@chipmobilesdk/rn-local-db 0.4.0 → 0.5.0

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

@@ -0,0 +1,176 @@
+"use strict";
+
+import { DiagnosticCodes } from "../../contract/errors.js";
+import { isCode } from "../../diagnostics/errors.js";
+import { base64ToBytes, bytesToBase64, utf8Bytes, utf8String } from "../../platform/bytes.js";
+/** US7: artifacts the package owns, and the reconciliation that keeps them honest. */
+export function registerAttachmentConformance(context) {
+  describe('conformance: attachments', () => {
+    beforeEach(() => context.reset());
+    const scope = {
+      kind: 'guest'
+    };
+    const content = bytesToBase64(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(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(utf8String(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 = 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(isCode(thrown, 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/module/testing/conformance/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DiagnosticCodes","isCode","base64ToBytes","bytesToBase64","utf8Bytes","utf8String","registerAttachmentConformance","context","describe","beforeEach","reset","scope","kind","content","it","handle","adapter","open","configFor","attachments","reference","write","id","owner","collection","contentType","expect","size","toBe","length","read","availability","state","close","slice","offset","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","ATTACHMENT_WRITE_FAILED","outcome","deleteScopeData","scopeTargetFor","toContain"],"sourceRoot":"../../../../src","sources":["testing/conformance/attachments.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,183 @@
+"use strict";
+
+import { DiagnosticCodes } from "../../contract/errors.js";
+import { isCode } from "../../diagnostics/errors.js";
+import { base64ToBytes, bytesToBase64, utf8Bytes, utf8String } from "../../platform/bytes.js";
+/** US10: opt-in encryption, and failures that stay apart from each other. */
+export 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 = bytesToBase64(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(utf8String(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(isCode(thrown, 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(isCode(empty, 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(isCode(thrown, 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/module/testing/conformance/encryption.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DiagnosticCodes","isCode","base64ToBytes","bytesToBase64","utf8Bytes","utf8String","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","attachments","write","contentType","read","slice","offset","length","availability","state","thrown","Error","error","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/module/testing/conformance/index.js

@@ -0,0 +1,97 @@
+"use strict";
+
+/**
+ * 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.
+ */
+
+import { registerRecordConformance } from "./records.js";
+import { registerScopeConformance } from "./scopes.js";
+import { registerQueryConformance } from "./queries.js";
+import { registerTransactionConformance } from "./transactions.js";
+import { registerMigrationConformance } from "./migrations.js";
+import { registerLifecycleConformance } from "./lifecycle.js";
+import { registerAttachmentConformance } from "./attachments.js";
+import { registerEncryptionConformance } from "./encryption.js";
+export const 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'
+  }]
+}];
+export 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.
+ */
+export 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', registerRecordConformance], ['scopes', registerScopeConformance], ['queries', registerQueryConformance], ['transactions', registerTransactionConformance], ['migrations', registerMigrationConformance], ['lifecycle', registerLifecycleConformance], ['attachments', registerAttachmentConformance], ['encryption', registerEncryptionConformance]];
+  for (const [name, register] of sections) {
+    if (skip.has(name)) {
+      continue;
+    }
+    register(context);
+  }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["registerRecordConformance","registerScopeConformance","registerQueryConformance","registerTransactionConformance","registerMigrationConformance","registerLifecycleConformance","registerAttachmentConformance","registerEncryptionConformance","TEST_COLLECTIONS","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","register","has"],"sourceRoot":"../../../../src","sources":["testing/conformance/index.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/testing/conformance/lifecycle.js

@@ -0,0 +1,130 @@
+"use strict";
+
+/** US6: sign-out retains; deletion happens only when asked, and only where asked. */
+export function registerLifecycleConformance(context) {
+  describe('conformance: lifecycle', () => {
+    beforeEach(() => context.reset());
+    const alice = {
+      kind: 'identity',
+      id: 'alice'
+    };
+    const bob = {
+      kind: 'identity',
+      id: 'bob'
+    };
+    it('retains data when a handle is closed without a delete request', async () => {
+      const first = await context.adapter.open(context.configFor(alice));
+      await first.collection('notes').insert({
+        id: 'a',
+        data: {
+          title: 'kept'
+        }
+      });
+      // Closing the handle is what a sign-out looks like to this package.
+      await first.close();
+      const second = await context.adapter.open(context.configFor(alice));
+      expect((await second.collection('notes').get('a')).data.title).toBe('kept');
+      await second.close();
+    });
+    it('removes every record in the target scope and nothing else', async () => {
+      const a = await context.adapter.open(context.configFor(alice));
+      await a.collection('notes').insert({
+        id: 'x',
+        data: {
+          title: 'alice'
+        }
+      });
+      await a.collection('plain').insert({
+        id: 'y',
+        data: {
+          label: 'alice'
+        }
+      });
+      await a.close();
+      const b = await context.adapter.open(context.configFor(bob));
+      await b.collection('notes').insert({
+        id: 'x',
+        data: {
+          title: 'bob'
+        }
+      });
+      await b.close();
+      const outcome = await context.adapter.deleteScopeData(context.scopeTargetFor(alice));
+      expect(outcome.removedRecords).toBe(2);
+      const reopenedAlice = await context.adapter.open(context.configFor(alice));
+      expect(await reopenedAlice.collection('notes').count()).toBe(0);
+      expect(await reopenedAlice.collection('plain').count()).toBe(0);
+      await reopenedAlice.close();
+      const reopenedBob = await context.adapter.open(context.configFor(bob));
+      expect((await reopenedBob.collection('notes').get('x')).data.title).toBe('bob');
+      await reopenedBob.close();
+    });
+    it('reports success for a scope holding no data', async () => {
+      const outcome = await context.adapter.deleteScopeData(context.scopeTargetFor({
+        kind: 'identity',
+        id: 'never-used'
+      }));
+      expect(outcome.removedRecords).toBe(0);
+      expect(outcome.failedRemovals).toEqual([]);
+    });
+    it('reports what it removed rather than a bare success', async () => {
+      const handle = await context.adapter.open(context.configFor(alice));
+      await handle.collection('notes').insert({
+        id: 'a',
+        data: {
+          title: 'x'
+        }
+      });
+      await handle.close();
+      const outcome = await context.adapter.deleteScopeData(context.scopeTargetFor(alice));
+      expect(outcome).toMatchObject({
+        removedRecords: 1,
+        removedArtifacts: [],
+        orphanedReferences: [],
+        failedRemovals: []
+      });
+    });
+    it('makes the whole database behave as a first install after deleteDatabase', async () => {
+      const handle = await context.adapter.open(context.configFor(alice));
+      await handle.collection('notes').insert({
+        id: 'a',
+        data: {
+          title: 'x'
+        }
+      });
+      await handle.close();
+      await context.adapter.deleteDatabase({
+        name: 'conformance'
+      });
+      const reopened = await context.adapter.open(context.configFor(alice));
+      expect(await reopened.collection('notes').count()).toBe(0);
+      await reopened.close();
+    });
+    it('recovers exactly one scope with resetScope', async () => {
+      const a = await context.adapter.open(context.configFor(alice));
+      await a.collection('notes').insert({
+        id: 'x',
+        data: {
+          title: 'alice'
+        }
+      });
+      await a.close();
+      const b = await context.adapter.open(context.configFor(bob));
+      await b.collection('notes').insert({
+        id: 'x',
+        data: {
+          title: 'bob'
+        }
+      });
+      await b.close();
+      await context.adapter.resetScope(context.scopeTargetFor(alice));
+      const reopenedAlice = await context.adapter.open(context.configFor(alice));
+      expect(await reopenedAlice.collection('notes').count()).toBe(0);
+      await reopenedAlice.close();
+      const reopenedBob = await context.adapter.open(context.configFor(bob));
+      expect(await reopenedBob.collection('notes').count()).toBe(1);
+      await reopenedBob.close();
+    });
+  });
+}
+//# sourceMappingURL=lifecycle.js.map

package/lib/module/testing/conformance/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["registerLifecycleConformance","context","describe","beforeEach","reset","alice","kind","id","bob","it","first","adapter","open","configFor","collection","insert","data","title","close","second","expect","get","toBe","a","label","b","outcome","deleteScopeData","scopeTargetFor","removedRecords","reopenedAlice","count","reopenedBob","failedRemovals","toEqual","handle","toMatchObject","removedArtifacts","orphanedReferences","deleteDatabase","name","reopened","resetScope"],"sourceRoot":"../../../../src","sources":["testing/conformance/lifecycle.ts"],"mappings":"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","ignoreList":[]}