@chipmobilesdk/rn-local-db 0.4.0 → 0.5.0

package/lib/commonjs/adapter/deletion.js

@@ -0,0 +1,291 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.clearAllInvalidations = clearAllInvalidations;
+exports.clearScopeInvalidation = clearScopeInvalidation;
+exports.deleteDatabase = deleteDatabase;
+exports.deleteScopeData = deleteScopeData;
+exports.emptyOutcome = emptyOutcome;
+exports.isScopeInvalidated = isScopeInvalidated;
+exports.markScopeInvalidated = markScopeInvalidated;
+exports.registerOpenHandle = registerOpenHandle;
+exports.resetScope = resetScope;
+var _fs = require("../platform/fs.js");
+var _location = require("../platform/location.js");
+var _paths = require("../artifacts/paths.js");
+var _keyProvider = require("../crypto/key-provider.js");
+var _compare = require("../query/compare.js");
+var _validate = require("../scope/validate.js");
+var _catalog = require("../sqlite/catalog.js");
+var _connection = require("../sqlite/connection.js");
+var _values = require("../sqlite/values.js");
+/**
+ * Deletion, and the ordering that makes an interrupted one visible.
+ *
+ * These are module-level functions rather than handle methods because they
+ * must work whether or not a handle is open on the target (FR-059) — a
+ * sign-out that already closed the handle still has to be able to delete, and
+ * an app recovering from a crash has no handle to call a method on.
+ *
+ * The order is: **mark `deleting` first, clear the catalog row last**
+ * (FR-061, FR-063). A crash at any point in between leaves the flag set, so
+ * the next open reports a scope mid-deletion rather than presenting it as
+ * complete. Clearing the row first would be the natural way to write this and
+ * would produce exactly the failure FR-063 exists to prevent: an
+ * interruption that looks like a success, leaving a user's data on disk after
+ * they asked for it to be gone.
+ *
+ * Nothing here ever runs on its own. No expiry, no sweep, no deletion on
+ * close or on app upgrade (FR-058) — the package deletes when asked, where
+ * asked, and not otherwise.
+ */
+
+/**
+ * Scopes deleted beneath a handle that is still open.
+ *
+ * FR-059a wants the handle to report `SCOPE_DELETED` rather than keep
+ * answering from a database that no longer exists — and wants the deletion to
+ * proceed rather than wait for the handle to be closed. A shared set is the
+ * whole mechanism: the deleter records, the handle checks.
+ */
+const invalidated = new Set();
+function invalidationKey(name, scopeKey) {
+  return `${name}:${scopeKey}`;
+}
+function markScopeInvalidated(name, scopeKey) {
+  invalidated.add(invalidationKey(name, scopeKey));
+}
+function clearScopeInvalidation(name, scopeKey) {
+  invalidated.delete(invalidationKey(name, scopeKey));
+}
+function isScopeInvalidated(name, scopeKey) {
+  return invalidated.has(invalidationKey(name, scopeKey));
+}
+function clearAllInvalidations() {
+  invalidated.clear();
+  openHandles.clear();
+}
+
+/**
+ * Handles open on a scope, so a deletion can take their connection away
+ * (LDB-14). Marking alone left the native connection and its handle slot held
+ * until the app closed a handle it had been told was dead: eight sign-outs
+ * later every open failed, with the unlinked file still pinned by its
+ * descriptor.
+ */
+const openHandles = new Map();
+
+/** Returns the function that takes the handle out of the registry again. */
+function registerOpenHandle(name, scopeKey, revoke) {
+  const key = invalidationKey(name, scopeKey);
+  const handles = openHandles.get(key) ?? new Set();
+  handles.add(revoke);
+  openHandles.set(key, handles);
+  return () => {
+    handles.delete(revoke);
+    if (handles.size === 0) {
+      openHandles.delete(key);
+    }
+  };
+}
+
+/** Every handle on the scope, or on any scope of the database when none is named. */
+async function revokeHandles(name, scopeKey) {
+  const prefix = `${name}:`;
+  for (const [key, handles] of [...openHandles]) {
+    const matches = scopeKey === undefined ? key.startsWith(prefix) : key === invalidationKey(name, scopeKey);
+    if (!matches) {
+      continue;
+    }
+    openHandles.delete(key);
+    for (const revoke of handles) {
+      // A connection that will not close does not get to stop a deletion.
+      await revoke().catch(() => undefined);
+    }
+  }
+}
+
+/** Deleting a scope that holds nothing is success, not an error (FR-062). */
+function emptyOutcome(scope) {
+  return {
+    ...(scope ? {
+      scopeKey: scope.key
+    } : {}),
+    removedRecords: 0,
+    removedArtifacts: [],
+    orphanedReferences: [],
+    failedRemovals: []
+  };
+}
+
+/**
+ * How many records the scope held, best effort.
+ *
+ * Best effort because an encrypted scope whose caller supplied no key cannot
+ * be opened to be counted — and refusing to delete it on that basis would be
+ * the worst possible answer to a deletion request. The files come off disk
+ * either way; only the number in the report is unavailable.
+ */
+async function countRecords(layout, scopeKey, encryptionKey) {
+  let connection = null;
+  try {
+    connection = await (0, _connection.openConnection)({
+      path: layout.scopeDataPath(scopeKey),
+      ...(encryptionKey ? {
+        encryptionKey
+      } : {})
+    });
+    const tables = await connection.execute("SELECT name FROM sqlite_master WHERE type = 'table' AND name LIKE 'c!_%' ESCAPE '!'");
+    let total = 0;
+    for (const row of tables.rows) {
+      const table = (0, _values.text)(row.name);
+      const counted = await connection.execute(`SELECT count(*) AS total FROM "${table}"`);
+      total += (0, _values.num)(counted.rows[0]?.total ?? 0);
+    }
+    return total;
+  } catch {
+    // Unknown, not zero: a report that said "0 records" about a scope it
+    // could not open would understate what was deleted.
+    return undefined;
+  } finally {
+    await connection?.close();
+  }
+}
+async function artifactIdsOnDisk(layout, scopeKey) {
+  try {
+    return (await (0, _fs.fileSystem)().readdir((0, _paths.artifactsDirectory)(layout, scopeKey))).sort(_compare.byteOrder);
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * The one implementation behind `deleteScopeData` and `resetScope`.
+ *
+ * They do the same thing to disk and mean entirely different things to the
+ * caller: one is a lifecycle operation an app performs on request, the other
+ * is an admission that a database is broken and is being discarded to recover
+ * from it (FR-057a). Keeping them as two exported names with two docstrings
+ * is what stops the destructive one from being reached by accident — there is
+ * no path from `openDatabase` to either.
+ */
+async function removeScope(config) {
+  const scope = (0, _validate.resolveScope)(config.scope);
+  const layout = (0, _location.layoutFor)(config.name);
+  const catalog = await (0, _connection.openConnection)({
+    path: layout.catalogPath
+  });
+  try {
+    await (0, _catalog.ensureCatalog)(catalog);
+    const entry = await (0, _catalog.readEntry)(catalog, scope.key);
+
+    // Mark first. Everything after this point is recoverable-in-principle;
+    // this flag is what makes an interruption visible rather than silent.
+    if (entry) {
+      await (0, _catalog.markDeleting)(catalog, scope.key);
+    }
+    markScopeInvalidated(config.name, scope.key);
+    // Before the files go: a connection still open on them pins them.
+    await revokeHandles(config.name, scope.key);
+    const removedArtifacts = await artifactIdsOnDisk(layout, scope.key);
+
+    // The key is needed to count what is being removed, not to remove it,
+    // so a key provider that fails — or a key already destroyed for this
+    // identity, which FR-104 encourages — costs the count, never the
+    // deletion. Until 0.2.0 it failed the whole call after the scope was
+    // already marked, leaving it stuck in `deleting`.
+    let keyHandle = null;
+    if (config.encryption?.enabled) {
+      try {
+        keyHandle = await (0, _keyProvider.acquireKey)(config.encryption, scope);
+      } catch {
+        keyHandle = null;
+      }
+    }
+    let counted;
+    try {
+      counted = config.encryption?.enabled && keyHandle === null ? undefined : await countRecords(layout, scope.key, keyHandle?.value());
+    } finally {
+      keyHandle?.release();
+    }
+    const failedRemovals = [];
+    if (!(await (0, _fs.removeIfPresent)(layout.scopePath(scope.key))) && entry) {
+      // The directory was there and would not go. Reporting it is the
+      // point: an app that told the user "deleted" would be wrong.
+      const stillThere = await (0, _fs.fileSystem)().exists(layout.scopePath(scope.key)).catch(() => false);
+      if (stillThere) {
+        failedRemovals.push(scope.key);
+      }
+    }
+    if (failedRemovals.length === 0) {
+      // Cleared last, on purpose.
+      await (0, _catalog.clearScope)(catalog, scope.key);
+    }
+    return {
+      scopeKey: scope.key,
+      removedRecords: counted ?? 0,
+      ...(counted === undefined ? {
+        recordCountUnavailable: true
+      } : {}),
+      removedArtifacts,
+      orphanedReferences: [],
+      failedRemovals
+    };
+  } finally {
+    await catalog.close();
+  }
+}
+
+/**
+ * Remove one scope's data. Every collection in that scope, and nothing
+ * outside it (FR-059, SC-012).
+ */
+function deleteScopeData(config) {
+  return removeScope(config);
+}
+
+/**
+ * Discard one scope and leave it ready for a clean first-run migration
+ * (FR-057a).
+ *
+ * Destructive, separately named, and never reachable from `openDatabase`. An
+ * automatic fallback here would turn a bad migration shipped to production
+ * into silent data loss for every user who launched the app.
+ */
+function resetScope(config) {
+  return removeScope(config);
+}
+
+/** Remove the whole database directory: catalog, every scope, every artifact. */
+async function deleteDatabase(config) {
+  const layout = (0, _location.layoutFor)(config.name);
+  let scopeKeys = [];
+  try {
+    const catalog = await (0, _connection.openConnection)({
+      path: layout.catalogPath
+    });
+    try {
+      await (0, _catalog.ensureCatalog)(catalog);
+      scopeKeys = (await (0, _catalog.listEntries)(catalog)).map(entry => entry.scopeKey);
+    } finally {
+      await catalog.close();
+    }
+  } catch {
+    // No catalog means nothing was ever registered here. The directory
+    // removal below is still the right thing to attempt.
+  }
+  for (const scopeKey of scopeKeys) {
+    markScopeInvalidated(config.name, scopeKey);
+  }
+  await revokeHandles(config.name);
+  const removed = await (0, _fs.removeIfPresent)(layout.root);
+  return {
+    removedRecords: 0,
+    removedArtifacts: [],
+    orphanedReferences: [],
+    failedRemovals: removed || scopeKeys.length === 0 ? [] : scopeKeys
+  };
+}
+//# sourceMappingURL=deletion.js.map

package/lib/commonjs/adapter/deletion.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_fs","require","_location","_paths","_keyProvider","_compare","_validate","_catalog","_connection","_values","invalidated","Set","invalidationKey","name","scopeKey","markScopeInvalidated","add","clearScopeInvalidation","delete","isScopeInvalidated","has","clearAllInvalidations","clear","openHandles","Map","registerOpenHandle","revoke","key","handles","get","set","size","revokeHandles","prefix","matches","undefined","startsWith","catch","emptyOutcome","scope","removedRecords","removedArtifacts","orphanedReferences","failedRemovals","countRecords","layout","encryptionKey","connection","openConnection","path","scopeDataPath","tables","execute","total","row","rows","table","text","counted","num","close","artifactIdsOnDisk","fileSystem","readdir","artifactsDirectory","sort","byteOrder","removeScope","config","resolveScope","layoutFor","catalog","catalogPath","ensureCatalog","entry","readEntry","markDeleting","keyHandle","encryption","enabled","acquireKey","value","release","removeIfPresent","scopePath","stillThere","exists","push","length","clearScope","recordCountUnavailable","deleteScopeData","resetScope","deleteDatabase","scopeKeys","listEntries","map","removed","root"],"sourceRoot":"../../../src","sources":["adapter/deletion.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/adapter/handle.js

@@ -0,0 +1,259 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildHandle = buildHandle;
+exports.schemaFor = schemaFor;
+var _errors = require("../contract/errors.js");
+var _availability = require("../artifacts/availability.js");
+var _cascade = require("../artifacts/cascade.js");
+var _reconcile = require("../artifacts/reconcile.js");
+var _store = require("../artifacts/store.js");
+var _derive = require("../crypto/derive.js");
+var _errors2 = require("../diagnostics/errors.js");
+var _devLog = require("../diagnostics/dev-log.js");
+var _faults = require("../diagnostics/faults.js");
+var _sort = require("../query/sort.js");
+var _batch = require("../sqlite/batch.js");
+var _indexCoverage = require("../sqlite/index-coverage.js");
+var _transactions = require("../sqlite/transactions.js");
+var _budgets = require("./budgets.js");
+var _collection = require("./collection.js");
+var _deletion = require("./deletion.js");
+var _transaction = require("./transaction.js");
+/**
+ * The handle an open returns: collections, transactions, batches and
+ * attachments over one connection, bound to one scope.
+ *
+ * Scope is bound here and nowhere else. The handle carries its scope key and
+ * no operation on it accepts a scope argument, so there is no `switchScope`
+ * to misuse and no read that could address another scope (FR-008a, FR-015).
+ */
+
+function schemaFor(schemas, name) {
+  const schema = schemas.get(name);
+  if (!schema) {
+    (0, _errors2.raise)(_errors.DiagnosticCodes.CONFIG_INVALID, {
+      message: 'collection is not declared',
+      detail: {
+        collection: name
+      }
+    });
+  }
+  return schema;
+}
+function buildHandle(context) {
+  const {
+    config,
+    connection,
+    layout,
+    scope,
+    schemas
+  } = context;
+  let closed = false;
+  // Set when a deletion took the connection away rather than the app closing it.
+  let revoked = false;
+  const releaseNative = async () => {
+    // The key goes first: a close that fails at the filesystem must not
+    // leave key material alive in a handle nobody can use (FR-098).
+    context.key?.release();
+    await connection.close();
+    (0, _budgets.releaseHandleSlot)();
+  };
+  const unregister = (0, _deletion.registerOpenHandle)(config.name, scope.key, async () => {
+    if (closed) {
+      return;
+    }
+    closed = true;
+    revoked = true;
+    await releaseNative();
+  });
+  const assertUsable = () => {
+    if (closed && !revoked) {
+      (0, _errors2.raise)(_errors.DiagnosticCodes.CLOSED_HANDLE, {
+        message: 'handle is closed'
+      });
+    }
+    if (revoked || (0, _deletion.isScopeInvalidated)(config.name, scope.key)) {
+      // The deletion did not wait for this handle, and this handle does
+      // not get to keep answering from data that is gone (FR-059a).
+      (0, _errors2.raise)(_errors.DiagnosticCodes.SCOPE_DELETED, {
+        message: 'scope was deleted beneath this handle',
+        detail: {
+          scopeKey: scope.key
+        }
+      });
+    }
+  };
+
+  // Everything below is built against an explicit executor: the connection for
+  // the handle, the transaction's own executor inside `transaction`. Nothing
+  // infers which one from the connection's state, which is how a write from
+  // outside used to be swallowed by an in-flight transaction (LDB-01).
+  const artifactsOn = executor => ({
+    executor: () => executor,
+    layout,
+    scopeKey: scope.key,
+    artifactKey: attachmentId => context.key ? (0, _derive.deriveArtifactKey)(context.key.value(), scope.key, attachmentId) : null,
+    now: context.now
+  });
+  const rawCollection = (name, executor) => {
+    assertUsable();
+    return (0, _devLog.instrument)(name, 'sqlite', (0, _collection.createSqlCollection)({
+      executor: () => executor,
+      schema: schemaFor(schemas, name),
+      now: context.now,
+      assertUsable
+    }));
+  };
+
+  /**
+   * Record deletion optionally takes its artifacts with it (FR-070).
+   *
+   * Off unless the app asks: a package that deleted a user's files as a side
+   * effect of a record delete would be making a decision that is not its to
+   * make. The outcome carries what was removed and what could not be.
+   */
+  const collectionOn = (name, executor, deferred) => {
+    const ops = rawCollection(name, executor);
+    if (config.cascadeAttachments !== true) {
+      return ops;
+    }
+    return {
+      ...ops,
+      async delete(id) {
+        const outcome = await ops.delete(id);
+        const cascade = await (0, _cascade.cascadeForOwner)(artifactsOn(executor), executor, {
+          collection: name,
+          id
+        }, deferred);
+        return {
+          ...outcome,
+          cascade
+        };
+      }
+    };
+  };
+  const attachmentsOn = (executor, deferred) => {
+    const artifacts = artifactsOn(executor);
+    return {
+      write(input) {
+        assertUsable();
+        return (0, _store.writeArtifact)(artifacts, input);
+      },
+      read(id, range) {
+        assertUsable();
+        return (0, _store.readArtifact)(artifacts, id, range);
+      },
+      availability(id) {
+        assertUsable();
+        return (0, _availability.artifactAvailability)(artifacts, executor, id);
+      },
+      remove(id) {
+        assertUsable();
+        return (0, _store.removeArtifact)(artifacts, id, deferred);
+      },
+      listFor(owner) {
+        assertUsable();
+        return (0, _store.listReferencesFor)(executor, owner);
+      },
+      reconcile(options) {
+        assertUsable();
+        return (0, _reconcile.reconcileArtifacts)(artifacts, executor, options);
+      }
+    };
+  };
+  const collectionFor = name => collectionOn(name, connection);
+  const attachments = attachmentsOn(connection);
+  const handle = {
+    scopeKey: scope.key,
+    schemaVersion: context.schemaVersion,
+    backupPosture: context.posture,
+    isEncrypted: context.key !== null,
+    collection: collectionFor,
+    async transaction(fn) {
+      assertUsable();
+      const pendingUnlinks = [];
+      const deferred = {
+        add: path => pendingUnlinks.push(path)
+      };
+      let aborted = false;
+      const result = await (0, _transactions.runInTransaction)(connection, async tx => {
+        const managed = (0, _transaction.createTransaction)({
+          collection: name => collectionOn(name, tx, deferred),
+          attachments: () => attachmentsOn(tx, deferred),
+          rollback: async () => {
+            aborted = true;
+            await tx.rollback();
+          }
+        });
+        const value = await fn(managed.transaction);
+        if (!managed.isSettled()) {
+          (0, _faults.throwIfFaulted)('commit');
+        }
+        managed.settle();
+        return value;
+      });
+      // Committed (a thrown body never gets here). Only now are files whose
+      // references the transaction deleted safe to remove; one that cannot be
+      // removed stays on disk as an orphan reconciliation reports.
+      if (!aborted) {
+        for (const path of pendingUnlinks) {
+          await (0, _cascade.unlinkArtifact)(path);
+        }
+      }
+      return result;
+    },
+    async batch(operations) {
+      assertUsable();
+      const outcome = await (0, _batch.runBatch)({
+        connection,
+        schemaFor: name => schemaFor(schemas, name),
+        now: context.now
+      }, operations);
+      if (config.cascadeAttachments !== true) {
+        return outcome;
+      }
+      // The batch has committed, so its hard deletes cascade exactly as a
+      // collection delete does. Skipping them left every attachment of a
+      // batch-deleted record behind as an orphan.
+      const artifacts = artifactsOn(connection);
+      const outcomes = [];
+      for (const [index, operation] of operations.entries()) {
+        const written = outcome.outcomes[index];
+        if (operation.type !== 'delete') {
+          outcomes.push(written);
+          continue;
+        }
+        const cascade = await (0, _cascade.cascadeForOwner)(artifacts, connection, {
+          collection: operation.collection,
+          id: operation.id
+        });
+        outcomes.push({
+          ...written,
+          cascade
+        });
+      }
+      return {
+        ...outcome,
+        outcomes
+      };
+    },
+    attachments: () => attachments,
+    explain(collection, query) {
+      assertUsable();
+      return (0, _indexCoverage.explainQuery)(connection, schemaFor(schemas, collection), query, (0, _sort.withStableTiebreaker)(query?.sort));
+    },
+    async close() {
+      if (closed) {
+        return;
+      }
+      closed = true;
+      unregister();
+      await releaseNative();
+    }
+  };
+  return handle;
+}
+//# sourceMappingURL=handle.js.map

package/lib/commonjs/adapter/handle.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_errors","require","_availability","_cascade","_reconcile","_store","_derive","_errors2","_devLog","_faults","_sort","_batch","_indexCoverage","_transactions","_budgets","_collection","_deletion","_transaction","schemaFor","schemas","name","schema","get","raise","DiagnosticCodes","CONFIG_INVALID","message","detail","collection","buildHandle","context","config","connection","layout","scope","closed","revoked","releaseNative","key","release","close","releaseHandleSlot","unregister","registerOpenHandle","assertUsable","CLOSED_HANDLE","isScopeInvalidated","SCOPE_DELETED","scopeKey","artifactsOn","executor","artifactKey","attachmentId","deriveArtifactKey","value","now","rawCollection","instrument","createSqlCollection","collectionOn","deferred","ops","cascadeAttachments","delete","id","outcome","cascade","cascadeForOwner","attachmentsOn","artifacts","write","input","writeArtifact","read","range","readArtifact","availability","artifactAvailability","remove","removeArtifact","listFor","owner","listReferencesFor","reconcile","options","reconcileArtifacts","collectionFor","attachments","handle","schemaVersion","backupPosture","posture","isEncrypted","transaction","fn","pendingUnlinks","add","path","push","aborted","result","runInTransaction","tx","managed","createTransaction","rollback","isSettled","throwIfFaulted","settle","unlinkArtifact","batch","operations","runBatch","outcomes","index","operation","entries","written","type","explain","query","explainQuery","withStableTiebreaker","sort"],"sourceRoot":"../../../src","sources":["adapter/handle.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/adapter/index.js

@@ -0,0 +1,67 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.deleteDatabase = deleteDatabase;
+exports.deleteScopeData = deleteScopeData;
+exports.openDatabase = openDatabase;
+exports.resetScope = resetScope;
+exports.setStorageAdapter = setStorageAdapter;
+/**
+ * The public lifecycle functions.
+ *
+ * Scope deletion and reset are module-level rather than handle methods: they
+ * must work whether or not a handle is open on the target (FR-059), and
+ * `resetScope` in particular must never be reachable as a fallback from
+ * `openDatabase` (FR-057a).
+ *
+ * The active adapter is resolved lazily so a consuming app that only ever
+ * uses the in-memory adapter in tests never loads the native peers.
+ */
+
+let override = null;
+let cached = null;
+
+/**
+ * Swap the adapter. Intended for tests and for the demo app's in-memory
+ * mode; production code never calls this.
+ */
+function setStorageAdapter(adapter) {
+  override = adapter;
+}
+function activeAdapter() {
+  if (override) {
+    return override;
+  }
+  if (!cached) {
+    // Lazy require, matching how rn-auth and rn-camera reach their native
+    // peers: importing at module scope would pull op-sqlite into every
+    // consumer, including ones that only run the in-memory adapter.
+    const {
+      createSqliteAdapter
+    } = require('../sqlite/adapter');
+    cached = createSqliteAdapter();
+  }
+  return cached;
+}
+function openDatabase(config) {
+  return activeAdapter().open(config);
+}
+function deleteScopeData(config) {
+  return activeAdapter().deleteScopeData(config);
+}
+function deleteDatabase(config) {
+  return activeAdapter().deleteDatabase(config);
+}
+
+/**
+ * Destructive. Discards one scope's data and leaves it ready for a clean
+ * first-run migration. Named apart from `deleteScopeData` deliberately: one
+ * is a lifecycle operation, the other is an admission that a database is
+ * broken.
+ */
+function resetScope(config) {
+  return activeAdapter().resetScope(config);
+}
+//# sourceMappingURL=index.js.map

package/lib/commonjs/adapter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["override","cached","setStorageAdapter","adapter","activeAdapter","createSqliteAdapter","require","openDatabase","config","open","deleteScopeData","deleteDatabase","resetScope"],"sourceRoot":"../../../src","sources":["adapter/index.ts"],"mappings":";;;;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA,IAAIA,QAA+B,GAAG,IAAI;AAC1C,IAAIC,MAA6B,GAAG,IAAI;;AAExC;AACA;AACA;AACA;AACO,SAASC,iBAAiBA,CAACC,OAA8B,EAAQ;EACvEH,QAAQ,GAAGG,OAAO;AACnB;AAEA,SAASC,aAAaA,CAAA,EAAmB;EACxC,IAAIJ,QAAQ,EAAE;IACb,OAAOA,QAAQ;EAChB;EACA,IAAI,CAACC,MAAM,EAAE;IACZ;IACA;IACA;IACA,MAAM;MAAEI;IAAoB,CAAC,GAAGC,OAAO,CAAC,mBAAmB,CAE1D;IACDL,MAAM,GAAGI,mBAAmB,CAAC,CAAC;EAC/B;EACA,OAAOJ,MAAM;AACd;AAEO,SAASM,YAAYA,CAACC,MAAsB,EAA2B;EAC7E,OAAOJ,aAAa,CAAC,CAAC,CAACK,IAAI,CAACD,MAAM,CAAC;AACpC;AAEO,SAASE,eAAeA,CAACF,MAAyB,EAA4B;EACpF,OAAOJ,aAAa,CAAC,CAAC,CAACM,eAAe,CAACF,MAAM,CAAC;AAC/C;AAEO,SAASG,cAAcA,CAACH,MAA4B,EAA4B;EACtF,OAAOJ,aAAa,CAAC,CAAC,CAACO,cAAc,CAACH,MAAM,CAAC;AAC9C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASI,UAAUA,CAACJ,MAAyB,EAA4B;EAC/E,OAAOJ,aAAa,CAAC,CAAC,CAACQ,UAAU,CAACJ,MAAM,CAAC;AAC1C","ignoreList":[]}