@pol-studios/powersync 1.0.30 → 1.0.33

package/dist/index.web.js

@@ -1,10 +1,19 @@
-import "./chunk-654ERHA7.js";
+import "./chunk-ANXWYQEJ.js";
 import {
-  SlimPowerSyncProvider,
   useAttachmentQueueContext,
   usePowerSyncContext,
   useSyncStatusContext
-} from "./chunk-RBPWEOIV.js";
+} from "./chunk-RIDSPLE5.js";
+import {
+  createSchemaRouter,
+  definePolConfig,
+  generatePowerSyncSchema,
+  getTableFromSchema,
+  getTableStrategy,
+  isProcessedPolConfig,
+  isTablePowerSync,
+  normalizeTableSpec
+} from "./chunk-HRAVPIAZ.js";
 import {
   DOWNLOAD_WORKFLOW_STATES,
   STATE_MAPPING,
@@ -16,7 +25,7 @@ import {
   buildRecordFetchQuery,
   buildWatchQuery,
   createMigrationStats,
-  createWatchIds,
+  createWatchPaths,
   extractIdsFromRows,
   formatMigrationStats,
   getStateName,
@@ -30,19 +39,17 @@ import {
   validateSqlIdentifier as validateSqlIdentifier2,
   validateWhereClause,
   watchConfigToSourceConfig
-} from "./chunk-C5ODS3XH.js";
+} from "./chunk-EOW7JK7Q.js";
+import {
+  PowerSyncErrorBoundary
+} from "./chunk-P6WOZO7H.js";
 import {
   ConflictBus,
-  OfflineDataProvider,
   PowerSyncProvider,
   ProviderBridge,
   UPLOAD_BACKOFF_DELAYS,
   UPLOAD_MAX_RETRIES
-} from "./chunk-JCGOZVWL.js";
-import "./chunk-YHTZ7VMV.js";
-import {
-  PowerSyncErrorBoundary
-} from "./chunk-P6WOZO7H.js";
+} from "./chunk-P4D6BQ4X.js";
 import {
   ATTACHMENT_TABLE,
   AbstractAttachmentQueue,
@@ -77,6 +84,7 @@ import {
   extractErrorCode,
   formatCacheSize,
   getCachedSize,
+  getCustomUrlResolver,
   getEvictionCandidates,
   getExcludeProtectedStatesCondition,
   getExtensionFromMimeType,
@@ -91,22 +99,25 @@ import {
   getSyncedUploadsWithPendingCallback,
   isAudioMimeType,
   isCacheNearCapacity,
+  isCustomSource,
   isDocumentMimeType,
   isImageMimeType,
   isLocallyAvailable,
   isPendingDownloadState,
   isPermanentError,
   isProtectedUploadState,
+  isSignedUrlSource,
   isStateTransitionAllowed,
   isVideoMimeType,
   markUploadPermanentFailure,
   markUploadSynced,
+  resolveBucketFromConfig,
   scheduleUploadRetry,
   startUploadProcessing,
   stripFileUri,
   uploadOne,
   validateSqlIdentifier
-} from "./chunk-CACKC6XG.js";
+} from "./chunk-PGEDE6IM.js";
 import {
   DeadLetterQueue,
   createDeadLetterEntry,
@@ -116,18 +127,22 @@ import {
   isBackgroundSyncRegistered,
   registerBackgroundSync,
   unregisterBackgroundSync
-} from "./chunk-A4IBBWGO.js";
+} from "./chunk-RALHHPTU.js";
 import {
+  DEFAULT_CONNECTION_HEALTH,
+  DEFAULT_SYNC_CONFIG,
+  DEFAULT_SYNC_METRICS,
+  DEFAULT_SYNC_STATUS,
   HealthMonitor,
   MetricsCollector,
   SyncStatusTracker
-} from "./chunk-RE5HWLCB.js";
+} from "./chunk-2RDWLXJW.js";
 import {
-  DEFAULT_CONNECTION_HEALTH,
-  DEFAULT_SYNC_CONFIG,
-  DEFAULT_SYNC_METRICS,
-  DEFAULT_SYNC_STATUS
-} from "./chunk-FNYQFILT.js";
+  CompletedTransactionsTable,
+  FailedTransactionsTable,
+  LOCAL_ONLY_TABLES,
+  LOCAL_TABLE_NAMES
+} from "./chunk-OGUFUZSY.js";
 import {
   checkIntegrityImpl,
   checkStorageQuotaImpl,
@@ -135,7 +150,7 @@ import {
   formatBytes,
   getCacheStatsImpl,
   useDatabaseMaintenance
-} from "./chunk-QREWE3NR.js";
+} from "./chunk-YONQYTVH.js";
 import {
   AttachmentQueueContext,
   CompletedTransactionsContext,
@@ -176,32 +191,33 @@ import {
   useUploadBlockedReason,
   useUploadRetry,
   useUploadStatus
-} from "./chunk-C2ACBYBZ.js";
+} from "./chunk-74TBHWJ4.js";
 import "./chunk-T4AO7JIG.js";
