stratal 0.0.1

package/dist/router/middleware/logger.middleware.js

@@ -0,0 +1,32 @@
+/**
+ * Create a Hono middleware that logs HTTP requests using our Logger service
+ *
+ * Logs request method, path, status code, and duration in milliseconds.
+ * Format: [HTTP] METHOD /path -> STATUS (duration ms)
+ *
+ * @param logger - Logger service instance
+ * @returns Hono middleware handler
+ *
+ * @example
+ * ```typescript
+ * const logger = container.resolve<LoggerService>(LOGGER_TOKENS.LoggerService)
+ * app.use('*', createLoggerMiddleware(logger))
+ * ```
+ */
+export function createLoggerMiddleware(logger) {
+    return async (c, next) => {
+        const start = Date.now();
+        const method = c.req.method;
+        const path = c.req.path;
+        await next();
+        const duration = Date.now() - start;
+        const status = c.res.status;
+        logger.info(`[HTTP] ${method} ${path} -> ${status}`, {
+            method,
+            path,
+            status,
+            duration,
+        });
+    };
+}
+//# sourceMappingURL=logger.middleware.js.map

package/dist/router/middleware/logger.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.middleware.js","sourceRoot":"","sources":["../../../src/router/middleware/logger.middleware.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAqB;IAC1D,OAAO,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACxB,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAA;QAC3B,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAA;QAEvB,MAAM,IAAI,EAAE,CAAA;QAEZ,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAA;QACnC,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAA;QAE3B,MAAM,CAAC,IAAI,CAAC,UAAU,MAAM,IAAI,IAAI,OAAO,MAAM,EAAE,EAAE;YACnD,MAAM;YACN,IAAI;YACJ,MAAM;YACN,QAAQ;SACT,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC"}

package/dist/router/middleware.interface.d.ts

@@ -0,0 +1,38 @@
+import type { RouterContext } from './router-context';
+/**
+ * Middleware interface for request processing
+ *
+ * Middlewares use the `@Transient()` decorator and are registered via
+ * the `configure(consumer)` method in modules implementing `MiddlewareConfigurable`.
+ *
+ * @example
+ * ```typescript
+ * @Transient()
+ * export class LoggingMiddleware implements Middleware {
+ *   async handle(ctx: RouterContext, next: () => Promise<void>): Promise<void> {
+ *     const start = Date.now()
+ *     await next()
+ *     console.log(`Request took ${Date.now() - start}ms`)
+ *   }
+ * }
+ *
+ * // Register in module:
+ * @Module({ providers: [...] })
+ * export class AppModule implements MiddlewareConfigurable {
+ *   configure(consumer: MiddlewareConsumer): void {
+ *     consumer.apply(LoggingMiddleware).forRoutes('*')
+ *   }
+ * }
+ * ```
+ */
+export interface Middleware {
+    /**
+     * Handle middleware logic
+     * Call next() to continue the middleware chain
+     *
+     * @param ctx - Router context with request/response helpers
+     * @param next - Function to call the next middleware or route handler
+     */
+    handle(ctx: RouterContext, next: () => Promise<void>): Promise<void>;
+}
+//# sourceMappingURL=middleware.interface.d.ts.map

package/dist/router/middleware.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.interface.d.ts","sourceRoot":"","sources":["../../src/router/middleware.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACrE"}

package/dist/router/middleware.interface.js

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

package/dist/router/middleware.interface.js.map

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

package/dist/router/router-context.d.ts

