@pol-studios/powersync 1.0.6 → 1.0.7

package/dist/index.d.ts

@@ -1,17 +1,27 @@
-import { A as AbstractPowerSyncDatabase } from './types-afHtE1U_.js';
-export { k as CacheStats, i as ClassifiedError, j as CompactResult, h as CompletedTransaction, b as ConnectionHealth, o as CountRow, C as CrudEntry, l as CrudTransaction, n as DbStatRow, D as DownloadProgress, E as EntitySyncState, F as FailedTransaction, r as FreelistCountRow, s as IntegrityCheckRow, I as IntegrityResult, q as PageCountRow, p as PageSizeRow, P as PowerSyncBackendConnector, m as SqliteTableRow, c as StorageInfo, d as StorageQuota, f as SyncError, g as SyncErrorType, e as SyncMetrics, S as SyncMode, a as SyncStatus, T as TableCacheStats } from './types-afHtE1U_.js';
-export { ATTACHMENT_DOWNLOAD_TIMEOUT_MS, ATTACHMENT_RETRY_DELAY_MS, AttachmentError, COMPRESSION_MAX_WIDTH, COMPRESSION_SKIP_SIZE_BYTES, COMPRESSION_TARGET_SIZE_BYTES, ConfigurationError, ConnectorError, DEFAULT_ATTACHMENT_CACHE_SIZE, DEFAULT_ATTACHMENT_CONCURRENCY, DEFAULT_COMPRESSION_QUALITY, DEFAULT_MAX_RETRY_ATTEMPTS, DEFAULT_RETRY_BACKOFF_MULTIPLIER, DEFAULT_RETRY_BASE_DELAY_MS, DEFAULT_RETRY_MAX_DELAY_MS, DEFAULT_SYNC_INTERVAL_MS, DEFAULT_SYNC_MODE, DOWNLOAD_STOP_THRESHOLD, EVICTION_TRIGGER_THRESHOLD, HEALTH_CHECK_INTERVAL_MS, HEALTH_CHECK_TIMEOUT_MS, InitializationError, LATENCY_DEGRADED_THRESHOLD_MS, MAX_CONSECUTIVE_FAILURES, PlatformAdapterError, PowerSyncError, STATS_CACHE_TTL_MS, STATUS_NOTIFY_THROTTLE_MS, STORAGE_CRITICAL_THRESHOLD, STORAGE_KEY_ATTACHMENT_SETTINGS, STORAGE_KEY_ENABLED, STORAGE_KEY_METRICS, STORAGE_KEY_PAUSED, STORAGE_KEY_PREFIX, STORAGE_KEY_SYNC_MODE, STORAGE_WARNING_THRESHOLD, SyncOperationError, classifyError, classifySupabaseError, createSyncError, extractEntityIds, extractTableNames, generateFailureId, toSyncOperationError } from './core/index.js';
-import { j as ConflictDetectionConfig, g as ConflictCheckResult } from './index-l3iL9Jte.js';
-export { f as ConflictBus, i as ConflictHandler, k as ConflictListener, h as ConflictResolution, C as ConnectorConfig, c as CrudHandler, D as DEFAULT_RETRY_CONFIG, F as FieldConflict, P as PowerSyncCredentials, l as ResolutionListener, e as RetryConfig, R as RetryStrategyConfig, b as SchemaRouter, S as SupabaseConnector, a as SupabaseConnectorOptions, d as defaultSchemaRouter } from './index-l3iL9Jte.js';
-export { AttachmentQueue, AttachmentQueueConfig, AttachmentRecord, AttachmentSourceConfig, AttachmentState, AttachmentStatsRow, AttachmentStorageAdapter, AttachmentSyncStats, AttachmentSyncStatus, CacheConfig, CacheFileRow, CachedSizeRow, CompressionConfig, DEFAULT_CACHE_CONFIG, DEFAULT_COMPRESSION_CONFIG, DEFAULT_DOWNLOAD_CONFIG, DownloadConfig, DownloadPhase, DownloadStatus, EvictRow, IdRow } from './attachments/index.js';
-export { e as HealthCheckResult, H as HealthMonitorOptions, M as MetricsCollectorOptions, P as PowerSyncRawStatus, c as SyncControlActions, f as SyncEvent, g as SyncEventListener, d as SyncOperationData, S as SyncScope, a as SyncStatusState, b as SyncStatusTrackerOptions, U as Unsubscribe } from './types-Cd7RhNqf.js';
-export { HealthMonitor, MetricsCollector, SyncStatusTracker } from './sync/index.js';
-export { F as FailedUpload, a as FailedUploadStore, f as failedUploadStore } from './failed-upload-store-C0cLxxPz.js';
+import { A as AbstractPowerSyncDatabase } from './types-CDqWh56B.js';
+export { k as CacheStats, i as ClassifiedError, j as CompactResult, h as CompletedTransaction, b as ConnectionHealth, o as CountRow, C as CrudEntry, l as CrudTransaction, n as DbStatRow, D as DownloadProgress, E as EntitySyncState, F as FailedTransaction, r as FreelistCountRow, s as IntegrityCheckRow, I as IntegrityResult, q as PageCountRow, p as PageSizeRow, P as PowerSyncBackendConnector, m as SqliteTableRow, c as StorageInfo, d as StorageQuota, f as SyncError, g as SyncErrorType, e as SyncMetrics, S as SyncMode, a as SyncStatus, T as TableCacheStats } from './types-CDqWh56B.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, extractTableNames, generateFailureId, toSyncOperationError } from './core/index.js';
+import { k as ConflictDetectionConfig, h as ConflictCheckResult } from './supabase-connector-qLm-WHkM.js';
+export { g as ConflictBus, j as ConflictHandler, l as ConflictListener, i as ConflictResolution, C as ConnectorCircuitBreakerConfig, b as ConnectorConfig, e as CrudHandler, D as DEFAULT_RETRY_CONFIG, F as FieldConflict, P as PowerSyncCredentials, m as ResolutionListener, f as RetryConfig, R as RetryStrategyConfig, c as SchemaRouter, S as SupabaseConnector, a as SupabaseConnectorOptions, d as defaultSchemaRouter } from './supabase-connector-qLm-WHkM.js';
+export { CircuitBreaker, CircuitBreakerConfig, CircuitBreakerStats, CircuitOpenError, CircuitState, DEFAULT_CIRCUIT_BREAKER_CONFIG } from './connector/index.js';
+export { t as AttachmentRecord, A as AttachmentSourceConfig, q as AttachmentStatsRow, e as AttachmentStorageAdapter, p as AttachmentSyncStats, o as AttachmentSyncStatus, h as CacheConfig, r as CacheFileRow, s as CachedSizeRow, C as CompressionConfig, i as DEFAULT_CACHE_CONFIG, D as DEFAULT_COMPRESSION_CONFIG, f as DEFAULT_UPLOAD_CONFIG, k as DownloadPhase, l as DownloadStatus, E as EvictRow, I as IdRow, P as PolAttachmentQueue, j as PolAttachmentQueueConfig, a as PolAttachmentQueueOptions, d as PolAttachmentRecord, b as PolAttachmentState, U as UploadConfig, g as UploadHandler, m as UploadPhase, n as UploadStatus, c as createPolAttachmentQueue } from './pol-attachment-queue-C7YNXXhK.js';
+export { PolStorageAdapter, PolStorageAdapterOptions } 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 { DeadLetterEntry, DeadLetterQueue, DeadLetterQueueListener, DeadLetterQueueOptions, DeadLetterReason, HealthMonitor, MetricsCollector, SyncStatusTracker, createDeadLetterEntry, generateDLQEntryId } from './sync/index.js';
 import { SupabaseClient } from '@supabase/supabase-js';
