@tanstack/powersync-db-collection 0.1.54 → 0.1.56

package/dist/cjs/PowerSyncTransactor.cjs

@@ -165,7 +165,7 @@ class PowerSyncTransactor {
       return null;
     }
     const diffOperation = await context.get(
-      common.sanitizeSQL`SELECT id, timestamp FROM ${trackedTableName} ORDER BY timestamp DESC LIMIT 1`
+      common.sanitizeSQL`SELECT id, timestamp FROM ${trackedTableName} ORDER BY operation_id DESC LIMIT 1`
     );
     return {
       tableName,

package/dist/cjs/PowerSyncTransactor.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"PowerSyncTransactor.cjs","sources":["../../src/PowerSyncTransactor.ts"],"sourcesContent":["import { sanitizeSQL } from '@powersync/common'\nimport DebugModule from 'debug'\nimport { PendingOperationStore } from './PendingOperationStore'\nimport { asPowerSyncRecord, mapOperationToPowerSync } from './helpers'\nimport type { AbstractPowerSyncDatabase, LockContext } from '@powersync/common'\nimport type { PendingMutation, Transaction } from '@tanstack/db'\nimport type { PendingOperation } from './PendingOperationStore'\nimport type {\n  EnhancedPowerSyncCollectionConfig,\n  PowerSyncCollectionMeta,\n} from './definitions'\n\nconst debug = DebugModule.debug(`ts/db:powersync`)\n\nexport type TransactorOptions = {\n  database: AbstractPowerSyncDatabase\n}\n\n/**\n * Applies mutations to the PowerSync database. This method is called automatically by the collection's\n * insert, update, and delete operations. You typically don't need to call this directly unless you\n * have special transaction requirements.\n *\n * @example\n * ```typescript\n * // Create a collection\n * const collection = createCollection(\n *   powerSyncCollectionOptions<Document>({\n *     database: db,\n *     table: APP_SCHEMA.props.documents,\n *   })\n * )\n *\n * const addTx = createTransaction({\n *   autoCommit: false,\n *   mutationFn: async ({ transaction }) => {\n *     await new PowerSyncTransactor({ database: db }).applyTransaction(transaction)\n *   },\n * })\n *\n * addTx.mutate(() => {\n *   for (let i = 0; i < 5; i++) {\n *     collection.insert({ id: randomUUID(), name: `tx-${i}` })\n *   }\n * })\n *\n * await addTx.commit()\n * await addTx.isPersisted.promise\n * ```\n *\n * @param transaction - The transaction containing mutations to apply\n * @returns A promise that resolves when the mutations have been persisted to PowerSync\n */\nexport class PowerSyncTransactor {\n  database: AbstractPowerSyncDatabase\n  pendingOperationStore: PendingOperationStore\n\n  constructor(options: TransactorOptions) {\n    this.database = options.database\n    this.pendingOperationStore = PendingOperationStore.GLOBAL\n  }\n\n  /**\n   * Persists a {@link Transaction} to the PowerSync SQLite database.\n   */\n  async applyTransaction(transaction: Transaction<any>) {\n    const { mutations } = transaction\n\n    if (mutations.length == 0) {\n      return\n    }\n    /**\n     * The transaction might contain operations for different collections.\n     * We can do some optimizations for single-collection transactions.\n     */\n    const mutationsCollectionIds = mutations.map(\n      (mutation) => mutation.collection.id,\n    )\n    const collectionIds = Array.from(new Set(mutationsCollectionIds))\n    const lastCollectionMutationIndexes = new Map<string, number>()\n    const allCollections = collectionIds\n      .map((id) => mutations.find((mutation) => mutation.collection.id == id)!)\n      .map((mutation) => mutation.collection)\n    for (const collectionId of collectionIds) {\n      lastCollectionMutationIndexes.set(\n        collectionId,\n        mutationsCollectionIds.lastIndexOf(collectionId),\n      )\n    }\n\n    // Check all the observers are ready before taking a lock\n    await Promise.all(\n      allCollections.map(async (collection) => {\n        if (collection.isReady()) {\n          return\n        }\n        await new Promise<void>((resolve) => collection.onFirstReady(resolve))\n      }),\n    )\n\n    // Persist to PowerSync\n    const { whenComplete } = await this.database.writeTransaction(\n      async (tx) => {\n        const pendingOperations: Array<PendingOperation | null> = []\n\n        for (const [index, mutation] of mutations.entries()) {\n          /**\n           * Each collection processes events independently. We need to make sure the\n           * last operation for each collection has been observed.\n           */\n          const shouldWait =\n            index == lastCollectionMutationIndexes.get(mutation.collection.id)\n          switch (mutation.type) {\n            case `insert`:\n              pendingOperations.push(\n                await this.handleInsert(mutation, tx, shouldWait),\n              )\n              break\n            case `update`:\n              pendingOperations.push(\n                await this.handleUpdate(mutation, tx, shouldWait),\n              )\n              break\n            case `delete`:\n              pendingOperations.push(\n                await this.handleDelete(mutation, tx, shouldWait),\n              )\n              break\n          }\n        }\n\n        /**\n         * Return a promise from the writeTransaction, without awaiting it.\n         * This promise will resolve once the entire transaction has been\n         * observed via the diff triggers.\n         * We return without awaiting in order to free the write lock.\n         */\n        return {\n          whenComplete: Promise.all(\n            pendingOperations\n              .filter((op) => !!op)\n              .map((op) => this.pendingOperationStore.waitFor(op)),\n          ),\n        }\n      },\n    )\n\n    // Wait for the change to be observed via the diff trigger\n    await whenComplete\n  }\n\n  protected async handleInsert(\n    mutation: PendingMutation<any>,\n    context: LockContext,\n    waitForCompletion: boolean = false,\n  ): Promise<PendingOperation | null> {\n    debug(`insert`, mutation)\n\n    return this.handleOperationWithCompletion(\n      mutation,\n      context,\n      waitForCompletion,\n      // eslint-disable-next-line no-shadow\n      async (tableName, mutation, serializeValue) => {\n        const values = serializeValue(mutation.modified)\n        const keys = Object.keys(values).map((key) => sanitizeSQL`${key}`)\n        const queryParameters = Object.values(values)\n\n        const metadataValue = this.processMutationMetadata(mutation)\n        if (metadataValue != null) {\n          keys.push(`_metadata`)\n          queryParameters.push(metadataValue)\n        }\n\n        await context.execute(\n          `\n        INSERT into ${tableName}\n            (${keys.join(`, `)})\n        VALUES\n            (${keys.map((_) => `?`).join(`, `)})\n        `,\n          queryParameters,\n        )\n      },\n    )\n  }\n\n  protected async handleUpdate(\n    mutation: PendingMutation<any>,\n    context: LockContext,\n    waitForCompletion: boolean = false,\n  ): Promise<PendingOperation | null> {\n    debug(`update`, mutation)\n\n    return this.handleOperationWithCompletion(\n      mutation,\n      context,\n      waitForCompletion,\n      // eslint-disable-next-line no-shadow\n      async (tableName, mutation, serializeValue) => {\n        const values = serializeValue(mutation.modified)\n        const keys = Object.keys(values).map((key) => sanitizeSQL`${key}`)\n        const queryParameters = Object.values(values)\n\n        const metadataValue = this.processMutationMetadata(mutation)\n        if (metadataValue != null) {\n          keys.push(`_metadata`)\n          queryParameters.push(metadataValue)\n        }\n\n        await context.execute(\n          `\n        UPDATE ${tableName}\n        SET ${keys.map((key) => `${key} = ?`).join(`, `)}\n        WHERE id = ?\n        `,\n          [...queryParameters, asPowerSyncRecord(mutation.modified).id],\n        )\n      },\n    )\n  }\n\n  protected async handleDelete(\n    mutation: PendingMutation<any>,\n    context: LockContext,\n    waitForCompletion: boolean = false,\n  ): Promise<PendingOperation | null> {\n    debug(`update`, mutation)\n\n    return this.handleOperationWithCompletion(\n      mutation,\n      context,\n      waitForCompletion,\n      // eslint-disable-next-line no-shadow\n      async (tableName, mutation) => {\n        const metadataValue = this.processMutationMetadata(mutation)\n        if (metadataValue != null) {\n          /**\n           * Delete operations with metadata require a different approach to handle metadata.\n           * This will delete the record.\n           */\n          await context.execute(\n            `\n            UPDATE ${tableName} SET _deleted = TRUE, _metadata = ? WHERE id = ?\n            `,\n            [metadataValue, asPowerSyncRecord(mutation.original).id],\n          )\n        } else {\n          await context.execute(\n            `\n            DELETE FROM ${tableName} WHERE id = ?\n            `,\n            [asPowerSyncRecord(mutation.original).id],\n          )\n        }\n      },\n    )\n  }\n\n  /**\n   * Helper function which wraps a persistence operation by:\n   * - Fetching the mutation's collection's SQLite table details\n   * - Executing the mutation\n   * - Returning the last pending diff operation if required\n   */\n  protected async handleOperationWithCompletion(\n    mutation: PendingMutation<any>,\n    context: LockContext,\n    waitForCompletion: boolean,\n    handler: (\n      tableName: string,\n      mutation: PendingMutation<any>,\n      serializeValue: (value: any) => Record<string, unknown>,\n    ) => Promise<void>,\n  ): Promise<PendingOperation | null> {\n    const { tableName, trackedTableName, serializeValue } =\n      this.getMutationCollectionMeta(mutation)\n\n    await handler(sanitizeSQL`${tableName}`, mutation, serializeValue)\n\n    if (!waitForCompletion) {\n      return null\n    }\n\n    // Need to get the operation in order to wait for it\n    const diffOperation = await context.get<{ id: string; timestamp: string }>(\n      sanitizeSQL`SELECT id, timestamp FROM ${trackedTableName} ORDER BY timestamp DESC LIMIT 1`,\n    )\n    return {\n      tableName,\n      id: diffOperation.id,\n      operation: mapOperationToPowerSync(mutation.type),\n      timestamp: diffOperation.timestamp,\n    }\n  }\n\n  protected getMutationCollectionMeta(\n    mutation: PendingMutation<any>,\n  ): PowerSyncCollectionMeta<any> {\n    if (\n      typeof (mutation.collection.config as any).utils?.getMeta != `function`\n    ) {\n      throw new Error(`Collection is not a PowerSync collection.`)\n    }\n    return (\n      mutation.collection\n        .config as unknown as EnhancedPowerSyncCollectionConfig<any>\n    ).utils.getMeta()\n  }\n\n  /**\n   * Processes collection mutation metadata for persistence to the database.\n   * We only support storing string metadata.\n   * @returns null if no metadata should be stored.\n   */\n  protected processMutationMetadata(\n    mutation: PendingMutation<any>,\n  ): string | null {\n    const { metadataIsTracked } = this.getMutationCollectionMeta(mutation)\n    if (!metadataIsTracked) {\n      // If it's not supported, we don't store metadata.\n      if (typeof mutation.metadata != `undefined`) {\n        // Log a warning if metadata is provided but not tracked.\n        this.database.logger.warn(\n          `Metadata provided for collection ${mutation.collection.id} but the PowerSync table does not track metadata. The PowerSync table should be configured with trackMetadata: true.`,\n          mutation.metadata,\n        )\n      }\n      return null\n    } else if (typeof mutation.metadata == `undefined`) {\n      return null\n    } else if (typeof mutation.metadata == `string`) {\n      return mutation.metadata\n    } else {\n      return JSON.stringify(mutation.metadata)\n    }\n  }\n}\n"],"names":["PendingOperationStore","mutation","sanitizeSQL","asPowerSyncRecord","mapOperationToPowerSync"],"mappings":"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"}
+{"version":3,"file":"PowerSyncTransactor.cjs","sources":["../../src/PowerSyncTransactor.ts"],"sourcesContent":["import { sanitizeSQL } from '@powersync/common'\nimport DebugModule from 'debug'\nimport { PendingOperationStore } from './PendingOperationStore'\nimport { asPowerSyncRecord, mapOperationToPowerSync } from './helpers'\nimport type { AbstractPowerSyncDatabase, LockContext } from '@powersync/common'\nimport type { PendingMutation, Transaction } from '@tanstack/db'\nimport type { PendingOperation } from './PendingOperationStore'\nimport type {\n  EnhancedPowerSyncCollectionConfig,\n  PowerSyncCollectionMeta,\n} from './definitions'\n\nconst debug = DebugModule.debug(`ts/db:powersync`)\n\nexport type TransactorOptions = {\n  database: AbstractPowerSyncDatabase\n}\n\n/**\n * Applies mutations to the PowerSync database. This method is called automatically by the collection's\n * insert, update, and delete operations. You typically don't need to call this directly unless you\n * have special transaction requirements.\n *\n * @example\n * ```typescript\n * // Create a collection\n * const collection = createCollection(\n *   powerSyncCollectionOptions<Document>({\n *     database: db,\n *     table: APP_SCHEMA.props.documents,\n *   })\n * )\n *\n * const addTx = createTransaction({\n *   autoCommit: false,\n *   mutationFn: async ({ transaction }) => {\n *     await new PowerSyncTransactor({ database: db }).applyTransaction(transaction)\n *   },\n * })\n *\n * addTx.mutate(() => {\n *   for (let i = 0; i < 5; i++) {\n *     collection.insert({ id: randomUUID(), name: `tx-${i}` })\n *   }\n * })\n *\n * await addTx.commit()\n * await addTx.isPersisted.promise\n * ```\n *\n * @param transaction - The transaction containing mutations to apply\n * @returns A promise that resolves when the mutations have been persisted to PowerSync\n */\nexport class PowerSyncTransactor {\n  database: AbstractPowerSyncDatabase\n  pendingOperationStore: PendingOperationStore\n\n  constructor(options: TransactorOptions) {\n    this.database = options.database\n    this.pendingOperationStore = PendingOperationStore.GLOBAL\n  }\n\n  /**\n   * Persists a {@link Transaction} to the PowerSync SQLite database.\n   */\n  async applyTransaction(transaction: Transaction<any>) {\n    const { mutations } = transaction\n\n    if (mutations.length == 0) {\n      return\n    }\n    /**\n     * The transaction might contain operations for different collections.\n     * We can do some optimizations for single-collection transactions.\n     */\n    const mutationsCollectionIds = mutations.map(\n      (mutation) => mutation.collection.id,\n    )\n    const collectionIds = Array.from(new Set(mutationsCollectionIds))\n    const lastCollectionMutationIndexes = new Map<string, number>()\n    const allCollections = collectionIds\n      .map((id) => mutations.find((mutation) => mutation.collection.id == id)!)\n      .map((mutation) => mutation.collection)\n    for (const collectionId of collectionIds) {\n      lastCollectionMutationIndexes.set(\n        collectionId,\n        mutationsCollectionIds.lastIndexOf(collectionId),\n      )\n    }\n\n    // Check all the observers are ready before taking a lock\n    await Promise.all(\n      allCollections.map(async (collection) => {\n        if (collection.isReady()) {\n          return\n        }\n        await new Promise<void>((resolve) => collection.onFirstReady(resolve))\n      }),\n    )\n\n    // Persist to PowerSync\n    const { whenComplete } = await this.database.writeTransaction(\n      async (tx) => {\n        const pendingOperations: Array<PendingOperation | null> = []\n\n        for (const [index, mutation] of mutations.entries()) {\n          /**\n           * Each collection processes events independently. We need to make sure the\n           * last operation for each collection has been observed.\n           */\n          const shouldWait =\n            index == lastCollectionMutationIndexes.get(mutation.collection.id)\n          switch (mutation.type) {\n            case `insert`:\n              pendingOperations.push(\n                await this.handleInsert(mutation, tx, shouldWait),\n              )\n              break\n            case `update`:\n              pendingOperations.push(\n                await this.handleUpdate(mutation, tx, shouldWait),\n              )\n              break\n            case `delete`:\n              pendingOperations.push(\n                await this.handleDelete(mutation, tx, shouldWait),\n              )\n              break\n          }\n        }\n\n        /**\n         * Return a promise from the writeTransaction, without awaiting it.\n         * This promise will resolve once the entire transaction has been\n         * observed via the diff triggers.\n         * We return without awaiting in order to free the write lock.\n         */\n        return {\n          whenComplete: Promise.all(\n            pendingOperations\n              .filter((op) => !!op)\n              .map((op) => this.pendingOperationStore.waitFor(op)),\n          ),\n        }\n      },\n    )\n\n    // Wait for the change to be observed via the diff trigger\n    await whenComplete\n  }\n\n  protected async handleInsert(\n    mutation: PendingMutation<any>,\n    context: LockContext,\n    waitForCompletion: boolean = false,\n  ): Promise<PendingOperation | null> {\n    debug(`insert`, mutation)\n\n    return this.handleOperationWithCompletion(\n      mutation,\n      context,\n      waitForCompletion,\n      // eslint-disable-next-line no-shadow\n      async (tableName, mutation, serializeValue) => {\n        const values = serializeValue(mutation.modified)\n        const keys = Object.keys(values).map((key) => sanitizeSQL`${key}`)\n        const queryParameters = Object.values(values)\n\n        const metadataValue = this.processMutationMetadata(mutation)\n        if (metadataValue != null) {\n          keys.push(`_metadata`)\n          queryParameters.push(metadataValue)\n        }\n\n        await context.execute(\n          `\n        INSERT into ${tableName}\n            (${keys.join(`, `)})\n        VALUES\n            (${keys.map((_) => `?`).join(`, `)})\n        `,\n          queryParameters,\n        )\n      },\n    )\n  }\n\n  protected async handleUpdate(\n    mutation: PendingMutation<any>,\n    context: LockContext,\n    waitForCompletion: boolean = false,\n  ): Promise<PendingOperation | null> {\n    debug(`update`, mutation)\n\n    return this.handleOperationWithCompletion(\n      mutation,\n      context,\n      waitForCompletion,\n      // eslint-disable-next-line no-shadow\n      async (tableName, mutation, serializeValue) => {\n        const values = serializeValue(mutation.modified)\n        const keys = Object.keys(values).map((key) => sanitizeSQL`${key}`)\n        const queryParameters = Object.values(values)\n\n        const metadataValue = this.processMutationMetadata(mutation)\n        if (metadataValue != null) {\n          keys.push(`_metadata`)\n          queryParameters.push(metadataValue)\n        }\n\n        await context.execute(\n          `\n        UPDATE ${tableName}\n        SET ${keys.map((key) => `${key} = ?`).join(`, `)}\n        WHERE id = ?\n        `,\n          [...queryParameters, asPowerSyncRecord(mutation.modified).id],\n        )\n      },\n    )\n  }\n\n  protected async handleDelete(\n    mutation: PendingMutation<any>,\n    context: LockContext,\n    waitForCompletion: boolean = false,\n  ): Promise<PendingOperation | null> {\n    debug(`update`, mutation)\n\n    return this.handleOperationWithCompletion(\n      mutation,\n      context,\n      waitForCompletion,\n      // eslint-disable-next-line no-shadow\n      async (tableName, mutation) => {\n        const metadataValue = this.processMutationMetadata(mutation)\n        if (metadataValue != null) {\n          /**\n           * Delete operations with metadata require a different approach to handle metadata.\n           * This will delete the record.\n           */\n          await context.execute(\n            `\n            UPDATE ${tableName} SET _deleted = TRUE, _metadata = ? WHERE id = ?\n            `,\n            [metadataValue, asPowerSyncRecord(mutation.original).id],\n          )\n        } else {\n          await context.execute(\n            `\n            DELETE FROM ${tableName} WHERE id = ?\n            `,\n            [asPowerSyncRecord(mutation.original).id],\n          )\n        }\n      },\n    )\n  }\n\n  /**\n   * Helper function which wraps a persistence operation by:\n   * - Fetching the mutation's collection's SQLite table details\n   * - Executing the mutation\n   * - Returning the last pending diff operation if required\n   */\n  protected async handleOperationWithCompletion(\n    mutation: PendingMutation<any>,\n    context: LockContext,\n    waitForCompletion: boolean,\n    handler: (\n      tableName: string,\n      mutation: PendingMutation<any>,\n      serializeValue: (value: any) => Record<string, unknown>,\n    ) => Promise<void>,\n  ): Promise<PendingOperation | null> {\n    const { tableName, trackedTableName, serializeValue } =\n      this.getMutationCollectionMeta(mutation)\n\n    await handler(sanitizeSQL`${tableName}`, mutation, serializeValue)\n\n    if (!waitForCompletion) {\n      return null\n    }\n\n    // Need to get the operation in order to wait for it\n    const diffOperation = await context.get<{ id: string; timestamp: string }>(\n      sanitizeSQL`SELECT id, timestamp FROM ${trackedTableName} ORDER BY operation_id DESC LIMIT 1`,\n    )\n    return {\n      tableName,\n      id: diffOperation.id,\n      operation: mapOperationToPowerSync(mutation.type),\n      timestamp: diffOperation.timestamp,\n    }\n  }\n\n  protected getMutationCollectionMeta(\n    mutation: PendingMutation<any>,\n  ): PowerSyncCollectionMeta<any> {\n    if (\n      typeof (mutation.collection.config as any).utils?.getMeta != `function`\n    ) {\n      throw new Error(`Collection is not a PowerSync collection.`)\n    }\n    return (\n      mutation.collection\n        .config as unknown as EnhancedPowerSyncCollectionConfig<any>\n    ).utils.getMeta()\n  }\n\n  /**\n   * Processes collection mutation metadata for persistence to the database.\n   * We only support storing string metadata.\n   * @returns null if no metadata should be stored.\n   */\n  protected processMutationMetadata(\n    mutation: PendingMutation<any>,\n  ): string | null {\n    const { metadataIsTracked } = this.getMutationCollectionMeta(mutation)\n    if (!metadataIsTracked) {\n      // If it's not supported, we don't store metadata.\n      if (typeof mutation.metadata != `undefined`) {\n        // Log a warning if metadata is provided but not tracked.\n        this.database.logger.warn(\n          `Metadata provided for collection ${mutation.collection.id} but the PowerSync table does not track metadata. The PowerSync table should be configured with trackMetadata: true.`,\n          mutation.metadata,\n        )\n      }\n      return null\n    } else if (typeof mutation.metadata == `undefined`) {\n      return null\n    } else if (typeof mutation.metadata == `string`) {\n      return mutation.metadata\n    } else {\n      return JSON.stringify(mutation.metadata)\n    }\n  }\n}\n"],"names":["PendingOperationStore","mutation","sanitizeSQL","asPowerSyncRecord","mapOperationToPowerSync"],"mappings":"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"}

