@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.
- package/build/_collections/utils/input-text-clean.util.d.ts +59 -0
- package/build/_collections/utils/input-text-clean.util.d.ts.map +1 -0
- package/build/_collections/utils/input-text-clean.util.js +79 -0
- package/build/_collections/utils/input-text-clean.util.js.map +1 -0
- package/build/index.d.ts +1 -0
- package/build/index.d.ts.map +1 -1
- package/build/index.js +1 -0
- package/build/index.js.map +1 -1
- package/build-esm/_collections/utils/input-text-clean.util.js +74 -0
- package/build-esm/index.js +1 -0
- package/package.json +1 -1
|
@@ -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';
|
package/build/index.d.ts.map
CHANGED
|
@@ -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);
|
package/build/index.js.map
CHANGED
|
@@ -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
|
+
}
|
package/build-esm/index.js
CHANGED
|
@@ -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.
|
|
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",
|