opf-validator 0.0.1

package/dist/utils/openFinanceErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openFinanceErrors.d.ts","sourceRoot":"","sources":["../../src/utils/openFinanceErrors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;CAiB7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BpC,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,WAAW,CAMb;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;yCACc,MAAM;oCAOX,MAAM,UAAU,MAAM;4CAOd,MAAM,UAAU,MAAM;;4CActB,MAAM;;+BAcnB,MAAM;CAMlC,CAAC"}

package/dist/utils/openFinanceErrors.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Padrão de Erros do Open Finance Brasil
+ * Seguindo a especificação da API de Consentimentos
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommonErrors = exports.PaymentConsentErrorCodes = exports.ConsentErrorCodes = void 0;
+exports.createError = createError;
+/**
+ * Códigos de erro para CreateConsent e CreateConsentExtensions
+ */
+exports.ConsentErrorCodes = {
+    DEPENDE_MULTIPLA_ALCADA: {
+        title: "Necessário aprovação de múltipla alçada.",
+        code: "DEPENDE_MULTIPLA_ALCADA",
+    },
+    ESTADO_CONSENTIMENTO_INVALIDO: {
+        title: "Estado inválido do consentimento.",
+        code: "ESTADO_CONSENTIMENTO_INVALIDO",
+    },
+    DATA_EXPIRACAO_INVALIDA: {
+        title: "Nova data para expiração do consentimento é inválida.",
+        code: "DATA_EXPIRACAO_INVALIDA",
+    },
+    ERRO_NAO_MAPEADO: {
+        title: "Erro não mapeado.",
+        code: "ERRO_NAO_MAPEADO",
+    },
+};
+/**
+ * Códigos de erro para CreatePaymentConsent
+ */
+exports.PaymentConsentErrorCodes = {
+    FORMA_PAGAMENTO_INVALIDA: {
+        title: "Forma de pagamento inválida.",
+        code: "FORMA_PAGAMENTO_INVALIDA",
+    },
+    DATA_PAGAMENTO_INVALIDA: {
+        title: "Data de pagamento inválida.",
+        code: "DATA_PAGAMENTO_INVALIDA",
+    },
+    DETALHE_PAGAMENTO_INVALIDO: {
+        title: "Detalhe do pagamento inválido.",
+        code: "DETALHE_PAGAMENTO_INVALIDO",
+    },
+    PARAMETRO_NAO_INFORMADO: {
+        title: "Parâmetro não informado.",
+        code: "PARAMETRO_NAO_INFORMADO",
+    },
+    PARAMETRO_INVALIDO: {
+        title: "Parâmetro inválido.",
+        code: "PARAMETRO_INVALIDO",
+    },
+    ERRO_IDEMPOTENCIA: {
+        title: "Erro idempotência.",
+        code: "ERRO_IDEMPOTENCIA",
+    },
+    NAO_INFORMADO: {
+        title: "Não informado.",
+        code: "NAO_INFORMADO",
+    },
+};
+/**
+ * Factory function para criar erros padronizados
+ */
+function createError(code, title, detail) {
+    return {
+        code,
+        title,
+        detail,
+    };
+}
+/**
+ * Mapa de tipos de erros comuns
+ */
+exports.CommonErrors = {
+    PARAMETRO_NAO_INFORMADO: (fieldName) => createError("PARAMETRO_NAO_INFORMADO", "Parâmetro não informado.", `Parâmetro [${fieldName}] obrigatório não informado.`),
+    PARAMETRO_INVALIDO: (fieldName, reason) => createError("PARAMETRO_INVALIDO", "Parâmetro inválido.", `Parâmetro [${fieldName}] não obedece as regras de formatação esperadas. ${reason}`),
+    DETALHE_PAGAMENTO_INVALIDO: (fieldName, reason) => createError("DETALHE_PAGAMENTO_INVALIDO", "Detalhe do pagamento inválido.", `Parâmetro [${fieldName}] não obedece às regras de negócio. ${reason}`),
+    DATA_EXPIRACAO_INVALIDA: () => 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)"),
+    FORMA_PAGAMENTO_INVALIDA: (paymentType) => createError("FORMA_PAGAMENTO_INVALIDA", "Forma de pagamento inválida.", `Forma de pagamento [${paymentType}] não suportada. O tipo de pagamento deve ser PIX.`),
+    DATA_PAGAMENTO_INVALIDA: () => createError("DATA_PAGAMENTO_INVALIDA", "Data de pagamento inválida.", "Data de pagamento inválida para a forma de pagamento selecionada. Deve estar no formato YYYY-MM-DD."),
+    ERRO_NAO_MAPEADO: (reason) => createError("ERRO_NAO_MAPEADO", "Erro não mapeado.", `Erro não mapeado: ${reason}`),
+};
+//# sourceMappingURL=openFinanceErrors.js.map

