lib-fints 1.4.8 → 1.5.1

package/dist/tests/partedResponse.test.js

@@ -0,0 +1,181 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { FinTSConfig } from '../config.js';
+import { Dialog } from '../dialog.js';
+import { StatementInteractionCAMT } from '../interactions/statementInteractionCAMT.js';
+import { CustomerOrderMessage, Message } from '../message.js';
+import { HICAZ } from '../segments/HICAZ.js';
+import { HKCAZ } from '../segments/HKCAZ.js';
+import { registerSegments } from '../segments/registry.js';
+vi.mock('../httpClient.js', () => ({
+    HttpClient: class MockHttpClient {
+        url;
+        debug;
+        debugRaw;
+        constructor(url, debug = false, debugRaw = false) {
+            this.url = url;
+            this.debug = debug;
+            this.debugRaw = debugRaw;
+        }
+        sendMessage = vi.fn();
+    },
+}));
+registerSegments();
+const CAMT_DESCRIPTOR = 'urn?:iso?:std?:iso?:20022?:tech?:xsd?:camt.052.001.08';
+/**
+ * A HICAZ segment as the bank sends it. Every portion of a parted response is a
+ * COMPLETE segment — it repeats account and descriptor before carrying its own share
+ * of the CAMT documents.
+ */
+function hicazText(...camtDocuments) {
+    const booked = camtDocuments.map((doc) => `@${doc.length}@${doc}`).join(':');
+    return `HICAZ:5:1+DE991234567123456:BANK12+${CAMT_DESCRIPTOR}+${booked}'`;
+}
+function responseMessage(hicaz, withContinuation) {
+    const answers = withContinuation
+        ? "HIRMG:3:2+0010::Entgegengenommen.+3040::Es liegen weitere Umsaetze vor.:AUFSETZ_1'"
+        : "HIRMG:3:2+0010::Entgegengenommen.+0020::Abfrage erfolgreich.'";
+    return Message.decode(`${answers}${hicaz}`, HICAZ.Id);
+}
+describe('parted responses (bank answer code 3040)', () => {
+    let config;
+    let dialog;
+    beforeEach(() => {
+        const bankingInformation = {
+            systemId: 'MOCK_SYSTEM_ID',
+            bankMessages: [],
+            bpd: {
+                version: 1,
+                bankId: '12030000',
+                bankName: 'Mock Bank',
+                countryCode: 280,
+                url: 'http://mock.bank.url',
+                allowedTransactions: [
+                    { transId: 'HKCAZ', tanRequired: false, versions: [1] },
+                ],
+                supportedTanMethods: [],
+                availableTanMethodIds: [],
+                maxTransactionsPerMessage: 1,
+                supportedLanguages: [],
+                supportedHbciVersions: [300],
+            },
+        };
+        config = FinTSConfig.fromBankingInformation('PRODUCT', '1.0', bankingInformation, 'user', 'pin');
+        dialog = new Dialog(config);
+    });
+    it('delivers every portion into the message the caller holds', async () => {
+        const first = responseMessage(hicazText('<Doc>one</Doc>'), true);
+        const second = responseMessage(hicazText('<Doc>two</Doc>', '<Doc>three</Doc>'), false);
+        vi.mocked(dialog.httpClient.sendMessage).mockResolvedValueOnce(second);
+        const interaction = new StatementInteractionCAMT('123');
+        const request = new CustomerOrderMessage(HKCAZ.Id, HICAZ.Id);
+        request.addSegment({
+            header: { segId: HKCAZ.Id, segNr: 0, version: 1 },
+            account: { iban: 'DE991234567123456', bic: 'BANK12' },
+            acceptedCamtFormats: ['urn:iso:std:iso:20022:tech:xsd:camt.052.001.08'],
+            allAccounts: false,
+        });
+        // biome-ignore lint/suspicious/noExplicitAny: reaching into the private collector on purpose
+        await dialog.handlePartedMessages(request, first, interaction);
+        // Before the fix this was a single unresolved PARTED segment and everything after
+        // the first portion was lost without a trace.
+        const segments = first.findAllSegments(HICAZ.Id);
+        expect(first.findAllSegments('PARTED')).toHaveLength(0);
+        expect(segments).toHaveLength(2);
+        expect(segments.flatMap((s) => s.bookedTransactions)).toEqual([
+            '<Doc>one</Doc>',
+            '<Doc>two</Doc>',
+            '<Doc>three</Doc>',
+        ]);
+    });
+    it('leaves an unparted response untouched', async () => {
+        const only = responseMessage(hicazText('<Doc>one</Doc>'), false);
+        const interaction = new StatementInteractionCAMT('123');
+        const request = new CustomerOrderMessage(HKCAZ.Id, HICAZ.Id);
+        request.addSegment({
+            header: { segId: HKCAZ.Id, segNr: 0, version: 1 },
+            account: { iban: 'DE991234567123456', bic: 'BANK12' },
+            acceptedCamtFormats: ['urn:iso:std:iso:20022:tech:xsd:camt.052.001.08'],
+            allAccounts: false,
+        });
+        // biome-ignore lint/suspicious/noExplicitAny: reaching into the private collector on purpose
+        await dialog.handlePartedMessages(request, only, interaction);
+        expect(dialog.httpClient.sendMessage).not.toHaveBeenCalled();
+        const segments = only.findAllSegments(HICAZ.Id);
+        expect(segments).toHaveLength(1);
+        expect(segments[0].bookedTransactions).toEqual(['<Doc>one</Doc>']);
+    });
+});
+describe('StatementInteractionCAMT with a parted response', () => {
+    it('parses the CAMT documents of every segment, not just the first', () => {
+        const camt = (id, amount) => `<?xml version="1.0"?><Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.052.001.08">` +
+            `<BkToCstmrAcctRpt><GrpHdr><MsgId>${id}</MsgId><CreDtTm>2026-07-01T10:00:00+02:00</CreDtTm></GrpHdr>` +
+            `<Rpt><Id>${id}</Id><Acct><Id><IBAN>DE991234567123456</IBAN></Id><Ccy>EUR</Ccy></Acct>` +
+            `<Bal><Tp><CdOrPrtry><Cd>PRCD</Cd></CdOrPrtry></Tp><Amt Ccy="EUR">1000.00</Amt>` +
+            `<CdtDbtInd>CRDT</CdtDbtInd><Dt><Dt>2026-06-30</Dt></Dt></Bal>` +
+            `<Bal><Tp><CdOrPrtry><Cd>CLBD</Cd></CdOrPrtry></Tp><Amt Ccy="EUR">990.00</Amt>` +
+            `<CdtDbtInd>CRDT</CdtDbtInd><Dt><Dt>2026-07-01</Dt></Dt></Bal>` +
+            `<Ntry><Amt>${amount}</Amt><CdtDbtInd>DBIT</CdtDbtInd>` +
+            `<BookgDt><Dt>2026-07-01</Dt></BookgDt><ValDt><Dt>2026-07-01</Dt></ValDt>` +
+            `<AcctSvcrRef>TXN${id}</AcctSvcrRef>` +
+            `<NtryDtls><TxDtls><RmtInf><Ustrd>Test ${id}</Ustrd></RmtInf></TxDtls></NtryDtls>` +
+            `</Ntry></Rpt></BkToCstmrAcctRpt></Document>`;
+        const message = Message.decode(`${hicazText(camt('A', '10.00'))}${hicazText(camt('B', '20.00'))}`);
+        expect(message.findAllSegments(HICAZ.Id)).toHaveLength(2);
+        const interaction = new StatementInteractionCAMT('123');
+        const clientResponse = { statements: [] };
+        interaction.handleResponse(message, clientResponse);
+        const transactions = clientResponse.statements.flatMap((s) => s.transactions);
+        expect(transactions).toHaveLength(2);
+    });
+});
+describe('several response segments in one bank message', () => {
+    it('resolves every portion, not just the first', async () => {
+        // Eine Botschaft mit ZWEI HICAZ-Segmenten. Vorher wurde nur das erste aufgeloest;
+        // das zweite blieb als PARTED im Baum und war fuer findAllSegments unsichtbar.
+        const answers = "HIRMG:3:2+0010::Entgegengenommen.+0020::Abfrage erfolgreich.'";
+        const message = Message.decode(`${answers}${hicazText('<Doc>one</Doc>')}${hicazText('<Doc>two</Doc>')}`, HICAZ.Id);
+        expect(message.findAllSegments('PARTED')).toHaveLength(2);
+        const dialog = new Dialog(FinTSConfig.fromBankingInformation('PRODUCT', '1.0', {
+            systemId: 'X',
+            bankMessages: [],
+            bpd: {
+                version: 1,
+                bankId: '12030000',
+                bankName: 'Mock',
+                countryCode: 280,
+                url: 'http://mock.bank.url',
+                allowedTransactions: [{ transId: 'HKCAZ', tanRequired: false, versions: [1] }],
+                supportedTanMethods: [],
+                availableTanMethodIds: [],
+                maxTransactionsPerMessage: 1,
+                supportedLanguages: [],
+                supportedHbciVersions: [300],
+            },
+            // biome-ignore lint/suspicious/noExplicitAny: schlanker Mock
+        }, 'user', 'pin'));
+        const request = new CustomerOrderMessage(HKCAZ.Id, HICAZ.Id);
+        request.addSegment({
+            header: { segId: HKCAZ.Id, segNr: 0, version: 1 },
+            account: { iban: 'DE991234567123456', bic: 'BANK12' },
+            acceptedCamtFormats: ['urn:iso:std:iso:20022:tech:xsd:camt.052.001.08'],
+            allAccounts: false,
+        });
+        // biome-ignore lint/suspicious/noExplicitAny: private Sammelroutine, absichtlich
+        await dialog.handlePartedMessages(request, message, new StatementInteractionCAMT('123'));
+        expect(message.findAllSegments('PARTED')).toHaveLength(0);
+        const segments = message.findAllSegments(HICAZ.Id);
+        expect(segments).toHaveLength(2);
+        expect(segments.flatMap((s) => s.bookedTransactions)).toEqual([
+            '<Doc>one</Doc>',
+            '<Doc>two</Doc>',
+        ]);
+    });
+    it('does not mistake a parameter segment for a response segment', () => {
+        // HICAZS begins like HICAZ. Without the colon in the comparison it would be held
+        // back as PARTED and never decoded — the same for HIEKAS/HIEKA, HIKAZS/HIKAZ.
+        const hicazs = "HICAZS:16:1:4+1+1+0+450:N:N:urn?:iso?:std?:iso?:20022?:tech?:xsd?:camt.052.001.08'";
+        const message = Message.decode(hicazs, HICAZ.Id);
+        expect(message.findAllSegments('PARTED')).toHaveLength(0);
+        expect(message.findAllSegments('HICAZS')).toHaveLength(1);
+    });
+});

