stratal 0.0.1

package/dist/module/module.decorator.js.map

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

package/dist/module/types.d.ts

@@ -0,0 +1,240 @@
+/**
+ * Module System Types
+ *
+ * Type definitions for the @Module decorator pattern with dynamic module support.
+ * Simplified for tsyringe's flat container model (no module scoping).
+ */
+import type { DependencyContainer } from 'tsyringe';
+import type InjectionToken from 'tsyringe/dist/typings/providers/injection-token';
+import type { Container } from '../di/container';
+import type { Scope } from '../di/types';
+import type { LoggerService } from '../logger';
+import type { Constructor } from '../types';
+export type { InjectionToken };
+/**
+ * Provider that uses a class constructor
+ *
+ * @example Transient (default)
+ * ```typescript
+ * { provide: UserService, useClass: UserService }
+ * ```
+ *
+ * @example Singleton
+ * ```typescript
+ * { provide: DI_TOKENS.ConsumerRegistry, useClass: ConsumerRegistry, scope: Scope.Singleton }
+ * ```
+ *
+ * @example Request-scoped
+ * ```typescript
+ * { provide: DI_TOKENS.ConnectionManager, useClass: ConnectionManager, scope: Scope.Request }
+ * ```
+ */
+export interface ClassProvider<T extends object = object> {
+    provide: InjectionToken<T>;
+    useClass: Constructor<T>;
+    /** Lifecycle scope - defaults to Transient if not specified */
+    scope?: Scope;
+}
+/**
+ * Provider that uses a pre-created value
+ *
+ * Note: Values are inherently singleton-like (same instance always returned).
+ * No scope option needed.
+ */
+export interface ValueProvider<T extends object = object> {
+    provide: InjectionToken<T>;
+    useValue: T;
+}
+/**
+ * Provider that uses a factory function with auto-injection support
+ *
+ * Note: Factory providers do not support scope/lifecycle in tsyringe.
+ * Factories are always called fresh on each resolution (transient-like behavior).
+ *
+ * @example Factory with dependencies
+ * ```typescript
+ * {
+ *   provide: LOGGER_TOKENS.Transports,
+ *   useFactory: (console) => [console],
+ *   inject: [LOGGER_TOKENS.ConsoleTransport]
+ * }
+ * ```
+ */
+export interface FactoryProvider<T extends object = object> {
+    provide: InjectionToken<T>;
+    useFactory: (...deps: any[]) => T | Promise<T>;
+    inject?: InjectionToken<unknown>[];
+}
+/**
+ * Provider that creates an alias to an existing token
+ *
+ * When the `provide` token is resolved, the container resolves `useExisting` instead.
+ * Both tokens return the same instance (for singleton/request-scoped services).
+ *
+ * Use cases:
+ * - Creating interface tokens that alias concrete implementations
+ * - Multiple tokens resolving to the same service
+ *
+ * @example Basic alias
+ * ```typescript
+ * {
+ *   provide: 'IUserService',
+ *   useExisting: UserService
+ * }
+ * // Resolving 'IUserService' returns the UserService instance
+ * ```
+ *
+ * @example Interface abstraction
+ * ```typescript
+ * providers: [
+ *   UserService,
+ *   { provide: I_USER_SERVICE, useExisting: UserService }
+ * ]
+ * // Both UserService and I_USER_SERVICE resolve to the same instance
+ * ```
+ */
+export interface ExistingProvider<T extends object = object> {
+    provide: InjectionToken<T>;
+    useExisting: InjectionToken<T>;
+}
+/**
+ * Union type for all provider types
+ */
+export type Provider<T extends object = object> = Constructor<T> | ClassProvider<T> | ValueProvider<T> | FactoryProvider<T> | ExistingProvider<T>;
+/**
+ * Module class type (decorated with @Module)
+ *
+ * Static methods for dynamic module configuration:
+ * - withRoot: Synchronous configuration (like NestJS forRoot)
+ * - withRootAsync: Async configuration with factory (like NestJS forRootAsync)
+ */
+export interface ModuleClass<T extends object = object> extends Constructor<T> {
+    /**
+     * Synchronous module configuration
+     *
+     * Use for global singleton modules with static configuration
+     *
+     * @example
+     * ```typescript
+     * @Module({ providers: [] })
+     * export class ConfigModule {
+     *   static withRoot(options: ConfigOptions): DynamicModule {
+     *     return {
+     *       providers: [
+     *         { provide: CONFIG_TOKEN, useValue: options }
+     *       ]
+     *     }
+     *   }
+     * }
+     *
+     * // Usage in AppModule
+     * @Module({ imports: [ConfigModule.withRoot({ apiKey: '...' })] })
+     * ```
+     */
+    withRoot?: (...args: unknown[]) => DynamicModule;
+    /**
+     * Async module configuration with dependency injection
+     *
+     * Use when configuration depends on other services
+     *
+     * @example
+     * ```typescript
+     * @Module({ providers: [] })
+     * export class DatabaseModule {
+     *   static withRootAsync<T>(options: AsyncModuleOptions<T>): DynamicModule {
+     *     return {
+     *       providers: [
+     *         {
+     *           provide: DB_TOKEN,
+     *           useFactory: options.useFactory,
+     *           inject: options.inject
+     *         }
+     *       ]
+     *     }
+     *   }
+     * }
+     *
+     * // Usage in AppModule
+     * @Module({
+     *   imports: [
+     *     DatabaseModule.withRootAsync({
+     *       inject: [CONFIG_TOKEN],
+     *       useFactory: (config) => ({ url: config.databaseUrl })
+     *     })
+     *   ]
+     * })
+     * ```
+     */
+    withRootAsync?: <TOptions>(options: AsyncModuleOptions<TOptions>) => DynamicModule;
+}
+/**
+ * Module options for @Module decorator
+ *
+ * Note: Middlewares are configured via the MiddlewareConfigurable interface's
+ * configure() method, not via this options object. See middleware/types.ts.
+ */
+export interface ModuleOptions {
+    imports?: (ModuleClass | DynamicModule)[];
+    providers?: Provider[];
+    controllers?: Constructor[];
+    consumers?: Constructor[];
+    jobs?: Constructor[];
+}
+/**
+ * Dynamic module returned by withRoot/withRootAsync
+ *
+ * Contains additional providers, controllers, consumers, and jobs
+ * that are added to the module when configured dynamically.
+ */
+export interface DynamicModule extends Omit<ModuleOptions, 'imports'> {
+    /**
+     * Reference to the module class that created this dynamic module
+     *
+     * Required for dynamic modules to support lifecycle methods (configure, onInitialize, onShutdown).
+     * ModuleRegistry uses this to instantiate the actual module class instead of an anonymous wrapper.
+     *
+     * Note: This is NOT for provider scoping (tsyringe is always global).
+     * It's purely for preserving the class reference for lifecycle method calls.
+     */
+    module: Constructor;
+}
+/**
+ * Async configuration options for withRootAsync
+ */
+export interface AsyncModuleOptions<TOptions> {
+    inject?: InjectionToken<unknown>[];
+    useFactory: (...deps: any[]) => TOptions | Promise<TOptions>;
+}
+/**
+ * Context passed to lifecycle hooks
+ */
+export interface ModuleContext {
+    container: Container;
+    logger: LoggerService;
+}
+/**
+ * Lifecycle hook: called after all providers are registered
+ */
+export interface OnInitialize {
+    onInitialize(context: ModuleContext): void | Promise<void>;
+}
+/**
+ * Lifecycle hook: called during application shutdown
+ */
+export interface OnShutdown {
+    onShutdown(context: ModuleContext): void | Promise<void>;
+}
+/**
+ * Tsyringe registry entry type (for internal use)
+ *
+ * Note: useFactory receives DependencyContainer from tsyringe,
+ * but we resolve our Container via CONTAINER_TOKEN for consistency.
+ */
+export interface RegistryEntry<T extends object = object> {
+    token: InjectionToken<T>;
+    useClass?: Constructor<T>;
+    useValue?: T;
+    useFactory?: (dependencyContainer: DependencyContainer) => T;
+    useToken?: InjectionToken<T>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/module/types.js

@@ -0,0 +1,8 @@
+/**
+ * Module System Types
+ *
+ * Type definitions for the @Module decorator pattern with dynamic module support.
+ * Simplified for tsyringe's flat container model (no module scoping).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/module/types.js.map

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

package/dist/openapi/index.d.ts

@@ -0,0 +1,5 @@
+export { OpenAPIModule } from './openapi.module';
+export { OPENAPI_TOKENS } from './openapi.tokens';
+export type { IOpenAPIConfigService, OpenAPIConfigOverride, OpenAPIEffectiveConfig, OpenAPIInfo, OpenAPIModuleOptions, RouteFilterFn } from './types';
+export { OpenAPIConfigService, OpenAPIService } from './services';
+//# sourceMappingURL=index.d.ts.map

package/dist/openapi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/openapi/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGhD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGjD,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,oBAAoB,EACpB,aAAa,EACd,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}

package/dist/openapi/index.js

@@ -0,0 +1,7 @@
+// Module
+export { OpenAPIModule } from './openapi.module';
+// Tokens
+export { OPENAPI_TOKENS } from './openapi.tokens';
+// Services
+export { OpenAPIConfigService, OpenAPIService } from './services';
+//# sourceMappingURL=index.js.map

package/dist/openapi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/openapi/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD,SAAS;AACT,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAYjD,WAAW;AACX,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}

package/dist/openapi/openapi.module.d.ts

@@ -0,0 +1,52 @@
+/**
+ * OpenAPI Module
+ *
+ * Provides configurable OpenAPI documentation endpoints with runtime override support.
+ *
+ * Features:
+ * - Configurable paths for /openapi.json and /docs
+ * - Runtime config overrides via middleware
+ * - i18n support for titles and descriptions
+ * - Route filtering via hideFromDocs and custom routeFilter
+ *
+ * @example Basic usage
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     OpenAPIModule.forRoot({
+ *       info: { title: 'My API', version: '1.0.0' }
+ *     })
+ *   ]
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * @example With runtime override in middleware
+ * ```typescript
+ * // In RouteAccessMiddleware
+ * constructor(
+ *   @inject(OPENAPI_TOKENS.ConfigService) private openAPIConfig: IOpenAPIConfigService
+ * ) {}
+ *
+ * async handle(ctx, next) {
+ *   this.openAPIConfig.override({
+ *     info: { title: 'Tenant API' },
+ *     routeFilter: (path) => this.shouldInclude(path)
+ *   })
+ *   await next()
+ * }
+ * ```
+ */
+import type { AsyncModuleOptions, DynamicModule } from '../module/types';
+import type { OpenAPIModuleOptions } from './types';
+export declare class OpenAPIModule {
+    /**
+     * Configure OpenAPI module with static options
+     *
+     * @param options - OpenAPI configuration (paths, info, security schemes)
+     * @returns DynamicModule with options provider
+     */
+    static forRoot(options?: OpenAPIModuleOptions): DynamicModule;
+    static forRootAsync(options: AsyncModuleOptions<OpenAPIModuleOptions>): DynamicModule;
+}
+//# sourceMappingURL=openapi.module.d.ts.map

package/dist/openapi/openapi.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.module.d.ts","sourceRoot":"","sources":["../../src/openapi/openapi.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAGxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAYnD,qBAQa,aAAa;IACxB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa;IAqBjE,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,GAAG,aAAa;CAYtF"}

package/dist/openapi/openapi.module.js

@@ -0,0 +1,110 @@
+/**
+ * OpenAPI Module
+ *
+ * Provides configurable OpenAPI documentation endpoints with runtime override support.
+ *
+ * Features:
+ * - Configurable paths for /openapi.json and /docs
+ * - Runtime config overrides via middleware
+ * - i18n support for titles and descriptions
+ * - Route filtering via hideFromDocs and custom routeFilter
+ *
+ * @example Basic usage
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     OpenAPIModule.forRoot({
+ *       info: { title: 'My API', version: '1.0.0' }
+ *     })
+ *   ]
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * @example With runtime override in middleware
+ * ```typescript
+ * // In RouteAccessMiddleware
+ * constructor(
+ *   @inject(OPENAPI_TOKENS.ConfigService) private openAPIConfig: IOpenAPIConfigService
+ * ) {}
+ *
+ * async handle(ctx, next) {
+ *   this.openAPIConfig.override({
+ *     info: { title: 'Tenant API' },
+ *     routeFilter: (path) => this.shouldInclude(path)
+ *   })
+ *   await next()
+ * }
+ * ```
+ */
+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 OpenAPIModule_1;
+import { Scope } from '../di';
+import { Module } from '../module';
+import { OPENAPI_TOKENS } from './openapi.tokens';
+import { OpenAPIConfigService, OpenAPIService } from './services';
+/** Default options when none provided */
+const DEFAULT_OPTIONS = {
+    jsonPath: '/api/openapi.json',
+    docsPath: '/api/docs',
+    info: {
+        title: 'API',
+        version: '1.0.0'
+    }
+};
+let OpenAPIModule = OpenAPIModule_1 = class OpenAPIModule {
+    /**
+     * Configure OpenAPI module with static options
+     *
+     * @param options - OpenAPI configuration (paths, info, security schemes)
+     * @returns DynamicModule with options provider
+     */
+    static forRoot(options = {}) {
+        // Merge with defaults
+        const mergedOptions = {
+            ...DEFAULT_OPTIONS,
+            ...options,
+            info: {
+                ...DEFAULT_OPTIONS.info,
+                ...options.info,
+                title: options.info?.title ?? DEFAULT_OPTIONS.info?.title ?? 'API',
+                version: options.info?.version ?? DEFAULT_OPTIONS.info?.version ?? '1.0.0',
+            }
+        };
+        return {
+            module: OpenAPIModule_1,
+            providers: [
+                { provide: OPENAPI_TOKENS.Options, useValue: mergedOptions }
+            ]
+        };
+    }
+    static forRootAsync(options) {
+        return {
+            module: OpenAPIModule_1,
+            providers: [
+                {
+                    provide: OPENAPI_TOKENS.Options,
+                    useFactory: options.useFactory,
+                    inject: options.inject
+                },
+            ]
+        };
+    }
+};
+OpenAPIModule = OpenAPIModule_1 = __decorate([
+    Module({
+        providers: [
+            // OpenAPI config service (request-scoped, supports runtime overrides)
+            { provide: OPENAPI_TOKENS.ConfigService, useClass: OpenAPIConfigService, scope: Scope.Request },
+            // OpenAPI service (generates specs, serves endpoints)
+            { provide: OPENAPI_TOKENS.OpenAPIService, useClass: OpenAPIService },
+        ],
+    })
+], OpenAPIModule);
+export { OpenAPIModule };
+//# sourceMappingURL=openapi.module.js.map

package/dist/openapi/openapi.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.module.js","sourceRoot":"","sources":["../../src/openapi/openapi.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;;;;;;;;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGjE,yCAAyC;AACzC,MAAM,eAAe,GAAyB;IAC5C,QAAQ,EAAE,mBAAmB;IAC7B,QAAQ,EAAE,WAAW;IACrB,IAAI,EAAE;QACJ,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,OAAO;KACjB;CACF,CAAA;AAUM,IAAM,aAAa,qBAAnB,MAAM,aAAa;IACxB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,UAAgC,EAAE;QAC/C,sBAAsB;QACtB,MAAM,aAAa,GAAyB;YAC1C,GAAG,eAAe;YAClB,GAAG,OAAO;YACV,IAAI,EAAE;gBACJ,GAAG,eAAe,CAAC,IAAI;gBACvB,GAAG,OAAO,CAAC,IAAI;gBACf,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,IAAI,eAAe,CAAC,IAAI,EAAE,KAAK,IAAI,KAAK;gBAClE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,IAAI,eAAe,CAAC,IAAI,EAAE,OAAO,IAAI,OAAO;aAC3E;SACF,CAAA;QAED,OAAO;YACL,MAAM,EAAE,eAAa;YACrB,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE;aAC7D;SACF,CAAA;IACH,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAAiD;QACnE,OAAO;YACL,MAAM,EAAE,eAAa;YACrB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,cAAc,CAAC,OAAO;oBAC/B,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;iBACvB;aACF;SACF,CAAA;IACH,CAAC;CACF,CAAA;AAxCY,aAAa;IARzB,MAAM,CAAC;QACN,SAAS,EAAE;YACT,sEAAsE;YACtE,EAAE,OAAO,EAAE,cAAc,CAAC,aAAa,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE;YAC/F,sDAAsD;YACtD,EAAE,OAAO,EAAE,cAAc,CAAC,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE;SACrE;KACF,CAAC;GACW,aAAa,CAwCzB"}

package/dist/openapi/openapi.tokens.d.ts

@@ -0,0 +1,12 @@
+/**
+ * OpenAPI Module DI Tokens
+ */
+export declare const OPENAPI_TOKENS: {
+    /** Static options provided via forRoot() */
+    readonly Options: symbol;
+    /** Request-scoped config service that supports runtime overrides */
+    readonly ConfigService: symbol;
+    /** OpenAPI service that generates specs and serves endpoints */
+    readonly OpenAPIService: symbol;
+};
+//# sourceMappingURL=openapi.tokens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.tokens.d.ts","sourceRoot":"","sources":["../../src/openapi/openapi.tokens.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB,4CAA4C;;IAG5C,oEAAoE;;IAGpE,gEAAgE;;CAExD,CAAA"}

package/dist/openapi/openapi.tokens.js

@@ -0,0 +1,12 @@
+/**
+ * OpenAPI Module DI Tokens
+ */
+export const OPENAPI_TOKENS = {
+    /** Static options provided via forRoot() */
+    Options: Symbol.for('OpenAPIModule.Options'),
+    /** Request-scoped config service that supports runtime overrides */
+    ConfigService: Symbol.for('OpenAPIModule.ConfigService'),
+    /** OpenAPI service that generates specs and serves endpoints */
+    OpenAPIService: Symbol.for('OpenAPIModule.OpenAPIService'),
+};
+//# sourceMappingURL=openapi.tokens.js.map

package/dist/openapi/openapi.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.tokens.js","sourceRoot":"","sources":["../../src/openapi/openapi.tokens.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC;IAE5C,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC;IAExD,gEAAgE;IAChE,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC;CAClD,CAAA"}

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

@@ -0,0 +1,3 @@
+export { OpenAPIConfigService } from './openapi-config.service';
+export { OpenAPIService } from './openapi.service';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/openapi/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/openapi/services/index.js

@@ -0,0 +1,3 @@
+export { OpenAPIConfigService } from './openapi-config.service';
+export { OpenAPIService } from './openapi.service';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/openapi/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}

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

