@futdevpro/nts-dynamo 1.15.122 → 1.15.127

package/.dynamo/logs/cicd-pipeline/status.json

@@ -1,94 +0,0 @@
-{
-  "pid": 29648,
-  "startedAt": "2026-07-28T22:36:44.892Z",
-  "startedAtMs": 1785278204892,
-  "phase": "npm-publish",
-  "pipelineComplete": false,
-  "serverRunning": false,
-  "totalDurationSec": null,
-  "restartPending": false,
-  "steps": {
-    "validate-secrets": {
-      "status": "ok",
-      "startedAt": "2026-07-28T22:36:44.907Z",
-      "logLineStart": 2,
-      "logLineEnd": 8,
-      "durationSec": 0.2
-    },
-    "discord-start": {
-      "status": "ok",
-      "startedAt": "2026-07-28T22:36:46.140Z",
-      "logLineStart": 9,
-      "logLineEnd": 14,
-      "durationSec": 3.2
-    },
-    "pre-flight": {
-      "status": "ok",
-      "startedAt": "2026-07-28T22:36:50.321Z",
-      "logLineStart": 15,
-      "logLineEnd": 17,
-      "durationSec": 0.6
-    },
-    "install": {
-      "status": "ok",
-      "startedAt": "2026-07-28T22:36:51.905Z",
-      "logLineStart": 18,
-      "logLineEnd": 99,
-      "durationSec": 19.3
-    },
-    "check-dev-leftovers": {
-      "status": "ok",
-      "startedAt": "2026-07-28T22:37:12.286Z",
-      "logLineStart": 100,
-      "logLineEnd": 107,
-      "durationSec": 3.9
-    },
-    "build": {
-      "status": "ok",
-      "startedAt": "2026-07-28T22:37:17.221Z",
-      "logLineStart": 108,
-      "logLineEnd": 109,
-      "durationSec": 25.4
-    },
-    "test": {
-      "status": "ok",
-      "startedAt": "2026-07-28T22:37:43.612Z",
-      "logLineStart": 110,
-      "logLineEnd": 2839,
-      "durationSec": 26.5,
-      "testSummary": {
-        "totalSpecs": 1607,
-        "failures": 0,
-        "passed": 1607,
-        "testDurationSec": 7.214
-      },
-      "errors": [
-        {
-          "line": 1627,
-          "text": "(checkDbReadiness) diagnostics collection failed (non-fatal) Error: boom",
-          "details": "at runNext (/tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8355:16)\nat /tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8361:11\nat /tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8241:9\nat UserContext.<anonymous> (/tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/build/_modules/server/server-status/server-status.control-service.spec.js:507:68)\nat QueueRunner.attempt (/tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8414:40)\nat QueueRunner.run (/tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8452:27)\nat runNext (/tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8355:16)\nat /tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8361:11\nat /tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8241:9",
-          "detailLineEnd": 1633
-        },
-        {
-          "line": 1634,
-          "text": "...(checkDbReadiness) diagnostics collection failed (non-fatal) Error: diag boom",
-          "details": "at runNext (/tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8355:16)\nat /tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8361:11\nat /tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/node_modules/.pnpm/jasmine-core@5.10.0/node_modules/jasmine-core/lib/jasmine-core/jasmine.js:8241:9\nat Object.get host [as host] (/tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/build/_modules/server/server-status/server-status.control-service.spec.js:487:36)\nat TestServerStatusControlService.checkDbReadiness (/tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/build/_modules/server/server-status/server-status.control-service.js:187:29)\nat async UserContext.<anonymous> (/tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/build/_modules/server/server-status/server-status.control-service.spec.js:490:28)",
-          "detailLineEnd": 1637
-        },
-        {
-          "line": 1811,
-          "text": "[dynts-migration] FAILED bad Error: boom",
-          "details": "at Object.run (/tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/build/_services/core/migration-runner.service.spec.js:67:50)\nat DyNTS_Migration_Runner.runPending (/tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/build/_services/core/migration-runner.service.js:52:49)\nat async UserContext.<anonymous> (/tmp/pipeline-runs/f3e5c9c2-a328-4e84-88e1-5d2dd12df92d/build/_services/core/migration-runner.service.spec.js:70:25)",
-          "detailLineEnd": 1814
-        }
-      ]
-    },
-    "npm-publish": {
-      "status": "running",
-      "startedAt": "2026-07-28T22:38:11.349Z",
-      "logLineStart": 2840,
-      "logLineEnd": null,
-      "durationSec": null
-    }
-  }
-}

package/build/_modules/ftp/_collections/ftp-url-signer.util.d.ts

