@pol-studios/db 1.0.48 → 1.0.50

package/dist/{DataLayerContext-DWlohoEg.d.ts → DataLayerContext--jqUiEMX.d.ts}

@@ -292,6 +292,13 @@ declare class AdapterAutoDetector {
     private lastResult;
     private syncStatus;
     constructor(powerSyncDb: PowerSyncDatabase | null, supabase: SupabaseClient | null, options?: AutoDetectorOptions);
+    /**
+     * Update the PowerSync database reference.
+     * Called when PowerSync becomes available after initial construction.
+     *
+     * @param db - PowerSync database instance or null
+     */
+    setPowerSyncDb(db: PowerSyncDatabase | null): void;
     /**
      * Update the sync status from PowerSync.
      * Called when sync status changes to re-evaluate backend recommendation.
@@ -530,9 +537,19 @@ declare class AdapterRegistry {
      */
     private adapters;
     /**
-     * PowerSync adapter instance (set during initialization)
+     * PowerSync adapter instance (set during initialization or lazily via getter)
      */
     private powerSyncAdapter;
+    /**
+     * Getter function to retrieve PowerSync database instance.
+     * Used for lazy initialization when PowerSync becomes available after registry creation.
+     */
+    private powerSyncGetter;
+    /**
+     * Factory function to create PowerSync adapter from database instance.
+     * Set via setPowerSyncGetter along with the getter.
+     */
+    private powerSyncAdapterFactory;
     /**
      * Supabase adapter instance (set during initialization)
      */
@@ -592,6 +609,26 @@ declare class AdapterRegistry {
      * @param adapter - PowerSync adapter implementation
      */
     setPowerSyncAdapter(adapter: TableDataAdapter): void;
+    /**
+     * Set a getter function for lazy PowerSync adapter initialization.
+     *
+     * This allows the registry to lazily create the PowerSync adapter when
+     * PowerSync becomes available, rather than requiring it at initialization time.
+     * Solves race conditions where queries/mutations run before PowerSync is ready.
+     *
+     * @param getter - Function that returns the PowerSync database instance (or null if not ready)
+     * @param factory - Function that creates a TableDataAdapter from the database instance
+     */
+    setPowerSyncGetter(getter: () => unknown, factory: (db: unknown) => TableDataAdapter): void;
+    /**
+     * Ensure PowerSync adapter is initialized if available.
+     *
+     * Checks the getter (if set) and lazily creates the adapter if PowerSync
+     * is now available. Also updates the auto-detector with the new reference.
+     *
+     * @returns true if PowerSync adapter is available, false otherwise
+     */
+    private ensurePowerSyncAdapter;
     /**
      * Set the sync tracker for mutation tracking.
      * When set, write operations on PowerSync tables will
@@ -643,7 +680,7 @@ declare class AdapterRegistry {
      * @returns The appropriate adapter for the table
      * @throws Error if adapters are not initialized
      */
-    getAdapter(table: string, operation?: 'read' | 'write'): TableDataAdapter;
+    getAdapter(table: string, _operation?: 'read' | 'write'): TableDataAdapter;
     /**
      * Get the PowerSync adapter directly
      *

package/dist/{chunk-GEU5ED7L.js → chunk-7CLN4ORU.js}

@@ -4164,6 +4164,18 @@ var AdapterAutoDetector = class {
   listeners = /* @__PURE__ */ new Set();
   lastResult = null;
   syncStatus = null;
+  /**
+   * Update the PowerSync database reference.
+   * Called when PowerSync becomes available after initial construction.
+   *
+   * @param db - PowerSync database instance or null
+   */
+  setPowerSyncDb(db) {
+    this.powerSyncDb = db;
+    if (db) {
+      this.detect();
+    }
+  }
   /**
    * Update the sync status from PowerSync.
    * Called when sync status changes to re-evaluate backend recommendation.
@@ -4611,9 +4623,19 @@ var AdapterRegistry = class {
    */
   adapters = /* @__PURE__ */ new Map();
   /**
-   * PowerSync adapter instance (set during initialization)
+   * PowerSync adapter instance (set during initialization or lazily via getter)
    */
   powerSyncAdapter = null;
+  /**
+   * Getter function to retrieve PowerSync database instance.
+   * Used for lazy initialization when PowerSync becomes available after registry creation.
+   */
+  powerSyncGetter = null;
+  /**
+   * Factory function to create PowerSync adapter from database instance.
+   * Set via setPowerSyncGetter along with the getter.
+   */
+  powerSyncAdapterFactory = null;
   /**
    * Supabase adapter instance (set during initialization)
    */
@@ -4682,6 +4704,46 @@ var AdapterRegistry = class {
       this.syncTrackingAdapter = null;
     }
   }
+  /**
+   * Set a getter function for lazy PowerSync adapter initialization.
+   *
+   * This allows the registry to lazily create the PowerSync adapter when
+   * PowerSync becomes available, rather than requiring it at initialization time.
+   * Solves race conditions where queries/mutations run before PowerSync is ready.
+   *
+   * @param getter - Function that returns the PowerSync database instance (or null if not ready)
+   * @param factory - Function that creates a TableDataAdapter from the database instance
+   */
+  setPowerSyncGetter(getter, factory) {
+    this.powerSyncGetter = getter;
+    this.powerSyncAdapterFactory = factory;
+  }
+  /**
+   * Ensure PowerSync adapter is initialized if available.
+   *
+   * Checks the getter (if set) and lazily creates the adapter if PowerSync
+   * is now available. Also updates the auto-detector with the new reference.
+   *
+   * @returns true if PowerSync adapter is available, false otherwise
+   */
+  ensurePowerSyncAdapter() {
+    if (this.powerSyncAdapter) {
+      return true;
+    }
+    if (!this.powerSyncGetter || !this.powerSyncAdapterFactory) {
+      return false;
+    }
+    const db = this.powerSyncGetter();
+    if (!db) {
+      return false;
+    }
+    const adapter = this.powerSyncAdapterFactory(db);
+    this.setPowerSyncAdapter(adapter);
+    if (this.autoDetector) {
+      this.autoDetector.setPowerSyncDb(db);
+    }
+    return true;
+  }
   /**
    * Set the sync tracker for mutation tracking.
    * When set, write operations on PowerSync tables will
@@ -4752,7 +4814,8 @@ var AdapterRegistry = class {
    * @returns The appropriate adapter for the table
    * @throws Error if adapters are not initialized
    */
-  getAdapter(table, operation = "read") {
+  getAdapter(table, _operation = "read") {
+    this.ensurePowerSyncAdapter();
     const tableWithoutSchema = table.includes(".") ? table.split(".")[1] : table;
     const strategy = this.config.tables[table] ?? this.config.tables[tableWithoutSchema];
     if (!strategy || strategy.strategy === "auto") {
@@ -4766,23 +4829,14 @@ var AdapterRegistry = class {
           throw new Error(`Table "${table}" is not configured for PowerSync sync and Supabase adapter is not available. Either add this table to the PowerSync schema or initialize the Supabase adapter.`);
         }
       }
-      if (operation === "write") {
-        if (this.powerSyncAdapter) {
-          return this.syncTrackingAdapter ?? this.powerSyncAdapter;
-        }
-        throw new Error(`PowerSync adapter not initialized for write operation on table "${table}". Writes to auto-strategy tables require PowerSync to be available for offline queue support.`);
-      }
-      return this.getAutoAdapter(strategy);
+      return this.getAutoAdapter(strategy, table);
     }
     if (strategy.strategy === "powersync" && this.autoDetector && this.supabaseAdapter) {
-      if (operation === "write") {
-        if (this.powerSyncAdapter) {
-          return this.syncTrackingAdapter ?? this.powerSyncAdapter;
-        }
-        throw new Error(`PowerSync adapter not initialized for write operation on table "${table}". Writes to PowerSync tables require PowerSync to be available.`);
-      }
       const detection = this.autoDetector.detectSilent();
       if (detection.powerSyncStatus === "initializing" /* INITIALIZING */ && detection.isOnline) {
+        if (typeof __DEV__ !== "undefined" && __DEV__) {
+          console.warn(`[AdapterRegistry] Table "${table}" configured for PowerSync but using Supabase. PowerSync status: ${detection.powerSyncStatus}, Online: ${detection.isOnline}`);
+        }
         return this.supabaseAdapter;
       }
     }
@@ -4884,11 +4938,14 @@ var AdapterRegistry = class {
    * @param strategy - Optional auto strategy configuration
    * @returns The automatically selected adapter
    */
-  getAutoAdapter(_strategy) {
+  getAutoAdapter(_strategy, table) {
     if (!this.autoDetector) {
       if (!this.supabaseAdapter) {
         throw new Error("No auto-detector configured and Supabase adapter not available. Either initialize auto-detection or set adapters explicitly.");
       }
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.warn(`[AdapterRegistry] No auto-detector configured${table ? ` for table "${table}"` : ""}. Using Supabase fallback.`);
+      }
       return this.supabaseAdapter;
     }
     const detection = this.autoDetector.detectSilent();
@@ -4898,6 +4955,9 @@ var AdapterRegistry = class {
         if (!this.supabaseAdapter) {
           throw new Error("Neither PowerSync nor Supabase adapters are available.");
         }
+        if (typeof __DEV__ !== "undefined" && __DEV__) {
+          console.warn(`[AdapterRegistry] PowerSync recommended${table ? ` for table "${table}"` : ""} but adapter not available. Falling back to Supabase. Reason: ${detection.reason}`);
+        }
         return this.supabaseAdapter;
       }
       return this.powerSyncAdapter;
@@ -7936,4 +7996,4 @@ moment/moment.js:
   (*! license : MIT *)
   (*! momentjs.com *)
 */
-//# sourceMappingURL=chunk-GEU5ED7L.js.map
+//# sourceMappingURL=chunk-7CLN4ORU.js.map