-export { AttachmentQueueContext, CompletedTransactionsContext, CompletedTransactionsContextValue, ConnectionHealthContext, ConnectionHealthContextValue, ConnectionStatusContext, ConnectionStatusContextValue, DEFAULT_CONNECTION_HEALTH, DEFAULT_SYNC_CONFIG, DEFAULT_SYNC_METRICS, DEFAULT_SYNC_STATUS, EntitySyncStatusResult, FailedTransactionsContext, FailedTransactionsContextValue, PendingMutationsContext, PendingMutationsContextValue, PowerSyncConfig, PowerSyncContext, PowerSyncContextValue, PowerSyncProvider, PowerSyncProviderProps, SyncActivityContext, SyncActivityContextValue, SyncActivityResult, SyncConfig, SyncMetricsContext, SyncMetricsContextValue, SyncModeContext, SyncModeContextValue, SyncStatusContext, SyncStatusContextValue, UploadStatusResult, useAttachmentQueue, useCompletedTransactionsContext, useConnectionHealth, useConnectionStatus, useDatabase, useDownloadProgress, useEntitySyncStatus, useFailedTransactionsContext, useIsSyncing, useOnlineStatus, usePendingMutations, usePendingMutationsContext, usePlatform, usePowerSync, useSyncActivity, useSyncActivityContext, useSyncControl, useSyncMetrics, useSyncMode, useSyncModeContext, useSyncStatus, useUploadStatus } from './provider/index.js';
+export { DatabaseMaintenanceUtils, checkIntegrityImpl, checkStorageQuotaImpl, compactDatabaseImpl, getCacheStatsImpl, useDatabaseMaintenance } from './maintenance/index.js';
+export { A as AttachmentUploadHandler, a as BucketConfig, B as BucketResolver, D as DownloadResult, P as PowerSyncStorageAdapter, R as RemoteStorageAdapter, S as StorageUploadHandler, b as SupabaseStorageAdapterOptions, U as UploadOptions, r as resolveBucketFromConfig } from './types-Bgvx7-E8.js';
+export { a as CacheSettings, C as CacheSettingsManager, b as CacheSettingsManagerOptions, D as DEFAULT_CACHE_SETTINGS, S as SupabaseStorageAdapter, c as createSupabaseStorageAdapter } from './CacheSettingsManager-1exbOC6S.js';
+export { D as DEFAULT_UPLOAD_NOTIFICATION, S as SupabaseUploadHandlerOptions, U as UploadEventHandlers, a as UploadNotificationConfig } from './types-BVacP54t.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 { AsyncStorageAdapter, CompressedImage, CompressionOptions, ConnectionType, DatabaseOptions, FileInfo, FileSystemAdapter, ImageProcessorAdapter, LoggerAdapter, NetworkAdapter, PlatformAdapter, PlatformType, detectPlatform } from './platform/index.js';
-import '@tanstack/react-query';
+export { ATTACHMENT_TABLE, AbstractAttachmentQueue, AttachmentState, AttachmentTable, AttachmentTableOptions, AttachmentQueueOptions as BaseAttachmentQueueOptions, DEFAULT_ATTACHMENT_QUEUE_OPTIONS, EncodingType, AttachmentRecord as OfficialAttachmentRecord, StorageAdapter } from '@powersync/attachments';
+import '@powersync/common';
 import 'react';
