@pol-studios/powersync 1.0.7 → 1.0.10

package/dist/storage/index.native.js

@@ -1,26 +1,40 @@
 import {
   SupabaseUploadHandler,
   createSupabaseUploadHandler
-} from "../chunk-DHYUBVP7.js";
+} from "../chunk-CAB26E6F.js";
 import {
   CacheSettingsManager,
   DEFAULT_CACHE_SETTINGS,
+  createSupabaseStorage,
+  isBlobResult,
+  isFileResult
+} from "../chunk-XOY2CJ67.js";
+import {
   SupabaseStorageAdapter,
-  createSupabaseStorageAdapter
-} from "../chunk-WQ5MPAVC.js";
+  createSupabaseStorageAdapter,
+  getStorageErrorMessage,
+  isStorageAuthError,
+  normalizeStoragePath
+} from "../chunk-XAEII4ZX.js";
 import {
   DEFAULT_UPLOAD_NOTIFICATION,
-  resolveBucketFromConfig
-} from "../chunk-MKD2VCX3.js";
-import "../chunk-DGUM43GV.js";
+  resolveBucket
+} from "../chunk-Z6VOBGTU.js";
+import "../chunk-FV2HXEIY.js";
 export {
   CacheSettingsManager,
   DEFAULT_CACHE_SETTINGS,
   DEFAULT_UPLOAD_NOTIFICATION,
   SupabaseStorageAdapter,
   SupabaseUploadHandler,
+  createSupabaseStorage,
   createSupabaseStorageAdapter,
   createSupabaseUploadHandler,
-  resolveBucketFromConfig
+  getStorageErrorMessage,
+  isBlobResult,
+  isFileResult,
+  isStorageAuthError,
+  normalizeStoragePath,
+  resolveBucket
 };
 //# sourceMappingURL=index.native.js.map

package/dist/storage/index.web.d.ts

@@ -1,6 +1,6 @@
-export { A as AttachmentUploadHandler, a as BucketConfig, B as BucketResolver, D as DownloadResult, P as PowerSyncStorageAdapter, R as RemoteStorageAdapter, S as StorageUploadHandler, b as SupabaseStorageAdapterOptions, U as UploadOptions, r as resolveBucketFromConfig } from '../types-Bgvx7-E8.js';
-export { a as CacheSettings, C as CacheSettingsManager, b as CacheSettingsManagerOptions, D as DEFAULT_CACHE_SETTINGS, S as SupabaseStorageAdapter, c as createSupabaseStorageAdapter } from '../CacheSettingsManager-1exbOC6S.js';
-export { D as DEFAULT_UPLOAD_NOTIFICATION, S as SupabaseUploadHandlerOptions, U as UploadEventHandlers, a as UploadNotificationConfig } from '../types-BVacP54t.js';
+export { D as DownloadResult, a as StorageBackend, b as StorageUploadOptions, d as SupabaseClient, S as SupabaseStorage, c as SupabaseStorageOptions, U as UploadProgress, r as resolveBucket } from '../types-D0WcHrq6.js';
+export { f as CacheSettings, C as CacheSettingsManager, h as CacheSettingsManagerOptions, D as DEFAULT_CACHE_SETTINGS, S as SupabaseStorageAdapter, c as createSupabaseStorage, d as createSupabaseStorageAdapter, g as getStorageErrorMessage, a as isBlobResult, i as isFileResult, b as isStorageAuthError, n as normalizeStoragePath } from '../CacheSettingsManager-uz-kbnRH.js';
+export { D as DEFAULT_UPLOAD_NOTIFICATION, S as SupabaseUploadHandlerOptions, U as UploadEventHandlers, a as UploadNotificationConfig } from '../types-CyvBaAl8.js';
 export { SupabaseUploadHandler, createSupabaseUploadHandler } from './upload/index.js';
 import '../platform/index.js';
 import '../types-CDqWh56B.js';

package/dist/storage/index.web.js

