npm - @tyndall/test-playwright - Versions diffs - 0.0.1 - Mend

@tyndall/test-playwright 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (77) hide show

package/README.md +30 -0
package/dist/app/AppInstance.d.ts +24 -0
package/dist/app/AppInstance.d.ts.map +1 -0
package/dist/app/AppInstance.js +30 -0
package/dist/app/AppLauncher.d.ts +32 -0
package/dist/app/AppLauncher.d.ts.map +1 -0
package/dist/app/AppLauncher.js +147 -0
package/dist/dynamic/ManifestObserver.d.ts +24 -0
package/dist/dynamic/ManifestObserver.d.ts.map +1 -0
package/dist/dynamic/ManifestObserver.js +71 -0
package/dist/errors.d.ts +17 -0
package/dist/errors.d.ts.map +1 -0
package/dist/errors.js +19 -0
package/dist/extensibility/EnvironmentScriptProvider.d.ts +21 -0
package/dist/extensibility/EnvironmentScriptProvider.d.ts.map +1 -0
package/dist/extensibility/EnvironmentScriptProvider.js +20 -0
package/dist/extensibility/ExpectRegistry.d.ts +11 -0
package/dist/extensibility/ExpectRegistry.d.ts.map +1 -0
package/dist/extensibility/ExpectRegistry.js +18 -0
package/dist/extensibility/StepRegistry.d.ts +14 -0
package/dist/extensibility/StepRegistry.d.ts.map +1 -0
package/dist/extensibility/StepRegistry.js +29 -0
package/dist/index.d.ts +21 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +15 -0
package/dist/reporter/ConsoleReporter.d.ts +6 -0
package/dist/reporter/ConsoleReporter.d.ts.map +1 -0
package/dist/reporter/ConsoleReporter.js +13 -0
package/dist/reporter/HtmlReporter.d.ts +11 -0
package/dist/reporter/HtmlReporter.d.ts.map +1 -0
package/dist/reporter/HtmlReporter.js +36 -0
package/dist/reporter/JsonReporter.d.ts +11 -0
package/dist/reporter/JsonReporter.d.ts.map +1 -0
package/dist/reporter/JsonReporter.js +12 -0
package/dist/reporter/Reporter.d.ts +5 -0
package/dist/reporter/Reporter.d.ts.map +1 -0
package/dist/reporter/Reporter.js +1 -0
package/dist/reporter/ResultCollector.d.ts +7 -0
package/dist/reporter/ResultCollector.d.ts.map +1 -0
package/dist/reporter/ResultCollector.js +26 -0
package/dist/runner/PlaywrightRunner.d.ts +38 -0
package/dist/runner/PlaywrightRunner.d.ts.map +1 -0
package/dist/runner/PlaywrightRunner.js +77 -0
package/dist/runner/StepExecutor.d.ts +16 -0
package/dist/runner/StepExecutor.d.ts.map +1 -0
package/dist/runner/StepExecutor.js +53 -0
package/dist/scenario/ScenarioLoader.d.ts +4 -0
package/dist/scenario/ScenarioLoader.d.ts.map +1 -0
package/dist/scenario/ScenarioLoader.js +23 -0
package/dist/scenario/ScenarioValidator.d.ts +15 -0
package/dist/scenario/ScenarioValidator.d.ts.map +1 -0
package/dist/scenario/ScenarioValidator.js +207 -0
package/dist/scenario/types.d.ts +2 -0
package/dist/scenario/types.d.ts.map +1 -0
package/dist/scenario/types.js +1 -0
package/dist/steps/click.d.ts +6 -0
package/dist/steps/click.d.ts.map +1 -0
package/dist/steps/click.js +3 -0
package/dist/steps/expect.d.ts +7 -0
package/dist/steps/expect.d.ts.map +1 -0
package/dist/steps/expect.js +71 -0
package/dist/steps/goto.d.ts +6 -0
package/dist/steps/goto.d.ts.map +1 -0
package/dist/steps/goto.js +6 -0
package/dist/steps/index.d.ts +16 -0
package/dist/steps/index.d.ts.map +1 -0
package/dist/steps/index.js +8 -0
package/dist/steps/types.d.ts +17 -0
package/dist/steps/types.d.ts.map +1 -0
package/dist/steps/types.js +1 -0
package/dist/types/result.d.ts +25 -0
package/dist/types/result.d.ts.map +1 -0
package/dist/types/result.js +1 -0
package/dist/types/scenario.d.ts +44 -0
package/dist/types/scenario.d.ts.map +1 -0
package/dist/types/scenario.js +1 -0
package/package.json +28 -0

