@futdevpro/dynamo-e2e 1.18.16 → 1.18.21

package/build/_modules/runtime/_collections/journey-context.util.d.ts

@@ -0,0 +1,72 @@
+import { DyE2E_JourneyCleanupReport_Interface, DyE2E_JourneyTestApi_Interface } from '../_models/journey-context.interface';
+/**
+ * BFR-FSMED-007 — typed user-journey context: carries the REAL ids / state a step created to the next step
+ * (state handoff), and owns a cleanup registry that removes everything the journey created, even when a step failed.
+ *
+ * - `step(name, fn)`: runs a step with the current state; the returned patch is merged into the state (handoff).
+ *   A failed step is recorded (`failedStep`) and rethrown — the journey stops, the cleanups still run.
+ * - `require(key)`: a handoff guard — a step that needs an earlier step's id fails with the step + key named,
+ *   instead of calling the API with `undefined`.
+ * - `registerCleanup(label, fn)`: register right AFTER the thing exists (create → register), so a later failure
+ *   cannot leak it. Cleanups run LIFO (dependants before their parents).
+ * - `runCleanup()`: runs EVERY cleanup, each isolated (one failure does not skip the rest), once (idempotent), then
+ *   throws if any failed — a leaked entity is a red journey, never a silent one.
+ *
+ * With Playwright: `DyE2E_useJourney(test, { name, initialState })` (serial mode + `afterAll` cleanup).
+ */
+export declare class DyE2E_JourneyContext<TState extends object> {
+    readonly name: string;
+    private currentState;
+    private readonly cleanups;
+    private readonly steps;
+    private failed;
+    private cleanupReport;
+    /** Creates the context with the journey name and its initial state. */
+    constructor(set: {
+        name: string;
+        initialState: TState;
+    });
+    /** The current state (a copy — change it through a step's returned patch or `handoff`). */
+    get state(): Readonly<TState>;
+    /** The names of the steps that completed, in order. */
+    get completedSteps(): string[];
+    /** The name of the step that threw, if any. */
+    get failedStep(): string | undefined;
+    /** Runs one journey step; its returned patch is merged into the state (the handoff to the next step). */
+    step(name: string, fn: (state: Readonly<TState>) => Promise<Partial<TState> | void> | Partial<TState> | void): Promise<Readonly<TState>>;
+    /** Merges a patch into the state outside a step (e.g. from a Playwright `test` body). */
+    handoff(patch: Partial<TState>): void;
+    /** Returns a state value an earlier step must have handed off; throws with the key named when it is missing. */
+    require<TKey extends keyof TState>(key: TKey): NonNullable<TState[TKey]>;
+    /** Registers a cleanup for something the journey created — call it right after the creation. */
+    registerCleanup(label: string, fn: () => Promise<unknown> | unknown): void;
+    /**
+     * Runs every registered cleanup LIFO, each isolated; idempotent (a second call returns the first report).
+     * Throws after ALL of them ran when any failed, naming the failed labels.
+     */
+    runCleanup(): Promise<DyE2E_JourneyCleanupReport_Interface>;
+}
+/**
+ * BFR-FSMED-007 — Playwright binding: puts the calling `describe` into serial mode (the steps share state) and
+ * registers `afterAll → runCleanup()`, so the cleanups run even when a step failed. Call it inside `test.describe`.
+ *
+ * ```ts
+ * test.describe('J-002 post lifecycle', () => {
+ *   const journey = DyE2E_useJourney(test, { name: 'J-002', initialState: { postId: undefined as string | undefined } });
+ *   test('create', async ({ request }) => {
+ *     const id = await createPost(request);
+ *     journey.registerCleanup(`delete post ${id}`, () => deletePostWithOwnClient(id));
+ *     journey.handoff({ postId: id });
+ *   });
+ *   test('read', async ({ request }) => { await readPost(request, journey.require('postId')); });
+ * });
+ * ```
+ *
+ * ⚠️ A cleanup runs in `afterAll`, AFTER the test-scoped fixtures (`page`, `request`) were disposed — it must not
+ * capture them: use its own client (`fetch`, or `playwright.request.newContext()` created inside the cleanup).
+ */
+export declare function DyE2E_useJourney<TState extends object>(test: DyE2E_JourneyTestApi_Interface, set: {
+    name: string;
+    initialState: TState;
+}): DyE2E_JourneyContext<TState>;
+//# sourceMappingURL=journey-context.util.d.ts.map

