@gscdump/engine 0.40.1 → 1.0.0

package/dist/rollups.mjs

@@ -1,9 +1,9 @@
-import "./_chunks/layout.mjs";
 import { engineErrors } from "./errors.mjs";
+import "./_chunks/layout.mjs";
 import { encodeRowsToParquetFlex } from "./adapters/hyparquet.mjs";
 import { createIndexingMetadataStore, createQueryDimStore, createSitemapStore, inspectionParquetKey, sitemapUrlsIndexPrefix } from "./_chunks/entities.mjs";
-import { encodeJsonBigintSafe } from "@gscdump/lakehouse";
 import { MS_PER_DAY } from "gscdump/dates";
+import { encodeJsonBigintSafe } from "@gscdump/lakehouse";
 function rollupPrefix(ctx, searchType) {
 	const base = ctx.siteId ? `u_${ctx.userId}/${ctx.siteId}/rollups` : `u_${ctx.userId}/rollups`;
 	return searchType !== void 0 && searchType !== "web" ? `${base}/${searchType}` : base;
@@ -754,7 +754,7 @@ const queryCanonicalDailyRollup = {
 				orderBy: "date, query_canonical",
 				pageRows: ROLLUP_PAGE_ROWS_DAILY
 			},
-			maxWindowDays: 7,
+			maxWindowDays: DAILY_MAX_WINDOW_DAYS,
 			sqlFor: dailyWindowSqlFor(useDim, canonExpr)
 		})).map(mapDailyRow);
 	}
