stratal 0.0.21 → 0.0.23

package/dist/openapi/index.d.mts

@@ -1,6 +1,6 @@
-import { Xn as RouterEnv, gn as AsyncModuleOptions, vn as DynamicModule } from "../index-ByOyTmqf.mjs";
-import { n as OpenAPIObject, r as PathItemObject } from "../index-Bnpfq6uk.mjs";
-import { t as OpenAPIService } from "../openapi.service-Bt9bCIrd.mjs";
+import { Dn as AsyncModuleOptions, kn as DynamicModule, or as RouterEnv } from "../index-B_JoEl3V.mjs";
+import { n as OpenAPIObject, r as PathItemObject } from "../zod-wecrEVAs.mjs";
+import { t as OpenAPIService } from "../openapi.service-YhTiJ1bO.mjs";
 import { MiddlewareHandler } from "hono/types";
 
 //#region src/openapi/types.d.ts
@@ -71,7 +71,18 @@ interface OpenAPIEffectiveConfig {
   ui?: OpenAPIUIOptions | false;
 }
 /**
- * OpenAPI config service interface
+ * Singleton holder of the static base config. Resolvable outside a request for
+ * static config (mount paths, base info) with no per-request state.
+ */
+interface IOpenAPIConfigStore {
+  /**
+   * Get the static base config (no per-request overrides applied).
+   */
+  getBaseConfig(): OpenAPIEffectiveConfig;
+}
+/**
+ * Request-scoped config service: reads through to {@link IOpenAPIConfigStore}
+ * and layers per-request overrides on top.
  */
 interface IOpenAPIConfigService {
   /**
@@ -102,7 +113,13 @@ declare class OpenAPIModule {
  * OpenAPI Module DI Tokens
  */
 declare const OPENAPI_TOKENS: {
-  /** Static options provided via forRoot() */readonly Options: symbol; /** Request-scoped config service that supports runtime overrides */
+  /** Static options provided via forRoot() */readonly Options: symbol;
+  /**
+   * Singleton holder of the static base config. Resolvable outside a request
+   * (bootstrap endpoint mounting, CLI commands) for static config — never throws
+   * on resolve and carries no per-request state.
+   */
+  readonly ConfigStore: symbol; /** Request-scoped config service that layers runtime overrides over the store */
   readonly ConfigService: symbol; /** OpenAPI service that generates specs and serves endpoints */
   readonly OpenAPIService: symbol;
 };
@@ -131,9 +148,9 @@ declare const OPENAPI_TOKENS: {
  * ```
  */
 declare class OpenAPIConfigService implements IOpenAPIConfigService {
-  private baseOptions?;
+  private store;
   private overrides;
-  constructor(baseOptions?: OpenAPIModuleOptions | undefined);
+  constructor(store: IOpenAPIConfigStore);
   /**
    * Add configuration override for this request.
    * Overrides are merged in the order they are added.
@@ -148,6 +165,25 @@ declare class OpenAPIConfigService implements IOpenAPIConfigService {
   private mergeConfig;
 }
 //#endregion
+//#region src/openapi/services/openapi-config.store.d.ts
+/**
+ * OpenAPI Config Store
+ *
+ * Singleton holder of the static base configuration (mount paths, base info,
+ * security schemes) derived from `OpenAPIModule.forRoot()` options. It carries
+ * no per-request state, so it is the thing to resolve when you need OpenAPI
+ * config OUTSIDE a request scope — endpoint mounting at bootstrap, the
+ * `mcp:serve` CLI command, etc. Resolving it never throws on its own.
+ *
+ * Per-request overrides live on {@link OpenAPIConfigService}, which reads the
+ * base config from here and merges its overrides on top.
+ */
+declare class OpenAPIConfigStore implements IOpenAPIConfigStore {
+  private baseOptions?;
+  constructor(baseOptions?: OpenAPIModuleOptions | undefined);
+  getBaseConfig(): OpenAPIEffectiveConfig;
+}
+//#endregion
 //#region src/openapi/services/openapi-tools.service.d.ts
 type JsonSchema = Record<string, unknown>;
 interface ToolDefinition {
@@ -198,5 +234,5 @@ declare class OpenApiToolsService {
   private getOperation;
 }
 //#endregion
-export { type Dispatcher, type IOpenAPIConfigService, OPENAPI_TOKENS, type OpenAPIConfigOverride, OpenAPIConfigService, type OpenAPIEffectiveConfig, type OpenAPIInfo, OpenAPIModule, type OpenAPIModuleOptions, OpenAPIService, type OpenAPIUIContext, type OpenAPIUIOptions, type OpenAPIUIRenderer, OpenApiToolsService, type RouteFilterFn, type ToolDefinition, type ToolExecutionResult, type ToolFilter };
+export { type Dispatcher, type IOpenAPIConfigService, type IOpenAPIConfigStore, OPENAPI_TOKENS, type OpenAPIConfigOverride, OpenAPIConfigService, OpenAPIConfigStore, type OpenAPIEffectiveConfig, type OpenAPIInfo, OpenAPIModule, type OpenAPIModuleOptions, OpenAPIService, type OpenAPIUIContext, type OpenAPIUIOptions, type OpenAPIUIRenderer, OpenApiToolsService, type RouteFilterFn, type ToolDefinition, type ToolExecutionResult, type ToolFilter };
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/openapi/types.ts","../../src/openapi/openapi.module.ts","../../src/openapi/openapi.tokens.ts","../../src/openapi/services/openapi-config.service.ts","../../src/openapi/services/openapi-tools.service.ts"],"mappings":";;;;;;;;;UAOiB,WAAA;EACf,KAAA;EACA,OAAA;EACA,WAAA;AAAA;;;;UAMe,gBAAA;EACf,OAAA;EACA,KAAA;AAAA;;;AAOF;;KAAY,iBAAA,IAAqB,OAAA,EAAS,gBAAA,KAAqB,iBAAA,CAAkB,SAAA;;;;UAKhE,gBAAA;EAL+D;EAO9E,IAAA;EAP+B;EAS/B,QAAA,GAAW,iBAAA;AAAA;;;AAJb;UAUiB,oBAAA;;EAEf,QAAA;EAVA;EAaA,IAAA,GAAO,WAAA;EAXI;EAcX,eAAA,GAAkB,MAAA;EAdU;EAiB5B,EAAA,GAAK,gBAAA;AAAA;;;;;KAOK,aAAA,IAAiB,IAAA,UAAc,QAAA,EAAU,cAAA;;;;UAKpC,qBAAA;EAff;EAiBA,IAAA,GAAO,OAAA,CAAQ,WAAA;EAdf;EAiBA,WAAA,GAAc,aAAA;AAAA;;AAVhB;;UAgBiB,sBAAA;EACf,QAAA;EACA,IAAA,EAAM,WAAA;EACN,eAAA,GAAkB,MAAA;EAClB,WAAA,GAAc,aAAA;EACd,EAAA,GAAK,gBAAA;AAAA;AAhBP;;;AAAA,UAsBiB,qBAAA;EApBR;;;;EAyBP,QAAA,CAAS,MAAA,EAAQ,qBAAA;EAzBV;;;EA8BP,kBAAA,IAAsB,sBAAA;AAAA;;;cC/BX,aAAA;ED9BiB;AAM9B;;;;;EAN8B,OCqCrB,OAAA,CAAQ,OAAA,GAAS,oBAAA,GAA4B,aAAA;EAAA,OAqB7C,YAAA,CAAa,OAAA,EAAS,kBAAA,CAAmB,oBAAA,IAAwB,aAAA;AAAA;;;;;;cCzF7D,cAAA;wEFII;EAAA;;;;;;;;;;AAAjB;;;;;;;;;AASA;;;;;AASA;;;cGQa,oBAAA,YAAgC,qBAAA;EAAA,QAIqB,WAAA;EAAA,QAHxD,SAAA;cAGwD,WAAA,GAAc,oBAAA;EHZA;;;;EGmB9E,QAAA,CAAS,MAAA,EAAQ,qBAAA;EHnBuE;EGwBxF,kBAAA,CAAA,GAAsB,sBAAA;EHnBP;;;;EAAA,QG0CP,WAAA;AAAA;;;KCrEL,UAAA,GAAa,MAAA;AAAA,UAED,cAAA;EACf,IAAA;EACA,WAAA;EACA,WAAA,EAAa,UAAA;EACb,MAAA;EACA,IAAA;EACA,UAAA;AAAA;AAAA,UAGe,mBAAA;EACf,MAAA;EACA,IAAA;EACA,OAAA,EAAS,MAAA;AAAA;AAAA,UAGM,UAAA;EACf,IAAA;EACA,UAAA;AAAA;AAAA,KAGU,UAAA,IAAc,MAAA,UAAgB,GAAA,UAAa,OAAA;EACrD,IAAA;EACA,OAAA,GAAU,MAAA;AAAA,MACN,OAAA,CAAQ,QAAA;;;;;;cA6BD,mBAAA;EAAA,wBACa,YAAA;EAAA,QAEhB,KAAA;EAAA,QACA,OAAA;EAAA,QACA,UAAA;EAAA,QAEA,IAAA;cAEI,IAAA,EAAM,aAAA,EAAe,OAAA;IAAY,UAAA,GAAa,UAAA;EAAA;EAS1D,QAAA,CAAS,MAAA,GAAS,UAAA,GAAa,cAAA;EAmB/B,OAAA,CAAQ,IAAA,WAAe,cAAA;EAIjB,WAAA,CAAY,IAAA,UAAc,IAAA,EAAM,MAAA,oBAA0B,OAAA,CAAQ,mBAAA;EAAA,QAmDhE,UAAA;EAAA,QAuBA,YAAA;EAAA,QASA,gBAAA;EAAA,QAOA,gBAAA;EAAA,QA+CA,eAAA;EAAA,QAYA,UAAA;EAAA,QA4BA,SAAA;EAAA,QAaA,YAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/openapi/types.ts","../../src/openapi/openapi.module.ts","../../src/openapi/openapi.tokens.ts","../../src/openapi/services/openapi-config.service.ts","../../src/openapi/services/openapi-config.store.ts","../../src/openapi/services/openapi-tools.service.ts"],"mappings":"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"}

package/dist/openapi/index.mjs

@@ -1,3 +1,3 @@
-import { A as OpenAPIModule, V as OpenAPIConfigService, j as OpenAPIService } from "../i18n.module-CzXLW9Hy.mjs";
-import { n as OPENAPI_TOKENS, t as OpenApiToolsService } from "../openapi-tools.service-Zs-Ewv7F.mjs";
-export { OPENAPI_TOKENS, OpenAPIConfigService, OpenAPIModule, OpenAPIService, OpenApiToolsService };
+import { n as OPENAPI_TOKENS, t as OpenApiToolsService } from "../openapi-tools.service-BC5EC3R3.mjs";
+import { i as OpenAPIConfigService, n as OpenAPIService, r as OpenAPIConfigStore, t as OpenAPIModule } from "../openapi-CstuTM8S.mjs";
+export { OPENAPI_TOKENS, OpenAPIConfigService, OpenAPIConfigStore, OpenAPIModule, OpenAPIService, OpenApiToolsService };

package/dist/openapi-CstuTM8S.mjs

@@ -0,0 +1,309 @@
+import { d as inject, o as Request, s as Singleton } from "./di-DseMn-z9.mjs";
+import { n as __decorateParam, t as __decorate } from "./decorate-CuAoSZvs.mjs";
+import { d as SECURITY_SCHEMES, l as ROUTER_CONTEXT_KEYS } from "./exception-context-kEoMFwze.mjs";
+import { n as Module } from "./module.decorator-CYHY6pG5.mjs";
+import "./module/index.mjs";
+import { t as I18N_TOKENS } from "./i18n.tokens-CZ_v8oyS.mjs";
+import { n as OPENAPI_TOKENS } from "./openapi-tools.service-BC5EC3R3.mjs";
+//#region src/openapi/services/openapi-config.service.ts
+let OpenAPIConfigService = class OpenAPIConfigService {
+	store;
+	overrides = [];
+	constructor(store) {
+		this.store = store;
+	}
+	/**
+	* 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() {
+		let effective = this.store.getBaseConfig();
+		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
+				}
+			},
+			routeFilter: override.routeFilter ?? base.routeFilter
+		};
+	}
+};
+OpenAPIConfigService = __decorate([Request(OPENAPI_TOKENS.ConfigService), __decorateParam(0, inject(OPENAPI_TOKENS.ConfigStore))], OpenAPIConfigService);
+//#endregion
+//#region src/openapi/services/openapi-config.store.ts
+let OpenAPIConfigStore = class OpenAPIConfigStore {
+	baseOptions;
+	constructor(baseOptions) {
+		this.baseOptions = baseOptions;
+	}
+	getBaseConfig() {
+		return {
+			jsonPath: this.baseOptions?.jsonPath ?? "/api/openapi.json",
+			ui: this.baseOptions?.ui,
+			info: {
+				title: this.baseOptions?.info?.title ?? "API",
+				version: this.baseOptions?.info?.version ?? "1.0.0",
+				description: this.baseOptions?.info?.description
+			},
+			securitySchemes: this.baseOptions?.securitySchemes
+		};
+	}
+};
+OpenAPIConfigStore = __decorate([Singleton(OPENAPI_TOKENS.ConfigStore), __decorateParam(0, inject(OPENAPI_TOKENS.Options, { isOptional: true }))], OpenAPIConfigStore);
+//#endregion
+//#region src/openapi/services/openapi.service.ts
+let OpenAPIService = class OpenAPIService {
+	/**
+	* Generate a filtered OpenAPI spec using the user's config.
+	* Usable from both HTTP handlers and CLI commands.
+	*/
+	getSpec(app, container) {
+		const configService = container.resolve(OPENAPI_TOKENS.ConfigService);
+		const i18n = container.resolve(I18N_TOKENS.I18nService);
+		const config = configService.getEffectiveConfig();
+		const fullSpec = app.getOpenAPIDocument({
+			openapi: "3.0.0",
+			info: {
+				version: config.info.version,
+				title: config.info.title,
+				description: config.info.description
+			}
+		});
+		fullSpec.components ??= {};
+		fullSpec.components.securitySchemes = this.getSecuritySchemeDefinitions(i18n);
+		if (config.routeFilter) fullSpec.paths = this.filterRoutes(fullSpec.paths, config);
+		if (fullSpec.components.schemas) fullSpec.components.schemas = this.filterSchemas(fullSpec);
+		return fullSpec;
+	}
+	/**
+	* Setup OpenAPI documentation endpoints
+	*/
+	setupEndpoints(app, container) {
+		const config = container.resolve(OPENAPI_TOKENS.ConfigStore).getBaseConfig();
+		const jsonPath = config.jsonPath;
+		const ui = config.ui;
+		app.get(jsonPath, (c) => {
+			const requestContainer = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER);
+			const fullSpec = this.getSpec(app, requestContainer);
+			const url = new URL(c.req.raw.url);
+			const i18n = requestContainer.resolve(I18N_TOKENS.I18nService);
+			fullSpec.servers = [{
+				url: `${url.protocol}//${url.host}`,
+				description: i18n.t("common.api.serverDescription")
+			}];
+			return c.json(fullSpec);
+		});
+		this.nameLastHandler(app, "OpenAPI", "spec");
+		if (ui !== false) {
+			const uiPath = ui?.path ?? "/api/docs";
+			const uiRenderer = ui?.renderer;
+			app.get(uiPath, async (c, next) => {
+				const effectiveConfig = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER).resolve(OPENAPI_TOKENS.ConfigService).getEffectiveConfig();
+				const uiContext = {
+					specUrl: effectiveConfig.jsonPath,
+					title: effectiveConfig.info.title
+				};
+				if (uiRenderer) return uiRenderer(uiContext)(c, next);
+				const { swaggerUI } = await import("@hono/swagger-ui");
+				return swaggerUI({ url: uiContext.specUrl })(c, next);
+			});
+			this.nameLastHandler(app, "OpenAPI", "docs");
+		}
+	}
+	nameLastHandler(app, controller, method) {
+		const last = app.routes[app.routes.length - 1];
+		Object.defineProperty(last.handler, "name", { value: `http:${controller}.${method}` });
+	}
+	/**
+	* Get localized security scheme definitions
+	*/
+	getSecuritySchemeDefinitions(i18n) {
+		return {
+			[SECURITY_SCHEMES.BEARER_AUTH]: {
+				type: "http",
+				scheme: "bearer",
+				bearerFormat: "JWT",
+				description: i18n.t("common.api.security.bearerAuth")
+			},
+			[SECURITY_SCHEMES.API_KEY]: {
+				type: "apiKey",
+				in: "header",
+				name: "X-API-Key",
+				description: i18n.t("common.api.security.apiKey")
+			},
+			[SECURITY_SCHEMES.SESSION_COOKIE]: {
+				type: "apiKey",
+				in: "cookie",
+				name: "session",
+				description: i18n.t("common.api.security.sessionCookie")
+			}
+		};
+	}
+	/**
+	* Filter OpenAPI paths using custom routeFilter
+	*/
+	filterRoutes(paths, config) {
+		const filteredPaths = {};
+		for (const [path, pathItem] of Object.entries(paths)) {
+			if (config.routeFilter && !config.routeFilter(path, pathItem)) continue;
+			filteredPaths[path] = pathItem;
+		}
+		return filteredPaths;
+	}
+	/**
+	* Filter unreferenced schemas from OpenAPI spec
+	*/
+	filterSchemas(spec) {
+		const referencedSchemas = /* @__PURE__ */ new Set();
+		this.collectSchemaRefs(spec.paths, referencedSchemas);
+		const filteredSchemas = {};
+		const components = spec.components;
+		if (components?.schemas) {
+			const allSchemas = components.schemas;
+			let prevSize = 0;
+			while (referencedSchemas.size > prevSize) {
+				prevSize = referencedSchemas.size;
+				for (const [schemaName, schemaValue] of Object.entries(allSchemas)) if (referencedSchemas.has(schemaName) && !filteredSchemas[schemaName]) {
+					filteredSchemas[schemaName] = schemaValue;
+					this.collectSchemaRefs(schemaValue, referencedSchemas);
+				}
+			}
+		}
+		return filteredSchemas;
+	}
+	/**
+	* Recursively collect all schema references from an object
+	*/
+	collectSchemaRefs(obj, refs) {
+		if (!obj || typeof obj !== "object") return;
+		const record = obj;
+		if (record.$ref && typeof record.$ref === "string") {
+			const match = /^#\/components\/schemas\/(.+)$/.exec(record.$ref);
+			if (match) refs.add(match[1]);
+		}
+		if (Array.isArray(obj)) for (const item of obj) this.collectSchemaRefs(item, refs);
+		else for (const value of Object.values(record)) this.collectSchemaRefs(value, refs);
+	}
+};
+OpenAPIService = __decorate([Singleton(OPENAPI_TOKENS.OpenAPIService)], OpenAPIService);
+//#endregion
+//#region src/openapi/openapi.module.ts
+/**
+* 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: 'Custom API' },
+*     routeFilter: (path) => this.shouldInclude(path)
+*   })
+*   await next()
+* }
+* ```
+*/
+var _OpenAPIModule;
+/** Default options when none provided */
+const DEFAULT_OPTIONS = {
+	jsonPath: "/api/openapi.json",
+	info: {
+		title: "API",
+		version: "1.0.0"
+	}
+};
+let OpenAPIModule = _OpenAPIModule = class OpenAPIModule {
+	/**
+	* Configure OpenAPI module with static options
+	*
+	* @param options - OpenAPI configuration (paths, info, security schemes)
+	* @returns DynamicModule with options provider
+	*/
+	static forRoot(options = {}) {
+		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,
+			providers: [{
+				provide: OPENAPI_TOKENS.Options,
+				useValue: mergedOptions
+			}]
+		};
+	}
+	static forRootAsync(options) {
+		return {
+			module: _OpenAPIModule,
+			providers: [{
+				provide: OPENAPI_TOKENS.Options,
+				useFactory: options.useFactory,
+				inject: options.inject
+			}]
+		};
+	}
+};
+OpenAPIModule = _OpenAPIModule = __decorate([Module({ providers: [
+	{
+		provide: OPENAPI_TOKENS.ConfigStore,
+		useClass: OpenAPIConfigStore
+	},
+	{
+		provide: OPENAPI_TOKENS.ConfigService,
+		useClass: OpenAPIConfigService
+	},
+	{
+		provide: OPENAPI_TOKENS.OpenAPIService,
+		useClass: OpenAPIService
+	}
+] })], OpenAPIModule);
+//#endregion
+export { OpenAPIConfigService as i, OpenAPIService as n, OpenAPIConfigStore as r, OpenAPIModule as t };
+
+//# sourceMappingURL=openapi-CstuTM8S.mjs.map

