@pol-studios/powersync 1.0.6 → 1.0.10

package/dist/index.web.js

@@ -1,26 +1,159 @@
-import "./chunk-OLHGI472.js";
-import "./chunk-32OLICZO.js";
+import "./chunk-654ERHA7.js";
+import {
+  SlimPowerSyncProvider,
+  useAttachmentQueueContext,
+  usePowerSyncContext,
+  useSyncStatusContext
+} from "./chunk-63PXSPIN.js";
+import {
+  DOWNLOAD_WORKFLOW_STATES,
+  STATE_MAPPING,
+  STATE_NAMES,
+  TERMINAL_STATES,
+  UPLOAD_WORKFLOW_STATES,
+  VALID_STATES,
+  buildIdOnlyWatchQuery,
+  buildRecordFetchQuery,
+  buildWatchQuery,
+  createMigrationStats,
+  formatMigrationStats,
+  getStateName,
+  isDownloadWorkflowState,
+  isTerminalState,
+  isUploadWorkflowState,
+  isValidAttachmentState,
+  migrateAttachmentState,
+  migrateAttachmentStateSafe,
+  recordMigration,
+  validateSqlIdentifier as validateSqlIdentifier2,
+  validateWhereClause,
+  watchConfigToSourceConfig
+} from "./chunk-ZM4ENYMF.js";
+import {
+  ConflictBus,
+  OfflineDataProvider,
+  PowerSyncProvider,
+  ProviderBridge
+} from "./chunk-BRXQNASY.js";
+import "./chunk-YHTZ7VMV.js";
+import {
+  PowerSyncErrorBoundary
+} from "./chunk-P6WOZO7H.js";
+import {
+  ATTACHMENT_TABLE,
+  AbstractAttachmentQueue,
+  AttachmentState,
+  AttachmentTable,
+  CACHE_SIZE_PRESETS,
+  DEFAULT_ATTACHMENT_QUEUE_OPTIONS,
+  DEFAULT_CACHE_CONFIG,
+  DEFAULT_COMPRESSION_CONFIG,
+  DEFAULT_DOWNLOAD_CONFIG,
+  DEFAULT_UPLOAD_CONFIG,
+  EncodingType,
+  LOCALLY_AVAILABLE_STATES,
+  PENDING_DOWNLOAD_STATES,
+  PROTECTED_UPLOAD_STATES,
+  PolAttachmentQueue,
+  PolAttachmentState,
+  PolStorageAdapter,
+  blobToArrayBuffer,
+  cacheLocalFile,
+  clearCache,
+  clearUploadCallback,
+  copyToManagedCache,
+  createCacheManagerDeps,
+  createPolAttachmentQueue,
+  createUploadManagerDeps,
+  createUploadManagerState,
+  determineAttachmentState,
+  downloadRecord,
+  enforceCacheLimit,
+  ensureFileUri,
+  extractErrorCode,
+  formatCacheSize,
+  getCachedSize,
+  getEvictionCandidates,
+  getExcludeProtectedStatesCondition,
+  getExtensionFromMimeType,
+  getFailedPermanentUploads,
+  getLocalUriForStoragePath,
+  getMimeType,
+  getMimeTypeFromPath,
+  getPendingUploads,
+  getProtectedStatesInClause,
+  getSoonestRetryTime,
+  getStaleUploads,
+  getSyncedUploadsWithPendingCallback,
+  isAudioMimeType,
+  isCacheNearCapacity,
+  isDocumentMimeType,
+  isImageMimeType,
+  isLocallyAvailable,
+  isPendingDownloadState,
+  isPermanentError,
+  isProtectedUploadState,
+  isStateTransitionAllowed,
+  isVideoMimeType,
+  markUploadPermanentFailure,
+  markUploadSynced,
+  scheduleUploadRetry,
+  startUploadProcessing,
+  stripFileUri,
+  uploadOne,
+  validateSqlIdentifier
+} from "./chunk-4TXTAEF2.js";
+import {
+  DeadLetterQueue,
+  createDeadLetterEntry,
+  defineBackgroundSyncTask,
+  generateDLQEntryId,
+  initializeBackgroundSync,
+  isBackgroundSyncRegistered,
+  registerBackgroundSync,
+  unregisterBackgroundSync
+} from "./chunk-A4IBBWGO.js";
+import {
+  HealthMonitor,
+  MetricsCollector,
+  SyncStatusTracker
+} from "./chunk-CUCAYK7Z.js";
+import {
+  DEFAULT_CONNECTION_HEALTH,
+  DEFAULT_SYNC_CONFIG,
+  DEFAULT_SYNC_METRICS,
+  DEFAULT_SYNC_STATUS
+} from "./chunk-24RDMMCL.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 +169,32 @@ import {
   useSyncModeContext,
   useSyncStatus,
   useUploadStatus
