@xyd-js/opencli2go 0.1.0-build.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../index.ts","../src/golit.ts","../src/flags.ts","../src/naming.ts","../src/model.ts","../src/handler.ts","../src/command.ts","../src/main.ts","../src/runtime.ts","../src/project.ts","../src/write.ts"],"sourcesContent":["export * from './src';\n","// Tiny Go-source string helpers (fern's CLI-generator style): just enough to\n// render struct/slice literals with correct indentation — not a full AST.\n\nconst TAB = '\\t';\nconst pad = (n: number) => TAB.repeat(n);\n\n/** A value renderer: its first line is emitted inline; nested lines indent to `indent`. */\nexport type GoVal = (indent: number) => string;\n\n/** A pre-rendered scalar (identifier, number, bool, expression). */\nexport const lit = (s: string): GoVal => () => s;\n\n/** A Go double-quoted string literal (JSON escaping is valid Go for our content). */\nexport const goStr = (s: string): GoVal => () => JSON.stringify(s);\n\nexport const goBool = (b: boolean): GoVal => () => String(b);\nexport const goInt = (n: number): GoVal => () => String(n);\n\n/** A struct literal: `Type{ Field: value, ... }` (prefix `&` when pointer). */\nexport function goStruct(type: string, fields: [string, GoVal][], pointer = false): GoVal {\n  return (indent: number) => {\n    const head = `${pointer ? '&' : ''}${type}{`;\n    if (fields.length === 0) return `${head}}`;\n    let out = `${head}\\n`;\n    for (const [k, v] of fields) {\n      out += `${pad(indent + 1)}${k}: ${v(indent + 1)},\\n`;\n    }\n    out += `${pad(indent)}}`;\n    return out;\n  };\n}\n\n/** A slice literal: `[]Elem{ a, b, ... }`. */\nexport function goSlice(elemType: string, elems: GoVal[]): GoVal {\n  return (indent: number) => {\n    if (elems.length === 0) return `[]${elemType}{}`;\n    let out = `[]${elemType}{\\n`;\n    for (const e of elems) {\n      out += `${pad(indent + 1)}${e(indent + 1)},\\n`;\n    }\n    out += `${pad(indent)}}`;\n    return out;\n  };\n}\n\n/** Render a top-level declaration value (indent 0). */\nexport function render(v: GoVal): string {\n  return v(0);\n}\n\n/** Tracks the import paths a file needs. Qualifiers are implied by the emitted code. */\nexport class Imports {\n  private paths = new Set<string>();\n\n  add(...importPaths: string[]): this {\n    for (const p of importPaths) this.paths.add(p);\n    return this;\n  }\n\n  get size(): number {\n    return this.paths.size;\n  }\n\n  render(): string {\n    if (this.paths.size === 0) return '';\n    const all = [...this.paths];\n    const std = all.filter((p) => !p.split('/')[0].includes('.')).sort();\n    const ext = all.filter((p) => p.split('/')[0].includes('.')).sort();\n    const groups = [std, ext].filter((g) => g.length > 0);\n    const block = groups.map((g) => g.map((p) => `${TAB}${JSON.stringify(p)}`).join('\\n')).join('\\n\\n');\n    return `import (\\n${block}\\n)`;\n  }\n}\n\n/** Assemble a complete Go file: package clause + imports + declarations. */\nexport function goFile(pkg: string, imports: Imports, decls: string[]): string {\n  const parts = [`package ${pkg}`];\n  if (imports.size > 0) parts.push(imports.render());\n  parts.push(...decls);\n  return `${parts.join('\\n\\n')}\\n`;\n}\n","import { goBool, goSlice, goStr, goStruct, type GoVal } from './golit';\nimport type { FlagModel, GoType } from './model';\n\nconst FLAG_TYPE: Record<GoType, string> = {\n  bool: 'BoolFlag',\n  int: 'IntFlag',\n  float: 'FloatFlag',\n  slice: 'StringSliceFlag',\n  string: 'StringFlag',\n  json: 'StringFlag',\n  file: 'StringFlag',\n};\n\nexport function renderFlag(f: FlagModel): GoVal {\n  const type = `cli.${FLAG_TYPE[f.goType]}`;\n  const fields: [string, GoVal][] = [['Name', goStr(f.flagName)]];\n  if (f.aliases.length) fields.push(['Aliases', goSlice('string', f.aliases.map(goStr))]);\n  if (f.description) fields.push(['Usage', goStr(f.description)]);\n  if (f.required) fields.push(['Required', goBool(true)]);\n  if (f.hidden) fields.push(['Hidden', goBool(true)]);\n  return goStruct(type, fields, true);\n}\n\nexport function renderFlags(flags: FlagModel[]): GoVal[] {\n  return flags.map(renderFlag);\n}\n","/** Split an identifier (camel/snake/kebab/space) into lowercase words. */\nexport function splitWords(input: string): string[] {\n  return input\n    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')\n    .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')\n    .split(/[\\s_\\-./]+/)\n    .map((w) => w.trim().toLowerCase())\n    .filter(Boolean);\n}\n\n/** PascalCase, e.g. \"chat-completions\" → \"ChatCompletions\". */\nexport function pascalCase(input: string): string {\n  return splitWords(input)\n    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))\n    .join('');\n}\n\n/** lowerCamelCase Go variable name, e.g. \"store-id\" → \"storeID\". */\nexport function goVar(input: string): string {\n  const pascal = pascalCase(input);\n  if (!pascal) return 'arg';\n  let name = pascal.charAt(0).toLowerCase() + pascal.slice(1);\n  // Common Go initialism cleanup for ergonomics.\n  name = name.replace(/Id\\b/g, 'ID').replace(/Url\\b/g, 'URL').replace(/Api\\b/g, 'API');\n  // Avoid Go keywords.\n  if (GO_KEYWORDS.has(name)) name = `${name}_`;\n  return name;\n}\n\n/** Slug for a binary / module name. */\nexport function slug(input: string): string {\n  return splitWords(input).join('-').replace(/[^a-z0-9-]/g, '');\n}\n\n/** SCREAMING_SNAKE_CASE env-var prefix. */\nexport function screamingSnakeCase(input: string): string {\n  return splitWords(input).join('_').toUpperCase().replace(/[^A-Z0-9_]/g, '');\n}\n\nconst GO_KEYWORDS = new Set([\n  'break', 'case', 'chan', 'const', 'continue', 'default', 'defer', 'else', 'fallthrough',\n  'for', 'func', 'go', 'goto', 'if', 'import', 'interface', 'map', 'package', 'range',\n  'return', 'select', 'struct', 'switch', 'type', 'var',\n]);\n","import type { Command, Option, XOpenApiCommand } from '@xyd-js/opencli';\n\nimport { goVar } from './naming';\n\nexport type GoType = 'string' | 'int' | 'float' | 'bool' | 'slice' | 'json' | 'file';\n\nexport interface PathArg {\n  goVar: string;\n  wireName: string;\n  idx: number;\n}\n\nexport interface FlagModel {\n  flagName: string;\n  wireName: string;\n  location: 'query' | 'header' | 'cookie' | 'body';\n  goType: GoType;\n  required: boolean;\n  hidden: boolean;\n  aliases: string[];\n  description?: string;\n}\n\nexport interface LeafModel {\n  method: string; // uppercase HTTP method\n  path: string;\n  pathArgs: PathArg[];\n  flags: FlagModel[];\n  hasBody: boolean;\n  bodyStyle?: string; // 'flatten' | 'json' | 'multipart'\n  bodyJsonOption?: string; // flag name when the whole body is one JSON option (style=json)\n}\n\nfunction fromToken(from: string | undefined, kind: 'option' | 'argument'): string | undefined {\n  if (!from) return undefined;\n  const [k, ...rest] = from.split(':');\n  return k === kind ? rest.join(':') : undefined;\n}\n\nfunction encodingToGoType(encoding: string | undefined): GoType | undefined {\n  switch (encoding) {\n    case 'integer':\n      return 'int';\n    case 'number':\n      return 'float';\n    case 'boolean':\n      return 'bool';\n    case 'array':\n      return 'slice';\n    case 'json':\n      return 'json';\n    case 'file':\n      return 'file';\n    case 'string':\n      return 'string';\n    default:\n      return undefined;\n  }\n}\n\nfunction optionGoType(opt: Option, encoding?: string): GoType {\n  if (!opt.arguments || opt.arguments.length === 0) return 'bool';\n  const fromEncoding = encodingToGoType(encoding);\n  if (fromEncoding) return fromEncoding;\n  const arg = opt.arguments[0];\n  if (arg.arity) return 'slice';\n  switch (arg.name) {\n    case 'integer':\n      return 'int';\n    case 'number':\n      return 'float';\n    case 'boolean':\n      return 'bool';\n    case 'json':\n      return 'json';\n    default:\n      return 'string';\n  }\n}\n\n/** Build the normalized request model for a leaf command from its x-openapi binding. */\nexport function buildLeafModel(command: Command): LeafModel {\n  const x = command['x-openapi'] as XOpenApiCommand;\n  const params = x.params || [];\n  const body = x.body;\n\n  const pathArgs: PathArg[] = (command.arguments || []).map((arg, idx) => {\n    const param = params.find((p) => p.in === 'path' && fromToken(p.from, 'argument') === arg.name);\n    return { goVar: goVar(arg.name), wireName: param?.name ?? arg.name, idx };\n  });\n\n  const bodyPropByOption = new Map<string, string>(); // flagName -> encoding\n  const bodyWireByOption = new Map<string, string>(); // flagName -> wire name\n  for (const prop of body?.properties || []) {\n    const flag = fromToken(prop.from, 'option');\n    if (flag) {\n      bodyPropByOption.set(flag, prop.encoding || 'string');\n      bodyWireByOption.set(flag, prop.name);\n    }\n  }\n\n  const flags: FlagModel[] = [];\n  for (const opt of command.options || []) {\n    const paramEntry = params.find((p) => fromToken(p.from, 'option') === opt.name && p.in !== 'path');\n    let location: FlagModel['location'];\n    let wireName: string;\n    let encoding: string | undefined;\n\n    if (paramEntry) {\n      location = paramEntry.in as FlagModel['location'];\n      wireName = paramEntry.name;\n    } else if (bodyPropByOption.has(opt.name)) {\n      location = 'body';\n      wireName = bodyWireByOption.get(opt.name) ?? opt.name;\n      encoding = bodyPropByOption.get(opt.name);\n    } else {\n      location = 'query';\n      wireName = opt.name;\n    }\n\n    flags.push({\n      flagName: opt.name,\n      wireName,\n      location,\n      goType: optionGoType(opt, encoding),\n      required: opt.required === true,\n      hidden: opt.hidden === true,\n      aliases: opt.aliases || [],\n      description: opt.description,\n    });\n  }\n\n  const bodyStyle = body?.style;\n  const bodyJsonOption =\n    bodyStyle === 'json' ? fromToken(body?.from, 'option') ?? flags.find((f) => f.location === 'body')?.flagName : undefined;\n  const hasBody = !!body && (bodyStyle === 'json' || flags.some((f) => f.location === 'body'));\n\n  return {\n    method: (x.method || 'get').toUpperCase(),\n    path: x.path,\n    pathArgs,\n    flags,\n    hasBody,\n    bodyStyle,\n    bodyJsonOption,\n  };\n}\n","import type { Command } from '@xyd-js/opencli';\n\nimport type { Imports } from './golit';\nimport { buildLeafModel, type GoType, type LeafModel } from './model';\nimport { pascalCase } from './naming';\n\nconst CLI = 'github.com/urfave/cli/v3';\nconst q = (s: string) => JSON.stringify(s);\n\nfunction readExpr(flagName: string, t: GoType): string {\n  switch (t) {\n    case 'bool':\n      return `cmd.Bool(${q(flagName)})`;\n    case 'int':\n      return `cmd.Int(${q(flagName)})`;\n    case 'float':\n      return `cmd.Float(${q(flagName)})`;\n    case 'slice':\n      return `cmd.StringSlice(${q(flagName)})`;\n    default:\n      return `cmd.String(${q(flagName)})`; // string | json | file\n  }\n}\n\nfunction pathExpr(model: LeafModel, imports: Imports): string {\n  const segs = model.path.split(/(\\{[^}]+\\})/).filter((s) => s !== '');\n  const parts: string[] = [];\n  let lit = '';\n  for (const seg of segs) {\n    const m = seg.match(/^\\{(.+)\\}$/);\n    if (m) {\n      if (lit) {\n        parts.push(q(lit));\n        lit = '';\n      }\n      const a = model.pathArgs.find((p) => p.wireName === m[1]);\n      parts.push(`url.PathEscape(${a ? a.goVar : '\"\"'})`);\n      imports.add('net/url');\n    } else {\n      lit += seg;\n    }\n  }\n  if (lit) parts.push(q(lit));\n  return parts.length ? parts.join(' + ') : '\"\"';\n}\n\n/** Render the handler func for a leaf command from its x-openapi binding. */\nexport function renderHandler(\n  pathNames: string[],\n  command: Command,\n  module: string,\n  imports: Imports,\n): { name: string; code: string } {\n  const model = buildLeafModel(command);\n  const name = `handle${pathNames.map(pascalCase).join('')}`;\n  imports.add('context', CLI, `${module}/internal/runtime`);\n\n  const lines: string[] = [];\n  const push = (s = '') => lines.push(s);\n\n  // Path params (positional args) — only declare the ones the path actually uses.\n  const pe = pathExpr(model, imports);\n  for (const a of model.pathArgs) {\n    if (pe.includes(`url.PathEscape(${a.goVar})`)) push(`${a.goVar} := cmd.Args().Get(${a.idx})`);\n  }\n  push(`path := ${pe}`);\n\n  // Query params.\n  const queryFlags = model.flags.filter((f) => f.location === 'query');\n  if (queryFlags.length) {\n    imports.add('net/url');\n    push('query := url.Values{}');\n    for (const f of queryFlags) {\n      const read = readExpr(f.flagName, f.goType);\n      let val = read;\n      if (f.goType !== 'string') {\n        val = `fmt.Sprint(${read})`;\n        imports.add('fmt');\n      }\n      push(`if cmd.IsSet(${q(f.flagName)}) {`);\n      push(`\\tquery.Set(${q(f.wireName)}, ${val})`);\n      push('}');\n    }\n  }\n\n  // Header / cookie params.\n  const headerFlags = model.flags.filter((f) => f.location === 'header' || f.location === 'cookie');\n  if (headerFlags.length) {\n    imports.add('net/http');\n    push('headers := http.Header{}');\n    for (const f of headerFlags) {\n      const read = readExpr(f.flagName, f.goType);\n      let val = read;\n      if (f.goType !== 'string') {\n        val = `fmt.Sprint(${read})`;\n        imports.add('fmt');\n      }\n      push(`if cmd.IsSet(${q(f.flagName)}) {`);\n      push(`\\theaders.Set(${q(f.wireName)}, ${val})`);\n      push('}');\n    }\n  }\n\n  // Body.\n  if (model.hasBody) {\n    imports.add('encoding/json');\n    if (model.bodyStyle === 'json' && model.bodyJsonOption) {\n      push('var bodyBytes []byte');\n      push(`if cmd.IsSet(${q(model.bodyJsonOption)}) {`);\n      push(`\\tbodyBytes = []byte(cmd.String(${q(model.bodyJsonOption)}))`);\n      push('}');\n    } else {\n      push('body := map[string]any{}');\n      for (const f of model.flags.filter((x) => x.location === 'body')) {\n        push(`if cmd.IsSet(${q(f.flagName)}) {`);\n        if (f.goType === 'json') {\n          // Accept either JSON (objects/arrays) or a bare scalar: a string|object\n          // union field is commonly given a plain value, and an unparseable value\n          // must not abort the whole request.\n          push(`\\traw := cmd.String(${q(f.flagName)})`);\n          push('\\tvar v any');\n          push('\\tif err := json.Unmarshal([]byte(raw), &v); err != nil {');\n          push('\\t\\tv = raw');\n          push('\\t}');\n          push(`\\tbody[${q(f.wireName)}] = v`);\n        } else {\n          push(`\\tbody[${q(f.wireName)}] = ${readExpr(f.flagName, f.goType)}`);\n        }\n        push('}');\n      }\n      push('bodyBytes, err := json.Marshal(body)');\n      push('if err != nil {');\n      push('\\treturn err');\n      push('}');\n    }\n  }\n\n  // Assemble the request.\n  push('req := runtime.Request{');\n  push(`\\tMethod: ${q(model.method)},`);\n  push('\\tPath: path,');\n  if (queryFlags.length) push('\\tQuery: query,');\n  if (headerFlags.length) push('\\tHeaders: headers,');\n  if (model.hasBody) push('\\tBody: bodyBytes,');\n  push('}');\n  push('return runtime.Do(ctx, req)');\n\n  const body = lines.map((l) => `\\t${l}`).join('\\n');\n  const code = `func ${name}(ctx context.Context, cmd *cli.Command) error {\\n${body}\\n}`;\n  return { name, code };\n}\n","import type { Command } from '@xyd-js/opencli';\n\nimport { Imports, goBool, goFile, goSlice, goStr, goStruct, lit, type GoVal } from './golit';\nimport { renderFlags } from './flags';\nimport { renderHandler } from './handler';\nimport { buildLeafModel } from './model';\nimport { pascalCase, splitWords } from './naming';\n\nconst CLI = 'github.com/urfave/cli/v3';\n\nfunction renderCommand(\n  command: Command,\n  pathNames: string[],\n  module: string,\n  imports: Imports,\n  handlers: string[],\n): GoVal {\n  imports.add(CLI);\n  const fields: [string, GoVal][] = [['Name', goStr(command.name)]];\n  if (command.aliases?.length) fields.push(['Aliases', goSlice('string', command.aliases.map(goStr))]);\n  if (command.description) fields.push(['Usage', goStr(command.description)]);\n  if (command.hidden) fields.push(['Hidden', goBool(true)]);\n\n  if (command.commands?.length) {\n    const subs = command.commands.map((sub) =>\n      renderCommand(sub, [...pathNames, sub.name], module, imports, handlers),\n    );\n    fields.push(['Commands', goSlice('*cli.Command', subs)]);\n  } else if (command['x-openapi']) {\n    const flags = renderFlags(buildLeafModel(command).flags);\n    if (flags.length) fields.push(['Flags', goSlice('cli.Flag', flags)]);\n    const handler = renderHandler(pathNames, command, module, imports);\n    fields.push(['Action', lit(handler.name)]);\n    handlers.push(handler.code);\n  }\n\n  return goStruct('cli.Command', fields, true);\n}\n\nexport interface ResourceFile {\n  path: string;\n  content: string;\n  constructor: string;\n}\n\n/** Render one `pkg/cmd/<resource>.go` file for a top-level command + its subtree. */\nexport function renderResourceFile(topCommand: Command, module: string): ResourceFile {\n  const imports = new Imports();\n  const handlers: string[] = [];\n  const struct = renderCommand(topCommand, [topCommand.name], module, imports, handlers);\n\n  const ctorName = `New${pascalCase(topCommand.name)}Command`;\n  const ctor = `func ${ctorName}() *cli.Command {\\n\\treturn ${struct(1)}\\n}`;\n  const content = goFile('cmd', imports, [ctor, ...handlers]);\n\n  const fileBase = splitWords(topCommand.name).join('') || 'command';\n  return { path: `pkg/cmd/${fileBase}.go`, content, constructor: ctorName };\n}\n","import type { OpencliSpecJson } from '@xyd-js/opencli';\n\nimport { Imports, goFile, goSlice, goStr, goStruct, lit, type GoVal } from './golit';\n\nconst CLI = 'github.com/urfave/cli/v3';\n\n/** Render `cmd/<bin>/main.go`. */\nexport function renderMain(\n  spec: OpencliSpecJson,\n  binName: string,\n  module: string,\n  constructors: string[],\n): string {\n  const imports = new Imports().add('context', 'log', 'os', CLI, `${module}/pkg/cmd`);\n\n  const fields: [string, GoVal][] = [['Name', goStr(binName)]];\n  const usage = spec.info?.summary || spec.info?.description;\n  if (usage) fields.push(['Usage', goStr(usage)]);\n  if (spec.info?.version) fields.push(['Version', goStr(spec.info.version)]);\n  fields.push(['Commands', goSlice('*cli.Command', constructors.map((c) => lit(`cmd.${c}()`)))]);\n\n  const app = goStruct('cli.Command', fields, true);\n  const body = `\\tapp := ${app(1)}\n\\tif err := app.Run(context.Background(), os.Args); err != nil {\n\\t\\tlog.Fatal(err)\n\\t}`;\n  const fn = `func main() {\\n${body}\\n}`;\n\n  return goFile('main', imports, [fn]);\n}\n","import type { OpencliSpecJson, XOpenApiSecurity } from '@xyd-js/opencli';\n\nimport { screamingSnakeCase } from './naming';\n\n/** Static, generic HTTP runtime copied verbatim into every generated project. */\nexport function runtimeGo(): string {\n  return `package runtime\n\nimport (\n\t\"bytes\"\n\t\"context\"\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"net/url\"\n\t\"strings\"\n)\n\n// Request is a generic API request assembled by a generated command handler.\ntype Request struct {\n\tMethod  string\n\tPath    string\n\tQuery   url.Values\n\tHeaders http.Header\n\tBody    []byte\n}\n\n// Do executes the request against the configured base URL (applying auth) and\n// prints the response body to stdout.\nfunc Do(ctx context.Context, req Request) error {\n\tendpoint := strings.TrimRight(BaseURL(), \"/\") + req.Path\n\tif len(req.Query) > 0 {\n\t\tendpoint += \"?\" + req.Query.Encode()\n\t}\n\n\tvar body io.Reader\n\tif len(req.Body) > 0 {\n\t\tbody = bytes.NewReader(req.Body)\n\t}\n\n\thttpReq, err := http.NewRequestWithContext(ctx, req.Method, endpoint, body)\n\tif err != nil {\n\t\treturn err\n\t}\n\tfor key, values := range req.Headers {\n\t\tfor _, value := range values {\n\t\t\thttpReq.Header.Add(key, value)\n\t\t}\n\t}\n\tif len(req.Body) > 0 && httpReq.Header.Get(\"Content-Type\") == \"\" {\n\t\thttpReq.Header.Set(\"Content-Type\", \"application/json\")\n\t}\n\tapplyAuth(httpReq)\n\n\tresp, err := http.DefaultClient.Do(httpReq)\n\tif err != nil {\n\t\treturn err\n\t}\n\tdefer resp.Body.Close()\n\n\tout, err := io.ReadAll(resp.Body)\n\tif err != nil {\n\t\treturn err\n\t}\n\tfmt.Println(string(out))\n\tif resp.StatusCode >= 400 {\n\t\treturn fmt.Errorf(\"request failed: %s\", resp.Status)\n\t}\n\treturn nil\n}\n`;\n}\n\nfunction authBlock(scheme: XOpenApiSecurity): string | null {\n  const env = scheme.envVar || 'API_KEY';\n  const name = scheme.name || '';\n  switch (scheme.kind) {\n    case 'bearer':\n      return `\tif v := os.Getenv(${JSON.stringify(env)}); v != \"\" {\n\t\treq.Header.Set(\"Authorization\", \"Bearer \"+v)\n\t}`;\n    case 'apiKey-header':\n      return `\tif v := os.Getenv(${JSON.stringify(env)}); v != \"\" {\n\t\treq.Header.Set(${JSON.stringify(name)}, v)\n\t}`;\n    case 'apiKey-query':\n      return `\tif v := os.Getenv(${JSON.stringify(env)}); v != \"\" {\n\t\tq := req.URL.Query()\n\t\tq.Set(${JSON.stringify(name)}, v)\n\t\treq.URL.RawQuery = q.Encode()\n\t}`;\n    case 'apiKey-cookie':\n      return `\tif v := os.Getenv(${JSON.stringify(env)}); v != \"\" {\n\t\treq.AddCookie(&http.Cookie{Name: ${JSON.stringify(name)}, Value: v})\n\t}`;\n    case 'basic':\n      return `\tuser := os.Getenv(${JSON.stringify(`${env}_USERNAME`)})\n\tpass := os.Getenv(${JSON.stringify(`${env}_PASSWORD`)})\n\tif user != \"\" || pass != \"\" {\n\t\treq.SetBasicAuth(user, pass)\n\t}`;\n    default:\n      return null;\n  }\n}\n\n/** Generated config: the base URL + auth, derived from the spec's root x-openapi. */\nexport function configGo(spec: OpencliSpecJson, binName: string, baseURL: string): string {\n  const prefix = screamingSnakeCase(binName);\n  const security = spec['x-openapi']?.security || [];\n  const blocks = security.map(authBlock).filter((b): b is string => b !== null);\n  const authBody = blocks.length ? `\\n${blocks.join('\\n')}\\n` : '';\n\n  return `package runtime\n\nimport (\n\t\"net/http\"\n\t\"os\"\n)\n\nconst defaultBaseURL = ${JSON.stringify(baseURL)}\n\n// BaseURL returns the API base URL, overridable via ${prefix}_BASE_URL.\nfunc BaseURL() string {\n\tif v := os.Getenv(${JSON.stringify(`${prefix}_BASE_URL`)}); v != \"\" {\n\t\treturn v\n\t}\n\treturn defaultBaseURL\n}\n\n// applyAuth attaches credentials read from the environment to the request.\nfunc applyAuth(req *http.Request) {${authBody}}\n`;\n}\n","import type { OpencliSpecJson } from '@xyd-js/opencli';\n\nimport { renderResourceFile } from './command';\nimport { renderMain } from './main';\nimport { slug } from './naming';\nimport { configGo, runtimeGo } from './runtime';\nimport type { Opencli2GoOptions } from './types';\n\n/**\n * Generate a buildable Go CLI project (urfave/cli v3) from an OpenCLI document.\n * Pure: returns a virtual file map `{ relativePath: contents }`.\n */\nexport function opencli2go(spec: OpencliSpecJson, options: Opencli2GoOptions = {}): Record<string, string> {\n  const binName = options.binName ?? (slug(spec.info?.title || 'cli') || 'cli');\n  const module = options.modulePath ?? `example.com/${binName}`;\n  const goVersion = options.goVersion ?? '1.22';\n  const baseURL = options.baseURL ?? spec['x-openapi']?.servers?.[0] ?? '';\n\n  const files: Record<string, string> = {};\n\n  files['go.mod'] = `module ${module}\\n\\ngo ${goVersion}\\n`;\n\n  const constructors: string[] = [];\n  for (const top of spec.commands || []) {\n    const resource = renderResourceFile(top, module);\n    files[resource.path] = resource.content;\n    constructors.push(resource.constructor);\n  }\n\n  files[`cmd/${binName}/main.go`] = renderMain(spec, binName, module, constructors);\n\n  files['internal/runtime/runtime.go'] = runtimeGo();\n  files['internal/runtime/config.go'] = configGo(spec, binName, baseURL);\n\n  return files;\n}\n","/** Write a generated file map to disk (the only fs-touching entry point). */\nexport async function writeProject(files: Record<string, string>, outDir: string): Promise<void> {\n  const fs = await import('node:fs/promises');\n  const path = await import('node:path');\n  for (const [rel, content] of Object.entries(files)) {\n    const full = path.join(outDir, rel);\n    await fs.mkdir(path.dirname(full), { recursive: true });\n    await fs.writeFile(full, content, 'utf8');\n  }\n}\n"],"mappings":"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","names":["lit","module","CLI","module","CLI","module","module"]}