@@ -800,7 +800,7 @@ async function rebuildCanonicalDailyResumable(opts) {
 	const sType = searchType !== void 0 ? { searchType } : {};
 	const startPageOffset = opts.pageOffset ?? 0;
 	const pageRows = opts.pageRows ?? 7e4;
-	const maxWindowDays = opts.maxWindowDays ?? 7;
+	const maxWindowDays = opts.maxWindowDays ?? DAILY_MAX_WINDOW_DAYS;
 	const shardCount = Math.max(1, Math.floor(opts.shardCount ?? 1));
 	const windows = planRollupWindows((await engine.listPartitions({
 		ctx,
@@ -1261,4 +1261,4 @@ const DEFAULT_ROLLUPS = [
 	sitemapChanges28dRollup
 ];
 const CANONICAL_ROLLUPS = [queryCanonicalVariantsRollup, queryCanonicalDailyRollup];
-export { CANONICAL_ROLLUPS, DAILY_MAX_WINDOW_DAYS, DEFAULT_ROLLUPS, ROLLUP_PAGE_ROWS, ROLLUP_PAGE_ROWS_DAILY, ROLLUP_PAGE_ROWS_WIDE, WINDOW_BYTE_BUDGET, dailyTotalsRollup, indexPercentRollup, indexingHealthRollup, indexingMetadataRollup, partitionDaySpan, partitionsInRange, planRollupWindows, queryCanonicalDailyRollup, queryCanonicalVariantsRollup, readLatestRollup, rebuildCanonicalDailyResumable, rebuildDailyFromHourly, rebuildRollups, rollupKey, rollupParquetKey, runWindowed, sitemapChanges28dRollup, sitemapHealthRollup, topCountries28dRollup, topKeywords28dParquetRollup, topKeywords28dRollup, topPages28dRollup, weeklyTotalsRollup };
+export { CANONICAL_ROLLUPS, DEFAULT_ROLLUPS, ROLLUP_PAGE_ROWS, ROLLUP_PAGE_ROWS_DAILY, ROLLUP_PAGE_ROWS_WIDE, WINDOW_BYTE_BUDGET, dailyTotalsRollup, indexPercentRollup, indexingHealthRollup, indexingMetadataRollup, planRollupWindows, queryCanonicalDailyRollup, queryCanonicalVariantsRollup, readLatestRollup, rebuildCanonicalDailyResumable, rebuildDailyFromHourly, rebuildRollups, rollupKey, rollupParquetKey, runWindowed, sitemapChanges28dRollup, sitemapHealthRollup, topCountries28dRollup, topKeywords28dParquetRollup, topPages28dRollup, weeklyTotalsRollup };

package/dist/scope.d.mts

@@ -28,7 +28,6 @@ interface TableScope {
   window?: ResolvedWindow;
   siteId?: string;
 }
-declare function buildTableScope(table: Record<string, any>, opts: ScopedRunnerOptions): TableScope;
 declare function mergeScope(scope: TableScope, ...extra: SQL[]): SQL | undefined;
 /**
  * Bind `buildTableScope` + `mergeScope` to a specific drizzle schema. Engine
@@ -41,4 +40,4 @@ declare function createScopedHelpers<S extends Record<string, Record<string, any
   scopeFor: (table: keyof S, opts: ScopedRunnerOptions) => TableScope;
   mergeScope: typeof mergeScope;
 };
-export { ResolvedWindow, ScopedRunnerOptions, TableScope, buildTableScope, createScopedHelpers, mergeScope };
+export { ResolvedWindow, ScopedRunnerOptions, TableScope, createScopedHelpers, mergeScope };

package/dist/scope.mjs

@@ -27,4 +27,4 @@ function createScopedHelpers(schema) {
 		mergeScope
 	};
 }
-export { buildTableScope, createScopedHelpers, mergeScope };
+export { createScopedHelpers, mergeScope };

package/dist/source/index.d.mts

@@ -1,3 +1,3 @@
 import { AnalysisQuerySource, AnalysisSourceKind, ExecuteSqlOptions, FileSet, QueryRow, SourceCapabilities } from "../_chunks/registry.mjs";
-import { AttachedTableMissingError, AttachedTableRunner, AttachedTableSourceOptions, CreateSqlQuerySourceOptions, ENGINE_QUERY_CAPABILITIES, EngineQuerySourceOptions, createAttachedTableSource, createEngineQuerySource, createSqlQuerySource, queryRows, rewriteForTableSource, runAnalyzerWithEngine } from "../_chunks/index.mjs";
-export { type AnalysisQuerySource, type AnalysisSourceKind, AttachedTableMissingError, type AttachedTableRunner, type AttachedTableSourceOptions, type CreateSqlQuerySourceOptions, ENGINE_QUERY_CAPABILITIES, EngineQuerySourceOptions, type ExecuteSqlOptions, type FileSet, type QueryRow, type SourceCapabilities, createAttachedTableSource, createEngineQuerySource, createSqlQuerySource, queryRows, rewriteForTableSource, runAnalyzerWithEngine };
+import { AttachedTableMissingError, AttachedTableRunner, AttachedTableSourceOptions, CreateSqlQuerySourceOptions, ENGINE_QUERY_CAPABILITIES, EngineQuerySourceOptions, createAttachedTableSource, createEngineQuerySource, createSqlQuerySource, queryRows, runAnalyzerWithEngine } from "../_chunks/index.mjs";
+export { type AnalysisQuerySource, type AnalysisSourceKind, AttachedTableMissingError, type AttachedTableRunner, type AttachedTableSourceOptions, type CreateSqlQuerySourceOptions, ENGINE_QUERY_CAPABILITIES, EngineQuerySourceOptions, type ExecuteSqlOptions, type FileSet, type QueryRow, type SourceCapabilities, createAttachedTableSource, createEngineQuerySource, createSqlQuerySource, queryRows, runAnalyzerWithEngine };

package/dist/source/index.mjs

@@ -1,2 +1,2 @@
-import { AttachedTableMissingError, ENGINE_QUERY_CAPABILITIES, createAttachedTableSource, createEngineQuerySource, createSqlQuerySource, queryRows, rewriteForTableSource, runAnalyzerWithEngine } from "../_chunks/source.mjs";
-export { AttachedTableMissingError, ENGINE_QUERY_CAPABILITIES, createAttachedTableSource, createEngineQuerySource, createSqlQuerySource, queryRows, rewriteForTableSource, runAnalyzerWithEngine };
+import { AttachedTableMissingError, ENGINE_QUERY_CAPABILITIES, createAttachedTableSource, createEngineQuerySource, createSqlQuerySource, queryRows, runAnalyzerWithEngine } from "../_chunks/source.mjs";
+export { AttachedTableMissingError, ENGINE_QUERY_CAPABILITIES, createAttachedTableSource, createEngineQuerySource, createSqlQuerySource, queryRows, runAnalyzerWithEngine };

package/dist/sql-bind.d.mts

@@ -1,33 +1,5 @@
-import { EngineError } from "./_chunks/errors.mjs";
-import { Result } from "gscdump/result";
 /** Escape single quotes for inlining inside a SQL string literal (SQL-standard `''` escaping). */
 declare function sqlEscape(s: string): string;
-/**
- * Errors-as-values core for {@link formatLiteral}: returns a typed
- * `invalid-sql-literal` `EngineError` for values that can't be safely inlined.
- */
-declare function formatLiteralResult(value: unknown): Result<string, EngineError>;
 declare function formatLiteral(value: unknown): string;
-/**
- * Replace `?` and `$N` placeholders with inline SQL literals. Single-quoted
- * string regions and SQL comments (`-- line`, `/* block *\/`) are left
- * untouched — a `?` or `$1` inside `'foo?bar'` or a comment is not a
- * placeholder. SQL-standard `''` escape handling; no `\`-escape or
- * dialect-specific identifier quoting.
- *
- * `?` placeholders bind sequentially against `params`. `$N` (Postgres-style)
- * binds explicitly to `params[N-1]`. The two styles must not be mixed in the
- * same query.
- *
- * Throws when placeholder count and params length disagree, or when a `$N`
- * index is out of range.
- */
-/**
- * Errors-as-values core for {@link bindLiterals}: returns a typed
- * `placeholder-arity-mismatch` / `invalid-sql-literal` `EngineError` instead of
- * throwing, so the edge RPC / proxy callers that build SQL from untrusted params
- * can branch on the failure.
- */
-declare function bindLiteralsResult(sql: string, params: readonly unknown[]): Result<string, EngineError>;
 declare function bindLiterals(sql: string, params: readonly unknown[]): string;
-export { bindLiterals, bindLiteralsResult, formatLiteral, formatLiteralResult, sqlEscape };
+export { bindLiterals, formatLiteral, sqlEscape };

package/dist/sql-bind.mjs

@@ -101,4 +101,4 @@ function bindLiteralsResult(sql, params) {
 function bindLiterals(sql, params) {
 	return unwrapResult(bindLiteralsResult(sql, params), engineErrorToException);
 }
-export { bindLiterals, bindLiteralsResult, formatLiteral, formatLiteralResult, sqlEscape };
+export { bindLiterals, formatLiteral, sqlEscape };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/engine",
   "type": "module",
-  "version": "0.40.1",
+  "version": "1.0.0",
   "description": "Append-only Parquet/DuckDB storage engine + planner + adapters for the gscdump pipeline. Node + edge runtimes; opt-in heavy peers.",
   "author": {
     "name": "Harlan Wilton",
@@ -36,21 +36,11 @@
       "import": "./dist/errors.mjs",
       "default": "./dist/errors.mjs"
     },
-    "./snapshot": {
-      "types": "./dist/snapshot.d.mts",
-      "import": "./dist/snapshot.mjs",
-      "default": "./dist/snapshot.mjs"
-    },
     "./planner": {
       "types": "./dist/planner.d.mts",
       "import": "./dist/planner.mjs",
       "default": "./dist/planner.mjs"
     },
-    "./compaction": {
-      "types": "./dist/compaction-public.d.mts",
-      "import": "./dist/compaction-public.mjs",
-      "default": "./dist/compaction-public.mjs"
-    },
     "./schema": {
       "types": "./dist/schema.d.mts",
       "import": "./dist/schema.mjs",
@@ -111,11 +101,6 @@
       "import": "./dist/adapters/r2.mjs",
       "default": "./dist/adapters/r2.mjs"
     },
-    "./r2-manifest": {
-      "types": "./dist/adapters/r2-manifest.d.mts",
-      "import": "./dist/adapters/r2-manifest.mjs",
-      "default": "./dist/adapters/r2-manifest.mjs"
-    },
     "./resolver": {
       "types": "./dist/resolver/index.d.mts",
       "import": "./dist/resolver/index.mjs",
@@ -168,10 +153,10 @@
     "dist"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "peerDependencies": {
-    "@duckdb/duckdb-wasm": "^1.32.0"
+    "@duckdb/duckdb-wasm": "^1.33.1-dev57.0"
   },
   "peerDependenciesMeta": {
     "@duckdb/duckdb-wasm": {
@@ -181,12 +166,12 @@
   "dependencies": {
     "drizzle-orm": "1.0.0-rc.3",
     "proper-lockfile": "^4.1.2",
-    "@gscdump/contracts": "0.40.1",
-    "@gscdump/lakehouse": "0.40.1",
-    "gscdump": "0.40.1"
+    "@gscdump/lakehouse": "^1.0.0",
+    "gscdump": "^1.0.0",
+    "@gscdump/contracts": "^1.0.0"
   },
   "devDependencies": {
-    "@duckdb/duckdb-wasm": "^1.32.0",
+    "@duckdb/duckdb-wasm": "1.33.1-dev57.0",
     "@types/node": "^26.1.1",
     "@types/proper-lockfile": "^4.1.4",
     "aws4fetch": "^1.0.20",

package/dist/_chunks/compaction.mjs

@@ -1,251 +0,0 @@
-import { dayPartition, inferSearchType, mondayOfWeek, monthPartition, objectKey, quarterOfMonth, quarterPartition, weekPartition } from "./layout.mjs";
-import { currentSchemaVersion } from "./schema.mjs";
-import { MS_PER_DAY } from "gscdump/dates";
-const DAILY_PARTITION_RE = /^daily\/(\d{4}-\d{2}-\d{2})$/;
-const WEEKLY_PARTITION_RE = /^weekly\/(\d{4}-\d{2}-\d{2})$/;
-const MONTHLY_PARTITION_RE = /^monthly\/(\d{4}-\d{2})$/;
-const QUARTERLY_PARTITION_RE = /^quarterly\/(\d{4})-Q([1-4])$/;
-const DEFAULT_THRESHOLDS = {
-	raw: 7,
-	d7: 30,
-	d30: 90
-};
-function countRawDailies(entries) {
-	return entries.filter((e) => e.tier === "raw" || e.tier == null && e.partition.startsWith("daily/")).length;
-}
-const PENDING_WINDOW_DAYS = 4;
-const STAGES = [
-	{
-		inputTier: "raw",
-		outputTier: "d7",
-		cutoffDays: DEFAULT_THRESHOLDS.raw,
-		bucketKey: (e) => {
-			const m = e.partition.match(DAILY_PARTITION_RE);
-			if (!m) return void 0;
-			return mondayOfWeek(m[1]);
-		},
-		bucketLatestMs: (monday) => Date.parse(`${monday}T00:00:00Z`) + 6 * MS_PER_DAY,
-		outputPartition: weekPartition
-	},
-	{
-		inputTier: "d7",
-		outputTier: "d30",
-		cutoffDays: DEFAULT_THRESHOLDS.d7,
-		bucketKey: (e) => {
-			const m = e.partition.match(WEEKLY_PARTITION_RE);
-			if (!m) return void 0;
-			return m[1].slice(0, 7);
-		},
-		bucketLatestMs: monthEndMs,
-		outputPartition: monthPartition
-	},
-	{
-		inputTier: "d30",
-		outputTier: "d90",
-		cutoffDays: DEFAULT_THRESHOLDS.d30,
-		bucketKey: (e) => {
-			const m = e.partition.match(MONTHLY_PARTITION_RE);
-			if (!m) return void 0;
-			return quarterOfMonth(m[1]);
-		},
-		bucketLatestMs: quarterEndMs,
-		outputPartition: quarterPartition
-	}
-];
-async function compactTieredImpl(deps, ctx, now, overrides = {}) {
-	const thresholds = {
-		...DEFAULT_THRESHOLDS,
-		...overrides
-	};
-	const stagesWithThresholds = STAGES.map((s) => ({
-		...s,
-		cutoffDays: s.outputTier === "d7" ? thresholds.raw : s.outputTier === "d30" ? thresholds.d7 : thresholds.d30
-	}));
-	for (const stage of stagesWithThresholds) await runStage(deps, ctx, stage, now);
-}
-async function runStage(deps, ctx, stage, now) {
-	const cutoff = now - Math.max(stage.cutoffDays, PENDING_WINDOW_DAYS) * MS_PER_DAY;
-	const candidates = await deps.manifestStore.listLive({
-		userId: ctx.userId,
-		siteId: ctx.siteId,
-		table: ctx.table,
-		tier: stage.inputTier
-	});
-	const buckets = /* @__PURE__ */ new Map();
-	for (const entry of candidates) {
-		if (entry.partition.startsWith("hourly/")) continue;
-		const key = stage.bucketKey(entry);
-		if (!key) continue;
-		if (stage.bucketLatestMs(key) >= cutoff) continue;
-		const compositeKey = `${inferSearchType(entry)}\0${key}`;
-		if (!buckets.has(compositeKey)) buckets.set(compositeKey, []);
-		buckets.get(compositeKey).push(entry);
-	}
-	for (const [compositeKey, entries] of buckets) {
-		const [searchType, bucket] = compositeKey.split("\0");
-		const targetPartition = stage.outputPartition(bucket);
-		if (entries.length === 1 && entries[0].partition === targetPartition) continue;
-		await deps.manifestStore.withLock({
-			userId: ctx.userId,
-			siteId: ctx.siteId,
-			table: ctx.table,
-			partition: targetPartition
-		}, async () => {
-			const key = objectKey(ctx, ctx.table, targetPartition, now, searchType);
-			const { bytes, rowCount } = await deps.codec.compactRows({ table: ctx.table }, entries.map((e) => e.objectKey), key, deps.dataSource);
-			const newEntry = {
-				userId: ctx.userId,
-				siteId: ctx.siteId,
-				table: ctx.table,
-				partition: targetPartition,
-				objectKey: key,
-				rowCount,
-				bytes,
-				createdAt: now,
-				schemaVersion: currentSchemaVersion(ctx.table),
-				tier: stage.outputTier,
-				...searchType !== "web" ? { searchType } : {}
-			};
-			await deps.manifestStore.registerVersion(newEntry, entries);
-		});
-	}
-}
-function enumeratePartitions(startDate, endDate) {
-	const out = [];
-	const [sy, sm, sd] = startDate.split("-").map(Number);
-	const [ey, em, ed] = endDate.split("-").map(Number);
-	const start = Date.UTC(sy, sm - 1, sd);
-	const end = Date.UTC(ey, em - 1, ed);
-	if (end < start) return out;
-	const seenWeeks = /* @__PURE__ */ new Set();
-	const seenMonths = /* @__PURE__ */ new Set();
-	const seenQuarters = /* @__PURE__ */ new Set();
-	for (let t = start; t <= end; t += 864e5) {
-		const d = new Date(t);
-		const y = d.getUTCFullYear();
-		const m = String(d.getUTCMonth() + 1).padStart(2, "0");
-		const isoDay = `${y}-${m}-${String(d.getUTCDate()).padStart(2, "0")}`;
-		const isoMonth = `${y}-${m}`;
-		out.push(dayPartition(isoDay));
-		const monday = mondayOfWeek(isoDay);
-		if (!seenWeeks.has(monday)) {
-			seenWeeks.add(monday);
-			out.push(weekPartition(monday));
-		}
-		if (!seenMonths.has(isoMonth)) {
-			seenMonths.add(isoMonth);
-			out.push(monthPartition(isoMonth));
-		}
-		const quarter = quarterOfMonth(isoMonth);
-		if (!seenQuarters.has(quarter)) {
-			seenQuarters.add(quarter);
-			out.push(quarterPartition(quarter));
-		}
-	}
-	return out;
-}
-function partitionSpan(partition) {
-	let m = partition.match(DAILY_PARTITION_RE);
-	if (m) {
-		const ms = Date.parse(`${m[1]}T00:00:00Z`);
-		return {
-			rank: 0,
-			startMs: ms,
-			endMs: ms
-		};
-	}
-	m = partition.match(WEEKLY_PARTITION_RE);
-	if (m) {
-		const ms = Date.parse(`${m[1]}T00:00:00Z`);
-		return {
-			rank: 1,
-			startMs: ms,
-			endMs: ms + 6 * MS_PER_DAY
-		};
-	}
-	m = partition.match(MONTHLY_PARTITION_RE);
-	if (m) {
-		const [y, mo] = m[1].split("-").map(Number);
-		return {
-			rank: 2,
-			startMs: Date.UTC(y, mo - 1, 1),
-			endMs: Date.UTC(y, mo, 0)
-		};
-	}
-	m = partition.match(QUARTERLY_PARTITION_RE);
-	if (m) {
-		const y = Number(m[1]);
-		const q = Number(m[2]);
-		return {
-			rank: 3,
-			startMs: Date.UTC(y, (q - 1) * 3, 1),
-			endMs: Date.UTC(y, q * 3, 0)
-		};
-	}
-}
-function splitOverlappingTiers(entries, queryRange) {
-	const rangeStartMs = queryRange ? Date.parse(`${queryRange.start}T00:00:00Z`) : void 0;
-	const rangeEndMs = queryRange ? Date.parse(`${queryRange.end}T00:00:00Z`) : void 0;
-	const spanned = [];
-	const kept = [];
-	const subsumed = [];
-	const clampToRange = Number.isFinite(rangeStartMs) && Number.isFinite(rangeEndMs);
-	for (const entry of entries) {
-		const span = partitionSpan(entry.partition);
-		if (!span) {
-			kept.push(entry);
-			continue;
-		}
-		const startMs = clampToRange ? Math.max(span.startMs, rangeStartMs) : span.startMs;
-		const endMs = clampToRange ? Math.min(span.endMs, rangeEndMs) : span.endMs;
-		if (queryRange && startMs > endMs) {
-			subsumed.push(entry);
-			continue;
-		}
-		spanned.push({
-			entry,
-			rank: span.rank,
-			startMs,
-			endMs
-		});
-	}
-	spanned.sort((a, b) => a.rank - b.rank || b.entry.createdAt - a.entry.createdAt);
-	const coveredBySearchType = /* @__PURE__ */ new Map();
-	for (const { entry, startMs, endMs } of spanned) {
-		const slice = inferSearchType(entry);
-		let covered = coveredBySearchType.get(slice);
-		if (!covered) {
-			covered = /* @__PURE__ */ new Set();
-			coveredBySearchType.set(slice, covered);
-		}
-		let fullyCovered = true;
-		for (let dayMs = startMs; dayMs <= endMs; dayMs += MS_PER_DAY) if (!covered.has(dayMs)) {
-			fullyCovered = false;
-			break;
-		}
-		if (fullyCovered) {
-			subsumed.push(entry);
-			continue;
-		}
-		kept.push(entry);
-		for (let dayMs = startMs; dayMs <= endMs; dayMs += MS_PER_DAY) covered.add(dayMs);
-	}
-	return {
-		kept,
-		subsumed
-	};
-}
-function dedupeOverlappingTiers(entries, queryRange) {
-	return splitOverlappingTiers(entries, queryRange).kept;
-}
-function monthEndMs(month) {
-	const [y, m] = month.split("-").map(Number);
-	return Date.UTC(y, m, 0, 23, 59, 59, 999);
-}
-function quarterEndMs(quarter) {
-	const [yStr, qStr] = quarter.split("-Q");
-	const y = Number(yStr);
-	const q = Number(qStr);
-	return Date.UTC(y, q * 3, 0, 23, 59, 59, 999);
-}
-export { compactTieredImpl, countRawDailies, dedupeOverlappingTiers, enumeratePartitions, splitOverlappingTiers };

package/dist/adapters/r2-manifest.d.mts

@@ -1,82 +0,0 @@
-import { ManifestStore, TableName } from "../_chunks/storage.mjs";
-interface R2ObjectMetadata {
-  etag: string;
-}
-interface R2ObjectBody extends R2ObjectMetadata {
-  text: () => Promise<string>;
-}
-interface R2ListResult {
-  objects: Array<{
-    key: string;
-  }>;
-  truncated: boolean;
-  cursor?: string;
-}
-interface R2ConditionalPutOptions {
-  /**
-   * Workers-binding-style precondition. `etagMatches` rejects with `null`
-   *  return on mismatch; `etagDoesNotMatch: '*'` rejects if the key exists.
-   */
-  onlyIf?: {
-    etagMatches?: string;
-    etagDoesNotMatch?: string;
-  };
-}
-/**
- * Minimal Cloudflare R2 binding shape needed for the manifest CAS loop.
- * Structurally compatible with Cloudflare's `R2Bucket` Workers API.
- */
-interface R2ManifestBucketLike {
-  get: (key: string) => Promise<R2ObjectBody | null>;
-  put: (key: string, bytes: string | Uint8Array, options?: R2ConditionalPutOptions) => Promise<R2ObjectMetadata | null>;
-  list: (options?: {
-    prefix?: string;
-    cursor?: string;
-    limit?: number;
-  }) => Promise<R2ListResult>;
-  /**
-   * Bulk delete. Required by {@link ManifestStore.purgeTenant}. Cloudflare's
-   * `R2Bucket.delete` accepts a single key or a string[] batch; both shapes
-   * work here.
-   */
-  delete: (keys: string | string[]) => Promise<void>;
-}
-/**
- * CAS lifecycle events emitted by the manifest store. Consumers wire these
- * into metrics (prom-client, console.table, the contention harness) to
- * measure rejection rate and latency under real R2 load.
- */
-type R2ManifestEvent = {
-  kind: 'cas-attempt';
-  siteId: string;
-  table: TableName;
-  attempt: number;
-} | {
-  kind: 'cas-rejected';
-  siteId: string;
-  table: TableName;
-  attempt: number;
-} | {
-  kind: 'cas-committed';
-  siteId: string;
-  table: TableName;
-  attempts: number;
-};
-interface CreateR2ManifestStoreOptions {
-  bucket: R2ManifestBucketLike;
-  /** Tenant scope. All shard keys are prefixed `u_<userId>/manifest/...`. */
-  userId: string;
-  /** Override the snapshot version-id generator. Defaults to `${ts}-${random}`. */
-  newSnapshotId?: () => string;
-  now?: () => number;
-  /** Maximum CAS retries before giving up. Defaults to 8. */
-  maxRetries?: number;
-  /**
-   * Optional telemetry hook. Fired synchronously from the CAS loop on each
-   * attempt, rejection, and successful commit. Must not throw; exceptions
-   * propagate and will fail the mutation.
-   */
-  onEvent?: (event: R2ManifestEvent) => void;
-}
-declare function createR2ManifestStore(opts: CreateR2ManifestStoreOptions): ManifestStore;
-export { CreateR2ManifestStoreOptions, R2ManifestBucketLike, R2ManifestEvent, createR2ManifestStore };