@demoscript/cli 1.0.2 → 1.0.3

package/dist/lib/executor.js

@@ -0,0 +1,185 @@
+export async function executeRestStep(step, config, variables) {
+    // Parse method and endpoint
+    const [method, ...endpointParts] = step.rest.split(' ');
+    const endpoint = endpointParts.join(' ');
+    // Substitute variables in endpoint
+    const resolvedEndpoint = substituteVariables(endpoint, variables);
+    // Build full URL
+    const baseUrl = step.base_url || config.settings?.base_url || '';
+    const fullUrl = `${baseUrl}${resolvedEndpoint}`;
+    // Build headers
+    const headers = {
+        'Content-Type': 'application/json',
+        ...substituteInObject(step.headers || {}, variables),
+    };
+    // Build body from form defaults or body
+    let body = undefined;
+    if (method !== 'GET') {
+        if (step.form) {
+            body = Object.fromEntries(step.form.map((field) => {
+                const value = field.default ?? '';
+                const resolved = typeof value === 'string' ? substituteVariables(value, variables) : value;
+                return [field.name, resolved];
+            }));
+        }
+        else if (step.body) {
+            body = substituteInObject(step.body, variables);
+        }
+    }
+    // Execute request
+    const response = await fetch(fullUrl, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    const responseBody = await response.json().catch(() => null);
+    const result = {
+        request: {
+            method,
+            url: fullUrl,
+            headers,
+            body,
+        },
+        status: response.status,
+        body: responseBody,
+    };
+    // Save variables from initial response BEFORE polling
+    // This allows poll endpoint to reference saved variables like $jobId
+    // Supported special keywords: _status (HTTP status code)
+    if (step.save) {
+        for (const [varName, path] of Object.entries(step.save)) {
+            if (path === '_status') {
+                // Special keyword: capture HTTP status code (200, 404, etc.)
+                variables[varName] = response.status;
+            }
+            else if (responseBody) {
+                // JSON path extraction from response body
+                const value = getNestedValue(responseBody, path);
+                if (value !== undefined) {
+                    variables[varName] = value;
+                }
+            }
+        }
+    }
+    // Handle polling if configured
+    if (step.poll) {
+        const pollingResult = await executePoll(step.poll, baseUrl, headers, variables, config.settings?.polling);
+        result.pollingResult = pollingResult;
+        result.body = pollingResult.finalResponse;
+    }
+    return result;
+}
+async function executePoll(pollConfig, baseUrl, headers, variables, defaults) {
+    const interval = pollConfig.interval ?? defaults?.interval ?? 2000;
+    const maxAttempts = pollConfig.max_attempts ?? defaults?.max_attempts ?? 30;
+    const endpoint = substituteVariables(pollConfig.endpoint, variables);
+    // If endpoint is already an absolute URL, don't prepend baseUrl
+    const pollUrl = endpoint.startsWith('http://') || endpoint.startsWith('https://')
+        ? endpoint
+        : `${baseUrl}${endpoint}`;
+    let attempts = 0;
+    let lastResponse = null;
+    while (attempts < maxAttempts) {
+        attempts++;
+        const response = await fetch(pollUrl, {
+            method: 'GET',
+            headers,
+        });
+        lastResponse = await response.json().catch(() => null);
+        // Check success condition
+        if (evaluateCondition(pollConfig.success_when, lastResponse)) {
+            return { attempts, finalResponse: lastResponse };
+        }
+        // Check failure condition if specified
+        if (pollConfig.failure_when && evaluateCondition(pollConfig.failure_when, lastResponse)) {
+            throw new Error(`Polling failed: ${pollConfig.failure_when} matched after ${attempts} attempts`);
+        }
+        // Wait before next attempt
+        await sleep(interval);
+    }
+    throw new Error(`Polling timed out after ${maxAttempts} attempts`);
+}
+export function evaluateCondition(condition, response) {
+    // Parse conditions like "response.status == 'complete'" or "status == 'confirmed'"
+    // Support both with and without "response." prefix
+    let match = condition.match(/^response\.(.+?)\s*(==|!=)\s*(.+)$/);
+    if (!match) {
+        // Try without response. prefix
+        match = condition.match(/^(.+?)\s*(==|!=)\s*(.+)$/);
+    }
+    if (!match) {
+        console.warn(`Unable to parse condition: ${condition}`);
+        return false;
+    }
+    const [, path, operator, expectedRaw] = match;
+    const actualValue = getNestedValue(response, path);
+    // Parse expected value
+    let expectedValue;
+    if (expectedRaw === 'true') {
+        expectedValue = true;
+    }
+    else if (expectedRaw === 'false') {
+        expectedValue = false;
+    }
+    else if (expectedRaw === 'null') {
+        expectedValue = null;
+    }
+    else if (/^['"](.*)['"]$/.test(expectedRaw)) {
+        expectedValue = expectedRaw.slice(1, -1);
+    }
+    else if (!isNaN(Number(expectedRaw))) {
+        expectedValue = Number(expectedRaw);
+    }
+    else {
+        expectedValue = expectedRaw;
+    }
+    if (operator === '==') {
+        return actualValue === expectedValue;
+    }
+    else if (operator === '!=') {
+        return actualValue !== expectedValue;
+    }
+    return false;
+}
+export function getNestedValue(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        if (typeof current === 'object') {
+            current = current[part];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+function substituteVariables(str, variables) {
+    return str.replace(/\$([a-zA-Z_][a-zA-Z0-9_]*)/g, (_, name) => {
+        const value = variables[name];
+        return value !== undefined ? String(value) : `$${name}`;
+    });
+}
+function substituteInObject(obj, variables) {
+    if (typeof obj === 'string') {
+        return substituteVariables(obj, variables);
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => substituteInObject(item, variables));
+    }
+    if (obj && typeof obj === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            result[key] = substituteInObject(value, variables);
+        }
+        return result;
+    }
+    return obj;
+}
+//# sourceMappingURL=executor.js.map

package/dist/lib/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/lib/executor.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAc,EACd,MAAkB,EAClB,SAAkC;IAElC,4BAA4B;IAC5B,MAAM,CAAC,MAAM,EAAE,GAAG,aAAa,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEzC,mCAAmC;IACnC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAElE,iBAAiB;IACjB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE,QAAQ,IAAI,EAAE,CAAC;IACjE,MAAM,OAAO,GAAG,GAAG,OAAO,GAAG,gBAAgB,EAAE,CAAC;IAEhD,gBAAgB;IAChB,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;QAClC,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,SAAS,CAA2B;KAC/E,CAAC;IAEF,wCAAwC;IACxC,IAAI,IAAI,GAAY,SAAS,CAAC;IAC9B,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,GAAG,MAAM,CAAC,WAAW,CACvB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;gBACtB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;gBAClC,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;gBAC3F,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAChC,CAAC,CAAC,CACH,CAAC;QACJ,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACrB,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE;QACpC,MAAM;QACN,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KAC9C,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAE7D,MAAM,MAAM,GAAoB;QAC9B,OAAO,EAAE;YACP,MAAM;YACN,GAAG,EAAE,OAAO;YACZ,OAAO;YACP,IAAI;SACL;QACD,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,IAAI,EAAE,YAAY;KACnB,CAAC;IAEF,sDAAsD;IACtD,qEAAqE;IACrE,yDAAyD;IACzD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,6DAA6D;gBAC7D,SAAS,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;YACvC,CAAC;iBAAM,IAAI,YAAY,EAAE,CAAC;gBACxB,0CAA0C;gBAC1C,MAAM,KAAK,GAAG,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;gBACjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,SAAS,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,aAAa,GAAG,MAAM,WAAW,CACrC,IAAI,CAAC,IAAI,EACT,OAAO,EACP,OAAO,EACP,SAAS,EACT,MAAM,CAAC,QAAQ,EAAE,OAAO,CACzB,CAAC;QACF,MAAM,CAAC,aAAa,GAAG,aAAa,CAAC;QACrC,MAAM,CAAC,IAAI,GAAG,aAAa,CAAC,aAAa,CAAC;IAC5C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAYD,KAAK,UAAU,WAAW,CACxB,UAAsB,EACtB,OAAe,EACf,OAA+B,EAC/B,SAAkC,EAClC,QAA0B;IAE1B,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,QAAQ,EAAE,QAAQ,IAAI,IAAI,CAAC;IACnE,MAAM,WAAW,GAAG,UAAU,CAAC,YAAY,IAAI,QAAQ,EAAE,YAAY,IAAI,EAAE,CAAC;IAE5E,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACrE,gEAAgE;IAChE,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC;QAC/E,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,GAAG,OAAO,GAAG,QAAQ,EAAE,CAAC;IAE5B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,YAAY,GAAY,IAAI,CAAC;IAEjC,OAAO,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC9B,QAAQ,EAAE,CAAC;QAEX,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE;YACpC,MAAM,EAAE,KAAK;YACb,OAAO;SACR,CAAC,CAAC;QAEH,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAEvD,0BAA0B;QAC1B,IAAI,iBAAiB,CAAC,UAAU,CAAC,YAAY,EAAE,YAAY,CAAC,EAAE,CAAC;YAC7D,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;QACnD,CAAC;QAED,uCAAuC;QACvC,IAAI,UAAU,CAAC,YAAY,IAAI,iBAAiB,CAAC,UAAU,CAAC,YAAY,EAAE,YAAY,CAAC,EAAE,CAAC;YACxF,MAAM,IAAI,KAAK,CAAC,mBAAmB,UAAU,CAAC,YAAY,kBAAkB,QAAQ,WAAW,CAAC,CAAC;QACnG,CAAC;QAED,2BAA2B;QAC3B,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,2BAA2B,WAAW,WAAW,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,QAAiB;IACpE,mFAAmF;IACnF,mDAAmD;IACnD,IAAI,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAClE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,+BAA+B;QAC/B,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,8BAA8B,SAAS,EAAE,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC;IAC9C,MAAM,WAAW,GAAG,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAEnD,uBAAuB;IACvB,IAAI,aAAsB,CAAC;IAC3B,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;QAC3B,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;SAAM,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;QACnC,aAAa,GAAG,KAAK,CAAC;IACxB,CAAC;SAAM,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;QAClC,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;SAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9C,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;SAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QACvC,aAAa,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,WAAW,CAAC;IAC9B,CAAC;IAED,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,WAAW,KAAK,aAAa,CAAC;IACvC,CAAC;SAAM,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC7B,OAAO,WAAW,KAAK,aAAa,CAAC;IACvC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAY,EAAE,IAAY;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,OAAO,GAAY,GAAG,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9C,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAW,EAAE,SAAkC;IAC1E,OAAO,GAAG,CAAC,OAAO,CAAC,6BAA6B,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE;QAC5D,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAY,EAAE,SAAkC;IAC1E,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,mBAAmB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/lib/executor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=executor.test.d.ts.map

package/dist/lib/executor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.test.d.ts","sourceRoot":"","sources":["../../src/lib/executor.test.ts"],"names":[],"mappings":""}

package/dist/lib/executor.test.js

@@ -0,0 +1,62 @@
+import { describe, it, expect } from 'vitest';
+import { evaluateCondition, getNestedValue } from './executor.js';
+describe('evaluateCondition', () => {
+    it('evaluates string equality', () => {
+        const response = { status: 'complete' };
+        expect(evaluateCondition("response.status == 'complete'", response)).toBe(true);
+        expect(evaluateCondition("response.status == 'pending'", response)).toBe(false);
+    });
+    it('evaluates string inequality', () => {
+        const response = { status: 'pending' };
+        expect(evaluateCondition("response.status != 'complete'", response)).toBe(true);
+        expect(evaluateCondition("response.status != 'pending'", response)).toBe(false);
+    });
+    it('evaluates boolean values', () => {
+        const response = { ready: true, done: false };
+        expect(evaluateCondition('response.ready == true', response)).toBe(true);
+        expect(evaluateCondition('response.done == false', response)).toBe(true);
+        expect(evaluateCondition('response.ready == false', response)).toBe(false);
+    });
+    it('evaluates numeric values', () => {
+        const response = { count: 42, value: 0 };
+        expect(evaluateCondition('response.count == 42', response)).toBe(true);
+        expect(evaluateCondition('response.value == 0', response)).toBe(true);
+        expect(evaluateCondition('response.count == 43', response)).toBe(false);
+    });
+    it('evaluates nested paths', () => {
+        const response = { data: { job: { status: 'done' } } };
+        expect(evaluateCondition("response.data.job.status == 'done'", response)).toBe(true);
+    });
+    it('evaluates null values', () => {
+        const response = { error: null };
+        expect(evaluateCondition('response.error == null', response)).toBe(true);
+    });
+    it('returns false for invalid conditions', () => {
+        expect(evaluateCondition('invalid condition', {})).toBe(false);
+    });
+});
+describe('getNestedValue', () => {
+    it('extracts simple property', () => {
+        expect(getNestedValue({ name: 'test' }, 'name')).toBe('test');
+    });
+    it('extracts deeply nested property', () => {
+        const obj = { a: { b: { c: { d: 'value' } } } };
+        expect(getNestedValue(obj, 'a.b.c.d')).toBe('value');
+    });
+    it('returns undefined for missing path', () => {
+        expect(getNestedValue({ name: 'test' }, 'missing')).toBeUndefined();
+    });
+    it('handles null in path', () => {
+        const obj = { data: null };
+        expect(getNestedValue(obj, 'data.name')).toBeUndefined();
+    });
+    it('handles undefined in path', () => {
+        const obj = { data: undefined };
+        expect(getNestedValue(obj, 'data.name')).toBeUndefined();
+    });
+    it('extracts array element by index', () => {
+        const obj = { items: ['a', 'b', 'c'] };
+        expect(getNestedValue(obj, 'items.1')).toBe('b');
+    });
+});
+//# sourceMappingURL=executor.test.js.map

package/dist/lib/executor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.test.js","sourceRoot":"","sources":["../../src/lib/executor.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/loader.d.ts

@@ -0,0 +1,10 @@
+import type { DemoConfig, DemoRecordings } from '../types.js';
+import { type OpenApiSpec } from './openapi.js';
+interface LoadedDemo {
+    config: DemoConfig;
+    recordings: DemoRecordings | null;
+    openapiSpec: OpenApiSpec | null;
+}
+export declare function loadDemo(demoFile: string, skipValidation?: boolean): Promise<LoadedDemo>;
+export {};
+//# sourceMappingURL=loader.d.ts.map

package/dist/lib/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/lib/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAA8D,MAAM,aAAa,CAAC;AAG1H,OAAO,EAAyD,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAsCvG,UAAU,UAAU;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,cAAc,GAAG,IAAI,CAAC;IAClC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;CACjC;AAED,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,UAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CA+C5F"}

package/dist/lib/loader.js

@@ -0,0 +1,156 @@
+import { readFileSync, existsSync } from 'fs';
+import { dirname, join } from 'path';
+import yaml from 'js-yaml';
+import { isRestStep, isStepGroup } from '../types.js';
+import { validateDemoConfig, formatValidationErrors } from './validator.js';
+import { fetchOpenApiSpec, generateFormFields, mergeFormFields } from './openapi.js';
+/**
+ * Convert camelCase variable name to human-readable label
+ * e.g. "accessToken" -> "Access Token", "adminUserId" -> "Admin User Id"
+ */
+function formatSaveLabel(varName) {
+    return varName
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .replace(/^./, str => str.toUpperCase());
+}
+/**
+ * Infer result display type from variable name and json path
+ */
+function inferResultType(varName, jsonPath) {
+    const nameLower = varName.toLowerCase();
+    const pathLower = jsonPath.toLowerCase();
+    // Token/ID fields -> mono (monospace)
+    if (nameLower.includes('token') || nameLower.includes('id') ||
+        pathLower.includes('token') || pathLower.includes('id')) {
+        return 'mono';
+    }
+    // Address/wallet fields
+    if (nameLower.includes('address') || nameLower.includes('wallet')) {
+        return 'address';
+    }
+    // URL fields
+    if (nameLower.includes('url') || nameLower.includes('link')) {
+        return 'link';
+    }
+    return 'text';
+}
+export async function loadDemo(demoFile, skipValidation = false) {
+    if (!existsSync(demoFile)) {
+        throw new Error(`Demo file not found: ${demoFile}`);
+    }
+    const content = readFileSync(demoFile, 'utf-8');
+    const config = yaml.load(content);
+    // Validate against JSON Schema
+    if (!skipValidation) {
+        const result = validateDemoConfig(config);
+        if (!result.valid) {
+            throw new Error(formatValidationErrors(result.errors));
+        }
+    }
+    // Basic required fields check (fallback)
+    if (!config.title) {
+        throw new Error('Demo config missing required field: title');
+    }
+    if (!config.steps || !Array.isArray(config.steps)) {
+        throw new Error('Demo config missing required field: steps');
+    }
+    // Try to load recordings
+    const demoDir = dirname(demoFile);
+    const recordingsPath = join(demoDir, 'recordings.json');
+    let recordings = null;
+    if (existsSync(recordingsPath)) {
+        const recordingsContent = readFileSync(recordingsPath, 'utf-8');
+        recordings = JSON.parse(recordingsContent);
+    }
+    // Fetch OpenAPI spec if configured
+    const openapiUrl = config.settings?.openapi;
+    let openapiSpec = null;
+    if (openapiUrl) {
+        openapiSpec = await fetchOpenApiSpec(openapiUrl);
+        if (openapiSpec) {
+            // Process steps to generate forms from OpenAPI
+            config.steps = processStepsWithOpenApi(config.steps, openapiSpec, config.settings?.base_url);
+        }
+    }
+    return { config, recordings, openapiSpec };
+}
+/**
+ * Process steps to generate form fields from OpenAPI spec
+ */
+function processStepsWithOpenApi(steps, spec, baseUrl) {
+    return steps.map(item => {
+        if (isStepGroup(item)) {
+            return {
+                ...item,
+                steps: processStepsArray(item.steps, spec, baseUrl)
+            };
+        }
+        if (isRestStep(item)) {
+            return processRestStepWithOpenApi(item, spec, baseUrl);
+        }
+        return item;
+    });
+}
+/**
+ * Process a flat array of steps (inside a group)
+ */
+function processStepsArray(steps, spec, baseUrl) {
+    return steps.map(step => {
+        if (isRestStep(step)) {
+            return processRestStepWithOpenApi(step, spec, baseUrl);
+        }
+        return step;
+    });
+}
+/**
+ * Process a single REST step to generate form fields and result fields from OpenAPI
+ */
+function processRestStepWithOpenApi(step, spec, baseUrl) {
+    // Get method and path from step
+    let method;
+    let path;
+    if ('rest' in step) {
+        const parts = step.rest.trim().split(/\s+/);
+        if (parts.length === 1) {
+            method = 'GET';
+            path = parts[0];
+        }
+        else {
+            method = parts[0].toUpperCase();
+            path = parts.slice(1).join(' ');
+        }
+    }
+    else {
+        method = step.method;
+        path = step.path;
+    }
+    // Generate form fields from OpenAPI request body schema
+    const openapiFields = generateFormFields(spec, method, path);
+    // Generate result fields from save mappings (only if results not specified)
+    // This shows what variables were captured from the response
+    let results = step.results;
+    if (!results || results.length === 0) {
+        if (step.save && Object.keys(step.save).length > 0) {
+            // Generate results from save mappings
+            results = Object.entries(step.save).map(([varName, jsonPath]) => ({
+                key: jsonPath,
+                label: formatSaveLabel(varName),
+                type: inferResultType(varName, jsonPath)
+            }));
+        }
+    }
+    // If no OpenAPI data found, return step unchanged
+    if (openapiFields.length === 0 && !results) {
+        return step;
+    }
+    // Merge form fields with defaults and manual overrides
+    const mergedFields = openapiFields.length > 0
+        ? mergeFormFields(openapiFields, step.defaults, step.form)
+        : step.form;
+    return {
+        ...step,
+        form: mergedFields || step.form,
+        results: results || step.results
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/lib/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/lib/loader.ts"],"names":[],"mappings":"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"}

package/dist/lib/openapi.d.ts

@@ -0,0 +1,108 @@
+import type { FormField, ResultField } from '../types.js';
+export interface OpenApiSpec {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+    paths: Record<string, OpenApiPath>;
+    components?: {
+        schemas?: Record<string, JsonSchema>;
+    };
+}
+export interface OpenApiPath {
+    get?: OpenApiOperation;
+    post?: OpenApiOperation;
+    put?: OpenApiOperation;
+    delete?: OpenApiOperation;
+    patch?: OpenApiOperation;
+}
+export interface OpenApiOperation {
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    tags?: string[];
+    parameters?: OpenApiParameter[];
+    requestBody?: {
+        required?: boolean;
+        content: Record<string, {
+            schema: JsonSchema;
+        }>;
+    };
+    responses: Record<string, {
+        description: string;
+        content?: Record<string, {
+            schema: JsonSchema;
+        }>;
+    }>;
+}
+export interface OpenApiParameter {
+    name: string;
+    in: 'path' | 'query' | 'header';
+    required?: boolean;
+    schema?: JsonSchema;
+    description?: string;
+}
+export interface JsonSchema {
+    type?: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    default?: unknown;
+    description?: string;
+    enum?: unknown[];
+    items?: JsonSchema;
+    $ref?: string;
+    allOf?: JsonSchema[];
+    oneOf?: JsonSchema[];
+    anyOf?: JsonSchema[];
+    format?: string;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+}
+/**
+ * Fetch and cache an OpenAPI spec
+ */
+export declare function fetchOpenApiSpec(url: string): Promise<OpenApiSpec | null>;
+/**
+ * Clear the OpenAPI spec cache
+ */
+export declare function clearOpenApiCache(): void;
+/**
+ * Generate FormField[] from an OpenAPI operation's request body
+ */
+export declare function generateFormFields(spec: OpenApiSpec, method: string, path: string): FormField[];
+/**
+ * Merge OpenAPI-generated fields with manual defaults and overrides
+ *
+ * Priority (smart merge - each layer inherits from previous):
+ * 1. OpenAPI schema (base: type, required, options, description)
+ * 2. defaults: values (override default values only)
+ * 3. form: fields (partial override - only specified properties are changed)
+ *
+ * This allows YAML like:
+ *   defaults:
+ *     wallet: "0x..."
+ *   form:
+ *     - name: wallet
+ *       label: "From Wallet"  # Only override the label, inherit default from above
+ */
+export declare function mergeFormFields(openapiFields: FormField[], defaults?: Record<string, unknown>, manualFields?: FormField[]): FormField[];
+/**
+ * Get endpoint info from OpenAPI for display
+ */
+export declare function getEndpointInfo(spec: OpenApiSpec, method: string, path: string): {
+    summary?: string;
+    description?: string;
+} | null;
+/**
+ * Generate ResultField[] from an OpenAPI operation's response schema
+ *
+ * When a REST step doesn't specify `results:`, this function can auto-generate
+ * result fields from the OpenAPI response schema.
+ */
+export declare function generateResultFields(spec: OpenApiSpec, method: string, path: string): ResultField[];
+//# sourceMappingURL=openapi.d.ts.map

package/dist/lib/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/lib/openapi.ts"],"names":[],"mappings":"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"}