@lpdjs/firestore-repo-service 2.3.2 → 2.3.4

package/dist/sync/bigquery.d.ts

@@ -1,4 +1,4 @@
-import { b as SqlDialect, a as SqlAdapter, c as SqlTableDef, d as SqlColumn } from '../types-CBwcflkG.js';
+import { b as SqlDialect, a as SqlAdapter, c as SqlTableDef, d as SqlColumn } from '../types-Bhy7MfCj.js';
 import '../firebase-auth-D1APf9PA.js';
 import 'firebase-functions/v2/firestore';
 import 'firebase-functions/v2/https';
@@ -36,6 +36,11 @@ declare class BigQueryAdapter implements SqlAdapter {
     tableExists(tableName: string): Promise<boolean>;
     /** Return the column names currently present in the table. */
     getTableColumns(tableName: string): Promise<string[]>;
+    /**
+     * Return existing columns with their normalized BigQuery type strings.
+     * Used by the worker to detect type drift before applying schema changes.
+     */
+    getTableColumnsWithTypes(tableName: string): Promise<Map<string, string>>;
     /** Create a table using a fully-qualified name. */
     createTable(table: SqlTableDef): Promise<void>;
     /** Add columns to an existing table using a fully-qualified name. */

package/dist/sync/bigquery.js

@@ -1,9 +1,9 @@
-var o="__sync_version";var d=class{constructor(){this.name="bigquery";}mapType(t){switch(t){case "string":return "STRING";case "number":return "FLOAT64";case "bigint":return "INT64";case "boolean":return "BOOL";case "timestamp":return "TIMESTAMP";case "json":return "JSON";case "text":return "STRING"}}quoteIdentifier(t){return `\`${t}\``}},f=new d,c=class c{constructor(t){this.bigquery=t.bigquery,this.datasetId=t.datasetId;}get dialect(){return f}async tableExists(t){let[e]=await this.dataset.table(t).exists();return e}async getTableColumns(t){let[e]=await this.dataset.table(t).getMetadata();return (e.schema?.fields??[]).map(s=>s.name)}async createTable(t){let e=a=>this.dialect.quoteIdentifier(a),r=t.columns.map(a=>{let n=a.isPrimaryKey?" NOT NULL":"";return `  ${e(a.name)} ${a.sqlType}${n}`}).join(`,
-`),s=`CREATE TABLE IF NOT EXISTS ${this.fqn(t.tableName)} (
-${r}
-);`;await this.bigquery.query({query:s});}async addColumns(t,e){let r=s=>this.dialect.quoteIdentifier(s);for(let s of e){let a=`ALTER TABLE ${this.fqn(t)} ADD COLUMN ${r(s.name)} ${s.sqlType};`;await this.bigquery.query({query:a});}}async insertRows(t,e){e.length!==0&&await this.dataset.table(t).insert(e);}async upsertRows(t,e,r){if(e.length===0)return;let s=Object.keys(e[0]),a=s.filter(i=>i!==r),n=i=>this.dialect.quoteIdentifier(i),q=e.map((i,E)=>`SELECT ${s.map(u=>E===0?`${this.escapeValue(i[u])} AS ${n(u)}`:this.escapeValue(i[u])).join(", ")}`).join(` UNION ALL
-    `),y=a.map(i=>`T.${n(i)} = S.${n(i)}`).join(", "),S=s.map(i=>n(i)).join(", "),T=s.map(i=>`S.${n(i)}`).join(", "),m=s.includes(o)?` AND (T.${n(o)} IS NULL OR S.${n(o)} > T.${n(o)})`:"",p=[`MERGE ${this.fqn(t)} AS T`,`USING (
-    ${q}
-  ) AS S`,`ON T.${n(r)} = S.${n(r)}`,`WHEN MATCHED${m} THEN UPDATE SET ${y}`,`WHEN NOT MATCHED THEN INSERT (${S}) VALUES (${T});`].join(`
-`);await this.bigquery.query({query:p});}async deleteRows(t,e,r){if(r.length===0)return;let s=l=>this.dialect.quoteIdentifier(l),a=r.map(l=>this.escapeValue(l)).join(", "),n=`DELETE FROM ${this.fqn(t)} WHERE ${s(e)} IN (${a});`;await this.bigquery.query({query:n});}async executeRaw(t){await this.bigquery.query({query:t});}get dataset(){return this.bigquery.dataset(this.datasetId)}fqn(t){return `\`${this.datasetId}.${t}\``}escapeValue(t){return t==null?"NULL":typeof t=="boolean"?t?"TRUE":"FALSE":typeof t=="number"||typeof t=="bigint"?String(t):typeof t=="string"?c.ISO_TIMESTAMP_RE.test(t)?`TIMESTAMP('${t}')`:t.startsWith("[")&&t.endsWith("]")||t.startsWith("{")&&t.endsWith("}")?`PARSE_JSON('${t.replace(/'/g,"\\'")}')`:`'${t.replace(/'/g,"\\'")}'`:`PARSE_JSON('${JSON.stringify(t).replace(/'/g,"\\'")}')`}};c.ISO_TIMESTAMP_RE=/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/;var g=c;export{g as BigQueryAdapter,f as bigqueryDialect};//# sourceMappingURL=bigquery.js.map
+var u="__sync_version";function T(o){let t=o.toUpperCase();switch(t){case "INTEGER":return "INT64";case "FLOAT":return "FLOAT64";case "BOOLEAN":return "BOOL";default:return t}}function N(o){if(!o||typeof o!="object")return  false;let t=o;return t.code!==400?false:(Array.isArray(t.errors)?t.errors:[]).some(n=>typeof n?.message=="string"&&n.message.toLowerCase().includes("serialize access"))}async function y(o,t=10,s=500){let n=0;for(;;)try{return await o()}catch(e){if(n++,!N(e)||n>t)throw e;let r=s*Math.pow(2,n),i=Math.random()*r;await new Promise(c=>setTimeout(c,i));}}var g=class{constructor(){this.name="bigquery";}mapType(t){switch(t){case "string":return "STRING";case "number":return "FLOAT64";case "bigint":return "INT64";case "boolean":return "BOOL";case "timestamp":return "TIMESTAMP";case "json":return "JSON";case "text":return "STRING"}}quoteIdentifier(t){return `\`${t}\``}},A=new g,l=class l{constructor(t){this.bigquery=t.bigquery,this.datasetId=t.datasetId;}get dialect(){return A}async tableExists(t){let[s]=await this.dataset.table(t).exists();return s}async getTableColumns(t){let[s]=await this.dataset.table(t).getMetadata();return (s.schema?.fields??[]).map(e=>e.name)}async getTableColumnsWithTypes(t){let[s]=await this.dataset.table(t).getMetadata(),n=s.schema?.fields??[],e=new Map;for(let r of n)e.set(r.name,T(r.type));return e}async createTable(t){let s=r=>this.dialect.quoteIdentifier(r),n=t.columns.map(r=>{let i=r.isPrimaryKey?" NOT NULL":"";return `  ${s(r.name)} ${r.sqlType}${i}`}).join(`,
+`),e=`CREATE TABLE IF NOT EXISTS ${this.fqn(t.tableName)} (
+${n}
+);`;await this.bigquery.query({query:e});}async addColumns(t,s){let n=e=>this.dialect.quoteIdentifier(e);for(let e of s){let r=`ALTER TABLE ${this.fqn(t)} ADD COLUMN ${n(e.name)} ${e.sqlType};`;await this.bigquery.query({query:r});}}async insertRows(t,s){s.length!==0&&await this.dataset.table(t).insert(s);}async upsertRows(t,s,n){if(s.length===0)return;let e=Object.keys(s[0]),r=e.filter(a=>a!==n),i=a=>this.dialect.quoteIdentifier(a),m=s.map((a,I)=>`SELECT ${e.map(d=>I===0?`${this.escapeValue(a[d])} AS ${i(d)}`:this.escapeValue(a[d])).join(", ")}`).join(` UNION ALL
+    `),f=r.map(a=>`T.${i(a)} = S.${i(a)}`).join(", "),E=e.map(a=>i(a)).join(", "),S=e.map(a=>`S.${i(a)}`).join(", "),q=e.includes(u)?` AND (T.${i(u)} IS NULL OR S.${i(u)} > T.${i(u)})`:"",h=[`MERGE ${this.fqn(t)} AS T`,`USING (
+    ${m}
+  ) AS S`,`ON T.${i(n)} = S.${i(n)}`,`WHEN MATCHED${q} THEN UPDATE SET ${f}`,`WHEN NOT MATCHED THEN INSERT (${E}) VALUES (${S});`].join(`
+`);await y(()=>this.bigquery.query({query:h}));}async deleteRows(t,s,n){if(n.length===0)return;let e=c=>this.dialect.quoteIdentifier(c),r=n.map(c=>this.escapeValue(c)).join(", "),i=`DELETE FROM ${this.fqn(t)} WHERE ${e(s)} IN (${r});`;await y(()=>this.bigquery.query({query:i}));}async executeRaw(t){await this.bigquery.query({query:t});}get dataset(){return this.bigquery.dataset(this.datasetId)}fqn(t){return `\`${this.datasetId}.${t}\``}escapeValue(t){return t==null?"NULL":typeof t=="boolean"?t?"TRUE":"FALSE":typeof t=="number"||typeof t=="bigint"?String(t):typeof t=="string"?l.ISO_TIMESTAMP_RE.test(t)?`TIMESTAMP('${t}')`:t.startsWith("[")&&t.endsWith("]")||t.startsWith("{")&&t.endsWith("}")?`PARSE_JSON('${t.replace(/'/g,"\\'")}')`:`'${t.replace(/'/g,"\\'")}'`:`PARSE_JSON('${JSON.stringify(t).replace(/'/g,"\\'")}')`}};l.ISO_TIMESTAMP_RE=/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/;var p=l;export{p as BigQueryAdapter,A as bigqueryDialect};//# sourceMappingURL=bigquery.js.map
 //# sourceMappingURL=bigquery.js.map

package/dist/sync/bigquery.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/sync/constants.ts","../../src/sync/adapters/bigquery.ts"],"names":["SYNC_VERSION_COLUMN","BigQueryDialect","logical","id","bigqueryDialect","_BigQueryAdapter","options","tableName","exists","metadata","f","table","qi","cols","c","notNull","ddl","columns","stmt","rows","primaryKey","allKeys","nonPkCols","k","source","row","i","updateSet","insertCols","insertVals","versionGuard","query","ids","escaped","v","sql","BigQueryAdapter"],"mappings":"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","file":"bigquery.js","sourcesContent":["/**\n * Internal constants shared between the worker, queue, schema mapper and\n * SQL adapters.\n */\n\n/**\n * Name of the SQL column that stores the publish-time `version` of each\n * sync event. Used by the worker to discard out-of-order PubSub deliveries\n * (the MERGE only updates rows when the incoming version is strictly\n * greater than the stored one).\n *\n * Two underscores prefix avoids collisions with user-defined fields.\n */\nexport const SYNC_VERSION_COLUMN = \"__sync_version\";\n","import { SYNC_VERSION_COLUMN } from \"../constants\";\nimport type {\n  LogicalType,\n  SqlAdapter,\n  SqlColumn,\n  SqlDialect,\n  SqlTableDef,\n} from \"../types\";\n\n// ---------------------------------------------------------------------------\n// Dialect (internal — used only by BigQueryAdapter)\n// ---------------------------------------------------------------------------\n\n/** BigQuery SQL dialect mapping. */\nclass BigQueryDialect implements SqlDialect {\n  readonly name = \"bigquery\";\n\n  mapType(logical: LogicalType): string {\n    switch (logical) {\n      case \"string\":\n        return \"STRING\";\n      case \"number\":\n        return \"FLOAT64\";\n      case \"bigint\":\n        return \"INT64\";\n      case \"boolean\":\n        return \"BOOL\";\n      case \"timestamp\":\n        return \"TIMESTAMP\";\n      case \"json\":\n        return \"JSON\";\n      case \"text\":\n        return \"STRING\";\n    }\n  }\n\n  quoteIdentifier(id: string): string {\n    return `\\`${id}\\``;\n  }\n}\n\n/** Shared BigQuery dialect singleton. */\nexport const bigqueryDialect: SqlDialect = new BigQueryDialect();\n\n// ---------------------------------------------------------------------------\n// Adapter\n// ---------------------------------------------------------------------------\n\n/**\n * BigQuery implementation of {@link SqlAdapter}.\n *\n * Accepts an already-configured BigQuery client so the library does not pull\n * in `@google-cloud/bigquery` as a hard dependency.\n *\n * @example\n * ```ts\n * import { BigQuery } from \"@google-cloud/bigquery\";\n * import { BigQueryAdapter } from \"./adapters/bigquery\";\n *\n * const adapter = new BigQueryAdapter({\n *   bigquery: new BigQuery({ projectId: \"my-project\" }),\n *   datasetId: \"my_dataset\",\n * });\n * ```\n */\nexport class BigQueryAdapter implements SqlAdapter {\n  private readonly bigquery: any;\n  private readonly datasetId: string;\n\n  constructor(options: { bigquery: any; datasetId: string }) {\n    this.bigquery = options.bigquery;\n    this.datasetId = options.datasetId;\n  }\n\n  /** The BigQuery SQL dialect. */\n  get dialect(): SqlDialect {\n    return bigqueryDialect;\n  }\n\n  /** Check whether a table exists in the dataset. */\n  async tableExists(tableName: string): Promise<boolean> {\n    const [exists] = await this.dataset.table(tableName).exists();\n    return exists;\n  }\n\n  /** Return the column names currently present in the table. */\n  async getTableColumns(tableName: string): Promise<string[]> {\n    const [metadata] = await this.dataset.table(tableName).getMetadata();\n    const fields: Array<{ name: string }> = metadata.schema?.fields ?? [];\n    return fields.map((f) => f.name);\n  }\n\n  /** Create a table using a fully-qualified name. */\n  async createTable(table: SqlTableDef): Promise<void> {\n    const qi = (id: string) => this.dialect.quoteIdentifier(id);\n    const cols = table.columns\n      .map((c) => {\n        const notNull = c.isPrimaryKey ? \" NOT NULL\" : \"\";\n        return `  ${qi(c.name)} ${c.sqlType}${notNull}`;\n      })\n      .join(\",\\n\");\n\n    const ddl = `CREATE TABLE IF NOT EXISTS ${this.fqn(table.tableName)} (\\n${cols}\\n);`;\n    await this.bigquery.query({ query: ddl });\n  }\n\n  /** Add columns to an existing table using a fully-qualified name. */\n  async addColumns(tableName: string, columns: SqlColumn[]): Promise<void> {\n    const qi = (id: string) => this.dialect.quoteIdentifier(id);\n    for (const c of columns) {\n      const stmt = `ALTER TABLE ${this.fqn(tableName)} ADD COLUMN ${qi(c.name)} ${c.sqlType};`;\n      await this.bigquery.query({ query: stmt });\n    }\n  }\n\n  /** Append rows via BigQuery streaming insert. */\n  async insertRows(\n    tableName: string,\n    rows: Record<string, unknown>[],\n  ): Promise<void> {\n    if (rows.length === 0) return;\n    await this.dataset.table(tableName).insert(rows);\n  }\n\n  /**\n   * Upsert rows using a MERGE DML statement.\n   *\n   * Builds a source table from inline SELECT … UNION ALL rows and merges\n   * into the target on the given primary key.\n   */\n  async upsertRows(\n    tableName: string,\n    rows: Record<string, unknown>[],\n    primaryKey: string,\n  ): Promise<void> {\n    if (rows.length === 0) return;\n\n    const allKeys = Object.keys(rows[0]!);\n    const nonPkCols = allKeys.filter((k) => k !== primaryKey);\n    const qi = (id: string) => this.dialect.quoteIdentifier(id);\n\n    // Build inline source: SELECT val AS col, … UNION ALL SELECT …\n    const selects = rows.map((row, i) => {\n      const values = allKeys\n        .map((k) => {\n          const aliased =\n            i === 0\n              ? `${this.escapeValue(row[k])} AS ${qi(k)}`\n              : this.escapeValue(row[k]);\n          return aliased;\n        })\n        .join(\", \");\n      return `SELECT ${values}`;\n    });\n\n    const source = selects.join(\" UNION ALL\\n    \");\n\n    // UPDATE SET clause (non-PK columns).\n    // Note: when __sync_version is present we still update it so the row\n    // tracks the latest applied version.\n    const updateSet = nonPkCols\n      .map((c) => `T.${qi(c)} = S.${qi(c)}`)\n      .join(\", \");\n\n    // INSERT columns / values\n    const insertCols = allKeys.map((c) => qi(c)).join(\", \");\n    const insertVals = allKeys.map((c) => `S.${qi(c)}`).join(\", \");\n\n    // Out-of-order protection: only UPDATE when the incoming version is\n    // strictly greater than the stored one (NULL stored version means the\n    // row pre-dates versioning → always update).\n    const versionGuard = allKeys.includes(SYNC_VERSION_COLUMN)\n      ? ` AND (T.${qi(SYNC_VERSION_COLUMN)} IS NULL OR S.${qi(SYNC_VERSION_COLUMN)} > T.${qi(SYNC_VERSION_COLUMN)})`\n      : \"\";\n\n    const query = [\n      `MERGE ${this.fqn(tableName)} AS T`,\n      `USING (\\n    ${source}\\n  ) AS S`,\n      `ON T.${qi(primaryKey)} = S.${qi(primaryKey)}`,\n      `WHEN MATCHED${versionGuard} THEN UPDATE SET ${updateSet}`,\n      `WHEN NOT MATCHED THEN INSERT (${insertCols}) VALUES (${insertVals});`,\n    ].join(\"\\n\");\n\n    await this.bigquery.query({ query });\n  }\n\n  /** Delete rows by primary-key values. */\n  async deleteRows(\n    tableName: string,\n    primaryKey: string,\n    ids: string[],\n  ): Promise<void> {\n    if (ids.length === 0) return;\n\n    const qi = (id: string) => this.dialect.quoteIdentifier(id);\n    const escaped = ids.map((v) => this.escapeValue(v)).join(\", \");\n    const query = `DELETE FROM ${this.fqn(tableName)} WHERE ${qi(primaryKey)} IN (${escaped});`;\n\n    await this.bigquery.query({ query });\n  }\n\n  /** Execute a raw SQL statement (used by the migration manager). */\n  async executeRaw(sql: string): Promise<void> {\n    await this.bigquery.query({ query: sql });\n  }\n\n  // -------------------------------------------------------------------------\n  // Private helpers\n  // -------------------------------------------------------------------------\n\n  /** The BigQuery Dataset handle. */\n  private get dataset() {\n    return this.bigquery.dataset(this.datasetId);\n  }\n\n  /** Return the fully-qualified table reference (`` `dataset.table` ``). */\n  private fqn(tableName: string): string {\n    return `\\`${this.datasetId}.${tableName}\\``;\n  }\n\n  /** ISO 8601 timestamp pattern (e.g. 2026-03-29T20:59:27.394Z) */\n  private static readonly ISO_TIMESTAMP_RE =\n    /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}/;\n\n  /** Escape a value for use as a SQL literal. */\n  private escapeValue(v: unknown): string {\n    if (v === null || v === undefined) return \"NULL\";\n    if (typeof v === \"boolean\") return v ? \"TRUE\" : \"FALSE\";\n    if (typeof v === \"number\" || typeof v === \"bigint\") return String(v);\n    if (typeof v === \"string\") {\n      // ISO 8601 timestamps → TIMESTAMP literal (keeps type-safety with BQ TIMESTAMP columns)\n      if (BigQueryAdapter.ISO_TIMESTAMP_RE.test(v)) {\n        return `TIMESTAMP('${v}')`;\n      }\n      // Detect JSON strings (arrays/objects) → use PARSE_JSON for native JSON columns\n      if (\n        (v.startsWith(\"[\") && v.endsWith(\"]\")) ||\n        (v.startsWith(\"{\") && v.endsWith(\"}\"))\n      ) {\n        return `PARSE_JSON('${v.replace(/'/g, \"\\\\'\")}')`;\n      }\n      return `'${v.replace(/'/g, \"\\\\'\")}'`;\n    }\n    // Objects / arrays → JSON\n    return `PARSE_JSON('${JSON.stringify(v).replace(/'/g, \"\\\\'\")}')`;\n  }\n}\n"]}
+{"version":3,"sources":["../../src/sync/constants.ts","../../src/sync/adapters/bigquery-types.ts","../../src/sync/adapters/bigquery.ts"],"names":["SYNC_VERSION_COLUMN","normalizeBigQueryType","type","upper","isConcurrentUpdateError","err","e","x","withRetry","fn","maxRetries","baseMs","attempt","cap","delay","res","BigQueryDialect","logical","id","bigqueryDialect","_BigQueryAdapter","options","tableName","exists","metadata","f","fields","result","table","qi","cols","c","notNull","ddl","columns","stmt","rows","primaryKey","allKeys","nonPkCols","k","source","row","i","updateSet","insertCols","insertVals","versionGuard","query","ids","escaped","v","sql","BigQueryAdapter"],"mappings":"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","file":"bigquery.js","sourcesContent":["/**\n * Internal constants shared between the worker, queue, schema mapper and\n * SQL adapters.\n */\n\n/**\n * Name of the SQL column that stores the publish-time `version` of each\n * sync event. Used by the worker to discard out-of-order PubSub deliveries\n * (the MERGE only updates rows when the incoming version is strictly\n * greater than the stored one).\n *\n * Two underscores prefix avoids collisions with user-defined fields.\n */\nexport const SYNC_VERSION_COLUMN = \"__sync_version\";\n","/**\n * BigQuery type-name utilities shared by the legacy `BigQueryAdapter` (DML\n * MERGE) and the new `BigQueryStorageAdapter` (Storage Write API).\n *\n * - {@link normalizeBigQueryType} canonicalises BigQuery type strings so that\n *   `INTEGER`/`INT64`, `FLOAT`/`FLOAT64`, `BOOLEAN`/`BOOL`, etc. compare\n *   equal during schema-drift detection.\n * - {@link isBigQueryTypeCompatible} returns whether a desired type can\n *   safely keep an existing column of another type — only widenings that\n *   BigQuery accepts via `ALTER COLUMN SET DATA TYPE` are allowed.\n */\n\n/**\n * Canonicalise a BigQuery type name returned by `getMetadata().schema`\n * (which may use legacy aliases like `INTEGER` or `FLOAT`) so that it can\n * be compared against the type produced by `BigQueryDialect.mapType()`.\n */\nexport function normalizeBigQueryType(type: string): string {\n  const upper = type.toUpperCase();\n  switch (upper) {\n    case \"INTEGER\":\n      return \"INT64\";\n    case \"FLOAT\":\n      return \"FLOAT64\";\n    case \"BOOLEAN\":\n      return \"BOOL\";\n    default:\n      return upper;\n  }\n}\n\n/**\n * Whether `desired` is the same as, or a safe widening of, `existing`.\n * The widenings mirror what BigQuery allows via\n * `ALTER COLUMN x SET DATA TYPE …` — see\n * https://cloud.google.com/bigquery/docs/managing-table-schemas#change_column_types\n */\nexport function isBigQueryTypeCompatible(\n  existing: string,\n  desired: string,\n): boolean {\n  const a = normalizeBigQueryType(existing);\n  const b = normalizeBigQueryType(desired);\n  if (a === b) return true;\n\n  const widenings: Record<string, string[]> = {\n    INT64: [\"NUMERIC\", \"BIGNUMERIC\", \"FLOAT64\"],\n    NUMERIC: [\"BIGNUMERIC\", \"FLOAT64\"],\n    DATE: [\"DATETIME\", \"TIMESTAMP\"],\n    DATETIME: [\"TIMESTAMP\"],\n  };\n  return widenings[a]?.includes(b) ?? false;\n}\n","import { SYNC_VERSION_COLUMN } from \"../constants\";\nimport type {\n  LogicalType,\n  SqlAdapter,\n  SqlColumn,\n  SqlDialect,\n  SqlTableDef,\n} from \"../types\";\nimport { normalizeBigQueryType } from \"./bigquery-types\";\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Returns true when the BigQuery error is a \"concurrent update\" serialization\n * conflict (code 400, reason \"invalidQuery\" containing \"serialize access\").\n * These are safe to retry after a brief back-off.\n */\nfunction isConcurrentUpdateError(err: unknown): boolean {\n  if (!err || typeof err !== \"object\") return false;\n  const e = err as Record<string, unknown>;\n  if (e[\"code\"] !== 400) return false;\n  const errors = Array.isArray(e[\"errors\"]) ? e[\"errors\"] : [];\n  return errors.some(\n    (x: any) =>\n      typeof x?.message === \"string\" &&\n      x.message.toLowerCase().includes(\"serialize access\"),\n  );\n}\n\n/**\n * Execute `fn`, retrying up to `maxRetries` times when BigQuery returns a\n * concurrent-update error.  Uses full-jitter exponential back-off.\n */\nasync function withRetry<T>(\n  fn: () => Promise<T>,\n  maxRetries = 10,\n  baseMs = 500,\n): Promise<T> {\n  let attempt = 0;\n  while (true) {\n    try {\n      return await fn();\n    } catch (err) {\n      attempt++;\n      if (!isConcurrentUpdateError(err) || attempt > maxRetries) throw err;\n      const cap = baseMs * Math.pow(2, attempt);\n      const delay = Math.random() * cap; // full jitter\n      await new Promise((res) => setTimeout(res, delay));\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Dialect (internal — used only by BigQueryAdapter)\n// ---------------------------------------------------------------------------\n\n/** BigQuery SQL dialect mapping. */\nclass BigQueryDialect implements SqlDialect {\n  readonly name = \"bigquery\";\n\n  mapType(logical: LogicalType): string {\n    switch (logical) {\n      case \"string\":\n        return \"STRING\";\n      case \"number\":\n        return \"FLOAT64\";\n      case \"bigint\":\n        return \"INT64\";\n      case \"boolean\":\n        return \"BOOL\";\n      case \"timestamp\":\n        return \"TIMESTAMP\";\n      case \"json\":\n        return \"JSON\";\n      case \"text\":\n        return \"STRING\";\n    }\n  }\n\n  quoteIdentifier(id: string): string {\n    return `\\`${id}\\``;\n  }\n}\n\n/** Shared BigQuery dialect singleton. */\nexport const bigqueryDialect: SqlDialect = new BigQueryDialect();\n\n// ---------------------------------------------------------------------------\n// Adapter\n// ---------------------------------------------------------------------------\n\n/**\n * BigQuery implementation of {@link SqlAdapter}.\n *\n * Accepts an already-configured BigQuery client so the library does not pull\n * in `@google-cloud/bigquery` as a hard dependency.\n *\n * @example\n * ```ts\n * import { BigQuery } from \"@google-cloud/bigquery\";\n * import { BigQueryAdapter } from \"./adapters/bigquery\";\n *\n * const adapter = new BigQueryAdapter({\n *   bigquery: new BigQuery({ projectId: \"my-project\" }),\n *   datasetId: \"my_dataset\",\n * });\n * ```\n */\nexport class BigQueryAdapter implements SqlAdapter {\n  private readonly bigquery: any;\n  private readonly datasetId: string;\n\n  constructor(options: { bigquery: any; datasetId: string }) {\n    this.bigquery = options.bigquery;\n    this.datasetId = options.datasetId;\n  }\n\n  /** The BigQuery SQL dialect. */\n  get dialect(): SqlDialect {\n    return bigqueryDialect;\n  }\n\n  /** Check whether a table exists in the dataset. */\n  async tableExists(tableName: string): Promise<boolean> {\n    const [exists] = await this.dataset.table(tableName).exists();\n    return exists;\n  }\n\n  /** Return the column names currently present in the table. */\n  async getTableColumns(tableName: string): Promise<string[]> {\n    const [metadata] = await this.dataset.table(tableName).getMetadata();\n    const fields: Array<{ name: string }> = metadata.schema?.fields ?? [];\n    return fields.map((f) => f.name);\n  }\n\n  /**\n   * Return existing columns with their normalized BigQuery type strings.\n   * Used by the worker to detect type drift before applying schema changes.\n   */\n  async getTableColumnsWithTypes(\n    tableName: string,\n  ): Promise<Map<string, string>> {\n    const [metadata] = await this.dataset.table(tableName).getMetadata();\n    const fields: Array<{ name: string; type: string }> =\n      metadata.schema?.fields ?? [];\n    const result = new Map<string, string>();\n    for (const f of fields) {\n      result.set(f.name, normalizeBigQueryType(f.type));\n    }\n    return result;\n  }\n\n  /** Create a table using a fully-qualified name. */\n  async createTable(table: SqlTableDef): Promise<void> {\n    const qi = (id: string) => this.dialect.quoteIdentifier(id);\n    const cols = table.columns\n      .map((c) => {\n        const notNull = c.isPrimaryKey ? \" NOT NULL\" : \"\";\n        return `  ${qi(c.name)} ${c.sqlType}${notNull}`;\n      })\n      .join(\",\\n\");\n\n    const ddl = `CREATE TABLE IF NOT EXISTS ${this.fqn(table.tableName)} (\\n${cols}\\n);`;\n    await this.bigquery.query({ query: ddl });\n  }\n\n  /** Add columns to an existing table using a fully-qualified name. */\n  async addColumns(tableName: string, columns: SqlColumn[]): Promise<void> {\n    const qi = (id: string) => this.dialect.quoteIdentifier(id);\n    for (const c of columns) {\n      const stmt = `ALTER TABLE ${this.fqn(tableName)} ADD COLUMN ${qi(c.name)} ${c.sqlType};`;\n      await this.bigquery.query({ query: stmt });\n    }\n  }\n\n  /** Append rows via BigQuery streaming insert. */\n  async insertRows(\n    tableName: string,\n    rows: Record<string, unknown>[],\n  ): Promise<void> {\n    if (rows.length === 0) return;\n    await this.dataset.table(tableName).insert(rows);\n  }\n\n  /**\n   * Upsert rows using a MERGE DML statement.\n   *\n   * Builds a source table from inline SELECT … UNION ALL rows and merges\n   * into the target on the given primary key.\n   */\n  async upsertRows(\n    tableName: string,\n    rows: Record<string, unknown>[],\n    primaryKey: string,\n  ): Promise<void> {\n    if (rows.length === 0) return;\n\n    const allKeys = Object.keys(rows[0]!);\n    const nonPkCols = allKeys.filter((k) => k !== primaryKey);\n    const qi = (id: string) => this.dialect.quoteIdentifier(id);\n\n    // Build inline source: SELECT val AS col, … UNION ALL SELECT …\n    const selects = rows.map((row, i) => {\n      const values = allKeys\n        .map((k) => {\n          const aliased =\n            i === 0\n              ? `${this.escapeValue(row[k])} AS ${qi(k)}`\n              : this.escapeValue(row[k]);\n          return aliased;\n        })\n        .join(\", \");\n      return `SELECT ${values}`;\n    });\n\n    const source = selects.join(\" UNION ALL\\n    \");\n\n    // UPDATE SET clause (non-PK columns).\n    // Note: when __sync_version is present we still update it so the row\n    // tracks the latest applied version.\n    const updateSet = nonPkCols\n      .map((c) => `T.${qi(c)} = S.${qi(c)}`)\n      .join(\", \");\n\n    // INSERT columns / values\n    const insertCols = allKeys.map((c) => qi(c)).join(\", \");\n    const insertVals = allKeys.map((c) => `S.${qi(c)}`).join(\", \");\n\n    // Out-of-order protection: only UPDATE when the incoming version is\n    // strictly greater than the stored one (NULL stored version means the\n    // row pre-dates versioning → always update).\n    const versionGuard = allKeys.includes(SYNC_VERSION_COLUMN)\n      ? ` AND (T.${qi(SYNC_VERSION_COLUMN)} IS NULL OR S.${qi(SYNC_VERSION_COLUMN)} > T.${qi(SYNC_VERSION_COLUMN)})`\n      : \"\";\n\n    const query = [\n      `MERGE ${this.fqn(tableName)} AS T`,\n      `USING (\\n    ${source}\\n  ) AS S`,\n      `ON T.${qi(primaryKey)} = S.${qi(primaryKey)}`,\n      `WHEN MATCHED${versionGuard} THEN UPDATE SET ${updateSet}`,\n      `WHEN NOT MATCHED THEN INSERT (${insertCols}) VALUES (${insertVals});`,\n    ].join(\"\\n\");\n\n    await withRetry(() => this.bigquery.query({ query }));\n  }\n\n  /** Delete rows by primary-key values. */\n  async deleteRows(\n    tableName: string,\n    primaryKey: string,\n    ids: string[],\n  ): Promise<void> {\n    if (ids.length === 0) return;\n\n    const qi = (id: string) => this.dialect.quoteIdentifier(id);\n    const escaped = ids.map((v) => this.escapeValue(v)).join(\", \");\n    const query = `DELETE FROM ${this.fqn(tableName)} WHERE ${qi(primaryKey)} IN (${escaped});`;\n\n    await withRetry(() => this.bigquery.query({ query }));\n  }\n\n  /** Execute a raw SQL statement (used by the migration manager). */\n  async executeRaw(sql: string): Promise<void> {\n    await this.bigquery.query({ query: sql });\n  }\n\n  // -------------------------------------------------------------------------\n  // Private helpers\n  // -------------------------------------------------------------------------\n\n  /** The BigQuery Dataset handle. */\n  private get dataset() {\n    return this.bigquery.dataset(this.datasetId);\n  }\n\n  /** Return the fully-qualified table reference (`` `dataset.table` ``). */\n  private fqn(tableName: string): string {\n    return `\\`${this.datasetId}.${tableName}\\``;\n  }\n\n  /** ISO 8601 timestamp pattern (e.g. 2026-03-29T20:59:27.394Z) */\n  private static readonly ISO_TIMESTAMP_RE =\n    /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}/;\n\n  /** Escape a value for use as a SQL literal. */\n  private escapeValue(v: unknown): string {\n    if (v === null || v === undefined) return \"NULL\";\n    if (typeof v === \"boolean\") return v ? \"TRUE\" : \"FALSE\";\n    if (typeof v === \"number\" || typeof v === \"bigint\") return String(v);\n    if (typeof v === \"string\") {\n      // ISO 8601 timestamps → TIMESTAMP literal (keeps type-safety with BQ TIMESTAMP columns)\n      if (BigQueryAdapter.ISO_TIMESTAMP_RE.test(v)) {\n        return `TIMESTAMP('${v}')`;\n      }\n      // Detect JSON strings (arrays/objects) → use PARSE_JSON for native JSON columns\n      if (\n        (v.startsWith(\"[\") && v.endsWith(\"]\")) ||\n        (v.startsWith(\"{\") && v.endsWith(\"}\"))\n      ) {\n        return `PARSE_JSON('${v.replace(/'/g, \"\\\\'\")}')`;\n      }\n      return `'${v.replace(/'/g, \"\\\\'\")}'`;\n    }\n    // Objects / arrays → JSON\n    return `PARSE_JSON('${JSON.stringify(v).replace(/'/g, \"\\\\'\")}')`;\n  }\n}\n"]}

