@gscdump/engine-duckdb-wasm 0.28.3 → 0.29.0

package/dist/index.d.mts

@@ -257,6 +257,16 @@ interface BootDuckDBWasmOptions {
    * server that cannot answer bounded reads fails closed.
    */
   config?: DuckDBConfig;
+  /**
+   * Cap DuckDB's memory with `SET memory_limit=<value>` right after open (e.g.
+   * `'2GB'`, `'512MB'`). A runaway query then errors with a clean
+   * out-of-memory rather than growing the WASM heap until the tab crashes —
+   * DuckDB has no statement-level timeout, so abandoned queries are otherwise
+   * only stopped by the caller's `AbortSignal` (which the runtime forwards to
+   * `conn.cancelSent()`). Opt-in: omit to keep DuckDB-WASM's default sizing.
+   * Accepts `<number>` with an optional `B`/`KB`/`MB`/`GB`/`TB` suffix.
+   */
+  memoryLimit?: string;
 }
 interface BrowserParquetFile {
   bytes: Uint8Array;

package/dist/index.mjs

@@ -1049,6 +1049,11 @@ async function dropAttachedResources(db, conn, schema, tables, files) {
 	for (const table of tables) await conn.query(`DROP VIEW IF EXISTS ${schema}.${table}`);
 	if (files.length > 0) await db.dropFiles([...files]);
 }
+function parseMemoryLimit(value) {
+	const trimmed = value.trim();
+	if (!/^\d+(?:\.\d+)?\s*(?:B|KB|MB|GB|TB)?$/i.test(trimmed)) throw new Error(`invalid memoryLimit '${value}' — expected e.g. '512MB' or '2GB'`);
+	return trimmed;
+}
 async function bootDuckDBWasm(options = {}) {
 	const { getJsDelivrBundles, selectBundle, AsyncDuckDB, ConsoleLogger, LogLevel } = await import("@duckdb/duckdb-wasm");
 	const bundle = await selectBundle(options.bundles ?? getJsDelivrBundles());
@@ -1058,9 +1063,11 @@ async function bootDuckDBWasm(options = {}) {
 	try {
 		await db.instantiate(bundle.mainModule, bundle.pthreadWorker);
 		await db.open(rangeOnlyConfig(options.config));
+		const conn = await db.connect();
+		if (options.memoryLimit !== void 0) await conn.query(`SET memory_limit='${parseMemoryLimit(options.memoryLimit)}'`);
 		return {
 			db,
-			conn: await db.connect()
+			conn
 		};
 	} catch (err) {
 		worker.terminate();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/engine-duckdb-wasm",
   "type": "module",
-  "version": "0.28.3",
+  "version": "0.29.0",
   "description": "DuckDB-WASM engine adapter for @gscdump/analysis — typed browser analytics against parquet via R2.",
   "author": {
     "name": "Harlan Wilton",
@@ -45,9 +45,9 @@
   },
   "dependencies": {
     "drizzle-orm": "1.0.0-rc.3",
-    "@gscdump/contracts": "0.28.3",
-    "@gscdump/engine": "0.28.3",
-    "gscdump": "0.28.3"
+    "@gscdump/contracts": "0.29.0",
+    "@gscdump/engine": "0.29.0",
+    "gscdump": "0.29.0"
   },
   "devDependencies": {
     "@duckdb/duckdb-wasm": "^1.32.0",