ondc-code-generator 0.9.0 → 1.0.0

package/alpha/table/rag-table-docs/confirm.md

@@ -3,11 +3,14 @@ action: confirm
 codeName: L1validations
 numTests: 45
 generated: 2026-03-10
+domain: -
+version: -
 ---
 
 # L1validations — `confirm` Validations (Table View)
 
 **36** leaf validation rule(s) applied to `confirm` in the **L1validations** flow.
+Domain: `-`, Version: `-`
 Group rows (GRP) list their immediate sub-tests. Leaf rows (LF) show the actual validation logic.
 
 ---

package/alpha/table/rag-table-docs/init.md

@@ -3,11 +3,14 @@ action: init
 codeName: L1validations
 numTests: 63
 generated: 2026-03-10
+domain: -
+version: -
 ---
 
 # L1validations — `init` Validations (Table View)
 
 **49** leaf validation rule(s) applied to `init` in the **L1validations** flow.
+Domain: `-`, Version: `-`
 Group rows (GRP) list their immediate sub-tests. Leaf rows (LF) show the actual validation logic.
 
 ---

package/alpha/table/rag-table-docs/on_confirm.md

@@ -3,11 +3,14 @@ action: on_confirm
 codeName: L1validations
 numTests: 146
 generated: 2026-03-10
+domain: -
+version: -
 ---
 
 # L1validations — `on_confirm` Validations (Table View)
 
 **109** leaf validation rule(s) applied to `on_confirm` in the **L1validations** flow.
+Domain: `-`, Version: `-`
 Group rows (GRP) list their immediate sub-tests. Leaf rows (LF) show the actual validation logic.
 
 ---

package/alpha/table/rag-table-docs/on_init.md

@@ -3,11 +3,14 @@ action: on_init
 codeName: L1validations
 numTests: 128
 generated: 2026-03-10
+domain: -
+version: -
 ---
 
 # L1validations — `on_init` Validations (Table View)
 
 **95** leaf validation rule(s) applied to `on_init` in the **L1validations** flow.
+Domain: `-`, Version: `-`
 Group rows (GRP) list their immediate sub-tests. Leaf rows (LF) show the actual validation logic.
 
 ---

package/alpha/table/rag-table-docs/on_search.md

@@ -3,11 +3,14 @@ action: on_search
 codeName: L1validations
 numTests: 145
 generated: 2026-03-10
+domain: -
+version: -
 ---
 
 # L1validations — `on_search` Validations (Table View)
 
 **115** leaf validation rule(s) applied to `on_search` in the **L1validations** flow.
+Domain: `-`, Version: `-`
 Group rows (GRP) list their immediate sub-tests. Leaf rows (LF) show the actual validation logic.
 
 ---

package/alpha/table/rag-table-docs/on_select.md

@@ -3,11 +3,14 @@ action: on_select
 codeName: L1validations
 numTests: 81
 generated: 2026-03-10
+domain: -
+version: -
 ---
 
 # L1validations — `on_select` Validations (Table View)
 
 **61** leaf validation rule(s) applied to `on_select` in the **L1validations** flow.
+Domain: `-`, Version: `-`
 Group rows (GRP) list their immediate sub-tests. Leaf rows (LF) show the actual validation logic.
 
 ---

package/alpha/table/rag-table-docs/on_status.md

@@ -3,11 +3,14 @@ action: on_status
 codeName: L1validations
 numTests: 135
 generated: 2026-03-10
+domain: -
+version: -
 ---
 
 # L1validations — `on_status` Validations (Table View)
 
 **101** leaf validation rule(s) applied to `on_status` in the **L1validations** flow.
+Domain: `-`, Version: `-`
 Group rows (GRP) list their immediate sub-tests. Leaf rows (LF) show the actual validation logic.
 
 ---

package/alpha/table/rag-table-docs/on_update.md

@@ -3,11 +3,14 @@ action: on_update
 codeName: L1validations
 numTests: 146
 generated: 2026-03-10
+domain: -
+version: -
 ---
 
 # L1validations — `on_update` Validations (Table View)
 
 **109** leaf validation rule(s) applied to `on_update` in the **L1validations** flow.
