@accelbyte/codegen 0.0.0-dev-20260407233405 → 0.0.0-dev-20260422072053

package/README.md

@@ -10,20 +10,20 @@ AccelByte Code Generator is a CLI tool that facilitates creating an AccelByte Ty
 This codegen build a CLI called `accelbyte-codegen` that will be used to generate code from given config.
 
 ```
-Commands:  
-accelbyte-codegen download-swaggers  Download swaggers JSON files  
-accelbyte-codegen generate-code      Generate code based on downloaded swagger files
+Commands:
+accelbyte-codegen download-swaggers  Download swagger JSON files
+accelbyte-codegen generate-code      Generate code from downloaded swagger files
 
 Options:
---version           Show version number                                                               [boolean]  
---config            Path to the config file with backend service URLs.                                [string] [required]  
---swaggersOutput    Directory to save the downloaded Swagger JSON files.                              [string] [required]  
---output            Directory for the generated code. Required when using the generate-code command.  [string]  
---help              Show help                                                                         [boolean]
---skipReactQuery    Disable React Query code generation.                                              [boolean]
---snippetOutput     Generate only code snippets.                                                      [boolean]
---snippetOnly       Directory for the generated code snippets. Required when generating snippets.     [boolean]
---webSocketSchema   Path to the WebSocket schema file (schema.json).                                  [string]
+--version                   Show version number                                                     [boolean]
+--config                    Path to the config file with backend service URLs.                      [string] [required]
+--swaggersOutput            Directory to save the downloaded Swagger JSON files.                    [string] [required]
+--output                    Directory for the generated code. Required for generate-code.           [string]
+--help                      Show help                                                               [boolean]
+--skipReactQuery            Disable React Query code generation.                                    [boolean]
+--snippetOnly               Generate only code snippets.                                            [boolean]
+--snippetOutput             Directory for the generated code snippets.                              [string]
+--webSocketSchema           Path to the WebSocket schema file (schema.json).                        [string]
 ```
 
 ### Config file
