@tanstack/expo-db-sqlite-persistence 0.1.2

package/README.md

@@ -0,0 +1,64 @@
+# @tanstack/expo-db-sqlite-persistence
+
+Thin SQLite persistence for Expo apps using the official `expo-sqlite` adapter.
+
+## Public API
+
+- `createExpoSQLitePersistence(...)`
+- `persistedCollectionOptions(...)` (re-exported from core)
+- Advanced driver entrypoint:
+  `@tanstack/expo-db-sqlite-persistence/expo-sqlite-driver`
+
+## Quick start
+
+```ts
+import * as SQLite from 'expo-sqlite'
+import { createCollection } from '@tanstack/db'
+import {
+  createExpoSQLitePersistence,
+  persistedCollectionOptions,
+} from '@tanstack/expo-db-sqlite-persistence'
+
+type Todo = {
+  id: string
+  title: string
+  completed: boolean
+}
+
+const database = await SQLite.openDatabaseAsync(`tanstack-db.sqlite`)
+
+// One shared persistence instance for the whole database.
+const persistence = createExpoSQLitePersistence({
+  database,
+})
+
+export const todosCollection = createCollection(
+  persistedCollectionOptions<Todo, string>({
+    id: `todos`,
+    getKey: (todo) => todo.id,
+    persistence,
+    schemaVersion: 1, // Per-collection schema version
+  }),
+)
+```
+
+## Notes
+
+- This package targets the official `expo-sqlite` async database API.
+- Requires `expo-sqlite` `^55.0.10` (documented as a peer dependency).
+- `createExpoSQLitePersistence` is shared across collections.
+- Mode defaults (`sync-present` vs `sync-absent`) are inferred from whether a
+  `sync` config is present in `persistedCollectionOptions`.
+- The React Native `op-sqlite` wrapper remains available in
+  `@tanstack/react-native-db-sqlite-persistence`.
+- Expo web is not part of the emulator-backed E2E path in this package. Use the
+  browser SQLite package for browser-focused persistence coverage.
+
+## E2E
+
+- `pnpm --filter @tanstack/expo-db-sqlite-persistence test:e2e`
+  runs the shared Node-backed conformance suite.
+- `pnpm --filter @tanstack/expo-db-sqlite-persistence test:e2e:expo:ios`
+  runs the real Expo iOS Simulator path.
+- `pnpm --filter @tanstack/expo-db-sqlite-persistence test:e2e:expo:android`
+  runs the real Expo Android Emulator path.

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

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const dbSqlitePersistenceCore = require("@tanstack/db-sqlite-persistence-core");
+function hasExistingDatabase(options) {
+  return `database` in options;
+}
+function assertTransactionCallbackHasDriverArg(fn) {
+  if (fn.length > 0) {
+    return;
+  }
+  throw new dbSqlitePersistenceCore.InvalidPersistedCollectionConfigError(
+    `SQLiteDriver.transaction callback must accept the transaction driver argument`
+  );
+}
+function isExpoSQLiteDatabaseLike(value) {
+  return typeof value === `object` && value !== null && typeof value.execAsync === `function` && typeof value.getAllAsync === `function` && typeof value.runAsync === `function` && typeof value.withExclusiveTransactionAsync === `function`;
+}
+class ExpoSQLiteDriver {
+  constructor(options) {
+    this.queue = Promise.resolve();
+    this.nextSavepointId = 1;
+    if (hasExistingDatabase(options)) {
+      if (!isExpoSQLiteDatabaseLike(options.database)) {
+        throw new dbSqlitePersistenceCore.InvalidPersistedCollectionConfigError(
+          `Expo SQLite database must provide execAsync/getAllAsync/runAsync/withExclusiveTransactionAsync`
+        );
+      }
+      this.databasePromise = Promise.resolve(options.database);
+      this.ownsDatabase = false;
+      return;
+    }
+    this.databasePromise = Promise.resolve(options.openDatabase()).then(
+      (database) => {
+        if (!isExpoSQLiteDatabaseLike(database)) {
+          throw new dbSqlitePersistenceCore.InvalidPersistedCollectionConfigError(
+            `Expo SQLite openDatabase() must resolve a database with execAsync/getAllAsync/runAsync/withExclusiveTransactionAsync`
+          );
+        }
+        return database;
+      }
+    );
+    this.ownsDatabase = true;
+  }
+  async exec(sql) {
+    await this.enqueue(async () => {
+      const database = await this.getDatabase();
+      await database.execAsync(sql);
+    });
+  }
+  async query(sql, params = []) {
+    return this.enqueue(async () => {
+      const database = await this.getDatabase();
+      return database.getAllAsync(sql, normalizeParams(params));
+    });
+  }
+  async run(sql, params = []) {
+    await this.enqueue(async () => {
+      const database = await this.getDatabase();
+      await database.runAsync(sql, normalizeParams(params));
+    });
+  }
+  async transaction(fn) {
+    assertTransactionCallbackHasDriverArg(fn);
+    return this.transactionWithDriver(fn);
+  }
+  async transactionWithDriver(fn) {
+    return this.enqueue(async () => {
+      const database = await this.getDatabase();
+      return database.withExclusiveTransactionAsync(async (transaction) => {
+        const transactionDriver = this.createTransactionDriver(transaction);
+        return fn(transactionDriver);
+      });
+    });
+  }
+  async close() {
+    const database = await this.getDatabase();
+    if (!this.ownsDatabase || typeof database.closeAsync !== `function`) {
+      return;
+    }
+    await database.closeAsync();
+  }
+  async getDatabase() {
+    return this.databasePromise;
+  }
+  enqueue(operation) {
+    const queuedOperation = this.queue.then(operation, operation);
+    this.queue = queuedOperation.then(
+      () => void 0,
+      () => void 0
+    );
+    return queuedOperation;
+  }
+  createTransactionDriver(transaction) {
+    const transactionDriver = {
+      exec: async (sql) => {
+        await transaction.execAsync(sql);
+      },
+      query: async (sql, params = []) => {
+        return transaction.getAllAsync(sql, normalizeParams(params));
+      },
+      run: async (sql, params = []) => {
+        await transaction.runAsync(sql, normalizeParams(params));
+      },
+      transaction: async (fn) => {
+        assertTransactionCallbackHasDriverArg(fn);
+        return this.runNestedTransaction(transaction, transactionDriver, fn);
+      },
+      transactionWithDriver: async (fn) => this.runNestedTransaction(transaction, transactionDriver, fn)
+    };
+    return transactionDriver;
+  }
+  async runNestedTransaction(transaction, transactionDriver, fn) {
+    const savepointName = `tsdb_sp_${this.nextSavepointId}`;
+    this.nextSavepointId++;
+    await transaction.execAsync(`SAVEPOINT ${savepointName}`);
+    try {
+      const result = await fn(transactionDriver);
+      await transaction.execAsync(`RELEASE SAVEPOINT ${savepointName}`);
+      return result;
+    } catch (error) {
+      await transaction.execAsync(`ROLLBACK TO SAVEPOINT ${savepointName}`);
+      await transaction.execAsync(`RELEASE SAVEPOINT ${savepointName}`);
+      throw error;
+    }
+  }
+}
+function normalizeParams(params) {
+  return params.length > 0 ? [...params] : void 0;
+}
+exports.ExpoSQLiteDriver = ExpoSQLiteDriver;
+//# sourceMappingURL=expo-sqlite-driver.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expo-sqlite-driver.cjs","sources":["../../src/expo-sqlite-driver.ts"],"sourcesContent":["import { InvalidPersistedCollectionConfigError } from '@tanstack/db-sqlite-persistence-core'\nimport type { SQLiteDriver } from '@tanstack/db-sqlite-persistence-core'\n\nexport type ExpoSQLiteBindParams =\n  | ReadonlyArray<unknown>\n  | Record<string, unknown>\n\nexport type ExpoSQLiteRunResult = {\n  changes: number\n  lastInsertRowId: number\n}\n\nexport type ExpoSQLiteQueryable = {\n  execAsync: (sql: string) => Promise<void>\n  getAllAsync: <T>(\n    sql: string,\n    params?: ExpoSQLiteBindParams,\n  ) => Promise<ReadonlyArray<T>>\n  runAsync: (\n    sql: string,\n    params?: ExpoSQLiteBindParams,\n  ) => Promise<ExpoSQLiteRunResult>\n}\n\nexport type ExpoSQLiteTransaction = ExpoSQLiteQueryable\n\nexport type ExpoSQLiteDatabaseLike = ExpoSQLiteQueryable & {\n  withExclusiveTransactionAsync: <T>(\n    task: (transaction: ExpoSQLiteTransaction) => Promise<T>,\n  ) => Promise<T>\n  closeAsync?: () => Promise<void>\n}\n\ntype ExpoSQLiteExistingDatabaseOptions = {\n  database: ExpoSQLiteDatabaseLike\n}\n\ntype ExpoSQLiteOpenDatabaseOptions = {\n  openDatabase: () => Promise<ExpoSQLiteDatabaseLike> | ExpoSQLiteDatabaseLike\n}\n\nexport type ExpoSQLiteDriverOptions =\n  | ExpoSQLiteExistingDatabaseOptions\n  | ExpoSQLiteOpenDatabaseOptions\n\nfunction hasExistingDatabase(\n  options: ExpoSQLiteDriverOptions,\n): options is ExpoSQLiteExistingDatabaseOptions {\n  return `database` in options\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 isExpoSQLiteDatabaseLike(\n  value: unknown,\n): value is ExpoSQLiteDatabaseLike {\n  return (\n    typeof value === `object` &&\n    value !== null &&\n    typeof (value as ExpoSQLiteDatabaseLike).execAsync === `function` &&\n    typeof (value as ExpoSQLiteDatabaseLike).getAllAsync === `function` &&\n    typeof (value as ExpoSQLiteDatabaseLike).runAsync === `function` &&\n    typeof (value as ExpoSQLiteDatabaseLike).withExclusiveTransactionAsync ===\n      `function`\n  )\n}\n\nexport class ExpoSQLiteDriver implements SQLiteDriver {\n  private readonly databasePromise: Promise<ExpoSQLiteDatabaseLike>\n  private readonly ownsDatabase: boolean\n  private queue: Promise<void> = Promise.resolve()\n  private nextSavepointId = 1\n\n  constructor(options: ExpoSQLiteDriverOptions) {\n    if (hasExistingDatabase(options)) {\n      if (!isExpoSQLiteDatabaseLike(options.database)) {\n        throw new InvalidPersistedCollectionConfigError(\n          `Expo SQLite database must provide execAsync/getAllAsync/runAsync/withExclusiveTransactionAsync`,\n        )\n      }\n\n      this.databasePromise = Promise.resolve(options.database)\n      this.ownsDatabase = false\n      return\n    }\n\n    this.databasePromise = Promise.resolve(options.openDatabase()).then(\n      (database) => {\n        if (!isExpoSQLiteDatabaseLike(database)) {\n          throw new InvalidPersistedCollectionConfigError(\n            `Expo SQLite openDatabase() must resolve a database with execAsync/getAllAsync/runAsync/withExclusiveTransactionAsync`,\n          )\n        }\n\n        return database\n      },\n    )\n    this.ownsDatabase = true\n  }\n\n  async exec(sql: string): Promise<void> {\n    await this.enqueue(async () => {\n      const database = await this.getDatabase()\n      await database.execAsync(sql)\n    })\n  }\n\n  async query<T>(\n    sql: string,\n    params: ReadonlyArray<unknown> = [],\n  ): Promise<ReadonlyArray<T>> {\n    return this.enqueue(async () => {\n      const database = await this.getDatabase()\n      return database.getAllAsync<T>(sql, normalizeParams(params))\n    })\n  }\n\n  async run(sql: string, params: ReadonlyArray<unknown> = []): Promise<void> {\n    await this.enqueue(async () => {\n      const database = await this.getDatabase()\n      await database.runAsync(sql, normalizeParams(params))\n    })\n  }\n\n  async transaction<T>(\n    fn: (transactionDriver: SQLiteDriver) => Promise<T>,\n  ): Promise<T> {\n    assertTransactionCallbackHasDriverArg(fn)\n    return this.transactionWithDriver(fn)\n  }\n\n  async transactionWithDriver<T>(\n    fn: (transactionDriver: SQLiteDriver) => Promise<T>,\n  ): Promise<T> {\n    return this.enqueue(async () => {\n      const database = await this.getDatabase()\n      return database.withExclusiveTransactionAsync(async (transaction) => {\n        const transactionDriver = this.createTransactionDriver(transaction)\n        return fn(transactionDriver)\n      })\n    })\n  }\n\n  async close(): Promise<void> {\n    const database = await this.getDatabase()\n    if (!this.ownsDatabase || typeof database.closeAsync !== `function`) {\n      return\n    }\n\n    await database.closeAsync()\n  }\n\n  async getDatabase(): Promise<ExpoSQLiteDatabaseLike> {\n    return this.databasePromise\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 createTransactionDriver(\n    transaction: ExpoSQLiteTransaction,\n  ): SQLiteDriver {\n    const transactionDriver: SQLiteDriver = {\n      exec: async (sql) => {\n        await transaction.execAsync(sql)\n      },\n      query: async <T>(\n        sql: string,\n        params: ReadonlyArray<unknown> = [],\n      ): Promise<ReadonlyArray<T>> => {\n        return transaction.getAllAsync<T>(sql, normalizeParams(params))\n      },\n      run: async (sql: string, params: ReadonlyArray<unknown> = []) => {\n        await transaction.runAsync(sql, normalizeParams(params))\n      },\n      transaction: async <T>(\n        fn: (nestedTransactionDriver: SQLiteDriver) => Promise<T>,\n      ): Promise<T> => {\n        assertTransactionCallbackHasDriverArg(fn)\n        return this.runNestedTransaction(transaction, transactionDriver, fn)\n      },\n      transactionWithDriver: async <T>(\n        fn: (nestedTransactionDriver: SQLiteDriver) => Promise<T>,\n      ): Promise<T> =>\n        this.runNestedTransaction(transaction, transactionDriver, fn),\n    }\n\n    return transactionDriver\n  }\n\n  private async runNestedTransaction<T>(\n    transaction: ExpoSQLiteTransaction,\n    transactionDriver: SQLiteDriver,\n    fn: (transactionDriver: SQLiteDriver) => Promise<T>,\n  ): Promise<T> {\n    const savepointName = `tsdb_sp_${this.nextSavepointId}`\n    this.nextSavepointId++\n    await transaction.execAsync(`SAVEPOINT ${savepointName}`)\n\n    try {\n      const result = await fn(transactionDriver)\n      await transaction.execAsync(`RELEASE SAVEPOINT ${savepointName}`)\n      return result\n    } catch (error) {\n      await transaction.execAsync(`ROLLBACK TO SAVEPOINT ${savepointName}`)\n      await transaction.execAsync(`RELEASE SAVEPOINT ${savepointName}`)\n      throw error\n    }\n  }\n}\n\nfunction normalizeParams(\n  params: ReadonlyArray<unknown>,\n): ExpoSQLiteBindParams | undefined {\n  return params.length > 0 ? [...params] : undefined\n}\n\nexport function createExpoSQLiteDriver(\n  options: ExpoSQLiteDriverOptions,\n): ExpoSQLiteDriver {\n  return new ExpoSQLiteDriver(options)\n}\n"],"names":["InvalidPersistedCollectionConfigError"],"mappings":"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"}

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

