@accelbyte/codegen 0.0.0-dev-20260320085237 → 0.0.0-dev-20260406042959

package/README.md

@@ -124,14 +124,16 @@ Place an `abcodegen.config.ts` file next to your `swaggers.json` to customize co
 
 ```typescript
 // abcodegen.config.ts
+import { type CodegenConfigOptions } from '@accelbyte/codegen'
+
 export default {
   // Override the base path prepended to all API routes.
   // Default: uses basePath from the swagger spec.
   basePath: '/custom',
 
-  // Skip generation of barrel index files (index.ts, all-query-imports.ts).
+  // Generate barrel index files (index.ts, all-imports.ts, all-query-imports.ts).
   // Default: true
-  unstable_shouldProduceIndexFile: false,
+  unstable_shouldProduceIndexFiles: false,
 
   // Force specific definitions to emit `z.any()` instead of a full schema.
   // Keyed by definition file name. Value can be `true` or a function receiving the schema.
@@ -139,7 +141,7 @@ export default {
     ProtobufAny: true,
     SomeOther: (schema) => schema.properties?.['@type'] !== undefined
   }
-}
+} satisfies CodegenConfigOptions
 ```
 
 ## Design Decisions
@@ -156,4 +158,10 @@ This triggers `@typescript-eslint/no-empty-object-type`. That rule guards agains
   files: ['src/generated-definitions/**'],
   rules: { '@typescript-eslint/no-empty-object-type': 'off' }
 }
-```
+```
+
+## Troubleshooting
+
+### Type or lint errors in generated files
+
+The generated code aims to use neutral, unopinionated style defaults. However, some generated syntax may conflict with your tsconfig or linter settings. In that case, you can ignore specific lint rules in the codegen folder, or create a `tsconfig.json` inside it to override your top-level configuration.

package/dist/accelbyte-codegen.d.mts

@@ -0,0 +1,22 @@
+interface CodegenConfigOptions {
+    /**
+     * Force specific definitions to emit `z.any()` instead of a full schema.
+     * Keyed by definition file name. Value can be `true` or a function receiving the schema.
+     *
+     * @example
+     * { ProtobufAny: true, SomeOther: (schema) => schema.properties?.['@type'] !== undefined }
+     */
+    unstable_overrideAsAny?: Record<string, boolean | ((schema: Record<string, any>) => boolean)>;
+    /**
+     * Generate barrel index files (index.ts, all-imports.ts, all-query-imports.ts).
+     * @default true
+     */
+    unstable_shouldProduceIndexFiles?: boolean;
+    /**
+     * Override the base path prepended to all API routes.
+     * @default `basePath` from the swagger spec
+     */
+    basePath?: string;
+}
+
+export type { CodegenConfigOptions };

package/dist/accelbyte-codegen.d.ts

@@ -0,0 +1,22 @@
+interface CodegenConfigOptions {
+    /**
+     * Force specific definitions to emit `z.any()` instead of a full schema.
+     * Keyed by definition file name. Value can be `true` or a function receiving the schema.
+     *
+     * @example
+     * { ProtobufAny: true, SomeOther: (schema) => schema.properties?.['@type'] !== undefined }
+     */
+    unstable_overrideAsAny?: Record<string, boolean | ((schema: Record<string, any>) => boolean)>;
+    /**
+     * Generate barrel index files (index.ts, all-imports.ts, all-query-imports.ts).
+     * @default true
+     */
+    unstable_shouldProduceIndexFiles?: boolean;
+    /**
+     * Override the base path prepended to all API routes.
+     * @default `basePath` from the swagger spec
+     */
+    basePath?: string;
+}
+
+export type { CodegenConfigOptions };

package/dist/accelbyte-codegen.js

@@ -21,8 +21,11 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/cli.ts
+var cli_exports = {};
+module.exports = __toCommonJS(cli_exports);
 var import_path6 = __toESM(require("path"));
 var import_yargs = __toESM(require("yargs"));
 
@@ -105,8 +108,8 @@ var CodegenConfig = class _CodegenConfig {
     const loaded = await import((0, import_url.pathToFileURL)(configPath).href);
     _CodegenConfig.config = loaded.default ?? loaded ?? {};
   }
