@chipmobilesdk/rn-local-db 0.3.0 → 0.5.0

package/lib/commonjs/sqlite/transaction-queue.js

@@ -0,0 +1,79 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TRANSACTION_WAIT_LIMIT_MS = void 0;
+exports.createTransactionQueue = createTransactionQueue;
+var _errors = require("../contract/errors.js");
+var _errors2 = require("../diagnostics/errors.js");
+/**
+ * The per-handle queue that keeps a transaction to itself.
+ *
+ * A transaction holds the queue until it settles; work arriving meanwhile
+ * through the handle waits its turn and then runs on its own, instead of
+ * joining the transaction and vanishing with its rollback (LDB-01). Shared by
+ * the SQLite connection and the memory adapter so both isolate the same way.
+ *
+ * Pure: no engine, no React, so the memory adapter can use it without loading
+ * native code.
+ */
+
+/**
+ * How long work through the handle waits behind a transaction before it is
+ * refused.
+ *
+ * Not a performance budget: it exists for the one wait that never ends. A
+ * transaction body that awaits the handle's own `collection()` or
+ * `attachments()` is waiting on work queued behind itself. Until 0.2.0 that
+ * work ran inside the transaction; now it is refused after this long with a
+ * message naming `tx.collection()` / `tx.attachments()`, and the transaction
+ * rolls back, rather than both waiting forever.
+ */
+const TRANSACTION_WAIT_LIMIT_MS = exports.TRANSACTION_WAIT_LIMIT_MS = 10_000;
+function createTransactionQueue(waitLimitMs = TRANSACTION_WAIT_LIMIT_MS) {
+  /** Tail of the queue. Never rejects, so one failure cannot stall the rest. */
+  let tail = Promise.resolve();
+  /** Transactions queued or running. Only work behind one of them can deadlock. */
+  let transactions = 0;
+  const enqueue = work => {
+    const run = tail.then(work, work);
+    tail = run.catch(() => undefined);
+    return run;
+  };
+  return {
+    run(work) {
+      if (transactions === 0) {
+        return enqueue(work);
+      }
+      let abandoned = false;
+      let timer;
+      const started = enqueue(() => {
+        clearTimeout(timer);
+        // Refused while waiting: it must not run late, after its caller was
+        // already told it failed.
+        return abandoned ? Promise.resolve(undefined) : work();
+      });
+      const refused = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+          abandoned = true;
+          try {
+            (0, _errors2.raise)(_errors.DiagnosticCodes.TRANSACTION_STATE, {
+              message: 'waited too long behind an in-flight transaction; inside a transaction body use tx.collection() and tx.attachments(), not the handle'
+            });
+          } catch (error) {
+            reject(error);
+          }
+        }, waitLimitMs);
+      });
+      return Promise.race([started, refused]);
+    },
+    runTransaction(work) {
+      transactions += 1;
+      return enqueue(work).finally(() => {
+        transactions -= 1;
+      });
+    }
+  };
+}
+//# sourceMappingURL=transaction-queue.js.map

