ondc-code-generator 0.9.0 → 1.0.1

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/markdown-message-generator.js

@@ -13,7 +13,10 @@ export function markdownMessageGenerator(returnInput, variableValues, startingPo
     const ast = buildAstFromInput(returnInput);
     const returnTemplate = variableValues[TestObjectSyntax.Description]
         ? variableValues[TestObjectSyntax.Description]
-        : CompileToMarkdown(ast, /*topLevel*/ true, /*depth*/ 0, /*forNot*/ false);
+        : CompileToMarkdown(ast, 
+        /*topLevel*/ true, 
+        /*depth*/ 0, 
+        /*forNot*/ false);
     let finalReturn = `#### **${startingPointer}**\n\n` +
         Mustache.render(returnTemplate, ConvertArrayToStringsInTestObject(variableValues));
     if (skipInput && skipInput.length > 0) {

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-generator.d.ts

@@ -1,18 +1,23 @@
 import { CodeGenerator, CodeGeneratorProps } from "../classes/abstract-generator.js";
 /**
- * RagGenerator — produces one Markdown file per API action under ./rag-docs/.
+ * RagGenerator — produces one richly structured Markdown file per API action
+ * under `./rag-docs/`, designed for direct RAG pipeline ingestion.
  *
- * Each file is a self-contained, richly structured document intended to be
- * fed directly into a Retrieval-Augmented Generation (RAG) pipeline.
- *
- * Layout per file:
+ * Format:
+ *   ---
+ *   YAML frontmatter (action, codeName, numTests, generated, domain, version)
  *   ---
- *   YAML frontmatter (action, codeName, numTests, generated date)
+ *   # Heading + context paragraph
+ *
+ *   ## TOP_LEVEL_GROUP
+ *   Prose intro listing child names, scope, skip condition.
  *   ---
- *   # <codeName> — <action> Validations
- *   Short context paragraph
- *   Numbered list of every test with its human-readable description,
- *   error code, scope, and (indented) skip condition when present.
+ *   ### CHILD_GROUP
+ *   **LEAF_NAME**
+ *   `group: PATH | type: leaf | error_code: X`
+ *
+ *   - bullet description lines
+ *   - Skipped if ...
  */
 export declare class RagGenerator extends CodeGenerator {
     generateSessionDataCode(): Promise<void>;
@@ -20,29 +25,35 @@ export declare class RagGenerator extends CodeGenerator {
     generateValidationCode: () => Promise<void>;
     generateCode: (codeConfig: CodeGeneratorProps) => Promise<void>;
     private buildActionMarkdown;
-    /** Count only leaf (non-group) tests recursively. */
+    /** Counts leaf (non-group) tests recursively. */
     private countLeafTests;
+    /** Formats a list of names as English prose: "A, B, and C". */
+    private englishList;
     /**
-     * Renders a numbered top-level section (##) for a test object.
-     *
-     * - Leaf test  → full human-readable description + metadata badges
-     * - Group node → brief intro line + all children rendered as ### sub-sections
-     *                (recursing further for deeply nested groups)
-     *
-     * This preserves the parent→child relationship in the output so RAG
-     * consumers can see exactly which sub-validations belong to which group.
+     * Top-level `##` section.
+     * - Leaf  → `## NAME` + metadata line + body
+     * - Group → `## NAME` + prose intro + `---` + children
+     */
+    private buildTopLevelSection;
+    /**
+     * Renders a group section recursively.
+     * @param headingLevel  Markdown heading for this group node (e.g. "##")
+     * @param childLevel    Markdown heading for its direct children (e.g. "###")
+     * @param ancestorPath  Names of ancestor groups, used to build breadcrumbs
      */
-    private buildTestSection;
+    private renderGroupSection;
     /**
-     * Renders a child/nested section at the given heading level.
-     * Recurses deeper (####, #####, …) for nested groups.
+     * Renders a leaf node's full content block:
+     *   **NAME**
+     *   `group: PATH | type: leaf | error_code: X`
+     *
+     *   - bullet description lines
+     *   - Skipped if ...  (inline, from markdownMessageGenerator)
      */
-    private renderChildSection;
+    private renderLeafBody;
     /**
-     * Renders the skip block for a group node as a blockquote.
-     * Returns an empty string when there is no _CONTINUE_ on this node.
+     * Renders a group's skip condition as a blockquote paragraph.
+     * Uses markdownMessageGenerator to compile the JVAL expression.
      */
-    private renderSkipBlock;
-    /** Renders a leaf test's heading, metadata badges, and compiled description. */
-    private renderLeaf;
+    private renderSkipInlineBullet;
 }