@pol-studios/powersync 1.0.3 → 1.0.6

package/dist/failed-upload-store-C0cLxxPz.d.ts

@@ -0,0 +1,33 @@
+interface FailedUpload {
+    id: string;
+    table: string;
+    operation: 'PUT' | 'PATCH' | 'DELETE';
+    data: Record<string, unknown>;
+    error: {
+        message: string;
+        code?: string;
+        category: 'transient' | 'permanent' | 'unknown';
+    };
+    retryCount: number;
+    lastAttempt: number;
+    nextRetryAt: number;
+}
+declare class FailedUploadStore {
+    private uploads;
+    private initialized;
+    private asyncStorageAvailable;
+    constructor();
+    private checkAsyncStorageAvailability;
+    private generateId;
+    add(upload: Omit<FailedUpload, 'id'>): string;
+    update(id: string, updates: Partial<FailedUpload>): void;
+    remove(id: string): void;
+    getAll(): FailedUpload[];
+    getRetryable(): FailedUpload[];
+    clear(): void;
+    load(): Promise<void>;
+    persist(): Promise<void>;
+}
+declare const failedUploadStore: FailedUploadStore;
+
+export { type FailedUpload as F, FailedUploadStore as a, failedUploadStore as f };

package/dist/{index-Cb-NI0Ct.d.ts → index-l3iL9Jte.d.ts}

@@ -1,6 +1,7 @@
 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';