@@ -1,37 +0,0 @@
-/**
- * FTP signed-URL ALÁÍRÓ (deep/generikus — `@futdevpro/nts-dynamo`).
- *
- * A böngésző-serve (`<img src>` / letöltő-link) nem tud Bearer-headert küldeni, ezért az
- * `fdp-ftp-service` HTTP-kiszolgálása rövid-/közép-életű **aláírt URL**-lel auth-ol. Ez az util a
- * megosztott titokkal HMAC-SHA256-tal aláírja a `path + exp`-et, és előállítja a serve-URL-t.
- *
- * ⚠️ Az algoritmusnak **BIT-RE egyeznie kell** az `fdp-ftp-service` `FtpUrlSignature_Util`-jával
- * (kanonikus string: `<normalizedPath>\n<expMs>`; normalizálás: leading-slash le + `\`→`/`), különben
- * az ftp elutasítja a signature-t.
- *
- * **PURE (ADR-004):** ez a modul NEM importál `fdp-templates`-et — a `secret`/`serveBaseUrl` a hívó-
- * (consumer-) oldalról jön paraméterként. Így minden FDP-server újrahasználhatja, egyetlen példányban.
- */
-export declare class DyNTS_FtpUrlSigner_Util {
-    /** Path normalizálás — pontosan az ftp-serve normalizálása (leading-slash le, `\`→`/`). */
-    static normalizePath(filePath: string): string;
-    /**
-     * Kanonikus UPLOAD-cél string: `accountId/folderPath/fileName`. A szerver-szerver (app→ftp) upload
-     * ezt írja alá → az ftp ugyanígy építi + validálja. Bit-azonos kell legyen a két oldalon.
-     */
-    static uploadTarget(accountId: string, folderPath: string, fileName: string): string;
-    /** HMAC-SHA256 a `<normalizedPath>\n<expMs>`-en → hex (az ftp ezt validálja). */
-    static sign(filePath: string, expMs: number, secret: string): string;
-    /**
-     * Teljes aláírt serve-URL egy ftp-path-ból: `<serveBaseUrl>/<normalizedPath>?exp=<ms>&sig=<hex>`.
-     * Üres `secret` → üres string (a gate inaktív; a hívó dönt a fallback-ről). `nowMs` injektálható teszthez.
-     */
-    static buildSignedServeUrl(params: {
-        serveBaseUrl: string;
-        ftpPath: string;
-        ttlMs: number;
-        secret: string;
-        nowMs?: number;
-    }): string;
-}
-//# sourceMappingURL=ftp-url-signer.util.d.ts.map

package/build/_modules/ftp/_collections/ftp-url-signer.util.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ftp-url-signer.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ftp/_collections/ftp-url-signer.util.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,qBAAa,uBAAuB;IAElC,2FAA2F;IAC3F,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI9C;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIpF,iFAAiF;IACjF,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAQpE;;;OAGG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE;QACjC,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,MAAM;CASX"}

package/build/_modules/ftp/_collections/ftp-url-signer.util.js

@@ -1,57 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_FtpUrlSigner_Util = void 0;
-const tslib_1 = require("tslib");
-const Crypto = tslib_1.__importStar(require("crypto"));
-/**
- * FTP signed-URL ALÁÍRÓ (deep/generikus — `@futdevpro/nts-dynamo`).
- *
- * A böngésző-serve (`<img src>` / letöltő-link) nem tud Bearer-headert küldeni, ezért az
- * `fdp-ftp-service` HTTP-kiszolgálása rövid-/közép-életű **aláírt URL**-lel auth-ol. Ez az util a
- * megosztott titokkal HMAC-SHA256-tal aláírja a `path + exp`-et, és előállítja a serve-URL-t.
- *
- * ⚠️ Az algoritmusnak **BIT-RE egyeznie kell** az `fdp-ftp-service` `FtpUrlSignature_Util`-jával
- * (kanonikus string: `<normalizedPath>\n<expMs>`; normalizálás: leading-slash le + `\`→`/`), különben
- * az ftp elutasítja a signature-t.
- *
- * **PURE (ADR-004):** ez a modul NEM importál `fdp-templates`-et — a `secret`/`serveBaseUrl` a hívó-
- * (consumer-) oldalról jön paraméterként. Így minden FDP-server újrahasználhatja, egyetlen példányban.
- */
-class DyNTS_FtpUrlSigner_Util {
-    /** Path normalizálás — pontosan az ftp-serve normalizálása (leading-slash le, `\`→`/`). */
-    static normalizePath(filePath) {
-        return filePath.replace(/^\/+/, '').replace(/\\/g, '/');
-    }
-    /**
-     * Kanonikus UPLOAD-cél string: `accountId/folderPath/fileName`. A szerver-szerver (app→ftp) upload
-     * ezt írja alá → az ftp ugyanígy építi + validálja. Bit-azonos kell legyen a két oldalon.
-     */
-    static uploadTarget(accountId, folderPath, fileName) {
-        return `${accountId}/${folderPath}/${fileName}`;
-    }
-    /** HMAC-SHA256 a `<normalizedPath>\n<expMs>`-en → hex (az ftp ezt validálja). */
-    static sign(filePath, expMs, secret) {
-        const normalizedPath = DyNTS_FtpUrlSigner_Util.normalizePath(filePath);
-        return Crypto
-            .createHmac('sha256', secret)
-            .update(`${normalizedPath}\n${expMs}`, 'utf8')
-            .digest('hex');
-    }
-    /**
-     * Teljes aláírt serve-URL egy ftp-path-ból: `<serveBaseUrl>/<normalizedPath>?exp=<ms>&sig=<hex>`.
-     * Üres `secret` → üres string (a gate inaktív; a hívó dönt a fallback-ről). `nowMs` injektálható teszthez.
-     */
-    static buildSignedServeUrl(params) {
-        if (!params.secret) {
-            return '';
-        }
-        const now = typeof params.nowMs === 'number' ? params.nowMs : Date.now();
-        const expMs = now + params.ttlMs;
-        const normalizedPath = DyNTS_FtpUrlSigner_Util.normalizePath(params.ftpPath);
-        const sig = DyNTS_FtpUrlSigner_Util.sign(normalizedPath, expMs, params.secret);
-        const base = params.serveBaseUrl.replace(/\/+$/, '');
-        return `${base}/${normalizedPath}?exp=${expMs}&sig=${sig}`;
-    }
-}
-exports.DyNTS_FtpUrlSigner_Util = DyNTS_FtpUrlSigner_Util;
-//# sourceMappingURL=ftp-url-signer.util.js.map