@@ -0,0 +1,117 @@
+import type { Context } from 'hono';
+import { type ContentfulStatusCode, type RedirectStatusCode } from 'hono/utils/http-status';
+import type { Container } from '../di/container';
+import type { RouterEnv } from './types';
+type ContextQueryResult<R extends Record<string, unknown> | undefined, K extends string | undefined> = K extends string ? string : R;
+/**
+ * Router context wrapper with helper methods
+ *
+ * Provides convenient access to Hono's context and common request/response operations.
+ * The native Hono context is available via the `c` property for advanced use cases.
+ *
+ * @example
+ * ```typescript
+ * async index(ctx: RouterContext): Promise<Response> {
+ *   // Use helper methods
+ *   const users = await this.service.findAll()
+ *   return ctx.json(users)
+ * }
+ *
+ * async show(ctx: RouterContext): Promise<Response> {
+ *   // Access route params
+ *   const id = ctx.param('id')
+ *   const user = await this.service.findById(id)
+ *   return ctx.json(user)
+ * }
+ *
+ * async create(ctx: RouterContext): Promise<Response> {
+ *   // Parse request body
+ *   const body = await ctx.body<CreateUserInput>()
+ *   const user = await this.service.create(body)
+ *   return ctx.json(user, 201)
+ * }
+ * ```
+ */
+export declare class RouterContext<T extends RouterEnv = RouterEnv> {
+    readonly c: Context<T>;
+    /**
+     * Native Hono context
+     * Access for advanced use cases not covered by helper methods
+     */
+    constructor(c: Context<T>);
+    /**
+     * Get request-scoped DI container
+     * Contains request-specific services and context (AuthContext)
+     *
+     * @throws Error if container not initialized
+     */
+    getContainer(): Container;
+    /**
+     * Set locale for the current request
+     * Locale is determined by X-Locale header or defaults to config
+     *
+     * @param locale - Locale code (e.g., 'en', 'fr')
+     */
+    setLocale(locale: string): void;
+    /**
+     * Get locale for the current request
+     *
+     * @returns Current locale code
+     */
+    getLocale(): string;
+    /**
+     * Return JSON response
+     *
+     * @param data - Data to serialize as JSON
+     * @param status - HTTP status code (default: 200)
+     */
+    json(data: object, status?: ContentfulStatusCode): Response;
+    /**
+     * Get route parameter value
+     *
+     * @param key - Parameter name (e.g., 'id' for /users/:id)
+     */
+    param(key: string): string;
+    /**
+     * Get query parameter value
+     *
+     * @param key - Query parameter name
+     */
+    query<R extends Record<string, unknown> | undefined = undefined, K extends string | undefined = undefined>(key?: K): ContextQueryResult<R, K>;
+    /**
+     * Get request header value
+     *
+     * @param name - Header name (case-insensitive)
+     */
+    header(name: string): string | undefined;
+    /**
+     * Get validated request body from OpenAPI route
+     * Returns pre-validated data that has passed schema validation
+     *
+     * @returns Validated JSON body
+     */
+    body<T>(): Promise<T>;
+    /**
+     * Return text response
+     *
+     * @param text - Text content
+     * @param status - HTTP status code (default: 200)
+     */
+    text(text: string, status?: ContentfulStatusCode): Response;
+    /**
+     * Return HTML response
+     *
+     * @param html - HTML content
+     * @param status - HTTP status code (default: 200)
+     */
+    html(html: string, status?: ContentfulStatusCode): Response;
+    /**
+     * Redirect to another URL
+     *
+     * @param url - Target URL
+     * @param status - HTTP status code (default: 302)
+     */
+    redirect(url: string, status?: RedirectStatusCode): Response;
+}
+export {};
+//# sourceMappingURL=router-context.d.ts.map

package/dist/router/router-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-context.d.ts","sourceRoot":"","sources":["../../src/router/router-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC,KAAK,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAAC,SAAS,MAAM,GAAG,SAAS,IAAI,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,CAAC,CAAA;AAEpI;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,aAAa,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;aAMtC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAL/B;;;OAGG;gBAEe,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAG/B;;;;;OAKG;IACH,YAAY,IAAI,SAAS;IAQzB;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;;;OAIG;IACH,SAAS,IAAI,MAAM;IAKnB;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,QAAQ;IAI3D;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI1B;;;;OAIG;IACH,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC,SAAS,MAAM,GAAG,SAAS,GAAG,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;IAK7I;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIxC;;;;;OAKG;IACH,IAAI,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;IAMrB;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,QAAQ;IAI3D;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,QAAQ;IAI3D;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,QAAQ;CAG7D"}

package/dist/router/router-context.js

