@bagelink/sdk 1.2.20 → 1.2.25

package/dist/index.cjs

@@ -101,14 +101,15 @@ const primitiveTypes = [
   "void",
   "any",
   "{ [key: string]: any }",
-  "undefined",
-  "{ [key: string]: any }"
+  "undefined"
 ];
+const functionsInventory = {};
+const pathOperations = [];
 function collectTypeForImportStatement(typeName) {
   typeName = typeName.trim().replace("[]", "");
   if (typeName.includes("|")) {
     typeName.split("|").forEach((singleType) => {
-      collectTypeForImportStatement(singleType);
+      collectTypeForImportStatement(singleType.trim());
     });
     return;
   }
@@ -124,9 +125,8 @@ function schemaToTypeWithCollection(schema) {
 }
 function getResponseType(response) {
   const mediaTypeObject = response.content?.["application/json"];
-  if (!mediaTypeObject || !mediaTypeObject.schema) return;
-  const responseType = schemaToTypeWithCollection(mediaTypeObject.schema);
-  return responseType;
+  if (!mediaTypeObject?.schema) return void 0;
+  return schemaToTypeWithCollection(mediaTypeObject.schema);
 }
 function generateResponseType(responses) {
   if (!responses) return "";
@@ -141,42 +141,14 @@ function generateResponseType(responses) {
   }
   return types.join(" | ");
 }
-function generateAxiosFunction(method, formattedPath, allParams, responseTypeStr, parameters, requestBodyPayload) {
-  if (allParams === "undefined") allParams = "";
-  let axiosFunction = `async (${allParams})${responseTypeStr} => {`;
-  if (requestBodyPayload === "formData") {
-    const paramStr = parameters?.config?.params ? `params: {${parameters.config.params}}` : "";
-    if (allParams.includes("file: File")) {
-      axiosFunction += `
-        const formData = new FormData()
-        formData.append('upload', file)
-        return axios.${method}(${formattedPath}, formData, {
-            headers: { 'Content-Type': 'multipart/form-data' },
-            onUploadProgress: options?.onUploadProgress${paramStr ? `, ${paramStr}` : ""}
-        })`;
-    } else {
-      axiosFunction += `
-        return axios.${method}(${formattedPath}, formData, {
-            headers: { 'Content-Type': 'multipart/form-data' }${paramStr ? `, ${paramStr}` : ""}
-        })`;
-    }
-  } else {
-    const paramStr = parameters?.config?.params ? `, { params: {${parameters.config.params}} }` : "";
-    const bodyVar = requestBodyPayload ? `${requestBodyPayload}` : "{}";
-    axiosFunction += `return axios.${method}(${formattedPath}${["get", "delete"].includes(method) ? paramStr : `, ${bodyVar}${paramStr}`})`;
-  }
-  axiosFunction += "}";
-  return axiosFunction;
-}
-const pathParamRegex = /\{([^}]+)\}/g;
 function getParamsFromPath(path) {
-  const params = path.match(pathParamRegex)?.map((p) => p.slice(1, -1));
-  return params;
+  const pathParamRegex = /\{[^}]+\}/g;
+  return path.match(pathParamRegex)?.map((p) => p.slice(1, -1));
 }
 function formatPathWithParams(path) {
   const params = getParamsFromPath(path);
-  const formattedPath = params ? `\`${path.replace(pathParamRegex, (v) => `$${toCamelCase(v)}`)}\`` : `'${path}'`;
-  return formattedPath;
+  if (!params) return `'${path}'`;
+  return `\`${path.replace(/\{([^}]+)\}/g, (_, paramName) => `\${${toCamelCase(paramName)}}`)}\``;
 }
 function generateRequestBody(requestBody) {
   if (!requestBody?.content)
@@ -210,14 +182,6 @@ function generateRequestBody(requestBody) {
   });
   return { requestBodyParam, requestBodyPayload };
 }