+import { F as FailedUpload } from './failed-upload-store-C0cLxxPz.js';
 
 /**
  * Conflict Types for @pol-studios/powersync
@@ -161,6 +162,12 @@ 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>;
 }
 /**
  * Configuration passed to PowerSyncProvider for connector setup
@@ -192,6 +199,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 +260,32 @@ 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
+ */
+declare const DEFAULT_RETRY_CONFIG: RetryConfig;
 
 /**
  * Supabase Connector for PowerSync
@@ -323,12 +362,44 @@ declare class SupabaseConnector implements PowerSyncBackendConnector {
     private activeProjectIds;
     private resolvedConflicts;
     private unsubscribeResolution?;
+    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;
+    /**
+     * Manually retry all failed uploads that are ready for retry.
+     * This processes entries from the failed upload store.
+     */
+    retryFailedUploads(): Promise<void>;
+    /**
+     * Clear all failed uploads from the store.
+     * Use with caution - this discards all pending retries.
+     */
+    clearFailedUploads(): void;
+    /**
+     * Get all failed uploads from the store.
+     */
+    getFailedUploads(): FailedUpload[];
+    /**
+     * Process a single CRUD entry with exponential backoff retry.
+     *
+     * @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.
@@ -386,4 +457,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 ConnectorConfig 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 SchemaRouter as b, type CrudHandler as c, defaultSchemaRouter as d, type RetryConfig as e, ConflictBus as f, type ConflictCheckResult as g, type ConflictResolution as h, type ConflictHandler as i, type ConflictDetectionConfig as j, type ConflictListener as k, type ResolutionListener as l };

package/dist/index.d.ts

@@ -1,17 +1,155 @@
 import { A as AbstractPowerSyncDatabase } from './types-afHtE1U_.js';
 export { k as CacheStats, i as ClassifiedError, j as CompactResult, h as CompletedTransaction, b as ConnectionHealth, o as CountRow, C as CrudEntry, l as CrudTransaction, n as DbStatRow, D as DownloadProgress, E as EntitySyncState, F as FailedTransaction, r as FreelistCountRow, s as IntegrityCheckRow, I as IntegrityResult, q as PageCountRow, p as PageSizeRow, P as PowerSyncBackendConnector, m as SqliteTableRow, c as StorageInfo, d as StorageQuota, f as SyncError, g as SyncErrorType, e as SyncMetrics, S as SyncMode, a as SyncStatus, T as TableCacheStats } from './types-afHtE1U_.js';
 export { ATTACHMENT_DOWNLOAD_TIMEOUT_MS, ATTACHMENT_RETRY_DELAY_MS, AttachmentError, COMPRESSION_MAX_WIDTH, COMPRESSION_SKIP_SIZE_BYTES, COMPRESSION_TARGET_SIZE_BYTES, ConfigurationError, ConnectorError, DEFAULT_ATTACHMENT_CACHE_SIZE, DEFAULT_ATTACHMENT_CONCURRENCY, DEFAULT_COMPRESSION_QUALITY, DEFAULT_MAX_RETRY_ATTEMPTS, DEFAULT_RETRY_BACKOFF_MULTIPLIER, DEFAULT_RETRY_BASE_DELAY_MS, DEFAULT_RETRY_MAX_DELAY_MS, DEFAULT_SYNC_INTERVAL_MS, DEFAULT_SYNC_MODE, DOWNLOAD_STOP_THRESHOLD, EVICTION_TRIGGER_THRESHOLD, HEALTH_CHECK_INTERVAL_MS, HEALTH_CHECK_TIMEOUT_MS, InitializationError, LATENCY_DEGRADED_THRESHOLD_MS, MAX_CONSECUTIVE_FAILURES, PlatformAdapterError, PowerSyncError, STATS_CACHE_TTL_MS, STATUS_NOTIFY_THROTTLE_MS, STORAGE_CRITICAL_THRESHOLD, STORAGE_KEY_ATTACHMENT_SETTINGS, STORAGE_KEY_ENABLED, STORAGE_KEY_METRICS, STORAGE_KEY_PAUSED, STORAGE_KEY_PREFIX, STORAGE_KEY_SYNC_MODE, STORAGE_WARNING_THRESHOLD, SyncOperationError, classifyError, classifySupabaseError, createSyncError, extractEntityIds, extractTableNames, generateFailureId, toSyncOperationError } from './core/index.js';
-import { i as ConflictDetectionConfig, f as ConflictCheckResult } from './index-Cb-NI0Ct.js';
-export { e as ConflictBus, h as ConflictHandler, j as ConflictListener, g as ConflictResolution, C as ConnectorConfig, c as CrudHandler, F as FieldConflict, P as PowerSyncCredentials, R as ResolutionListener, b as SchemaRouter, S as SupabaseConnector, a as SupabaseConnectorOptions, d as defaultSchemaRouter } from './index-Cb-NI0Ct.js';
+import { j as ConflictDetectionConfig, g as ConflictCheckResult } from './index-l3iL9Jte.js';
+export { f as ConflictBus, i as ConflictHandler, k as ConflictListener, h as ConflictResolution, C as ConnectorConfig, c as CrudHandler, D as DEFAULT_RETRY_CONFIG, F as FieldConflict, P as PowerSyncCredentials, l as ResolutionListener, e as RetryConfig, R as RetryStrategyConfig, b as SchemaRouter, S as SupabaseConnector, a as SupabaseConnectorOptions, d as defaultSchemaRouter } from './index-l3iL9Jte.js';
 export { AttachmentQueue, AttachmentQueueConfig, AttachmentRecord, AttachmentSourceConfig, AttachmentState, AttachmentStatsRow, AttachmentStorageAdapter, AttachmentSyncStats, AttachmentSyncStatus, CacheConfig, CacheFileRow, CachedSizeRow, CompressionConfig, DEFAULT_CACHE_CONFIG, DEFAULT_COMPRESSION_CONFIG, DEFAULT_DOWNLOAD_CONFIG, DownloadConfig, DownloadPhase, DownloadStatus, EvictRow, IdRow } from './attachments/index.js';
 export { e as HealthCheckResult, H as HealthMonitorOptions, M as MetricsCollectorOptions, P as PowerSyncRawStatus, c as SyncControlActions, f as SyncEvent, g as SyncEventListener, d as SyncOperationData, S as SyncScope, a as SyncStatusState, b as SyncStatusTrackerOptions, U as Unsubscribe } from './types-Cd7RhNqf.js';
 export { HealthMonitor, MetricsCollector, SyncStatusTracker } from './sync/index.js';
+export { F as FailedUpload, a as FailedUploadStore, f as failedUploadStore } from './failed-upload-store-C0cLxxPz.js';
 import { SupabaseClient } from '@supabase/supabase-js';
-export { AttachmentQueueContext, ConnectionHealthContext, ConnectionHealthContextValue, DEFAULT_CONNECTION_HEALTH, DEFAULT_SYNC_CONFIG, DEFAULT_SYNC_METRICS, DEFAULT_SYNC_STATUS, EntitySyncStatusResult, PowerSyncConfig, PowerSyncContext, PowerSyncContextValue, PowerSyncProvider, PowerSyncProviderProps, SyncActivityResult, SyncConfig, SyncMetricsContext, SyncMetricsContextValue, SyncStatusContext, SyncStatusContextValue, UploadStatusResult, useAttachmentQueue, useConnectionHealth, useDatabase, useDownloadProgress, useEntitySyncStatus, useIsSyncing, useOnlineStatus, usePendingMutations, usePlatform, usePowerSync, useSyncActivity, useSyncControl, useSyncMetrics, useSyncMode, useSyncStatus, useUploadStatus } from './provider/index.js';
+export { AttachmentQueueContext, CompletedTransactionsContext, CompletedTransactionsContextValue, ConnectionHealthContext, ConnectionHealthContextValue, ConnectionStatusContext, ConnectionStatusContextValue, DEFAULT_CONNECTION_HEALTH, DEFAULT_SYNC_CONFIG, DEFAULT_SYNC_METRICS, DEFAULT_SYNC_STATUS, EntitySyncStatusResult, FailedTransactionsContext, FailedTransactionsContextValue, PendingMutationsContext, PendingMutationsContextValue, PowerSyncConfig, PowerSyncContext, PowerSyncContextValue, PowerSyncProvider, PowerSyncProviderProps, SyncActivityContext, SyncActivityContextValue, SyncActivityResult, SyncConfig, SyncMetricsContext, SyncMetricsContextValue, SyncModeContext, SyncModeContextValue, SyncStatusContext, SyncStatusContextValue, UploadStatusResult, useAttachmentQueue, useCompletedTransactionsContext, useConnectionHealth, useConnectionStatus, useDatabase, useDownloadProgress, useEntitySyncStatus, useFailedTransactionsContext, useIsSyncing, useOnlineStatus, usePendingMutations, usePendingMutationsContext, usePlatform, usePowerSync, useSyncActivity, useSyncActivityContext, useSyncControl, useSyncMetrics, useSyncMode, useSyncModeContext, useSyncStatus, useUploadStatus } from './provider/index.js';
 export { AsyncStorageAdapter, CompressedImage, CompressionOptions, ConnectionType, DatabaseOptions, FileInfo, FileSystemAdapter, ImageProcessorAdapter, LoggerAdapter, NetworkAdapter, PlatformAdapter, PlatformType, detectPlatform } from './platform/index.js';
 import '@tanstack/react-query';
 import 'react';
 
+/**
+ * Exponential backoff retry utilities for resilient network operations.
+ *
+ * Provides configurable retry logic with exponential backoff, jitter,
+ * and abort signal support for cancellation.
+ */
+/**
+ * Configuration for exponential backoff retry behavior.
+ */
+interface BackoffConfig {
+    /** Maximum number of retry attempts (0 = no retries, just one attempt) */
+    maxRetries: number;
+    /** Base delay in milliseconds before first retry */
+    baseDelayMs: number;
+    /** Maximum delay cap in milliseconds */
+    maxDelayMs: number;
+    /** Multiplier applied to delay for each subsequent retry (typically 2) */
+    backoffMultiplier: number;
+}
+/**
+ * Options for the withExponentialBackoff function.
+ */
+interface BackoffOptions {
+    /** Optional AbortSignal for cancellation support */
+    signal?: AbortSignal;
+    /** Callback invoked before each retry attempt */
+    onRetry?: (attempt: number, delay: number, error: Error) => void;
+}
+/**
+ * Error thrown when an operation is aborted via AbortSignal.
+ */
+declare class AbortError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when all retry attempts have been exhausted.
+ */
+declare class RetryExhaustedError extends Error {
+    /** The last error that caused the final retry to fail */
+    readonly cause: Error;
+    /** Total number of attempts made */
+    readonly attempts: number;
+    constructor(cause: Error, attempts: number);
+}
+/**
+ * Calculates the delay for a given retry attempt using exponential backoff.
+ *
+ * Formula: min(baseDelay * (multiplier ^ attempt), maxDelay)
+ *
+ * @param attempt - The current attempt number (0-indexed)
+ * @param config - Backoff configuration
+ * @returns Delay in milliseconds (without jitter)
+ *
+ * @example
+ * ```ts
+ * const config = { baseDelayMs: 1000, maxDelayMs: 30000, backoffMultiplier: 2 };
+ * calculateBackoffDelay(0, config); // 1000
+ * calculateBackoffDelay(1, config); // 2000
+ * calculateBackoffDelay(2, config); // 4000
+ * calculateBackoffDelay(5, config); // 30000 (capped at maxDelayMs)
+ * ```
+ */
+declare function calculateBackoffDelay(attempt: number, config: Pick<BackoffConfig, 'baseDelayMs' | 'maxDelayMs' | 'backoffMultiplier'>): number;
+/**
+ * Adds jitter (±10%) to a delay value to prevent thundering herd.
+ *
+ * @param delay - Base delay in milliseconds
+ * @returns Delay with random jitter applied
+ */
+declare function addJitter(delay: number): number;
+/**
+ * Sleep utility that respects AbortSignal for cancellation.
+ *
+ * @param ms - Duration to sleep in milliseconds
+ * @param signal - Optional AbortSignal for cancellation
+ * @returns Promise that resolves after the delay or rejects if aborted
+ * @throws {AbortError} If the signal is aborted during sleep
+ *
+ * @example
+ * ```ts
+ * const controller = new AbortController();
+ *
+ * // Sleep for 1 second
+ * await sleep(1000);
+ *
+ * // Sleep with cancellation support
+ * await sleep(1000, controller.signal);
+ *
+ * // Cancel the sleep
+ * controller.abort();
+ * ```
+ */
+declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+/**
+ * Default backoff configuration suitable for most network operations.
+ */
+declare const DEFAULT_BACKOFF_CONFIG: BackoffConfig;
+/**
+ * Executes a function with exponential backoff retry logic.
+ *
+ * Retries the provided function on failure using exponential backoff with jitter.
+ * Supports cancellation via AbortSignal and provides hooks for retry observation.
+ *
+ * @param fn - Async function to execute with retry logic
+ * @param config - Backoff configuration (maxRetries, delays, multiplier)
+ * @param options - Optional abort signal and retry callback
+ * @returns Promise resolving to the function result
+ * @throws {AbortError} If operation is aborted via signal
+ * @throws {RetryExhaustedError} If all retry attempts fail
+ *
+ * @example
+ * ```ts
+ * const controller = new AbortController();
+ *
+ * const result = await withExponentialBackoff(
+ *   async () => {
+ *     const response = await fetch('https://api.example.com/data');
+ *     if (!response.ok) throw new Error('Request failed');
+ *     return response.json();
+ *   },
+ *   {
+ *     maxRetries: 3,
+ *     baseDelayMs: 1000,
+ *     maxDelayMs: 30000,
+ *     backoffMultiplier: 2,
+ *   },
+ *   {
+ *     signal: controller.signal,
+ *     onRetry: (attempt, delay, error) => {
+ *       console.log(`Retry ${attempt} in ${delay}ms: ${error.message}`);
+ *     },
+ *   }
+ * );
+ * ```
+ */
+declare function withExponentialBackoff<T>(fn: () => Promise<T>, config: BackoffConfig, options?: BackoffOptions): Promise<T>;
+
 /**
  * Conflict Detection for @pol-studios/powersync
  *
@@ -64,4 +202,4 @@ declare function fetchServerVersion(table: string, recordId: string, schema: str
  */
 declare function getLocalVersion(table: string, recordId: string, db: AbstractPowerSyncDatabase): Promise<number | null>;
 