@@ -0,0 +1,42 @@
+import { SQLiteDriver } from '@tanstack/db-sqlite-persistence-core';
+export type ExpoSQLiteBindParams = ReadonlyArray<unknown> | Record<string, unknown>;
+export type ExpoSQLiteRunResult = {
+    changes: number;
+    lastInsertRowId: number;
+};
+export type ExpoSQLiteQueryable = {
+    execAsync: (sql: string) => Promise<void>;
+    getAllAsync: <T>(sql: string, params?: ExpoSQLiteBindParams) => Promise<ReadonlyArray<T>>;
+    runAsync: (sql: string, params?: ExpoSQLiteBindParams) => Promise<ExpoSQLiteRunResult>;
+};
+export type ExpoSQLiteTransaction = ExpoSQLiteQueryable;
+export type ExpoSQLiteDatabaseLike = ExpoSQLiteQueryable & {
+    withExclusiveTransactionAsync: <T>(task: (transaction: ExpoSQLiteTransaction) => Promise<T>) => Promise<T>;
+    closeAsync?: () => Promise<void>;
+};
+type ExpoSQLiteExistingDatabaseOptions = {
+    database: ExpoSQLiteDatabaseLike;
+};
+type ExpoSQLiteOpenDatabaseOptions = {
+    openDatabase: () => Promise<ExpoSQLiteDatabaseLike> | ExpoSQLiteDatabaseLike;
+};
+export type ExpoSQLiteDriverOptions = ExpoSQLiteExistingDatabaseOptions | ExpoSQLiteOpenDatabaseOptions;
+export declare class ExpoSQLiteDriver implements SQLiteDriver {
+    private readonly databasePromise;
+    private readonly ownsDatabase;
+    private queue;
+    private nextSavepointId;
+    constructor(options: ExpoSQLiteDriverOptions);
+    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(): Promise<ExpoSQLiteDatabaseLike>;
+    private enqueue;
+    private createTransactionDriver;
+    private runNestedTransaction;
+}
+export declare function createExpoSQLiteDriver(options: ExpoSQLiteDriverOptions): ExpoSQLiteDriver;
+export {};