-} from "./chunk-KCDG2MNP.js";
+} from "./chunk-YSTEESEG.js";
+import "./chunk-T4AO7JIG.js";
+import "./chunk-CAB26E6F.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,
+  createSupabaseStorage,
+  isBlobResult,
+  isFileResult
+} from "./chunk-XOY2CJ67.js";
 import {
-  DEFAULT_CONNECTION_HEALTH,
-  DEFAULT_SYNC_CONFIG,
-  DEFAULT_SYNC_METRICS,
-  DEFAULT_SYNC_STATUS,
-  HealthMonitor,
-  MetricsCollector,
-  SyncStatusTracker
-} from "./chunk-R4YFWQ3Q.js";
+  SupabaseStorageAdapter,
+  createSupabaseStorageAdapter,
+  getStorageErrorMessage,
+  isStorageAuthError,
+  normalizeStoragePath
+} from "./chunk-XAEII4ZX.js";
+import "./chunk-TGBT5XBE.js";
+import {
+  SupabaseUploadHandler,
+  createSupabaseUploadHandler
+} from "./chunk-P4HZA6ZT.js";
+import {
+  DEFAULT_UPLOAD_NOTIFICATION,
+  resolveBucket
+} from "./chunk-Z6VOBGTU.js";
 import "./chunk-W7HSR35B.js";
 import {
   ATTACHMENT_DOWNLOAD_TIMEOUT_MS,
@@ -80,37 +221,44 @@ 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";
+} from "./chunk-CGL33PL4.js";
+import "./chunk-WN5ZJ3E2.js";
 import {
   createWebPlatformAdapter
-} from "./chunk-7EMDVIZX.js";
-import "./chunk-VJCL2SWD.js";
+} from "./chunk-N75DEF5J.js";
 import {
-  AbortError,
-  DEFAULT_BACKOFF_CONFIG,
+  AuthRefreshError,
+  CircuitBreaker,
+  CircuitOpenError,
+  DEFAULT_CIRCUIT_BREAKER_CONFIG,
+  createSupabaseAuth
+} from "./chunk-HWSNV45P.js";
+import {
+  ConflictDetectionError,
   DEFAULT_RETRY_CONFIG,
-  RetryExhaustedError,
   SupabaseConnector,
-  addJitter,
-  calculateBackoffDelay,
   defaultSchemaRouter,
   detectConflicts,
   fetchServerVersion,
   getLocalVersion,
-  hasVersionColumn,
+  hasVersionColumn
+} from "./chunk-KN2IZERF.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,
@@ -125,29 +273,41 @@ import {
   extractEntityIds,
   extractTableNames,
   generateFailureId,
+  isRlsError,
   toSyncOperationError
-} from "./chunk-FPTDATY5.js";
+} from "./chunk-VACPAAQZ.js";
 export {
   ATTACHMENT_DOWNLOAD_TIMEOUT_MS,
   ATTACHMENT_RETRY_DELAY_MS,
+  ATTACHMENT_TABLE,
   AbortError,
+  AbstractAttachmentQueue,
   AttachmentError,
-  AttachmentQueue,
   AttachmentQueueContext,
   AttachmentState,
+  AttachmentTable,
+  AuthRefreshError,
+  CACHE_SIZE_PRESETS,
   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,
@@ -162,64 +322,170 @@ export {
   DEFAULT_SYNC_METRICS,
   DEFAULT_SYNC_MODE,
   DEFAULT_SYNC_STATUS,
+  DEFAULT_UPLOAD_CONFIG,
+  DEFAULT_UPLOAD_NOTIFICATION,
   DOWNLOAD_STOP_THRESHOLD,
+  DOWNLOAD_WORKFLOW_STATES,
+  DeadLetterQueue,
   EVICTION_TRIGGER_THRESHOLD,
+  EncodingType,
   FailedTransactionsContext,
-  FailedUploadStore,
   HEALTH_CHECK_INTERVAL_MS,
   HEALTH_CHECK_TIMEOUT_MS,
   HealthMonitor,
   InitializationError,
   LATENCY_DEGRADED_THRESHOLD_MS,
+  LOCALLY_AVAILABLE_STATES,
   MAX_CONSECUTIVE_FAILURES,
   MetricsCollector,
+  OfflineDataProvider,
+  PENDING_DOWNLOAD_STATES,
+  PROTECTED_UPLOAD_STATES,
   PendingMutationsContext,
   PlatformAdapterError,
+  PolAttachmentQueue,
+  PolAttachmentState,
+  PolStorageAdapter,
   PowerSyncContext,
   PowerSyncError,
+  PowerSyncErrorBoundary,
   PowerSyncProvider,
+  ProviderBridge,
   RetryExhaustedError,
+  STATE_MAPPING,
+  STATE_NAMES,
   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,
+  SlimPowerSyncProvider,
   SupabaseConnector,
+  SupabaseStorageAdapter,
+  SupabaseUploadHandler,
   SyncActivityContext,
   SyncMetricsContext,
   SyncModeContext,
   SyncOperationError,
   SyncStatusContext,
   SyncStatusTracker,
+  TERMINAL_STATES,
+  UPLOAD_WORKFLOW_STATES,
+  VALID_STATES,
   addJitter,
+  blobToArrayBuffer,
+  buildIdOnlyWatchQuery,
+  buildRecordFetchQuery,
+  buildWatchQuery,
+  cacheLocalFile,
   calculateBackoffDelay,
+  checkIntegrityImpl,
+  checkStorageQuotaImpl,
   classifyError,
   classifySupabaseError,
+  clearCache,
+  clearUploadCallback,
+  compactDatabaseImpl,
+  copyToManagedCache,
+  createCacheManagerDeps,
+  createDeadLetterEntry,
+  createMigrationStats,
+  createPolAttachmentQueue,
+  createSupabaseAuth,
+  createSupabaseStorage,
+  createSupabaseStorageAdapter,
+  createSupabaseUploadHandler,
   createSyncError,
+  createUploadManagerDeps,
+  createUploadManagerState,
   createWebPlatformAdapter,
   defaultSchemaRouter,
+  defineBackgroundSyncTask,
   detectConflicts,
+  determineAttachmentState,
+  downloadRecord,
+  enforceCacheLimit,
+  ensureFileUri,
   extractEntityIds,
+  extractErrorCode,
   extractTableNames,
-  failedUploadStore,
   fetchServerVersion,
+  formatBytes,
+  formatCacheSize,
+  formatMigrationStats,
+  generateDLQEntryId,
   generateFailureId,
+  getCacheStatsImpl,
+  getCachedSize,
+  getEvictionCandidates,
+  getExcludeProtectedStatesCondition,
+  getExtensionFromMimeType,
+  getFailedPermanentUploads,
+  getLocalUriForStoragePath,
   getLocalVersion,
+  getMimeType,
+  getMimeTypeFromPath,
+  getPendingUploads,
+  getProtectedStatesInClause,
+  getSoonestRetryTime,
+  getStaleUploads,
+  getStateName,
+  getStorageErrorMessage,
+  getSyncedUploadsWithPendingCallback,
   hasVersionColumn,
+  initializeBackgroundSync,
+  isAudioMimeType,
+  isBackgroundSyncRegistered,
+  isBlobResult,
+  isCacheNearCapacity,
+  isDocumentMimeType,
+  isDownloadWorkflowState,
+  isFileResult,
+  isImageMimeType,
+  isLocallyAvailable,
+  isPendingDownloadState,
+  isPermanentError,
+  isProtectedUploadState,
+  isRlsError,
+  isStateTransitionAllowed,
+  isStorageAuthError,
+  isTerminalState,
+  isUploadWorkflowState,
+  isValidAttachmentState,
+  isVideoMimeType,
+  markUploadPermanentFailure,
+  markUploadSynced,
+  migrateAttachmentState,
+  migrateAttachmentStateSafe,
+  normalizeStoragePath,
+  recordMigration,
+  registerBackgroundSync,
+  resolveBucket,
+  scheduleUploadRetry,
   sleep,
+  startUploadProcessing,
+  stripFileUri,
   toSyncOperationError,
+  unregisterBackgroundSync,
+  uploadOne,
   useAttachmentQueue,
+  useAttachmentQueueContext,
+  useAttachmentQueueReady,
+  useCompletedTransactions,
   useCompletedTransactionsContext,
   useConnectionHealth,
   useConnectionStatus,
   useDatabase,
+  useDatabaseMaintenance,
   useDownloadProgress,
   useEntitySyncStatus,
+  useFailedTransactions,
   useFailedTransactionsContext,
   useIsSyncing,
   useOnlineStatus,
@@ -227,6 +493,7 @@ export {
   usePendingMutationsContext,
   usePlatform,
   usePowerSync,
+  usePowerSyncContext,
   useSyncActivity,
   useSyncActivityContext,
   useSyncControl,
@@ -234,7 +501,12 @@ export {
   useSyncMode,
   useSyncModeContext,
   useSyncStatus,
+  useSyncStatusContext,
   useUploadStatus,
+  validateSqlIdentifier2 as validateSqlIdentifier,
+  validateSqlIdentifier as validateSqlIdentifierFromStateMachine,
+  validateWhereClause,
+  watchConfigToSourceConfig,
   withExponentialBackoff
 };
 //# sourceMappingURL=index.web.js.map

package/dist/maintenance/index.d.ts

@@ -0,0 +1,118 @@
+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 { LoggerAdapter } from '../platform/index.js';
+
+/**
+ * Database Maintenance Module Types for @pol-studios/powersync
+ *
+ * This module provides types for database maintenance operations including
+ * cache inspection, compaction, integrity checking, and storage quota monitoring.
+ */
+
+/**
+ * Return type for the useDatabaseMaintenance hook.
+ * Provides utilities for inspecting and maintaining the PowerSync database.
+ */
+interface DatabaseMaintenanceUtils {
+    /**
+     * Get detailed cache statistics for all tables.
+     * Returns null if the database is not available.
+     *
+     * @returns Cache statistics including table-level details and storage info
+     */
+    getCacheStats: () => Promise<CacheStats | null>;
+    /**
+     * Compact the database by running VACUUM.
+     * This reclaims free pages and reduces the database file size.
+     *
+     * @returns Result of the compaction operation
+     */
+    compactDatabase: () => Promise<CompactResult>;
+    /**
+     * Check the integrity of the database.
+     * Runs SQLite integrity_check pragma.
+     *
+     * @returns Result indicating health status and any issues found
+     */
+    checkIntegrity: () => Promise<IntegrityResult>;
+    /**
+     * Check device storage quota and database size.
+     * Useful for warning users about low storage situations.
+     *
+     * @returns Storage quota information with status
+     */
+    checkStorageQuota: () => Promise<StorageQuota>;
+}
+
+/**
+ * Pure Database Maintenance Functions for @pol-studios/powersync
+ *
+ * This module contains stateless, pure functions for database maintenance operations.
+ * These functions can be called by hooks or used directly in other contexts.
+ *
+ * All functions accept the database as a parameter rather than accessing it from context,
+ * making them testable and reusable across different environments.
+ */
+
+/**
+ * Get detailed cache statistics for all tables in the database.
+ *
+ * This function:
+ * - Queries all tables from sqlite_master
+ * - Tries to get table sizes from dbstat (with fallback estimation)
+ * - Batches table row counts in groups of 50
+ * - Calculates storage info from PRAGMA page_size, page_count, freelist_count
+ *
+ * @param db - The PowerSync database instance
+ * @param logger - Optional logger for debug output
+ * @returns Cache statistics or null if operation times out or fails
+ */
+declare function getCacheStatsImpl(db: AbstractPowerSyncDatabase, logger?: LoggerAdapter): Promise<CacheStats | null>;
+/**
+ * Compact the database by running VACUUM.
+ * This reclaims free pages and reduces the database file size.
+ *
+ * @param db - The PowerSync database instance
+ * @returns Result of the compaction operation including bytes reclaimed
+ */
+declare function compactDatabaseImpl(db: AbstractPowerSyncDatabase): Promise<CompactResult>;
+/**
+ * Check the integrity of the database.
+ * Runs SQLite's PRAGMA integrity_check.
+ *
+ * @param db - The PowerSync database instance
+ * @returns Result indicating health status and any issues found
+ */
+declare function checkIntegrityImpl(db: AbstractPowerSyncDatabase): Promise<IntegrityResult>;
+/**
+ * Check device storage quota and database size.
+ * Useful for warning users about low storage situations.
+ *
+ * @param db - The PowerSync database instance (can be null)
+ * @param getFreeDiskSpace - Callback to get free disk space in bytes
+ * @returns Storage quota information with status
+ */
+declare function checkStorageQuotaImpl(db: AbstractPowerSyncDatabase | null, getFreeDiskSpace: () => Promise<number>): Promise<StorageQuota>;
+
+/**
+ * React Hook for Database Maintenance Utilities
+ *
+ * This module provides a React hook that wraps the pure database maintenance
+ * functions with stable function references via useCallback.
+ */
+
+/**
+ * Hook for database maintenance utilities.
+ *
+ * Use this hook when you need to perform database maintenance operations.
+ * These operations are expensive - call sparingly (e.g., settings screens).
+ *
+ * Each function has a stable reference via useCallback.
+ *
+ * @example
+ * const { getCacheStats, compactDatabase } = useDatabaseMaintenance();
+ * const stats = await getCacheStats();
+ */
+declare function useDatabaseMaintenance(): DatabaseMaintenanceUtils;
+
+export { CacheStats, CompactResult, type DatabaseMaintenanceUtils, IntegrityResult, StorageQuota, checkIntegrityImpl, checkStorageQuotaImpl, compactDatabaseImpl, getCacheStatsImpl, useDatabaseMaintenance };

package/dist/maintenance/index.js

@@ -0,0 +1,16 @@
+import {
+  checkIntegrityImpl,
+  checkStorageQuotaImpl,
+  compactDatabaseImpl,
+  getCacheStatsImpl,
+  useDatabaseMaintenance
+} from "../chunk-WGHNIAF7.js";
+import "../chunk-YSTEESEG.js";
+export {
+  checkIntegrityImpl,
+  checkStorageQuotaImpl,
+  compactDatabaseImpl,
+  getCacheStatsImpl,
+  useDatabaseMaintenance
+};
+//# sourceMappingURL=index.js.map

package/dist/maintenance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/platform/index.d.ts

@@ -1,4 +1,4 @@
-import { A as AbstractPowerSyncDatabase } from '../types-afHtE1U_.js';
+import { A as AbstractPowerSyncDatabase } from '../types-CDqWh56B.js';
 
 /**
  * Platform Adapter Types for @pol-studios/powersync
@@ -95,6 +95,21 @@ interface FileSystemAdapter {
      * Get the free disk space in bytes
      */
     getFreeDiskSpace(): Promise<number>;
+    /**
+     * Download a file from a URL directly to a local path.
+     *
+     * React Native: Uses expo-file-system downloadAsync which streams
+     * directly to disk without loading the entire file into memory,
+     * making it suitable for large files.
+     *
+     * Web: Uses fetch + blob + base64 conversion to IndexedDB. Note that
+     * the file is temporarily held in memory during conversion, so very
+     * large files (>50MB) may cause memory pressure on web platforms.
+     *
+     * @param url - The URL to download from
+     * @param localPath - The local path to save the file to
+     */
+    downloadFile(url: string, localPath: string): Promise<void>;
 }
 /**
  * Key-value storage interface for persisting preferences and state.