@tanstack/capacitor-db-sqlite-persistence 0.1.2

package/README.md

@@ -0,0 +1,109 @@
+# @tanstack/capacitor-db-sqlite-persistence
+
+Thin SQLite persistence for Capacitor apps using
+`@capacitor-community/sqlite`.
+
+## Public API
+
+- `createCapacitorSQLitePersistence(...)`
+- `persistedCollectionOptions(...)` (re-exported from core)
+
+## Install
+
+```bash
+pnpm add @tanstack/capacitor-db-sqlite-persistence @capacitor-community/sqlite
+```
+
+## Quick start
+
+```ts
+import { CapacitorSQLite, SQLiteConnection } from '@capacitor-community/sqlite'
+import { createCollection } from '@tanstack/db'
+import { QueryClient } from '@tanstack/query-core'
+import { queryCollectionOptions } from '@tanstack/query-db-collection'
+import {
+  createCapacitorSQLitePersistence,
+  persistedCollectionOptions,
+} from '@tanstack/capacitor-db-sqlite-persistence'
+
+type Todo = {
+  id: string
+  title: string
+  completed: boolean
+}
+
+const sqlite = new SQLiteConnection(CapacitorSQLite)
+const database = await sqlite.createConnection(
+  `tanstack-db`,
+  false,
+  `no-encryption`,
+  1,
+  false,
+)
+
+await database.open()
+
+// One shared persistence instance for the whole database.
+const persistence = createCapacitorSQLitePersistence({
+  database,
+})
+const queryClient = new QueryClient()
+
+export const todosCollection = createCollection(
+  persistedCollectionOptions<Todo, string>({
+    ...queryCollectionOptions({
+      queryKey: [`todos`],
+      queryFn: async () => {
+        const response = await fetch(`/api/todos`)
+        return response.json() as Promise<Array<Todo>>
+      },
+      queryClient,
+      getKey: (todo) => todo.id,
+    }),
+    id: `todos`,
+    persistence,
+    schemaVersion: 1, // Per-collection schema version
+  }),
+)
+```
+
+## Platform notes
+
+- `createCapacitorSQLitePersistence` is shared across collections.
+- Mode defaults (`sync-present` vs `sync-absent`) are inferred from whether a
+  `sync` config is present in `persistedCollectionOptions`.
+- This package assumes you provide an already-created and opened
+  `SQLiteDBConnection`.
+- Calling `close()` on this driver's database adapter closes the underlying
+  `SQLiteDBConnection`, so treat driver ownership as connection ownership.
+- This package targets native Capacitor runtimes. Use the dedicated browser and
+  Electron persistence packages instead of the plugin's web or Electron modes.
+- The plugin's database version and upgrade APIs are separate from TanStack DB
+  `schemaVersion`.
+- `@capacitor-community/sqlite` uses SQLCipher-backed native builds, so app
+  setup may require additional platform configuration outside this package.
+- Capacitor 8 creates iOS projects with Swift Package Manager by default, but
+  `@capacitor-community/sqlite` currently links through CocoaPods on iOS. Add
+  iOS with `npx cap add ios --packagemanager CocoaPods`, or recreate an SPM
+  project in CocoaPods mode before expecting the native plugin to load.
+
+## Testing
+
+- `pnpm --filter @tanstack/capacitor-db-sqlite-persistence test:e2e`
+  runs the package e2e suite against the default `better-sqlite3` harness.
+- `pnpm --filter @tanstack/capacitor-db-sqlite-persistence test:e2e:ios`
+  builds the package-local Capacitor harness in `e2e/app`, launches the iOS
+  simulator, and runs the full persisted collection e2e suite inside the real
+  native Capacitor runtime.
+- `pnpm --filter @tanstack/capacitor-db-sqlite-persistence test:e2e:android`
+  builds the same package-local Capacitor harness in `e2e/app`, launches an
+  Android emulator or uses a connected debug target, and runs the full
+  persisted collection e2e suite inside the real native Capacitor runtime.
+- `test:e2e:ios` is a repo-local validation path for this package. It depends on
+  the checked-in `e2e/app` harness plus local Capacitor/Xcode tooling.
+- `test:e2e:android` depends on a local Android SDK. The runner auto-detects the
+  default macOS SDK location, boots the first available AVD when needed, and
+  reads the app-owned SQLite result database out of the debug sandbox with
+  `adb run-as`.
+- The native harness lives under `e2e/app` so the same app can be extended to
+  other native targets later, including Android.

package/dist/cjs/capacitor-persistence.cjs

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const dbSqlitePersistenceCore = require("@tanstack/db-sqlite-persistence-core");
+const capacitorSqliteDriver = require("./capacitor-sqlite-driver.cjs");
+function normalizeSchemaMismatchPolicy(policy) {
+  if (policy === `throw`) {
+    return `sync-absent-error`;
+  }
+  return policy;
+}
+function resolveSchemaMismatchPolicy(explicitPolicy, mode) {
+  if (explicitPolicy) {
+    return normalizeSchemaMismatchPolicy(explicitPolicy);
+  }
+  return mode === `sync-present` ? `sync-present-reset` : `sync-absent-error`;
+}
+function createAdapterCacheKey(schemaMismatchPolicy, schemaVersion) {
+  const schemaVersionKey = schemaVersion === void 0 ? `schema:default` : `schema:${schemaVersion}`;
+  return `${schemaMismatchPolicy}|${schemaVersionKey}`;
+}
+function createInternalSQLiteDriver(options) {
+  return new capacitorSqliteDriver.CapacitorSQLiteDriver({
+    database: options.database
+  });
+}
+function resolveAdapterBaseOptions(options) {
+  return {
+    appliedTxPruneMaxRows: options.appliedTxPruneMaxRows,
+    appliedTxPruneMaxAgeSeconds: options.appliedTxPruneMaxAgeSeconds,
+    pullSinceReloadThreshold: options.pullSinceReloadThreshold
+  };
+}
+function createCapacitorSQLitePersistence(options) {
+  const { coordinator, schemaMismatchPolicy } = options;
+  const driver = createInternalSQLiteDriver(options);
+  const adapterBaseOptions = resolveAdapterBaseOptions(options);
+  const resolvedCoordinator = coordinator ?? new dbSqlitePersistenceCore.SingleProcessCoordinator();
+  const adapterCache = /* @__PURE__ */ new Map();
+  const getAdapterForCollection = (mode, schemaVersion) => {
+    const resolvedSchemaMismatchPolicy = resolveSchemaMismatchPolicy(
+      schemaMismatchPolicy,
+      mode
+    );
+    const cacheKey = createAdapterCacheKey(
+      resolvedSchemaMismatchPolicy,
+      schemaVersion
+    );
+    const cachedAdapter = adapterCache.get(cacheKey);
+    if (cachedAdapter) {
+      return cachedAdapter;
+    }
+    const adapter = dbSqlitePersistenceCore.createSQLiteCorePersistenceAdapter({
+      ...adapterBaseOptions,
+      driver,
+      schemaMismatchPolicy: resolvedSchemaMismatchPolicy,
+      ...schemaVersion === void 0 ? {} : { schemaVersion }
+    });
+    adapterCache.set(cacheKey, adapter);
+    return adapter;
+  };
+  const createCollectionPersistence = (mode, schemaVersion) => ({
+    adapter: getAdapterForCollection(
+      mode,
+      schemaVersion
+    ),
+    coordinator: resolvedCoordinator
+  });
+  const defaultPersistence = createCollectionPersistence(
+    `sync-absent`,
+    void 0
+  );
+  return {
+    ...defaultPersistence,
+    resolvePersistenceForCollection: ({ mode, schemaVersion }) => createCollectionPersistence(mode, schemaVersion),
+    resolvePersistenceForMode: (mode) => createCollectionPersistence(mode, void 0)
+  };
+}
+exports.createCapacitorSQLitePersistence = createCapacitorSQLitePersistence;
+//# sourceMappingURL=capacitor-persistence.cjs.map

