stratal 0.0.1

package/dist/openapi/services/openapi.service.d.ts

@@ -0,0 +1,52 @@
+import type { OpenAPIHono } from '../../i18n/validation';
+import type { IController } from '../../router/controller';
+import type { RouterEnv } from '../../router/types';
+import type { Constructor } from '../../types';
+import type { IOpenAPIConfigService } from '../types';
+/**
+ * OpenAPI Service
+ *
+ * Generates OpenAPI specifications with support for:
+ * - Runtime configuration via OpenAPIConfigService
+ * - Route filtering via hideFromDocs and custom routeFilter
+ * - i18n support for titles and descriptions
+ * - Security scheme definitions
+ *
+ * Configuration is resolved per-request from OpenAPIConfigService,
+ * allowing middleware to override config based on domain context.
+ */
+export declare class OpenAPIService {
+    private configService;
+    private routeInfoMap;
+    constructor(configService: IOpenAPIConfigService);
+    /**
+     * Setup OpenAPI documentation endpoints
+     */
+    setupEndpoints(app: OpenAPIHono<RouterEnv>, controllers: Constructor<IController>[]): void;
+    /**
+     * Get localized security scheme definitions
+     */
+    private getSecuritySchemeDefinitions;
+    /**
+     * Build route info map from controllers
+     * Maps route prefixes to their hideFromDocs flag
+     */
+    private buildRouteInfoMap;
+    /**
+     * Filter OpenAPI paths based on hideFromDocs and custom routeFilter
+     */
+    private filterRoutes;
+    /**
+     * Get route info by matching path against controller routes
+     */
+    private getRouteInfo;
+    /**
+     * Filter unreferenced schemas from OpenAPI spec
+     */
+    private filterSchemas;
+    /**
+     * Recursively collect all schema references from an object
+     */
+    private collectSchemaRefs;
+}
+//# sourceMappingURL=openapi.service.d.ts.map

package/dist/openapi/services/openapi.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.service.d.ts","sourceRoot":"","sources":["../../../src/openapi/services/openapi.service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,uBAAuB,CAAA;AAExE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,OAAO,KAAK,EAAE,qBAAqB,EAA0B,MAAM,UAAU,CAAA;AAS7E;;;;;;;;;;;GAWG;AACH,qBACa,cAAc;IAKvB,OAAO,CAAC,aAAa;IAJvB,OAAO,CAAC,YAAY,CAA+B;gBAIzC,aAAa,EAAE,qBAAqB;IAG9C;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC,EAAE,GAAG,IAAI;IAsE1F;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAuBpC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,YAAY;IA0BpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA6BrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA2B1B"}

package/dist/openapi/services/openapi.service.js

