@chipmobilesdk/rn-local-db 0.3.0 → 0.5.0

package/lib/commonjs/testing/memory-adapter/index.js

@@ -0,0 +1,366 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "Budgets", {
+  enumerable: true,
+  get: function () {
+    return _config.Budgets;
+  }
+});
+Object.defineProperty(exports, "activeFaults", {
+  enumerable: true,
+  get: function () {
+    return _faults.activeFaults;
+  }
+});
+exports.createMemoryAdapter = createMemoryAdapter;
+var _transactionQueue = require("../../sqlite/transaction-queue.js");
+var _errors = require("../../contract/errors.js");
+var _keyProvider = require("../../crypto/key-provider.js");
+var _devLog = require("../../diagnostics/dev-log.js");
+var _errors2 = require("../../diagnostics/errors.js");
+var _budgets = require("../../query/budgets.js");
+var _validateConfig = require("../../schema/validate-config.js");
+var _validate = require("../../scope/validate.js");
+var _migrations = require("./migrations.js");
+var _collection = require("./collection.js");
+var _store = require("./store.js");
+var _attachments = require("./attachments.js");
+var _faults = require("../faults.js");
+var _config = require("../../contract/config.js");
+/**
+ * The in-memory adapter.
+ *
+ * Not a convenience: op-sqlite is native and unreachable from Jest, so this
+ * is the only way the package's own guarantees are testable in CI
+ * (research.md R8). Documented divergences are listed in the package README.
+ */
+
+function schemaIndex(collections) {
+  return new Map(collections.map(collection => [collection.name, collection]));
+}
+function cloneCollections(store) {
+  const copy = new Map();
+  for (const [name, rows] of store.collections) {
+    copy.set(name, new Map([...rows].map(([id, row]) => [id, {
+      ...row
+    }])));
+  }
+  return copy;
+}
+function createMemoryAdapter(options = {}) {
+  const now = options.now ?? (() => Date.now());
+  async function open(config) {
+    (0, _validateConfig.validateConfig)(config);
+    (0, _faults.throwIfFaulted)('open');
+    const scope = (0, _validate.resolveScope)(config.scope);
+    const existing = (0, _store.existingScopeStore)(config.name, scope.key);
+    if (existing?.deletionState === 'deleting') {
+      // A deletion that was interrupted must never look complete.
+      (0, _errors2.raise)(_errors.DiagnosticCodes.SCOPE_DELETED, {
+        message: 'scope deletion was interrupted',
+        detail: {
+          scopeKey: scope.key
+        }
+      });
+    }
+    const store = (0, _store.scopeStoreFor)(config.name, scope.key);
+    const encryptionRequested = config.encryption?.enabled === true;
+    if (store.schemaVersion > 0 && store.encrypted !== encryptionRequested) {
+      (0, _errors2.raise)(_errors.DiagnosticCodes.ENCRYPTION_MISMATCH, {
+        message: 'encryption posture does not match the stored database'
+      });
+    }
+    if (encryptionRequested) {
+      // The same acquisition path the on-device adapter uses, so a locked
+      // keychain and a provider returning nothing stay as distinguishable
+      // here as they are on a phone (SC-020b). Released immediately: the
+      // in-memory store has nothing to encrypt with it.
+      const key = await (0, _keyProvider.acquireKey)(config.encryption, scope);
+      key.release();
+    }
+    store.encrypted = encryptionRequested;
+    store.backupIncluded = config.backup?.includeInPlatformBackup === true;
+    const schemas = schemaIndex(config.collections);
+    for (const collection of config.collections) {
+      (0, _store.collectionMap)(store, collection.name);
+    }
+    await (0, _migrations.runMigrations)(store, config, now);
+    let closed = false;
+    const assertOpen = () => {
+      if (closed) {
+        (0, _errors2.raise)(_errors.DiagnosticCodes.CLOSED_HANDLE, {
+          message: 'handle is closed'
+        });
+      }
+      if (store.deletionState === 'deleting') {
+        (0, _errors2.raise)(_errors.DiagnosticCodes.SCOPE_DELETED, {
+          message: 'scope was deleted beneath this handle',
+          detail: {
+            scopeKey: scope.key
+          }
+        });
+      }
+    };
+
+    /**
+     * The same isolation the SQLite connection gives: a transaction holds the
+     * handle until it settles, and work through the handle meanwhile waits
+     * rather than landing inside the transaction's snapshot and vanishing
+     * with its rollback. Only what the transaction hands out runs inside it.
+     */
+    const queue = (0, _transactionQueue.createTransactionQueue)();
+    const queued = ops => Object.fromEntries(Object.entries(ops).map(([key, value]) => [key, typeof value === 'function' ? (...args) => queue.run(() => value(...args)) : value]));
+
+    /** Artifact deletions held back until the transaction that caused them commits. */
+
+    /** FR-070 for the memory adapter, with the SQLite adapter's ordering and reporting. */
+    const cascadeFor = (collection, id, deferred) => {
+      const removedArtifacts = [];
+      for (const reference of [...store.attachments.values()]) {
+        if (reference.owner?.collection !== collection || reference.owner?.id !== id) continue;
+        store.attachments.delete(reference.id);
+        if (deferred) {
+          deferred.add(reference.id);
+        } else {
+          store.artifacts.delete(reference.id);
+        }
+        removedArtifacts.push(reference.id);
+      }
+      return {
+        removedRecords: 0,
+        removedArtifacts,
+        orphanedReferences: [],
+        failedRemovals: []
+      };
+    };
+    const rawCollectionFor = (name, deferred) => {
+      assertOpen();
+      const schema = schemas.get(name);
+      if (!schema) {
+        (0, _errors2.raise)(_errors.DiagnosticCodes.CONFIG_INVALID, {
+          message: 'collection is not declared',
+          detail: {
+            collection: name
+          }
+        });
+      }
+      const ops = (0, _devLog.instrument)(name, 'memory', (0, _collection.createMemoryCollection)({
+        store,
+        schema,
+        now,
+        assertOpen
+      }));
+      if (config.cascadeAttachments !== true) {
+        return ops;
+      }
+      return {
+        ...ops,
+        async delete(id) {
+          const outcome = await ops.delete(id);
+          return {
+            ...outcome,
+            cascade: cascadeFor(name, id, deferred)
+          };
+        }
+      };
+    };
+    const collectionFor = name => queued(rawCollectionFor(name));
+    const backupPosture = {
+      requested: store.backupIncluded ? 'included' : 'excluded',
+      observed: store.backupIncluded ? 'included' : 'excluded',
+      enforcedBy: 'package'
+    };
+    const rawAttachments = (0, _attachments.createMemoryAttachments)({
+      store,
+      options,
+      now,
+      assertOpen
+    });
+    const attachments = queued(rawAttachments());
+
+    /**
+     * One transaction against the store. Snapshot-and-restore rather than a
+     * write log: simpler to reason about, and rollback fidelity is what US4
+     * tests. Runs only inside `exclusive`, so the snapshot never captures,
+     * nor its restore erases, a write made from outside.
+     */
+    const runTransaction = async fn => {
+      const snapshot = cloneCollections(store);
+      const attachmentSnapshot = new Map(store.attachments);
+      const pendingArtifactRemovals = [];
+      const deferred = {
+        add: id => pendingArtifactRemovals.push(id)
+      };
+      let settled = false;
+      const assertLive = () => {
+        if (settled) {
+          (0, _errors2.raise)(_errors.DiagnosticCodes.TRANSACTION_STATE, {
+            message: 'transaction already settled'
+          });
+        }
+      };
+      const rollback = () => {
+        store.collections = snapshot;
+        store.attachments = attachmentSnapshot;
+      };
+
+      // A collection taken from the transaction keeps refusing once it
+      // settles, as the SQLite executor does; otherwise a write after abort
+      // would land straight in the store.
+      const live = ops => Object.fromEntries(Object.entries(ops).map(([key, value]) => [key, typeof value === 'function' ?
+      // Async so a refusal rejects, as the SQLite executor's does.
+      async (...args) => {
+        assertLive();
+        return value(...args);
+      } : value]));
+      const tx = {
+        collection: name => {
+          assertLive();
+          return live(rawCollectionFor(name, deferred));
+        },
+        attachments: () => {
+          assertLive();
+          return rawAttachments(deferred);
+        },
+        async abort() {
+          assertLive();
+          settled = true;
+          rollback();
+        }
+      };
+      try {
+        const result = await fn(tx);
+        if (!settled) {
+          (0, _faults.throwIfFaulted)('commit');
+          settled = true;
+          // Committed: the artifacts whose references went may go too.
+          for (const id of pendingArtifactRemovals) {
+            store.artifacts.delete(id);
+          }
+        }
+        return result;
+      } catch (error) {
+        if (!settled) {
+          settled = true;
+          rollback();
+        }
+        throw error;
+      }
+    };
+    const handle = {
+      scopeKey: scope.key,
+      schemaVersion: store.schemaVersion,
+      backupPosture,
+      isEncrypted: store.encrypted,
+      collection: collectionFor,
+      transaction(fn) {
+        assertOpen();
+        return queue.runTransaction(() => runTransaction(fn));
+      },
+      batch(operations) {
+        assertOpen();
+        (0, _budgets.assertBatchWithinBudget)(operations.length);
+        return queue.runTransaction(() => runTransaction(async tx => {
+          const outcomes = [];
+          for (const operation of operations) {
+            const ops = tx.collection(operation.collection);
+            switch (operation.type) {
+              case 'insert':
+                outcomes.push(await ops.insert(operation.record));
+                break;
+              case 'update':
+                outcomes.push(await ops.update(operation.id, {
+                  data: operation.data
+                }));
+                break;
+              case 'upsert':
+                outcomes.push(await ops.upsert(operation.record));
+                break;
+              case 'delete':
+                outcomes.push(await ops.delete(operation.id));
+                break;
+              case 'softDelete':
+                outcomes.push(await ops.softDelete(operation.id));
+                break;
+              default:
+                break;
+            }
+          }
+          return {
+            applied: outcomes.length,
+            outcomes
+          };
+        }));
+      },
+      attachments: () => attachments,
+      async explain(collection, _query) {
+        assertOpen();
+        // Documented divergence: index declarations are validated but
+        // have no performance effect in memory (FR-096).
+        return {
+          collection,
+          usesIndex: false,
+          detail: 'memory adapter does not use indexes'
+        };
+      },
+      async close() {
+        closed = true;
+      }
+    };
+    return handle;
+  }
+
+  /**
+   * Backs both `deleteScopeData` and `resetScope`. They differ in intent and
+   * in what they let a consumer conclude, not in what they do to the store —
+   * keeping them as separate exported names is what makes the destructive one
+   * impossible to call by accident.
+   */
+  async function removeScope(config) {
+    const scope = (0, _validate.resolveScope)(config.scope);
+    const store = (0, _store.existingScopeStore)(config.name, scope.key);
+    if (!store) {
+      // Deleting nothing is success, not an error (FR-062).
+      return {
+        scopeKey: scope.key,
+        removedRecords: 0,
+        removedArtifacts: [],
+        orphanedReferences: [],
+        failedRemovals: []
+      };
+    }
+    store.deletionState = 'deleting';
+    let removedRecords = 0;
+    for (const rows of store.collections.values()) {
+      removedRecords += rows.size;
+    }
+    const removedArtifacts = [...store.artifacts.keys()];
+    (0, _store.dropScope)(config.name, scope.key);
+    return {
+      scopeKey: scope.key,
+      removedRecords,
+      removedArtifacts,
+      orphanedReferences: [],
+      failedRemovals: []
+    };
+  }
+  return {
+    name: 'memory',
+    open,
+    deleteScopeData: config => removeScope(config),
+    resetScope: config => removeScope(config),
+    async deleteDatabase(config) {
+      (0, _store.dropDatabase)(config.name);
+      return {
+        removedRecords: 0,
+        removedArtifacts: [],
+        orphanedReferences: [],
+        failedRemovals: []
+      };
+    }
+  };
+}
+//# sourceMappingURL=index.js.map