package/dist/cjs/capacitor-persistence.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacitor-persistence.cjs","sources":["../../src/capacitor-persistence.ts"],"sourcesContent":["import {\n  SingleProcessCoordinator,\n  createSQLiteCorePersistenceAdapter,\n} from '@tanstack/db-sqlite-persistence-core'\nimport { CapacitorSQLiteDriver } from './capacitor-sqlite-driver'\nimport type { SQLiteDBConnection } from '@capacitor-community/sqlite'\nimport type {\n  PersistedCollectionCoordinator,\n  PersistedCollectionMode,\n  PersistedCollectionPersistence,\n  SQLiteCoreAdapterOptions,\n  SQLiteDriver,\n} from '@tanstack/db-sqlite-persistence-core'\n\nexport type { CapacitorSQLiteDatabaseLike } from './capacitor-sqlite-driver'\nexport type { SQLiteDBConnection } from '@capacitor-community/sqlite'\n\ntype CapacitorSQLiteCoreSchemaMismatchPolicy =\n  | `sync-present-reset`\n  | `sync-absent-error`\n  | `reset`\n\nexport type CapacitorSQLiteSchemaMismatchPolicy =\n  | CapacitorSQLiteCoreSchemaMismatchPolicy\n  | `throw`\n\ntype CapacitorSQLitePersistenceBaseOptions = Omit<\n  SQLiteCoreAdapterOptions,\n  `driver` | `schemaVersion` | `schemaMismatchPolicy`\n> & {\n  database: SQLiteDBConnection\n  coordinator?: PersistedCollectionCoordinator\n  schemaMismatchPolicy?: CapacitorSQLiteSchemaMismatchPolicy\n}\n\nexport type CapacitorSQLitePersistenceOptions =\n  CapacitorSQLitePersistenceBaseOptions\n\nfunction normalizeSchemaMismatchPolicy(\n  policy: CapacitorSQLiteSchemaMismatchPolicy,\n): CapacitorSQLiteCoreSchemaMismatchPolicy {\n  if (policy === `throw`) {\n    return `sync-absent-error`\n  }\n\n  return policy\n}\n\nfunction resolveSchemaMismatchPolicy(\n  explicitPolicy: CapacitorSQLiteSchemaMismatchPolicy | undefined,\n  mode: PersistedCollectionMode,\n): CapacitorSQLiteCoreSchemaMismatchPolicy {\n  if (explicitPolicy) {\n    return normalizeSchemaMismatchPolicy(explicitPolicy)\n  }\n\n  return mode === `sync-present` ? `sync-present-reset` : `sync-absent-error`\n}\n\nfunction createAdapterCacheKey(\n  schemaMismatchPolicy: CapacitorSQLiteCoreSchemaMismatchPolicy,\n  schemaVersion: number | undefined,\n): string {\n  const schemaVersionKey =\n    schemaVersion === undefined ? `schema:default` : `schema:${schemaVersion}`\n  return `${schemaMismatchPolicy}|${schemaVersionKey}`\n}\n\nfunction createInternalSQLiteDriver(\n  options: CapacitorSQLitePersistenceOptions,\n): SQLiteDriver {\n  return new CapacitorSQLiteDriver({\n    database: options.database,\n  })\n}\n\nfunction resolveAdapterBaseOptions(\n  options: CapacitorSQLitePersistenceOptions,\n): Omit<\n  SQLiteCoreAdapterOptions,\n  `driver` | `schemaVersion` | `schemaMismatchPolicy`\n> {\n  return {\n    appliedTxPruneMaxRows: options.appliedTxPruneMaxRows,\n    appliedTxPruneMaxAgeSeconds: options.appliedTxPruneMaxAgeSeconds,\n    pullSinceReloadThreshold: options.pullSinceReloadThreshold,\n  }\n}\n\nexport function createCapacitorSQLitePersistence<\n  T extends object,\n  TKey extends string | number = string | number,\n>(\n  options: CapacitorSQLitePersistenceOptions,\n): PersistedCollectionPersistence<T, TKey> {\n  const { coordinator, schemaMismatchPolicy } = options\n  const driver = createInternalSQLiteDriver(options)\n  const adapterBaseOptions = resolveAdapterBaseOptions(options)\n  const resolvedCoordinator = coordinator ?? new SingleProcessCoordinator()\n  const adapterCache = new Map<\n    string,\n    ReturnType<\n      typeof createSQLiteCorePersistenceAdapter<\n        Record<string, unknown>,\n        string | number\n      >\n    >\n  >()\n\n  const getAdapterForCollection = (\n    mode: PersistedCollectionMode,\n    schemaVersion: number | undefined,\n  ) => {\n    const resolvedSchemaMismatchPolicy = resolveSchemaMismatchPolicy(\n      schemaMismatchPolicy,\n      mode,\n    )\n    const cacheKey = createAdapterCacheKey(\n      resolvedSchemaMismatchPolicy,\n      schemaVersion,\n    )\n    const cachedAdapter = adapterCache.get(cacheKey)\n    if (cachedAdapter) {\n      return cachedAdapter\n    }\n\n    const adapter = createSQLiteCorePersistenceAdapter<\n      Record<string, unknown>,\n      string | number\n    >({\n      ...adapterBaseOptions,\n      driver,\n      schemaMismatchPolicy: resolvedSchemaMismatchPolicy,\n      ...(schemaVersion === undefined ? {} : { schemaVersion }),\n    })\n    adapterCache.set(cacheKey, adapter)\n    return adapter\n  }\n\n  const createCollectionPersistence = (\n    mode: PersistedCollectionMode,\n    schemaVersion: number | undefined,\n  ): PersistedCollectionPersistence<T, TKey> => ({\n    adapter: getAdapterForCollection(\n      mode,\n      schemaVersion,\n    ) as unknown as PersistedCollectionPersistence<T, TKey>[`adapter`],\n    coordinator: resolvedCoordinator,\n  })\n\n  const defaultPersistence = createCollectionPersistence(\n    `sync-absent`,\n    undefined,\n  )\n\n  return {\n    ...defaultPersistence,\n    resolvePersistenceForCollection: ({ mode, schemaVersion }) =>\n      createCollectionPersistence(mode, schemaVersion),\n    resolvePersistenceForMode: (mode) =>\n      createCollectionPersistence(mode, undefined),\n  }\n}\n"],"names":["CapacitorSQLiteDriver","SingleProcessCoordinator","createSQLiteCorePersistenceAdapter"],"mappings":";;;;AAsCA,SAAS,8BACP,QACyC;AACzC,MAAI,WAAW,SAAS;AACtB,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEA,SAAS,4BACP,gBACA,MACyC;AACzC,MAAI,gBAAgB;AAClB,WAAO,8BAA8B,cAAc;AAAA,EACrD;AAEA,SAAO,SAAS,iBAAiB,uBAAuB;AAC1D;AAEA,SAAS,sBACP,sBACA,eACQ;AACR,QAAM,mBACJ,kBAAkB,SAAY,mBAAmB,UAAU,aAAa;AAC1E,SAAO,GAAG,oBAAoB,IAAI,gBAAgB;AACpD;AAEA,SAAS,2BACP,SACc;AACd,SAAO,IAAIA,sBAAAA,sBAAsB;AAAA,IAC/B,UAAU,QAAQ;AAAA,EAAA,CACnB;AACH;AAEA,SAAS,0BACP,SAIA;AACA,SAAO;AAAA,IACL,uBAAuB,QAAQ;AAAA,IAC/B,6BAA6B,QAAQ;AAAA,IACrC,0BAA0B,QAAQ;AAAA,EAAA;AAEtC;AAEO,SAAS,iCAId,SACyC;AACzC,QAAM,EAAE,aAAa,qBAAA,IAAyB;AAC9C,QAAM,SAAS,2BAA2B,OAAO;AACjD,QAAM,qBAAqB,0BAA0B,OAAO;AAC5D,QAAM,sBAAsB,eAAe,IAAIC,iDAAA;AAC/C,QAAM,mCAAmB,IAAA;AAUzB,QAAM,0BAA0B,CAC9B,MACA,kBACG;AACH,UAAM,+BAA+B;AAAA,MACnC;AAAA,MACA;AAAA,IAAA;AAEF,UAAM,WAAW;AAAA,MACf;AAAA,MACA;AAAA,IAAA;AAEF,UAAM,gBAAgB,aAAa,IAAI,QAAQ;AAC/C,QAAI,eAAe;AACjB,aAAO;AAAA,IACT;AAEA,UAAM,UAAUC,wBAAAA,mCAGd;AAAA,MACA,GAAG;AAAA,MACH;AAAA,MACA,sBAAsB;AAAA,MACtB,GAAI,kBAAkB,SAAY,CAAA,IAAK,EAAE,cAAA;AAAA,IAAc,CACxD;AACD,iBAAa,IAAI,UAAU,OAAO;AAClC,WAAO;AAAA,EACT;AAEA,QAAM,8BAA8B,CAClC,MACA,mBAC6C;AAAA,IAC7C,SAAS;AAAA,MACP;AAAA,MACA;AAAA,IAAA;AAAA,IAEF,aAAa;AAAA,EAAA;AAGf,QAAM,qBAAqB;AAAA,IACzB;AAAA,IACA;AAAA,EAAA;AAGF,SAAO;AAAA,IACL,GAAG;AAAA,IACH,iCAAiC,CAAC,EAAE,MAAM,oBACxC,4BAA4B,MAAM,aAAa;AAAA,IACjD,2BAA2B,CAAC,SAC1B,4BAA4B,MAAM,MAAS;AAAA,EAAA;AAEjD;;"}

