fints-lib 0.6.0 → 0.7.0

package/dist/pain.js

@@ -0,0 +1,315 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectPain001Descriptor = selectPain001Descriptor;
+exports.selectPain008Descriptor = selectPain008Descriptor;
+exports.buildPain008 = buildPain008;
+exports.buildPain001 = buildPain001;
+exports.buildDirectDebitSubmission = buildDirectDebitSubmission;
+exports.buildCreditTransferSubmission = buildCreditTransferSubmission;
+const date_fns_1 = require("date-fns");
+const utils_1 = require("./utils");
+const DEFAULT_DIRECT_DEBIT_SEQUENCE = "OOFF";
+const DEFAULT_LOCAL_INSTRUMENT = "CORE";
+const DEFAULT_CURRENCY = "EUR";
+function escapeXml(value) {
+    return value
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+function formatDate(date) {
+    return (0, date_fns_1.format)(date, "yyyy-MM-dd");
+}
+function formatDateTime(date) {
+    return (0, date_fns_1.format)(date, "yyyy-MM-dd'T'HH:mm:ss");
+}
+function formatAmount(amount) {
+    return amount.toFixed(2);
+}
+function ensurePositiveAmount(amount) {
+    if (!(amount > 0)) {
+        throw new Error("Direct debit amount must be greater than zero.");
+    }
+}
+function ensureDate(value, description) {
+    if (!(value instanceof Date) || isNaN(value.getTime())) {
+        throw new Error(`${description} must be a valid date.`);
+    }
+}
+function ensureText(value, description) {
+    if (!value || value.trim().length === 0) {
+        throw new Error(`${description} must be provided.`);
+    }
+}
+function namespaceFromDescriptor(descriptor) {
+    const unescaped = (0, utils_1.unescapeFinTS)(descriptor);
+    const versionMatch = unescaped.match(/pain\.008\.\d{3}\.\d{2}/);
+    if (versionMatch) {
+        return `urn:iso:std:iso:20022:tech:xsd:${versionMatch[0]}`;
+    }
+    return unescaped.replace(/\.xsd$/i, "");
+}
+function namespaceFromDescriptorPain001(descriptor) {
+    const unescaped = (0, utils_1.unescapeFinTS)(descriptor);
+    const versionMatch = unescaped.match(/pain\.001\.\d{3}\.\d{2}/);
+    if (versionMatch) {
+        return `urn:iso:std:iso:20022:tech:xsd:${versionMatch[0]}`;
+    }
+    return unescaped.replace(/\.xsd$/i, "");
+}
+function selectPain001Descriptor(painFormats) {
+    const preferredVersions = ["pain.001.003.03", "pain.001.001.03", "pain.001.003.02", "pain.001.001.02"];
+    for (const version of preferredVersions) {
+        const descriptor = painFormats.find((candidate) => candidate.includes(version));
+        if (descriptor) {
+            return descriptor;
+        }
+    }
+    const fallback = painFormats.find((candidate) => candidate.includes("pain.001"));
+    if (fallback) {
+        return fallback;
+    }
+    throw new Error("Bank does not advertise support for pain.001 credit transfer messages.");
+}
+function selectPain008Descriptor(painFormats) {
+    const preferredVersions = ["pain.008.003.02", "pain.008.003.01", "pain.008.002.02", "pain.008.001.02"];
+    for (const version of preferredVersions) {
+        const descriptor = painFormats.find((candidate) => candidate.includes(version));
+        if (descriptor) {
+            return descriptor;
+        }
+    }
+    const fallback = painFormats.find((candidate) => candidate.includes("pain.008"));
+    if (fallback) {
+        return fallback;
+    }
+    throw new Error("Bank does not advertise support for pain.008 direct debit messages.");
+}
+function buildPain008(request, account, descriptor) {
+    var _a, _b;
+    ensureText(account.iban, "Creditor IBAN");
+    ensureText(account.bic, "Creditor BIC");
+    ensureText(request.creditorName, "Creditor name");
+    ensureText(request.creditorId, "Creditor identifier");
+    ensureText((_a = request.debtor) === null || _a === void 0 ? void 0 : _a.name, "Debtor name");
+    ensureText((_b = request.debtor) === null || _b === void 0 ? void 0 : _b.iban, "Debtor IBAN");
+    ensureText(request.mandateId, "Mandate identifier");
+    ensurePositiveAmount(request.amount);
+    ensureDate(request.mandateSignatureDate, "Mandate signature date");
+    ensureDate(request.requestedCollectionDate, "Requested collection date");
+    const createdAt = request.creationDateTime ? new Date(request.creationDateTime) : new Date();
+    const messageId = request.messageId || `DD-${(0, date_fns_1.format)(createdAt, "yyyyMMddHHmmssSSS")}`;
+    const paymentInformationId = request.paymentInformationId || messageId;
+    const endToEndId = request.endToEndId || "NOTPROVIDED";
+    const currency = request.currency || DEFAULT_CURRENCY;
+    const sequenceType = request.sequenceType || DEFAULT_DIRECT_DEBIT_SEQUENCE;
+    const localInstrument = request.localInstrument || DEFAULT_LOCAL_INSTRUMENT;
+    const batchBooking = request.batchBooking === true;
+    const namespace = namespaceFromDescriptor(descriptor);
+    const debtorBic = request.debtor.bic;
+    const amount = formatAmount(request.amount);
+    const creditorName = request.creditorName.trim();
+    const debtorName = request.debtor.name.trim();
+    const xmlParts = [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        `<Document xmlns="${escapeXml(namespace)}">`,
+        "  <CstmrDrctDbtInitn>",
+        "    <GrpHdr>",
+        `      <MsgId>${escapeXml(messageId)}</MsgId>`,
+        `      <CreDtTm>${formatDateTime(createdAt)}</CreDtTm>`,
+        "      <NbOfTxs>1</NbOfTxs>",
+        `      <CtrlSum>${amount}</CtrlSum>`,
+        "      <InitgPty>",
+        `        <Nm>${escapeXml(creditorName)}</Nm>`,
+        "      </InitgPty>",
+        "    </GrpHdr>",
+        "    <PmtInf>",
+        `      <PmtInfId>${escapeXml(paymentInformationId)}</PmtInfId>`,
+        "      <PmtMtd>DD</PmtMtd>",
+        `      <BtchBookg>${batchBooking ? "true" : "false"}</BtchBookg>`,
+        "      <NbOfTxs>1</NbOfTxs>",
+        `      <CtrlSum>${amount}</CtrlSum>`,
+        "      <PmtTpInf>",
+        "        <SvcLvl>",
+        "          <Cd>SEPA</Cd>",
+        "        </SvcLvl>",
+        "        <LclInstrm>",
+        `          <Cd>${escapeXml(localInstrument)}</Cd>`,
+        "        </LclInstrm>",
+        `        <SeqTp>${escapeXml(sequenceType)}</SeqTp>`,
+        "      </PmtTpInf>",
+        `      <ReqdColltnDt>${formatDate(request.requestedCollectionDate)}</ReqdColltnDt>`,
+        "      <Cdtr>",
+        `        <Nm>${escapeXml(creditorName)}</Nm>`,
+        "      </Cdtr>",
+        "      <CdtrAcct>",
+        "        <Id>",
+        `          <IBAN>${escapeXml(account.iban)}</IBAN>`,
+        "        </Id>",
+        "      </CdtrAcct>",
+        "      <CdtrAgt>",
+        "        <FinInstnId>",
+        `          <BIC>${escapeXml(account.bic)}</BIC>`,
+        "        </FinInstnId>",
+        "      </CdtrAgt>",
+        "      <ChrgBr>SLEV</ChrgBr>",
+        "      <CdtrSchmeId>",
+        "        <Id>",
+        "          <PrvtId>",
+        "            <Othr>",
+        `              <Id>${escapeXml(request.creditorId)}</Id>`,
+        "              <SchmeNm>",
+        "                <Prtry>SEPA</Prtry>",
+        "              </SchmeNm>",
+        "            </Othr>",
+        "          </PrvtId>",
+        "        </Id>",
+        "      </CdtrSchmeId>",
+        "      <DrctDbtTxInf>",
+        "        <PmtId>",
+        `          <EndToEndId>${escapeXml(endToEndId)}</EndToEndId>`,
+        "        </PmtId>",
+        `        <InstdAmt Ccy="${escapeXml(currency)}">${amount}</InstdAmt>`,
+        "        <DrctDbtTx>",
+        "          <MndtRltdInf>",
+        `            <MndtId>${escapeXml(request.mandateId)}</MndtId>`,
+        `            <DtOfSgntr>${formatDate(request.mandateSignatureDate)}</DtOfSgntr>`,
+        "          </MndtRltdInf>",
+        "        </DrctDbtTx>",
+    ];
+    if (debtorBic) {
+        xmlParts.push("        <DbtrAgt>", "          <FinInstnId>", `            <BIC>${escapeXml(debtorBic)}</BIC>`, "          </FinInstnId>", "        </DbtrAgt>");
+    }
+    xmlParts.push("        <Dbtr>", `          <Nm>${escapeXml(debtorName)}</Nm>`, "        </Dbtr>", "        <DbtrAcct>", "          <Id>", `            <IBAN>${escapeXml(request.debtor.iban)}</IBAN>`, "          </Id>", "        </DbtrAcct>");
+    if (request.purposeCode) {
+        xmlParts.push("        <Purp>", `          <Cd>${escapeXml(request.purposeCode)}</Cd>`, "        </Purp>");
+    }
+    if (request.remittanceInformation) {
+        xmlParts.push("        <RmtInf>", `          <Ustrd>${escapeXml(request.remittanceInformation)}</Ustrd>`, "        </RmtInf>");
+    }
+    xmlParts.push("      </DrctDbtTxInf>", "    </PmtInf>", "  </CstmrDrctDbtInitn>", "</Document>");
+    const xml = xmlParts.join(" ");
+    return {
+        xml,
+        messageId,
+        paymentInformationId,
+        endToEndId,
+        namespace,
+    };
+}
+function buildPain001(request, account, descriptor) {
+    var _a, _b;
+    ensureText(account.iban, "Debtor IBAN");
+    ensureText(account.bic, "Debtor BIC");
+    ensureText(request.debtorName, "Debtor name");
+    ensureText((_a = request.creditor) === null || _a === void 0 ? void 0 : _a.name, "Creditor name");
+    ensureText((_b = request.creditor) === null || _b === void 0 ? void 0 : _b.iban, "Creditor IBAN");
+    ensurePositiveAmount(request.amount);
+    if (request.executionDate) {
+        ensureDate(request.executionDate, "Requested execution date");
+    }
+    const createdAt = request.creationDateTime ? new Date(request.creationDateTime) : new Date();
+    const executionDate = request.executionDate ? new Date(request.executionDate) : new Date();
+    ensureDate(executionDate, "Requested execution date");
+    const messageId = request.messageId || `CT-${(0, date_fns_1.format)(createdAt, "yyyyMMddHHmmssSSS")}`;
+    const paymentInformationId = request.paymentInformationId || messageId;
+    const endToEndId = request.endToEndId || "NOTPROVIDED";
+    const currency = request.currency || DEFAULT_CURRENCY;
+    const batchBooking = request.batchBooking === true;
+    const namespace = namespaceFromDescriptorPain001(descriptor);
+    const creditorBic = request.creditor.bic;
+    const amount = formatAmount(request.amount);
+    const debtorName = request.debtorName.trim();
+    const creditorName = request.creditor.name.trim();
+    const xmlParts = [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        `<Document xmlns="${escapeXml(namespace)}">`,
+        "  <CstmrCdtTrfInitn>",
+        "    <GrpHdr>",
+        `      <MsgId>${escapeXml(messageId)}</MsgId>`,
+        `      <CreDtTm>${formatDateTime(createdAt)}</CreDtTm>`,
+        "      <NbOfTxs>1</NbOfTxs>",
+        `      <CtrlSum>${amount}</CtrlSum>`,
+        "      <InitgPty>",
+        `        <Nm>${escapeXml(debtorName)}</Nm>`,
+        "      </InitgPty>",
+        "    </GrpHdr>",
+        "    <PmtInf>",
+        `      <PmtInfId>${escapeXml(paymentInformationId)}</PmtInfId>`,
+        "      <PmtMtd>TRF</PmtMtd>",
+        `      <BtchBookg>${batchBooking ? "true" : "false"}</BtchBookg>`,
+        "      <NbOfTxs>1</NbOfTxs>",
+        `      <CtrlSum>${amount}</CtrlSum>`,
+        "      <PmtTpInf>",
+        "        <SvcLvl>",
+        "          <Cd>SEPA</Cd>",
+        "        </SvcLvl>",
+        "      </PmtTpInf>",
+        `      <ReqdExctnDt>${formatDate(executionDate)}</ReqdExctnDt>`,
+        "      <Dbtr>",
+        `        <Nm>${escapeXml(debtorName)}</Nm>`,
+        "      </Dbtr>",
+        "      <DbtrAcct>",
+        "        <Id>",
+        `          <IBAN>${escapeXml(account.iban)}</IBAN>`,
+        "        </Id>",
+        "      </DbtrAcct>",
+        "      <DbtrAgt>",
+        "        <FinInstnId>",
+        `          <BIC>${escapeXml(account.bic)}</BIC>`,
+        "        </FinInstnId>",
+        "      </DbtrAgt>",
+        "      <ChrgBr>SLEV</ChrgBr>",
+        "      <CdtTrfTxInf>",
+        "        <PmtId>",
+        `          <EndToEndId>${escapeXml(endToEndId)}</EndToEndId>`,
+        "        </PmtId>",
+        "        <Amt>",
+        `          <InstdAmt Ccy="${escapeXml(currency)}">${amount}</InstdAmt>`,
+        "        </Amt>",
+    ];
+    if (creditorBic) {
+        xmlParts.push("        <CdtrAgt>", "          <FinInstnId>", `            <BIC>${escapeXml(creditorBic)}</BIC>`, "          </FinInstnId>", "        </CdtrAgt>");
+    }
+    xmlParts.push("        <Cdtr>", `          <Nm>${escapeXml(creditorName)}</Nm>`, "        </Cdtr>", "        <CdtrAcct>", "          <Id>", `            <IBAN>${escapeXml(request.creditor.iban)}</IBAN>`, "          </Id>", "        </CdtrAcct>");
+    if (request.purposeCode) {
+        xmlParts.push("        <Purp>", `          <Cd>${escapeXml(request.purposeCode)}</Cd>`, "        </Purp>");
+    }
+    if (request.remittanceInformation) {
+        xmlParts.push("        <RmtInf>", `          <Ustrd>${escapeXml(request.remittanceInformation)}</Ustrd>`, "        </RmtInf>");
+    }
+    xmlParts.push("      </CdtTrfTxInf>", "    </PmtInf>", "  </CstmrCdtTrfInitn>", "</Document>");
+    const xml = xmlParts.join(" ");
+    return {
+        xml,
+        messageId,
+        paymentInformationId,
+        endToEndId,
+        namespace,
+    };
+}
+function buildDirectDebitSubmission(request, account, descriptor) {
+    const { xml, messageId, paymentInformationId, endToEndId } = buildPain008(request, account, descriptor);
+    return {
+        taskId: undefined,
+        messageId,
+        paymentInformationId,
+        endToEndId,
+        painDescriptor: descriptor,
+        xml,
+    };
+}
+function buildCreditTransferSubmission(request, account, descriptor) {
+    const { xml, messageId, paymentInformationId, endToEndId } = buildPain001(request, account, descriptor);
+    return {
+        taskId: undefined,
+        messageId,
+        paymentInformationId,
+        endToEndId,
+        painDescriptor: descriptor,
+        xml,
+    };
+}
+//# sourceMappingURL=pain.js.map

package/dist/pain.js.map

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

package/dist/parse.d.ts

@@ -0,0 +1,46 @@
+/**
+ * A set of utilities for parsing data from the fints data formats.
+ */
+export declare const Parse: {
+    /**
+     * Parse a boolean (JN).
+     *
+     * @param str The string to parse.
+     *
+     * @return The parsed boolean.
+     */
+    bool(str: string): boolean;
+    /**
+     * Parse a number.
+     *
+     * @param str The string to parse.
+     *
+     * @return The parsed number.
+     */
+    num(str: string): number;
+    /**
+     * Parse a set of digits.
+     *
+     * @param str The string to parse.
+     *
+     * @return The parsed number.
+     */
+    dig(str: string): number;
+    /**
+     * Parse a date.
+     *
+     * @param str The string or date to parse.
+     *
+     * @return The parsed date.
+     */
+    date(str: string): Date;
+    /**
+     * Parse a xml document to an object.
+     *
+     * @param str The xml parse.
+     *
+     * @return The parsed object.
+     */
+    xml(str: string): unknown;
+    challengeHhdUc(str: string[][]): [string, Buffer];
+};

package/dist/parse.js

@@ -0,0 +1,97 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Parse = void 0;
+const date_fns_1 = require("date-fns");
+const fast_xml_parser_1 = require("fast-xml-parser");
+const iconv_lite_1 = __importDefault(require("iconv-lite"));
+/**
+ * A set of utilities for parsing data from the fints data formats.
+ */
+exports.Parse = {
+    /**
+     * Parse a boolean (JN).
+     *
+     * @param str The string to parse.
+     *
+     * @return The parsed boolean.
+     */
+    bool(str) {
+        if (str === "J") {
+            return true;
+        }
+        return false;
+    },
+    /**
+     * Parse a number.
+     *
+     * @param str The string to parse.
+     *
+     * @return The parsed number.
+     */
+    num(str) {
+        if (typeof str === "undefined") {
+            return;
+        }
+        return Number(str.replace(/,/, "."));
+    },
+    /**
+     * Parse a set of digits.
+     *
+     * @param str The string to parse.
+     *
+     * @return The parsed number.
+     */
+    dig(str) {
+        if (str === "0") {
+            return 0;
+        }
+        while (str.startsWith("0")) {
+            str = str.substr(1, str.length);
+        }
+        return Number(str);
+    },
+    /**
+     * Parse a date.
+     *
+     * @param str The string or date to parse.
+     *
+     * @return The parsed date.
+     */
+    date(str) {
+        return (0, date_fns_1.parse)(str, "yyyyMMdd", new Date());
+    },
+    /**
+     * Parse a xml document to an object.
+     *
+     * @param str The xml parse.
+     *
+     * @return The parsed object.
+     */
+    xml(str) {
+        const parser = new fast_xml_parser_1.XMLParser();
+        return parser.parse(str);
+    },
+    challengeHhdUc(str) {
+        // tslint:disable-next-line:max-line-length
+        // Documentation: https://www.hbci-zka.de/dokumente/spezifikation_deutsch/hhd/Belegungsrichtlinien%20TANve1.5%20FV%20vom%202018-04-16.pdf
+        // II.3
+        // Matrix-Format:
+        // 2 bytes = length of mime type
+        // mime type as string
+        // 2 bytes = length of data
+        if (str && str[0]) {
+            const buffer = iconv_lite_1.default.encode(str[0][0], "ISO-8859-1");
+            const mediaTypeLength = buffer.readUIntBE(0, 2);
+            const mediaType = buffer.toString("utf8", 2, 2 + mediaTypeLength);
+            const imageLength = buffer.readUIntBE(2 + mediaTypeLength, 2);
+            return [mediaType, buffer.slice(2 + mediaTypeLength + 2, 2 + mediaTypeLength + 2 + imageLength)];
+        }
+        else {
+            return ["", Buffer.alloc(0)];
+        }
+    },
+};
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":";;;;;;AAAA,uCAA8C;AAC9C,qDAA4C;AAC5C,4DAA+B;AAE/B;;GAEG;AACU,QAAA,KAAK,GAAG;IACjB;;;;;;OAMG;IACH,IAAI,CAAC,GAAW;QACZ,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IACD;;;;;;OAMG;IACH,GAAG,CAAC,GAAW;QACX,IAAI,OAAO,GAAG,KAAK,WAAW,EAAE,CAAC;YAC7B,OAAO;QACX,CAAC;QACD,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACzC,CAAC;IACD;;;;;;OAMG;IACH,GAAG,CAAC,GAAW;QACX,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,CAAC;QACb,CAAC;QACD,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD;;;;;;OAMG;IACH,IAAI,CAAC,GAAW;QACZ,OAAO,IAAA,gBAAS,EAAC,GAAG,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IACD;;;;;;OAMG;IACH,GAAG,CAAC,GAAW;QACX,MAAM,MAAM,GAAG,IAAI,2BAAS,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,cAAc,CAAC,GAAe;QAC1B,2CAA2C;QAC3C,yIAAyI;QACzI,OAAO;QAEP,iBAAiB;QACjB,gCAAgC;QAChC,sBAAsB;QACtB,2BAA2B;QAE3B,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,oBAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;YACrD,MAAM,eAAe,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAChD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC;YAClE,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,eAAe,EAAE,CAAC,CAAC,CAAC;YAC9D,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,eAAe,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;QACrG,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC;IACL,CAAC;CACJ,CAAC"}

package/dist/pin-tan-client.d.ts

@@ -0,0 +1,47 @@
+import { Client } from "./client";
+import { Dialog, DialogConfig } from "./dialog";
+import { Request } from "./request";
+import { ConnectionConfig } from "./http-connection";
+import { Segment } from "./segments";
+/**
+ * Set of options needed to construct a `PinTanClient`.
+ */
+export interface PinTanClientConfig extends Partial<ConnectionConfig> {
+    /**
+     * The fints product identification.
+     */
+    productId?: string;
+    /**
+     * The banks identification number (Bankleitzahl).
+     */
+    blz: string;
+    /**
+     * The username or identification number.
+     */
+    name: string;
+    /**
+     * The pin code or password used for authenticating with the fints server.
+     */
+    pin: string;
+    /**
+     * The URL to reach the server at.
+     */
+    url: string;
+    /**
+     * If set to `true`, will log all requests performed and responses received.
+     */
+    debug?: boolean;
+}
+export declare class PinTanClient extends Client {
+    /**
+     * Connection used to reach the server.
+     */
+    private connection;
+    /**
+     * Configuration for connecting and authenticating.
+     */
+    protected config: PinTanClientConfig;
+    constructor(config: PinTanClientConfig);
+    createDialog(dialogConfig?: DialogConfig): Dialog;
+    createRequest(dialog: Dialog, segments: Segment<any>[], tan?: string): Request;
+}

package/dist/pin-tan-client.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PinTanClient = void 0;
+const client_1 = require("./client");
+const dialog_1 = require("./dialog");
+const request_1 = require("./request");
+const http_connection_1 = require("./http-connection");
+const constants_1 = require("./constants");
+class PinTanClient extends client_1.Client {
+    constructor(config) {
+        super();
+        this.config = config;
+        const { url, debug, timeout, maxRetries, retryDelay } = config;
+        const connectionConfig = {
+            url,
+            debug: debug !== null && debug !== void 0 ? debug : false,
+            timeout: timeout !== null && timeout !== void 0 ? timeout : 30000,
+            maxRetries: maxRetries !== null && maxRetries !== void 0 ? maxRetries : 3,
+            retryDelay: retryDelay !== null && retryDelay !== void 0 ? retryDelay : 1000,
+        };
+        this.connection = new http_connection_1.HttpConnection(connectionConfig);
+    }
+    createDialog(dialogConfig) {
+        const { blz, name, pin, productId = constants_1.PRODUCT_NAME } = this.config;
+        const { connection } = this;
+        return new dialog_1.Dialog(dialogConfig ? dialogConfig : { blz, name, pin, systemId: "0", productId }, connection);
+    }
+    createRequest(dialog, segments, tan) {
+        const { blz, name, pin } = this.config;
+        const { systemId, dialogId, msgNo, tanMethods } = dialog;
+        return new request_1.Request({ blz, name, pin, systemId, dialogId, msgNo, segments, tanMethods, tan });
+    }
+}
+exports.PinTanClient = PinTanClient;
+//# sourceMappingURL=pin-tan-client.js.map

package/dist/pin-tan-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pin-tan-client.js","sourceRoot":"","sources":["../src/pin-tan-client.ts"],"names":[],"mappings":";;;AAAA,qCAAkC;AAClC,qCAAgD;AAChD,uCAAoC;AACpC,uDAAqE;AAGrE,2CAA2C;AAgC3C,MAAa,YAAa,SAAQ,eAAM;IAUpC,YAAY,MAA0B;QAClC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC/D,MAAM,gBAAgB,GAAqB;YACvC,GAAG;YACH,KAAK,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,KAAK;YACrB,OAAO,EAAE,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,KAAK;YACzB,UAAU,EAAE,UAAU,aAAV,UAAU,cAAV,UAAU,GAAI,CAAC;YAC3B,UAAU,EAAE,UAAU,aAAV,UAAU,cAAV,UAAU,GAAI,IAAI;SACjC,CAAC;QACF,IAAI,CAAC,UAAU,GAAG,IAAI,gCAAc,CAAC,gBAAgB,CAAC,CAAC;IAC3D,CAAC;IAEM,YAAY,CAAC,YAA2B;QAC3C,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,GAAG,wBAAY,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QACjE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAC5B,OAAO,IAAI,eAAM,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,UAAU,CAAC,CAAC;IAC9G,CAAC;IAEM,aAAa,CAAC,MAAc,EAAE,QAAwB,EAAE,GAAY;QACvE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QACvC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QACzD,OAAO,IAAI,iBAAO,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IACjG,CAAC;CACJ;AAnCD,oCAmCC"}

package/dist/request.d.ts

@@ -0,0 +1,90 @@
+import { Segment } from "./segments";
+import { TanMethod } from "./tan-method";
+/**
+ * Properties used to constructe a `Request`.
+ */
+export declare class RequestConfig {
+    /**
+     * The banks identification number (Bankleitzahl).
+     */
+    blz: string;
+    /**
+     * The username or identification number.
+     */
+    name: string;
+    /**
+     * The pin code or password used for authenticating with the fints server.
+     */
+    pin: string;
+    /**
+     * An optional TAN for performing this request.
+     * Can be omitted if no TAN is needed to perform the request.
+     */
+    tan: string;
+    /**
+     * The system's id. This id needs to be stored across all dialogs and will be assigned
+     * by the server at the first request.
+     */
+    systemId: string;
+    /**
+     * The unique id of the message's dialog.
+     */
+    dialogId: string;
+    /**
+     * All messages sent within a dialog are numbered.
+     * This requests number.
+     */
+    msgNo: number;
+    /**
+     * A list of allowed TAN methods as configured by the server.
+     */
+    tanMethods: TanMethod[];
+    /**
+     * All segments that should be transmitted in the HNVSD segment of the request.
+     */
+    segments: Segment<any>[];
+}
+/**
+ * A single request holding multiple segments.
+ * Will likely embedded in a dialog.
+ */
+export declare class Request extends RequestConfig {
+    /**
+     * A unique identifier for linking a signature header to its footer.
+     * Needs to be randomly generated and unique per dialog.
+     * All references in all segments need to be equal per message.
+     */
+    secRef: number;
+    constructor(config: Partial<RequestConfig>);
+    /**
+     * Determines if a TAN method with a "999" security function is available.
+     * This determines whether profile version 2 can be used.
+     */
+    private get hasNo999SecurityFunction();
+    /**
+     * Use security profile version 2 if the server supports it.
+     * Will be `1` or `2`, depending on the server's capabilities.
+     */
+    private get profileVersion();
+    /**
+     * Determines the security function to use. Will default to the first one if the "999" security function is
+     * unavailable.
+     */
+    private get securityFunction();
+    /**
+     * Returns the total number of segments in this request, including all header meta segments.
+     */
+    private get segmentCount();
+    /**
+     * An array of all segments, including the HNVSD segment wrapping the user payload segments.
+     */
+    private get fullSegments();
+    /**
+     * Generate a textual representation for debug purposes.
+     */
+    get debugString(): string;
+    /**
+     * Serialize the whole request into a string that can be sent to the server.
+     */
+    toString(): string;
+}