package/dist/index.d.cts

@@ -0,0 +1,26 @@
+import { OpencliSpecJson } from '@xyd-js/opencli';
+
+interface Opencli2GoOptions {
+    /** Go module path for the generated project. Default: `example.com/<binName>`. */
+    modulePath?: string;
+    /** Binary name (the `cmd/<binName>` dir + root command name). Default: slug(info.title). */
+    binName?: string;
+    /** `go` directive in go.mod. Default: "1.22". */
+    goVersion?: string;
+    /**
+     * Default API base URL baked into the generated runtime (overridable at runtime
+     * via `<ENVPREFIX>_BASE_URL`). Default: the first `x-openapi.servers` entry.
+     */
+    baseURL?: string;
+}
+
+/**
+ * Generate a buildable Go CLI project (urfave/cli v3) from an OpenCLI document.
+ * Pure: returns a virtual file map `{ relativePath: contents }`.
+ */
+declare function opencli2go(spec: OpencliSpecJson, options?: Opencli2GoOptions): Record<string, string>;
+
+/** Write a generated file map to disk (the only fs-touching entry point). */
+declare function writeProject(files: Record<string, string>, outDir: string): Promise<void>;
+
+export { type Opencli2GoOptions, opencli2go, writeProject };

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import { OpencliSpecJson } from '@xyd-js/opencli';
+
+interface Opencli2GoOptions {
+    /** Go module path for the generated project. Default: `example.com/<binName>`. */
+    modulePath?: string;
+    /** Binary name (the `cmd/<binName>` dir + root command name). Default: slug(info.title). */
+    binName?: string;
+    /** `go` directive in go.mod. Default: "1.22". */
+    goVersion?: string;
+    /**
+     * Default API base URL baked into the generated runtime (overridable at runtime
+     * via `<ENVPREFIX>_BASE_URL`). Default: the first `x-openapi.servers` entry.
+     */
+    baseURL?: string;
+}
+
+/**
+ * Generate a buildable Go CLI project (urfave/cli v3) from an OpenCLI document.
+ * Pure: returns a virtual file map `{ relativePath: contents }`.
+ */
+declare function opencli2go(spec: OpencliSpecJson, options?: Opencli2GoOptions): Record<string, string>;
+
+/** Write a generated file map to disk (the only fs-touching entry point). */
+declare function writeProject(files: Record<string, string>, outDir: string): Promise<void>;
+
+export { type Opencli2GoOptions, opencli2go, writeProject };