package/lib/commonjs/testing/memory-adapter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_transactionQueue","require","_errors","_keyProvider","_devLog","_errors2","_budgets","_validateConfig","_validate","_migrations","_collection","_store","_attachments","_faults","_config","schemaIndex","collections","Map","map","collection","name","cloneCollections","store","copy","rows","set","id","row","createMemoryAdapter","options","now","Date","open","config","validateConfig","throwIfFaulted","scope","resolveScope","existing","existingScopeStore","key","deletionState","raise","DiagnosticCodes","SCOPE_DELETED","message","detail","scopeKey","scopeStoreFor","encryptionRequested","encryption","enabled","schemaVersion","encrypted","ENCRYPTION_MISMATCH","acquireKey","release","backupIncluded","backup","includeInPlatformBackup","schemas","collectionMap","runMigrations","closed","assertOpen","CLOSED_HANDLE","queue","createTransactionQueue","queued","ops","Object","fromEntries","entries","value","args","run","cascadeFor","deferred","removedArtifacts","reference","attachments","values","owner","delete","add","artifacts","push","removedRecords","orphanedReferences","failedRemovals","rawCollectionFor","schema","get","CONFIG_INVALID","instrument","createMemoryCollection","cascadeAttachments","outcome","cascade","collectionFor","backupPosture","requested","observed","enforcedBy","rawAttachments","createMemoryAttachments","runTransaction","fn","snapshot","attachmentSnapshot","pendingArtifactRemovals","settled","assertLive","TRANSACTION_STATE","rollback","live","tx","abort","result","error","handle","isEncrypted","transaction","batch","operations","assertBatchWithinBudget","length","outcomes","operation","type","insert","record","update","data","upsert","softDelete","applied","explain","_query","usesIndex","close","removeScope","size","keys","dropScope","deleteScopeData","resetScope","deleteDatabase","dropDatabase"],"sourceRoot":"../../../../src","sources":["testing/memory-adapter/index.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/testing/memory-adapter/migrations.js

