@gscdump/engine-duckdb-wasm 1.4.11 → 1.5.1

package/dist/index.d.mts

@@ -7,5 +7,6 @@ import { overlayViewBody } from "./overlay-view.mjs";
 import { Schema, countries, dates, hourly_pages, page_queries, pages, queries, schema } from "./schema.mjs";
 import { InsightRunner, InsightRunnerOptions, ScopedRunnerOptions, TableScope, createInsightRunner, mergeScope, scopeFor } from "./runner.mjs";
 import { AnalyzeResult, AttachParquetTablesOptions, AttachParquetUrlTablesOptions, AttachedTablesHandle, BootDuckDBWasmOptions, BrowserAnalysisRuntime, BrowserAttachBudgetExceededError, BrowserAttachError, BrowserParquetFile, BrowserParquetTable, BrowserParquetUrlTable, DuckDBWasmBootResult, QueryResult, attachParquetTables, attachParquetUrlTables, attachParquetUrlTablesResult, bootDuckDBWasm, browserAttachErrors, createBrowserAnalysisRuntime, isBrowserAttachError } from "./runtime.mjs";
+import { ObjectAsyncLock, SharedAsyncResource, SharedAsyncResourceOptions, SharedAsyncResourceState, createObjectAsyncLock, createSharedAsyncResource } from "./shared-runtime.mjs";
 import { ComparisonMode, ResolveWindowOptions, ResolvedWindow, WindowPreset, resolveWindow } from "@gscdump/engine/period";
-export { type AnalyzeResult, type AttachOpfsTablesOptions, type AttachParquetTablesOptions, type AttachParquetUrlTablesOptions, type AttachedTablesHandle, type BootDuckDBWasmOptions, type BrowserAnalysisRuntime, BrowserAttachBudgetExceededError, type BrowserAttachError, type BrowserParquetFile, type BrowserParquetTable, type BrowserParquetUrlTable, type ComparisonMode, type CompiledArchetypeSql, type DuckDBWasmBootResult, type DuckDBWasmClient, DuckDBWasmDatabase, type DuckDBWasmDrizzleDatabase, type InsightRunner, type InsightRunnerOptions, type OpfsAttachTiming, type OpfsAttachTimingStage, type OpfsAttachedHandle, type OpfsFileProgress, type OpfsParquetFile, type OpfsParquetTable, OpfsQuotaExceededError, type QueryResult, type ResolveWindowOptions, type ResolvedWindow, type Schema, type ScopedRunnerOptions, type TableScope, type WindowPreset, attachOpfsParquetTables, attachParquetTables, attachParquetUrlTables, attachParquetUrlTablesResult, bootDuckDBWasm, browserAttachErrors, clearOpfsSnapshotCache, compileArchetypeSql, countries, createBrowserAnalysisRuntime, createClient, createInsightRunner, dates, drizzle, estimateOpfsStorage, hourly_pages, isBrowserAttachError, mergeScope, overlayViewBody, page_queries, pages, queries, readOpfsSnapshotFile, requestPersistentStorage, resolveWindow, schema, scopeFor, tableForArchetype };
+export { type AnalyzeResult, type AttachOpfsTablesOptions, type AttachParquetTablesOptions, type AttachParquetUrlTablesOptions, type AttachedTablesHandle, type BootDuckDBWasmOptions, type BrowserAnalysisRuntime, BrowserAttachBudgetExceededError, type BrowserAttachError, type BrowserParquetFile, type BrowserParquetTable, type BrowserParquetUrlTable, type ComparisonMode, type CompiledArchetypeSql, type DuckDBWasmBootResult, type DuckDBWasmClient, DuckDBWasmDatabase, type DuckDBWasmDrizzleDatabase, type InsightRunner, type InsightRunnerOptions, type ObjectAsyncLock, type OpfsAttachTiming, type OpfsAttachTimingStage, type OpfsAttachedHandle, type OpfsFileProgress, type OpfsParquetFile, type OpfsParquetTable, OpfsQuotaExceededError, type QueryResult, type ResolveWindowOptions, type ResolvedWindow, type Schema, type ScopedRunnerOptions, type SharedAsyncResource, type SharedAsyncResourceOptions, type SharedAsyncResourceState, type TableScope, type WindowPreset, attachOpfsParquetTables, attachParquetTables, attachParquetUrlTables, attachParquetUrlTablesResult, bootDuckDBWasm, browserAttachErrors, clearOpfsSnapshotCache, compileArchetypeSql, countries, createBrowserAnalysisRuntime, createClient, createInsightRunner, createObjectAsyncLock, createSharedAsyncResource, dates, drizzle, estimateOpfsStorage, hourly_pages, isBrowserAttachError, mergeScope, overlayViewBody, page_queries, pages, queries, readOpfsSnapshotFile, requestPersistentStorage, resolveWindow, schema, scopeFor, tableForArchetype };

