stratal 0.0.1

package/dist/queue/queue-manager.d.ts

@@ -0,0 +1,36 @@
+import { ConsumerRegistry } from './consumer-registry';
+/**
+ * Queue Manager
+ *
+ * Singleton service for processing queue message batches.
+ * Routes messages to consumers based on message type.
+ *
+ * **Message Routing:**
+ * - Consumers declare message types they handle (e.g., ['email.send'])
+ * - When a message arrives, consumers matching the message type are invoked
+ * - A consumer can handle messages from ANY queue (routing is by type, not queue)
+ *
+ * **Note:** For sending messages to queues, use IQueueSender instances
+ * obtained via @InjectQueue('queue-name') or module bindings.
+ *
+ * @example Processing a queue batch
+ * ```typescript
+ * // In Cloudflare Worker queue handler
+ * await queueManager.processBatch('notifications-queue', batch)
+ * ```
+ */
+export declare class QueueManager {
+    private readonly registry;
+    constructor(registry: ConsumerRegistry);
+    /**
+     * 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
+     */
+    processBatch(_queueName: string, batch: MessageBatch): Promise<void>;
+}
+//# sourceMappingURL=queue-manager.d.ts.map

package/dist/queue/queue-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-manager.d.ts","sourceRoot":"","sources":["../../src/queue/queue-manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAGtD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBACa,YAAY;IAEe,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAGjF;;;;;;;;OAQG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAwB3E"}

package/dist/queue/queue-manager.js

@@ -0,0 +1,80 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject } from 'tsyringe';
+import { Transient } from '../di/decorators';
+import { DI_TOKENS } from '../di/tokens';
+import { ConsumerRegistry } from './consumer-registry';
+/**
+ * Queue Manager
+ *
+ * Singleton service for processing queue message batches.
+ * Routes messages to consumers based on message type.
+ *
+ * **Message Routing:**
+ * - Consumers declare message types they handle (e.g., ['email.send'])
+ * - When a message arrives, consumers matching the message type are invoked
+ * - A consumer can handle messages from ANY queue (routing is by type, not queue)
+ *
+ * **Note:** For sending messages to queues, use IQueueSender instances
+ * obtained via @InjectQueue('queue-name') or module bindings.
+ *
+ * @example Processing a queue batch
+ * ```typescript
+ * // In Cloudflare Worker queue handler
+ * await queueManager.processBatch('notifications-queue', batch)
+ * ```
+ */
+let QueueManager = class QueueManager {
+    registry;
+    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;
+            // Find consumers by message type (not by queue name)
+            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),
+    __param(0, inject(DI_TOKENS.ConsumerRegistry)),
+    __metadata("design:paramtypes", [ConsumerRegistry])
+], QueueManager);
+export { QueueManager };
+//# sourceMappingURL=queue-manager.js.map

package/dist/queue/queue-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-manager.js","sourceRoot":"","sources":["../../src/queue/queue-manager.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAGtD;;;;;;;;;;;;;;;;;;;GAmBG;AAEI,IAAM,YAAY,GAAlB,MAAM,YAAY;IAEgC;IADvD,YACuD,QAA0B;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;IAC9E,CAAC;IAEJ;;;;;;;;OAQG;IACH,KAAK,CAAC,YAAY,CAAC,UAAkB,EAAE,KAAmB;QACxD,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAoB,CAAA;YAEjD,qDAAqD;YACrD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;YAE/D,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC;oBACH,MAAM,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;oBACnC,OAAO,CAAC,GAAG,EAAE,CAAA;gBACf,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,aAAa,GAAG,KAAK,YAAY,KAAK;wBAC1C,CAAC,CAAC,KAAK;wBACP,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;oBAE5B,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;wBACrB,MAAM,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;oBACrD,CAAC;oBACD,OAAO,CAAC,KAAK,EAAE,CAAA;gBACjB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAA;AAtCY,YAAY;IADxB,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC;IAGtB,WAAA,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAA;qCAA4B,gBAAgB;GAFtE,YAAY,CAsCxB"}

