@chipmobilesdk/rn-local-db 0.3.0 → 0.5.0

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

@@ -0,0 +1,163 @@
+"use strict";
+
+import { DiagnosticCodes } from "../../contract/errors.js";
+import { isCode } from "../../diagnostics/errors.js";
+/** US5: ordered, once-only migrations that fail loudly. */
+export function registerMigrationConformance(context) {
+  describe('conformance: migrations', () => {
+    beforeEach(() => context.reset());
+    const scope = {
+      kind: 'guest'
+    };
+    function chain(order, onRun) {
+      return order.map(version => ({
+        version,
+        migrate: async () => {
+          onRun(version);
+        }
+      }));
+    }
+    it('runs pending migrations in ascending order', async () => {
+      const ran = [];
+      const handle = await context.adapter.open(context.configFor(scope, {
+        schemaVersion: 3,
+        migrations: chain([3, 1, 2], v => ran.push(v))
+      }));
+      expect(ran).toEqual([1, 2, 3]);
+      expect(handle.schemaVersion).toBe(3);
+      await handle.close();
+    });
+    it('runs each migration at most once across repeated opens', async () => {
+      const ran = [];
+      const config = context.configFor(scope, {
+        schemaVersion: 2,
+        migrations: chain([1, 2], v => ran.push(v))
+      });
+      for (let i = 0; i < 3; i += 1) {
+        const handle = await context.adapter.open(config);
+        await handle.close();
+      }
+      expect(ran).toEqual([1, 2]);
+    });
+    it('returns no handle and keeps the version when a migration fails', async () => {
+      const config = context.configFor(scope, {
+        schemaVersion: 2,
+        migrations: [{
+          version: 1,
+          migrate: async () => {}
+        }, {
+          version: 2,
+          migrate: async () => {
+            throw new Error('boom');
+          }
+        }]
+      });
+      let thrown;
+      try {
+        await context.adapter.open(config);
+      } catch (error) {
+        thrown = error;
+      }
+      expect(isCode(thrown, DiagnosticCodes.MIGRATION_FAILED)).toBe(true);
+      expect(thrown.migration).toEqual({
+        recordedVersion: 1,
+        failingVersion: 2,
+        outcome: 'failed'
+      });
+    });
+    it('retries from the same version rather than skipping ahead', async () => {
+      let attempts = 0;
+      const config = context.configFor(scope, {
+        schemaVersion: 1,
+        migrations: [{
+          version: 1,
+          migrate: async () => {
+            attempts += 1;
+            if (attempts < 3) {
+              throw new Error('not yet');
+            }
+          }
+        }]
+      });
+      for (let i = 0; i < 2; i += 1) {
+        await expect(context.adapter.open(config)).rejects.toBeDefined();
+      }
+      const handle = await context.adapter.open(config);
+      expect(attempts).toBe(3);
+      expect(handle.schemaVersion).toBe(1);
+      await handle.close();
+    });
+    it('alters nothing across repeated failed opens', async () => {
+      const seedConfig = context.configFor(scope, {
+        schemaVersion: 1,
+        migrations: [{
+          version: 1,
+          migrate: async () => {}
+        }]
+      });
+      const seeded = await context.adapter.open(seedConfig);
+      await seeded.collection('notes').insert({
+        id: 'keep',
+        data: {
+          title: 'keep'
+        }
+      });
+      await seeded.close();
+      const brokenConfig = context.configFor(scope, {
+        schemaVersion: 2,
+        migrations: [{
+          version: 1,
+          migrate: async () => {}
+        }, {
+          version: 2,
+          migrate: async () => {
+            throw new Error('permanently broken');
+          }
+        }]
+      });
+      for (let i = 0; i < 10; i += 1) {
+        await expect(context.adapter.open(brokenConfig)).rejects.toBeDefined();
+      }
+      const recovered = await context.adapter.open(seedConfig);
+      expect((await recovered.collection('notes').get('keep')).data.title).toBe('keep');
+      await recovered.close();
+    });
+    it('reports a downgrade rather than opening or discarding', async () => {
+      const newer = await context.adapter.open(context.configFor(scope, {
+        schemaVersion: 3,
+        migrations: chain([1, 2, 3], () => {})
+      }));
+      await newer.close();
+      let thrown;
+      try {
+        await context.adapter.open(context.configFor(scope, {
+          schemaVersion: 1,
+          migrations: chain([1], () => {})
+        }));
+      } catch (error) {
+        thrown = error;
+      }
+      expect(isCode(thrown, DiagnosticCodes.SCHEMA_DOWNGRADE)).toBe(true);
+    });
+    it('migrates a scope created after the migration shipped', async () => {
+      const ran = [];
+      const config = id => context.configFor({
+        kind: 'identity',
+        id
+      }, {
+        schemaVersion: 2,
+        migrations: chain([1, 2], v => ran.push(v))
+      });
+      const first = await context.adapter.open(config('alice'));
+      await first.close();
+      ran.length = 0;
+
+      // A brand-new scope must not be assumed already current.
+      const second = await context.adapter.open(config('bob'));
+      expect(ran).toEqual([1, 2]);
+      expect(second.schemaVersion).toBe(2);
+      await second.close();
+    });
+  });
+}
+//# sourceMappingURL=migrations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["DiagnosticCodes","isCode","registerMigrationConformance","context","describe","beforeEach","reset","scope","kind","chain","order","onRun","map","version","migrate","it","ran","handle","adapter","open","configFor","schemaVersion","migrations","v","push","expect","toEqual","toBe","close","config","i","Error","thrown","error","MIGRATION_FAILED","migration","recordedVersion","failingVersion","outcome","attempts","rejects","toBeDefined","seedConfig","seeded","collection","insert","id","data","title","brokenConfig","recovered","get","newer","SCHEMA_DOWNGRADE","first","length","second"],"sourceRoot":"../../../../src","sources":["testing/conformance/migrations.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,274 @@
+"use strict";
+
+import { DiagnosticCodes } from "../../contract/errors.js";
+import { isCode } from "../../diagnostics/errors.js";
+/** US3: filter, sort, page, count — and paging that loses nothing. */
+export function registerQueryConformance(context) {
+  describe('conformance: queries', () => {
+    beforeEach(() => context.reset());
+    const scope = {
+      kind: 'guest'
+    };
+    const SIZE = 40;
+    async function seeded() {
+      const handle = await context.adapter.open(context.configFor(scope));
+      const notes = handle.collection('notes');
+      for (let i = 0; i < SIZE; i += 1) {
+        await notes.insert({
+          id: `id-${String(i).padStart(3, '0')}`,
+          data: {
+            title: `note ${i}`,
+            score: i % 10,
+            done: i % 2 === 0
+          }
+        });
+      }
+      return handle;
+    }
+    it('filters to the matching records only', async () => {
+      const handle = await seeded();
+      const page = await handle.collection('notes').list({
+        filter: {
+          op: 'eq',
+          field: 'score',
+          value: 3
+        },
+        page: {
+          size: 100
+        }
+      });
+      expect(page.records).toHaveLength(4);
+      expect(page.records.every(r => r.data.score === 3)).toBe(true);
+      await handle.close();
+    });
+    it('agrees between count and a full listing', async () => {
+      const handle = await seeded();
+      const notes = handle.collection('notes');
+      const filter = {
+        op: 'gte',
+        field: 'score',
+        value: 5
+      };
+      const counted = await notes.count(filter);
+      const listed = await notes.list({
+        filter,
+        page: {
+          size: 500
+        }
+      });
+      expect(counted).toBe(listed.records.length);
+      await handle.close();
+    });
+    it('walks every record exactly once with no gaps or duplicates', async () => {
+      const handle = await seeded();
+      const notes = handle.collection('notes');
+      const seen = [];
+      let cursor;
+      let guard = 0;
+      do {
+        const page = await notes.list({
+          sort: [{
+            field: 'score'
+          }],
+          page: {
+            size: 7,
+            cursor
+          }
+        });
+        seen.push(...page.records.map(r => r.id));
+        cursor = page.cursor;
+        guard += 1;
+      } while (cursor && guard < 50);
+      expect(seen).toHaveLength(SIZE);
+      expect(new Set(seen).size).toBe(SIZE);
+      await handle.close();
+    });
+    it('sorts, and breaks ties deterministically', async () => {
+      const handle = await seeded();
+      const page = await handle.collection('notes').list({
+        sort: [{
+          field: 'score'
+        }],
+        page: {
+          size: 500
+        }
+      });
+      const scores = page.records.map(r => r.data.score);
+      expect([...scores].sort((a, b) => a - b)).toEqual(scores);
+      const again = await handle.collection('notes').list({
+        sort: [{
+          field: 'score'
+        }],
+        page: {
+          size: 500
+        }
+      });
+      expect(again.records.map(r => r.id)).toEqual(page.records.map(r => r.id));
+      await handle.close();
+    });
+    it('sorts descending when asked', async () => {
+      const handle = await seeded();
+      const page = await handle.collection('notes').list({
+        sort: [{
+          field: 'score',
+          direction: 'desc'
+        }],
+        page: {
+          size: 5
+        }
+      });
+      expect(page.records[0].data.score).toBe(9);
+      await handle.close();
+    });
+    it('returns an empty result rather than an error when nothing matches', async () => {
+      const handle = await seeded();
+      const page = await handle.collection('notes').list({
+        filter: {
+          op: 'eq',
+          field: 'score',
+          value: 999
+        }
+      });
+      expect(page.records).toEqual([]);
+      expect(page.hasMore).toBe(false);
+      await handle.close();
+    });
+    it('rejects a filter on an undeclared field', async () => {
+      const handle = await seeded();
+      let thrown;
+      try {
+        await handle.collection('notes').list({
+          filter: {
+            op: 'eq',
+            field: 'nope',
+            value: 1
+          }
+        });
+      } catch (error) {
+        thrown = error;
+      }
+      expect(isCode(thrown, DiagnosticCodes.QUERY_INVALID)).toBe(true);
+      await handle.close();
+    });
+    it.each([0, -1, 501])('rejects page size %p', async size => {
+      const handle = await seeded();
+      let thrown;
+      try {
+        await handle.collection('notes').list({
+          page: {
+            size
+          }
+        });
+      } catch (error) {
+        thrown = error;
+      }
+      expect(isCode(thrown, DiagnosticCodes.PAGE_SIZE_INVALID)).toBe(true);
+      await handle.close();
+    });
+    it('excludes soft-deleted records from queries and counts by default', async () => {
+      const handle = await seeded();
+      const notes = handle.collection('notes');
+      await notes.softDelete('id-000');
+      expect(await notes.count()).toBe(SIZE - 1);
+      const page = await notes.list({
+        page: {
+          size: 500
+        }
+      });
+      expect(page.records.some(r => r.id === 'id-000')).toBe(false);
+      await handle.close();
+    });
+    it('supports the full operator set', async () => {
+      const handle = await seeded();
+      const notes = handle.collection('notes');
+      expect((await notes.list({
+        filter: {
+          op: 'ne',
+          field: 'score',
+          value: 0
+        },
+        page: {
+          size: 500
+        }
+      })).records).toHaveLength(36);
+      expect((await notes.list({
+        filter: {
+          op: 'in',
+          field: 'score',
+          value: [0, 1]
+        },
+        page: {
+          size: 500
+        }
+      })).records).toHaveLength(8);
+      expect((await notes.list({
+        filter: {
+          op: 'nin',
+          field: 'score',
+          value: [0]
+        },
+        page: {
+          size: 500
+        }
+      })).records).toHaveLength(36);
+      expect((await notes.list({
+        filter: {
+          op: 'between',
+          field: 'score',
+          value: [0, 1]
+        },
+        page: {
+          size: 500
+        }
+      })).records).toHaveLength(8);
+      expect((await notes.list({
+        filter: {
+          op: 'lt',
+          field: 'score',
+          value: 1
+        },
+        page: {
+          size: 500
+        }
+      })).records).toHaveLength(4);
+      expect((await notes.list({
+        filter: {
+          op: 'exists',
+          field: 'title',
+          value: true
+        },
+        page: {
+          size: 500
+        }
+      })).records).toHaveLength(SIZE);
+      expect((await notes.list({
+        filter: {
+          op: 'isNull',
+          field: 'title'
+        },
+        page: {
+          size: 500
+        }
+      })).records).toHaveLength(0);
+      expect((await notes.list({
+        filter: {
+          op: 'and',
+          nodes: [{
+            op: 'gte',
+            field: 'score',
+            value: 5
+          }, {
+            op: 'eq',
+            field: 'done',
+            value: true
+          }]
+        },
+        page: {
+          size: 500
+        }
+      })).records.length).toBeGreaterThan(0);
+      await handle.close();
+    });
+  });
+}
+//# sourceMappingURL=queries.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["DiagnosticCodes","isCode","registerQueryConformance","context","describe","beforeEach","reset","scope","kind","SIZE","seeded","handle","adapter","open","configFor","notes","collection","i","insert","id","String","padStart","data","title","score","done","it","page","list","filter","op","field","value","size","expect","records","toHaveLength","every","r","toBe","close","counted","count","listed","length","seen","cursor","guard","sort","push","map","Set","scores","a","b","toEqual","again","direction","hasMore","thrown","error","QUERY_INVALID","each","PAGE_SIZE_INVALID","softDelete","some","nodes","toBeGreaterThan"],"sourceRoot":"../../../../src","sources":["testing/conformance/queries.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,220 @@
+"use strict";
+
+import { DiagnosticCodes } from "../../contract/errors.js";
+import { isCode } from "../../diagnostics/errors.js";
+/** US1: durable CRUD, and the four value conditions staying distinguishable. */
+export function registerRecordConformance(context) {
+  describe('conformance: records', () => {
+    beforeEach(() => context.reset());
+    const scope = {
+      kind: 'guest'
+    };
+    it('returns exactly what was stored', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      const notes = handle.collection('notes');
+      const data = {
+        title: 'alpha',
+        score: 1.5,
+        nested: {
+          deep: [1, 'two', null, {
+            three: true
+          }]
+        },
+        explicitNull: null
+      };
+      await notes.insert({
+        id: 'a',
+        data
+      });
+      expect((await notes.get('a')).data).toEqual(data);
+      await handle.close();
+    });
+    it('does not mutate the object the caller passed in', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      const data = {
+        title: 'alpha'
+      };
+      await handle.collection('notes').insert({
+        id: 'a',
+        data
+      });
+      expect(data).toEqual({
+        title: 'alpha'
+      });
+      await handle.close();
+    });
+    it('does not hand back a live reference into the store', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      const notes = handle.collection('notes');
+      await notes.insert({
+        id: 'a',
+        data: {
+          title: 'alpha'
+        }
+      });
+      const first = await notes.get('a');
+      first.data.title = 'mutated';
+      expect((await notes.get('a')).data).toEqual({
+        title: 'alpha'
+      });
+      await handle.close();
+    });
+    it('distinguishes absent record, explicit null, and absent field', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      const notes = handle.collection('notes');
+      await notes.insert({
+        id: 'null-field',
+        data: {
+          title: null
+        }
+      });
+      await notes.insert({
+        id: 'absent-field',
+        data: {}
+      });
+      const withNull = await notes.get('null-field');
+      expect('title' in withNull.data).toBe(true);
+      expect(withNull.data.title).toBeNull();
+      const withAbsent = await notes.get('absent-field');
+      expect('title' in withAbsent.data).toBe(false);
+      expect(await notes.find('never-existed')).toBeNull();
+      await handle.close();
+    });
+    it('reports a conflict rather than overwriting on insert', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      const notes = handle.collection('notes');
+      await notes.insert({
+        id: 'a',
+        data: {
+          title: 'first'
+        }
+      });
+      let thrown;
+      try {
+        await notes.insert({
+          id: 'a',
+          data: {
+            title: 'second'
+          }
+        });
+      } catch (error) {
+        thrown = error;
+      }
+      expect(isCode(thrown, DiagnosticCodes.RECORD_CONFLICT)).toBe(true);
+      expect((await notes.get('a')).data.title).toBe('first');
+      await handle.close();
+    });
+    it('reports whether an upsert created or updated', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      const notes = handle.collection('notes');
+      expect((await notes.upsert({
+        id: 'a',
+        data: {
+          title: 'x'
+        }
+      })).operation).toBe('created');
+      expect((await notes.upsert({
+        id: 'a',
+        data: {
+          title: 'y'
+        }
+      })).operation).toBe('updated');
+      await handle.close();
+    });
+    it('reports record-not-found rather than creating on update', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      let thrown;
+      try {
+        await handle.collection('notes').update('ghost', {
+          data: {
+            title: 'x'
+          }
+        });
+      } catch (error) {
+        thrown = error;
+      }
+      expect(isCode(thrown, DiagnosticCodes.RECORD_NOT_FOUND)).toBe(true);
+      expect(await handle.collection('notes').find('ghost')).toBeNull();
+      await handle.close();
+    });
+    it('makes a hard-deleted record not-found', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      const notes = handle.collection('notes');
+      await notes.insert({
+        id: 'a',
+        data: {
+          title: 'x'
+        }
+      });
+      await notes.delete('a');
+      expect(await notes.find('a')).toBeNull();
+      await handle.close();
+    });
+    it('hides a soft-deleted record by default and restores it', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      const notes = handle.collection('notes');
+      await notes.insert({
+        id: 'a',
+        data: {
+          title: 'x'
+        }
+      });
+      await notes.softDelete('a');
+      expect(await notes.find('a')).toBeNull();
+      expect((await notes.list()).records).toHaveLength(0);
+      expect((await notes.list({
+        includeSoftDeleted: true
+      })).records).toHaveLength(1);
+      await notes.restore('a');
+      expect(await notes.find('a')).not.toBeNull();
+      await handle.close();
+    });
+    it('rejects a record over the size budget rather than truncating', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      let thrown;
+      try {
+        await handle.collection('notes').insert({
+          id: 'big',
+          data: {
+            title: 'x'.repeat(300_000)
+          }
+        });
+      } catch (error) {
+        thrown = error;
+      }
+      expect(isCode(thrown, DiagnosticCodes.RECORD_TOO_LARGE)).toBe(true);
+      expect(await handle.collection('notes').find('big')).toBeNull();
+      await handle.close();
+    });
+    it('rejects operations on a closed handle', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      await handle.close();
+      let thrown;
+      try {
+        await handle.collection('notes').find('a');
+      } catch (error) {
+        thrown = error;
+      }
+      expect(isCode(thrown, DiagnosticCodes.CLOSED_HANDLE)).toBe(true);
+    });
+    it('persists across a close and reopen', async () => {
+      const first = await context.adapter.open(context.configFor(scope));
+      await first.collection('notes').insert({
+        id: 'a',
+        data: {
+          title: 'kept'
+        }
+      });
+      await first.close();
+      const second = await context.adapter.open(context.configFor(scope));
+      expect((await second.collection('notes').get('a')).data.title).toBe('kept');
+      await second.close();
+    });
+    it('rejects a collection that was never declared', async () => {
+      const handle = await context.adapter.open(context.configFor(scope));
+      expect(() => handle.collection('nope')).toThrow();
+      await handle.close();
+    });
+  });
+}
+//# sourceMappingURL=records.js.map