@pol-studios/powersync 1.0.25 → 1.0.30

package/dist/index.web.d.ts

@@ -1,11 +1,11 @@
-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-CDqWh56B.js';
+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, U as UploadBlockReason } from './types-Dv1uf0LZ.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_AUTO_OFFLINE, STORAGE_KEY_ENABLED, STORAGE_KEY_METRICS, STORAGE_KEY_PAUSED, STORAGE_KEY_PREFIX, STORAGE_KEY_SYNC_MODE, STORAGE_WARNING_THRESHOLD, SyncOperationError, classifyError, classifySupabaseError, createSyncError, extractEntityIds, extractHttpStatusCode, extractTableNames, generateFailureId, isRlsError, toSyncOperationError } from './core/index.js';
-export { A as AuthProvider, i as ConflictBus, j as ConflictCheckResult, m as ConflictDetectionConfig, l as ConflictHandler, n as ConflictListener, k as ConflictResolution, C as ConnectorCircuitBreakerConfig, a as ConnectorConfig, c as CrudHandler, D as DEFAULT_RETRY_CONFIG, F as FieldConflict, P as PowerSyncCredentials, o as ResolutionListener, e as RetryConfig, R as RetryStrategyConfig, b as SchemaRouter, f as Session, S as SupabaseConnectorOptions, U as UploadErrorClassification, g as UploadErrorContext, h as UploadErrorMiddleware, d as defaultSchemaRouter } from './types-DiBvmGEi.js';
-export { S as SupabaseConnector } from './supabase-connector-D2oIl2t8.js';
+export { A as AuthProvider, i as ConflictBus, j as ConflictCheckResult, m as ConflictDetectionConfig, l as ConflictHandler, n as ConflictListener, k as ConflictResolution, C as ConnectorCircuitBreakerConfig, a as ConnectorConfig, c as CrudHandler, D as DEFAULT_RETRY_CONFIG, F as FieldConflict, P as PowerSyncCredentials, o as ResolutionListener, e as RetryConfig, R as RetryStrategyConfig, b as SchemaRouter, f as Session, S as SupabaseConnectorOptions, U as UploadErrorClassification, g as UploadErrorContext, h as UploadErrorMiddleware, d as defaultSchemaRouter } from './types-CpM2_LhU.js';
+export { S as SupabaseConnector } from './supabase-connector-C4YpH_l3.js';
 export { AuthRefreshError, CircuitBreaker, CircuitBreakerConfig, CircuitBreakerStats, CircuitOpenError, CircuitState, DEFAULT_CIRCUIT_BREAKER_CONFIG, DiscardEntryError, SupabaseAuthOptions, TransactionAbortError, createSupabaseAuth, discardOnHttpStatus, discardOnPgCodes, discardOrphaned, idempotentTables, retryOnHttpStatus, runUploadErrorMiddleware, runUploadErrorMiddlewareSync, successOnPgCodes, tableHandlers } from './connector/index.js';
 export { f as AttachmentConfig, F as AttachmentRecord, A as AttachmentSourceConfig, x as AttachmentStatsRow, g as AttachmentStorageAdapter, w as AttachmentSyncStats, v as AttachmentSyncStatus, B as BatchFilterContext, n as CACHE_SIZE_PRESETS, l as CacheConfig, y as CacheFileRow, o as CacheSizePreset, p as CacheSizeValue, z as CachedSizeRow, C as CompressionConfig, m as DEFAULT_CACHE_CONFIG, D as DEFAULT_COMPRESSION_CONFIG, k as DEFAULT_DOWNLOAD_CONFIG, h as DEFAULT_UPLOAD_CONFIG, j as DownloadConfig, r as DownloadPhase, s as DownloadStatus, E as EvictRow, I as IdRow, P as PolAttachmentQueue, a as PolAttachmentQueueOptions, d as PolAttachmentRecord, b as PolAttachmentState, S as SimpleAttachmentConfig, e as SkipDownloadContext, U as UploadConfig, i as UploadHandler, t as UploadPhase, u as UploadStatus, W as WatchConfig, c as createPolAttachmentQueue, q as formatCacheSize } from './pol-attachment-queue-BE2HU3Us.js';
 export { CacheManagerDeps, DOWNLOAD_WORKFLOW_STATES, DownloadManagerDeps, LOCALLY_AVAILABLE_STATES, MigrationStats, PENDING_DOWNLOAD_STATES, PROTECTED_UPLOAD_STATES, PolStorageAdapter, PolStorageAdapterOptions, STATE_MAPPING, STATE_NAMES, TERMINAL_STATES, UPLOAD_WORKFLOW_STATES, UploadManagerDeps, UploadManagerState, VALID_STATES, blobToArrayBuffer, buildIdOnlyWatchQuery, buildRecordFetchQuery, buildWatchQuery, cacheLocalFile, clearCache, clearUploadCallback, copyToManagedCache, createCacheManagerDeps, createMigrationStats, createUploadManagerDeps, createUploadManagerState, createWatchIds, determineAttachmentState, downloadRecord, enforceCacheLimit, ensureFileUri, extractErrorCode, extractIdsFromRows, formatMigrationStats, getCachedSize, getEvictionCandidates, getExcludeProtectedStatesCondition, getFailedPermanentUploads, getLocalUriForStoragePath, getPendingUploads, getProtectedStatesInClause, getSoonestRetryTime, getStaleUploads, getStateName, getSyncedUploadsWithPendingCallback, isCacheNearCapacity, isDownloadWorkflowState, isLocallyAvailable, isPendingDownloadState, isPermanentError, isProtectedUploadState, isStateTransitionAllowed, isTerminalState, isUploadWorkflowState, isValidAttachmentState, markUploadPermanentFailure, markUploadSynced, migrateAttachmentState, migrateAttachmentStateSafe, recordMigration, scheduleUploadRetry, startUploadProcessing, stripFileUri, uploadOne, validateSqlIdentifier, validateSqlIdentifierFromStateMachine, validateWhereClause, watchConfigToSourceConfig } from './attachments/index.js';
