@pol-studios/powersync 1.0.30 → 1.0.32

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

@@ -1,5 +1,6 @@
-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';
+import { S as SupabaseUploadHandlerOptions, B as BucketConfig } from '../../types-6QHGELuY.js';
+export { D as DEFAULT_UPLOAD_NOTIFICATION, U as UploadEventHandlers, a as UploadNotificationConfig } from '../../types-6QHGELuY.js';
+import { SupabaseClient } from '@supabase/supabase-js';
 
 /**
  * Supabase Upload Handler for Web
@@ -49,6 +50,6 @@ declare class SupabaseUploadHandler {
 /**
  * Factory function for creating a SupabaseUploadHandler.
  */
-declare function createSupabaseUploadHandler(supabaseClient: any, bucketConfig: BucketConfig): SupabaseUploadHandler;
+declare function createSupabaseUploadHandler(supabaseClient: SupabaseClient, bucketConfig: BucketConfig): SupabaseUploadHandler;
 
 export { BucketConfig, SupabaseUploadHandler, SupabaseUploadHandlerOptions, createSupabaseUploadHandler };

package/dist/storage/upload/index.js

@@ -2,11 +2,13 @@ import "../../chunk-TGBT5XBE.js";
 import {
   SupabaseUploadHandler,
   createSupabaseUploadHandler
-} from "../../chunk-P4HZA6ZT.js";
+} from "../../chunk-4665ZSE5.js";
 import {
   DEFAULT_UPLOAD_NOTIFICATION
-} from "../../chunk-Z6VOBGTU.js";
+} from "../../chunk-ZAN22NGL.js";
+import "../../chunk-UOMHWUHV.js";
 import "../../chunk-FV2HXEIY.js";
+import "../../chunk-5WRI5ZAA.js";
 export {
   DEFAULT_UPLOAD_NOTIFICATION,
   SupabaseUploadHandler,

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

@@ -1,5 +1,6 @@
-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';
+import { S as SupabaseUploadHandlerOptions, a as UploadNotificationConfig, B as BucketConfig } from '../../types-6QHGELuY.js';
+export { D as DEFAULT_UPLOAD_NOTIFICATION, U as UploadEventHandlers } from '../../types-6QHGELuY.js';
+import { SupabaseClient } from '@supabase/supabase-js';
 
 /**
  * Supabase Upload Handler for React Native
@@ -51,6 +52,6 @@ declare class SupabaseUploadHandler {
 /**
  * Factory function for creating a SupabaseUploadHandler.
  */
-declare function createSupabaseUploadHandler(supabaseClient: any, bucketConfig: BucketConfig, notificationConfig?: Partial<UploadNotificationConfig>): SupabaseUploadHandler;
+declare function createSupabaseUploadHandler(supabaseClient: SupabaseClient, bucketConfig: BucketConfig, notificationConfig?: Partial<UploadNotificationConfig>): SupabaseUploadHandler;
 
 export { BucketConfig, SupabaseUploadHandler, SupabaseUploadHandlerOptions, UploadNotificationConfig, createSupabaseUploadHandler };

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

@@ -2,11 +2,13 @@ import "../../chunk-YHTZ7VMV.js";
 import {
   SupabaseUploadHandler,
   createSupabaseUploadHandler
-} from "../../chunk-CAB26E6F.js";
+} from "../../chunk-C4J4MLER.js";
 import {
   DEFAULT_UPLOAD_NOTIFICATION
-} from "../../chunk-Z6VOBGTU.js";
+} from "../../chunk-ZAN22NGL.js";
+import "../../chunk-UOMHWUHV.js";
 import "../../chunk-FV2HXEIY.js";
+import "../../chunk-5WRI5ZAA.js";
 export {
   DEFAULT_UPLOAD_NOTIFICATION,
   SupabaseUploadHandler,

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

@@ -1,2 +1,3 @@
-export { B as BucketConfig, D as DEFAULT_UPLOAD_NOTIFICATION, S as SupabaseUploadHandlerOptions, U as UploadEventHandlers, a as UploadNotificationConfig } from '../../types-CyvBaAl8.js';
+export { B as BucketConfig, D as DEFAULT_UPLOAD_NOTIFICATION, S as SupabaseUploadHandlerOptions, U as UploadEventHandlers, a as UploadNotificationConfig } from '../../types-6QHGELuY.js';
 export { SupabaseUploadHandler, createSupabaseUploadHandler } from './index.js';
+import '@supabase/supabase-js';

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

@@ -1,11 +1,13 @@
 import {
   SupabaseUploadHandler,
   createSupabaseUploadHandler
-} from "../../chunk-P4HZA6ZT.js";
+} from "../../chunk-4665ZSE5.js";
 import {
   DEFAULT_UPLOAD_NOTIFICATION
-} from "../../chunk-Z6VOBGTU.js";
+} from "../../chunk-ZAN22NGL.js";
+import "../../chunk-UOMHWUHV.js";
 import "../../chunk-FV2HXEIY.js";