@@ -0,0 +1,43 @@
+import type { IOpenAPIConfigService, OpenAPIConfigOverride, OpenAPIEffectiveConfig, OpenAPIModuleOptions } from '../types';
+/**
+ * OpenAPI Config Service
+ *
+ * Request-scoped service that manages OpenAPI configuration for the current request.
+ * Supports runtime overrides via middleware while preserving base configuration.
+ *
+ * @example
+ * ```typescript
+ * // In middleware (e.g., RouteAccessMiddleware)
+ * constructor(
+ *   @inject(OPENAPI_TOKENS.ConfigService) private openAPIConfig: IOpenAPIConfigService
+ * ) {}
+ *
+ * async handle(ctx, next) {
+ *   this.openAPIConfig.override({
+ *     info: { title: 'Tenant API' },
+ *     routeFilter: (path) => shouldInclude(path)
+ *   })
+ *   await next()
+ * }
+ * ```
+ */
+export declare class OpenAPIConfigService implements IOpenAPIConfigService {
+    private baseOptions?;
+    private overrides;
+    constructor(baseOptions?: OpenAPIModuleOptions | undefined);
+    /**
+     * Add configuration override for this request
+     * Overrides are merged in the order they are added
+     */
+    override(config: OpenAPIConfigOverride): void;
+    /**
+     * Get effective configuration (base merged with all overrides)
+     */
+    getEffectiveConfig(): OpenAPIEffectiveConfig;
+    /**
+     * Merge override into effective config
+     * Info is shallow-merged, routeFilter is replaced
+     */
+    private mergeConfig;
+}
+//# sourceMappingURL=openapi-config.service.d.ts.map

