@arki/event-sourcing 0.1.4 → 0.2.1

package/README.md

@@ -22,20 +22,105 @@ Peer-installs:
 
 - **Event store** — `getEventStore(connectionString, options)` opens a PostgreSQL event store with a clean `close()` that releases the pool.
 - **Message bus** — `eventSourcingFeatures.initMessageBus(eventStore, handlers)` builds an in-memory message bus, registers command handlers, and wraps each handler with stream-name resolution + logging.
+- **DOT adapter** — `eventSourcing()` opens the store, publishes `eventStore` + `messageBus`, collects feature-local ES bundles, and registers the `event-catalog` projection.
 - **Process managers** — `createProcessManager` (per-batch), `createStatefulProcessManager` (per-batch with state), and `createSimpleProcessManager` (per-message with a pre-bound context).
-- **Builders** — fluent `defineCommand`, `defineEvent`, `defineDecider`, `defineProjection`, `defineCommandHandler`, `defineProcessManager`, `defineStatefulProcessManager` for type-safe authoring.
+- **Builders** — `defineCommand`, `defineEvent`, `defineDecider`, `defineProjection`, `defineCommandHandler`, `defineProcessManager`, `defineStatefulProcessManager` for type-safe authoring.
 - **Drizzle projection helpers** — `drizzleProjection` / `drizzleWithRepoProjection` so projection handlers receive a typed Drizzle database (or repository registry) instead of a raw client.
 
 ## Quick start
 
-### 1. Bootstrap an event store and message bus
+### DOT app setup
+
+```ts
+import { z } from '@arki/contracts';
+import { defineApp, pip, provide, token } from '@arki/dot';
+import { eventSourcing, es, type EsBundle } from '@arki/event-sourcing/dot';
+import { defineCommand, defineCommandHandler, defineEvent } from '@arki/event-sourcing/builders';
+
+const placeOrder = defineCommand({
+  type: 'PlaceOrder',
+  inputSchema: z.object({ orderId: z.string(), total: z.number() }),
+});
+
+const orderPlaced = defineEvent({
+  type: 'OrderPlaced',
+  dataSchema: z.object({ orderId: z.string(), total: z.number() }),
+});
+
+const placeOrderHandler = defineCommandHandler({
+  initialState: () => ({ placed: false }),
+  evolve: (state, event) => (event.type === 'OrderPlaced' ? { placed: true } : state),
+  decide: (command, state) => {
+    if (state.placed) throw new Error('Order already placed');
+    return [orderPlaced({ orderId: command.data.orderId, total: command.data.total })];
+  },
+});
+
+export const OrdersEs = token<EsBundle>()('orders.es');
+
+export const ordersEsPip = pip({
+  name: 'orders-es',
+  actions: [placeOrder, orderPlaced],
+  boot: () =>
+    provide(
+      OrdersEs,
+      es.bundle({
+        handlers: [es.handle(placeOrder, placeOrderHandler, command => `order-${command.data.orderId}`)],
+        readModels: [],
+      }),
+    ),
+});
+
+export const app = defineApp('shop-api')
+  .use(ordersEsPip)
+  .use(eventSourcing({ bundles: [OrdersEs], dbUrl: process.env.DB_URL }));
+```
+
+`eventSourcing()` may be mounted with no options for append-only mode. It resolves the store URL from `EVENT_STORE_URL`, `EVENTSTORE_URL`, or `EVENT_DB_URL`; apps that use a different env name should pass `dbUrl` explicitly.
+
+Commands and events produced by `defineCommand` / `defineEvent` contribute DOT actions. `dot explain --as event-catalog` renders their JSON Schemas without booting the app. Deprecated dynamic `commandHandlers` still run, but are intentionally absent from the manifest and catalog.
+
+### Composition order
+
+Feature pips that handle commands publish ES bundles. Feature pips that send commands need the `messageBus` service. Mount them in this order:
+
+```text
+es-feature pips -> eventSourcing() -> http/queue feature pips that need messageBus -> http()/queue runtime
+```
+
+A feature that both handles `PlaceOrder` and exposes `POST /orders` should be split into two pips: `orders-es` publishes `OrdersEs`; `orders-http` needs `messageBus` and binds the HTTP route.
+
+### HTTP and queue recipes
+
+Expose a command over HTTP explicitly:
+
+```ts
+routes().bind(placeOrderRoute, async ({ body }, { messageBus }) => {
+  await messageBus.send(placeOrder(body));
+  return { ok: true };
+});
+```
+
+Use `@arki/queue` for durable/async command transport:
+
+```ts
+jobs.worker('orders.place', async ({ payload }, { messageBus }) => {
+  await messageBus.send(placeOrder(payload));
+});
+```
+
+The message bus published by this package is strictly in-process synchronous dispatch. It is not durable, does not distribute work across instances, and does not survive restarts or rolling deploys.
+
+### Programmatic bootstrap
+
+Non-DOT composition roots can still use the lower-level helpers:
 
 ```ts
 import { eventSourcingFeatures } from '@arki/event-sourcing';
 
 const { eventStore, close } = eventSourcingFeatures.initEventSourcing(
   [
-    /* projections produced by defineProjection / drizzleProjection / postgreSQLProjection */
+    /* read-model projections produced by defineProjection / drizzleProjection / postgreSQLProjection */
   ],
   process.env.EVENT_STORE_URL,
 );
@@ -44,46 +129,10 @@ const messageBus = eventSourcingFeatures.initMessageBus(eventStore, [
   /* { commandType, handler, getStreamName } registrations */
 ]);
 
-// Later, on shutdown:
 await close();
 ```
 