+import "../../chunk-5WRI5ZAA.js";
 export {
   DEFAULT_UPLOAD_NOTIFICATION,
   SupabaseUploadHandler,

package/dist/{supabase-connector-C4YpH_l3.d.ts → supabase-connector-HMxBA9Kg.d.ts}

@@ -1,5 +1,5 @@
-import { P as PowerSyncBackendConnector, A as AbstractPowerSyncDatabase } from './types-Dv1uf0LZ.js';
-import { S as SupabaseConnectorOptions, P as PowerSyncCredentials } from './types-CpM2_LhU.js';
+import { P as PowerSyncBackendConnector, A as AbstractPowerSyncDatabase } from './types-B9MptP7E.js';
+import { S as SupabaseConnectorOptions, P as PowerSyncCredentials } from './types-DqJnP50o.js';
 
 /**
  * Supabase Connector for PowerSync

package/dist/sync/index.d.ts

@@ -1,13 +1,18 @@
-import { b as SyncStatusTrackerOptions, P as PowerSyncRawStatus, U as Unsubscribe, M as MetricsCollectorOptions, d as SyncOperationData, H as HealthMonitorOptions, e as HealthCheckResult } from '../background-sync-CVR3PkFi.js';
-export { B as BackgroundSyncOptions, h as BackgroundSyncSystem, c as SyncControlActions, f as SyncEvent, g as SyncEventListener, S as SyncScope, a as SyncStatusState, i as defineBackgroundSyncTask, j as initializeBackgroundSync, k as isBackgroundSyncRegistered, r as registerBackgroundSync, u as unregisterBackgroundSync } from '../background-sync-CVR3PkFi.js';
-import { a as SyncStatus, S as SyncMode, U as UploadBlockReason, C as CrudEntry, f as SyncError, F as FailedTransaction, h as CompletedTransaction, e as SyncMetrics, A as AbstractPowerSyncDatabase, b as ConnectionHealth } from '../types-Dv1uf0LZ.js';
+import { b as SyncStatusTrackerOptions, P as PowerSyncRawStatus, U as Unsubscribe, M as MetricsCollectorOptions, d as SyncOperationData, H as HealthMonitorOptions, e as HealthCheckResult } from '../background-sync-BujnI3IR.js';
+export { B as BackgroundSyncOptions, h as BackgroundSyncSystem, c as SyncControlActions, f as SyncEvent, g as SyncEventListener, S as SyncScope, a as SyncStatusState, i as defineBackgroundSyncTask, j as initializeBackgroundSync, k as isBackgroundSyncRegistered, r as registerBackgroundSync, u as unregisterBackgroundSync } from '../background-sync-BujnI3IR.js';
+import { A as AbstractPowerSyncDatabase, a as SyncStatus, S as SyncMode, U as UploadBlockReason, C as CrudEntry, f as SyncError, F as FailedTransaction, h as CompletedTransaction, e as SyncMetrics, b as ConnectionHealth } from '../types-B9MptP7E.js';
 import { AsyncStorageAdapter, LoggerAdapter } from '../platform/index.js';
+import * as _powersync_common from '@powersync/common';
+import { Table } from '@powersync/common';
 
 /**
  * Sync Status Tracker for @pol-studios/powersync
  *
  * Tracks and normalizes PowerSync status changes, providing a consistent
  * interface for status updates with throttling support.
+ *
+ * Transaction persistence uses local-only SQLite tables instead of AsyncStorage
+ * for better integration with PowerSync's database.
  */
 
 /**
@@ -41,6 +46,7 @@ declare class SyncStatusTracker {
     private readonly logger;
     private readonly notifyThrottleMs;
     private readonly onStatusChange?;
+    private _db;
     private _state;
     private _pendingMutations;
     private _lastNotifyTime;
@@ -53,9 +59,6 @@ declare class SyncStatusTracker {
     private readonly _networkRestoreDelayMs;
     private _persistDebounceTimer;
     private _lastProgress;
-    private readonly _backoffBaseMs;
-    private readonly _backoffMaxMs;
-    private readonly _backoffMultiplier;
     private _failedTransactions;
     private readonly _maxStoredFailures;
     private readonly _failureTTLMs;
@@ -65,11 +68,64 @@ declare class SyncStatusTracker {
     private _lastNotificationTime;
     private _isAutoOffline;
     constructor(storage: AsyncStorageAdapter, logger: LoggerAdapter, options?: SyncStatusTrackerOptions);
+    private _dbInitializing;
+    private _dbReady;
+    private _persistenceErrorCount;
+    private readonly _maxPersistenceErrors;
+    /**
+     * Set the PowerSync database instance AND initialize transactions atomically.
+     * This prevents race conditions between setDatabase() and initTransactions().
+     *
+     * @param db - The PowerSync database instance
+     * @returns Promise that resolves when initialization is complete
+     */
+    setDatabaseAndInit(db: AbstractPowerSyncDatabase): Promise<void>;
+    /**
+     * Set the PowerSync database instance for local-only table persistence.
+     * @deprecated Use setDatabaseAndInit() instead to avoid race conditions.
+     */
+    setDatabase(db: AbstractPowerSyncDatabase): void;
+    /**
+     * Get the PowerSync database instance.
+     */
+    getDatabase(): AbstractPowerSyncDatabase | null;
+    /**
+     * Check if the database is ready for persistence operations.
+     */
+    isDatabaseReady(): boolean;
+    /**
+     * Check if persistence is in a degraded state (too many errors).
+     */
+    isPersistenceDegraded(): boolean;
+    /**
+     * Track a persistence error and log if we enter degraded mode.
+     */
+    private _trackPersistenceError;
+    /**
+     * Reset persistence error count (e.g., after successful operation).
+     */
+    private _resetPersistenceErrors;
     /**
      * Initialize the tracker by loading persisted state.
      * Includes migration from old isPaused boolean to new syncMode.
+     *
+     * Note: Transaction data is loaded from SQLite after the database is set.
+     * Call initTransactions() after setDatabase() to load transaction history.
      */
     init(): Promise<void>;
+    /**
+     * Initialize transactions from SQLite local-only tables.
+     * Must be called after setDatabase() has been called.
+     */
+    initTransactions(): Promise<void>;
+    /**
+     * Load completed transactions from SQLite local-only table.
+     */
+    private _loadCompletedTransactionsFromDb;
+    /**
+     * Load failed transactions from SQLite local-only table.
+     */
+    private _loadFailedTransactionsFromDb;
     /**
      * Dispose the tracker and clear timers.
      */
@@ -180,14 +236,6 @@ declare class SyncStatusTracker {
      * @returns Unsubscribe function
      */
     onSyncModeChange(listener: (mode: SyncMode) => void): Unsubscribe;
-    /**
-     * Compute exponential backoff delay for a given retry count.
-     * Uses base 1s, max 60s, multiplier 2.
-     *
-     * @param retryCount - Number of retries (1-based)
-     * @returns Backoff delay in milliseconds
-     */
-    private _computeBackoffMs;
     /**
      * Record a transaction failure.
      * If a failure for the same entries already exists, updates the retry count.
@@ -287,14 +335,30 @@ declare class SyncStatusTracker {
      */
     getLastNotificationTime(): number;
     /**
-     * Schedule a debounced persist operation.
-     * This prevents race conditions from multiple rapid persist calls.
+     * Insert a completed transaction into SQLite.
      */
-    private _schedulePersist;
+    private _insertCompletedTransaction;
+    /**
+     * Delete a completed transaction from SQLite.
+     */
+    private _deleteCompletedTransaction;
+    /**
+     * Delete all completed transactions from SQLite.
+     */
+    private _deleteAllCompletedTransactions;
+    /**
+     * Insert a failed transaction into SQLite.
+     */
+    private _insertFailedTransaction;
+    /**
+     * Delete a failed transaction from SQLite.
+     */
+    private _deleteFailedTransaction;
     /**
-     * Persist completed and failed transactions to storage.
+     * Enforce the max completed transactions limit in SQLite.
+     * Removes oldest entries beyond the limit.
      */
-    private _persistTransactions;
+    private _enforceCompletedTransactionsLimit;
     private _hasStatusChanged;
     /**
      * Notify all listeners of status changes with throttling.
@@ -532,6 +596,77 @@ declare class HealthMonitor {
     private _withTimeout;
 }
 
+/**
+ * Local-only table for storing failed upload transactions.
+ * Not synced to server - purely client-side persistence.
+ *
+ * Replaces AsyncStorage key '@pol-powersync:failed_transactions'.
+ */
+declare const FailedTransactionsTable: Table<{
+    entries: _powersync_common.BaseColumnType<string>;
+    errorType: _powersync_common.BaseColumnType<string>;
+    errorMessage: _powersync_common.BaseColumnType<string>;
+    errorUserMessage: _powersync_common.BaseColumnType<string>;
+    errorPgCode: _powersync_common.BaseColumnType<string>;
+    errorTimestamp: _powersync_common.BaseColumnType<string>;
+    errorIsPermanent: _powersync_common.BaseColumnType<number>;
+    affectedEntityIds: _powersync_common.BaseColumnType<string>;
+    affectedTables: _powersync_common.BaseColumnType<string>;
+    retryCount: _powersync_common.BaseColumnType<number>;
+    isPermanent: _powersync_common.BaseColumnType<number>;
+    firstFailedAt: _powersync_common.BaseColumnType<string>;
+    lastFailedAt: _powersync_common.BaseColumnType<string>;
+}>;
+/**
+ * Local-only table for storing completed upload transactions.
+ * Used for sync history/activity display.
+ *
+ * Replaces AsyncStorage key '@pol-powersync:completed_transactions'.
+ */
+declare const CompletedTransactionsTable: Table<{
+    entries: _powersync_common.BaseColumnType<string>;
+    affectedEntityIds: _powersync_common.BaseColumnType<string>;
+    affectedTables: _powersync_common.BaseColumnType<string>;
+    completedAt: _powersync_common.BaseColumnType<string>;
+}>;
+/**
+ * Local-only tables to be merged into the PowerSync schema.
+ *
+ * These use the naming convention `ps_local_*` to clearly indicate
+ * they are local-only tables managed by the sync system.
+ */
+declare const LOCAL_ONLY_TABLES: {
+    ps_local_failed_transactions: Table<{
+        entries: _powersync_common.BaseColumnType<string>;
+        errorType: _powersync_common.BaseColumnType<string>;
+        errorMessage: _powersync_common.BaseColumnType<string>;
+        errorUserMessage: _powersync_common.BaseColumnType<string>;
+        errorPgCode: _powersync_common.BaseColumnType<string>;
+        errorTimestamp: _powersync_common.BaseColumnType<string>;
+        errorIsPermanent: _powersync_common.BaseColumnType<number>;
+        affectedEntityIds: _powersync_common.BaseColumnType<string>;
+        affectedTables: _powersync_common.BaseColumnType<string>;
+        retryCount: _powersync_common.BaseColumnType<number>;
+        isPermanent: _powersync_common.BaseColumnType<number>;
+        firstFailedAt: _powersync_common.BaseColumnType<string>;
+        lastFailedAt: _powersync_common.BaseColumnType<string>;
+    }>;
+    ps_local_completed_transactions: Table<{
+        entries: _powersync_common.BaseColumnType<string>;
+        affectedEntityIds: _powersync_common.BaseColumnType<string>;
+        affectedTables: _powersync_common.BaseColumnType<string>;
+        completedAt: _powersync_common.BaseColumnType<string>;
+    }>;
+};
+/**
+ * Table names for the local-only tables.
+ * Use these constants when querying the tables.
+ */
+declare const LOCAL_TABLE_NAMES: {
+    readonly FAILED_TRANSACTIONS: "ps_local_failed_transactions";
+    readonly COMPLETED_TRANSACTIONS: "ps_local_completed_transactions";
+};
+
 /**
  * Dead Letter Queue (DLQ) for PowerSync
  *
@@ -724,4 +859,4 @@ declare function generateDLQEntryId(entries: CrudEntry[]): string;
  */
 declare function createDeadLetterEntry(entries: CrudEntry[], error: SyncError, reason: DeadLetterReason, retryAttempts?: number): DeadLetterEntry;
 
-export { type DeadLetterEntry, DeadLetterQueue, type DeadLetterQueueListener, type DeadLetterQueueOptions, type DeadLetterReason, HealthCheckResult, HealthMonitor, HealthMonitorOptions, MetricsCollector, MetricsCollectorOptions, PowerSyncRawStatus, SyncOperationData, SyncStatusTracker, SyncStatusTrackerOptions, Unsubscribe, createDeadLetterEntry, generateDLQEntryId };
+export { CompletedTransactionsTable, type DeadLetterEntry, DeadLetterQueue, type DeadLetterQueueListener, type DeadLetterQueueOptions, type DeadLetterReason, FailedTransactionsTable, HealthCheckResult, HealthMonitor, HealthMonitorOptions, LOCAL_ONLY_TABLES, LOCAL_TABLE_NAMES, MetricsCollector, MetricsCollectorOptions, PowerSyncRawStatus, SyncOperationData, SyncStatusTracker, SyncStatusTrackerOptions, Unsubscribe, createDeadLetterEntry, generateDLQEntryId };

package/dist/sync/index.js

@@ -7,18 +7,28 @@ import {
   isBackgroundSyncRegistered,
   registerBackgroundSync,
   unregisterBackgroundSync
-} from "../chunk-A4IBBWGO.js";
+} from "../chunk-RALHHPTU.js";
 import {
   HealthMonitor,
   MetricsCollector,
   SyncStatusTracker
-} from "../chunk-RE5HWLCB.js";
-import "../chunk-FNYQFILT.js";
+} from "../chunk-2RDWLXJW.js";
+import {
+  CompletedTransactionsTable,
+  FailedTransactionsTable,
+  LOCAL_ONLY_TABLES,
+  LOCAL_TABLE_NAMES
+} from "../chunk-OGUFUZSY.js";
 import "../chunk-CGL33PL4.js";
 import "../chunk-I2AYMY5O.js";