package/build/_modules/runtime/_collections/journey-context.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey-context.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/runtime/_collections/journey-context.util.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oCAAoC,EAEpC,8BAA8B,EAC/B,MAAM,sCAAsC,CAAC;AAQ9C;;;;;;;;;;;;;;GAcG;AACH,qBAAa,oBAAoB,CAAC,MAAM,SAAS,MAAM;IACrD,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6C;IACtE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAAmD;IAExE,uEAAuE;gBAC3D,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;IAKvD,2FAA2F;IAC3F,IAAW,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,CAEnC;IAED,uDAAuD;IACvD,IAAW,cAAc,IAAI,MAAM,EAAE,CAEpC;IAED,+CAA+C;IAC/C,IAAW,UAAU,IAAI,MAAM,GAAG,SAAS,CAE1C;IAED,yGAAyG;IAC5F,IAAI,CACf,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,GACxF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAsB5B,yFAAyF;IAClF,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI;IAI5C,gHAAgH;IACzG,OAAO,CAAC,IAAI,SAAS,MAAM,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAa/E,gGAAgG;IACzF,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI;IAOjF;;;OAGG;IACU,UAAU,IAAI,OAAO,CAAC,oCAAoC,CAAC;CA8BzE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,SAAS,MAAM,EACpD,IAAI,EAAE,8BAA8B,EACpC,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC1C,oBAAoB,CAAC,MAAM,CAAC,CAS9B"}

package/build/_modules/runtime/_collections/journey-context.util.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyE2E_JourneyContext = void 0;
+exports.DyE2E_useJourney = DyE2E_useJourney;
+/**
+ * BFR-FSMED-007 — typed user-journey context: carries the REAL ids / state a step created to the next step
+ * (state handoff), and owns a cleanup registry that removes everything the journey created, even when a step failed.
+ *
+ * - `step(name, fn)`: runs a step with the current state; the returned patch is merged into the state (handoff).
+ *   A failed step is recorded (`failedStep`) and rethrown — the journey stops, the cleanups still run.
+ * - `require(key)`: a handoff guard — a step that needs an earlier step's id fails with the step + key named,
+ *   instead of calling the API with `undefined`.
+ * - `registerCleanup(label, fn)`: register right AFTER the thing exists (create → register), so a later failure
+ *   cannot leak it. Cleanups run LIFO (dependants before their parents).
+ * - `runCleanup()`: runs EVERY cleanup, each isolated (one failure does not skip the rest), once (idempotent), then
+ *   throws if any failed — a leaked entity is a red journey, never a silent one.
+ *
+ * With Playwright: `DyE2E_useJourney(test, { name, initialState })` (serial mode + `afterAll` cleanup).
+ */
+class DyE2E_JourneyContext {
+    name;
+    currentState;
+    cleanups = [];
+    steps = [];
+    failed;
+    cleanupReport;
+    /** Creates the context with the journey name and its initial state. */
+    constructor(set) {
+        this.name = set.name;
+        this.currentState = { ...set.initialState };
+    }
+    /** The current state (a copy — change it through a step's returned patch or `handoff`). */
+    get state() {
+        return { ...this.currentState };
+    }
+    /** The names of the steps that completed, in order. */
+    get completedSteps() {
+        return [...this.steps];
+    }
+    /** The name of the step that threw, if any. */
+    get failedStep() {
+        return this.failed;
+    }
+    /** Runs one journey step; its returned patch is merged into the state (the handoff to the next step). */
+    async step(name, fn) {
+        if (this.failed) {
+            throw new Error(`[DyE2E journey "${this.name}"] step "${name}" not run: step "${this.failed}" already failed.`);
+        }
+        try {
+            const patch = await fn(this.state);
+            if (patch) {
+                this.currentState = { ...this.currentState, ...patch };
+            }
+            this.steps.push(name);
+        }
+        catch (err) {
+            this.failed = name;
+            throw err;
+        }
+        return this.state;
+    }
+    /** Merges a patch into the state outside a step (e.g. from a Playwright `test` body). */
+    handoff(patch) {
+        this.currentState = { ...this.currentState, ...patch };
+    }
+    /** Returns a state value an earlier step must have handed off; throws with the key named when it is missing. */
+    require(key) {
+        const value = this.currentState[key];
+        if (value === undefined || value === null) {
+            throw new Error(`[DyE2E journey "${this.name}"] state "${String(key)}" is missing — an earlier step did not hand it off ` +
+                `(completed: ${this.steps.join(' → ') || 'none'}).`);
+        }
+        return value;
+    }
+    /** Registers a cleanup for something the journey created — call it right after the creation. */
+    registerCleanup(label, fn) {
+        if (this.cleanupReport) {
+            throw new Error(`[DyE2E journey "${this.name}"] cleanup "${label}" registered after runCleanup().`);
+        }
+        this.cleanups.push({ label: label, fn: fn });
+    }
+    /**
+     * Runs every registered cleanup LIFO, each isolated; idempotent (a second call returns the first report).
+     * Throws after ALL of them ran when any failed, naming the failed labels.
+     */
+    async runCleanup() {
+        if (this.cleanupReport) {
+            return this.cleanupReport;
+        }
+        const results = [];
+        for (const entry of [...this.cleanups].reverse()) {
+            try {
+                await entry.fn();
+                results.push({ label: entry.label, ok: true });
+            }
+            catch (err) {
+                results.push({ label: entry.label, ok: false, error: err instanceof Error ? err.message : String(err) });
+            }
+        }
+        const failures = results.filter((result) => !result.ok);
+        this.cleanupReport = { journey: this.name, results: results, failed: failures.length };
+        if (failures.length) {
+            throw new Error(`[DyE2E journey "${this.name}"] ${failures.length}/${results.length} cleanup(s) failed — leaked: ` +
+                failures.map((f) => `${f.label} (${f.error})`).join('; '));
+        }
+        return this.cleanupReport;
+    }
+}
+exports.DyE2E_JourneyContext = DyE2E_JourneyContext;
+/**
+ * BFR-FSMED-007 — Playwright binding: puts the calling `describe` into serial mode (the steps share state) and
+ * registers `afterAll → runCleanup()`, so the cleanups run even when a step failed. Call it inside `test.describe`.
+ *
+ * ```ts
+ * test.describe('J-002 post lifecycle', () => {
+ *   const journey = DyE2E_useJourney(test, { name: 'J-002', initialState: { postId: undefined as string | undefined } });
+ *   test('create', async ({ request }) => {
+ *     const id = await createPost(request);
+ *     journey.registerCleanup(`delete post ${id}`, () => deletePostWithOwnClient(id));
+ *     journey.handoff({ postId: id });
+ *   });
+ *   test('read', async ({ request }) => { await readPost(request, journey.require('postId')); });
+ * });
+ * ```
+ *
+ * ⚠️ A cleanup runs in `afterAll`, AFTER the test-scoped fixtures (`page`, `request`) were disposed — it must not
+ * capture them: use its own client (`fetch`, or `playwright.request.newContext()` created inside the cleanup).
+ */
+function DyE2E_useJourney(test, set) {
+    const journey = new DyE2E_JourneyContext(set);
+    test.describe.configure({ mode: 'serial' });
+    test.afterAll(async () => {
+        await journey.runCleanup();
+    });
+    return journey;
+}
+//# sourceMappingURL=journey-context.util.js.map

