opf-validator 0.0.1

package/README.md

@@ -0,0 +1,143 @@
+# OPF Validator
+
+Biblioteca TypeScript para validar requisições da Open Finance Brasil.
+
+## Características
+
+- ✅ Validadores para consentimentos, pagamentos únicos e recorrentes
+- ✅ Suporte completo a TypeScript
+- ✅ Tratamento de erros conforme Open Finance Brasil
+- ✅ Estrutura modular por domínio
+- ✅ Sem dependências
+
+## Instalação
+
+```bash
+npm install opf-validator
+```
+
+## Uso Rápido
+
+```typescript
+import { validateCreatePixPayment } from "opf-validator/payments";
+
+const resultado = validateCreatePixPayment({
+  data: {
+    endToEndId: "E12345678901234567890123456789",
+    date: "2025-01-15",
+    payment: { amount: "250.75", currency: "BRL" },
+    creditorAccount: { ispb: "00000000", number: "9876543210987", accountType: "CACC", issuer: "code" },
+    document: { identification: "12345678901", rel: "CPF" },
+    localInstrument: "DICT"
+  }
+});
+
+if (resultado.isValid) {
+  console.log("✓ Válido");
+} else {
+  console.error("✗ Erros:", resultado.errors);
+}
+```
+
+## Validadores Disponíveis
+
+### Headers de Requisição
+- `validateHeaders` - Validar todos os headers
+- `validateHeader` - Validar um header específico com obrigatoriedade customizável
+- `validateHeaderRequired` - Validar header como obrigatório
+- `validateHeaderOptional` - Validar header como opcional
+
+### Consentimentos
+- `validateCreateConsent` - Criar consentimento
+- `validateCreateConsentExtensions` - Estender consentimento
+
+### Pagamentos Únicos
+- `validateCreatePaymentConsent` - Criar consentimento de pagamento
+- `validateCreatePixPayment` - Criar pagamento Pix
+- `validatePatchPixPayment` - Cancelar pagamento
+
+### Pagamentos Recorrentes
+- `validateCreateRecurringConsent` - Criar consentimento recorrente
+- `validatePatchRecurringConsent` - Autorizar consentimento recorrente
+- `validateCreateRecurringPixPayment` - Criar pagamento recorrente
+- `validatePatchRecurringPixPayment` - Cancelar pagamento recorrente
+- `validateCreateRecurringRetryPixPayment` - Tentar novamente pagamento recorrente
+
+## Validação de Headers HTTP
+
+Os headers são validados conforme especificações da Open Finance Brasil. Há três formas de validação:
+
+```typescript
+import { 
+  validateHeader, 
+  validateHeaderRequired, 
+  validateHeaderOptional,
+  validateHeaders 
+} from "opf-validator/utils/validateHeaderParameters";
+
+// Forma 1: Com override de obrigatoriedade (customizável por endpoint)
+const result = validateHeader('x-fapi-interaction-id', value, false); // Opcional
+const result = validateHeader('Authorization', token, true);          // Obrigatório
+
+// Forma 2: Sempre obrigatório
+const result = validateHeaderRequired('x-fapi-interaction-id', uuid);
+
+// Forma 3: Sempre opcional
+const result = validateHeaderOptional('X-Idempotency-Key', key);
+
+// Validar todos os headers de uma requisição
+const result = validateHeaders(request.headers);
+```
+
+**Exemplo com Express:**
+
+```typescript
+import express from 'express';
+import { validateHeaders } from 'opf-validator/utils/validateHeaderParameters';
+
+app.post('/api/payments', (req, res) => {
+  const validation = validateHeaders(req.headers);
+  if (!validation.isValid) {
+    return res.status(400).json(validation.errors);
+  }
+  // Prosseguir com a lógica...
+});
+```
+
+Para exemplos detalhados, consulte [VALIDATORS_GUIDE.md](./VALIDATORS_GUIDE.md).
+
+## Módulos
+
+```typescript
+// Consentimentos
+import { validateCreateConsent, validateCreateConsentExtensions } from "opf-validator/consent";
+
+// Pagamentos únicos
+import { validateCreatePaymentConsent, validateCreatePixPayment, validatePatchPixPayment } from "opf-validator/payments";
+
+// Pagamentos recorrentes
+import { validateCreateRecurringConsent, validatePatchRecurringConsent, validateCreateRecurringPixPayment, validatePatchRecurringPixPayment, validateCreateRecurringRetryPixPayment } from "opf-validator/recurring-payments";
+
+// Utilitários
+import { validateCPF, validateAmount } from "opf-validator";
+```
+
+## Documentação
+
+Veja [QUICK_START.md](./QUICK_START.md) para exemplos completos.
+
+## Estrutura
+
+```
+opf-validator/
+├── consent/               # Validadores de consentimentos
+├── payments/              # Validadores de pagamentos únicos
+├── recurring-payments/    # Validadores de pagamentos recorrentes
+├── utils/                 # Utilitários e tipos
+├── index.ts               # Exports principais
+└── QUICK_START.md         # Guia de início rápido
+```
+
+## Referências
+
+- [Open Finance Brasil](https://www.gov.br/cidadania/pt-br/acesso-a-informacao/perguntas-frequentes/open-finance)

package/dist/consent/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Consent Module - Exports all validators and success responses
+ */
+export { validateCreateConsent } from "./validators/createConsent";
+export type { CreateConsentPayload, CreateConsentData } from "./validators/createConsent";
+export { validateCreateConsentExtensions } from "./validators/createConsentExtensions";
+export type { CreateConsentExtensionsPayload, CreateConsentExtensionsData, LoggedUserExtensions, BusinessEntityExtensions, } from "./validators/createConsentExtensions";
+export type { CreateConsentSuccessResponse, GetConsentSuccessResponse, CreateConsentExtensionsSuccessResponse, } from "./successResponses";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/consent/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE1F,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,YAAY,EACV,8BAA8B,EAC9B,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,sCAAsC,CAAC;AAG9C,YAAY,EACV,4BAA4B,EAC5B,yBAAyB,EACzB,sCAAsC,GACvC,MAAM,oBAAoB,CAAC"}

package/dist/consent/index.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Consent Module - Exports all validators and success responses
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateCreateConsentExtensions = exports.validateCreateConsent = void 0;
+// Validators
+var createConsent_1 = require("./validators/createConsent");
+Object.defineProperty(exports, "validateCreateConsent", { enumerable: true, get: function () { return createConsent_1.validateCreateConsent; } });
+var createConsentExtensions_1 = require("./validators/createConsentExtensions");
+Object.defineProperty(exports, "validateCreateConsentExtensions", { enumerable: true, get: function () { return createConsentExtensions_1.validateCreateConsentExtensions; } });
+//# sourceMappingURL=index.js.map

package/dist/consent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/consent/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,aAAa;AACb,4DAAmE;AAA1D,sHAAA,qBAAqB,OAAA;AAG9B,gFAAuF;AAA9E,0IAAA,+BAA+B,OAAA"}

package/dist/consent/successResponses/index.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Interfaces de Sucesso para Respostas de Consent
+ */
+/**
+ * Resposta de sucesso para POST /consents (CreateConsent)
+ */
+export interface CreateConsentSuccessResponse {
+    data: {
+        consentId: string;
+        status: string;
+        statusUpdateDateTime: string;
+        permissions: string[];
+        expirationDateTime: string;
+        loggedUser?: {
+            document: {
+                identification: string;
+                rel: string;
+            };
+        };
+    };
+    links?: {
+        self: string;
+        first?: string;
+        prev?: string;
+        next?: string;
+        last?: string;
+    };
+    meta?: {
+        totalRecords?: number;
+        totalPages?: number;
+        requestDateTime: string;
+    };
+}
+/**
+ * Resposta de sucesso para GET /consents/:consentId (GetConsent)
+ */
+export interface GetConsentSuccessResponse {
+    data: {
+        consentId: string;
+        status: string;
+        statusUpdateDateTime: string;
+        permissions: string[];
+        expirationDateTime: string;
+        creationDateTime: string;
+        loggedUser?: {
+            document: {
+                identification: string;
+                rel: string;
+            };
+        };
+    };
+    links?: {
+        self: string;
+    };
+    meta?: {
+        requestDateTime: string;
+    };
+}
+/**
+ * Resposta de sucesso para POST /consents/:consentId/extensions (CreateConsentExtensions)
+ */
+export interface CreateConsentExtensionsSuccessResponse {
+    data: {
+        consentId: string;
+        status: string;
+        statusUpdateDateTime: string;
+        permissions: string[];
+        expirationDateTime: string;
+        loggedUser?: {
+            document: {
+                identification: string;
+                rel: string;
+            };
+        };
+        businessEntity?: {
+            document: {
+                identification: string;
+                rel: string;
+            };
+        };
+    };
+    links?: {
+        self: string;
+    };
+    meta?: {
+        requestDateTime: string;
+    };
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/consent/successResponses/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/consent/successResponses/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,oBAAoB,EAAE,MAAM,CAAC;QAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,UAAU,CAAC,EAAE;YACX,QAAQ,EAAE;gBACR,cAAc,EAAE,MAAM,CAAC;gBACvB,GAAG,EAAE,MAAM,CAAC;aACb,CAAC;SACH,CAAC;KACH,CAAC;IACF,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,IAAI,CAAC,EAAE;QACL,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,oBAAoB,EAAE,MAAM,CAAC;QAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,CAAC,EAAE;YACX,QAAQ,EAAE;gBACR,cAAc,EAAE,MAAM,CAAC;gBACvB,GAAG,EAAE,MAAM,CAAC;aACb,CAAC;SACH,CAAC;KACH,CAAC;IACF,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,IAAI,CAAC,EAAE;QACL,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sCAAsC;IACrD,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,oBAAoB,EAAE,MAAM,CAAC;QAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,UAAU,CAAC,EAAE;YACX,QAAQ,EAAE;gBACR,cAAc,EAAE,MAAM,CAAC;gBACvB,GAAG,EAAE,MAAM,CAAC;aACb,CAAC;SACH,CAAC;QACF,cAAc,CAAC,EAAE;YACf,QAAQ,EAAE;gBACR,cAAc,EAAE,MAAM,CAAC;gBACvB,GAAG,EAAE,MAAM,CAAC;aACb,CAAC;SACH,CAAC;KACH,CAAC;IACF,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,IAAI,CAAC,EAAE;QACL,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH"}

package/dist/consent/successResponses/index.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Interfaces de Sucesso para Respostas de Consent
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/consent/successResponses/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/consent/successResponses/index.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/consent/validators/createConsent.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Validações para CreateConsent
+ * Segue as regras especificadas no Open Finance Brasil
+ */
+import { ValidationResult } from "../../utils/openFinanceErrors";
+interface LoggedUser {
+    documentType: string;
+    documentNumber: string;
+}
+interface BusinessEntity {
+    document: {
+        identification: string;
+        rel: string;
+    };
+}
+interface CreateConsentData {
+    permissions: string[];
+    loggedUser: LoggedUser;
+    businessEntity?: BusinessEntity;
+    expirationDateTime?: string;
+    isLinked?: boolean;
+}
+interface CreateConsentPayload {
+    data: CreateConsentData;
+}
+/**
+ * Valida o payload de criação de consentimento
+ */
+export declare function validateCreateConsent(payload: any): ValidationResult;
+export { CreateConsentPayload, CreateConsentData };
+//# sourceMappingURL=createConsent.d.ts.map

package/dist/consent/validators/createConsent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createConsent.d.ts","sourceRoot":"","sources":["../../../src/consent/validators/createConsent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,gBAAgB,EAGjB,MAAM,+BAA+B,CAAC;AAEvC,UAAU,UAAU;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,cAAc;IACtB,QAAQ,EAAE;QACR,cAAc,EAAE,MAAM,CAAC;QACvB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED,UAAU,iBAAiB;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAyCD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,GAAG,GAAG,gBAAgB,CAuDpE;AA8MD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/consent/validators/createConsent.js

@@ -0,0 +1,205 @@
+"use strict";
+/**
+ * Validações para CreateConsent
+ * Segue as regras especificadas no Open Finance Brasil
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateCreateConsent = validateCreateConsent;
+const openFinanceErrors_1 = require("../../utils/openFinanceErrors");
+const VALID_PERMISSIONS = [
+    "ACCOUNTS_READ",
+    "ACCOUNTS_BALANCES_READ",
+    "ACCOUNTS_TRANSACTIONS_READ",
+    "ACCOUNTS_OVERDRAFT_LIMITS_READ",
+    "CREDIT_CARDS_ACCOUNTS_READ",
+    "CREDIT_CARDS_ACCOUNTS_BILLS_READ",
+    "CREDIT_CARDS_ACCOUNTS_BILLS_TRANSACTIONS_READ",
+    "CREDIT_CARDS_ACCOUNTS_LIMITS_READ",
+    "CREDIT_CARDS_ACCOUNTS_TRANSACTIONS_READ",
+    "CUSTOMERS_PERSONAL_IDENTIFICATIONS_READ",
+    "CUSTOMERS_PERSONAL_ADITTIONALINFO_READ",
+    "CUSTOMERS_BUSINESS_IDENTIFICATIONS_READ",
+    "CUSTOMERS_BUSINESS_ADITTIONALINFO_READ",
+    "FINANCINGS_READ",
+    "FINANCINGS_SCHEDULED_INSTALMENTS_READ",
+    "FINANCINGS_PAYMENTS_READ",
+    "FINANCINGS_WARRANTIES_READ",
+    "INVOICE_FINANCINGS_READ",
+    "INVOICE_FINANCINGS_SCHEDULED_INSTALMENTS_READ",
+    "INVOICE_FINANCINGS_PAYMENTS_READ",
+    "INVOICE_FINANCINGS_WARRANTIES_READ",
+    "LOANS_READ",
+    "LOANS_SCHEDULED_INSTALMENTS_READ",
+    "LOANS_PAYMENTS_READ",
+    "LOANS_WARRANTIES_READ",
+    "UNARRANGED_ACCOUNTS_OVERDRAFT_READ",
+    "UNARRANGED_ACCOUNTS_OVERDRAFT_SCHEDULED_INSTALMENTS_READ",
+    "UNARRANGED_ACCOUNTS_OVERDRAFT_PAYMENTS_READ",
+    "UNARRANGED_ACCOUNTS_OVERDRAFT_WARRANTIES_READ",
+    "RESOURCES_READ",
+    "BANK_FIXED_INCOMES_READ",
+    "CREDIT_FIXED_INCOMES_READ",
+    "FUNDS_READ",
+    "VARIABLE_INCOMES_READ",
+    "TREASURE_TITLES_READ",
+    "EXCHANGES_READ",
+];
+/**
+ * Valida o payload de criação de consentimento
+ */
+function validateCreateConsent(payload) {
+    const errors = [];
+    // Validação: data deve existir
+    if (!payload.data) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_NAO_INFORMADO("data"));
+        return { isValid: false, errors };
+    }
+    const data = payload.data;
+    // Validação: permissions é obrigatório
+    if (!data.permissions) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_NAO_INFORMADO("permissions"));
+    }
+    else {
+        const permissionErrors = validatePermissions(data.permissions);
+        errors.push(...permissionErrors);
+    }
+    // Validação: loggedUser é obrigatório
+    if (!data.loggedUser) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_NAO_INFORMADO("loggedUser"));
+    }
+    else {
+        const loggedUserErrors = validateLoggedUser(data.loggedUser);
+        errors.push(...loggedUserErrors);
+    }
+    // Validação: expirationDateTime (regulatory-required)
+    if (data.expirationDateTime) {
+        const expirationErrors = validateExpirationDateTime(data.expirationDateTime);
+        errors.push(...expirationErrors);
+    }
+    // Validação: isLinked
+    if (data.isLinked !== undefined && typeof data.isLinked !== "boolean") {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO("isLinked", "Deve ser um valor booleano"));
+    }
+    // Validação: businessEntity (opcional)
+    if (data.businessEntity) {
+        const businessEntityErrors = validateBusinessEntity(data.businessEntity);
+        errors.push(...businessEntityErrors);
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Valida permissions array
+ */
+function validatePermissions(permissions) {
+    const errors = [];
+    if (!Array.isArray(permissions)) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO("permissions", "Deve ser um array de strings"));
+        return errors;
+    }
+    if (permissions.length === 0) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO("permissions", "Array não pode estar vazio (minItems: 1)"));
+        return errors;
+    }
+    // Validar duplicidade
+    const uniquePermissions = new Set(permissions);
+    if (uniquePermissions.size !== permissions.length) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO("permissions", "Array não deve ter duplicidade de itens"));
+    }
+    // Validar permissões conhecidas
+    const invalidPermissions = permissions.filter((permission) => !VALID_PERMISSIONS.includes(permission));
+    if (invalidPermissions.length > 0) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO("permissions", `Permissões inválidas encontradas: ${invalidPermissions.join(", ")}`));
+    }
+    return errors;
+}
+/**
+ * Valida LoggedUser
+ */
+function validateLoggedUser(loggedUser) {
+    const errors = [];
+    if (typeof loggedUser !== "object" || loggedUser === null) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO("loggedUser", "Deve ser um objeto"));
+        return errors;
+    }
+    // documentType é obrigatório
+    if (!loggedUser.documentType) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_NAO_INFORMADO("loggedUser.documentType"));
+    }
+    else if (typeof loggedUser.documentType !== "string") {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO("loggedUser.documentType", "Deve ser uma string"));
+    }
+    // documentNumber é obrigatório
+    if (!loggedUser.documentNumber) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_NAO_INFORMADO("loggedUser.documentNumber"));
+    }
+    else if (typeof loggedUser.documentNumber !== "string") {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO("loggedUser.documentNumber", "Deve ser uma string"));
+    }
+    return errors;
+}
+/**
+ * Valida expirationDateTime
+ * RFC-3339 format: YYYY-MM-DDTHH:mm:ssZ
+ * maxLength: 20
+ */
+function validateExpirationDateTime(expirationDateTime) {
+    const errors = [];
+    if (typeof expirationDateTime !== "string") {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO("expirationDateTime", "Deve ser uma string em formato RFC-3339"));
+        return errors;
+    }
+    if (expirationDateTime.length > 20) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO("expirationDateTime", "Deve ter no máximo 20 caracteres"));
+    }
+    // Validar formato RFC-3339 (UTC)
+    const rfc3339Pattern = /^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])T(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)Z$/;
+    if (!rfc3339Pattern.test(expirationDateTime)) {
+        errors.push((0, openFinanceErrors_1.createError)("DATA_EXPIRACAO_INVALIDA", "Nova data para expiração do consentimento é inválida.", "A data de expiração deve estar no formato RFC-3339 com timezone UTC (YYYY-MM-DDTHH:mm:ssZ)"));
+    }
+    return errors;
+}
+/**
+ * Valida BusinessEntity
+ */
+function validateBusinessEntity(businessEntity) {
+    const errors = [];
+    if (typeof businessEntity !== "object" || businessEntity === null) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO("businessEntity", "Deve ser um objeto"));
+        return errors;
+    }
+    if (!businessEntity.document) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_NAO_INFORMADO("businessEntity.document"));
+    }
+    else {
+        const documentErrors = validateDocument(businessEntity.document);
+        errors.push(...documentErrors);
+    }
+    return errors;
+}
+/**
+ * Valida Document
+ */
+function validateDocument(document) {
+    const errors = [];
+    if (typeof document !== "object" || document === null) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO("document", "Deve ser um objeto"));
+        return errors;
+    }
+    if (!document.identification) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_NAO_INFORMADO("document.identification"));
+    }
+    else if (typeof document.identification !== "string") {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO("document.identification", "Deve ser uma string"));
+    }
+    if (!document.rel) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_NAO_INFORMADO("document.rel"));
+    }
+    else if (typeof document.rel !== "string") {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO("document.rel", "Deve ser uma string"));
+    }
+    return errors;
+}
+//# sourceMappingURL=createConsent.js.map

