@futdevpro/nts-dynamo 1.15.151 → 1.15.154

package/src/_modules/test-email-sink/_models/data-models/dynts-sent-test-mail.data-model.ts

@@ -1,41 +1,41 @@
-import { DyFM_DataModel_Params, DyFM_Metadata, DyFM_Object } from '@futdevpro/fsm-dynamo';
-
-/**
- * BFR-MASTERPROMPTER-015 (MP-19) — egy SINK-elt teszt-email rekord.
- *
- * A `DyNTS_EmailService.sendEmail` a teszt-cim-mintara (`DyNTS_testEmailPattern`) meno kuldeseket
- * local/test kornyezetben IDE menti SMTP helyett. A rekordokat a `/e2e/sent-mail` read-endpoint
- * szolgalja ki (X-E2E-KEY-vedett, env-gate-elt). A kollekcio TTL-indexet kap (default 24h) — a
- * teszt-emailek maguktol elevulnek, nincs unbounded growth.
- */
-export class DyNTS_SentTestMail extends DyFM_Metadata {
-  /** A cimzett (a teszt-mintara matchelo cim). Tobb-cimzettes kuldesnel vesszovel osszefuzve. */
-  to?: string;
-
-  /** Az email targya. */
-  subject?: string;
-
-  /** A kikuldendo (lerenderelt) HTML tartalom — ebbol parseolhato pl. a verifikacios link. */
-  html?: string;
-
-  /** A kuldes issuer-e (melyik flow/account inditotta) — debug/korrelacio. */
-  issuer?: string;
-
-  constructor(set?: Partial<DyNTS_SentTestMail>) {
-    super(set);
-    if (set) {
-      DyFM_Object.cleanAssign(this, set);
-    }
-  }
-}
-
-export const DyNTS_sentTestMail_dataParams: DyFM_DataModel_Params<DyNTS_SentTestMail> =
-  new DyFM_DataModel_Params<DyNTS_SentTestMail>({
-    dataName: 'dynts_sent_test_mails',
-    properties: {
-      to: { type: 'string', index: true, required: true },
-      subject: { type: 'string' },
-      html: { type: 'string' },
-      issuer: { type: 'string', index: true },
-    },
-  });
+import { DyFM_DataModel_Params, DyFM_Metadata, DyFM_Object } from '@futdevpro/fsm-dynamo';
+
+/**
+ * BFR-MASTERPROMPTER-015 (MP-19) — egy SINK-elt teszt-email rekord.
+ *
+ * A `DyNTS_EmailService.sendEmail` a teszt-cim-mintara (`DyNTS_testEmailPattern`) meno kuldeseket
+ * local/test kornyezetben IDE menti SMTP helyett. A rekordokat a `/e2e/sent-mail` read-endpoint
+ * szolgalja ki (X-E2E-KEY-vedett, env-gate-elt). A kollekcio TTL-indexet kap (default 24h) — a
+ * teszt-emailek maguktol elevulnek, nincs unbounded growth.
+ */
+export class DyNTS_SentTestMail extends DyFM_Metadata {
+  /** A cimzett (a teszt-mintara matchelo cim). Tobb-cimzettes kuldesnel vesszovel osszefuzve. */
+  to?: string;
+
+  /** Az email targya. */
+  subject?: string;
+
+  /** A kikuldendo (lerenderelt) HTML tartalom — ebbol parseolhato pl. a verifikacios link. */
+  html?: string;
+
+  /** A kuldes issuer-e (melyik flow/account inditotta) — debug/korrelacio. */
+  issuer?: string;
+
+  constructor(set?: Partial<DyNTS_SentTestMail>) {
+    super(set);
+    if (set) {
+      DyFM_Object.cleanAssign(this, set);
+    }
+  }
+}
+
+export const DyNTS_sentTestMail_dataParams: DyFM_DataModel_Params<DyNTS_SentTestMail> =
+  new DyFM_DataModel_Params<DyNTS_SentTestMail>({
+    dataName: 'dynts_sent_test_mails',
+    properties: {
+      to: { type: 'string', index: true, required: true },
+      subject: { type: 'string' },
+      html: { type: 'string' },
+      issuer: { type: 'string', index: true },
+    },
+  });

package/src/_modules/test-email-sink/_services/dynts-test-email-sink.service.spec.ts

