fints-lib 0.6.0 → 0.7.0

package/dist/errors/fints-error.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidSystemIdError = exports.StrongAuthenticationRequiredError = exports.PinError = exports.MessageStructureError = exports.DialogAbortedError = exports.OrderRejectedError = exports.AuthenticationError = exports.FinTSError = void 0;
+exports.createFinTSError = createFinTSError;
+const error_codes_1 = require("../error-codes");
+/**
+ * Base class for FinTS-specific errors with enhanced error information
+ */
+class FinTSError extends Error {
+    constructor(message, code, returnValue) {
+        super(message);
+        this.name = "FinTSError";
+        this.code = code || "UNKNOWN";
+        this.returnValue = returnValue;
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, FinTSError);
+        }
+    }
+}
+exports.FinTSError = FinTSError;
+/**
+ * Error thrown when customer authentication fails
+ */
+class AuthenticationError extends FinTSError {
+    constructor(message, code, returnValue) {
+        super(message, code, returnValue);
+        this.name = "AuthenticationError";
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+/**
+ * Error thrown when an order/transaction is rejected
+ */
+class OrderRejectedError extends FinTSError {
+    constructor(message, code, returnValue) {
+        super(message, code, returnValue);
+        this.name = "OrderRejectedError";
+    }
+}
+exports.OrderRejectedError = OrderRejectedError;
+/**
+ * Error thrown when the dialog is aborted by the server
+ */
+class DialogAbortedError extends FinTSError {
+    constructor(message, code, returnValue) {
+        super(message, code, returnValue);
+        this.name = "DialogAbortedError";
+    }
+}
+exports.DialogAbortedError = DialogAbortedError;
+/**
+ * Error thrown when a message has structural errors
+ */
+class MessageStructureError extends FinTSError {
+    constructor(message, code, returnValue) {
+        super(message, code, returnValue);
+        this.name = "MessageStructureError";
+    }
+}
+exports.MessageStructureError = MessageStructureError;
+/**
+ * Error thrown when a PIN is incorrect
+ */
+class PinError extends FinTSError {
+    constructor(message, code, returnValue) {
+        super(message, code, returnValue);
+        this.name = "PinError";
+    }
+}
+exports.PinError = PinError;
+/**
+ * Error thrown when strong customer authentication is required (PSD2)
+ */
+class StrongAuthenticationRequiredError extends FinTSError {
+    constructor(message, code, returnValue) {
+        super(message, code, returnValue);
+        this.name = "StrongAuthenticationRequiredError";
+    }
+}
+exports.StrongAuthenticationRequiredError = StrongAuthenticationRequiredError;
+/**
+ * Error thrown when system/customer ID is invalid
+ */
+class InvalidSystemIdError extends FinTSError {
+    constructor(message, code, returnValue) {
+        super(message, code, returnValue);
+        this.name = "InvalidSystemIdError";
+    }
+}
+exports.InvalidSystemIdError = InvalidSystemIdError;
+/**
+ * Mapping of error codes to error class constructors
+ */
+const ERROR_CODE_MAPPINGS = {
+    // PIN errors
+    9942: PinError,
+    // Authentication errors
+    9110: AuthenticationError,
+    // Strong authentication required (PSD2)
+    3076: StrongAuthenticationRequiredError,
+    3956: StrongAuthenticationRequiredError,
+    // Order/transaction errors
+    9120: OrderRejectedError,
+    9140: OrderRejectedError,
+    9340: OrderRejectedError,
+    // Dialog errors
+    9380: DialogAbortedError,
+    9800: DialogAbortedError,
+    // Message structure errors
+    9010: MessageStructureError,
+    9030: MessageStructureError,
+    9040: MessageStructureError,
+    // System ID errors
+    9931: InvalidSystemIdError,
+    9070: InvalidSystemIdError,
+};
+/**
+ * Factory function to create appropriate error based on error code
+ */
+function createFinTSError(code, message, returnValue) {
+    const formattedMessage = (0, error_codes_1.formatErrorCode)(code, message);
+    // Look up the appropriate error class based on error code
+    const ErrorClass = ERROR_CODE_MAPPINGS[code];
+    if (ErrorClass) {
+        return new ErrorClass(formattedMessage, code, returnValue);
+    }
+    // Generic FinTS error for unmapped codes
+    return new FinTSError(formattedMessage, code, returnValue);
+}
+//# sourceMappingURL=fints-error.js.map

package/dist/errors/fints-error.js.map

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

package/dist/errors/response-error.d.ts

@@ -0,0 +1,6 @@
+import { Response } from "../response";
+export declare class ResponseError extends Error {
+    response: Response;
+    errors: string[];
+    constructor(response: Response);
+}

package/dist/errors/response-error.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseError = void 0;
+const error_codes_1 = require("../error-codes");
+class ResponseError extends Error {
+    constructor(response) {
+        const errors = Array.from(response.returnValues().values())
+            .filter((value) => value.error)
+            .map((value) => (0, error_codes_1.formatErrorCode)(value.code, value.message));
+        super(`Error(s) in dialog: ${errors.join(", ")}.`);
+        this.response = response;
+        this.errors = errors;
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ResponseError);
+        }
+    }
+}
+exports.ResponseError = ResponseError;
+//# sourceMappingURL=response-error.js.map

