@ondc/automation-mock-runner 1.3.42 → 1.3.44

package/dist/lib/MockRunner.d.ts

@@ -1,4 +1,5 @@
 import { BaseCodeRunner } from "./runners/base-runner";
+import { RunnerOptions } from "./runners/runner-factory";
 import { MockPlaygroundConfigType } from "./types/mock-config";
 import { Logger } from "./utils/logger";
 import { ExecutionResult } from "./types/execution-results";
@@ -7,6 +8,14 @@ export declare class MockRunner {
     private static sharedRunner;
     logger: Logger;
     private static getSharedRunner;
+    /**
+     * Initialize (or replace) the process-wide shared runner with explicit
+     * options. Call this once at service boot — before constructing any
+     * MockRunner — to configure the fetch allowlist and worker pool settings.
+     *
+     * If a shared runner already exists it is terminated and replaced.
+     */
+    static initSharedRunner(options?: RunnerOptions): BaseCodeRunner;
     constructor(config: MockPlaygroundConfigType, skipValidation?: boolean);
     getRunnerInstance(): BaseCodeRunner;
     getConfig(): {
@@ -69,9 +78,9 @@ export declare class MockRunner {
         success: boolean;
         errors?: import("zod/v4/core").$ZodIssue[];
     };
-    runGeneratePayload(actionId: string, inputs?: any): Promise<ExecutionResult>;
+    runGeneratePayload(actionId: string, inputs?: any, extraSessionData?: Record<string, any>): Promise<ExecutionResult>;
     runGeneratePayloadWithSession(actionId: string, sessionData: any): Promise<ExecutionResult>;
-    runValidatePayload(actionId: string, targetPayload: any): Promise<ExecutionResult>;
+    runValidatePayload(actionId: string, targetPayload: any, extraSessionData?: Record<string, any>): Promise<ExecutionResult>;
     runValidatePayloadWithSession(actionId: string, targetPayload: any, sessionData: any): Promise<ExecutionResult>;
     runMeetRequirements(actionId: string): Promise<ExecutionResult>;
     runMeetRequirementsWithSession(actionId: string, sessionData: any): Promise<ExecutionResult>;
@@ -81,5 +90,6 @@ export declare class MockRunner {
     static runGetSave(payload: any, expression: string): Promise<ExecutionResult>;
     static encodeBase64(input: string): string;
     static decodeBase64(encoded: string): string;
+    private static resolveBaseActionId;
     private static getIdFromSession;
 }

package/dist/lib/MockRunner.js

@@ -18,6 +18,27 @@ class MockRunner {
         }
         return MockRunner.sharedRunner;
     }
+    /**
+     * Initialize (or replace) the process-wide shared runner with explicit
+     * options. Call this once at service boot — before constructing any
+     * MockRunner — to configure the fetch allowlist and worker pool settings.
+     *
+     * If a shared runner already exists it is terminated and replaced.
+     */
+    static initSharedRunner(options = {}) {
+        const logger = logger_1.Logger.getInstance();
+        if (MockRunner.sharedRunner) {
+            logger.warn("Replacing existing shared runner");
+            try {
+                MockRunner.sharedRunner.terminate();
+            }
+            catch (e) {
+                logger.error("Failed to terminate previous shared runner", {}, e);
+            }
+        }
+        MockRunner.sharedRunner = runner_factory_1.RunnerFactory.createRunner(options, logger);
+        return MockRunner.sharedRunner;
+    }
     constructor(config, skipValidation = false) {
         this.logger = logger_1.Logger.getInstance();
         if (!skipValidation) {
@@ -55,23 +76,27 @@ class MockRunner {
         const res = (0, validateConfig_1.validateConfigWithErrors)(this.config);
         return res;
     }
-    async runGeneratePayload(actionId, inputs = {}) {
+    async runGeneratePayload(actionId, inputs = {}, extraSessionData) {
         const executionId = this.logger.createExecutionContext(actionId);
         const startTime = Date.now();
         try {
+            const baseActionId = MockRunner.resolveBaseActionId(actionId);
             this.logger.logExecution(executionId, "Starting payload generation", {
                 actionId,
                 inputKeys: Object.keys(inputs),
             });
-            const step = this.config.steps.find((s) => s.action_id === actionId);
+            const step = this.config.steps.find((s) => s.action_id === baseActionId);
             if (!step) {
                 const availableActions = this.config.steps.map((s) => s.action_id);
                 throw new errors_1.ActionNotFoundError(actionId, availableActions);
             }
-            const index = this.config.steps.findIndex((s) => s.action_id === actionId);
+            const index = this.config.steps.findIndex((s) => s.action_id === baseActionId);
             // Deep clone to avoid mutations
             const defaultPayload = JSON.parse(JSON.stringify(step.mock.defaultPayload));
             const sessionData = await this.getSessionDataUpToStep(index);
+            if (extraSessionData) {
+                Object.assign(sessionData, extraSessionData);
+            }
             // Validate inputs against schema if provided
             if (step.mock.inputs?.jsonSchema && Object.keys(inputs).length > 0) {
                 // TODO: Add JSON schema validation for inputs
@@ -132,16 +157,17 @@ class MockRunner {
         const executionId = this.logger.createExecutionContext(actionId);
         const startTime = Date.now();
         try {
+            const baseActionId = MockRunner.resolveBaseActionId(actionId);
             this.logger.logExecution(executionId, "Starting payload generation with session data", {
                 actionId,
                 sessionKeys: Object.keys(sessionData),
             });
-            const step = this.config.steps.find((s) => s.action_id === actionId);
+            const step = this.config.steps.find((s) => s.action_id === baseActionId);
             if (!step) {
                 const availableActions = this.config.steps.map((s) => s.action_id);
                 throw new errors_1.ActionNotFoundError(actionId, availableActions);
             }
-            const index = this.config.steps.findIndex((s) => s.action_id === actionId);
+            const index = this.config.steps.findIndex((s) => s.action_id === baseActionId);
             // Deep clone to avoid mutations
             const defaultPayload = JSON.parse(JSON.stringify(step.mock.defaultPayload));
             const context = this.generateContext(step.action_id, step.api, sessionData);
@@ -189,15 +215,19 @@ class MockRunner {
             };
         }
     }
-    async runValidatePayload(actionId, targetPayload) {
+    async runValidatePayload(actionId, targetPayload, extraSessionData) {
         try {
-            const step = this.config.steps.find((s) => s.action_id === actionId);
+            const baseActionId = MockRunner.resolveBaseActionId(actionId);
+            const step = this.config.steps.find((s) => s.action_id === baseActionId);
             if (!step) {
                 throw new Error(`Action step with ID ${actionId} not found.`);
             }
-            const index = this.config.steps.findIndex((s) => s.action_id === actionId);
+            const index = this.config.steps.findIndex((s) => s.action_id === baseActionId);
             const schema = (0, function_registry_1.getFunctionSchema)("validate");
             const sessionData = await this.getSessionDataUpToStep(index);
+            if (extraSessionData) {
+                Object.assign(sessionData, extraSessionData);
+            }
             const result = await this.getRunnerInstance().execute(MockRunner.decodeBase64(step.mock.validate), schema, [targetPayload, sessionData]);
             return result;
         }
@@ -217,7 +247,8 @@ class MockRunner {
     }
     async runValidatePayloadWithSession(actionId, targetPayload, sessionData) {
         try {
-            const step = this.config.steps.find((s) => s.action_id === actionId);
+            const baseActionId = MockRunner.resolveBaseActionId(actionId);
+            const step = this.config.steps.find((s) => s.action_id === baseActionId);
             if (!step) {
                 throw new Error(`Action step with ID ${actionId} not found.`);
             }
@@ -241,11 +272,12 @@ class MockRunner {
     }
     async runMeetRequirements(actionId) {
         try {
-            const step = this.config.steps.find((s) => s.action_id === actionId);
+            const baseActionId = MockRunner.resolveBaseActionId(actionId);
+            const step = this.config.steps.find((s) => s.action_id === baseActionId);
             if (!step) {
                 throw new Error(`Action step with ID ${actionId} not found.`);
             }
-            const index = this.config.steps.findIndex((s) => s.action_id === actionId);
+            const index = this.config.steps.findIndex((s) => s.action_id === baseActionId);
             const schema = (0, function_registry_1.getFunctionSchema)("meetsRequirements");
             const sessionData = await this.getSessionDataUpToStep(index);
             const result = await this.getRunnerInstance().execute(MockRunner.decodeBase64(step.mock.requirements), schema, [sessionData]);
@@ -267,7 +299,8 @@ class MockRunner {
     }
     async runMeetRequirementsWithSession(actionId, sessionData) {
         try {
-            const step = this.config.steps.find((s) => s.action_id === actionId);
+            const baseActionId = MockRunner.resolveBaseActionId(actionId);
+            const step = this.config.steps.find((s) => s.action_id === baseActionId);
             if (!step) {
                 throw new Error(`Action step with ID ${actionId} not found.`);
             }
@@ -290,6 +323,7 @@ class MockRunner {
         }
     }
     getDefaultStep(api, actionId, formType) {
+        const baseActionId = MockRunner.resolveBaseActionId(actionId);
         if (formType === "dynamic_form" || formType === "html_form") {
             return {
                 api: api,
@@ -386,7 +420,10 @@ class MockRunner {
     }
     generateContext(actionId, action, sessionData) {
         // Find the step configuration for this action
-        const step = this.config.steps.find((s) => s.action_id === actionId);
+        // GENERATED#1#on_search_full_page_gcr
+        // get the last by splitting on # and taking the last part
+        const baseActionId = MockRunner.resolveBaseActionId(actionId);
+        const step = this.config.steps.find((s) => s.action_id === baseActionId);
         // Determine the message_id based on responseFor logic
         let messageId = (0, uuid_1.v4)();
         if (step?.responseFor) {
@@ -587,6 +624,9 @@ class MockRunner {
         const bytes = new Uint8Array([...binaryString].map((char) => char.charCodeAt(0)));
         return new TextDecoder().decode(bytes);
     }
+    static resolveBaseActionId(actionId) {
+        return actionId.split("#").slice(-1)[0];
+    }
     static getIdFromSession(sessionData, key) {
         if (sessionData === undefined) {
             return undefined;

package/dist/lib/configHelper.js

@@ -11,6 +11,7 @@ const MockRunner_1 = require("./MockRunner");
 const uuid_1 = require("uuid");
 const terser_1 = require("terser");
 const validateConfig_1 = require("./utils/validateConfig");
+const helpers_1 = require("./helpers");
 function createInitialMockConfig(domain, version, flowId) {
     return {
         meta: {
@@ -32,65 +33,9 @@ function createInitialMockConfig(domain, version, flowId) {
         steps: [],
         transaction_history: [],
         validationLib: "",
-        helperLib: MockRunner_1.MockRunner.encodeBase64(defaultHelpers),
+        helperLib: MockRunner_1.MockRunner.encodeBase64(helpers_1.DEFAULT_HELPER_LIB),
     };
 }
-const defaultHelpers = `/*
-	Custom helper functions available in all mock generation functions.
-	these are appended below the generate function for each step.
-*/
-
-const createFormURL = (domain,formId, sessionData) => {
-	const baseURL = sessionData.mockBaseUrl;
-	const transactionId = sessionData.transactionId[0];
-	const sessionId = sessionData.sessionId;
-	return \`\${baseURL}/forms/\${domain}/\${formId}/?transaction_id=\${transactionId}&session_id=\${sessionId}\`;
-}
-
-// Generates a UUID v4
-function uuidv4() {
-	return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
-	  const r = Math.random() * 16 | 0;
-	  const v = c === 'x' ? r : (r & 0x3 | 0x8);
-	  return v.toString(16);
-	});
-}
-
-// Generate a 6 digit string ID
-function generate6DigitId() {
-	return Math.floor(100000 + Math.random() * 900000).toString();
-}
-
-// Returns the current ISO timestamp
-function currentTimestamp() {
-	return new Date().toISOString();
-}
-
-// Converts ISO 8601 duration string to total seconds
-const isoDurToSec = (duration) => {
-  const durRE = /P((\d+)Y)?((\d+)M)?((\d+)W)?((\d+)D)?T?((\d+)H)?((\d+)M)?((\d+)S)?/;
-  const s = durRE.exec(duration);
-  if (!s) return 0;
-  
-  return (Number(s?.[2]) || 0) * 31536000 +
-	(Number(s?.[4]) || 0) * 2628288 +
-	(Number(s?.[6]) || 0) * 604800 +
-	(Number(s?.[8]) || 0) * 86400 +
-	(Number(s?.[10]) || 0) * 3600 +
-	(Number(s?.[12]) || 0) * 60 +
-	(Number(s?.[14]) || 0);
-};
-
-const setCityFromInputs = (payload, inputs) => {
-	if (!inputs) return "*";
-	let version = payload.context.version || payload.context.core_version || "2.0.0";
-	if (version.startsWith("1")) {
-		payload.context.city = inputs.city_code ?? "*";
-	} else {
-		payload.context.location.city.code = inputs.city_code ?? "*";
-	}
-}
-`;
 function convertToFlowConfig(config) {
     const flowConfig = {};
     flowConfig.id = config.meta.flowId;
@@ -172,13 +117,25 @@ function convertToFlowConfig(config) {
         if (step.mock.inputs !== undefined &&
             step.mock.inputs !== null &&
             Object.keys(step.mock.inputs).length > 0) {
-            flowStep.input = [
-                {
-                    name: step.mock.inputs.id,
-                    type: step.mock.inputs.id,
-                    schema: step.mock.inputs.jsonSchema,
-                },
-            ];
+            if (step.mock.inputs.id == "finvu_verification") {
+                flowStep.input = [
+                    {
+                        name: "finvu_verification",
+                        label: "Complete Account Aggregator Verification",
+                        type: "FINVU_REDIRECT",
+                        payloadField: "$.context.aa_consent_verified",
+                    },
+                ];
+            }
+            else {
+                flowStep.input = [
+                    {
+                        name: step.mock.inputs.id,
+                        type: step.mock.inputs.id,
+                        schema: step.mock.inputs.jsonSchema,
+                    },
+                ];
+            }
         }
         if (step.mock.inputs?.oldInputs) {
             flowStep.input = step.mock.inputs.oldInputs;

package/dist/lib/constants/function-registry.js

@@ -26,7 +26,7 @@ exports.FUNCTION_REGISTRY = {
             description: "The generated payload object to be sent in the API request",
         },
         description: "Generates the mock payload for an API call",
-        timeout: 35 * 1000,
+        timeout: 45 * 1000,
         defaultBody: `  return defaultPayload;`,
         template: (body) => `/**
  * Generates the mock payload for an API call in the transaction flow.

package/dist/lib/helpers/default-helpers.d.ts

@@ -0,0 +1,13 @@
+export function getSubscriberUrl(sessionData: any, type: any): any;
+export function uuidv4(): string;
+export function generate6DigitId(): string;
+export function currentTimestamp(): string;
+export function isoDurToSec(duration: any): number;
+export function setCityFromInputs(payload: any, inputs: any): "*" | undefined;
+export function createFormURL(domain: any, formId: any, sessionData: any): string;
+export function generateConsentHandler(sessionData: any, { custId, templateName, consentDescription, redirectUrl, }: {
+    custId: any;
+    templateName?: string | undefined;
+    consentDescription?: string | undefined;
+    redirectUrl?: string | undefined;
+}): Promise<any>;

package/dist/lib/helpers/default-helpers.js

@@ -0,0 +1,173 @@
+"use strict";
+/*
+ * Default helpers available to every `generate()` in a mock step.
+ *
+ * Authoring rules (enforced by how this file is consumed, not by tooling):
+ *   1. Use `function` declarations only. Arrow `const x = () => {}` stringifies
+ *      as an expression — it won't hoist or concat cleanly when each function
+ *      is `.toString()`-ed into the helper bundle.
+ *   2. No `require` / `import` inside function bodies. The VM sandbox has no
+ *      module system. Only sandbox-whitelisted globals (Math, Date, JSON, …)
+ *      and sibling helpers are in scope.
+ *   3. Cross-helper calls are fine — every function declaration lands in the
+ *      same flat script after assembly, and declarations hoist.
+ *   4. Put docs INSIDE the function body (first statement). Leading comments
+ *      above a declaration are dropped by `fn.toString()`, so they never
+ *      reach the assembled bundle.
+ *   5. If the helper needs request-scope data, take `sessionData` as an
+ *      explicit parameter. Free-variable references to `sessionData` do NOT
+ *      resolve at runtime — helpers are declared at script scope, `sessionData`
+ *      is only a parameter of `generate()`.
+ *
+ * The `module.exports = {...}` line at the bottom is only used by Node
+ * (index.ts and the Jest tests). `fn.toString()` never includes it, so it
+ * doesn't leak into the sandbox string.
+ */
+function getSubscriberUrl(sessionData, type) {
+    // Resolve the BPP or BAP subscriber URL from session data.
+    // Usage: getSubscriberUrl(sessionData, "bpp")
+    if (type === "bpp") {
+        return sessionData.bppUri;
+    }
+    else {
+        return sessionData.bapUri;
+    }
+}
+function uuidv4() {
+    // Generates a UUID v4 (RFC 4122, random-based).
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function (c) {
+        const r = (Math.random() * 16) | 0;
+        const v = c === "x" ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+function generate6DigitId() {
+    // Generate a 6-digit numeric string ID in [100000, 999999].
+    return Math.floor(100000 + Math.random() * 900000).toString();
+}
+function currentTimestamp() {
+    // Returns the current ISO-8601 UTC timestamp (e.g. "2026-04-23T12:34:56.789Z").
+    return new Date().toISOString();
+}
+function isoDurToSec(duration) {
+    /*
+     * Convert an ISO 8601 duration string (e.g. "PT1H30M", "P2DT3H") to total seconds.
+     * Returns 0 for unparseable input.
+     * Approximations used: 1 week = 7 days, 1 month ≈ 30.42 days (2628288 sec),
+     * 1 year = 365 days. Not calendar-exact.
+     */
+    const durRE = /P((\d+)Y)?((\d+)M)?((\d+)W)?((\d+)D)?T?((\d+)H)?((\d+)M)?((\d+)S)?/;
+    const s = durRE.exec(duration);
+    if (!s)
+        return 0;
+    return ((Number(s?.[2]) || 0) * 31536000 +
+        (Number(s?.[4]) || 0) * 2628288 +
+        (Number(s?.[6]) || 0) * 604800 +
+        (Number(s?.[8]) || 0) * 86400 +
+        (Number(s?.[10]) || 0) * 3600 +
+        (Number(s?.[12]) || 0) * 60 +
+        (Number(s?.[14]) || 0));
+}
+function setCityFromInputs(payload, inputs) {
+    /*
+     * Mutates `payload.context` in place to set the city code from `inputs.city_code`.
+     * Version-aware: ONDC v1.x uses flat `context.city`, v2.x uses nested
+     * `context.location.city.code`. Falls back to "*" when city_code is missing.
+     * No-op when `inputs` is falsy.
+     */
+    if (!inputs)
+        return "*";
+    const version = payload.context.version || payload.context.core_version || "2.0.0";
+    if (version.startsWith("1")) {
+        payload.context.city = inputs.city_code ?? "*";
+    }
+    else {
+        payload.context.location.city.code = inputs.city_code ?? "*";
+    }
+}
+function createFormURL(domain, formId, sessionData) {
+    /*
+     * Build a form submission URL from session data.
+     * Reads sessionData.mockBaseUrl, sessionData.transactionId[0], sessionData.sessionId.
+     * Returns: `${baseURL}/forms/${domain}/${formId}/?transaction_id=...&session_id=...`
+     */
+    const baseURL = sessionData.mockBaseUrl;
+    const transactionId = sessionData.transactionId[0];
+    const sessionId = sessionData.sessionId;
+    return `${baseURL}/forms/${domain}/${formId}/?transaction_id=${transactionId}&session_id=${sessionId}`;
+}
+async function generateConsentHandler(sessionData, { custId, templateName = "FINVUDEMO_TESTING", consentDescription = "Gold Loan Account Aggregator Consent", redirectUrl = "https://google.co.in", }) {
+    /*
+     * Generate a consent handler from the Finvu AA Service.
+     * Reads the service base URL from `sessionData.finvuUrl` — the installing
+     * service MUST include that origin in
+     *   MockRunner.initSharedRunner({ allowedFetchBaseUrls: [...] })
+     * otherwise the sandboxed fetch will be blocked.
+     *
+     * Times out after 10s via AbortController.
+     *
+     * @param {Object} sessionData             session data; sessionData.finvuUrl is required
+     * @param {Object} params
+     * @param {string} params.custId           customer ID (required)
+     * @param {string} [params.templateName]
+     * @param {string} [params.consentDescription]
+     * @param {string} [params.redirectUrl]
+     * @returns {Promise<string>} consentHandler
+     */
+    if (!custId) {
+        throw new Error("custId is required");
+    }
+    const baseUrl = sessionData && sessionData.finvuUrl;
+    if (!baseUrl) {
+        throw new Error("sessionData.finvuUrl is required");
+    }
+    const url = `${baseUrl}/finvu-aa/consent/generate`;
+    const payload = {
+        custId,
+        templateName,
+        consentDescription,
+        redirectUrl,
+    };
+    console.log("Calling Finvu AA Service:", url);
+    console.log("Consent request payload:", payload);
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 10000);
+    try {
+        const res = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(payload),
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Request failed: ${res.status} ${text}`);
+        }
+        const data = await res.json();
+        if (!data || !data.consentHandler) {
+            throw new Error("Invalid response: consentHandler missing");
+        }
+        return data.consentHandler;
+    }
+    catch (err) {
+        if (err && err.name === "AbortError") {
+            throw new Error("Request timed out after 10 seconds");
+        }
+        throw err;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+module.exports = {
+    getSubscriberUrl,
+    uuidv4,
+    generate6DigitId,
+    currentTimestamp,
+    isoDurToSec,
+    setCityFromInputs,
+    createFormURL,
+    generateConsentHandler,
+};

package/dist/lib/helpers/default-helpers.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Unit tests for the default helper functions + bundle integrity.
+ *
+ * Unit tests import the functions as a normal CJS module and call them.
+ * The bundle test loads DEFAULT_HELPER_LIB into a fresh vm context — this
+ * simulates how the string is actually used in the worker sandbox and
+ * catches any stringification / hoisting / free-variable regressions.
+ */
+export {};