@seniorsistemas/br-validators-front 0.0.0-stage → 1.0.0-beta.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Senior Sistemas S.A.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,87 @@
-# Temporary Holding Version
+# br-validators-front
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Validadores leves, rápidos e **sem nenhuma dependência** para documentos brasileiros, e-mail e telefone. São funções puras e síncronas, em TypeScript, para usar antes de enviar dados ao backend ou dentro de formulários. Inclui validadores prontos para Reactive Forms do Angular.
+
+| Validador                                         | O que valida                                            |
+| ------------------------------------------------- | ------------------------------------------------------- |
+| [CPF](src/validators/cpf/README.md)               | CPF, com ou sem máscara                                 |
+| [CNPJ](src/validators/cnpj/README.md)             | CNPJ numérico e **alfanumérico** (IN RFB nº 2.229/2024) |
+| [Inscrição Estadual](src/validators/ie/README.md) | IE das 27 UFs, conforme os roteiros do SINTEGRA         |
+| [E-mail](src/validators/email/README.md)          | E-mail, com regras pensadas para formulários            |
+| [Telefone](src/validators/phone/README.md)        | Celular, fixo, 0800, 4004… e internacional              |
+| [Angular](src/angular/README.md)                  | `ValidatorFn` para Reactive Forms                       |
+
+O pacote é _tree-shakeable_: importar só `isValidCpf` traz só o código do CPF (~0,6 kB; o pacote inteiro tem ~3,3 kB, min + brotli).
+
+## Instalação
+
+```bash
+npm install @seniorsistemas/br-validators-front
+```
+
+Funciona em qualquer bundler (Angular CLI, Vite, webpack, esbuild) e no Node 18+, via `import` (ESM) ou `require` (CommonJS). Os tipos vêm junto.
+
+## Uso rápido
+
+Cada validador tem duas funções:
+
+- `isValidXxx(valor)` devolve `true` ou `false`;
+- `validateXxx(valor)` devolve o valor normalizado (sem máscara) ou o código do erro.
+
+```ts
+import { isValidCpf, validateCpf } from "br-validators";
+
+isValidCpf("529.982.247-25"); // true
+
+validateCpf("529.982.247-25"); // { valid: true, normalizedValue: '52998224725' }
+validateCpf("529.982.247-24"); // { valid: false, error: 'INVALID_CHECK_DIGIT' }
+```
+
+O `normalizedValue` é o que normalmente se envia ao backend.
+
+Cada validador também pode ser importado pelo seu caminho: `br-validators/cpf`, `br-validators/cnpj`, `br-validators/ie`, `br-validators/email`, `br-validators/phone` e `br-validators/angular`.
+
+### Regras comuns
+
+- **Máscara.** CPF e CNPJ aceitam só duas formas: sem pontuação nenhuma ou com a máscara completa, cada sinal no lugar certo. Inscrição Estadual e telefone aceitam separadores em qualquer posição. Em todos os casos, um caractere fora do esperado torna o valor inválido: `abc529.982.247-25` não é um CPF válido.
+- **Espaços nas pontas** são ignorados.
+- **Valor vazio.** `null`, `undefined` e texto em branco dão o erro `EMPTY`; nenhum validador lança exceção. Valores que não são texto (como `number`) dão `INVALID_FORMAT`.
+
+### Mensagens de erro
+
+Os validadores devolvem códigos, não textos, o que deixa a tradução para a aplicação. Para quem quiser algo pronto, há mapas de mensagens genéricas, um por idioma:
+
+| Mapa           | Idioma                  |
+| -------------- | ----------------------- |
+| `messagesPtBr` | Português (Brasil)      |
+| `messagesEnUs` | Inglês (Estados Unidos) |
+| `messagesEsCo` | Espanhol (Colômbia)     |
+
+```ts
+import { messagesPtBr, validateCpf } from "br-validators";
+
+const result = validateCpf(valor);
+if (!result.valid) exibirErro(messagesPtBr[result.error]); // 'Dígito verificador inválido'
+if (!result.valid) exibirErro(messagesEnUs[result.error]); // 'Invalid check digit'
+```
+
+Todos os mapas têm o tipo `Messages` e cobrem todos os códigos de erro; se um código novo for criado, o TypeScript acusa o idioma que ficou sem tradução.
+
+## Desenvolvimento
+
+| Comando                 | O que faz                                                       |
+| ----------------------- | --------------------------------------------------------------- |
+| `npm test`              | Roda os testes (Vitest)                                         |
+| `npm run coverage`      | Roda os testes com cobertura (o limite é 100%)                  |
+| `npm run lint`          | ESLint com `typescript-eslint` em modo estrito                  |
+| `npm run format`        | Formata com Prettier                                            |
+| `npm run build`         | Gera ESM, CJS e tipos em `dist/` (tsup)                         |
+| `npm run check:exports` | Confere os `exports` e os tipos (are-the-types-wrong e publint) |
+| `npm run bench`         | Gera o build e roda o [benchmark](bench/README.md)              |
+| `npm run check`         | Roda tudo acima, menos o benchmark                              |
+
+Os testes ficam ao lado do código (`src/validators/<validador>/*.test.ts`). Ao mudar uma regra, atualize o teste e o README do validador.
+
+## Licença
+
+MIT