package/build/_modules/ftp/_collections/ftp-url-signer.util.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ftp-url-signer.util.js","sourceRoot":"","sources":["../../../../src/_modules/ftp/_collections/ftp-url-signer.util.ts"],"names":[],"mappings":";;;;AAAA,uDAAiC;AAEjC;;;;;;;;;;;;;GAaG;AACH,MAAa,uBAAuB;IAElC,2FAA2F;IAC3F,MAAM,CAAC,aAAa,CAAC,QAAgB;QACnC,OAAO,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,SAAiB,EAAE,UAAkB,EAAE,QAAgB;QACzE,OAAO,GAAG,SAAS,IAAI,UAAU,IAAI,QAAQ,EAAE,CAAC;IAClD,CAAC;IAED,iFAAiF;IACjF,MAAM,CAAC,IAAI,CAAC,QAAgB,EAAE,KAAa,EAAE,MAAc;QACzD,MAAM,cAAc,GAAW,uBAAuB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC/E,OAAO,MAAM;aACV,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC;aAC5B,MAAM,CAAC,GAAG,cAAc,KAAK,KAAK,EAAE,EAAE,MAAM,CAAC;aAC7C,MAAM,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAM1B;QACC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAAC,OAAO,EAAE,CAAC;QAAC,CAAC;QAClC,MAAM,GAAG,GAAW,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACjF,MAAM,KAAK,GAAW,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC;QACzC,MAAM,cAAc,GAAW,uBAAuB,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrF,MAAM,GAAG,GAAW,uBAAuB,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACvF,MAAM,IAAI,GAAW,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7D,OAAO,GAAG,IAAI,IAAI,cAAc,QAAQ,KAAK,QAAQ,GAAG,EAAE,CAAC;IAC7D,CAAC;CACF;AA3CD,0DA2CC"}

package/build/_modules/ftp/_services/ftp-service.api-service.d.ts

@@ -1,63 +0,0 @@
-/**
- * FTP-kliens KONFIG (a consumer adja át — PURE: nincs fdp-templates-függés).
- * A `fdp-ftp-service` URL-jei + a megosztott aláíró-titok a hívó-oldalról jönnek.
- */
-export interface DyNTS_FtpService_Config {
-    /** az `fdp-ftp-service` API base-URL a szerver-szerver feltöltéshez (pl. `FDP_ftpServiceApiEnv_settings.baseUrl.fromBE`). */
-    apiBaseUrl: string;
-    /** a publikus serve-host az aláírt letöltő-URL-ekhez (pl. `FDP_ftpServiceApiEnv_settings.baseUrl.siteAddress`). */
-    serveBaseUrl: string;
-    /** a megosztott HMAC-titok (env-var `FTP_URL_SIGNING_SECRET`, MÁR létező). Üres → a serve-gate inaktív. */
-    signingSecret: string;
-    /** az upload-endpoint (default `/files/upload`). */
-    uploadFileEndpoint?: string;
-}
-/** FTP-feltöltés bemenete. */
-export interface DyNTS_FtpService_UploadFile_Input {
-    accountId: string;
-    folderPath: string;
-    fileName: string;
-    fileBuffer: Buffer;
-}
-/** FTP-feltöltés válasza. */
-export interface DyNTS_FtpService_UploadFile_Response {
-    filePath: string;
-    ftpPath: string;
-}
-/**
- * FTP Service API kliens (deep/generikus — `@futdevpro/nts-dynamo`).
- * @description A szerver-oldali FTP-KLIENS: a meglévő `fdp-ftp-service` tároló-szervert HÍVJA — fájlt tölt
- *   fel (signed upload), és aláírt serve-URL-t épít. **NEM tartalmaz FTP-szervert.** A korábban az
- *   MP-be / token-service-be duplikált FTP-kliens EGYETLEN, flotta-közös kiváltása.
- *
- *   **PURE (ADR-004):** a config (URL-ek + titok) a `DyNTS_FtpService_Config`-ból, a hívó adja át —
- *   nincs `fdp-templates`-import. Nem singleton: minden consumer a saját config-jával példányosít.
- *
- * @example
- * ```ts
- * const ftp: DyNTS_FtpService_ApiService = new DyNTS_FtpService_ApiService({
- *   apiBaseUrl: FDP_ftpServiceApiEnv_settings.baseUrl.fromBE,
- *   serveBaseUrl: FDP_ftpServiceApiEnv_settings.baseUrl.siteAddress,
- *   signingSecret: process.env.FTP_URL_SIGNING_SECRET || '',
- * });
- * const { ftpPath } = await ftp.uploadFile({ accountId, folderPath: 'invoices/<userId>', fileName, fileBuffer });
- * const url: string = ftp.buildSignedServeUrl(ftpPath);
- * ```
- */
-export declare class DyNTS_FtpService_ApiService {
-    private readonly config;
-    constructor(config: DyNTS_FtpService_Config);
-    private get uploadFileEndpoint();
-    /**
-     * Fájl feltöltése az `fdp-ftp-service`-re (signed, szerver-szerver).
-     * @description A kanonikus upload-célt + lejáratot HMAC-aláírjuk a megosztott titokkal; az ftp ezt
-     *   validálja (a signature a KONKRÉT account+path-hoz köt — más account-ra nem replay-elhető).
-     */
-    uploadFile(input: DyNTS_FtpService_UploadFile_Input): Promise<DyNTS_FtpService_UploadFile_Response>;
-    /**
-     * Aláírt serve-URL egy `ftpPath`-ból (böngésző-letöltéshez). Üres titok → üres string (gate inaktív).
-     * @param ttlMs opcionális egyedi élettartam; default 30 nap.
-     */
-    buildSignedServeUrl(ftpPath: string, ttlMs?: number): string;
-}
-//# sourceMappingURL=ftp-service.api-service.d.ts.map

