@br-validators/express 1.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BR Validators contributors
+
+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

@@ -0,0 +1,82 @@
+# @br-validators/express
+
+Express and Fastify middleware for Brazilian document validation — delegates to [`@br-validators/core`](../br-validators) `validate*` functions (BR-GENERATE-001 / BR-VALIDATE parity).
+
+## Install
+
+```bash
+pnpm add @br-validators/express @br-validators/core express
+```
+
+**Peer dependencies:** `express` `^4.21.0 || ^5.0.0`, `@br-validators/core`
+
+## Express
+
+```typescript
+import express from 'express';
+import { brValidate } from '@br-validators/express';
+
+const app = express();
+app.use(express.json());
+
+app.post(
+  '/cliente',
+  brValidate({
+    body: { cpf: 'cpf', cnpj: 'cnpj', cep: 'cep' },
+    uf: { from: 'body', field: 'uf' },
+  }),
+  (req, res) => {
+    res.json({ ok: true });
+  },
+);
+```
+
+Invalid input returns HTTP **400** with a structured body:
+
+```json
+{
+  "ok": false,
+  "field": "cpf",
+  "code": "INVALID_CHECK_DIGIT",
+  "message": "..."
+}
+```
+
+## Fastify
+
+```typescript
+import Fastify from 'fastify';
+import { brValidateFastify } from '@br-validators/express/fastify';
+
+const app = Fastify();
+
+app.post(
+  '/cliente',
+  {
+    preHandler: brValidateFastify({
+      body: { cpf: 'cpf', ie: 'inscricao-estadual' },
+      uf: { from: 'body', field: 'uf' },
+    }),
+  },
+  async () => ({ ok: true }),
+);
+```
+
+## Schema
+
+| Option | Description |
+|--------|-------------|
+| `body` | Map field names → core validator type id |
+| `query` | Same for `req.query` |
+| `params` | Same for `req.params` |
+| `uf` | `{ from: 'body' \| 'query' \| 'params', field: 'uf' }` or `{ value: 'SP' }` — required for IE and RG |
+
+### Supported type ids (18)
+
+`cpf`, `cnpj`, `cep`, `placa`, `pis-pasep`, `pix`, `telefone`, `boleto`, `cartao-credito`, `cnh`, `renavam`, `nfe-chave`, `titulo-eleitor`, `processo-judicial`, `inscricao-estadual`, `inscricao-estadual-produtor-rural`, `brcode`, `rg`
+
+Official algorithm sources: [docs/OFFICIAL-SOURCES.md](../../docs/OFFICIAL-SOURCES.md).
+
+## License
+
+MIT

package/dist/br-validate-BOiTO6lR.d.ts

@@ -0,0 +1,41 @@
+import { UfCode, ValidationErrorCode } from '@br-validators/core';
+
+/** Core validator type ids supported by `brValidate()`. */
+type BrValidatorTypeId = 'cpf' | 'cnpj' | 'cep' | 'placa' | 'pis-pasep' | 'pix' | 'telefone' | 'boleto' | 'cartao-credito' | 'cnh' | 'renavam' | 'nfe-chave' | 'titulo-eleitor' | 'processo-judicial' | 'inscricao-estadual' | 'inscricao-estadual-produtor-rural' | 'brcode' | 'rg';
+declare const BR_VALIDATOR_TYPE_IDS: readonly ["cpf", "cnpj", "cep", "placa", "pis-pasep", "pix", "telefone", "boleto", "cartao-credito", "cnh", "renavam", "nfe-chave", "titulo-eleitor", "processo-judicial", "inscricao-estadual", "inscricao-estadual-produtor-rural", "brcode", "rg"];
+type BrValidateLocation = 'body' | 'query' | 'params';
+type BrValidateFieldSchema = Record<string, BrValidatorTypeId>;
+type BrValidateUfSource = {
+    from: BrValidateLocation;
+    field: string;
+} | {
+    value: UfCode;
+};
+type BrValidateOptions = {
+    body?: BrValidateFieldSchema;
+    query?: BrValidateFieldSchema;
+    params?: BrValidateFieldSchema;
+    /** Required for `inscricao-estadual`, `inscricao-estadual-produtor-rural`, and `rg`. */
+    uf?: BrValidateUfSource;
+};
+type BrValidationErrorResponse = {
+    ok: false;
+    field: string;
+    code: ValidationErrorCode;
+    message: string;
+};
+type BrValidateRequest = {
+    body?: object;
+    query?: object;
+    params?: object;
+};
+type BrValidateResponse = {
+    status(code: number): BrValidateResponse;
+    json(body: BrValidationErrorResponse): void;
+};
+type BrValidateNext = () => void;
+declare function isBrValidatorTypeId(value: string): value is BrValidatorTypeId;
+
+declare function createBrValidateHandler(options: BrValidateOptions): (req: BrValidateRequest, res: BrValidateResponse, next: BrValidateNext) => void;
+
+export { type BrValidateOptions as B, type BrValidateRequest as a, type BrValidationErrorResponse as b, type BrValidatorTypeId as c, createBrValidateHandler as d, BR_VALIDATOR_TYPE_IDS as e, type BrValidateFieldSchema as f, type BrValidateLocation as g, type BrValidateUfSource as h, isBrValidatorTypeId as i };

package/dist/chunk-OKPS2N5C.js