package/dist/angular/index.cjs

@@ -0,0 +1,47 @@
+'use strict';
+
+var chunk4DZAZWIX_cjs = require('../chunk-4DZAZWIX.cjs');
+var chunkHOMHHSPE_cjs = require('../chunk-HOMHHSPE.cjs');
+var chunkR5XVY4XW_cjs = require('../chunk-R5XVY4XW.cjs');
+require('../chunk-IHKI43ES.cjs');
+var chunkLFSTXSR5_cjs = require('../chunk-LFSTXSR5.cjs');
+var chunk5DLDDBDT_cjs = require('../chunk-5DLDDBDT.cjs');
+require('../chunk-LJS2LBQG.cjs');
+
+// src/angular/angular.ts
+function createValidator(key, validate) {
+  return (control) => {
+    const { value } = control;
+    if (value == null) return null;
+    if (typeof value !== "string") return { [key]: { error: "INVALID_FORMAT" } };
+    if (value.trim() === "") return null;
+    const result = validate(value, control);
+    return result.valid ? null : { [key]: { error: result.error } };
+  };
+}
+function cpfValidator() {
+  return createValidator("cpf", chunk4DZAZWIX_cjs.validateCpf);
+}
+function cnpjValidator() {
+  return createValidator("cnpj", chunkHOMHHSPE_cjs.validateCnpj);
+}
+function ieValidator(uf, options) {
+  const ufOf = (control) => typeof uf === "function" ? uf(control) : uf;
+  const validate = createValidator(
+    "ie",
+    (value, control) => chunkR5XVY4XW_cjs.validateIe(value, ufOf(control), options)
+  );
+  return (control) => chunkR5XVY4XW_cjs.isExterior(ufOf(control)) ? null : validate(control);
+}
+function emailValidator(options) {
+  return createValidator("email", (value) => chunkLFSTXSR5_cjs.validateEmail(value, options));
+}
+function phoneValidator(options) {
+  return createValidator("phone", (value) => chunk5DLDDBDT_cjs.validatePhone(value, options));
+}
+
+exports.cnpjValidator = cnpjValidator;
+exports.cpfValidator = cpfValidator;
+exports.emailValidator = emailValidator;
+exports.ieValidator = ieValidator;
+exports.phoneValidator = phoneValidator;

package/dist/angular/index.d.cts

