stratal 0.0.13 → 0.0.14

package/dist/queue/index.mjs

@@ -0,0 +1,80 @@
+import "../errors-BRJgVd5-.mjs";
+import { a as __decorate, d as Transient, g as DI_TOKENS, o as __decorateParam, s as __decorateMetadata } from "../logger-Bg-CuidS.mjs";
+import "../module-Dvzm4dhS.mjs";
+import "../events-CQyvSyrQ.mjs";
+import "../middleware-B3tx1u1K.mjs";
+import "../router-context-DlTxpJUG.mjs";
+import { a as CloudflareQueueProvider, c as QUEUE_TOKENS, i as SyncQueueProvider, l as QueueSender, n as QueueRegistry, o as QueueProviderNotSupportedError, r as QueueProviderFactory, s as QueueBindingNotFoundError, t as QueueModule, u as ConsumerRegistry } from "../queue.module-ZqaZ2iY0.mjs";
+import { inject } from "tsyringe";
+//#region src/queue/queue-manager.ts
+var _ref;
+let QueueManager = class QueueManager {
+	constructor(registry) {
+		this.registry = registry;
+	}
+	/**
+	* Process a batch of queue messages
+	*
+	* Routes messages to registered consumers based on message type.
+	* Uses ConsumerRegistry to find matching consumers.
+	*
+	* @param _queueName - Name of the queue (for logging, not used for routing)
+	* @param batch - Batch of messages from Cloudflare Queue
+	*/
+	async processBatch(_queueName, batch) {
+		for (const message of batch.messages) {
+			const queueMessage = message.body;
+			const consumers = this.registry.getConsumers(queueMessage.type);
+			for (const consumer of consumers) try {
+				await consumer.handle(queueMessage);
+				message.ack();
+			} catch (error) {
+				const errorInstance = error instanceof Error ? error : new Error(String(error));
+				if (consumer.onError) await consumer.onError(errorInstance, queueMessage);
+				message.retry();
+			}
+		}
+	}
+};
+QueueManager = __decorate([
+	Transient(DI_TOKENS.Queue),
+	__decorateParam(0, inject(DI_TOKENS.ConsumerRegistry)),
+	__decorateMetadata("design:paramtypes", [typeof (_ref = typeof ConsumerRegistry !== "undefined" && ConsumerRegistry) === "function" ? _ref : Object])
+], QueueManager);
+//#endregion
+//#region src/queue/decorators/inject-queue.decorator.ts
+/**
+* Inject a queue sender by name.
+*
+* Queue names are typed via module augmentation of QueueNames interface.
+* The queue name serves as both the identifier and the DI injection token.
+*
+* @param name - Queue name (typed with autocomplete if QueueNames is augmented)
+* @returns Parameter decorator for constructor injection
+*
+* @example
+* ```typescript
+* // Direct injection by queue name
+* constructor(
+*   @InjectQueue('notifications-queue') private queue: IQueueSender
+* ) {}
+*
+* // Usage
+* await this.queue.dispatch({
+*   type: 'email.send',
+*   payload: { to: 'user@example.com', subject: 'Hello' }
+* })
+* ```
+*
+* @remarks
+* The queue must be registered via `QueueModule.registerQueue(name)` before injection.
+* For module-internal queue bindings (e.g., EmailModule), use `@inject(TOKEN)` with
+* `useExisting` provider binding instead.
+*/
+function InjectQueue(name) {
+	return inject(name);
+}
+//#endregion
+export { CloudflareQueueProvider, ConsumerRegistry, InjectQueue, QUEUE_TOKENS, QueueBindingNotFoundError, QueueManager, QueueModule, QueueProviderFactory, QueueProviderNotSupportedError, QueueRegistry, QueueSender, SyncQueueProvider };
+
+//# sourceMappingURL=index.mjs.map