+import '@tanstack/react-query';
+import '@powersync/react-native';
 
 /**
  * Exponential backoff retry utilities for resilient network operations.
@@ -150,6 +160,74 @@ declare const DEFAULT_BACKOFF_CONFIG: BackoffConfig;
  */
 declare function withExponentialBackoff<T>(fn: () => Promise<T>, config: BackoffConfig, options?: BackoffOptions): Promise<T>;
 
+/**
+ * Format bytes to human-readable string
+ *
+ * @param bytes - Number of bytes to format
+ * @param decimals - Number of decimal places (default: 2)
+ * @returns Formatted string like "1.5 MB", "256 KB", etc.
+ */
+declare function formatBytes(bytes: number, decimals?: number): string;
+
+/**
+ * MIME Type Utilities for @pol-studios/powersync
+ *
+ * Provides file extension to MIME type mapping for storage operations.
+ */
+/**
+ * Get MIME type from file extension.
+ *
+ * @param extension - File extension (with or without leading dot)
+ * @returns MIME type string
+ *
+ * @example
+ * ```typescript
+ * getMimeType('jpg');     // 'image/jpeg'
+ * getMimeType('.png');    // 'image/png'
+ * getMimeType('unknown'); // 'application/octet-stream'
+ * getMimeType(undefined); // 'application/octet-stream'
+ * ```
+ */
+declare function getMimeType(extension: string | undefined | null): string;
+/**
+ * Get MIME type from a file path or filename.
+ *
+ * @param filePath - Full file path or filename
+ * @returns MIME type string
+ *
+ * @example
+ * ```typescript
+ * getMimeTypeFromPath('/path/to/image.jpg');     // 'image/jpeg'
+ * getMimeTypeFromPath('document.pdf');           // 'application/pdf'
+ * getMimeTypeFromPath('file-without-extension'); // 'application/octet-stream'
+ * ```
+ */
+declare function getMimeTypeFromPath(filePath: string | undefined | null): string;
+/**
+ * Check if a MIME type represents an image.
+ */
+declare function isImageMimeType(mimeType: string): boolean;
+/**
+ * Check if a MIME type represents a video.
+ */
+declare function isVideoMimeType(mimeType: string): boolean;
+/**
+ * Check if a MIME type represents audio.
+ */
+declare function isAudioMimeType(mimeType: string): boolean;
+/**
+ * Check if a MIME type represents a document (PDF, Office, etc.).
+ */
+declare function isDocumentMimeType(mimeType: string): boolean;
+/**
+ * Get file extension from MIME type (reverse lookup).
+ * Returns the most common extension for the given MIME type.
+ *
+ * @param mimeType - MIME type string
+ * @returns File extension without leading dot, or undefined if unknown
+ */
+declare function getExtensionFromMimeType(mimeType: string): string | undefined;
+
 /**
  * Conflict Detection for @pol-studios/powersync
  *
@@ -157,6 +235,16 @@ declare function withExponentialBackoff<T>(fn: () => Promise<T>, config: Backoff
  * Only queries AuditLog when version mismatch is detected.
  */
 