package/dist/utils/openFinanceErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openFinanceErrors.js","sourceRoot":"","sources":["../../src/utils/openFinanceErrors.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAwEH,kCAUC;AArED;;GAEG;AACU,QAAA,iBAAiB,GAAG;IAC/B,uBAAuB,EAAE;QACvB,KAAK,EAAE,0CAA0C;QACjD,IAAI,EAAE,yBAAyB;KAChC;IACD,6BAA6B,EAAE;QAC7B,KAAK,EAAE,mCAAmC;QAC1C,IAAI,EAAE,+BAA+B;KACtC;IACD,uBAAuB,EAAE;QACvB,KAAK,EAAE,uDAAuD;QAC9D,IAAI,EAAE,yBAAyB;KAChC;IACD,gBAAgB,EAAE;QAChB,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,kBAAkB;KACzB;CACF,CAAC;AAEF;;GAEG;AACU,QAAA,wBAAwB,GAAG;IACtC,wBAAwB,EAAE;QACxB,KAAK,EAAE,8BAA8B;QACrC,IAAI,EAAE,0BAA0B;KACjC;IACD,uBAAuB,EAAE;QACvB,KAAK,EAAE,6BAA6B;QACpC,IAAI,EAAE,yBAAyB;KAChC;IACD,0BAA0B,EAAE;QAC1B,KAAK,EAAE,gCAAgC;QACvC,IAAI,EAAE,4BAA4B;KACnC;IACD,uBAAuB,EAAE;QACvB,KAAK,EAAE,0BAA0B;QACjC,IAAI,EAAE,yBAAyB;KAChC;IACD,kBAAkB,EAAE;QAClB,KAAK,EAAE,qBAAqB;QAC5B,IAAI,EAAE,oBAAoB;KAC3B;IACD,iBAAiB,EAAE;QACjB,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,mBAAmB;KAC1B;IACD,aAAa,EAAE;QACb,KAAK,EAAE,gBAAgB;QACvB,IAAI,EAAE,eAAe;KACtB;CACF,CAAC;AAEF;;GAEG;AACH,SAAgB,WAAW,CACzB,IAAY,EACZ,KAAa,EACb,MAAc;IAEd,OAAO;QACL,IAAI;QACJ,KAAK;QACL,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;GAEG;AACU,QAAA,YAAY,GAAG;IAC1B,uBAAuB,EAAE,CAAC,SAAiB,EAAE,EAAE,CAC7C,WAAW,CACT,yBAAyB,EACzB,0BAA0B,EAC1B,cAAc,SAAS,8BAA8B,CACtD;IAEH,kBAAkB,EAAE,CAAC,SAAiB,EAAE,MAAc,EAAE,EAAE,CACxD,WAAW,CACT,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,SAAS,oDAAoD,MAAM,EAAE,CACpF;IAEH,0BAA0B,EAAE,CAAC,SAAiB,EAAE,MAAc,EAAE,EAAE,CAChE,WAAW,CACT,4BAA4B,EAC5B,gCAAgC,EAChC,cAAc,SAAS,uCAAuC,MAAM,EAAE,CACvE;IAEH,uBAAuB,EAAE,GAAG,EAAE,CAC5B,WAAW,CACT,yBAAyB,EACzB,uDAAuD,EACvD,4FAA4F,CAC7F;IAEH,wBAAwB,EAAE,CAAC,WAAmB,EAAE,EAAE,CAChD,WAAW,CACT,0BAA0B,EAC1B,8BAA8B,EAC9B,uBAAuB,WAAW,oDAAoD,CACvF;IAEH,uBAAuB,EAAE,GAAG,EAAE,CAC5B,WAAW,CACT,yBAAyB,EACzB,6BAA6B,EAC7B,qGAAqG,CACtG;IAEH,gBAAgB,EAAE,CAAC,MAAc,EAAE,EAAE,CACnC,WAAW,CACT,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,MAAM,EAAE,CAC9B;CACJ,CAAC"}