-export { B as BackgroundSyncOptions, h as BackgroundSyncSystem, 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, i as defineBackgroundSyncTask, j as initializeBackgroundSync, k as isBackgroundSyncRegistered, r as registerBackgroundSync, u as unregisterBackgroundSync } from './background-sync-ChCXW-EV.js';
+export { B as BackgroundSyncOptions, h as BackgroundSyncSystem, 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, i as defineBackgroundSyncTask, j as initializeBackgroundSync, k as isBackgroundSyncRegistered, r as registerBackgroundSync, u as unregisterBackgroundSync } from './background-sync-CVR3PkFi.js';
 export { DeadLetterEntry, DeadLetterQueue, DeadLetterQueueListener, DeadLetterQueueOptions, DeadLetterReason, HealthMonitor, MetricsCollector, SyncStatusTracker, createDeadLetterEntry, generateDLQEntryId } from './sync/index.js';
 export { AbortError, BackoffConfig, BackoffOptions, ConflictDetectionError, DEFAULT_BACKOFF_CONFIG, RetryExhaustedError, addJitter, calculateBackoffDelay, detectConflicts, fetchServerVersion, formatBytes, getExtensionFromMimeType, getLocalVersion, getMimeType, getMimeTypeFromPath, hasVersionColumn, isAudioMimeType, isDocumentMimeType, isImageMimeType, isVideoMimeType, sleep, withExponentialBackoff } from './index.js';
 export { DatabaseMaintenanceUtils, checkIntegrityImpl, checkStorageQuotaImpl, compactDatabaseImpl, getCacheStatsImpl, useDatabaseMaintenance } from './maintenance/index.js';