package/build/_modules/ftp/_services/ftp-service.api-service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ftp-service.api-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ftp/_services/ftp-service.api-service.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,6HAA6H;IAC7H,UAAU,EAAE,MAAM,CAAC;IACnB,mHAAmH;IACnH,YAAY,EAAE,MAAM,CAAC;IACrB,2GAA2G;IAC3G,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,8BAA8B;AAC9B,MAAM,WAAW,iCAAiC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,6BAA6B;AAC7B,MAAM,WAAW,oCAAoC;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,2BAA2B;IAEtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;gBAErC,MAAM,EAAE,uBAAuB;IAI3C,OAAO,KAAK,kBAAkB,GAE7B;IAED;;;;OAIG;IACG,UAAU,CAAC,KAAK,EAAE,iCAAiC,GAAG,OAAO,CAAC,oCAAoC,CAAC;IA8BzG;;;OAGG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAgC,GAAG,MAAM;CAQtF"}

package/build/_modules/ftp/_services/ftp-service.api-service.js

@@ -1,84 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_FtpService_ApiService = void 0;
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const api_service_1 = require("../../../_services/core/api.service");
-const api_call_params_control_model_1 = require("../../../_models/control-models/api-call-params.control-model");
-const ftp_url_signer_util_1 = require("../_collections/ftp-url-signer.util");
-/** A signed UPLOAD-aláírás érvényessége (10 perc) — a szerver-szerver app→ftp feltöltés szinkron, rövid ablak elég. */
-const FTP_SIGNED_UPLOAD_TTL_MS = 10 * 60 * 1000;
-/** A signed SERVE-URL alap-élettartama (30 nap) — a felhasználó később is letölti a fájlt. */
-const FTP_SIGNED_SERVE_TTL_MS = 30 * 24 * 60 * 60 * 1000;
-/**
- * FTP Service API kliens (deep/generikus — `@futdevpro/nts-dynamo`).
- * @description A szerver-oldali FTP-KLIENS: a meglévő `fdp-ftp-service` tároló-szervert HÍVJA — fájlt tölt
- *   fel (signed upload), és aláírt serve-URL-t épít. **NEM tartalmaz FTP-szervert.** A korábban az
- *   MP-be / token-service-be duplikált FTP-kliens EGYETLEN, flotta-közös kiváltása.
- *
- *   **PURE (ADR-004):** a config (URL-ek + titok) a `DyNTS_FtpService_Config`-ból, a hívó adja át —
- *   nincs `fdp-templates`-import. Nem singleton: minden consumer a saját config-jával példányosít.
- *
- * @example
- * ```ts
- * const ftp: DyNTS_FtpService_ApiService = new DyNTS_FtpService_ApiService({
- *   apiBaseUrl: FDP_ftpServiceApiEnv_settings.baseUrl.fromBE,
- *   serveBaseUrl: FDP_ftpServiceApiEnv_settings.baseUrl.siteAddress,
- *   signingSecret: process.env.FTP_URL_SIGNING_SECRET || '',
- * });
- * const { ftpPath } = await ftp.uploadFile({ accountId, folderPath: 'invoices/<userId>', fileName, fileBuffer });
- * const url: string = ftp.buildSignedServeUrl(ftpPath);
- * ```
- */
-class DyNTS_FtpService_ApiService {
-    config;
-    constructor(config) {
-        this.config = config;
-    }
-    get uploadFileEndpoint() {
-        return this.config.uploadFileEndpoint ?? '/files/upload';
-    }
-    /**
-     * Fájl feltöltése az `fdp-ftp-service`-re (signed, szerver-szerver).
-     * @description A kanonikus upload-célt + lejáratot HMAC-aláírjuk a megosztott titokkal; az ftp ezt
-     *   validálja (a signature a KONKRÉT account+path-hoz köt — más account-ra nem replay-elhető).
-     */
-    async uploadFile(input) {
-        const expMs = Date.now() + FTP_SIGNED_UPLOAD_TTL_MS;
-        const uploadTarget = ftp_url_signer_util_1.DyNTS_FtpUrlSigner_Util.uploadTarget(input.accountId, input.folderPath, input.fileName);
-        const sig = ftp_url_signer_util_1.DyNTS_FtpUrlSigner_Util.sign(uploadTarget, expMs, this.config.signingSecret);
-        return await api_service_1.DyNTS_ApiService.startApiCall(new api_call_params_control_model_1.DyNTS_ApiCall_Params({
-            name: 'uploadFile (DyNTS_FtpService)',
-            type: fsm_dynamo_1.DyFM_HttpCallType.post,
-            baseUrl: this.config.apiBaseUrl,
-            endpoint: this.uploadFileEndpoint,
-            httpOptions: new api_call_params_control_model_1.DyNTS_HttpOptions({
-                headers: {
-                    'Content-Type': 'application/json',
-                },
-            }),
-        }), {
-            body: {
-                accountId: input.accountId,
-                folderPath: input.folderPath,
-                fileName: input.fileName,
-                fileBuffer: input.fileBuffer.toString('base64'),
-                exp: expMs,
-                sig: sig,
-            },
-        });
-    }
-    /**
-     * Aláírt serve-URL egy `ftpPath`-ból (böngésző-letöltéshez). Üres titok → üres string (gate inaktív).
-     * @param ttlMs opcionális egyedi élettartam; default 30 nap.
-     */
-    buildSignedServeUrl(ftpPath, ttlMs = FTP_SIGNED_SERVE_TTL_MS) {
-        return ftp_url_signer_util_1.DyNTS_FtpUrlSigner_Util.buildSignedServeUrl({
-            serveBaseUrl: this.config.serveBaseUrl,
-            ftpPath: ftpPath,
-            ttlMs: ttlMs,
-            secret: this.config.signingSecret,
-        });
-    }
-}
-exports.DyNTS_FtpService_ApiService = DyNTS_FtpService_ApiService;
-//# sourceMappingURL=ftp-service.api-service.js.map

