@pol-studios/powersync 1.0.7 → 1.0.11

package/dist/index.web.js

@@ -1,11 +1,41 @@
-import "./chunk-KGSFAE5B.js";
-import "./chunk-GKF7TOMT.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-BREGB4WL.js";
+} from "./chunk-BRXQNASY.js";
+import "./chunk-YHTZ7VMV.js";
 import {
   PowerSyncErrorBoundary
 } from "./chunk-P6WOZO7H.js";
@@ -14,16 +44,65 @@ import {
   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,
-  createPolAttachmentQueue
-} from "./chunk-ZEOKPWUC.js";
+  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,
@@ -35,14 +114,16 @@ import {
   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";
+} from "./chunk-CUCAYK7Z.js";
+import {
+  DEFAULT_CONNECTION_HEALTH,
+  DEFAULT_SYNC_CONFIG,
+  DEFAULT_SYNC_METRICS,
+  DEFAULT_SYNC_STATUS
+} from "./chunk-24RDMMCL.js";
 import {
   checkIntegrityImpl,
   checkStorageQuotaImpl,
@@ -89,29 +170,31 @@ import {
   useSyncStatus,
   useUploadStatus
 } from "./chunk-YSTEESEG.js";
-import "./chunk-LNL64IJZ.js";
+import "./chunk-T4AO7JIG.js";
+import "./chunk-CAB26E6F.js";
 import {
   CacheSettingsManager,
   DEFAULT_CACHE_SETTINGS,
+  createSupabaseStorage,
+  isBlobResult,
+  isFileResult
+} from "./chunk-XOY2CJ67.js";
+import {
   SupabaseStorageAdapter,
   createSupabaseStorageAdapter,
-  getExtensionFromMimeType,
-  getMimeType,
-  getMimeTypeFromPath,
-  isAudioMimeType,
-  isDocumentMimeType,
-  isImageMimeType,
-  isVideoMimeType
-} from "./chunk-WQ5MPAVC.js";
+  getStorageErrorMessage,
+  isStorageAuthError,
+  normalizeStoragePath
+} from "./chunk-XAEII4ZX.js";
 import "./chunk-TGBT5XBE.js";
 import {
   SupabaseUploadHandler,
   createSupabaseUploadHandler
-} from "./chunk-UEYRTLKE.js";
+} from "./chunk-P4HZA6ZT.js";
 import {
   DEFAULT_UPLOAD_NOTIFICATION,
-  resolveBucketFromConfig
-} from "./chunk-MKD2VCX3.js";
+  resolveBucket
+} from "./chunk-Z6VOBGTU.js";
 import "./chunk-W7HSR35B.js";
 import {
   ATTACHMENT_DOWNLOAD_TIMEOUT_MS,
@@ -146,15 +229,17 @@ import {
   STORAGE_KEY_SYNC_MODE,
   STORAGE_WARNING_THRESHOLD
 } from "./chunk-CGL33PL4.js";
-import "./chunk-53WH2JJV.js";
+import "./chunk-WN5ZJ3E2.js";
 import {
   createWebPlatformAdapter
 } from "./chunk-N75DEF5J.js";
 import {
+  AuthRefreshError,
   CircuitBreaker,
   CircuitOpenError,
-  DEFAULT_CIRCUIT_BREAKER_CONFIG
-} from "./chunk-4C3RY5SU.js";
+  DEFAULT_CIRCUIT_BREAKER_CONFIG,
+  createSupabaseAuth
+} from "./chunk-HWSNV45P.js";
 import {
   ConflictDetectionError,
   DEFAULT_RETRY_CONFIG,
@@ -164,7 +249,7 @@ import {
   fetchServerVersion,
   getLocalVersion,
   hasVersionColumn
-} from "./chunk-HFOFLW5F.js";
+} from "./chunk-KN2IZERF.js";
 import {
   AbortError,
   DEFAULT_BACKOFF_CONFIG,
@@ -188,9 +273,9 @@ import {
   extractEntityIds,
   extractTableNames,
   generateFailureId,
+  isRlsError,
   toSyncOperationError
-} from "./chunk-XQAJM2MW.js";
-import "./chunk-DGUM43GV.js";
+} from "./chunk-VACPAAQZ.js";
 export {
   ATTACHMENT_DOWNLOAD_TIMEOUT_MS,
   ATTACHMENT_RETRY_DELAY_MS,
@@ -201,6 +286,8 @@ export {
   AttachmentQueueContext,
   AttachmentState,
   AttachmentTable,
+  AuthRefreshError,
+  CACHE_SIZE_PRESETS,
   COMPRESSION_MAX_WIDTH,
   COMPRESSION_SKIP_SIZE_BYTES,
   COMPRESSION_TARGET_SIZE_BYTES,
@@ -224,6 +311,7 @@ export {
   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,
@@ -237,6 +325,7 @@ export {
   DEFAULT_UPLOAD_CONFIG,
   DEFAULT_UPLOAD_NOTIFICATION,
   DOWNLOAD_STOP_THRESHOLD,
+  DOWNLOAD_WORKFLOW_STATES,
   DeadLetterQueue,
   EVICTION_TRIGGER_THRESHOLD,
   EncodingType,
@@ -246,9 +335,12 @@ export {
   HealthMonitor,
   InitializationError,
   LATENCY_DEGRADED_THRESHOLD_MS,
+  LOCALLY_AVAILABLE_STATES,
   MAX_CONSECUTIVE_FAILURES,
   MetricsCollector,
   OfflineDataProvider,
+  PENDING_DOWNLOAD_STATES,
+  PROTECTED_UPLOAD_STATES,
   PendingMutationsContext,
   PlatformAdapterError,
   PolAttachmentQueue,
@@ -260,6 +352,8 @@ export {
   PowerSyncProvider,
   ProviderBridge,
   RetryExhaustedError,
+  STATE_MAPPING,
+  STATE_NAMES,
   STATS_CACHE_TTL_MS,
   STATUS_NOTIFY_THROTTLE_MS,
   STORAGE_CRITICAL_THRESHOLD,
@@ -271,6 +365,7 @@ export {
   STORAGE_KEY_PREFIX,
   STORAGE_KEY_SYNC_MODE,
   STORAGE_WARNING_THRESHOLD,
+  SlimPowerSyncProvider,
   SupabaseConnector,
   SupabaseStorageAdapter,
   SupabaseUploadHandler,
@@ -280,46 +375,107 @@ export {
   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,
   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,
-  resolveBucketFromConfig,
+  resolveBucket,
+  scheduleUploadRetry,
   sleep,
+  startUploadProcessing,
+  stripFileUri,
   toSyncOperationError,
   unregisterBackgroundSync,
+  uploadOne,
   useAttachmentQueue,
+  useAttachmentQueueContext,
   useAttachmentQueueReady,
   useCompletedTransactions,
   useCompletedTransactionsContext,
@@ -337,6 +493,7 @@ export {
   usePendingMutationsContext,
   usePlatform,
   usePowerSync,
+  usePowerSyncContext,
   useSyncActivity,
   useSyncActivityContext,
   useSyncControl,
@@ -344,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.js

@@ -6,7 +6,6 @@ import {
   useDatabaseMaintenance
 } from "../chunk-WGHNIAF7.js";
 import "../chunk-YSTEESEG.js";
-import "../chunk-DGUM43GV.js";
 export {
   checkIntegrityImpl,
   checkStorageQuotaImpl,

package/dist/platform/index.js

@@ -1,5 +1,3 @@
-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   * 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.js

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

package/dist/platform/index.web.js

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