@pol-studios/powersync 1.0.4 → 1.0.7

package/dist/provider/index.js

@@ -1,62 +1,107 @@
+import {
+  OfflineDataProvider,
+  PowerSyncProvider,
+  ProviderBridge
+} from "../chunk-BREGB4WL.js";
+import "../chunk-P6WOZO7H.js";
+import "../chunk-ZEOKPWUC.js";
+import {
+  DEFAULT_CONNECTION_HEALTH,
+  DEFAULT_SYNC_CONFIG,
+  DEFAULT_SYNC_METRICS,
+  DEFAULT_SYNC_STATUS
+} from "../chunk-H772V6XQ.js";
 import {
   AttachmentQueueContext,
+  CompletedTransactionsContext,
   ConnectionHealthContext,
+  ConnectionStatusContext,
+  FailedTransactionsContext,
+  PendingMutationsContext,
   PowerSyncContext,
-  PowerSyncProvider,
+  SyncActivityContext,
   SyncMetricsContext,
+  SyncModeContext,
   SyncStatusContext,
   useAttachmentQueue,
+  useAttachmentQueueReady,
+  useCompletedTransactions,
+  useCompletedTransactionsContext,
   useConnectionHealth,
+  useConnectionStatus,
   useDatabase,
   useDownloadProgress,
   useEntitySyncStatus,
+  useFailedTransactions,
+  useFailedTransactionsContext,
   useIsSyncing,
   useOnlineStatus,
   usePendingMutations,
+  usePendingMutationsContext,
   usePlatform,
   usePowerSync,
   useSyncActivity,
+  useSyncActivityContext,
   useSyncControl,
   useSyncMetrics,
   useSyncMode,
+  useSyncModeContext,
   useSyncStatus,
   useUploadStatus
-} from "../chunk-GMFDCVMZ.js";
-import "../chunk-V6LJ6MR2.js";
-import {
-  DEFAULT_CONNECTION_HEALTH,
-  DEFAULT_SYNC_CONFIG,
-  DEFAULT_SYNC_METRICS,
-  DEFAULT_SYNC_STATUS
-} from "../chunk-OTJXIRWX.js";
-import "../chunk-EJ23MXPQ.js";
-import "../chunk-C2RSTGDC.js";
-import "../chunk-FPTDATY5.js";
+} from "../chunk-YSTEESEG.js";
+import "../chunk-LNL64IJZ.js";
+import "../chunk-WQ5MPAVC.js";
+import "../chunk-TGBT5XBE.js";
+import "../chunk-UEYRTLKE.js";
+import "../chunk-MKD2VCX3.js";
+import "../chunk-CGL33PL4.js";
+import "../chunk-53WH2JJV.js";
+import "../chunk-HFOFLW5F.js";
+import "../chunk-FV2HXEIY.js";
+import "../chunk-XQAJM2MW.js";
+import "../chunk-DGUM43GV.js";
 export {
   AttachmentQueueContext,
+  CompletedTransactionsContext,
   ConnectionHealthContext,
+  ConnectionStatusContext,
   DEFAULT_CONNECTION_HEALTH,
   DEFAULT_SYNC_CONFIG,
   DEFAULT_SYNC_METRICS,
   DEFAULT_SYNC_STATUS,
+  FailedTransactionsContext,
+  OfflineDataProvider,
+  PendingMutationsContext,
   PowerSyncContext,
   PowerSyncProvider,
+  ProviderBridge,
+  SyncActivityContext,
   SyncMetricsContext,
+  SyncModeContext,
   SyncStatusContext,
   useAttachmentQueue,
+  useAttachmentQueueReady,
+  useCompletedTransactions,
+  useCompletedTransactionsContext,
   useConnectionHealth,
+  useConnectionStatus,
   useDatabase,
   useDownloadProgress,
   useEntitySyncStatus,
+  useFailedTransactions,
+  useFailedTransactionsContext,
   useIsSyncing,
   useOnlineStatus,
   usePendingMutations,
+  usePendingMutationsContext,
   usePlatform,
   usePowerSync,
   useSyncActivity,
+  useSyncActivityContext,
   useSyncControl,
   useSyncMetrics,
   useSyncMode,
+  useSyncModeContext,
   useSyncStatus,
   useUploadStatus
 };

package/dist/storage/index.d.ts

@@ -0,0 +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 { SupabaseUploadHandler, createSupabaseUploadHandler } from './upload/index.js';
+import '../platform/index.js';
+import '../types-CDqWh56B.js';

