theokit 0.2.0 → 0.2.1

package/dist/dev-emit-3CHM73TV.js

@@ -0,0 +1,390 @@
+import {
+  generateManifest
+} from "./chunk-ERAZNHHR.js";
+import "./chunk-2BQYEBCK.js";
+import "./chunk-7DHGV77J.js";
+import "./chunk-X2VVCJ4V.js";
+import "./chunk-WSJKACWB.js";
+import "./chunk-DGUM43GV.js";
+
+// src/vite-plugin/openapi-emit/emit.ts
+import { mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+
+// src/vite-plugin/openapi-emit/zod-to-openapi.ts
+var ZodToOpenApiError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ZodToOpenApiError";
+  }
+};
+function zodToOpenApiSchema(schema, options = {}) {
+  const ctx = options.ctx ?? { seen: /* @__PURE__ */ new Map(), components: {} };
+  const name = options.name;
+  if (name !== void 0) {
+    if (Object.prototype.hasOwnProperty.call(ctx.components, name)) {
+      return { $ref: `#/components/schemas/${name}` };
+    }
+    ctx.seen.set(schema, name);
+    ctx.components[name] = {};
+    const body = convert(schema, ctx);
+    ctx.components[name] = body;
+    return { $ref: `#/components/schemas/${name}` };
+  }
+  return convert(schema, ctx);
+}
+function convert(schema, ctx) {
+  const existing = ctx.seen.get(schema);
+  if (existing !== void 0) {
+    return { $ref: `#/components/schemas/${existing}` };
+  }
+  const def = schema._def;
+  const typeName = def.typeName ?? "";
+  switch (typeName) {
+    case "ZodString":
+      return convertString(schema);
+    case "ZodNumber":
+      return convertNumber(schema);
+    case "ZodBoolean":
+      return { type: "boolean" };
+    case "ZodLiteral":
+      return convertLiteral(schema);
+    case "ZodEnum":
+      return convertEnum(schema);
+    case "ZodArray":
+      return convertArray(schema, ctx);
+    case "ZodObject":
+      return convertObject(schema, ctx);
+    case "ZodUnion":
+      return convertUnion(schema, ctx);
+    case "ZodDiscriminatedUnion":
+      return convertDiscriminatedUnion(schema, ctx);
+    case "ZodOptional":
+      return convert(schema._def.innerType, ctx);
+    case "ZodNullable": {
+      const inner = convert(
+        schema._def.innerType,
+        ctx
+      );
+      return { ...inner, nullable: true };
+    }
+    case "ZodEffects":
+    case "ZodTransform":
+      return convert(schema._def.schema, ctx);
+    case "ZodDefault":
+      return convert(schema._def.innerType, ctx);
+    case "ZodLazy": {
+      const getter = schema._def.getter;
+      return convert(getter(), ctx);
+    }
+    case "ZodRecord": {
+      const valueType = schema._def.valueType;
+      return { type: "object", additionalProperties: convert(valueType, ctx) };
+    }
+    case "ZodAny":
+    case "ZodUnknown":
+      return {};
+    // no constraint
+    case "ZodNull":
+      return { type: "null" };
+    case "ZodFunction":
+      throw new ZodToOpenApiError(
+        "Unsupported Zod type: z.function() cannot be represented in OpenAPI Schema. Remove from the route schema."
+      );
+    case "ZodPromise":
+      throw new ZodToOpenApiError(
+        "Unsupported Zod type: z.promise() cannot be represented in OpenAPI Schema. Unwrap the value before passing to defineRoute."
+      );
+    default:
+      throw new ZodToOpenApiError(
+        `Unsupported Zod type: ${typeName || "(unknown)"}. Open an issue if this construct should be supported.`
+      );
+  }
+}
+function convertString(schema) {
+  const def = schema._def;
+  const checks = def.checks ?? [];
+  const out = { type: "string" };
+  for (const c of checks) {
+    if (c.kind === "email") out.format = "email";
+    else if (c.kind === "uuid") out.format = "uuid";
+    else if (c.kind === "url") out.format = "uri";
+    else if (c.kind === "datetime") out.format = "date-time";
+  }
+  return out;
+}
+function convertNumber(schema) {
+  const def = schema._def;
+  const checks = def.checks ?? [];
+  const isInt = checks.some((c) => c.kind === "int");
+  return { type: isInt ? "integer" : "number" };
+}
+function convertLiteral(schema) {
+  const value = schema._def.value;
+  const typed = literalTypeOf(value);
+  if (typed === null) {
+    return { type: "null", enum: [null] };
+  }
+  return { type: typed, enum: [value] };
+}
+function literalTypeOf(value) {
+  if (value === null) return null;
+  if (typeof value === "string") return "string";
+  if (typeof value === "number") return Number.isInteger(value) ? "integer" : "number";
+  if (typeof value === "boolean") return "boolean";
+  return "string";
+}
+function convertEnum(schema) {
+  const values = schema._def.values;
+  return { type: "string", enum: [...values] };
+}
+function convertArray(schema, ctx) {
+  const inner = schema._def.type;
+  return { type: "array", items: convert(inner, ctx) };
+}
+function convertObject(schema, ctx) {
+  const shape = schema.shape;
+  const properties = {};
+  const required = [];
+  for (const [key, child] of Object.entries(shape)) {
+    properties[key] = convert(child, ctx);
+    const childDef = child._def;
+    const isOptional = childDef.typeName === "ZodOptional" || childDef.typeName === "ZodDefault";
+    if (!isOptional) required.push(key);
+  }
+  const out = {
+    type: "object",
+    properties,
+    additionalProperties: false
+  };
+  if (required.length > 0) out.required = required;
+  return out;
+}
+function convertUnion(schema, ctx) {
+  const options = schema._def.options;
+  return { oneOf: options.map((o) => convert(o, ctx)) };
+}
+function convertDiscriminatedUnion(schema, ctx) {
+  const def = schema._def;
+  return {
+    oneOf: def.options.map((o) => convert(o, ctx)),
+    discriminator: { propertyName: def.discriminator }
+  };
+}
+
+// src/vite-plugin/openapi-emit/emit.ts
+var METHOD_TO_KEY = {
+  GET: "get",
+  POST: "post",
+  PUT: "put",
+  PATCH: "patch",
+  DELETE: "delete",
+  HEAD: "head",
+  OPTIONS: "options"
+};
+function templatePath(routePath) {
+  return routePath.replace(/:([A-Za-z_]\w{0,64})\??/g, "{$1}");
+}
+function buildParameters(paramsSchema, querySchema, ctx) {
+  const out = [];
+  if (paramsSchema !== void 0) {
+    appendObjectAsParameters(paramsSchema, "path", out, ctx);
+  }
+  if (querySchema !== void 0) {
+    appendObjectAsParameters(querySchema, "query", out, ctx);
+  }
+  return out;
+}
+function appendObjectAsParameters(schema, location, out, ctx) {
+  const shape = schema.shape;
+  if (shape === void 0) return;
+  for (const [name, child] of Object.entries(shape)) {
+    const childDef = child._def;
+    const optional = childDef.typeName === "ZodOptional" || childDef.typeName === "ZodDefault";
+    out.push({
+      name,
+      in: location,
+      required: location === "path" ? true : !optional,
+      schema: zodToOpenApiSchema(child, { ctx })
+    });
+  }
+}
+function buildOperation(route, ctx, method) {
+  const sanitized = route.routePath.replace(/[/:\-{}]/g, "_").replace(/_+/g, "_");
+  const operationId = `${method.toLowerCase()}_${sanitized.replace(/^_|_$/g, "")}`;
+  const op = {
+    operationId,
+    responses: {
+      "200": { description: "OK" }
+    }
+  };
+  const parameters = buildParameters(route.params, route.query, ctx);
+  if (parameters.length > 0) op.parameters = parameters;
+  if (route.body !== void 0) {
+    op.requestBody = {
+      required: true,
+      content: {
+        "application/json": { schema: zodToOpenApiSchema(route.body, { ctx }) }
+      }
+    };
+  }
+  if (route.response !== void 0) {
+    op.responses["200"] = {
+      description: "OK",
+      content: {
+        "application/json": { schema: zodToOpenApiSchema(route.response, { ctx }) }
+      }
+    };
+  }
+  return op;
+}
+function emitOpenApi(input) {
+  const { manifest, config } = input;
+  const ctx = { seen: /* @__PURE__ */ new Map(), components: {} };
+  const paths = {};
+  for (const route of manifest) {
+    const templatedPath = templatePath(route.routePath);
+    const item = paths[templatedPath] ?? {};
+    for (const method of route.methods) {
+      const key = METHOD_TO_KEY[method.toUpperCase()];
+      if (key === void 0) continue;
+      item[key] = buildOperation(route, ctx, method);
+    }
+    paths[templatedPath] = item;
+  }
+  const servers = applyServerOverride(config.servers);
+  const document = {
+    openapi: config.specVersion,
+    info: { title: config.title, version: config.version },
+    servers,
+    paths
+  };
+  if (Object.keys(ctx.components).length > 0) {
+    document.components = { schemas: ctx.components };
+  }
+  mkdirSync(config.outDir, { recursive: true });
+  const outPath = join(config.outDir, "openapi.json");
+  writeFileSync(outPath, `${JSON.stringify(document, null, 2)}
+`, "utf8");
+  return { document, path: outPath };
+}
+function applyServerOverride(servers) {
+  const override = process.env.THEOKIT_OPENAPI_SERVER_URL;
+  if (override === void 0 || override === "") return servers;
+  if (servers.length === 0) return [{ url: override }];
+  const [first, ...rest] = servers;
+  return [
+    {
+      url: override,
+      ...first.description !== void 0 ? { description: first.description } : {}
+    },
+    ...rest
+  ];
+}
+
+// src/vite-plugin/openapi-emit/load-routes.ts
+import { resolve } from "path";
+var HTTP_METHOD_KEYS = ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
+async function loadRoutesForOpenApi(options) {
+  const { serverDir, routes } = options;
+  let loadModule = options.loadModule;
+  let dispose;
+  if (loadModule === void 0) {
+    const created = await createDefaultLoader(serverDir);
+    loadModule = created.load;
+    dispose = created.dispose;
+  }
+  const out = [];
+  try {
+    for (const r of routes) {
+      const abs = resolve(serverDir, r.filePath);
+      let mod;
+      try {
+        mod = await loadModule(abs);
+      } catch (err) {
+        console.warn(
+          `[openapi-emit] Skipping ${r.filePath}: load failed (${err.message})`
+        );
+        continue;
+      }
+      const methods = r.methods ?? HTTP_METHOD_KEYS.filter((m) => mod[m] !== void 0);
+      if (methods.length === 0) {
+        const def = mod.default;
+        if (def !== void 0 && def !== null) {
+          out.push({ routePath: r.routePath, methods: ["GET"], ...extractSchemas(def) });
+        }
+        continue;
+      }
+      for (const method of methods) {
+        const handler = mod[method] ?? mod.default;
+        if (handler === void 0 || handler === null) continue;
+        out.push({ routePath: r.routePath, methods: [method], ...extractSchemas(handler) });
+      }
+    }
+  } finally {
+    if (dispose !== void 0) {
+      await dispose();
+    }
+  }
+  return out;
+}
+function extractSchemas(handlerExport) {
+  if (typeof handlerExport !== "object" || handlerExport === null) return {};
+  const cfg = handlerExport;
+  const out = {};
+  if (cfg.body !== void 0) out.body = cfg.body;
+  if (cfg.query !== void 0) out.query = cfg.query;
+  if (cfg.params !== void 0) out.params = cfg.params;
+  if (cfg.response !== void 0) out.response = cfg.response;
+  return out;
+}
+async function createDefaultLoader(serverDir) {
+  const { createServer } = await import("vite");
+  const server = await createServer({
+    root: serverDir,
+    configFile: false,
+    server: { middlewareMode: true },
+    appType: "custom",
+    logLevel: "silent"
+  });
+  const swallow = () => {
+  };
+  return {
+    load: async (absPath) => server.ssrLoadModule(absPath),
+    dispose: async () => {
+      await server.close().catch(swallow);
+    }
+  };
+}
+
+// src/vite-plugin/openapi-emit/dev-emit.ts
+var inFlight = false;
+async function reEmitOpenApi(serverDir, distDir, openApiConfig) {
+  if (inFlight) {
+    console.warn(
+      "[openapi-emit] previous emit still running; skipping watcher event (EC-8 single-flight guard)"
+    );
+    return;
+  }
+  inFlight = true;
+  try {
+    const manifest = generateManifest(serverDir);
+    const hydrated = await loadRoutesForOpenApi({ serverDir, routes: manifest.routes });
+    emitOpenApi({
+      manifest: hydrated,
+      config: { ...openApiConfig, outDir: distDir }
+    });
+  } catch (err) {
+    console.warn(`[openapi-emit] re-emit failed: ${err.message}`);
+  } finally {
+    inFlight = false;
+  }
+}
+function _resetInFlightForTests() {
+  inFlight = false;
+}
+export {
+  _resetInFlightForTests,
+  reEmitOpenApi
+};
+//# sourceMappingURL=dev-emit-3CHM73TV.js.map

