@pol-studios/powersync 1.0.6 → 1.0.10

package/dist/provider/index.d.ts

@@ -1,13 +1,17 @@
 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-afHtE1U_.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 } from '../types-CDqWh56B.js';
 import { PlatformAdapter } from '../platform/index.js';
-import { C as ConnectorConfig, S as SupabaseConnector, f as ConflictBus } from '../index-l3iL9Jte.js';
-import { AttachmentQueueConfig, AttachmentQueue } from '../attachments/index.js';
+import { a as ConnectorConfig, g as ConflictBus } from '../types-B212hgfA.js';
+import { e as AttachmentConfig, P as PolAttachmentQueue, A as AttachmentSourceConfig, z as AttachmentRecord, C as CompressionConfig, i as DownloadConfig } from '../pol-attachment-queue-BVAIueoP.js';
+import { S as SupabaseConnector } from '../supabase-connector-T9vHq_3i.js';
 import * as react from 'react';
-import react__default from 'react';
-import { c as SyncControlActions } from '../types-Cd7RhNqf.js';
-import '../failed-upload-store-C0cLxxPz.js';
+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 '@powersync/attachments';
+import '@powersync/common';
 
 /**
  * Provider Types for @pol-studios/powersync
@@ -71,8 +75,16 @@ interface PowerSyncConfig<TSchema = unknown> {
     connector?: ConnectorConfig;
     /**
      * Optional: Attachment queue configuration for offline file caching.
+     *
+     * @example
+     * ```typescript
+     * attachments: {
+     *   source: { table: 'photos', idColumn: 'storage_path' },
+     *   remoteStorage: supabaseStorageAdapter,
+     * }
+     * ```
      */
-    attachments?: AttachmentQueueConfig;
+    attachments?: AttachmentConfig;
     /**
      * Optional: Sync behavior configuration.
      */
@@ -124,7 +136,7 @@ interface PowerSyncContextValue<TSchema = unknown> {
      * The attachment queue instance.
      * Will be null if attachments are not configured or not initialized.
      */
-    attachmentQueue: AttachmentQueue | null;
+    attachmentQueue: PolAttachmentQueue | null;
     /**
      * Whether the PowerSync database is ready for use.
      */
@@ -133,6 +145,17 @@ interface PowerSyncContextValue<TSchema = unknown> {
      * Whether the provider is currently initializing.
      */
     isInitializing: boolean;
+    /**
+     * Whether the attachment queue is ready for use.
+     * This is separate from isReady because the attachment queue initializes
+     * asynchronously after the database is ready.
+     *
+     * States:
+     * - `false`: Attachment queue is still initializing
+     * - `true` with `attachmentQueue !== null`: Ready and available
+     * - `true` with `attachmentQueue === null`: Either attachments not configured, OR initialization failed
+     */
+    attachmentQueueReady: boolean;
     /**
      * Error that occurred during initialization, if any.
      */
@@ -252,10 +275,6 @@ interface SyncStatusContextValue {
      * Resume automatic retry of failed uploads.
      */
     resumeAutoRetry: () => void;
-    /**
-     * Manually retry all failed uploads that are ready for retry.
-     */
-    retryFailedUploads: () => Promise<void>;
 }
 /**
  * Connection state - changes rarely (on connect/disconnect).
@@ -298,6 +317,17 @@ interface PendingMutationsContextValue {
     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)
+     * after a successful write. Includes createdAt timestamp for display.
+     */
+    addPendingMutation: (entry: CrudEntry) => void;
+    /**
+     * Remove a pending mutation by its entity ID.
+     * Called when a transaction completes sync.
+     */
+    removePendingMutation: (id: string) => void;
 }
 /**
  * Failed transactions - changes on failures.
@@ -318,8 +348,16 @@ interface FailedTransactionsContextValue {
     pauseAutoRetry: () => void;
     /** Resume automatic retry of failed uploads */
     resumeAutoRetry: () => void;
-    /** Manually retry all failed uploads */
-    retryFailedUploads: () => Promise<void>;
+    /**
+     * Retry a specific failed transaction.
+     *
+     * This removes the failure from tracking and triggers a sync.
+     * The actual CRUD entries remain in PowerSync's queue - this just
+     * clears our error tracking so the sync can retry them.
+     *
+     * If the sync fails to start, the failure is re-recorded.
+     */
+    retryFailure: (failureId: string) => Promise<void>;
 }
 /**
  * Completed transactions - changes on successful syncs.
@@ -330,6 +368,18 @@ interface CompletedTransactionsContextValue {
     completedTransactions: CompletedTransaction[];
     /** Clear the completed transaction history */
     clearCompletedHistory: () => void;
