axigen 0.1.1 → 1.1.0

package/dist/cli/index.mjs

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-#!/usr/bin/env node
 
 // src/cli/index.ts
 import { Command } from "commander";
@@ -67,9 +66,52 @@ function validateConfig(raw, filePath) {
     axiosInstanceExport: typeof cfg.axiosInstanceExport === "string" ? cfg.axiosInstanceExport : "axiosInstance",
     language: cfg.language === "js" ? "js" : "ts",
     jsdoc: cfg.jsdoc !== false,
-    tags: Array.isArray(cfg.tags) ? cfg.tags : void 0
+    tags: Array.isArray(cfg.tags) ? cfg.tags : void 0,
+    functionName: validateFunctionNameConfig(cfg.functionName, filePath)
   };
 }
+function validateFunctionNameConfig(raw, filePath) {
+  if (raw === void 0 || raw === null) return void 0;
+  if (typeof raw !== "object") {
+    throw new Error(`Config error: "functionName" must be an object`);
+  }
+  const fn = raw;
+  const result = {};
+  if (fn.transforms !== void 0) {
+    if (!Array.isArray(fn.transforms)) {
+      throw new Error(`Config error: "functionName.transforms" must be an array`);
+    }
+    result.transforms = fn.transforms.map((t, i) => {
+      if (!t || typeof t !== "object") {
+        throw new Error(`Config error: "functionName.transforms[${i}]" must be an object`);
+      }
+      const transform = t;
+      if (typeof transform.match !== "string") {
+        throw new Error(`Config error: "functionName.transforms[${i}].match" must be a string regex pattern`);
+      }
+      if (typeof transform.replacement !== "string") {
+        throw new Error(`Config error: "functionName.transforms[${i}].replacement" must be a string`);
+      }
+      try {
+        new RegExp(transform.match, transform.flags ?? "g");
+      } catch {
+        throw new Error(`Config error: "functionName.transforms[${i}].match" is not a valid regex: ${transform.match}`);
+      }
+      return {
+        match: transform.match,
+        flags: typeof transform.flags === "string" ? transform.flags : "g",
+        replacement: transform.replacement
+      };
+    });
+  }
+  if (fn.appendMethod !== void 0) {
+    if (typeof fn.appendMethod !== "boolean" && !Array.isArray(fn.appendMethod)) {
+      throw new Error(`Config error: "functionName.appendMethod" must be a boolean or an array of HTTP methods`);
+    }
+    result.appendMethod = fn.appendMethod;
+  }
+  return result;
+}
 
 // src/generate.ts
 import fs3 from "fs";
