@arki/event-sourcing 0.1.5 → 0.2.1

package/dist/dot.js

@@ -2,7 +2,7 @@
  * DOT adapter for `@arki/event-sourcing`.
  *
  * Wraps `eventSourcingFeatures.initEventSourcing` + `initMessageBus` as a
- * single `DotPip`. The pip opens the PostgreSQL event store in
+ * single `DotPlugin`. The plugin opens the PostgreSQL event store in
  * `boot`, attaches command handlers to an in-memory message bus, publishes
  * both as `services.eventStore` and `services.messageBus`, and closes the
  * event store pool in `dispose` (reverse declaration order).
@@ -36,18 +36,50 @@
  * Importing this adapter without `@arki/dot` installed will fail at module
  * load — that is intentional: the adapter only makes sense in a DOT app.
  */
-import { pip, DotPipError } from '@arki/dot/pip';
+import { plugin, DotPluginError } from '@arki/dot/plugin';
+import { debugBuilder } from './debug.js';
 import { EVENT_STORE_URL_VARIANTS, eventSourcingFeatures } from './event-sourcing-features.js';
 /**
- * Stable error codes thrown by the event-sourcing pip. Exported so consumers
+ * Stable error codes thrown by the event-sourcing plugin. Exported so consumers
  * and coding agents can match against them — never parse the message.
  *
  * @see packages/dot/docs/principles.md — principle 1.3 ("errors are part
  * of the API") and principle 4 ("agent-discoverable everywhere").
  */
