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

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
@@ -140,7 +140,50 @@ export default {
   unstable_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

@@ -17,6 +17,15 @@ interface CodegenConfigOptions {
      * @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

@@ -17,6 +17,15 @@ interface CodegenConfigOptions {
      * @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

@@ -117,6 +117,9 @@ var CodegenConfig = class _CodegenConfig {
   static getOverrideAsAny() {
     return _CodegenConfig.config.unstable_overrideAsAny;
   }
+  static splitOutputByServiceName() {
+    return _CodegenConfig.config.unstable_splitOutputByServiceName ?? false;
+  }
   /** Reset to defaults — used for testing */
   static reset() {
     _CodegenConfig.config = {};
@@ -1907,8 +1910,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 +1940,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 +1998,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 +2033,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 };