package/dist/index.mjs

@@ -7,5 +7,6 @@ import { OpfsQuotaExceededError, attachOpfsParquetTables, clearOpfsSnapshotCache
 import { countries, dates, hourly_pages, page_queries, pages, queries, schema } from "./schema.mjs";
 import { createInsightRunner, mergeScope, scopeFor } from "./runner.mjs";
 import { BrowserAttachBudgetExceededError, attachParquetTables, attachParquetUrlTables, attachParquetUrlTablesResult, bootDuckDBWasm, browserAttachErrors, createBrowserAnalysisRuntime, isBrowserAttachError } from "./runtime.mjs";
+import { createObjectAsyncLock, createSharedAsyncResource } from "./shared-runtime.mjs";
 import { resolveWindow } from "@gscdump/engine/period";
-export { BrowserAttachBudgetExceededError, DuckDBWasmDatabase, OpfsQuotaExceededError, attachOpfsParquetTables, attachParquetTables, attachParquetUrlTables, attachParquetUrlTablesResult, bootDuckDBWasm, browserAttachErrors, clearOpfsSnapshotCache, compileArchetypeSql, countries, createBrowserAnalysisRuntime, createClient, createInsightRunner, dates, drizzle, estimateOpfsStorage, hourly_pages, isBrowserAttachError, mergeScope, overlayViewBody, page_queries, pages, queries, readOpfsSnapshotFile, requestPersistentStorage, resolveWindow, schema, scopeFor, tableForArchetype };
+export { BrowserAttachBudgetExceededError, DuckDBWasmDatabase, OpfsQuotaExceededError, attachOpfsParquetTables, attachParquetTables, attachParquetUrlTables, attachParquetUrlTablesResult, bootDuckDBWasm, browserAttachErrors, clearOpfsSnapshotCache, compileArchetypeSql, countries, createBrowserAnalysisRuntime, createClient, createInsightRunner, createObjectAsyncLock, createSharedAsyncResource, dates, drizzle, estimateOpfsStorage, hourly_pages, isBrowserAttachError, mergeScope, overlayViewBody, page_queries, pages, queries, readOpfsSnapshotFile, requestPersistentStorage, resolveWindow, schema, scopeFor, tableForArchetype };

package/dist/runner.d.mts

@@ -15,14 +15,6 @@ interface InsightRunner {
   close: () => Promise<void>;
 }
 declare function createInsightRunner(opts: InsightRunnerOptions): Promise<InsightRunner>;
-/**
- * Build a per-table predicate set from {siteId, window}. The returned
- * `wherePredicates` composes with user-level filters via `mergeScope`.
- *
- * Note: the current SCHEMAS don't include `site_id` on any table (snapshots
- * are already per-site), so `siteId` is a no-op for now — kept in the API
- * so consumers can add the predicate without an interface change when
- * multi-site snapshots land.
- */
-declare const scopeFor: (table: "pages" | "queries" | "countries" | "page_queries" | "dates" | "search_appearance" | "search_appearance_pages" | "search_appearance_queries" | "search_appearance_page_queries" | "hourly_pages", opts: ScopedRunnerOptions) => TableScope, mergeScope: typeof import("@gscdump/engine/scope").mergeScope;
+declare const scopeFor: (table: "pages" | "queries" | "countries" | "page_queries" | "dates" | "search_appearance" | "search_appearance_pages" | "search_appearance_queries" | "search_appearance_page_queries" | "hourly_pages", opts: ScopedRunnerOptions) => TableScope;
+declare const mergeScope: typeof import("@gscdump/engine/scope").mergeScope;
 export { InsightRunner, InsightRunnerOptions, type ScopedRunnerOptions, type TableScope, createInsightRunner, mergeScope, scopeFor };

package/dist/runner.mjs

@@ -15,5 +15,7 @@ async function createInsightRunner(opts) {
 		close: () => client.close()
 	};
 }
-const { scopeFor, mergeScope } = createScopedHelpers(schema);
+const scopedHelpers = createScopedHelpers(schema);
+const scopeFor = scopedHelpers.scopeFor;
+const mergeScope = scopedHelpers.mergeScope;
 export { createInsightRunner, mergeScope, scopeFor };

package/dist/shared-runtime.d.mts