package/dist/reporter/HtmlReporter.js ADDED Viewed

@@ -0,0 +1,36 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+export class HtmlReporter {
+    constructor(options = {}) {
+        this.outputPath = options.outputPath ?? "e2e-report.html";
+    }
+    async report(result) {
+        const resolvedPath = resolve(this.outputPath);
+        await mkdir(dirname(resolvedPath), { recursive: true });
+        const rows = result.scenarios
+            .map((scenario) => `<tr><td>${scenario.scenario.id}</td><td>${scenario.status}</td></tr>`)
+            .join("");
+        const html = `<!doctype html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <title>E2E Report</title>
+  <style>
+    body { font-family: Arial, sans-serif; padding: 16px; }
+    table { border-collapse: collapse; width: 100%; }
+    th, td { border: 1px solid #ddd; padding: 8px; }
+    th { background: #f4f4f4; text-align: left; }
+  </style>
+</head>
+<body>
+  <h1>${result.name}</h1>
+  <p>Status: ${result.status}</p>
+  <table>
+    <thead><tr><th>Scenario</th><th>Status</th></tr></thead>
+    <tbody>${rows}</tbody>
+  </table>
+</body>
+</html>`;
+        await writeFile(resolvedPath, html, "utf-8");
+    }
+}

package/dist/reporter/JsonReporter.d.ts ADDED Viewed

@@ -0,0 +1,11 @@
+import type { AggregatedResult } from "../types/result.js";
+import type { Reporter } from "./Reporter.js";
+export interface JsonReporterOptions {
+    outputPath?: string;
+}
+export declare class JsonReporter implements Reporter {
+    private readonly outputPath;
+    constructor(options?: JsonReporterOptions);
+    report(result: AggregatedResult): Promise<void>;
+}
+//# sourceMappingURL=JsonReporter.d.ts.map

package/dist/reporter/JsonReporter.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"JsonReporter.d.ts","sourceRoot":"","sources":["../../src/reporter/JsonReporter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,GAAE,mBAAwB;IAIvC,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAKtD"}

package/dist/reporter/JsonReporter.js ADDED Viewed

@@ -0,0 +1,12 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+export class JsonReporter {
+    constructor(options = {}) {
+        this.outputPath = options.outputPath ?? "e2e-report.json";
+    }
+    async report(result) {
+        const resolvedPath = resolve(this.outputPath);
+        await mkdir(dirname(resolvedPath), { recursive: true });
+        await writeFile(resolvedPath, JSON.stringify(result, null, 2), "utf-8");
+    }
+}

package/dist/reporter/Reporter.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+import type { AggregatedResult } from "../types/result.js";
+export interface Reporter {
+    report(result: AggregatedResult): Promise<void>;
+}
+//# sourceMappingURL=Reporter.d.ts.map

package/dist/reporter/Reporter.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"Reporter.d.ts","sourceRoot":"","sources":["../../src/reporter/Reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD"}

package/dist/reporter/Reporter.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/dist/reporter/ResultCollector.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+import type { AggregatedResult, ScenarioResult } from "../types/result.js";
+export declare class ResultCollector {
+    private readonly results;
+    add(result: ScenarioResult): void;
+    finalize(name: string): AggregatedResult;
+}
+//# sourceMappingURL=ResultCollector.d.ts.map

package/dist/reporter/ResultCollector.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"ResultCollector.d.ts","sourceRoot":"","sources":["../../src/reporter/ResultCollector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAc,MAAM,oBAAoB,CAAC;AAEvF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAEhD,GAAG,CAAC,MAAM,EAAE,cAAc;IAI1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;CAoBzC"}