-function combineAllParams(parameters, requestBodyParam) {
-  let allParamsArray = [];
-  if (parameters && parameters.params)
-    allParamsArray = parameters.params.split(",").map((p) => p.trim());
-  if (requestBodyParam) allParamsArray.push(requestBodyParam.trim());
-  allParamsArray = allParamsArray.filter((p) => p).sort((a, b) => (a.includes("?") ? 1 : -1) - (b.includes("?") ? 1 : -1));
-  return allParamsArray.join(", ");
-}
 function generateFunctionParameters(params, isFileUpload = false) {
   if (!params?.length) return {};
   if (isFileUpload) {
@@ -230,7 +194,7 @@ function generateFunctionParameters(params, isFileUpload = false) {
     };
   }
   const functionParams = [];
-  const paramList = [];
+  const queryParams = [];
   for (const param of params) {
     const paramType = schemaToType(param.schema);
     collectTypeForImportStatement(paramType);
@@ -247,16 +211,53 @@ function generateFunctionParameters(params, isFileUpload = false) {
       );
     }
     if (param.in === "query" || param.in === "header") {
-      paramList.push(
+      queryParams.push(
         paramName === varName ? paramName : `'${paramName}': ${varName}`
       );
     }
   }
   return {
     params: functionParams.join(", "),
-    config: paramList.length ? { params: paramList.join(", ") } : {}
+    config: queryParams.length ? { params: queryParams.join(", ") } : void 0
   };
 }
