@gscdump/engine-duckdb-wasm 1.5.0 → 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/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.5.0",
+  "version": "1.5.1",
   "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": "^1.5.0",
-    "@gscdump/engine": "^1.5.0",
-    "gscdump": "^1.5.0"
+    "@gscdump/contracts": "^1.5.1",
+    "@gscdump/engine": "^1.5.1",
+    "gscdump": "^1.5.1"
   },
   "devDependencies": {
     "@duckdb/duckdb-wasm": "1.33.1-dev57.0",