package/dist/openapi/services/openapi-config.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-config.service.d.ts","sourceRoot":"","sources":["../../../src/openapi/services/openapi-config.service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,UAAU,CAAA;AAEjB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBACa,oBAAqB,YAAW,qBAAqB;IAIR,OAAO,CAAC,WAAW,CAAC;IAH5E,OAAO,CAAC,SAAS,CAA8B;gBAGiB,WAAW,CAAC,EAAE,oBAAoB,YAAA;IAGlG;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAI7C;;OAEG;IACH,kBAAkB,IAAI,sBAAsB;IAqB5C;;;OAGG;IACH,OAAO,CAAC,WAAW;CAkBpB"}

package/dist/openapi/services/openapi-config.service.js

@@ -0,0 +1,98 @@
+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 { OPENAPI_TOKENS } from '../openapi.tokens';
+/**
+ * OpenAPI Config Service
+ *
+ * Request-scoped service that manages OpenAPI configuration for the current request.
+ * Supports runtime overrides via middleware while preserving base configuration.
+ *
+ * @example
+ * ```typescript
+ * // In middleware (e.g., RouteAccessMiddleware)
+ * constructor(
+ *   @inject(OPENAPI_TOKENS.ConfigService) private openAPIConfig: IOpenAPIConfigService
+ * ) {}
+ *
+ * async handle(ctx, next) {
+ *   this.openAPIConfig.override({
+ *     info: { title: 'Tenant API' },
+ *     routeFilter: (path) => shouldInclude(path)
+ *   })
+ *   await next()
+ * }
+ * ```
+ */
+let OpenAPIConfigService = class OpenAPIConfigService {
+    baseOptions;
+    overrides = [];
+    constructor(baseOptions) {
+        this.baseOptions = baseOptions;
+    }
+    /**
+     * Add configuration override for this request
+     * Overrides are merged in the order they are added
+     */
+    override(config) {
+        this.overrides.push(config);
+    }
+    /**
+     * Get effective configuration (base merged with all overrides)
+     */
+    getEffectiveConfig() {
+        // Start with base options and defaults
+        let effective = {
+            jsonPath: this.baseOptions?.jsonPath ?? '/api/openapi.json',
+            docsPath: this.baseOptions?.docsPath ?? '/api/docs',
+            info: {
+                title: this.baseOptions?.info?.title ?? 'API',
+                version: this.baseOptions?.info?.version ?? '1.0.0',
+                description: this.baseOptions?.info?.description
+            },
+            securitySchemes: this.baseOptions?.securitySchemes
+        };
+        // Merge each override in order
+        for (const override of this.overrides) {
+            effective = this.mergeConfig(effective, override);
+        }
+        return effective;
+    }
+    /**
+     * Merge override into effective config
+     * Info is shallow-merged, routeFilter is replaced
+     */
+    mergeConfig(base, override) {
+        return {
+            ...base,
+            info: {
+                ...base.info,
+                ...(override.info && {
+                    title: override.info.title ?? base.info.title,
+                    version: override.info.version ?? base.info.version,
+                    description: override.info.description ?? base.info.description
+                })
+            },
+            // Last routeFilter wins
+            routeFilter: override.routeFilter ?? base.routeFilter
+        };
+    }
+};
+OpenAPIConfigService = __decorate([
+    Transient(OPENAPI_TOKENS.ConfigService),
+    __param(0, inject(OPENAPI_TOKENS.Options, { isOptional: true })),
+    __metadata("design:paramtypes", [Object])
+], OpenAPIConfigService);
+export { OpenAPIConfigService };
+//# sourceMappingURL=openapi-config.service.js.map

