lib-fints 1.2.0 → 1.3.0

package/README.md

@@ -1,3 +1,5 @@
+[![Node.js CI with pnpm](https://github.com/robocode13/lib-fints/actions/workflows/build-test.yml/badge.svg?branch=main)](https://github.com/robocode13/lib-fints/actions/workflows/build-test.yml)
+
 # Lib-FinTS
 
 A Typescript/Javascript client library for Online-Banking via the FinTS 3.0 protocol with PIN/TAN, supporting PSD2 and decoupled TAN methods. The library has no dependencies on other libraries
@@ -186,15 +188,48 @@ config.debugEnabled = true;
 
 This will print out all sent messages and received responses to the console in a structured format.
 
+## Supported Transactions
+
+The following table shows all transactions supported by the FinTSClient interface:
+
+| Transaction                | Method                                                               | Description                                                                   | FinTS Segment(s)           | TAN Support | Account-Specific |
+| -------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------------- | -------------------------- | ----------- | ---------------- |
+| **Synchronization**        | `synchronize()`                                                      | Synchronizes bank and account information, updating config.bankingInformation | HKIDN, HKVVB, HKSYN, HKTAB | ✓           | ❌               |
+| **Account Balance**        | `getAccountBalance(accountNumber)`                                   | Fetches the current balance for a specific account                            | HKSAL                      | ✓           | ✓                |
+| **Account Statements**     | `getAccountStatements(accountNumber, from?, to?)`                    | Fetches account transactions/statements for a date range                      | HKKAZ                      | ✓           | ✓                |
+| **Portfolio**              | `getPortfolio(accountNumber, currency?, priceQuality?, maxEntries?)` | Fetches securities portfolio information for depot accounts                   | HKWPD                      | ✓           | ✓                |
+| **Credit Card Statements** | `getCreditCardStatements(accountNumber, from?)`                      | Fetches credit card statements for credit card accounts                       | DKKKU                      | ✓           | ✓                |
+| **TAN Method Selection**   | `selectTanMethod(tanMethodId)`                                       | Selects a TAN method by ID from available methods                             | -                          | ❌          | ❌               |
+| **TAN Media Selection**    | `selectTanMedia(tanMediaName)`                                       | Selects a specific TAN media device by name                                   | -                          | ❌          | ❌               |
+
+### Transaction Support Checking
+
+For each account-specific transaction, the client provides corresponding `can*` methods to check if the bank or specific account supports the transaction:
+
+| Support Check Method                         | Purpose                                                |
+| -------------------------------------------- | ------------------------------------------------------ |
+| `canGetAccountBalance(accountNumber?)`       | Checks if account balance fetching is supported        |
+| `canGetAccountStatements(accountNumber?)`    | Checks if account statements fetching is supported     |
+| `canGetPortfolio(accountNumber?)`            | Checks if portfolio information fetching is supported  |
+| `canGetCreditCardStatements(accountNumber?)` | Checks if credit card statements fetching is supported |
+
+### TAN Continuation Methods
+
+Every transaction that supports TAN authentication has a corresponding `*WithTan` method for continuing the transaction after TAN entry:
+
+- `synchronizeWithTan(tanReference, tan?)`
+- `getAccountBalanceWithTan(tanReference, tan?)`
+- `getAccountStatementsWithTan(tanReference, tan?)`
+- `getPortfolioWithTan(tanReference, tan?)`
+- `getCreditCardStatementsWithTan(tanReference, tan?)`
+
+The `tan` parameter can be omitted when using decoupled TAN methods.
+
 ## Limitations
 
 - Only FinTS 3.0 is supported (older versions may not work)
-- Only PIN/TAN security is supported (inluding decoupled TAN methods)
-- Currently only the following transactions are supported:
-  - Synchronize bank and account information
-  - Fetching account balances
-  - Fetching account statements
-  - Fetching the portfolio of a securities account
+- Only PIN/TAN security is supported (including decoupled TAN methods)
+- No support for payment transactions or transfers yet
 
 Implementing further transactions should be straight forward and contributions are highly appreciated
 

package/dist/client.js

@@ -8,7 +8,9 @@ import { TanMediaInteraction } from './interactions/tanMediaInteraction.js';
 import { HKSAL } from './segments/HKSAL.js';
 import { HKKAZ } from './segments/HKKAZ.js';
 import { HKWPD } from './segments/HKWPD.js';
+import { DKKKU } from './segments/DKKKU.js';
 import { InitDialogInteraction } from './interactions/initDialogInteraction.js';
+import { CreditCardStatementInteraction } from "./interactions/creditcardStatementInteraction.js";
 /**
  * A client to communicate with a bank over the FinTS protocol
  */
@@ -161,6 +163,36 @@ export class FinTSClient {
     async getPortfolioWithTan(tanReference, tan) {
         return this.continueCustomerInteractionWithTan(tanReference, tan);
     }
+    /**
+     * 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
+     * @returns true if the bank (and account) supports fetching credit card statements
+     */
+    canGetCreditCardStatements(accountNumber) {
+        return accountNumber
+            ? this.config.isAccountTransactionSupported(accountNumber, DKKKU.Id)
+            : this.config.isTransactionSupported(DKKKU.Id);
+    }
+    /**
+     * 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
+     * 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
+     */
+    async getCreditCardStatements(accountNumber, from) {
+        return this.startCustomerOrderInteraction(new CreditCardStatementInteraction(accountNumber, from));
+    }
+    /**
+     * Continues the credit card statements 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 credit card statements response containing an array of statements
+     */
+    async getCreditCardStatementsWithTan(tanReference, tan) {
+        return this.continueCustomerInteractionWithTan(tanReference, tan);
+    }
     async startCustomerOrderInteraction(interaction) {
         const dialog = new Dialog(this.config);
         const syncResponse = await this.initDialog(dialog, false, interaction);

package/dist/creditCardStatement.js

@@ -0,0 +1 @@
+export {};

package/dist/dialog.js

@@ -7,7 +7,6 @@ import { HKTAN } from './segments/HKTAN.js';
 import { HNHBK } from './segments/HNHBK.js';
 import { decode } from './segment.js';
 import { PARTED } from './partedSegment.js';
-import { HttpClientNode } from './httpClientNode.js';
 export class Dialog {
     config;
     dialogId = '0';
@@ -182,11 +181,6 @@ export class Dialog {
         }
     }
     getHttpClient() {
-        if (typeof fetch === 'function') {
-            return new HttpClient(this.config.bankingUrl, this.config.debugEnabled);
-        }
-        else {
-            return new HttpClientNode(this.config.bankingUrl, this.config.debugEnabled);
-        }
+        return new HttpClient(this.config.bankingUrl, this.config.debugEnabled);
     }
 }

package/dist/interactions/creditcardStatementInteraction.js

@@ -0,0 +1,106 @@
+import { CustomerOrderInteraction } from './customerInteraction.js';
+import { DKKKU } from '../segments/DKKKU.js';
+import { DIKKU } from '../segments/DIKKU.js';
+export class CreditCardStatementInteraction extends CustomerOrderInteraction {
+    accountNumber;
+    from;
+    constructor(accountNumber, from) {
+        super(DKKKU.Id, DIKKU.Id);
+        this.accountNumber = accountNumber;
+        this.from = from;
+    }
+    createSegments(init) {
+        const bankAccount = init.getBankAccount(this.accountNumber);
+        if (!init.isAccountTransactionSupported(this.accountNumber, this.segId)) {
+            throw Error(`Account ${this.accountNumber} does not support business transaction '${this.segId}'`);
+        }
+        const account = { ...bankAccount, iban: undefined };
+        const version = 2;
+        const dkkku = {
+            header: { segId: DKKKU.Id, segNr: 0, version: version },
+            account,
+            accountNumber: account.accountNumber,
+            subAccountId: account.subAccountId,
+            from: this.from,
+        };
+        return [dkkku];
+    }
+    handleResponse(response, clientResponse) {
+        function parseGermanFloat(value) {
+            const valueFloatStr = value.replaceAll('.', '').replaceAll(',', '.');
+            return parseFloat(valueFloatStr);
+        }
+        const dikku = response.findSegment(DIKKU.Id);
+        if (dikku) {
+            const creditDebit = dikku.balance.creditDebit;
+            const balanceAmount = dikku.balance.amount.value * (creditDebit === 'D' ? -1 : 1);
+            const balanceCurrency = dikku.balance.amount.currency;
+            const balanceDateTime = dikku.balance.date;
+            if (dikku.balance.time) {
+                balanceDateTime.setUTCHours(dikku.balance.time.getUTCHours());
+                balanceDateTime.setUTCMinutes(dikku.balance.time.getUTCMinutes());
+                balanceDateTime.setUTCSeconds(dikku.balance.time.getUTCSeconds());
+            }
+            clientResponse.balance = {
+                balance: balanceAmount,
+                date: balanceDateTime,
+                currency: balanceCurrency,
+            };
+            clientResponse.statements = [];
+            if (dikku.transactions) {
+                for (let i = 0; i < dikku.transactions.length; i++) {
+                    const parts = dikku.transactions[i].split(':');
+                    // const accountNumber = parts[0];
+                    const transactionDateStr = parts[1];
+                    const valueDateStr = parts[2];
+                    const currencyOrig = parts[5];
+                    const depositMarkerOrig = parts[6];
+                    const amountOrig = parseGermanFloat(parts[4]) * (depositMarkerOrig === 'D' ? -1 : 1);
+                    const exchangeRate = parseGermanFloat(parts[7]);
+                    const currency = parts[9];
+                    const depositMarker = parts[10];
+                    const amount = parseGermanFloat(parts[8]) * (depositMarker === 'D' ? -1 : 1);
+                    const tYear = parseInt(transactionDateStr.substring(0, 4));
+                    const tMonth = parseInt(transactionDateStr.substring(4, 6));
+                    const tDay = parseInt(transactionDateStr.substring(6, 8));
+                    const vYear = parseInt(valueDateStr.substring(0, 4));
+                    const vMonth = parseInt(valueDateStr.substring(4, 6));
+                    const vDay = parseInt(valueDateStr.substring(6, 8));
+                    let purpose = '';
+                    let pIdx = 11;
+                    do {
+                        let partPurpose = parts[pIdx].trim();
+                        if (partPurpose === 'J') {
+                            break;
+                        }
+                        purpose = purpose + partPurpose;
+                        if (purpose.endsWith('Betrag?')) {
+                            purpose = purpose.slice(0, purpose.length - 7) + ' Betrag ';
+                        }
+                        else if (purpose[purpose.length - 1] === '?') {
+                            purpose = purpose.slice(0, purpose.length - 1) + ' ';
+                        }
+                        else {
+                            break;
+                        }
+                        pIdx += 1;
+                    } while (pIdx < 21);
+                    const statement = {
+                        transactionDate: new Date(tYear, tMonth - 1, tDay),
+                        valueDate: new Date(vYear, vMonth - 1, vDay),
+                        currency: currency,
+                        amount: amount,
+                        purpose: purpose,
+                        originalCurrency: currencyOrig,
+                        originalAmount: amountOrig,
+                        exchangeRate: exchangeRate,
+                    };
+                    clientResponse.statements = clientResponse.statements.concat(statement);
+                }
+            }
+        }
+        else {
+            clientResponse.statements = [];
+        }
+    }
+}

package/dist/segments/DIKKU.js

@@ -0,0 +1,23 @@
+import { Binary } from '../dataElements/Binary.js';
+import { SegmentDefinition } from '../segmentDefinition.js';
+import { Identification } from "../dataElements/Identification.js";
+import { Text } from "../dataElements/Text.js";
+import { BalanceGroup } from "../dataGroups/Balance.js";
+/**
+ * Credit card transactions within period response
+ */
+export class DIKKU extends SegmentDefinition {
+    static Id = 'DIKKU';
+    version = 2;
+    constructor() {
+        super(DIKKU.Id);
+    }
+    elements = [
+        new Identification('accountNumber', 1, 1),
+        new Text('Ignore', 0, 1),
+        new BalanceGroup('balance', 1, 1),
+        new Text('Ignore', 0, 1),
+        new Text('Ignore', 0, 1),
+        new Binary('transactions', 0, 10000, Number.MAX_SAFE_INTEGER),
+    ];
+}

package/dist/segments/DKKKU.js

@@ -0,0 +1,25 @@
+import { Dat } from '../dataElements/Dat.js';
+import { Numeric } from '../dataElements/Numeric.js';
+import { AlphaNumeric } from '../dataElements/AlphaNumeric.js';
+import { AccountGroup } from '../dataGroups/Account.js';
+import { SegmentDefinition } from '../segmentDefinition.js';
+import { Identification } from "../dataElements/Identification.js";
+/**
+ * Request credit card transactions in a given period
+ */
+export class DKKKU extends SegmentDefinition {
+    static Id = 'DKKKU';
+    static Version = 2;
+    constructor() {
+        super(DKKKU.Id);
+    }
+    version = DKKKU.Version;
+    elements = [
+        new AccountGroup('account', 1, 1, 1, 6),
+        new Identification('accountNumber', 1, 1),
+        new Identification('subAccountId', 1, 1),
+        new Dat('from', 0, 1),
+        new Numeric('maxEntries', 0, 1, 4),
+        new AlphaNumeric('continuationMark', 0, 1, 35),
+    ];
+}

package/dist/segments/registry.js

@@ -29,6 +29,8 @@ import { HIKAZS } from './HIKAZS.js';
 import { HITAB } from './HITAB.js';
 import { HKWPD } from './HKWPD.js';
 import { HIWPD } from './HIWPD.js';
+import { DIKKU } from "./DIKKU.js";
+import { DKKKU } from "./DKKKU.js";
 import { UNKNOW } from '../unknownSegment.js';
 import { PARTED } from '../partedSegment.js';
 const registry = new Map();
@@ -60,6 +62,8 @@ export function registerSegments() {
     registerSegmentDefinition(new HKSAL());
     registerSegmentDefinition(new HISAL());
     registerSegmentDefinition(new HKKAZ());
+    registerSegmentDefinition(new DKKKU());
+    registerSegmentDefinition(new DIKKU());
     registerSegmentDefinition(new HIKAZ());
     registerSegmentDefinition(new HIKAZS());
     registerSegmentDefinition(new HKWPD());

package/dist/types/client.d.ts

@@ -103,6 +103,28 @@ export declare class FinTSClient {
      * @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
+     * @param accountNumber 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;
+    /**
+     * 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
+     * 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>;
+    /**
+     * Continues the credit card statements 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 credit card statements response containing an array of statements
+     */
+    getCreditCardStatementsWithTan(tanReference: string, tan?: string): Promise<StatementResponse>;
     private startCustomerOrderInteraction;
     private continueCustomerInteractionWithTan;
     private initDialog;

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAwB,MAAM,wCAAwC,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAsB,MAAM,sCAAsC,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAwB,MAAM,wCAAwC,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAI3C,OAAO,EAAyB,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAE9F,MAAM,WAAW,mBAAoB,SAAQ,YAAY;CAAG;AAE5D;;GAEG;AACH,qBAAa,WAAW;IAOJ,MAAM,EAAE,WAAW;IANtC,OAAO,CAAC,wBAAwB,CAA0C;IAE1E;;;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;IAwBjD;;;;;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;IAI/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;IAMxD;;;;;;OAMG;IACG,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIrG;;;;;OAKG;IACG,2BAA2B,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIjG;;;;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;YAI3E,6BAA6B;YAqB7B,kCAAkC;YA0ClC,UAAU;CAcxB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAwB,MAAM,wCAAwC,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAsB,MAAM,sCAAsC,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAwB,MAAM,wCAAwC,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAK3C,OAAO,EAAyB,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAG9F,MAAM,WAAW,mBAAoB,SAAQ,YAAY;CAAG;AAE5D;;GAEG;AACH,qBAAa,WAAW;IAOJ,MAAM,EAAE,WAAW;IANtC,OAAO,CAAC,wBAAwB,CAA0C;IAE1E;;;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;IAwBjD;;;;;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;IAI/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;IAMxD;;;;;;OAMG;IACG,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIrG;;;;;OAKG;IACG,2BAA2B,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIjG;;;;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;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;IAI7F;;;;;OAKG;IACG,8BAA8B,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAItF,6BAA6B;YAqB7B,kCAAkC;YA0ClC,UAAU;CAcxB"}

package/dist/types/creditCardStatement.d.ts

@@ -0,0 +1,11 @@
+export type CreditCardStatement = {
+    transactionDate: Date;
+    valueDate: Date;
+    currency: string;
+    amount: number;
+    purpose: string;
+    originalCurrency: string;
+    originalAmount: number;
+    exchangeRate: number;
+};
+//# sourceMappingURL=creditCardStatement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"creditCardStatement.d.ts","sourceRoot":"","sources":["../../src/creditCardStatement.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IAEhC,eAAe,EAAE,IAAI,CAAC;IAItB,SAAS,EAAE,IAAI,CAAC;IAEhB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../src/dialog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAyC,OAAO,EAAE,MAAM,cAAc,CAAC;AAQ9E,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAEjG,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAE9F,qBAAa,MAAM;IAOC,MAAM,EAAE,WAAW;IANtC,QAAQ,EAAE,MAAM,CAAO;IACvB,iBAAiB,SAAK;IACtB,aAAa,UAAS;IACtB,QAAQ,UAAS;IACjB,UAAU,EAAE,UAAU,CAAC;gBAEJ,MAAM,EAAE,WAAW;IAQhC,UAAU,CAAC,WAAW,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IA0DrE,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;IAuCvB,6BAA6B,CAAC,eAAe,SAAS,cAAc,EACzE,WAAW,EAAE,wBAAwB,GACnC,OAAO,CAAC,eAAe,CAAC;IA+FrB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuDjG,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,aAAa;CAOrB"}
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../src/dialog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAyC,OAAO,EAAE,MAAM,cAAc,CAAC;AAQ9E,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjG,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAE9F,qBAAa,MAAM;IAOC,MAAM,EAAE,WAAW;IANtC,QAAQ,EAAE,MAAM,CAAO;IACvB,iBAAiB,SAAK;IACtB,aAAa,UAAS;IACtB,QAAQ,UAAS;IACjB,UAAU,EAAE,UAAU,CAAC;gBAEJ,MAAM,EAAE,WAAW;IAQhC,UAAU,CAAC,WAAW,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IA0DrE,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;IAuCvB,6BAA6B,CAAC,eAAe,SAAS,cAAc,EACzE,WAAW,EAAE,wBAAwB,GACnC,OAAO,CAAC,eAAe,CAAC;IA+FrB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuDjG,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,aAAa;CAGrB"}

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

@@ -0,0 +1,18 @@
+import { ClientResponse, CustomerOrderInteraction } from './customerInteraction.js';
+import { Message } from '../message.js';
+import { Segment } from '../segment.js';
+import { CreditCardStatement } from '../creditCardStatement.js';
+import { FinTSConfig } from '../config.js';
+import { AccountBalance } from "../accountBalance.js";
+export interface CreditCardStatementResponse extends ClientResponse {
+    balance: AccountBalance;
+    statements: CreditCardStatement[];
+}
+export declare class CreditCardStatementInteraction extends CustomerOrderInteraction {
+    accountNumber: string;
+    from?: Date | undefined;
+    constructor(accountNumber: string, from?: Date | undefined);
+    createSegments(init: FinTSConfig): Segment[];
+    handleResponse(response: Message, clientResponse: CreditCardStatementResponse): void;
+}
+//# sourceMappingURL=creditcardStatementInteraction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"creditcardStatementInteraction.d.ts","sourceRoot":"","sources":["../../../src/interactions/creditcardStatementInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpF,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAEpD,MAAM,WAAW,2BAA4B,SAAQ,cAAc;IACjE,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,mBAAmB,EAAE,CAAC;CACnC;AAED,qBAAa,8BAA+B,SAAQ,wBAAwB;IACvD,aAAa,EAAE,MAAM;IAAS,IAAI,CAAC;gBAAnC,aAAa,EAAE,MAAM,EAAS,IAAI,CAAC,kBAAM;IAI5D,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,EAAE;IAqB5C,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,2BAA2B;CA8E9E"}

package/dist/types/segments/DIKKU.d.ts

@@ -0,0 +1,20 @@
+import { Binary } from '../dataElements/Binary.js';
+import { SegmentDefinition } from '../segmentDefinition.js';
+import { Segment } from '../segment.js';
+import { Identification } from "../dataElements/Identification.js";
+import { Text } from "../dataElements/Text.js";
+import { BalanceGroup, Balance } from "../dataGroups/Balance.js";
+export type DIKKUSegment = Segment & {
+    balance: Balance;
+    transactions: string[];
+};
+/**
+ * Credit card transactions within period response
+ */
+export declare class DIKKU extends SegmentDefinition {
+    static Id: string;
+    version: number;
+    constructor();
+    elements: (Identification | Text | Binary | BalanceGroup)[];
+}
+//# sourceMappingURL=DIKKU.d.ts.map

package/dist/types/segments/DIKKU.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DIKKU.d.ts","sourceRoot":"","sources":["../../../src/segments/DIKKU.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAC,cAAc,EAAC,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAC,IAAI,EAAC,MAAM,yBAAyB,CAAC;AAC7C,OAAO,EAAC,YAAY,EAAE,OAAO,EAAC,MAAM,0BAA0B,CAAC;AAE/D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,qBAAa,KAAM,SAAQ,iBAAiB;IAC3C,MAAM,CAAC,EAAE,SAAW;IACpB,OAAO,SAAK;;IAIZ,QAAQ,oDAON;CACF"}

package/dist/types/segments/DKKKU.d.ts

@@ -0,0 +1,24 @@
+import { Dat } from '../dataElements/Dat.js';
+import { Numeric } from '../dataElements/Numeric.js';
+import { AlphaNumeric } from '../dataElements/AlphaNumeric.js';
+import { Account, AccountGroup } from '../dataGroups/Account.js';
+import { SegmentWithContinuationMark } from '../segment.js';
+import { SegmentDefinition } from '../segmentDefinition.js';
+export type DKKKUSegment = SegmentWithContinuationMark & {
+    account: Account;
+    accountNumber: string;
+    subAccountId: string | undefined;
+    from?: Date;
+    maxEntries?: number;
+};
+/**
+ * Request credit card transactions in a given period
+ */
+export declare class DKKKU extends SegmentDefinition {
+    static Id: string;
+    static Version: number;
+    constructor();
+    version: number;
+    elements: (AlphaNumeric | AccountGroup | Numeric | Dat)[];
+}
+//# sourceMappingURL=DKKKU.d.ts.map

package/dist/types/segments/DKKKU.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DKKKU.d.ts","sourceRoot":"","sources":["../../../src/segments/DKKKU.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,MAAM,MAAM,YAAY,GAAG,2BAA2B,GAAG;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,qBAAa,KAAM,SAAQ,iBAAiB;IACxC,MAAM,CAAC,EAAE,SAAW;IACpB,MAAM,CAAC,OAAO,SAAK;;IAInB,OAAO,SAAiB;IACxB,QAAQ,kDAON;CACL"}

package/dist/types/segments/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/segments/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAqC5D,wBAAgB,gBAAgB,SAkC/B;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,MAAM,GACT,iBAAiB,GAAG,SAAS,CAE/B"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/segments/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAuC5D,wBAAgB,gBAAgB,SAoC/B;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,MAAM,GACT,iBAAiB,GAAG,SAAS,CAE/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lib-fints",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Typescript/Javascript client library for Online-Banking via the FinTS 3.0 protocol with PIN/TAN",
   "engines": {
     "node": ">=18.0.0"
@@ -19,6 +19,12 @@
       }
     }
   },
+  "scripts": {
+    "build": "rm -rf ./dist && tsc",
+    "pack": "npm run build && npm pack --pack-destination ~/npm-repo",
+    "test": "vitest",
+    "preprepare": "npm run build"
+  },
   "keywords": [
     "FinTS",
     "HBCI",
@@ -36,10 +42,5 @@
     "@types/node": "^20.10.6",
     "typescript": "^5.3.3",
     "vitest": "^1.6.0"
-  },
-  "scripts": {
-    "build": "rm -rf ./dist && tsc",
-    "pack": "npm run build && npm pack --pack-destination ~/npm-repo",
-    "test": "vitest"
   }
-}
+}

package/dist/httpClientNode.js

@@ -1,59 +0,0 @@
-import { Message } from './message.js';
-import * as https from 'https';
-export class HttpClientNode {
-    url;
-    debug;
-    constructor(url, debug = false) {
-        this.url = url;
-        this.debug = debug;
-    }
-    async sendMessage(message) {
-        const encodedMessage = message.encode();
-        const requestBuffer = Buffer.from(encodedMessage).toString('base64');
-        if (this.debug) {
-            console.log('Request Message:\n' + message.toString());
-        }
-        const requestOptions = {
-            method: 'POST',
-            headers: { 'Content-Type': 'text/plain' },
-        };
-        return new Promise((resolve, reject) => {
-            const req = https.request(this.url, requestOptions, (res) => {
-                let data = '';
-                res.on('data', (chunk) => {
-                    data += chunk;
-                });
-                res.on('end', () => {
-                    if (res.statusCode === 200) {
-                        const responseBuffer = Buffer.from(data, 'base64');
-                        const responseText = responseBuffer.toString('latin1');
-                        try {
-                            const customerOrderMessage = message;
-                            const responseMessage = Message.decode(responseText, customerOrderMessage.supportsPartedResponseSegments
-                                ? customerOrderMessage.orderResponseSegId
-                                : undefined);
-                            if (this.debug) {
-                                console.log('Response Message:\n' + responseMessage.toString(true) + '\n');
-                            }
-                            resolve(responseMessage);
-                        }
-                        catch (error) {
-                            console.error('Error decoding response message:', error);
-                            console.error('Response Message Content:\n', responseText.split("'").join('\n'));
-                            reject(error);
-                        }
-                    }
-                    else {
-                        reject(new Error(`Request failed with status code ${res.statusCode}: ${data}`));
-                    }
-                });
-            });
-            req.on('error', (error) => {
-                console.error('Request error:', error);
-                reject(error);
-            });
-            req.write(requestBuffer);
-            req.end();
-        });
-    }
-}

package/dist/types/httpClientNode.d.ts

@@ -1,8 +0,0 @@
-import { CustomerMessage, Message } from './message.js';
-export declare class HttpClientNode {
-    url: string;
-    debug: boolean;
-    constructor(url: string, debug?: boolean);
-    sendMessage(message: CustomerMessage): Promise<Message>;
-}
-//# sourceMappingURL=httpClientNode.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"httpClientNode.d.ts","sourceRoot":"","sources":["../../src/httpClientNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAwB,OAAO,EAAE,MAAM,cAAc,CAAC;AAG9E,qBAAa,cAAc;IACN,GAAG,EAAE,MAAM;IAAS,KAAK;gBAAzB,GAAG,EAAE,MAAM,EAAS,KAAK,UAAQ;IAE9C,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;CA2D9D"}