package/dist/utils/paymentErrors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Erros específicos para validação de Payment Consent
+ */
+export declare const PaymentErrors: {
+    FORMA_PAGAMENTO_INVALIDA: (paymentType: string) => import("./openFinanceErrors").ErrorDetail;
+    DATA_PAGAMENTO_INVALIDA: () => import("./openFinanceErrors").ErrorDetail;
+    DETALHE_PAGAMENTO_INVALIDO: (fieldName: string, reason: string) => import("./openFinanceErrors").ErrorDetail;
+};
+//# sourceMappingURL=paymentErrors.d.ts.map

package/dist/utils/paymentErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymentErrors.d.ts","sourceRoot":"","sources":["../../src/utils/paymentErrors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,aAAa;4CACgB,MAAM;;4CAcN,MAAM,UAAU,MAAM;CAM/D,CAAC"}

package/dist/utils/paymentErrors.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Erros específicos para validação de Payment Consent
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentErrors = void 0;
+const openFinanceErrors_1 = require("./openFinanceErrors");
+exports.PaymentErrors = {
+    FORMA_PAGAMENTO_INVALIDA: (paymentType) => (0, openFinanceErrors_1.createError)("FORMA_PAGAMENTO_INVALIDA", "Forma de pagamento inválida.", `Forma de pagamento [${paymentType}] não suportada. O tipo de pagamento deve ser PIX.`),
+    DATA_PAGAMENTO_INVALIDA: () => (0, openFinanceErrors_1.createError)("DATA_PAGAMENTO_INVALIDA", "Data de pagamento inválida.", "Data de pagamento inválida para a forma de pagamento selecionada. Deve estar no formato YYYY-MM-DD."),
+    DETALHE_PAGAMENTO_INVALIDO: (fieldName, reason) => (0, openFinanceErrors_1.createError)("DETALHE_PAGAMENTO_INVALIDO", "Detalhe do pagamento inválido.", `Parâmetro [${fieldName}] não obedece às regras de negócio. ${reason}`),
+};
+//# sourceMappingURL=paymentErrors.js.map

package/dist/utils/paymentErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymentErrors.js","sourceRoot":"","sources":["../../src/utils/paymentErrors.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,2DAAkD;AAErC,QAAA,aAAa,GAAG;IAC3B,wBAAwB,EAAE,CAAC,WAAmB,EAAE,EAAE,CAChD,IAAA,+BAAW,EACT,0BAA0B,EAC1B,8BAA8B,EAC9B,uBAAuB,WAAW,oDAAoD,CACvF;IAEH,uBAAuB,EAAE,GAAG,EAAE,CAC5B,IAAA,+BAAW,EACT,yBAAyB,EACzB,6BAA6B,EAC7B,qGAAqG,CACtG;IAEH,0BAA0B,EAAE,CAAC,SAAiB,EAAE,MAAc,EAAE,EAAE,CAChE,IAAA,+BAAW,EACT,4BAA4B,EAC5B,gCAAgC,EAChC,cAAc,SAAS,uCAAuC,MAAM,EAAE,CACvE;CACJ,CAAC"}

