lib-fints 1.4.0 → 1.4.1

package/dist/client.js

@@ -62,8 +62,7 @@ export class FinTSClient {
      * @returns the synchronization response
      */
     async synchronizeWithTan(tanReference, tan) {
-        const responses = await this.continueCustomerInteractionWithTan(tanReference, tan);
-        return responses.get(HKIDN.Id);
+        return await this.continueCustomerInteractionWithTan([HKIDN.Id], tanReference, tan);
     }
     /**
      * Checks if the bank supports fetching an account balance in general or for the given account number when provided
@@ -81,8 +80,8 @@ export class FinTSClient {
      * @returns the account balance response
      */
     async getAccountBalance(accountNumber) {
-        const responses = await this.startCustomerOrderInteraction(new BalanceInteraction(accountNumber));
-        return responses.get(HKSAL.Id);
+        const response = await this.startCustomerOrderInteraction(new BalanceInteraction(accountNumber));
+        return response;
     }
     /**
      * Continues the account balance fetching when a TAN is required
@@ -91,8 +90,7 @@ export class FinTSClient {
      * @returns the account balance response
      */
     async getAccountBalanceWithTan(tanReference, tan) {
-        const responses = await this.continueCustomerInteractionWithTan(tanReference, tan);
-        return responses.get(HKSAL.Id);
+        return (await this.continueCustomerInteractionWithTan([HKSAL.Id], tanReference, tan));
     }
     /**
      * Checks if the bank supports fetching account statements in general or for the given account number when provided
@@ -128,12 +126,10 @@ export class FinTSClient {
         // Choose format based on support and preference
         const useCAMT = (preferCamt && camtSupported) || (!mt940Supported && camtSupported);
         if (useCAMT) {
-            const responses = await this.startCustomerOrderInteraction(new StatementInteractionCAMT(accountNumber, from, to));
-            return responses.get(HKCAZ.Id);
+            return (await this.startCustomerOrderInteraction(new StatementInteractionCAMT(accountNumber, from, to)));
         }
         else {
-            const responses = await this.startCustomerOrderInteraction(new StatementInteractionMT940(accountNumber, from, to));
-            return responses.get(HKKAZ.Id);
+            return (await this.startCustomerOrderInteraction(new StatementInteractionMT940(accountNumber, from, to)));
         }
     }
     /**
@@ -143,8 +139,7 @@ export class FinTSClient {
      * @returns an account statements response containing an array of statements
      */
     async getAccountStatementsWithTan(tanReference, tan) {
-        const responses = await this.continueCustomerInteractionWithTan(tanReference, tan);
-        return responses.get(HKKAZ.Id);
+        return (await this.continueCustomerInteractionWithTan([HKCAZ.Id, HKKAZ.Id], tanReference, tan));
     }
     /**
      * Checks if the bank supports fetching portfolio information in general or for the given account number when provided
@@ -165,19 +160,17 @@ export class FinTSClient {
      * @returns a portfolio response containing holdings and total value
      */
     async getPortfolio(accountNumber, currency, priceQuality, maxEntries) {
-        const responses = await this.startCustomerOrderInteraction(new PortfolioInteraction(accountNumber, currency, priceQuality, maxEntries));
-        return responses.get(HKWPD.Id);
+        return (await this.startCustomerOrderInteraction(new PortfolioInteraction(accountNumber, currency, priceQuality, maxEntries)));
     }
     /**
-     * Continues the portfolio 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 portfolio response containing holdings and total value
-     */
+       * Continues the portfolio 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 portfolio response containing holdings and total value
+       */
     async getPortfolioWithTan(tanReference, tan) {
-        const responses = await this.continueCustomerInteractionWithTan(tanReference, tan);
-        return responses.get(HKWPD.Id);
+        return (await this.continueCustomerInteractionWithTan([HKWPD.Id], tanReference, tan));
     }
     /**
      * Checks if the bank supports fetching credit card statements in general or for the given account number
@@ -198,8 +191,7 @@ export class FinTSClient {
      * @returns an account statements response containing an array of statements
      */
     async getCreditCardStatements(accountNumber, from) {
-        const responses = await this.startCustomerOrderInteraction(new CreditCardStatementInteraction(accountNumber, from));
-        return responses.get(DKKKU.Id);
+        return (await this.startCustomerOrderInteraction(new CreditCardStatementInteraction(accountNumber, from)));
     }
     /**
      * Continues the credit card statements fetching when a TAN is required
@@ -208,18 +200,31 @@ export class FinTSClient {
      * @returns a credit card statements response containing an array of statements
      */
     async getCreditCardStatementsWithTan(tanReference, tan) {
-        const responses = await this.continueCustomerInteractionWithTan(tanReference, tan);
-        return responses.get(DKKKU.Id);
+        return (await this.continueCustomerInteractionWithTan([DKKKU.Id], tanReference, tan));
     }
     async startCustomerOrderInteraction(interaction) {
         this.currentDialog = new Dialog(this.config, false);
         this.currentDialog.addCustomerInteraction(interaction);
-        return await this.currentDialog.start();
+        const responses = await this.currentDialog.start();
+        const response = responses.get(interaction.segId);
+        if (response) {
+            return response;
+        }
+        else {
+            return [...responses.values()].at(-1);
+        }
     }
-    async continueCustomerInteractionWithTan(tanReference, tan) {
+    async continueCustomerInteractionWithTan(segIds, tanReference, tan) {
         if (!this.currentDialog) {
             throw new Error('no customer dialog was started which can continue');
         }
-        return await this.currentDialog.continue(tanReference, tan);
+        const responses = await this.currentDialog.continue(tanReference, tan);
+        for (const segId of segIds) {
+            const response = responses.get(segId);
+            if (response) {
+                return response;
+            }
+        }
+        return [...responses.values()].at(-1);
     }
 }

package/dist/tests/client.test.js

@@ -2,7 +2,100 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { FinTSClient } from '../client.js';
 import { Dialog } from '../dialog.js';
 import { FinTSConfig } from '../config.js';
+import { Language } from '../codes.js';
+import { AccountType } from '../bankAccount.js';
 describe('FinTSClient', () => {
+    const client = new FinTSClient(FinTSConfig.fromBankingInformation('product', '1.0', {
+        systemId: 'SYSTEM01',
+        bpd: {
+            version: 1,
+            url: 'https://bank.example.com/fints',
+            countryCode: 280,
+            bankId: '10020030',
+            bankName: 'Example Bank',
+            allowedTransactions: [
+                { transId: 'HKSAL', versions: [6, 7], tanRequired: false },
+                { transId: 'HKCAZ', versions: [1], tanRequired: false },
+                { transId: 'HKKAZ', versions: [6], tanRequired: true },
+                { transId: 'HKWPD', versions: [7], tanRequired: true },
+                { transId: 'DKKKU', versions: [2], tanRequired: false },
+            ],
+            maxTransactionsPerMessage: 1,
+            supportedLanguages: [Language.German],
+            supportedHbciVersions: [300],
+            supportedTanMethods: [
+                {
+                    id: 1,
+                    name: 'ChipTAN',
+                    version: 1,
+                    isDecoupled: false,
+                    activeTanMediaCount: 1,
+                    activeTanMedia: ['TAN-Generator 123'],
+                    tanMediaRequirement: 0,
+                },
+                {
+                    id: 2,
+                    name: 'pushTAN',
+                    version: 1,
+                    isDecoupled: true,
+                    activeTanMediaCount: 1,
+                    activeTanMedia: ['Mobile App'],
+                    tanMediaRequirement: 1,
+                },
+            ],
+            availableTanMethodIds: [1, 2],
+        },
+        upd: {
+            version: 1,
+            usage: 0,
+            bankAccounts: [
+                {
+                    accountNumber: '1234567890',
+                    bank: {
+                        bankId: '10020030',
+                        country: 280,
+                    },
+                    iban: 'DE89370400440532013000',
+                    customerId: 'customer1',
+                    accountType: AccountType.CheckingAccount,
+                    currency: 'EUR',
+                    holder1: 'Test User',
+                    allowedTransactions: [
+                        { transId: 'HKSAL', numSignatures: 1 },
+                        { transId: 'HKCAZ', numSignatures: 1 },
+                        { transId: 'HKKAZ', numSignatures: 1 },
+                    ],
+                },
+                {
+                    accountNumber: '9876543210',
+                    bank: {
+                        bankId: '10020030',
+                        country: 280,
+                    },
+                    iban: 'DE89370400440532013001',
+                    customerId: 'customer1',
+                    accountType: AccountType.SecuritiesAccount,
+                    currency: 'EUR',
+                    holder1: 'Test User',
+                    allowedTransactions: [{ transId: 'HKWPD', numSignatures: 1 }],
+                },
+                {
+                    accountNumber: '1111222233',
+                    bank: {
+                        bankId: '10020030',
+                        country: 280,
+                    },
+                    iban: 'DE89370400440532013002',
+                    customerId: 'customer1',
+                    accountType: AccountType.CreditCardAccount,
+                    currency: 'EUR',
+                    holder1: 'Test User',
+                    allowedTransactions: [{ transId: 'DKKKU', numSignatures: 1 }],
+                },
+            ],
+        },
+        bankMessages: [],
+    }));
     let dialogStartMock;
     let dialogContinueMock;
     beforeEach(() => {
@@ -13,26 +106,547 @@ describe('FinTSClient', () => {
         dialogStartMock.mockRestore();
         dialogContinueMock.mockRestore();
     });
-    it('sends a message', async () => {
-        const client = new FinTSClient(FinTSConfig.forFirstTimeUse('product', '1.0', 'http://localhost', '12030000', 'user'));
-        dialogStartMock.mockResolvedValueOnce(new Map([
-            [
-                'HKIDN',
-                {
-                    dialogId: 'DIALOG1',
-                    success: true,
-                    requiresTan: false,
-                    bankingInformationUpdated: true,
-                    bankingInformation: { systemId: 'SYSTEM01', bankMessages: [] },
-                    bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
-                },
-            ],
-        ]));
-        const response = await client.synchronize();
-        expect(response.success).toBe(true);
-        expect(response.requiresTan).toBe(false);
-        expect(response.bankingInformation).toBeDefined();
-        expect(dialogStartMock).toHaveBeenCalledOnce();
-        expect(dialogContinueMock).toHaveBeenCalledTimes(0);
+    describe('getAccountBalance', () => {
+        it('returns balance response when no TAN is required', async () => {
+            dialogStartMock.mockResolvedValueOnce(new Map([
+                [
+                    'HKIDN',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                    },
+                ],
+                [
+                    'HKSAL',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                        balance: { date: new Date('2025-12-23'), currency: 'EUR', balance: 1000.0 },
+                    },
+                ],
+                [
+                    'HKEND',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 100, text: 'Dialog beendet' }],
+                    },
+                ],
+            ]));
+            const response = (await client.getAccountBalance('1234567890'));
+            expect(response.success).toBe(true);
+            expect(response.requiresTan).toBe(false);
+            expect(response.balance).toBeDefined();
+            expect(dialogStartMock).toHaveBeenCalledOnce();
+            expect(dialogContinueMock).toHaveBeenCalledTimes(0);
+        });
+        it('returns init dialog response when TAN is required', async () => {
+            dialogStartMock.mockResolvedValueOnce(new Map([
+                [
+                    'HKIDN',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: true,
+                        tanReference: 'TANREF123',
+                        tanChallenge: 'Bitte geben Sie Ihre TAN ein.',
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                    },
+                ],
+            ]));
+            const response = (await client.getAccountBalance('1234567890'));
+            expect(response.success).toBe(true);
+            expect(response.requiresTan).toBe(true);
+            expect(response.tanReference).toBe('TANREF123');
+            expect(dialogStartMock).toHaveBeenCalledOnce();
+            expect(dialogContinueMock).toHaveBeenCalledTimes(0);
+        });
+    });
+    describe('getAccountBalanceWithTan', () => {
+        it('returns balance response when TAN is provided', async () => {
+            dialogContinueMock.mockResolvedValueOnce(new Map([
+                [
+                    'HKSAL',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                        balance: { date: new Date('2025-12-23'), currency: 'EUR', balance: 2500.0 },
+                    },
+                ],
+                [
+                    'HKEND',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 100, text: 'Dialog beendet' }],
+                    },
+                ],
+            ]));
+            const response = (await client.getAccountBalanceWithTan('TANREF123', '123456'));
+            expect(response.success).toBe(true);
+            expect(response.requiresTan).toBe(false);
+            expect(response.balance).toBeDefined();
+            expect(response.balance.balance).toBe(2500.0);
+            expect(dialogContinueMock).toHaveBeenCalledWith('TANREF123', '123456');
+        });
+    });
+    describe('synchronize', () => {
+        it('returns synchronization response when no TAN is required', async () => {
+            dialogStartMock.mockResolvedValueOnce(new Map([
+                [
+                    'HKIDN',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: true,
+                        bankAnswers: [{ code: 20, text: 'Synchronisierung erfolgreich' }],
+                    },
+                ],
+                [
+                    'HKEND',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 100, text: 'Dialog beendet' }],
+                    },
+                ],
+            ]));
+            const response = await client.synchronize();
+            expect(response.success).toBe(true);
+            expect(response.requiresTan).toBe(false);
+            expect(response.bankingInformationUpdated).toBe(true);
+            expect(dialogStartMock).toHaveBeenCalledOnce();
+        });
+        it('returns sync response requiring TAN', async () => {
+            dialogStartMock.mockResolvedValueOnce(new Map([
+                [
+                    'HKIDN',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: true,
+                        tanReference: 'SYNCTAN123',
+                        tanChallenge: 'TAN für Synchronisation eingeben.',
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 3955, text: 'TAN erforderlich' }],
+                    },
+                ],
+            ]));
+            const response = await client.synchronize();
+            expect(response.success).toBe(true);
+            expect(response.requiresTan).toBe(true);
+            expect(response.tanReference).toBe('SYNCTAN123');
+            expect(response.tanChallenge).toBe('TAN für Synchronisation eingeben.');
+        });
+    });
+    describe('synchronizeWithTan', () => {
+        it('completes synchronization with TAN', async () => {
+            dialogContinueMock.mockResolvedValueOnce(new Map([
+                [
+                    'HKIDN',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: true,
+                        bankAnswers: [{ code: 20, text: 'Synchronisierung erfolgreich' }],
+                    },
+                ],
+                [
+                    'HKEND',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 100, text: 'Dialog beendet' }],
+                    },
+                ],
+            ]));
+            const response = await client.synchronizeWithTan('SYNCTAN123', '789012');
+            expect(response.success).toBe(true);
+            expect(response.requiresTan).toBe(false);
+            expect(response.bankingInformationUpdated).toBe(true);
+            expect(dialogContinueMock).toHaveBeenCalledWith('SYNCTAN123', '789012');
+        });
+    });
+    describe('getAccountStatements', () => {
+        it('fetches statements using CAMT format when available and preferred', async () => {
+            dialogStartMock.mockResolvedValueOnce(new Map([
+                [
+                    'HKIDN',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                    },
+                ],
+                [
+                    'HKCAZ',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                        statements: [
+                            {
+                                account: '1234567890',
+                                transactions: [],
+                                openingBalance: { date: new Date('2025-12-01'), currency: 'EUR', value: 500.0 },
+                                closingBalance: { date: new Date('2025-12-23'), currency: 'EUR', value: 1500.0 },
+                            },
+                        ],
+                    },
+                ],
+                [
+                    'HKEND',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 100, text: 'Dialog beendet' }],
+                    },
+                ],
+            ]));
+            const response = (await client.getAccountStatements('1234567890'));
+            expect(response.success).toBe(true);
+            expect(response.statements).toBeDefined();
+            expect(response.statements.length).toBe(1);
+            expect(response.statements[0].account).toBe('1234567890');
+        });
+        it('throws error when account does not support statements', async () => {
+            await expect(client.getAccountStatements('9999999999')).rejects.toThrow('Account 9999999999 not found in UPD');
+        });
+        it('uses MT940 when preferCamt is false', async () => {
+            dialogStartMock.mockResolvedValueOnce(new Map([
+                [
+                    'HKIDN',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                    },
+                ],
+                [
+                    'HKKAZ',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                        statements: [
+                            {
+                                account: '1234567890',
+                                transactions: [],
+                                openingBalance: { date: new Date('2025-12-01'), currency: 'EUR', value: 500.0 },
+                                closingBalance: { date: new Date('2025-12-23'), currency: 'EUR', value: 1500.0 },
+                            },
+                        ],
+                    },
+                ],
+                [
+                    'HKEND',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 100, text: 'Dialog beendet' }],
+                    },
+                ],
+            ]));
+            const response = (await client.getAccountStatements('1234567890', undefined, undefined, false));
+            expect(response.success).toBe(true);
+            expect(response.statements).toBeDefined();
+            expect(response.statements.length).toBe(1);
+            expect(response.statements[0].account).toBe('1234567890');
+        });
+    });
+    describe('getAccountStatementsWithTan', () => {
+        it('continues statement fetching with TAN', async () => {
+            dialogContinueMock.mockResolvedValueOnce(new Map([
+                [
+                    'HKCAZ',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                        statements: [
+                            {
+                                account: '1234567890',
+                                transactions: [],
+                                openingBalance: { date: new Date('2025-12-01'), currency: 'EUR', value: 500.0 },
+                                closingBalance: { date: new Date('2025-12-23'), currency: 'EUR', value: 1500.0 },
+                            },
+                        ],
+                    },
+                ],
+            ]));
+            const response = (await client.getAccountStatementsWithTan('STATEMENTTAN123', '456789'));
+            expect(response.success).toBe(true);
+            expect(response.statements).toBeDefined();
+            expect(dialogContinueMock).toHaveBeenCalledWith('STATEMENTTAN123', '456789');
+        });
+    });
+    describe('getPortfolio', () => {
+        it('fetches portfolio information', async () => {
+            dialogStartMock.mockResolvedValueOnce(new Map([
+                [
+                    'HKIDN',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                    },
+                ],
+                [
+                    'HKWPD',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                        portfolioStatement: {
+                            currency: 'EUR',
+                            holdings: [
+                                {
+                                    isin: 'DE0001234567',
+                                    price: 25.5,
+                                    currency: 'EUR',
+                                },
+                            ],
+                            totalValue: 2550.0,
+                        },
+                    },
+                ],
+            ]));
+            const response = (await client.getPortfolio('9876543210'));
+            expect(response.success).toBe(true);
+            expect(response.portfolioStatement?.holdings).toBeDefined();
+            expect(response.portfolioStatement.holdings.length).toBe(1);
+            expect(response.portfolioStatement.totalValue).toBe(2550.0);
+        });
+        it('fetches portfolio with optional parameters', async () => {
+            dialogStartMock.mockResolvedValueOnce(new Map([
+                [
+                    'HKIDN',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                    },
+                ],
+                [
+                    'HKWPD',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                        portfolioStatement: {
+                            currency: 'EUR',
+                            holdings: [
+                                {
+                                    isin: 'DE0001234567',
+                                    price: 25.5,
+                                },
+                            ],
+                            totalValue: 1000.0,
+                        },
+                    },
+                ],
+            ]));
+            const response = (await client.getPortfolio('9876543210', 'EUR', '1', 10));
+            expect(response.success).toBe(true);
+            expect(response.portfolioStatement.holdings).toBeDefined();
+            expect(response.portfolioStatement.holdings.length).toBe(1);
+            expect(response.portfolioStatement.holdings[0].isin).toBe('DE0001234567');
+        });
+    });
+    describe('getPortfolioWithTan', () => {
+        it('continues portfolio fetching with TAN', async () => {
+            dialogContinueMock.mockResolvedValueOnce(new Map([
+                [
+                    'HKWPD',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                        portfolioStatement: {
+                            currency: 'EUR',
+                            holdings: [],
+                        },
+                    },
+                ],
+            ]));
+            const response = (await client.getPortfolioWithTan('PORTFOLIOTAN123', '987654'));
+            expect(response.success).toBe(true);
+            expect(response.portfolioStatement).toBeDefined();
+            expect(dialogContinueMock).toHaveBeenCalledWith('PORTFOLIOTAN123', '987654');
+        });
+    });
+    describe('getCreditCardStatements', () => {
+        it('fetches credit card statements', async () => {
+            dialogStartMock.mockResolvedValueOnce(new Map([
+                [
+                    'HKIDN',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                    },
+                ],
+                [
+                    'DKKKU',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                        statements: [
+                            {
+                                openingBalance: { date: new Date('2025-12-01'), currency: 'EUR', value: 0.0 },
+                                closingBalance: { date: new Date('2025-12-23'), currency: 'EUR', value: -150.0 },
+                                transactions: [],
+                            },
+                        ],
+                    },
+                ],
+            ]));
+            const response = (await client.getCreditCardStatements('1111222233'));
+            expect(response.success).toBe(true);
+            expect(response.statements).toBeDefined();
+            expect(response.statements.length).toBe(1);
+            expect(response.statements[0].closingBalance?.value).toBe(-150.0);
+        });
+    });
+    describe('getCreditCardStatementsWithTan', () => {
+        it('continues credit card statement fetching with TAN', async () => {
+            dialogContinueMock.mockResolvedValueOnce(new Map([
+                [
+                    'DKKKU',
+                    {
+                        dialogId: 'DIALOG1',
+                        success: true,
+                        requiresTan: false,
+                        bankingInformationUpdated: false,
+                        bankAnswers: [{ code: 20, text: 'Auftrag ausgeführt' }],
+                        statements: [],
+                    },
+                ],
+            ]));
+            const response = (await client.getCreditCardStatementsWithTan('CCTAN123', '111222'));
+            expect(response.success).toBe(true);
+            expect(response.statements).toBeDefined();
+            expect(dialogContinueMock).toHaveBeenCalledWith('CCTAN123', '111222');
+        });
+    });
+    describe('capability checks', () => {
+        describe('canGetAccountBalance', () => {
+            it('returns true for general capability when bank supports it', () => {
+                expect(client.canGetAccountBalance()).toBe(true);
+            });
+            it('returns true for specific account that supports balance checking', () => {
+                expect(client.canGetAccountBalance('1234567890')).toBe(true);
+            });
+            it('returns false for account that does not support balance checking', () => {
+                expect(client.canGetAccountBalance('9876543210')).toBe(false);
+            });
+        });
+        describe('canGetAccountStatements', () => {
+            it('returns true for general capability when bank supports it', () => {
+                expect(client.canGetAccountStatements()).toBe(true);
+            });
+            it('returns true for account that supports statements', () => {
+                expect(client.canGetAccountStatements('1234567890')).toBe(true);
+            });
+            it('returns false for account that does not support statements', () => {
+                expect(client.canGetAccountStatements('1111222233')).toBe(false);
+            });
+        });
+        describe('canGetPortfolio', () => {
+            it('returns true for general capability when bank supports it', () => {
+                expect(client.canGetPortfolio()).toBe(true);
+            });
+            it('returns true for depot account', () => {
+                expect(client.canGetPortfolio('9876543210')).toBe(true);
+            });
+            it('returns false for non-depot account', () => {
+                expect(client.canGetPortfolio('1234567890')).toBe(false);
+            });
+        });
+        describe('canGetCreditCardStatements', () => {
+            it('returns true for general capability when bank supports it', () => {
+                expect(client.canGetCreditCardStatements()).toBe(true);
+            });
+            it('returns true for credit card account', () => {
+                expect(client.canGetCreditCardStatements('1111222233')).toBe(true);
+            });
+            it('returns false for non-credit card account', () => {
+                expect(client.canGetCreditCardStatements('1234567890')).toBe(false);
+            });
+        });
+    });
+    describe('TAN method and media selection', () => {
+        describe('selectTanMethod', () => {
+            it('selects TAN method by ID and returns the method', () => {
+                const tanMethod = client.selectTanMethod(2);
+                expect(tanMethod).toBeDefined();
+                expect(tanMethod.id).toBe(2);
+                expect(tanMethod.name).toBe('pushTAN');
+                expect(client.config.selectedTanMethod).toBe(tanMethod);
+            });
+            it('throws error for invalid TAN method ID', () => {
+                expect(() => client.selectTanMethod(999)).toThrow();
+            });
+        });
+        describe('selectTanMedia', () => {
+            it('selects TAN media by name', () => {
+                // First select a TAN method that has TAN media
+                client.selectTanMethod(1);
+                expect(() => client.selectTanMedia('TAN-Generator 123')).not.toThrow();
+            });
+            it('throws error for invalid TAN media name', () => {
+                client.selectTanMethod(1);
+                expect(() => client.selectTanMedia('Invalid Media')).toThrow();
+            });
+        });
     });
 });

