@kelpie/server 0.5.1 → 0.6.0

package/dist/runtime/events.d.ts

@@ -1,3 +1,5 @@
+import type { EventTarget, KelpieEvent } from '@kelpie/schemas';
+import type { ZodType } from 'zod';
 import type { Logger } from '../lib/logger.ts';
 /**
  * In-process typed domain events, per `modules.md`.
@@ -5,135 +7,111 @@ import type { Logger } from '../lib/logger.ts';
  * Delivery is at-least-once within the process, with no durable queue. A crash
  * between commit and dispatch loses the event. A durable outbox is a known
  * follow-up; do not build it before a consumer cannot tolerate the loss.
+ *
+ * Every event carries the envelope defined in `@kelpie/schemas`
+ * (`KelpieEvent<Name, Data>`). Names and payload schemas live in per-module
+ * catalogs the bus registers at boot; two modules cannot declare the same name.
  */
 /**
- * CRM object types that `record.*` events carry. Every object the API writes,
- * including the link and content records.
- *
- * Wider than `EXTENSIBLE_RECORD_TYPES` in `@kelpie/schemas`, which is the
- * shorter list of detail pages a UI module can contribute to. A Position, a
- * Form, and a Handbook page each publish events but have no page to extend.
+ * CRM object types the webhooks bridge treats as deliverable records. Kept
+ * here (rather than folded into a module) because import and webhooks both
+ * read it, and neither owns the list.
  */
 export declare const RECORD_OBJECT_TYPES: readonly ['person', 'company', 'position', 'deal', 'opportunity', 'partnership', 'raise', 'role', 'candidate', 'handbook_page', 'form'];
 export type RecordObjectType = (typeof RECORD_OBJECT_TYPES)[number];
-/** Objects whose stage or status moves through a pipeline. */
-export type StagedObjectType = 'deal' | 'opportunity' | 'raise' | 'partnership';
 /**
- * The event catalog. Every payload carries `workspaceId`: a consumer must never
- * have to look up which tenant an event belongs to.
+ * The compile-time event catalog.
  *
- * Adding an event means adding a key here. The name is the key, so a typo is a
- * compile error rather than a subscription that never fires.
+ * Modules extend this interface via TypeScript declaration merging, one
+ * declaration per module. The runtime catalog (see `registerCatalog`) is the
+ * authority; this interface is what gives autocomplete and payload typing at
+ * every `publish` and `subscribe` call site.
  */
