@fasttest-ai/qa-agent 0.1.3 → 0.3.0

package/dist/variables.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Environment variable substitution for test steps and assertions.
+ *
+ * Test steps can contain {{VAR_NAME}} placeholders that are resolved from
+ * process.env at execution time. This allows suites to be saved with
+ * placeholders for credentials, then executed in CI/CD where the actual
+ * values are set as GitHub Secrets or environment variables.
+ */
+import type { TestStep, TestAssertion } from "./cloud.js";
+/**
+ * Replace all {{VAR}} placeholders in a string with values from the environment.
+ * Throws if any referenced variable is missing, listing ALL missing names.
+ */
+export declare function resolveString(input: string, env?: Record<string, string | undefined>): string;
+/**
+ * Resolve {{VAR}} placeholders in a test step's value fields.
+ * Returns a new step object — does not mutate the original.
+ * Does NOT resolve selectors or descriptions.
+ */
+export declare function resolveStepVariables(step: TestStep, env?: Record<string, string | undefined>): TestStep;
+/**
+ * Resolve {{VAR}} placeholders in an assertion's value fields.
+ * Returns a new assertion object — does not mutate the original.
+ */
+export declare function resolveAssertionVariables(assertion: TestAssertion, env?: Record<string, string | undefined>): TestAssertion;
+/**
+ * Collect all unique {{VAR}} names referenced across steps and assertions.
+ * Used for pre-flight logging and CI YAML generation.
+ */
+export declare function collectVariableNames(steps: TestStep[], assertions: TestAssertion[]): string[];

package/dist/variables.js

@@ -0,0 +1,104 @@
+/**
+ * Environment variable substitution for test steps and assertions.
+ *
+ * Test steps can contain {{VAR_NAME}} placeholders that are resolved from
+ * process.env at execution time. This allows suites to be saved with
+ * placeholders for credentials, then executed in CI/CD where the actual
+ * values are set as GitHub Secrets or environment variables.
+ */
+/** Matches {{UPPER_SNAKE_CASE}} variable placeholders. */
+const VAR_PATTERN = /\{\{([A-Z][A-Z0-9_]*)\}\}/g;
+/**
+ * Replace all {{VAR}} placeholders in a string with values from the environment.
+ * Throws if any referenced variable is missing, listing ALL missing names.
+ */
+export function resolveString(input, env = process.env) {
+    const missing = [];
+    const resolved = input.replace(VAR_PATTERN, (match, varName) => {
+        const value = env[varName];
+        if (value === undefined) {
+            missing.push(varName);
+            return match;
+        }
+        return value;
+    });
+    if (missing.length > 0) {
+        throw new Error(`Missing environment variable(s): ${missing.join(", ")}. ` +
+            `Set these before running tests. In GitHub Actions, add them as repository secrets.`);
+    }
+    return resolved;
+}
+/**
+ * Resolve {{VAR}} placeholders in a test step's value fields.
+ * Returns a new step object — does not mutate the original.
+ * Does NOT resolve selectors or descriptions.
+ */
+export function resolveStepVariables(step, env) {
+    const resolved = { ...step };
+    if (resolved.value !== undefined)
+        resolved.value = resolveString(resolved.value, env);
+    if (resolved.url !== undefined)
+        resolved.url = resolveString(resolved.url, env);
+    if (resolved.expression !== undefined)
+        resolved.expression = resolveString(resolved.expression, env);
+    if (resolved.key !== undefined)
+        resolved.key = resolveString(resolved.key, env);
+    if (resolved.fields !== undefined) {
+        const resolvedFields = {};
+        for (const [selector, val] of Object.entries(resolved.fields)) {
+            resolvedFields[selector] = resolveString(val, env);
+        }
+        resolved.fields = resolvedFields;
+    }
+    return resolved;
+}
+/**
+ * Resolve {{VAR}} placeholders in an assertion's value fields.
+ * Returns a new assertion object — does not mutate the original.
+ */
+export function resolveAssertionVariables(assertion, env) {
+    const resolved = { ...assertion };
+    if (resolved.text !== undefined)
+        resolved.text = resolveString(resolved.text, env);
+    if (resolved.url !== undefined)
+        resolved.url = resolveString(resolved.url, env);
+    if (resolved.value !== undefined)
+        resolved.value = resolveString(resolved.value, env);
+    if (resolved.expected_value !== undefined)
+        resolved.expected_value = resolveString(resolved.expected_value, env);
+    return resolved;
+}
+/**
+ * Collect all unique {{VAR}} names referenced across steps and assertions.
+ * Used for pre-flight logging and CI YAML generation.
+ */
+export function collectVariableNames(steps, assertions) {
+    const vars = new Set();
+    function scan(input) {
+        if (!input)
+            return;
+        const re = /\{\{([A-Z][A-Z0-9_]*)\}\}/g;
+        let match;
+        while ((match = re.exec(input)) !== null) {
+            vars.add(match[1]);
+        }
+    }
+    for (const step of steps) {
+        scan(step.value);
+        scan(step.url);
+        scan(step.expression);
+        scan(step.key);
+        if (step.fields) {
+            for (const val of Object.values(step.fields))
+                scan(val);
+        }
+    }
+    for (const assertion of assertions) {
+        scan(assertion.text);
+        scan(assertion.url);
+        scan(assertion.value);
+        scan(assertion.expected_value);
+    }
+    return Array.from(vars).sort();
+}
+//# sourceMappingURL=variables.js.map

package/dist/variables.js.map

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

package/package.json

@@ -1,16 +1,20 @@
 {
   "name": "@fasttest-ai/qa-agent",
-  "version": "0.1.3",
-  "description": "QA Agent — AI testing engineer MCP server",
+  "version": "0.3.0",
+  "description": "FastTest Agent — AI testing engineer MCP server",
   "type": "module",
   "bin": {
-    "qa-agent": "bin/qa-agent.js"
+    "qa-agent": "bin/qa-agent.js",
+    "qa-agent-ci": "bin/qa-agent-ci.js",
+    "fasttest": "bin/qa-agent.js",
+    "fasttest-ci": "bin/qa-agent-ci.js"
   },
   "main": "./dist/index.js",
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "start": "node dist/index.js"
+    "start": "node dist/index.js",
+    "ci": "node dist/cli.js"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",