stratal 0.0.1

package/dist/queue/queue.module.js

@@ -0,0 +1,113 @@
+/**
+ * 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
+ */
+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 QueueModule_1;
+import { DI_TOKENS } from '../di/tokens';
+import { Scope } from '../di/types';
+import { Module } from '../module';
+import { ConsumerRegistry } from './consumer-registry';
+import { QueueRegistry } from './queue-registry';
+import { QUEUE_TOKENS } from './queue.tokens';
+import { QueueProviderFactory } from './services';
+let QueueModule = QueueModule_1 = 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_1,
+            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_1,
+            providers: [
+                {
+                    provide: name,
+                    useFactory: (registry) => registry.getQueue(name),
+                    inject: [QUEUE_TOKENS.QueueRegistry],
+                },
+            ],
+        };
+    }
+};
+QueueModule = QueueModule_1 = __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);
+export { QueueModule };
+//# sourceMappingURL=queue.module.js.map

package/dist/queue/queue.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.module.js","sourceRoot":"","sources":["../../src/queue/queue.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;;;;;;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAElC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAqB1C,IAAM,WAAW,mBAAjB,MAAM,WAAW;IACtB;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,YAAY,CAAC,OAA+C;QACjE,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,YAAY,CAAC,kBAAkB;oBACxC,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;iBACvB;aACF;SACF,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,aAAa,CAAC,IAAe;QAClC,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,IAAoC;oBAC7C,UAAU,EAAE,CAAC,QAAuB,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAChE,MAAM,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC;iBACrC;aACF;SACF,CAAA;IACH,CAAC;CACF,CAAA;AA9DY,WAAW;IAPvB,MAAM,CAAC;QACN,SAAS,EAAE;YACT,EAAE,OAAO,EAAE,SAAS,CAAC,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE;YAC3F,EAAE,OAAO,EAAE,YAAY,CAAC,oBAAoB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE;YACtG,EAAE,OAAO,EAAE,YAAY,CAAC,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE;SACjE;KACF,CAAC;GACW,WAAW,CA8DvB"}

package/dist/queue/queue.tokens.d.ts

@@ -0,0 +1,7 @@
+export declare const QUEUE_TOKENS: {
+    readonly QueueProviderFactory: symbol;
+    readonly QueueRegistry: symbol;
+    readonly QueueModuleOptions: symbol;
+};
+export type QueueToken = (typeof QUEUE_TOKENS)[keyof typeof QUEUE_TOKENS];
+//# sourceMappingURL=queue.tokens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.tokens.d.ts","sourceRoot":"","sources":["../../src/queue/queue.tokens.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;;CAIf,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAA"}

package/dist/queue/queue.tokens.js

@@ -0,0 +1,6 @@
+export const QUEUE_TOKENS = {
+    QueueProviderFactory: Symbol.for('QueueProviderFactory'),
+    QueueRegistry: Symbol.for('QueueRegistry'),
+    QueueModuleOptions: Symbol.for('QueueModuleOptions'),
+};
+//# sourceMappingURL=queue.tokens.js.map

package/dist/queue/queue.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.tokens.js","sourceRoot":"","sources":["../../src/queue/queue.tokens.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,oBAAoB,EAAE,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACxD,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC;IAC1C,kBAAkB,EAAE,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC;CAC5C,CAAA"}

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

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

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

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

package/dist/queue/services/index.js

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

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

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

package/dist/queue/services/queue-provider-factory.d.ts