package/dist/utils/successResponses.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Interfaces genéricas de Sucesso para respostas da Open Finance Brasil
+ */
+/**
+ * Interface genérica de sucesso para qualquer resposta
+ */
+export interface SuccessResponse<T> {
+    data: T;
+    links?: {
+        self: string;
+        first?: string;
+        prev?: string;
+        next?: string;
+        last?: string;
+    };
+    meta?: {
+        totalRecords?: number;
+        totalPages?: number;
+        requestDateTime: string;
+    };
+}
+/**
+ * Resposta de sucesso genérica com dados de paginação
+ */
+export interface PaginatedSuccessResponse<T> {
+    data: T[];
+    links?: {
+        self: string;
+        first: string;
+        prev?: string;
+        next?: string;
+        last: string;
+    };
+    meta: {
+        totalRecords: number;
+        totalPages: number;
+        requestDateTime: string;
+    };
+}
+/**
+ * Resposta de sucesso genérica simples
+ */
+export interface SimpleSuccessResponse<T> {
+    data: T;
+    links?: {
+        self: string;
+    };
+    meta?: {
+        requestDateTime: string;
+    };
+}
+//# sourceMappingURL=successResponses.d.ts.map

package/dist/utils/successResponses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"successResponses.d.ts","sourceRoot":"","sources":["../../src/utils/successResponses.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC;IACR,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,wBAAwB,CAAC,CAAC;IACzC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,IAAI,EAAE;QACJ,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,IAAI,CAAC,EAAE;QACL,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH"}

package/dist/utils/successResponses.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Interfaces genéricas de Sucesso para respostas da Open Finance Brasil
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=successResponses.js.map

package/dist/utils/successResponses.js.map

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

package/dist/utils/validateHeaderParameters.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Validador de Headers de Requisição HTTP
+ * Valida headers enviados no request contra regras de Open Finance Brasil
+ */
+import { ErrorDetail } from "./openFinanceErrors";
+interface HeaderValidationRule {
+    name: string;
+    headerName: string;
+    required: boolean;
+    pattern?: string;
+    minLength?: number;
+    maxLength?: number;
+    format?: string;
+}
+/**
+ * Regras de validação para headers de Open Finance Brasil
+ */
+declare const HEADER_VALIDATION_RULES: HeaderValidationRule[];
+/**
+ * Valida todos os headers de uma requisição
+ */
+export declare function validateHeaders(headers: Record<string, string | string[] | undefined>): {
+    isValid: boolean;
+    errors: ErrorDetail[];
+};
+/**
+ * Valida um header específico
+ * @param headerName - Nome do header (ex: 'x-fapi-interaction-id')
+ * @param headerValue - Valor do header
+ * @param required - Se verdadeiro, força o header como obrigatório; se falso, força como opcional; se undefined, usa a regra padrão
+ */
+export declare function validateHeader(headerName: string, headerValue: any, required?: boolean): {
+    isValid: boolean;
+    errors: ErrorDetail[];
+};
+/**
+ * Valida um header como obrigatório
+ */
+export declare function validateHeaderRequired(headerName: string, headerValue: any): {
+    isValid: boolean;
+    errors: ErrorDetail[];
+};
+/**
+ * Valida um header como opcional
+ */
+export declare function validateHeaderOptional(headerName: string, headerValue: any): {
+    isValid: boolean;
+    errors: ErrorDetail[];
+};
+export { HEADER_VALIDATION_RULES, HeaderValidationRule };
+//# sourceMappingURL=validateHeaderParameters.d.ts.map