@@ -0,0 +1,78 @@
+import { EmailOptions } from '../email/index.cjs';
+import { IeOptions } from '../ie/index.cjs';
+import { UfInput } from '../index.cjs';
+import { PhoneOptions } from '../index.cjs';
+import '../result-BWDTMsGY.cjs';
+
+/** O mínimo de um `AbstractControl` que os validadores leem: o valor. */
+interface ControlLike {
+    readonly value: unknown;
+}
+/** Compatível com `ValidationErrors` do `@angular/forms`. */
+type ValidationErrorsLike = Record<string, unknown>;
+/**
+ * Compatível com `ValidatorFn` do `@angular/forms`. A tipagem é estrutural, então o
+ * pacote não depende do Angular e funciona com qualquer versão de Reactive Forms.
+ */
+type ValidatorFnLike = (control: ControlLike) => ValidationErrorsLike | null;
+/**
+ * UF fixa, ou função que recebe o control e devolve a UF atual (ex.: lida de outro
+ * campo do mesmo formulário). Aceita também `EX` (exterior).
+ */
+type UfSource<C extends ControlLike = ControlLike> = UfInput | ((control: C) => string | null | undefined);
+/**
+ * Validador de CPF para Reactive Forms. Em caso de erro: `{ cpf: { error: CpfError } }`.
+ *
+ * @example
+ * cpf = new FormControl('', [Validators.required, cpfValidator()]);
+ */
+declare function cpfValidator(): ValidatorFnLike;
+/**
+ * Validador de CNPJ (numérico ou alfanumérico) para Reactive Forms.
+ * Em caso de erro: `{ cnpj: { error: CnpjError } }`.
+ *
+ * @example
+ * cnpj = new FormControl('', [Validators.required, cnpjValidator()]);
+ */
+declare function cnpjValidator(): ValidatorFnLike;
+/**
+ * Validador de Inscrição Estadual para Reactive Forms.
+ * Em caso de erro: `{ ie: { error: IeError } }`.
+ *
+ * A UF pode ser fixa ou uma função que recebe o control. Para ler a UF de outro
+ * campo, tipe o parâmetro como `AbstractControl` e use `control.parent`. Nesse caso:
+ * - revalide a IE quando a UF mudar;
+ * - se o formulário já nasce com a IE preenchida, revalide também logo após criá-lo,
+ *   porque o Angular valida cada control antes de ele entrar no `FormGroup`.
+ *
+ * Com a UF `EX` (exterior), o campo é sempre válido.
+ *
+ * @example
+ * form = new FormGroup({
+ *   uf: new FormControl('SP'),
+ *   ie: new FormControl('', [
+ *     ieValidator((control: AbstractControl) => control.parent?.get('uf')?.value),
+ *   ]),
+ * });
+ * form.controls.uf.valueChanges.subscribe(() => form.controls.ie.updateValueAndValidity());
+ */
+declare function ieValidator<C extends ControlLike = ControlLike>(uf: UfSource<C>, options?: IeOptions): (control: C) => ValidationErrorsLike | null;
+/**
+ * Validador de e-mail para Reactive Forms (mais rigoroso que o `Validators.email`).
+ * Em caso de erro: `{ email: { error: EmailError } }`.
+ *
+ * @example
+ * email = new FormControl('', [emailValidator()]);
+ */
+declare function emailValidator(options?: EmailOptions): ValidatorFnLike;
+/**
+ * Validador de telefone para Reactive Forms.
+ * Em caso de erro: `{ phone: { error: PhoneError } }`.
+ *
+ * @example
+ * celular = new FormControl('', [phoneValidator({ types: ['mobile'] })]);
+ */
+declare function phoneValidator(options?: PhoneOptions): ValidatorFnLike;
+
+export { cnpjValidator, cpfValidator, emailValidator, ieValidator, phoneValidator };
+export type { ControlLike, UfSource, ValidationErrorsLike, ValidatorFnLike };

package/dist/angular/index.d.ts