package/dist/cjs/powersync.cjs

@@ -57,6 +57,14 @@ function powerSyncCollectionOptions(config) {
       } else {
         return runOnDemandSync();
       }
+      async function safelyDisposeTracking(context) {
+        const dispose = disposeTracking;
+        if (!dispose) {
+          return;
+        }
+        disposeTracking = null;
+        await dispose(context ? { context } : void 0);
+      }
       async function createDiffTrigger(options) {
         const { setupContext, when, writeType, batchQuery, onReady } = options;
         return await database.triggers.createDiffTrigger({
@@ -104,6 +112,9 @@ function powerSyncCollectionOptions(config) {
         });
       }
       async function flushDiffRecordsWithContext(context) {
+        if (!disposeTracking) {
+          return;
+        }
         try {
           begin();
           const operations = await context.getAll(
@@ -160,12 +171,12 @@ function powerSyncCollectionOptions(config) {
         );
         await afterOnChangeRegistered?.();
         if (abortController.signal.aborted) {
-          await disposeTracking?.();
+          await safelyDisposeTracking();
         } else {
           abortController.signal.addEventListener(
             `abort`,
             async () => {
-              await disposeTracking?.();
+              await safelyDisposeTracking();
             },
             { once: true }
           );
@@ -219,7 +230,7 @@ function powerSyncCollectionOptions(config) {
           if (activeWhereExpressions.length === 0) {
             await database.writeLock(async (ctx) => {
               await flushDiffRecordsWithContext(ctx);
-              await disposeTracking?.({ context: ctx });
+              await safelyDisposeTracking(ctx);
             });
             return;
           }
@@ -242,7 +253,7 @@ function powerSyncCollectionOptions(config) {
           const viewWhereClause = toInlinedWhereClause(compiledView);
           await database.writeLock(async (ctx) => {
             await flushDiffRecordsWithContext(ctx);
-            await disposeTracking?.({ context: ctx });
+            await safelyDisposeTracking(ctx);
             disposeTracking = await createDiffTrigger({
               setupContext: ctx,
               when: {

package/dist/cjs/powersync.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"powersync.cjs","sources":["../../src/powersync.ts"],"sourcesContent":["import { DiffTriggerOperation, sanitizeSQL } from '@powersync/common'\nimport { or } from '@tanstack/db'\nimport { compileSQLite } from './sqlite-compiler'\nimport { PendingOperationStore } from './PendingOperationStore'\nimport { PowerSyncTransactor } from './PowerSyncTransactor'\nimport { DEFAULT_BATCH_SIZE } from './definitions'\nimport { asPowerSyncRecord, mapOperation } from './helpers'\nimport { convertTableToSchema } from './schema'\nimport { serializeForSQLite } from './serialization'\nimport type {\n  CleanupFn,\n  LoadSubsetOptions,\n  OperationType,\n  SyncConfig,\n} from '@tanstack/db'\nimport type {\n  AnyTableColumnType,\n  ExtractedTable,\n  ExtractedTableColumns,\n  MapBaseColumnType,\n  OptionalExtractedTable,\n} from './helpers'\nimport type {\n  BasePowerSyncCollectionConfig,\n  ConfigWithArbitraryCollectionTypes,\n  ConfigWithSQLiteInputType,\n  ConfigWithSQLiteTypes,\n  CustomSQLiteSerializer,\n  EnhancedPowerSyncCollectionConfig,\n  InferPowerSyncOutputType,\n  PowerSyncCollectionConfig,\n  PowerSyncCollectionUtils,\n} from './definitions'\nimport type { PendingOperation } from './PendingOperationStore'\nimport type { StandardSchemaV1 } from '@standard-schema/spec'\nimport type { LockContext, Table, TriggerDiffRecord } from '@powersync/common'\n\n/**\n * Creates PowerSync collection options for use with a standard Collection.\n *\n * @template TTable - The SQLite-based typing\n * @template TSchema - The validation schema type (optionally supports a custom input type)\n * @param config - Configuration options for the PowerSync collection\n * @returns Collection options with utilities\n */\n\n// Overload 1: No schema is provided\n\n/**\n * Creates a PowerSync collection configuration with basic default validation.\n * Input and Output types are the SQLite column types.\n *\n * @example\n * ```typescript\n * const APP_SCHEMA = new Schema({\n *   documents: new Table({\n *     name: column.text,\n *   }),\n * })\n *\n * type Document = (typeof APP_SCHEMA)[\"types\"][\"documents\"]\n *\n * const db = new PowerSyncDatabase({\n *   database: {\n *     dbFilename: \"test.sqlite\",\n *   },\n *   schema: APP_SCHEMA,\n * })\n *\n * const collection = createCollection(\n *   powerSyncCollectionOptions({\n *     database: db,\n *     table: APP_SCHEMA.props.documents\n *   })\n * )\n * ```\n */\nexport function powerSyncCollectionOptions<TTable extends Table = Table>(\n  config: BasePowerSyncCollectionConfig<TTable, never> & ConfigWithSQLiteTypes,\n): EnhancedPowerSyncCollectionConfig<\n  TTable,\n  OptionalExtractedTable<TTable>,\n  never\n>\n\n// Overload 2: Schema is provided and the TInput matches SQLite types.\n\n/**\n * Creates a PowerSync collection configuration with schema validation.\n *\n * The input types satisfy the SQLite column types.\n *\n * The output types are defined by the provided schema. This schema can enforce additional\n * validation or type transforms.\n * Arbitrary output typed mutations are encoded to SQLite for persistence. We provide a basic standard\n * serialization implementation to serialize column values. Custom or advanced types require providing additional\n * serializer specifications. Partial column overrides can be supplied to `serializer`.\n *\n * @example\n * ```typescript\n * import { z } from \"zod\"\n *\n * // The PowerSync SQLite schema\n * const APP_SCHEMA = new Schema({\n *   documents: new Table({\n *     name: column.text,\n *     // Dates are stored as ISO date strings in SQLite\n *     created_at: column.text\n *   }),\n * })\n *\n * // Advanced Zod validations. The output type of this schema\n * // is constrained to the SQLite schema of APP_SCHEMA\n * const schema = z.object({\n *   id: z.string(),\n *   // Notice that `name` is not nullable (is required) here and it has additional validation\n *   name: z.string().min(3, { message: \"Should be at least 3 characters\" }).nullable(),\n *   // The input type is still the SQLite string type. While collections will output smart Date instances.\n *   created_at: z.string().transform(val => new Date(val))\n * })\n *\n * const collection = createCollection(\n *   powerSyncCollectionOptions({\n *     database: db,\n *     table: APP_SCHEMA.props.documents,\n *     schema,\n *     serializer: {\n *        // The default is toISOString, this is just to demonstrate custom overrides\n *        created_at: (outputValue) => outputValue.toISOString(),\n *     },\n *   })\n * )\n * ```\n */\nexport function powerSyncCollectionOptions<\n  TTable extends Table,\n  TSchema extends StandardSchemaV1<\n    // TInput is the SQLite types. We can use the supplied schema to validate sync input\n    OptionalExtractedTable<TTable>,\n    AnyTableColumnType<TTable>\n  >,\n>(\n  config: BasePowerSyncCollectionConfig<TTable, TSchema> &\n    ConfigWithSQLiteInputType<TTable, TSchema>,\n): EnhancedPowerSyncCollectionConfig<\n  TTable,\n  InferPowerSyncOutputType<TTable, TSchema>,\n  TSchema\n> & {\n  schema: TSchema\n}\n\n// Overload 3: Schema is provided with arbitrary TInput and TOutput\n/**\n * Creates a PowerSync collection configuration with schema validation.\n *\n * The input types are not linked to the internal SQLite table types. This can\n * give greater flexibility, e.g. by accepting rich types as input for `insert` or `update` operations.\n * An additional `deserializationSchema` is required in order to process incoming SQLite updates to the output type.\n *\n * The output types are defined by the provided schema. This schema can enforce additional\n * validation or type transforms.\n * Arbitrary output typed mutations are encoded to SQLite for persistence. We provide a basic standard\n * serialization implementation to serialize column values. Custom or advanced types require providing additional\n * serializer specifications. Partial column overrides can be supplied to `serializer`.\n *\n * @example\n * ```typescript\n * import { z } from \"zod\"\n *\n * // The PowerSync SQLite schema\n * const APP_SCHEMA = new Schema({\n *   documents: new Table({\n *     name: column.text,\n *     // Booleans are represented as integers in SQLite\n *     is_active: column.integer\n *   }),\n * })\n *\n * // Advanced Zod validations.\n * // We accept boolean values as input for operations and expose Booleans in query results\n * const schema = z.object({\n *   id: z.string(),\n *   isActive: z.boolean(), // TInput and TOutput are boolean\n * })\n *\n * // The deserializationSchema converts the SQLite synced INTEGER (0/1) values to booleans.\n * const deserializationSchema = z.object({\n *   id: z.string(),\n *   isActive: z.number().nullable().transform((val) => val == null ? true : val > 0),\n * })\n *\n * const collection = createCollection(\n *   powerSyncCollectionOptions({\n *     database: db,\n *     table: APP_SCHEMA.props.documents,\n *     schema,\n *     deserializationSchema,\n *   })\n * )\n * ```\n */\nexport function powerSyncCollectionOptions<\n  TTable extends Table,\n  TSchema extends StandardSchemaV1<\n    // The input and output must have the same keys, the value types can be arbitrary\n    AnyTableColumnType<TTable>,\n    AnyTableColumnType<TTable>\n  >,\n>(\n  config: BasePowerSyncCollectionConfig<TTable, TSchema> &\n    ConfigWithArbitraryCollectionTypes<TTable, TSchema>,\n): EnhancedPowerSyncCollectionConfig<\n  TTable,\n  InferPowerSyncOutputType<TTable, TSchema>,\n  TSchema\n> & {\n  utils: PowerSyncCollectionUtils<TTable>\n  schema: TSchema\n}\n\n/**\n * Implementation of powerSyncCollectionOptions that handles both schema and non-schema configurations.\n */\n\nexport function powerSyncCollectionOptions<\n  TTable extends Table,\n  TSchema extends StandardSchemaV1<any> = never,\n>(config: PowerSyncCollectionConfig<TTable, TSchema>) {\n  const {\n    database,\n    table,\n    schema: inputSchema,\n    syncBatchSize = DEFAULT_BATCH_SIZE,\n    syncMode = 'eager',\n    ...restConfig\n  } = config\n\n  const deserializationSchema =\n    `deserializationSchema` in config ? config.deserializationSchema : null\n  const serializer = `serializer` in config ? config.serializer : undefined\n  const onDeserializationError =\n    `onDeserializationError` in config\n      ? config.onDeserializationError\n      : undefined\n\n  // The SQLite table type\n  type TableType = ExtractedTable<TTable>\n\n  // The collection output type\n  type OutputType = InferPowerSyncOutputType<TTable, TSchema>\n\n  const { viewName, trackMetadata: metadataIsTracked } = table\n\n  /**\n   * Deserializes data from the incoming sync stream\n   */\n  const deserializeSyncRow = (value: TableType): OutputType => {\n    const validationSchema = deserializationSchema || schema\n    const validation = validationSchema[`~standard`].validate(value)\n    if (`value` in validation) {\n      return validation.value\n    } else if (`issues` in validation) {\n      const issueMessage = `Failed to validate incoming data for ${viewName}. Issues: ${validation.issues.map((issue) => `${issue.path} - ${issue.message}`)}`\n      database.logger.error(issueMessage)\n      onDeserializationError!(validation)\n      throw new Error(issueMessage)\n    } else {\n      const unknownErrorMessage = `Unknown deserialization error for ${viewName}`\n      database.logger.error(unknownErrorMessage)\n      onDeserializationError!({ issues: [{ message: unknownErrorMessage }] })\n      throw new Error(unknownErrorMessage)\n    }\n  }\n\n  // We can do basic runtime validations for columns if not explicit schema has been provided\n  const schema = inputSchema ?? (convertTableToSchema(table) as TSchema)\n  /**\n   * The onInsert, onUpdate, and onDelete handlers should only return\n   * after we have written the changes to TanStack DB.\n   * We currently only write to TanStack DB from a diff trigger.\n   * We wait for the diff trigger to observe the change,\n   * and only then return from the on[X] handlers.\n   * This ensures that when the transaction is reported as\n   * complete to the caller, the in-memory state is already\n   * consistent with the database.\n   */\n  const pendingOperationStore = PendingOperationStore.GLOBAL\n  // Keep the tracked table unique in case of multiple tabs.\n  const trackedTableName = `__${viewName}_tracking_${Math.floor(\n    Math.random() * 0xffffffff,\n  )\n    .toString(16)\n    .padStart(8, `0`)}`\n\n  const transactor = new PowerSyncTransactor({\n    database,\n  })\n\n  /**\n   * \"sync\"\n   * Notice that this describes the Sync between the local SQLite table\n   * and the in-memory tanstack-db collection.\n   */\n  const sync: SyncConfig<OutputType, string> = {\n    sync: (params) => {\n      const { begin, write, collection, commit, markReady } = params\n      const abortController = new AbortController()\n\n      let disposeTracking:\n        | ((options?: { context?: LockContext }) => Promise<void>)\n        | null = null\n\n      if (syncMode === `eager`) {\n        return runEagerSync()\n      } else {\n        return runOnDemandSync()\n      }\n\n      async function createDiffTrigger(options: {\n        setupContext?: LockContext\n        when: Record<DiffTriggerOperation, string>\n        writeType: (rowId: string) => OperationType\n        batchQuery: (\n          lockContext: LockContext,\n          batchSize: number,\n          cursor: number,\n        ) => Promise<Array<TableType>>\n        onReady: () => void\n      }) {\n        const { setupContext, when, writeType, batchQuery, onReady } = options\n\n        return await database.triggers.createDiffTrigger({\n          source: viewName,\n          destination: trackedTableName,\n          setupContext,\n          when,\n          hooks: {\n            beforeCreate: async (context) => {\n              let currentBatchCount = syncBatchSize\n              let cursor = 0\n              while (currentBatchCount == syncBatchSize) {\n                begin()\n\n                const batchItems = await batchQuery(\n                  context,\n                  syncBatchSize,\n                  cursor,\n                )\n                currentBatchCount = batchItems.length\n                cursor += currentBatchCount\n                for (const row of batchItems) {\n                  write({\n                    type: writeType(row.id),\n                    value: deserializeSyncRow(row),\n                  })\n                }\n                commit()\n              }\n              onReady()\n              database.logger.info(\n                `Sync is ready for ${viewName} into ${trackedTableName}`,\n              )\n            },\n          },\n        })\n      }\n\n      async function flushDiffRecords(): Promise<void> {\n        await database\n          .writeTransaction(async (context) => {\n            await flushDiffRecordsWithContext(context)\n          })\n          .catch((error) => {\n            database.logger.error(\n              `An error has been detected in the sync handler`,\n              error,\n            )\n          })\n      }\n\n      // We can use this directly if we want to pair a flush with dispose+recreate diff trigger.\n      async function flushDiffRecordsWithContext(\n        context: LockContext,\n      ): Promise<void> {\n        try {\n          begin()\n          const operations = await context.getAll<TriggerDiffRecord>(\n            `SELECT * FROM ${trackedTableName} ORDER BY operation_id ASC`,\n          )\n          const pendingOperations: Array<PendingOperation> = []\n\n          for (const op of operations) {\n            const { id, operation, timestamp, value } = op\n            const parsedValue = deserializeSyncRow({\n              id,\n              ...JSON.parse(value),\n            })\n            const parsedPreviousValue =\n              op.operation == DiffTriggerOperation.UPDATE\n                ? deserializeSyncRow({\n                    id,\n                    ...JSON.parse(op.previous_value),\n                  })\n                : undefined\n            write({\n              type: mapOperation(operation),\n              value: parsedValue,\n              previousValue: parsedPreviousValue,\n            })\n            pendingOperations.push({\n              id,\n              operation,\n              timestamp,\n              tableName: viewName,\n            })\n          }\n\n          // clear the current operations\n          await context.execute(`DELETE FROM ${trackedTableName}`)\n\n          commit()\n          pendingOperationStore.resolvePendingFor(pendingOperations)\n        } catch (error) {\n          database.logger.error(\n            `An error has been detected in the sync handler`,\n            error,\n          )\n        }\n      }\n\n      // The sync function needs to be synchronous.\n      async function start(afterOnChangeRegistered?: () => Promise<void>) {\n        database.logger.info(\n          `Sync is starting for ${viewName} into ${trackedTableName}`,\n        )\n        database.onChangeWithCallback(\n          {\n            onChange: async () => {\n              await flushDiffRecords()\n            },\n          },\n          {\n            signal: abortController.signal,\n            triggerImmediate: false,\n            tables: [trackedTableName],\n          },\n        )\n\n        await afterOnChangeRegistered?.()\n\n        // If the abort controller was aborted while processing the request above\n        if (abortController.signal.aborted) {\n          await disposeTracking?.()\n        } else {\n          abortController.signal.addEventListener(\n            `abort`,\n            async () => {\n              await disposeTracking?.()\n            },\n            { once: true },\n          )\n        }\n      }\n\n      // Eager mode.\n      // Registers a diff trigger for the entire table.\n      function runEagerSync() {\n        let onUnload: CleanupFn | void | null = null\n\n        start(async () => {\n          onUnload = await restConfig.onLoad?.()\n\n          disposeTracking = await createDiffTrigger({\n            when: {\n              [DiffTriggerOperation.INSERT]: `TRUE`,\n              [DiffTriggerOperation.UPDATE]: `TRUE`,\n              [DiffTriggerOperation.DELETE]: `TRUE`,\n            },\n            writeType: (_rowId: string) => `insert`,\n            batchQuery: (\n              lockContext: LockContext,\n              batchSize: number,\n              cursor: number,\n            ) =>\n              lockContext.getAll<TableType>(\n                sanitizeSQL`SELECT * FROM ${viewName} LIMIT ? OFFSET ?`,\n                [batchSize, cursor],\n              ),\n            onReady: () => markReady(),\n          })\n        }).catch((error) =>\n          database.logger.error(\n            `Could not start syncing process for ${viewName} into ${trackedTableName}`,\n            error,\n          ),\n        )\n\n        return () => {\n          database.logger.info(\n            `Sync has been stopped for ${viewName} into ${trackedTableName}`,\n          )\n          abortController.abort()\n          onUnload?.()\n        }\n      }\n\n      // On-demand mode.\n      // Registers a diff trigger for the active WHERE expressions.\n      function runOnDemandSync() {\n        let onUnloadSubset: CleanupFn | void | null = null\n\n        start().catch((error) =>\n          database.logger.error(\n            `Could not start syncing process for ${viewName} into ${trackedTableName}`,\n            error,\n          ),\n        )\n\n        // Tracks all active WHERE expressions for on-demand sync filtering.\n        // Each loadSubset call pushes its predicate; unloadSubset removes it.\n        const activeWhereExpressions: Array<LoadSubsetOptions['where']> = []\n\n        const loadSubset = async (\n          options?: LoadSubsetOptions,\n        ): Promise<void> => {\n          if (options) {\n            activeWhereExpressions.push(options.where)\n            onUnloadSubset = await restConfig.onLoadSubset?.(options)\n          }\n\n          if (activeWhereExpressions.length === 0) {\n            await database.writeLock(async (ctx) => {\n              await flushDiffRecordsWithContext(ctx)\n              await disposeTracking?.({ context: ctx })\n            })\n            return\n          }\n\n          const combinedWhere =\n            activeWhereExpressions.length === 1\n              ? activeWhereExpressions[0]\n              : or(\n                  activeWhereExpressions[0],\n                  activeWhereExpressions[1],\n                  ...activeWhereExpressions.slice(2),\n                )\n\n          const compiledNewData = compileSQLite(\n            { where: combinedWhere },\n            { jsonColumn: 'NEW.data' },\n          )\n\n          const compiledOldData = compileSQLite(\n            { where: combinedWhere },\n            { jsonColumn: 'OLD.data' },\n          )\n\n          const compiledView = compileSQLite({ where: combinedWhere })\n\n          const newDataWhenClause = toInlinedWhereClause(compiledNewData)\n          const oldDataWhenClause = toInlinedWhereClause(compiledOldData)\n          const viewWhereClause = toInlinedWhereClause(compiledView)\n\n          await database.writeLock(async (ctx) => {\n            await flushDiffRecordsWithContext(ctx)\n            await disposeTracking?.({ context: ctx })\n\n            disposeTracking = await createDiffTrigger({\n              setupContext: ctx,\n              when: {\n                [DiffTriggerOperation.INSERT]: newDataWhenClause,\n                [DiffTriggerOperation.UPDATE]: `(${newDataWhenClause}) OR (${oldDataWhenClause})`,\n                [DiffTriggerOperation.DELETE]: oldDataWhenClause,\n              },\n              writeType: (rowId: string) =>\n                collection.has(rowId) ? `update` : `insert`,\n              batchQuery: (\n                lockContext: LockContext,\n                batchSize: number,\n                cursor: number,\n              ) =>\n                lockContext.getAll<TableType>(\n                  `SELECT * FROM ${viewName} WHERE ${viewWhereClause} LIMIT ? OFFSET ?`,\n                  [batchSize, cursor],\n                ),\n              onReady: () => {},\n            })\n          })\n        }\n\n        const toInlinedWhereClause = (compiled: {\n          where?: string\n          params: Array<unknown>\n        }): string => {\n          if (!compiled.where) return 'TRUE'\n          const sqlParts = compiled.where.split('?')\n          return sanitizeSQL(\n            sqlParts as unknown as TemplateStringsArray,\n            ...compiled.params,\n          )\n        }\n\n        const unloadSubset = async (options: LoadSubsetOptions) => {\n          onUnloadSubset?.()\n\n          const idx = activeWhereExpressions.indexOf(options.where)\n          if (idx !== -1) {\n            activeWhereExpressions.splice(idx, 1)\n          }\n\n          // Evict rows that were exclusively loaded by the departing predicate.\n          // These are rows matching the departing WHERE that are no longer covered\n          // by any remaining active predicate.\n          const compiledDeparting = compileSQLite({ where: options.where })\n          const departingWhereSQL = toInlinedWhereClause(compiledDeparting)\n\n          let evictionSQL: string\n          if (activeWhereExpressions.length === 0) {\n            evictionSQL = `SELECT id FROM ${viewName} WHERE ${departingWhereSQL}`\n          } else {\n            const combinedRemaining =\n              activeWhereExpressions.length === 1\n                ? activeWhereExpressions[0]!\n                : or(\n                    activeWhereExpressions[0],\n                    activeWhereExpressions[1],\n                    ...activeWhereExpressions.slice(2),\n                  )\n            const compiledRemaining = compileSQLite({\n              where: combinedRemaining,\n            })\n            const remainingWhereSQL = toInlinedWhereClause(compiledRemaining)\n            evictionSQL = `SELECT id FROM ${viewName} WHERE (${departingWhereSQL}) AND NOT (${remainingWhereSQL})`\n          }\n\n          const rowsToEvict = await database.getAll<{ id: string }>(evictionSQL)\n          if (rowsToEvict.length > 0) {\n            begin()\n            for (const { id } of rowsToEvict) {\n              write({ type: `delete`, key: id })\n            }\n            commit()\n          }\n\n          // Recreate the diff trigger for the remaining active WHERE expressions.\n          await loadSubset()\n        }\n\n        markReady()\n\n        return {\n          cleanup: () => {\n            database.logger.info(\n              `Sync has been stopped for ${viewName} into ${trackedTableName}`,\n            )\n            abortController.abort()\n          },\n          loadSubset: (options: LoadSubsetOptions) => loadSubset(options),\n          unloadSubset: (options: LoadSubsetOptions) => unloadSubset(options),\n        }\n      }\n    },\n    // Expose the getSyncMetadata function\n    getSyncMetadata: undefined,\n  }\n\n  const getKey = (record: OutputType) => asPowerSyncRecord(record).id\n\n  const outputConfig: EnhancedPowerSyncCollectionConfig<\n    TTable,\n    OutputType,\n    TSchema\n  > = {\n    ...restConfig,\n    schema,\n    getKey,\n    // Syncing should start immediately since we need to monitor the changes for mutations\n    startSync: true,\n    syncMode,\n    sync,\n    onInsert: async (params) => {\n      // The transaction here should only ever contain a single insert mutation\n      return await transactor.applyTransaction(params.transaction)\n    },\n    onUpdate: async (params) => {\n      // The transaction here should only ever contain a single update mutation\n      return await transactor.applyTransaction(params.transaction)\n    },\n    onDelete: async (params) => {\n      // The transaction here should only ever contain a single delete mutation\n      return await transactor.applyTransaction(params.transaction)\n    },\n    utils: {\n      getMeta: () => ({\n        tableName: viewName,\n        trackedTableName,\n        metadataIsTracked,\n        serializeValue: (value) =>\n          serializeForSQLite(\n            value,\n            // This is required by the input generic\n            table as Table<\n              MapBaseColumnType<InferPowerSyncOutputType<TTable, TSchema>>\n            >,\n            // Coerce serializer to the shape that corresponds to the Table constructed from OutputType\n            serializer as CustomSQLiteSerializer<\n              OutputType,\n              ExtractedTableColumns<Table<MapBaseColumnType<OutputType>>>\n            >,\n          ),\n      }),\n    },\n  }\n  return outputConfig\n}\n"],"names":["DEFAULT_BATCH_SIZE","schema","convertTableToSchema","PendingOperationStore","PowerSyncTransactor","DiffTriggerOperation","mapOperation","sanitizeSQL","or","compileSQLite","asPowerSyncRecord","serializeForSQLite"],"mappings":"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"}
+{"version":3,"file":"powersync.cjs","sources":["../../src/powersync.ts"],"sourcesContent":["import { DiffTriggerOperation, sanitizeSQL } from '@powersync/common'\nimport { or } from '@tanstack/db'\nimport { compileSQLite } from './sqlite-compiler'\nimport { PendingOperationStore } from './PendingOperationStore'\nimport { PowerSyncTransactor } from './PowerSyncTransactor'\nimport { DEFAULT_BATCH_SIZE } from './definitions'\nimport { asPowerSyncRecord, mapOperation } from './helpers'\nimport { convertTableToSchema } from './schema'\nimport { serializeForSQLite } from './serialization'\nimport type {\n  CleanupFn,\n  LoadSubsetOptions,\n  OperationType,\n  SyncConfig,\n} from '@tanstack/db'\nimport type {\n  AnyTableColumnType,\n  ExtractedTable,\n  ExtractedTableColumns,\n  MapBaseColumnType,\n  OptionalExtractedTable,\n} from './helpers'\nimport type {\n  BasePowerSyncCollectionConfig,\n  ConfigWithArbitraryCollectionTypes,\n  ConfigWithSQLiteInputType,\n  ConfigWithSQLiteTypes,\n  CustomSQLiteSerializer,\n  EnhancedPowerSyncCollectionConfig,\n  InferPowerSyncOutputType,\n  PowerSyncCollectionConfig,\n  PowerSyncCollectionUtils,\n} from './definitions'\nimport type { PendingOperation } from './PendingOperationStore'\nimport type { StandardSchemaV1 } from '@standard-schema/spec'\nimport type { LockContext, Table, TriggerDiffRecord } from '@powersync/common'\n\n/**\n * Creates PowerSync collection options for use with a standard Collection.\n *\n * @template TTable - The SQLite-based typing\n * @template TSchema - The validation schema type (optionally supports a custom input type)\n * @param config - Configuration options for the PowerSync collection\n * @returns Collection options with utilities\n */\n\n// Overload 1: No schema is provided\n\n/**\n * Creates a PowerSync collection configuration with basic default validation.\n * Input and Output types are the SQLite column types.\n *\n * @example\n * ```typescript\n * const APP_SCHEMA = new Schema({\n *   documents: new Table({\n *     name: column.text,\n *   }),\n * })\n *\n * type Document = (typeof APP_SCHEMA)[\"types\"][\"documents\"]\n *\n * const db = new PowerSyncDatabase({\n *   database: {\n *     dbFilename: \"test.sqlite\",\n *   },\n *   schema: APP_SCHEMA,\n * })\n *\n * const collection = createCollection(\n *   powerSyncCollectionOptions({\n *     database: db,\n *     table: APP_SCHEMA.props.documents\n *   })\n * )\n * ```\n */\nexport function powerSyncCollectionOptions<TTable extends Table = Table>(\n  config: BasePowerSyncCollectionConfig<TTable, never> & ConfigWithSQLiteTypes,\n): EnhancedPowerSyncCollectionConfig<\n  TTable,\n  OptionalExtractedTable<TTable>,\n  never\n>\n\n// Overload 2: Schema is provided and the TInput matches SQLite types.\n\n/**\n * Creates a PowerSync collection configuration with schema validation.\n *\n * The input types satisfy the SQLite column types.\n *\n * The output types are defined by the provided schema. This schema can enforce additional\n * validation or type transforms.\n * Arbitrary output typed mutations are encoded to SQLite for persistence. We provide a basic standard\n * serialization implementation to serialize column values. Custom or advanced types require providing additional\n * serializer specifications. Partial column overrides can be supplied to `serializer`.\n *\n * @example\n * ```typescript\n * import { z } from \"zod\"\n *\n * // The PowerSync SQLite schema\n * const APP_SCHEMA = new Schema({\n *   documents: new Table({\n *     name: column.text,\n *     // Dates are stored as ISO date strings in SQLite\n *     created_at: column.text\n *   }),\n * })\n *\n * // Advanced Zod validations. The output type of this schema\n * // is constrained to the SQLite schema of APP_SCHEMA\n * const schema = z.object({\n *   id: z.string(),\n *   // Notice that `name` is not nullable (is required) here and it has additional validation\n *   name: z.string().min(3, { message: \"Should be at least 3 characters\" }).nullable(),\n *   // The input type is still the SQLite string type. While collections will output smart Date instances.\n *   created_at: z.string().transform(val => new Date(val))\n * })\n *\n * const collection = createCollection(\n *   powerSyncCollectionOptions({\n *     database: db,\n *     table: APP_SCHEMA.props.documents,\n *     schema,\n *     serializer: {\n *        // The default is toISOString, this is just to demonstrate custom overrides\n *        created_at: (outputValue) => outputValue.toISOString(),\n *     },\n *   })\n * )\n * ```\n */\nexport function powerSyncCollectionOptions<\n  TTable extends Table,\n  TSchema extends StandardSchemaV1<\n    // TInput is the SQLite types. We can use the supplied schema to validate sync input\n    OptionalExtractedTable<TTable>,\n    AnyTableColumnType<TTable>\n  >,\n>(\n  config: BasePowerSyncCollectionConfig<TTable, TSchema> &\n    ConfigWithSQLiteInputType<TTable, TSchema>,\n): EnhancedPowerSyncCollectionConfig<\n  TTable,\n  InferPowerSyncOutputType<TTable, TSchema>,\n  TSchema\n> & {\n  schema: TSchema\n}\n\n// Overload 3: Schema is provided with arbitrary TInput and TOutput\n/**\n * Creates a PowerSync collection configuration with schema validation.\n *\n * The input types are not linked to the internal SQLite table types. This can\n * give greater flexibility, e.g. by accepting rich types as input for `insert` or `update` operations.\n * An additional `deserializationSchema` is required in order to process incoming SQLite updates to the output type.\n *\n * The output types are defined by the provided schema. This schema can enforce additional\n * validation or type transforms.\n * Arbitrary output typed mutations are encoded to SQLite for persistence. We provide a basic standard\n * serialization implementation to serialize column values. Custom or advanced types require providing additional\n * serializer specifications. Partial column overrides can be supplied to `serializer`.\n *\n * @example\n * ```typescript\n * import { z } from \"zod\"\n *\n * // The PowerSync SQLite schema\n * const APP_SCHEMA = new Schema({\n *   documents: new Table({\n *     name: column.text,\n *     // Booleans are represented as integers in SQLite\n *     is_active: column.integer\n *   }),\n * })\n *\n * // Advanced Zod validations.\n * // We accept boolean values as input for operations and expose Booleans in query results\n * const schema = z.object({\n *   id: z.string(),\n *   isActive: z.boolean(), // TInput and TOutput are boolean\n * })\n *\n * // The deserializationSchema converts the SQLite synced INTEGER (0/1) values to booleans.\n * const deserializationSchema = z.object({\n *   id: z.string(),\n *   isActive: z.number().nullable().transform((val) => val == null ? true : val > 0),\n * })\n *\n * const collection = createCollection(\n *   powerSyncCollectionOptions({\n *     database: db,\n *     table: APP_SCHEMA.props.documents,\n *     schema,\n *     deserializationSchema,\n *   })\n * )\n * ```\n */\nexport function powerSyncCollectionOptions<\n  TTable extends Table,\n  TSchema extends StandardSchemaV1<\n    // The input and output must have the same keys, the value types can be arbitrary\n    AnyTableColumnType<TTable>,\n    AnyTableColumnType<TTable>\n  >,\n>(\n  config: BasePowerSyncCollectionConfig<TTable, TSchema> &\n    ConfigWithArbitraryCollectionTypes<TTable, TSchema>,\n): EnhancedPowerSyncCollectionConfig<\n  TTable,\n  InferPowerSyncOutputType<TTable, TSchema>,\n  TSchema\n> & {\n  utils: PowerSyncCollectionUtils<TTable>\n  schema: TSchema\n}\n\n/**\n * Implementation of powerSyncCollectionOptions that handles both schema and non-schema configurations.\n */\n\nexport function powerSyncCollectionOptions<\n  TTable extends Table,\n  TSchema extends StandardSchemaV1<any> = never,\n>(config: PowerSyncCollectionConfig<TTable, TSchema>) {\n  const {\n    database,\n    table,\n    schema: inputSchema,\n    syncBatchSize = DEFAULT_BATCH_SIZE,\n    syncMode = 'eager',\n    ...restConfig\n  } = config\n\n  const deserializationSchema =\n    `deserializationSchema` in config ? config.deserializationSchema : null\n  const serializer = `serializer` in config ? config.serializer : undefined\n  const onDeserializationError =\n    `onDeserializationError` in config\n      ? config.onDeserializationError\n      : undefined\n\n  // The SQLite table type\n  type TableType = ExtractedTable<TTable>\n\n  // The collection output type\n  type OutputType = InferPowerSyncOutputType<TTable, TSchema>\n\n  const { viewName, trackMetadata: metadataIsTracked } = table\n\n  /**\n   * Deserializes data from the incoming sync stream\n   */\n  const deserializeSyncRow = (value: TableType): OutputType => {\n    const validationSchema = deserializationSchema || schema\n    const validation = validationSchema[`~standard`].validate(value)\n    if (`value` in validation) {\n      return validation.value\n    } else if (`issues` in validation) {\n      const issueMessage = `Failed to validate incoming data for ${viewName}. Issues: ${validation.issues.map((issue) => `${issue.path} - ${issue.message}`)}`\n      database.logger.error(issueMessage)\n      onDeserializationError!(validation)\n      throw new Error(issueMessage)\n    } else {\n      const unknownErrorMessage = `Unknown deserialization error for ${viewName}`\n      database.logger.error(unknownErrorMessage)\n      onDeserializationError!({ issues: [{ message: unknownErrorMessage }] })\n      throw new Error(unknownErrorMessage)\n    }\n  }\n\n  // We can do basic runtime validations for columns if not explicit schema has been provided\n  const schema = inputSchema ?? (convertTableToSchema(table) as TSchema)\n  /**\n   * The onInsert, onUpdate, and onDelete handlers should only return\n   * after we have written the changes to TanStack DB.\n   * We currently only write to TanStack DB from a diff trigger.\n   * We wait for the diff trigger to observe the change,\n   * and only then return from the on[X] handlers.\n   * This ensures that when the transaction is reported as\n   * complete to the caller, the in-memory state is already\n   * consistent with the database.\n   */\n  const pendingOperationStore = PendingOperationStore.GLOBAL\n  // Keep the tracked table unique in case of multiple tabs.\n  const trackedTableName = `__${viewName}_tracking_${Math.floor(\n    Math.random() * 0xffffffff,\n  )\n    .toString(16)\n    .padStart(8, `0`)}`\n\n  const transactor = new PowerSyncTransactor({\n    database,\n  })\n\n  /**\n   * \"sync\"\n   * Notice that this describes the Sync between the local SQLite table\n   * and the in-memory tanstack-db collection.\n   */\n  const sync: SyncConfig<OutputType, string> = {\n    sync: (params) => {\n      const { begin, write, collection, commit, markReady } = params\n      const abortController = new AbortController()\n\n      let disposeTracking:\n        | ((options?: { context?: LockContext }) => Promise<void>)\n        | null = null\n\n      if (syncMode === `eager`) {\n        return runEagerSync()\n      } else {\n        return runOnDemandSync()\n      }\n\n      /**\n       * Disposes the current diff trigger, if one is active, and clears the\n       * tracking state.\n       */\n      async function safelyDisposeTracking(\n        context?: LockContext,\n      ): Promise<void> {\n        const dispose = disposeTracking\n        if (!dispose) {\n          return\n        }\n\n        disposeTracking = null\n        await dispose(context ? { context } : undefined)\n      }\n\n      async function createDiffTrigger(options: {\n        setupContext?: LockContext\n        when: Record<DiffTriggerOperation, string>\n        writeType: (rowId: string) => OperationType\n        batchQuery: (\n          lockContext: LockContext,\n          batchSize: number,\n          cursor: number,\n        ) => Promise<Array<TableType>>\n        onReady: () => void\n      }) {\n        const { setupContext, when, writeType, batchQuery, onReady } = options\n\n        return await database.triggers.createDiffTrigger({\n          source: viewName,\n          destination: trackedTableName,\n          setupContext,\n          when,\n          hooks: {\n            beforeCreate: async (context) => {\n              let currentBatchCount = syncBatchSize\n              let cursor = 0\n              while (currentBatchCount == syncBatchSize) {\n                begin()\n\n                const batchItems = await batchQuery(\n                  context,\n                  syncBatchSize,\n                  cursor,\n                )\n                currentBatchCount = batchItems.length\n                cursor += currentBatchCount\n                for (const row of batchItems) {\n                  write({\n                    type: writeType(row.id),\n                    value: deserializeSyncRow(row),\n                  })\n                }\n                commit()\n              }\n              onReady()\n              database.logger.info(\n                `Sync is ready for ${viewName} into ${trackedTableName}`,\n              )\n            },\n          },\n        })\n      }\n\n      async function flushDiffRecords(): Promise<void> {\n        await database\n          .writeTransaction(async (context) => {\n            await flushDiffRecordsWithContext(context)\n          })\n          .catch((error) => {\n            database.logger.error(\n              `An error has been detected in the sync handler`,\n              error,\n            )\n          })\n      }\n\n      // We can use this directly if we want to pair a flush with dispose+recreate diff trigger.\n      async function flushDiffRecordsWithContext(\n        context: LockContext,\n      ): Promise<void> {\n        // There is nothing to flush if no tracking table is currently active.\n        if (!disposeTracking) {\n          return\n        }\n\n        try {\n          begin()\n          const operations = await context.getAll<TriggerDiffRecord>(\n            `SELECT * FROM ${trackedTableName} ORDER BY operation_id ASC`,\n          )\n          const pendingOperations: Array<PendingOperation> = []\n\n          for (const op of operations) {\n            const { id, operation, timestamp, value } = op\n            const parsedValue = deserializeSyncRow({\n              id,\n              ...JSON.parse(value),\n            })\n            const parsedPreviousValue =\n              op.operation == DiffTriggerOperation.UPDATE\n                ? deserializeSyncRow({\n                    id,\n                    ...JSON.parse(op.previous_value),\n                  })\n                : undefined\n            write({\n              type: mapOperation(operation),\n              value: parsedValue,\n              previousValue: parsedPreviousValue,\n            })\n            pendingOperations.push({\n              id,\n              operation,\n              timestamp,\n              tableName: viewName,\n            })\n          }\n\n          // clear the current operations\n          await context.execute(`DELETE FROM ${trackedTableName}`)\n\n          commit()\n          pendingOperationStore.resolvePendingFor(pendingOperations)\n        } catch (error) {\n          database.logger.error(\n            `An error has been detected in the sync handler`,\n            error,\n          )\n        }\n      }\n\n      // The sync function needs to be synchronous.\n      async function start(afterOnChangeRegistered?: () => Promise<void>) {\n        database.logger.info(\n          `Sync is starting for ${viewName} into ${trackedTableName}`,\n        )\n        database.onChangeWithCallback(\n          {\n            onChange: async () => {\n              await flushDiffRecords()\n            },\n          },\n          {\n            signal: abortController.signal,\n            triggerImmediate: false,\n            tables: [trackedTableName],\n          },\n        )\n\n        await afterOnChangeRegistered?.()\n\n        // If the abort controller was aborted while processing the request above\n        if (abortController.signal.aborted) {\n          await safelyDisposeTracking()\n        } else {\n          abortController.signal.addEventListener(\n            `abort`,\n            async () => {\n              await safelyDisposeTracking()\n            },\n            { once: true },\n          )\n        }\n      }\n\n      // Eager mode.\n      // Registers a diff trigger for the entire table.\n      function runEagerSync() {\n        let onUnload: CleanupFn | void | null = null\n\n        start(async () => {\n          onUnload = await restConfig.onLoad?.()\n\n          disposeTracking = await createDiffTrigger({\n            when: {\n              [DiffTriggerOperation.INSERT]: `TRUE`,\n              [DiffTriggerOperation.UPDATE]: `TRUE`,\n              [DiffTriggerOperation.DELETE]: `TRUE`,\n            },\n            writeType: (_rowId: string) => `insert`,\n            batchQuery: (\n              lockContext: LockContext,\n              batchSize: number,\n              cursor: number,\n            ) =>\n              lockContext.getAll<TableType>(\n                sanitizeSQL`SELECT * FROM ${viewName} LIMIT ? OFFSET ?`,\n                [batchSize, cursor],\n              ),\n            onReady: () => markReady(),\n          })\n        }).catch((error) =>\n          database.logger.error(\n            `Could not start syncing process for ${viewName} into ${trackedTableName}`,\n            error,\n          ),\n        )\n\n        return () => {\n          database.logger.info(\n            `Sync has been stopped for ${viewName} into ${trackedTableName}`,\n          )\n          abortController.abort()\n          onUnload?.()\n        }\n      }\n\n      // On-demand mode.\n      // Registers a diff trigger for the active WHERE expressions.\n      function runOnDemandSync() {\n        let onUnloadSubset: CleanupFn | void | null = null\n\n        start().catch((error) =>\n          database.logger.error(\n            `Could not start syncing process for ${viewName} into ${trackedTableName}`,\n            error,\n          ),\n        )\n\n        // Tracks all active WHERE expressions for on-demand sync filtering.\n        // Each loadSubset call pushes its predicate; unloadSubset removes it.\n        const activeWhereExpressions: Array<LoadSubsetOptions['where']> = []\n\n        const loadSubset = async (\n          options?: LoadSubsetOptions,\n        ): Promise<void> => {\n          if (options) {\n            activeWhereExpressions.push(options.where)\n            onUnloadSubset = await restConfig.onLoadSubset?.(options)\n          }\n\n          // No predicates remain, so stop tracking entirely. Both calls are no-ops\n          // when no tracking table is currently active.\n          if (activeWhereExpressions.length === 0) {\n            await database.writeLock(async (ctx) => {\n              await flushDiffRecordsWithContext(ctx)\n              await safelyDisposeTracking(ctx)\n            })\n            return\n          }\n\n          const combinedWhere =\n            activeWhereExpressions.length === 1\n              ? activeWhereExpressions[0]\n              : or(\n                  activeWhereExpressions[0],\n                  activeWhereExpressions[1],\n                  ...activeWhereExpressions.slice(2),\n                )\n\n          const compiledNewData = compileSQLite(\n            { where: combinedWhere },\n            { jsonColumn: 'NEW.data' },\n          )\n\n          const compiledOldData = compileSQLite(\n            { where: combinedWhere },\n            { jsonColumn: 'OLD.data' },\n          )\n\n          const compiledView = compileSQLite({ where: combinedWhere })\n\n          const newDataWhenClause = toInlinedWhereClause(compiledNewData)\n          const oldDataWhenClause = toInlinedWhereClause(compiledOldData)\n          const viewWhereClause = toInlinedWhereClause(compiledView)\n\n          await database.writeLock(async (ctx) => {\n            // Replace any active tracking with one covering the new set of\n            // predicates.\n            await flushDiffRecordsWithContext(ctx)\n            await safelyDisposeTracking(ctx)\n\n            disposeTracking = await createDiffTrigger({\n              setupContext: ctx,\n              when: {\n                [DiffTriggerOperation.INSERT]: newDataWhenClause,\n                [DiffTriggerOperation.UPDATE]: `(${newDataWhenClause}) OR (${oldDataWhenClause})`,\n                [DiffTriggerOperation.DELETE]: oldDataWhenClause,\n              },\n              writeType: (rowId: string) =>\n                collection.has(rowId) ? `update` : `insert`,\n              batchQuery: (\n                lockContext: LockContext,\n                batchSize: number,\n                cursor: number,\n              ) =>\n                lockContext.getAll<TableType>(\n                  `SELECT * FROM ${viewName} WHERE ${viewWhereClause} LIMIT ? OFFSET ?`,\n                  [batchSize, cursor],\n                ),\n              onReady: () => {},\n            })\n          })\n        }\n\n        const toInlinedWhereClause = (compiled: {\n          where?: string\n          params: Array<unknown>\n        }): string => {\n          if (!compiled.where) return 'TRUE'\n          const sqlParts = compiled.where.split('?')\n          return sanitizeSQL(\n            sqlParts as unknown as TemplateStringsArray,\n            ...compiled.params,\n          )\n        }\n\n        const unloadSubset = async (options: LoadSubsetOptions) => {\n          onUnloadSubset?.()\n\n          const idx = activeWhereExpressions.indexOf(options.where)\n          if (idx !== -1) {\n            activeWhereExpressions.splice(idx, 1)\n          }\n\n          // Evict rows that were exclusively loaded by the departing predicate.\n          // These are rows matching the departing WHERE that are no longer covered\n          // by any remaining active predicate.\n          const compiledDeparting = compileSQLite({ where: options.where })\n          const departingWhereSQL = toInlinedWhereClause(compiledDeparting)\n\n          let evictionSQL: string\n          if (activeWhereExpressions.length === 0) {\n            evictionSQL = `SELECT id FROM ${viewName} WHERE ${departingWhereSQL}`\n          } else {\n            const combinedRemaining =\n              activeWhereExpressions.length === 1\n                ? activeWhereExpressions[0]!\n                : or(\n                    activeWhereExpressions[0],\n                    activeWhereExpressions[1],\n                    ...activeWhereExpressions.slice(2),\n                  )\n            const compiledRemaining = compileSQLite({\n              where: combinedRemaining,\n            })\n            const remainingWhereSQL = toInlinedWhereClause(compiledRemaining)\n            evictionSQL = `SELECT id FROM ${viewName} WHERE (${departingWhereSQL}) AND NOT (${remainingWhereSQL})`\n          }\n\n          const rowsToEvict = await database.getAll<{ id: string }>(evictionSQL)\n          if (rowsToEvict.length > 0) {\n            begin()\n            for (const { id } of rowsToEvict) {\n              write({ type: `delete`, key: id })\n            }\n            commit()\n          }\n\n          // Recreate the diff trigger for the remaining active WHERE expressions.\n          await loadSubset()\n        }\n\n        markReady()\n\n        return {\n          cleanup: () => {\n            database.logger.info(\n              `Sync has been stopped for ${viewName} into ${trackedTableName}`,\n            )\n            abortController.abort()\n          },\n          loadSubset: (options: LoadSubsetOptions) => loadSubset(options),\n          unloadSubset: (options: LoadSubsetOptions) => unloadSubset(options),\n        }\n      }\n    },\n    // Expose the getSyncMetadata function\n    getSyncMetadata: undefined,\n  }\n\n  const getKey = (record: OutputType) => asPowerSyncRecord(record).id\n\n  const outputConfig: EnhancedPowerSyncCollectionConfig<\n    TTable,\n    OutputType,\n    TSchema\n  > = {\n    ...restConfig,\n    schema,\n    getKey,\n    // Syncing should start immediately since we need to monitor the changes for mutations\n    startSync: true,\n    syncMode,\n    sync,\n    onInsert: async (params) => {\n      // The transaction here should only ever contain a single insert mutation\n      return await transactor.applyTransaction(params.transaction)\n    },\n    onUpdate: async (params) => {\n      // The transaction here should only ever contain a single update mutation\n      return await transactor.applyTransaction(params.transaction)\n    },\n    onDelete: async (params) => {\n      // The transaction here should only ever contain a single delete mutation\n      return await transactor.applyTransaction(params.transaction)\n    },\n    utils: {\n      getMeta: () => ({\n        tableName: viewName,\n        trackedTableName,\n        metadataIsTracked,\n        serializeValue: (value) =>\n          serializeForSQLite(\n            value,\n            // This is required by the input generic\n            table as Table<\n              MapBaseColumnType<InferPowerSyncOutputType<TTable, TSchema>>\n            >,\n            // Coerce serializer to the shape that corresponds to the Table constructed from OutputType\n            serializer as CustomSQLiteSerializer<\n              OutputType,\n              ExtractedTableColumns<Table<MapBaseColumnType<OutputType>>>\n            >,\n          ),\n      }),\n    },\n  }\n  return outputConfig\n}\n"],"names":["DEFAULT_BATCH_SIZE","schema","convertTableToSchema","PendingOperationStore","PowerSyncTransactor","DiffTriggerOperation","mapOperation","sanitizeSQL","or","compileSQLite","asPowerSyncRecord","serializeForSQLite"],"mappings":";;;;;;;;;;;AAiOO,SAAS,2BAGd,QAAoD;AACpD,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR,gBAAgBA,YAAAA;AAAAA,IAChB,WAAW;AAAA,IACX,GAAG;AAAA,EAAA,IACD;AAEJ,QAAM,wBACJ,2BAA2B,SAAS,OAAO,wBAAwB;AACrE,QAAM,aAAa,gBAAgB,SAAS,OAAO,aAAa;AAChE,QAAM,yBACJ,4BAA4B,SACxB,OAAO,yBACP;AAQN,QAAM,EAAE,UAAU,eAAe,kBAAA,IAAsB;AAKvD,QAAM,qBAAqB,CAAC,UAAiC;AAC3D,UAAM,mBAAmB,yBAAyBC;AAClD,UAAM,aAAa,iBAAiB,WAAW,EAAE,SAAS,KAAK;AAC/D,QAAI,WAAW,YAAY;AACzB,aAAO,WAAW;AAAA,IACpB,WAAW,YAAY,YAAY;AACjC,YAAM,eAAe,wCAAwC,QAAQ,aAAa,WAAW,OAAO,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,MAAM,MAAM,OAAO,EAAE,CAAC;AACtJ,eAAS,OAAO,MAAM,YAAY;AAClC,6BAAwB,UAAU;AAClC,YAAM,IAAI,MAAM,YAAY;AAAA,IAC9B,OAAO;AACL,YAAM,sBAAsB,qCAAqC,QAAQ;AACzE,eAAS,OAAO,MAAM,mBAAmB;AACzC,6BAAwB,EAAE,QAAQ,CAAC,EAAE,SAAS,oBAAA,CAAqB,GAAG;AACtE,YAAM,IAAI,MAAM,mBAAmB;AAAA,IACrC;AAAA,EACF;AAGA,QAAMA,WAAS,eAAgBC,OAAAA,qBAAqB,KAAK;AAWzD,QAAM,wBAAwBC,sBAAAA,sBAAsB;AAEpD,QAAM,mBAAmB,KAAK,QAAQ,aAAa,KAAK;AAAA,IACtD,KAAK,WAAW;AAAA,EAAA,EAEf,SAAS,EAAE,EACX,SAAS,GAAG,GAAG,CAAC;AAEnB,QAAM,aAAa,IAAIC,wCAAoB;AAAA,IACzC;AAAA,EAAA,CACD;AAOD,QAAM,OAAuC;AAAA,IAC3C,MAAM,CAAC,WAAW;AAChB,YAAM,EAAE,OAAO,OAAO,YAAY,QAAQ,cAAc;AACxD,YAAM,kBAAkB,IAAI,gBAAA;AAE5B,UAAI,kBAEO;AAEX,UAAI,aAAa,SAAS;AACxB,eAAO,aAAA;AAAA,MACT,OAAO;AACL,eAAO,gBAAA;AAAA,MACT;AAMA,qBAAe,sBACb,SACe;AACf,cAAM,UAAU;AAChB,YAAI,CAAC,SAAS;AACZ;AAAA,QACF;AAEA,0BAAkB;AAClB,cAAM,QAAQ,UAAU,EAAE,QAAA,IAAY,MAAS;AAAA,MACjD;AAEA,qBAAe,kBAAkB,SAU9B;AACD,cAAM,EAAE,cAAc,MAAM,WAAW,YAAY,YAAY;AAE/D,eAAO,MAAM,SAAS,SAAS,kBAAkB;AAAA,UAC/C,QAAQ;AAAA,UACR,aAAa;AAAA,UACb;AAAA,UACA;AAAA,UACA,OAAO;AAAA,YACL,cAAc,OAAO,YAAY;AAC/B,kBAAI,oBAAoB;AACxB,kBAAI,SAAS;AACb,qBAAO,qBAAqB,eAAe;AACzC,sBAAA;AAEA,sBAAM,aAAa,MAAM;AAAA,kBACvB;AAAA,kBACA;AAAA,kBACA;AAAA,gBAAA;AAEF,oCAAoB,WAAW;AAC/B,0BAAU;AACV,2BAAW,OAAO,YAAY;AAC5B,wBAAM;AAAA,oBACJ,MAAM,UAAU,IAAI,EAAE;AAAA,oBACtB,OAAO,mBAAmB,GAAG;AAAA,kBAAA,CAC9B;AAAA,gBACH;AACA,uBAAA;AAAA,cACF;AACA,sBAAA;AACA,uBAAS,OAAO;AAAA,gBACd,qBAAqB,QAAQ,SAAS,gBAAgB;AAAA,cAAA;AAAA,YAE1D;AAAA,UAAA;AAAA,QACF,CACD;AAAA,MACH;AAEA,qBAAe,mBAAkC;AAC/C,cAAM,SACH,iBAAiB,OAAO,YAAY;AACnC,gBAAM,4BAA4B,OAAO;AAAA,QAC3C,CAAC,EACA,MAAM,CAAC,UAAU;AAChB,mBAAS,OAAO;AAAA,YACd;AAAA,YACA;AAAA,UAAA;AAAA,QAEJ,CAAC;AAAA,MACL;AAGA,qBAAe,4BACb,SACe;AAEf,YAAI,CAAC,iBAAiB;AACpB;AAAA,QACF;AAEA,YAAI;AACF,gBAAA;AACA,gBAAM,aAAa,MAAM,QAAQ;AAAA,YAC/B,iBAAiB,gBAAgB;AAAA,UAAA;AAEnC,gBAAM,oBAA6C,CAAA;AAEnD,qBAAW,MAAM,YAAY;AAC3B,kBAAM,EAAE,IAAI,WAAW,WAAW,UAAU;AAC5C,kBAAM,cAAc,mBAAmB;AAAA,cACrC;AAAA,cACA,GAAG,KAAK,MAAM,KAAK;AAAA,YAAA,CACpB;AACD,kBAAM,sBACJ,GAAG,aAAaC,OAAAA,qBAAqB,SACjC,mBAAmB;AAAA,cACjB;AAAA,cACA,GAAG,KAAK,MAAM,GAAG,cAAc;AAAA,YAAA,CAChC,IACD;AACN,kBAAM;AAAA,cACJ,MAAMC,QAAAA,aAAa,SAAS;AAAA,cAC5B,OAAO;AAAA,cACP,eAAe;AAAA,YAAA,CAChB;AACD,8BAAkB,KAAK;AAAA,cACrB;AAAA,cACA;AAAA,cACA;AAAA,cACA,WAAW;AAAA,YAAA,CACZ;AAAA,UACH;AAGA,gBAAM,QAAQ,QAAQ,eAAe,gBAAgB,EAAE;AAEvD,iBAAA;AACA,gCAAsB,kBAAkB,iBAAiB;AAAA,QAC3D,SAAS,OAAO;AACd,mBAAS,OAAO;AAAA,YACd;AAAA,YACA;AAAA,UAAA;AAAA,QAEJ;AAAA,MACF;AAGA,qBAAe,MAAM,yBAA+C;AAClE,iBAAS,OAAO;AAAA,UACd,wBAAwB,QAAQ,SAAS,gBAAgB;AAAA,QAAA;AAE3D,iBAAS;AAAA,UACP;AAAA,YACE,UAAU,YAAY;AACpB,oBAAM,iBAAA;AAAA,YACR;AAAA,UAAA;AAAA,UAEF;AAAA,YACE,QAAQ,gBAAgB;AAAA,YACxB,kBAAkB;AAAA,YAClB,QAAQ,CAAC,gBAAgB;AAAA,UAAA;AAAA,QAC3B;AAGF,cAAM,0BAAA;AAGN,YAAI,gBAAgB,OAAO,SAAS;AAClC,gBAAM,sBAAA;AAAA,QACR,OAAO;AACL,0BAAgB,OAAO;AAAA,YACrB;AAAA,YACA,YAAY;AACV,oBAAM,sBAAA;AAAA,YACR;AAAA,YACA,EAAE,MAAM,KAAA;AAAA,UAAK;AAAA,QAEjB;AAAA,MACF;AAIA,eAAS,eAAe;AACtB,YAAI,WAAoC;AAExC,cAAM,YAAY;AAChB,qBAAW,MAAM,WAAW,SAAA;AAE5B,4BAAkB,MAAM,kBAAkB;AAAA,YACxC,MAAM;AAAA,cACJ,CAACD,OAAAA,qBAAqB,MAAM,GAAG;AAAA,cAC/B,CAACA,OAAAA,qBAAqB,MAAM,GAAG;AAAA,cAC/B,CAACA,OAAAA,qBAAqB,MAAM,GAAG;AAAA,YAAA;AAAA,YAEjC,WAAW,CAAC,WAAmB;AAAA,YAC/B,YAAY,CACV,aACA,WACA,WAEA,YAAY;AAAA,cACVE,mCAA4B,QAAQ;AAAA,cACpC,CAAC,WAAW,MAAM;AAAA,YAAA;AAAA,YAEtB,SAAS,MAAM,UAAA;AAAA,UAAU,CAC1B;AAAA,QACH,CAAC,EAAE;AAAA,UAAM,CAAC,UACR,SAAS,OAAO;AAAA,YACd,uCAAuC,QAAQ,SAAS,gBAAgB;AAAA,YACxE;AAAA,UAAA;AAAA,QACF;AAGF,eAAO,MAAM;AACX,mBAAS,OAAO;AAAA,YACd,6BAA6B,QAAQ,SAAS,gBAAgB;AAAA,UAAA;AAEhE,0BAAgB,MAAA;AAChB,qBAAA;AAAA,QACF;AAAA,MACF;AAIA,eAAS,kBAAkB;AACzB,YAAI,iBAA0C;AAE9C,cAAA,EAAQ;AAAA,UAAM,CAAC,UACb,SAAS,OAAO;AAAA,YACd,uCAAuC,QAAQ,SAAS,gBAAgB;AAAA,YACxE;AAAA,UAAA;AAAA,QACF;AAKF,cAAM,yBAA4D,CAAA;AAElE,cAAM,aAAa,OACjB,YACkB;AAClB,cAAI,SAAS;AACX,mCAAuB,KAAK,QAAQ,KAAK;AACzC,6BAAiB,MAAM,WAAW,eAAe,OAAO;AAAA,UAC1D;AAIA,cAAI,uBAAuB,WAAW,GAAG;AACvC,kBAAM,SAAS,UAAU,OAAO,QAAQ;AACtC,oBAAM,4BAA4B,GAAG;AACrC,oBAAM,sBAAsB,GAAG;AAAA,YACjC,CAAC;AACD;AAAA,UACF;AAEA,gBAAM,gBACJ,uBAAuB,WAAW,IAC9B,uBAAuB,CAAC,IACxBC,GAAAA;AAAAA,YACE,uBAAuB,CAAC;AAAA,YACxB,uBAAuB,CAAC;AAAA,YACxB,GAAG,uBAAuB,MAAM,CAAC;AAAA,UAAA;AAGzC,gBAAM,kBAAkBC,eAAAA;AAAAA,YACtB,EAAE,OAAO,cAAA;AAAA,YACT,EAAE,YAAY,WAAA;AAAA,UAAW;AAG3B,gBAAM,kBAAkBA,eAAAA;AAAAA,YACtB,EAAE,OAAO,cAAA;AAAA,YACT,EAAE,YAAY,WAAA;AAAA,UAAW;AAG3B,gBAAM,eAAeA,eAAAA,cAAc,EAAE,OAAO,eAAe;AAE3D,gBAAM,oBAAoB,qBAAqB,eAAe;AAC9D,gBAAM,oBAAoB,qBAAqB,eAAe;AAC9D,gBAAM,kBAAkB,qBAAqB,YAAY;AAEzD,gBAAM,SAAS,UAAU,OAAO,QAAQ;AAGtC,kBAAM,4BAA4B,GAAG;AACrC,kBAAM,sBAAsB,GAAG;AAE/B,8BAAkB,MAAM,kBAAkB;AAAA,cACxC,cAAc;AAAA,cACd,MAAM;AAAA,gBACJ,CAACJ,OAAAA,qBAAqB,MAAM,GAAG;AAAA,gBAC/B,CAACA,OAAAA,qBAAqB,MAAM,GAAG,IAAI,iBAAiB,SAAS,iBAAiB;AAAA,gBAC9E,CAACA,OAAAA,qBAAqB,MAAM,GAAG;AAAA,cAAA;AAAA,cAEjC,WAAW,CAAC,UACV,WAAW,IAAI,KAAK,IAAI,WAAW;AAAA,cACrC,YAAY,CACV,aACA,WACA,WAEA,YAAY;AAAA,gBACV,iBAAiB,QAAQ,UAAU,eAAe;AAAA,gBAClD,CAAC,WAAW,MAAM;AAAA,cAAA;AAAA,cAEtB,SAAS,MAAM;AAAA,cAAC;AAAA,YAAA,CACjB;AAAA,UACH,CAAC;AAAA,QACH;AAEA,cAAM,uBAAuB,CAAC,aAGhB;AACZ,cAAI,CAAC,SAAS,MAAO,QAAO;AAC5B,gBAAM,WAAW,SAAS,MAAM,MAAM,GAAG;AACzC,iBAAOE,OAAAA;AAAAA,YACL;AAAA,YACA,GAAG,SAAS;AAAA,UAAA;AAAA,QAEhB;AAEA,cAAM,eAAe,OAAO,YAA+B;AACzD,2BAAA;AAEA,gBAAM,MAAM,uBAAuB,QAAQ,QAAQ,KAAK;AACxD,cAAI,QAAQ,IAAI;AACd,mCAAuB,OAAO,KAAK,CAAC;AAAA,UACtC;AAKA,gBAAM,oBAAoBE,eAAAA,cAAc,EAAE,OAAO,QAAQ,OAAO;AAChE,gBAAM,oBAAoB,qBAAqB,iBAAiB;AAEhE,cAAI;AACJ,cAAI,uBAAuB,WAAW,GAAG;AACvC,0BAAc,kBAAkB,QAAQ,UAAU,iBAAiB;AAAA,UACrE,OAAO;AACL,kBAAM,oBACJ,uBAAuB,WAAW,IAC9B,uBAAuB,CAAC,IACxBD,GAAAA;AAAAA,cACE,uBAAuB,CAAC;AAAA,cACxB,uBAAuB,CAAC;AAAA,cACxB,GAAG,uBAAuB,MAAM,CAAC;AAAA,YAAA;AAEzC,kBAAM,oBAAoBC,eAAAA,cAAc;AAAA,cACtC,OAAO;AAAA,YAAA,CACR;AACD,kBAAM,oBAAoB,qBAAqB,iBAAiB;AAChE,0BAAc,kBAAkB,QAAQ,WAAW,iBAAiB,cAAc,iBAAiB;AAAA,UACrG;AAEA,gBAAM,cAAc,MAAM,SAAS,OAAuB,WAAW;AACrE,cAAI,YAAY,SAAS,GAAG;AAC1B,kBAAA;AACA,uBAAW,EAAE,GAAA,KAAQ,aAAa;AAChC,oBAAM,EAAE,MAAM,UAAU,KAAK,IAAI;AAAA,YACnC;AACA,mBAAA;AAAA,UACF;AAGA,gBAAM,WAAA;AAAA,QACR;AAEA,kBAAA;AAEA,eAAO;AAAA,UACL,SAAS,MAAM;AACb,qBAAS,OAAO;AAAA,cACd,6BAA6B,QAAQ,SAAS,gBAAgB;AAAA,YAAA;AAEhE,4BAAgB,MAAA;AAAA,UAClB;AAAA,UACA,YAAY,CAAC,YAA+B,WAAW,OAAO;AAAA,UAC9D,cAAc,CAAC,YAA+B,aAAa,OAAO;AAAA,QAAA;AAAA,MAEtE;AAAA,IACF;AAAA;AAAA,IAEA,iBAAiB;AAAA,EAAA;AAGnB,QAAM,SAAS,CAAC,WAAuBC,QAAAA,kBAAkB,MAAM,EAAE;AAEjE,QAAM,eAIF;AAAA,IACF,GAAG;AAAA,IAAA,QACHT;AAAAA,IACA;AAAA;AAAA,IAEA,WAAW;AAAA,IACX;AAAA,IACA;AAAA,IACA,UAAU,OAAO,WAAW;AAE1B,aAAO,MAAM,WAAW,iBAAiB,OAAO,WAAW;AAAA,IAC7D;AAAA,IACA,UAAU,OAAO,WAAW;AAE1B,aAAO,MAAM,WAAW,iBAAiB,OAAO,WAAW;AAAA,IAC7D;AAAA,IACA,UAAU,OAAO,WAAW;AAE1B,aAAO,MAAM,WAAW,iBAAiB,OAAO,WAAW;AAAA,IAC7D;AAAA,IACA,OAAO;AAAA,MACL,SAAS,OAAO;AAAA,QACd,WAAW;AAAA,QACX;AAAA,QACA;AAAA,QACA,gBAAgB,CAAC,UACfU,cAAAA;AAAAA,UACE;AAAA;AAAA,UAEA;AAAA;AAAA,UAIA;AAAA,QAAA;AAAA,MAIF;AAAA,IACJ;AAAA,EACF;AAEF,SAAO;AACT;;"}

package/dist/esm/PowerSyncTransactor.js

@@ -163,7 +163,7 @@ class PowerSyncTransactor {
       return null;
     }
     const diffOperation = await context.get(
-      sanitizeSQL`SELECT id, timestamp FROM ${trackedTableName} ORDER BY timestamp DESC LIMIT 1`
+      sanitizeSQL`SELECT id, timestamp FROM ${trackedTableName} ORDER BY operation_id DESC LIMIT 1`
     );
     return {
       tableName,

package/dist/esm/PowerSyncTransactor.js.map

@@ -1 +1 @@
-{"version":3,"file":"PowerSyncTransactor.js","sources":["../../src/PowerSyncTransactor.ts"],"sourcesContent":["import { sanitizeSQL } from '@powersync/common'\nimport DebugModule from 'debug'\nimport { PendingOperationStore } from './PendingOperationStore'\nimport { asPowerSyncRecord, mapOperationToPowerSync } from './helpers'\nimport type { AbstractPowerSyncDatabase, LockContext } from '@powersync/common'\nimport type { PendingMutation, Transaction } from '@tanstack/db'\nimport type { PendingOperation } from './PendingOperationStore'\nimport type {\n  EnhancedPowerSyncCollectionConfig,\n  PowerSyncCollectionMeta,\n} from './definitions'\n\nconst debug = DebugModule.debug(`ts/db:powersync`)\n\nexport type TransactorOptions = {\n  database: AbstractPowerSyncDatabase\n}\n\n/**\n * Applies mutations to the PowerSync database. This method is called automatically by the collection's\n * insert, update, and delete operations. You typically don't need to call this directly unless you\n * have special transaction requirements.\n *\n * @example\n * ```typescript\n * // Create a collection\n * const collection = createCollection(\n *   powerSyncCollectionOptions<Document>({\n *     database: db,\n *     table: APP_SCHEMA.props.documents,\n *   })\n * )\n *\n * const addTx = createTransaction({\n *   autoCommit: false,\n *   mutationFn: async ({ transaction }) => {\n *     await new PowerSyncTransactor({ database: db }).applyTransaction(transaction)\n *   },\n * })\n *\n * addTx.mutate(() => {\n *   for (let i = 0; i < 5; i++) {\n *     collection.insert({ id: randomUUID(), name: `tx-${i}` })\n *   }\n * })\n *\n * await addTx.commit()\n * await addTx.isPersisted.promise\n * ```\n *\n * @param transaction - The transaction containing mutations to apply\n * @returns A promise that resolves when the mutations have been persisted to PowerSync\n */\nexport class PowerSyncTransactor {\n  database: AbstractPowerSyncDatabase\n  pendingOperationStore: PendingOperationStore\n\n  constructor(options: TransactorOptions) {\n    this.database = options.database\n    this.pendingOperationStore = PendingOperationStore.GLOBAL\n  }\n\n  /**\n   * Persists a {@link Transaction} to the PowerSync SQLite database.\n   */\n  async applyTransaction(transaction: Transaction<any>) {\n    const { mutations } = transaction\n\n    if (mutations.length == 0) {\n      return\n    }\n    /**\n     * The transaction might contain operations for different collections.\n     * We can do some optimizations for single-collection transactions.\n     */\n    const mutationsCollectionIds = mutations.map(\n      (mutation) => mutation.collection.id,\n    )\n    const collectionIds = Array.from(new Set(mutationsCollectionIds))\n    const lastCollectionMutationIndexes = new Map<string, number>()\n    const allCollections = collectionIds\n      .map((id) => mutations.find((mutation) => mutation.collection.id == id)!)\n      .map((mutation) => mutation.collection)\n    for (const collectionId of collectionIds) {\n      lastCollectionMutationIndexes.set(\n        collectionId,\n        mutationsCollectionIds.lastIndexOf(collectionId),\n      )\n    }\n\n    // Check all the observers are ready before taking a lock\n    await Promise.all(\n      allCollections.map(async (collection) => {\n        if (collection.isReady()) {\n          return\n        }\n        await new Promise<void>((resolve) => collection.onFirstReady(resolve))\n      }),\n    )\n\n    // Persist to PowerSync\n    const { whenComplete } = await this.database.writeTransaction(\n      async (tx) => {\n        const pendingOperations: Array<PendingOperation | null> = []\n\n        for (const [index, mutation] of mutations.entries()) {\n          /**\n           * Each collection processes events independently. We need to make sure the\n           * last operation for each collection has been observed.\n           */\n          const shouldWait =\n            index == lastCollectionMutationIndexes.get(mutation.collection.id)\n          switch (mutation.type) {\n            case `insert`:\n              pendingOperations.push(\n                await this.handleInsert(mutation, tx, shouldWait),\n              )\n              break\n            case `update`:\n              pendingOperations.push(\n                await this.handleUpdate(mutation, tx, shouldWait),\n              )\n              break\n            case `delete`:\n              pendingOperations.push(\n                await this.handleDelete(mutation, tx, shouldWait),\n              )\n              break\n          }\n        }\n\n        /**\n         * Return a promise from the writeTransaction, without awaiting it.\n         * This promise will resolve once the entire transaction has been\n         * observed via the diff triggers.\n         * We return without awaiting in order to free the write lock.\n         */\n        return {\n          whenComplete: Promise.all(\n            pendingOperations\n              .filter((op) => !!op)\n              .map((op) => this.pendingOperationStore.waitFor(op)),\n          ),\n        }\n      },\n    )\n\n    // Wait for the change to be observed via the diff trigger\n    await whenComplete\n  }\n\n  protected async handleInsert(\n    mutation: PendingMutation<any>,\n    context: LockContext,\n    waitForCompletion: boolean = false,\n  ): Promise<PendingOperation | null> {\n    debug(`insert`, mutation)\n\n    return this.handleOperationWithCompletion(\n      mutation,\n      context,\n      waitForCompletion,\n      // eslint-disable-next-line no-shadow\n      async (tableName, mutation, serializeValue) => {\n        const values = serializeValue(mutation.modified)\n        const keys = Object.keys(values).map((key) => sanitizeSQL`${key}`)\n        const queryParameters = Object.values(values)\n\n        const metadataValue = this.processMutationMetadata(mutation)\n        if (metadataValue != null) {\n          keys.push(`_metadata`)\n          queryParameters.push(metadataValue)\n        }\n\n        await context.execute(\n          `\n        INSERT into ${tableName}\n            (${keys.join(`, `)})\n        VALUES\n            (${keys.map((_) => `?`).join(`, `)})\n        `,\n          queryParameters,\n        )\n      },\n    )\n  }\n\n  protected async handleUpdate(\n    mutation: PendingMutation<any>,\n    context: LockContext,\n    waitForCompletion: boolean = false,\n  ): Promise<PendingOperation | null> {\n    debug(`update`, mutation)\n\n    return this.handleOperationWithCompletion(\n      mutation,\n      context,\n      waitForCompletion,\n      // eslint-disable-next-line no-shadow\n      async (tableName, mutation, serializeValue) => {\n        const values = serializeValue(mutation.modified)\n        const keys = Object.keys(values).map((key) => sanitizeSQL`${key}`)\n        const queryParameters = Object.values(values)\n\n        const metadataValue = this.processMutationMetadata(mutation)\n        if (metadataValue != null) {\n          keys.push(`_metadata`)\n          queryParameters.push(metadataValue)\n        }\n\n        await context.execute(\n          `\n        UPDATE ${tableName}\n        SET ${keys.map((key) => `${key} = ?`).join(`, `)}\n        WHERE id = ?\n        `,\n          [...queryParameters, asPowerSyncRecord(mutation.modified).id],\n        )\n      },\n    )\n  }\n\n  protected async handleDelete(\n    mutation: PendingMutation<any>,\n    context: LockContext,\n    waitForCompletion: boolean = false,\n  ): Promise<PendingOperation | null> {\n    debug(`update`, mutation)\n\n    return this.handleOperationWithCompletion(\n      mutation,\n      context,\n      waitForCompletion,\n      // eslint-disable-next-line no-shadow\n      async (tableName, mutation) => {\n        const metadataValue = this.processMutationMetadata(mutation)\n        if (metadataValue != null) {\n          /**\n           * Delete operations with metadata require a different approach to handle metadata.\n           * This will delete the record.\n           */\n          await context.execute(\n            `\n            UPDATE ${tableName} SET _deleted = TRUE, _metadata = ? WHERE id = ?\n            `,\n            [metadataValue, asPowerSyncRecord(mutation.original).id],\n          )\n        } else {\n          await context.execute(\n            `\n            DELETE FROM ${tableName} WHERE id = ?\n            `,\n            [asPowerSyncRecord(mutation.original).id],\n          )\n        }\n      },\n    )\n  }\n\n  /**\n   * Helper function which wraps a persistence operation by:\n   * - Fetching the mutation's collection's SQLite table details\n   * - Executing the mutation\n   * - Returning the last pending diff operation if required\n   */\n  protected async handleOperationWithCompletion(\n    mutation: PendingMutation<any>,\n    context: LockContext,\n    waitForCompletion: boolean,\n    handler: (\n      tableName: string,\n      mutation: PendingMutation<any>,\n      serializeValue: (value: any) => Record<string, unknown>,\n    ) => Promise<void>,\n  ): Promise<PendingOperation | null> {\n    const { tableName, trackedTableName, serializeValue } =\n      this.getMutationCollectionMeta(mutation)\n\n    await handler(sanitizeSQL`${tableName}`, mutation, serializeValue)\n\n    if (!waitForCompletion) {\n      return null\n    }\n\n    // Need to get the operation in order to wait for it\n    const diffOperation = await context.get<{ id: string; timestamp: string }>(\n      sanitizeSQL`SELECT id, timestamp FROM ${trackedTableName} ORDER BY timestamp DESC LIMIT 1`,\n    )\n    return {\n      tableName,\n      id: diffOperation.id,\n      operation: mapOperationToPowerSync(mutation.type),\n      timestamp: diffOperation.timestamp,\n    }\n  }\n\n  protected getMutationCollectionMeta(\n    mutation: PendingMutation<any>,\n  ): PowerSyncCollectionMeta<any> {\n    if (\n      typeof (mutation.collection.config as any).utils?.getMeta != `function`\n    ) {\n      throw new Error(`Collection is not a PowerSync collection.`)\n    }\n    return (\n      mutation.collection\n        .config as unknown as EnhancedPowerSyncCollectionConfig<any>\n    ).utils.getMeta()\n  }\n\n  /**\n   * Processes collection mutation metadata for persistence to the database.\n   * We only support storing string metadata.\n   * @returns null if no metadata should be stored.\n   */\n  protected processMutationMetadata(\n    mutation: PendingMutation<any>,\n  ): string | null {\n    const { metadataIsTracked } = this.getMutationCollectionMeta(mutation)\n    if (!metadataIsTracked) {\n      // If it's not supported, we don't store metadata.\n      if (typeof mutation.metadata != `undefined`) {\n        // Log a warning if metadata is provided but not tracked.\n        this.database.logger.warn(\n          `Metadata provided for collection ${mutation.collection.id} but the PowerSync table does not track metadata. The PowerSync table should be configured with trackMetadata: true.`,\n          mutation.metadata,\n        )\n      }\n      return null\n    } else if (typeof mutation.metadata == `undefined`) {\n      return null\n    } else if (typeof mutation.metadata == `string`) {\n      return mutation.metadata\n    } else {\n      return JSON.stringify(mutation.metadata)\n    }\n  }\n}\n"],"names":["mutation"],"mappings":"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"}
+{"version":3,"file":"PowerSyncTransactor.js","sources":["../../src/PowerSyncTransactor.ts"],"sourcesContent":["import { sanitizeSQL } from '@powersync/common'\nimport DebugModule from 'debug'\nimport { PendingOperationStore } from './PendingOperationStore'\nimport { asPowerSyncRecord, mapOperationToPowerSync } from './helpers'\nimport type { AbstractPowerSyncDatabase, LockContext } from '@powersync/common'\nimport type { PendingMutation, Transaction } from '@tanstack/db'\nimport type { PendingOperation } from './PendingOperationStore'\nimport type {\n  EnhancedPowerSyncCollectionConfig,\n  PowerSyncCollectionMeta,\n} from './definitions'\n\nconst debug = DebugModule.debug(`ts/db:powersync`)\n\nexport type TransactorOptions = {\n  database: AbstractPowerSyncDatabase\n}\n\n/**\n * Applies mutations to the PowerSync database. This method is called automatically by the collection's\n * insert, update, and delete operations. You typically don't need to call this directly unless you\n * have special transaction requirements.\n *\n * @example\n * ```typescript\n * // Create a collection\n * const collection = createCollection(\n *   powerSyncCollectionOptions<Document>({\n *     database: db,\n *     table: APP_SCHEMA.props.documents,\n *   })\n * )\n *\n * const addTx = createTransaction({\n *   autoCommit: false,\n *   mutationFn: async ({ transaction }) => {\n *     await new PowerSyncTransactor({ database: db }).applyTransaction(transaction)\n *   },\n * })\n *\n * addTx.mutate(() => {\n *   for (let i = 0; i < 5; i++) {\n *     collection.insert({ id: randomUUID(), name: `tx-${i}` })\n *   }\n * })\n *\n * await addTx.commit()\n * await addTx.isPersisted.promise\n * ```\n *\n * @param transaction - The transaction containing mutations to apply\n * @returns A promise that resolves when the mutations have been persisted to PowerSync\n */\nexport class PowerSyncTransactor {\n  database: AbstractPowerSyncDatabase\n  pendingOperationStore: PendingOperationStore\n\n  constructor(options: TransactorOptions) {\n    this.database = options.database\n    this.pendingOperationStore = PendingOperationStore.GLOBAL\n  }\n\n  /**\n   * Persists a {@link Transaction} to the PowerSync SQLite database.\n   */\n  async applyTransaction(transaction: Transaction<any>) {\n    const { mutations } = transaction\n\n    if (mutations.length == 0) {\n      return\n    }\n    /**\n     * The transaction might contain operations for different collections.\n     * We can do some optimizations for single-collection transactions.\n     */\n    const mutationsCollectionIds = mutations.map(\n      (mutation) => mutation.collection.id,\n    )\n    const collectionIds = Array.from(new Set(mutationsCollectionIds))\n    const lastCollectionMutationIndexes = new Map<string, number>()\n    const allCollections = collectionIds\n      .map((id) => mutations.find((mutation) => mutation.collection.id == id)!)\n      .map((mutation) => mutation.collection)\n    for (const collectionId of collectionIds) {\n      lastCollectionMutationIndexes.set(\n        collectionId,\n        mutationsCollectionIds.lastIndexOf(collectionId),\n      )\n    }\n\n    // Check all the observers are ready before taking a lock\n    await Promise.all(\n      allCollections.map(async (collection) => {\n        if (collection.isReady()) {\n          return\n        }\n        await new Promise<void>((resolve) => collection.onFirstReady(resolve))\n      }),\n    )\n\n    // Persist to PowerSync\n    const { whenComplete } = await this.database.writeTransaction(\n      async (tx) => {\n        const pendingOperations: Array<PendingOperation | null> = []\n\n        for (const [index, mutation] of mutations.entries()) {\n          /**\n           * Each collection processes events independently. We need to make sure the\n           * last operation for each collection has been observed.\n           */\n          const shouldWait =\n            index == lastCollectionMutationIndexes.get(mutation.collection.id)\n          switch (mutation.type) {\n            case `insert`:\n              pendingOperations.push(\n                await this.handleInsert(mutation, tx, shouldWait),\n              )\n              break\n            case `update`:\n              pendingOperations.push(\n                await this.handleUpdate(mutation, tx, shouldWait),\n              )\n              break\n            case `delete`:\n              pendingOperations.push(\n                await this.handleDelete(mutation, tx, shouldWait),\n              )\n              break\n          }\n        }\n\n        /**\n         * Return a promise from the writeTransaction, without awaiting it.\n         * This promise will resolve once the entire transaction has been\n         * observed via the diff triggers.\n         * We return without awaiting in order to free the write lock.\n         */\n        return {\n          whenComplete: Promise.all(\n            pendingOperations\n              .filter((op) => !!op)\n              .map((op) => this.pendingOperationStore.waitFor(op)),\n          ),\n        }\n      },\n    )\n\n    // Wait for the change to be observed via the diff trigger\n    await whenComplete\n  }\n\n  protected async handleInsert(\n    mutation: PendingMutation<any>,\n    context: LockContext,\n    waitForCompletion: boolean = false,\n  ): Promise<PendingOperation | null> {\n    debug(`insert`, mutation)\n\n    return this.handleOperationWithCompletion(\n      mutation,\n      context,\n      waitForCompletion,\n      // eslint-disable-next-line no-shadow\n      async (tableName, mutation, serializeValue) => {\n        const values = serializeValue(mutation.modified)\n        const keys = Object.keys(values).map((key) => sanitizeSQL`${key}`)\n        const queryParameters = Object.values(values)\n\n        const metadataValue = this.processMutationMetadata(mutation)\n        if (metadataValue != null) {\n          keys.push(`_metadata`)\n          queryParameters.push(metadataValue)\n        }\n\n        await context.execute(\n          `\n        INSERT into ${tableName}\n            (${keys.join(`, `)})\n        VALUES\n            (${keys.map((_) => `?`).join(`, `)})\n        `,\n          queryParameters,\n        )\n      },\n    )\n  }\n\n  protected async handleUpdate(\n    mutation: PendingMutation<any>,\n    context: LockContext,\n    waitForCompletion: boolean = false,\n  ): Promise<PendingOperation | null> {\n    debug(`update`, mutation)\n\n    return this.handleOperationWithCompletion(\n      mutation,\n      context,\n      waitForCompletion,\n      // eslint-disable-next-line no-shadow\n      async (tableName, mutation, serializeValue) => {\n        const values = serializeValue(mutation.modified)\n        const keys = Object.keys(values).map((key) => sanitizeSQL`${key}`)\n        const queryParameters = Object.values(values)\n\n        const metadataValue = this.processMutationMetadata(mutation)\n        if (metadataValue != null) {\n          keys.push(`_metadata`)\n          queryParameters.push(metadataValue)\n        }\n\n        await context.execute(\n          `\n        UPDATE ${tableName}\n        SET ${keys.map((key) => `${key} = ?`).join(`, `)}\n        WHERE id = ?\n        `,\n          [...queryParameters, asPowerSyncRecord(mutation.modified).id],\n        )\n      },\n    )\n  }\n\n  protected async handleDelete(\n    mutation: PendingMutation<any>,\n    context: LockContext,\n    waitForCompletion: boolean = false,\n  ): Promise<PendingOperation | null> {\n    debug(`update`, mutation)\n\n    return this.handleOperationWithCompletion(\n      mutation,\n      context,\n      waitForCompletion,\n      // eslint-disable-next-line no-shadow\n      async (tableName, mutation) => {\n        const metadataValue = this.processMutationMetadata(mutation)\n        if (metadataValue != null) {\n          /**\n           * Delete operations with metadata require a different approach to handle metadata.\n           * This will delete the record.\n           */\n          await context.execute(\n            `\n            UPDATE ${tableName} SET _deleted = TRUE, _metadata = ? WHERE id = ?\n            `,\n            [metadataValue, asPowerSyncRecord(mutation.original).id],\n          )\n        } else {\n          await context.execute(\n            `\n            DELETE FROM ${tableName} WHERE id = ?\n            `,\n            [asPowerSyncRecord(mutation.original).id],\n          )\n        }\n      },\n    )\n  }\n\n  /**\n   * Helper function which wraps a persistence operation by:\n   * - Fetching the mutation's collection's SQLite table details\n   * - Executing the mutation\n   * - Returning the last pending diff operation if required\n   */\n  protected async handleOperationWithCompletion(\n    mutation: PendingMutation<any>,\n    context: LockContext,\n    waitForCompletion: boolean,\n    handler: (\n      tableName: string,\n      mutation: PendingMutation<any>,\n      serializeValue: (value: any) => Record<string, unknown>,\n    ) => Promise<void>,\n  ): Promise<PendingOperation | null> {\n    const { tableName, trackedTableName, serializeValue } =\n      this.getMutationCollectionMeta(mutation)\n\n    await handler(sanitizeSQL`${tableName}`, mutation, serializeValue)\n\n    if (!waitForCompletion) {\n      return null\n    }\n\n    // Need to get the operation in order to wait for it\n    const diffOperation = await context.get<{ id: string; timestamp: string }>(\n      sanitizeSQL`SELECT id, timestamp FROM ${trackedTableName} ORDER BY operation_id DESC LIMIT 1`,\n    )\n    return {\n      tableName,\n      id: diffOperation.id,\n      operation: mapOperationToPowerSync(mutation.type),\n      timestamp: diffOperation.timestamp,\n    }\n  }\n\n  protected getMutationCollectionMeta(\n    mutation: PendingMutation<any>,\n  ): PowerSyncCollectionMeta<any> {\n    if (\n      typeof (mutation.collection.config as any).utils?.getMeta != `function`\n    ) {\n      throw new Error(`Collection is not a PowerSync collection.`)\n    }\n    return (\n      mutation.collection\n        .config as unknown as EnhancedPowerSyncCollectionConfig<any>\n    ).utils.getMeta()\n  }\n\n  /**\n   * Processes collection mutation metadata for persistence to the database.\n   * We only support storing string metadata.\n   * @returns null if no metadata should be stored.\n   */\n  protected processMutationMetadata(\n    mutation: PendingMutation<any>,\n  ): string | null {\n    const { metadataIsTracked } = this.getMutationCollectionMeta(mutation)\n    if (!metadataIsTracked) {\n      // If it's not supported, we don't store metadata.\n      if (typeof mutation.metadata != `undefined`) {\n        // Log a warning if metadata is provided but not tracked.\n        this.database.logger.warn(\n          `Metadata provided for collection ${mutation.collection.id} but the PowerSync table does not track metadata. The PowerSync table should be configured with trackMetadata: true.`,\n          mutation.metadata,\n        )\n      }\n      return null\n    } else if (typeof mutation.metadata == `undefined`) {\n      return null\n    } else if (typeof mutation.metadata == `string`) {\n      return mutation.metadata\n    } else {\n      return JSON.stringify(mutation.metadata)\n    }\n  }\n}\n"],"names":["mutation"],"mappings":"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"}

package/dist/esm/powersync.js

@@ -55,6 +55,14 @@ function powerSyncCollectionOptions(config) {
       } else {
         return runOnDemandSync();
       }
+      async function safelyDisposeTracking(context) {
+        const dispose = disposeTracking;
+        if (!dispose) {
+          return;
+        }
+        disposeTracking = null;
+        await dispose(context ? { context } : void 0);
+      }
       async function createDiffTrigger(options) {
         const { setupContext, when, writeType, batchQuery, onReady } = options;
         return await database.triggers.createDiffTrigger({
@@ -102,6 +110,9 @@ function powerSyncCollectionOptions(config) {
         });
       }
       async function flushDiffRecordsWithContext(context) {
+        if (!disposeTracking) {
+          return;
+        }
         try {
           begin();
           const operations = await context.getAll(
@@ -158,12 +169,12 @@ function powerSyncCollectionOptions(config) {
         );
         await afterOnChangeRegistered?.();
         if (abortController.signal.aborted) {
-          await disposeTracking?.();
+          await safelyDisposeTracking();
         } else {
           abortController.signal.addEventListener(
             `abort`,
             async () => {
-              await disposeTracking?.();
+              await safelyDisposeTracking();
             },
             { once: true }
           );
@@ -217,7 +228,7 @@ function powerSyncCollectionOptions(config) {
           if (activeWhereExpressions.length === 0) {
             await database.writeLock(async (ctx) => {
               await flushDiffRecordsWithContext(ctx);
-              await disposeTracking?.({ context: ctx });
+              await safelyDisposeTracking(ctx);
             });
             return;
           }
@@ -240,7 +251,7 @@ function powerSyncCollectionOptions(config) {
           const viewWhereClause = toInlinedWhereClause(compiledView);
           await database.writeLock(async (ctx) => {
             await flushDiffRecordsWithContext(ctx);
-            await disposeTracking?.({ context: ctx });
+            await safelyDisposeTracking(ctx);
             disposeTracking = await createDiffTrigger({
               setupContext: ctx,
               when: {

package/dist/esm/powersync.js.map

@@ -1 +1 @@
-{"version":3,"file":"powersync.js","sources":["../../src/powersync.ts"],"sourcesContent":["import { DiffTriggerOperation, sanitizeSQL } from '@powersync/common'\nimport { or } from '@tanstack/db'\nimport { compileSQLite } from './sqlite-compiler'\nimport { PendingOperationStore } from './PendingOperationStore'\nimport { PowerSyncTransactor } from './PowerSyncTransactor'\nimport { DEFAULT_BATCH_SIZE } from './definitions'\nimport { asPowerSyncRecord, mapOperation } from './helpers'\nimport { convertTableToSchema } from './schema'\nimport { serializeForSQLite } from './serialization'\nimport type {\n  CleanupFn,\n  LoadSubsetOptions,\n  OperationType,\n  SyncConfig,\n} from '@tanstack/db'\nimport type {\n  AnyTableColumnType,\n  ExtractedTable,\n  ExtractedTableColumns,\n  MapBaseColumnType,\n  OptionalExtractedTable,\n} from './helpers'\nimport type {\n  BasePowerSyncCollectionConfig,\n  ConfigWithArbitraryCollectionTypes,\n  ConfigWithSQLiteInputType,\n  ConfigWithSQLiteTypes,\n  CustomSQLiteSerializer,\n  EnhancedPowerSyncCollectionConfig,\n  InferPowerSyncOutputType,\n  PowerSyncCollectionConfig,\n  PowerSyncCollectionUtils,\n} from './definitions'\nimport type { PendingOperation } from './PendingOperationStore'\nimport type { StandardSchemaV1 } from '@standard-schema/spec'\nimport type { LockContext, Table, TriggerDiffRecord } from '@powersync/common'\n\n/**\n * Creates PowerSync collection options for use with a standard Collection.\n *\n * @template TTable - The SQLite-based typing\n * @template TSchema - The validation schema type (optionally supports a custom input type)\n * @param config - Configuration options for the PowerSync collection\n * @returns Collection options with utilities\n */\n\n// Overload 1: No schema is provided\n\n/**\n * Creates a PowerSync collection configuration with basic default validation.\n * Input and Output types are the SQLite column types.\n *\n * @example\n * ```typescript\n * const APP_SCHEMA = new Schema({\n *   documents: new Table({\n *     name: column.text,\n *   }),\n * })\n *\n * type Document = (typeof APP_SCHEMA)[\"types\"][\"documents\"]\n *\n * const db = new PowerSyncDatabase({\n *   database: {\n *     dbFilename: \"test.sqlite\",\n *   },\n *   schema: APP_SCHEMA,\n * })\n *\n * const collection = createCollection(\n *   powerSyncCollectionOptions({\n *     database: db,\n *     table: APP_SCHEMA.props.documents\n *   })\n * )\n * ```\n */\nexport function powerSyncCollectionOptions<TTable extends Table = Table>(\n  config: BasePowerSyncCollectionConfig<TTable, never> & ConfigWithSQLiteTypes,\n): EnhancedPowerSyncCollectionConfig<\n  TTable,\n  OptionalExtractedTable<TTable>,\n  never\n>\n\n// Overload 2: Schema is provided and the TInput matches SQLite types.\n\n/**\n * Creates a PowerSync collection configuration with schema validation.\n *\n * The input types satisfy the SQLite column types.\n *\n * The output types are defined by the provided schema. This schema can enforce additional\n * validation or type transforms.\n * Arbitrary output typed mutations are encoded to SQLite for persistence. We provide a basic standard\n * serialization implementation to serialize column values. Custom or advanced types require providing additional\n * serializer specifications. Partial column overrides can be supplied to `serializer`.\n *\n * @example\n * ```typescript\n * import { z } from \"zod\"\n *\n * // The PowerSync SQLite schema\n * const APP_SCHEMA = new Schema({\n *   documents: new Table({\n *     name: column.text,\n *     // Dates are stored as ISO date strings in SQLite\n *     created_at: column.text\n *   }),\n * })\n *\n * // Advanced Zod validations. The output type of this schema\n * // is constrained to the SQLite schema of APP_SCHEMA\n * const schema = z.object({\n *   id: z.string(),\n *   // Notice that `name` is not nullable (is required) here and it has additional validation\n *   name: z.string().min(3, { message: \"Should be at least 3 characters\" }).nullable(),\n *   // The input type is still the SQLite string type. While collections will output smart Date instances.\n *   created_at: z.string().transform(val => new Date(val))\n * })\n *\n * const collection = createCollection(\n *   powerSyncCollectionOptions({\n *     database: db,\n *     table: APP_SCHEMA.props.documents,\n *     schema,\n *     serializer: {\n *        // The default is toISOString, this is just to demonstrate custom overrides\n *        created_at: (outputValue) => outputValue.toISOString(),\n *     },\n *   })\n * )\n * ```\n */\nexport function powerSyncCollectionOptions<\n  TTable extends Table,\n  TSchema extends StandardSchemaV1<\n    // TInput is the SQLite types. We can use the supplied schema to validate sync input\n    OptionalExtractedTable<TTable>,\n    AnyTableColumnType<TTable>\n  >,\n>(\n  config: BasePowerSyncCollectionConfig<TTable, TSchema> &\n    ConfigWithSQLiteInputType<TTable, TSchema>,\n): EnhancedPowerSyncCollectionConfig<\n  TTable,\n  InferPowerSyncOutputType<TTable, TSchema>,\n  TSchema\n> & {\n  schema: TSchema\n}\n\n// Overload 3: Schema is provided with arbitrary TInput and TOutput\n/**\n * Creates a PowerSync collection configuration with schema validation.\n *\n * The input types are not linked to the internal SQLite table types. This can\n * give greater flexibility, e.g. by accepting rich types as input for `insert` or `update` operations.\n * An additional `deserializationSchema` is required in order to process incoming SQLite updates to the output type.\n *\n * The output types are defined by the provided schema. This schema can enforce additional\n * validation or type transforms.\n * Arbitrary output typed mutations are encoded to SQLite for persistence. We provide a basic standard\n * serialization implementation to serialize column values. Custom or advanced types require providing additional\n * serializer specifications. Partial column overrides can be supplied to `serializer`.\n *\n * @example\n * ```typescript\n * import { z } from \"zod\"\n *\n * // The PowerSync SQLite schema\n * const APP_SCHEMA = new Schema({\n *   documents: new Table({\n *     name: column.text,\n *     // Booleans are represented as integers in SQLite\n *     is_active: column.integer\n *   }),\n * })\n *\n * // Advanced Zod validations.\n * // We accept boolean values as input for operations and expose Booleans in query results\n * const schema = z.object({\n *   id: z.string(),\n *   isActive: z.boolean(), // TInput and TOutput are boolean\n * })\n *\n * // The deserializationSchema converts the SQLite synced INTEGER (0/1) values to booleans.\n * const deserializationSchema = z.object({\n *   id: z.string(),\n *   isActive: z.number().nullable().transform((val) => val == null ? true : val > 0),\n * })\n *\n * const collection = createCollection(\n *   powerSyncCollectionOptions({\n *     database: db,\n *     table: APP_SCHEMA.props.documents,\n *     schema,\n *     deserializationSchema,\n *   })\n * )\n * ```\n */\nexport function powerSyncCollectionOptions<\n  TTable extends Table,\n  TSchema extends StandardSchemaV1<\n    // The input and output must have the same keys, the value types can be arbitrary\n    AnyTableColumnType<TTable>,\n    AnyTableColumnType<TTable>\n  >,\n>(\n  config: BasePowerSyncCollectionConfig<TTable, TSchema> &\n    ConfigWithArbitraryCollectionTypes<TTable, TSchema>,\n): EnhancedPowerSyncCollectionConfig<\n  TTable,\n  InferPowerSyncOutputType<TTable, TSchema>,\n  TSchema\n> & {\n  utils: PowerSyncCollectionUtils<TTable>\n  schema: TSchema\n}\n\n/**\n * Implementation of powerSyncCollectionOptions that handles both schema and non-schema configurations.\n */\n\nexport function powerSyncCollectionOptions<\n  TTable extends Table,\n  TSchema extends StandardSchemaV1<any> = never,\n>(config: PowerSyncCollectionConfig<TTable, TSchema>) {\n  const {\n    database,\n    table,\n    schema: inputSchema,\n    syncBatchSize = DEFAULT_BATCH_SIZE,\n    syncMode = 'eager',\n    ...restConfig\n  } = config\n\n  const deserializationSchema =\n    `deserializationSchema` in config ? config.deserializationSchema : null\n  const serializer = `serializer` in config ? config.serializer : undefined\n  const onDeserializationError =\n    `onDeserializationError` in config\n      ? config.onDeserializationError\n      : undefined\n\n  // The SQLite table type\n  type TableType = ExtractedTable<TTable>\n\n  // The collection output type\n  type OutputType = InferPowerSyncOutputType<TTable, TSchema>\n\n  const { viewName, trackMetadata: metadataIsTracked } = table\n\n  /**\n   * Deserializes data from the incoming sync stream\n   */\n  const deserializeSyncRow = (value: TableType): OutputType => {\n    const validationSchema = deserializationSchema || schema\n    const validation = validationSchema[`~standard`].validate(value)\n    if (`value` in validation) {\n      return validation.value\n    } else if (`issues` in validation) {\n      const issueMessage = `Failed to validate incoming data for ${viewName}. Issues: ${validation.issues.map((issue) => `${issue.path} - ${issue.message}`)}`\n      database.logger.error(issueMessage)\n      onDeserializationError!(validation)\n      throw new Error(issueMessage)\n    } else {\n      const unknownErrorMessage = `Unknown deserialization error for ${viewName}`\n      database.logger.error(unknownErrorMessage)\n      onDeserializationError!({ issues: [{ message: unknownErrorMessage }] })\n      throw new Error(unknownErrorMessage)\n    }\n  }\n\n  // We can do basic runtime validations for columns if not explicit schema has been provided\n  const schema = inputSchema ?? (convertTableToSchema(table) as TSchema)\n  /**\n   * The onInsert, onUpdate, and onDelete handlers should only return\n   * after we have written the changes to TanStack DB.\n   * We currently only write to TanStack DB from a diff trigger.\n   * We wait for the diff trigger to observe the change,\n   * and only then return from the on[X] handlers.\n   * This ensures that when the transaction is reported as\n   * complete to the caller, the in-memory state is already\n   * consistent with the database.\n   */\n  const pendingOperationStore = PendingOperationStore.GLOBAL\n  // Keep the tracked table unique in case of multiple tabs.\n  const trackedTableName = `__${viewName}_tracking_${Math.floor(\n    Math.random() * 0xffffffff,\n  )\n    .toString(16)\n    .padStart(8, `0`)}`\n\n  const transactor = new PowerSyncTransactor({\n    database,\n  })\n\n  /**\n   * \"sync\"\n   * Notice that this describes the Sync between the local SQLite table\n   * and the in-memory tanstack-db collection.\n   */\n  const sync: SyncConfig<OutputType, string> = {\n    sync: (params) => {\n      const { begin, write, collection, commit, markReady } = params\n      const abortController = new AbortController()\n\n      let disposeTracking:\n        | ((options?: { context?: LockContext }) => Promise<void>)\n        | null = null\n\n      if (syncMode === `eager`) {\n        return runEagerSync()\n      } else {\n        return runOnDemandSync()\n      }\n\n      async function createDiffTrigger(options: {\n        setupContext?: LockContext\n        when: Record<DiffTriggerOperation, string>\n        writeType: (rowId: string) => OperationType\n        batchQuery: (\n          lockContext: LockContext,\n          batchSize: number,\n          cursor: number,\n        ) => Promise<Array<TableType>>\n        onReady: () => void\n      }) {\n        const { setupContext, when, writeType, batchQuery, onReady } = options\n\n        return await database.triggers.createDiffTrigger({\n          source: viewName,\n          destination: trackedTableName,\n          setupContext,\n          when,\n          hooks: {\n            beforeCreate: async (context) => {\n              let currentBatchCount = syncBatchSize\n              let cursor = 0\n              while (currentBatchCount == syncBatchSize) {\n                begin()\n\n                const batchItems = await batchQuery(\n                  context,\n                  syncBatchSize,\n                  cursor,\n                )\n                currentBatchCount = batchItems.length\n                cursor += currentBatchCount\n                for (const row of batchItems) {\n                  write({\n                    type: writeType(row.id),\n                    value: deserializeSyncRow(row),\n                  })\n                }\n                commit()\n              }\n              onReady()\n              database.logger.info(\n                `Sync is ready for ${viewName} into ${trackedTableName}`,\n              )\n            },\n          },\n        })\n      }\n\n      async function flushDiffRecords(): Promise<void> {\n        await database\n          .writeTransaction(async (context) => {\n            await flushDiffRecordsWithContext(context)\n          })\n          .catch((error) => {\n            database.logger.error(\n              `An error has been detected in the sync handler`,\n              error,\n            )\n          })\n      }\n\n      // We can use this directly if we want to pair a flush with dispose+recreate diff trigger.\n      async function flushDiffRecordsWithContext(\n        context: LockContext,\n      ): Promise<void> {\n        try {\n          begin()\n          const operations = await context.getAll<TriggerDiffRecord>(\n            `SELECT * FROM ${trackedTableName} ORDER BY operation_id ASC`,\n          )\n          const pendingOperations: Array<PendingOperation> = []\n\n          for (const op of operations) {\n            const { id, operation, timestamp, value } = op\n            const parsedValue = deserializeSyncRow({\n              id,\n              ...JSON.parse(value),\n            })\n            const parsedPreviousValue =\n              op.operation == DiffTriggerOperation.UPDATE\n                ? deserializeSyncRow({\n                    id,\n                    ...JSON.parse(op.previous_value),\n                  })\n                : undefined\n            write({\n              type: mapOperation(operation),\n              value: parsedValue,\n              previousValue: parsedPreviousValue,\n            })\n            pendingOperations.push({\n              id,\n              operation,\n              timestamp,\n              tableName: viewName,\n            })\n          }\n\n          // clear the current operations\n          await context.execute(`DELETE FROM ${trackedTableName}`)\n\n          commit()\n          pendingOperationStore.resolvePendingFor(pendingOperations)\n        } catch (error) {\n          database.logger.error(\n            `An error has been detected in the sync handler`,\n            error,\n          )\n        }\n      }\n\n      // The sync function needs to be synchronous.\n      async function start(afterOnChangeRegistered?: () => Promise<void>) {\n        database.logger.info(\n          `Sync is starting for ${viewName} into ${trackedTableName}`,\n        )\n        database.onChangeWithCallback(\n          {\n            onChange: async () => {\n              await flushDiffRecords()\n            },\n          },\n          {\n            signal: abortController.signal,\n            triggerImmediate: false,\n            tables: [trackedTableName],\n          },\n        )\n\n        await afterOnChangeRegistered?.()\n\n        // If the abort controller was aborted while processing the request above\n        if (abortController.signal.aborted) {\n          await disposeTracking?.()\n        } else {\n          abortController.signal.addEventListener(\n            `abort`,\n            async () => {\n              await disposeTracking?.()\n            },\n            { once: true },\n          )\n        }\n      }\n\n      // Eager mode.\n      // Registers a diff trigger for the entire table.\n      function runEagerSync() {\n        let onUnload: CleanupFn | void | null = null\n\n        start(async () => {\n          onUnload = await restConfig.onLoad?.()\n\n          disposeTracking = await createDiffTrigger({\n            when: {\n              [DiffTriggerOperation.INSERT]: `TRUE`,\n              [DiffTriggerOperation.UPDATE]: `TRUE`,\n              [DiffTriggerOperation.DELETE]: `TRUE`,\n            },\n            writeType: (_rowId: string) => `insert`,\n            batchQuery: (\n              lockContext: LockContext,\n              batchSize: number,\n              cursor: number,\n            ) =>\n              lockContext.getAll<TableType>(\n                sanitizeSQL`SELECT * FROM ${viewName} LIMIT ? OFFSET ?`,\n                [batchSize, cursor],\n              ),\n            onReady: () => markReady(),\n          })\n        }).catch((error) =>\n          database.logger.error(\n            `Could not start syncing process for ${viewName} into ${trackedTableName}`,\n            error,\n          ),\n        )\n\n        return () => {\n          database.logger.info(\n            `Sync has been stopped for ${viewName} into ${trackedTableName}`,\n          )\n          abortController.abort()\n          onUnload?.()\n        }\n      }\n\n      // On-demand mode.\n      // Registers a diff trigger for the active WHERE expressions.\n      function runOnDemandSync() {\n        let onUnloadSubset: CleanupFn | void | null = null\n\n        start().catch((error) =>\n          database.logger.error(\n            `Could not start syncing process for ${viewName} into ${trackedTableName}`,\n            error,\n          ),\n        )\n\n        // Tracks all active WHERE expressions for on-demand sync filtering.\n        // Each loadSubset call pushes its predicate; unloadSubset removes it.\n        const activeWhereExpressions: Array<LoadSubsetOptions['where']> = []\n\n        const loadSubset = async (\n          options?: LoadSubsetOptions,\n        ): Promise<void> => {\n          if (options) {\n            activeWhereExpressions.push(options.where)\n            onUnloadSubset = await restConfig.onLoadSubset?.(options)\n          }\n\n          if (activeWhereExpressions.length === 0) {\n            await database.writeLock(async (ctx) => {\n              await flushDiffRecordsWithContext(ctx)\n              await disposeTracking?.({ context: ctx })\n            })\n            return\n          }\n\n          const combinedWhere =\n            activeWhereExpressions.length === 1\n              ? activeWhereExpressions[0]\n              : or(\n                  activeWhereExpressions[0],\n                  activeWhereExpressions[1],\n                  ...activeWhereExpressions.slice(2),\n                )\n\n          const compiledNewData = compileSQLite(\n            { where: combinedWhere },\n            { jsonColumn: 'NEW.data' },\n          )\n\n          const compiledOldData = compileSQLite(\n            { where: combinedWhere },\n            { jsonColumn: 'OLD.data' },\n          )\n\n          const compiledView = compileSQLite({ where: combinedWhere })\n\n          const newDataWhenClause = toInlinedWhereClause(compiledNewData)\n          const oldDataWhenClause = toInlinedWhereClause(compiledOldData)\n          const viewWhereClause = toInlinedWhereClause(compiledView)\n\n          await database.writeLock(async (ctx) => {\n            await flushDiffRecordsWithContext(ctx)\n            await disposeTracking?.({ context: ctx })\n\n            disposeTracking = await createDiffTrigger({\n              setupContext: ctx,\n              when: {\n                [DiffTriggerOperation.INSERT]: newDataWhenClause,\n                [DiffTriggerOperation.UPDATE]: `(${newDataWhenClause}) OR (${oldDataWhenClause})`,\n                [DiffTriggerOperation.DELETE]: oldDataWhenClause,\n              },\n              writeType: (rowId: string) =>\n                collection.has(rowId) ? `update` : `insert`,\n              batchQuery: (\n                lockContext: LockContext,\n                batchSize: number,\n                cursor: number,\n              ) =>\n                lockContext.getAll<TableType>(\n                  `SELECT * FROM ${viewName} WHERE ${viewWhereClause} LIMIT ? OFFSET ?`,\n                  [batchSize, cursor],\n                ),\n              onReady: () => {},\n            })\n          })\n        }\n\n        const toInlinedWhereClause = (compiled: {\n          where?: string\n          params: Array<unknown>\n        }): string => {\n          if (!compiled.where) return 'TRUE'\n          const sqlParts = compiled.where.split('?')\n          return sanitizeSQL(\n            sqlParts as unknown as TemplateStringsArray,\n            ...compiled.params,\n          )\n        }\n\n        const unloadSubset = async (options: LoadSubsetOptions) => {\n          onUnloadSubset?.()\n\n          const idx = activeWhereExpressions.indexOf(options.where)\n          if (idx !== -1) {\n            activeWhereExpressions.splice(idx, 1)\n          }\n\n          // Evict rows that were exclusively loaded by the departing predicate.\n          // These are rows matching the departing WHERE that are no longer covered\n          // by any remaining active predicate.\n          const compiledDeparting = compileSQLite({ where: options.where })\n          const departingWhereSQL = toInlinedWhereClause(compiledDeparting)\n\n          let evictionSQL: string\n          if (activeWhereExpressions.length === 0) {\n            evictionSQL = `SELECT id FROM ${viewName} WHERE ${departingWhereSQL}`\n          } else {\n            const combinedRemaining =\n              activeWhereExpressions.length === 1\n                ? activeWhereExpressions[0]!\n                : or(\n                    activeWhereExpressions[0],\n                    activeWhereExpressions[1],\n                    ...activeWhereExpressions.slice(2),\n                  )\n            const compiledRemaining = compileSQLite({\n              where: combinedRemaining,\n            })\n            const remainingWhereSQL = toInlinedWhereClause(compiledRemaining)\n            evictionSQL = `SELECT id FROM ${viewName} WHERE (${departingWhereSQL}) AND NOT (${remainingWhereSQL})`\n          }\n\n          const rowsToEvict = await database.getAll<{ id: string }>(evictionSQL)\n          if (rowsToEvict.length > 0) {\n            begin()\n            for (const { id } of rowsToEvict) {\n              write({ type: `delete`, key: id })\n            }\n            commit()\n          }\n\n          // Recreate the diff trigger for the remaining active WHERE expressions.\n          await loadSubset()\n        }\n\n        markReady()\n\n        return {\n          cleanup: () => {\n            database.logger.info(\n              `Sync has been stopped for ${viewName} into ${trackedTableName}`,\n            )\n            abortController.abort()\n          },\n          loadSubset: (options: LoadSubsetOptions) => loadSubset(options),\n          unloadSubset: (options: LoadSubsetOptions) => unloadSubset(options),\n        }\n      }\n    },\n    // Expose the getSyncMetadata function\n    getSyncMetadata: undefined,\n  }\n\n  const getKey = (record: OutputType) => asPowerSyncRecord(record).id\n\n  const outputConfig: EnhancedPowerSyncCollectionConfig<\n    TTable,\n    OutputType,\n    TSchema\n  > = {\n    ...restConfig,\n    schema,\n    getKey,\n    // Syncing should start immediately since we need to monitor the changes for mutations\n    startSync: true,\n    syncMode,\n    sync,\n    onInsert: async (params) => {\n      // The transaction here should only ever contain a single insert mutation\n      return await transactor.applyTransaction(params.transaction)\n    },\n    onUpdate: async (params) => {\n      // The transaction here should only ever contain a single update mutation\n      return await transactor.applyTransaction(params.transaction)\n    },\n    onDelete: async (params) => {\n      // The transaction here should only ever contain a single delete mutation\n      return await transactor.applyTransaction(params.transaction)\n    },\n    utils: {\n      getMeta: () => ({\n        tableName: viewName,\n        trackedTableName,\n        metadataIsTracked,\n        serializeValue: (value) =>\n          serializeForSQLite(\n            value,\n            // This is required by the input generic\n            table as Table<\n              MapBaseColumnType<InferPowerSyncOutputType<TTable, TSchema>>\n            >,\n            // Coerce serializer to the shape that corresponds to the Table constructed from OutputType\n            serializer as CustomSQLiteSerializer<\n              OutputType,\n              ExtractedTableColumns<Table<MapBaseColumnType<OutputType>>>\n            >,\n          ),\n      }),\n    },\n  }\n  return outputConfig\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"powersync.js","sources":["../../src/powersync.ts"],"sourcesContent":["import { DiffTriggerOperation, sanitizeSQL } from '@powersync/common'\nimport { or } from '@tanstack/db'\nimport { compileSQLite } from './sqlite-compiler'\nimport { PendingOperationStore } from './PendingOperationStore'\nimport { PowerSyncTransactor } from './PowerSyncTransactor'\nimport { DEFAULT_BATCH_SIZE } from './definitions'\nimport { asPowerSyncRecord, mapOperation } from './helpers'\nimport { convertTableToSchema } from './schema'\nimport { serializeForSQLite } from './serialization'\nimport type {\n  CleanupFn,\n  LoadSubsetOptions,\n  OperationType,\n  SyncConfig,\n} from '@tanstack/db'\nimport type {\n  AnyTableColumnType,\n  ExtractedTable,\n  ExtractedTableColumns,\n  MapBaseColumnType,\n  OptionalExtractedTable,\n} from './helpers'\nimport type {\n  BasePowerSyncCollectionConfig,\n  ConfigWithArbitraryCollectionTypes,\n  ConfigWithSQLiteInputType,\n  ConfigWithSQLiteTypes,\n  CustomSQLiteSerializer,\n  EnhancedPowerSyncCollectionConfig,\n  InferPowerSyncOutputType,\n  PowerSyncCollectionConfig,\n  PowerSyncCollectionUtils,\n} from './definitions'\nimport type { PendingOperation } from './PendingOperationStore'\nimport type { StandardSchemaV1 } from '@standard-schema/spec'\nimport type { LockContext, Table, TriggerDiffRecord } from '@powersync/common'\n\n/**\n * Creates PowerSync collection options for use with a standard Collection.\n *\n * @template TTable - The SQLite-based typing\n * @template TSchema - The validation schema type (optionally supports a custom input type)\n * @param config - Configuration options for the PowerSync collection\n * @returns Collection options with utilities\n */\n\n// Overload 1: No schema is provided\n\n/**\n * Creates a PowerSync collection configuration with basic default validation.\n * Input and Output types are the SQLite column types.\n *\n * @example\n * ```typescript\n * const APP_SCHEMA = new Schema({\n *   documents: new Table({\n *     name: column.text,\n *   }),\n * })\n *\n * type Document = (typeof APP_SCHEMA)[\"types\"][\"documents\"]\n *\n * const db = new PowerSyncDatabase({\n *   database: {\n *     dbFilename: \"test.sqlite\",\n *   },\n *   schema: APP_SCHEMA,\n * })\n *\n * const collection = createCollection(\n *   powerSyncCollectionOptions({\n *     database: db,\n *     table: APP_SCHEMA.props.documents\n *   })\n * )\n * ```\n */\nexport function powerSyncCollectionOptions<TTable extends Table = Table>(\n  config: BasePowerSyncCollectionConfig<TTable, never> & ConfigWithSQLiteTypes,\n): EnhancedPowerSyncCollectionConfig<\n  TTable,\n  OptionalExtractedTable<TTable>,\n  never\n>\n\n// Overload 2: Schema is provided and the TInput matches SQLite types.\n\n/**\n * Creates a PowerSync collection configuration with schema validation.\n *\n * The input types satisfy the SQLite column types.\n *\n * The output types are defined by the provided schema. This schema can enforce additional\n * validation or type transforms.\n * Arbitrary output typed mutations are encoded to SQLite for persistence. We provide a basic standard\n * serialization implementation to serialize column values. Custom or advanced types require providing additional\n * serializer specifications. Partial column overrides can be supplied to `serializer`.\n *\n * @example\n * ```typescript\n * import { z } from \"zod\"\n *\n * // The PowerSync SQLite schema\n * const APP_SCHEMA = new Schema({\n *   documents: new Table({\n *     name: column.text,\n *     // Dates are stored as ISO date strings in SQLite\n *     created_at: column.text\n *   }),\n * })\n *\n * // Advanced Zod validations. The output type of this schema\n * // is constrained to the SQLite schema of APP_SCHEMA\n * const schema = z.object({\n *   id: z.string(),\n *   // Notice that `name` is not nullable (is required) here and it has additional validation\n *   name: z.string().min(3, { message: \"Should be at least 3 characters\" }).nullable(),\n *   // The input type is still the SQLite string type. While collections will output smart Date instances.\n *   created_at: z.string().transform(val => new Date(val))\n * })\n *\n * const collection = createCollection(\n *   powerSyncCollectionOptions({\n *     database: db,\n *     table: APP_SCHEMA.props.documents,\n *     schema,\n *     serializer: {\n *        // The default is toISOString, this is just to demonstrate custom overrides\n *        created_at: (outputValue) => outputValue.toISOString(),\n *     },\n *   })\n * )\n * ```\n */\nexport function powerSyncCollectionOptions<\n  TTable extends Table,\n  TSchema extends StandardSchemaV1<\n    // TInput is the SQLite types. We can use the supplied schema to validate sync input\n    OptionalExtractedTable<TTable>,\n    AnyTableColumnType<TTable>\n  >,\n>(\n  config: BasePowerSyncCollectionConfig<TTable, TSchema> &\n    ConfigWithSQLiteInputType<TTable, TSchema>,\n): EnhancedPowerSyncCollectionConfig<\n  TTable,\n  InferPowerSyncOutputType<TTable, TSchema>,\n  TSchema\n> & {\n  schema: TSchema\n}\n\n// Overload 3: Schema is provided with arbitrary TInput and TOutput\n/**\n * Creates a PowerSync collection configuration with schema validation.\n *\n * The input types are not linked to the internal SQLite table types. This can\n * give greater flexibility, e.g. by accepting rich types as input for `insert` or `update` operations.\n * An additional `deserializationSchema` is required in order to process incoming SQLite updates to the output type.\n *\n * The output types are defined by the provided schema. This schema can enforce additional\n * validation or type transforms.\n * Arbitrary output typed mutations are encoded to SQLite for persistence. We provide a basic standard\n * serialization implementation to serialize column values. Custom or advanced types require providing additional\n * serializer specifications. Partial column overrides can be supplied to `serializer`.\n *\n * @example\n * ```typescript\n * import { z } from \"zod\"\n *\n * // The PowerSync SQLite schema\n * const APP_SCHEMA = new Schema({\n *   documents: new Table({\n *     name: column.text,\n *     // Booleans are represented as integers in SQLite\n *     is_active: column.integer\n *   }),\n * })\n *\n * // Advanced Zod validations.\n * // We accept boolean values as input for operations and expose Booleans in query results\n * const schema = z.object({\n *   id: z.string(),\n *   isActive: z.boolean(), // TInput and TOutput are boolean\n * })\n *\n * // The deserializationSchema converts the SQLite synced INTEGER (0/1) values to booleans.\n * const deserializationSchema = z.object({\n *   id: z.string(),\n *   isActive: z.number().nullable().transform((val) => val == null ? true : val > 0),\n * })\n *\n * const collection = createCollection(\n *   powerSyncCollectionOptions({\n *     database: db,\n *     table: APP_SCHEMA.props.documents,\n *     schema,\n *     deserializationSchema,\n *   })\n * )\n * ```\n */\nexport function powerSyncCollectionOptions<\n  TTable extends Table,\n  TSchema extends StandardSchemaV1<\n    // The input and output must have the same keys, the value types can be arbitrary\n    AnyTableColumnType<TTable>,\n    AnyTableColumnType<TTable>\n  >,\n>(\n  config: BasePowerSyncCollectionConfig<TTable, TSchema> &\n    ConfigWithArbitraryCollectionTypes<TTable, TSchema>,\n): EnhancedPowerSyncCollectionConfig<\n  TTable,\n  InferPowerSyncOutputType<TTable, TSchema>,\n  TSchema\n> & {\n  utils: PowerSyncCollectionUtils<TTable>\n  schema: TSchema\n}\n\n/**\n * Implementation of powerSyncCollectionOptions that handles both schema and non-schema configurations.\n */\n\nexport function powerSyncCollectionOptions<\n  TTable extends Table,\n  TSchema extends StandardSchemaV1<any> = never,\n>(config: PowerSyncCollectionConfig<TTable, TSchema>) {\n  const {\n    database,\n    table,\n    schema: inputSchema,\n    syncBatchSize = DEFAULT_BATCH_SIZE,\n    syncMode = 'eager',\n    ...restConfig\n  } = config\n\n  const deserializationSchema =\n    `deserializationSchema` in config ? config.deserializationSchema : null\n  const serializer = `serializer` in config ? config.serializer : undefined\n  const onDeserializationError =\n    `onDeserializationError` in config\n      ? config.onDeserializationError\n      : undefined\n\n  // The SQLite table type\n  type TableType = ExtractedTable<TTable>\n\n  // The collection output type\n  type OutputType = InferPowerSyncOutputType<TTable, TSchema>\n\n  const { viewName, trackMetadata: metadataIsTracked } = table\n\n  /**\n   * Deserializes data from the incoming sync stream\n   */\n  const deserializeSyncRow = (value: TableType): OutputType => {\n    const validationSchema = deserializationSchema || schema\n    const validation = validationSchema[`~standard`].validate(value)\n    if (`value` in validation) {\n      return validation.value\n    } else if (`issues` in validation) {\n      const issueMessage = `Failed to validate incoming data for ${viewName}. Issues: ${validation.issues.map((issue) => `${issue.path} - ${issue.message}`)}`\n      database.logger.error(issueMessage)\n      onDeserializationError!(validation)\n      throw new Error(issueMessage)\n    } else {\n      const unknownErrorMessage = `Unknown deserialization error for ${viewName}`\n      database.logger.error(unknownErrorMessage)\n      onDeserializationError!({ issues: [{ message: unknownErrorMessage }] })\n      throw new Error(unknownErrorMessage)\n    }\n  }\n\n  // We can do basic runtime validations for columns if not explicit schema has been provided\n  const schema = inputSchema ?? (convertTableToSchema(table) as TSchema)\n  /**\n   * The onInsert, onUpdate, and onDelete handlers should only return\n   * after we have written the changes to TanStack DB.\n   * We currently only write to TanStack DB from a diff trigger.\n   * We wait for the diff trigger to observe the change,\n   * and only then return from the on[X] handlers.\n   * This ensures that when the transaction is reported as\n   * complete to the caller, the in-memory state is already\n   * consistent with the database.\n   */\n  const pendingOperationStore = PendingOperationStore.GLOBAL\n  // Keep the tracked table unique in case of multiple tabs.\n  const trackedTableName = `__${viewName}_tracking_${Math.floor(\n    Math.random() * 0xffffffff,\n  )\n    .toString(16)\n    .padStart(8, `0`)}`\n\n  const transactor = new PowerSyncTransactor({\n    database,\n  })\n\n  /**\n   * \"sync\"\n   * Notice that this describes the Sync between the local SQLite table\n   * and the in-memory tanstack-db collection.\n   */\n  const sync: SyncConfig<OutputType, string> = {\n    sync: (params) => {\n      const { begin, write, collection, commit, markReady } = params\n      const abortController = new AbortController()\n\n      let disposeTracking:\n        | ((options?: { context?: LockContext }) => Promise<void>)\n        | null = null\n\n      if (syncMode === `eager`) {\n        return runEagerSync()\n      } else {\n        return runOnDemandSync()\n      }\n\n      /**\n       * Disposes the current diff trigger, if one is active, and clears the\n       * tracking state.\n       */\n      async function safelyDisposeTracking(\n        context?: LockContext,\n      ): Promise<void> {\n        const dispose = disposeTracking\n        if (!dispose) {\n          return\n        }\n\n        disposeTracking = null\n        await dispose(context ? { context } : undefined)\n      }\n\n      async function createDiffTrigger(options: {\n        setupContext?: LockContext\n        when: Record<DiffTriggerOperation, string>\n        writeType: (rowId: string) => OperationType\n        batchQuery: (\n          lockContext: LockContext,\n          batchSize: number,\n          cursor: number,\n        ) => Promise<Array<TableType>>\n        onReady: () => void\n      }) {\n        const { setupContext, when, writeType, batchQuery, onReady } = options\n\n        return await database.triggers.createDiffTrigger({\n          source: viewName,\n          destination: trackedTableName,\n          setupContext,\n          when,\n          hooks: {\n            beforeCreate: async (context) => {\n              let currentBatchCount = syncBatchSize\n              let cursor = 0\n              while (currentBatchCount == syncBatchSize) {\n                begin()\n\n                const batchItems = await batchQuery(\n                  context,\n                  syncBatchSize,\n                  cursor,\n                )\n                currentBatchCount = batchItems.length\n                cursor += currentBatchCount\n                for (const row of batchItems) {\n                  write({\n                    type: writeType(row.id),\n                    value: deserializeSyncRow(row),\n                  })\n                }\n                commit()\n              }\n              onReady()\n              database.logger.info(\n                `Sync is ready for ${viewName} into ${trackedTableName}`,\n              )\n            },\n          },\n        })\n      }\n\n      async function flushDiffRecords(): Promise<void> {\n        await database\n          .writeTransaction(async (context) => {\n            await flushDiffRecordsWithContext(context)\n          })\n          .catch((error) => {\n            database.logger.error(\n              `An error has been detected in the sync handler`,\n              error,\n            )\n          })\n      }\n\n      // We can use this directly if we want to pair a flush with dispose+recreate diff trigger.\n      async function flushDiffRecordsWithContext(\n        context: LockContext,\n      ): Promise<void> {\n        // There is nothing to flush if no tracking table is currently active.\n        if (!disposeTracking) {\n          return\n        }\n\n        try {\n          begin()\n          const operations = await context.getAll<TriggerDiffRecord>(\n            `SELECT * FROM ${trackedTableName} ORDER BY operation_id ASC`,\n          )\n          const pendingOperations: Array<PendingOperation> = []\n\n          for (const op of operations) {\n            const { id, operation, timestamp, value } = op\n            const parsedValue = deserializeSyncRow({\n              id,\n              ...JSON.parse(value),\n            })\n            const parsedPreviousValue =\n              op.operation == DiffTriggerOperation.UPDATE\n                ? deserializeSyncRow({\n                    id,\n                    ...JSON.parse(op.previous_value),\n                  })\n                : undefined\n            write({\n              type: mapOperation(operation),\n              value: parsedValue,\n              previousValue: parsedPreviousValue,\n            })\n            pendingOperations.push({\n              id,\n              operation,\n              timestamp,\n              tableName: viewName,\n            })\n          }\n\n          // clear the current operations\n          await context.execute(`DELETE FROM ${trackedTableName}`)\n\n          commit()\n          pendingOperationStore.resolvePendingFor(pendingOperations)\n        } catch (error) {\n          database.logger.error(\n            `An error has been detected in the sync handler`,\n            error,\n          )\n        }\n      }\n\n      // The sync function needs to be synchronous.\n      async function start(afterOnChangeRegistered?: () => Promise<void>) {\n        database.logger.info(\n          `Sync is starting for ${viewName} into ${trackedTableName}`,\n        )\n        database.onChangeWithCallback(\n          {\n            onChange: async () => {\n              await flushDiffRecords()\n            },\n          },\n          {\n            signal: abortController.signal,\n            triggerImmediate: false,\n            tables: [trackedTableName],\n          },\n        )\n\n        await afterOnChangeRegistered?.()\n\n        // If the abort controller was aborted while processing the request above\n        if (abortController.signal.aborted) {\n          await safelyDisposeTracking()\n        } else {\n          abortController.signal.addEventListener(\n            `abort`,\n            async () => {\n              await safelyDisposeTracking()\n            },\n            { once: true },\n          )\n        }\n      }\n\n      // Eager mode.\n      // Registers a diff trigger for the entire table.\n      function runEagerSync() {\n        let onUnload: CleanupFn | void | null = null\n\n        start(async () => {\n          onUnload = await restConfig.onLoad?.()\n\n          disposeTracking = await createDiffTrigger({\n            when: {\n              [DiffTriggerOperation.INSERT]: `TRUE`,\n              [DiffTriggerOperation.UPDATE]: `TRUE`,\n              [DiffTriggerOperation.DELETE]: `TRUE`,\n            },\n            writeType: (_rowId: string) => `insert`,\n            batchQuery: (\n              lockContext: LockContext,\n              batchSize: number,\n              cursor: number,\n            ) =>\n              lockContext.getAll<TableType>(\n                sanitizeSQL`SELECT * FROM ${viewName} LIMIT ? OFFSET ?`,\n                [batchSize, cursor],\n              ),\n            onReady: () => markReady(),\n          })\n        }).catch((error) =>\n          database.logger.error(\n            `Could not start syncing process for ${viewName} into ${trackedTableName}`,\n            error,\n          ),\n        )\n\n        return () => {\n          database.logger.info(\n            `Sync has been stopped for ${viewName} into ${trackedTableName}`,\n          )\n          abortController.abort()\n          onUnload?.()\n        }\n      }\n\n      // On-demand mode.\n      // Registers a diff trigger for the active WHERE expressions.\n      function runOnDemandSync() {\n        let onUnloadSubset: CleanupFn | void | null = null\n\n        start().catch((error) =>\n          database.logger.error(\n            `Could not start syncing process for ${viewName} into ${trackedTableName}`,\n            error,\n          ),\n        )\n\n        // Tracks all active WHERE expressions for on-demand sync filtering.\n        // Each loadSubset call pushes its predicate; unloadSubset removes it.\n        const activeWhereExpressions: Array<LoadSubsetOptions['where']> = []\n\n        const loadSubset = async (\n          options?: LoadSubsetOptions,\n        ): Promise<void> => {\n          if (options) {\n            activeWhereExpressions.push(options.where)\n            onUnloadSubset = await restConfig.onLoadSubset?.(options)\n          }\n\n          // No predicates remain, so stop tracking entirely. Both calls are no-ops\n          // when no tracking table is currently active.\n          if (activeWhereExpressions.length === 0) {\n            await database.writeLock(async (ctx) => {\n              await flushDiffRecordsWithContext(ctx)\n              await safelyDisposeTracking(ctx)\n            })\n            return\n          }\n\n          const combinedWhere =\n            activeWhereExpressions.length === 1\n              ? activeWhereExpressions[0]\n              : or(\n                  activeWhereExpressions[0],\n                  activeWhereExpressions[1],\n                  ...activeWhereExpressions.slice(2),\n                )\n\n          const compiledNewData = compileSQLite(\n            { where: combinedWhere },\n            { jsonColumn: 'NEW.data' },\n          )\n\n          const compiledOldData = compileSQLite(\n            { where: combinedWhere },\n            { jsonColumn: 'OLD.data' },\n          )\n\n          const compiledView = compileSQLite({ where: combinedWhere })\n\n          const newDataWhenClause = toInlinedWhereClause(compiledNewData)\n          const oldDataWhenClause = toInlinedWhereClause(compiledOldData)\n          const viewWhereClause = toInlinedWhereClause(compiledView)\n\n          await database.writeLock(async (ctx) => {\n            // Replace any active tracking with one covering the new set of\n            // predicates.\n            await flushDiffRecordsWithContext(ctx)\n            await safelyDisposeTracking(ctx)\n\n            disposeTracking = await createDiffTrigger({\n              setupContext: ctx,\n              when: {\n                [DiffTriggerOperation.INSERT]: newDataWhenClause,\n                [DiffTriggerOperation.UPDATE]: `(${newDataWhenClause}) OR (${oldDataWhenClause})`,\n                [DiffTriggerOperation.DELETE]: oldDataWhenClause,\n              },\n              writeType: (rowId: string) =>\n                collection.has(rowId) ? `update` : `insert`,\n              batchQuery: (\n                lockContext: LockContext,\n                batchSize: number,\n                cursor: number,\n              ) =>\n                lockContext.getAll<TableType>(\n                  `SELECT * FROM ${viewName} WHERE ${viewWhereClause} LIMIT ? OFFSET ?`,\n                  [batchSize, cursor],\n                ),\n              onReady: () => {},\n            })\n          })\n        }\n\n        const toInlinedWhereClause = (compiled: {\n          where?: string\n          params: Array<unknown>\n        }): string => {\n          if (!compiled.where) return 'TRUE'\n          const sqlParts = compiled.where.split('?')\n          return sanitizeSQL(\n            sqlParts as unknown as TemplateStringsArray,\n            ...compiled.params,\n          )\n        }\n\n        const unloadSubset = async (options: LoadSubsetOptions) => {\n          onUnloadSubset?.()\n\n          const idx = activeWhereExpressions.indexOf(options.where)\n          if (idx !== -1) {\n            activeWhereExpressions.splice(idx, 1)\n          }\n\n          // Evict rows that were exclusively loaded by the departing predicate.\n          // These are rows matching the departing WHERE that are no longer covered\n          // by any remaining active predicate.\n          const compiledDeparting = compileSQLite({ where: options.where })\n          const departingWhereSQL = toInlinedWhereClause(compiledDeparting)\n\n          let evictionSQL: string\n          if (activeWhereExpressions.length === 0) {\n            evictionSQL = `SELECT id FROM ${viewName} WHERE ${departingWhereSQL}`\n          } else {\n            const combinedRemaining =\n              activeWhereExpressions.length === 1\n                ? activeWhereExpressions[0]!\n                : or(\n                    activeWhereExpressions[0],\n                    activeWhereExpressions[1],\n                    ...activeWhereExpressions.slice(2),\n                  )\n            const compiledRemaining = compileSQLite({\n              where: combinedRemaining,\n            })\n            const remainingWhereSQL = toInlinedWhereClause(compiledRemaining)\n            evictionSQL = `SELECT id FROM ${viewName} WHERE (${departingWhereSQL}) AND NOT (${remainingWhereSQL})`\n          }\n\n          const rowsToEvict = await database.getAll<{ id: string }>(evictionSQL)\n          if (rowsToEvict.length > 0) {\n            begin()\n            for (const { id } of rowsToEvict) {\n              write({ type: `delete`, key: id })\n            }\n            commit()\n          }\n\n          // Recreate the diff trigger for the remaining active WHERE expressions.\n          await loadSubset()\n        }\n\n        markReady()\n\n        return {\n          cleanup: () => {\n            database.logger.info(\n              `Sync has been stopped for ${viewName} into ${trackedTableName}`,\n            )\n            abortController.abort()\n          },\n          loadSubset: (options: LoadSubsetOptions) => loadSubset(options),\n          unloadSubset: (options: LoadSubsetOptions) => unloadSubset(options),\n        }\n      }\n    },\n    // Expose the getSyncMetadata function\n    getSyncMetadata: undefined,\n  }\n\n  const getKey = (record: OutputType) => asPowerSyncRecord(record).id\n\n  const outputConfig: EnhancedPowerSyncCollectionConfig<\n    TTable,\n    OutputType,\n    TSchema\n  > = {\n    ...restConfig,\n    schema,\n    getKey,\n    // Syncing should start immediately since we need to monitor the changes for mutations\n    startSync: true,\n    syncMode,\n    sync,\n    onInsert: async (params) => {\n      // The transaction here should only ever contain a single insert mutation\n      return await transactor.applyTransaction(params.transaction)\n    },\n    onUpdate: async (params) => {\n      // The transaction here should only ever contain a single update mutation\n      return await transactor.applyTransaction(params.transaction)\n    },\n    onDelete: async (params) => {\n      // The transaction here should only ever contain a single delete mutation\n      return await transactor.applyTransaction(params.transaction)\n    },\n    utils: {\n      getMeta: () => ({\n        tableName: viewName,\n        trackedTableName,\n        metadataIsTracked,\n        serializeValue: (value) =>\n          serializeForSQLite(\n            value,\n            // This is required by the input generic\n            table as Table<\n              MapBaseColumnType<InferPowerSyncOutputType<TTable, TSchema>>\n            >,\n            // Coerce serializer to the shape that corresponds to the Table constructed from OutputType\n            serializer as CustomSQLiteSerializer<\n              OutputType,\n              ExtractedTableColumns<Table<MapBaseColumnType<OutputType>>>\n            >,\n          ),\n      }),\n    },\n  }\n  return outputConfig\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/powersync-db-collection",
-  "version": "0.1.54",
+  "version": "0.1.56",
   "description": "PowerSync collection for TanStack DB",
   "author": "POWERSYNC",
   "license": "MIT",
@@ -50,7 +50,7 @@
     "@tanstack/store": "^0.9.2",
     "debug": "^4.4.3",
     "p-defer": "^4.0.1",
-    "@tanstack/db": "0.6.16"
+    "@tanstack/db": "0.7.0"
   },
   "peerDependencies": {
     "@powersync/common": "^1.41.0"

package/src/PowerSyncTransactor.ts

@@ -284,7 +284,7 @@ export class PowerSyncTransactor {
 
     // Need to get the operation in order to wait for it
     const diffOperation = await context.get<{ id: string; timestamp: string }>(
-      sanitizeSQL`SELECT id, timestamp FROM ${trackedTableName} ORDER BY timestamp DESC LIMIT 1`,
+      sanitizeSQL`SELECT id, timestamp FROM ${trackedTableName} ORDER BY operation_id DESC LIMIT 1`,
     )
     return {
       tableName,

package/src/powersync.ts

@@ -317,6 +317,22 @@ export function powerSyncCollectionOptions<
         return runOnDemandSync()
       }
 
+      /**
+       * Disposes the current diff trigger, if one is active, and clears the
+       * tracking state.
+       */
+      async function safelyDisposeTracking(
+        context?: LockContext,
+      ): Promise<void> {
+        const dispose = disposeTracking
+        if (!dispose) {
+          return
+        }
+
+        disposeTracking = null
+        await dispose(context ? { context } : undefined)
+      }
+
       async function createDiffTrigger(options: {
         setupContext?: LockContext
         when: Record<DiffTriggerOperation, string>
@@ -383,6 +399,11 @@ export function powerSyncCollectionOptions<
       async function flushDiffRecordsWithContext(
         context: LockContext,
       ): Promise<void> {
+        // There is nothing to flush if no tracking table is currently active.
+        if (!disposeTracking) {
+          return
+        }
+
         try {
           begin()
           const operations = await context.getAll<TriggerDiffRecord>(
@@ -451,12 +472,12 @@ export function powerSyncCollectionOptions<
 
         // If the abort controller was aborted while processing the request above
         if (abortController.signal.aborted) {
-          await disposeTracking?.()
+          await safelyDisposeTracking()
         } else {
           abortController.signal.addEventListener(
             `abort`,
             async () => {
-              await disposeTracking?.()
+              await safelyDisposeTracking()
             },
             { once: true },
           )
@@ -529,10 +550,12 @@ export function powerSyncCollectionOptions<
             onUnloadSubset = await restConfig.onLoadSubset?.(options)
           }
 
+          // No predicates remain, so stop tracking entirely. Both calls are no-ops
+          // when no tracking table is currently active.
           if (activeWhereExpressions.length === 0) {
             await database.writeLock(async (ctx) => {
               await flushDiffRecordsWithContext(ctx)
-              await disposeTracking?.({ context: ctx })
+              await safelyDisposeTracking(ctx)
             })
             return
           }
@@ -563,8 +586,10 @@ export function powerSyncCollectionOptions<
           const viewWhereClause = toInlinedWhereClause(compiledView)
 
           await database.writeLock(async (ctx) => {
+            // Replace any active tracking with one covering the new set of
+            // predicates.
             await flushDiffRecordsWithContext(ctx)
-            await disposeTracking?.({ context: ctx })
+            await safelyDisposeTracking(ctx)
 
             disposeTracking = await createDiffTrigger({
               setupContext: ctx,