@substrat-run/contract-tests 0.144.0 → 0.145.0

package/dist/stamps-module.js

@@ -0,0 +1,242 @@
+/**
+ * The fixture behind `updatedStampsContractSuite` (#2166): an entity that declares all four stamps,
+ * written by derived and authored handlers alike, and one that declares only `createdAt`.
+ *
+ * - `sdoc` — every stamp, and archivable: a derived create, get, update and archive, plus authored
+ *   writes that stamp the updated pair right or wrong on purpose (`stamp`), an authored delete, a
+ *   write inside a `ctx.atomic` that is rolled back, and a consumer that writes the row.
+ * - `splain` — the created stamp only: an authored write that stamps nothing is never checked.
+ *
+ * Inert for every other suite: nothing else invokes a `stamps/*` operation or reads its tables.
+ */
+import { z } from 'zod';
+import { defineEntities, defineOperations, entityStateOutput, manifestEntities, manifestOperations, moduleManifest, permissionKey, } from '@substrat-run/contracts';
+import { assertAllowed, operationsFor, readHistory } from '@substrat-run/kernel';
+export const STAMPS_MODULE_ID = '@test/stamps';
+/** A time no call is ever made at. */
+export const STALE_TIME = '2000-01-01T00:00:00.000Z';
+export const stampsEntities = defineEntities({
+    sdoc: {
+        table: 'stamped_docs',
+        fields: z.object({
+            id: z.string(),
+            title: z.string(),
+            created_at: z.string(),
+            created_by: z.string(),
+            updated_at: z.string(),
+            updated_by: z.string(),
+        }),
+        archive: { permission: 'sdoc:archive' },
+        stamps: { created_at: 'createdAt', created_by: 'createdBy', updated_at: 'updatedAt', updated_by: 'updatedBy' },
+    },
+    splain: {
+        table: 'stamped_plain',
+        fields: z.object({ id: z.string(), title: z.string(), created_at: z.string() }),
+        stamps: { created_at: 'createdAt' },
+    },
+});
+/** How an authored write stamps the updated pair: right, or wrong in one particular way. */
+export const STAMP_MODES = ['both', 'skip-at', 'skip-by', 'constant', 'other'];
+const PERMISSIONS = ['sdoc:read', 'sdoc:write', 'sdoc:archive'];
+const doc = (key) => ({ key, entity: 'sdoc', idFrom: 'docId' });
+const byId = z.object({ id: z.string() });
+const touched = { entity: 'sdoc', entityIdFrom: 'id', type: 'sdoc.touched', schemaVersion: 1, piiClass: 'none', payload: ['id'] };
+export const stampsOperations = defineOperations(stampsEntities, PERMISSIONS)({
+    'stamps/create-doc': {
+        summary: 'Add a doc, every stamp written by the platform',
+        derive: 'create',
+        permission: 'sdoc:write',
+        input: z.object({ title: z.string() }),
+        output: stampsEntities.sdoc.fields,
+        http: { method: 'POST', path: '/docs' },
+        emits: { entity: 'sdoc', entityIdFrom: 'id', type: 'sdoc.created', schemaVersion: 1, piiClass: 'none', payload: ['id', 'title'] },
+    },
+    'stamps/get-doc': {
+        summary: 'One doc',
+        derive: 'get',
+        permission: doc('sdoc:read'),
+        input: z.object({ docId: z.string() }),
+        output: stampsEntities.sdoc.fields,
+        http: { method: 'GET', path: '/docs/{docId}' },
+    },
+    'stamps/update-doc': {
+        summary: "Change a doc's title",
+        derive: 'update',
+        permission: doc('sdoc:write'),
+        input: z.object({ docId: z.string(), title: z.string().optional() }),
+        output: stampsEntities.sdoc.fields,
+        http: { method: 'PATCH', path: '/docs/{docId}' },
+        concurrency: { over: 'sdoc', idFrom: 'docId' },
+        emits: { entity: 'sdoc', entityIdFrom: 'id', type: 'sdoc.updated', schemaVersion: 1, piiClass: 'none', payload: ['id', 'title'] },
+    },
+    'stamps/archive-doc': {
+        summary: 'File a doc away — a kernel move',
+        derive: 'archive',
+        permission: doc('sdoc:archive'),
+        input: z.object({ docId: z.string() }),
+        output: entityStateOutput,
+        http: { method: 'POST', path: '/docs/{docId}/archive' },
+    },
+    'stamps/add-doc': {
+        summary: 'Add a doc by hand, with or without the updated pair',
+        permission: 'sdoc:write',
+        input: z.object({ id: z.string(), title: z.string(), stampUpdated: z.boolean() }),
+        output: byId,
+        emits: { entity: 'sdoc', entityIdFrom: 'id', type: 'sdoc.added', schemaVersion: 1, piiClass: 'none', payload: ['id'] },
+    },
+    'stamps/touch-doc': {
+        summary: "Change a doc's title by hand, stamping as told",
+        permission: 'sdoc:write',
+        input: z.object({ id: z.string(), title: z.string(), stamp: z.enum(STAMP_MODES) }),
+        output: byId,
+        emits: touched,
+    },
+    'stamps/atomic-touch': {
+        summary: 'Write a doc without its stamps inside a ctx.atomic that is rolled back',
+        permission: 'sdoc:write',
+        input: z.object({ id: z.string(), title: z.string() }),
+        output: byId,
+        emits: touched,
+    },
+    'stamps/remove-doc': {
+        summary: 'Delete a doc by hand',
+        permission: 'sdoc:write',
+        input: byId,
+        output: byId,
+        emits: { entity: 'sdoc', entityIdFrom: 'id', type: 'sdoc.removed', schemaVersion: 1, piiClass: 'none', payload: ['id'] },
+    },
+    'stamps/poke': {
+        summary: 'Ask the consumer to write a doc, stamping as told — the event is about the plain row',
+        permission: 'sdoc:write',
+        input: z.object({ id: z.string(), stamp: z.enum(STAMP_MODES) }),
+        output: byId,
+        emits: { entity: 'splain', entityIdFrom: 'id', type: 'sdoc.poked', schemaVersion: 1, piiClass: 'none', payload: ['id'] },
+    },
+    'stamps/history': {
+        summary: "How many events name a doc — what a rolled-back write must leave unchanged",
+        permission: 'sdoc:read',
+        input: byId,
+        output: z.object({ events: z.number() }),
+    },
+    'stamps/touch-plain': {
+        summary: 'Write a plain row, which declares no updated stamp',
+        permission: 'sdoc:write',
+        input: z.object({ id: z.string(), title: z.string() }),
+        output: byId,
+        emits: { entity: 'splain', entityIdFrom: 'id', type: 'splain.touched', schemaVersion: 1, piiClass: 'none', payload: ['id'] },
+    },
+});
+export const stampsManifest = moduleManifest.parse({
+    id: STAMPS_MODULE_ID,
+    version: '1.0.0',
+    kernelContract: '^0.0.1',
+    migrations: { journalDir: './migrations', compatibleFrom: '1.0.0' },
+    ...manifestOperations(stampsOperations, {
+        permissions: { 'sdoc:read': 'read docs', 'sdoc:write': 'write docs', 'sdoc:archive': 'archive docs' },
+        consumes: [{ type: 'sdoc.poked', schemaVersion: 1 }],
+    }),
+    ...manifestEntities(stampsEntities, {}),
+    entitlementKey: 'stamps',
+});
+const WRITE = permissionKey.parse('sdoc:write');
+const READ = permissionKey.parse('sdoc:read');
+const docRef = (id) => ({ entityType: 'sdoc', entityId: id });
+/** The updated pair as `mode` writes it: this call's, or wrong in one particular way. */
+function updatedPair(ctx, mode) {
+    const now = ctx.now();
+    const me = String(ctx.principal);
+    switch (mode) {
+        case 'both':
+            return { set: ', updated_at = ?, updated_by = ?', values: [now, me] };
+        case 'skip-at':
+            return { set: ', updated_by = ?', values: [me] };
+        case 'skip-by':
+            return { set: ', updated_at = ?', values: [now] };
+        case 'constant':
+            return { set: ', updated_at = ?, updated_by = ?', values: [STALE_TIME, me] };
+        case 'other':
+            return { set: ', updated_at = ?, updated_by = ?', values: [now, 'someone-else'] };
+    }
+}
+function touchDoc(ctx, id, title, mode) {
+    const pair = updatedPair(ctx, mode);
+    ctx.sql.exec(`UPDATE stamped_docs SET title = ?${pair.set} WHERE id = ?`, [title, ...pair.values, id]);
+    ctx.emit({ type: 'sdoc.touched', schemaVersion: 1, entity: docRef(id), piiClass: 'none', payload: { id } });
+}
+export const stampsMod = {
+    manifest: stampsManifest,
+    migrations: [
+        {
+            version: '0001-init',
+            sql: `CREATE TABLE stamped_docs (id TEXT PRIMARY KEY, title TEXT NOT NULL,
+                                       created_at TEXT NOT NULL, created_by TEXT NOT NULL,
+                                       updated_at TEXT NOT NULL, updated_by TEXT NOT NULL);
+            CREATE TABLE stamped_plain (id TEXT PRIMARY KEY, title TEXT NOT NULL, created_at TEXT NOT NULL);`,
+        },
+    ],
+    ...operationsFor(stampsOperations)({
+        'stamps/add-doc': async (ctx, i) => {
+            assertAllowed(await ctx.check(WRITE));
+            const now = ctx.now();
+            const me = String(ctx.principal);
+            // Without the pair, an older update's: the row is new, so its updated stamps are this call's too.
+            const updated = i.stampUpdated ? [now, me] : [STALE_TIME, me];
+            ctx.sql.exec('INSERT INTO stamped_docs (id, title, created_at, created_by, updated_at, updated_by) VALUES (?, ?, ?, ?, ?, ?)', [i.id, i.title, now, me, ...updated]);
+            ctx.emit({ type: 'sdoc.added', schemaVersion: 1, entity: docRef(i.id), piiClass: 'none', payload: { id: i.id } });
+            return { id: i.id };
+        },
+        'stamps/touch-doc': async (ctx, i) => {
+            assertAllowed(await ctx.check(WRITE));
+            touchDoc(ctx, i.id, i.title, i.stamp);
+            return { id: i.id };
+        },
+        'stamps/atomic-touch': async (ctx, i) => {
+            assertAllowed(await ctx.check(WRITE));
+            try {
+                await ctx.atomic(() => {
+                    touchDoc(ctx, i.id, i.title, 'skip-at');
+                    throw new Error('rolled back on purpose');
+                });
+            }
+            catch {
+                // The write and its event are gone; nothing this call commits names the doc.
+            }
+            return { id: i.id };
+        },
+        'stamps/remove-doc': async (ctx, i) => {
+            assertAllowed(await ctx.check(WRITE));
+            ctx.sql.exec('DELETE FROM stamped_docs WHERE id = ?', [i.id]);
+            ctx.emit({ type: 'sdoc.removed', schemaVersion: 1, entity: docRef(i.id), piiClass: 'none', payload: { id: i.id } });
+            return { id: i.id };
+        },
+        'stamps/poke': async (ctx, i) => {
+            assertAllowed(await ctx.check(WRITE));
+            ctx.emit({
+                type: 'sdoc.poked',
+                schemaVersion: 1,
+                entity: { entityType: 'splain', entityId: i.id },
+                piiClass: 'none',
+                payload: { id: i.id, stamp: i.stamp },
+            });
+            return { id: i.id };
+        },
+        'stamps/history': async (ctx, i) => {
+            assertAllowed(await ctx.check(READ));
+            return { events: readHistory({ sql: ctx.sql }, docRef(i.id), { limit: 100 }).entries.length };
+        },
+        'stamps/touch-plain': async (ctx, i) => {
+            assertAllowed(await ctx.check(WRITE));
+            ctx.sql.exec('INSERT INTO stamped_plain (id, title, created_at) VALUES (?, ?, ?) ON CONFLICT (id) DO UPDATE SET title = excluded.title', [i.id, i.title, ctx.now()]);
+            ctx.emit({ type: 'splain.touched', schemaVersion: 1, entity: { entityType: 'splain', entityId: i.id }, piiClass: 'none', payload: { id: i.id } });
+            return { id: i.id };
+        },
+    }),
+    consumers: {
+        // Writes the doc the poke names as the consumer's own principal, stamping as the poke says.
+        'sdoc.poked': async (ctx, event) => {
+            const { id, stamp } = z.object({ id: z.string(), stamp: z.enum(STAMP_MODES) }).parse(event.payload);
+            touchDoc(ctx, id, `consumed ${stamp}`, stamp);
+        },
+    },
+};
+//# sourceMappingURL=stamps-module.js.map

