@yellowsakura/js-pii-mask 0.8.93 → 0.9.0

package/README.md

@@ -1,4 +1,4 @@
-# js-pii-mask
+# JS PII Mask
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://shields.io/badge/TypeScript-3178C6?logo=TypeScript&logoColor=FFF&style=flat-square)](https://www.typescriptlang.org)
@@ -8,9 +8,9 @@
 
 Simple lightweight PII (Personally Identifiable Information) masking library for **TypeScript / JavaScript**.
 
-It provides **regex-based detection and masking** of common PII patterns, inspired by [OpenAI's guardrails-js](https://github.com/openai/openai-guardrails-js), with a strong focus on **simplicity, predictability, and extensibility**.
+It provides **regex-based detection and masking** of common PII patterns, inspired by [OpenAI's guardrails-js](https://github.com/openai/openai-guardrails-js), with **basic NLP capabilities** to enhance its detection power, and a strong focus on simplicity, predictability, and extensibility.
 
-> ⚠️ Heuristic-based detection: useful in practice, **not a compliance guarantee**.
+> Heuristic-based detection: useful in practice, **not a compliance guarantee**.
 
 ## Contents
 
@@ -19,14 +19,14 @@ It provides **regex-based detection and masking** of common PII patterns, inspir
 3. [Supported PII entities](#supported-pii-entities)
 4. [API reference](#api-reference)
 5. [How it works and recommended use cases](#how-it-works-and-recommended-use-cases)
-6. [Licences](#licences)
+6. [License](#license)
 
 ## Features
 
-- 🔎 Detects **35+ common PII types** (global + regional)
+- 🔎 Detects **40+ common PII types** (global + regional)
 - 🧩 **Custom rules** for managing specific domains
-- ⚡ Fast, dependency-free, sequential processing
-- ❌ **Cannot**: Understand semantic context or perform deep NLP analysis
+- ⚡ Fast, sequential processing
+- 🧠 **Optional lightweight NLP** for dynamic named entities (names, places, orgs)
 - 🔍 **Trade-offs**: Balanced for minimal false positives, but may miss some edge cases
 
 This library is **pattern-based**.
@@ -37,7 +37,7 @@ This library is **pattern-based**.
 **Does NOT**:
 - Understand semantic context
 - Detect unstructured personal data
-- Perform NER or NLP
+- Perform deep NER or NLP
 - Guarantee 100% accuracy
 
 **Expect**:
@@ -83,16 +83,16 @@ mask('Email: admin@example.com, SSN: 123-45-6789')
 import { mask, FixedPIIEntity } from '@yellowsakura/js-pii-mask'
 
 // Mask only specific entity types
-mask("Email: test@example.com, SSN: 123-45-6789", {
+mask('Email: test@example.com, SSN: 123-45-6789', {
   fixedPiiEntities: [FixedPIIEntity.EMAIL_ADDRESS]
 })
-// Output: "Email: <EMAIL_ADDRESS>, SSN: 123-45-6789"
+// → "Email: <EMAIL_ADDRESS>, SSN: 123-45-6789"
 
 // Mask only financial information
-mask("Card: 1234-5678-9012-3456, Email: test@example.com", {
+mask('Card: 1234-5678-9012-3456, Email: test@example.com', {
   fixedPiiEntities: [FixedPIIEntity.CREDIT_CARD, FixedPIIEntity.US_BANK_NUMBER]
 })
-// Output: "Card: <CREDIT_CARD>, Email: test@example.com"
+// → "Card: <CREDIT_CARD>, Email: test@example.com"
 ```
 
 ### Custom rules
@@ -126,12 +126,39 @@ mask('Employee EMP-12345 (email: john@company.com) submitted ticket', {
   ],
   fixedPiiEntities: [FixedPIIEntity.EMAIL_ADDRESS]
 })
-// Output: "Employee <EMPLOYEE_ID> (email: <EMAIL_ADDRESS>) submitted ticket"
+// → "Employee <EMPLOYEE_ID> (email: <EMAIL_ADDRESS>) submitted ticket"
 ```
 
+### Using NLP (Lightweight)
+
+You can enable **N**atural **L**anguage **P**rocessing to detect dynamic entities like names, places, and organizations.  
+This uses the [compromise](https://www.npmjs.com/package/compromise) library.
+
+```ts
+import { mask, NlpEntity } from '@yellowsakura/js-pii-mask'
+
+// Enable default NLP entities (People, Places, Orgs, etc.)
+mask('John Smith visited Paris', { nlp: true })
+// → "<PEOPLE> visited <PLACES>"
+
+// Selective NLP entities
+mask('Google bought Fitbit for $2.1 billion', { 
+  nlpRules: [NlpEntity.ORGS, NlpEntity.MONEY] 
+})
+// → "<ORGS> bought <ORGS> for <MONEY>"
+```
+
+> **⚠️ NLP Limitations & Best Practices**
+> 
+> The NLP feature is powered by `compromise`, a lightweight library designed to be fast rather than perfect.
+>
+> - **Language Support**: Optimized primarily for **English**. Accuracy in other languages is limited.
+> - **Accuracy**: Expect higher false positives/negatives than deep-learning based NER models.
+> - **Performance**: Little slower than pure regex regex-based masking.
+
 ## Supported PII entities
 
-The library includes **35+ predefined patterns**, including:
+The library includes **40+ predefined patterns**, including:
 
 ### Global
 - EMAIL_ADDRESS
@@ -142,6 +169,13 @@ The library includes **35+ predefined patterns**, including:
 - URL
 - DATE_TIME
 
+### NLP Entities (Dynamic)
+- PEOPLE (Names)
+- PLACES (Locations, Cities, Countries)
+- ORGS (Organizations, Companies)
+- MONEY (Currency amounts)
+- ACRONYMS
+
 ### Country-specific (examples)
 - US: SSN, Passport, Bank Number, ITIN
 - UK: NHS, NINO
@@ -150,7 +184,7 @@ The library includes **35+ predefined patterns**, including:
 
 Some entities require **context keywords** (e.g. `CVV`, `BIC_SWIFT`) to reduce false positives.
 
-For overlapping patterns, explicitly specify `fixedPiiEntities`, see [`src/pii-fixed-rules.ts`](./src/pii-fixed-rules.ts) for an exhaustive list.
+See [`src/pii-nlp.ts`](./src/pii-nlp.ts) and [`src/pii-fixed-rules.ts`](./src/pii-fixed-rules.ts) for an exhaustive list.
 
 ## API reference
 
@@ -169,12 +203,24 @@ type MaskOptions = {
   // Array of custom masking rules (always applied FIRST)
   customRules?: CustomRule[]
 
+  // Enable NLP processing (default: false)
+  nlp?: boolean
+
+  // Specific NLP entities to detect (default: all if nlp=true)
+  nlpRules?: NlpEntity[]
+
   // Array of specific fixed PII entities to detect (always applied AFTER custom rules)
   // If empty or undefined, ALL fixed entities are checked
   fixedPiiEntities?: FixedPIIEntity[]
 }
 ```
 
+**Order of execution:**
+1. **NLP Rules** (if enabled)
+2. **Custom Rules** (if defined)
+3. **Fixed PII Rules**
+```
+
 **Returns:** 
 - `string` - The masked text with PII replaced by `<REPLACED>` placeholders
 
@@ -198,12 +244,6 @@ interface CustomRule {
 
 **Examples:**
 ```ts
-// Good: Specific pattern with word boundaries
-{
-  pattern: /\bEMP-\d{5}\b/g,
-  replacement: 'EMPLOYEE_ID'
-}
-
 // Good: Case-insensitive matching
 {
   pattern: /ticket-[a-z0-9]{8}/gi,
@@ -216,10 +256,27 @@ interface CustomRule {
   replacement: 'NUMBER'
 }
 ```
+### `NlpEntity` Enum
+
+Enumeration of all predefined NLP entity types, import to specify which entities to detect:
+
+```ts
+import { NlpEntity } from '@yellowsakura/js-pii-mask'
+
+mask(text, {
+  nlpRules: [
+    NlpEntity.ACRONYMS,
+    NlpEntity.MONEY,
+    NlpEntity.ORGS,
+    NlpEntity.PEOPLE,
+    NlpEntity.PLACES
+  ]
+})
+```
 
 ### `FixedPIIEntity` Enum
 
-Enumeration of all predefined PII entity types. Import to specify which entities to detect:
+Enumeration of all predefined PII entity types, import to specify which entities to detect:
 
 ```ts
 import { FixedPIIEntity } from '@yellowsakura/js-pii-mask'
@@ -228,7 +285,8 @@ mask(text, {
   fixedPiiEntities: [
     FixedPIIEntity.EMAIL_ADDRESS,
     FixedPIIEntity.PHONE_NUMBER,
-    FixedPIIEntity.US_SSN
+    FixedPIIEntity.US_SSN,
+    ...
   ]
 })
 ```
@@ -236,28 +294,27 @@ mask(text, {
 ## How it works and recommended use cases:
 
 1. Unicode normalization (NFKC, zero-width removal)
-2. Apply custom rules (in order)
-3. Apply fixed PII rules (all or selected)
-4. Replace matches inline
+2. Apply NLP Rules
+3. Apply custom rules (in order)
+4. Apply fixed PII rules (all or selected)
 
 Deterministic, sequential, and predictable.
 
-## Use cases
+### Use cases
 
-✅ Test / staging data anonymization
-✅ API response redaction
-✅ Preprocessing before third-party services (e.g. LLM)
+✅ Test / staging data anonymization  
+✅ API response redaction  
+✅ Preprocessing before third-party services (e.g. LLM)  
 ✅ Masking internal identifiers
 
 ⚠️ Use with caution for:
-- Legal, medical, or financial documents
+- Legal, medical, or financial documents  
 - Automated compliance enforcement
 
 ❌ Not suitable as a standalone compliance solution.
 
-# License
+## License
 
 The code is licensed under the [MIT](https://opensource.org/licenses/MIT) by [Yellow Sakura](https://www.yellowsakura.com), [support@yellowsakura.com](mailto:support@yellowsakura.com), see the LICENSE file.  
-For more details, please refer to the [project page](https://www.yellowsakura.com/en/projects/js-pii-mask).
 
 This library is adapted from [OpenAI's guardrails-js](https://github.com/openai/openai-guardrails-js) PII detection patterns.

package/dist/index.cjs

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));const c=s(require(`compromise`));let l=function(e){return e.ACRONYMS=`acronyms`,e.MONEY=`money`,e.ORGS=`organizations`,e.PEOPLE=`people`,e.PLACES=`places`,e}({});function u(e,t=Object.values(l)){if(!e||t.length===0)return e;let n=(0,c.default)(e);return t.forEach(t=>{let r=n[t]().out(`array`);r.forEach(n=>{e=e.replaceAll(n,`<${t.toUpperCase()}>`)})}),e}function d(e,t){if(!e||!t||t.length===0)return e;for(let n of t){if(!n.pattern||n.replacement===void 0)continue;e=e.replace(n.pattern,`<${n.replacement}>`)}return e}let f=function(e){return e.CREDIT_CARD=`CREDIT_CARD`,e.CRYPTO=`CRYPTO`,e.DATE_TIME=`DATE_TIME`,e.EMAIL_ADDRESS=`EMAIL_ADDRESS`,e.IBAN_CODE=`IBAN_CODE`,e.IP_ADDRESS=`IP_ADDRESS`,e.PHONE_NUMBER=`PHONE_NUMBER`,e.URL=`URL`,e.CVV=`CVV`,e.BIC_SWIFT=`BIC_SWIFT`,e.US_BANK_NUMBER=`US_BANK_NUMBER`,e.US_DRIVER_LICENSE=`US_DRIVER_LICENSE`,e.US_ITIN=`US_ITIN`,e.US_PASSPORT=`US_PASSPORT`,e.US_SSN=`US_SSN`,e.UK_NHS=`UK_NHS`,e.UK_NINO=`UK_NINO`,e.ES_NIF=`ES_NIF`,e.ES_NIE=`ES_NIE`,e.IT_FISCAL_CODE=`IT_FISCAL_CODE`,e.IT_DOCUMENT=`IT_DOCUMENT`,e.IT_VAT_CODE=`IT_VAT_CODE`,e.PL_PESEL=`PL_PESEL`,e.FI_PERSONAL_IDENTITY_CODE=`FI_PERSONAL_IDENTITY_CODE`,e.SG_NRIC_FIN=`SG_NRIC_FIN`,e.SG_UEN=`SG_UEN`,e.AU_ABN=`AU_ABN`,e.AU_ACN=`AU_ACN`,e.AU_TFN=`AU_TFN`,e.AU_MEDICARE=`AU_MEDICARE`,e.IN_PAN=`IN_PAN`,e.IN_AADHAAR=`IN_AADHAAR`,e.IN_VEHICLE_REGISTRATION=`IN_VEHICLE_REGISTRATION`,e.IN_VOTER=`IN_VOTER`,e.IN_PASSPORT=`IN_PASSPORT`,e.KR_RRN=`KR_RRN`,e}({});const p=[`(?:[sS][wW][iI][fF][tT])`,`(?:[bB][iI][cC])`,`(?:[bB][aA][nN][kK][\\s-]?[cC][oO][dD][eE])`,`(?:[sS][wW][iI][fF][tT][\\s-]?[cC][oO][dD][eE])`,`(?:[bB][iI][cC][\\s-]?[cC][oO][dD][eE])`].join(`|`),m=RegExp(`(?:${p})[:\\s=]+([A-Z]{4}[A-Z]{2}[A-Z0-9]{2}(?:[A-Z0-9]{3})?)\\b`,`g`),h={[f.CREDIT_CARD]:[/\b\d{4}[-\s]?\d{4}[-\s]?\d{4}[-\s]?\d{4}\b/g],[f.CRYPTO]:[/\b[13][a-km-zA-HJ-NP-Z1-9]{25,34}\b/g],[f.DATE_TIME]:[/\b(0[1-9]|1[0-2])[/-](0[1-9]|[12]\d|3[01])[/-](19|20)\d{2}\b/g],[f.EMAIL_ADDRESS]:[/\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/g,RegExp(`(?<=[?&=/])[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}`,`g`)],[f.IBAN_CODE]:[/\b[A-Z]{2}[0-9]{2}[A-Z0-9]{4}[0-9]{7}([A-Z0-9]?){0,16}\b/g],[f.IP_ADDRESS]:[/\b(?:[0-9]{1,3}\.){3}[0-9]{1,3}\b/g,/\b(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}\b/g,/\b(?:[0-9a-fA-F]{1,4}:){1,7}:|:(?::[0-9a-fA-F]{1,4}){1,7}\b/g],[f.PHONE_NUMBER]:[/\b(\+\d{1,3}[-.\s]?)?\(?\d{3}\)?[-.\s]?\d{3}[-.\s]?\d{4}\b/g],[f.URL]:[/\bhttps?:\/\/(?:[-\w.])+(?::[0-9]+)?(?:\/(?:[\w/_.])*(?:\?(?:[\w&=%.])*)?(?:#(?:[\w.])*)?)?/g],[f.CVV]:[/\b(?:cvv|cvc|security\s*code|card\s*code)[\s:=]*[0-9]{3,4}\b/gi],[f.BIC_SWIFT]:[m],[f.US_BANK_NUMBER]:[/\b\d{8,17}\b/g],[f.US_DRIVER_LICENSE]:[/\b[A-Z]\d{7}\b/g],[f.US_ITIN]:[/\b9\d{2}-\d{2}-\d{4}\b/g],[f.US_PASSPORT]:[/\b[A-Z]\d{8}\b/g],[f.US_SSN]:[/\b\d{3}-\d{2}-\d{4}\b|\b\d{9}\b/g],[f.UK_NHS]:[/\b\d{3} \d{3} \d{4}\b/g],[f.UK_NINO]:[/\b[A-Z]{2}\d{6}[A-Z]\b/g],[f.ES_NIF]:[/\b\d{8}[A-Z]\b/g],[f.ES_NIE]:[/\b[XYZ]\d{7}[A-Z]\b/g],[f.IT_FISCAL_CODE]:[/\b[A-Z]{6}\d{2}[A-Z]\d{2}[A-Z]\d{3}[A-Z]\b/g],[f.IT_DOCUMENT]:[/\b[A-Z]{2}\d{7}\b/g],[f.IT_VAT_CODE]:[/\bIT\d{11}\b/g],[f.PL_PESEL]:[/\b\d{11}\b/g],[f.FI_PERSONAL_IDENTITY_CODE]:[/\b\d{6}[+-A]\d{3}[A-Z0-9]\b/g],[f.SG_NRIC_FIN]:[/\b[A-Z]\d{7}[A-Z]\b/g],[f.SG_UEN]:[/\b\d{8}[A-Z]\b|\b\d{9}[A-Z]\b/g],[f.AU_ABN]:[/\b\d{2} \d{3} \d{3} \d{3}\b/g],[f.AU_ACN]:[/\b\d{3} \d{3} \d{3}\b/g],[f.AU_TFN]:[/\b\d{9}\b/g],[f.AU_MEDICARE]:[/\b\d{4} \d{5} \d{1}\b/g],[f.IN_PAN]:[/\b[A-Z]{5}\d{4}[A-Z]\b/g],[f.IN_AADHAAR]:[/\b\d{4} \d{4} \d{4}\b/g],[f.IN_VEHICLE_REGISTRATION]:[/\b[A-Z]{2}\d{2}[A-Z]{2}\d{4}\b/g],[f.IN_VOTER]:[/\b[A-Z]{3}\d{7}\b/g],[f.IN_PASSPORT]:[/\b[A-Z]\d{7}\b/g],[f.KR_RRN]:[/\b\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])-[1-4]\d{6}\b/g]};function g(e,t=Object.values(f)){if(!e)return e;for(let n of t){let t=h[n];if(!t||!t.length)continue;for(let r of t)e=e.replace(r,`<${n}>`)}return e}function _(e){if(!e)return e;let t=/(?:\u200B|\u200C|\u200D|\u2060|\uFEFF)/g;try{return e.normalize(`NFKC`).replace(t,``)}catch{return e.replace(t,``)}}function v(e,t){let{nlp:n=!1,nlpRules:r=[],customRules:i=[],fixedPiiEntities:a=[]}=t||{},o=_(e);return(n||r.length>0)&&(o=r.length==0?u(o):u(o,r)),i.length>0&&(o=d(o,i)),a.length>0?g(o,a):g(o)}exports.FixedPIIEntity=f,exports.NlpEntity=l,exports.mask=v;

package/dist/{index.d.mts → index.d.cts}

@@ -1,7 +1,9 @@
+import { NlpEntity } from './pii-nlp';
 import { CustomRule } from './pii-custom-rules';
 import { FixedPIIEntity } from './pii-fixed-rules';
 export type { CustomRule } from './pii-custom-rules';
 export { FixedPIIEntity } from './pii-fixed-rules';
+export { NlpEntity } from './pii-nlp';
 /**
  * Configuration options for the `mask` function.
  *
@@ -13,6 +15,8 @@ export { FixedPIIEntity } from './pii-fixed-rules';
  * Both properties are optional.
  */
 type MaskOptions = {
+    nlp?: boolean;
+    nlpRules?: NlpEntity[];
     customRules?: CustomRule[];
     fixedPiiEntities?: FixedPIIEntity[];
 };

package/dist/index.d.ts

@@ -1,7 +1,9 @@
+import { NlpEntity } from './pii-nlp';
 import { CustomRule } from './pii-custom-rules';
 import { FixedPIIEntity } from './pii-fixed-rules';
 export type { CustomRule } from './pii-custom-rules';
 export { FixedPIIEntity } from './pii-fixed-rules';
+export { NlpEntity } from './pii-nlp';
 /**
  * Configuration options for the `mask` function.
  *
@@ -13,6 +15,8 @@ export { FixedPIIEntity } from './pii-fixed-rules';
  * Both properties are optional.
  */
 type MaskOptions = {
+    nlp?: boolean;
+    nlpRules?: NlpEntity[];
     customRules?: CustomRule[];
     fixedPiiEntities?: FixedPIIEntity[];
 };

package/dist/index.js

@@ -1 +1 @@
-function e(e,t){if(!e||!t||t.length===0)return e;for(let n of t){if(!n.pattern||n.replacement===void 0)continue;e=e.replace(n.pattern,`<${n.replacement}>`)}return e}let t=function(e){return e.CREDIT_CARD=`CREDIT_CARD`,e.CRYPTO=`CRYPTO`,e.DATE_TIME=`DATE_TIME`,e.EMAIL_ADDRESS=`EMAIL_ADDRESS`,e.IBAN_CODE=`IBAN_CODE`,e.IP_ADDRESS=`IP_ADDRESS`,e.PHONE_NUMBER=`PHONE_NUMBER`,e.URL=`URL`,e.CVV=`CVV`,e.BIC_SWIFT=`BIC_SWIFT`,e.US_BANK_NUMBER=`US_BANK_NUMBER`,e.US_DRIVER_LICENSE=`US_DRIVER_LICENSE`,e.US_ITIN=`US_ITIN`,e.US_PASSPORT=`US_PASSPORT`,e.US_SSN=`US_SSN`,e.UK_NHS=`UK_NHS`,e.UK_NINO=`UK_NINO`,e.ES_NIF=`ES_NIF`,e.ES_NIE=`ES_NIE`,e.IT_FISCAL_CODE=`IT_FISCAL_CODE`,e.IT_DOCUMENT=`IT_DOCUMENT`,e.IT_VAT_CODE=`IT_VAT_CODE`,e.PL_PESEL=`PL_PESEL`,e.FI_PERSONAL_IDENTITY_CODE=`FI_PERSONAL_IDENTITY_CODE`,e.SG_NRIC_FIN=`SG_NRIC_FIN`,e.SG_UEN=`SG_UEN`,e.AU_ABN=`AU_ABN`,e.AU_ACN=`AU_ACN`,e.AU_TFN=`AU_TFN`,e.AU_MEDICARE=`AU_MEDICARE`,e.IN_PAN=`IN_PAN`,e.IN_AADHAAR=`IN_AADHAAR`,e.IN_VEHICLE_REGISTRATION=`IN_VEHICLE_REGISTRATION`,e.IN_VOTER=`IN_VOTER`,e.IN_PASSPORT=`IN_PASSPORT`,e.KR_RRN=`KR_RRN`,e}({});const n=[`(?:[sS][wW][iI][fF][tT])`,`(?:[bB][iI][cC])`,`(?:[bB][aA][nN][kK][\\s-]?[cC][oO][dD][eE])`,`(?:[sS][wW][iI][fF][tT][\\s-]?[cC][oO][dD][eE])`,`(?:[bB][iI][cC][\\s-]?[cC][oO][dD][eE])`].join(`|`),r=RegExp(`(?:${n})[:\\s=]+([A-Z]{4}[A-Z]{2}[A-Z0-9]{2}(?:[A-Z0-9]{3})?)\\b`,`g`),i={[t.CREDIT_CARD]:[/\b\d{4}[-\s]?\d{4}[-\s]?\d{4}[-\s]?\d{4}\b/g],[t.CRYPTO]:[/\b[13][a-km-zA-HJ-NP-Z1-9]{25,34}\b/g],[t.DATE_TIME]:[/\b(0[1-9]|1[0-2])[/-](0[1-9]|[12]\d|3[01])[/-](19|20)\d{2}\b/g],[t.EMAIL_ADDRESS]:[/\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/g,RegExp(`(?<=[?&=/])[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}`,`g`)],[t.IBAN_CODE]:[/\b[A-Z]{2}[0-9]{2}[A-Z0-9]{4}[0-9]{7}([A-Z0-9]?){0,16}\b/g],[t.IP_ADDRESS]:[/\b(?:[0-9]{1,3}\.){3}[0-9]{1,3}\b/g,/\b(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}\b/g,/\b(?:[0-9a-fA-F]{1,4}:){1,7}:|:(?::[0-9a-fA-F]{1,4}){1,7}\b/g],[t.PHONE_NUMBER]:[/\b(\+\d{1,3}[-.\s]?)?\(?\d{3}\)?[-.\s]?\d{3}[-.\s]?\d{4}\b/g],[t.URL]:[/\bhttps?:\/\/(?:[-\w.])+(?::[0-9]+)?(?:\/(?:[\w/_.])*(?:\?(?:[\w&=%.])*)?(?:#(?:[\w.])*)?)?/g],[t.CVV]:[/\b(?:cvv|cvc|security\s*code|card\s*code)[\s:=]*[0-9]{3,4}\b/gi],[t.BIC_SWIFT]:[r],[t.US_BANK_NUMBER]:[/\b\d{8,17}\b/g],[t.US_DRIVER_LICENSE]:[/\b[A-Z]\d{7}\b/g],[t.US_ITIN]:[/\b9\d{2}-\d{2}-\d{4}\b/g],[t.US_PASSPORT]:[/\b[A-Z]\d{8}\b/g],[t.US_SSN]:[/\b\d{3}-\d{2}-\d{4}\b|\b\d{9}\b/g],[t.UK_NHS]:[/\b\d{3} \d{3} \d{4}\b/g],[t.UK_NINO]:[/\b[A-Z]{2}\d{6}[A-Z]\b/g],[t.ES_NIF]:[/\b\d{8}[A-Z]\b/g],[t.ES_NIE]:[/\b[XYZ]\d{7}[A-Z]\b/g],[t.IT_FISCAL_CODE]:[/\b[A-Z]{6}\d{2}[A-Z]\d{2}[A-Z]\d{3}[A-Z]\b/g],[t.IT_DOCUMENT]:[/\b[A-Z]{2}\d{7}\b/g],[t.IT_VAT_CODE]:[/\bIT\d{11}\b/g],[t.PL_PESEL]:[/\b\d{11}\b/g],[t.FI_PERSONAL_IDENTITY_CODE]:[/\b\d{6}[+-A]\d{3}[A-Z0-9]\b/g],[t.SG_NRIC_FIN]:[/\b[A-Z]\d{7}[A-Z]\b/g],[t.SG_UEN]:[/\b\d{8}[A-Z]\b|\b\d{9}[A-Z]\b/g],[t.AU_ABN]:[/\b\d{2} \d{3} \d{3} \d{3}\b/g],[t.AU_ACN]:[/\b\d{3} \d{3} \d{3}\b/g],[t.AU_TFN]:[/\b\d{9}\b/g],[t.AU_MEDICARE]:[/\b\d{4} \d{5} \d{1}\b/g],[t.IN_PAN]:[/\b[A-Z]{5}\d{4}[A-Z]\b/g],[t.IN_AADHAAR]:[/\b\d{4} \d{4} \d{4}\b/g],[t.IN_VEHICLE_REGISTRATION]:[/\b[A-Z]{2}\d{2}[A-Z]{2}\d{4}\b/g],[t.IN_VOTER]:[/\b[A-Z]{3}\d{7}\b/g],[t.IN_PASSPORT]:[/\b[A-Z]\d{7}\b/g],[t.KR_RRN]:[/\b\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])-[1-4]\d{6}\b/g]};function a(e,n=Object.values(t)){if(!e)return e;for(let t of n){let n=i[t];if(!n||!n.length)continue;for(let r of n)e=e.replace(r,`<${t}>`)}return e}function o(e){if(!e)return e;let t=/(?:\u200B|\u200C|\u200D|\u2060|\uFEFF)/g;try{return e.normalize(`NFKC`).replace(t,``)}catch{return e.replace(t,``)}}function s(t,n){let{customRules:r=[],fixedPiiEntities:i=[]}=n||{},s=o(t);return r.length>0&&(s=e(s,r)),i.length>0?a(s,i):a(s)}exports.FixedPIIEntity=t,exports.mask=s;
+import e from"compromise";let t=function(e){return e.ACRONYMS=`acronyms`,e.MONEY=`money`,e.ORGS=`organizations`,e.PEOPLE=`people`,e.PLACES=`places`,e}({});function n(n,r=Object.values(t)){if(!n||r.length===0)return n;let i=e(n);return r.forEach(e=>{let t=i[e]().out(`array`);t.forEach(t=>{n=n.replaceAll(t,`<${e.toUpperCase()}>`)})}),n}function r(e,t){if(!e||!t||t.length===0)return e;for(let n of t){if(!n.pattern||n.replacement===void 0)continue;e=e.replace(n.pattern,`<${n.replacement}>`)}return e}let i=function(e){return e.CREDIT_CARD=`CREDIT_CARD`,e.CRYPTO=`CRYPTO`,e.DATE_TIME=`DATE_TIME`,e.EMAIL_ADDRESS=`EMAIL_ADDRESS`,e.IBAN_CODE=`IBAN_CODE`,e.IP_ADDRESS=`IP_ADDRESS`,e.PHONE_NUMBER=`PHONE_NUMBER`,e.URL=`URL`,e.CVV=`CVV`,e.BIC_SWIFT=`BIC_SWIFT`,e.US_BANK_NUMBER=`US_BANK_NUMBER`,e.US_DRIVER_LICENSE=`US_DRIVER_LICENSE`,e.US_ITIN=`US_ITIN`,e.US_PASSPORT=`US_PASSPORT`,e.US_SSN=`US_SSN`,e.UK_NHS=`UK_NHS`,e.UK_NINO=`UK_NINO`,e.ES_NIF=`ES_NIF`,e.ES_NIE=`ES_NIE`,e.IT_FISCAL_CODE=`IT_FISCAL_CODE`,e.IT_DOCUMENT=`IT_DOCUMENT`,e.IT_VAT_CODE=`IT_VAT_CODE`,e.PL_PESEL=`PL_PESEL`,e.FI_PERSONAL_IDENTITY_CODE=`FI_PERSONAL_IDENTITY_CODE`,e.SG_NRIC_FIN=`SG_NRIC_FIN`,e.SG_UEN=`SG_UEN`,e.AU_ABN=`AU_ABN`,e.AU_ACN=`AU_ACN`,e.AU_TFN=`AU_TFN`,e.AU_MEDICARE=`AU_MEDICARE`,e.IN_PAN=`IN_PAN`,e.IN_AADHAAR=`IN_AADHAAR`,e.IN_VEHICLE_REGISTRATION=`IN_VEHICLE_REGISTRATION`,e.IN_VOTER=`IN_VOTER`,e.IN_PASSPORT=`IN_PASSPORT`,e.KR_RRN=`KR_RRN`,e}({});const a=[`(?:[sS][wW][iI][fF][tT])`,`(?:[bB][iI][cC])`,`(?:[bB][aA][nN][kK][\\s-]?[cC][oO][dD][eE])`,`(?:[sS][wW][iI][fF][tT][\\s-]?[cC][oO][dD][eE])`,`(?:[bB][iI][cC][\\s-]?[cC][oO][dD][eE])`].join(`|`),o=RegExp(`(?:${a})[:\\s=]+([A-Z]{4}[A-Z]{2}[A-Z0-9]{2}(?:[A-Z0-9]{3})?)\\b`,`g`),s={[i.CREDIT_CARD]:[/\b\d{4}[-\s]?\d{4}[-\s]?\d{4}[-\s]?\d{4}\b/g],[i.CRYPTO]:[/\b[13][a-km-zA-HJ-NP-Z1-9]{25,34}\b/g],[i.DATE_TIME]:[/\b(0[1-9]|1[0-2])[/-](0[1-9]|[12]\d|3[01])[/-](19|20)\d{2}\b/g],[i.EMAIL_ADDRESS]:[/\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/g,RegExp(`(?<=[?&=/])[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}`,`g`)],[i.IBAN_CODE]:[/\b[A-Z]{2}[0-9]{2}[A-Z0-9]{4}[0-9]{7}([A-Z0-9]?){0,16}\b/g],[i.IP_ADDRESS]:[/\b(?:[0-9]{1,3}\.){3}[0-9]{1,3}\b/g,/\b(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}\b/g,/\b(?:[0-9a-fA-F]{1,4}:){1,7}:|:(?::[0-9a-fA-F]{1,4}){1,7}\b/g],[i.PHONE_NUMBER]:[/\b(\+\d{1,3}[-.\s]?)?\(?\d{3}\)?[-.\s]?\d{3}[-.\s]?\d{4}\b/g],[i.URL]:[/\bhttps?:\/\/(?:[-\w.])+(?::[0-9]+)?(?:\/(?:[\w/_.])*(?:\?(?:[\w&=%.])*)?(?:#(?:[\w.])*)?)?/g],[i.CVV]:[/\b(?:cvv|cvc|security\s*code|card\s*code)[\s:=]*[0-9]{3,4}\b/gi],[i.BIC_SWIFT]:[o],[i.US_BANK_NUMBER]:[/\b\d{8,17}\b/g],[i.US_DRIVER_LICENSE]:[/\b[A-Z]\d{7}\b/g],[i.US_ITIN]:[/\b9\d{2}-\d{2}-\d{4}\b/g],[i.US_PASSPORT]:[/\b[A-Z]\d{8}\b/g],[i.US_SSN]:[/\b\d{3}-\d{2}-\d{4}\b|\b\d{9}\b/g],[i.UK_NHS]:[/\b\d{3} \d{3} \d{4}\b/g],[i.UK_NINO]:[/\b[A-Z]{2}\d{6}[A-Z]\b/g],[i.ES_NIF]:[/\b\d{8}[A-Z]\b/g],[i.ES_NIE]:[/\b[XYZ]\d{7}[A-Z]\b/g],[i.IT_FISCAL_CODE]:[/\b[A-Z]{6}\d{2}[A-Z]\d{2}[A-Z]\d{3}[A-Z]\b/g],[i.IT_DOCUMENT]:[/\b[A-Z]{2}\d{7}\b/g],[i.IT_VAT_CODE]:[/\bIT\d{11}\b/g],[i.PL_PESEL]:[/\b\d{11}\b/g],[i.FI_PERSONAL_IDENTITY_CODE]:[/\b\d{6}[+-A]\d{3}[A-Z0-9]\b/g],[i.SG_NRIC_FIN]:[/\b[A-Z]\d{7}[A-Z]\b/g],[i.SG_UEN]:[/\b\d{8}[A-Z]\b|\b\d{9}[A-Z]\b/g],[i.AU_ABN]:[/\b\d{2} \d{3} \d{3} \d{3}\b/g],[i.AU_ACN]:[/\b\d{3} \d{3} \d{3}\b/g],[i.AU_TFN]:[/\b\d{9}\b/g],[i.AU_MEDICARE]:[/\b\d{4} \d{5} \d{1}\b/g],[i.IN_PAN]:[/\b[A-Z]{5}\d{4}[A-Z]\b/g],[i.IN_AADHAAR]:[/\b\d{4} \d{4} \d{4}\b/g],[i.IN_VEHICLE_REGISTRATION]:[/\b[A-Z]{2}\d{2}[A-Z]{2}\d{4}\b/g],[i.IN_VOTER]:[/\b[A-Z]{3}\d{7}\b/g],[i.IN_PASSPORT]:[/\b[A-Z]\d{7}\b/g],[i.KR_RRN]:[/\b\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])-[1-4]\d{6}\b/g]};function c(e,t=Object.values(i)){if(!e)return e;for(let n of t){let t=s[n];if(!t||!t.length)continue;for(let r of t)e=e.replace(r,`<${n}>`)}return e}function l(e){if(!e)return e;let t=/(?:\u200B|\u200C|\u200D|\u2060|\uFEFF)/g;try{return e.normalize(`NFKC`).replace(t,``)}catch{return e.replace(t,``)}}function u(e,t){let{nlp:i=!1,nlpRules:a=[],customRules:o=[],fixedPiiEntities:s=[]}=t||{},u=l(e);return(i||a.length>0)&&(u=a.length==0?n(u):n(u,a)),o.length>0&&(u=r(u,o)),s.length>0?c(u,s):c(u)}export{i as FixedPIIEntity,t as NlpEntity,u as mask};

package/dist/pii-nlp.d.cts

@@ -0,0 +1,43 @@
+/**
+ * Supported NLP entity types.
+ *
+ * These map directly to `compromise` library methods for entity extraction.
+ * Useful for detecting dynamic PII that lacks a fixed structure.
+ */
+export declare enum NlpEntity {
+    ACRONYMS = "acronyms",
+    MONEY = "money",
+    ORGS = "organizations",
+    PEOPLE = "people",
+    PLACES = "places"
+}
+/**
+ * Apply NLP-based masking rules to text.
+ *
+ * Uses the `compromise` library to identify and mask dynamic entities.
+ * This function handles the entities sequentially.
+ *
+ * Use Cases:
+ * - Masking names in free text
+ * - Masking cities or organizations
+ *
+ * Limitations:
+ * - Performance: Slower than `applyFixedRules`. Use only when necessary.
+ * - Accuracy: Depends on `compromise` heuristics. Best suited for complete sentences in English.
+ *
+ * @param text - The text to scan and mask
+ * @param entities - List of NLP entity types to detect (defaults to ALL)
+ *
+ * @returns The text with detected entities replaced by placeholders (e.g. <PEOPLE>)
+ *
+ * @example
+ * // Default usage (masks all supported NLP entities)
+ * applyNlpRules("John Smith visited Paris")
+ * // Returns: "<PEOPLE> visited <PLACES>"
+ *
+ * @example
+ * // Selective masking
+ * applyNlpRules("Google bought Fitbit for $2.1 billion", [NlpEntity.ORGS])
+ * // Returns: "<ORGS> bought <ORGS> for $2.1 billion"
+ */
+export declare function applyNlpRules(text: string, entities?: NlpEntity[]): string;

package/dist/pii-nlp.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Supported NLP entity types.
+ *
+ * These map directly to `compromise` library methods for entity extraction.
+ * Useful for detecting dynamic PII that lacks a fixed structure.
+ */
+export declare enum NlpEntity {
+    ACRONYMS = "acronyms",
+    MONEY = "money",
+    ORGS = "organizations",
+    PEOPLE = "people",
+    PLACES = "places"
+}
+/**
+ * Apply NLP-based masking rules to text.
+ *
+ * Uses the `compromise` library to identify and mask dynamic entities.
+ * This function handles the entities sequentially.
+ *
+ * Use Cases:
+ * - Masking names in free text
+ * - Masking cities or organizations
+ *
+ * Limitations:
+ * - Performance: Slower than `applyFixedRules`. Use only when necessary.
+ * - Accuracy: Depends on `compromise` heuristics. Best suited for complete sentences in English.
+ *
+ * @param text - The text to scan and mask
+ * @param entities - List of NLP entity types to detect (defaults to ALL)
+ *
+ * @returns The text with detected entities replaced by placeholders (e.g. <PEOPLE>)
+ *
+ * @example
+ * // Default usage (masks all supported NLP entities)
+ * applyNlpRules("John Smith visited Paris")
+ * // Returns: "<PEOPLE> visited <PLACES>"
+ *
+ * @example
+ * // Selective masking
+ * applyNlpRules("Google bought Fitbit for $2.1 billion", [NlpEntity.ORGS])
+ * // Returns: "<ORGS> bought <ORGS> for $2.1 billion"
+ */
+export declare function applyNlpRules(text: string, entities?: NlpEntity[]): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yellowsakura/js-pii-mask",
-  "version": "0.8.93",
+  "version": "0.9.0",
   "description": "Simple and effective PII data masking library for TypeScript/JavaScript",
   "keywords": [
     "pii",
@@ -8,12 +8,8 @@
     "masking",
     "data-privacy",
     "privacy",
-    "gdpr",
-    "ccpa",
     "anonymization",
-    "typescript",
-    "personal-data",
-    "sensitive-data"
+    "personal-data"
   ],
   "homepage": "https://github.com/YellowSakura/js-pii-mask#readme",
   "bugs": {
@@ -25,7 +21,8 @@
   },
   "license": "MIT",
   "author": "Yellow Sakura",
-  "main": "./dist/index.js",
+  "main": "./dist/index.cjs",
+  "type": "module",
   "types": "./dist/index.d.ts",
   "directories": {
     "doc": "docs",
@@ -56,5 +53,8 @@
   "engines": {
     "node": ">=24.12.0"
   },
-  "module": "./dist/index.mjs"
+  "module": "./dist/index.js",
+  "dependencies": {
+    "compromise": "^14.14.5"
+  }
 }

package/dist/index.mjs

@@ -1 +0,0 @@
-function e(e,t){if(!e||!t||t.length===0)return e;for(let n of t){if(!n.pattern||n.replacement===void 0)continue;e=e.replace(n.pattern,`<${n.replacement}>`)}return e}let t=function(e){return e.CREDIT_CARD=`CREDIT_CARD`,e.CRYPTO=`CRYPTO`,e.DATE_TIME=`DATE_TIME`,e.EMAIL_ADDRESS=`EMAIL_ADDRESS`,e.IBAN_CODE=`IBAN_CODE`,e.IP_ADDRESS=`IP_ADDRESS`,e.PHONE_NUMBER=`PHONE_NUMBER`,e.URL=`URL`,e.CVV=`CVV`,e.BIC_SWIFT=`BIC_SWIFT`,e.US_BANK_NUMBER=`US_BANK_NUMBER`,e.US_DRIVER_LICENSE=`US_DRIVER_LICENSE`,e.US_ITIN=`US_ITIN`,e.US_PASSPORT=`US_PASSPORT`,e.US_SSN=`US_SSN`,e.UK_NHS=`UK_NHS`,e.UK_NINO=`UK_NINO`,e.ES_NIF=`ES_NIF`,e.ES_NIE=`ES_NIE`,e.IT_FISCAL_CODE=`IT_FISCAL_CODE`,e.IT_DOCUMENT=`IT_DOCUMENT`,e.IT_VAT_CODE=`IT_VAT_CODE`,e.PL_PESEL=`PL_PESEL`,e.FI_PERSONAL_IDENTITY_CODE=`FI_PERSONAL_IDENTITY_CODE`,e.SG_NRIC_FIN=`SG_NRIC_FIN`,e.SG_UEN=`SG_UEN`,e.AU_ABN=`AU_ABN`,e.AU_ACN=`AU_ACN`,e.AU_TFN=`AU_TFN`,e.AU_MEDICARE=`AU_MEDICARE`,e.IN_PAN=`IN_PAN`,e.IN_AADHAAR=`IN_AADHAAR`,e.IN_VEHICLE_REGISTRATION=`IN_VEHICLE_REGISTRATION`,e.IN_VOTER=`IN_VOTER`,e.IN_PASSPORT=`IN_PASSPORT`,e.KR_RRN=`KR_RRN`,e}({});const n=[`(?:[sS][wW][iI][fF][tT])`,`(?:[bB][iI][cC])`,`(?:[bB][aA][nN][kK][\\s-]?[cC][oO][dD][eE])`,`(?:[sS][wW][iI][fF][tT][\\s-]?[cC][oO][dD][eE])`,`(?:[bB][iI][cC][\\s-]?[cC][oO][dD][eE])`].join(`|`),r=RegExp(`(?:${n})[:\\s=]+([A-Z]{4}[A-Z]{2}[A-Z0-9]{2}(?:[A-Z0-9]{3})?)\\b`,`g`),i={[t.CREDIT_CARD]:[/\b\d{4}[-\s]?\d{4}[-\s]?\d{4}[-\s]?\d{4}\b/g],[t.CRYPTO]:[/\b[13][a-km-zA-HJ-NP-Z1-9]{25,34}\b/g],[t.DATE_TIME]:[/\b(0[1-9]|1[0-2])[/-](0[1-9]|[12]\d|3[01])[/-](19|20)\d{2}\b/g],[t.EMAIL_ADDRESS]:[/\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/g,RegExp(`(?<=[?&=/])[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}`,`g`)],[t.IBAN_CODE]:[/\b[A-Z]{2}[0-9]{2}[A-Z0-9]{4}[0-9]{7}([A-Z0-9]?){0,16}\b/g],[t.IP_ADDRESS]:[/\b(?:[0-9]{1,3}\.){3}[0-9]{1,3}\b/g,/\b(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}\b/g,/\b(?:[0-9a-fA-F]{1,4}:){1,7}:|:(?::[0-9a-fA-F]{1,4}){1,7}\b/g],[t.PHONE_NUMBER]:[/\b(\+\d{1,3}[-.\s]?)?\(?\d{3}\)?[-.\s]?\d{3}[-.\s]?\d{4}\b/g],[t.URL]:[/\bhttps?:\/\/(?:[-\w.])+(?::[0-9]+)?(?:\/(?:[\w/_.])*(?:\?(?:[\w&=%.])*)?(?:#(?:[\w.])*)?)?/g],[t.CVV]:[/\b(?:cvv|cvc|security\s*code|card\s*code)[\s:=]*[0-9]{3,4}\b/gi],[t.BIC_SWIFT]:[r],[t.US_BANK_NUMBER]:[/\b\d{8,17}\b/g],[t.US_DRIVER_LICENSE]:[/\b[A-Z]\d{7}\b/g],[t.US_ITIN]:[/\b9\d{2}-\d{2}-\d{4}\b/g],[t.US_PASSPORT]:[/\b[A-Z]\d{8}\b/g],[t.US_SSN]:[/\b\d{3}-\d{2}-\d{4}\b|\b\d{9}\b/g],[t.UK_NHS]:[/\b\d{3} \d{3} \d{4}\b/g],[t.UK_NINO]:[/\b[A-Z]{2}\d{6}[A-Z]\b/g],[t.ES_NIF]:[/\b\d{8}[A-Z]\b/g],[t.ES_NIE]:[/\b[XYZ]\d{7}[A-Z]\b/g],[t.IT_FISCAL_CODE]:[/\b[A-Z]{6}\d{2}[A-Z]\d{2}[A-Z]\d{3}[A-Z]\b/g],[t.IT_DOCUMENT]:[/\b[A-Z]{2}\d{7}\b/g],[t.IT_VAT_CODE]:[/\bIT\d{11}\b/g],[t.PL_PESEL]:[/\b\d{11}\b/g],[t.FI_PERSONAL_IDENTITY_CODE]:[/\b\d{6}[+-A]\d{3}[A-Z0-9]\b/g],[t.SG_NRIC_FIN]:[/\b[A-Z]\d{7}[A-Z]\b/g],[t.SG_UEN]:[/\b\d{8}[A-Z]\b|\b\d{9}[A-Z]\b/g],[t.AU_ABN]:[/\b\d{2} \d{3} \d{3} \d{3}\b/g],[t.AU_ACN]:[/\b\d{3} \d{3} \d{3}\b/g],[t.AU_TFN]:[/\b\d{9}\b/g],[t.AU_MEDICARE]:[/\b\d{4} \d{5} \d{1}\b/g],[t.IN_PAN]:[/\b[A-Z]{5}\d{4}[A-Z]\b/g],[t.IN_AADHAAR]:[/\b\d{4} \d{4} \d{4}\b/g],[t.IN_VEHICLE_REGISTRATION]:[/\b[A-Z]{2}\d{2}[A-Z]{2}\d{4}\b/g],[t.IN_VOTER]:[/\b[A-Z]{3}\d{7}\b/g],[t.IN_PASSPORT]:[/\b[A-Z]\d{7}\b/g],[t.KR_RRN]:[/\b\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])-[1-4]\d{6}\b/g]};function a(e,n=Object.values(t)){if(!e)return e;for(let t of n){let n=i[t];if(!n||!n.length)continue;for(let r of n)e=e.replace(r,`<${t}>`)}return e}function o(e){if(!e)return e;let t=/(?:\u200B|\u200C|\u200D|\u2060|\uFEFF)/g;try{return e.normalize(`NFKC`).replace(t,``)}catch{return e.replace(t,``)}}function s(t,n){let{customRules:r=[],fixedPiiEntities:i=[]}=n||{},s=o(t);return r.length>0&&(s=e(s,r)),i.length>0?a(s,i):a(s)}export{t as FixedPIIEntity,s as mask};