@coderoftime/fints 0.0.0-stage → 0.1.0

package/dist/core/amount.js

@@ -0,0 +1,189 @@
+import { FormatError } from '../util/errors.js';
+/** Most decimal places an amount has: ISO 20022, the widest of the bank formats, allows five. */
+const maxScale = 5;
+/** Largest `minorUnits` an amount holds: 2^53 - 1, which JavaScript numbers represent exactly. */
+const maxMinorUnits = Number.MAX_SAFE_INTEGER;
+const powersOfTen = [1, 10, 100, 1000, 10000, 100000];
+/** Most digits a parsed amount has: few enough that the sum of two parsed amounts still fits. */
+const maxDigits = 15;
+const decimal = /^([+-]?)(\d*)(?:[.,](\d*))?$/;
+/** Decimal places of the minor unit of `currency` (ISO 4217): two, except for the currencies listed here. */
+function minorUnitDigits(currency) {
+    switch (currency) {
+        case 'BIF':
+        case 'CLP':
+        case 'DJF':
+        case 'GNF':
+        case 'ISK':
+        case 'JPY':
+        case 'KMF':
+        case 'KRW':
+        case 'PYG':
+        case 'RWF':
+        case 'UGX':
+        case 'UYI':
+        case 'VND':
+        case 'VUV':
+        case 'XAF':
+        case 'XOF':
+        case 'XPF':
+            return 0;
+        case 'BHD':
+        case 'IQD':
+        case 'JOD':
+        case 'KWD':
+        case 'LYD':
+        case 'OMR':
+        case 'TND':
+            return 3;
+        case 'CLF':
+        case 'UYW':
+            return 4;
+        default:
+            return 2;
+    }
+}
+/** A money amount stored as an integer number of `scale`-digit minor units. */
+export class Amount {
+    /** The amount in units of 10^-`scale` of the currency, negative for a debit: 1234 with scale 2 is 12.34. */
+    minorUnits;
+    /** Number of decimal places `minorUnits` has, from 0 to 5. */
+    scale;
+    /** ISO 4217 currency code, for example `EUR`. */
+    currency;
+    /**
+     * An amount of `minorUnits` with `scale` decimal places; throws `RangeError` for a `scale` outside 0 to 5, and for
+     * `minorUnits` that are no integer or beyond 2^53 - 1 in either direction, about 90 trillion at two decimal places.
+     */
+    constructor(minorUnits, scale, currency) {
+        if (!Number.isInteger(scale) || scale < 0 || scale > maxScale) {
+            throw new RangeError(`scale must be an integer from 0 to ${maxScale}: ${scale}`);
+        }
+        if (!Number.isSafeInteger(minorUnits))
+            throw new RangeError(`minorUnits out of range: ${minorUnits}`);
+        // No negative zero, which would format as `-0.00`.
+        this.minorUnits = minorUnits === 0 ? 0 : minorUnits;
+        this.scale = scale;
+        this.currency = currency;
+    }
+    /**
+     * Parses a number as banks send it: digits with at most one decimal separator, `,` (FinTS 3.0, MT940) or `.` (camt),
+     * and no thousands separators.
+     *
+     * The amount has the decimal places of the `currency`'s minor unit (ISO 4217): two for most currencies, none for
+     * `JPY`, three for `KWD`. It has more where the value has more significant digits. So `100,` in `EUR` is `100.00`, in
+     * `JPY` `100`.
+     *
+     * Throws `FormatError` for anything else, so that `1.234,56` in bank data is an error, not a guess, and for more than
+     * five decimal places (trailing zeros aside) or more than 15 digits.
+     */
+    static parseDecimal(value, currency) {
+        const match = decimal.exec(value.trim());
+        const whole = match?.[2] ?? '';
+        let fraction = match?.[3] ?? '';
+        if (!match || (whole === '' && fraction === ''))
+            throw new FormatError('Invalid amount', value);
+        const minorDigits = minorUnitDigits(currency);
+        while (fraction.length > minorDigits && fraction.endsWith('0')) {
+            fraction = fraction.substring(0, fraction.length - 1);
+        }
+        fraction = fraction.padEnd(minorDigits, '0');
+        const digits = `${whole.replace(/^0+/, '')}${fraction}`;
+        if (fraction.length > maxScale || digits.length > maxDigits) {
+            throw new FormatError(`Amount with more than ${maxScale} decimal places or ${maxDigits} digits`, value);
+        }
+        // Nothing is left of a zero without decimal places, such as `0` in `JPY`.
+        const units = digits === '' ? 0 : Number(digits);
+        return new Amount(match[1] === '-' ? -units : units, fraction.length, currency);
+    }
+    /** The amount as a floating-point number, which cannot hold every decimal fraction exactly; do not calculate with it. */
+    get value() {
+        return this.minorUnits / powersOfTen[this.scale];
+    }
+    /** Whether the amount is below zero. */
+    get isNegative() {
+        return this.minorUnits < 0;
+    }
+    /** Whether the amount is zero. */
+    get isZero() {
+        return this.minorUnits === 0;
+    }
+    /** This amount with the opposite sign. */
+    negate() {
+        return new Amount(-this.minorUnits, this.scale, this.currency);
+    }
+    /** This amount without its sign. */
+    abs() {
+        return this.isNegative ? this.negate() : this;
+    }
+    /**
+     * The sum with `other`, at the larger of the two scales; throws `TypeError` for another currency and `RangeError` for
+     * a sum beyond what an amount holds.
+     */
+    add(other) {
+        this.checkCurrency(other);
+        const [mine, theirs] = this.atCommonScale(other);
+        const sum = mine + theirs;
+        const limit = BigInt(maxMinorUnits);
+        if (sum > limit || sum < -limit)
+            throw new RangeError(`The sum of ${this.toString()} and ${other.toString()} is too large for an Amount`);
+        return new Amount(Number(sum), Math.max(this.scale, other.scale), this.currency);
+    }
+    /** The difference to `other`; throws `TypeError` for another currency. */
+    subtract(other) {
+        return this.add(other.negate());
+    }
+    /** Compares by value, whatever the scales; throws `TypeError` for another currency. */
+    compareTo(other) {
+        this.checkCurrency(other);
+        return this.compareValue(other);
+    }
+    /** Whether `other` is the same amount in the same currency, whatever the `scale`: 1.50 equals 1.500. */
+    equals(other) {
+        return other instanceof Amount && other.currency === this.currency && this.compareValue(other) === 0;
+    }
+    /** Formats the amount without currency, for example `-12.50`. */
+    toDecimalString(decimalSeparator = '.') {
+        const digits = Math.abs(this.minorUnits)
+            .toString()
+            .padStart(this.scale + 1, '0');
+        const whole = digits.substring(0, digits.length - this.scale);
+        const fraction = digits.substring(digits.length - this.scale);
+        const sign = this.isNegative ? '-' : '';
+        return this.scale === 0 ? `${sign}${whole}` : `${sign}${whole}${decimalSeparator}${fraction}`;
+    }
+    toString() {
+        return `${this.toDecimalString()} ${this.currency}`;
+    }
+    /** The minor units of both amounts at the larger scale, as `bigint`s, since the factor could leave the safe range. */
+    atCommonScale(other) {
+        const target = Math.max(this.scale, other.scale);
+        return [this.rescale(target), other.rescale(target)];
+    }
+    rescale(target) {
+        return BigInt(this.minorUnits) * BigInt(powersOfTen[target - this.scale]);
+    }
+    compareValue(other) {
+        if (this.scale === other.scale)
+            return Math.sign(this.minorUnits - other.minorUnits);
+        const [mine, theirs] = this.atCommonScale(other);
+        return mine === theirs ? 0 : mine < theirs ? -1 : 1;
+    }
+    checkCurrency(other) {
+        if (other.currency !== this.currency)
+            throw new TypeError(`Currency mismatch: ${this.currency} vs ${other.currency}`);
+    }
+}
+/**
+ * `amount` as a credit (unchanged) or a debit (negated), by the bank's credit/debit `mark`.
+ *
+ * Throws `FormatError` for any other `mark`, `undefined` included: a missing mark must not be read as a credit.
+ */
+export function withMark(amount, mark, credit, debit) {
+    if (mark === credit)
+        return amount;
+    if (mark === debit)
+        return amount.negate();
+    throw new FormatError(`Credit/debit mark is neither "${credit}" nor "${debit}"`, mark);
+}
+//# sourceMappingURL=amount.js.map