@@ -0,0 +1,78 @@
+import { EmailOptions } from '../email/index.js';
+import { IeOptions } from '../ie/index.js';
+import { UfInput } from '../index.js';
+import { PhoneOptions } from '../index.js';
+import '../result-BWDTMsGY.js';
+
+/** O mínimo de um `AbstractControl` que os validadores leem: o valor. */
+interface ControlLike {
+    readonly value: unknown;
+}
+/** Compatível com `ValidationErrors` do `@angular/forms`. */
+type ValidationErrorsLike = Record<string, unknown>;
+/**
+ * Compatível com `ValidatorFn` do `@angular/forms`. A tipagem é estrutural, então o
+ * pacote não depende do Angular e funciona com qualquer versão de Reactive Forms.
+ */
+type ValidatorFnLike = (control: ControlLike) => ValidationErrorsLike | null;
+/**
+ * UF fixa, ou função que recebe o control e devolve a UF atual (ex.: lida de outro
+ * campo do mesmo formulário). Aceita também `EX` (exterior).
+ */
+type UfSource<C extends ControlLike = ControlLike> = UfInput | ((control: C) => string | null | undefined);
+/**
+ * Validador de CPF para Reactive Forms. Em caso de erro: `{ cpf: { error: CpfError } }`.
+ *
+ * @example
+ * cpf = new FormControl('', [Validators.required, cpfValidator()]);
+ */
+declare function cpfValidator(): ValidatorFnLike;
+/**
+ * Validador de CNPJ (numérico ou alfanumérico) para Reactive Forms.
+ * Em caso de erro: `{ cnpj: { error: CnpjError } }`.
+ *
+ * @example
+ * cnpj = new FormControl('', [Validators.required, cnpjValidator()]);
+ */
+declare function cnpjValidator(): ValidatorFnLike;
+/**
+ * Validador de Inscrição Estadual para Reactive Forms.
+ * Em caso de erro: `{ ie: { error: IeError } }`.
+ *
+ * A UF pode ser fixa ou uma função que recebe o control. Para ler a UF de outro
+ * campo, tipe o parâmetro como `AbstractControl` e use `control.parent`. Nesse caso:
+ * - revalide a IE quando a UF mudar;
+ * - se o formulário já nasce com a IE preenchida, revalide também logo após criá-lo,
+ *   porque o Angular valida cada control antes de ele entrar no `FormGroup`.
+ *
+ * Com a UF `EX` (exterior), o campo é sempre válido.
+ *
+ * @example
+ * form = new FormGroup({
+ *   uf: new FormControl('SP'),
+ *   ie: new FormControl('', [
+ *     ieValidator((control: AbstractControl) => control.parent?.get('uf')?.value),
+ *   ]),
+ * });
+ * form.controls.uf.valueChanges.subscribe(() => form.controls.ie.updateValueAndValidity());
+ */
+declare function ieValidator<C extends ControlLike = ControlLike>(uf: UfSource<C>, options?: IeOptions): (control: C) => ValidationErrorsLike | null;
+/**
+ * Validador de e-mail para Reactive Forms (mais rigoroso que o `Validators.email`).
+ * Em caso de erro: `{ email: { error: EmailError } }`.
+ *
+ * @example
+ * email = new FormControl('', [emailValidator()]);
+ */
+declare function emailValidator(options?: EmailOptions): ValidatorFnLike;
+/**
+ * Validador de telefone para Reactive Forms.
+ * Em caso de erro: `{ phone: { error: PhoneError } }`.
+ *
+ * @example
+ * celular = new FormControl('', [phoneValidator({ types: ['mobile'] })]);
+ */
+declare function phoneValidator(options?: PhoneOptions): ValidatorFnLike;
+
+export { cnpjValidator, cpfValidator, emailValidator, ieValidator, phoneValidator };
+export type { ControlLike, UfSource, ValidationErrorsLike, ValidatorFnLike };

package/dist/angular/index.js

@@ -0,0 +1,41 @@
+import { validateCpf } from '../chunk-KCKWTNIK.js';
+import { validateCnpj } from '../chunk-5JKMEOAQ.js';
+import { isExterior, validateIe } from '../chunk-KV45PLCT.js';
+import '../chunk-AN3ZYKQD.js';
+import { validateEmail } from '../chunk-IOOBBQYD.js';
+import { validatePhone } from '../chunk-FEY4WHL2.js';
+import '../chunk-L3M6L7UZ.js';
+
+// src/angular/angular.ts
+function createValidator(key, validate) {
+  return (control) => {
+    const { value } = control;
+    if (value == null) return null;
+    if (typeof value !== "string") return { [key]: { error: "INVALID_FORMAT" } };
+    if (value.trim() === "") return null;
+    const result = validate(value, control);
+    return result.valid ? null : { [key]: { error: result.error } };
+  };
+}
+function cpfValidator() {
+  return createValidator("cpf", validateCpf);
+}
+function cnpjValidator() {
+  return createValidator("cnpj", validateCnpj);
+}
+function ieValidator(uf, options) {
+  const ufOf = (control) => typeof uf === "function" ? uf(control) : uf;
+  const validate = createValidator(
+    "ie",
+    (value, control) => validateIe(value, ufOf(control), options)
+  );
+  return (control) => isExterior(ufOf(control)) ? null : validate(control);
+}
+function emailValidator(options) {
+  return createValidator("email", (value) => validateEmail(value, options));
+}
+function phoneValidator(options) {
+  return createValidator("phone", (value) => validatePhone(value, options));
+}
+
+export { cnpjValidator, cpfValidator, emailValidator, ieValidator, phoneValidator };

