@pol-studios/powersync 1.0.25 → 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-D2oIl2t8.d.ts → supabase-connector-HMxBA9Kg.d.ts}

@@ -1,5 +1,5 @@
-import { P as PowerSyncBackendConnector, A as AbstractPowerSyncDatabase } from './types-CDqWh56B.js';
-import { S as SupabaseConnectorOptions, P as PowerSyncCredentials } from './types-DiBvmGEi.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
@@ -10,6 +10,12 @@ import { S as SupabaseConnectorOptions, P as PowerSyncCredentials } from './type
  * - Schema routing for multi-schema databases
  * - Custom CRUD handling for complex operations
  * - Version-based conflict detection (when enabled)
+ *
+ * Error Handling Architecture (Simplified):
+ * - NO internal retry loops - PowerSync SDK handles all retries naturally
+ * - Middleware decides once: success/discard/retry/fail_transaction
+ * - ALL errors throw to let PowerSync retry naturally
+ * - ALL errors call onTransactionFailure (at outer level) for UI visibility
  */
 
 /**
@@ -78,15 +84,10 @@ declare class SupabaseConnector implements PowerSyncBackendConnector {
     private unsubscribeResolution?;
     private versionColumnPromises;
     private isDestroyed;
-    private retryConfig;
     private completionFailures;
     private static readonly COMPLETION_MAX_FAILURES;
     private static readonly COMPLETION_EXTENDED_TIMEOUT_MS;
     private static readonly MAX_STORED_RESOLUTIONS;
-    private autoRetryPaused;
-    private entryCooldowns;
-    private static readonly COOLDOWN_DURATION_MS;
-    private static readonly MAX_ENTRY_COOLDOWNS;
     private readonly uploadErrorMiddleware;
     constructor(options: SupabaseConnectorOptions);
     /**
@@ -100,28 +101,25 @@ declare class SupabaseConnector implements PowerSyncBackendConnector {
      */
     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
+     * Process a single CRUD entry once (no internal retries).
      *
-     * This fixes the issue where reassigning selectedConfig inside withExponentialBackoff's
-     * callback had no effect because the config was already destructured at call time.
+     * On failure, middleware classifies the error:
+     * - 'success': Treat as completed (e.g., idempotent duplicate)
+     * - 'discard': Remove from queue silently
+     * - 'retry': Throw to let PowerSync retry on next sync cycle
+     * - 'fail_transaction': Throw TransactionAbortError immediately
+     * - 'continue': Throw original error (PowerSync will retry)
      *
      * @param entry - The CRUD entry to process
-     * @throws Error if all retries exhausted (for critical failures)
+     * @throws Error for all errors (PowerSync will retry)
+     * @throws TransactionAbortError when middleware returns 'fail_transaction'
+     * @throws DiscardEntryError for discarded entries
+     */
+    private processEntryOnce;
+    /**
+     * Handle an entry error by running middleware and deciding what to do.
      */
-    private processWithRetry;
+    private handleEntryError;
     /**
      * Set the active project IDs for scoped sync.
      * Call this when user selects/opens projects.

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-ChCXW-EV.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-ChCXW-EV.js';
-import { a as SyncStatus, S as SyncMode, C as CrudEntry, f as SyncError, F as FailedTransaction, h as CompletedTransaction, e as SyncMetrics, A as AbstractPowerSyncDatabase, b as ConnectionHealth } from '../types-CDqWh56B.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;
@@ -62,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.
      */