@@ -0,0 +1,145 @@
+import { RequestContainerNotInitializedError } from '../infrastructure/errors';
+import { ROUTER_CONTEXT_KEYS } from './constants';
+/**
+ * Router context wrapper with helper methods
+ *
+ * Provides convenient access to Hono's context and common request/response operations.
+ * The native Hono context is available via the `c` property for advanced use cases.
+ *
+ * @example
+ * ```typescript
+ * async index(ctx: RouterContext): Promise<Response> {
+ *   // Use helper methods
+ *   const users = await this.service.findAll()
+ *   return ctx.json(users)
+ * }
+ *
+ * async show(ctx: RouterContext): Promise<Response> {
+ *   // Access route params
+ *   const id = ctx.param('id')
+ *   const user = await this.service.findById(id)
+ *   return ctx.json(user)
+ * }
+ *
+ * async create(ctx: RouterContext): Promise<Response> {
+ *   // Parse request body
+ *   const body = await ctx.body<CreateUserInput>()
+ *   const user = await this.service.create(body)
+ *   return ctx.json(user, 201)
+ * }
+ * ```
+ */
+export class RouterContext {
+    c;
+    /**
+     * Native Hono context
+     * Access for advanced use cases not covered by helper methods
+     */
+    constructor(c) {
+        this.c = c;
+    }
+    /**
+     * Get request-scoped DI container
+     * Contains request-specific services and context (AuthContext)
+     *
+     * @throws Error if container not initialized
+     */
+    getContainer() {
+        const container = this.c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER);
+        if (!container) {
+            throw new RequestContainerNotInitializedError();
+        }
+        return container;
+    }
+    /**
+     * Set locale for the current request
+     * Locale is determined by X-Locale header or defaults to config
+     *
+     * @param locale - Locale code (e.g., 'en', 'fr')
+     */
+    setLocale(locale) {
+        this.c.set(ROUTER_CONTEXT_KEYS.LOCALE, locale);
+    }
+    /**
+     * Get locale for the current request
+     *
+     * @returns Current locale code
+     */
+    getLocale() {
+        const locale = this.c.get(ROUTER_CONTEXT_KEYS.LOCALE);
+        return locale || 'en';
+    }
+    /**
+     * Return JSON response
+     *
+     * @param data - Data to serialize as JSON
+     * @param status - HTTP status code (default: 200)
+     */
+    json(data, status) {
+        return this.c.json(data, status);
+    }
+    /**
+     * Get route parameter value
+     *
+     * @param key - Parameter name (e.g., 'id' for /users/:id)
+     */
+    param(key) {
+        return this.c.req.valid('param')[key];
+    }
+    /**
+     * Get query parameter value
+     *
+     * @param key - Query parameter name
+     */
+    query(key) {
+        const validated = this.c.req.valid('query');
+        return key ? validated[key] : validated;
+    }
+    /**
+     * Get request header value
+     *
+     * @param name - Header name (case-insensitive)
+     */
+    header(name) {
+        return this.c.req.header(name);
+    }
+    /**
+     * Get validated request body from OpenAPI route
+     * Returns pre-validated data that has passed schema validation
+     *
+     * @returns Validated JSON body
+     */
+    body() {
+        // Type assertion needed because req.valid() is type-safe per route
+        // but this is a generic helper method that works across all routes
+        return this.c.req.valid('json');
+    }
+    /**
+     * Return text response
+     *
+     * @param text - Text content
+     * @param status - HTTP status code (default: 200)
+     */
+    text(text, status) {
+        return this.c.text(text, status);
+    }
+    /**
+     * Return HTML response
+     *
+     * @param html - HTML content
+     * @param status - HTTP status code (default: 200)
+     */
+    html(html, status) {
+        return this.c.html(html, status);
+    }
+    /**
+     * Redirect to another URL
+     *
+     * @param url - Target URL
+     * @param status - HTTP status code (default: 302)
+     */
+    redirect(url, status) {
+        return this.c.redirect(url, status);
+    }
+}
+//# sourceMappingURL=router-context.js.map