package/dist/chunk-4DZAZWIX.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+var chunkIHKI43ES_cjs = require('./chunk-IHKI43ES.cjs');
+var chunkLJS2LBQG_cjs = require('./chunk-LJS2LBQG.cjs');
+
+// src/validators/cpf/cpf.ts
+function hasMask(input) {
+  return input.length === 14 && input.charCodeAt(3) === chunkLJS2LBQG_cjs.DOT && input.charCodeAt(7) === chunkLJS2LBQG_cjs.DOT && input.charCodeAt(11) === chunkLJS2LBQG_cjs.HYPHEN;
+}
+function parseCpf(value) {
+  const input = chunkLJS2LBQG_cjs.readInput(value);
+  if (typeof input !== "string") return input;
+  const cpf = chunkLJS2LBQG_cjs.stripMask(input, chunkLJS2LBQG_cjs.isDigit);
+  if (cpf === null) return chunkLJS2LBQG_cjs.invalid("INVALID_FORMAT");
+  if (cpf.length !== 11) return chunkLJS2LBQG_cjs.invalid("INVALID_LENGTH");
+  if (cpf !== input && !hasMask(input)) return chunkLJS2LBQG_cjs.invalid("INVALID_FORMAT");
+  return cpf;
+}
+function validateCpf(value) {
+  const cpf = parseCpf(value);
+  if (typeof cpf !== "string") return cpf;
+  if (chunkLJS2LBQG_cjs.allSameChar(cpf)) return chunkLJS2LBQG_cjs.invalid("REPEATED_DIGITS");
+  if (chunkIHKI43ES_cjs.mod11(chunkIHKI43ES_cjs.cycleSum(cpf, 9, 11)) !== chunkIHKI43ES_cjs.charValue(cpf, 9) || chunkIHKI43ES_cjs.mod11(chunkIHKI43ES_cjs.cycleSum(cpf, 10, 11)) !== chunkIHKI43ES_cjs.charValue(cpf, 10)) {
+    return chunkLJS2LBQG_cjs.invalid("INVALID_CHECK_DIGIT");
+  }
+  return { valid: true, normalizedValue: cpf };
+}
+function isValidCpf(value) {
+  return validateCpf(value).valid;
+}
+function formatCpf(value) {
+  const cpf = parseCpf(value);
+  if (typeof cpf !== "string") return null;
+  return `${cpf.slice(0, 3)}.${cpf.slice(3, 6)}.${cpf.slice(6, 9)}-${cpf.slice(9)}`;
+}
+
+exports.formatCpf = formatCpf;
+exports.isValidCpf = isValidCpf;
+exports.validateCpf = validateCpf;

package/dist/chunk-5DLDDBDT.cjs

