@futdevpro/fdp-e2e-helpers 1.15.19 → 1.15.22

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

@@ -0,0 +1,57 @@
+import { defineConfig } from '@playwright/test';
+/**
+ * `fdp-api-e2e.util` — **közös API-E2E helperek** a backend microservice-ek (auth, ftp, …) Playwright
+ * API-tesztjeihez (böngésző NÉLKÜL, a `request` fixture-rel).
+ *
+ * Cél: a per-rendszer e2e-scaffold (playwright.config + global-setup + server-status spec) NE duplikálódjon —
+ * minden microservice innen örökli. Használat egy fogyasztóban:
+ *
+ * ```ts
+ * // playwright.config.ts
+ * export default FDP_createApiE2EConfig({
+ *   serverBaseURL: process.env.E2E_SERVER_URL || 'http://localhost:48005',
+ *   globalSetup: require.resolve('./src/_shared/_fixtures/e2e-global-setup'),
+ * });
+ *
+ * // src/_shared/_fixtures/e2e-global-setup.ts
+ * import { FDP_apiHealthCheck } from '@futdevpro/fdp-e2e-helpers';
+ * export default async () => FDP_apiHealthCheck(process.env.E2E_SERVER_URL || 'http://localhost:48005', 'auth');
+ *
+ * // src/_modules/server-status/server-status.spec.ts
+ * import { FDP_buildServerStatusE2E } from '@futdevpro/fdp-e2e-helpers';
+ * FDP_buildServerStatusE2E({ issuerSystem: 'auth' });
+ * ```
+ */
+/** A `FDP_createApiE2EConfig` opciói. */
+export interface FDP_ApiE2EConfig_Options {
+    /** A cél szerver base-URL-je (lokál vagy test-env, jellemzően `process.env.E2E_SERVER_URL` fallback-kel). */
+    serverBaseURL: string;
+    /** A spec-ek könyvtára. Default: `./src/_modules`. */
+    testDir?: string;
+    /** A global-setup modul-útja (`require.resolve(...)`). Opcionális (jellemzően a health-check). */
+    globalSetup?: string;
+}
+/**
+ * Egységes Playwright **API-E2E** config (böngésző nélkül, JSON-Accept, önaláírt-cert-toleráns).
+ * @description a fogyasztó `export default FDP_createApiE2EConfig({...})`-tal használja
+ */
+export declare function FDP_createApiE2EConfig(opts: FDP_ApiE2EConfig_Options): ReturnType<typeof defineConfig>;
+/**
+ * Soft API-health-check global-setupnak (NEM fatális): a `/api/server/status`-t hiteli, és jelzi ha a
+ * szerver nem érhető el, de nem dobja el a futást.
+ * @description a fogyasztó global-setupja: `export default () => FDP_apiHealthCheck(url, 'auth')`
+ */
+export declare function FDP_apiHealthCheck(serverBaseURL: string, systemName?: string): Promise<void>;
+/** A `FDP_buildServerStatusE2E` opciói. */
+export interface FDP_ServerStatusE2E_Options {
+    /** A rendszer azonosítója, amit a status-body issuer-jelzésében ellenőrzünk (pl. `'auth'`, `'ftp'`). */
+    issuerSystem: string;
+    /** A status-endpoint útja. Default: `/api/server/status`. */
+    statusPath?: string;
+}
+/**
+ * Beregisztrálja a **standard server-status API-E2E** teszteket (status 200 + issuer-system cross-wiring-check
+ * + unknown-route graceful). A fogyasztó spec-je: `FDP_buildServerStatusE2E({ issuerSystem: 'auth' })`.
+ */
+export declare function FDP_buildServerStatusE2E(opts: FDP_ServerStatusE2E_Options): void;
+//# sourceMappingURL=fdp-api-e2e.util.d.ts.map

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

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FDP_createApiE2EConfig = FDP_createApiE2EConfig;
+exports.FDP_apiHealthCheck = FDP_apiHealthCheck;
+exports.FDP_buildServerStatusE2E = FDP_buildServerStatusE2E;
+const test_1 = require("@playwright/test");
+/**
+ * Egységes Playwright **API-E2E** config (böngésző nélkül, JSON-Accept, önaláírt-cert-toleráns).
+ * @description a fogyasztó `export default FDP_createApiE2EConfig({...})`-tal használja
+ */
+function FDP_createApiE2EConfig(opts) {
+    return (0, test_1.defineConfig)({
+        testDir: opts.testDir ?? './src/_modules',
+        timeout: 60_000,
+        expect: { timeout: 10_000 },
+        fullyParallel: false,
+        forbidOnly: Boolean(process.env.CI),
+        retries: 0,
+        workers: 1,
+        reporter: [
+            ['json', { outputFile: 'test-results/results.json' }],
+            ['list'],
+        ],
+        globalSetup: opts.globalSetup,
+        use: {
+            baseURL: opts.serverBaseURL,
+            ignoreHTTPSErrors: true,
+            extraHTTPHeaders: { 'Accept': 'application/json' },
+        },
+        projects: [
+            { name: 'api', use: { baseURL: opts.serverBaseURL } },
+        ],
+    });
+}
+/**
+ * Soft API-health-check global-setupnak (NEM fatális): a `/api/server/status`-t hiteli, és jelzi ha a
+ * szerver nem érhető el, de nem dobja el a futást.
+ * @description a fogyasztó global-setupja: `export default () => FDP_apiHealthCheck(url, 'auth')`
+ */
+async function FDP_apiHealthCheck(serverBaseURL, systemName = 'service') {
+    const statusUrl = `${serverBaseURL.replace(/\/+$/, '')}/api/server/status`;
+    try {
+        const response = await fetch(statusUrl, {
+            method: 'GET',
+            signal: AbortSignal.timeout(8000),
+        });
+        if (!response.ok) {
+            console.warn(`[E2E] ${systemName} status non-OK (${response.status}) @ ${statusUrl}`);
+        }
+        else {
+            console.log(`[E2E] Global setup OK — ${systemName} reachable @ ${serverBaseURL}`);
+        }
+    }
+    catch (error) {
+        console.warn(`[E2E] ${systemName} nem elérhető (${statusUrl}): ${error.message}`);
+    }
+}
+/**
+ * Beregisztrálja a **standard server-status API-E2E** teszteket (status 200 + issuer-system cross-wiring-check
+ * + unknown-route graceful). A fogyasztó spec-je: `FDP_buildServerStatusE2E({ issuerSystem: 'auth' })`.
+ */
+function FDP_buildServerStatusE2E(opts) {
+    const statusPath = opts.statusPath ?? '/api/server/status';
+    test_1.test.describe(`API — server-status / routing (${opts.issuerSystem})`, () => {
+        (0, test_1.test)(`GET ${statusPath} → 200 + JSON body`, async ({ request }) => {
+            const response = await request.get(statusPath);
+            (0, test_1.expect)(response.status(), 'a status-endpoint elérhető és 200-at ad').toBe(200);
+            const body = await response.json();
+            (0, test_1.expect)(body, 'a status JSON-body nem üres').toBeTruthy();
+        });
+        (0, test_1.test)(`a status a(z) "${opts.issuerSystem}" issuer-system-et jelzi (nincs cross-wiring)`, async ({ request }) => {
+            const response = await request.get(statusPath);
+            (0, test_1.expect)(response.status()).toBe(200);
+            const body = await response.json();
+            const serialized = JSON.stringify(body).toLowerCase();
+            (0, test_1.expect)(serialized, `a status-body issuer-jelzése: ${serialized.slice(0, 200)}`)
+                .toContain(opts.issuerSystem.toLowerCase());
+        });
+        (0, test_1.test)('ismeretlen API-route → nem 500 (graceful)', async ({ request }) => {
+            const response = await request.get('/api/__fdp_nonexistent_route_xyz_12345');
+            (0, test_1.expect)(response.status(), `ismeretlen route status: ${response.status()}`).toBeLessThan(500);
+        });
+    });
+}
+//# sourceMappingURL=fdp-api-e2e.util.js.map

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