package/dist/openapi-CstuTM8S.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-CstuTM8S.mjs","names":[],"sources":["../src/openapi/services/openapi-config.service.ts","../src/openapi/services/openapi-config.store.ts","../src/openapi/services/openapi.service.ts","../src/openapi/openapi.module.ts"],"sourcesContent":["import { inject } from '../../di'\nimport { Request } from '../../di/decorators'\nimport { OPENAPI_TOKENS } from '../openapi.tokens'\nimport type {\n  IOpenAPIConfigService,\n  IOpenAPIConfigStore,\n  OpenAPIConfigOverride,\n  OpenAPIEffectiveConfig\n} from '../types'\n\n/**\n * OpenAPI Config Service\n *\n * Request-scoped service that manages OpenAPI configuration for the current request.\n * Supports runtime overrides via middleware while preserving base configuration.\n *\n * @example\n * ```typescript\n * // In middleware (e.g., RouteAccessMiddleware)\n * constructor(\n *   @inject(OPENAPI_TOKENS.ConfigService) private openAPIConfig: IOpenAPIConfigService\n * ) {}\n *\n * async handle(ctx, next) {\n *   this.openAPIConfig.override({\n *     info: { title: 'Custom API' },\n *     routeFilter: (path) => shouldInclude(path)\n *   })\n *   await next()\n * }\n * ```\n */\n@Request(OPENAPI_TOKENS.ConfigService)\nexport class OpenAPIConfigService implements IOpenAPIConfigService {\n  private overrides: OpenAPIConfigOverride[] = []\n\n  constructor(\n    @inject(OPENAPI_TOKENS.ConfigStore) private store: IOpenAPIConfigStore\n  ) { }\n\n  /**\n   * Add configuration override for this request.\n   * Overrides are merged in the order they are added.\n   */\n  override(config: OpenAPIConfigOverride): void {\n    this.overrides.push(config)\n  }\n\n  /** Get effective configuration (base merged with all overrides) */\n  getEffectiveConfig(): OpenAPIEffectiveConfig {\n    let effective = this.store.getBaseConfig()\n\n    for (const override of this.overrides) {\n      effective = this.mergeConfig(effective, override)\n    }\n\n    return effective\n  }\n\n  /**\n   * Merge override into effective config.\n   * Info is shallow-merged, routeFilter is replaced.\n   */\n  private mergeConfig(\n    base: OpenAPIEffectiveConfig,\n    override: OpenAPIConfigOverride\n  ): OpenAPIEffectiveConfig {\n    return {\n      ...base,\n      info: {\n        ...base.info,\n        ...(override.info && {\n          title: override.info.title ?? base.info.title,\n          version: override.info.version ?? base.info.version,\n          description: override.info.description ?? base.info.description\n        })\n      },\n      routeFilter: override.routeFilter ?? base.routeFilter\n    }\n  }\n}\n","import { inject } from '../../di'\nimport { Singleton } from '../../di/decorators'\nimport { OPENAPI_TOKENS } from '../openapi.tokens'\nimport type {\n  IOpenAPIConfigStore,\n  OpenAPIEffectiveConfig,\n  OpenAPIModuleOptions\n} from '../types'\n\n/**\n * OpenAPI Config Store\n *\n * Singleton holder of the static base configuration (mount paths, base info,\n * security schemes) derived from `OpenAPIModule.forRoot()` options. It carries\n * no per-request state, so it is the thing to resolve when you need OpenAPI\n * config OUTSIDE a request scope — endpoint mounting at bootstrap, the\n * `mcp:serve` CLI command, etc. Resolving it never throws on its own.\n *\n * Per-request overrides live on {@link OpenAPIConfigService}, which reads the\n * base config from here and merges its overrides on top.\n */\n@Singleton(OPENAPI_TOKENS.ConfigStore)\nexport class OpenAPIConfigStore implements IOpenAPIConfigStore {\n  constructor(\n    @inject(OPENAPI_TOKENS.Options, { isOptional: true }) private baseOptions?: OpenAPIModuleOptions\n  ) { }\n\n  getBaseConfig(): OpenAPIEffectiveConfig {\n    return {\n      jsonPath: this.baseOptions?.jsonPath ?? '/api/openapi.json',\n      ui: this.baseOptions?.ui,\n      info: {\n        title: this.baseOptions?.info?.title ?? 'API',\n        version: this.baseOptions?.info?.version ?? '1.0.0',\n        description: this.baseOptions?.info?.description\n      },\n      securitySchemes: this.baseOptions?.securitySchemes\n    }\n  }\n}\n","import type { Container } from '../../di/container'\nimport { Singleton } from '../../di/decorators'\nimport { I18N_TOKENS } from '../../i18n/i18n.tokens'\nimport type { II18nService } from '../../i18n/i18n.types'\nimport type { OpenAPIHono, OpenAPIObject, PathItemObject } from '../../i18n/validation/zod'\nimport { ROUTER_CONTEXT_KEYS, SECURITY_SCHEMES } from '../../router/constants'\nimport type { RouterEnv } from '../../router/types'\nimport { OPENAPI_TOKENS } from '../openapi.tokens'\nimport type { IOpenAPIConfigService, IOpenAPIConfigStore, OpenAPIEffectiveConfig } from '../types'\n\n/**\n * OpenAPI Service\n *\n * Generates OpenAPI specifications with support for:\n * - Runtime configuration via OpenAPIConfigService\n * - Route filtering via custom routeFilter\n * - i18n support for titles and descriptions\n * - Security scheme definitions\n *\n * Hidden routes (hideFromDocs) are excluded at registration time via\n * @hono/zod-openapi's `hide` option and don't appear in the spec.\n *\n * Configuration is resolved per-request from OpenAPIConfigService,\n * allowing middleware to override config based on domain context.\n */\n@Singleton(OPENAPI_TOKENS.OpenAPIService)\nexport class OpenAPIService {\n\n  /**\n   * Generate a filtered OpenAPI spec using the user's config.\n   * Usable from both HTTP handlers and CLI commands.\n   */\n  getSpec(app: OpenAPIHono<RouterEnv>, container: Container): OpenAPIObject {\n    const configService = container.resolve<IOpenAPIConfigService>(OPENAPI_TOKENS.ConfigService)\n    const i18n = container.resolve<II18nService>(I18N_TOKENS.I18nService)\n    const config = configService.getEffectiveConfig()\n\n    const fullSpec = app.getOpenAPIDocument({\n      openapi: '3.0.0',\n      info: {\n        version: config.info.version,\n        title: config.info.title,\n        description: config.info.description,\n      },\n    })\n\n    // Security schemes\n    fullSpec.components ??= {}\n    fullSpec.components.securitySchemes = this.getSecuritySchemeDefinitions(i18n)\n\n    // Apply custom routeFilter if provided\n    if (config.routeFilter) {\n      fullSpec.paths = this.filterRoutes(\n        fullSpec.paths as Record<string, PathItemObject>,\n        config,\n      )\n    }\n\n    // Filter unreferenced schemas\n    if (fullSpec.components.schemas) {\n      fullSpec.components.schemas = this.filterSchemas(fullSpec as unknown as Record<string, unknown>) as typeof fullSpec.components.schemas\n    }\n\n    return fullSpec\n  }\n\n  /**\n   * Setup OpenAPI documentation endpoints\n   */\n  setupEndpoints(app: OpenAPIHono<RouterEnv>, container: Container): void {\n    // Endpoints are mounted at bootstrap (no request scope), so read the static\n    // mount paths from the singleton config store — request overrides (info /\n    // routeFilter) never affect jsonPath/ui and are resolved per request inside\n    // the handlers below via the request-scoped config service.\n    const config = container.resolve<IOpenAPIConfigStore>(OPENAPI_TOKENS.ConfigStore).getBaseConfig()\n    const jsonPath = config.jsonPath\n    const ui = config.ui\n\n    // OpenAPI JSON spec endpoint\n    app.get(jsonPath, (c) => {\n      const requestContainer = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER)\n      const fullSpec = this.getSpec(app, requestContainer)\n\n      // Add servers (HTTP-specific — needs request URL context)\n      const url = new URL(c.req.raw.url)\n      const i18n = requestContainer.resolve<II18nService>(I18N_TOKENS.I18nService)\n      fullSpec.servers = [{\n        url: `${url.protocol}//${url.host}`,\n        description: i18n.t('common.api.serverDescription'),\n      }]\n\n      return c.json(fullSpec)\n    })\n    this.nameLastHandler(app, 'OpenAPI', 'spec')\n\n    // Docs UI endpoint\n    if (ui !== false) {\n      const uiPath = ui?.path ?? '/api/docs'\n      const uiRenderer = ui?.renderer\n\n      app.get(uiPath, async (c, next) => {\n        const requestContainer = c.get(ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER)\n        const requestConfigService = requestContainer.resolve<IOpenAPIConfigService>(\n          OPENAPI_TOKENS.ConfigService\n        )\n        const effectiveConfig = requestConfigService.getEffectiveConfig()\n        const uiContext = { specUrl: effectiveConfig.jsonPath, title: effectiveConfig.info.title }\n\n        if (uiRenderer) {\n          return uiRenderer(uiContext)(c, next)\n        }\n\n        const { swaggerUI } = await import('@hono/swagger-ui')\n        return swaggerUI<RouterEnv>({ url: uiContext.specUrl })(c, next)\n      })\n      this.nameLastHandler(app, 'OpenAPI', 'docs')\n    }\n  }\n\n  private nameLastHandler(app: OpenAPIHono<RouterEnv>, controller: string, method: string): void {\n    const last = app.routes[app.routes.length - 1]\n    Object.defineProperty(last.handler, 'name', { value: `http:${controller}.${method}` })\n  }\n\n  /**\n   * Get localized security scheme definitions\n   */\n  private getSecuritySchemeDefinitions(i18n: II18nService) {\n    return {\n      [SECURITY_SCHEMES.BEARER_AUTH]: {\n        type: 'http',\n        scheme: 'bearer',\n        bearerFormat: 'JWT',\n        description: i18n.t('common.api.security.bearerAuth')\n      },\n      [SECURITY_SCHEMES.API_KEY]: {\n        type: 'apiKey',\n        in: 'header',\n        name: 'X-API-Key',\n        description: i18n.t('common.api.security.apiKey')\n      },\n      [SECURITY_SCHEMES.SESSION_COOKIE]: {\n        type: 'apiKey',\n        in: 'cookie',\n        name: 'session',\n        description: i18n.t('common.api.security.sessionCookie')\n      }\n    } as const\n  }\n\n  /**\n   * Filter OpenAPI paths using custom routeFilter\n   */\n  private filterRoutes(\n    paths: Record<string, PathItemObject>,\n    config: OpenAPIEffectiveConfig\n  ): Record<string, PathItemObject> {\n    const filteredPaths: Record<string, PathItemObject> = {}\n\n    for (const [path, pathItem] of Object.entries(paths)) {\n      if (config.routeFilter && !config.routeFilter(path, pathItem)) {\n        continue\n      }\n\n      filteredPaths[path] = pathItem\n    }\n\n    return filteredPaths\n  }\n\n  /**\n   * Filter unreferenced schemas from OpenAPI spec\n   */\n  private filterSchemas(spec: Record<string, unknown>): Record<string, unknown> {\n    const referencedSchemas = new Set<string>()\n\n    // Collect all schema references from paths\n    this.collectSchemaRefs(spec.paths, referencedSchemas)\n\n    // Filter schemas to only include referenced ones\n    const filteredSchemas: Record<string, unknown> = {}\n    const components = spec.components as Record<string, unknown> | undefined\n    if (components?.schemas) {\n      const allSchemas = components.schemas as Record<string, unknown>\n      let prevSize = 0\n      while (referencedSchemas.size > prevSize) {\n        prevSize = referencedSchemas.size\n        for (const [schemaName, schemaValue] of Object.entries(allSchemas)) {\n          if (referencedSchemas.has(schemaName) && !filteredSchemas[schemaName]) {\n            filteredSchemas[schemaName] = schemaValue\n            this.collectSchemaRefs(schemaValue, referencedSchemas)\n          }\n        }\n      }\n    }\n\n    return filteredSchemas\n  }\n\n  /**\n   * Recursively collect all schema references from an object\n   */\n  private collectSchemaRefs(obj: unknown, refs: Set<string>): void {\n    if (!obj || typeof obj !== 'object') {\n      return\n    }\n\n    const record = obj as Record<string, unknown>\n\n    // Check if this object has a $ref property\n    if (record.$ref && typeof record.$ref === 'string') {\n      // Extract schema name from $ref (format: #/components/schemas/SchemaName)\n      const match = /^#\\/components\\/schemas\\/(.+)$/.exec(record.$ref)\n      if (match) {\n        refs.add(match[1])\n      }\n    }\n\n    // Recursively check all properties\n    if (Array.isArray(obj)) {\n      for (const item of obj) {\n        this.collectSchemaRefs(item, refs)\n      }\n    } else {\n      for (const value of Object.values(record)) {\n        this.collectSchemaRefs(value, refs)\n      }\n    }\n  }\n}\n","/**\n * OpenAPI Module\n *\n * Provides configurable OpenAPI documentation endpoints with runtime override support.\n *\n * Features:\n * - Configurable paths for /openapi.json and /docs\n * - Runtime config overrides via middleware\n * - i18n support for titles and descriptions\n * - Route filtering via hideFromDocs and custom routeFilter\n *\n * @example Basic usage\n * ```typescript\n * @Module({\n *   imports: [\n *     OpenAPIModule.forRoot({\n *       info: { title: 'My API', version: '1.0.0' }\n *     })\n *   ]\n * })\n * export class AppModule {}\n * ```\n *\n * @example With runtime override in middleware\n * ```typescript\n * // In RouteAccessMiddleware\n * constructor(\n *   @inject(OPENAPI_TOKENS.ConfigService) private openAPIConfig: IOpenAPIConfigService\n * ) {}\n *\n * async handle(ctx, next) {\n *   this.openAPIConfig.override({\n *     info: { title: 'Custom API' },\n *     routeFilter: (path) => this.shouldInclude(path)\n *   })\n *   await next()\n * }\n * ```\n */\n\nimport { Module } from '../module'\nimport type { AsyncModuleOptions, DynamicModule } from '../module/types'\nimport { OPENAPI_TOKENS } from './openapi.tokens'\nimport { OpenAPIConfigService, OpenAPIConfigStore, OpenAPIService } from './services'\nimport type { OpenAPIModuleOptions } from './types'\n\n/** Default options when none provided */\nconst DEFAULT_OPTIONS: OpenAPIModuleOptions = {\n  jsonPath: '/api/openapi.json',\n  info: {\n    title: 'API',\n    version: '1.0.0'\n  }\n}\n\n@Module({\n  providers: [\n    // Static base config (singleton — resolvable outside a request scope)\n    { provide: OPENAPI_TOKENS.ConfigStore, useClass: OpenAPIConfigStore },\n    // OpenAPI config service (request-scoped, supports runtime overrides)\n    { provide: OPENAPI_TOKENS.ConfigService, useClass: OpenAPIConfigService },\n    // OpenAPI service (singleton — serves spec and docs endpoints)\n    { provide: OPENAPI_TOKENS.OpenAPIService, useClass: OpenAPIService },\n  ],\n})\nexport class OpenAPIModule {\n  /**\n   * Configure OpenAPI module with static options\n   *\n   * @param options - OpenAPI configuration (paths, info, security schemes)\n   * @returns DynamicModule with options provider\n   */\n  static forRoot(options: OpenAPIModuleOptions = {}): DynamicModule {\n    // Merge with defaults\n    const mergedOptions: OpenAPIModuleOptions = {\n      ...DEFAULT_OPTIONS,\n      ...options,\n      info: {\n        ...DEFAULT_OPTIONS.info,\n        ...options.info,\n        title: options.info?.title ?? DEFAULT_OPTIONS.info?.title ?? 'API',\n        version: options.info?.version ?? DEFAULT_OPTIONS.info?.version ?? '1.0.0',\n      }\n    }\n\n    return {\n      module: OpenAPIModule,\n      providers: [\n        { provide: OPENAPI_TOKENS.Options, useValue: mergedOptions }\n      ]\n    }\n  }\n\n  static forRootAsync(options: AsyncModuleOptions<OpenAPIModuleOptions>): DynamicModule {\n    return {\n      module: OpenAPIModule,\n      providers: [\n        {\n          provide: OPENAPI_TOKENS.Options,\n          useFactory: options.useFactory,\n          inject: options.inject\n        },\n      ]\n    }\n  }\n}\n"],"mappings":";;;;;;;;AAiCO,IAAA,uBAAA,MAAM,qBAAsD;CAInB;CAH9C,YAA6C,CAAC;CAE9C,YACE,OACA;EAD4C,KAAA,QAAA;CAC1C;;;;;CAMJ,SAAS,QAAqC;EAC5C,KAAK,UAAU,KAAK,MAAM;CAC5B;;CAGA,qBAA6C;EAC3C,IAAI,YAAY,KAAK,MAAM,cAAc;EAEzC,KAAK,MAAM,YAAY,KAAK,WAC1B,YAAY,KAAK,YAAY,WAAW,QAAQ;EAGlD,OAAO;CACT;;;;;CAMA,YACE,MACA,UACwB;EACxB,OAAO;GACL,GAAG;GACH,MAAM;IACJ,GAAG,KAAK;IACR,GAAI,SAAS,QAAQ;KACnB,OAAO,SAAS,KAAK,SAAS,KAAK,KAAK;KACxC,SAAS,SAAS,KAAK,WAAW,KAAK,KAAK;KAC5C,aAAa,SAAS,KAAK,eAAe,KAAK,KAAK;IACtD;GACF;GACA,aAAa,SAAS,eAAe,KAAK;EAC5C;CACF;AACF;mCAhDC,QAAQ,eAAe,aAAa,GAAA,gBAAA,GAKhC,OAAO,eAAe,WAAW,CAAA,CAAA,GAAA,oBAAA;;;ACf/B,IAAA,qBAAA,MAAM,mBAAkD;CAEG;CADhE,YACE,aACA;EAD8D,KAAA,cAAA;CAC5D;CAEJ,gBAAwC;EACtC,OAAO;GACL,UAAU,KAAK,aAAa,YAAY;GACxC,IAAI,KAAK,aAAa;GACtB,MAAM;IACJ,OAAO,KAAK,aAAa,MAAM,SAAS;IACxC,SAAS,KAAK,aAAa,MAAM,WAAW;IAC5C,aAAa,KAAK,aAAa,MAAM;GACvC;GACA,iBAAiB,KAAK,aAAa;EACrC;CACF;AACF;iCAlBC,UAAU,eAAe,WAAW,GAAA,gBAAA,GAGhC,OAAO,eAAe,SAAS,EAAE,YAAY,KAAK,CAAC,CAAA,CAAA,GAAA,kBAAA;;;ACEjD,IAAA,iBAAA,MAAM,eAAe;;;;;CAM1B,QAAQ,KAA6B,WAAqC;EACxE,MAAM,gBAAgB,UAAU,QAA+B,eAAe,aAAa;EAC3F,MAAM,OAAO,UAAU,QAAsB,YAAY,WAAW;EACpE,MAAM,SAAS,cAAc,mBAAmB;EAEhD,MAAM,WAAW,IAAI,mBAAmB;GACtC,SAAS;GACT,MAAM;IACJ,SAAS,OAAO,KAAK;IACrB,OAAO,OAAO,KAAK;IACnB,aAAa,OAAO,KAAK;GAC3B;EACF,CAAC;EAGD,SAAS,eAAe,CAAC;EACzB,SAAS,WAAW,kBAAkB,KAAK,6BAA6B,IAAI;EAG5E,IAAI,OAAO,aACT,SAAS,QAAQ,KAAK,aACpB,SAAS,OACT,MACF;EAIF,IAAI,SAAS,WAAW,SACtB,SAAS,WAAW,UAAU,KAAK,cAAc,QAA8C;EAGjG,OAAO;CACT;;;;CAKA,eAAe,KAA6B,WAA4B;EAKtE,MAAM,SAAS,UAAU,QAA6B,eAAe,WAAW,EAAE,cAAc;EAChG,MAAM,WAAW,OAAO;EACxB,MAAM,KAAK,OAAO;EAGlB,IAAI,IAAI,WAAW,MAAM;GACvB,MAAM,mBAAmB,EAAE,IAAI,oBAAoB,iBAAiB;GACpE,MAAM,WAAW,KAAK,QAAQ,KAAK,gBAAgB;GAGnD,MAAM,MAAM,IAAI,IAAI,EAAE,IAAI,IAAI,GAAG;GACjC,MAAM,OAAO,iBAAiB,QAAsB,YAAY,WAAW;GAC3E,SAAS,UAAU,CAAC;IAClB,KAAK,GAAG,IAAI,SAAS,IAAI,IAAI;IAC7B,aAAa,KAAK,EAAE,8BAA8B;GACpD,CAAC;GAED,OAAO,EAAE,KAAK,QAAQ;EACxB,CAAC;EACD,KAAK,gBAAgB,KAAK,WAAW,MAAM;EAG3C,IAAI,OAAO,OAAO;GAChB,MAAM,SAAS,IAAI,QAAQ;GAC3B,MAAM,aAAa,IAAI;GAEvB,IAAI,IAAI,QAAQ,OAAO,GAAG,SAAS;IAKjC,MAAM,kBAJmB,EAAE,IAAI,oBAAoB,iBACP,EAAE,QAC5C,eAAe,aAE0B,EAAE,mBAAmB;IAChE,MAAM,YAAY;KAAE,SAAS,gBAAgB;KAAU,OAAO,gBAAgB,KAAK;IAAM;IAEzF,IAAI,YACF,OAAO,WAAW,SAAS,EAAE,GAAG,IAAI;IAGtC,MAAM,EAAE,cAAc,MAAM,OAAO;IACnC,OAAO,UAAqB,EAAE,KAAK,UAAU,QAAQ,CAAC,EAAE,GAAG,IAAI;GACjE,CAAC;GACD,KAAK,gBAAgB,KAAK,WAAW,MAAM;EAC7C;CACF;CAEA,gBAAwB,KAA6B,YAAoB,QAAsB;EAC7F,MAAM,OAAO,IAAI,OAAO,IAAI,OAAO,SAAS;EAC5C,OAAO,eAAe,KAAK,SAAS,QAAQ,EAAE,OAAO,QAAQ,WAAW,GAAG,SAAS,CAAC;CACvF;;;;CAKA,6BAAqC,MAAoB;EACvD,OAAO;IACJ,iBAAiB,cAAc;IAC9B,MAAM;IACN,QAAQ;IACR,cAAc;IACd,aAAa,KAAK,EAAE,gCAAgC;GACtD;IACC,iBAAiB,UAAU;IAC1B,MAAM;IACN,IAAI;IACJ,MAAM;IACN,aAAa,KAAK,EAAE,4BAA4B;GAClD;IACC,iBAAiB,iBAAiB;IACjC,MAAM;IACN,IAAI;IACJ,MAAM;IACN,aAAa,KAAK,EAAE,mCAAmC;GACzD;EACF;CACF;;;;CAKA,aACE,OACA,QACgC;EAChC,MAAM,gBAAgD,CAAC;EAEvD,KAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,KAAK,GAAG;GACpD,IAAI,OAAO,eAAe,CAAC,OAAO,YAAY,MAAM,QAAQ,GAC1D;GAGF,cAAc,QAAQ;EACxB;EAEA,OAAO;CACT;;;;CAKA,cAAsB,MAAwD;EAC5E,MAAM,oCAAoB,IAAI,IAAY;EAG1C,KAAK,kBAAkB,KAAK,OAAO,iBAAiB;EAGpD,MAAM,kBAA2C,CAAC;EAClD,MAAM,aAAa,KAAK;EACxB,IAAI,YAAY,SAAS;GACvB,MAAM,aAAa,WAAW;GAC9B,IAAI,WAAW;GACf,OAAO,kBAAkB,OAAO,UAAU;IACxC,WAAW,kBAAkB;IAC7B,KAAK,MAAM,CAAC,YAAY,gBAAgB,OAAO,QAAQ,UAAU,GAC/D,IAAI,kBAAkB,IAAI,UAAU,KAAK,CAAC,gBAAgB,aAAa;KACrE,gBAAgB,cAAc;KAC9B,KAAK,kBAAkB,aAAa,iBAAiB;IACvD;GAEJ;EACF;EAEA,OAAO;CACT;;;;CAKA,kBAA0B,KAAc,MAAyB;EAC/D,IAAI,CAAC,OAAO,OAAO,QAAQ,UACzB;EAGF,MAAM,SAAS;EAGf,IAAI,OAAO,QAAQ,OAAO,OAAO,SAAS,UAAU;GAElD,MAAM,QAAQ,iCAAiC,KAAK,OAAO,IAAI;GAC/D,IAAI,OACF,KAAK,IAAI,MAAM,EAAE;EAErB;EAGA,IAAI,MAAM,QAAQ,GAAG,GACnB,KAAK,MAAM,QAAQ,KACjB,KAAK,kBAAkB,MAAM,IAAI;OAGnC,KAAK,MAAM,SAAS,OAAO,OAAO,MAAM,GACtC,KAAK,kBAAkB,OAAO,IAAI;CAGxC;AACF;6BA5MC,UAAU,eAAe,cAAc,CAAA,GAAA,cAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACsBxC,MAAM,kBAAwC;CAC5C,UAAU;CACV,MAAM;EACJ,OAAO;EACP,SAAS;CACX;AACF;AAYO,IAAA,gBAAA,iBAAA,MAAM,cAAc;;;;;;;CAOzB,OAAO,QAAQ,UAAgC,CAAC,GAAkB;EAEhE,MAAM,gBAAsC;GAC1C,GAAG;GACH,GAAG;GACH,MAAM;IACJ,GAAG,gBAAgB;IACnB,GAAG,QAAQ;IACX,OAAO,QAAQ,MAAM,SAAS,gBAAgB,MAAM,SAAS;IAC7D,SAAS,QAAQ,MAAM,WAAW,gBAAgB,MAAM,WAAW;GACrE;EACF;EAEA,OAAO;GACL,QAAA;GACA,WAAW,CACT;IAAE,SAAS,eAAe;IAAS,UAAU;GAAc,CAC7D;EACF;CACF;CAEA,OAAO,aAAa,SAAkE;EACpF,OAAO;GACL,QAAA;GACA,WAAW,CACT;IACE,SAAS,eAAe;IACxB,YAAY,QAAQ;IACpB,QAAQ,QAAQ;GAClB,CACF;EACF;CACF;AACF;6CAlDC,OAAO,EACN,WAAW;CAET;EAAE,SAAS,eAAe;EAAa,UAAU;CAAmB;CAEpE;EAAE,SAAS,eAAe;EAAe,UAAU;CAAqB;CAExE;EAAE,SAAS,eAAe;EAAgB,UAAU;CAAe;AACrE,EACF,CAAC,CAAA,GAAA,aAAA"}

package/dist/{openapi-tools.service-Zs-Ewv7F.mjs → openapi-tools.service-BC5EC3R3.mjs}

@@ -5,7 +5,13 @@
 const OPENAPI_TOKENS = {
 	/** Static options provided via forRoot() */
 	Options: Symbol.for("stratal:openapi:options"),
-	/** Request-scoped config service that supports runtime overrides */
+	/**
+	* Singleton holder of the static base config. Resolvable outside a request
+	* (bootstrap endpoint mounting, CLI commands) for static config — never throws
+	* on resolve and carries no per-request state.
+	*/
+	ConfigStore: Symbol.for("stratal:openapi:config:store"),
+	/** Request-scoped config service that layers runtime overrides over the store */
 	ConfigService: Symbol.for("stratal:openapi:config:service"),
 	/** OpenAPI service that generates specs and serves endpoints */
 	OpenAPIService: Symbol.for("stratal:openapi:service")
@@ -197,4 +203,4 @@ var OpenApiToolsService = class OpenApiToolsService {
 //#endregion
 export { OPENAPI_TOKENS as n, OpenApiToolsService as t };
 
-//# sourceMappingURL=openapi-tools.service-Zs-Ewv7F.mjs.map
+//# sourceMappingURL=openapi-tools.service-BC5EC3R3.mjs.map

package/dist/openapi-tools.service-BC5EC3R3.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-tools.service-BC5EC3R3.mjs","names":[],"sources":["../src/openapi/openapi.tokens.ts","../src/openapi/services/openapi-tools.service.ts"],"sourcesContent":["/**\n * OpenAPI Module DI Tokens\n */\nexport const OPENAPI_TOKENS = {\n  /** Static options provided via forRoot() */\n  Options: Symbol.for('stratal:openapi:options'),\n\n  /**\n   * Singleton holder of the static base config. Resolvable outside a request\n   * (bootstrap endpoint mounting, CLI commands) for static config — never throws\n   * on resolve and carries no per-request state.\n   */\n  ConfigStore: Symbol.for('stratal:openapi:config:store'),\n\n  /** Request-scoped config service that layers runtime overrides over the store */\n  ConfigService: Symbol.for('stratal:openapi:config:service'),\n\n  /** OpenAPI service that generates specs and serves endpoints */\n  OpenAPIService: Symbol.for('stratal:openapi:service'),\n} as const\n","import type { OpenAPIObject } from '../../i18n/validation/zod'\nimport type { HttpMethod } from '../../router/types'\n\ntype JsonSchema = Record<string, unknown>\n\nexport interface ToolDefinition {\n  name: string\n  description: string\n  inputSchema: JsonSchema\n  method: string\n  path: string\n  pathParams: string[]\n}\n\nexport interface ToolExecutionResult {\n  status: number\n  body: string\n  headers: Record<string, string>\n}\n\nexport interface ToolFilter {\n  tags?: string[]\n  pathPrefix?: string\n}\n\nexport type Dispatcher = (method: string, url: string, options?: {\n  body?: unknown\n  headers?: Record<string, string>\n}) => Promise<Response>\n\ninterface OperationObject {\n  operationId?: string\n  summary?: string\n  description?: string\n  tags?: string[]\n  parameters?: ParameterObject[]\n  requestBody?: RequestBodyObject\n}\n\ninterface ParameterObject {\n  name: string\n  in: string\n  required?: boolean\n  schema?: JsonSchema\n  description?: string\n}\n\ninterface RequestBodyObject {\n  required?: boolean\n  content?: Record<string, { schema?: JsonSchema }>\n}\n\n/**\n * Converts an OpenAPI 3.0 spec into callable tool definitions.\n *\n * Plain class (no DI) — reusable across MCP, CLI, and custom tooling.\n */\nexport class OpenApiToolsService {\n  private static readonly HTTP_METHODS: Set<string> = new Set<HttpMethod>(['get', 'post', 'put', 'delete', 'patch', 'head', 'options', 'trace'])\n\n  private tools: ToolDefinition[] = []\n  private toolMap = new Map<string, ToolDefinition>()\n  private dispatcher?: Dispatcher\n\n  private spec: OpenAPIObject\n\n  constructor(spec: OpenAPIObject, options?: { dispatcher?: Dispatcher }) {\n    this.spec = spec\n    this.dispatcher = options?.dispatcher\n    this.tools = this.buildTools()\n    for (const tool of this.tools) {\n      this.toolMap.set(tool.name, tool)\n    }\n  }\n\n  getTools(filter?: ToolFilter): ToolDefinition[] {\n    let tools = this.tools\n\n    if (filter?.tags?.length) {\n      const tagSet = new Set(filter.tags)\n      tools = tools.filter((t) => {\n        const op = this.getOperation(t.method, t.path)\n        return op?.tags?.some((tag) => tagSet.has(tag)) ?? false\n      })\n    }\n\n    if (filter?.pathPrefix) {\n      const prefix = filter.pathPrefix\n      tools = tools.filter((t) => t.path.startsWith(prefix))\n    }\n\n    return tools\n  }\n\n  getTool(name: string): ToolDefinition | undefined {\n    return this.toolMap.get(name)\n  }\n\n  async executeTool(name: string, args: Record<string, unknown>): Promise<ToolExecutionResult> {\n    const tool = this.toolMap.get(name)\n    if (!tool) {\n      throw new Error(`Tool not found: ${name}`)\n    }\n    if (!this.dispatcher) {\n      throw new Error('No dispatcher configured')\n    }\n\n    // Interpolate path params\n    let url = tool.path\n    for (const param of tool.pathParams) {\n      const value = args[`path_${param}`]\n      if (value === undefined) {\n        throw new Error(`Missing required path parameter: ${param}`)\n      }\n      url = url.replace(`{${param}}`, encodeURIComponent(value != null && typeof value === 'object' ? JSON.stringify(value) : String(value as string | number | boolean)))\n    }\n\n    // Collect query params\n    const queryParts: string[] = []\n    for (const key of Object.keys(args)) {\n      if (key.startsWith('query_')) {\n        const paramName = key.slice(6)\n        const value = args[key]\n        queryParts.push(`${encodeURIComponent(paramName)}=${encodeURIComponent(value != null && typeof value === 'object' ? JSON.stringify(value) : String(value as string | number | boolean))}`)\n      }\n    }\n    if (queryParts.length > 0) {\n      url += `?${queryParts.join('&')}`\n    }\n\n    const body = args.body\n    const response = await this.dispatcher(\n      tool.method.toUpperCase(),\n      url,\n      body !== undefined ? { body } : undefined,\n    )\n\n    const responseHeaders: Record<string, string> = {}\n    response.headers.forEach((value, key) => {\n      responseHeaders[key] = value\n    })\n\n    return {\n      status: response.status,\n      body: await response.text(),\n      headers: responseHeaders,\n    }\n  }\n\n  private buildTools(): ToolDefinition[] {\n    const tools: ToolDefinition[] = []\n    const paths = this.spec.paths\n\n    for (const [path, pathItem] of Object.entries(paths)) {\n      for (const [method, operation] of Object.entries(pathItem)) {\n        if (!operation || typeof operation !== 'object') continue\n        if (!OpenApiToolsService.HTTP_METHODS.has(method.toLowerCase())) continue\n\n        const op = operation as OperationObject\n        const name = op.operationId ?? this.generateName(method, path)\n        const description = this.buildDescription(op, method, path)\n        const pathItemParams = (pathItem as Record<string, unknown>).parameters as ParameterObject[] | undefined\n        const mergedParameters = this.mergeParameters(pathItemParams, op.parameters)\n        const { schema, pathParams } = this.buildInputSchema({ ...op, parameters: mergedParameters })\n\n        tools.push({ name, description, inputSchema: schema, method: method.toUpperCase(), path, pathParams })\n      }\n    }\n\n    return tools\n  }\n\n  private generateName(method: string, path: string): string {\n    const snake = path\n      .replace(/[{}]/g, '')\n      .replace(/[^a-zA-Z0-9]+/g, '_')\n      .replace(/^_|_$/g, '')\n      .toLowerCase()\n    return `${method.toLowerCase()}_${snake}`\n  }\n\n  private buildDescription(op: OperationObject, method: string, path: string): string {\n    if (op.summary && op.description) {\n      return `${op.summary} — ${op.description}`\n    }\n    return op.summary ?? op.description ?? `${method.toUpperCase()} ${path}`\n  }\n\n  private buildInputSchema(op: OperationObject): { schema: JsonSchema; pathParams: string[] } {\n    const properties: Record<string, JsonSchema> = {}\n    const required: string[] = []\n    const pathParams: string[] = []\n\n    // Parameters (path + query)\n    for (const param of op.parameters ?? []) {\n      const resolvedParam = this.resolveRef(param) as ParameterObject\n      const paramSchema = resolvedParam.schema ? this.resolveRef(resolvedParam.schema) as JsonSchema : { type: 'string' }\n\n      if (resolvedParam.in === 'path') {\n        pathParams.push(resolvedParam.name)\n        const key = `path_${resolvedParam.name}`\n        properties[key] = { ...paramSchema }\n        if (resolvedParam.description) properties[key].description = resolvedParam.description\n        required.push(key)\n      } else if (resolvedParam.in === 'query') {\n        const key = `query_${resolvedParam.name}`\n        properties[key] = { ...paramSchema }\n        if (resolvedParam.description) properties[key].description = resolvedParam.description\n        if (resolvedParam.required) required.push(key)\n      }\n    }\n\n    // Request body\n    const resolvedBody = op.requestBody ? this.resolveRef(op.requestBody) as RequestBodyObject : undefined\n    if (resolvedBody) {\n      const jsonContent = resolvedBody.content?.['application/json']\n      if (jsonContent?.schema) {\n        properties.body = this.resolveRef(jsonContent.schema) as JsonSchema\n      } else {\n        properties.body = { type: 'object' }\n      }\n      const needsBody = resolvedBody.required === true\n      if (needsBody) {\n        required.push('body')\n      }\n    }\n\n    const schema: JsonSchema = { type: 'object', properties }\n    if (required.length > 0) {\n      schema.required = required\n    }\n\n    return { schema, pathParams }\n  }\n\n  private mergeParameters(pathLevel?: ParameterObject[], opLevel?: ParameterObject[]): ParameterObject[] {\n    const resolvedPathLevel = pathLevel?.map((p) => this.resolveRef(p) as ParameterObject)\n    const resolvedOpLevel = opLevel?.map((p) => this.resolveRef(p) as ParameterObject)\n\n    if (!resolvedPathLevel?.length) return resolvedOpLevel ?? []\n    if (!resolvedOpLevel?.length) return resolvedPathLevel\n\n    const opKeys = new Set(resolvedOpLevel.map((p) => `${p.in}:${p.name}`))\n    const inherited = resolvedPathLevel.filter((p) => !opKeys.has(`${p.in}:${p.name}`))\n    return [...inherited, ...resolvedOpLevel]\n  }\n\n  private resolveRef(obj: unknown, seen = new Set<string>()): unknown {\n    if (!obj || typeof obj !== 'object') return obj\n    const record = obj as Record<string, unknown>\n\n    if (typeof record.$ref === 'string') {\n      const refPath = record.$ref\n      if (seen.has(refPath)) return obj\n      seen.add(refPath)\n\n      const resolved = this.lookupRef(refPath)\n      if (!resolved) return obj\n      return this.resolveRef(resolved, seen)\n    }\n\n    // Recursively walk all properties and resolve nested $refs\n    const result: Record<string, unknown> = {}\n    for (const [key, value] of Object.entries(record)) {\n      if (Array.isArray(value)) {\n        result[key] = value.map((item) => this.resolveRef(item, seen))\n      } else if (value && typeof value === 'object') {\n        result[key] = this.resolveRef(value, seen)\n      } else {\n        result[key] = value\n      }\n    }\n    return result\n  }\n\n  private lookupRef(refPath: string): unknown {\n    const components = this.spec.components as Record<string, Record<string, unknown>> | undefined\n    if (!components) return undefined\n\n    const match = /^#\\/components\\/(\\w+)\\/(.+)$/.exec(refPath)\n    if (!match) return undefined\n\n    const [, section, name] = match\n    const sectionObj = components[section]\n    if (typeof sectionObj !== 'object') return undefined\n    return sectionObj[name]\n  }\n\n  private getOperation(method: string, path: string): OperationObject | undefined {\n    const paths = this.spec.paths as Record<string, Record<string, unknown>> | undefined\n    return paths?.[path]?.[method.toLowerCase()] as OperationObject | undefined\n  }\n}\n"],"mappings":"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"}

package/dist/{openapi.service-Bt9bCIrd.d.mts → openapi.service-YhTiJ1bO.d.mts}

@@ -1,5 +1,5 @@
-import { Dr as Container, Xn as RouterEnv } from "./index-ByOyTmqf.mjs";
-import { n as OpenAPIObject, t as OpenAPIHono } from "./index-Bnpfq6uk.mjs";
+import { Y as Container, or as RouterEnv } from "./index-B_JoEl3V.mjs";
+import { n as OpenAPIObject, t as OpenAPIHono } from "./zod-wecrEVAs.mjs";
 
 //#region src/openapi/services/openapi.service.d.ts
 /**
@@ -47,4 +47,4 @@ declare class OpenAPIService {
 }
 //#endregion
 export { OpenAPIService as t };
-//# sourceMappingURL=openapi.service-Bt9bCIrd.d.mts.map
+//# sourceMappingURL=openapi.service-YhTiJ1bO.d.mts.map

package/dist/openapi.service-YhTiJ1bO.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.service-YhTiJ1bO.d.mts","names":[],"sources":["../src/openapi/services/openapi.service.ts"],"mappings":";;;;;AAyBA;;;;;;;;;;;;;;cACa,cAAA;EAMH;;;;EAAR,OAAA,CAAQ,GAAA,EAAK,WAAA,CAAY,SAAA,GAAY,SAAA,EAAW,SAAA,GAAY,aAAA;EAqCxC;;;EAApB,cAAA,CAAe,GAAA,EAAK,WAAA,CAAY,SAAA,GAAY,SAAA,EAAW,SAAA;EAAA,QAkD/C,eAAA;EAAA;;;EAAA,QAQA,4BAAA;EA2EA;;AAAiB;EAAjB,QAjDA,YAAA;;;;UAoBA,aAAA;;;;UA6BA,iBAAA;AAAA"}