package/dist/cjs/capacitor-persistence.d.cts

@@ -0,0 +1,13 @@
+import { SQLiteDBConnection } from '@capacitor-community/sqlite';
+import { PersistedCollectionCoordinator, PersistedCollectionPersistence, SQLiteCoreAdapterOptions } from '@tanstack/db-sqlite-persistence-core';
+export type { CapacitorSQLiteDatabaseLike } from './capacitor-sqlite-driver.cjs';
+export type { SQLiteDBConnection } from '@capacitor-community/sqlite';
+type CapacitorSQLiteCoreSchemaMismatchPolicy = `sync-present-reset` | `sync-absent-error` | `reset`;
+export type CapacitorSQLiteSchemaMismatchPolicy = CapacitorSQLiteCoreSchemaMismatchPolicy | `throw`;
+type CapacitorSQLitePersistenceBaseOptions = Omit<SQLiteCoreAdapterOptions, `driver` | `schemaVersion` | `schemaMismatchPolicy`> & {
+    database: SQLiteDBConnection;
+    coordinator?: PersistedCollectionCoordinator;
+    schemaMismatchPolicy?: CapacitorSQLiteSchemaMismatchPolicy;
+};
+export type CapacitorSQLitePersistenceOptions = CapacitorSQLitePersistenceBaseOptions;
+export declare function createCapacitorSQLitePersistence<T extends object, TKey extends string | number = string | number>(options: CapacitorSQLitePersistenceOptions): PersistedCollectionPersistence<T, TKey>;

