@flowspec-qa/runner-core 0.1.0

package/dist/api-client.d.ts

@@ -0,0 +1,50 @@
+import { AxiosRequestConfig } from 'axios';
+export declare const apiClient: {
+    get<T>(url: string, cfg?: AxiosRequestConfig): Promise<T>;
+    post<T>(url: string, data?: unknown, cfg?: AxiosRequestConfig): Promise<T>;
+    getStream(url: string): Promise<NodeJS.ReadableStream>;
+    getArrayBuffer(url: string): Promise<Buffer>;
+    /** Update base URL at runtime (e.g. pointing to a self-hosted instance) */
+    setBaseUrl(url: string): void;
+};
+export interface Project {
+    id: string;
+    name: string;
+    entity_count?: number;
+}
+export interface Suite {
+    entity_id: string;
+    entity_title: string;
+    suite_id: string;
+    framework: 'playwright' | 'cypress' | 'maestro';
+    mode?: string;
+    status?: string;
+    created_at?: string;
+}
+export declare const FlowSpecQAApi: {
+    listProjects(): Promise<Project[]>;
+    listSuites(entityId?: string): Promise<Suite[]>;
+    /** Download the ZIP of generated test files for a suite (suite_id = TestSuite.id) */
+    downloadSuiteZip(suiteId: string): Promise<Buffer>;
+    submitRunResult(payload: RunResultPayload): Promise<{
+        ok: boolean;
+        exec_id: string;
+    }>;
+};
+export interface RunResultPayload {
+    run_id: string;
+    entity_id: string;
+    framework: string;
+    env_label: string;
+    results: TestResultItem[];
+    started_at: string;
+    finished_at: string;
+    runner_version: string;
+}
+export interface TestResultItem {
+    name: string;
+    status: 'pass' | 'fail' | 'skip';
+    duration_ms: number;
+    error?: string | null;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAiB,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAmCjE,eAAO,MAAM,SAAS;QACV,CAAC,OAAO,MAAM,QAAQ,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;SAIpD,CAAC,OAAO,MAAM,SAAS,OAAO,QAAQ,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;mBAI3D,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;wBAIlC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKlD,2EAA2E;oBAC3D,MAAM,GAAG,IAAI;CAI9B,CAAC;AAIF,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,KAAK;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,aAAa;oBACF,OAAO,CAAC,OAAO,EAAE,CAAC;0BAIZ,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAQrD,qFAAqF;8BACrD,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;6BAIzB,gBAAgB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAG5F,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB"}

package/dist/api-client.js

@@ -0,0 +1,70 @@
+import axios from 'axios';
+import { config } from './config.js';
+// Lazy singleton — created on first use so baseUrl is read after config is loaded
+let _client = null;
+function getClient() {
+    if (!_client) {
+        _client = axios.create({
+            baseURL: config.get('baseUrl'),
+            timeout: 30_000,
+            headers: { 'Content-Type': 'application/json' },
+        });
+        // Attach Bearer token (API Key) to every request
+        _client.interceptors.request.use((req) => {
+            const apiKey = config.get('apiKey');
+            if (apiKey) {
+                req.headers['Authorization'] = `Bearer ${apiKey}`;
+            }
+            return req;
+        });
+        // Normalize error messages
+        _client.interceptors.response.use((res) => res, (err) => {
+            const msg = err.response?.data?.detail || err.response?.data?.message || err.message;
+            return Promise.reject(new Error(msg));
+        });
+    }
+    return _client;
+}
+export const apiClient = {
+    async get(url, cfg) {
+        const res = await getClient().get(url, cfg);
+        return res.data;
+    },
+    async post(url, data, cfg) {
+        const res = await getClient().post(url, data, cfg);
+        return res.data;
+    },
+    async getStream(url) {
+        const res = await getClient().get(url, { responseType: 'stream' });
+        return res.data;
+    },
+    async getArrayBuffer(url) {
+        const res = await getClient().get(url, { responseType: 'arraybuffer' });
+        return Buffer.from(res.data);
+    },
+    /** Update base URL at runtime (e.g. pointing to a self-hosted instance) */
+    setBaseUrl(url) {
+        config.set('baseUrl', url);
+        _client = null; // force recreation
+    },
+};
+export const FlowSpecQAApi = {
+    async listProjects() {
+        return apiClient.get('/api/config/projects');
+    },
+    async listSuites(entityId) {
+        const url = entityId
+            ? `/api/automation/suites?entity_id=${entityId}`
+            : '/api/automation/suites';
+        const resp = await apiClient.get(url);
+        return resp.suites ?? [];
+    },
+    /** Download the ZIP of generated test files for a suite (suite_id = TestSuite.id) */
+    async downloadSuiteZip(suiteId) {
+        return apiClient.getArrayBuffer(`/api/automation/download-suite/${suiteId}`);
+    },
+    async submitRunResult(payload) {
+        return apiClient.post('/api/automation/submit-run-result', payload);
+    },
+};
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/auth.d.ts

@@ -0,0 +1,17 @@
+export interface AuthStatus {
+    authenticated: boolean;
+    maskedKey?: string;
+}
+/**
+ * Store the API Key locally and test it against the SaaS.
+ * Keys use the format: sk-smrt-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+ */
+export declare function login(apiKey: string): Promise<void>;
+export declare function logout(): void;
+export declare function getAuthStatus(): AuthStatus;
+/**
+ * Return the API Key to use as Bearer token.
+ * The SaaS get_api_key_context dependency accepts: Authorization: Bearer sk-smrt-xxx
+ */
+export declare function getBearerToken(): string;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzD;AAED,wBAAgB,MAAM,IAAI,IAAI,CAE7B;AAED,wBAAgB,aAAa,IAAI,UAAU,CAO1C;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAMvC"}

package/dist/auth.js

@@ -0,0 +1,38 @@
+import { config } from './config.js';
+/**
+ * Store the API Key locally and test it against the SaaS.
+ * Keys use the format: sk-smrt-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+ */
+export async function login(apiKey) {
+    if (!apiKey.startsWith('sk-smrt-')) {
+        throw new Error('Invalid API Key format. Keys should start with "sk-smrt-"');
+    }
+    config.set('apiKey', apiKey);
+    // Validate immediately by making a test call
+    const { apiClient } = await import('./api-client.js');
+    await apiClient.get('/api/config/projects'); // throws if key is invalid
+}
+export function logout() {
+    config.set('apiKey', undefined);
+}
+export function getAuthStatus() {
+    const apiKey = config.get('apiKey');
+    if (!apiKey)
+        return { authenticated: false };
+    return {
+        authenticated: true,
+        maskedKey: apiKey.slice(0, 12) + '*'.repeat(Math.max(0, apiKey.length - 12)),
+    };
+}
+/**
+ * Return the API Key to use as Bearer token.
+ * The SaaS get_api_key_context dependency accepts: Authorization: Bearer sk-smrt-xxx
+ */
+export function getBearerToken() {
+    const apiKey = config.get('apiKey');
+    if (!apiKey) {
+        throw new Error('Not authenticated. Run: flowspecqa auth login');
+    }
+    return apiKey;
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAOrC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,MAAc;IACxC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7B,6CAA6C;IAC7C,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACtD,MAAM,SAAS,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC,2BAA2B;AAC1E,CAAC;AAED,MAAM,UAAU,MAAM;IACpB,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IAC7C,OAAO;QACL,aAAa,EAAE,IAAI;QACnB,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;KAC7E,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,16 @@
+export interface RunnerConfig {
+    apiKey?: string;
+    runnerToken?: string;
+    runnerTokenExpiry?: string;
+    baseUrl: string;
+    suiteCacheDir: string;
+    sanitizerPatterns: string[];
+}
+export declare const config: {
+    get<K extends keyof RunnerConfig>(key: K): RunnerConfig[K];
+    set<K extends keyof RunnerConfig>(key: K, value: RunnerConfig[K]): void;
+    getAll(): RunnerConfig;
+    clear(): void;
+    readonly configPath: string;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAoBD,eAAO,MAAM,MAAM;QACb,CAAC,SAAS,MAAM,YAAY,OAAO,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;QAItD,CAAC,SAAS,MAAM,YAAY,OAAO,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;cAI7D,YAAY;aAIb,IAAI;yBAIK,MAAM;CAGzB,CAAC"}

package/dist/config.js

@@ -0,0 +1,37 @@
+import Conf from 'conf';
+import path from 'path';
+import os from 'os';
+const DEFAULT_CONFIG = {
+    baseUrl: 'https://www.flowspecqa.com',
+    suiteCacheDir: path.join(os.homedir(), '.flowspecqa', 'suites'),
+    sanitizerPatterns: [
+        // Strip URLs, IPs, auth tokens from error messages before upload
+        'https?://[^\\s]+',
+        '\\b\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\b',
+        'Bearer\\s+[A-Za-z0-9.\\-_]+',
+        'Authorization:\\s*[^\\r\\n]+',
+        'password["\']?\\s*[:=]\\s*["\']?[^"\'\\s&]+',
+    ],
+};
+const conf = new Conf({
+    projectName: 'flowspecqa-runner',
+    defaults: DEFAULT_CONFIG,
+});
+export const config = {
+    get(key) {
+        return conf.get(key);
+    },
+    set(key, value) {
+        conf.set(key, value);
+    },
+    getAll() {
+        return conf.store;
+    },
+    clear() {
+        conf.clear();
+    },
+    get configPath() {
+        return conf.path;
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAWpB,MAAM,cAAc,GAAiB;IACnC,OAAO,EAAE,4BAA4B;IACrC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,QAAQ,CAAC;IAC/D,iBAAiB,EAAE;QACjB,iEAAiE;QACjE,kBAAkB;QAClB,iDAAiD;QACjD,6BAA6B;QAC7B,8BAA8B;QAC9B,6CAA6C;KAC9C;CACF,CAAC;AAEF,MAAM,IAAI,GAAG,IAAI,IAAI,CAAe;IAClC,WAAW,EAAE,mBAAmB;IAChC,QAAQ,EAAE,cAAc;CACzB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,CAA+B,GAAM;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAoB,CAAC;IAC1C,CAAC;IAED,GAAG,CAA+B,GAAM,EAAE,KAAsB;QAC9D,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAqB,CAAC;IACpC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF,CAAC"}

package/dist/executor.d.ts

@@ -0,0 +1,32 @@
+import type { TestResultItem } from './api-client.js';
+export interface ExecutionOptions {
+    env?: Record<string, string>;
+    timeout?: number;
+    workers?: number;
+    headed?: boolean;
+    reporter?: string;
+    grepPattern?: string;
+}
+export interface ExecutionResult {
+    exitCode: number;
+    results: TestResultItem[];
+    startedAt: Date;
+    finishedAt: Date;
+    stdout: string;
+    stderr: string;
+}
+/**
+ * Execute a Playwright test suite and parse the results.
+ */
+export declare function executePlaywright(suiteDir: string, options?: ExecutionOptions): Promise<ExecutionResult>;
+/**
+ * Execute a Cypress test suite.
+ */
+export declare function executeCypress(suiteDir: string, options?: ExecutionOptions): Promise<ExecutionResult>;
+/**
+ * Execute a Maestro test suite (iOS/Android YAML flows) and parse JUnit XML results.
+ * Requires: Maestro CLI installed globally (`curl -Ls 'https://get.maestro.mobile.dev' | bash`)
+ * No npm install step — Maestro uses its own runtime.
+ */
+export declare function executeMaestro(suiteDir: string, options?: ExecutionOptions): Promise<ExecutionResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,IAAI,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA2C1B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAkC1B;AA8DD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAqC1B"}

package/dist/executor.js

@@ -0,0 +1,221 @@
+import { execa } from 'execa';
+import path from 'path';
+import { existsSync } from 'fs';
+/**
+ * Execute a Playwright test suite and parse the results.
+ */
+export async function executePlaywright(suiteDir, options = {}) {
+    const startedAt = new Date();
+    // Install deps if node_modules missing
+    if (!isNodeModulesPresent(suiteDir)) {
+        await execa('npm', ['install', '--prefer-offline'], {
+            cwd: suiteDir,
+            env: { ...process.env, ...(options.env ?? {}) },
+        });
+    }
+    const args = ['playwright', 'test',
+        '--reporter=json',
+        ...(options.workers ? [`--workers=${options.workers}`] : []),
+        ...(options.headed ? ['--headed'] : []),
+        ...(options.grepPattern ? [`--grep`, options.grepPattern] : []),
+    ];
+    let stdout = '';
+    let stderr = '';
+    let exitCode = 0;
+    try {
+        const result = await execa('npx', args, {
+            cwd: suiteDir,
+            env: { ...process.env, ...(options.env ?? {}) },
+            timeout: options.timeout ?? 600_000,
+            reject: false, // don't throw on test failures
+        });
+        stdout = result.stdout;
+        stderr = result.stderr;
+        exitCode = result.exitCode ?? 1;
+    }
+    catch (err) {
+        const e = err;
+        stdout = e.stdout ?? '';
+        stderr = e.stderr ?? e.message;
+        exitCode = e.exitCode ?? 1;
+    }
+    const finishedAt = new Date();
+    const results = parsePlaywrightJson(stdout);
+    return { exitCode, results, startedAt, finishedAt, stdout, stderr };
+}
+/**
+ * Execute a Cypress test suite.
+ */
+export async function executeCypress(suiteDir, options = {}) {
+    const startedAt = new Date();
+    if (!isNodeModulesPresent(suiteDir)) {
+        await execa('npm', ['install', '--prefer-offline'], { cwd: suiteDir });
+    }
+    const args = ['cypress', 'run', '--reporter=json',
+        ...(options.headed ? ['--headed'] : ['--headless']),
+    ];
+    let stdout = '';
+    let stderr = '';
+    let exitCode = 0;
+    try {
+        const result = await execa('npx', args, {
+            cwd: suiteDir,
+            env: { ...process.env, ...(options.env ?? {}) },
+            timeout: options.timeout ?? 600_000,
+            reject: false,
+        });
+        stdout = result.stdout;
+        stderr = result.stderr;
+        exitCode = result.exitCode ?? 1;
+    }
+    catch (err) {
+        const e = err;
+        stdout = e.stdout ?? '';
+        stderr = e.stderr ?? e.message;
+        exitCode = e.exitCode ?? 1;
+    }
+    const finishedAt = new Date();
+    return { exitCode, results: parseCypressJson(stdout), startedAt, finishedAt, stdout, stderr };
+}
+// ─── Parsers ─────────────────────────────────────────────────────────────────
+function parsePlaywrightJson(stdout) {
+    try {
+        // Playwright --reporter=json outputs JSON on stdout
+        const json = extractJson(stdout);
+        if (!json)
+            return [];
+        const suites = json.suites ?? [];
+        const items = [];
+        collectPlaywrightSpecs(suites, items);
+        return items;
+    }
+    catch {
+        return [];
+    }
+}
+function collectPlaywrightSpecs(suites, items) {
+    for (const suite of suites) {
+        for (const spec of suite.specs ?? []) {
+            for (const test of spec.tests ?? []) {
+                const result = test.results?.[0];
+                items.push({
+                    name: spec.title,
+                    status: result?.status === 'passed' ? 'pass' : result?.status === 'skipped' ? 'skip' : 'fail',
+                    duration_ms: result?.duration ?? 0,
+                    error: result?.error?.message ?? null,
+                });
+            }
+        }
+        collectPlaywrightSpecs(suite.suites ?? [], items);
+    }
+}
+function parseCypressJson(stdout) {
+    try {
+        const json = extractJson(stdout);
+        if (!json)
+            return [];
+        return (json.results ?? []).flatMap((r) => (r.tests ?? []).map((t) => ({
+            name: t.fullTitle ?? t.title,
+            status: t.state === 'passed' ? 'pass' : t.state === 'pending' ? 'skip' : 'fail',
+            duration_ms: t.duration ?? 0,
+            error: t.err?.message ?? null,
+        })));
+    }
+    catch {
+        return [];
+    }
+}
+function extractJson(text) {
+    const match = text.match(/\{[\s\S]*\}/);
+    if (!match)
+        return null;
+    return JSON.parse(match[0]);
+}
+function isNodeModulesPresent(dir) {
+    return existsSync(path.join(dir, 'node_modules'));
+}
+/**
+ * Execute a Maestro test suite (iOS/Android YAML flows) and parse JUnit XML results.
+ * Requires: Maestro CLI installed globally (`curl -Ls 'https://get.maestro.mobile.dev' | bash`)
+ * No npm install step — Maestro uses its own runtime.
+ */
+export async function executeMaestro(suiteDir, options = {}) {
+    const startedAt = new Date();
+    const reportPath = path.join(suiteDir, 'report.xml');
+    const flowsDir = path.join(suiteDir, 'flows');
+    const args = [
+        'test',
+        '--format', 'junit',
+        '--output', reportPath,
+        existsSync(flowsDir) ? flowsDir : suiteDir,
+    ];
+    let stdout = '';
+    let stderr = '';
+    let exitCode = 0;
+    try {
+        const proc = await execa('maestro', args, {
+            cwd: suiteDir,
+            env: { ...process.env, ...(options.env ?? {}) },
+            reject: false,
+            timeout: options.timeout ?? 10 * 60 * 1000,
+        });
+        stdout = proc.stdout ?? '';
+        stderr = proc.stderr ?? '';
+        exitCode = proc.exitCode ?? 0;
+    }
+    catch (err) {
+        const execaErr = err;
+        stdout = execaErr.stdout ?? '';
+        stderr = execaErr.stderr ?? '';
+        exitCode = execaErr.exitCode ?? 1;
+    }
+    const finishedAt = new Date();
+    const results = parseMaestroXml(reportPath);
+    return { exitCode, results, startedAt, finishedAt, stdout, stderr };
+}
+/**
+ * Parse Maestro JUnit XML report into TestResultItem[].
+ * Format: <testsuite><testcase name="..." time="2.3"><failure message="..."/></testcase></testsuite>
+ */
+function parseMaestroXml(reportPath) {
+    if (!existsSync(reportPath))
+        return [];
+    try {
+        const { XMLParser } = require('fast-xml-parser');
+        const { readFileSync } = require('fs');
+        const xml = readFileSync(reportPath, 'utf-8');
+        const parser = new XMLParser({ ignoreAttributes: false, attributeNamePrefix: '@_' });
+        const doc = parser.parse(xml);
+        // Support both <testsuites> (wrapper) and bare <testsuite>
+        const suites = doc?.testsuites?.testsuite ?? doc?.testsuite;
+        const suiteArray = Array.isArray(suites) ? suites : suites ? [suites] : [];
+        const items = [];
+        for (const suite of suiteArray) {
+            const testcases = suite?.testcase;
+            const cases = Array.isArray(testcases) ? testcases : testcases ? [testcases] : [];
+            for (const tc of cases) {
+                const name = tc['@_name'] ?? tc['@_classname'] ?? 'unknown';
+                const timeStr = tc['@_time'] ?? '0';
+                const duration_ms = Math.round(parseFloat(timeStr) * 1000);
+                const hasFailure = tc.failure !== undefined;
+                const hasSkipped = tc.skipped !== undefined;
+                const failureMsg = typeof tc.failure === 'object'
+                    ? tc.failure['@_message'] ?? null
+                    : typeof tc.failure === 'string'
+                        ? tc.failure
+                        : null;
+                items.push({
+                    name,
+                    status: hasFailure ? 'fail' : hasSkipped ? 'skip' : 'pass',
+                    duration_ms,
+                    error: hasFailure ? failureMsg : null,
+                });
+            }
+        }
+        return items;
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { config, type RunnerConfig } from './config.js';
+export { login, logout, getAuthStatus, getBearerToken, type AuthStatus } from './auth.js';
+export { apiClient, FlowSpecQAApi, type Project, type Suite, type RunResultPayload, type TestResultItem } from './api-client.js';
+export { downloadSuite, listCachedSuites, evictSuite, type LocalSuite } from './suite-manager.js';
+export { executePlaywright, executeCypress, executeMaestro, type ExecutionOptions, type ExecutionResult } from './executor.js';
+export { sanitizeResults, assertNoSecrets } from './result-sanitizer.js';
+export { uploadResults, type UploadOptions } from './uploader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAC1F,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjI,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAC/H,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// @flowspec-qa/runner-core — public API
+export { config } from './config.js';
+export { login, logout, getAuthStatus, getBearerToken } from './auth.js';
+export { apiClient, FlowSpecQAApi } from './api-client.js';
+export { downloadSuite, listCachedSuites, evictSuite } from './suite-manager.js';
+export { executePlaywright, executeCypress, executeMaestro } from './executor.js';
+export { sanitizeResults, assertNoSecrets } from './result-sanitizer.js';
+export { uploadResults } from './uploader.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,MAAM,EAAqB,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAmB,MAAM,WAAW,CAAC;AAC1F,OAAO,EAAE,SAAS,EAAE,aAAa,EAAwE,MAAM,iBAAiB,CAAC;AACjI,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAmB,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAA+C,MAAM,eAAe,CAAC;AAC/H,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAsB,MAAM,eAAe,CAAC"}

package/dist/result-sanitizer.d.ts

@@ -0,0 +1,21 @@
+import type { TestResultItem } from './api-client.js';
+/**
+ * Sanitize test results before uploading to FlowSpecQA SaaS.
+ *
+ * Strips:
+ *  - HTTP/HTTPS URLs (base URLs of the client's environments)
+ *  - IP addresses
+ *  - Authorization / Bearer tokens
+ *  - Password patterns (key=value)
+ *  - Anything matching custom patterns in config
+ *
+ * The test name, status, and duration are NEVER modified.
+ * Only `error` messages are sanitized.
+ */
+export declare function sanitizeResults(results: TestResultItem[]): TestResultItem[];
+/**
+ * Validate that no obvious secrets leaked through (belt-and-suspenders check).
+ * Throws if any result still contains a pattern that looks like a secret.
+ */
+export declare function assertNoSecrets(results: TestResultItem[]): void;
+//# sourceMappingURL=result-sanitizer.d.ts.map

package/dist/result-sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-sanitizer.d.ts","sourceRoot":"","sources":["../src/result-sanitizer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAO3E;AAcD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI,CAkB/D"}

package/dist/result-sanitizer.js

@@ -0,0 +1,54 @@
+import { config } from './config.js';
+/**
+ * Sanitize test results before uploading to FlowSpecQA SaaS.
+ *
+ * Strips:
+ *  - HTTP/HTTPS URLs (base URLs of the client's environments)
+ *  - IP addresses
+ *  - Authorization / Bearer tokens
+ *  - Password patterns (key=value)
+ *  - Anything matching custom patterns in config
+ *
+ * The test name, status, and duration are NEVER modified.
+ * Only `error` messages are sanitized.
+ */
+export function sanitizeResults(results) {
+    const patterns = config.get('sanitizerPatterns').map((p) => new RegExp(p, 'gi'));
+    return results.map((r) => ({
+        ...r,
+        error: r.error ? sanitizeString(r.error, patterns) : null,
+    }));
+}
+function sanitizeString(text, patterns) {
+    let sanitized = text;
+    for (const pattern of patterns) {
+        sanitized = sanitized.replace(pattern, '[REDACTED]');
+    }
+    // Additional pass: truncate very long error messages to 1500 chars
+    if (sanitized.length > 1500) {
+        sanitized = sanitized.slice(0, 1500) + '... [truncated]';
+    }
+    return sanitized;
+}
+/**
+ * Validate that no obvious secrets leaked through (belt-and-suspenders check).
+ * Throws if any result still contains a pattern that looks like a secret.
+ */
+export function assertNoSecrets(results) {
+    const dangerPatterns = [
+        /https?:\/\/[a-z0-9.-]+\.(internal|local|corp|dev|staging|test)[/:]?/i,
+        /Bearer\s+[A-Za-z0-9.\-_]{20,}/,
+        /\bpassword\b/i,
+    ];
+    for (const r of results) {
+        if (!r.error)
+            continue;
+        for (const p of dangerPatterns) {
+            if (p.test(r.error)) {
+                throw new Error(`Security check failed: error message for test "${r.name}" may contain sensitive data. ` +
+                    `Run with --skip-security-check to bypass (not recommended).`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=result-sanitizer.js.map

package/dist/result-sanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-sanitizer.js","sourceRoot":"","sources":["../src/result-sanitizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAEjF,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,GAAG,CAAC;QACJ,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;KAC1D,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,QAAkB;IACtD,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACvD,CAAC;IACD,mEAAmE;IACnE,IAAI,SAAS,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;QAC5B,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,iBAAiB,CAAC;IAC3D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,cAAc,GAAG;QACrB,sEAAsE;QACtE,+BAA+B;QAC/B,eAAe;KAChB,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,CAAC,KAAK;YAAE,SAAS;QACvB,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;YAC/B,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CACb,kDAAkD,CAAC,CAAC,IAAI,gCAAgC;oBACxF,6DAA6D,CAC9D,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}