@pol-studios/powersync 1.0.22 → 1.0.25

package/dist/index.web.js

@@ -4,7 +4,7 @@ import {
   useAttachmentQueueContext,
   usePowerSyncContext,
   useSyncStatusContext
-} from "./chunk-XOCIONAA.js";
+} from "./chunk-TIFL2KWE.js";
 import {
   DOWNLOAD_WORKFLOW_STATES,
   STATE_MAPPING,
@@ -16,6 +16,8 @@ import {
   buildRecordFetchQuery,
   buildWatchQuery,
   createMigrationStats,
+  createWatchIds,
+  extractIdsFromRows,
   formatMigrationStats,
   getStateName,
   isDownloadWorkflowState,
@@ -28,13 +30,13 @@ import {
   validateSqlIdentifier as validateSqlIdentifier2,
   validateWhereClause,
   watchConfigToSourceConfig
-} from "./chunk-ZM4ENYMF.js";
+} from "./chunk-C5ODS3XH.js";
 import {
   ConflictBus,
   OfflineDataProvider,
   PowerSyncProvider,
   ProviderBridge
-} from "./chunk-N4K7E53V.js";
+} from "./chunk-VB737IVN.js";
 import "./chunk-YHTZ7VMV.js";
 import {
   PowerSyncErrorBoundary
@@ -102,7 +104,7 @@ import {
   stripFileUri,
   uploadOne,
   validateSqlIdentifier
-} from "./chunk-4TXTAEF2.js";
+} from "./chunk-CACKC6XG.js";
 import {
   DeadLetterQueue,
   createDeadLetterEntry,
@@ -117,7 +119,7 @@ import {
   HealthMonitor,
   MetricsCollector,
   SyncStatusTracker
-} from "./chunk-PG2NPQG3.js";
+} from "./chunk-55DKCJV4.js";
 import {
   DEFAULT_CONNECTION_HEALTH,
   DEFAULT_SYNC_CONFIG,
@@ -260,7 +262,7 @@ import {
   runUploadErrorMiddlewareSync,
   successOnPgCodes,
   tableHandlers
-} from "./chunk-IMRSLJRV.js";
+} from "./chunk-BGBQYQV3.js";
 import {
   AbortError,
   DEFAULT_BACKOFF_CONFIG,
@@ -418,6 +420,7 @@ export {
   createSyncError,
   createUploadManagerDeps,
   createUploadManagerState,
+  createWatchIds,
   createWebPlatformAdapter,
   defaultSchemaRouter,
   defineBackgroundSyncTask,
@@ -432,6 +435,7 @@ export {
   extractEntityIds,
   extractErrorCode,
   extractHttpStatusCode,
+  extractIdsFromRows,
   extractTableNames,
   fetchServerVersion,
   formatBytes,

package/dist/{pol-attachment-queue-BVAIueoP.d.ts → pol-attachment-queue-BE2HU3Us.d.ts}

@@ -92,15 +92,25 @@ interface PolAttachmentRecord {
     upload_bucket_id?: string | null;
 }
 /**
- * Legacy configuration for watching a source table.
- * @deprecated Use AttachmentSourceConfig with watchIds callback instead.
- * This interface is kept for backward compatibility with query-builder utilities.
+ * Configuration for watching a source table.
+ * Used by query-builder utilities to generate SQL queries.
+ *
+ * Note: Either `pathColumn` or `idColumn` must be provided.
+ * `pathColumn` is the preferred option; `idColumn` is deprecated but still supported.
  */
 interface WatchConfig {
     /** Source table name */
     table: string;
-    /** Column containing attachment ID/path */
-    idColumn: string;
+    /**
+     * Column containing attachment path/ID.
+     * Preferred over `idColumn`.
+     */
+    pathColumn?: string;
+    /**
+     * Column containing attachment ID/path.
+     * @deprecated Use `pathColumn` instead. Will be removed in a future version.
+     */
+    idColumn?: string;
     /** Additional columns to include in context */
     selectColumns?: string[];
     /** Optional WHERE clause fragment (e.g., "storagePath IS NOT NULL") */
@@ -111,6 +121,28 @@ interface WatchConfig {
         direction: "ASC" | "DESC";
     };
 }
+/**
+ * Simplified attachment configuration for single-table use cases.
+ * Use this when you have a single table with attachment paths and don't need
+ * complex JOIN queries or custom watch logic.
+ *
+ * @example
+ * ```typescript
+ * const config: SimpleAttachmentConfig = {
+ *   bucket: 'photos',
+ *   table: 'EquipmentUnitMediaContent',
+ *   pathColumn: 'storagePath',
+ * };
+ * ```
+ */
+interface SimpleAttachmentConfig {
+    /** Storage bucket name for this attachment source */
+    bucket: string;
+    /** Source table name */
+    table: string;
+    /** Column containing the attachment path/ID */
+    pathColumn: string;
+}
 /**
  * Legacy context for batch filtering of attachments.
  * @deprecated Use SkipDownloadContext with skipDownload callback instead.
@@ -173,6 +205,9 @@ interface AttachmentSourceConfig {
      * - Queue downloads for IDs that appear in subsequent emissions
      * - Auto-archive attachments whose IDs disappear from emissions
      *
+     * For simple single-table cases, you can use `table` and `pathColumn` instead
+     * of providing a custom `watchIds` callback.
+     *
      * @param db - PowerSync database instance for querying
      * @param onUpdate - Callback to emit current set of attachment IDs
      * @returns Optional cleanup function to dispose of the watch subscription
@@ -191,7 +226,36 @@ interface AttachmentSourceConfig {
      * }
      * ```
      */
-    watchIds: (db: AbstractPowerSyncDatabase, onUpdate: (ids: string[]) => void) => (() => void) | void;
+    watchIds?: (db: AbstractPowerSyncDatabase, onUpdate: (ids: string[]) => void) => (() => void) | void;
+    /**
+     * Source table name for simplified configuration.
+     * Use with `pathColumn` as an alternative to providing a custom `watchIds` callback.
+     * Only for simple single-table cases without JOINs.
+     *
+     * @example
+     * ```typescript
+     * const config: AttachmentSourceConfig = {
+     *   bucket: 'photos',
+     *   table: 'EquipmentUnitMediaContent',
+     *   pathColumn: 'storagePath',
+     * };
+     * ```
+     */
+    table?: string;
+    /**
+     * Column containing the attachment path/ID for simplified configuration.
+     * Use with `table` as an alternative to providing a custom `watchIds` callback.
+     *
+     * @example
+     * ```typescript
+     * const config: AttachmentSourceConfig = {
+     *   bucket: 'photos',
+     *   table: 'EquipmentUnitMediaContent',
+     *   pathColumn: 'storagePath',
+     * };
+     * ```
+     */
+    pathColumn?: string;
     /**
      * Optional batch filter to skip downloading certain attachments.
      *
@@ -814,4 +878,4 @@ interface CreateAttachmentQueueOptions extends AttachmentConfig {
 }
 declare function createPolAttachmentQueue(powersync: AbstractPowerSyncDatabase, platform: PlatformAdapter, config: CreateAttachmentQueueOptions): PolAttachmentQueue;
 
-export { type AttachmentSourceConfig as A, type BatchFilterContext as B, type CompressionConfig as C, DEFAULT_COMPRESSION_CONFIG as D, type EvictRow as E, type IdRow as I, PolAttachmentQueue as P, type SkipDownloadContext as S, type UploadConfig as U, type WatchConfig as W, type PolAttachmentQueueOptions as a, PolAttachmentState as b, createPolAttachmentQueue as c, type PolAttachmentRecord as d, type AttachmentConfig as e, type AttachmentStorageAdapter as f, DEFAULT_UPLOAD_CONFIG as g, type UploadHandler as h, type DownloadConfig as i, DEFAULT_DOWNLOAD_CONFIG as j, type CacheConfig as k, DEFAULT_CACHE_CONFIG as l, CACHE_SIZE_PRESETS as m, type CacheSizePreset as n, type CacheSizeValue as o, formatCacheSize as p, type DownloadPhase as q, type DownloadStatus as r, type UploadPhase as s, type UploadStatus as t, type AttachmentSyncStatus as u, type AttachmentSyncStats as v, type AttachmentStatsRow as w, type CacheFileRow as x, type CachedSizeRow as y, type AttachmentRecord as z };
+export { type AttachmentSourceConfig as A, type BatchFilterContext as B, type CompressionConfig as C, DEFAULT_COMPRESSION_CONFIG as D, type EvictRow as E, type AttachmentRecord as F, type IdRow as I, PolAttachmentQueue as P, type SimpleAttachmentConfig as S, type UploadConfig as U, type WatchConfig as W, type PolAttachmentQueueOptions as a, PolAttachmentState as b, createPolAttachmentQueue as c, type PolAttachmentRecord as d, type SkipDownloadContext as e, type AttachmentConfig as f, type AttachmentStorageAdapter as g, DEFAULT_UPLOAD_CONFIG as h, type UploadHandler as i, type DownloadConfig as j, DEFAULT_DOWNLOAD_CONFIG as k, type CacheConfig as l, DEFAULT_CACHE_CONFIG as m, CACHE_SIZE_PRESETS as n, type CacheSizePreset as o, type CacheSizeValue as p, formatCacheSize as q, type DownloadPhase as r, type DownloadStatus as s, type UploadPhase as t, type UploadStatus as u, type AttachmentSyncStatus as v, type AttachmentSyncStats as w, type AttachmentStatsRow as x, type CacheFileRow as y, type CachedSizeRow as z };

package/dist/provider/index.d.ts

@@ -3,8 +3,8 @@ import { QueryClient } from '@tanstack/react-query';
 import { A as AbstractPowerSyncDatabase, a as SyncStatus, C as CrudEntry, S as SyncMode, F as FailedTransaction, h as CompletedTransaction, b as ConnectionHealth, e as SyncMetrics, D as DownloadProgress, E as EntitySyncState, f as SyncError } from '../types-CDqWh56B.js';
 import { PlatformAdapter } from '../platform/index.js';
 import { a as ConnectorConfig, i as ConflictBus } from '../types-DiBvmGEi.js';
-import { e as AttachmentConfig, P as PolAttachmentQueue, A as AttachmentSourceConfig, z as AttachmentRecord, C as CompressionConfig, i as DownloadConfig } from '../pol-attachment-queue-BVAIueoP.js';
-import { S as SupabaseConnector } from '../supabase-connector-WuiFiBnV.js';
+import { f as AttachmentConfig, P as PolAttachmentQueue, A as AttachmentSourceConfig, F as AttachmentRecord, C as CompressionConfig, j as DownloadConfig } from '../pol-attachment-queue-BE2HU3Us.js';
+import { S as SupabaseConnector } from '../supabase-connector-D2oIl2t8.js';
 import * as react from 'react';
 import react__default, { ReactNode } from 'react';
 import { Schema } from '@powersync/react-native';

package/dist/provider/index.js

@@ -2,11 +2,11 @@ import {
   OfflineDataProvider,
   PowerSyncProvider,
   ProviderBridge
-} from "../chunk-N4K7E53V.js";
+} from "../chunk-VB737IVN.js";
 import "../chunk-YHTZ7VMV.js";
 import "../chunk-P6WOZO7H.js";
-import "../chunk-4TXTAEF2.js";
-import "../chunk-PG2NPQG3.js";
+import "../chunk-CACKC6XG.js";
+import "../chunk-55DKCJV4.js";
 import {
   DEFAULT_CONNECTION_HEALTH,
   DEFAULT_SYNC_CONFIG,
@@ -56,7 +56,7 @@ import "../chunk-XAEII4ZX.js";
 import "../chunk-Z6VOBGTU.js";
 import "../chunk-CGL33PL4.js";
 import "../chunk-WN5ZJ3E2.js";
-import "../chunk-IMRSLJRV.js";
+import "../chunk-BGBQYQV3.js";
 import "../chunk-FV2HXEIY.js";
 import "../chunk-I2AYMY5O.js";
 export {

package/dist/react/index.d.ts

@@ -3,7 +3,7 @@ import react__default, { ReactNode } from 'react';
 import { Schema } from '@powersync/react-native';
 import { A as AuthProvider } from '../types-DiBvmGEi.js';
 import { a as StorageBackend } from '../types-D0WcHrq6.js';
-import { e as AttachmentConfig, P as PolAttachmentQueue } from '../pol-attachment-queue-BVAIueoP.js';
+import { f as AttachmentConfig, P as PolAttachmentQueue } from '../pol-attachment-queue-BE2HU3Us.js';
 import { PlatformAdapter } from '../platform/index.js';
 import { f as SyncError, a as SyncStatus, A as AbstractPowerSyncDatabase } from '../types-CDqWh56B.js';
 import '@supabase/supabase-js';

package/dist/react/index.js

@@ -6,10 +6,10 @@ import {
   useAttachmentQueueContext,
   usePowerSyncContext,
   useSyncStatusContext
-} from "../chunk-XOCIONAA.js";
-import "../chunk-4TXTAEF2.js";
+} from "../chunk-TIFL2KWE.js";
+import "../chunk-CACKC6XG.js";
 import "../chunk-24RDMMCL.js";
-import "../chunk-IMRSLJRV.js";
+import "../chunk-BGBQYQV3.js";
 import "../chunk-FV2HXEIY.js";
 import "../chunk-I2AYMY5O.js";
 export {

package/dist/{supabase-connector-WuiFiBnV.d.ts → supabase-connector-D2oIl2t8.d.ts}

@@ -82,9 +82,11 @@ declare class SupabaseConnector implements PowerSyncBackendConnector {
     private completionFailures;
     private static readonly COMPLETION_MAX_FAILURES;
     private static readonly COMPLETION_EXTENDED_TIMEOUT_MS;
+    private static readonly MAX_STORED_RESOLUTIONS;
     private autoRetryPaused;
     private entryCooldowns;
     private static readonly COOLDOWN_DURATION_MS;
+    private static readonly MAX_ENTRY_COOLDOWNS;
     private readonly uploadErrorMiddleware;
     constructor(options: SupabaseConnectorOptions);
     /**
@@ -170,7 +172,7 @@ declare class SupabaseConnector implements PowerSyncBackendConnector {
      * Process batched PUT (upsert) operations for a single table.
      * Falls back to individual processing if batch fails.
      * CRITICAL: Throws on first failure to maintain transaction atomicity.
-     * @returns Array of successfully processed entries
+     * @returns Object containing successful and discarded entries
      * @throws Error on first failure - keeps entire transaction in ps_crud
      */
     private processBatchedPuts;
@@ -178,10 +180,19 @@ declare class SupabaseConnector implements PowerSyncBackendConnector {
      * Process batched DELETE operations for a single table.
      * Falls back to individual processing if batch fails.
      * CRITICAL: Throws on first failure to maintain transaction atomicity.
-     * @returns Array of successfully processed entries
+     * @returns Object containing successful and discarded entries
      * @throws Error on first failure - keeps entire transaction in ps_crud
      */
     private processBatchedDeletes;
+    /**
+     * Process batched PATCH (update) operations for a single table.
+     * Uses parallel processing with configurable concurrency since each PATCH may have different fields.
+     * CRITICAL: Throws on first non-DiscardEntryError failure to maintain transaction atomicity.
+     * @param batchSize Number of concurrent PATCH operations (default: 5)
+     * @returns Object containing successful and discarded entries
+     * @throws Error on first non-DiscardEntryError failure - keeps entire transaction in ps_crud
+     */
+    private processBatchedPatches;
     /**
      * Check if a table has a _version column (cached).
      * P4.1: Uses Promise-based locking to prevent duplicate concurrent queries.

package/dist/sync/index.d.ts

@@ -333,6 +333,8 @@ declare class MetricsCollector {
     private _initialized;
     private _syncStartTime;
     private _wasSyncing;
+    private _persistTimeout;
+    private readonly PERSIST_DEBOUNCE_MS;
     constructor(storage: AsyncStorageAdapter, logger: LoggerAdapter, options?: MetricsCollectorOptions);
     /**
      * Initialize the collector by loading persisted metrics.
@@ -380,6 +382,7 @@ declare class MetricsCollector {
      * @returns Unsubscribe function
      */
     onMetricsUpdate(listener: (metrics: SyncMetrics) => void): Unsubscribe;
+    private _schedulePersist;
     private _persist;
     private _notifyListeners;
 }

package/dist/sync/index.js

@@ -12,7 +12,7 @@ import {
   HealthMonitor,
   MetricsCollector,
   SyncStatusTracker
-} from "../chunk-PG2NPQG3.js";
+} from "../chunk-55DKCJV4.js";
 import "../chunk-24RDMMCL.js";
 import "../chunk-CGL33PL4.js";
 import "../chunk-I2AYMY5O.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pol-studios/powersync",
-  "version": "1.0.22",
+  "version": "1.0.25",
   "description": "Enterprise PowerSync integration for offline-first applications",
   "license": "UNLICENSED",
   "type": "module",
@@ -141,7 +141,7 @@
     "commander": "^12.0.0",
     "jiti": "^2.4.0",
     "picocolors": "^1.0.0",
-    "@pol-studios/db": "1.0.54"
+    "@pol-studios/db": "1.0.59"
   },
   "peerDependencies": {
     "@powersync/react-native": ">=1.0.8",
@@ -202,12 +202,18 @@
     "@babel/core": "^7.28.0",
     "@powersync/common": "^1.49.0",
     "@powersync/op-sqlite": "^0.8.0",
+    "@testing-library/react": "^16.0.0",
+    "@testing-library/react-hooks": "^8.0.1",
     "@types/react": "^18.0.0",
+    "@vitest/coverage-v8": "^3.0.0",
+    "@vitest/ui": "^3.0.0",
     "babel-plugin-react-compiler": "^1.0.0",
     "expo-background-task": "^0.0.1",
     "expo-task-manager": "^12.0.0",
+    "jsdom": "^26.0.0",
     "tsup": "^8.0.0",
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "vitest": "^3.0.0"
   },
   "publishConfig": {
     "access": "public"
@@ -215,6 +221,10 @@
   "scripts": {
     "build": "NODE_OPTIONS='--max-old-space-size=8192' tsup",
     "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:ui": "vitest --ui"
   }
 }