package/dist/dev-emit-3CHM73TV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite-plugin/openapi-emit/emit.ts","../src/vite-plugin/openapi-emit/zod-to-openapi.ts","../src/vite-plugin/openapi-emit/load-routes.ts","../src/vite-plugin/openapi-emit/dev-emit.ts"],"sourcesContent":["/**\n * In-house `emitOpenApi()` orchestrator (build-time only).\n *\n * Pure transformation: takes a route manifest (already hydrated with Zod\n * schemas extracted from `defineRoute()` config) + the openapi config\n * block, builds an OpenAPI 3.x document, writes `<outDir>/openapi.json`,\n * returns the document for downstream callers (CLI logs, tests).\n *\n * Per G2 plan v1.1 T2.1. Modelled on trpc-openapi's\n * `generateOpenApiDocument` + encore's `Generator.Generate()`.\n *\n * NEVER ship to runtime — devDep-shaped artifact.\n *\n * Path templating: TheoKit's `:param` syntax is converted to OpenAPI's\n * `{param}` per the spec. Env-var override: `THEOKIT_OPENAPI_SERVER_URL`\n * overrides `servers[0].url` without rebuilding the config.\n */\n/* eslint-disable security/detect-non-literal-fs-filename --\n * Build-time emit. outDir is a config-controlled relative path. The\n * caller already refused absolute paths via theoConfigSchema.distDir\n * pattern; the openapi.outDir field follows the same convention.\n */\nimport { mkdirSync, writeFileSync } from 'node:fs'\nimport { join } from 'node:path'\n\nimport type { z } from 'zod'\n\nimport { zodToOpenApiSchema, type ConvertCtx, type OpenApiSchema } from './zod-to-openapi.js'\n\nexport interface OpenApiManifestRoute {\n  /** TheoKit-style path with `:param` placeholders (`/users/:id`). */\n  routePath: string\n  /** Uppercase HTTP methods the route exports (`['GET','POST']`). */\n  methods: string[]\n  /** Optional `defineRoute({body})` schema. */\n  body?: z.ZodType\n  /** Optional `defineRoute({query})` schema. */\n  query?: z.ZodType\n  /** Optional `defineRoute({params})` schema. */\n  params?: z.ZodType\n  /** Optional `defineRoute({response})` schema. */\n  response?: z.ZodType\n}\n\nexport interface OpenApiEmitConfig {\n  servers: { url: string; description?: string }[]\n  specVersion: '3.1.0' | '3.0.3'\n  title: string\n  version: string\n  outDir: string\n}\n\nexport interface OpenApiOperation {\n  operationId?: string\n  parameters?: OpenApiParameter[]\n  requestBody?: {\n    required?: boolean\n    content: Record<string, { schema: OpenApiSchema }>\n  }\n  responses: Record<\n    string,\n    { description: string; content?: Record<string, { schema: OpenApiSchema }> }\n  >\n}\n\nexport interface OpenApiParameter {\n  name: string\n  in: 'path' | 'query' | 'header' | 'cookie'\n  required: boolean\n  schema: OpenApiSchema\n  description?: string\n}\n\nexport type OpenApiPathItem = Partial<\n  Record<'get' | 'post' | 'put' | 'patch' | 'delete' | 'head' | 'options', OpenApiOperation>\n>\n\nexport interface OpenApiDocument {\n  openapi: '3.1.0' | '3.0.3'\n  info: { title: string; version: string }\n  servers: { url: string; description?: string }[]\n  paths: Record<string, OpenApiPathItem>\n  components?: { schemas?: Record<string, OpenApiSchema> }\n}\n\nexport interface EmitOpenApiInput {\n  manifest: OpenApiManifestRoute[]\n  config: OpenApiEmitConfig\n}\n\nexport interface EmitOpenApiResult {\n  document: OpenApiDocument\n  path: string\n}\n\nconst METHOD_TO_KEY: Record<string, keyof OpenApiPathItem> = {\n  GET: 'get',\n  POST: 'post',\n  PUT: 'put',\n  PATCH: 'patch',\n  DELETE: 'delete',\n  HEAD: 'head',\n  OPTIONS: 'options',\n}\n\n/** Convert `/users/:id/posts/:postId?` → `/users/{id}/posts/{postId}`. */\nexport function templatePath(routePath: string): string {\n  // Bounded quantifier (\\w{0,64}) is OSS-safe — TheoKit route param names\n  // never exceed 64 chars in practice; cap prevents super-linear backtracking.\n  return routePath.replace(/:([A-Za-z_]\\w{0,64})\\??/g, '{$1}')\n}\n\nfunction buildParameters(\n  paramsSchema: z.ZodType | undefined,\n  querySchema: z.ZodType | undefined,\n  ctx: ConvertCtx,\n): OpenApiParameter[] {\n  const out: OpenApiParameter[] = []\n  if (paramsSchema !== undefined) {\n    appendObjectAsParameters(paramsSchema, 'path', out, ctx)\n  }\n  if (querySchema !== undefined) {\n    appendObjectAsParameters(querySchema, 'query', out, ctx)\n  }\n  return out\n}\n\nfunction appendObjectAsParameters(\n  schema: z.ZodType,\n  location: 'path' | 'query',\n  out: OpenApiParameter[],\n  ctx: ConvertCtx,\n): void {\n  // We expect an object schema; if it's not, skip silently (caller already\n  // validated upstream when scanning defineRoute()).\n  const shape = (schema as unknown as { shape?: Record<string, z.ZodType> }).shape\n  if (shape === undefined) return\n  for (const [name, child] of Object.entries(shape)) {\n    const childDef = (child as unknown as { _def: { typeName?: string } })._def\n    const optional = childDef.typeName === 'ZodOptional' || childDef.typeName === 'ZodDefault'\n    out.push({\n      name,\n      in: location,\n      required: location === 'path' ? true : !optional,\n      schema: zodToOpenApiSchema(child, { ctx }),\n    })\n  }\n}\n\nfunction buildOperation(\n  route: OpenApiManifestRoute,\n  ctx: ConvertCtx,\n  method: string,\n): OpenApiOperation {\n  // Bounded sanitizer: two single-pass replacements (no nested quantifiers).\n  const sanitized = route.routePath.replace(/[/:\\-{}]/g, '_').replace(/_+/g, '_')\n  const operationId = `${method.toLowerCase()}_${sanitized.replace(/^_|_$/g, '')}`\n  const op: OpenApiOperation = {\n    operationId,\n    responses: {\n      '200': { description: 'OK' },\n    },\n  }\n\n  const parameters = buildParameters(route.params, route.query, ctx)\n  if (parameters.length > 0) op.parameters = parameters\n\n  // Body only meaningful for write methods; we still attach if defined so\n  // the document is honest about the contract.\n  if (route.body !== undefined) {\n    op.requestBody = {\n      required: true,\n      content: {\n        'application/json': { schema: zodToOpenApiSchema(route.body, { ctx }) },\n      },\n    }\n  }\n\n  if (route.response !== undefined) {\n    op.responses['200'] = {\n      description: 'OK',\n      content: {\n        'application/json': { schema: zodToOpenApiSchema(route.response, { ctx }) },\n      },\n    }\n  }\n\n  return op\n}\n\nexport function emitOpenApi(input: EmitOpenApiInput): EmitOpenApiResult {\n  const { manifest, config } = input\n\n  const ctx: ConvertCtx = { seen: new Map(), components: {} }\n\n  const paths: Record<string, OpenApiPathItem> = {}\n  for (const route of manifest) {\n    const templatedPath = templatePath(route.routePath)\n    const item: OpenApiPathItem = paths[templatedPath] ?? {}\n    for (const method of route.methods) {\n      // Defensive: manifest emitter normalizes to uppercase, but if a\n      // future scanner produces a non-HTTP verb the key lookup yields\n      // undefined and we skip silently. TS narrows the indexed type to\n      // keyof OpenApiPathItem; the runtime undefined check is honest.\n      const key = METHOD_TO_KEY[method.toUpperCase()] as keyof OpenApiPathItem | undefined\n      if (key === undefined) continue\n      item[key] = buildOperation(route, ctx, method)\n    }\n    paths[templatedPath] = item\n  }\n\n  const servers = applyServerOverride(config.servers)\n\n  const document: OpenApiDocument = {\n    openapi: config.specVersion,\n    info: { title: config.title, version: config.version },\n    servers,\n    paths,\n  }\n\n  if (Object.keys(ctx.components).length > 0) {\n    document.components = { schemas: ctx.components }\n  }\n\n  mkdirSync(config.outDir, { recursive: true })\n  const outPath = join(config.outDir, 'openapi.json')\n  writeFileSync(outPath, `${JSON.stringify(document, null, 2)}\\n`, 'utf8')\n\n  return { document, path: outPath }\n}\n\nfunction applyServerOverride(\n  servers: { url: string; description?: string }[],\n): { url: string; description?: string }[] {\n  const override = process.env.THEOKIT_OPENAPI_SERVER_URL\n  if (override === undefined || override === '') return servers\n  if (servers.length === 0) return [{ url: override }]\n  const [first, ...rest] = servers\n  return [\n    {\n      url: override,\n      ...(first.description !== undefined ? { description: first.description } : {}),\n    },\n    ...rest,\n  ]\n}\n","/**\n * In-house Zod → OpenAPI 3.x Schema converter (build-time only).\n *\n * Per G2 plan v1.1 ADR D1 + EC-1: installed zod is 3.x (no native\n * `.toJSONSchema()`). This module is the PRIMARY conversion path.\n * Algorithm modelled on encore's `pkg/clientgen/openapi/schema.go`:\n * recursive descent + seen-map for cycle detection (named refs).\n *\n * Pure function: no I/O, no module loading. Caller extracts the Zod\n * schemas from `defineRoute({body, query, params})` and passes them\n * here. Returned `OpenApiSchema` is a structural subset of the OpenAPI\n * 3.0/3.1 Schema Object — fields populated as needed.\n *\n * NEVER ship to runtime — devDep-shaped artifact.\n *\n * Unsupported Zod constructs (z.function(), z.promise()) throw a\n * `ZodToOpenApiError` with a descriptive message so the caller can\n * surface the offending route + advise the user.\n */\nimport type { z } from 'zod'\n\nexport interface OpenApiSchema {\n  type?: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object' | 'null'\n  format?: string\n  items?: OpenApiSchema\n  properties?: Record<string, OpenApiSchema>\n  required?: string[]\n  additionalProperties?: boolean | OpenApiSchema\n  oneOf?: OpenApiSchema[]\n  anyOf?: OpenApiSchema[]\n  allOf?: OpenApiSchema[]\n  discriminator?: { propertyName: string; mapping?: Record<string, string> }\n  enum?: unknown[]\n  nullable?: boolean\n  description?: string\n  $ref?: string\n  // OpenAPI 3.1 (JSON Schema 2020-12) allows `type: [..., 'null']`; for now\n  // we stick with 3.0-compatible `nullable: true`. Caller can transform at\n  // emit time if specVersion === '3.1.0'.\n}\n\nexport interface ConvertCtx {\n  /** Seen-map: zod schema reference → component name (for $ref cycle detection). */\n  seen: Map<z.ZodType, string>\n  /** Output bucket for named component schemas. */\n  components: Record<string, OpenApiSchema>\n}\n\nexport interface ConvertOptions {\n  /**\n   * Optional context carried across recursive calls. Pass the SAME ctx to\n   * every `zodToOpenApiSchema` invocation in one emit pass so cycle\n   * detection works across multiple routes.\n   */\n  ctx?: ConvertCtx\n  /**\n   * If provided, the schema is registered under `components.schemas[name]`\n   * and the returned value is `{ $ref: '#/components/schemas/<name>' }`.\n   * Use this for top-level recursive types where the consumer (e.g.,\n   * OpenAPI document builder) wants named schemas instead of inlined ones.\n   */\n  name?: string\n}\n\nexport class ZodToOpenApiError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'ZodToOpenApiError'\n  }\n}\n\nexport function zodToOpenApiSchema(schema: z.ZodType, options: ConvertOptions = {}): OpenApiSchema {\n  const ctx: ConvertCtx = options.ctx ?? { seen: new Map(), components: {} }\n\n  const name = options.name\n  if (name !== undefined) {\n    // Top-level named schema — register placeholder BEFORE recursing, then\n    // patch the slot with the computed body. This avoids infinite recursion\n    // for self-referential types (encore schema.go:289 pattern).\n    if (Object.prototype.hasOwnProperty.call(ctx.components, name)) {\n      return { $ref: `#/components/schemas/${name}` }\n    }\n    ctx.seen.set(schema, name)\n    ctx.components[name] = {} // placeholder\n    const body = convert(schema, ctx)\n    ctx.components[name] = body\n    return { $ref: `#/components/schemas/${name}` }\n  }\n\n  return convert(schema, ctx)\n}\n\n// eslint-disable-next-line complexity -- switch-based dispatch on Zod typeName; splitting hides intent\nfunction convert(schema: z.ZodType, ctx: ConvertCtx): OpenApiSchema {\n  // Cycle: if we've seen this exact schema reference before, emit $ref.\n  const existing = ctx.seen.get(schema)\n  if (existing !== undefined) {\n    return { $ref: `#/components/schemas/${existing}` }\n  }\n\n  const def = (schema as unknown as { _def: { typeName?: string } })._def\n  const typeName = def.typeName ?? ''\n\n  switch (typeName) {\n    case 'ZodString':\n      return convertString(schema)\n    case 'ZodNumber':\n      return convertNumber(schema)\n    case 'ZodBoolean':\n      return { type: 'boolean' }\n    case 'ZodLiteral':\n      return convertLiteral(schema)\n    case 'ZodEnum':\n      return convertEnum(schema)\n    case 'ZodArray':\n      return convertArray(schema, ctx)\n    case 'ZodObject':\n      return convertObject(schema, ctx)\n    case 'ZodUnion':\n      return convertUnion(schema, ctx)\n    case 'ZodDiscriminatedUnion':\n      return convertDiscriminatedUnion(schema, ctx)\n    case 'ZodOptional':\n      // Optional-as-property is handled at object level; here we unwrap.\n      return convert((schema as unknown as { _def: { innerType: z.ZodType } })._def.innerType, ctx)\n    case 'ZodNullable': {\n      const inner = convert(\n        (schema as unknown as { _def: { innerType: z.ZodType } })._def.innerType,\n        ctx,\n      )\n      return { ...inner, nullable: true }\n    }\n    case 'ZodEffects':\n    case 'ZodTransform':\n      // Transforms change runtime output, but the WIRE shape is the input.\n      return convert((schema as unknown as { _def: { schema: z.ZodType } })._def.schema, ctx)\n    case 'ZodDefault':\n      return convert((schema as unknown as { _def: { innerType: z.ZodType } })._def.innerType, ctx)\n    case 'ZodLazy': {\n      const getter = (schema as unknown as { _def: { getter: () => z.ZodType } })._def.getter\n      return convert(getter(), ctx)\n    }\n    case 'ZodRecord': {\n      const valueType = (schema as unknown as { _def: { valueType: z.ZodType } })._def.valueType\n      return { type: 'object', additionalProperties: convert(valueType, ctx) }\n    }\n    case 'ZodAny':\n    case 'ZodUnknown':\n      return {} // no constraint\n    case 'ZodNull':\n      return { type: 'null' }\n    case 'ZodFunction':\n      throw new ZodToOpenApiError(\n        'Unsupported Zod type: z.function() cannot be represented in OpenAPI Schema. Remove from the route schema.',\n      )\n    case 'ZodPromise':\n      throw new ZodToOpenApiError(\n        'Unsupported Zod type: z.promise() cannot be represented in OpenAPI Schema. Unwrap the value before passing to defineRoute.',\n      )\n    default:\n      throw new ZodToOpenApiError(\n        `Unsupported Zod type: ${typeName || '(unknown)'}. Open an issue if this construct should be supported.`,\n      )\n  }\n}\n\ninterface StringCheck {\n  kind: string\n}\n\nfunction convertString(schema: z.ZodType): OpenApiSchema {\n  const def = (schema as unknown as { _def: { checks?: StringCheck[] } })._def\n  const checks = def.checks ?? []\n  const out: OpenApiSchema = { type: 'string' }\n  for (const c of checks) {\n    if (c.kind === 'email') out.format = 'email'\n    else if (c.kind === 'uuid') out.format = 'uuid'\n    else if (c.kind === 'url') out.format = 'uri'\n    else if (c.kind === 'datetime') out.format = 'date-time'\n  }\n  return out\n}\n\ninterface NumberCheck {\n  kind: string\n}\n\nfunction convertNumber(schema: z.ZodType): OpenApiSchema {\n  const def = (schema as unknown as { _def: { checks?: NumberCheck[] } })._def\n  const checks = def.checks ?? []\n  const isInt = checks.some((c) => c.kind === 'int')\n  return { type: isInt ? 'integer' : 'number' }\n}\n\nfunction convertLiteral(schema: z.ZodType): OpenApiSchema {\n  const value = (schema as unknown as { _def: { value: unknown } })._def.value\n  const typed = literalTypeOf(value)\n  if (typed === null) {\n    // Null literal\n    return { type: 'null', enum: [null] }\n  }\n  return { type: typed, enum: [value] }\n}\n\nfunction literalTypeOf(value: unknown): OpenApiSchema['type'] | null {\n  if (value === null) return null\n  if (typeof value === 'string') return 'string'\n  if (typeof value === 'number') return Number.isInteger(value) ? 'integer' : 'number'\n  if (typeof value === 'boolean') return 'boolean'\n  return 'string' // fallback for symbol/etc.\n}\n\nfunction convertEnum(schema: z.ZodType): OpenApiSchema {\n  const values = (schema as unknown as { _def: { values: readonly string[] } })._def.values\n  return { type: 'string', enum: [...values] }\n}\n\nfunction convertArray(schema: z.ZodType, ctx: ConvertCtx): OpenApiSchema {\n  const inner = (schema as unknown as { _def: { type: z.ZodType } })._def.type\n  return { type: 'array', items: convert(inner, ctx) }\n}\n\nfunction convertObject(schema: z.ZodType, ctx: ConvertCtx): OpenApiSchema {\n  const shape = (schema as unknown as { shape: Record<string, z.ZodType> }).shape\n  const properties: Record<string, OpenApiSchema> = {}\n  const required: string[] = []\n  for (const [key, child] of Object.entries(shape)) {\n    properties[key] = convert(child, ctx)\n    const childDef = (child as unknown as { _def: { typeName?: string } })._def\n    const isOptional = childDef.typeName === 'ZodOptional' || childDef.typeName === 'ZodDefault'\n    if (!isOptional) required.push(key)\n  }\n  const out: OpenApiSchema = {\n    type: 'object',\n    properties,\n    additionalProperties: false,\n  }\n  if (required.length > 0) out.required = required\n  return out\n}\n\nfunction convertUnion(schema: z.ZodType, ctx: ConvertCtx): OpenApiSchema {\n  const options = (schema as unknown as { _def: { options: z.ZodType[] } })._def.options\n  return { oneOf: options.map((o) => convert(o, ctx)) }\n}\n\nfunction convertDiscriminatedUnion(schema: z.ZodType, ctx: ConvertCtx): OpenApiSchema {\n  const def = (\n    schema as unknown as {\n      _def: { discriminator: string; options: z.ZodType[] }\n    }\n  )._def\n  return {\n    oneOf: def.options.map((o) => convert(o, ctx)),\n    discriminator: { propertyName: def.discriminator },\n  }\n}\n","/**\n * Build-time route loader for OpenAPI emit.\n *\n * Takes the G1 manifest (filePath + routePath + methods) and hydrates each\n * route's Zod schemas by dynamically importing the module. `defineRoute`\n * is an identity function, so the imported config exposes `body/query/\n * params/response` directly without any AST gymnastics.\n *\n * Supports both export shapes:\n *   1. `export const POST = defineRoute({...})` (per-method named exports)\n *   2. `export default defineRoute({...})` (single-export legacy shape)\n *\n * Per G2 plan v1.1 T2.2. Uses Vite's `ssrLoadModule` because route files\n * are TS at build time — Node's native loader doesn't transpile.\n */\nimport { resolve } from 'node:path'\n\nimport type { z } from 'zod'\n\nimport type { ManifestRoute } from '../../server/scan/manifest.js'\n\nimport type { OpenApiManifestRoute } from './emit.js'\n\ninterface RouteConfigShape {\n  body?: z.ZodType\n  query?: z.ZodType\n  params?: z.ZodType\n  response?: z.ZodType\n}\n\ninterface ViteLikeServer {\n  ssrLoadModule: (id: string) => Promise<Record<string, unknown>>\n  close: () => Promise<void>\n}\n\ninterface DefaultLoader {\n  load: (absPath: string) => Promise<Record<string, unknown>>\n  dispose: () => Promise<void>\n}\n\n/** Method names recognized as per-route named exports (UPPERCASE). */\nconst HTTP_METHOD_KEYS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'] as const\n\nexport interface LoadRoutesOptions {\n  serverDir: string\n  routes: ManifestRoute[]\n  /** Injectable for tests; defaults to a fresh Vite SSR dev server. */\n  loadModule?: (absPath: string) => Promise<Record<string, unknown>>\n}\n\n/**\n * Hydrate manifest routes with Zod schemas extracted from their modules.\n *\n * Returns one `OpenApiManifestRoute` per (file × method) tuple. If a route\n * file declares multiple methods (`GET` + `POST`), each method gets its\n * own entry with the schemas from that method's `defineRoute()` call.\n *\n * Routes that fail to load are skipped with a console warning — the emit\n * should be best-effort, not a hard build failure.\n *\n * The default Vite loader is created once per call and disposed in the\n * `finally` block so the underlying server is released even when route\n * loading throws.\n */\nexport async function loadRoutesForOpenApi(\n  options: LoadRoutesOptions,\n): Promise<OpenApiManifestRoute[]> {\n  const { serverDir, routes } = options\n  let loadModule = options.loadModule\n  let dispose: (() => Promise<void>) | undefined\n  if (loadModule === undefined) {\n    const created = await createDefaultLoader(serverDir)\n    loadModule = created.load\n    dispose = created.dispose\n  }\n\n  const out: OpenApiManifestRoute[] = []\n  try {\n    for (const r of routes) {\n      const abs = resolve(serverDir, r.filePath)\n      let mod: Record<string, unknown>\n      try {\n        mod = await loadModule(abs)\n      } catch (err) {\n        console.warn(\n          `[openapi-emit] Skipping ${r.filePath}: load failed (${(err as Error).message})`,\n        )\n        continue\n      }\n\n      const methods = r.methods ?? HTTP_METHOD_KEYS.filter((m) => mod[m] !== undefined)\n      if (methods.length === 0) {\n        // Fall back to default export when no method-named exports detected.\n        const def = mod.default\n        if (def !== undefined && def !== null) {\n          out.push({ routePath: r.routePath, methods: ['GET'], ...extractSchemas(def) })\n        }\n        continue\n      }\n\n      for (const method of methods) {\n        const handler = mod[method] ?? mod.default\n        if (handler === undefined || handler === null) continue\n        out.push({ routePath: r.routePath, methods: [method], ...extractSchemas(handler) })\n      }\n    }\n  } finally {\n    if (dispose !== undefined) {\n      await dispose()\n    }\n  }\n  return out\n}\n\nfunction extractSchemas(handlerExport: unknown): RouteConfigShape {\n  if (typeof handlerExport !== 'object' || handlerExport === null) return {}\n  const cfg = handlerExport as RouteConfigShape\n  const out: RouteConfigShape = {}\n  if (cfg.body !== undefined) out.body = cfg.body\n  if (cfg.query !== undefined) out.query = cfg.query\n  if (cfg.params !== undefined) out.params = cfg.params\n  if (cfg.response !== undefined) out.response = cfg.response\n  return out\n}\n\n/**\n * Default loader: spin up a minimal Vite SSR dev server (no HMR, no\n * middlewares) just to use its `ssrLoadModule`. Vite handles TS, ESM, and\n * import resolution for free.\n *\n * Returns `{load, dispose}` — the caller owns the lifecycle and MUST\n * call `dispose()` (typically in a `finally`) so the server is closed.\n */\nasync function createDefaultLoader(serverDir: string): Promise<DefaultLoader> {\n  // Vite is a peerDep in build flows; import dynamically.\n  const { createServer } = await import('vite')\n  const server = (await createServer({\n    root: serverDir,\n    configFile: false,\n    server: { middlewareMode: true },\n    appType: 'custom',\n    logLevel: 'silent',\n  })) as unknown as ViteLikeServer\n\n  const swallow = (): void => {\n    /* eat close errors — best-effort cleanup */\n  }\n  return {\n    load: async (absPath) => server.ssrLoadModule(absPath),\n    dispose: async () => {\n      await server.close().catch(swallow)\n    },\n  }\n}\n","/**\n * Dev-mode OpenAPI emit helper for `theokit dev`.\n *\n * Per P#3 plan v1.3 T1.1 (ADRs D3 + D4 + EC-8). Called once on `theokit dev`\n * boot AND on every chokidar 'change'/'add'/'unlink' watcher event for\n * route files when `config.openapi !== undefined`. Re-runs G2's\n * `emitOpenApi()` orchestrator to keep `<distDir>/openapi.json` always\n * fresh in dev.\n *\n * EC-8 absorbed (single-flight guard): if a previous invocation is still\n * awaiting `loadRoutesForOpenApi` (Vite SSR loader can hang on circular\n * imports or syntax errors), skip the new call and emit a `console.warn`\n * so watcher events don't pile up + dev server doesn't deadlock.\n *\n * Best-effort: ALL errors caught + warned. Never throws out of the\n * exported function (would crash Vite dev's chokidar handler).\n *\n * NEVER ship to runtime — dev-only artifact gated on `config.openapi`.\n */\nimport { generateManifest } from '../../server/scan/manifest.js'\n\nimport { emitOpenApi } from './emit.js'\nimport { loadRoutesForOpenApi } from './load-routes.js'\n\ninterface DevEmitConfig {\n  servers: { url: string; description?: string }[]\n  specVersion: '3.1.0' | '3.0.3'\n  title: string\n  version: string\n}\n\nlet inFlight = false\n\nexport async function reEmitOpenApi(\n  serverDir: string,\n  distDir: string,\n  openApiConfig: DevEmitConfig,\n): Promise<void> {\n  if (inFlight) {\n    console.warn(\n      '[openapi-emit] previous emit still running; skipping watcher event (EC-8 single-flight guard)',\n    )\n    return\n  }\n  inFlight = true\n  try {\n    const manifest = generateManifest(serverDir)\n    const hydrated = await loadRoutesForOpenApi({ serverDir, routes: manifest.routes })\n    emitOpenApi({\n      manifest: hydrated,\n      config: { ...openApiConfig, outDir: distDir },\n    })\n  } catch (err) {\n    console.warn(`[openapi-emit] re-emit failed: ${(err as Error).message}`)\n  } finally {\n    inFlight = false\n  }\n}\n\n/** Test seam — resets the inFlight flag between tests. NOT for production use. */\nexport function _resetInFlightForTests(): void {\n  inFlight = false\n}\n"],"mappings":";;;;;;;;;;AAsBA,SAAS,WAAW,qBAAqB;AACzC,SAAS,YAAY;;;ACyCd,IAAM,oBAAN,cAAgC,MAAM;AAAA,EAC3C,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEO,SAAS,mBAAmB,QAAmB,UAA0B,CAAC,GAAkB;AACjG,QAAM,MAAkB,QAAQ,OAAO,EAAE,MAAM,oBAAI,IAAI,GAAG,YAAY,CAAC,EAAE;AAEzE,QAAM,OAAO,QAAQ;AACrB,MAAI,SAAS,QAAW;AAItB,QAAI,OAAO,UAAU,eAAe,KAAK,IAAI,YAAY,IAAI,GAAG;AAC9D,aAAO,EAAE,MAAM,wBAAwB,IAAI,GAAG;AAAA,IAChD;AACA,QAAI,KAAK,IAAI,QAAQ,IAAI;AACzB,QAAI,WAAW,IAAI,IAAI,CAAC;AACxB,UAAM,OAAO,QAAQ,QAAQ,GAAG;AAChC,QAAI,WAAW,IAAI,IAAI;AACvB,WAAO,EAAE,MAAM,wBAAwB,IAAI,GAAG;AAAA,EAChD;AAEA,SAAO,QAAQ,QAAQ,GAAG;AAC5B;AAGA,SAAS,QAAQ,QAAmB,KAAgC;AAElE,QAAM,WAAW,IAAI,KAAK,IAAI,MAAM;AACpC,MAAI,aAAa,QAAW;AAC1B,WAAO,EAAE,MAAM,wBAAwB,QAAQ,GAAG;AAAA,EACpD;AAEA,QAAM,MAAO,OAAsD;AACnE,QAAM,WAAW,IAAI,YAAY;AAEjC,UAAQ,UAAU;AAAA,IAChB,KAAK;AACH,aAAO,cAAc,MAAM;AAAA,IAC7B,KAAK;AACH,aAAO,cAAc,MAAM;AAAA,IAC7B,KAAK;AACH,aAAO,EAAE,MAAM,UAAU;AAAA,IAC3B,KAAK;AACH,aAAO,eAAe,MAAM;AAAA,IAC9B,KAAK;AACH,aAAO,YAAY,MAAM;AAAA,IAC3B,KAAK;AACH,aAAO,aAAa,QAAQ,GAAG;AAAA,IACjC,KAAK;AACH,aAAO,cAAc,QAAQ,GAAG;AAAA,IAClC,KAAK;AACH,aAAO,aAAa,QAAQ,GAAG;AAAA,IACjC,KAAK;AACH,aAAO,0BAA0B,QAAQ,GAAG;AAAA,IAC9C,KAAK;AAEH,aAAO,QAAS,OAAyD,KAAK,WAAW,GAAG;AAAA,IAC9F,KAAK,eAAe;AAClB,YAAM,QAAQ;AAAA,QACX,OAAyD,KAAK;AAAA,QAC/D;AAAA,MACF;AACA,aAAO,EAAE,GAAG,OAAO,UAAU,KAAK;AAAA,IACpC;AAAA,IACA,KAAK;AAAA,IACL,KAAK;AAEH,aAAO,QAAS,OAAsD,KAAK,QAAQ,GAAG;AAAA,IACxF,KAAK;AACH,aAAO,QAAS,OAAyD,KAAK,WAAW,GAAG;AAAA,IAC9F,KAAK,WAAW;AACd,YAAM,SAAU,OAA4D,KAAK;AACjF,aAAO,QAAQ,OAAO,GAAG,GAAG;AAAA,IAC9B;AAAA,IACA,KAAK,aAAa;AAChB,YAAM,YAAa,OAAyD,KAAK;AACjF,aAAO,EAAE,MAAM,UAAU,sBAAsB,QAAQ,WAAW,GAAG,EAAE;AAAA,IACzE;AAAA,IACA,KAAK;AAAA,IACL,KAAK;AACH,aAAO,CAAC;AAAA;AAAA,IACV,KAAK;AACH,aAAO,EAAE,MAAM,OAAO;AAAA,IACxB,KAAK;AACH,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF,KAAK;AACH,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACE,YAAM,IAAI;AAAA,QACR,yBAAyB,YAAY,WAAW;AAAA,MAClD;AAAA,EACJ;AACF;AAMA,SAAS,cAAc,QAAkC;AACvD,QAAM,MAAO,OAA2D;AACxE,QAAM,SAAS,IAAI,UAAU,CAAC;AAC9B,QAAM,MAAqB,EAAE,MAAM,SAAS;AAC5C,aAAW,KAAK,QAAQ;AACtB,QAAI,EAAE,SAAS,QAAS,KAAI,SAAS;AAAA,aAC5B,EAAE,SAAS,OAAQ,KAAI,SAAS;AAAA,aAChC,EAAE,SAAS,MAAO,KAAI,SAAS;AAAA,aAC/B,EAAE,SAAS,WAAY,KAAI,SAAS;AAAA,EAC/C;AACA,SAAO;AACT;AAMA,SAAS,cAAc,QAAkC;AACvD,QAAM,MAAO,OAA2D;AACxE,QAAM,SAAS,IAAI,UAAU,CAAC;AAC9B,QAAM,QAAQ,OAAO,KAAK,CAAC,MAAM,EAAE,SAAS,KAAK;AACjD,SAAO,EAAE,MAAM,QAAQ,YAAY,SAAS;AAC9C;AAEA,SAAS,eAAe,QAAkC;AACxD,QAAM,QAAS,OAAmD,KAAK;AACvE,QAAM,QAAQ,cAAc,KAAK;AACjC,MAAI,UAAU,MAAM;AAElB,WAAO,EAAE,MAAM,QAAQ,MAAM,CAAC,IAAI,EAAE;AAAA,EACtC;AACA,SAAO,EAAE,MAAM,OAAO,MAAM,CAAC,KAAK,EAAE;AACtC;AAEA,SAAS,cAAc,OAA8C;AACnE,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI,OAAO,UAAU,SAAU,QAAO,OAAO,UAAU,KAAK,IAAI,YAAY;AAC5E,MAAI,OAAO,UAAU,UAAW,QAAO;AACvC,SAAO;AACT;AAEA,SAAS,YAAY,QAAkC;AACrD,QAAM,SAAU,OAA8D,KAAK;AACnF,SAAO,EAAE,MAAM,UAAU,MAAM,CAAC,GAAG,MAAM,EAAE;AAC7C;AAEA,SAAS,aAAa,QAAmB,KAAgC;AACvE,QAAM,QAAS,OAAoD,KAAK;AACxE,SAAO,EAAE,MAAM,SAAS,OAAO,QAAQ,OAAO,GAAG,EAAE;AACrD;AAEA,SAAS,cAAc,QAAmB,KAAgC;AACxE,QAAM,QAAS,OAA2D;AAC1E,QAAM,aAA4C,CAAC;AACnD,QAAM,WAAqB,CAAC;AAC5B,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,eAAW,GAAG,IAAI,QAAQ,OAAO,GAAG;AACpC,UAAM,WAAY,MAAqD;AACvE,UAAM,aAAa,SAAS,aAAa,iBAAiB,SAAS,aAAa;AAChF,QAAI,CAAC,WAAY,UAAS,KAAK,GAAG;AAAA,EACpC;AACA,QAAM,MAAqB;AAAA,IACzB,MAAM;AAAA,IACN;AAAA,IACA,sBAAsB;AAAA,EACxB;AACA,MAAI,SAAS,SAAS,EAAG,KAAI,WAAW;AACxC,SAAO;AACT;AAEA,SAAS,aAAa,QAAmB,KAAgC;AACvE,QAAM,UAAW,OAAyD,KAAK;AAC/E,SAAO,EAAE,OAAO,QAAQ,IAAI,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC,EAAE;AACtD;AAEA,SAAS,0BAA0B,QAAmB,KAAgC;AACpF,QAAM,MACJ,OAGA;AACF,SAAO;AAAA,IACL,OAAO,IAAI,QAAQ,IAAI,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAC;AAAA,IAC7C,eAAe,EAAE,cAAc,IAAI,cAAc;AAAA,EACnD;AACF;;;ADjKA,IAAM,gBAAuD;AAAA,EAC3D,KAAK;AAAA,EACL,MAAM;AAAA,EACN,KAAK;AAAA,EACL,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,SAAS;AACX;AAGO,SAAS,aAAa,WAA2B;AAGtD,SAAO,UAAU,QAAQ,4BAA4B,MAAM;AAC7D;AAEA,SAAS,gBACP,cACA,aACA,KACoB;AACpB,QAAM,MAA0B,CAAC;AACjC,MAAI,iBAAiB,QAAW;AAC9B,6BAAyB,cAAc,QAAQ,KAAK,GAAG;AAAA,EACzD;AACA,MAAI,gBAAgB,QAAW;AAC7B,6BAAyB,aAAa,SAAS,KAAK,GAAG;AAAA,EACzD;AACA,SAAO;AACT;AAEA,SAAS,yBACP,QACA,UACA,KACA,KACM;AAGN,QAAM,QAAS,OAA4D;AAC3E,MAAI,UAAU,OAAW;AACzB,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AACjD,UAAM,WAAY,MAAqD;AACvE,UAAM,WAAW,SAAS,aAAa,iBAAiB,SAAS,aAAa;AAC9E,QAAI,KAAK;AAAA,MACP;AAAA,MACA,IAAI;AAAA,MACJ,UAAU,aAAa,SAAS,OAAO,CAAC;AAAA,MACxC,QAAQ,mBAAmB,OAAO,EAAE,IAAI,CAAC;AAAA,IAC3C,CAAC;AAAA,EACH;AACF;AAEA,SAAS,eACP,OACA,KACA,QACkB;AAElB,QAAM,YAAY,MAAM,UAAU,QAAQ,aAAa,GAAG,EAAE,QAAQ,OAAO,GAAG;AAC9E,QAAM,cAAc,GAAG,OAAO,YAAY,CAAC,IAAI,UAAU,QAAQ,UAAU,EAAE,CAAC;AAC9E,QAAM,KAAuB;AAAA,IAC3B;AAAA,IACA,WAAW;AAAA,MACT,OAAO,EAAE,aAAa,KAAK;AAAA,IAC7B;AAAA,EACF;AAEA,QAAM,aAAa,gBAAgB,MAAM,QAAQ,MAAM,OAAO,GAAG;AACjE,MAAI,WAAW,SAAS,EAAG,IAAG,aAAa;AAI3C,MAAI,MAAM,SAAS,QAAW;AAC5B,OAAG,cAAc;AAAA,MACf,UAAU;AAAA,MACV,SAAS;AAAA,QACP,oBAAoB,EAAE,QAAQ,mBAAmB,MAAM,MAAM,EAAE,IAAI,CAAC,EAAE;AAAA,MACxE;AAAA,IACF;AAAA,EACF;AAEA,MAAI,MAAM,aAAa,QAAW;AAChC,OAAG,UAAU,KAAK,IAAI;AAAA,MACpB,aAAa;AAAA,MACb,SAAS;AAAA,QACP,oBAAoB,EAAE,QAAQ,mBAAmB,MAAM,UAAU,EAAE,IAAI,CAAC,EAAE;AAAA,MAC5E;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAEO,SAAS,YAAY,OAA4C;AACtE,QAAM,EAAE,UAAU,OAAO,IAAI;AAE7B,QAAM,MAAkB,EAAE,MAAM,oBAAI,IAAI,GAAG,YAAY,CAAC,EAAE;AAE1D,QAAM,QAAyC,CAAC;AAChD,aAAW,SAAS,UAAU;AAC5B,UAAM,gBAAgB,aAAa,MAAM,SAAS;AAClD,UAAM,OAAwB,MAAM,aAAa,KAAK,CAAC;AACvD,eAAW,UAAU,MAAM,SAAS;AAKlC,YAAM,MAAM,cAAc,OAAO,YAAY,CAAC;AAC9C,UAAI,QAAQ,OAAW;AACvB,WAAK,GAAG,IAAI,eAAe,OAAO,KAAK,MAAM;AAAA,IAC/C;AACA,UAAM,aAAa,IAAI;AAAA,EACzB;AAEA,QAAM,UAAU,oBAAoB,OAAO,OAAO;AAElD,QAAM,WAA4B;AAAA,IAChC,SAAS,OAAO;AAAA,IAChB,MAAM,EAAE,OAAO,OAAO,OAAO,SAAS,OAAO,QAAQ;AAAA,IACrD;AAAA,IACA;AAAA,EACF;AAEA,MAAI,OAAO,KAAK,IAAI,UAAU,EAAE,SAAS,GAAG;AAC1C,aAAS,aAAa,EAAE,SAAS,IAAI,WAAW;AAAA,EAClD;AAEA,YAAU,OAAO,QAAQ,EAAE,WAAW,KAAK,CAAC;AAC5C,QAAM,UAAU,KAAK,OAAO,QAAQ,cAAc;AAClD,gBAAc,SAAS,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;AAAA,GAAM,MAAM;AAEvE,SAAO,EAAE,UAAU,MAAM,QAAQ;AACnC;AAEA,SAAS,oBACP,SACyC;AACzC,QAAM,WAAW,QAAQ,IAAI;AAC7B,MAAI,aAAa,UAAa,aAAa,GAAI,QAAO;AACtD,MAAI,QAAQ,WAAW,EAAG,QAAO,CAAC,EAAE,KAAK,SAAS,CAAC;AACnD,QAAM,CAAC,OAAO,GAAG,IAAI,IAAI;AACzB,SAAO;AAAA,IACL;AAAA,MACE,KAAK;AAAA,MACL,GAAI,MAAM,gBAAgB,SAAY,EAAE,aAAa,MAAM,YAAY,IAAI,CAAC;AAAA,IAC9E;AAAA,IACA,GAAG;AAAA,EACL;AACF;;;AEtOA,SAAS,eAAe;AA0BxB,IAAM,mBAAmB,CAAC,OAAO,QAAQ,OAAO,SAAS,UAAU,QAAQ,SAAS;AAuBpF,eAAsB,qBACpB,SACiC;AACjC,QAAM,EAAE,WAAW,OAAO,IAAI;AAC9B,MAAI,aAAa,QAAQ;AACzB,MAAI;AACJ,MAAI,eAAe,QAAW;AAC5B,UAAM,UAAU,MAAM,oBAAoB,SAAS;AACnD,iBAAa,QAAQ;AACrB,cAAU,QAAQ;AAAA,EACpB;AAEA,QAAM,MAA8B,CAAC;AACrC,MAAI;AACF,eAAW,KAAK,QAAQ;AACtB,YAAM,MAAM,QAAQ,WAAW,EAAE,QAAQ;AACzC,UAAI;AACJ,UAAI;AACF,cAAM,MAAM,WAAW,GAAG;AAAA,MAC5B,SAAS,KAAK;AACZ,gBAAQ;AAAA,UACN,2BAA2B,EAAE,QAAQ,kBAAmB,IAAc,OAAO;AAAA,QAC/E;AACA;AAAA,MACF;AAEA,YAAM,UAAU,EAAE,WAAW,iBAAiB,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,MAAS;AAChF,UAAI,QAAQ,WAAW,GAAG;AAExB,cAAM,MAAM,IAAI;AAChB,YAAI,QAAQ,UAAa,QAAQ,MAAM;AACrC,cAAI,KAAK,EAAE,WAAW,EAAE,WAAW,SAAS,CAAC,KAAK,GAAG,GAAG,eAAe,GAAG,EAAE,CAAC;AAAA,QAC/E;AACA;AAAA,MACF;AAEA,iBAAW,UAAU,SAAS;AAC5B,cAAM,UAAU,IAAI,MAAM,KAAK,IAAI;AACnC,YAAI,YAAY,UAAa,YAAY,KAAM;AAC/C,YAAI,KAAK,EAAE,WAAW,EAAE,WAAW,SAAS,CAAC,MAAM,GAAG,GAAG,eAAe,OAAO,EAAE,CAAC;AAAA,MACpF;AAAA,IACF;AAAA,EACF,UAAE;AACA,QAAI,YAAY,QAAW;AACzB,YAAM,QAAQ;AAAA,IAChB;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,eAAe,eAA0C;AAChE,MAAI,OAAO,kBAAkB,YAAY,kBAAkB,KAAM,QAAO,CAAC;AACzE,QAAM,MAAM;AACZ,QAAM,MAAwB,CAAC;AAC/B,MAAI,IAAI,SAAS,OAAW,KAAI,OAAO,IAAI;AAC3C,MAAI,IAAI,UAAU,OAAW,KAAI,QAAQ,IAAI;AAC7C,MAAI,IAAI,WAAW,OAAW,KAAI,SAAS,IAAI;AAC/C,MAAI,IAAI,aAAa,OAAW,KAAI,WAAW,IAAI;AACnD,SAAO;AACT;AAUA,eAAe,oBAAoB,WAA2C;AAE5E,QAAM,EAAE,aAAa,IAAI,MAAM,OAAO,MAAM;AAC5C,QAAM,SAAU,MAAM,aAAa;AAAA,IACjC,MAAM;AAAA,IACN,YAAY;AAAA,IACZ,QAAQ,EAAE,gBAAgB,KAAK;AAAA,IAC/B,SAAS;AAAA,IACT,UAAU;AAAA,EACZ,CAAC;AAED,QAAM,UAAU,MAAY;AAAA,EAE5B;AACA,SAAO;AAAA,IACL,MAAM,OAAO,YAAY,OAAO,cAAc,OAAO;AAAA,IACrD,SAAS,YAAY;AACnB,YAAM,OAAO,MAAM,EAAE,MAAM,OAAO;AAAA,IACpC;AAAA,EACF;AACF;;;AC1HA,IAAI,WAAW;AAEf,eAAsB,cACpB,WACA,SACA,eACe;AACf,MAAI,UAAU;AACZ,YAAQ;AAAA,MACN;AAAA,IACF;AACA;AAAA,EACF;AACA,aAAW;AACX,MAAI;AACF,UAAM,WAAW,iBAAiB,SAAS;AAC3C,UAAM,WAAW,MAAM,qBAAqB,EAAE,WAAW,QAAQ,SAAS,OAAO,CAAC;AAClF,gBAAY;AAAA,MACV,UAAU;AAAA,MACV,QAAQ,EAAE,GAAG,eAAe,QAAQ,QAAQ;AAAA,IAC9C,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,YAAQ,KAAK,kCAAmC,IAAc,OAAO,EAAE;AAAA,EACzE,UAAE;AACA,eAAW;AAAA,EACb;AACF;AAGO,SAAS,yBAA+B;AAC7C,aAAW;AACb;","names":[]}

package/dist/dev-emit-I3CKOHML.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import "tsx/esm";
+import {
+  emitOpenApi,
+  loadRoutesForOpenApi
+} from "./chunk-ZOXNJV2O.js";
+import {
+  generateManifest
+} from "./chunk-SEVYARIU.js";
+import "./chunk-QLGES2HC.js";
+import "./chunk-MOT42NAH.js";
+import "./chunk-KT3MWNZG.js";
+
+// src/vite-plugin/openapi-emit/dev-emit.ts
+var inFlight = false;
+async function reEmitOpenApi(serverDir, distDir, openApiConfig) {
+  if (inFlight) {
+    console.warn(
+      "[openapi-emit] previous emit still running; skipping watcher event (EC-8 single-flight guard)"
+    );
+    return;
+  }
+  inFlight = true;
+  try {
+    const manifest = generateManifest(serverDir);
+    const hydrated = await loadRoutesForOpenApi({ serverDir, routes: manifest.routes });
+    emitOpenApi({
+      manifest: hydrated,
+      config: { ...openApiConfig, outDir: distDir }
+    });
+  } catch (err) {
+    console.warn(`[openapi-emit] re-emit failed: ${err.message}`);
+  } finally {
+    inFlight = false;
+  }
+}
+function _resetInFlightForTests() {
+  inFlight = false;
+}
+export {
+  _resetInFlightForTests,
+  reEmitOpenApi
+};
+//# sourceMappingURL=dev-emit-I3CKOHML.js.map

package/dist/dev-emit-I3CKOHML.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite-plugin/openapi-emit/dev-emit.ts"],"sourcesContent":["/**\n * Dev-mode OpenAPI emit helper for `theokit dev`.\n *\n * Per P#3 plan v1.3 T1.1 (ADRs D3 + D4 + EC-8). Called once on `theokit dev`\n * boot AND on every chokidar 'change'/'add'/'unlink' watcher event for\n * route files when `config.openapi !== undefined`. Re-runs G2's\n * `emitOpenApi()` orchestrator to keep `<distDir>/openapi.json` always\n * fresh in dev.\n *\n * EC-8 absorbed (single-flight guard): if a previous invocation is still\n * awaiting `loadRoutesForOpenApi` (Vite SSR loader can hang on circular\n * imports or syntax errors), skip the new call and emit a `console.warn`\n * so watcher events don't pile up + dev server doesn't deadlock.\n *\n * Best-effort: ALL errors caught + warned. Never throws out of the\n * exported function (would crash Vite dev's chokidar handler).\n *\n * NEVER ship to runtime — dev-only artifact gated on `config.openapi`.\n */\nimport { generateManifest } from '../../server/scan/manifest.js'\n\nimport { emitOpenApi } from './emit.js'\nimport { loadRoutesForOpenApi } from './load-routes.js'\n\ninterface DevEmitConfig {\n  servers: { url: string; description?: string }[]\n  specVersion: '3.1.0' | '3.0.3'\n  title: string\n  version: string\n}\n\nlet inFlight = false\n\nexport async function reEmitOpenApi(\n  serverDir: string,\n  distDir: string,\n  openApiConfig: DevEmitConfig,\n): Promise<void> {\n  if (inFlight) {\n    console.warn(\n      '[openapi-emit] previous emit still running; skipping watcher event (EC-8 single-flight guard)',\n    )\n    return\n  }\n  inFlight = true\n  try {\n    const manifest = generateManifest(serverDir)\n    const hydrated = await loadRoutesForOpenApi({ serverDir, routes: manifest.routes })\n    emitOpenApi({\n      manifest: hydrated,\n      config: { ...openApiConfig, outDir: distDir },\n    })\n  } catch (err) {\n    console.warn(`[openapi-emit] re-emit failed: ${(err as Error).message}`)\n  } finally {\n    inFlight = false\n  }\n}\n\n/** Test seam — resets the inFlight flag between tests. NOT for production use. */\nexport function _resetInFlightForTests(): void {\n  inFlight = false\n}\n"],"mappings":";;;;;;;;;;;;;;AA+BA,IAAI,WAAW;AAEf,eAAsB,cACpB,WACA,SACA,eACe;AACf,MAAI,UAAU;AACZ,YAAQ;AAAA,MACN;AAAA,IACF;AACA;AAAA,EACF;AACA,aAAW;AACX,MAAI;AACF,UAAM,WAAW,iBAAiB,SAAS;AAC3C,UAAM,WAAW,MAAM,qBAAqB,EAAE,WAAW,QAAQ,SAAS,OAAO,CAAC;AAClF,gBAAY;AAAA,MACV,UAAU;AAAA,MACV,QAAQ,EAAE,GAAG,eAAe,QAAQ,QAAQ;AAAA,IAC9C,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,YAAQ,KAAK,kCAAmC,IAAc,OAAO,EAAE;AAAA,EACzE,UAAE;AACA,eAAW;AAAA,EACb;AACF;AAGO,SAAS,yBAA+B;AAC7C,aAAW;AACb;","names":[]}