-`initEventSourcing` throws a descriptive error if the connection string is undefined, naming `EVENT_STORE_URL`, `EVENTSTORE_URL`, and `EVENT_DB_URL` as the recognised env var names.
-
-### 2. Define a command, a decider, and a handler
-
-```ts
-import { defineCommand, defineEvent, defineDecider, defineCommandHandler, z } from '@arki/event-sourcing';
-// (or import each builder from '@arki/event-sourcing/builders')
-
-const PlaceOrder = defineCommand({
-  type: 'PlaceOrder',
-  inputSchema: z.object({ orderId: z.string(), total: z.number() }),
-  metadataSchema: z.object({ userId: z.string() }),
-});
-
-const OrderPlaced = defineEvent({
-  type: 'OrderPlaced',
-  inputSchema: z.object({ orderId: z.string(), total: z.number() }),
-  metadataSchema: z.object({ userId: z.string(), at: z.string() }),
-});
-
-const orderDecider = defineDecider()
-  .initialState(() => ({ placed: false }))
-  .evolve((state, event) => (event.type === 'OrderPlaced' ? { placed: true } : state))
-  .decide((command, state) => {
-    if (state.placed) throw new Error('Order already placed');
-    return OrderPlaced({ orderId: command.data.orderId, total: command.data.total }, {
-      userId: command.metadata.userId,
-      at: new Date().toISOString(),
-    });
-  })
-  .build();
-
-export const placeOrderHandler = defineCommandHandler(orderDecider);
-```
-
-### 3. Define a process manager
+### Process managers
 
 Use `createProcessManager` for batch processing, or `createSimpleProcessManager` when the handler closes over a fixed context and processes one event at a time:
 
@@ -114,6 +163,8 @@ await eventSourcingFeatures.setupProcessManagers(eventStore, [sendOrderEmails]);
 - `@arki/event-sourcing/builders` — fluent builders only.
 - `@arki/event-sourcing/store` — `getEventStore`, `drizzleProjection`, `postgreSQLProjection`, projection context types.
 - `@arki/event-sourcing/bus` — `getInMemoryMessageBus` and message bus types re-exported from Emmett.
+- `@arki/event-sourcing/dot` — DOT pip, ES bundle helpers, and ES pip error codes.
+- `@arki/event-sourcing/projection` — pure `event-catalog` projection for DOT.
 
 ## Documentation
 

package/dist/builders/command.d.ts

@@ -1,5 +1,6 @@
 import type { z } from '@arki/contracts';
 import type { Command, DefaultCommandMetadata } from '../command.js';
+import type { EventSourcingActionDeclaration } from '../dot-action.js';
 import type { DefaultRecord } from '../types.js';
 /**
  * Configuration for defining a domain command factory.
@@ -12,6 +13,12 @@ export type CommandConfig<TType extends string, TInput extends DefaultRecord, TM
     /** Optional Zod schema for validating command metadata */
     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;