@@ -0,0 +1,158 @@
+import { validateBrCode, validateProcessoJudicial, validateTituloEleitor, validateNfeChave, validateRenavam, validateCnh, validateCartaoCredito, validateBoleto, validateTelefone, validatePixKey, validatePisPasep, validatePlaca, validateCep, validateCnpj, validateCpf, validateRg, validateIeProdutorRural, validateInscricaoEstadual, RG_SUPPORTED_UFS } from '@br-validators/core';
+
+// src/validator-registry.ts
+var UF_REQUIRED_TYPES = /* @__PURE__ */ new Set([
+  "inscricao-estadual",
+  "inscricao-estadual-produtor-rural",
+  "rg"
+]);
+function requiresUf(typeId) {
+  return UF_REQUIRED_TYPES.has(typeId);
+}
+function missingUfFailure() {
+  return {
+    ok: false,
+    code: "UNSUPPORTED_FORMAT",
+    message: "UF is required for this field \u2014 configure brValidate({ uf: { from, field } }) or { value }"
+  };
+}
+function runWithUf(context, validate) {
+  return (value, ctx) => {
+    const uf = ctx.uf ?? context.uf;
+    if (!uf) {
+      return missingUfFailure();
+    }
+    return validate(value, uf);
+  };
+}
+function isRgUf(uf) {
+  return RG_SUPPORTED_UFS.includes(uf);
+}
+var VALIDATORS = {
+  cpf: (value) => validateCpf(value),
+  cnpj: (value) => validateCnpj(value),
+  cep: (value) => validateCep(value),
+  placa: (value) => validatePlaca(value),
+  "pis-pasep": (value) => validatePisPasep(value),
+  pix: (value) => validatePixKey(value),
+  telefone: (value) => validateTelefone(value),
+  boleto: (value) => validateBoleto(value),
+  "cartao-credito": (value) => validateCartaoCredito(value),
+  cnh: (value) => validateCnh(value),
+  renavam: (value) => validateRenavam(value),
+  "nfe-chave": (value) => validateNfeChave(value),
+  "titulo-eleitor": (value) => validateTituloEleitor(value),
+  "processo-judicial": (value) => validateProcessoJudicial(value),
+  brcode: (value) => validateBrCode(value),
+  "inscricao-estadual": runWithUf({}, (value, uf) => validateInscricaoEstadual(value, { uf })),
+  "inscricao-estadual-produtor-rural": runWithUf({}, (value, uf) => validateIeProdutorRural(uf, value)),
+  rg: runWithUf({}, (value, uf) => {
+    if (!isRgUf(uf)) {
+      return {
+        ok: false,
+        code: "UF_NOT_IMPLEMENTED",
+        message: `UF ${uf} is not implemented for RG validation`
+      };
+    }
+    return validateRg(value, { uf });
+  })
+};
+function runBrValidator(typeId, value, context) {
+  return VALIDATORS[typeId](value, context);
+}
+
+// src/br-validate.ts
+function readRecordField(record, field) {
+  if (!record) {
+    return void 0;
+  }
+  return Object.prototype.hasOwnProperty.call(record, field) ? record[field] : void 0;
+}
+function collectFieldRefs(location, schema) {
+  if (!schema) {
+    return [];
+  }
+  return Object.entries(schema).map(([field, typeId]) => ({
+    location,
+    field,
+    typeId
+  }));
+}
+function listBrValidateFields(options) {
+  return [
+    ...collectFieldRefs("body", options.body),
+    ...collectFieldRefs("query", options.query),
+    ...collectFieldRefs("params", options.params)
+  ];
+}
+function readLocationRecord(req, location) {
+  switch (location) {
+    case "body":
+      return req.body;
+    case "query":
+      return req.query;
+    case "params":
+      return req.params;
+  }
+}
+function resolveBrValidateUf(source, req) {
+  if (!source) {
+    return void 0;
+  }
+  if ("value" in source) {
+    return source.value;
+  }
+  const raw = readRecordField(readLocationRecord(req, source.from), source.field);
+  if (typeof raw !== "string" || raw.trim() === "") {
+    return void 0;
+  }
+  return raw.trim().toUpperCase();
+}
+function validationError(field, code, message) {
+  return { ok: false, field, code, message };
+}
+function respondValidationError(res, error) {
+  res.status(400).json(error);
+}
+function createBrValidateHandler(options) {
+  const fields = listBrValidateFields(options);
+  return (req, res, next) => {
+    const uf = resolveBrValidateUf(options.uf, req);
+    for (const { location, field, typeId } of fields) {
+      if (requiresUf(typeId) && !uf) {
+        respondValidationError(
+          res,
+          validationError(
+            field,
+            "UNSUPPORTED_FORMAT",
+            "UF is required for this field \u2014 configure brValidate({ uf: { from, field } }) or { value }"
+          )
+        );
+        return;
+      }
+      const raw = readRecordField(readLocationRecord(req, location), field);
+      if (raw === void 0 || raw === null) {
+        respondValidationError(res, validationError(field, "EMPTY_INPUT", "Field is required"));
+        return;
+      }
+      if (typeof raw !== "string") {
+        respondValidationError(res, validationError(field, "UNSUPPORTED_FORMAT", "Value must be a string"));
+        return;
+      }
+      if (raw.trim() === "") {
+        respondValidationError(res, validationError(field, "EMPTY_INPUT", "Field must not be empty"));
+        return;
+      }
+      const result = runBrValidator(typeId, raw, { uf });
+      if (!result.ok) {
+        respondValidationError(res, validationError(field, result.code, result.message));
+        return;
+      }
+    }
+    next();
+  };
+}
+
+export { createBrValidateHandler, requiresUf };
+//# sourceMappingURL=chunk-OKPS2N5C.js.map
+//# sourceMappingURL=chunk-OKPS2N5C.js.map