package/build/_modules/ftp/_services/ftp-service.api-service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ftp-service.api-service.js","sourceRoot":"","sources":["../../../../src/_modules/ftp/_services/ftp-service.api-service.ts"],"names":[],"mappings":";;;AAAA,sDAA0D;AAE1D,qEAAuE;AACvE,iHAAwH;AACxH,6EAA8E;AAE9E,uHAAuH;AACvH,MAAM,wBAAwB,GAAW,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACxD,8FAA8F;AAC9F,MAAM,uBAAuB,GAAW,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AA+BjE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,2BAA2B;IAErB,MAAM,CAA0B;IAEjD,YAAY,MAA+B;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAY,kBAAkB;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,kBAAkB,IAAI,eAAe,CAAC;IAC3D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,KAAwC;QACvD,MAAM,KAAK,GAAW,IAAI,CAAC,GAAG,EAAE,GAAG,wBAAwB,CAAC;QAC5D,MAAM,YAAY,GAAW,6CAAuB,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QACrH,MAAM,GAAG,GAAW,6CAAuB,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAEjG,OAAO,MAAM,8BAAgB,CAAC,YAAY,CACxC,IAAI,oDAAoB,CAAC;YACvB,IAAI,EAAE,+BAA+B;YACrC,IAAI,EAAE,8BAAiB,CAAC,IAAI;YAC5B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;YAC/B,QAAQ,EAAE,IAAI,CAAC,kBAAkB;YACjC,WAAW,EAAE,IAAI,iDAAiB,CAAC;gBACjC,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;iBACnC;aACF,CAAC;SACH,CAAC,EACF;YACE,IAAI,EAAE;gBACJ,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC/C,GAAG,EAAE,KAAK;gBACV,GAAG,EAAE,GAAG;aACT;SACF,CACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,mBAAmB,CAAC,OAAe,EAAE,QAAgB,uBAAuB;QAC1E,OAAO,6CAAuB,CAAC,mBAAmB,CAAC;YACjD,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;YACtC,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;SAClC,CAAC,CAAC;IACL,CAAC;CACF;AA3DD,kEA2DC"}

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

