stratal 0.0.1

package/dist/router/router.tokens.js

@@ -0,0 +1,39 @@
+/**
+ * Dependency injection tokens for the router system
+ *
+ * Controllers and middlewares are exposed via module methods (getControllers() and getMiddlewares())
+ * rather than DI tokens. The Application collects them by iterating through modules.
+ *
+ * ## Service Instantiation Pattern
+ *
+ * Router services (RouteRegistrationService, OpenAPIService) are manually instantiated in RouterService
+ * rather than resolved from the DI container. This is intentional and provides several benefits:
+ *
+ * 1. **Lifecycle Control**: Services are created once during router initialization and reused across
+ *    all requests, ensuring singleton behavior without relying on DI container scope management.
+ *
+ * 2. **Performance**: Avoiding container resolution on each request reduces overhead. These services
+ *    don't need request-scoped data and can safely be singletons.
+ *
+ * 3. **Dependency Injection Still Works**: Constructor injection still works perfectly - the container
+ *    resolves dependencies (like Logger) when we call `new RouteRegistrationService()`. We're only
+ *    bypassing the container for the top-level service itself.
+ *
+ * 4. **Clarity**: Makes it explicit that these are singleton services that manage router configuration,
+ *    not request-scoped services that handle individual requests.
+ *
+ * This pattern is safe and recommended for stateless utility services that don't need request context.
+ * Request-scoped services (like controllers) are still resolved from the container on each request.
+ */
+export const ROUTER_TOKENS = {
+    /**
+     * Token for RouterService singleton
+     */
+    RouterService: Symbol.for('RouterService'),
+    /**
+     * Token for RouterContext (request-scoped)
+     * Contains Hono context wrapper with helper methods
+     */
+    RouterContext: Symbol.for('RouterContext'),
+};
+//# sourceMappingURL=router.tokens.js.map

package/dist/router/router.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.tokens.js","sourceRoot":"","sources":["../../src/router/router.tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC;IAE1C;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC;CAClC,CAAA"}

package/dist/router/schemas/common.schemas.d.ts