+    /** Clear a specific completed transaction by ID */
+    clearCompletedItem: (completedId: string) => void;
+    /**
+     * Completed transactions that occurred AFTER the last notification display.
+     * Use this for toast/banner notifications to avoid showing stale historical counts.
+     */
+    newCompletedTransactions: CompletedTransaction[];
+    /**
+     * Mark notifications as seen (updates the lastNotificationTime).
+     * Call this when a sync notification is displayed or auto-dismissed.
+     */
+    markNotificationsAsSeen: () => void;
 }
 /**
  * Sync mode control - changes rarely (user action).
@@ -340,7 +390,18 @@ interface SyncModeContextValue {
     syncMode: SyncMode;
     /** Whether sync is currently paused (offline mode) */
     isPaused: boolean;
-    /** Set the sync mode */
+    /**
+     * Whether offline mode was automatically set due to network loss.
+     * When true, sync will auto-resume when network returns.
+     * When false (user manually chose offline), sync won't auto-resume.
+     */
+    isAutoOffline: boolean;
+    /**
+     * Whether the network is currently reachable.
+     * This is used as a gate to block uploads even when syncMode is 'push-pull'.
+     */
+    networkReachable: boolean;
+    /** Set the sync mode (manual - won't auto-resume) */
     setSyncMode: (mode: SyncMode) => Promise<void>;
     /** Set the force next upload flag */
     setForceNextUpload: (force: boolean) => void;