@@ -14,7 +14,7 @@ export { f as CacheSettings, C as CacheSettingsManager, h as CacheSettingsManage
 export { D as DEFAULT_UPLOAD_NOTIFICATION, S as SupabaseUploadHandlerOptions, U as UploadEventHandlers, a as UploadNotificationConfig } from './types-CyvBaAl8.js';
 export { SupabaseUploadHandler, createSupabaseUploadHandler } from './storage/upload/index.js';
 export { PowerSyncErrorBoundary } from './error/index.js';
-export { AttachmentQueueContext, BackgroundSyncCallbacks, BackgroundSyncConfig, BackgroundSyncStatus, CompletedTransactionsContext, CompletedTransactionsContextValue, ConnectionHealthContext, ConnectionHealthContextValue, ConnectionStatusContext, ConnectionStatusContextValue, DEFAULT_CONNECTION_HEALTH, DEFAULT_SYNC_CONFIG, DEFAULT_SYNC_METRICS, DEFAULT_SYNC_STATUS, DataLayerConfig, DataLayerIntegration, EntitySyncStatusResult, FailedTransactionsContext, FailedTransactionsContextValue, OfflineDataAttachmentConfig, OfflineDataProvider, OfflineDataProviderConfig, OfflineDataProviderProps, PendingMutationsContext, PendingMutationsContextValue, PowerSyncConfig, PowerSyncContext, PowerSyncContextValue, PowerSyncProvider, PowerSyncProviderProps, PowerSyncSyncStatusSnapshot, ProviderBridge, ProviderBridgeProps, SyncActivityContext, SyncActivityContextValue, SyncActivityResult, SyncConfig, SyncMetricsContext, SyncMetricsContextValue, SyncModeContext, SyncModeContextValue, SyncStatusContext, SyncStatusContextValue, UploadStatusResult, 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 './provider/index.js';
+export { AttachmentQueueContext, BackgroundSyncCallbacks, BackgroundSyncConfig, BackgroundSyncStatus, CompletedTransactionsContext, CompletedTransactionsContextValue, ConnectionHealthContext, ConnectionHealthContextValue, ConnectionStatusContext, ConnectionStatusContextValue, DEFAULT_CONNECTION_HEALTH, DEFAULT_SYNC_CONFIG, DEFAULT_SYNC_METRICS, DEFAULT_SYNC_STATUS, DataLayerConfig, DataLayerIntegration, EntitySyncStatusResult, FailedTransactionsContext, FailedTransactionsContextValue, OfflineDataAttachmentConfig, OfflineDataProvider, OfflineDataProviderConfig, OfflineDataProviderProps, PendingMutationsContext, PendingMutationsContextValue, PowerSyncConfig, PowerSyncContext, PowerSyncContextValue, PowerSyncProvider, PowerSyncProviderProps, PowerSyncSyncStatusSnapshot, ProviderBridge, ProviderBridgeProps, RetryCountdownResult, SyncActivityContext, SyncActivityContextValue, SyncActivityResult, SyncConfig, SyncMetricsContext, SyncMetricsContextValue, SyncModeContext, SyncModeContextValue, SyncStatusContext, SyncStatusContextValue, UPLOAD_BACKOFF_DELAYS, UPLOAD_MAX_RETRIES, UploadBlockedReasonResult, UploadStatusResult, useAttachmentQueue, useAttachmentQueueReady, useCompletedTransactions, useCompletedTransactionsContext, useConnectionHealth, useConnectionStatus, useDatabase, useDownloadProgress, useEntitySyncStatus, useFailedTransactions, useFailedTransactionsContext, useIsSyncing, useOnlineStatus, usePendingMutations, usePendingMutationsContext, usePlatform, usePowerSync, useRetryCountdown, useSyncActivity, useSyncActivityContext, useSyncControl, useSyncMetrics, useSyncMode, useSyncModeContext, useSyncStatus, useUploadBlockedReason, useUploadRetry, useUploadStatus } from './provider/index.js';
 export { AttachmentQueueContextValue, SlimPowerSyncProvider, useAttachmentQueueContext, usePowerSyncContext, useSyncStatusContext } from './react/index.js';
 export { AsyncStorageAdapter, CompressedImage, CompressionOptions, ConnectionType, DatabaseOptions, FileInfo, FileSystemAdapter, ImageProcessorAdapter, LoggerAdapter, NetworkAdapter, PlatformAdapter, PlatformType, detectPlatform } from './platform/index.js';
 export { createWebPlatformAdapter } from './platform/index.web.js';

package/dist/index.web.js

@@ -4,7 +4,7 @@ import {
   useAttachmentQueueContext,
   usePowerSyncContext,
   useSyncStatusContext
-} from "./chunk-TIFL2KWE.js";
+} from "./chunk-RBPWEOIV.js";
 import {
   DOWNLOAD_WORKFLOW_STATES,
   STATE_MAPPING,
@@ -35,8 +35,10 @@ import {
   ConflictBus,
   OfflineDataProvider,
   PowerSyncProvider,
-  ProviderBridge
-} from "./chunk-VB737IVN.js";
+  ProviderBridge,
+  UPLOAD_BACKOFF_DELAYS,
+  UPLOAD_MAX_RETRIES
+} from "./chunk-JCGOZVWL.js";
 import "./chunk-YHTZ7VMV.js";
 import {
   PowerSyncErrorBoundary
@@ -119,13 +121,13 @@ import {
   HealthMonitor,
   MetricsCollector,
   SyncStatusTracker
-} from "./chunk-55DKCJV4.js";
+} from "./chunk-RE5HWLCB.js";
 import {
   DEFAULT_CONNECTION_HEALTH,
   DEFAULT_SYNC_CONFIG,
   DEFAULT_SYNC_METRICS,
   DEFAULT_SYNC_STATUS
-} from "./chunk-24RDMMCL.js";
+} from "./chunk-FNYQFILT.js";
 import {
   checkIntegrityImpl,
   checkStorageQuotaImpl,
@@ -133,7 +135,7 @@ import {
   formatBytes,
   getCacheStatsImpl,
   useDatabaseMaintenance
-} from "./chunk-WGHNIAF7.js";
+} from "./chunk-QREWE3NR.js";
 import {
   AttachmentQueueContext,
   CompletedTransactionsContext,
@@ -163,6 +165,7 @@ import {
   usePendingMutationsContext,
   usePlatform,
   usePowerSync,
+  useRetryCountdown,
   useSyncActivity,
   useSyncActivityContext,
   useSyncControl,
@@ -170,8 +173,10 @@ import {
   useSyncMode,
   useSyncModeContext,
   useSyncStatus,
+  useUploadBlockedReason,
+  useUploadRetry,
   useUploadStatus
-} from "./chunk-YSTEESEG.js";
+} from "./chunk-C2ACBYBZ.js";
 import "./chunk-T4AO7JIG.js";
 import "./chunk-CAB26E6F.js";
 import {
@@ -197,6 +202,15 @@ import {
   DEFAULT_UPLOAD_NOTIFICATION,
   resolveBucket
 } from "./chunk-Z6VOBGTU.js";
+import {
+  AbortError,
+  DEFAULT_BACKOFF_CONFIG,
+  RetryExhaustedError,
+  addJitter,
+  calculateBackoffDelay,
+  sleep,
+  withExponentialBackoff
+} from "./chunk-FV2HXEIY.js";
 import "./chunk-W7HSR35B.js";
 import {
   ATTACHMENT_DOWNLOAD_TIMEOUT_MS,
@@ -262,16 +276,7 @@ import {
   runUploadErrorMiddlewareSync,
   successOnPgCodes,
   tableHandlers
-} from "./chunk-BGBQYQV3.js";
-import {
-  AbortError,
-  DEFAULT_BACKOFF_CONFIG,
-  RetryExhaustedError,
-  addJitter,
-  calculateBackoffDelay,
-  sleep,
-  withExponentialBackoff
-} from "./chunk-FV2HXEIY.js";
+} from "./chunk-BC2SRII2.js";
 import {
   AttachmentError,
   ConfigurationError,
@@ -392,6 +397,8 @@ export {
   SyncStatusTracker,
   TERMINAL_STATES,
   TransactionAbortError,
+  UPLOAD_BACKOFF_DELAYS,
+  UPLOAD_MAX_RETRIES,
   UPLOAD_WORKFLOW_STATES,
   VALID_STATES,
   addJitter,
@@ -522,6 +529,7 @@ export {
   usePlatform,
   usePowerSync,
   usePowerSyncContext,
+  useRetryCountdown,
   useSyncActivity,
   useSyncActivityContext,
   useSyncControl,
@@ -530,6 +538,8 @@ export {
   useSyncModeContext,
   useSyncStatus,
   useSyncStatusContext,
+  useUploadBlockedReason,
+  useUploadRetry,
   useUploadStatus,
   validateSqlIdentifier2 as validateSqlIdentifier,
   validateSqlIdentifier as validateSqlIdentifierFromStateMachine,

package/dist/maintenance/index.d.ts

@@ -1,5 +1,5 @@
-import { k as CacheStats, j as CompactResult, I as IntegrityResult, d as StorageQuota, A as AbstractPowerSyncDatabase } from '../types-CDqWh56B.js';
-export { c as StorageInfo } from '../types-CDqWh56B.js';
+import { k as CacheStats, j as CompactResult, I as IntegrityResult, d as StorageQuota, A as AbstractPowerSyncDatabase } from '../types-Dv1uf0LZ.js';
+export { c as StorageInfo } from '../types-Dv1uf0LZ.js';
 import { LoggerAdapter } from '../platform/index.js';
 
 /**

package/dist/maintenance/index.js

@@ -4,8 +4,8 @@ import {
   compactDatabaseImpl,
   getCacheStatsImpl,
   useDatabaseMaintenance
-} from "../chunk-WGHNIAF7.js";
-import "../chunk-YSTEESEG.js";
+} from "../chunk-QREWE3NR.js";
+import "../chunk-C2ACBYBZ.js";
 export {
   checkIntegrityImpl,
   checkStorageQuotaImpl,

package/dist/platform/index.d.ts

@@ -1,4 +1,4 @@
-import { A as AbstractPowerSyncDatabase } from '../types-CDqWh56B.js';
+import { A as AbstractPowerSyncDatabase } from '../types-Dv1uf0LZ.js';
 
 /**
  * Platform Adapter Types for @pol-studios/powersync

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

@@ -1,5 +1,5 @@
 import { LoggerAdapter, PlatformAdapter } from './index.js';
-import '../types-CDqWh56B.js';
+import '../types-Dv1uf0LZ.js';
 
 /**
  * React Native Platform Adapter for @pol-studios/powersync

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

@@ -1,5 +1,5 @@
 import { LoggerAdapter, PlatformAdapter } from './index.js';
-import '../types-CDqWh56B.js';
+import '../types-Dv1uf0LZ.js';
 
 /**
  * Web Platform Adapter for @pol-studios/powersync

package/dist/provider/index.d.ts

@@ -1,15 +1,15 @@
 import { SupabaseClient } from '@supabase/supabase-js';
 import { QueryClient } from '@tanstack/react-query';
-import { A as AbstractPowerSyncDatabase, a as SyncStatus, C as CrudEntry, S as SyncMode, F as FailedTransaction, h as CompletedTransaction, b as ConnectionHealth, e as SyncMetrics, D as DownloadProgress, E as EntitySyncState, f as SyncError } from '../types-CDqWh56B.js';
+import { A as AbstractPowerSyncDatabase, a as SyncStatus, C as CrudEntry, S as SyncMode, F as FailedTransaction, h as CompletedTransaction, b as ConnectionHealth, e as SyncMetrics, D as DownloadProgress, E as EntitySyncState, f as SyncError, U as UploadBlockReason } from '../types-Dv1uf0LZ.js';
 import { PlatformAdapter } from '../platform/index.js';
-import { a as ConnectorConfig, i as ConflictBus } from '../types-DiBvmGEi.js';
+import { a as ConnectorConfig, i as ConflictBus } from '../types-CpM2_LhU.js';
 import { f as AttachmentConfig, P as PolAttachmentQueue, A as AttachmentSourceConfig, F as AttachmentRecord, C as CompressionConfig, j as DownloadConfig } from '../pol-attachment-queue-BE2HU3Us.js';
-import { S as SupabaseConnector } from '../supabase-connector-D2oIl2t8.js';
+import { S as SupabaseConnector } from '../supabase-connector-C4YpH_l3.js';
 import * as react from 'react';
 import react__default, { ReactNode } from 'react';
 import { Schema } from '@powersync/react-native';
 import { a as StorageBackend } from '../types-D0WcHrq6.js';
-import { h as BackgroundSyncSystem, c as SyncControlActions } from '../background-sync-ChCXW-EV.js';
+import { h as BackgroundSyncSystem, c as SyncControlActions } from '../background-sync-CVR3PkFi.js';
 import '@powersync/attachments';
 import '@powersync/common';
 
@@ -232,10 +232,6 @@ interface SyncStatusContextValue {
      * Clear a specific failure by its ID.
      */
     clearFailure: (failureId: string) => void;
-    /**
-     * Clear all failures.
-     */
-    clearAllFailures: () => void;
     /**
      * Completed transactions history.
      */
@@ -261,20 +257,31 @@ interface SyncStatusContextValue {
      */
     discardPendingMutation: (clientId: number) => Promise<void>;
     /**
-     * Discard all pending mutations.
-     * Uses safe disconnect/reconnect pattern to avoid transaction conflicts.
-     * @throws Error if upload is in progress
+     * Whether we're currently waiting for a retry after upload failure.
+     */
+    isWaitingForUploadRetry: boolean;
+    /**
+     * When the next retry will occur (null if not waiting).
+     */
+    nextUploadRetryAt: Date | null;
+    /**
+     * Whether the maximum retry attempts have been reached.
+     */
+    maxUploadRetriesReached: boolean;
+    /**
+     * Current retry attempt count.
      */
-    discardAllPendingMutations: () => Promise<void>;
+    uploadRetryCount: number;
     /**
-     * Pause automatic retry of failed uploads.
-     * Useful when user is actively resolving conflicts.
+     * Force a manual retry after max retries reached.
      */
-    pauseAutoRetry: () => void;
+    manualUploadRetry: () => Promise<void>;
     /**
-     * Resume automatic retry of failed uploads.
+     * Discard a specific failed entry by its ps_crud ID and reconnect.
+     * Use this when a single entry is causing upload failures.
+     * @param entryId - The ps_crud entry ID (clientId) to discard
      */
-    resumeAutoRetry: () => void;
+    discardFailedEntryAndReconnect: (entryId: number) => Promise<void>;
 }
 /**
  * Connection state - changes rarely (on connect/disconnect).
@@ -315,8 +322,6 @@ interface PendingMutationsContextValue {
     pendingCount: number;
     /** Discard a specific pending mutation by its client ID */
     discardPendingMutation: (clientId: number) => Promise<void>;
-    /** Discard all pending mutations */
-    discardAllPendingMutations: () => Promise<void>;
     /**
      * Add a pending mutation to the list.
      * Called by mutation hooks (useDbInsert, useDbUpdate, useDbDelete, useDbUpsert)
@@ -342,12 +347,6 @@ interface FailedTransactionsContextValue {
     permanentErrorCount: number;
     /** Clear a specific failure by its ID */
     clearFailure: (failureId: string) => void;
-    /** Clear all failures */
-    clearAllFailures: () => void;
-    /** Pause automatic retry of failed uploads */
-    pauseAutoRetry: () => void;
-    /** Resume automatic retry of failed uploads */
-    resumeAutoRetry: () => void;
     /**
      * Retry a specific failed transaction.
      *
@@ -405,6 +404,36 @@ interface SyncModeContextValue {
     setSyncMode: (mode: SyncMode) => Promise<void>;
     /** Set the force next upload flag */
     setForceNextUpload: (force: boolean) => void;
+    /**
+     * Whether we're currently waiting for a retry after upload failure.
+     * When true, PowerSync is disconnected and waiting for the backoff timer.
+     */
+    isWaitingForUploadRetry: boolean;
+    /**
+     * When the next retry will occur (null if not waiting).
+     * Use this to display a countdown to the user.
+     */
+    nextUploadRetryAt: Date | null;
+    /**
+     * Whether the maximum retry attempts have been reached.
+     * When true, the system won't automatically retry - user must intervene.
+     */
+    maxUploadRetriesReached: boolean;
+    /**
+     * Current retry attempt count (0 when no retries have occurred).
+     */
+    uploadRetryCount: number;
+    /**
+     * Force a manual retry after max retries reached.
+     * Resets retry state and attempts to reconnect.
+     */
+    manualUploadRetry: () => Promise<void>;
+    /**
+     * Discard a specific failed entry by its ps_crud ID and reconnect.
+     * Use this when a single entry is causing upload failures.
+     * @param entryId - The ps_crud entry ID (clientId) to discard
+     */
+    discardFailedEntryAndReconnect: (entryId: number) => Promise<void>;
 }
 /**
  * Value provided by ConnectionHealthContext.
@@ -1164,6 +1193,58 @@ declare function useSyncMode(): {
     canDownload: boolean;
     networkReachable: boolean;
 };
+/**
+ * Hook to access upload retry state for exponential backoff handling.
+ *
+ * When an upload fails, the provider disconnects and waits with exponential backoff
+ * before reconnecting. After 7 failed attempts (256s backoff), it stays disconnected
+ * and lets the user decide.
+ *
+ * @returns Upload retry state and control functions
+ * @throws Error if used outside of PowerSyncProvider
+ *
+ * @example
+ * ```typescript
+ * function UploadRetryBanner() {
+ *   const {
+ *     isWaiting,
+ *     nextRetryAt,
+ *     maxRetriesReached,
+ *     retryCount,
+ *     manualRetry,
+ *     discardAndReconnect,
+ *   } = useUploadRetry();
+ *
+ *   if (maxRetriesReached) {
+ *     return (
+ *       <View>
+ *         <Text>Upload failed after {retryCount} attempts</Text>
+ *         <Button onPress={manualRetry}>Try Again</Button>
+ *         <Button onPress={discardAndReconnect}>Discard Changes</Button>
+ *       </View>
+ *     );
+ *   }
+ *
+ *   if (isWaiting && nextRetryAt) {
+ *     return (
+ *       <View>
+ *         <Text>Retrying in {Math.ceil((nextRetryAt.getTime() - Date.now()) / 1000)}s</Text>
+ *       </View>
+ *     );
+ *   }
+ *
+ *   return null;
+ * }
+ * ```
+ */
+declare function useUploadRetry(): {
+    isWaiting: boolean;
+    nextRetryAt: Date | null;
+    maxRetriesReached: boolean;
+    retryCount: number;
+    manualRetry: () => Promise<void>;
+    discardEntryAndReconnect: (entryId: number) => Promise<void>;
+};
 /**
  * Hook to access connection health status.
  *
@@ -1469,8 +1550,8 @@ interface UploadStatusResult {
     failedTransactions: FailedTransaction[];
     /** Trigger sync retry (reconnect) */
     retryAll: () => Promise<void>;
-    /** Dismiss all failures */
-    dismissAll: () => void;
+    /** Dismiss a specific failure by its ID */
+    dismissFailure: (failureId: string) => void;
 }
 /**
  * Hook to get overall upload status across all entities.
@@ -1559,5 +1640,84 @@ declare const useFailedTransactions: typeof useFailedTransactionsContext;
  * Alias for useCompletedTransactionsContext.
  */
 declare const useCompletedTransactions: typeof useCompletedTransactionsContext;
+/**
+ * Return type for useUploadBlockedReason hook.
+ */
+interface UploadBlockedReasonResult {
+    /** Whether uploads are currently blocked */
+    isBlocked: boolean;
+    /** The reason uploads are blocked */
+    reason: UploadBlockReason;
+    /** Human-readable description of why uploads are blocked */
+    description: string | null;
+    /** Whether an upload is actively in progress */
+    isUploading: boolean;
+}
+/**
+ * Hook to get why uploads are blocked.
+ * Derives block reason from existing sync mode, network, and connection state.
+ *
+ * @returns Upload blocked status with reason and description
+ *
+ * @example
+ * ```typescript
+ * function UploadBlockedBanner() {
+ *   const { isBlocked, reason, description } = useUploadBlockedReason();
+ *
+ *   if (!isBlocked) return null;
+ *
+ *   return <Banner>{description}</Banner>;
+ * }
+ * ```
+ */
+declare function useUploadBlockedReason(): UploadBlockedReasonResult;
+/**
+ * Return type for useRetryCountdown hook.
+ */
+interface RetryCountdownResult {
+    /** The soonest next retry time from all failed transactions */
+    nextRetryAt: Date | null;
+    /** Milliseconds until the next retry (0 if already past) */
+    timeUntilRetryMs: number;
+    /** Formatted countdown string (e.g., "5s", "1m 30s", "2m") or null if no retry scheduled */
+    formattedCountdown: string | null;
+}
+/**
+ * Hook for retry countdown display.
+ * Returns the soonest nextRetryAt from all failed transactions.
+ * Re-renders every second when countdown is active.
+ *
+ * @returns Retry countdown information
+ *
+ * @example
+ * ```typescript
+ * function RetryTimer() {
+ *   const { nextRetryAt, formattedCountdown } = useRetryCountdown();
+ *
+ *   if (!nextRetryAt) return null;
+ *
+ *   return <Text>Retrying in {formattedCountdown}</Text>;
+ * }
+ * ```
+ */
+declare function useRetryCountdown(): RetryCountdownResult;
+
+/**
+ * Provider Constants for @pol-studios/powersync
+ *
+ * Exports constants used in the provider that may need to be accessed by UI components.
+ */
+/**
+ * Maximum number of upload retry attempts before stopping automatic retries.
+ * After this many attempts, the user must manually retry or discard the failed entries.
+ *
+ * Backoff delays: 4s, 8s, 16s, 32s, 64s, 128s, 256s (total: ~8.5 minutes)
+ */
+declare const UPLOAD_MAX_RETRIES = 7;
+/**
+ * Backoff delays in seconds for each retry attempt.
+ * Uses exponential backoff: 4s, 8s, 16s, 32s, 64s, 128s, 256s
+ */
+declare const UPLOAD_BACKOFF_DELAYS: readonly [4, 8, 16, 32, 64, 128, 256];
 
-export { AttachmentQueueContext, type BackgroundSyncCallbacks, type BackgroundSyncConfig, type BackgroundSyncStatus, CompletedTransactionsContext, type CompletedTransactionsContextValue, ConnectionHealthContext, type ConnectionHealthContextValue, ConnectionStatusContext, type ConnectionStatusContextValue, DEFAULT_CONNECTION_HEALTH, DEFAULT_SYNC_CONFIG, DEFAULT_SYNC_METRICS, DEFAULT_SYNC_STATUS, type DataLayerConfig, type DataLayerIntegration, type EntitySyncStatusResult, FailedTransactionsContext, type FailedTransactionsContextValue, type OfflineDataAttachmentConfig, OfflineDataProvider, type OfflineDataProviderConfig, type OfflineDataProviderProps, PendingMutationsContext, type PendingMutationsContextValue, type PowerSyncConfig, PowerSyncContext, type PowerSyncContextValue, PowerSyncProvider, type PowerSyncProviderProps, type PowerSyncSyncStatusSnapshot, ProviderBridge, type ProviderBridgeProps, SyncActivityContext, type SyncActivityContextValue, type SyncActivityResult, type SyncConfig, SyncMetricsContext, type SyncMetricsContextValue, SyncModeContext, type SyncModeContextValue, SyncStatusContext, type SyncStatusContextValue, type UploadStatusResult, 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 };
+export { AttachmentQueueContext, type BackgroundSyncCallbacks, type BackgroundSyncConfig, type BackgroundSyncStatus, CompletedTransactionsContext, type CompletedTransactionsContextValue, ConnectionHealthContext, type ConnectionHealthContextValue, ConnectionStatusContext, type ConnectionStatusContextValue, DEFAULT_CONNECTION_HEALTH, DEFAULT_SYNC_CONFIG, DEFAULT_SYNC_METRICS, DEFAULT_SYNC_STATUS, type DataLayerConfig, type DataLayerIntegration, type EntitySyncStatusResult, FailedTransactionsContext, type FailedTransactionsContextValue, type OfflineDataAttachmentConfig, OfflineDataProvider, type OfflineDataProviderConfig, type OfflineDataProviderProps, PendingMutationsContext, type PendingMutationsContextValue, type PowerSyncConfig, PowerSyncContext, type PowerSyncContextValue, PowerSyncProvider, type PowerSyncProviderProps, type PowerSyncSyncStatusSnapshot, ProviderBridge, type ProviderBridgeProps, type RetryCountdownResult, SyncActivityContext, type SyncActivityContextValue, type SyncActivityResult, type SyncConfig, SyncMetricsContext, type SyncMetricsContextValue, SyncModeContext, type SyncModeContextValue, SyncStatusContext, type SyncStatusContextValue, UPLOAD_BACKOFF_DELAYS, UPLOAD_MAX_RETRIES, type UploadBlockedReasonResult, type UploadStatusResult, useAttachmentQueue, useAttachmentQueueReady, useCompletedTransactions, useCompletedTransactionsContext, useConnectionHealth, useConnectionStatus, useDatabase, useDownloadProgress, useEntitySyncStatus, useFailedTransactions, useFailedTransactionsContext, useIsSyncing, useOnlineStatus, usePendingMutations, usePendingMutationsContext, usePlatform, usePowerSync, useRetryCountdown, useSyncActivity, useSyncActivityContext, useSyncControl, useSyncMetrics, useSyncMode, useSyncModeContext, useSyncStatus, useUploadBlockedReason, useUploadRetry, useUploadStatus };

package/dist/provider/index.js

@@ -1,18 +1,20 @@
 import {
   OfflineDataProvider,
   PowerSyncProvider,
-  ProviderBridge
-} from "../chunk-VB737IVN.js";
+  ProviderBridge,
+  UPLOAD_BACKOFF_DELAYS,
+  UPLOAD_MAX_RETRIES
+} from "../chunk-JCGOZVWL.js";
 import "../chunk-YHTZ7VMV.js";
 import "../chunk-P6WOZO7H.js";
 import "../chunk-CACKC6XG.js";
-import "../chunk-55DKCJV4.js";
+import "../chunk-RE5HWLCB.js";
 import {
   DEFAULT_CONNECTION_HEALTH,
   DEFAULT_SYNC_CONFIG,
   DEFAULT_SYNC_METRICS,
   DEFAULT_SYNC_STATUS
-} from "../chunk-24RDMMCL.js";
+} from "../chunk-FNYQFILT.js";
 import {
   AttachmentQueueContext,
   CompletedTransactionsContext,
@@ -42,6 +44,7 @@ import {
   usePendingMutationsContext,
   usePlatform,
   usePowerSync,
+  useRetryCountdown,
   useSyncActivity,
   useSyncActivityContext,
   useSyncControl,
@@ -49,15 +52,17 @@ import {
   useSyncMode,
   useSyncModeContext,
   useSyncStatus,
+  useUploadBlockedReason,
+  useUploadRetry,
   useUploadStatus
-} from "../chunk-YSTEESEG.js";
+} from "../chunk-C2ACBYBZ.js";
 import "../chunk-CAB26E6F.js";
 import "../chunk-XAEII4ZX.js";
 import "../chunk-Z6VOBGTU.js";
+import "../chunk-FV2HXEIY.js";
 import "../chunk-CGL33PL4.js";
 import "../chunk-WN5ZJ3E2.js";
-import "../chunk-BGBQYQV3.js";
-import "../chunk-FV2HXEIY.js";
+import "../chunk-BC2SRII2.js";
 import "../chunk-I2AYMY5O.js";
 export {
   AttachmentQueueContext,
@@ -78,6 +83,8 @@ export {
   SyncMetricsContext,
   SyncModeContext,
   SyncStatusContext,
+  UPLOAD_BACKOFF_DELAYS,
+  UPLOAD_MAX_RETRIES,
   useAttachmentQueue,
   useAttachmentQueueReady,
   useCompletedTransactions,
@@ -95,6 +102,7 @@ export {
   usePendingMutationsContext,
   usePlatform,
   usePowerSync,
+  useRetryCountdown,
   useSyncActivity,
   useSyncActivityContext,
   useSyncControl,
@@ -102,6 +110,8 @@ export {
   useSyncMode,
   useSyncModeContext,
   useSyncStatus,
+  useUploadBlockedReason,
+  useUploadRetry,
   useUploadStatus
 };
 //# sourceMappingURL=index.js.map

package/dist/react/index.d.ts

@@ -1,11 +1,11 @@
 import * as react from 'react';
 import react__default, { ReactNode } from 'react';
 import { Schema } from '@powersync/react-native';
-import { A as AuthProvider } from '../types-DiBvmGEi.js';
+import { A as AuthProvider } from '../types-CpM2_LhU.js';
 import { a as StorageBackend } from '../types-D0WcHrq6.js';
 import { f as AttachmentConfig, P as PolAttachmentQueue } from '../pol-attachment-queue-BE2HU3Us.js';
 import { PlatformAdapter } from '../platform/index.js';
-import { f as SyncError, a as SyncStatus, A as AbstractPowerSyncDatabase } from '../types-CDqWh56B.js';
+import { f as SyncError, a as SyncStatus, A as AbstractPowerSyncDatabase } from '../types-Dv1uf0LZ.js';
 import '@supabase/supabase-js';
 import '@powersync/attachments';
 import '@powersync/common';

package/dist/react/index.js

@@ -6,11 +6,11 @@ import {
   useAttachmentQueueContext,
   usePowerSyncContext,
   useSyncStatusContext
-} from "../chunk-TIFL2KWE.js";
+} from "../chunk-RBPWEOIV.js";
 import "../chunk-CACKC6XG.js";
-import "../chunk-24RDMMCL.js";
-import "../chunk-BGBQYQV3.js";
+import "../chunk-FNYQFILT.js";
 import "../chunk-FV2HXEIY.js";
+import "../chunk-BC2SRII2.js";
 import "../chunk-I2AYMY5O.js";
 export {
   AttachmentQueueContext,

package/dist/storage/index.d.ts

@@ -3,4 +3,4 @@ export { f as CacheSettings, C as CacheSettingsManager, h as CacheSettingsManage
 export { D as DEFAULT_UPLOAD_NOTIFICATION, S as SupabaseUploadHandlerOptions, U as UploadEventHandlers, a as UploadNotificationConfig } from '../types-CyvBaAl8.js';
 export { SupabaseUploadHandler, createSupabaseUploadHandler } from './upload/index.js';
 import '../platform/index.js';
-import '../types-CDqWh56B.js';
+import '../types-Dv1uf0LZ.js';

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

@@ -3,4 +3,4 @@ export { f as CacheSettings, C as CacheSettingsManager, h as CacheSettingsManage
 export { D as DEFAULT_UPLOAD_NOTIFICATION, S as SupabaseUploadHandlerOptions, U as UploadEventHandlers, a as UploadNotificationConfig } from '../types-CyvBaAl8.js';
 export { SupabaseUploadHandler, createSupabaseUploadHandler } from './upload/index.native.js';
 import '../platform/index.js';
-import '../types-CDqWh56B.js';
+import '../types-Dv1uf0LZ.js';

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

@@ -3,4 +3,4 @@ export { f as CacheSettings, C as CacheSettingsManager, h as CacheSettingsManage
 export { D as DEFAULT_UPLOAD_NOTIFICATION, S as SupabaseUploadHandlerOptions, U as UploadEventHandlers, a as UploadNotificationConfig } from '../types-CyvBaAl8.js';
 export { SupabaseUploadHandler, createSupabaseUploadHandler } from './upload/index.js';
 import '../platform/index.js';
-import '../types-CDqWh56B.js';
+import '../types-Dv1uf0LZ.js';