package/dist/consent/validators/createConsent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createConsent.js","sourceRoot":"","sources":["../../../src/consent/validators/createConsent.ts"],"names":[],"mappings":"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"}

package/dist/consent/validators/createConsentExtensions.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Validações para CreateConsentExtensions
+ * Segue as regras especificadas no Open Finance Brasil para renovação de consentimento
+ */
+import { ValidationResult } from "../../utils/openFinanceErrors";
+interface LoggedUserDocumentExtensions {
+    identification: string;
+    rel: string;
+}
+interface LoggedUserExtensions {
+    document: LoggedUserDocumentExtensions;
+}
+interface BusinessEntityDocumentExtensions {
+    identification: string;
+    rel: string;
+}
+interface BusinessEntityExtensions {
+    document: BusinessEntityDocumentExtensions;
+}
+interface CreateConsentExtensionsData {
+    expirationDateTime?: string;
+    loggedUser: LoggedUserExtensions;
+    businessEntity?: BusinessEntityExtensions;
+}
+interface CreateConsentExtensionsPayload {
+    data: CreateConsentExtensionsData;
+}
+/**
+ * Valida o payload de renovação de consentimento
+ */
+export declare function validateCreateConsentExtensions(payload: any): ValidationResult;
+export { CreateConsentExtensionsPayload, CreateConsentExtensionsData, LoggedUserExtensions, BusinessEntityExtensions, };
+//# sourceMappingURL=createConsentExtensions.d.ts.map

package/dist/consent/validators/createConsentExtensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createConsentExtensions.d.ts","sourceRoot":"","sources":["../../../src/consent/validators/createConsentExtensions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,gBAAgB,EAGjB,MAAM,+BAA+B,CAAC;AAEvC,UAAU,4BAA4B;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,4BAA4B,CAAC;CACxC;AAED,UAAU,gCAAgC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,wBAAwB;IAChC,QAAQ,EAAE,gCAAgC,CAAC;CAC5C;AAED,UAAU,2BAA2B;IACnC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,oBAAoB,CAAC;IACjC,cAAc,CAAC,EAAE,wBAAwB,CAAC;CAC3C;AAED,UAAU,8BAA8B;IACtC,IAAI,EAAE,2BAA2B,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,GAAG,GAAG,gBAAgB,CAuC9E;AA0RD,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,GACzB,CAAC"}