@gscdump/cloudflare 0.17.2 → 0.17.4

package/dist/index.d.mts

@@ -56,6 +56,20 @@ interface AnalyticsEngineHooks {
   onR2Write?: (byteLength: number) => void;
 }
 declare function getAnalyticsEngine(env: AnalyticsEnv, db: any, hooks?: AnalyticsEngineHooks): ReturnType<typeof createStorageEngine> | null;
+interface InflightDedupe<T> {
+  dedupe: (key: string, run: () => Promise<T>) => Promise<T>;
+  has: (key: string) => boolean;
+  clear: () => void;
+}
+declare function createInflightDedupe<T>(): InflightDedupe<T>;
+interface HostedR2QueryKeyInput {
+  userId: string | number;
+  siteId: string;
+  state: unknown;
+  comparison?: unknown;
+  comparisonFilter?: string;
+}
+declare function getHostedR2QueryKey(input: HostedR2QueryKeyInput): string;
 interface PresignOptions {
   key: string;
   bucket: string;
@@ -70,4 +84,4 @@ declare function signSizeHint(env: AnalyticsEnv, key: string, bytes: number): Pr
 declare function verifySizeHint(env: AnalyticsEnv, key: string, bytes: number, providedHex: string): Promise<boolean>;
 declare function createDucklingsCodec(_env: AnalyticsEnv): ParquetCodec;
 declare function createDucklingsExecutor(env: AnalyticsEnv): QueryExecutor;
-export { type AnalyticsEngineHooks, type AnalyticsEnv, type PresignOptions, type Row, createDucklingsCodec, createDucklingsExecutor, createR2Presigner, getAnalyticsEngine, getWasmDuckDBFactory, resetWasmDuckDB, signSizeHint, useAnalyticsEnv, verifySizeHint };
+export { type AnalyticsEngineHooks, type AnalyticsEnv, type HostedR2QueryKeyInput, type InflightDedupe, type PresignOptions, type Row, createDucklingsCodec, createDucklingsExecutor, createInflightDedupe, createR2Presigner, getAnalyticsEngine, getHostedR2QueryKey, getWasmDuckDBFactory, resetWasmDuckDB, signSizeHint, useAnalyticsEnv, verifySizeHint };

package/dist/index.mjs

@@ -129,6 +129,50 @@ function useAnalyticsEnv(event) {
 		statusMessage: "AnalyticsEnv not available — host must populate event.context.analyticsEnv or use the Cloudflare adapter"
 	});
 }
+function createInflightDedupe() {
+	const inflight = /* @__PURE__ */ new Map();
+	return {
+		dedupe(key, run) {
+			const existing = inflight.get(key);
+			if (existing) return existing;
+			const promise = run().finally(() => {
+				if (inflight.get(key) === promise) inflight.delete(key);
+			});
+			inflight.set(key, promise);
+			return promise;
+		},
+		has(key) {
+			return inflight.has(key);
+		},
+		clear() {
+			inflight.clear();
+		}
+	};
+}
+function stableStringify(value) {
+	if (Array.isArray(value)) return `[${value.map(stableStringify).join(",")}]`;
+	if (value && typeof value === "object") return `{${Object.keys(value).sort().map((key) => {
+		return `${JSON.stringify(key)}:${stableStringify(value[key])}`;
+	}).join(",")}}`;
+	return JSON.stringify(value);
+}
+function hashString(value) {
+	let hash = 0;
+	for (let i = 0; i < value.length; i++) {
+		hash = (hash << 5) - hash + value.charCodeAt(i);
+		hash |= 0;
+	}
+	return Math.abs(hash).toString(36);
+}
+function getHostedR2QueryKey(input) {
+	return [
+		input.userId,
+		input.siteId,
+		hashString(stableStringify(input.state)),
+		input.comparison ? hashString(stableStringify(input.comparison)) : "",
+		input.comparisonFilter ?? ""
+	].join(":");
+}
 function createR2Presigner(env) {
 	if (!env.R2_ACCESS_KEY_ID || !env.R2_SECRET_ACCESS_KEY) throw createError({
 		statusCode: 500,
@@ -197,4 +241,4 @@ async function verifySizeHint(env, key, bytes, providedHex) {
 	for (let i = 0; i < SIG_HEX_LEN; i++) diff |= expected.charCodeAt(i) ^ providedHex.charCodeAt(i);
 	return diff === 0;
 }
-export { createDucklingsCodec, createDucklingsExecutor, createR2Presigner, getAnalyticsEngine, getWasmDuckDBFactory, resetWasmDuckDB, signSizeHint, useAnalyticsEnv, verifySizeHint };
+export { createDucklingsCodec, createDucklingsExecutor, createInflightDedupe, createR2Presigner, getAnalyticsEngine, getHostedR2QueryKey, getWasmDuckDBFactory, resetWasmDuckDB, signSizeHint, useAnalyticsEnv, verifySizeHint };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/cloudflare",
   "type": "module",
-  "version": "0.17.2",
+  "version": "0.17.4",
   "description": "Cloudflare-Workers-flavored helpers for the gscdump analytics stack: AnalyticsEnv binding contract, R2 SigV4 presigner, size-hint HMAC, DuckDB Workers shims, engine factory.",
   "author": {
     "name": "Harlan Wilton",
@@ -40,8 +40,8 @@
   },
   "dependencies": {
     "aws4fetch": "^1.0.20",
-    "@gscdump/engine-sqlite": "0.17.2",
-    "@gscdump/engine": "0.17.2"
+    "@gscdump/engine-sqlite": "0.17.4",
+    "@gscdump/engine": "0.17.4"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^4.20260517.1",