@substrat-run/contract-tests 0.87.0 → 0.89.0

package/dist/timeline-suite.js

@@ -0,0 +1,223 @@
+/**
+ * Contract suite for `readTimeline` / `readHistory` — the supported read of an
+ * entity's history (#800).
+ *
+ * What it pins is not that a `SELECT` runs. Five demos already had one and all
+ * five ran; the suite exists because of what they got WRONG, and every case here
+ * is one of those:
+ *
+ * - **A timestamp cursor loses rows.** Meridian's and rally's timelines walked
+ *   `occurred_at > ?`, and `ctx.now()` is stable for a whole invocation (#812) —
+ *   so every event one operation emits shares an instant, and a page boundary
+ *   inside them dropped the rest. The burst case constructs that on purpose.
+ * - **`actor` is not an id.** It is stored `JSON.stringify`d over a union whose
+ *   principal member is a bare string, so the column holds `"01J…"` WITH quotes.
+ *   The suite asserts the decoded value, for a principal and for a system actor,
+ *   because the string-shaped read is the trap that looks like it works.
+ * - **A shred keeps the row.** The payload goes, the envelope stays, and a
+ *   history that threw or skipped the row would be a worse answer than
+ *   "something happened here and you may not know what."
+ *
+ * Behavioural against a real database throughout, for the reason the entity
+ * version suite gives: a query that reads correctly can still be wrong, and a
+ * string assertion would call it a pass.
+ */
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import { dataSubjectId, permissionKey, platformActorId, principalId, scopeId, tenantId, } from '@substrat-run/contracts';
+import { ulid } from '@substrat-run/kernel';
+import { contractTestBareOps, testMod } from './modules.js';
+const PERM_USE = permissionKey.parse('testmod:use');
+export function timelineContractSuite(adapterName, makeFixture) {
+    describe(`entity timeline (readTimeline / readHistory): ${adapterName}`, () => {
+        let fixture;
+        let host;
+        let stub;
+        const t1 = tenantId.parse(ulid());
+        const s1 = scopeId.parse(ulid());
+        const alice = principalId.parse(ulid());
+        const staff = platformActorId.parse(ulid());
+        const timeline = (entityId, page = {}, entityType = 'test-thing') => stub.invoke('test/timeline', { entityType, entityId, ...page });
+        const history = (entityId, page = {}, entityType = 'test-thing') => stub.invoke('test/history', { entityType, entityId, ...page });
+        const emitAbout = (entityId, subject) => stub.invoke('test/emit-about', { entityId, ...(subject ? { subject } : {}) });
+        const burst = (entityId, count) => stub.invoke('test/emit-burst', { entityId, count });
+        const said = (entityId, subject, what) => stub.invoke('test/emit-about-with-payload', { entityId, subject, said: what });
+        beforeAll(async () => {
+            fixture = await makeFixture();
+            host = fixture.host;
+            for (const [name, handler] of Object.entries(contractTestBareOps)) {
+                host.defineOperation(name, handler);
+            }
+            host.registerModule(testMod);
+            await host.admin.createTenant(staff, { id: t1, slug: 'timeline-tenant', name: 'Timeline Tenant' });
+            await host.admin.grantEntitlement(staff, t1, 'testmod');
+            await host.admin.defineRole(staff, t1, {
+                key: 'timeline-admin',
+                permissions: [PERM_USE],
+                source: 'vertical',
+            });
+            await host.admin.assignRole(staff, {
+                principalId: alice,
+                roleKey: 'timeline-admin',
+                node: { tenantId: t1, scopeId: null },
+            });
+            await host.provisionScope(staff, { tenantId: t1, scopeId: s1, vertical: 'timeline-vertical' });
+            await host.admin.activateScope(staff, t1, s1);
+            stub = await host.getScope(alice, t1, s1);
+        });
+        afterAll(async () => {
+            await fixture.cleanup();
+        });
+        it('is empty for an entity nothing has emitted about', async () => {
+            const page = await timeline('never-touched');
+            expect(page.entries).toEqual([]);
+            // Short page ⇒ the walk is done. A non-null cursor here would send a
+            // client back for a second empty fetch forever.
+            expect(page.nextCursor).toBeNull();
+        });
+        it('returns the envelope in creation order', async () => {
+            const id = `e-${ulid()}`;
+            await emitAbout(id);
+            await emitAbout(id);
+            await emitAbout(id);
+            const { entries } = await timeline(id);
+            expect(entries).toHaveLength(3);
+            expect(entries.map((e) => e.type)).toEqual([
+                'test.happened',
+                'test.happened',
+                'test.happened',
+            ]);
+            // `ORDER BY id` IS creation order because `ulid()` is monotonic — the same
+            // property `entityVersionQuery` relies on. Asserted rather than assumed,
+            // since losing it would make timelines subtly wrong and nothing else red.
+            const ids = entries.map((e) => e.id);
+            expect([...ids].sort()).toEqual(ids);
+        });
+        it('decodes `actor` into the union rather than handing back stored JSON', async () => {
+            const id = `e-${ulid()}`;
+            await emitAbout(id);
+            const [entry] = (await timeline(id)).entries;
+            // The trap this helper exists to close. The column holds `"01J…"` — quotes
+            // included — so a caller resolving a name against the raw text misses every
+            // time, and the natural fix is a string-trim that then breaks on a system
+            // actor. Here it is the principal id itself.
+            expect(entry.actor).toBe(alice);
+            expect(typeof entry.actor).toBe('string');
+            expect(JSON.stringify(entry.actor).startsWith('"\\"')).toBe(false);
+        });
+        it('is per entity — an event about one does not appear on another', async () => {
+            const left = `e-${ulid()}`;
+            const right = `e-${ulid()}`;
+            await emitAbout(left);
+            await emitAbout(right);
+            await emitAbout(right);
+            expect((await timeline(left)).entries).toHaveLength(1);
+            expect((await timeline(right)).entries).toHaveLength(2);
+            // Same id, other type: the pair identifies the row, not the id alone.
+            expect((await timeline(left, {}, 'other-thing')).entries).toEqual([]);
+        });
+        it('pages without losing events that share an instant', async () => {
+            const id = `e-${ulid()}`;
+            // One invocation, five events. `ctx.now()` does not move inside an
+            // operation, so all five carry the same `occurred_at` — this is the
+            // ordinary case, not a contrived tie.
+            const at = await burst(id, 5);
+            const first = await timeline(id, { limit: 2 });
+            expect(first.entries).toHaveLength(2);
+            expect(first.nextCursor).toBe(first.entries[1].id);
+            expect(first.entries.every((e) => e.occurredAt === at)).toBe(true);
+            const second = await timeline(id, { limit: 2, cursor: first.nextCursor });
+            const third = await timeline(id, { limit: 2, cursor: second.nextCursor });
+            expect(third.nextCursor).toBeNull();
+            const walked = [...first.entries, ...second.entries, ...third.entries].map((e) => e.id);
+            // The assertion the old timestamp cursor failed: five emitted, five walked,
+            // none seen twice. `occurred_at > ?` returned two and then nothing, because
+            // every remaining row shared the instant it had just walked past.
+            expect(walked).toHaveLength(5);
+            expect(new Set(walked).size).toBe(5);
+        });
+        it('walks newest-first on `desc`, over the same rows', async () => {
+            const id = `e-${ulid()}`;
+            await burst(id, 4);
+            const asc = (await timeline(id)).entries.map((e) => e.id);
+            const desc = (await timeline(id, { order: 'desc' })).entries.map((e) => e.id);
+            expect(desc).toEqual([...asc].reverse());
+            // The cursor is exclusive in BOTH directions — strictly before, walking down.
+            const firstDown = await timeline(id, { order: 'desc', limit: 2 });
+            const nextDown = await timeline(id, {
+                order: 'desc',
+                limit: 2,
+                cursor: firstDown.nextCursor,
+            });
+            expect(nextDown.entries.map((e) => e.id)).toEqual(asc.slice(0, 2).reverse());
+        });
+        it("uses the event id as the cursor — the entity's version at that point", async () => {
+            const id = `e-${ulid()}`;
+            await emitAbout(id);
+            await emitAbout(id);
+            const { entries } = await timeline(id);
+            const version = await stub.invoke('test/version-of', {
+                entityType: 'test-thing',
+                entityId: id,
+            });
+            // #901's token and this walk's last entry are the same value, which is the
+            // point of ordering by `id`: "list the history", "name a version" and
+            // "refuse my stale write" (#129) stop being three vocabularies.
+            expect(entries[entries.length - 1].id).toBe(version);
+        });
+        it('carries the payload, the classification and the authorization', async () => {
+            const id = `e-${ulid()}`;
+            await said(id, dataSubjectId.parse(ulid()), 'moved to Customer');
+            const [entry] = (await history(id)).entries;
+            // The fat event — the NEW values. "X → Y" is reconstructed by diffing
+            // consecutive payloads; nothing stores a before-state, which is a property
+            // of the spine and not something this read could have hidden.
+            expect(entry.payload).toEqual({ said: 'moved to Customer' });
+            expect(entry.piiClass).toBe('direct');
+            expect(entry.subjectId).not.toBeNull();
+            // K-34: the checks the emitting operation passed. Null would mean
+            // UNRECORDED — a row written before the column existed — which is a
+            // different fact from an empty list and must not be conflated with one.
+            expect(entry.authorization).not.toBeNull();
+            expect(entry.authorization.map((a) => a.permission)).toContain(PERM_USE);
+            // And the TIMELINE read of the same event carries none of it. That is the
+            // whole reason the two are separate: one has a disclosure decision behind
+            // it and the other cannot have.
+            const [envelope] = (await timeline(id)).entries;
+            expect(envelope).not.toHaveProperty('payload');
+            expect(envelope.id).toBe(entry.id);
+        });
+        it('degrades to a null payload after a shred, keeping the envelope', async () => {
+            const id = `e-${ulid()}`;
+            const subject = dataSubjectId.parse(ulid());
+            await said(id, subject, 'something about a person');
+            const before = (await history(id)).entries[0];
+            expect(before.payload).toEqual({ said: 'something about a person' });
+            const receipt = await host.admin.shredSubject(staff, t1, s1, subject);
+            expect(receipt.eventsRedacted).toBe(1);
+            const after = (await history(id)).entries[0];
+            // §5.3's line, held exactly: the payload goes, the envelope stays. A
+            // history after an erasure correctly reads "someone changed this, then" —
+            // so a renderer must expect the null. It is a supported result, which is
+            // why this is asserted rather than left to a caller to discover.
+            expect(after.payload).toBeNull();
+            expect(after.id).toBe(before.id);
+            expect(after.occurredAt).toBe(before.occurredAt);
+            expect(after.actor).toBe(before.actor);
+            expect(after.subjectId).toBe(subject);
+            // And the timeline — which never carried a payload — is unchanged by it.
+            expect((await timeline(id)).entries).toHaveLength(1);
+        });
+        it('defaults and caps the page size rather than answering unbounded', async () => {
+            const id = `e-${ulid()}`;
+            await burst(id, 3);
+            // An app walking a screen must not receive ten thousand rows because
+            // nobody named a number. This differs from `ListPage`'s kernel-read
+            // convention (unset ⇒ unbounded) deliberately, and matches what the HTTP
+            // layer would have given the same caller.
+            const page = await timeline(id, { limit: 0 });
+            expect(page.entries).toHaveLength(3);
+            expect(page.nextCursor).toBeNull();
+        });
+    });
+}
+//# sourceMappingURL=timeline-suite.js.map

package/dist/timeline-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-suite.js","sourceRoot":"","sources":["../src/timeline-suite.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@substrat-run/contract-tests",
-  "version": "0.87.0",
+  "version": "0.89.0",
   "description": "The suite every scope-host adapter must pass, forever (D-14)",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -16,6 +16,14 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./conformance": {
+      "types": "./dist/conformance.d.ts",
+      "default": "./dist/conformance.js"
+    },
+    "./plan": {
+      "types": "./dist/entity-check-plan.d.ts",
+      "default": "./dist/entity-check-plan.js"
     }
   },
   "files": [
@@ -23,8 +31,8 @@
   ],
   "dependencies": {
     "vitest": "^3.2.7",
-    "@substrat-run/contracts": "^0.87.0",
-    "@substrat-run/kernel": "^0.87.0"
+    "@substrat-run/contracts": "^0.89.0",
+    "@substrat-run/kernel": "^0.89.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",