package/build/_modules/runtime/_collections/journey-context.util.js.map

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

package/build/_modules/runtime/_models/journey-context.interface.d.ts

@@ -0,0 +1,31 @@
+/** BFR-FSMED-007 — the outcome of one registered cleanup in `DyE2E_JourneyContext.runCleanup()`. */
+export interface DyE2E_JourneyCleanupResult_Interface {
+    /** The label given at registration (what was cleaned up — e.g. `hard-delete account 64f…`). */
+    label: string;
+    /** `true` when the cleanup resolved. */
+    ok: boolean;
+    /** The failure message when `ok` is `false`. */
+    error?: string;
+}
+/** BFR-FSMED-007 — what `DyE2E_JourneyContext.runCleanup()` did: every cleanup, in the order it ran (LIFO). */
+export interface DyE2E_JourneyCleanupReport_Interface {
+    /** The journey name. */
+    journey: string;
+    /** One row per registered cleanup, in run order (last registered first). */
+    results: DyE2E_JourneyCleanupResult_Interface[];
+    /** The number of failed cleanups (`0` = everything the journey created is gone). */
+    failed: number;
+}
+/**
+ * BFR-FSMED-007 — the minimal Playwright `test` surface `DyE2E_useJourney` needs (structural, so a unit test can pass a
+ * double and the runtime needs no specific Playwright version).
+ */
+export interface DyE2E_JourneyTestApi_Interface {
+    describe: {
+        configure: (options: {
+            mode: 'serial';
+        }) => void;
+    };
+    afterAll: (fn: () => Promise<void>) => void;
+}
+//# sourceMappingURL=journey-context.interface.d.ts.map

package/build/_modules/runtime/_models/journey-context.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey-context.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/runtime/_models/journey-context.interface.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,MAAM,WAAW,oCAAoC;IACnD,+FAA+F;IAC/F,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,EAAE,EAAE,OAAO,CAAC;IACZ,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,+GAA+G;AAC/G,MAAM,WAAW,oCAAoC;IACnD,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,OAAO,EAAE,oCAAoC,EAAE,CAAC;IAChD,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE;QAAE,SAAS,EAAE,CAAC,OAAO,EAAE;YAAE,IAAI,EAAE,QAAQ,CAAA;SAAE,KAAK,IAAI,CAAA;KAAE,CAAC;IAC/D,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;CAC7C"}

package/build/_modules/runtime/_models/journey-context.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=journey-context.interface.js.map

package/build/_modules/runtime/_models/journey-context.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey-context.interface.js","sourceRoot":"","sources":["../../../../src/_modules/runtime/_models/journey-context.interface.ts"],"names":[],"mappings":""}

package/build/_modules/runtime/index.d.ts

