@tanstack/capacitor-db-sqlite-persistence 0.1.2

package/dist/esm/capacitor-sqlite-driver.d.ts

@@ -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/esm/capacitor-sqlite-driver.js

@@ -0,0 +1,220 @@
+import { InvalidPersistedCollectionConfigError } from "@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 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 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 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;
+    }
+  }
+}
+export {
+  CapacitorSQLiteDriver
+};
+//# sourceMappingURL=capacitor-sqlite-driver.js.map

package/dist/esm/capacitor-sqlite-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacitor-sqlite-driver.js","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":[],"mappings":";AAoBA,IAAI,+BACF;AAEF,SAAS,sCAA+C;AACtD,MAAI,OAAO,YAAY,aAAa;AAClC,WAAO;AAAA,EACT;AAIA,SAAO,OAAO,QAAQ,UAAU,SAAS;AAC3C;AAEA,SAAS,6BAAqC;AAC5C,QAAM,aAAa;AACnB,SAAO,QAAQ,UAAU;AAC3B;AAEA,eAAe,+BAAsE;AACnF,MAAI,8BAA8B;AAChC,WAAO;AAAA,EACT;AAEA,kCAAgC,YAAY;AAC1C,QAAI,CAAC,uCAAuC;AAC1C,aAAO;AAAA,IACT;AAEA,QAAI;AACF,YAAM,mBAAoB,MAAM,OAAO;AAIvC,aAAO,OAAO,iBAAiB,sBAAsB,aACjD,iBAAiB,oBACjB;AAAA,IACN,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF,GAAA;AAEA,SAAO;AACT;AAEA,SAAS,sCACP,IACM;AACN,MAAI,GAAG,SAAS,GAAG;AACjB;AAAA,EACF;AAEA,QAAM,IAAI;AAAA,IACR;AAAA,EAAA;AAEJ;AAEA,SAAS,8BACP,OACsC;AACtC,QAAM,YAAY;AAClB,SACE,OAAO,UAAU,YACjB,UAAU,QACV,OAAO,UAAU,YAAY,cAC7B,OAAO,UAAU,UAAU,cAC3B,OAAO,UAAU,QAAQ;AAE7B;AAEA,SAAS,iBACP,QACA,KACkB;AAClB,MAAI,MAAM,QAAQ,OAAO,MAAM,GAAG;AAChC,WAAO,OAAO;AAAA,EAChB;AAEA,QAAM,IAAI;AAAA,IACR,4DAA4D,GAAG;AAAA,EAAA;AAEnE;AAMO,MAAM,sBAA8C;AAAA,EAOzD,YAAY,SAAuC;AALnD,SAAQ,QAAuB,QAAQ,QAAA;AACvC,SAAQ,kBAAkB;AAC1B,SAAQ,mCACN;AAGA,QAAI,CAAC,8BAA8B,QAAQ,QAAQ,GAAG;AACpD,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AAEA,SAAK,WAAW,QAAQ;AAAA,EAC1B;AAAA,EAEA,MAAM,KAAK,KAA4B;AACrC,UAAM,0BAA0B,MAAM,KAAK,2BAAA;AAC3C,QAAI,yBAAyB;AAC3B,YAAM,wBAAwB,KAAK,GAAG;AACtC;AAAA,IACF;AAEA,UAAM,KAAK,QAAQ,YAAY;AAC7B,YAAM,KAAK,SAAS,QAAQ,KAAK,KAAK;AAAA,IACxC,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,MACJ,KACA,SAAiC,IACN;AAC3B,UAAM,0BAA0B,MAAM,KAAK,2BAAA;AAC3C,QAAI,yBAAyB;AAC3B,aAAO,wBAAwB,MAAS,KAAK,MAAM;AAAA,IACrD;AAEA,WAAO,KAAK,QAAQ,YAAY;AAC9B,YAAM,SAAS,MAAM,KAAK,SAAS,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC;AACzD,aAAO,iBAAoB,QAAQ,GAAG;AAAA,IACxC,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,IAAI,KAAa,SAAiC,IAAmB;AACzE,UAAM,0BAA0B,MAAM,KAAK,2BAAA;AAC3C,QAAI,yBAAyB;AAC3B,YAAM,wBAAwB,IAAI,KAAK,MAAM;AAC7C;AAAA,IACF;AAEA,UAAM,KAAK,QAAQ,YAAY;AAC7B,YAAM,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,MAAM,GAAG,KAAK;AAAA,IACjD,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,YACJ,IACY;AACZ,0CAAsC,EAAE;AAExC,UAAM,0BAA0B,MAAM,KAAK,2BAAA;AAC3C,QAAI,yBAAyB;AAC3B,aAAO,wBAAwB,YAAY,EAAE;AAAA,IAC/C;AAEA,WAAO,KAAK;AAAA,MAAsB,CAAC,sBACjC,GAAG,iBAAiB;AAAA,IAAA;AAAA,EAExB;AAAA,EAEA,MAAM,sBACJ,IACY;AACZ,UAAM,0BAA0B,MAAM,KAAK,2BAAA;AAC3C,QACE,2BACA,OAAO,wBAAwB,0BAA0B,YACzD;AACA,aAAO,wBAAwB,sBAAsB,EAAE;AAAA,IACzD;AAEA,WAAO,KAAK,QAAQ,YAAY;AAC9B,YAAM,KAAK,yBAAA;AACX,YAAM,oBAAoB,KAAK,wBAAA;AAC/B,UAAI;AACF,cAAM,SAAS,MAAM,KAAK;AAAA,UACxB;AAAA,UACA,YAAY,GAAG,iBAAiB;AAAA,QAAA;AAElC,cAAM,KAAK,0BAAA;AACX,eAAO;AAAA,MACT,SAAS,OAAO;AACd,YAAI;AACF,gBAAM,KAAK,4BAAA;AAAA,QACb,QAAQ;AAAA,QAER;AACA,cAAM;AAAA,MACR;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,QAAuB;AAC3B,UAAM,KAAK,SAAS,MAAA;AAAA,EACtB;AAAA,EAEA,cAA2C;AACzC,WAAO,KAAK;AAAA,EACd;AAAA,EAEQ,QAAW,WAAyC;AAC1D,UAAM,kBAAkB,KAAK,MAAM,KAAK,WAAW,SAAS;AAC5D,SAAK,QAAQ,gBAAgB;AAAA,MAC3B,MAAM;AAAA,MACN,MAAM;AAAA,IAAA;AAER,WAAO;AAAA,EACT;AAAA,EAEA,MAAc,+BAA+F;AAC3G,QAAI,KAAK,kCAAkC;AACzC,aAAO,KAAK;AAAA,IACd;AAEA,SAAK,oCAAoC,YAAY;AACnD,YAAM,wBAAwB,MAAM,6BAAA;AACpC,UAAI,CAAC,uBAAuB;AAC1B,eAAO;AAAA,MACT;AAEA,aAAO,IAAI,sBAAA;AAAA,IACb,GAAA;AAEA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAc,6BAA2D;AACvE,UAAM,4BAA4B,MAAM,KAAK,6BAAA;AAC7C,UAAM,QAAQ,2BAA2B,SAAA;AACzC,WAAO,OAAO,qBAAqB;AAAA,EACrC;AAAA,EAEA,MAAc,0BACZ,mBACA,UACkB;AAClB,UAAM,4BAA4B,MAAM,KAAK,6BAAA;AAC7C,QAAI,CAAC,2BAA2B;AAC9B,aAAO,SAAA;AAAA,IACT;AAEA,WAAO,0BAA0B,IAAI,EAAE,kBAAA,GAAqB,QAAQ;AAAA,EACtE;AAAA,EAEA,MAAc,2BAA0C;AACtD,UAAM,KAAK,SAAS,QAAQ,mBAAmB,KAAK;AAAA,EACtD;AAAA,EAEA,MAAc,4BAA2C;AACvD,UAAM,KAAK,SAAS,QAAQ,UAAU,KAAK;AAAA,EAC7C;AAAA,EAEA,MAAc,8BAA6C;AACzD,UAAM,KAAK,SAAS,QAAQ,YAAY,KAAK;AAAA,EAC/C;AAAA,EAEQ,0BAAwC;AAC9C,UAAM,oBAAkC;AAAA,MACtC,MAAM,OAAO,QAAQ;AACnB,cAAM,KAAK,SAAS,QAAQ,KAAK,KAAK;AAAA,MACxC;AAAA,MACA,OAAO,OACL,KACA,SAAiC,OACH;AAC9B,cAAM,SAAS,MAAM,KAAK,SAAS,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC;AACzD,eAAO,iBAAoB,QAAQ,GAAG;AAAA,MACxC;AAAA,MACA,KAAK,OAAO,KAAK,SAAS,OAAO;AAC/B,cAAM,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,MAAM,GAAG,KAAK;AAAA,MACjD;AAAA,MACA,aAAa,OACX,OACe;AACf,8CAAsC,EAAE;AACxC,eAAO,KAAK,qBAAqB,mBAAmB,OAAO,WAAW;AACpE,iBAAO,GAAG,MAAM;AAAA,QAClB,CAAC;AAAA,MACH;AAAA,MACA,uBAAuB,OACrB,OACe,KAAK,qBAAqB,mBAAmB,EAAE;AAAA,IAAA;AAGlE,WAAO;AAAA,EACT;AAAA,EAEA,MAAc,qBACZ,mBACA,IACY;AACZ,UAAM,gBAAgB,WAAW,KAAK,eAAe;AACrD,SAAK;AACL,UAAM,KAAK,SAAS,QAAQ,aAAa,aAAa,IAAI,KAAK;AAE/D,QAAI;AACF,YAAM,SAAS,MAAM,KAAK;AAAA,QACxB;AAAA,QACA,YAAY,GAAG,iBAAiB;AAAA,MAAA;AAElC,YAAM,KAAK,SAAS,QAAQ,qBAAqB,aAAa,IAAI,KAAK;AACvE,aAAO;AAAA,IACT,SAAS,OAAO;AACd,YAAM,KAAK,SAAS;AAAA,QAClB,yBAAyB,aAAa;AAAA,QACtC;AAAA,MAAA;AAEF,YAAM,KAAK,SAAS,QAAQ,qBAAqB,aAAa,IAAI,KAAK;AACvE,YAAM;AAAA,IACR;AAAA,EACF;AACF;"}