-export { AbstractPowerSyncDatabase, ConflictCheckResult, ConflictDetectionConfig, detectConflicts, fetchServerVersion, getLocalVersion, hasVersionColumn };
+export { AbortError, AbstractPowerSyncDatabase, type BackoffConfig, type BackoffOptions, ConflictCheckResult, ConflictDetectionConfig, DEFAULT_BACKOFF_CONFIG, RetryExhaustedError, addJitter, calculateBackoffDelay, detectConflicts, fetchServerVersion, getLocalVersion, hasVersionColumn, sleep, withExponentialBackoff };

package/dist/index.js

@@ -2,29 +2,41 @@ import "./chunk-OLHGI472.js";
 import "./chunk-32OLICZO.js";
 import {
   AttachmentQueueContext,
+  CompletedTransactionsContext,
   ConflictBus,
   ConnectionHealthContext,
+  ConnectionStatusContext,
+  FailedTransactionsContext,
+  PendingMutationsContext,
   PowerSyncContext,
   PowerSyncProvider,
+  SyncActivityContext,
   SyncMetricsContext,
+  SyncModeContext,
   SyncStatusContext,
   useAttachmentQueue,
+  useCompletedTransactionsContext,
   useConnectionHealth,
+  useConnectionStatus,
   useDatabase,
   useDownloadProgress,
   useEntitySyncStatus,
+  useFailedTransactionsContext,
   useIsSyncing,
   useOnlineStatus,
   usePendingMutations,
+  usePendingMutationsContext,
   usePlatform,
   usePowerSync,
   useSyncActivity,
+  useSyncActivityContext,
   useSyncControl,
   useSyncMetrics,
   useSyncMode,
+  useSyncModeContext,
   useSyncStatus,
   useUploadStatus
-} from "./chunk-GMFDCVMZ.js";
+} from "./chunk-KCDG2MNP.js";
 import {
   AttachmentQueue,
   AttachmentState,
@@ -32,7 +44,7 @@ import {
   DEFAULT_COMPRESSION_CONFIG,
   DEFAULT_DOWNLOAD_CONFIG
 } from "./chunk-V6LJ6MR2.js";
-import "./chunk-7JQZBZ5N.js";
+import "./chunk-5FIMA26D.js";
 import {
   DEFAULT_CONNECTION_HEALTH,
   DEFAULT_SYNC_CONFIG,
@@ -41,7 +53,7 @@ import {
   HealthMonitor,
   MetricsCollector,
   SyncStatusTracker
-} from "./chunk-OTJXIRWX.js";
+} from "./chunk-R4YFWQ3Q.js";
 import "./chunk-W7HSR35B.js";
 import {
   ATTACHMENT_DOWNLOAD_TIMEOUT_MS,
@@ -77,13 +89,25 @@ import {
 } from "./chunk-EJ23MXPQ.js";
 import "./chunk-VJCL2SWD.js";
 import {
+  AbortError,
+  DEFAULT_BACKOFF_CONFIG,
+  DEFAULT_RETRY_CONFIG,
+  RetryExhaustedError,
   SupabaseConnector,
+  addJitter,
+  calculateBackoffDelay,
   defaultSchemaRouter,
   detectConflicts,
   fetchServerVersion,
   getLocalVersion,
-  hasVersionColumn
-} from "./chunk-C2RSTGDC.js";
+  hasVersionColumn,
+  sleep,
+  withExponentialBackoff
+} from "./chunk-62J2DPKX.js";
+import {
+  FailedUploadStore,
+  failedUploadStore
+} from "./chunk-PAFBKNL3.js";
 import {
   AttachmentError,
   ConfigurationError,
@@ -103,6 +127,7 @@ import {
 export {
   ATTACHMENT_DOWNLOAD_TIMEOUT_MS,
   ATTACHMENT_RETRY_DELAY_MS,
+  AbortError,
   AttachmentError,
   AttachmentQueue,
   AttachmentQueueContext,
@@ -110,12 +135,15 @@ export {
   COMPRESSION_MAX_WIDTH,
   COMPRESSION_SKIP_SIZE_BYTES,
   COMPRESSION_TARGET_SIZE_BYTES,
+  CompletedTransactionsContext,
   ConfigurationError,
   ConflictBus,
   ConnectionHealthContext,
+  ConnectionStatusContext,
   ConnectorError,
   DEFAULT_ATTACHMENT_CACHE_SIZE,
   DEFAULT_ATTACHMENT_CONCURRENCY,
+  DEFAULT_BACKOFF_CONFIG,
   DEFAULT_CACHE_CONFIG,
   DEFAULT_COMPRESSION_CONFIG,
   DEFAULT_COMPRESSION_QUALITY,
@@ -124,6 +152,7 @@ export {
   DEFAULT_MAX_RETRY_ATTEMPTS,
   DEFAULT_RETRY_BACKOFF_MULTIPLIER,
   DEFAULT_RETRY_BASE_DELAY_MS,
+  DEFAULT_RETRY_CONFIG,
   DEFAULT_RETRY_MAX_DELAY_MS,
   DEFAULT_SYNC_CONFIG,
   DEFAULT_SYNC_INTERVAL_MS,
@@ -132,6 +161,8 @@ export {
   DEFAULT_SYNC_STATUS,
   DOWNLOAD_STOP_THRESHOLD,
   EVICTION_TRIGGER_THRESHOLD,
+  FailedTransactionsContext,
+  FailedUploadStore,
   HEALTH_CHECK_INTERVAL_MS,
   HEALTH_CHECK_TIMEOUT_MS,
   HealthMonitor,
@@ -139,10 +170,12 @@ export {
   LATENCY_DEGRADED_THRESHOLD_MS,
   MAX_CONSECUTIVE_FAILURES,
   MetricsCollector,
+  PendingMutationsContext,
   PlatformAdapterError,
   PowerSyncContext,
   PowerSyncError,
   PowerSyncProvider,
+  RetryExhaustedError,
   STATS_CACHE_TTL_MS,
   STATUS_NOTIFY_THROTTLE_MS,
   STORAGE_CRITICAL_THRESHOLD,
@@ -154,10 +187,14 @@ export {
   STORAGE_KEY_SYNC_MODE,
   STORAGE_WARNING_THRESHOLD,
   SupabaseConnector,
+  SyncActivityContext,
   SyncMetricsContext,
+  SyncModeContext,
   SyncOperationError,
   SyncStatusContext,
   SyncStatusTracker,
+  addJitter,
+  calculateBackoffDelay,
   classifyError,
   classifySupabaseError,
   createSyncError,
@@ -165,26 +202,35 @@ export {
   detectConflicts,
   extractEntityIds,
   extractTableNames,
+  failedUploadStore,
   fetchServerVersion,
   generateFailureId,
   getLocalVersion,
   hasVersionColumn,
+  sleep,
   toSyncOperationError,
   useAttachmentQueue,
+  useCompletedTransactionsContext,
   useConnectionHealth,
+  useConnectionStatus,
   useDatabase,
   useDownloadProgress,
   useEntitySyncStatus,
+  useFailedTransactionsContext,
   useIsSyncing,
   useOnlineStatus,
   usePendingMutations,
+  usePendingMutationsContext,
   usePlatform,
   usePowerSync,
   useSyncActivity,
+  useSyncActivityContext,
   useSyncControl,
   useSyncMetrics,
   useSyncMode,
+  useSyncModeContext,
   useSyncStatus,
-  useUploadStatus
+  useUploadStatus,
+  withExponentialBackoff
 };
 //# sourceMappingURL=index.js.map

package/dist/index.native.d.ts

@@ -1,11 +1,12 @@
 export { A as AbstractPowerSyncDatabase, k as CacheStats, i as ClassifiedError, j as CompactResult, h as CompletedTransaction, b as ConnectionHealth, o as CountRow, C as CrudEntry, l as CrudTransaction, n as DbStatRow, D as DownloadProgress, E as EntitySyncState, F as FailedTransaction, r as FreelistCountRow, s as IntegrityCheckRow, I as IntegrityResult, q as PageCountRow, p as PageSizeRow, P as PowerSyncBackendConnector, m as SqliteTableRow, c as StorageInfo, d as StorageQuota, f as SyncError, g as SyncErrorType, e as SyncMetrics, S as SyncMode, a as SyncStatus, T as TableCacheStats } from './types-afHtE1U_.js';
 export { ATTACHMENT_DOWNLOAD_TIMEOUT_MS, ATTACHMENT_RETRY_DELAY_MS, AttachmentError, COMPRESSION_MAX_WIDTH, COMPRESSION_SKIP_SIZE_BYTES, COMPRESSION_TARGET_SIZE_BYTES, ConfigurationError, ConnectorError, DEFAULT_ATTACHMENT_CACHE_SIZE, DEFAULT_ATTACHMENT_CONCURRENCY, DEFAULT_COMPRESSION_QUALITY, DEFAULT_MAX_RETRY_ATTEMPTS, DEFAULT_RETRY_BACKOFF_MULTIPLIER, DEFAULT_RETRY_BASE_DELAY_MS, DEFAULT_RETRY_MAX_DELAY_MS, DEFAULT_SYNC_INTERVAL_MS, DEFAULT_SYNC_MODE, DOWNLOAD_STOP_THRESHOLD, EVICTION_TRIGGER_THRESHOLD, HEALTH_CHECK_INTERVAL_MS, HEALTH_CHECK_TIMEOUT_MS, InitializationError, LATENCY_DEGRADED_THRESHOLD_MS, MAX_CONSECUTIVE_FAILURES, PlatformAdapterError, PowerSyncError, STATS_CACHE_TTL_MS, STATUS_NOTIFY_THROTTLE_MS, STORAGE_CRITICAL_THRESHOLD, STORAGE_KEY_ATTACHMENT_SETTINGS, STORAGE_KEY_ENABLED, STORAGE_KEY_METRICS, STORAGE_KEY_PAUSED, STORAGE_KEY_PREFIX, STORAGE_KEY_SYNC_MODE, STORAGE_WARNING_THRESHOLD, SyncOperationError, classifyError, classifySupabaseError, createSyncError, extractEntityIds, extractTableNames, generateFailureId, toSyncOperationError } from './core/index.js';
-export { e as ConflictBus, f as ConflictCheckResult, i as ConflictDetectionConfig, h as ConflictHandler, j as ConflictListener, g as ConflictResolution, C as ConnectorConfig, c as CrudHandler, F as FieldConflict, P as PowerSyncCredentials, R as ResolutionListener, b as SchemaRouter, S as SupabaseConnector, a as SupabaseConnectorOptions, d as defaultSchemaRouter } from './index-Cb-NI0Ct.js';
+export { f as ConflictBus, g as ConflictCheckResult, j as ConflictDetectionConfig, i as ConflictHandler, k as ConflictListener, h as ConflictResolution, C as ConnectorConfig, c as CrudHandler, D as DEFAULT_RETRY_CONFIG, F as FieldConflict, P as PowerSyncCredentials, l as ResolutionListener, e as RetryConfig, R as RetryStrategyConfig, b as SchemaRouter, S as SupabaseConnector, a as SupabaseConnectorOptions, d as defaultSchemaRouter } from './index-l3iL9Jte.js';
 export { AttachmentQueue, AttachmentQueueConfig, AttachmentRecord, AttachmentSourceConfig, AttachmentState, AttachmentStatsRow, AttachmentStorageAdapter, AttachmentSyncStats, AttachmentSyncStatus, CacheConfig, CacheFileRow, CachedSizeRow, CompressionConfig, DEFAULT_CACHE_CONFIG, DEFAULT_COMPRESSION_CONFIG, DEFAULT_DOWNLOAD_CONFIG, DownloadConfig, DownloadPhase, DownloadStatus, EvictRow, IdRow } from './attachments/index.js';
 export { e as HealthCheckResult, H as HealthMonitorOptions, M as MetricsCollectorOptions, P as PowerSyncRawStatus, c as SyncControlActions, f as SyncEvent, g as SyncEventListener, d as SyncOperationData, S as SyncScope, a as SyncStatusState, b as SyncStatusTrackerOptions, U as Unsubscribe } from './types-Cd7RhNqf.js';
 export { HealthMonitor, MetricsCollector, SyncStatusTracker } from './sync/index.js';
-export { detectConflicts, fetchServerVersion, getLocalVersion, hasVersionColumn } from './index.js';
-export { AttachmentQueueContext, ConnectionHealthContext, ConnectionHealthContextValue, DEFAULT_CONNECTION_HEALTH, DEFAULT_SYNC_CONFIG, DEFAULT_SYNC_METRICS, DEFAULT_SYNC_STATUS, EntitySyncStatusResult, PowerSyncConfig, PowerSyncContext, PowerSyncContextValue, PowerSyncProvider, PowerSyncProviderProps, SyncActivityResult, SyncConfig, SyncMetricsContext, SyncMetricsContextValue, SyncStatusContext, SyncStatusContextValue, UploadStatusResult, useAttachmentQueue, useConnectionHealth, useDatabase, useDownloadProgress, useEntitySyncStatus, useIsSyncing, useOnlineStatus, usePendingMutations, usePlatform, usePowerSync, useSyncActivity, useSyncControl, useSyncMetrics, useSyncMode, useSyncStatus, useUploadStatus } from './provider/index.js';
+export { F as FailedUpload, a as FailedUploadStore, f as failedUploadStore } from './failed-upload-store-C0cLxxPz.js';
+export { AbortError, BackoffConfig, BackoffOptions, DEFAULT_BACKOFF_CONFIG, RetryExhaustedError, addJitter, calculateBackoffDelay, detectConflicts, fetchServerVersion, getLocalVersion, hasVersionColumn, sleep, withExponentialBackoff } from './index.js';
+export { AttachmentQueueContext, CompletedTransactionsContext, CompletedTransactionsContextValue, ConnectionHealthContext, ConnectionHealthContextValue, ConnectionStatusContext, ConnectionStatusContextValue, DEFAULT_CONNECTION_HEALTH, DEFAULT_SYNC_CONFIG, DEFAULT_SYNC_METRICS, DEFAULT_SYNC_STATUS, EntitySyncStatusResult, FailedTransactionsContext, FailedTransactionsContextValue, PendingMutationsContext, PendingMutationsContextValue, PowerSyncConfig, PowerSyncContext, PowerSyncContextValue, PowerSyncProvider, PowerSyncProviderProps, SyncActivityContext, SyncActivityContextValue, SyncActivityResult, SyncConfig, SyncMetricsContext, SyncMetricsContextValue, SyncModeContext, SyncModeContextValue, SyncStatusContext, SyncStatusContextValue, UploadStatusResult, useAttachmentQueue, useCompletedTransactionsContext, useConnectionHealth, useConnectionStatus, useDatabase, useDownloadProgress, useEntitySyncStatus, useFailedTransactionsContext, useIsSyncing, useOnlineStatus, usePendingMutations, usePendingMutationsContext, usePlatform, usePowerSync, useSyncActivity, useSyncActivityContext, useSyncControl, useSyncMetrics, useSyncMode, useSyncModeContext, useSyncStatus, useUploadStatus } from './provider/index.js';
 export { AsyncStorageAdapter, CompressedImage, CompressionOptions, ConnectionType, DatabaseOptions, FileInfo, FileSystemAdapter, ImageProcessorAdapter, LoggerAdapter, NetworkAdapter, PlatformAdapter, PlatformType, detectPlatform } from './platform/index.js';
 export { createNativePlatformAdapter } from './platform/index.native.js';
 import '@supabase/supabase-js';