package/dist/reporter/ResultCollector.js ADDED Viewed

@@ -0,0 +1,26 @@
+export class ResultCollector {
+    constructor() {
+        this.results = [];
+    }
+    add(result) {
+        this.results.push(result);
+    }
+    finalize(name) {
+        const status = this.results.some((result) => result.status === "failed")
+            ? "failed"
+            : "passed";
+        const startedAt = this.results.length
+            ? Math.min(...this.results.map((result) => result.startedAt))
+            : Date.now();
+        const finishedAt = this.results.length
+            ? Math.max(...this.results.map((result) => result.finishedAt))
+            : Date.now();
+        return {
+            name,
+            scenarios: [...this.results],
+            status,
+            startedAt,
+            finishedAt,
+        };
+    }
+}

package/dist/runner/PlaywrightRunner.d.ts ADDED Viewed

@@ -0,0 +1,38 @@
+import type { ScenarioCase } from "../types/scenario.js";
+import type { ScenarioResult } from "../types/result.js";
+import type { PageLike } from "../steps/types.js";
+import type { EnvironmentScriptProvider } from "../extensibility/EnvironmentScriptProvider.js";
+import type { StepRegistry } from "../extensibility/StepRegistry.js";
+import type { ExpectRegistry } from "../extensibility/ExpectRegistry.js";
+export interface PlaywrightLaunchOptions {
+    headless: boolean;
+}
+export interface BrowserLauncher {
+    launch(options: PlaywrightLaunchOptions): Promise<BrowserLike>;
+}
+export interface BrowserLike {
+    newPage(): Promise<PageLike>;
+    close(): Promise<void>;
+}
+export interface PlaywrightRunnerOptions {
+    headless?: boolean;
+    launcher?: BrowserLauncher;
+    environmentScriptPath?: string;
+    environmentScriptProvider?: EnvironmentScriptProvider;
+    stepRegistry?: StepRegistry;
+    expectRegistry?: ExpectRegistry;
+    abortOnFailure?: boolean;
+}
+export declare class PlaywrightRunner {
+    private readonly stepExecutor;
+    private readonly launcher;
+    private readonly headless;
+    private readonly environmentScriptPath?;
+    private readonly environmentScriptProvider?;
+    private readonly expectRegistry?;
+    constructor(options?: PlaywrightRunnerOptions);
+    runScenario(scenario: ScenarioCase, baseUrl: string): Promise<ScenarioResult>;
+    private resolveEnvironmentScript;
+    private injectEnvironmentScript;
+}
+//# sourceMappingURL=PlaywrightRunner.d.ts.map

package/dist/runner/PlaywrightRunner.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"PlaywrightRunner.d.ts","sourceRoot":"","sources":["../../src/runner/PlaywrightRunner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAe,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,KAAK,EAEV,yBAAyB,EAC1B,MAAM,+CAA+C,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAUD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IACtD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAA4B;IACvE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAiB;gBAErC,OAAO,GAAE,uBAA4B;IAY3C,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;YAmCrE,wBAAwB;YAUxB,uBAAuB;CAWtC"}

package/dist/runner/PlaywrightRunner.js ADDED Viewed

