@futdevpro/dynamo-e2e 1.18.9 → 1.18.11

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 Minden release a `dynamo-e2e-foundation` HYPERPLAN MP-N ütemezést követi.
 Verzióformátum: `MM.mm.p` (két-számjegyes major-minor, Dynamo-konvenció).
 
+## [01.18.11] — 2026-08-26 — Deterministic game E2E preset
+
+- Added `@futdevpro/dynamo-e2e/game` with an event-driven, capability-gated seam for deterministic seed read-back,
+  versioned state import/export, manual clock advancement, canvas world-to-screen mapping and failure artifacts.
+- The default seam guard permits loopback hosts only. Test environments require an explicit allow-list entry and
+  retain their server-side guard; timeout values are failure bounds, with no fixed sleep or helper polling.
+- Added schema-v1 game journey contracts and bidirectional validation for cross-feature serial state carry,
+  step-level business assertions, value outcomes, variant coverage, executable evidence and cleanup ownership.
+- Corrected `DYE2E_PACKAGE_VERSION` to the actual package version.
+
 ## [01.18.9] — 2026-07-21 — Playwright-config preset (fleet e2e-config konszolidáció #2)
 
 ### Added
@@ -105,9 +115,9 @@ generator (NEM AI-engine).** Az AI agent EXTERNAL consumer.
 
 ### Spec-pinning
 
-[`documentations/specifications/ai-visual-qa-system.md`](../../documentations/specifications/ai-visual-qa-system.md)
+[`fdp-documentations/specifications/ai-visual-qa-system.md`](../../fdp-documentations/specifications/ai-visual-qa-system.md)
 22 szekció canonical, scope-LOCK preamble UI-20260611-003. Workspace HYPERPLAN:
-`documentations/plans/ai-visual-qa/HYPERPLAN.md` 13 MP.
+`fdp-documentations/plans/ai-visual-qa/HYPERPLAN.md` 13 MP.
 
 ## [01.17.1] — 2026-06-10 — 🎯 HYPERPLAN 112/112 ✓
 

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Future Development Program Ltd. (HU)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -70,4 +70,7 @@ const specSource = DyE2E_FormSuite_Generator.emit({
 - `@futdevpro/dynamo-e2e/generators` — Node-only emission engine
 - `@futdevpro/dynamo-e2e/runtime` — Playwright fixtures + page-objects (Wave-4)
 - `@futdevpro/dynamo-e2e/presets` — pre-built suites + `DyE2E_getPlaywrightConfig` / `DyE2E_getGlobalSetup` playwright-config factory (fleet e2e-config SSOT)
+- `@futdevpro/dynamo-e2e/game` — capability-gated deterministic game seam, failure artifacts and bidirectional journey-catalog validation
 - `@futdevpro/dynamo-e2e/cwv` — Core Web Vitals (Wave-3)
+
+Detailed game-preset contract: [`__documentations/game-preset.md`](__documentations/game-preset.md).

package/build/_modules/game/_models/game-contracts.interface.d.ts

@@ -0,0 +1,82 @@
+export type DyE2E_GameCapability_Type = 'seed' | 'state' | 'clock' | 'canvas' | 'diagnostics';
+export interface DyE2E_GamePoint_Interface {
+    x: number;
+    y: number;
+}
+export interface DyE2E_GameDiagnostics_Interface {
+    seed?: string | number;
+    stateVersion?: string | number;
+    clockMs?: number;
+    lastBusinessTransition?: string;
+    [key: string]: unknown;
+}
+export interface DyE2E_GameVersionedState_Interface<TPayload = unknown> {
+    schemaVersion: string | number;
+    payload?: TPayload;
+    [key: string]: unknown;
+}
+export interface DyE2E_GameFailureArtifact_Interface<TSnapshot = unknown, TState extends DyE2E_GameVersionedState_Interface = DyE2E_GameVersionedState_Interface> {
+    url: string;
+    viewport: {
+        width: number;
+        height: number;
+    } | null;
+    capabilities: readonly DyE2E_GameCapability_Type[];
+    seed?: string | number;
+    state?: TState;
+    snapshot?: TSnapshot;
+    diagnostics?: DyE2E_GameDiagnostics_Interface;
+    captureErrors?: Readonly<Record<string, string>>;
+}
+export interface DyE2E_GameSeam_Options_Interface {
+    seamKey?: string;
+    readyEventName?: string;
+    optInStorageKey?: string;
+    optInQueryParam?: string;
+    timeoutMs?: number;
+    allowedHosts?: readonly string[];
+    requiredCapabilities?: readonly DyE2E_GameCapability_Type[];
+}
+export interface DyE2E_GameJourneyStep_Interface {
+    id: string;
+    businessAssertion: string;
+    consumesStateFromStepId?: string;
+}
+export type DyE2E_GameJourneyVariant_Type = 'happy-path' | 'decline' | 'partial' | 'fallback' | 'interruption-resume' | 'access-limited';
+export interface DyE2E_GameJourneyCleanup_Interface {
+    owner: string;
+    mode: 'hard-delete' | 'restore-snapshot' | 'reset-profile';
+    businessAssertion: string;
+}
+export interface DyE2E_GameJourney_Interface {
+    id: string;
+    title: string;
+    critical: boolean;
+    serial: true;
+    variant: DyE2E_GameJourneyVariant_Type;
+    featureIds: readonly string[];
+    evidenceTestIds: readonly string[];
+    steps: readonly DyE2E_GameJourneyStep_Interface[];
+    valueOutcome: string;
+    cleanup: DyE2E_GameJourneyCleanup_Interface;
+}
+export interface DyE2E_GameJourneyFeature_Interface {
+    id: string;
+    journeyIds: readonly string[];
+}
+export interface DyE2E_GameJourneyCatalog_Interface {
+    schemaVersion: 1;
+    requiredVariants: readonly DyE2E_GameJourneyVariant_Type[];
+    features: readonly DyE2E_GameJourneyFeature_Interface[];
+    journeys: readonly DyE2E_GameJourney_Interface[];
+}
+export interface DyE2E_GameJourneyCatalog_Finding_Interface {
+    path: string;
+    code: string;
+    message: string;
+}
+export interface DyE2E_GameJourneyCatalog_Validation_Interface {
+    valid: boolean;
+    findings: DyE2E_GameJourneyCatalog_Finding_Interface[];
+}
+//# sourceMappingURL=game-contracts.interface.d.ts.map

package/build/_modules/game/_models/game-contracts.interface.d.ts.map

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

package/build/_modules/game/_models/game-contracts.interface.js

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

package/build/_modules/game/_models/game-contracts.interface.js.map

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

package/build/_modules/game/game-seam.helper.d.ts

@@ -0,0 +1,40 @@
+import type { Page } from '@playwright/test';
+import { DyE2E_GameCapability_Type, DyE2E_GameFailureArtifact_Interface, DyE2E_GamePoint_Interface, DyE2E_GameSeam_Options_Interface, DyE2E_GameVersionedState_Interface } from './_models/game-contracts.interface';
+/**
+ * Capability-gated adapter for an explicitly enabled browser game test seam.
+ *
+ * It never creates business state. Readiness is event-driven; timeout values are hard failure bounds, not fixed
+ * sleeps or polling intervals.
+ */
+export declare class DyE2E_GameSeam_Helper<TSnapshot = unknown, TState extends DyE2E_GameVersionedState_Interface = DyE2E_GameVersionedState_Interface> {
+    private readonly page;
+    private readonly seamKey;
+    private readonly readyEventName;
+    private readonly optInStorageKey;
+    private readonly optInQueryParam;
+    private readonly timeoutMs;
+    private readonly allowedHosts;
+    private readonly requiredCapabilities;
+    constructor(page: Page, options?: DyE2E_GameSeam_Options_Interface);
+    /** Enable the seam before navigation. Non-loopback hosts require an explicit allow-list entry. */
+    enableForNavigation(targetUrl: string): Promise<void>;
+    /** Add the explicit query opt-in while preserving existing query parameters. */
+    withOptIn(targetUrl: string): string;
+    /** Wait for one readiness event, or return immediately if the seam is already installed. */
+    waitForSeam(): Promise<void>;
+    capabilities(): Promise<readonly DyE2E_GameCapability_Type[]>;
+    snapshot(): Promise<TSnapshot>;
+    installSeed(seed: string | number): Promise<void>;
+    readSeed(): Promise<string | number>;
+    exportState(): Promise<TState>;
+    importState(state: TState): Promise<void>;
+    advanceClock(deltaMs: number): Promise<void>;
+    worldToScreen(point: DyE2E_GamePoint_Interface): Promise<DyE2E_GamePoint_Interface>;
+    /** One browser round-trip containing the evidence needed to diagnose deterministic game failures. */
+    captureFailureArtifact(): Promise<DyE2E_GameFailureArtifact_Interface<TSnapshot, TState>>;
+    private assertAllowedHost;
+    private requireCapabilities;
+    private assertVersionedState;
+    private invoke;
+}
+//# sourceMappingURL=game-seam.helper.d.ts.map

package/build/_modules/game/game-seam.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-seam.helper.d.ts","sourceRoot":"","sources":["../../../src/_modules/game/game-seam.helper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EACL,yBAAyB,EAEzB,mCAAmC,EACnC,yBAAyB,EACzB,gCAAgC,EAChC,kCAAkC,EACnC,MAAM,oCAAoC,CAAC;AAK5C;;;;;GAKG;AACH,qBAAa,qBAAqB,CAChC,SAAS,GAAG,OAAO,EACnB,MAAM,SAAS,kCAAkC,GAAG,kCAAkC;IAW1E,OAAO,CAAC,QAAQ,CAAC,IAAI;IARjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IACjD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAuC;gBAE/C,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,gCAAqC;IAmBvF,kGAAkG;IAC5F,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3D,gFAAgF;IAChF,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAQpC,4FAA4F;IACtF,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAsC5B,YAAY,IAAI,OAAO,CAAC,SAAS,yBAAyB,EAAE,CAAC;IAqB7D,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC;IAI9B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBjD,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IAUpC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAM9B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C,aAAa,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAezF,qGAAqG;IAC/F,sBAAsB,IAAI,OAAO,CAAC,mCAAmC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAsC/F,OAAO,CAAC,iBAAiB;YAWX,mBAAmB;IAcjC,OAAO,CAAC,oBAAoB;YAYd,MAAM;CAyBrB"}

package/build/_modules/game/game-seam.helper.js

@@ -0,0 +1,254 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyE2E_GameSeam_Helper = void 0;
+const DEFAULT_ALLOWED_HOSTS = ['localhost', '127.0.0.1', '::1'];
+const KNOWN_CAPABILITIES = ['seed', 'state', 'clock', 'canvas', 'diagnostics'];
+/**
+ * Capability-gated adapter for an explicitly enabled browser game test seam.
+ *
+ * It never creates business state. Readiness is event-driven; timeout values are hard failure bounds, not fixed
+ * sleeps or polling intervals.
+ */
+class DyE2E_GameSeam_Helper {
+    page;
+    seamKey;
+    readyEventName;
+    optInStorageKey;
+    optInQueryParam;
+    timeoutMs;
+    allowedHosts;
+    requiredCapabilities;
+    constructor(page, options = {}) {
+        this.page = page;
+        this.seamKey = options.seamKey ?? '__dye2eGame';
+        this.readyEventName = options.readyEventName ?? 'dye2e:game-seam-ready';
+        this.optInStorageKey = options.optInStorageKey ?? 'dye2eGame';
+        this.optInQueryParam = options.optInQueryParam ?? 'dye2eGame';
+        this.timeoutMs = options.timeoutMs ?? 15_000;
+        this.allowedHosts = (options.allowedHosts ?? DEFAULT_ALLOWED_HOSTS).map((host) => host.toLowerCase());
+        this.requiredCapabilities = options.requiredCapabilities ?? [];
+        if (!Number.isFinite(this.timeoutMs) || this.timeoutMs <= 0) {
+            throw new Error(`[DyE2E_GameSeam_Helper] timeoutMs must be finite and positive; received ${this.timeoutMs}.`);
+        }
+        if (![this.seamKey, this.readyEventName, this.optInStorageKey, this.optInQueryParam].every(Boolean)) {
+            throw new Error('[DyE2E_GameSeam_Helper] Seam, event and opt-in names must be non-empty.');
+        }
+        if (this.allowedHosts.length === 0 || this.allowedHosts.some((host) => !host.trim())) {
+            throw new Error('[DyE2E_GameSeam_Helper] At least one non-empty allowed host is required.');
+        }
+    }
+    /** Enable the seam before navigation. Non-loopback hosts require an explicit allow-list entry. */
+    async enableForNavigation(targetUrl) {
+        this.assertAllowedHost(targetUrl);
+        await this.page.addInitScript((settings) => {
+            if (!settings.allowedHosts.includes(window.location.hostname.toLowerCase())) {
+                return;
+            }
+            try {
+                window.sessionStorage.setItem(settings.storageKey, '1');
+            }
+            catch {
+                // A query opt-in remains available when browser policy disables session storage.
+            }
+        }, { storageKey: this.optInStorageKey, allowedHosts: this.allowedHosts });
+    }
+    /** Add the explicit query opt-in while preserving existing query parameters. */
+    withOptIn(targetUrl) {
+        this.assertAllowedHost(targetUrl);
+        const parsed = new URL(targetUrl, 'http://localhost');
+        parsed.searchParams.set(this.optInQueryParam, '1');
+        return targetUrl.startsWith('/') ? `${parsed.pathname}${parsed.search}${parsed.hash}` : parsed.toString();
+    }
+    /** Wait for one readiness event, or return immediately if the seam is already installed. */
+    async waitForSeam() {
+        await this.page.evaluate(([key, eventName, timeoutMs]) => new Promise((resolve, reject) => {
+            let timeoutId;
+            const onReady = (event) => {
+                const detail = event.detail;
+                const detailKey = typeof detail === 'object' && detail !== null
+                    ? detail.seamKey
+                    : detail;
+                if (detailKey !== undefined && detailKey !== key) {
+                    return;
+                }
+                window.clearTimeout(timeoutId);
+                window.removeEventListener(eventName, onReady);
+                resolve();
+            };
+            timeoutId = window.setTimeout(() => {
+                window.removeEventListener(eventName, onReady);
+                reject(new Error(`[DyE2E_GameSeam_Helper] '${key}' did not dispatch '${eventName}' within ${timeoutMs}ms. `
+                    + 'Verify host allow-listing, explicit opt-in, seam installation and ready-event dispatch.'));
+            }, timeoutMs);
+            window.addEventListener(eventName, onReady);
+            if (window[key]) {
+                window.clearTimeout(timeoutId);
+                window.removeEventListener(eventName, onReady);
+                resolve();
+            }
+        }), [this.seamKey, this.readyEventName, this.timeoutMs]);
+        await this.requireCapabilities(this.requiredCapabilities);
+    }
+    async capabilities() {
+        return this.page.evaluate((settings) => {
+            const { key, knownCapabilities } = settings;
+            const seam = window[key];
+            if (!seam) {
+                throw new Error(`[DyE2E_GameSeam_Helper] Seam '${key}' is not installed.`);
+            }
+            if (!Array.isArray(seam.capabilities)) {
+                return [];
+            }
+            const invalid = seam.capabilities.filter((value) => !knownCapabilities.includes(value));
+            if (invalid.length > 0) {
+                throw new Error(`[DyE2E_GameSeam_Helper] Seam '${key}' declares unknown capabilities: ${invalid.join(', ')}.`);
+            }
+            return [...new Set(seam.capabilities)];
+        }, { key: this.seamKey, knownCapabilities: KNOWN_CAPABILITIES });
+    }
+    async snapshot() {
+        return this.invoke('diagnostics', 'getSnapshot');
+    }
+    async installSeed(seed) {
+        if ((typeof seed !== 'string' && typeof seed !== 'number')
+            || (typeof seed === 'string' && !seed.trim())
+            || (typeof seed === 'number' && !Number.isFinite(seed))) {
+            throw new Error(`[DyE2E_GameSeam_Helper] Seed must be a non-empty string or finite number; received '${seed}'.`);
+        }
+        const accepted = await this.invoke('seed', 'installSeed', seed);
+        if (accepted === false) {
+            throw new Error(`[DyE2E_GameSeam_Helper] The game rejected seed '${String(seed)}'.`);
+        }
+        const applied = await this.readSeed();
+        if (String(applied) !== String(seed)) {
+            throw new Error(`[DyE2E_GameSeam_Helper] Seed read-back mismatch: requested '${String(seed)}', `
+                + `received '${String(applied)}'.`);
+        }
+    }
+    async readSeed() {
+        const seed = await this.invoke('seed', 'readSeed');
+        if ((typeof seed !== 'string' && typeof seed !== 'number')
+            || (typeof seed === 'string' && !seed.trim())
+            || (typeof seed === 'number' && !Number.isFinite(seed))) {
+            throw new Error(`[DyE2E_GameSeam_Helper] readSeed returned an invalid seed '${String(seed)}'.`);
+        }
+        return seed;
+    }
+    async exportState() {
+        const state = await this.invoke('state', 'exportState');
+        this.assertVersionedState(state);
+        return state;
+    }
+    async importState(state) {
+        this.assertVersionedState(state);
+        const accepted = await this.invoke('state', 'importState', state);
+        if (accepted === false) {
+            throw new Error('[DyE2E_GameSeam_Helper] The game rejected the imported state.');
+        }
+    }
+    async advanceClock(deltaMs) {
+        if (!Number.isFinite(deltaMs) || deltaMs <= 0) {
+            throw new Error(`[DyE2E_GameSeam_Helper] deltaMs must be finite and positive; received ${deltaMs}.`);
+        }
+        const accepted = await this.invoke('clock', 'advanceClock', deltaMs);
+        if (accepted === false) {
+            throw new Error(`[DyE2E_GameSeam_Helper] The game rejected manual clock advancement by ${deltaMs}ms.`);
+        }
+    }
+    async worldToScreen(point) {
+        if (!point || ![point.x, point.y].every(Number.isFinite)) {
+            throw new Error('[DyE2E_GameSeam_Helper] World coordinates must be finite numbers.');
+        }
+        const screenPoint = await this.invoke('canvas', 'worldToScreen', point);
+        if (!screenPoint || ![screenPoint.x, screenPoint.y].every(Number.isFinite)) {
+            throw new Error('[DyE2E_GameSeam_Helper] worldToScreen returned non-finite screen coordinates.');
+        }
+        return screenPoint;
+    }
+    /** One browser round-trip containing the evidence needed to diagnose deterministic game failures. */
+    async captureFailureArtifact() {
+        return this.page.evaluate(async (key) => {
+            const seam = window[key];
+            if (!seam) {
+                throw new Error(`[DyE2E_GameSeam_Helper] Seam '${key}' is not installed.`);
+            }
+            const capabilities = Array.isArray(seam.capabilities)
+                ? [...seam.capabilities]
+                : [];
+            const captureErrors = {};
+            const call = async (name) => {
+                const method = seam[name];
+                if (typeof method !== 'function') {
+                    return undefined;
+                }
+                try {
+                    return await method.call(seam);
+                }
+                catch (error) {
+                    captureErrors[name] = error instanceof Error ? error.message : String(error);
+                    return undefined;
+                }
+            };
+            return {
+                url: window.location.href,
+                viewport: { width: window.innerWidth, height: window.innerHeight },
+                capabilities,
+                seed: capabilities.includes('seed') ? await call('readSeed') : undefined,
+                state: capabilities.includes('state') ? await call('exportState') : undefined,
+                snapshot: capabilities.includes('diagnostics') ? await call('getSnapshot') : undefined,
+                diagnostics: capabilities.includes('diagnostics')
+                    ? await call('getDiagnostics')
+                    : undefined,
+                captureErrors: Object.keys(captureErrors).length > 0 ? captureErrors : undefined,
+            };
+        }, this.seamKey);
+    }
+    assertAllowedHost(targetUrl) {
+        const parsed = new URL(targetUrl, 'http://localhost');
+        if (!this.allowedHosts.includes(parsed.hostname)) {
+            throw new Error(`[DyE2E_GameSeam_Helper] Refusing to enable a game seam on host '${parsed.hostname}'. `
+                + `Allowed hosts: ${this.allowedHosts.join(', ')}. Add a test host explicitly only when its server-side `
+                + 'seam guard is enabled.');
+        }
+    }
+    async requireCapabilities(required) {
+        if (required.length === 0) {
+            return;
+        }
+        const available = await this.capabilities();
+        const missing = required.filter((item) => !available.includes(item));
+        if (missing.length > 0) {
+            throw new Error(`[DyE2E_GameSeam_Helper] Missing required capabilities: ${missing.join(', ')}. `
+                + `Available: ${available.join(', ') || '(none)'}.`);
+        }
+    }
+    assertVersionedState(state) {
+        if (!state || typeof state !== 'object') {
+            throw new Error('[DyE2E_GameSeam_Helper] A state snapshot must be an object with schemaVersion.');
+        }
+        const schemaVersion = state.schemaVersion;
+        if ((typeof schemaVersion !== 'string' && typeof schemaVersion !== 'number')
+            || String(schemaVersion).trim().length === 0
+            || (typeof schemaVersion === 'number' && !Number.isFinite(schemaVersion))) {
+            throw new Error('[DyE2E_GameSeam_Helper] A state snapshot must carry a non-empty schemaVersion.');
+        }
+    }
+    async invoke(capability, methodName, ...args) {
+        return this.page.evaluate(([key, requiredCapability, method, callArgs]) => {
+            const seam = window[key];
+            if (!seam) {
+                throw new Error(`[DyE2E_GameSeam_Helper] Seam '${key}' is not installed.`);
+            }
+            if (!Array.isArray(seam.capabilities) || !seam.capabilities.includes(requiredCapability)) {
+                throw new Error(`[DyE2E_GameSeam_Helper] Method '${method}' requires '${requiredCapability}'.`);
+            }
+            const fn = seam[method];
+            if (typeof fn !== 'function') {
+                throw new Error(`[DyE2E_GameSeam_Helper] Capability '${requiredCapability}' declares missing method '${method}'.`);
+            }
+            return fn.apply(seam, callArgs);
+        }, [this.seamKey, capability, methodName, args]);
+    }
+}
+exports.DyE2E_GameSeam_Helper = DyE2E_GameSeam_Helper;
+//# sourceMappingURL=game-seam.helper.js.map

package/build/_modules/game/game-seam.helper.js.map

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

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

@@ -0,0 +1,4 @@
+export * from './_models/game-contracts.interface';
+export * from './game-seam.helper';
+export * from './journey-catalog.validator';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/game/index.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC"}

package/build/_modules/game/index.js

@@ -0,0 +1,20 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./_models/game-contracts.interface"), exports);
+__exportStar(require("./game-seam.helper"), exports);
+__exportStar(require("./journey-catalog.validator"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/game/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qEAAmD;AACnD,qDAAmC;AACnC,8DAA4C"}

package/build/_modules/game/journey-catalog.validator.d.ts

@@ -0,0 +1,5 @@
+import { DyE2E_GameJourneyCatalog_Validation_Interface } from './_models/game-contracts.interface';
+/** Validate cross-feature, state-carrying journey evidence without executing or manufacturing business state. */
+export declare function DyE2E_validateGameJourneyCatalog(candidate: unknown): DyE2E_GameJourneyCatalog_Validation_Interface;
+export declare function DyE2E_assertGameJourneyCatalog(catalog: unknown): void;
+//# sourceMappingURL=journey-catalog.validator.d.ts.map

package/build/_modules/game/journey-catalog.validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey-catalog.validator.d.ts","sourceRoot":"","sources":["../../../src/_modules/game/journey-catalog.validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,6CAA6C,EAC9C,MAAM,oCAAoC,CAAC;AAa5C,iHAAiH;AACjH,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,OAAO,GACjB,6CAA6C,CAmJ/C;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQrE"}