package/dist/utils/validateHeaderParameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateHeaderParameters.d.ts","sourceRoot":"","sources":["../../src/utils/validateHeaderParameters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAgB,MAAM,qBAAqB,CAAC;AAEhE,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,QAAA,MAAM,uBAAuB,EAAE,oBAAoB,EA6ClD,CAAC;AAiEF;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAa7C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,GAAG,EAChB,QAAQ,CAAC,EAAE,OAAO,GACjB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAkB7C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,GAAG,GACf;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAE7C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,GAAG,GACf;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAE7C;AAED,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/utils/validateHeaderParameters.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Validador de Headers de Requisição HTTP
+ * Valida headers enviados no request contra regras de Open Finance Brasil
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HEADER_VALIDATION_RULES = void 0;
+exports.validateHeaders = validateHeaders;
+exports.validateHeader = validateHeader;
+exports.validateHeaderRequired = validateHeaderRequired;
+exports.validateHeaderOptional = validateHeaderOptional;
+const openFinanceErrors_1 = require("./openFinanceErrors");
+/**
+ * Regras de validação para headers de Open Finance Brasil
+ */
+const HEADER_VALIDATION_RULES = [
+    {
+        name: 'xFapiInteractionId',
+        headerName: 'x-fapi-interaction-id',
+        required: true,
+        pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$',
+        minLength: 36,
+        maxLength: 36,
+        format: 'uuid',
+    },
+    {
+        name: 'XIdempotencyKey',
+        headerName: 'X-Idempotency-Key',
+        required: false,
+        maxLength: 36,
+    },
+    {
+        name: 'xFapiAuthDate',
+        headerName: 'x-fapi-auth-date',
+        required: false,
+        pattern: '^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), \\d{2} (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) \\d{4} \\d{2}:\\d{2}:\\d{2} (GMT|UTC)$',
+        minLength: 29,
+        maxLength: 29,
+    },
+    {
+        name: 'xFapiCustomerIpAddress',
+        headerName: 'x-fapi-customer-ip-address',
+        required: false,
+        maxLength: 100,
+    },
+    {
+        name: 'xCustomerUserAgent',
+        headerName: 'x-customer-user-agent',
+        required: false,
+        pattern: '^[^\\s](.*[^\\s])?$',
+        minLength: 1,
+        maxLength: 255,
+    },
+    {
+        name: 'Authorization',
+        headerName: 'Authorization',
+        required: true,
+        minLength: 1,
+        maxLength: 2048,
+    },
+];
+exports.HEADER_VALIDATION_RULES = HEADER_VALIDATION_RULES;
+/**
+ * Valida um header específico com opção de customizar obrigatoriedade
+ */
+function validateSingleHeader(headerValue, rule, options) {
+    const errors = [];
+    // Usar requiredOverride se fornecido, caso contrário usar a regra padrão
+    const isRequired = options?.requiredOverride !== undefined ? options.requiredOverride : rule.required;
+    // Verificar se é obrigatório
+    if (isRequired && (!headerValue || headerValue.trim() === '')) {
+        return [
+            openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO(rule.headerName, `Header ${rule.headerName} é obrigatório`),
+        ];
+    }
+    // Se não é obrigatório e não foi enviado, é válido
+    if (!isRequired && (!headerValue || headerValue.trim() === '')) {
+        return [];
+    }
+    const value = String(headerValue).trim();
+    // Validar tamanho mínimo
+    if (rule.minLength && value.length < rule.minLength) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO(rule.headerName, `Deve ter no mínimo ${rule.minLength} caracteres (${value.length})`));
+    }
+    // Validar tamanho máximo
+    if (rule.maxLength && value.length > rule.maxLength) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO(rule.headerName, `Deve ter no máximo ${rule.maxLength} caracteres (${value.length})`));
+    }
+    // Validar padrão (regex)
+    if (rule.pattern && !new RegExp(rule.pattern).test(value)) {
+        errors.push(openFinanceErrors_1.CommonErrors.PARAMETRO_INVALIDO(rule.headerName, `Formato inválido (esperado: ${rule.pattern})`));
+    }
+    return errors;
+}
+/**
+ * Valida todos os headers de uma requisição
+ */
+function validateHeaders(headers) {
+    const errors = [];
+    HEADER_VALIDATION_RULES.forEach((rule) => {
+        const headerValue = headers[rule.headerName];
+        const headerErrors = validateSingleHeader(headerValue, rule);
+        errors.push(...headerErrors);
+    });
+    return {
+        isValid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Valida um header específico
+ * @param headerName - Nome do header (ex: 'x-fapi-interaction-id')
+ * @param headerValue - Valor do header
+ * @param required - Se verdadeiro, força o header como obrigatório; se falso, força como opcional; se undefined, usa a regra padrão
+ */
+function validateHeader(headerName, headerValue, required) {
+    const rule = HEADER_VALIDATION_RULES.find((r) => r.headerName.toLowerCase() === headerName.toLowerCase());
+    if (!rule) {
+        return {
+            isValid: true,
+            errors: [],
+        };
+    }
+    const errors = validateSingleHeader(headerValue, rule, { requiredOverride: required });
+    return {
+        isValid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Valida um header como obrigatório
+ */
+function validateHeaderRequired(headerName, headerValue) {
+    return validateHeader(headerName, headerValue, true);
+}
+/**
+ * Valida um header como opcional
+ */
+function validateHeaderOptional(headerName, headerValue) {
+    return validateHeader(headerName, headerValue, false);
+}
+//# sourceMappingURL=validateHeaderParameters.js.map

package/dist/utils/validateHeaderParameters.js.map

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

package/dist/utils/validationHelpers.d.ts

@@ -0,0 +1,89 @@
+import { ErrorDetail } from "./openFinanceErrors";
+/**
+ * Validadores compartilhados para reutilização em todos os validadores
+ */
+/**
+ * Valida CPF (11 dígitos)
+ */
+export declare function validateCPF(cpf: any, fieldName?: string): ErrorDetail[];
+/**
+ * Valida CNPJ (14 caracteres alfanuméricos)
+ */
+export declare function validateCNPJ(cnpj: any, fieldName?: string): ErrorDetail[];
+/**
+ * Valida documento (CPF ou CNPJ)
+ */
+export declare function validateDocumentIdentification(identification: any, fieldName?: string): ErrorDetail[];
+/**
+ * Valida tipo de documento (CPF ou CNPJ)
+ */
+export declare function validateDocumentType(rel: any, fieldName?: string, allowedTypes?: string[]): ErrorDetail[];
+/**
+ * Valida data no formato YYYY-MM-DD
+ */
+export declare function validateDate(date: any, fieldName?: string): ErrorDetail[];
+/**
+ * Valida data/hora no formato RFC-3339 (YYYY-MM-DDTHH:mm:ssZ)
+ */
+export declare function validateDateTime(dateTime: any, fieldName?: string, maxLength?: number): ErrorDetail[];
+/**
+ * Valida hora especificada (formato HH:mm:ss)
+ */
+export declare function validateTimeFormat(time: string, expectedHour: number, expectedMinute: number, expectedSecond: number, fieldName?: string): boolean;
+/**
+ * Valida amount (formato monetário: \d{1,16}\.\d{2})
+ */
+export declare function validateAmount(amount: any, fieldName?: string, maxLength?: number): ErrorDetail[];
+/**
+ * Valida moeda (deve ser BRL)
+ */
+export declare function validateCurrency(currency: any, fieldName?: string): ErrorDetail[];
+/**
+ * Valida ISPB (8 caracteres)
+ */
+export declare function validateISPB(ispb: any, fieldName?: string): ErrorDetail[];
+/**
+ * Valida número de conta (1-20 dígitos)
+ */
+export declare function validateAccountNumber(number: any, fieldName?: string): ErrorDetail[];
+/**
+ * Valida issuer/agência (1-4 dígitos)
+ */
+export declare function validateIssuer(issuer: any, fieldName?: string): ErrorDetail[];
+/**
+ * Valida tipo de conta
+ */
+export declare function validateAccountType(accountType: any, fieldName?: string, validTypes?: string[]): ErrorDetail[];
+/**
+ * Valida string contra enum
+ */
+export declare function validateEnum(value: any, validValues: string[], fieldName: string): ErrorDetail[];
+/**
+ * Valida offset de timezone (±hh:mm ou ±hh)
+ */
+export declare function validateTimeZoneOffset(offset: any, fieldName?: string): ErrorDetail[];
+/**
+ * Valida dimensões de tela (height e width inteiros)
+ */
+export declare function validateScreenDimensions(dimensions: any, fieldName?: string): ErrorDetail[];
+/**
+ * Valida string com tamanho máximo
+ */
+export declare function validateString(value: any, fieldName: string, maxLength?: number, minLength?: number): ErrorDetail[];
+/**
+ * Valida EndToEndId no formato Pix (32 caracteres)
+ */
+export declare function validateEndToEndId(endToEndId: any, fieldName?: string, exact32?: boolean): ErrorDetail[];
+/**
+ * Valida transactionIdentification (1-35 caracteres alfanuméricos)
+ */
+export declare function validateTransactionIdentification(transId: any, fieldName?: string): ErrorDetail[];
+/**
+ * Valida que um objeto é do tipo correto
+ */
+export declare function validateObjectType(value: any, fieldName: string): ErrorDetail[];
+/**
+ * Exportação da função de validação de headers de requisição
+ */
+export { validateHeaders, validateHeader, validateHeaderRequired, validateHeaderOptional, HEADER_VALIDATION_RULES } from './validateHeaderParameters';
+//# sourceMappingURL=validationHelpers.d.ts.map

package/dist/utils/validationHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/validationHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,qBAAqB,CAAC;AAEhE;;GAEG;AAEH;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,GAAE,MAAc,GAAG,WAAW,EAAE,CAuB9E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,GAAE,MAAe,GAAG,WAAW,EAAE,CAuBjF;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,cAAc,EAAE,GAAG,EACnB,SAAS,GAAE,MAAyB,GACnC,WAAW,EAAE,CAuBf;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,GAAG,EACR,SAAS,GAAE,MAAc,EACzB,YAAY,GAAE,MAAM,EAAoB,GACvC,WAAW,EAAE,CAoBf;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,GAAG,EACT,SAAS,GAAE,MAAe,GACzB,WAAW,EAAE,CAsBf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,GAAG,EACb,SAAS,GAAE,MAAmB,EAC9B,SAAS,GAAE,MAAW,GACrB,WAAW,EAAE,CA+Bf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,SAAS,GAAE,MAAe,GACzB,OAAO,CAST;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,GAAG,EACX,SAAS,GAAE,MAAiB,EAC5B,SAAS,GAAE,MAAW,GACrB,WAAW,EAAE,CA2Bf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,GAAG,EACb,SAAS,GAAE,MAAmB,GAC7B,WAAW,EAAE,CAyBf;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,GAAG,EACT,SAAS,GAAE,MAAe,GACzB,WAAW,EAAE,CA8Bf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,GAAG,EACX,SAAS,GAAE,MAAiB,GAC3B,WAAW,EAAE,CA2Bf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,GAAG,EACX,SAAS,GAAE,MAAiB,GAC3B,WAAW,EAAE,CA2Bf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,GAAG,EAChB,SAAS,GAAE,MAAsB,EACjC,UAAU,GAAE,MAAM,EAA6B,GAC9C,WAAW,EAAE,CAoBf;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,GAAG,EACV,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,EAAE,MAAM,GAChB,WAAW,EAAE,CAoBf;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,GAAG,EACX,SAAS,GAAE,MAA6B,GACvC,WAAW,EAAE,CAkBf;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,GAAG,EACf,SAAS,GAAE,MAA2B,GACrC,WAAW,EAAE,CAqCf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,GAAE,MAAU,GACpB,WAAW,EAAE,CA6Bf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,GAAG,EACf,SAAS,GAAE,MAAqB,EAChC,OAAO,GAAE,OAAc,GACtB,WAAW,EAAE,CAoDf;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,GAAG,EACZ,SAAS,GAAE,MAAoC,GAC9C,WAAW,EAAE,CA8Bf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,MAAM,GAChB,WAAW,EAAE,CAUf;AAED;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC"}