package/dist/sync/index.cjs

@@ -1,4 +1,4 @@
-'use strict';function te(n){let e=[],t=n.replace(/[.*+?^${}()|[\]\\]/g,r=>r===":"?r:`\\${r}`).replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g,(r,s)=>(e.push(s),"([^/]+)"));return {pattern:new RegExp(`^${t}$`),paramNames:e}}function ne(n){let e=n.path??n.url??"/",t=e.indexOf("?");return t===-1?e:e.slice(0,t)}var Z=class{constructor(){this.routes=[];this.middlewares=[];this.notFoundHandler=(e,t)=>{t.status(404).send("Not Found");};this.errorHandler=(e,t,r)=>{console.error("[MiniRouter]",e),r.status(500).send("Internal Server Error");};}use(e){return this.middlewares.push(e),this}get(e,t){return this.addRoute("GET",e,t)}post(e,t){return this.addRoute("POST",e,t)}put(e,t){return this.addRoute("PUT",e,t)}patch(e,t){return this.addRoute("PATCH",e,t)}delete(e,t){return this.addRoute("DELETE",e,t)}onNotFound(e){return this.notFoundHandler=e,this}onError(e){return this.errorHandler=e,this}addRoute(e,t,r){let{pattern:s,paramNames:u}=te(t);return this.routes.push({method:e.toUpperCase(),pattern:s,paramNames:u,handler:r}),this}async handle(e,t){let r=(e.method??"GET").toUpperCase(),s=ne(e),u=null,h={};for(let k of this.routes){if(k.method!==r)continue;let y=s.match(k.pattern);if(y){u=k,h={},k.paramNames.forEach((f,c)=>{h[f]=decodeURIComponent(y[c+1]??"");});break}}let x=Object.assign(e,{params:h}),l=u?u.handler:this.notFoundHandler;try{await this.runMiddlewareChain(x,t,l);}catch(k){this.errorHandler(k,e,t);}}async runMiddlewareChain(e,t,r){let s=0,u=async()=>{if(s<this.middlewares.length){let h=this.middlewares[s++];await h(e,t,u);}else await r(e,t);};await u();}};function _(n,e){let t=e==="/"?"":e.replace(/\/$/,"");if(process.env.FUNCTIONS_EMULATOR==="true"){let u=process.env.GCLOUD_PROJECT??process.env.GOOGLE_CLOUD_PROJECT??"demo-project",h=process.env.FUNCTION_REGION??"us-central1",x=(process.env.FUNCTION_TARGET??"").replace(/\./g,"-");return `/${u}/${h}/${x}${t}`}let r=process.env.K_SERVICE,s=n?.hostname??n?.headers?.host??"";return r&&typeof s=="string"&&s.includes("cloudfunctions.net")?`/${r.toLowerCase()}${t}`:t}function B(n){return !!n&&typeof n=="object"&&n.__authExtension===true}var se={string:"ZodString",number:"ZodNumber",bigint:"ZodBigInt",boolean:"ZodBoolean",date:"ZodDate",enum:"ZodEnum",nativeEnum:"ZodNativeEnum",literal:"ZodLiteral",object:"ZodObject",array:"ZodArray",optional:"ZodOptional",nullable:"ZodNullable",default:"ZodDefault",coerce:"ZodCoerce",union:"ZodUnion",undefined:"ZodUndefined",unknown:"ZodUnknown",any:"ZodAny",record:"ZodRecord"};function M(n){let e=n,t=e._zod?.def?.type;if(t)return se[t]??`Zod${t.charAt(0).toUpperCase()}${t.slice(1)}`;let r=e._def?.typeName;return r||""}function G(n){let e=n;if(e._zod?.def?.innerType)return e._zod.def.innerType;if(e._def?.innerType)return e._def.innerType}function H(n){let e=n;return e.shape&&typeof e.shape=="object"?e.shape:e._zod?.def?.shape&&typeof e._zod.def.shape=="object"?e._zod.def.shape:e._def?.shape?typeof e._def.shape=="function"?e._def.shape():e._def.shape:{}}var D="__sync_version";var ie=new Set(["ZodOptional","ZodNullable","ZodDefault"]);function Q(n){let e=n,t=false;for(;;){let r=M(e);if(!ie.has(r))break;(r==="ZodOptional"||r==="ZodNullable")&&(t=true);let s=G(e);if(!s)break;e=s;}return {inner:e,nullable:t}}var W={ZodString:"string",ZodNumber:"number",ZodBigInt:"bigint",ZodBoolean:"boolean",ZodDate:"timestamp",ZodEnum:"string",ZodNativeEnum:"string",ZodLiteral:"string"};function ae(n){let{inner:e}=Q(n);return W[M(e)]??"json"}function J(n,e,t,r,s,u,h,x){for(let[l,k]of Object.entries(n)){let y=t?`${t}__${l}`:l;if(s.has(l)||s.has(y))continue;let{inner:f,nullable:c}=Q(k),d=M(f),a=r||c;if(d==="ZodObject"){let i=H(f);J(i,e,y,a,s,u,h,x);continue}let o=W[d]??"json",p=y===h||l===h,b=u[y]??u[l]??y;x.push({name:b,sqlType:e.mapType(o),nullable:p?false:a,isPrimaryKey:p});}}function P(n,e,t={}){let{primaryKey:r,exclude:s=[],columnMap:u={}}=t,h=new Set(s),x=H(n),l=[];return J(x,e,"",false,h,u,r,l),l.some(k=>k.name===D)||l.push({name:D,sqlType:e.mapType("bigint"),nullable:true,isPrimaryKey:false,description:"Monotonic publish version (Date.now() ms). Internal."}),l}function K(n){if(n==null)return null;if(typeof n=="object"&&typeof n.toDate=="function")return n.toDate().toISOString();if(n instanceof Date)return n.toISOString();if(Buffer.isBuffer(n))return n.toString("base64");if(n instanceof Uint8Array)return Buffer.from(n).toString("base64");if(typeof n=="object"&&"latitude"in n&&"longitude"in n){let e=n;return JSON.stringify({lat:e.latitude,lng:e.longitude})}return Array.isArray(n)?JSON.stringify(n.map(K)):n}function V(n,e,t){for(let[r,s]of Object.entries(n)){let u=e?`${e}__${r}`:r;s!=null&&typeof s=="object"&&!Array.isArray(s)&&!(s instanceof Date)&&!Buffer.isBuffer(s)&&!(s instanceof Uint8Array)&&typeof s.toDate!="function"&&!("latitude"in s&&"longitude"in s)?V(s,u,t):t[u]=K(s);}}function j(n,e){let t=new Set(e?.exclude),r=e?.columnMap??{},s={};V(n,"",s);let u={};for(let[h,x]of Object.entries(s)){if(t.has(h))continue;let l=h.split("__")[0];if(l!==h&&t.has(l))continue;let k=r[h]??(h.includes("__")?r[h.split("__").pop()]:void 0)??h;u[k]=x;}return u}function N(n,e,t){return `<!DOCTYPE html>
+'use strict';function re(n){let e=[],t=n.replace(/[.*+?^${}()|[\]\\]/g,r=>r===":"?r:`\\${r}`).replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g,(r,s)=>(e.push(s),"([^/]+)"));return {pattern:new RegExp(`^${t}$`),paramNames:e}}function se(n){let e=n.path??n.url??"/",t=e.indexOf("?");return t===-1?e:e.slice(0,t)}var q=class{constructor(){this.routes=[];this.middlewares=[];this.notFoundHandler=(e,t)=>{t.status(404).send("Not Found");};this.errorHandler=(e,t,r)=>{console.error("[MiniRouter]",e),r.status(500).send("Internal Server Error");};}use(e){return this.middlewares.push(e),this}get(e,t){return this.addRoute("GET",e,t)}post(e,t){return this.addRoute("POST",e,t)}put(e,t){return this.addRoute("PUT",e,t)}patch(e,t){return this.addRoute("PATCH",e,t)}delete(e,t){return this.addRoute("DELETE",e,t)}onNotFound(e){return this.notFoundHandler=e,this}onError(e){return this.errorHandler=e,this}addRoute(e,t,r){let{pattern:s,paramNames:d}=re(t);return this.routes.push({method:e.toUpperCase(),pattern:s,paramNames:d,handler:r}),this}async handle(e,t){let r=(e.method??"GET").toUpperCase(),s=se(e),d=null,h={};for(let k of this.routes){if(k.method!==r)continue;let y=s.match(k.pattern);if(y){d=k,h={},k.paramNames.forEach((l,c)=>{h[l]=decodeURIComponent(y[c+1]??"");});break}}let w=Object.assign(e,{params:h}),p=d?d.handler:this.notFoundHandler;try{await this.runMiddlewareChain(w,t,p);}catch(k){this.errorHandler(k,e,t);}}async runMiddlewareChain(e,t,r){let s=0,d=async()=>{if(s<this.middlewares.length){let h=this.middlewares[s++];await h(e,t,d);}else await r(e,t);};await d();}};function _(n,e){let t=e==="/"?"":e.replace(/\/$/,"");if(process.env.FUNCTIONS_EMULATOR==="true"){let d=process.env.GCLOUD_PROJECT??process.env.GOOGLE_CLOUD_PROJECT??"demo-project",h=process.env.FUNCTION_REGION??"us-central1",w=(process.env.FUNCTION_TARGET??"").replace(/\./g,"-");return `/${d}/${h}/${w}${t}`}let r=process.env.K_SERVICE,s=n?.hostname??n?.headers?.host??"";return r&&typeof s=="string"&&s.includes("cloudfunctions.net")?`/${r.toLowerCase()}${t}`:t}function B(n){return !!n&&typeof n=="object"&&n.__authExtension===true}var ce={string:"ZodString",number:"ZodNumber",bigint:"ZodBigInt",boolean:"ZodBoolean",date:"ZodDate",enum:"ZodEnum",nativeEnum:"ZodNativeEnum",literal:"ZodLiteral",object:"ZodObject",array:"ZodArray",optional:"ZodOptional",nullable:"ZodNullable",default:"ZodDefault",coerce:"ZodCoerce",union:"ZodUnion",undefined:"ZodUndefined",unknown:"ZodUnknown",any:"ZodAny",record:"ZodRecord"};function Z(n){let e=n,t=e._zod?.def?.type;if(t)return ce[t]??`Zod${t.charAt(0).toUpperCase()}${t.slice(1)}`;let r=e._def?.typeName;return r||""}function Q(n){let e=n;if(e._zod?.def?.innerType)return e._zod.def.innerType;if(e._def?.innerType)return e._def.innerType}function H(n){let e=n;return e.shape&&typeof e.shape=="object"?e.shape:e._zod?.def?.shape&&typeof e._zod.def.shape=="object"?e._zod.def.shape:e._def?.shape?typeof e._def.shape=="function"?e._def.shape():e._def.shape:{}}var D="__sync_version";var de=new Set(["ZodOptional","ZodNullable","ZodDefault"]);function W(n){let e=n,t=false;for(;;){let r=Z(e);if(!de.has(r))break;(r==="ZodOptional"||r==="ZodNullable")&&(t=true);let s=Q(e);if(!s)break;e=s;}return {inner:e,nullable:t}}var J={ZodString:"string",ZodNumber:"number",ZodBigInt:"bigint",ZodBoolean:"boolean",ZodDate:"timestamp",ZodEnum:"string",ZodNativeEnum:"string",ZodLiteral:"string"};function ue(n){let{inner:e}=W(n);return J[Z(e)]??"json"}function V(n,e,t,r,s,d,h,w){for(let[p,k]of Object.entries(n)){let y=t?`${t}__${p}`:p;if(s.has(p)||s.has(y))continue;let{inner:l,nullable:c}=W(k),u=Z(l),a=r||c;if(u==="ZodObject"){let i=H(l);V(i,e,y,a,s,d,h,w);continue}let o=J[u]??"json",f=y===h||p===h,b=d[y]??d[p]??y;w.push({name:b,sqlType:e.mapType(o),nullable:f?false:a,isPrimaryKey:f});}}function P(n,e,t={}){let{primaryKey:r,exclude:s=[],columnMap:d={}}=t,h=new Set(s),w=H(n),p=[];return V(w,e,"",false,h,d,r,p),p.some(k=>k.name===D)||p.push({name:D,sqlType:e.mapType("bigint"),nullable:true,isPrimaryKey:false,description:"Monotonic publish version (Date.now() ms). Internal."}),p}function K(n){if(n==null)return null;if(typeof n=="object"&&typeof n.toDate=="function")return n.toDate().toISOString();if(n instanceof Date)return n.toISOString();if(Buffer.isBuffer(n))return n.toString("base64");if(n instanceof Uint8Array)return Buffer.from(n).toString("base64");if(typeof n=="object"&&"latitude"in n&&"longitude"in n){let e=n;return JSON.stringify({lat:e.latitude,lng:e.longitude})}return Array.isArray(n)?JSON.stringify(n.map(K)):n}function Y(n,e,t){for(let[r,s]of Object.entries(n)){let d=e?`${e}__${r}`:r;s!=null&&typeof s=="object"&&!Array.isArray(s)&&!(s instanceof Date)&&!Buffer.isBuffer(s)&&!(s instanceof Uint8Array)&&typeof s.toDate!="function"&&!("latitude"in s&&"longitude"in s)?Y(s,d,t):t[d]=K(s);}}function j(n,e){let t=new Set(e?.exclude),r=e?.columnMap??{},s={};Y(n,"",s);let d={};for(let[h,w]of Object.entries(s)){if(t.has(h))continue;let p=h.split("__")[0];if(p!==h&&t.has(p))continue;let k=r[h]??(h.includes("__")?r[h.split("__").pop()]:void 0)??h;d[k]=w;}return d}function N(n,e,t){return `<!DOCTYPE html>
 <html lang="en"><head>
 <meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
 <title>${n} \u2014 Sync Admin</title>
@@ -28,64 +28,64 @@
 <nav><a href="${e}/">\u2190 Dashboard</a></nav>
 <h1>${n}</h1>
 ${t}
-</body></html>`}function O(n,e,t=200){n.status(t).set("Content-Type","text/html; charset=utf-8").send(e);}function z(n,e,t=200){n.status(t).set("Content-Type","application/json").send(JSON.stringify(e,null,2));}function F(n){return (n.headers?.accept??"").includes("application/json")}function ce(n,e,t,r,s,u,h,x){let l=(s.basePath??"/").replace(/\/$/,"")||"",k=s.featuresFlag??{},y=[];for(let[c,d]of Object.entries(n)){let a=u[c];y.push({name:c,schema:d.schema??null,documentKey:d._systemKeys?.[0]??d.documentKey??"docId",tableName:a?.tableName??c,isGroup:!!d._isGroup,repoCfg:a,repo:d});}let f=new Z;if(s.auth)if(B(s.auth)){let c=s.auth;for(let d of c.routes){let a=`${l}${d.path}`;d.method==="GET"?f.get(a,d.handler):f.post(a,d.handler);}f.use(c.middleware);}else if(typeof s.auth=="function")f.use(s.auth);else {let c=s.auth.realm??"Sync Admin",d="Basic "+Buffer.from(`${s.auth.username}:${s.auth.password}`).toString("base64");f.use((a,o,p)=>{if((a.headers?.authorization??"")!==d){o.status(401).set("WWW-Authenticate",`Basic realm="${c}"`).set("Content-Type","text/plain").send("Unauthorized");return}p();});}return f.get(`${l}/`,(c,d)=>{let a=_(c,l),o=y.map(i=>{let S=[];return k.healthCheck&&S.push(`<a class="btn" href="${a}/${i.name}/health">Health</a>`),k.manualSync&&S.push(`<a class="btn btn-primary" href="${a}/${i.name}/force-sync">Force Sync</a>`),`<tr>
+</body></html>`}function O(n,e,t=200){n.status(t).set("Content-Type","text/html; charset=utf-8").send(e);}function z(n,e,t=200){n.status(t).set("Content-Type","application/json").send(JSON.stringify(e,null,2));}function F(n){return (n.headers?.accept??"").includes("application/json")}function le(n,e,t,r,s,d,h,w){let p=(s.basePath??"/").replace(/\/$/,"")||"",k=s.featuresFlag??{},y=[];for(let[c,u]of Object.entries(n)){let a=d[c];y.push({name:c,schema:u.schema??null,documentKey:u._systemKeys?.[0]??u.documentKey??"docId",tableName:a?.tableName??c,isGroup:!!u._isGroup,repoCfg:a,repo:u});}let l=new q;if(s.auth)if(B(s.auth)){let c=s.auth;for(let u of c.routes){let a=`${p}${u.path}`;u.method==="GET"?l.get(a,u.handler):l.post(a,u.handler);}l.use(c.middleware);}else if(typeof s.auth=="function")l.use(s.auth);else {let c=s.auth.realm??"Sync Admin",u="Basic "+Buffer.from(`${s.auth.username}:${s.auth.password}`).toString("base64");l.use((a,o,f)=>{if((a.headers?.authorization??"")!==u){o.status(401).set("WWW-Authenticate",`Basic realm="${c}"`).set("Content-Type","text/plain").send("Unauthorized");return}f();});}return l.get(`${p}/`,(c,u)=>{let a=_(c,p),o=y.map(i=>{let S=[];return k.healthCheck&&S.push(`<a class="btn" href="${a}/${i.name}/health">Health</a>`),k.manualSync&&S.push(`<a class="btn btn-primary" href="${a}/${i.name}/force-sync">Force Sync</a>`),`<tr>
           <td><strong>${i.name}</strong></td>
           <td>${i.tableName}</td>
           <td>${i.isGroup?'<span class="badge badge-warn">group</span>':'<span class="badge badge-ok">collection</span>'}</td>
           <td>${i.schema?"\u2713":"\u2717"}</td>
           <td>${S.join(" ")}</td>
         </tr>`}).join(`
-`),p=k.configCheck?`<p style="margin-top:.5rem"><a class="btn" href="${a}/config-check">\u2699 Config Check</a></p>`:"",b=N("Sync Dashboard",a,`<div class="card">
+`),f=k.configCheck?`<p style="margin-top:.5rem"><a class="btn" href="${a}/config-check">\u2699 Config Check</a></p>`:"",b=N("Sync Dashboard",a,`<div class="card">
         <table>
           <thead><tr><th>Repository</th><th>Table</th><th>Type</th><th>Schema</th><th>Actions</th></tr></thead>
           <tbody>${o}</tbody>
         </table>
-        ${p}
-      </div>`);O(d,b);}),f.get(`${l}`,(c,d)=>{let a=_(c,l);d.status(302).set("Location",`${a}/`).send("");}),k.healthCheck&&f.get(`${l}/:repoName/health`,async(c,d)=>{let a=_(c,l),o=y.find(m=>m.name===c.params.repoName);if(!o){O(d,N("Not Found",a,`<p>Unknown repo: ${c.params.repoName}</p>`),404);return}if(!o.schema){O(d,N("Health Check",a,`<p class="badge badge-warn">No Zod schema attached to "${o.name}"</p>`));return}let p=P(o.schema,e.dialect,{primaryKey:o.documentKey,exclude:o.repoCfg?.exclude,columnMap:o.repoCfg?.columnMap}),b=[],i=false,S=null;try{i=await e.tableExists(o.tableName),i&&(b=await e.getTableColumns(o.tableName));}catch(m){S=m?.message??String(m);}let v=new Set(b),A=new Set(p.map(m=>m.name)),T=p.filter(m=>!v.has(m.name)),E=b.filter(m=>!A.has(m)),I=p.filter(m=>v.has(m.name)),g=i&&T.length===0&&!S;if(F(c)){z(d,{repo:o.name,table:o.tableName,tableExists:i,healthy:g,error:S,columns:{expected:p.map(m=>({name:m.name,type:m.sqlType,nullable:m.nullable,isPrimaryKey:m.isPrimaryKey})),actual:b,matched:I.map(m=>m.name),missing:T.map(m=>({name:m.name,type:m.sqlType})),extra:E}});return}let w=g?'<span class="badge badge-ok">Healthy</span>':'<span class="badge badge-err">Unhealthy</span>',R=p.map(m=>{let L=v.has(m.name)?'<span class="badge badge-ok">OK</span>':'<span class="badge badge-err">MISSING</span>';return `<tr><td>${m.name}</td><td>${m.sqlType}</td><td>${m.nullable?"Yes":"No"}</td><td>${m.isPrimaryKey?"\u2713":""}</td><td>${L}</td></tr>`}).join(`
+        ${f}
+      </div>`);O(u,b);}),l.get(`${p}`,(c,u)=>{let a=_(c,p);u.status(302).set("Location",`${a}/`).send("");}),k.healthCheck&&l.get(`${p}/:repoName/health`,async(c,u)=>{let a=_(c,p),o=y.find(m=>m.name===c.params.repoName);if(!o){O(u,N("Not Found",a,`<p>Unknown repo: ${c.params.repoName}</p>`),404);return}if(!o.schema){O(u,N("Health Check",a,`<p class="badge badge-warn">No Zod schema attached to "${o.name}"</p>`));return}let f=P(o.schema,e.dialect,{primaryKey:o.documentKey,exclude:o.repoCfg?.exclude,columnMap:o.repoCfg?.columnMap}),b=[],i=false,S=null;try{i=await e.tableExists(o.tableName),i&&(b=await e.getTableColumns(o.tableName));}catch(m){S=m?.message??String(m);}let R=new Set(b),v=new Set(f.map(m=>m.name)),A=f.filter(m=>!R.has(m.name)),E=b.filter(m=>!v.has(m)),I=f.filter(m=>R.has(m.name)),g=i&&A.length===0&&!S;if(F(c)){z(u,{repo:o.name,table:o.tableName,tableExists:i,healthy:g,error:S,columns:{expected:f.map(m=>({name:m.name,type:m.sqlType,nullable:m.nullable,isPrimaryKey:m.isPrimaryKey})),actual:b,matched:I.map(m=>m.name),missing:A.map(m=>({name:m.name,type:m.sqlType})),extra:E}});return}let x=g?'<span class="badge badge-ok">Healthy</span>':'<span class="badge badge-err">Unhealthy</span>',T=f.map(m=>{let L=R.has(m.name)?'<span class="badge badge-ok">OK</span>':'<span class="badge badge-err">MISSING</span>';return `<tr><td>${m.name}</td><td>${m.sqlType}</td><td>${m.nullable?"Yes":"No"}</td><td>${m.isPrimaryKey?"\u2713":""}</td><td>${L}</td></tr>`}).join(`
 `),C=E.map(m=>`<tr><td>${m}</td><td colspan="3" class="muted">not in schema</td><td><span class="badge badge-warn">EXTRA</span></td></tr>`).join(`
 `),$=N(`Health: ${o.name}`,a,`<div class="card">
-          <p>Table: <code>${o.tableName}</code> ${i?w:'<span class="badge badge-err">NOT FOUND</span>'}</p>
+          <p>Table: <code>${o.tableName}</code> ${i?x:'<span class="badge badge-err">NOT FOUND</span>'}</p>
           ${S?`<p class="badge badge-err">Error: ${S}</p>`:""}
           <h2>Columns</h2>
           <table>
             <thead><tr><th>Column</th><th>SQL Type</th><th>Nullable</th><th>PK</th><th>Status</th></tr></thead>
-            <tbody>${R}${C}</tbody>
+            <tbody>${T}${C}</tbody>
           </table>
-        </div>`);O(d,$);}),k.manualSync&&(f.get(`${l}/:repoName/force-sync`,(c,d)=>{let a=_(c,l),o=y.find(b=>b.name===c.params.repoName);if(!o){O(d,N("Not Found",a,`<p>Unknown repo: ${c.params.repoName}</p>`),404);return}let p=N(`Force Sync: ${o.name}`,a,`<div class="card">
+        </div>`);O(u,$);}),k.manualSync&&(l.get(`${p}/:repoName/force-sync`,(c,u)=>{let a=_(c,p),o=y.find(b=>b.name===c.params.repoName);if(!o){O(u,N("Not Found",a,`<p>Unknown repo: ${c.params.repoName}</p>`),404);return}let f=N(`Force Sync: ${o.name}`,a,`<div class="card">
           <p>This will read <strong>all</strong> documents from the <code>${o.name}</code> Firestore collection
           and upsert them into the <code>${o.tableName}</code> SQL table.</p>
           <p class="muted" style="margin:.75rem 0">This may take a while for large collections.</p>
           <form method="POST" action="${a}/${o.name}/force-sync">
             <button type="submit" class="btn btn-primary">Start Force Sync</button>
           </form>
-        </div>`);O(d,p);}),f.post(`${l}/:repoName/force-sync`,async(c,d)=>{let a=_(c,l),o=y.find(g=>g.name===c.params.repoName);if(!o){z(d,{error:`Unknown repo: ${c.params.repoName}`},404);return}let p=o.repo.ref;if(!p){z(d,{error:`No collection reference for "${o.name}"`},400);return}let b=0,i=0,S=[],v=500,A=p.limit(v),T=null;try{for(;;){let R=await(T?A.startAfter(T):A).get();if(R.empty)break;for(let C of R.docs){let $=C.data(),m=String($[o.documentKey]??C.id),L=j($,{exclude:o.repoCfg?.exclude,columnMap:o.repoCfg?.columnMap});try{await r({operation:"UPSERT",repoName:o.name,docId:m,data:L,timestamp:new Date().toISOString()}),b++;}catch(U){i++;let ee=U?.message??String(U);console.error(`[ForceSync:${o.name}] doc=${m} failed:`,U),S.length<5&&S.push(`${m}: ${ee}`);}}if(T=R.docs[R.docs.length-1],R.docs.length<v)break}let g=t.get(o.name);g&&await g.flush();}catch(g){if(F(c)){z(d,{error:g?.message??String(g),synced:b,errors:i},500);return}O(d,N(`Force Sync: ${o.name}`,a,`<div class="card">
+        </div>`);O(u,f);}),l.post(`${p}/:repoName/force-sync`,async(c,u)=>{let a=_(c,p),o=y.find(g=>g.name===c.params.repoName);if(!o){z(u,{error:`Unknown repo: ${c.params.repoName}`},404);return}let f=o.repo.ref;if(!f){z(u,{error:`No collection reference for "${o.name}"`},400);return}let b=0,i=0,S=[],R=500,v=f.limit(R),A=null;try{for(;;){let T=await(A?v.startAfter(A):v).get();if(T.empty)break;for(let C of T.docs){let $=C.data(),m=String($[o.documentKey]??C.id),L=j($,{exclude:o.repoCfg?.exclude,columnMap:o.repoCfg?.columnMap});try{await r({operation:"UPSERT",repoName:o.name,docId:m,data:L,timestamp:new Date().toISOString()}),b++;}catch(U){i++;let oe=U?.message??String(U);console.error(`[ForceSync:${o.name}] doc=${m} failed:`,U),S.length<5&&S.push(`${m}: ${oe}`);}}if(A=T.docs[T.docs.length-1],T.docs.length<R)break}let g=t.get(o.name);g&&await g.flush();}catch(g){if(F(c)){z(u,{error:g?.message??String(g),synced:b,errors:i},500);return}O(u,N(`Force Sync: ${o.name}`,a,`<div class="card">
               <p class="badge badge-err">Error: ${g?.message??String(g)}</p>
               <p>Synced ${b} docs before failure (${i} errors).</p>
-            </div>`),500);return}if(F(c)){z(d,{repo:o.name,table:o.tableName,synced:b,errors:i,...S.length>0&&{errorSamples:S}});return}let E=S.length>0?`<details style="margin-top:1rem"><summary>First ${S.length} error(s)</summary>
-              <pre style="white-space:pre-wrap">${S.map(g=>g.replace(/[<>&]/g,w=>`&#${w.charCodeAt(0)};`)).join(`
+            </div>`),500);return}if(F(c)){z(u,{repo:o.name,table:o.tableName,synced:b,errors:i,...S.length>0&&{errorSamples:S}});return}let E=S.length>0?`<details style="margin-top:1rem"><summary>First ${S.length} error(s)</summary>
+              <pre style="white-space:pre-wrap">${S.map(g=>g.replace(/[<>&]/g,x=>`&#${x.charCodeAt(0)};`)).join(`
 
 `)}</pre></details>`:"",I=N(`Force Sync: ${o.name}`,a,`<div class="card">
           <p class="badge ${i>0?"badge-warn":"badge-ok"}">${i>0?"Completed with errors":"Complete"}</p>
           <p>Synced <strong>${b}</strong> documents to <code>${o.tableName}</code>.</p>
           ${i>0?`<p class="badge badge-warn">${i} error(s)</p>`:""}
           ${E}
-        </div>`);O(d,I);})),k.configCheck&&f.get(`${l}/config-check`,async(c,d)=>{let a=_(c,l),o=process.env.GCLOUD_PROJECT??process.env.GOOGLE_CLOUD_PROJECT??process.env.GCP_PROJECT??"unknown",p="https://console.cloud.google.com",b=x??"firestore-sync",i=[];try{await e.tableExists("__nonexistent_health_check__"),i.push({name:"BigQuery API",category:"bigquery",status:"ok",message:"BigQuery API is reachable"});}catch(g){let w=g?.message??String(g),R=w.toLowerCase(),C=R.includes("disabled")||R.includes("has not been used")||R.includes("accessnotconfigured"),$=R.includes("permission")||w.includes("403")||R.includes("access denied"),m=R.includes("project")&&R.includes("not found"),L=R.includes("not found")||w.includes("404");C?i.push({name:"BigQuery API",category:"bigquery",status:"error",message:"BigQuery API is not enabled",fix:{gcloud:`gcloud services enable bigquery.googleapis.com --project=${o}`,console:`${p}/apis/library/bigquery.googleapis.com?project=${o}`}}):m?i.push({name:"BigQuery Project",category:"bigquery",status:"error",message:w,fix:{hint:"The GCP project does not exist or the credentials don't have access to it. In the Firebase emulator, GCLOUD_PROJECT may override the configured projectId. Ensure you pass the correct projectId to the BigQuery constructor and have valid credentials.",console:`${p}/home/dashboard`}}):$?i.push({name:"BigQuery API",category:"bigquery",status:"error",message:`Permission denied: ${w}`,fix:{hint:"Grant the service account BigQuery Data Editor + BigQuery Job User roles",gcloud:[`SA=$(gcloud run services describe YOUR_SERVICE --region=YOUR_REGION --format="value(spec.template.spec.serviceAccountName)" --project=${o})`,`gcloud projects add-iam-policy-binding ${o} --member="serviceAccount:$SA" --role="roles/bigquery.dataEditor"`,`gcloud projects add-iam-policy-binding ${o} --member="serviceAccount:$SA" --role="roles/bigquery.jobUser"`].join(`
-`),console:`${p}/iam-admin/iam?project=${o}`}}):L?i.push({name:"BigQuery Dataset",category:"bigquery",status:"error",message:`Dataset not found: ${w}`,fix:{hint:"Create the dataset first",gcloud:`bq mk --dataset ${o}:YOUR_DATASET_ID`,console:`${p}/bigquery?project=${o}`}}):i.push({name:"BigQuery API",category:"bigquery",status:"ok",message:"BigQuery API is reachable (table lookup returned expected error)"});}for(let g of y)try{let w=await e.tableExists(g.tableName);i.push({name:`Table: ${g.tableName}`,category:"bigquery",status:w?"ok":"warn",message:w?`Table \`${g.tableName}\` exists`:`Table \`${g.tableName}\` does not exist yet`,...!w&&{fix:{hint:"Table will be auto-created on first sync if autoMigrate is enabled. Or create it manually."}}});}catch(w){i.push({name:`Table: ${g.tableName}`,category:"bigquery",status:"error",message:w?.message??String(w)});}if(h)for(let g of y){let w=`${b}-${g.name}`;try{let R=h.topic(w);if(typeof R.exists=="function"){let[C]=await R.exists();i.push({name:`Topic: ${w}`,category:"pubsub",status:C?"ok":"error",message:C?`Topic \`${w}\` exists`:`Topic \`${w}\` does not exist`,...!C&&{fix:{gcloud:`gcloud pubsub topics create ${w} --project=${o}`,console:`${p}/cloudpubsub/topic/list?project=${o}`}}});}else i.push({name:`Topic: ${w}`,category:"pubsub",status:"warn",message:"Cannot verify topic existence (PubSub client doesn't expose .exists())",fix:{gcloud:`gcloud pubsub topics create ${w} --project=${o}`,console:`${p}/cloudpubsub/topic/list?project=${o}`,hint:"Ensure the topic exists. It is auto-created by the Firebase emulator but must exist in production."}});}catch(R){let C=R?.message??String(R),$=C.includes("disabled")||C.includes("has not been used");if(i.push({name:$?"Pub/Sub API":`Topic: ${w}`,category:"pubsub",status:"error",message:$?"Pub/Sub API is not enabled":C,fix:$?{gcloud:`gcloud services enable pubsub.googleapis.com --project=${o}`,console:`${p}/apis/library/pubsub.googleapis.com?project=${o}`}:{gcloud:`gcloud pubsub topics create ${w} --project=${o}`,console:`${p}/cloudpubsub/topic/list?project=${o}`}}),$)break}}else i.push({name:"Pub/Sub Client",category:"pubsub",status:"warn",message:"PubSub client not available for config check"});if(F(c)){let g=i.every(w=>w.status==="ok");z(d,{project:o,healthy:g,checks:i});return}let S=g=>g==="ok"?'<span class="badge badge-ok">OK</span>':g==="warn"?'<span class="badge badge-warn">WARN</span>':'<span class="badge badge-err">ERROR</span>',v={bigquery:i.filter(g=>g.category==="bigquery"),pubsub:i.filter(g=>g.category==="pubsub"),firestore:i.filter(g=>g.category==="firestore")},A=(g,w)=>{if(w.length===0)return "";let R=w.map(C=>{let $="";if(C.fix){let m=[];C.fix.hint&&m.push(`<p class="muted">${C.fix.hint}</p>`),C.fix.gcloud&&m.push(`<pre>$ ${C.fix.gcloud}</pre>`),C.fix.console&&m.push(`<p><a href="${C.fix.console}" target="_blank">Open GCP Console \u2192</a></p>`),$=`<div style="margin-top:.5rem">${m.join("")}</div>`;}return `<tr>
+        </div>`);O(u,I);})),k.configCheck&&l.get(`${p}/config-check`,async(c,u)=>{let a=_(c,p),o=process.env.GCLOUD_PROJECT??process.env.GOOGLE_CLOUD_PROJECT??process.env.GCP_PROJECT??"unknown",f="https://console.cloud.google.com",b=w??"firestore-sync",i=[];try{await e.tableExists("__nonexistent_health_check__"),i.push({name:"BigQuery API",category:"bigquery",status:"ok",message:"BigQuery API is reachable"});}catch(g){let x=g?.message??String(g),T=x.toLowerCase(),C=T.includes("disabled")||T.includes("has not been used")||T.includes("accessnotconfigured"),$=T.includes("permission")||x.includes("403")||T.includes("access denied"),m=T.includes("project")&&T.includes("not found"),L=T.includes("not found")||x.includes("404");C?i.push({name:"BigQuery API",category:"bigquery",status:"error",message:"BigQuery API is not enabled",fix:{gcloud:`gcloud services enable bigquery.googleapis.com --project=${o}`,console:`${f}/apis/library/bigquery.googleapis.com?project=${o}`}}):m?i.push({name:"BigQuery Project",category:"bigquery",status:"error",message:x,fix:{hint:"The GCP project does not exist or the credentials don't have access to it. In the Firebase emulator, GCLOUD_PROJECT may override the configured projectId. Ensure you pass the correct projectId to the BigQuery constructor and have valid credentials.",console:`${f}/home/dashboard`}}):$?i.push({name:"BigQuery API",category:"bigquery",status:"error",message:`Permission denied: ${x}`,fix:{hint:"Grant the service account BigQuery Data Editor + BigQuery Job User roles",gcloud:[`SA=$(gcloud run services describe YOUR_SERVICE --region=YOUR_REGION --format="value(spec.template.spec.serviceAccountName)" --project=${o})`,`gcloud projects add-iam-policy-binding ${o} --member="serviceAccount:$SA" --role="roles/bigquery.dataEditor"`,`gcloud projects add-iam-policy-binding ${o} --member="serviceAccount:$SA" --role="roles/bigquery.jobUser"`].join(`
+`),console:`${f}/iam-admin/iam?project=${o}`}}):L?i.push({name:"BigQuery Dataset",category:"bigquery",status:"error",message:`Dataset not found: ${x}`,fix:{hint:"Create the dataset first",gcloud:`bq mk --dataset ${o}:YOUR_DATASET_ID`,console:`${f}/bigquery?project=${o}`}}):i.push({name:"BigQuery API",category:"bigquery",status:"ok",message:"BigQuery API is reachable (table lookup returned expected error)"});}for(let g of y)try{let x=await e.tableExists(g.tableName);i.push({name:`Table: ${g.tableName}`,category:"bigquery",status:x?"ok":"warn",message:x?`Table \`${g.tableName}\` exists`:`Table \`${g.tableName}\` does not exist yet`,...!x&&{fix:{hint:"Table will be auto-created on first sync if autoMigrate is enabled. Or create it manually."}}});}catch(x){i.push({name:`Table: ${g.tableName}`,category:"bigquery",status:"error",message:x?.message??String(x)});}if(h)for(let g of y){let x=`${b}-${g.name}`;try{let T=h.topic(x);if(typeof T.exists=="function"){let[C]=await T.exists();i.push({name:`Topic: ${x}`,category:"pubsub",status:C?"ok":"error",message:C?`Topic \`${x}\` exists`:`Topic \`${x}\` does not exist`,...!C&&{fix:{gcloud:`gcloud pubsub topics create ${x} --project=${o}`,console:`${f}/cloudpubsub/topic/list?project=${o}`}}});}else i.push({name:`Topic: ${x}`,category:"pubsub",status:"warn",message:"Cannot verify topic existence (PubSub client doesn't expose .exists())",fix:{gcloud:`gcloud pubsub topics create ${x} --project=${o}`,console:`${f}/cloudpubsub/topic/list?project=${o}`,hint:"Ensure the topic exists. It is auto-created by the Firebase emulator but must exist in production."}});}catch(T){let C=T?.message??String(T),$=C.includes("disabled")||C.includes("has not been used");if(i.push({name:$?"Pub/Sub API":`Topic: ${x}`,category:"pubsub",status:"error",message:$?"Pub/Sub API is not enabled":C,fix:$?{gcloud:`gcloud services enable pubsub.googleapis.com --project=${o}`,console:`${f}/apis/library/pubsub.googleapis.com?project=${o}`}:{gcloud:`gcloud pubsub topics create ${x} --project=${o}`,console:`${f}/cloudpubsub/topic/list?project=${o}`}}),$)break}}else i.push({name:"Pub/Sub Client",category:"pubsub",status:"warn",message:"PubSub client not available for config check"});if(F(c)){let g=i.every(x=>x.status==="ok");z(u,{project:o,healthy:g,checks:i});return}let S=g=>g==="ok"?'<span class="badge badge-ok">OK</span>':g==="warn"?'<span class="badge badge-warn">WARN</span>':'<span class="badge badge-err">ERROR</span>',R={bigquery:i.filter(g=>g.category==="bigquery"),pubsub:i.filter(g=>g.category==="pubsub"),firestore:i.filter(g=>g.category==="firestore")},v=(g,x)=>{if(x.length===0)return "";let T=x.map(C=>{let $="";if(C.fix){let m=[];C.fix.hint&&m.push(`<p class="muted">${C.fix.hint}</p>`),C.fix.gcloud&&m.push(`<pre>$ ${C.fix.gcloud}</pre>`),C.fix.console&&m.push(`<p><a href="${C.fix.console}" target="_blank">Open GCP Console \u2192</a></p>`),$=`<div style="margin-top:.5rem">${m.join("")}</div>`;}return `<tr>
               <td>${S(C.status)}</td>
               <td><strong>${C.name}</strong><br><span class="muted">${C.message}</span>${$}</td>
             </tr>`}).join(`
 `);return `<h2>${g}</h2>
           <table><thead><tr><th style="width:80px">Status</th><th>Check</th></tr></thead>
-          <tbody>${R}</tbody></table>`},E=i.every(g=>g.status==="ok")?'<span class="badge badge-ok">All checks passed</span>':'<span class="badge badge-warn">Some issues found</span>',I=N("Config Check",a,`<div class="card">
+          <tbody>${T}</tbody></table>`},E=i.every(g=>g.status==="ok")?'<span class="badge badge-ok">All checks passed</span>':'<span class="badge badge-warn">Some issues found</span>',I=N("Config Check",a,`<div class="card">
           <p>Project: <code>${o}</code> ${E}</p>
-          ${A("BigQuery",v.bigquery)}
-          ${A("Pub/Sub",v.pubsub)}
-          ${A("Firestore",v.firestore)}
-        </div>`);O(d,I);}),async(c,d)=>{await f.handle(c,d);}}function Y(n,e){let t=e.columns.map(r=>{let s=r.isPrimaryKey?" NOT NULL":"";return `  ${n.quoteIdentifier(r.name)} ${r.sqlType}${s}`}).join(`,
+          ${v("BigQuery",R.bigquery)}
+          ${v("Pub/Sub",R.pubsub)}
+          ${v("Firestore",R.firestore)}
+        </div>`);O(u,I);}),async(c,u)=>{await l.handle(c,u);}}function X(n,e){let t=e.columns.map(r=>{let s=r.isPrimaryKey?" NOT NULL":"";return `  ${n.quoteIdentifier(r.name)} ${r.sqlType}${s}`}).join(`,
 `);return `CREATE TABLE IF NOT EXISTS ${n.quoteIdentifier(e.tableName)} (
 ${t}
-);`}function de(n,e,t){return t.map(r=>`ALTER TABLE ${n.quoteIdentifier(e)} ADD COLUMN ${n.quoteIdentifier(r.name)} ${r.sqlType};`).join(`
-`)}function ue(n,e,t){let r=[];for(let[s,u]of Object.entries(n)){let h=u.schema??u._schema??void 0;if(!h)continue;let x=t?.repos?.[s],l=x?.tableName??s,k=u._systemKeys?.[0]??u.documentKey??"docId",y=P(h,e,{primaryKey:k,exclude:x?.exclude,columnMap:x?.columnMap}),f={tableName:l,columns:y};r.push(Y(e,f));}return r.join(`
+);`}function pe(n,e,t){return t.map(r=>`ALTER TABLE ${n.quoteIdentifier(e)} ADD COLUMN ${n.quoteIdentifier(r.name)} ${r.sqlType};`).join(`
+`)}function fe(n,e,t){let r=[];for(let[s,d]of Object.entries(n)){let h=d.schema??d._schema??void 0;if(!h)continue;let w=t?.repos?.[s],p=w?.tableName??s,k=d._systemKeys?.[0]??d.documentKey??"docId",y=P(h,e,{primaryKey:k,exclude:w?.exclude,columnMap:w?.columnMap}),l={tableName:p,columns:y};r.push(X(e,l));}return r.join(`
 
-`)}async function le(n,e,t){let r={created:[],altered:[],upToDate:[],skipped:[]};for(let[s,u]of Object.entries(n)){let h=u.schema??void 0;if(!h){r.skipped.push(s);continue}let x=t?.repos?.[s],l=x?.tableName??s,k=u._systemKeys?.[0]??u.documentKey??"docId",y=P(h,e.dialect,{primaryKey:k,exclude:x?.exclude,columnMap:x?.columnMap}),f={tableName:l,columns:y};if(!await e.tableExists(l))await e.createTable(f),r.created.push(l);else {let d=new Set(await e.getTableColumns(l)),a=y.filter(o=>!d.has(o.name));a.length>0?(await e.addColumns(l,a),r.altered.push(l)):r.upToDate.push(l);}}return r}var q=class{constructor(e){this.buffer=[];this.flushing=false;this.timer=null;this.adapter=e.adapter,this.tableName=e.tableName,this.primaryKey=e.primaryKey,this.batchSize=e.batchSize??100,this.onFlushError=e.onFlushError;let t=e.flushIntervalMs??5e3;t>0&&(this.timer=setInterval(()=>{this.flush();},t),typeof this.timer=="object"&&"unref"in this.timer&&this.timer.unref());}get size(){return this.buffer.length}enqueue(...e){this.buffer.push(...e),this.buffer.length>=this.batchSize&&this.flush();}async flush(){if(this.flushing||this.buffer.length===0)return;this.flushing=true;let e=this.buffer.splice(0,this.batchSize);try{let t=new Map,r=[];for(let u of e)if(u.operation==="DELETE")r.push(u.docId),t.delete(u.docId);else if(u.data){let h=t.get(u.docId);if(!h)t.set(u.docId,u.data);else {let x=Number(h[D]??0);Number(u.data[D]??0)>=x&&t.set(u.docId,u.data);}}let s=Array.from(t.values());s.length>0&&await this.adapter.upsertRows(this.tableName,s,this.primaryKey),r.length>0&&await this.adapter.deleteRows(this.tableName,this.primaryKey,r);}catch(t){this.onFlushError?await this.onFlushError(e,t).catch(r=>{console.error(`[SyncQueue] Flush error for ${this.tableName}:`,t),console.error("[SyncQueue] Error handler also failed:",r);}):(this.buffer.unshift(...e),console.error(`[SyncQueue] Flush failed for ${this.tableName}:`,t));}finally{this.flushing=false;}}async shutdown(){this.timer&&(clearInterval(this.timer),this.timer=null),await this.flush();}};var pe="firestore-sync";function fe(n,e){let t=e.ref?.path??void 0;return t?`${t}/{docId}`:(console.warn(`[SyncTriggers] Cannot determine collection path for "${n}". Skipping.`),null)}function ge(n,e){let{onDocumentCreated:t,onDocumentUpdated:r,onDocumentDeleted:s}=e.deps.firestoreTriggers,u=e.deps.pubsub,h=e?.topicPrefix??pe,x={},l=new Map;function k(f){let c=l.get(f);return c||(c=u.topic(f),l.set(f,c),c)}async function y(f,c){await k(f).publishMessage({json:c});}for(let[f,c]of Object.entries(n)){let d=e?.repos?.[f],a;if(c._isGroup){if(!d?.triggerPath){console.warn(`[SyncTriggers] Skipping collection-group repo "${f}". Provide a triggerPath in the sync repos config for group collections.`);continue}a=d.triggerPath;}else a=d?.triggerPath??fe(f,c);if(!a)continue;let o=c._systemKeys?.[0]??"docId",p=`${h}-${f}`;x[`${f}_onCreate`]=t(a,async b=>{let i=b.data;if(!i)return;let S=i.data();if(!S)return;let v=String(S[o]??i.id),A=j(S,{exclude:d?.exclude,columnMap:d?.columnMap}),T={operation:"INSERT",repoName:f,docId:v,data:A,timestamp:new Date().toISOString(),version:Date.now()};await y(p,T);}),x[`${f}_onUpdate`]=r(a,async b=>{let i=b.data?.after;if(!i)return;let S=i.data();if(!S)return;let v=String(S[o]??i.id),A=j(S,{exclude:d?.exclude,columnMap:d?.columnMap}),T={operation:"UPSERT",repoName:f,docId:v,data:A,timestamp:new Date().toISOString(),version:Date.now()};await y(p,T);}),x[`${f}_onDelete`]=s(a,async b=>{let i=b.data;if(!i)return;let S=i.data(),v=String(S?.[o]??i.id),A={operation:"DELETE",repoName:f,docId:v,data:null,timestamp:new Date().toISOString(),version:Date.now()};await y(p,A);});}return x}var X=new Set;async function me(n,e,t,r,s,u,h){if(X.has(n))return;let x=P(t,e.dialect,{primaryKey:s,exclude:u,columnMap:h});if(!await e.tableExists(r))await e.createTable({tableName:r,columns:x});else {let k=new Set(await e.getTableColumns(r)),y=x.filter(f=>!k.has(f.name));y.length>0&&await e.addColumns(r,y);}X.add(n);}function he(n,e){let{deps:t,adapter:r,batchSize:s=100,flushIntervalMs:u=5e3,autoMigrate:h=false,topicPrefix:x="firestore-sync",workerOptions:l,repos:k={}}=e,y=new Map;function f(a,o){let p=y.get(a);if(p)return p;let i=k[a]?.tableName??a,S=async(v,A)=>{console.error(`[SyncWorker] Flush failed for "${a}" (${v.length} events):`,A);try{let T=`${x}-${a}-dlq`,E=t.pubsub.topic(T),[I]=await E.exists();I||(await E.create(),console.info(`[SyncWorker] Created DLQ topic "${T}"`));for(let g of v)await E.publishMessage({json:g});}catch(T){console.error(`[SyncWorker] Dead-letter publish also failed for ${a}:`,T);}};return p=new q({adapter:r,tableName:i,primaryKey:o,batchSize:s,flushIntervalMs:u,onFlushError:S}),y.set(a,p),p}async function c(a){let{repoName:o}=a,p=n[o];if(!p){console.warn(`[SyncWorker] Unknown repo "${o}", skipping event`);return}let b=p._systemKeys?.[0]??p.documentKey??"docId",i=k[o],S=i?.columnMap,v=S?.[b]??b;if(h){let T=p.schema??void 0;if(T){let E=i?.tableName??o;await me(o,r,T,E,b,i?.exclude,S);}}let A=f(o,v);a.data&&(a.data[D]=a.version??Date.now()),A.enqueue(a);}function d(a){let o=async p=>{let b=p.data?.message?.json??p.data?.json;if(!b){console.warn("[SyncWorker] Received empty PubSub message");return}await c(b);let i=y.get(b.repoName);i&&await i.flush();};return l?t.pubsubHandler.onMessagePublished({topic:a,...l},o):t.pubsubHandler.onMessagePublished(a,o)}return {handleMessage:c,createHandler:d,queues:y,async shutdown(){let a=[];for(let o of y.values())a.push(o.shutdown());await Promise.all(a);}}}exports.SyncQueue=q;exports.addColumnsDDL=de;exports.autoMigrate=le;exports.createSyncTriggers=ge;exports.createSyncWorker=he;exports.createTableDDL=Y;exports.createadminsyncServer=ce;exports.generateDDL=ue;exports.serializeDocument=j;exports.serializeValue=K;exports.zodSchemaToColumns=P;exports.zodTypeToLogical=ae;//# sourceMappingURL=index.cjs.map
+`)}async function ge(n,e,t){let r={created:[],altered:[],upToDate:[],skipped:[]};for(let[s,d]of Object.entries(n)){let h=d.schema??void 0;if(!h){r.skipped.push(s);continue}let w=t?.repos?.[s],p=w?.tableName??s,k=d._systemKeys?.[0]??d.documentKey??"docId",y=P(h,e.dialect,{primaryKey:k,exclude:w?.exclude,columnMap:w?.columnMap}),l={tableName:p,columns:y};if(!await e.tableExists(p))await e.createTable(l),r.created.push(p);else {let u=new Set(await e.getTableColumns(p)),a=y.filter(o=>!u.has(o.name));a.length>0?(await e.addColumns(p,a),r.altered.push(p)):r.upToDate.push(p);}}return r}var M=class{constructor(e){this.buffer=[];this.flushing=false;this.flushPromise=null;this.timer=null;this.adapter=e.adapter,this.tableName=e.tableName,this.primaryKey=e.primaryKey,this.batchSize=e.batchSize??100,this.onFlushError=e.onFlushError;let t=e.flushIntervalMs??5e3;t>0&&(this.timer=setInterval(()=>{this.flush();},t),typeof this.timer=="object"&&"unref"in this.timer&&this.timer.unref());}get size(){return this.buffer.length}enqueue(...e){this.buffer.push(...e),this.buffer.length>=this.batchSize&&this.flush();}async flush(){for(;this.flushing&&this.flushPromise;)await this.flushPromise;this.buffer.length!==0&&(this.flushing=true,this.flushPromise=this._doFlush().finally(()=>{this.flushing=false,this.flushPromise=null;}),await this.flushPromise);}async _doFlush(){let e=this.buffer.splice(0,this.batchSize);try{let t=new Map,r=[];for(let d of e)if(d.operation==="DELETE")r.push(d.docId),t.delete(d.docId);else if(d.data){let h=t.get(d.docId);if(!h)t.set(d.docId,d.data);else {let w=Number(h[D]??0);Number(d.data[D]??0)>=w&&t.set(d.docId,d.data);}}let s=Array.from(t.values());s.length>0&&await this.adapter.upsertRows(this.tableName,s,this.primaryKey),r.length>0&&await this.adapter.deleteRows(this.tableName,this.primaryKey,r);}catch(t){this.onFlushError?await this.onFlushError(e,t):(this.buffer.unshift(...e),console.error(`[SyncQueue] Flush failed for ${this.tableName}:`,t));}}async shutdown(){this.timer&&(clearInterval(this.timer),this.timer=null),await this.flush();}};var me="firestore-sync";function he(n,e){let t=e.ref?.path??void 0;return t?`${t}/{docId}`:(console.warn(`[SyncTriggers] Cannot determine collection path for "${n}". Skipping.`),null)}function ye(n,e){let{onDocumentCreated:t,onDocumentUpdated:r,onDocumentDeleted:s}=e.deps.firestoreTriggers,d=e.deps.pubsub,h=e?.topicPrefix??me,w={},p=new Map;function k(l){let c=p.get(l);return c||(c=d.topic(l),p.set(l,c),c)}async function y(l,c){await k(l).publishMessage({json:c});}for(let[l,c]of Object.entries(n)){let u=e?.repos?.[l],a;if(c._isGroup){if(!u?.triggerPath){console.warn(`[SyncTriggers] Skipping collection-group repo "${l}". Provide a triggerPath in the sync repos config for group collections.`);continue}a=u.triggerPath;}else a=u?.triggerPath??he(l,c);if(!a)continue;let o=c._systemKeys?.[0]??"docId",f=`${h}-${l}`;w[`${l}_onCreate`]=t(a,async b=>{let i=b.data;if(!i)return;let S=i.data();if(!S)return;let R=String(S[o]??i.id),v=j(S,{exclude:u?.exclude,columnMap:u?.columnMap}),A={operation:"INSERT",repoName:l,docId:R,data:v,timestamp:new Date().toISOString(),version:Date.now()};await y(f,A);}),w[`${l}_onUpdate`]=r(a,async b=>{let i=b.data?.after;if(!i)return;let S=i.data();if(!S)return;let R=String(S[o]??i.id),v=j(S,{exclude:u?.exclude,columnMap:u?.columnMap}),A={operation:"UPSERT",repoName:l,docId:R,data:v,timestamp:new Date().toISOString(),version:Date.now()};await y(f,A);}),w[`${l}_onDelete`]=s(a,async b=>{let i=b.data;if(!i)return;let S=i.data(),R=String(S?.[o]??i.id),v={operation:"DELETE",repoName:l,docId:R,data:null,timestamp:new Date().toISOString(),version:Date.now()};await y(f,v);});}return w}function ee(n){let e=n.toUpperCase();switch(e){case "INTEGER":return "INT64";case "FLOAT":return "FLOAT64";case "BOOLEAN":return "BOOL";default:return e}}function te(n,e){let t=ee(n),r=ee(e);return t===r?true:{INT64:["NUMERIC","BIGNUMERIC","FLOAT64"],NUMERIC:["BIGNUMERIC","FLOAT64"],DATE:["DATETIME","TIMESTAMP"],DATETIME:["TIMESTAMP"]}[t]?.includes(r)??false}var ne=new Set,G=class extends Error{constructor(t,r,s,d){super(`Schema drift detected on \`${t}\`: column \`${r}\` has type ${s} in BigQuery but the current Zod schema maps it to ${d}. BigQuery cannot safely convert between these types \u2014 to resolve, either (a) keep the BigQuery type and add a transform in your repo to coerce values, (b) rename the field in your Zod schema (creates a new column), or (c) drop & recreate the table.`);this.tableName=t;this.column=r;this.existingType=s;this.desiredType=d;this.name="SchemaTypeMismatchError";}};async function be(n,e,t,r,s,d,h){if(ne.has(n))return;let w=P(t,e.dialect,{primaryKey:s,exclude:d,columnMap:h});if(!await e.tableExists(r))await e.createTable({tableName:r,columns:w});else if(e.getTableColumnsWithTypes){let k=await e.getTableColumnsWithTypes(r),y=[];for(let l of w){let c=k.get(l.name);if(c===void 0){y.push(l);continue}if(e.dialect.name==="bigquery"&&!te(c,l.sqlType))throw new G(r,l.name,c,l.sqlType)}y.length>0&&(await e.addColumns(r,y),await e.onSchemaChange?.(r));}else {let k=new Set(await e.getTableColumns(r)),y=w.filter(l=>!k.has(l.name));y.length>0&&(await e.addColumns(r,y),await e.onSchemaChange?.(r));}ne.add(n);}function Se(n,e){let{deps:t,adapter:r,batchSize:s=100,flushIntervalMs:d=5e3,autoMigrate:h=false,topicPrefix:w="firestore-sync",workerOptions:p,repos:k={}}=e,y=new Map;function l(a,o){let f=y.get(a);if(f)return f;let i=k[a]?.tableName??a,S=async(R,v)=>{console.error(`[SyncWorker] Flush failed for "${a}" (${R.length} events):`,v);let A=`${w}-${a}-dlq`,E=t.pubsub.topic(A),[I]=await E.exists();I||(await E.create(),console.info(`[SyncWorker] Created DLQ topic "${A}"`));for(let g of R)await E.publishMessage({json:g});};return f=new M({adapter:r,tableName:i,primaryKey:o,batchSize:s,flushIntervalMs:d,onFlushError:S}),y.set(a,f),f}async function c(a){let{repoName:o}=a,f=n[o];if(!f){console.warn(`[SyncWorker] Unknown repo "${o}", skipping event`);return}let b=f._systemKeys?.[0]??f.documentKey??"docId",i=k[o],S=i?.columnMap,R=S?.[b]??b;if(h){let A=f.schema??void 0;if(A){let E=i?.tableName??o;await be(o,r,A,E,b,i?.exclude,S);}}let v=l(o,R);a.data&&(a.data[D]=a.version??Date.now()),v.enqueue(a);}function u(a){let o=async f=>{let b=f.data?.message?.json??f.data?.json;if(!b){console.warn("[SyncWorker] Received empty PubSub message");return}await c(b);let i=y.get(b.repoName);i&&await i.flush();};return p?t.pubsubHandler.onMessagePublished({topic:a,...p},o):t.pubsubHandler.onMessagePublished(a,o)}return {handleMessage:c,createHandler:u,queues:y,async shutdown(){let a=[];for(let o of y.values())a.push(o.shutdown());await Promise.all(a);}}}exports.SyncQueue=M;exports.addColumnsDDL=pe;exports.autoMigrate=ge;exports.createSyncTriggers=ye;exports.createSyncWorker=Se;exports.createTableDDL=X;exports.createadminsyncServer=le;exports.generateDDL=fe;exports.serializeDocument=j;exports.serializeValue=K;exports.zodSchemaToColumns=P;exports.zodTypeToLogical=ue;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map