package/dist/storage/index.js

@@ -0,0 +1,28 @@
+import "../chunk-LNL64IJZ.js";
+import {
+  CacheSettingsManager,
+  DEFAULT_CACHE_SETTINGS,
+  SupabaseStorageAdapter,
+  createSupabaseStorageAdapter
+} from "../chunk-WQ5MPAVC.js";
+import "../chunk-TGBT5XBE.js";
+import {
+  SupabaseUploadHandler,
+  createSupabaseUploadHandler
+} from "../chunk-UEYRTLKE.js";
+import {
+  DEFAULT_UPLOAD_NOTIFICATION,
+  resolveBucketFromConfig
+} from "../chunk-MKD2VCX3.js";
+import "../chunk-DGUM43GV.js";
+export {
+  CacheSettingsManager,
+  DEFAULT_CACHE_SETTINGS,
+  DEFAULT_UPLOAD_NOTIFICATION,
+  SupabaseStorageAdapter,
+  SupabaseUploadHandler,
+  createSupabaseStorageAdapter,
+  createSupabaseUploadHandler,
+  resolveBucketFromConfig
+};
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +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 { SupabaseUploadHandler, createSupabaseUploadHandler } from './upload/index.native.js';
+import '../platform/index.js';
+import '../types-CDqWh56B.js';

package/dist/storage/index.native.js

@@ -0,0 +1,26 @@
+import {
+  SupabaseUploadHandler,
+  createSupabaseUploadHandler
+} from "../chunk-DHYUBVP7.js";
+import {
+  CacheSettingsManager,
+  DEFAULT_CACHE_SETTINGS,
+  SupabaseStorageAdapter,
+  createSupabaseStorageAdapter
+} from "../chunk-WQ5MPAVC.js";
+import {
+  DEFAULT_UPLOAD_NOTIFICATION,
+  resolveBucketFromConfig
+} from "../chunk-MKD2VCX3.js";
+import "../chunk-DGUM43GV.js";
+export {
+  CacheSettingsManager,
+  DEFAULT_CACHE_SETTINGS,
+  DEFAULT_UPLOAD_NOTIFICATION,
+  SupabaseStorageAdapter,
+  SupabaseUploadHandler,
+  createSupabaseStorageAdapter,
+  createSupabaseUploadHandler,
+  resolveBucketFromConfig
+};
+//# sourceMappingURL=index.native.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +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 { SupabaseUploadHandler, createSupabaseUploadHandler } from './upload/index.js';
+import '../platform/index.js';
+import '../types-CDqWh56B.js';

package/dist/storage/index.web.js

@@ -0,0 +1,26 @@
+import {
+  CacheSettingsManager,
+  DEFAULT_CACHE_SETTINGS,
+  SupabaseStorageAdapter,
+  createSupabaseStorageAdapter
+} from "../chunk-WQ5MPAVC.js";
+import {
+  SupabaseUploadHandler,
+  createSupabaseUploadHandler
+} from "../chunk-UEYRTLKE.js";
+import {
+  DEFAULT_UPLOAD_NOTIFICATION,
+  resolveBucketFromConfig
+} from "../chunk-MKD2VCX3.js";
+import "../chunk-DGUM43GV.js";
+export {
+  CacheSettingsManager,
+  DEFAULT_CACHE_SETTINGS,
+  DEFAULT_UPLOAD_NOTIFICATION,
+  SupabaseStorageAdapter,
+  SupabaseUploadHandler,
+  createSupabaseStorageAdapter,
+  createSupabaseUploadHandler,
+  resolveBucketFromConfig
+};
+//# sourceMappingURL=index.web.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +1,55 @@
+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';
+
+/**
+ * Supabase Upload Handler for Web
+ *
+ * Implements UploadHandler interface using the fetch API
+ * for browser-based uploads.
+ */
+
+/**
+ * Web upload handler using the fetch API.
+ *
+ * Features:
+ * - Signed URL-based uploads
+ * - AbortSignal cancellation support
+ * - Blob/File upload support
+ *
+ * @example
+ * ```typescript
+ * const handler = createSupabaseUploadHandler(supabaseClient, {
+ *   defaultBucket: 'attachments',
+ *   bucketMap: new Map([['avatars/', 'user-avatars']]),
+ * });
+ *
+ * await handler.uploadFile(
+ *   'photos/image.jpg',
+ *   blobUrl,
+ *   'image/jpeg'
+ * );
+ * ```
+ */
+declare class SupabaseUploadHandler implements StorageUploadHandler {
+    private supabase;
+    private bucketConfig;
+    constructor(options: SupabaseUploadHandlerOptions);
+    /**
+     * Upload a file to Supabase Storage using fetch.
+     * Supports AbortSignal for cancellation.
+     */
+    uploadFile(storagePath: string, localFileUri: string, mediaType: string, signal?: AbortSignal): Promise<void>;
+    /**
+     * Resolve the storage bucket for a given path.
+     */
+    resolveBucket(storagePath: string): string;
+}
+/**
+ * Factory function for creating a SupabaseUploadHandler.
+ */
+declare function createSupabaseUploadHandler(supabaseClient: any, bucketConfig: BucketConfig): SupabaseUploadHandler;
+
+export { SupabaseUploadHandler, SupabaseUploadHandlerOptions, createSupabaseUploadHandler };