package/dist/errors/response-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-error.js","sourceRoot":"","sources":["../../src/errors/response-error.ts"],"names":[],"mappings":";;;AACA,gDAAiD;AAEjD,MAAa,aAAc,SAAQ,KAAK;IAIpC,YAAY,QAAkB;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC;aACtD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;aAC9B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,6BAAe,EAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAEhE,KAAK,CAAC,uBAAuB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,qFAAqF;QACrF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QACjD,CAAC;IACL,CAAC;CACJ;AAlBD,sCAkBC"}

package/dist/errors/tan-required-error.d.ts

@@ -0,0 +1,40 @@
+import { Dialog } from "../dialog";
+import { DirectDebitSubmission, CreditTransferSubmission } from "../types";
+/**
+ * TAN process steps for multi-step flows
+ */
+export declare enum TanProcessStep {
+    INITIAL = "initial",
+    CHALLENGE_SENT = "challenge_sent",
+    CHALLENGE_RESPONSE_NEEDED = "challenge_response_needed",
+    COMPLETED = "completed"
+}
+export declare class TanRequiredError extends Error {
+    transactionReference: string;
+    challengeText: string;
+    challengeMedia: Buffer;
+    dialog: Dialog;
+    directDebitSubmission?: DirectDebitSubmission;
+    creditTransferSubmission?: CreditTransferSubmission;
+    /**
+     * Current step in the TAN process flow
+     */
+    processStep: TanProcessStep;
+    /**
+     * Segment that triggered the TAN requirement
+     */
+    triggeringSegment?: string;
+    /**
+     * Additional context information for debugging
+     */
+    context?: Record<string, any>;
+    constructor(message: string, transactionReference: string, challengeText: string, challengeMedia: Buffer, dialog: Dialog, processStep?: TanProcessStep, triggeringSegment?: string, context?: Record<string, any>);
+    /**
+     * Helper to check if this is a multi-step TAN flow
+     */
+    isMultiStep(): boolean;
+    /**
+     * Get a user-friendly description of the current step
+     */
+    getStepDescription(): string;
+}

package/dist/errors/tan-required-error.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TanRequiredError = exports.TanProcessStep = void 0;
+/**
+ * TAN process steps for multi-step flows
+ */
+var TanProcessStep;
+(function (TanProcessStep) {
+    TanProcessStep["INITIAL"] = "initial";
+    TanProcessStep["CHALLENGE_SENT"] = "challenge_sent";
+    TanProcessStep["CHALLENGE_RESPONSE_NEEDED"] = "challenge_response_needed";
+    TanProcessStep["COMPLETED"] = "completed";
+})(TanProcessStep || (exports.TanProcessStep = TanProcessStep = {}));
+class TanRequiredError extends Error {
+    constructor(message, transactionReference, challengeText, challengeMedia, dialog, processStep = TanProcessStep.CHALLENGE_RESPONSE_NEEDED, triggeringSegment, context) {
+        super(message);
+        this.transactionReference = transactionReference;
+        this.challengeText = challengeText;
+        this.challengeMedia = challengeMedia;
+        this.dialog = dialog;
+        this.processStep = processStep;
+        this.triggeringSegment = triggeringSegment;
+        this.context = context;
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, TanRequiredError);
+        }
+    }
+    /**
+     * Helper to check if this is a multi-step TAN flow
+     */
+    isMultiStep() {
+        return this.processStep !== TanProcessStep.COMPLETED;
+    }
+    /**
+     * Get a user-friendly description of the current step
+     */
+    getStepDescription() {
+        switch (this.processStep) {
+            case TanProcessStep.INITIAL:
+                return "TAN process initiated";
+            case TanProcessStep.CHALLENGE_SENT:
+                return "TAN challenge has been sent";
+            case TanProcessStep.CHALLENGE_RESPONSE_NEEDED:
+                return "TAN response required";
+            case TanProcessStep.COMPLETED:
+                return "TAN process completed";
+            default:
+                return "Unknown TAN process step";
+        }
+    }
+}
+exports.TanRequiredError = TanRequiredError;
+//# sourceMappingURL=tan-required-error.js.map

