@avodado/sync 0.0.1

package/dist/index.js

@@ -0,0 +1,264 @@
+import { parse } from 'yaml';
+import { z } from 'zod';
+
+// src/openapi/parse.ts
+var refSchema = z.object({ $ref: z.string() }).passthrough();
+var propertySchema = z.lazy(
+  () => z.object({
+    type: z.string().optional(),
+    format: z.string().optional(),
+    description: z.string().optional(),
+    enum: z.array(z.unknown()).optional(),
+    items: z.union([refSchema, propertySchema]).optional(),
+    properties: z.record(z.string(), z.union([refSchema, propertySchema])).optional(),
+    required: z.array(z.string()).optional(),
+    example: z.unknown().optional(),
+    $ref: z.string().optional()
+  }).passthrough()
+);
+var componentSchema = z.object({
+  type: z.string().optional(),
+  description: z.string().optional(),
+  properties: z.record(z.string(), z.union([refSchema, propertySchema])).optional(),
+  required: z.array(z.string()).optional(),
+  enum: z.array(z.unknown()).optional(),
+  allOf: z.array(z.union([refSchema, propertySchema])).optional()
+}).passthrough();
+var responseSchema = z.object({
+  description: z.string().optional(),
+  content: z.record(z.string(), z.unknown()).optional()
+}).passthrough();
+var parameterSchema = z.object({
+  name: z.string(),
+  in: z.string(),
+  required: z.boolean().optional(),
+  description: z.string().optional(),
+  schema: z.union([refSchema, propertySchema]).optional()
+}).passthrough();
+var operationSchema = z.object({
+  operationId: z.string().optional(),
+  summary: z.string().optional(),
+  description: z.string().optional(),
+  tags: z.array(z.string()).optional(),
+  parameters: z.array(parameterSchema).optional(),
+  requestBody: z.unknown().optional(),
+  responses: z.record(z.string(), responseSchema).optional()
+}).passthrough();
+var pathItemSchema = z.object({
+  get: operationSchema.optional(),
+  post: operationSchema.optional(),
+  put: operationSchema.optional(),
+  patch: operationSchema.optional(),
+  delete: operationSchema.optional(),
+  head: operationSchema.optional(),
+  options: operationSchema.optional(),
+  parameters: z.array(parameterSchema).optional()
+}).passthrough();
+var infoSchema = z.object({
+  title: z.string(),
+  description: z.string().optional(),
+  version: z.string()
+}).passthrough();
+var openApiSchema = z.object({
+  openapi: z.string().optional(),
+  swagger: z.string().optional(),
+  info: infoSchema,
+  paths: z.record(z.string(), pathItemSchema).optional(),
+  components: z.object({
+    schemas: z.record(z.string(), componentSchema).optional()
+  }).passthrough().optional()
+}).passthrough();
+var HTTP_METHODS = ["get", "post", "put", "patch", "delete"];
+
+// src/openapi/parse.ts
+function parseOpenApi(source) {
+  let raw;
+  try {
+    raw = parse(source);
+  } catch (err) {
+    throw new Error(`OpenAPI spec is not valid YAML/JSON: ${err.message}`);
+  }
+  const result = openApiSchema.safeParse(raw);
+  if (!result.success) {
+    const issues = result.error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ");
+    throw new Error(`OpenAPI spec failed validation: ${issues}`);
+  }
+  return result.data;
+}
+
+// src/openapi/generate.ts
+var METHOD_ORDER = {
+  get: 0,
+  post: 1,
+  put: 2,
+  patch: 3,
+  delete: 4
+};
+function collectEndpoints(spec) {
+  const out = [];
+  const paths = spec.paths ?? {};
+  for (const path of Object.keys(paths).sort()) {
+    const item = paths[path];
+    if (item === void 0) continue;
+    for (const method of HTTP_METHODS) {
+      const op = item[method];
+      if (op === void 0) continue;
+      out.push({ method, path, op });
+    }
+  }
+  out.sort((a, b) => {
+    const p = a.path.localeCompare(b.path);
+    if (p !== 0) return p;
+    return METHOD_ORDER[a.method] - METHOD_ORDER[b.method];
+  });
+  return out;
+}
+function slugify(s) {
+  return s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function endpointId(slug, ep) {
+  return `${slug}-${ep.method}-${slugify(ep.path) || "root"}`;
+}
+function yamlString(s) {
+  return `"${s.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+function renderEndpointTable(endpoints) {
+  const rows = endpoints.map((ep) => {
+    const summary = (ep.op.summary ?? "").replace(/\s+/g, " ").trim();
+    return `  - [${ep.method.toUpperCase()}, ${yamlString(ep.path)}, ${yamlString(summary)}]`;
+  }).join("\n");
+  return ["```table", "columns: [Method, Path, Summary]", "rows:", rows, "```"].join("\n");
+}
+function renderEndpointSequence(slug, ep) {
+  const id = endpointId(slug, ep);
+  const title = (ep.op.summary ?? `${ep.method.toUpperCase()} ${ep.path}`).trim();
+  const desc = (ep.op.description ?? "").replace(/\s+/g, " ").trim();
+  const responses = ep.op.responses ?? {};
+  const codes = Object.keys(responses).sort();
+  const okCodes = codes.filter((c) => /^[12]/.test(c));
+  const errCodes = codes.filter((c) => /^[345]/.test(c));
+  const lines = [
+    "```sequence",
+    `id: ${id}`,
+    `title: ${yamlString(title)}`
+  ];
+  if (desc.length > 0) lines.push(`description: ${yamlString(desc)}`);
+  lines.push(`endpoint: { method: ${ep.method.toUpperCase()}, path: ${yamlString(ep.path)} }`);
+  lines.push("actors:");
+  lines.push("  - { id: Client, name: Client }");
+  lines.push("  - { id: API, name: API }");
+  lines.push("messages:");
+  lines.push(
+    `  - { from: Client, to: API, label: ${yamlString(`${ep.method.toUpperCase()} ${ep.path}`)}, kind: sync }`
+  );
+  for (const code of okCodes) {
+    const summary = (responses[code]?.description ?? "").replace(/\s+/g, " ").trim();
+    const label = summary.length > 0 ? `${code} ${summary}` : code;
+    lines.push(`  - { from: API, to: Client, label: ${yamlString(label)}, kind: response }`);
+  }
+  for (const code of errCodes) {
+    const summary = (responses[code]?.description ?? "").replace(/\s+/g, " ").trim();
+    const label = summary.length > 0 ? `${code} ${summary}` : code;
+    lines.push(`  - { from: API, to: Client, label: ${yamlString(label)}, kind: error }`);
+  }
+  lines.push("```");
+  return lines.join("\n");
+}
+var PRIMITIVE_TYPE_REMAP = {
+  integer: "int",
+  number: "number",
+  string: "string",
+  boolean: "bool"
+};
+function schemaTypeLabel(schema, propName, propSchema) {
+  const s = propSchema ?? schema;
+  if (s.$ref !== void 0) {
+    const name = String(s.$ref).split("/").pop() ?? "ref";
+    return name;
+  }
+  const fmt = s.format;
+  if (fmt === "uuid") return "uuid";
+  if (fmt === "date-time" || fmt === "date") return "timestamp";
+  if (s.type === "array") {
+    const items = s.items;
+    return `${items !== void 0 ? schemaTypeLabel(s, propName, items) : "any"}[]`;
+  }
+  if (typeof s.type === "string") {
+    return PRIMITIVE_TYPE_REMAP[s.type] ?? s.type;
+  }
+  return "any";
+}
+function flattenColumns(schema) {
+  const out = [];
+  const required = new Set(schema.required ?? []);
+  const props = schema.properties ?? {};
+  for (const name of Object.keys(props)) {
+    const propSchema = props[name];
+    if (propSchema === void 0) continue;
+    const type = schemaTypeLabel(schema, name, propSchema);
+    const pk = name === "id";
+    const fk = !pk && /_id$/i.test(name);
+    out.push({
+      name,
+      type: required.has(name) ? type : `${type}?`,
+      pk,
+      fk
+    });
+  }
+  return out;
+}
+function renderSchemasErd(slug, spec) {
+  const schemas = spec.components?.schemas ?? {};
+  const names = Object.keys(schemas).sort();
+  if (names.length === 0) return "";
+  const entityLines = ["entities:"];
+  for (const name of names) {
+    const schema = schemas[name];
+    if (schema === void 0 || schema.type !== "object") continue;
+    const cols = flattenColumns(schema);
+    if (cols.length === 0) continue;
+    entityLines.push(`  - name: ${name}`);
+    entityLines.push("    columns:");
+    for (const c of cols) {
+      const flags = [];
+      if (c.pk) flags.push("pk: true");
+      if (c.fk) flags.push("fk: true");
+      const tail = flags.length > 0 ? `, ${flags.join(", ")}` : "";
+      entityLines.push(`      - { name: ${c.name}, type: ${yamlString(c.type)}${tail} }`);
+    }
+  }
+  if (entityLines.length === 1) return "";
+  return ["```erd", `id: ${slug}-schemas`, ...entityLines, "```"].join("\n");
+}
+function openapiToMarkdown(spec, opts = {}) {
+  const slug = opts.slug ?? "api";
+  const endpoints = collectEndpoints(spec);
+  const description = (spec.info.description ?? "").trim();
+  const out = [];
+  out.push(
+    "```meta",
+    `title: ${yamlString(spec.info.title)}`,
+    description.length > 0 ? `subtitle: ${yamlString(description.split(/\r?\n/)[0] ?? "")}` : "",
+    `tag: ${yamlString(`API \xB7 v${spec.info.version}`)}`,
+    "```"
+  );
+  if (description.length > 0) {
+    out.push("", "## Overview", "", description);
+  }
+  if (endpoints.length > 0) {
+    out.push("", "## Endpoints", "", renderEndpointTable(endpoints));
+  }
+  for (const ep of endpoints) {
+    out.push("", `## ${ep.method.toUpperCase()} ${ep.path}`, "", renderEndpointSequence(slug, ep));
+  }
+  const erd = renderSchemasErd(slug, spec);
+  if (erd.length > 0) {
+    out.push("", "## Schemas", "", erd);
+  }
+  const cleaned = out.filter((s, i, a) => !(s === "" && a[i - 1] === ""));
+  return cleaned.join("\n").replace(/\n+$/, "") + "\n";
+}
+
+export { HTTP_METHODS, openApiSchema, openapiToMarkdown, parseOpenApi };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/openapi/schemas.ts","../src/openapi/parse.ts","../src/openapi/generate.ts"],"names":["yamlParse"],"mappings":";;;;AAQA,IAAM,SAAA,GAAY,CAAA,CAAE,MAAA,CAAO,EAAE,IAAA,EAAM,EAAE,MAAA,EAAO,EAAG,CAAA,CAAE,WAAA,EAAY;AAE7D,IAAM,iBAA4B,CAAA,CAAE,IAAA;AAAA,EAAK,MACvC,EACG,MAAA,CAAO;AAAA,IACN,IAAA,EAAM,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,IAC1B,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,IAC5B,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,IACjC,MAAM,CAAA,CAAE,KAAA,CAAM,EAAE,OAAA,EAAS,EAAE,QAAA,EAAS;AAAA,IACpC,KAAA,EAAO,EAAE,KAAA,CAAM,CAAC,WAAW,cAAc,CAAC,EAAE,QAAA,EAAS;AAAA,IACrD,UAAA,EAAY,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,QAAO,EAAG,CAAA,CAAE,KAAA,CAAM,CAAC,SAAA,EAAW,cAAc,CAAC,CAAC,EAAE,QAAA,EAAS;AAAA,IAChF,UAAU,CAAA,CAAE,KAAA,CAAM,EAAE,MAAA,EAAQ,EAAE,QAAA,EAAS;AAAA,IACvC,OAAA,EAAS,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,IAC9B,IAAA,EAAM,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AAAS,GAC3B,EACA,WAAA;AACL,CAAA;AAEA,IAAM,eAAA,GAAkB,EACrB,MAAA,CAAO;AAAA,EACN,IAAA,EAAM,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC1B,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,UAAA,EAAY,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,QAAO,EAAG,CAAA,CAAE,KAAA,CAAM,CAAC,SAAA,EAAW,cAAc,CAAC,CAAC,EAAE,QAAA,EAAS;AAAA,EAChF,UAAU,CAAA,CAAE,KAAA,CAAM,EAAE,MAAA,EAAQ,EAAE,QAAA,EAAS;AAAA,EACvC,MAAM,CAAA,CAAE,KAAA,CAAM,EAAE,OAAA,EAAS,EAAE,QAAA,EAAS;AAAA,EACpC,KAAA,EAAO,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,KAAA,CAAM,CAAC,SAAA,EAAW,cAAc,CAAC,CAAC,CAAA,CAAE,QAAA;AACvD,CAAC,EACA,WAAA,EAAY;AAEf,IAAM,cAAA,GAAiB,EACpB,MAAA,CAAO;AAAA,EACN,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,OAAA,EAAS,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,IAAU,CAAA,CAAE,OAAA,EAAS,CAAA,CAAE,QAAA;AAC7C,CAAC,EACA,WAAA,EAAY;AAEf,IAAM,eAAA,GAAkB,EACrB,MAAA,CAAO;AAAA,EACN,IAAA,EAAM,EAAE,MAAA,EAAO;AAAA,EACf,EAAA,EAAI,EAAE,MAAA,EAAO;AAAA,EACb,QAAA,EAAU,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,EAC/B,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,MAAA,EAAQ,EAAE,KAAA,CAAM,CAAC,WAAW,cAAc,CAAC,EAAE,QAAA;AAC/C,CAAC,EACA,WAAA,EAAY;AAEf,IAAM,eAAA,GAAkB,EACrB,MAAA,CAAO;AAAA,EACN,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,OAAA,EAAS,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC7B,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,MAAM,CAAA,CAAE,KAAA,CAAM,EAAE,MAAA,EAAQ,EAAE,QAAA,EAAS;AAAA,EACnC,UAAA,EAAY,CAAA,CAAE,KAAA,CAAM,eAAe,EAAE,QAAA,EAAS;AAAA,EAC9C,WAAA,EAAa,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,EAClC,SAAA,EAAW,EAAE,MAAA,CAAO,CAAA,CAAE,QAAO,EAAG,cAAc,EAAE,QAAA;AAClD,CAAC,EACA,WAAA,EAAY;AAEf,IAAM,cAAA,GAAiB,EACpB,MAAA,CAAO;AAAA,EACN,GAAA,EAAK,gBAAgB,QAAA,EAAS;AAAA,EAC9B,IAAA,EAAM,gBAAgB,QAAA,EAAS;AAAA,EAC/B,GAAA,EAAK,gBAAgB,QAAA,EAAS;AAAA,EAC9B,KAAA,EAAO,gBAAgB,QAAA,EAAS;AAAA,EAChC,MAAA,EAAQ,gBAAgB,QAAA,EAAS;AAAA,EACjC,IAAA,EAAM,gBAAgB,QAAA,EAAS;AAAA,EAC/B,OAAA,EAAS,gBAAgB,QAAA,EAAS;AAAA,EAClC,UAAA,EAAY,CAAA,CAAE,KAAA,CAAM,eAAe,EAAE,QAAA;AACvC,CAAC,EACA,WAAA,EAAY;AAEf,IAAM,UAAA,GAAa,EAChB,MAAA,CAAO;AAAA,EACN,KAAA,EAAO,EAAE,MAAA,EAAO;AAAA,EAChB,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EACjC,OAAA,EAAS,EAAE,MAAA;AACb,CAAC,EACA,WAAA,EAAY;AAER,IAAM,aAAA,GAAgB,EAC1B,MAAA,CAAO;AAAA,EACN,OAAA,EAAS,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC7B,OAAA,EAAS,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC7B,IAAA,EAAM,UAAA;AAAA,EACN,KAAA,EAAO,EAAE,MAAA,CAAO,CAAA,CAAE,QAAO,EAAG,cAAc,EAAE,QAAA,EAAS;AAAA,EACrD,UAAA,EAAY,EACT,MAAA,CAAO;AAAA,IACN,OAAA,EAAS,EAAE,MAAA,CAAO,CAAA,CAAE,QAAO,EAAG,eAAe,EAAE,QAAA;AAAS,GACzD,CAAA,CACA,WAAA,EAAY,CACZ,QAAA;AACL,CAAC,EACA,WAAA;AASI,IAAM,eAAe,CAAC,KAAA,EAAO,MAAA,EAAQ,KAAA,EAAO,SAAS,QAAQ;;;AC5F7D,SAAS,aAAa,MAAA,EAA6B;AACxD,EAAA,IAAI,GAAA;AACJ,EAAA,IAAI;AACF,IAAA,GAAA,GAAMA,MAAU,MAAM,CAAA;AAAA,EACxB,SAAS,GAAA,EAAK;AACZ,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,qCAAA,EAAyC,GAAA,CAAc,OAAO,CAAA,CAAE,CAAA;AAAA,EAClF;AACA,EAAA,MAAM,MAAA,GAAS,aAAA,CAAc,SAAA,CAAU,GAAG,CAAA;AAC1C,EAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,IAAA,MAAM,MAAA,GAAS,OAAO,KAAA,CAAM,MAAA,CACzB,IAAI,CAAC,CAAA,KAAM,GAAG,CAAA,CAAE,IAAA,CAAK,KAAK,GAAG,CAAA,IAAK,QAAQ,CAAA,EAAA,EAAK,CAAA,CAAE,OAAO,CAAA,CAAE,CAAA,CAC1D,KAAK,IAAI,CAAA;AACZ,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,gCAAA,EAAmC,MAAM,CAAA,CAAE,CAAA;AAAA,EAC7D;AACA,EAAA,OAAO,MAAA,CAAO,IAAA;AAChB;;;ACDA,IAAM,YAAA,GAA2C;AAAA,EAC/C,GAAA,EAAK,CAAA;AAAA,EACL,IAAA,EAAM,CAAA;AAAA,EACN,GAAA,EAAK,CAAA;AAAA,EACL,KAAA,EAAO,CAAA;AAAA,EACP,MAAA,EAAQ;AACV,CAAA;AAQA,SAAS,iBAAiB,IAAA,EAA+B;AACvD,EAAA,MAAM,MAAkB,EAAC;AACzB,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,IAAS,EAAC;AAC7B,EAAA,KAAA,MAAW,QAAQ,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA,CAAE,MAAK,EAAG;AAC5C,IAAA,MAAM,IAAA,GAAO,MAAM,IAAI,CAAA;AACvB,IAAA,IAAI,SAAS,MAAA,EAAW;AACxB,IAAA,KAAA,MAAW,UAAU,YAAA,EAAc;AACjC,MAAA,MAAM,EAAA,GAAK,KAAK,MAAM,CAAA;AACtB,MAAA,IAAI,OAAO,MAAA,EAAW;AACtB,MAAA,GAAA,CAAI,IAAA,CAAK,EAAE,MAAA,EAAQ,IAAA,EAAM,IAAI,CAAA;AAAA,IAC/B;AAAA,EACF;AACA,EAAA,GAAA,CAAI,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM;AACjB,IAAA,MAAM,CAAA,GAAI,CAAA,CAAE,IAAA,CAAK,aAAA,CAAc,EAAE,IAAI,CAAA;AACrC,IAAA,IAAI,CAAA,KAAM,GAAG,OAAO,CAAA;AACpB,IAAA,OAAO,aAAa,CAAA,CAAE,MAAM,CAAA,GAAI,YAAA,CAAa,EAAE,MAAM,CAAA;AAAA,EACvD,CAAC,CAAA;AACD,EAAA,OAAO,GAAA;AACT;AAGA,SAAS,QAAQ,CAAA,EAAmB;AAClC,EAAA,OAAO,CAAA,CACJ,aAAY,CACZ,OAAA,CAAQ,eAAe,GAAG,CAAA,CAC1B,OAAA,CAAQ,UAAA,EAAY,EAAE,CAAA;AAC3B;AAEA,SAAS,UAAA,CAAW,MAAc,EAAA,EAAsB;AACtD,EAAA,OAAO,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,EAAA,CAAG,MAAM,IAAI,OAAA,CAAQ,EAAA,CAAG,IAAI,CAAA,IAAK,MAAM,CAAA,CAAA;AAC3D;AAGA,SAAS,WAAW,CAAA,EAAmB;AACrC,EAAA,OAAO,CAAA,CAAA,EAAI,EAAE,OAAA,CAAQ,KAAA,EAAO,MAAM,CAAA,CAAE,OAAA,CAAQ,IAAA,EAAM,KAAK,CAAC,CAAA,CAAA,CAAA;AAC1D;AAGA,SAAS,oBAAoB,SAAA,EAAwC;AACnE,EAAA,MAAM,IAAA,GAAO,SAAA,CACV,GAAA,CAAI,CAAC,EAAA,KAAO;AACX,IAAA,MAAM,OAAA,GAAA,CAAW,GAAG,EAAA,CAAG,OAAA,IAAW,IAAI,OAAA,CAAQ,MAAA,EAAQ,GAAG,CAAA,CAAE,IAAA,EAAK;AAChE,IAAA,OAAO,CAAA,KAAA,EAAQ,EAAA,CAAG,MAAA,CAAO,WAAA,EAAa,CAAA,EAAA,EAAK,UAAA,CAAW,EAAA,CAAG,IAAI,CAAC,CAAA,EAAA,EAAK,UAAA,CAAW,OAAO,CAAC,CAAA,CAAA,CAAA;AAAA,EACxF,CAAC,CAAA,CACA,IAAA,CAAK,IAAI,CAAA;AACZ,EAAA,OAAO,CAAC,YAAY,kCAAA,EAAoC,OAAA,EAAS,MAAM,KAAK,CAAA,CAAE,KAAK,IAAI,CAAA;AACzF;AAGA,SAAS,sBAAA,CAAuB,MAAc,EAAA,EAAsB;AAClE,EAAA,MAAM,EAAA,GAAK,UAAA,CAAW,IAAA,EAAM,EAAE,CAAA;AAC9B,EAAA,MAAM,KAAA,GAAA,CAAS,EAAA,CAAG,EAAA,CAAG,OAAA,IAAW,CAAA,EAAG,EAAA,CAAG,MAAA,CAAO,WAAA,EAAa,CAAA,CAAA,EAAI,EAAA,CAAG,IAAI,IAAI,IAAA,EAAK;AAC9E,EAAA,MAAM,IAAA,GAAA,CAAQ,GAAG,EAAA,CAAG,WAAA,IAAe,IAAI,OAAA,CAAQ,MAAA,EAAQ,GAAG,CAAA,CAAE,IAAA,EAAK;AACjE,EAAA,MAAM,SAAA,GAAY,EAAA,CAAG,EAAA,CAAG,SAAA,IAAa,EAAC;AACtC,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,CAAK,SAAS,EAAE,IAAA,EAAK;AAC1C,EAAA,MAAM,OAAA,GAAU,MAAM,MAAA,CAAO,CAAC,MAAM,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAC,CAAA;AACnD,EAAA,MAAM,QAAA,GAAW,MAAM,MAAA,CAAO,CAAC,MAAM,QAAA,CAAS,IAAA,CAAK,CAAC,CAAC,CAAA;AAErD,EAAA,MAAM,KAAA,GAAkB;AAAA,IACtB,aAAA;AAAA,IACA,OAAO,EAAE,CAAA,CAAA;AAAA,IACT,CAAA,OAAA,EAAU,UAAA,CAAW,KAAK,CAAC,CAAA;AAAA,GAC7B;AACA,EAAA,IAAI,IAAA,CAAK,SAAS,CAAA,EAAG,KAAA,CAAM,KAAK,CAAA,aAAA,EAAgB,UAAA,CAAW,IAAI,CAAC,CAAA,CAAE,CAAA;AAClE,EAAA,KAAA,CAAM,IAAA,CAAK,CAAA,oBAAA,EAAuB,EAAA,CAAG,MAAA,CAAO,WAAA,EAAa,CAAA,QAAA,EAAW,UAAA,CAAW,EAAA,CAAG,IAAI,CAAC,CAAA,EAAA,CAAI,CAAA;AAC3F,EAAA,KAAA,CAAM,KAAK,SAAS,CAAA;AACpB,EAAA,KAAA,CAAM,KAAK,kCAAkC,CAAA;AAC7C,EAAA,KAAA,CAAM,KAAK,4BAA4B,CAAA;AACvC,EAAA,KAAA,CAAM,KAAK,WAAW,CAAA;AACtB,EAAA,KAAA,CAAM,IAAA;AAAA,IACJ,CAAA,oCAAA,EAAuC,UAAA,CAAW,CAAA,EAAG,EAAA,CAAG,MAAA,CAAO,WAAA,EAAa,CAAA,CAAA,EAAI,EAAA,CAAG,IAAI,CAAA,CAAE,CAAC,CAAA,cAAA;AAAA,GAC5F;AACA,EAAA,KAAA,MAAW,QAAQ,OAAA,EAAS;AAC1B,IAAA,MAAM,OAAA,GAAA,CAAW,SAAA,CAAU,IAAI,CAAA,EAAG,WAAA,IAAe,IAAI,OAAA,CAAQ,MAAA,EAAQ,GAAG,CAAA,CAAE,IAAA,EAAK;AAC/E,IAAA,MAAM,KAAA,GAAQ,QAAQ,MAAA,GAAS,CAAA,GAAI,GAAG,IAAI,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA,GAAK,IAAA;AAC1D,IAAA,KAAA,CAAM,IAAA,CAAK,CAAA,oCAAA,EAAuC,UAAA,CAAW,KAAK,CAAC,CAAA,kBAAA,CAAoB,CAAA;AAAA,EACzF;AACA,EAAA,KAAA,MAAW,QAAQ,QAAA,EAAU;AAC3B,IAAA,MAAM,OAAA,GAAA,CAAW,SAAA,CAAU,IAAI,CAAA,EAAG,WAAA,IAAe,IAAI,OAAA,CAAQ,MAAA,EAAQ,GAAG,CAAA,CAAE,IAAA,EAAK;AAC/E,IAAA,MAAM,KAAA,GAAQ,QAAQ,MAAA,GAAS,CAAA,GAAI,GAAG,IAAI,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA,GAAK,IAAA;AAC1D,IAAA,KAAA,CAAM,IAAA,CAAK,CAAA,oCAAA,EAAuC,UAAA,CAAW,KAAK,CAAC,CAAA,eAAA,CAAiB,CAAA;AAAA,EACtF;AACA,EAAA,KAAA,CAAM,KAAK,KAAK,CAAA;AAChB,EAAA,OAAO,KAAA,CAAM,KAAK,IAAI,CAAA;AACxB;AASA,IAAM,oBAAA,GAA+C;AAAA,EACnD,OAAA,EAAS,KAAA;AAAA,EACT,MAAA,EAAQ,QAAA;AAAA,EACR,MAAA,EAAQ,QAAA;AAAA,EACR,OAAA,EAAS;AACX,CAAA;AAEA,SAAS,eAAA,CAAgB,MAAA,EAAuB,QAAA,EAA8B,UAAA,EAA8B;AAC1G,EAAA,MAAM,IAAK,UAAA,IAA4C,MAAA;AACvD,EAAA,IAAI,CAAA,CAAE,SAAS,MAAA,EAAW;AACxB,IAAA,MAAM,IAAA,GAAO,OAAO,CAAA,CAAE,IAAI,EAAE,KAAA,CAAM,GAAG,CAAA,CAAE,GAAA,EAAI,IAAK,KAAA;AAChD,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,MAAM,CAAA,CAAE,MAAA;AACd,EAAA,IAAI,GAAA,KAAQ,QAAQ,OAAO,MAAA;AAC3B,EAAA,IAAI,GAAA,KAAQ,WAAA,IAAe,GAAA,KAAQ,MAAA,EAAQ,OAAO,WAAA;AAClD,EAAA,IAAI,CAAA,CAAE,SAAS,OAAA,EAAS;AACtB,IAAA,MAAM,QAAQ,CAAA,CAAE,KAAA;AAChB,IAAA,OAAO,CAAA,EAAG,UAAU,MAAA,GAAY,eAAA,CAAgB,GAAG,QAAA,EAAU,KAAK,IAAI,KAAK,CAAA,EAAA,CAAA;AAAA,EAC7E;AACA,EAAA,IAAI,OAAO,CAAA,CAAE,IAAA,KAAS,QAAA,EAAU;AAC9B,IAAA,OAAO,oBAAA,CAAqB,CAAA,CAAE,IAAI,CAAA,IAAK,CAAA,CAAE,IAAA;AAAA,EAC3C;AACA,EAAA,OAAO,KAAA;AACT;AAEA,SAAS,eAAe,MAAA,EAAqC;AAC3D,EAAA,MAAM,MAAoB,EAAC;AAC3B,EAAA,MAAM,WAAW,IAAI,GAAA,CAAI,MAAA,CAAO,QAAA,IAAY,EAAE,CAAA;AAC9C,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,UAAA,IAAc,EAAC;AACpC,EAAA,KAAA,MAAW,IAAA,IAAQ,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA,EAAG;AACrC,IAAA,MAAM,UAAA,GAAa,MAAM,IAAI,CAAA;AAC7B,IAAA,IAAI,eAAe,MAAA,EAAW;AAC9B,IAAA,MAAM,IAAA,GAAO,eAAA,CAAgB,MAAA,EAAQ,IAAA,EAAM,UAAU,CAAA;AACrD,IAAA,MAAM,KAAK,IAAA,KAAS,IAAA;AACpB,IAAA,MAAM,EAAA,GAAK,CAAC,EAAA,IAAM,OAAA,CAAQ,KAAK,IAAI,CAAA;AACnC,IAAA,GAAA,CAAI,IAAA,CAAK;AAAA,MACP,IAAA;AAAA,MACA,MAAM,QAAA,CAAS,GAAA,CAAI,IAAI,CAAA,GAAI,IAAA,GAAO,GAAG,IAAI,CAAA,CAAA,CAAA;AAAA,MACzC,EAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AACA,EAAA,OAAO,GAAA;AACT;AAGA,SAAS,gBAAA,CAAiB,MAAc,IAAA,EAA2B;AACjE,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,UAAA,EAAY,OAAA,IAAW,EAAC;AAC7C,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,CAAK,OAAO,EAAE,IAAA,EAAK;AACxC,EAAA,IAAI,KAAA,CAAM,MAAA,KAAW,CAAA,EAAG,OAAO,EAAA;AAC/B,EAAA,MAAM,WAAA,GAAwB,CAAC,WAAW,CAAA;AAC1C,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,MAAM,MAAA,GAAS,QAAQ,IAAI,CAAA;AAC3B,IAAA,IAAI,MAAA,KAAW,MAAA,IAAa,MAAA,CAAO,IAAA,KAAS,QAAA,EAAU;AACtD,IAAA,MAAM,IAAA,GAAO,eAAe,MAAM,CAAA;AAClC,IAAA,IAAI,IAAA,CAAK,WAAW,CAAA,EAAG;AACvB,IAAA,WAAA,CAAY,IAAA,CAAK,CAAA,UAAA,EAAa,IAAI,CAAA,CAAE,CAAA;AACpC,IAAA,WAAA,CAAY,KAAK,cAAc,CAAA;AAC/B,IAAA,KAAA,MAAW,KAAK,IAAA,EAAM;AACpB,MAAA,MAAM,QAAkB,EAAC;AACzB,MAAA,IAAI,CAAA,CAAE,EAAA,EAAI,KAAA,CAAM,IAAA,CAAK,UAAU,CAAA;AAC/B,MAAA,IAAI,CAAA,CAAE,EAAA,EAAI,KAAA,CAAM,IAAA,CAAK,UAAU,CAAA;AAC/B,MAAA,MAAM,IAAA,GAAO,MAAM,MAAA,GAAS,CAAA,GAAI,KAAK,KAAA,CAAM,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA,GAAK,EAAA;AAC1D,MAAA,WAAA,CAAY,IAAA,CAAK,CAAA,gBAAA,EAAmB,CAAA,CAAE,IAAI,CAAA,QAAA,EAAW,UAAA,CAAW,CAAA,CAAE,IAAI,CAAC,CAAA,EAAG,IAAI,CAAA,EAAA,CAAI,CAAA;AAAA,IACpF;AAAA,EACF;AACA,EAAA,IAAI,WAAA,CAAY,MAAA,KAAW,CAAA,EAAG,OAAO,EAAA;AACrC,EAAA,OAAO,CAAC,QAAA,EAAU,CAAA,IAAA,EAAO,IAAI,CAAA,QAAA,CAAA,EAAY,GAAG,WAAA,EAAa,KAAK,CAAA,CAAE,IAAA,CAAK,IAAI,CAAA;AAC3E;AASO,SAAS,iBAAA,CAAkB,IAAA,EAAmB,IAAA,GAAwB,EAAC,EAAW;AACvF,EAAA,MAAM,IAAA,GAAO,KAAK,IAAA,IAAQ,KAAA;AAC1B,EAAA,MAAM,SAAA,GAAY,iBAAiB,IAAI,CAAA;AACvC,EAAA,MAAM,WAAA,GAAA,CAAe,IAAA,CAAK,IAAA,CAAK,WAAA,IAAe,IAAI,IAAA,EAAK;AAEvD,EAAA,MAAM,MAAgB,EAAC;AAEvB,EAAA,GAAA,CAAI,IAAA;AAAA,IACF,SAAA;AAAA,IACA,CAAA,OAAA,EAAU,UAAA,CAAW,IAAA,CAAK,IAAA,CAAK,KAAK,CAAC,CAAA,CAAA;AAAA,IACrC,WAAA,CAAY,MAAA,GAAS,CAAA,GACjB,CAAA,UAAA,EAAa,UAAA,CAAW,WAAA,CAAY,KAAA,CAAM,OAAO,CAAA,CAAE,CAAC,CAAA,IAAK,EAAE,CAAC,CAAA,CAAA,GAC5D,EAAA;AAAA,IACJ,QAAQ,UAAA,CAAW,CAAA,UAAA,EAAU,KAAK,IAAA,CAAK,OAAO,EAAE,CAAC,CAAA,CAAA;AAAA,IACjD;AAAA,GACF;AAEA,EAAA,IAAI,WAAA,CAAY,SAAS,CAAA,EAAG;AAC1B,IAAA,GAAA,CAAI,IAAA,CAAK,EAAA,EAAI,aAAA,EAAe,EAAA,EAAI,WAAW,CAAA;AAAA,EAC7C;AAEA,EAAA,IAAI,SAAA,CAAU,SAAS,CAAA,EAAG;AACxB,IAAA,GAAA,CAAI,KAAK,EAAA,EAAI,cAAA,EAAgB,EAAA,EAAI,mBAAA,CAAoB,SAAS,CAAC,CAAA;AAAA,EACjE;AAEA,EAAA,KAAA,MAAW,MAAM,SAAA,EAAW;AAC1B,IAAA,GAAA,CAAI,IAAA,CAAK,EAAA,EAAI,CAAA,GAAA,EAAM,EAAA,CAAG,OAAO,WAAA,EAAa,CAAA,CAAA,EAAI,EAAA,CAAG,IAAI,CAAA,CAAA,EAAI,EAAA,EAAI,sBAAA,CAAuB,IAAA,EAAM,EAAE,CAAC,CAAA;AAAA,EAC/F;AAEA,EAAA,MAAM,GAAA,GAAM,gBAAA,CAAiB,IAAA,EAAM,IAAI,CAAA;AACvC,EAAA,IAAI,GAAA,CAAI,SAAS,CAAA,EAAG;AAClB,IAAA,GAAA,CAAI,IAAA,CAAK,EAAA,EAAI,YAAA,EAAc,EAAA,EAAI,GAAG,CAAA;AAAA,EACpC;AAGA,EAAA,MAAM,OAAA,GAAU,GAAA,CAAI,MAAA,CAAO,CAAC,GAAG,CAAA,EAAG,CAAA,KAAM,EAAE,CAAA,KAAM,EAAA,IAAM,CAAA,CAAE,CAAA,GAAI,CAAC,MAAM,EAAA,CAAG,CAAA;AACtE,EAAA,OAAO,QAAQ,IAAA,CAAK,IAAI,EAAE,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAA,GAAI,IAAA;AAClD","file":"index.js","sourcesContent":["/**\n * Minimal zod schemas for the OpenAPI 3.x subset we actually use during\n * generation. Anything not listed here is allowed via `passthrough` so we\n * don't fail on extra fields the spec author put in.\n */\n\nimport { z } from 'zod';\n\nconst refSchema = z.object({ $ref: z.string() }).passthrough();\n\nconst propertySchema: z.ZodType = z.lazy(() =>\n  z\n    .object({\n      type: z.string().optional(),\n      format: z.string().optional(),\n      description: z.string().optional(),\n      enum: z.array(z.unknown()).optional(),\n      items: z.union([refSchema, propertySchema]).optional(),\n      properties: z.record(z.string(), z.union([refSchema, propertySchema])).optional(),\n      required: z.array(z.string()).optional(),\n      example: z.unknown().optional(),\n      $ref: z.string().optional(),\n    })\n    .passthrough(),\n);\n\nconst componentSchema = z\n  .object({\n    type: z.string().optional(),\n    description: z.string().optional(),\n    properties: z.record(z.string(), z.union([refSchema, propertySchema])).optional(),\n    required: z.array(z.string()).optional(),\n    enum: z.array(z.unknown()).optional(),\n    allOf: z.array(z.union([refSchema, propertySchema])).optional(),\n  })\n  .passthrough();\n\nconst responseSchema = z\n  .object({\n    description: z.string().optional(),\n    content: z.record(z.string(), z.unknown()).optional(),\n  })\n  .passthrough();\n\nconst parameterSchema = z\n  .object({\n    name: z.string(),\n    in: z.string(),\n    required: z.boolean().optional(),\n    description: z.string().optional(),\n    schema: z.union([refSchema, propertySchema]).optional(),\n  })\n  .passthrough();\n\nconst operationSchema = z\n  .object({\n    operationId: z.string().optional(),\n    summary: z.string().optional(),\n    description: z.string().optional(),\n    tags: z.array(z.string()).optional(),\n    parameters: z.array(parameterSchema).optional(),\n    requestBody: z.unknown().optional(),\n    responses: z.record(z.string(), responseSchema).optional(),\n  })\n  .passthrough();\n\nconst pathItemSchema = z\n  .object({\n    get: operationSchema.optional(),\n    post: operationSchema.optional(),\n    put: operationSchema.optional(),\n    patch: operationSchema.optional(),\n    delete: operationSchema.optional(),\n    head: operationSchema.optional(),\n    options: operationSchema.optional(),\n    parameters: z.array(parameterSchema).optional(),\n  })\n  .passthrough();\n\nconst infoSchema = z\n  .object({\n    title: z.string(),\n    description: z.string().optional(),\n    version: z.string(),\n  })\n  .passthrough();\n\nexport const openApiSchema = z\n  .object({\n    openapi: z.string().optional(),\n    swagger: z.string().optional(),\n    info: infoSchema,\n    paths: z.record(z.string(), pathItemSchema).optional(),\n    components: z\n      .object({\n        schemas: z.record(z.string(), componentSchema).optional(),\n      })\n      .passthrough()\n      .optional(),\n  })\n  .passthrough();\n\n/** Parsed OpenAPI spec (validated subset). */\nexport type OpenApiSpec = z.infer<typeof openApiSchema>;\nexport type OpenApiOperation = z.infer<typeof operationSchema>;\nexport type OpenApiSchema = z.infer<typeof componentSchema>;\nexport type OpenApiParameter = z.infer<typeof parameterSchema>;\n\n/** HTTP methods we generate sequences for. */\nexport const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete'] as const;\nexport type HttpMethod = (typeof HTTP_METHODS)[number];\n","/**\n * Parses an OpenAPI 3.x spec from a YAML or JSON string and validates it\n * against {@link openApiSchema}. Returns the typed spec or throws with a\n * structured message.\n */\n\nimport { parse as yamlParse } from 'yaml';\nimport { openApiSchema, type OpenApiSpec } from './schemas.js';\n\n/**\n * Parses + validates an OpenAPI spec.\n *\n * @param source - YAML or JSON source string.\n * @returns The validated spec.\n * @throws If the source isn't valid YAML/JSON or doesn't match the OpenAPI\n *   subset we support.\n */\nexport function parseOpenApi(source: string): OpenApiSpec {\n  let raw: unknown;\n  try {\n    raw = yamlParse(source) as unknown;\n  } catch (err) {\n    throw new Error(`OpenAPI spec is not valid YAML/JSON: ${(err as Error).message}`);\n  }\n  const result = openApiSchema.safeParse(raw);\n  if (!result.success) {\n    const issues = result.error.issues\n      .map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`)\n      .join('; ');\n    throw new Error(`OpenAPI spec failed validation: ${issues}`);\n  }\n  return result.data;\n}\n","/**\n * Converts an OpenAPI spec into Avodado markdown.\n *\n * The output is **deterministic**: same spec in → same markdown out. That\n * makes drift detection a simple string compare.\n *\n * The doc contains:\n * - `meta` block (title / subtitle / tag from `info`)\n * - `prose` block with the API description\n * - `table` block listing every endpoint\n * - one `sequence` block per endpoint\n * - `erd` block from `components.schemas`\n */\n\nimport {\n  HTTP_METHODS,\n  type HttpMethod,\n  type OpenApiOperation,\n  type OpenApiSchema,\n  type OpenApiSpec,\n} from './schemas.js';\n\n/** Options for {@link openapiToMarkdown}. */\nexport interface GenerateOptions {\n  /**\n   * The doc slug — also drives generated block ids (e.g. `<slug>-post-orders`).\n   * Defaults to `api`.\n   */\n  readonly slug?: string;\n}\n\nconst METHOD_ORDER: Record<HttpMethod, number> = {\n  get: 0,\n  post: 1,\n  put: 2,\n  patch: 3,\n  delete: 4,\n};\n\ninterface Endpoint {\n  readonly method: HttpMethod;\n  readonly path: string;\n  readonly op: OpenApiOperation;\n}\n\nfunction collectEndpoints(spec: OpenApiSpec): Endpoint[] {\n  const out: Endpoint[] = [];\n  const paths = spec.paths ?? {};\n  for (const path of Object.keys(paths).sort()) {\n    const item = paths[path];\n    if (item === undefined) continue;\n    for (const method of HTTP_METHODS) {\n      const op = item[method];\n      if (op === undefined) continue;\n      out.push({ method, path, op });\n    }\n  }\n  out.sort((a, b) => {\n    const p = a.path.localeCompare(b.path);\n    if (p !== 0) return p;\n    return METHOD_ORDER[a.method] - METHOD_ORDER[b.method];\n  });\n  return out;\n}\n\n/** Sanitises an arbitrary string into a slug-safe id segment. */\nfunction slugify(s: string): string {\n  return s\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '');\n}\n\nfunction endpointId(slug: string, ep: Endpoint): string {\n  return `${slug}-${ep.method}-${slugify(ep.path) || 'root'}`;\n}\n\n/** Escapes a string for safe use inside a single-line YAML scalar. */\nfunction yamlString(s: string): string {\n  return `\"${s.replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"')}\"`;\n}\n\n/** Renders the endpoint table block. */\nfunction renderEndpointTable(endpoints: readonly Endpoint[]): string {\n  const rows = endpoints\n    .map((ep) => {\n      const summary = (ep.op.summary ?? '').replace(/\\s+/g, ' ').trim();\n      return `  - [${ep.method.toUpperCase()}, ${yamlString(ep.path)}, ${yamlString(summary)}]`;\n    })\n    .join('\\n');\n  return ['```table', 'columns: [Method, Path, Summary]', 'rows:', rows, '```'].join('\\n');\n}\n\n/** Renders the `sequence` block for one endpoint. */\nfunction renderEndpointSequence(slug: string, ep: Endpoint): string {\n  const id = endpointId(slug, ep);\n  const title = (ep.op.summary ?? `${ep.method.toUpperCase()} ${ep.path}`).trim();\n  const desc = (ep.op.description ?? '').replace(/\\s+/g, ' ').trim();\n  const responses = ep.op.responses ?? {};\n  const codes = Object.keys(responses).sort();\n  const okCodes = codes.filter((c) => /^[12]/.test(c));\n  const errCodes = codes.filter((c) => /^[345]/.test(c));\n\n  const lines: string[] = [\n    '```sequence',\n    `id: ${id}`,\n    `title: ${yamlString(title)}`,\n  ];\n  if (desc.length > 0) lines.push(`description: ${yamlString(desc)}`);\n  lines.push(`endpoint: { method: ${ep.method.toUpperCase()}, path: ${yamlString(ep.path)} }`);\n  lines.push('actors:');\n  lines.push('  - { id: Client, name: Client }');\n  lines.push('  - { id: API, name: API }');\n  lines.push('messages:');\n  lines.push(\n    `  - { from: Client, to: API, label: ${yamlString(`${ep.method.toUpperCase()} ${ep.path}`)}, kind: sync }`,\n  );\n  for (const code of okCodes) {\n    const summary = (responses[code]?.description ?? '').replace(/\\s+/g, ' ').trim();\n    const label = summary.length > 0 ? `${code} ${summary}` : code;\n    lines.push(`  - { from: API, to: Client, label: ${yamlString(label)}, kind: response }`);\n  }\n  for (const code of errCodes) {\n    const summary = (responses[code]?.description ?? '').replace(/\\s+/g, ' ').trim();\n    const label = summary.length > 0 ? `${code} ${summary}` : code;\n    lines.push(`  - { from: API, to: Client, label: ${yamlString(label)}, kind: error }`);\n  }\n  lines.push('```');\n  return lines.join('\\n');\n}\n\ninterface ColumnSpec {\n  readonly name: string;\n  readonly type: string;\n  readonly pk: boolean;\n  readonly fk: boolean;\n}\n\nconst PRIMITIVE_TYPE_REMAP: Record<string, string> = {\n  integer: 'int',\n  number: 'number',\n  string: 'string',\n  boolean: 'bool',\n};\n\nfunction schemaTypeLabel(schema: OpenApiSchema, propName: string | undefined, propSchema?: unknown): string {\n  const s = (propSchema as OpenApiSchema | undefined) ?? schema;\n  if (s.$ref !== undefined) {\n    const name = String(s.$ref).split('/').pop() ?? 'ref';\n    return name;\n  }\n  const fmt = s.format;\n  if (fmt === 'uuid') return 'uuid';\n  if (fmt === 'date-time' || fmt === 'date') return 'timestamp';\n  if (s.type === 'array') {\n    const items = s.items as OpenApiSchema | undefined;\n    return `${items !== undefined ? schemaTypeLabel(s, propName, items) : 'any'}[]`;\n  }\n  if (typeof s.type === 'string') {\n    return PRIMITIVE_TYPE_REMAP[s.type] ?? s.type;\n  }\n  return 'any';\n}\n\nfunction flattenColumns(schema: OpenApiSchema): ColumnSpec[] {\n  const out: ColumnSpec[] = [];\n  const required = new Set(schema.required ?? []);\n  const props = schema.properties ?? {};\n  for (const name of Object.keys(props)) {\n    const propSchema = props[name] as OpenApiSchema | undefined;\n    if (propSchema === undefined) continue;\n    const type = schemaTypeLabel(schema, name, propSchema);\n    const pk = name === 'id';\n    const fk = !pk && /_id$/i.test(name);\n    out.push({\n      name,\n      type: required.has(name) ? type : `${type}?`,\n      pk,\n      fk,\n    });\n  }\n  return out;\n}\n\n/** Renders the `erd` block from `components.schemas`. */\nfunction renderSchemasErd(slug: string, spec: OpenApiSpec): string {\n  const schemas = spec.components?.schemas ?? {};\n  const names = Object.keys(schemas).sort();\n  if (names.length === 0) return '';\n  const entityLines: string[] = ['entities:'];\n  for (const name of names) {\n    const schema = schemas[name];\n    if (schema === undefined || schema.type !== 'object') continue;\n    const cols = flattenColumns(schema);\n    if (cols.length === 0) continue;\n    entityLines.push(`  - name: ${name}`);\n    entityLines.push('    columns:');\n    for (const c of cols) {\n      const flags: string[] = [];\n      if (c.pk) flags.push('pk: true');\n      if (c.fk) flags.push('fk: true');\n      const tail = flags.length > 0 ? `, ${flags.join(', ')}` : '';\n      entityLines.push(`      - { name: ${c.name}, type: ${yamlString(c.type)}${tail} }`);\n    }\n  }\n  if (entityLines.length === 1) return '';\n  return ['```erd', `id: ${slug}-schemas`, ...entityLines, '```'].join('\\n');\n}\n\n/**\n * Generates an Avodado markdown document from an OpenAPI spec.\n *\n * @param spec - The parsed OpenAPI spec.\n * @param opts - Options including the doc slug.\n * @returns The markdown source.\n */\nexport function openapiToMarkdown(spec: OpenApiSpec, opts: GenerateOptions = {}): string {\n  const slug = opts.slug ?? 'api';\n  const endpoints = collectEndpoints(spec);\n  const description = (spec.info.description ?? '').trim();\n\n  const out: string[] = [];\n\n  out.push(\n    '```meta',\n    `title: ${yamlString(spec.info.title)}`,\n    description.length > 0\n      ? `subtitle: ${yamlString(description.split(/\\r?\\n/)[0] ?? '')}`\n      : '',\n    `tag: ${yamlString(`API · v${spec.info.version}`)}`,\n    '```',\n  );\n\n  if (description.length > 0) {\n    out.push('', '## Overview', '', description);\n  }\n\n  if (endpoints.length > 0) {\n    out.push('', '## Endpoints', '', renderEndpointTable(endpoints));\n  }\n\n  for (const ep of endpoints) {\n    out.push('', `## ${ep.method.toUpperCase()} ${ep.path}`, '', renderEndpointSequence(slug, ep));\n  }\n\n  const erd = renderSchemasErd(slug, spec);\n  if (erd.length > 0) {\n    out.push('', '## Schemas', '', erd);\n  }\n\n  // Strip empty lines from the meta block (description was empty).\n  const cleaned = out.filter((s, i, a) => !(s === '' && a[i - 1] === ''));\n  return cleaned.join('\\n').replace(/\\n+$/, '') + '\\n';\n}\n"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@avodado/sync",
+  "version": "0.0.1",
+  "description": "Import external sources (OpenAPI, SQL DDL) into Avodado documents.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "yaml": "^2.6.1",
+    "zod": "^3.24.1",
+    "@avodado/core": "0.0.1"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jdiejim/avodado.git",
+    "directory": "packages/sync"
+  },
+  "homepage": "https://github.com/jdiejim/avodado#readme",
+  "bugs": "https://github.com/jdiejim/avodado/issues",
+  "keywords": [
+    "avodado",
+    "documentation",
+    "docs-as-code",
+    "markdown",
+    "openapi",
+    "codegen"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}