+import "../chunk-5WRI5ZAA.js";
 export {
+  CompletedTransactionsTable,
   DeadLetterQueue,
+  FailedTransactionsTable,
   HealthMonitor,
+  LOCAL_ONLY_TABLES,
+  LOCAL_TABLE_NAMES,
   MetricsCollector,
   SyncStatusTracker,
   createDeadLetterEntry,

package/dist/{types-CyvBaAl8.d.ts → types-6QHGELuY.d.ts}

@@ -1,8 +1,11 @@
+import { SupabaseClient } from '@supabase/supabase-js';
+
 /**
  * Upload Handler Types for @pol-studios/powersync
  *
  * Defines types for platform-specific upload handlers.
  */
+
 /**
  * Bucket configuration for multi-bucket routing.
  */
@@ -19,7 +22,7 @@ interface BucketConfig {
  */
 interface SupabaseUploadHandlerOptions {
     /** Supabase client instance */
-    supabaseClient: any;
+    supabaseClient: SupabaseClient;
     /** Bucket configuration for multi-bucket routing */
     bucketConfig: BucketConfig;
 }

package/dist/{types-Dv1uf0LZ.d.ts → types-B9MptP7E.d.ts}

@@ -214,16 +214,6 @@ interface FailedTransaction {
     affectedEntityIds: string[];
     /** Table names involved in this transaction */
     affectedTables: string[];
-    /**
-     * Estimated next retry time.
-     * @deprecated With simplified architecture, PowerSync SDK controls retry timing.
-     */
-    nextRetryAt?: Date;
-    /**
-     * Current backoff delay in ms.
-     * @deprecated With simplified architecture, PowerSync SDK controls retry timing.
-     */
-    backoffMs?: number;
 }
 /**
  * Result of classifying a Supabase/PostgreSQL error
@@ -332,6 +322,13 @@ interface AbstractPowerSyncDatabase {
     connect(connector: PowerSyncBackendConnector): Promise<void>;
     /** Disconnect from the PowerSync service */
     disconnect(): Promise<void>;
+    /**
+     * Disconnect and clear all synced data.
+     * @param options.clearLocal - If false, preserves local mutations in ps_crud. Default: true
+     */
+    disconnectAndClear(options?: {
+        clearLocal?: boolean;
+    }): Promise<void>;
     /** Register a listener for status changes */
     registerListener(listener: {
         statusChanged?: (status: unknown) => void;