@@ -0,0 +1,126 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.runMigrations = runMigrations;
+var _errors = require("../../contract/errors.js");
+var _errors2 = require("../../diagnostics/errors.js");
+var _faults = require("../faults.js");
+/**
+ * Migration execution for the in-memory adapter.
+ *
+ * Mirrors the on-device rules exactly, because migration behaviour is the
+ * thing consumers most need to test without a device: ordered, at most once
+ * per scope, atomic per step, and loud on failure (FR-047 to FR-057).
+ */
+
+async function runMigrations(store, config, now) {
+  const migrations = [...(config.migrations ?? [])].sort((a, b) => a.version - b.version);
+  if (store.schemaVersion > config.schemaVersion) {
+    // Opening anyway would mean a newer database read by older code, which
+    // silently drops whatever the newer schema added.
+    (0, _errors2.raise)(_errors.DiagnosticCodes.SCHEMA_DOWNGRADE, {
+      message: 'recorded schema version is newer than the declared one',
+      detail: {
+        recordedVersion: store.schemaVersion,
+        version: config.schemaVersion
+      }
+    });
+  }
+  for (const migration of migrations) {
+    if (migration.version <= store.schemaVersion) {
+      continue;
+    }
+    const snapshot = new Map([...store.collections].map(([name, rows]) => [name, new Map(rows)]));
+    try {
+      (0, _faults.throwIfFaulted)('migration');
+      // A migration gets collection access but no handle-level surface:
+      // it must not open another scope or start a nested transaction.
+      const context = {
+        collection: name => {
+          if (!store.collections.has(name)) {
+            store.collections.set(name, new Map());
+          }
+          return migrationCollection(store, name);
+        },
+        abort: async () => {
+          throw new Error('migration aborted');
+        },
+        execute: async () => {
+          // The memory adapter has no SQL. Documented divergence.
+        }
+      };
+      await migration.migrate(context);
+      store.schemaVersion = migration.version;
+      store.ledger.set(migration.version, {
+        version: migration.version,
+        attemptedAt: now(),
+        outcome: 'applied'
+      });
+    } catch (error) {
+      // Leave the recorded version untouched so the next open retries
+      // from the same place rather than skipping ahead (FR-051).
+      store.collections = snapshot;
+      store.ledger.set(migration.version, {
+        version: migration.version,
+        attemptedAt: now(),
+        outcome: 'failed',
+        failureCode: error.code ?? _errors.DiagnosticCodes.MIGRATION_FAILED
+      });
+      (0, _errors2.raise)(_errors.DiagnosticCodes.MIGRATION_FAILED, {
+        message: 'migration failed',
+        migration: {
+          recordedVersion: store.schemaVersion,
+          failingVersion: migration.version,
+          outcome: 'failed'
+        },
+        cause: error
+      });
+    }
+  }
+  if (migrations.length === 0) {
+    store.schemaVersion = config.schemaVersion;
+  }
+}
+function migrationCollection(store, name) {
+  const rows = store.collections.get(name);
+  return {
+    async insert(record) {
+      rows.set(record.id, {
+        id: record.id,
+        payload: JSON.stringify(record.data)
+      });
+      return {
+        operation: 'created',
+        id: record.id
+      };
+    },
+    async upsert(record) {
+      const existed = rows.has(record.id);
+      rows.set(record.id, {
+        id: record.id,
+        payload: JSON.stringify(record.data)
+      });
+      return {
+        operation: existed ? 'updated' : 'created',
+        id: record.id
+      };
+    },
+    async delete(id) {
+      rows.delete(id);
+      return {
+        operation: 'deleted',
+        id
+      };
+    },
+    async find(id) {
+      const row = rows.get(id);
+      return row ? {
+        id: row.id,
+        data: JSON.parse(row.payload)
+      } : null;
+    }
+  };
+}
+//# sourceMappingURL=migrations.js.map