package/dist/queue/queue-name.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Queue Name Type System with Module Augmentation
+ *
+ * This file provides a type-safe queue naming system using module augmentation.
+ * Applications augment the QueueNames interface to get autocomplete for queue names.
+ *
+ * @example In apps/backend/src/types/queues.ts:
+ * ```typescript
+ * declare module 'stratal' {
+ *   interface QueueNames {
+ *     'notifications-queue': true
+ *     'tenant-notifications-queue': true
+ *   }
+ * }
+ * ```
+ *
+ * When QueueNames is augmented, QueueName provides autocomplete.
+ * When not augmented, QueueName falls back to string for flexibility.
+ */
+/**
+ * Augmentable interface for queue names.
+ *
+ * Applications extend this interface via module augmentation to define
+ * their queue names. The keys become the valid queue name union type.
+ *
+ * @example
+ * ```typescript
+ * // In your application's type declarations
+ * declare module 'stratal' {
+ *   interface QueueNames {
+ *     'notifications-queue': true
+ *     'tenant-notifications-queue': true
+ *   }
+ * }
+ * ```
+ */
+export interface QueueNames {
+}
+/**
+ * Queue name type - extracts keys from QueueNames or falls back to string.
+ *
+ * When QueueNames is augmented with queue name keys, this type provides:
+ * - Type safety: Only declared queue names are valid
+ * - Autocomplete: IDE suggestions for available queue names
+ *
+ * When QueueNames is empty (not augmented), falls back to string
+ * for flexibility during development or in non-typed contexts.
+ */
+export type QueueName = keyof QueueNames extends never ? string : keyof QueueNames;
+//# sourceMappingURL=queue-name.d.ts.map

package/dist/queue/queue-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-name.d.ts","sourceRoot":"","sources":["../../src/queue/queue-name.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,UAAU;CAAI;AAE/B;;;;;;;;;GASG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,UAAU,SAAS,KAAK,GAAG,MAAM,GAAG,MAAM,UAAU,CAAA"}

package/dist/queue/queue-name.js

@@ -0,0 +1,21 @@
+/**
+ * Queue Name Type System with Module Augmentation
+ *
+ * This file provides a type-safe queue naming system using module augmentation.
+ * Applications augment the QueueNames interface to get autocomplete for queue names.
+ *
+ * @example In apps/backend/src/types/queues.ts:
+ * ```typescript
+ * declare module 'stratal' {
+ *   interface QueueNames {
+ *     'notifications-queue': true
+ *     'tenant-notifications-queue': true
+ *   }
+ * }
+ * ```
+ *
+ * When QueueNames is augmented, QueueName provides autocomplete.
+ * When not augmented, QueueName falls back to string for flexibility.
+ */
+export {};
+//# sourceMappingURL=queue-name.js.map

package/dist/queue/queue-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-name.js","sourceRoot":"","sources":["../../src/queue/queue-name.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/queue/queue-registry.d.ts