@@ -518,7 +579,7 @@ declare const SyncMetricsContext: react.Context<SyncMetricsContextValue>;
  * }
  * ```
  */
-declare const AttachmentQueueContext: react.Context<AttachmentQueue>;
+declare const AttachmentQueueContext: react.Context<PolAttachmentQueue>;
 
 /**
  * PowerSyncProvider Component for @pol-studios/powersync
@@ -563,6 +624,316 @@ declare const AttachmentQueueContext: react.Context<AttachmentQueue>;
  */
 declare function PowerSyncProvider<TSchema = unknown>({ config, children, onReady, onError, onSyncStatusChange, }: PowerSyncProviderProps<TSchema>): react__default.ReactElement;
 
+/**
+ * Configuration for @pol-studios/db DataLayerProvider integration.
+ * This allows OfflineDataProvider to wrap and configure the DataLayerProvider.
+ */
+interface DataLayerConfig {
+    /**
+     * Entity schemas that define tables and relationships.
+     * This is passed directly to DataLayerProvider.
+     */
+    schema: Record<string, unknown>;
+}
+/**
+ * Data layer integration configuration.
+ */
+interface DataLayerIntegration {
+    /** DataLayer configuration */
+    config: DataLayerConfig;
+    /** Skip rendering DataLayerProvider (default: false) */
+    skip?: boolean;
+}
+/**
+ * Callbacks for background sync lifecycle events.
+ */
+interface BackgroundSyncCallbacks {
+    /** Called when background sync starts */
+    onSyncStart?: () => void;
+    /** Called when background sync completes successfully */
+    onSyncComplete?: () => void;
+    /** Called when background sync fails */
+    onSyncError?: (error: Error) => void;
+}
+/**
+ * Background sync configuration.
+ */
+interface BackgroundSyncConfig {
+    /** Enable background sync */
+    enabled: boolean;
+    /** Minimum interval between background syncs in minutes (default: 15) */
+    minimumInterval?: number;
+    /** Callbacks for sync lifecycle events */
+    callbacks?: BackgroundSyncCallbacks;
+}
+/**
+ * Status reported by background sync.
+ * Compatible with the status callback in BackgroundSyncSystem.
+ */
+interface BackgroundSyncStatus {
+    /** Last successful sync timestamp */
+    lastSyncedAt?: Date | null;
+    /** Whether currently downloading */
+    downloading: boolean;
+    /** Whether currently uploading */
+    uploading: boolean;
+}
+/**
+ * Snapshot of PowerSync sync status for passing to DataLayerProvider.
+ */
+interface PowerSyncSyncStatusSnapshot {
+    /** Whether initial sync has completed */
+    hasSynced: boolean;
+    /** Whether connected to the PowerSync service */
+    connected: boolean;
+    /** Whether currently attempting to connect */
+    connecting: boolean;
+    /** Whether the device is online (from platform adapter) */
+    isOnline: boolean;
+}
+/**
+ * Attachment configuration for OfflineDataProvider.
+ * Uses the new 2-callback API (watchIds, skipDownload).
+ */
+interface OfflineDataAttachmentConfig extends AttachmentSourceConfig {
+    /** Optional: callback when upload completes */
+    onUploadComplete?: (attachment: AttachmentRecord) => void;
+    /** Optional: callback when upload fails */
+    onUploadFailed?: (attachment: AttachmentRecord, error: Error) => void;
+    /** Optional: max cache size in bytes */
+    maxCacheBytes?: number;
+    /**
+     * Optional: image compression settings for downloads.
+     * Uses Supabase's transform feature to resize/compress images on download.
+     */
+    compression?: Partial<CompressionConfig>;
+    /**
+     * Optional: download configuration for performance tuning.
+     * Adjusts concurrency and timeout for downloads.
+     */
+    download?: Partial<DownloadConfig>;
+}
+/**
+ * Configuration for OfflineDataProvider
+ */
+interface OfflineDataProviderConfig {
+    /** PowerSync schema definition */
+    schema: Schema;
+    /** Supabase client instance */
+    supabaseClient: SupabaseClient;
+    /** React Query client */
+    queryClient: QueryClient;
+    /** PowerSync service URL (if missing, runs in online-only mode) */
+    powerSyncUrl?: string;
+    /** Database filename (default: 'powersync.db') */
+    dbFilename?: string;
+    /** Attachment configuration */
+    attachments?: OfflineDataAttachmentConfig;
+    /** Platform adapter (created automatically if not provided) */
+    platform?: PlatformAdapter;
+    /** Custom connector configuration for CRUD handling */
+    connector?: {
+        /** Schema router function for table-specific schema lookups */
+        schemaRouter?: (table: string) => unknown;
+        /** Enable conflict detection */
+        conflictDetection?: {
+            enabled: boolean;
+        };
+    };
+    /** Sync behavior configuration */
+    sync?: {
+        /** Automatically connect when the provider mounts and there's an authenticated session */
+        autoConnect?: boolean;
+        /** Enable health monitoring */
+        enableHealthMonitoring?: boolean;
+        /** Enable metrics collection */
+        enableMetrics?: boolean;
+    };
+}
+/**
+ * Props for OfflineDataProvider
+ */
+interface OfflineDataProviderProps {
+    /** Provider configuration */
+    config: OfflineDataProviderConfig;
+    children: ReactNode;
+    /**
+     * DataLayer configuration for @pol-studios/db integration.
+     * When provided, OfflineDataProvider wraps children with DataLayerProvider
+     * and automatically bridges PowerSync context to it.
+     */
+    dataLayer?: DataLayerIntegration;
+    /**
+     * Background sync configuration.
+     * When enabled, sets up background sync system for iOS/Android.
+     */
+    backgroundSync?: BackgroundSyncConfig;
+    /** Skip rendering ConflictProvider (default: false) */
+    skipConflictProvider?: boolean;
+    /** Skip rendering StorageQueueProvider (default: false) */
+    skipStorageQueueProvider?: boolean;
+    /** Custom storage backend (overrides built-in Supabase adapter) */
+    storageBackend?: StorageBackend;
+    /** Custom error UI for initialization errors */
+    renderInitError?: (error: Error, retry: () => void) => ReactNode;
+    /** Custom error UI (alias for renderInitError) */
+    renderError?: (error: Error, retry: () => void) => ReactNode;
+    onReady?: () => void;
+    onError?: (error: Error) => void;
+    onSyncStatusChange?: (status: PowerSyncSyncStatusSnapshot) => void;
+    /**
+     * Called when the background sync system is ready.
+     * Use this to set up app-level background sync via defineBackgroundSyncTask.
+     */
+    onBackgroundSyncSystemReady?: (system: BackgroundSyncSystem) => void;
+}
+/**
+ * Props for the internal ProviderBridge component.
+ */
+interface ProviderBridgeProps {
+    children: ReactNode;
+    /** Skip ConflictProvider */
+    skipConflictProvider?: boolean;
+    /** Skip StorageQueueProvider */
+    skipStorageQueueProvider?: boolean;
+    /** Background sync configuration */
+    backgroundSync?: BackgroundSyncConfig;
+    /** Callback for background sync system setup */
+    onBackgroundSyncSystemReady?: (system: BackgroundSyncSystem | null) => void;
+    /** Called once when db becomes ready, with the db instance and initial sync status */
+    onDbReady: (db: AbstractPowerSyncDatabase | null, syncStatus: PowerSyncSyncStatusSnapshot) => void;
+    /** Called whenever sync status changes after initial readiness */
+    onSyncStatusChange: (syncStatus: PowerSyncSyncStatusSnapshot) => void;
+    /** Called with the addPendingMutation function once available */
+    onAddPendingMutationReady: (add: (entry: CrudEntry) => void) => void;
+    /** Called with the removePendingMutation function once available */
+    onRemovePendingMutationReady: (remove: (id: string) => void) => void;
+}
+
+/**
+ * OfflineDataProvider Component for @pol-studios/powersync
+ *
+ * Batteries-included offline data provider that combines:
+ * - PowerSyncProvider for offline-first data sync
+ * - DataLayerProvider integration from @pol-studios/db
+ * - ConflictProvider for conflict resolution UI
+ * - StorageQueueProvider for attachment queue access
+ * - Background sync system setup
+ * - Error recovery UI with retry capability
+ * - Online-only mode fallback (no PowerSync URL)
+ *
+ * @example
+ * ```tsx
+ * <OfflineDataProvider
+ *   config={{
+ *     schema: AppSchema,
+ *     supabaseClient: supabase,
+ *     queryClient: queryClient,
+ *     powerSyncUrl: env.powerSyncUrl,
+ *     attachments: {
+ *       bucket: 'my-bucket',
+ *       watchIds: (db, onUpdate) => {
+ *         db.watch('SELECT storagePath as id FROM photos', [], {
+ *           onResult: (r) => onUpdate(r.rows._array.map(x => x.id)),
+ *         });
+ *       },
+ *       skipDownload: async ({ ids }) => {
+ *         // Return IDs to skip downloading (e.g., videos)
+ *         return ids.filter(id => id.endsWith('.mp4'));
+ *       },
+ *     },
+ *   }}
+ *   dataLayer={{ config: dataLayerConfig }}
+ *   renderInitError={(error, retry) => <MyErrorUI error={error} onRetry={retry} />}
+ * >
+ *   <App />
+ * </OfflineDataProvider>
+ * ```
+ */
+
+/**
+ * Batteries-included offline data provider.
+ *
+ * Combines PowerSyncProvider with error boundary, DataLayerProvider integration,
+ * and sensible defaults for a complete offline-first data solution.
+ *
+ * Key features:
+ * - Automatic PowerSync setup and initialization
+ * - Integration with @pol-studios/db DataLayerProvider
+ * - ConflictProvider and StorageQueueProvider wiring
+ * - Background sync system support
+ * - Error recovery UI with retry capability
+ * - Online-only mode fallback when no PowerSync URL is provided
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <OfflineDataProvider
+ *   config={{
+ *     schema: AppSchema,
+ *     supabaseClient: supabase,
+ *     queryClient: queryClient,
+ *     powerSyncUrl: process.env.EXPO_PUBLIC_POWERSYNC_URL,
+ *   }}
+ * >
+ *   <App />
+ * </OfflineDataProvider>
+ *
+ * // With DataLayer integration
+ * <OfflineDataProvider
+ *   config={{ ... }}
+ *   dataLayer={{ config: dataLayerConfig }}
+ * >
+ *   <App />
+ * </OfflineDataProvider>
+ *
+ * // With custom error UI
+ * <OfflineDataProvider
+ *   config={{ ... }}
+ *   renderInitError={(error, retry) => <MyErrorUI error={error} onRetry={retry} />}
+ * >
+ *   <App />
+ * </OfflineDataProvider>
+ * ```
+ */
+declare function OfflineDataProvider({ config, children, dataLayer, backgroundSync, skipConflictProvider, skipStorageQueueProvider, storageBackend, renderInitError, renderError, onReady, onError, onSyncStatusChange, onBackgroundSyncSystemReady: onBackgroundSyncSystemReadyProp, }: OfflineDataProviderProps): react__default.ReactElement;
+
+/**
+ * ProviderBridge Component for @pol-studios/powersync
+ *
+ * Internal bridge component that connects PowerSync context to external providers:
+ * - DataLayerProvider from @pol-studios/db
+ * - ConflictProvider from @pol-studios/db
+ * - StorageQueueProvider from @pol-studios/db
+ *
+ * This component is used internally by OfflineDataProvider and should not be
+ * exported directly. It handles the complex wiring between packages.
+ */
+
+/**
+ * ProviderBridge connects the PowerSync package context to external providers
+ * like ConflictProvider and StorageQueueProvider from @pol-studios/db.
+ *
+ * This component:
+ * 1. Signals the parent when the db is ready (onDbReady)
+ * 2. Reports sync status changes (onSyncStatusChange)
+ * 3. Exposes pending mutation functions to parent (for DataLayerProvider)
+ * 4. Sets up background sync system when enabled
+ * 5. Wraps children with ConflictProvider and StorageQueueProvider
+ * 6. Exposes PowerSync db via native PowerSyncContext for SDK hooks
+ *
+ * IMPORTANT: DataLayerProvider is rendered OUTSIDE this component (in OfflineDataProvider)
+ * so it always exists in the React tree even before PowerSync is ready.
+ * This prevents "useDataLayer must be used within a DataLayerProvider" errors
+ * when routes mount before the db is initialized.
+ *
+ * CRITICAL: The conflictBus is created internally by PowerSyncProvider and
+ * passed to the connector. We MUST use the same bus instance from context
+ * for ConflictProvider, otherwise conflicts detected by the connector won't
+ * reach the UI components subscribed via ConflictProvider.
+ */
+declare function ProviderBridge({ children, skipConflictProvider, skipStorageQueueProvider, backgroundSync, onBackgroundSyncSystemReady, onDbReady, onSyncStatusChange, onAddPendingMutationReady, onRemovePendingMutationReady, }: ProviderBridgeProps): react__default.ReactElement | null;
+
 /**
  * Hook to access the PowerSync database and related services.
  *
@@ -584,7 +955,17 @@ declare function PowerSyncProvider<TSchema = unknown>({ config, children, onRead
  */
 declare function usePowerSync<TSchema = unknown>(): PowerSyncContextValue<TSchema>;
 /**
- * Hook to access the current sync status.
+ * @deprecated This hook causes re-renders on any status change.
+ * Use focused hooks instead:
+ *
+ * | Old (useSyncStatus)            | New hook                    |
+ * |--------------------------------|-----------------------------|
+ * | connected, hasSynced           | useConnectionStatus()       |
+ * | uploading, downloading         | useSyncActivityContext()    |
+ * | pendingCount, pendingMutations | usePendingMutationsContext()|
+ * | failedTransactions             | useFailedTransactions()     |
+ * | syncMode, setSyncMode          | useSyncMode()               |
+ * | triggerSync, pause, resume     | useSyncControl()            |
  *
  * @returns Sync status with connection state, pending uploads, and progress
  * @throws Error if used outside of PowerSyncProvider
@@ -672,11 +1053,11 @@ declare function usePendingMutationsContext(): PendingMutationsContextValue;
  * @example
  * ```typescript
  * function SyncErrorBanner() {
- *   const { hasUploadErrors, permanentErrorCount, retryFailedUploads } = useFailedTransactionsContext();
+ *   const { hasUploadErrors, permanentErrorCount, retryFailure, failedTransactions } = useFailedTransactionsContext();
  *
  *   if (!hasUploadErrors) return null;
  *   return (
- *     <Banner onRetry={retryFailedUploads}>
+ *     <Banner onRetry={() => failedTransactions.forEach(f => retryFailure(f.id))}>
  *       {permanentErrorCount} changes failed to sync
  *     </Banner>
  *   );
@@ -781,6 +1162,7 @@ declare function useSyncMode(): {
     setMode: (mode: SyncMode) => Promise<void>;
     canUpload: boolean;
     canDownload: boolean;
+    networkReachable: boolean;
 };
 /**
  * Hook to access connection health status.
@@ -865,7 +1247,36 @@ declare function useSyncMetrics(): SyncMetrics;
  * }
  * ```
  */