package/dist/types/accountDescriptor.d.ts

@@ -0,0 +1,49 @@
+import type { BankAccount } from './bankAccount.js';
+import type { FinTSConfig } from './config.js';
+import type { Account } from './dataGroups/Account.js';
+import type { InternationalAccount } from './dataGroups/InternationalAccount.js';
+/**
+ * Builds the account connection ("Kontoverbindung") a segment carries.
+ *
+ * FinTS has two forms, and segments pick one by version: the national form (KTV,
+ * account number + sub-account + bank) and the international one (KTI, which adds
+ * IBAN and BIC and makes every field optional). The international form allows the
+ * national fields to be present as well, but only where the bank permits it — and
+ * the bank says so in the HISPAS parameters, in `nationalAccountAllowed`.
+ *
+ * Filling both halves regardless is rejected by banks that set the flag to false.
+ * Measured at comdirect (BLZ 2004xxxx), same account, same range, same session:
+ *
+ *   IBAN + BIC + number + sub-account + bank   →  3010 "Kontonummer ist ungültig", 0 statements
+ *   IBAN + BIC                                 →  0020 "Auftrag ausgeführt", 19 statements
+ *   IBAN                                       →  0020 "Auftrag ausgeführt", 19 statements
+ *   number + sub-account + bank                →  3010 "Kontonummer ist ungültig", 0 statements
+ *
+ * The last line is why this is a rule about the national *fields* rather than about
+ * the combination: the bank rejects them in a KTI even when no IBAN accompanies
+ * them.
+ */
+/**
+ * The national form. Built field by field rather than by spreading the account and
+ * blanking what does not belong: the data group has exactly these three fields, and
+ * saying so is clearer than relying on the encoder to ignore the rest.
+ */
+export declare function nationalAccount(account: BankAccount): Account;
+/**
+ * The international form. IBAN and BIC always; the national fields only where the
+ * bank's HISPAS parameters allow them.
+ *
+ * An account without an IBAN — a securities account, typically — has nothing else
+ * to identify it with, so it keeps the national fields whatever the flag says. A
+ * request the bank refuses is more useful than one it cannot resolve at all.
+ *
+ * A bank that announces no HISPAS at all keeps both halves, exactly as before. The
+ * specification would read absent permission as no permission, but this library has
+ * already been round that loop: #20 reduced the CAMT descriptor to IBAN and BIC for
+ * comdirect, #25 reported Postbank answering "Angaben zur nationalen Kontoverbindung
+ * für Identifikation erforderlich", and the reduction was reverted. Only a bank that
+ * says `false` gets the shorter form, so no bank that works today can regress on a
+ * rule it never stated.
+ */
+export declare function internationalAccount(config: FinTSConfig, account: BankAccount): InternationalAccount;
+//# sourceMappingURL=accountDescriptor.d.ts.map