package/lib/commonjs/sqlite/transaction-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_errors","require","_errors2","TRANSACTION_WAIT_LIMIT_MS","exports","createTransactionQueue","waitLimitMs","tail","Promise","resolve","transactions","enqueue","work","run","then","catch","undefined","abandoned","timer","started","clearTimeout","refused","_","reject","setTimeout","raise","DiagnosticCodes","TRANSACTION_STATE","message","error","race","runTransaction","finally"],"sourceRoot":"../../../src","sources":["sqlite/transaction-queue.ts"],"mappings":";;;;;;;AAYA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,QAAA,GAAAD,OAAA;AAbA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAME,yBAAyB,GAAAC,OAAA,CAAAD,yBAAA,GAAG,MAAM;AASxC,SAASE,sBAAsBA,CACrCC,WAAmB,GAAGH,yBAAyB,EAC5B;EACnB;EACA,IAAII,IAAsB,GAAGC,OAAO,CAACC,OAAO,CAAC,CAAC;EAC9C;EACA,IAAIC,YAAY,GAAG,CAAC;EAEpB,MAAMC,OAAO,GAAOC,IAAsB,IAAiB;IAC1D,MAAMC,GAAG,GAAGN,IAAI,CAACO,IAAI,CAACF,IAAI,EAAEA,IAAI,CAAC;IACjCL,IAAI,GAAGM,GAAG,CAACE,KAAK,CAAC,MAAMC,SAAS,CAAC;IACjC,OAAOH,GAAG;EACX,CAAC;EAED,OAAO;IACNA,GAAGA,CAAID,IAAsB,EAAc;MAC1C,IAAIF,YAAY,KAAK,CAAC,EAAE;QACvB,OAAOC,OAAO,CAACC,IAAI,CAAC;MACrB;MAEA,IAAIK,SAAS,GAAG,KAAK;MACrB,IAAIC,KAAgD;MACpD,MAAMC,OAAO,GAAGR,OAAO,CAAC,MAAM;QAC7BS,YAAY,CAACF,KAAK,CAAC;QACnB;QACA;QACA,OAAOD,SAAS,GAAGT,OAAO,CAACC,OAAO,CAACO,SAAc,CAAC,GAAGJ,IAAI,CAAC,CAAC;MAC5D,CAAC,CAAC;MACF,MAAMS,OAAO,GAAG,IAAIb,OAAO,CAAQ,CAACc,CAAC,EAAEC,MAAM,KAAK;QACjDL,KAAK,GAAGM,UAAU,CAAC,MAAM;UACxBP,SAAS,GAAG,IAAI;UAChB,IAAI;YACH,IAAAQ,cAAK,EAACC,uBAAe,CAACC,iBAAiB,EAAE;cACxCC,OAAO,EACN;YACF,CAAC,CAAC;UACH,CAAC,CAAC,OAAOC,KAAK,EAAE;YACfN,MAAM,CAACM,KAAK,CAAC;UACd;QACD,CAAC,EAAEvB,WAAW,CAAC;MAChB,CAAC,CAAC;MACF,OAAOE,OAAO,CAACsB,IAAI,CAAC,CAACX,OAAO,EAAEE,OAAO,CAAC,CAAC;IACxC,CAAC;IAEDU,cAAcA,CAAInB,IAAsB,EAAc;MACrDF,YAAY,IAAI,CAAC;MACjB,OAAOC,OAAO,CAACC,IAAI,CAAC,CAACoB,OAAO,CAAC,MAAM;QAClCtB,YAAY,IAAI,CAAC;MAClB,CAAC,CAAC;IACH;EACD,CAAC;AACF","ignoreList":[]}

package/lib/commonjs/sqlite/transactions.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.runInTransaction = runInTransaction;
+/**
+ * The transaction primitive.
+ *
+ * A transaction never spans two scopes, and not because a check forbids it:
+ * a transaction runs on one connection, a connection is opened against one
+ * scope's file, and the public surface offers no way to reach a second one
+ * from inside. FR-038 is a type error rather than a runtime one (research.md
+ * R2).
+ *
+ * Rollback fidelity is SQLite's, not this package's. A failure at any step
+ * unwinds through the engine's own `ROLLBACK`, which is the only way SC-006's
+ * "identical to its pre-transaction state, every time" survives a process
+ * kill halfway through.
+ */
+
+/**
+ * Run `body` inside one transaction on one scope.
+ *
+ * Deliberately thin. The interesting behavior — read-your-own-writes,
+ * terminal-state rejection, what a settled transaction does when used again —
+ * belongs to `adapter/transaction.ts`, where both adapters can be held to the
+ * same rules.
+ */
+function runInTransaction(connection, body) {
+  return connection.transaction(body);
+}
+//# sourceMappingURL=transactions.js.map