@@ -79,6 +138,26 @@ declare class SyncStatusTracker {
      * Get the current sync mode.
      */
     getSyncMode(): SyncMode;
+    /**
+     * Get the reason why uploads are currently blocked.
+     * Returns 'none' if uploads are ready to proceed.
+     *
+     * Priority order (first match wins):
+     * 1. offline_mode - User explicitly chose offline mode
+     * 2. auto_offline - System went offline automatically (network loss with auto-offline flag)
+     * 3. pull_only_mode - Pull-only mode active
+     * 4. network_unreachable - No internet connection
+     * 5. disconnected - PowerSync not connected
+     * 6. connecting - PowerSync is connecting
+     * 7. uploading - Actively uploading
+     * 8. none - Ready to sync
+     */
+    getUploadBlockReason(): UploadBlockReason;
+    /**
+     * Get a human-readable description of why uploads are blocked.
+     * Returns null if uploads are not blocked.
+     */
+    getUploadBlockDescription(): string | null;
     /**
      * Check if uploads are allowed based on current sync mode and network reachability.
      */
@@ -173,9 +252,15 @@ declare class SyncStatusTracker {
      */
     clearFailure(failureId: string): void;
     /**
-     * Clear all failures.
+     * Clear failures for successfully synced entries.
+     * Removes any failed transaction that contains entries with the given IDs.
+     *
+     * This is called when `onTransactionSuccess` fires - if any entry in a failed
+     * transaction has now succeeded, we remove that entire failure record.
+     *
+     * @param entryIds - Array of CrudEntry.id values that succeeded
      */
-    clearAllFailures(): void;
+    clearSuccessfulEntries(entryIds: string[]): void;
     /**
      * Remove a failed transaction from tracking and return its entries.
      * This is a "pop" operation - the failure is removed from the list.
@@ -250,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.
@@ -495,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
  *
@@ -687,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-55DKCJV4.js";
-import "../chunk-24RDMMCL.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-CDqWh56B.d.ts → types-B9MptP7E.d.ts}

@@ -23,6 +23,11 @@ type EntitySyncState = 'idle' | 'saving' | 'syncing' | 'synced' | 'error';
  * - 'offline': No sync at all (fully disconnected)
  */
 type SyncMode = 'push-pull' | 'pull-only' | 'offline';
+/**
+ * Reason why uploads are currently blocked.
+ * Used by getUploadBlockReason() to provide detailed status for UI.
+ */
+type UploadBlockReason = 'offline_mode' | 'pull_only_mode' | 'network_unreachable' | 'auto_offline' | 'disconnected' | 'connecting' | 'uploading' | 'none';
 /**
  * CrudEntry represents a pending CRUD operation in the sync queue
  */
@@ -317,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;
@@ -390,4 +402,4 @@ interface IntegrityCheckRow {
     [key: string]: unknown;
 }
 
-export type { AbstractPowerSyncDatabase as A, CrudEntry as C, DownloadProgress as D, EntitySyncState as E, FailedTransaction as F, IntegrityResult as I, PowerSyncBackendConnector as P, SyncMode as S, TableCacheStats as T, SyncStatus as a, ConnectionHealth as b, StorageInfo as c, StorageQuota as d, SyncMetrics as e, SyncError as f, SyncErrorType as g, CompletedTransaction as h, ClassifiedError as i, CompactResult as j, CacheStats as k, CrudTransaction as l, SqliteTableRow as m, DbStatRow as n, CountRow as o, PageSizeRow as p, PageCountRow as q, FreelistCountRow as r, IntegrityCheckRow as s };
+export type { AbstractPowerSyncDatabase as A, CrudEntry as C, DownloadProgress as D, EntitySyncState as E, FailedTransaction as F, IntegrityResult as I, PowerSyncBackendConnector as P, SyncMode as S, TableCacheStats as T, UploadBlockReason as U, SyncStatus as a, ConnectionHealth as b, StorageInfo as c, StorageQuota as d, SyncMetrics as e, SyncError as f, SyncErrorType as g, CompletedTransaction as h, ClassifiedError as i, CompactResult as j, CacheStats as k, CrudTransaction as l, SqliteTableRow as m, DbStatRow as n, CountRow as o, PageSizeRow as p, PageCountRow as q, FreelistCountRow as r, IntegrityCheckRow as s };