package/dist/types/client.d.ts

@@ -97,12 +97,12 @@ export declare class FinTSClient {
      */
     getPortfolio(accountNumber: string, 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
-
-     * @param tan The TAN entered by the user, can be omitted if a decoupled TAN method is used
-     * @returns a portfolio response containing holdings and total value
-     */
+       * Continues the portfolio 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 portfolio response containing holdings and total value
+       */
     getPortfolioWithTan(tanReference: string, tan?: string): Promise<PortfolioResponse>;
     /**
      * Checks if the bank supports fetching credit card statements in general or for the given account number

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAsB,MAAM,sCAAsC,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAwB,MAAM,wCAAwC,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAM3C,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAIvE,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;IAK/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;IAK1F;;;;OAIG;IACH,oBAAoB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO;IAMrD;;;;OAIG;IACG,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAK/E;;;;;OAKG;IACG,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAKnG;;;;OAIG;IACH,uBAAuB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO;IAaxD;;;;;;;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,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKjG;;;;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;IAO7B;;;;;;OAMG;IACG,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKzF;;;;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;IAK7F;;;;;OAKG;IACG,8BAA8B,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAKtF,6BAA6B;YAQ7B,kCAAkC;CAUhD"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAsB,MAAM,sCAAsC,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAwB,MAAM,wCAAwC,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAM3C,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAIvE,MAAM,WAAW,mBAAoB,SAAQ,YAAY;CAAG;AAE5D;;GAEG;AACH,qBAAa,WAAW;IAOH,MAAM,EAAE,WAAW;IANtC,OAAO,CAAC,aAAa,CAAqB;IAE1C;;;OAGG;gBACgB,MAAM,EAAE,WAAW;IAUtC;;;;OAIG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAK/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;IAK/E;;;;;OAKG;IACG,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInG;;;;OAIG;IACH,uBAAuB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO;IAaxD;;;;;;;OAOG;IACG,oBAAoB,CACxB,aAAa,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,IAAI,EACX,EAAE,CAAC,EAAE,IAAI,EACT,UAAU,GAAE,OAAc,GACzB,OAAO,CAAC,iBAAiB,CAAC;IAuB7B;;;;;OAKG;IACG,2BAA2B,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQjG;;;;OAIG;IACH,eAAe,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO;IAMhD;;;;;;;OAOG;IACG,YAAY,CAChB,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,GAAG,GAAG,GAAG,EACxB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC;IAM7B;;;;;;SAME;IACI,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIzF;;;;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,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAItF,6BAA6B;YAa7B,kCAAkC;CAoBjD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lib-fints",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Typescript/Javascript client library for Online-Banking via the FinTS 3.0 protocol with PIN/TAN",
   "engines": {
     "node": ">=18.0.0"