stratal 0.0.27 → 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-tools.service-VKZJlTIX.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\n/**\n * Serialize a path/query parameter value for use in a URL.\n * Objects/arrays are JSON-encoded; primitives are coerced to string.\n */\nfunction stringifyParamValue(value: unknown): string {\n  if (value != null && typeof value === 'object') {\n    return JSON.stringify(value)\n  }\n  return String(value)\n}\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(stringifyParamValue(value)))\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(stringifyParamValue(value))}`)\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-Ds-R1tih.d.mts

@@ -0,0 +1,43 @@
+import { $ as Container, zn as HonoApp } from "./index-B2WtEagR.mjs";
+import { r as OpenAPIObject } from "./zod-BGisqLs3.mjs";
+//#region src/openapi/services/openapi.service.d.ts
+/**
+ * OpenAPI Service
+ *
+ * Generates OpenAPI specifications lazily from the route metadata registry:
+ * - Built on demand (per request to the spec endpoint), never at startup
+ * - Schema → JSON Schema via zod v4's native `z.toJSONSchema()`
+ * - Runtime configuration via OpenAPIConfigService
+ * - Route visibility via a metadata predicate (`routeFilter`)
+ * - i18n support for titles, descriptions, and security schemes
+ *
+ * Hidden routes (hideFromDocs) are flagged in the metadata and excluded by the
+ * generator. The generator and the common error schemas are dynamically
+ * imported so `zod`/`common.schemas` never reach the routing path — they load
+ * only when the document is actually requested.
+ */
+declare class OpenAPIService {
+  /**
+   * Generate a filtered OpenAPI document from collected route metadata.
+   * Usable from both HTTP handlers and CLI commands.
+   */
+  getSpec(container: Container): Promise<OpenAPIObject>;
+  /**
+   * Append the standard error responses (400/401/403/404/409/500) a route
+   * doesn't already declare. Done here, in the lazy doc path, so the error
+   * schemas never load at registration time.
+   */
+  private withCommonErrors;
+  /**
+   * Setup OpenAPI documentation endpoints
+   */
+  setupEndpoints(app: HonoApp, container: Container): void;
+  private nameLastHandler;
+  /**
+   * Get localized security scheme definitions
+   */
+  private getSecuritySchemeDefinitions;
+}
+//#endregion
+export { OpenAPIService as t };
+//# sourceMappingURL=openapi.service-Ds-R1tih.d.mts.map

package/dist/openapi.service-Ds-R1tih.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.service-Ds-R1tih.d.mts","names":[],"sources":["../src/openapi/services/openapi.service.ts"],"mappings":";;;;;;;;;;;;;;;;;;cA6Ba;;;;;EAKL,QAAQ,WAAW,YAAY,QAAQ;;;;;;UA8BrC;;;;EAkBR,eAAe,KAAK,SAAS,WAAW;UAkDhC;;;;UAQA"}

package/dist/quarry/index.d.mts

@@ -1,13 +1,12 @@
-import { An as ParsedOption, En as CommandInput, Mn as Quarry, On as CommandResult, jn as ParsedSignature, kn as ParsedArgument } from "../index-uybm0bhQ.mjs";
+import { Gn as ParsedOption, Kn as ParsedSignature, Un as CommandResult, Vn as CommandInput, Wn as ParsedArgument, qn as Quarry } from "../index-B2WtEagR.mjs";
 import { t as Constructor } from "../types-CmV_9xBD.mjs";
-import { t as Command } from "../command-DoBD2Cwl.mjs";
-import { t as QuarryRegistry } from "../quarry-registry-DRnV-DDa.mjs";
-
+import { t as Command } from "../command-BXMccV_9.mjs";
+import { t as QuarryRegistry } from "../quarry-registry-Ci4k58FZ.mjs";
 //#region src/quarry/errors/command-not-found.error.d.ts
 /**
  * Thrown when a command is not found in the Quarry registry.
  */
-declare class CommandNotFoundError extends Error {
+export declare class CommandNotFoundError extends Error {
   constructor(name: string);
 }
 //#endregion
@@ -19,7 +18,7 @@ declare class CommandNotFoundError extends Error {
  * Does NOT extend `ApplicationError` (which requires i18n keys + error codes).
  * Not routed through ExceptionHandler.
  */
-declare class CommandError extends Error {
+export declare class CommandError extends Error {
   constructor(message: string);
 }
 //#endregion
@@ -29,7 +28,7 @@ declare class CommandError extends Error {
  *
  * Used by ModuleRegistry for auto-discovery from providers.
  */
-declare function isCommand(target: Constructor): boolean;
+export declare function isCommand(target: Constructor): boolean;
 //#endregion
 //#region src/quarry/quarry.module.d.ts
 /**
@@ -38,7 +37,7 @@ declare function isCommand(target: Constructor): boolean;
  * Eager: resolved synchronously at bootstrap (`registerCommands`) and by the
  * CLI runner (`bin/quarry.ts`), so it cannot be lazily loaded.
  */
-declare class QuarryModule {}
+export declare class QuarryModule {}
 //#endregion
 //#region src/quarry/signature-parser.d.ts
 /**
@@ -52,7 +51,7 @@ declare class QuarryModule {}
  *
  * Pure function, zero dependencies, edge-compatible.
  */
-declare function parseSignature(signature: string): ParsedSignature;
+export declare function parseSignature(signature: string): ParsedSignature;
 //#endregion
 //#region src/quarry/usage-generator.d.ts
 /**
@@ -60,7 +59,7 @@ declare function parseSignature(signature: string): ParsedSignature;
  *
  * Pure function, edge-compatible.
  */
-declare function generateUsage(signature: ParsedSignature, description?: string): string;
+export declare function generateUsage(signature: ParsedSignature, description?: string): string;
 //#endregion
-export { Command, CommandError, type CommandInput, CommandNotFoundError, type CommandResult, type ParsedArgument, type ParsedOption, type ParsedSignature, type Quarry, QuarryModule, QuarryRegistry, generateUsage, isCommand, parseSignature };
+export { Command, type CommandInput, type CommandResult, type ParsedArgument, type ParsedOption, type ParsedSignature, type Quarry, QuarryRegistry };
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/quarry/errors/command-not-found.error.ts","../../src/quarry/errors/command.error.ts","../../src/quarry/is-command.ts","../../src/quarry/quarry.module.ts","../../src/quarry/signature-parser.ts","../../src/quarry/usage-generator.ts"],"mappings":";;;;;;;;;cAGa,oBAAA,SAA6B,KAAK;cACjC,IAAA;AAAA;;;;;;;;;AADd;cCIa,YAAA,SAAqB,KAAK;cACzB,OAAA;AAAA;;;;;;;;iBCAE,SAAA,CAAU,MAAmB,EAAX,WAAW;;;;;;;;;cCOhC,YAAA;;;;;;;;AHZb;;;;;;iBIWgB,cAAA,CAAe,SAAA,WAAoB,eAAe;;;;;;;;iBCNlD,aAAA,CAAc,SAAA,EAAW,eAAe,EAAE,WAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/quarry/errors/command-not-found.error.ts","../../src/quarry/errors/command.error.ts","../../src/quarry/is-command.ts","../../src/quarry/quarry.module.ts","../../src/quarry/signature-parser.ts","../../src/quarry/usage-generator.ts"],"mappings":";;;;;;;;qBAGa,6BAA6B;EACxC,YAAY;;;;;;;;;;;qBCGD,qBAAqB;EAChC,YAAY;;;;;;;;;wBCAE,UAAU,QAAQ;;;;;;;;;qBCOrB;;;;;;;;;;;;;;wBCDG,eAAe,oBAAoB;;;;;;;;wBCNnC,cAAc,WAAW,iBAAiB"}

package/dist/quarry/index.mjs

@@ -1,6 +1,6 @@
-import { n as CommandError, t as Command } from "../command-BvmUAPPQ.mjs";
-import { t as isCommand } from "../is-command-CEPO9n8c.mjs";
+import { r as CommandError, t as Command } from "../command-Bb820B6W.mjs";
+import { t as isCommand } from "../is-command-CSVv14wh.mjs";
 import { t as CommandNotFoundError } from "../command-not-found.error-ONAZ2Bpk.mjs";
-import { i as parseSignature, r as QuarryRegistry, t as QuarryModule } from "../quarry.module-CcGxU2dJ.mjs";
-import { t as generateUsage } from "../usage-generator-DAWYasuP.mjs";
+import { i as parseSignature, r as QuarryRegistry, t as QuarryModule } from "../quarry.module-BssRR8f0.mjs";
+import { t as generateUsage } from "../usage-generator-BW7EcO-C.mjs";
 export { Command, CommandError, CommandNotFoundError, QuarryModule, QuarryRegistry, generateUsage, isCommand, parseSignature };

package/dist/quarry/runner.d.mts

@@ -1,12 +1,11 @@
-import { bn as LocalePathService, f as ExceptionHandler, ft as Application, hn as ModuleRegistry, pn as RouteRegistry } from "../index-uybm0bhQ.mjs";
+import { En as LocalePathService, _n as RouteRegistry, f as ExceptionHandler, ft as Application, xn as ModuleRegistry } from "../index-B2WtEagR.mjs";
 import { t as Constructor } from "../types-CmV_9xBD.mjs";
-import { n as ConsumerRegistry } from "../consumer-registry-D3iMTSdy.mjs";
-import { t as Stratal } from "../stratal-D5j_I14G.mjs";
-import { t as LazyModuleLoader } from "../lazy-module-loader-M6YKudNL.mjs";
-import { t as OpenAPIService } from "../openapi.service-2rvJBCEg.mjs";
-import { t as Command } from "../command-DoBD2Cwl.mjs";
-import { t as QuarryRegistry } from "../quarry-registry-DRnV-DDa.mjs";
-
+import { n as ConsumerRegistry } from "../consumer-registry-i9oCdarv.mjs";
+import { t as Stratal } from "../stratal-Bs1_E8GQ.mjs";
+import { t as LazyModuleLoader } from "../lazy-module-loader-C3OHoUnR.mjs";
+import { t as OpenAPIService } from "../openapi.service-Ds-R1tih.mjs";
+import { t as Command } from "../command-BXMccV_9.mjs";
+import { t as QuarryRegistry } from "../quarry-registry-Ci4k58FZ.mjs";
 //#region src/quarry/builtin-quarry.module.d.ts
 /**
  * Built-in framework CLI commands.
@@ -17,10 +16,10 @@ import { t as QuarryRegistry } from "../quarry-registry-DRnV-DDa.mjs";
  * (e.g. `@modelcontextprotocol/sdk` reached via `McpServeCommand`) out
  * of the worker bundle and the worker-env Vite dev optimizer.
  */
-declare class BuiltinQuarryModule {}
+export declare class BuiltinQuarryModule {}
 //#endregion
 //#region src/quarry/commands/api.command.d.ts
-declare class ApiCommand extends Command {
+export declare class ApiCommand extends Command {
   private app;
   static command: string;
   static description: string;
@@ -31,7 +30,7 @@ declare class ApiCommand extends Command {
 }
 //#endregion
 //#region src/quarry/commands/event-list.command.d.ts
-declare class EventListCommand extends Command {
+export declare class EventListCommand extends Command {
   private modules;
   static command: string;
   static description: string;
@@ -40,7 +39,7 @@ declare class EventListCommand extends Command {
 }
 //#endregion
 //#region src/quarry/commands/help.command.d.ts
-declare class HelpCommand extends Command {
+export declare class HelpCommand extends Command {
   private quarryRegistry;
   static command: string;
   static description: string;
@@ -50,7 +49,7 @@ declare class HelpCommand extends Command {
 }
 //#endregion
 //#region src/quarry/commands/mcp-serve.command.d.ts
-declare class McpServeCommand extends Command {
+export declare class McpServeCommand extends Command {
   private app;
   private openAPIService;
   static command: string;
@@ -60,7 +59,7 @@ declare class McpServeCommand extends Command {
 }
 //#endregion
 //#region src/quarry/commands/mcp-tools.command.d.ts
-declare class McpToolsCommand extends Command {
+export declare class McpToolsCommand extends Command {
   private app;
   private openAPIService;
   static command: string;
@@ -70,7 +69,7 @@ declare class McpToolsCommand extends Command {
 }
 //#endregion
 //#region src/quarry/commands/queue-list.command.d.ts
-declare class QueueListCommand extends Command {
+export declare class QueueListCommand extends Command {
   private consumers;
   static command: string;
   static description: string;
@@ -94,7 +93,7 @@ declare class QueueListCommand extends Command {
  * quarry route:list --hidden
  * ```
  */