package/dist/errors/tan-required-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tan-required-error.js","sourceRoot":"","sources":["../../src/errors/tan-required-error.ts"],"names":[],"mappings":";;;AAGA;;GAEG;AACH,IAAY,cAKX;AALD,WAAY,cAAc;IACtB,qCAAmB,CAAA;IACnB,mDAAiC,CAAA;IACjC,yEAAuD,CAAA;IACvD,yCAAuB,CAAA;AAC3B,CAAC,EALW,cAAc,8BAAd,cAAc,QAKzB;AAED,MAAa,gBAAiB,SAAQ,KAAK;IAoBvC,YACI,OAAe,EACf,oBAA4B,EAC5B,aAAqB,EACrB,cAAsB,EACtB,MAAc,EACd,cAA8B,cAAc,CAAC,yBAAyB,EACtE,iBAA0B,EAC1B,OAA6B;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QACjD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;QAC3C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,qFAAqF;QACrF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;IAED;;OAEG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,WAAW,KAAK,cAAc,CAAC,SAAS,CAAC;IACzD,CAAC;IAED;;OAEG;IACI,kBAAkB;QACrB,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;YACvB,KAAK,cAAc,CAAC,OAAO;gBACvB,OAAO,uBAAuB,CAAC;YACnC,KAAK,cAAc,CAAC,cAAc;gBAC9B,OAAO,6BAA6B,CAAC;YACzC,KAAK,cAAc,CAAC,yBAAyB;gBACzC,OAAO,uBAAuB,CAAC;YACnC,KAAK,cAAc,CAAC,SAAS;gBACzB,OAAO,uBAAuB,CAAC;YACnC;gBACI,OAAO,0BAA0B,CAAC;QAC1C,CAAC;IACL,CAAC;CACJ;AArED,4CAqEC"}

package/dist/format.d.ts

@@ -0,0 +1,81 @@
+/**
+ * A set of utilities for formatting data into the fints data formats.
+ */
+export declare const Format: {
+    /**
+     * Format a date. The time part is ignored.
+     *
+     * @param date The date to format.
+     *
+     * @return The formatted string.
+     */
+    date(date?: Date): string;
+    /**
+     * Format a binary string with a length specification.
+     *
+     * @param str The string to format.
+     *
+     * @return The formatted string.
+     */
+    stringWithLength(str: string): string;
+    /**
+     * Format a boolean with no `false` representation.
+     *
+     * @param value The boolean to format.
+     *
+     * @return The formatted string.
+     */
+    bool(value: boolean): "J" | "";
+    /**
+     * Return the SEPA identification descriptor.
+     *
+     * @return The SEPA identification descriptor.
+     */
+    sepaDescriptor(): string;
+    /**
+     * Format a number.
+     *
+     * @param num The number to format.
+     *
+     * @return The formatted string.
+     */
+    num(num: number): string;
+    /**
+     * Format a normal string, escaping all control characters.
+     *
+     * @param str The string to format.
+     *
+     * @return The formatted string.
+     */
+    stringEscaped(str: string): string;
+    /**
+     * Format a set of digits.
+     *
+     * @param num The number to format.
+     *
+     * @return The formatted string.
+     */
+    dig(num: number): string;
+    /**
+     * Format a time. The date part is ignored.
+     *
+     * @param date The date to format.
+     *
+     * @return The formatted string.
+     */
+    time(date?: Date): string;
+    /**
+     * Return an empty string.
+     *
+     * @return An empty string.
+     */
+    empty(): string;
+    /**
+     * Format a boolean with an explicit `false` representation (named "JN" in the official documentation).
+     *
+     * @param value The boolean to format.
+     *
+     * @return The formatted string.
+     */
+    jn(bool: boolean): "J" | "N";
+};