@@ -0,0 +1,77 @@
+import { StepExecutor } from "./StepExecutor.js";
+import { ManifestObserver } from "../dynamic/ManifestObserver.js";
+import { BrowserError } from "../errors.js";
+const defaultLauncher = {
+    async launch(options) {
+        const { chromium } = await import("playwright");
+        const browser = await chromium.launch({ headless: options.headless });
+        return browser;
+    },
+};
+export class PlaywrightRunner {
+    constructor(options = {}) {
+        this.stepExecutor = new StepExecutor({
+            registry: options.stepRegistry,
+            abortOnFailure: options.abortOnFailure,
+        });
+        this.launcher = options.launcher ?? defaultLauncher;
+        this.headless = options.headless ?? true;
+        this.environmentScriptPath = options.environmentScriptPath;
+        this.environmentScriptProvider = options.environmentScriptProvider;
+        this.expectRegistry = options.expectRegistry;
+    }
+    async runScenario(scenario, baseUrl) {
+        const startedAt = Date.now();
+        let browser;
+        try {
+            browser = await this.launcher.launch({ headless: this.headless });
+        }
+        catch (error) {
+            throw new BrowserError("Failed to launch browser", { cause: error });
+        }
+        try {
+            const page = await browser.newPage();
+            await this.injectEnvironmentScript(page);
+            const manifestObserver = new ManifestObserver();
+            manifestObserver.attach(page);
+            const context = {
+                page,
+                baseUrl,
+                manifestObserver,
+                expectRegistry: this.expectRegistry,
+            };
+            const steps = await this.stepExecutor.executeAll(scenario.steps, context);
+            const status = steps.some((step) => step.status === "failed") ? "failed" : "passed";
+            return {
+                scenario,
+                steps,
+                status,
+                startedAt,
+                finishedAt: Date.now(),
+            };
+        }
+        finally {
+            await browser.close();
+        }
+    }
+    async resolveEnvironmentScript() {
+        if (this.environmentScriptProvider) {
+            return this.environmentScriptProvider.getEnvironmentScript();
+        }
+        if (this.environmentScriptPath) {
+            return { path: this.environmentScriptPath };
+        }
+        return null;
+    }
+    async injectEnvironmentScript(page) {
+        const script = await this.resolveEnvironmentScript();
+        if (!script) {
+            return;
+        }
+        if (!page.addInitScript) {
+            throw new Error("Environment script injection requires addInitScript support on the page.");
+        }
+        // Inject before any navigation to simulate native webview bridges.
+        await page.addInitScript({ path: script.path });
+    }
+}

package/dist/runner/StepExecutor.d.ts ADDED Viewed

@@ -0,0 +1,16 @@
+import type { Step } from "../types/scenario.js";
+import type { StepResult } from "../types/result.js";
+import type { StepContext } from "../steps/index.js";
+import { type StepRegistry } from "../extensibility/StepRegistry.js";
+export interface StepExecutorOptions {
+    registry?: StepRegistry;
+    abortOnFailure?: boolean;
+}
+export declare class StepExecutor {
+    private readonly registry;
+    private readonly abortOnFailure;
+    constructor(options?: StepExecutorOptions);
+    execute(step: Step, context: StepContext): Promise<StepResult>;
+    executeAll(steps: Step[], context: StepContext): Promise<StepResult[]>;
+}
+//# sourceMappingURL=StepExecutor.d.ts.map

package/dist/runner/StepExecutor.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"StepExecutor.d.ts","sourceRoot":"","sources":["../../src/runner/StepExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,kCAAkC,CAAC;AAG1C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;gBAE7B,OAAO,GAAE,mBAAwB;IAKvC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAyB9D,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAqB7E"}

package/dist/runner/StepExecutor.js ADDED Viewed

@@ -0,0 +1,53 @@
+import { defaultStepRegistry, } from "../extensibility/StepRegistry.js";
+import { SchemaError } from "../errors.js";
+export class StepExecutor {
+    constructor(options = {}) {
+        this.registry = options.registry ?? defaultStepRegistry;
+        this.abortOnFailure = options.abortOnFailure ?? false;
+    }
+    async execute(step, context) {
+        const startedAt = Date.now();
+        try {
+            const stepType = Object.keys(step)[0];
+            const handler = this.registry.get(stepType);
+            if (!handler) {
+                throw new SchemaError(`Unknown step type: ${String(stepType)}`);
+            }
+            await handler(step, context);
+            return {
+                status: "passed",
+                startedAt,
+                finishedAt: Date.now(),
+            };
+        }
+        catch (error) {
+            return {
+                status: "failed",
+                startedAt,
+                finishedAt: Date.now(),
+                error: error instanceof Error ? error.message : String(error),
+                errorType: error instanceof Error ? error.name : undefined,
+            };
+        }
+    }
+    async executeAll(steps, context) {
+        const results = [];
+        for (let index = 0; index < steps.length; index += 1) {
+            const step = steps[index];
+            const result = await this.execute(step, context);
+            results.push(result);
+            if (result.status === "failed" && this.abortOnFailure) {
+                for (let remaining = index + 1; remaining < steps.length; remaining += 1) {
+                    const timestamp = Date.now();
+                    results.push({
+                        status: "skipped",
+                        startedAt: timestamp,
+                        finishedAt: timestamp,
+                    });
+                }
+                break;
+            }
+        }
+        return results;
+    }
+}