package/dist/esm/capacitor.d.ts

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

package/dist/esm/capacitor.js

@@ -0,0 +1,8 @@
+import { createCapacitorSQLitePersistence as createCapacitorSQLitePersistence$1 } from "./capacitor-persistence.js";
+function createCapacitorSQLitePersistence(options) {
+  return createCapacitorSQLitePersistence$1(options);
+}
+export {
+  createCapacitorSQLitePersistence
+};
+//# sourceMappingURL=capacitor.js.map

package/dist/esm/capacitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacitor.js","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,mCAA2B,OAAO;AAC3C;"}

package/dist/esm/index.d.ts

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

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+import { createCapacitorSQLitePersistence } from "./capacitor.js";
+import { persistedCollectionOptions } from "@tanstack/db-sqlite-persistence-core";
+export {
+  createCapacitorSQLitePersistence,
+  persistedCollectionOptions
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@tanstack/capacitor-db-sqlite-persistence",
+  "version": "0.1.2",
+  "description": "Capacitor SQLite persisted collection adapter for TanStack DB",
+  "author": "TanStack Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TanStack/db.git",
+    "directory": "packages/capacitor-db-sqlite-persistence"
+  },
+  "homepage": "https://tanstack.com/db",
+  "keywords": [
+    "sqlite",
+    "capacitor",
+    "ionic",
+    "persistence",
+    "typescript"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "lint": "eslint . --fix",
+    "test": "vitest --run",
+    "test:e2e": "pnpm --filter @tanstack/db-ivm build && pnpm --filter @tanstack/db build && pnpm --filter @tanstack/db-sqlite-persistence-core build && pnpm --filter @tanstack/capacitor-db-sqlite-persistence build && vitest --config vitest.e2e.config.ts --run",
+    "test:e2e:android": "pnpm exec tsx ./e2e/run-android-e2e.ts",
+    "test:e2e:ios": "pnpm exec tsx ./e2e/run-ios-e2e.ts"
+  },
+  "type": "module",
+  "main": "dist/cjs/index.cjs",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.cts",
+        "default": "./dist/cjs/index.cjs"
+      }
+    },
+    "./capacitor": {
+      "import": {
+        "types": "./dist/esm/capacitor.d.ts",
+        "default": "./dist/esm/capacitor.js"
+      },
+      "require": {
+        "types": "./dist/cjs/capacitor.d.cts",
+        "default": "./dist/cjs/capacitor.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@tanstack/db-sqlite-persistence-core": "workspace:*"
+  },
+  "peerDependencies": {
+    "@capacitor-community/sqlite": "^8.0.1",
+    "typescript": ">=4.7"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@vitest/coverage-istanbul": "^3.2.4",
+    "better-sqlite3": "^12.6.2"
+  }
+}