package/dist/format.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Format = void 0;
+const date_fns_1 = require("date-fns");
+const utils_1 = require("./utils");
+/**
+ * A set of utilities for formatting data into the fints data formats.
+ */
+exports.Format = {
+    /**
+     * Format a date. The time part is ignored.
+     *
+     * @param date The date to format.
+     *
+     * @return The formatted string.
+     */
+    date(date) {
+        const dateToFormat = date ? date : new Date();
+        return (0, date_fns_1.format)(dateToFormat, "yyyMMdd");
+    },
+    /**
+     * Format a binary string with a length specification.
+     *
+     * @param str The string to format.
+     *
+     * @return The formatted string.
+     */
+    stringWithLength(str) {
+        return `@${str.length}@${str}`;
+    },
+    /**
+     * Format a boolean with no `false` representation.
+     *
+     * @param value The boolean to format.
+     *
+     * @return The formatted string.
+     */
+    bool(value) {
+        return value ? "J" : "";
+    },
+    /**
+     * Return the SEPA identification descriptor.
+     *
+     * @return The SEPA identification descriptor.
+     */
+    sepaDescriptor() {
+        return "urn?:iso?:std?:iso?:20022?:tech?:xsd?:pain.001.001.03";
+    },
+    /**
+     * Format a number.
+     *
+     * @param num The number to format.
+     *
+     * @return The formatted string.
+     */
+    num(num) {
+        return `${num}`.replace(/\./, ",");
+    },
+    /**
+     * Format a normal string, escaping all control characters.
+     *
+     * @param str The string to format.
+     *
+     * @return The formatted string.
+     */
+    stringEscaped(str) {
+        if (!str) {
+            return "";
+        }
+        return (0, utils_1.escapeFinTS)(str);
+    },
+    /**
+     * Format a set of digits.
+     *
+     * @param num The number to format.
+     *
+     * @return The formatted string.
+     */
+    dig(num) {
+        return (0, utils_1.leftPad)(String(num), 12);
+    },
+    /**
+     * Format a time. The date part is ignored.
+     *
+     * @param date The date to format.
+     *
+     * @return The formatted string.
+     */
+    time(date) {
+        const dateToFormat = date ? date : new Date();
+        return (0, date_fns_1.format)(dateToFormat, "HHMMss");
+    },
+    /**
+     * Return an empty string.
+     *
+     * @return An empty string.
+     */
+    empty() {
+        return "";
+    },
+    /**
+     * Format a boolean with an explicit `false` representation (named "JN" in the official documentation).
+     *
+     * @param value The boolean to format.
+     *
+     * @return The formatted string.
+     */
+    jn(bool) {
+        return bool ? "J" : "N";
+    },
+};
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":";;;AAAA,uCAAkC;AAClC,mCAA+C;AAE/C;;GAEG;AACU,QAAA,MAAM,GAAG;IAClB;;;;;;OAMG;IACH,IAAI,CAAC,IAAW;QACZ,MAAM,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAC9C,OAAO,IAAA,iBAAM,EAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAC3C,CAAC;IACD;;;;;;OAMG;IACH,gBAAgB,CAAC,GAAW;QACxB,OAAO,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;IACnC,CAAC;IACD;;;;;;OAMG;IACH,IAAI,CAAC,KAAc;QACf,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5B,CAAC;IACD;;;;OAIG;IACH,cAAc;QACV,OAAO,uDAAuD,CAAC;IACnE,CAAC;IACD;;;;;;OAMG;IACH,GAAG,CAAC,GAAW;QACX,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvC,CAAC;IACD;;;;;;OAMG;IACH,aAAa,CAAC,GAAW;QACrB,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO,EAAE,CAAC;QACd,CAAC;QACD,OAAO,IAAA,mBAAW,EAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD;;;;;;OAMG;IACH,GAAG,CAAC,GAAW;QACX,OAAO,IAAA,eAAO,EAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC;IACD;;;;;;OAMG;IACH,IAAI,CAAC,IAAW;QACZ,MAAM,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAC9C,OAAO,IAAA,iBAAM,EAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IACD;;;;OAIG;IACH,KAAK;QACD,OAAO,EAAE,CAAC;IACd,CAAC;IACD;;;;;;OAMG;IACH,EAAE,CAAC,IAAa;QACZ,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC5B,CAAC;CACJ,CAAC"}

package/dist/http-connection.d.ts