package/dist/storage/upload/index.js

@@ -0,0 +1,15 @@
+import "../../chunk-TGBT5XBE.js";
+import {
+  SupabaseUploadHandler,
+  createSupabaseUploadHandler
+} from "../../chunk-UEYRTLKE.js";
+import {
+  DEFAULT_UPLOAD_NOTIFICATION
+} from "../../chunk-MKD2VCX3.js";
+import "../../chunk-DGUM43GV.js";
+export {
+  DEFAULT_UPLOAD_NOTIFICATION,
+  SupabaseUploadHandler,
+  createSupabaseUploadHandler
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +1,57 @@
+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';
+
+/**
+ * Supabase Upload Handler for React Native
+ *
+ * Implements UploadHandler interface using react-native-background-upload
+ * for iOS background upload capability.
+ */
+
+/**
+ * React Native upload handler using react-native-background-upload.
+ *
+ * Features:
+ * - iOS background upload support
+ * - AbortSignal cancellation support
+ * - Android notification support
+ * - Signed URL-based uploads
+ *
+ * @example
+ * ```typescript
+ * const handler = createSupabaseUploadHandler(supabaseClient, {
+ *   defaultBucket: 'attachments',
+ *   bucketMap: new Map([['avatars/', 'user-avatars']]),
+ * });
+ *
+ * await handler.uploadFile(
+ *   'photos/image.jpg',
+ *   'file:///path/to/image.jpg',
+ *   'image/jpeg'
+ * );
+ * ```
+ */
+declare class SupabaseUploadHandler implements StorageUploadHandler {
+    private supabase;
+    private bucketConfig;
+    private notificationConfig;
+    constructor(options: SupabaseUploadHandlerOptions, notificationConfig?: Partial<UploadNotificationConfig>);
+    /**
+     * Upload a file to Supabase Storage using react-native-background-upload.
+     * Supports iOS background uploads and AbortSignal for cancellation.
+     */
+    uploadFile(storagePath: string, localFileUri: string, mediaType: string, signal?: AbortSignal): Promise<void>;
+    /**
+     * Resolve the storage bucket for a given path.
+     */
+    resolveBucket(storagePath: string): string;
+}
+/**
+ * Factory function for creating a SupabaseUploadHandler.
+ */
+declare function createSupabaseUploadHandler(supabaseClient: any, bucketConfig: BucketConfig, notificationConfig?: Partial<UploadNotificationConfig>): SupabaseUploadHandler;
+
+export { SupabaseUploadHandler, SupabaseUploadHandlerOptions, UploadNotificationConfig, createSupabaseUploadHandler };

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

@@ -0,0 +1,14 @@
+import {
+  SupabaseUploadHandler,
+  createSupabaseUploadHandler
+} from "../../chunk-DHYUBVP7.js";
+import {
+  DEFAULT_UPLOAD_NOTIFICATION
+} from "../../chunk-MKD2VCX3.js";
+import "../../chunk-DGUM43GV.js";
+export {
+  DEFAULT_UPLOAD_NOTIFICATION,
+  SupabaseUploadHandler,
+  createSupabaseUploadHandler
+};
+//# sourceMappingURL=index.native.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +1,5 @@
+export { D as DEFAULT_UPLOAD_NOTIFICATION, S as SupabaseUploadHandlerOptions, U as UploadEventHandlers, a as UploadNotificationConfig } from '../../types-BVacP54t.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

@@ -0,0 +1,14 @@
+import {
+  SupabaseUploadHandler,
+  createSupabaseUploadHandler
+} from "../../chunk-UEYRTLKE.js";
+import {
+  DEFAULT_UPLOAD_NOTIFICATION
+} from "../../chunk-MKD2VCX3.js";
+import "../../chunk-DGUM43GV.js";
+export {
+  DEFAULT_UPLOAD_NOTIFICATION,
+  SupabaseUploadHandler,
+  createSupabaseUploadHandler
+};
+//# sourceMappingURL=index.web.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{index-Cb-NI0Ct.d.ts → supabase-connector-qLm-WHkM.d.ts}

@@ -1,5 +1,5 @@
+import { C as CrudEntry, i as ClassifiedError, P as PowerSyncBackendConnector, A as AbstractPowerSyncDatabase } from './types-CDqWh56B.js';
 import { SupabaseClient } from '@supabase/supabase-js';
-import { C as CrudEntry, i as ClassifiedError, P as PowerSyncBackendConnector, A as AbstractPowerSyncDatabase } from './types-afHtE1U_.js';
 import { LoggerAdapter } from './platform/index.js';
 
 /**
@@ -85,10 +85,13 @@ type ResolutionListener = (table: string, recordId: string, resolution: Conflict
  * 4. Connector subscribes via bus.onResolution() -> triggers re-upload
  */
 declare class ConflictBus {
+    private static MAX_PENDING;
     private conflictListeners;
     private resolutionListeners;
+    private pendingConflicts;
     /**
      * Subscribe to conflict detection events.
+     * Flushes any pending conflicts to ALL listeners (including the new one).
      * @returns Unsubscribe function
      */
     onConflict(listener: ConflictListener): () => void;
@@ -99,6 +102,7 @@ declare class ConflictBus {
     onResolution(listener: ResolutionListener): () => void;
     /**
      * Emit a conflict detection event (called by connector).
+     * If no listeners are subscribed, queues the conflict for later delivery.
      */
     emitConflict(conflict: ConflictCheckResult): void;
     /**
@@ -106,9 +110,13 @@ declare class ConflictBus {
      */
     emitResolution(table: string, recordId: string, resolution: ConflictResolution): void;
     /**
-     * Clear all listeners (for cleanup).
+     * Clear all listeners and pending conflicts (for cleanup).
      */
     destroy(): void;
+    /**
+     * Get the number of pending conflicts (useful for debugging/testing).
+     */
+    get pendingCount(): number;
 }
 
 /**
@@ -117,6 +125,37 @@ declare class ConflictBus {
  * Defines interfaces for PowerSync backend connectors.
  */
 
+/**
+ * Circuit breaker configuration for the connector.
+ * Prevents cascading failures by stopping requests when service is down.
+ */
+interface ConnectorCircuitBreakerConfig {
+    /**
+     * Enable circuit breaker pattern.
+     * @default false
+     */
+    enabled: boolean;
+    /**
+     * Number of failures required to trip the circuit.
+     * @default 5
+     */
+    failureThreshold?: number;
+    /**
+     * Time window in ms for counting failures.
+     * @default 60000 (60 seconds)
+     */
+    failureWindowMs?: number;
+    /**
+     * Initial delay before transitioning from OPEN to HALF_OPEN.
+     * @default 1000 (1 second)
+     */
+    initialRecoveryDelayMs?: number;
+    /**
+     * Maximum delay for exponential backoff.
+     * @default 32000 (32 seconds)
+     */
+    maxRecoveryDelayMs?: number;
+}
 /**
  * Options for creating a SupabaseConnector
  */
@@ -161,6 +200,19 @@ interface SupabaseConnectorOptions {
      * Use this to notify the UI layer about detected conflicts.
      */
     conflictBus?: ConflictBus;
+    /**
+     * Optional: Configuration for retry behavior on upload failures.
+     * Allows customizing retry attempts, delays, and backoff for different error types.
+     * @default DEFAULT_RETRY_CONFIG
+     */
+    retryConfig?: Partial<RetryConfig>;
+    /**
+     * Optional: Configuration for circuit breaker pattern.
+     * When enabled, prevents cascading failures by stopping requests when
+     * the service is experiencing high failure rates.
+     * @default { enabled: false }
+     */
+    circuitBreaker?: ConnectorCircuitBreakerConfig;
 }
 /**
  * Configuration passed to PowerSyncProvider for connector setup
@@ -192,6 +244,12 @@ interface ConnectorConfig {
         /** Refresh token when it expires within this many seconds (default: 60) */
         refreshThresholdSeconds?: number;
     };
+    /**
+     * Optional retry configuration for upload failures.
+     * Allows customizing retry attempts, delays, and backoff for different error types.
+     * @default DEFAULT_RETRY_CONFIG
+     */
+    retryConfig?: Partial<RetryConfig>;
 }
 /**
  * Function that determines which Supabase schema a table belongs to.
@@ -247,6 +305,39 @@ interface PowerSyncCredentials {
     /** When the token expires */
     expiresAt?: Date;
 }