@@ -0,0 +1,148 @@
+import { z } from '../../i18n/validation';
+/**
+ * Common OpenAPI Schemas
+ *
+ * Reusable schema definitions for common API patterns:
+ * - Error responses
+ * - Pagination
+ * - Common parameters
+ */
+/**
+ * Generic error response schema
+ * Used for all error responses (4xx, 5xx)
+ * Matches ApplicationError.toErrorResponse() structure
+ */
+export declare const errorResponseSchema: z.ZodObject<{
+    code: z.ZodNumber;
+    message: z.ZodString;
+    timestamp: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    stack: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Validation error response schema
+ * Used for 400 Bad Request with validation failures
+ * Matches ApplicationError.toErrorResponse() structure with validation-specific metadata
+ */
+export declare const validationErrorResponseSchema: z.ZodObject<{
+    code: z.ZodNumber;
+    message: z.ZodString;
+    timestamp: z.ZodString;
+    metadata: z.ZodObject<{
+        issues: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            message: z.ZodString;
+            code: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    stack: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Pagination query parameters schema
+ * Used for list endpoints
+ */
+export declare const paginationQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+/**
+ * Paginated response wrapper schema
+ * Generic wrapper for paginated list responses
+ */
+export declare const paginatedResponseSchema: <T extends z.ZodType>(itemSchema: T) => z.ZodObject<{
+    data: z.ZodArray<T>;
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        limit: z.ZodNumber;
+        total: z.ZodNumber;
+        totalPages: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * UUID parameter schema
+ * Used for :id parameters in RESTful routes
+ */
+export declare const uuidParamSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Success message response schema
+ * Used for operations that don't return data (e.g., DELETE)
+ */
+export declare const successMessageSchema: z.ZodObject<{
+    message: z.ZodString;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Common HTTP status error schemas
+ * Pre-configured for standard error responses
+ */
+export declare const commonErrorSchemas: {
+    readonly 400: {
+        readonly schema: z.ZodObject<{
+            code: z.ZodNumber;
+            message: z.ZodString;
+            timestamp: z.ZodString;
+            metadata: z.ZodObject<{
+                issues: z.ZodArray<z.ZodObject<{
+                    path: z.ZodString;
+                    message: z.ZodString;
+                    code: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+            stack: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly description: "Validation error";
+    };
+    readonly 401: {
+        readonly schema: z.ZodObject<{
+            code: z.ZodNumber;
+            message: z.ZodString;
+            timestamp: z.ZodString;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            stack: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly description: "Unauthorized";
+    };
+    readonly 403: {
+        readonly schema: z.ZodObject<{
+            code: z.ZodNumber;
+            message: z.ZodString;
+            timestamp: z.ZodString;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            stack: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly description: "Forbidden";
+    };
+    readonly 404: {
+        readonly schema: z.ZodObject<{
+            code: z.ZodNumber;
+            message: z.ZodString;
+            timestamp: z.ZodString;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            stack: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly description: "Not found";
+    };
+    readonly 409: {
+        readonly schema: z.ZodObject<{
+            code: z.ZodNumber;
+            message: z.ZodString;
+            timestamp: z.ZodString;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            stack: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly description: "Conflict";
+    };
+    readonly 500: {
+        readonly schema: z.ZodObject<{
+            code: z.ZodNumber;
+            message: z.ZodString;
+            timestamp: z.ZodString;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            stack: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly description: "Internal server error";
+    };
+};
+//# sourceMappingURL=common.schemas.d.ts.map

package/dist/router/schemas/common.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.schemas.d.ts","sourceRoot":"","sources":["../../../src/router/schemas/common.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,uBAAuB,CAAA;AAEzC;;;;;;;GAOG;AAEH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;;iBAML,CAAA;AAE3B;;;;GAIG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;iBAYL,CAAA;AAErC;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;iBAGL,CAAA;AAE7B;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC;;;;;;;;iBAStE,CAAA;AAEJ;;;GAGG;AACH,eAAO,MAAM,eAAe;;iBAEL,CAAA;AAEvB;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;iBAGL,CAAA;AAE5B;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOrB,CAAA"}

package/dist/router/schemas/common.schemas.js

@@ -0,0 +1,88 @@
+import { z } from '../../i18n/validation';
+/**
+ * Common OpenAPI Schemas
+ *
+ * Reusable schema definitions for common API patterns:
+ * - Error responses
+ * - Pagination
+ * - Common parameters
+ */
+/**
+ * Generic error response schema
+ * Used for all error responses (4xx, 5xx)
+ * Matches ApplicationError.toErrorResponse() structure
+ */
+export const errorResponseSchema = z.object({
+    code: z.number().int().describe('Application error code'),
+    message: z.string().describe('Human-readable error message'),
+    timestamp: z.string().datetime().describe('ISO timestamp when error occurred'),
+    metadata: z.record(z.string(), z.unknown()).optional().describe('Additional error context'),
+    stack: z.string().optional().describe('Stack trace (development only)')
+}).openapi('ErrorResponse');
+/**
+ * Validation error response schema
+ * Used for 400 Bad Request with validation failures
+ * Matches ApplicationError.toErrorResponse() structure with validation-specific metadata
+ */
+export const validationErrorResponseSchema = z.object({
+    code: z.number().int().describe('Application error code'),
+    message: z.string().describe('Human-readable error message'),
+    timestamp: z.string().datetime().describe('ISO timestamp when error occurred'),
+    metadata: z.object({
+        issues: z.array(z.object({
+            path: z.string().describe('Field path that failed validation'),
+            message: z.string().describe('Validation failure message'),
+            code: z.string().describe('Zod validation error code')
+        }))
+    }).describe('Validation error details'),
+    stack: z.string().optional().describe('Stack trace (development only)')
+}).openapi('ValidationErrorResponse');
+/**
+ * Pagination query parameters schema
+ * Used for list endpoints
+ */
+export const paginationQuerySchema = z.object({
+    page: z.coerce.number().int().positive().default(1).describe('Page number (1-indexed)'),
+    limit: z.coerce.number().int().positive().max(100).default(20).describe('Items per page (max 100)')
+}).openapi('PaginationQuery');
+/**
+ * Paginated response wrapper schema
+ * Generic wrapper for paginated list responses
+ */
+export const paginatedResponseSchema = (itemSchema) => z.object({
+    data: z.array(itemSchema).describe('Array of items for current page'),
+    pagination: z.object({
+        page: z.number().int().positive().describe('Current page number'),
+        limit: z.number().int().positive().describe('Items per page'),
+        total: z.number().int().nonnegative().describe('Total number of items'),
+        totalPages: z.number().int().nonnegative().describe('Total number of pages')
+    })
+});
+/**
+ * UUID parameter schema
+ * Used for :id parameters in RESTful routes
+ */
+export const uuidParamSchema = z.object({
+    id: z.string().uuid().describe('Resource UUID')
+}).openapi('UUIDParam');
+/**
+ * Success message response schema
+ * Used for operations that don't return data (e.g., DELETE)
+ */
+export const successMessageSchema = z.object({
+    message: z.string().describe('Success message'),
+    data: z.record(z.string(), z.unknown()).optional().describe('Optional additional data')
+}).openapi('SuccessMessage');
+/**
+ * Common HTTP status error schemas
+ * Pre-configured for standard error responses
+ */
+export const commonErrorSchemas = {
+    400: { schema: validationErrorResponseSchema, description: 'Validation error' },
+    401: { schema: errorResponseSchema, description: 'Unauthorized' },
+    403: { schema: errorResponseSchema, description: 'Forbidden' },
+    404: { schema: errorResponseSchema, description: 'Not found' },
+    409: { schema: errorResponseSchema, description: 'Conflict' },
+    500: { schema: errorResponseSchema, description: 'Internal server error' }
+};
+//# sourceMappingURL=common.schemas.js.map

package/dist/router/schemas/common.schemas.js.map

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

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

@@ -0,0 +1,2 @@
+export { commonErrorSchemas, errorResponseSchema, paginatedResponseSchema, paginationQuerySchema, successMessageSchema, uuidParamSchema, validationErrorResponseSchema } from './common.schemas';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/router/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,eAAe,EAAE,6BAA6B,EAC9J,MAAM,kBAAkB,CAAC"}

package/dist/router/schemas/index.js

@@ -0,0 +1,2 @@
+export { commonErrorSchemas, errorResponseSchema, paginatedResponseSchema, paginationQuerySchema, successMessageSchema, uuidParamSchema, validationErrorResponseSchema } from './common.schemas';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/router/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,eAAe,EAAE,6BAA6B,EAC9J,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Router services index
+ * Exports all specialized router services
+ */
+export { RequestScopeService } from './request-scope.service';
+export { RouteRegistrationService } from './route-registration.service';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/router/services/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAA"}

package/dist/router/services/index.js

@@ -0,0 +1,7 @@
+/**
+ * Router services index
+ * Exports all specialized router services
+ */
+export { RequestScopeService } from './request-scope.service';
+export { RouteRegistrationService } from './route-registration.service';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/router/services/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAA"}

package/dist/router/services/request-scope.service.d.ts

@@ -0,0 +1,44 @@
+import type { OpenAPIHono } from '../../i18n/validation';
+import { Container } from '../../di';
+import type { RouterEnv } from '../types';
+/**
+ * Request Scope Service
+ *
+ * Manages request-scoped container setup and lifecycle.
+ * Creates context-enriched instances of @RequestScoped services.
+ *
+ * **Two-Tier Container Architecture:**
+ * ```
+ * Container (manages global container)
+ *        ↓
+ *   container.createRequestScope(routerContext)
+ *        ↓
+ * Request Container (child, per request)
+ *        ↓
+ *   Context-enriched instances via withContext(routerContext)
+ * ```
+ *
+ * **Responsibilities:**
+ * - Setup request-scoped container middleware
+ * - Create context-enriched instances of @RequestScoped services
+ *
+ * **Note:**
+ * - AuthContext registration is handled by AuthModule's AuthContextMiddleware
+ * - Locale extraction is handled by I18nModule's LocaleExtractionMiddleware
+ * - Zod i18n context is handled by I18nModule's I18nContextMiddleware
+ * - Session verification is handled by AuthModule's SessionVerificationMiddleware
+ * - Tenant-specific setup (TenancyContext, TenancyDatabaseService) is handled
+ *   by TenancyScopeMiddleware from the tenancy module
+ */
+export declare class RequestScopeService {
+    private readonly container;
+    constructor(container: Container);
+    /**
+     * Setup request-scoped container middleware
+     *
+     * This MUST run before all other middleware and routes.
+     * Creates a child container with context-enriched service instances.
+     */
+    setupMiddleware(app: OpenAPIHono<RouterEnv>): void;
+}
+//# sourceMappingURL=request-scope.service.d.ts.map

package/dist/router/services/request-scope.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-scope.service.d.ts","sourceRoot":"","sources":["../../../src/router/services/request-scope.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,EAAE,SAAS,EAAmB,MAAM,UAAU,CAAA;AAIrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBACa,mBAAmB;IAG5B,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAGvC;;;;;OAKG;IACH,eAAe,CAAC,GAAG,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,IAAI;CAgBnD"}

package/dist/router/services/request-scope.service.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 { Container, CONTAINER_TOKEN } from '../../di';
+import { Transient } from '../../di/decorators';
+import { ROUTER_CONTEXT_KEYS } from '../constants';
+import { RouterContext } from '../router-context';
+/**
+ * Request Scope Service
+ *
+ * Manages request-scoped container setup and lifecycle.
+ * Creates context-enriched instances of @RequestScoped services.
+ *
+ * **Two-Tier Container Architecture:**
+ * ```
+ * Container (manages global container)
+ *        ↓
+ *   container.createRequestScope(routerContext)
+ *        ↓
+ * Request Container (child, per request)
+ *        ↓
+ *   Context-enriched instances via withContext(routerContext)
+ * ```
+ *
+ * **Responsibilities:**
+ * - Setup request-scoped container middleware
+ * - Create context-enriched instances of @RequestScoped services
+ *
+ * **Note:**
+ * - AuthContext registration is handled by AuthModule's AuthContextMiddleware
+ * - Locale extraction is handled by I18nModule's LocaleExtractionMiddleware
+ * - Zod i18n context is handled by I18nModule's I18nContextMiddleware
+ * - Session verification is handled by AuthModule's SessionVerificationMiddleware
+ * - Tenant-specific setup (TenancyContext, TenancyDatabaseService) is handled
+ *   by TenancyScopeMiddleware from the tenancy module
+ */
+let RequestScopeService = class RequestScopeService {
+    container;
+    constructor(container) {
+        this.container = container;
+    }
+    /**
+     * Setup request-scoped container middleware
+     *
+     * This MUST run before all other middleware and routes.
+     * Creates a child container with context-enriched service instances.
+     */
+    setupMiddleware(app) {
+        app.use('*', async (c, next) => {
+            // Create RouterContext
+            const routerContext = new RouterContext(c);
+            // Create request scope using Container
+            const requestContainer = this.container.createRequestScope(routerContext);
+            // Store in Hono context
+            c.set(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER, requestContainer);
+            // Run request within AsyncLocalStorage context
+            // Cleanup is automatic in runWithContextStore
+            await requestContainer.runWithContextStore(() => next());
+        });
+    }
+};
+RequestScopeService = __decorate([
+    Transient(),
+    __param(0, inject(CONTAINER_TOKEN)),
+    __metadata("design:paramtypes", [Container])
+], RequestScopeService);
+export { RequestScopeService };
+//# sourceMappingURL=request-scope.service.js.map

package/dist/router/services/request-scope.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-scope.service.js","sourceRoot":"","sources":["../../../src/router/services/request-scope.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAGX;IAFnB,YAEmB,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IACpC,CAAC;IAEJ;;;;;OAKG;IACH,eAAe,CAAC,GAA2B;QACzC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;YAC7B,uBAAuB;YACvB,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,CAAuB,CAAC,CAAA;YAEhE,uCAAuC;YACvC,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAA;YAEzE,wBAAwB;YACxB,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAA;YAE9D,+CAA+C;YAC/C,8CAA8C;YAC9C,MAAM,gBAAgB,CAAC,mBAAmB,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAA;QAC1D,CAAC,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AA5BY,mBAAmB;IAD/B,SAAS,EAAE;IAGP,WAAA,MAAM,CAAC,eAAe,CAAC,CAAA;qCACI,SAAS;GAH5B,mBAAmB,CA4B/B"}

package/dist/router/services/route-registration.service.d.ts

@@ -0,0 +1,94 @@
+import type { OpenAPIHono } from '../../i18n/validation';
+import { type LoggerService } from '../../logger';
+import type { Constructor } from '../../types';
+import type { IController } from '../controller';
+import type { RouterEnv } from '../types';
+/**
+ * Route registration service
+ * Manages controller and route registration with OpenAPI support
+ *
+ * Responsibilities:
+ * - Register RESTful controllers with OpenAPI metadata
+ * - Auto-derive HTTP methods/paths from controller method names
+ * - Build OpenAPI route configurations with guard execution
+ * - Validate all controllers have access decorators (strict mode)
+ * - Create controller handlers with DI resolution
+ */
+export declare class RouteRegistrationService {
+    private logger;
+    private controllerClasses;
+    constructor(logger: LoggerService);
+    /**
+     * Configure router with controllers
+     *
+     * @param app - OpenAPIHono application instance
+     * @param controllers - Array of controller classes from modules
+     */
+    configure(app: OpenAPIHono<RouterEnv>, controllers: Constructor<IController>[]): void;
+    /**
+     * Register a single controller with all its routes
+     * Validates that controller has access decorator (strict mode)
+     */
+    private registerController;
+    /**
+     * Create a guard execution middleware
+     *
+     * This middleware executes all guards for a route before the handler.
+     * Guards are executed in order; all must pass for the request to proceed.
+     *
+     * @param guards - Array of guards to execute
+     * @returns Hono middleware function
+     */
+    private createGuardMiddleware;
+    /**
+     * Register wildcard route for non-RESTful controllers
+     */
+    private registerWildcardRoute;
+    /**
+     * Register OpenAPI routes with metadata
+     */
+    private registerOpenAPIRoutes;
+    /**
+     * Register route without OpenAPI metadata (for hidden routes)
+     * Route is functional but won't appear in documentation
+     */
+    private registerRouteWithoutOpenAPI;
+    /**
+     * Register traditional RESTful routes without OpenAPI
+     */
+    private registerRESTfulRoutes;
+    /**
+     * Auto-derive HTTP method and path from controller method name
+     * Uses HTTP_METHODS constant for RESTful convention mapping
+     */
+    private deriveHttpMethodAndPath;
+    /**
+     * Merge controller-level and route-level metadata
+     * Tags are merged (appended), security is merged (union)
+     * Guards automatically add sessionCookie security if present
+     */
+    private mergeMetadata;
+    /**
+     * Build OpenAPI route configuration from metadata
+     * Creates a route definition compatible with @hono/zod-openapi
+     * Includes guard execution for proper access control
+     *
+     * Execution order: Global middlewares → Guards → Handler
+     */
+    private buildOpenAPIRoute;
+    /**
+     * Resolve method parameter injections from the container
+     *
+     * @param prototype - Controller prototype
+     * @param methodName - Method name to get injections for
+     * @param container - Request-scoped container
+     * @returns Array of resolved dependencies in parameter order
+     */
+    private resolveMethodInjections;
+    /**
+     * Create controller handler that resolves controller from request-scoped container
+     * This ensures each request gets a fresh controller with request-scoped context
+     */
+    private createControllerHandler;
+}
+//# sourceMappingURL=route-registration.service.d.ts.map

package/dist/router/services/route-registration.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-registration.service.d.ts","sourceRoot":"","sources":["../../../src/router/services/route-registration.service.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAchD,OAAO,KAAK,EAKV,SAAS,EAEV,MAAM,UAAU,CAAA;AAEjB;;;;;;;;;;GAUG;AACH,qBAAa,wBAAwB;IAIjC,OAAO,CAAC,MAAM;IAHhB,OAAO,CAAC,iBAAiB,CAA8C;gBAG7D,MAAM,EAAE,aAAa;IAG/B;;;;;OAKG;IACH,SAAS,CACP,GAAG,EAAE,WAAW,CAAC,SAAS,CAAC,EAC3B,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC,EAAE,GACtC,IAAI;IAwBP;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAkC1B;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA6F7B;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IA+CnC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAU/B;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAuCrB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAiHzB;;;;;;;OAOG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;CAsChC"}