@@ -0,0 +1,98 @@
+'use strict';
+
+var chunkLJS2LBQG_cjs = require('./chunk-LJS2LBQG.cjs');
+
+// src/validators/phone/ddd.ts
+var DDDS = "11 12 13 14 15 16 17 18 19 21 22 24 27 28 31 32 33 34 35 37 38 41 42 43 44 45 46 47 48 49 51 53 54 55 61 62 63 64 65 66 67 68 69 71 73 74 75 77 79 81 82 83 84 85 86 87 88 89 91 92 93 94 95 96 97 98 99";
+var dddSet;
+function isValidDdd(ddd) {
+  dddSet != null ? dddSet : dddSet = new Set(DDDS.split(" "));
+  return dddSet.has(ddd);
+}
+
+// src/validators/phone/country-codes.ts
+var COUNTRY_CODES = "1 7 20 27 30 31 32 33 34 36 39 40 41 43 44 45 46 47 48 49 51 52 53 54 55 56 57 58 60 61 62 63 64 65 66 81 82 84 86 90 91 92 93 94 95 98 211 212 213 216 218 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 260 261 262 263 264 265 266 267 268 269 290 291 297 298 299 350 351 352 353 354 355 356 357 358 359 370 371 372 373 374 375 376 377 378 379 380 381 382 383 385 386 387 389 420 421 423 500 501 502 503 504 505 506 507 508 509 590 591 592 593 594 595 596 597 598 599 670 672 673 674 675 676 677 678 679 680 681 682 683 685 686 687 688 689 690 691 692 800 808 850 852 853 855 856 870 878 880 881 882 883 886 888 960 961 962 963 964 965 966 967 968 970 971 972 973 974 975 976 977 979 992 993 994 995 996 997 998";
+var countryCodeSet;
+function findCountryCode(digits) {
+  countryCodeSet != null ? countryCodeSet : countryCodeSet = new Set(COUNTRY_CODES.split(" "));
+  for (let length = 1; length <= 3 && length <= digits.length; length++) {
+    const code = digits.slice(0, length);
+    if (countryCodeSet.has(code)) return code;
+  }
+  return void 0;
+}
+
+// src/validators/phone/phone.ts
+var BRAZIL = "55";
+var E164_MAX_LENGTH = 15;
+var INTERNATIONAL_MIN_NATIONAL_LENGTH = 4;
+var SPECIAL_PREFIXES = ["0300", "0303", "0500", "0800", "0900"];
+var PLUS = 43;
+function isPhoneSeparator(code) {
+  return code === 32 || code === chunkLJS2LBQG_cjs.DOT || code === chunkLJS2LBQG_cjs.HYPHEN || code === 40 || code === 41;
+}
+function extractDigits(input, start) {
+  let out = "";
+  let runStart = start;
+  for (let i = start; i < input.length; i++) {
+    const code = input.charCodeAt(i);
+    if (chunkLJS2LBQG_cjs.isDigit(code)) continue;
+    if (!isPhoneSeparator(code)) return null;
+    out += input.slice(runStart, i);
+    runStart = i + 1;
+  }
+  return out + input.slice(runStart);
+}
+function validatePhone(value, options) {
+  const input = chunkLJS2LBQG_cjs.readInput(value);
+  if (typeof input !== "string") return input;
+  const hasPlus = input.charCodeAt(0) === PLUS;
+  const digits = extractDigits(input, hasPlus ? 1 : 0);
+  if (digits === null || digits === "") return chunkLJS2LBQG_cjs.invalid("INVALID_FORMAT");
+  const result = hasPlus ? parseInternational(digits) : parseBrazilian(digits);
+  if (result.valid && (options == null ? void 0 : options.types) && !options.types.includes(result.type)) {
+    return chunkLJS2LBQG_cjs.invalid("TYPE_NOT_ALLOWED");
+  }
+  return result;
+}
+function isValidPhone(value, options) {
+  return validatePhone(value, options).valid;
+}
+function parseInternational(digits) {
+  const countryCode = findCountryCode(digits);
+  if (countryCode === void 0) return chunkLJS2LBQG_cjs.invalid("INVALID_COUNTRY_CODE");
+  if (countryCode === BRAZIL) return parseNational(digits.slice(2));
+  if (digits.length > E164_MAX_LENGTH || digits.length - countryCode.length < INTERNATIONAL_MIN_NATIONAL_LENGTH) {
+    return chunkLJS2LBQG_cjs.invalid("INVALID_LENGTH");
+  }
+  return { valid: true, normalizedValue: `+${digits}`, type: "international" };
+}
+function parseBrazilian(digits) {
+  const length = digits.length;
+  if (length === 11 && SPECIAL_PREFIXES.includes(digits.slice(0, 4))) {
+    return { valid: true, normalizedValue: digits, type: "special" };
+  }
+  if (length === 8 && (digits.startsWith("30") || digits.startsWith("40"))) {
+    return { valid: true, normalizedValue: digits, type: "special" };
+  }
+  if ((length === 12 || length === 13) && digits.startsWith(BRAZIL)) {
+    return parseNational(digits.slice(2));
+  }
+  if ((length === 11 || length === 12) && digits.startsWith("0")) {
+    return parseNational(digits.slice(1));
+  }
+  return parseNational(digits);
+}
+function parseNational(national) {
+  if (national.length !== 10 && national.length !== 11) return chunkLJS2LBQG_cjs.invalid("INVALID_LENGTH");
+  if (!isValidDdd(national.slice(0, 2))) return chunkLJS2LBQG_cjs.invalid("INVALID_DDD");
+  const first = national.charAt(2);
+  if (national.length === 11) {
+    return first === "9" ? { valid: true, normalizedValue: `+55${national}`, type: "mobile" } : chunkLJS2LBQG_cjs.invalid("INVALID_NUMBER");
+  }
+  return first >= "2" && first <= "5" ? { valid: true, normalizedValue: `+55${national}`, type: "landline" } : chunkLJS2LBQG_cjs.invalid("INVALID_NUMBER");
+}
+
+exports.isValidDdd = isValidDdd;
+exports.isValidPhone = isValidPhone;
+exports.validatePhone = validatePhone;

package/dist/chunk-5JKMEOAQ.js

