@substrat-run/contract-tests 0.106.0 → 0.108.0

package/dist/scope-host-suite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope-host-suite.d.ts","sourceRoot":"","sources":["../src/scope-host-suite.ts"],"names":[],"mappings":"AAuBA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAW9B,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AA2BD,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,EAC5C,IAAI,GAAE,qBAA0B,GAC/B,IAAI,CA63JN"}
+{"version":3,"file":"scope-host-suite.d.ts","sourceRoot":"","sources":["../src/scope-host-suite.ts"],"names":[],"mappings":"AAuBA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAC;AAW9B,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AA2BD,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,EAC5C,IAAI,GAAE,qBAA0B,GAC/B,IAAI,CAk7JN"}

package/dist/scope-host-suite.js

@@ -362,6 +362,51 @@ export function scopeHostContractSuite(adapterName, makeFixture, opts = {}) {
             const journal2 = await again.invoke('testmod/read-journal');
             expect(journal2.filter((r) => r.module_id === '@test/mod')).toHaveLength(1);
         });
+        it('answers one record’s history through the platform (#1235)', async () => {
+            // `readHistory` has been the sanctioned read since #800 and, until this
+            // verb, nothing above the scope could call it — the whole point of #1235.
+            const stub = await host.getScope(alice, t1, s1);
+            await stub.invoke('test/emit-event');
+            await stub.invoke('test/emit-event', { subject: ulid(), secret: 'shh' });
+            const page = await host.admin.entityHistory(staff, t1, s1, {
+                entityType: 'test-thing',
+                entityId: 'x1',
+            });
+            expect(page.entries.length).toBeGreaterThanOrEqual(2);
+            expect(page.entries.every((e) => e.type === 'test.happened')).toBe(true);
+            // The fields a timeline exists to show, decoded rather than hand-parsed: the
+            // payload, the operation that emitted it, and the PII class that says whether
+            // the payload is personal at all.
+            const withSecret = page.entries.find((e) => e.payload?.secret === 'shh');
+            expect(withSecret).toBeDefined();
+            expect(withSecret.operation).toBe('test/emit-event');
+            expect(withSecret.piiClass).toBe('pseudonymous');
+            expect(withSecret.subjectId).not.toBeNull();
+            // Nobody was impersonating — a fact, not a gap, and the contract keeps the
+            // two apart.
+            expect(withSecret.impersonation).toBeNull();
+            // Another entity's history is a different story, never this one's.
+            const other = await host.admin.entityHistory(staff, t1, s1, {
+                entityType: 'test-thing',
+                entityId: 'no-such-record',
+            });
+            expect(other.entries).toEqual([]);
+            // Cursor-paged like every other list read: the page carries its own continuation.
+            const first = await host.admin.entityHistory(staff, t1, s1, {
+                entityType: 'test-thing',
+                entityId: 'x1',
+                limit: 1,
+            });
+            expect(first.entries).toHaveLength(1);
+            expect(first.nextCursor).toBe(first.entries[0].id);
+            const next = await host.admin.entityHistory(staff, t1, s1, {
+                entityType: 'test-thing',
+                entityId: 'x1',
+                limit: 1,
+                cursor: first.nextCursor,
+            });
+            expect(next.entries[0].id).not.toBe(first.entries[0].id);
+        });
         it('answers WHEN each migration ran, newest first (#1236)', async () => {
             // `applied_at` has been written since this table shipped and read by
             // nothing — every reader wanted the frontier. This is the read that makes
@@ -2940,30 +2985,30 @@ export function scopeHostContractSuite(adapterName, makeFixture, opts = {}) {
         };
         it('a private vertical version lands ADMITTED on push, noted as auto-admission', async () => {
             await host.admin.registerVertical(staff, {
-                slug: 'egeryds/crm',
-                name: 'Egeryds CRM',
+                slug: 'tenant-a/crm',
+                name: 'Tenant A CRM',
                 source: 'cli',
                 ownerTenant: t2,
             });
-            const vid = await publishPrivate('egeryds/crm', '0.1.0');
-            const [v] = await host.admin.listVersions(staff, 'egeryds/crm');
+            const vid = await publishPrivate('tenant-a/crm', '0.1.0');
+            const [v] = await host.admin.listVersions(staff, 'tenant-a/crm');
             expect(v?.admission).toBe('admitted');
             expect(v?.admissionNote).toBe(AUTO_ADMISSION_NOTE);
             // Promotable immediately — for a private vertical, push + promote IS the deploy.
-            await host.admin.promoteVersion(staff, 'egeryds/crm', 'prod', vid);
-            expect((await host.admin.listChannels(staff, 'egeryds/crm')).find((c) => c.channel === 'prod')?.versionId).toBe(vid);
+            await host.admin.promoteVersion(staff, 'tenant-a/crm', 'prod', vid);
+            expect((await host.admin.listChannels(staff, 'tenant-a/crm')).find((c) => c.channel === 'prod')?.versionId).toBe(vid);
         });
         it('getVersion reads ONE version by id, and fails closed across a lineage', async () => {
             // The read that replaced "list every version this vertical ever pushed, then
             // .find() one". Correctness first: same row, same shape as the list gives.
-            const vid = await publishPrivate('egeryds/crm', '0.9.0');
+            const vid = await publishPrivate('tenant-a/crm', '0.9.0');
             const one = await host.admin.getVersion(staff, vid);
             expect(one?.id).toBe(vid);
-            expect(one).toEqual((await host.admin.listVersions(staff, 'egeryds/crm')).find((v) => v.id === vid));
+            expect(one).toEqual((await host.admin.listVersions(staff, 'tenant-a/crm')).find((v) => v.id === vid));
             // Narrowed, it keeps what the old `.find()`-inside-one-slug's-list gave for free:
             // a version of ANOTHER vertical is absent, not returned across the boundary. Without
             // this, the slug in the URL stops constraining which version a route can hand back.
-            expect((await host.admin.getVersion(staff, vid, 'egeryds/crm'))?.id).toBe(vid);
+            expect((await host.admin.getVersion(staff, vid, 'tenant-a/crm'))?.id).toBe(vid);
             expect(await host.admin.getVersion(staff, vid, 'callout')).toBeUndefined();
             // An id nobody published is absent, not a throw — callers branch on undefined.
             expect(await host.admin.getVersion(staff, ulid())).toBeUndefined();
@@ -2976,15 +3021,15 @@ export function scopeHostContractSuite(adapterName, makeFixture, opts = {}) {
             expect(versions.find((v) => v.version === '9.9.9')?.admission).toBe('pending');
         });
         it('promotion appends to the channel history — the go-live timeline rollback picks from', async () => {
-            const first = (await host.admin.listChannelHistory(staff, 'egeryds/crm', 'prod'));
+            const first = (await host.admin.listChannelHistory(staff, 'tenant-a/crm', 'prod'));
             expect(first).toHaveLength(1);
             expect(first[0].fromVersionId).toBeNull(); // nothing before the first go-live
-            const v2 = await publishPrivate('egeryds/crm', '0.2.0');
-            await host.admin.promoteVersion(staff, 'egeryds/crm', 'prod', v2);
+            const v2 = await publishPrivate('tenant-a/crm', '0.2.0');
+            await host.admin.promoteVersion(staff, 'tenant-a/crm', 'prod', v2);
             // Rollback is a NEW promotion of the older version — the timeline only grows.
             const v1 = first[0].versionId;
-            await host.admin.promoteVersion(staff, 'egeryds/crm', 'prod', v1);
-            const timeline = await host.admin.listChannelHistory(staff, 'egeryds/crm', 'prod');
+            await host.admin.promoteVersion(staff, 'tenant-a/crm', 'prod', v1);
+            const timeline = await host.admin.listChannelHistory(staff, 'tenant-a/crm', 'prod');
             expect(timeline.map((h) => h.versionId)).toEqual([v1, v2, v1]); // newest first
             expect(timeline[0].fromVersionId).toBe(v2);
             expect(timeline[1].fromVersionId).toBe(v1);
@@ -3001,33 +3046,33 @@ export function scopeHostContractSuite(adapterName, makeFixture, opts = {}) {
             const appScope = scopeId.parse(ulid());
             await host.provisionScope(staff, { tenantId: t2, scopeId: appScope });
             await host.admin.activateScope(staff, t2, appScope);
-            const prodNow = (await host.admin.listChannels(staff, 'egeryds/crm')).find((c) => c.channel === 'prod')
+            const prodNow = (await host.admin.listChannels(staff, 'tenant-a/crm')).find((c) => c.channel === 'prod')
                 .versionId;
             await host.admin.bindScopeVersion(staff, t2, appScope, prodNow);
-            const v3 = await publishPrivate('egeryds/crm', '0.3.0');
-            await host.admin.promoteVersion(staff, 'egeryds/crm', 'prod', v3);
+            const v3 = await publishPrivate('tenant-a/crm', '0.3.0');
+            await host.admin.promoteVersion(staff, 'tenant-a/crm', 'prod', v3);
             expect((await host.admin.getScopeRecord(staff, t2, appScope))?.verticalVersionId).toBe(v3);
         });
         it('publish refuses an auto-admitted prod version until a staff admit vouches for it', async () => {
             // Listing is the moment OTHER tenants start trusting this code, so the version
             // they would install needs a recorded human decision — the auto-admission note
             // is exactly what marks its absence.
-            await expect(host.admin.setVerticalListed(staff, 'egeryds/crm', true)).rejects.toThrow(/auto-admitted.*staff admit/);
+            await expect(host.admin.setVerticalListed(staff, 'tenant-a/crm', true)).rejects.toThrow(/auto-admitted.*staff admit/);
             // A staff admit of the already-admitted version upgrades it to a manual vouch
             // (clears the note, audited) — then listing passes.
-            const prodNow = (await host.admin.listChannels(staff, 'egeryds/crm')).find((c) => c.channel === 'prod')
+            const prodNow = (await host.admin.listChannels(staff, 'tenant-a/crm')).find((c) => c.channel === 'prod')
                 .versionId;
             await host.admin.admitVersion(staff, prodNow);
-            const upgraded = (await host.admin.listVersions(staff, 'egeryds/crm')).find((v) => v.id === prodNow);
+            const upgraded = (await host.admin.listVersions(staff, 'tenant-a/crm')).find((v) => v.id === prodNow);
             expect(upgraded?.admission).toBe('admitted');
             expect(upgraded?.admissionNote).toBeNull();
-            await host.admin.setVerticalListed(staff, 'egeryds/crm', true);
+            await host.admin.setVerticalListed(staff, 'tenant-a/crm', true);
             // Listed now: the next push lands PENDING — staff admission is back in the
             // path exactly when the audience widened.
-            const v4 = await publishPrivate('egeryds/crm', '0.4.0');
-            expect((await host.admin.listVersions(staff, 'egeryds/crm')).find((v) => v.id === v4)?.admission).toBe('pending');
+            const v4 = await publishPrivate('tenant-a/crm', '0.4.0');
+            expect((await host.admin.listVersions(staff, 'tenant-a/crm')).find((v) => v.id === v4)?.admission).toBe('pending');
             // Unlist again so later suites see the vertical private (and pushes self-admit).
-            await host.admin.setVerticalListed(staff, 'egeryds/crm', false);
+            await host.admin.setVerticalListed(staff, 'tenant-a/crm', false);
         });
         // -- the provisioning state (K-31) ---------------------------------------
         it('provisions a scope as `provisioning`, not `active`', async () => {
@@ -3703,9 +3748,10 @@ export function scopeHostContractSuite(adapterName, makeFixture, opts = {}) {
             const stub = await host.getScope(alice, t4, s4);
             // Holding nothing: the denial says so, rather than leaving "held" to the imagination.
             await expect(stub.invoke('billed/act')).rejects.toThrow(/holds: none/);
-            // The Egeryds shape (#691): the tenant DOES hold keys — just not under the name the
-            // manifest declares. Required-alone reads as "buy the SKU" and sends you shopping;
-            // required-vs-held shows a near-miss at a glance, which is the actual diagnosis.
+            // The slug-prefixed-key shape (#691): the tenant DOES hold keys — just not
+            // under the name the manifest declares. Required-alone reads as "buy the
+            // SKU" and sends you shopping; required-vs-held shows a near-miss at a
+            // glance, which is the actual diagnosis.
             await host.admin.grantEntitlement(staff, t4, 't-0wv2mwk4j5/billed');
             await host.admin.grantEntitlement(staff, t4, 'workorder');
             const err = await stub.invoke('billed/act').then(() => null, (e) => e.message);
@@ -4102,12 +4148,12 @@ export function scopeHostContractSuite(adapterName, makeFixture, opts = {}) {
             expect(seen).toEqual(all.map((v) => v.slug));
         });
         it('flips listVersions to newest-first on order desc, cursor still exclusive', async () => {
-            const asc = await host.admin.listVersions(staff, 'egeryds/crm');
+            const asc = await host.admin.listVersions(staff, 'tenant-a/crm');
             expect(asc.length).toBeGreaterThanOrEqual(4);
-            const desc = await host.admin.listVersions(staff, 'egeryds/crm', { order: 'desc' });
+            const desc = await host.admin.listVersions(staff, 'tenant-a/crm', { order: 'desc' });
             expect(desc.map((v) => v.id)).toEqual([...asc.map((v) => v.id)].reverse());
             // Descending pages backward from the cursor, strictly before it.
-            const page = await host.admin.listVersions(staff, 'egeryds/crm', {
+            const page = await host.admin.listVersions(staff, 'tenant-a/crm', {
                 order: 'desc',
                 limit: 2,
                 cursor: desc[0].id,
@@ -4115,19 +4161,19 @@ export function scopeHostContractSuite(adapterName, makeFixture, opts = {}) {
             expect(page.map((v) => v.id)).toEqual(desc.slice(1, 3).map((v) => v.id));
         });
         it('keeps listChannelHistory newest-first by default and pages it; asc flips the walk', async () => {
-            const newest = await host.admin.listChannelHistory(staff, 'egeryds/crm', 'prod');
+            const newest = await host.admin.listChannelHistory(staff, 'tenant-a/crm', 'prod');
             expect(newest.length).toBeGreaterThanOrEqual(4);
             // Entry ids are ULIDs, so newest-first means descending ids — the shipped order.
             expect(newest.map((h) => h.id)).toEqual([...newest.map((h) => h.id)].sort().reverse());
-            const first = await host.admin.listChannelHistory(staff, 'egeryds/crm', 'prod', { limit: 2 });
+            const first = await host.admin.listChannelHistory(staff, 'tenant-a/crm', 'prod', { limit: 2 });
             expect(first.map((h) => h.id)).toEqual(newest.slice(0, 2).map((h) => h.id));
-            const next = await host.admin.listChannelHistory(staff, 'egeryds/crm', 'prod', {
+            const next = await host.admin.listChannelHistory(staff, 'tenant-a/crm', 'prod', {
                 limit: 2,
                 cursor: first[1].id,
             });
             expect(next.map((h) => h.id)).toEqual(newest.slice(2, 4).map((h) => h.id));
             // 'asc' flips to oldest-first — the whole timeline, reversed.
-            const oldest = await host.admin.listChannelHistory(staff, 'egeryds/crm', 'prod', {
+            const oldest = await host.admin.listChannelHistory(staff, 'tenant-a/crm', 'prod', {
                 order: 'asc',
             });
             expect(oldest.map((h) => h.id)).toEqual([...newest.map((h) => h.id)].reverse());