@futdevpro/fsm-dynamo 1.20.199 → 1.20.200

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,59 @@
1
+ /**
2
+ * ⚖️ **A szöveg-bemenetek tisztítása — egy közös forrás, kliensnek ÉS szervernek**
3
+ * *(BFR-FUTDEVPRO-130, `core-payment-flow-flawless`)*.
4
+ *
5
+ * Egy vágólapról bekerült nulla-szélességű szóköz, irányjelző vagy nem-törő szóköz egy névben, címben vagy
6
+ * e-mailben **láthatatlanul** eltér attól, amit a felhasználó lát: a számlán más áll, a keresés ⛔ talál, a levél
7
+ * ⛔ jut el. A fizetési úton ennek ⛔ szabad megtörténnie, és a felhasználó erről ⛔ is szól — elmegy.
8
+ *
9
+ * ⭐ **Izomorf** *(az fsm-dynamo kliensen és szerveren is fut)*: a kliens a felhasználónak mutatja a tiszta alakot,
10
+ * a szerver pedig azért **kötelező**, mert a kliens megkerülhető. Ugyanaz a függvény mindkét oldalon ⇒ a kettő
11
+ * ⛔ térhet el.
12
+ *
13
+ * ⚠️ **Ami szándékosan ⛔ nincs benne:** látható karaktert ⛔ vesz el *(kötőjel, pont, perjel)* — egy adószám
14
+ * *(`12345678-2-42`)* vagy egy cím kötőjelei jelentéshordozók. A formátum-normalizálás a mező-specifikus
15
+ * normalizáló dolga *(pl. a VIES adószám-normalizálója)*.
16
+ *
17
+ * Előzmény: a `fdp-credit-service` és a `futdevpro` ugyanezt saját másolatban tartotta *(`InputTextClean_Util`)*;
18
+ * ez a közös alak, ugyanazzal a viselkedéssel ⇒ az átállás egy import-csere.
19
+ */
20
+ export declare class DyFM_InputTextClean_Util {
21
+ /**
22
+ * ⭐ **A láthatatlan és formázó karakterek** — egy név / cím / e-mail / adószám szövegében **soha** nem
23
+ * jelentéshordozók: lágy kötőjel *(`U+00AD`)*, nulla-szélességű és irányjelző karakterek *(`U+200B–U+200F`,
24
+ * `U+202A–U+202E`, `U+2060`, `U+2066–U+2069`)*, BOM *(`U+FEFF`)*.
25
+ *
26
+ * ⚠️ **Kódpont-escape-ekkel**, ⛔ literálisan — egy láthatatlan karakter a forrásban olvashatatlan, és egy
27
+ * szerkesztő csendben eldobhatja. Egy karakter-osztály belseje *(`[` és `]` nélkül)*, hogy más mintába is
28
+ * beépíthető legyen.
29
+ */
30
+ static readonly invisibleClass: string;
31
+ /** A láthatatlan karakterek — globális törléshez. */
32
+ private static readonly invisible;
33
+ /**
34
+ * Egysoros szöveg: a láthatatlan karakterek **kiesnek**, a bármilyen szóköz-futam *(nem-törő szóköz, tabulátor,
35
+ * sortörés)* **egyetlen** szóközzé válik, és a két vége **levágódik**.
36
+ *
37
+ * @param raw bármilyen bemenet; hiánynál *(`null` / `undefined`)* üres szöveg, ⛔ `"undefined"`
38
+ * @returns a tisztított szöveg
39
+ */
40
+ static clean(raw: unknown): string;
41
+ /**
42
+ * E-mail-cím: tisztítva, **belső szóköz nélkül** és **kisbetűsen** *(a nagybetűs alak a nyugta-levél és a
43
+ * keresés útján tér el)*.
44
+ *
45
+ * @param raw bármilyen bemenet
46
+ * @returns a tisztított, kisbetűs cím *(hiánynál üres szöveg)*
47
+ */
48
+ static email(raw: unknown): string;
49
+ /**
50
+ * Opcionális mező: hiányzó mezőt ⛔ hoz létre, csak a meglévőt tisztítja. Az üres eredmény `undefined` — a
51
+ * kötelező mezőről a modell ellenőrzése dönt, ⛔ egy üres szöveg csúszik át rajta.
52
+ *
53
+ * @param value a mező értéke
54
+ * @param cleaner a tisztító *(alapból a `clean`; e-mailhez az `email`)*
55
+ * @returns a tisztított érték, vagy `undefined`
56
+ */
57
+ static optional(value: unknown, cleaner?: (raw: unknown) => string): string | undefined;
58
+ }
59
+ //# sourceMappingURL=input-text-clean.util.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"input-text-clean.util.d.ts","sourceRoot":"","sources":["../../../src/_collections/utils/input-text-clean.util.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,wBAAwB;IAEnC;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAwE;IAE9G,qDAAqD;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAA2E;IAE5G;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAYlC;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAIlC;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CACb,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAuC,GACjE,MAAM,GAAG,SAAS;CAOtB"}
@@ -0,0 +1,79 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.DyFM_InputTextClean_Util = void 0;
4
+ /**
5
+ * ⚖️ **A szöveg-bemenetek tisztítása — egy közös forrás, kliensnek ÉS szervernek**
6
+ * *(BFR-FUTDEVPRO-130, `core-payment-flow-flawless`)*.
7
+ *
8
+ * Egy vágólapról bekerült nulla-szélességű szóköz, irányjelző vagy nem-törő szóköz egy névben, címben vagy
9
+ * e-mailben **láthatatlanul** eltér attól, amit a felhasználó lát: a számlán más áll, a keresés ⛔ talál, a levél
10
+ * ⛔ jut el. A fizetési úton ennek ⛔ szabad megtörténnie, és a felhasználó erről ⛔ is szól — elmegy.
11
+ *
12
+ * ⭐ **Izomorf** *(az fsm-dynamo kliensen és szerveren is fut)*: a kliens a felhasználónak mutatja a tiszta alakot,
13
+ * a szerver pedig azért **kötelező**, mert a kliens megkerülhető. Ugyanaz a függvény mindkét oldalon ⇒ a kettő
14
+ * ⛔ térhet el.
15
+ *
16
+ * ⚠️ **Ami szándékosan ⛔ nincs benne:** látható karaktert ⛔ vesz el *(kötőjel, pont, perjel)* — egy adószám
17
+ * *(`12345678-2-42`)* vagy egy cím kötőjelei jelentéshordozók. A formátum-normalizálás a mező-specifikus
18
+ * normalizáló dolga *(pl. a VIES adószám-normalizálója)*.
19
+ *
20
+ * Előzmény: a `fdp-credit-service` és a `futdevpro` ugyanezt saját másolatban tartotta *(`InputTextClean_Util`)*;
21
+ * ez a közös alak, ugyanazzal a viselkedéssel ⇒ az átállás egy import-csere.
22
+ */
23
+ class DyFM_InputTextClean_Util {
24
+ /**
25
+ * ⭐ **A láthatatlan és formázó karakterek** — egy név / cím / e-mail / adószám szövegében **soha** nem
26
+ * jelentéshordozók: lágy kötőjel *(`U+00AD`)*, nulla-szélességű és irányjelző karakterek *(`U+200B–U+200F`,
27
+ * `U+202A–U+202E`, `U+2060`, `U+2066–U+2069`)*, BOM *(`U+FEFF`)*.
28
+ *
29
+ * ⚠️ **Kódpont-escape-ekkel**, ⛔ literálisan — egy láthatatlan karakter a forrásban olvashatatlan, és egy
30
+ * szerkesztő csendben eldobhatja. Egy karakter-osztály belseje *(`[` és `]` nélkül)*, hogy más mintába is
31
+ * beépíthető legyen.
32
+ */
33
+ static invisibleClass = '\\u00AD\\u200B-\\u200F\\u202A-\\u202E\\u2060\\u2066-\\u2069\\uFEFF';
34
+ /** A láthatatlan karakterek — globális törléshez. */
35
+ static invisible = new RegExp(`[${DyFM_InputTextClean_Util.invisibleClass}]`, 'g');
36
+ /**
37
+ * Egysoros szöveg: a láthatatlan karakterek **kiesnek**, a bármilyen szóköz-futam *(nem-törő szóköz, tabulátor,
38
+ * sortörés)* **egyetlen** szóközzé válik, és a két vége **levágódik**.
39
+ *
40
+ * @param raw bármilyen bemenet; hiánynál *(`null` / `undefined`)* üres szöveg, ⛔ `"undefined"`
41
+ * @returns a tisztított szöveg
42
+ */
43
+ static clean(raw) {
44
+ if (raw === null || raw === undefined) {
45
+ return '';
46
+ }
47
+ // a lathatatlan karakterek ki, a szokoz-futam egy szokoz, a ket vege levagva
48
+ return `${raw}`
49
+ .replace(DyFM_InputTextClean_Util.invisible, '')
50
+ .replace(/\s+/g, ' ')
51
+ .trim();
52
+ }
53
+ /**
54
+ * E-mail-cím: tisztítva, **belső szóköz nélkül** és **kisbetűsen** *(a nagybetűs alak a nyugta-levél és a
55
+ * keresés útján tér el)*.
56
+ *
57
+ * @param raw bármilyen bemenet
58
+ * @returns a tisztított, kisbetűs cím *(hiánynál üres szöveg)*
59
+ */
60
+ static email(raw) {
61
+ return DyFM_InputTextClean_Util.clean(raw).replace(/\s/g, '').toLowerCase();
62
+ }
63
+ /**
64
+ * Opcionális mező: hiányzó mezőt ⛔ hoz létre, csak a meglévőt tisztítja. Az üres eredmény `undefined` — a
65
+ * kötelező mezőről a modell ellenőrzése dönt, ⛔ egy üres szöveg csúszik át rajta.
66
+ *
67
+ * @param value a mező értéke
68
+ * @param cleaner a tisztító *(alapból a `clean`; e-mailhez az `email`)*
69
+ * @returns a tisztított érték, vagy `undefined`
70
+ */
71
+ static optional(value, cleaner = DyFM_InputTextClean_Util.clean) {
72
+ if (value === null || value === undefined) {
73
+ return undefined;
74
+ }
75
+ return cleaner(value) || undefined;
76
+ }
77
+ }
78
+ exports.DyFM_InputTextClean_Util = DyFM_InputTextClean_Util;
79
+ //# sourceMappingURL=input-text-clean.util.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"input-text-clean.util.js","sourceRoot":"","sources":["../../../src/_collections/utils/input-text-clean.util.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,wBAAwB;IAEnC;;;;;;;;OAQG;IACH,MAAM,CAAU,cAAc,GAAW,oEAAoE,CAAC;IAE9G,qDAAqD;IAC7C,MAAM,CAAU,SAAS,GAAW,IAAI,MAAM,CAAC,IAAI,wBAAwB,CAAC,cAAc,GAAG,EAAE,GAAG,CAAC,CAAC;IAE5G;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,GAAY;QACvB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,6EAA6E;QAC7E,OAAO,GAAG,GAAG,EAAE;aACZ,OAAO,CAAC,wBAAwB,CAAC,SAAS,EAAE,EAAE,CAAC;aAC/C,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;aACpB,IAAI,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,GAAY;QACvB,OAAO,wBAAwB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9E,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CACb,KAAc,EACd,UAAoC,wBAAwB,CAAC,KAAK;QAElE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;IACrC,CAAC;;AA/DH,4DAgEC"}
package/build/index.d.ts CHANGED
@@ -13,6 +13,7 @@ export * from './_collections/utils/round-list.util';
13
13
  export * from './_collections/utils/secret-mask.util';