package/lib/commonjs/sqlite/transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["runInTransaction","connection","body","transaction"],"sourceRoot":"../../../src","sources":["sqlite/transactions.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,gBAAgBA,CAC/BC,UAAsB,EACtBC,IAA6C,EAChC;EACb,OAAOD,UAAU,CAACE,WAAW,CAACD,IAAI,CAAC;AACpC","ignoreList":[]}

package/lib/commonjs/sqlite/values.js

@@ -0,0 +1,31 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.maybeNum = maybeNum;
+exports.maybeText = maybeText;
+exports.num = num;
+exports.text = text;
+/**
+ * Reading values back out of a result row.
+ *
+ * The engine hands back `unknown` per column, and every read site would
+ * otherwise repeat the same `String(...)` / `Number(...)` coercion with a
+ * slightly different null check. One place to do it means one place where the
+ * "NULL means absent, not empty string" rule is decided.
+ */
+
+function text(value) {
+  return typeof value === 'string' ? value : String(value);
+}
+function num(value) {
+  return typeof value === 'number' ? value : Number(value);
+}
+function maybeText(value) {
+  return value == null ? null : text(value);
+}
+function maybeNum(value) {
+  return value == null ? null : num(value);
+}
+//# sourceMappingURL=values.js.map

package/lib/commonjs/sqlite/values.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["text","value","String","num","Number","maybeText","maybeNum"],"sourceRoot":"../../../src","sources":["sqlite/values.ts"],"mappings":";;;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEO,SAASA,IAAIA,CAACC,KAAc,EAAU;EAC5C,OAAO,OAAOA,KAAK,KAAK,QAAQ,GAAGA,KAAK,GAAGC,MAAM,CAACD,KAAkC,CAAC;AACtF;AAEO,SAASE,GAAGA,CAACF,KAAc,EAAU;EAC3C,OAAO,OAAOA,KAAK,KAAK,QAAQ,GAAGA,KAAK,GAAGG,MAAM,CAACH,KAAwB,CAAC;AAC5E;AAEO,SAASI,SAASA,CAACJ,KAAc,EAAiB;EACxD,OAAOA,KAAK,IAAI,IAAI,GAAG,IAAI,GAAGD,IAAI,CAACC,KAAK,CAAC;AAC1C;AAEO,SAASK,QAAQA,CAACL,KAAc,EAAiB;EACvD,OAAOA,KAAK,IAAI,IAAI,GAAG,IAAI,GAAGE,GAAG,CAACF,KAAK,CAAC;AACzC","ignoreList":[]}

package/lib/commonjs/testing/conformance/attachments.js

