@futdevpro/fdp-e2e-helpers 1.15.9

package/build/_services/e2e-user-manager.service.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.E2E_UserManagerService = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const nts_dynamo_1 = require("@futdevpro/nts-dynamo");
+const e2e_hard_delete_util_1 = require("../_collections/e2e-hard-delete.util");
+const e2e_unique_generator_util_1 = require("../_collections/e2e-unique-generator.util");
+/**
+ * E2E_UserManagerService — persistent + temporary user-ek kezelese az E2E
+ * teszt-ciklusban.
+ *
+ * Lift-and-shift a fdp-token-service `e2e/src/_shared/_services/e2e-user-manager.service.ts`-bol
+ * (BL-20260518-003). FONTOS valtozasok a token-service eredetijehez kepest:
+ *  - `deleteTemporaryUser()` TODO-stub-jat valodi impl-be hoztuk: most az
+ *    `E2E_HardDelete_Util.deleteAccount()`-ot hivja (BL-20260518-004 + BL-001 osszekoteshez).
+ *  - `getPersistentUser()`-bol az `E2E_ConfigService`-fuggoseget kihagytuk —
+ *    a config explicit `setPersistentUser()` setter-en at kerul be (decoupled
+ *    a config-service-tol, amig BL-005 lift-up nem kerul be a csomagba).
+ *
+ * Pattern: singleton-service `extends DyNTS_SingletonService` — peerDep
+ * @futdevpro/nts-dynamo szukseges. Spec REQ-USER-001 + REQ-USER-002 user-lifecycle.
+ */
+class E2E_UserManagerService extends nts_dynamo_1.DyNTS_SingletonService {
+    /**
+     * Singleton instance getter — peerDep-mentes elerheteloseg a consumer-eknek.
+     */
+    static getInstance() {
+        return E2E_UserManagerService.getSingletonInstance();
+    }
+    /**
+     * Private constructor — defense-in-depth a singleton-enforcement-hez.
+     * Pattern conform a token-service eredetijével + a többi E2E_*Service-szel
+     * (E2E_LoggerService, E2E_ConfigService).
+     */
+    constructor() {
+        super();
+    }
+    persistentUser = null;
+    temporaryUsers = [];
+    // Hard-delete cascade-hez szukseges config (a temporary-user-cleanup-flow)
+    authServiceUrl = null;
+    e2eKey = null;
+    /**
+     * Persistent user explicit setter — a config-service decoupling miatt nincs
+     * implicit config-loader, a consumer adja meg. BL-005 lift-up utan opcionalisan
+     * a config-service is hozhatja.
+     *
+     * @param user - Persistent user adatai (email, username, password, accountId?)
+     */
+    setPersistentUser(user) {
+        if (!user.isPersistent) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                message: 'setPersistentUser: provided user has isPersistent=false',
+                errorCode: 'FDP-E2E-UMS-SPU-001',
+                issuerService: 'E2E_UserManagerService',
+            });
+        }
+        this.persistentUser = user;
+        fsm_dynamo_1.DyFM_Log.info(`[E2E_UserManager] Persistent user set: ${user.email}`);
+    }
+    /**
+     * Hard-delete cascade config beallitasa (a temporary-user-cleanup-hoz).
+     * A consumer cycle-elejen egyszer hivja, utana minden delete ezt hasznalja.
+     *
+     * @param config - authServiceUrl + e2eKey (X-E2E-Key header value)
+     */
+    setHardDeleteConfig(config) {
+        this.authServiceUrl = config.authServiceUrl;
+        this.e2eKey = config.e2eKey;
+    }
+    /**
+     * Persistent user lekerese (cache-elt).
+     *
+     * @returns Persistent user
+     * @throws DyFM_Error ha persistent user meg nincs setelve (setPersistentUser hivas hianyzik)
+     */
+    getPersistentUser() {
+        if (!this.persistentUser) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                message: 'getPersistentUser: no persistent user set — call setPersistentUser() first',
+                errorCode: 'FDP-E2E-UMS-GPU-001',
+                issuerService: 'E2E_UserManagerService',
+            });
+        }
+        return this.persistentUser;
+    }
+    /**
+     * Temporary user letrehozasa egyedi email + username + password generatorral.
+     * A user az `temporaryUsers` listaba kerul cleanup-tracking-hez (cleanupAllTemporaryUsers).
+     *
+     * @param testContext - A teszt/scenario neve (pl. 'registration-flow', 'login-test')
+     * @param accountId - Opcionalis: ha mar letrehozott account, az ID it-t adjuk a hard-delete-hez
+     * @returns A letrehozott (tracking-ba felvett) temporary user
+     */
+    createTemporaryUser(testContext, accountId) {
+        const email = e2e_unique_generator_util_1.E2E_UniqueGenerator_Util.generateUniqueEmail('e2e-user', testContext);
+        const username = e2e_unique_generator_util_1.E2E_UniqueGenerator_Util.generateUniqueUsername('e2e-user', testContext);
+        const password = e2e_unique_generator_util_1.E2E_UniqueGenerator_Util.generateUniquePassword('e2e-pw');
+        const user = {
+            email: email,
+            username: username,
+            password: password,
+            accountId: accountId,
+            isPersistent: false,
+            createdAt: new Date(),
+            testContext: testContext,
+        };
+        this.temporaryUsers.push(user);
+        fsm_dynamo_1.DyFM_Log.info(`[E2E_UserManager] Temporary user created: ${user.email} (testContext=${testContext})`);
+        return user;
+    }
+    /**
+     * Temporary user torlese — hard-delete cascade-pel az auth-service-en at.
+     * A `setHardDeleteConfig()` hivasa szukseges elotte (kulonben dob).
+     *
+     * @param user - A torlendo user. Ha `isPersistent: true`, dob (NEM lehet persistentet torolni).
+     * @throws DyFM_Error ha (a) user persistent, (b) hard-delete config nincs setelve,
+     *         (c) accountId nincs setelve, (d) cascade-delete HTTP hiba.
+     */
+    async deleteTemporaryUser(user) {
+        if (user.isPersistent) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                message: 'Cannot delete persistent user',
+                errorCode: 'FDP-E2E-UMS-DTU-PERS',
+                issuerService: 'E2E_UserManagerService',
+            });
+        }
+        if (!this.authServiceUrl || !this.e2eKey) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                message: 'deleteTemporaryUser: hard-delete config not set — call setHardDeleteConfig() first',
+                errorCode: 'FDP-E2E-UMS-DTU-NOCONFIG',
+                issuerService: 'E2E_UserManagerService',
+            });
+        }
+        if (!user.accountId) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                message: `deleteTemporaryUser: user has no accountId set (email=${user.email}) — cannot cascade-delete`,
+                errorCode: 'FDP-E2E-UMS-DTU-NOID',
+                issuerService: 'E2E_UserManagerService',
+            });
+        }
+        await e2e_hard_delete_util_1.E2E_HardDelete_Util.deleteAccount({
+            authServiceUrl: this.authServiceUrl,
+            accountId: user.accountId,
+            e2eKey: this.e2eKey,
+        });
+        const index = this.temporaryUsers.findIndex((u) => u.email === user.email);
+        if (index !== -1) {
+            this.temporaryUsers.splice(index, 1);
+        }
+        fsm_dynamo_1.DyFM_Log.info(`[E2E_UserManager] Temporary user hard-deleted: ${user.email}`);
+    }
+    /**
+     * Osszes tracking-ba felvett temporary user hard-delete-cascade-pel torlese.
+     * Cycle-vegi cleanup — hibatkereles: egy user fail-e NEM blokkolja a tobbit
+     * (try/catch per-user + warn log).
+     */
+    async cleanupAllTemporaryUsers() {
+        const usersToCleanup = [...this.temporaryUsers];
+        fsm_dynamo_1.DyFM_Log.info(`[E2E_UserManager] Cleaning up ${usersToCleanup.length} temporary user(s)`);
+        let successCount = 0;
+        let failCount = 0;
+        for (const user of usersToCleanup) {
+            try {
+                await this.deleteTemporaryUser(user);
+                successCount++;
+            }
+            catch (error) {
+                failCount++;
+                fsm_dynamo_1.DyFM_Log.H_error(`[E2E_UserManager] Failed to delete temporary user ${user.email}: ${error.message}`);
+            }
+        }
+        fsm_dynamo_1.DyFM_Log.info(`[E2E_UserManager] Cleanup complete: ${successCount} success, ${failCount} fail`);
+    }
+    /**
+     * Tracking-list lekerese (read-only) — debug/inspection celokra.
+     */
+    getTemporaryUsers() {
+        return [...this.temporaryUsers];
+    }
+}
+exports.E2E_UserManagerService = E2E_UserManagerService;
+//# sourceMappingURL=e2e-user-manager.service.js.map