14
14
  export * from './_collections/utils/doc-only-path.util';
15
15
  export * from './_collections/utils/hu-calendar.util';
16
+ export * from './_collections/utils/input-text-clean.util';
16
17
  export * from './_collections/utils/object.util';
17
18
  export * from './_collections/utils/require-env.util';
18
19
  export * from './_collections/utils/stack.util';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/build/index.js CHANGED
@@ -19,6 +19,7 @@ tslib_1.__exportStar(require("./_collections/utils/round-list.util"), exports);
19
19
  tslib_1.__exportStar(require("./_collections/utils/secret-mask.util"), exports);
20
20
  tslib_1.__exportStar(require("./_collections/utils/doc-only-path.util"), exports);
21
21
  tslib_1.__exportStar(require("./_collections/utils/hu-calendar.util"), exports);
22
+ tslib_1.__exportStar(require("./_collections/utils/input-text-clean.util"), exports);
22
23
  tslib_1.__exportStar(require("./_collections/utils/object.util"), exports);
23
24
  tslib_1.__exportStar(require("./_collections/utils/require-env.util"), exports);
24
25
  tslib_1.__exportStar(require("./_collections/utils/stack.util"), exports);
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,cAAc;AACd,wBAAwB;AACxB,oFAA0D;AAC1D,wFAA8D;AAC9D,yFAA+D;AAC/D,iFAAuD;AACvD,+EAAqD;AAErD,oBAAoB;AACpB,0EAAgD;AAChD,0EAAgD;AAChD,yEAA+C;AAC/C,0FAAgE;AAChE,sFAA4D;AAC5D,wEAA8C;AAC9C,+EAAqD;AACrD,gFAAsD;AACtD,kFAAwD;AACxD,gFAAsD;AACtD,2EAAiD;AACjD,gFAAsD;AACtD,0EAAgD;AAChD,2EAAiD;AACjD,gFAAsD;AACtD,sFAA4D;AAC5D,yEAA+C;AAC/C,yEAA+C;AAC/C,0FAAgE;AAChE,8EAAoD;AACpD,oFAA0D;AAC1D,yFAA+D;AAC/D,kFAAwD;AACxD,qFAA2D;AAC3D,yEAA+C;AAC/C,oFAA0D;AAE1D,yBAAyB;AACzB,oFAA0D;AAC1D,8EAAoD;AACpD,gFAAsD;AACtD,sFAA4D;AAC5D,iFAAuD;AAEvD,2BAA2B;AAC3B,yFAA+D;AAC/D,gFAAsD;AACtD,yFAA+D;AAG/D,QAAQ;AACR,4EAAkD;AAClD,wEAA8C;AAC9C,yEAA+C;AAC/C,oEAA0C;AAC1C,qEAA2C;AAC3C,kEAAwC;AACxC,4EAAkD;AAClD,gFAAsD;AACtD,mFAAyD;AACzD,iFAAuD;AAEvD,aAAa;AACb,4EAAkD;AAClD,6EAAmD;AACnD,gFAAsD;AAEtD,aAAa;AACb,yEAA+C;AAC/C,mEAAyC;AACzC,2EAAiD;AAGjD,SAAS;AACT,wBAAwB;AACxB,mGAAyE;AACzE,qGAA2E;AAC3E,sGAA4E;AAC5E,wGAA8E;AAC9E,uFAA6D;AAC7D,mGAAyE;AACzE,oGAA0E;AAC1E,sFAA4D;AAC5D,qFAA2D;AAC3D,yFAA+D;AAC/D,6FAAmE;AACnE,+FAAqE;AACrE,gHAAsF;AACtF,4GAAkF;AAElF,6BAA6B;AAC7B,0GAAgF;AAChF,mGAAyE;AACzE,iGAAuE;AAEvE,qBAAqB;AACrB,kFAAwD;AACxD,oFAA0D;AAE1D,oBAAoB;AACpB,oFAA0D;AAC1D,wFAA8D;AAC9D,oFAA0D;AAC1D,2FAAiE;AACjE,gGAAsE;AACtE,yFAA+D;AAC/D,8FAAoE;AACpE,4FAAkE;AAClE,8FAAoE;AACpE,+FAAqE;AACrE,mGAAyE;AACzE,kGAAwE;AACxE,+FAAqE;AACrE,gGAAsE;AACtE,+EAAqD;AACrD,uFAA6D;AAC7D,wFAA8D;AAC9D,sFAA4D;AAC5D,uFAA6D;AAC7D,iGAAuE;AACvE,iFAAuD;AAEvD,gCAAgC;AAChC,yGAA+E;AAC/E,qGAA2E;AAE3E,eAAe;AACf,yEAA+C;AAC/C,uEAA6C;AAC7C,yEAA+C;AAC/C,uEAA6C"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,cAAc;AACd,wBAAwB;AACxB,oFAA0D;AAC1D,wFAA8D;AAC9D,yFAA+D;AAC/D,iFAAuD;AACvD,+EAAqD;AAErD,oBAAoB;AACpB,0EAAgD;AAChD,0EAAgD;AAChD,yEAA+C;AAC/C,0FAAgE;AAChE,sFAA4D;AAC5D,wEAA8C;AAC9C,+EAAqD;AACrD,gFAAsD;AACtD,kFAAwD;AACxD,gFAAsD;AACtD,qFAA2D;AAC3D,2EAAiD;AACjD,gFAAsD;AACtD,0EAAgD;AAChD,2EAAiD;AACjD,gFAAsD;AACtD,sFAA4D;AAC5D,yEAA+C;AAC/C,yEAA+C;AAC/C,0FAAgE;AAChE,8EAAoD;AACpD,oFAA0D;AAC1D,yFAA+D;AAC/D,kFAAwD;AACxD,qFAA2D;AAC3D,yEAA+C;AAC/C,oFAA0D;AAE1D,yBAAyB;AACzB,oFAA0D;AAC1D,8EAAoD;AACpD,gFAAsD;AACtD,sFAA4D;AAC5D,iFAAuD;AAEvD,2BAA2B;AAC3B,yFAA+D;AAC/D,gFAAsD;AACtD,yFAA+D;AAG/D,QAAQ;AACR,4EAAkD;AAClD,wEAA8C;AAC9C,yEAA+C;AAC/C,oEAA0C;AAC1C,qEAA2C;AAC3C,kEAAwC;AACxC,4EAAkD;AAClD,gFAAsD;AACtD,mFAAyD;AACzD,iFAAuD;AAEvD,aAAa;AACb,4EAAkD;AAClD,6EAAmD;AACnD,gFAAsD;AAEtD,aAAa;AACb,yEAA+C;AAC/C,mEAAyC;AACzC,2EAAiD;AAGjD,SAAS;AACT,wBAAwB;AACxB,mGAAyE;AACzE,qGAA2E;AAC3E,sGAA4E;AAC5E,wGAA8E;AAC9E,uFAA6D;AAC7D,mGAAyE;AACzE,oGAA0E;AAC1E,sFAA4D;AAC5D,qFAA2D;AAC3D,yFAA+D;AAC/D,6FAAmE;AACnE,+FAAqE;AACrE,gHAAsF;AACtF,4GAAkF;AAElF,6BAA6B;AAC7B,0GAAgF;AAChF,mGAAyE;AACzE,iGAAuE;AAEvE,qBAAqB;AACrB,kFAAwD;AACxD,oFAA0D;AAE1D,oBAAoB;AACpB,oFAA0D;AAC1D,wFAA8D;AAC9D,oFAA0D;AAC1D,2FAAiE;AACjE,gGAAsE;AACtE,yFAA+D;AAC/D,8FAAoE;AACpE,4FAAkE;AAClE,8FAAoE;AACpE,+FAAqE;AACrE,mGAAyE;AACzE,kGAAwE;AACxE,+FAAqE;AACrE,gGAAsE;AACtE,+EAAqD;AACrD,uFAA6D;AAC7D,wFAA8D;AAC9D,sFAA4D;AAC5D,uFAA6D;AAC7D,iGAAuE;AACvE,iFAAuD;AAEvD,gCAAgC;AAChC,yGAA+E;AAC/E,qGAA2E;AAE3E,eAAe;AACf,yEAA+C;AAC/C,uEAA6C;AAC7C,yEAA+C;AAC/C,uEAA6C"}
@@ -0,0 +1,74 @@
1
+ /**
2
+ * ⚖️ **A szöveg-bemenetek tisztítása — egy közös forrás, kliensnek ÉS szervernek**
3
+ * *(BFR-FUTDEVPRO-130, `core-payment-flow-flawless`)*.
4
+ *
5
+ * Egy vágólapról bekerült nulla-szélességű szóköz, irányjelző vagy nem-törő szóköz egy névben, címben vagy
6
+ * e-mailben **láthatatlanul** eltér attól, amit a felhasználó lát: a számlán más áll, a keresés ⛔ talál, a levél
7
+ * ⛔ jut el. A fizetési úton ennek ⛔ szabad megtörténnie, és a felhasználó erről ⛔ is szól — elmegy.
8
+ *
9
+ * ⭐ **Izomorf** *(az fsm-dynamo kliensen és szerveren is fut)*: a kliens a felhasználónak mutatja a tiszta alakot,
10
+ * a szerver pedig azért **kötelező**, mert a kliens megkerülhető. Ugyanaz a függvény mindkét oldalon ⇒ a kettő
11
+ * ⛔ térhet el.
12
+ *
13
+ * ⚠️ **Ami szándékosan ⛔ nincs benne:** látható karaktert ⛔ vesz el *(kötőjel, pont, perjel)* — egy adószám
14
+ * *(`12345678-2-42`)* vagy egy cím kötőjelei jelentéshordozók. A formátum-normalizálás a mező-specifikus
15
+ * normalizáló dolga *(pl. a VIES adószám-normalizálója)*.
16
+ *
17
+ * Előzmény: a `fdp-credit-service` és a `futdevpro` ugyanezt saját másolatban tartotta *(`InputTextClean_Util`)*;
18
+ * ez a közös alak, ugyanazzal a viselkedéssel ⇒ az átállás egy import-csere.
19
+ */
20
+ export class DyFM_InputTextClean_Util {
21
+ /**
22
+ * ⭐ **A láthatatlan és formázó karakterek** — egy név / cím / e-mail / adószám szövegében **soha** nem
23
+ * jelentéshordozók: lágy kötőjel *(`U+00AD`)*, nulla-szélességű és irányjelző karakterek *(`U+200B–U+200F`,
24
+ * `U+202A–U+202E`, `U+2060`, `U+2066–U+2069`)*, BOM *(`U+FEFF`)*.
25
+ *
26
+ * ⚠️ **Kódpont-escape-ekkel**, ⛔ literálisan — egy láthatatlan karakter a forrásban olvashatatlan, és egy
27
+ * szerkesztő csendben eldobhatja. Egy karakter-osztály belseje *(`[` és `]` nélkül)*, hogy más mintába is
28
+ * beépíthető legyen.
29
+ */
30
+ static invisibleClass = '\\u00AD\\u200B-\\u200F\\u202A-\\u202E\\u2060\\u2066-\\u2069\\uFEFF';
31
+ /** A láthatatlan karakterek — globális törléshez. */
32
+ static invisible = new RegExp(`[${DyFM_InputTextClean_Util.invisibleClass}]`, 'g');
33
+ /**
34
+ * Egysoros szöveg: a láthatatlan karakterek **kiesnek**, a bármilyen szóköz-futam *(nem-törő szóköz, tabulátor,
35
+ * sortörés)* **egyetlen** szóközzé válik, és a két vége **levágódik**.
36
+ *
37
+ * @param raw bármilyen bemenet; hiánynál *(`null` / `undefined`)* üres szöveg, ⛔ `"undefined"`
38
+ * @returns a tisztított szöveg
39
+ */
40
+ static clean(raw) {
41
+ if (raw === null || raw === undefined) {
42
+ return '';
43
+ }
44
+ // a lathatatlan karakterek ki, a szokoz-futam egy szokoz, a ket vege levagva
45
+ return `${raw}`
46
+ .replace(DyFM_InputTextClean_Util.invisible, '')
47
+ .replace(/\s+/g, ' ')
48
+ .trim();
49
+ }
50
+ /**
51
+ * E-mail-cím: tisztítva, **belső szóköz nélkül** és **kisbetűsen** *(a nagybetűs alak a nyugta-levél és a
52
+ * keresés útján tér el)*.
53
+ *
54
+ * @param raw bármilyen bemenet
55
+ * @returns a tisztított, kisbetűs cím *(hiánynál üres szöveg)*
56
+ */
57
+ static email(raw) {
58
+ return DyFM_InputTextClean_Util.clean(raw).replace(/\s/g, '').toLowerCase();
59
+ }
60
+ /**
61
+ * Opcionális mező: hiányzó mezőt ⛔ hoz létre, csak a meglévőt tisztítja. Az üres eredmény `undefined` — a
62
+ * kötelező mezőről a modell ellenőrzése dönt, ⛔ egy üres szöveg csúszik át rajta.
63
+ *
64
+ * @param value a mező értéke
65
+ * @param cleaner a tisztító *(alapból a `clean`; e-mailhez az `email`)*
66
+ * @returns a tisztított érték, vagy `undefined`
67
+ */
68
+ static optional(value, cleaner = DyFM_InputTextClean_Util.clean) {
69
+ if (value === null || value === undefined) {
70
+ return undefined;
71
+ }
72
+ return cleaner(value) || undefined;
73
+ }
74
+ }
@@ -16,6 +16,7 @@ export * from './_collections/utils/round-list.util';
16
16
  export * from './_collections/utils/secret-mask.util';
17
17
  export * from './_collections/utils/doc-only-path.util';
18
18
  export * from './_collections/utils/hu-calendar.util';
19
+ export * from './_collections/utils/input-text-clean.util';
19
20
  export * from './_collections/utils/object.util';
20
21
  export * from './_collections/utils/require-env.util';
21
22
  export * from './_collections/utils/stack.util';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@futdevpro/fsm-dynamo",
3
- "version": "1.20.199",
3
+ "version": "1.20.200",
4
4
  "description": "Full Stack Model Collection for Dynamic (NodeJS-Typescript) Framework called Dynamo, by Future Development Ltd.",
5
5
  "DyBu_settings": {
6
6
  "packageType": "full-stack-package",