@@ -0,0 +1,46 @@
+import type { II18nService } from '../i18n/i18n.types';
+import type { IQueueSender } from './queue-sender.interface';
+import { QueueProviderFactory } from './services';
+/**
+ * Queue Registry
+ *
+ * Request-scoped factory service for creating QueueSender instances.
+ * Caches senders per queue name within the request scope.
+ *
+ * This service is used internally by QueueModule.registerQueue() to provide
+ * IQueueSender instances for each registered queue.
+ *
+ * **Why request-scoped?**
+ * - Needs access to I18nService for locale-aware message metadata
+ * - Provider is created once per request for consistency
+ * - Queue senders are cached per request to avoid recreating them
+ *
+ * @example
+ * ```typescript
+ * // Used internally by QueueModule.registerQueue()
+ * QueueModule.registerQueue('notifications-queue')
+ *
+ * // The module creates a factory provider:
+ * {
+ *   provide: 'notifications-queue',
+ *   useFactory: (registry: QueueRegistry) => registry.getQueue('notifications-queue'),
+ *   inject: [QUEUE_TOKENS.QueueRegistry],
+ * }
+ * ```
+ */
+export declare class QueueRegistry {
+    private readonly i18n;
+    private readonly provider;
+    private readonly senders;
+    constructor(providerFactory: QueueProviderFactory, i18n: II18nService);
+    /**
+     * 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: string): IQueueSender;
+}
+//# sourceMappingURL=queue-registry.d.ts.map

package/dist/queue/queue-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-registry.d.ts","sourceRoot":"","sources":["../../src/queue/queue-registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBACa,aAAa;IAMW,OAAO,CAAC,QAAQ,CAAC,IAAI;IALxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;gBAGb,eAAe,EAAE,oBAAoB,EAC9B,IAAI,EAAE,YAAY;IAKtE;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;CAU1C"}

package/dist/queue/queue-registry.js

@@ -0,0 +1,78 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject } from 'tsyringe';
+import { Transient } from '../di/decorators';
+import { I18N_TOKENS } from '../i18n/i18n.tokens';
+import { QueueSender } from './queue-sender';
+import { QUEUE_TOKENS } from './queue.tokens';
+import { QueueProviderFactory } from './services';
+/**
+ * Queue Registry
+ *
+ * Request-scoped factory service for creating QueueSender instances.
+ * Caches senders per queue name within the request scope.
+ *
+ * This service is used internally by QueueModule.registerQueue() to provide
+ * IQueueSender instances for each registered queue.
+ *
+ * **Why request-scoped?**
+ * - Needs access to I18nService for locale-aware message metadata
+ * - Provider is created once per request for consistency
+ * - Queue senders are cached per request to avoid recreating them
+ *
+ * @example
+ * ```typescript
+ * // Used internally by QueueModule.registerQueue()
+ * QueueModule.registerQueue('notifications-queue')
+ *
+ * // The module creates a factory provider:
+ * {
+ *   provide: 'notifications-queue',
+ *   useFactory: (registry: QueueRegistry) => registry.getQueue('notifications-queue'),
+ *   inject: [QUEUE_TOKENS.QueueRegistry],
+ * }
+ * ```
+ */
+let QueueRegistry = class QueueRegistry {
+    i18n;
+    provider;
+    senders = 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),
+    __param(0, inject(QUEUE_TOKENS.QueueProviderFactory)),
+    __param(1, inject(I18N_TOKENS.I18nService)),
+    __metadata("design:paramtypes", [QueueProviderFactory, Object])
+], QueueRegistry);
+export { QueueRegistry };
+//# sourceMappingURL=queue-registry.js.map

package/dist/queue/queue-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-registry.js","sourceRoot":"","sources":["../../src/queue/queue-registry.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAIjD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEI,IAAM,aAAa,GAAnB,MAAM,aAAa;IAM4B;IALnC,QAAQ,CAAgB;IACxB,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAA;IAE1D,YAC6C,eAAqC,EAC9B,IAAkB;QAAlB,SAAI,GAAJ,IAAI,CAAc;QAEpE,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAC,MAAM,EAAE,CAAA;IAC1C,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAiB;QACxB,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QAExC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;YAC7D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;QACrC,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAA;AA7BY,aAAa;IADzB,SAAS,CAAC,YAAY,CAAC,aAAa,CAAC;IAMjC,WAAA,MAAM,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAA;IACzC,WAAA,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,CAAA;qCAD4B,oBAAoB;GALvE,aAAa,CA6BzB"}

package/dist/queue/queue-sender.d.ts

@@ -0,0 +1,38 @@
+import type { II18nService } from '../i18n/i18n.types';
+import type { IQueueProvider } from './providers';
+import type { DispatchMessage, IQueueSender } from './queue-sender.interface';
+/**
+ * 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' }
+ * })
+ * ```
+ */
+export declare class QueueSender implements IQueueSender {
+    private readonly queueName;
+    private readonly provider;
+    private readonly i18n;
+    constructor(queueName: string, provider: IQueueProvider, i18n: II18nService);
+    /**
+     * Dispatch a message to this queue.
+     *
+     * @param message - Message to dispatch (without id/timestamp)
+     */
+    dispatch<T>(message: DispatchMessage<T>): Promise<void>;
+}
+//# sourceMappingURL=queue-sender.d.ts.map

package/dist/queue/queue-sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-sender.d.ts","sourceRoot":"","sources":["../../src/queue/queue-sender.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE7E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,WAAY,YAAW,YAAY;IAE5C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAFJ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,YAAY;IAGrC;;;;OAIG;IACG,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAmB9D"}

package/dist/queue/queue-sender.interface.d.ts

