@ts-typed/validators 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -4,6 +4,38 @@ All notable changes to `@ts-typed/validators` are documented in this file.
 
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.1.2] - 2026-10-18
+
+### Changed
+
+- **`FullName` is no longer Brazil-specific.** Moved from `@ts-typed/validators/br` to a new `@ts-typed/validators/global` entry point (also re-exported from the package root). It no longer validates against `./br`'s exports — `require('@ts-typed/validators/br').FullName` is now `undefined`.
+
+### Added
+
+- A new `@ts-typed/validators/global` entry point for validators meant for universal/international use, exporting `FullName`, `Email`, and `CreditCard`.
+- `Email`: validates `local-part@domain.tld` pragmatically (not full RFC 5322) — local part allows letters/digits/`._%+-`, domain allows letters/digits/hyphens/dots, must end in a 2+ letter TLD. Adds `.localPart()`, `.domain()`, and `.redact()` (keeps the local part's first character, masks the rest, shows the domain in full: `"ana@example.com"` -> `"a**@example.com"`).
+- `CreditCard`: validates a payment card number with the Luhn checksum (network-agnostic, works across card networks worldwide). Accepts spaces/hyphens as separators; the cleaned value must be 12-19 digits and pass the Luhn check. Adds `.numbers()`, `.masked()` (last 4 digits shown, rest masked in groups of 4: `"4532015112830366"` -> `"**** **** **** 0366"`), and `.redact()` (same as `.masked()`).
+
+## [0.1.1] - 2026-10-18
+
+### Added
+
+- A new `FullName` validator: confirms a value looks like a plausible Brazilian full name (at least two words of letters — including accented characters, apostrophes, hyphens), with `.firstName()` (the first word) and `.lastName()` (everything after the first word).
+- A `.redact()` privacy-masking method on every class except `CEP`'s own numeric-only predecessor behavior changed too (see below):
+  - `CPF`: `"123.456.789-09"` -> `"***.456.789-**"` (hide the first group and the check digits).
+  - `CNPJ`: hide the first group and the check digits (works for both the legacy numeric and alphanumeric formats).
+  - `PIS`/`Pasep`/`Nis`/`Nit`: hide the first group and the final check digit.
+  - `CNH`: hide the first 3 and last 2 of its 11 digits.
+  - `Placa`: show the 3-letter prefix, mask everything after it (`"ABC1234"`/`"ABC1D23"` -> `"ABC****"`).
+  - `CEP`: hide the first 5 digits (area/sector), show only the last 3 (`"12345-678"` -> `"*****-678"`).
+  - `FullName`: every word reduced to its first letter plus one asterisk per remaining character (`"Ana Maria Silva Santos"` -> `"A** M**** S**** S*****"`).
+
+  None of these formats are mandated by a single federal standard — Brazil has no unified rule for this (there's an open legislative proposal asking for one, because fragmented masks across institutions make them easier to reverse-engineer). `CPF`'s format matches a real, documented state transparency-portal convention; the others follow the same principle for consistency, not independent sourcing per document type. `CNPJ` identifies a legal entity, not a natural person — LGPD's personal-data protections don't apply to it the way they do to the others, so `.redact()` there is for API consistency, not a compliance requirement.
+
+### Changed
+
+- Depends on `@ts-typed/compiler@0.1.22` (the version this package's own dependency was pinned to had fallen behind the app-level direct dependency in a real install, creating two separate `ValueObject`/`StrictTypeError` class instances and silently breaking `@Catch(StrictTypeError)` matching — caught via a real end-to-end demo, same root cause documented in `@ts-typed/nestjs`'s own CHANGELOG history).
+
 ## [0.1.0] - 2026-10-18
 
 ### Added

package/README.md

@@ -7,28 +7,34 @@ npm install @ts-typed/validators
 ```
 
 ```ts
-import { CPF } from '@ts-typed/validators'; // or '@ts-typed/validators/br'
+import { CPF } from '@ts-typed/validators/br';
+import { Email } from '@ts-typed/validators/global';
 
 export class CreateUserDto {
-  public readonly cpf!: CPF; // declared as CPF, populated from JSON as a plain string
+  public readonly cpf!: CPF;     // Brazil-specific
+  public readonly email!: Email; // global
 }
 
 class UserService {
   public create(dto: CreateUserDto) {
-    console.log(dto.cpf);          // "12345678909" (or however the client sent it)
-    console.log(dto.cpf.masked());  // "123.456.789-09"
-    console.log(dto.cpf.numbers()); // "12345678909"
+    console.log(dto.cpf);            // "12345678909" (or however the client sent it)
+    console.log(dto.cpf.masked());   // "123.456.789-09"
+    console.log(dto.email.domain()); // "example.com"
   }
 }
 ```
 
-With `@ts-typed/compiler`'s build step, the raw string the client sent for `cpf` auto-constructs into a validated `CPF` instance the moment it's assigned — no `new CPF(...)` anywhere in application code, and an invalid CPF throws before `create()` ever runs.
+With `@ts-typed/compiler`'s build step, a raw string crossing a typed boundary auto-constructs into a validated instance the moment it's assigned — no manual `new` anywhere in application code, and an invalid value throws before `create()` ever runs.
 
 Each class behaves like a string everywhere it matters (`console.log`, template literals, `JSON.stringify`, every native `String.prototype` method), while adding its own validation and formatting methods. See [`@ts-typed/compiler`'s README](https://github.com/ts-typed/compiler#readme) for the full `ValueObject`/auto-construction mechanism this package builds on.
 
-## Validators (Brazil)
+## Entry points
 
-Import from `@ts-typed/validators` or `@ts-typed/validators/br` (same exports, either path):
+- `@ts-typed/validators/br` — Brazil-specific document validators.
+- `@ts-typed/validators/global` — validators meant for universal/international use.
+- `@ts-typed/validators` (the bare package root) re-exports everything from both.
+
+## Validators (Brazil) — `@ts-typed/validators/br`
 
 | Class | Document | Check digit | Accepts |
 |---|---|---|---|
@@ -39,10 +45,40 @@ Import from `@ts-typed/validators` or `@ts-typed/validators/br` (same exports, e
 | `Placa` | Vehicle plate | Format only — no check digit exists | Legacy (`"ABC1234"`) or Mercosul (`"ABC1D23"`) |
 | `CNH` | Driver's license number | Modulus 11 | `"03215478120"` |
 
-Every class exposes `.numbers()` (the normalized, unformatted value) and, where there's a natural display format, `.masked()`. `CNH` has no standard formatted display form, so it only exposes `.numbers()`.
+Every document class exposes `.numbers()` (the normalized, unformatted value) and, where there's a natural display format, `.masked()`. `CNH` has no standard formatted display form, so it only exposes `.numbers()`.
 
 **`CEP` and `Placa` validate FORMAT only** — neither document type has a nationally standardized check digit, so these confirm shape (length/pattern), not that a specific number was actually issued.
 
+## Validators (global) — `@ts-typed/validators/global`
+
+| Class | What it validates | Notes |
+|---|---|---|
+| `FullName` | A plausible full name (first + surname, any locale/script) | No check digit — plausibility only. `.firstName()`, `.lastName()`. |
+| `Email` | `local-part@domain.tld` | Pragmatic format check, not full RFC 5322. `.localPart()`, `.domain()`. |
+| `CreditCard` | A payment card number | Luhn checksum (network-agnostic). Accepts space/hyphen separators; 12-19 digits. `.numbers()`, `.masked()`. |
+
+```ts
+import { Email, CreditCard, FullName } from '@ts-typed/validators/global';
+
+new Email('ana@example.com').domain();              // "example.com"
+new CreditCard('4532 0151 1283 0366').masked();      // "**** **** **** 0366"
+new FullName('Ana Maria Silva Santos').firstName();  // "Ana"
+```
+
+## Privacy masking (`.redact()`)
+
+Every class — in both `/br` and `/global` — exposes `.redact()`, for displaying a value in a context where the full value shouldn't be shown (logs, public listings, support tooling):
+
+```ts
+new CPF('123.456.789-09').redact();                    // "***.456.789-**"
+new CEP('12345-678').redact();                          // "*****-678"
+new FullName('Ana Maria Silva Santos').redact();        // "A** M**** S**** S*****"
+new Email('ana@example.com').redact();                   // "a**@example.com"
+new CreditCard('4532015112830366').redact();             // "**** **** **** 0366"
+```
+
+Brazil has no single federal standard for this (there's an open legislative proposal asking for one, precisely because different institutions using different masks makes a number easier to reconstruct by cross-referencing). `CPF`'s format matches a real, documented state transparency-portal convention; the rest follow the same principle for consistency, not independent sourcing per document type. `CNPJ` identifies a legal entity, not a natural person, so LGPD's personal-data rules don't apply to it the way they do the others — its `.redact()` exists for API consistency, not because redacting a CNPJ is commonly required.
+
 ## Why no `RG`
 
 An RG (Registro Geral) has no nationally standardized check digit — the format and whether a check digit exists at all varies by issuing state, and many states have none. Shipping an `RG` class would mean pretending to validate something that can't actually be validated nationwide, so it's deliberately not included.

package/dist/br/cep.class.d.ts

@@ -12,5 +12,11 @@ export declare class CEP extends ValueObject {
     masked(): string;
     /** Digits only: `12345678`. */
     numbers(): string;
+    /**
+     * Hides the first 5 digits (the part that narrows a location down to a
+     * specific area/sector) and shows only the last 3 (the distribution
+     * digits): `"12345-678"` -> `"*****-678"`.
+     */
+    redact(): string;
 }
 //# sourceMappingURL=cep.class.d.ts.map

package/dist/br/cep.class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cep.class.d.ts","sourceRoot":"","sources":["../../src/br/cep.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;GAKG;AACH,qBAAa,GAAI,SAAQ,WAAW;gBACf,GAAG,EAAE,MAAM;IAI9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIvC,2CAA2C;IACpC,MAAM,IAAI,MAAM;IAKvB,+BAA+B;IACxB,OAAO,IAAI,MAAM;CAGzB"}
+{"version":3,"file":"cep.class.d.ts","sourceRoot":"","sources":["../../src/br/cep.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;GAKG;AACH,qBAAa,GAAI,SAAQ,WAAW;gBACf,GAAG,EAAE,MAAM;IAI9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIvC,2CAA2C;IACpC,MAAM,IAAI,MAAM;IAKvB,+BAA+B;IACxB,OAAO,IAAI,MAAM;IAIxB;;;;OAIG;IACI,MAAM,IAAI,MAAM;CAIxB"}

package/dist/br/cep.class.js

@@ -24,6 +24,15 @@ class CEP extends compiler_1.ValueObject {
     numbers() {
         return this.toString().replace(/[\s./-]/g, '');
     }
+    /**
+     * Hides the first 5 digits (the part that narrows a location down to a
+     * specific area/sector) and shows only the last 3 (the distribution
+     * digits): `"12345-678"` -> `"*****-678"`.
+     */
+    redact() {
+        const d = this.numbers();
+        return `*****-${d.slice(5)}`;
+    }
 }
 exports.CEP = CEP;
 //# sourceMappingURL=cep.class.js.map

package/dist/br/cep.class.js.map

@@ -1 +1 @@
-{"version":3,"file":"cep.class.js","sourceRoot":"","sources":["../../src/br/cep.class.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AAEjD;;;;;GAKG;AACH,MAAa,GAAI,SAAQ,sBAAW;IAClC,YAAmB,GAAW;QAC5B,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAES,OAAO,CAAC,GAAW;QAC3B,OAAO,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,2CAA2C;IACpC,MAAM;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,CAAC;IAED,+BAA+B;IACxB,OAAO;QACZ,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;CACF;AAnBD,kBAmBC"}
+{"version":3,"file":"cep.class.js","sourceRoot":"","sources":["../../src/br/cep.class.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AAEjD;;;;;GAKG;AACH,MAAa,GAAI,SAAQ,sBAAW;IAClC,YAAmB,GAAW;QAC5B,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAES,OAAO,CAAC,GAAW;QAC3B,OAAO,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,2CAA2C;IACpC,MAAM;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,CAAC;IAED,+BAA+B;IACxB,OAAO;QACZ,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;;;OAIG;IACI,MAAM;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/B,CAAC;CACF;AA7BD,kBA6BC"}

package/dist/br/cnh.class.d.ts

@@ -11,5 +11,11 @@ export declare class CNH extends ValueObject {
     protected isValid(raw: string): boolean;
     /** Digits only: `12345678901`. */
     numbers(): string;
+    /**
+     * Privacy-masked form: `***154781**`. Hides the first 3 and last 2 digits,
+     * showing the middle 6. The CNH has no official masking standard; this
+     * applies the same proportion as `CPF.redact()` for consistency.
+     */
+    redact(): string;
 }
 //# sourceMappingURL=cnh.class.d.ts.map

package/dist/br/cnh.class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cnh.class.d.ts","sourceRoot":"","sources":["../../src/br/cnh.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;GAMG;AACH,qBAAa,GAAI,SAAQ,WAAW;gBACf,GAAG,EAAE,MAAM;IAI9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIvC,kCAAkC;IAC3B,OAAO,IAAI,MAAM;CAGzB"}
+{"version":3,"file":"cnh.class.d.ts","sourceRoot":"","sources":["../../src/br/cnh.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;GAMG;AACH,qBAAa,GAAI,SAAQ,WAAW;gBACf,GAAG,EAAE,MAAM;IAI9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIvC,kCAAkC;IAC3B,OAAO,IAAI,MAAM;IAIxB;;;;OAIG;IACI,MAAM,IAAI,MAAM;CAIxB"}

package/dist/br/cnh.class.js

@@ -20,6 +20,15 @@ class CNH extends compiler_1.ValueObject {
     numbers() {
         return this.toString().replace(/[\s./-]/g, '');
     }
+    /**
+     * Privacy-masked form: `***154781**`. Hides the first 3 and last 2 digits,
+     * showing the middle 6. The CNH has no official masking standard; this
+     * applies the same proportion as `CPF.redact()` for consistency.
+     */
+    redact() {
+        const d = this.numbers();
+        return `***${d.slice(3, 9)}**`;
+    }
 }
 exports.CNH = CNH;
 function isValidCNH(cleaned) {

package/dist/br/cnh.class.js.map

@@ -1 +1 @@
-{"version":3,"file":"cnh.class.js","sourceRoot":"","sources":["../../src/br/cnh.class.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AAEjD;;;;;;GAMG;AACH,MAAa,GAAI,SAAQ,sBAAW;IAClC,YAAmB,GAAW;QAC5B,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAES,OAAO,CAAC,GAAW;QAC3B,OAAO,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,kCAAkC;IAC3B,OAAO;QACZ,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;CACF;AAbD,kBAaC;AAED,SAAS,UAAU,CAAC,OAAe;IACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3E,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACpB,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"cnh.class.js","sourceRoot":"","sources":["../../src/br/cnh.class.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AAEjD;;;;;;GAMG;AACH,MAAa,GAAI,SAAQ,sBAAW;IAClC,YAAmB,GAAW;QAC5B,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAES,OAAO,CAAC,GAAW;QAC3B,OAAO,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,kCAAkC;IAC3B,OAAO;QACZ,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;;;OAIG;IACI,MAAM;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC;IACjC,CAAC;CACF;AAvBD,kBAuBC;AAED,SAAS,UAAU,CAAC,OAAe;IACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3E,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACpB,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC;AAC9B,CAAC"}

package/dist/br/cnpj.class.d.ts

@@ -17,5 +17,17 @@ export declare class CNPJ extends ValueObject {
     masked(): string;
     /** Normalized unformatted value, uppercased: `12ABC34501DE35`. */
     numbers(): string;
+    /**
+     * Privacy-masked display form: `**.ABC.345/01DE-**`. Hides the first
+     * 2-character group and the final 2 check digits.
+     *
+     * CNPJ identifies a LEGAL ENTITY (a company), not a natural person. LGPD's
+     * personal-data protections apply to pessoa física, so redacting a CNPJ is
+     * not a legal requirement the way it is for CPF. This method exists for API
+     * consistency with the other document classes, not because CNPJ redaction is
+     * commonly practiced or required. The masking pattern follows the same
+     * principle as `CPF.redact()`; it is not a CNPJ-specific federal standard.
+     */
+    redact(): string;
 }
 //# sourceMappingURL=cnpj.class.d.ts.map

package/dist/br/cnpj.class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cnpj.class.d.ts","sourceRoot":"","sources":["../../src/br/cnpj.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,qBAAa,IAAK,SAAQ,WAAW;gBAChB,GAAG,EAAE,MAAM;IAI9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIvC,8EAA8E;IACvE,MAAM,IAAI,MAAM;IAKvB,kEAAkE;IAC3D,OAAO,IAAI,MAAM;CAGzB"}
+{"version":3,"file":"cnpj.class.d.ts","sourceRoot":"","sources":["../../src/br/cnpj.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,qBAAa,IAAK,SAAQ,WAAW;gBAChB,GAAG,EAAE,MAAM;IAI9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIvC,8EAA8E;IACvE,MAAM,IAAI,MAAM;IAKvB,kEAAkE;IAC3D,OAAO,IAAI,MAAM;IAIxB;;;;;;;;;;OAUG;IACI,MAAM,IAAI,MAAM;CAIxB"}

package/dist/br/cnpj.class.js

@@ -29,6 +29,21 @@ class CNPJ extends compiler_1.ValueObject {
     numbers() {
         return normalize(this.toString());
     }
+    /**
+     * Privacy-masked display form: `**.ABC.345/01DE-**`. Hides the first
+     * 2-character group and the final 2 check digits.
+     *
+     * CNPJ identifies a LEGAL ENTITY (a company), not a natural person. LGPD's
+     * personal-data protections apply to pessoa física, so redacting a CNPJ is
+     * not a legal requirement the way it is for CPF. This method exists for API
+     * consistency with the other document classes, not because CNPJ redaction is
+     * commonly practiced or required. The masking pattern follows the same
+     * principle as `CPF.redact()`; it is not a CNPJ-specific federal standard.
+     */
+    redact() {
+        const v = this.numbers();
+        return `**.${v.slice(2, 5)}.${v.slice(5, 8)}/${v.slice(8, 12)}-**`;
+    }
 }
 exports.CNPJ = CNPJ;
 function normalize(raw) {

package/dist/br/cnpj.class.js.map

@@ -1 +1 @@
-{"version":3,"file":"cnpj.class.js","sourceRoot":"","sources":["../../src/br/cnpj.class.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AAEjD;;;;;;;;;;GAUG;AACH,MAAa,IAAK,SAAQ,sBAAW;IACnC,YAAmB,GAAW;QAC5B,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAES,OAAO,CAAC,GAAW;QAC3B,OAAO,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,8EAA8E;IACvE,MAAM;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IAC/F,CAAC;IAED,kEAAkE;IAC3D,OAAO;QACZ,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpC,CAAC;CACF;AAnBD,oBAmBC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACnD,CAAC;AAED,SAAS,SAAS,CAAC,EAAU;IAC3B,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,mCAAmC;AACnE,CAAC;AAED,SAAS,MAAM,CAAC,MAAgB,EAAE,OAAiB;IACjD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,MAAM,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;IACrB,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC;AAChC,CAAC;AAED,SAAS,WAAW,CAAC,YAAoB;IACvC,IAAI,YAAY,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/D,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClE,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvC,IAAI,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;IACjD,OAAO,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC"}
+{"version":3,"file":"cnpj.class.js","sourceRoot":"","sources":["../../src/br/cnpj.class.ts"],"names":[],"mappings":"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"}

package/dist/br/cpf.class.d.ts

@@ -9,5 +9,12 @@ export declare class CPF extends ValueObject {
     masked(): string;
     /** Digits only: `12345678901`. */
     numbers(): string;
+    /**
+     * Privacy-masked display form: `***.456.789-**`. Hides the first 3-digit
+     * group and the two check digits, showing the middle groups. This follows a
+     * convention used by at least one state's public transparency portal for
+     * CPF; it is a widely used practice, not a single federal standard.
+     */
+    redact(): string;
 }
 //# sourceMappingURL=cpf.class.d.ts.map

package/dist/br/cpf.class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cpf.class.d.ts","sourceRoot":"","sources":["../../src/br/cpf.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;GAEG;AACH,qBAAa,GAAI,SAAQ,WAAW;gBACf,GAAG,EAAE,MAAM;IAI9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKvC,gDAAgD;IACzC,MAAM,IAAI,MAAM;IAKvB,kCAAkC;IAC3B,OAAO,IAAI,MAAM;CAGzB"}
+{"version":3,"file":"cpf.class.d.ts","sourceRoot":"","sources":["../../src/br/cpf.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;GAEG;AACH,qBAAa,GAAI,SAAQ,WAAW;gBACf,GAAG,EAAE,MAAM;IAI9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKvC,gDAAgD;IACzC,MAAM,IAAI,MAAM;IAKvB,kCAAkC;IAC3B,OAAO,IAAI,MAAM;IAIxB;;;;;OAKG;IACI,MAAM,IAAI,MAAM;CAIxB"}

package/dist/br/cpf.class.js

@@ -22,6 +22,16 @@ class CPF extends compiler_1.ValueObject {
     numbers() {
         return this.toString().replace(/[\s./-]/g, '');
     }
+    /**
+     * Privacy-masked display form: `***.456.789-**`. Hides the first 3-digit
+     * group and the two check digits, showing the middle groups. This follows a
+     * convention used by at least one state's public transparency portal for
+     * CPF; it is a widely used practice, not a single federal standard.
+     */
+    redact() {
+        const d = this.numbers();
+        return `***.${d.slice(3, 6)}.${d.slice(6, 9)}-**`;
+    }
 }
 exports.CPF = CPF;
 function isValidCPF(cleaned) {

package/dist/br/cpf.class.js.map

@@ -1 +1 @@
-{"version":3,"file":"cpf.class.js","sourceRoot":"","sources":["../../src/br/cpf.class.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AAEjD;;GAEG;AACH,MAAa,GAAI,SAAQ,sBAAW;IAClC,YAAmB,GAAW;QAC5B,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAES,OAAO,CAAC,GAAW;QAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,gDAAgD;IACzC,MAAM;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,CAAC;IAED,kCAAkC;IAC3B,OAAO;QACZ,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;CACF;AApBD,kBAoBC;AAED,SAAS,UAAU,CAAC,OAAe;IACjC,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACxE,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACxD,IAAI,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;IACnB,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC;IACnC,IAAI,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,GAAG,GAAG,CAAC,CAAC;IACR,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;QAAE,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACzD,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;IACf,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC;IACnC,OAAO,GAAG,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"cpf.class.js","sourceRoot":"","sources":["../../src/br/cpf.class.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AAEjD;;GAEG;AACH,MAAa,GAAI,SAAQ,sBAAW;IAClC,YAAmB,GAAW;QAC5B,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAES,OAAO,CAAC,GAAW;QAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,gDAAgD;IACzC,MAAM;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,CAAC;IAED,kCAAkC;IAC3B,OAAO;QACZ,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;;;;OAKG;IACI,MAAM;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC;IACpD,CAAC;CACF;AA/BD,kBA+BC;AAED,SAAS,UAAU,CAAC,OAAe;IACjC,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACxE,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACxD,IAAI,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;IACnB,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC;IACnC,IAAI,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,GAAG,GAAG,CAAC,CAAC;IACR,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;QAAE,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACzD,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;IACf,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC;IACnC,OAAO,GAAG,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;AAC5B,CAAC"}

package/dist/br/pis.class.d.ts

@@ -11,6 +11,13 @@ export declare class PIS extends ValueObject {
     masked(): string;
     /** Digits only: `12065328705`. */
     numbers(): string;
+    /**
+     * Privacy-masked display form: `***.65328.70-*`. Hides the first 3-digit
+     * group and the final check digit, showing the middle portion. This applies
+     * the same proportional masking principle as `CPF.redact()`; it is not a
+     * PIS-specific federal standard.
+     */
+    redact(): string;
 }
 export { PIS as Pasep, PIS as Nis, PIS as Nit };
 //# sourceMappingURL=pis.class.d.ts.map

package/dist/br/pis.class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pis.class.d.ts","sourceRoot":"","sources":["../../src/br/pis.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;GAIG;AACH,qBAAa,GAAI,SAAQ,WAAW;gBACf,GAAG,EAAE,MAAM;IAI9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIvC,gDAAgD;IACzC,MAAM,IAAI,MAAM;IAKvB,kCAAkC;IAC3B,OAAO,IAAI,MAAM;CAGzB;AAED,OAAO,EAAE,GAAG,IAAI,KAAK,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG,EAAE,CAAC"}
+{"version":3,"file":"pis.class.d.ts","sourceRoot":"","sources":["../../src/br/pis.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;GAIG;AACH,qBAAa,GAAI,SAAQ,WAAW;gBACf,GAAG,EAAE,MAAM;IAI9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIvC,gDAAgD;IACzC,MAAM,IAAI,MAAM;IAKvB,kCAAkC;IAC3B,OAAO,IAAI,MAAM;IAIxB;;;;;OAKG;IACI,MAAM,IAAI,MAAM;CAIxB;AAED,OAAO,EAAE,GAAG,IAAI,KAAK,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG,EAAE,CAAC"}

package/dist/br/pis.class.js

@@ -23,6 +23,16 @@ class PIS extends compiler_1.ValueObject {
     numbers() {
         return this.toString().replace(/[\s./-]/g, '');
     }
+    /**
+     * Privacy-masked display form: `***.65328.70-*`. Hides the first 3-digit
+     * group and the final check digit, showing the middle portion. This applies
+     * the same proportional masking principle as `CPF.redact()`; it is not a
+     * PIS-specific federal standard.
+     */
+    redact() {
+        const d = this.numbers();
+        return `***.${d.slice(3, 8)}.${d.slice(8, 10)}-*`;
+    }
 }
 exports.PIS = PIS;
 exports.Pasep = PIS;

package/dist/br/pis.class.js.map

@@ -1 +1 @@
-{"version":3,"file":"pis.class.js","sourceRoot":"","sources":["../../src/br/pis.class.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AAEjD;;;;GAIG;AACH,MAAa,GAAI,SAAQ,sBAAW;IAClC,YAAmB,GAAW;QAC5B,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAES,OAAO,CAAC,GAAW;QAC3B,OAAO,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,gDAAgD;IACzC,MAAM;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IAC9E,CAAC;IAED,kCAAkC;IAC3B,OAAO;QACZ,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;CACF;AAnBD,kBAmBC;AAEe,oBAAK;AAAS,kBAAG;AAAS,kBAAG;AAE7C,SAAS,UAAU,CAAC,OAAe;IACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5E,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;IACzB,IAAI,EAAE,IAAI,EAAE;QAAE,EAAE,GAAG,CAAC,CAAC;IACrB,OAAO,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"pis.class.js","sourceRoot":"","sources":["../../src/br/pis.class.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AAEjD;;;;GAIG;AACH,MAAa,GAAI,SAAQ,sBAAW;IAClC,YAAmB,GAAW;QAC5B,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAES,OAAO,CAAC,GAAW;QAC3B,OAAO,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,gDAAgD;IACzC,MAAM;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IAC9E,CAAC;IAED,kCAAkC;IAC3B,OAAO;QACZ,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;;;;OAKG;IACI,MAAM;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC;IACpD,CAAC;CACF;AA9BD,kBA8BC;AAEe,oBAAK;AAAS,kBAAG;AAAS,kBAAG;AAE7C,SAAS,UAAU,CAAC,OAAe;IACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5E,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;IACzB,IAAI,EAAE,IAAI,EAAE;QAAE,EAAE,GAAG,CAAC,CAAC;IACrB,OAAO,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC"}

package/dist/br/placa.class.d.ts

@@ -15,5 +15,12 @@ export declare class Placa extends ValueObject {
     masked(): string;
     /** Normalized uppercase value without separators: `ABC1234` or `ABC1D23`. */
     numbers(): string;
+    /**
+     * Privacy-masked form: `ABC****` for either format (legacy or Mercosul),
+     * with no separator. Shows the 3-letter prefix and masks the rest. This is a
+     * reasonable, consistent masking convention chosen for this library; it is
+     * not an official plate-specific standard.
+     */
+    redact(): string;
 }
 //# sourceMappingURL=placa.class.d.ts.map

package/dist/br/placa.class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"placa.class.d.ts","sourceRoot":"","sources":["../../src/br/placa.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKjD;;;;;;;;GAQG;AACH,qBAAa,KAAM,SAAQ,WAAW;gBACjB,GAAG,EAAE,MAAM;IAI9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKvC,2EAA2E;IACpE,MAAM,IAAI,MAAM;IAKvB,6EAA6E;IACtE,OAAO,IAAI,MAAM;CAGzB"}
+{"version":3,"file":"placa.class.d.ts","sourceRoot":"","sources":["../../src/br/placa.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKjD;;;;;;;;GAQG;AACH,qBAAa,KAAM,SAAQ,WAAW;gBACjB,GAAG,EAAE,MAAM;IAI9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKvC,2EAA2E;IACpE,MAAM,IAAI,MAAM;IAKvB,6EAA6E;IACtE,OAAO,IAAI,MAAM;IAIxB;;;;;OAKG;IACI,MAAM,IAAI,MAAM;CAGxB"}

package/dist/br/placa.class.js

@@ -30,6 +30,15 @@ class Placa extends compiler_1.ValueObject {
     numbers() {
         return normalize(this.toString());
     }
+    /**
+     * Privacy-masked form: `ABC****` for either format (legacy or Mercosul),
+     * with no separator. Shows the 3-letter prefix and masks the rest. This is a
+     * reasonable, consistent masking convention chosen for this library; it is
+     * not an official plate-specific standard.
+     */
+    redact() {
+        return `${this.numbers().slice(0, 3)}****`;
+    }
 }
 exports.Placa = Placa;
 function normalize(raw) {

package/dist/br/placa.class.js.map

@@ -1 +1 @@
-{"version":3,"file":"placa.class.js","sourceRoot":"","sources":["../../src/br/placa.class.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AAEjD,MAAM,MAAM,GAAG,iBAAiB,CAAC;AACjC,MAAM,QAAQ,GAAG,wBAAwB,CAAC;AAE1C;;;;;;;;GAQG;AACH,MAAa,KAAM,SAAQ,sBAAW;IACpC,YAAmB,GAAW;QAC5B,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAES,OAAO,CAAC,GAAW;QAC3B,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,2EAA2E;IACpE,MAAM;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,6EAA6E;IACtE,OAAO;QACZ,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpC,CAAC;CACF;AApBD,sBAoBC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACnD,CAAC"}
+{"version":3,"file":"placa.class.js","sourceRoot":"","sources":["../../src/br/placa.class.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AAEjD,MAAM,MAAM,GAAG,iBAAiB,CAAC;AACjC,MAAM,QAAQ,GAAG,wBAAwB,CAAC;AAE1C;;;;;;;;GAQG;AACH,MAAa,KAAM,SAAQ,sBAAW;IACpC,YAAmB,GAAW;QAC5B,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAES,OAAO,CAAC,GAAW;QAC3B,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,2EAA2E;IACpE,MAAM;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,6EAA6E;IACtE,OAAO;QACZ,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACI,MAAM;QACX,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IAC7C,CAAC;CACF;AA9BD,sBA8BC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACnD,CAAC"}

package/dist/global/credit-card.class.d.ts

@@ -0,0 +1,20 @@
+import { ValueObject } from '@ts-typed/compiler';
+/**
+ * A payment card number, validated with the Luhn checksum: a network-agnostic
+ * check used by card numbers worldwide. Separators (spaces or hyphens) are
+ * accepted; the cleaned value must be 12 to 19 digits and pass the Luhn check.
+ */
+export declare class CreditCard extends ValueObject {
+    constructor(raw: string);
+    protected isValid(raw: string): boolean;
+    /** Digits only, separators removed: `"4532 0151 1283 0366"` -> `"4532015112830366"`. */
+    numbers(): string;
+    /**
+     * Card display form: only the last 4 digits are shown, the rest masked, in
+     * groups of 4: `"4532015112830366"` -> `"**** **** **** 0366"`.
+     */
+    masked(): string;
+    /** Card display is already a redaction by convention, so this is the same as `masked()`. */
+    redact(): string;
+}
+//# sourceMappingURL=credit-card.class.d.ts.map

package/dist/global/credit-card.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-card.class.d.ts","sourceRoot":"","sources":["../../src/global/credit-card.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,WAAW;gBACtB,GAAG,EAAE,MAAM;IAI9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKvC,wFAAwF;IACjF,OAAO,IAAI,MAAM;IAIxB;;;OAGG;IACI,MAAM,IAAI,MAAM;IAMvB,4FAA4F;IACrF,MAAM,IAAI,MAAM;CAGxB"}

package/dist/global/credit-card.class.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditCard = void 0;
+const compiler_1 = require("@ts-typed/compiler");
+/**
+ * A payment card number, validated with the Luhn checksum: a network-agnostic
+ * check used by card numbers worldwide. Separators (spaces or hyphens) are
+ * accepted; the cleaned value must be 12 to 19 digits and pass the Luhn check.
+ */
+class CreditCard extends compiler_1.ValueObject {
+    constructor(raw) {
+        super(raw);
+    }
+    isValid(raw) {
+        const cleaned = raw.replace(/[\s-]/g, '');
+        return /^\d{12,19}$/.test(cleaned) && isValidLuhn(cleaned);
+    }
+    /** Digits only, separators removed: `"4532 0151 1283 0366"` -> `"4532015112830366"`. */
+    numbers() {
+        return this.toString().replace(/[\s-]/g, '');
+    }
+    /**
+     * Card display form: only the last 4 digits are shown, the rest masked, in
+     * groups of 4: `"4532015112830366"` -> `"**** **** **** 0366"`.
+     */
+    masked() {
+        const digits = this.numbers();
+        const hidden = '*'.repeat(digits.length - 4).match(/.{1,4}/g) ?? [];
+        return [...hidden, digits.slice(-4)].join(' ');
+    }
+    /** Card display is already a redaction by convention, so this is the same as `masked()`. */
+    redact() {
+        return this.masked();
+    }
+}
+exports.CreditCard = CreditCard;
+function isValidLuhn(digits) {
+    let sum = 0;
+    let shouldDouble = false;
+    for (let i = digits.length - 1; i >= 0; i--) {
+        let d = Number(digits[i]);
+        if (shouldDouble) {
+            d *= 2;
+            if (d > 9)
+                d -= 9;
+        }
+        sum += d;
+        shouldDouble = !shouldDouble;
+    }
+    return sum % 10 === 0;
+}
+//# sourceMappingURL=credit-card.class.js.map

package/dist/global/credit-card.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-card.class.js","sourceRoot":"","sources":["../../src/global/credit-card.class.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AAEjD;;;;GAIG;AACH,MAAa,UAAW,SAAQ,sBAAW;IACzC,YAAmB,GAAW;QAC5B,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAES,OAAO,CAAC,GAAW;QAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC1C,OAAO,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,wFAAwF;IACjF,OAAO;QACZ,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED;;;OAGG;IACI,MAAM;QACX,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACpE,OAAO,CAAC,GAAG,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC;IAED,4FAA4F;IACrF,MAAM;QACX,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;CACF;AA7BD,gCA6BC;AAED,SAAS,WAAW,CAAC,MAAc;IACjC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,YAAY,EAAE,CAAC;YACjB,CAAC,IAAI,CAAC,CAAC;YACP,IAAI,CAAC,GAAG,CAAC;gBAAE,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,GAAG,IAAI,CAAC,CAAC;QACT,YAAY,GAAG,CAAC,YAAY,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;AACxB,CAAC"}

package/dist/global/email.class.d.ts

@@ -0,0 +1,24 @@
+import { ValueObject } from '@ts-typed/compiler';
+/**
+ * An email address, validated pragmatically rather than against the full
+ * RFC 5322 grammar: `local-part@domain.tld`. The local part allows letters,
+ * digits and `. _ % + -`; the domain allows letters, digits, hyphens and dots,
+ * and must end in a TLD of at least two letters. This matches the format
+ * checks most real-world systems apply.
+ */
+export declare class Email extends ValueObject {
+    constructor(raw: string);
+    protected isValid(raw: string): boolean;
+    /** Everything before the `@`: `"ana@example.com"` -> `"ana"`. */
+    localPart(): string;
+    /** Everything after the `@`: `"ana@example.com"` -> `"example.com"`. */
+    domain(): string;
+    /**
+     * Privacy-masked display form: the first character of the local part is
+     * kept, the rest of it is masked, and the domain is shown in full:
+     * `"ana@example.com"` -> `"a**@example.com"`. A one-character local part
+     * has nothing to mask, so it is shown as-is: `"j@example.com"`.
+     */
+    redact(): string;
+}
+//# sourceMappingURL=email.class.d.ts.map

package/dist/global/email.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.class.d.ts","sourceRoot":"","sources":["../../src/global/email.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;GAMG;AACH,qBAAa,KAAM,SAAQ,WAAW;gBACjB,GAAG,EAAE,MAAM;IAI9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIvC,iEAAiE;IAC1D,SAAS,IAAI,MAAM;IAK1B,wEAAwE;IACjE,MAAM,IAAI,MAAM;IAKvB;;;;;OAKG;IACI,MAAM,IAAI,MAAM;CAKxB"}

package/dist/global/email.class.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Email = void 0;
+const compiler_1 = require("@ts-typed/compiler");
+/**
+ * An email address, validated pragmatically rather than against the full
+ * RFC 5322 grammar: `local-part@domain.tld`. The local part allows letters,
+ * digits and `. _ % + -`; the domain allows letters, digits, hyphens and dots,
+ * and must end in a TLD of at least two letters. This matches the format
+ * checks most real-world systems apply.
+ */
+class Email extends compiler_1.ValueObject {
+    constructor(raw) {
+        super(raw);
+    }
+    isValid(raw) {
+        return /^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$/.test(raw);
+    }
+    /** Everything before the `@`: `"ana@example.com"` -> `"ana"`. */
+    localPart() {
+        const value = this.toString();
+        return value.slice(0, value.indexOf('@'));
+    }
+    /** Everything after the `@`: `"ana@example.com"` -> `"example.com"`. */
+    domain() {
+        const value = this.toString();
+        return value.slice(value.indexOf('@') + 1);
+    }
+    /**
+     * Privacy-masked display form: the first character of the local part is
+     * kept, the rest of it is masked, and the domain is shown in full:
+     * `"ana@example.com"` -> `"a**@example.com"`. A one-character local part
+     * has nothing to mask, so it is shown as-is: `"j@example.com"`.
+     */
+    redact() {
+        const local = this.localPart();
+        const masked = local.charAt(0) + '*'.repeat(Math.max(local.length - 1, 0));
+        return `${masked}@${this.domain()}`;
+    }
+}
+exports.Email = Email;
+//# sourceMappingURL=email.class.js.map

package/dist/global/email.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.class.js","sourceRoot":"","sources":["../../src/global/email.class.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AAEjD;;;;;;GAMG;AACH,MAAa,KAAM,SAAQ,sBAAW;IACpC,YAAmB,GAAW;QAC5B,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAES,OAAO,CAAC,GAAW;QAC3B,OAAO,kDAAkD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtE,CAAC;IAED,iEAAiE;IAC1D,SAAS;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,wEAAwE;IACjE,MAAM;QACX,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACI,MAAM;QACX,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3E,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;IACtC,CAAC;CACF;AAhCD,sBAgCC"}

package/dist/global/full-name.class.d.ts

@@ -0,0 +1,23 @@
+import { ValueObject } from '@ts-typed/compiler';
+/**
+ * A Brazilian full name: at least a first name and a surname. There is no
+ * check digit for a name — `isValid` only confirms it looks like a plausible
+ * full name (at least two words, each made of letters — including accented
+ * Portuguese characters — apostrophes, or hyphens).
+ */
+export declare class FullName extends ValueObject {
+    constructor(raw: string);
+    protected isValid(raw: string): boolean;
+    /** The first word: `"Ana Maria Silva Santos"` -> `"Ana"`. */
+    firstName(): string;
+    /** Everything after the first word: `"Ana Maria Silva Santos"` -> `"Maria Silva Santos"`. */
+    lastName(): string;
+    /**
+     * Every word reduced to its first letter plus an asterisk for each
+     * remaining character, so none of the name's content past the first
+     * letter of each word is shown: `"Ana Maria Silva Santos"` ->
+     * `"A** M**** S**** S*****"`.
+     */
+    redact(): string;
+}
+//# sourceMappingURL=full-name.class.d.ts.map

package/dist/global/full-name.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"full-name.class.d.ts","sourceRoot":"","sources":["../../src/global/full-name.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,WAAW;gBACpB,GAAG,EAAE,MAAM;IAI9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKvC,6DAA6D;IACtD,SAAS,IAAI,MAAM;IAI1B,6FAA6F;IACtF,QAAQ,IAAI,MAAM;IAIzB;;;;;OAKG;IACI,MAAM,IAAI,MAAM;CAMxB"}

package/dist/global/full-name.class.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FullName = void 0;
+const compiler_1 = require("@ts-typed/compiler");
+/**
+ * A Brazilian full name: at least a first name and a surname. There is no
+ * check digit for a name — `isValid` only confirms it looks like a plausible
+ * full name (at least two words, each made of letters — including accented
+ * Portuguese characters — apostrophes, or hyphens).
+ */
+class FullName extends compiler_1.ValueObject {
+    constructor(raw) {
+        super(raw);
+    }
+    isValid(raw) {
+        const words = normalize(raw).split(' ');
+        return words.length >= 2 && words.every((word) => /^[A-Za-zÀ-ÖØ-öø-ÿ'-]+$/.test(word));
+    }
+    /** The first word: `"Ana Maria Silva Santos"` -> `"Ana"`. */
+    firstName() {
+        return normalize(this.toString()).split(' ')[0];
+    }
+    /** Everything after the first word: `"Ana Maria Silva Santos"` -> `"Maria Silva Santos"`. */
+    lastName() {
+        return normalize(this.toString()).split(' ').slice(1).join(' ');
+    }
+    /**
+     * Every word reduced to its first letter plus an asterisk for each
+     * remaining character, so none of the name's content past the first
+     * letter of each word is shown: `"Ana Maria Silva Santos"` ->
+     * `"A** M**** S**** S*****"`.
+     */
+    redact() {
+        return normalize(this.toString())
+            .split(' ')
+            .map((word) => word.charAt(0) + '*'.repeat(word.length - 1))
+            .join(' ');
+    }
+}
+exports.FullName = FullName;
+function normalize(raw) {
+    return raw.trim().replace(/\s+/g, ' ');
+}
+//# sourceMappingURL=full-name.class.js.map

package/dist/global/full-name.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"full-name.class.js","sourceRoot":"","sources":["../../src/global/full-name.class.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AAEjD;;;;;GAKG;AACH,MAAa,QAAS,SAAQ,sBAAW;IACvC,YAAmB,GAAW;QAC5B,KAAK,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAES,OAAO,CAAC,GAAW;QAC3B,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzF,CAAC;IAED,6DAA6D;IACtD,SAAS;QACd,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,6FAA6F;IACtF,QAAQ;QACb,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClE,CAAC;IAED;;;;;OAKG;IACI,MAAM;QACX,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;aAC9B,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;aAC3D,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;CACF;AAhCD,4BAgCC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC"}

package/dist/global/index.d.ts

@@ -0,0 +1,4 @@
+export { FullName } from './full-name.class';
+export { Email } from './email.class';
+export { CreditCard } from './credit-card.class';
+//# sourceMappingURL=index.d.ts.map

package/dist/global/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/global/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/global/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditCard = exports.Email = exports.FullName = void 0;
+var full_name_class_1 = require("./full-name.class");
+Object.defineProperty(exports, "FullName", { enumerable: true, get: function () { return full_name_class_1.FullName; } });
+var email_class_1 = require("./email.class");
+Object.defineProperty(exports, "Email", { enumerable: true, get: function () { return email_class_1.Email; } });
+var credit_card_class_1 = require("./credit-card.class");
+Object.defineProperty(exports, "CreditCard", { enumerable: true, get: function () { return credit_card_class_1.CreditCard; } });
+//# sourceMappingURL=index.js.map

package/dist/global/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/global/index.ts"],"names":[],"mappings":";;;AAAA,qDAA6C;AAApC,2GAAA,QAAQ,OAAA;AACjB,6CAAsC;AAA7B,oGAAA,KAAK,OAAA;AACd,yDAAiD;AAAxC,+GAAA,UAAU,OAAA"}

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export * from './br';
+export * from './global';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./br"), exports);
+__exportStar(require("./global"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uCAAqB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uCAAqB;AACrB,2CAAyB"}

package/package.json

@@ -1,11 +1,11 @@
 {
     "name": "@ts-typed/validators",
-    "version": "0.1.0",
+    "version": "0.1.2",
     "private": false,
     "publishConfig": {
         "access": "public"
     },
-    "description": "Document/data validators built on @ts-typed/compiler's ValueObject, organized by locale (starting with Brazil)",
+    "description": "Document/data validators built on @ts-typed/compiler's ValueObject: locale-specific (Brazil) and global (Email, CreditCard, FullName) validators",
     "license": "Apache-2.0",
     "engines": {
         "node": ">=22"
@@ -23,6 +23,11 @@
             "require": "./dist/br/index.js",
             "default": "./dist/br/index.js"
         },
+        "./global": {
+            "types": "./dist/global/index.d.ts",
+            "require": "./dist/global/index.js",
+            "default": "./dist/global/index.js"
+        },
         "./package.json": "./package.json"
     },
     "files": [
@@ -38,7 +43,7 @@
         "test": "npm run build && node --test --test-concurrency=1"
     },
     "dependencies": {
-        "@ts-typed/compiler": "0.1.21"
+        "@ts-typed/compiler": "0.1.22"
     },
     "peerDependencies": {
         "typescript": ">=5.9 <6"