@@ -1,3 +0,0 @@
-export { DyNTS_FtpUrlSigner_Util } from './_collections/ftp-url-signer.util';
-export { DyNTS_FtpService_ApiService, DyNTS_FtpService_Config, DyNTS_FtpService_UploadFile_Input, DyNTS_FtpService_UploadFile_Response, } from './_services/ftp-service.api-service';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/ftp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,iCAAiC,EACjC,oCAAoC,GACrC,MAAM,qCAAqC,CAAC"}

package/build/_modules/ftp/index.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_FtpService_ApiService = exports.DyNTS_FtpUrlSigner_Util = void 0;
-var ftp_url_signer_util_1 = require("./_collections/ftp-url-signer.util");
-Object.defineProperty(exports, "DyNTS_FtpUrlSigner_Util", { enumerable: true, get: function () { return ftp_url_signer_util_1.DyNTS_FtpUrlSigner_Util; } });
-var ftp_service_api_service_1 = require("./_services/ftp-service.api-service");
-Object.defineProperty(exports, "DyNTS_FtpService_ApiService", { enumerable: true, get: function () { return ftp_service_api_service_1.DyNTS_FtpService_ApiService; } });
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/ftp/index.ts"],"names":[],"mappings":";;;AAAA,0EAA6E;AAApE,8HAAA,uBAAuB,OAAA;AAChC,+EAK6C;AAJ3C,sIAAA,2BAA2B,OAAA"}

package/src/_modules/ftp/_collections/ftp-url-signer.util.spec.ts

@@ -1,44 +0,0 @@
-import { DyNTS_FtpUrlSigner_Util } from './ftp-url-signer.util';
-
-/**
- * A generikus FTP signed-URL aláíró tesztjei (AAA). Igazolja: a normalizálás + a HMAC determinisztikus,
- * a tamper/lejárat eltérő sig-et ad, üres titok → üres serve-URL (gate inaktív).
- */
-describe('| DyNTS_FtpUrlSigner_Util', () => {
-  const SECRET: string = 'shared-ftp-signing-secret-123';
-
-  it('| normalizePath: leading-slash le + backslash→slash', () => {
-    expect(DyNTS_FtpUrlSigner_Util.normalizePath('/a\\b/c')).toBe('a/b/c');
-    expect(DyNTS_FtpUrlSigner_Util.normalizePath('///x/y')).toBe('x/y');
-  });
-
-  it('| uploadTarget: accountId/folderPath/fileName', () => {
-    expect(DyNTS_FtpUrlSigner_Util.uploadTarget('acc', 'invoices/u1', 'inv.pdf')).toBe('acc/invoices/u1/inv.pdf');
-  });
-
-  it('| sign: determinisztikus + a normalizált path-ra HMAC-el (a nyers és a normalizált egyezik)', () => {
-    const a: string = DyNTS_FtpUrlSigner_Util.sign('/inv/u1.pdf', 1000, SECRET);
-    const b: string = DyNTS_FtpUrlSigner_Util.sign('inv/u1.pdf', 1000, SECRET);
-    expect(a).toBe(b);
-    expect(a).toMatch(/^[0-9a-f]{64}$/);
-  });
-
-  it('| sign: eltérő exp / eltérő secret → eltérő aláírás (tamper-evidens)', () => {
-    const base: string = DyNTS_FtpUrlSigner_Util.sign('inv/u1.pdf', 1000, SECRET);
-    expect(DyNTS_FtpUrlSigner_Util.sign('inv/u1.pdf', 2000, SECRET)).not.toBe(base);
-    expect(DyNTS_FtpUrlSigner_Util.sign('inv/u1.pdf', 1000, 'other')).not.toBe(base);
-  });
-
-  it('| buildSignedServeUrl: exp=now+ttl + sig; a base trailing-slash levágva', () => {
-    const url: string = DyNTS_FtpUrlSigner_Util.buildSignedServeUrl({
-      serveBaseUrl: 'https://ftp.host/', ftpPath: '/inv/u1.pdf', ttlMs: 5000, secret: SECRET, nowMs: 1000,
-    });
-    expect(url).toBe(`https://ftp.host/inv/u1.pdf?exp=6000&sig=${DyNTS_FtpUrlSigner_Util.sign('inv/u1.pdf', 6000, SECRET)}`);
-  });
-
-  it('| buildSignedServeUrl: ÜRES titok → üres string (gate inaktív)', () => {
-    expect(DyNTS_FtpUrlSigner_Util.buildSignedServeUrl({
-      serveBaseUrl: 'https://ftp.host', ftpPath: 'x.pdf', ttlMs: 5000, secret: '',
-    })).toBe('');
-  });
-});

package/src/_modules/ftp/_collections/ftp-url-signer.util.ts

