@velajs/vela 1.19.0 → 1.19.1

package/dist/plugin-ByBlVOve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-ByBlVOve.js","names":[],"sources":["../src/entrypoint/entrypoint.types.ts","../src/entrypoint/entrypoint.registry.ts","../src/lifecycle/index.ts","../src/module/lazy-modules.ts","../src/openapi/scalar-ui.ts","../src/openapi/swagger-ui.ts","../src/openapi/redoc-ui.ts","../src/application.ts","../src/container/module-ref.ts","../src/config/config.tokens.ts","../src/http/url/signing-secret.ts","../src/http/url/url-generator.service.ts","../src/http/url/signed-url.guard.ts","../src/module/middleware.ts","../src/module/module-loader.ts","../src/pipeline/app-providers.ts","../src/factory/bootstrap.ts","../src/plugin/plugin.ts"],"sourcesContent":["import type { Token } from '../container/types';\nimport type { DiscoveryService } from '../discovery/discovery.service';\n\n/**\n * A declared entrypoint kind: a named category of non-HTTP (or non-standard)\n * entry surface that some module knows how to dispatch — WebSocket gateways,\n * queue consumers, scheduled jobs, CLI commands. Core ships NO fixed set;\n * any module registers its own kind and any runtime adapter can query it.\n *\n * `metaKey` binds the kind to a decorator's metadata key: every provider\n * carrying that metadata becomes an entrypoint of this kind at bootstrap.\n */\nexport interface EntrypointKind {\n  kind: string;\n  metaKey: string;\n  /**\n   * 'class': one entrypoint per decorated provider (`@WebSocketGateway`).\n   * 'method': one entrypoint per decorated method (`@Cron`, `@QueueConsumer`\n   * handler methods) — flattened from the class-level list convention.\n   */\n  level: 'class' | 'method';\n}\n\n/** One concrete entrypoint discovered at bootstrap. */\nexport interface Entrypoint<M = unknown> {\n  kind: string;\n  token: Token;\n  /** The resolved provider backing the entrypoint (undefined if request-scoped). */\n  instance: unknown;\n  /** Present for method-level kinds. */\n  methodName?: string | symbol;\n  meta: M;\n}\n\n/**\n * Escape hatch for providers whose entrypoints are computed rather than purely\n * decorator-declared (e.g. `WsDispatcher` aggregates per-gateway routing state\n * before contributing). Implementers are detected among the app's eagerly\n * instantiated providers after `onApplicationBootstrap` hooks have run.\n */\nexport interface ContributesEntrypoints {\n  collectEntrypoints(discovery: DiscoveryService): Entrypoint[] | Promise<Entrypoint[]>;\n}\n\nexport function contributesEntrypoints(x: unknown): x is ContributesEntrypoints {\n  return (\n    typeof x === 'object' &&\n    x !== null &&\n    typeof (x as ContributesEntrypoints).collectEntrypoints === 'function'\n  );\n}\n","import type { DiscoveryService } from '../discovery/discovery.service';\nimport { contributesEntrypoints, type Entrypoint, type EntrypointKind } from './entrypoint.types';\n\n// Kind declarations are process-global and import-time (a module declares its\n// kind next to its decorator, before any app exists), so they are anchored on\n// `globalThis` exactly like MetadataRegistry state: a Vite HMR re-eval must\n// reuse the same store, not mint an empty one.\nconst KIND_STORE_KEY = Symbol.for('vela:entrypoints:v1');\n\nfunction kindStore(): Map<string, EntrypointKind> {\n  const g = globalThis as unknown as Record<symbol, Map<string, EntrypointKind> | undefined>;\n  return (g[KIND_STORE_KEY] ??= new Map());\n}\n\n/**\n * Declare an entrypoint kind. Idempotent per `kind` (last declaration wins so\n * an HMR-re-evaluated module can re-declare); typically called at module\n * import time next to the decorator definition:\n *\n * ```ts\n * export const WS_GATEWAY_METADATA = 'vela:ws:gateway';\n * registerEntrypointKind({ kind: 'websocket', metaKey: WS_GATEWAY_METADATA, level: 'class' });\n * ```\n */\nexport function registerEntrypointKind(k: EntrypointKind): void {\n  kindStore().set(k.kind, k);\n}\n\n/** All declared kinds (registration order). */\nexport function getEntrypointKinds(): EntrypointKind[] {\n  return [...kindStore().values()];\n}\n\n/**\n * Reset all kind declarations. Test-only.\n * @internal\n */\nexport function _resetEntrypointKinds(): void {\n  kindStore().clear();\n}\n\n/**\n * The per-application view of every entrypoint: built once after\n * `onApplicationBootstrap` hooks have run (so `ContributesEntrypoints`\n * providers have finished their own discovery), queried by runtime adapters:\n *\n * ```ts\n * for (const ep of app.entrypoints.ofKind('websocket')) { ... }\n * ```\n *\n * Per-app (never global): two applications in one process each build their\n * own registry from their own container.\n */\nexport class EntrypointRegistry {\n  private readonly byKind = new Map<string, Entrypoint[]>();\n\n  static async build(\n    discovery: DiscoveryService,\n    eagerInstances: readonly unknown[],\n    options: { deferLazy?: boolean } = {},\n  ): Promise<EntrypointRegistry> {\n    const registry = new EntrypointRegistry();\n    // With deferLazy, providers of unmaterialized lazy modules yield\n    // metadata-only entries (instance: undefined). Dispatchers re-resolve by\n    // token per event, so the owning module materializes at dispatch time.\n    const filter = options.deferLazy ? { deferLazy: true } : undefined;\n\n    for (const kind of getEntrypointKinds()) {\n      if (kind.level === 'class') {\n        for (const found of discovery.providersWithMeta(kind.metaKey, filter)) {\n          registry.add({\n            kind: kind.kind,\n            token: found.token,\n            instance: found.instance,\n            meta: found.meta,\n          });\n        }\n      } else {\n        for (const found of discovery.methodsWithMeta(kind.metaKey, filter)) {\n          registry.add({\n            kind: kind.kind,\n            token: found.class.token,\n            instance: found.class.instance,\n            methodName: found.methodName,\n            meta: found.meta,\n          });\n        }\n      }\n    }\n\n    // Computed contributions. A contributor is AUTHORITATIVE for every kind it\n    // reports: its entries replace any metaKey-derived ones of the same kind,\n    // so a dispatcher that both carries decorator metadata and computes richer\n    // entries (path routing, aggregated handlers) never double-reports.\n    const contributed: Entrypoint[] = [];\n    for (const instance of new Set(eagerInstances)) {\n      if (!contributesEntrypoints(instance)) continue;\n      contributed.push(...(await instance.collectEntrypoints(discovery)));\n    }\n    for (const kind of new Set(contributed.map((ep) => ep.kind))) {\n      registry.byKind.delete(kind);\n    }\n    for (const ep of contributed) registry.add(ep);\n\n    return registry;\n  }\n\n  private add(ep: Entrypoint): void {\n    const list = this.byKind.get(ep.kind);\n    if (list) list.push(ep);\n    else this.byKind.set(ep.kind, [ep]);\n  }\n\n  ofKind<M = unknown>(kind: string): Entrypoint<M>[] {\n    return (this.byKind.get(kind) ?? []) as Entrypoint<M>[];\n  }\n\n  kinds(): string[] {\n    return [...this.byKind.keys()];\n  }\n\n  all(): Entrypoint[] {\n    return [...this.byKind.values()].flat();\n  }\n}\n","export interface OnModuleInit {\n  onModuleInit(): void | Promise<void>;\n}\n\nexport interface OnApplicationBootstrap {\n  onApplicationBootstrap(): void | Promise<void>;\n}\n\nexport interface OnModuleDestroy {\n  onModuleDestroy(): void | Promise<void>;\n}\n\nexport interface OnApplicationShutdown {\n  onApplicationShutdown(signal?: string): void | Promise<void>;\n}\n\nexport interface BeforeApplicationShutdown {\n  beforeApplicationShutdown(signal?: string): void | Promise<void>;\n}\n\nexport function hasOnModuleInit(instance: unknown): instance is OnModuleInit {\n  return (\n    instance !== null &&\n    typeof instance === 'object' &&\n    typeof (instance as OnModuleInit).onModuleInit === 'function'\n  );\n}\n\nexport function hasOnApplicationBootstrap(instance: unknown): instance is OnApplicationBootstrap {\n  return (\n    instance !== null &&\n    typeof instance === 'object' &&\n    typeof (instance as OnApplicationBootstrap).onApplicationBootstrap === 'function'\n  );\n}\n\nexport function hasOnModuleDestroy(instance: unknown): instance is OnModuleDestroy {\n  return (\n    instance !== null &&\n    typeof instance === 'object' &&\n    typeof (instance as OnModuleDestroy).onModuleDestroy === 'function'\n  );\n}\n\nexport function hasBeforeApplicationShutdown(\n  instance: unknown,\n): instance is BeforeApplicationShutdown {\n  return (\n    instance !== null &&\n    typeof instance === 'object' &&\n    typeof (instance as BeforeApplicationShutdown).beforeApplicationShutdown === 'function'\n  );\n}\n\nexport function hasOnApplicationShutdown(instance: unknown): instance is OnApplicationShutdown {\n  return (\n    instance !== null &&\n    typeof instance === 'object' &&\n    typeof (instance as OnApplicationShutdown).onApplicationShutdown === 'function'\n  );\n}\n","import { Scope } from '../constants';\nimport type { Container } from '../container/container';\nimport type { LazyResolutionHook, Token } from '../container/types';\nimport { hasOnApplicationBootstrap, hasOnModuleInit } from '../lifecycle/index';\n\n/** One lazy module instance's deferral unit: its own tokens, in registration order. */\nexport interface LazyModuleGroup {\n  moduleId: string;\n  tokens: Token[];\n  /**\n   * A class provider's prototype declares `collectEntrypoints` — the module\n   * must be materialized before the entrypoint registry snapshot or its\n   * computed contributions would be silently absent.\n   */\n  hasEntrypointContributor: boolean;\n}\n\nfunction isThenable(x: unknown): x is PromiseLike<unknown> {\n  return (\n    x !== null &&\n    (typeof x === 'object' || typeof x === 'function') &&\n    typeof (x as PromiseLike<unknown>).then === 'function'\n  );\n}\n\n/**\n * Owns deferred-module state for one application: which module instances are\n * still pending, which have been claimed by a container trigger, and how\n * claimed groups get completed (construction + lifecycle-hook replay).\n *\n * Phases:\n * - `'bootstrap'` (until the end of `callOnApplicationBootstrap`): completed\n *   groups are *absorbed* — their instances queue up for the application's\n *   normal hook phases, so a lazy module dragged in by an eager consumer gets\n *   today-identical semantics.\n * - `'live'`: hooks replay at drain time (memoized, exactly once), then the\n *   instances are handed to the application for shutdown-hook symmetry.\n *\n * Sync/async duality: sync drains throw a descriptive error when a member\n * factory or hook yields a thenable — lazy modules with async providers or\n * hooks must be reached through an async seam (`materializeLazyModules()`,\n * `resolveAsync`) or stay eager.\n */\nexport class LazyModuleManager implements LazyResolutionHook {\n  private readonly pending = new Map<string, LazyModuleGroup>();\n  private readonly claimed: LazyModuleGroup[] = [];\n  private readonly absorbed: unknown[] = [];\n  private phase: 'bootstrap' | 'live' = 'bootstrap';\n  private draining = false;\n  // In-flight async drain: concurrent drainAsync callers must await the SAME\n  // completion (the running loop picks their claims up), never resolve early\n  // with a group's hooks still pending.\n  private drainPromise?: Promise<void>;\n  private onMaterialized?: (instances: unknown[]) => void;\n\n  constructor(private readonly container: Container) {}\n\n  registerGroup(group: LazyModuleGroup): void {\n    this.pending.set(group.moduleId, group);\n  }\n\n  /** Application sink for live-phase materializations (shutdown symmetry). */\n  setOnMaterialized(sink: (instances: unknown[]) => void): void {\n    this.onMaterialized = sink;\n  }\n\n  setPhaseLive(): void {\n    this.phase = 'live';\n  }\n\n  isPending(moduleId: string): boolean {\n    return this.pending.has(moduleId);\n  }\n\n  /** Tokens whose owning modules are ALL still pending are deferred. */\n  hasPendingModules(): boolean {\n    return this.pending.size > 0;\n  }\n\n  claim(moduleId: string): void {\n    const group = this.pending.get(moduleId);\n    if (!group) return;\n    this.pending.delete(moduleId);\n    this.claimed.push(group);\n  }\n\n  hasClaimed(): boolean {\n    return this.claimed.length > 0;\n  }\n\n  /**\n   * A drain loop is running. The container consults this before its\n   * post-resolution drain: `constructGroupAsync` resolves members through\n   * `resolveAsync`, whose end-of-cascade check would otherwise re-enter and\n   * AWAIT the very drain promise it is executing inside — a self-referential\n   * await that never settles (with ≥2 claimed groups). Claims made while\n   * draining are picked up by the running loop instead.\n   */\n  isDraining(): boolean {\n    return this.draining;\n  }\n\n  /** Instances constructed during the bootstrap phase, owed their hooks. */\n  takeAbsorbed(): unknown[] {\n    if (this.absorbed.length === 0) return [];\n    return this.absorbed.splice(0, this.absorbed.length);\n  }\n\n  drainSync(): void {\n    if (this.draining) return;\n    this.draining = true;\n    try {\n      // Construct-all-then-hook, batch by batch: a cascade's groups arrive in\n      // consumer-before-dependency claim order (the consumer's token resolves\n      // first; constructing it claims its deps), so hook phases run over the\n      // REVERSED batch — dependency-before-consumer, matching what the eager\n      // bootstrap would have produced. Hooks can claim further groups\n      // (discovery cascades) → outer loop.\n      while (this.claimed.length > 0) {\n        const batch: Array<{ group: LazyModuleGroup; instances: unknown[] }> = [];\n        while (this.claimed.length > 0) {\n          const group = this.claimed.shift()!;\n          batch.push({ group, instances: this.constructGroupSync(group) });\n        }\n        this.finishBatchSync(batch);\n      }\n    } finally {\n      this.draining = false;\n    }\n  }\n\n  drainAsync(): Promise<void> {\n    if (this.draining) {\n      // External concurrent callers await the in-flight completion (its loop\n      // picks their claims up). Callers INSIDE the drain's own await chain\n      // never reach here — the container skips its post-resolution drain\n      // while isDraining() (self-await would deadlock).\n      return this.drainPromise ?? Promise.resolve();\n    }\n    this.draining = true;\n    const run = (async () => {\n      try {\n        while (this.claimed.length > 0) {\n          const batch: Array<{ group: LazyModuleGroup; instances: unknown[] }> = [];\n          while (this.claimed.length > 0) {\n            const group = this.claimed.shift()!;\n            batch.push({ group, instances: await this.constructGroupAsync(group) });\n          }\n          await this.finishBatchAsync(batch);\n        }\n      } finally {\n        this.draining = false;\n        this.drainPromise = undefined;\n      }\n    })();\n    this.drainPromise = run;\n    return run;\n  }\n\n  /**\n   * Materialize every still-pending group whose providers compute entrypoints\n   * (`collectEntrypoints` on a class prototype). Called by the application\n   * right before the entrypoint-registry snapshot so computed contributions\n   * are never silently absent. The cost — those modules are effectively\n   * eager — is the documented price of contributing computed entrypoints.\n   */\n  async materializeContributors(): Promise<void> {\n    for (const group of [...this.pending.values()]) {\n      if (group.hasEntrypointContributor) this.claim(group.moduleId);\n    }\n    await this.drainAsync();\n  }\n\n  /** Materialize everything still pending (warmup / tests / node runtimes). */\n  async materializeAll(): Promise<void> {\n    for (const moduleId of [...this.pending.keys()]) this.claim(moduleId);\n    await this.drainAsync();\n  }\n\n  private groupTokensToConstruct(group: LazyModuleGroup): Token[] {\n    return group.tokens.filter((token) => this.container.getProviderScope(token) !== Scope.REQUEST);\n  }\n\n  private constructGroupSync(group: LazyModuleGroup): unknown[] {\n    const out = new Set<unknown>();\n    for (const token of this.groupTokensToConstruct(group)) {\n      try {\n        out.add(this.container.resolve(token, group.moduleId));\n      } catch (error) {\n        // Only the sync-resolution-of-async-factory error is a seam problem;\n        // genuine provider failures must surface untouched.\n        if (error instanceof Error && error.message.includes('returned a Promise')) {\n          throw this.describeSyncFailure(group.moduleId, error);\n        }\n        throw error;\n      }\n    }\n    return [...out];\n  }\n\n  private async constructGroupAsync(group: LazyModuleGroup): Promise<unknown[]> {\n    const out = new Set<unknown>();\n    for (const token of this.groupTokensToConstruct(group)) {\n      out.add(await this.container.resolveAsync(token, group.moduleId));\n    }\n    return [...out];\n  }\n\n  /** Reversed batch = dependency-before-consumer (see drainSync comment). */\n  private orderBatch(\n    batch: Array<{ group: LazyModuleGroup; instances: unknown[] }>,\n  ): Array<{ group: LazyModuleGroup; instances: unknown[] }> {\n    return [...batch].reverse();\n  }\n\n  private finishBatchSync(batch: Array<{ group: LazyModuleGroup; instances: unknown[] }>): void {\n    const ordered = this.orderBatch(batch);\n    if (this.phase === 'bootstrap') {\n      for (const { instances } of ordered) this.absorbed.push(...instances);\n      return;\n    }\n    for (const { group, instances } of ordered) {\n      for (const instance of instances) {\n        if (hasOnModuleInit(instance) && isThenable(instance.onModuleInit())) {\n          throw this.describeSyncFailure(group.moduleId);\n        }\n      }\n    }\n    for (const { group, instances } of ordered) {\n      for (const instance of instances) {\n        if (hasOnApplicationBootstrap(instance) && isThenable(instance.onApplicationBootstrap())) {\n          throw this.describeSyncFailure(group.moduleId);\n        }\n      }\n    }\n    this.onMaterialized?.(ordered.flatMap((b) => b.instances));\n  }\n\n  private async finishBatchAsync(\n    batch: Array<{ group: LazyModuleGroup; instances: unknown[] }>,\n  ): Promise<void> {\n    const ordered = this.orderBatch(batch);\n    if (this.phase === 'bootstrap') {\n      for (const { instances } of ordered) this.absorbed.push(...instances);\n      return;\n    }\n    for (const { instances } of ordered) {\n      for (const instance of instances) {\n        if (hasOnModuleInit(instance)) await instance.onModuleInit();\n      }\n    }\n    for (const { instances } of ordered) {\n      for (const instance of instances) {\n        if (hasOnApplicationBootstrap(instance)) await instance.onApplicationBootstrap();\n      }\n    }\n    this.onMaterialized?.(ordered.flatMap((b) => b.instances));\n  }\n\n  private describeSyncFailure(moduleId: string, cause?: unknown): Error {\n    return new Error(\n      `[vela] lazy module '${moduleId}' has async providers or lifecycle hooks and was ` +\n        `triggered through a synchronous resolution path. Reach it through an async seam ` +\n        `first (app.materializeLazyModules(), an async provider) or remove lazy: true.`,\n      cause !== undefined ? { cause } : undefined,\n    );\n  }\n}\n","// Minimal HTML shell that bootstraps Scalar's hosted API-reference UI.\n// Served as a static string so it works on every edge runtime with no\n// Node or bundler deps. Scalar itself is loaded from a CDN at runtime.\nexport function renderScalarUi(jsonUrl: string, title?: string): string {\n  const safeUrl = jsonUrl.replace(/\"/g, '&quot;');\n  const safeTitle = (title ?? 'API Reference')\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;');\n  return `<!doctype html>\n<html>\n  <head>\n    <title>${safeTitle}</title>\n    <meta charset=\"utf-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n  </head>\n  <body>\n    <script id=\"api-reference\" data-url=\"${safeUrl}\"></script>\n    <script src=\"https://cdn.jsdelivr.net/npm/@scalar/api-reference\"></script>\n  </body>\n</html>`;\n}\n","// Minimal HTML shell that bootstraps Swagger UI from a CDN. Served as a\n// static string so it works on every edge runtime with no Node or bundler\n// deps — Swagger UI itself is loaded from a CDN at runtime.\nexport function renderSwaggerUi(specUrl: string, title?: string): string {\n  const safeUrl = specUrl.replace(/\"/g, '&quot;');\n  const safeTitle = (title ?? 'API Reference')\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;');\n  return `<!doctype html>\n<html>\n  <head>\n    <title>${safeTitle}</title>\n    <meta charset=\"utf-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n    <link rel=\"stylesheet\" href=\"https://cdn.jsdelivr.net/npm/swagger-ui-dist/swagger-ui.css\" />\n  </head>\n  <body>\n    <div id=\"swagger-ui\"></div>\n    <script src=\"https://cdn.jsdelivr.net/npm/swagger-ui-dist/swagger-ui-bundle.js\"></script>\n    <script>\n      window.ui = SwaggerUIBundle({ url: \"${safeUrl}\", dom_id: '#swagger-ui' });\n    </script>\n  </body>\n</html>`;\n}\n","// Minimal HTML shell that bootstraps ReDoc from a CDN. Served as a static\n// string so it works on every edge runtime with no Node or bundler deps —\n// ReDoc itself is loaded from a CDN at runtime.\nexport function renderRedocUi(specUrl: string, title?: string): string {\n  const safeUrl = specUrl.replace(/\"/g, '&quot;');\n  const safeTitle = (title ?? 'API Reference')\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;');\n  return `<!doctype html>\n<html>\n  <head>\n    <title>${safeTitle}</title>\n    <meta charset=\"utf-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n  </head>\n  <body>\n    <redoc spec-url=\"${safeUrl}\"></redoc>\n    <script src=\"https://cdn.jsdelivr.net/npm/redoc/bundles/redoc.standalone.js\"></script>\n  </body>\n</html>`;\n}\n","import type { Hono } from 'hono';\nimport { HTTPException } from 'hono/http-exception';\nimport type { ContentfulStatusCode } from 'hono/utils/http-status';\nimport { toErrorBody } from '@velajs/errors';\nimport type { Container } from './container/container';\nimport type { Token, Type } from './container/types';\nimport { APP_EXCEPTION_HANDLER } from './pipeline/tokens';\nimport type { ExceptionHandler } from './exceptions/exception-handler';\nimport { resolveErrorReporter } from './exceptions/reporter';\nimport { DiscoveryService } from './discovery/discovery.service';\nimport { EntrypointRegistry } from './entrypoint/entrypoint.registry';\nimport { LazyModuleManager } from './module/lazy-modules';\nimport type { RouteDescription, RouteManager } from './http/route.manager';\nimport {\n  hasBeforeApplicationShutdown,\n  hasOnApplicationBootstrap,\n  hasOnApplicationShutdown,\n  hasOnModuleDestroy,\n  hasOnModuleInit,\n} from './lifecycle/index';\nimport type { MountOpenApiOptions, OpenApiUi } from './openapi/types';\nimport { renderScalarUi } from './openapi/scalar-ui';\nimport { renderSwaggerUi } from './openapi/swagger-ui';\nimport { renderRedocUi } from './openapi/redoc-ui';\nimport type { FilterType, GuardType, InterceptorType, PipeType } from './registry/types';\n\nexport class VelaApplication {\n  private instances: unknown[] = [];\n  private honoApp: Hono | null = null;\n  private entrypointRegistry: EntrypointRegistry | null = null;\n  private disposed = false;\n  private readonly lazyManager: LazyModuleManager | undefined;\n  // Identity guard for the instance flow: a token registered by BOTH a lazy\n  // and an eager module reaches us through the eager pass AND the absorbed\n  // batch — without dedup its hooks would run twice.\n  private readonly knownInstances = new Set<unknown>();\n\n  constructor(\n    private readonly container: Container,\n    private readonly routeManager: RouteManager,\n  ) {\n    // bootstrap() registers the manager; a hand-built container may not have\n    // one (container unit tests) — lazy semantics simply don't engage then.\n    this.lazyManager = container.has(LazyModuleManager)\n      ? container.resolve(LazyModuleManager)\n      : undefined;\n    // Live-phase materializations join the instance flow so close()/dispose()\n    // run shutdown hooks over them (LIFO — appended last, destroyed first).\n    this.lazyManager?.setOnMaterialized((instances) => {\n      this.instances.push(...this.trackNew(instances));\n    });\n  }\n\n  private trackNew(batch: unknown[]): unknown[] {\n    const fresh = batch.filter((i) => !this.knownInstances.has(i));\n    for (const i of fresh) this.knownInstances.add(i);\n    return fresh;\n  }\n\n  /** Pre-build routes (handles async CRUD imports). Called by VelaFactory. */\n  async initRoutes(): Promise<void> {\n    this.honoApp = await this.routeManager.build();\n\n    // Last line of defense for the HTTP edge. HandlerExecutor's catch tail\n    // only sees controller-handler errors; a raw Hono middleware (or any\n    // hono-level throw that bypasses route.manager's wrapMiddlewareWithFilters)\n    // would otherwise reach Hono's default error handler unreported and\n    // unredacted. `onError` funnels it through the same report-first + canonical\n    // redacted body path every other edge uses.\n    this.honoApp.onError((err, c) => {\n      const reporter = resolveErrorReporter(this.container);\n      // Hono's own HTTPException (e.g. `bodyLimit`'s 413) carries a deliberate,\n      // author-intended client response — honor it exactly as Hono's default\n      // error handler would, without treating it as a server fault to redact.\n      // But a 5xx HTTPException is still a server fault: every other edge reports\n      // before returning, so report status>=500 here too (leaving the verbatim\n      // response — and its redaction/status — untouched).\n      if (err instanceof HTTPException) {\n        if (err.status >= 500) {\n          reporter.report(err, { edge: 'hono', source: `${c.req.method} ${c.req.path}` });\n        }\n        return err.getResponse();\n      }\n      reporter.report(err, { edge: 'hono', source: `${c.req.method} ${c.req.path}` });\n      const { body, status } = toErrorBody(err, { catalog: reporter.catalog });\n      return c.json(body, status as ContentfulStatusCode);\n    });\n  }\n\n  private getApp(): Hono {\n    if (!this.honoApp) {\n      throw new Error(\n        'Routes not built. This should not happen — VelaFactory.create() builds routes automatically.',\n      );\n    }\n    return this.honoApp;\n  }\n\n  get fetch(): Hono['fetch'] {\n    return this.getApp().fetch;\n  }\n\n  getInstances(): unknown[] {\n    return this.instances;\n  }\n\n  getContainer(): Container {\n    return this.container;\n  }\n\n  setInstances(instances: unknown[]): void {\n    this.instances = instances;\n    this.knownInstances.clear();\n    for (const i of instances) this.knownInstances.add(i);\n  }\n\n  get<T>(token: Token<T>): T {\n    return this.container.resolve(token);\n  }\n\n  getHonoApp(): Hono {\n    return this.getApp();\n  }\n\n  /**\n   * Every explicit controller route as the framework registered it (fully\n   * composed paths — the `vela route list` seam). Requires built routes;\n   * contributed routes (`@velajs/crud`) mount directly on Hono and are\n   * observable via `getHonoApp().routes` instead.\n   */\n  describeRoutes(): RouteDescription[] {\n    this.getApp(); // same routes-not-built guard as every HTTP accessor\n    return this.routeManager.getRouteDescriptions();\n  }\n\n  /** The global route prefix in effect ('' when none). */\n  getGlobalPrefix(): string {\n    return this.routeManager.getGlobalPrefix();\n  }\n\n  // Pipeline components — applied at request time, no rebuild needed\n\n  useGlobalPipes(...pipes: PipeType[]): this {\n    this.routeManager.useGlobalPipes(...pipes);\n    return this;\n  }\n\n  useGlobalGuards(...guards: GuardType[]): this {\n    this.routeManager.useGlobalGuards(...guards);\n    return this;\n  }\n\n  useGlobalInterceptors(...interceptors: InterceptorType[]): this {\n    this.routeManager.useGlobalInterceptors(...interceptors);\n    return this;\n  }\n\n  useGlobalFilters(...filters: FilterType[]): this {\n    this.routeManager.useGlobalFilters(...filters);\n    return this;\n  }\n\n  /**\n   * Register the application-wide {@link ExceptionHandler} imperatively — the\n   * sibling of `ErrorsModule.forRoot({ handler })`. A class is constructed\n   * through DI (`useClass`); a plain handler object is registered verbatim\n   * (`useValue`). Consumed by `resolveErrorReporter` at every transport edge,\n   * so it takes effect on the next request without a rebuild.\n   *\n   * ```ts\n   * app.useGlobalExceptionHandler({ report: (e) => sentry.capture(e) });\n   * ```\n   */\n  useGlobalExceptionHandler(handler: Type<ExceptionHandler> | ExceptionHandler): this {\n    this.container.register(\n      typeof handler === 'function'\n        ? { provide: APP_EXCEPTION_HANDLER, useClass: handler }\n        : { provide: APP_EXCEPTION_HANDLER, useValue: handler },\n    );\n    return this;\n  }\n\n  /**\n   * Serve a pre-built OpenAPI document and one or more interactive doc UIs\n   * (Swagger UI, Scalar, ReDoc) on the underlying Hono app, mirroring the\n   * hono-crud docs convention. Edge-safe: each UI is a tiny self-contained\n   * HTML shell that loads its renderer from a CDN at runtime so nothing is\n   * bundled server-side and no extra dependency is required.\n   *\n   * Defaults: spec at `/openapi.json`, Scalar at `/scalar`, Swagger UI at\n   * `/docs`, ReDoc at `/redoc`. The deprecated `path` / `uiPath` aliases are\n   * retained for migration from the previous single-UI shape.\n   *\n   * ```ts\n   * const doc = createOpenApiDocument(AppModule);\n   * app.mountOpenApi({ document: doc });            // Scalar @ /scalar\n   * app.mountOpenApi({ document: doc, ui: 'all' }); // swagger + scalar + redoc\n   * ```\n   */\n  mountOpenApi(options: MountOpenApiOptions): this {\n    const app = this.getApp();\n    const doc = options.document;\n    const title = options.title;\n\n    // Spec JSON: new default `/openapi.json`. The deprecated `path` alias is\n    // honored as an override only (does not change the default).\n    const specPath = options.specPath ?? options.path ?? '/openapi.json';\n    app.get(specPath, (c) => c.json(doc));\n\n    // Normalize the requested UI set. Default is Scalar only.\n    const uiOption = options.ui;\n    let uis: OpenApiUi[];\n    let singleStringUi = false;\n    if (uiOption === undefined) {\n      uis = ['scalar'];\n    } else if (uiOption === 'all') {\n      uis = ['swagger', 'scalar', 'redoc'];\n    } else if (Array.isArray(uiOption)) {\n      uis = uiOption;\n    } else {\n      uis = [uiOption];\n      singleStringUi = true;\n    }\n\n    for (const ui of uis) {\n      // Back-compat: the old `{ ui: 'scalar', uiPath }` form mapped a single\n      // string UI to `uiPath`. Honor that only when exactly one UI was\n      // requested as a string.\n      const legacyPath = singleStringUi && uis.length === 1 ? options.uiPath : undefined;\n\n      if (ui === 'swagger') {\n        const path = legacyPath ?? options.swaggerPath ?? '/docs';\n        const html = renderSwaggerUi(specPath, title);\n        app.get(path, (c) => c.html(html));\n      } else if (ui === 'redoc') {\n        const path = legacyPath ?? options.redocPath ?? '/redoc';\n        const html = renderRedocUi(specPath, title);\n        app.get(path, (c) => c.html(html));\n      } else {\n        const path = legacyPath ?? options.scalarPath ?? '/scalar';\n        const html = renderScalarUi(specPath, title);\n        app.get(path, (c) => c.html(html));\n      }\n    }\n\n    return this;\n  }\n\n  // Lifecycle hooks\n\n  /**\n   * Pull instances materialized during the bootstrap phase (lazy modules\n   * dragged in by eager consumers) into the front of the instance list —\n   * dependency-before-consumer: a group absorbed because an eager provider\n   * injected it must be initialized before that consumer's hooks read it.\n   */\n  private absorbLazyInstances(prepend: boolean): unknown[] {\n    const batch = this.trackNew(this.lazyManager?.takeAbsorbed() ?? []);\n    if (batch.length === 0) return batch;\n    if (prepend) {\n      this.instances = [...batch, ...this.instances];\n    } else {\n      this.instances.push(...batch);\n    }\n    return batch;\n  }\n\n  async callOnModuleInit(): Promise<void> {\n    this.absorbLazyInstances(true);\n    // Index loop: hooks can trigger further absorptions, which append —\n    // the loop naturally covers them.\n    for (let i = 0; i < this.instances.length; i++) {\n      const instance = this.instances[i];\n      if (hasOnModuleInit(instance)) {\n        await instance.onModuleInit();\n      }\n      this.absorbLazyInstances(false);\n    }\n  }\n\n  async callOnApplicationBootstrap(): Promise<void> {\n    for (let i = 0; i < this.instances.length; i++) {\n      const instance = this.instances[i];\n      if (hasOnApplicationBootstrap(instance)) {\n        await instance.onApplicationBootstrap();\n      }\n      // Instances absorbed mid-phase already missed the init pass — run\n      // onModuleInit now; the loop then reaches them for the bootstrap hook.\n      for (const late of this.absorbLazyInstances(false)) {\n        if (hasOnModuleInit(late)) await late.onModuleInit();\n      }\n    }\n\n    // Computed-entrypoint contributors (ContributesEntrypoints) in lazy\n    // modules must exist before the snapshot below — materialize them now\n    // (the documented cost of contributing computed entrypoints), then run\n    // their hooks through the same absorb loop.\n    if (this.lazyManager) {\n      await this.lazyManager.materializeContributors();\n      let batch: unknown[];\n      while ((batch = this.absorbLazyInstances(false)).length > 0) {\n        for (const late of batch) {\n          if (hasOnModuleInit(late)) await late.onModuleInit();\n        }\n        for (const late of batch) {\n          if (hasOnApplicationBootstrap(late)) await late.onApplicationBootstrap();\n        }\n      }\n      // From here on, materializations replay their hooks at the trigger.\n      this.lazyManager.setPhaseLive();\n    }\n\n    // Build the per-app entrypoint registry AFTER the hooks: dispatchers that\n    // implement ContributesEntrypoints (WsDispatcher) finish their own\n    // discovery inside onApplicationBootstrap. Built here — not in\n    // VelaFactory/initRoutes — so slim bootstrap paths that never build HTTP\n    // routes (the Cloudflare Durable Object) still get `app.entrypoints`.\n    // Lazy-pending providers of declared kinds yield metadata-only entries\n    // (instance: undefined) — dispatchers re-resolve by token per event,\n    // which materializes the owning module at dispatch time.\n    const discovery = this.container.has(DiscoveryService)\n      ? this.container.resolve(DiscoveryService)\n      : new DiscoveryService(this.container);\n    this.entrypointRegistry = await EntrypointRegistry.build(discovery, this.instances, {\n      deferLazy: true,\n    });\n\n    // Make the per-app registry injectable (global token): providers that\n    // dispatch entrypoints themselves (the queue module's in-process driver\n    // binding) resolve it instead of needing a back-reference to the app.\n    // Registered AFTER build so anything resolving it sees the final registry;\n    // pre-bootstrap resolution attempts fail the `has()` probe and defer.\n    this.container.register({ provide: EntrypointRegistry, useValue: this.entrypointRegistry });\n    this.container.markGlobalToken(EntrypointRegistry);\n  }\n\n  /**\n   * Materialize every still-pending lazy module (async-safe): construct the\n   * groups, replay their lifecycle hooks, and add their instances to the\n   * shutdown flow. Warmup escape hatch for tests and node runtimes that want\n   * eager-everything semantics back after bootstrap.\n   */\n  async materializeLazyModules(): Promise<void> {\n    await this.lazyManager?.materializeAll();\n  }\n\n  /**\n   * Every entrypoint contributed by the module graph, grouped by kind —\n   * what runtime adapters/transports query instead of re-scanning providers:\n   * `app.entrypoints.ofKind('websocket')`.\n   */\n  get entrypoints(): EntrypointRegistry {\n    if (!this.entrypointRegistry) {\n      throw new Error(\n        'Entrypoints are not built yet — they are assembled at the end of ' +\n          'callOnApplicationBootstrap(). Finish bootstrapping before querying them.',\n      );\n    }\n    return this.entrypointRegistry;\n  }\n\n  async close(signal?: string): Promise<void> {\n    const reversed = [...this.instances].reverse();\n\n    for (const instance of reversed) {\n      if (hasBeforeApplicationShutdown(instance)) {\n        await instance.beforeApplicationShutdown(signal);\n      }\n    }\n\n    for (const instance of reversed) {\n      if (hasOnModuleDestroy(instance)) {\n        await instance.onModuleDestroy();\n      }\n    }\n\n    for (const instance of reversed) {\n      if (hasOnApplicationShutdown(instance)) {\n        await instance.onApplicationShutdown(signal);\n      }\n    }\n  }\n\n  /**\n   * Full teardown: run shutdown lifecycle hooks ({@link close}) then dispose\n   * container-held instances (LIFO) and clear cached singletons. Use for\n   * graceful shutdown and dev HMR so old and new DI graphs never coexist.\n   *\n   * On runtimes/TS supporting explicit resource management this is also exposed\n   * as `Symbol.asyncDispose`, enabling `await using app = await VelaFactory.create(...)`.\n   */\n  async dispose(signal?: string): Promise<void> {\n    // Idempotent: `await using` + an explicit dispose(), or repeated shutdown\n    // signals, must not re-run shutdown lifecycle hooks.\n    if (this.disposed) return;\n    this.disposed = true;\n    await this.close(signal);\n    await this.container.dispose();\n  }\n}\n\n// Attach the well-known async-dispose symbol at runtime (it is not in the\n// ES2022 lib the project compiles against) so `await using` works where\n// supported, without a type dependency on esnext.disposable.\nconst ASYNC_DISPOSE: symbol | undefined = (Symbol as { asyncDispose?: symbol }).asyncDispose;\nif (ASYNC_DISPOSE) {\n  (VelaApplication.prototype as unknown as Record<PropertyKey, unknown>)[ASYNC_DISPOSE] = function (\n    this: VelaApplication,\n  ): Promise<void> {\n    return this.dispose();\n  };\n}\n","import { Scope } from '../constants';\nimport { Injectable } from './decorators';\nimport type { Token, Type } from './types';\nimport type { Container } from './container';\n\n@Injectable()\nexport class ModuleRef {\n  constructor(private readonly container: Container) {}\n\n  /**\n   * Retrieve a provider instance from the DI container.\n   * Returns the existing singleton (or cached value) for the token.\n   */\n  get<T>(token: Token<T>): T {\n    return this.container.resolve(token);\n  }\n\n  /**\n   * Resolve a provider, creating a new instance for TRANSIENT-scoped providers.\n   * For SINGLETON-scoped providers this is equivalent to get().\n   */\n  resolve<T>(token: Token<T>): T {\n    return this.container.resolve(token);\n  }\n\n  /**\n   * Instantiate a class outside of the DI container's singleton cache.\n   * Dependencies are resolved from the container. Each call returns a new instance.\n   */\n  create<T>(type: Type<T>): T {\n    const sandbox = this.container.createDetached();\n    sandbox.register({ provide: type, useClass: type, scope: Scope.TRANSIENT });\n    return sandbox.resolve(type);\n  }\n}\n","import { InjectionToken } from '../container/types';\n\nexport const CONFIG_OPTIONS = new InjectionToken<Record<string, unknown>>('CONFIG_OPTIONS');\n\n/**\n * Ambient environment record consumed by config-namespace factories\n * (`registerAs`). It is the multi-runtime substitute for stratal's\n * Cloudflare-specific `env` token: core never touches `process.env`.\n *\n * The token self-provides `{}` by default (so factories resolve even with no\n * platform binding), and stays OVERRIDABLE — a platform adapter\n * (`@velajs/cloudflare`) or a future `./config-node` subpath provides a global\n * `CONFIG_ENV` and that registration wins over the default.\n */\nexport const CONFIG_ENV = new InjectionToken<Record<string, unknown>>('CONFIG_ENV', {\n  factory: () => ({}),\n});\n","import { InjectionToken } from '../../container/types';\n\n/**\n * Optional DI token holding the HMAC secret used to sign / verify URLs. Provide\n * it globally (e.g. from a platform adapter or a `@Global` module) so both\n * {@link UrlGeneratorService} and the signed-URL guard can read it:\n *\n * ```ts\n * { provide: URL_SIGNING_SECRET, useValue: env.URL_SIGNING_SECRET }\n * ```\n */\nexport const URL_SIGNING_SECRET = new InjectionToken<string>('URL_SIGNING_SECRET');\n\n/** Key read from `CONFIG_ENV` when no explicit secret / token is available. */\nexport const URL_SIGNING_SECRET_ENV_KEY = 'URL_SIGNING_SECRET';\n\n/**\n * Resolve the signing secret from, in order: an explicit argument, the\n * {@link URL_SIGNING_SECRET} token, then `CONFIG_ENV[URL_SIGNING_SECRET]`.\n * Throws a descriptive error when none is available — signing must never fall\n * back to an empty/implicit key.\n */\nexport function resolveSigningSecret(\n  explicit: string | undefined,\n  token: string | undefined,\n  env: Record<string, unknown> | undefined,\n): string {\n  const fromEnv = env?.[URL_SIGNING_SECRET_ENV_KEY];\n  const secret = explicit ?? token ?? (typeof fromEnv === 'string' ? fromEnv : undefined);\n  if (!secret) {\n    throw new Error(\n      'No URL signing secret is available. Pass one explicitly, register a ' +\n        '`URL_SIGNING_SECRET` provider, or set `URL_SIGNING_SECRET` in `CONFIG_ENV`.',\n    );\n  }\n  return secret;\n}\n","import { Injectable, Inject, Optional } from '../../container/decorators';\nimport { CONFIG_ENV } from '../../config/config.tokens';\nimport { signUrl } from '../../crypto/signed-url';\nimport { RouteManager } from '../route.manager';\nimport type { RouteDescription } from '../route.manager';\nimport type { RouteName, RouteParams } from '../route-map';\nimport { URL_SIGNING_SECRET, resolveSigningSecret } from './signing-secret';\n\n/** Value accepted for a path param or query entry. */\ntype UrlParamValue = string | number | boolean;\n\n/** Extra options for {@link UrlGeneratorService.urlFor}. */\nexport interface UrlForOptions {\n  /** Additional query-string entries merged after any leftover params. */\n  query?: Record<string, UrlParamValue>;\n}\n\n/** Options for {@link UrlGeneratorService.signedUrl}. */\nexport interface SignedUrlGenerateOptions {\n  /** Time-to-live in seconds; enforced on verification via the `expires` param. */\n  expiresIn?: number;\n  /** Override the signing secret (else the `URL_SIGNING_SECRET` token / `CONFIG_ENV`). */\n  secret?: string;\n}\n\n/**\n * Builds URLs for named routes (Laravel-flavoured `route()` ergonomics).\n *\n * Route descriptions are read LAZILY from the {@link RouteManager} on first use\n * — post-build, so composition (global prefix + version + controller prefix) is\n * already baked into each path — and it never instantiates controllers, so it\n * plays nicely with lazy modules. Registered as an app-level singleton by\n * `bootstrap`, so it is injectable anywhere.\n */\n@Injectable()\nexport class UrlGeneratorService {\n  private routeMap: Map<string, RouteDescription> | null = null;\n\n  constructor(\n    @Inject(RouteManager) private readonly routeManager: RouteManager,\n    @Optional() @Inject(URL_SIGNING_SECRET) private readonly secretToken?: string,\n    @Optional() @Inject(CONFIG_ENV) private readonly env: Record<string, unknown> = {},\n  ) {}\n\n  /**\n   * Build the path for a named route, filling `:param` placeholders from\n   * `params`. Params that don't match a placeholder become query-string\n   * entries; `opts.query` is merged after them.\n   *\n   * @throws if no route carries `name`, or a required `:param` is missing.\n   */\n  urlFor<N extends RouteName>(name: N, params?: RouteParams<N>, opts?: UrlForOptions): string {\n    const description = this.routes().get(name as string);\n    if (!description) {\n      throw new Error(\n        `No route named \"${String(name)}\" was found. Give the route a name ` +\n          `via \\`@Get(path, { name: '${String(name)}' })\\`.`,\n      );\n    }\n\n    const provided = { ...(params ?? {}) } as Record<string, UrlParamValue | null | undefined>;\n    const consumed = new Set<string>();\n\n    const path = description.path.replace(/:([A-Za-z0-9_]+)/g, (_match, key: string) => {\n      const value = provided[key];\n      if (value === undefined || value === null) {\n        throw new Error(`Missing route param \"${key}\" for route \"${String(name)}\".`);\n      }\n      consumed.add(key);\n      return encodeURIComponent(String(value));\n    });\n\n    const query = new URLSearchParams();\n    for (const [key, value] of Object.entries(provided)) {\n      if (consumed.has(key) || value === undefined || value === null) continue;\n      query.set(key, String(value));\n    }\n    for (const [key, value] of Object.entries(opts?.query ?? {})) {\n      if (value === undefined || value === null) continue;\n      query.set(key, String(value));\n    }\n\n    const qs = query.toString();\n    return qs ? `${path}?${qs}` : path;\n  }\n\n  /**\n   * Build a named-route URL and HMAC-sign it (path + query). The secret comes\n   * from `options.secret`, else the {@link URL_SIGNING_SECRET} token, else\n   * `CONFIG_ENV`; a descriptive error is thrown when none is available.\n   */\n  async signedUrl<N extends RouteName>(\n    name: N,\n    params?: RouteParams<N>,\n    options: SignedUrlGenerateOptions = {},\n  ): Promise<string> {\n    const url = this.urlFor(name, params);\n    const secret = resolveSigningSecret(options.secret, this.secretToken, this.env);\n    return signUrl(\n      url,\n      secret,\n      options.expiresIn !== undefined ? { expiresIn: options.expiresIn } : undefined,\n    );\n  }\n\n  /**\n   * Lazily index named route descriptions. Rebuilt while empty (routes may not\n   * be built yet), cached once populated.\n   */\n  private routes(): Map<string, RouteDescription> {\n    if (this.routeMap && this.routeMap.size > 0) return this.routeMap;\n    const map = new Map<string, RouteDescription>();\n    for (const description of this.routeManager.getRouteDescriptions()) {\n      if (description.name && !map.has(description.name)) {\n        map.set(description.name, description);\n      }\n    }\n    this.routeMap = map;\n    return map;\n  }\n}\n","import { Injectable, Inject, Optional } from '../../container/decorators';\nimport { CONFIG_ENV } from '../../config/config.tokens';\nimport { verifySignedUrl } from '../../crypto/signed-url';\nimport { ForbiddenException } from '../../errors/http-exception';\nimport { applyDecorators } from '../decorators';\nimport { UseGuards } from '../../pipeline/decorators';\nimport type { CanActivate, ExecutionContext } from '../../pipeline/types';\nimport { URL_SIGNING_SECRET, resolveSigningSecret } from './signing-secret';\n\n/**\n * Verifies the HMAC signature (and `expires`) of the incoming request URL,\n * using the same secret source as {@link UrlGeneratorService.signedUrl}: the\n * {@link URL_SIGNING_SECRET} token, else `CONFIG_ENV`. Throws\n * `ForbiddenException` (403) when the signature is missing, tampered, or\n * expired. Registered app-wide by `bootstrap`; apply it per-route with\n * {@link SignedUrl}.\n */\n@Injectable()\nexport class SignedUrlGuard implements CanActivate {\n  constructor(\n    @Optional() @Inject(URL_SIGNING_SECRET) private readonly secretToken?: string,\n    @Optional() @Inject(CONFIG_ENV) private readonly env: Record<string, unknown> = {},\n  ) {}\n\n  async canActivate(context: ExecutionContext): Promise<boolean> {\n    const request = context.switchToHttp().getRequest<Request>();\n    const secret = resolveSigningSecret(undefined, this.secretToken, this.env);\n    const valid = await verifySignedUrl(request.url, secret);\n    if (!valid) {\n      throw new ForbiddenException('Invalid or expired signed URL');\n    }\n    return true;\n  }\n}\n\n/**\n * Guards a route with {@link SignedUrlGuard} — the request must carry a valid,\n * unexpired HMAC signature (produced by `UrlGeneratorService.signedUrl`).\n *\n * ```ts\n * @Get('download', { name: 'file.download' })\n * @SignedUrl()\n * download() { ... }\n * ```\n */\nexport function SignedUrl(): ReturnType<typeof applyDecorators> {\n  return applyDecorators(UseGuards(SignedUrlGuard));\n}\n","import { HttpMethod } from '../constants';\nimport type { NestMiddleware } from '../pipeline/types';\nimport { MetadataRegistry } from '../registry/metadata.registry';\nimport type { Constructor, Type } from '../registry/types';\n\nexport interface RouteInfo {\n  path: string;\n  method?: HttpMethod;\n}\n\nexport interface MiddlewareRouteDefinition {\n  middleware: Array<Type<NestMiddleware> | NestMiddleware>;\n  routes: RouteInfo[];\n  excludes: RouteInfo[];\n  /** Stable-sort key; lower runs first. Default 0. */\n  priority?: number;\n}\n\nexport interface MiddlewareConfigProxy {\n  exclude(...routes: Array<string | RouteInfo>): MiddlewareConfigProxy;\n  withPriority(priority: number): MiddlewareConfigProxy;\n  forRoutes(...routes: Array<string | Constructor | RouteInfo>): MiddlewareConsumer;\n}\n\nexport interface MiddlewareConsumer {\n  apply(...middleware: Array<Type<NestMiddleware> | NestMiddleware>): MiddlewareConfigProxy;\n}\n\nexport interface NestModule {\n  configure(consumer: MiddlewareConsumer): void;\n}\n\nexport class MiddlewareBuilder implements MiddlewareConsumer {\n  private definitions: MiddlewareRouteDefinition[] = [];\n\n  apply(...middleware: Array<Type<NestMiddleware> | NestMiddleware>): MiddlewareConfigProxy {\n    const currentMiddleware = [...middleware];\n    let currentExcludes: RouteInfo[] = [];\n    let currentPriority: number | undefined;\n\n    const proxy: MiddlewareConfigProxy = {\n      exclude: (...routes: Array<string | RouteInfo>) => {\n        currentExcludes = routes.map(normalizeRouteArg);\n        return proxy;\n      },\n      withPriority: (priority: number) => {\n        currentPriority = priority;\n        return proxy;\n      },\n      forRoutes: (...routes: Array<string | Constructor | RouteInfo>) => {\n        this.definitions.push({\n          middleware: currentMiddleware,\n          routes: routes.flatMap(resolveRouteArg),\n          excludes: [...currentExcludes],\n          ...(currentPriority !== undefined ? { priority: currentPriority } : {}),\n        });\n        currentExcludes = [];\n        currentPriority = undefined;\n        return this;\n      },\n    };\n\n    return proxy;\n  }\n\n  getDefinitions(): MiddlewareRouteDefinition[] {\n    return [...this.definitions];\n  }\n}\n\nfunction normalizeRouteArg(route: string | RouteInfo): RouteInfo {\n  return typeof route === 'string' ? { path: route } : route;\n}\n\nfunction resolveRouteArg(route: string | Constructor | RouteInfo): RouteInfo[] {\n  if (typeof route === 'string') {\n    return [{ path: route }];\n  }\n  if (typeof route === 'function') {\n    const prefix = MetadataRegistry.getControllerPath(route as Constructor);\n    return [{ path: prefix || '/' }];\n  }\n  return [route];\n}\n","import { Scope } from '../constants';\nimport type { Container } from '../container/container';\nimport {\n  ForwardRef,\n  InjectionToken,\n  ModuleVisibilityError,\n  MultipleProvidersFoundError,\n} from '../container/types';\nimport type { ProviderOptions, Token, Type } from '../container/types';\nimport type { RouteManager } from '../http/route.manager';\nimport {\n  APP_FILTER,\n  APP_GUARD,\n  APP_INTERCEPTOR,\n  APP_MIDDLEWARE,\n  APP_PIPE,\n} from '../pipeline/tokens';\nimport { MetadataRegistry } from '../registry/metadata.registry';\nimport { getOrCreateArray } from '../registry/util';\nimport type { DynamicModule, ModuleImport } from '../registry/types';\nimport { getModuleMetadata, isModule } from './decorators';\nimport { LazyModuleManager } from './lazy-modules';\nimport { MiddlewareBuilder } from './middleware';\nimport type { MiddlewareRouteDefinition, NestModule } from './middleware';\n\nconst APP_TOKENS = new Set<Token>([\n  APP_GUARD,\n  APP_PIPE,\n  APP_INTERCEPTOR,\n  APP_FILTER,\n  APP_MIDDLEWARE,\n]);\n\nconst DEFAULT_KEY = 'default';\n\n/** What the loader records per lazy module instance (see LazyModuleManager). */\nexport interface LazyModuleGroupSpec {\n  moduleId: string;\n  tokens: Token[];\n  hasEntrypointContributor: boolean;\n}\n\n/**\n * Structural check for `ContributesEntrypoints` on a provider's class —\n * deliberately string-coupled to the interface's method name so the loader\n * does not import from `entrypoint/` (layering).\n */\nfunction declaresEntrypointContributor(provider: Type | ProviderOptions): boolean {\n  const cls = typeof provider === 'function' ? provider : provider.useClass;\n  if (typeof cls !== 'function') return false;\n  const proto = (cls as Type).prototype as Record<string, unknown> | undefined;\n  return typeof proto?.collectEntrypoints === 'function';\n}\n\nfunction isDynamicModule(value: unknown): value is DynamicModule {\n  // TS 4.9+ narrows `'module' in value` so `value.module` is typed `unknown`\n  // — no cast required for the typeof check below.\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'module' in value &&\n    typeof value.module === 'function'\n  );\n}\n\nfunction implementsNestModule(cls: Type): cls is Type<NestModule> {\n  // `Type.prototype` is `any` — direct property access is type-safe enough.\n  return typeof cls.prototype?.configure === 'function';\n}\n\nfunction tokenOfProvider(provider: Type | ProviderOptions): Token | undefined {\n  return typeof provider === 'function' ? provider : provider.provide;\n}\n\nfunction keyOfImport(entry: Type | DynamicModule): string {\n  return isDynamicModule(entry) ? (entry.key ?? DEFAULT_KEY) : DEFAULT_KEY;\n}\n\n/**\n * `ForwardRef.factory` is typed to return the broader `Token<T>` because the\n * primitive is shared with provider injection. In module-imports position the\n * runtime contract narrows: the factory must yield a module class or a\n * `DynamicModule`. This helper validates the contract AND narrows the type\n * without a structural cast.\n */\nfunction unwrapModuleForwardRef(ref: ForwardRef): Type | DynamicModule {\n  const result = ref.factory();\n  if (typeof result === 'function') return result;\n  if (isDynamicModule(result)) return result;\n  throw new Error(\n    `forwardRef in module imports must resolve to a module class or DynamicModule; ` +\n      `got ${typeof result === 'object' ? 'a non-module object' : typeof result}.`,\n  );\n}\n\nexport class ModuleLoader {\n  // class → set of keys already processed (multi-instance dedup is by both)\n  private processedModules = new Map<Type, Set<string>>();\n  private processingStack = new Set<string>();\n  private collectedControllers = new Set<Type>();\n  private registeredProviders: Token[] = [];\n  // (class, key) → exported tokens\n  private moduleExportsCache = new Map<Type, Map<string, Set<Token>>>();\n  private globalExports = new Set<Token>();\n  private consumerMiddlewareDefinitions: MiddlewareRouteDefinition[] = [];\n  private appProviderCounter = 0;\n  private appProviderTokens = new Map<Token, Token[]>([\n    [APP_GUARD, []],\n    [APP_PIPE, []],\n    [APP_INTERCEPTOR, []],\n    [APP_FILTER, []],\n    [APP_MIDDLEWARE, []],\n  ]);\n  // (class, key) → composed moduleId (cached for stable identity within a load)\n  private moduleIdByClassKey = new Map<Type, Map<string, string>>();\n  private seenModuleIds = new Set<string>();\n  // Lazy (deferred-init) module instances: moduleId → its own tokens in\n  // registration order. Consumed by LazyModuleManager via getLazyGroups().\n  private lazyModuleIds = new Set<string>();\n  private lazyGroups = new Map<string, LazyModuleGroupSpec>();\n\n  constructor(\n    private container: Container,\n    private router: RouteManager,\n  ) {}\n\n  load(rootModule: Type): void {\n    this.processModule(rootModule);\n\n    for (const controller of this.collectedControllers) {\n      this.router.registerController(controller);\n    }\n\n    // Arm the deferred-init seam HERE — at the end of load(), not in\n    // bootstrap() — so every consumer of the loader gets identical lazy\n    // semantics, including hand-rolled bootstrap paths that never call\n    // bootstrap() (@velajs/testing's TestingModuleBuilder.compile builds its\n    // own container). Still after all module-load-time resolutions\n    // (NestModule.configure), so load-time resolution never claims a group.\n    // Registered as a provider so VelaApplication can drive the phase\n    // transitions from any of those paths.\n    const lazyManager = new LazyModuleManager(this.container);\n    for (const group of this.getLazyGroups()) {\n      lazyManager.registerGroup(group);\n    }\n    this.container.setLazyHook(lazyManager);\n    this.container.register({ provide: LazyModuleManager, useValue: lazyManager });\n  }\n\n  private getModuleId(moduleClass: Type, key: string): string {\n    let perClass = this.moduleIdByClassKey.get(moduleClass);\n    if (perClass) {\n      const cached = perClass.get(key);\n      if (cached) return cached;\n    } else {\n      perClass = new Map();\n      this.moduleIdByClassKey.set(moduleClass, perClass);\n    }\n\n    const baseName = moduleClass.name || 'AnonModule';\n    let id = `${baseName}#${key}`;\n    let counter = 0;\n    // Cross-class name collision (rare): two different classes named identically.\n    // The (class, key) pair identifies us; bump suffix to keep `id` strings unique\n    // in `seenModuleIds` so debug output stays unambiguous.\n    while (this.seenModuleIds.has(id)) {\n      id = `${baseName}#${key}~${++counter}`;\n    }\n    this.seenModuleIds.add(id);\n    perClass.set(key, id);\n    return id;\n  }\n\n  private isProcessed(moduleClass: Type, key: string): boolean {\n    return this.processedModules.get(moduleClass)?.has(key) ?? false;\n  }\n\n  private markProcessed(moduleClass: Type, key: string): void {\n    let keys = this.processedModules.get(moduleClass);\n    if (!keys) {\n      keys = new Set();\n      this.processedModules.set(moduleClass, keys);\n    }\n    keys.add(key);\n  }\n\n  private getCachedExports(moduleClass: Type, key: string): Set<Token> | undefined {\n    return this.moduleExportsCache.get(moduleClass)?.get(key);\n  }\n\n  private cacheExports(moduleClass: Type, key: string, exports: Set<Token>): void {\n    let perClass = this.moduleExportsCache.get(moduleClass);\n    if (!perClass) {\n      perClass = new Map();\n      this.moduleExportsCache.set(moduleClass, perClass);\n    }\n    perClass.set(key, exports);\n  }\n\n  private processModule(moduleClassOrDynamic: Type | DynamicModule): Set<Token> {\n    let moduleClass: Type;\n    let extraImports: ModuleImport[] = [];\n    let extraControllers: Type[] = [];\n    let extraProviders: Array<Type | ProviderOptions> = [];\n    let extraExports: Array<Type | InjectionToken> = [];\n    let key: string = DEFAULT_KEY;\n\n    if (isDynamicModule(moduleClassOrDynamic)) {\n      moduleClass = moduleClassOrDynamic.module;\n      extraImports = moduleClassOrDynamic.imports ?? [];\n      extraControllers = moduleClassOrDynamic.controllers ?? [];\n      extraProviders = moduleClassOrDynamic.providers ?? [];\n      extraExports = moduleClassOrDynamic.exports ?? [];\n      key = moduleClassOrDynamic.key ?? DEFAULT_KEY;\n    } else {\n      moduleClass = moduleClassOrDynamic;\n    }\n\n    if (this.isProcessed(moduleClass, key)) {\n      // Even if already processed, still collect extra controllers from dynamic module\n      for (const controller of extraControllers) {\n        this.collectedControllers.add(controller);\n      }\n      return this.getCachedExports(moduleClass, key) ?? new Set();\n    }\n\n    const stackKey = `${moduleClass.name}#${key}`;\n    if (this.processingStack.has(stackKey)) {\n      const chain = [...this.processingStack, stackKey].join(' -> ');\n      throw new Error(`Circular module dependency detected: ${chain}`);\n    }\n\n    if (!isModule(moduleClass)) {\n      if (isDynamicModule(moduleClassOrDynamic)) {\n        MetadataRegistry.setModuleOptions(moduleClass, {});\n      } else {\n        throw new Error(\n          `${moduleClass.name} is not a module. Add @Module() decorator to the class.`,\n        );\n      }\n    }\n\n    const metadata = getModuleMetadata(moduleClass);\n    if (!metadata) {\n      throw new Error(`Failed to get module metadata for ${moduleClass.name}`);\n    }\n\n    this.processingStack.add(stackKey);\n\n    const moduleId = this.getModuleId(moduleClass, key);\n\n    try {\n      const importedProviders = new Set<Token>(this.globalExports);\n\n      // Determine importedModuleIds eagerly (before recursing) so child\n      // modules can be referenced in our scope's importedModules set.\n      const importedModuleIds = new Set<string>();\n\n      // Track per-class keys seen in this imports array — emit a loader-time\n      // diagnostic when the same module class appears under both `\"default\"`\n      // and at least one explicit key (almost always user error).\n      const keysByClassInImports = new Map<Type, Set<string>>();\n\n      const allImports = [...metadata.imports, ...extraImports];\n\n      for (const entry of allImports) {\n        const importedModule = entry instanceof ForwardRef ? unwrapModuleForwardRef(entry) : entry;\n\n        const importedModuleClass = isDynamicModule(importedModule)\n          ? importedModule.module\n          : importedModule;\n        const importedKey = keyOfImport(importedModule);\n\n        let keys = keysByClassInImports.get(importedModuleClass);\n        if (!keys) {\n          keys = new Set();\n          keysByClassInImports.set(importedModuleClass, keys);\n        }\n        keys.add(importedKey);\n\n        const importedId = this.getModuleId(importedModuleClass, importedKey);\n        importedModuleIds.add(importedId);\n\n        const importedStackKey = `${importedModuleClass.name}#${importedKey}`;\n        if (entry instanceof ForwardRef && this.processingStack.has(importedStackKey)) {\n          continue;\n        }\n\n        const exportedTokens = this.processModule(importedModule);\n        for (const token of exportedTokens) {\n          importedProviders.add(token);\n        }\n      }\n\n      this.warnOnMixedDefaultAndKeyed(moduleClass.name, keysByClassInImports);\n\n      const allProviders = [...metadata.providers, ...extraProviders];\n      const allControllers = [...metadata.controllers, ...extraControllers];\n      const allExports = [...metadata.exports, ...extraExports];\n\n      // Build the ModuleScope BEFORE registering providers so the visibility\n      // check sees the local-provider set as we register.\n      const localProviders = new Set<Token>();\n      for (const provider of allProviders) {\n        const tk = tokenOfProvider(provider);\n        if (tk !== undefined) localProviders.add(tk);\n      }\n      for (const controller of allControllers) {\n        localProviders.add(controller);\n      }\n      // The module class itself can be DI-resolved (NestModule.configure path);\n      // include it in its own scope.\n      localProviders.add(moduleClass);\n\n      const isGlobal =\n        metadata.isGlobal ||\n        (isDynamicModule(moduleClassOrDynamic) && moduleClassOrDynamic.global === true);\n\n      const isLazy =\n        metadata.lazy ||\n        (isDynamicModule(moduleClassOrDynamic) && moduleClassOrDynamic.lazy === true);\n\n      this.container.registerScope({\n        moduleId,\n        localProviders,\n        importedModules: importedModuleIds,\n        exportedTokens: new Set<Token>(allExports),\n        isGlobal,\n        lazy: isLazy,\n      });\n\n      const lazyTokens: Token[] = [];\n      let hasEntrypointContributor = false;\n\n      for (const provider of allProviders) {\n        const registered = this.registerProvider(provider, moduleId);\n        if (isLazy && registered !== undefined) {\n          lazyTokens.push(registered);\n          hasEntrypointContributor ||= declaresEntrypointContributor(provider);\n        }\n      }\n\n      for (const controller of allControllers) {\n        // Register the controller in its owning module's bucket so its\n        // dependencies resolve from the module's POV (vs `__root__`'s).\n        this.container.register(controller, moduleId);\n        this.collectedControllers.add(controller);\n        if (isLazy) lazyTokens.push(controller);\n      }\n\n      if (isLazy) {\n        this.lazyModuleIds.add(moduleId);\n        this.lazyGroups.set(moduleId, {\n          moduleId,\n          tokens: lazyTokens,\n          hasEntrypointContributor,\n        });\n      }\n\n      // Propagate module-level Use* decorators (@UseGuards, @UseInterceptors, etc.) to each controller\n      for (const controller of allControllers) {\n        MetadataRegistry.propagateControllerComponents(moduleClass, controller);\n      }\n\n      this.markProcessed(moduleClass, key);\n\n      const exports = this.buildExportSet(allExports, allProviders, importedProviders);\n      this.cacheExports(moduleClass, key, exports);\n\n      if (isGlobal) {\n        for (const token of exports) {\n          this.globalExports.add(token);\n        }\n      }\n\n      // Call configure() if the module implements NestModule. The module is\n      // resolved through the container so it can have its own DI dependencies.\n      if (implementsNestModule(moduleClass)) {\n        if (!this.container.hasInScope(moduleClass, moduleId)) {\n          this.container.register(moduleClass, moduleId);\n        }\n        const instance = this.container.resolve(moduleClass, moduleId);\n        const builder = new MiddlewareBuilder();\n        instance.configure(builder);\n        this.consumerMiddlewareDefinitions.push(...builder.getDefinitions());\n      }\n\n      return exports;\n    } finally {\n      this.processingStack.delete(stackKey);\n    }\n  }\n\n  private warnOnMixedDefaultAndKeyed(\n    parentName: string,\n    keysByClass: Map<Type, Set<string>>,\n  ): void {\n    const mode = this.container.getDiagnostics();\n    if (mode === 'silent') return;\n    for (const [cls, keys] of keysByClass) {\n      if (keys.size < 2) continue;\n      if (!keys.has(DEFAULT_KEY)) continue;\n      const message =\n        `[vela] ${cls.name} imported in both bare and keyed form in '${parentName}'. ` +\n        `These resolve to distinct module instances; consumers asking for an exported ` +\n        `token will hit MultipleProvidersFoundError. Use one form consistently.`;\n      if (mode === 'throw') throw new Error(message);\n      console.warn(message);\n    }\n  }\n\n  /** Registers the provider and returns the token it was registered under. */\n  private registerProvider(provider: Type | ProviderOptions, moduleId: string): Token | undefined {\n    if (typeof provider === 'function') {\n      // Per-module bucket: the same class can be registered in multiple\n      // modules' buckets simultaneously without collision.\n      this.container.register(provider, moduleId);\n      this.registeredProviders.push(provider);\n      return provider;\n    }\n\n    const token = provider.provide;\n    if (!token) {\n      this.container.register(provider, moduleId);\n      return undefined;\n    }\n\n    if (this.isAppToken(token)) {\n      // Multiple APP_* providers within the same module bucket need\n      // distinct tokens so they don't overwrite each other in the bucket\n      // Map. Across buckets, `container.resolveAll(APP_GUARD)` walks\n      // every bucket — no need to mark synthetic tokens global.\n      const syntheticToken = new InjectionToken(`${token.toString()}:${this.appProviderCounter++}`);\n      this.container.register({ ...provider, provide: syntheticToken }, moduleId);\n      this.registeredProviders.push(syntheticToken);\n      getOrCreateArray(this.appProviderTokens, token).push(syntheticToken);\n      return syntheticToken;\n    }\n\n    this.container.register(provider, moduleId);\n    this.registeredProviders.push(token);\n    return token;\n  }\n\n  private isAppToken(token: Token): boolean {\n    return APP_TOKENS.has(token);\n  }\n\n  private buildExportSet(\n    exports: Array<Type | InjectionToken>,\n    providers: Array<Type | ProviderOptions>,\n    importedProviders: Set<Token>,\n  ): Set<Token> {\n    const exportSet = new Set<Token>();\n    const providerTokens = new Set<Token>();\n    for (const p of providers) {\n      const token = tokenOfProvider(p);\n      if (token !== undefined) providerTokens.add(token);\n    }\n\n    for (const exported of exports) {\n      const isLocalProvider = providerTokens.has(exported);\n      const isImportedProvider = importedProviders.has(exported);\n\n      if (!isLocalProvider && !isImportedProvider) {\n        const name = typeof exported === 'function' ? exported.name : String(exported);\n        console.warn(\n          `Warning: Exporting '${name}' which is neither a local provider nor imported from another module.`,\n        );\n      }\n\n      exportSet.add(exported);\n    }\n\n    return exportSet;\n  }\n\n  getControllers(): Type[] {\n    return [...this.collectedControllers];\n  }\n\n  getRegisteredProviders(): Token[] {\n    return [...this.registeredProviders];\n  }\n\n  getAppProviderTokens(token: Token): Token[] {\n    return [...(this.appProviderTokens.get(token) ?? [])];\n  }\n\n  getConsumerMiddlewareDefinitions(): MiddlewareRouteDefinition[] {\n    return [...this.consumerMiddlewareDefinitions];\n  }\n\n  /**\n   * Every lazy module instance recorded during load. Handed to the\n   * LazyModuleManager at bootstrap; empty when no module opted in.\n   */\n  getLazyGroups(): LazyModuleGroupSpec[] {\n    return [...this.lazyGroups.values()];\n  }\n\n  /**\n   * A token is deferred iff EVERY module bucket holding it belongs to a lazy\n   * module instance — a token also registered by a non-lazy module stays on\n   * the eager pass (and resolving it there claims the lazy sibling, which is\n   * the \"any use = init\" semantic, not a bug).\n   */\n  private isLazyOnlyToken(token: Token): boolean {\n    if (this.lazyModuleIds.size === 0) return false;\n    const owners = this.container.getOwnerModuleIds(token);\n    if (owners.length === 0) return false;\n    return owners.every((id) => this.lazyModuleIds.has(id));\n  }\n\n  async resolveAllInstances(): Promise<unknown[]> {\n    const instanceSet = new Set<unknown>();\n\n    for (const token of this.registeredProviders) {\n      try {\n        if (this.container.getProviderScope(token) === Scope.REQUEST) {\n          continue;\n        }\n        if (this.isLazyOnlyToken(token)) {\n          continue;\n        }\n        const instance = await this.container.resolveAsync(token);\n        instanceSet.add(instance);\n      } catch (err) {\n        if (err instanceof ModuleVisibilityError || err instanceof MultipleProvidersFoundError) {\n          throw err;\n        }\n        this.routeError(err, `resolve provider`);\n      }\n    }\n\n    for (const controller of this.collectedControllers) {\n      try {\n        if (this.container.getProviderScope(controller) === Scope.REQUEST) {\n          continue;\n        }\n        if (this.isLazyOnlyToken(controller)) {\n          continue;\n        }\n        const instance = await this.container.resolveAsync(controller);\n        instanceSet.add(instance);\n      } catch (err) {\n        if (err instanceof ModuleVisibilityError || err instanceof MultipleProvidersFoundError) {\n          throw err;\n        }\n        this.routeError(err, `resolve controller ${controller.name}`);\n      }\n    }\n\n    return [...instanceSet];\n  }\n\n  private routeError(err: unknown, context: string): void {\n    const mode = this.container.getDiagnostics();\n    if (mode === 'silent') return;\n    if (mode === 'throw') {\n      throw err instanceof Error ? err : new Error(String(err));\n    }\n    console.warn(`[vela] ${context} failed:`, err);\n  }\n}\n","import type { Container } from '../container/container';\nimport type { Token } from '../container/types';\nimport type { RouteManager } from '../http/route.manager';\nimport type { ModuleLoader } from '../module/module-loader';\nimport { APP_FILTER, APP_GUARD, APP_INTERCEPTOR, APP_MIDDLEWARE, APP_PIPE } from './tokens';\n\ntype Bind = (...tokens: Token[]) => RouteManager;\n\ninterface AppProviderSlot {\n  token: Token;\n  bind: (rm: RouteManager) => Bind;\n}\n\n// NestJS-style \"APP_*\" provider convention: each slot maps a well-known DI\n// token to the RouteManager method that installs providers under it as a\n// global component. Module-level @Provide(APP_*) entries expand into\n// synthetic tokens (collected by ModuleLoader); a single @Inject(APP_*)\n// provider falls back to the bare token.\nconst SLOTS: AppProviderSlot[] = [\n  { token: APP_GUARD, bind: (rm) => rm.useGlobalGuardTokens.bind(rm) },\n  { token: APP_PIPE, bind: (rm) => rm.useGlobalPipeTokens.bind(rm) },\n  { token: APP_INTERCEPTOR, bind: (rm) => rm.useGlobalInterceptorTokens.bind(rm) },\n  { token: APP_FILTER, bind: (rm) => rm.useGlobalFilterTokens.bind(rm) },\n  { token: APP_MIDDLEWARE, bind: (rm) => rm.useGlobalMiddlewareTokens.bind(rm) },\n];\n\n/**\n * Bind every APP_* provider registered in the container as a global\n * component on the RouteManager. The single source of truth for app-level\n * pipeline configuration — used by both VelaFactory.create and\n * @velajs/testing's TestingModuleBuilder.compile.\n */\nexport function bindAppProviders(\n  routeManager: RouteManager,\n  container: Container,\n  loader: ModuleLoader,\n): void {\n  for (const { token, bind } of SLOTS) {\n    const collected = loader.getAppProviderTokens(token);\n    if (collected.length > 0) {\n      bind(routeManager)(...collected);\n    } else if (container.has(token)) {\n      bind(routeManager)(token);\n    }\n  }\n}\n","import { Scope } from '../constants';\nimport { Container } from '../container/container';\nimport { ModuleRef } from '../container/module-ref';\nimport { DiscoveryService } from '../discovery/discovery.service';\nimport type { Diagnostics, Type } from '../container/types';\nimport { REQUEST_CONTEXT } from '../http/request-context';\nimport { RouteManager } from '../http/route.manager';\nimport type { RouteManagerOptions } from '../http/route.manager';\nimport { UrlGeneratorService } from '../http/url/url-generator.service';\nimport { SignedUrlGuard } from '../http/url/signed-url.guard';\nimport { ModuleLoader } from '../module/module-loader';\nimport { bindAppProviders } from '../pipeline/app-providers';\nimport { ComponentManager } from '../pipeline/component.manager';\nimport {\n  APP_EXCEPTION_HANDLER,\n  APP_FILTER,\n  APP_GUARD,\n  APP_INTERCEPTOR,\n  APP_MIDDLEWARE,\n  APP_PIPE,\n  ERROR_CATALOG,\n} from '../pipeline/tokens';\nimport type { NestMiddleware } from '../pipeline/types';\n\nexport interface BootstrapOptions extends RouteManagerOptions {\n  diagnostics?: Diagnostics;\n}\n\nexport interface BootstrapResult {\n  container: Container;\n  routeManager: RouteManager;\n  loader: ModuleLoader;\n}\n\n/**\n * Wire the DI graph for `rootModule` and prepare the route manager — without\n * running lifecycle hooks or building the Hono app. The single primitive\n * shared by `VelaFactory.create` (HTTP), `@velajs/testing` (test), and any\n * non-HTTP consumer (CLI tools, custom runtimes).\n *\n * Framework-internal tokens (`Container`, `ModuleRef`, `APP_*`) are marked\n * global so they are resolvable from any module.\n */\nexport async function bootstrap(\n  rootModule: Type,\n  options: BootstrapOptions = {},\n): Promise<BootstrapResult> {\n  const container = new Container({\n    diagnostics: options.diagnostics,\n  });\n\n  container.register({ provide: Container, useValue: container });\n  container.markGlobalToken(Container);\n\n  container.register({\n    provide: ModuleRef,\n    useFactory: (c: Container) => new ModuleRef(c),\n    inject: [Container],\n  });\n  container.markGlobalToken(ModuleRef);\n\n  // Decorator-driven discovery — global so any provider can inject it.\n  container.register({\n    provide: DiscoveryService,\n    useFactory: (c: Container) => new DiscoveryService(c),\n    inject: [Container],\n  });\n  container.markGlobalToken(DiscoveryService);\n\n  for (const t of [\n    APP_GUARD,\n    APP_PIPE,\n    APP_INTERCEPTOR,\n    APP_FILTER,\n    APP_MIDDLEWARE,\n    APP_EXCEPTION_HANDLER,\n    ERROR_CATALOG,\n  ]) {\n    container.markGlobalToken(t);\n  }\n\n  // REQUEST_CONTEXT is seeded into each request-scoped child by RouteManager\n  // before any handler resolves it (see route.manager.ts:getRequestContainer).\n  // The factory throws so misuse outside the request path surfaces immediately\n  // instead of materializing a phantom context.\n  container.register({\n    provide: REQUEST_CONTEXT,\n    scope: Scope.REQUEST,\n    useFactory: () => {\n      throw new Error(\n        'REQUEST_CONTEXT can only be resolved inside a request — ' +\n          'it is seeded by RouteManager when the request enters the pipeline.',\n      );\n    },\n  });\n  container.markGlobalToken(REQUEST_CONTEXT);\n\n  const routeManager = new RouteManager(container, options);\n  // Resolvable so non-HTTP transports (the WebSocket dispatcher) can read the\n  // same global-tier components (APP_* + app.useGlobalX()).\n  container.register({ provide: RouteManager, useValue: routeManager });\n  container.markGlobalToken(RouteManager);\n\n  // Named-route URL generation + signed-URL verification are app-level\n  // singletons: injectable from any module, and (for the guard) instantiable by\n  // the pipeline when a route opts in via `@SignedUrl()`. Both read their secret\n  // lazily and never force controllers/lazy modules to materialize.\n  container.register(UrlGeneratorService);\n  container.markGlobalToken(UrlGeneratorService);\n  container.register(SignedUrlGuard);\n  container.markGlobalToken(SignedUrlGuard);\n\n  const loader = new ModuleLoader(container, routeManager);\n  // loader.load() also arms the deferred-init seam (LazyModuleManager) — kept\n  // inside the loader so hand-rolled bootstrap paths that never call this\n  // function (@velajs/testing's TestingModuleBuilder.compile) get identical\n  // lazy semantics.\n  loader.load(rootModule);\n\n  bindAppProviders(routeManager, container, loader);\n  routeManager.registerConsumerMiddleware(loader.getConsumerMiddlewareDefinitions());\n\n  if (options.globalPrefix) {\n    routeManager.setGlobalPrefix(options.globalPrefix);\n  }\n\n  for (const handler of options.middleware ?? []) {\n    const mw: NestMiddleware = { use: handler };\n    routeManager.useGlobalMiddleware(mw);\n  }\n\n  // All providers are registered — compute request-scope bubbling so effective\n  // scopes are known before eager instantiation and request resolution.\n  container.computeEffectiveScopes();\n\n  return { container, routeManager, loader };\n}\n","import { InjectionToken } from '../container/types';\nimport type { Type } from '../container/types';\nimport { Module } from '../module/decorators';\nimport type { DynamicModule } from '../registry/types';\n\nexport interface Plugin {\n  id: string;\n  version: string;\n  module: Type | DynamicModule;\n  dependsOn?: string[];\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Freeze and validate a plugin manifest. Returns the same object so it can\n * be used in `composePlugins([definePlugin(...), ...])`.\n */\nexport function definePlugin(plugin: Plugin): Plugin {\n  if (!plugin.id) throw new Error('Plugin requires an id');\n  if (!plugin.version) throw new Error('Plugin requires a version');\n  if (!plugin.module) throw new Error('Plugin requires a module');\n  return Object.freeze({ ...plugin });\n}\n\nexport class PluginRegistry {\n  private byId: Map<string, Plugin>;\n\n  constructor(plugins: readonly Plugin[]) {\n    this.byId = new Map();\n    for (const p of plugins) {\n      if (this.byId.has(p.id)) {\n        throw new Error(`Duplicate plugin id: '${p.id}'`);\n      }\n      this.byId.set(p.id, p);\n    }\n  }\n\n  list(): Plugin[] {\n    return [...this.byId.values()];\n  }\n\n  get(id: string): Plugin | undefined {\n    return this.byId.get(id);\n  }\n\n  dependents(id: string): Plugin[] {\n    return this.list().filter((p) => p.dependsOn?.includes(id) ?? false);\n  }\n}\n\nexport const PLUGIN_REGISTRY_TOKEN = new InjectionToken<PluginRegistry>('PLUGIN_REGISTRY');\n\n@Module({})\nexport class PluginRootModule {}\n\n/**\n * Topologically sort plugins so each plugin's dependencies appear first.\n * Throws on missing dependencies and cycles.\n */\nfunction topologicalSort(plugins: readonly Plugin[]): Plugin[] {\n  const byId = new Map<string, Plugin>();\n  for (const p of plugins) {\n    if (byId.has(p.id)) {\n      throw new Error(`Duplicate plugin id: '${p.id}'`);\n    }\n    byId.set(p.id, p);\n  }\n\n  const result: Plugin[] = [];\n  const visiting = new Set<string>();\n  const visited = new Set<string>();\n\n  const visit = (p: Plugin, path: string[]): void => {\n    if (visited.has(p.id)) return;\n    if (visiting.has(p.id)) {\n      const cycle = [...path, p.id].join(' -> ');\n      throw new Error(`Plugin cycle detected: ${cycle}`);\n    }\n    visiting.add(p.id);\n    for (const depId of p.dependsOn ?? []) {\n      const dep = byId.get(depId);\n      if (!dep) {\n        throw new Error(`Plugin '${p.id}' depends on missing plugin '${depId}'`);\n      }\n      visit(dep, [...path, p.id]);\n    }\n    visiting.delete(p.id);\n    visited.add(p.id);\n    result.push(p);\n  };\n\n  for (const p of plugins) visit(p, []);\n  return result;\n}\n\n/**\n * Compose a list of plugins into a single dynamic module that imports each\n * plugin's module in dependency order, registers a `PluginRegistry`, and\n * exposes it globally so any plugin can introspect peers.\n */\nexport function composePlugins(plugins: readonly Plugin[]): DynamicModule {\n  const sorted = topologicalSort(plugins);\n  const registry = new PluginRegistry(sorted);\n\n  return {\n    module: PluginRootModule,\n    imports: sorted.map((p) => p.module),\n    providers: [{ provide: PLUGIN_REGISTRY_TOKEN, useValue: registry }],\n    exports: [PLUGIN_REGISTRY_TOKEN],\n    global: true,\n  };\n}\n"],"mappings":"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"}