@@ -0,0 +1,180 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.registerAttachmentConformance = registerAttachmentConformance;
+var _errors = require("../../contract/errors.js");
+var _errors2 = require("../../diagnostics/errors.js");
+var _bytes = require("../../platform/bytes.js");
+/** US7: artifacts the package owns, and the reconciliation that keeps them honest. */
+function registerAttachmentConformance(context) {
+  describe('conformance: attachments', () => {
+    beforeEach(() => context.reset());
+    const scope = {
+      kind: 'guest'
+    };
+    const content = (0, _bytes.bytesToBase64)((0, _bytes.utf8Bytes)('hello attachment'));
+    it('stores a reference alongside the artifact', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      const attachments = handle.attachments();
+      const reference = await attachments.write({
+        id: 'a1',
+        owner: {
+          collection: 'notes',
+          id: 'n1'
+        },
+        contentType: 'text/plain',
+        content
+      });
+      expect(reference.size).toBe((0, _bytes.base64ToBytes)(content).length);
+      expect(await attachments.read('a1')).toBe(content);
+      expect((await attachments.availability('a1')).state).toBe('available');
+      await handle.close();
+    });
+    it('reads a byte range without materialising the whole artifact', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      const attachments = handle.attachments();
+      await attachments.write({
+        id: 'a1',
+        contentType: 'text/plain',
+        content
+      });
+      const slice = await attachments.read('a1', {
+        offset: 0,
+        length: 5
+      });
+      expect((0, _bytes.utf8String)((0, _bytes.base64ToBytes)(slice))).toBe('hello');
+      await handle.close();
+    });
+    it('lists the attachments belonging to a record', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      const attachments = handle.attachments();
+      await attachments.write({
+        id: 'a1',
+        owner: {
+          collection: 'notes',
+          id: 'n1'
+        },
+        contentType: 'text/plain',
+        content
+      });
+      await attachments.write({
+        id: 'a2',
+        contentType: 'text/plain',
+        content
+      });
+      const owned = await attachments.listFor({
+        collection: 'notes',
+        id: 'n1'
+      });
+      expect(owned.map(r => r.id)).toEqual(['a1']);
+      await handle.close();
+    });
+    it('reports a missing artifact without making the record unreadable', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      await handle.collection('notes').insert({
+        id: 'n1',
+        data: {
+          title: 'has media'
+        }
+      });
+      const attachments = handle.attachments();
+      await attachments.write({
+        id: 'a1',
+        owner: {
+          collection: 'notes',
+          id: 'n1'
+        },
+        contentType: 'text/plain',
+        content
+      });
+
+      // Remove the artifact behind the package's back.
+      await context.removeArtifactBehindTheScenes(handle.scopeKey, 'a1');
+      expect((await attachments.availability('a1')).state).toBe('missing');
+      expect((await handle.collection('notes').get('n1')).data.title).toBe('has media');
+      await handle.close();
+    });
+    it('finds an orphaned artifact and a dangling reference', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      const attachments = handle.attachments();
+      await attachments.write({
+        id: 'a1',
+        contentType: 'text/plain',
+        content
+      });
+      await context.removeReferenceBehindTheScenes(handle.scopeKey, 'a1');
+      await attachments.write({
+        id: 'a2',
+        contentType: 'text/plain',
+        content
+      });
+      await context.removeArtifactBehindTheScenes(handle.scopeKey, 'a2');
+      const report = await attachments.reconcile();
+      expect(report.orphanedArtifacts).toEqual(['a1']);
+      expect(report.danglingReferences).toEqual(['a2']);
+      const removed = await attachments.reconcile({
+        removeOrphans: true
+      });
+      expect(removed.removedArtifacts).toEqual(['a1']);
+      expect((await attachments.reconcile()).orphanedArtifacts).toEqual([]);
+      await handle.close();
+    });
+    it('rolls a reference back with its transaction', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      try {
+        await handle.transaction(async tx => {
+          await tx.collection('notes').insert({
+            id: 'n1',
+            data: {
+              title: 'x'
+            }
+          });
+          await tx.attachments().write({
+            id: 'a1',
+            contentType: 'text/plain',
+            content
+          });
+          throw new Error('injected');
+        });
+      } catch {
+        // Expected.
+      }
+      expect(await handle.collection('notes').find('n1')).toBeNull();
+      // The reference is gone; the artifact on disk is not, which is
+      // exactly why reconciliation exists.
+      const report = await handle.attachments().reconcile();
+      expect(report.orphanedArtifacts).toEqual(['a1']);
+      await handle.close();
+    });
+    it('rejects an artifact over the size budget', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      const huge = (0, _bytes.bytesToBase64)(new Uint8Array(101 * 1024 * 1024));
+      let thrown;
+      try {
+        await handle.attachments().write({
+          id: 'big',
+          contentType: 'application/octet-stream',
+          content: huge
+        });
+      } catch (error) {
+        thrown = error;
+      }
+      expect((0, _errors2.isCode)(thrown, _errors.DiagnosticCodes.ATTACHMENT_WRITE_FAILED)).toBe(true);
+      await handle.close();
+    });
+    it('removes artifacts when the scope is deleted', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      await handle.attachments().write({
+        id: 'a1',
+        contentType: 'text/plain',
+        content
+      });
+      await handle.close();
+      const outcome = await context.adapter.deleteScopeData(context.scopeTargetFor(scope));
+      expect(outcome.removedArtifacts).toContain('a1');
+    });
+  });
+}
+//# sourceMappingURL=attachments.js.map