@@ -0,0 +1,28 @@
+type SharedAsyncResourceState = {
+  _tag: 'idle' | 'loading' | 'ready';
+  consecutiveFailures: number;
+  lastFailureAt: null;
+} | {
+  _tag: 'cooldown' | 'exhausted';
+  consecutiveFailures: number;
+  lastFailureAt: number;
+  error: unknown;
+};
+interface SharedAsyncResourceOptions<T> {
+  load: () => Promise<T>;
+  retryCooldownMs?: number;
+  maxConsecutiveFailures?: number;
+  now?: () => number;
+  onStateChange?: (state: SharedAsyncResourceState) => void;
+}
+interface SharedAsyncResource<T> {
+  get: () => Promise<T>;
+  state: () => SharedAsyncResourceState;
+  reset: () => void;
+}
+declare function createSharedAsyncResource<T>(options: SharedAsyncResourceOptions<T>): SharedAsyncResource<T>;
+interface ObjectAsyncLock<T extends object> {
+  run: <R>(key: T, task: () => Promise<R>) => Promise<R>;
+}
+declare function createObjectAsyncLock<T extends object>(onRejected?: (error: unknown) => void): ObjectAsyncLock<T>;
+export { ObjectAsyncLock, SharedAsyncResource, SharedAsyncResourceOptions, SharedAsyncResourceState, createObjectAsyncLock, createSharedAsyncResource };

package/dist/shared-runtime.mjs

@@ -0,0 +1,79 @@
+function createSharedAsyncResource(options) {
+	const now = options.now ?? Date.now;
+	const retryCooldownMs = options.retryCooldownMs ?? 3e4;
+	const maxConsecutiveFailures = options.maxConsecutiveFailures ?? 3;
+	let promise = null;
+	let current = {
+		_tag: "idle",
+		consecutiveFailures: 0,
+		lastFailureAt: null
+	};
+	const update = (state) => {
+		current = state;
+		options.onStateChange?.(state);
+	};
+	const get = () => {
+		if (promise) return promise;
+		if (current.consecutiveFailures >= maxConsecutiveFailures) {
+			if (current._tag !== "cooldown" && current._tag !== "exhausted") return Promise.reject(/* @__PURE__ */ new Error("shared resource exhausted without a recorded failure"));
+			update({
+				...current,
+				_tag: "exhausted"
+			});
+			return Promise.reject(current.error);
+		}
+		if ((current._tag === "cooldown" || current._tag === "exhausted") && now() - current.lastFailureAt < retryCooldownMs) {
+			update({
+				...current,
+				_tag: "cooldown"
+			});
+			return Promise.reject(current.error);
+		}
+		update({
+			_tag: "loading",
+			consecutiveFailures: current.consecutiveFailures,
+			lastFailureAt: null
+		});
+		promise = options.load().then((resource) => {
+			update({
+				_tag: "ready",
+				consecutiveFailures: 0,
+				lastFailureAt: null
+			});
+			return resource;
+		}, (error) => {
+			promise = null;
+			update({
+				_tag: "cooldown",
+				consecutiveFailures: current.consecutiveFailures + 1,
+				lastFailureAt: now(),
+				error
+			});
+			throw error;
+		});
+		return promise;
+	};
+	return {
+		get,
+		state: () => current,
+		reset: () => {
+			promise = null;
+			update({
+				_tag: "idle",
+				consecutiveFailures: 0,
+				lastFailureAt: null
+			});
+		}
+	};
+}
+function createObjectAsyncLock(onRejected) {
+	const chains = /* @__PURE__ */ new WeakMap();
+	return { run(key, task) {
+		const result = (chains.get(key) ?? Promise.resolve()).then(task);
+		chains.set(key, result.then(() => void 0, (error) => {
+			onRejected?.(error);
+		}));
+		return result;
+	} };
+}
+export { createObjectAsyncLock, createSharedAsyncResource };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/engine-duckdb-wasm",
   "type": "module",
-  "version": "1.4.11",
+  "version": "1.5.1",
   "description": "DuckDB-WASM engine adapter for @gscdump/analysis — typed browser analytics against parquet via R2.",
   "author": {
     "name": "Harlan Wilton",
@@ -45,15 +45,15 @@
   },
   "dependencies": {
     "drizzle-orm": "1.0.0-rc.3",
-    "@gscdump/contracts": "^1.4.11",
-    "@gscdump/engine": "^1.4.11",
-    "gscdump": "^1.4.11"
+    "@gscdump/contracts": "^1.5.1",
+    "@gscdump/engine": "^1.5.1",
+    "gscdump": "^1.5.1"
   },
   "devDependencies": {
     "@duckdb/duckdb-wasm": "1.33.1-dev57.0",
     "@vitest/browser": "^4.1.10",
     "@vitest/browser-playwright": "^4.1.10",
-    "playwright": "^1.61.1",
+    "playwright": "^1.62.0",
     "vitest": "^4.1.10"
   },
   "scripts": {