package/dist/queue/index.d.ts

@@ -1,10 +1,247 @@
-export { QueueModule, QUEUE_MODULE_OPTIONS } from './queue.module';
-export { Processor, Process, getProcessHandlers } from './queue.decorators';
-export { queueToken, QUEUE_DRIVER, PROCESSOR_METADATA, PROCESS_METADATA } from './queue.tokens';
-export { QueueClient } from './queue.client';
-export { QueueDispatchBinding } from './queue.binding';
-export { dispatchQueueJob } from './queue.dispatch';
-export type { QueueDispatchResult, QueueEntry } from './queue.dispatch';
-export { inline } from './inline.driver';
-export type { InlineQueueDriver, InlineQueueOptions } from './inline.driver';
-export type { AddJobOptions, ProcessMetadata, ProcessorMetadata, QueueDispatchFn, QueueDriver, QueueDriverBindHooks, QueueJob, QueueModuleOptions, } from './queue.types';
+import { P as Container, U as InjectionToken, X as Token, i as DiscoveryService } from "../discovery.service-Cpf1QcZ5.js";
+import { q as EntrypointRegistry } from "../metadata.registry-D1od8ZBt.js";
+import { zt as ConfigurableModuleClassType } from "../index-DhShDLCM.js";
+//#region src/queue/queue.types.d.ts
+/**
+ * One job as handed to `@Process` handlers and drivers. Ids are minted by the
+ * client via `crypto.randomUUID()` (Web Crypto — edge-safe).
+ */
+interface QueueJob<T = unknown> {
+  id: string;
+  /** Queue the job was added to (`QueueModule.forRoot({ queues })` name). */
+  queue: string;
+  /** Job name — matched against `@Process(name)`; unnamed handlers catch the rest. */
+  name: string;
+  data: T;
+  /** Delivery attempt, 1-based. Platform drivers increment on retry. */
+  attempt: number;
+}
+interface AddJobOptions {
+  /**
+   * Requested delivery delay. Honored only by drivers that support it — the
+   * in-core `inline()` driver does not and warns once (log diagnostics).
+   */
+  delayMs?: number;
+}
+/** The function a driver calls to deliver one job into the app's processors. */
+type QueueDispatchFn = (job: QueueJob) => Promise<void>;
+interface QueueDriverBindHooks {
+  /**
+   * Where fire-and-forget delivery errors go (the inline driver's
+   * `immediate` mode has no awaiter to rethrow into). Wired to the
+   * container's diagnostics by `QueueDispatchBinding`.
+   */
+  onError?: (error: unknown, job: QueueJob) => void;
+}
+/**
+ * Producer/transport seam. `enqueue` accepts a job for later (or immediate)
+ * delivery; drivers that deliver in-process implement `bind` to receive the
+ * app's dispatch function. Platform packages (Cloudflare Queues, Redis, …)
+ * implement this interface out-of-core.
+ */
+interface QueueDriver {
+  readonly kind: string;
+  enqueue(job: QueueJob, options?: AddJobOptions): Promise<void>;
+  bind?(dispatch: QueueDispatchFn, hooks?: QueueDriverBindHooks): void;
+}
+interface QueueModuleOptions {
+  /**
+   * Queue names this instance provides clients for. STRUCTURAL — must be
+   * known at `forRoot`/`forRootAsync` call time (clients are options-derived
+   * providers); `forRootAsync` callers pass it alongside the factory.
+   */
+  queues?: string[];
+  /** Defaults to the in-core `inline()` driver. */
+  driver?: QueueDriver;
+}
+/** Class-level meta written by `@Processor(queueName)` (the 'queue' entrypoint kind). */
+interface ProcessorMetadata {
+  queueName: string;
+}
+/** Per-handler meta written by `@Process(jobName?)`. */
+interface ProcessMetadata {
+  jobName?: string;
+  methodName: string | symbol;
+}
+//#endregion
+//#region src/queue/queue.module.d.ts
+/**
+ * First-party queue module — authored 100% on vela's public API (the
+ * roadmap's "openness proof"). Producers inject a per-queue `QueueClient`
+ * via `queueToken(name)`; consumers are `@Processor`/`@Process` classes in
+ * ordinary user modules; platforms deliver through `dispatchQueueJob` or the
+ * in-core `inline()` driver.
+ *
+ * ```ts
+ * imports: [QueueModule.forRoot({ queues: ['email'] })]
+ * ```
+ *
+ * `lazy: true` (dogfoods 1.13): the module materializes when an eager
+ * producer injects a client (bootstrap — same structural reality that keeps
+ * WebSocketModule eager) or, in consumer-only workers, at the first
+ * delivered job.
+ *
+ * `queues` is STRUCTURAL: clients are options-derived providers, so
+ * `forRootAsync` callers pass it alongside the factory —
+ * `forRootAsync({ queues: ['email'], useFactory: () => ({ driver }) })`.
+ * Note that async options inherit the 1.13 lazy-module contract: the module
+ * must first materialize through an async seam (an eager producer's injection
+ * during the bootstrap sweep — the common case — or
+ * `app.materializeLazyModules()`); a synchronous first touch throws the
+ * descriptive sync-seam error.
+ */
+declare const ConfigurableModuleClass: ConfigurableModuleClassType<QueueModuleOptions, "forRoot", "create", {
+  isGlobal?: boolean;
+}>, MODULE_OPTIONS_TOKEN: InjectionToken<QueueModuleOptions>;
+declare class QueueModule extends ConfigurableModuleClass {}
+//#endregion
+//#region src/queue/queue.decorators.d.ts
+/**
+ * Marks a provider class as a processor for one queue:
+ *
+ * ```ts
+ * @Processor('email')
+ * @Injectable()
+ * class EmailProcessor {
+ *   @Process('welcome')
+ *   async sendWelcome(job: QueueJob<{ userId: string }>) { ... }
+ * }
+ * ```
+ */
+declare function Processor(queueName: string): ClassDecorator;
+/**
+ * Marks a processor method as the handler for a job name. Omit the name for
+ * the wildcard handler (receives every job on the queue that has no named
+ * handler). Named handlers win over the wildcard; a duplicate registration
+ * for the same name is first-wins with a diagnostics warning at dispatch.
+ */
+declare function Process(jobName?: string): MethodDecorator;
+/** `@Process` entries declared on a processor class (declaration order). */
+declare function getProcessHandlers(processorClass: object): ProcessMetadata[];
+//#endregion
+//#region src/queue/queue.client.d.ts
+/**
+ * Producer handle for one named queue — inject via `queueToken(name)`:
+ *
+ * ```ts
+ * constructor(@Inject(queueToken('email')) private readonly email: QueueClient) {}
+ * await this.email.add('welcome', { userId });
+ * ```
+ *
+ * `add()` resolves when the DRIVER accepted the job, not when a processor
+ * handled it (the inline driver's `immediate` mode delivers on a following
+ * microtask; platform drivers deliver in another isolate entirely).
+ */
+declare class QueueClient {
+  private readonly queue;
+  private readonly driver;
+  constructor(queue: string, driver: QueueDriver);
+  get name(): string;
+  add<T>(jobName: string, data: T, options?: AddJobOptions): Promise<QueueJob<T>>;
+}
+//#endregion
+//#region src/queue/queue.tokens.d.ts
+declare const PROCESSOR_METADATA = "vela:queue:processor";
+declare const PROCESS_METADATA = "vela:queue:process";
+/** The driver in effect for a `QueueModule` instance. */
+declare const QUEUE_DRIVER: InjectionToken<QueueDriver>;
+/**
+ * The injection token for a named queue's `QueueClient`:
+ *
+ * ```ts
+ * constructor(@Inject(queueToken('email')) private readonly email: QueueClient) {}
+ * ```
+ *
+ * Memoized per name (HMR-stable). Deliberately NO `InjectionToken` default
+ * factory: the container resolves default-factory tokens from the root bucket
+ * BEFORE walking module imports, which would break the exported-provider
+ * path — the token description (`vela:queue:client:<name>`) keeps the
+ * no-provider error readable instead.
+ */
+declare function queueToken(name: string): InjectionToken<QueueClient>;
+//#endregion
+//#region src/queue/queue.binding.d.ts
+/**
+ * Wires a `QueueModule` instance's driver to the app: binds in-process
+ * delivery to the dispatch core and validates that no other module instance
+ * provides the same queue names.
+ *
+ * Delivery resolves processors from the per-app `EntrypointRegistry` once it
+ * exists (registered into the container at the end of
+ * `callOnApplicationBootstrap`); deliveries that arrive earlier (a producer's
+ * `onModuleInit` calling `add()`) fall back to `DiscoveryService` with
+ * `deferLazy` — identical entries, no buffering, no lost jobs.
+ *
+ * Every `QueueClient` injects this binding, so the driver is always bound
+ * before the first `add()` — including when the module materializes lazily.
+ */
+declare class QueueDispatchBinding {
+  private readonly container;
+  private readonly discovery;
+  constructor(container: Container, discovery: DiscoveryService, driver: QueueDriver, queues: string[]);
+  private deliver;
+  private routeError;
+}
+//#endregion
+//#region src/queue/queue.dispatch.d.ts
+interface QueueDispatchResult {
+  /** Processors that ran a handler for this job. */
+  handled: number;
+}
+/** One dispatchable processor: its class token + `@Processor` meta. */
+interface QueueEntry {
+  token: Token;
+  meta: ProcessorMetadata;
+}
+/**
+ * Deliver one job to every `@Processor` of its queue — the primitive both the
+ * in-core `inline()` driver and platform adapters call.
+ *
+ * Each matching processor runs inside `runInEntrypointScope` (request-scoped
+ * dependencies rebuild per job) and is re-resolved BY TOKEN through the async
+ * seam, so processors living in `lazy: true` modules materialize cleanly on
+ * first dispatch — async providers and lifecycle hooks included. Scoped
+ * guards/interceptors/filters run through `PipelineRunner`
+ * (`getType() === 'queue'`, `getPayload()` is the job); app-wide `APP_*`
+ * components deliberately do NOT apply (cloudflare queue/scheduled parity —
+ * documented divergence from the WebSocket dispatcher).
+ *
+ * Errors no scoped filter claims RETHROW so awaiting platforms keep their
+ * retry semantics; fire-and-forget callers (inline `immediate` mode) must
+ * catch — `QueueDispatchBinding` routes those to diagnostics.
+ */
+declare function dispatchQueueJob(container: Container, entrypoints: EntrypointRegistry, job: QueueJob): Promise<QueueDispatchResult>;
+//#endregion
+//#region src/queue/inline.driver.d.ts
+interface InlineQueueOptions {
+  /**
+   * `immediate` (default): deliver on a microtask after `enqueue` resolves —
+   * `add()` resolving does NOT mean the job was handled. Handler errors are
+   * routed to the binding's error hook (container diagnostics), never thrown
+   * into the detached microtask.
+   *
+   * `manual`: buffer until `flush()` — deterministic delivery for tests.
+   */
+  mode?: 'immediate' | 'manual';
+}
+interface InlineQueueDriver extends QueueDriver {
+  /**
+   * Deliver everything buffered (manual mode; also drains jobs enqueued
+   * before the driver was bound). Resolves with the delivered count; rejects
+   * with an `AggregateError` after attempting ALL buffered jobs if any
+   * handler error went unclaimed — the awaiter exists here, so the
+   * platform-retry rethrow contract is meaningful.
+   */
+  flush(): Promise<number>;
+  /** Jobs currently buffered (unbound immediate + all manual). */
+  readonly size: number;
+}
+/**
+ * In-process driver for dev, tests, and single-isolate apps. Edge-pure: no
+ * timers — `immediate` mode uses `queueMicrotask`. `delayMs` is not
+ * supported (warns once through the bound error hook's diagnostics side).
+ */
+declare function inline(options?: InlineQueueOptions): InlineQueueDriver;
+//#endregion
+export { type AddJobOptions, type InlineQueueDriver, type InlineQueueOptions, PROCESSOR_METADATA, PROCESS_METADATA, Process, type ProcessMetadata, Processor, type ProcessorMetadata, QUEUE_DRIVER, MODULE_OPTIONS_TOKEN as QUEUE_MODULE_OPTIONS, QueueClient, QueueDispatchBinding, type QueueDispatchFn, type QueueDispatchResult, type QueueDriver, type QueueDriverBindHooks, type QueueEntry, type QueueJob, QueueModule, type QueueModuleOptions, dispatchQueueJob, getProcessHandlers, inline, queueToken };
+//# sourceMappingURL=index.d.ts.map