@substrat-run/contracts 0.120.0 → 0.122.0

package/dist/vertical-events.d.ts

@@ -262,4 +262,262 @@ export type ImportedEvent = Omit<ExportedEvent, 'hops'> & {
 };
 /** How many vertical boundaries a cause chain may cross before its next export is withheld. */
 export declare const EXPORT_HOP_CAP = 8;
+/**
+ * What a replay costs, in the words a person is shown before they pull the lever. The literal
+ * the request must carry (`acknowledge: 'rerun-handlers'`) stands for exactly this sentence.
+ */
+export declare const REPLAY_EFFECT = "handlers run again; anything they send or call outside this app happens again";
+/** What a skip costs, in the words a person is shown before they pull the lever. */
+export declare const SKIP_EFFECT = "the skipped events are never handed to this app's handlers, unless a later replay reaches back to them";
+/**
+ * Move a consumer's watermark on one edge (#1705 PR 3): the lever behind "replay from N" and
+ * "skip to now".
+ *
+ * The edge is named by the PRODUCER's vertical slug. Which scope that is, is the platform's to
+ * resolve from its directory, in the consumer's tenant, exactly as the sweep does. A caller
+ * never names the producer's scope.
+ *
+ * - `replay`: re-deliver every event after `after` (`null`: the whole exported history). Each
+ *   importing module's handler runs AGAIN for every replayed event, and what it emits is a new
+ *   event that fans out again. "Once per (event, module)" becomes "once per (event, module) per
+ *   replay". Hence the acknowledgement, whose literal stands for `REPLAY_EFFECT`.
+ * - `skip`: move the watermark forward to `through` (`'now'`: every event of an earlier millisecond
+ *   than the skip's; one in the skip's own millisecond is delivered, never dropped), so
+ *   what lies between is never delivered. Recoverable, since the producer's outbox keeps the
+ *   events and a later replay reaches back to them. Still acknowledged, because nothing else
+ *   tells the person that the app will simply not see those events.
+ *
+ * The mode is held to its direction: a replay refuses a target ahead of the watermark and a
+ * skip refuses one behind it, so the acknowledgement a person gave always matches what moved.
+ */
+export declare const importCursorMove: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    mode: z.ZodLiteral<"replay">;
+    from: z.ZodString;
+    after: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "EventId", "out">>;
+    acknowledge: z.ZodLiteral<"rerun-handlers">;
+    reason: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    mode: z.ZodLiteral<"skip">;
+    from: z.ZodString;
+    through: z.ZodUnion<readonly [z.core.$ZodBranded<z.ZodString, "EventId", "out">, z.ZodLiteral<"now">]>;
+    acknowledge: z.ZodLiteral<"skip-events">;
+    reason: z.ZodString;
+}, z.core.$strip>], "mode">;
+export type ImportCursorMove = z.infer<typeof importCursorMove>;
+/**
+ * The refusal a lever request without its acknowledgement gets (#1705 PR 3), or `null` when the
+ * acknowledgement matches the mode. Said in the words the literal stands for, so a caller that
+ * left it out is told what it would have agreed to, not that a string did not match.
+ */
+export declare function importCursorAcknowledgementMissing(raw: unknown): string | null;
+/**
+ * The far end's half of the lever (#1705 PR 3): the move, plus the producer the platform
+ * resolved. A CP-less deployment has no directory to resolve it from, so the control plane
+ * asserts it, as it asserts `ImportBatch.source`. `replayId` is the act the platform's admin
+ * rows already name, so the rows the far end moves aside carry the same id.
+ */
+export declare const importCursorMoveAt: z.ZodObject<{
+    move: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"replay">;
+        from: z.ZodString;
+        after: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "EventId", "out">>;
+        acknowledge: z.ZodLiteral<"rerun-handlers">;
+        reason: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        mode: z.ZodLiteral<"skip">;
+        from: z.ZodString;
+        through: z.ZodUnion<readonly [z.core.$ZodBranded<z.ZodString, "EventId", "out">, z.ZodLiteral<"now">]>;
+        acknowledge: z.ZodLiteral<"skip-events">;
+        reason: z.ZodString;
+    }, z.core.$strip>], "mode">;
+    source: z.ZodObject<{
+        vertical: z.ZodString;
+        scopeId: z.core.$ZodBranded<z.ZodString, "ScopeId", "out">;
+    }, z.core.$strip>;
+    replayId: z.ZodString;
+}, z.core.$strip>;
+export type ImportCursorMoveAt = z.infer<typeof importCursorMoveAt>;
+/**
+ * What a move did (#1705 PR 3).
+ *
+ * `replayId` names the act: the admin-log row carries it, and so does every journal row the
+ * replay moved into `_substrat_import_replays`. A replay does not delete the record that a
+ * delivery happened. It moves it aside, so the live journal can take the event again and the
+ * evidence of the first delivery stays. `archived` counts what moved (0 on a skip).
+ */
+export declare const importCursorMoved: z.ZodObject<{
+    replayId: z.ZodString;
+    mode: z.ZodEnum<{
+        replay: "replay";
+        skip: "skip";
+    }>;
+    source: z.ZodObject<{
+        vertical: z.ZodString;
+        scopeId: z.core.$ZodBranded<z.ZodString, "ScopeId", "out">;
+    }, z.core.$strip>;
+    previous: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "EventId", "out">>;
+    cursor: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "EventId", "out">>;
+    archived: z.ZodObject<{
+        journal: z.ZodNumber;
+        deliveries: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ImportCursorMoved = z.infer<typeof importCursorMoved>;
+/**
+ * Where one edge stands, read live (#1705 PR 3). What a person needs is whether events are
+ * getting through, and if not, why.
+ *
+ * - `caught-up`: the consumer has everything the producer releases to it.
+ * - `behind`: events are waiting past the watermark. `lagMs` says how long the oldest has waited.
+ *   A sweep takes them on its next pass unless something below is also true.
+ * - `paused`: one side refuses the other. Either the producer does not grant the consumer's
+ *   key, or the consumer's door has the producer switched off. Nothing is lost, and the backlog
+ *   waits in the producer's outbox.
+ * - `unresolved`: the platform cannot name both ends. The producer is not installed, or a
+ *   vertical has two primary installs.
+ * - `unavailable`: a side could not be ASKED (a transport error, or a deployment that predates
+ *   the routes). This is not a healthy state and must never render as one. It says nothing about
+ *   whether events are moving.
+ */
+export declare const edgeHealthState: z.ZodEnum<{
+    behind: "behind";
+    "caught-up": "caught-up";
+    paused: "paused";
+    unavailable: "unavailable";
+    unresolved: "unresolved";
+}>;
+export type EdgeHealthState = z.infer<typeof edgeHealthState>;
+export declare const edgeHealth: z.ZodObject<{
+    tenantId: z.core.$ZodBranded<z.ZodString, "TenantId", "out">;
+    consumer: z.ZodObject<{
+        scopeId: z.core.$ZodBranded<z.ZodString, "ScopeId", "out">;
+        vertical: z.ZodString;
+    }, z.core.$strip>;
+    producer: z.ZodObject<{
+        vertical: z.ZodString;
+        scopeId: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "ScopeId", "out">>;
+    }, z.core.$strip>;
+    state: z.ZodEnum<{
+        behind: "behind";
+        "caught-up": "caught-up";
+        paused: "paused";
+        unavailable: "unavailable";
+        unresolved: "unresolved";
+    }>;
+    reason: z.ZodNullable<z.ZodString>;
+    watermark: z.ZodNullable<z.ZodObject<{
+        cursor: z.core.$ZodBranded<z.ZodString, "EventId", "out">;
+        updatedAt: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "Instant", "out">>;
+    }, z.core.$strip>>;
+    oldestPending: z.ZodNullable<z.ZodObject<{
+        id: z.core.$ZodBranded<z.ZodString, "EventId", "out">;
+        occurredAt: z.ZodString;
+    }, z.core.$strip>>;
+    lagMs: z.ZodNullable<z.ZodNumber>;
+    unexported: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        schemaVersion: z.ZodNumber;
+    }, z.core.$strip>>;
+    lastDelivered: z.ZodNullable<z.ZodObject<{
+        at: z.core.$ZodBranded<z.ZodString, "Instant", "out">;
+    }, z.core.$strip>>;
+    lastProblem: z.ZodNullable<z.ZodObject<{
+        at: z.core.$ZodBranded<z.ZodString, "Instant", "out">;
+        outcome: z.ZodEnum<{
+            failed: "failed";
+            skipped: "skipped";
+        }>;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type EdgeHealth = z.infer<typeof edgeHealth>;
+/**
+ * Every edge in one tenant (#1705 PR 3), read live. `history` is the sweep-run read that
+ * supplies `lastDelivered` / `lastProblem`. If it fails, the live states still stand, and the
+ * view says the history is missing rather than showing edges with no past.
+ */
+export declare const edgeHealthReport: z.ZodObject<{
+    tenantId: z.core.$ZodBranded<z.ZodString, "TenantId", "out">;
+    checkedAt: z.core.$ZodBranded<z.ZodString, "Instant", "out">;
+    edges: z.ZodArray<z.ZodObject<{
+        tenantId: z.core.$ZodBranded<z.ZodString, "TenantId", "out">;
+        consumer: z.ZodObject<{
+            scopeId: z.core.$ZodBranded<z.ZodString, "ScopeId", "out">;
+            vertical: z.ZodString;
+        }, z.core.$strip>;
+        producer: z.ZodObject<{
+            vertical: z.ZodString;
+            scopeId: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "ScopeId", "out">>;
+        }, z.core.$strip>;
+        state: z.ZodEnum<{
+            behind: "behind";
+            "caught-up": "caught-up";
+            paused: "paused";
+            unavailable: "unavailable";
+            unresolved: "unresolved";
+        }>;
+        reason: z.ZodNullable<z.ZodString>;
+        watermark: z.ZodNullable<z.ZodObject<{
+            cursor: z.core.$ZodBranded<z.ZodString, "EventId", "out">;
+            updatedAt: z.ZodNullable<z.core.$ZodBranded<z.ZodString, "Instant", "out">>;
+        }, z.core.$strip>>;
+        oldestPending: z.ZodNullable<z.ZodObject<{
+            id: z.core.$ZodBranded<z.ZodString, "EventId", "out">;
+            occurredAt: z.ZodString;
+        }, z.core.$strip>>;
+        lagMs: z.ZodNullable<z.ZodNumber>;
+        unexported: z.ZodArray<z.ZodObject<{
+            type: z.ZodString;
+            schemaVersion: z.ZodNumber;
+        }, z.core.$strip>>;
+        lastDelivered: z.ZodNullable<z.ZodObject<{
+            at: z.core.$ZodBranded<z.ZodString, "Instant", "out">;
+        }, z.core.$strip>>;
+        lastProblem: z.ZodNullable<z.ZodObject<{
+            at: z.core.$ZodBranded<z.ZodString, "Instant", "out">;
+            outcome: z.ZodEnum<{
+                failed: "failed";
+                skipped: "skipped";
+            }>;
+            error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    unavailable: z.ZodNullable<z.ZodString>;
+    history: z.ZodObject<{
+        available: z.ZodBoolean;
+        reason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type EdgeHealthReport = z.infer<typeof edgeHealthReport>;
+/**
+ * How each state reads on a badge. `unavailable` is a side nobody could ask. It says nothing
+ * about whether events move, so it is never `success`, and only a caught-up edge is green.
+ */
+export declare const EDGE_STATE: Record<EdgeHealthState, {
+    tone: 'success' | 'warning' | 'danger';
+    label: string;
+}>;
+/**
+ * The badge one edge wears, which is its state's unless the consumer imports types its producer
+ * does not export (`edge.unexported`). Those never arrive, so a caught-up edge carrying them is
+ * not green: it is caught up on what is exported, and waiting forever on the rest.
+ */
+export declare function edgeBadge(edge: Pick<EdgeHealth, 'state' | 'unexported'>): {
+    tone: 'success' | 'warning' | 'danger';
+    label: string;
+};
+/** The sentence naming what an edge's producer does not export, or null when it exports all of it. */
+export declare function unexportedNote(edge: Pick<EdgeHealth, 'unexported' | 'producer'>): string | null;
+/** How long the oldest waiting event has waited, in a person's words. */
+export declare function lagText(ms: number | null): string | null;
+/**
+ * Whether a view of `scopeId` offers the lever on an edge: only on an edge INTO it (the watermark
+ * is the consumer's), and only where both ends resolved and could be asked.
+ */
+export declare function leverOffered(edge: EdgeHealth, scopeId: string): boolean;
+export type LeverMode = ImportCursorMove['mode'];
+/** What a lever does, in the words the platform refuses a missing acknowledgement in. */
+export declare const LEVER_EFFECT: Record<LeverMode, string>;
+/** The request a dialog sends once the person has agreed: the whole history, or up to now. */
+export declare function leverRequest(mode: LeverMode, from: string, reason: string): ImportCursorMove;
 //# sourceMappingURL=vertical-events.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"vertical-events.d.ts","sourceRoot":"","sources":["../src/vertical-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAmC,OAAO,EAAgB,MAAM,UAAU,CAAC;AAelF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;iBAQxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,cAAc;;;;;EAAuD,CAAC;AACnF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;iBAOxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,iFAAiF;AACjF,eAAO,MAAM,WAAW;;;iBAGtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;;;;;;;;iBAM1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,gFAAgF;AAChF,eAAO,MAAM,YAAY;;;;;iBAKvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;iBAGtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;iBASvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG;IACxD,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAA;KAAE,CAAC;CAChE,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,cAAc,IAAI,CAAC"}
+{"version":3,"file":"vertical-events.d.ts","sourceRoot":"","sources":["../src/vertical-events.ts"],"names":[],"mappings":"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"}

package/dist/vertical-events.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { eventId, instant, permissionKey, scopeId, verticalSlug } from './ids.js';
+import { eventId, instant, permissionKey, scopeId, tenantId, verticalSlug } from './ids.js';
 import { entityRef, eventType } from './events.js';
 // Cross-vertical event delivery (#1705): the three messages the platform carries between a
 // producer vertical's scope and a consumer vertical's scope in the same tenant.
@@ -164,4 +164,215 @@ export const importResult = z.object({
 });
 /** How many vertical boundaries a cause chain may cross before its next export is withheld. */
 export const EXPORT_HOP_CAP = 8;
+// -- the replay lever (#1705 PR 3) -----------------------------------------------------------
+/**
+ * What a replay costs, in the words a person is shown before they pull the lever. The literal
+ * the request must carry (`acknowledge: 'rerun-handlers'`) stands for exactly this sentence.
+ */
+export const REPLAY_EFFECT = 'handlers run again; anything they send or call outside this app happens again';
+/** What a skip costs, in the words a person is shown before they pull the lever. */
+export const SKIP_EFFECT = "the skipped events are never handed to this app's handlers, unless a later replay reaches back to them";
+/**
+ * Move a consumer's watermark on one edge (#1705 PR 3): the lever behind "replay from N" and
+ * "skip to now".
+ *
+ * The edge is named by the PRODUCER's vertical slug. Which scope that is, is the platform's to
+ * resolve from its directory, in the consumer's tenant, exactly as the sweep does. A caller
+ * never names the producer's scope.
+ *
+ * - `replay`: re-deliver every event after `after` (`null`: the whole exported history). Each
+ *   importing module's handler runs AGAIN for every replayed event, and what it emits is a new
+ *   event that fans out again. "Once per (event, module)" becomes "once per (event, module) per
+ *   replay". Hence the acknowledgement, whose literal stands for `REPLAY_EFFECT`.
+ * - `skip`: move the watermark forward to `through` (`'now'`: every event of an earlier millisecond
+ *   than the skip's; one in the skip's own millisecond is delivered, never dropped), so
+ *   what lies between is never delivered. Recoverable, since the producer's outbox keeps the
+ *   events and a later replay reaches back to them. Still acknowledged, because nothing else
+ *   tells the person that the app will simply not see those events.
+ *
+ * The mode is held to its direction: a replay refuses a target ahead of the watermark and a
+ * skip refuses one behind it, so the acknowledgement a person gave always matches what moved.
+ */
+export const importCursorMove = z.discriminatedUnion('mode', [
+    z.object({
+        mode: z.literal('replay'),
+        from: verticalSlug,
+        after: eventId.nullable(),
+        acknowledge: z.literal('rerun-handlers'),
+        reason: z.string().trim().min(1).max(500),
+    }),
+    z.object({
+        mode: z.literal('skip'),
+        from: verticalSlug,
+        through: z.union([eventId, z.literal('now')]),
+        acknowledge: z.literal('skip-events'),
+        reason: z.string().trim().min(1).max(500),
+    }),
+]);
+/**
+ * The refusal a lever request without its acknowledgement gets (#1705 PR 3), or `null` when the
+ * acknowledgement matches the mode. Said in the words the literal stands for, so a caller that
+ * left it out is told what it would have agreed to, not that a string did not match.
+ */
+export function importCursorAcknowledgementMissing(raw) {
+    if (raw === null || typeof raw !== 'object')
+        return null;
+    const r = raw;
+    if (r.mode === 'replay' && r.acknowledge !== 'rerun-handlers') {
+        return `a replay needs acknowledge: 'rerun-handlers' — ${REPLAY_EFFECT}`;
+    }
+    if (r.mode === 'skip' && r.acknowledge !== 'skip-events') {
+        return `a skip needs acknowledge: 'skip-events' — ${SKIP_EFFECT}`;
+    }
+    return null;
+}
+/**
+ * The far end's half of the lever (#1705 PR 3): the move, plus the producer the platform
+ * resolved. A CP-less deployment has no directory to resolve it from, so the control plane
+ * asserts it, as it asserts `ImportBatch.source`. `replayId` is the act the platform's admin
+ * rows already name, so the rows the far end moves aside carry the same id.
+ */
+export const importCursorMoveAt = z.object({
+    move: importCursorMove,
+    source: z.object({ vertical: verticalSlug, scopeId }),
+    replayId: z.string().regex(/^[0-9A-HJKMNP-TV-Z]{26}$/),
+});
+/**
+ * What a move did (#1705 PR 3).
+ *
+ * `replayId` names the act: the admin-log row carries it, and so does every journal row the
+ * replay moved into `_substrat_import_replays`. A replay does not delete the record that a
+ * delivery happened. It moves it aside, so the live journal can take the event again and the
+ * evidence of the first delivery stays. `archived` counts what moved (0 on a skip).
+ */
+export const importCursorMoved = z.object({
+    replayId: z.string().min(1),
+    mode: z.enum(['replay', 'skip']),
+    source: z.object({ vertical: verticalSlug, scopeId }),
+    previous: eventId.nullable(),
+    cursor: eventId.nullable(),
+    archived: z.object({
+        journal: z.number().int().nonnegative(),
+        deliveries: z.number().int().nonnegative(),
+    }),
+});
+// -- edge health (#1705 PR 3) ----------------------------------------------------------------
+/**
+ * Where one edge stands, read live (#1705 PR 3). What a person needs is whether events are
+ * getting through, and if not, why.
+ *
+ * - `caught-up`: the consumer has everything the producer releases to it.
+ * - `behind`: events are waiting past the watermark. `lagMs` says how long the oldest has waited.
+ *   A sweep takes them on its next pass unless something below is also true.
+ * - `paused`: one side refuses the other. Either the producer does not grant the consumer's
+ *   key, or the consumer's door has the producer switched off. Nothing is lost, and the backlog
+ *   waits in the producer's outbox.
+ * - `unresolved`: the platform cannot name both ends. The producer is not installed, or a
+ *   vertical has two primary installs.
+ * - `unavailable`: a side could not be ASKED (a transport error, or a deployment that predates
+ *   the routes). This is not a healthy state and must never render as one. It says nothing about
+ *   whether events are moving.
+ */
+export const edgeHealthState = z.enum(['caught-up', 'behind', 'paused', 'unresolved', 'unavailable']);
+export const edgeHealth = z.object({
+    tenantId,
+    consumer: z.object({ scopeId, vertical: z.string() }),
+    /** `'*'`, with no scope: the consumer could not be asked, so no producer was named. */
+    producer: z.object({ vertical: z.string(), scopeId: scopeId.nullable() }),
+    state: edgeHealthState,
+    /** The sentence a person reads. Set on every state but `caught-up`. */
+    reason: z.string().nullable(),
+    /** The consumer's watermark on this edge. `null`: it has taken nothing yet. */
+    watermark: z.object({ cursor: eventId, updatedAt: instant.nullable() }).nullable(),
+    /** The oldest event waiting past the watermark (released or withheld). */
+    oldestPending: z.object({ id: eventId, occurredAt: z.string() }).nullable(),
+    /** How long the oldest pending event has waited, in ms. `null` when nothing waits, or it is unknown. */
+    lagMs: z.number().int().nonnegative().nullable(),
+    /** Types the consumer imports that the producer does not export. Reported, not paused. */
+    unexported: z.array(wantedEvent),
+    /** The latest sweep pass that moved this edge. */
+    lastDelivered: z.object({ at: instant }).nullable(),
+    /** The latest sweep pass on this edge that did NOT deliver, if it is newer than the last one that did. */
+    lastProblem: z
+        .object({ at: instant, outcome: z.enum(['failed', 'skipped']), error: z.string().nullable() })
+        .nullable(),
+});
+/**
+ * Every edge in one tenant (#1705 PR 3), read live. `history` is the sweep-run read that
+ * supplies `lastDelivered` / `lastProblem`. If it fails, the live states still stand, and the
+ * view says the history is missing rather than showing edges with no past.
+ */
+export const edgeHealthReport = z.object({
+    tenantId,
+    checkedAt: instant,
+    edges: z.array(edgeHealth),
+    /** Set when the tenant's importing apps could not be listed at all: no edge can be shown. */
+    unavailable: z.string().nullable(),
+    history: z.object({ available: z.boolean(), reason: z.string().nullable() }),
+});
+// -- what the console and the dashboard say about an edge (#1705 PR 3) ------------------------
+// One copy, because a tenant and an operator looking at the same edge must be told the same
+// thing: the same label, the same tone, the same lag, and the same request behind the lever.
+/**
+ * How each state reads on a badge. `unavailable` is a side nobody could ask. It says nothing
+ * about whether events move, so it is never `success`, and only a caught-up edge is green.
+ */
+export const EDGE_STATE = {
+    'caught-up': { tone: 'success', label: 'Caught up' },
+    behind: { tone: 'warning', label: 'Behind' },
+    paused: { tone: 'danger', label: 'Paused' },
+    unresolved: { tone: 'warning', label: 'Unresolved' },
+    unavailable: { tone: 'danger', label: 'Unavailable' },
+};
+/**
+ * The badge one edge wears, which is its state's unless the consumer imports types its producer
+ * does not export (`edge.unexported`). Those never arrive, so a caught-up edge carrying them is
+ * not green: it is caught up on what is exported, and waiting forever on the rest.
+ */
+export function edgeBadge(edge) {
+    const base = EDGE_STATE[edge.state];
+    if (edge.unexported.length === 0 || base.tone !== 'success')
+        return base;
+    return { tone: 'warning', label: `${base.label} · ${edge.unexported.length} type(s) never arrive` };
+}
+/** The sentence naming what an edge's producer does not export, or null when it exports all of it. */
+export function unexportedNote(edge) {
+    if (edge.unexported.length === 0)
+        return null;
+    const types = edge.unexported.map((w) => `${w.type} v${w.schemaVersion}`).join(', ');
+    return `'${edge.producer.vertical}' does not export ${types} — this app imports it, and it never arrives until the producer exports it`;
+}
+/** How long the oldest waiting event has waited, in a person's words. */
+export function lagText(ms) {
+    if (ms === null)
+        return null;
+    const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m} min`;
+    const h = Math.floor(m / 60);
+    if (h < 48)
+        return `${h} h`;
+    return `${Math.floor(h / 24)} days`;
+}
+/**
+ * Whether a view of `scopeId` offers the lever on an edge: only on an edge INTO it (the watermark
+ * is the consumer's), and only where both ends resolved and could be asked.
+ */
+export function leverOffered(edge, scopeId) {
+    return (edge.consumer.scopeId === scopeId &&
+        edge.producer.scopeId !== null &&
+        edge.state !== 'unresolved' &&
+        edge.state !== 'unavailable');
+}
+/** What a lever does, in the words the platform refuses a missing acknowledgement in. */
+export const LEVER_EFFECT = { replay: REPLAY_EFFECT, skip: SKIP_EFFECT };
+/** The request a dialog sends once the person has agreed: the whole history, or up to now. */
+export function leverRequest(mode, from, reason) {
+    return mode === 'replay'
+        ? { mode: 'replay', from, after: null, acknowledge: 'rerun-handlers', reason: reason.trim() }
+        : { mode: 'skip', from, through: 'now', acknowledge: 'skip-events', reason: reason.trim() };
+}
 //# sourceMappingURL=vertical-events.js.map

package/dist/vertical-events.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@substrat-run/contracts",
-  "version": "0.120.0",
+  "version": "0.122.0",
   "description": "Substrat kernel contract schemas — Zod is the source of truth (master plan D-22); OAS/JSON Schema are emitted artifacts",
   "license": "Apache-2.0",
   "repository": {