@@ -0,0 +1,39 @@
+import { mod11, cycleSum, charValue } from './chunk-AN3ZYKQD.js';
+import { allSameChar, invalid, readInput, stripMask, isAsciiAlphanumeric, isDigit, DOT, SLASH, HYPHEN } from './chunk-L3M6L7UZ.js';
+
+// src/validators/cnpj/cnpj.ts
+function hasMask(input) {
+  return input.length === 18 && input.charCodeAt(2) === DOT && input.charCodeAt(6) === DOT && input.charCodeAt(10) === SLASH && input.charCodeAt(15) === HYPHEN;
+}
+function parseCnpj(value) {
+  const input = readInput(value);
+  if (typeof input !== "string") return input;
+  const stripped = stripMask(input, isAsciiAlphanumeric);
+  if (stripped === null) return invalid("INVALID_FORMAT");
+  if (stripped.length !== 14) return invalid("INVALID_LENGTH");
+  if (stripped !== input && !hasMask(input)) return invalid("INVALID_FORMAT");
+  const cnpj = stripped.toUpperCase();
+  if (!isDigit(cnpj.charCodeAt(12)) || !isDigit(cnpj.charCodeAt(13))) {
+    return invalid("INVALID_FORMAT");
+  }
+  return cnpj;
+}
+function validateCnpj(value) {
+  const cnpj = parseCnpj(value);
+  if (typeof cnpj !== "string") return cnpj;
+  if (allSameChar(cnpj)) return invalid("REPEATED_DIGITS");
+  if (mod11(cycleSum(cnpj, 12)) !== charValue(cnpj, 12) || mod11(cycleSum(cnpj, 13)) !== charValue(cnpj, 13)) {
+    return invalid("INVALID_CHECK_DIGIT");
+  }
+  return { valid: true, normalizedValue: cnpj };
+}
+function isValidCnpj(value) {
+  return validateCnpj(value).valid;
+}
+function formatCnpj(value) {
+  const cnpj = parseCnpj(value);
+  if (typeof cnpj !== "string") return null;
+  return `${cnpj.slice(0, 2)}.${cnpj.slice(2, 5)}.${cnpj.slice(5, 8)}/${cnpj.slice(8, 12)}-${cnpj.slice(12)}`;
+}
+
+export { formatCnpj, isValidCnpj, validateCnpj };

package/dist/chunk-AN3ZYKQD.js

@@ -0,0 +1,25 @@
+// src/shared/check-digit.ts
+function charValue(s, i) {
+  return s.charCodeAt(i) - 48;
+}
+function cycleSum(s, count, maxWeight = 9) {
+  let sum = 0;
+  let weight = 2;
+  for (let i = count - 1; i >= 0; i--) {
+    sum += charValue(s, i) * weight;
+    weight = weight === maxWeight ? 2 : weight + 1;
+  }
+  return sum;
+}
+function weightedSum(s, weights) {
+  let sum = 0;
+  let i = 0;
+  for (const weight of weights) sum += charValue(s, i++) * weight;
+  return sum;
+}
+function mod11(sum) {
+  const rest = sum % 11;
+  return rest < 2 ? 0 : 11 - rest;
+}
+
+export { charValue, cycleSum, mod11, weightedSum };

package/dist/chunk-FEY4WHL2.js