+};
 /**
  * Creates a strongly-typed command factory function.
  *
@@ -35,5 +42,5 @@ export type CommandConfig<TType extends string, TInput extends DefaultRecord, TM
  * );
  * ```
  */
-export declare function defineCommand<TType extends string, TInput extends DefaultRecord, TMetadata extends DefaultCommandMetadata | undefined = undefined>(config: CommandConfig<TType, TInput, TMetadata>): (input: TInput, metadata?: TMetadata) => Command<TType, TInput, TMetadata>;
+export declare function defineCommand<TType extends string, TInput extends DefaultRecord, TMetadata extends DefaultCommandMetadata | undefined = undefined>(config: CommandConfig<TType, TInput, TMetadata>): CommandFactory<TType, TInput, TMetadata>;
 //# sourceMappingURL=command.d.ts.map

package/dist/builders/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/builders/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,aAAa,CACvB,KAAK,SAAS,MAAM,EACpB,MAAM,SAAS,aAAa,EAC5B,SAAS,SAAS,sBAAsB,GAAG,SAAS,GAAG,SAAS,IAC9D;IACF,mDAAmD;IACnD,IAAI,EAAE,KAAK,CAAC;IACZ,8CAA8C;IAC9C,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,0DAA0D;IAC1D,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;CACvC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAC3B,KAAK,SAAS,MAAM,EACpB,MAAM,SAAS,aAAa,EAC5B,SAAS,SAAS,sBAAsB,GAAG,SAAS,GAAG,SAAS,EAEhE,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,GAC9C,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,KAAK,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAqB5E"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/builders/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,8BAA8B,EAAc,MAAM,kBAAkB,CAAC;AAEnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,aAAa,CACvB,KAAK,SAAS,MAAM,EACpB,MAAM,SAAS,aAAa,EAC5B,SAAS,SAAS,sBAAsB,GAAG,SAAS,GAAG,SAAS,IAC9D;IACF,mDAAmD;IACnD,IAAI,EAAE,KAAK,CAAC;IACZ,8CAA8C;IAC9C,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,0DAA0D;IAC1D,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,cAAc,CACxB,KAAK,SAAS,MAAM,EACpB,MAAM,SAAS,aAAa,EAC5B,SAAS,SAAS,sBAAsB,GAAG,SAAS,GAAG,SAAS,IAC9D,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,KAAK,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,GAC9E,8BAA8B,GAAG;IAC/B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/C,WAAW,IAAI,8BAA8B,CAAC;CAC/C,CAAC;AAmBJ;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAC3B,KAAK,SAAS,MAAM,EACpB,MAAM,SAAS,aAAa,EAC5B,SAAS,SAAS,sBAAsB,GAAG,SAAS,GAAG,SAAS,EAEhE,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,GAC9C,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CA+C1C"}

package/dist/builders/command.js

@@ -1,3 +1,17 @@
+import { EVENT_SOURCING_ACTION_META_SCHEMA, schemaToJsonObject } from '../dot-action.js';
+function commandAction(type, inputSchema) {
+    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.
  *
@@ -23,7 +37,8 @@
  */
 export function defineCommand(config) {
     const { type, inputSchema, metadataSchema } = config;
-    return (input, metadata) => {
+    let cachedAction;
+    const factory = (input, metadata) => {
         const validatedInput = inputSchema.parse(input);
         const validatedMetadata = metadataSchema ? metadataSchema.parse(metadata) : metadata;
         // Conditionally construct the command object based on whether metadata is provided
@@ -40,5 +55,27 @@ export function defineCommand(config) {
                 kind: 'Command',
             });
     };
+    const getAction = () => {
+        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() {
+                return getAction().meta;
+            },
+        },
+        toDotAction: { value: getAction },
+    });
+    return factory;
 }
 //# sourceMappingURL=command.js.map