package/dist/openapi/services/openapi-config.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-config.service.js","sourceRoot":"","sources":["../../../src/openapi/services/openapi-config.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAQlD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAIiC;IAHxD,SAAS,GAA4B,EAAE,CAAA;IAE/C,YACgE,WAAkC;QAAlC,gBAAW,GAAX,WAAW,CAAuB;IAC9F,CAAC;IAEL;;;OAGG;IACH,QAAQ,CAAC,MAA6B;QACpC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC7B,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,uCAAuC;QACvC,IAAI,SAAS,GAA2B;YACtC,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,IAAI,mBAAmB;YAC3D,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,IAAI,WAAW;YACnD,IAAI,EAAE;gBACJ,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,IAAI,KAAK;gBAC7C,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,IAAI,OAAO;gBACnD,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,WAAW;aACjD;YACD,eAAe,EAAE,IAAI,CAAC,WAAW,EAAE,eAAe;SACnD,CAAA;QAED,+BAA+B;QAC/B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QACnD,CAAC;QAED,OAAO,SAAS,CAAA;IAClB,CAAC;IAED;;;OAGG;IACK,WAAW,CACjB,IAA4B,EAC5B,QAA+B;QAE/B,OAAO;YACL,GAAG,IAAI;YACP,IAAI,EAAE;gBACJ,GAAG,IAAI,CAAC,IAAI;gBACZ,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI;oBACnB,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK;oBAC7C,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO;oBACnD,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW;iBAChE,CAAC;aACH;YACD,wBAAwB;YACxB,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW;SACtD,CAAA;IACH,CAAC;CACF,CAAA;AA7DY,oBAAoB;IADhC,SAAS,CAAC,cAAc,CAAC,aAAa,CAAC;IAKnC,WAAA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAA;;GAJ5C,oBAAoB,CA6DhC"}