@@ -1,26 +1,40 @@
 import {
   CacheSettingsManager,
   DEFAULT_CACHE_SETTINGS,
+  createSupabaseStorage,
+  isBlobResult,
+  isFileResult
+} from "../chunk-XOY2CJ67.js";
+import {
   SupabaseStorageAdapter,
-  createSupabaseStorageAdapter
-} from "../chunk-WQ5MPAVC.js";
+  createSupabaseStorageAdapter,
+  getStorageErrorMessage,
+  isStorageAuthError,
+  normalizeStoragePath
+} from "../chunk-XAEII4ZX.js";
 import {
   SupabaseUploadHandler,
   createSupabaseUploadHandler
-} from "../chunk-UEYRTLKE.js";
+} from "../chunk-P4HZA6ZT.js";
 import {
   DEFAULT_UPLOAD_NOTIFICATION,
-  resolveBucketFromConfig
-} from "../chunk-MKD2VCX3.js";
-import "../chunk-DGUM43GV.js";
+  resolveBucket
+} from "../chunk-Z6VOBGTU.js";
+import "../chunk-FV2HXEIY.js";
 export {
   CacheSettingsManager,
   DEFAULT_CACHE_SETTINGS,
   DEFAULT_UPLOAD_NOTIFICATION,
   SupabaseStorageAdapter,
   SupabaseUploadHandler,
+  createSupabaseStorage,
   createSupabaseStorageAdapter,
   createSupabaseUploadHandler,
-  resolveBucketFromConfig
+  getStorageErrorMessage,
+  isBlobResult,
+  isFileResult,
+  isStorageAuthError,
+  normalizeStoragePath,
+  resolveBucket
 };
 //# sourceMappingURL=index.web.js.map

package/dist/storage/upload/index.d.ts

@@ -1,8 +1,5 @@
-import { S as SupabaseUploadHandlerOptions } from '../../types-BVacP54t.js';
-export { D as DEFAULT_UPLOAD_NOTIFICATION, U as UploadEventHandlers, a as UploadNotificationConfig } from '../../types-BVacP54t.js';
-import { S as StorageUploadHandler, a as BucketConfig } from '../../types-Bgvx7-E8.js';
-import '../../platform/index.js';
-import '../../types-CDqWh56B.js';
+import { S as SupabaseUploadHandlerOptions, B as BucketConfig } from '../../types-CyvBaAl8.js';
+export { D as DEFAULT_UPLOAD_NOTIFICATION, U as UploadEventHandlers, a as UploadNotificationConfig } from '../../types-CyvBaAl8.js';
 
 /**
  * Supabase Upload Handler for Web
@@ -33,9 +30,11 @@ import '../../types-CDqWh56B.js';
  * );
  * ```
  */
