stratal 0.0.1

package/dist/middleware/middleware-configuration.service.d.ts

@@ -0,0 +1,64 @@
+import type { OpenAPIHono } from '../i18n/validation';
+import type { Container } from '../di';
+import type { LoggerService } from '../logger';
+import type { IController } from '../router/controller';
+import type { RouterEnv } from '../router/types';
+import type { Constructor } from '../types';
+import type { MiddlewareConfigEntry } from './types';
+/**
+ * Service for applying middleware configurations to Hono app
+ *
+ * Processes MiddlewareConfigEntry[] from modules and registers
+ * appropriate middleware handlers with route matching.
+ */
+export declare class MiddlewareConfigurationService {
+    private readonly logger;
+    constructor(logger: LoggerService);
+    /**
+     * Apply middleware configurations to the Hono app
+     *
+     * @param app - Hono application instance
+     * @param configs - Middleware configuration entries from modules
+     * @param controllers - All registered controller classes (for route resolution)
+     * @param container - DI container for resolving middleware instances
+     */
+    applyMiddlewares(app: OpenAPIHono<RouterEnv>, configs: MiddlewareConfigEntry[], controllers: Constructor<IController>[], container: Container): void;
+    /**
+     * Apply a single middleware configuration entry
+     */
+    private applyMiddlewareConfig;
+    /**
+     * Resolve route targets into concrete route patterns
+     */
+    private resolveRoutePatterns;
+    /**
+     * Register middleware handlers for a specific route pattern
+     */
+    private registerMiddlewareForPattern;
+    /**
+     * Register handler for a specific HTTP method
+     */
+    private registerForMethod;
+    /**
+     * Create a middleware handler function that executes the middleware chain
+     */
+    private createMiddlewareHandler;
+    /**
+     * Check if a request matches any exclusion pattern
+     */
+    private isExcluded;
+    /**
+     * Check if request matches a route pattern
+     */
+    private matchesRoute;
+    /**
+     * Match request path against pattern
+     * Supports wildcards: /api/* matches /api/users, /api/v1/users
+     */
+    private matchesPath;
+    /**
+     * Execute middleware chain in order
+     */
+    private executeMiddlewareChain;
+}
+//# sourceMappingURL=middleware-configuration.service.d.ts.map

package/dist/middleware/middleware-configuration.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-configuration.service.d.ts","sourceRoot":"","sources":["../../src/middleware/middleware-configuration.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAIvD,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,KAAK,EAAE,qBAAqB,EAAa,MAAM,SAAS,CAAA;AAE/D;;;;;GAKG;AACH,qBAAa,8BAA8B;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAElD;;;;;;;OAOG;IACH,gBAAgB,CACd,GAAG,EAAE,WAAW,CAAC,SAAS,CAAC,EAC3B,OAAO,EAAE,qBAAqB,EAAE,EAChC,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC,EAAE,EACvC,SAAS,EAAE,SAAS,GACnB,IAAI;IAMP;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA8B5B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IA2BpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAuB/B;;OAEG;IACH,OAAO,CAAC,UAAU;IAalB;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;;OAGG;IACH,OAAO,CAAC,WAAW;IA0BnB;;OAEG;YACW,sBAAsB;CAwBrC"}

package/dist/middleware/middleware-configuration.service.js