+/**
+ * Configuration for a single retry category
+ */
+interface RetryStrategyConfig {
+    /** Maximum number of retry attempts */
+    maxRetries: number;
+    /** Initial delay in milliseconds */
+    baseDelayMs: number;
+    /** Maximum delay cap in milliseconds */
+    maxDelayMs: number;
+    /** Multiplier for exponential backoff */
+    backoffMultiplier: number;
+}
+/**
+ * Full retry configuration for the connector
+ */
+interface RetryConfig {
+    /** Retry config for transient errors (network, server 5xx) */
+    transient: RetryStrategyConfig;
+    /** Retry config for permanent errors (RLS, validation, constraints) */
+    permanent: RetryStrategyConfig;
+}
+/**
+ * Default retry configuration
+ *
+ * Uses fast exponential backoff for transient errors (network issues):
+ * - Transient: 1s → 2s → 4s
+ *
+ * Permanent errors (RLS violations, constraint errors) get NO retries
+ * because they will never succeed - fail fast and surface to user.
+ * PowerSync's native retry mechanism will re-attempt on next sync cycle.
+ */
+declare const DEFAULT_RETRY_CONFIG: RetryConfig;
 
 /**
  * Supabase Connector for PowerSync
@@ -323,12 +414,39 @@ declare class SupabaseConnector implements PowerSyncBackendConnector {
     private activeProjectIds;
     private resolvedConflicts;
     private unsubscribeResolution?;
+    private versionColumnPromises;
+    private isDestroyed;
+    private retryConfig;
+    private autoRetryPaused;
     constructor(options: SupabaseConnectorOptions);
     /**
      * Clean up resources (unsubscribe from event listeners).
      * Call this when the connector is no longer needed.
      */
     destroy(): void;