package/lib/commonjs/testing/memory-adapter/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_errors","require","_errors2","_faults","runMigrations","store","config","now","migrations","sort","a","b","version","schemaVersion","raise","DiagnosticCodes","SCHEMA_DOWNGRADE","message","detail","recordedVersion","migration","snapshot","Map","collections","map","name","rows","throwIfFaulted","context","collection","has","set","migrationCollection","abort","Error","execute","migrate","ledger","attemptedAt","outcome","error","failureCode","code","MIGRATION_FAILED","failingVersion","cause","length","get","insert","record","id","payload","JSON","stringify","data","operation","upsert","existed","delete","find","row","parse"],"sourceRoot":"../../../../src","sources":["testing/memory-adapter/migrations.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/testing/memory-adapter/reset.js

@@ -0,0 +1,49 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.memoryConformanceHooks = void 0;
+exports.resetMemoryAdapter = resetMemoryAdapter;
+exports.seedRecords = seedRecords;
+var _faults = require("../faults.js");
+var _store = require("./store.js");
+/**
+ * Test lifecycle helpers.
+ *
+ * `seedRecords` deliberately goes through the same write operations
+ * production code uses (FR-094). Seeding by poking the store directly would
+ * skip budget checks and timestamp handling, so tests would pass against data
+ * the package would have refused to store.
+ */
+
+/**
+ * The conformance suite's "reach past the package" hooks, implemented for the
+ * in-memory store. On device the equivalent unlinks the file directly.
+ */
+const memoryConformanceHooks = exports.memoryConformanceHooks = {
+  async removeArtifactBehindTheScenes(scopeKey, attachmentId) {
+    (0, _store.existingScopeStore)('conformance', scopeKey)?.artifacts.delete(attachmentId);
+  },
+  async removeReferenceBehindTheScenes(scopeKey, attachmentId) {
+    (0, _store.existingScopeStore)('conformance', scopeKey)?.attachments.delete(attachmentId);
+  }
+};
+
+/** Return every in-memory database to a known-empty state (FR-093). */
+async function resetMemoryAdapter(_adapter) {
+  (0, _store.resetAllMemoryStores)();
+  (0, _faults.clearFaults)();
+}
+async function seedRecords(adapter, config, collection, records) {
+  const handle = await adapter.open(config);
+  try {
+    const ops = handle.collection(collection);
+    for (const record of records) {
+      await ops.upsert(record);
+    }
+  } finally {
+    await handle.close();
+  }
+}
+//# sourceMappingURL=reset.js.map