@@ -0,0 +1,46 @@
+import type { QueueMessage } from './queue-consumer';
+/**
+ * Message input for queue dispatch (without auto-generated fields)
+ *
+ * When dispatching a message, the id and timestamp are auto-generated.
+ * You only need to provide the type, payload, and optional metadata.
+ */
+export type DispatchMessage<T = unknown> = Omit<QueueMessage<T>, 'id' | 'timestamp'>;
+/**
+ * Queue sender interface for dispatching messages to a queue.
+ *
+ * Each IQueueSender instance is bound to a specific queue name.
+ * Messages are dispatched with auto-generated id, timestamp, and locale metadata.
+ *
+ * @example
+ * ```typescript
+ * // Injected via @InjectQueue or token binding
+ * constructor(
+ *   @InjectQueue('notifications-queue') private queue: IQueueSender
+ * ) {}
+ *
+ * // Dispatch a message
+ * await this.queue.dispatch({
+ *   type: 'email.send',
+ *   payload: {
+ *     to: 'user@example.com',
+ *     subject: 'Welcome',
+ *     html: '<h1>Hello!</h1>'
+ *   }
+ * })
+ * ```
+ */
+export interface IQueueSender {
+    /**
+     * Dispatch a message to this queue.
+     *
+     * Auto-adds:
+     * - `id`: Unique message identifier (UUID)
+     * - `timestamp`: Current timestamp in milliseconds
+     * - `metadata.locale`: Current locale from i18n context
+     *
+     * @param message - Message to dispatch (without id/timestamp)
+     */
+    dispatch<T>(message: DispatchMessage<T>): Promise<void>;
+}
+//# sourceMappingURL=queue-sender.interface.d.ts.map

package/dist/queue/queue-sender.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-sender.interface.d.ts","sourceRoot":"","sources":["../../src/queue/queue-sender.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,WAAW,CAAC,CAAA;AAEpF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;OASG;IACH,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxD"}

package/dist/queue/queue-sender.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue-sender.interface.js.map

package/dist/queue/queue-sender.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-sender.interface.js","sourceRoot":"","sources":["../../src/queue/queue-sender.interface.ts"],"names":[],"mappings":""}

package/dist/queue/queue-sender.js

@@ -0,0 +1,54 @@
+/**
+ * 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' }
+ * })
+ * ```
+ */
+export class QueueSender {
+    queueName;
+    provider;
+    i18n;
+    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 : undefined
+        };
+        await this.provider.send(this.queueName, fullMessage);
+    }
+}
+//# sourceMappingURL=queue-sender.js.map

package/dist/queue/queue-sender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-sender.js","sourceRoot":"","sources":["../../src/queue/queue-sender.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,WAAW;IAEH;IACA;IACA;IAHnB,YACmB,SAAiB,EACjB,QAAwB,EACxB,IAAkB;QAFlB,cAAS,GAAT,SAAS,CAAQ;QACjB,aAAQ,GAAR,QAAQ,CAAgB;QACxB,SAAI,GAAJ,IAAI,CAAc;IAClC,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAI,OAA2B;QAC3C,MAAM,QAAQ,GAAG,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAA;QAExC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;YACpC,IAAI,MAAM,EAAE,CAAC;gBACX,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAA;YAC1B,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAoB;YACnC,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;YACvB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,GAAG,OAAO;YACV,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;SAClE,CAAA;QAED,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;IACvD,CAAC;CACF"}

package/dist/queue/queue.module.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 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('tenant-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
+ */
+import type { AsyncModuleOptions, DynamicModule } from '../module/types';
+import type { QueueName } from './queue-name';
+/**
+ * Queue module configuration options
+ */
+export interface QueueModuleOptions {
+    /**
+     * Queue provider type
+     * - 'cloudflare': Production provider using Cloudflare Queue bindings
+     * - 'sync': Testing provider that processes messages immediately
+     */
+    provider: 'cloudflare' | 'sync';
+}
+export declare 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: AsyncModuleOptions<QueueModuleOptions>): DynamicModule;
+    /**
+     * 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: QueueName): DynamicModule;
+}
+//# sourceMappingURL=queue.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.module.d.ts","sourceRoot":"","sources":["../../src/queue/queue.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAkB,MAAM,iBAAiB,CAAA;AAExF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAM7C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,EAAE,YAAY,GAAG,MAAM,CAAA;CAChC;AAED,qBAOa,WAAW;IACtB;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,GAAG,aAAa;IAanF;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa;CAYrD"}