package/dist/router/router-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-context.js","sourceRoot":"","sources":["../../src/router/router-context.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mCAAmC,EAAE,MAAM,0BAA0B,CAAA;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAKjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,OAAO,aAAa;IAMN;IALlB;;;OAGG;IACH,YACkB,CAAa;QAAb,MAAC,GAAD,CAAC,CAAY;IAC3B,CAAC;IAEL;;;;;OAKG;IACH,YAAY;QACV,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,CAAA;QACnE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,mCAAmC,EAAE,CAAA;QACjD,CAAC;QACD,OAAO,SAAsB,CAAA;IAC/B,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChD,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAA;QACrD,OAAQ,MAAiB,IAAI,IAAI,CAAA;IACnC,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,IAAY,EAAE,MAA6B;QAC9C,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAClC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAW;QACf,OAAQ,IAAI,CAAC,CAAC,CAAC,GAAqE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAA;IAC1G,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAsG,GAAO;QAChH,MAAM,SAAS,GAAI,IAAI,CAAC,CAAC,CAAC,GAAsE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC/G,OAAO,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAA6B,CAAC,CAAC,CAAC,SAAqC,CAAA;IACjG,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAChC,CAAC;IAED;;;;;OAKG;IACH,IAAI;QACF,mEAAmE;QACnE,mEAAmE;QACnE,OAAQ,IAAI,CAAC,CAAC,CAAC,GAAwD,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACvF,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,IAAY,EAAE,MAA6B;QAC9C,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAClC,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,IAAY,EAAE,MAA6B;QAC9C,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAClC,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,GAAW,EAAE,MAA2B;QAC/C,OAAO,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IACrC,CAAC;CACF"}

package/dist/router/router.service.d.ts

@@ -0,0 +1,62 @@
+import { type StratalEnv } from '../env';
+import { type Container } from '../di';
+import { type LoggerService } from '../logger';
+import { type MiddlewareConfigEntry } from '../middleware';
+import type { Constructor } from '../types';
+import type { IController } from './controller';
+/**
+ * RouterService manages HTTP routing and request handling with OpenAPI support
+ *
+ * Responsibilities:
+ * - Creates and configures OpenAPIHono application
+ * - Delegates to specialized services:
+ *   - RequestScopeService: Request-scoped container setup
+ *   - OpenAPIService: OpenAPI spec and documentation endpoints
+ *   - RouteRegistrationService: Controller and route registration
+ * - Registers global middleware (CORS, logging, error handling)
+ * - Handles fetch requests via Hono
+ *
+ * Note: Route access control (domain-based enforcement) is handled by
+ * RouteAccessMiddleware in the tenancy module, applied via TenancyModule.configure().
+ *
+ * The service is registered as a singleton in the DI container
+ * and accessed by the Backend worker's fetch() method.
+ */
+export declare class RouterService {
+    private logger;
+    private container;
+    private app;
+    private configured;
+    constructor(logger: LoggerService, container: Container);
+    /**
+     * Setup all middleware in correct order
+     * Note: OpenAPI setup is deferred to configure() because it needs controllers
+     */
+    private setupMiddleware;
+    /**
+     * Setup global middleware that runs for all requests
+     */
+    private setupGlobalMiddleware;
+    /**
+     * Configure router with middlewares and controllers atomically
+     * This MUST be called immediately after RouterService construction
+     * and can only be called once.
+     *
+     * @param middlewareConfigs - Array of middleware configuration entries from modules
+     * @param controllers - Array of controller classes from modules
+     */
+    configure(middlewareConfigs: MiddlewareConfigEntry[], controllers: Constructor<IController>[]): void;
+    /**
+     * Handle incoming fetch request via Hono
+     *
+     * This method is called by the Backend worker's fetch() method.
+     * The request-scoped container is created in RequestScopeService.
+     *
+     * @param request - Incoming Request object
+     * @param env - Cloudflare environment bindings
+     * @param ctx - Cloudflare execution context
+     * @returns Response object
+     */
+    fetch(request: Request, env: StratalEnv, ctx: ExecutionContext): Response | Promise<Response>;
+}
+//# sourceMappingURL=router.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.service.d.ts","sourceRoot":"","sources":["../../src/router/router.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAA;AACxC,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAIvD,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAA;AAC7D,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAA;AAEtB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAS/C;;;;;;;;;;;;;;;;;GAiBG;AACH,qBACa,aAAa;IAMtB,OAAO,CAAC,MAAM;IAEd,OAAO,CAAC,SAAS;IAPnB,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,UAAU,CAAQ;gBAIhB,MAAM,EAAE,aAAa,EAErB,SAAS,EAAE,SAAS;IA8B9B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;;;;;;OAOG;IACH,SAAS,CAAC,iBAAiB,EAAE,qBAAqB,EAAE,EAAE,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC,EAAE,GAAG,IAAI;IAgCpG;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,gBAAgB,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;CAM9F"}