+    /**
+     * 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.
@@ -358,13 +476,37 @@ declare class SupabaseConnector implements PowerSyncBackendConnector {
      * 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.
+     *
+     * @param context - The finalization context containing results and transaction
+     */
+    private finalizeTransaction;
     /**
      * Process a transaction without conflict detection.
-     * Used when conflict detection is disabled.
+     * 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;
     /**
@@ -372,12 +514,6 @@ declare class SupabaseConnector implements PowerSyncBackendConnector {
      * Used for partial sync resolution.
      */
     private filterFields;
-    /**
-     * Process a single CRUD operation.
-     *
-     * UUID-native tables (public schema, post-migration) use `id` as the UUID column.
-     * Core schema tables (Profile, Comment, CommentSection) still use a separate `uuid` column.
-     */
     /**
      * Process a single CRUD operation.
      *
@@ -386,4 +522,4 @@ declare class SupabaseConnector implements PowerSyncBackendConnector {
     private processCrudEntry;
 }
 
-export { type ConnectorConfig as C, type FieldConflict as F, type PowerSyncCredentials as P, type ResolutionListener as R, SupabaseConnector as S, type SupabaseConnectorOptions as a, type SchemaRouter as b, type CrudHandler as c, defaultSchemaRouter as d, ConflictBus as e, type ConflictCheckResult as f, type ConflictResolution as g, type ConflictHandler as h, type ConflictDetectionConfig as i, type ConflictListener as j };
+export { type ConnectorCircuitBreakerConfig as C, DEFAULT_RETRY_CONFIG as D, type FieldConflict as F, type PowerSyncCredentials as P, type RetryStrategyConfig as R, SupabaseConnector as S, type SupabaseConnectorOptions as a, type ConnectorConfig as b, type SchemaRouter as c, defaultSchemaRouter as d, type CrudHandler as e, type RetryConfig as f, ConflictBus as g, type ConflictCheckResult as h, type ConflictResolution as i, type ConflictHandler as j, type ConflictDetectionConfig as k, type ConflictListener as l, type ResolutionListener as m };