-export interface DomainEvents {
-    'workspace.created': {
-        workspaceId: string;
-        slug: string;
-    };
-    /** Fires after the cascade, so nothing the workspace owned still exists. */
-    'workspace.deleted': {
-        workspaceId: string;
-        slug: string;
-    };
-    'member.invited': {
-        workspaceId: string;
-        inviteId: string;
-        email: string;
-    };
-    'member.joined': {
-        workspaceId: string;
-        memberId: string;
-        userId: string;
-    };
-    /** Pairs with `member.joined`, which is what a seat count subscribes to. */
-    'member.removed': {
-        workspaceId: string;
-        memberId: string;
-        userId: string;
-    };
-    'record.created': {
-        workspaceId: string;
-        objectType: RecordObjectType;
-        recordId: string;
-    };
-    'record.updated': {
-        workspaceId: string;
-        objectType: RecordObjectType;
-        recordId: string;
-        changedFields: readonly string[];
-    };
-    'record.deleted': {
-        workspaceId: string;
-        objectType: RecordObjectType;
-        recordId: string;
-    };
-    'stage.changed': {
-        workspaceId: string;
-        objectType: StagedObjectType;
-        recordId: string;
-        fromStageId: string | null;
-        toStageId: string;
-    };
-    'note.added': {
-        workspaceId: string;
-        noteId: string;
-        targetType: string;
-        targetId: string;
-    };
-    'decision.added': {
-        workspaceId: string;
-        decisionId: string;
-        targetType: string;
-        targetId: string;
-    };
-    'plan.completed': {
-        workspaceId: string;
-        planItemId: string;
-        targetType: string;
-        targetId: string;
-    };
-    'form.submitted': {
-        workspaceId: string;
-        formId: string;
-        submissionId: string;
-    };
-    'import.completed': {
-        workspaceId: string;
-        importJobId: string;
-        object: string;
-    };
-    'agent_run.finished': {
-        workspaceId: string;
-        agentRunId: string;
-        status: 'succeeded' | 'failed';
-    };
+export interface KelpieEventMap {
 }
-export type DomainEventName = keyof DomainEvents;
 /**
- * The catalog as data. Webhooks needs the deliverable event names at runtime, and
- * `satisfies` keeps this list from drifting from the interface above.
- *
- * An event added to `DomainEvents` but forgotten here is caught by
- * `createHandlerRegistry`, which must produce an entry for every name.
+ * When `KelpieEventMap` is empty (no module has declared an event yet) `keyof`
+ * is `never`, which would make every `EventHandler` signature unusable. The
+ * fallback keeps types working during boot and in tests that build the bus
+ * without any modules registered.
  */
-export declare const DOMAIN_EVENT_NAMES: readonly ["workspace.created", "workspace.deleted", "member.invited", "member.joined", "member.removed", "record.created", "record.updated", "record.deleted", "stage.changed", "note.added", "decision.added", "plan.completed", "form.submitted", "import.completed", "agent_run.finished"];
+type EventMapWithFallback = keyof KelpieEventMap extends never ? Readonly<Record<string, unknown>> : KelpieEventMap;
+export type EventName = string & keyof EventMapWithFallback;
 /** Handlers are async and must be idempotent: the same event may arrive twice. */
-export type EventHandler<Name extends DomainEventName> = (payload: DomainEvents[Name]) => Promise<void>;
+export type EventHandler<Name extends EventName> = (event: KelpieEvent<Name, EventMapWithFallback[Name]>) => Promise<void> | void;
+/** Prefix subscribers see events they cannot name statically. */
+export type AnyEventHandler = (event: KelpieEvent<string, unknown>) => Promise<void> | void;
+/**
+ * What a module hands the runtime at registration: the module's id and the Zod
+ * schema for every event name the module publishes.
+ */
+export interface EventCatalog {
+    readonly moduleId: string;
+    readonly events: Readonly<Record<string, ZodType>>;
+}
+/** One frame in the causation chain that produced an event. */
+export interface EventChainEntry {
+    readonly id: string;
+    readonly name: string;
+    readonly targetType: string;
+    readonly targetId: string;
+}
+export declare function currentEventChain(): readonly EventChainEntry[];
+/**
+ * Runs the cycle guard against the current chain. Called from the transaction
+ * scope's `emit` before it buffers the event.
+ */
+export declare function checkEventCycle(chain: readonly EventChainEntry[], name: string, target: EventTarget, maxDepth: number): CycleGuardOutcome;
+export type CycleGuardOutcome = {
+    readonly kind: 'ok';
+} | {
+    readonly kind: 'depth';
+} | {
+    readonly kind: 'repeat';
+};
+export interface SubscribeOptions {
+    /** Shown in logs when the handler fails or times out. Defaults to the event name. */
+    readonly label?: string;
+    /** Overrides the bus-wide default. */
+    readonly timeoutMs?: number;
+}
 export interface EventBus {
-    /** Registers a handler. Handlers for one event run concurrently, not in order. */
-    subscribe<Name extends DomainEventName>(name: Name, handler: EventHandler<Name>): void;
+    /**
+     * Registers a module's event catalog. Called by `registerModules` at boot,
+     * once per module that declares events. Two modules cannot declare the same
+     * event name; the second call throws.
+     */
+    registerCatalog(catalog: EventCatalog): void;
+    /** True if any module has declared this event name. */
+    hasEvent(name: string): boolean;
+    /** The payload schema registered for this event, or `undefined` if unknown. */
+    getSchema(name: string): ZodType | undefined;
+    /**
+     * Subscribe to an event by exact name. Handlers for one event run
+     * concurrently, each in its own error and timeout boundary.
+     */
+    subscribe<Name extends EventName>(name: Name, handler: EventHandler<Name>, options?: SubscribeOptions): void;
+    /**
+     * Subscribe to every event whose name starts with `prefix`. Runs concurrently
+     * with exact-name subscribers. Match is a plain `startsWith`; there is no
+     * pattern language.
+     */
+    subscribePrefix(prefix: string, handler: AnyEventHandler, options?: SubscribeOptions): void;
     /**
      * Dispatches immediately. Services should not call this directly: they emit
      * through the transaction scope so nothing fires before the commit.
-     *
-     * @returns A promise that settles when every handler for this event has settled.
      */
-    publish<Name extends DomainEventName>(name: Name, payload: DomainEvents[Name]): Promise<void>;
+    publish<Name extends EventName>(event: KelpieEvent<Name, EventMapWithFallback[Name]>): Promise<void>;
     /**
      * Settles once every in-flight publication has finished, including any a
      * handler started. Used by tests, and by shutdown to flush before exit.
      */
     drain(): Promise<void>;
 }
-export declare function createEventBus(logger: Logger): EventBus;
+export interface EventBusOptions {
+    /** Default per-handler timeout in ms. Defaults to 5000. */
+    readonly defaultHandlerTimeoutMs?: number;
+}
+export declare function createEventBus(logger: Logger, options?: EventBusOptions): EventBus;
+export {};
 //# sourceMappingURL=events.d.ts.map

package/dist/runtime/events.d.ts.map

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

package/dist/runtime/events.js

@@ -1,3 +1,5 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import Emittery from 'emittery';
 import { describeThrown } from '../lib/errors.js';
 /**
  * In-process typed domain events, per `modules.md`.
@@ -5,14 +7,15 @@ import { describeThrown } from '../lib/errors.js';
  * Delivery is at-least-once within the process, with no durable queue. A crash
  * between commit and dispatch loses the event. A durable outbox is a known
  * follow-up; do not build it before a consumer cannot tolerate the loss.
+ *
+ * Every event carries the envelope defined in `@kelpie/schemas`
+ * (`KelpieEvent<Name, Data>`). Names and payload schemas live in per-module
+ * catalogs the bus registers at boot; two modules cannot declare the same name.
  */
 /**
- * CRM object types that `record.*` events carry. Every object the API writes,
- * including the link and content records.
- *
- * Wider than `EXTENSIBLE_RECORD_TYPES` in `@kelpie/schemas`, which is the
- * shorter list of detail pages a UI module can contribute to. A Position, a
- * Form, and a Handbook page each publish events but have no page to extend.
+ * CRM object types the webhooks bridge treats as deliverable records. Kept
+ * here (rather than folded into a module) because import and webhooks both
+ * read it, and neither owns the list.
  */
 export const RECORD_OBJECT_TYPES = [
     'person',
@@ -28,63 +31,131 @@ export const RECORD_OBJECT_TYPES = [
     'form',
 ];
 /**
- * The catalog as data. Webhooks needs the deliverable event names at runtime, and
- * `satisfies` keeps this list from drifting from the interface above.
+ * The chain of ancestor events currently being handled, keyed against the async
+ * context that started them. `undefined` outside any handler.
  *
- * An event added to `DomainEvents` but forgotten here is caught by
- * `createHandlerRegistry`, which must produce an entry for every name.
+ * The bus wraps every `publish` in `run(child, ...)`, so a handler that opens a
+ * transaction and calls `emit(...)` inherits the chain. The transaction scope
+ * reads this to stamp `causedBy` and to run the cycle guard.
  */
-export const DOMAIN_EVENT_NAMES = [
-    'workspace.created',
-    'workspace.deleted',
-    'member.invited',
-    'member.joined',
-    'member.removed',
-    'record.created',
-    'record.updated',
-    'record.deleted',
-    'stage.changed',
-    'note.added',
-    'decision.added',
-    'plan.completed',
-    'form.submitted',
-    'import.completed',
-    'agent_run.finished',
-];
+const chainStorage = new AsyncLocalStorage();
+export function currentEventChain() {
+    return chainStorage.getStore() ?? [];
+}
 /**
- * Every name gets a list up front. TypeScript cannot check a write through a
- * generic key, so pre-seeding turns `subscribe` into a read plus a push, which it
- * can check. The one assertion is building a complete record from its own key list.
+ * Runs the cycle guard against the current chain. Called from the transaction
+ * scope's `emit` before it buffers the event.
  */
-function createHandlerRegistry() {
-    const registry = {};
-    for (const name of DOMAIN_EVENT_NAMES) {
-        registry[name] = [];
+export function checkEventCycle(chain, name, target, maxDepth) {
+    if (chain.length >= maxDepth) {
+        return { kind: 'depth' };
+    }
+    for (const entry of chain) {
+        if (entry.name === name && entry.targetType === target.type && entry.targetId === target.id) {
+            return { kind: 'repeat' };
+        }
     }
-    return registry;
+    return { kind: 'ok' };
 }
-export function createEventBus(logger) {
-    const handlers = createHandlerRegistry();
+const DEFAULT_HANDLER_TIMEOUT_MS = 5000;
+export function createEventBus(logger, options = {}) {
+    const emittery = new Emittery();
+    const schemas = new Map();
+    const owners = new Map();
+    const prefixHandlers = [];
     const inFlight = new Set();
+    const defaultTimeoutMs = options.defaultHandlerTimeoutMs ?? DEFAULT_HANDLER_TIMEOUT_MS;
+    function wrap(label, timeoutMs, handler, context) {
+        return async (event) => {
+            let timerHandle;
+            const timedOut = Symbol('timeout');
+            const timer = new Promise((resolve) => {
+                timerHandle = setTimeout(() => resolve(timedOut), timeoutMs);
+                timerHandle.unref?.();
+            });
+            try {
+                const outcome = await Promise.race([
+                    Promise.resolve().then(() => handler(event)),
+                    timer,
+                ]);
+                if (outcome === timedOut) {
+                    logger.error('event handler timed out', { label, timeoutMs, ...context(event) });
+                }
+            }
+            catch (error) {
+                logger.error('event handler failed', {
+                    label,
+                    error: describeThrown(error),
+                    ...context(event),
+                });
+            }
+            finally {
+                if (timerHandle !== undefined) {
+                    clearTimeout(timerHandle);
+                }
+            }
+        };
+    }
     return {
-        subscribe(name, handler) {
-            handlers[name].push(handler);
-        },
-        publish(name, payload) {
-            const registered = handlers[name];
-            const settled = Promise.allSettled(registered.map((handler) => handler(payload))).then((outcomes) => {
-                for (const outcome of outcomes) {
-                    if (outcome.status === 'rejected') {
-                        logger.error('event handler failed', {
-                            event: name,
-                            error: describeThrown(outcome.reason),
-                        });
-                    }
+        registerCatalog(catalog) {
+            for (const [name, schema] of Object.entries(catalog.events)) {
+                const existing = owners.get(name);
+                if (existing !== undefined) {
+                    throw new Error(`event "${name}" is declared by both module "${existing}" and module "${catalog.moduleId}"`);
                 }
+                owners.set(name, catalog.moduleId);
+                schemas.set(name, schema);
+            }
+        },
+        hasEvent(name) {
+            return schemas.has(name);
+        },
+        getSchema(name) {
+            return schemas.get(name);
+        },
+        subscribe(name, handler, subscribeOptions) {
+            const label = subscribeOptions?.label ?? name;
+            const timeoutMs = subscribeOptions?.timeoutMs ?? defaultTimeoutMs;
+            const wrapped = wrap(label, timeoutMs, (event) => {
+                const envelope = event.data;
+                return handler(envelope);
+            }, (event) => {
+                const envelope = event.data;
+                return { event: envelope.name, eventId: envelope.id };
+            });
+            emittery.on(name, wrapped);
+        },
+        subscribePrefix(prefix, handler, subscribeOptions) {
+            const label = subscribeOptions?.label ?? `${prefix}*`;
+            const timeoutMs = subscribeOptions?.timeoutMs ?? defaultTimeoutMs;
+            prefixHandlers.push({
+                prefix,
+                label,
+                run: wrap(label, timeoutMs, handler, (event) => ({ event: event.name, eventId: event.id })),
             });
+        },
+        publish(event) {
+            const parent = chainStorage.getStore() ?? [];
+            const child = [
+                ...parent,
+                {
+                    id: event.id,
+                    name: event.name,
+                    targetType: event.target.type,
+                    targetId: event.target.id,
+                },
+            ];
+            const matching = prefixHandlers.filter((entry) => event.name.startsWith(entry.prefix));
+            const typedEvent = event;
+            const settled = chainStorage.run(child, () => Promise.allSettled([
+                emittery.emit(event.name, typedEvent),
+                ...matching.map((entry) => entry.run(typedEvent)),
+            ]));
             inFlight.add(settled);
-            void settled.finally(() => inFlight.delete(settled));
-            return settled;
+            void settled.finally(() => {
+                inFlight.delete(settled);
+            });
+            return settled.then(() => undefined);
         },
         async drain() {
             // A handler may publish further events, so keep draining until the set is

package/dist/runtime/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/runtime/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGjD;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ;IACR,SAAS;IACT,UAAU;IACV,MAAM;IACN,aAAa;IACb,aAAa;IACb,OAAO;IACP,MAAM;IACN,WAAW;IACX,eAAe;IACf,MAAM;CACE,CAAA;AA+CV;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,mBAAmB;IACnB,mBAAmB;IACnB,gBAAgB;IAChB,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,eAAe;IACf,YAAY;IACZ,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,kBAAkB;IAClB,oBAAoB;CACyB,CAAA;AA6B/C;;;;GAIG;AACH,SAAS,qBAAqB;IAC5B,MAAM,QAAQ,GAA6B,EAAE,CAAA;IAE7C,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,CAAC;QACtC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;IACrB,CAAC;IAED,OAAO,QAA2B,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAA;IACxC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAiB,CAAA;IAEzC,OAAO;QACL,SAAS,CAAC,IAAI,EAAE,OAAO;YACrB,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC9B,CAAC;QAED,OAAO,CAAC,IAAI,EAAE,OAAO;YACnB,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;YAEjC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CACpF,CAAC,QAAQ,EAAE,EAAE;gBACX,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;oBAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;wBAClC,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE;4BACnC,KAAK,EAAE,IAAI;4BACX,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC;yBACtC,CAAC,CAAA;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC,CACF,CAAA;YAED,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACrB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;YAEpD,OAAO,OAAO,CAAA;QAChB,CAAC;QAED,KAAK,CAAC,KAAK;YACT,0EAA0E;YAC1E,iDAAiD;YACjD,OAAO,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAA;YACzC,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/runtime/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAGpD,OAAO,QAAQ,MAAM,UAAU,CAAA;AAG/B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGjD;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ;IACR,SAAS;IACT,UAAU;IACV,MAAM;IACN,aAAa;IACb,aAAa;IACb,OAAO;IACP,MAAM;IACN,WAAW;IACX,eAAe;IACf,MAAM;CACE,CAAA;AAoDV;;;;;;;GAOG;AACH,MAAM,YAAY,GAAG,IAAI,iBAAiB,EAA8B,CAAA;AAExE,MAAM,UAAU,iBAAiB;IAC/B,OAAO,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAA;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAiC,EACjC,IAAY,EACZ,MAAmB,EACnB,QAAgB;IAEhB,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IAC1B,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC;YAC5F,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACvB,CAAC;AA2DD,MAAM,0BAA0B,GAAG,IAAI,CAAA;AA0BvC,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,OAAO,GAAoB,EAAE;IAC1E,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAkC,CAAA;IAC/D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAA;IAC1C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;IACxC,MAAM,cAAc,GAAoB,EAAE,CAAA;IAC1C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAA;IAC5C,MAAM,gBAAgB,GAAG,OAAO,CAAC,uBAAuB,IAAI,0BAA0B,CAAA;IAEtF,SAAS,IAAI,CACX,KAAa,EACb,SAAiB,EACjB,OAA+C,EAC/C,OAA4D;QAE5D,OAAO,KAAK,EAAE,KAAK,EAAE,EAAE;YACrB,IAAI,WAAuC,CAAA;YAC3C,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;YAClC,MAAM,KAAK,GAAG,IAAI,OAAO,CAAkB,CAAC,OAAO,EAAE,EAAE;gBACrD,WAAW,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAA;gBAC5D,WAAW,CAAC,KAAK,EAAE,EAAE,CAAA;YACvB,CAAC,CAAC,CAAA;YAEF,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;oBACjC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;oBAC5C,KAAK;iBACN,CAAC,CAAA;gBACF,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACzB,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;gBAClF,CAAC;YACH,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE;oBACnC,KAAK;oBACL,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC;oBAC5B,GAAG,OAAO,CAAC,KAAK,CAAC;iBAClB,CAAC,CAAA;YACJ,CAAC;oBAAS,CAAC;gBACT,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;oBAC9B,YAAY,CAAC,WAAW,CAAC,CAAA;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC,CAAA;IACH,CAAC;IAED,OAAO;QACL,eAAe,CAAC,OAAO;YACrB,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBACjC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,MAAM,IAAI,KAAK,CACb,UAAU,IAAI,iCAAiC,QAAQ,iBAAiB,OAAO,CAAC,QAAQ,GAAG,CAC5F,CAAA;gBACH,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;gBAClC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YAC3B,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,IAAI;YACX,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC1B,CAAC;QAED,SAAS,CAAC,IAAI;YACZ,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC1B,CAAC;QAED,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,gBAAgB;YACvC,MAAM,KAAK,GAAG,gBAAgB,EAAE,KAAK,IAAI,IAAI,CAAA;YAC7C,MAAM,SAAS,GAAG,gBAAgB,EAAE,SAAS,IAAI,gBAAgB,CAAA;YACjE,MAAM,OAAO,GAAG,IAAI,CAClB,KAAK,EACL,SAAS,EACT,CAAC,KAAK,EAAE,EAAE;gBACR,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAoC,CAAA;gBAC3D,OAAO,OAAO,CAAC,QAAiB,CAAC,CAAA;YACnC,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;gBACR,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAoC,CAAA;gBAC3D,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAA;YACvD,CAAC,CACF,CAAA;YACD,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAC5B,CAAC;QAED,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,gBAAgB;YAC/C,MAAM,KAAK,GAAG,gBAAgB,EAAE,KAAK,IAAI,GAAG,MAAM,GAAG,CAAA;YACrD,MAAM,SAAS,GAAG,gBAAgB,EAAE,SAAS,IAAI,gBAAgB,CAAA;YACjE,cAAc,CAAC,IAAI,CAAC;gBAClB,MAAM;gBACN,KAAK;gBACL,GAAG,EAAE,IAAI,CACP,KAAK,EACL,SAAS,EACT,OAAO,EACP,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CACtD;aACF,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,CAAC,KAAK;YACX,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAA;YAC5C,MAAM,KAAK,GAAsB;gBAC/B,GAAG,MAAM;gBACT;oBACE,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;oBAC7B,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;iBAC1B;aACF,CAAA;YAED,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;YACtF,MAAM,UAAU,GAAG,KAAqC,CAAA;YAExD,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,CAC3C,OAAO,CAAC,UAAU,CAAC;gBACjB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC;gBACrC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;aAClD,CAAC,CACH,CAAA;YAED,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACrB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE;gBACxB,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YAC1B,CAAC,CAAC,CAAA;YAEF,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QACtC,CAAC;QAED,KAAK,CAAC,KAAK;YACT,0EAA0E;YAC1E,iDAAiD;YACjD,OAAO,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAA;YACzC,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/runtime/module.d.ts

@@ -5,6 +5,7 @@ import type { Database } from '../lib/database.ts';
 import type { EmailSender } from '../lib/email.ts';
 import type { IdFactory } from '../lib/ids.ts';
 import type { Logger } from '../lib/logger.ts';
+import type { SecretEncryptionConfig } from '../lib/secrets.ts';
 import type { EntitlementRegistry } from './entitlements.ts';
 import type { EventBus } from './events.ts';
 import type { TransactionScope } from './transaction.ts';
@@ -62,16 +63,54 @@ export interface ModuleServices {
     readonly db: Database;
     /** Runs work in one transaction and publishes its events after commit. */
     readonly transaction: TransactionScope;
-    /** Transactional mail only: invites and password resets. */
-    readonly email: EmailSender;
     /** Generates `<prefix>_<ulid>` ids. Injected so tests can pin them. */
     readonly createId: IdFactory;
     /** The current time, injected so expiry logic is testable. */
     readonly now: () => Date;
+    /**
+     * The deployment's base URL, when the assembly declares `appBaseUrl` in
+     * `kelpie.config.ts`. Modules that need it prefer this over
+     * `context.config(appUrlConfigSchema)`, which they fall back to when this is
+     * undefined (older assemblies).
+     */
+    readonly appBaseUrl?: string | undefined;
+    /**
+     * The keys that seal stored secrets, when the assembly declares
+     * `secretEncryption`. Same fallback pattern as `appBaseUrl`.
+     */
+    readonly secretEncryption?: SecretEncryptionConfig | undefined;
 }
 export interface ModuleContext extends ModuleServices {
     /** Registers routes. They mount under `/v1` and are public API like any other. */
     routes(mount: (router: Hono) => void): void;
+    /**
+     * Registers a named transactional-mail provider. `name` is what the assembly
+     * puts in `kelpie.config.ts`'s `email.provider`; the runtime resolves that
+     * field against the registry after every module has registered.
+     *
+     * `build` is a factory the runtime calls exactly once, and only for the
+     * provider `email.provider` picked. A provider that is registered but never
+     * picked never has its factory called, so a module can register itself
+     * without demanding its own env up front: a self-hoster who leaves the
+     * built-in `smtp-email` core module in `coreModules` while running on
+     * `EMAIL_PROVIDER=log` will not be asked for SMTP credentials at boot.
+     * The factory may throw; the runtime wraps the error with the module id.
+     *
+     * Any number of modules may register different names side by side. Two
+     * modules registering the same name fails boot. `'log'` is registered by
+     * the runtime itself, so a module that tries to shadow it fails boot too.
+     *
+     * `context.email` is a proxy: every module receives the same object, and
+     * its `send` delegates to whichever provider `email.provider` picked.
+     * Consumer modules capture the proxy at register time; registration order
+     * does not matter.
+     */
+    provideEmailSender(name: string, build: () => EmailSender): void;
+    /**
+     * Transactional mail. Every module receives the same proxy; `.send()`
+     * delegates to the provider `email.provider` picked.
+     */
+    readonly email: EmailSender;
     /**
      * Registers routes that mount under `/v1/public`, take no credentials, and
      * answer cross-origin requests from any site.
@@ -143,6 +182,14 @@ export interface ModuleCatalogEntry {
     readonly id: string;
     readonly structural: boolean;
 }
+/**
+ * A module's event catalog: the Zod schema for every event name the module
+ * publishes. Registered with the bus at boot; two modules cannot claim the same
+ * name.
+ */
+export interface ModuleEventCatalog {
+    readonly [eventName: string]: ZodType;
+}
 export interface KelpieModule {
     readonly id: string;
     /** Ids of modules that must register first. Missing ones fail boot. */
@@ -157,6 +204,11 @@ export interface KelpieModule {
      * without its author having to opt in.
      */
     readonly structural?: boolean;
+    /**
+     * The events this module publishes, as a runtime catalog. Optional: a module
+     * that only consumes events, or contributes none, may omit it.
+     */
+    readonly events?: ModuleEventCatalog;
     register(context: ModuleContext): Promise<void>;
 }
 //# sourceMappingURL=module.d.ts.map

package/dist/runtime/module.d.ts.map

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

package/dist/runtime/registry.d.ts

@@ -2,6 +2,7 @@ import { Hono } from 'hono';
 import type { Context, Handler, MiddlewareHandler } from 'hono';
 import type { Actor } from '../lib/actor.ts';
 import type { Environment } from '../lib/config.ts';
+import type { EmailSender } from '../lib/email.ts';
 import type { Logger } from '../lib/logger.ts';
 import type { EntitlementRegistry } from './entitlements.ts';
 import type { EventBus } from './events.ts';
@@ -62,6 +63,28 @@ export interface ModuleRuntimeOptions {
     readonly entitlements?: EntitlementRegistry | undefined;
     /** The database, transaction scope, and collaborators every module builds on. */
     readonly services: ModuleServices;
+    /**
+     * Picks the transactional-mail provider. `provider` is a name a module
+     * registered via `context.provideEmailSender(name, sender)`. `'log'` is a
+     * built-in the runtime always registers using its own logger and `from`, so
+     * a bare install boots without a provider module.
+     *
+     * `from` is the address on every outgoing message. The log provider uses it
+     * verbatim; other providers may read the same value through their own
+     * `context.config` if they need to.
+     */
+    readonly email: {
+        readonly provider: string;
+        readonly from: string;
+    };
+    /**
+     * Extra named providers seeded into the registry before any module runs.
+     * Modules still register through `context.provideEmailSender`; these are for
+     * tests that want to inspect what was sent without building a whole module.
+     * A name collision with a module (or with `'log'`) fails boot exactly as if
+     * two modules had registered it.
+     */
+    readonly additionalEmailProviders?: ReadonlyMap<string, EmailSender> | undefined;
     /**
      * The deploy-time module override (`lib/moduleConfig.ts`), parsed. A locked
      * module id wins over whatever a workspace's own settings say.

package/dist/runtime/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/runtime/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAA;AAE/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EAGP,cAAc,EACd,kBAAkB,EACnB,MAAM,aAAa,CAAA;AAIpB;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;IACzC,0FAA0F;IAC1F,QAAQ,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,CAAA;IAC/C,qFAAqF;IACrF,QAAQ,CAAC,aAAa,EAAE,SAAS,yBAAyB,EAAE,CAAA;IAC5D,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAA;IACnD,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAC/C,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IACrC,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;IACzB,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAA;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;CACpC;AAwBD;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;IACzC,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;IACtC,yEAAyE;IACzE,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAA;IACvD,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAA;IACrE;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,CAAA;CAC3E;AA8HD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA2EjG"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/runtime/registry.ts"],"names":[],"mappings":"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"}