@pol-studios/powersync 1.0.6 → 1.0.7

package/dist/index.web.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,37 +138,42 @@ 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-53WH2JJV.js";
 import {
   createWebPlatformAdapter
-} from "./chunk-7EMDVIZX.js";
-import "./chunk-VJCL2SWD.js";
+} from "./chunk-N75DEF5J.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,
@@ -126,32 +189,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,
@@ -162,10 +234,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,
@@ -173,16 +248,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,
@@ -190,6 +272,8 @@ export {
   STORAGE_KEY_SYNC_MODE,
   STORAGE_WARNING_THRESHOLD,
   SupabaseConnector,
+  SupabaseStorageAdapter,
+  SupabaseUploadHandler,
   SyncActivityContext,
   SyncMetricsContext,
   SyncModeContext,
@@ -198,28 +282,54 @@ export {
   SyncStatusTracker,
   addJitter,
   calculateBackoffDelay,
+  checkIntegrityImpl,
+  checkStorageQuotaImpl,
   classifyError,
   classifySupabaseError,
+  compactDatabaseImpl,
+  createDeadLetterEntry,
+  createPolAttachmentQueue,
+  createSupabaseStorageAdapter,
+  createSupabaseUploadHandler,
   createSyncError,
   createWebPlatformAdapter,
   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/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,17 @@
+import {
+  checkIntegrityImpl,
+  checkStorageQuotaImpl,
+  compactDatabaseImpl,
+  getCacheStatsImpl,
+  useDatabaseMaintenance
+} from "../chunk-WGHNIAF7.js";
+import "../chunk-YSTEESEG.js";
+import "../chunk-DGUM43GV.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.

package/dist/platform/index.js

@@ -1,3 +1,5 @@
+import "../chunk-DGUM43GV.js";
+
 // src/platform/types.ts
 function detectPlatform() {
   if (typeof navigator !== "undefined" && navigator.product === "ReactNative") {

package/dist/platform/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/platform/types.ts"],"sourcesContent":["/**\n * Platform Adapter Types for @pol-studios/powersync\n *\n * This module defines the interfaces that platform-specific adapters must implement.\n * Consumers provide an adapter for their platform (React Native or Web) that handles\n * platform-specific operations like file system access, async storage, and network status.\n */\n\nimport type { AbstractPowerSyncDatabase } from '../core/types';\n\n// ─── Database Factory Options ────────────────────────────────────────────────\n\n/**\n * Options for creating a PowerSync database instance\n */\nexport interface DatabaseOptions {\n  /** Database file name (e.g., \"pol-offline.db\") */\n  dbFilename: string;\n  /** PowerSync schema definition */\n  schema: unknown; // Schema type from @powersync/common\n  /** Optional: Encryption key for SQLite */\n  encryptionKey?: string;\n}\n\n// ─── File System Adapter ─────────────────────────────────────────────────────\n\n/**\n * Information about a file or directory\n */\nexport interface FileInfo {\n  /** Whether the file/directory exists */\n  exists: boolean;\n  /** Size in bytes (0 for directories) */\n  size: number;\n  /** Last modification time */\n  modificationTime?: Date;\n  /** Whether this is a directory */\n  isDirectory: boolean;\n}\n\n/**\n * File system operations interface.\n *\n * React Native: Implemented using expo-file-system\n * Web: Implemented using IndexedDB or Cache API\n */\nexport interface FileSystemAdapter {\n  /**\n   * Read a file's contents\n   * @param uri - The file URI/path\n   * @param encoding - How to encode the result ('base64' or 'utf8')\n   */\n  readFile(uri: string, encoding?: 'base64' | 'utf8'): Promise<string>;\n\n  /**\n   * Write data to a file (creates parent directories if needed)\n   * @param uri - The file URI/path\n   * @param data - The data to write\n   * @param encoding - How the data is encoded ('base64' or 'utf8')\n   */\n  writeFile(uri: string, data: string, encoding?: 'base64' | 'utf8'): Promise<void>;\n\n  /**\n   * Delete a file\n   * @param uri - The file URI/path\n   */\n  deleteFile(uri: string): Promise<void>;\n\n  /**\n   * Copy a file from source to destination\n   * @param source - Source file URI/path\n   * @param destination - Destination file URI/path\n   */\n  copyFile(source: string, destination: string): Promise<void>;\n\n  /**\n   * Move a file from source to destination\n   * @param source - Source file URI/path\n   * @param destination - Destination file URI/path\n   */\n  moveFile(source: string, destination: string): Promise<void>;\n\n  /**\n   * Get information about a file or directory\n   * @param uri - The file URI/path\n   * @returns File info or null if it doesn't exist\n   */\n  getFileInfo(uri: string): Promise<FileInfo | null>;\n\n  /**\n   * Create a directory\n   * @param uri - The directory URI/path\n   * @param options - Options for directory creation\n   */\n  makeDirectory(uri: string, options?: {\n    intermediates?: boolean;\n  }): Promise<void>;\n\n  /**\n   * Get the documents directory path for this platform\n   */\n  getDocumentsDirectory(): string;\n\n  /**\n   * Get the cache directory path for this platform\n   */\n  getCacheDirectory(): string;\n\n  /**\n   * Get the free disk space in bytes\n   */\n  getFreeDiskSpace(): Promise<number>;\n}\n\n// ─── Async Storage Adapter ───────────────────────────────────────────────────\n\n/**\n * Key-value storage interface for persisting preferences and state.\n *\n * React Native: Implemented using @react-native-async-storage/async-storage\n * Web: Implemented using localStorage\n */\nexport interface AsyncStorageAdapter {\n  /**\n   * Get a value by key\n   * @param key - The storage key\n   * @returns The stored value or null if not found\n   */\n  getItem(key: string): Promise<string | null>;\n\n  /**\n   * Set a value by key\n   * @param key - The storage key\n   * @param value - The value to store\n   */\n  setItem(key: string, value: string): Promise<void>;\n\n  /**\n   * Remove a value by key\n   * @param key - The storage key\n   */\n  removeItem(key: string): Promise<void>;\n\n  /**\n   * Get multiple values by keys\n   * @param keys - Array of storage keys\n   * @returns Array of [key, value] tuples\n   */\n  multiGet(keys: string[]): Promise<[string, string | null][]>;\n\n  /**\n   * Set multiple values\n   * @param entries - Array of [key, value] tuples\n   */\n  multiSet(entries: [string, string][]): Promise<void>;\n}\n\n// ─── Network Adapter ─────────────────────────────────────────────────────────\n\n/** Network connection types */\nexport type ConnectionType = 'wifi' | 'cellular' | 'ethernet' | 'unknown' | 'none';\n\n/**\n * Network connectivity monitoring interface.\n *\n * React Native: Implemented using @react-native-community/netinfo\n * Web: Implemented using navigator.onLine + online/offline events\n */\nexport interface NetworkAdapter {\n  /**\n   * Check if the device is currently connected to the internet\n   */\n  isConnected(): Promise<boolean>;\n\n  /**\n   * Get the current connection type\n   */\n  getConnectionType(): Promise<ConnectionType>;\n\n  /**\n   * Add a listener for connection status changes\n   * @param callback - Called when connection status changes\n   * @returns Unsubscribe function\n   */\n  addConnectionListener(callback: (isConnected: boolean) => void): () => void;\n}\n\n// ─── Logger Adapter ──────────────────────────────────────────────────────────\n\n/**\n * Logging interface for debugging and monitoring.\n * Allows consumers to use their existing logging infrastructure.\n */\nexport interface LoggerAdapter {\n  /**\n   * Log a debug message (verbose, for development)\n   */\n  debug(message: string, ...args: unknown[]): void;\n\n  /**\n   * Log an info message (general information)\n   */\n  info(message: string, ...args: unknown[]): void;\n\n  /**\n   * Log a warning message (potential issues)\n   */\n  warn(message: string, ...args: unknown[]): void;\n\n  /**\n   * Log an error message (failures)\n   */\n  error(message: string, ...args: unknown[]): void;\n}\n\n// ─── Image Processor Adapter ─────────────────────────────────────────────────\n\n/**\n * Result of an image compression operation\n */\nexport interface CompressedImage {\n  /** URI/path to the compressed image */\n  uri: string;\n  /** Width of the compressed image in pixels */\n  width: number;\n  /** Height of the compressed image in pixels */\n  height: number;\n}\n\n/**\n * Options for image compression\n */\nexport interface CompressionOptions {\n  /** Compression quality (0.0 to 1.0, where 1.0 is best quality) */\n  quality: number;\n  /** Maximum width in pixels (will scale down if larger) */\n  maxWidth?: number;\n  /** Maximum height in pixels (will scale down if larger) */\n  maxHeight?: number;\n  /** Output format */\n  format?: 'jpeg' | 'png' | 'webp';\n}\n\n/**\n * Image processing interface for attachment compression.\n *\n * React Native: Implemented using expo-image-manipulator\n * Web: Implemented using canvas API\n *\n * This is optional - if not provided, attachments won't be compressed.\n */\nexport interface ImageProcessorAdapter {\n  /**\n   * Compress an image\n   * @param uri - The source image URI/path\n   * @param options - Compression options\n   * @returns The compressed image result\n   */\n  compress(uri: string, options: CompressionOptions): Promise<CompressedImage>;\n}\n\n// ─── Main Platform Adapter Interface ─────────────────────────────────────────\n\n/**\n * Platform-specific adapter that consumers must provide.\n * This allows the package to work across React Native and Web.\n *\n * @example React Native\n * ```typescript\n * import { createNativePlatformAdapter } from '@pol-studios/powersync/platform';\n *\n * const platform = createNativePlatformAdapter(logger);\n * ```\n *\n * @example Web\n * ```typescript\n * import { createWebPlatformAdapter } from '@pol-studios/powersync/platform';\n *\n * const platform = createWebPlatformAdapter(logger);\n * ```\n */\nexport interface PlatformAdapter {\n  /**\n   * Create a PowerSync database instance for this platform.\n   *\n   * React Native: Uses PowerSyncDatabase from @powersync/react-native\n   * Web: Uses PowerSyncDatabase from @powersync/web\n   *\n   * @param options - Database creation options\n   * @returns Initialized PowerSync database\n   */\n  createDatabase(options: DatabaseOptions): Promise<AbstractPowerSyncDatabase>;\n\n  /**\n   * File system operations for attachment caching.\n   */\n  fileSystem: FileSystemAdapter;\n\n  /**\n   * Key-value storage for preferences and metrics persistence.\n   */\n  storage: AsyncStorageAdapter;\n\n  /**\n   * Network connectivity monitoring.\n   */\n  network: NetworkAdapter;\n\n  /**\n   * Logging interface.\n   */\n  logger: LoggerAdapter;\n\n  /**\n   * Optional: Image compression for attachment optimization.\n   * If not provided, attachments won't be compressed.\n   */\n  imageProcessor?: ImageProcessorAdapter;\n}\n\n// ─── Platform Detection ──────────────────────────────────────────────────────\n\n/** Supported platform types */\nexport type PlatformType = 'react-native' | 'web' | 'unknown';\n\n/**\n * Detect the current platform based on environment\n */\nexport function detectPlatform(): PlatformType {\n  // Check for React Native\n  if (typeof navigator !== 'undefined' && navigator.product === 'ReactNative') {\n    return 'react-native';\n  }\n\n  // Check for browser environment\n  if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n    return 'web';\n  }\n  return 'unknown';\n}"],"mappings":";AAwUO,SAAS,iBAA+B;AAE7C,MAAI,OAAO,cAAc,eAAe,UAAU,YAAY,eAAe;AAC3E,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,WAAW,eAAe,OAAO,aAAa,aAAa;AACpE,WAAO;AAAA,EACT;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/platform/types.ts"],"sourcesContent":["/**\n * Platform Adapter Types for @pol-studios/powersync\n *\n * This module defines the interfaces that platform-specific adapters must implement.\n * Consumers provide an adapter for their platform (React Native or Web) that handles\n * platform-specific operations like file system access, async storage, and network status.\n */\n\nimport type { AbstractPowerSyncDatabase } from '../core/types';\n\n// ─── Database Factory Options ────────────────────────────────────────────────\n\n/**\n * Options for creating a PowerSync database instance\n */\nexport interface DatabaseOptions {\n  /** Database file name (e.g., \"pol-offline.db\") */\n  dbFilename: string;\n  /** PowerSync schema definition */\n  schema: unknown; // Schema type from @powersync/common\n  /** Optional: Encryption key for SQLite */\n  encryptionKey?: string;\n}\n\n// ─── File System Adapter ─────────────────────────────────────────────────────\n\n/**\n * Information about a file or directory\n */\nexport interface FileInfo {\n  /** Whether the file/directory exists */\n  exists: boolean;\n  /** Size in bytes (0 for directories) */\n  size: number;\n  /** Last modification time */\n  modificationTime?: Date;\n  /** Whether this is a directory */\n  isDirectory: boolean;\n}\n\n/**\n * File system operations interface.\n *\n * React Native: Implemented using expo-file-system\n * Web: Implemented using IndexedDB or Cache API\n */\nexport interface FileSystemAdapter {\n  /**\n   * Read a file's contents\n   * @param uri - The file URI/path\n   * @param encoding - How to encode the result ('base64' or 'utf8')\n   */\n  readFile(uri: string, encoding?: 'base64' | 'utf8'): Promise<string>;\n\n  /**\n   * Write data to a file (creates parent directories if needed)\n   * @param uri - The file URI/path\n   * @param data - The data to write\n   * @param encoding - How the data is encoded ('base64' or 'utf8')\n   */\n  writeFile(uri: string, data: string, encoding?: 'base64' | 'utf8'): Promise<void>;\n\n  /**\n   * Delete a file\n   * @param uri - The file URI/path\n   */\n  deleteFile(uri: string): Promise<void>;\n\n  /**\n   * Copy a file from source to destination\n   * @param source - Source file URI/path\n   * @param destination - Destination file URI/path\n   */\n  copyFile(source: string, destination: string): Promise<void>;\n\n  /**\n   * Move a file from source to destination\n   * @param source - Source file URI/path\n   * @param destination - Destination file URI/path\n   */\n  moveFile(source: string, destination: string): Promise<void>;\n\n  /**\n   * Get information about a file or directory\n   * @param uri - The file URI/path\n   * @returns File info or null if it doesn't exist\n   */\n  getFileInfo(uri: string): Promise<FileInfo | null>;\n\n  /**\n   * Create a directory\n   * @param uri - The directory URI/path\n   * @param options - Options for directory creation\n   */\n  makeDirectory(uri: string, options?: {\n    intermediates?: boolean;\n  }): Promise<void>;\n\n  /**\n   * Get the documents directory path for this platform\n   */\n  getDocumentsDirectory(): string;\n\n  /**\n   * Get the cache directory path for this platform\n   */\n  getCacheDirectory(): string;\n\n  /**\n   * Get the free disk space in bytes\n   */\n  getFreeDiskSpace(): Promise<number>;\n\n  /**\n   * Download a file from a URL directly to a local path.\n   *\n   * React Native: Uses expo-file-system downloadAsync which streams\n   * directly to disk without loading the entire file into memory,\n   * making it suitable for large files.\n   *\n   * Web: Uses fetch + blob + base64 conversion to IndexedDB. Note that\n   * the file is temporarily held in memory during conversion, so very\n   * large files (>50MB) may cause memory pressure on web platforms.\n   *\n   * @param url - The URL to download from\n   * @param localPath - The local path to save the file to\n   */\n  downloadFile(url: string, localPath: string): Promise<void>;\n}\n\n// ─── Async Storage Adapter ───────────────────────────────────────────────────\n\n/**\n * Key-value storage interface for persisting preferences and state.\n *\n * React Native: Implemented using @react-native-async-storage/async-storage\n * Web: Implemented using localStorage\n */\nexport interface AsyncStorageAdapter {\n  /**\n   * Get a value by key\n   * @param key - The storage key\n   * @returns The stored value or null if not found\n   */\n  getItem(key: string): Promise<string | null>;\n\n  /**\n   * Set a value by key\n   * @param key - The storage key\n   * @param value - The value to store\n   */\n  setItem(key: string, value: string): Promise<void>;\n\n  /**\n   * Remove a value by key\n   * @param key - The storage key\n   */\n  removeItem(key: string): Promise<void>;\n\n  /**\n   * Get multiple values by keys\n   * @param keys - Array of storage keys\n   * @returns Array of [key, value] tuples\n   */\n  multiGet(keys: string[]): Promise<[string, string | null][]>;\n\n  /**\n   * Set multiple values\n   * @param entries - Array of [key, value] tuples\n   */\n  multiSet(entries: [string, string][]): Promise<void>;\n}\n\n// ─── Network Adapter ─────────────────────────────────────────────────────────\n\n/** Network connection types */\nexport type ConnectionType = 'wifi' | 'cellular' | 'ethernet' | 'unknown' | 'none';\n\n/**\n * Network connectivity monitoring interface.\n *\n * React Native: Implemented using @react-native-community/netinfo\n * Web: Implemented using navigator.onLine + online/offline events\n */\nexport interface NetworkAdapter {\n  /**\n   * Check if the device is currently connected to the internet\n   */\n  isConnected(): Promise<boolean>;\n\n  /**\n   * Get the current connection type\n   */\n  getConnectionType(): Promise<ConnectionType>;\n\n  /**\n   * Add a listener for connection status changes\n   * @param callback - Called when connection status changes\n   * @returns Unsubscribe function\n   */\n  addConnectionListener(callback: (isConnected: boolean) => void): () => void;\n}\n\n// ─── Logger Adapter ──────────────────────────────────────────────────────────\n\n/**\n * Logging interface for debugging and monitoring.\n * Allows consumers to use their existing logging infrastructure.\n */\nexport interface LoggerAdapter {\n  /**\n   * Log a debug message (verbose, for development)\n   */\n  debug(message: string, ...args: unknown[]): void;\n\n  /**\n   * Log an info message (general information)\n   */\n  info(message: string, ...args: unknown[]): void;\n\n  /**\n   * Log a warning message (potential issues)\n   */\n  warn(message: string, ...args: unknown[]): void;\n\n  /**\n   * Log an error message (failures)\n   */\n  error(message: string, ...args: unknown[]): void;\n}\n\n// ─── Image Processor Adapter ─────────────────────────────────────────────────\n\n/**\n * Result of an image compression operation\n */\nexport interface CompressedImage {\n  /** URI/path to the compressed image */\n  uri: string;\n  /** Width of the compressed image in pixels */\n  width: number;\n  /** Height of the compressed image in pixels */\n  height: number;\n}\n\n/**\n * Options for image compression\n */\nexport interface CompressionOptions {\n  /** Compression quality (0.0 to 1.0, where 1.0 is best quality) */\n  quality: number;\n  /** Maximum width in pixels (will scale down if larger) */\n  maxWidth?: number;\n  /** Maximum height in pixels (will scale down if larger) */\n  maxHeight?: number;\n  /** Output format */\n  format?: 'jpeg' | 'png' | 'webp';\n}\n\n/**\n * Image processing interface for attachment compression.\n *\n * React Native: Implemented using expo-image-manipulator\n * Web: Implemented using canvas API\n *\n * This is optional - if not provided, attachments won't be compressed.\n */\nexport interface ImageProcessorAdapter {\n  /**\n   * Compress an image\n   * @param uri - The source image URI/path\n   * @param options - Compression options\n   * @returns The compressed image result\n   */\n  compress(uri: string, options: CompressionOptions): Promise<CompressedImage>;\n}\n\n// ─── Main Platform Adapter Interface ─────────────────────────────────────────\n\n/**\n * Platform-specific adapter that consumers must provide.\n * This allows the package to work across React Native and Web.\n *\n * @example React Native\n * ```typescript\n * import { createNativePlatformAdapter } from '@pol-studios/powersync/platform';\n *\n * const platform = createNativePlatformAdapter(logger);\n * ```\n *\n * @example Web\n * ```typescript\n * import { createWebPlatformAdapter } from '@pol-studios/powersync/platform';\n *\n * const platform = createWebPlatformAdapter(logger);\n * ```\n */\nexport interface PlatformAdapter {\n  /**\n   * Create a PowerSync database instance for this platform.\n   *\n   * React Native: Uses PowerSyncDatabase from @powersync/react-native\n   * Web: Uses PowerSyncDatabase from @powersync/web\n   *\n   * @param options - Database creation options\n   * @returns Initialized PowerSync database\n   */\n  createDatabase(options: DatabaseOptions): Promise<AbstractPowerSyncDatabase>;\n\n  /**\n   * File system operations for attachment caching.\n   */\n  fileSystem: FileSystemAdapter;\n\n  /**\n   * Key-value storage for preferences and metrics persistence.\n   */\n  storage: AsyncStorageAdapter;\n\n  /**\n   * Network connectivity monitoring.\n   */\n  network: NetworkAdapter;\n\n  /**\n   * Logging interface.\n   */\n  logger: LoggerAdapter;\n\n  /**\n   * Optional: Image compression for attachment optimization.\n   * If not provided, attachments won't be compressed.\n   */\n  imageProcessor?: ImageProcessorAdapter;\n}\n\n// ─── Platform Detection ──────────────────────────────────────────────────────\n\n/** Supported platform types */\nexport type PlatformType = 'react-native' | 'web' | 'unknown';\n\n/**\n * Detect the current platform based on environment\n */\nexport function detectPlatform(): PlatformType {\n  // Check for React Native\n  if (typeof navigator !== 'undefined' && navigator.product === 'ReactNative') {\n    return 'react-native';\n  }\n\n  // Check for browser environment\n  if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n    return 'web';\n  }\n  return 'unknown';\n}"],"mappings":";;;AAwVO,SAAS,iBAA+B;AAE7C,MAAI,OAAO,cAAc,eAAe,UAAU,YAAY,eAAe;AAC3E,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,WAAW,eAAe,OAAO,aAAa,aAAa;AACpE,WAAO;AAAA,EACT;AACA,SAAO;AACT;","names":[]}

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

@@ -1,12 +1,12 @@
 import { LoggerAdapter, PlatformAdapter } from './index.js';
-import '../types-afHtE1U_.js';
+import '../types-CDqWh56B.js';
 
 /**
  * React Native Platform Adapter for @pol-studios/powersync
  *
  * Implements the PlatformAdapter interface using React Native specific APIs:
  * - @powersync/react-native for SQLite database
- * - expo-file-system for file operations
+ * - expo-file-system for file operations (new class-based API)
  * - @react-native-async-storage/async-storage for key-value storage
  * - @react-native-community/netinfo for network monitoring
  * - expo-image-manipulator for image compression

package/dist/platform/index.native.js

@@ -1,6 +1,7 @@
 import {
   createNativePlatformAdapter
-} from "../chunk-3AYXHQ4W.js";
+} from "../chunk-53WH2JJV.js";
+import "../chunk-DGUM43GV.js";
 export {
   createNativePlatformAdapter
 };

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

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

package/dist/platform/index.web.js

@@ -1,6 +1,7 @@
 import {
   createWebPlatformAdapter
-} from "../chunk-7EMDVIZX.js";
+} from "../chunk-N75DEF5J.js";
+import "../chunk-DGUM43GV.js";
 export {
   createWebPlatformAdapter
 };