+Domain: `-`, Version: `-`
 Group rows (GRP) list their immediate sub-tests. Leaf rows (LF) show the actual validation logic.
 
 ---

package/alpha/table/rag-table-docs/search.md

@@ -3,11 +3,14 @@ action: search
 codeName: L1validations
 numTests: 110
 generated: 2026-03-10
+domain: -
+version: -
 ---
 
 # L1validations — `search` Validations (Table View)
 
 **88** leaf validation rule(s) applied to `search` in the **L1validations** flow.
+Domain: `-`, Version: `-`
 Group rows (GRP) list their immediate sub-tests. Leaf rows (LF) show the actual validation logic.
 
 ---

package/alpha/table/rag-table-docs/select.md

@@ -3,11 +3,14 @@ action: select
 codeName: L1validations
 numTests: 52
 generated: 2026-03-10
+domain: -
+version: -
 ---
 
 # L1validations — `select` Validations (Table View)
 
 **40** leaf validation rule(s) applied to `select` in the **L1validations** flow.
+Domain: `-`, Version: `-`
 Group rows (GRP) list their immediate sub-tests. Leaf rows (LF) show the actual validation logic.
 
 ---

package/alpha/table/rag-table-docs/status.md

@@ -3,11 +3,14 @@ action: status
 codeName: L1validations
 numTests: 26
 generated: 2026-03-10
+domain: -
+version: -
 ---
 
 # L1validations — `status` Validations (Table View)
 
 **22** leaf validation rule(s) applied to `status` in the **L1validations** flow.
+Domain: `-`, Version: `-`
 Group rows (GRP) list their immediate sub-tests. Leaf rows (LF) show the actual validation logic.
 
 ---

package/alpha/table/rag-table-docs/update.md

@@ -3,11 +3,14 @@ action: update
 codeName: L1validations
 numTests: 33
 generated: 2026-03-10
+domain: -
+version: -
 ---
 
 # L1validations — `update` Validations (Table View)
 
 **27** leaf validation rule(s) applied to `update` in the **L1validations** flow.
+Domain: `-`, Version: `-`
 Group rows (GRP) list their immediate sub-tests. Leaf rows (LF) show the actual validation logic.
 
 ---

package/dist/generator/config-compiler.d.ts

@@ -15,15 +15,29 @@ export declare class ConfigCompiler {
     errorDefinitions: ErrorDefinition[] | undefined;
     generatorConfig: CodeGeneratorConfig | undefined;
     language: SupportedLanguages;
+    domain?: string | string[];
+    version?: string;
     private SchemaExtractionService;
     constructor(language: SupportedLanguages);
     initialize: (buildYaml: string, generatorConfig?: Partial<CodeGeneratorConfig>) => Promise<void>;
     performValidations: (valConfig: ValidationConfig) => Promise<void>;
     withMinimalValidations: (valConfig: ValidationConfig) => Promise<void>;
-    generateCode: (valConfig: ValidationConfig, codeName?: string, minimal?: boolean, outputPath?: string, absolutePath?: boolean, goPackageName?: string) => Promise<void>;
+    generateCode: (valConfig: ValidationConfig, codeGenConfig?: CodeGenConfig | string) => Promise<void>;
     generateL0Schema: (outputPath?: string, type?: "json" | "typescript", absolutePath?: boolean) => Promise<void>;
     generateValidPaths: () => Promise<Record<string, string[]>>;
-    generateValidationFromBuild: (codeName: string, outputPath: string, absolutePath?: boolean, goPackageName?: string) => Promise<void>;
+    generateValidationFromBuild: (codeGenConfig: CodeGenConfig | string, outputPath?: string, absolutePath?: boolean, goPackageName?: string) => Promise<void>;
     extractPayloadsFromBuild: (outputPath: string) => Promise<void>;
 }
