stratal 0.0.13 → 0.0.15

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

@@ -1,52 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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;IA2E1F;;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

@@ -1,231 +0,0 @@
-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 { swaggerUI } from '@hono/swagger-ui';
-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);
-        });
-        // Docs UI endpoint
-        if (config.ui !== false) {
-            const uiPath = config.ui?.path ?? '/api/docs';
-            const uiRenderer = config.ui?.renderer;
-            app.get(uiPath, (c, next) => {
-                const requestContainer = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER);
-                const requestConfigService = requestContainer.resolve(OPENAPI_TOKENS.ConfigService);
-                const effectiveConfig = requestConfigService.getEffectiveConfig();
-                const uiContext = { specUrl: effectiveConfig.jsonPath, title: effectiveConfig.info.title };
-                if (uiRenderer) {
-                    return uiRenderer(uiContext)(c, next);
-                }
-                return swaggerUI({ url: uiContext.specUrl })(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

@@ -1 +0,0 @@
-{"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

@@ -1,84 +0,0 @@
-import type { MiddlewareHandler } from 'hono/types';
-import type { PathItemObject } from '../i18n/validation';
-import type { RouterEnv } from '../router/types';
-/**
- * OpenAPI Info section configuration
- */
-export interface OpenAPIInfo {
-    title: string;
-    version: string;
-    description?: string;
-}
-/**
- * Context passed to a custom OpenAPI UI renderer
- */
-export interface OpenAPIUIContext {
-    specUrl: string;
-    title: string;
-}
-/**
- * Custom UI renderer function
- * Returns a Hono middleware handler that serves the docs UI
- */
-export type OpenAPIUIRenderer = (context: OpenAPIUIContext) => MiddlewareHandler<RouterEnv>;
-/**
- * Options for the docs UI
- */
-export interface OpenAPIUIOptions {
-    /** Path for docs UI (default: '/api/docs') */
-    path?: string;
-    /** Custom UI renderer (default: swagger UI) */
-    renderer?: OpenAPIUIRenderer;
-}
-/**
- * Static module configuration (provided via forRoot)
- */
-export interface OpenAPIModuleOptions {
-    /** Path for OpenAPI JSON spec (default: '/api/openapi.json') */
-    jsonPath?: string;
-    /** Default info section for spec */
-    info?: OpenAPIInfo;
-    /** Security schemes definition */
-    securitySchemes?: Record<string, object>;
-    /** Docs UI configuration. Set to false to disable. (default: swagger UI at /api/docs) */
-    ui?: OpenAPIUIOptions | false;
-}
-/**
- * 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;
-    info: OpenAPIInfo;
-    securitySchemes?: Record<string, object>;
-    routeFilter?: RouteFilterFn;
-    ui?: OpenAPIUIOptions | false;
-}
-/**
- * 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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/openapi/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD;;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,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,iBAAiB,CAAC,SAAS,CAAC,CAAA;AAE3F;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,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;IAExC,yFAAyF;IACzF,EAAE,CAAC,EAAE,gBAAgB,GAAG,KAAK,CAAA;CAC9B;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,IAAI,EAAE,WAAW,CAAA;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,WAAW,CAAC,EAAE,aAAa,CAAA;IAC3B,EAAE,CAAC,EAAE,gBAAgB,GAAG,KAAK,CAAA;CAC9B;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

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

package/dist/openapi/types.js.map

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

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

@@ -1,77 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,110 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

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

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

@@ -1 +0,0 @@
-{"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

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

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

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

package/dist/queue/decorators/inject-queue.decorator.d.ts

@@ -1,31 +0,0 @@
-import type { QueueName } from '../queue-name';
-/**
- * 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.
- */
-export declare function InjectQueue(name: QueueName): ParameterDecorator;
-//# sourceMappingURL=inject-queue.decorator.d.ts.map

package/dist/queue/decorators/inject-queue.decorator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"inject-queue.decorator.d.ts","sourceRoot":"","sources":["../../../src/queue/decorators/inject-queue.decorator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,kBAAkB,CAE/D"}