-import "./chunk-CAB26E6F.js";
+import "./chunk-TGBT5XBE.js";
+import {
+  SupabaseUploadHandler,
+  createSupabaseUploadHandler
+} from "./chunk-4665ZSE5.js";
 import {
   CacheSettingsManager,
   DEFAULT_CACHE_SETTINGS,
   createSupabaseStorage,
   isBlobResult,
   isFileResult
-} from "./chunk-XOY2CJ67.js";
+} from "./chunk-4F5B5CZ7.js";
+import {
+  DEFAULT_UPLOAD_NOTIFICATION
+} from "./chunk-ZAN22NGL.js";
 import {
   SupabaseStorageAdapter,
   createSupabaseStorageAdapter,
   getStorageErrorMessage,
   isStorageAuthError,
   normalizeStoragePath
-} from "./chunk-XAEII4ZX.js";
-import "./chunk-TGBT5XBE.js";
-import {
-  SupabaseUploadHandler,
-  createSupabaseUploadHandler
-} from "./chunk-P4HZA6ZT.js";
+} from "./chunk-NUGQOTEM.js";
 import {
-  DEFAULT_UPLOAD_NOTIFICATION,
   resolveBucket
-} from "./chunk-Z6VOBGTU.js";
+} from "./chunk-UOMHWUHV.js";
 import {
   AbortError,
   DEFAULT_BACKOFF_CONFIG,
@@ -245,7 +261,6 @@ import {
   STORAGE_KEY_SYNC_MODE,
   STORAGE_WARNING_THRESHOLD
 } from "./chunk-CGL33PL4.js";
-import "./chunk-WN5ZJ3E2.js";
 import {
   createWebPlatformAdapter
 } from "./chunk-N75DEF5J.js";
@@ -266,6 +281,7 @@ import {
   detectConflicts,
   discardOnHttpStatus,
   discardOnPgCodes,
+  discardOnRlsDenied,
   discardOrphaned,
   fetchServerVersion,
   getLocalVersion,
@@ -276,7 +292,7 @@ import {
   runUploadErrorMiddlewareSync,
   successOnPgCodes,
   tableHandlers
-} from "./chunk-BC2SRII2.js";
+} from "./chunk-65A3SYJZ.js";
 import {
   AttachmentError,
   ConfigurationError,
@@ -295,6 +311,7 @@ import {
   isRlsError,
   toSyncOperationError
 } from "./chunk-I2AYMY5O.js";
+import "./chunk-5WRI5ZAA.js";
 export {
   ATTACHMENT_DOWNLOAD_TIMEOUT_MS,
   ATTACHMENT_RETRY_DELAY_MS,
@@ -314,6 +331,7 @@ export {
   CircuitBreaker,
   CircuitOpenError,
   CompletedTransactionsContext,
+  CompletedTransactionsTable,
   ConfigurationError,
   ConflictBus,
   ConflictDetectionError,
@@ -350,15 +368,17 @@ export {
   EVICTION_TRIGGER_THRESHOLD,
   EncodingType,
   FailedTransactionsContext,
+  FailedTransactionsTable,
   HEALTH_CHECK_INTERVAL_MS,
   HEALTH_CHECK_TIMEOUT_MS,
   HealthMonitor,
   InitializationError,
   LATENCY_DEGRADED_THRESHOLD_MS,
   LOCALLY_AVAILABLE_STATES,
+  LOCAL_ONLY_TABLES,
+  LOCAL_TABLE_NAMES,
   MAX_CONSECUTIVE_FAILURES,
   MetricsCollector,
-  OfflineDataProvider,
   PENDING_DOWNLOAD_STATES,
   PROTECTED_UPLOAD_STATES,
   PendingMutationsContext,
@@ -385,7 +405,6 @@ export {
   STORAGE_KEY_PREFIX,
   STORAGE_KEY_SYNC_MODE,
   STORAGE_WARNING_THRESHOLD,
-  SlimPowerSyncProvider,
   SupabaseConnector,
   SupabaseStorageAdapter,
   SupabaseUploadHandler,
@@ -420,6 +439,7 @@ export {
   createDeadLetterEntry,
   createMigrationStats,
   createPolAttachmentQueue,
+  createSchemaRouter,
   createSupabaseAuth,
   createSupabaseStorage,
   createSupabaseStorageAdapter,
@@ -427,14 +447,16 @@ export {
   createSyncError,
   createUploadManagerDeps,
   createUploadManagerState,
-  createWatchIds,
+  createWatchPaths,
   createWebPlatformAdapter,
   defaultSchemaRouter,
   defineBackgroundSyncTask,
+  definePolConfig,
   detectConflicts,
   determineAttachmentState,
   discardOnHttpStatus,
   discardOnPgCodes,
+  discardOnRlsDenied,
   discardOrphaned,
   downloadRecord,
   enforceCacheLimit,
@@ -450,8 +472,10 @@ export {
   formatMigrationStats,
   generateDLQEntryId,
   generateFailureId,
+  generatePowerSyncSchema,
   getCacheStatsImpl,
   getCachedSize,
+  getCustomUrlResolver,
   getEvictionCandidates,
   getExcludeProtectedStatesCondition,
   getExtensionFromMimeType,
@@ -467,6 +491,8 @@ export {
   getStateName,
   getStorageErrorMessage,
   getSyncedUploadsWithPendingCallback,
+  getTableFromSchema,
+  getTableStrategy,
   hasVersionColumn,
   idempotentTables,
   initializeBackgroundSync,
@@ -474,6 +500,7 @@ export {
   isBackgroundSyncRegistered,
   isBlobResult,
   isCacheNearCapacity,
+  isCustomSource,
   isDocumentMimeType,
   isDownloadWorkflowState,
   isFileResult,
@@ -481,10 +508,13 @@ export {
   isLocallyAvailable,
   isPendingDownloadState,
   isPermanentError,
+  isProcessedPolConfig,
   isProtectedUploadState,
   isRlsError,
+  isSignedUrlSource,
   isStateTransitionAllowed,
   isStorageAuthError,
+  isTablePowerSync,
   isTerminalState,
   isUploadWorkflowState,
   isValidAttachmentState,
@@ -494,9 +524,11 @@ export {
   migrateAttachmentState,
   migrateAttachmentStateSafe,
   normalizeStoragePath,
+  normalizeTableSpec,
   recordMigration,
   registerBackgroundSync,
   resolveBucket,
+  resolveBucketFromConfig,
   retryOnHttpStatus,
   runUploadErrorMiddleware,
   runUploadErrorMiddlewareSync,

package/dist/maintenance/index.d.ts

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

package/dist/maintenance/index.js

@@ -4,8 +4,9 @@ import {
   compactDatabaseImpl,
   getCacheStatsImpl,
   useDatabaseMaintenance
-} from "../chunk-QREWE3NR.js";
-import "../chunk-C2ACBYBZ.js";
+} from "../chunk-YONQYTVH.js";
+import "../chunk-74TBHWJ4.js";
+import "../chunk-5WRI5ZAA.js";
 export {
   checkIntegrityImpl,
   checkStorageQuotaImpl,

package/dist/platform/index.d.ts

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

package/dist/platform/index.js

@@ -1,3 +1,5 @@
+import "../chunk-5WRI5ZAA.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   * 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":[]}
+{"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,5 +1,5 @@
 import { LoggerAdapter, PlatformAdapter } from './index.js';
-import '../types-Dv1uf0LZ.js';
+import '../types-B9MptP7E.js';
 
 /**
  * React Native Platform Adapter for @pol-studios/powersync

package/dist/platform/index.native.js

@@ -1,6 +1,7 @@
 import {
   createNativePlatformAdapter
 } from "../chunk-WN5ZJ3E2.js";
+import "../chunk-5WRI5ZAA.js";
 export {
   createNativePlatformAdapter
 };

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

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

package/dist/platform/index.web.js

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