package/dist/chunk-OKPS2N5C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/validator-registry.ts","../src/br-validate.ts"],"names":[],"mappings":";;;AAoCA,IAAM,iBAAA,uBAAwB,GAAA,CAAuB;AAAA,EACnD,oBAAA;AAAA,EACA,mCAAA;AAAA,EACA;AACF,CAAC,CAAA;AAEM,SAAS,WAAW,MAAA,EAAoC;AAC7D,EAAA,OAAO,iBAAA,CAAkB,IAAI,MAAM,CAAA;AACrC;AAEA,SAAS,gBAAA,GAAqC;AAC5C,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,KAAA;AAAA,IACJ,IAAA,EAAM,oBAAA;AAAA,IACN,OAAA,EAAS;AAAA,GACX;AACF;AAEA,SAAS,SAAA,CACP,SACA,QAAA,EAC4D;AAC5D,EAAA,OAAO,CAAC,OAAO,GAAA,KAAQ;AACrB,IAAA,MAAM,EAAA,GAAK,GAAA,CAAI,EAAA,IAAM,OAAA,CAAQ,EAAA;AAC7B,IAAA,IAAI,CAAC,EAAA,EAAI;AACP,MAAA,OAAO,gBAAA,EAAiB;AAAA,IAC1B;AACA,IAAA,OAAO,QAAA,CAAS,OAAO,EAAE,CAAA;AAAA,EAC3B,CAAA;AACF;AAEA,SAAS,OAAO,EAAA,EAA4B;AAC1C,EAAA,OAAQ,gBAAA,CAAuC,SAAS,EAAE,CAAA;AAC5D;AAEA,IAAM,UAAA,GAAyD;AAAA,EAC7D,GAAA,EAAK,CAAC,KAAA,KAAU,WAAA,CAAY,KAAK,CAAA;AAAA,EACjC,IAAA,EAAM,CAAC,KAAA,KAAU,YAAA,CAAa,KAAK,CAAA;AAAA,EACnC,GAAA,EAAK,CAAC,KAAA,KAAU,WAAA,CAAY,KAAK,CAAA;AAAA,EACjC,KAAA,EAAO,CAAC,KAAA,KAAU,aAAA,CAAc,KAAK,CAAA;AAAA,EACrC,WAAA,EAAa,CAAC,KAAA,KAAU,gBAAA,CAAiB,KAAK,CAAA;AAAA,EAC9C,GAAA,EAAK,CAAC,KAAA,KAAU,cAAA,CAAe,KAAK,CAAA;AAAA,EACpC,QAAA,EAAU,CAAC,KAAA,KAAU,gBAAA,CAAiB,KAAK,CAAA;AAAA,EAC3C,MAAA,EAAQ,CAAC,KAAA,KAAU,cAAA,CAAe,KAAK,CAAA;AAAA,EACvC,gBAAA,EAAkB,CAAC,KAAA,KAAU,qBAAA,CAAsB,KAAK,CAAA;AAAA,EACxD,GAAA,EAAK,CAAC,KAAA,KAAU,WAAA,CAAY,KAAK,CAAA;AAAA,EACjC,OAAA,EAAS,CAAC,KAAA,KAAU,eAAA,CAAgB,KAAK,CAAA;AAAA,EACzC,WAAA,EAAa,CAAC,KAAA,KAAU,gBAAA,CAAiB,KAAK,CAAA;AAAA,EAC9C,gBAAA,EAAkB,CAAC,KAAA,KAAU,qBAAA,CAAsB,KAAK,CAAA;AAAA,EACxD,mBAAA,EAAqB,CAAC,KAAA,KAAU,wBAAA,CAAyB,KAAK,CAAA;AAAA,EAC9D,MAAA,EAAQ,CAAC,KAAA,KAAU,cAAA,CAAe,KAAK,CAAA;AAAA,EACvC,oBAAA,EAAsB,SAAA,CAAU,EAAC,EAAG,CAAC,KAAA,EAAO,EAAA,KAAO,yBAAA,CAA0B,KAAA,EAAO,EAAE,EAAA,EAAI,CAAC,CAAA;AAAA,EAC3F,mCAAA,EAAqC,SAAA,CAAU,EAAC,EAAG,CAAC,OAAO,EAAA,KAAO,uBAAA,CAAwB,EAAA,EAAI,KAAK,CAAC,CAAA;AAAA,EACpG,IAAI,SAAA,CAAU,EAAC,EAAG,CAAC,OAAO,EAAA,KAAO;AAC/B,IAAA,IAAI,CAAC,MAAA,CAAO,EAAE,CAAA,EAAG;AACf,MAAA,OAAO;AAAA,QACL,EAAA,EAAI,KAAA;AAAA,QACJ,IAAA,EAAM,oBAAA;AAAA,QACN,OAAA,EAAS,MAAM,EAAE,CAAA,qCAAA;AAAA,OACnB;AAAA,IACF;AACA,IAAA,OAAO,UAAA,CAAW,KAAA,EAAO,EAAE,EAAA,EAAI,CAAA;AAAA,EACjC,CAAC;AACH,CAAA;AAEO,SAAS,cAAA,CACd,MAAA,EACA,KAAA,EACA,OAAA,EACkB;AAClB,EAAA,OAAO,UAAA,CAAW,MAAM,CAAA,CAAE,KAAA,EAAO,OAAO,CAAA;AAC1C;;;AC9FA,SAAS,eAAA,CAAgB,QAA4B,KAAA,EAAwB;AAC3E,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA,CAAO,UAAU,cAAA,CAAe,IAAA,CAAK,QAAQ,KAAK,CAAA,GACrD,MAAA,CAAO,KAA4B,CAAA,GACnC,MAAA;AACN;AAEA,SAAS,gBAAA,CACP,UACA,MAAA,EACsB;AACtB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,EAAC;AAAA,EACV;AACA,EAAA,OAAO,MAAA,CAAO,QAAQ,MAAM,CAAA,CAAE,IAAI,CAAC,CAAC,KAAA,EAAO,MAAM,CAAA,MAAO;AAAA,IACtD,QAAA;AAAA,IACA,KAAA;AAAA,IACA;AAAA,GACF,CAAE,CAAA;AACJ;AAEO,SAAS,qBAAqB,OAAA,EAAkD;AACrF,EAAA,OAAO;AAAA,IACL,GAAG,gBAAA,CAAiB,MAAA,EAAQ,OAAA,CAAQ,IAAI,CAAA;AAAA,IACxC,GAAG,gBAAA,CAAiB,OAAA,EAAS,OAAA,CAAQ,KAAK,CAAA;AAAA,IAC1C,GAAG,gBAAA,CAAiB,QAAA,EAAU,OAAA,CAAQ,MAAM;AAAA,GAC9C;AACF;AAEA,SAAS,kBAAA,CAAmB,KAAwB,QAAA,EAAkD;AACpG,EAAA,QAAQ,QAAA;AAAU,IAChB,KAAK,MAAA;AACH,MAAA,OAAO,GAAA,CAAI,IAAA;AAAA,IACb,KAAK,OAAA;AACH,MAAA,OAAO,GAAA,CAAI,KAAA;AAAA,IACb,KAAK,QAAA;AACH,MAAA,OAAO,GAAA,CAAI,MAAA;AAAA;AAEjB;AAEO,SAAS,mBAAA,CACd,QACA,GAAA,EACoB;AACpB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,IAAI,WAAW,MAAA,EAAQ;AACrB,IAAA,OAAO,MAAA,CAAO,KAAA;AAAA,EAChB;AACA,EAAA,MAAM,GAAA,GAAM,gBAAgB,kBAAA,CAAmB,GAAA,EAAK,OAAO,IAAI,CAAA,EAAG,OAAO,KAAK,CAAA;AAC9E,EAAA,IAAI,OAAO,GAAA,KAAQ,QAAA,IAAY,GAAA,CAAI,IAAA,OAAW,EAAA,EAAI;AAChD,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,OAAO,GAAA,CAAI,IAAA,EAAK,CAAE,WAAA,EAAY;AAChC;AAEA,SAAS,eAAA,CACP,KAAA,EACA,IAAA,EACA,OAAA,EAC2B;AAC3B,EAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,KAAA,EAAO,MAAM,OAAA,EAAQ;AAC3C;AAEA,SAAS,sBAAA,CAAuB,KAAyB,KAAA,EAAwC;AAC/F,EAAA,GAAA,CAAI,MAAA,CAAO,GAAG,CAAA,CAAE,IAAA,CAAK,KAAK,CAAA;AAC5B;AAEO,SAAS,wBAAwB,OAAA,EAA4B;AAClE,EAAA,MAAM,MAAA,GAAS,qBAAqB,OAAO,CAAA;AAE3C,EAAA,OAAO,CAAC,GAAA,EAAwB,GAAA,EAAyB,IAAA,KAA+B;AACtF,IAAA,MAAM,EAAA,GAAK,mBAAA,CAAoB,OAAA,CAAQ,EAAA,EAAI,GAAG,CAAA;AAE9C,IAAA,KAAA,MAAW,EAAE,QAAA,EAAU,KAAA,EAAO,MAAA,MAAY,MAAA,EAAQ;AAChD,MAAA,IAAI,UAAA,CAAW,MAAM,CAAA,IAAK,CAAC,EAAA,EAAI;AAC7B,QAAA,sBAAA;AAAA,UACE,GAAA;AAAA,UACA,eAAA;AAAA,YACE,KAAA;AAAA,YACA,oBAAA;AAAA,YACA;AAAA;AACF,SACF;AACA,QAAA;AAAA,MACF;AAEA,MAAA,MAAM,MAAM,eAAA,CAAgB,kBAAA,CAAmB,GAAA,EAAK,QAAQ,GAAG,KAAK,CAAA;AAEpE,MAAA,IAAI,GAAA,KAAQ,MAAA,IAAa,GAAA,KAAQ,IAAA,EAAM;AACrC,QAAA,sBAAA,CAAuB,GAAA,EAAK,eAAA,CAAgB,KAAA,EAAO,aAAA,EAAe,mBAAmB,CAAC,CAAA;AACtF,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,OAAO,QAAQ,QAAA,EAAU;AAC3B,QAAA,sBAAA,CAAuB,GAAA,EAAK,eAAA,CAAgB,KAAA,EAAO,oBAAA,EAAsB,wBAAwB,CAAC,CAAA;AAClG,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,GAAA,CAAI,IAAA,EAAK,KAAM,EAAA,EAAI;AACrB,QAAA,sBAAA,CAAuB,GAAA,EAAK,eAAA,CAAgB,KAAA,EAAO,aAAA,EAAe,yBAAyB,CAAC,CAAA;AAC5F,QAAA;AAAA,MACF;AAEA,MAAA,MAAM,SAAS,cAAA,CAAe,MAAA,EAAQ,GAAA,EAAK,EAAE,IAAI,CAAA;AACjD,MAAA,IAAI,CAAC,OAAO,EAAA,EAAI;AACd,QAAA,sBAAA,CAAuB,KAAK,eAAA,CAAgB,KAAA,EAAO,OAAO,IAAA,EAAM,MAAA,CAAO,OAAO,CAAC,CAAA;AAC/E,QAAA;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAA,EAAK;AAAA,EACP,CAAA;AACF","file":"chunk-OKPS2N5C.js","sourcesContent":["import {\n  validateBoleto,\n  validateBrCode,\n  validateCartaoCredito,\n  validateCep,\n  validateCnh,\n  validateCnpj,\n  validateCpf,\n  validateIeProdutorRural,\n  validateInscricaoEstadual,\n  validateNfeChave,\n  validatePisPasep,\n  validatePixKey,\n  validatePlaca,\n  validateProcessoJudicial,\n  validateRenavam,\n  validateRg,\n  validateTelefone,\n  validateTituloEleitor,\n  RG_SUPPORTED_UFS,\n  type RgUfCode,\n  type UfCode,\n  type ValidationErrorCode,\n} from '@br-validators/core';\nimport type { BrValidatorTypeId } from './types.js';\n\nexport type ValidatorContext = {\n  uf?: UfCode;\n};\n\nexport type ValidatorOutcome =\n  | { ok: true }\n  | { ok: false; code: ValidationErrorCode; message: string };\n\nexport type ValidatorRunner = (value: string, context: ValidatorContext) => ValidatorOutcome;\n\nconst UF_REQUIRED_TYPES = new Set<BrValidatorTypeId>([\n  'inscricao-estadual',\n  'inscricao-estadual-produtor-rural',\n  'rg',\n]);\n\nexport function requiresUf(typeId: BrValidatorTypeId): boolean {\n  return UF_REQUIRED_TYPES.has(typeId);\n}\n\nfunction missingUfFailure(): ValidatorOutcome {\n  return {\n    ok: false,\n    code: 'UNSUPPORTED_FORMAT',\n    message: 'UF is required for this field — configure brValidate({ uf: { from, field } }) or { value }',\n  };\n}\n\nfunction runWithUf(\n  context: ValidatorContext,\n  validate: (value: string, uf: UfCode) => ValidatorOutcome,\n): (value: string, ctx: ValidatorContext) => ValidatorOutcome {\n  return (value, ctx) => {\n    const uf = ctx.uf ?? context.uf;\n    if (!uf) {\n      return missingUfFailure();\n    }\n    return validate(value, uf);\n  };\n}\n\nfunction isRgUf(uf: UfCode): uf is RgUfCode {\n  return (RG_SUPPORTED_UFS as readonly string[]).includes(uf);\n}\n\nconst VALIDATORS: Record<BrValidatorTypeId, ValidatorRunner> = {\n  cpf: (value) => validateCpf(value),\n  cnpj: (value) => validateCnpj(value),\n  cep: (value) => validateCep(value),\n  placa: (value) => validatePlaca(value),\n  'pis-pasep': (value) => validatePisPasep(value),\n  pix: (value) => validatePixKey(value),\n  telefone: (value) => validateTelefone(value),\n  boleto: (value) => validateBoleto(value),\n  'cartao-credito': (value) => validateCartaoCredito(value),\n  cnh: (value) => validateCnh(value),\n  renavam: (value) => validateRenavam(value),\n  'nfe-chave': (value) => validateNfeChave(value),\n  'titulo-eleitor': (value) => validateTituloEleitor(value),\n  'processo-judicial': (value) => validateProcessoJudicial(value),\n  brcode: (value) => validateBrCode(value),\n  'inscricao-estadual': runWithUf({}, (value, uf) => validateInscricaoEstadual(value, { uf })),\n  'inscricao-estadual-produtor-rural': runWithUf({}, (value, uf) => validateIeProdutorRural(uf, value)),\n  rg: runWithUf({}, (value, uf) => {\n    if (!isRgUf(uf)) {\n      return {\n        ok: false,\n        code: 'UF_NOT_IMPLEMENTED',\n        message: `UF ${uf} is not implemented for RG validation`,\n      };\n    }\n    return validateRg(value, { uf });\n  }),\n};\n\nexport function runBrValidator(\n  typeId: BrValidatorTypeId,\n  value: string,\n  context: ValidatorContext,\n): ValidatorOutcome {\n  return VALIDATORS[typeId](value, context);\n}\n","import type {\n  BrValidateFieldRef,\n  BrValidateLocation,\n  BrValidateNext,\n  BrValidateOptions,\n  BrValidateRequest,\n  BrValidateResponse,\n  BrValidateUfSource,\n  BrValidationErrorResponse,\n} from './types.js';\nimport type { UfCode } from '@br-validators/core';\nimport { requiresUf, runBrValidator } from './validator-registry.js';\n\nfunction readRecordField(record: object | undefined, field: string): unknown {\n  if (!record) {\n    return undefined;\n  }\n  return Object.prototype.hasOwnProperty.call(record, field)\n    ? record[field as keyof typeof record]\n    : undefined;\n}\n\nfunction collectFieldRefs(\n  location: BrValidateLocation,\n  schema: Record<string, import('./types.js').BrValidatorTypeId> | undefined,\n): BrValidateFieldRef[] {\n  if (!schema) {\n    return [];\n  }\n  return Object.entries(schema).map(([field, typeId]) => ({\n    location,\n    field,\n    typeId,\n  }));\n}\n\nexport function listBrValidateFields(options: BrValidateOptions): BrValidateFieldRef[] {\n  return [\n    ...collectFieldRefs('body', options.body),\n    ...collectFieldRefs('query', options.query),\n    ...collectFieldRefs('params', options.params),\n  ];\n}\n\nfunction readLocationRecord(req: BrValidateRequest, location: BrValidateLocation): object | undefined {\n  switch (location) {\n    case 'body':\n      return req.body;\n    case 'query':\n      return req.query;\n    case 'params':\n      return req.params;\n  }\n}\n\nexport function resolveBrValidateUf(\n  source: BrValidateUfSource | undefined,\n  req: BrValidateRequest,\n): UfCode | undefined {\n  if (!source) {\n    return undefined;\n  }\n  if ('value' in source) {\n    return source.value;\n  }\n  const raw = readRecordField(readLocationRecord(req, source.from), source.field);\n  if (typeof raw !== 'string' || raw.trim() === '') {\n    return undefined;\n  }\n  return raw.trim().toUpperCase() as UfCode;\n}\n\nfunction validationError(\n  field: string,\n  code: BrValidationErrorResponse['code'],\n  message: string,\n): BrValidationErrorResponse {\n  return { ok: false, field, code, message };\n}\n\nfunction respondValidationError(res: BrValidateResponse, error: BrValidationErrorResponse): void {\n  res.status(400).json(error);\n}\n\nexport function createBrValidateHandler(options: BrValidateOptions) {\n  const fields = listBrValidateFields(options);\n\n  return (req: BrValidateRequest, res: BrValidateResponse, next: BrValidateNext): void => {\n    const uf = resolveBrValidateUf(options.uf, req);\n\n    for (const { location, field, typeId } of fields) {\n      if (requiresUf(typeId) && !uf) {\n        respondValidationError(\n          res,\n          validationError(\n            field,\n            'UNSUPPORTED_FORMAT',\n            'UF is required for this field — configure brValidate({ uf: { from, field } }) or { value }',\n          ),\n        );\n        return;\n      }\n\n      const raw = readRecordField(readLocationRecord(req, location), field);\n\n      if (raw === undefined || raw === null) {\n        respondValidationError(res, validationError(field, 'EMPTY_INPUT', 'Field is required'));\n        return;\n      }\n\n      if (typeof raw !== 'string') {\n        respondValidationError(res, validationError(field, 'UNSUPPORTED_FORMAT', 'Value must be a string'));\n        return;\n      }\n\n      if (raw.trim() === '') {\n        respondValidationError(res, validationError(field, 'EMPTY_INPUT', 'Field must not be empty'));\n        return;\n      }\n\n      const result = runBrValidator(typeId, raw, { uf });\n      if (!result.ok) {\n        respondValidationError(res, validationError(field, result.code, result.message));\n        return;\n      }\n    }\n\n    next();\n  };\n}\n"]}

