@linkiez/boleto-sdk 1.0.0 → 1.1.2

package/README.md

@@ -1,168 +1,185 @@
-# 🎫 BoletoSDK
-
-Brazilian bank slip (boleto) & CNAB processing library with type safety, validation, and ready-to-render assets.
-
-[![npm version](https://badge.fury.io/js/@linkiez%2Fboleto-sdk.svg)](https://www.npmjs.com/package/@linkiez/boleto-sdk)
-[![CI](https://github.com/linkiez/BoletoSDK/workflows/CI/badge.svg)](https://github.com/linkiez/BoletoSDK/actions)
-[![Coverage](https://img.shields.io/codecov/c/github/linkiez/BoletoSDK)](https://codecov.io/gh/linkiez/BoletoSDK)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)](https://www.typescriptlang.org/)
-
-Parse, generate, and validate CNAB 240/400 files with consistent APIs.
-
-## 🌟 Highlights
-
-- CNAB 240/400 parsing, generation, and validation
-- Boleto assets: barcode, PIX QR, HTML/PDF (pt-BR labels)
-- Bank constants, layout validation, and robust tests
-
-## 🧾 Boleto Generation
-
-```typescript
-import {
-  buildBoletoHtml,
-  generateBarcode,
-  generateBoletoEmail,
-  generateBoletoPdfBuffer,
-  generatePixQRCode,
-} from '@linkiez/boleto-sdk';
-
-const barcode = generateBarcode({
-  bankCode: '341',
-  currencyCode: '9',
-  dueDate: new Date('2026-02-28'),
-  amount: 150.5,
-  freeField: '1234567890123456789012345',
-});
-
-const pix = generatePixQRCode({
-  key: '12345678000195',
-  amount: 150.5,
-  merchantName: 'ACME CORP',
-  merchantCity: 'SAO PAULO',
-  transactionId: 'INV001',
-});
-
-const boletoData = {
-  beneficiary: {
-    name: 'ACME CORP',
-    document: '12345678000195',
-    address: 'Avenida 1, 1000',
-  },
-  payer: {
-    name: 'Joao da Silva',
-    document: '12345678901',
-    address: 'Rua 2, 200',
-  },
-  payment: {
-    documentNumber: 'DOC-001',
-    ourNumber: '12345678',
-    amount: 150.5,
-    dueDate: new Date('2026-02-28'),
-    barcode: barcode.barcode,
-    digitableLine: barcode.digitableLine,
-    pix: { payload: pix.payload },
-  },
-  bank: { code: '341', name: 'ITAU UNIBANCO SA' },
-};
-
-const html = buildBoletoHtml(boletoData, { layout: 'detailed' });
-const pdf = await generateBoletoPdfBuffer(boletoData, { includePixQr: true });
-```
-
-## 🚀 Quick Start
-
-```bash
-npm install @linkiez/boleto-sdk
-```
-
-```typescript
-import { parseCnab, generateCnab } from '@linkiez/boleto-sdk';
-
-const parsed = parseCnab(content);
-const output = generateCnab(parsed);
-```
-
-```typescript
-import {
-  generateBarcode,
-  generatePixQRCode,
-  generateBoletoPdfBuffer,
-} from '@linkiez/boleto-sdk';
-
-const { barcode, digitableLine } = generateBarcode({
-  bankCode: '341',
-  dueDate: new Date('2025-02-10'),
-  amount: 150.5,
-  freeField: '1234567890123456789012345',
-});
-
-const pix = generatePixQRCode({
-  key: '12345678000195',
-  amount: 150.5,
-  merchantName: 'ACME CORP',
-  merchantCity: 'SAO PAULO',
-  transactionId: 'INV001',
-});
-
-const pdf = await generateBoletoPdfBuffer({
-  beneficiary: { name: 'ACME CORP', document: '12345678000195', address: 'Avenida 1' },
-  payer: { name: 'Joao da Silva', document: '12345678901', address: 'Rua 2' },
-  payment: {
-    documentNumber: 'DOC-001',
-    ourNumber: '12345678',
-    amount: 150.5,
-    dueDate: new Date('2025-02-10'),
-    barcode,
-    digitableLine,
-    pix: { payload: pix.payload },
-  },
-  bank: { code: '341', name: 'ITAU UNIBANCO SA' },
-});
-```
-
-## 📚 Documentation
-
-### Core
-
-- [API Reference](doc/API-REFERENCE.md)
-- [CNAB240 Guide](doc/CNAB240_GUIDE.md)
-- [CNAB400 Usage Guide](doc/CNAB400-USAGE-GUIDE.md)
-- [Boleto Generation Guide](doc/BOLETO-GENERATION.md)
-- [Examples](doc/EXAMPLES.md)
-
-### Specs and Validation
-
-- [CNAB240 FEBRABAN Spec](doc/CNAB240-FEBRABAN.md)
-- [CNAB400 Positions Validation](doc/CNAB400_POSITIONS_VALIDATION.md)
-- [Segment Positions Validation](doc/SEGMENT_POSITIONS_VALIDATION.md)
-- [Business Rules](doc/BUSINESS_RULES.md)
-- [Business Rules Sources](doc/BUSINESS_RULES_SOURCES.md)
-
-### Supporting Docs
-
-- [Bank Differences](doc/BANK_DIFFERENCES.md)
-- [FAQ](doc/FAQ.md)
-- [Migration](doc/MIGRATION.md)
-- [SonarQube](doc/SONARQUBE.md)
-- [CNAB400 Bank Samples](doc)
-
-### Project
-
-- [Architecture](ARCHITECTURE.md)
-- [Testing](TESTING.md)
-- [Contributing](CONTRIBUTING.md)
-- [Roadmap](ROADMAP.md)
-
-## 🛠️ Development
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) and [TESTING.md](TESTING.md) for setup, workflows, and conventions.
-
-## 📜 License
-
-APACHE. See [LICENSE](LICENSE).
-
-## 🔗 Links
-
-- [NPM Package](https://www.npmjs.com/package/@linkiez/boleto-sdk)
-- [Report Issues](https://github.com/linkiez/BoletoSDK/issues)
+# 🎫 BoletoSDK
+
+Brazilian bank slip (boleto) & CNAB processing library with type safety, validation, and ready-to-render assets.
+
+[![npm version](https://badge.fury.io/js/@linkiez%2Fboleto-sdk.svg)](https://www.npmjs.com/package/@linkiez/boleto-sdk)
+[![GitHub release](https://img.shields.io/github/v/release/linkiez/BoletoSDK)](https://github.com/linkiez/BoletoSDK/releases)
+[![CI](https://github.com/linkiez/BoletoSDK/workflows/CI/badge.svg)](https://github.com/linkiez/BoletoSDK/actions)
+[![Coverage](https://img.shields.io/codecov/c/github/linkiez/BoletoSDK)](https://codecov.io/gh/linkiez/BoletoSDK)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)](https://www.typescriptlang.org/)
+
+Parse, generate, and validate CNAB 240/400 files with consistent APIs.
+
+## 🌟 Highlights
+
+- CNAB 240/400 parsing, generation, and validation
+- Boleto assets: barcode, PIX QR, HTML/PDF (pt-BR labels)
+- Bank constants, layout validation, and robust tests
+
+## 🧾 Boleto Generation
+
+```typescript
+import {
+  buildBoletoHtml,
+  generateBarcode,
+  generateBoletoEmail,
+  generateBoletoPdfBuffer,
+  generatePixQRCode,
+} from '@linkiez/boleto-sdk';
+
+const barcode = generateBarcode({
+  bankCode: '341',
+  currencyCode: '9',
+  dueDate: new Date('2026-02-28'),
+  amount: 150.5,
+  freeField: '1234567890123456789012345',
+});
+
+const pix = generatePixQRCode({
+  key: '12345678000195',
+  amount: 150.5,
+  merchantName: 'ACME CORP',
+  merchantCity: 'SAO PAULO',
+  transactionId: 'INV001',
+});
+
+const boletoData = {
+  beneficiary: {
+    name: 'ACME CORP',
+    document: '12345678000195',
+    address: 'Avenida 1, 1000',
+  },
+  payer: {
+    name: 'Joao da Silva',
+    document: '12345678901',
+    address: 'Rua 2, 200',
+  },
+  payment: {
+    documentNumber: 'DOC-001',
+    ourNumber: '12345678',
+    amount: 150.5,
+    dueDate: new Date('2026-02-28'),
+    barcode: barcode.barcode,
+    digitableLine: barcode.digitableLine,
+    pix: { payload: pix.payload },
+  },
+  bank: { code: '341', name: 'ITAU UNIBANCO SA' },
+};
+
+const html = buildBoletoHtml(boletoData, { layout: 'detailed' });
+const pdf = await generateBoletoPdfBuffer(boletoData, { includePixQr: true });
+```
+
+## 🚀 Quick Start
+
+```bash
+npm install @linkiez/boleto-sdk
+```
+
+```typescript
+import { parseCnab, generateCnab } from '@linkiez/boleto-sdk';
+
+const parsed = parseCnab(content);
+const output = generateCnab(parsed);
+```
+
+```typescript
+import {
+  generateBarcode,
+  generatePixQRCode,
+  generateBoletoPdfBuffer,
+} from '@linkiez/boleto-sdk';
+
+const { barcode, digitableLine } = generateBarcode({
+  bankCode: '341',
+  dueDate: new Date('2025-02-10'),
+  amount: 150.5,
+  freeField: '1234567890123456789012345',
+});
+
+const pix = generatePixQRCode({
+  key: '12345678000195',
+  amount: 150.5,
+  merchantName: 'ACME CORP',
+  merchantCity: 'SAO PAULO',
+  transactionId: 'INV001',
+});
+
+const pdf = await generateBoletoPdfBuffer({
+  beneficiary: { name: 'ACME CORP', document: '12345678000195', address: 'Avenida 1' },
+  payer: { name: 'Joao da Silva', document: '12345678901', address: 'Rua 2' },
+  payment: {
+    documentNumber: 'DOC-001',
+    ourNumber: '12345678',
+    amount: 150.5,
+    dueDate: new Date('2025-02-10'),
+    barcode,
+    digitableLine,
+    pix: { payload: pix.payload },
+  },
+  bank: { code: '341', name: 'ITAU UNIBANCO SA' },
+});
+```
+
+## 🏦 Bank Adapters (Itaú)
+
+```typescript
+import { createItauAdapter } from '@linkiez/boleto-sdk';
+
+const adapter = createItauAdapter();
+
+adapter.assertSupportedWallet('109');
+
+const ourNumber = adapter.buildOurNumber('12345678');
+// { baseNumber: '12345678', checkDigit: 2, formatted: '123456782' }
+```
+
+For complete examples, see [Adapters Guide](doc/ADAPTERS.md).
+
+## 📚 Documentation
+
+### Core
+
+- [API Reference](doc/API-REFERENCE.md)
+- [CNAB240 Guide](doc/CNAB240_GUIDE.md)
+- [CNAB400 Usage Guide](doc/CNAB400-USAGE-GUIDE.md)
+- [Boleto Generation Guide](doc/BOLETO-GENERATION.md)
+- [Adapters Guide](doc/ADAPTERS.md)
+- [Examples](doc/EXAMPLES.md)
+
+### Specs and Validation
+
+- [CNAB240 FEBRABAN Spec](doc/CNAB240-FEBRABAN.md)
+- [CNAB400 Positions Validation](doc/CNAB400_POSITIONS_VALIDATION.md)
+- [Segment Positions Validation](doc/SEGMENT_POSITIONS_VALIDATION.md)
+- [Business Rules](doc/BUSINESS_RULES.md)
+- [Business Rules Sources](doc/BUSINESS_RULES_SOURCES.md)
+
+### Supporting Docs
+
+- [Bank Differences](doc/BANK_DIFFERENCES.md)
+- [FAQ](doc/FAQ.md)
+- [Migration](doc/MIGRATION.md)
+- [SonarQube](doc/SONARQUBE.md)
+- [CNAB400 Bank Samples](doc)
+
+### Project
+
+- [Architecture](ARCHITECTURE.md)
+- [Testing](TESTING.md)
+- [Contributing](CONTRIBUTING.md)
+- [Roadmap](ROADMAP.md)
+
+## 🛠️ Development
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) and [TESTING.md](TESTING.md) for setup, workflows, and conventions.
+
+## 📜 License
+
+APACHE. See [LICENSE](LICENSE).
+
+## 🔗 Links
+
+- [NPM Package](https://www.npmjs.com/package/@linkiez/boleto-sdk)
+- [Report Issues](https://github.com/linkiez/BoletoSDK/issues)

package/dist/adapters/IBankAdapter.d.ts

@@ -0,0 +1,9 @@
+export interface IBankAdapter<TWalletConfig = unknown, TRemittanceDetail = unknown, TReturnDetail = unknown, TCnab240Detail = unknown> {
+    isSupportedWallet(walletCode: string): boolean;
+    assertSupportedWallet(walletCode: string): void;
+    getWalletConfig(walletCode: string): TWalletConfig | undefined;
+    buildRemittanceDetailsFromContent(content: string): TRemittanceDetail[];
+    buildReturnDetailsFromContent(content: string): TReturnDetail[];
+    buildCnab240DetailsFromContent(content: string): TCnab240Detail[];
+}
+//# sourceMappingURL=IBankAdapter.d.ts.map

package/dist/adapters/IBankAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IBankAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/IBankAdapter.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY,CAC3B,aAAa,GAAG,OAAO,EACvB,iBAAiB,GAAG,OAAO,EAC3B,aAAa,GAAG,OAAO,EACvB,cAAc,GAAG,OAAO;IAQxB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAQ/C,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAQhD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAQ/D,iCAAiC,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAAC;IAQxE,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IAQhE,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;CACnE"}

package/dist/adapters/IBankAdapter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IBankAdapter.js.map

package/dist/adapters/IBankAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IBankAdapter.js","sourceRoot":"","sources":["../../src/adapters/IBankAdapter.ts"],"names":[],"mappings":""}

package/dist/adapters/bradesco/BradescoAdapter.d.ts

@@ -0,0 +1,27 @@
+import type { BradescoCnab240Segment, BradescoCnab400RemittanceDetail, BradescoCnab400ReturnDetail, BradescoOccurrenceMapping, BradescoOurNumberResult, BradescoRemittanceFields, BradescoReturnFields, BradescoWalletConfig } from '../../types/adapters';
+import type { Batch as Cnab240Batch, Cnab240File, DetailRecord as Cnab240DetailRecord } from '../../types/cnab240';
+import type { IBankAdapter } from '../IBankAdapter';
+export declare class BradescoAdapter implements IBankAdapter<BradescoWalletConfig, BradescoCnab400RemittanceDetail, BradescoCnab400ReturnDetail, BradescoCnab240Segment> {
+    private static normalizeCnab240Wallet;
+    private static extractDetailLines;
+    private buildCnab240Validation;
+    isSupportedWallet(walletCode: string): boolean;
+    assertSupportedWallet(walletCode: string): void;
+    getWalletConfig(walletCode: string): BradescoWalletConfig | undefined;
+    formatOurNumber(baseNumber: string): string;
+    buildOurNumber(baseNumber: string): BradescoOurNumberResult;
+    mapOccurrenceCode(occurrenceCode: string): BradescoOccurrenceMapping;
+    validateRemittanceFields(fields: BradescoRemittanceFields): import("../..").ValidationResult;
+    validateReturnFields(fields: BradescoReturnFields): import("../..").ValidationResult;
+    buildRemittanceDetail(line: string): BradescoCnab400RemittanceDetail;
+    buildReturnDetail(line: string): BradescoCnab400ReturnDetail;
+    buildRemittanceDetailsFromContent(content: string): BradescoCnab400RemittanceDetail[];
+    buildReturnDetailsFromContent(content: string): BradescoCnab400ReturnDetail[];
+    buildCnab240Detail(detail: Cnab240DetailRecord): BradescoCnab240Segment;
+    buildCnab240Details(details: Cnab240DetailRecord[]): BradescoCnab240Segment[];
+    buildCnab240DetailsFromBatch(batch: Cnab240Batch): BradescoCnab240Segment[];
+    buildCnab240DetailsFromFile(file: Cnab240File): BradescoCnab240Segment[];
+    buildCnab240DetailsFromContent(content: string): BradescoCnab240Segment[];
+}
+export declare function createBradescoAdapter(): BradescoAdapter;
+//# sourceMappingURL=BradescoAdapter.d.ts.map

package/dist/adapters/bradesco/BradescoAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BradescoAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/bradesco/BradescoAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,+BAA+B,EAC/B,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,KAAK,IAAI,YAAY,EACrB,WAAW,EACX,YAAY,IAAI,mBAAmB,EACpC,MAAM,qBAAqB,CAAC;AAY7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKpD,qBAAa,eAAgB,YAAW,YAAY,CAClD,oBAAoB,EACpB,+BAA+B,EAC/B,2BAA2B,EAC3B,sBAAsB,CACvB;IACC,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAarC,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAWjC,OAAO,CAAC,sBAAsB;IAsBvB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAU9C,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAU/C,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAUrE,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAU3C,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,uBAAuB;IAU3D,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,yBAAyB;IAUpE,wBAAwB,CAAC,MAAM,EAAE,wBAAwB;IAUzD,oBAAoB,CAAC,MAAM,EAAE,oBAAoB;IAUjD,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,+BAA+B;IAmBpE,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,2BAA2B;IAuB5D,iCAAiC,CAAC,OAAO,EAAE,MAAM,GAAG,+BAA+B,EAAE;IAUrF,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,2BAA2B,EAAE;IAU7E,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,sBAAsB;IAuBvE,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,sBAAsB,EAAE;IAU7E,4BAA4B,CAAC,KAAK,EAAE,YAAY,GAAG,sBAAsB,EAAE;IAU3E,2BAA2B,CAAC,IAAI,EAAE,WAAW,GAAG,sBAAsB,EAAE;IAUxE,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,EAAE;CAIjF;AAOD,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD"}

package/dist/adapters/bradesco/BradescoAdapter.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BradescoAdapter = void 0;
+exports.createBradescoAdapter = createBradescoAdapter;
+const cnab240_1 = require("../../parsers/cnab240");
+const cnab400_1 = require("../../parsers/cnab400");
+const BradescoFieldParser_1 = require("./BradescoFieldParser");
+const BradescoOccurrenceMapper_1 = require("./BradescoOccurrenceMapper");
+const BradescoOurNumberCalculator_1 = require("./BradescoOurNumberCalculator");
+const BradescoValidator_1 = require("./BradescoValidator");
+const BradescoWalletValidator_1 = require("./BradescoWalletValidator");
+class BradescoAdapter {
+    static normalizeCnab240Wallet(walletNumber) {
+        if (!walletNumber) {
+            return undefined;
+        }
+        const normalized = walletNumber.trim();
+        if (normalized.length === 1 && /^\d$/.test(normalized)) {
+            return `0${normalized}`;
+        }
+        return normalized;
+    }
+    static extractDetailLines(content) {
+        if (!content || content.trim().length === 0) {
+            return [];
+        }
+        return content
+            .replaceAll('\r', '')
+            .split('\n')
+            .filter((line) => line.length > 0 && line.startsWith('1'));
+    }
+    buildCnab240Validation(walletNumber) {
+        const errors = [];
+        if (!walletNumber || !this.getWalletConfig(walletNumber)) {
+            errors.push(`Unsupported Bradesco wallet code: ${walletNumber ?? ''}`.trim());
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+        };
+    }
+    isSupportedWallet(walletCode) {
+        return (0, BradescoWalletValidator_1.isValidBradescoWallet)(walletCode);
+    }
+    assertSupportedWallet(walletCode) {
+        (0, BradescoWalletValidator_1.assertValidBradescoWallet)(walletCode);
+    }
+    getWalletConfig(walletCode) {
+        return (0, BradescoWalletValidator_1.getBradescoWalletConfig)(walletCode);
+    }
+    formatOurNumber(baseNumber) {
+        return (0, BradescoOurNumberCalculator_1.formatBradescoOurNumber)(baseNumber);
+    }
+    buildOurNumber(baseNumber) {
+        return (0, BradescoOurNumberCalculator_1.buildBradescoOurNumber)(baseNumber);
+    }
+    mapOccurrenceCode(occurrenceCode) {
+        return (0, BradescoOccurrenceMapper_1.mapBradescoOccurrenceCode)(occurrenceCode);
+    }
+    validateRemittanceFields(fields) {
+        return (0, BradescoValidator_1.validateBradescoRemittanceFields)(fields);
+    }
+    validateReturnFields(fields) {
+        return (0, BradescoValidator_1.validateBradescoReturnFields)(fields);
+    }
+    buildRemittanceDetail(line) {
+        const detail = (0, cnab400_1.parseDetailRecord)(line);
+        const fields = (0, BradescoFieldParser_1.parseBradescoRemittanceFields)(line);
+        return {
+            movementType: 'remittance',
+            detail,
+            fields,
+            wallet: fields.walletNumber ? this.getWalletConfig(fields.walletNumber) : undefined,
+            validation: this.validateRemittanceFields(fields),
+        };
+    }
+    buildReturnDetail(line) {
+        const detail = (0, cnab400_1.parseReturnDetailRecord)(line);
+        const fields = (0, BradescoFieldParser_1.parseBradescoReturnFields)(line);
+        return {
+            movementType: 'return',
+            detail,
+            fields,
+            wallet: fields.walletNumber ? this.getWalletConfig(fields.walletNumber) : undefined,
+            occurrence: fields.occurrenceCode && (0, BradescoOccurrenceMapper_1.isValidBradescoOccurrenceCode)(fields.occurrenceCode)
+                ? this.mapOccurrenceCode(fields.occurrenceCode)
+                : undefined,
+            validation: this.validateReturnFields(fields),
+        };
+    }
+    buildRemittanceDetailsFromContent(content) {
+        return BradescoAdapter.extractDetailLines(content).map((line) => this.buildRemittanceDetail(line));
+    }
+    buildReturnDetailsFromContent(content) {
+        return BradescoAdapter.extractDetailLines(content).map((line) => this.buildReturnDetail(line));
+    }
+    buildCnab240Detail(detail) {
+        const walletNumber = BradescoAdapter.normalizeCnab240Wallet(detail.segmentP.portfolioCode);
+        const occurrenceCode = detail.segmentP.occurrenceCode;
+        return {
+            movementType: 'cnab240',
+            detail,
+            walletNumber,
+            wallet: walletNumber ? this.getWalletConfig(walletNumber) : undefined,
+            occurrenceCode,
+            occurrence: (0, BradescoOccurrenceMapper_1.isValidBradescoOccurrenceCode)(occurrenceCode)
+                ? this.mapOccurrenceCode(occurrenceCode)
+                : undefined,
+            validation: this.buildCnab240Validation(walletNumber),
+        };
+    }
+    buildCnab240Details(details) {
+        return details.map((detail) => this.buildCnab240Detail(detail));
+    }
+    buildCnab240DetailsFromBatch(batch) {
+        return this.buildCnab240Details(batch.details);
+    }
+    buildCnab240DetailsFromFile(file) {
+        return file.batches.flatMap((batch) => this.buildCnab240DetailsFromBatch(batch));
+    }
+    buildCnab240DetailsFromContent(content) {
+        const file = (0, cnab240_1.parseCnab240)(content);
+        return this.buildCnab240DetailsFromFile(file);
+    }
+}
+exports.BradescoAdapter = BradescoAdapter;
+function createBradescoAdapter() {
+    return new BradescoAdapter();
+}
+//# sourceMappingURL=BradescoAdapter.js.map

package/dist/adapters/bradesco/BradescoAdapter.js.map

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

package/dist/adapters/bradesco/BradescoFieldParser.d.ts

@@ -0,0 +1,4 @@
+import type { BradescoRemittanceFields, BradescoReturnFields } from '../../types/adapters';
+export declare function parseBradescoRemittanceFields(line: string): BradescoRemittanceFields;
+export declare function parseBradescoReturnFields(line: string): BradescoReturnFields;
+//# sourceMappingURL=BradescoFieldParser.d.ts.map

package/dist/adapters/bradesco/BradescoFieldParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BradescoFieldParser.d.ts","sourceRoot":"","sources":["../../../src/adapters/bradesco/BradescoFieldParser.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAmB3F,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CA8CpF;AASD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAgC5E"}

package/dist/adapters/bradesco/BradescoFieldParser.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBradescoRemittanceFields = parseBradescoRemittanceFields;
+exports.parseBradescoReturnFields = parseBradescoReturnFields;
+const cnab400_1 = require("../../constants/cnab400");
+const RECORD_POSITIONS_1 = require("../../constants/cnab400/RECORD_POSITIONS");
+const parsers_1 = require("../../utils/parsers");
+function extractField(line, start, end) {
+    return line.substring(start - 1, end);
+}
+function trimToUndefined(value) {
+    const trimmedValue = value.trim();
+    return trimmedValue || undefined;
+}
+function parseBradescoRemittanceFields(line) {
+    if (line.length !== cnab400_1.LINE_LENGTH) {
+        throw new Error(`Invalid Bradesco remittance detail line length: ${line.length}`);
+    }
+    const instructionCode = extractField(line, RECORD_POSITIONS_1.DETAIL_RECORD_REMESSA_POSITIONS.INSTRUCTION_CODE_1.start, RECORD_POSITIONS_1.DETAIL_RECORD_REMESSA_POSITIONS.INSTRUCTION_CODE_1.end);
+    const walletNumber = trimToUndefined(extractField(line, RECORD_POSITIONS_1.DETAIL_RECORD_REMESSA_POSITIONS.PORTFOLIO_CODE.start, RECORD_POSITIONS_1.DETAIL_RECORD_REMESSA_POSITIONS.PORTFOLIO_CODE.end));
+    const walletType = trimToUndefined(extractField(line, RECORD_POSITIONS_1.DETAIL_RECORD_REMESSA_POSITIONS.PORTFOLIO_TYPE.start, RECORD_POSITIONS_1.DETAIL_RECORD_REMESSA_POSITIONS.PORTFOLIO_TYPE.end));
+    const occurrenceCode = trimToUndefined(extractField(line, RECORD_POSITIONS_1.DETAIL_RECORD_REMESSA_POSITIONS.OCCURRENCE_CODE.start, RECORD_POSITIONS_1.DETAIL_RECORD_REMESSA_POSITIONS.OCCURRENCE_CODE.end));
+    const rawDaysCount = trimToUndefined(extractField(line, RECORD_POSITIONS_1.DETAIL_RECORD_REMESSA_POSITIONS.DAYS_COUNT.start, RECORD_POSITIONS_1.DETAIL_RECORD_REMESSA_POSITIONS.DAYS_COUNT.end));
+    return {
+        instructionCode,
+        walletNumber,
+        walletType,
+        occurrenceCode,
+        daysCount: rawDaysCount ? (0, parsers_1.parseNumber)(rawDaysCount) : undefined,
+    };
+}
+function parseBradescoReturnFields(line) {
+    if (line.length !== cnab400_1.LINE_LENGTH) {
+        throw new Error(`Invalid Bradesco return detail line length: ${line.length}`);
+    }
+    return {
+        walletNumber: trimToUndefined(extractField(line, 84, 86)),
+        walletType: trimToUndefined(extractField(line, RECORD_POSITIONS_1.DETAIL_RECORD_RETORNO_POSITIONS.PORTFOLIO_CODE.start, RECORD_POSITIONS_1.DETAIL_RECORD_RETORNO_POSITIONS.PORTFOLIO_CODE.end)),
+        occurrenceCode: trimToUndefined(extractField(line, RECORD_POSITIONS_1.DETAIL_RECORD_RETORNO_POSITIONS.OCCURRENCE_CODE.start, RECORD_POSITIONS_1.DETAIL_RECORD_RETORNO_POSITIONS.OCCURRENCE_CODE.end)),
+        ourNumber: trimToUndefined(extractField(line, RECORD_POSITIONS_1.DETAIL_RECORD_RETORNO_POSITIONS.OUR_NUMBER.start, RECORD_POSITIONS_1.DETAIL_RECORD_RETORNO_POSITIONS.OUR_NUMBER.end)),
+        ourNumberCheckDigit: trimToUndefined(extractField(line, 71, 71)),
+        confirmedOurNumber: trimToUndefined(extractField(line, 127, 134)),
+        confirmedOurNumberCheckDigit: trimToUndefined(extractField(line, 135, 135)),
+    };
+}
+//# sourceMappingURL=BradescoFieldParser.js.map

package/dist/adapters/bradesco/BradescoFieldParser.js.map

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

package/dist/adapters/bradesco/BradescoOccurrenceMapper.d.ts

@@ -0,0 +1,5 @@
+import type { BradescoOccurrenceCode, BradescoOccurrenceMapping } from '../../types/adapters';
+export declare const BRADESCO_OCCURRENCE_CODE_MAP: Record<BradescoOccurrenceCode, BradescoOccurrenceMapping>;
+export declare function isValidBradescoOccurrenceCode(occurrenceCode: string): occurrenceCode is BradescoOccurrenceCode;
+export declare function mapBradescoOccurrenceCode(occurrenceCode: string): BradescoOccurrenceMapping;
+//# sourceMappingURL=BradescoOccurrenceMapper.d.ts.map

package/dist/adapters/bradesco/BradescoOccurrenceMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BradescoOccurrenceMapper.d.ts","sourceRoot":"","sources":["../../../src/adapters/bradesco/BradescoOccurrenceMapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,yBAAyB,EAC1B,MAAM,sBAAsB,CAAC;AAK9B,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAC/C,sBAAsB,EACtB,yBAAyB,CAgC1B,CAAC;AAQF,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,MAAM,GACrB,cAAc,IAAI,sBAAsB,CAE1C;AASD,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,yBAAyB,CAM3F"}