@haskou/ddd-kernel 0.1.0 → 1.0.0

package/dist/adapters/pubsub/in-memory/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/adapters/pubsub/in-memory/InMemoryEventBus.ts","../../../../src/adapters/pubsub/in-memory/InMemoryPubSub.ts"],"sourcesContent":["import type {\n  DomainEvent,\n  HandlerContext,\n  MessageHandler,\n} from '../../../contracts/index.js';\n\nexport class InMemoryEventBus {\n  private readonly handlers = new Map<\n    string,\n    MessageHandler<DomainEvent, void>[]\n  >();\n\n  constructor(private readonly context: HandlerContext) {}\n\n  public subscribe<TEvent extends DomainEvent>(\n    name: TEvent['name'],\n    handler: MessageHandler<TEvent, void>,\n  ): void {\n    const handlers = this.handlers.get(name) ?? [];\n\n    handlers.push(handler as MessageHandler<DomainEvent, void>);\n    this.handlers.set(name, handlers);\n  }\n\n  public async publish<TEvent extends DomainEvent>(\n    event: TEvent,\n  ): Promise<void> {\n    const handlers = this.handlers.get(event.name) ?? [];\n\n    for (const handler of handlers) {\n      await handler(event, this.context);\n    }\n  }\n}\n","import type {\n  HandlerContext,\n  Message,\n  MessageHandler,\n  Subscription,\n} from '../../../contracts/index.js';\n\nexport class InMemoryPubSub {\n  private readonly consumers = new Map<\n    string,\n    Set<MessageHandler<Message, void>>\n  >();\n\n  constructor(private readonly context: HandlerContext) {}\n\n  public async publish<TMessage extends Message>(\n    topic: string,\n    message: TMessage,\n  ): Promise<void> {\n    const consumers = this.consumers.get(topic) ?? new Set();\n\n    for (const consumer of consumers) {\n      await consumer(message, this.context);\n    }\n  }\n\n  public subscribe<TMessage extends Message>(\n    topic: string,\n    consumer: MessageHandler<TMessage, void>,\n  ): Promise<Subscription> {\n    const consumers =\n      this.consumers.get(topic) ?? new Set<MessageHandler<Message, void>>();\n    const castConsumer = consumer as MessageHandler<Message, void>;\n\n    consumers.add(castConsumer);\n    this.consumers.set(topic, consumers);\n\n    return Promise.resolve({\n      close: () => {\n        consumers.delete(castConsumer);\n\n        return Promise.resolve();\n      },\n    });\n  }\n}\n"],"mappings":";AAMO,IAAM,mBAAN,MAAuB;AAAA,EAM5B,YAA6B,SAAyB;AAAzB;AAAA,EAA0B;AAAA,EAA1B;AAAA,EALZ,WAAW,oBAAI,IAG9B;AAAA,EAIK,UACL,MACA,SACM;AACN,UAAM,WAAW,KAAK,SAAS,IAAI,IAAI,KAAK,CAAC;AAE7C,aAAS,KAAK,OAA4C;AAC1D,SAAK,SAAS,IAAI,MAAM,QAAQ;AAAA,EAClC;AAAA,EAEA,MAAa,QACX,OACe;AACf,UAAM,WAAW,KAAK,SAAS,IAAI,MAAM,IAAI,KAAK,CAAC;AAEnD,eAAW,WAAW,UAAU;AAC9B,YAAM,QAAQ,OAAO,KAAK,OAAO;AAAA,IACnC;AAAA,EACF;AACF;;;AC1BO,IAAM,iBAAN,MAAqB;AAAA,EAM1B,YAA6B,SAAyB;AAAzB;AAAA,EAA0B;AAAA,EAA1B;AAAA,EALZ,YAAY,oBAAI,IAG/B;AAAA,EAIF,MAAa,QACX,OACA,SACe;AACf,UAAM,YAAY,KAAK,UAAU,IAAI,KAAK,KAAK,oBAAI,IAAI;AAEvD,eAAW,YAAY,WAAW;AAChC,YAAM,SAAS,SAAS,KAAK,OAAO;AAAA,IACtC;AAAA,EACF;AAAA,EAEO,UACL,OACA,UACuB;AACvB,UAAM,YACJ,KAAK,UAAU,IAAI,KAAK,KAAK,oBAAI,IAAmC;AACtE,UAAM,eAAe;AAErB,cAAU,IAAI,YAAY;AAC1B,SAAK,UAAU,IAAI,OAAO,SAAS;AAEnC,WAAO,QAAQ,QAAQ;AAAA,MACrB,OAAO,MAAM;AACX,kBAAU,OAAO,YAAY;AAE7B,eAAO,QAAQ,QAAQ;AAAA,MACzB;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":[]}
+{"version":3,"sources":["../../../../src/adapters/pubsub/DefaultPublisherHookErrorPolicy.ts","../../../../src/adapters/pubsub/PublisherHookPipeline.ts","../../../../src/adapters/pubsub/in-memory/InMemoryEventBus.ts","../../../../src/adapters/pubsub/in-memory/InMemoryPubSub.ts"],"sourcesContent":["import type {\n  PublishContext,\n  PublisherHookErrorPolicy,\n} from '../../contracts/index.js';\n\nexport class DefaultPublisherHookErrorPolicy implements PublisherHookErrorPolicy {\n  public handleAfterPublishError(\n    error: unknown,\n    context: PublishContext,\n  ): void {\n    void error;\n    void context;\n  }\n\n  public shouldFailAfterPublish(\n    error: unknown,\n    context: PublishContext,\n  ): boolean {\n    void error;\n    void context;\n\n    return false;\n  }\n}\n\nexport default DefaultPublisherHookErrorPolicy;\n","import type {\n  PublishContext,\n  PublisherHook,\n  PublisherHookErrorPolicy,\n} from '../../contracts/index.js';\n\nimport { DefaultPublisherHookErrorPolicy } from './DefaultPublisherHookErrorPolicy.js';\n\nexport class PublisherHookPipeline {\n  private readonly hooks: PublisherHook[] = [];\n\n  constructor(\n    hooks: readonly PublisherHook[] = [],\n    private readonly errorPolicy: PublisherHookErrorPolicy = new DefaultPublisherHookErrorPolicy(),\n  ) {\n    this.hooks.push(...hooks);\n  }\n\n  private async runAfterPublishHooks(context: PublishContext): Promise<void> {\n    for (const hook of this.hooks) {\n      await this.runAfterPublishHook(hook, context);\n    }\n  }\n\n  private async runAfterPublishHook(\n    hook: PublisherHook,\n    context: PublishContext,\n  ): Promise<void> {\n    try {\n      await hook.afterPublish?.(context);\n    } catch (error: unknown) {\n      await this.errorPolicy.handleAfterPublishError(error, context);\n\n      if (this.errorPolicy.shouldFailAfterPublish(error, context)) {\n        throw error;\n      }\n    }\n  }\n\n  private async runBeforePublishHooks(context: PublishContext): Promise<void> {\n    for (const hook of this.hooks) {\n      await hook.beforePublish?.(context);\n    }\n  }\n\n  private async runPublishErrorHooks(\n    error: unknown,\n    context: PublishContext,\n  ): Promise<void> {\n    for (const hook of this.hooks) {\n      await hook.onPublishError?.(error, context);\n    }\n  }\n\n  public register(...hooks: PublisherHook[]): void {\n    this.hooks.push(...hooks);\n  }\n\n  public async run<T>(\n    context: PublishContext,\n    publish: () => Promise<T> | T,\n  ): Promise<T> {\n    await this.runBeforePublishHooks(context);\n\n    try {\n      const result = await publish();\n\n      await this.runAfterPublishHooks(context);\n\n      return result;\n    } catch (error: unknown) {\n      await this.runPublishErrorHooks(error, context);\n\n      throw error;\n    }\n  }\n}\n","import type {\n  DomainEvent,\n  HandlerContext,\n  MessageHandler,\n  PublisherHook,\n  PublisherHookErrorPolicy,\n} from '../../../contracts/index.js';\n\nimport { PublisherHookPipeline } from '../PublisherHookPipeline.js';\n\nexport class InMemoryEventBus {\n  private readonly handlers = new Map<\n    string,\n    MessageHandler<DomainEvent, void>[]\n  >();\n\n  private readonly publisherHookPipeline: PublisherHookPipeline;\n\n  constructor(\n    private readonly context: HandlerContext,\n    publisherHooks: readonly PublisherHook[] = [],\n    publisherHookErrorPolicy?: PublisherHookErrorPolicy,\n  ) {\n    this.publisherHookPipeline = new PublisherHookPipeline(\n      publisherHooks,\n      publisherHookErrorPolicy,\n    );\n  }\n\n  public subscribe<TEvent extends DomainEvent>(\n    name: TEvent['name'],\n    handler: MessageHandler<TEvent, void>,\n  ): void {\n    const handlers = this.handlers.get(name) ?? [];\n\n    handlers.push(handler as MessageHandler<DomainEvent, void>);\n    this.handlers.set(name, handlers);\n  }\n\n  public async publish<TEvent extends DomainEvent>(\n    event: TEvent,\n  ): Promise<void> {\n    const handlers = this.handlers.get(event.name) ?? [];\n\n    await this.publisherHookPipeline.run(\n      { message: event, metadata: event.metadata ?? {}, topic: event.name },\n      async () => {\n        for (const handler of handlers) {\n          await handler(event, this.context);\n        }\n      },\n    );\n  }\n\n  public registerPublisherHooks(...hooks: PublisherHook[]): void {\n    this.publisherHookPipeline.register(...hooks);\n  }\n}\n","import type {\n  HandlerContext,\n  Message,\n  MessageHandler,\n  PublisherHook,\n  PublisherHookErrorPolicy,\n  Subscription,\n} from '../../../contracts/index.js';\n\nimport { PublisherHookPipeline } from '../PublisherHookPipeline.js';\n\nexport class InMemoryPubSub {\n  private readonly consumers = new Map<\n    string,\n    Set<MessageHandler<Message, void>>\n  >();\n\n  private readonly publisherHookPipeline: PublisherHookPipeline;\n\n  constructor(\n    private readonly context: HandlerContext,\n    publisherHooks: readonly PublisherHook[] = [],\n    publisherHookErrorPolicy?: PublisherHookErrorPolicy,\n  ) {\n    this.publisherHookPipeline = new PublisherHookPipeline(\n      publisherHooks,\n      publisherHookErrorPolicy,\n    );\n  }\n\n  public async publish<TMessage extends Message>(\n    topic: string,\n    message: TMessage,\n  ): Promise<void> {\n    const consumers = this.consumers.get(topic) ?? new Set();\n\n    await this.publisherHookPipeline.run(\n      { message, metadata: message.metadata ?? {}, topic },\n      async () => {\n        for (const consumer of consumers) {\n          await consumer(message, this.context);\n        }\n      },\n    );\n  }\n\n  public subscribe<TMessage extends Message>(\n    topic: string,\n    consumer: MessageHandler<TMessage, void>,\n  ): Promise<Subscription> {\n    const consumers =\n      this.consumers.get(topic) ?? new Set<MessageHandler<Message, void>>();\n    const castConsumer = consumer as MessageHandler<Message, void>;\n\n    consumers.add(castConsumer);\n    this.consumers.set(topic, consumers);\n\n    return Promise.resolve({\n      close: () => {\n        consumers.delete(castConsumer);\n\n        return Promise.resolve();\n      },\n    });\n  }\n\n  public registerPublisherHooks(...hooks: PublisherHook[]): void {\n    this.publisherHookPipeline.register(...hooks);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/adapters/pubsub/index.cjs

@@ -31,10 +31,17 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var pubsub_exports = {};
 __export(pubsub_exports, {
   Consumer: () => Consumer,
+  ConsumerMiddlewarePipeline: () => ConsumerMiddlewarePipeline,
+  CorrelationConsumerMiddleware: () => CorrelationConsumerMiddleware,
+  DefaultPublisherHookErrorPolicy: () => DefaultPublisherHookErrorPolicy,
+  IdempotencyConsumerMiddleware: () => IdempotencyConsumerMiddleware,
   InMemoryEventBus: () => InMemoryEventBus,
+  InMemoryIdempotencyStore: () => InMemoryIdempotencyStore,
   InMemoryPubSub: () => InMemoryPubSub,
   InvalidDomainEventError: () => InvalidDomainEventError,
   NoFailedMessagesError: () => NoFailedMessagesError,
+  PublisherHookPipeline: () => PublisherHookPipeline,
+  RetryConsumerMiddleware: () => RetryConsumerMiddleware,
   default: () => Consumer_default
 });
 module.exports = __toCommonJS(pubsub_exports);
@@ -81,6 +88,7 @@ var DependencyInjection = class _DependencyInjection {
   autowire;
   loader;
   container;
+  overrideTokenIds = /* @__PURE__ */ new Map();
   static configure(options) {
     _DependencyInjection.configuredInstance = new _DependencyInjection(options);
     return _DependencyInjection.configuredInstance;
@@ -105,6 +113,16 @@ var DependencyInjection = class _DependencyInjection {
   getServiceClassName(serviceName) {
     return typeof serviceName === "function" ? serviceName.name : void 0;
   }
+  getOverrideId(prefix, token) {
+    const tokenName = this.getServiceClassName(token) ?? String(token);
+    return `ddd-kernel.override.${prefix}.${tokenName}`;
+  }
+  ensureSyntheticService(id, value) {
+    const definition = this.container.register(id);
+    definition.public = true;
+    definition.synthetic = true;
+    this.container.set(id, value);
+  }
   parentMatchesService(parentId, serviceClassName) {
     if (!parentId) {
       return false;
@@ -116,6 +134,26 @@ var DependencyInjection = class _DependencyInjection {
     const serviceName = Buffer.from(serviceId, "base64").toString("utf8");
     return serviceName.endsWith(`__${serviceClassName}__${serviceClassName}`);
   }
+  serviceIdReferencesService(serviceId, serviceClassName) {
+    const serviceName = Buffer.from(serviceId, "base64").toString("utf8");
+    return serviceName.endsWith(`__${serviceClassName}`);
+  }
+  getReferenceId(value) {
+    if (typeof value === "object" && value !== null && "id" in value && typeof value.id === "string") {
+      return value.id;
+    }
+    return void 0;
+  }
+  getDefinitionArgumentReferences(definition) {
+    return [
+      ...definition._args ?? [],
+      ...definition._appendArgs ?? [],
+      ...definition._overrideArgs ?? []
+    ].flatMap((argument) => {
+      const referenceId = this.getReferenceId(argument);
+      return referenceId ? [referenceId] : [];
+    });
+  }
   findConcreteChildServiceId(serviceName) {
     const serviceClassName = this.getServiceClassName(serviceName);
     if (!serviceClassName) {
@@ -146,6 +184,86 @@ var DependencyInjection = class _DependencyInjection {
     );
     return matches[matches.length - 1];
   }
+  findReferencedServiceIds(serviceName) {
+    const serviceClassName = this.getServiceClassName(serviceName);
+    if (!serviceClassName) {
+      return [];
+    }
+    return [
+      ...new Set(
+        [...this.definitions.values()].flatMap(
+          (definition) => this.getDefinitionArgumentReferences(definition)
+        ).filter(
+          (id) => this.serviceIdReferencesService(id, serviceClassName)
+        )
+      )
+    ];
+  }
+  getOverrideTokenIds(token) {
+    const tokenIds = [
+      this.findRegisteredServiceId(token),
+      this.findAliasServiceId(token),
+      ...this.findReferencedServiceIds(token)
+    ].filter((id) => id !== void 0);
+    const existingTokenIds = [...new Set(tokenIds)];
+    if (existingTokenIds.length > 0) {
+      return existingTokenIds;
+    }
+    const overrideTokenId = this.getOverrideId("token", token);
+    this.ensureSyntheticService(overrideTokenId, void 0);
+    return [overrideTokenId];
+  }
+  getOverrideClassServiceId(ClassDefinition) {
+    const registeredServiceId = this.findRegisteredServiceId(ClassDefinition);
+    if (registeredServiceId) {
+      return registeredServiceId;
+    }
+    const overrideClassId = this.getOverrideId("class", ClassDefinition);
+    this.container.register(overrideClassId, ClassDefinition);
+    return overrideClassId;
+  }
+  applyClassOverride(override) {
+    if (!("useClass" in override)) {
+      return;
+    }
+    const tokenIds = this.getOverrideTokenIds(override.token);
+    const classId = this.getOverrideClassServiceId(override.useClass);
+    this.overrideTokenIds.set(override.token, tokenIds[0]);
+    for (const tokenId of tokenIds) {
+      this.container.setAlias(tokenId, classId);
+    }
+  }
+  applyFactoryOverride(override) {
+    if (!("useFactory" in override)) {
+      return;
+    }
+    const tokenIds = this.getOverrideTokenIds(override.token);
+    const factoryId = this.getOverrideId("factory", override.token);
+    this.ensureSyntheticService(factoryId, override.useFactory(this));
+    this.overrideTokenIds.set(override.token, tokenIds[0]);
+    for (const tokenId of tokenIds) {
+      this.container.setAlias(tokenId, factoryId);
+    }
+  }
+  applyValueOverride(override) {
+    if (!("useValue" in override)) {
+      return;
+    }
+    const tokenIds = this.getOverrideTokenIds(override.token);
+    const valueId = this.getOverrideId("value", override.token);
+    this.ensureSyntheticService(valueId, override.useValue);
+    this.overrideTokenIds.set(override.token, tokenIds[0]);
+    for (const tokenId of tokenIds) {
+      this.container.setAlias(tokenId, valueId);
+    }
+  }
+  applyOverrides() {
+    for (const override of this.options.overrides ?? []) {
+      this.applyClassOverride(override);
+      this.applyFactoryOverride(override);
+      this.applyValueOverride(override);
+    }
+  }
   registerParentAliases() {
     for (const [id, definition] of this.definitions.entries()) {
       if (definition._abstract === true || !definition._parent) {
@@ -168,17 +286,22 @@ var DependencyInjection = class _DependencyInjection {
       await this.loader.load(this.options.servicesYamlPath);
     }
     this.registerParentAliases();
+    this.applyOverrides();
     await this.container.compile();
   }
   getService(serviceName) {
-    const childServiceId = this.findConcreteChildServiceId(serviceName);
-    if (childServiceId) {
-      return this.container.get(childServiceId);
+    const overrideTokenId = this.overrideTokenIds.get(serviceName);
+    if (overrideTokenId) {
+      return this.container.get(overrideTokenId);
     }
     const aliasServiceId = this.findAliasServiceId(serviceName);
     if (aliasServiceId) {
       return this.container.get(aliasServiceId);
     }
+    const childServiceId = this.findConcreteChildServiceId(serviceName);
+    if (childServiceId) {
+      return this.container.get(childServiceId);
+    }
     const registeredServiceId = this.findRegisteredServiceId(serviceName);
     if (registeredServiceId) {
       return this.container.get(registeredServiceId);
@@ -226,6 +349,9 @@ var Kernel = class _Kernel {
   static get logger() {
     return _Kernel.getActiveKernel().logger;
   }
+  static get active() {
+    return _Kernel.getActiveKernel();
+  }
   static get rootDirectory() {
     return process.cwd();
   }
@@ -294,13 +420,21 @@ var Kernel = class _Kernel {
   get schedulers() {
     return this.schedulersList;
   }
-  async dependencyInjection() {
-    this.dependencyInjectionInstance = this.dependencyInjectionInstance ?? DependencyInjection.configure({
-      containerBuild: process.env.CONTAINER_BUILD === "true",
-      servicesYamlPath: this.options.servicesYamlPath ?? import_node_path2.default.resolve(_Kernel.configDirectory, "container", "services.yaml"),
-      sourceDirectory: this.options.sourceDirectory ?? _Kernel.sourceDirectory
-    });
+  getDependencyInjectionOptions(options = {}) {
+    return {
+      containerBuild: options.containerBuild ?? process.env.CONTAINER_BUILD === "true",
+      overrides: options.overrides ?? [],
+      servicesYamlPath: options.servicesYamlPath ?? this.options.servicesYamlPath ?? import_node_path2.default.resolve(_Kernel.configDirectory, "container", "services.yaml"),
+      sourceDirectory: options.sourceDirectory ?? this.options.sourceDirectory ?? _Kernel.sourceDirectory
+    };
+  }
+  async dependencyInjection(options = {}) {
+    _Kernel.state.activeKernel = this;
+    this.dependencyInjectionInstance = this.dependencyInjectionInstance ?? DependencyInjection.configure(
+      this.getDependencyInjectionOptions(options)
+    );
     await this.dependencyInjectionInstance.compile();
+    _Kernel.state.activeKernel = this;
   }
   getRoutes() {
     return this.routes;
@@ -383,21 +517,52 @@ var Kernel = class _Kernel {
   }
 };
 
+// src/adapters/pubsub/ConsumerMiddlewarePipeline.ts
+var ConsumerMiddlewarePipeline = class {
+  constructor(middlewares) {
+    this.middlewares = middlewares;
+  }
+  middlewares;
+  async run(event, context, handler, index) {
+    const middleware = this.middlewares[index];
+    if (!middleware) {
+      await handler();
+      return;
+    }
+    await middleware.handle(
+      event,
+      () => this.run(event, context, handler, index + 1),
+      context
+    );
+  }
+  async execute(event, context, handler) {
+    await this.run(event, context, handler, 0);
+  }
+};
+
 // src/adapters/pubsub/Consumer.ts
 var Consumer = class {
   constructor(consumer) {
     this.consumer = consumer;
   }
   consumer;
-  async runMiddleware(event, middlewares, index) {
-    const middleware = middlewares[index];
-    if (!middleware) {
-      await this.handler(event);
-      return;
-    }
-    await middleware.handle(
+  async runMiddleware(event, consumerContext) {
+    const pipeline = new ConsumerMiddlewarePipeline(Kernel.consumerMiddleware);
+    const metadata = consumerContext?.metadata ?? {};
+    await pipeline.execute(
       event,
-      () => this.runMiddleware(event, middlewares, index + 1)
+      {
+        causationId: event.getCausationId(),
+        correlationId: event.getCorrelationId(),
+        eventId: event.eventId,
+        eventName: this.eventName,
+        exchange: this.exchange,
+        kernel: Kernel.active,
+        metadata,
+        queueName: this.queueName,
+        rawMessage: metadata.rawMessage
+      },
+      () => this.handler(event)
     );
   }
   async init() {
@@ -406,7 +571,7 @@ var Consumer = class {
       this.eventName,
       this.domainEvent,
       this.exchange,
-      (event) => this.runMiddleware(event, Kernel.consumerMiddleware, 0)
+      (event, context) => this.runMiddleware(event, context)
     );
   }
   get(service) {
@@ -415,6 +580,178 @@ var Consumer = class {
 };
 var Consumer_default = Consumer;
 
+// src/adapters/pubsub/CorrelationConsumerMiddleware.ts
+var CorrelationConsumerMiddleware = class {
+  constructor(options = {}) {
+    this.options = options;
+  }
+  options;
+  async handle(event, next, context) {
+    const correlationId = this.options.correlationId?.(event, context) ?? context.correlationId;
+    const causationId = this.options.causationId?.(event, context) ?? context.causationId;
+    if (correlationId) {
+      event.withCorrelationId(correlationId);
+    }
+    if (causationId) {
+      event.withCausationId(causationId);
+    }
+    await next();
+  }
+};
+
+// src/adapters/pubsub/DefaultPublisherHookErrorPolicy.ts
+var DefaultPublisherHookErrorPolicy = class {
+  handleAfterPublishError(error, context) {
+    void error;
+    void context;
+  }
+  shouldFailAfterPublish(error, context) {
+    void error;
+    void context;
+    return false;
+  }
+};
+
+// src/adapters/pubsub/IdempotencyConsumerMiddleware.ts
+var IdempotencyConsumerMiddleware = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  async handleClaimedKey(key, next) {
+    const claimed = await this.options.store.claim?.(key);
+    if (!claimed) {
+      return;
+    }
+    try {
+      await next();
+      await (this.options.store.commit?.(key) ?? this.options.store.mark(key));
+    } catch (error) {
+      await this.options.store.release?.(key);
+      throw error;
+    }
+  }
+  async handleLegacyKey(key, next) {
+    if (await this.options.store.has(key)) {
+      return;
+    }
+    await next();
+    await this.options.store.mark(key);
+  }
+  async handle(event, next, context) {
+    const key = this.options.key?.(event, context) ?? context.eventId;
+    if (this.options.store.claim) {
+      await this.handleClaimedKey(key, next);
+    } else {
+      await this.handleLegacyKey(key, next);
+    }
+  }
+};
+
+// src/adapters/pubsub/InMemoryIdempotencyStore.ts
+var InMemoryIdempotencyStore = class {
+  claimedKeys = /* @__PURE__ */ new Set();
+  handledKeys = /* @__PURE__ */ new Set();
+  claim(key) {
+    if (this.handledKeys.has(key) || this.claimedKeys.has(key)) {
+      return false;
+    }
+    this.claimedKeys.add(key);
+    return true;
+  }
+  commit(key) {
+    this.claimedKeys.delete(key);
+    this.handledKeys.add(key);
+  }
+  release(key) {
+    this.claimedKeys.delete(key);
+  }
+  has(key) {
+    return this.handledKeys.has(key);
+  }
+  mark(key) {
+    this.handledKeys.add(key);
+  }
+};
+
+// src/adapters/pubsub/PublisherHookPipeline.ts
+var PublisherHookPipeline = class {
+  constructor(hooks = [], errorPolicy = new DefaultPublisherHookErrorPolicy()) {
+    this.errorPolicy = errorPolicy;
+    this.hooks.push(...hooks);
+  }
+  errorPolicy;
+  hooks = [];
+  async runAfterPublishHooks(context) {
+    for (const hook of this.hooks) {
+      await this.runAfterPublishHook(hook, context);
+    }
+  }
+  async runAfterPublishHook(hook, context) {
+    try {
+      await hook.afterPublish?.(context);
+    } catch (error) {
+      await this.errorPolicy.handleAfterPublishError(error, context);
+      if (this.errorPolicy.shouldFailAfterPublish(error, context)) {
+        throw error;
+      }
+    }
+  }
+  async runBeforePublishHooks(context) {
+    for (const hook of this.hooks) {
+      await hook.beforePublish?.(context);
+    }
+  }
+  async runPublishErrorHooks(error, context) {
+    for (const hook of this.hooks) {
+      await hook.onPublishError?.(error, context);
+    }
+  }
+  register(...hooks) {
+    this.hooks.push(...hooks);
+  }
+  async run(context, publish) {
+    await this.runBeforePublishHooks(context);
+    try {
+      const result = await publish();
+      await this.runAfterPublishHooks(context);
+      return result;
+    } catch (error) {
+      await this.runPublishErrorHooks(error, context);
+      throw error;
+    }
+  }
+};
+
+// src/adapters/pubsub/RetryConsumerMiddleware.ts
+var RetryConsumerMiddleware = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  async delay(attempt, error, context) {
+    const delayInMilliseconds = typeof this.options.delay === "function" ? await this.options.delay(attempt, error, context) : this.options.delay ?? 0;
+    if (delayInMilliseconds > 0) {
+      await new Promise((resolve) => setTimeout(resolve, delayInMilliseconds));
+    }
+  }
+  async handle(event, next, context) {
+    for (let attempt = 1; attempt <= this.options.maxAttempts; attempt++) {
+      try {
+        await next();
+        return;
+      } catch (error) {
+        const canRetry = attempt < this.options.maxAttempts && await (this.options.shouldRetry?.(error, attempt, context) ?? true);
+        if (!canRetry) {
+          throw error;
+        }
+        await this.options.onRetry?.(error, attempt, context);
+        await this.delay(attempt, error, context);
+      }
+    }
+  }
+};
+
 // src/adapters/pubsub/amqp/AmqpMessageBusAdapter.ts
 var import_amqplib = __toESM(require("amqplib"), 1);
 var import_node_crypto = require("crypto");
@@ -437,11 +774,16 @@ var NoFailedMessagesError = class extends Error {
 
 // src/adapters/pubsub/in-memory/InMemoryEventBus.ts
 var InMemoryEventBus = class {
-  constructor(context) {
+  constructor(context, publisherHooks = [], publisherHookErrorPolicy) {
     this.context = context;
+    this.publisherHookPipeline = new PublisherHookPipeline(
+      publisherHooks,
+      publisherHookErrorPolicy
+    );
   }
   context;
   handlers = /* @__PURE__ */ new Map();
+  publisherHookPipeline;
   subscribe(name, handler) {
     const handlers = this.handlers.get(name) ?? [];
     handlers.push(handler);
@@ -449,24 +791,42 @@ var InMemoryEventBus = class {
   }
   async publish(event) {
     const handlers = this.handlers.get(event.name) ?? [];
-    for (const handler of handlers) {
-      await handler(event, this.context);
-    }
+    await this.publisherHookPipeline.run(
+      { message: event, metadata: event.metadata ?? {}, topic: event.name },
+      async () => {
+        for (const handler of handlers) {
+          await handler(event, this.context);
+        }
+      }
+    );
+  }
+  registerPublisherHooks(...hooks) {
+    this.publisherHookPipeline.register(...hooks);
   }
 };
 
 // src/adapters/pubsub/in-memory/InMemoryPubSub.ts
 var InMemoryPubSub = class {
-  constructor(context) {
+  constructor(context, publisherHooks = [], publisherHookErrorPolicy) {
     this.context = context;
+    this.publisherHookPipeline = new PublisherHookPipeline(
+      publisherHooks,
+      publisherHookErrorPolicy
+    );
   }
   context;
   consumers = /* @__PURE__ */ new Map();
+  publisherHookPipeline;
   async publish(topic, message) {
     const consumers = this.consumers.get(topic) ?? /* @__PURE__ */ new Set();
-    for (const consumer of consumers) {
-      await consumer(message, this.context);
-    }
+    await this.publisherHookPipeline.run(
+      { message, metadata: message.metadata ?? {}, topic },
+      async () => {
+        for (const consumer of consumers) {
+          await consumer(message, this.context);
+        }
+      }
+    );
   }
   subscribe(topic, consumer) {
     const consumers = this.consumers.get(topic) ?? /* @__PURE__ */ new Set();
@@ -480,13 +840,23 @@ var InMemoryPubSub = class {
       }
     });
   }
+  registerPublisherHooks(...hooks) {
+    this.publisherHookPipeline.register(...hooks);
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Consumer,
+  ConsumerMiddlewarePipeline,
+  CorrelationConsumerMiddleware,
+  DefaultPublisherHookErrorPolicy,
+  IdempotencyConsumerMiddleware,
   InMemoryEventBus,
+  InMemoryIdempotencyStore,
   InMemoryPubSub,
   InvalidDomainEventError,
-  NoFailedMessagesError
+  NoFailedMessagesError,
+  PublisherHookPipeline,
+  RetryConsumerMiddleware
 });
 //# sourceMappingURL=index.cjs.map