+/**
+ * Error thrown when conflict detection fails due to external issues
+ * (e.g., AuditLog query failure). Callers should handle this and decide
+ * whether to retry, fail the sync, or escalate to the user.
+ */
+declare class ConflictDetectionError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
 /**
  * Detect conflicts between local pending changes and server state.
  *
@@ -202,4 +290,4 @@ declare function fetchServerVersion(table: string, recordId: string, schema: str
  */
 declare function getLocalVersion(table: string, recordId: string, db: AbstractPowerSyncDatabase): Promise<number | null>;
 
-export { AbortError, AbstractPowerSyncDatabase, type BackoffConfig, type BackoffOptions, ConflictCheckResult, ConflictDetectionConfig, DEFAULT_BACKOFF_CONFIG, RetryExhaustedError, addJitter, calculateBackoffDelay, detectConflicts, fetchServerVersion, getLocalVersion, hasVersionColumn, sleep, withExponentialBackoff };
+export { AbortError, AbstractPowerSyncDatabase, type BackoffConfig, type BackoffOptions, ConflictCheckResult, ConflictDetectionConfig, ConflictDetectionError, DEFAULT_BACKOFF_CONFIG, RetryExhaustedError, addJitter, calculateBackoffDelay, detectConflicts, fetchServerVersion, formatBytes, getExtensionFromMimeType, getLocalVersion, getMimeType, getMimeTypeFromPath, hasVersionColumn, isAudioMimeType, isDocumentMimeType, isImageMimeType, isVideoMimeType, sleep, withExponentialBackoff };

package/dist/index.js