@@ -1,112 +1,112 @@
-import { DyFM_EnvironmentFlag } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
-import { DyNTS_testEmailPattern } from '../_collections/test-email-pattern.const';
-import { DyNTS_TestEmailSink_Service } from './dynts-test-email-sink.service';
-
-describe('| DyNTS_TestEmailSink_Service (BFR-MASTERPROMPTER-015)', () => {
-  let originalEnvironment: DyFM_EnvironmentFlag;
-  let originalSinkSettings: typeof DyNTS_global_settings.testEmailSink;
-
-  beforeEach(() => {
-    originalEnvironment = DyNTS_global_settings.env_settings.environment;
-    originalSinkSettings = DyNTS_global_settings.testEmailSink;
-  });
-
-  afterEach(() => {
-    DyNTS_global_settings.env_settings.environment = originalEnvironment;
-    DyNTS_global_settings.testEmailSink = originalSinkSettings;
-  });
-
-  describe('| DyNTS_testEmailPattern', () => {
-    it('| matchel a kanonikus teszt-cimre (case-insensitive)', () => {
-      expect(DyNTS_testEmailPattern.test('e2e-abc123@e2e.test.futdevpro.local')).toBeTrue();
-      expect(DyNTS_testEmailPattern.test('X@E2E.TEST.FUTDEVPRO.LOCAL')).toBeTrue();
-    });
-
-    it('| NEM matchel valos cimekre (incl. hasonlo domain-vegzodesek)', () => {
-      expect(DyNTS_testEmailPattern.test('user@gmail.com')).toBeFalse();
-      expect(DyNTS_testEmailPattern.test('user@futdevpro.hu')).toBeFalse();
-      expect(DyNTS_testEmailPattern.test('user@e2e.test.futdevpro.localhost')).toBeFalse();
-      expect(DyNTS_testEmailPattern.test('user@notE2e.test.futdevpro.local.evil.com')).toBeFalse();
-    });
-  });
-
-  describe('| shouldSink — env-gate (fail-closed)', () => {
-    it('| test kornyezetben teszt-cimre → TRUE', () => {
-      DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.test;
-      expect(DyNTS_TestEmailSink_Service.shouldSink('x@e2e.test.futdevpro.local')).toBeTrue();
-    });
-
-    it('| local kornyezetben teszt-cimre → TRUE', () => {
-      DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.local;
-      expect(DyNTS_TestEmailSink_Service.shouldSink('x@e2e.test.futdevpro.local')).toBeTrue();
-    });
-
-    it('| PROD kornyezetben MEG enabled:true settinggel SEM aktiv (hard fail-closed)', () => {
-      DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.prod;
-      DyNTS_global_settings.testEmailSink = { enabled: true };
-      expect(DyNTS_TestEmailSink_Service.shouldSink('x@e2e.test.futdevpro.local')).toBeFalse();
-    });
-
-    it('| test kornyezetben enabled:false settinggel kikapcsolhato', () => {
-      DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.test;
-      DyNTS_global_settings.testEmailSink = { enabled: false };
-      expect(DyNTS_TestEmailSink_Service.shouldSink('x@e2e.test.futdevpro.local')).toBeFalse();
-    });
-  });
-
-  describe('| shouldSink — cimzett-minta', () => {
-    beforeEach(() => {
-      DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.test;
-    });
-
-    it('| valos cimre → FALSE (test kornyezetben is)', () => {
-      expect(DyNTS_TestEmailSink_Service.shouldSink('user@gmail.com')).toBeFalse();
-    });
-
-    it('| ures/undefined cimre → FALSE', () => {
-      expect(DyNTS_TestEmailSink_Service.shouldSink(undefined)).toBeFalse();
-      expect(DyNTS_TestEmailSink_Service.shouldSink('')).toBeFalse();
-    });
-
-    it('| vesszos tobb-cimzettes string: MIND teszt-cim → TRUE', () => {
-      expect(DyNTS_TestEmailSink_Service.shouldSink(
-        'a@e2e.test.futdevpro.local, b@e2e.test.futdevpro.local',
-      )).toBeTrue();
-    });
-
-    it('| KEVERT cimzett-lista (teszt + valos) → FALSE (a valos cimzett nem veszithet emailt)', () => {
-      expect(DyNTS_TestEmailSink_Service.shouldSink(
-        'a@e2e.test.futdevpro.local, real@gmail.com',
-      )).toBeFalse();
-    });
-
-    it('| tomb-cimzettek: mind teszt → TRUE; kevert → FALSE', () => {
-      expect(DyNTS_TestEmailSink_Service.shouldSink([ 'a@e2e.test.futdevpro.local' ])).toBeTrue();
-      expect(DyNTS_TestEmailSink_Service.shouldSink([ 'a@e2e.test.futdevpro.local', 'real@x.com' ])).toBeFalse();
-    });
-
-    it('| custom pattern-override settinggel', () => {
-      DyNTS_global_settings.testEmailSink = { pattern: /@sink\.example$/ };
-      expect(DyNTS_TestEmailSink_Service.shouldSink('x@sink.example')).toBeTrue();
-      expect(DyNTS_TestEmailSink_Service.shouldSink('x@e2e.test.futdevpro.local')).toBeFalse();
-    });
-  });
-
-  describe('| extractLinks', () => {
-    it('| minden href-et kinyer sorrendben', () => {
-      const html: string =
-        '<a href="https://x.hu/email-verification/tok3n">Verify</a> <a href="https://x.hu/reset">Reset</a>';
-      expect(DyNTS_TestEmailSink_Service.extractLinks(html)).toEqual([
-        'https://x.hu/email-verification/tok3n',
-        'https://x.hu/reset',
-      ]);
-    });
-
-    it('| ures/undefined html → ures tomb', () => {
-      expect(DyNTS_TestEmailSink_Service.extractLinks(undefined)).toEqual([]);
-      expect(DyNTS_TestEmailSink_Service.extractLinks('<p>no links</p>')).toEqual([]);
-    });
-  });
-});
+import { DyFM_EnvironmentFlag } from '@futdevpro/fsm-dynamo';
+
+import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
+import { DyNTS_testEmailPattern } from '../_collections/test-email-pattern.const';
+import { DyNTS_TestEmailSink_Service } from './dynts-test-email-sink.service';
+
+describe('| DyNTS_TestEmailSink_Service (BFR-MASTERPROMPTER-015)', () => {
+  let originalEnvironment: DyFM_EnvironmentFlag;
+  let originalSinkSettings: typeof DyNTS_global_settings.testEmailSink;
+
+  beforeEach(() => {
+    originalEnvironment = DyNTS_global_settings.env_settings.environment;
+    originalSinkSettings = DyNTS_global_settings.testEmailSink;
+  });
+
+  afterEach(() => {
+    DyNTS_global_settings.env_settings.environment = originalEnvironment;
+    DyNTS_global_settings.testEmailSink = originalSinkSettings;
+  });
+
+  describe('| DyNTS_testEmailPattern', () => {
+    it('| matchel a kanonikus teszt-cimre (case-insensitive)', () => {
+      expect(DyNTS_testEmailPattern.test('e2e-abc123@e2e.test.futdevpro.local')).toBeTrue();
+      expect(DyNTS_testEmailPattern.test('X@E2E.TEST.FUTDEVPRO.LOCAL')).toBeTrue();
+    });
+
+    it('| NEM matchel valos cimekre (incl. hasonlo domain-vegzodesek)', () => {
+      expect(DyNTS_testEmailPattern.test('user@gmail.com')).toBeFalse();
+      expect(DyNTS_testEmailPattern.test('user@futdevpro.hu')).toBeFalse();
+      expect(DyNTS_testEmailPattern.test('user@e2e.test.futdevpro.localhost')).toBeFalse();
+      expect(DyNTS_testEmailPattern.test('user@notE2e.test.futdevpro.local.evil.com')).toBeFalse();
+    });
+  });
+
+  describe('| shouldSink — env-gate (fail-closed)', () => {
+    it('| test kornyezetben teszt-cimre → TRUE', () => {
+      DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.test;
+      expect(DyNTS_TestEmailSink_Service.shouldSink('x@e2e.test.futdevpro.local')).toBeTrue();
+    });
+
+    it('| local kornyezetben teszt-cimre → TRUE', () => {
+      DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.local;
+      expect(DyNTS_TestEmailSink_Service.shouldSink('x@e2e.test.futdevpro.local')).toBeTrue();
+    });
+
+    it('| PROD kornyezetben MEG enabled:true settinggel SEM aktiv (hard fail-closed)', () => {
+      DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.prod;
+      DyNTS_global_settings.testEmailSink = { enabled: true };
+      expect(DyNTS_TestEmailSink_Service.shouldSink('x@e2e.test.futdevpro.local')).toBeFalse();
+    });
+
+    it('| test kornyezetben enabled:false settinggel kikapcsolhato', () => {
+      DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.test;
+      DyNTS_global_settings.testEmailSink = { enabled: false };
+      expect(DyNTS_TestEmailSink_Service.shouldSink('x@e2e.test.futdevpro.local')).toBeFalse();
+    });
+  });
+
+  describe('| shouldSink — cimzett-minta', () => {
+    beforeEach(() => {
+      DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.test;
+    });
+
+    it('| valos cimre → FALSE (test kornyezetben is)', () => {
+      expect(DyNTS_TestEmailSink_Service.shouldSink('user@gmail.com')).toBeFalse();
+    });
+
+    it('| ures/undefined cimre → FALSE', () => {
+      expect(DyNTS_TestEmailSink_Service.shouldSink(undefined)).toBeFalse();
+      expect(DyNTS_TestEmailSink_Service.shouldSink('')).toBeFalse();
+    });
+
+    it('| vesszos tobb-cimzettes string: MIND teszt-cim → TRUE', () => {
+      expect(DyNTS_TestEmailSink_Service.shouldSink(
+        'a@e2e.test.futdevpro.local, b@e2e.test.futdevpro.local',
+      )).toBeTrue();
+    });
+
+    it('| KEVERT cimzett-lista (teszt + valos) → FALSE (a valos cimzett nem veszithet emailt)', () => {
+      expect(DyNTS_TestEmailSink_Service.shouldSink(
+        'a@e2e.test.futdevpro.local, real@gmail.com',
+      )).toBeFalse();
+    });
+
+    it('| tomb-cimzettek: mind teszt → TRUE; kevert → FALSE', () => {
+      expect(DyNTS_TestEmailSink_Service.shouldSink([ 'a@e2e.test.futdevpro.local' ])).toBeTrue();
+      expect(DyNTS_TestEmailSink_Service.shouldSink([ 'a@e2e.test.futdevpro.local', 'real@x.com' ])).toBeFalse();
+    });
+
+    it('| custom pattern-override settinggel', () => {
+      DyNTS_global_settings.testEmailSink = { pattern: /@sink\.example$/ };
+      expect(DyNTS_TestEmailSink_Service.shouldSink('x@sink.example')).toBeTrue();
+      expect(DyNTS_TestEmailSink_Service.shouldSink('x@e2e.test.futdevpro.local')).toBeFalse();
+    });
+  });
+
+  describe('| extractLinks', () => {
+    it('| minden href-et kinyer sorrendben', () => {
+      const html: string =
+        '<a href="https://x.hu/email-verification/tok3n">Verify</a> <a href="https://x.hu/reset">Reset</a>';
+      expect(DyNTS_TestEmailSink_Service.extractLinks(html)).toEqual([
+        'https://x.hu/email-verification/tok3n',
+        'https://x.hu/reset',
+      ]);
+    });
+
+    it('| ures/undefined html → ures tomb', () => {
+      expect(DyNTS_TestEmailSink_Service.extractLinks(undefined)).toEqual([]);
+      expect(DyNTS_TestEmailSink_Service.extractLinks('<p>no links</p>')).toEqual([]);
+    });
+  });
+});