package/dist/cjs/expo.cjs

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const dbSqlitePersistenceCore = require("@tanstack/db-sqlite-persistence-core");
+const expoSqliteDriver = require("./expo-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 expoSqliteDriver.ExpoSQLiteDriver({
+    database: options.database
+  });
+}
+function resolveAdapterBaseOptions(options) {
+  return {
+    appliedTxPruneMaxRows: options.appliedTxPruneMaxRows,
+    appliedTxPruneMaxAgeSeconds: options.appliedTxPruneMaxAgeSeconds,
+    pullSinceReloadThreshold: options.pullSinceReloadThreshold
+  };
+}
+function createExpoSQLitePersistence(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.createExpoSQLitePersistence = createExpoSQLitePersistence;
+//# sourceMappingURL=expo.cjs.map

package/dist/cjs/expo.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"expo.cjs","sources":["../../src/expo.ts"],"sourcesContent":["import {\n  SingleProcessCoordinator,\n  createSQLiteCorePersistenceAdapter,\n} from '@tanstack/db-sqlite-persistence-core'\nimport { ExpoSQLiteDriver } from './expo-sqlite-driver'\nimport type {\n  PersistedCollectionCoordinator,\n  PersistedCollectionMode,\n  PersistedCollectionPersistence,\n  SQLiteCoreAdapterOptions,\n  SQLiteDriver,\n} from '@tanstack/db-sqlite-persistence-core'\nimport type { ExpoSQLiteDatabaseLike } from './expo-sqlite-driver'\n\nexport type { ExpoSQLiteDatabaseLike } from './expo-sqlite-driver'\n\ntype ExpoSQLiteCoreSchemaMismatchPolicy =\n  | `sync-present-reset`\n  | `sync-absent-error`\n  | `reset`\n\nexport type ExpoSQLiteSchemaMismatchPolicy =\n  | ExpoSQLiteCoreSchemaMismatchPolicy\n  | `throw`\n\nexport type ExpoSQLitePersistenceOptions = Omit<\n  SQLiteCoreAdapterOptions,\n  `driver` | `schemaVersion` | `schemaMismatchPolicy`\n> & {\n  database: ExpoSQLiteDatabaseLike\n  coordinator?: PersistedCollectionCoordinator\n  schemaMismatchPolicy?: ExpoSQLiteSchemaMismatchPolicy\n}\n\nfunction normalizeSchemaMismatchPolicy(\n  policy: ExpoSQLiteSchemaMismatchPolicy,\n): ExpoSQLiteCoreSchemaMismatchPolicy {\n  if (policy === `throw`) {\n    return `sync-absent-error`\n  }\n\n  return policy\n}\n\nfunction resolveSchemaMismatchPolicy(\n  explicitPolicy: ExpoSQLiteSchemaMismatchPolicy | undefined,\n  mode: PersistedCollectionMode,\n): ExpoSQLiteCoreSchemaMismatchPolicy {\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: ExpoSQLiteCoreSchemaMismatchPolicy,\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: ExpoSQLitePersistenceOptions,\n): SQLiteDriver {\n  return new ExpoSQLiteDriver({\n    database: options.database,\n  })\n}\n\nfunction resolveAdapterBaseOptions(\n  options: ExpoSQLitePersistenceOptions,\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 createExpoSQLitePersistence<\n  T extends object,\n  TKey extends string | number = string | number,\n>(\n  options: ExpoSQLitePersistenceOptions,\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":["ExpoSQLiteDriver","SingleProcessCoordinator","createSQLiteCorePersistenceAdapter"],"mappings":";;;;AAkCA,SAAS,8BACP,QACoC;AACpC,MAAI,WAAW,SAAS;AACtB,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEA,SAAS,4BACP,gBACA,MACoC;AACpC,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,iBAAAA,iBAAiB;AAAA,IAC1B,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,4BAId,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/expo.d.cts

@@ -0,0 +1,11 @@
+import { PersistedCollectionCoordinator, PersistedCollectionPersistence, SQLiteCoreAdapterOptions } from '@tanstack/db-sqlite-persistence-core';
+import { ExpoSQLiteDatabaseLike } from './expo-sqlite-driver.cjs';
+export type { ExpoSQLiteDatabaseLike } from './expo-sqlite-driver.cjs';
+type ExpoSQLiteCoreSchemaMismatchPolicy = `sync-present-reset` | `sync-absent-error` | `reset`;
+export type ExpoSQLiteSchemaMismatchPolicy = ExpoSQLiteCoreSchemaMismatchPolicy | `throw`;
+export type ExpoSQLitePersistenceOptions = Omit<SQLiteCoreAdapterOptions, `driver` | `schemaVersion` | `schemaMismatchPolicy`> & {
+    database: ExpoSQLiteDatabaseLike;
+    coordinator?: PersistedCollectionCoordinator;
+    schemaMismatchPolicy?: ExpoSQLiteSchemaMismatchPolicy;
+};
+export declare function createExpoSQLitePersistence<T extends object, TKey extends string | number = string | number>(options: ExpoSQLitePersistenceOptions): PersistedCollectionPersistence<T, TKey>;

package/dist/cjs/index.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const expo = require("./expo.cjs");
+const dbSqlitePersistenceCore = require("@tanstack/db-sqlite-persistence-core");
+exports.createExpoSQLitePersistence = expo.createExpoSQLitePersistence;
+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 { createExpoSQLitePersistence } from './expo.cjs';
+export type { ExpoSQLiteDatabaseLike, ExpoSQLitePersistenceOptions, ExpoSQLiteSchemaMismatchPolicy, } from './expo.cjs';
+export { persistedCollectionOptions } from '@tanstack/db-sqlite-persistence-core';
+export type { PersistedCollectionCoordinator, PersistedCollectionPersistence, } from '@tanstack/db-sqlite-persistence-core';

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

@@ -0,0 +1,42 @@
+import { SQLiteDriver } from '@tanstack/db-sqlite-persistence-core';
+export type ExpoSQLiteBindParams = ReadonlyArray<unknown> | Record<string, unknown>;
+export type ExpoSQLiteRunResult = {
+    changes: number;
+    lastInsertRowId: number;
+};
+export type ExpoSQLiteQueryable = {
+    execAsync: (sql: string) => Promise<void>;
+    getAllAsync: <T>(sql: string, params?: ExpoSQLiteBindParams) => Promise<ReadonlyArray<T>>;
+    runAsync: (sql: string, params?: ExpoSQLiteBindParams) => Promise<ExpoSQLiteRunResult>;
+};
+export type ExpoSQLiteTransaction = ExpoSQLiteQueryable;
+export type ExpoSQLiteDatabaseLike = ExpoSQLiteQueryable & {
+    withExclusiveTransactionAsync: <T>(task: (transaction: ExpoSQLiteTransaction) => Promise<T>) => Promise<T>;
+    closeAsync?: () => Promise<void>;
+};
+type ExpoSQLiteExistingDatabaseOptions = {
+    database: ExpoSQLiteDatabaseLike;
+};
+type ExpoSQLiteOpenDatabaseOptions = {
+    openDatabase: () => Promise<ExpoSQLiteDatabaseLike> | ExpoSQLiteDatabaseLike;
+};
+export type ExpoSQLiteDriverOptions = ExpoSQLiteExistingDatabaseOptions | ExpoSQLiteOpenDatabaseOptions;
+export declare class ExpoSQLiteDriver implements SQLiteDriver {
+    private readonly databasePromise;
+    private readonly ownsDatabase;
+    private queue;
+    private nextSavepointId;
+    constructor(options: ExpoSQLiteDriverOptions);
+    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(): Promise<ExpoSQLiteDatabaseLike>;
+    private enqueue;
+    private createTransactionDriver;
+    private runNestedTransaction;
+}
+export declare function createExpoSQLiteDriver(options: ExpoSQLiteDriverOptions): ExpoSQLiteDriver;
+export {};

package/dist/esm/expo-sqlite-driver.js

@@ -0,0 +1,131 @@
+import { InvalidPersistedCollectionConfigError } from "@tanstack/db-sqlite-persistence-core";
+function hasExistingDatabase(options) {
+  return `database` in options;
+}
+function assertTransactionCallbackHasDriverArg(fn) {
+  if (fn.length > 0) {
+    return;
+  }
+  throw new InvalidPersistedCollectionConfigError(
+    `SQLiteDriver.transaction callback must accept the transaction driver argument`
+  );
+}
+function isExpoSQLiteDatabaseLike(value) {
+  return typeof value === `object` && value !== null && typeof value.execAsync === `function` && typeof value.getAllAsync === `function` && typeof value.runAsync === `function` && typeof value.withExclusiveTransactionAsync === `function`;
+}
+class ExpoSQLiteDriver {
+  constructor(options) {
+    this.queue = Promise.resolve();
+    this.nextSavepointId = 1;
+    if (hasExistingDatabase(options)) {
+      if (!isExpoSQLiteDatabaseLike(options.database)) {
+        throw new InvalidPersistedCollectionConfigError(
+          `Expo SQLite database must provide execAsync/getAllAsync/runAsync/withExclusiveTransactionAsync`
+        );
+      }
+      this.databasePromise = Promise.resolve(options.database);
+      this.ownsDatabase = false;
+      return;
+    }
+    this.databasePromise = Promise.resolve(options.openDatabase()).then(
+      (database) => {
+        if (!isExpoSQLiteDatabaseLike(database)) {
+          throw new InvalidPersistedCollectionConfigError(
+            `Expo SQLite openDatabase() must resolve a database with execAsync/getAllAsync/runAsync/withExclusiveTransactionAsync`
+          );
+        }
+        return database;
+      }
+    );
+    this.ownsDatabase = true;
+  }
+  async exec(sql) {
+    await this.enqueue(async () => {
+      const database = await this.getDatabase();
+      await database.execAsync(sql);
+    });
+  }
+  async query(sql, params = []) {
+    return this.enqueue(async () => {
+      const database = await this.getDatabase();
+      return database.getAllAsync(sql, normalizeParams(params));
+    });
+  }
+  async run(sql, params = []) {
+    await this.enqueue(async () => {
+      const database = await this.getDatabase();
+      await database.runAsync(sql, normalizeParams(params));
+    });
+  }
+  async transaction(fn) {
+    assertTransactionCallbackHasDriverArg(fn);
+    return this.transactionWithDriver(fn);
+  }
+  async transactionWithDriver(fn) {
+    return this.enqueue(async () => {
+      const database = await this.getDatabase();
+      return database.withExclusiveTransactionAsync(async (transaction) => {
+        const transactionDriver = this.createTransactionDriver(transaction);
+        return fn(transactionDriver);
+      });
+    });
+  }
+  async close() {
+    const database = await this.getDatabase();
+    if (!this.ownsDatabase || typeof database.closeAsync !== `function`) {
+      return;
+    }
+    await database.closeAsync();
+  }
+  async getDatabase() {
+    return this.databasePromise;
+  }
+  enqueue(operation) {
+    const queuedOperation = this.queue.then(operation, operation);
+    this.queue = queuedOperation.then(
+      () => void 0,
+      () => void 0
+    );
+    return queuedOperation;
+  }
+  createTransactionDriver(transaction) {
+    const transactionDriver = {
+      exec: async (sql) => {
+        await transaction.execAsync(sql);
+      },
+      query: async (sql, params = []) => {
+        return transaction.getAllAsync(sql, normalizeParams(params));
+      },
+      run: async (sql, params = []) => {
+        await transaction.runAsync(sql, normalizeParams(params));
+      },
+      transaction: async (fn) => {
+        assertTransactionCallbackHasDriverArg(fn);
+        return this.runNestedTransaction(transaction, transactionDriver, fn);
+      },
+      transactionWithDriver: async (fn) => this.runNestedTransaction(transaction, transactionDriver, fn)
+    };
+    return transactionDriver;
+  }
+  async runNestedTransaction(transaction, transactionDriver, fn) {
+    const savepointName = `tsdb_sp_${this.nextSavepointId}`;
+    this.nextSavepointId++;
+    await transaction.execAsync(`SAVEPOINT ${savepointName}`);
+    try {
+      const result = await fn(transactionDriver);
+      await transaction.execAsync(`RELEASE SAVEPOINT ${savepointName}`);
+      return result;
+    } catch (error) {
+      await transaction.execAsync(`ROLLBACK TO SAVEPOINT ${savepointName}`);
+      await transaction.execAsync(`RELEASE SAVEPOINT ${savepointName}`);
+      throw error;
+    }
+  }
+}
+function normalizeParams(params) {
+  return params.length > 0 ? [...params] : void 0;
+}
+export {
+  ExpoSQLiteDriver
+};
+//# sourceMappingURL=expo-sqlite-driver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expo-sqlite-driver.js","sources":["../../src/expo-sqlite-driver.ts"],"sourcesContent":["import { InvalidPersistedCollectionConfigError } from '@tanstack/db-sqlite-persistence-core'\nimport type { SQLiteDriver } from '@tanstack/db-sqlite-persistence-core'\n\nexport type ExpoSQLiteBindParams =\n  | ReadonlyArray<unknown>\n  | Record<string, unknown>\n\nexport type ExpoSQLiteRunResult = {\n  changes: number\n  lastInsertRowId: number\n}\n\nexport type ExpoSQLiteQueryable = {\n  execAsync: (sql: string) => Promise<void>\n  getAllAsync: <T>(\n    sql: string,\n    params?: ExpoSQLiteBindParams,\n  ) => Promise<ReadonlyArray<T>>\n  runAsync: (\n    sql: string,\n    params?: ExpoSQLiteBindParams,\n  ) => Promise<ExpoSQLiteRunResult>\n}\n\nexport type ExpoSQLiteTransaction = ExpoSQLiteQueryable\n\nexport type ExpoSQLiteDatabaseLike = ExpoSQLiteQueryable & {\n  withExclusiveTransactionAsync: <T>(\n    task: (transaction: ExpoSQLiteTransaction) => Promise<T>,\n  ) => Promise<T>\n  closeAsync?: () => Promise<void>\n}\n\ntype ExpoSQLiteExistingDatabaseOptions = {\n  database: ExpoSQLiteDatabaseLike\n}\n\ntype ExpoSQLiteOpenDatabaseOptions = {\n  openDatabase: () => Promise<ExpoSQLiteDatabaseLike> | ExpoSQLiteDatabaseLike\n}\n\nexport type ExpoSQLiteDriverOptions =\n  | ExpoSQLiteExistingDatabaseOptions\n  | ExpoSQLiteOpenDatabaseOptions\n\nfunction hasExistingDatabase(\n  options: ExpoSQLiteDriverOptions,\n): options is ExpoSQLiteExistingDatabaseOptions {\n  return `database` in options\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 isExpoSQLiteDatabaseLike(\n  value: unknown,\n): value is ExpoSQLiteDatabaseLike {\n  return (\n    typeof value === `object` &&\n    value !== null &&\n    typeof (value as ExpoSQLiteDatabaseLike).execAsync === `function` &&\n    typeof (value as ExpoSQLiteDatabaseLike).getAllAsync === `function` &&\n    typeof (value as ExpoSQLiteDatabaseLike).runAsync === `function` &&\n    typeof (value as ExpoSQLiteDatabaseLike).withExclusiveTransactionAsync ===\n      `function`\n  )\n}\n\nexport class ExpoSQLiteDriver implements SQLiteDriver {\n  private readonly databasePromise: Promise<ExpoSQLiteDatabaseLike>\n  private readonly ownsDatabase: boolean\n  private queue: Promise<void> = Promise.resolve()\n  private nextSavepointId = 1\n\n  constructor(options: ExpoSQLiteDriverOptions) {\n    if (hasExistingDatabase(options)) {\n      if (!isExpoSQLiteDatabaseLike(options.database)) {\n        throw new InvalidPersistedCollectionConfigError(\n          `Expo SQLite database must provide execAsync/getAllAsync/runAsync/withExclusiveTransactionAsync`,\n        )\n      }\n\n      this.databasePromise = Promise.resolve(options.database)\n      this.ownsDatabase = false\n      return\n    }\n\n    this.databasePromise = Promise.resolve(options.openDatabase()).then(\n      (database) => {\n        if (!isExpoSQLiteDatabaseLike(database)) {\n          throw new InvalidPersistedCollectionConfigError(\n            `Expo SQLite openDatabase() must resolve a database with execAsync/getAllAsync/runAsync/withExclusiveTransactionAsync`,\n          )\n        }\n\n        return database\n      },\n    )\n    this.ownsDatabase = true\n  }\n\n  async exec(sql: string): Promise<void> {\n    await this.enqueue(async () => {\n      const database = await this.getDatabase()\n      await database.execAsync(sql)\n    })\n  }\n\n  async query<T>(\n    sql: string,\n    params: ReadonlyArray<unknown> = [],\n  ): Promise<ReadonlyArray<T>> {\n    return this.enqueue(async () => {\n      const database = await this.getDatabase()\n      return database.getAllAsync<T>(sql, normalizeParams(params))\n    })\n  }\n\n  async run(sql: string, params: ReadonlyArray<unknown> = []): Promise<void> {\n    await this.enqueue(async () => {\n      const database = await this.getDatabase()\n      await database.runAsync(sql, normalizeParams(params))\n    })\n  }\n\n  async transaction<T>(\n    fn: (transactionDriver: SQLiteDriver) => Promise<T>,\n  ): Promise<T> {\n    assertTransactionCallbackHasDriverArg(fn)\n    return this.transactionWithDriver(fn)\n  }\n\n  async transactionWithDriver<T>(\n    fn: (transactionDriver: SQLiteDriver) => Promise<T>,\n  ): Promise<T> {\n    return this.enqueue(async () => {\n      const database = await this.getDatabase()\n      return database.withExclusiveTransactionAsync(async (transaction) => {\n        const transactionDriver = this.createTransactionDriver(transaction)\n        return fn(transactionDriver)\n      })\n    })\n  }\n\n  async close(): Promise<void> {\n    const database = await this.getDatabase()\n    if (!this.ownsDatabase || typeof database.closeAsync !== `function`) {\n      return\n    }\n\n    await database.closeAsync()\n  }\n\n  async getDatabase(): Promise<ExpoSQLiteDatabaseLike> {\n    return this.databasePromise\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 createTransactionDriver(\n    transaction: ExpoSQLiteTransaction,\n  ): SQLiteDriver {\n    const transactionDriver: SQLiteDriver = {\n      exec: async (sql) => {\n        await transaction.execAsync(sql)\n      },\n      query: async <T>(\n        sql: string,\n        params: ReadonlyArray<unknown> = [],\n      ): Promise<ReadonlyArray<T>> => {\n        return transaction.getAllAsync<T>(sql, normalizeParams(params))\n      },\n      run: async (sql: string, params: ReadonlyArray<unknown> = []) => {\n        await transaction.runAsync(sql, normalizeParams(params))\n      },\n      transaction: async <T>(\n        fn: (nestedTransactionDriver: SQLiteDriver) => Promise<T>,\n      ): Promise<T> => {\n        assertTransactionCallbackHasDriverArg(fn)\n        return this.runNestedTransaction(transaction, transactionDriver, fn)\n      },\n      transactionWithDriver: async <T>(\n        fn: (nestedTransactionDriver: SQLiteDriver) => Promise<T>,\n      ): Promise<T> =>\n        this.runNestedTransaction(transaction, transactionDriver, fn),\n    }\n\n    return transactionDriver\n  }\n\n  private async runNestedTransaction<T>(\n    transaction: ExpoSQLiteTransaction,\n    transactionDriver: SQLiteDriver,\n    fn: (transactionDriver: SQLiteDriver) => Promise<T>,\n  ): Promise<T> {\n    const savepointName = `tsdb_sp_${this.nextSavepointId}`\n    this.nextSavepointId++\n    await transaction.execAsync(`SAVEPOINT ${savepointName}`)\n\n    try {\n      const result = await fn(transactionDriver)\n      await transaction.execAsync(`RELEASE SAVEPOINT ${savepointName}`)\n      return result\n    } catch (error) {\n      await transaction.execAsync(`ROLLBACK TO SAVEPOINT ${savepointName}`)\n      await transaction.execAsync(`RELEASE SAVEPOINT ${savepointName}`)\n      throw error\n    }\n  }\n}\n\nfunction normalizeParams(\n  params: ReadonlyArray<unknown>,\n): ExpoSQLiteBindParams | undefined {\n  return params.length > 0 ? [...params] : undefined\n}\n\nexport function createExpoSQLiteDriver(\n  options: ExpoSQLiteDriverOptions,\n): ExpoSQLiteDriver {\n  return new ExpoSQLiteDriver(options)\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/expo.d.ts

@@ -0,0 +1,11 @@
+import { PersistedCollectionCoordinator, PersistedCollectionPersistence, SQLiteCoreAdapterOptions } from '@tanstack/db-sqlite-persistence-core';
+import { ExpoSQLiteDatabaseLike } from './expo-sqlite-driver.js';
+export type { ExpoSQLiteDatabaseLike } from './expo-sqlite-driver.js';
+type ExpoSQLiteCoreSchemaMismatchPolicy = `sync-present-reset` | `sync-absent-error` | `reset`;
+export type ExpoSQLiteSchemaMismatchPolicy = ExpoSQLiteCoreSchemaMismatchPolicy | `throw`;
+export type ExpoSQLitePersistenceOptions = Omit<SQLiteCoreAdapterOptions, `driver` | `schemaVersion` | `schemaMismatchPolicy`> & {
+    database: ExpoSQLiteDatabaseLike;
+    coordinator?: PersistedCollectionCoordinator;
+    schemaMismatchPolicy?: ExpoSQLiteSchemaMismatchPolicy;
+};
+export declare function createExpoSQLitePersistence<T extends object, TKey extends string | number = string | number>(options: ExpoSQLitePersistenceOptions): PersistedCollectionPersistence<T, TKey>;

package/dist/esm/expo.js

@@ -0,0 +1,79 @@
+import { SingleProcessCoordinator, createSQLiteCorePersistenceAdapter } from "@tanstack/db-sqlite-persistence-core";
+import { ExpoSQLiteDriver } from "./expo-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 ExpoSQLiteDriver({
+    database: options.database
+  });
+}
+function resolveAdapterBaseOptions(options) {
+  return {
+    appliedTxPruneMaxRows: options.appliedTxPruneMaxRows,
+    appliedTxPruneMaxAgeSeconds: options.appliedTxPruneMaxAgeSeconds,
+    pullSinceReloadThreshold: options.pullSinceReloadThreshold
+  };
+}
+function createExpoSQLitePersistence(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 {
+  createExpoSQLitePersistence
+};
+//# sourceMappingURL=expo.js.map

package/dist/esm/expo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expo.js","sources":["../../src/expo.ts"],"sourcesContent":["import {\n  SingleProcessCoordinator,\n  createSQLiteCorePersistenceAdapter,\n} from '@tanstack/db-sqlite-persistence-core'\nimport { ExpoSQLiteDriver } from './expo-sqlite-driver'\nimport type {\n  PersistedCollectionCoordinator,\n  PersistedCollectionMode,\n  PersistedCollectionPersistence,\n  SQLiteCoreAdapterOptions,\n  SQLiteDriver,\n} from '@tanstack/db-sqlite-persistence-core'\nimport type { ExpoSQLiteDatabaseLike } from './expo-sqlite-driver'\n\nexport type { ExpoSQLiteDatabaseLike } from './expo-sqlite-driver'\n\ntype ExpoSQLiteCoreSchemaMismatchPolicy =\n  | `sync-present-reset`\n  | `sync-absent-error`\n  | `reset`\n\nexport type ExpoSQLiteSchemaMismatchPolicy =\n  | ExpoSQLiteCoreSchemaMismatchPolicy\n  | `throw`\n\nexport type ExpoSQLitePersistenceOptions = Omit<\n  SQLiteCoreAdapterOptions,\n  `driver` | `schemaVersion` | `schemaMismatchPolicy`\n> & {\n  database: ExpoSQLiteDatabaseLike\n  coordinator?: PersistedCollectionCoordinator\n  schemaMismatchPolicy?: ExpoSQLiteSchemaMismatchPolicy\n}\n\nfunction normalizeSchemaMismatchPolicy(\n  policy: ExpoSQLiteSchemaMismatchPolicy,\n): ExpoSQLiteCoreSchemaMismatchPolicy {\n  if (policy === `throw`) {\n    return `sync-absent-error`\n  }\n\n  return policy\n}\n\nfunction resolveSchemaMismatchPolicy(\n  explicitPolicy: ExpoSQLiteSchemaMismatchPolicy | undefined,\n  mode: PersistedCollectionMode,\n): ExpoSQLiteCoreSchemaMismatchPolicy {\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: ExpoSQLiteCoreSchemaMismatchPolicy,\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: ExpoSQLitePersistenceOptions,\n): SQLiteDriver {\n  return new ExpoSQLiteDriver({\n    database: options.database,\n  })\n}\n\nfunction resolveAdapterBaseOptions(\n  options: ExpoSQLitePersistenceOptions,\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 createExpoSQLitePersistence<\n  T extends object,\n  TKey extends string | number = string | number,\n>(\n  options: ExpoSQLitePersistenceOptions,\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":";;AAkCA,SAAS,8BACP,QACoC;AACpC,MAAI,WAAW,SAAS;AACtB,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEA,SAAS,4BACP,gBACA,MACoC;AACpC,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,iBAAiB;AAAA,IAC1B,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,4BAId,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;"}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+export { createExpoSQLitePersistence } from './expo.js';
+export type { ExpoSQLiteDatabaseLike, ExpoSQLitePersistenceOptions, ExpoSQLiteSchemaMismatchPolicy, } from './expo.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 { createExpoSQLitePersistence } from "./expo.js";
+import { persistedCollectionOptions } from "@tanstack/db-sqlite-persistence-core";
+export {
+  createExpoSQLitePersistence,
+  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/expo-db-sqlite-persistence",
+  "version": "0.1.2",
+  "description": "Expo 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/expo-db-sqlite-persistence"
+  },
+  "homepage": "https://tanstack.com/db",
+  "keywords": [
+    "sqlite",
+    "expo",
+    "expo-sqlite",
+    "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/expo-db-sqlite-persistence build && vitest --config vitest.e2e.config.ts --run",
+    "test:e2e:expo:ios": "pnpm --filter @tanstack/db-ivm build && pnpm --filter @tanstack/db build && pnpm --filter @tanstack/db-sqlite-persistence-core build && pnpm --filter @tanstack/expo-db-sqlite-persistence build && TANSTACK_DB_MOBILE_REQUIRE_RUNTIME_FACTORY=1 TANSTACK_DB_MOBILE_SQLITE_FACTORY_MODULE=./tests/helpers/expo-emulator-database-factory.ts TANSTACK_DB_EXPO_RUNTIME_PLATFORM=ios vitest --config vitest.e2e.config.ts --run",
+    "test:e2e:expo:android": "pnpm --filter @tanstack/db-ivm build && pnpm --filter @tanstack/db build && pnpm --filter @tanstack/db-sqlite-persistence-core build && pnpm --filter @tanstack/expo-db-sqlite-persistence build && TANSTACK_DB_MOBILE_REQUIRE_RUNTIME_FACTORY=1 TANSTACK_DB_MOBILE_SQLITE_FACTORY_MODULE=./tests/helpers/expo-emulator-database-factory.ts TANSTACK_DB_EXPO_RUNTIME_PLATFORM=android vitest --config vitest.e2e.config.ts --run"
+  },
+  "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"
+      }
+    },
+    "./expo-sqlite-driver": {
+      "import": {
+        "types": "./dist/esm/expo-sqlite-driver.d.ts",
+        "default": "./dist/esm/expo-sqlite-driver.js"
+      },
+      "require": {
+        "types": "./dist/cjs/expo-sqlite-driver.d.cts",
+        "default": "./dist/cjs/expo-sqlite-driver.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@tanstack/db-sqlite-persistence-core": "workspace:*"
+  },
+  "peerDependencies": {
+    "expo-sqlite": "^55.0.10",
+    "typescript": ">=4.7"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@vitest/coverage-istanbul": "^3.2.4",
+    "better-sqlite3": "^12.6.2"
+  }
+}

package/src/expo-sqlite-driver.ts

@@ -0,0 +1,238 @@
+import { InvalidPersistedCollectionConfigError } from '@tanstack/db-sqlite-persistence-core'
+import type { SQLiteDriver } from '@tanstack/db-sqlite-persistence-core'
+
+export type ExpoSQLiteBindParams =
+  | ReadonlyArray<unknown>
+  | Record<string, unknown>
+
+export type ExpoSQLiteRunResult = {
+  changes: number
+  lastInsertRowId: number
+}
+
+export type ExpoSQLiteQueryable = {
+  execAsync: (sql: string) => Promise<void>
+  getAllAsync: <T>(
+    sql: string,
+    params?: ExpoSQLiteBindParams,
+  ) => Promise<ReadonlyArray<T>>
+  runAsync: (
+    sql: string,
+    params?: ExpoSQLiteBindParams,
+  ) => Promise<ExpoSQLiteRunResult>
+}
+
+export type ExpoSQLiteTransaction = ExpoSQLiteQueryable
+
+export type ExpoSQLiteDatabaseLike = ExpoSQLiteQueryable & {
+  withExclusiveTransactionAsync: <T>(
+    task: (transaction: ExpoSQLiteTransaction) => Promise<T>,
+  ) => Promise<T>
+  closeAsync?: () => Promise<void>
+}
+
+type ExpoSQLiteExistingDatabaseOptions = {
+  database: ExpoSQLiteDatabaseLike
+}
+
+type ExpoSQLiteOpenDatabaseOptions = {
+  openDatabase: () => Promise<ExpoSQLiteDatabaseLike> | ExpoSQLiteDatabaseLike
+}
+
+export type ExpoSQLiteDriverOptions =
+  | ExpoSQLiteExistingDatabaseOptions
+  | ExpoSQLiteOpenDatabaseOptions
+
+function hasExistingDatabase(
+  options: ExpoSQLiteDriverOptions,
+): options is ExpoSQLiteExistingDatabaseOptions {
+  return `database` in options
+}
+
+function assertTransactionCallbackHasDriverArg(
+  fn: (transactionDriver: SQLiteDriver) => Promise<unknown>,
+): void {
+  if (fn.length > 0) {
+    return
+  }
+
+  throw new InvalidPersistedCollectionConfigError(
+    `SQLiteDriver.transaction callback must accept the transaction driver argument`,
+  )
+}
+
+function isExpoSQLiteDatabaseLike(
+  value: unknown,
+): value is ExpoSQLiteDatabaseLike {
+  return (
+    typeof value === `object` &&
+    value !== null &&
+    typeof (value as ExpoSQLiteDatabaseLike).execAsync === `function` &&
+    typeof (value as ExpoSQLiteDatabaseLike).getAllAsync === `function` &&
+    typeof (value as ExpoSQLiteDatabaseLike).runAsync === `function` &&
+    typeof (value as ExpoSQLiteDatabaseLike).withExclusiveTransactionAsync ===
+      `function`
+  )
+}
+
+export class ExpoSQLiteDriver implements SQLiteDriver {
+  private readonly databasePromise: Promise<ExpoSQLiteDatabaseLike>
+  private readonly ownsDatabase: boolean
+  private queue: Promise<void> = Promise.resolve()
+  private nextSavepointId = 1
+
+  constructor(options: ExpoSQLiteDriverOptions) {
+    if (hasExistingDatabase(options)) {
+      if (!isExpoSQLiteDatabaseLike(options.database)) {
+        throw new InvalidPersistedCollectionConfigError(
+          `Expo SQLite database must provide execAsync/getAllAsync/runAsync/withExclusiveTransactionAsync`,
+        )
+      }
+
+      this.databasePromise = Promise.resolve(options.database)
+      this.ownsDatabase = false
+      return
+    }
+
+    this.databasePromise = Promise.resolve(options.openDatabase()).then(
+      (database) => {
+        if (!isExpoSQLiteDatabaseLike(database)) {
+          throw new InvalidPersistedCollectionConfigError(
+            `Expo SQLite openDatabase() must resolve a database with execAsync/getAllAsync/runAsync/withExclusiveTransactionAsync`,
+          )
+        }
+
+        return database
+      },
+    )
+    this.ownsDatabase = true
+  }
+
+  async exec(sql: string): Promise<void> {
+    await this.enqueue(async () => {
+      const database = await this.getDatabase()
+      await database.execAsync(sql)
+    })
+  }
+
+  async query<T>(
+    sql: string,
+    params: ReadonlyArray<unknown> = [],
+  ): Promise<ReadonlyArray<T>> {
+    return this.enqueue(async () => {
+      const database = await this.getDatabase()
+      return database.getAllAsync<T>(sql, normalizeParams(params))
+    })
+  }
+
+  async run(sql: string, params: ReadonlyArray<unknown> = []): Promise<void> {
+    await this.enqueue(async () => {
+      const database = await this.getDatabase()
+      await database.runAsync(sql, normalizeParams(params))
+    })
+  }
+
+  async transaction<T>(
+    fn: (transactionDriver: SQLiteDriver) => Promise<T>,
+  ): Promise<T> {
+    assertTransactionCallbackHasDriverArg(fn)
+    return this.transactionWithDriver(fn)
+  }
+
+  async transactionWithDriver<T>(
+    fn: (transactionDriver: SQLiteDriver) => Promise<T>,
+  ): Promise<T> {
+    return this.enqueue(async () => {
+      const database = await this.getDatabase()
+      return database.withExclusiveTransactionAsync(async (transaction) => {
+        const transactionDriver = this.createTransactionDriver(transaction)
+        return fn(transactionDriver)
+      })
+    })
+  }
+
+  async close(): Promise<void> {
+    const database = await this.getDatabase()
+    if (!this.ownsDatabase || typeof database.closeAsync !== `function`) {
+      return
+    }
+
+    await database.closeAsync()
+  }
+
+  async getDatabase(): Promise<ExpoSQLiteDatabaseLike> {
+    return this.databasePromise
+  }
+
+  private enqueue<T>(operation: () => Promise<T>): Promise<T> {
+    const queuedOperation = this.queue.then(operation, operation)
+    this.queue = queuedOperation.then(
+      () => undefined,
+      () => undefined,
+    )
+    return queuedOperation
+  }
+
+  private createTransactionDriver(
+    transaction: ExpoSQLiteTransaction,
+  ): SQLiteDriver {
+    const transactionDriver: SQLiteDriver = {
+      exec: async (sql) => {
+        await transaction.execAsync(sql)
+      },
+      query: async <T>(
+        sql: string,
+        params: ReadonlyArray<unknown> = [],
+      ): Promise<ReadonlyArray<T>> => {
+        return transaction.getAllAsync<T>(sql, normalizeParams(params))
+      },
+      run: async (sql: string, params: ReadonlyArray<unknown> = []) => {
+        await transaction.runAsync(sql, normalizeParams(params))
+      },
+      transaction: async <T>(
+        fn: (nestedTransactionDriver: SQLiteDriver) => Promise<T>,
+      ): Promise<T> => {
+        assertTransactionCallbackHasDriverArg(fn)
+        return this.runNestedTransaction(transaction, transactionDriver, fn)
+      },
+      transactionWithDriver: async <T>(
+        fn: (nestedTransactionDriver: SQLiteDriver) => Promise<T>,
+      ): Promise<T> =>
+        this.runNestedTransaction(transaction, transactionDriver, fn),
+    }
+
+    return transactionDriver
+  }
+
+  private async runNestedTransaction<T>(
+    transaction: ExpoSQLiteTransaction,
+    transactionDriver: SQLiteDriver,
+    fn: (transactionDriver: SQLiteDriver) => Promise<T>,
+  ): Promise<T> {
+    const savepointName = `tsdb_sp_${this.nextSavepointId}`
+    this.nextSavepointId++
+    await transaction.execAsync(`SAVEPOINT ${savepointName}`)
+
+    try {
+      const result = await fn(transactionDriver)
+      await transaction.execAsync(`RELEASE SAVEPOINT ${savepointName}`)
+      return result
+    } catch (error) {
+      await transaction.execAsync(`ROLLBACK TO SAVEPOINT ${savepointName}`)
+      await transaction.execAsync(`RELEASE SAVEPOINT ${savepointName}`)
+      throw error
+    }
+  }
+}
+
+function normalizeParams(
+  params: ReadonlyArray<unknown>,
+): ExpoSQLiteBindParams | undefined {
+  return params.length > 0 ? [...params] : undefined
+}
+
+export function createExpoSQLiteDriver(
+  options: ExpoSQLiteDriverOptions,
+): ExpoSQLiteDriver {
+  return new ExpoSQLiteDriver(options)
+}

package/src/expo.ts

@@ -0,0 +1,159 @@
+import {
+  SingleProcessCoordinator,
+  createSQLiteCorePersistenceAdapter,
+} from '@tanstack/db-sqlite-persistence-core'
+import { ExpoSQLiteDriver } from './expo-sqlite-driver'
+import type {
+  PersistedCollectionCoordinator,
+  PersistedCollectionMode,
+  PersistedCollectionPersistence,
+  SQLiteCoreAdapterOptions,
+  SQLiteDriver,
+} from '@tanstack/db-sqlite-persistence-core'
+import type { ExpoSQLiteDatabaseLike } from './expo-sqlite-driver'
+
+export type { ExpoSQLiteDatabaseLike } from './expo-sqlite-driver'
+
+type ExpoSQLiteCoreSchemaMismatchPolicy =
+  | `sync-present-reset`
+  | `sync-absent-error`
+  | `reset`
+
+export type ExpoSQLiteSchemaMismatchPolicy =
+  | ExpoSQLiteCoreSchemaMismatchPolicy
+  | `throw`
+
+export type ExpoSQLitePersistenceOptions = Omit<
+  SQLiteCoreAdapterOptions,
+  `driver` | `schemaVersion` | `schemaMismatchPolicy`
+> & {
+  database: ExpoSQLiteDatabaseLike
+  coordinator?: PersistedCollectionCoordinator
+  schemaMismatchPolicy?: ExpoSQLiteSchemaMismatchPolicy
+}
+
+function normalizeSchemaMismatchPolicy(
+  policy: ExpoSQLiteSchemaMismatchPolicy,
+): ExpoSQLiteCoreSchemaMismatchPolicy {
+  if (policy === `throw`) {
+    return `sync-absent-error`
+  }
+
+  return policy
+}
+
+function resolveSchemaMismatchPolicy(
+  explicitPolicy: ExpoSQLiteSchemaMismatchPolicy | undefined,
+  mode: PersistedCollectionMode,
+): ExpoSQLiteCoreSchemaMismatchPolicy {
+  if (explicitPolicy) {
+    return normalizeSchemaMismatchPolicy(explicitPolicy)
+  }
+
+  return mode === `sync-present` ? `sync-present-reset` : `sync-absent-error`
+}
+
+function createAdapterCacheKey(
+  schemaMismatchPolicy: ExpoSQLiteCoreSchemaMismatchPolicy,
+  schemaVersion: number | undefined,
+): string {
+  const schemaVersionKey =
+    schemaVersion === undefined ? `schema:default` : `schema:${schemaVersion}`
+  return `${schemaMismatchPolicy}|${schemaVersionKey}`
+}
+
+function createInternalSQLiteDriver(
+  options: ExpoSQLitePersistenceOptions,
+): SQLiteDriver {
+  return new ExpoSQLiteDriver({
+    database: options.database,
+  })
+}
+
+function resolveAdapterBaseOptions(
+  options: ExpoSQLitePersistenceOptions,
+): Omit<
+  SQLiteCoreAdapterOptions,
+  `driver` | `schemaVersion` | `schemaMismatchPolicy`
+> {
+  return {
+    appliedTxPruneMaxRows: options.appliedTxPruneMaxRows,
+    appliedTxPruneMaxAgeSeconds: options.appliedTxPruneMaxAgeSeconds,
+    pullSinceReloadThreshold: options.pullSinceReloadThreshold,
+  }
+}
+
+export function createExpoSQLitePersistence<
+  T extends object,
+  TKey extends string | number = string | number,
+>(
+  options: ExpoSQLitePersistenceOptions,
+): 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),
+  }
+}

package/src/index.ts

@@ -0,0 +1,11 @@
+export { createExpoSQLitePersistence } from './expo'
+export type {
+  ExpoSQLiteDatabaseLike,
+  ExpoSQLitePersistenceOptions,
+  ExpoSQLiteSchemaMismatchPolicy,
+} from './expo'
+export { persistedCollectionOptions } from '@tanstack/db-sqlite-persistence-core'
+export type {
+  PersistedCollectionCoordinator,
+  PersistedCollectionPersistence,
+} from '@tanstack/db-sqlite-persistence-core'