-declare class RouteListCommand extends Command {
+export declare class RouteListCommand extends Command {
   private registry;
   static command: string;
   static description: string;
@@ -116,7 +115,7 @@ declare class RouteListCommand extends Command {
  * quarry route:types --output=types/routes.d.ts
  * ```
  */
-declare class RouteTypesCommand extends Command {
+export declare class RouteTypesCommand extends Command {
   private registry;
   private localePathService;
   static command: string;
@@ -130,7 +129,7 @@ declare class RouteTypesCommand extends Command {
 }
 //#endregion
 //#region src/quarry/commands/schedule-list.command.d.ts
-declare class ScheduleListCommand extends Command {
+export declare class ScheduleListCommand extends Command {
   private loader;
   static command: string;
   static description: string;
@@ -176,9 +175,9 @@ interface QuarryRunOptions {
  * })
  * ```
  */
-declare class QuarryRunner {
+export declare class QuarryRunner {
   static run(options: QuarryRunOptions): Stratal;
 }
 //#endregion
-export { ApiCommand, BuiltinQuarryModule, EventListCommand, HelpCommand, McpServeCommand, McpToolsCommand, type QuarryRunOptions, QuarryRunner, QueueListCommand, RouteListCommand, RouteTypesCommand, ScheduleListCommand };
+export type { QuarryRunOptions };
 //# sourceMappingURL=runner.d.mts.map

package/dist/quarry/runner.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.mts","names":[],"sources":["../../src/quarry/builtin-quarry.module.ts","../../src/quarry/commands/api.command.ts","../../src/quarry/commands/event-list.command.ts","../../src/quarry/commands/help.command.ts","../../src/quarry/commands/mcp-serve.command.ts","../../src/quarry/commands/mcp-tools.command.ts","../../src/quarry/commands/queue-list.command.ts","../../src/quarry/commands/route-list.command.ts","../../src/quarry/commands/route-types.command.ts","../../src/quarry/commands/schedule-list.command.ts","../../src/quarry/quarry-runner.ts"],"mappings":";;;;;;;;;;;;;;;;;;;cAsDa,mBAAA;;;cChDA,UAAA,SAAmB,OAAA;EAAA,QAKqB,GAAA;EAAA,OAJ5C,OAAA;EAAA,OACA,WAAA;EAAA,OACA,OAAA;cAE4C,GAAA,EAAK,WAAA;EAIlD,MAAA,IAAU,OAAA;EAAA,QAUF,SAAA;AAAA;;;cCnBH,gBAAA,SAAyB,OAAO;EAAA,QAIW,OAAA;EAAA,OAH/C,OAAA;EAAA,OACA,WAAA;cAE+C,OAAA,EAAS,cAAA;EAI/D,MAAA;AAAA;;;cCRW,WAAA,SAAoB,OAAA;EAAA,QAKe,cAAA;EAAA,OAJvC,OAAA;EAAA,OACA,WAAA;EAAA,OACA,OAAA;cAEuC,cAAA,EAAgB,cAAA;EAIxD,MAAA,IAAU,OAAA;AAAA;;;cCJL,eAAA,SAAwB,OAAA;EAAA,QAKM,GAAA;EAAA,QACQ,cAAA;EAAA,OAL1C,OAAA;EAAA,OACA,WAAA;cAGkC,GAAA,EAAK,WAAA,EACG,cAAA,EAAgB,cAAA;EAK3D,MAAA,IAAU,OAAA;AAAA;;;cCdL,eAAA,SAAwB,OAAA;EAAA,QAKM,GAAA;EAAA,QACQ,cAAA;EAAA,OAL1C,OAAA;EAAA,OACA,WAAA;cAGkC,GAAA,EAAK,WAAA,EACG,cAAA,EAAgB,cAAA;EAK3D,MAAA,IAAU,OAAA;AAAA;;;cCdL,gBAAA,SAAyB,OAAO;EAAA,QAIa,SAAA;EAAA,OAHjD,OAAA;EAAA,OACA,WAAA;cAEiD,SAAA,EAAW,gBAAA;EAInE,MAAA;AAAA;;;;;;;;;;;ANiBF;;;;AAwBgC;;;cOlCnB,gBAAA,SAAyB,OAAO;EAAA,QAIc,QAAA;EAAA,OAHlD,OAAA;EAAA,OACA,WAAA;cAEkD,QAAA,EAAU,aAAA;EAInE,MAAA;EAAA,QAsCQ,SAAA;AAAA;;;;;;;;;;APpCV;;;;AAwBgC;cQlCnB,iBAAA,SAA0B,OAAA;EAAA,QAKU,QAAA;EAAA,QACI,iBAAA;EAAA,OAL5C,OAAA;EAAA,OACA,WAAA;cAGwC,QAAA,EAAU,aAAA,EACN,iBAAA,EAAmB,iBAAA;EAKtE,MAAA;EPhBgB;;;EAAA,QOmCR,mBAAA;AAAA;;;cC5CG,mBAAA,SAA4B,OAAA;EAAA,QAIiB,MAAA;EAAA,OAHjD,OAAA;EAAA,OACA,WAAA;cAEiD,MAAA,EAAQ,gBAAA;EAI1D,MAAA,IAAU,OAAA;AAAA;;;UCPD,gBAAA;;;;;;;AVuBjB;;EUdE,OAAA,EAAS,WAAA;EVsCqB;AAAA;;;;AChDhC;ESiBE,SAAA,GAAY,WAAA;;EAEZ,gBAAA,GAAmB,WAAA,CAAY,gBAAA;AAAA;;;;;;;;;;;;;;;;ATAR;;cSoBZ,YAAA;EAAA,OACJ,GAAA,CAAI,OAAA,EAAS,gBAAA,GAAmB,OAAO;AAAA"}
+{"version":3,"file":"runner.d.mts","names":[],"sources":["../../src/quarry/builtin-quarry.module.ts","../../src/quarry/commands/api.command.ts","../../src/quarry/commands/event-list.command.ts","../../src/quarry/commands/help.command.ts","../../src/quarry/commands/mcp-serve.command.ts","../../src/quarry/commands/mcp-tools.command.ts","../../src/quarry/commands/queue-list.command.ts","../../src/quarry/commands/route-list.command.ts","../../src/quarry/commands/route-types.command.ts","../../src/quarry/commands/schedule-list.command.ts","../../src/quarry/quarry-runner.ts"],"mappings":";;;;;;;;;;;;;;;;;;qBAsDa;;;qBChDA,mBAAmB;UAKqB;SAJ5C;SACA;SACA;EAEP,YAAmD,KAAK;EAIlD,UAAU;UAUF;;;;qBCnBH,yBAAyB;UAIkB;SAH/C;SACA;EAEP,YAAsD,SAAS;EAI/D;;;;qBCRW,oBAAoB;UAKe;SAJvC;SACA;SACA;EAEP,YAA8C,gBAAgB;EAIxD,UAAU;;;;qBCHL,wBAAwB;UAKM;UACQ;SAL1C;SACA;EAEP,YACyC,KAAK,aACG,gBAAgB;EAK3D,UAAU;;;;qBCdL,wBAAwB;UAKM;UACQ;SAL1C;SACA;EAEP,YACyC,KAAK,aACG,gBAAgB;EAK3D,UAAU;;;;qBCfL,yBAAyB;UAIoB;SAHjD;SACA;EAEP,YAAwD,WAAW;EAInE;;;;;;;;;;;;;;;;;;;qBCOW,yBAAyB;UAIqB;SAHlD;SACA;EAEP,YAAyD,UAAU;EAInE;UAsCQ;;;;;;;;;;;;;;;;qBC9CG,0BAA0B;UAKU;UACI;SAL5C;SACA;EAEP,YAC+C,UAAU,eACN,mBAAmB;EAKtE;;;;UAmBQ;;;;qBC5CG,4BAA4B;UAIiB;SAHjD;SACA;EAEP,YAAwD,QAAQ;EAI1D,UAAU;;;;UCPD;;;;;;;;;EASf,SAAS;;;;;;;EAOT,YAAY;;EAEZ,mBAAmB,YAAY;;;;;;;;;;;;;;;;;;;qBAoBpB;SACJ,IAAI,SAAS,mBAAmB"}

package/dist/quarry/runner.mjs

@@ -1,15 +1,16 @@
-import { b as ROUTER_TOKENS, p as inject, r as DI_TOKENS } from "../di-D7qmrAir.mjs";
-import { n as __decorateParam, t as __decorate } from "../decorate-CuAoSZvs.mjs";
+import { C as ROUTER_TOKENS, p as inject, r as DI_TOKENS } from "../di-DQ3xbjgf.mjs";
+import { n as getContainer } from "../container-storage-DfF7SXdV.mjs";
+import { n as __decorateParam, t as __decorate } from "../decorate-C79yt3Wt.mjs";
 import "../logger/index.mjs";
-import { a as getListenerHandlers } from "../events-BhEQuT1X.mjs";
-import { n as Module } from "../module.decorator-CYHY6pG5.mjs";
-import { a as cyan, c as green, i as bold, l as red, t as Command, u as yellow } from "../command-BvmUAPPQ.mjs";
-import { t as Stratal } from "../stratal-BL6FKUM_.mjs";
+import { a as getListenerHandlers } from "../events-GtwGEHyT.mjs";
+import { n as Module } from "../module.decorator-CYbrOlX9.mjs";
+import { a as bold, d as yellow, l as green, o as cyan, t as Command, u as red } from "../command-Bb820B6W.mjs";
+import { t as Stratal } from "../stratal-CiwNpWy2.mjs";
 import { t as QUEUE_TOKENS } from "../queue.tokens-DjHnFmre.mjs";
 import { t as I18N_TOKENS } from "../i18n.tokens-CZ_v8oyS.mjs";
-import { n as OPENAPI_TOKENS, t as OpenApiToolsService } from "../openapi-tools.service-BC5EC3R3.mjs";
+import { n as OPENAPI_TOKENS, t as OpenApiToolsService } from "../openapi-tools.service-VKZJlTIX.mjs";
 import { t as CommandNotFoundError } from "../command-not-found.error-ONAZ2Bpk.mjs";
-import { n as DbSeedListCommand, t as DbSeedCommand } from "../seeder-BPGY5rUb.mjs";
+import { n as DbSeedListCommand, t as DbSeedCommand } from "../seeder-BrAk7XIj.mjs";
 import { z } from "zod";
 import { writeFileSync } from "node:fs";
 import { resolve } from "node:path";
@@ -453,7 +454,7 @@ let McpServeCommand = class McpServeCommand extends Command {
 			if (colonIdx > 0) headers[h.slice(0, colonIdx).trim()] = h.slice(colonIdx + 1).trim();
 		}
 		const hono = await this.app.ensureHono();
-		const spec = this.openAPIService.getSpec(hono, this.app.container);
+		const spec = await this.openAPIService.getSpec(getContainer());
 		const service = new OpenApiToolsService(spec, { dispatcher: baseUrl ? async (method, url, opts) => {
 			const fullUrl = `${baseUrl}${url}`;
 			try {
@@ -542,8 +543,9 @@ let McpToolsCommand = class McpToolsCommand extends Command {
 	async handle() {
 		const tags = this.array("tag");
 		const pathPrefix = this.string("path");
-		const hono = await this.app.ensureHono();
-		const service = new OpenApiToolsService(this.openAPIService.getSpec(hono, this.app.container));
+		await this.app.ensureHono();
+		const spec = await this.openAPIService.getSpec(getContainer());
+		const service = new OpenApiToolsService(spec);
 		const filter = {
 			tags: tags.length > 0 ? tags : void 0,
 			pathPrefix: pathPrefix || void 0
@@ -816,7 +818,8 @@ let RouteTypesCommand = class RouteTypesCommand extends Command {
 			this.warn("No named routes found. Add name to your @Route() or @Get()/@Post() decorators.");
 			return 0;
 		}
-		writeFileSync(outputPath, this.generateDeclaration(namedRoutes), "utf-8");
+		const content = this.generateDeclaration(namedRoutes);
+		writeFileSync(outputPath, content, "utf-8");
 		this.info(`Generated route types for ${namedRoutes.length} named routes → ${outputPath}`);
 	}
 	/**
@@ -863,7 +866,7 @@ let ScheduleListCommand = class ScheduleListCommand extends Command {
 		this.loader = loader;
 	}
 	async handle() {
-		const cron = (await this.loader.load(() => import("../cron.module-C81HTzR7.mjs").then((n) => n.n).then((m) => m.CronModule))).get(DI_TOKENS.Cron);
+		const cron = (await this.loader.load(() => import("../cron.module-Dnyl9sFk.mjs").then((n) => n.n).then((m) => m.CronModule))).get(DI_TOKENS.Cron);
 		const schedules = cron.getAllSchedules();
 		if (schedules.length === 0) {
 			this.info("No cron jobs found");