package/dist/fastify.d.ts

@@ -0,0 +1,20 @@
+import { B as BrValidateOptions, a as BrValidateRequest } from './br-validate-BOiTO6lR.js';
+export { b as BrValidationErrorResponse, c as BrValidatorTypeId, d as createBrValidateHandler } from './br-validate-BOiTO6lR.js';
+import '@br-validators/core';
+
+type FastifyBrValidateReply = {
+    status(code: number): FastifyBrValidateReply;
+    send(body: object): unknown;
+};
+type FastifyLikeRequest = {
+    body?: unknown;
+    query?: unknown;
+    params?: unknown;
+};
+declare function toBrValidateRequest(request: FastifyLikeRequest): BrValidateRequest;
+/**
+ * Fastify preHandler — same schema as Express `brValidate()`.
+ */
+declare function brValidateFastify(options: BrValidateOptions): (request: FastifyLikeRequest, reply: FastifyBrValidateReply, done: () => void) => void;
+
+export { BrValidateOptions, type FastifyBrValidateReply, brValidateFastify, toBrValidateRequest };

package/dist/fastify.js

@@ -0,0 +1,38 @@
+import { createBrValidateHandler } from './chunk-OKPS2N5C.js';
+export { createBrValidateHandler } from './chunk-OKPS2N5C.js';
+
+// src/fastify.ts
+function asRequestObject(value) {
+  if (typeof value === "object" && value !== null) {
+    return value;
+  }
+  return void 0;
+}
+function toBrValidateRequest(request) {
+  return {
+    body: asRequestObject(request.body),
+    query: asRequestObject(request.query),
+    params: asRequestObject(request.params)
+  };
+}
+function brValidateFastify(options) {
+  const handler = createBrValidateHandler(options);
+  return (request, reply, done) => {
+    let statusCode = 200;
+    const adaptedReply = {
+      status(code) {
+        statusCode = code;
+        reply.status(code);
+        return adaptedReply;
+      },
+      json(body) {
+        void reply.status(statusCode).send(body);
+      }
+    };
+    handler(toBrValidateRequest(request), adaptedReply, done);
+  };
+}
+
+export { brValidateFastify, toBrValidateRequest };
+//# sourceMappingURL=fastify.js.map
+//# sourceMappingURL=fastify.js.map

