@automatons/typescript-client-fetch 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) tanmen (yt.prog@gmail.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @automatons/typescript-client-fetch
+[![CI/CD](https://github.com/openapi-automatons/typescript-client-fetch/actions/workflows/ci-cd.yml/badge.svg)](https://github.com/openapi-automatons/typescript-client-fetch/actions/workflows/ci-cd.yml)
+[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)
+[![npm downloads](https://img.shields.io/npm/dw/@automatons/typescript-client-fetch)](https://www.npmjs.com/package/@automatons/typescript-client-fetch)
+
+## What is @automatons/typescript-client-fetch
+This is a client generator that emits a typed client built on the standard `fetch` API (no `axios` dependency).
+Only use openapi-automatons.
+
+This package is **ESM-only** and requires **Node.js >= 22**.
+
+Each generated operation returns a `FetchResponse<T>` (`{ data, status, statusText, headers, response }`), so consumers can write `const { data } = await api.xxx()`.
+Non-2xx responses are **not** thrown — inspect `response.ok` / `status` instead.
+
+## How can I use @automatons/typescript-client-fetch?
+This library is designed to be used by [openapi-automatons](https://github.com/openapi-automatons/openapi-automatons).
+Please read the [readme](https://github.com/openapi-automatons/openapi-automatons/blob/main/README.md) of [openapi-automatons](https://github.com/openapi-automatons/openapi-automatons) for how to use it.

package/index.d.ts

@@ -0,0 +1,5 @@
+import { Automaton } from '@automatons/tools';
+
+declare const generatorTypescriptFetchClient: Automaton;
+
+export { generatorTypescriptFetchClient as default };

package/index.js

@@ -0,0 +1,482 @@
+// src/generator/generate.ts
+import { parser } from "@automatons/parser";
+
+// src/generator/render.ts
+import path from "path";
+import { mkdir, writeFile } from "fs/promises";
+import { IndentationText, Project, QuoteKind } from "ts-morph";
+import { format } from "prettier";
+var project = new Project({
+  useInMemoryFileSystem: true,
+  manipulationSettings: {
+    quoteKind: QuoteKind.Double,
+    indentationText: IndentationText.TwoSpaces,
+    useTrailingCommas: true
+  }
+});
+var counter = 0;
+var render = (build) => {
+  const sf = project.createSourceFile(`__gen_${counter++}.ts`, "", { overwrite: true });
+  build(sf);
+  const text = sf.getFullText();
+  project.removeSourceFile(sf);
+  return text;
+};
+var write = async (outDir, relPath, text) => {
+  const outputPath = path.resolve(outDir, relPath);
+  await mkdir(path.dirname(outputPath), { recursive: true });
+  const formatted = await format(text, { parser: "typescript" });
+  await writeFile(outputPath, formatted, { encoding: "utf-8" });
+};
+
+// src/generator/schema.ts
+var quoteKey = (name) => name.includes("-") ? `"${name}"` : name;
+var nullable = (schema) => schema.nullable ? " | null" : "";
+var schemaToType = (schema) => {
+  switch (schema.type) {
+    case "model":
+      return schema.name;
+    case "object": {
+      if (schema.properties && schema.properties.length) {
+        const props = schema.properties.map(
+          (property) => `/**
+ * ${property.name}
+ */
+${quoteKey(property.name)}${property.required ? "" : "?"}: ${schemaToType(property.schema)};`
+        ).join("\n");
+        return `{
+${props}
+}${nullable(schema)}`;
+      }
+      return `object${nullable(schema)}`;
+    }
+    case "allOf":
+      return `(${schema.schemas.map(schemaToType).join(" & ")})`;
+    case "oneOf":
+      return `(${schema.schemas.map(schemaToType).join(" | ")})`;
+    case "array":
+      return `${schema.items ? `Array<${schemaToType(schema.items)}>` : "any[]"}${nullable(schema)}`;
+    case "boolean":
+      return `boolean${nullable(schema)}`;
+    case "string": {
+      const base = schema.enum && schema.enum.length ? schema.enum.map((value) => `"${value}"`).join(" | ") : schema.format === "date" || schema.format === "date-time" ? "Date" : schema.format === "url" ? "URL" : "string";
+      return `${base}${nullable(schema)}`;
+    }
+    case "integer":
+    case "number": {
+      const base = schema.enum && schema.enum.length ? schema.enum.join(" | ") : "number";
+      return `${base}${nullable(schema)}`;
+    }
+    default:
+      throw new Error(`Unsupported schema type: ${schema.type}`);
+  }
+};
+
+// src/generator/comment.ts
+var docs = (options) => {
+  const tags = [];
+  if (options.async) tags.push({ tagName: "async" });
+  if (options.description) tags.push({ tagName: "description", text: options.description });
+  if (options.deprecated) tags.push({ tagName: "deprecated" });
+  if (options.readOnly) tags.push({ tagName: "readonly" });
+  return [{ description: options.title, tags }];
+};
+
+// src/generator/model.ts
+var emitModel = (model) => render((sf) => {
+  model.imports.forEach(
+    (imported) => sf.addImportDeclaration({
+      namedImports: [imported.title],
+      moduleSpecifier: `./${imported.filename}`
+    })
+  );
+  sf.addTypeAlias({
+    isExported: true,
+    name: model.title,
+    type: schemaToType(model.schema),
+    docs: docs({ title: model.title })
+  });
+});
+var emitModelsIndex = (models) => render(
+  (sf) => models.forEach((model) => sf.addExportDeclaration({ moduleSpecifier: `./${model.filename}` }))
+);
+
+// src/generator/config.ts
+var callable = (returns, arg = "") => `${returns} | Promise<${returns}> | ((${arg}) => ${returns} | Promise<${returns}>)`;
+var securityType = (security) => {
+  if (security.type === "http" && security.scheme === "basic") {
+    const basic = "{username: string; password: string;}";
+    return `${security.name}?: ${callable(basic)};`;
+  }
+  if (security.type === "oauth2" || security.type === "openIdConnect") {
+    return `${security.name}?: ${callable("string", "scopes?: string[]")};`;
+  }
+  return `${security.name}?: ${callable("string")};`;
+};
+var emitConfig = (securities) => render((sf) => {
+  sf.addTypeAlias({
+    isExported: true,
+    name: "Security",
+    type: `{
+${securities.map(securityType).join("\n")}
+}`
+  });
+  sf.addTypeAlias({
+    isExported: true,
+    name: "Config",
+    type: `{
+  fetch?: typeof fetch;
+  token?: string | Promise<string> | (() => string | Promise<string>);
+  security?: Security;
+}`
+  });
+});
+var emitIndex = (hasModels, hasApis) => render((sf) => {
+  if (hasModels) sf.addExportDeclaration({ moduleSpecifier: "./models" });
+  if (hasApis) sf.addExportDeclaration({ moduleSpecifier: "./apis" });
+  sf.addExportDeclaration({ moduleSpecifier: "./config" });
+});
+
+// src/generator/abstractApi.ts
+import { Scope } from "ts-morph";
+var FETCH_STATEMENTS = [
+  "const DateFormat = /^\\d{4}-\\d{2}-\\d{2}([tT]\\d{2}:\\d{2}:\\d{2}(Z|[+-]\\d{2}:\\d{2})|Z)?$/;",
+  "const reviver = (_key: string, value: any) => typeof value === 'string' && DateFormat.test(value) ? new Date(value) : value;",
+  "const toQuery = (params: Record<string, unknown>): string => { const search = new URLSearchParams(); for (const [key, value] of Object.entries(params)) { if (value === undefined || value === null) continue; if (Array.isArray(value)) { value.forEach((item) => search.append(key, String(item))); } else { search.append(key, String(value)); } } return search.toString(); };"
+];
+var REQUEST_STATEMENTS = [
+  "const { baseURL, params, headers, ...init } = config;",
+  "const search = toQuery(params);",
+  'const url = `${baseURL}${path}${search ? `?${search}` : ""}`;',
+  "const _headers = new Headers(headers);",
+  'if (init.body instanceof FormData) { _headers.delete("Content-Type"); }',
+  "const response = await this.fetch(url, { ...init, method, headers: _headers });",
+  "const text = await response.text();",
+  "const data = (text ? JSON.parse(text, reviver) : undefined) as T;",
+  "return { data, status: response.status, statusText: response.statusText, headers: response.headers, response };"
+];
+var overload = (security) => {
+  const base = { scope: Scope.Protected, isAsync: true };
+  if (security.type === "http" && security.scheme === "basic") {
+    return {
+      ...base,
+      parameters: [{ name: "key", type: `"${security.name}"` }],
+      returnType: "Promise<{username: string; password: string;}>"
+    };
+  }
+  if (security.type === "oauth2" || security.type === "openIdConnect") {
+    return {
+      ...base,
+      parameters: [{ name: "key", type: `"${security.name}"` }, { name: "scopes", type: "string[]" }],
+      returnType: "Promise<string>"
+    };
+  }
+  return { ...base, parameters: [{ name: "key", type: `"${security.name}"` }], returnType: "Promise<string>" };
+};
+var emitAbstractApi = (securities) => render((sf) => {
+  sf.addImportDeclaration({
+    isTypeOnly: true,
+    namedImports: securities.length ? ["Config", "Security"] : ["Config"],
+    moduleSpecifier: "../config"
+  });
+  sf.addTypeAlias({
+    isExported: true,
+    name: "RequestConfig",
+    type: "Omit<RequestInit, 'headers'> & { baseURL: string; params: Record<string, unknown>; headers: Record<string, string>; }"
+  });
+  sf.addTypeAlias({
+    isExported: true,
+    name: "FetchResponse",
+    typeParameters: [{ name: "T", default: "unknown" }],
+    type: "{ data: T; status: number; statusText: string; headers: Headers; response: Response; }"
+  });
+  sf.addStatements(FETCH_STATEMENTS);
+  const abstractConfig = sf.addClass({ isExported: true, name: "AbstractConfig", docs: docs({ title: "AbstractConfig" }) });
+  if (securities.length) {
+    abstractConfig.addProperty({ name: "#security", isReadonly: true, type: "Security" });
+    abstractConfig.addConstructor({
+      docs: docs({ title: "constructor" }),
+      parameters: [{ name: "security", type: "Security", initializer: "{}" }],
+      statements: ["this.#security = security;"]
+    });
+    const scoped = securities.some((s) => s.type === "oauth2" || s.type === "openIdConnect");
+    abstractConfig.addMethod({
+      scope: Scope.Protected,
+      isAsync: true,
+      name: "security",
+      overloads: securities.map(overload),
+      parameters: [
+        { name: "key", type: "keyof Security" },
+        ...scoped ? [{ name: "scopes", type: "string[]", hasQuestionToken: true }] : []
+      ],
+      returnType: "Promise<string | {username: string; password: string;}>",
+      statements: [
+        "const security = this.#security[key];",
+        'if (!security) { throw new Error("Unauthorized user request."); }',
+        `else if (security instanceof Function) { ${scoped ? "return scopes ? security(scopes) : security();" : "return security();"} }`,
+        "return security;"
+      ]
+    });
+  }
+  const abstractApi = sf.addClass({ isExported: true, name: "AbstractApi", docs: docs({ title: "AbstractApi" }) });
+  abstractApi.addProperty({ scope: Scope.Protected, name: "fetch", type: "typeof fetch", initializer: "fetch" });
+  abstractApi.addConstructor({
+    docs: docs({ title: "constructor" }),
+    parameters: [{ name: "config", type: "Config" }],
+    statements: ["if (config.fetch) { this.fetch = config.fetch; }"]
+  });
+  abstractApi.addMethod({
+    scope: Scope.Protected,
+    isAsync: true,
+    name: "request",
+    typeParameters: [{ name: "T", default: "unknown" }],
+    parameters: [
+      { name: "path", type: "string" },
+      { name: "method", type: "string" },
+      { name: "config", type: "RequestConfig" }
+    ],
+    returnType: "Promise<FetchResponse<T>>",
+    statements: REQUEST_STATEMENTS
+  });
+});
+
+// src/generator/api.ts
+import { Scope as Scope2 } from "ts-morph";
+
+// src/extractors/api.ts
+var isAffectPath = (path4) => ["post", "patch", "put"].includes(path4.method);
+var extractApiMeta = (api) => {
+  const hasTemplate = api.servers.some((server) => server.values?.length) || api.paths.some((path4) => path4.parameters?.length) || api.paths.some((path4) => path4.headers?.length);
+  const hasQuery = api.paths.some((path4) => path4.queries?.length) || api.paths.some((path4) => path4.cookies?.length);
+  const hasFormData = api.paths.some((path4) => isAffectPath(path4) ? path4.forms?.length : false);
+  return { hasQuery, hasTemplate, hasFormData };
+};
+
+// src/generator/api.ts
+var isAffect = (path4) => ["post", "put", "patch"].includes(path4.method);
+var formsOf = (path4) => isAffect(path4) && path4.forms ? path4.forms : [];
+var objectType = (entries) => `{ ${entries.map((e) => `${e.name}${e.required ? "" : "?"}: ${schemaToType(e.schema)}, `).join("")}}`;
+var allOptional = (entries = []) => entries.every((e) => !e.required);
+var contentType = (path4) => {
+  const forms = formsOf(path4);
+  return forms.length ? forms.map((form) => form.types.map((type) => `'${type}'`).join(" | ")).join(" | ") : "'application/json'";
+};
+var headersType = (path4) => `{ 'Content-Type': ${contentType(path4)}, ${(path4.headers ?? []).map((h) => `${h.name}${h.required ? "" : "?"}: ${schemaToType(h.schema)}, `).join("")}}`;
+var serverUnion = (servers) => servers.map((server) => `${server.name}Server`).join(" | ");
+var serverDefault = (servers) => {
+  const [first] = servers;
+  return servers.length === 1 && first && !(first.values && first.values.length) ? `{ name: '${first.name}' }` : void 0;
+};
+var withInit = (init) => init ? { initializer: init } : {};
+var queriesParam = (path4) => path4.queries?.length ? { name: "queries", type: objectType(path4.queries), ...withInit(allOptional(path4.queries) ? "{}" : void 0) } : void 0;
+var cookiesParam = (path4) => path4.cookies?.length ? { name: "cookies", type: objectType(path4.cookies), ...withInit(allOptional(path4.cookies) ? "{}" : void 0) } : void 0;
+var headersParam = (path4) => ({
+  name: "headers",
+  type: headersType(path4),
+  ...withInit(allOptional(path4.headers) ? "{ 'Content-Type': 'application/json' }" : void 0)
+});
+var serverParam = (path4) => path4.servers?.length ? { name: "server", type: serverUnion(path4.servers), ...withInit(serverDefault(path4.servers)) } : void 0;
+var configParam = () => ({
+  name: "config",
+  type: "RequestInit",
+  hasQuestionToken: true
+});
+var compact = (items) => items.filter((item) => item !== void 0);
+var requestParams = (path4) => {
+  const forms = formsOf(path4);
+  return compact([
+    ...(path4.parameters ?? []).map((p) => ({ name: p.name, type: schemaToType(p.schema) })),
+    forms.length ? { name: "form", type: forms.map((form) => schemaToType(form.schema)).join(" | ") } : void 0,
+    queriesParam(path4),
+    cookiesParam(path4),
+    headersParam(path4),
+    serverParam(path4),
+    configParam()
+  ]);
+};
+var configParams = (path4) => compact([queriesParam(path4), cookiesParam(path4), headersParam(path4), serverParam(path4), configParam()]);
+var requestVariables = (path4) => compact([
+  path4.queries?.length ? "queries" : void 0,
+  path4.cookies?.length ? "cookies" : void 0,
+  "headers",
+  path4.servers?.length ? "server" : void 0,
+  "config"
+]).join(", ");
+var requestBody = (api, path4) => {
+  const forms = formsOf(path4);
+  const replaces = (path4.parameters ?? []).map((p) => `.replace("{${p.name}}", template('${p.name}', ${p.name}, '${p.style ?? "simple"}', ${p.explode ?? false}))`).join("");
+  void api;
+  const generic = path4.schema ? `<${schemaToType(path4.schema)}>` : "";
+  const request = forms.length ? `{ ...requestConfig, body: body(headers['Content-Type'], form) }` : "requestConfig";
+  return compact([
+    `const path = "${path4.path}"${replaces};`,
+    `const requestConfig = await this.#config.${path4.name}(${requestVariables(path4)});`,
+    `return this.request${generic}(path, "${path4.method.toUpperCase()}", ${request});`
+  ]);
+};
+var configBody = (api, path4) => {
+  const securities = path4.securities ?? [];
+  const params = compact([
+    ...(path4.queries ?? []).map((q) => `...query("${q.name}", queries.${q.name}, '${q.style ?? "form"}', ${q.explode ?? false}),`),
+    ...securities.map((s) => s.type === "apiKey" && s.in === "query" ? `${s.key}: await this.security("${s.name}"),` : void 0)
+  ]);
+  const cookieStatements = compact([
+    ...(path4.cookies ?? []).map(
+      (c) => `if (cookies.${c.name}) { _cookies += Object.entries(query('${c.name}', cookies.${c.name}, 'form', ${c.explode ?? false})).reduce((pre, [key, value]) => \`\${pre}\${key}=\${value};\`, ''); }`
+    ),
+    ...securities.flatMap(
+      (s) => s.type === "apiKey" && s.in === "cookie" ? [
+        `const _cookie${s.name} = await this.security("${s.name}");`,
+        `if (_cookie${s.name}) { _cookies += \`${s.key}=\${_cookie${s.name}};\`; }`
+      ] : []
+    )
+  ]);
+  const headerStatements = compact([
+    ...(path4.headers ?? []).map(
+      (h) => `if (headers.${h.name}) { _headers['${h.name}'] = template('${h.name}', headers.${h.name}, 'simple', ${h.explode ?? false}); }`
+    ),
+    ...securities.map((s) => {
+      if (s.type === "apiKey" && s.in === "header") return `_headers['${s.key}'] = await this.security("${s.name}");`;
+      if (s.type === "http" && s.scheme === "bearer") return `_headers['Authorization'] = \`Bearer \${await this.security("${s.name}")}\`;`;
+      if (s.type === "http" && s.scheme === "basic")
+        return `const _basic${s.name} = await this.security("${s.name}"); _headers['Authorization'] = \`Basic \${btoa(\`\${_basic${s.name}.username}:\${_basic${s.name}.password}\`)}\`;`;
+      if (s.type === "oauth2" || s.type === "openIdConnect")
+        return `_headers['Authorization'] = \`Bearer \${await this.security("${s.name}", [${s.scopes.map((x) => `"${x}"`).join(", ")}])}\`;`;
+      return void 0;
+    })
+  ]);
+  const hasCookies = cookieStatements.length > 0;
+  return compact([
+    `const params = { ${params.join(" ")} };`,
+    hasCookies ? "let _cookies = '';" : void 0,
+    ...cookieStatements,
+    "const _headers = Object.fromEntries(new Headers(config?.headers)) as Record<string, string>;",
+    "_headers['Content-Type'] = headers['Content-Type'];",
+    ...headerStatements,
+    hasCookies ? "if (_cookies) { _headers['Cookie'] = _cookies; }" : void 0,
+    `return { ...config, baseURL: ${api.title}Config.server(server), params, headers: _headers };`
+  ]);
+};
+var serverTypeAlias = (server) => {
+  const values = server.values?.length ? `; values: { ${server.values.map((v) => `${v.name}: ${v.enums?.length ? v.enums.map((e) => `'${e}'`).join(" | ") : "string"} `).join("")}}` : "";
+  return `{ name: "${server.name}"${values} }`;
+};
+var serverMethodStatements = (servers) => [
+  ...servers.map((server) => {
+    const replaces = (server.values ?? []).map((v) => `.replace('{${v.name}}', template('${v.name}', server.values.${v.name}, 'simple', false))`).join("");
+    return `if ('${server.name}' === server.name) { return '${server.url}'${replaces}; }`;
+  }),
+  "throw new Error('Undefined server. please define server.');"
+];
+var utilImports = (api) => {
+  const meta = extractApiMeta(api);
+  return compact([meta.hasTemplate ? "template" : void 0, meta.hasQuery ? "query" : void 0, meta.hasFormData ? "body" : void 0]);
+};
+var emitApi = (api, securities) => render((sf) => {
+  sf.addImportDeclaration({
+    namedImports: ["AbstractApi", "AbstractConfig", "FetchResponse", "RequestConfig"],
+    moduleSpecifier: "./abstractApi"
+  });
+  sf.addImportDeclaration({
+    namedImports: securities.length ? ["Config", "Security"] : ["Config"],
+    moduleSpecifier: "../config"
+  });
+  const utils = utilImports(api);
+  if (utils.length) sf.addImportDeclaration({ namedImports: utils, moduleSpecifier: "../utils" });
+  if (api.imports.length) sf.addImportDeclaration({ namedImports: api.imports.map((m) => m.title), moduleSpecifier: "../models" });
+  api.servers.forEach((server) => sf.addTypeAlias({ name: `${server.name}Server`, type: serverTypeAlias(server) }));
+  const apiClass = sf.addClass({ isExported: true, name: api.title, extends: "AbstractApi", docs: docs({ title: api.title }) });
+  apiClass.addProperty({ name: "#config", isReadonly: true, type: `${api.title}Config` });
+  apiClass.addConstructor({
+    docs: docs({ title: "constructor" }),
+    parameters: [{ name: "config", type: "Config", initializer: "{}" }],
+    statements: ["super(config);", `this.#config = new ${api.title}Config(${securities.length ? "config.security" : ""});`]
+  });
+  api.paths.forEach(
+    (path4) => apiClass.addMethod({
+      scope: Scope2.Public,
+      isAsync: true,
+      name: path4.name,
+      docs: docs({ title: path4.name, async: true }),
+      parameters: requestParams(path4),
+      returnType: `Promise<FetchResponse${path4.schema ? `<${schemaToType(path4.schema)}>` : ""}>`,
+      statements: requestBody(api, path4)
+    })
+  );
+  const configClass = sf.addClass({ name: `${api.title}Config`, extends: "AbstractConfig" });
+  if (securities.length)
+    configClass.addConstructor({
+      parameters: [{ name: "security", type: "Security", initializer: "{}" }],
+      statements: ["super(security);"]
+    });
+  configClass.addMethod({
+    isStatic: true,
+    scope: Scope2.Private,
+    name: "server",
+    parameters: [{ name: "server", type: serverUnion(api.servers.length ? api.servers : api.paths[0]?.servers ?? []) }],
+    statements: serverMethodStatements(api.servers.length ? api.servers : api.paths[0]?.servers ?? [])
+  });
+  api.paths.forEach(
+    (path4) => configClass.addMethod({
+      scope: Scope2.Public,
+      isAsync: true,
+      name: path4.name,
+      parameters: configParams(path4),
+      returnType: "Promise<RequestConfig>",
+      statements: configBody(api, path4)
+    })
+  );
+});
+var emitApisIndex = (apis) => render((sf) => apis.forEach((api) => sf.addExportDeclaration({ moduleSpecifier: `./${api.filename}` })));
+
+// src/generator/statics.ts
+import path3 from "path";
+import { readdir, readFile } from "fs/promises";
+
+// src/paths.ts
+import path2 from "path";
+var paths = {
+  static: path2.resolve(import.meta.dirname, "static"),
+  tmp: path2.resolve(import.meta.dirname, "../tmp")
+};
+var paths_default = paths;
+
+// src/generator/statics.ts
+var emitStatics = async (outDir) => {
+  const dir = path3.join(paths_default.static, "utils");
+  const files = await readdir(dir);
+  await Promise.all(
+    files.map(async (file) => {
+      const text = await readFile(path3.join(dir, file), { encoding: "utf-8" });
+      await write(outDir, path3.join("utils", file), text);
+    })
+  );
+};
+
+// src/generator/generate.ts
+var generate = async (openapi, settings) => {
+  const { outDir } = settings;
+  const { models, apis, securities } = await parser(openapi, settings);
+  const tasks = [];
+  if (models.length) {
+    tasks.push(write(outDir, "models/index.ts", emitModelsIndex(models)));
+    models.forEach((model) => tasks.push(write(outDir, `models/${model.filename}.ts`, emitModel(model))));
+  }
+  if (apis.length) {
+    tasks.push(write(outDir, "apis/index.ts", emitApisIndex(apis)));
+    tasks.push(write(outDir, "apis/abstractApi.ts", emitAbstractApi(securities)));
+    apis.forEach((api) => tasks.push(write(outDir, `apis/${api.filename}.ts`, emitApi(api, securities))));
+  }
+  tasks.push(write(outDir, "index.ts", emitIndex(models.length > 0, apis.length > 0)));
+  tasks.push(write(outDir, "config.ts", emitConfig(securities)));
+  tasks.push(emitStatics(outDir));
+  return Promise.all(tasks);
+};
+
+// src/index.ts
+var generatorTypescriptFetchClient = (openapi, settings) => generate(openapi, settings);
+var index_default = generatorTypescriptFetchClient;
+export {
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/generator/generate.ts","../src/generator/render.ts","../src/generator/schema.ts","../src/generator/comment.ts","../src/generator/model.ts","../src/generator/config.ts","../src/generator/abstractApi.ts","../src/generator/api.ts","../src/extractors/api.ts","../src/generator/statics.ts","../src/paths.ts","../src/index.ts"],"sourcesContent":["import {AutomatonSettings, Openapi} from \"@automatons/tools\";\nimport {parser} from \"@automatons/parser\";\nimport {write} from \"./render\";\nimport {emitModel, emitModelsIndex} from \"./model\";\nimport {emitConfig, emitIndex} from \"./config\";\nimport {emitAbstractApi} from \"./abstractApi\";\nimport {emitApi, emitApisIndex} from \"./api\";\nimport {emitStatics} from \"./statics\";\n\nexport const generate = async (openapi: Openapi, settings: AutomatonSettings): Promise<void[]> => {\n  const {outDir} = settings;\n  const {models, apis, securities} = await parser(openapi, settings);\n  const tasks: Promise<void>[] = [];\n\n  if (models.length) {\n    tasks.push(write(outDir, \"models/index.ts\", emitModelsIndex(models)));\n    models.forEach((model) => tasks.push(write(outDir, `models/${model.filename}.ts`, emitModel(model))));\n  }\n\n  if (apis.length) {\n    tasks.push(write(outDir, \"apis/index.ts\", emitApisIndex(apis)));\n    tasks.push(write(outDir, \"apis/abstractApi.ts\", emitAbstractApi(securities)));\n    apis.forEach((api) => tasks.push(write(outDir, `apis/${api.filename}.ts`, emitApi(api, securities))));\n  }\n\n  tasks.push(write(outDir, \"index.ts\", emitIndex(models.length > 0, apis.length > 0)));\n  tasks.push(write(outDir, \"config.ts\", emitConfig(securities)));\n  tasks.push(emitStatics(outDir));\n\n  return Promise.all(tasks);\n};\n","import path from \"node:path\";\nimport {mkdir, writeFile} from \"node:fs/promises\";\nimport {IndentationText, Project, QuoteKind, SourceFile} from \"ts-morph\";\nimport {format} from \"prettier\";\n\nconst project = new Project({\n  useInMemoryFileSystem: true,\n  manipulationSettings: {\n    quoteKind: QuoteKind.Double,\n    indentationText: IndentationText.TwoSpaces,\n    useTrailingCommas: true,\n  },\n});\n\nlet counter = 0;\n\n/**\n * Build a TypeScript source string by manipulating a throwaway ts-morph SourceFile.\n */\nexport const render = (build: (sf: SourceFile) => void): string => {\n  const sf = project.createSourceFile(`__gen_${counter++}.ts`, \"\", {overwrite: true});\n  build(sf);\n  const text = sf.getFullText();\n  project.removeSourceFile(sf);\n  return text;\n};\n\n/**\n * Format with prettier and write the file under outDir.\n */\nexport const write = async (outDir: string, relPath: string, text: string): Promise<void> => {\n  const outputPath = path.resolve(outDir, relPath);\n  await mkdir(path.dirname(outputPath), {recursive: true});\n  const formatted = await format(text, {parser: \"typescript\"});\n  await writeFile(outputPath, formatted, {encoding: \"utf-8\"});\n};\n","import {Schema} from \"@automatons/parser\";\n\nconst quoteKey = (name: string): string => (name.includes(\"-\") ? `\"${name}\"` : name);\n\nconst nullable = (schema: {nullable?: boolean}): string => (schema.nullable ? \" | null\" : \"\");\n\n/**\n * Render a parser Schema (a discriminated union) as a TypeScript type string.\n * Mirrors the previous models/* handlebars partials.\n */\nexport const schemaToType = (schema: Schema): string => {\n  switch (schema.type) {\n    case \"model\":\n      return schema.name;\n    case \"object\": {\n      if (schema.properties && schema.properties.length) {\n        const props = schema.properties\n          .map(\n            (property) =>\n              `/**\\n * ${property.name}\\n */\\n${quoteKey(property.name)}${\n                property.required ? \"\" : \"?\"\n              }: ${schemaToType(property.schema)};`,\n          )\n          .join(\"\\n\");\n        return `{\\n${props}\\n}${nullable(schema)}`;\n      }\n      return `object${nullable(schema)}`;\n    }\n    case \"allOf\":\n      return `(${schema.schemas.map(schemaToType).join(\" & \")})`;\n    case \"oneOf\":\n      return `(${schema.schemas.map(schemaToType).join(\" | \")})`;\n    case \"array\":\n      return `${schema.items ? `Array<${schemaToType(schema.items)}>` : \"any[]\"}${nullable(schema)}`;\n    case \"boolean\":\n      return `boolean${nullable(schema)}`;\n    case \"string\": {\n      const base =\n        schema.enum && schema.enum.length\n          ? schema.enum.map((value) => `\"${value}\"`).join(\" | \")\n          : schema.format === \"date\" || schema.format === \"date-time\"\n            ? \"Date\"\n            : schema.format === \"url\"\n              ? \"URL\"\n              : \"string\";\n      return `${base}${nullable(schema)}`;\n    }\n    case \"integer\":\n    case \"number\": {\n      const base = schema.enum && schema.enum.length ? schema.enum.join(\" | \") : \"number\";\n      return `${base}${nullable(schema)}`;\n    }\n    default:\n      throw new Error(`Unsupported schema type: ${(schema as {type: string}).type}`);\n  }\n};\n","import {OptionalKind, JSDocStructure, JSDocTagStructure} from \"ts-morph\";\n\nexport type CommentOptions = {\n  title: string;\n  async?: boolean;\n  description?: string;\n  deprecated?: boolean;\n  readOnly?: boolean;\n};\n\n/**\n * Build a ts-morph JSDoc structure mirroring the previous comment partial.\n */\nexport const docs = (options: CommentOptions): OptionalKind<JSDocStructure>[] => {\n  const tags: OptionalKind<JSDocTagStructure>[] = [];\n  if (options.async) tags.push({tagName: \"async\"});\n  if (options.description) tags.push({tagName: \"description\", text: options.description});\n  if (options.deprecated) tags.push({tagName: \"deprecated\"});\n  if (options.readOnly) tags.push({tagName: \"readonly\"});\n  return [{description: options.title, tags}];\n};\n","import {Model} from \"@automatons/parser\";\nimport {render} from \"./render\";\nimport {schemaToType} from \"./schema\";\nimport {docs} from \"./comment\";\n\n/**\n * Emit a single model file: imports for referenced models + an exported type alias.\n */\nexport const emitModel = (model: Model): string =>\n  render((sf) => {\n    model.imports.forEach((imported) =>\n      sf.addImportDeclaration({\n        namedImports: [imported.title],\n        moduleSpecifier: `./${imported.filename}`,\n      }),\n    );\n    sf.addTypeAlias({\n      isExported: true,\n      name: model.title,\n      type: schemaToType(model.schema),\n      docs: docs({title: model.title}),\n    });\n  });\n\n/**\n * Emit models/index.ts re-exporting every model.\n */\nexport const emitModelsIndex = (models: Model[]): string =>\n  render((sf) =>\n    models.forEach((model) => sf.addExportDeclaration({moduleSpecifier: `./${model.filename}`})),\n  );\n","import {Security} from \"@automatons/parser\";\nimport {render} from \"./render\";\n\nconst callable = (returns: string, arg = \"\"): string =>\n  `${returns} | Promise<${returns}> | ((${arg}) => ${returns} | Promise<${returns}>)`;\n\nconst securityType = (security: Security): string => {\n  if (security.type === \"http\" && security.scheme === \"basic\") {\n    const basic = \"{username: string; password: string;}\";\n    return `${security.name}?: ${callable(basic)};`;\n  }\n  if (security.type === \"oauth2\" || security.type === \"openIdConnect\") {\n    return `${security.name}?: ${callable(\"string\", \"scopes?: string[]\")};`;\n  }\n  return `${security.name}?: ${callable(\"string\")};`;\n};\n\n/**\n * Emit config.ts: the Security map type and the Config type.\n */\nexport const emitConfig = (securities: Security[]): string =>\n  render((sf) => {\n    sf.addTypeAlias({\n      isExported: true,\n      name: \"Security\",\n      type: `{\\n${securities.map(securityType).join(\"\\n\")}\\n}`,\n    });\n    sf.addTypeAlias({\n      isExported: true,\n      name: \"Config\",\n      type: `{\n  fetch?: typeof fetch;\n  token?: string | Promise<string> | (() => string | Promise<string>);\n  security?: Security;\n}`,\n    });\n  });\n\n/**\n * Emit the top-level index.ts.\n */\nexport const emitIndex = (hasModels: boolean, hasApis: boolean): string =>\n  render((sf) => {\n    if (hasModels) sf.addExportDeclaration({moduleSpecifier: \"./models\"});\n    if (hasApis) sf.addExportDeclaration({moduleSpecifier: \"./apis\"});\n    sf.addExportDeclaration({moduleSpecifier: \"./config\"});\n  });\n","import {Security} from \"@automatons/parser\";\nimport {OptionalKind, MethodDeclarationOverloadStructure, Scope} from \"ts-morph\";\nimport {render} from \"./render\";\nimport {docs} from \"./comment\";\n\nconst FETCH_STATEMENTS = [\n  \"const DateFormat = /^\\\\d{4}-\\\\d{2}-\\\\d{2}([tT]\\\\d{2}:\\\\d{2}:\\\\d{2}(Z|[+-]\\\\d{2}:\\\\d{2})|Z)?$/;\",\n  \"const reviver = (_key: string, value: any) => typeof value === 'string' && DateFormat.test(value) ? new Date(value) : value;\",\n  \"const toQuery = (params: Record<string, unknown>): string => { const search = new URLSearchParams(); for (const [key, value] of Object.entries(params)) { if (value === undefined || value === null) continue; if (Array.isArray(value)) { value.forEach((item) => search.append(key, String(item))); } else { search.append(key, String(value)); } } return search.toString(); };\",\n];\n\nconst REQUEST_STATEMENTS = [\n  \"const { baseURL, params, headers, ...init } = config;\",\n  \"const search = toQuery(params);\",\n  'const url = `${baseURL}${path}${search ? `?${search}` : \"\"}`;',\n  \"const _headers = new Headers(headers);\",\n  'if (init.body instanceof FormData) { _headers.delete(\"Content-Type\"); }',\n  \"const response = await this.fetch(url, { ...init, method, headers: _headers });\",\n  \"const text = await response.text();\",\n  \"const data = (text ? JSON.parse(text, reviver) : undefined) as T;\",\n  \"return { data, status: response.status, statusText: response.statusText, headers: response.headers, response };\",\n];\n\nconst overload = (security: Security): OptionalKind<MethodDeclarationOverloadStructure> => {\n  const base = {scope: Scope.Protected, isAsync: true};\n  if (security.type === \"http\" && security.scheme === \"basic\") {\n    return {\n      ...base,\n      parameters: [{name: \"key\", type: `\"${security.name}\"`}],\n      returnType: \"Promise<{username: string; password: string;}>\",\n    };\n  }\n  if (security.type === \"oauth2\" || security.type === \"openIdConnect\") {\n    return {\n      ...base,\n      parameters: [{name: \"key\", type: `\"${security.name}\"`}, {name: \"scopes\", type: \"string[]\"}],\n      returnType: \"Promise<string>\",\n    };\n  }\n  return {...base, parameters: [{name: \"key\", type: `\"${security.name}\"`}], returnType: \"Promise<string>\"};\n};\n\n/**\n * Emit apis/abstractApi.ts: the shared fetch runtime plus the AbstractConfig / AbstractApi base classes.\n */\nexport const emitAbstractApi = (securities: Security[]): string =>\n  render((sf) => {\n    sf.addImportDeclaration({\n      isTypeOnly: true,\n      namedImports: securities.length ? [\"Config\", \"Security\"] : [\"Config\"],\n      moduleSpecifier: \"../config\",\n    });\n\n    sf.addTypeAlias({\n      isExported: true,\n      name: \"RequestConfig\",\n      type: \"Omit<RequestInit, 'headers'> & { baseURL: string; params: Record<string, unknown>; headers: Record<string, string>; }\",\n    });\n    sf.addTypeAlias({\n      isExported: true,\n      name: \"FetchResponse\",\n      typeParameters: [{name: \"T\", default: \"unknown\"}],\n      type: \"{ data: T; status: number; statusText: string; headers: Headers; response: Response; }\",\n    });\n\n    sf.addStatements(FETCH_STATEMENTS);\n\n    const abstractConfig = sf.addClass({isExported: true, name: \"AbstractConfig\", docs: docs({title: \"AbstractConfig\"})});\n    if (securities.length) {\n      abstractConfig.addProperty({name: \"#security\", isReadonly: true, type: \"Security\"});\n      abstractConfig.addConstructor({\n        docs: docs({title: \"constructor\"}),\n        parameters: [{name: \"security\", type: \"Security\", initializer: \"{}\"}],\n        statements: [\"this.#security = security;\"],\n      });\n      const scoped = securities.some((s) => s.type === \"oauth2\" || s.type === \"openIdConnect\");\n      abstractConfig.addMethod({\n        scope: Scope.Protected,\n        isAsync: true,\n        name: \"security\",\n        overloads: securities.map(overload),\n        parameters: [\n          {name: \"key\", type: \"keyof Security\"},\n          ...(scoped ? [{name: \"scopes\", type: \"string[]\", hasQuestionToken: true}] : []),\n        ],\n        returnType: \"Promise<string | {username: string; password: string;}>\",\n        statements: [\n          \"const security = this.#security[key];\",\n          'if (!security) { throw new Error(\"Unauthorized user request.\"); }',\n          `else if (security instanceof Function) { ${scoped ? \"return scopes ? security(scopes) : security();\" : \"return security();\"} }`,\n          \"return security;\",\n        ],\n      });\n    }\n\n    const abstractApi = sf.addClass({isExported: true, name: \"AbstractApi\", docs: docs({title: \"AbstractApi\"})});\n    abstractApi.addProperty({scope: Scope.Protected, name: \"fetch\", type: \"typeof fetch\", initializer: \"fetch\"});\n    abstractApi.addConstructor({\n      docs: docs({title: \"constructor\"}),\n      parameters: [{name: \"config\", type: \"Config\"}],\n      statements: [\"if (config.fetch) { this.fetch = config.fetch; }\"],\n    });\n    abstractApi.addMethod({\n      scope: Scope.Protected,\n      isAsync: true,\n      name: \"request\",\n      typeParameters: [{name: \"T\", default: \"unknown\"}],\n      parameters: [\n        {name: \"path\", type: \"string\"},\n        {name: \"method\", type: \"string\"},\n        {name: \"config\", type: \"RequestConfig\"},\n      ],\n      returnType: \"Promise<FetchResponse<T>>\",\n      statements: REQUEST_STATEMENTS,\n    });\n  });\n","import {AffectPath, Api, Path, Schema, Security, Server} from \"@automatons/parser\";\nimport {OptionalKind, ParameterDeclarationStructure, Scope} from \"ts-morph\";\nimport {render} from \"./render\";\nimport {schemaToType} from \"./schema\";\nimport {docs} from \"./comment\";\nimport {extractApiMeta} from \"../extractors/api\";\n\nconst isAffect = (path: Path): path is AffectPath => [\"post\", \"put\", \"patch\"].includes(path.method);\nconst formsOf = (path: Path): NonNullable<AffectPath[\"forms\"]> => (isAffect(path) && path.forms ? path.forms : []);\n\ntype Entry = {name: string; required?: boolean; schema: Schema};\nconst objectType = (entries: ReadonlyArray<Entry>): string =>\n  `{ ${entries.map((e) => `${e.name}${e.required ? \"\" : \"?\"}: ${schemaToType(e.schema)}, `).join(\"\")}}`;\nconst allOptional = (entries: ReadonlyArray<{required?: boolean}> = []): boolean => entries.every((e) => !e.required);\n\nconst contentType = (path: Path): string => {\n  const forms = formsOf(path);\n  return forms.length\n    ? forms.map((form) => form.types.map((type) => `'${type}'`).join(\" | \")).join(\" | \")\n    : \"'application/json'\";\n};\nconst headersType = (path: Path): string =>\n  `{ 'Content-Type': ${contentType(path)}, ${(path.headers ?? [])\n    .map((h) => `${h.name}${h.required ? \"\" : \"?\"}: ${schemaToType(h.schema)}, `)\n    .join(\"\")}}`;\n\nconst serverUnion = (servers: Server[]): string => servers.map((server) => `${server.name}Server`).join(\" | \");\nconst serverDefault = (servers: Server[]): string | undefined => {\n  const [first] = servers;\n  return servers.length === 1 && first && !(first.values && first.values.length)\n    ? `{ name: '${first.name}' }`\n    : undefined;\n};\n\nconst withInit = (init?: string): {initializer: string} | object => (init ? {initializer: init} : {});\n\nconst queriesParam = (path: Path): OptionalKind<ParameterDeclarationStructure> | undefined =>\n  path.queries?.length\n    ? {name: \"queries\", type: objectType(path.queries), ...withInit(allOptional(path.queries) ? \"{}\" : undefined)}\n    : undefined;\nconst cookiesParam = (path: Path): OptionalKind<ParameterDeclarationStructure> | undefined =>\n  path.cookies?.length\n    ? {name: \"cookies\", type: objectType(path.cookies), ...withInit(allOptional(path.cookies) ? \"{}\" : undefined)}\n    : undefined;\nconst headersParam = (path: Path): OptionalKind<ParameterDeclarationStructure> => ({\n  name: \"headers\",\n  type: headersType(path),\n  ...withInit(allOptional(path.headers) ? \"{ 'Content-Type': 'application/json' }\" : undefined),\n});\nconst serverParam = (path: Path): OptionalKind<ParameterDeclarationStructure> | undefined =>\n  path.servers?.length\n    ? {name: \"server\", type: serverUnion(path.servers), ...withInit(serverDefault(path.servers))}\n    : undefined;\nconst configParam = (): OptionalKind<ParameterDeclarationStructure> => ({\n  name: \"config\",\n  type: \"RequestInit\",\n  hasQuestionToken: true,\n});\nconst compact = <T>(items: (T | undefined)[]): T[] => items.filter((item): item is T => item !== undefined);\n\nconst requestParams = (path: Path): OptionalKind<ParameterDeclarationStructure>[] => {\n  const forms = formsOf(path);\n  return compact([\n    ...(path.parameters ?? []).map((p) => ({name: p.name, type: schemaToType(p.schema)})),\n    forms.length ? {name: \"form\", type: forms.map((form) => schemaToType(form.schema)).join(\" | \")} : undefined,\n    queriesParam(path),\n    cookiesParam(path),\n    headersParam(path),\n    serverParam(path),\n    configParam(),\n  ]);\n};\nconst configParams = (path: Path): OptionalKind<ParameterDeclarationStructure>[] =>\n  compact([queriesParam(path), cookiesParam(path), headersParam(path), serverParam(path), configParam()]);\n\nconst requestVariables = (path: Path): string =>\n  compact([\n    path.queries?.length ? \"queries\" : undefined,\n    path.cookies?.length ? \"cookies\" : undefined,\n    \"headers\",\n    path.servers?.length ? \"server\" : undefined,\n    \"config\",\n  ]).join(\", \");\n\nconst requestBody = (api: Api, path: Path): string[] => {\n  const forms = formsOf(path);\n  const replaces = (path.parameters ?? [])\n    .map((p) => `.replace(\"{${p.name}}\", template('${p.name}', ${p.name}, '${p.style ?? \"simple\"}', ${p.explode ?? false}))`)\n    .join(\"\");\n  void api;\n  const generic = path.schema ? `<${schemaToType(path.schema)}>` : \"\";\n  const request = forms.length\n    ? `{ ...requestConfig, body: body(headers['Content-Type'], form) }`\n    : \"requestConfig\";\n  return compact([\n    `const path = \"${path.path}\"${replaces};`,\n    `const requestConfig = await this.#config.${path.name}(${requestVariables(path)});`,\n    `return this.request${generic}(path, \"${path.method.toUpperCase()}\", ${request});`,\n  ]);\n};\n\nconst configBody = (api: Api, path: Path): string[] => {\n  const securities = path.securities ?? [];\n  const params = compact([\n    ...(path.queries ?? []).map((q) => `...query(\"${q.name}\", queries.${q.name}, '${q.style ?? \"form\"}', ${q.explode ?? false}),`),\n    ...securities.map((s) => (s.type === \"apiKey\" && s.in === \"query\" ? `${s.key}: await this.security(\"${s.name}\"),` : undefined)),\n  ]);\n  const cookieStatements = compact<string>([\n    ...(path.cookies ?? []).map(\n      (c) =>\n        `if (cookies.${c.name}) { _cookies += Object.entries(query('${c.name}', cookies.${c.name}, 'form', ${c.explode ?? false})).reduce((pre, [key, value]) => \\`\\${pre}\\${key}=\\${value};\\`, ''); }`,\n    ),\n    ...securities.flatMap((s) =>\n      s.type === \"apiKey\" && s.in === \"cookie\"\n        ? [\n            `const _cookie${s.name} = await this.security(\"${s.name}\");`,\n            `if (_cookie${s.name}) { _cookies += \\`${s.key}=\\${_cookie${s.name}};\\`; }`,\n          ]\n        : [],\n    ),\n  ]);\n  const headerStatements = compact<string>([\n    ...(path.headers ?? []).map(\n      (h) => `if (headers.${h.name}) { _headers['${h.name}'] = template('${h.name}', headers.${h.name}, 'simple', ${h.explode ?? false}); }`,\n    ),\n    ...securities.map((s) => {\n      if (s.type === \"apiKey\" && s.in === \"header\") return `_headers['${s.key}'] = await this.security(\"${s.name}\");`;\n      if (s.type === \"http\" && s.scheme === \"bearer\") return `_headers['Authorization'] = \\`Bearer \\${await this.security(\"${s.name}\")}\\`;`;\n      if (s.type === \"http\" && s.scheme === \"basic\")\n        return `const _basic${s.name} = await this.security(\"${s.name}\"); _headers['Authorization'] = \\`Basic \\${btoa(\\`\\${_basic${s.name}.username}:\\${_basic${s.name}.password}\\`)}\\`;`;\n      if (s.type === \"oauth2\" || s.type === \"openIdConnect\")\n        return `_headers['Authorization'] = \\`Bearer \\${await this.security(\"${s.name}\", [${s.scopes.map((x) => `\"${x}\"`).join(\", \")}])}\\`;`;\n      return undefined;\n    }),\n  ]);\n  const hasCookies = cookieStatements.length > 0;\n  return compact([\n    `const params = { ${params.join(\" \")} };`,\n    hasCookies ? \"let _cookies = '';\" : undefined,\n    ...cookieStatements,\n    \"const _headers = Object.fromEntries(new Headers(config?.headers)) as Record<string, string>;\",\n    \"_headers['Content-Type'] = headers['Content-Type'];\",\n    ...headerStatements,\n    hasCookies ? \"if (_cookies) { _headers['Cookie'] = _cookies; }\" : undefined,\n    `return { ...config, baseURL: ${api.title}Config.server(server), params, headers: _headers };`,\n  ]);\n};\n\nconst serverTypeAlias = (server: Server): string => {\n  const values = server.values?.length\n    ? `; values: { ${server.values\n        .map((v) => `${v.name}: ${v.enums?.length ? v.enums.map((e) => `'${e}'`).join(\" | \") : \"string\"} `)\n        .join(\"\")}}`\n    : \"\";\n  return `{ name: \"${server.name}\"${values} }`;\n};\n\nconst serverMethodStatements = (servers: Server[]): string[] => [\n  ...servers.map((server) => {\n    const replaces = (server.values ?? [])\n      .map((v) => `.replace('{${v.name}}', template('${v.name}', server.values.${v.name}, 'simple', false))`)\n      .join(\"\");\n    return `if ('${server.name}' === server.name) { return '${server.url}'${replaces}; }`;\n  }),\n  \"throw new Error('Undefined server. please define server.');\",\n];\n\nconst utilImports = (api: Api): string[] => {\n  const meta = extractApiMeta(api);\n  return compact([meta.hasTemplate ? \"template\" : undefined, meta.hasQuery ? \"query\" : undefined, meta.hasFormData ? \"body\" : undefined]);\n};\n\n/**\n * Emit a single api file: the typed fetch client class and its request-config class.\n */\nexport const emitApi = (api: Api, securities: Security[]): string =>\n  render((sf) => {\n    sf.addImportDeclaration({\n      namedImports: [\"AbstractApi\", \"AbstractConfig\", \"FetchResponse\", \"RequestConfig\"],\n      moduleSpecifier: \"./abstractApi\",\n    });\n    sf.addImportDeclaration({\n      namedImports: securities.length ? [\"Config\", \"Security\"] : [\"Config\"],\n      moduleSpecifier: \"../config\",\n    });\n    const utils = utilImports(api);\n    if (utils.length) sf.addImportDeclaration({namedImports: utils, moduleSpecifier: \"../utils\"});\n    if (api.imports.length) sf.addImportDeclaration({namedImports: api.imports.map((m) => m.title), moduleSpecifier: \"../models\"});\n\n    api.servers.forEach((server) => sf.addTypeAlias({name: `${server.name}Server`, type: serverTypeAlias(server)}));\n\n    const apiClass = sf.addClass({isExported: true, name: api.title, extends: \"AbstractApi\", docs: docs({title: api.title})});\n    apiClass.addProperty({name: \"#config\", isReadonly: true, type: `${api.title}Config`});\n    apiClass.addConstructor({\n      docs: docs({title: \"constructor\"}),\n      parameters: [{name: \"config\", type: \"Config\", initializer: \"{}\"}],\n      statements: [\"super(config);\", `this.#config = new ${api.title}Config(${securities.length ? \"config.security\" : \"\"});`],\n    });\n    api.paths.forEach((path) =>\n      apiClass.addMethod({\n        scope: Scope.Public,\n        isAsync: true,\n        name: path.name,\n        docs: docs({title: path.name, async: true}),\n        parameters: requestParams(path),\n        returnType: `Promise<FetchResponse${path.schema ? `<${schemaToType(path.schema)}>` : \"\"}>`,\n        statements: requestBody(api, path),\n      }),\n    );\n\n    const configClass = sf.addClass({name: `${api.title}Config`, extends: \"AbstractConfig\"});\n    if (securities.length)\n      configClass.addConstructor({\n        parameters: [{name: \"security\", type: \"Security\", initializer: \"{}\"}],\n        statements: [\"super(security);\"],\n      });\n    configClass.addMethod({\n      isStatic: true,\n      scope: Scope.Private,\n      name: \"server\",\n      parameters: [{name: \"server\", type: serverUnion(api.servers.length ? api.servers : api.paths[0]?.servers ?? [])}],\n      statements: serverMethodStatements(api.servers.length ? api.servers : api.paths[0]?.servers ?? []),\n    });\n    api.paths.forEach((path) =>\n      configClass.addMethod({\n        scope: Scope.Public,\n        isAsync: true,\n        name: path.name,\n        parameters: configParams(path),\n        returnType: \"Promise<RequestConfig>\",\n        statements: configBody(api, path),\n      }),\n    );\n  });\n\n/**\n * Emit apis/index.ts re-exporting every api.\n */\nexport const emitApisIndex = (apis: Api[]): string =>\n  render((sf) => apis.forEach((api) => sf.addExportDeclaration({moduleSpecifier: `./${api.filename}`})));\n","import {AffectPath, Api, Path} from \"@automatons/parser\";\n\nconst isAffectPath = (path: Path): path is AffectPath => ['post', 'patch', 'put'].includes(path.method);\n\nexport const extractApiMeta = (api: Api) => {\n  const hasTemplate = api.servers.some(server => server.values?.length)\n    || api.paths.some(path => path.parameters?.length)\n    || api.paths.some(path => path.headers?.length);\n  const hasQuery = api.paths.some(path => path.queries?.length)\n    || api.paths.some(path => path.cookies?.length);\n  const hasFormData = api.paths.some(path => isAffectPath(path) ? path.forms?.length : false);\n  return {hasQuery, hasTemplate, hasFormData};\n};\n","import path from \"node:path\";\nimport {readdir, readFile} from \"node:fs/promises\";\nimport paths from \"../paths\";\nimport {write} from \"./render\";\n\n/**\n * Copy the static utility files (template/query/formData/index) into the output.\n */\nexport const emitStatics = async (outDir: string): Promise<void> => {\n  const dir = path.join(paths.static, \"utils\");\n  const files = await readdir(dir);\n  await Promise.all(\n    files.map(async (file) => {\n      const text = await readFile(path.join(dir, file), {encoding: \"utf-8\"});\n      await write(outDir, path.join(\"utils\", file), text);\n    }),\n  );\n};\n","import path from \"node:path\";\n\nconst paths = {\n  static: path.resolve(import.meta.dirname, \"static\"),\n  tmp: path.resolve(import.meta.dirname, \"../tmp\"),\n};\nexport default paths;\n","import {Automaton} from \"@automatons/tools\";\nimport {generate} from \"./generator\";\n\nconst generatorTypescriptFetchClient: Automaton = (openapi, settings) =>\n  generate(openapi, settings);\n\nexport default generatorTypescriptFetchClient;\n"],"mappings":"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","names":["Scope","path","path","Scope","path","path","path"]}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@automatons/typescript-client-fetch",
+  "version": "1.0.0",
+  "repository": "https://github.com/openapi-automatons/typescript-client-fetch.git",
+  "author": "tanmen <yt.prog@gmail.com>",
+  "license": "MIT",
+  "packageManager": "yarn@1.22.22",
+  "type": "module",
+  "keywords": [
+    "openapi",
+    "openapi-automatons",
+    "automatons",
+    "fetch"
+  ],
+  "main": "index.js",
+  "module": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    }
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "prebuild": "depcheck",
+    "build": "tsup && cp -R src/static dist/ && cp package.json README.md LICENSE dist",
+    "lint": "eslint src",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:integration": "tsx scripts/pretest.ts && vitest run --config test/vitest.config.ts",
+    "prepare": "husky"
+  },
+  "dependencies": {
+    "@automatons/parser": "^1.0.0",
+    "@automatons/tools": "^2.0.0",
+    "prettier": "^3.8.3",
+    "ts-morph": "^28.0.0"
+  },
+  "peerDependencies": {
+    "object-to-formdata": "^4",
+    "openapi-automatons": "^2"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^21.0.2",
+    "@commitlint/config-conventional": "^21.0.2",
+    "@eslint/js": "^10.0.1",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/node": "^24.0.0",
+    "@vitest/coverage-v8": "^3.2.0",
+    "depcheck": "^1.4.7",
+    "eslint": "^10.4.1",
+    "eslint-config-prettier": "^10.1.8",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.0.7",
+    "object-to-formdata": "^4.5.1",
+    "semantic-release": "^25.0.3",
+    "tsup": "^8.5.0",
+    "tsx": "^4.19.0",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.46.0",
+    "vitest": "^3.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/static/utils/body.ts

@@ -0,0 +1,13 @@
+import { serialize } from 'object-to-formdata';
+
+export const body = <T = unknown>(type: string, form: T): BodyInit | undefined => {
+	if (form === undefined || form === null) return undefined;
+	switch (type) {
+		case 'multipart/form-data':
+			return serialize(form);
+		case 'application/x-www-form-urlencoded':
+			return new URLSearchParams(form as unknown as Record<string, string>);
+		default:
+			return JSON.stringify(form);
+	}
+}

package/static/utils/index.ts

@@ -0,0 +1,3 @@
+export * from './template';
+export * from './query';
+export * from './body';

package/static/utils/query.ts

@@ -0,0 +1,79 @@
+type ParsedUrlQueryInput = { [key: string]: string | number | boolean | ReadonlyArray<string> | ReadonlyArray<number> | ReadonlyArray<boolean> | null | undefined }
+
+const isObject = (value: any): value is object => {
+	const type = typeof value
+	return value != null && (type == 'object' || type == 'function')
+}
+
+const queryForm =
+  (name: string,
+   value: string | number | Array<string | number> | { [key: string]: string | number },
+   explode: boolean): ParsedUrlQueryInput => {
+    if (Array.isArray(value)) {
+      if (explode) {
+        return {[name]: value.map(String)}
+      } else {
+        return {[name]: value.join(',')}
+      }
+    } else if (isObject(value)) {
+      if (explode) {
+        return value;
+      } else {
+        return {[name]: Object.entries(value).map((prop: [string, string | number]) => prop.join(',')).join(',')}
+      }
+    } else {
+      return {[name]: value};
+    }
+  }
+
+const querySpaceDelimited =
+  (name: string,
+   value: string | number | Array<string | number> | { [key: string]: string | number }): ParsedUrlQueryInput => {
+    if (Array.isArray(value)) {
+      return {[name]: value.join(' ')}
+    } else if (isObject(value)) {
+      return {[name]: Object.entries(value).map((prop: [string, string | number]) => prop.join(' ')).join(' ')}
+    }
+    throw new Error(`Unsupported value: ${name}`);
+  }
+
+const queryPipeDelimited =
+  (name: string,
+   value: string | number | Array<string | number> | { [key: string]: string | number }): ParsedUrlQueryInput => {
+    if (Array.isArray(value)) {
+      return {[name]: value.join('|')}
+    } else if (isObject(value)) {
+      return {[name]: Object.entries(value).map((prop: [string, string | number]) => prop.join('|')).join('|')}
+    }
+    throw new Error(`Unsupported value: ${name}`);
+  }
+
+const queryDeepObject =
+  (name: string,
+   value: string | number | Array<string | number> | { [key: string]: string | number }): ParsedUrlQueryInput => {
+    if (!Array.isArray(value) && isObject(value)) {
+      return Object.keys(value).reduce((pre, cur) => ({...pre, [`${name}[${cur}]`]: value[cur]}), {});
+    }
+    throw new Error(`Unsupported value: ${name}`);
+  }
+
+export const query =
+  (
+    name: string,
+    value: undefined | string | number | Array<string | number> | { [key: string]: string | number },
+    style: 'form' | 'spaceDelimited' | 'pipeDelimited' | 'deepObject',
+    explode: boolean): ParsedUrlQueryInput => {
+    if (value === undefined) return {};
+    switch (style) {
+      case 'form':
+        return queryForm(name, value, explode);
+      case 'spaceDelimited':
+        return querySpaceDelimited(name, value);
+      case 'pipeDelimited':
+        return queryPipeDelimited(name, value);
+      case 'deepObject':
+        return queryDeepObject(name, value);
+      default:
+        throw new Error(`Unsupported style: ${style}`);
+    }
+  }

package/static/utils/template.ts

@@ -0,0 +1,55 @@
+const templateSimple = (explode: boolean, value: string | number | Array<string | number> | { [p: string]: string | number }): string => {
+  if (!explode) {
+    return value instanceof Object
+      ? Array.isArray(value)
+        ? value.join(',') : Object.entries(value).map(prop => prop.join(',')).flat().join(',')
+      : String(value);
+  }
+  return value instanceof Object
+    ? Array.isArray(value)
+      ? value.join(',') : Object.entries(value).map(([key, value]) => `${key}=${value}`).flat().join(',')
+    : String(value);
+}
+
+const templateLabel = (explode: boolean, value: string | number | Array<string | number> | { [p: string]: string | number }): string => {
+  if (!explode) {
+    return `.${value instanceof Object
+      ? Array.isArray(value)
+        ? value.join(',') : Object.entries(value).map(prop => prop.join(',')).flat().join(',')
+      : String(value)}`;
+  }
+  return value instanceof Object
+    ? Array.isArray(value)
+      ? value.join(',') : Object.entries(value).map(([key, value]) => `${key}=${value}`).flat().join(',')
+    : String(value);
+}
+
+const templateMatrix = (explode: boolean, name: string, value: string | number | Array<string | number> | { [p: string]: string | number }): string => {
+  if (!explode) {
+    return `;${name}=${value instanceof Object
+      ? Array.isArray(value)
+        ? value.join(',') : Object.entries(value).map(prop => prop.join(',')).flat().join(',')
+      : String(value)}`;
+  }
+  return `;${value instanceof Object
+    ? Array.isArray(value)
+      ? value.map(item => `${name}=${item}`).join(';')
+      : Object.entries(value).map(([key, value]) => `${key}=${value}`).flat().join(';')
+    : `${name}=${String(value)}`}`;
+}
+
+export const template =
+  (
+    name: string,
+    value: string | number | Array<string | number> | { [key: string]: string | number },
+    style: 'simple' | 'label' | 'matrix',
+    explode: boolean): string => {
+    if (style === 'simple') {
+      return templateSimple(explode, value);
+    } else if (style === 'label') {
+      return templateLabel(explode, value);
+    } else if (style === 'matrix') {
+      return templateMatrix(explode, name, value);
+    }
+    throw new Error(`Unsupported style: ${style}`)
+  }