@coderoftime/fints 0.0.0-stage → 0.1.0

package/dist/util/xml.js

@@ -0,0 +1,183 @@
+import { FormatError } from './errors.js';
+/**
+ * An element of a parsed XML document, looked up by local name: camt documents come with and without namespace
+ * prefixes.
+ */
+export class XmlElement {
+    localName;
+    attributes;
+    children = [];
+    constructor(
+    /** The name without namespace prefix. */
+    localName, 
+    /** The attributes by name without namespace prefix; namespace declarations are left out. */
+    attributes) {
+        this.localName = localName;
+        this.attributes = attributes;
+    }
+    get childElements() {
+        return this.children.filter((c) => c instanceof XmlElement);
+    }
+    /** The text of this element and all below it. */
+    get innerText() {
+        return this.children.map((c) => (c instanceof XmlElement ? c.innerText : c)).join('');
+    }
+    getAttribute(localName) {
+        return this.attributes.get(localName);
+    }
+    /** The first child element called `localName`. */
+    child(localName) {
+        return this.childElements.find((c) => c.localName === localName);
+    }
+    /** The element reached by following child names along `path`; this element for an empty path. */
+    at(path) {
+        return path.reduce((element, name) => element?.child(name), this);
+    }
+    /** The trimmed text of the element at `path`, or `undefined` if it is missing or empty. */
+    textAt(path) {
+        const text = this.at(path)?.innerText.trim();
+        return text === undefined || text === '' ? undefined : text;
+    }
+    /** All elements below this one called `localName`, in document order. */
+    descendantsNamed(localName) {
+        const found = [];
+        const visit = (element) => {
+            for (const c of element.childElements) {
+                if (c.localName === localName)
+                    found.push(c);
+                visit(c);
+            }
+        };
+        visit(this);
+        return found;
+    }
+}
+const namePattern = /[^\s<>/=!?"']+/y;
+const attributePattern = /\s+([^\s<>/=!?"']+)\s*=\s*(?:"([^"<]*)"|'([^'<]*)')/y;
+/** The match of the sticky `pattern` at `position` in `text`. */
+function matchAt(pattern, text, position) {
+    pattern.lastIndex = position;
+    return pattern.exec(text);
+}
+const predefinedEntities = { amp: '&', lt: '<', gt: '>', quot: '"', apos: "'" };
+function localNameOf(qualified) {
+    const colon = qualified.indexOf(':');
+    return colon < 0 ? qualified : qualified.substring(colon + 1);
+}
+/** Resolves the character and predefined entity references in `text`; throws `FormatError` for any other. */
+function decodeEntities(text) {
+    return text.replace(/&([^;&\s]*);?/g, (match, name) => {
+        if (!match.endsWith(';'))
+            throw new FormatError('Invalid XML: unterminated entity reference');
+        if (name.startsWith('#')) {
+            const hex = name.startsWith('#x');
+            const digits = name.substring(hex ? 2 : 1);
+            const code = (hex ? /^[0-9a-fA-F]+$/ : /^\d+$/).test(digits) ? parseInt(digits, hex ? 16 : 10) : NaN;
+            if (!(code > 0 && code <= 0x10ffff && (code < 0xd800 || code > 0xdfff))) {
+                throw new FormatError('Invalid XML character reference', match);
+            }
+            return String.fromCodePoint(code);
+        }
+        const value = predefinedEntities[name];
+        if (value === undefined)
+            throw new FormatError('Invalid XML: unknown entity', match);
+        return value;
+    });
+}
+/**
+ * Parses an XML document and returns its root element; throws `FormatError` if it is not well-formed.
+ *
+ * A document type declaration is refused: bank data have none, and its entities could expand without limit.
+ */
+export function parseXml(xml) {
+    let position = 0;
+    const stack = [];
+    let root;
+    const fail = (reason) => {
+        throw new FormatError(`Invalid XML: ${reason} at position ${position}`);
+    };
+    const skipPast = (terminator, what) => {
+        const end = xml.indexOf(terminator, position);
+        if (end < 0)
+            fail(`unterminated ${what}`);
+        position = end + terminator.length;
+    };
+    while (position < xml.length) {
+        const lt = xml.indexOf('<', position);
+        const textEnd = lt < 0 ? xml.length : lt;
+        if (textEnd > position) {
+            const text = xml.substring(position, textEnd);
+            const parent = stack.at(-1);
+            if (parent)
+                parent.children.push(decodeEntities(text));
+            else if (text.trim() !== '')
+                fail('text outside the root element');
+            position = textEnd;
+            continue;
+        }
+        if (xml.startsWith('<?', position)) {
+            skipPast('?>', 'processing instruction');
+        }
+        else if (xml.startsWith('<!--', position)) {
+            skipPast('-->', 'comment');
+        }
+        else if (xml.startsWith('<![CDATA[', position)) {
+            const parent = stack.at(-1) ?? fail('CDATA outside the root element');
+            const start = position + 9;
+            skipPast(']]>', 'CDATA section');
+            parent.children.push(xml.substring(start, position - 3));
+        }
+        else if (xml.startsWith('<!', position)) {
+            fail('document type declarations are not supported');
+        }
+        else if (xml.startsWith('</', position)) {
+            position += 2;
+            const name = matchAt(namePattern, xml, position)?.[0] ?? fail('missing end tag name');
+            position += name.length;
+            while (/\s/.test(xml.charAt(position)))
+                position++;
+            if (xml.charAt(position) !== '>')
+                fail('malformed end tag');
+            position++;
+            const open = stack.pop();
+            if (open === undefined || open.localName !== localNameOf(name))
+                fail(`unexpected end tag ${name}`);
+        }
+        else {
+            position++;
+            const name = matchAt(namePattern, xml, position)?.[0] ?? fail('missing element name');
+            position += name.length;
+            const attributes = new Map();
+            for (;;) {
+                const attribute = matchAt(attributePattern, xml, position);
+                if (!attribute)
+                    break;
+                position += attribute[0].length;
+                const attributeName = attribute[1];
+                if (attributeName !== 'xmlns' && !attributeName.startsWith('xmlns:')) {
+                    attributes.set(localNameOf(attributeName), decodeEntities(attribute[2] ?? attribute[3] ?? ''));
+                }
+            }
+            while (/\s/.test(xml.charAt(position)))
+                position++;
+            const selfClosing = xml.startsWith('/>', position);
+            if (!selfClosing && xml.charAt(position) !== '>')
+                fail(`malformed start tag ${name}`);
+            position += selfClosing ? 2 : 1;
+            const element = new XmlElement(localNameOf(name), attributes);
+            const parent = stack.at(-1);
+            if (parent)
+                parent.children.push(element);
+            else if (root)
+                fail('a second root element');
+            else
+                root = element;
+            if (!selfClosing)
+                stack.push(element);
+        }
+    }
+    if (stack.length > 0)
+        fail(`unclosed element ${stack.at(-1).localName}`);
+    return root ?? fail('no root element');
+}
+//# sourceMappingURL=xml.js.map

package/dist/util/xml.js.map

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

package/dist/v3/account-extension.d.ts

@@ -0,0 +1,25 @@
+import { AccountDataStatus, type Account } from '../core/account.js';
+import { Balance } from '../core/balance.js';
+/**
+ * The account extension of the user parameter data (HIUPD "Erweiterung, kontobezogen", Formals E.3.1): JSON with the
+ * BIC, the balance, and what the bank tells about the data it holds for the account.
+ */
+export declare class AccountExtension {
+    /** The BIC of the account, which spares the SEPA account list (Formals F.3.4). */
+    readonly bic: string | undefined;
+    /** What the bank tells about the account's data. */
+    readonly status: AccountDataStatus;
+    private readonly balance;
+    /** Whether `balance` holds all a balance query would deliver (`BalComplete`). */
+    private readonly balanceComplete;
+    private constructor();
+    /**
+     * Reads `json`; `undefined` if it is not a JSON object or any element is malformed, which voids the whole extension
+     * (Formals F.2, KF3).
+     */
+    static tryParse(json: string): AccountExtension | undefined;
+    private static read;
+    /** The balance of `account`, where the extension holds all a balance query would deliver (Formals F.3.2). */
+    completeBalance(account: Account): Balance | undefined;
+}
+//# sourceMappingURL=account-extension.d.ts.map

package/dist/v3/account-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-extension.d.ts","sourceRoot":"","sources":["../../src/v3/account-extension.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAuB7C;;;GAGG;AACH,qBAAa,gBAAgB;IAEzB,kFAAkF;IAClF,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAChC,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,eAAe;IAPlC,OAAO;IAUP;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAU3D,OAAO,CAAC,MAAM,CAAC,IAAI;IAgBnB,6GAA6G;IAC7G,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS;CAiBvD"}

package/dist/v3/account-extension.js

@@ -0,0 +1,176 @@
+// Internal to the package, and named after the FinTS specification. Documentation is where the meaning is not evident.
+import { AccountDataStatus } from '../core/account.js';
+import { Amount, withMark } from '../core/amount.js';
+import { Balance } from '../core/balance.js';
+import { parseFintsDate, parseUtcPlusOneDateTime } from '../util/dates.js';
+import { FormatError } from '../util/errors.js';
+/**
+ * The account extension of the user parameter data (HIUPD "Erweiterung, kontobezogen", Formals E.3.1): JSON with the
+ * BIC, the balance, and what the bank tells about the data it holds for the account.
+ */
+export class AccountExtension {
+    bic;
+    status;
+    balance;
+    balanceComplete;
+    constructor(
+    /** The BIC of the account, which spares the SEPA account list (Formals F.3.4). */
+    bic, 
+    /** What the bank tells about the account's data. */
+    status, balance, 
+    /** Whether `balance` holds all a balance query would deliver (`BalComplete`). */
+    balanceComplete) {
+        this.bic = bic;
+        this.status = status;
+        this.balance = balance;
+        this.balanceComplete = balanceComplete;
+    }
+    /**
+     * Reads `json`; `undefined` if it is not a JSON object or any element is malformed, which voids the whole extension
+     * (Formals F.2, KF3).
+     */
+    static tryParse(json) {
+        try {
+            const decoded = JSON.parse(json);
+            return isObject(decoded) ? AccountExtension.read(new Json(decoded)) : undefined;
+        }
+        catch (error) {
+            if (error instanceof FormatError || error instanceof SyntaxError)
+                return undefined;
+            throw error;
+        }
+    }
+    static read(json) {
+        const balance = json.object('AcctBal');
+        const next = json.object('AcctStatNext');
+        return new AccountExtension(json.string('BIC'), new AccountDataStatus({
+            inventory: json.object('Inventory')?.strings ?? new Map(),
+            lastTransactions: json.string('umsltzt'),
+            nextTransactionsAt: next === undefined ? undefined : moment(next, '000000'),
+            transactionBalancesCurrent: json.flag('BalStatAcct') || json.flag('BalStatAct'),
+        }), balance === undefined ? undefined : readBalance(balance), json.flag('BalComplete'));
+    }
+    /** The balance of `account`, where the extension holds all a balance query would deliver (Formals F.3.2). */
+    completeBalance(account) {
+        const b = this.balance;
+        if (b === undefined || !this.balanceComplete)
+            return undefined;
+        return new Balance({
+            account,
+            booked: b.booked.amount,
+            bookedAsOf: b.booked.date,
+            bookedAsOfTime: b.booked.time,
+            pending: b.pending?.amount,
+            creditLine: b.creditLine,
+            available: b.available,
+            used: b.used,
+            overdraft: b.overdraft,
+            bookingDate: b.bookingDate,
+            bookingTime: b.bookingTime,
+        });
+    }
+}
+function readBalance(json) {
+    const currency = json.string('Cur') ?? fail('Extension balance without currency');
+    const amount = (key) => {
+        const value = json.string(key);
+        return value === undefined ? undefined : Amount.parseDecimal(value, currency);
+    };
+    const saldo = (key) => {
+        const s = json.object(key);
+        if (s === undefined)
+            return undefined;
+        const value = s.string('Val') ?? fail('Extension balance without value');
+        return {
+            amount: withMark(Amount.parseDecimal(value, currency), s.string('DebCrd'), 'C', 'D'),
+            date: parseFintsDate(s.string('Date')) ?? fail('Extension balance without date'),
+            time: moment(s),
+        };
+    };
+    const bookTime = json.object('BookTime');
+    return {
+        booked: saldo('CurValBal') ?? fail('Extension balance without booked balance'),
+        pending: saldo('InclPendTransBal'),
+        creditLine: amount('OverdraftLim'),
+        available: amount('AvailFunds'),
+        used: amount('AlrdyDrwnOnBal'),
+        overdraft: amount('OverDraft'),
+        bookingDate: bookTime === undefined ? undefined : parseFintsDate(bookTime.string('Date')),
+        bookingTime: bookTime === undefined ? undefined : moment(bookTime),
+    };
+}
+/**
+ * The moment of `Date` and `Time` in `json`, which the extension states in UTC+01:00 all year round; `undefined`
+ * without a time, unless `defaultTime` stands in for it.
+ */
+function moment(json, defaultTime) {
+    const time = json.string('Time') ?? defaultTime;
+    if (time === undefined)
+        return undefined;
+    return parseUtcPlusOneDateTime(json.string('Date'), time) ?? fail('Extension date or time is malformed');
+}
+function fail(message) {
+    throw new FormatError(message);
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * A JSON object of the extension, read by key without regard to case: the specification itself spells some keys
+ * differently (`OverDraftLim` and `OverdraftLim`). Values of the wrong type are a `FormatError`.
+ */
+class Json {
+    values = new Map();
+    constructor(values) {
+        for (const [key, value] of Object.entries(values))
+            this.values.set(key.toLowerCase(), value);
+    }
+    value(key) {
+        return this.values.get(key.toLowerCase());
+    }
+    /** A string, or a number written as string: dates and times come as either. */
+    string(key) {
+        const value = this.value(key);
+        if (value === undefined || value === null)
+            return undefined;
+        if (typeof value === 'string')
+            return value.trim() === '' ? undefined : value.trim();
+        if (typeof value === 'number')
+            return String(value);
+        throw new FormatError(`Extension element "${key}" is not text`);
+    }
+    flag(key) {
+        const value = this.value(key);
+        if (value === undefined || value === null)
+            return false;
+        if (typeof value === 'boolean')
+            return value;
+        if (typeof value === 'string')
+            return value === 'J' || value.toLowerCase() === 'true';
+        throw new FormatError(`Extension element "${key}" is not a flag`);
+    }
+    object(key) {
+        const value = this.value(key);
+        if (value === undefined || value === null)
+            return undefined;
+        if (isObject(value))
+            return new Json(value);
+        throw new FormatError(`Extension element "${key}" is not an object`);
+    }
+    /** The object's values as strings, keyed in capitals, as segment IDs are written. */
+    get strings() {
+        const result = new Map();
+        for (const [key, value] of this.values) {
+            if (value === null)
+                result.set(key.toUpperCase(), '');
+            else if (typeof value === 'string')
+                result.set(key.toUpperCase(), value);
+            else if (typeof value === 'number')
+                result.set(key.toUpperCase(), String(value));
+            else
+                throw new FormatError(`Extension element "${key}" is not text`);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=account-extension.js.map

package/dist/v3/account-extension.js.map

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

package/dist/v3/client.d.ts

@@ -0,0 +1,24 @@
+import type { FinTsClientOptions } from '../core/client.js';
+import { FinTsConfig, type FinTsConfigInit } from '../core/config.js';
+import { PinTanClient } from '../session/pin-tan-client.js';
+import type { IncomingMessage3 } from './message.js';
+import type { SegmentSpec } from './syntax.js';
+/** What `FinTs3Client` takes. */
+export interface FinTs3ClientInit {
+    /** Where and as whom to log in: a `FinTsConfig`, or what its constructor takes. */
+    config: FinTsConfig | FinTsConfigInit;
+    /** The user's PIN; the client keeps it in memory only and never logs it. */
+    pin: string;
+    /** How the client reaches the user and the bank. */
+    options: FinTsClientOptions;
+}
+/** FinTS 3.0 PIN/TAN client, the version German banks use. */
+export declare class FinTs3Client extends PinTanClient<IncomingMessage3, SegmentSpec> {
+    /**
+     * Throws `TypeError` if the configuration is invalid, if the PIN is empty, or if the PIN or login data contain
+     * characters FinTS 3.0 cannot send: it uses ISO 8859-1, so `€` and most non-Latin letters are not possible. Throws as
+     * well for a product ID longer than 25 or a product version longer than 5 characters.
+     */
+    constructor(init: FinTs3ClientInit);
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/v3/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,MAAM,EAAE,WAAW,GAAG,eAAe,CAAC;IACtC,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAED,8DAA8D;AAC9D,qBAAa,YAAa,SAAQ,YAAY,CAAC,gBAAgB,EAAE,WAAW,CAAC;IAC3E;;;;OAIG;gBACS,IAAI,EAAE,gBAAgB;CAInC"}

package/dist/v3/client.js

@@ -0,0 +1,16 @@
+import { FinTsConfig } from '../core/config.js';
+import { PinTanClient } from '../session/pin-tan-client.js';
+import { FinTs3Protocol } from './protocol.js';
+/** FinTS 3.0 PIN/TAN client, the version German banks use. */
+export class FinTs3Client extends PinTanClient {
+    /**
+     * Throws `TypeError` if the configuration is invalid, if the PIN is empty, or if the PIN or login data contain
+     * characters FinTS 3.0 cannot send: it uses ISO 8859-1, so `€` and most non-Latin letters are not possible. Throws as
+     * well for a product ID longer than 25 or a product version longer than 5 characters.
+     */
+    constructor(init) {
+        const config = init.config instanceof FinTsConfig ? init.config : new FinTsConfig(init.config);
+        super(init.options, (logger) => new FinTs3Protocol(config, init.pin, init.options.transport, logger));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/v3/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/v3/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAwB,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAa/C,8DAA8D;AAC9D,MAAM,OAAO,YAAa,SAAQ,YAA2C;IAC3E;;;;OAIG;IACH,YAAY,IAAsB;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,YAAY,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/F,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACxG,CAAC;CACF"}

package/dist/v3/dialog.d.ts

@@ -0,0 +1,78 @@
+import { PinTanDialog } from '../session/pin-tan-dialog.js';
+import type { Approval, StartWithOrder } from '../session/protocol.js';
+import { TanMethod } from '../tan/tan-models.js';
+import { IncomingMessage3 } from './message.js';
+import type { Bpd3 } from './parameters.js';
+import type { SegmentSpec } from './syntax.js';
+/** How a message is signed: the security function of the TAN method and the customer system ID. */
+export interface Signing3 {
+    readonly securityFunction: string;
+    readonly systemId: string;
+}
+/**
+ * What a dialog needs from the session: the parameter data received so far, the segments that open a dialog, and the
+ * way to the bank. The `FinTs3Protocol` provides it, and keeps the login data and the PIN to itself.
+ */
+export interface FinTs3DialogHost {
+    /** The bank parameter data received so far, if any. */
+    readonly bankParameters: Bpd3 | undefined;
+    /** The customer system ID the bank assigned; `undefined` before the synchronization. */
+    readonly systemId: string | undefined;
+    /** Identification (HKIDN) and processing preparation (HKVVB), which open every dialog. */
+    initSegments(systemId: string, anonymous?: boolean): SegmentSpec[];
+    /**
+     * Sends `segments` as message `number` of the dialog `dialogId` and returns the bank's answer, not yet parsed.
+     *
+     * With `signing` the message is signed with the PIN and the `tan`, after `LoginGuard.check`; without, it goes out
+     * unsigned, as in an anonymous dialog.
+     */
+    post(message: {
+        dialogId: string;
+        number: number;
+        segments: readonly SegmentSpec[];
+        signing: Signing3 | undefined;
+        tan: string | undefined;
+    }): Promise<Uint8Array>;
+}
+/** One FinTS 3.0 dialog: numbered messages under the dialog ID the bank assigns in its first answer. */
+export declare class FinTs3Dialog extends PinTanDialog<IncomingMessage3, SegmentSpec> {
+    private readonly host;
+    private readonly anonymous;
+    private systemId;
+    private id;
+    private constructor();
+    static signed(host: FinTs3DialogHost, method: TanMethod, tanMedium?: string): FinTs3Dialog;
+    /** A dialog without login, which only delivers the bank parameter data. */
+    static anonymous(host: FinTs3DialogHost): FinTs3Dialog;
+    protected get bankParameters(): Bpd3 | undefined;
+    get isActive(): boolean;
+    /** The version of the HKTAN segments: that of the HITANS segment the bank describes the method in. */
+    private get tanVersion();
+    start(synchronize?: boolean): Promise<IncomingMessage3>;
+    /**
+     * Opens the dialog, asking strong authentication for `order` with a two-step method, then sends `order` in the next
+     * message.
+     */
+    startWith(order: SegmentSpec): StartWithOrder<IncomingMessage3>;
+    /**
+     * Opens the anonymous dialog; the answer carries the bank parameter data.
+     *
+     * With `announceSca` the message also carries HKTAN, the way a client that can do strong customer authentication
+     * tells the bank so, whereupon the bank may send parameter data suited to it (PIN/TAN, B.4.3.1).
+     */
+    requestBankParameters(announceSca?: boolean): Promise<IncomingMessage3>;
+    send(order: SegmentSpec): Promise<IncomingMessage3>;
+    protected sendEnd(): Promise<void>;
+    private tanRequest;
+    /**
+     * The approval a HITAN segment of process 4 asks for, answered with HKTAN process 2 (TAN) or S (status).
+     *
+     * Throws `FinTsProtocolError` for an app approval with a method of HITANS #6: the status request (process S) came with
+     * version 7, along with app approvals (PIN/TAN B.5.2).
+     */
+    protected approvalIn(response: IncomingMessage3): Approval<IncomingMessage3> | undefined;
+    private sendSegments;
+    /** The bank assigns the dialog ID in its answer to the first message. */
+    protected readDialogData(response: IncomingMessage3): void;
+}
+//# sourceMappingURL=dialog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../src/v3/dialog.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAW/C,mGAAmG;AACnG,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,cAAc,EAAE,IAAI,GAAG,SAAS,CAAC;IAE1C,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAEtC,0FAA0F;IAC1F,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,CAAC;IAEnE;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;QACjC,OAAO,EAAE,QAAQ,GAAG,SAAS,CAAC;QAC9B,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;KACzB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACzB;AAED,wGAAwG;AACxG,qBAAa,YAAa,SAAQ,YAAY,CAAC,gBAAgB,EAAE,WAAW,CAAC;IAKzE,OAAO,CAAC,QAAQ,CAAC,IAAI;IAGrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAP5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,EAAE,CAAc;IAExB,OAAO;IAUP,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY;IAI1F,2EAA2E;IAC3E,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY;IAItD,SAAS,KAAK,cAAc,IAAI,IAAI,GAAG,SAAS,CAE/C;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,sGAAsG;IACtG,OAAO,KAAK,UAAU,GAErB;IAED,KAAK,CAAC,WAAW,UAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC;IASrD;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAAC,gBAAgB,CAAC;IAW/D;;;;;OAKG;IACH,qBAAqB,CAAC,WAAW,UAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOrE,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;cAKnC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC,OAAO,CAAC,UAAU;IAIlB;;;;;OAKG;IACH,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,gBAAgB,GAAG,QAAQ,CAAC,gBAAgB,CAAC,GAAG,SAAS;IAoBxF,OAAO,CAAC,YAAY;IAgBpB,yEAAyE;IACzE,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;CAG3D"}