package/dist/scenario/ScenarioLoader.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+export declare class ScenarioLoader {
+    load(filePath: string): Promise<unknown>;
+}
+//# sourceMappingURL=ScenarioLoader.d.ts.map

package/dist/scenario/ScenarioLoader.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"ScenarioLoader.d.ts","sourceRoot":"","sources":["../../src/scenario/ScenarioLoader.ts"],"names":[],"mappings":"AAKA,qBAAa,cAAc;IACnB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAqB/C"}

package/dist/scenario/ScenarioLoader.js ADDED Viewed

@@ -0,0 +1,23 @@
+import { readFile } from "node:fs/promises";
+import { extname, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { parse as parseYaml } from "yaml";
+export class ScenarioLoader {
+    async load(filePath) {
+        const absolutePath = resolve(filePath);
+        const extension = extname(absolutePath).toLowerCase();
+        if (extension === ".yaml" || extension === ".yml") {
+            const raw = await readFile(absolutePath, "utf-8");
+            return parseYaml(raw);
+        }
+        if (extension === ".json") {
+            const raw = await readFile(absolutePath, "utf-8");
+            return JSON.parse(raw);
+        }
+        if (extension === ".ts" || extension === ".mts" || extension === ".cts" || extension === ".js") {
+            const module = await import(pathToFileURL(absolutePath).href);
+            return module.default ?? module;
+        }
+        throw new Error(`Unsupported scenario format: ${extension || "(no extension)"}`);
+    }
+}

package/dist/scenario/ScenarioValidator.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+import type { ScenarioDocument } from "../types/scenario.js";
+import { SchemaError } from "../errors.js";
+export declare class ScenarioValidationError extends SchemaError {
+    constructor(message: string);
+}
+export declare class ScenarioValidator {
+    validate(document: unknown): ScenarioDocument;
+    private validateScenario;
+    private validateStep;
+    private validateExpect;
+    private validateNetwork;
+    private validateDynamicManifest;
+    private stepPath;
+}
+//# sourceMappingURL=ScenarioValidator.d.ts.map

package/dist/scenario/ScenarioValidator.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"ScenarioValidator.d.ts","sourceRoot":"","sources":["../../src/scenario/ScenarioValidator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,gBAAgB,EAGjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAqC3C,qBAAa,uBAAwB,SAAQ,WAAW;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,gBAAgB;IAwD7C,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,YAAY;IAkCpB,OAAO,CAAC,cAAc;IA8DtB,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,uBAAuB;IAoB/B,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/scenario/ScenarioValidator.js ADDED Viewed

@@ -0,0 +1,207 @@
+import { SchemaError } from "../errors.js";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const ensureString = (value, path) => {
+    if (typeof value !== "string") {
+        throw new ScenarioValidationError(`Expected string at ${path}`);
+    }
+    return value;
+};
+const ensureBoolean = (value, path) => {
+    if (typeof value !== "boolean") {
+        throw new ScenarioValidationError(`Expected boolean at ${path}`);
+    }
+    return value;
+};
+const ensureNumber = (value, path) => {
+    if (typeof value !== "number" || Number.isNaN(value)) {
+        throw new ScenarioValidationError(`Expected number at ${path}`);
+    }
+    return value;
+};
+const ensureEnum = (value, allowed, path) => {
+    if (typeof value !== "string" || !allowed.includes(value)) {
+        throw new ScenarioValidationError(`Expected ${allowed.join(" | ")} at ${path}`);
+    }
+    return value;
+};
+export class ScenarioValidationError extends SchemaError {
+    constructor(message) {
+        super(message);
+        this.name = "ScenarioValidationError";
+    }
+}
+export class ScenarioValidator {
+    validate(document) {
+        if (!isRecord(document)) {
+            throw new ScenarioValidationError("Scenario document must be an object.");
+        }
+        const name = ensureString(document.name, "name");
+        const mode = "mode" in document
+            ? ensureEnum(document.mode, ["dev", "ssg", "ssr"], "mode")
+            : undefined;
+        const baseUrl = "baseUrl" in document ? ensureString(document.baseUrl, "baseUrl") : undefined;
+        let setup;
+        if ("setup" in document) {
+            if (!isRecord(document.setup)) {
+                throw new ScenarioValidationError("setup must be an object");
+            }
+            const setupRaw = document.setup;
+            const allowed = new Set(["env"]);
+            for (const key of Object.keys(setupRaw)) {
+                if (!allowed.has(key)) {
+                    throw new ScenarioValidationError(`Unknown setup key: ${key}`);
+                }
+            }
+            if ("env" in setupRaw) {
+                if (!isRecord(setupRaw.env)) {
+                    throw new ScenarioValidationError("setup.env must be an object");
+                }
+                const envEntries = {};
+                for (const [key, value] of Object.entries(setupRaw.env)) {
+                    envEntries[key] = ensureString(value, `setup.env.${key}`);
+                }
+                setup = { env: envEntries };
+            }
+        }
+        if (!Array.isArray(document.scenarios)) {
+            throw new ScenarioValidationError("scenarios must be an array");
+        }
+        if (document.scenarios.length === 0) {
+            throw new ScenarioValidationError("scenarios must contain at least one scenario");
+        }
+        const scenarios = document.scenarios.map((scenario, index) => this.validateScenario(scenario, index));
+        return {
+            name,
+            mode: mode,
+            baseUrl,
+            setup,
+            scenarios,
+        };
+    }
+    validateScenario(value, index) {
+        if (!isRecord(value)) {
+            throw new ScenarioValidationError(`Scenario at index ${index} must be an object`);
+        }
+        const id = ensureString(value.id, `scenarios[${index}].id`);
+        const name = "name" in value ? ensureString(value.name, `scenarios[${index}].name`) : undefined;
+        if (!Array.isArray(value.steps)) {
+            throw new ScenarioValidationError(`scenarios[${index}].steps must be an array`);
+        }
+        if (value.steps.length === 0) {
+            throw new ScenarioValidationError(`scenarios[${index}].steps must not be empty`);
+        }
+        const steps = value.steps.map((step, stepIndex) => this.validateStep(step, index, stepIndex));
+        return { id, name, steps };
+    }
+    validateStep(value, scenarioIndex, stepIndex) {
+        if (!isRecord(value)) {
+            throw new ScenarioValidationError(`scenarios[${scenarioIndex}].steps[${stepIndex}] must be an object`);
+        }
+        const keys = Object.keys(value);
+        if (keys.length !== 1) {
+            throw new ScenarioValidationError(`scenarios[${scenarioIndex}].steps[${stepIndex}] must have exactly one step type`);
+        }
+        if ("goto" in value) {
+            return { goto: ensureString(value.goto, this.stepPath(scenarioIndex, stepIndex, "goto")) };
+        }
+        if ("click" in value) {
+            return { click: ensureString(value.click, this.stepPath(scenarioIndex, stepIndex, "click")) };
+        }
+        if ("expect" in value) {
+            return {
+                expect: this.validateExpect(value.expect, this.stepPath(scenarioIndex, stepIndex, "expect")),
+            };
+        }
+        return value;
+    }
+    validateExpect(value, path) {
+        if (!isRecord(value)) {
+            throw new ScenarioValidationError(`${path} must be an object`);
+        }
+        const expectSpec = {};
+        const customExpectations = {};
+        const knownKeys = new Set([
+            "selector",
+            "text",
+            "contains",
+            "exists",
+            "network",
+            "dynamicManifest",
+            "custom",
+        ]);
+        for (const [key, entry] of Object.entries(value)) {
+            if (!knownKeys.has(key)) {
+                customExpectations[key] = entry;
+            }
+        }
+        if ("selector" in value) {
+            expectSpec.selector = ensureString(value.selector, `${path}.selector`);
+        }
+        if ("text" in value) {
+            expectSpec.text = ensureString(value.text, `${path}.text`);
+        }
+        if ("contains" in value) {
+            expectSpec.contains = ensureString(value.contains, `${path}.contains`);
+        }
+        if ("exists" in value) {
+            expectSpec.exists = ensureBoolean(value.exists, `${path}.exists`);
+        }
+        if ("network" in value) {
+            expectSpec.network = this.validateNetwork(value.network, `${path}.network`);
+        }
+        if ("dynamicManifest" in value) {
+            expectSpec.dynamicManifest = this.validateDynamicManifest(value.dynamicManifest, `${path}.dynamicManifest`);
+        }
+        if ("custom" in value) {
+            if (!isRecord(value.custom)) {
+                throw new ScenarioValidationError(`${path}.custom must be an object`);
+            }
+            Object.assign(customExpectations, value.custom);
+        }
+        if (Object.keys(customExpectations).length > 0) {
+            expectSpec.custom = customExpectations;
+        }
+        if (Object.keys(expectSpec).length === 0) {
+            throw new ScenarioValidationError(`${path} must define at least one expectation`);
+        }
+        return expectSpec;
+    }
+    validateNetwork(value, path) {
+        if (!isRecord(value)) {
+            throw new ScenarioValidationError(`${path} must be an object`);
+        }
+        const expectation = {};
+        if ("url" in value) {
+            expectation.url = ensureString(value.url, `${path}.url`);
+        }
+        if ("method" in value) {
+            expectation.method = ensureString(value.method, `${path}.method`);
+        }
+        if ("status" in value) {
+            expectation.status = ensureNumber(value.status, `${path}.status`);
+        }
+        if ("count" in value) {
+            expectation.count = ensureNumber(value.count, `${path}.count`);
+        }
+        return expectation;
+    }
+    validateDynamicManifest(value, path) {
+        if (!isRecord(value)) {
+            throw new ScenarioValidationError(`${path} must be an object`);
+        }
+        const expectation = {};
+        if ("mode" in value) {
+            expectation.mode = ensureEnum(value.mode, ["meta", "program"], `${path}.mode`);
+        }
+        if ("pageId" in value) {
+            expectation.pageId = ensureString(value.pageId, `${path}.pageId`);
+        }
+        if ("version" in value) {
+            expectation.version = ensureString(value.version, `${path}.version`);
+        }
+        return expectation;
+    }
+    stepPath(scenarioIndex, stepIndex, key) {
+        return `scenarios[${scenarioIndex}].steps[${stepIndex}].${key}`;
+    }
+}

package/dist/scenario/types.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export type { ScenarioMode, ScenarioSetup, ScenarioCase, ScenarioDocument, Step, ExpectSpec, DynamicManifestExpectation, NetworkExpectation, } from "../types/scenario.js";
2	+ //# sourceMappingURL=types.d.ts.map

package/dist/scenario/types.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/scenario/types.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,IAAI,EACJ,UAAU,EACV,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}

package/dist/scenario/types.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/dist/steps/click.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+import type { StepContext } from "./types.js";
+export interface ClickStep {
+    click: string;
+}
+export declare const runClickStep: (step: ClickStep, context: StepContext) => Promise<void>;
+//# sourceMappingURL=click.d.ts.map

package/dist/steps/click.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../src/steps/click.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,YAAY,GAAU,MAAM,SAAS,EAAE,SAAS,WAAW,kBAEvE,CAAC"}

package/dist/steps/click.js ADDED Viewed

@@ -0,0 +1,3 @@
+export const runClickStep = async (step, context) => {
+    await context.page.click(step.click);
+};

package/dist/steps/expect.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+import type { ExpectSpec } from "../types/scenario.js";
+import type { StepContext } from "./types.js";
+export interface ExpectStep {
+    expect: ExpectSpec;
+}
+export declare const runExpectStep: (step: ExpectStep, context: StepContext) => Promise<void>;
+//# sourceMappingURL=expect.d.ts.map

package/dist/steps/expect.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../../src/steps/expect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAC;CACpB;AAsDD,eAAO,MAAM,aAAa,GAAU,MAAM,UAAU,EAAE,SAAS,WAAW,kBA4BzE,CAAC"}