@@ -0,0 +1,36 @@
+import "isomorphic-fetch";
+import { Request } from "./request";
+import { Response } from "./response";
+import { Connection } from "./types";
+/**
+ * Configuration specifying how to reach the fints server.
+ */
+export declare class ConnectionConfig {
+    /**
+     * The URL to reach the server at.
+     */
+    url: string;
+    /**
+     * If set to `true`, will log all requests performed and responses received.
+     */
+    debug: boolean;
+    /**
+     * Timeout in milliseconds for HTTP requests. Default: 30000 (30 seconds)
+     */
+    timeout: number;
+    /**
+     * Maximum number of retry attempts for failed requests. Default: 3
+     */
+    maxRetries: number;
+    /**
+     * Base delay in milliseconds for exponential backoff. Default: 1000 (1 second)
+     */
+    retryDelay: number;
+}
+/**
+ * A connection used by clients to reach the fints server.
+ */
+export declare class HttpConnection extends ConnectionConfig implements Connection {
+    constructor(config: ConnectionConfig);
+    send(request: Request): Promise<Response>;
+}

package/dist/http-connection.js

@@ -0,0 +1,109 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpConnection = exports.ConnectionConfig = void 0;
+require("isomorphic-fetch");
+const logger_1 = require("./logger");
+const utils_1 = require("./utils");
+const response_1 = require("./response");
+/**
+ * Configuration specifying how to reach the fints server.
+ */
+class ConnectionConfig {
+    constructor() {
+        /**
+         * If set to `true`, will log all requests performed and responses received.
+         */
+        this.debug = false;
+        /**
+         * Timeout in milliseconds for HTTP requests. Default: 30000 (30 seconds)
+         */
+        this.timeout = 30000;
+        /**
+         * Maximum number of retry attempts for failed requests. Default: 3
+         */
+        this.maxRetries = 3;
+        /**
+         * Base delay in milliseconds for exponential backoff. Default: 1000 (1 second)
+         */
+        this.retryDelay = 1000;
+    }
+}
+exports.ConnectionConfig = ConnectionConfig;
+/**
+ * A connection used by clients to reach the fints server.
+ */
+class HttpConnection extends ConnectionConfig {
+    constructor(config) {
+        super();
+        Object.assign(this, config);
+    }
+    send(request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { url } = this;
+            (0, logger_1.verbose)(`Sending Request: ${request}`);
+            if (this.debug) {
+                (0, logger_1.verbose)(`Parsed Request:\n${request.debugString}`);
+            }
+            let lastError = null;
+            let attempt = 0;
+            while (attempt <= this.maxRetries) {
+                try {
+                    const controller = new AbortController();
+                    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+                    try {
+                        const httpRequest = yield fetch(url, {
+                            method: "POST",
+                            body: (0, utils_1.encodeBase64)(String(request)),
+                            signal: controller.signal,
+                        });
+                        if (!httpRequest.ok) {
+                            throw new Error(`Received bad status code ${httpRequest.status} from FinTS endpoint.`);
+                        }
+                        const responseString = (0, utils_1.decodeBase64)(yield httpRequest.text());
+                        (0, logger_1.verbose)(`Received Response: ${responseString}`);
+                        const response = new response_1.Response(responseString);
+                        if (this.debug) {
+                            (0, logger_1.verbose)(`Parsed Response:\n${response.debugString}`);
+                        }
+                        return response;
+                    }
+                    finally {
+                        clearTimeout(timeoutId);
+                    }
+                }
+                catch (error) {
+                    lastError = error;
+                    attempt++;
+                    // Check if error is due to timeout (AbortError is thrown when fetch is aborted)
+                    const isTimeout = error.name === "AbortError";
+                    if (attempt <= this.maxRetries) {
+                        // Calculate exponential backoff delay
+                        const delay = this.retryDelay * Math.pow(2, attempt - 1);
+                        (0, logger_1.verbose)(`Request failed (attempt ${attempt}/${this.maxRetries + 1}), retrying in ${delay}ms: ${error.message}`);
+                        yield new Promise((resolve) => setTimeout(resolve, delay));
+                    }
+                    else {
+                        // Max retries reached
+                        if (isTimeout) {
+                            throw new Error(`FinTS request timed out after ${this.maxRetries + 1} attempts (timeout: ${this.timeout}ms)`);
+                        }
+                        throw new Error(`FinTS request failed after ${this.maxRetries + 1} attempts: ${lastError.message}`);
+                    }
+                }
+            }
+            // This should never be reached, but TypeScript needs it
+            throw lastError || new Error("Unknown error during FinTS request");
+        });
+    }
+}
+exports.HttpConnection = HttpConnection;
+//# sourceMappingURL=http-connection.js.map