package/lib/commonjs/testing/memory-adapter/reset.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_faults","require","_store","memoryConformanceHooks","exports","removeArtifactBehindTheScenes","scopeKey","attachmentId","existingScopeStore","artifacts","delete","removeReferenceBehindTheScenes","attachments","resetMemoryAdapter","_adapter","resetAllMemoryStores","clearFaults","seedRecords","adapter","config","collection","records","handle","open","ops","record","upsert","close"],"sourceRoot":"../../../../src","sources":["testing/memory-adapter/reset.ts"],"mappings":";;;;;;;;AAYA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,MAAA,GAAAD,OAAA;AAbA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACO,MAAME,sBAAsB,GAAAC,OAAA,CAAAD,sBAAA,GAAG;EACrC,MAAME,6BAA6BA,CAACC,QAAgB,EAAEC,YAAoB,EAAiB;IAC1F,IAAAC,yBAAkB,EAAC,aAAa,EAAEF,QAAQ,CAAC,EAAEG,SAAS,CAACC,MAAM,CAACH,YAAY,CAAC;EAC5E,CAAC;EACD,MAAMI,8BAA8BA,CAACL,QAAgB,EAAEC,YAAoB,EAAiB;IAC3F,IAAAC,yBAAkB,EAAC,aAAa,EAAEF,QAAQ,CAAC,EAAEM,WAAW,CAACF,MAAM,CAACH,YAAY,CAAC;EAC9E;AACD,CAAC;;AAED;AACO,eAAeM,kBAAkBA,CAACC,QAAyB,EAAiB;EAClF,IAAAC,2BAAoB,EAAC,CAAC;EACtB,IAAAC,mBAAW,EAAC,CAAC;AACd;AAEO,eAAeC,WAAWA,CAChCC,OAAuB,EACvBC,MAAsB,EACtBC,UAAkB,EAClBC,OAAyB,EACT;EAChB,MAAMC,MAAM,GAAG,MAAMJ,OAAO,CAACK,IAAI,CAACJ,MAAM,CAAC;EACzC,IAAI;IACH,MAAMK,GAAG,GAAGF,MAAM,CAACF,UAAU,CAAIA,UAAU,CAAC;IAC5C,KAAK,MAAMK,MAAM,IAAIJ,OAAO,EAAE;MAC7B,MAAMG,GAAG,CAACE,MAAM,CAACD,MAAM,CAAC;IACzB;EACD,CAAC,SAAS;IACT,MAAMH,MAAM,CAACK,KAAK,CAAC,CAAC;EACrB;AACD","ignoreList":[]}