package/lib/commonjs/testing/conformance/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_errors","require","_errors2","_bytes","registerAttachmentConformance","context","describe","beforeEach","reset","scope","kind","content","bytesToBase64","utf8Bytes","it","handle","adapter","open","configFor","attachments","reference","write","id","owner","collection","contentType","expect","size","toBe","base64ToBytes","length","read","availability","state","close","slice","offset","utf8String","owned","listFor","map","r","toEqual","insert","data","title","removeArtifactBehindTheScenes","scopeKey","get","removeReferenceBehindTheScenes","report","reconcile","orphanedArtifacts","danglingReferences","removed","removeOrphans","removedArtifacts","transaction","tx","Error","find","toBeNull","huge","Uint8Array","thrown","error","isCode","DiagnosticCodes","ATTACHMENT_WRITE_FAILED","outcome","deleteScopeData","scopeTargetFor","toContain"],"sourceRoot":"../../../../src","sources":["testing/conformance/attachments.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/testing/conformance/encryption.js

@@ -0,0 +1,187 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.registerEncryptionConformance = registerEncryptionConformance;
+var _errors = require("../../contract/errors.js");
+var _errors2 = require("../../diagnostics/errors.js");
+var _bytes = require("../../platform/bytes.js");
+/** US10: opt-in encryption, and failures that stay apart from each other. */
+function registerEncryptionConformance(context) {
+  describe('conformance: encryption', () => {
+    beforeEach(() => context.reset());
+    const scope = {
+      kind: 'identity',
+      id: 'encrypted'
+    };
+    const keyProvider = {
+      getKey: async () => 'a-correct-key-32-bytes-long-value'
+    };
+    const encrypted = {
+      enabled: true,
+      keyProvider
+    };
+    it('reports its own posture', async () => {
+      const handle = await context.adapter.open(context.configFor(scope, {
+        encryption: encrypted
+      }));
+      expect(handle.isEncrypted).toBe(true);
+      await handle.close();
+      const plain = await context.adapter.open(context.configFor({
+        kind: 'identity',
+        id: 'plain'
+      }, {
+        encryption: undefined
+      }));
+      expect(plain.isEncrypted).toBe(false);
+      await plain.close();
+    });
+    it('stores and returns records unchanged under encryption', async () => {
+      const handle = await context.adapter.open(context.configFor(scope, {
+        encryption: encrypted
+      }));
+      const data = {
+        title: 'secret',
+        score: 1,
+        nested: {
+          deep: [1, null, true]
+        }
+      };
+      await handle.collection('notes').insert({
+        id: 'a',
+        data
+      });
+      expect((await handle.collection('notes').get('a')).data).toEqual(data);
+      await handle.close();
+      const reopened = await context.adapter.open(context.configFor(scope, {
+        encryption: encrypted
+      }));
+      expect((await reopened.collection('notes').get('a')).data).toEqual(data);
+      await reopened.close();
+    });
+    it('round-trips an artifact under encryption, including a byte range', async () => {
+      const handle = await context.adapter.open(context.configFor(scope, {
+        encryption: encrypted
+      }));
+      const content = (0, _bytes.bytesToBase64)((0, _bytes.utf8Bytes)('hello encrypted attachment'));
+      await handle.attachments().write({
+        id: 'a1',
+        contentType: 'text/plain',
+        content
+      });
+      expect(await handle.attachments().read('a1')).toBe(content);
+      const slice = await handle.attachments().read('a1', {
+        offset: 6,
+        length: 9
+      });
+      expect((0, _bytes.utf8String)((0, _bytes.base64ToBytes)(slice))).toBe('encrypted');
+      expect((await handle.attachments().availability('a1')).state).toBe('available');
+      await handle.close();
+    });
+    it('reports a key-provider failure separately from an invalid key', async () => {
+      let thrown;
+      try {
+        await context.adapter.open(context.configFor(scope, {
+          encryption: {
+            enabled: true,
+            keyProvider: {
+              getKey: async () => {
+                throw new Error('device is locked');
+              }
+            }
+          }
+        }));
+      } catch (error) {
+        thrown = error;
+      }
+      expect((0, _errors2.isCode)(thrown, _errors.DiagnosticCodes.KEY_PROVIDER_FAILED)).toBe(true);
+      let empty;
+      try {
+        await context.adapter.open(context.configFor(scope, {
+          encryption: {
+            enabled: true,
+            keyProvider: {
+              getKey: async () => ''
+            }
+          }
+        }));
+      } catch (error) {
+        empty = error;
+      }
+      expect((0, _errors2.isCode)(empty, _errors.DiagnosticCodes.KEY_INVALID)).toBe(true);
+    });
+    it('reports a posture mismatch rather than opening or converting', async () => {
+      const plain = await context.adapter.open(context.configFor(scope));
+      await plain.collection('notes').insert({
+        id: 'a',
+        data: {
+          title: 'plaintext'
+        }
+      });
+      await plain.close();
+      let thrown;
+      try {
+        await context.adapter.open(context.configFor(scope, {
+          encryption: encrypted
+        }));
+      } catch (error) {
+        thrown = error;
+      }
+      expect((0, _errors2.isCode)(thrown, _errors.DiagnosticCodes.ENCRYPTION_MISMATCH)).toBe(true);
+
+      // Nothing was converted, truncated, or discarded.
+      const reopened = await context.adapter.open(context.configFor(scope));
+      expect((await reopened.collection('notes').get('a')).data.title).toBe('plaintext');
+      await reopened.close();
+    });
+    it('gives the key provider the scope, so an app can key per identity', async () => {
+      const seen = [];
+      const recording = {
+        getKey: async resolved => {
+          seen.push(resolved.key);
+          return `key-for-${resolved.key}`;
+        }
+      };
+      for (const id of ['alice', 'bob']) {
+        const handle = await context.adapter.open(context.configFor({
+          kind: 'identity',
+          id
+        }, {
+          encryption: {
+            enabled: true,
+            keyProvider: recording
+          }
+        }));
+        await handle.close();
+      }
+      expect(seen).toHaveLength(2);
+      expect(new Set(seen).size).toBe(2);
+      for (const key of seen) {
+        expect(key).toMatch(/^[0-9a-f]{64}$/);
+      }
+    });
+    it('keeps an encrypted scope isolated from an unencrypted sibling', async () => {
+      const secure = await context.adapter.open(context.configFor({
+        kind: 'identity',
+        id: 'secure'
+      }, {
+        encryption: encrypted
+      }));
+      await secure.collection('notes').insert({
+        id: 'shared',
+        data: {
+          title: 'secure'
+        }
+      });
+      await secure.close();
+      const open = await context.adapter.open(context.configFor({
+        kind: 'identity',
+        id: 'open'
+      }));
+      expect(await open.collection('notes').find('shared')).toBeNull();
+      await open.close();
+    });
+  });
+}
+//# sourceMappingURL=encryption.js.map