@@ -133,14 +133,57 @@ export default {
 
   // Generate barrel index files (index.ts, all-imports.ts, all-query-imports.ts).
   // Default: true
-  unstable_shouldProduceIndexFiles: false,
+  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.
-  unstable_overrideAsAny: {
+  overrideAsAny: {
     ProtobufAny: true,
     SomeOther: (schema) => schema.properties?.['@type'] !== undefined
-  }
+  },
+
+  // Output each swagger set into a subfolder named after its service name.
+  // Default: false
+  unstable_splitOutputByServiceName: true
+} satisfies CodegenConfigOptions
+```
+
+### `unstable_splitOutputByServiceName`
+
+By default, all swagger sets in `swaggers.json` are generated into the same `--output` directory. When this option is enabled, each set is placed in a subfolder named after its service name (the first element of each inner array).
+
+Given a config like:
+
+```json
+[
+  ["iam",      "iam",      "iam.json",      "https://example.com/iam/apidocs/api.json"],
+  ["platform", "platform", "platform.json", "https://example.com/platform/swagger.json"]
+]
+```
+
+The output becomes:
+
+```
+sdk/
+  iam/
+    generated-admin/
+    generated-public/
+    generated-definitions/
+    Iam.ts
+  platform/
+    generated-admin/
+    generated-public/
+    generated-definitions/
+    Platform.ts
+  all-imports.ts        ← re-exports from all subfolders
+  all-query-imports.ts
+```
+
+Enable via `abcodegen.config.ts`:
+
+```typescript
+export default {
+  unstable_splitOutputByServiceName: true
 } satisfies CodegenConfigOptions
 ```
 

package/dist/accelbyte-codegen.d.mts

@@ -6,17 +6,26 @@ interface CodegenConfigOptions {
      * @example
      * { ProtobufAny: true, SomeOther: (schema) => schema.properties?.['@type'] !== undefined }
      */
-    unstable_overrideAsAny?: Record<string, boolean | ((schema: Record<string, any>) => boolean)>;
+    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;
+    shouldProduceIndexFiles?: boolean;
     /**
      * Override the base path prepended to all API routes.
      * @default `basePath` from the swagger spec
      */
     basePath?: string;
+    /**
+     * When enabled, each swagger set is generated into a subfolder named after its service name
+     * inside the output directory, instead of all sets sharing the same root output folder.
+     *
+     * If swaggers.json contains [["a", "b", "c", "d"]], then the service name is the "a".
+     *
+     * @default false
+     */
+    unstable_splitOutputByServiceName?: boolean;
 }
 
 export type { CodegenConfigOptions };

package/dist/accelbyte-codegen.d.ts

@@ -6,17 +6,26 @@ interface CodegenConfigOptions {
      * @example
      * { ProtobufAny: true, SomeOther: (schema) => schema.properties?.['@type'] !== undefined }
      */
-    unstable_overrideAsAny?: Record<string, boolean | ((schema: Record<string, any>) => boolean)>;
+    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;
+    shouldProduceIndexFiles?: boolean;
     /**
      * Override the base path prepended to all API routes.
      * @default `basePath` from the swagger spec
      */
     basePath?: string;
+    /**
+     * When enabled, each swagger set is generated into a subfolder named after its service name
+     * inside the output directory, instead of all sets sharing the same root output folder.
+     *
+     * If swaggers.json contains [["a", "b", "c", "d"]], then the service name is the "a".
+     *
+     * @default false
+     */
+    unstable_splitOutputByServiceName?: boolean;
 }
 
 export type { CodegenConfigOptions };

package/dist/accelbyte-codegen.js

@@ -109,13 +109,16 @@ var CodegenConfig = class _CodegenConfig {
     _CodegenConfig.config = loaded.default ?? loaded ?? {};
   }
   static shouldProduceIndexFiles() {
-    return _CodegenConfig.config.unstable_shouldProduceIndexFiles ?? true;
+    return _CodegenConfig.config.shouldProduceIndexFiles ?? true;
   }
   static getBasePath() {
     return _CodegenConfig.config.basePath;
   }
   static getOverrideAsAny() {
-    return _CodegenConfig.config.unstable_overrideAsAny;
+    return _CodegenConfig.config.overrideAsAny;
+  }
+  static splitOutputByServiceName() {
+    return _CodegenConfig.config.unstable_splitOutputByServiceName ?? false;
   }
   /** Reset to defaults — used for testing */
   static reset() {
@@ -883,6 +886,16 @@ var resolveConflicts = ({ path: path9, generatedMethod, testedGeneratedMethod, e
       _testedGenMethod += "_admin";
     }
   }
+  try {
+    testConflict(path9, _testedGenMethod, existingMethods);
+  } catch (e) {
+    const parentSegmentMatch = path9.match(/\/([^/{}]+)\/{[^}]+}\/[^/]*$/);
+    if (parentSegmentMatch) {
+      const suffix = "_By" + import_lodash.default.upperFirst(import_lodash.default.camelCase(parentSegmentMatch[1]));
+      generatedMethod += suffix;
+      _testedGenMethod += suffix;
+    }
+  }
   testConflict(path9, _testedGenMethod, existingMethods);
   return generatedMethod;
 };
@@ -1907,8 +1920,11 @@ var CodeGenerator = class _CodeGenerator {
     const queryImportsSet = /* @__PURE__ */ new Set();
     const apiInfo = { ...api.info, "x-version": api["x-version"]?.version };
     console.log("----------\nGenerating API:", { title: apiInfo.title, version: apiInfo.version });
+    const isSplitByService = CodegenConfig.splitOutputByServiceName();
+    const srcFolder = isSplitByService ? import_path4.default.join(CliParser.getOutputPath(), serviceName) : CliParser.getOutputPath();
+    const targetSrcFolder = `${CliParser.getOutputPath()}/`;
     if (!CliParser.isGenerateSnippetOnly()) {
-      ParserUtils.writeXVersion(_CodeGenerator.srcFolder(), api["x-version"], api.info);
+      ParserUtils.writeXVersion(srcFolder, api["x-version"], api.info);
     }
     const parsedInformation = await SwaggerReaderHelpers.parseAllEndpoints({ api, sdkName, serviceName });
     if (CliParser.getSnippetOutputPath()) {
@@ -1934,11 +1950,10 @@ var CodeGenerator = class _CodeGenerator {
       console.log("\nSuccessfully generate SDK snippets only\n----------\n\n");
       return;
     }
-    const DIST_DIR = (isAdmin) => `${_CodeGenerator.getGeneratedFolder(isAdmin)}`;
+    const DIST_DIR = (isAdmin) => import_path4.default.join(srcFolder, isAdmin ? "generated-admin" : "generated-public");
     const DIST_DIR_ENDPOINTS = (isAdmin) => import_path4.default.join(DIST_DIR(isAdmin), "endpoints");
     const DIST_DIR_QUERIES = (isAdmin) => import_path4.default.join(DIST_DIR(isAdmin), "queries");
-    const DIST_DEFINITION_DIR = import_path4.default.join(_CodeGenerator.srcFolder(), "generated-definitions");
-    const targetSrcFolder = `${_CodeGenerator.srcFolder()}/`;
+    const DIST_DEFINITION_DIR = import_path4.default.join(srcFolder, "generated-definitions");
     _CodeGenerator.prepareDirs(DIST_DEFINITION_DIR, DIST_DIR, DIST_DIR_ENDPOINTS, DIST_DIR_QUERIES);
     const mainApiList = [];
     const generatedDefinitions = [];
@@ -1993,9 +2008,7 @@ var CodeGenerator = class _CodeGenerator {
         }
         mainApiList.push(...apiList);
         if (CodegenConfig.shouldProduceIndexFiles()) {
-          indexImportsSet.add(
-            ParserUtils.getRelativePathToWebSdkSrcFolder(import_path4.default.join(_CodeGenerator.srcFolder(), serviceNameTitle), targetSrcFolder)
-          );
+          indexImportsSet.add(ParserUtils.getRelativePathToWebSdkSrcFolder(import_path4.default.join(srcFolder, serviceNameTitle), targetSrcFolder));
         }
       };
       const writeDefinitions = (api2) => {
@@ -2030,7 +2043,7 @@ var CodeGenerator = class _CodeGenerator {
     if (CodegenConfig.shouldProduceIndexFiles()) {
       const isGenerateWebSocket = CliParser.isGenerateWebSocket();
       const apiIndexBuff = templateApiIndex(serviceNameTitle, mainApiList, isGenerateWebSocket);
-      ParserUtils.writeApiMainFile(_CodeGenerator.srcFolder(), serviceNameTitle, apiIndexBuff);
+      ParserUtils.writeApiMainFile(srcFolder, serviceNameTitle, apiIndexBuff);
     }
     console.log("\nCOMPLETED\n----------\n\n");
     return { indexImports: indexImportsSet, queryImports: queryImportsSet };