-declare function useAttachmentQueue(): AttachmentQueue | null;
+declare function useAttachmentQueue(): PolAttachmentQueue | null;
+/**
+ * Hook to check if the attachment queue has finished initializing.
+ *
+ * This is useful when you need to wait for the attachment queue to be ready
+ * before performing upload operations. The attachment queue initializes
+ * asynchronously after the database is ready, so there's a brief period
+ * where `isReady` is true but `attachmentQueueReady` is false.
+ *
+ * @returns Whether the attachment queue is ready (true if initialized or if attachments not configured)
+ *
+ * @example
+ * ```typescript
+ * function UploadButton() {
+ *   const attachmentQueue = useAttachmentQueue();
+ *   const attachmentQueueReady = useAttachmentQueueReady();
+ *
+ *   if (!attachmentQueueReady) {
+ *     return <Button disabled>Initializing...</Button>;
+ *   }
+ *
+ *   if (!attachmentQueue) {
+ *     return <Text>Uploads not configured</Text>;
+ *   }
+ *
+ *   return <Button onPress={handleUpload}>Upload</Button>;
+ * }
+ * ```
+ */
+declare function useAttachmentQueueReady(): boolean;
 /**
  * Hook to get the PowerSync database instance.
  * Throws if not ready.
@@ -1090,20 +1501,29 @@ interface SyncActivityResult {
     failed: FailedTransaction[];
     /** Recently completed transactions */
     completed: CompletedTransaction[];
