Generator command

Author: vcua-mobify

resources/generate-from-oas/config/config.yaml

@@ -0,0 +1,2 @@
+additionalProperties:
+  paramNaming: original

src/commands/generate.ts

@@ -0,0 +1,7 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+export { GenerateCommand as default } from "../generate-from-oas";

src/diff/diffCommand.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2020, salesforce.com, inc.
+ * Copyright (c) 2025, salesforce.com, inc.
  * All rights reserved.
  * SPDX-License-Identifier: BSD-3-Clause
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
@@ -228,7 +228,6 @@ Exit statuses:
         // Diff two files (we do not have a custom ruleset defined for OAS
         // By default, checks are all 'diff-only' 
         await oasDiffChangelog(baseApis, newApis, flags);
-        // await oasDiffChangelog("~/Git/oas-spike/diff-oas-test/specs/petstore.yaml", "~/Git/oas-spike/diff-oas-test/specs/petstore1.yaml", flags);
       }
     } else {
       if (flags.dir) {

src/diff/oasDiff.ts

@@ -1,3 +1,9 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
 import { flags } from "@oclif/command";
 import { OutputFlags } from "@oclif/parser";
 import fs from 'fs-extra'

src/generate-from-oas/generateCommand.ts

@@ -0,0 +1,59 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import { Command, flags } from "@oclif/command";
+import { allCommonFlags } from "../common/flags";
+import { generateFromOas, DEFAULT_CONFIG_PACKAGE_PATH, DEFAULT_CONFIG_PATH } from "./generateFromOas";
+
+export class GenerateCommand extends Command {
+
+  static description = "Generate from OAS";
+
+  static flags = {
+    ...allCommonFlags(),
+    inputSpec: flags.string({
+      char: "i",
+      description: 'Input OAS specification file',
+      required: true,
+    }),
+    outputDir: flags.string({
+      char: "o",
+      description: 'Output directory for generated code',
+      required: true,   
+    }),
+    templateDir: flags.string({
+      char: "t",
+      description: 'Template directory',
+      required: true,
+    }),
+    configFile: flags.string({
+        char: "c",
+        description: `[default:${DEFAULT_CONFIG_PACKAGE_PATH}] Configuration file with additional generator properties`
+    }),
+    generator: flags.string({
+      char: "g",
+      description: '[default:typescript-fetch] Generator to use',
+    }),
+    skipValidateSpec: flags.boolean({
+      description: 'Skip validation of the OAS specification',
+    }),
+  };
+
+  async run(): Promise<void> {
+    console.log('Running generator')
+    const { flags } = this.parse(GenerateCommand);
+    console.log(flags)
+    generateFromOas({
+      inputSpec: flags.inputSpec,
+      outputDir: flags.outputDir,
+      templateDir: flags.templateDir,
+      configFile: flags.configFile,
+      generator: flags.generator,
+      skipValidateSpec: flags.skipValidateSpec
+    });
+  }
+}

src/generate-from-oas/generateFromOas.ts

@@ -0,0 +1,45 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import path from "path";
+import { execSync } from "child_process";
+import { string, boolean } from "@oclif/parser/lib/flags";
+
+  // Path relative to project root
+  export const DEFAULT_CONFIG_BASE_PATH =
+  "resources/generate-from-oas/config/config.yaml";
+
+  export const DEFAULT_CONFIG_PATH = path.join(
+    __dirname,
+    "../../",
+    DEFAULT_CONFIG_BASE_PATH
+  );
+
+  // Path prefixed with package name, short form usable by require()
+  export const DEFAULT_CONFIG_PACKAGE_PATH = path.join(
+    "@commerce-apps/raml-toolkit",
+    path.dirname(DEFAULT_CONFIG_BASE_PATH),
+    path.basename(DEFAULT_CONFIG_BASE_PATH)
+  );
+
+
+export const generateFromOas = (args: {
+  inputSpec: string,
+  outputDir: string,
+  templateDir: string,
+  configFile?: string,
+  generator?: string,
+  skipValidateSpec?: boolean
+}) => {
+    const {inputSpec, outputDir, templateDir, configFile, generator, skipValidateSpec} = args;
+    const skipValidateSpecFlag = skipValidateSpec ? "--skip-validate-spec" : "";
+    const _configFile = configFile ? configFile : DEFAULT_CONFIG_PATH;
+    const _generator = generator ? generator : "typescript-fetch";
+
+    execSync(`openapi-generator-cli generate -i ${inputSpec} -o ${outputDir} -t ${templateDir} -g ${_generator} -c ${_configFile} ${skipValidateSpecFlag}`);
+}
+

src/generate-from-oas/index.ts

@@ -0,0 +1,8 @@
+/*
+ * Copyright (c) 2025, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+export { GenerateCommand } from "./generateCommand";
+export { generateFromOas } from "./generateFromOas";

src/index.ts

@@ -9,5 +9,6 @@ export * as amfParser from "./common/amfParser";
 export * as diff from "./diff";
 export * as download from "./download";
 export * as generate from "./generate";
+export * as generateFromOas from "./generate-from-oas";
 export * as lint from "./lint";
 export { ramlToolLogger } from "./common/logger";