+export type CodeGenConfig = {
+    codeName: string;
+    goPkgName?: string;
+    domain?: string | string[];
+    version?: string;
+    /** Skip full path/enum validations and run minimal checks only. Default: false */
+    minimal?: boolean;
+    /** Base output directory. Default: "./" */
+    outputPath?: string;
+    /** Treat outputPath as absolute (skip prepending "generated/<codeName>"). Default: false */
+    absolutePath?: boolean;
+};
 export {};

package/dist/generator/config-compiler.js

@@ -34,9 +34,10 @@ export class ConfigCompiler {
                 this.SchemaExtractionService.extractPossiblePaths(this.jsonSchemas);
             const errors = this.buildData["x-errorcodes"];
             this.errorDefinitions = errors.code;
+            this.domain = this.buildData.info?.domain;
+            this.version = this.buildData.info?.version;
         };
         this.performValidations = async (valConfig) => {
-            // try {
             if (!this.buildData)
                 throw new Error("Build data not initialized");
             if (!this.jsonSchemas)
@@ -46,22 +47,19 @@ export class ConfigCompiler {
             if (!this.errorDefinitions)
                 throw new Error("Error definitions not initialized");
             await new ConfigValidator("", valConfig, this.possibleJsonPaths, this.errorDefinitions).validate();
-            // } catch (e) {
-            // 	logger.error(e);
-            // 	throw new Error(e as any);
-            // }
         };
         this.withMinimalValidations = async (valConfig) => {
-            // try {
             await new ConfigValidator("", valConfig, {}, [], {
                 minimal: true,
             }).validate();
-            // } catch (e) {
-            // logger.error(e);
-            // throw new Error("validation failed");
         };
-        // };
-        this.generateCode = async (valConfig, codeName = "L1-Validations", minimal = false, outputPath = "./", absolutePath = false, goPackageName = "validationpkg") => {
+        this.generateCode = async (valConfig, codeGenConfig = "L1-Validations") => {
+            // Accept either the new CodeGenConfig object or the legacy positional
+            // string (codeName) so existing call-sites continue to work.
+            const config = typeof codeGenConfig === "string"
+                ? { codeName: codeGenConfig }
+                : codeGenConfig;
+            const { codeName = "L1-Validations", goPkgName = "validationpkg", minimal = false, outputPath = "./", absolutePath = false, domain = this.domain, version = this.version, } = config;
             try {
                 console.log("[ CODE GENERATION ] Starting code generation...");
                 valConfig = JSON.parse(JSON.stringify(valConfig));
@@ -82,35 +80,51 @@ export class ConfigCompiler {
                     case SupportedLanguages.Typescript:
                         await new TypescriptGenerator(valConfig, this.errorDefinitions ?? [], targetPath).generateCode({
                             codeName: codeName,
+                            domain: domain,
+                            version: version,
                         });
                         break;
                     case SupportedLanguages.Python:
                         await new PythonGenerator(valConfig, this.errorDefinitions ?? [], targetPath).generateCode({
                             codeName: codeName,
+                            domain: domain,
+                            version: version,
                         });
                         break;
                     case SupportedLanguages.Javascript:
                         await new JavascriptGenerator(valConfig, this.errorDefinitions ?? [], targetPath).generateCode({
                             codeName: codeName,
+                            domain: domain,
+                            version: version,
                         });
                         break;
                     case SupportedLanguages.Golang:
                         await new GoGenerator(valConfig, this.errorDefinitions ?? [], targetPath).generateCode({
                             codeName: codeName,
-                            goPkgName: goPackageName,
+                            goPkgName: goPkgName,
+                            domain: domain,
+                            version: version,
                         });
                         break;
                     case SupportedLanguages.Markdown:
-                        await new MarkdownDocGenerator(valConfig, this.errorDefinitions ?? [], targetPath).generateCode();
+                        await new MarkdownDocGenerator(valConfig, this.errorDefinitions ?? [], targetPath).generateCode({
+                            codeName: codeName,
+                            domain: domain,
+                            version: version,
+                        });
                         break;
                     case SupportedLanguages.RAG:
                         await new RagGenerator(valConfig, this.errorDefinitions ?? [], targetPath).generateCode({
                             codeName: codeName,
+                            domain: domain,
+                            version: version,
                         });
                         break;
                     case SupportedLanguages.RAG_TABLE:
                         await new RagTableGenerator(valConfig, this.errorDefinitions ?? [], targetPath).generateCode({
                             codeName: codeName,
+                            domain: domain,
+                            version: version,
                         });
                         break;
                     default:
@@ -156,19 +170,31 @@ export class ConfigCompiler {
         this.generateValidPaths = async () => {
             if (!this.possibleJsonPaths)
                 throw new Error("Possible paths not initialized");
-            // writeFileSync(
-            // 	"./validPaths.json",
-            // 	JSON.stringify(this.possibleJsonPaths, null, 2)
-            // );
             return this.possibleJsonPaths;
         };
-        this.generateValidationFromBuild = async (codeName, outputPath, absolutePath = false, goPackageName = "validationpkg") => {
+        this.generateValidationFromBuild = async (codeGenConfig, outputPath, absolutePath, goPackageName) => {
             if (!this.buildData)
                 throw new Error("Build data not initialized");
             const valConfig = this.buildData["x-validations"];
             if (!valConfig)
                 throw new Error("No validation config found in build data");
-            await this.generateCode(valConfig, codeName, false, outputPath, absolutePath, goPackageName);
+            // Support legacy positional call: (codeName, outputPath, absolutePath, goPkgName)
+            const config = typeof codeGenConfig === "string"
+                ? {
+                    codeName: codeGenConfig,
+                    outputPath: outputPath ?? "./",
+                    absolutePath: absolutePath ?? false,
+                    goPkgName: goPackageName ?? "validationpkg",
+                    domain: this.buildData.info?.domain,
+                    version: this.buildData.info?.version,
+                }
+                : {
+                    ...codeGenConfig,
+                    domain: codeGenConfig.domain ?? this.buildData?.info?.domain,
+                    version: codeGenConfig.version ??
+                        this.buildData?.info?.version,
+                };
+            await this.generateCode(valConfig, config);
         };
         this.extractPayloadsFromBuild = async (outputPath) => {
             if (!this.buildData)

package/dist/generator/generators/classes/abstract-generator.d.ts

@@ -3,6 +3,8 @@ import { ErrorDefinition } from "../../../types/error-codes";
 export type CodeGeneratorProps = {
     codeName: string;
     goPkgName?: string;
+    domain?: string | string[];
+    version?: string;
 };
 export declare abstract class CodeGenerator {
     validationConfig: ValidationConfig;

package/dist/generator/generators/documentation/md-generator.d.ts

@@ -11,6 +11,7 @@ import { CodeGenerator, CodeGeneratorProps } from "../classes/abstract-generator
 export declare class MarkdownDocGenerator extends CodeGenerator {
     generateSessionDataCode(): Promise<void>;
     generateUnitTestingCode(): Promise<void>;
+    codeConfig: CodeGeneratorProps | undefined;
     generateValidationCode: () => Promise<void>;
-    generateCode: (_codeConfig?: CodeGeneratorProps) => Promise<void>;
+    generateCode: (codeConfig: CodeGeneratorProps) => Promise<void>;
 }

package/dist/generator/generators/documentation/md-generator.js

@@ -29,7 +29,7 @@ export class MarkdownDocGenerator extends CodeGenerator {
             let finalMarkdown = "";
             for (const action of Object.keys(testConfig)) {
                 const section = tableGen.buildActionMarkdown(action, action, // use action name as codeName heading inside the doc
-                testConfig[action]);
+                testConfig[action], this.codeConfig);
                 finalMarkdown += `\n\n${section}`;
             }
             finalMarkdown = finalMarkdown.trimStart();
@@ -41,7 +41,8 @@ export class MarkdownDocGenerator extends CodeGenerator {
             }));
             writeFileWithFsExtra(this.rootPath, "./page/style.css", cssData);
         };
-        this.generateCode = async (_codeConfig) => {
+        this.generateCode = async (codeConfig) => {
+            this.codeConfig = codeConfig; // store for use in generateValidationCode
             await this.generateValidationCode();
         };
     }

package/dist/generator/generators/go/go-generator.js

@@ -42,7 +42,7 @@ export class GoGenerator extends CodeGenerator {
             await writeAndFormatCode(this.rootPath, `./${this.codeConfig.goPkgName}/go.mod`, goModCode, "text");
             await this.generateSessionDataCode();
             await this.generateUnitTestingCode();
-            await new MarkdownDocGenerator(this.validationConfig, this.errorCodes, this.rootPath).generateCode();
+            await new MarkdownDocGenerator(this.validationConfig, this.errorCodes, this.rootPath).generateCode(codeConfig);
         };
         this.generateTestFunction = async (testObject) => {
             const template = readFileSync(path.resolve(__dirname, "./templates/test-object.mustache"), "utf-8");

package/dist/generator/generators/javascript/js-generator.js

@@ -45,7 +45,7 @@ export class JavascriptGenerator extends CodeGenerator {
                 await this.generatePackageJson(codeConfig.codeName);
                 // Step 6: Generate documentation
                 logger.debug("Step 6: Generating documentation");
-                await new MarkdownDocGenerator(this.validationConfig, this.errorCodes, this.rootPath).generateCode();
+                await new MarkdownDocGenerator(this.validationConfig, this.errorCodes, this.rootPath).generateCode(codeConfig);
                 // Step 7: Clean up temporary files
                 logger.debug("Step 7: Cleaning up temporary files");
                 await this.cleanup();

package/dist/generator/generators/python/py-generator.js

@@ -107,7 +107,7 @@ export class PythonGenerator extends CodeGenerator {
             await writeAndFormatCode(this.rootPath, "requirements.txt", requirements, "text");
             await writeAndFormatCode(this.rootPath, "error.py", this.generateErrorFile(this.errorCodes), "python");
             await writeAndFormatCode(this.rootPath, "__init__.py", this.generateIndexFile(apiNames, codeConfig.codeName), "python");
-            await new MarkdownDocGenerator(this.validationConfig, this.errorCodes, this.rootPath).generateCode();
+            await new MarkdownDocGenerator(this.validationConfig, this.errorCodes, this.rootPath).generateCode(codeConfig);
             await this.generateSessionDataCode();
         };
         this.generateTestFunction = async (testObject) => {

package/dist/generator/generators/rag/rag-table-generator.d.ts

@@ -26,7 +26,7 @@ export declare class RagTableGenerator extends CodeGenerator {
     generateCode: (codeConfig: CodeGeneratorProps) => Promise<void>;
     /** Collects rows and returns structured JSON for one action. */
     private buildActionJson;
-    buildActionMarkdown(action: string, codeName: string, testArray: TestObject[]): string;
+    buildActionMarkdown(action: string, codeName: string, testArray: TestObject[], codeConfig: CodeGeneratorProps): string;
     /**
      * Walks the test tree depth-first.
      *

package/dist/generator/generators/rag/rag-table-generator.js

@@ -33,7 +33,7 @@ export class RagTableGenerator extends CodeGenerator {
             const rawJson = {};
             for (const action of Object.keys(testConfig)) {
                 const testArray = testConfig[action];
-                const md = this.buildActionMarkdown(action, codeName, testArray);
+                const md = this.buildActionMarkdown(action, codeName, testArray, codeConfig);
                 writeFileWithFsExtra(this.rootPath, `./rag-table-docs/${action}.md`, md);
                 rawJson[action] = this.buildActionJson(action, codeName, testArray);
             }
@@ -62,18 +62,23 @@ export class RagTableGenerator extends CodeGenerator {
             rows: rows.map(({ index: _idx, ...rest }) => rest),
         };
     }
-    buildActionMarkdown(action, codeName, testArray) {
+    buildActionMarkdown(action, codeName, testArray, codeConfig) {
         const rows = [];
         this.collectRows(testArray, rows, "");
         // Re-index after collection so numbering is clean
         rows.forEach((r, i) => (r.index = i + 1));
         const dateStr = new Date().toISOString().split("T")[0];
+        const domainText = Array.isArray(codeConfig.domain)
+            ? codeConfig.domain.join(", ")
+            : (codeConfig.domain ?? "-");
         const frontmatter = [
             "---",
             `action: ${action}`,
             `codeName: ${codeName}`,
             `numTests: ${rows.length}`,
             `generated: ${dateStr}`,
+            `domain: ${domainText}`,
+            `version: ${codeConfig.version ?? "-"}`,
             "---",
         ].join("\n");
         const leafCount = rows.filter((r) => r.rowType === "leaf").length;
@@ -81,6 +86,7 @@ export class RagTableGenerator extends CodeGenerator {
             `# ${codeName} — \`${action}\` Validations (Table View)`,
             "",
             `**${leafCount}** leaf validation rule(s) applied to \`${action}\` in the **${codeName}** flow.`,
+            `Domain: \`${domainText}\`, Version: \`${codeConfig.version ?? "-"}\``,
             `Group rows (GRP) list their immediate sub-tests. Leaf rows (LF) show the actual validation logic.`,
             "",
             "---",

package/dist/generator/generators/typescript/ts-generator.js

@@ -100,7 +100,7 @@ export class TypescriptGenerator extends CodeGenerator {
             await this.generateValidationCode();
             await writeAndFormatCode(this.rootPath, "error.ts", this.generateErrorFile(this.errorCodes), "typescript");
             await writeAndFormatCode(this.rootPath, "index.ts", this.generateIndexFile(Object.keys(this.validationConfig[ConfigSyntax.Tests]), codeConfig.codeName), "typescript");
-            await new MarkdownDocGenerator(this.validationConfig, this.errorCodes, this.rootPath).generateCode();
+            await new MarkdownDocGenerator(this.validationConfig, this.errorCodes, this.rootPath).generateCode(codeConfig);
             await this.generateSessionDataCode();
         };
         this.generateTestFunction = async (testObject) => {

package/dist/index.test.js

@@ -14,15 +14,24 @@ const main = async () => {
     await compiler.initialize(buildYaml);
     const validPaths = await compiler.generateValidPaths();
     writeFileSync(path.resolve(__dirname, "../alpha/possible-json-paths.json"), JSON.stringify(validPaths, null, 2), "utf-8");
-    await compiler.generateCode(valConfig, "L1_validations", false, "./alpha/python/");
+    await compiler.generateCode(valConfig, {
+        codeName: "L1_validations",
+        outputPath: "./alpha/python/",
+    });
     const compilerTy = new ConfigCompiler(SupportedLanguages.Typescript);
     await compilerTy.initialize(buildYaml);
-    await compilerTy.generateCode(valConfig, "L1_validations", false, "./alpha/typescript/");
+    await compilerTy.generateCode(valConfig, {
+        codeName: "L1_validations",
+        outputPath: "./alpha/typescript/",
+    });
     await compilerTy.generateL0Schema("./alpha/typescript/L0_schema/");
     await compilerTy.generateL0Schema("./alpha/json/", "json");
     const compilerGo = new ConfigCompiler(SupportedLanguages.Golang);
     await compilerGo.initialize(buildYaml);
-    await compilerGo.generateCode(valConfig, "L1_validations", false, "./alpha/golang/");
+    await compilerGo.generateCode(valConfig, {
+        codeName: "L1_validations",
+        outputPath: "./alpha/golang/",
+    });
     // JavaScript generation example
     // const compilerJs = new ConfigCompiler(SupportedLanguages.Javascript);
     // await compilerJs.initialize(buildYaml);

package/dist/types/build.d.ts

@@ -41,6 +41,10 @@ export type BuildPath = {
 };
 export interface BUILD_TYPE {
     paths: BuildPath;
+    info: {
+        domain?: string | string[];
+        version?: string;
+    };
     "x-enum": any;
     "x-attributes": Xattributes;
     "x-errorcodes": {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ondc-code-generator",
-    "version": "0.9.0",
+    "version": "1.0.0",
     "description": "generate code from build.yaml ",
     "main": "dist/index.js",
     "type": "module",