package/src/_modules/test-email-sink/_services/dynts-test-email-sink.service.ts

@@ -1,141 +1,141 @@
-import { DyFM_EnvironmentFlag, DyFM_Log } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
-import { DyNTS_DataService } from '../../../_services/base/data.service';
-import { DyNTS_testEmailPattern } from '../_collections/test-email-pattern.const';
-import { DyNTS_SentTestMail, DyNTS_sentTestMail_dataParams } from '../_models/data-models/dynts-sent-test-mail.data-model';
-
-/**
- * BFR-MASTERPROMPTER-015 (MP-19) — test-email SINK statikus util-service.
- *
- * A `DyNTS_EmailService.sendEmail` a kuldes ELOTT megkerdezi (`shouldSink`): ha a kornyezet
- * local/test ES a cimzett(ek) a teszt-cim-mintara matchelnek, a kuldes NEM SMTP-re megy, hanem a
- * `dynts_sent_test_mails` kollekcioba (`storeSentMail`). Minden mas eset VALTOZATLAN (zero
- * regresszio a valos emailekre; prod-on a sink SOHA nem aktiv — fail-closed env-gate).
- *
- * Konfiguracio (opcionalis): `DyNTS_global_settings.testEmailSink = { enabled?, pattern?, ttlHours? }`
- * — default: enabled local/test-en, pattern = `DyNTS_testEmailPattern`, TTL 24h.
- */
-export class DyNTS_TestEmailSink_Service {
-
-  /** A TTL-index ensure csak egyszer fusson processzenkent (idempotens a Mongo-oldalon is). */
-  private static ttlIndexEnsured: boolean = false;
-
-  /** A sink aktiv-e: explicit setting-override VAGY default env-gate (CSAK local/test — prod fail-closed). */
-  static isSinkActive(): boolean {
-    const settings = DyNTS_global_settings.testEmailSink;
-    const envIsTestLike: boolean = [ DyFM_EnvironmentFlag.local, DyFM_EnvironmentFlag.test ]
-      .includes(DyNTS_global_settings.env_settings.environment);
-
-    // A prod/dev kornyezet HARD-gate: settings.enabled=true SEM kapcsolhatja be (fail-closed).
-    if (!envIsTestLike) { return false; }
-
-    return settings?.enabled !== false; // default: local/test-en aktiv
-  }
-
-  /** Az ervenyes teszt-cim-minta (setting-override vagy a kanonikus default). */
-  static getPattern(): RegExp {
-    return DyNTS_global_settings.testEmailSink?.pattern ?? DyNTS_testEmailPattern;
-  }
-
-  /**
-   * SINK-elendo-e a kuldes: aktiv a sink ES MINDEN cimzett a teszt-mintara matchel.
-   * Kevert cimzett-lista (teszt + valos) → NEM sink-elunk (a kuldes a mai uton megy) — igy egy valos
-   * cimzett SOHA nem veszithet emailt a sink miatt.
-   */
-  static shouldSink(to: string | string[] | undefined): boolean {
-    if (!to || !this.isSinkActive()) { return false; }
-
-    const recipients: string[] = Array.isArray(to) ? to : String(to).split(',').map((r: string): string => r.trim());
-    if (!recipients.length) { return false; }
-
-    const pattern: RegExp = this.getPattern();
-    return recipients.every((recipient: string): boolean => pattern.test(recipient));
-  }
-
-  /** A sink-elt email eltarolasa + (elso hivaskor) a TTL-index best-effort felhuzasa. */
-  static async storeSentMail(set: {
-    to: string | string[];
-    subject?: string;
-    html?: string;
-    issuer: string;
-  }): Promise<void> {
-    const mail_DS = new DyNTS_DataService<DyNTS_SentTestMail>(
-      new DyNTS_SentTestMail(),
-      DyNTS_sentTestMail_dataParams,
-      set.issuer,
-    );
-
-    await mail_DS.dataDBService.createData(new DyNTS_SentTestMail({
-      to: Array.isArray(set.to) ? set.to.join(',') : set.to,
-      subject: set.subject,
-      html: set.html,
-      issuer: set.issuer,
-    }), set.issuer);
-
-    DyFM_Log.info(`[TEST-EMAIL-SINK] sunk mail to ${set.to} (subject: "${set.subject}") — DB-be, SMTP kihagyva`);
-
-    this.ensureTtlIndex(mail_DS);
-  }
-
-  /**
-   * Sink-elt emailek lekerdezese (a read-endpoint + a tesztek hasznaljak).
-   * BFR-008 query-options: sort desc + limit DB-szinten (nincs full-scan).
-   */
-  static async findSentMails(filter: {
-    to?: string;
-    sinceIso?: string;
-    limit?: number;
-  }, issuer: string): Promise<DyNTS_SentTestMail[]> {
-    const mail_DS = new DyNTS_DataService<DyNTS_SentTestMail>(
-      new DyNTS_SentTestMail(),
-      DyNTS_sentTestMail_dataParams,
-      issuer,
-    );
-
-    const dbFilter: Record<string, unknown> = {};
-    if (filter.to) { dbFilter.to = filter.to; }
-    if (filter.sinceIso) { dbFilter.__created = { $gte: new Date(filter.sinceIso) }; }
-
-    return mail_DS.findDataList(
-      dbFilter as never,
-      true,
-      { sort: { __created: -1 }, limit: Math.min(filter.limit ?? 20, 100) },
-    );
-  }
-
-  /**
-   * Link-kinyero a sink-elt HTML-bol (pl. verifikacios link / reset-token URL) — a fogyaszto tesztek
-   * kenyelmi utilja. Minden href-et visszaad, sorrendben.
-   */
-  static extractLinks(html: string | undefined): string[] {
-    if (!html) { return []; }
-    const links: string[] = [];
-    const hrefRegex: RegExp = /href="([^"]+)"/gi;
-    let match: RegExpExecArray | null = hrefRegex.exec(html);
-    while (match) {
-      links.push(match[1]);
-      match = hrefRegex.exec(html);
-    }
-    return links;
-  }
-
-  /** Best-effort TTL-index a __created-en (default 24h; settings.ttlHours override). Sosem dob. */
-  private static ensureTtlIndex(mail_DS: DyNTS_DataService<DyNTS_SentTestMail>): void {
-    if (this.ttlIndexEnsured) { return; }
-    this.ttlIndexEnsured = true;
-
-    const ttlHours: number = DyNTS_global_settings.testEmailSink?.ttlHours ?? 24;
-    try {
-      const model = mail_DS.dataDBService.dataModel as {
-        collection?: { createIndex?: (spec: object, opts: object) => Promise<unknown> };
-      };
-      void model.collection?.createIndex?.({ __created: 1 }, { expireAfterSeconds: ttlHours * 3600 })
-        ?.catch((error: Error): void => {
-          DyFM_Log.warn(`[TEST-EMAIL-SINK] TTL-index ensure failed (non-fatal): ${error.message}`);
-        });
-    } catch (error) {
-      DyFM_Log.warn(`[TEST-EMAIL-SINK] TTL-index ensure failed (non-fatal): ${(error as Error).message}`);
-    }
-  }
-}
+import { DyFM_EnvironmentFlag, DyFM_Log } from '@futdevpro/fsm-dynamo';
+
+import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
+import { DyNTS_DataService } from '../../../_services/base/data.service';
+import { DyNTS_testEmailPattern } from '../_collections/test-email-pattern.const';
+import { DyNTS_SentTestMail, DyNTS_sentTestMail_dataParams } from '../_models/data-models/dynts-sent-test-mail.data-model';
+
+/**
+ * BFR-MASTERPROMPTER-015 (MP-19) — test-email SINK statikus util-service.
+ *
+ * A `DyNTS_EmailService.sendEmail` a kuldes ELOTT megkerdezi (`shouldSink`): ha a kornyezet
+ * local/test ES a cimzett(ek) a teszt-cim-mintara matchelnek, a kuldes NEM SMTP-re megy, hanem a
+ * `dynts_sent_test_mails` kollekcioba (`storeSentMail`). Minden mas eset VALTOZATLAN (zero
+ * regresszio a valos emailekre; prod-on a sink SOHA nem aktiv — fail-closed env-gate).
+ *
+ * Konfiguracio (opcionalis): `DyNTS_global_settings.testEmailSink = { enabled?, pattern?, ttlHours? }`
+ * — default: enabled local/test-en, pattern = `DyNTS_testEmailPattern`, TTL 24h.
+ */
+export class DyNTS_TestEmailSink_Service {
+
+  /** A TTL-index ensure csak egyszer fusson processzenkent (idempotens a Mongo-oldalon is). */
+  private static ttlIndexEnsured: boolean = false;
+
+  /** A sink aktiv-e: explicit setting-override VAGY default env-gate (CSAK local/test — prod fail-closed). */
+  static isSinkActive(): boolean {
+    const settings = DyNTS_global_settings.testEmailSink;
+    const envIsTestLike: boolean = [ DyFM_EnvironmentFlag.local, DyFM_EnvironmentFlag.test ]
+      .includes(DyNTS_global_settings.env_settings.environment);
+
+    // A prod/dev kornyezet HARD-gate: settings.enabled=true SEM kapcsolhatja be (fail-closed).
+    if (!envIsTestLike) { return false; }
+
+    return settings?.enabled !== false; // default: local/test-en aktiv
+  }
+
+  /** Az ervenyes teszt-cim-minta (setting-override vagy a kanonikus default). */
+  static getPattern(): RegExp {
+    return DyNTS_global_settings.testEmailSink?.pattern ?? DyNTS_testEmailPattern;
+  }
+
+  /**
+   * SINK-elendo-e a kuldes: aktiv a sink ES MINDEN cimzett a teszt-mintara matchel.
+   * Kevert cimzett-lista (teszt + valos) → NEM sink-elunk (a kuldes a mai uton megy) — igy egy valos
+   * cimzett SOHA nem veszithet emailt a sink miatt.
+   */
+  static shouldSink(to: string | string[] | undefined): boolean {
+    if (!to || !this.isSinkActive()) { return false; }
+
+    const recipients: string[] = Array.isArray(to) ? to : String(to).split(',').map((r: string): string => r.trim());
+    if (!recipients.length) { return false; }
+
+    const pattern: RegExp = this.getPattern();
+    return recipients.every((recipient: string): boolean => pattern.test(recipient));
+  }
+
+  /** A sink-elt email eltarolasa + (elso hivaskor) a TTL-index best-effort felhuzasa. */
+  static async storeSentMail(set: {
+    to: string | string[];
+    subject?: string;
+    html?: string;
+    issuer: string;
+  }): Promise<void> {
+    const mail_DS = new DyNTS_DataService<DyNTS_SentTestMail>(
+      new DyNTS_SentTestMail(),
+      DyNTS_sentTestMail_dataParams,
+      set.issuer,
+    );
+
+    await mail_DS.dataDBService.createData(new DyNTS_SentTestMail({
+      to: Array.isArray(set.to) ? set.to.join(',') : set.to,
+      subject: set.subject,
+      html: set.html,
+      issuer: set.issuer,
+    }), set.issuer);
+
+    DyFM_Log.info(`[TEST-EMAIL-SINK] sunk mail to ${set.to} (subject: "${set.subject}") — DB-be, SMTP kihagyva`);
+
+    this.ensureTtlIndex(mail_DS);
+  }
+
+  /**
+   * Sink-elt emailek lekerdezese (a read-endpoint + a tesztek hasznaljak).
+   * BFR-008 query-options: sort desc + limit DB-szinten (nincs full-scan).
+   */
+  static async findSentMails(filter: {
+    to?: string;
+    sinceIso?: string;
+    limit?: number;
+  }, issuer: string): Promise<DyNTS_SentTestMail[]> {
+    const mail_DS = new DyNTS_DataService<DyNTS_SentTestMail>(
+      new DyNTS_SentTestMail(),
+      DyNTS_sentTestMail_dataParams,
+      issuer,
+    );
+
+    const dbFilter: Record<string, unknown> = {};
+    if (filter.to) { dbFilter.to = filter.to; }
+    if (filter.sinceIso) { dbFilter.__created = { $gte: new Date(filter.sinceIso) }; }
+
+    return mail_DS.findDataList(
+      dbFilter as never,
+      true,
+      { sort: { __created: -1 }, limit: Math.min(filter.limit ?? 20, 100) },
+    );
+  }
+
+  /**
+   * Link-kinyero a sink-elt HTML-bol (pl. verifikacios link / reset-token URL) — a fogyaszto tesztek
+   * kenyelmi utilja. Minden href-et visszaad, sorrendben.
+   */
+  static extractLinks(html: string | undefined): string[] {
+    if (!html) { return []; }
+    const links: string[] = [];
+    const hrefRegex: RegExp = /href="([^"]+)"/gi;
+    let match: RegExpExecArray | null = hrefRegex.exec(html);
+    while (match) {
+      links.push(match[1]);
+      match = hrefRegex.exec(html);
+    }
+    return links;
+  }
+
+  /** Best-effort TTL-index a __created-en (default 24h; settings.ttlHours override). Sosem dob. */
+  private static ensureTtlIndex(mail_DS: DyNTS_DataService<DyNTS_SentTestMail>): void {
+    if (this.ttlIndexEnsured) { return; }
+    this.ttlIndexEnsured = true;
+
+    const ttlHours: number = DyNTS_global_settings.testEmailSink?.ttlHours ?? 24;
+    try {
+      const model = mail_DS.dataDBService.dataModel as {
+        collection?: { createIndex?: (spec: object, opts: object) => Promise<unknown> };
+      };
+      void model.collection?.createIndex?.({ __created: 1 }, { expireAfterSeconds: ttlHours * 3600 })
+        ?.catch((error: Error): void => {
+          DyFM_Log.warn(`[TEST-EMAIL-SINK] TTL-index ensure failed (non-fatal): ${error.message}`);
+        });
+    } catch (error) {
+      DyFM_Log.warn(`[TEST-EMAIL-SINK] TTL-index ensure failed (non-fatal): ${(error as Error).message}`);
+    }
+  }
+}