@@ -1,26 +1,78 @@
-import "./chunk-OLHGI472.js";
-import "./chunk-32OLICZO.js";
+import "./chunk-KGSFAE5B.js";
+import "./chunk-GKF7TOMT.js";
+import {
+  ConflictBus,
+  OfflineDataProvider,
+  PowerSyncProvider,
+  ProviderBridge
+} from "./chunk-BREGB4WL.js";
+import {
+  PowerSyncErrorBoundary
+} from "./chunk-P6WOZO7H.js";
+import {
+  ATTACHMENT_TABLE,
+  AbstractAttachmentQueue,
+  AttachmentState,
+  AttachmentTable,
+  DEFAULT_ATTACHMENT_QUEUE_OPTIONS,
+  DEFAULT_CACHE_CONFIG,
+  DEFAULT_COMPRESSION_CONFIG,
+  DEFAULT_UPLOAD_CONFIG,
+  EncodingType,
+  PolAttachmentQueue,
+  PolAttachmentState,
+  PolStorageAdapter,
+  createPolAttachmentQueue
+} from "./chunk-ZEOKPWUC.js";
+import {
+  DeadLetterQueue,
+  createDeadLetterEntry,
+  defineBackgroundSyncTask,
+  generateDLQEntryId,
+  initializeBackgroundSync,
+  isBackgroundSyncRegistered,
+  registerBackgroundSync,
+  unregisterBackgroundSync
+} from "./chunk-A4IBBWGO.js";
+import {
+  DEFAULT_CONNECTION_HEALTH,
+  DEFAULT_SYNC_CONFIG,
+  DEFAULT_SYNC_METRICS,
+  DEFAULT_SYNC_STATUS,
+  HealthMonitor,
+  MetricsCollector,
+  SyncStatusTracker
+} from "./chunk-H772V6XQ.js";
+import {
+  checkIntegrityImpl,
+  checkStorageQuotaImpl,
+  compactDatabaseImpl,
+  formatBytes,
+  getCacheStatsImpl,
+  useDatabaseMaintenance
+} from "./chunk-WGHNIAF7.js";
 import {
   AttachmentQueueContext,
   CompletedTransactionsContext,
-  ConflictBus,
   ConnectionHealthContext,
   ConnectionStatusContext,
   FailedTransactionsContext,
   PendingMutationsContext,
   PowerSyncContext,
-  PowerSyncProvider,
   SyncActivityContext,
   SyncMetricsContext,
   SyncModeContext,
   SyncStatusContext,
   useAttachmentQueue,
+  useAttachmentQueueReady,
+  useCompletedTransactions,
   useCompletedTransactionsContext,
   useConnectionHealth,
   useConnectionStatus,
   useDatabase,
   useDownloadProgress,
   useEntitySyncStatus,
+  useFailedTransactions,
   useFailedTransactionsContext,
   useIsSyncing,
   useOnlineStatus,
@@ -36,24 +88,30 @@ import {
   useSyncModeContext,
   useSyncStatus,
   useUploadStatus
-} from "./chunk-KCDG2MNP.js";
+} from "./chunk-YSTEESEG.js";
+import "./chunk-LNL64IJZ.js";
 import {
-  AttachmentQueue,
-  AttachmentState,
-  DEFAULT_CACHE_CONFIG,
-  DEFAULT_COMPRESSION_CONFIG,
-  DEFAULT_DOWNLOAD_CONFIG
-} from "./chunk-V6LJ6MR2.js";
-import "./chunk-5FIMA26D.js";
+  CacheSettingsManager,
+  DEFAULT_CACHE_SETTINGS,
+  SupabaseStorageAdapter,
+  createSupabaseStorageAdapter,
+  getExtensionFromMimeType,
+  getMimeType,
+  getMimeTypeFromPath,
+  isAudioMimeType,
+  isDocumentMimeType,
+  isImageMimeType,
+  isVideoMimeType
+} from "./chunk-WQ5MPAVC.js";
+import "./chunk-TGBT5XBE.js";
 import {
-  DEFAULT_CONNECTION_HEALTH,
-  DEFAULT_SYNC_CONFIG,
-  DEFAULT_SYNC_METRICS,
-  DEFAULT_SYNC_STATUS,
-  HealthMonitor,
-  MetricsCollector,
-  SyncStatusTracker
-} from "./chunk-R4YFWQ3Q.js";
+  SupabaseUploadHandler,
+  createSupabaseUploadHandler
+} from "./chunk-UEYRTLKE.js";
+import {
+  DEFAULT_UPLOAD_NOTIFICATION,
+  resolveBucketFromConfig
+} from "./chunk-MKD2VCX3.js";
 import "./chunk-W7HSR35B.js";
 import {
   ATTACHMENT_DOWNLOAD_TIMEOUT_MS,
@@ -80,34 +138,39 @@ import {
   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
-} from "./chunk-EJ23MXPQ.js";
-import "./chunk-VJCL2SWD.js";
+} from "./chunk-CGL33PL4.js";
+import "./chunk-53WH2JJV.js";
 import {
-  AbortError,
-  DEFAULT_BACKOFF_CONFIG,
+  CircuitBreaker,
+  CircuitOpenError,
+  DEFAULT_CIRCUIT_BREAKER_CONFIG
+} from "./chunk-4C3RY5SU.js";
+import {
+  ConflictDetectionError,
   DEFAULT_RETRY_CONFIG,
-  RetryExhaustedError,
   SupabaseConnector,
-  addJitter,
-  calculateBackoffDelay,
   defaultSchemaRouter,
   detectConflicts,
   fetchServerVersion,
   getLocalVersion,
-  hasVersionColumn,
+  hasVersionColumn
+} from "./chunk-HFOFLW5F.js";
+import {
+  AbortError,
+  DEFAULT_BACKOFF_CONFIG,
+  RetryExhaustedError,
+  addJitter,
+  calculateBackoffDelay,
   sleep,
   withExponentialBackoff
-} from "./chunk-62J2DPKX.js";
-import {
-  FailedUploadStore,
-  failedUploadStore
-} from "./chunk-PAFBKNL3.js";
+} from "./chunk-FV2HXEIY.js";
 import {
   AttachmentError,
   ConfigurationError,
@@ -123,32 +186,41 @@ import {
   extractTableNames,
   generateFailureId,
   toSyncOperationError
-} from "./chunk-FPTDATY5.js";
+} from "./chunk-XQAJM2MW.js";
+import "./chunk-DGUM43GV.js";
 export {
   ATTACHMENT_DOWNLOAD_TIMEOUT_MS,
   ATTACHMENT_RETRY_DELAY_MS,
+  ATTACHMENT_TABLE,
   AbortError,
+  AbstractAttachmentQueue,
   AttachmentError,
-  AttachmentQueue,
   AttachmentQueueContext,
   AttachmentState,
+  AttachmentTable,
   COMPRESSION_MAX_WIDTH,
   COMPRESSION_SKIP_SIZE_BYTES,
   COMPRESSION_TARGET_SIZE_BYTES,
+  CacheSettingsManager,
+  CircuitBreaker,
+  CircuitOpenError,
   CompletedTransactionsContext,
   ConfigurationError,
   ConflictBus,
+  ConflictDetectionError,
   ConnectionHealthContext,
   ConnectionStatusContext,
   ConnectorError,
   DEFAULT_ATTACHMENT_CACHE_SIZE,
   DEFAULT_ATTACHMENT_CONCURRENCY,
+  DEFAULT_ATTACHMENT_QUEUE_OPTIONS,
   DEFAULT_BACKOFF_CONFIG,
   DEFAULT_CACHE_CONFIG,
+  DEFAULT_CACHE_SETTINGS,
+  DEFAULT_CIRCUIT_BREAKER_CONFIG,
   DEFAULT_COMPRESSION_CONFIG,
   DEFAULT_COMPRESSION_QUALITY,
   DEFAULT_CONNECTION_HEALTH,
-  DEFAULT_DOWNLOAD_CONFIG,
   DEFAULT_MAX_RETRY_ATTEMPTS,
   DEFAULT_RETRY_BACKOFF_MULTIPLIER,
   DEFAULT_RETRY_BASE_DELAY_MS,
@@ -159,10 +231,13 @@ export {
   DEFAULT_SYNC_METRICS,
   DEFAULT_SYNC_MODE,
   DEFAULT_SYNC_STATUS,
+  DEFAULT_UPLOAD_CONFIG,
+  DEFAULT_UPLOAD_NOTIFICATION,
   DOWNLOAD_STOP_THRESHOLD,
+  DeadLetterQueue,
   EVICTION_TRIGGER_THRESHOLD,
+  EncodingType,
   FailedTransactionsContext,
-  FailedUploadStore,
   HEALTH_CHECK_INTERVAL_MS,
   HEALTH_CHECK_TIMEOUT_MS,
   HealthMonitor,
@@ -170,16 +245,23 @@ export {
   LATENCY_DEGRADED_THRESHOLD_MS,
   MAX_CONSECUTIVE_FAILURES,
   MetricsCollector,
+  OfflineDataProvider,
   PendingMutationsContext,
   PlatformAdapterError,
+  PolAttachmentQueue,
+  PolAttachmentState,
+  PolStorageAdapter,
   PowerSyncContext,
   PowerSyncError,
+  PowerSyncErrorBoundary,
   PowerSyncProvider,
+  ProviderBridge,
   RetryExhaustedError,
   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,
@@ -187,6 +269,8 @@ export {
   STORAGE_KEY_SYNC_MODE,
   STORAGE_WARNING_THRESHOLD,
   SupabaseConnector,
+  SupabaseStorageAdapter,
+  SupabaseUploadHandler,
   SyncActivityContext,
   SyncMetricsContext,
   SyncModeContext,
@@ -195,27 +279,53 @@ export {
   SyncStatusTracker,
   addJitter,
   calculateBackoffDelay,
+  checkIntegrityImpl,
+  checkStorageQuotaImpl,
   classifyError,
   classifySupabaseError,
+  compactDatabaseImpl,
+  createDeadLetterEntry,
+  createPolAttachmentQueue,
+  createSupabaseStorageAdapter,
+  createSupabaseUploadHandler,
   createSyncError,
   defaultSchemaRouter,
+  defineBackgroundSyncTask,
   detectConflicts,
   extractEntityIds,
   extractTableNames,
-  failedUploadStore,
   fetchServerVersion,
+  formatBytes,
+  generateDLQEntryId,
   generateFailureId,
+  getCacheStatsImpl,
+  getExtensionFromMimeType,
   getLocalVersion,
+  getMimeType,
+  getMimeTypeFromPath,
   hasVersionColumn,
+  initializeBackgroundSync,
+  isAudioMimeType,
+  isBackgroundSyncRegistered,
+  isDocumentMimeType,
+  isImageMimeType,
+  isVideoMimeType,
+  registerBackgroundSync,
+  resolveBucketFromConfig,
   sleep,
   toSyncOperationError,
+  unregisterBackgroundSync,
   useAttachmentQueue,
+  useAttachmentQueueReady,
+  useCompletedTransactions,
   useCompletedTransactionsContext,
   useConnectionHealth,
   useConnectionStatus,
   useDatabase,
+  useDatabaseMaintenance,
   useDownloadProgress,
   useEntitySyncStatus,
+  useFailedTransactions,
   useFailedTransactionsContext,
   useIsSyncing,
   useOnlineStatus,

package/dist/index.native.d.ts

@@ -1,14 +1,24 @@
-export { A as AbstractPowerSyncDatabase, k as CacheStats, i as ClassifiedError, j as CompactResult, h as CompletedTransaction, b as ConnectionHealth, o as CountRow, C as CrudEntry, l as CrudTransaction, n as DbStatRow, D as DownloadProgress, E as EntitySyncState, F as FailedTransaction, r as FreelistCountRow, s as IntegrityCheckRow, I as IntegrityResult, q as PageCountRow, p as PageSizeRow, P as PowerSyncBackendConnector, m as SqliteTableRow, c as StorageInfo, d as StorageQuota, f as SyncError, g as SyncErrorType, e as SyncMetrics, S as SyncMode, a as SyncStatus, T as TableCacheStats } from './types-afHtE1U_.js';
-export { ATTACHMENT_DOWNLOAD_TIMEOUT_MS, ATTACHMENT_RETRY_DELAY_MS, AttachmentError, COMPRESSION_MAX_WIDTH, COMPRESSION_SKIP_SIZE_BYTES, COMPRESSION_TARGET_SIZE_BYTES, ConfigurationError, ConnectorError, DEFAULT_ATTACHMENT_CACHE_SIZE, DEFAULT_ATTACHMENT_CONCURRENCY, DEFAULT_COMPRESSION_QUALITY, DEFAULT_MAX_RETRY_ATTEMPTS, DEFAULT_RETRY_BACKOFF_MULTIPLIER, DEFAULT_RETRY_BASE_DELAY_MS, DEFAULT_RETRY_MAX_DELAY_MS, DEFAULT_SYNC_INTERVAL_MS, DEFAULT_SYNC_MODE, DOWNLOAD_STOP_THRESHOLD, EVICTION_TRIGGER_THRESHOLD, HEALTH_CHECK_INTERVAL_MS, HEALTH_CHECK_TIMEOUT_MS, InitializationError, LATENCY_DEGRADED_THRESHOLD_MS, MAX_CONSECUTIVE_FAILURES, PlatformAdapterError, PowerSyncError, STATS_CACHE_TTL_MS, STATUS_NOTIFY_THROTTLE_MS, STORAGE_CRITICAL_THRESHOLD, STORAGE_KEY_ATTACHMENT_SETTINGS, STORAGE_KEY_ENABLED, STORAGE_KEY_METRICS, STORAGE_KEY_PAUSED, STORAGE_KEY_PREFIX, STORAGE_KEY_SYNC_MODE, STORAGE_WARNING_THRESHOLD, SyncOperationError, classifyError, classifySupabaseError, createSyncError, extractEntityIds, extractTableNames, generateFailureId, toSyncOperationError } from './core/index.js';
-export { f as ConflictBus, g as ConflictCheckResult, j as ConflictDetectionConfig, i as ConflictHandler, k as ConflictListener, h as ConflictResolution, C as ConnectorConfig, c as CrudHandler, D as DEFAULT_RETRY_CONFIG, F as FieldConflict, P as PowerSyncCredentials, l as ResolutionListener, e as RetryConfig, R as RetryStrategyConfig, b as SchemaRouter, S as SupabaseConnector, a as SupabaseConnectorOptions, d as defaultSchemaRouter } from './index-l3iL9Jte.js';
-export { AttachmentQueue, AttachmentQueueConfig, AttachmentRecord, AttachmentSourceConfig, AttachmentState, AttachmentStatsRow, AttachmentStorageAdapter, AttachmentSyncStats, AttachmentSyncStatus, CacheConfig, CacheFileRow, CachedSizeRow, CompressionConfig, DEFAULT_CACHE_CONFIG, DEFAULT_COMPRESSION_CONFIG, DEFAULT_DOWNLOAD_CONFIG, DownloadConfig, DownloadPhase, DownloadStatus, EvictRow, IdRow } from './attachments/index.js';
-export { e as HealthCheckResult, H as HealthMonitorOptions, M as MetricsCollectorOptions, P as PowerSyncRawStatus, c as SyncControlActions, f as SyncEvent, g as SyncEventListener, d as SyncOperationData, S as SyncScope, a as SyncStatusState, b as SyncStatusTrackerOptions, U as Unsubscribe } from './types-Cd7RhNqf.js';
-export { HealthMonitor, MetricsCollector, SyncStatusTracker } from './sync/index.js';
-export { F as FailedUpload, a as FailedUploadStore, f as failedUploadStore } from './failed-upload-store-C0cLxxPz.js';
-export { AbortError, BackoffConfig, BackoffOptions, DEFAULT_BACKOFF_CONFIG, RetryExhaustedError, addJitter, calculateBackoffDelay, detectConflicts, fetchServerVersion, getLocalVersion, hasVersionColumn, sleep, withExponentialBackoff } from './index.js';
-export { AttachmentQueueContext, CompletedTransactionsContext, CompletedTransactionsContextValue, ConnectionHealthContext, ConnectionHealthContextValue, ConnectionStatusContext, ConnectionStatusContextValue, DEFAULT_CONNECTION_HEALTH, DEFAULT_SYNC_CONFIG, DEFAULT_SYNC_METRICS, DEFAULT_SYNC_STATUS, EntitySyncStatusResult, FailedTransactionsContext, FailedTransactionsContextValue, PendingMutationsContext, PendingMutationsContextValue, PowerSyncConfig, PowerSyncContext, PowerSyncContextValue, PowerSyncProvider, PowerSyncProviderProps, SyncActivityContext, SyncActivityContextValue, SyncActivityResult, SyncConfig, SyncMetricsContext, SyncMetricsContextValue, SyncModeContext, SyncModeContextValue, SyncStatusContext, SyncStatusContextValue, UploadStatusResult, useAttachmentQueue, useCompletedTransactionsContext, useConnectionHealth, useConnectionStatus, useDatabase, useDownloadProgress, useEntitySyncStatus, useFailedTransactionsContext, useIsSyncing, useOnlineStatus, usePendingMutations, usePendingMutationsContext, usePlatform, usePowerSync, useSyncActivity, useSyncActivityContext, useSyncControl, useSyncMetrics, useSyncMode, useSyncModeContext, useSyncStatus, useUploadStatus } from './provider/index.js';
+export { 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 { 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, extractTableNames, generateFailureId, toSyncOperationError } from './core/index.js';
+export { g as ConflictBus, h as ConflictCheckResult, k as ConflictDetectionConfig, j as ConflictHandler, l as ConflictListener, i as ConflictResolution, C as ConnectorCircuitBreakerConfig, b as ConnectorConfig, e as CrudHandler, D as DEFAULT_RETRY_CONFIG, F as FieldConflict, P as PowerSyncCredentials, m as ResolutionListener, f as RetryConfig, R as RetryStrategyConfig, c as SchemaRouter, S as SupabaseConnector, a as SupabaseConnectorOptions, d as defaultSchemaRouter } from './supabase-connector-qLm-WHkM.js';
+export { CircuitBreaker, CircuitBreakerConfig, CircuitBreakerStats, CircuitOpenError, CircuitState, DEFAULT_CIRCUIT_BREAKER_CONFIG } from './connector/index.js';
+export { t as AttachmentRecord, A as AttachmentSourceConfig, q as AttachmentStatsRow, e as AttachmentStorageAdapter, p as AttachmentSyncStats, o as AttachmentSyncStatus, h as CacheConfig, r as CacheFileRow, s as CachedSizeRow, C as CompressionConfig, i as DEFAULT_CACHE_CONFIG, D as DEFAULT_COMPRESSION_CONFIG, f as DEFAULT_UPLOAD_CONFIG, k as DownloadPhase, l as DownloadStatus, E as EvictRow, I as IdRow, P as PolAttachmentQueue, j as PolAttachmentQueueConfig, a as PolAttachmentQueueOptions, d as PolAttachmentRecord, b as PolAttachmentState, U as UploadConfig, g as UploadHandler, m as UploadPhase, n as UploadStatus, c as createPolAttachmentQueue } from './pol-attachment-queue-C7YNXXhK.js';
+export { PolStorageAdapter, PolStorageAdapterOptions } 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 { 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';
+export { A as AttachmentUploadHandler, a as BucketConfig, B as BucketResolver, D as DownloadResult, P as PowerSyncStorageAdapter, R as RemoteStorageAdapter, S as StorageUploadHandler, b as SupabaseStorageAdapterOptions, U as UploadOptions, r as resolveBucketFromConfig } from './types-Bgvx7-E8.js';
+export { a as CacheSettings, C as CacheSettingsManager, b as CacheSettingsManagerOptions, D as DEFAULT_CACHE_SETTINGS, S as SupabaseStorageAdapter, c as createSupabaseStorageAdapter } from './CacheSettingsManager-1exbOC6S.js';
+export { D as DEFAULT_UPLOAD_NOTIFICATION, S as SupabaseUploadHandlerOptions, U as UploadEventHandlers, a as UploadNotificationConfig } from './types-BVacP54t.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 { AsyncStorageAdapter, CompressedImage, CompressionOptions, ConnectionType, DatabaseOptions, FileInfo, FileSystemAdapter, ImageProcessorAdapter, LoggerAdapter, NetworkAdapter, PlatformAdapter, PlatformType, detectPlatform } from './platform/index.js';
 export { createNativePlatformAdapter } from './platform/index.native.js';
+export { ATTACHMENT_TABLE, AbstractAttachmentQueue, AttachmentState, AttachmentTable, AttachmentTableOptions, AttachmentQueueOptions as BaseAttachmentQueueOptions, DEFAULT_ATTACHMENT_QUEUE_OPTIONS, EncodingType, AttachmentRecord as OfficialAttachmentRecord, StorageAdapter } from '@powersync/attachments';
 import '@supabase/supabase-js';
-import '@tanstack/react-query';
+import '@powersync/common';
 import 'react';
+import '@tanstack/react-query';
+import '@powersync/react-native';