@lpdjs/firestore-repo-service 2.3.2 → 2.3.4

package/dist/{types-CBwcflkG.d.ts → types-Bhy7MfCj.d.ts}

@@ -94,6 +94,16 @@ interface SqlAdapter {
      * Used by the migration manager to detect schema drift.
      */
     getTableColumns(tableName: string): Promise<string[]>;
+    /**
+     * Return existing columns with their dialect-specific SQL type strings.
+     * Used by the worker to detect type drift (e.g. Zod field changes from
+     * `number` to `string`) and fail fast with an explicit error rather than
+     * letting MERGE/Storage Write fail silently on every event.
+     *
+     * Optional for backwards-compat: if the adapter does not implement it,
+     * the worker skips type-drift detection but still adds new columns.
+     */
+    getTableColumnsWithTypes?(tableName: string): Promise<Map<string, string>>;
     /**
      * Create a table. Should be idempotent (IF NOT EXISTS).
      */
@@ -116,6 +126,15 @@ interface SqlAdapter {
      * The adapter is responsible for qualifying table names (e.g. dataset.table).
      */
     addColumns(tableName: string, columns: SqlColumn[]): Promise<void>;
+    /**
+     * Hook called by the worker after a schema change (`addColumns`) so that
+     * adapters caching schema-derived state — e.g. Storage Write proto
+     * descriptors / writer connections — can invalidate their cache.
+     *
+     * Optional: adapters with no cache (legacy `BigQueryAdapter`) do not need
+     * to implement this.
+     */
+    onSchemaChange?(tableName: string): void | Promise<void>;
     /**
      * Execute a raw SQL statement.
      * The adapter is responsible for qualifying any table references.

package/dist/{types-BW592RAZ.d.cts → types-_JSH59Iy.d.cts}

@@ -94,6 +94,16 @@ interface SqlAdapter {
      * Used by the migration manager to detect schema drift.
      */
     getTableColumns(tableName: string): Promise<string[]>;
+    /**
+     * Return existing columns with their dialect-specific SQL type strings.
+     * Used by the worker to detect type drift (e.g. Zod field changes from
+     * `number` to `string`) and fail fast with an explicit error rather than
+     * letting MERGE/Storage Write fail silently on every event.
+     *
+     * Optional for backwards-compat: if the adapter does not implement it,
+     * the worker skips type-drift detection but still adds new columns.
+     */
+    getTableColumnsWithTypes?(tableName: string): Promise<Map<string, string>>;
     /**
      * Create a table. Should be idempotent (IF NOT EXISTS).
      */
@@ -116,6 +126,15 @@ interface SqlAdapter {
      * The adapter is responsible for qualifying table names (e.g. dataset.table).
      */
     addColumns(tableName: string, columns: SqlColumn[]): Promise<void>;
+    /**
+     * Hook called by the worker after a schema change (`addColumns`) so that
+     * adapters caching schema-derived state — e.g. Storage Write proto
+     * descriptors / writer connections — can invalidate their cache.
+     *
+     * Optional: adapters with no cache (legacy `BigQueryAdapter`) do not need
+     * to implement this.
+     */
+    onSchemaChange?(tableName: string): void | Promise<void>;
     /**
      * Execute a raw SQL statement.
      * The adapter is responsible for qualifying any table references.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lpdjs/firestore-repo-service",
-  "version": "2.3.2",
+  "version": "2.3.4",
   "workspaces": [
     "test/functions"
   ],
@@ -40,6 +40,16 @@
         "default": "./dist/sync/bigquery.js"
       }
     },
+    "./sync/bigquery-storage": {
+      "require": {
+        "types": "./dist/sync/bigquery-storage.d.cts",
+        "default": "./dist/sync/bigquery-storage.cjs"
+      },
+      "import": {
+        "types": "./dist/sync/bigquery-storage.d.ts",
+        "default": "./dist/sync/bigquery-storage.js"
+      }
+    },
     "./history": {
       "require": {
         "types": "./dist/history/index.d.cts",
@@ -124,6 +134,9 @@
       "sync/bigquery": [
         "./dist/sync/bigquery.d.ts"
       ],
+      "sync/bigquery-storage": [
+        "./dist/sync/bigquery-storage.d.ts"
+      ],
       "history": [
         "./dist/history/index.d.ts"
       ]
@@ -195,6 +208,7 @@
   "homepage": "https://frs.lpdjs.fr",
   "peerDependencies": {
     "@google-cloud/bigquery": "^7.0.0 || ^8.0.0",
+    "@google-cloud/bigquery-storage": "^4.0.0 || ^5.0.0",
     "@google-cloud/pubsub": "^4.0.0 || ^5.0.0",
     "firebase-admin": "^11.0.0 || ^12.0.0 || ^13.0.0",
     "firebase-functions": "^5.0.0 || ^6.0.0 || ^7.0.0",
@@ -208,12 +222,16 @@
     "@google-cloud/bigquery": {
       "optional": true
     },
+    "@google-cloud/bigquery-storage": {
+      "optional": true
+    },
     "@google-cloud/pubsub": {
       "optional": true
     }
   },
   "devDependencies": {
     "@google-cloud/bigquery": "^8.3.0",
+    "@google-cloud/bigquery-storage": "^5.1.0",
     "@google-cloud/pubsub": "^5.3.0",
     "@types/bun": "latest",
     "@types/express": "latest",