package/dist/stamps-module.js.map

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

package/dist/stamps-suite.d.ts

@@ -0,0 +1,3 @@
+import type { ScopeHostFixture } from './scope-host-suite.js';
+export declare function updatedStampsContractSuite(adapterName: string, makeFixture: () => Promise<ScopeHostFixture>): void;
+//# sourceMappingURL=stamps-suite.d.ts.map

package/dist/stamps-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamps-suite.d.ts","sourceRoot":"","sources":["../src/stamps-suite.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAM9D,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CA4KlH"}

package/dist/stamps-suite.js

@@ -0,0 +1,170 @@
+/**
+ * Contract suite for the updated stamps the host holds true (#2166).
+ *
+ * What it pins, on each adapter's SQL: an entity that declares `updatedAt`/`updatedBy` holds them on
+ * every row an operation or a consumer emits about. A derived create writes all four stamps and a
+ * derived update the updated pair. An authored write that stamps the pair passes; one that skips
+ * either column, writes a constant time or another principal is refused `internal`, and its row and
+ * its event roll back with it. A deleted row, a kernel move, an emit rolled back inside a
+ * `ctx.atomic` and an entity without the pair are not checked. A consumer is held to the same rule,
+ * with its own instant and principal, and a refused delivery is dead-lettered.
+ */
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import { errorCodeOf, permissionKey, platformActorId, principalId, scopeId, tenantId } from '@substrat-run/contracts';
+import { ulid } from '@substrat-run/kernel';
+import { stampsMod } from './stamps-module.js';
+const KEYS = ['sdoc:read', 'sdoc:write', 'sdoc:archive'].map((k) => permissionKey.parse(k));
+export function updatedStampsContractSuite(adapterName, makeFixture) {
+    describe(`updated stamps held by the host (#2166): ${adapterName}`, () => {
+        let fixture;
+        let host;
+        const t = tenantId.parse(ulid());
+        const s = scopeId.parse(ulid());
+        const staff = platformActorId.parse(ulid());
+        const alice = principalId.parse(ulid());
+        const carl = principalId.parse(ulid());
+        let as;
+        let asCarl;
+        const refusal = (call) => call.then(() => ({ code: 'answered', message: '' }), (e) => ({ code: errorCodeOf(e), message: e.message }));
+        const get = (id) => as.invoke('stamps/get-doc', { docId: id });
+        const events = async (id) => (await as.invoke('stamps/history', { id })).events;
+        const create = async (title) => as.invoke('stamps/create-doc', { title });
+        /**
+         * A stamp left alone is only stale once the clock has moved past it: in the same millisecond
+         * the old time IS this call's, and true. A timer, because workerd's clock stands still while
+         * code runs.
+         */
+        const pastStamp = async (d) => {
+            while (new Date().toISOString() <= d.updated_at)
+                await new Promise((r) => setTimeout(r, 2));
+        };
+        beforeAll(async () => {
+            fixture = await makeFixture();
+            host = fixture.host;
+            host.registerModule(stampsMod);
+            await host.admin.createTenant(staff, { id: t, slug: 'stamps-tenant', name: 'Stamps Tenant' });
+            await host.admin.grantEntitlement(staff, t, 'stamps');
+            await host.admin.defineRole(staff, t, { key: 'stamps-admin', permissions: KEYS, source: 'vertical' });
+            for (const who of [alice, carl]) {
+                await host.admin.assignRole(staff, { principalId: who, roleKey: 'stamps-admin', node: { tenantId: t, scopeId: null } });
+            }
+            await host.provisionScope(staff, { tenantId: t, scopeId: s, vertical: 'stamps-vertical' });
+            await host.admin.activateScope(staff, t, s);
+            as = await host.getScope(alice, t, s);
+            asCarl = await host.getScope(carl, t, s);
+        });
+        afterAll(async () => {
+            await fixture.cleanup();
+        });
+        describe('derived writes stamp the pair themselves', () => {
+            it('a derived create writes all four stamps: the call’s instant and the caller', async () => {
+                const before = new Date().toISOString();
+                const d = await create('first');
+                const after = new Date().toISOString();
+                expect(d.created_at).toBe(d.updated_at);
+                expect(d.created_at >= before && d.created_at <= after).toBe(true);
+                expect([d.created_by, d.updated_by]).toEqual([alice, alice]);
+                expect(await get(d.id)).toEqual(d);
+            });
+            it('a derived update moves the updated pair to its own caller, and leaves the created pair', async () => {
+                const d = await create('second');
+                const before = new Date().toISOString();
+                const after = await asCarl.invoke('stamps/update-doc', { docId: d.id, title: 'changed' });
+                expect(after).toEqual({ ...d, title: 'changed', updated_at: after.updated_at, updated_by: carl });
+                expect(after.updated_at >= before).toBe(true);
+                expect(await get(d.id)).toEqual(after);
+            });
+            it('a derived update that sends nothing writes nothing, so the pair stays', async () => {
+                const d = await create('untouched');
+                expect(await asCarl.invoke('stamps/update-doc', { docId: d.id })).toEqual(d);
+            });
+        });
+        describe('an authored write is held to the pair', () => {
+            it('an authored update that stamps the pair passes', async () => {
+                const d = await create('authored');
+                await asCarl.invoke('stamps/touch-doc', { id: d.id, title: 'by hand', stamp: 'both' });
+                const after = await get(d.id);
+                expect(after.title).toBe('by hand');
+                expect(after.updated_by).toBe(carl);
+                expect(after.created_by).toBe(alice);
+            });
+            it.each([
+                ['skip-at', 'updated_at', 'time'],
+                ['skip-by', 'updated_by', 'principal'],
+                ['constant', 'updated_at', 'time'],
+                ['other', 'updated_by', 'principal'],
+            ])('stamping %s is refused internal, and the write and its event roll back', async (stamp, column, what) => {
+                const d = await create(`refused ${stamp}`);
+                await pastStamp(d);
+                const seen = await events(d.id);
+                const r = await refusal(asCarl.invoke('stamps/touch-doc', { id: d.id, title: 'lost', stamp }));
+                expect(r.code).toBe('internal');
+                expect(r.message).toContain(`'${column}' does not hold this call's ${what}`);
+                expect(r.message).toContain('stamps/touch-doc');
+                expect(await get(d.id)).toEqual(d);
+                expect(await events(d.id)).toBe(seen);
+            });
+            it('an authored insert must stamp the updated pair too: without it, no row is left', async () => {
+                const ok = ulid();
+                await as.invoke('stamps/add-doc', { id: ok, title: 'with', stampUpdated: true });
+                expect((await get(ok)).updated_at).toBe((await get(ok)).created_at);
+                const stale = ulid();
+                const r = await refusal(as.invoke('stamps/add-doc', { id: stale, title: 'without', stampUpdated: false }));
+                expect(r.code).toBe('internal');
+                expect((await refusal(get(stale))).code).toBe('not_found');
+            });
+        });
+        describe('what is not checked', () => {
+            it('an emit about a deleted row: there is nothing left to stamp', async () => {
+                const d = await create('to remove');
+                await as.invoke('stamps/remove-doc', { id: d.id });
+                expect((await refusal(get(d.id))).code).toBe('not_found');
+            });
+            it('a kernel move: archiving writes only the platform’s columns, and leaves the pair', async () => {
+                const d = await create('to archive');
+                await asCarl.invoke('stamps/archive-doc', { docId: d.id });
+                expect(await get(d.id)).toEqual(d);
+            });
+            it('an emit rolled back inside ctx.atomic is gone from the outbox, so it is not held', async () => {
+                const d = await create('atomic');
+                // Another principal, past the create's millisecond: the rolled-back write left the row
+                // stale in time, so were its emit still counted, this call would be refused.
+                await pastStamp(d);
+                const seen = await events(d.id);
+                await asCarl.invoke('stamps/atomic-touch', { id: d.id, title: 'never' });
+                expect(await get(d.id)).toEqual(d);
+                expect(await events(d.id)).toBe(seen);
+            });
+            it('an entity that declares no updated stamp: an unstamped write passes', async () => {
+                const id = ulid();
+                await expect(as.invoke('stamps/touch-plain', { id, title: 'one' })).resolves.toEqual({ id });
+                await expect(asCarl.invoke('stamps/touch-plain', { id, title: 'two' })).resolves.toEqual({ id });
+            });
+        });
+        describe('a consumer is held to the pair, as its own principal', () => {
+            const poke = async (stamp) => {
+                const d = await create(`poked ${stamp}`);
+                await as.invoke('stamps/poke', { id: d.id, stamp });
+                return d;
+            };
+            const lettersFor = async (id) => (await host.admin.deadLetters(staff, t, s, {})).entries.filter((l) => String(l.error ?? '').includes(id));
+            it('a consumer that stamps the pair writes the row, as its own principal', async () => {
+                const d = await poke('both');
+                const after = await get(d.id);
+                expect(after.title).toBe('consumed both');
+                expect(after.updated_by).not.toBe(alice);
+                expect(after.updated_at >= d.updated_at).toBe(true);
+                expect(await lettersFor(d.id)).toEqual([]);
+            });
+            it('a consumer that skips the pair is dead-lettered, and its write rolls back', async () => {
+                const d = await poke('constant');
+                expect(await get(d.id)).toEqual(d);
+                const letters = await lettersFor(d.id);
+                expect(letters).toHaveLength(1);
+                expect(String(letters[0]?.error)).toContain("'updated_at' does not hold this call's time");
+                expect(String(letters[0]?.error)).toContain('consuming sdoc.poked');
+            });
+        });
+    });
+}
+//# sourceMappingURL=stamps-suite.js.map