@@ -0,0 +1,41 @@
+import { type StratalEnv } from '../../env';
+import { ConsumerRegistry } from '../consumer-registry';
+import { type IQueueProvider } from '../providers';
+import type { QueueModuleOptions } from '../queue.module';
+/**
+ * Queue Provider Factory
+ *
+ * Creates the appropriate queue provider based on configuration provided
+ * via QueueModule.forRootAsync().
+ *
+ * **Provider Selection:**
+ * - `cloudflare`: Production provider using Cloudflare Queue bindings
+ * - `sync`: Testing provider that processes messages immediately
+ *
+ * @example
+ * ```typescript
+ * // Configuration via QueueModule.forRootAsync()
+ * QueueModule.forRootAsync({
+ *   inject: [CONFIG_TOKENS.ConfigService],
+ *   useFactory: (config) => ({ provider: config.get('queue').provider })
+ * })
+ *
+ * // Factory usage (internal)
+ * const factory = container.resolve(QueueProviderFactory)
+ * const provider = factory.create()
+ * ```
+ */
+export declare class QueueProviderFactory {
+    private readonly env;
+    private readonly registry;
+    private readonly options?;
+    constructor(env: StratalEnv, registry: ConsumerRegistry, options?: QueueModuleOptions | undefined);
+    /**
+     * Create a queue provider based on module configuration
+     *
+     * @returns Queue provider instance
+     * @throws {QueueProviderNotSupportedError} If provider type is not supported
+     */
+    create(): IQueueProvider;
+}
+//# sourceMappingURL=queue-provider-factory.d.ts.map

package/dist/queue/services/queue-provider-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-provider-factory.d.ts","sourceRoot":"","sources":["../../../src/queue/services/queue-provider-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAG3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAEvD,OAAO,EAA8C,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAC9F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGzD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,oBAAoB;IAEI,OAAO,CAAC,QAAQ,CAAC,GAAG;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAFtC,GAAG,EAAE,UAAU,EACZ,QAAQ,EAAE,gBAAgB,EACC,OAAO,CAAC,EAAE,kBAAkB,YAAA;IAG9G;;;;;OAKG;IACH,MAAM,IAAI,cAAc;CAczB"}

package/dist/queue/services/queue-provider-factory.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 { DI_TOKENS } from '../../di/tokens';
+import { ConsumerRegistry } from '../consumer-registry';
+import { QueueProviderNotSupportedError } from '../errors';
+import { CloudflareQueueProvider, SyncQueueProvider } from '../providers';
+import { QUEUE_TOKENS } from '../queue.tokens';
+/**
+ * Queue Provider Factory
+ *
+ * Creates the appropriate queue provider based on configuration provided
+ * via QueueModule.forRootAsync().
+ *
+ * **Provider Selection:**
+ * - `cloudflare`: Production provider using Cloudflare Queue bindings
+ * - `sync`: Testing provider that processes messages immediately
+ *
+ * @example
+ * ```typescript
+ * // Configuration via QueueModule.forRootAsync()
+ * QueueModule.forRootAsync({
+ *   inject: [CONFIG_TOKENS.ConfigService],
+ *   useFactory: (config) => ({ provider: config.get('queue').provider })
+ * })
+ *
+ * // Factory usage (internal)
+ * const factory = container.resolve(QueueProviderFactory)
+ * const provider = factory.create()
+ * ```
+ */
+let QueueProviderFactory = class QueueProviderFactory {
+    env;
+    registry;
+    options;
+    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),
+    __param(0, inject(DI_TOKENS.CloudflareEnv)),
+    __param(1, inject(DI_TOKENS.ConsumerRegistry)),
+    __param(2, inject(QUEUE_TOKENS.QueueModuleOptions, { isOptional: true })),
+    __metadata("design:paramtypes", [Object, ConsumerRegistry, Object])
+], QueueProviderFactory);
+export { QueueProviderFactory };
+//# sourceMappingURL=queue-provider-factory.js.map

package/dist/queue/services/queue-provider-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-provider-factory.js","sourceRoot":"","sources":["../../../src/queue/services/queue-provider-factory.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,8BAA8B,EAAE,MAAM,WAAW,CAAA;AAC1D,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAuB,MAAM,cAAc,CAAA;AAE9F,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAEqB;IACG;IAC2B;IAHlF,YACoD,GAAe,EACZ,QAA0B,EACC,OAA4B;QAF1D,QAAG,GAAH,GAAG,CAAY;QACZ,aAAQ,GAAR,QAAQ,CAAkB;QACC,YAAO,GAAP,OAAO,CAAqB;IAC1G,CAAC;IAEL;;;;;OAKG;IACH,MAAM;QACJ,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,IAAI,YAAY,CAAA;QAE3D,QAAQ,YAAY,EAAE,CAAC;YACrB,KAAK,YAAY;gBACf,OAAO,IAAI,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAE9C,KAAK,MAAM;gBACT,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAE7C;gBACE,MAAM,IAAI,8BAA8B,CAAC,YAAY,CAAC,CAAA;QAC1D,CAAC;IACH,CAAC;CACF,CAAA;AA3BY,oBAAoB;IADhC,SAAS,CAAC,YAAY,CAAC,oBAAoB,CAAC;IAGxC,WAAA,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAA;IAC/B,WAAA,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAA;IAClC,WAAA,MAAM,CAAC,YAAY,CAAC,kBAAkB,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAA;6CADC,gBAAgB;GAHtE,oBAAoB,CA2BhC"}

