@ducklings/workers-ducklake

DuckDB WASM for Cloudflare Workers with httpfs, client-only quack, and ducklake statically bundled.

This package targets Cloudflare Workers and uses Asyncify so DuckDB can perform async fetch()-backed I/O from WASM. It requires a Workers paid plan because the final bundle is close to Cloudflare's compressed Worker size limit. Run wrangler deploy --dry-run --outdir bundled against your built Worker to verify the final gzip size.

Installation

npm install @ducklings/workers-ducklake
Copy

Usage

import { init, DuckDB, AccessMode } from '@ducklings/workers-ducklake';
import wasmModule from '@ducklings/workers-ducklake/wasm';

await init({ wasmModule });

const db = new DuckDB({
  accessMode: AccessMode.READ_WRITE,
  lockConfiguration: true,
  customConfig: {
    memory_limit: '100MB',
    preserve_insertion_order: 'false',
  },
});

const conn = db.connect();
await conn.execute("ATTACH 'ducklake:metadata.ducklake' AS ducklake (DATA_PATH 's3://my-bucket/ducklake/')");
const result = await conn.query('SELECT * FROM ducklake.some_table LIMIT 10');
Copy

Vite Plugin

import { defineConfig } from 'vite';
import { cloudflare } from '@cloudflare/vite-plugin';
import { ducklingsWorkerPlugin } from '@ducklings/workers-ducklake/vite-plugin';

export default defineConfig({
  plugins: [ducklingsWorkerPlugin(), cloudflare()],
});
Copy

The plugin resolves @ducklings/workers-ducklake/wasm and copies the bundled WASM into the Cloudflare Worker output directory.

Extension Set

The published package does not bundle DuckDB's json extension to stay within Cloudflare deployment size limits.