package/build/index.d.ts

@@ -0,0 +1,9 @@
+export * from './_collections/e2e-hard-delete.util';
+export * from './_collections/e2e-unique-generator.util';
+export * from './_services/e2e-config.service';
+export * from './_services/e2e-logger.service';
+export * from './_services/e2e-user-manager.service';
+export * from './_models/interfaces/e2e-hard-delete-options.interface';
+export * from './_models/interfaces/e2e-test-config.interface';
+export * from './_models/interfaces/e2e-user.interface';
+//# sourceMappingURL=index.d.ts.map

package/build/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// COLLECTIONS / UTILS
+tslib_1.__exportStar(require("./_collections/e2e-hard-delete.util"), exports);
+tslib_1.__exportStar(require("./_collections/e2e-unique-generator.util"), exports);
+// SERVICES
+tslib_1.__exportStar(require("./_services/e2e-config.service"), exports);
+tslib_1.__exportStar(require("./_services/e2e-logger.service"), exports);
+tslib_1.__exportStar(require("./_services/e2e-user-manager.service"), exports);
+// INTERFACES
+tslib_1.__exportStar(require("./_models/interfaces/e2e-hard-delete-options.interface"), exports);
+tslib_1.__exportStar(require("./_models/interfaces/e2e-test-config.interface"), exports);
+tslib_1.__exportStar(require("./_models/interfaces/e2e-user.interface"), exports);
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@futdevpro/fdp-e2e-helpers",
+  "version": "01.15.9",
+  "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",
+    "tgzFolderName": "fdp-e2e-helpers",
+    "systemName": "fdp-e2e"
+  },
+  "author": "Future Development Program Ltd.",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/futdevpro/fdp-e2e-helpers/issues"
+  },
+  "homepage": "futdevpro.hu",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/futdevpro/fdp-e2e-helpers.git"
+  },
+  "keywords": [
+    "e2e",
+    "playwright",
+    "testing",
+    "fdp",
+    "futdevpro",
+    "hard-delete",
+    "user-management"
+  ],
+  "scripts": {
+    "prep": "npm i -g pnpm rimraf nodemon && pnpm i",
+    "preprep-setup-safechain-windows": "iex (iwr \"https://raw.githubusercontent.com/AikidoSec/safe-chain/main/install-scripts/install-safe-chain.ps1\" -UseBasicParsing)",
+    "preprep-setup-safechain-linux": "curl -fsSL https://raw.githubusercontent.com/AikidoSec/safe-chain/main/install-scripts/install-safe-chain.sh | sh",
+    "start": "npm run prep && nodemon",
+    "deploy": "npm run build",
+    "clean-deploy": "npm run clean && npm run build-all",
+    "build": "npm run build-base && jasmine && npm publish",
+    "build-tgz": "npm run build-base && jasmine && npm pack && move ./*.tgz ../tgz-collection/fdp-e2e-helpers",
+    "build-all": "npm run build-tgz && npm run build-base",
+    "build-base": "rimraf ./build && npx tsc",
+    "build-clean": "npm run clean && npm run build-base",
+    "build-n-test": "pnpm i && npm run build-tgz",
+    "clean": "rimraf ./build && rimraf package-lock.json && rimraf ./node_modules",
+    "test": "npm run build-base && jasmine",
+    "test-clean": "npm run build-clean && jasmine",
+    "start-clean": "npm run clean && npm run start",
+    "nodemon-run": "npm run build-tgz",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "validate:imports": "dynamo-validate-imports",
+    "validate:naming": "dynamo-validate-naming",
+    "prepare": "husky"
+  },
+  "main": "./build/index.js",
+  "module": "./build/index.js",
+  "types": "./build/index.d.ts",
+  "typings": "./build/index.d.ts",
+  "exports": {
+    ".": {
+      "default": "./build/index.js",
+      "module": "./build/index.js",
+      "types": "./build/index.d.ts",
+      "typings": "./build/index.d.ts"
+    }
+  },
+  "files": [
+    "build/**/*.js",
+    "build/**/*.d.ts",
+    "!build/**/*.spec.*",
+    "README.md",
+    "HOWTO.md"
+  ],
+  "peerDependencies": {
+    "@futdevpro/fsm-dynamo": ">=1.15.0",
+    "@futdevpro/nts-dynamo": ">=1.15.0"
+  },
+  "dependencies": {
+    "axios": "~1.8.1",
+    "dotenv": "^16.4.5",
+    "tslib": "^2.6.2"
+  },
+  "devDependencies": {
+    "@futdevpro/dynamo-eslint": "1.15.10",
+    "@futdevpro/fsm-dynamo": "1.15.13",
+    "@futdevpro/nts-dynamo": "1.15.31",
+    "@types/jasmine": "^5.1.5",
+    "@typescript-eslint/eslint-plugin": "^8.41.0",
+    "@typescript-eslint/parser": "^8.41.0",
+    "eslint": "^9.34.0",
+    "eslint-plugin-import": "^2.29.0",
+    "eslint-plugin-jsdoc": "^48.0.0",
+    "eslint-plugin-prettier": "^5.1.3",
+    "husky": "^9.1.7",
+    "jasmine": "5.10.0",
+    "jasmine-ts": "^0.4.0",
+    "prettier": "^3.3.0",
+    "typescript": "~5.5.4"
+  }
+}