@@ -1,60 +0,0 @@
-import * as Crypto from 'crypto';
-
-/**
- * FTP signed-URL ALÁÍRÓ (deep/generikus — `@futdevpro/nts-dynamo`).
- *
- * A böngésző-serve (`<img src>` / letöltő-link) nem tud Bearer-headert küldeni, ezért az
- * `fdp-ftp-service` HTTP-kiszolgálása rövid-/közép-életű **aláírt URL**-lel auth-ol. Ez az util a
- * megosztott titokkal HMAC-SHA256-tal aláírja a `path + exp`-et, és előállítja a serve-URL-t.
- *
- * ⚠️ Az algoritmusnak **BIT-RE egyeznie kell** az `fdp-ftp-service` `FtpUrlSignature_Util`-jával
- * (kanonikus string: `<normalizedPath>\n<expMs>`; normalizálás: leading-slash le + `\`→`/`), különben
- * az ftp elutasítja a signature-t.
- *
- * **PURE (ADR-004):** ez a modul NEM importál `fdp-templates`-et — a `secret`/`serveBaseUrl` a hívó-
- * (consumer-) oldalról jön paraméterként. Így minden FDP-server újrahasználhatja, egyetlen példányban.
- */
-export class DyNTS_FtpUrlSigner_Util {
-
-  /** Path normalizálás — pontosan az ftp-serve normalizálása (leading-slash le, `\`→`/`). */
-  static normalizePath(filePath: string): string {
-    return filePath.replace(/^\/+/, '').replace(/\\/g, '/');
-  }
-
-  /**
-   * Kanonikus UPLOAD-cél string: `accountId/folderPath/fileName`. A szerver-szerver (app→ftp) upload
-   * ezt írja alá → az ftp ugyanígy építi + validálja. Bit-azonos kell legyen a két oldalon.
-   */
-  static uploadTarget(accountId: string, folderPath: string, fileName: string): string {
-    return `${accountId}/${folderPath}/${fileName}`;
-  }
-
-  /** HMAC-SHA256 a `<normalizedPath>\n<expMs>`-en → hex (az ftp ezt validálja). */
-  static sign(filePath: string, expMs: number, secret: string): string {
-    const normalizedPath: string = DyNTS_FtpUrlSigner_Util.normalizePath(filePath);
-    return Crypto
-      .createHmac('sha256', secret)
-      .update(`${normalizedPath}\n${expMs}`, 'utf8')
-      .digest('hex');
-  }
-
-  /**
-   * Teljes aláírt serve-URL egy ftp-path-ból: `<serveBaseUrl>/<normalizedPath>?exp=<ms>&sig=<hex>`.
-   * Üres `secret` → üres string (a gate inaktív; a hívó dönt a fallback-ről). `nowMs` injektálható teszthez.
-   */
-  static buildSignedServeUrl(params: {
-    serveBaseUrl: string;
-    ftpPath: string;
-    ttlMs: number;
-    secret: string;
-    nowMs?: number;
-  }): string {
-    if (!params.secret) { return ''; }
-    const now: number = typeof params.nowMs === 'number' ? params.nowMs : Date.now();
-    const expMs: number = now + params.ttlMs;
-    const normalizedPath: string = DyNTS_FtpUrlSigner_Util.normalizePath(params.ftpPath);
-    const sig: string = DyNTS_FtpUrlSigner_Util.sign(normalizedPath, expMs, params.secret);
-    const base: string = params.serveBaseUrl.replace(/\/+$/, '');
-    return `${base}/${normalizedPath}?exp=${expMs}&sig=${sig}`;
-  }
-}

package/src/_modules/ftp/_services/ftp-service.api-service.ts

