@gscdump/engine 0.11.5 → 0.13.0

package/dist/_chunks/storage.d.mts

@@ -1,4 +1,3 @@
-import { t as ComparisonFilter } from "./types.mjs";
 import { Row, Row as Row$1, TableName, TableName as TableName$1, TenantCtx, TenantCtx as TenantCtx$1 } from "@gscdump/contracts";
 import { BuilderState, SearchType, SearchType as SearchType$1 } from "gscdump/query";
 /**
@@ -298,25 +297,6 @@ interface QueryResult {
   sql: string;
   objectKeys: string[];
 }
-interface ComparisonResult {
-  rows: Row[];
-  totalCount: number;
-  totals: Record<string, unknown>;
-}
-interface ExtraResult {
-  key: string;
-  rows: Row[];
-}
-interface OptimizedQueryResult {
-  rows: Row[];
-  totalCount: number;
-  totals: {
-    clicks: number;
-    impressions: number;
-    ctr: number;
-    position: number;
-  };
-}
 interface QueryExecuteOptions {
   sql: string;
   params: unknown[];
@@ -403,35 +383,6 @@ interface RunSQLOptions {
 interface StorageEngine {
   writeDay: (ctx: WriteCtx, rows: Row[]) => Promise<void>;
   query: (ctx: QueryCtx, state: BuilderState) => Promise<QueryResult>;
-  /**
-   * Two-window comparison query (resolver-compiled). Joins a `current` and
-   * `previous` window CTE on dimensions, applies an optional row filter
-   * (`new`/`lost`/`improving`/`declining`), and returns the merged rows plus
-   * total count and unfiltered totals.
-   *
-   * Tenant scoping comes from `ctx.userId`/`ctx.siteId` (manifest lookup) —
-   * the SQL itself is single-tenant against the parquet adapter, which has
-   * `includeSiteId: false`.
-   *
-   * Throws if `current` and `previous` resolve to different tables.
-   */
-  queryComparison: (ctx: QueryCtx, current: BuilderState, previous: BuilderState, filter?: ComparisonFilter) => Promise<ComparisonResult>;
-  /**
-   * Canonical-variant enrichment queries. Returns one result per extra
-   * surface; today only `queryCanonical` triggers an extra. Empty array
-   * when the state has no extras-eligible dimensions.
-   */
-  queryExtras: (ctx: QueryCtx, state: BuilderState) => Promise<ExtraResult[]>;
-  /**
-   * Single-scan variant of {@link query} that piggy-backs `totalCount` and
-   * unfiltered metric totals onto the dimensioned result via window functions.
-   * Replaces the host-side rows + totals + count fan-out with one DuckDB
-   * execution. Window-function output columns (`totalCount`, `totalClicks`,
-   * `totalImpressions`, `totalCtr`, `totalPosition`) are stripped from `rows`
-   * before return; missing per-metric totals (when the metric was not
-   * requested in `state.metrics`) default to 0.
-   */
-  queryOptimized: (ctx: QueryCtx, state: BuilderState) => Promise<OptimizedQueryResult>;
   /**
    * Run arbitrary SQL resolved against named partition sets. Composes
    * manifest lookup + object reads + placeholder substitution + execution
@@ -490,4 +441,4 @@ interface EngineOptions {
 }
 declare function dayPartition(date: string): string;
 declare function objectKey(ctx: TenantCtx, table: TableName, partition: string, version: number, searchType?: SearchType): string;
-export { SyncStateDetail as A, WriteResult as B, QueryExecutor as C, SearchType$1 as D, RunSQLOptions as E, TenantCtx$1 as F, CompactionThresholds as G, inferLegacyTier as H, Watermark as I, enumeratePartitions as K, WatermarkFilter as L, SyncStateKind as M, SyncStateScope as N, StorageEngine as O, TableName$1 as P, WatermarkScope as R, QueryExecuteResult as S, Row$1 as T, inferSearchType as U, dayPartition as V, objectKey as W, PurgeFilter as _, DataSource as a, QueryCtx as b, FileSetRef as c, LockScope as d, ManifestEntry as f, ParquetCodec as g, OptimizedQueryResult as h, DEFAULT_SEARCH_TYPE as i, SyncStateFilter as j, SyncState as k, GcCtx as l, ManifestStore as m, CompactionTier as n, EngineOptions as o, ManifestPurgeResult as p, ComparisonResult as r, ExtraResult as s, CodecCtx as t, ListLiveFilter as u, PurgeResult as v, QueryResult as w, QueryExecuteOptions as x, PurgeUrlsResult as y, WriteCtx as z };
+export { SyncStateScope as A, inferSearchType as B, RunSQLOptions as C, SyncStateDetail as D, SyncState as E, WatermarkScope as F, CompactionThresholds as H, WriteCtx as I, WriteResult as L, TenantCtx$1 as M, Watermark as N, SyncStateFilter as O, WatermarkFilter as P, dayPartition as R, Row$1 as S, StorageEngine as T, enumeratePartitions as U, objectKey as V, QueryCtx as _, EngineOptions as a, QueryExecutor as b, ListLiveFilter as c, ManifestPurgeResult as d, ManifestStore as f, PurgeUrlsResult as g, PurgeResult as h, DataSource as i, TableName$1 as j, SyncStateKind as k, LockScope as l, PurgeFilter as m, CompactionTier as n, FileSetRef as o, ParquetCodec as p, DEFAULT_SEARCH_TYPE as r, GcCtx as s, CodecCtx as t, ManifestEntry as u, QueryExecuteOptions as v, SearchType$1 as w, QueryResult as x, QueryExecuteResult as y, inferLegacyTier as z };

package/dist/_chunks/types.d.mts

@@ -17,6 +17,7 @@ interface ResolverAdapter<TableKey extends string = string> {
   metricSql: (metric: Metric, tableKey: TableKey) => SQL;
   dimensionPredicates: (filters: InternalFilter[], tableKey: TableKey) => SQL[];
   havingPredicates: (filters: InternalFilter[], tableKey: TableKey) => SQL[];
+  prefilterPredicates: (filters: InternalFilter[], tableKey: TableKey) => SQL[];
   topLevelPredicate: (filters: InternalFilter[], tableKey: TableKey) => SQL | undefined;
   compile: (query: SQL) => {
     sql: string;

package/dist/adapters/filesystem.d.mts

@@ -1,4 +1,4 @@
-import { a as DataSource, m as ManifestStore } from "../_chunks/storage.mjs";
+import { f as ManifestStore, i as DataSource } from "../_chunks/storage.mjs";
 interface FilesystemDataSourceOptions {
   rootDir: string;
 }

package/dist/adapters/hyparquet.d.mts

@@ -1,4 +1,4 @@
-import { P as TableName, T as Row, a as DataSource, g as ParquetCodec, t as CodecCtx } from "../_chunks/storage.mjs";
+import { S as Row, i as DataSource, j as TableName, p as ParquetCodec, t as CodecCtx } from "../_chunks/storage.mjs";
 import { t as ColumnDef } from "../_chunks/schema.mjs";
 declare function encodeRowsToParquet(table: TableName, rows: readonly Row[]): Uint8Array;
 interface EncodeFlexOptions {

package/dist/adapters/node.d.mts

@@ -1,4 +1,4 @@
-import { O as StorageEngine, a as DataSource } from "../_chunks/storage.mjs";
+import { T as StorageEngine, i as DataSource } from "../_chunks/storage.mjs";
 import { NodeDuckDBOptions, createNodeDuckDBHandle, resetNodeDuckDB } from "./duckdb-node.mjs";
 import { t as SnapshotIndex } from "../_chunks/snapshot.mjs";
 import { Row, TableName } from "@gscdump/contracts";

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

@@ -1,4 +1,4 @@
-import { P as TableName, m as ManifestStore } from "../_chunks/storage.mjs";
+import { f as ManifestStore, j as TableName } from "../_chunks/storage.mjs";
 interface R2ObjectMetadata {
   etag: string;
 }

package/dist/adapters/r2.d.mts

@@ -1,4 +1,4 @@
-import { a as DataSource } from "../_chunks/storage.mjs";
+import { i as DataSource } from "../_chunks/storage.mjs";
 interface R2GetOptions {
   range?: {
     offset: number;

package/dist/contracts.d.mts

@@ -1,2 +1,2 @@
-import { A as SyncStateDetail, B as WriteResult, C as QueryExecutor, D as SearchType, E as RunSQLOptions, F as TenantCtx, I as Watermark, L as WatermarkFilter, M as SyncStateKind, N as SyncStateScope, O as StorageEngine, P as TableName, R as WatermarkScope, S as QueryExecuteResult, T as Row, a as DataSource, b as QueryCtx, c as FileSetRef, d as LockScope, f as ManifestEntry, g as ParquetCodec, j as SyncStateFilter, k as SyncState, l as GcCtx, m as ManifestStore, n as CompactionTier, o as EngineOptions, t as CodecCtx, u as ListLiveFilter, w as QueryResult, x as QueryExecuteOptions, z as WriteCtx } from "./_chunks/storage.mjs";
+import { A as SyncStateScope, C as RunSQLOptions, D as SyncStateDetail, E as SyncState, F as WatermarkScope, I as WriteCtx, L as WriteResult, M as TenantCtx, N as Watermark, O as SyncStateFilter, P as WatermarkFilter, S as Row, T as StorageEngine, _ as QueryCtx, a as EngineOptions, b as QueryExecutor, c as ListLiveFilter, f as ManifestStore, i as DataSource, j as TableName, k as SyncStateKind, l as LockScope, n as CompactionTier, o as FileSetRef, p as ParquetCodec, s as GcCtx, t as CodecCtx, u as ManifestEntry, v as QueryExecuteOptions, w as SearchType, x as QueryResult, y as QueryExecuteResult } from "./_chunks/storage.mjs";
 export { CodecCtx, CompactionTier, DataSource, EngineOptions, FileSetRef, GcCtx, ListLiveFilter, LockScope, ManifestEntry, ManifestStore, ParquetCodec, QueryCtx, QueryExecuteOptions, QueryExecuteResult, QueryExecutor, QueryResult, Row, RunSQLOptions, SearchType, StorageEngine, SyncState, SyncStateDetail, SyncStateFilter, SyncStateKind, SyncStateScope, TableName, TenantCtx, Watermark, WatermarkFilter, WatermarkScope, WriteCtx, WriteResult };

package/dist/entities.d.mts

@@ -1,4 +1,4 @@
-import { a as DataSource } from "./_chunks/storage.mjs";
+import { i as DataSource } from "./_chunks/storage.mjs";
 import { ScheduleState } from "./schedule.mjs";
 import { TenantCtx } from "@gscdump/contracts";
 /**

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { A as SyncStateDetail, B as WriteResult, C as QueryExecutor, D as SearchType, E as RunSQLOptions, F as TenantCtx, G as CompactionThresholds, H as inferLegacyTier, I as Watermark, K as enumeratePartitions, L as WatermarkFilter, M as SyncStateKind, N as SyncStateScope, O as StorageEngine, P as TableName, R as WatermarkScope, S as QueryExecuteResult, T as Row, U as inferSearchType, V as dayPartition, W as objectKey, _ as PurgeFilter, a as DataSource, b as QueryCtx, c as FileSetRef, d as LockScope, f as ManifestEntry, g as ParquetCodec, h as OptimizedQueryResult, i as DEFAULT_SEARCH_TYPE, j as SyncStateFilter, k as SyncState, l as GcCtx, m as ManifestStore, n as CompactionTier, o as EngineOptions, p as ManifestPurgeResult, r as ComparisonResult, s as ExtraResult, t as CodecCtx, u as ListLiveFilter, v as PurgeResult, w as QueryResult, x as QueryExecuteOptions, y as PurgeUrlsResult, z as WriteCtx } from "./_chunks/storage.mjs";
+import { A as SyncStateScope, B as inferSearchType, C as RunSQLOptions, D as SyncStateDetail, E as SyncState, F as WatermarkScope, H as CompactionThresholds, I as WriteCtx, L as WriteResult, M as TenantCtx, N as Watermark, O as SyncStateFilter, P as WatermarkFilter, R as dayPartition, S as Row, T as StorageEngine, U as enumeratePartitions, V as objectKey, _ as QueryCtx, a as EngineOptions, b as QueryExecutor, c as ListLiveFilter, d as ManifestPurgeResult, f as ManifestStore, g as PurgeUrlsResult, h as PurgeResult, i as DataSource, j as TableName, k as SyncStateKind, l as LockScope, m as PurgeFilter, n as CompactionTier, o as FileSetRef, p as ParquetCodec, r as DEFAULT_SEARCH_TYPE, s as GcCtx, t as CodecCtx, u as ManifestEntry, v as QueryExecuteOptions, w as SearchType, x as QueryResult, y as QueryExecuteResult, z as inferLegacyTier } from "./_chunks/storage.mjs";
 import { a as createDuckDBExecutor, i as createDuckDBCodec, n as DuckDBHandle, r as canonicalEmptyParquetSchema, t as DuckDBFactory } from "./_chunks/duckdb.mjs";
 import { _ as pages, a as allTables, c as inferTable, d as TABLE_METADATA, f as countries, g as page_keywords, h as keywords, i as TableSchema, m as drizzleSchema, n as ColumnType, o as currentSchemaVersion, p as devices, r as SCHEMAS, s as dimensionToColumn, t as ColumnDef, u as DrizzleSchema } from "./_chunks/schema.mjs";
 import { InspectionVerdict, SchedulePolicy, ScheduleState, fixedPolicy, inspectionPolicy, sitemapPolicy } from "./schedule.mjs";
@@ -10,4 +10,4 @@ declare function coerceRow(row: Row$1): Row$1;
 declare function coerceRows(rows: readonly Row$1[]): Row$1[];
 declare const MAX_DAY_BYTES: number;
 declare function createStorageEngine(opts: EngineOptions): StorageEngine;
-export { type CodecCtx, type ColumnDef, type ColumnType, type CompactionThresholds, type CompactionTier, type ComparisonResult, DEFAULT_SEARCH_TYPE, type DataSource, type DrizzleSchema, type DuckDBFactory, type DuckDBHandle, type EngineOptions, type ExtraResult, FILES_PLACEHOLDER, type FileSetRef, type GcCtx, type GscApiRow, type IngestOptions, type InspectionVerdict, type ListLiveFilter, type LockScope, MAX_DAY_BYTES, type ManifestEntry, type ManifestPurgeResult, type ManifestStore, type OptimizedQueryResult, type ParquetCodec, type PurgeFilter, type PurgeResult, type PurgeUrlsResult, type QueryCtx, type QueryExecuteOptions, type QueryExecuteResult, type QueryExecutor, type QueryResult, type ResolvedQuery, type Row, type RowAccumulator, type RowAccumulatorOptions, type RunSQLOptions, SCHEMAS, type SchedulePolicy, type ScheduleState, type SearchType, type StorageEngine, type SyncState, type SyncStateDetail, type SyncStateFilter, type SyncStateKind, type SyncStateScope, TABLE_METADATA, type TableName, type TableSchema, type TenantCtx, type Watermark, type WatermarkFilter, type WatermarkScope, type WriteCtx, type WriteResult, allTables, bindLiterals, canonicalEmptyParquetSchema, coerceRow, coerceRows, countries, createDuckDBCodec, createDuckDBExecutor, createRowAccumulator, createStorageEngine, currentSchemaVersion, dayPartition, devices, dimensionToColumn, drizzleSchema, enumeratePartitions, fixedPolicy, formatLiteral, inferLegacyTier, inferSearchType, inferTable, inspectionPolicy, keywords, objectKey, page_keywords, pages, resolveToSQL, sitemapPolicy, substituteNamedFiles, toPath, toSumPosition, transformGscRow };
+export { type CodecCtx, type ColumnDef, type ColumnType, type CompactionThresholds, type CompactionTier, DEFAULT_SEARCH_TYPE, type DataSource, type DrizzleSchema, type DuckDBFactory, type DuckDBHandle, type EngineOptions, FILES_PLACEHOLDER, type FileSetRef, type GcCtx, type GscApiRow, type IngestOptions, type InspectionVerdict, type ListLiveFilter, type LockScope, MAX_DAY_BYTES, type ManifestEntry, type ManifestPurgeResult, type ManifestStore, type ParquetCodec, type PurgeFilter, type PurgeResult, type PurgeUrlsResult, type QueryCtx, type QueryExecuteOptions, type QueryExecuteResult, type QueryExecutor, type QueryResult, type ResolvedQuery, type Row, type RowAccumulator, type RowAccumulatorOptions, type RunSQLOptions, SCHEMAS, type SchedulePolicy, type ScheduleState, type SearchType, type StorageEngine, type SyncState, type SyncStateDetail, type SyncStateFilter, type SyncStateKind, type SyncStateScope, TABLE_METADATA, type TableName, type TableSchema, type TenantCtx, type Watermark, type WatermarkFilter, type WatermarkScope, type WriteCtx, type WriteResult, allTables, bindLiterals, canonicalEmptyParquetSchema, coerceRow, coerceRows, countries, createDuckDBCodec, createDuckDBExecutor, createRowAccumulator, createStorageEngine, currentSchemaVersion, dayPartition, devices, dimensionToColumn, drizzleSchema, enumeratePartitions, fixedPolicy, formatLiteral, inferLegacyTier, inferSearchType, inferTable, inspectionPolicy, keywords, objectKey, page_keywords, pages, resolveToSQL, sitemapPolicy, substituteNamedFiles, toPath, toSumPosition, transformGscRow };

package/dist/index.mjs

@@ -1,3 +1,4 @@
+import { n as coerceRows, t as coerceRow } from "./_chunks/coerce.mjs";
 import { a as inferTable, c as countries, d as keywords, f as page_keywords, i as dimensionToColumn, l as devices, n as allTables, p as pages, r as currentSchemaVersion, s as TABLE_METADATA, t as SCHEMAS, u as drizzleSchema } from "./_chunks/schema.mjs";
 import { i as inferSearchType, n as dayPartition, r as inferLegacyTier, s as objectKey, t as DEFAULT_SEARCH_TYPE } from "./_chunks/storage.mjs";
 import { i as substituteNamedFiles, o as enumeratePartitions, r as resolveToSQL, t as FILES_PLACEHOLDER } from "./_chunks/compiler.mjs";
@@ -6,17 +7,4 @@ import { a as createDuckDBExecutor, i as createDuckDBCodec, n as createStorageEn
 import { createRowAccumulator, toPath, toSumPosition, transformGscRow } from "./ingest.mjs";
 import "./planner.mjs";
 import { fixedPolicy, inspectionPolicy, sitemapPolicy } from "./schedule.mjs";
-function coerceRow(row) {
-	let mutated = null;
-	for (const [k, v] of Object.entries(row)) if (typeof v === "bigint") {
-		if (!mutated) mutated = { ...row };
-		mutated[k] = Number(v);
-	}
-	return mutated ?? row;
-}
-function coerceRows(rows) {
-	const out = Array.from({ length: rows.length });
-	for (let i = 0; i < rows.length; i++) out[i] = coerceRow(rows[i]);
-	return out;
-}
 export { DEFAULT_SEARCH_TYPE, FILES_PLACEHOLDER, MAX_DAY_BYTES, SCHEMAS, TABLE_METADATA, allTables, bindLiterals, canonicalEmptyParquetSchema, coerceRow, coerceRows, countries, createDuckDBCodec, createDuckDBExecutor, createRowAccumulator, createStorageEngine, currentSchemaVersion, dayPartition, devices, dimensionToColumn, drizzleSchema, enumeratePartitions, fixedPolicy, formatLiteral, inferLegacyTier, inferSearchType, inferTable, inspectionPolicy, keywords, objectKey, page_keywords, pages, resolveToSQL, sitemapPolicy, substituteNamedFiles, toPath, toSumPosition, transformGscRow };

package/dist/ingest.d.mts

@@ -1,4 +1,4 @@
-import { P as TableName, T as Row } from "./_chunks/storage.mjs";
+import { S as Row, j as TableName } from "./_chunks/storage.mjs";
 /**
  * Canonical GSC API dimension order per table. Consumers hitting the raw
  * `searchanalytics.query` endpoint must request dimensions in this order so

package/dist/planner.d.mts

@@ -1,3 +1,3 @@
-import { K as enumeratePartitions } from "./_chunks/storage.mjs";
+import { U as enumeratePartitions } from "./_chunks/storage.mjs";
 import { a as substituteNamedFiles, i as resolveToSQL, n as ResolvedQuery, r as compileLogicalQueryPlan, t as FILES_PLACEHOLDER } from "./_chunks/planner.mjs";
 export { FILES_PLACEHOLDER, ResolvedQuery, compileLogicalQueryPlan, enumeratePartitions, resolveToSQL, substituteNamedFiles };

package/dist/resolver/index.d.mts

@@ -49,6 +49,7 @@ interface SqlFragments<TableKey extends string> {
   dimExprSql: (dim: Dimension, tableKey: TableKey) => SQL;
   metricSql: (metric: Metric, tableKey: TableKey) => SQL;
   havingPredicates: (filters: InternalFilter[], tableKey: TableKey) => SQL[];
+  prefilterPredicates: (filters: InternalFilter[], tableKey: TableKey) => SQL[];
   dimensionPredicates: (filters: InternalFilter[], tableKey: TableKey) => SQL[];
   topLevelPredicate: (filters: InternalFilter[], tableKey: TableKey) => SQL | undefined;
 }

package/dist/resolver/index.mjs

@@ -1,3 +1,2 @@
-import { a as DIMENSION_SURFACES, c as dimensionColumn, d as buildExtrasQueries, f as buildTotalsSql, g as resolveToSQLOptimized, h as resolveToSQL, i as createSqlFragments, l as inferLogicalDataset, m as resolveComparisonSQL, n as pgResolverAdapter, o as LOGICAL_DATASETS, p as mergeExtras, r as createResolverAdapter, s as assertDimensionsSupported, t as createParquetResolverAdapter, u as supportsDimensionOnSurface } from "../_chunks/pg-adapter.mjs";
-import { a as getInternalFilters, c as matchesTopLevelPage, i as getFilterDimensions, l as metricValue, n as dimensionValue, o as matchesDimensionFilter, r as getDimensionFilters, s as matchesMetricFilter, t as assertSchemaInSync } from "../_chunks/resolver.mjs";
+import { C as dimensionColumn, S as assertDimensionsSupported, T as supportsDimensionOnSurface, _ as resolveToSQLOptimized, a as getDimensionFilters, b as DIMENSION_SURFACES, c as matchesDimensionFilter, d as metricValue, f as buildExtrasQueries, g as resolveToSQL, h as resolveComparisonSQL, i as dimensionValue, l as matchesMetricFilter, m as mergeExtras, n as createParquetResolverAdapter, o as getFilterDimensions, p as buildTotalsSql, r as pgResolverAdapter, s as getInternalFilters, t as assertSchemaInSync, u as matchesTopLevelPage, v as createResolverAdapter, w as inferLogicalDataset, x as LOGICAL_DATASETS, y as createSqlFragments } from "../_chunks/resolver.mjs";
 export { DIMENSION_SURFACES, LOGICAL_DATASETS, assertDimensionsSupported, assertSchemaInSync, buildExtrasQueries, buildTotalsSql, createParquetResolverAdapter, createResolverAdapter, createSqlFragments, dimensionColumn, dimensionValue, getDimensionFilters, getFilterDimensions, getInternalFilters, inferLogicalDataset, matchesDimensionFilter, matchesMetricFilter, matchesTopLevelPage, mergeExtras, metricValue, pgResolverAdapter, resolveComparisonSQL, resolveToSQL, resolveToSQLOptimized, supportsDimensionOnSurface };

package/dist/rollups.d.mts

@@ -1,4 +1,4 @@
-import { a as DataSource, c as FileSetRef } from "./_chunks/storage.mjs";
+import { i as DataSource, o as FileSetRef } from "./_chunks/storage.mjs";
 import { t as ColumnDef } from "./_chunks/schema.mjs";
 import { TenantCtx } from "@gscdump/contracts";
 import * as _$_gscdump_engine_contracts0 from "@gscdump/engine/contracts";

package/dist/source/index.d.mts

@@ -1,14 +1,15 @@
-import { F as TenantCtx, O as StorageEngine, T as Row } from "../_chunks/storage.mjs";
-import { o as ResolverAdapter } from "../_chunks/types.mjs";
+import { M as TenantCtx, S as Row, T as StorageEngine } from "../_chunks/storage.mjs";
 import { n as AnalysisResult, t as AnalysisParams } from "../_chunks/analysis-types.mjs";
+import { o as ResolverAdapter } from "../_chunks/types.mjs";
 import { C as ExecuteSqlOptions, E as SourceCapabilities, S as AnalysisSourceKind, T as QueryRow, t as AnalyzerRegistry, w as FileSet, x as AnalysisQuerySource } from "../_chunks/registry.mjs";
 import { PlannerCapabilities } from "gscdump/query/plan";
 import { BuilderState } from "gscdump/query";
 interface AttachedTableRunner {
   /**
    * Run a query with positional (`?`) bound parameters. Return objects keyed
-   * by column name. The runner MUST coerce BIGINT → number and DATE → ISO
-   * string (or let the analyzer reducer normalize via `num(v)`/`str(v)`).
+   * by column name. BIGINT → number coercion is applied by the source factory
+   * (see `coerceRows`); runners only need to handle DATE → ISO string (or
+   * let the analyzer reducer normalize via `num(v)`/`str(v)`).
    */
   query: (sql: string, params?: unknown[], signal?: AbortSignal) => Promise<Row[]>;
 }

