@futdevpro/fdp-e2e-helpers 1.15.18 → 1.15.21

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,24 @@
+/**
+ * `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;
+//# sourceMappingURL=fdp-browser-e2e.util.d.ts.map

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FDP_buildAuthFormsE2E = FDP_buildAuthFormsE2E;
+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 });
+        });
+    });
+}
+//# 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.18",
+  "version": "01.15.21",
   "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",