@@ -0,0 +1,228 @@
+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 { Scalar } from '@scalar/hono-api-reference';
+import { inject } from 'tsyringe';
+import { Transient } from '../../di/decorators';
+import { I18N_TOKENS } from '../../i18n';
+import { ROUTER_CONTEXT_KEYS, SECURITY_SCHEMES } from '../../router/constants';
+import { getControllerOptions, getControllerRoute } from '../../router/decorators';
+import { OPENAPI_TOKENS } from '../openapi.tokens';
+/**
+ * OpenAPI Service
+ *
+ * Generates OpenAPI specifications with support for:
+ * - Runtime configuration via OpenAPIConfigService
+ * - Route filtering via hideFromDocs and custom routeFilter
+ * - i18n support for titles and descriptions
+ * - Security scheme definitions
+ *
+ * Configuration is resolved per-request from OpenAPIConfigService,
+ * allowing middleware to override config based on domain context.
+ */
+let OpenAPIService = class OpenAPIService {
+    configService;
+    routeInfoMap = new Map();
+    constructor(configService) {
+        this.configService = configService;
+    }
+    /**
+     * Setup OpenAPI documentation endpoints
+     */
+    setupEndpoints(app, controllers) {
+        // Build route info map for hideFromDocs filtering
+        this.buildRouteInfoMap(controllers);
+        const config = this.configService.getEffectiveConfig();
+        // OpenAPI JSON spec endpoint
+        app.get(config.jsonPath, (c) => {
+            // Get request-scoped services
+            const requestContainer = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER);
+            const i18n = requestContainer.resolve(I18N_TOKENS.I18nService);
+            const requestConfigService = requestContainer.resolve(OPENAPI_TOKENS.ConfigService);
+            // Get effective config (with any middleware overrides)
+            const effectiveConfig = requestConfigService.getEffectiveConfig();
+            const url = new URL(c.req.raw.url);
+            // Generate full OpenAPI spec using Hono's built-in generator
+            const fullSpec = app.getOpenAPIDocument({
+                openapi: '3.0.0',
+                info: {
+                    version: effectiveConfig.info.version,
+                    title: effectiveConfig.info.title,
+                    description: effectiveConfig.info.description
+                },
+                servers: [
+                    {
+                        url: `${url.protocol}//${url.host}`,
+                        description: i18n.t('common.api.serverDescription')
+                    }
+                ]
+            });
+            // Add security schemes
+            fullSpec.components ??= {};
+            fullSpec.components.securitySchemes = this.getSecuritySchemeDefinitions(i18n);
+            // Filter routes based on hideFromDocs and custom routeFilter
+            fullSpec.paths = this.filterRoutes(fullSpec.paths, effectiveConfig);
+            // Filter unreferenced schemas
+            if (fullSpec.components.schemas) {
+                fullSpec.components.schemas = this.filterSchemas(fullSpec);
+            }
+            return c.json(fullSpec);
+        });
+        // Swagger UI endpoint
+        app.get(config.docsPath, (c, next) => {
+            const requestContainer = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER);
+            const requestConfigService = requestContainer.resolve(OPENAPI_TOKENS.ConfigService);
+            const effectiveConfig = requestConfigService.getEffectiveConfig();
+            return Scalar({
+                url: effectiveConfig.jsonPath,
+                pageTitle: effectiveConfig.info.title,
+                telemetry: false,
+                theme: 'deepSpace',
+            })(c, next);
+        });
+    }
+    /**
+     * Get localized security scheme definitions
+     */
+    getSecuritySchemeDefinitions(i18n) {
+        return {
+            [SECURITY_SCHEMES.BEARER_AUTH]: {
+                type: 'http',
+                scheme: 'bearer',
+                bearerFormat: 'JWT',
+                description: i18n.t('common.api.security.bearerAuth')
+            },
+            [SECURITY_SCHEMES.API_KEY]: {
+                type: 'apiKey',
+                in: 'header',
+                name: 'X-API-Key',
+                description: i18n.t('common.api.security.apiKey')
+            },
+            [SECURITY_SCHEMES.SESSION_COOKIE]: {
+                type: 'apiKey',
+                in: 'cookie',
+                name: 'session',
+                description: i18n.t('common.api.security.sessionCookie')
+            }
+        };
+    }
+    /**
+     * Build route info map from controllers
+     * Maps route prefixes to their hideFromDocs flag
+     */
+    buildRouteInfoMap(controllers) {
+        for (const ControllerClass of controllers) {
+            const route = getControllerRoute(ControllerClass);
+            const options = getControllerOptions(ControllerClass);
+            if (route) {
+                this.routeInfoMap.set(route, {
+                    hideFromDocs: options?.hideFromDocs ?? false
+                });
+            }
+        }
+    }
+    /**
+     * Filter OpenAPI paths based on hideFromDocs and custom routeFilter
+     */
+    filterRoutes(paths, config) {
+        const filteredPaths = {};
+        for (const [path, pathItem] of Object.entries(paths)) {
+            // 1. Check hideFromDocs (always filtered)
+            const routeInfo = this.getRouteInfo(path);
+            if (routeInfo.hideFromDocs) {
+                continue;
+            }
+            // 2. Apply custom routeFilter if provided
+            if (config.routeFilter) {
+                if (!config.routeFilter(path, pathItem)) {
+                    continue;
+                }
+            }
+            filteredPaths[path] = pathItem;
+        }
+        return filteredPaths;
+    }
+    /**
+     * Get route info by matching path against controller routes
+     */
+    getRouteInfo(path) {
+        for (const [route, info] of this.routeInfoMap.entries()) {
+            if (path === route || path.startsWith(`${route}/`)) {
+                return info;
+            }
+        }
+        // Default to visible for unmatched routes
+        return { hideFromDocs: false };
+    }
+    /**
+     * Filter unreferenced schemas from OpenAPI spec
+     */
+    filterSchemas(spec) {
+        const referencedSchemas = new Set();
+        // Collect all schema references from paths
+        this.collectSchemaRefs(spec.paths, referencedSchemas);
+        // Filter schemas to only include referenced ones
+        const filteredSchemas = {};
+        const components = spec.components;
+        if (components?.schemas) {
+            for (const [schemaName, schemaValue] of Object.entries(components.schemas)) {
+                if (referencedSchemas.has(schemaName)) {
+                    filteredSchemas[schemaName] = schemaValue;
+                    // Also collect references from this schema (for nested schemas)
+                    this.collectSchemaRefs(schemaValue, referencedSchemas);
+                }
+            }
+            // Second pass to include any schemas referenced by included schemas
+            for (const [schemaName, schemaValue] of Object.entries(components.schemas)) {
+                if (referencedSchemas.has(schemaName) && !filteredSchemas[schemaName]) {
+                    filteredSchemas[schemaName] = schemaValue;
+                }
+            }
+        }
+        return filteredSchemas;
+    }
+    /**
+     * Recursively collect all schema references from an object
+     */
+    collectSchemaRefs(obj, refs) {
+        if (!obj || typeof obj !== 'object') {
+            return;
+        }
+        const record = obj;
+        // Check if this object has a $ref property
+        if (record.$ref && typeof record.$ref === 'string') {
+            // Extract schema name from $ref (format: #/components/schemas/SchemaName)
+            const match = /^#\/components\/schemas\/(.+)$/.exec(record.$ref);
+            if (match) {
+                refs.add(match[1]);
+            }
+        }
+        // Recursively check all properties
+        if (Array.isArray(obj)) {
+            for (const item of obj) {
+                this.collectSchemaRefs(item, refs);
+            }
+        }
+        else {
+            for (const value of Object.values(record)) {
+                this.collectSchemaRefs(value, refs);
+            }
+        }
+    }
+};
+OpenAPIService = __decorate([
+    Transient(OPENAPI_TOKENS.OpenAPIService),
+    __param(0, inject(OPENAPI_TOKENS.ConfigService)),
+    __metadata("design:paramtypes", [Object])
+], OpenAPIService);
+export { OpenAPIService };
+//# sourceMappingURL=openapi.service.js.map