@@ -13,12 +13,14 @@
  * ```
  */
 export * from './_collections/assertion-helpers.util';
+export * from './_collections/journey-context.util';
 export * from './_collections/notification-detector-page-script.const';
 export * from './_collections/notification-detector.util';
 export * from './_collections/notification-sweep.util';
 export * from './_collections/unique-generator.util';
 export * from './_collections/wait-helpers.util';
 export * from './_models/index';
+export * from './_models/journey-context.interface';
 export * from './_models/notification-report.interface';
 export * from './_models/notification-sweep.interface';
 export * from './_models/test-user.interface';

package/build/_modules/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,cAAc,uCAAuC,CAAC;AACtD,cAAc,wDAAwD,CAAC;AACvE,cAAc,2CAA2C,CAAC;AAC1D,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iBAAiB,CAAC;AAChC,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,YAAY,CAAC;AAE3B,eAAO,MAAM,qBAAqB,EAAE,MAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wDAAwD,CAAC;AACvE,cAAc,2CAA2C,CAAC;AAC1D,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iBAAiB,CAAC;AAChC,cAAc,qCAAqC,CAAC;AACpD,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,YAAY,CAAC;AAE3B,eAAO,MAAM,qBAAqB,EAAE,MAAwB,CAAC"}

package/build/_modules/runtime/index.js

@@ -30,12 +30,14 @@ exports.DYE2E_RUNTIME_VERSION = void 0;
  * ```
  */
 __exportStar(require("./_collections/assertion-helpers.util"), exports);
+__exportStar(require("./_collections/journey-context.util"), exports);
 __exportStar(require("./_collections/notification-detector-page-script.const"), exports);
 __exportStar(require("./_collections/notification-detector.util"), exports);
 __exportStar(require("./_collections/notification-sweep.util"), exports);
 __exportStar(require("./_collections/unique-generator.util"), exports);
 __exportStar(require("./_collections/wait-helpers.util"), exports);
 __exportStar(require("./_models/index"), exports);
+__exportStar(require("./_models/journey-context.interface"), exports);
 __exportStar(require("./_models/notification-report.interface"), exports);
 __exportStar(require("./_models/notification-sweep.interface"), exports);
 __exportStar(require("./_models/test-user.interface"), exports);

package/build/_modules/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/runtime/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;GAaG;AACH,wEAAsD;AACtD,yFAAuE;AACvE,4EAA0D;AAC1D,yEAAuD;AACvD,uEAAqD;AACrD,mEAAiD;AACjD,kDAAgC;AAChC,0EAAwD;AACxD,yEAAuD;AACvD,gEAA8C;AAC9C,iEAA+C;AAC/C,gEAA8C;AAC9C,+DAA6C;AAC7C,iEAA+C;AAC/C,6DAA2C;AAC3C,qEAAmD;AACnD,8DAA4C;AAC5C,gEAA8C;AAC9C,mEAAiD;AACjD,6CAA2B;AAEd,QAAA,qBAAqB,GAAW,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/runtime/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;GAaG;AACH,wEAAsD;AACtD,sEAAoD;AACpD,yFAAuE;AACvE,4EAA0D;AAC1D,yEAAuD;AACvD,uEAAqD;AACrD,mEAAiD;AACjD,kDAAgC;AAChC,sEAAoD;AACpD,0EAAwD;AACxD,yEAAuD;AACvD,gEAA8C;AAC9C,iEAA+C;AAC/C,gEAA8C;AAC9C,+DAA6C;AAC7C,iEAA+C;AAC/C,6DAA2C;AAC3C,qEAAmD;AACnD,8DAA4C;AAC5C,gEAA8C;AAC9C,mEAAiD;AACjD,6CAA2B;AAEd,QAAA,qBAAqB,GAAW,eAAe,CAAC"}

package/build/_modules/vqa/_collections/constants/vqa-standard-viewports.const.d.ts

@@ -4,7 +4,7 @@ import { DyE2E_Viewport_Interface } from '../../../contracts/_models/interfaces/
  * ezekből választhat subset-et, vagy override-olhatja sajáttal.
  *
  * **Konvenció**: `key` filename-friendly + a `dye2e generate-review-bundle` ezzel