package/dist/stamps-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamps-suite.js","sourceRoot":"","sources":["../src/stamps-suite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAoB,MAAM,yBAAyB,CAAC;AACxI,OAAO,EAAE,IAAI,EAAkC,MAAM,sBAAsB,CAAC;AAE5E,OAAO,EAAE,SAAS,EAAkB,MAAM,oBAAoB,CAAC;AAE/D,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAG5F,MAAM,UAAU,0BAA0B,CAAC,WAAmB,EAAE,WAA4C;IAC1G,QAAQ,CAAC,4CAA4C,WAAW,EAAE,EAAE,GAAG,EAAE;QACvE,IAAI,OAAyB,CAAC;QAC9B,IAAI,IAAe,CAAC;QACpB,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAgB,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,IAAI,GAAgB,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,EAAa,CAAC;QAClB,IAAI,MAAiB,CAAC;QAEtB,MAAM,OAAO,GAAG,CAAC,IAAsB,EAA0D,EAAE,CACjG,IAAI,CAAC,IAAI,CACP,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,EACzC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC,CAC1E,CAAC;QACJ,MAAM,GAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAM,gBAAgB,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,KAAK,EAAE,EAAU,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAqB,gBAAgB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QAC5G,MAAM,MAAM,GAAG,KAAK,EAAE,KAAa,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAM,mBAAmB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACvF;;;;WAIG;QACH,MAAM,SAAS,GAAG,KAAK,EAAE,CAAM,EAAE,EAAE;YACjC,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,UAAU;gBAAE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9F,CAAC,CAAC;QAEF,SAAS,CAAC,KAAK,IAAI,EAAE;YACnB,OAAO,GAAG,MAAM,WAAW,EAAE,CAAC;YAC9B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YACpB,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;YAC/B,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;YAC9F,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;YACtD,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YACtG,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1H,CAAC;YACD,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAC;YAC3F,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5C,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACtC,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,KAAK,IAAI,EAAE;YAClB,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;YACxD,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;gBAC1F,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBACxC,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;gBAChC,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBACvC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;gBACxC,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,MAAM,IAAI,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnE,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;gBAC7D,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,wFAAwF,EAAE,KAAK,IAAI,EAAE;gBACtG,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACjC,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,CAAM,mBAAmB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC/F,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClG,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9C,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;gBACrF,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;gBACpC,MAAM,CAAC,MAAM,MAAM,CAAC,MAAM,CAAM,mBAAmB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACpF,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,uCAAuC,EAAE,GAAG,EAAE;YACrD,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;gBAC9D,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;gBACnC,MAAM,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;gBACvF,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC9B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACpC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,IAAI,CAAC;gBACN,CAAC,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC;gBACjC,CAAC,SAAS,EAAE,YAAY,EAAE,WAAW,CAAC;gBACtC,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,CAAC;gBAClC,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,CAAC;aAC5B,CAAC,CAAC,wEAAwE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;gBAClH,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC;gBAC3C,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC;gBACnB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAChC,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC/F,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAChC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,IAAI,MAAM,+BAA+B,IAAI,EAAE,CAAC,CAAC;gBAC7E,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;gBAChD,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACnC,MAAM,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,gFAAgF,EAAE,KAAK,IAAI,EAAE;gBAC9F,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;gBAClB,MAAM,EAAE,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;gBACjF,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;gBACpE,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;gBACrB,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC3G,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAChC,MAAM,CAAC,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC7D,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;YACnC,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;gBAC3E,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;gBACpC,MAAM,EAAE,CAAC,MAAM,CAAC,mBAAmB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnD,MAAM,CAAC,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC5D,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,kFAAkF,EAAE,KAAK,IAAI,EAAE;gBAChG,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;gBACrC,MAAM,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3D,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,kFAAkF,EAAE,KAAK,IAAI,EAAE;gBAChG,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACjC,uFAAuF;gBACvF,6EAA6E;gBAC7E,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC;gBACnB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAChC,MAAM,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBACzE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACnC,MAAM,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;gBACnF,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;gBAClB,MAAM,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC7F,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACnG,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,sDAAsD,EAAE,GAAG,EAAE;YACpE,MAAM,IAAI,GAAG,KAAK,EAAE,KAAgB,EAAE,EAAE;gBACtC,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;gBACzC,MAAM,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBACpD,OAAO,CAAC,CAAC;YACX,CAAC,CAAC;YACF,MAAM,UAAU,GAAG,KAAK,EAAE,EAAU,EAAE,EAAE,CACtC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;YAE5G,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;gBACpF,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC7B,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC9B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;gBAC1C,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACzC,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpD,MAAM,CAAC,MAAM,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC7C,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;gBACzF,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;gBACjC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACnC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACvC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;gBAChC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,6CAA6C,CAAC,CAAC;gBAC3F,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;YACtE,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/vertical-events-suite.d.ts