-export const EVENT_SOURCING_PIP_ERROR_CODES = {
+export const EVENT_SOURCING_PLUGIN_ERROR_CODES = {
     /** boot was called without a configured event-store URL. */
-    dbUrlNotConfigured: 'EVENT_SOURCING_PIP_E001',
+    dbUrlNotConfigured: 'EVENT_SOURCING_PLUGIN_E001',
+    /** two collected handlers claim the same command type. */
+    duplicateCommandHandler: 'EVENT_SOURCING_PLUGIN_E002',
+    /** a bundle token listed in options.bundles was not provided. */
+    bundleMissing: 'EVENT_SOURCING_PLUGIN_E003',
+    /** a command was dispatched with no registered handler. */
+    commandHandlerMissing: 'EVENT_SOURCING_PLUGIN_E004',
+    /** a command was dispatched after the dispatcher closed. */
+    dispatcherClosed: 'EVENT_SOURCING_PLUGIN_E005',
+    /** reserved for a future declared-action/handler parity diagnostic. */
+    declaredActionUnbound: 'EVENT_SOURCING_PLUGIN_E006',
+    /** command/event schema could not be converted to JSON Schema. */
+    schemaRejected: 'EVENT_SOURCING_PLUGIN_E007',
+};
+const EVENT_SOURCING_PLUGIN_VERSION = '0.2.0';
+function bundle(input = {}) {
+    return {
+        handlers: input.handlers ?? [],
+        readModels: input.readModels ?? [],
+    };
+}
+function handle(command, handler, getStreamName) {
+    return {
+        commandType: command.type,
+        handler,
+        getStreamName,
+    };
+}
+/** Namespace for feature-local ES bundle helpers. */
+export const es = {
+    bundle,
+    handle,
 };
 /**
  * Resolve the event-store connection URL from explicit options first, then
@@ -64,50 +96,200 @@ function resolveDbUrl(explicit) {
     }
     return undefined;
 }
+function dotPluginError(args) {
+    return new DotPluginError({
+        code: args.code,
+        message: args.message,
+        remediation: args.remediation,
+        docsUrl: `https://arki.dev/event-sourcing/errors/${args.docsSlug}`,
+    });
+}
+function assertUniqueCommandHandlers(commandHandlers) {
+    const seen = new Map();
+    for (const registration of commandHandlers) {
+        const count = seen.get(registration.commandType) ?? 0;
+        seen.set(registration.commandType, count + 1);
+    }
+    const duplicate = [...seen.entries()].find(([, count]) => count > 1)?.[0];
+    if (duplicate === undefined)
+        return;
+    throw dotPluginError({
+        code: EVENT_SOURCING_PLUGIN_ERROR_CODES.duplicateCommandHandler,
+        message: `[event-sourcing] command handler "${duplicate}" is registered more than once.`,
+        remediation: 'Each command type may have exactly one handler across options.bundles and dynamic commandHandlers. Remove one registration or rename the command type.',
+        docsSlug: 'event-sourcing-plugin-e002',
+    });
+}
+function controlledMessageBus(inner, commandTypes) {
+    let closed = false;
+    let inflight = 0;
+    const waiters = [];
+    const finishOne = () => {
+        inflight -= 1;
+        if (inflight !== 0)
+            return;
+        const drained = waiters.splice(0);
+        for (const waiter of drained)
+            waiter();
+    };
+    return {
+        async send(command) {
+            if (closed) {
+                throw dotPluginError({
+                    code: EVENT_SOURCING_PLUGIN_ERROR_CODES.dispatcherClosed,
+                    message: `[event-sourcing] command "${command.type}" was dispatched after the message bus closed.`,
+                    remediation: 'Do not send commands after app.stop() begins. Stop ingress before closing event-sourcing consumers.',
+                    docsSlug: 'event-sourcing-plugin-e005',
+                });
+            }
+            if (!commandTypes.has(command.type)) {
+                throw dotPluginError({
+                    code: EVENT_SOURCING_PLUGIN_ERROR_CODES.commandHandlerMissing,
+                    message: `[event-sourcing] no command handler is registered for "${command.type}".`,
+                    remediation: 'Declare a feature ES bundle with es.handle(...), publish it before eventSourcing(...), and list its token in options.bundles.',
+                    docsSlug: 'event-sourcing-plugin-e004',
+                });
+            }
+            inflight += 1;
+            try {
+                await inner.send(command);
+            }
+            finally {
+                finishOne();
+            }
+        },
+        publish: event => inner.publish(event),
+        schedule: (message, when) => {
+            inner.schedule(message, when);
+        },
+        close() {
+            closed = true;
+            if (inflight === 0)
+                return Promise.resolve();
+            return new Promise(resolve => {
+                waiters.push(resolve);
+            });
+        },
+    };
+}
 /**
- * Build a DOT pip that opens the event store, wires command handlers
+ * Build a DOT plugin that opens the event store, wires command handlers
  * into an in-memory message bus, and publishes both as services. The
  * kernel calls `dispose` in reverse declaration order to release the
  * underlying PG pool.
  */
-export function eventSourcing(options) {
-    const commandHandlers = options.commandHandlers ?? [];
+export function eventSourcing(options = {}) {
+    const bundleTokens = options.bundles ?? [];
+    const featureTokens = options.features ?? [];
+    const needs = {};
+    for (const tok of [...bundleTokens, ...featureTokens]) {
+        if (needs[tok.key] !== undefined) {
+            throw dotPluginError({
+                code: EVENT_SOURCING_PLUGIN_ERROR_CODES.duplicateCommandHandler,
+                message: `[event-sourcing] token "${tok.key}" is listed twice across options.bundles/options.features.`,
+                remediation: 'List each ES bundle or feature token once.',
+                docsSlug: 'event-sourcing-plugin-e002',
+            });
+        }
+        needs[tok.key] = tok;
+    }
     // Captured at boot so dispose can call it without re-reading services
     // (dispose is allowed to run even when services failed to publish).
     let closeStore;
-    return pip({
+    let closeBus;
+    const inner = plugin({
         name: 'event-sourcing',
-        version: '0.1.0',
+        version: EVENT_SOURCING_PLUGIN_VERSION,
+        needs,
         configure(ctx) {
             ctx.registerService('eventStore', 'event-store');
             ctx.registerService('messageBus', 'message-bus');
+            ctx.registerProjection({
+                format: 'event-catalog',
+                binding: 'es',
+                module: '@arki/event-sourcing/projection',
+            });
             ctx.declareProvides('event-store', 'message-bus');
         },
-        boot() {
-            // Validate at the pip boundary so the DOT lifecycle gets a coded
+        boot(ctx) {
+            // Validate at the plugin boundary so the DOT lifecycle gets a coded
             // error. `eventSourcingFeatures.initEventSourcing` still throws raw
             // `Error` for non-DOT consumers (its public contract is unchanged);
             // the check here makes sure we never reach it without a URL.
             const dbUrl = resolveDbUrl(options.dbUrl);
             if (dbUrl === undefined) {
-                throw new DotPipError({
-                    code: EVENT_SOURCING_PIP_ERROR_CODES.dbUrlNotConfigured,
+                throw new DotPluginError({
+                    code: EVENT_SOURCING_PLUGIN_ERROR_CODES.dbUrlNotConfigured,
                     message: '[event-sourcing] Event Store database URL is not configured.',
                     remediation: `Pass options.dbUrl to eventSourcing(...) or set one of ${EVENT_STORE_URL_VARIANTS.join(', ')} in the environment before booting the app.`,
-                    docsUrl: 'https://arki.dev/dot/errors/event-sourcing-pip-e001',
+                    docsUrl: 'https://arki.dev/dot/errors/event-sourcing-plugin-e001',
                 });
             }
-            const { eventStore, close } = eventSourcingFeatures.initEventSourcing(options.projections, dbUrl);
+            const record = ctx;
+            const bundles = [];
+            for (const tok of bundleTokens) {
+                const collected = record[tok.key];
+                if (collected === undefined) {
+                    throw dotPluginError({
+                        code: EVENT_SOURCING_PLUGIN_ERROR_CODES.bundleMissing,
+                        message: `[event-sourcing] bundle "${tok.key}" was not provided by any earlier plugin.`,
+                        remediation: 'Mount the plugin that publishes this ES bundle before eventSourcing(...). The typed builder enforces this; erased composition reaches this check.',
+                        docsSlug: 'event-sourcing-plugin-e003',
+                    });
+                }
+                bundles.push(collected);
+            }
+            const featureRecord = ctx;
+            for (const tok of featureTokens) {
+                const slice = featureRecord[tok.key];
+                if (slice === undefined) {
+                    throw dotPluginError({
+                        code: EVENT_SOURCING_PLUGIN_ERROR_CODES.bundleMissing,
+                        message: `[event-sourcing] feature "${tok.key}" was not provided by any earlier plugin.`,
+                        remediation: 'Mount the feature plugin that provides this token before eventSourcing(...). The typed builder enforces this; erased composition reaches this check.',
+                        docsSlug: 'event-sourcing-plugin-e003',
+                    });
+                }
+                if (slice.es === undefined) {
+                    debugBuilder('[event-sourcing] feature "%s" did not contribute an es slice.', tok.key);
+                    continue;
+                }
+                bundles.push(slice.es);
+            }
+            const readModels = [
+                ...(options.projections ?? []),
+                ...bundles.flatMap(collected => collected.readModels),
+            ];
+            const commandHandlers = [
+                ...bundles.flatMap(collected => collected.handlers),
+                ...(options.commandHandlers ?? []),
+            ];
+            assertUniqueCommandHandlers(commandHandlers);
+            const { eventStore, close } = eventSourcingFeatures.initEventSourcing(readModels, dbUrl);
             closeStore = close;
-            const messageBus = eventSourcingFeatures.initMessageBus(eventStore, [...commandHandlers]);
+            const messageBus = controlledMessageBus(eventSourcingFeatures.initMessageBus(eventStore, [...commandHandlers]), new Set(commandHandlers.map(registration => registration.commandType)));
+            closeBus = () => messageBus.close();
             return { eventStore, messageBus };
         },
+        start() {
+            // Marks the plugin active so DOT will run `stop`, where the dispatcher
+            // closes before dispose releases the store pool.
+        },
+        async stop() {
+            await closeBus?.();
+        },
         async dispose() {
+            await closeBus?.();
+            closeBus = undefined;
             if (closeStore !== undefined) {
                 await closeStore();
                 closeStore = undefined;
             }
         },
     });
+    // Erasure seam: `needs` is assembled from runtime tokens, while the
+    // return type re-attaches the token-derived wire shape for the app
+    // builder guard. Same pattern as @arki/http's bundle collector.
+    return inner;
 }
 //# sourceMappingURL=dot.js.map

package/dist/dot.js.map

@@ -1 +1 @@
-{"version":3,"file":"dot.js","sourceRoot":"","sources":["../src/dot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAKH,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAIjD,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE/F;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,4DAA4D;IAC5D,kBAAkB,EAAE,yBAAyB;CACrC,CAAC;AAuCX;;;;GAIG;AACH,SAAS,YAAY,CAAC,QAA4B;IAChD,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC/D,KAAK,MAAM,IAAI,IAAI,wBAAwB,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;YAAE,OAAO,KAAK,CAAC;IACxD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,OAAgC;IAC5D,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC;IAEtD,sEAAsE;IACtE,oEAAoE;IACpE,IAAI,UAA6C,CAAC;IAElD,OAAO,GAAG,CAAC;QACT,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,OAAO;QAChB,SAAS,CAAC,GAAG;YACX,GAAG,CAAC,eAAe,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;YACjD,GAAG,CAAC,eAAe,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;YACjD,GAAG,CAAC,eAAe,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QACpD,CAAC;QACD,IAAI;YACF,iEAAiE;YACjE,oEAAoE;YACpE,oEAAoE;YACpE,6DAA6D;YAC7D,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,WAAW,CAAC;oBACpB,IAAI,EAAE,8BAA8B,CAAC,kBAAkB;oBACvD,OAAO,EAAE,8DAA8D;oBACvE,WAAW,EAAE,0DAA0D,wBAAwB,CAAC,IAAI,CAClG,IAAI,CACL,6CAA6C;oBAC9C,OAAO,EAAE,qDAAqD;iBAC/D,CAAC,CAAC;YACL,CAAC;YACD,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,qBAAqB,CAAC,iBAAiB,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAClG,UAAU,GAAG,KAAK,CAAC;YACnB,MAAM,UAAU,GAAG,qBAAqB,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;YAC1F,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;QACpC,CAAC;QACD,KAAK,CAAC,OAAO;YACX,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,UAAU,EAAE,CAAC;gBACnB,UAAU,GAAG,SAAS,CAAC;YACzB,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"dot.js","sourceRoot":"","sources":["../src/dot.ts"],"names":[],"mappings":"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"}

package/dist/projection.d.ts

@@ -0,0 +1,53 @@
+/**
+ * DOT projection entry point for `dot explain --as event-catalog`.
+ *
+ * Pure manifest in, JSON document out. It intentionally renders only
+ * configure-time ES actions: command handlers collected dynamically through
+ * deprecated 0.1.x options are executable but manifest-invisible.
+ */
+import type { JsonObject } from './dot-action.js';
+type DotActionLike = {
+    readonly id: string;
+    readonly plugin: string;
+    readonly binding: string;
+    readonly direction: 'in' | 'out';
+    readonly address?: string;
+    readonly summary?: string;
+    readonly meta?: JsonObject;
+    readonly metaSchema?: string;
+};
+type DotManifestLike = {
+    readonly app: {
+        readonly name: string;
+        readonly version?: string;
+    };
+    readonly actions: readonly DotActionLike[];
+};
+type CatalogCommand = JsonObject & {
+    readonly type: string;
+    readonly address: string;
+    readonly summary?: string;
+    readonly input: JsonObject;
+};
+type CatalogEvent = JsonObject & {
+    readonly type: string;
+    readonly address: string;
+    readonly summary?: string;
+    readonly data: JsonObject;
+};
+type CatalogPlugin = JsonObject & {
+    readonly name: string;
+    readonly commands: CatalogCommand[];
+    readonly events: CatalogEvent[];
+};
+type EventCatalog = JsonObject & {
+    readonly format: 'event-catalog';
+    readonly app: {
+        readonly name: string;
+        readonly version?: string;
+    };
+    readonly plugins: CatalogPlugin[];
+};
+export declare function project(manifest: DotManifestLike): EventCatalog;
+export {};
+//# sourceMappingURL=projection.d.ts.map

package/dist/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAOlD,KAAK,aAAa,GAAG;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,KAAK,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,GAAG,EAAE;QACZ,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;CAC5C,CAAC;AAEF,KAAK,cAAc,GAAG,UAAU,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B,CAAC;AAEF,KAAK,YAAY,GAAG,UAAU,GAAG;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B,CAAC;AAEF,KAAK,aAAa,GAAG,UAAU,GAAG;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;CACjC,CAAC;AAEF,KAAK,YAAY,GAAG,UAAU,GAAG;IAC/B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE;QACZ,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,CAAC;CACnC,CAAC;AAoDF,wBAAgB,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,YAAY,CAqB/D"}

package/dist/projection.js

@@ -0,0 +1,76 @@
+/**
+ * DOT projection entry point for `dot explain --as event-catalog`.
+ *
+ * Pure manifest in, JSON document out. It intentionally renders only
+ * configure-time ES actions: command handlers collected dynamically through
+ * deprecated 0.1.x options are executable but manifest-invisible.
+ */
+import { EVENT_SOURCING_ACTION_META_SCHEMA, EventSourcingActionError, isJsonObject, } from './dot-action.js';
+function projectionError(message) {
+    return new EventSourcingActionError(message, new TypeError(message));
+}
+function getGroup(groups, plugin) {
+    const existing = groups.find(group => group.name === plugin);
+    if (existing !== undefined)
+        return existing;
+    const created = { name: plugin, commands: [], events: [] };
+    groups.push(created);
+    return created;
+}
+function assertMeta(action) {
+    if (action.metaSchema !== EVENT_SOURCING_ACTION_META_SCHEMA) {
+        throw projectionError(`[event-sourcing] action "${action.id}" uses unsupported meta schema "${action.metaSchema ?? 'missing'}".`);
+    }
+    if (action.meta === undefined) {
+        throw projectionError(`[event-sourcing] action "${action.id}" has no event-sourcing metadata.`);
+    }
+    return action.meta;
+}
+function commandFromAction(action, meta) {
+    const input = meta['input'];
+    if (meta['kind'] !== 'command' || !isJsonObject(input)) {
+        throw projectionError(`[event-sourcing] action "${action.id}" has invalid command metadata.`);
+    }
+    return {
+        type: action.id,
+        address: action.address ?? action.id,
+        ...(action.summary === undefined ? {} : { summary: action.summary }),
+        input,
+    };
+}
+function eventFromAction(action, meta) {
+    const data = meta['data'];
+    if (meta['kind'] !== 'event' || !isJsonObject(data)) {
+        throw projectionError(`[event-sourcing] action "${action.id}" has invalid event metadata.`);
+    }
+    return {
+        type: action.id,
+        address: action.address ?? action.id,
+        ...(action.summary === undefined ? {} : { summary: action.summary }),
+        data,
+    };
+}
+export function project(manifest) {
+    const plugins = [];
+    for (const action of manifest.actions) {
+        if (action.binding !== 'es')
+            continue;
+        const meta = assertMeta(action);
+        const group = getGroup(plugins, action.plugin);
+        if (action.direction === 'in') {
+            group.commands.push(commandFromAction(action, meta));
+        }
+        else {
+            group.events.push(eventFromAction(action, meta));
+        }
+    }
+    return {
+        format: 'event-catalog',
+        app: {
+            name: manifest.app.name,
+            ...(manifest.app.version === undefined ? {} : { version: manifest.app.version }),
+        },
+        plugins,
+    };
+}
+//# sourceMappingURL=projection.js.map

package/dist/projection.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arki/event-sourcing",
-  "version": "0.1.5",
+  "version": "0.2.1",
   "description": "Event sourcing primitives — event store, message bus, projections, process managers — built on Emmett for ARKI.",
   "license": "MIT",
   "repository": {
@@ -60,6 +60,11 @@
       "import": "./dist/dot.js",
       "default": "./dist/dot.js"
     },
+    "./projection": {
+      "types": "./dist/projection.d.ts",
+      "import": "./dist/projection.js",
+      "default": "./dist/projection.js"
+    },
     "./event": {
       "types": "./dist/event.d.ts",
       "import": "./dist/event.js",
@@ -85,7 +90,7 @@
     "package.json"
   ],
   "dependencies": {
-    "@arki/contracts": "0.0.2",
+    "@arki/contracts": "0.0.3",
     "@arki/log": "0.0.2",
     "@event-driven-io/emmett": "^0.41.0",
     "@event-driven-io/emmett-postgresql": "^0.41.0",
@@ -93,7 +98,7 @@
     "drizzle-orm": "1.0.0-rc.1"
   },
   "peerDependencies": {
-    "@arki/dot": "^0.3.0"
+    "@arki/dot": "^0.4.0"
   },
   "peerDependenciesMeta": {
     "@arki/dot": {

package/src/builders/command.ts

@@ -1,6 +1,8 @@
 import type { z } from '@arki/contracts';
 
 import type { Command, DefaultCommandMetadata } from '../command.js';
+import type { EventSourcingActionDeclaration, JsonObject } from '../dot-action.js';
+import { EVENT_SOURCING_ACTION_META_SCHEMA, schemaToJsonObject } from '../dot-action.js';
 import type { DefaultRecord } from '../types.js';
 
 /**
@@ -19,6 +21,35 @@ export type CommandConfig<
   metadataSchema?: z.ZodType<TMetadata>;
 };
 
+export type CommandFactory<
+  TType extends string,
+  TInput extends DefaultRecord,
+  TMetadata extends DefaultCommandMetadata | undefined = undefined,
+> = ((input: TInput, metadata?: TMetadata) => Command<TType, TInput, TMetadata>) &
+  EventSourcingActionDeclaration & {
+    readonly type: TType;
+    readonly inputSchema: z.ZodType<TInput>;
+    readonly metadataSchema?: z.ZodType<TMetadata>;
+    toDotAction(): EventSourcingActionDeclaration;
+  };
+
+function commandAction<TType extends string>(
+  type: TType,
+  inputSchema: z.ZodType,
+): EventSourcingActionDeclaration {
+  return {
+    id: type,
+    binding: 'es',
+    direction: 'in',
+    address: type,
+    metaSchema: EVENT_SOURCING_ACTION_META_SCHEMA,
+    meta: {
+      kind: 'command',
+      input: schemaToJsonObject(inputSchema, `command "${type}" input`),
+    },
+  };
+}
+
 /**
  * Creates a strongly-typed command factory function.
  *
@@ -48,10 +79,11 @@ export function defineCommand<
   TMetadata extends DefaultCommandMetadata | undefined = undefined,
 >(
   config: CommandConfig<TType, TInput, TMetadata>,
-): (input: TInput, metadata?: TMetadata) => Command<TType, TInput, TMetadata> {
+): CommandFactory<TType, TInput, TMetadata> {
   const { type, inputSchema, metadataSchema } = config;
+  let cachedAction: EventSourcingActionDeclaration | undefined;
 
-  return (input: TInput, metadata?: TMetadata) => {
+  const factory = (input: TInput, metadata?: TMetadata) => {
     const validatedInput = inputSchema.parse(input);
     const validatedMetadata = metadataSchema ? metadataSchema.parse(metadata) : metadata;
 
@@ -69,4 +101,29 @@ export function defineCommand<
           kind: 'Command' as const,
         }) as unknown as Command<TType, TInput, TMetadata>;
   };
+
+  const getAction = (): EventSourcingActionDeclaration => {
+    cachedAction ??= commandAction(type, inputSchema);
+    return cachedAction;
+  };
+
+  Object.defineProperties(factory, {
+    type: { value: type, enumerable: true },
+    inputSchema: { value: inputSchema },
+    ...(metadataSchema === undefined ? {} : { metadataSchema: { value: metadataSchema } }),
+    id: { value: type, enumerable: true },
+    binding: { value: 'es', enumerable: true },
+    direction: { value: 'in', enumerable: true },
+    address: { value: type, enumerable: true },
+    metaSchema: { value: EVENT_SOURCING_ACTION_META_SCHEMA, enumerable: true },
+    meta: {
+      enumerable: true,
+      get(): JsonObject {
+        return getAction().meta;
+      },
+    },
+    toDotAction: { value: getAction },
+  });
+
+  return factory as CommandFactory<TType, TInput, TMetadata>;
 }

package/src/builders/event.ts

@@ -1,6 +1,8 @@
 import type { z } from '@arki/contracts';
 
 import type { Event } from '../event.js';
+import type { EventSourcingActionDeclaration, JsonObject } from '../dot-action.js';
+import { EVENT_SOURCING_ACTION_META_SCHEMA, schemaToJsonObject } from '../dot-action.js';
 import type { DefaultRecord } from '../types.js';
 
 /**
@@ -19,6 +21,35 @@ export type EventConfig<
   metadataSchema?: z.ZodType<TMetadata>;
 };
 
+export type EventFactory<
+  TType extends string,
+  TData extends DefaultRecord,
+  TMetadata extends DefaultRecord | undefined = undefined,
+> = ((data: TData, metadata?: TMetadata) => Event<TType, TData, TMetadata>) &
+  EventSourcingActionDeclaration & {
+    readonly type: TType;
+    readonly dataSchema: z.ZodType<TData>;
+    readonly metadataSchema?: z.ZodType<TMetadata>;
+    toDotAction(): EventSourcingActionDeclaration;
+  };
+
+function eventAction<TType extends string>(
+  type: TType,
+  dataSchema: z.ZodType,
+): EventSourcingActionDeclaration {
+  return {
+    id: type,
+    binding: 'es',
+    direction: 'out',
+    address: type,
+    metaSchema: EVENT_SOURCING_ACTION_META_SCHEMA,
+    meta: {
+      kind: 'event',
+      data: schemaToJsonObject(dataSchema, `event "${type}" data`),
+    },
+  };
+}
+
 /**
  * Creates a strongly-typed event factory function.
  *
@@ -46,10 +77,11 @@ export function defineEvent<
   TType extends string,
   TData extends DefaultRecord,
   TMetadata extends DefaultRecord | undefined = undefined,
->(config: EventConfig<TType, TData, TMetadata>): (data: TData, metadata?: TMetadata) => Event<TType, TData, TMetadata> {
+>(config: EventConfig<TType, TData, TMetadata>): EventFactory<TType, TData, TMetadata> {
   const { type, dataSchema, metadataSchema } = config;
+  let cachedAction: EventSourcingActionDeclaration | undefined;
 
-  return (data: TData, metadata?: TMetadata) => {
+  const factory = (data: TData, metadata?: TMetadata) => {
     const validatedData = dataSchema.parse(data);
     const validatedMetadata = metadataSchema ? metadataSchema.parse(metadata) : metadata;
 
@@ -65,4 +97,29 @@ export function defineEvent<
           metadata: validatedMetadata,
         }) as unknown as Event<TType, TData, TMetadata>;
   };
+
+  const getAction = (): EventSourcingActionDeclaration => {
+    cachedAction ??= eventAction(type, dataSchema);
+    return cachedAction;
+  };
+
+  Object.defineProperties(factory, {
+    type: { value: type, enumerable: true },
+    dataSchema: { value: dataSchema },
+    ...(metadataSchema === undefined ? {} : { metadataSchema: { value: metadataSchema } }),
+    id: { value: type, enumerable: true },
+    binding: { value: 'es', enumerable: true },
+    direction: { value: 'out', enumerable: true },
+    address: { value: type, enumerable: true },
+    metaSchema: { value: EVENT_SOURCING_ACTION_META_SCHEMA, enumerable: true },
+    meta: {
+      enumerable: true,
+      get(): JsonObject {
+        return getAction().meta;
+      },
+    },
+    toDotAction: { value: getAction },
+  });
+
+  return factory as EventFactory<TType, TData, TMetadata>;
 }