+function combineAllParams(parameters, requestBodyParam) {
+  let allParamsArray = [];
+  if (parameters.params) {
+    allParamsArray = parameters.params.split(",").map((p) => p.trim());
+  }
+  if (requestBodyParam) {
+    allParamsArray.push(requestBodyParam.trim());
+  }
+  return allParamsArray.filter(Boolean).sort((a, b) => (a.includes("?") ? 1 : -1) - (b.includes("?") ? 1 : -1)).join(", ");
+}
+function generateAxiosFunction(method, formattedPath, allParams, responseTypeStr, parameters, requestBodyPayload) {
+  if (allParams === "undefined") allParams = "";
+  let axiosFunction = `async (${allParams})${responseTypeStr} => {`;
+  const paramStr = parameters.config?.params ? `params: {${parameters.config.params}}` : "";
+  if (requestBodyPayload === "formData") {
+    if (allParams.includes("file: File")) {
+      axiosFunction += `
+        const formData = new FormData()
+        formData.append('upload', file)
+        return axios.${method}(${formattedPath}, formData, {
+            headers: { 'Content-Type': 'multipart/form-data' },
+            onUploadProgress: options?.onUploadProgress${paramStr ? `, ${paramStr}` : ""}
+        })`;
+    } else {
+      axiosFunction += `
+        return axios.${method}(${formattedPath}, formData, {
+            headers: { 'Content-Type': 'multipart/form-data' }${paramStr ? `, ${paramStr}` : ""}
+        })`;
+    }
+  } else {
+    const configParams = paramStr ? `, { ${paramStr} }` : "";
+    const bodyVar = requestBodyPayload || "{}";
+    axiosFunction += `return axios.${method}(${formattedPath}${["get", "delete"].includes(method) ? configParams : `, ${bodyVar}${configParams}`})`;
+  }
+  axiosFunction += "}";
+  return axiosFunction;
+}
 function generateFunctionForOperation(method, path, operation) {
   if (!operation) return "";
   const isFileUpload = operation.requestBody?.content["multipart/form-data"]?.schema?.$ref?.includes("Body_upload_files");
@@ -270,7 +271,61 @@ function generateFunctionForOperation(method, path, operation) {
   const allParams = isFileUpload ? "file: File, options?: UploadOptions & { dirPath?: string, tags?: string[] }" : combineAllParams(parameters, requestBodyParam);
   const responseType = generateResponseType(operation.responses);
   const responseTypeStr = responseType ? `: Promise<AxiosResponse<${responseType}>>` : "";
-  return generateAxiosFunction(
+  let functionComment = "/**\n";
+  if (operation.summary) {
+    functionComment += ` * ${operation.summary}
+`;
+  }
+  if (operation.description) {
+    if (operation.summary) functionComment += ` *
+`;
+    const descriptionLines = operation.description.split("\n");
+    descriptionLines.forEach((line) => {
+      functionComment += ` * ${line}
+`;
+    });
+  }
+  functionComment += ` *
+ * @endpoint ${method.toUpperCase()} ${path}
+`;
+  if (operation.parameters?.length) {
+    functionComment += " *\n";
+    operation.parameters.forEach((param) => {
+      const paramType = schemaToType(param.schema);
+      const paramName = toCamelCase(param.name);
+      const required = param.required ? "" : "?";
+      functionComment += ` * @param {${paramType}} ${paramName}${required}`;
+      if (param.description) {
+        functionComment += ` - ${param.description}`;
+      } else {
+        functionComment += ` - ${param.name} parameter`;
+      }
+      functionComment += "\n";
+    });
+  }
+  if (operation.requestBody && requestBodyParam) {
+    const bodyParamName = requestBodyParam.split(":")[0].trim();
+    const bodyParamType = requestBodyParam.split(":")[1]?.split("=")[0]?.trim() || "any";
+    functionComment += ` * @param {${bodyParamType}} ${bodyParamName}`;
+    if (operation.requestBody.description) {
+      functionComment += ` - ${operation.requestBody.description}`;
+    } else {
+      functionComment += ` - Request body`;
+    }
+    functionComment += "\n";
+  }
+  if (responseType) {
+    functionComment += ` * @returns {Promise<AxiosResponse<${responseType}>>} The API response
+`;
+    for (const [statusCode, response] of Object.entries(operation.responses)) {
+      if (statusCode.startsWith("2") && response.description) {
+        functionComment += ` * @response ${statusCode} - ${response.description}
+`;
+      }
+    }
+  }
+  functionComment += " */\n";
+  return functionComment + generateAxiosFunction(
     method,
     formatPathWithParams(path),
     allParams,
@@ -279,25 +334,6 @@ function generateFunctionForOperation(method, path, operation) {
     requestBodyPayload
   );
 }
-const generateRandomString = () => Math.random().toString(36).slice(7);
-const DOUBLE_QUOTE_REGEX = /"([^"]+)":/g;
-function fileTemplate(tsString, typeForImport, baseURL) {
-  const templateCode = `import ax from 'axios';
-		 import type { AxiosResponse } from 'axios';
-		 import type {${typeForImport.join(", ")}} from './types.d';
-
-	export interface UploadOptions {
-		onUploadProgress?: (progressEvent: any) => void
-		dirPath?: string
-		tags?: string[]
-	}
-
-	export const axios = ax.create({baseURL:${baseURL}, withCredentials: true});
-	${tsString}`;
-  return templateCode.replace(DOUBLE_QUOTE_REGEX, "$1:");
-}
-const functionsInventory = {};
-const pathOperations = [];
 function hasConflict(path, method) {
   const cleanPathName = path.split("/").filter((p) => p && !/\{|\}/.test(p)).join("/");
   const matchingPaths = pathOperations.filter(
@@ -306,13 +342,20 @@ function hasConflict(path, method) {
   pathOperations.push({ path: cleanPathName, method });
   return matchingPaths.length > 0;
 }
+function generateRandomString() {
+  return Math.random().toString(36).slice(7);
+}
 function createFunctionPlaceholder(path, method, operation) {
   const funcID = generateRandomString();
-  functionsInventory[funcID] = generateFunctionForOperation(
-    method,
-    path,
-    operation
-  );
+  if (operation) {
+    functionsInventory[funcID] = generateFunctionForOperation(
+      method,
+      path,
+      operation
+    );
+  } else {
+    functionsInventory[funcID] = "";
+  }
   return funcID;
 }
 function handlePathSegment(path, operation, existingObj = {}) {
@@ -333,7 +376,6 @@ function handlePathSegment(path, operation, existingObj = {}) {
   return { ...obj, ...existingObj };
 }
 function generateFunctions(paths, baseUrl) {
-  let tsString = "";
   const body = {};
   const allPathsClean = Object.keys(paths).map(cleanPath);
   for (const [path, operation] of Object.entries(paths)) {
@@ -344,8 +386,8 @@ function generateFunctions(paths, baseUrl) {
       const methods = Object.keys(operation);
       if (index === array.length - 1 && methods.length === 1 && allPathsClean.filter((p) => p === cleanPath(path)).length === 1) {
         const method = methods[0];
-        const opp = { ...operation }[method];
-        acc[objFuncKey] = createFunctionPlaceholder(path, methods[0], opp);
+        const opp = operation[method];
+        acc[objFuncKey] = createFunctionPlaceholder(path, method, opp);
       } else if (index === array.length - 1) {
         acc[objFuncKey] = handlePathSegment(path, operation, acc[objFuncKey]);
       } else if (!acc[objFuncKey] || typeof acc[objFuncKey] !== "object") {
@@ -354,15 +396,46 @@ function generateFunctions(paths, baseUrl) {
       return acc[objFuncKey];
     }, body);
   }
+  let tsString = "";
   for (const [parent, object] of Object.entries(body)) {
-    tsString += `export const ${parent} = ${JSON.stringify(object, void 0, 2)};
+    tsString += `
+/**
+ * API functions for ${parent} endpoints
+ */
+export const ${parent} = ${JSON.stringify(object, void 0, 2)};
 `;
   }
   Object.entries(functionsInventory).forEach(([key, value]) => {
     tsString = tsString.replace(`"${key}"`, value);
   });
-  tsString = fileTemplate(tsString, allTypes, baseUrl);
-  return tsString;
+  return fileTemplate(tsString, allTypes, baseUrl);
+}
+function fileTemplate(tsString, typeForImport, baseURL) {
+  const templateCode = `import ax from 'axios';
+import type { AxiosResponse } from 'axios';
+import type { ${typeForImport.join(", ")} } from './types.d';
+
+/**
+ * Options for file upload operations
+ */
+export interface UploadOptions {
+	/** Progress callback for upload operations */
+	onUploadProgress?: (progressEvent: any) => void
+	/** Directory path for the uploaded file */
+	dirPath?: string
+	/** Tags to associate with the uploaded file */
+	tags?: string[]
+}
+
+/**
+ * Configured axios instance for API requests
+ * @example
+ * // Making a direct request with the axios instance
+ * const response = await axios.get('/some-endpoint');
+ */
+export const axios = ax.create({baseURL: ${baseURL}, withCredentials: true});
+${tsString}`;
+  return templateCode.replace(/"([^"]+)":/g, "$1:");
 }
 
 function generateTypes(schemas) {

package/dist/index.mjs

@@ -95,14 +95,15 @@ const primitiveTypes = [
   "void",
   "any",
   "{ [key: string]: any }",
-  "undefined",
-  "{ [key: string]: any }"
+  "undefined"
 ];
+const functionsInventory = {};
+const pathOperations = [];
 function collectTypeForImportStatement(typeName) {
   typeName = typeName.trim().replace("[]", "");
   if (typeName.includes("|")) {
     typeName.split("|").forEach((singleType) => {
-      collectTypeForImportStatement(singleType);
+      collectTypeForImportStatement(singleType.trim());
     });
     return;
   }
@@ -118,9 +119,8 @@ function schemaToTypeWithCollection(schema) {
 }
 function getResponseType(response) {
   const mediaTypeObject = response.content?.["application/json"];
-  if (!mediaTypeObject || !mediaTypeObject.schema) return;
-  const responseType = schemaToTypeWithCollection(mediaTypeObject.schema);
-  return responseType;
+  if (!mediaTypeObject?.schema) return void 0;
+  return schemaToTypeWithCollection(mediaTypeObject.schema);
 }
 function generateResponseType(responses) {
   if (!responses) return "";
@@ -135,42 +135,14 @@ function generateResponseType(responses) {
   }
   return types.join(" | ");
 }
-function generateAxiosFunction(method, formattedPath, allParams, responseTypeStr, parameters, requestBodyPayload) {
-  if (allParams === "undefined") allParams = "";
-  let axiosFunction = `async (${allParams})${responseTypeStr} => {`;
-  if (requestBodyPayload === "formData") {
-    const paramStr = parameters?.config?.params ? `params: {${parameters.config.params}}` : "";
-    if (allParams.includes("file: File")) {
-      axiosFunction += `
-        const formData = new FormData()
-        formData.append('upload', file)
-        return axios.${method}(${formattedPath}, formData, {
-            headers: { 'Content-Type': 'multipart/form-data' },
-            onUploadProgress: options?.onUploadProgress${paramStr ? `, ${paramStr}` : ""}
-        })`;
-    } else {
-      axiosFunction += `
-        return axios.${method}(${formattedPath}, formData, {
-            headers: { 'Content-Type': 'multipart/form-data' }${paramStr ? `, ${paramStr}` : ""}
-        })`;
-    }
-  } else {
-    const paramStr = parameters?.config?.params ? `, { params: {${parameters.config.params}} }` : "";
-    const bodyVar = requestBodyPayload ? `${requestBodyPayload}` : "{}";
-    axiosFunction += `return axios.${method}(${formattedPath}${["get", "delete"].includes(method) ? paramStr : `, ${bodyVar}${paramStr}`})`;
-  }
-  axiosFunction += "}";
-  return axiosFunction;
-}
-const pathParamRegex = /\{([^}]+)\}/g;
 function getParamsFromPath(path) {
-  const params = path.match(pathParamRegex)?.map((p) => p.slice(1, -1));
-  return params;
+  const pathParamRegex = /\{[^}]+\}/g;
+  return path.match(pathParamRegex)?.map((p) => p.slice(1, -1));
 }
 function formatPathWithParams(path) {
   const params = getParamsFromPath(path);
-  const formattedPath = params ? `\`${path.replace(pathParamRegex, (v) => `$${toCamelCase(v)}`)}\`` : `'${path}'`;
-  return formattedPath;
+  if (!params) return `'${path}'`;
+  return `\`${path.replace(/\{([^}]+)\}/g, (_, paramName) => `\${${toCamelCase(paramName)}}`)}\``;
 }
 function generateRequestBody(requestBody) {
   if (!requestBody?.content)
@@ -204,14 +176,6 @@ function generateRequestBody(requestBody) {
   });
   return { requestBodyParam, requestBodyPayload };
 }
-function combineAllParams(parameters, requestBodyParam) {
-  let allParamsArray = [];
-  if (parameters && parameters.params)
-    allParamsArray = parameters.params.split(",").map((p) => p.trim());
-  if (requestBodyParam) allParamsArray.push(requestBodyParam.trim());
-  allParamsArray = allParamsArray.filter((p) => p).sort((a, b) => (a.includes("?") ? 1 : -1) - (b.includes("?") ? 1 : -1));
-  return allParamsArray.join(", ");
-}
 function generateFunctionParameters(params, isFileUpload = false) {
   if (!params?.length) return {};
   if (isFileUpload) {
@@ -224,7 +188,7 @@ function generateFunctionParameters(params, isFileUpload = false) {
     };
   }
   const functionParams = [];
-  const paramList = [];
+  const queryParams = [];
   for (const param of params) {
     const paramType = schemaToType(param.schema);
     collectTypeForImportStatement(paramType);
@@ -241,16 +205,53 @@ function generateFunctionParameters(params, isFileUpload = false) {
       );
     }
     if (param.in === "query" || param.in === "header") {
-      paramList.push(
+      queryParams.push(
         paramName === varName ? paramName : `'${paramName}': ${varName}`
       );
     }
   }
   return {
     params: functionParams.join(", "),
-    config: paramList.length ? { params: paramList.join(", ") } : {}
+    config: queryParams.length ? { params: queryParams.join(", ") } : void 0
   };
 }
+function combineAllParams(parameters, requestBodyParam) {
+  let allParamsArray = [];
+  if (parameters.params) {
+    allParamsArray = parameters.params.split(",").map((p) => p.trim());
+  }
+  if (requestBodyParam) {
+    allParamsArray.push(requestBodyParam.trim());
+  }
+  return allParamsArray.filter(Boolean).sort((a, b) => (a.includes("?") ? 1 : -1) - (b.includes("?") ? 1 : -1)).join(", ");
+}
+function generateAxiosFunction(method, formattedPath, allParams, responseTypeStr, parameters, requestBodyPayload) {
+  if (allParams === "undefined") allParams = "";
+  let axiosFunction = `async (${allParams})${responseTypeStr} => {`;
+  const paramStr = parameters.config?.params ? `params: {${parameters.config.params}}` : "";
+  if (requestBodyPayload === "formData") {
+    if (allParams.includes("file: File")) {
+      axiosFunction += `
+        const formData = new FormData()
+        formData.append('upload', file)
+        return axios.${method}(${formattedPath}, formData, {
+            headers: { 'Content-Type': 'multipart/form-data' },
+            onUploadProgress: options?.onUploadProgress${paramStr ? `, ${paramStr}` : ""}
+        })`;
+    } else {
+      axiosFunction += `
+        return axios.${method}(${formattedPath}, formData, {
+            headers: { 'Content-Type': 'multipart/form-data' }${paramStr ? `, ${paramStr}` : ""}
+        })`;
+    }
+  } else {
+    const configParams = paramStr ? `, { ${paramStr} }` : "";
+    const bodyVar = requestBodyPayload || "{}";
+    axiosFunction += `return axios.${method}(${formattedPath}${["get", "delete"].includes(method) ? configParams : `, ${bodyVar}${configParams}`})`;
+  }
+  axiosFunction += "}";
+  return axiosFunction;
+}
 function generateFunctionForOperation(method, path, operation) {
   if (!operation) return "";
   const isFileUpload = operation.requestBody?.content["multipart/form-data"]?.schema?.$ref?.includes("Body_upload_files");
@@ -264,7 +265,61 @@ function generateFunctionForOperation(method, path, operation) {
   const allParams = isFileUpload ? "file: File, options?: UploadOptions & { dirPath?: string, tags?: string[] }" : combineAllParams(parameters, requestBodyParam);
   const responseType = generateResponseType(operation.responses);
   const responseTypeStr = responseType ? `: Promise<AxiosResponse<${responseType}>>` : "";
-  return generateAxiosFunction(
+  let functionComment = "/**\n";
+  if (operation.summary) {
+    functionComment += ` * ${operation.summary}
+`;
+  }
+  if (operation.description) {
+    if (operation.summary) functionComment += ` *
+`;
+    const descriptionLines = operation.description.split("\n");
+    descriptionLines.forEach((line) => {
+      functionComment += ` * ${line}
+`;
+    });
+  }
+  functionComment += ` *
+ * @endpoint ${method.toUpperCase()} ${path}
+`;
+  if (operation.parameters?.length) {
+    functionComment += " *\n";
+    operation.parameters.forEach((param) => {
+      const paramType = schemaToType(param.schema);
+      const paramName = toCamelCase(param.name);
+      const required = param.required ? "" : "?";
+      functionComment += ` * @param {${paramType}} ${paramName}${required}`;
+      if (param.description) {
+        functionComment += ` - ${param.description}`;
+      } else {
+        functionComment += ` - ${param.name} parameter`;
+      }
+      functionComment += "\n";
+    });
+  }
+  if (operation.requestBody && requestBodyParam) {
+    const bodyParamName = requestBodyParam.split(":")[0].trim();
+    const bodyParamType = requestBodyParam.split(":")[1]?.split("=")[0]?.trim() || "any";
+    functionComment += ` * @param {${bodyParamType}} ${bodyParamName}`;
+    if (operation.requestBody.description) {
+      functionComment += ` - ${operation.requestBody.description}`;
+    } else {
+      functionComment += ` - Request body`;
+    }
+    functionComment += "\n";
+  }
+  if (responseType) {
+    functionComment += ` * @returns {Promise<AxiosResponse<${responseType}>>} The API response
+`;
+    for (const [statusCode, response] of Object.entries(operation.responses)) {
+      if (statusCode.startsWith("2") && response.description) {
+        functionComment += ` * @response ${statusCode} - ${response.description}
+`;
+      }
+    }
+  }
+  functionComment += " */\n";
+  return functionComment + generateAxiosFunction(
     method,
     formatPathWithParams(path),
     allParams,
@@ -273,25 +328,6 @@ function generateFunctionForOperation(method, path, operation) {
     requestBodyPayload
   );
 }
-const generateRandomString = () => Math.random().toString(36).slice(7);
-const DOUBLE_QUOTE_REGEX = /"([^"]+)":/g;
-function fileTemplate(tsString, typeForImport, baseURL) {
-  const templateCode = `import ax from 'axios';
-		 import type { AxiosResponse } from 'axios';
-		 import type {${typeForImport.join(", ")}} from './types.d';
-
-	export interface UploadOptions {
-		onUploadProgress?: (progressEvent: any) => void
-		dirPath?: string
-		tags?: string[]
-	}
-
-	export const axios = ax.create({baseURL:${baseURL}, withCredentials: true});
-	${tsString}`;
-  return templateCode.replace(DOUBLE_QUOTE_REGEX, "$1:");
-}
-const functionsInventory = {};
-const pathOperations = [];
 function hasConflict(path, method) {
   const cleanPathName = path.split("/").filter((p) => p && !/\{|\}/.test(p)).join("/");
   const matchingPaths = pathOperations.filter(
@@ -300,13 +336,20 @@ function hasConflict(path, method) {
   pathOperations.push({ path: cleanPathName, method });
   return matchingPaths.length > 0;
 }
+function generateRandomString() {
+  return Math.random().toString(36).slice(7);
+}
 function createFunctionPlaceholder(path, method, operation) {
   const funcID = generateRandomString();
-  functionsInventory[funcID] = generateFunctionForOperation(
-    method,
-    path,
-    operation
-  );
+  if (operation) {
+    functionsInventory[funcID] = generateFunctionForOperation(
+      method,
+      path,
+      operation
+    );
+  } else {
+    functionsInventory[funcID] = "";
+  }
   return funcID;
 }
 function handlePathSegment(path, operation, existingObj = {}) {
@@ -327,7 +370,6 @@ function handlePathSegment(path, operation, existingObj = {}) {
   return { ...obj, ...existingObj };
 }
 function generateFunctions(paths, baseUrl) {
-  let tsString = "";
   const body = {};
   const allPathsClean = Object.keys(paths).map(cleanPath);
   for (const [path, operation] of Object.entries(paths)) {
@@ -338,8 +380,8 @@ function generateFunctions(paths, baseUrl) {
       const methods = Object.keys(operation);
       if (index === array.length - 1 && methods.length === 1 && allPathsClean.filter((p) => p === cleanPath(path)).length === 1) {
         const method = methods[0];
-        const opp = { ...operation }[method];
-        acc[objFuncKey] = createFunctionPlaceholder(path, methods[0], opp);
+        const opp = operation[method];
+        acc[objFuncKey] = createFunctionPlaceholder(path, method, opp);
       } else if (index === array.length - 1) {
         acc[objFuncKey] = handlePathSegment(path, operation, acc[objFuncKey]);
       } else if (!acc[objFuncKey] || typeof acc[objFuncKey] !== "object") {
@@ -348,15 +390,46 @@ function generateFunctions(paths, baseUrl) {
       return acc[objFuncKey];
     }, body);
   }
+  let tsString = "";
   for (const [parent, object] of Object.entries(body)) {
-    tsString += `export const ${parent} = ${JSON.stringify(object, void 0, 2)};
+    tsString += `
+/**
+ * API functions for ${parent} endpoints
+ */
+export const ${parent} = ${JSON.stringify(object, void 0, 2)};
 `;
   }
   Object.entries(functionsInventory).forEach(([key, value]) => {
     tsString = tsString.replace(`"${key}"`, value);
   });
-  tsString = fileTemplate(tsString, allTypes, baseUrl);
-  return tsString;
+  return fileTemplate(tsString, allTypes, baseUrl);
+}
+function fileTemplate(tsString, typeForImport, baseURL) {
+  const templateCode = `import ax from 'axios';
+import type { AxiosResponse } from 'axios';
+import type { ${typeForImport.join(", ")} } from './types.d';
+
+/**
+ * Options for file upload operations
+ */
+export interface UploadOptions {
+	/** Progress callback for upload operations */
+	onUploadProgress?: (progressEvent: any) => void
+	/** Directory path for the uploaded file */
+	dirPath?: string
+	/** Tags to associate with the uploaded file */
+	tags?: string[]
+}
+
+/**
+ * Configured axios instance for API requests
+ * @example
+ * // Making a direct request with the axios instance
+ * const response = await axios.get('/some-endpoint');
+ */
+export const axios = ax.create({baseURL: ${baseURL}, withCredentials: true});
+${tsString}`;
+  return templateCode.replace(/"([^"]+)":/g, "$1:");
 }
 
 function generateTypes(schemas) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bagelink/sdk",
   "type": "module",
-  "version": "1.2.20",
+  "version": "1.2.25",
   "description": "Bagel core sdk packages",
   "author": {
     "name": "Neveh Allon",