package/dist/types/accountDescriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accountDescriptor.d.ts","sourceRoot":"","sources":["../../src/accountDescriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAIjF;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAM7D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,WAAW,GAClB,oBAAoB,CAgBtB"}

package/dist/types/bankAccount.d.ts

@@ -22,5 +22,18 @@ export type BankAccount = SepaAccount & {
     limit?: AccountLimit;
     allowedTransactions?: AllowedTransactions[];
 };
+/**
+ * How a caller names an account.
+ *
+ * An account number is not by itself unique: FinTS identifies an account by number
+ * *and* sub-account id together, and banks use that — a securities account and the
+ * current account it settles through commonly share a number and differ only in the
+ * sub-account id. Where that happens, a number alone cannot say which one is meant,
+ * so the account itself can be passed instead. Take it from
+ * `config.bankingInformation.upd.bankAccounts`.
+ */
+export type AccountRef = string | BankAccount;
+/** How an account reference reads in an error message. */
+export declare function describeAccount(account: AccountRef): string;
 export declare function finTsAccountTypeToEnum(accountType: number): AccountType;
 //# sourceMappingURL=bankAccount.d.ts.map

package/dist/types/bankAccount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bankAccount.d.ts","sourceRoot":"","sources":["../../src/bankAccount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE7E,oBAAY,WAAW;IACtB,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;IACvC,qBAAqB,0BAA0B;IAC/C,mBAAmB,wBAAwB;IAC3C,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;CAC/B;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,mBAAmB,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAC5C,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAWvE"}
+{"version":3,"file":"bankAccount.d.ts","sourceRoot":"","sources":["../../src/bankAccount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE7E,oBAAY,WAAW;IACtB,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;IACvC,qBAAqB,0BAA0B;IAC/C,mBAAmB,wBAAwB;IAC3C,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;CAC/B;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,mBAAmB,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAC5C,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,CAAC;AAE9C,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAK3D;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAWvE"}

package/dist/types/client.d.ts

@@ -1,6 +1,8 @@
+import { type AccountRef } from './bankAccount.js';
 import { FinTSConfig } from './config.js';
 import { type AccountBalanceResponse } from './interactions/balanceInteraction.js';
 import type { StatementResponse } from './interactions/customerInteraction.js';
+import { type ElectronicStatementOptions, type ElectronicStatementResponse } from './interactions/electronicStatementInteraction.js';
 import type { InitResponse } from './interactions/initDialogInteraction.js';
 import { type PortfolioResponse } from './interactions/portfolioInteraction.js';
 import type { TanMethod } from './tanMethod.js';
@@ -42,16 +44,16 @@ export declare class FinTSClient {
     synchronizeWithTan(tanReference: string, tan?: string): Promise<SynchronizeResponse>;
     /**
      * Checks if the bank supports fetching an account balance in general or for the given account number when provided
-     * @param accountNumber when the account number is provided, checks if the account supports fetching the balance
+     * @param account when the account number is provided, checks if the account supports fetching the balance
      * @returns true if the bank (and account) supports fetching the account balance
      */
-    canGetAccountBalance(accountNumber?: string): boolean;
+    canGetAccountBalance(account?: AccountRef): boolean;
     /**
      * Fetches the account balance for the given account number
-     * @param accountNumber - the account number to fetch the balance for, must be an account available in the config.baningInformation.UPD.accounts
+     * @param account - the account number to fetch the balance for, must be an account available in the config.baningInformation.UPD.accounts
      * @returns the account balance response
      */
-    getAccountBalance(accountNumber: string): Promise<AccountBalanceResponse>;
+    getAccountBalance(account: AccountRef): Promise<AccountBalanceResponse>;
     /**
      * Continues the account balance fetching when a TAN is required
      * @param tanReference The TAN reference provided in the first call's response
@@ -61,19 +63,19 @@ export declare class FinTSClient {
     getAccountBalanceWithTan(tanReference: string, tan?: string): Promise<AccountBalanceResponse>;
     /**
      * Checks if the bank supports fetching account statements in general or for the given account number when provided
-     * @param accountNumber when the account number is provided, checks if the account supports fetching of statements
+     * @param account when the account number is provided, checks if the account supports fetching of statements
      * @returns true if the bank (and account) supports fetching account statements
      */
-    canGetAccountStatements(accountNumber?: string): boolean;
+    canGetAccountStatements(account?: AccountRef): boolean;
     /**
      * Fetches the account statements for the given account number
-     * @param accountNumber - the account number to fetch the statements for, must be an account available in the config.baningInformation.UPD.accounts
+     * @param account - the account number to fetch the statements for, must be an account available in the config.baningInformation.UPD.accounts
      * @param from - an optional start date of the period to fetch the statements for
      * @param to - an optional end date of the period to fetch the statements for
      * @param preferCamt - whether to prefer CAMT format over MT940 when both are supported (default: true)
      * @returns an account statements response containing an array of statements
      */
-    getAccountStatements(accountNumber: string, from?: Date, to?: Date, preferCamt?: boolean): Promise<StatementResponse>;
+    getAccountStatements(account: AccountRef, from?: Date, to?: Date, preferCamt?: boolean): Promise<StatementResponse>;
     /**
      * Continues the account statements fetching when a TAN is required
      * @param tanReference The TAN reference provided in the first call's response
@@ -83,19 +85,19 @@ export declare class FinTSClient {
     getAccountStatementsWithTan(tanReference: string, tan?: string): Promise<StatementResponse>;
     /**
      * Checks if the bank supports fetching portfolio information in general or for the given account number when provided
-     * @param accountNumber when the account number is provided, checks if the account supports fetching of portfolio information
+     * @param account when the account number is provided, checks if the account supports fetching of portfolio information
      * @returns true if the bank (and account) supports fetching portfolio information
      */
-    canGetPortfolio(accountNumber?: string): boolean;
+    canGetPortfolio(account?: AccountRef): boolean;
     /**
      * Fetches the portfolio information for the given depot account number
-     * @param accountNumber - the depot account number to fetch the portfolio for, must be an account available in the config.bankingInformation.UPD.accounts
+     * @param account - the depot account number to fetch the portfolio for, must be an account available in the config.bankingInformation.UPD.accounts
      * @param currency - optional currency filter for the portfolio statement
      * @param priceQuality - optional price quality filter ('1' for real-time, '2' for delayed)
      * @param maxEntries - optional maximum number of entries to retrieve
      * @returns a portfolio response containing holdings and total value
      */
-    getPortfolio(accountNumber: string, currency?: string, priceQuality?: '1' | '2', maxEntries?: number): Promise<PortfolioResponse>;
+    getPortfolio(account: AccountRef, currency?: string, priceQuality?: '1' | '2', maxEntries?: number): Promise<PortfolioResponse>;
     /**
      * Continues the portfolio fetching when a TAN is required
      * @param tanReference The TAN reference provided in the first call's response
@@ -106,19 +108,19 @@ export declare class FinTSClient {
     getPortfolioWithTan(tanReference: string, tan?: string): Promise<PortfolioResponse>;
     /**
      * Checks if the bank supports fetching credit card statements in general or for the given account number
-     * @param accountNumber when the account number is provided, checks if the account supports fetching of statements
+     * @param account when the account number is provided, checks if the account supports fetching of statements
      * @returns true if the bank (and account) supports fetching credit card statements
      */
-    canGetCreditCardStatements(accountNumber?: string): boolean;
+    canGetCreditCardStatements(account?: AccountRef): boolean;
     /**
      * Fetches the credit card statements for the given account number
-     * @param accountNumber - the account number to fetch the statements for, must be a credit card account available
+     * @param account - the account number to fetch the statements for, must be a credit card account available
      * in the config.baningInformation.UPD.accounts
      * @param from - an optional start date of the period to fetch the statements for
      * @param to - an optional end date of the period to fetch the statements for
      * @returns an account statements response containing an array of statements
      */
-    getCreditCardStatements(accountNumber: string, from?: Date): Promise<StatementResponse>;
+    getCreditCardStatements(account: AccountRef, from?: Date): Promise<StatementResponse>;
     /**
      * Continues the credit card statements fetching when a TAN is required
      * @param tanReference The TAN reference provided in the first call's response
@@ -126,6 +128,33 @@ export declare class FinTSClient {
      * @returns a credit card statements response containing an array of statements
      */
     getCreditCardStatementsWithTan(tanReference: string, tan?: string): Promise<StatementResponse>;
+    /**
+     * Checks if the bank supports fetching electronic account statements in general or for the given account number
+     * @param account when the account number is provided, checks if the account supports fetching of electronic statements
+     * @returns true if the bank (and account) supports fetching electronic account statements
+     */
+    canGetElectronicStatements(account?: AccountRef): boolean;
+    /**
+     * Fetches an electronic account statement (Elektronischer Kontoauszug) for the given account number
+     *
+     * This returns the statement document the bank files in the customer's electronic mailbox,
+     * usually a PDF, not a list of transactions. The bank hands out one statement per call and
+     * announces a waiting successor in `nextOffset`; pass that value back in `options.offset` to
+     * fetch the next one. Banks that set `receiptRequired` in their HIEKAS parameters keep
+     * offering a statement until it has been acknowledged with its receipt.
+     *
+     * @param account - the account number to fetch the statement for, must be an account available in the config.bankingInformation.upd.accounts
+     * @param options - optional format, statement number and year, entry limit and offset
+     * @returns a response containing the statement documents and the offset of a waiting successor
+     */
+    getElectronicStatements(account: AccountRef, options?: ElectronicStatementOptions): Promise<ElectronicStatementResponse>;
+    /**
+     * Continues the electronic account statement fetching when a TAN is required
+     * @param tanReference The TAN reference provided in the first call's response
+     * @param tan The TAN entered by the user, can be omitted if a decoupled TAN method is used
+     * @returns a response containing the statement documents
+     */
+    getElectronicStatementsWithTan(tanReference: string, tan?: string): Promise<ElectronicStatementResponse>;
     private startCustomerOrderInteraction;
     private continueCustomerInteractionWithTan;
 }

package/dist/types/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EACN,KAAK,sBAAsB,EAE3B,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,EAGX,iBAAiB,EACjB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAEN,KAAK,iBAAiB,EACtB,MAAM,wCAAwC,CAAC;AAShD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,mBAAoB,SAAQ,YAAY;CAAG;AAE5D;;GAEG;AACH,qBAAa,WAAW;IAOJ,MAAM,EAAE,WAAW;IANtC,OAAO,CAAC,aAAa,CAAqB;IAE1C;;;OAGG;gBACgB,MAAM,EAAE,WAAW;IAUtC;;;;OAIG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAI/C;;;OAGG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAI1C;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAMjD;;;;;OAKG;IACG,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI1F;;;;OAIG;IACH,oBAAoB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO;IAMrD;;;;OAIG;IACG,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAO/E;;;;;OAKG;IACG,wBAAwB,CAC7B,YAAY,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE,MAAM,GACV,OAAO,CAAC,sBAAsB,CAAC;IAQlC;;;;OAIG;IACH,uBAAuB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO;IAexD;;;;;;;OAOG;IACG,oBAAoB,CACzB,aAAa,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,IAAI,EACX,EAAE,CAAC,EAAE,IAAI,EACT,UAAU,GAAE,OAAc,GACxB,OAAO,CAAC,iBAAiB,CAAC;IAuB7B;;;;;OAKG;IACG,2BAA2B,CAChC,YAAY,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,CAAC;IAQ7B;;;;OAIG;IACH,eAAe,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO;IAMhD;;;;;;;OAOG;IACG,YAAY,CACjB,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,GAAG,GAAG,GAAG,EACxB,UAAU,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAM7B;;;;;;OAMG;IACG,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQzF;;;;OAIG;IACH,0BAA0B,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO;IAM3D;;;;;;;OAOG;IACG,uBAAuB,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAM7F;;;;;OAKG;IACG,8BAA8B,CACnC,YAAY,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,CAAC;YAQf,6BAA6B;YAsB7B,kCAAkC;CA2BhD"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/types/config.d.ts

@@ -1,4 +1,4 @@
-import type { BankAccount } from './bankAccount.js';
+import type { AccountRef, BankAccount } from './bankAccount.js';
 import type { BankingInformation } from './bankingInformation.js';
 import type { TanMethod } from './tanMethod.js';
 /**
@@ -86,21 +86,42 @@ export declare class FinTSConfig {
      * @param transId The transaction ID
      */
     isTransactionSupported(transId: string): boolean;
+    /**
+     * The account the bank meant, without demanding that it be unambiguous.
+     *
+     * For entries the *bank* supplied — a SEPA account from HISPA, say — rather than
+     * ones a caller asked for. A caller who names an ambiguous account has made a
+     * mistake worth an exception; a bank listing its own accounts has not, and
+     * throwing there would break every dialog at an institution that shares numbers.
+     *
+     * @param account An account number with, where the bank gave one, its sub-account id
+     */
+    matchBankAccount(account: {
+        accountNumber: string;
+        subAccountId?: string;
+    }): BankAccount | undefined;
     /**
      * Checks if a transaction is supported for a specific account
-     * @param accountNumber The account number
+     * @param account An account number, or an account from `bankingInformation.upd.bankAccounts`
      * @param transId The transaction ID
      */
-    isAccountTransactionSupported(accountNumber: string, transId: string): boolean;
+    isAccountTransactionSupported(account: AccountRef, transId: string): boolean;
     /**
      * Gets the maximum supported transaction version of a transaction, considering this client's support and the bank's support
      * @param transId The transaction ID
      */
     getMaxSupportedTransactionVersion(transId: string): number | undefined;
     /**
-     * Gets the bank account information for a specific account number
-     * @param accountNumber The account number
+     * Resolves an account reference against the accounts the bank reported.
+     *
+     * A number alone is enough wherever it is unique, which is the usual case. Where
+     * it is not, this throws instead of picking one: FinTS identifies an account by
+     * number *and* sub-account id, so a number that matches two accounts does not say
+     * which one is meant, and answering for the wrong one produces a balance or a list
+     * of transactions that belongs to a different account with nothing to indicate it.
+     *
+     * @param account An account number, or an account from `bankingInformation.upd.bankAccounts`
      */
-    getBankAccount(accountNumber: string): BankAccount;
+    getBankAccount(account: AccountRef): BankAccount;
 }
 //# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;GAEG;AACH,qBAAa,WAAW;IAKf,SAAS,EAAE,MAAM;IACjB,cAAc,EAAE,MAAM;IAC7B,OAAO,CAAC,GAAG,CAAC;IACZ,OAAO,CAAC,kBAAkB,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM;IACf,GAAG,CAAC,EAAE,MAAM;IAEZ,WAAW,CAAC,EAAE,MAAM;IACpB,YAAY,CAAC,EAAE,MAAM;IACrB,UAAU,CAAC,EAAE,MAAM;IAC1B,OAAO,CAAC,OAAO;IAdhB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,YAAY,UAAS;IAErB,OAAO;IA+CP;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,eAAe,CACrB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,GAAE,MAAY,GACvB,WAAW;IAgBd;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,sBAAsB,CAC5B,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,kBAAkB,EACtC,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,GAAE,MAAY,GACvB,WAAW;IAgBd;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,IAAI,mBAAmB,IAAI,SAAS,EAAE,CAMrC;IAED;;;OAGG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAU/C;;;OAGG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM;IAcnC;;OAEG;IACH,IAAI,iBAAiB,IAAI,SAAS,GAAG,SAAS,CAE7C;IAED;;;;OAIG;IACH,wBAAwB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAO3D;;;OAGG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAOhD;;;;OAIG;IACH,6BAA6B,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAK9E;;;OAGG;IACH,iCAAiC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAgBtE;;;OAGG;IACH,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW;CAWlD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;GAEG;AACH,qBAAa,WAAW;IAKf,SAAS,EAAE,MAAM;IACjB,cAAc,EAAE,MAAM;IAC7B,OAAO,CAAC,GAAG,CAAC;IACZ,OAAO,CAAC,kBAAkB,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM;IACf,GAAG,CAAC,EAAE,MAAM;IAEZ,WAAW,CAAC,EAAE,MAAM;IACpB,YAAY,CAAC,EAAE,MAAM;IACrB,UAAU,CAAC,EAAE,MAAM;IAC1B,OAAO,CAAC,OAAO;IAdhB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,YAAY,UAAS;IAErB,OAAO;IA+CP;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,eAAe,CACrB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,GAAE,MAAY,GACvB,WAAW;IAgBd;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,sBAAsB,CAC5B,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,kBAAkB,EACtC,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,GAAE,MAAY,GACvB,WAAW;IAgBd;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,IAAI,mBAAmB,IAAI,SAAS,EAAE,CAMrC;IAED;;;OAGG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAU/C;;;OAGG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM;IAcnC;;OAEG;IACH,IAAI,iBAAiB,IAAI,SAAS,GAAG,SAAS,CAE7C;IAED;;;;OAIG;IACH,wBAAwB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAO3D;;;OAGG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAOhD;;;;;;;;;OASG;IACH,gBAAgB,CAAC,OAAO,EAAE;QACzB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,WAAW,GAAG,SAAS;IAiB3B;;;;OAIG;IACH,6BAA6B,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAK5E;;;OAGG;IACH,iCAAiC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAgBtE;;;;;;;;;;OAUG;IACH,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,WAAW;CAqChD"}

