@futdevpro/nts-dynamo 1.15.122 → 1.15.126

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';