@@ -244,6 +286,7 @@ function generateTypesFile(endpoints, schemas = {}) {
   lines.push(`// This file is auto-generated by axigen. DO NOT EDIT.`);
   lines.push(`// Generated at: ${(/* @__PURE__ */ new Date()).toISOString()}`);
   lines.push("");
+  const declaredInComponents = new Set(Object.keys(schemas));
   if (Object.keys(schemas).length > 0) {
     lines.push("// \u2500\u2500\u2500 Component Schemas \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
     lines.push("");
@@ -255,48 +298,118 @@ function generateTypesFile(endpoints, schemas = {}) {
       lines.push("");
     }
   }
-  lines.push("// \u2500\u2500\u2500 Endpoint Types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-  lines.push("");
+  const endpointLines = [];
   for (const ep of endpoints) {
     const baseName = operationToTypeName(ep.operationId);
     if (ep.pathParams.length > 0) {
-      lines.push(`export interface ${baseName}PathParams {`);
+      endpointLines.push(`export interface ${baseName}PathParams {`);
       for (const p of ep.pathParams) {
         const type = schemaToTSType(p.schema);
         const comment = p.description ? `  /** ${p.description} */
 ` : "";
-        lines.push(`${comment}  ${p.name}: ${type}`);
+        endpointLines.push(`${comment}  ${p.name}: ${type}`);
       }
-      lines.push(`}`);
-      lines.push("");
+      endpointLines.push(`}`);
+      endpointLines.push("");
     }
     if (ep.queryParams.length > 0) {
-      lines.push(`export interface ${baseName}QueryParams {`);
+      endpointLines.push(`export interface ${baseName}QueryParams {`);
       for (const p of ep.queryParams) {
         const optional = !p.required ? "?" : "";
         const type = schemaToTSType(p.schema);
         const comment = p.description ? `  /** ${p.description} */
 ` : "";
-        lines.push(`${comment}  ${p.name}${optional}: ${type}`);
+        endpointLines.push(`${comment}  ${p.name}${optional}: ${type}`);
       }
-      lines.push(`}`);
-      lines.push("");
+      endpointLines.push(`}`);
+      endpointLines.push("");
     }
     if (ep.bodySchema) {
-      lines.push(`export type ${baseName}Body = ${schemaToTSType(ep.bodySchema)}`);
-      lines.push("");
+      const refName = getRefName(ep.bodySchema);
+      if (refName && declaredInComponents.has(refName)) {
+        if (`${baseName}Body` !== refName) {
+          endpointLines.push(`export type ${baseName}Body = ${refName}`);
+          endpointLines.push("");
+        }
+      } else {
+        endpointLines.push(`export type ${baseName}Body = ${schemaToTSType(ep.bodySchema)}`);
+        endpointLines.push("");
+      }
     }
     if (ep.responseSchema) {
-      lines.push(`export type ${baseName}Response = ${schemaToTSType(ep.responseSchema)}`);
-      lines.push("");
+      const refName = getRefName(ep.responseSchema);
+      if (refName && declaredInComponents.has(refName)) {
+        if (`${baseName}Response` !== refName) {
+          endpointLines.push(`export type ${baseName}Response = ${refName}`);
+          endpointLines.push("");
+        }
+      } else {
+        endpointLines.push(`export type ${baseName}Response = ${schemaToTSType(ep.responseSchema)}`);
+        endpointLines.push("");
+      }
     }
   }
+  if (endpointLines.length > 0) {
+    lines.push("// \u2500\u2500\u2500 Endpoint Types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    lines.push("");
+    lines.push(...endpointLines);
+  }
   return lines.join("\n");
 }
+function getRefName(schema) {
+  if (schema.$ref) return refToTypeName(schema.$ref);
+  return void 0;
+}
 function operationToTypeName(operationId) {
   return operationId.charAt(0).toUpperCase() + operationId.slice(1);
 }
 
+// src/generator/function-name.ts
+function resolveFunctionName(operationId, method, config) {
+  if (!config) return operationId;
+  let name = operationId;
+  if (config.transforms && config.transforms.length > 0) {
+    for (const transform of config.transforms) {
+      name = applyTransform(name, transform);
+    }
+  }
+  if (shouldAppendMethod(method, config.appendMethod)) {
+    const suffix = method.charAt(0).toUpperCase() + method.slice(1).toLowerCase();
+    name = name + suffix;
+  }
+  return name;
+}
+function applyTransform(input, transform) {
+  const flags = transform.flags ?? "g";
+  const regex = new RegExp(transform.match, flags);
+  const { replacement } = transform;
+  const upperMatch = replacement.match(/^upper:\$(\d+)$/);
+  if (upperMatch) {
+    const groupIndex = parseInt(upperMatch[1], 10);
+    return input.replace(regex, (...args) => {
+      const captured = args[groupIndex];
+      return captured ? captured.toUpperCase() : "";
+    });
+  }
+  const lowerMatch = replacement.match(/^lower:\$(\d+)$/);
+  if (lowerMatch) {
+    const groupIndex = parseInt(lowerMatch[1], 10);
+    return input.replace(regex, (...args) => {
+      const captured = args[groupIndex];
+      return captured ? captured.toLowerCase() : "";
+    });
+  }
+  return input.replace(regex, replacement);
+}
+function shouldAppendMethod(method, appendMethod) {
+  if (!appendMethod) return false;
+  if (appendMethod === true) return true;
+  if (Array.isArray(appendMethod)) {
+    return appendMethod.map((m) => m.toLowerCase()).includes(method.toLowerCase());
+  }
+  return false;
+}
+
 // src/generator/axios.ts
 function generateClientFile(opts) {
   const { endpoints, config, typesRelativePath } = opts;
@@ -307,7 +420,7 @@ function generateClientFile(opts) {
   lines.push(`// Generated at: ${(/* @__PURE__ */ new Date()).toISOString()}`);
   lines.push("");
   if (isTS) {
-    lines.push(`import type { AxiosResponse } from 'axios'`);
+    lines.push(`import type { AxiosRequestConfig, AxiosResponse } from 'axios'`);
   }
   lines.push(`import { ${instanceExport} } from '${config.axiosInstancePath}'`);
   if (isTS && typesRelativePath) {
@@ -319,13 +432,15 @@ function generateClientFile(opts) {
   lines.push("");
   lines.push("");
   for (const ep of endpoints) {
-    const fn = buildFunction(ep, isTS, instanceExport, config.jsdoc !== false);
+    const fn = buildFunction(ep, isTS, instanceExport, config);
     lines.push(fn);
     lines.push("");
   }
   return lines.join("\n");
 }
-function buildFunction(ep, isTS, instanceExport, jsdoc) {
+function buildFunction(ep, isTS, instanceExport, config) {
+  const jsdoc = config.jsdoc !== false;
+  const fnName = resolveFunctionName(ep.operationId, ep.method, config.functionName);
   const typeName = operationToTypeName(ep.operationId);
   const lines = [];
   if (jsdoc) {
@@ -340,9 +455,8 @@ function buildFunction(ep, isTS, instanceExport, jsdoc) {
   }
   const params = buildParams(ep, typeName, isTS);
   const returnType = isTS ? buildReturnType(ep, typeName) : "";
-  const asyncKw = "async ";
-  lines.push(`export ${asyncKw}function ${ep.operationId}(${params})${returnType} {`);
-  const callLines = buildAxiosCall(ep, instanceExport, typeName, isTS);
+  lines.push(`export async function ${fnName}(${params})${returnType} {`);
+  const callLines = buildAxiosCall(ep, instanceExport);
   for (const l of callLines) {
     lines.push(`  ${l}`);
   }
@@ -365,31 +479,36 @@ function buildParams(ep, typeName, isTS) {
     const type = isTS ? `: ${typeName}QueryParams` : "";
     parts.push(`params${optional}${type}`);
   }
+  if (isTS) {
+    parts.push(`config?: AxiosRequestConfig`);
+    parts.push(`options?: AxiosRequestConfig`);
+  } else {
+    parts.push(`config`);
+    parts.push(`options`);
+  }
   return parts.join(", ");
 }
 function buildReturnType(ep, typeName) {
   const responseType = ep.responseSchema ? `${typeName}Response` : "unknown";
   return `: Promise<AxiosResponse<${responseType}>>`;
 }
-function buildAxiosCall(ep, instanceExport, _typeName, _isTS) {
+function buildAxiosCall(ep, instanceExport) {
   const lines = [];
   const interpolatedPath = ep.pathParams.length > 0 ? "`" + ep.path.replace(/\{(\w+)\}/g, "${$1}") + "`" : `'${ep.path}'`;
   const hasBody = !!ep.bodySchema;
   const hasQuery = ep.queryParams.length > 0;
-  const method = ep.method.toLowerCase();
-  if (method === "get" || method === "delete" || method === "head") {
-    if (hasQuery) {
-      lines.push(`return ${instanceExport}.${method}(${interpolatedPath}, { params })`);
-    } else {
-      lines.push(`return ${instanceExport}.${method}(${interpolatedPath})`);
-    }
+  if (hasQuery) {
+    lines.push(`const mergedConfig: AxiosRequestConfig = { ...config, params: { ...params, ...config?.params } }`);
+  }
+  const configArg = hasQuery ? "mergedConfig" : "config";
+  if (hasBody) {
+    lines.push(
+      `return ${instanceExport}({ method: '${ep.method.toUpperCase()}', url: ${interpolatedPath}, data, ...${configArg} }, options)`
+    );
   } else {
-    const bodyArg = hasBody ? "data" : "undefined";
-    if (hasQuery) {
-      lines.push(`return ${instanceExport}.${method}(${interpolatedPath}, ${bodyArg}, { params })`);
-    } else {
-      lines.push(`return ${instanceExport}.${method}(${interpolatedPath}, ${bodyArg})`);
-    }
+    lines.push(
+      `return ${instanceExport}({ method: '${ep.method.toUpperCase()}', url: ${interpolatedPath}, ...${configArg} }, options)`
+    );
   }
   return lines;
 }

package/dist/index.d.mts

@@ -74,17 +74,66 @@ interface SchemaObject {
     default?: unknown;
     example?: unknown;
 }
+interface FunctionNameTransform {
+    /**
+     * Regex pattern to match parts of the operationId.
+     * Example: to convert "product-variant-create" to "productVariantCreate"
+     * use: { match: '-([a-z])', replacement: (_, c) => c.toUpperCase() }
+     *
+     * Defined as a string pattern (flags supported via `flags` field).
+     */
+    match: string;
+    /** Regex flags (e.g. 'g', 'gi'). Defaults to 'g'. */
+    flags?: string;
+    /**
+     * Replacement string. Supports capture groups via $1, $2, etc.
+     * Example: to capitalize the first char after a dash: use a replacer function
+     * defined as a template string like "upper:$1" — see docs for special tokens.
+     *
+     * Special tokens:
+     *   "upper:$1"  → uppercase capture group 1
+     *   "lower:$1"  → lowercase capture group 1
+     *   any other string is used as-is (standard String.replace replacement)
+     */
+    replacement: string;
+}
+interface FunctionNameConfig {
+    /**
+     * One or more regex transforms applied in order to the raw operationId.
+     * Each transform is applied to the result of the previous one.
+     */
+    transforms?: FunctionNameTransform[];
+    /**
+     * Append the HTTP method to the end of the function name.
+     * Can be set globally or per-method.
+     *
+     * Examples:
+     *   appendMethod: true          → always append
+     *   appendMethod: ['post','put'] → append only for these methods
+     */
+    appendMethod?: boolean | HttpMethod[];
+}
 interface AxigenConfig {
+    /** Path to the OpenAPI spec file (YAML or JSON) */
     input: string;
     output: {
+        /** Output path for generated Axios client functions */
         client: string;
+        /** Output path for generated TypeScript types (optional) */
         types?: string;
     };
+    /** Import path to the user's Axios instance */
     axiosInstancePath: string;
+    /** Named export of the Axios instance (default: "axiosInstance") */
     axiosInstanceExport?: string;
+    /** Output language (default: "ts") */
     language?: "ts" | "js";
+    /** Add JSDoc comments to generated functions (default: true) */
     jsdoc?: boolean;
+    /** Only generate endpoints matching these tags */
     tags?: string[];
+    /** Controls how generated function names are derived from operationIds */
+    functionName?: FunctionNameConfig;
 }
 interface ParsedEndpoint {
     operationId: string;
@@ -121,7 +170,7 @@ declare function extractEndpoints(spec: OpenAPISpec, filterTags?: string[]): Par
 interface GenerateClientOptions {
     endpoints: ParsedEndpoint[];
     config: AxigenConfig;
-    /** مسیر نسبی فایل types نسبت به فایل client */
+    /** Relative path to the types file from the client file */
     typesRelativePath?: string;
 }
 declare function generateClientFile(opts: GenerateClientOptions): string;

package/dist/index.d.ts

@@ -74,17 +74,66 @@ interface SchemaObject {
     default?: unknown;
     example?: unknown;
 }
+interface FunctionNameTransform {
+    /**
+     * Regex pattern to match parts of the operationId.
+     * Example: to convert "product-variant-create" to "productVariantCreate"
+     * use: { match: '-([a-z])', replacement: (_, c) => c.toUpperCase() }
+     *
+     * Defined as a string pattern (flags supported via `flags` field).
+     */
+    match: string;
+    /** Regex flags (e.g. 'g', 'gi'). Defaults to 'g'. */
+    flags?: string;
+    /**
+     * Replacement string. Supports capture groups via $1, $2, etc.
+     * Example: to capitalize the first char after a dash: use a replacer function
+     * defined as a template string like "upper:$1" — see docs for special tokens.
+     *
+     * Special tokens:
+     *   "upper:$1"  → uppercase capture group 1
+     *   "lower:$1"  → lowercase capture group 1
+     *   any other string is used as-is (standard String.replace replacement)
+     */
+    replacement: string;
+}
+interface FunctionNameConfig {
+    /**
+     * One or more regex transforms applied in order to the raw operationId.
+     * Each transform is applied to the result of the previous one.
+     */
+    transforms?: FunctionNameTransform[];
+    /**
+     * Append the HTTP method to the end of the function name.
+     * Can be set globally or per-method.
+     *
+     * Examples:
+     *   appendMethod: true          → always append
+     *   appendMethod: ['post','put'] → append only for these methods
+     */
+    appendMethod?: boolean | HttpMethod[];
+}
 interface AxigenConfig {
+    /** Path to the OpenAPI spec file (YAML or JSON) */
     input: string;
     output: {
+        /** Output path for generated Axios client functions */
         client: string;
+        /** Output path for generated TypeScript types (optional) */
         types?: string;
     };
+    /** Import path to the user's Axios instance */
     axiosInstancePath: string;
+    /** Named export of the Axios instance (default: "axiosInstance") */
     axiosInstanceExport?: string;
+    /** Output language (default: "ts") */
     language?: "ts" | "js";
+    /** Add JSDoc comments to generated functions (default: true) */
     jsdoc?: boolean;
+    /** Only generate endpoints matching these tags */
     tags?: string[];
+    /** Controls how generated function names are derived from operationIds */
+    functionName?: FunctionNameConfig;
 }
 interface ParsedEndpoint {
     operationId: string;
@@ -121,7 +170,7 @@ declare function extractEndpoints(spec: OpenAPISpec, filterTags?: string[]): Par
 interface GenerateClientOptions {
     endpoints: ParsedEndpoint[];
     config: AxigenConfig;
-    /** مسیر نسبی فایل types نسبت به فایل client */
+    /** Relative path to the types file from the client file */
     typesRelativePath?: string;
 }
 declare function generateClientFile(opts: GenerateClientOptions): string;

package/dist/index.js

@@ -212,6 +212,7 @@ function generateTypesFile(endpoints, schemas = {}) {
   lines.push(`// This file is auto-generated by axigen. DO NOT EDIT.`);
   lines.push(`// Generated at: ${(/* @__PURE__ */ new Date()).toISOString()}`);
   lines.push("");
+  const declaredInComponents = new Set(Object.keys(schemas));
   if (Object.keys(schemas).length > 0) {
     lines.push("// \u2500\u2500\u2500 Component Schemas \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
     lines.push("");
@@ -223,48 +224,118 @@ function generateTypesFile(endpoints, schemas = {}) {
       lines.push("");
     }
   }
-  lines.push("// \u2500\u2500\u2500 Endpoint Types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-  lines.push("");
+  const endpointLines = [];
   for (const ep of endpoints) {
     const baseName = operationToTypeName(ep.operationId);
     if (ep.pathParams.length > 0) {
-      lines.push(`export interface ${baseName}PathParams {`);
+      endpointLines.push(`export interface ${baseName}PathParams {`);
       for (const p of ep.pathParams) {
         const type = schemaToTSType(p.schema);
         const comment = p.description ? `  /** ${p.description} */
 ` : "";
-        lines.push(`${comment}  ${p.name}: ${type}`);
+        endpointLines.push(`${comment}  ${p.name}: ${type}`);
       }
-      lines.push(`}`);
-      lines.push("");
+      endpointLines.push(`}`);
+      endpointLines.push("");
     }
     if (ep.queryParams.length > 0) {
-      lines.push(`export interface ${baseName}QueryParams {`);
+      endpointLines.push(`export interface ${baseName}QueryParams {`);
       for (const p of ep.queryParams) {
         const optional = !p.required ? "?" : "";
         const type = schemaToTSType(p.schema);
         const comment = p.description ? `  /** ${p.description} */
 ` : "";
-        lines.push(`${comment}  ${p.name}${optional}: ${type}`);
+        endpointLines.push(`${comment}  ${p.name}${optional}: ${type}`);
       }
-      lines.push(`}`);
-      lines.push("");
+      endpointLines.push(`}`);
+      endpointLines.push("");
     }
     if (ep.bodySchema) {
-      lines.push(`export type ${baseName}Body = ${schemaToTSType(ep.bodySchema)}`);
-      lines.push("");
+      const refName = getRefName(ep.bodySchema);
+      if (refName && declaredInComponents.has(refName)) {
+        if (`${baseName}Body` !== refName) {
+          endpointLines.push(`export type ${baseName}Body = ${refName}`);
+          endpointLines.push("");
+        }
+      } else {
+        endpointLines.push(`export type ${baseName}Body = ${schemaToTSType(ep.bodySchema)}`);
+        endpointLines.push("");
+      }
     }
     if (ep.responseSchema) {
-      lines.push(`export type ${baseName}Response = ${schemaToTSType(ep.responseSchema)}`);
-      lines.push("");
+      const refName = getRefName(ep.responseSchema);
+      if (refName && declaredInComponents.has(refName)) {
+        if (`${baseName}Response` !== refName) {
+          endpointLines.push(`export type ${baseName}Response = ${refName}`);
+          endpointLines.push("");
+        }
+      } else {
+        endpointLines.push(`export type ${baseName}Response = ${schemaToTSType(ep.responseSchema)}`);
+        endpointLines.push("");
+      }
     }
   }
+  if (endpointLines.length > 0) {
+    lines.push("// \u2500\u2500\u2500 Endpoint Types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    lines.push("");
+    lines.push(...endpointLines);
+  }
   return lines.join("\n");
 }
+function getRefName(schema) {
+  if (schema.$ref) return refToTypeName(schema.$ref);
+  return void 0;
+}
 function operationToTypeName(operationId) {
   return operationId.charAt(0).toUpperCase() + operationId.slice(1);
 }
 
+// src/generator/function-name.ts
+function resolveFunctionName(operationId, method, config) {
+  if (!config) return operationId;
+  let name = operationId;
+  if (config.transforms && config.transforms.length > 0) {
+    for (const transform of config.transforms) {
+      name = applyTransform(name, transform);
+    }
+  }
+  if (shouldAppendMethod(method, config.appendMethod)) {
+    const suffix = method.charAt(0).toUpperCase() + method.slice(1).toLowerCase();
+    name = name + suffix;
+  }
+  return name;
+}
+function applyTransform(input, transform) {
+  const flags = transform.flags ?? "g";
+  const regex = new RegExp(transform.match, flags);
+  const { replacement } = transform;
+  const upperMatch = replacement.match(/^upper:\$(\d+)$/);
+  if (upperMatch) {
+    const groupIndex = parseInt(upperMatch[1], 10);
+    return input.replace(regex, (...args) => {
+      const captured = args[groupIndex];
+      return captured ? captured.toUpperCase() : "";
+    });
+  }
+  const lowerMatch = replacement.match(/^lower:\$(\d+)$/);
+  if (lowerMatch) {
+    const groupIndex = parseInt(lowerMatch[1], 10);
+    return input.replace(regex, (...args) => {
+      const captured = args[groupIndex];
+      return captured ? captured.toLowerCase() : "";
+    });
+  }
+  return input.replace(regex, replacement);
+}
+function shouldAppendMethod(method, appendMethod) {
+  if (!appendMethod) return false;
+  if (appendMethod === true) return true;
+  if (Array.isArray(appendMethod)) {
+    return appendMethod.map((m) => m.toLowerCase()).includes(method.toLowerCase());
+  }
+  return false;
+}
+
 // src/generator/axios.ts
 function generateClientFile(opts) {
   const { endpoints, config, typesRelativePath } = opts;
@@ -275,7 +346,7 @@ function generateClientFile(opts) {
   lines.push(`// Generated at: ${(/* @__PURE__ */ new Date()).toISOString()}`);
   lines.push("");
   if (isTS) {
-    lines.push(`import type { AxiosResponse } from 'axios'`);
+    lines.push(`import type { AxiosRequestConfig, AxiosResponse } from 'axios'`);
   }
   lines.push(`import { ${instanceExport} } from '${config.axiosInstancePath}'`);
   if (isTS && typesRelativePath) {
@@ -287,13 +358,15 @@ function generateClientFile(opts) {
   lines.push("");
   lines.push("");
   for (const ep of endpoints) {
-    const fn = buildFunction(ep, isTS, instanceExport, config.jsdoc !== false);
+    const fn = buildFunction(ep, isTS, instanceExport, config);
     lines.push(fn);
     lines.push("");
   }
   return lines.join("\n");
 }
-function buildFunction(ep, isTS, instanceExport, jsdoc) {
+function buildFunction(ep, isTS, instanceExport, config) {
+  const jsdoc = config.jsdoc !== false;
+  const fnName = resolveFunctionName(ep.operationId, ep.method, config.functionName);
   const typeName = operationToTypeName(ep.operationId);
   const lines = [];
   if (jsdoc) {
@@ -308,9 +381,8 @@ function buildFunction(ep, isTS, instanceExport, jsdoc) {
   }
   const params = buildParams(ep, typeName, isTS);
   const returnType = isTS ? buildReturnType(ep, typeName) : "";
-  const asyncKw = "async ";
-  lines.push(`export ${asyncKw}function ${ep.operationId}(${params})${returnType} {`);
-  const callLines = buildAxiosCall(ep, instanceExport, typeName, isTS);
+  lines.push(`export async function ${fnName}(${params})${returnType} {`);
+  const callLines = buildAxiosCall(ep, instanceExport);
   for (const l of callLines) {
     lines.push(`  ${l}`);
   }
@@ -333,31 +405,36 @@ function buildParams(ep, typeName, isTS) {
     const type = isTS ? `: ${typeName}QueryParams` : "";
     parts.push(`params${optional}${type}`);
   }
+  if (isTS) {
+    parts.push(`config?: AxiosRequestConfig`);
+    parts.push(`options?: AxiosRequestConfig`);
+  } else {
+    parts.push(`config`);
+    parts.push(`options`);
+  }
   return parts.join(", ");
 }
 function buildReturnType(ep, typeName) {
   const responseType = ep.responseSchema ? `${typeName}Response` : "unknown";
   return `: Promise<AxiosResponse<${responseType}>>`;
 }
-function buildAxiosCall(ep, instanceExport, _typeName, _isTS) {
+function buildAxiosCall(ep, instanceExport) {
   const lines = [];
   const interpolatedPath = ep.pathParams.length > 0 ? "`" + ep.path.replace(/\{(\w+)\}/g, "${$1}") + "`" : `'${ep.path}'`;
   const hasBody = !!ep.bodySchema;
   const hasQuery = ep.queryParams.length > 0;
-  const method = ep.method.toLowerCase();
-  if (method === "get" || method === "delete" || method === "head") {
-    if (hasQuery) {
-      lines.push(`return ${instanceExport}.${method}(${interpolatedPath}, { params })`);
-    } else {
-      lines.push(`return ${instanceExport}.${method}(${interpolatedPath})`);
-    }
+  if (hasQuery) {
+    lines.push(`const mergedConfig: AxiosRequestConfig = { ...config, params: { ...params, ...config?.params } }`);
+  }
+  const configArg = hasQuery ? "mergedConfig" : "config";
+  if (hasBody) {
+    lines.push(
+      `return ${instanceExport}({ method: '${ep.method.toUpperCase()}', url: ${interpolatedPath}, data, ...${configArg} }, options)`
+    );
   } else {
-    const bodyArg = hasBody ? "data" : "undefined";
-    if (hasQuery) {
-      lines.push(`return ${instanceExport}.${method}(${interpolatedPath}, ${bodyArg}, { params })`);
-    } else {
-      lines.push(`return ${instanceExport}.${method}(${interpolatedPath}, ${bodyArg})`);
-    }
+    lines.push(
+      `return ${instanceExport}({ method: '${ep.method.toUpperCase()}', url: ${interpolatedPath}, ...${configArg} }, options)`
+    );
   }
   return lines;
 }
@@ -482,9 +559,52 @@ function validateConfig(raw, filePath) {
     axiosInstanceExport: typeof cfg.axiosInstanceExport === "string" ? cfg.axiosInstanceExport : "axiosInstance",
     language: cfg.language === "js" ? "js" : "ts",
     jsdoc: cfg.jsdoc !== false,
-    tags: Array.isArray(cfg.tags) ? cfg.tags : void 0
+    tags: Array.isArray(cfg.tags) ? cfg.tags : void 0,
+    functionName: validateFunctionNameConfig(cfg.functionName, filePath)
   };
 }
+function validateFunctionNameConfig(raw, filePath) {
+  if (raw === void 0 || raw === null) return void 0;
+  if (typeof raw !== "object") {
+    throw new Error(`Config error: "functionName" must be an object`);
+  }
+  const fn = raw;
+  const result = {};
+  if (fn.transforms !== void 0) {
+    if (!Array.isArray(fn.transforms)) {
+      throw new Error(`Config error: "functionName.transforms" must be an array`);
+    }
+    result.transforms = fn.transforms.map((t, i) => {
+      if (!t || typeof t !== "object") {
+        throw new Error(`Config error: "functionName.transforms[${i}]" must be an object`);
+      }
+      const transform = t;
+      if (typeof transform.match !== "string") {
+        throw new Error(`Config error: "functionName.transforms[${i}].match" must be a string regex pattern`);
+      }
+      if (typeof transform.replacement !== "string") {
+        throw new Error(`Config error: "functionName.transforms[${i}].replacement" must be a string`);
+      }
+      try {
+        new RegExp(transform.match, transform.flags ?? "g");
+      } catch {
+        throw new Error(`Config error: "functionName.transforms[${i}].match" is not a valid regex: ${transform.match}`);
+      }
+      return {
+        match: transform.match,
+        flags: typeof transform.flags === "string" ? transform.flags : "g",
+        replacement: transform.replacement
+      };
+    });
+  }
+  if (fn.appendMethod !== void 0) {
+    if (typeof fn.appendMethod !== "boolean" && !Array.isArray(fn.appendMethod)) {
+      throw new Error(`Config error: "functionName.appendMethod" must be a boolean or an array of HTTP methods`);
+    }
+    result.appendMethod = fn.appendMethod;
+  }
+  return result;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   extractEndpoints,

package/dist/index.mjs

@@ -171,6 +171,7 @@ function generateTypesFile(endpoints, schemas = {}) {
   lines.push(`// This file is auto-generated by axigen. DO NOT EDIT.`);
   lines.push(`// Generated at: ${(/* @__PURE__ */ new Date()).toISOString()}`);
   lines.push("");
+  const declaredInComponents = new Set(Object.keys(schemas));
   if (Object.keys(schemas).length > 0) {
     lines.push("// \u2500\u2500\u2500 Component Schemas \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
     lines.push("");
@@ -182,48 +183,118 @@ function generateTypesFile(endpoints, schemas = {}) {
       lines.push("");
     }
   }
-  lines.push("// \u2500\u2500\u2500 Endpoint Types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-  lines.push("");
+  const endpointLines = [];
   for (const ep of endpoints) {
     const baseName = operationToTypeName(ep.operationId);
     if (ep.pathParams.length > 0) {
-      lines.push(`export interface ${baseName}PathParams {`);
+      endpointLines.push(`export interface ${baseName}PathParams {`);
       for (const p of ep.pathParams) {
         const type = schemaToTSType(p.schema);
         const comment = p.description ? `  /** ${p.description} */
 ` : "";
-        lines.push(`${comment}  ${p.name}: ${type}`);
+        endpointLines.push(`${comment}  ${p.name}: ${type}`);
       }
-      lines.push(`}`);
-      lines.push("");
+      endpointLines.push(`}`);
+      endpointLines.push("");
     }
     if (ep.queryParams.length > 0) {
-      lines.push(`export interface ${baseName}QueryParams {`);
+      endpointLines.push(`export interface ${baseName}QueryParams {`);
       for (const p of ep.queryParams) {
         const optional = !p.required ? "?" : "";
         const type = schemaToTSType(p.schema);
         const comment = p.description ? `  /** ${p.description} */
 ` : "";
-        lines.push(`${comment}  ${p.name}${optional}: ${type}`);
+        endpointLines.push(`${comment}  ${p.name}${optional}: ${type}`);
       }
-      lines.push(`}`);
-      lines.push("");
+      endpointLines.push(`}`);
+      endpointLines.push("");
     }
     if (ep.bodySchema) {
-      lines.push(`export type ${baseName}Body = ${schemaToTSType(ep.bodySchema)}`);
-      lines.push("");
+      const refName = getRefName(ep.bodySchema);
+      if (refName && declaredInComponents.has(refName)) {
+        if (`${baseName}Body` !== refName) {
+          endpointLines.push(`export type ${baseName}Body = ${refName}`);
+          endpointLines.push("");
+        }
+      } else {
+        endpointLines.push(`export type ${baseName}Body = ${schemaToTSType(ep.bodySchema)}`);
+        endpointLines.push("");
+      }
     }
     if (ep.responseSchema) {
-      lines.push(`export type ${baseName}Response = ${schemaToTSType(ep.responseSchema)}`);
-      lines.push("");
+      const refName = getRefName(ep.responseSchema);
+      if (refName && declaredInComponents.has(refName)) {
+        if (`${baseName}Response` !== refName) {
+          endpointLines.push(`export type ${baseName}Response = ${refName}`);
+          endpointLines.push("");
+        }
+      } else {
+        endpointLines.push(`export type ${baseName}Response = ${schemaToTSType(ep.responseSchema)}`);
+        endpointLines.push("");
+      }
     }
   }
+  if (endpointLines.length > 0) {
+    lines.push("// \u2500\u2500\u2500 Endpoint Types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    lines.push("");
+    lines.push(...endpointLines);
+  }
   return lines.join("\n");
 }
+function getRefName(schema) {
+  if (schema.$ref) return refToTypeName(schema.$ref);
+  return void 0;
+}
 function operationToTypeName(operationId) {
   return operationId.charAt(0).toUpperCase() + operationId.slice(1);
 }
 
+// src/generator/function-name.ts
+function resolveFunctionName(operationId, method, config) {
+  if (!config) return operationId;
+  let name = operationId;
+  if (config.transforms && config.transforms.length > 0) {
+    for (const transform of config.transforms) {
+      name = applyTransform(name, transform);
+    }
+  }
+  if (shouldAppendMethod(method, config.appendMethod)) {
+    const suffix = method.charAt(0).toUpperCase() + method.slice(1).toLowerCase();
+    name = name + suffix;
+  }
+  return name;
+}
+function applyTransform(input, transform) {
+  const flags = transform.flags ?? "g";
+  const regex = new RegExp(transform.match, flags);
+  const { replacement } = transform;
+  const upperMatch = replacement.match(/^upper:\$(\d+)$/);
+  if (upperMatch) {
+    const groupIndex = parseInt(upperMatch[1], 10);
+    return input.replace(regex, (...args) => {
+      const captured = args[groupIndex];
+      return captured ? captured.toUpperCase() : "";
+    });
+  }
+  const lowerMatch = replacement.match(/^lower:\$(\d+)$/);
+  if (lowerMatch) {
+    const groupIndex = parseInt(lowerMatch[1], 10);
+    return input.replace(regex, (...args) => {
+      const captured = args[groupIndex];
+      return captured ? captured.toLowerCase() : "";
+    });
+  }
+  return input.replace(regex, replacement);
+}
+function shouldAppendMethod(method, appendMethod) {
+  if (!appendMethod) return false;
+  if (appendMethod === true) return true;
+  if (Array.isArray(appendMethod)) {
+    return appendMethod.map((m) => m.toLowerCase()).includes(method.toLowerCase());
+  }
+  return false;
+}
+
 // src/generator/axios.ts
 function generateClientFile(opts) {
   const { endpoints, config, typesRelativePath } = opts;
@@ -234,7 +305,7 @@ function generateClientFile(opts) {
   lines.push(`// Generated at: ${(/* @__PURE__ */ new Date()).toISOString()}`);
   lines.push("");
   if (isTS) {
-    lines.push(`import type { AxiosResponse } from 'axios'`);
+    lines.push(`import type { AxiosRequestConfig, AxiosResponse } from 'axios'`);
   }
   lines.push(`import { ${instanceExport} } from '${config.axiosInstancePath}'`);
   if (isTS && typesRelativePath) {
@@ -246,13 +317,15 @@ function generateClientFile(opts) {
   lines.push("");
   lines.push("");
   for (const ep of endpoints) {
-    const fn = buildFunction(ep, isTS, instanceExport, config.jsdoc !== false);
+    const fn = buildFunction(ep, isTS, instanceExport, config);
     lines.push(fn);
     lines.push("");
   }
   return lines.join("\n");
 }
-function buildFunction(ep, isTS, instanceExport, jsdoc) {
+function buildFunction(ep, isTS, instanceExport, config) {
+  const jsdoc = config.jsdoc !== false;
+  const fnName = resolveFunctionName(ep.operationId, ep.method, config.functionName);
   const typeName = operationToTypeName(ep.operationId);
   const lines = [];
   if (jsdoc) {
@@ -267,9 +340,8 @@ function buildFunction(ep, isTS, instanceExport, jsdoc) {
   }
   const params = buildParams(ep, typeName, isTS);
   const returnType = isTS ? buildReturnType(ep, typeName) : "";
-  const asyncKw = "async ";
-  lines.push(`export ${asyncKw}function ${ep.operationId}(${params})${returnType} {`);
-  const callLines = buildAxiosCall(ep, instanceExport, typeName, isTS);
+  lines.push(`export async function ${fnName}(${params})${returnType} {`);
+  const callLines = buildAxiosCall(ep, instanceExport);
   for (const l of callLines) {
     lines.push(`  ${l}`);
   }
@@ -292,31 +364,36 @@ function buildParams(ep, typeName, isTS) {
     const type = isTS ? `: ${typeName}QueryParams` : "";
     parts.push(`params${optional}${type}`);
   }
+  if (isTS) {
+    parts.push(`config?: AxiosRequestConfig`);
+    parts.push(`options?: AxiosRequestConfig`);
+  } else {
+    parts.push(`config`);
+    parts.push(`options`);
+  }
   return parts.join(", ");
 }
 function buildReturnType(ep, typeName) {
   const responseType = ep.responseSchema ? `${typeName}Response` : "unknown";
   return `: Promise<AxiosResponse<${responseType}>>`;
 }
-function buildAxiosCall(ep, instanceExport, _typeName, _isTS) {
+function buildAxiosCall(ep, instanceExport) {
   const lines = [];
   const interpolatedPath = ep.pathParams.length > 0 ? "`" + ep.path.replace(/\{(\w+)\}/g, "${$1}") + "`" : `'${ep.path}'`;
   const hasBody = !!ep.bodySchema;
   const hasQuery = ep.queryParams.length > 0;
-  const method = ep.method.toLowerCase();
-  if (method === "get" || method === "delete" || method === "head") {
-    if (hasQuery) {
-      lines.push(`return ${instanceExport}.${method}(${interpolatedPath}, { params })`);
-    } else {
-      lines.push(`return ${instanceExport}.${method}(${interpolatedPath})`);
-    }
+  if (hasQuery) {
+    lines.push(`const mergedConfig: AxiosRequestConfig = { ...config, params: { ...params, ...config?.params } }`);
+  }
+  const configArg = hasQuery ? "mergedConfig" : "config";
+  if (hasBody) {
+    lines.push(
+      `return ${instanceExport}({ method: '${ep.method.toUpperCase()}', url: ${interpolatedPath}, data, ...${configArg} }, options)`
+    );
   } else {
-    const bodyArg = hasBody ? "data" : "undefined";
-    if (hasQuery) {
-      lines.push(`return ${instanceExport}.${method}(${interpolatedPath}, ${bodyArg}, { params })`);
-    } else {
-      lines.push(`return ${instanceExport}.${method}(${interpolatedPath}, ${bodyArg})`);
-    }
+    lines.push(
+      `return ${instanceExport}({ method: '${ep.method.toUpperCase()}', url: ${interpolatedPath}, ...${configArg} }, options)`
+    );
   }
   return lines;
 }
@@ -441,9 +518,52 @@ function validateConfig(raw, filePath) {
     axiosInstanceExport: typeof cfg.axiosInstanceExport === "string" ? cfg.axiosInstanceExport : "axiosInstance",
     language: cfg.language === "js" ? "js" : "ts",
     jsdoc: cfg.jsdoc !== false,
-    tags: Array.isArray(cfg.tags) ? cfg.tags : void 0
+    tags: Array.isArray(cfg.tags) ? cfg.tags : void 0,
+    functionName: validateFunctionNameConfig(cfg.functionName, filePath)
   };
 }
+function validateFunctionNameConfig(raw, filePath) {
+  if (raw === void 0 || raw === null) return void 0;
+  if (typeof raw !== "object") {
+    throw new Error(`Config error: "functionName" must be an object`);
+  }
+  const fn = raw;
+  const result = {};
+  if (fn.transforms !== void 0) {
+    if (!Array.isArray(fn.transforms)) {
+      throw new Error(`Config error: "functionName.transforms" must be an array`);
+    }
+    result.transforms = fn.transforms.map((t, i) => {
+      if (!t || typeof t !== "object") {
+        throw new Error(`Config error: "functionName.transforms[${i}]" must be an object`);
+      }
+      const transform = t;
+      if (typeof transform.match !== "string") {
+        throw new Error(`Config error: "functionName.transforms[${i}].match" must be a string regex pattern`);
+      }
+      if (typeof transform.replacement !== "string") {
+        throw new Error(`Config error: "functionName.transforms[${i}].replacement" must be a string`);
+      }
+      try {
+        new RegExp(transform.match, transform.flags ?? "g");
+      } catch {
+        throw new Error(`Config error: "functionName.transforms[${i}].match" is not a valid regex: ${transform.match}`);
+      }
+      return {
+        match: transform.match,
+        flags: typeof transform.flags === "string" ? transform.flags : "g",
+        replacement: transform.replacement
+      };
+    });
+  }
+  if (fn.appendMethod !== void 0) {
+    if (typeof fn.appendMethod !== "boolean" && !Array.isArray(fn.appendMethod)) {
+      throw new Error(`Config error: "functionName.appendMethod" must be a boolean or an array of HTTP methods`);
+    }
+    result.appendMethod = fn.appendMethod;
+  }
+  return result;
+}
 export {
   extractEndpoints,
   generate,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "axigen",
-  "version": "0.1.1",
+  "version": "1.1.0",
   "description": "Generate typed Axios client functions from OpenAPI / Swagger specs",
   "keywords": [
     "openapi",
@@ -37,7 +37,11 @@
     "dev": "tsx src/cli/index.ts",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src --ext .ts",
-    "prepublishOnly": "npm run build && npm run typecheck"
+    "prepublishOnly": "npm run build && npm run typecheck",
+    "release": "standard-version",
+    "release:minor": "standard-version --release-as minor",
+    "release:major": "standard-version --release-as major",
+    "release:patch": "standard-version --release-as patch"
   },
   "dependencies": {
     "chalk": "^5.3.0",
@@ -48,6 +52,7 @@
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.19.43",
+    "standard-version": "^9.5.0",
     "tsup": "^8.0.2",
     "tsx": "^4.7.0",
     "typescript": "^5.3.3"