package/dist/types/dataElements/Binary.d.ts

@@ -3,6 +3,13 @@ export declare class Binary extends DataElement {
     maxLength?: number | undefined;
     constructor(name: string, minCount?: number, maxCount?: number, maxLength?: number | undefined, minVersion?: number, maxVersion?: number);
     encode(value: string): string;
+    /**
+     * A binary value arrives as `@<length>@<data>`. The length is authoritative: it is the
+     * only thing that tells data apart from the separators and escape characters that a
+     * binary payload — a PDF, for instance — is full of. Returning everything after the
+     * second `@` instead would hand out whatever the bank appended between the end of the
+     * data and the next separator.
+     */
     decode(text: string): string;
 }
 //# sourceMappingURL=Binary.d.ts.map

package/dist/types/dataElements/Binary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Binary.d.ts","sourceRoot":"","sources":["../../../src/dataElements/Binary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,qBAAa,MAAO,SAAQ,WAAW;IAK9B,SAAS,CAAC,EAAE,MAAM;gBAHzB,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAI,EACZ,QAAQ,SAAI,EACL,SAAS,CAAC,EAAE,MAAM,YAAA,EACzB,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM;IAKpB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAY7B,MAAM,CAAC,IAAI,EAAE,MAAM;CAGnB"}
+{"version":3,"file":"Binary.d.ts","sourceRoot":"","sources":["../../../src/dataElements/Binary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,qBAAa,MAAO,SAAQ,WAAW;IAK9B,SAAS,CAAC,EAAE,MAAM;gBAHzB,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAI,EACZ,QAAQ,SAAI,EACL,SAAS,CAAC,EAAE,MAAM,YAAA,EACzB,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM;IAKpB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAY7B;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM;CAgBnB"}

package/dist/types/dialog.d.ts

@@ -19,6 +19,20 @@ export declare class Dialog {
     private createCurrentCustomerMessage;
     private createCurrentTanMessage;
     private getTanMediaName;
+    /**
+     * Collects a response that the bank spreads over several messages.
+     *
+     * When the bank cannot fit a response into one message it answers with code 3040 plus
+     * a continuation mark. Repeating the order with that mark yields the next portion —
+     * as a COMPLETE, self-contained response segment, not as a byte-wise continuation of
+     * the previous one. A HICAZ follow-up, for example, repeats the account and the CAMT
+     * descriptor before carrying its own share of the statements.
+     *
+     * Every portion is therefore decoded on its own and all of them are placed into the
+     * response message the caller holds. Combining their payloads needs to know what the
+     * payload means — one MT940 stream continues, a list of CAMT documents is appended —
+     * so that step belongs to the interaction, which does it via `findAllSegments`.
+     */
     private handlePartedMessages;
     private checkEnded;
     private getHttpClient;

package/dist/types/dialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../src/dialog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAExB,MAAM,uCAAuC,CAAC;AAW/C,qBAAa,MAAM;IAWV,MAAM,EAAE,WAAW;IAV3B,QAAQ,EAAE,MAAM,CAAO;IACvB,iBAAiB,SAAK;IACtB,YAAY,EAAE,mBAAmB,EAAE,CAAM;IACzC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAa;IACnD,uBAAuB,SAAK;IAC5B,aAAa,UAAS;IACtB,QAAQ,UAAS;IACjB,UAAU,EAAE,UAAU,CAAC;gBAGf,MAAM,EAAE,WAAW,EAC1B,YAAY,GAAE,OAAe;IAc9B,IAAI,kBAAkB,IAAI,mBAAmB,CAE5C;IAEK,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAyC7C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAmD7F,sBAAsB,CAAC,WAAW,EAAE,mBAAmB,EAAE,YAAY,UAAQ,GAAG,IAAI;IAuBpF,OAAO,CAAC,4BAA4B;IAuDpC,OAAO,CAAC,uBAAuB;IAiC/B,OAAO,CAAC,eAAe;YAeT,oBAAoB;IAoDlC,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,aAAa;CAGrB"}
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../src/dialog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAExB,MAAM,uCAAuC,CAAC;AAW/C,qBAAa,MAAM;IAWV,MAAM,EAAE,WAAW;IAV3B,QAAQ,EAAE,MAAM,CAAO;IACvB,iBAAiB,SAAK;IACtB,YAAY,EAAE,mBAAmB,EAAE,CAAM;IACzC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAa;IACnD,uBAAuB,SAAK;IAC5B,aAAa,UAAS;IACtB,QAAQ,UAAS;IACjB,UAAU,EAAE,UAAU,CAAC;gBAGf,MAAM,EAAE,WAAW,EAC1B,YAAY,GAAE,OAAe;IAc9B,IAAI,kBAAkB,IAAI,mBAAmB,CAE5C;IAEK,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAyC7C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAmD7F,sBAAsB,CAAC,WAAW,EAAE,mBAAmB,EAAE,YAAY,UAAQ,GAAG,IAAI;IAuBpF,OAAO,CAAC,4BAA4B;IAuDpC,OAAO,CAAC,uBAAuB;IAiC/B,OAAO,CAAC,eAAe;IAevB;;;;;;;;;;;;;OAaG;YACW,oBAAoB;IA8DlC,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,aAAa;CAGrB"}

package/dist/types/electronicStatement.d.ts

@@ -0,0 +1,40 @@
+/**
+ * An electronic account statement (Elektronischer Kontoauszug) as handed out by the bank.
+ *
+ * Unlike {@link Statement} this is not a list of parsed transactions but the statement
+ * document itself — the same document the bank files in the customer's electronic mailbox,
+ * usually a PDF.
+ */
+export type ElectronicStatement = {
+    /** The format of {@link document}, as announced by the bank in the HIEKAS parameters */
+    format: string;
+    /** Start of the period the statement covers */
+    from?: Date;
+    /** End of the period the statement covers */
+    to?: Date;
+    /** The date the statement was created by the bank */
+    date?: Date;
+    /** The year the statement number refers to, statement numbers restart every year */
+    year?: number;
+    /** The sequential number of the statement within its year */
+    number?: number;
+    /** The statement document itself */
+    document: Uint8Array;
+    /** Information about the closing of the accounting period, when the bank provides it */
+    closingInfo?: string;
+    /** Information about the conditions of the account, when the bank provides it */
+    conditionsInfo?: string;
+    /** Advertising text, when the bank provides it */
+    advertisement?: string;
+    iban?: string;
+    bic?: string;
+    /** The account holder's name, joined from the up to three name lines the bank sends */
+    accountName?: string;
+    /**
+     * The receipt for this statement. When the bank requires acknowledgement
+     * (`receiptRequired` in the HIEKAS parameters), it only stops handing out a statement
+     * once it has been acknowledged with this receipt.
+     */
+    receipt?: string;
+};
+//# sourceMappingURL=electronicStatement.d.ts.map

package/dist/types/electronicStatement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"electronicStatement.d.ts","sourceRoot":"","sources":["../../src/electronicStatement.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG;IACjC,wFAAwF;IACxF,MAAM,EAAE,MAAM,CAAC;IAEf,+CAA+C;IAC/C,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,6CAA6C;IAC7C,EAAE,CAAC,EAAE,IAAI,CAAC;IAEV,qDAAqD;IACrD,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,oCAAoC;IACpC,QAAQ,EAAE,UAAU,CAAC;IAErB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/dist/types/index.d.ts

@@ -6,14 +6,17 @@ export * from './bpd.js';
 export * from './client.js';
 export * from './config.js';
 export * from './dialog.js';
+export * from './electronicStatement.js';
 export * from './httpClient.js';
 export { AccountBalanceResponse } from './interactions/balanceInteraction.js';
 export { ClientResponse, StatementResponse } from './interactions/customerInteraction.js';
+export { ElectronicStatementOptions, ElectronicStatementResponse, } from './interactions/electronicStatementInteraction.js';
 export { PortfolioResponse } from './interactions/portfolioInteraction.js';
 export * from './message.js';
 export * from './mt535parser.js';
 export * from './mt940parser.js';
 export * from './segment.js';
+export { StatementFormat } from './segments/HKEKA.js';
 export * from './statement.js';
 export * from './upd.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1F,OAAO,EACN,0BAA0B,EAC1B,2BAA2B,GAC3B,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC"}

package/dist/types/interactions/balanceInteraction.d.ts

@@ -1,4 +1,5 @@
 import type { AccountBalance } from '../accountBalance.js';
+import { type AccountRef } from '../bankAccount.js';
 import type { FinTSConfig } from '../config.js';
 import type { Message } from '../message.js';
 import type { Segment } from '../segment.js';
@@ -7,8 +8,8 @@ export interface AccountBalanceResponse extends ClientResponse {
     balance?: AccountBalance;
 }
 export declare class BalanceInteraction extends CustomerOrderInteraction {
-    accountNumber: string;
-    constructor(accountNumber: string);
+    account: AccountRef;
+    constructor(account: AccountRef);
     createSegments(init: FinTSConfig): Segment[];
     handleResponse(response: Message, clientResponse: AccountBalanceResponse): void;
 }

package/dist/types/interactions/balanceInteraction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"balanceInteraction.d.ts","sourceRoot":"","sources":["../../../src/interactions/balanceInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EAAE,KAAK,cAAc,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEzF,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC7D,OAAO,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,qBAAa,kBAAmB,SAAQ,wBAAwB;IAC5C,aAAa,EAAE,MAAM;gBAArB,aAAa,EAAE,MAAM;IAIxC,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,EAAE;IA0B5C,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,sBAAsB;CAaxE"}
+{"version":3,"file":"balanceInteraction.d.ts","sourceRoot":"","sources":["../../../src/interactions/balanceInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,KAAK,UAAU,EAAmB,MAAM,mBAAmB,CAAC;AAErE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EAAE,KAAK,cAAc,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEzF,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC7D,OAAO,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,qBAAa,kBAAmB,SAAQ,wBAAwB;IAC5C,OAAO,EAAE,UAAU;gBAAnB,OAAO,EAAE,UAAU;IAItC,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,EAAE;IA0B5C,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,sBAAsB;CAaxE"}