@@ -1,120 +0,0 @@
-import { DyFM_HttpCallType } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_ApiService } from '../../../_services/core/api.service';
-import { DyNTS_ApiCall_Params, DyNTS_HttpOptions } from '../../../_models/control-models/api-call-params.control-model';
-import { DyNTS_FtpUrlSigner_Util } from '../_collections/ftp-url-signer.util';
-
-/** A signed UPLOAD-aláírás érvényessége (10 perc) — a szerver-szerver app→ftp feltöltés szinkron, rövid ablak elég. */
-const FTP_SIGNED_UPLOAD_TTL_MS: number = 10 * 60 * 1000;
-/** A signed SERVE-URL alap-élettartama (30 nap) — a felhasználó később is letölti a fájlt. */
-const FTP_SIGNED_SERVE_TTL_MS: number = 30 * 24 * 60 * 60 * 1000;
-
-/**
- * FTP-kliens KONFIG (a consumer adja át — PURE: nincs fdp-templates-függés).
- * A `fdp-ftp-service` URL-jei + a megosztott aláíró-titok a hívó-oldalról jönnek.
- */
-export interface DyNTS_FtpService_Config {
-  /** az `fdp-ftp-service` API base-URL a szerver-szerver feltöltéshez (pl. `FDP_ftpServiceApiEnv_settings.baseUrl.fromBE`). */
-  apiBaseUrl: string;
-  /** a publikus serve-host az aláírt letöltő-URL-ekhez (pl. `FDP_ftpServiceApiEnv_settings.baseUrl.siteAddress`). */
-  serveBaseUrl: string;
-  /** a megosztott HMAC-titok (env-var `FTP_URL_SIGNING_SECRET`, MÁR létező). Üres → a serve-gate inaktív. */
-  signingSecret: string;
-  /** az upload-endpoint (default `/files/upload`). */
-  uploadFileEndpoint?: string;
-}
-
-/** FTP-feltöltés bemenete. */
-export interface DyNTS_FtpService_UploadFile_Input {
-  accountId: string;
-  folderPath: string;
-  fileName: string;
-  fileBuffer: Buffer;
-}
-
-/** FTP-feltöltés válasza. */
-export interface DyNTS_FtpService_UploadFile_Response {
-  filePath: string;
-  ftpPath: string;
-}
-
-/**
- * FTP Service API kliens (deep/generikus — `@futdevpro/nts-dynamo`).
- * @description A szerver-oldali FTP-KLIENS: a meglévő `fdp-ftp-service` tároló-szervert HÍVJA — fájlt tölt
- *   fel (signed upload), és aláírt serve-URL-t épít. **NEM tartalmaz FTP-szervert.** A korábban az
- *   MP-be / token-service-be duplikált FTP-kliens EGYETLEN, flotta-közös kiváltása.
- *
- *   **PURE (ADR-004):** a config (URL-ek + titok) a `DyNTS_FtpService_Config`-ból, a hívó adja át —
- *   nincs `fdp-templates`-import. Nem singleton: minden consumer a saját config-jával példányosít.
- *
- * @example
- * ```ts
- * const ftp: DyNTS_FtpService_ApiService = new DyNTS_FtpService_ApiService({
- *   apiBaseUrl: FDP_ftpServiceApiEnv_settings.baseUrl.fromBE,
- *   serveBaseUrl: FDP_ftpServiceApiEnv_settings.baseUrl.siteAddress,
- *   signingSecret: process.env.FTP_URL_SIGNING_SECRET || '',
- * });
- * const { ftpPath } = await ftp.uploadFile({ accountId, folderPath: 'invoices/<userId>', fileName, fileBuffer });
- * const url: string = ftp.buildSignedServeUrl(ftpPath);
- * ```
- */
-export class DyNTS_FtpService_ApiService {
-
-  private readonly config: DyNTS_FtpService_Config;
-
-  constructor(config: DyNTS_FtpService_Config) {
-    this.config = config;
-  }
-
-  private get uploadFileEndpoint(): string {
-    return this.config.uploadFileEndpoint ?? '/files/upload';
-  }
-
-  /**
-   * Fájl feltöltése az `fdp-ftp-service`-re (signed, szerver-szerver).
-   * @description A kanonikus upload-célt + lejáratot HMAC-aláírjuk a megosztott titokkal; az ftp ezt
-   *   validálja (a signature a KONKRÉT account+path-hoz köt — más account-ra nem replay-elhető).
-   */
-  async uploadFile(input: DyNTS_FtpService_UploadFile_Input): Promise<DyNTS_FtpService_UploadFile_Response> {
-    const expMs: number = Date.now() + FTP_SIGNED_UPLOAD_TTL_MS;
-    const uploadTarget: string = DyNTS_FtpUrlSigner_Util.uploadTarget(input.accountId, input.folderPath, input.fileName);
-    const sig: string = DyNTS_FtpUrlSigner_Util.sign(uploadTarget, expMs, this.config.signingSecret);
-
-    return await DyNTS_ApiService.startApiCall<DyNTS_FtpService_UploadFile_Response>(
-      new DyNTS_ApiCall_Params({
-        name: 'uploadFile (DyNTS_FtpService)',
-        type: DyFM_HttpCallType.post,
-        baseUrl: this.config.apiBaseUrl,
-        endpoint: this.uploadFileEndpoint,
-        httpOptions: new DyNTS_HttpOptions({
-          headers: {
-            'Content-Type': 'application/json',
-          },
-        }),
-      }),
-      {
-        body: {
-          accountId: input.accountId,
-          folderPath: input.folderPath,
-          fileName: input.fileName,
-          fileBuffer: input.fileBuffer.toString('base64'),
-          exp: expMs,
-          sig: sig,
-        },
-      },
-    );
-  }
-
-  /**
-   * Aláírt serve-URL egy `ftpPath`-ból (böngésző-letöltéshez). Üres titok → üres string (gate inaktív).
-   * @param ttlMs opcionális egyedi élettartam; default 30 nap.
-   */
-  buildSignedServeUrl(ftpPath: string, ttlMs: number = FTP_SIGNED_SERVE_TTL_MS): string {
-    return DyNTS_FtpUrlSigner_Util.buildSignedServeUrl({
-      serveBaseUrl: this.config.serveBaseUrl,
-      ftpPath: ftpPath,
-      ttlMs: ttlMs,
-      secret: this.config.signingSecret,
-    });
-  }
-}

package/src/_modules/ftp/index.ts

@@ -1,7 +0,0 @@
-export { DyNTS_FtpUrlSigner_Util } from './_collections/ftp-url-signer.util';
-export {
-  DyNTS_FtpService_ApiService,
-  DyNTS_FtpService_Config,
-  DyNTS_FtpService_UploadFile_Input,
-  DyNTS_FtpService_UploadFile_Response,
-} from './_services/ftp-service.api-service';