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

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;
@@ -240,13 +243,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}
 }
   `;
@@ -703,6 +721,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));
@@ -1963,7 +1982,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)
           );
@@ -1997,7 +2016,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);
@@ -2425,6 +2444,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();