@accelbyte/codegen 0.0.0-dev-20240906023252 → 0.0.0-dev-20240911051006

package/dist/accelbyte-codegen.js

@@ -146,6 +146,18 @@ var extractDescription = (description, options) => {
     indentation
   }) : "";
 };
+var getResponseType = ({
+  responseClasses,
+  defaultType = "unknown"
+}) => {
+  const responseClass = responseClasses.length === 1 ? responseClasses?.[0] : "unknown";
+  const responseType = responseClass !== "unknown" ? responseClasses?.[0] : defaultType;
+  return {
+    responseType,
+    responseTypeInAxiosResponse: `Promise<AxiosResponse<${responseType}>>`,
+    responseTypeInResponse: `Promise<Response<${responseType}>>`
+  };
+};
 
 // src/templates/template-class.ts
 var getImportableVarMap = () => ({
@@ -199,6 +211,12 @@ var makeNewImportVarMap2 = () => ({
   axios: ["AxiosRequestConfig", "AxiosResponse"]
 });
 var templateApiClass = (className, body, importStatements, returnMethods) => {
+  const returnsMethodsWithDescription = Object.keys(returnMethods).reduce((acc, key) => {
+    acc += `
+    ${returnMethods[key]}
+${key},`;
+    return acc;
+  }, "");
   const $className = className.replace(/Api$/, "$");
   return `/**
  * AUTO GENERATED
@@ -213,25 +231,35 @@ export function ${className}(sdk: AccelByteSDK, args?: SdkSetConfigParam) {
   const sdkAssembly = sdk.assembly()
   
   const namespace = args?.coreConfig?.namespace ?? sdkAssembly.coreConfig.namespace
-  const requestConfig = ApiUtils.mergeAxiosConfigs(sdkAssembly.axiosInstance.defaults as AxiosRequestConfig, {...(args?.coreConfig?.baseURL ? {baseURL: args?.coreConfig?.baseURL} : {}), ...args?.axiosConfig?.request})
-  const interceptors = args?.axiosConfig?.interceptors ?? sdkAssembly.axiosConfig.interceptors ?? []
   const useSchemaValidation = args?.coreConfig?.useSchemaValidation ?? sdkAssembly.coreConfig.useSchemaValidation
-  const axiosInstance = Network.create(requestConfig)
   
-  for (const interceptor of interceptors) {
-    if(interceptor.type === 'request') {
-      axiosInstance.interceptors.request.use(interceptor?.onRequest, interceptor.onError)
-    }
+  let axiosInstance = sdkAssembly.axiosInstance
+  const requestConfigOverrides = args?.axiosConfig?.request
+  const baseURLOverride = args?.coreConfig?.baseURL
+  const interceptorsOverride = args?.axiosConfig?.interceptors ?? []
 
-    if(interceptor.type === 'response') {
-      axiosInstance.interceptors.response.use(interceptor?.onSuccess, interceptor.onError)
+  if (requestConfigOverrides || baseURLOverride || interceptorsOverride.length > 0) {
+    const requestConfig = ApiUtils.mergeAxiosConfigs(sdkAssembly.axiosInstance.defaults as AxiosRequestConfig, {
+      ...(baseURLOverride ? { baseURL: baseURLOverride } : {}),
+      ...requestConfigOverrides
+    })
+    axiosInstance = Network.create(requestConfig)
+
+    for (const interceptor of interceptorsOverride) {
+      if (interceptor.type === 'request') {
+        axiosInstance.interceptors.request.use(interceptor.onRequest, interceptor.onError)
+      }
+
+      if (interceptor.type === 'response') {
+        axiosInstance.interceptors.response.use(interceptor.onSuccess, interceptor.onError)
+      }
     }
   }
 
   ${body}
   
   return {
-    ${returnMethods}
+    ${returnsMethodsWithDescription}
   }
 }
   `;
@@ -616,12 +644,12 @@ var ParserUtils = class _ParserUtils {
       import_fs3.default.writeFileSync(`${distDir}/version.json`, JSON.stringify(customVersion, null, 2));
     }
   }
-  static writeApiFile(distDir, apiName, apiBuffer, imports, returnMethods) {
+  static writeApiFile(distDir, apiName, apiBuffer, imports, returnMethodsDescription) {
     const newImports = [];
     imports.forEach((el) => {
       newImports.push(el.replace("../../generated-definitions", "../generated-definitions"));
     });
-    const fileContent = templateApiClass(apiName, apiBuffer, newImports, returnMethods);
+    const fileContent = templateApiClass(apiName, apiBuffer, newImports, returnMethodsDescription);
     import_fs3.default.writeFileSync(`${distDir}/${apiName}.ts`, _ParserUtils.prependCopyrightHeader(fileContent));
   }
   static writeApiMainFile(distDir, serviceName, fileContent) {
@@ -884,7 +912,6 @@ var OpenApiSpec = import_zod2.z.object({
 // src/templates/template-api-method.ts
 var templateApiMethod = ({
   classMethod,
-  description,
   httpMethod,
   path: path7,
   pathParams,
@@ -893,7 +920,6 @@ var templateApiMethod = ({
   classGenName,
   methodParams,
   methodParamsNoTypes,
-  deprecated,
   xSecurity
 }) => {
   let newPath = `'${path7}'`;
@@ -924,12 +950,9 @@ var templateApiMethod = ({
     }
   }
   const snippetShell = `curl ${snippetShellArgs.join(" \\\n    ")}`;
-  const descriptionText = extractDescription(description, { isDeprecated: deprecated, responseClasses });
-  const resolvedResponseClass = responseClasses.length === 1 ? responseClasses?.[0] : "unknown";
-  const responseType = resolvedResponseClass !== "unknown" ? `${resolvedResponseClass}` : "unknown";
+  const { responseType, responseTypeInAxiosResponse } = getResponseType({ responseClasses });
   const methodImpl = `
-  ${descriptionText}
-  async function ${classMethod}(${methodParams}): Promise<AxiosResponse<${responseType}>> {
+  async function ${classMethod}(${methodParams}): ${responseTypeInAxiosResponse} {
     const $ = new ${classGenName}(axiosInstance, namespace, useSchemaValidation)
     const resp = await $.${classMethod}(${methodParamsNoTypes})
     if (resp.error) throw resp.error
@@ -1005,14 +1028,12 @@ var templateMethod = ({
     dataPayload = dataType ? `{data, params}` : "{params}";
   }
   const isFileUpload = methodParams.indexOf("data: {file") > -1;
-  const resolvedResponseClass = responseClasses.length === 1 ? responseClasses?.[0] : "unknown";
-  const resolvedResponseClassValidated = responseClasses.length === 1 ? responseClasses?.[0] : "z.unknown()";
+  const { responseType, responseTypeInResponse } = getResponseType({ responseClasses });
+  const resolvedResponseClassValidated = responseType !== "unknown" ? `${responseType}` : "z.unknown()";
   methodParams = (queryParamsType ? `${methodParams} ${queryParamsType}` : methodParams).replace(/,\s*$/, "");
   methodParamsNoTypes = queryParamsType ? `${methodParamsNoTypes} queryParams` : methodParamsNoTypes;
   const isGuardInvoked = ["get", "post", "put", "patch", "delete"].includes(httpMethod);
-  const responseType = resolvedResponseClass !== "unknown" ? `${resolvedResponseClass}` : "unknown";
-  const responseSyncType = "Response";
-  const generatedMethodName = `${classMethod}(${methodParams}): Promise<${responseSyncType}<${responseType}>>`;
+  const generatedMethodName = `${classMethod}(${methodParams}): ${responseTypeInResponse}`;
   let methodImpl = `${descriptionText}
   ${generatedMethodName} {
     ${queryParamsDefault}
@@ -1070,9 +1091,8 @@ var templateQueryMethod = ({
       }
     }
   }
-  const resolvedResponseClass = responseClasses.length === 1 ? responseClasses?.[0] : "unknown";
-  let _methodName = convertMethodNameToHook({ classMethod, apiGenName, isPostFetch, isFetch });
-  const _responseType = resolvedResponseClass !== "unknown" ? `${resolvedResponseClass}` : "unknown";
+  const { responseType } = getResponseType({ responseClasses });
+  let _methodName = convertMethodNameToHook({ classMethod, apiGenName, isGet });
   const _methodParams = methodParams && methodParams.length > 0 ? `& { ${methodParams} }` : "";
   const _methodParamsImpl = convertToMethodImplArgs(methodParams);
   const queryKey = createQueryKey(apiGenName, classMethod);
@@ -1087,9 +1107,9 @@ ${descriptionText}
 export const ${_methodName} = (
     sdk: AccelByteSDK,
     input: SdkSetConfigParam ${_methodParams},
-    options?: Omit<UseQueryOptions<${_responseType}, AxiosError<ApiError>>, 'queryKey'>,
-    callback?: (data: AxiosResponse<${_responseType}>) => void
-  ): UseQueryResult<${_responseType}, AxiosError<ApiError>> => { 
+    options?: Omit<UseQueryOptions<${responseType}, AxiosError<ApiError>>, 'queryKey'>,
+    callback?: (data: AxiosResponse<${responseType}>) => void
+  ): UseQueryResult<${responseType}, AxiosError<ApiError>> => { 
   
   const queryFn = (
   sdk: AccelByteSDK, 
@@ -1102,7 +1122,7 @@ export const ${_methodName} = (
       return response.data
   }
   
-  return ${queryMethod}<${_responseType}, AxiosError<ApiError>>({
+  return ${queryMethod}<${responseType}, AxiosError<ApiError>>({
     queryKey: [${queryKey}, input],
     queryFn: queryFn(sdk, input),
     ...options
@@ -1115,9 +1135,9 @@ export const ${_methodName} = (
   ${descriptionText}
 export const ${_methodName} = (
     sdk: AccelByteSDK,
-    options?: Omit<UseMutationOptions<${_responseType}, AxiosError<ApiError>, SdkSetConfigParam ${_methodParams}>, 'mutationKey'>,
-    callback?: (data: ${_responseType}) => void
-  ): UseMutationResult<${_responseType}, AxiosError<ApiError>, SdkSetConfigParam ${_methodParams}> => { 
+    options?: Omit<UseMutationOptions<${responseType}, AxiosError<ApiError>, SdkSetConfigParam ${_methodParams}>, 'mutationKey'>,
+    callback?: (data: ${responseType}) => void
+  ): UseMutationResult<${responseType}, AxiosError<ApiError>, SdkSetConfigParam ${_methodParams}> => { 
   
   const mutationFn = async (input: SdkSetConfigParam ${_methodParams}) => {
       const response = 
@@ -1137,6 +1157,13 @@ export const ${_methodName} = (
   `;
   return isGet ? queryMethodImpl : mutationMethodImpl;
 };
+function versionMutationSuffixMethodName(baseMethodName) {
+  const parts = baseMethodName.split(/(_v\d+)$/);
+  const name = parts[0];
+  const versionSuffix = parts[1] || "";
+  const res = `${name}Mutation${versionSuffix}`;
+  return res;
+}
 function createQueryKey(className, methodName) {
   const prefixRegex = /^(get|create|update|delete|patch|post|fetch)[_]?/i;
   const cleanedMethodName = methodName.replace(prefixRegex, "").trim();
@@ -1152,15 +1179,11 @@ var prefixMappings = {
   post: "usePost",
   fetch: "useFetch"
 };
-function convertMethodNameToHook({
-  classMethod,
-  apiGenName,
-  isPostFetch,
-  isFetch
-}) {
-  for (const [originalPrefix, newPrefix] of Object.entries(prefixMappings)) {
+function convertMethodNameToHook({ classMethod, apiGenName, isGet }) {
+  for (const [originalPrefix] of Object.entries(prefixMappings)) {
     if (classMethod.startsWith(originalPrefix)) {
-      return `use${apiGenName}_${capitalize(classMethod)}`;
+      const methodName = !isGet ? versionMutationSuffixMethodName(classMethod) : classMethod;
+      return `use${apiGenName}_${capitalize(methodName)}`;
     }
   }
   return classMethod;
@@ -1246,7 +1269,8 @@ var SwaggerReaderHelpers = class _SwaggerReaderHelpers {
         tagToSdkClientRecord: {},
         tagToSdkFunctionNamesRecord: {},
         tagToSdkImportsRecord: {},
-        tagToEndpointQueryRecord: {}
+        tagToEndpointQueryRecord: {},
+        tagToSdkFunctionDescription: {}
       },
       public: {
         arrayDefinitions: [],
@@ -1256,7 +1280,8 @@ var SwaggerReaderHelpers = class _SwaggerReaderHelpers {
         tagToSdkClientRecord: {},
         tagToSdkFunctionNamesRecord: {},
         tagToSdkImportsRecord: {},
-        tagToEndpointQueryRecord: {}
+        tagToEndpointQueryRecord: {},
+        tagToSdkFunctionDescription: {}
       }
     };
     const sortedPathsByLength = new Map(
@@ -1288,7 +1313,8 @@ var SwaggerReaderHelpers = class _SwaggerReaderHelpers {
         tagToSdkClientRecord,
         tagToSdkFunctionNamesRecord,
         tagToSdkImportsRecord,
-        tagToEndpointQueryRecord
+        tagToEndpointQueryRecord,
+        tagToSdkFunctionDescription
       } = picked;
       const tagToClassMethodsMapByType = isAdminEndpoint ? tagToClassMethodsMap.admin : tagToClassMethodsMap.public;
       const generatedMethods = {};
@@ -1368,9 +1394,14 @@ var SwaggerReaderHelpers = class _SwaggerReaderHelpers {
           description
         });
         tagToEndpointQueryRecord[tag] = (tagToEndpointQueryRecord[tag] || "") + queryMethodImpl;
+        const fnDescription = extractDescription(description, { isDeprecated: deprecated, responseClasses });
+        const tagFnDescriptions = tagToSdkFunctionDescription[tag];
+        tagToSdkFunctionDescription[tag] = {
+          ...tagFnDescriptions,
+          [classMethod]: fnDescription
+        };
         const { generatedMethodString, snippetApiArgs, snippetMethod, snippetShell } = templateApiMethod({
           classMethod,
-          description,
           httpMethod,
           path: pathWithBase,
           pathParams,
@@ -1379,7 +1410,6 @@ var SwaggerReaderHelpers = class _SwaggerReaderHelpers {
           classGenName,
           methodParams,
           methodParamsNoTypes,
-          deprecated,
           xSecurity: endpoint["x-security"]
         });
         tagToSdkClientRecord[tag] = (tagToSdkClientRecord[tag] || "") + generatedMethodString;
@@ -1751,7 +1781,8 @@ var CodeGenerator = class _CodeGenerator {
         tagToSdkClientRecord,
         tagToSdkFunctionNamesRecord,
         tagToSdkImportsRecord,
-        tagToEndpointQueryRecord
+        tagToEndpointQueryRecord,
+        tagToSdkFunctionDescription
       } = parsedInformationByType;
       const writeApiEndpointFiles = (isAdminEndpoint) => {
         const apiList = [];
@@ -1775,7 +1806,7 @@ var CodeGenerator = class _CodeGenerator {
             sdkName
           );
           const apiBuffer = tagToSdkClientRecord[tag];
-          ParserUtils.writeApiFile(DIST_DIR(isAdminEndpoint), apiGenName, apiBuffer, imports, tagToSdkFunctionNamesRecord[tag]);
+          ParserUtils.writeApiFile(DIST_DIR(isAdminEndpoint), apiGenName, apiBuffer, imports, tagToSdkFunctionDescription[tag]);
           apiList.push(apiGenName);
           indexImportsSet.add(
             ParserUtils.getRelativePathToWebSdkSrcFolder(import_path3.default.join(DIST_DIR_ENDPOINTS(isAdminEndpoint), `${classGenName}`), targetSrcFolder)