package/lib/commonjs/testing/conformance/encryption.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_errors","require","_errors2","_bytes","registerEncryptionConformance","context","describe","beforeEach","reset","scope","kind","id","keyProvider","getKey","encrypted","enabled","it","handle","adapter","open","configFor","encryption","expect","isEncrypted","toBe","close","plain","undefined","data","title","score","nested","deep","collection","insert","get","toEqual","reopened","content","bytesToBase64","utf8Bytes","attachments","write","contentType","read","slice","offset","length","utf8String","base64ToBytes","availability","state","thrown","Error","error","isCode","DiagnosticCodes","KEY_PROVIDER_FAILED","empty","KEY_INVALID","ENCRYPTION_MISMATCH","seen","recording","resolved","push","key","toHaveLength","Set","size","toMatch","secure","find","toBeNull"],"sourceRoot":"../../../../src","sources":["testing/conformance/encryption.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/testing/conformance/index.js

@@ -0,0 +1,103 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TEST_COLLECTIONS = void 0;
+exports.makeConformanceContext = makeConformanceContext;
+exports.runConformanceSuite = runConformanceSuite;
+var _records = require("./records.js");
+var _scopes = require("./scopes.js");
+var _queries = require("./queries.js");
+var _transactions = require("./transactions.js");
+var _migrations = require("./migrations.js");
+var _lifecycle = require("./lifecycle.js");
+var _attachments = require("./attachments.js");
+var _encryption = require("./encryption.js");
+/**
+ * The conformance suite: the executable definition of what the package
+ * guarantees (FR-092).
+ *
+ * Exported rather than kept internal so a consuming team can run it against
+ * their own adapter if one ever exists, and so both of ours are held to
+ * exactly the same standard rather than to two similar-looking test files.
+ */
+
+const TEST_COLLECTIONS = exports.TEST_COLLECTIONS = [{
+  name: 'notes',
+  fields: [{
+    name: 'title',
+    type: 'string'
+  }, {
+    name: 'score',
+    type: 'number'
+  }, {
+    name: 'done',
+    type: 'boolean'
+  }, {
+    name: 'updated',
+    type: 'timestamp'
+  }],
+  indexes: [{
+    name: 'notes_by_score',
+    fields: ['score']
+  }],
+  softDelete: true,
+  timestamps: true
+}, {
+  name: 'plain',
+  fields: [{
+    name: 'label',
+    type: 'string'
+  }]
+}];
+function makeConformanceContext(adapter, reset, hooks, defaults = {}) {
+  return {
+    adapter,
+    reset,
+    ...hooks,
+    configFor(scope, overrides = {}) {
+      return {
+        name: 'conformance',
+        scope,
+        schemaVersion: 1,
+        collections: TEST_COLLECTIONS,
+        migrations: [{
+          version: 1,
+          migrate: async () => {}
+        }],
+        ...defaults,
+        ...overrides
+      };
+    },
+    scopeTargetFor(scope) {
+      return {
+        name: 'conformance',
+        scope,
+        ...(defaults.encryption ? {
+          encryption: defaults.encryption
+        } : {})
+      };
+    }
+  };
+}
+
+/**
+ * Registers the whole suite against one adapter. Both adapters call this with
+ * the same arguments; any difference in outcome is a divergence that must be
+ * documented under FR-096 or fixed.
+ */
+function runConformanceSuite(factory, reset, hooks, options = {}) {
+  const skip = new Set(options.skip ?? []);
+  const context = makeConformanceContext(factory(), reset, hooks, options.encryption ? {
+    encryption: options.encryption
+  } : {});
+  const sections = [['records', _records.registerRecordConformance], ['scopes', _scopes.registerScopeConformance], ['queries', _queries.registerQueryConformance], ['transactions', _transactions.registerTransactionConformance], ['migrations', _migrations.registerMigrationConformance], ['lifecycle', _lifecycle.registerLifecycleConformance], ['attachments', _attachments.registerAttachmentConformance], ['encryption', _encryption.registerEncryptionConformance]];
+  for (const [name, register] of sections) {
+    if (skip.has(name)) {
+      continue;
+    }
+    register(context);
+  }
+}
+//# sourceMappingURL=index.js.map

package/lib/commonjs/testing/conformance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_records","require","_scopes","_queries","_transactions","_migrations","_lifecycle","_attachments","_encryption","TEST_COLLECTIONS","exports","name","fields","type","indexes","softDelete","timestamps","makeConformanceContext","adapter","reset","hooks","defaults","configFor","scope","overrides","schemaVersion","collections","migrations","version","migrate","scopeTargetFor","encryption","runConformanceSuite","factory","options","skip","Set","context","sections","registerRecordConformance","registerScopeConformance","registerQueryConformance","registerTransactionConformance","registerMigrationConformance","registerLifecycleConformance","registerAttachmentConformance","registerEncryptionConformance","register","has"],"sourceRoot":"../../../../src","sources":["testing/conformance/index.ts"],"mappings":"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","ignoreList":[]}