@pol-studios/powersync 1.0.25 → 1.0.32

package/README.md

@@ -512,7 +512,6 @@ function FailedUploads() {
     permanentErrorCount,
     retryFailure,
     clearFailure,
-    clearAllFailures,
   } = useFailedTransactionsContext();
 
   if (!hasUploadErrors) return null;

package/dist/{CacheSettingsManager-uz-kbnRH.d.ts → CacheSettingsManager-0H_7thHW.d.ts}

@@ -1,4 +1,4 @@
-import { c as SupabaseStorageOptions, a as StorageBackend, D as DownloadResult, S as SupabaseStorage, d as SupabaseClient } from './types-D0WcHrq6.js';
+import { c as SupabaseStorageOptions, a as StorageBackend, D as DownloadResult, S as SupabaseStorage, d as SupabaseClient } from './types-CGMibJKD.js';
 import { LoggerAdapter, FileSystemAdapter, AsyncStorageAdapter } from './platform/index.js';
 
 /**
@@ -202,6 +202,17 @@ interface SupabaseStorageAdapterOptions {
     logger?: LoggerAdapter;
     /** Image transform options for compression on download */
     imageTransform?: ImageTransformOptions;
+    /**
+     * Whether to use signed URLs for downloads (default: true).
+     * Set to false for public buckets to use getPublicUrl instead of createSignedUrl.
+     * This avoids rate limits and simplifies access for public assets.
+     */
+    useSignedUrls?: boolean;
+    /**
+     * Custom URL resolver for non-Supabase backends.
+     * When provided, getDownloadUrl will use this instead of Supabase Storage API.
+     */
+    customUrlResolver?: (path: string) => Promise<string> | string;
 }
 declare class SupabaseStorageAdapter implements SupabaseStorage {
     private client;
@@ -212,6 +223,8 @@ declare class SupabaseStorageAdapter implements SupabaseStorage {
     private fileSystem?;
     private logger?;
     private imageTransform?;
+    private useSignedUrls;
+    private customUrlResolver?;
     constructor(options: SupabaseStorageAdapterOptions, fileSystem?: FileSystemAdapter);
     /**
      * Update image transform options (can be set after construction).
@@ -272,9 +285,14 @@ declare class SupabaseStorageAdapter implements SupabaseStorage {
      */
     delete(path: string): Promise<void>;
     /**
-     * Get a signed download URL for a remote file.
+     * Get a download URL for a remote file.
+     *
+     * Supports three modes:
+     * 1. Custom URL resolver (for non-Supabase backends)
+     * 2. Public URLs (for public Supabase buckets, when useSignedUrls=false)
+     * 3. Signed URLs (default, for private Supabase buckets)
      *
-     * Includes session refresh logic to handle stale tokens during background downloads.
+     * Includes session refresh logic for signed URLs to handle stale tokens during background downloads.
      * If the initial request fails with an auth error (400/401/403), refreshes the session
      * and retries once.
      */

package/dist/attachments/index.d.ts

@@ -1,11 +1,12 @@
-import { g as AttachmentStorageAdapter, d as PolAttachmentRecord, i as UploadHandler, U as UploadConfig, u as UploadStatus, l as CacheConfig, W as WatchConfig } from '../pol-attachment-queue-BE2HU3Us.js';
-export { f as AttachmentConfig, F as AttachmentRecord, A as AttachmentSourceConfig, x as AttachmentStatsRow, w as AttachmentSyncStats, v as AttachmentSyncStatus, B as BatchFilterContext, n as CACHE_SIZE_PRESETS, y as CacheFileRow, o as CacheSizePreset, p as CacheSizeValue, z as CachedSizeRow, C as CompressionConfig, m as DEFAULT_CACHE_CONFIG, D as DEFAULT_COMPRESSION_CONFIG, k as DEFAULT_DOWNLOAD_CONFIG, h as DEFAULT_UPLOAD_CONFIG, j as DownloadConfig, r as DownloadPhase, s as DownloadStatus, E as EvictRow, I as IdRow, P as PolAttachmentQueue, a as PolAttachmentQueueOptions, b as PolAttachmentState, S as SimpleAttachmentConfig, e as SkipDownloadContext, t as UploadPhase, c as createPolAttachmentQueue, q as formatCacheSize } from '../pol-attachment-queue-BE2HU3Us.js';
+export { P as PolAttachmentQueue, a as PolAttachmentQueueOptions, c as createPolAttachmentQueue } from '../pol-attachment-queue-DqBvLAEY.js';
 import { StorageAdapter, EncodingType, AttachmentRecord } from '@powersync/attachments';
 export { ATTACHMENT_TABLE, AbstractAttachmentQueue, AttachmentState, AttachmentTable, AttachmentTableOptions, AttachmentQueueOptions as BaseAttachmentQueueOptions, DEFAULT_ATTACHMENT_QUEUE_OPTIONS, EncodingType, AttachmentRecord as OfficialAttachmentRecord, StorageAdapter } from '@powersync/attachments';
 import { PlatformAdapter, LoggerAdapter } from '../platform/index.js';
+import { e as AttachmentStorageAdapter, a as PolAttachmentRecord, h as UploadHandler, U as UploadConfig, t as UploadStatus, k as CacheConfig, W as WatchConfig } from '../types-JCEhw2Lf.js';
+export { d as AttachmentConfig, z as AttachmentRecord, A as AttachmentSource, c as AttachmentSourceConfig, w as AttachmentStatsRow, v as AttachmentSyncStats, u as AttachmentSyncStatus, m as CACHE_SIZE_PRESETS, x as CacheFileRow, n as CacheSizePreset, o as CacheSizeValue, y as CachedSizeRow, f as CompressionConfig, C as CustomAttachmentSource, l as DEFAULT_CACHE_CONFIG, D as DEFAULT_COMPRESSION_CONFIG, j as DEFAULT_DOWNLOAD_CONFIG, g as DEFAULT_UPLOAD_CONFIG, i as DownloadConfig, q as DownloadPhase, r as DownloadStatus, E as EvictRow, I as IdRow, P as PolAttachmentState, S as SimpleAttachmentConfig, b as SupabaseBucketSource, s as UploadPhase, p as formatCacheSize, H as getCustomUrlResolver, G as isCustomSource, F as isSignedUrlSource, B as resolveBucketFromConfig } from '../types-JCEhw2Lf.js';
 import { AbstractPowerSyncDatabase } from '@powersync/common';
 export { AbstractPowerSyncDatabase as PowerSyncDBInterface } from '@powersync/common';
-import '../types-CDqWh56B.js';
+import '../types-B9MptP7E.js';
 
 /**
  * POL Storage Adapter
@@ -28,7 +29,7 @@ interface PolStorageAdapterOptions {
      */
     remoteStorage: AttachmentStorageAdapter;
     /**
-     * Base directory name for attachments within the cache directory.
+     * Base directory name for attachments within the documents directory.
      * Defaults to 'attachments'.
      */
     attachmentDirectoryName?: string;
@@ -67,6 +68,11 @@ declare class PolStorageAdapter implements StorageAdapter {
     uploadFile(filePath: string, data: ArrayBuffer, options?: {
         mediaType?: string;
     }): Promise<void>;
+    /**
+     * Convert base64 string to Blob with error handling.
+     * Throws a descriptive error if the base64 data is malformed.
+     */
+    private _base64ToBlob;
     /**
      * Download a file from remote storage.
      *
@@ -111,7 +117,7 @@ declare class PolStorageAdapter implements StorageAdapter {
     copyFile(sourceUri: string, targetUri: string): Promise<void>;
     /**
      * Get the user's storage directory for attachments.
-     * Returns the cache directory path ending with '/'.
+     * Returns the documents directory path ending with '/'.
      */
     getUserStorageDirectory(): string;
     /**
@@ -271,7 +277,7 @@ declare function blobToArrayBuffer(blob: Blob): Promise<ArrayBuffer>;
  * This override writes the downloaded file directly to the file system
  * using platform-native methods.
  *
- * Note: Filtering is handled by skipDownload callback in the queue.
+ * Note: Filtering should be done in the watchPaths callback - only emit paths you want to download.
  */
 declare function downloadRecord(deps: DownloadManagerDeps, record: AttachmentRecord): Promise<boolean>;
 
@@ -477,7 +483,9 @@ declare function getLocalUriForStoragePath(deps: CacheManagerDeps, storagePath:
     fileExists(uri: string): Promise<boolean>;
 }): Promise<string | null>;
 /**
- * Copy source file to managed cache for durable uploads.
+ * Copy source file to documents directory for durable uploads.
+ * Uses documents directory (not cache) to prevent iOS from evicting
+ * upload source files before they can be uploaded.
  */
 declare function copyToManagedCache(platform: PlatformAdapter, logger: LoggerAdapter, sourceUri: string, storagePath: string): Promise<string>;
 /**
@@ -532,27 +540,21 @@ declare function validateWhereClause(whereClause: string): void;
  * // FROM EquipmentUnitMediaContent
  * // WHERE storagePath IS NOT NULL
  * // ORDER BY takenOn DESC
- *
- * // Using idColumn (deprecated, still works)
- * const query = buildWatchQuery({
- *   table: 'EquipmentUnitMediaContent',
- *   idColumn: 'storagePath',
- * });
  * ```
  */
 declare function buildWatchQuery(config: WatchConfig): string;
 /**
- * Build a simpler ID-only watch query.
- * Use this when you only need IDs without additional columns.
+ * Build a simpler path-only watch query.
+ * Use this when you only need paths without additional columns.
  *
  * @param config - The WatchConfig to build a query from
- * @returns SQL query string that selects only IDs
+ * @returns SQL query string that selects only paths
  *
  * @example
  * ```typescript
  * const query = buildIdOnlyWatchQuery({
  *   table: 'EquipmentUnitMediaContent',
- *   idColumn: 'storagePath',
+ *   pathColumn: 'storagePath',
  *   where: 'storagePath IS NOT NULL',
  * });
  *
@@ -588,7 +590,7 @@ declare function buildRecordFetchQuery(config: WatchConfig, ids?: string[]): {
     params: unknown[];
 };
 /**
- * Convert WatchConfig to a legacy format for backwards compatibility.
+ * Convert WatchConfig to a source config format.
  *
  * @param watchConfig - The WatchConfig to convert
  * @returns Object with table, pathColumn, and optional orderByColumn
@@ -596,8 +598,6 @@ declare function buildRecordFetchQuery(config: WatchConfig, ids?: string[]): {
 declare function watchConfigToSourceConfig(watchConfig: WatchConfig): {
     table: string;
     pathColumn: string;
-    /** @deprecated Use pathColumn instead */
-    idColumn: string;
     orderByColumn?: string | null;
 };
 /**
@@ -612,27 +612,27 @@ declare function extractIdsFromRows(results: {
     rows?: unknown;
 }): string[];
 /**
- * Creates a watchIds callback for simple single-table attachment configurations.
+ * Creates a watchPaths callback for simple single-table attachment configurations.
  *
- * This is a convenience function that generates a properly typed watchIds callback
+ * This is a convenience function that generates a properly typed watchPaths callback
  * from a table name and path column. Use this for simple cases where you don't need
  * JOINs or complex watch logic.
  *
  * @param table - The source table name
- * @param pathColumn - The column containing the attachment path/ID
- * @returns A properly typed watchIds callback for use in AttachmentSourceConfig
+ * @param pathColumn - The column containing the attachment path
+ * @returns A properly typed watchPaths callback for use in AttachmentSourceConfig
  *
  * @example
  * ```typescript
- * import { createWatchIds } from '@pol-studios/powersync/attachments';
+ * import { createWatchPaths } from '@pol-studios/powersync/attachments';
  *
  * const config: AttachmentSourceConfig = {
- *   bucket: 'photos',
- *   watchIds: createWatchIds('EquipmentUnitMediaContent', 'storagePath'),
+ *   source: { type: 'supabase-bucket', bucket: 'photos' },
+ *   watchPaths: createWatchPaths('EquipmentUnitMediaContent', 'storagePath'),
  * };
  * ```
  */
-declare function createWatchIds(table: string, pathColumn: string): (db: AbstractPowerSyncDatabase, onUpdate: (ids: string[]) => void) => () => void;
+declare function createWatchPaths(table: string, pathColumn: string): (db: AbstractPowerSyncDatabase, supabase: unknown, onUpdate: (paths: string[]) => void) => () => void;
 
 /**
  * Migration Utilities for @pol-studios/powersync Attachments
@@ -664,7 +664,7 @@ declare function createWatchIds(table: string, pathColumn: string): (db: Abstrac
  *   QUEUED_SYNC=0, QUEUED_UPLOAD=1, QUEUED_DOWNLOAD=2, SYNCED=3, ARCHIVED=4
  *
  * POL extensions add:
- *   FAILED_PERMANENT=5, DOWNLOAD_SKIPPED=6
+ *   FAILED_PERMANENT=5
  *
  * For migration purposes, most states map 1:1. The mapping exists to:
  * 1. Document the relationship between old and new states
@@ -843,4 +843,4 @@ declare function recordMigration(stats: MigrationStats, oldState: number, newSta
  */
 declare function formatMigrationStats(stats: MigrationStats): string;
 
-export { AttachmentStorageAdapter, CacheConfig, type CacheManagerDeps, DOWNLOAD_WORKFLOW_STATES, type DownloadManagerDeps, LOCALLY_AVAILABLE_STATES, type MigrationStats, PENDING_DOWNLOAD_STATES, PROTECTED_UPLOAD_STATES, PolAttachmentRecord, PolStorageAdapter, type PolStorageAdapterOptions, STATE_MAPPING, STATE_NAMES, TERMINAL_STATES, UPLOAD_WORKFLOW_STATES, UploadConfig, UploadHandler, type UploadManagerDeps, type UploadManagerState, UploadStatus, VALID_STATES, WatchConfig, blobToArrayBuffer, buildIdOnlyWatchQuery, buildRecordFetchQuery, buildWatchQuery, cacheLocalFile, clearCache, clearUploadCallback, copyToManagedCache, createCacheManagerDeps, createMigrationStats, createUploadManagerDeps, createUploadManagerState, createWatchIds, determineAttachmentState, downloadRecord, enforceCacheLimit, ensureFileUri, extractErrorCode, extractIdsFromRows, formatMigrationStats, getCachedSize, getEvictionCandidates, getExcludeProtectedStatesCondition, getFailedPermanentUploads, getLocalUriForStoragePath, getPendingUploads, getProtectedStatesInClause, getSoonestRetryTime, getStaleUploads, getStateName, getSyncedUploadsWithPendingCallback, isCacheNearCapacity, isDownloadWorkflowState, isLocallyAvailable, isPendingDownloadState, isPermanentError, isProtectedUploadState, isStateTransitionAllowed, isTerminalState, isUploadWorkflowState, isValidAttachmentState, markUploadPermanentFailure, markUploadSynced, migrateAttachmentState, migrateAttachmentStateSafe, recordMigration, scheduleUploadRetry, startUploadProcessing, stripFileUri, uploadOne, validateSqlIdentifier, validateSqlIdentifier$1 as validateSqlIdentifierFromStateMachine, validateWhereClause, watchConfigToSourceConfig };
+export { AttachmentStorageAdapter, CacheConfig, type CacheManagerDeps, DOWNLOAD_WORKFLOW_STATES, type DownloadManagerDeps, LOCALLY_AVAILABLE_STATES, type MigrationStats, PENDING_DOWNLOAD_STATES, PROTECTED_UPLOAD_STATES, PolAttachmentRecord, PolStorageAdapter, type PolStorageAdapterOptions, STATE_MAPPING, STATE_NAMES, TERMINAL_STATES, UPLOAD_WORKFLOW_STATES, UploadConfig, UploadHandler, type UploadManagerDeps, type UploadManagerState, UploadStatus, VALID_STATES, WatchConfig, blobToArrayBuffer, buildIdOnlyWatchQuery, buildRecordFetchQuery, buildWatchQuery, cacheLocalFile, clearCache, clearUploadCallback, copyToManagedCache, createCacheManagerDeps, createMigrationStats, createUploadManagerDeps, createUploadManagerState, createWatchPaths, determineAttachmentState, downloadRecord, enforceCacheLimit, ensureFileUri, extractErrorCode, extractIdsFromRows, formatMigrationStats, getCachedSize, getEvictionCandidates, getExcludeProtectedStatesCondition, getFailedPermanentUploads, getLocalUriForStoragePath, getPendingUploads, getProtectedStatesInClause, getSoonestRetryTime, getStaleUploads, getStateName, getSyncedUploadsWithPendingCallback, isCacheNearCapacity, isDownloadWorkflowState, isLocallyAvailable, isPendingDownloadState, isPermanentError, isProtectedUploadState, isStateTransitionAllowed, isTerminalState, isUploadWorkflowState, isValidAttachmentState, markUploadPermanentFailure, markUploadSynced, migrateAttachmentState, migrateAttachmentStateSafe, recordMigration, scheduleUploadRetry, startUploadProcessing, stripFileUri, uploadOne, validateSqlIdentifier, validateSqlIdentifier$1 as validateSqlIdentifierFromStateMachine, validateWhereClause, watchConfigToSourceConfig };

package/dist/attachments/index.js

@@ -9,7 +9,7 @@ import {
   buildRecordFetchQuery,
   buildWatchQuery,
   createMigrationStats,
-  createWatchIds,
+  createWatchPaths,
   extractIdsFromRows,
   formatMigrationStats,
   getStateName,
@@ -23,7 +23,7 @@ import {
   validateSqlIdentifier as validateSqlIdentifier2,
   validateWhereClause,
   watchConfigToSourceConfig
-} from "../chunk-C5ODS3XH.js";
+} from "../chunk-EOW7JK7Q.js";
 import {
   ATTACHMENT_TABLE,
   AbstractAttachmentQueue,
@@ -58,6 +58,7 @@ import {
   extractErrorCode,
   formatCacheSize,
   getCachedSize,
+  getCustomUrlResolver,
   getEvictionCandidates,
   getExcludeProtectedStatesCondition,
   getFailedPermanentUploads,
@@ -68,20 +69,24 @@ import {
   getStaleUploads,
   getSyncedUploadsWithPendingCallback,
   isCacheNearCapacity,
+  isCustomSource,
   isLocallyAvailable,
   isPendingDownloadState,
   isPermanentError,
   isProtectedUploadState,
+  isSignedUrlSource,
   isStateTransitionAllowed,
   markUploadPermanentFailure,
   markUploadSynced,
+  resolveBucketFromConfig,
   scheduleUploadRetry,
   startUploadProcessing,
   stripFileUri,
   uploadOne,
   validateSqlIdentifier
-} from "../chunk-CACKC6XG.js";
+} from "../chunk-PGEDE6IM.js";
 import "../chunk-FV2HXEIY.js";
+import "../chunk-5WRI5ZAA.js";
 export {
   ATTACHMENT_TABLE,
   AbstractAttachmentQueue,
@@ -119,7 +124,7 @@ export {
   createPolAttachmentQueue,
   createUploadManagerDeps,
   createUploadManagerState,
-  createWatchIds,
+  createWatchPaths,
   determineAttachmentState,
   downloadRecord,
   enforceCacheLimit,
@@ -129,6 +134,7 @@ export {
   formatCacheSize,
   formatMigrationStats,
   getCachedSize,
+  getCustomUrlResolver,
   getEvictionCandidates,
   getExcludeProtectedStatesCondition,
   getFailedPermanentUploads,
@@ -140,11 +146,13 @@ export {
   getStateName,
   getSyncedUploadsWithPendingCallback,
   isCacheNearCapacity,
+  isCustomSource,
   isDownloadWorkflowState,
   isLocallyAvailable,
   isPendingDownloadState,
   isPermanentError,
   isProtectedUploadState,
+  isSignedUrlSource,
   isStateTransitionAllowed,
   isTerminalState,
   isUploadWorkflowState,
@@ -154,6 +162,7 @@ export {
   migrateAttachmentState,
   migrateAttachmentStateSafe,
   recordMigration,
+  resolveBucketFromConfig,
   scheduleUploadRetry,
   startUploadProcessing,
   stripFileUri,

package/dist/{background-sync-ChCXW-EV.d.ts → background-sync-BujnI3IR.d.ts}

@@ -1,4 +1,4 @@
-import { a as SyncStatus, S as SyncMode, e as SyncMetrics, b as ConnectionHealth, f as SyncError } from './types-CDqWh56B.js';
+import { a as SyncStatus, S as SyncMode, e as SyncMetrics, b as ConnectionHealth, f as SyncError } from './types-B9MptP7E.js';
 
 /**
  * Sync Module Types for @pol-studios/powersync