@@ -0,0 +1,94 @@
+import { readInput, invalid, isDigit, DOT, HYPHEN } from './chunk-L3M6L7UZ.js';
+
+// src/validators/phone/ddd.ts
+var DDDS = "11 12 13 14 15 16 17 18 19 21 22 24 27 28 31 32 33 34 35 37 38 41 42 43 44 45 46 47 48 49 51 53 54 55 61 62 63 64 65 66 67 68 69 71 73 74 75 77 79 81 82 83 84 85 86 87 88 89 91 92 93 94 95 96 97 98 99";
+var dddSet;
+function isValidDdd(ddd) {
+  dddSet != null ? dddSet : dddSet = new Set(DDDS.split(" "));
+  return dddSet.has(ddd);
+}
+
+// src/validators/phone/country-codes.ts
+var COUNTRY_CODES = "1 7 20 27 30 31 32 33 34 36 39 40 41 43 44 45 46 47 48 49 51 52 53 54 55 56 57 58 60 61 62 63 64 65 66 81 82 84 86 90 91 92 93 94 95 98 211 212 213 216 218 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 260 261 262 263 264 265 266 267 268 269 290 291 297 298 299 350 351 352 353 354 355 356 357 358 359 370 371 372 373 374 375 376 377 378 379 380 381 382 383 385 386 387 389 420 421 423 500 501 502 503 504 505 506 507 508 509 590 591 592 593 594 595 596 597 598 599 670 672 673 674 675 676 677 678 679 680 681 682 683 685 686 687 688 689 690 691 692 800 808 850 852 853 855 856 870 878 880 881 882 883 886 888 960 961 962 963 964 965 966 967 968 970 971 972 973 974 975 976 977 979 992 993 994 995 996 997 998";
+var countryCodeSet;
+function findCountryCode(digits) {
+  countryCodeSet != null ? countryCodeSet : countryCodeSet = new Set(COUNTRY_CODES.split(" "));
+  for (let length = 1; length <= 3 && length <= digits.length; length++) {
+    const code = digits.slice(0, length);
+    if (countryCodeSet.has(code)) return code;
+  }
+  return void 0;
+}
+
+// src/validators/phone/phone.ts
+var BRAZIL = "55";
+var E164_MAX_LENGTH = 15;
+var INTERNATIONAL_MIN_NATIONAL_LENGTH = 4;
+var SPECIAL_PREFIXES = ["0300", "0303", "0500", "0800", "0900"];
+var PLUS = 43;
+function isPhoneSeparator(code) {
+  return code === 32 || code === DOT || code === HYPHEN || code === 40 || code === 41;
+}
+function extractDigits(input, start) {
+  let out = "";
+  let runStart = start;
+  for (let i = start; i < input.length; i++) {
+    const code = input.charCodeAt(i);
+    if (isDigit(code)) continue;
+    if (!isPhoneSeparator(code)) return null;
+    out += input.slice(runStart, i);
+    runStart = i + 1;
+  }
+  return out + input.slice(runStart);
+}
+function validatePhone(value, options) {
+  const input = readInput(value);
+  if (typeof input !== "string") return input;
+  const hasPlus = input.charCodeAt(0) === PLUS;
+  const digits = extractDigits(input, hasPlus ? 1 : 0);
+  if (digits === null || digits === "") return invalid("INVALID_FORMAT");
+  const result = hasPlus ? parseInternational(digits) : parseBrazilian(digits);
+  if (result.valid && (options == null ? void 0 : options.types) && !options.types.includes(result.type)) {
+    return invalid("TYPE_NOT_ALLOWED");
+  }
+  return result;
+}
+function isValidPhone(value, options) {
+  return validatePhone(value, options).valid;
+}
+function parseInternational(digits) {
+  const countryCode = findCountryCode(digits);
+  if (countryCode === void 0) return invalid("INVALID_COUNTRY_CODE");
+  if (countryCode === BRAZIL) return parseNational(digits.slice(2));
+  if (digits.length > E164_MAX_LENGTH || digits.length - countryCode.length < INTERNATIONAL_MIN_NATIONAL_LENGTH) {
+    return invalid("INVALID_LENGTH");
+  }
+  return { valid: true, normalizedValue: `+${digits}`, type: "international" };
+}
+function parseBrazilian(digits) {
+  const length = digits.length;
+  if (length === 11 && SPECIAL_PREFIXES.includes(digits.slice(0, 4))) {
+    return { valid: true, normalizedValue: digits, type: "special" };
+  }
+  if (length === 8 && (digits.startsWith("30") || digits.startsWith("40"))) {
+    return { valid: true, normalizedValue: digits, type: "special" };
+  }
+  if ((length === 12 || length === 13) && digits.startsWith(BRAZIL)) {
+    return parseNational(digits.slice(2));
+  }
+  if ((length === 11 || length === 12) && digits.startsWith("0")) {
+    return parseNational(digits.slice(1));
+  }
+  return parseNational(digits);
+}
+function parseNational(national) {
+  if (national.length !== 10 && national.length !== 11) return invalid("INVALID_LENGTH");
+  if (!isValidDdd(national.slice(0, 2))) return invalid("INVALID_DDD");
+  const first = national.charAt(2);
+  if (national.length === 11) {
+    return first === "9" ? { valid: true, normalizedValue: `+55${national}`, type: "mobile" } : invalid("INVALID_NUMBER");
+  }
+  return first >= "2" && first <= "5" ? { valid: true, normalizedValue: `+55${national}`, type: "landline" } : invalid("INVALID_NUMBER");
+}
+
+export { isValidDdd, isValidPhone, validatePhone };