@@ -106,6 +106,7 @@ export declare const crmExportModManifest: {
         archivePermission?: (string & z.$brand<"PermissionKey">) | undefined;
         trashPermission?: (string & z.$brand<"PermissionKey">) | undefined;
         purgeAfterDays?: number | undefined;
+        purgeEarly?: boolean | undefined;
         table?: string | undefined;
         idColumn?: string | undefined;
         entityType: string;
@@ -123,6 +124,13 @@ export declare const crmExportModManifest: {
             }[];
         }[];
     } | undefined;
+    updatedStamps?: {
+        table: string;
+        idColumn: string;
+        at?: string | undefined;
+        by?: string | undefined;
+        entityType: string;
+    }[] | undefined;
     ui?: {
         routes?: {
             path: string;
@@ -255,6 +263,7 @@ export declare const boardImportModManifest: {
         archivePermission?: (string & z.$brand<"PermissionKey">) | undefined;
         trashPermission?: (string & z.$brand<"PermissionKey">) | undefined;
         purgeAfterDays?: number | undefined;
+        purgeEarly?: boolean | undefined;
         table?: string | undefined;
         idColumn?: string | undefined;
         entityType: string;
@@ -272,6 +281,13 @@ export declare const boardImportModManifest: {
             }[];
         }[];
     } | undefined;
+    updatedStamps?: {
+        table: string;
+        idColumn: string;
+        at?: string | undefined;
+        by?: string | undefined;
+        entityType: string;
+    }[] | undefined;
     ui?: {
         routes?: {
             path: string;

package/dist/vertical-events-suite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vertical-events-suite.d.ts","sourceRoot":"","sources":["../src/vertical-events-suite.ts"],"names":[],"mappings":"AACA,OAAO,EASL,CAAC,EAED,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAGtB,KAAK,OAAO,EACZ,KAAK,QAAQ,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAOL,KAAK,kBAAkB,EAEvB,KAAK,kBAAkB,EAGvB,KAAK,SAAS,EAEf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA4D,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAevH,eAAO,MAAM,YAAY,aAAa,CAAC;AACvC,eAAO,MAAM,cAAc,eAAe,CAAC;AAI3C,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiC/B,CAAC;AAiFH,eAAO,MAAM,YAAY,EAAE,kBAuC1B,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BjC,CAAC;AAgDH,eAAO,MAAM,cAAc,EAAE,kBA0D5B,CAAC;AAIF;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;IACnD;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzF;;;;OAIG;IACH,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACrG;;;OAGG;IACH,IAAI,CAAC,EAAE,CACL,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,SAAS;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,EAAE,CAAC,CAAC;IACtG;;;;OAIG;IACH,eAAe,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;CACpD;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,GAChD,IAAI,CA24CN"}
+{"version":3,"file":"vertical-events-suite.d.ts","sourceRoot":"","sources":["../src/vertical-events-suite.ts"],"names":[],"mappings":"AACA,OAAO,EASL,CAAC,EAED,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAGtB,KAAK,OAAO,EACZ,KAAK,QAAQ,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAOL,KAAK,kBAAkB,EAEvB,KAAK,kBAAkB,EAGvB,KAAK,SAAS,EAEf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA4D,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAevH,eAAO,MAAM,YAAY,aAAa,CAAC;AACvC,eAAO,MAAM,cAAc,eAAe,CAAC;AAI3C,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiC/B,CAAC;AAiFH,eAAO,MAAM,YAAY,EAAE,kBAuC1B,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCjC,CAAC;AAgDH,eAAO,MAAM,cAAc,EAAE,kBAmE5B,CAAC;AAIF;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;IACnD;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzF;;;;OAIG;IACH,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACrG;;;OAGG;IACH,IAAI,CAAC,EAAE,CACL,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,SAAS;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,EAAE,CAAC,CAAC;IACtG;;;;OAIG;IACH,eAAe,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;CACpD;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,GAChD,IAAI,CA65CN"}

package/dist/vertical-events-suite.js

@@ -194,6 +194,8 @@ export const boardImportModManifest = moduleManifest.parse({
     peers: [{ vertical: CRM_VERTICAL, operations: [], permissions: ['association:sync', 'association:read'] }],
     migrations: { journalDir: './migrations', compatibleFrom: '1.0.0' },
     attachmentTargets: [],
+    // #2166: an association holds its updated stamps, so an IMPORT handler is held to them too.
+    updatedStamps: [{ entityType: 'association', table: 'board_associations', idColumn: 'crm_id', at: 'updated_at', by: 'updated_by' }],
     entitlementKey: 'board-import',
 });
 const customerCreated = z.object({ id: z.string(), name: z.string() });
@@ -228,7 +230,7 @@ export const boardImportMod = {
         {
             version: '0001-init',
             sql: `
-        CREATE TABLE board_associations (crm_id TEXT PRIMARY KEY, name TEXT NOT NULL);
+        CREATE TABLE board_associations (crm_id TEXT PRIMARY KEY, name TEXT NOT NULL, updated_at TEXT, updated_by TEXT);
         CREATE TABLE board_noted (event_id TEXT PRIMARY KEY);
       `,
         },
@@ -251,8 +253,11 @@ export const boardImportMod = {
                 // The name is quoted, so a handler's own sentence can carry a subject's id (#1757).
                 if (c.name.startsWith('poison'))
                     throw new Error(`board refuses the poison customer ${c.name}`);
-                ctx.sql.exec(`INSERT INTO board_associations (crm_id, name) VALUES (?, ?)
-           ON CONFLICT (crm_id) DO UPDATE SET name = excluded.name`, [c.id, c.name]);
+                // #2166: a 'stale' customer is written with a time that is not this delivery's.
+                const at = c.name.startsWith('stale') ? '2000-01-01T00:00:00.000Z' : ctx.now();
+                ctx.sql.exec(`INSERT INTO board_associations (crm_id, name, updated_at, updated_by) VALUES (?, ?, ?, ?)
+           ON CONFLICT (crm_id) DO UPDATE SET name = excluded.name, updated_at = excluded.updated_at,
+                                             updated_by = excluded.updated_by`, [c.id, c.name, at, String(ctx.principal)]);
                 ctx.emit({
                     type: 'board.association-created',
                     schemaVersion: 1,
@@ -268,6 +273,12 @@ export const boardImportMod = {
             'crm.customer-touched': async (ctx, event) => {
                 assertAllowed(await ctx.check(key('association:sync')));
                 const { id } = z.object({ id: z.string() }).parse(event.payload);
+                // #2166: an event about an association is a write to it, so it moves the stamps.
+                ctx.sql.exec('UPDATE board_associations SET updated_at = ?, updated_by = ? WHERE crm_id = ?', [
+                    ctx.now(),
+                    String(ctx.principal),
+                    id,
+                ]);
                 ctx.emit({
                     type: 'board.association-linked',
                     schemaVersion: 1,
@@ -582,6 +593,22 @@ export function verticalEventsContractSuite(adapterName, makeFixture) {
             expect(refused).toBeTruthy();
             expect(poison).toBeTruthy();
         });
+        it('an import handler is held to the updated stamps (#2166): a stale one is dead-lettered and rolls back', async () => {
+            const t = await newTenant();
+            const p = await install(t, CRM_VERTICAL);
+            const c = await install(t, BOARD_VERTICAL);
+            await create(t, p, 'stale customer');
+            await create(t, p, 'Fresh customer');
+            const { report } = await sweep();
+            expect(into(report, c)).toMatchObject({ state: 'delivered', delivered: 1, deadLettered: 1 });
+            const view = await board(t, c);
+            expect(view.associations.map((r) => r.name)).toEqual(['Fresh customer']);
+            const refused = view.deliveries.filter((d) => d.error?.includes("'updated_at' does not hold this call's time"));
+            expect(refused).toHaveLength(1);
+            expect(refused[0]?.error).toContain('consuming crm.customer-created');
+            // Its event rolled back with its row.
+            expect(view.outbox.filter((o) => o.type === 'board.association-created')).toHaveLength(1);
+        });
         it('at-least-once across the edge: a batch delivered twice runs each handler once', async () => {
             const t = await newTenant();
             const p = await install(t, CRM_VERTICAL);