opf-validator-beta 0.0.13

package/dist/utils/openFinanceErrors.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Padrão de Erros do Open Finance Brasil
+ * Seguindo a especificação da API de Consentimentos
+ */
+export interface ErrorDetail {
+    code: string;
+    title: string;
+    detail: string;
+}
+export interface ValidationResult {
+    isValid: boolean;
+    statusCode: number;
+    errors: ErrorDetail[];
+}
+/**
+ * Códigos de erro para CreateConsent e CreateConsentExtensions
+ */
+export declare const ConsentErrorCodes: {
+    DEPENDE_MULTIPLA_ALCADA: {
+        title: string;
+        code: string;
+    };
+    ESTADO_CONSENTIMENTO_INVALIDO: {
+        title: string;
+        code: string;
+    };
+    DATA_EXPIRACAO_INVALIDA: {
+        title: string;
+        code: string;
+    };
+    ERRO_NAO_MAPEADO: {
+        title: string;
+        code: string;
+    };
+};
+/**
+ * Códigos de erro para CreatePaymentConsent
+ */
+export declare const PaymentConsentErrorCodes: {
+    FORMA_PAGAMENTO_INVALIDA: {
+        title: string;
+        code: string;
+    };
+    DATA_PAGAMENTO_INVALIDA: {
+        title: string;
+        code: string;
+    };
+    DETALHE_PAGAMENTO_INVALIDO: {
+        title: string;
+        code: string;
+    };
+    PARAMETRO_NAO_INFORMADO: {
+        title: string;
+        code: string;
+    };
+    PARAMETRO_INVALIDO: {
+        title: string;
+        code: string;
+    };
+    ERRO_IDEMPOTENCIA: {
+        title: string;
+        code: string;
+    };
+    NAO_INFORMADO: {
+        title: string;
+        code: string;
+    };
+};
+/**
+ * Factory function para criar erros padronizados
+ */
+export declare function createError(code: string, title: string, detail: string): ErrorDetail;
+/**
+ * Determina o status code baseado nos códigos de erro
+ * Segue a especificação Open Finance Brasil
+ */
+export declare function getStatusCode(errors: ErrorDetail[]): number;
+/**
+ * Mapa de tipos de erros comuns
+ */
+export declare const CommonErrors: {
+    PARAMETRO_NAO_INFORMADO: (fieldName: string) => ErrorDetail;
+    PARAMETRO_INVALIDO: (fieldName: string, reason: string) => ErrorDetail;
+    DETALHE_PAGAMENTO_INVALIDO: (fieldName: string, reason: string) => ErrorDetail;
+    DATA_EXPIRACAO_INVALIDA: () => ErrorDetail;
+    FORMA_PAGAMENTO_INVALIDA: (paymentType: string) => ErrorDetail;
+    DATA_PAGAMENTO_INVALIDA: () => ErrorDetail;
+    ERRO_NAO_MAPEADO: (reason: string) => ErrorDetail;
+};
+//# sourceMappingURL=openFinanceErrors.d.ts.map

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,UAAU,EAAE,MAAM,CAAC;IACnB,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;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CA0B3D;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,114 @@
+"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;
+exports.getStatusCode = getStatusCode;
+/**
+ * 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,
+    };
+}
+/**
+ * Determina o status code baseado nos códigos de erro
+ * Segue a especificação Open Finance Brasil
+ */
+function getStatusCode(errors) {
+    if (errors.length === 0)
+        return 201;
+    const errorCodes = errors.map(e => e.code);
+    // 422: Unprocessable Entity - erros sintáticos e semânticos previstos
+    const unprocessableErrorCodes = [
+        'PARAMETRO_INVALIDO',
+        'PARAMETRO_NAO_INFORMADO',
+        'DETALHE_PAGAMENTO_INVALIDO',
+        'DATA_EXPIRACAO_INVALIDA',
+        'DATA_PAGAMENTO_INVALIDA',
+        'FORMA_PAGAMENTO_INVALIDA',
+        'DEPENDE_MULTIPLA_ALCADA',
+        'ESTADO_CONSENTIMENTO_INVALIDO',
+        'ERRO_IDEMPOTENCIA',
+        'FORA_PRAZO_PERMITIDO',
+        'NAO_INFORMADO',
+    ];
+    if (errorCodes.some(code => unprocessableErrorCodes.includes(code))) {
+        return 422;
+    }
+    // 400: Bad Request - erros gerais
+    return 400;
+}
+/**
+ * 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":"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"}

package/dist/utils/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "opf-validator-utils",
+  "private": true,
+  "main": "index.js",
+  "types": "index.d.ts"
+}

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 (SEM fapi-interaction-id obrigatório)
+ */
+declare const HEADER_VALIDATION_RULES: HeaderValidationRule[];
+/**
+ * Regras de validação para headers de Open Finance Brasil (COM fapi-interaction-id obrigatório)
+ */
+declare const HEADER_VALIDATION_RULES_WITH_FAPIINTERACTION_ID: HeaderValidationRule[];
+/**
+ * Valida todos os headers de uma requisição (SEM exigir fapi-interaction-id)
+ */
+export declare function validateHeaders(headers: Record<string, string | string[] | undefined>): {
+    isValid: boolean;
+    statusCode: number;
+    errors: ErrorDetail[];
+};
+/**
+ * Valida todos os headers de uma requisição (COM fapi-interaction-id obrigatório)
+ */
+export declare function validateHeadersWithFapiRequired(headers: Record<string, string | string[] | undefined>): {
+    isValid: boolean;
+    statusCode: number;
+    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): {
+    isValid: boolean;
+    statusCode: number;
+    errors: ErrorDetail[];
+};
+export { HEADER_VALIDATION_RULES, HEADER_VALIDATION_RULES_WITH_FAPIINTERACTION_ID, 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;AAGhE,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;AAEF;;GAEG;AACH,QAAA,MAAM,+CAA+C,EAAE,oBAAoB,EA6C1E,CAAC;AA0DF;;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,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAcjE;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAcjE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,GAAG,GACf;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAoBjE;AAGD,OAAO,EAAE,uBAAuB,EAAE,+CAA+C,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/utils/validateHeaderParameters.js

@@ -0,0 +1,197 @@
+"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_WITH_FAPIINTERACTION_ID = exports.HEADER_VALIDATION_RULES = void 0;
+exports.validateHeaders = validateHeaders;
+exports.validateHeadersWithFapiRequired = validateHeadersWithFapiRequired;
+exports.validateHeader = validateHeader;
+const openFinanceErrors_1 = require("./openFinanceErrors");
+const openFinanceErrors_2 = require("./openFinanceErrors");
+/**
+ * Regras de validação para headers de Open Finance Brasil (SEM fapi-interaction-id obrigatório)
+ */
+const HEADER_VALIDATION_RULES = [
+    {
+        name: 'xFapiInteractionId',
+        headerName: 'x-fapi-interaction-id',
+        required: false,
+        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;
+/**
+ * Regras de validação para headers de Open Finance Brasil (COM fapi-interaction-id obrigatório)
+ */
+const HEADER_VALIDATION_RULES_WITH_FAPIINTERACTION_ID = [
+    {
+        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_WITH_FAPIINTERACTION_ID = HEADER_VALIDATION_RULES_WITH_FAPIINTERACTION_ID;
+/**
+ * Valida um header específico com opção de customizar obrigatoriedade
+ */
+function validateSingleHeader(headerValue, rule) {
+    const errors = [];
+    // Verificar se é obrigatório
+    if (rule.required && (!headerValue || String(headerValue).trim() === '')) {
+        return [
+            openFinanceErrors_1.CommonErrors.PARAMETRO_NAO_INFORMADO(rule.headerName),
+        ];
+    }
+    // Se não é obrigatório e não foi enviado, é válido
+    if (!headerValue || String(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.format || rule.pattern})`));
+    }
+    return errors;
+}
+/**
+ * Valida todos os headers de uma requisição (SEM exigir fapi-interaction-id)
+ */
+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,
+        statusCode: (0, openFinanceErrors_2.getStatusCode)(errors),
+        errors,
+    };
+}
+/**
+ * Valida todos os headers de uma requisição (COM fapi-interaction-id obrigatório)
+ */
+function validateHeadersWithFapiRequired(headers) {
+    const errors = [];
+    HEADER_VALIDATION_RULES_WITH_FAPIINTERACTION_ID.forEach((rule) => {
+        const headerValue = headers[rule.headerName];
+        const headerErrors = validateSingleHeader(headerValue, rule);
+        errors.push(...headerErrors);
+    });
+    return {
+        isValid: errors.length === 0,
+        statusCode: (0, openFinanceErrors_2.getStatusCode)(errors),
+        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) {
+    const rule = HEADER_VALIDATION_RULES.find((r) => r.headerName.toLowerCase() === headerName.toLowerCase());
+    if (!rule) {
+        return {
+            isValid: true,
+            statusCode: 201,
+            errors: [],
+        };
+    }
+    const errors = validateSingleHeader(headerValue, rule);
+    return {
+        isValid: errors.length === 0,
+        statusCode: (0, openFinanceErrors_2.getStatusCode)(errors),
+        errors,
+    };
+}
+//# 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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"}