package/dist/core/amount.js.map

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

package/dist/core/balance.d.ts

@@ -0,0 +1,54 @@
+import type { Account } from './account.js';
+import type { Amount } from './amount.js';
+/** What `Balance` takes; the bank states the amounts it knows. */
+export interface BalanceInit {
+    account: Account;
+    booked: Amount;
+    bookedAsOf: Date;
+    bookedAsOfTime?: Date | undefined;
+    pending?: Amount | undefined;
+    creditLine?: Amount | undefined;
+    available?: Amount | undefined;
+    used?: Amount | undefined;
+    overdraft?: Amount | undefined;
+    bookingDate?: Date | undefined;
+    bookingTime?: Date | undefined;
+    productName?: string | undefined;
+}
+/** Account balance as reported by the bank. */
+export declare class Balance {
+    /** The account the balance belongs to. */
+    readonly account: Account;
+    /** Booked balance; negative when overdrawn. */
+    readonly booked: Amount;
+    /**
+     * The calendar day the bank states with the booked balance: the day it transmitted the balance, which need not be the
+     * day the balance was booked (`bookingDate`). A local `Date` at midnight.
+     */
+    readonly bookedAsOf: Date;
+    /** The exact moment of `bookedAsOf`, where the bank states the time of day as well; `undefined` otherwise. */
+    readonly bookedAsOfTime: Date | undefined;
+    /** Balance of pending (not yet booked) transactions, if the bank reports it. */
+    readonly pending: Amount | undefined;
+    /** Arranged overdraft limit. */
+    readonly creditLine: Amount | undefined;
+    /** Amount currently available for payments. */
+    readonly available: Amount | undefined;
+    /** Amount already drawn on the account's limit. */
+    readonly used: Amount | undefined;
+    /** Amount by which the account exceeds its limit. */
+    readonly overdraft: Amount | undefined;
+    /** The calendar day the booked balance was booked (Buchungszeitpunkt), where the bank states it. */
+    readonly bookingDate: Date | undefined;
+    /** The exact moment of `bookingDate`, where the bank states the time of day as well; `undefined` otherwise. */
+    readonly bookingTime: Date | undefined;
+    /** The bank's name for the account, for example `Girokonto`. */
+    readonly productName: string | undefined;
+    constructor(init: BalanceInit);
+    /**
+     * The account, as `Account.toString` shows it, and the date; no amount, so that logs and crash reports do not collect
+     * account data.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=balance.d.ts.map

package/dist/core/balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../../src/core/balance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,IAAI,CAAC;IACjB,cAAc,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,+CAA+C;AAC/C,qBAAa,OAAO;IAClB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAE1B,8GAA8G;IAC9G,QAAQ,CAAC,cAAc,EAAE,IAAI,GAAG,SAAS,CAAC;IAE1C,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAErC,gCAAgC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAExC,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAElC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC,oGAAoG;IACpG,QAAQ,CAAC,WAAW,EAAE,IAAI,GAAG,SAAS,CAAC;IAEvC,+GAA+G;IAC/G,QAAQ,CAAC,WAAW,EAAE,IAAI,GAAG,SAAS,CAAC;IAEvC,gEAAgE;IAChE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE7B,IAAI,EAAE,WAAW;IAe7B;;;OAGG;IACH,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/core/balance.js

@@ -0,0 +1,53 @@
+import { formatIsoDate } from '../util/dates.js';
+/** Account balance as reported by the bank. */
+export class Balance {
+    /** The account the balance belongs to. */
+    account;
+    /** Booked balance; negative when overdrawn. */
+    booked;
+    /**
+     * The calendar day the bank states with the booked balance: the day it transmitted the balance, which need not be the
+     * day the balance was booked (`bookingDate`). A local `Date` at midnight.
+     */
+    bookedAsOf;
+    /** The exact moment of `bookedAsOf`, where the bank states the time of day as well; `undefined` otherwise. */
+    bookedAsOfTime;
+    /** Balance of pending (not yet booked) transactions, if the bank reports it. */
+    pending;
+    /** Arranged overdraft limit. */
+    creditLine;
+    /** Amount currently available for payments. */
+    available;
+    /** Amount already drawn on the account's limit. */
+    used;
+    /** Amount by which the account exceeds its limit. */
+    overdraft;
+    /** The calendar day the booked balance was booked (Buchungszeitpunkt), where the bank states it. */
+    bookingDate;
+    /** The exact moment of `bookingDate`, where the bank states the time of day as well; `undefined` otherwise. */
+    bookingTime;
+    /** The bank's name for the account, for example `Girokonto`. */
+    productName;
+    constructor(init) {
+        this.account = init.account;
+        this.booked = init.booked;
+        this.bookedAsOf = init.bookedAsOf;
+        this.bookedAsOfTime = init.bookedAsOfTime;
+        this.pending = init.pending;
+        this.creditLine = init.creditLine;
+        this.available = init.available;
+        this.used = init.used;
+        this.overdraft = init.overdraft;
+        this.bookingDate = init.bookingDate;
+        this.bookingTime = init.bookingTime;
+        this.productName = init.productName;
+    }
+    /**
+     * The account, as `Account.toString` shows it, and the date; no amount, so that logs and crash reports do not collect
+     * account data.
+     */
+    toString() {
+        return `Balance(${this.account.toString()}, ${formatIsoDate(this.bookedAsOf)})`;
+    }
+}
+//# sourceMappingURL=balance.js.map

package/dist/core/balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.js","sourceRoot":"","sources":["../../src/core/balance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAoBjD,+CAA+C;AAC/C,MAAM,OAAO,OAAO;IAClB,0CAA0C;IACjC,OAAO,CAAU;IAE1B,+CAA+C;IACtC,MAAM,CAAS;IAExB;;;OAGG;IACM,UAAU,CAAO;IAE1B,8GAA8G;IACrG,cAAc,CAAmB;IAE1C,gFAAgF;IACvE,OAAO,CAAqB;IAErC,gCAAgC;IACvB,UAAU,CAAqB;IAExC,+CAA+C;IACtC,SAAS,CAAqB;IAEvC,mDAAmD;IAC1C,IAAI,CAAqB;IAElC,qDAAqD;IAC5C,SAAS,CAAqB;IAEvC,oGAAoG;IAC3F,WAAW,CAAmB;IAEvC,+GAA+G;IACtG,WAAW,CAAmB;IAEvC,gEAAgE;IACvD,WAAW,CAAqB;IAEzC,YAAY,IAAiB;QAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,OAAO,WAAW,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;IAClF,CAAC;CACF"}

package/dist/core/bank-info.d.ts

@@ -0,0 +1,49 @@
+/** General bank information from the bank parameter data (BPD). */
+export declare class BankInfo {
+    /** German bank code (BLZ). */
+    readonly bankCode: string;
+    /** The bank's name. */
+    readonly name: string | undefined;
+    /** Version of the bank parameter data this information comes from. */
+    readonly bpdVersion: number;
+    /** FinTS versions the bank supports, as it names them. */
+    readonly supportedVersions: readonly string[];
+    /** Languages the bank's messages come in, as codes the bank defines. */
+    readonly languages: readonly string[];
+    /** Largest message in kilobytes (1024 bytes) the bank accepts; the client sends nothing larger. */
+    readonly maxMessageSize: number | undefined;
+    /**
+     * Time in seconds before which a client must not send a life-indicator message to keep an idle dialog open, `0` for
+     * none (HIBPA, Formals C.9). This client sends no such messages.
+     */
+    readonly minTimeout: number | undefined;
+    /**
+     * Time in seconds after which the bank will likely end a dialog without messages, `0` for no limit (HIBPA, Formals
+     * C.9). The client starts a new dialog for a call after that time.
+     */
+    readonly maxTimeout: number | undefined;
+    constructor(init: {
+        bankCode: string;
+        name?: string | undefined;
+        bpdVersion: number;
+        supportedVersions?: readonly string[];
+        languages?: readonly string[];
+        maxMessageSize?: number | undefined;
+        minTimeout?: number | undefined;
+        maxTimeout?: number | undefined;
+    });
+}
+/** Free-text message sent by the bank during login. */
+export declare class BankMessage {
+    /** What the message is about. */
+    readonly subject: string;
+    /** The message itself. */
+    readonly text: string;
+    constructor(
+    /** What the message is about. */
+    subject: string, 
+    /** The message itself. */
+    text: string);
+    toString(): string;
+}
+//# sourceMappingURL=bank-info.d.ts.map

package/dist/core/bank-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bank-info.d.ts","sourceRoot":"","sources":["../../src/core/bank-info.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,qBAAa,QAAQ;IACnB,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,uBAAuB;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAElC,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,0DAA0D;IAC1D,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAE9C,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAEtC,mGAAmG;IACnG,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAExC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE5B,IAAI,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACtC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACjC;CAUF;AAED,uDAAuD;AACvD,qBAAa,WAAW;IAEpB,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM;;IAHrB,iCAAiC;IACxB,OAAO,EAAE,MAAM;IACxB,0BAA0B;IACjB,IAAI,EAAE,MAAM;IAGvB,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/core/bank-info.js

@@ -0,0 +1,52 @@
+/** General bank information from the bank parameter data (BPD). */
+export class BankInfo {
+    /** German bank code (BLZ). */
+    bankCode;
+    /** The bank's name. */
+    name;
+    /** Version of the bank parameter data this information comes from. */
+    bpdVersion;
+    /** FinTS versions the bank supports, as it names them. */
+    supportedVersions;
+    /** Languages the bank's messages come in, as codes the bank defines. */
+    languages;
+    /** Largest message in kilobytes (1024 bytes) the bank accepts; the client sends nothing larger. */
+    maxMessageSize;
+    /**
+     * Time in seconds before which a client must not send a life-indicator message to keep an idle dialog open, `0` for
+     * none (HIBPA, Formals C.9). This client sends no such messages.
+     */
+    minTimeout;
+    /**
+     * Time in seconds after which the bank will likely end a dialog without messages, `0` for no limit (HIBPA, Formals
+     * C.9). The client starts a new dialog for a call after that time.
+     */
+    maxTimeout;
+    constructor(init) {
+        this.bankCode = init.bankCode;
+        this.name = init.name;
+        this.bpdVersion = init.bpdVersion;
+        this.supportedVersions = Object.freeze([...(init.supportedVersions ?? [])]);
+        this.languages = Object.freeze([...(init.languages ?? [])]);
+        this.maxMessageSize = init.maxMessageSize;
+        this.minTimeout = init.minTimeout;
+        this.maxTimeout = init.maxTimeout;
+    }
+}
+/** Free-text message sent by the bank during login. */
+export class BankMessage {
+    subject;
+    text;
+    constructor(
+    /** What the message is about. */
+    subject, 
+    /** The message itself. */
+    text) {
+        this.subject = subject;
+        this.text = text;
+    }
+    toString() {
+        return `${this.subject}: ${this.text}`;
+    }
+}
+//# sourceMappingURL=bank-info.js.map

package/dist/core/bank-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bank-info.js","sourceRoot":"","sources":["../../src/core/bank-info.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,OAAO,QAAQ;IACnB,8BAA8B;IACrB,QAAQ,CAAS;IAE1B,uBAAuB;IACd,IAAI,CAAqB;IAElC,sEAAsE;IAC7D,UAAU,CAAS;IAE5B,0DAA0D;IACjD,iBAAiB,CAAoB;IAE9C,wEAAwE;IAC/D,SAAS,CAAoB;IAEtC,mGAAmG;IAC1F,cAAc,CAAqB;IAE5C;;;OAGG;IACM,UAAU,CAAqB;IAExC;;;OAGG;IACM,UAAU,CAAqB;IAExC,YAAY,IASX;QACC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACpC,CAAC;CACF;AAED,uDAAuD;AACvD,MAAM,OAAO,WAAW;IAGX;IAEA;IAJX;IACE,iCAAiC;IACxB,OAAe;IACxB,0BAA0B;IACjB,IAAY;QAFZ,YAAO,GAAP,OAAO,CAAQ;QAEf,SAAI,GAAJ,IAAI,CAAQ;IACpB,CAAC;IAEJ,QAAQ;QACN,OAAO,GAAG,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;IACzC,CAAC;CACF"}

package/dist/core/client.d.ts

@@ -0,0 +1,126 @@
+import type { TanCallback, TanMediumSelector, TanMethodSelector } from '../tan/challenge.js';
+import type { TanMedium, TanMethod } from '../tan/tan-models.js';
+import type { Account } from './account.js';
+import type { Balance } from './balance.js';
+import type { BankInfo, BankMessage } from './bank-info.js';
+import type { FinTsFeedback } from './feedback.js';
+import type { Transaction, TransactionFormat } from './transaction.js';
+import type { FinTsTransport } from './transport.js';
+/** Which way a FinTS message travels: from the client to the bank, or back. */
+export type MessageDirection = 'outgoing' | 'incoming';
+/** Receives every FinTS message with PIN and TAN masked. */
+export type MessageLogger = (direction: MessageDirection, message: string) => void;
+/** Receives free-text messages the bank sends during login. */
+export type BankMessageHandler = (message: BankMessage) => void;
+/** Receives a warning the bank sends, a return code from 3000 to 3999. */
+export type WarningHandler = (warning: FinTsFeedback) => void;
+/**
+ * How a client reaches the user and the bank, apart from the login data in `FinTsConfig`.
+ *
+ * An error thrown by a callback that only informs the app (`onBankMessage`, `onWarning`, `logger`) fails the call once
+ * the call's exchange with the bank is over, so that it cannot break off a dialog half-way; an error of the call itself
+ * takes precedence.
+ */
+export interface FinTsClientOptions {
+    /** Called whenever the bank asks for a TAN or an app approval. */
+    tanCallback: TanCallback;
+    /** Picks the TAN method when the bank offers several; the first is used without it. */
+    tanMethodSelector?: TanMethodSelector;
+    /** Picks the TAN medium when the method needs one and the user has several; the first is used without it. */
+    tanMediumSelector?: TanMediumSelector;
+    /** Receives the free-text messages the bank sends during login. */
+    onBankMessage?: BankMessageHandler;
+    /**
+     * Receives the bank's warnings, such as 3951 (switch to another TAN method), but not those the client acts on itself,
+     * such as 3040 (more data follow). Show them to the user with code and text, as the specification asks.
+     */
+    onWarning?: WarningHandler;
+    /** Receives every FinTS message with PIN and TAN masked, for diagnosis; the messages contain account data. */
+    logger?: MessageLogger;
+    /**
+     * The `FinTsClient.state` of a previous session, which skips the bank setup steps.
+     *
+     * A state saved for another user or bank is ignored.
+     */
+    state?: string | undefined;
+    /**
+     * Sends the messages; an `HttpTransport` by default.
+     *
+     * The client closes it on `FinTsClient.close`, so hand each client a transport of its own.
+     */
+    transport?: FinTsTransport;
+}
+/** What `getTransactions` takes besides the account. */
+export interface TransactionQuery {
+    /** The first day, a day in the future counting as today; banks typically ask for a TAN beyond 90 days ago. */
+    from?: Date | undefined;
+    /** The last day, a day in the future counting as today. */
+    to?: Date | undefined;
+    /** The format to ask for; `auto` by default. */
+    format?: TransactionFormat;
+}
+/**
+ * Read access to a bank account over FinTS.
+ *
+ * All calls share one bank dialog, so strong authentication happens once per session. Calls run one after another; call
+ * `close` when done.
+ *
+ * A callback in `FinTsClientOptions` must not wait for another call of its client, which would wait for the running
+ * call. On Node.js, Deno and Bun such a call fails with `FinTsStateError`; elsewhere it would wait forever. `close` works
+ * from anywhere.
+ */
+export interface FinTsClient {
+    /**
+     * Serialized session data: bank and user parameters, customer system ID, the TAN methods the user may use, the chosen
+     * TAN method and medium, and the SEPA account list.
+     *
+     * Contains no PIN or TAN, but account details, so store it encrypted.
+     */
+    readonly state: string;
+    /** Security function code of the TAN method in use, for example `942`; `undefined` before the first login. */
+    readonly selectedTanMethod: string | undefined;
+    /** Name of the TAN medium sent to the bank, if the method needs one. */
+    readonly selectedTanMedium: string | undefined;
+    /**
+     * Switches to another TAN method, and optionally TAN medium, for the following calls.
+     *
+     * Ends the current dialog, so the next call logs in again with the new method. If the bank does not offer
+     * `securityFunction`, the client picks another method at that login.
+     */
+    selectTanMethod(securityFunction: string, tanMedium?: string): Promise<void>;
+    /** General information about the bank, from the bank parameter data. */
+    getBankInfo(): Promise<BankInfo>;
+    /** TAN procedures the bank allows for this user. */
+    getTanMethods(): Promise<TanMethod[]>;
+    /** TAN devices registered for this user. */
+    getTanMedia(): Promise<TanMedium[]>;
+    /** Accounts of the user, completed with IBAN and BIC where the bank provides them. */
+    getAccounts(): Promise<Account[]>;
+    /**
+     * The balance of `account`.
+     *
+     * Where the user parameter data carry the complete balance (account extension), possibly from the saved `state`, it
+     * comes from there without a query; `Balance.bookedAsOf` tells the day it states.
+     *
+     * Throws `FinTsUnsupportedError`, without asking the bank, where the parameter data rule the query out.
+     */
+    getBalance(account: Account): Promise<Balance>;
+    /**
+     * Transactions from the day of `from` to the day of `to`, both included, booked and pending, sorted by date; those of
+     * the same day in the bank's order.
+     *
+     * Only the local calendar day counts, and a day in the future counts as today. Banks typically ask for a TAN when
+     * `from` is more than 90 days ago; see also `Account.dataStatus`. Throws `TypeError` if `from` lies on a day after
+     * `to`, and `FinTsUnsupportedError`, without asking the bank, where the parameter data rule the query out.
+     */
+    getTransactions(account: Account, query?: TransactionQuery): Promise<Transaction[]>;
+    /**
+     * Ends the bank dialog and releases the connection.
+     *
+     * A running call stops at its next step, also while it waits for a TAN, an app approval or a selection, and fails with
+     * `FinTsStateError`, as do all later calls. A request already on its way is awaited, at most for the transport's
+     * timeout.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

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

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

package/dist/core/client.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.js.map

package/dist/core/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":""}

package/dist/core/config.d.ts

@@ -0,0 +1,68 @@
+/** Numeric country code of Germany (ISO 3166), where FinTS banks are. */
+export declare const defaultCountryCode = "280";
+/** What `FinTsConfig` takes. */
+export interface FinTsConfigInit {
+    /** The bank's FinTS PIN/TAN endpoint; must be https. */
+    url: string | URL;
+    /** German bank code (BLZ). */
+    bankCode: string;
+    /** Login name (Benutzerkennung / Legitimations-ID). */
+    userId: string;
+    /** Customer ID; defaults to `userId`. */
+    customerId?: string | undefined;
+    /** FinTS product registration number from the Deutsche Kreditwirtschaft; at most 25 characters. */
+    productId: string;
+    /** Version of the app as registered with the product; at most five characters. `1.0` by default. */
+    productVersion?: string;
+    /** Numeric country code of the bank, `280` (Germany) by default. */
+    countryCode?: string;
+    /**
+     * Allows plain http for the loopback addresses `localhost`, `127.x.x.x` and `::1`, for tests against a local server.
+     *
+     * Any other host must use https, whatever this says: the PIN travels with every message.
+     */
+    allowInsecureUrl?: boolean;
+}
+/** Connection and login data for one bank user. */
+export declare class FinTsConfig {
+    /** Numeric country code of Germany (ISO 3166), where FinTS banks are. */
+    static readonly defaultCountryCode = "280";
+    readonly url: URL;
+    readonly bankCode: string;
+    readonly userId: string;
+    private readonly explicitCustomerId;
+    readonly productId: string;
+    readonly productVersion: string;
+    readonly countryCode: string;
+    readonly allowInsecureUrl: boolean;
+    /**
+     * Throws `TypeError` if `url` is not a valid URL, has no host or is not https, unless `allowInsecureUrl` is set and
+     * `url` is a loopback address, and if a login detail or the product is empty: the bank would refuse the login.
+     */
+    constructor(init: FinTsConfigInit);
+    /** Customer ID; defaults to `userId`. */
+    get customerId(): string;
+}
+/** The host of `url` without the brackets of an IPv6 address, as `URL` writes it. */
+export declare function hostOf(url: URL): string;
+/**
+ * Throws `TypeError` unless `url` names a host and uses https: the PIN travels with every message.
+ *
+ * With `allowInsecure`, http is accepted for loopback hosts only.
+ */
+export declare function requireSecureUrl(url: URL, allowInsecure?: boolean): void;
+/**
+ * Throws `TypeError` for an empty PIN, which the bank would count as a failed attempt, and for one with leading or
+ * trailing blanks: FinTS values carry none (Formals B.4.1), so such a PIN could only go out changed.
+ *
+ * The message leaves out the value.
+ */
+export declare function requirePin(pin: string): string;
+/**
+ * Throws `TypeError` if `pin` is shorter than `min` or longer than `max` characters, the bank's limits: the bank would
+ * count such a PIN as a failed attempt. A limit that is `undefined` or below 1 does not apply.
+ *
+ * The message leaves out the PIN and its length.
+ */
+export declare function requirePinLength(pin: string, min: number | undefined, max: number | undefined): void;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IAClB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,mGAAmG;IACnG,SAAS,EAAE,MAAM,CAAC;IAClB,oGAAoG;IACpG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,mDAAmD;AACnD,qBAAa,WAAW;IACtB,yEAAyE;IACzE,MAAM,CAAC,QAAQ,CAAC,kBAAkB,SAAsB;IAExD,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAEnC;;;OAGG;gBACS,IAAI,EAAE,eAAe;IA4BjC,yCAAyC;IACzC,IAAI,UAAU,IAAI,MAAM,CAEvB;CACF;AAMD,qFAAqF;AACrF,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAGvC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,UAAQ,GAAG,IAAI,CAItE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAUpG"}