@futdevpro/fdp-e2e-helpers 1.15.21 → 1.15.22

package/build/_collections/fdp-browser-e2e.util.d.ts

@@ -21,4 +21,30 @@ export interface FDP_AuthFormsE2E_Options {
  * ezért érdemes E2E-vel őrizni. A fogyasztó: `FDP_buildAuthFormsE2E({ loginRoute, registerRoute })`.
  */
 export declare function FDP_buildAuthFormsE2E(opts: FDP_AuthFormsE2E_Options): void;
+/** A `FDP_buildRobustnessE2E` opciói. */
+export interface FDP_RobustnessE2E_Options {
+    /** A publikus landing-oldal route-ja (console-health + page-title check). Pl. `/landing`. */
+    landingRoute: string;
+    /** Egy AUTH-GUARD-dal védett route, ami unauthentikáltan máshová redirect-el. Pl. `/main`. Ha nincs megadva → a guard-teszt kimarad. */
+    protectedRoute?: string;
+    /** Egy biztosan NEM létező route a 404/not-found-kezelés tesztelésére. Default: `/nonexistent-route-xyz-12345`. */
+    unknownRoute?: string;
+    /** A not-found-redirect URL-jében elvárt jelölő (a routing `**` → not-found). Default: `not-found`. */
+    notFoundIndicator?: string;
+    /** A védett route pathname-töredéke, aminek a redirect UTÁN NEM szabad benne lennie az URL-ben. Default: a `protectedRoute` `/`-ek nélkül. */
+    protectedPathFragment?: string;
+}
+/**
+ * Beregisztrálja a **production-readiness robusztussági smoke-okat** (no-auth, no-spend) — minden frontendes
+ * rendszerre újrahasználható (master-prompter, futdevpro, token-service, niche-datasets-space, …). Ezek a
+ * meglévő public/nav-smoke-ot egészítik ki az auth/spend nélkül is ellenőrizhető viselkedésekkel:
+ *  - **auth-guard**: a védett route unauthentikáltan NEM marad elérhető (redirect),
+ *  - **404-graceful**: ismeretlen route → not-found (nem törött oldal),
+ *  - **console-health**: a landing KRITIKUS JS-hiba nélkül tölt be,
+ *  - **page-title**: van title (alap struktúra/SEO).
+ *
+ * Egy törött guard / fehér-képernyős JS-crash = launch-blokkoló, ezért érdemes E2E-vel őrizni. A logika a
+ * master-prompter `robustness.spec`-jéből emelve (live test-env-en zöldre futtatva), parametrizálva.
+ */
+export declare function FDP_buildRobustnessE2E(opts: FDP_RobustnessE2E_Options): void;
 //# sourceMappingURL=fdp-browser-e2e.util.d.ts.map

package/build/_collections/fdp-browser-e2e.util.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FDP_buildAuthFormsE2E = FDP_buildAuthFormsE2E;
+exports.FDP_buildRobustnessE2E = FDP_buildRobustnessE2E;
 const test_1 = require("@playwright/test");
 /**
  * Beregisztrálja a **standard auth-UI form-struktúra** smoke-okat (no-auth, no-spend): a login + register oldal
@@ -33,4 +34,60 @@ function FDP_buildAuthFormsE2E(opts) {
         });
     });
 }
+/**
+ * Beregisztrálja a **production-readiness robusztussági smoke-okat** (no-auth, no-spend) — minden frontendes
+ * rendszerre újrahasználható (master-prompter, futdevpro, token-service, niche-datasets-space, …). Ezek a
+ * meglévő public/nav-smoke-ot egészítik ki az auth/spend nélkül is ellenőrizhető viselkedésekkel:
+ *  - **auth-guard**: a védett route unauthentikáltan NEM marad elérhető (redirect),
+ *  - **404-graceful**: ismeretlen route → not-found (nem törött oldal),
+ *  - **console-health**: a landing KRITIKUS JS-hiba nélkül tölt be,
+ *  - **page-title**: van title (alap struktúra/SEO).
+ *
+ * Egy törött guard / fehér-képernyős JS-crash = launch-blokkoló, ezért érdemes E2E-vel őrizni. A logika a
+ * master-prompter `robustness.spec`-jéből emelve (live test-env-en zöldre futtatva), parametrizálva.
+ */
+function FDP_buildRobustnessE2E(opts) {
+    const unknownRoute = opts.unknownRoute ?? '/nonexistent-route-xyz-12345';
+    const notFoundIndicator = opts.notFoundIndicator ?? 'not-found';
+    const protectedFragment = opts.protectedPathFragment ??
+        (opts.protectedRoute ? opts.protectedRoute.replace(/\//g, '') : '');
+    test_1.test.describe('Robustness — auth-guard / 404 / console-health', () => {
+        if (opts.protectedRoute) {
+            (0, test_1.test)('a védett route unauthentikáltan elnavigál (auth-guard)', async ({ page }) => {
+                await page.goto(opts.protectedRoute);
+                // a guard ASYNC lehet (silent-login check) → a redirect a bootstrap UTÁN; a pathname-et figyeljük
+                // (a query-ben benne lehet a védett route mint redirectTo). Ha sosem redirect-el → timeout → (helyes) bukás.
+                await page.waitForURL((url) => !url.pathname.replace(/\//g, '').startsWith(protectedFragment), { timeout: 15_000 });
+                (0, test_1.expect)(new URL(page.url()).pathname.replace(/\//g, '')).not.toContain(protectedFragment);
+                await (0, test_1.expect)(page.locator('body')).toBeVisible();
+            });
+        }
+        (0, test_1.test)('ismeretlen route → not-found kezelés (nem törött oldal)', async ({ page }) => {
+            await page.goto(unknownRoute);
+            await page.waitForLoadState('domcontentloaded');
+            (0, test_1.expect)(page.url()).toContain(notFoundIndicator);
+            await (0, test_1.expect)(page.locator('body')).toBeVisible();
+        });
+        (0, test_1.test)('a landing KRITIKUS JS-hiba nélkül tölt be (console-health)', async ({ page }) => {
+            const errors = [];
+            page.on('console', (msg) => {
+                if (msg.type() === 'error') {
+                    errors.push(msg.text());
+                }
+            });
+            page.on('pageerror', (err) => { errors.push(err.message); });
+            await page.goto(opts.landingRoute);
+            await page.waitForLoadState('networkidle');
+            // csak a KRITIKUS JS-hibákra szigorú (a sima console.error lehet 3rd-party/analytics/404-favicon)
+            const critical = errors.filter((e) => /TypeError|ReferenceError|is not a function|is not defined/.test(e));
+            (0, test_1.expect)(critical, `Kritikus JS-hibák a betöltéskor: ${critical.join(' | ')}`).toHaveLength(0);
+        });
+        (0, test_1.test)('a betöltött oldalnak van title-je (alap struktúra/SEO)', async ({ page }) => {
+            await page.goto(opts.landingRoute);
+            await page.waitForLoadState('domcontentloaded');
+            const title = await page.title();
+            (0, test_1.expect)(title.trim().length).toBeGreaterThan(0);
+        });
+    });
+}
 //# sourceMappingURL=fdp-browser-e2e.util.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fdp-e2e-helpers",
-  "version": "01.15.21",
+  "version": "01.15.22",
   "description": "Shared E2E test helpers for FDP-stack apps. First util: E2E_HardDelete_Util. Stateless utility-collection — NOT a framework.",
   "DyBu_settings": {
     "packageType": "shared-package",
@@ -71,7 +71,7 @@
   ],
   "peerDependencies": {
     "@futdevpro/fsm-dynamo": "1.15.23",
-    "@futdevpro/nts-dynamo": "1.15.46",
+    "@futdevpro/nts-dynamo": "1.15.48",
     "@playwright/test": ">=1.49.0"
   },
   "dependencies": {
@@ -80,9 +80,9 @@
     "tslib": "^2.6.2"
   },
   "devDependencies": {
-    "@futdevpro/dynamo-eslint": "1.15.12",
+    "@futdevpro/dynamo-eslint": "1.15.14",
     "@futdevpro/fsm-dynamo": "1.15.23",
-    "@futdevpro/nts-dynamo": "1.15.46",
+    "@futdevpro/nts-dynamo": "1.15.48",
     "@playwright/test": "^1.49.0",
     "@types/jasmine": "^5.1.5",
     "@typescript-eslint/eslint-plugin": "^8.41.0",