package/dist/source/index.mjs

@@ -1,5 +1,5 @@
-import { h as resolveToSQL, n as pgResolverAdapter, s as assertDimensionsSupported } from "../_chunks/pg-adapter.mjs";
-import { i as getFilterDimensions } from "../_chunks/resolver.mjs";
+import { n as coerceRows } from "../_chunks/coerce.mjs";
+import { S as assertDimensionsSupported, g as resolveToSQL, o as getFilterDimensions, r as pgResolverAdapter } from "../_chunks/resolver.mjs";
 import { n as runAnalyzerFromSource } from "../_chunks/dispatch.mjs";
 var AttachedTableMissingError = class extends Error {
 	missing;
@@ -12,8 +12,7 @@ var AttachedTableMissingError = class extends Error {
 const ATTACHED_TABLE_CAPABILITIES = {
 	fileSets: true,
 	attachedTables: true,
-	regex: true,
-	executeSql: true
+	regex: true
 };
 const ATTACHED_TABLE_CAPABILITIES_WITH_ADAPTER = {
 	...ATTACHED_TABLE_CAPABILITIES,
@@ -47,7 +46,7 @@ function createAttachedTableSource(runner, options) {
 				if (missing.length > 0) throw new AttachedTableMissingError(missing);
 			}
 			const rewritten = rewriteForTableSource(sql, schema, fileSets);
-			return await runner.query(rewritten, params ?? [], signal);
+			return coerceRows(await runner.query(rewritten, params ?? [], signal));
 		}
 	};
 }