-  static shouldProduceIndexFile() {
-    return _CodegenConfig.config.unstable_shouldProduceIndexFile ?? true;
+  static shouldProduceIndexFiles() {
+    return _CodegenConfig.config.unstable_shouldProduceIndexFiles ?? true;
   }
   static getBasePath() {
     return _CodegenConfig.config.basePath;
@@ -194,7 +197,8 @@ var getResponseType = ({
   defaultType = "unknown"
 }) => {
   const responseClass = responseClasses.length === 1 ? responseClasses?.[0] : "unknown";
-  const responseType = responseClass !== "unknown" ? responseClasses?.[0] : defaultType;
+  const rawResponseType = responseClass !== "unknown" ? responseClasses?.[0] : defaultType;
+  const responseType = rawResponseType === "__dictionary__" ? "Record<string, any>" : rawResponseType;
   return {
     responseType,
     responseTypeInAxiosResponse: `Promise<AxiosResponse<${responseType}>>`,
@@ -240,13 +244,28 @@ var generateImports = (body, importStatements, makeNewImportVarMap3, getImportab
 ${importStatements.sort().join("\n")}`;
 };
 var templateClass = (className, body, importStatements) => {
+  const attributes = {
+    definitions: ["private axiosInstance: AxiosInstance", "private namespace: string", "private useSchemaValidation: boolean"],
+    assignments: ["this.axiosInstance = axiosInstance", "this.namespace = namespace", "this.useSchemaValidation = useSchemaValidation"]
+  };
+  let namespaceConstructor = "namespace";
+  if (!body.includes(".replace('{namespace}', this.namespace)")) {
+    namespaceConstructor = "_namespace";
+    attributes.definitions.splice(1, 1);
+    attributes.assignments.splice(1, 1);
+  }
   return `/**
  * AUTO GENERATED
  */
 ${generateImports(body, importStatements, makeNewImportVarMap(), getImportableVarMap(), CLASS_TYPE_ONLY_VARS)}
 
 export class ${className} {
-  constructor(private axiosInstance: AxiosInstance, private namespace: string, private useSchemaValidation = true) {}
+  ${attributes.definitions.join("\n")}
+
+  constructor(axiosInstance: AxiosInstance, ${namespaceConstructor}: string, useSchemaValidation = true) {
+    ${attributes.assignments.join("\n")}
+  }
+
   ${body}
 }
   `;
@@ -499,13 +518,14 @@ var ParserUtils = class _ParserUtils {
   };
   static parseRefImport = (bodyParam) => {
     const $ref = bodyParam?.schema?.$ref || bodyParam?.schema?.items?.$ref;
-    if (!$ref) {
+    if (!$ref || $ref.endsWith("__dictionary__")) {
       return null;
     }
     const type = _ParserUtils.parseRefType($ref);
     return `import { ${type} } from '../../generated-definitions/${type}.js'`;
   };
   static parseRefType = ($ref) => {
+    if ($ref.endsWith("__dictionary__")) return "__dictionary__";
     let ref = $ref.replace(".", "/");
     if (ref[ref.length - 1] === "." || ref[ref.length - 1] === "/") {
       ref = ref.slice(0, -1);
@@ -703,6 +723,7 @@ var ParserUtils = class _ParserUtils {
     return queryFileName;
   }
   static writeXVersion(distDir, xversionJson, apiInfo) {
+    import_fs4.default.mkdirSync(distDir, { recursive: true });
     if (xversionJson) {
       console.log("x-version:", xversionJson);
       import_fs4.default.writeFileSync(`${distDir}/version.json`, JSON.stringify(xversionJson, null, 2));
@@ -1077,6 +1098,7 @@ var templateMethod = ({
   let dataType = null;
   if (httpMethod !== "get") {
     dataType = ParserUtils.parseBodyParamsType(bodyParams);
+    if (dataType === "__dictionary__") dataType = "Record<string, any>";
     importStatements = ParserUtils.parseBodyParamsImports(bodyParams);
     methodParams += dataType ? `data: ${dataType},` : "";
     methodParamsNoTypes += dataType ? `data,` : "";
@@ -1100,7 +1122,7 @@ var templateMethod = ({
   }
   const isFileUpload = methodParams.indexOf("data: {file") > -1;
   const { responseType, responseTypeInResponse } = getResponseType({ responseClasses });
-  const resolvedResponseClassValidated = responseType !== "unknown" ? `${responseType}` : "z.unknown()";
+  const resolvedResponseClassValidated = responseClasses.length === 1 && responseClasses[0] === "__dictionary__" ? "z.record(z.string(), z.any())" : 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);
@@ -1444,7 +1466,7 @@ var SwaggerReaderHelpers = class _SwaggerReaderHelpers {
         const responseClass = responseClasses.length > 1 ? null : responseClasses?.[0];
         const { className, classGenName } = ParserUtils.generateClassName(tag, isAdminEndpoint);
         tagToClassImportsRecord[className] = tagToClassImportsRecord[className] ? tagToClassImportsRecord[className] : {};
-        if (responseClass) {
+        if (responseClass && responseClass !== "__dictionary__") {
           tagToClassImportsRecord[className][responseClass] = `import { ${responseClass} } from '../../generated-definitions/${responseClass}.js'`;
         }
         if (responseClass && responseClass.endsWith("Array")) {
@@ -1692,7 +1714,14 @@ ${exportedTypeString}
       };
     } else if (type) {
       if (type === "object" && definition.additionalProperties) {
-        const zodAttribute = this.parseToZodAttribute("", definition.additionalProperties, [""]);
+        const additionalProps = definition.additionalProperties;
+        if (Object.keys(additionalProps).length === 0) {
+          return {
+            schemaString: `${schemaAttribute} z.record(z.any())${schemaRequired}`,
+            typeString: `${typeAttribute} Record<string, any>${typeNullishability}`
+          };
+        }
+        const zodAttribute = this.parseToZodAttribute("", additionalProps, [""]);
         return {
           schemaString: `${schemaAttribute} z.record(${zodAttribute.schemaString})${schemaRequired}`,
           typeString: `${typeAttribute} Record<string, ${zodAttribute.typeString}>${typeNullishability}`
@@ -1963,7 +1992,7 @@ var CodeGenerator = class _CodeGenerator {
           );
         }
         mainApiList.push(...apiList);
-        if (CodegenConfig.shouldProduceIndexFile()) {
+        if (CodegenConfig.shouldProduceIndexFiles()) {
           indexImportsSet.add(
             ParserUtils.getRelativePathToWebSdkSrcFolder(import_path4.default.join(_CodeGenerator.srcFolder(), serviceNameTitle), targetSrcFolder)
           );
@@ -1973,6 +2002,7 @@ var CodeGenerator = class _CodeGenerator {
         const duplicates = /* @__PURE__ */ new Map();
         const definitions = api2?.components?.schemas || api2.definitions;
         for (const ref in definitions) {
+          if (ref === "__dictionary__") continue;
           const definition = definitions[ref];
           const fileName = ParserUtils.parseRefType(ref);
           const fileExist = import_fs5.default.existsSync(import_path4.default.join(DIST_DEFINITION_DIR, `${fileName}.ts`));
@@ -1997,7 +2027,7 @@ var CodeGenerator = class _CodeGenerator {
     };
     generatePublicOrAdmin(true);
     generatePublicOrAdmin(false);
-    if (CodegenConfig.shouldProduceIndexFile()) {
+    if (CodegenConfig.shouldProduceIndexFiles()) {
       const isGenerateWebSocket = CliParser.isGenerateWebSocket();
       const apiIndexBuff = templateApiIndex(serviceNameTitle, mainApiList, isGenerateWebSocket);
       ParserUtils.writeApiMainFile(_CodeGenerator.srcFolder(), serviceNameTitle, apiIndexBuff);
@@ -2028,6 +2058,7 @@ var SwaggerDownloader = class _SwaggerDownloader {
     fs6.readFile(filePath, "utf8", (err, data) => {
       if (err) throw err;
       let result = data;
+      result = result.replace(new RegExp("map%5Bstring%5Dinterface%20%7B%7D", "g"), "__dictionary__").replace(new RegExp("map\\[string\\]interface \\{\\}", "g"), "__dictionary__").replace(new RegExp("map\\[string\\]any", "g"), "__dictionary__");
       searchStr.forEach((s) => {
         result = result.replace(new RegExp(s, "g"), " ");
       });
@@ -2425,6 +2456,9 @@ var generateSdk = async () => {
   if (CliParser.isGenerateWebSocket()) {
     WebsocketGenerator.main();
   }
+  if (!CodegenConfig.shouldProduceIndexFiles()) {
+    return;
+  }
   const indexImportsSet = /* @__PURE__ */ new Set();
   const queryImportsSet = /* @__PURE__ */ new Set();
   const filenamesSet = /* @__PURE__ */ new Set();