package/dist/router/router.service.js

@@ -0,0 +1,166 @@
+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 { OpenAPIHono } from '../i18n/validation';
+import { cors } from 'hono/cors';
+import { inject } from 'tsyringe';
+import { CONTAINER_TOKEN } from '../di';
+import { Transient } from '../di/decorators';
+import { DI_TOKENS } from '../di/tokens';
+import { getHttpStatus } from '../infrastructure/error-handler';
+import { LOGGER_TOKENS } from '../logger';
+import { MiddlewareConfigurationService, } from '../middleware';
+import { OPENAPI_TOKENS } from '../openapi';
+import { ROUTER_CONTEXT_KEYS } from './constants';
+import { RouteNotFoundError, RouterAlreadyConfiguredError, RouterNotConfiguredError } from './errors';
+import { SchemaValidationError } from './errors/schema-validation.error';
+import { createLoggerMiddleware } from './middleware';
+import { ROUTER_TOKENS } from './router.tokens';
+import { RequestScopeService } from './services/request-scope.service';
+import { RouteRegistrationService } from './services/route-registration.service';
+/**
+ * RouterService manages HTTP routing and request handling with OpenAPI support
+ *
+ * Responsibilities:
+ * - Creates and configures OpenAPIHono application
+ * - Delegates to specialized services:
+ *   - RequestScopeService: Request-scoped container setup
+ *   - OpenAPIService: OpenAPI spec and documentation endpoints
+ *   - RouteRegistrationService: Controller and route registration
+ * - Registers global middleware (CORS, logging, error handling)
+ * - Handles fetch requests via Hono
+ *
+ * Note: Route access control (domain-based enforcement) is handled by
+ * RouteAccessMiddleware in the tenancy module, applied via TenancyModule.configure().
+ *
+ * The service is registered as a singleton in the DI container
+ * and accessed by the Backend worker's fetch() method.
+ */
+let RouterService = class RouterService {
+    logger;
+    container;
+    app;
+    configured = false;
+    constructor(logger, container) {
+        this.logger = logger;
+        this.container = container;
+        this.app = new OpenAPIHono({
+            defaultHook: (result, c) => {
+                if (!result.success) {
+                    // Get request container (created by RequestScopeService)
+                    const requestContainer = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER);
+                    // Resolve GlobalErrorHandler from request container for i18n support
+                    const errorHandler = requestContainer.resolve(DI_TOKENS.ErrorHandler);
+                    // Convert ZodError to SchemaValidationError
+                    const validationError = new SchemaValidationError(result.error);
+                    // Process through global error handler for consistent formatting
+                    const errorResponse = errorHandler.handle(validationError);
+                    // Get HTTP status code from error code
+                    const status = getHttpStatus(errorResponse.code);
+                    return c.json(errorResponse, status);
+                }
+                // Validation succeeded, continue to handler
+                return;
+            },
+        });
+        this.setupMiddleware();
+    }
+    /**
+     * Setup all middleware in correct order
+     * Note: OpenAPI setup is deferred to configure() because it needs controllers
+     */
+    setupMiddleware() {
+        // 1. Request-scoped container setup (MUST be FIRST)
+        const requestScopeService = new RequestScopeService(this.container);
+        requestScopeService.setupMiddleware(this.app);
+        // 2. Global middleware (CORS, logging, error handling)
+        this.setupGlobalMiddleware();
+        // 3. OpenAPI documentation endpoints - deferred to configure()
+    }
+    /**
+     * Setup global middleware that runs for all requests
+     */
+    setupGlobalMiddleware() {
+        // CORS middleware
+        this.app.use('*', cors());
+        // Request logger middleware (uses our Logger service)
+        this.app.use('*', createLoggerMiddleware(this.logger));
+        // Global error handler
+        this.app.onError((err, c) => {
+            // Resolve GlobalErrorHandler from request container (has I18nService for translation)
+            const requestContainer = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER);
+            const errorHandler = requestContainer.resolve(DI_TOKENS.ErrorHandler);
+            // Handle all errors via GlobalErrorHandler
+            const errorResponse = errorHandler.handle(err);
+            const status = getHttpStatus(errorResponse.code);
+            return c.json(errorResponse, status);
+        });
+    }
+    /**
+     * Configure router with middlewares and controllers atomically
+     * This MUST be called immediately after RouterService construction
+     * and can only be called once.
+     *
+     * @param middlewareConfigs - Array of middleware configuration entries from modules
+     * @param controllers - Array of controller classes from modules
+     */
+    configure(middlewareConfigs, controllers) {
+        if (this.configured) {
+            throw new RouterAlreadyConfiguredError();
+        }
+        this.logger.info('Configuring router', {
+            middlewareConfigCount: middlewareConfigs.length,
+            controllerCount: controllers.length,
+        });
+        // 3. Apply middleware configurations FIRST (includes LocaleExtractionMiddleware, RouteAccessMiddleware)
+        // Middleware must run before OpenAPI endpoints so locale and route context are available
+        const middlewareConfigService = new MiddlewareConfigurationService(this.logger);
+        middlewareConfigService.applyMiddlewares(this.app, middlewareConfigs, controllers, this.container);
+        // 4. OpenAPI documentation endpoints (needs middleware to run first for i18n and route filtering)
+        const openAPIService = this.container.resolve(OPENAPI_TOKENS.OpenAPIService);
+        openAPIService.setupEndpoints(this.app, controllers);
+        // 5. Register controllers and routes
+        const routeRegistrationService = new RouteRegistrationService(this.logger);
+        routeRegistrationService.configure(this.app, controllers);
+        // 6. Register 404 handler last
+        this.app.notFound((c) => {
+            throw new RouteNotFoundError(c.req.path, c.req.method);
+        });
+        this.configured = true;
+        this.logger.info('Router configuration complete');
+    }
+    /**
+     * Handle incoming fetch request via Hono
+     *
+     * This method is called by the Backend worker's fetch() method.
+     * The request-scoped container is created in RequestScopeService.
+     *
+     * @param request - Incoming Request object
+     * @param env - Cloudflare environment bindings
+     * @param ctx - Cloudflare execution context
+     * @returns Response object
+     */
+    fetch(request, env, ctx) {
+        if (!this.configured) {
+            throw new RouterNotConfiguredError();
+        }
+        return this.app.fetch(request, env, ctx);
+    }
+};
+RouterService = __decorate([
+    Transient(ROUTER_TOKENS.RouterService),
+    __param(0, inject(LOGGER_TOKENS.LoggerService)),
+    __param(1, inject(CONTAINER_TOKEN)),
+    __metadata("design:paramtypes", [Function, Function])
+], RouterService);
+export { RouterService };
+//# sourceMappingURL=router.service.js.map

package/dist/router/router.service.js.map

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

package/dist/router/router.tokens.d.ts

@@ -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 declare const ROUTER_TOKENS: {
+    /**
+     * Token for RouterService singleton
+     */
+    readonly RouterService: symbol;
+    /**
+     * Token for RouterContext (request-scoped)
+     * Contains Hono context wrapper with helper methods
+     */
+    readonly RouterContext: symbol;
+};
+//# sourceMappingURL=router.tokens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.tokens.d.ts","sourceRoot":"","sources":["../../src/router/router.tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;;IAGH;;;OAGG;;CAEK,CAAA"}