+    /** New completed transactions since last notification display (for toasts/banners) */
+    newCompleted: CompletedTransaction[];
     /** Counts summary */
     counts: {
         pending: number;
         failed: number;
         completed: number;
+        newCompleted: number;
     };
     /** Whether there is any sync activity to show (pending or failed) */
     hasActivity: boolean;
     /** Retry all failed transactions */
     retryAll: () => Promise<void>;
+    /** Retry a specific failed transaction */
+    retryFailure: (failureId: string) => Promise<void>;
     /** Dismiss a specific failure */
     dismissFailure: (failureId: string) => void;
     /** Clear all completed transactions from the list */
     clearCompleted: () => void;
+    /** Clear a specific completed transaction from the list */
+    clearCompletedItem: (completedId: string) => void;
+    /** Mark notifications as seen (for auto-dismiss functionality) */
+    markNotificationsAsSeen: () => void;
 }
 /**
  * Hook to get comprehensive sync activity including pending, failed, and completed transactions.
@@ -1129,5 +1549,15 @@ interface SyncActivityResult {
  * ```
  */
 declare function useSyncActivity(): SyncActivityResult;
+/**
+ * Get failed transactions state and retry/dismiss functions.
+ * Alias for useFailedTransactionsContext.
+ */
+declare const useFailedTransactions: typeof useFailedTransactionsContext;
+/**
+ * Get completed transactions state and clear function.
+ * Alias for useCompletedTransactionsContext.
+ */
+declare const useCompletedTransactions: typeof useCompletedTransactionsContext;
 
-export { AttachmentQueueContext, CompletedTransactionsContext, type CompletedTransactionsContextValue, ConnectionHealthContext, type ConnectionHealthContextValue, ConnectionStatusContext, type ConnectionStatusContextValue, DEFAULT_CONNECTION_HEALTH, DEFAULT_SYNC_CONFIG, DEFAULT_SYNC_METRICS, DEFAULT_SYNC_STATUS, type EntitySyncStatusResult, FailedTransactionsContext, type FailedTransactionsContextValue, PendingMutationsContext, type PendingMutationsContextValue, type PowerSyncConfig, PowerSyncContext, type PowerSyncContextValue, PowerSyncProvider, type PowerSyncProviderProps, SyncActivityContext, type SyncActivityContextValue, type SyncActivityResult, type SyncConfig, SyncMetricsContext, type SyncMetricsContextValue, SyncModeContext, type SyncModeContextValue, SyncStatusContext, type SyncStatusContextValue, type UploadStatusResult, useAttachmentQueue, useCompletedTransactionsContext, useConnectionHealth, useConnectionStatus, useDatabase, useDownloadProgress, useEntitySyncStatus, 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, 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 };