@@ -0,0 +1,50 @@
+/**
+ * `fdp-browser-e2e.util` — **közös böngésző-E2E helperek** a frontendes rendszerek (master-prompter, futdevpro,
+ * token-service, …) Playwright page-tesztjeihez. Cél: a visszatérő smoke-minták NE duplikálódjanak rendszerenként.
+ *
+ * Használat egy fogyasztó spec-ben:
+ * ```ts
+ * import { FDP_buildAuthFormsE2E } from '@futdevpro/fdp-e2e-helpers';
+ * FDP_buildAuthFormsE2E({ loginRoute: '/landing/login', registerRoute: '/landing/register' });
+ * ```
+ */
+/** A `FDP_buildAuthFormsE2E` opciói. */
+export interface FDP_AuthFormsE2E_Options {
+    /** A login-oldal route-ja (pl. `/landing/login`). */
+    loginRoute: string;
+    /** A register-oldal route-ja (pl. `/landing/register`). */
+    registerRoute: string;
+}
+/**
+ * Beregisztrálja a **standard auth-UI form-struktúra** smoke-okat (no-auth, no-spend): a login + register oldal
+ * renderel jelszó-mezőt + submit-gombot, a login-on van email/text input. Egy törött login-form = launch-blokkoló,
+ * 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

@@ -0,0 +1,93 @@
+"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
+ * renderel jelszó-mezőt + submit-gombot, a login-on van email/text input. Egy törött login-form = launch-blokkoló,
+ * ezért érdemes E2E-vel őrizni. A fogyasztó: `FDP_buildAuthFormsE2E({ loginRoute, registerRoute })`.
+ */
+function FDP_buildAuthFormsE2E(opts) {
+    test_1.test.describe('Auth UI — login / register form-struktúra', () => {
+        (0, test_1.test)('a login-oldal renderel jelszó-mezőt + submit-gombot', async ({ page }) => {
+            await page.goto(opts.loginRoute);
+            await page.waitForLoadState('networkidle');
+            const passwordField = page.locator('input[type="password"]');
+            await (0, test_1.expect)(passwordField.first(), 'a login-formon van jelszó-mező').toBeVisible({ timeout: 10_000 });
+            const submitish = page.locator('button, input[type="submit"]');
+            (0, test_1.expect)(await submitish.count(), 'a login-oldalon van legalább egy gomb/submit').toBeGreaterThan(0);
+        });
+        (0, test_1.test)('a register-oldal renderel jelszó-mezőt + submit-gombot', async ({ page }) => {
+            await page.goto(opts.registerRoute);
+            await page.waitForLoadState('networkidle');
+            const passwordField = page.locator('input[type="password"]');
+            await (0, test_1.expect)(passwordField.first(), 'a register-formon van jelszó-mező').toBeVisible({ timeout: 10_000 });
+            const submitish = page.locator('button, input[type="submit"]');
+            (0, test_1.expect)(await submitish.count(), 'a register-oldalon van legalább egy gomb/submit').toBeGreaterThan(0);
+        });
+        (0, test_1.test)('a login-oldalon van szöveges/email beviteli mező (nem csak jelszó)', async ({ page }) => {
+            await page.goto(opts.loginRoute);
+            await page.waitForLoadState('networkidle');
+            const textInputs = page.locator('input:not([type="password"]):not([type="hidden"]):not([type="checkbox"])');
+            await (0, test_1.expect)(textInputs.first(), 'a login-formon van szöveges/email mező').toBeVisible({ timeout: 10_000 });
+        });
+    });
+}
+/**
+ * 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/build/index.d.ts

@@ -1,6 +1,8 @@
 export * from './_collections/e2e-hard-delete.util';
 export * from './_collections/e2e-unique-generator.util';
 export * from './_collections/fdp-cwv-collector.util';
+export * from './_collections/fdp-api-e2e.util';
+export * from './_collections/fdp-browser-e2e.util';
 export * from './_services/e2e-config.service';
 export * from './_services/e2e-logger.service';
 export * from './_services/e2e-login-helper.service';

package/build/index.js

@@ -5,6 +5,8 @@ const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./_collections/e2e-hard-delete.util"), exports);
 tslib_1.__exportStar(require("./_collections/e2e-unique-generator.util"), exports);
 tslib_1.__exportStar(require("./_collections/fdp-cwv-collector.util"), exports);
+tslib_1.__exportStar(require("./_collections/fdp-api-e2e.util"), exports);
+tslib_1.__exportStar(require("./_collections/fdp-browser-e2e.util"), exports);
 // SERVICES
 tslib_1.__exportStar(require("./_services/e2e-config.service"), exports);
 tslib_1.__exportStar(require("./_services/e2e-logger.service"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fdp-e2e-helpers",
-  "version": "01.15.19",
+  "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",