package/dist/http-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-connection.js","sourceRoot":"","sources":["../src/http-connection.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,4BAA0B;AAC1B,qCAAmC;AACnC,mCAAqD;AAErD,yCAAsC;AAGtC;;GAEG;AACH,MAAa,gBAAgB;IAA7B;QAKI;;WAEG;QACI,UAAK,GAAG,KAAK,CAAC;QACrB;;WAEG;QACI,YAAO,GAAG,KAAK,CAAC;QACvB;;WAEG;QACI,eAAU,GAAG,CAAC,CAAC;QACtB;;WAEG;QACI,eAAU,GAAG,IAAI,CAAC;IAC7B,CAAC;CAAA;AArBD,4CAqBC;AAED;;GAEG;AACH,MAAa,cAAe,SAAQ,gBAAgB;IAChD,YAAY,MAAwB;QAChC,KAAK,EAAE,CAAC;QACR,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChC,CAAC;IAEY,IAAI,CAAC,OAAgB;;YAC9B,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;YACrB,IAAA,gBAAO,EAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YACvC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,IAAA,gBAAO,EAAC,oBAAoB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;YACvD,CAAC;YAED,IAAI,SAAS,GAAiB,IAAI,CAAC;YACnC,IAAI,OAAO,GAAG,CAAC,CAAC;YAEhB,OAAO,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChC,IAAI,CAAC;oBACD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;oBACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;oBAErE,IAAI,CAAC;wBACD,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;4BACjC,MAAM,EAAE,MAAM;4BACd,IAAI,EAAE,IAAA,oBAAY,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC;4BACnC,MAAM,EAAE,UAAU,CAAC,MAAM;yBAC5B,CAAC,CAAC;wBAEH,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC;4BAClB,MAAM,IAAI,KAAK,CAAC,4BAA4B,WAAW,CAAC,MAAM,uBAAuB,CAAC,CAAC;wBAC3F,CAAC;wBAED,MAAM,cAAc,GAAG,IAAA,oBAAY,EAAC,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;wBAC9D,IAAA,gBAAO,EAAC,sBAAsB,cAAc,EAAE,CAAC,CAAC;wBAChD,MAAM,QAAQ,GAAG,IAAI,mBAAQ,CAAC,cAAc,CAAC,CAAC;wBAC9C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;4BACb,IAAA,gBAAO,EAAC,qBAAqB,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;wBACzD,CAAC;wBACD,OAAO,QAAQ,CAAC;oBACpB,CAAC;4BAAS,CAAC;wBACP,YAAY,CAAC,SAAS,CAAC,CAAC;oBAC5B,CAAC;gBACL,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACb,SAAS,GAAG,KAAc,CAAC;oBAC3B,OAAO,EAAE,CAAC;oBAEV,gFAAgF;oBAChF,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;oBAE9C,IAAI,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;wBAC7B,sCAAsC;wBACtC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;wBACzD,IAAA,gBAAO,EACH,2BAA2B,OAAO,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,kBAAkB,KAAK,OAAO,KAAK,CAAC,OAAO,EAAE,CACzG,CAAC;wBACF,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;oBAC/D,CAAC;yBAAM,CAAC;wBACJ,sBAAsB;wBACtB,IAAI,SAAS,EAAE,CAAC;4BACZ,MAAM,IAAI,KAAK,CACX,iCAAiC,IAAI,CAAC,UAAU,GAAG,CAAC,uBAAuB,IAAI,CAAC,OAAO,KAAK,CAC/F,CAAC;wBACN,CAAC;wBACD,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,CAAC,UAAU,GAAG,CAAC,cAAc,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;oBACxG,CAAC;gBACL,CAAC;YACL,CAAC;YAED,wDAAwD;YACxD,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACvE,CAAC;KAAA;CACJ;AAvED,wCAuEC"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export * from "./client";
+export * from "./constants";
+export * from "./dialog";
+export * from "./error-codes";
+export * from "./format";
+export * from "./http-connection";
+export * from "./logger";
+export * from "./mt940-86-structured";
+export * from "./mt535";
+export * from "./pain";
+export * from "./pain-formats";
+export * from "./parse";
+export * from "./pin-tan-client";
+export * from "./request";
+export * from "./response";
+export * from "./return-value";
+export * from "./segments";
+export * from "./tan-method";
+export * from "./types";
+export * from "./utils";
+export * from "./errors/response-error";
+export * from "./errors/tan-required-error";
+export * from "./errors/fints-error";