@rcmade/hono-docs 1.0.1

package/dist/index.mjs

@@ -0,0 +1,432 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/config/index.ts
+function defineConfig(config) {
+  return config;
+}
+
+// src/core/runGenerate.ts
+import fs3 from "fs";
+import path3, { resolve as resolve2 } from "path";
+import { Project } from "ts-morph";
+
+// src/config/loadConfig.ts
+import { resolve, extname } from "path";
+import { existsSync } from "fs";
+import { pathToFileURL } from "url";
+import { register } from "esbuild-register/dist/node";
+async function loadConfig(configFile) {
+  const fullPath = resolve(process.cwd(), configFile);
+  if (!existsSync(fullPath)) {
+    throw new Error(`[hono-docs] Config file not found: ${fullPath}`);
+  }
+  const ext = extname(fullPath);
+  let unregister = () => {
+  };
+  if (ext === ".ts" || ext === ".tsx" || ext === ".mts") {
+    const reg = register({
+      target: "es2020",
+      jsx: "automatic"
+    });
+    unregister = reg.unregister;
+  }
+  let configModule;
+  try {
+    if (ext === ".mjs" || ext === ".mts") {
+      configModule = await import(pathToFileURL(fullPath).href);
+    } else {
+      configModule = __require(fullPath);
+    }
+  } catch (err) {
+    unregister();
+    throw new Error(
+      `[hono-docs] Failed to load config: ${err instanceof Error ? err.message : String(err)}`
+    );
+  } finally {
+    unregister();
+  }
+  const config = configModule && typeof configModule === "object" && "default" in configModule ? (
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    configModule.default
+  ) : configModule;
+  if (!config || typeof config !== "object") {
+    throw new Error(
+      `[hono-docs] Invalid config file. Expected an object, got: ${typeof config}`
+    );
+  }
+  return config;
+}
+
+// src/core/generateTypes.ts
+import fs from "fs";
+import path from "path";
+
+// src/utils/format.ts
+function sanitizeApiPrefix(prefix) {
+  return prefix.replace(/^\//, "").split(/[^a-z0-9]+/i).filter(Boolean).map(
+    (seg, i) => i === 0 ? seg.toLowerCase() : seg[0].toUpperCase() + seg.slice(1).toLowerCase()
+  ).join("");
+}
+function unwrapUnion(type) {
+  return type.isUnion() ? type.getUnionTypes() : [type];
+}
+function normalizeImportPaths(typeText) {
+  return typeText.replace(/from ["'].*node_modules\/(.*)["']/g, `from "$1"`);
+}
+function cleanDefaultResponse(operation, pathKey, method) {
+  var _a;
+  const defaultResponse = (_a = operation.responses) == null ? void 0 : _a.default;
+  if (!defaultResponse) return;
+  const desc = defaultResponse.description ?? "";
+  if (desc.includes("import(")) {
+    const content = defaultResponse.content;
+    if (content && Object.keys(content).length > 0) {
+      defaultResponse.description = "Default fallback response";
+      console.log(
+        `\u2139\uFE0F Cleaned 'default' description in ${method.toUpperCase()} ${pathKey}`
+      );
+    } else {
+      delete operation.responses.default;
+      console.log(
+        `\u{1F5D1}\uFE0F Removed empty 'default' in ${method.toUpperCase()} ${pathKey}`
+      );
+    }
+  }
+}
+function groupBy(arr, fn) {
+  return arr.reduce((acc, x) => {
+    (acc[fn(x)] ||= []).push(x);
+    return acc;
+  }, {});
+}
+
+// src/core/generateTypes.ts
+async function generateTypes({
+  config,
+  project,
+  rootPath,
+  apiGroup,
+  fileName,
+  outputRoot
+}) {
+  fs.mkdirSync(outputRoot, { recursive: true });
+  const outputPath = path.join(outputRoot, `${fileName}.d.ts`);
+  const absInput = path.resolve(rootPath, apiGroup.appTypePath);
+  const sourceFile = project.addSourceFileAtPath(absInput);
+  const typeAliases = sourceFile.getTypeAliases();
+  const interfaces = sourceFile.getInterfaces();
+  let result = `// AUTO-GENERATED from ${apiGroup.appTypePath}
+
+`;
+  typeAliases.forEach((alias) => {
+    const raw = alias.getType().getText(alias);
+    const clean = normalizeImportPaths(raw);
+    result += `export type ${alias.getName()} = ${clean};
+
+`;
+  });
+  interfaces.forEach((intf) => {
+    result += intf.getText() + "\n\n";
+  });
+  const preContent = config.preDefineTypeContent || "";
+  fs.writeFileSync(outputPath, `${preContent}
+${result}`, "utf-8");
+  console.log(`\u2705 Wrote: ${outputPath}`);
+  return { appTypePath: outputPath, name: fileName };
+}
+
+// src/core/generateOpenApi.ts
+import fs2 from "fs";
+import path2 from "path";
+import {
+  SyntaxKind as SyntaxKind2
+} from "ts-morph";
+
+// src/utils/buildSchema.ts
+import { SyntaxKind } from "ts-morph";
+function buildSchema(type) {
+  var _a;
+  if (type.isUnion()) {
+    const members = type.getUnionTypes();
+    const lits = members.filter((u) => u.isStringLiteral());
+    const onlyNull = members.every(
+      (u) => u.isStringLiteral() || u.isNull() || u.isUndefined()
+    );
+    if (lits.length && onlyNull) {
+      const schema = {
+        type: "string",
+        enum: lits.map((u) => u.getLiteralValue())
+      };
+      if (members.some((u) => u.isNull() || u.isUndefined()))
+        schema.nullable = true;
+      return schema;
+    }
+    const nonNull = members.filter((u) => !u.isNull() && !u.isUndefined());
+    return { oneOf: nonNull.map(buildSchema) };
+  }
+  if (type.isString()) return { type: "string" };
+  if (type.isNumber()) return { type: "number" };
+  if (type.isBoolean()) return { type: "boolean" };
+  if (type.isArray()) {
+    return {
+      type: "array",
+      items: buildSchema(type.getArrayElementTypeOrThrow())
+    };
+  }
+  const decls = ((_a = type.getSymbol()) == null ? void 0 : _a.getDeclarations()) || [];
+  const isLit = decls.some(
+    (d) => d.getKind() === SyntaxKind.TypeLiteral || d.getKind() === SyntaxKind.InterfaceDeclaration
+  );
+  if (!isLit) return {};
+  const props = type.getProperties().filter(
+    (p) => {
+      var _a2;
+      return ((_a2 = p.getValueDeclaration()) == null ? void 0 : _a2.getKind()) === SyntaxKind.PropertySignature;
+    }
+  );
+  const propsMap = {};
+  const req = [];
+  for (const p of props) {
+    const decl = p.getValueDeclarationOrThrow();
+    propsMap[p.getName()] = buildSchema(decl.getType());
+    if (!p.isOptional()) req.push(p.getName());
+  }
+  const res = { type: "object", properties: propsMap };
+  if (req.length) res.required = req;
+  return res;
+}
+
+// src/utils/parameters.ts
+function genParameters(type) {
+  var _a;
+  const input = (_a = type.getProperty("input")) == null ? void 0 : _a.getValueDeclarationOrThrow().getType();
+  if (!input) return [];
+  const sources = ["query", "param", "header", "cookie"];
+  const params = [];
+  for (const src of sources) {
+    const p = input.getProperty(src);
+    if (!p) continue;
+    const srcType = p.getValueDeclarationOrThrow().getType();
+    for (const f of srcType.getProperties()) {
+      const ft = f.getValueDeclarationOrThrow().getType();
+      params.push({
+        name: f.getName(),
+        in: src === "param" ? "path" : src,
+        required: !f.isOptional(),
+        schema: buildSchema(ft)
+      });
+    }
+  }
+  return params;
+}
+
+// src/utils/requestBody.ts
+function genRequestBody(type) {
+  var _a;
+  const inp = (_a = type.getProperty("input")) == null ? void 0 : _a.getValueDeclarationOrThrow().getType();
+  if (!inp) return null;
+  const content = {};
+  const j = inp.getProperty("json");
+  if (j) {
+    content["application/json"] = {
+      schema: buildSchema(j.getValueDeclarationOrThrow().getType())
+    };
+  }
+  const f = inp.getProperty("form");
+  if (f) {
+    content["multipart/form-data"] = {
+      schema: buildSchema(f.getValueDeclarationOrThrow().getType())
+    };
+  }
+  return Object.keys(content).length ? { required: true, content } : null;
+}
+
+// src/core/generateOpenApi.ts
+async function generateOpenApi({
+  config,
+  snapshotPath,
+  fileName,
+  project,
+  rootPath,
+  outputRoot
+}) {
+  const sf = project.addSourceFileAtPath(
+    path2.resolve(rootPath, snapshotPath.appTypePath)
+  );
+  const aliasDecl = sf.getTypeAliasOrThrow("AppType");
+  const topTypeNode = aliasDecl.getTypeNode();
+  let typeArgs;
+  if (topTypeNode == null ? void 0 : topTypeNode.isKind(SyntaxKind2.TypeReference)) {
+    typeArgs = topTypeNode.getTypeArguments();
+  } else if (topTypeNode == null ? void 0 : topTypeNode.isKind(SyntaxKind2.ImportType)) {
+    typeArgs = topTypeNode.getTypeArguments();
+  } else {
+    throw new Error("AppType must be an ImportType or a TypeReference");
+  }
+  if (typeArgs.length < 2) {
+    throw new Error("Expected two type arguments on HonoBase");
+  }
+  const routesNode = typeArgs[1];
+  const literals = [];
+  if (routesNode.isKind(SyntaxKind2.IntersectionType)) {
+    for (const tn of routesNode.asKind(SyntaxKind2.IntersectionType).getTypeNodes()) {
+      if (tn.isKind(SyntaxKind2.TypeLiteral))
+        literals.push(tn);
+    }
+  } else if (routesNode.isKind(SyntaxKind2.TypeLiteral)) {
+    literals.push(routesNode);
+  } else {
+    throw new Error("Routes type is not a literal or intersection of literals");
+  }
+  const paths = {};
+  for (const lit of literals) {
+    for (const member of lit.getMembers()) {
+      if (!member.isKind(SyntaxKind2.PropertySignature)) continue;
+      const routeProp = member.asKindOrThrow(SyntaxKind2.PropertySignature);
+      const raw = routeProp.getNameNode().getText().replace(/"/g, "");
+      const route = raw.replace(/:([^/]+)/g, "{$1}");
+      if (!paths[route]) paths[route] = {};
+      const tn = routeProp.getTypeNode();
+      if (!tn || !tn.isKind(SyntaxKind2.TypeLiteral)) continue;
+      const rhs = tn;
+      for (const m of rhs.getMembers()) {
+        if (!m.isKind(SyntaxKind2.PropertySignature)) continue;
+        const methodProp = m.asKindOrThrow(SyntaxKind2.PropertySignature);
+        const name = methodProp.getNameNode().getText();
+        const http = name.slice(1).toLowerCase();
+        const variants = unwrapUnion(methodProp.getType());
+        const op = {
+          summary: `Auto-generated ${http.toUpperCase()} ${route}`
+        };
+        const params = genParameters(variants[0]);
+        if (params.length) op.parameters = params;
+        const rb = genRequestBody(variants[0]);
+        if (rb) op.requestBody = rb;
+        op.responses = {};
+        const byStatus = groupBy(variants, (v) => {
+          const s = v.getProperty("status").getValueDeclarationOrThrow().getType().getText();
+          return /^\d+$/.test(s) ? s : "default";
+        });
+        for (const [code, vs] of Object.entries(byStatus)) {
+          const schemas = vs.map(
+            (v) => buildSchema(
+              v.getProperty("output").getValueDeclarationOrThrow().getType()
+            )
+          );
+          const schema = schemas.length > 1 ? { oneOf: schemas } : schemas[0];
+          op.responses[code] = {
+            description: code === "default" ? `Generic status from ${vs[0].getProperty("status").getValueDeclarationOrThrow().getType().getText()}` : `Status ${code}`,
+            content: { "application/json": { schema } }
+          };
+        }
+        paths[route][http] = op;
+      }
+    }
+  }
+  const spec = {
+    ...config.openApi,
+    paths
+  };
+  const outputPath = path2.join(outputRoot, `${fileName}.json`);
+  fs2.mkdirSync(path2.dirname(outputPath), { recursive: true });
+  fs2.writeFileSync(outputPath, JSON.stringify(spec, null, 2), "utf-8");
+  console.log(`\u2705 OpenAPI written to ${outputPath}`);
+  return { openApiPath: outputPath };
+}
+
+// src/core/runGenerate.ts
+async function runGenerate(configPath) {
+  const config = await loadConfig(configPath);
+  const rootPath = process.cwd();
+  console.log("Initializing ts-morph with tsConfig:", config.tsConfigPath);
+  const project = new Project({
+    tsConfigFilePath: resolve2(rootPath, config.tsConfigPath)
+  });
+  const isDevMode = __dirname.includes("/src/") || __dirname.includes("\\src\\");
+  const libDir = isDevMode ? path3.resolve(__dirname, "../../") : path3.dirname(__require.resolve("@rcmade/hono-docs/package.json"));
+  const apis = config.apis;
+  const snapshotOutputRoot = path3.resolve(libDir, "output/types");
+  const openAPiOutputRoot = path3.resolve(libDir, "output/openapi");
+  const commonParams = {
+    config,
+    libDir,
+    project,
+    rootPath
+  };
+  for (const apiGroup of apis) {
+    const sanitizedName = sanitizeApiPrefix(apiGroup.apiPrefix);
+    const snapshotPath = await generateTypes({
+      ...commonParams,
+      apiGroup,
+      fileName: sanitizedName,
+      outputRoot: snapshotOutputRoot
+    });
+    await generateOpenApi({
+      snapshotPath,
+      ...commonParams,
+      fileName: sanitizedName,
+      outputRoot: openAPiOutputRoot
+    });
+  }
+  const merged = {
+    ...config.openApi,
+    tags: [],
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    paths: {}
+  };
+  for (const apiGroup of apis) {
+    const name = sanitizeApiPrefix(apiGroup.apiPrefix);
+    const openApiFile = path3.join(openAPiOutputRoot, `${name}.json`);
+    if (!fs3.existsSync(openApiFile)) {
+      console.warn(`\u26A0\uFE0F Missing OpenAPI file: ${openApiFile}`);
+      continue;
+    }
+    const json = JSON.parse(fs3.readFileSync(openApiFile, "utf-8"));
+    merged.tags.push({ name: apiGroup.name });
+    const customApiMap = /* @__PURE__ */ new Map();
+    if (apiGroup == null ? void 0 : apiGroup.api) {
+      for (const customApi of apiGroup.api) {
+        const fullPath = path3.posix.join(apiGroup.apiPrefix, customApi.api).replace(/\/+$/, "") || "/";
+        customApiMap.set(
+          `${customApi.method.toLowerCase()} ${fullPath}`,
+          customApi
+        );
+      }
+    }
+    for (const [pathKey, operations] of Object.entries(json.paths)) {
+      const prefixedPath = path3.posix.join(apiGroup.apiPrefix, pathKey).replace(/\/+$/, "") || "/";
+      if (!merged.paths[prefixedPath]) merged.paths[prefixedPath] = {};
+      for (const [method, operation] of Object.entries(operations)) {
+        const opKey = `${method.toLowerCase()} ${prefixedPath}`;
+        const customApi = customApiMap.get(opKey);
+        if (customApi) {
+          operation.summary = customApi.summery || operation.summary;
+          operation.description = customApi.description || operation.description;
+          operation.tags = customApi.tag && customApi.tag.length > 0 ? customApi.tag : [apiGroup.name];
+        } else {
+          operation.tags = operation.tags || [];
+          if (!operation.tags.includes(apiGroup.name)) {
+            operation.tags.push(apiGroup.name);
+          }
+        }
+        cleanDefaultResponse(operation, prefixedPath, method);
+        merged.paths[prefixedPath][method] = operation;
+      }
+    }
+  }
+  const outputPath = path3.join(rootPath, config.outputs.openApiJson);
+  fs3.mkdirSync(path3.dirname(outputPath), { recursive: true });
+  fs3.writeFileSync(outputPath, `${JSON.stringify(merged, null, 2)}
+`);
+  console.log(`\u2705 Final merged OpenAPI spec written to: ${outputPath}`);
+}
+export {
+  defineConfig,
+  runGenerate
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/index.ts","../src/core/runGenerate.ts","../src/config/loadConfig.ts","../src/core/generateTypes.ts","../src/utils/format.ts","../src/core/generateOpenApi.ts","../src/utils/buildSchema.ts","../src/utils/parameters.ts","../src/utils/requestBody.ts"],"sourcesContent":["// src/config/index.ts\nimport type { HonoDocsConfig } from \"../types\";\n\n/**\n * A no‑op helper to get TS inference and IDE support when\n * writing `export default defineConfig({...})` in userland.\n */\nexport function defineConfig(config: HonoDocsConfig): HonoDocsConfig {\n  return config;\n}\n","import fs from \"node:fs\";\nimport path, { resolve } from \"node:path\";\nimport { Project } from \"ts-morph\";\nimport { loadConfig } from \"../config/loadConfig\";\nimport { generateTypes } from \"./generateTypes\";\nimport { generateOpenApi } from \"./generateOpenApi\";\nimport { Api } from \"../types\";\nimport { cleanDefaultResponse, sanitizeApiPrefix } from \"../utils/format\";\n\nexport async function runGenerate(configPath: string) {\n  const config = await loadConfig(configPath);\n\n  const rootPath = process.cwd();\n  console.log(\"Initializing ts-morph with tsConfig:\", config.tsConfigPath);\n  const project = new Project({\n    tsConfigFilePath: resolve(rootPath, config.tsConfigPath),\n  });\n\n  const isDevMode =\n    __dirname.includes(\"/src/\") || __dirname.includes(\"\\\\src\\\\\");\n\n  const libDir = isDevMode\n    ? path.resolve(__dirname, \"../../\")\n    : path.dirname(require.resolve(\"@rcmade/hono-docs/package.json\"));\n\n  const apis = config.apis;\n\n  const snapshotOutputRoot = path.resolve(libDir, \"output/types\");\n  const openAPiOutputRoot = path.resolve(libDir, \"output/openapi\");\n\n  const commonParams = {\n    config,\n    libDir,\n    project,\n    rootPath,\n  };\n  for (const apiGroup of apis) {\n    const sanitizedName = sanitizeApiPrefix(apiGroup.apiPrefix);\n\n    const snapshotPath = await generateTypes({\n      ...commonParams,\n      apiGroup: apiGroup,\n      fileName: sanitizedName,\n      outputRoot: snapshotOutputRoot,\n    });\n\n    await generateOpenApi({\n      snapshotPath,\n      ...commonParams,\n      fileName: sanitizedName,\n      outputRoot: openAPiOutputRoot,\n    });\n  }\n\n  const merged = {\n    ...config.openApi,\n    tags: [] as { name: string }[],\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    paths: {} as Record<string, any>,\n  };\n\n  for (const apiGroup of apis) {\n    const name = sanitizeApiPrefix(apiGroup.apiPrefix);\n    const openApiFile = path.join(openAPiOutputRoot, `${name}.json`);\n\n    if (!fs.existsSync(openApiFile)) {\n      console.warn(`⚠️ Missing OpenAPI file: ${openApiFile}`);\n      continue;\n    }\n\n    const json = JSON.parse(fs.readFileSync(openApiFile, \"utf-8\"));\n    merged.tags.push({ name: apiGroup.name });\n\n    const customApiMap = new Map<string, Api>();\n\n    if (apiGroup?.api) {\n      for (const customApi of apiGroup.api) {\n        const fullPath =\n          path.posix\n            .join(apiGroup.apiPrefix, customApi.api)\n            .replace(/\\/+$/, \"\") || \"/\";\n        customApiMap.set(\n          `${customApi.method.toLowerCase()} ${fullPath}`,\n          customApi\n        );\n      }\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    for (const [pathKey, operations] of Object.entries<any>(json.paths)) {\n      const prefixedPath =\n        path.posix.join(apiGroup.apiPrefix, pathKey).replace(/\\/+$/, \"\") || \"/\";\n      if (!merged.paths[prefixedPath]) merged.paths[prefixedPath] = {};\n\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      for (const [method, operation] of Object.entries<any>(operations)) {\n        const opKey = `${method.toLowerCase()} ${prefixedPath}`;\n        const customApi = customApiMap.get(opKey);\n\n        // Override or enrich metadata if defined\n        if (customApi) {\n          operation.summary = customApi.summery || operation.summary;\n          operation.description =\n            customApi.description || operation.description;\n          operation.tags =\n            customApi.tag && customApi.tag.length > 0\n              ? customApi.tag\n              : [apiGroup.name];\n        } else {\n          operation.tags = operation.tags || [];\n          if (!operation.tags.includes(apiGroup.name)) {\n            operation.tags.push(apiGroup.name);\n          }\n        }\n\n        cleanDefaultResponse(operation, prefixedPath, method);\n        merged.paths[prefixedPath][method] = operation;\n      }\n    }\n  }\n\n  const outputPath = path.join(rootPath, config.outputs.openApiJson);\n  fs.mkdirSync(path.dirname(outputPath), { recursive: true });\n\n  fs.writeFileSync(outputPath, `${JSON.stringify(merged, null, 2)}\\n`);\n\n  console.log(`✅ Final merged OpenAPI spec written to: ${outputPath}`);\n}\n","import { resolve, extname } from \"path\";\nimport { existsSync } from \"fs\";\nimport { pathToFileURL } from \"url\";\nimport { register } from \"esbuild-register/dist/node\";\nimport type { HonoDocsConfig } from \"../types\";\n\nexport async function loadConfig(configFile: string): Promise<HonoDocsConfig> {\n  // 1. Resolve absolute path\n  const fullPath = resolve(process.cwd(), configFile);\n\n  if (!existsSync(fullPath)) {\n    throw new Error(`[hono-docs] Config file not found: ${fullPath}`);\n  }\n\n  // 2. Detect file extension\n  const ext = extname(fullPath);\n  let unregister = () => {};\n\n  // 3. Register TS transpiler if needed\n  if (ext === \".ts\" || ext === \".tsx\" || ext === \".mts\") {\n    const reg = register({\n      target: \"es2020\",\n      jsx: \"automatic\",\n    });\n    unregister = reg.unregister;\n  }\n\n  // 4. Dynamically load the config\n  let configModule: unknown;\n\n  try {\n    if (ext === \".mjs\" || ext === \".mts\") {\n      // ESM config\n      configModule = await import(pathToFileURL(fullPath).href);\n    } else {\n      // Use require with esbuild-register hook for .ts/.js\n      configModule = require(fullPath);\n    }\n  } catch (err) {\n    unregister();\n    throw new Error(\n      `[hono-docs] Failed to load config: ${\n        err instanceof Error ? err.message : String(err)\n      }`\n    );\n  } finally {\n    unregister();\n  }\n\n  // 5. Handle default or named export\n  const config =\n    configModule &&\n    typeof configModule === \"object\" &&\n    \"default\" in configModule\n      ? // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        (configModule as any).default\n      : configModule;\n\n  if (!config || typeof config !== \"object\") {\n    throw new Error(\n      `[hono-docs] Invalid config file. Expected an object, got: ${typeof config}`\n    );\n  }\n\n  return config as HonoDocsConfig;\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport type { ApiGroup, GenerateParams } from \"../types\";\nimport { normalizeImportPaths } from \"../utils/format\";\n\nexport async function generateTypes({\n  config,\n  project,\n  rootPath,\n  apiGroup,\n  fileName,\n  outputRoot,\n}: GenerateParams & { apiGroup: ApiGroup }) {\n  fs.mkdirSync(outputRoot, { recursive: true });\n\n  const outputPath = path.join(outputRoot, `${fileName}.d.ts`);\n  const absInput = path.resolve(rootPath, apiGroup.appTypePath);\n\n  const sourceFile = project.addSourceFileAtPath(absInput);\n  const typeAliases = sourceFile.getTypeAliases();\n  const interfaces = sourceFile.getInterfaces();\n\n  let result = `// AUTO-GENERATED from ${apiGroup.appTypePath}\\n\\n`;\n\n  typeAliases.forEach((alias) => {\n    const raw = alias.getType().getText(alias);\n    const clean = normalizeImportPaths(raw);\n    result += `export type ${alias.getName()} = ${clean};\\n\\n`;\n  });\n\n  interfaces.forEach((intf) => {\n    result += intf.getText() + \"\\n\\n\";\n  });\n\n  const preContent = config.preDefineTypeContent || \"\";\n\n  fs.writeFileSync(outputPath, `${preContent}\\n${result}`, \"utf-8\");\n  console.log(`✅ Wrote: ${outputPath}`);\n  return { appTypePath: outputPath, name: fileName };\n}\n","export function sanitizeApiPrefix(prefix: string): string {\n  return prefix\n    .replace(/^\\//, \"\")\n    .split(/[^a-z0-9]+/i)\n    .filter(Boolean)\n    .map((seg, i) =>\n      i === 0\n        ? seg.toLowerCase()\n        : seg[0].toUpperCase() + seg.slice(1).toLowerCase()\n    )\n    .join(\"\");\n}\n\nexport function unwrapUnion(\n  type: import(\"ts-morph\").Type\n): import(\"ts-morph\").Type[] {\n  return type.isUnion() ? type.getUnionTypes() : [type];\n}\n\nexport function normalizeImportPaths(typeText: string): string {\n  return typeText.replace(/from [\"'].*node_modules\\/(.*)[\"']/g, `from \"$1\"`);\n}\n\nexport function cleanDefaultResponse(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  operation: any,\n  pathKey: string,\n  method: string\n) {\n  const defaultResponse = operation.responses?.default;\n  if (!defaultResponse) return;\n\n  const desc = defaultResponse.description ?? \"\";\n\n  if (desc.includes(\"import(\")) {\n    const content = defaultResponse.content;\n\n    if (content && Object.keys(content).length > 0) {\n      defaultResponse.description = \"Default fallback response\";\n      console.log(\n        `ℹ️ Cleaned 'default' description in ${method.toUpperCase()} ${pathKey}`\n      );\n    } else {\n      delete operation.responses.default;\n      console.log(\n        `🗑️ Removed empty 'default' in ${method.toUpperCase()} ${pathKey}`\n      );\n    }\n  }\n}\n\n\nexport function groupBy<T>(\n  arr: T[],\n  fn: (x: T) => string\n): Record<string, T[]> {\n  return arr.reduce((acc, x) => {\n    (acc[fn(x)] ||= []).push(x);\n    return acc;\n  }, {} as Record<string, T[]>);\n}\n","// src/core/generateOpenApi.ts\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport {\n  SyntaxKind,\n  TypeLiteralNode,\n  ImportTypeNode,\n  TypeReferenceNode,\n  TypeNode,\n  ts,\n} from \"ts-morph\";\nimport type {\n  AppTypeSnapshotPath,\n  GenerateParams,\n  OpenApiPath,\n} from \"../types\";\nimport { genParameters } from \"../utils/parameters\";\nimport { genRequestBody } from \"../utils/requestBody\";\nimport { buildSchema } from \"../utils/buildSchema\";\nimport { groupBy, unwrapUnion } from \"../utils/format\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype OpenAPI = Record<string, any>;\n\nexport async function generateOpenApi({\n  config,\n  snapshotPath,\n  fileName,\n  project,\n  rootPath,\n  outputRoot,\n}: // {\n//   config: HonoDocsConfig;\n//   snapshotPath: AppTypeSnapshotPath;\n// }\nGenerateParams & {\n  snapshotPath: AppTypeSnapshotPath;\n}): Promise<OpenApiPath> {\n  const sf = project.addSourceFileAtPath(\n    path.resolve(rootPath, snapshotPath.appTypePath)\n  );\n  const aliasDecl = sf.getTypeAliasOrThrow(\"AppType\");\n\n  const topTypeNode = aliasDecl.getTypeNode();\n\n  let typeArgs: readonly TypeNode<ts.TypeNode>[];\n\n  if (topTypeNode?.isKind(SyntaxKind.TypeReference)) {\n    typeArgs = (topTypeNode as TypeReferenceNode).getTypeArguments();\n  } else if (topTypeNode?.isKind(SyntaxKind.ImportType)) {\n    typeArgs = (topTypeNode as ImportTypeNode).getTypeArguments();\n  } else {\n    throw new Error(\"AppType must be an ImportType or a TypeReference\");\n  }\n\n  if (typeArgs.length < 2) {\n    throw new Error(\"Expected two type arguments on HonoBase\");\n  }\n\n  const routesNode = typeArgs[1];\n\n  // Gather all TypeLiteralNodes (handle intersections)\n  const literals: TypeLiteralNode[] = [];\n  if (routesNode.isKind(SyntaxKind.IntersectionType)) {\n    for (const tn of routesNode\n      .asKind(SyntaxKind.IntersectionType)!\n      .getTypeNodes()) {\n      if (tn.isKind(SyntaxKind.TypeLiteral))\n        literals.push(tn as TypeLiteralNode);\n    }\n  } else if (routesNode.isKind(SyntaxKind.TypeLiteral)) {\n    literals.push(routesNode as TypeLiteralNode);\n  } else {\n    throw new Error(\"Routes type is not a literal or intersection of literals\");\n  }\n\n  const paths: OpenAPI = {};\n\n  for (const lit of literals) {\n    for (const member of lit.getMembers()) {\n      if (!member.isKind(SyntaxKind.PropertySignature)) continue;\n      const routeProp = member.asKindOrThrow(SyntaxKind.PropertySignature);\n      // Extract route string and normalize to OpenAPI path syntax\n      const raw = routeProp.getNameNode().getText().replace(/\"/g, \"\");\n      const route = raw.replace(/:([^/]+)/g, \"{$1}\");\n      if (!paths[route]) paths[route] = {};\n\n      // === NEW: get the RHS TypeLiteralNode properly ===\n      const tn = routeProp.getTypeNode();\n      if (!tn || !tn.isKind(SyntaxKind.TypeLiteral)) continue;\n      const rhs = tn as TypeLiteralNode;\n\n      for (const m of rhs.getMembers()) {\n        if (!m.isKind(SyntaxKind.PropertySignature)) continue;\n        const methodProp = m.asKindOrThrow(SyntaxKind.PropertySignature);\n        const name = methodProp.getNameNode().getText(); // e.g. \"$get\"\n        const http = name.slice(1).toLowerCase(); // \"get\", \"post\", etc.\n        const variants = unwrapUnion(methodProp.getType());\n\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const op: any = {\n          summary: `Auto-generated ${http.toUpperCase()} ${route}`,\n        };\n\n        // parameters\n        const params = genParameters(variants[0]);\n        if (params.length) op.parameters = params;\n\n        // requestBody\n        const rb = genRequestBody(variants[0]);\n        if (rb) op.requestBody = rb;\n\n        // responses\n        op.responses = {};\n        const byStatus = groupBy(variants, (v) => {\n          const s = v\n            .getProperty(\"status\")!\n            .getValueDeclarationOrThrow()\n            .getType()\n            .getText();\n          return /^\\d+$/.test(s) ? s : \"default\";\n        });\n        for (const [code, vs] of Object.entries(byStatus)) {\n          const schemas = vs.map((v) =>\n            buildSchema(\n              v.getProperty(\"output\")!.getValueDeclarationOrThrow().getType()\n            )\n          );\n          const schema = schemas.length > 1 ? { oneOf: schemas } : schemas[0];\n          op.responses[code] = {\n            description:\n              code === \"default\"\n                ? `Generic status from ${vs[0]\n                    .getProperty(\"status\")!\n                    .getValueDeclarationOrThrow()\n                    .getType()\n                    .getText()}`\n                : `Status ${code}`,\n            content: { \"application/json\": { schema } },\n          };\n        }\n\n        paths[route][http] = op;\n      }\n    }\n  }\n\n  const spec = {\n    ...config.openApi,\n    paths,\n  };\n\n  // write to disk\n  const outputPath = path.join(outputRoot, `${fileName}.json`);\n\n  fs.mkdirSync(path.dirname(outputPath), { recursive: true });\n  fs.writeFileSync(outputPath, JSON.stringify(spec, null, 2), \"utf-8\");\n  console.log(`✅ OpenAPI written to ${outputPath}`);\n  return { openApiPath: outputPath };\n}\n","import { SyntaxKind } from \"ts-morph\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function buildSchema(type: import(\"ts-morph\").Type): any {\n  if (type.isUnion()) {\n    const members = type.getUnionTypes();\n    const lits = members.filter((u) => u.isStringLiteral());\n    const onlyNull = members.every(\n      (u) => u.isStringLiteral() || u.isNull() || u.isUndefined()\n    );\n    if (lits.length && onlyNull) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const schema: any = {\n        type: \"string\",\n        enum: lits.map((u) => u.getLiteralValue()),\n      };\n      if (members.some((u) => u.isNull() || u.isUndefined()))\n        schema.nullable = true;\n      return schema;\n    }\n    const nonNull = members.filter((u) => !u.isNull() && !u.isUndefined());\n    return { oneOf: nonNull.map(buildSchema) };\n  }\n  if (type.isString()) return { type: \"string\" };\n  if (type.isNumber()) return { type: \"number\" };\n  if (type.isBoolean()) return { type: \"boolean\" };\n  if (type.isArray()) {\n    return {\n      type: \"array\",\n      items: buildSchema(type.getArrayElementTypeOrThrow()),\n    };\n  }\n\n  const decls = type.getSymbol()?.getDeclarations() || [];\n  const isLit = decls.some(\n    (d) =>\n      d.getKind() === SyntaxKind.TypeLiteral ||\n      d.getKind() === SyntaxKind.InterfaceDeclaration\n  );\n  if (!isLit) return {};\n\n  const props = type\n    .getProperties()\n    .filter(\n      (p) => p.getValueDeclaration()?.getKind() === SyntaxKind.PropertySignature\n    );\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const propsMap: Record<string, any> = {};\n  const req: string[] = [];\n  for (const p of props) {\n    const decl = p.getValueDeclarationOrThrow();\n    propsMap[p.getName()] = buildSchema(decl.getType());\n    if (!p.isOptional()) req.push(p.getName());\n  }\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const res: any = { type: \"object\", properties: propsMap };\n  if (req.length) res.required = req;\n  return res;\n}\n","import { buildSchema } from \"./buildSchema\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function genParameters(type: import(\"ts-morph\").Type): any[] {\n  const input = type\n    .getProperty(\"input\")\n    ?.getValueDeclarationOrThrow()\n    .getType();\n  if (!input) return [];\n  const sources = [\"query\", \"param\", \"header\", \"cookie\"];\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const params: any[] = [];\n  for (const src of sources) {\n    const p = input.getProperty(src);\n    if (!p) continue;\n    const srcType = p.getValueDeclarationOrThrow().getType();\n    for (const f of srcType.getProperties()) {\n      const ft = f.getValueDeclarationOrThrow().getType();\n      params.push({\n        name: f.getName(),\n        in: src === \"param\" ? \"path\" : src,\n        required: !f.isOptional(),\n        schema: buildSchema(ft),\n      });\n    }\n  }\n  return params;\n}\n","import { buildSchema } from \"./buildSchema\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function genRequestBody(type: import(\"ts-morph\").Type): any | null {\n  const inp = type.getProperty(\"input\")?.getValueDeclarationOrThrow().getType();\n  if (!inp) return null;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const content: Record<string, any> = {};\n  const j = inp.getProperty(\"json\");\n  if (j) {\n    content[\"application/json\"] = {\n      schema: buildSchema(j.getValueDeclarationOrThrow().getType()),\n    };\n  }\n  const f = inp.getProperty(\"form\");\n  if (f) {\n    content[\"multipart/form-data\"] = {\n      schema: buildSchema(f.getValueDeclarationOrThrow().getType()),\n    };\n  }\n  return Object.keys(content).length ? { required: true, content } : null;\n}\n"],"mappings":"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","names":["fs","path","resolve","fs","path","SyntaxKind","_a","path","SyntaxKind","fs","resolve","path","fs"]}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@rcmade/hono-docs",
+  "version": "1.0.1",
+  "description": "Auto-generate OpenAPI 3.0 spec from Hono route types",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rcmade/hono-docs.git"
+  },
+  "bugs": {
+    "url": "https://github.com/rcmade/hono-docs/issues"
+  },
+  "homepage": "https://github.com/rcmade/hono-docs#readme",
+  "keywords": [
+    "openapi",
+    "hono",
+    "typescript",
+    "documentation",
+    "cli",
+    "generator"
+  ],
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "hono-docs": "dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./core": {
+      "import": "./dist/core/index.mjs",
+      "require": "./dist/core/index.js"
+    },
+    "./cli": {
+      "import": "./dist/cli/index.mjs",
+      "require": "./dist/cli/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "esbuild-register": "^3.6.0",
+    "ts-morph": "^26.0.0",
+    "yargs": "^18.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.29.0",
+    "@types/node": "^24.0.3",
+    "@types/yargs": "^17.0.33",
+    "@typescript-eslint/eslint-plugin": "^8.34.1",
+    "@typescript-eslint/parser": "^8.34.1",
+    "eslint": "^9.29.0",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-format": "^1.0.1",
+    "eslint-plugin-import": "^2.32.0",
+    "globals": "^16.2.0",
+    "husky": "^9.1.7",
+    "openapi-types": "^12.1.3",
+    "standard-version": "^9.5.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.33.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "lint": "eslint . --ext .ts,.js",
+    "postinstall": "husky install"
+  }
+}