package/dist/builders/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/builders/command.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,aAAa,CAK3B,MAA+C;IAE/C,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAErD,OAAO,CAAC,KAAa,EAAE,QAAoB,EAAE,EAAE;QAC7C,MAAM,cAAc,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,iBAAiB,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAErF,mFAAmF;QACnF,OAAO,CAAC,iBAAiB,KAAK,SAAS;YACrC,CAAC,CAAC;gBACE,IAAI;gBACJ,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,SAAkB;aACzB;YACH,CAAC,CAAC;gBACE,IAAI;gBACJ,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,iBAAiB;gBAC3B,IAAI,EAAE,SAAkB;aACzB,CAAiD,CAAC;IACzD,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/builders/command.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iCAAiC,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AA+BzF,SAAS,aAAa,CACpB,IAAW,EACX,WAAsB;IAEtB,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,iCAAiC;QAC7C,IAAI,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,kBAAkB,CAAC,WAAW,EAAE,YAAY,IAAI,SAAS,CAAC;SAClE;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,aAAa,CAK3B,MAA+C;IAE/C,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IACrD,IAAI,YAAwD,CAAC;IAE7D,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,QAAoB,EAAE,EAAE;QACtD,MAAM,cAAc,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,iBAAiB,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAErF,mFAAmF;QACnF,OAAO,CAAC,iBAAiB,KAAK,SAAS;YACrC,CAAC,CAAC;gBACE,IAAI;gBACJ,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,SAAkB;aACzB;YACH,CAAC,CAAC;gBACE,IAAI;gBACJ,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,iBAAiB;gBAC3B,IAAI,EAAE,SAAkB;aACzB,CAAiD,CAAC;IACzD,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,GAAmC,EAAE;QACrD,YAAY,KAAK,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAClD,OAAO,YAAY,CAAC;IACtB,CAAC,CAAC;IAEF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE;QAC/B,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;QACvC,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;QACnC,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC;QACtF,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;QACrC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;QAC1C,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;QAC5C,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;QAC1C,UAAU,EAAE,EAAE,KAAK,EAAE,iCAAiC,EAAE,UAAU,EAAE,IAAI,EAAE;QAC1E,IAAI,EAAE;YACJ,UAAU,EAAE,IAAI;YAChB,GAAG;gBACD,OAAO,SAAS,EAAE,CAAC,IAAI,CAAC;YAC1B,CAAC;SACF;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;KAClC,CAAC,CAAC;IAEH,OAAO,OAAmD,CAAC;AAC7D,CAAC"}

package/dist/builders/event.d.ts

@@ -1,5 +1,6 @@
 import type { z } from '@arki/contracts';
 import type { Event } from '../event.js';
+import type { EventSourcingActionDeclaration } from '../dot-action.js';
 import type { DefaultRecord } from '../types.js';
 /**
  * Configuration for defining a domain event factory.
@@ -12,6 +13,12 @@ export type EventConfig<TType extends string, TData extends DefaultRecord, TMeta
     /** Optional Zod schema for validating event metadata */
     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;
+};
 /**
  * Creates a strongly-typed event factory function.
  *
@@ -35,5 +42,5 @@ export type EventConfig<TType extends string, TData extends DefaultRecord, TMeta
  * );
  * ```
  */
-export declare 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>;
+export declare function defineEvent<TType extends string, TData extends DefaultRecord, TMetadata extends DefaultRecord | undefined = undefined>(config: EventConfig<TType, TData, TMetadata>): EventFactory<TType, TData, TMetadata>;
 //# sourceMappingURL=event.d.ts.map

