lib-fints 1.0.3 → 1.1.1

package/README.md

@@ -1,6 +1,6 @@
 # Lib-FinTS
 
-A Typescript/Javascript client library for Online-Banking via the FinTS 3.0 protocol with PIN/TAN. The library has no dependencies on other libraries
+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
 
 ## Getting Started
 
@@ -15,14 +15,14 @@ In order to communicate with banks via the FinTS protocol you have to register a
 > In order to fulfill the PSD2 requirements regarding transparency about the software used by customers, the German Banking Industry has established a process for registering FinTS products in order to be able to provide customers with information regarding FinTS usage.
 > FinTS product registration is currently offered free of charge by the German Banking Industry.
 
-[ZKA Registration Website](https://www.hbci-zka.de/register/prod_register.htm)
+[ZKA Registration Website](https://www.fints.org/de/hersteller/produktregistrierung)
 
 ### Runtime Environment
 
 The library is written in Typescript and compiled to the ES2022 Javascript language standard which means a minimum Node version of 18 is required.
 
 **A note about Browsers:**
-It wouldn't be hard to make the code compatible with a browser environment, but communicating directly from the front-end with a bank server will most likely fail because of the imposed CORS restrictions from web browsers and the lack of corresponding CORS headers in bank server responses.
+In theory the library is compatible with a browser environment, but communicating directly from the front-end with a bank server will, apart from security considerations, most likely fail because of the imposed CORS restrictions from web browsers and the lack of corresponding CORS headers in bank server responses.
 
 ### Installing
 
@@ -34,7 +34,7 @@ npm i lib-fints
 
 ### Sample Usage
 
-The main public API of this library is the `FinTSClient` class and `FinTSConfig` class. In order to instantiate the client you need to provide a configration instance. There are basically two ways to initialize a configuration object, one is when you communicate with a bank for the first time and the other when you already have banking information from a prevous session available (more on that later).
+The main public API of this library is the `FinTSClient` class and `FinTSConfig` class. In order to instantiate the client you need to provide a configuration instance. There are basically two ways to initialize a configuration object, one is when you communicate with a bank for the first time and the other when you already have banking information from a prevous session available (more on that later).
 
 If you don't have any previous banking information available you can use the static `forFirstTimeUse()` factory method like this:
 
@@ -57,16 +57,16 @@ If the call is successfull the response will contain a `bankingInformation` obje
 
 ```typescript
 export type BankingInformation = {
-  systemId: string;
-  bpd?: BPD;
-  upd?: UPD;
-  bankMessages: BankMessage[];
+	systemId: string;
+	bpd?: BPD;
+	upd?: UPD;
+	bankMessages: BankMessage[];
 };
 ```
 
 The BPD object (_BankParameterDaten_) contains general information (e.g. available TAN methods and allowed transactions) and the UPD object (_UserParameterDaten_) user-specific information which is mainly the list of the user's bank accounts.
 
-Unfortunately with this first synchronization call most banks will most likely only return most of the BPA information but no UPD (accounts) information, which is needed to fetch balances or statements. The reason for this is that you need to specify a TAN method before making the synchronization call, but how would you know which TAN methods are available and how to specify them? This is why you need to make a second synchronization call with a TAN method selected from the `availableTanMethodIds`in the BPA, returned from the first synchronization call:
+Unfortunately with this first synchronization call most banks will likely only return the BPA information but no UPD (accounts) information, which is needed to fetch balances or statements. The reason for this is that you need to specify a TAN method before making the synchronization call, but you can only know which TAN methods are available from the BPA? This is why you need to make a second synchronization call with a TAN method selected from the `availableTanMethodIds`in the BPA, returned from the first synchronization call:
 
 ```typescript
 // for simplicity, we just select the first available TAN method
@@ -88,7 +88,7 @@ const balanceResponse = await client.getAccountBalance(account.accountNumber);
 const statementResponse = await client.getAccountStatements(account.accountNumber);
 ```
 
-These are only the most basic steps needed to retrieve information from the bank. It kept many questions unanswered like "how to handle TANs" or "how to avoid synchronizations every time you start a new session". These are explained in the corresponding sections below.
+These are only the most basic steps needed to retrieve information from the bank. There are still some unanswered questions like "how to handle TANs" or "how to avoid synchronizations every time you start a new session". These are explained in the corresponding sections below.
 
 ## More detailed API Description
 
@@ -99,27 +99,35 @@ Most transactions may require authorization with a two step TAN process. As ment
 ```typescript
 // we use the node readline interface later to ask the user for a TAN
 const rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout,
+	input: process.stdin,
+	output: process.stdout,
 });
 
 let response = await client.getAccountStatements(account.accountNumber);
 
 if (!response.success) {
-  return;
+	return;
 }
 
 // need to check if a TAN is required to continue the transaction
 if (response.requiresTan) {
-  // asking the user for the TAN, using the tanChallenge property
-  const tan = await rl.question(response.tanChallenge + ': ');
-  // continue the transaction by providing the tanReference from the response and the entered TAN
-  response = await client.getAccountStatementsWithTan(response.tanReference!, tan);
+	// asking the user for the TAN, using the tanChallenge property
+	const tan = await rl.question(response.tanChallenge + ': ');
+	// continue the transaction by providing the tanReference from the response and the entered TAN
+	response = await client.getAccountStatementsWithTan(response.tanReference!, tan);
 }
 ```
 
 The `FinTSClient`contains for every transaction method like `synchronize()` or `getAccountStatements()` a corresponding `...WithTan()` method which needs to be called to continue the transaction with the given `tanReference` returned in the first response. The response object of this second call should now contain all transaction related data, assuming `success=true`.
 
+**Decoupled TAN methods**
+
+The library now also supports decoupled TAN methods where you don't actually have to provide a TAN entered by a user, but the approval is done "decoupled" on another device (e.g. mobile phone via banking app). The procedure explained above is still very similar, `requiresTan` will signal a required approval and you can continue with one of the `...WithTan()` methods where you can ommit the last `tan` parameter.
+
+You could ask the user to confirm that the approval was given and then continue with the call or periodically call the method until it returns the transaction result (`requiresTan=false` and `success=true`). The continuation methods will keep returning `requiresTan=true` as long as the user hasn't approved the transaction.
+
+see also the `decoupled` property on the `TanMethod` object for related parameters given by the bank.
+
 ### Starting a session from saved banking information
 
 As mentioned earlier there is a second way to initialize the `FinTSClient` with a `FinTSConfig` when you already performed a synchronization in a previous session and this is by providing the `bankingInformation` object received from previous uses. This `bankingInformation` object, which contains the general bank (BPD) and accounts information (UPD), should be persisted after a session and reloaded in the next session.
@@ -127,13 +135,13 @@ This not only saves you from making the same synchronization requests every time
 
 ```typescript
 const config = FinTSConfig.fromBankingInformation(
-  productId,
-  productVersion,
-  bankingInformation,
-  userId,
-  pin,
-  tanMethodId,
-  tanMediaName // when also needed (see below)
+	productId,
+	productVersion,
+	bankingInformation,
+	userId,
+	pin,
+	tanMethodId,
+	tanMediaName // when also needed (see below)
 );
 const client = new FinTSClient(config);
 ```
@@ -148,12 +156,12 @@ You can get a list of all available TAN methods from the `config.availableTanMet
 
 ```typescript
 export type TanMethod = {
-  id: number;
-  name: string;
-  version: number;
-  activeTanMediaCount: number;
-  activeTanMedia: string[];
-  tanMediaRequirement: TanMediaRequirement;
+	id: number;
+	name: string;
+	version: number;
+	activeTanMediaCount: number;
+	activeTanMedia: string[];
+	tanMediaRequirement: TanMediaRequirement;
 };
 ```
 
@@ -163,7 +171,7 @@ The property `activeTanMedia` contains a list of the TAN media names you can use
 
 #### Banking Information may be updated any time
 
-The `bankingInformation` is primarily obtained by the `synchronize()` calls as seen above. But what if the banking information changed since the last synchronization call and how would you know? For this reason the BPD and UPD are versioned and with every transaction made, not just synchronizations, the currently used versions are provided to the bank and if something changed, the bank will sent back new versions of the BPD and UPD respectively. This is all handled by the client but you need to check the `bankingInformationUpdated` property, which is available in every response, which tells you if there were changes and make sure to persist the new version for future sessions. You can always get the up-to-date version of the `bankingInformation` object with `config.bankingInformation`.
+The `bankingInformation` is primarily obtained through the `synchronize()` calls as demonstrated above. However, it is possible that the banking information may have changed since the last synchronization call. To address this, the BPD and UPD are versioned, and with every transaction made, not just synchronizations, the currently used versions are provided to the bank. If any changes have occurred, the bank will send back new versions of the BPD and UPD respectively. This process is managed by the client, but it is essential to check the `bankingInformationUpdated` property, which is available in every response. This property indicates if there have been any changes, and it is important to persist the new version for future sessions. The most up-to-date version of the `bankingInformation` object can always be retrieved using `config.bankingInformation`.
 
 ### Debugging
 
@@ -178,7 +186,7 @@ This will print out all sent messages and received responses to the console in a
 ## Limitations
 
 - Only FinTS 3.0 is supported (older versions may not work)
-- Only PIN/TAN security is supported
+- 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

package/dist/client.js

@@ -66,7 +66,7 @@ export class FinTSClient {
     /**
      * Continues the synchronization transaction 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
+     * @param tan The TAN entered by the user, can be omitted if a decoupled TAN method is used
      * @returns the synchronization response
      */
     async synchronizeWithTan(tanReference, tan) {
@@ -93,7 +93,7 @@ export class FinTSClient {
     /**
      * Continues the account balance 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
+     * @param tan The TAN entered by the user, can be omitted if a decoupled TAN method is used
      * @returns the account balance response
      */
     async getAccountBalanceWithTan(tanReference, tan) {
@@ -122,7 +122,7 @@ export class FinTSClient {
     /**
      * Continues the account 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
+     * @param tan The TAN entered by the user, can be omitted if a decoupled TAN method is used
      * @returns an account statements response containing an array of statements
      */
     async getAccountStatementsWithTan(tanReference, tan) {

package/dist/codes.js

@@ -77,3 +77,11 @@ export var TanUsage;
     TanUsage[TanUsage["Single"] = 1] = "Single";
     TanUsage[TanUsage["MobileAndGenerator"] = 2] = "MobileAndGenerator";
 })(TanUsage || (TanUsage = {}));
+export var TanProcess;
+(function (TanProcess) {
+    TanProcess["Process1"] = "1";
+    TanProcess["Process2"] = "2";
+    TanProcess["Process3"] = "3";
+    TanProcess["Process4"] = "4";
+    TanProcess["Status"] = "S";
+})(TanProcess || (TanProcess = {}));

package/dist/config.js

@@ -114,8 +114,8 @@ export class FinTSConfig {
      * @param tanMethodId The ID of the TAN method to select, corresponding to an ID in availableTanMethods
      */
     selectTanMethod(tanMethodId) {
-        if (!this.bankingInformation.bpd?.availableTanMethodIds?.find((id) => id === tanMethodId)) {
-            throw new Error(`TAN Method '${tanMethodId}' not found in the available TAN methods in the BPD`);
+        if (!this.availableTanMethods.find((method) => method.id === tanMethodId)) {
+            throw new Error(`TAN Method '${tanMethodId}' is not supported`);
         }
         this.tanMethodId = tanMethodId;
     }

package/dist/dialog.js

@@ -1,4 +1,4 @@
-import { TanMediaRequirement } from './codes.js';
+import { TanMediaRequirement, TanProcess } from './codes.js';
 import { HttpClient } from './httpClient.js';
 import { CustomerMessage, CustomerOrderMessage } from './message.js';
 import { HKEND } from './segments/HKEND.js';
@@ -45,7 +45,7 @@ export class Dialog {
         if (this.config.userId && this.config.pin && isScaSupported) {
             const hktan = {
                 header: { segId: HKTAN.Id, segNr: 0, version: tanMethod.version },
-                tanProcess: 4,
+                tanProcess: TanProcess.Process4,
                 segId: HKIDN.Id,
             };
             message.addSegment(hktan);
@@ -107,7 +107,7 @@ export class Dialog {
             if (this.config.userId && this.config.pin && this.config.tanMethodId) {
                 const hktan = {
                     header: { segId: HKTAN.Id, segNr: 0, version: this.config.selectedTanMethod.version },
-                    tanProcess: 4,
+                    tanProcess: TanProcess.Process4,
                     segId: interaction.segId,
                     tanMedia: this.config.tanMediaName,
                 };
@@ -142,8 +142,11 @@ export class Dialog {
         return interaction.getClientResponse(responseMessage);
     }
     async sendTanMessage(refSegId, tanOrderReference, tan) {
-        if (!refSegId || !tanOrderReference || !tan) {
-            throw Error('refSegId, tanOrderReference and TAN must be provided to send a TAN message');
+        if (!refSegId || !tanOrderReference) {
+            throw Error('refSegId and tanOrderReference must be provided to send a TAN message');
+        }
+        if (!this.config.selectedTanMethod?.isDecoupled && !tan) {
+            throw Error('TAN must be provided for non-decoupled TAN methods');
         }
         if (!this.isInitialized) {
             throw Error('dialog must be initialized before sending a TAN message');
@@ -159,7 +162,7 @@ export class Dialog {
         if (this.config.userId && this.config.pin && this.config.tanMethodId) {
             const hktan = {
                 header: { segId: HKTAN.Id, segNr: 0, version: this.config.selectedTanMethod.version },
-                tanProcess: 2,
+                tanProcess: this.config.selectedTanMethod?.isDecoupled ? TanProcess.Status : TanProcess.Process2,
                 segId: refSegId,
                 orderRef: tanOrderReference,
                 nextTan: false,

package/dist/interactions/customerInteraction.js

@@ -19,29 +19,37 @@ export class CustomerInteraction {
     handleBaseResponse(response) {
         const hnhbk = response.findSegment(HNHBK.Id);
         const dialogId = hnhbk?.dialogId ?? '';
-        if (response.hasReturnCode(30)) {
+        const bankAnswers = response.getBankAnswers();
+        if (response.hasReturnCode(30) ||
+            response.hasReturnCode(3955) ||
+            response.hasReturnCode(3956) ||
+            response.hasReturnCode(3957)) {
             const hitan = response.findSegment(HITAN.Id);
             if (hitan) {
                 return {
                     dialogId,
                     success: true,
                     bankingInformationUpdated: false,
-                    bankAnswers: response.getBankAnswers(),
+                    bankAnswers: bankAnswers,
                     requiresTan: true,
                     tanReference: hitan.orderReference,
-                    tanChallenge: hitan.challenge,
+                    tanChallenge: hitan.challenge ??
+                        bankAnswers.find((answer) => answer.code === 3955)?.text ??
+                        bankAnswers.find((answer) => answer.code === 3956)?.text ??
+                        bankAnswers.find((answer) => answer.code === 3957)?.text ??
+                        '',
                     tanMediaName: hitan.tanMedia,
                 };
             }
             else {
-                throw new Error('HITAN segment not found in response, despite return code 30');
+                throw new Error('HITAN segment not found in response, despite return code indicating security approval');
             }
         }
         return {
             dialogId,
             success: response.getHighestReturnCode() < 9000,
             bankingInformationUpdated: false,
-            bankAnswers: response.getBankAnswers(),
+            bankAnswers: bankAnswers,
             requiresTan: false,
         };
     }

package/dist/interactions/initDialogInteraction.js

@@ -60,16 +60,29 @@ export class InitDialogInteraction extends CustomerInteraction {
         const hibpa = response.findSegment(HIBPA.Id);
         if (hibpa) {
             const hitansSegments = response.findAllSegments(HITANS.Id);
+            hitansSegments.sort((a, b) => b.header.version - a.header.version);
             const supportedTanMethods = [];
             hitansSegments.forEach((hitans) => {
-                supportedTanMethods.push(...(hitans?.params.tanMethods.map((t) => ({
-                    id: t.secFunc,
-                    name: t.methodName,
+                supportedTanMethods.push(...(hitans?.params.tanMethods
+                    .map((method) => ({
+                    id: method.secFunc,
+                    name: method.methodName,
                     version: hitans.header.version,
-                    activeTanMediaCount: t.activeTanMedia,
+                    isDecoupled: isDecoupledTanMethod(method),
+                    activeTanMediaCount: method.activeTanMedia,
                     activeTanMedia: [],
-                    tanMediaRequirement: t.tanMediaRequired,
-                })) ?? []));
+                    tanMediaRequirement: method.tanMediaRequired,
+                    decoupled: isDecoupledTanMethod(method)
+                        ? {
+                            maxStatusRequests: method.decoupledMaxStatusRequests,
+                            waitingSecondsBeforeFirstStatusRequest: method.decoupledWaitBeforeFirstStatusRequest,
+                            waitingSecondsBetweenStatusRequests: method.decoupledWaitBetweenStatusRequests,
+                            manualConfirmationAllowed: method.decoupledManualConfirmationAllowed ?? false,
+                            autoConfirmationAllowed: method.decoupledAutoConfirmationAllowed ?? false,
+                        }
+                        : undefined,
+                }))
+                    .filter((method) => !supportedTanMethods.some((existing) => existing.id === method.id)) ?? []));
             });
             let bankingUrl = this.config.bankingUrl;
             const hikom = response.findSegment(HIKOM.Id);
@@ -155,3 +168,16 @@ export class InitDialogInteraction extends CustomerInteraction {
             currentBankingInformationSnapshot !== JSON.stringify(this.config.bankingInformation);
     }
 }
+function isDecoupledTanMethod(tanMethod) {
+    if (tanMethod.zkaMethod === 'Decoupled' || tanMethod.zkaMethod === 'DecoupledPush') {
+        return true;
+    }
+    if (tanMethod.decoupledMaxStatusRequests !== undefined ||
+        tanMethod.decoupledWaitBeforeFirstStatusRequest !== undefined ||
+        tanMethod.decoupledWaitBetweenStatusRequests !== undefined ||
+        tanMethod.decoupledManualConfirmationAllowed !== undefined ||
+        tanMethod.decoupledAutoConfirmationAllowed !== undefined) {
+        return true;
+    }
+    return false;
+}

package/dist/interactions/tanMediaInteraction.js

@@ -21,7 +21,9 @@ export class TanMediaInteraction extends CustomerOrderInteraction {
     handleResponse(response, clientResponse) {
         const hitab = response.findSegment(HITAB.Id);
         if (hitab) {
-            clientResponse.tanMediaList = hitab.mediaList.map((media) => media.name).filter((name) => name);
+            clientResponse.tanMediaList = (hitab.mediaList ?? [])
+                .map((media) => media.name)
+                .filter((name) => name);
         }
     }
 }

package/dist/segment.js

@@ -43,12 +43,13 @@ export function segmentToString(segment) {
         text += ` RefSeg: ${segment.header.refSegNr}`;
     }
     const segmentDefinition = getSegmentDefinition(segment.header.segId);
-    let texts = segmentDefinition.elements.map((element, index) => {
+    let texts = segmentDefinition.getElementsForVersion(segment.header.version).map((element) => {
         if (element.maxCount > 1) {
-            return keyedSegment[element.name]
-                .map((value) => element.toString(value))
-                .filter((text) => !!text)
-                .join('; ');
+            return (keyedSegment[element.name] ??
+                []
+                    .map((value) => element.toString(value))
+                    .filter((text) => !!text)
+                    .join('; '));
         }
         else {
             return element.toString(keyedSegment[element.name]);

package/dist/segmentDefinition.js

@@ -3,6 +3,9 @@ import { SegmentHeaderGroup } from './segmentHeader.js';
 export class SegmentDefinition {
     id = this.constructor.name;
     static header = new SegmentHeaderGroup();
+    getElementsForVersion(version) {
+        return this.elements.filter((element) => version >= (element.minVersion ?? 0) && version <= (element.maxVersion ?? Number.MAX_SAFE_INTEGER));
+    }
     encode(data) {
         const headerText = SegmentDefinition.header.encode(data.header, [data.header.segId], data.header.version);
         const elementsText = encodeElements(data, this.elements, '+', data.header.version, [data.header.segId]);

package/dist/segments/HITAN.js

@@ -1,7 +1,6 @@
 import { Time } from '../dataElements/Time.js';
 import { Dat } from '../dataElements/Dat.js';
 import { Binary } from '../dataElements/Binary.js';
-import { Numeric } from '../dataElements/Numeric.js';
 import { AlphaNumeric } from '../dataElements/AlphaNumeric.js';
 import { DataGroup } from '../dataGroups/DataGroup.js';
 import { SegmentDefinition } from '../segmentDefinition.js';
@@ -10,9 +9,9 @@ import { SegmentDefinition } from '../segmentDefinition.js';
  */
 export class HITAN extends SegmentDefinition {
     static Id = this.name;
-    version = 6;
+    version = 7;
     elements = [
-        new Numeric('tanProcess', 1, 1, 1),
+        new AlphaNumeric('tanProcess', 1, 1, 1),
         new Binary('orderHash', 0, 1, 256),
         new AlphaNumeric('orderReference', 0, 1, 35),
         new AlphaNumeric('challenge', 0, 1, 2048),

package/dist/segments/HITANS.js

@@ -9,7 +9,7 @@ import { BusinessTransactionParameter } from './businessTransactionParameter.js'
  */
 export class HITANS extends BusinessTransactionParameter {
     static Id = this.name;
-    version = 6;
+    version = 7;
     constructor() {
         super([
             new YesNo('oneStepAllowed', 1, 1),
@@ -23,8 +23,8 @@ export class HITANS extends BusinessTransactionParameter {
                 new AlphaNumeric('zkaMethod', 0, 1, 32, 4),
                 new AlphaNumeric('zkaVersion', 0, 1, 10, 4),
                 new AlphaNumeric('methodName', 1, 1, 30, 1),
-                new Numeric('tanMaxLen', 1, 1, 2, 1),
-                new Numeric('format', 1, 1, 1, 1),
+                new Numeric('tanMaxLen', 0, 1, 2, 1),
+                new Numeric('format', 0, 1, 1, 1),
                 new AlphaNumeric('challengeText', 1, 1, 30, 1),
                 new Numeric('maxChallengeLen', 1, 1, 4, 1),
                 new Numeric('supportedActiveTanLists', 0, 1, 1, 1, 5),
@@ -42,6 +42,11 @@ export class HITANS extends BusinessTransactionParameter {
                 new Numeric('tanMediaRequired', 1, 1, 1, 3),
                 new YesNo('hdducRequired', 1, 1, 6),
                 new Numeric('activeTanMedia', 0, 1, 1, 3),
+                new Numeric('decoupledMaxStatusRequests', 0, 1, 3, 7),
+                new Numeric('decoupledWaitBeforeFirstStatusRequest', 0, 1, 3, 7),
+                new Numeric('decoupledWaitBetweenStatusRequests', 0, 1, 3, 7),
+                new YesNo('decoupledManualConfirmationAllowed', 0, 1, 7),
+                new YesNo('decoupledAutoConfirmationAllowed', 0, 1, 7),
             ], 1, 98),
         ]);
     }

package/dist/segments/HKTAN.js

@@ -10,10 +10,10 @@ import { SegmentDefinition } from '../segmentDefinition.js';
  */
 export class HKTAN extends SegmentDefinition {
     static Id = this.name;
-    static Version = 6;
+    static Version = 7;
     version = HKTAN.Version;
     elements = [
-        new Numeric('tanProcess', 1, 1, 1),
+        new AlphaNumeric('tanProcess', 1, 1, 1),
         new AlphaNumeric('segId', 0, 1, 6),
         new InternationalAccountGroup('customerAccount', 0, 1),
         new Binary('orderHash', 0, 1, 256),

package/dist/tests/HITAB.test.js

@@ -1,12 +1,13 @@
 import { describe, it, expect } from 'vitest';
 import { registerSegments } from '../segments/registry.js';
 import { HITAB } from '../segments/HITAB.js';
-import { decode, encode } from '../segment.js';
+import { decode, encode, segmentToString } from '../segment.js';
 registerSegments();
 describe('HITAB', () => {
     it('decodes correctly', () => {
         const text = "HITAB:5:4:3+0+A:1:::::::::::Media1::::::::+A:1:::::::::::Media2::::::::'";
         const segment = decode(text);
+        expect(segment.mediaList).toBeDefined();
         expect(segment.mediaList.length).toBe(2);
         expect(segment.mediaList[0].name).toBe('Media1');
     });
@@ -16,4 +17,10 @@ describe('HITAB', () => {
         const segment = decode(text);
         expect(encode(segment)).toBe(text);
     });
+    it('decodes and stringifies when list is empty', () => {
+        HITAB.Id;
+        const text = 'HITAB:4:5:3+0';
+        const segment = decode(text);
+        expect(segmentToString(segment)).toBe('   4. HITAB v5 RefSeg: 3; tanUsage: 0');
+    });
 });

package/dist/tests/HKTAN.test.js

@@ -2,13 +2,14 @@ import { describe, it, expect } from 'vitest';
 import { registerSegments } from '../segments/registry.js';
 import { HKTAN } from '../segments/HKTAN.js';
 import { decode, encode } from '../segment.js';
+import { TanProcess } from '../codes.js';
 registerSegments();
 describe('HKTAN', () => {
     it('encode', () => {
         const segment = {
             header: { segId: HKTAN.Id, segNr: 1, version: 6 },
             segId: 'HKKAZ',
-            tanProcess: 4,
+            tanProcess: TanProcess.Process4,
             tanMedia: 'Media1',
         };
         expect(encode(segment)).toBe("HKTAN:1:6+4+HKKAZ+++++++++Media1'");

package/dist/types/client.d.ts

@@ -35,10 +35,10 @@ export declare class FinTSClient {
     /**
      * Continues the synchronization transaction 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
+     * @param tan The TAN entered by the user, can be omitted if a decoupled TAN method is used
      * @returns the synchronization response
      */
-    synchronizeWithTan(tanReference: string, tan: string): Promise<SynchronizeResponse>;
+    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
@@ -54,10 +54,10 @@ export declare class FinTSClient {
     /**
      * Continues the account balance 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
+     * @param tan The TAN entered by the user, can be omitted if a decoupled TAN method is used
      * @returns the account balance response
      */
-    getAccountBalanceWithTan(tanReference: string, tan: string): Promise<AccountBalanceResponse>;
+    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
@@ -75,10 +75,10 @@ export declare class FinTSClient {
     /**
      * Continues the account 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
+     * @param tan The TAN entered by the user, can be omitted if a decoupled TAN method is used
      * @returns an account statements response containing an array of statements
      */
-    getAccountStatementsWithTan(tanReference: string, tan: string): Promise<StatementResponse>;
+    getAccountStatementsWithTan(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,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,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,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIzF;;;;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,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAIlG;;;;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,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAIlF,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,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,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;YAInF,6BAA6B;YAqB7B,kCAAkC;YA0ClC,UAAU;CAcxB"}

package/dist/types/codes.d.ts

@@ -65,4 +65,11 @@ export declare enum TanUsage {
     Single = 1,
     MobileAndGenerator = 2
 }
+export declare enum TanProcess {
+    Process1 = "1",
+    Process2 = "2",
+    Process3 = "3",
+    Process4 = "4",
+    Status = "S"
+}
 //# sourceMappingURL=codes.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../src/codes.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IAClB,OAAO,IAAI;IACX,MAAM,IAAI;IACV,OAAO,IAAI;IACX,MAAM,IAAI;CACX;AAED,oBAAY,OAAO;IACjB,OAAO,IAAI;IACX,KAAK,IAAI;IACT,KAAK,IAAI;CACV;AAED,oBAAY,aAAa;IACvB,IAAI,IAAI;IACR,MAAM,IAAI;IACV,MAAM,IAAI;IACV,MAAM,IAAI;IACV,UAAU,IAAI;CACf;AAED,oBAAY,QAAQ;IAClB,WAAW,IAAI;IACf,kBAAkB,IAAI;IACtB,WAAW,IAAI;CAChB;AAED,oBAAY,SAAS;IACnB,WAAW,MAAM;IACjB,GAAG,MAAM;IACT,IAAI,MAAM;IACV,KAAK,MAAM;IACX,IAAI,MAAM;CACX;AAED,oBAAY,QAAQ;IAClB,iBAAiB,IAAI;IACrB,cAAc,IAAI;CACnB;AAED,oBAAY,WAAW;IACrB,MAAM,MAAM;IACZ,KAAK,MAAM;CACZ;AAED,oBAAY,YAAY;IACtB,GAAG,IAAI;IACP,MAAM,IAAI;IACV,SAAS,IAAI;CACd;AAED,oBAAY,aAAa;IACvB,GAAG,MAAM;IACT,IAAI,MAAM;IACV,YAAY,MAAM;IAClB,MAAM,MAAM;IACZ,OAAO,MAAM;IACb,SAAS,MAAM;CAChB;AAED,oBAAY,mBAAmB;IAC7B,UAAU,IAAI;IACd,QAAQ,IAAI;IACZ,QAAQ,IAAI;CACb;AAED,oBAAY,SAAS;IACnB,MAAM,IAAI;IACV,SAAS,IAAI;IACb,kBAAkB,IAAI;IACtB,qBAAqB,IAAI;CAC1B;AAED,oBAAY,QAAQ;IAClB,GAAG,IAAI;IACP,MAAM,IAAI;IACV,kBAAkB,IAAI;CACvB"}
+{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../src/codes.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IACnB,OAAO,IAAI;IACX,MAAM,IAAI;IACV,OAAO,IAAI;IACX,MAAM,IAAI;CACV;AAED,oBAAY,OAAO;IAClB,OAAO,IAAI;IACX,KAAK,IAAI;IACT,KAAK,IAAI;CACT;AAED,oBAAY,aAAa;IACxB,IAAI,IAAI;IACR,MAAM,IAAI;IACV,MAAM,IAAI;IACV,MAAM,IAAI;IACV,UAAU,IAAI;CACd;AAED,oBAAY,QAAQ;IACnB,WAAW,IAAI;IACf,kBAAkB,IAAI;IACtB,WAAW,IAAI;CACf;AAED,oBAAY,SAAS;IACpB,WAAW,MAAM;IACjB,GAAG,MAAM;IACT,IAAI,MAAM;IACV,KAAK,MAAM;IACX,IAAI,MAAM;CACV;AAED,oBAAY,QAAQ;IACnB,iBAAiB,IAAI;IACrB,cAAc,IAAI;CAClB;AAED,oBAAY,WAAW;IACtB,MAAM,MAAM;IACZ,KAAK,MAAM;CACX;AAED,oBAAY,YAAY;IACvB,GAAG,IAAI;IACP,MAAM,IAAI;IACV,SAAS,IAAI;CACb;AAED,oBAAY,aAAa;IACxB,GAAG,MAAM;IACT,IAAI,MAAM;IACV,YAAY,MAAM;IAClB,MAAM,MAAM;IACZ,OAAO,MAAM;IACb,SAAS,MAAM;CACf;AAED,oBAAY,mBAAmB;IAC9B,UAAU,IAAI;IACd,QAAQ,IAAI;IACZ,QAAQ,IAAI;CACZ;AAED,oBAAY,SAAS;IACpB,MAAM,IAAI;IACV,SAAS,IAAI;IACb,kBAAkB,IAAI;IACtB,qBAAqB,IAAI;CACzB;AAED,oBAAY,QAAQ;IACnB,GAAG,IAAI;IACP,MAAM,IAAI;IACV,kBAAkB,IAAI;CACtB;AAED,oBAAY,UAAU;IACrB,QAAQ,MAAM;IACd,QAAQ,MAAM;IACd,QAAQ,MAAM;IACd,QAAQ,MAAM;IACd,MAAM,MAAM;CACZ"}

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D;;GAEG;AACH,qBAAa,WAAW;IAKb,SAAS,EAAE,MAAM;IACjB,cAAc,EAAE,MAAM;IAC7B,OAAO,CAAC,GAAG,CAAC;IACZ,OAAO,CAAC,kBAAkB,CAAC;IACpB,MAAM,CAAC;IACP,GAAG,CAAC;IAEJ,WAAW,CAAC;IACZ,YAAY,CAAC;IACb,UAAU,CAAC;IAClB,OAAO,CAAC,OAAO;IAdjB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,YAAY,UAAS;IAErB,OAAO;IA+CP;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,eAAe,CACpB,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,GACxB,WAAW;IAgBd;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,sBAAsB,CAC3B,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,GACxB,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;IAQnC;;;OAGG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM;IAYnC;;OAEG;IACH,IAAI,iBAAiB,IAAI,SAAS,GAAG,SAAS,CAE7C;IAED;;;OAGG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIhD;;;;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;IAetE;;;OAGG;IACH,cAAc,CAAC,aAAa,EAAE,MAAM;CASrC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D;;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;IACP,GAAG,CAAC;IAEJ,WAAW,CAAC;IACZ,YAAY,CAAC;IACb,UAAU,CAAC;IAClB,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;IAQnC;;;OAGG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM;IAYnC;;OAEG;IACH,IAAI,iBAAiB,IAAI,SAAS,GAAG,SAAS,CAE7C;IAED;;;OAGG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIhD;;;;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;IAetE;;;OAGG;IACH,cAAc,CAAC,aAAa,EAAE,MAAM;CASpC"}

package/dist/types/dialog.d.ts

@@ -14,7 +14,7 @@ export declare class Dialog {
     initialize(interaction: InitDialogInteraction): Promise<InitResponse>;
     end(): Promise<boolean>;
     startCustomerOrderInteraction<TClientResponse extends ClientResponse>(interaction: CustomerOrderInteraction): Promise<TClientResponse>;
-    sendTanMessage(refSegId: string, tanOrderReference: string, tan: string): Promise<Message>;
+    sendTanMessage(refSegId: string, tanOrderReference: string, tan?: string): Promise<Message>;
     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":"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,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmDhG,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;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"}

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

@@ -9,7 +9,7 @@ import { Segment } from '../segment.js';
  * @property success Whether the interaction was successful
  * @property bankingInformationUpdated Whether the banking information were updated
  * @property bankAnswers The answers from the bank
- * @property requiresTan Whether a TAN is required to continue the transaction
+ * @property requiresTan Whether security approval is required to continue the transaction (a user entered TAN or decoupled approval)
  * @property tanReference A reference for the TAN which needs to be provided in the continuation method
  * @property tanChallenge A prompt provided by the bank which should be displayed to the user to enter the TAN
  * @property tanMediaName The name of the TAN media to use for the TAN input

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

@@ -1 +1 @@
-{"version":3,"file":"customerInteraction.d.ts","sourceRoot":"","sources":["../../../src/interactions/customerInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIxC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,yBAAyB,EAAE,OAAO,CAAC;IACnC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,8BAAsB,mBAAmB;IAGrB,KAAK,EAAE,MAAM;IAFhC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEG,KAAK,EAAE,MAAM;IAEhC,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,EAAE;IAIzC,iBAAiB,CAAC,SAAS,SAAS,cAAc,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS;IAUhF,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,EAAE;IAC/D,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,GAAG,IAAI;IAE1F,OAAO,CAAC,kBAAkB;CA8B1B;AAED,8BAAsB,wBAAyB,SAAQ,mBAAmB;IACvC,aAAa,EAAE,MAAM;gBAA3C,KAAK,EAAE,MAAM,EAAS,aAAa,EAAE,MAAM;CAGvD"}
+{"version":3,"file":"customerInteraction.d.ts","sourceRoot":"","sources":["../../../src/interactions/customerInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIxC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,yBAAyB,EAAE,OAAO,CAAC;IACnC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,8BAAsB,mBAAmB;IAGrB,KAAK,EAAE,MAAM;IAFhC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEG,KAAK,EAAE,MAAM;IAEhC,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,EAAE;IAIzC,iBAAiB,CAAC,SAAS,SAAS,cAAc,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS;IAUhF,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,EAAE;IAC/D,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,GAAG,IAAI;IAE1F,OAAO,CAAC,kBAAkB;CAyC1B;AAED,8BAAsB,wBAAyB,SAAQ,mBAAmB;IACvC,aAAa,EAAE,MAAM;gBAA3C,KAAK,EAAE,MAAM,EAAS,aAAa,EAAE,MAAM;CAGvD"}

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

@@ -1 +1 @@
-{"version":3,"file":"initDialogInteraction.d.ts","sourceRoot":"","sources":["../../../src/interactions/initDialogInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzG,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAe,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAiB3E,MAAM,WAAW,YAAa,SAAQ,cAAc;IACnD,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACxC;AAED,qBAAa,qBAAsB,SAAQ,mBAAmB;IAErD,MAAM,EAAE,WAAW;IACnB,YAAY;IACZ,mBAAmB,CAAC;gBAFpB,MAAM,EAAE,WAAW,EACnB,YAAY,UAAQ,EACpB,mBAAmB,CAAC,sCAA0B;IAKtD,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,EAAE;IAoC5C,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY;CA8H9D"}
+{"version":3,"file":"initDialogInteraction.d.ts","sourceRoot":"","sources":["../../../src/interactions/initDialogInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzG,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAe,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAiB3E,MAAM,WAAW,YAAa,SAAQ,cAAc;IACnD,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACxC;AAED,qBAAa,qBAAsB,SAAQ,mBAAmB;IAErD,MAAM,EAAE,WAAW;IACnB,YAAY;IACZ,mBAAmB,CAAC;gBAFpB,MAAM,EAAE,WAAW,EACnB,YAAY,UAAQ,EACpB,mBAAmB,CAAC,sCAA0B;IAKtD,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,EAAE;IAoC5C,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY;CA2I9D"}

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

@@ -1 +1 @@
-{"version":3,"file":"tanMediaInteraction.d.ts","sourceRoot":"","sources":["../../../src/interactions/tanMediaInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzG,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAK3C,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,qBAAa,mBAAoB,SAAQ,wBAAwB;;IAK/D,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,EAAE;IAgB5C,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB;CAMnE"}
+{"version":3,"file":"tanMediaInteraction.d.ts","sourceRoot":"","sources":["../../../src/interactions/tanMediaInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzG,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAK3C,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACvD,YAAY,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,qBAAa,mBAAoB,SAAQ,wBAAwB;;IAKhE,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,EAAE;IAgB5C,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB;CAQlE"}

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

@@ -1 +1 @@
-{"version":3,"file":"segment.d.ts","sourceRoot":"","sources":["../../src/segment.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,OAAO,GAAG;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA6B5C;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAQ5C;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CA0BxD"}
+{"version":3,"file":"segment.d.ts","sourceRoot":"","sources":["../../src/segment.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,MAAM,OAAO,GAAG;IACrB,MAAM,EAAE,aAAa,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,OAAO,GAAG;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA6B5C;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAQ5C;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CA6BxD"}

package/dist/types/segmentDefinition.d.ts

@@ -6,6 +6,7 @@ export declare abstract class SegmentDefinition {
     abstract version: number;
     static header: SegmentHeaderGroup;
     abstract elements: DataElement[];
+    getElementsForVersion(version: number): DataElement[];
     encode(data: Segment): string;
 }
 //# sourceMappingURL=segmentDefinition.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"segmentDefinition.d.ts","sourceRoot":"","sources":["../../src/segmentDefinition.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,8BAAsB,iBAAiB;IACrC,EAAE,SAAyB;IAE3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,MAAM,qBAA4B;IACzC,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;IAEjC,MAAM,CAAC,IAAI,EAAE,OAAO;CAKrB"}
+{"version":3,"file":"segmentDefinition.d.ts","sourceRoot":"","sources":["../../src/segmentDefinition.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,8BAAsB,iBAAiB;IACtC,EAAE,SAAyB;IAE3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,MAAM,qBAA4B;IACzC,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;IAEjC,qBAAqB,CAAC,OAAO,EAAE,MAAM;IAMrC,MAAM,CAAC,IAAI,EAAE,OAAO;CAKpB"}

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

@@ -7,7 +7,7 @@ import { Segment } from '../segment.js';
 import { SegmentDefinition } from '../segmentDefinition.js';
 export type HITABSegment = Segment & {
     tanUsage: TanUsage;
-    mediaList: TanMedia[];
+    mediaList?: TanMedia[];
 };
 export type TanMedia = {
     class: TanMediaClass;

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

@@ -1 +1 @@
-{"version":3,"file":"HITAB.d.ts","sourceRoot":"","sources":["../../../src/segments/HITAB.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAA6B,MAAM,uCAAuC,CAAC;AACxG,OAAO,EAAE,OAAO,EAAgB,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,cAAc,CAAC,EAAE,IAAI,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,qBAAa,KAAM,SAAQ,iBAAiB;IAC1C,MAAM,CAAC,EAAE,SAAa;IACtB,OAAO,SAAK;IACZ,QAAQ,0BA0BN;CACH"}
+{"version":3,"file":"HITAB.d.ts","sourceRoot":"","sources":["../../../src/segments/HITAB.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAA6B,MAAM,uCAAuC,CAAC;AACxG,OAAO,EAAE,OAAO,EAAgB,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG;IACpC,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,cAAc,CAAC,EAAE,IAAI,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,qBAAa,KAAM,SAAQ,iBAAiB;IAC3C,MAAM,CAAC,EAAE,SAAa;IACtB,OAAO,SAAK;IACZ,QAAQ,0BA0BN;CACF"}

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

@@ -1,12 +1,12 @@
 import { Binary } from '../dataElements/Binary.js';
-import { Numeric } from '../dataElements/Numeric.js';
 import { AlphaNumeric } from '../dataElements/AlphaNumeric.js';
 import { TimeStamp } from '../dataGroups/TimeStamp.js';
 import { DataGroup } from '../dataGroups/DataGroup.js';
 import { Segment } from '../segment.js';
 import { SegmentDefinition } from '../segmentDefinition.js';
+import { TanProcess } from '../codes.js';
 export type HITANSegment = Segment & {
-    tanProcess: number;
+    tanProcess: TanProcess;
     orderHash?: string;
     orderReference?: string;
     challenge?: string;
@@ -20,6 +20,6 @@ export type HITANSegment = Segment & {
 export declare class HITAN extends SegmentDefinition {
     static Id: string;
     version: number;
-    elements: (DataGroup | AlphaNumeric | Numeric | Binary)[];
+    elements: (DataGroup | AlphaNumeric | Binary)[];
 }
 //# sourceMappingURL=HITAN.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"HITAN.d.ts","sourceRoot":"","sources":["../../../src/segments/HITAN.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,qBAAa,KAAM,SAAQ,iBAAiB;IAC1C,MAAM,CAAC,EAAE,SAAa;IACtB,OAAO,SAAK;IACZ,QAAQ,kDAQN;CACH"}
+{"version":3,"file":"HITAN.d.ts","sourceRoot":"","sources":["../../../src/segments/HITAN.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG;IACpC,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,qBAAa,KAAM,SAAQ,iBAAiB;IAC3C,MAAM,CAAC,EAAE,SAAa;IACtB,OAAO,SAAK;IACZ,QAAQ,wCAQN;CACF"}

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

@@ -11,11 +11,11 @@ export type HitansTanMethod = {
     secFunc: number;
     tanProcess: number;
     methodId: string;
-    zkaMethod: string;
-    zkaVersion: string;
+    zkaMethod?: string;
+    zkaVersion?: string;
     methodName: string;
-    tanMaxLen: number;
-    format: number;
+    tanMaxLen?: number;
+    format?: number;
     challengeText: string;
     maxChallengeLen: number;
     multipleTans: boolean;
@@ -29,6 +29,11 @@ export type HitansTanMethod = {
     tanMediaRequired: TanMediaRequirement;
     hdducRequired: boolean;
     activeTanMedia: number;
+    decoupledMaxStatusRequests?: number;
+    decoupledWaitBeforeFirstStatusRequest?: number;
+    decoupledWaitBetweenStatusRequests?: number;
+    decoupledManualConfirmationAllowed?: boolean;
+    decoupledAutoConfirmationAllowed?: boolean;
 };
 /**
  * Parameters for two-step TAN methods

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

@@ -1 +1 @@
-{"version":3,"file":"HITANS.d.ts","sourceRoot":"","sources":["../../../src/segments/HITANS.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAMlD,OAAO,EAAE,4BAA4B,EAAE,mCAAmC,EAAE,MAAM,mCAAmC,CAAC;AAEtH,MAAM,MAAM,aAAa,GAAG,mCAAmC,CAAC,eAAe,CAAC,CAAC;AAEjF,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,mBAAmB,CAAC;IACtC,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,qBAAa,MAAO,SAAQ,4BAA4B;IACtD,MAAM,CAAC,EAAE,SAAa;IACtB,OAAO,SAAK;;CA0Cb"}
+{"version":3,"file":"HITANS.d.ts","sourceRoot":"","sources":["../../../src/segments/HITANS.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAMlD,OAAO,EAAE,4BAA4B,EAAE,mCAAmC,EAAE,MAAM,mCAAmC,CAAC;AAEtH,MAAM,MAAM,aAAa,GAAG,mCAAmC,CAAC,eAAe,CAAC,CAAC;AAEjF,MAAM,MAAM,eAAe,GAAG;IAC7B,cAAc,EAAE,OAAO,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,eAAe,EAAE,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,mBAAmB,CAAC;IACtC,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,qCAAqC,CAAC,EAAE,MAAM,CAAC;IAC/C,kCAAkC,CAAC,EAAE,MAAM,CAAC;IAC5C,kCAAkC,CAAC,EAAE,OAAO,CAAC;IAC7C,gCAAgC,CAAC,EAAE,OAAO,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH,qBAAa,MAAO,SAAQ,4BAA4B;IACvD,MAAM,CAAC,EAAE,SAAa;IACtB,OAAO,SAAK;;CA+CZ"}

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

@@ -6,8 +6,9 @@ import { InternationalAccount } from '../dataGroups/InternationalAccount.js';
 import { DataGroup } from '../dataGroups/DataGroup.js';
 import { Segment } from '../segment.js';
 import { SegmentDefinition } from '../segmentDefinition.js';
+import { TanProcess } from '../codes.js';
 export type HKTANSegment = Segment & {
-    tanProcess: number;
+    tanProcess: TanProcess;
     segId: string;
     customerAccount?: InternationalAccount;
     orderHash?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"HKTAN.d.ts","sourceRoot":"","sources":["../../../src/segments/HKTAN.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAA6B,MAAM,uCAAuC,CAAC;AACxG,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,qBAAa,KAAM,SAAQ,iBAAiB;IAC1C,MAAM,CAAC,EAAE,SAAa;IACtB,MAAM,CAAC,OAAO,SAAK;IACnB,OAAO,SAAiB;IACxB,QAAQ,0DAwBN;CACH"}
+{"version":3,"file":"HKTAN.d.ts","sourceRoot":"","sources":["../../../src/segments/HKTAN.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAA6B,MAAM,uCAAuC,CAAC;AACxG,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG;IACpC,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,qBAAa,KAAM,SAAQ,iBAAiB;IAC3C,MAAM,CAAC,EAAE,SAAa;IACtB,MAAM,CAAC,OAAO,SAAK;IACnB,OAAO,SAAiB;IACxB,QAAQ,0DAwBN;CACF"}

package/dist/types/tanMethod.d.ts

@@ -1,10 +1,31 @@
 import { TanMediaRequirement } from './codes.js';
+/**
+ * Represents a TAN (Transaction Authentication Number) method used to approve transactions.
+ *
+ * @property {number} id - The unique identifier for the TAN method.
+ * @property {string} name - The name of the TAN method.
+ * @property {number} version - The version of the TAN method.
+ * @property {boolean} isDecoupled - Indicates if the TAN method is decoupled, in which case no real TAN needs to be provided.
+ * @property {number} activeTanMediaCount - The number of active TAN media available for approval.
+ * @property {string[]} activeTanMedia - The names of active TAN media.
+ * @property {TanMediaRequirement} tanMediaRequirement - A value indicating wether a TAN media is required.
+ * @property {DecoupledParams} [decoupled] - Optional parameters for decoupled TAN methods, is only set when isDecoupled is also true.
+ */
 export type TanMethod = {
     id: number;
     name: string;
     version: number;
+    isDecoupled: boolean;
     activeTanMediaCount: number;
     activeTanMedia: string[];
     tanMediaRequirement: TanMediaRequirement;
+    decoupled?: DecoupledParams;
+};
+export type DecoupledParams = {
+    maxStatusRequests: number;
+    waitingSecondsBeforeFirstStatusRequest: number;
+    waitingSecondsBetweenStatusRequests: number;
+    manualConfirmationAllowed: boolean;
+    autoConfirmationAllowed: boolean;
 };
 //# sourceMappingURL=tanMethod.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tanMethod.d.ts","sourceRoot":"","sources":["../../src/tanMethod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,EAAE,mBAAmB,CAAC;CAC1C,CAAC"}
+{"version":3,"file":"tanMethod.d.ts","sourceRoot":"","sources":["../../src/tanMethod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,SAAS,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sCAAsC,EAAE,MAAM,CAAC;IAC/C,mCAAmC,EAAE,MAAM,CAAC;IAC5C,yBAAyB,EAAE,OAAO,CAAC;IACnC,uBAAuB,EAAE,OAAO,CAAC;CACjC,CAAC"}

package/package.json

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