package/src/_modules/test-email-sink/get-sent-mail-routing-module.util.ts

@@ -1,29 +1,29 @@
-import { DyNTS_RoutingModule_Settings } from '../../_models/interfaces/routing-module-settings.interface';
-import { DyNTS_RoutingModule } from '../../_services/route/routing-module.service';
-import { DyNTS_TestEmailSink_Controller, DyNTS_TestEmailSinkController_Config } from './test-email-sink.controller';
-
-/**
- * BFR-MASTERPROMPTER-015 (MP-19) — a sent-mail read-endpoint routing-modulja
- * (a `DyNTS_getLogsRoutingModule` mintajara).
- *
- * Hasznalat a fogyaszto routing-jaban (X-E2E-KEY vedelemmel — EROSEN ajanlott):
- *   DyNTS_getSentMailRoutingModule({ authPreProcess: authService.validateE2EKey })
- *
- * Ez a `GET /e2e/sent-mail/get?to=…&since=…&limit=…` endpointot adja. A sink magatol aktiv
- * local/test kornyezetben (lasd `DyNTS_TestEmailSink_Service.isSinkActive`); a read-endpoint
- * beepitett HARD env-gate-tel prod-on mindig 403.
- */
-export function DyNTS_getSentMailRoutingModule(
-  config?: DyNTS_TestEmailSinkController_Config
-): DyNTS_RoutingModule {
-  if (config) {
-    DyNTS_TestEmailSink_Controller.configure(config);
-  }
-
-  const set: DyNTS_RoutingModule_Settings = {
-    route: '/e2e/sent-mail',
-    controllers: [ DyNTS_TestEmailSink_Controller.getInstance() ],
-  };
-
-  return new DyNTS_RoutingModule(set);
-}
+import { DyNTS_RoutingModule_Settings } from '../../_models/interfaces/routing-module-settings.interface';
+import { DyNTS_RoutingModule } from '../../_services/route/routing-module.service';
+import { DyNTS_TestEmailSink_Controller, DyNTS_TestEmailSinkController_Config } from './test-email-sink.controller';
+
+/**
+ * BFR-MASTERPROMPTER-015 (MP-19) — a sent-mail read-endpoint routing-modulja
+ * (a `DyNTS_getLogsRoutingModule` mintajara).
+ *
+ * Hasznalat a fogyaszto routing-jaban (X-E2E-KEY vedelemmel — EROSEN ajanlott):
+ *   DyNTS_getSentMailRoutingModule({ authPreProcess: authService.validateE2EKey })
+ *
+ * Ez a `GET /e2e/sent-mail/get?to=…&since=…&limit=…` endpointot adja. A sink magatol aktiv
+ * local/test kornyezetben (lasd `DyNTS_TestEmailSink_Service.isSinkActive`); a read-endpoint
+ * beepitett HARD env-gate-tel prod-on mindig 403.
+ */
+export function DyNTS_getSentMailRoutingModule(
+  config?: DyNTS_TestEmailSinkController_Config
+): DyNTS_RoutingModule {
+  if (config) {
+    DyNTS_TestEmailSink_Controller.configure(config);
+  }
+
+  const set: DyNTS_RoutingModule_Settings = {
+    route: '/e2e/sent-mail',
+    controllers: [ DyNTS_TestEmailSink_Controller.getInstance() ],
+  };
+
+  return new DyNTS_RoutingModule(set);
+}