package/dist/router/constants.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Type-safe context keys for Hono router variables
+ * Using symbols to avoid string collisions
+ */
+export declare const ROUTER_CONTEXT_KEYS: {
+    readonly REQUEST_CONTAINER: "requestContainer";
+    readonly LOCALE: "locale";
+};
+/**
+ * Metadata keys for storing route and controller configuration
+ * Using symbols to avoid collisions with other decorators
+ */
+export declare const ROUTE_METADATA_KEYS: {
+    readonly CONTROLLER_ROUTE: symbol;
+    readonly CONTROLLER_OPTIONS: symbol;
+    readonly CONTROLLER_MIDDLEWARES: symbol;
+    readonly ROUTE_CONFIG: symbol;
+    readonly DECORATED_METHODS: symbol;
+    readonly AUTH_GUARD: symbol;
+};
+/**
+ * Security scheme identifiers for OpenAPI
+ * These reference the security scheme definitions in security.schemas.ts
+ */
+export declare const SECURITY_SCHEMES: {
+    readonly BEARER_AUTH: "bearerAuth";
+    readonly API_KEY: "apiKey";
+    readonly SESSION_COOKIE: "sessionCookie";
+};
+/**
+ * HTTP method mapping for RESTful controller methods
+ * Maps controller method names to HTTP verbs and path patterns
+ */
+export declare const HTTP_METHODS: {
+    readonly index: {
+        readonly method: "get";
+        readonly path: "";
+    };
+    readonly show: {
+        readonly method: "get";
+        readonly path: "/:id";
+    };
+    readonly create: {
+        readonly method: "post";
+        readonly path: "";
+    };
+    readonly update: {
+        readonly method: "put";
+        readonly path: "/:id";
+    };
+    readonly patch: {
+        readonly method: "patch";
+        readonly path: "/:id";
+    };
+    readonly destroy: {
+        readonly method: "delete";
+        readonly path: "/:id";
+    };
+};
+/**
+ * Default success status codes for RESTful controller methods
+ * Used by @Route() decorator to auto-derive response status
+ */
+export declare const METHOD_STATUS_CODES: {
+    readonly index: 200;
+    readonly show: 200;
+    readonly create: 201;
+    readonly update: 200;
+    readonly patch: 200;
+    readonly destroy: 200;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/router/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/router/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;CAGW,CAAA;AAE3C;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;CAOtB,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;CAInB,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;CAOf,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;CAOtB,CAAA"}

package/dist/router/constants.js

@@ -0,0 +1,54 @@
+/**
+ * Type-safe context keys for Hono router variables
+ * Using symbols to avoid string collisions
+ */
+export const ROUTER_CONTEXT_KEYS = {
+    REQUEST_CONTAINER: 'requestContainer',
+    LOCALE: 'locale'
+};
+/**
+ * Metadata keys for storing route and controller configuration
+ * Using symbols to avoid collisions with other decorators
+ */
+export const ROUTE_METADATA_KEYS = {
+    CONTROLLER_ROUTE: Symbol('controller:route'),
+    CONTROLLER_OPTIONS: Symbol('controller:options'),
+    CONTROLLER_MIDDLEWARES: Symbol('controller:middlewares'),
+    ROUTE_CONFIG: Symbol('route:config'),
+    DECORATED_METHODS: Symbol('decorated:methods'),
+    AUTH_GUARD: Symbol('auth:guard')
+};
+/**
+ * Security scheme identifiers for OpenAPI
+ * These reference the security scheme definitions in security.schemas.ts
+ */
+export const SECURITY_SCHEMES = {
+    BEARER_AUTH: 'bearerAuth',
+    API_KEY: 'apiKey',
+    SESSION_COOKIE: 'sessionCookie'
+};
+/**
+ * HTTP method mapping for RESTful controller methods
+ * Maps controller method names to HTTP verbs and path patterns
+ */
+export const HTTP_METHODS = {
+    index: { method: 'get', path: '' },
+    show: { method: 'get', path: '/:id' },
+    create: { method: 'post', path: '' },
+    update: { method: 'put', path: '/:id' },
+    patch: { method: 'patch', path: '/:id' },
+    destroy: { method: 'delete', path: '/:id' }
+};
+/**
+ * Default success status codes for RESTful controller methods
+ * Used by @Route() decorator to auto-derive response status
+ */
+export const METHOD_STATUS_CODES = {
+    index: 200,
+    show: 200,
+    create: 201,
+    update: 200,
+    patch: 200,
+    destroy: 200
+};
+//# sourceMappingURL=constants.js.map

package/dist/router/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/router/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,iBAAiB,EAAE,kBAAkB;IACrC,MAAM,EAAE,QAAQ;CACyB,CAAA;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,gBAAgB,EAAE,MAAM,CAAC,kBAAkB,CAAC;IAC5C,kBAAkB,EAAE,MAAM,CAAC,oBAAoB,CAAC;IAChD,sBAAsB,EAAE,MAAM,CAAC,wBAAwB,CAAC;IACxD,YAAY,EAAE,MAAM,CAAC,cAAc,CAAC;IACpC,iBAAiB,EAAE,MAAM,CAAC,mBAAmB,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC;CACxB,CAAA;AAEV;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,WAAW,EAAE,YAAY;IACzB,OAAO,EAAE,QAAQ;IACjB,cAAc,EAAE,eAAe;CACvB,CAAA;AAEV;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAW;IAC3C,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAW;IAC9C,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAW;IAC7C,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAW;IAChD,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAW;IACjD,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAW;CAC5C,CAAA;AAEV;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,GAAG;IACX,MAAM,EAAE,GAAG;IACX,KAAK,EAAE,GAAG;IACV,OAAO,EAAE,GAAG;CACJ,CAAA"}

package/dist/router/controller.d.ts

@@ -0,0 +1,56 @@
+import type { RouterContext } from './router-context';
+/**
+ * Controller interface for handling HTTP requests
+ *
+ * Controllers can implement RESTful methods or a custom handle() method.
+ * The route for the controller is set via the @Controller decorator.
+ *
+ * RESTful methods auto-map to HTTP verbs:
+ * - index() → GET /route
+ * - show() → GET /route/:id
+ * - create() → POST /route
+ * - update() → PUT /route/:id
+ * - patch() → PATCH /route/:id
+ * - destroy() → DELETE /route/:id
+ *
+ * For non-RESTful routes (wildcards, custom patterns), implement handle()
+ */
+export interface IController {
+    /**
+     * GET /route
+     * List all resources
+     */
+    index?(ctx: RouterContext): Promise<Response> | Response;
+    /**
+     * GET /route/:id
+     * Show a specific resource
+     */
+    show?(ctx: RouterContext): Promise<Response> | Response;
+    /**
+     * POST /route
+     * Create a new resource
+     */
+    create?(ctx: RouterContext): Promise<Response> | Response;
+    /**
+     * PUT /route/:id
+     * Update a resource (full replacement)
+     */
+    update?(ctx: RouterContext): Promise<Response> | Response;
+    /**
+     * PATCH /route/:id
+     * Patch a resource (partial update)
+     */
+    patch?(ctx: RouterContext): Promise<Response> | Response;
+    /**
+     * DELETE /route/:id
+     * Delete a resource
+     */
+    destroy?(ctx: RouterContext): Promise<Response> | Response;
+    /**
+     * Custom handler for non-RESTful routes
+     * Use this for wildcards (e.g., /api/v1/auth/*) or custom patterns
+     * Takes precedence over RESTful methods if defined
+     */
+    handle?(ctx: RouterContext): Promise<Response> | Response;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/router/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/router/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,KAAK,CAAC,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAA;IAExD;;;OAGG;IACH,IAAI,CAAC,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAA;IAEvD;;;OAGG;IACH,MAAM,CAAC,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAA;IAEzD;;;OAGG;IACH,MAAM,CAAC,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAA;IAEzD;;;OAGG;IACH,KAAK,CAAC,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAA;IAExD;;;OAGG;IACH,OAAO,CAAC,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAA;IAE1D;;;;OAIG;IACH,MAAM,CAAC,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAA;CAC1D"}

package/dist/router/controller.js

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

package/dist/router/controller.js.map

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

package/dist/router/decorators/controller.decorator.d.ts

@@ -0,0 +1,55 @@
+import { type Constructor } from '../../types';
+import type { ControllerOptions } from '../types';
+/**
+ * Base controller decorator for route registration
+ *
+ * This is the core controller decorator that handles:
+ * - Transient scope registration (request-scoped)
+ * - Route metadata storage
+ * - Controller options (tags, security schemes, hideFromDocs)
+ *
+ * NOTE: This decorator does NOT set route access context.
+ * For multi-tenant applications, use the decorators from tenancy module:
+ * - @Controller (from tenancy) - Landlord-only routes
+ * - @TenantController - Tenant-only routes
+ * - @UniversalController - Routes accessible from both domains
+ *
+ * @param route - Base route for this controller (e.g., '/api/v1/users')
+ * @param options - Optional configuration (tags, security schemes, hideFromDocs)
+ *
+ * @example Single-tenant application (no tenancy module)
+ * ```typescript
+ * import { Controller } from 'stratal/router'
+ *
+ * @Controller('/api/v1/users', { tags: ['Users'] })
+ * export class UsersController implements IController {
+ *   // All routes accessible (no access context filtering)
+ * }
+ * ```
+ *
+ * @example Multi-tenant application (use tenancy decorators instead)
+ * ```typescript
+ * import { Controller } from 'stratal/tenancy'
+ *
+ * @Controller('/api/v1/tenants', { tags: ['Tenants'] })
+ * export class TenantsController implements IController {
+ *   // Only accessible from landlord domain
+ * }
+ * ```
+ */
+export declare function Controller(route: string, options?: ControllerOptions): <T extends Constructor>(target: T) => T;
+/**
+ * Get the route from controller class metadata
+ *
+ * @param target - Controller class or instance
+ * @returns Route string or undefined if not set
+ */
+export declare function getControllerRoute(target: object): string | undefined;
+/**
+ * Get the options from controller class metadata
+ *
+ * @param target - Controller class or instance
+ * @returns Controller options or undefined if not set
+ */
+export declare function getControllerOptions(target: object): ControllerOptions | undefined;
+//# sourceMappingURL=controller.decorator.d.ts.map

package/dist/router/decorators/controller.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.decorator.d.ts","sourceRoot":"","sources":["../../../src/router/decorators/controller.decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAIjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,IAClD,CAAC,SAAS,WAAW,EAAE,QAAQ,CAAC,OAclD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKrE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAGlF"}

package/dist/router/decorators/controller.decorator.js

@@ -0,0 +1,76 @@
+import { Transient } from '../../di/decorators';
+import { ROUTE_METADATA_KEYS } from '../constants';
+const CONTROLLER_ROUTE_KEY = ROUTE_METADATA_KEYS.CONTROLLER_ROUTE;
+/**
+ * Base controller decorator for route registration
+ *
+ * This is the core controller decorator that handles:
+ * - Transient scope registration (request-scoped)
+ * - Route metadata storage
+ * - Controller options (tags, security schemes, hideFromDocs)
+ *
+ * NOTE: This decorator does NOT set route access context.
+ * For multi-tenant applications, use the decorators from tenancy module:
+ * - @Controller (from tenancy) - Landlord-only routes
+ * - @TenantController - Tenant-only routes
+ * - @UniversalController - Routes accessible from both domains
+ *
+ * @param route - Base route for this controller (e.g., '/api/v1/users')
+ * @param options - Optional configuration (tags, security schemes, hideFromDocs)
+ *
+ * @example Single-tenant application (no tenancy module)
+ * ```typescript
+ * import { Controller } from 'stratal/router'
+ *
+ * @Controller('/api/v1/users', { tags: ['Users'] })
+ * export class UsersController implements IController {
+ *   // All routes accessible (no access context filtering)
+ * }
+ * ```
+ *
+ * @example Multi-tenant application (use tenancy decorators instead)
+ * ```typescript
+ * import { Controller } from 'stratal/tenancy'
+ *
+ * @Controller('/api/v1/tenants', { tags: ['Tenants'] })
+ * export class TenantsController implements IController {
+ *   // Only accessible from landlord domain
+ * }
+ * ```
+ */
+export function Controller(route, options) {
+    return function (target) {
+        // Wrap @Transient (handles @injectable and scope metadata)
+        Transient()(target);
+        // Store route metadata on the class
+        Reflect.defineMetadata(CONTROLLER_ROUTE_KEY, route, target);
+        // Store options metadata if provided
+        if (options) {
+            Reflect.defineMetadata(ROUTE_METADATA_KEYS.CONTROLLER_OPTIONS, options, target);
+        }
+        return target;
+    };
+}
+/**
+ * Get the route from controller class metadata
+ *
+ * @param target - Controller class or instance
+ * @returns Route string or undefined if not set
+ */
+export function getControllerRoute(target) {
+    // Check if target is a class constructor (function) or an instance
+    // If class, get metadata from it directly; if instance, get from constructor
+    const metadataTarget = typeof target === 'function' ? target : target.constructor;
+    return Reflect.getMetadata(CONTROLLER_ROUTE_KEY, metadataTarget);
+}
+/**
+ * Get the options from controller class metadata
+ *
+ * @param target - Controller class or instance
+ * @returns Controller options or undefined if not set
+ */
+export function getControllerOptions(target) {
+    const metadataTarget = typeof target === 'function' ? target : target.constructor;
+    return Reflect.getMetadata(ROUTE_METADATA_KEYS.CONTROLLER_OPTIONS, metadataTarget);
+}
+//# sourceMappingURL=controller.decorator.js.map

package/dist/router/decorators/controller.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.decorator.js","sourceRoot":"","sources":["../../../src/router/decorators/controller.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAE/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAGlD,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,gBAAgB,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,OAA2B;IACnE,OAAO,UAAiC,MAAS;QAC/C,2DAA2D;QAC3D,SAAS,EAAE,CAAC,MAAM,CAAC,CAAA;QAEnB,oCAAoC;QACpC,OAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;QAE3D,qCAAqC;QACrC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;QACjF,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,mEAAmE;IACnE,6EAA6E;IAC7E,MAAM,cAAc,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,MAAkC,CAAC,WAAW,CAAA;IAC9G,OAAO,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,cAAc,CAAuB,CAAA;AACxF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,MAAM,cAAc,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,MAAkC,CAAC,WAAW,CAAA;IAC9G,OAAO,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,cAAc,CAAkC,CAAA;AACrH,CAAC"}

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

@@ -0,0 +1,3 @@
+export { Controller, getControllerOptions, getControllerRoute } from './controller.decorator';
+export { getDecoratedMethods, getRouteConfig, Route } from './route.decorator';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/router/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAAE,oBAAoB,EAAE,kBAAkB,EACrD,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/router/decorators/index.js

@@ -0,0 +1,7 @@
+export { Controller, getControllerOptions, getControllerRoute } from './controller.decorator';
+export { getDecoratedMethods, getRouteConfig, Route } from './route.decorator';
+// Guards are now exported from core/guards module
+// Use: import { UseGuards, AuthGuard } from 'stratal/guards'
+// TenantController and UniversalController are now exported from tenancy module
+// Use: import { TenantController, UniversalController } from 'stratal/tenancy'
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/router/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAAE,oBAAoB,EAAE,kBAAkB,EACrD,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAE9E,kDAAkD;AAClD,6DAA6D;AAE7D,gFAAgF;AAChF,+EAA+E"}