package/dist/builders/event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/builders/event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,WAAW,CACrB,KAAK,SAAS,MAAM,EACpB,KAAK,SAAS,aAAa,EAC3B,SAAS,SAAS,aAAa,GAAG,SAAS,GAAG,SAAS,IACrD;IACF,kDAAkD;IAClD,IAAI,EAAE,KAAK,CAAC;IACZ,2CAA2C;IAC3C,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,wDAAwD;IACxD,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;CACvC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CACzB,KAAK,SAAS,MAAM,EACpB,KAAK,SAAS,aAAa,EAC3B,SAAS,SAAS,aAAa,GAAG,SAAS,GAAG,SAAS,EACvD,MAAM,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,SAAS,KAAK,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAmBrH"}
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/builders/event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,8BAA8B,EAAc,MAAM,kBAAkB,CAAC;AAEnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,WAAW,CACrB,KAAK,SAAS,MAAM,EACpB,KAAK,SAAS,aAAa,EAC3B,SAAS,SAAS,aAAa,GAAG,SAAS,GAAG,SAAS,IACrD;IACF,kDAAkD;IAClD,IAAI,EAAE,KAAK,CAAC;IACZ,2CAA2C;IAC3C,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,wDAAwD;IACxD,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,YAAY,CACtB,KAAK,SAAS,MAAM,EACpB,KAAK,SAAS,aAAa,EAC3B,SAAS,SAAS,aAAa,GAAG,SAAS,GAAG,SAAS,IACrD,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,SAAS,KAAK,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,GACzE,8BAA8B,GAAG;IAC/B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/C,WAAW,IAAI,8BAA8B,CAAC;CAC/C,CAAC;AAmBJ;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CACzB,KAAK,SAAS,MAAM,EACpB,KAAK,SAAS,aAAa,EAC3B,SAAS,SAAS,aAAa,GAAG,SAAS,GAAG,SAAS,EACvD,MAAM,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CA6CrF"}

package/dist/builders/event.js

@@ -1,3 +1,17 @@
+import { EVENT_SOURCING_ACTION_META_SCHEMA, schemaToJsonObject } from '../dot-action.js';
+function eventAction(type, dataSchema) {
+    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.
  *
@@ -23,7 +37,8 @@
  */
 export function defineEvent(config) {
     const { type, dataSchema, metadataSchema } = config;
-    return (data, metadata) => {
+    let cachedAction;
+    const factory = (data, metadata) => {
         const validatedData = dataSchema.parse(data);
         const validatedMetadata = metadataSchema ? metadataSchema.parse(metadata) : metadata;
         // Conditionally construct the event object based on whether metadata is provided
@@ -38,5 +53,27 @@ export function defineEvent(config) {
                 metadata: validatedMetadata,
             });
     };
+    const getAction = () => {
+        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() {
+                return getAction().meta;
+            },
+        },
+        toDotAction: { value: getAction },
+    });
+    return factory;
 }
 //# sourceMappingURL=event.js.map

package/dist/builders/event.js.map