package/dist/fastify.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fastify.ts"],"names":[],"mappings":";;;;AAcA,SAAS,gBAAgB,KAAA,EAAoC;AAC3D,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA,EAAM;AAC/C,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA;AACT;AAEO,SAAS,oBAAoB,OAAA,EAAgD;AAClF,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,eAAA,CAAgB,OAAA,CAAQ,IAAI,CAAA;AAAA,IAClC,KAAA,EAAO,eAAA,CAAgB,OAAA,CAAQ,KAAK,CAAA;AAAA,IACpC,MAAA,EAAQ,eAAA,CAAgB,OAAA,CAAQ,MAAM;AAAA,GACxC;AACF;AAKO,SAAS,kBAAkB,OAAA,EAA4B;AAC5D,EAAA,MAAM,OAAA,GAAU,wBAAwB,OAAO,CAAA;AAC/C,EAAA,OAAO,CAAC,OAAA,EAA6B,KAAA,EAA+B,IAAA,KAA2B;AAC7F,IAAA,IAAI,UAAA,GAAa,GAAA;AACjB,IAAA,MAAM,YAAA,GAAe;AAAA,MACnB,OAAO,IAAA,EAAc;AACnB,QAAA,UAAA,GAAa,IAAA;AACb,QAAA,KAAA,CAAM,OAAO,IAAI,CAAA;AACjB,QAAA,OAAO,YAAA;AAAA,MACT,CAAA;AAAA,MACA,KAAK,IAAA,EAAc;AACjB,QAAA,KAAK,KAAA,CAAM,MAAA,CAAO,UAAU,CAAA,CAAE,KAAK,IAAI,CAAA;AAAA,MACzC;AAAA,KACF;AACA,IAAA,OAAA,CAAQ,mBAAA,CAAoB,OAAO,CAAA,EAAG,YAAA,EAAc,IAAI,CAAA;AAAA,EAC1D,CAAA;AACF","file":"fastify.js","sourcesContent":["import { createBrValidateHandler } from './br-validate.js';\nimport type { BrValidateOptions, BrValidateRequest } from './types.js';\n\nexport type FastifyBrValidateReply = {\n  status(code: number): FastifyBrValidateReply;\n  send(body: object): unknown;\n};\n\ntype FastifyLikeRequest = {\n  body?: unknown;\n  query?: unknown;\n  params?: unknown;\n};\n\nfunction asRequestObject(value: unknown): object | undefined {\n  if (typeof value === 'object' && value !== null) {\n    return value;\n  }\n  return undefined;\n}\n\nexport function toBrValidateRequest(request: FastifyLikeRequest): BrValidateRequest {\n  return {\n    body: asRequestObject(request.body),\n    query: asRequestObject(request.query),\n    params: asRequestObject(request.params),\n  };\n}\n\n/**\n * Fastify preHandler — same schema as Express `brValidate()`.\n */\nexport function brValidateFastify(options: BrValidateOptions) {\n  const handler = createBrValidateHandler(options);\n  return (request: FastifyLikeRequest, reply: FastifyBrValidateReply, done: () => void): void => {\n    let statusCode = 200;\n    const adaptedReply = {\n      status(code: number) {\n        statusCode = code;\n        reply.status(code);\n        return adaptedReply;\n      },\n      json(body: object) {\n        void reply.status(statusCode).send(body);\n      },\n    };\n    handler(toBrValidateRequest(request), adaptedReply, done);\n  };\n}\n\nexport { createBrValidateHandler } from './br-validate.js';\nexport type { BrValidateOptions, BrValidationErrorResponse, BrValidatorTypeId } from './types.js';\n"]}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { RequestHandler } from 'express';
+import { c as BrValidatorTypeId, B as BrValidateOptions } from './br-validate-BOiTO6lR.js';
+export { e as BR_VALIDATOR_TYPE_IDS, f as BrValidateFieldSchema, g as BrValidateLocation, h as BrValidateUfSource, b as BrValidationErrorResponse, d as createBrValidateHandler, i as isBrValidatorTypeId } from './br-validate-BOiTO6lR.js';
+import '@br-validators/core';
+
+declare function requiresUf(typeId: BrValidatorTypeId): boolean;
+
+/**
+ * Express middleware factory — validates request fields with @br-validators/core.
+ * Invalid input responds with HTTP 400 and `{ ok: false, field, code, message }`.
+ */
+declare function brValidate(options: BrValidateOptions): RequestHandler;
+
+export { BrValidateOptions, BrValidatorTypeId, brValidate, requiresUf };