package/src/capacitor-persistence.ts

@@ -0,0 +1,163 @@
+import {
+  SingleProcessCoordinator,
+  createSQLiteCorePersistenceAdapter,
+} from '@tanstack/db-sqlite-persistence-core'
+import { CapacitorSQLiteDriver } from './capacitor-sqlite-driver'
+import type { SQLiteDBConnection } from '@capacitor-community/sqlite'
+import type {
+  PersistedCollectionCoordinator,
+  PersistedCollectionMode,
+  PersistedCollectionPersistence,
+  SQLiteCoreAdapterOptions,
+  SQLiteDriver,
+} from '@tanstack/db-sqlite-persistence-core'
+
+export type { CapacitorSQLiteDatabaseLike } from './capacitor-sqlite-driver'
+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
+
+function normalizeSchemaMismatchPolicy(
+  policy: CapacitorSQLiteSchemaMismatchPolicy,
+): CapacitorSQLiteCoreSchemaMismatchPolicy {
+  if (policy === `throw`) {
+    return `sync-absent-error`
+  }
+
+  return policy
+}
+
+function resolveSchemaMismatchPolicy(
+  explicitPolicy: CapacitorSQLiteSchemaMismatchPolicy | undefined,
+  mode: PersistedCollectionMode,
+): CapacitorSQLiteCoreSchemaMismatchPolicy {
+  if (explicitPolicy) {
+    return normalizeSchemaMismatchPolicy(explicitPolicy)
+  }
+
+  return mode === `sync-present` ? `sync-present-reset` : `sync-absent-error`
+}
+
+function createAdapterCacheKey(
+  schemaMismatchPolicy: CapacitorSQLiteCoreSchemaMismatchPolicy,
+  schemaVersion: number | undefined,
+): string {
+  const schemaVersionKey =
+    schemaVersion === undefined ? `schema:default` : `schema:${schemaVersion}`
+  return `${schemaMismatchPolicy}|${schemaVersionKey}`
+}
+
+function createInternalSQLiteDriver(
+  options: CapacitorSQLitePersistenceOptions,
+): SQLiteDriver {
+  return new CapacitorSQLiteDriver({
+    database: options.database,
+  })
+}
+
+function resolveAdapterBaseOptions(
+  options: CapacitorSQLitePersistenceOptions,
+): Omit<
+  SQLiteCoreAdapterOptions,
+  `driver` | `schemaVersion` | `schemaMismatchPolicy`
+> {
+  return {
+    appliedTxPruneMaxRows: options.appliedTxPruneMaxRows,
+    appliedTxPruneMaxAgeSeconds: options.appliedTxPruneMaxAgeSeconds,
+    pullSinceReloadThreshold: options.pullSinceReloadThreshold,
+  }
+}
+
+export function createCapacitorSQLitePersistence<
+  T extends object,
+  TKey extends string | number = string | number,
+>(
+  options: CapacitorSQLitePersistenceOptions,
+): PersistedCollectionPersistence<T, TKey> {
+  const { coordinator, schemaMismatchPolicy } = options
+  const driver = createInternalSQLiteDriver(options)
+  const adapterBaseOptions = resolveAdapterBaseOptions(options)
+  const resolvedCoordinator = coordinator ?? new SingleProcessCoordinator()
+  const adapterCache = new Map<
+    string,
+    ReturnType<
+      typeof createSQLiteCorePersistenceAdapter<
+        Record<string, unknown>,
+        string | number
+      >
+    >
+  >()
+
+  const getAdapterForCollection = (
+    mode: PersistedCollectionMode,
+    schemaVersion: number | undefined,
+  ) => {
+    const resolvedSchemaMismatchPolicy = resolveSchemaMismatchPolicy(
+      schemaMismatchPolicy,
+      mode,
+    )
+    const cacheKey = createAdapterCacheKey(
+      resolvedSchemaMismatchPolicy,
+      schemaVersion,
+    )
+    const cachedAdapter = adapterCache.get(cacheKey)
+    if (cachedAdapter) {
+      return cachedAdapter
+    }
+
+    const adapter = createSQLiteCorePersistenceAdapter<
+      Record<string, unknown>,
+      string | number
+    >({
+      ...adapterBaseOptions,
+      driver,
+      schemaMismatchPolicy: resolvedSchemaMismatchPolicy,
+      ...(schemaVersion === undefined ? {} : { schemaVersion }),
+    })
+    adapterCache.set(cacheKey, adapter)
+    return adapter
+  }
+
+  const createCollectionPersistence = (
+    mode: PersistedCollectionMode,
+    schemaVersion: number | undefined,
+  ): PersistedCollectionPersistence<T, TKey> => ({
+    adapter: getAdapterForCollection(
+      mode,
+      schemaVersion,
+    ) as unknown as PersistedCollectionPersistence<T, TKey>[`adapter`],
+    coordinator: resolvedCoordinator,
+  })
+
+  const defaultPersistence = createCollectionPersistence(
+    `sync-absent`,
+    undefined,
+  )
+
+  return {
+    ...defaultPersistence,
+    resolvePersistenceForCollection: ({ mode, schemaVersion }) =>
+      createCollectionPersistence(mode, schemaVersion),
+    resolvePersistenceForMode: (mode) =>
+      createCollectionPersistence(mode, undefined),
+  }
+}