package/dist/openapi/services/openapi.service.js.map

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

package/dist/openapi/types.d.ts

@@ -0,0 +1,61 @@
+import type { PathItemObject } from '../i18n/validation';
+/**
+ * OpenAPI Info section configuration
+ */
+export interface OpenAPIInfo {
+    title: string;
+    version: string;
+    description?: string;
+}
+/**
+ * Static module configuration (provided via forRoot)
+ */
+export interface OpenAPIModuleOptions {
+    /** Path for OpenAPI JSON spec (default: '/api/openapi.json') */
+    jsonPath?: string;
+    /** Path for Swagger UI docs (default: '/api/docs') */
+    docsPath?: string;
+    /** Default info section for spec */
+    info?: OpenAPIInfo;
+    /** Security schemes definition */
+    securitySchemes?: Record<string, object>;
+}
+/**
+ * Route filter function type
+ * Returns true to include route, false to exclude
+ */
+export type RouteFilterFn = (path: string, pathItem: PathItemObject) => boolean;
+/**
+ * Runtime configuration override (set via middleware)
+ */
+export interface OpenAPIConfigOverride {
+    /** Override info section */
+    info?: Partial<OpenAPIInfo>;
+    /** Custom route filter (returns true to include, false to exclude) */
+    routeFilter?: RouteFilterFn;
+}
+/**
+ * Effective configuration after merging base options with overrides
+ */
+export interface OpenAPIEffectiveConfig {
+    jsonPath: string;
+    docsPath: string;
+    info: OpenAPIInfo;
+    securitySchemes?: Record<string, object>;
+    routeFilter?: RouteFilterFn;
+}
+/**
+ * OpenAPI config service interface
+ */
+export interface IOpenAPIConfigService {
+    /**
+     * Override config for this request
+     * Can be called multiple times; overrides are merged in order
+     */
+    override(config: OpenAPIConfigOverride): void;
+    /**
+     * Get effective config (base merged with all overrides)
+     */
+    getEffectiveConfig(): OpenAPIEffectiveConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/openapi/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/openapi/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,oCAAoC;IACpC,IAAI,CAAC,EAAE,WAAW,CAAA;IAElB,kCAAkC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACzC;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAA;AAE/E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IAE3B,sEAAsE;IACtE,WAAW,CAAC,EAAE,aAAa,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,WAAW,CAAA;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,WAAW,CAAC,EAAE,aAAa,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAA;IAE7C;;OAEG;IACH,kBAAkB,IAAI,sBAAsB,CAAA;CAC7C"}

package/dist/openapi/types.js

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

package/dist/openapi/types.js.map

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

package/dist/polyfills/dom.polyfill.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dom.polyfill.d.ts.map

package/dist/polyfills/dom.polyfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.polyfill.d.ts","sourceRoot":"","sources":["../../src/polyfills/dom.polyfill.ts"],"names":[],"mappings":""}

package/dist/polyfills/dom.polyfill.js

@@ -0,0 +1,30 @@
+/**
+ * DOM polyfills for Cloudflare Workers
+ *
+ * AWS SDK v3 uses DOMParser and Node for XML parsing, which are not available in Workers.
+ * This module must be imported BEFORE any AWS SDK imports (including transitive).
+ *
+ * @see https://github.com/aws/aws-sdk-js-v3/issues/7375
+ */
+import { DOMParser } from '@xmldom/xmldom';
+// DOMParser polyfill for XML response parsing
+globalThis.DOMParser = DOMParser;
+// Node interface polyfill with DOM node type constants
+// Required by AWS SDK for XML response parsing
+if (typeof globalThis.Node === 'undefined') {
+    globalThis.Node = {
+        ELEMENT_NODE: 1,
+        ATTRIBUTE_NODE: 2,
+        TEXT_NODE: 3,
+        CDATA_SECTION_NODE: 4,
+        ENTITY_REFERENCE_NODE: 5,
+        ENTITY_NODE: 6,
+        PROCESSING_INSTRUCTION_NODE: 7,
+        COMMENT_NODE: 8,
+        DOCUMENT_NODE: 9,
+        DOCUMENT_TYPE_NODE: 10,
+        DOCUMENT_FRAGMENT_NODE: 11,
+        NOTATION_NODE: 12,
+    };
+}
+//# sourceMappingURL=dom.polyfill.js.map

package/dist/polyfills/dom.polyfill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.polyfill.js","sourceRoot":"","sources":["../../src/polyfills/dom.polyfill.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,8CAA8C;AAC9C,UAAU,CAAC,SAAS,GAAG,SAAS,CAAA;AAEhC,uDAAuD;AACvD,+CAA+C;AAC/C,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;IAC3C,UAAU,CAAC,IAAI,GAAG;QAChB,YAAY,EAAE,CAAC;QACf,cAAc,EAAE,CAAC;QACjB,SAAS,EAAE,CAAC;QACZ,kBAAkB,EAAE,CAAC;QACrB,qBAAqB,EAAE,CAAC;QACxB,WAAW,EAAE,CAAC;QACd,2BAA2B,EAAE,CAAC;QAC9B,YAAY,EAAE,CAAC;QACf,aAAa,EAAE,CAAC;QAChB,kBAAkB,EAAE,EAAE;QACtB,sBAAsB,EAAE,EAAE;QAC1B,aAAa,EAAE,EAAE;KACQ,CAAA;AAC7B,CAAC"}

package/dist/polyfills/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Polyfills module
+ *
+ * Import this module at the very top of your entry point to ensure
+ * polyfills are loaded before any code that depends on them.
+ */
+import './dom.polyfill';
+//# sourceMappingURL=index.d.ts.map

package/dist/polyfills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/polyfills/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,gBAAgB,CAAC"}

package/dist/polyfills/index.js

@@ -0,0 +1,8 @@
+/**
+ * Polyfills module
+ *
+ * Import this module at the very top of your entry point to ensure
+ * polyfills are loaded before any code that depends on them.
+ */
+import './dom.polyfill';
+//# sourceMappingURL=index.js.map

package/dist/polyfills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/polyfills/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,gBAAgB,CAAC"}

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

@@ -0,0 +1,77 @@
+import type { IQueueConsumer } from './queue-consumer';
+/**
+ * Consumer Registry
+ *
+ * Singleton service that holds all registered queue consumers indexed by message type.
+ * Consumers declare the message types they handle, and this registry routes messages
+ * to the appropriate consumers based on their types.
+ *
+ * **Message-Type Routing:**
+ * - Consumers declare `messageTypes` array (e.g., `['email.send', 'email.batch.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)
+ * - Use `'*'` as a wildcard to handle all message types
+ *
+ * @example Consumer registration
+ * ```typescript
+ * // In consumer.ts
+ * @Transient()
+ * export class EmailConsumer implements IQueueConsumer {
+ *   readonly messageTypes = ['email.send', 'email.batch.send']
+ *   // ...
+ * }
+ *
+ * // In module.ts
+ * @Module({
+ *   consumers: [EmailConsumer]
+ * })
+ *
+ * // Application auto-registers via ConsumerRegistry
+ * this.consumerRegistry.register(consumer)
+ * ```
+ */
+export declare class ConsumerRegistry {
+    /** Map from message type to consumers handling that type */
+    private consumersByType;
+    /** Set of all registered consumers (for iteration) */
+    private allConsumers;
+    /**
+     * Register a queue consumer
+     *
+     * Indexes the consumer by each of its declared message types.
+     *
+     * @param consumer - Queue consumer to register
+     */
+    register(consumer: IQueueConsumer): void;
+    /**
+     * 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: string): IQueueConsumer[];
+    /**
+     * 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: string): boolean;
+    /**
+     * Get all registered message types
+     *
+     * @returns Array of message types with registered consumers
+     */
+    getMessageTypes(): string[];
+    /**
+     * Get all registered consumers
+     *
+     * @returns Array of all registered consumers
+     */
+    getAllConsumers(): IQueueConsumer[];
+}
+//# sourceMappingURL=consumer-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-registry.d.ts","sourceRoot":"","sources":["../../src/queue/consumer-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBACa,gBAAgB;IAC3B,4DAA4D;IAC5D,OAAO,CAAC,eAAe,CAAsC;IAE7D,sDAAsD;IACtD,OAAO,CAAC,YAAY,CAA4B;IAEhD;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAcxC;;;;;;;;;OASG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,EAAE;IASnD;;;;;OAKG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAI1C;;;;OAIG;IACH,eAAe,IAAI,MAAM,EAAE;IAI3B;;;;OAIG;IACH,eAAe,IAAI,cAAc,EAAE;CAGpC"}

package/dist/queue/consumer-registry.js

@@ -0,0 +1,110 @@
+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;
+};
+import { Transient } from '../di/decorators';
+import { DI_TOKENS } from '../di/tokens';
+/**
+ * Consumer Registry
+ *
+ * Singleton service that holds all registered queue consumers indexed by message type.
+ * Consumers declare the message types they handle, and this registry routes messages
+ * to the appropriate consumers based on their types.
+ *
+ * **Message-Type Routing:**
+ * - Consumers declare `messageTypes` array (e.g., `['email.send', 'email.batch.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)
+ * - Use `'*'` as a wildcard to handle all message types
+ *
+ * @example Consumer registration
+ * ```typescript
+ * // In consumer.ts
+ * @Transient()
+ * export class EmailConsumer implements IQueueConsumer {
+ *   readonly messageTypes = ['email.send', 'email.batch.send']
+ *   // ...
+ * }
+ *
+ * // In module.ts
+ * @Module({
+ *   consumers: [EmailConsumer]
+ * })
+ *
+ * // Application auto-registers via ConsumerRegistry
+ * this.consumerRegistry.register(consumer)
+ * ```
+ */
+let ConsumerRegistry = class ConsumerRegistry {
+    /** Map from message type to consumers handling that type */
+    consumersByType = new Map();
+    /** Set of all registered consumers (for iteration) */
+    allConsumers = 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; // Already registered
+        }
+        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('*') ?? [];
+        // Combine and dedupe
+        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);
+export { ConsumerRegistry };
+//# sourceMappingURL=consumer-registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-registry.js","sourceRoot":"","sources":["../../src/queue/consumer-registry.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAGxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAC3B,4DAA4D;IACpD,eAAe,GAAG,IAAI,GAAG,EAA4B,CAAA;IAE7D,sDAAsD;IAC9C,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEhD;;;;;;OAMG;IACH,QAAQ,CAAC,QAAwB;QAC/B,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,OAAM,CAAC,qBAAqB;QAC9B,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAE/B,KAAK,MAAM,WAAW,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAA;YAC5D,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACvB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;QACjD,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,YAAY,CAAC,WAAmB;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAA;QAC9D,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;QAEzD,qBAAqB;QACrB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,EAAE,GAAG,aAAa,CAAC,CAAC,CAAA;QAC3D,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC7B,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,WAAmB;QAC9B,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;IAClD,CAAC;IAED;;;;OAIG;IACH,eAAe;QACb,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAA;IAChD,CAAC;IAED;;;;OAIG;IACH,eAAe;QACb,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IACtC,CAAC;CACF,CAAA;AA1EY,gBAAgB;IAD5B,SAAS,CAAC,SAAS,CAAC,gBAAgB,CAAC;GACzB,gBAAgB,CA0E5B"}

package/dist/queue/decorators/index.d.ts

@@ -0,0 +1,2 @@
+export * from './inject-queue.decorator';
+//# sourceMappingURL=index.d.ts.map

package/dist/queue/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/queue/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA"}

package/dist/queue/decorators/index.js

@@ -0,0 +1,2 @@
+export * from './inject-queue.decorator';
+//# sourceMappingURL=index.js.map

package/dist/queue/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/queue/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA"}