package/dist/index.js

@@ -0,0 +1,39 @@
+import { createBrValidateHandler } from './chunk-OKPS2N5C.js';
+export { createBrValidateHandler, requiresUf } from './chunk-OKPS2N5C.js';
+
+// src/types.ts
+var BR_VALIDATOR_TYPE_IDS = [
+  "cpf",
+  "cnpj",
+  "cep",
+  "placa",
+  "pis-pasep",
+  "pix",
+  "telefone",
+  "boleto",
+  "cartao-credito",
+  "cnh",
+  "renavam",
+  "nfe-chave",
+  "titulo-eleitor",
+  "processo-judicial",
+  "inscricao-estadual",
+  "inscricao-estadual-produtor-rural",
+  "brcode",
+  "rg"
+];
+function isBrValidatorTypeId(value) {
+  return BR_VALIDATOR_TYPE_IDS.includes(value);
+}
+
+// src/index.ts
+function brValidate(options) {
+  const handler = createBrValidateHandler(options);
+  return (req, res, next) => {
+    handler(req, res, next);
+  };
+}
+
+export { BR_VALIDATOR_TYPE_IDS, brValidate, isBrValidatorTypeId };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/index.ts"],"names":[],"mappings":";;;;AAuBO,IAAM,qBAAA,GAAwB;AAAA,EACnC,KAAA;AAAA,EACA,MAAA;AAAA,EACA,KAAA;AAAA,EACA,OAAA;AAAA,EACA,WAAA;AAAA,EACA,KAAA;AAAA,EACA,UAAA;AAAA,EACA,QAAA;AAAA,EACA,gBAAA;AAAA,EACA,KAAA;AAAA,EACA,SAAA;AAAA,EACA,WAAA;AAAA,EACA,gBAAA;AAAA,EACA,mBAAA;AAAA,EACA,oBAAA;AAAA,EACA,mCAAA;AAAA,EACA,QAAA;AAAA,EACA;AACF;AAsCO,SAAS,oBAAoB,KAAA,EAA2C;AAC7E,EAAA,OAAQ,qBAAA,CAA4C,SAAS,KAAK,CAAA;AACpE;;;AC1EO,SAAS,WAAW,OAAA,EAA4C;AACrE,EAAA,MAAM,OAAA,GAAU,wBAAwB,OAAO,CAAA;AAC/C,EAAA,OAAO,CAAC,GAAA,EAAK,GAAA,EAAK,IAAA,KAAS;AACzB,IAAA,OAAA,CAAQ,GAAA,EAAK,KAAK,IAAI,CAAA;AAAA,EACxB,CAAA;AACF","file":"index.js","sourcesContent":["import type { UfCode, ValidationErrorCode } from '@br-validators/core';\n\n/** Core validator type ids supported by `brValidate()`. */\nexport type BrValidatorTypeId =\n  | 'cpf'\n  | 'cnpj'\n  | 'cep'\n  | 'placa'\n  | 'pis-pasep'\n  | 'pix'\n  | 'telefone'\n  | 'boleto'\n  | 'cartao-credito'\n  | 'cnh'\n  | 'renavam'\n  | 'nfe-chave'\n  | 'titulo-eleitor'\n  | 'processo-judicial'\n  | 'inscricao-estadual'\n  | 'inscricao-estadual-produtor-rural'\n  | 'brcode'\n  | 'rg';\n\nexport const BR_VALIDATOR_TYPE_IDS = [\n  'cpf',\n  'cnpj',\n  'cep',\n  'placa',\n  'pis-pasep',\n  'pix',\n  'telefone',\n  'boleto',\n  'cartao-credito',\n  'cnh',\n  'renavam',\n  'nfe-chave',\n  'titulo-eleitor',\n  'processo-judicial',\n  'inscricao-estadual',\n  'inscricao-estadual-produtor-rural',\n  'brcode',\n  'rg',\n] as const satisfies readonly BrValidatorTypeId[];\n\nexport type BrValidateLocation = 'body' | 'query' | 'params';\n\nexport type BrValidateFieldSchema = Record<string, BrValidatorTypeId>;\n\nexport type BrValidateUfSource =\n  | { from: BrValidateLocation; field: string }\n  | { value: UfCode };\n\nexport type BrValidateOptions = {\n  body?: BrValidateFieldSchema;\n  query?: BrValidateFieldSchema;\n  params?: BrValidateFieldSchema;\n  /** Required for `inscricao-estadual`, `inscricao-estadual-produtor-rural`, and `rg`. */\n  uf?: BrValidateUfSource;\n};\n\nexport type BrValidationErrorResponse = {\n  ok: false;\n  field: string;\n  code: ValidationErrorCode;\n  message: string;\n};\n\nexport type BrValidateRequest = {\n  body?: object;\n  query?: object;\n  params?: object;\n};\n\nexport type BrValidateResponse = {\n  status(code: number): BrValidateResponse;\n  json(body: BrValidationErrorResponse): void;\n};\n\nexport type BrValidateNext = () => void;\n\nexport function isBrValidatorTypeId(value: string): value is BrValidatorTypeId {\n  return (BR_VALIDATOR_TYPE_IDS as readonly string[]).includes(value);\n}\n\nexport type BrValidateFieldRef = {\n  location: BrValidateLocation;\n  field: string;\n  typeId: BrValidatorTypeId;\n};\n","import type { RequestHandler } from 'express';\nimport { createBrValidateHandler } from './br-validate.js';\nimport type { BrValidateOptions } from './types.js';\n\n/**\n * Express middleware factory — validates request fields with @br-validators/core.\n * Invalid input responds with HTTP 400 and `{ ok: false, field, code, message }`.\n */\nexport function brValidate(options: BrValidateOptions): RequestHandler {\n  const handler = createBrValidateHandler(options);\n  return (req, res, next) => {\n    handler(req, res, next);\n  };\n}\n\nexport { createBrValidateHandler } from './br-validate.js';\nexport {\n  BR_VALIDATOR_TYPE_IDS,\n  isBrValidatorTypeId,\n  type BrValidateFieldSchema,\n  type BrValidateLocation,\n  type BrValidateOptions,\n  type BrValidateUfSource,\n  type BrValidationErrorResponse,\n  type BrValidatorTypeId,\n} from './types.js';\nexport { requiresUf } from './validator-registry.js';\n"]}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@br-validators/express",
+  "version": "1.6.0",
+  "description": "Express and Fastify middleware for Brazilian document validators — delegates to @br-validators/core",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AlexandreZanata/br-validators.git",
+    "directory": "packages/br-validators-express"
+  },
+  "homepage": "https://github.com/AlexandreZanata/br-validators/tree/main/packages/br-validators-express#readme",
+  "bugs": {
+    "url": "https://github.com/AlexandreZanata/br-validators/issues"
+  },
+  "keywords": [
+    "brazil",
+    "express",
+    "fastify",
+    "middleware",
+    "validator",
+    "cpf",
+    "cnpj"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./fastify": {
+      "types": "./dist/fastify.d.ts",
+      "import": "./dist/fastify.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "express": "^4.21.0 || ^5.0.0",
+    "@br-validators/core": "1.6.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@br-validators/core": "1.6.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.3",
+    "@types/node": "^22.15.21",
+    "@vitest/coverage-v8": "^3.2.4",
+    "express": "^5.1.0",
+    "fastify": "^5.4.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsup",
+    "pretypecheck": "pnpm --filter @br-validators/core build",
+    "pretest": "pnpm --filter @br-validators/core build",
+    "pretest:coverage": "pnpm --filter @br-validators/core build",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src tests --max-warnings 0"
+  }
+}