@@ -1 +1 @@
-{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/builders/event.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,WAAW,CAIzB,MAA4C;IAC5C,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAEpD,OAAO,CAAC,IAAW,EAAE,QAAoB,EAAE,EAAE;QAC3C,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,iBAAiB,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAErF,iFAAiF;QACjF,OAAO,CAAC,iBAAiB,KAAK,SAAS;YACrC,CAAC,CAAC;gBACE,IAAI;gBACJ,IAAI,EAAE,aAAa;aACpB;YACH,CAAC,CAAC;gBACE,IAAI;gBACJ,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,iBAAiB;aAC5B,CAA8C,CAAC;IACtD,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/builders/event.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iCAAiC,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AA+BzF,SAAS,WAAW,CAClB,IAAW,EACX,UAAqB;IAErB,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,iCAAiC;QAC7C,IAAI,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,kBAAkB,CAAC,UAAU,EAAE,UAAU,IAAI,QAAQ,CAAC;SAC7D;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,WAAW,CAIzB,MAA4C;IAC5C,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IACpD,IAAI,YAAwD,CAAC;IAE7D,MAAM,OAAO,GAAG,CAAC,IAAW,EAAE,QAAoB,EAAE,EAAE;QACpD,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,iBAAiB,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAErF,iFAAiF;QACjF,OAAO,CAAC,iBAAiB,KAAK,SAAS;YACrC,CAAC,CAAC;gBACE,IAAI;gBACJ,IAAI,EAAE,aAAa;aACpB;YACH,CAAC,CAAC;gBACE,IAAI;gBACJ,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,iBAAiB;aAC5B,CAA8C,CAAC;IACtD,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,GAAmC,EAAE;QACrD,YAAY,KAAK,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC/C,OAAO,YAAY,CAAC;IACtB,CAAC,CAAC;IAEF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE;QAC/B,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;QACvC,UAAU,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE;QACjC,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC;QACtF,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;QACrC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;QAC1C,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;QAC7C,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;QAC1C,UAAU,EAAE,EAAE,KAAK,EAAE,iCAAiC,EAAE,UAAU,EAAE,IAAI,EAAE;QAC1E,IAAI,EAAE;YACJ,UAAU,EAAE,IAAI;YAChB,GAAG;gBACD,OAAO,SAAS,EAAE,CAAC,IAAI,CAAC;YAC1B,CAAC;SACF;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;KAClC,CAAC,CAAC;IAEH,OAAO,OAAgD,CAAC;AAC1D,CAAC"}

package/dist/dot-action.d.ts

@@ -0,0 +1,31 @@
+import { z } from '@arki/contracts';
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export declare const EVENT_SOURCING_ACTION_META_SCHEMA = "@arki/event-sourcing/action-meta@1";
+export declare const EVENT_SOURCING_SCHEMA_REJECTED_CODE = "EVENT_SOURCING_PLUGIN_E007";
+export type EventSourcingActionMeta = {
+    readonly kind: 'command';
+    readonly input: JsonObject;
+} | {
+    readonly kind: 'event';
+    readonly data: JsonObject;
+};
+export type EventSourcingActionDeclaration = {
+    readonly id: string;
+    readonly binding: 'es';
+    readonly direction: 'in' | 'out';
+    readonly address: string;
+    readonly metaSchema: typeof EVENT_SOURCING_ACTION_META_SCHEMA;
+    readonly meta: EventSourcingActionMeta;
+};
+export declare class EventSourcingActionError extends Error {
+    readonly code = "EVENT_SOURCING_PLUGIN_E007";
+    constructor(message: string, cause: unknown);
+}
+export declare function isJsonObject(value: unknown): value is JsonObject;
+export declare function schemaToJsonObject(schema: z.ZodType, label: string): JsonObject;
+//# sourceMappingURL=dot-action.d.ts.map

package/dist/dot-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dot-action.d.ts","sourceRoot":"","sources":["../src/dot-action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,iBAAiB,CAAC;AAEpC,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACtG,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,eAAO,MAAM,iCAAiC,uCAAuC,CAAC;AACtF,eAAO,MAAM,mCAAmC,+BAA+B,CAAC;AAEhF,MAAM,MAAM,uBAAuB,GAC/B;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B,CAAC;AAEN,MAAM,MAAM,8BAA8B,GAAG;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,KAAK,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,iCAAiC,CAAC;IAC9D,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;CACxC,CAAC;AAEF,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,gCAAuC;gBAExC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAI5C;AAmBD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AA4BD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAY/E"}

package/dist/dot-action.js

@@ -0,0 +1,73 @@
+import { z } from '@arki/contracts';
+export const EVENT_SOURCING_ACTION_META_SCHEMA = '@arki/event-sourcing/action-meta@1';
+export const EVENT_SOURCING_SCHEMA_REJECTED_CODE = 'EVENT_SOURCING_PLUGIN_E007';
+export class EventSourcingActionError extends Error {
+    code = EVENT_SOURCING_SCHEMA_REJECTED_CODE;
+    constructor(message, cause) {
+        super(message, { cause });
+        this.name = 'EventSourcingActionError';
+    }
+}
+function isJsonPrimitive(value) {
+    return value === null || typeof value === 'string' || typeof value === 'boolean' || typeof value === 'number';
+}
+function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function isJsonValue(value) {
+    if (isJsonPrimitive(value))
+        return typeof value !== 'number' || Number.isFinite(value);
+    if (Array.isArray(value))
+        return value.every(isJsonValue);
+    if (!isPlainObject(value))
+        return false;
+    return Object.values(value).every(isJsonValue);
+}
+export function isJsonObject(value) {
+    return isPlainObject(value) && Object.values(value).every(isJsonValue);
+}
+function jsonDeepEqual(left, right) {
+    if (isJsonPrimitive(left) || isJsonPrimitive(right))
+        return Object.is(left, right);
+    if (Array.isArray(left) || Array.isArray(right)) {
+        if (!Array.isArray(left) || !Array.isArray(right) || left.length !== right.length)
+            return false;
+        return left.every((value, index) => jsonDeepEqual(value, right[index]));
+    }
+    if (!isPlainObject(left) || !isPlainObject(right))
+        return false;
+    const leftEntries = Object.entries(left);
+    const rightEntries = Object.entries(right);
+    if (leftEntries.length !== rightEntries.length)
+        return false;
+    for (const [key, value] of leftEntries) {
+        if (!Object.hasOwn(right, key) || !jsonDeepEqual(value, right[key]))
+            return false;
+    }
+    return true;
+}
+function toJsonObject(value) {
+    const serialized = JSON.stringify(value);
+    if (serialized === undefined)
+        throw new TypeError('Value must be a JSON-serializable object.');
+    const parsed = JSON.parse(serialized);
+    if (!isJsonObject(parsed) || !jsonDeepEqual(value, parsed)) {
+        throw new TypeError('Value must be a JSON-serializable object without lossy coercions.');
+    }
+    return parsed;
+}
+export function schemaToJsonObject(schema, label) {
+    try {
+        const json = z.toJSONSchema(schema);
+        const rest = { ...json };
+        delete rest['$schema'];
+        return toJsonObject(rest);
+    }
+    catch (error) {
+        throw new EventSourcingActionError(`[event-sourcing] ${label} schema could not be converted to JSON Schema.`, error);
+    }
+}
+//# sourceMappingURL=dot-action.js.map

package/dist/dot-action.js.map

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

package/dist/dot.d.ts

@@ -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,31 +36,98 @@
  * 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 type { EventStore, MessageBus } from '@event-driven-io/emmett';
-import type { EmptyShape, Pip } from '@arki/dot/pip';
+import type { Command, Event, EventStore, MessageBus } from '@event-driven-io/emmett';
+import type { Plugin, Token } from '@arki/dot/plugin';
 import type { CommandHandlerRegistration } from './command.js';
 import type { PostgreSQLProjectionInput } from './event-sourcing-features.js';
+import type { CommandHandler } from './builders/command-handler.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 declare const EVENT_SOURCING_PIP_ERROR_CODES: {
+export declare const EVENT_SOURCING_PLUGIN_ERROR_CODES: {
     /** boot was called without a configured event-store URL. */
-    readonly dbUrlNotConfigured: "EVENT_SOURCING_PIP_E001";
+    readonly dbUrlNotConfigured: "EVENT_SOURCING_PLUGIN_E001";
+    /** two collected handlers claim the same command type. */
+    readonly duplicateCommandHandler: "EVENT_SOURCING_PLUGIN_E002";
+    /** a bundle token listed in options.bundles was not provided. */
+    readonly bundleMissing: "EVENT_SOURCING_PLUGIN_E003";
+    /** a command was dispatched with no registered handler. */
+    readonly commandHandlerMissing: "EVENT_SOURCING_PLUGIN_E004";
+    /** a command was dispatched after the dispatcher closed. */
+    readonly dispatcherClosed: "EVENT_SOURCING_PLUGIN_E005";
+    /** reserved for a future declared-action/handler parity diagnostic. */
+    readonly declaredActionUnbound: "EVENT_SOURCING_PLUGIN_E006";
+    /** command/event schema could not be converted to JSON Schema. */
+    readonly schemaRejected: "EVENT_SOURCING_PLUGIN_E007";
+};
+/** A token publishing an {@link EsBundle} — what `options.bundles` lists. */
+export type BundleToken = Token<EsBundle, string>;
+/** Wire-needs record derived from bundle tokens. */
+export type BundleNeeds<TBundles extends readonly BundleToken[]> = {
+    readonly [Tok in TBundles[number] as Tok extends Token<EsBundle, infer K> ? K : never]: EsBundle;
+};
+/**
+ * A feature token whose slice MAY carry an ES bundle under the `es` key —
+ * what `options.features` lists (the feature-plugins slice protocol).
+ * Features without an `es` slice contribute nothing, by design.
+ */
+export type EsFeatureToken = Token<{
+    readonly es?: EsBundle;
+}, string>;
+/** Wire-needs record derived from feature tokens. */
+export type EsFeatureNeeds<TFeatures extends readonly EsFeatureToken[]> = {
+    readonly [Tok in TFeatures[number] as Tok extends Token<unknown, infer K> ? K : never]: {
+        readonly es?: EsBundle;
+    };
+};
+type CommandFactory<C extends Command = Command> = {
+    readonly type: C['type'];
+} & ((input: never, metadata?: never) => C);
+/** Feature-local event-sourcing registrations collected by `eventSourcing()`. */
+export type EsBundle = {
+    /** Command handlers attached to the in-process message bus at boot. */
+    readonly handlers: readonly CommandHandlerRegistration[];
+    /** Inline PostgreSQL read-model projections registered on the event store. */
+    readonly readModels: readonly PostgreSQLProjectionInput[];
+};
+export type EsBundleInput = {
+    readonly handlers?: readonly CommandHandlerRegistration[];
+    readonly readModels?: readonly PostgreSQLProjectionInput[];
+};
+declare function bundle(input?: EsBundleInput): EsBundle;
+declare function handle<C extends Command, State, StreamEvent extends Event>(command: CommandFactory<C>, handler: CommandHandler<State, C, StreamEvent>, getStreamName: (command: C) => string): CommandHandlerRegistration<C, State, StreamEvent>;
+/** Namespace for feature-local ES bundle helpers. */
+export declare const es: {
+    bundle: typeof bundle;
+    handle: typeof handle;
 };
 /**
  * Options for the event-sourcing DOT adapter.
  */
-export type EventSourcingDotOptions = {
+export type EventSourcingDotOptions<TBundles extends readonly BundleToken[] = readonly BundleToken[], TFeatures extends readonly EsFeatureToken[] = readonly EsFeatureToken[]> = {
     /**
      * PostgreSQL projection definitions registered inline on the event store.
      * Accepts the three projection builder patterns documented on
      * {@link PostgreSQLProjectionInput}.
      */
-    readonly projections: readonly PostgreSQLProjectionInput[];
+    readonly projections?: readonly PostgreSQLProjectionInput[];
+    /**
+     * Feature-local bundles to collect. Each token becomes a typed DOT need,
+     * so the app builder rejects an `eventSourcing({ bundles })` collector
+     * unless an earlier plugin publishes every listed bundle.
+     */
+    readonly bundles?: TBundles;
+    /**
+     * Feature-plugin slice tokens to collect (`{ es?: EsBundle }`). Each token
+     * becomes a typed DOT need like `bundles`; a feature without an `es`
+     * slice contributes nothing (partial features are zero-config — a
+     * debug line records the empty contribution).
+     */
+    readonly features?: TFeatures;
     /**
      * Command handlers wired into the in-memory message bus. Each handler's
      * `getStreamName` callback maps an incoming command to its target stream.
@@ -70,7 +137,7 @@ export type EventSourcingDotOptions = {
      */
     readonly commandHandlers?: readonly CommandHandlerRegistration[];
     /**
-     * Connection URL for the event store. When omitted, the pip reads
+     * Connection URL for the event store. When omitted, the plugin reads
      * `EVENT_STORE_URL`, `EVENTSTORE_URL`, or `EVENT_DB_URL` from
      * `process.env`. If none are set, `boot` throws.
      */
@@ -87,10 +154,11 @@ export type EventSourcingServices = {
     readonly messageBus: MessageBus;
 };
 /**
- * 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 declare function eventSourcing(options: EventSourcingDotOptions): Pip<EmptyShape, EventSourcingServices>;
+export declare function eventSourcing<const TBundles extends readonly BundleToken[] = readonly [], const TFeatures extends readonly EsFeatureToken[] = readonly []>(options?: EventSourcingDotOptions<TBundles, TFeatures>): Plugin<BundleNeeds<TBundles> & EsFeatureNeeds<TFeatures>, EventSourcingServices>;
+export {};
 //# sourceMappingURL=dot.d.ts.map

package/dist/dot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dot.d.ts","sourceRoot":"","sources":["../src/dot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAG9E;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B;IACzC,4DAA4D;;CAEpD,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC3D;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACjE;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,qBAAqB,GAAG;IAClC,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC,CAAC;AAgBF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,uBAAuB,GAAG,GAAG,CAAC,UAAU,EAAE,qBAAqB,CAAC,CA2CtG"}
+{"version":3,"file":"dot.d.ts","sourceRoot":"","sources":["../src/dot.ts"],"names":[],"mappings":"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"}