package/dist/cjs/capacitor-sqlite-driver.cjs

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const dbSqlitePersistenceCore = require("@tanstack/db-sqlite-persistence-core");
+let asyncLocalStorageCtorPromise = null;
+function canAttemptNodeAsyncLocalStorageLoad() {
+  if (typeof process === `undefined`) {
+    return false;
+  }
+  return typeof process.versions?.node === `string`;
+}
+function getNodeAsyncHooksSpecifier() {
+  const moduleName = `async_hooks`;
+  return `node:${moduleName}`;
+}
+async function resolveAsyncLocalStorageCtor() {
+  if (asyncLocalStorageCtorPromise) {
+    return asyncLocalStorageCtorPromise;
+  }
+  asyncLocalStorageCtorPromise = (async () => {
+    if (!canAttemptNodeAsyncLocalStorageLoad()) {
+      return null;
+    }
+    try {
+      const asyncHooksModule = await import(getNodeAsyncHooksSpecifier());
+      return typeof asyncHooksModule.AsyncLocalStorage === `function` ? asyncHooksModule.AsyncLocalStorage : null;
+    } catch {
+      return null;
+    }
+  })();
+  return asyncLocalStorageCtorPromise;
+}
+function assertTransactionCallbackHasDriverArg(fn) {
+  if (fn.length > 0) {
+    return;
+  }
+  throw new dbSqlitePersistenceCore.InvalidPersistedCollectionConfigError(
+    `SQLiteDriver.transaction callback must accept the transaction driver argument`
+  );
+}
+function isCapacitorSQLiteDatabaseLike(value) {
+  const candidate = value;
+  return typeof value === `object` && value !== null && typeof candidate.execute === `function` && typeof candidate.query === `function` && typeof candidate.run === `function`;
+}
+function extractQueryRows(result, sql) {
+  if (Array.isArray(result.values)) {
+    return result.values;
+  }
+  throw new dbSqlitePersistenceCore.InvalidPersistedCollectionConfigError(
+    `Unsupported Capacitor SQLite query result shape for SQL "${sql}"`
+  );
+}
+class CapacitorSQLiteDriver {
+  constructor(options) {
+    this.queue = Promise.resolve();
+    this.nextSavepointId = 1;
+    this.transactionContextStoragePromise = null;
+    if (!isCapacitorSQLiteDatabaseLike(options.database)) {
+      throw new dbSqlitePersistenceCore.InvalidPersistedCollectionConfigError(
+        `Capacitor SQLite database object must provide execute/query/run methods`
+      );
+    }
+    this.database = options.database;
+  }
+  async exec(sql) {
+    const activeTransactionDriver = await this.getActiveTransactionDriver();
+    if (activeTransactionDriver) {
+      await activeTransactionDriver.exec(sql);
+      return;
+    }
+    await this.enqueue(async () => {
+      await this.database.execute(sql, false);
+    });
+  }
+  async query(sql, params = []) {
+    const activeTransactionDriver = await this.getActiveTransactionDriver();
+    if (activeTransactionDriver) {
+      return activeTransactionDriver.query(sql, params);
+    }
+    return this.enqueue(async () => {
+      const result = await this.database.query(sql, [...params]);
+      return extractQueryRows(result, sql);
+    });
+  }
+  async run(sql, params = []) {
+    const activeTransactionDriver = await this.getActiveTransactionDriver();
+    if (activeTransactionDriver) {
+      await activeTransactionDriver.run(sql, params);
+      return;
+    }
+    await this.enqueue(async () => {
+      await this.database.run(sql, [...params], false);
+    });
+  }
+  async transaction(fn) {
+    assertTransactionCallbackHasDriverArg(fn);
+    const activeTransactionDriver = await this.getActiveTransactionDriver();
+    if (activeTransactionDriver) {
+      return activeTransactionDriver.transaction(fn);
+    }
+    return this.transactionWithDriver(
+      (transactionDriver) => fn(transactionDriver)
+    );
+  }
+  async transactionWithDriver(fn) {
+    const activeTransactionDriver = await this.getActiveTransactionDriver();
+    if (activeTransactionDriver && typeof activeTransactionDriver.transactionWithDriver === `function`) {
+      return activeTransactionDriver.transactionWithDriver(fn);
+    }
+    return this.enqueue(async () => {
+      await this.beginTopLevelTransaction();
+      const transactionDriver = this.createTransactionDriver();
+      try {
+        const result = await this.runWithTransactionContext(
+          transactionDriver,
+          async () => fn(transactionDriver)
+        );
+        await this.commitTopLevelTransaction();
+        return result;
+      } catch (error) {
+        try {
+          await this.rollbackTopLevelTransaction();
+        } catch {
+        }
+        throw error;
+      }
+    });
+  }
+  async close() {
+    await this.database.close();
+  }
+  getDatabase() {
+    return this.database;
+  }
+  enqueue(operation) {
+    const queuedOperation = this.queue.then(operation, operation);
+    this.queue = queuedOperation.then(
+      () => void 0,
+      () => void 0
+    );
+    return queuedOperation;
+  }
+  async getTransactionContextStorage() {
+    if (this.transactionContextStoragePromise) {
+      return this.transactionContextStoragePromise;
+    }
+    this.transactionContextStoragePromise = (async () => {
+      const asyncLocalStorageCtor = await resolveAsyncLocalStorageCtor();
+      if (!asyncLocalStorageCtor) {
+        return null;
+      }
+      return new asyncLocalStorageCtor();
+    })();
+    return this.transactionContextStoragePromise;
+  }
+  async getActiveTransactionDriver() {
+    const transactionContextStorage = await this.getTransactionContextStorage();
+    const store = transactionContextStorage?.getStore();
+    return store?.transactionDriver ?? null;
+  }
+  async runWithTransactionContext(transactionDriver, callback) {
+    const transactionContextStorage = await this.getTransactionContextStorage();
+    if (!transactionContextStorage) {
+      return callback();
+    }
+    return transactionContextStorage.run({ transactionDriver }, callback);
+  }
+  async beginTopLevelTransaction() {
+    await this.database.execute(`BEGIN IMMEDIATE`, false);
+  }
+  async commitTopLevelTransaction() {
+    await this.database.execute(`COMMIT`, false);
+  }
+  async rollbackTopLevelTransaction() {
+    await this.database.execute(`ROLLBACK`, false);
+  }
+  createTransactionDriver() {
+    const transactionDriver = {
+      exec: async (sql) => {
+        await this.database.execute(sql, false);
+      },
+      query: async (sql, params = []) => {
+        const result = await this.database.query(sql, [...params]);
+        return extractQueryRows(result, sql);
+      },
+      run: async (sql, params = []) => {
+        await this.database.run(sql, [...params], false);
+      },
+      transaction: async (fn) => {
+        assertTransactionCallbackHasDriverArg(fn);
+        return this.runNestedTransaction(transactionDriver, async (driver) => {
+          return fn(driver);
+        });
+      },
+      transactionWithDriver: async (fn) => this.runNestedTransaction(transactionDriver, fn)
+    };
+    return transactionDriver;
+  }
+  async runNestedTransaction(transactionDriver, fn) {
+    const savepointName = `tsdb_sp_${this.nextSavepointId}`;
+    this.nextSavepointId++;
+    await this.database.execute(`SAVEPOINT ${savepointName}`, false);
+    try {
+      const result = await this.runWithTransactionContext(
+        transactionDriver,
+        async () => fn(transactionDriver)
+      );
+      await this.database.execute(`RELEASE SAVEPOINT ${savepointName}`, false);
+      return result;
+    } catch (error) {
+      await this.database.execute(
+        `ROLLBACK TO SAVEPOINT ${savepointName}`,
+        false
+      );
+      await this.database.execute(`RELEASE SAVEPOINT ${savepointName}`, false);
+      throw error;
+    }
+  }
+}
+exports.CapacitorSQLiteDriver = CapacitorSQLiteDriver;
+//# sourceMappingURL=capacitor-sqlite-driver.cjs.map