@@ -59,7 +58,6 @@ function createSqlQuerySource(options) {
 		capabilities: {
 			...adapter.capabilities,
 			...extraCapabilities,
-			executeSql: true,
 			adapter: true
 		},
 		adapter,
@@ -69,10 +67,10 @@ function createSqlQuerySource(options) {
 				adapter,
 				siteId
 			});
-			return execute(resolved.sql, resolved.params);
+			return coerceRows(await execute(resolved.sql, resolved.params));
 		},
-		executeSql(sql, params) {
-			return execute(sql, params ?? []);
+		async executeSql(sql, params) {
+			return coerceRows(await execute(sql, params ?? []));
 		}
 	};
 }
@@ -93,7 +91,6 @@ const ENGINE_QUERY_CAPABILITIES = {
 const ENGINE_SOURCE_CAPABILITIES = {
 	...ENGINE_QUERY_CAPABILITIES,
 	fileSets: true,
-	executeSql: true,
 	adapter: true
 };
 function createEngineQuerySource(options) {
@@ -107,7 +104,7 @@ function createEngineQuerySource(options) {
 			const filterDims = getFilterDimensions(state.filter, isMetricDimension);
 			assertDimensionsSupported([...state.dimensions, ...filterDims], "stored", "engine query source");
 			if (state.dimensions.includes("queryCanonical") || filterDims.includes("queryCanonical")) throw new Error("engine query source does not support queryCanonical; use browser/sqlite query sources for derived dimensions");
-			return (await engine.query(ctx, state)).rows;
+			return coerceRows((await engine.query(ctx, state)).rows);
 		},
 		async executeSql(sql, params, opts) {
 			const fileSets = opts?.fileSets;
@@ -119,7 +116,7 @@ function createEngineQuerySource(options) {
 				sql,
 				params: params ?? []
 			});
-			return rows;
+			return coerceRows(rows);
 		}
 	};
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/engine",
   "type": "module",
-  "version": "0.11.5",
+  "version": "0.13.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",
@@ -169,8 +169,8 @@
   "dependencies": {
     "drizzle-orm": "^0.45.2",
     "proper-lockfile": "^4.1.2",
-    "gscdump": "0.11.5",
-    "@gscdump/contracts": "0.11.5"
+    "@gscdump/contracts": "0.13.0",
+    "gscdump": "0.13.0"
   },
   "devDependencies": {
     "@duckdb/duckdb-wasm": "^1.32.0",