-declare class SupabaseUploadHandler implements StorageUploadHandler {
+declare class SupabaseUploadHandler {
     private supabase;
-    private bucketConfig;
+    private defaultBucket;
+    private bucketMap?;
+    private bucketResolver?;
     constructor(options: SupabaseUploadHandlerOptions);
     /**
      * Upload a file to Supabase Storage using fetch.
@@ -52,4 +51,4 @@ declare class SupabaseUploadHandler implements StorageUploadHandler {
  */
 declare function createSupabaseUploadHandler(supabaseClient: any, bucketConfig: BucketConfig): SupabaseUploadHandler;
 
-export { SupabaseUploadHandler, SupabaseUploadHandlerOptions, createSupabaseUploadHandler };
+export { BucketConfig, SupabaseUploadHandler, SupabaseUploadHandlerOptions, createSupabaseUploadHandler };

package/dist/storage/upload/index.js

@@ -2,11 +2,11 @@ import "../../chunk-TGBT5XBE.js";
 import {
   SupabaseUploadHandler,
   createSupabaseUploadHandler
-} from "../../chunk-UEYRTLKE.js";
+} from "../../chunk-P4HZA6ZT.js";
 import {
   DEFAULT_UPLOAD_NOTIFICATION
-} from "../../chunk-MKD2VCX3.js";
-import "../../chunk-DGUM43GV.js";
+} from "../../chunk-Z6VOBGTU.js";
+import "../../chunk-FV2HXEIY.js";
 export {
   DEFAULT_UPLOAD_NOTIFICATION,
   SupabaseUploadHandler,

package/dist/storage/upload/index.native.d.ts

@@ -1,8 +1,5 @@
-import { S as SupabaseUploadHandlerOptions, a as UploadNotificationConfig } from '../../types-BVacP54t.js';
-export { D as DEFAULT_UPLOAD_NOTIFICATION, U as UploadEventHandlers } from '../../types-BVacP54t.js';
-import { S as StorageUploadHandler, a as BucketConfig } from '../../types-Bgvx7-E8.js';
-import '../../platform/index.js';
-import '../../types-CDqWh56B.js';
+import { S as SupabaseUploadHandlerOptions, a as UploadNotificationConfig, B as BucketConfig } from '../../types-CyvBaAl8.js';
+export { D as DEFAULT_UPLOAD_NOTIFICATION, U as UploadEventHandlers } from '../../types-CyvBaAl8.js';
 
 /**
  * Supabase Upload Handler for React Native
@@ -34,9 +31,11 @@ import '../../types-CDqWh56B.js';
  * );
  * ```
  */
-declare class SupabaseUploadHandler implements StorageUploadHandler {
+declare class SupabaseUploadHandler {
     private supabase;
-    private bucketConfig;
+    private defaultBucket;
+    private bucketMap?;
+    private bucketResolver?;
     private notificationConfig;
     constructor(options: SupabaseUploadHandlerOptions, notificationConfig?: Partial<UploadNotificationConfig>);
     /**
@@ -54,4 +53,4 @@ declare class SupabaseUploadHandler implements StorageUploadHandler {
  */
 declare function createSupabaseUploadHandler(supabaseClient: any, bucketConfig: BucketConfig, notificationConfig?: Partial<UploadNotificationConfig>): SupabaseUploadHandler;
 
-export { SupabaseUploadHandler, SupabaseUploadHandlerOptions, UploadNotificationConfig, createSupabaseUploadHandler };
+export { BucketConfig, SupabaseUploadHandler, SupabaseUploadHandlerOptions, UploadNotificationConfig, createSupabaseUploadHandler };

package/dist/storage/upload/index.native.js

@@ -1,11 +1,12 @@
+import "../../chunk-YHTZ7VMV.js";
 import {
   SupabaseUploadHandler,
   createSupabaseUploadHandler
-} from "../../chunk-DHYUBVP7.js";
+} from "../../chunk-CAB26E6F.js";
 import {
   DEFAULT_UPLOAD_NOTIFICATION
-} from "../../chunk-MKD2VCX3.js";
-import "../../chunk-DGUM43GV.js";
+} from "../../chunk-Z6VOBGTU.js";
+import "../../chunk-FV2HXEIY.js";
 export {
   DEFAULT_UPLOAD_NOTIFICATION,
   SupabaseUploadHandler,

package/dist/storage/upload/index.web.d.ts

@@ -1,5 +1,2 @@
-export { D as DEFAULT_UPLOAD_NOTIFICATION, S as SupabaseUploadHandlerOptions, U as UploadEventHandlers, a as UploadNotificationConfig } from '../../types-BVacP54t.js';
+export { B as BucketConfig, D as DEFAULT_UPLOAD_NOTIFICATION, S as SupabaseUploadHandlerOptions, U as UploadEventHandlers, a as UploadNotificationConfig } from '../../types-CyvBaAl8.js';
 export { SupabaseUploadHandler, createSupabaseUploadHandler } from './index.js';
-import '../../types-Bgvx7-E8.js';
-import '../../platform/index.js';
-import '../../types-CDqWh56B.js';

package/dist/storage/upload/index.web.js

@@ -1,11 +1,11 @@
 import {
   SupabaseUploadHandler,
   createSupabaseUploadHandler
-} from "../../chunk-UEYRTLKE.js";
+} from "../../chunk-P4HZA6ZT.js";
 import {
   DEFAULT_UPLOAD_NOTIFICATION
-} from "../../chunk-MKD2VCX3.js";
-import "../../chunk-DGUM43GV.js";
+} from "../../chunk-Z6VOBGTU.js";
+import "../../chunk-FV2HXEIY.js";
 export {
   DEFAULT_UPLOAD_NOTIFICATION,
   SupabaseUploadHandler,

package/dist/supabase-connector-T9vHq_3i.d.ts

@@ -0,0 +1,202 @@
+import { P as PowerSyncBackendConnector, A as AbstractPowerSyncDatabase } from './types-CDqWh56B.js';
+import { S as SupabaseConnectorOptions, P as PowerSyncCredentials } from './types-B212hgfA.js';
+
+/**
+ * Supabase Connector for PowerSync
+ *
+ * A generic, configurable connector that handles:
+ * - Authentication with Supabase JWT tokens
+ * - Uploading local changes back to Supabase
+ * - Schema routing for multi-schema databases
+ * - Custom CRUD handling for complex operations
+ * - Version-based conflict detection (when enabled)
+ */
+
+/**
+ * Generic Supabase connector for PowerSync.
+ *
+ * This connector handles authentication and CRUD uploads to Supabase.
+ * It supports configurable schema routing and custom CRUD handlers
+ * for complex use cases.
+ *
+ * @example Basic usage
+ * ```typescript
+ * const connector = new SupabaseConnector({
+ *   supabaseClient: supabase,
+ *   powerSyncUrl: 'https://your-powersync-instance.com',
+ * });
+ * ```
+ *
+ * @example With schema routing
+ * ```typescript
+ * const connector = new SupabaseConnector({
+ *   supabaseClient: supabase,
+ *   powerSyncUrl: 'https://your-powersync-instance.com',
+ *   schemaRouter: (table) => {
+ *     if (['Profile', 'Comment', 'CommentSection'].includes(table)) {
+ *       return 'core';
+ *     }
+ *     return 'public';
+ *   },
+ * });
+ * ```
+ *
+ * @example With custom CRUD handler
+ * ```typescript
+ * const connector = new SupabaseConnector({
+ *   supabaseClient: supabase,
+ *   powerSyncUrl: 'https://your-powersync-instance.com',
+ *   crudHandler: {
+ *     async handlePut(entry, supabase, schema) {
+ *       // Custom handling for specific tables
+ *       if (entry.table === 'SpecialTable') {
+ *         await myCustomUpsert(entry);
+ *         return true; // Handled
+ *       }
+ *       return false; // Use default
+ *     },
+ *   },
+ * });
+ * ```
+ */
+declare class SupabaseConnector implements PowerSyncBackendConnector {
+    private readonly supabase;
+    private readonly powerSyncUrl;
+    private readonly schemaRouter;
+    private readonly crudHandler?;
+    private readonly logger?;
+    private readonly onTransactionSuccess?;
+    private readonly onTransactionFailure?;
+    private readonly onTransactionComplete?;
+    private readonly shouldUploadFn?;
+    private readonly conflictDetection?;
+    private readonly conflictHandler?;
+    private readonly conflictBus?;
+    private versionColumnCache;
+    private activeProjectIds;
+    private resolvedConflicts;
+    private unsubscribeResolution?;
+    private versionColumnPromises;
+    private isDestroyed;
+    private retryConfig;
+    private completionFailures;
+    private static readonly COMPLETION_MAX_FAILURES;
+    private static readonly COMPLETION_EXTENDED_TIMEOUT_MS;
+    private autoRetryPaused;
+    private entryCooldowns;
+    private static readonly COOLDOWN_DURATION_MS;
+    constructor(options: SupabaseConnectorOptions);
+    /**
+     * Clean up resources (unsubscribe from event listeners).
+     * Call this when the connector is no longer needed.
+     */
+    destroy(): void;
+    /**
+     * Generate a fingerprint for a set of entries to track completion failures.
+     * Uses sorted entry IDs to create a consistent fingerprint regardless of order.
+     */
+    private generateTransactionFingerprint;
+    /**
+     * Pause automatic retry of failed uploads.
+     * Use this when the user goes offline intentionally or wants manual control.
+     */
+    pauseAutoRetry(): void;
+    /**
+     * Resume automatic retry of failed uploads.
+     */
+    resumeAutoRetry(): void;
+    /**
+     * Process a single CRUD entry with exponential backoff retry.
+     *
+     * This method uses a two-phase approach:
+     * 1. First attempt - try the operation to classify the error type
+     * 2. Retry phase - use the appropriate config (transient vs permanent) based on classification
+     *
+     * This fixes the issue where reassigning selectedConfig inside withExponentialBackoff's
+     * callback had no effect because the config was already destructured at call time.
+     *
+     * @param entry - The CRUD entry to process
+     * @throws Error if all retries exhausted (for critical failures)
+     */
+    private processWithRetry;
+    /**
+     * Set the active project IDs for scoped sync.
+     * Call this when user selects/opens projects.
+     */
+    setActiveProjectIds(projectIds: string[]): void;
+    /**
+     * Get the current active project IDs.
+     */
+    getActiveProjectIds(): string[];
+    /**
+     * Get credentials for PowerSync connection.
+     * Uses Supabase session token.
+     *
+     * Note: Token refresh is handled by Supabase's startAutoRefresh() which must be
+     * called on app initialization. getSession() returns the auto-refreshed token.
+     */
+    fetchCredentials(): Promise<PowerSyncCredentials>;
+    /**
+     * Upload local changes to Supabase.
+     * Called automatically by PowerSync when there are pending uploads.
+     *
+     * When conflict detection is enabled:
+     * 1. Checks if table has _version column (cached)
+     * 2. If yes, compares local vs server version
+     * 3. On version mismatch, queries AuditLog for field conflicts
+     * 4. If conflicts found, calls handler or publishes to conflict bus
+     * 5. Applies resolution or skips entry based on handler response
+     */
+    uploadData(database: AbstractPowerSyncDatabase): Promise<void>;
+    /**
+     * Finalize a transaction by completing it after all entries processed successfully.
+     * Extracted to eliminate duplication between uploadData and processTransaction.
+     *
+     * Implements circuit breaker logic for completion failures:
+     * - On first failure: retry once with extended timeout (60s)
+     * - After 3 failures for same entries: log and return without throwing
+     *   (data is safely in Supabase via idempotent upserts, preventing infinite retry loop)
+     *
+     * @param context - The finalization context containing results and transaction
+     */
+    private finalizeTransaction;
+    /**
+     * Process a transaction without conflict detection.
+     * Uses batched operations for PUT and DELETE, individual processing for PATCH.
+     */
+    private processTransaction;
+    /**
+     * Process batched PUT (upsert) operations for a single table.
+     * Falls back to individual processing if batch fails.
+     * CRITICAL: Throws on first failure to maintain transaction atomicity.
+     * @returns Array of successfully processed entries
+     * @throws Error on first failure - keeps entire transaction in ps_crud
+     */
+    private processBatchedPuts;
+    /**
+     * Process batched DELETE operations for a single table.
+     * Falls back to individual processing if batch fails.
+     * CRITICAL: Throws on first failure to maintain transaction atomicity.
+     * @returns Array of successfully processed entries
+     * @throws Error on first failure - keeps entire transaction in ps_crud
+     */
+    private processBatchedDeletes;
+    /**
+     * Check if a table has a _version column (cached).
+     * P4.1: Uses Promise-based locking to prevent duplicate concurrent queries.
+     */
+    private checkVersionColumn;
+    /**
+     * Filter opData to only include specified fields.
+     * Used for partial sync resolution.
+     */
+    private filterFields;
+    /**
+     * Process a single CRUD operation.
+     *
+     * All synced tables use `id` as their UUID primary key column.
+     */
+    private processCrudEntry;
+}
+
+export { SupabaseConnector as S };

package/dist/sync/index.js

@@ -12,10 +12,10 @@ import {
   HealthMonitor,
   MetricsCollector,
   SyncStatusTracker
-} from "../chunk-H772V6XQ.js";
+} from "../chunk-CUCAYK7Z.js";
+import "../chunk-24RDMMCL.js";
 import "../chunk-CGL33PL4.js";
-import "../chunk-XQAJM2MW.js";
-import "../chunk-DGUM43GV.js";
+import "../chunk-VACPAAQZ.js";
 export {
   DeadLetterQueue,
   HealthMonitor,