package/dist/cjs/capacitor-sqlite-driver.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacitor-sqlite-driver.cjs","sources":["../../src/capacitor-sqlite-driver.ts"],"sourcesContent":["import { InvalidPersistedCollectionConfigError } from '@tanstack/db-sqlite-persistence-core'\nimport type { SQLiteDriver } from '@tanstack/db-sqlite-persistence-core'\nimport type {\n  capSQLiteValues as CapacitorSQLiteValues,\n  SQLiteDBConnection,\n} from '@capacitor-community/sqlite'\n\nexport type CapacitorSQLiteDatabaseLike = SQLiteDBConnection\n\ntype TransactionContextStore = {\n  transactionDriver: SQLiteDriver\n}\n\ntype AsyncLocalStorageLike<TStore> = {\n  getStore: () => TStore | undefined\n  run: <TResult>(store: TStore, callback: () => TResult) => TResult\n}\n\ntype AsyncLocalStorageCtor = new <TStore>() => AsyncLocalStorageLike<TStore>\n\nlet asyncLocalStorageCtorPromise: Promise<AsyncLocalStorageCtor | null> | null =\n  null\n\nfunction canAttemptNodeAsyncLocalStorageLoad(): boolean {\n  if (typeof process === `undefined`) {\n    return false\n  }\n\n  // In Capacitor webviews, process may be polyfilled without versions.\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  return typeof process.versions?.node === `string`\n}\n\nfunction getNodeAsyncHooksSpecifier(): string {\n  const moduleName = `async_hooks`\n  return `node:${moduleName}`\n}\n\nasync function resolveAsyncLocalStorageCtor(): Promise<AsyncLocalStorageCtor | null> {\n  if (asyncLocalStorageCtorPromise) {\n    return asyncLocalStorageCtorPromise\n  }\n\n  asyncLocalStorageCtorPromise = (async () => {\n    if (!canAttemptNodeAsyncLocalStorageLoad()) {\n      return null\n    }\n\n    try {\n      const asyncHooksModule = (await import(getNodeAsyncHooksSpecifier())) as {\n        AsyncLocalStorage?: AsyncLocalStorageCtor\n      }\n\n      return typeof asyncHooksModule.AsyncLocalStorage === `function`\n        ? asyncHooksModule.AsyncLocalStorage\n        : null\n    } catch {\n      return null\n    }\n  })()\n\n  return asyncLocalStorageCtorPromise\n}\n\nfunction assertTransactionCallbackHasDriverArg(\n  fn: (transactionDriver: SQLiteDriver) => Promise<unknown>,\n): void {\n  if (fn.length > 0) {\n    return\n  }\n\n  throw new InvalidPersistedCollectionConfigError(\n    `SQLiteDriver.transaction callback must accept the transaction driver argument`,\n  )\n}\n\nfunction isCapacitorSQLiteDatabaseLike(\n  value: unknown,\n): value is CapacitorSQLiteDatabaseLike {\n  const candidate = value as Partial<CapacitorSQLiteDatabaseLike>\n  return (\n    typeof value === `object` &&\n    value !== null &&\n    typeof candidate.execute === `function` &&\n    typeof candidate.query === `function` &&\n    typeof candidate.run === `function`\n  )\n}\n\nfunction extractQueryRows<T>(\n  result: CapacitorSQLiteValues,\n  sql: string,\n): ReadonlyArray<T> {\n  if (Array.isArray(result.values)) {\n    return result.values as ReadonlyArray<T>\n  }\n\n  throw new InvalidPersistedCollectionConfigError(\n    `Unsupported Capacitor SQLite query result shape for SQL \"${sql}\"`,\n  )\n}\n\nexport type CapacitorSQLiteDriverOptions = {\n  database: CapacitorSQLiteDatabaseLike\n}\n\nexport class CapacitorSQLiteDriver implements SQLiteDriver {\n  private readonly database: CapacitorSQLiteDatabaseLike\n  private queue: Promise<void> = Promise.resolve()\n  private nextSavepointId = 1\n  private transactionContextStoragePromise: Promise<AsyncLocalStorageLike<TransactionContextStore> | null> | null =\n    null\n\n  constructor(options: CapacitorSQLiteDriverOptions) {\n    if (!isCapacitorSQLiteDatabaseLike(options.database)) {\n      throw new InvalidPersistedCollectionConfigError(\n        `Capacitor SQLite database object must provide execute/query/run methods`,\n      )\n    }\n\n    this.database = options.database\n  }\n\n  async exec(sql: string): Promise<void> {\n    const activeTransactionDriver = await this.getActiveTransactionDriver()\n    if (activeTransactionDriver) {\n      await activeTransactionDriver.exec(sql)\n      return\n    }\n\n    await this.enqueue(async () => {\n      await this.database.execute(sql, false)\n    })\n  }\n\n  async query<T>(\n    sql: string,\n    params: ReadonlyArray<unknown> = [],\n  ): Promise<ReadonlyArray<T>> {\n    const activeTransactionDriver = await this.getActiveTransactionDriver()\n    if (activeTransactionDriver) {\n      return activeTransactionDriver.query<T>(sql, params)\n    }\n\n    return this.enqueue(async () => {\n      const result = await this.database.query(sql, [...params])\n      return extractQueryRows<T>(result, sql)\n    })\n  }\n\n  async run(sql: string, params: ReadonlyArray<unknown> = []): Promise<void> {\n    const activeTransactionDriver = await this.getActiveTransactionDriver()\n    if (activeTransactionDriver) {\n      await activeTransactionDriver.run(sql, params)\n      return\n    }\n\n    await this.enqueue(async () => {\n      await this.database.run(sql, [...params], false)\n    })\n  }\n\n  async transaction<T>(\n    fn: (transactionDriver: SQLiteDriver) => Promise<T>,\n  ): Promise<T> {\n    assertTransactionCallbackHasDriverArg(fn)\n\n    const activeTransactionDriver = await this.getActiveTransactionDriver()\n    if (activeTransactionDriver) {\n      return activeTransactionDriver.transaction(fn)\n    }\n\n    return this.transactionWithDriver((transactionDriver) =>\n      fn(transactionDriver),\n    )\n  }\n\n  async transactionWithDriver<T>(\n    fn: (transactionDriver: SQLiteDriver) => Promise<T>,\n  ): Promise<T> {\n    const activeTransactionDriver = await this.getActiveTransactionDriver()\n    if (\n      activeTransactionDriver &&\n      typeof activeTransactionDriver.transactionWithDriver === `function`\n    ) {\n      return activeTransactionDriver.transactionWithDriver(fn)\n    }\n\n    return this.enqueue(async () => {\n      await this.beginTopLevelTransaction()\n      const transactionDriver = this.createTransactionDriver()\n      try {\n        const result = await this.runWithTransactionContext(\n          transactionDriver,\n          async () => fn(transactionDriver),\n        )\n        await this.commitTopLevelTransaction()\n        return result\n      } catch (error) {\n        try {\n          await this.rollbackTopLevelTransaction()\n        } catch {\n          // Preserve the original transaction failure as the primary error.\n        }\n        throw error\n      }\n    })\n  }\n\n  async close(): Promise<void> {\n    await this.database.close()\n  }\n\n  getDatabase(): CapacitorSQLiteDatabaseLike {\n    return this.database\n  }\n\n  private enqueue<T>(operation: () => Promise<T>): Promise<T> {\n    const queuedOperation = this.queue.then(operation, operation)\n    this.queue = queuedOperation.then(\n      () => undefined,\n      () => undefined,\n    )\n    return queuedOperation\n  }\n\n  private async getTransactionContextStorage(): Promise<AsyncLocalStorageLike<TransactionContextStore> | null> {\n    if (this.transactionContextStoragePromise) {\n      return this.transactionContextStoragePromise\n    }\n\n    this.transactionContextStoragePromise = (async () => {\n      const asyncLocalStorageCtor = await resolveAsyncLocalStorageCtor()\n      if (!asyncLocalStorageCtor) {\n        return null\n      }\n\n      return new asyncLocalStorageCtor<TransactionContextStore>()\n    })()\n\n    return this.transactionContextStoragePromise\n  }\n\n  private async getActiveTransactionDriver(): Promise<SQLiteDriver | null> {\n    const transactionContextStorage = await this.getTransactionContextStorage()\n    const store = transactionContextStorage?.getStore()\n    return store?.transactionDriver ?? null\n  }\n\n  private async runWithTransactionContext<TResult>(\n    transactionDriver: SQLiteDriver,\n    callback: () => Promise<TResult>,\n  ): Promise<TResult> {\n    const transactionContextStorage = await this.getTransactionContextStorage()\n    if (!transactionContextStorage) {\n      return callback()\n    }\n\n    return transactionContextStorage.run({ transactionDriver }, callback)\n  }\n\n  private async beginTopLevelTransaction(): Promise<void> {\n    await this.database.execute(`BEGIN IMMEDIATE`, false)\n  }\n\n  private async commitTopLevelTransaction(): Promise<void> {\n    await this.database.execute(`COMMIT`, false)\n  }\n\n  private async rollbackTopLevelTransaction(): Promise<void> {\n    await this.database.execute(`ROLLBACK`, false)\n  }\n\n  private createTransactionDriver(): SQLiteDriver {\n    const transactionDriver: SQLiteDriver = {\n      exec: async (sql) => {\n        await this.database.execute(sql, false)\n      },\n      query: async <T>(\n        sql: string,\n        params: ReadonlyArray<unknown> = [],\n      ): Promise<ReadonlyArray<T>> => {\n        const result = await this.database.query(sql, [...params])\n        return extractQueryRows<T>(result, sql)\n      },\n      run: async (sql, params = []) => {\n        await this.database.run(sql, [...params], false)\n      },\n      transaction: async <T>(\n        fn: (transactionDriver: SQLiteDriver) => Promise<T>,\n      ): Promise<T> => {\n        assertTransactionCallbackHasDriverArg(fn)\n        return this.runNestedTransaction(transactionDriver, async (driver) => {\n          return fn(driver)\n        })\n      },\n      transactionWithDriver: async <T>(\n        fn: (transactionDriver: SQLiteDriver) => Promise<T>,\n      ): Promise<T> => this.runNestedTransaction(transactionDriver, fn),\n    }\n\n    return transactionDriver\n  }\n\n  private async runNestedTransaction<T>(\n    transactionDriver: SQLiteDriver,\n    fn: (transactionDriver: SQLiteDriver) => Promise<T>,\n  ): Promise<T> {\n    const savepointName = `tsdb_sp_${this.nextSavepointId}`\n    this.nextSavepointId++\n    await this.database.execute(`SAVEPOINT ${savepointName}`, false)\n\n    try {\n      const result = await this.runWithTransactionContext(\n        transactionDriver,\n        async () => fn(transactionDriver),\n      )\n      await this.database.execute(`RELEASE SAVEPOINT ${savepointName}`, false)\n      return result\n    } catch (error) {\n      await this.database.execute(\n        `ROLLBACK TO SAVEPOINT ${savepointName}`,\n        false,\n      )\n      await this.database.execute(`RELEASE SAVEPOINT ${savepointName}`, false)\n      throw error\n    }\n  }\n}\n\nexport function createCapacitorSQLiteDriver(\n  options: CapacitorSQLiteDriverOptions,\n): CapacitorSQLiteDriver {\n  return new CapacitorSQLiteDriver(options)\n}\n"],"names":["InvalidPersistedCollectionConfigError"],"mappings":"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"}

package/dist/cjs/capacitor-sqlite-driver.d.cts

@@ -0,0 +1,30 @@
+import { SQLiteDriver } from '@tanstack/db-sqlite-persistence-core';
+import { SQLiteDBConnection } from '@capacitor-community/sqlite';
+export type CapacitorSQLiteDatabaseLike = SQLiteDBConnection;
+export type CapacitorSQLiteDriverOptions = {
+    database: CapacitorSQLiteDatabaseLike;
+};
+export declare class CapacitorSQLiteDriver implements SQLiteDriver {
+    private readonly database;
+    private queue;
+    private nextSavepointId;
+    private transactionContextStoragePromise;
+    constructor(options: CapacitorSQLiteDriverOptions);
+    exec(sql: string): Promise<void>;
+    query<T>(sql: string, params?: ReadonlyArray<unknown>): Promise<ReadonlyArray<T>>;
+    run(sql: string, params?: ReadonlyArray<unknown>): Promise<void>;
+    transaction<T>(fn: (transactionDriver: SQLiteDriver) => Promise<T>): Promise<T>;
+    transactionWithDriver<T>(fn: (transactionDriver: SQLiteDriver) => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+    getDatabase(): CapacitorSQLiteDatabaseLike;
+    private enqueue;
+    private getTransactionContextStorage;
+    private getActiveTransactionDriver;
+    private runWithTransactionContext;
+    private beginTopLevelTransaction;
+    private commitTopLevelTransaction;
+    private rollbackTopLevelTransaction;
+    private createTransactionDriver;
+    private runNestedTransaction;
+}
+export declare function createCapacitorSQLiteDriver(options: CapacitorSQLiteDriverOptions): CapacitorSQLiteDriver;

package/dist/cjs/capacitor.cjs

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const capacitorPersistence = require("./capacitor-persistence.cjs");
+function createCapacitorSQLitePersistence(options) {
+  return capacitorPersistence.createCapacitorSQLitePersistence(options);
+}
+exports.createCapacitorSQLitePersistence = createCapacitorSQLitePersistence;
+//# sourceMappingURL=capacitor.cjs.map

package/dist/cjs/capacitor.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacitor.cjs","sources":["../../src/capacitor.ts"],"sourcesContent":["import { createCapacitorSQLitePersistence as createPersistence } from './capacitor-persistence'\nimport type {\n  CapacitorSQLitePersistenceOptions as CapacitorSQLitePersistenceOptionsBase,\n  CapacitorSQLiteSchemaMismatchPolicy as CapacitorSQLiteSchemaMismatchPolicyBase,\n} from './capacitor-persistence'\nimport type { PersistedCollectionPersistence } from '@tanstack/db-sqlite-persistence-core'\n\nexport type CapacitorSQLitePersistenceOptions =\n  CapacitorSQLitePersistenceOptionsBase\nexport type CapacitorSQLiteSchemaMismatchPolicy =\n  CapacitorSQLiteSchemaMismatchPolicyBase\nexport type { CapacitorSQLiteDatabaseLike } from './capacitor-persistence'\nexport type { SQLiteDBConnection } from './capacitor-persistence'\n\nexport function createCapacitorSQLitePersistence<\n  T extends object,\n  TKey extends string | number = string | number,\n>(\n  options: CapacitorSQLitePersistenceOptions,\n): PersistedCollectionPersistence<T, TKey> {\n  return createPersistence<T, TKey>(options)\n}\n"],"names":["createPersistence"],"mappings":";;;AAcO,SAAS,iCAId,SACyC;AACzC,SAAOA,qBAAAA,iCAA2B,OAAO;AAC3C;;"}

package/dist/cjs/capacitor.d.cts

@@ -0,0 +1,7 @@
+import { CapacitorSQLitePersistenceOptions as CapacitorSQLitePersistenceOptionsBase, CapacitorSQLiteSchemaMismatchPolicy as CapacitorSQLiteSchemaMismatchPolicyBase } from './capacitor-persistence.cjs';
+import { PersistedCollectionPersistence } from '@tanstack/db-sqlite-persistence-core';
+export type CapacitorSQLitePersistenceOptions = CapacitorSQLitePersistenceOptionsBase;
+export type CapacitorSQLiteSchemaMismatchPolicy = CapacitorSQLiteSchemaMismatchPolicyBase;
+export type { CapacitorSQLiteDatabaseLike } from './capacitor-persistence.cjs';
+export type { SQLiteDBConnection } from './capacitor-persistence.cjs';
+export declare function createCapacitorSQLitePersistence<T extends object, TKey extends string | number = string | number>(options: CapacitorSQLitePersistenceOptions): PersistedCollectionPersistence<T, TKey>;

package/dist/cjs/index.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const capacitor = require("./capacitor.cjs");
+const dbSqlitePersistenceCore = require("@tanstack/db-sqlite-persistence-core");
+exports.createCapacitorSQLitePersistence = capacitor.createCapacitorSQLitePersistence;
+Object.defineProperty(exports, "persistedCollectionOptions", {
+  enumerable: true,
+  get: () => dbSqlitePersistenceCore.persistedCollectionOptions
+});
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}

package/dist/cjs/index.d.cts

@@ -0,0 +1,4 @@
+export { createCapacitorSQLitePersistence } from './capacitor.cjs';
+export type { CapacitorSQLiteDatabaseLike, CapacitorSQLitePersistenceOptions, CapacitorSQLiteSchemaMismatchPolicy, SQLiteDBConnection, } from './capacitor.cjs';
+export { persistedCollectionOptions } from '@tanstack/db-sqlite-persistence-core';
+export type { PersistedCollectionCoordinator, PersistedCollectionPersistence, } from '@tanstack/db-sqlite-persistence-core';

package/dist/esm/capacitor-persistence.d.ts

@@ -0,0 +1,13 @@
+import { SQLiteDBConnection } from '@capacitor-community/sqlite';
+import { PersistedCollectionCoordinator, PersistedCollectionPersistence, SQLiteCoreAdapterOptions } from '@tanstack/db-sqlite-persistence-core';
+export type { CapacitorSQLiteDatabaseLike } from './capacitor-sqlite-driver.js';
+export type { SQLiteDBConnection } from '@capacitor-community/sqlite';
+type CapacitorSQLiteCoreSchemaMismatchPolicy = `sync-present-reset` | `sync-absent-error` | `reset`;
+export type CapacitorSQLiteSchemaMismatchPolicy = CapacitorSQLiteCoreSchemaMismatchPolicy | `throw`;
+type CapacitorSQLitePersistenceBaseOptions = Omit<SQLiteCoreAdapterOptions, `driver` | `schemaVersion` | `schemaMismatchPolicy`> & {
+    database: SQLiteDBConnection;
+    coordinator?: PersistedCollectionCoordinator;
+    schemaMismatchPolicy?: CapacitorSQLiteSchemaMismatchPolicy;
+};
+export type CapacitorSQLitePersistenceOptions = CapacitorSQLitePersistenceBaseOptions;
+export declare function createCapacitorSQLitePersistence<T extends object, TKey extends string | number = string | number>(options: CapacitorSQLitePersistenceOptions): PersistedCollectionPersistence<T, TKey>;

package/dist/esm/capacitor-persistence.js

@@ -0,0 +1,79 @@
+import { SingleProcessCoordinator, createSQLiteCorePersistenceAdapter } from "@tanstack/db-sqlite-persistence-core";
+import { CapacitorSQLiteDriver } from "./capacitor-sqlite-driver.js";
+function normalizeSchemaMismatchPolicy(policy) {
+  if (policy === `throw`) {
+    return `sync-absent-error`;
+  }
+  return policy;
+}
+function resolveSchemaMismatchPolicy(explicitPolicy, mode) {
+  if (explicitPolicy) {
+    return normalizeSchemaMismatchPolicy(explicitPolicy);
+  }
+  return mode === `sync-present` ? `sync-present-reset` : `sync-absent-error`;
+}
+function createAdapterCacheKey(schemaMismatchPolicy, schemaVersion) {
+  const schemaVersionKey = schemaVersion === void 0 ? `schema:default` : `schema:${schemaVersion}`;
+  return `${schemaMismatchPolicy}|${schemaVersionKey}`;
+}
+function createInternalSQLiteDriver(options) {
+  return new CapacitorSQLiteDriver({
+    database: options.database
+  });
+}
+function resolveAdapterBaseOptions(options) {
+  return {
+    appliedTxPruneMaxRows: options.appliedTxPruneMaxRows,
+    appliedTxPruneMaxAgeSeconds: options.appliedTxPruneMaxAgeSeconds,
+    pullSinceReloadThreshold: options.pullSinceReloadThreshold
+  };
+}
+function createCapacitorSQLitePersistence(options) {
+  const { coordinator, schemaMismatchPolicy } = options;
+  const driver = createInternalSQLiteDriver(options);
+  const adapterBaseOptions = resolveAdapterBaseOptions(options);
+  const resolvedCoordinator = coordinator ?? new SingleProcessCoordinator();
+  const adapterCache = /* @__PURE__ */ new Map();
+  const getAdapterForCollection = (mode, schemaVersion) => {
+    const resolvedSchemaMismatchPolicy = resolveSchemaMismatchPolicy(
+      schemaMismatchPolicy,
+      mode
+    );
+    const cacheKey = createAdapterCacheKey(
+      resolvedSchemaMismatchPolicy,
+      schemaVersion
+    );
+    const cachedAdapter = adapterCache.get(cacheKey);
+    if (cachedAdapter) {
+      return cachedAdapter;
+    }
+    const adapter = createSQLiteCorePersistenceAdapter({
+      ...adapterBaseOptions,
+      driver,
+      schemaMismatchPolicy: resolvedSchemaMismatchPolicy,
+      ...schemaVersion === void 0 ? {} : { schemaVersion }
+    });
+    adapterCache.set(cacheKey, adapter);
+    return adapter;
+  };
+  const createCollectionPersistence = (mode, schemaVersion) => ({
+    adapter: getAdapterForCollection(
+      mode,
+      schemaVersion
+    ),
+    coordinator: resolvedCoordinator
+  });
+  const defaultPersistence = createCollectionPersistence(
+    `sync-absent`,
+    void 0
+  );
+  return {
+    ...defaultPersistence,
+    resolvePersistenceForCollection: ({ mode, schemaVersion }) => createCollectionPersistence(mode, schemaVersion),
+    resolvePersistenceForMode: (mode) => createCollectionPersistence(mode, void 0)
+  };
+}
+export {
+  createCapacitorSQLitePersistence
+};
+//# sourceMappingURL=capacitor-persistence.js.map

package/dist/esm/capacitor-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacitor-persistence.js","sources":["../../src/capacitor-persistence.ts"],"sourcesContent":["import {\n  SingleProcessCoordinator,\n  createSQLiteCorePersistenceAdapter,\n} from '@tanstack/db-sqlite-persistence-core'\nimport { CapacitorSQLiteDriver } from './capacitor-sqlite-driver'\nimport type { SQLiteDBConnection } from '@capacitor-community/sqlite'\nimport type {\n  PersistedCollectionCoordinator,\n  PersistedCollectionMode,\n  PersistedCollectionPersistence,\n  SQLiteCoreAdapterOptions,\n  SQLiteDriver,\n} from '@tanstack/db-sqlite-persistence-core'\n\nexport type { CapacitorSQLiteDatabaseLike } from './capacitor-sqlite-driver'\nexport type { SQLiteDBConnection } from '@capacitor-community/sqlite'\n\ntype CapacitorSQLiteCoreSchemaMismatchPolicy =\n  | `sync-present-reset`\n  | `sync-absent-error`\n  | `reset`\n\nexport type CapacitorSQLiteSchemaMismatchPolicy =\n  | CapacitorSQLiteCoreSchemaMismatchPolicy\n  | `throw`\n\ntype CapacitorSQLitePersistenceBaseOptions = Omit<\n  SQLiteCoreAdapterOptions,\n  `driver` | `schemaVersion` | `schemaMismatchPolicy`\n> & {\n  database: SQLiteDBConnection\n  coordinator?: PersistedCollectionCoordinator\n  schemaMismatchPolicy?: CapacitorSQLiteSchemaMismatchPolicy\n}\n\nexport type CapacitorSQLitePersistenceOptions =\n  CapacitorSQLitePersistenceBaseOptions\n\nfunction normalizeSchemaMismatchPolicy(\n  policy: CapacitorSQLiteSchemaMismatchPolicy,\n): CapacitorSQLiteCoreSchemaMismatchPolicy {\n  if (policy === `throw`) {\n    return `sync-absent-error`\n  }\n\n  return policy\n}\n\nfunction resolveSchemaMismatchPolicy(\n  explicitPolicy: CapacitorSQLiteSchemaMismatchPolicy | undefined,\n  mode: PersistedCollectionMode,\n): CapacitorSQLiteCoreSchemaMismatchPolicy {\n  if (explicitPolicy) {\n    return normalizeSchemaMismatchPolicy(explicitPolicy)\n  }\n\n  return mode === `sync-present` ? `sync-present-reset` : `sync-absent-error`\n}\n\nfunction createAdapterCacheKey(\n  schemaMismatchPolicy: CapacitorSQLiteCoreSchemaMismatchPolicy,\n  schemaVersion: number | undefined,\n): string {\n  const schemaVersionKey =\n    schemaVersion === undefined ? `schema:default` : `schema:${schemaVersion}`\n  return `${schemaMismatchPolicy}|${schemaVersionKey}`\n}\n\nfunction createInternalSQLiteDriver(\n  options: CapacitorSQLitePersistenceOptions,\n): SQLiteDriver {\n  return new CapacitorSQLiteDriver({\n    database: options.database,\n  })\n}\n\nfunction resolveAdapterBaseOptions(\n  options: CapacitorSQLitePersistenceOptions,\n): Omit<\n  SQLiteCoreAdapterOptions,\n  `driver` | `schemaVersion` | `schemaMismatchPolicy`\n> {\n  return {\n    appliedTxPruneMaxRows: options.appliedTxPruneMaxRows,\n    appliedTxPruneMaxAgeSeconds: options.appliedTxPruneMaxAgeSeconds,\n    pullSinceReloadThreshold: options.pullSinceReloadThreshold,\n  }\n}\n\nexport function createCapacitorSQLitePersistence<\n  T extends object,\n  TKey extends string | number = string | number,\n>(\n  options: CapacitorSQLitePersistenceOptions,\n): PersistedCollectionPersistence<T, TKey> {\n  const { coordinator, schemaMismatchPolicy } = options\n  const driver = createInternalSQLiteDriver(options)\n  const adapterBaseOptions = resolveAdapterBaseOptions(options)\n  const resolvedCoordinator = coordinator ?? new SingleProcessCoordinator()\n  const adapterCache = new Map<\n    string,\n    ReturnType<\n      typeof createSQLiteCorePersistenceAdapter<\n        Record<string, unknown>,\n        string | number\n      >\n    >\n  >()\n\n  const getAdapterForCollection = (\n    mode: PersistedCollectionMode,\n    schemaVersion: number | undefined,\n  ) => {\n    const resolvedSchemaMismatchPolicy = resolveSchemaMismatchPolicy(\n      schemaMismatchPolicy,\n      mode,\n    )\n    const cacheKey = createAdapterCacheKey(\n      resolvedSchemaMismatchPolicy,\n      schemaVersion,\n    )\n    const cachedAdapter = adapterCache.get(cacheKey)\n    if (cachedAdapter) {\n      return cachedAdapter\n    }\n\n    const adapter = createSQLiteCorePersistenceAdapter<\n      Record<string, unknown>,\n      string | number\n    >({\n      ...adapterBaseOptions,\n      driver,\n      schemaMismatchPolicy: resolvedSchemaMismatchPolicy,\n      ...(schemaVersion === undefined ? {} : { schemaVersion }),\n    })\n    adapterCache.set(cacheKey, adapter)\n    return adapter\n  }\n\n  const createCollectionPersistence = (\n    mode: PersistedCollectionMode,\n    schemaVersion: number | undefined,\n  ): PersistedCollectionPersistence<T, TKey> => ({\n    adapter: getAdapterForCollection(\n      mode,\n      schemaVersion,\n    ) as unknown as PersistedCollectionPersistence<T, TKey>[`adapter`],\n    coordinator: resolvedCoordinator,\n  })\n\n  const defaultPersistence = createCollectionPersistence(\n    `sync-absent`,\n    undefined,\n  )\n\n  return {\n    ...defaultPersistence,\n    resolvePersistenceForCollection: ({ mode, schemaVersion }) =>\n      createCollectionPersistence(mode, schemaVersion),\n    resolvePersistenceForMode: (mode) =>\n      createCollectionPersistence(mode, undefined),\n  }\n}\n"],"names":[],"mappings":";;AAsCA,SAAS,8BACP,QACyC;AACzC,MAAI,WAAW,SAAS;AACtB,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEA,SAAS,4BACP,gBACA,MACyC;AACzC,MAAI,gBAAgB;AAClB,WAAO,8BAA8B,cAAc;AAAA,EACrD;AAEA,SAAO,SAAS,iBAAiB,uBAAuB;AAC1D;AAEA,SAAS,sBACP,sBACA,eACQ;AACR,QAAM,mBACJ,kBAAkB,SAAY,mBAAmB,UAAU,aAAa;AAC1E,SAAO,GAAG,oBAAoB,IAAI,gBAAgB;AACpD;AAEA,SAAS,2BACP,SACc;AACd,SAAO,IAAI,sBAAsB;AAAA,IAC/B,UAAU,QAAQ;AAAA,EAAA,CACnB;AACH;AAEA,SAAS,0BACP,SAIA;AACA,SAAO;AAAA,IACL,uBAAuB,QAAQ;AAAA,IAC/B,6BAA6B,QAAQ;AAAA,IACrC,0BAA0B,QAAQ;AAAA,EAAA;AAEtC;AAEO,SAAS,iCAId,SACyC;AACzC,QAAM,EAAE,aAAa,qBAAA,IAAyB;AAC9C,QAAM,SAAS,2BAA2B,OAAO;AACjD,QAAM,qBAAqB,0BAA0B,OAAO;AAC5D,QAAM,sBAAsB,eAAe,IAAI,yBAAA;AAC/C,QAAM,mCAAmB,IAAA;AAUzB,QAAM,0BAA0B,CAC9B,MACA,kBACG;AACH,UAAM,+BAA+B;AAAA,MACnC;AAAA,MACA;AAAA,IAAA;AAEF,UAAM,WAAW;AAAA,MACf;AAAA,MACA;AAAA,IAAA;AAEF,UAAM,gBAAgB,aAAa,IAAI,QAAQ;AAC/C,QAAI,eAAe;AACjB,aAAO;AAAA,IACT;AAEA,UAAM,UAAU,mCAGd;AAAA,MACA,GAAG;AAAA,MACH;AAAA,MACA,sBAAsB;AAAA,MACtB,GAAI,kBAAkB,SAAY,CAAA,IAAK,EAAE,cAAA;AAAA,IAAc,CACxD;AACD,iBAAa,IAAI,UAAU,OAAO;AAClC,WAAO;AAAA,EACT;AAEA,QAAM,8BAA8B,CAClC,MACA,mBAC6C;AAAA,IAC7C,SAAS;AAAA,MACP;AAAA,MACA;AAAA,IAAA;AAAA,IAEF,aAAa;AAAA,EAAA;AAGf,QAAM,qBAAqB;AAAA,IACzB;AAAA,IACA;AAAA,EAAA;AAGF,SAAO;AAAA,IACL,GAAG;AAAA,IACH,iCAAiC,CAAC,EAAE,MAAM,oBACxC,4BAA4B,MAAM,aAAa;AAAA,IACjD,2BAA2B,CAAC,SAC1B,4BAA4B,MAAM,MAAS;AAAA,EAAA;AAEjD;"}