- * mappel artifact-ot (`screenshots/<state>/<key>-full.png`).
+ * mappel artifact-ot (`states/<state>/<key>-<orientation>/full.png`).
  */
 export declare const DyE2E_VQA_StandardViewports_Const: {
     [key: string]: DyE2E_Viewport_Interface;

package/build/_modules/vqa/_collections/constants/vqa-standard-viewports.const.js

@@ -6,7 +6,7 @@ exports.DyE2E_VQA_DefaultViewportSubset_Const = exports.DyE2E_VQA_StandardViewpo
  * ezekből választhat subset-et, vagy override-olhatja sajáttal.
  *
  * **Konvenció**: `key` filename-friendly + a `dye2e generate-review-bundle` ezzel
- * mappel artifact-ot (`screenshots/<state>/<key>-full.png`).
+ * mappel artifact-ot (`states/<state>/<key>-<orientation>/full.png`).
  */
 exports.DyE2E_VQA_StandardViewports_Const = {
     mobileSmall: {

package/build/_modules/vqa/_collections/index.d.ts

@@ -7,4 +7,5 @@ export * from './utils/finding-validator.util';
 export * from './utils/finding-id.util';
 export * from './utils/risk-score.util';
 export * from './utils/deterministic-finding.util';
+export * from './utils/review-gate.util';
 //# sourceMappingURL=index.d.ts.map

package/build/_modules/vqa/_collections/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/_modules/vqa/_collections/index.ts"],"names":[],"mappings":"AAAA,cAAc,0CAA0C,CAAC;AACzD,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/_modules/vqa/_collections/index.ts"],"names":[],"mappings":"AAAA,cAAc,0CAA0C,CAAC;AACzD,cAAc,0CAA0C,CAAC;AACzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,0BAA0B,CAAC"}

package/build/_modules/vqa/_collections/index.js

@@ -23,4 +23,5 @@ __exportStar(require("./utils/finding-validator.util"), exports);
 __exportStar(require("./utils/finding-id.util"), exports);
 __exportStar(require("./utils/risk-score.util"), exports);
 __exportStar(require("./utils/deterministic-finding.util"), exports);
+__exportStar(require("./utils/review-gate.util"), exports);
 //# sourceMappingURL=index.js.map

package/build/_modules/vqa/_collections/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/_modules/vqa/_collections/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2EAAyD;AACzD,2EAAyD;AACzD,mEAAiD;AACjD,oEAAkD;AAClD,kEAAgD;AAChD,iEAA+C;AAC/C,0DAAwC;AACxC,0DAAwC;AACxC,qEAAmD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/_modules/vqa/_collections/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2EAAyD;AACzD,2EAAyD;AACzD,mEAAiD;AACjD,oEAAkD;AAClD,kEAAgD;AAChD,iEAA+C;AAC/C,0DAAwC;AACxC,0DAAwC;AACxC,qEAAmD;AACnD,2DAAyC"}

package/build/_modules/vqa/_collections/utils/review-gate.util.d.ts

@@ -0,0 +1,36 @@
+import { DyE2E_VQA_FindingStatus_Type } from '../../_enums/finding-status.enum';
+import { DyE2E_VQA_ReviewGate_Options, DyE2E_VQA_ReviewGateCategory_Type, DyE2E_VQA_ReviewGateReport_Interface } from '../../_models/interfaces/review-gate.interface';
+/** BFR-FSMED-015 — every gate category, in report order (the default `failOn`). */
+export declare const DYE2E_VQA_REVIEW_GATE_CATEGORIES: DyE2E_VQA_ReviewGateCategory_Type[];
+/**
+ * BFR-FSMED-015 — finding statuses that CLOSE a finding for the release verdict. Everything else (open, in-progress,
+ * fixed-but-not-re-audited, ready-for-re-audit, reopened) is still open.
+ */
+export declare const DYE2E_VQA_CLOSED_FINDING_STATUSES: DyE2E_VQA_FindingStatus_Type[];
+/**
+ * BFR-FSMED-015 (part 3) — the aggregate release gate for a VQA review bundle: manifest + captured evidence +
+ * finding-set + human-review marker ⇒ ONE verdict with stable codes and a machine-readable report.
+ *
+ * Checks: missing evidence (`VQA-GATE-EVIDENCE-MISSING`), missing findings file (`VQA-GATE-FINDINGS-MISSING`),
+ * orphan evidence (`VQA-GATE-EVIDENCE-ORPHAN`), invalid findings (`VQA-GATE-FINDING-INVALID`,
+ * `VQA-GATE-FINDING-FOREIGN`, `VQA-GATE-FINDING-REF-MISSING`), open blocker / high (`VQA-GATE-FINDING-OPEN-BLOCKER` /
+ * `-HIGH`), human review (`VQA-GATE-HUMAN-REVIEW-MISSING` / `-INVALID` / `-REJECTED`). A missing / unreadable bundle
+ * manifest (`VQA-GATE-MANIFEST-MISSING` / `-INVALID`) always fails — without it nothing can be checked.
+ */
+export declare class DyE2E_VQA_ReviewGate_Util {
+    /** Runs every check and returns the report; `verdict` is `fail` when any blocking issue exists. */
+    static verify(options: DyE2E_VQA_ReviewGate_Options): DyE2E_VQA_ReviewGateReport_Interface;
+    /** Parses a `--fail-on a,b` list; an unknown category throws (a typo must not silently weaken the gate). */
+    static parseFailOn(raw: string | undefined): DyE2E_VQA_ReviewGateCategory_Type[];
+    /** Reads `<bundle>/manifest.json`; a missing / unreadable one is an always-blocking issue. */
+    private static readManifest;
+    /** Missing capture artifacts + evidence folders the manifest does not declare. */
+    private static checkEvidence;
+    /** Finding schema + consistency with the bundle + open blocker / high. Returns the number of findings read. */
+    private static checkFindings;
+    /** The human-review marker: present, well-formed, approving. */
+    private static checkHumanReview;
+    /** The subdirectory names of a directory. */
+    private static subdirs;
+}
+//# sourceMappingURL=review-gate.util.d.ts.map

package/build/_modules/vqa/_collections/utils/review-gate.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-gate.util.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/vqa/_collections/utils/review-gate.util.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAMhF,OAAO,EAEL,4BAA4B,EAC5B,iCAAiC,EAEjC,oCAAoC,EACrC,MAAM,gDAAgD,CAAC;AAIxD,mFAAmF;AACnF,eAAO,MAAM,gCAAgC,EAAE,iCAAiC,EACT,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,iCAAiC,EAAE,4BAA4B,EAI3E,CAAC;AAcF;;;;;;;;;GASG;AACH,qBAAa,yBAAyB;IAEpC,mGAAmG;IACnG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,4BAA4B,GAAG,oCAAoC;IAqC1F,4GAA4G;IAC5G,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,iCAAiC,EAAE;IAmBhF,8FAA8F;IAC9F,OAAO,CAAC,MAAM,CAAC,YAAY;IAiC3B,kFAAkF;IAClF,OAAO,CAAC,MAAM,CAAC,aAAa;IAqC5B,+GAA+G;IAC/G,OAAO,CAAC,MAAM,CAAC,aAAa;IAyE5B,gEAAgE;IAChE,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAuC/B,6CAA6C;IAC7C,OAAO,CAAC,MAAM,CAAC,OAAO;CAKvB"}

package/build/_modules/vqa/_collections/utils/review-gate.util.js

@@ -0,0 +1,232 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyE2E_VQA_ReviewGate_Util = exports.DYE2E_VQA_CLOSED_FINDING_STATUSES = exports.DYE2E_VQA_REVIEW_GATE_CATEGORIES = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const finding_status_enum_1 = require("../../_enums/finding-status.enum");
+const finding_severity_enum_1 = require("../../_enums/finding-severity.enum");
+const review_bundle_generator_1 = require("../../generators/review-bundle.generator");
+const finding_validator_util_1 = require("./finding-validator.util");
+/** BFR-FSMED-015 — every gate category, in report order (the default `failOn`). */
+exports.DYE2E_VQA_REVIEW_GATE_CATEGORIES = ['missing', 'orphan', 'invalid', 'blocker', 'high', 'human-review'];
+/**
+ * BFR-FSMED-015 — finding statuses that CLOSE a finding for the release verdict. Everything else (open, in-progress,
+ * fixed-but-not-re-audited, ready-for-re-audit, reopened) is still open.
+ */
+exports.DYE2E_VQA_CLOSED_FINDING_STATUSES = [
+    finding_status_enum_1.DyE2E_VQA_FindingStatus_Type.verified,
+    finding_status_enum_1.DyE2E_VQA_FindingStatus_Type.ignored,
+    finding_status_enum_1.DyE2E_VQA_FindingStatus_Type.acceptedRisk,
+];
+/**
+ * BFR-FSMED-015 (part 3) — the aggregate release gate for a VQA review bundle: manifest + captured evidence +
+ * finding-set + human-review marker ⇒ ONE verdict with stable codes and a machine-readable report.
+ *
+ * Checks: missing evidence (`VQA-GATE-EVIDENCE-MISSING`), missing findings file (`VQA-GATE-FINDINGS-MISSING`),
+ * orphan evidence (`VQA-GATE-EVIDENCE-ORPHAN`), invalid findings (`VQA-GATE-FINDING-INVALID`,
+ * `VQA-GATE-FINDING-FOREIGN`, `VQA-GATE-FINDING-REF-MISSING`), open blocker / high (`VQA-GATE-FINDING-OPEN-BLOCKER` /
+ * `-HIGH`), human review (`VQA-GATE-HUMAN-REVIEW-MISSING` / `-INVALID` / `-REJECTED`). A missing / unreadable bundle
+ * manifest (`VQA-GATE-MANIFEST-MISSING` / `-INVALID`) always fails — without it nothing can be checked.
+ */
+class DyE2E_VQA_ReviewGate_Util {
+    /** Runs every check and returns the report; `verdict` is `fail` when any blocking issue exists. */
+    static verify(options) {
+        const failOn = options.failOn ?? exports.DYE2E_VQA_REVIEW_GATE_CATEGORIES;
+        const issues = [];
+        const add = (code, category, message, ref) => {
+            issues.push({ code: code, category: category, blocking: failOn.includes(category), message: message, ref: ref });
+        };
+        const manifest = DyE2E_VQA_ReviewGate_Util.readManifest(options.bundlePath, issues);
+        let findingsTotal = 0;
+        if (manifest) {
+            DyE2E_VQA_ReviewGate_Util.checkEvidence(options.bundlePath, manifest, add);
+            findingsTotal = DyE2E_VQA_ReviewGate_Util.checkFindings(options, manifest, add);
+            DyE2E_VQA_ReviewGate_Util.checkHumanReview(options, add);
+        }
+        const counts = {
+            'missing': 0, 'orphan': 0, 'invalid': 0, 'blocker': 0, 'high': 0, 'human-review': 0,
+        };
+        issues.forEach((issue) => {
+            counts[issue.category]++;
+        });
+        return {
+            schema: 'dye2e-vqa-review-gate/1',
+            bundlePath: options.bundlePath,
+            featureId: manifest?.featureId ?? '',
+            verdict: issues.some((issue) => issue.blocking) ? 'fail' : 'pass',
+            failOn: failOn,
+            counts: counts,
+            findingsTotal: findingsTotal,
+            issues: issues,
+        };
+    }
+    /** Parses a `--fail-on a,b` list; an unknown category throws (a typo must not silently weaken the gate). */
+    static parseFailOn(raw) {
+        if (!raw) {
+            return exports.DYE2E_VQA_REVIEW_GATE_CATEGORIES;
+        }
+        return raw.split(',').map((part) => {
+            const category = exports.DYE2E_VQA_REVIEW_GATE_CATEGORIES
+                .find((known) => known === part.trim());
+            if (!category) {
+                throw new Error(`VQA-GATE-FAIL-ON-UNKNOWN: "${part.trim()}" — valid: ${exports.DYE2E_VQA_REVIEW_GATE_CATEGORIES.join(', ')}`);
+            }
+            return category;
+        });
+    }
+    /** Reads `<bundle>/manifest.json`; a missing / unreadable one is an always-blocking issue. */
+    static readManifest(bundlePath, issues) {
+        const manifestPath = path.join(bundlePath, 'manifest.json');
+        if (!fs.existsSync(manifestPath)) {
+            issues.push({
+                code: 'VQA-GATE-MANIFEST-MISSING', category: 'missing', blocking: true, ref: 'manifest.json',
+                message: `bundle manifest not found: ${manifestPath}`,
+            });
+            return undefined;
+        }
+        try {
+            const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+            if (!manifest?.featureId || !Array.isArray(manifest.states) || !Array.isArray(manifest.viewports)) {
+                throw new Error('featureId / states / viewports missing');
+            }
+            return manifest;
+        }
+        catch (err) {
+            issues.push({
+                code: 'VQA-GATE-MANIFEST-INVALID', category: 'invalid', blocking: true, ref: 'manifest.json',
+                message: `bundle manifest unreadable: ${err instanceof Error ? err.message : String(err)}`,
+            });
+            return undefined;
+        }
+    }
+    /** Missing capture artifacts + evidence folders the manifest does not declare. */
+    static checkEvidence(bundlePath, manifest, add) {
+        review_bundle_generator_1.DyE2E_VQA_ReviewBundle_Generator.verifyBundleArtifacts(bundlePath, manifest).missing
+            .forEach((ref) => add('VQA-GATE-EVIDENCE-MISSING', 'missing', `capture artifact missing: ${ref}`, ref));
+        const statesDir = path.join(bundlePath, 'states');
+        if (!fs.existsSync(statesDir)) {
+            return;
+        }
+        const orientations = manifest.orientations && manifest.orientations.length ? manifest.orientations : ['preserve'];
+        const stateIds = manifest.states.map((state) => state.stateId);
+        const viewportDirs = manifest.viewports.flatMap((viewport) => orientations.map((orientation) => `${viewport.key}-${orientation}`));
+        for (const stateDir of DyE2E_VQA_ReviewGate_Util.subdirs(statesDir)) {
+            if (!stateIds.includes(stateDir)) {
+                add('VQA-GATE-EVIDENCE-ORPHAN', 'orphan', `evidence for a state the manifest does not declare: ${stateDir}`, `states/${stateDir}`);
+                continue;
+            }
+            for (const viewportDir of DyE2E_VQA_ReviewGate_Util.subdirs(path.join(statesDir, stateDir))) {
+                if (!viewportDirs.includes(viewportDir)) {
+                    add('VQA-GATE-EVIDENCE-ORPHAN', 'orphan', `evidence for a viewport / orientation the manifest does not declare: ${stateDir}/${viewportDir}`, `states/${stateDir}/${viewportDir}`);
+                }
+            }
+        }
+    }
+    /** Finding schema + consistency with the bundle + open blocker / high. Returns the number of findings read. */
+    static checkFindings(options, manifest, add) {
+        const findingsPath = options.findingsPath ?? path.join(options.bundlePath, 'findings', 'findings.json');
+        if (!fs.existsSync(findingsPath)) {
+            add('VQA-GATE-FINDINGS-MISSING', 'missing', `finding-set not found (the review did not run, or wrote elsewhere): ${findingsPath}`, findingsPath);
+            return 0;
+        }
+        let findings;
+        try {
+            const raw = JSON.parse(fs.readFileSync(findingsPath, 'utf-8'));
+            const list = Array.isArray(raw) ? raw : raw?.findings;
+            if (!Array.isArray(list)) {
+                throw new Error('expected an array or { findings: [] }');
+            }
+            findings = list;
+        }
+        catch (err) {
+            add('VQA-GATE-FINDING-INVALID', 'invalid', `finding-set unreadable: ${err instanceof Error ? err.message : String(err)}`, findingsPath);
+            return 0;
+        }
+        const stateIds = manifest.states.map((state) => state.stateId);
+        const viewportKeys = manifest.viewports.map((viewport) => viewport.key);
+        findings.forEach((finding, index) => {
+            const ref = finding?.findingId || `findings[${index}]`;
+            const validation = finding_validator_util_1.DyE2E_VQA_FindingValidator_Util.validate(finding);
+            if (!validation.ok) {
+                add('VQA-GATE-FINDING-INVALID', 'invalid', `schema: ${validation.errors
+                    .map((e) => `${e.path} ${e.message}`).join('; ')}`, ref);
+            }
+            // Cross-check against the bundle: a finding about another feature / an undeclared state or viewport is foreign
+            if (finding?.featureId !== manifest.featureId || !stateIds.includes(finding?.stateId ?? '')
+                || !viewportKeys.includes(finding?.viewport ?? '')) {
+                add('VQA-GATE-FINDING-FOREIGN', 'invalid', `feature / state / viewport not in this bundle: ${finding?.featureId} / ${finding?.stateId} / ${finding?.viewport}`, ref);
+            }
+            // Every evidence reference must point at a file that exists in the bundle
+            [finding?.screenshotRef, finding?.domSnapshotRef]
+                .filter((evidenceRef) => !!evidenceRef)
+                .filter((evidenceRef) => !fs.existsSync(path.join(options.bundlePath, evidenceRef)))
+                .forEach((evidenceRef) => add('VQA-GATE-FINDING-REF-MISSING', 'invalid', `evidence reference not in the bundle: ${evidenceRef}`, ref));
+            const isOpen = !exports.DYE2E_VQA_CLOSED_FINDING_STATUSES
+                .some((status) => status === finding?.status);
+            if (isOpen && finding?.severity === finding_severity_enum_1.DyE2E_VQA_FindingSeverity_Type.blocker) {
+                add('VQA-GATE-FINDING-OPEN-BLOCKER', 'blocker', `open blocker (status: ${finding.status})`, ref);
+            }
+            if (isOpen && finding?.severity === finding_severity_enum_1.DyE2E_VQA_FindingSeverity_Type.high) {
+                add('VQA-GATE-FINDING-OPEN-HIGH', 'high', `open high (status: ${finding.status})`, ref);
+            }
+        });
+        return findings.length;
+    }
+    /** The human-review marker: present, well-formed, approving. */
+    static checkHumanReview(options, add) {
+        const reviewPath = options.humanReviewPath ?? path.join(options.bundlePath, 'human-review.json');
+        if (!fs.existsSync(reviewPath)) {
+            add('VQA-GATE-HUMAN-REVIEW-MISSING', 'human-review', `no human review marker: ${reviewPath}`, reviewPath);
+            return;
+        }
+        let review;
+        try {
+            review = JSON.parse(fs.readFileSync(reviewPath, 'utf-8'));
+        }
+        catch (err) {
+            add('VQA-GATE-HUMAN-REVIEW-INVALID', 'human-review', `human review marker unreadable: ${err instanceof Error ? err.message : String(err)}`, reviewPath);
+            return;
+        }
+        const wellFormed = typeof review?.reviewer === 'string' && !!review.reviewer.trim()
+            && typeof review.reviewedAt === 'string' && !Number.isNaN(Date.parse(review.reviewedAt))
+            && (review.verdict === 'approved' || review.verdict === 'rejected');
+        if (!wellFormed) {
+            add('VQA-GATE-HUMAN-REVIEW-INVALID', 'human-review', 'human review marker needs { reviewer, reviewedAt (ISO date), verdict: approved | rejected }', reviewPath);
+            return;
+        }
+        if (review.verdict === 'rejected') {
+            add('VQA-GATE-HUMAN-REVIEW-REJECTED', 'human-review', `the human reviewer (${review.reviewer}) rejected`, reviewPath);
+        }
+    }
+    /** The subdirectory names of a directory. */
+    static subdirs(dir) {
+        return fs.readdirSync(dir, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name);
+    }
+}
+exports.DyE2E_VQA_ReviewGate_Util = DyE2E_VQA_ReviewGate_Util;
+//# sourceMappingURL=review-gate.util.js.map