@@ -0,0 +1,210 @@
+import { getControllerRoute } from '../router/decorators/controller.decorator';
+import { RouterContext } from '../router/router-context';
+/**
+ * Service for applying middleware configurations to Hono app
+ *
+ * Processes MiddlewareConfigEntry[] from modules and registers
+ * appropriate middleware handlers with route matching.
+ */
+export class MiddlewareConfigurationService {
+    logger;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Apply middleware configurations to the Hono app
+     *
+     * @param app - Hono application instance
+     * @param configs - Middleware configuration entries from modules
+     * @param controllers - All registered controller classes (for route resolution)
+     * @param container - DI container for resolving middleware instances
+     */
+    applyMiddlewares(app, configs, controllers, container) {
+        for (const config of configs) {
+            this.applyMiddlewareConfig(app, config, controllers, container);
+        }
+    }
+    /**
+     * Apply a single middleware configuration entry
+     */
+    applyMiddlewareConfig(app, config, controllers, container) {
+        const { middlewares, excludes, routes } = config;
+        // Resolve route patterns from targets
+        const routePatterns = this.resolveRoutePatterns(routes, controllers);
+        // Log the configuration for debugging
+        this.logger.debug('Applying middleware configuration', {
+            middlewares: middlewares.map(m => m.name),
+            routes: routePatterns,
+            excludes: excludes,
+        });
+        // Apply middleware to each route pattern
+        for (const pattern of routePatterns) {
+            this.registerMiddlewareForPattern(app, middlewares, pattern, excludes, container);
+        }
+    }
+    /**
+     * Resolve route targets into concrete route patterns
+     */
+    resolveRoutePatterns(targets, _controllers) {
+        const patterns = [];
+        for (const target of targets) {
+            if (target === '*') {
+                // Global middleware - apply to all routes
+                patterns.push({ path: '*' });
+            }
+            else if (typeof target === 'function') {
+                // Controller class - get its route from metadata
+                const route = getControllerRoute(target);
+                if (route) {
+                    // Add wildcard for all paths under this controller
+                    patterns.push({ path: `${route}/*` });
+                    // Also match the exact path
+                    patterns.push({ path: route });
+                }
+                else {
+                    this.logger.warn('Controller has no route metadata', { controller: target.name });
+                }
+            }
+            else {
+                // RouteInfo object - use directly
+                patterns.push(target);
+            }
+        }
+        return patterns;
+    }
+    /**
+     * Register middleware handlers for a specific route pattern
+     */
+    registerMiddlewareForPattern(app, middlewares, pattern, excludes, container) {
+        const path = pattern.path;
+        const methods = pattern.method
+            ? (Array.isArray(pattern.method) ? pattern.method : [pattern.method])
+            : undefined;
+        // Create the middleware handler
+        const handler = this.createMiddlewareHandler(middlewares, excludes, container);
+        // Register with Hono
+        if (methods && methods.length > 0) {
+            // Method-specific registration
+            for (const method of methods) {
+                this.registerForMethod(app, method, path, handler);
+            }
+        }
+        else {
+            // All methods
+            app.use(path, handler);
+        }
+    }
+    /**
+     * Register handler for a specific HTTP method
+     */
+    registerForMethod(app, method, path, handler) {
+        switch (method) {
+            case 'get':
+                app.get(path, handler);
+                break;
+            case 'post':
+                app.post(path, handler);
+                break;
+            case 'put':
+                app.put(path, handler);
+                break;
+            case 'delete':
+                app.delete(path, handler);
+                break;
+            case 'patch':
+                app.patch(path, handler);
+                break;
+            default:
+                app.use(path, handler);
+        }
+    }
+    /**
+     * Create a middleware handler function that executes the middleware chain
+     */
+    createMiddlewareHandler(middlewares, excludes, container) {
+        return async (c, next) => {
+            const requestPath = c.req.path;
+            const requestMethod = c.req.method.toLowerCase();
+            // Check if this request should be excluded
+            if (this.isExcluded(requestPath, requestMethod, excludes)) {
+                await next();
+                return;
+            }
+            // Create RouterContext for middleware
+            const ctx = new RouterContext(c);
+            // Execute middleware chain
+            await this.executeMiddlewareChain(middlewares, ctx, container, next);
+        };
+    }
+    /**
+     * Check if a request matches any exclusion pattern
+     */
+    isExcluded(requestPath, requestMethod, excludes) {
+        for (const exclude of excludes) {
+            if (this.matchesRoute(requestPath, requestMethod, exclude)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Check if request matches a route pattern
+     */
+    matchesRoute(requestPath, requestMethod, route) {
+        // Check method match (if specified)
+        if (route.method) {
+            const methods = Array.isArray(route.method) ? route.method : [route.method];
+            if (!methods.includes(requestMethod)) {
+                return false;
+            }
+        }
+        // Check path match
+        return this.matchesPath(requestPath, route.path);
+    }
+    /**
+     * Match request path against pattern
+     * Supports wildcards: /api/* matches /api/users, /api/v1/users
+     */
+    matchesPath(requestPath, pattern) {
+        // Exact match
+        if (pattern === requestPath) {
+            return true;
+        }
+        // Global wildcard
+        if (pattern === '*') {
+            return true;
+        }
+        // Wildcard pattern (e.g., /api/*)
+        if (pattern.endsWith('/*')) {
+            const prefix = pattern.slice(0, -2);
+            return requestPath === prefix || requestPath.startsWith(prefix + '/');
+        }
+        // Path parameter pattern (e.g., /api/users/:id)
+        // Convert to regex for matching
+        const regexPattern = pattern
+            .replace(/:[^/]+/g, '[^/]+') // Replace :param with regex
+            .replace(/\*/g, '.*'); // Replace * with regex
+        const regex = new RegExp(`^${regexPattern}$`);
+        return regex.test(requestPath);
+    }
+    /**
+     * Execute middleware chain in order
+     */
+    async executeMiddlewareChain(middlewares, ctx, container, finalNext) {
+        // Build middleware chain from end to start
+        let chain = finalNext;
+        for (let i = middlewares.length - 1; i >= 0; i--) {
+            const MiddlewareClass = middlewares[i];
+            const currentNext = chain;
+            chain = async () => {
+                // Resolve middleware from request-scoped container
+                const requestContainer = ctx.getContainer();
+                const middleware = requestContainer.resolve(MiddlewareClass);
+                await middleware.handle(ctx, currentNext);
+            };
+        }
+        // Execute the chain
+        await chain();
+    }
+}
+//# sourceMappingURL=middleware-configuration.service.js.map

package/dist/middleware/middleware-configuration.service.js.map

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

package/dist/middleware/middleware-consumer.d.ts

@@ -0,0 +1,57 @@
+import type { Middleware } from '../router/middleware.interface';
+import type { Constructor } from '../types';
+import type { MiddlewareConfigEntry, MiddlewareConsumer as IMiddlewareConsumer, MiddlewareBuilder as IMiddlewareBuilder } from './types';
+/**
+ * Consumer for configuring middleware in modules
+ *
+ * Provides fluent API for registering middleware with route targeting.
+ * Used by modules implementing MiddlewareConfigurable interface.
+ *
+ * @example
+ * ```typescript
+ * @Module({ providers: [...] })
+ * export class AppModule implements MiddlewareConfigurable {
+ *   configure(consumer: MiddlewareConsumer): void {
+ *     // Global logging middleware (excludes health check)
+ *     consumer
+ *       .apply(LoggingMiddleware)
+ *       .exclude('/health')
+ *       .forRoutes('*')
+ *
+ *     // Tenant identification for specific controllers
+ *     consumer
+ *       .apply(TenantIdentificationMiddleware)
+ *       .forRoutes(TenantsController, SchoolsController)
+ *
+ *     // Rate limiting for auth endpoints
+ *     consumer
+ *       .apply(RateLimitMiddleware)
+ *       .forRoutes({ path: '/api/v1/auth/*', method: 'post' })
+ *   }
+ * }
+ * ```
+ */
+export declare class MiddlewareConsumerImpl implements IMiddlewareConsumer {
+    private entries;
+    /**
+     * Start configuring middleware
+     *
+     * @param middlewares - Middleware classes to apply
+     * @returns Builder for configuring routes and exclusions
+     */
+    apply(...middlewares: Constructor<Middleware>[]): IMiddlewareBuilder;
+    /**
+     * Add a configuration entry (called by builder)
+     * @internal
+     */
+    addEntry(entry: MiddlewareConfigEntry): void;
+    /**
+     * Get all configured middleware entries
+     */
+    getEntries(): MiddlewareConfigEntry[];
+}
+/**
+ * Create a new middleware consumer instance
+ */
+export declare function createMiddlewareConsumer(): IMiddlewareConsumer;
+//# sourceMappingURL=middleware-consumer.d.ts.map

package/dist/middleware/middleware-consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-consumer.d.ts","sourceRoot":"","sources":["../../src/middleware/middleware-consumer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,IAAI,mBAAmB,EACzC,iBAAiB,IAAI,kBAAkB,EAGxC,MAAM,SAAS,CAAA;AA4EhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,OAAO,CAAC,OAAO,CAA8B;IAE7C;;;;;OAKG;IACH,KAAK,CAAC,GAAG,WAAW,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,GAAG,kBAAkB;IAIpE;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI;IAI5C;;OAEG;IACH,UAAU,IAAI,qBAAqB,EAAE;CAGtC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,mBAAmB,CAE9D"}

package/dist/middleware/middleware-consumer.js

@@ -0,0 +1,130 @@
+/**
+ * Builder for configuring middleware routes and exclusions
+ *
+ * Provides fluent API for specifying where middleware should apply.
+ */
+class MiddlewareBuilderImpl {
+    middlewares;
+    excludedRoutes = [];
+    consumer;
+    constructor(middlewares, consumer) {
+        this.middlewares = middlewares;
+        this.consumer = consumer;
+    }
+    /**
+     * Exclude specific routes from middleware
+     *
+     * @param routes - Routes to exclude (path strings or RouteInfo objects)
+     * @returns this for method chaining
+     *
+     * @example
+     * ```typescript
+     * consumer
+     *   .apply(AuthMiddleware)
+     *   .exclude('/health', { path: '/api/public', method: 'get' })
+     *   .forRoutes('*')
+     * ```
+     */
+    exclude(...routes) {
+        for (const route of routes) {
+            if (typeof route === 'string') {
+                this.excludedRoutes.push({ path: route });
+            }
+            else {
+                this.excludedRoutes.push(route);
+            }
+        }
+        return this;
+    }
+    /**
+     * Apply middleware to specified routes
+     *
+     * This method finalizes the configuration and registers it with the consumer.
+     *
+     * @param targets - Controller classes, RouteInfo objects, or '*' for global
+     *
+     * @example
+     * ```typescript
+     * // Apply to all routes
+     * consumer.apply(LoggingMiddleware).forRoutes('*')
+     *
+     * // Apply to specific controllers
+     * consumer.apply(TenantMiddleware).forRoutes(TenantsController, SchoolsController)
+     *
+     * // Apply to specific paths
+     * consumer.apply(RateLimitMiddleware).forRoutes(
+     *   { path: '/api/v1/auth', method: 'post' }
+     * )
+     * ```
+     */
+    forRoutes(...targets) {
+        const entry = {
+            middlewares: this.middlewares,
+            excludes: this.excludedRoutes,
+            routes: targets,
+        };
+        this.consumer.addEntry(entry);
+    }
+}
+/**
+ * Consumer for configuring middleware in modules
+ *
+ * Provides fluent API for registering middleware with route targeting.
+ * Used by modules implementing MiddlewareConfigurable interface.
+ *
+ * @example
+ * ```typescript
+ * @Module({ providers: [...] })
+ * export class AppModule implements MiddlewareConfigurable {
+ *   configure(consumer: MiddlewareConsumer): void {
+ *     // Global logging middleware (excludes health check)
+ *     consumer
+ *       .apply(LoggingMiddleware)
+ *       .exclude('/health')
+ *       .forRoutes('*')
+ *
+ *     // Tenant identification for specific controllers
+ *     consumer
+ *       .apply(TenantIdentificationMiddleware)
+ *       .forRoutes(TenantsController, SchoolsController)
+ *
+ *     // Rate limiting for auth endpoints
+ *     consumer
+ *       .apply(RateLimitMiddleware)
+ *       .forRoutes({ path: '/api/v1/auth/*', method: 'post' })
+ *   }
+ * }
+ * ```
+ */
+export class MiddlewareConsumerImpl {
+    entries = [];
+    /**
+     * Start configuring middleware
+     *
+     * @param middlewares - Middleware classes to apply
+     * @returns Builder for configuring routes and exclusions
+     */
+    apply(...middlewares) {
+        return new MiddlewareBuilderImpl(middlewares, this);
+    }
+    /**
+     * Add a configuration entry (called by builder)
+     * @internal
+     */
+    addEntry(entry) {
+        this.entries.push(entry);
+    }
+    /**
+     * Get all configured middleware entries
+     */
+    getEntries() {
+        return this.entries;
+    }
+}
+/**
+ * Create a new middleware consumer instance
+ */
+export function createMiddlewareConsumer() {
+    return new MiddlewareConsumerImpl();
+}
+//# sourceMappingURL=middleware-consumer.js.map

package/dist/middleware/middleware-consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-consumer.js","sourceRoot":"","sources":["../../src/middleware/middleware-consumer.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,MAAM,qBAAqB;IACjB,WAAW,CAA2B;IACtC,cAAc,GAAgB,EAAE,CAAA;IAChC,QAAQ,CAAwB;IAExC,YACE,WAAsC,EACtC,QAAgC;QAEhC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,GAAG,MAA8B;QACvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;YAC3C,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACjC,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,SAAS,CAAC,GAAG,OAAgC;QAC3C,MAAM,KAAK,GAA0B;YACnC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,cAAc;YAC7B,MAAM,EAAE,OAAO;SAChB,CAAA;QACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC/B,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAO,sBAAsB;IACzB,OAAO,GAA4B,EAAE,CAAA;IAE7C;;;;;OAKG;IACH,KAAK,CAAC,GAAG,WAAsC;QAC7C,OAAO,IAAI,qBAAqB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;IACrD,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,KAA4B;QACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC1B,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,IAAI,sBAAsB,EAAE,CAAA;AACrC,CAAC"}

package/dist/middleware/types.d.ts

@@ -0,0 +1,94 @@
+import type { IController } from '../router/controller';
+import type { Middleware } from '../router/middleware.interface';
+import type { HttpMethod } from '../router/types';
+import type { Constructor } from '../types';
+/**
+ * Route information for middleware targeting
+ */
+export interface RouteInfo {
+    /** Route path pattern (e.g., '/api/v1/users', '/health') */
+    path: string;
+    /** HTTP method(s) to match. If omitted, matches all methods */
+    method?: HttpMethod | HttpMethod[];
+}
+/**
+ * Internal configuration entry for middleware registration
+ */
+export interface MiddlewareConfigEntry {
+    /** Middleware classes to apply */
+    middlewares: Constructor<Middleware>[];
+    /** Routes to exclude from middleware */
+    excludes: RouteInfo[];
+    /** Target routes for middleware */
+    routes: MiddlewareRouteTarget[];
+}
+/**
+ * Valid targets for middleware routes
+ * - Controller class: Apply to all routes in that controller
+ * - RouteInfo: Apply to specific path/method combination
+ * - '*': Apply to all routes (global middleware)
+ */
+export type MiddlewareRouteTarget = Constructor<IController> | RouteInfo | '*';
+/**
+ * Interface for modules that configure middleware
+ *
+ * Implement this interface in your module class to configure
+ * middleware using the consumer pattern.
+ *
+ * @example
+ * ```typescript
+ * @Module({ providers: [...] })
+ * export class AppModule implements MiddlewareConfigurable {
+ *   configure(consumer: MiddlewareConsumer): void {
+ *     consumer
+ *       .apply(LoggingMiddleware, CorsMiddleware)
+ *       .exclude({ path: '/health', method: 'get' })
+ *       .forRoutes('*')
+ *
+ *     consumer
+ *       .apply(TenantMiddleware)
+ *       .forRoutes(TenantsController, SchoolsController)
+ *   }
+ * }
+ * ```
+ */
+export interface MiddlewareConfigurable {
+    /**
+     * Configure middleware for this module
+     * @param consumer - Middleware consumer for fluent configuration
+     */
+    configure(consumer: MiddlewareConsumer): void;
+}
+/**
+ * Forward declaration for MiddlewareConsumer
+ * Implementation in middleware-consumer.ts
+ */
+export interface MiddlewareConsumer {
+    /**
+     * Specify middleware(s) to apply
+     * @param middlewares - Middleware classes to apply
+     * @returns Builder for configuring routes
+     */
+    apply(...middlewares: Constructor<Middleware>[]): MiddlewareBuilder;
+    /**
+     * Get all configured middleware entries
+     */
+    getEntries(): MiddlewareConfigEntry[];
+}
+/**
+ * Forward declaration for MiddlewareBuilder
+ * Implementation in middleware-consumer.ts
+ */
+export interface MiddlewareBuilder {
+    /**
+     * Exclude routes from middleware
+     * @param routes - Routes to exclude (path strings or RouteInfo objects)
+     */
+    exclude(...routes: (string | RouteInfo)[]): this;
+    /**
+     * Apply middleware to specified routes
+     * @param targets - Controller classes, route patterns, or '*' for global
+     */
+    forRoutes(...targets: MiddlewareRouteTarget[]): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/middleware/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAA;IACZ,+DAA+D;IAC/D,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,WAAW,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,CAAA;IACtC,wCAAwC;IACxC,QAAQ,EAAE,SAAS,EAAE,CAAA;IACrB,mCAAmC;IACnC,MAAM,EAAE,qBAAqB,EAAE,CAAA;CAChC;AAED;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,SAAS,GAAG,GAAG,CAAA;AAE9E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAA;CAC9C;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,KAAK,CAAC,GAAG,WAAW,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,GAAG,iBAAiB,CAAA;IACnE;;OAEG;IACH,UAAU,IAAI,qBAAqB,EAAE,CAAA;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,IAAI,CAAA;IAChD;;;OAGG;IACH,SAAS,CAAC,GAAG,OAAO,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAA;CACrD"}

package/dist/middleware/types.js

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

package/dist/middleware/types.js.map

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

package/dist/module/errors/index.d.ts

@@ -0,0 +1,5 @@
+export * from './invalid-module-provider.error';
+export * from './module-already-registered.error';
+export * from './module-circular-dependency.error';
+export * from './module-dependency-not-found.error';
+//# sourceMappingURL=index.d.ts.map

package/dist/module/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/module/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAA;AAC/C,cAAc,mCAAmC,CAAA;AACjD,cAAc,oCAAoC,CAAA;AAClD,cAAc,qCAAqC,CAAA"}

package/dist/module/errors/index.js

@@ -0,0 +1,5 @@
+export * from './invalid-module-provider.error';
+export * from './module-already-registered.error';
+export * from './module-circular-dependency.error';
+export * from './module-dependency-not-found.error';
+//# sourceMappingURL=index.js.map

package/dist/module/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/module/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAA;AAC/C,cAAc,mCAAmC,CAAA;AACjD,cAAc,oCAAoC,CAAA;AAClD,cAAc,qCAAqC,CAAA"}

package/dist/module/errors/invalid-module-provider.error.d.ts

@@ -0,0 +1,11 @@
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * InvalidModuleProviderError
+ *
+ * Thrown when a module provider configuration is invalid.
+ * This indicates a misconfiguration in the @Module decorator providers array.
+ */
+export declare class InvalidModuleProviderError extends ApplicationError {
+    constructor(provider: unknown);
+}
+//# sourceMappingURL=invalid-module-provider.error.d.ts.map

package/dist/module/errors/invalid-module-provider.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid-module-provider.error.d.ts","sourceRoot":"","sources":["../../../src/module/errors/invalid-module-provider.error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;GAKG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB;gBAClD,QAAQ,EAAE,OAAO;CAO9B"}

package/dist/module/errors/invalid-module-provider.error.js

@@ -0,0 +1,14 @@
+import { ERROR_CODES } from '../../errors';
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * InvalidModuleProviderError
+ *
+ * Thrown when a module provider configuration is invalid.
+ * This indicates a misconfiguration in the @Module decorator providers array.
+ */
+export class InvalidModuleProviderError extends ApplicationError {
+    constructor(provider) {
+        super('errors.invalidModuleProvider', ERROR_CODES.SYSTEM.INVALID_MODULE_PROVIDER, { provider: JSON.stringify(provider) });
+    }
+}
+//# sourceMappingURL=invalid-module-provider.error.js.map

package/dist/module/errors/invalid-module-provider.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid-module-provider.error.js","sourceRoot":"","sources":["../../../src/module/errors/invalid-module-provider.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;GAKG;AACH,MAAM,OAAO,0BAA2B,SAAQ,gBAAgB;IAC9D,YAAY,QAAiB;QAC3B,KAAK,CACH,8BAA8B,EAC9B,WAAW,CAAC,MAAM,CAAC,uBAAuB,EAC1C,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CACvC,CAAA;IACH,CAAC;CACF"}

package/dist/module/errors/module-already-registered.error.d.ts

@@ -0,0 +1,11 @@
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * ModuleAlreadyRegisteredError
+ *
+ * Thrown when attempting to register a module that is already registered.
+ * This prevents duplicate module registration which could cause unexpected behavior.
+ */
+export declare class ModuleAlreadyRegisteredError extends ApplicationError {
+    constructor(moduleName: string);
+}
+//# sourceMappingURL=module-already-registered.error.d.ts.map

package/dist/module/errors/module-already-registered.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-already-registered.error.d.ts","sourceRoot":"","sources":["../../../src/module/errors/module-already-registered.error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;GAKG;AACH,qBAAa,4BAA6B,SAAQ,gBAAgB;gBACpD,UAAU,EAAE,MAAM;CAO/B"}