package/dist/queue/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/queue/queue-manager.ts","../../src/queue/decorators/inject-queue.decorator.ts"],"sourcesContent":["import { inject } from 'tsyringe'\nimport { Transient } from '../di/decorators'\nimport { DI_TOKENS } from '../di/tokens'\nimport { ConsumerRegistry } from './consumer-registry'\nimport type { QueueMessage } from './queue-consumer'\n\n/**\n * Queue Manager\n *\n * Singleton service for processing queue message batches.\n * Routes messages to consumers based on message type.\n *\n * **Message Routing:**\n * - Consumers declare message types they handle (e.g., ['email.send'])\n * - When a message arrives, consumers matching the message type are invoked\n * - A consumer can handle messages from ANY queue (routing is by type, not queue)\n *\n * **Note:** For sending messages to queues, use IQueueSender instances\n * obtained via @InjectQueue('queue-name') or module bindings.\n *\n * @example Processing a queue batch\n * ```typescript\n * // In Cloudflare Worker queue handler\n * await queueManager.processBatch('notifications-queue', batch)\n * ```\n */\n@Transient(DI_TOKENS.Queue)\nexport class QueueManager {\n  constructor(\n    @inject(DI_TOKENS.ConsumerRegistry) private readonly registry: ConsumerRegistry\n  ) {}\n\n  /**\n   * Process a batch of queue messages\n   *\n   * Routes messages to registered consumers based on message type.\n   * Uses ConsumerRegistry to find matching consumers.\n   *\n   * @param _queueName - Name of the queue (for logging, not used for routing)\n   * @param batch - Batch of messages from Cloudflare Queue\n   */\n  async processBatch(_queueName: string, batch: MessageBatch): Promise<void> {\n    for (const message of batch.messages) {\n      const queueMessage = message.body as QueueMessage\n\n      // Find consumers by message type (not by queue name)\n      const consumers = this.registry.getConsumers(queueMessage.type)\n\n      for (const consumer of consumers) {\n        try {\n          await consumer.handle(queueMessage)\n          message.ack()\n        } catch (error) {\n          const errorInstance = error instanceof Error\n            ? error\n            : new Error(String(error))\n\n          if (consumer.onError) {\n            await consumer.onError(errorInstance, queueMessage)\n          }\n          message.retry()\n        }\n      }\n    }\n  }\n}\n","import { inject } from 'tsyringe'\nimport type { QueueName } from '../queue-name'\n\n/**\n * Inject a queue sender by name.\n *\n * Queue names are typed via module augmentation of QueueNames interface.\n * The queue name serves as both the identifier and the DI injection token.\n *\n * @param name - Queue name (typed with autocomplete if QueueNames is augmented)\n * @returns Parameter decorator for constructor injection\n *\n * @example\n * ```typescript\n * // Direct injection by queue name\n * constructor(\n *   @InjectQueue('notifications-queue') private queue: IQueueSender\n * ) {}\n *\n * // Usage\n * await this.queue.dispatch({\n *   type: 'email.send',\n *   payload: { to: 'user@example.com', subject: 'Hello' }\n * })\n * ```\n *\n * @remarks\n * The queue must be registered via `QueueModule.registerQueue(name)` before injection.\n * For module-internal queue bindings (e.g., EmailModule), use `@inject(TOKEN)` with\n * `useExisting` provider binding instead.\n */\nexport function InjectQueue(name: QueueName): ParameterDecorator {\n  return inject(name)\n}\n"],"mappings":";;;;;;;;;;AA2BO,IAAA,eAAA,MAAM,aAAa;CACxB,YACE,UACA;AADqD,OAAA,WAAA;;;;;;;;;;;CAYvD,MAAM,aAAa,YAAoB,OAAoC;AACzE,OAAK,MAAM,WAAW,MAAM,UAAU;GACpC,MAAM,eAAe,QAAQ;GAG7B,MAAM,YAAY,KAAK,SAAS,aAAa,aAAa,KAAK;AAE/D,QAAK,MAAM,YAAY,UACrB,KAAI;AACF,UAAM,SAAS,OAAO,aAAa;AACnC,YAAQ,KAAK;YACN,OAAO;IACd,MAAM,gBAAgB,iBAAiB,QACnC,QACA,IAAI,MAAM,OAAO,MAAM,CAAC;AAE5B,QAAI,SAAS,QACX,OAAM,SAAS,QAAQ,eAAe,aAAa;AAErD,YAAQ,OAAO;;;;;;CAlCxB,UAAU,UAAU,MAAM;oBAGtB,OAAO,UAAU,iBAAiB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACEvC,SAAgB,YAAY,MAAqC;AAC/D,QAAO,OAAO,KAAK"}

package/dist/queue.module-ZqaZ2iY0.mjs

@@ -0,0 +1,403 @@
+import { S as ApplicationError, b as ERROR_CODES, o as I18N_TOKENS, s as Scope } from "./errors-BRJgVd5-.mjs";
+import { a as __decorate, d as Transient, g as DI_TOKENS, o as __decorateParam, s as __decorateMetadata } from "./logger-Bg-CuidS.mjs";
+import { r as Module } from "./module-Dvzm4dhS.mjs";
+import { inject } from "tsyringe";
+//#region src/queue/consumer-registry.ts
+let ConsumerRegistry = class ConsumerRegistry {
+	/** Map from message type to consumers handling that type */
+	consumersByType = /* @__PURE__ */ new Map();
+	/** Set of all registered consumers (for iteration) */
+	allConsumers = /* @__PURE__ */ new Set();
+	/**
+	* Register a queue consumer
+	*
+	* Indexes the consumer by each of its declared message types.
+	*
+	* @param consumer - Queue consumer to register
+	*/
+	register(consumer) {
+		if (this.allConsumers.has(consumer)) return;
+		this.allConsumers.add(consumer);
+		for (const messageType of consumer.messageTypes) {
+			const existing = this.consumersByType.get(messageType) ?? [];
+			existing.push(consumer);
+			this.consumersByType.set(messageType, existing);
+		}
+	}
+	/**
+	* Get all consumers that can handle a specific message type
+	*
+	* Returns consumers that either:
+	* - Explicitly declare the message type
+	* - Use '*' wildcard to handle all types
+	*
+	* @param messageType - The message type to find consumers for
+	* @returns Array of consumers that can handle this message type
+	*/
+	getConsumers(messageType) {
+		const exactMatch = this.consumersByType.get(messageType) ?? [];
+		const wildcardMatch = this.consumersByType.get("*") ?? [];
+		const combined = new Set([...exactMatch, ...wildcardMatch]);
+		return Array.from(combined);
+	}
+	/**
+	* Check if any consumers can handle a message type
+	*
+	* @param messageType - The message type to check
+	* @returns true if at least one consumer can handle this type
+	*/
+	hasConsumers(messageType) {
+		return this.getConsumers(messageType).length > 0;
+	}
+	/**
+	* Get all registered message types
+	*
+	* @returns Array of message types with registered consumers
+	*/
+	getMessageTypes() {
+		return Array.from(this.consumersByType.keys());
+	}
+	/**
+	* Get all registered consumers
+	*
+	* @returns Array of all registered consumers
+	*/
+	getAllConsumers() {
+		return Array.from(this.allConsumers);
+	}
+};
+ConsumerRegistry = __decorate([Transient(DI_TOKENS.ConsumerRegistry)], ConsumerRegistry);
+//#endregion
+//#region src/queue/queue-sender.ts
+/**
+* Queue Sender
+*
+* Implementation of IQueueSender bound to a specific queue name.
+* Created by QueueRegistry for each registered queue.
+*
+* Automatically enriches messages with:
+* - `id`: UUID generated via crypto.randomUUID()
+* - `timestamp`: Current time in milliseconds
+* - `metadata.locale`: Current locale from I18n context
+*
+* @example
+* ```typescript
+* // Created by QueueRegistry, not directly instantiated
+* const sender = registry.getQueue('notifications-queue')
+*
+* await sender.dispatch({
+*   type: 'email.send',
+*   payload: { to: 'user@example.com', subject: 'Hello' }
+* })
+* ```
+*/
+var QueueSender = class {
+	constructor(queueName, provider, i18n) {
+		this.queueName = queueName;
+		this.provider = provider;
+		this.i18n = i18n;
+	}
+	/**
+	* Dispatch a message to this queue.
+	*
+	* @param message - Message to dispatch (without id/timestamp)
+	*/
+	async dispatch(message) {
+		const metadata = { ...message.metadata };
+		if (!metadata.locale) {
+			const locale = this.i18n.getLocale();
+			if (locale) metadata.locale = locale;
+		}
+		const fullMessage = {
+			id: crypto.randomUUID(),
+			timestamp: Date.now(),
+			...message,
+			metadata: Object.keys(metadata).length > 0 ? metadata : void 0
+		};
+		await this.provider.send(this.queueName, fullMessage);
+	}
+};
+//#endregion
+//#region src/queue/queue.tokens.ts
+const QUEUE_TOKENS = {
+	QueueProviderFactory: Symbol.for("stratal:queue:provider:factory"),
+	QueueRegistry: Symbol.for("stratal:queue:registry"),
+	QueueModuleOptions: Symbol.for("stratal:queue:options")
+};
+//#endregion
+//#region src/queue/errors/queue-binding-not-found.error.ts
+/**
+* QueueBindingNotFoundError
+*
+* Thrown when attempting to access a Cloudflare Queue binding that hasn't been configured.
+* This typically indicates that the queue binding is missing from wrangler.jsonc
+* or the environment variables are not properly set.
+*/
+var QueueBindingNotFoundError = class extends ApplicationError {
+	constructor(queueName, bindingName) {
+		super("errors.queueBindingNotFound", ERROR_CODES.SYSTEM.QUEUE_BINDING_NOT_FOUND, {
+			queueName,
+			bindingName
+		});
+	}
+};
+//#endregion
+//#region src/queue/errors/queue-provider-not-supported.error.ts
+/**
+* QueueProviderNotSupportedError
+*
+* Thrown when attempting to use a queue provider that is not supported.
+* Valid providers are: 'cloudflare', 'sync'
+*
+* This typically indicates an invalid QUEUE_PROVIDER environment variable.
+*/
+var QueueProviderNotSupportedError = class extends ApplicationError {
+	constructor(provider) {
+		super("errors.queueProviderNotSupported", ERROR_CODES.SYSTEM.QUEUE_PROVIDER_NOT_SUPPORTED, { provider });
+	}
+};
+//#endregion
+//#region src/queue/providers/cloudflare-queue.provider.ts
+let CloudflareQueueProvider = class CloudflareQueueProvider {
+	constructor(env) {
+		this.env = env;
+	}
+	/**
+	* Send a message to a Cloudflare Queue
+	*
+	* @param queueName - Queue name (e.g., 'notifications-queue')
+	* @param message - Complete message with id, timestamp, and payload
+	* @throws {QueueBindingNotFoundError} If queue binding is not configured
+	*/
+	async send(queueName, message) {
+		await this.getQueue(queueName).send(message);
+	}
+	/**
+	* Resolve queue binding from Cloudflare environment
+	*
+	* Converts kebab-case queue name to UPPER_SNAKE_CASE binding name.
+	*
+	* @param queueName - Queue name (e.g., 'notifications-queue')
+	* @returns Cloudflare Queue binding
+	* @throws {QueueBindingNotFoundError} If binding not found in env
+	*/
+	getQueue(queueName) {
+		const bindingName = queueName.toUpperCase().replace(/-/g, "_");
+		const queue = this.env[bindingName];
+		if (!queue) throw new QueueBindingNotFoundError(queueName, bindingName);
+		return queue;
+	}
+};
+CloudflareQueueProvider = __decorate([
+	Transient(),
+	__decorateParam(0, inject(DI_TOKENS.CloudflareEnv)),
+	__decorateMetadata("design:paramtypes", [Object])
+], CloudflareQueueProvider);
+//#endregion
+//#region src/queue/providers/sync-queue.provider.ts
+var _ref$2;
+let SyncQueueProvider = class SyncQueueProvider {
+	constructor(registry) {
+		this.registry = registry;
+	}
+	/**
+	* Process a message synchronously
+	*
+	* Finds all matching consumers by message type and calls their handle() method.
+	* If any consumer throws, onError() is called and the error is re-thrown.
+	*
+	* @param _queueName - Queue name (not used for routing, consumers match by message type)
+	* @param message - Complete message with id, timestamp, and payload
+	* @throws Re-throws any error from consumer.handle() after calling onError()
+	*/
+	async send(_queueName, message) {
+		const consumers = this.registry.getConsumers(message.type);
+		for (const consumer of consumers) try {
+			await consumer.handle(message);
+		} catch (error) {
+			const errorInstance = error instanceof Error ? error : new Error(String(error));
+			if (consumer.onError) await consumer.onError(errorInstance, message);
+			throw errorInstance;
+		}
+	}
+};
+SyncQueueProvider = __decorate([
+	Transient(),
+	__decorateParam(0, inject(DI_TOKENS.ConsumerRegistry)),
+	__decorateMetadata("design:paramtypes", [typeof (_ref$2 = typeof ConsumerRegistry !== "undefined" && ConsumerRegistry) === "function" ? _ref$2 : Object])
+], SyncQueueProvider);
+//#endregion
+//#region src/queue/services/queue-provider-factory.ts
+var _ref$1;
+let QueueProviderFactory = class QueueProviderFactory {
+	constructor(env, registry, options) {
+		this.env = env;
+		this.registry = registry;
+		this.options = options;
+	}
+	/**
+	* Create a queue provider based on module configuration
+	*
+	* @returns Queue provider instance
+	* @throws {QueueProviderNotSupportedError} If provider type is not supported
+	*/
+	create() {
+		const providerType = this.options?.provider ?? "cloudflare";
+		switch (providerType) {
+			case "cloudflare": return new CloudflareQueueProvider(this.env);
+			case "sync": return new SyncQueueProvider(this.registry);
+			default: throw new QueueProviderNotSupportedError(providerType);
+		}
+	}
+};
+QueueProviderFactory = __decorate([
+	Transient(QUEUE_TOKENS.QueueProviderFactory),
+	__decorateParam(0, inject(DI_TOKENS.CloudflareEnv)),
+	__decorateParam(1, inject(DI_TOKENS.ConsumerRegistry)),
+	__decorateParam(2, inject(QUEUE_TOKENS.QueueModuleOptions, { isOptional: true })),
+	__decorateMetadata("design:paramtypes", [
+		Object,
+		typeof (_ref$1 = typeof ConsumerRegistry !== "undefined" && ConsumerRegistry) === "function" ? _ref$1 : Object,
+		Object
+	])
+], QueueProviderFactory);
+//#endregion
+//#region src/queue/queue-registry.ts
+var _ref;
+let QueueRegistry = class QueueRegistry {
+	provider;
+	senders = /* @__PURE__ */ new Map();
+	constructor(providerFactory, i18n) {
+		this.i18n = i18n;
+		this.provider = providerFactory.create();
+	}
+	/**
+	* Get or create a QueueSender for the specified queue name.
+	*
+	* Senders are cached per queue name within the request scope.
+	*
+	* @param queueName - The queue name to get a sender for
+	* @returns QueueSender bound to the specified queue
+	*/
+	getQueue(queueName) {
+		let sender = this.senders.get(queueName);
+		if (!sender) {
+			sender = new QueueSender(queueName, this.provider, this.i18n);
+			this.senders.set(queueName, sender);
+		}
+		return sender;
+	}
+};
+QueueRegistry = __decorate([
+	Transient(QUEUE_TOKENS.QueueRegistry),
+	__decorateParam(0, inject(QUEUE_TOKENS.QueueProviderFactory)),
+	__decorateParam(1, inject(I18N_TOKENS.I18nService)),
+	__decorateMetadata("design:paramtypes", [typeof (_ref = typeof QueueProviderFactory !== "undefined" && QueueProviderFactory) === "function" ? _ref : Object, Object])
+], QueueRegistry);
+//#endregion
+//#region src/queue/queue.module.ts
+/**
+* Queue Module
+*
+* Provides declarative queue infrastructure with provider abstraction.
+*
+* **Usage:**
+* ```typescript
+* // 1. Configure provider (once, in app root)
+* QueueModule.forRootAsync({
+*   inject: [CONFIG_TOKENS.ConfigService],
+*   useFactory: (config) => ({ provider: config.get('queue').provider })
+* })
+*
+* // 2. Register queues (queue name IS the injection token)
+* QueueModule.registerQueue('notifications-queue')
+* QueueModule.registerQueue('batch-notifications-queue')
+*
+* // 3. Inject and use
+* constructor(@InjectQueue('notifications-queue') private queue: IQueueSender) {}
+* await this.queue.dispatch({ type: 'email.send', payload: {...} })
+* ```
+*
+* **Providers:**
+* - `cloudflare`: Production provider using Cloudflare Queue bindings
+* - `sync`: Testing provider that processes messages immediately
+*/
+var _QueueModule;
+let QueueModule = _QueueModule = class QueueModule {
+	/**
+	* Configure queue infrastructure with async factory.
+	*
+	* Use when provider configuration depends on other services like ConfigService.
+	*
+	* @param options - Async configuration with factory and inject tokens
+	* @returns Dynamic module with queue infrastructure
+	*
+	* @example
+	* ```typescript
+	* QueueModule.forRootAsync({
+	*   inject: [CONFIG_TOKENS.ConfigService],
+	*   useFactory: (config: IConfigService) => ({
+	*     provider: config.get('queue').provider
+	*   })
+	* })
+	* ```
+	*/
+	static forRootAsync(options) {
+		return {
+			module: _QueueModule,
+			providers: [{
+				provide: QUEUE_TOKENS.QueueModuleOptions,
+				useFactory: options.useFactory,
+				inject: options.inject
+			}]
+		};
+	}
+	/**
+	* Register a queue for injection.
+	*
+	* The queue name serves as both the identifier and the DI injection token.
+	* Queue names are typed via module augmentation of QueueNames interface.
+	*
+	* @param name - Queue name (typed with autocomplete if QueueNames is augmented)
+	* @returns Dynamic module that provides the queue sender
+	*
+	* @example
+	* ```typescript
+	* // In AppModule imports
+	* QueueModule.registerQueue('notifications-queue')
+	*
+	* // Then inject using the queue name
+	* constructor(@InjectQueue('notifications-queue') private queue: IQueueSender) {}
+	* ```
+	*/
+	static registerQueue(name) {
+		return {
+			module: _QueueModule,
+			providers: [{
+				provide: name,
+				useFactory: (registry) => registry.getQueue(name),
+				inject: [QUEUE_TOKENS.QueueRegistry]
+			}]
+		};
+	}
+};
+QueueModule = _QueueModule = __decorate([Module({ providers: [
+	{
+		provide: DI_TOKENS.ConsumerRegistry,
+		useClass: ConsumerRegistry,
+		scope: Scope.Singleton
+	},
+	{
+		provide: QUEUE_TOKENS.QueueProviderFactory,
+		useClass: QueueProviderFactory,
+		scope: Scope.Singleton
+	},
+	{
+		provide: QUEUE_TOKENS.QueueRegistry,
+		useClass: QueueRegistry
+	}
+] })], QueueModule);
+//#endregion
+export { CloudflareQueueProvider as a, QUEUE_TOKENS as c, SyncQueueProvider as i, QueueSender as l, QueueRegistry as n, QueueProviderNotSupportedError as o, QueueProviderFactory as r, QueueBindingNotFoundError as s, QueueModule as t, ConsumerRegistry as u };
+
+//# sourceMappingURL=queue.module-ZqaZ2iY0.mjs.map

package/dist/queue.module-ZqaZ2iY0.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.module-ZqaZ2iY0.mjs","names":[],"sources":["../src/queue/consumer-registry.ts","../src/queue/queue-sender.ts","../src/queue/queue.tokens.ts","../src/queue/errors/queue-binding-not-found.error.ts","../src/queue/errors/queue-provider-not-supported.error.ts","../src/queue/providers/cloudflare-queue.provider.ts","../src/queue/providers/sync-queue.provider.ts","../src/queue/services/queue-provider-factory.ts","../src/queue/queue-registry.ts","../src/queue/queue.module.ts"],"sourcesContent":["import { Transient } from '../di/decorators'\nimport { DI_TOKENS } from '../di/tokens'\nimport type { IQueueConsumer } from './queue-consumer'\n\n/**\n * Consumer Registry\n *\n * Singleton service that holds all registered queue consumers indexed by message type.\n * Consumers declare the message types they handle, and this registry routes messages\n * to the appropriate consumers based on their types.\n *\n * **Message-Type Routing:**\n * - Consumers declare `messageTypes` array (e.g., `['email.send', 'email.batch.send']`)\n * - When a message arrives, consumers matching the message type are invoked\n * - A consumer can handle messages from ANY queue (routing is by type, not queue)\n * - Use `'*'` as a wildcard to handle all message types\n *\n * @example Consumer registration\n * ```typescript\n * // In consumer.ts\n * @Transient()\n * export class EmailConsumer implements IQueueConsumer {\n *   readonly messageTypes = ['email.send', 'email.batch.send']\n *   // ...\n * }\n *\n * // In module.ts\n * @Module({\n *   consumers: [EmailConsumer]\n * })\n *\n * // Application auto-registers via ConsumerRegistry\n * this.consumerRegistry.register(consumer)\n * ```\n */\n@Transient(DI_TOKENS.ConsumerRegistry)\nexport class ConsumerRegistry {\n  /** Map from message type to consumers handling that type */\n  private consumersByType = new Map<string, IQueueConsumer[]>()\n\n  /** Set of all registered consumers (for iteration) */\n  private allConsumers = new Set<IQueueConsumer>()\n\n  /**\n   * Register a queue consumer\n   *\n   * Indexes the consumer by each of its declared message types.\n   *\n   * @param consumer - Queue consumer to register\n   */\n  register(consumer: IQueueConsumer): void {\n    if (this.allConsumers.has(consumer)) {\n      return // Already registered\n    }\n\n    this.allConsumers.add(consumer)\n\n    for (const messageType of consumer.messageTypes) {\n      const existing = this.consumersByType.get(messageType) ?? []\n      existing.push(consumer)\n      this.consumersByType.set(messageType, existing)\n    }\n  }\n\n  /**\n   * Get all consumers that can handle a specific message type\n   *\n   * Returns consumers that either:\n   * - Explicitly declare the message type\n   * - Use '*' wildcard to handle all types\n   *\n   * @param messageType - The message type to find consumers for\n   * @returns Array of consumers that can handle this message type\n   */\n  getConsumers(messageType: string): IQueueConsumer[] {\n    const exactMatch = this.consumersByType.get(messageType) ?? []\n    const wildcardMatch = this.consumersByType.get('*') ?? []\n\n    // Combine and dedupe\n    const combined = new Set([...exactMatch, ...wildcardMatch])\n    return Array.from(combined)\n  }\n\n  /**\n   * Check if any consumers can handle a message type\n   *\n   * @param messageType - The message type to check\n   * @returns true if at least one consumer can handle this type\n   */\n  hasConsumers(messageType: string): boolean {\n    return this.getConsumers(messageType).length > 0\n  }\n\n  /**\n   * Get all registered message types\n   *\n   * @returns Array of message types with registered consumers\n   */\n  getMessageTypes(): string[] {\n    return Array.from(this.consumersByType.keys())\n  }\n\n  /**\n   * Get all registered consumers\n   *\n   * @returns Array of all registered consumers\n   */\n  getAllConsumers(): IQueueConsumer[] {\n    return Array.from(this.allConsumers)\n  }\n}\n","import type { II18nService } from '../i18n/i18n.types'\nimport type { IQueueProvider } from './providers'\nimport type { QueueMessage } from './queue-consumer'\nimport type { DispatchMessage, IQueueSender } from './queue-sender.interface'\n\n/**\n * Queue Sender\n *\n * Implementation of IQueueSender bound to a specific queue name.\n * Created by QueueRegistry for each registered queue.\n *\n * Automatically enriches messages with:\n * - `id`: UUID generated via crypto.randomUUID()\n * - `timestamp`: Current time in milliseconds\n * - `metadata.locale`: Current locale from I18n context\n *\n * @example\n * ```typescript\n * // Created by QueueRegistry, not directly instantiated\n * const sender = registry.getQueue('notifications-queue')\n *\n * await sender.dispatch({\n *   type: 'email.send',\n *   payload: { to: 'user@example.com', subject: 'Hello' }\n * })\n * ```\n */\nexport class QueueSender implements IQueueSender {\n  constructor(\n    private readonly queueName: string,\n    private readonly provider: IQueueProvider,\n    private readonly i18n: II18nService\n  ) {}\n\n  /**\n   * Dispatch a message to this queue.\n   *\n   * @param message - Message to dispatch (without id/timestamp)\n   */\n  async dispatch<T>(message: DispatchMessage<T>): Promise<void> {\n    const metadata = { ...message.metadata }\n\n    if (!metadata.locale) {\n      const locale = this.i18n.getLocale()\n      if (locale) {\n        metadata.locale = locale\n      }\n    }\n\n    const fullMessage: QueueMessage<T> = {\n      id: crypto.randomUUID(),\n      timestamp: Date.now(),\n      ...message,\n      metadata: Object.keys(metadata).length > 0 ? metadata : undefined\n    }\n\n    await this.provider.send(this.queueName, fullMessage)\n  }\n}\n","export const QUEUE_TOKENS = {\n  QueueProviderFactory: Symbol.for('stratal:queue:provider:factory'),\n  QueueRegistry: Symbol.for('stratal:queue:registry'),\n  QueueModuleOptions: Symbol.for('stratal:queue:options'),\n} as const\n\nexport type QueueToken = (typeof QUEUE_TOKENS)[keyof typeof QUEUE_TOKENS]\n","import { ApplicationError, ERROR_CODES } from '../../errors'\n\n/**\n * QueueBindingNotFoundError\n *\n * Thrown when attempting to access a Cloudflare Queue binding that hasn't been configured.\n * This typically indicates that the queue binding is missing from wrangler.jsonc\n * or the environment variables are not properly set.\n */\nexport class QueueBindingNotFoundError extends ApplicationError {\n  constructor(queueName: string, bindingName: string) {\n    super(\n      'errors.queueBindingNotFound',\n      ERROR_CODES.SYSTEM.QUEUE_BINDING_NOT_FOUND,\n      { queueName, bindingName }\n    )\n  }\n}\n","import { ApplicationError, ERROR_CODES } from '../../errors'\n\n/**\n * QueueProviderNotSupportedError\n *\n * Thrown when attempting to use a queue provider that is not supported.\n * Valid providers are: 'cloudflare', 'sync'\n *\n * This typically indicates an invalid QUEUE_PROVIDER environment variable.\n */\nexport class QueueProviderNotSupportedError extends ApplicationError {\n  constructor(provider: string) {\n    super(\n      'errors.queueProviderNotSupported',\n      ERROR_CODES.SYSTEM.QUEUE_PROVIDER_NOT_SUPPORTED,\n      { provider }\n    )\n  }\n}\n","import { inject } from 'tsyringe'\nimport { type StratalEnv } from '../../env'\nimport { Transient } from '../../di/decorators'\nimport { DI_TOKENS } from '../../di/tokens'\nimport { QueueBindingNotFoundError } from '../errors'\nimport type { QueueMessage } from '../queue-consumer'\nimport type { IQueueProvider } from './queue-provider.interface'\n\n/**\n * Cloudflare Queue Provider\n *\n * Sends messages to Cloudflare Queues by resolving bindings from the environment.\n * Used in production environments where Cloudflare Workers handle queue processing.\n *\n * **Binding Resolution:**\n * Queue names are converted to binding names:\n * - `notifications-queue` → `NOTIFICATIONS_QUEUE`\n *\n * @example\n * ```typescript\n * const provider = new CloudflareQueueProvider(env)\n * await provider.send('notifications-queue', message)\n * ```\n */\n@Transient()\nexport class CloudflareQueueProvider implements IQueueProvider {\n  constructor(\n    @inject(DI_TOKENS.CloudflareEnv) private readonly env: StratalEnv\n  ) { }\n\n  /**\n   * Send a message to a Cloudflare Queue\n   *\n   * @param queueName - Queue name (e.g., 'notifications-queue')\n   * @param message - Complete message with id, timestamp, and payload\n   * @throws {QueueBindingNotFoundError} If queue binding is not configured\n   */\n  async send<T>(queueName: string, message: QueueMessage<T>): Promise<void> {\n    const queue = this.getQueue(queueName)\n    await queue.send(message)\n  }\n\n  /**\n   * Resolve queue binding from Cloudflare environment\n   *\n   * Converts kebab-case queue name to UPPER_SNAKE_CASE binding name.\n   *\n   * @param queueName - Queue name (e.g., 'notifications-queue')\n   * @returns Cloudflare Queue binding\n   * @throws {QueueBindingNotFoundError} If binding not found in env\n   */\n  private getQueue(queueName: string): Queue {\n    const bindingName = queueName.toUpperCase().replace(/-/g, '_')\n    const queue = (this.env as unknown as Record<string, unknown>)[bindingName] as Queue | undefined\n\n    if (!queue) {\n      throw new QueueBindingNotFoundError(queueName, bindingName)\n    }\n\n    return queue\n  }\n}\n","import { inject } from 'tsyringe'\nimport { Transient } from '../../di/decorators'\nimport { DI_TOKENS } from '../../di/tokens'\nimport { ConsumerRegistry } from '../consumer-registry'\nimport type { QueueMessage } from '../queue-consumer'\nimport type { IQueueProvider } from './queue-provider.interface'\n\n/**\n * Sync Queue Provider\n *\n * Processes messages immediately by finding matching consumers and calling\n * their handle() method directly. Used for testing and development where\n * real queue infrastructure is not available.\n *\n * **Behavior:**\n * - Messages are processed synchronously when send() is called\n * - Matching consumers are found via ConsumerRegistry by message type\n * - All matching consumers are called sequentially\n * - Errors are re-thrown after onError() is called (fail-fast for testing)\n *\n * **Consumer Matching:**\n * - Consumers are matched by message type, not queue name\n * - Wildcard ('*') matches all message types\n *\n * @example Testing with sync provider\n * ```typescript\n * const provider = new SyncQueueProvider(registry)\n * await provider.send('notifications-queue', {\n *   id: '123',\n *   timestamp: Date.now(),\n *   type: 'email.send',\n *   payload: { to: 'test@example.com' }\n * })\n * // Consumer's handle() is called immediately!\n * ```\n */\n@Transient()\nexport class SyncQueueProvider implements IQueueProvider {\n  constructor(\n    @inject(DI_TOKENS.ConsumerRegistry) private readonly registry: ConsumerRegistry\n  ) {}\n\n  /**\n   * Process a message synchronously\n   *\n   * Finds all matching consumers by message type and calls their handle() method.\n   * If any consumer throws, onError() is called and the error is re-thrown.\n   *\n   * @param _queueName - Queue name (not used for routing, consumers match by message type)\n   * @param message - Complete message with id, timestamp, and payload\n   * @throws Re-throws any error from consumer.handle() after calling onError()\n   */\n  async send<T>(_queueName: string, message: QueueMessage<T>): Promise<void> {\n    // Consumers are matched by message type, not queue name\n    const consumers = this.registry.getConsumers(message.type)\n\n    // Process synchronously - call each matching consumer\n    for (const consumer of consumers) {\n      try {\n        await consumer.handle(message)\n      } catch (error) {\n        const errorInstance = error instanceof Error\n          ? error\n          : new Error(String(error))\n\n        // Call onError hook if defined\n        if (consumer.onError) {\n          await consumer.onError(errorInstance, message)\n        }\n\n        // Re-throw for fail-fast behavior in tests\n        throw errorInstance\n      }\n    }\n  }\n}\n","import { inject } from 'tsyringe'\nimport { type StratalEnv } from '../../env'\nimport { Transient } from '../../di/decorators'\nimport { DI_TOKENS } from '../../di/tokens'\nimport { ConsumerRegistry } from '../consumer-registry'\nimport { QueueProviderNotSupportedError } from '../errors'\nimport { CloudflareQueueProvider, SyncQueueProvider, type IQueueProvider } from '../providers'\nimport type { QueueModuleOptions } from '../queue.module'\nimport { QUEUE_TOKENS } from '../queue.tokens'\n\n/**\n * Queue Provider Factory\n *\n * Creates the appropriate queue provider based on configuration provided\n * via QueueModule.forRootAsync().\n *\n * **Provider Selection:**\n * - `cloudflare`: Production provider using Cloudflare Queue bindings\n * - `sync`: Testing provider that processes messages immediately\n *\n * @example\n * ```typescript\n * // Configuration via QueueModule.forRootAsync()\n * QueueModule.forRootAsync({\n *   inject: [CONFIG_TOKENS.ConfigService],\n *   useFactory: (config) => ({ provider: config.get('queue').provider })\n * })\n *\n * // Factory usage (internal)\n * const factory = container.resolve(QueueProviderFactory)\n * const provider = factory.create()\n * ```\n */\n@Transient(QUEUE_TOKENS.QueueProviderFactory)\nexport class QueueProviderFactory {\n  constructor(\n    @inject(DI_TOKENS.CloudflareEnv) private readonly env: StratalEnv,\n    @inject(DI_TOKENS.ConsumerRegistry) private readonly registry: ConsumerRegistry,\n    @inject(QUEUE_TOKENS.QueueModuleOptions, { isOptional: true }) private readonly options?: QueueModuleOptions,\n  ) { }\n\n  /**\n   * Create a queue provider based on module configuration\n   *\n   * @returns Queue provider instance\n   * @throws {QueueProviderNotSupportedError} If provider type is not supported\n   */\n  create(): IQueueProvider {\n    const providerType = this.options?.provider ?? 'cloudflare'\n\n    switch (providerType) {\n      case 'cloudflare':\n        return new CloudflareQueueProvider(this.env)\n\n      case 'sync':\n        return new SyncQueueProvider(this.registry)\n\n      default:\n        throw new QueueProviderNotSupportedError(providerType)\n    }\n  }\n}\n","import { inject } from 'tsyringe'\nimport { Transient } from '../di/decorators'\nimport { I18N_TOKENS } from '../i18n/i18n.tokens'\nimport type { II18nService } from '../i18n/i18n.types'\nimport type { IQueueProvider } from './providers'\nimport type { IQueueSender } from './queue-sender.interface'\nimport { QueueSender } from './queue-sender'\nimport { QUEUE_TOKENS } from './queue.tokens'\nimport { QueueProviderFactory } from './services'\n\n/**\n * Queue Registry\n *\n * Request-scoped factory service for creating QueueSender instances.\n * Caches senders per queue name within the request scope.\n *\n * This service is used internally by QueueModule.registerQueue() to provide\n * IQueueSender instances for each registered queue.\n *\n * **Why request-scoped?**\n * - Needs access to I18nService for locale-aware message metadata\n * - Provider is created once per request for consistency\n * - Queue senders are cached per request to avoid recreating them\n *\n * @example\n * ```typescript\n * // Used internally by QueueModule.registerQueue()\n * QueueModule.registerQueue('notifications-queue')\n *\n * // The module creates a factory provider:\n * {\n *   provide: 'notifications-queue',\n *   useFactory: (registry: QueueRegistry) => registry.getQueue('notifications-queue'),\n *   inject: [QUEUE_TOKENS.QueueRegistry],\n * }\n * ```\n */\n@Transient(QUEUE_TOKENS.QueueRegistry)\nexport class QueueRegistry {\n  private readonly provider: IQueueProvider\n  private readonly senders = new Map<string, IQueueSender>()\n\n  constructor(\n    @inject(QUEUE_TOKENS.QueueProviderFactory) providerFactory: QueueProviderFactory,\n    @inject(I18N_TOKENS.I18nService) private readonly i18n: II18nService\n  ) {\n    this.provider = providerFactory.create()\n  }\n\n  /**\n   * Get or create a QueueSender for the specified queue name.\n   *\n   * Senders are cached per queue name within the request scope.\n   *\n   * @param queueName - The queue name to get a sender for\n   * @returns QueueSender bound to the specified queue\n   */\n  getQueue(queueName: string): IQueueSender {\n    let sender = this.senders.get(queueName)\n\n    if (!sender) {\n      sender = new QueueSender(queueName, this.provider, this.i18n)\n      this.senders.set(queueName, sender)\n    }\n\n    return sender\n  }\n}\n","/**\n * Queue Module\n *\n * Provides declarative queue infrastructure with provider abstraction.\n *\n * **Usage:**\n * ```typescript\n * // 1. Configure provider (once, in app root)\n * QueueModule.forRootAsync({\n *   inject: [CONFIG_TOKENS.ConfigService],\n *   useFactory: (config) => ({ provider: config.get('queue').provider })\n * })\n *\n * // 2. Register queues (queue name IS the injection token)\n * QueueModule.registerQueue('notifications-queue')\n * QueueModule.registerQueue('batch-notifications-queue')\n *\n * // 3. Inject and use\n * constructor(@InjectQueue('notifications-queue') private queue: IQueueSender) {}\n * await this.queue.dispatch({ type: 'email.send', payload: {...} })\n * ```\n *\n * **Providers:**\n * - `cloudflare`: Production provider using Cloudflare Queue bindings\n * - `sync`: Testing provider that processes messages immediately\n */\n\nimport { DI_TOKENS } from '../di/tokens'\nimport { Scope } from '../di/types'\nimport { Module } from '../module'\nimport type { AsyncModuleOptions, DynamicModule, InjectionToken } from '../module/types'\nimport { ConsumerRegistry } from './consumer-registry'\nimport type { QueueName } from './queue-name'\nimport { QueueRegistry } from './queue-registry'\nimport type { IQueueSender } from './queue-sender.interface'\nimport { QUEUE_TOKENS } from './queue.tokens'\nimport { QueueProviderFactory } from './services'\n\n/**\n * Queue module configuration options\n */\nexport interface QueueModuleOptions {\n  /**\n   * Queue provider type\n   * - 'cloudflare': Production provider using Cloudflare Queue bindings\n   * - 'sync': Testing provider that processes messages immediately\n   */\n  provider: 'cloudflare' | 'sync'\n}\n\n@Module({\n  providers: [\n    { provide: DI_TOKENS.ConsumerRegistry, useClass: ConsumerRegistry, scope: Scope.Singleton },\n    { provide: QUEUE_TOKENS.QueueProviderFactory, useClass: QueueProviderFactory, scope: Scope.Singleton },\n    { provide: QUEUE_TOKENS.QueueRegistry, useClass: QueueRegistry },\n  ],\n})\nexport class QueueModule {\n  /**\n   * Configure queue infrastructure with async factory.\n   *\n   * Use when provider configuration depends on other services like ConfigService.\n   *\n   * @param options - Async configuration with factory and inject tokens\n   * @returns Dynamic module with queue infrastructure\n   *\n   * @example\n   * ```typescript\n   * QueueModule.forRootAsync({\n   *   inject: [CONFIG_TOKENS.ConfigService],\n   *   useFactory: (config: IConfigService) => ({\n   *     provider: config.get('queue').provider\n   *   })\n   * })\n   * ```\n   */\n  static forRootAsync(options: AsyncModuleOptions<QueueModuleOptions>): DynamicModule {\n    return {\n      module: QueueModule,\n      providers: [\n        {\n          provide: QUEUE_TOKENS.QueueModuleOptions,\n          useFactory: options.useFactory,\n          inject: options.inject,\n        },\n      ],\n    }\n  }\n\n  /**\n   * Register a queue for injection.\n   *\n   * The queue name serves as both the identifier and the DI injection token.\n   * Queue names are typed via module augmentation of QueueNames interface.\n   *\n   * @param name - Queue name (typed with autocomplete if QueueNames is augmented)\n   * @returns Dynamic module that provides the queue sender\n   *\n   * @example\n   * ```typescript\n   * // In AppModule imports\n   * QueueModule.registerQueue('notifications-queue')\n   *\n   * // Then inject using the queue name\n   * constructor(@InjectQueue('notifications-queue') private queue: IQueueSender) {}\n   * ```\n   */\n  static registerQueue(name: QueueName): DynamicModule {\n    return {\n      module: QueueModule,\n      providers: [\n        {\n          provide: name as InjectionToken<IQueueSender>,\n          useFactory: (registry: QueueRegistry) => registry.getQueue(name),\n          inject: [QUEUE_TOKENS.QueueRegistry],\n        },\n      ],\n    }\n  }\n}\n"],"mappings":";;;;;AAoCO,IAAA,mBAAA,MAAM,iBAAiB;;CAE5B,kCAA0B,IAAI,KAA+B;;CAG7D,+BAAuB,IAAI,KAAqB;;;;;;;;CAShD,SAAS,UAAgC;AACvC,MAAI,KAAK,aAAa,IAAI,SAAS,CACjC;AAGF,OAAK,aAAa,IAAI,SAAS;AAE/B,OAAK,MAAM,eAAe,SAAS,cAAc;GAC/C,MAAM,WAAW,KAAK,gBAAgB,IAAI,YAAY,IAAI,EAAE;AAC5D,YAAS,KAAK,SAAS;AACvB,QAAK,gBAAgB,IAAI,aAAa,SAAS;;;;;;;;;;;;;CAcnD,aAAa,aAAuC;EAClD,MAAM,aAAa,KAAK,gBAAgB,IAAI,YAAY,IAAI,EAAE;EAC9D,MAAM,gBAAgB,KAAK,gBAAgB,IAAI,IAAI,IAAI,EAAE;EAGzD,MAAM,WAAW,IAAI,IAAI,CAAC,GAAG,YAAY,GAAG,cAAc,CAAC;AAC3D,SAAO,MAAM,KAAK,SAAS;;;;;;;;CAS7B,aAAa,aAA8B;AACzC,SAAO,KAAK,aAAa,YAAY,CAAC,SAAS;;;;;;;CAQjD,kBAA4B;AAC1B,SAAO,MAAM,KAAK,KAAK,gBAAgB,MAAM,CAAC;;;;;;;CAQhD,kBAAoC;AAClC,SAAO,MAAM,KAAK,KAAK,aAAa;;;+BAzEvC,UAAU,UAAU,iBAAiB,CAAA,EAAA,iBAAA;;;;;;;;;;;;;;;;;;;;;;;;;ACRtC,IAAa,cAAb,MAAiD;CAC/C,YACE,WACA,UACA,MACA;AAHiB,OAAA,YAAA;AACA,OAAA,WAAA;AACA,OAAA,OAAA;;;;;;;CAQnB,MAAM,SAAY,SAA4C;EAC5D,MAAM,WAAW,EAAE,GAAG,QAAQ,UAAU;AAExC,MAAI,CAAC,SAAS,QAAQ;GACpB,MAAM,SAAS,KAAK,KAAK,WAAW;AACpC,OAAI,OACF,UAAS,SAAS;;EAItB,MAAM,cAA+B;GACnC,IAAI,OAAO,YAAY;GACvB,WAAW,KAAK,KAAK;GACrB,GAAG;GACH,UAAU,OAAO,KAAK,SAAS,CAAC,SAAS,IAAI,WAAW,KAAA;GACzD;AAED,QAAM,KAAK,SAAS,KAAK,KAAK,WAAW,YAAY;;;;;ACxDzD,MAAa,eAAe;CAC1B,sBAAsB,OAAO,IAAI,iCAAiC;CAClE,eAAe,OAAO,IAAI,yBAAyB;CACnD,oBAAoB,OAAO,IAAI,wBAAwB;CACxD;;;;;;;;;;ACKD,IAAa,4BAAb,cAA+C,iBAAiB;CAC9D,YAAY,WAAmB,aAAqB;AAClD,QACE,+BACA,YAAY,OAAO,yBACnB;GAAE;GAAW;GAAa,CAC3B;;;;;;;;;;;;;ACLL,IAAa,iCAAb,cAAoD,iBAAiB;CACnE,YAAY,UAAkB;AAC5B,QACE,oCACA,YAAY,OAAO,8BACnB,EAAE,UAAU,CACb;;;;;ACSE,IAAA,0BAAA,MAAM,wBAAkD;CAC7D,YACE,KACA;AADkD,OAAA,MAAA;;;;;;;;;CAUpD,MAAM,KAAQ,WAAmB,SAAyC;AAExE,QADc,KAAK,SAAS,UAAU,CAC1B,KAAK,QAAQ;;;;;;;;;;;CAY3B,SAAiB,WAA0B;EACzC,MAAM,cAAc,UAAU,aAAa,CAAC,QAAQ,MAAM,IAAI;EAC9D,MAAM,QAAS,KAAK,IAA2C;AAE/D,MAAI,CAAC,MACH,OAAM,IAAI,0BAA0B,WAAW,YAAY;AAG7D,SAAO;;;;CAnCV,WAAW;oBAGP,OAAO,UAAU,cAAc,CAAA;;;;;;ACU7B,IAAA,oBAAA,MAAM,kBAA4C;CACvD,YACE,UACA;AADqD,OAAA,WAAA;;;;;;;;;;;;CAavD,MAAM,KAAQ,YAAoB,SAAyC;EAEzE,MAAM,YAAY,KAAK,SAAS,aAAa,QAAQ,KAAK;AAG1D,OAAK,MAAM,YAAY,UACrB,KAAI;AACF,SAAM,SAAS,OAAO,QAAQ;WACvB,OAAO;GACd,MAAM,gBAAgB,iBAAiB,QACnC,QACA,IAAI,MAAM,OAAO,MAAM,CAAC;AAG5B,OAAI,SAAS,QACX,OAAM,SAAS,QAAQ,eAAe,QAAQ;AAIhD,SAAM;;;;;CAnCb,WAAW;oBAGP,OAAO,UAAU,iBAAiB,CAAA;;;;;;ACLhC,IAAA,uBAAA,MAAM,qBAAqB;CAChC,YACE,KACA,UACA,SACA;AAHkD,OAAA,MAAA;AACG,OAAA,WAAA;AAC2B,OAAA,UAAA;;;;;;;;CASlF,SAAyB;EACvB,MAAM,eAAe,KAAK,SAAS,YAAY;AAE/C,UAAQ,cAAR;GACE,KAAK,aACH,QAAO,IAAI,wBAAwB,KAAK,IAAI;GAE9C,KAAK,OACH,QAAO,IAAI,kBAAkB,KAAK,SAAS;GAE7C,QACE,OAAM,IAAI,+BAA+B,aAAa;;;;;CAzB7D,UAAU,aAAa,qBAAqB;oBAGxC,OAAO,UAAU,cAAc,CAAA;oBAC/B,OAAO,UAAU,iBAAiB,CAAA;oBAClC,OAAO,aAAa,oBAAoB,EAAE,YAAY,MAAM,CAAC,CAAA;;;;;;;;;;ACA3D,IAAA,gBAAA,MAAM,cAAc;CACzB;CACA,0BAA2B,IAAI,KAA2B;CAE1D,YACE,iBACA,MACA;AADkD,OAAA,OAAA;AAElD,OAAK,WAAW,gBAAgB,QAAQ;;;;;;;;;;CAW1C,SAAS,WAAiC;EACxC,IAAI,SAAS,KAAK,QAAQ,IAAI,UAAU;AAExC,MAAI,CAAC,QAAQ;AACX,YAAS,IAAI,YAAY,WAAW,KAAK,UAAU,KAAK,KAAK;AAC7D,QAAK,QAAQ,IAAI,WAAW,OAAO;;AAGrC,SAAO;;;;CA5BV,UAAU,aAAa,cAAc;oBAMjC,OAAO,aAAa,qBAAqB,CAAA;oBACzC,OAAO,YAAY,YAAY,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACa7B,IAAA,cAAA,eAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;CAmBvB,OAAO,aAAa,SAAgE;AAClF,SAAO;GACL,QAAA;GACA,WAAW,CACT;IACE,SAAS,aAAa;IACtB,YAAY,QAAQ;IACpB,QAAQ,QAAQ;IACjB,CACF;GACF;;;;;;;;;;;;;;;;;;;;CAqBH,OAAO,cAAc,MAAgC;AACnD,SAAO;GACL,QAAA;GACA,WAAW,CACT;IACE,SAAS;IACT,aAAa,aAA4B,SAAS,SAAS,KAAK;IAChE,QAAQ,CAAC,aAAa,cAAc;IACrC,CACF;GACF;;;yCAnEJ,OAAO,EACN,WAAW;CACT;EAAE,SAAS,UAAU;EAAkB,UAAU;EAAkB,OAAO,MAAM;EAAW;CAC3F;EAAE,SAAS,aAAa;EAAsB,UAAU;EAAsB,OAAO,MAAM;EAAW;CACtG;EAAE,SAAS,aAAa;EAAe,UAAU;EAAe;CACjE,EACF,CAAC,CAAA,EAAA,YAAA"}

package/dist/resend.provider-BFGt6fS4.mjs

@@ -0,0 +1,69 @@
+import "./errors-BRJgVd5-.mjs";
+import "./logger-Bg-CuidS.mjs";
+import { EmailResendApiFailedError, ResendApiKeyMissingError } from "./email/index.mjs";
+import { t as BaseEmailProvider } from "./base-email.provider-bzdAYp8Z.mjs";
+import { Resend } from "resend";
+//#region src/email/providers/resend.provider.ts
+/**
+* Resend Email Provider
+*
+* Implementation of IEmailProvider using Resend API
+* Docs: https://resend.com/docs
+*/
+var ResendProvider = class extends BaseEmailProvider {
+	client;
+	defaultFrom;
+	constructor(options) {
+		super();
+		this.options = options;
+		if (!this.options.apiKey) throw new ResendApiKeyMissingError();
+		this.client = new Resend(this.options.apiKey);
+		this.defaultFrom = this.options.from;
+	}
+	async send(message) {
+		try {
+			const from = message.from ? `${message.from.name} <${message.from.email}>` : `${this.defaultFrom.name} <${this.defaultFrom.email}>`;
+			const to = Array.isArray(message.to) ? message.to : [message.to];
+			const response = await this.client.emails.send({
+				from,
+				to,
+				subject: message.subject,
+				html: message.html,
+				text: message.text,
+				...message.template && { template: message.template },
+				...message.replyTo && { replyTo: message.replyTo },
+				...message.cc && { cc: message.cc },
+				...message.bcc && { bcc: message.bcc },
+				...message.attachments && { attachments: await Promise.all(message.attachments.map(async (attachment) => ({
+					filename: attachment.filename,
+					content: await this.toBuffer(attachment.content)
+				}))) }
+			});
+			if (response.error) throw new EmailResendApiFailedError();
+			return {
+				messageId: response.data.id,
+				accepted: true,
+				metadata: { provider: "resend" }
+			};
+		} catch (error) {
+			if (error instanceof EmailResendApiFailedError || error instanceof ResendApiKeyMissingError) throw error;
+			throw new EmailResendApiFailedError();
+		}
+	}
+	/**
+	* Convert attachment content to Buffer
+	*
+	* Resend SDK expects Buffer for attachment content.
+	* If content is already a Buffer, return as-is.
+	* If content is a ReadableStream, convert to Buffer.
+	*/
+	async toBuffer(content) {
+		if (Buffer.isBuffer(content)) return content;
+		const arrayBuffer = await new Response(content).arrayBuffer();
+		return Buffer.from(arrayBuffer);
+	}
+};
+//#endregion
+export { ResendProvider };
+
+//# sourceMappingURL=resend.provider-BFGt6fS4.mjs.map

package/dist/resend.provider-BFGt6fS4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resend.provider-BFGt6fS4.mjs","names":[],"sources":["../src/email/providers/resend.provider.ts"],"sourcesContent":["import { Resend } from 'resend'\nimport type { ResolvedEmailAttachment, ResolvedEmailMessage } from '../contracts'\nimport type { EmailModuleOptions } from '../email.module'\nimport { EmailResendApiFailedError, ResendApiKeyMissingError } from '../errors'\nimport { BaseEmailProvider } from './base-email.provider'\nimport type { EmailSendResult } from './email-provider.interface'\n\n/**\n * Resend Email Provider\n *\n * Implementation of IEmailProvider using Resend API\n * Docs: https://resend.com/docs\n */\nexport class ResendProvider extends BaseEmailProvider {\n  private readonly client: Resend\n  private readonly defaultFrom: { name: string; email: string }\n\n  constructor(\n    private readonly options: EmailModuleOptions\n  ) {\n    super()\n\n    // Validate Resend API key\n    if (!this.options.apiKey) {\n      throw new ResendApiKeyMissingError()\n    }\n\n    this.client = new Resend(this.options.apiKey)\n    this.defaultFrom = this.options.from\n  }\n\n  async send(message: ResolvedEmailMessage): Promise<EmailSendResult> {\n    try {\n      const from = message.from\n        ? `${message.from.name} <${message.from.email}>`\n        : `${this.defaultFrom.name} <${this.defaultFrom.email}>`\n\n      const to = Array.isArray(message.to) ? message.to : [message.to]\n\n      // eslint-disable-next-line @typescript-eslint/no-unsafe-argument -- Resend SDK types\n      const response = await this.client.emails.send({\n        from,\n        to,\n        subject: message.subject,\n        html: message.html,\n        text: message.text,\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment -- Resend template extension\n        ...((message as any).template && { template: (message as any).template }),\n        ...(message.replyTo && { replyTo: message.replyTo }),\n        ...(message.cc && { cc: message.cc }),\n        ...(message.bcc && { bcc: message.bcc }),\n        ...(message.attachments && {\n          attachments: await Promise.all(\n            message.attachments.map(async attachment => ({\n              filename: attachment.filename,\n              content: await this.toBuffer(attachment.content),\n            }))\n          ),\n        }),\n      })\n\n      if (response.error) {\n        throw new EmailResendApiFailedError()\n      }\n\n      return {\n        messageId: response.data.id,\n        accepted: true,\n        metadata: {\n          provider: 'resend',\n        },\n      }\n    } catch (error) {\n      if (error instanceof EmailResendApiFailedError || error instanceof ResendApiKeyMissingError) {\n        throw error\n      }\n\n      throw new EmailResendApiFailedError()\n    }\n  }\n\n  /**\n   * Convert attachment content to Buffer\n   *\n   * Resend SDK expects Buffer for attachment content.\n   * If content is already a Buffer, return as-is.\n   * If content is a ReadableStream, convert to Buffer.\n   */\n  private async toBuffer(content: ResolvedEmailAttachment['content']): Promise<Buffer> {\n    if (Buffer.isBuffer(content)) {\n      return content\n    }\n    // Convert ReadableStream to Buffer\n    const response = new Response(content)\n    const arrayBuffer = await response.arrayBuffer()\n    return Buffer.from(arrayBuffer)\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAaA,IAAa,iBAAb,cAAoC,kBAAkB;CACpD;CACA;CAEA,YACE,SACA;AACA,SAAO;AAFU,OAAA,UAAA;AAKjB,MAAI,CAAC,KAAK,QAAQ,OAChB,OAAM,IAAI,0BAA0B;AAGtC,OAAK,SAAS,IAAI,OAAO,KAAK,QAAQ,OAAO;AAC7C,OAAK,cAAc,KAAK,QAAQ;;CAGlC,MAAM,KAAK,SAAyD;AAClE,MAAI;GACF,MAAM,OAAO,QAAQ,OACjB,GAAG,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,MAAM,KAC5C,GAAG,KAAK,YAAY,KAAK,IAAI,KAAK,YAAY,MAAM;GAExD,MAAM,KAAK,MAAM,QAAQ,QAAQ,GAAG,GAAG,QAAQ,KAAK,CAAC,QAAQ,GAAG;GAGhE,MAAM,WAAW,MAAM,KAAK,OAAO,OAAO,KAAK;IAC7C;IACA;IACA,SAAS,QAAQ;IACjB,MAAM,QAAQ;IACd,MAAM,QAAQ;IAEd,GAAK,QAAgB,YAAY,EAAE,UAAW,QAAgB,UAAU;IACxE,GAAI,QAAQ,WAAW,EAAE,SAAS,QAAQ,SAAS;IACnD,GAAI,QAAQ,MAAM,EAAE,IAAI,QAAQ,IAAI;IACpC,GAAI,QAAQ,OAAO,EAAE,KAAK,QAAQ,KAAK;IACvC,GAAI,QAAQ,eAAe,EACzB,aAAa,MAAM,QAAQ,IACzB,QAAQ,YAAY,IAAI,OAAM,gBAAe;KAC3C,UAAU,WAAW;KACrB,SAAS,MAAM,KAAK,SAAS,WAAW,QAAQ;KACjD,EAAE,CACJ,EACF;IACF,CAAC;AAEF,OAAI,SAAS,MACX,OAAM,IAAI,2BAA2B;AAGvC,UAAO;IACL,WAAW,SAAS,KAAK;IACzB,UAAU;IACV,UAAU,EACR,UAAU,UACX;IACF;WACM,OAAO;AACd,OAAI,iBAAiB,6BAA6B,iBAAiB,yBACjE,OAAM;AAGR,SAAM,IAAI,2BAA2B;;;;;;;;;;CAWzC,MAAc,SAAS,SAA8D;AACnF,MAAI,OAAO,SAAS,QAAQ,CAC1B,QAAO;EAIT,MAAM,cAAc,MADH,IAAI,SAAS,QAAQ,CACH,aAAa;AAChD,SAAO,OAAO,KAAK,YAAY"}

package/dist/router/index.d.mts

@@ -0,0 +1,2 @@
+import { A as Delete, At as RouteConfig, B as getControllerVersion, Bt as SECURITY_SCHEMES, C as successMessageSchema, Ct as IController, D as getDecoratedMethods, Dt as HttpRouteMetadata, E as Route, Et as ControllerOptions, F as getHttpDecoratedMethods, Ft as SecurityScheme, H as RouteRegistrationService, I as getHttpRouteMetadata, It as VersioningOptions, L as Controller, Lt as HTTP_METHODS, M as Patch, Mt as RouteResponseObject, N as Post, Nt as RouterEnv, O as getRouteConfig, Ot as RouteBody, P as Put, Pt as RouterVariables, R as getControllerOptions, Rt as ROUTER_CONTEXT_KEYS, S as paginationQuerySchema, St as Middleware, T as validationErrorResponseSchema, Tt as RouterContext, U as HonoApp, V as ROUTER_TOKENS, Vt as VERSION_NEUTRAL, _ as ControllerRegistrationError, b as errorResponseSchema, d as SSEMessage, f as SSEStreamingApi, g as OpenAPIRouteRegistrationError, h as OpenAPIValidationError, j as Get, jt as RouteResponse, k as All, kt as RouteBodyObject, m as RouteNotFoundError, p as StreamingApi, v as HonoAppAlreadyConfiguredError, w as uuidParamSchema, x as paginatedResponseSchema, y as commonErrorSchemas, z as getControllerRoute, zt as ROUTE_METADATA_KEYS } from "../index-C9bIk5tt.mjs";
+export { All, Controller, ControllerOptions, ControllerRegistrationError, Delete, Get, HTTP_METHODS, HonoApp, HonoAppAlreadyConfiguredError, HttpRouteMetadata, IController, Middleware, OpenAPIRouteRegistrationError, OpenAPIValidationError, Patch, Post, Put, ROUTER_CONTEXT_KEYS, ROUTER_TOKENS, ROUTE_METADATA_KEYS, Route, RouteBody, RouteBodyObject, RouteConfig, RouteNotFoundError, RouteRegistrationService, RouteResponse, RouteResponseObject, RouterContext, RouterEnv, RouterVariables, SECURITY_SCHEMES, SSEMessage, SSEStreamingApi, SecurityScheme, StreamingApi, VERSION_NEUTRAL, VersioningOptions, commonErrorSchemas, errorResponseSchema, getControllerOptions, getControllerRoute, getControllerVersion, getDecoratedMethods, getHttpDecoratedMethods, getHttpRouteMetadata, getRouteConfig, paginatedResponseSchema, paginationQuerySchema, successMessageSchema, uuidParamSchema, validationErrorResponseSchema };

package/dist/router/index.mjs

@@ -0,0 +1,11 @@
+import { v as ROUTER_TOKENS } from "../errors-BRJgVd5-.mjs";
+import "../logger-Bg-CuidS.mjs";
+import "../module-Dvzm4dhS.mjs";
+import "../events-CQyvSyrQ.mjs";
+import { a as getControllerVersion, i as getControllerRoute, n as Controller, r as getControllerOptions } from "../middleware-B3tx1u1K.mjs";
+import { a as ROUTER_CONTEXT_KEYS, c as VERSION_NEUTRAL, o as ROUTE_METADATA_KEYS, r as HTTP_METHODS, s as SECURITY_SCHEMES, t as RouterContext } from "../router-context-DlTxpJUG.mjs";
+import "../validation-DA5nptIp.mjs";
+import { C as Get, D as getHttpDecoratedMethods, E as Put, O as getHttpRouteMetadata, S as Delete, T as Post, a as errorResponseSchema, b as getRouteConfig, c as successMessageSchema, d as RouteNotFoundError, f as OpenAPIValidationError, h as HonoAppAlreadyConfiguredError, i as commonErrorSchemas, l as uuidParamSchema, m as ControllerRegistrationError, n as HonoApp, o as paginatedResponseSchema, p as OpenAPIRouteRegistrationError, r as RouteRegistrationService, s as paginationQuerySchema, u as validationErrorResponseSchema, v as Route, w as Patch, x as All, y as getDecoratedMethods } from "../i18n.module-C9wQr_2k.mjs";
+import "../guards-B5o618bL.mjs";
+import "../gateway-context-D7TFPLi5.mjs";
+export { All, Controller, ControllerRegistrationError, Delete, Get, HTTP_METHODS, HonoApp, HonoAppAlreadyConfiguredError, OpenAPIRouteRegistrationError, OpenAPIValidationError, Patch, Post, Put, ROUTER_CONTEXT_KEYS, ROUTER_TOKENS, ROUTE_METADATA_KEYS, Route, RouteNotFoundError, RouteRegistrationService, RouterContext, SECURITY_SCHEMES, VERSION_NEUTRAL, commonErrorSchemas, errorResponseSchema, getControllerOptions, getControllerRoute, getControllerVersion, getDecoratedMethods, getHttpDecoratedMethods, getHttpRouteMetadata, getRouteConfig, paginatedResponseSchema, paginationQuerySchema, successMessageSchema, uuidParamSchema, validationErrorResponseSchema };