@coderoftime/fints 0.1.0 → 0.2.0

package/dist/v3/protocol.js

@@ -1,83 +1,35 @@
 // Internal to the package, and named after the FinTS specification. Documentation is where the meaning is not evident.
-import { requirePin } from '../core/config.js';
-import { FinTsError, FinTsTransportError, FinTsUnsupportedError } from '../core/errors.js';
-import { hasErrors } from '../core/feedback.js';
-import { camtTransactions, mt940Transactions } from '../formats/readers.js';
-import { BankConnection, checkMessageSize } from '../session/bank-connection.js';
-import { LoginGuard } from '../session/login-guard.js';
-import { offeredVersion, requireBankParameters } from '../session/parameter-data.js';
-import { balanceQuery, checkBeforeSigning, chooseTransactions, } from '../session/protocol.js';
-import { invalidArgument } from '../util/errors.js';
-import { readOptionalString } from '../util/json.js';
+import { requirePinLength } from '../core/config.js';
+import { clientClosedError } from '../core/errors.js';
 import { decodeBankText } from '../util/text.js';
-import { FinTs3Dialog } from './dialog.js';
-import { buildMessage, decodeTransport, encodeTransport, IncomingMessage3 } from './message.js';
-import { Bpd3, decodeSegments, encodeSegments, Upd3 } from './parameters.js';
-import { balanceAccount, parseBalance, parseSepaAccounts, parseTanMedia, Segments } from './segments.js';
-import { isLatin1 } from './syntax.js';
+import { BankConnection, checkMessageSize } from './bank-connection.js';
+import { buildMessage, decodeTransport, encodeTransport } from './message.js';
+import { Segments } from './segments.js';
 /** Customer ID the specification reserves for anonymous dialogs. */
 const anonymousCustomerId = '9999999999';
-/** Longest product ID (Produktbezeichnung) and product version HKVVB takes. */
-const maxProductIdLength = 25;
-const maxProductVersionLength = 5;
-function requireLatin1(text, name) {
-    // The message leaves out the value, which may be the PIN.
-    if (!isLatin1(text))
-        throw invalidArgument(`${name} contains characters FinTS 3.0 cannot send (ISO 8859-1 only)`);
-    return text;
+/** Whether `segments` are those of a dialog end, the one message a closing client still sends. */
+function isDialogEnd(segments) {
+    return segments.length === 1 && segments[0].type === 'HKEND';
 }
-function requireMaxLength(text, maxLength, name) {
-    if (text.length > maxLength)
-        throw invalidArgument(`At most ${maxLength} characters in FinTS 3.0`, name);
-}
-function requireSendable(config) {
-    requireLatin1(config.userId, 'userId');
-    requireLatin1(config.customerId, 'customerId');
-    requireLatin1(config.productId, 'productId');
-    requireLatin1(config.productVersion, 'productVersion');
-    // Cut short, the product would be one the bank does not know.
-    requireMaxLength(config.productId, maxProductIdLength, 'productId');
-    requireMaxLength(config.productVersion, maxProductVersionLength, 'productVersion');
-    return config;
-}
-/** The segments of `type` in all `pages`. */
-function all(pages, type) {
-    return pages.flatMap((p) => p.findAll(type));
-}
-/** FinTS 3.0 messages and business transactions (HBCI segment syntax, PIN/TAN security). */
+/**
+ * Builds, signs and posts FinTS 3.0 messages (HBCI segment syntax, PIN/TAN security) for the user `parameters.config`
+ * names, with the parameter data and IDs `parameters` keeps. Every message signed with the PIN takes it from the
+ * `PinGuard` (`post`), which keeps it from going out after a refused login.
+ */
 export class FinTs3Protocol {
+    parameters;
+    guard;
     config;
-    pin;
     connection;
-    loginGuard = new LoginGuard();
-    /** Customer system ID the bank assigned in the synchronization. */
-    systemId;
-    bpd;
-    upd;
-    /**
-     * Throws `TypeError` if the PIN is empty, if the PIN or login data contain characters FinTS 3.0 cannot send (ISO
-     * 8859-1 only), or the product ID or version is longer than its field in HKVVB.
-     */
-    constructor(config, pin, transport, logger) {
-        this.config = requireSendable(config);
-        this.pin = requireLatin1(requirePin(pin), 'pin');
-        this.connection = new BankConnection(config.url, transport, logger);
-    }
-    get bankParameters() {
-        return this.bpd;
-    }
-    get userParameters() {
-        return this.upd;
-    }
-    /** Dialogs cannot start without the customer system ID. */
-    get synchronization() {
-        return this.systemId === undefined ? 'required' : 'none';
-    }
-    forgetSystemId() {
-        const had = this.systemId !== undefined;
-        this.systemId = undefined;
-        return had;
-    }
+    /** Whether the client is closing, so that only dialog ends go out (`beginClose`). */
+    closing = false;
+    constructor(parameters, guard, transport, logger) {
+        this.parameters = parameters;
+        this.guard = guard;
+        this.config = parameters.config;
+        this.connection = new BankConnection(this.config.url, transport, logger);
+    }
+    /** Identification (HKIDN) and processing preparation (HKVVB), which open every dialog. */
     initSegments(systemId, anonymous = false) {
         return [
             Segments.identification({
@@ -88,18 +40,26 @@ export class FinTs3Protocol {
                 systemIdRequired: !anonymous,
             }),
             Segments.processingPreparation({
-                bpdVersion: this.bpd?.version ?? 0,
-                updVersion: anonymous ? 0 : (this.upd?.version ?? 0),
-                language: this.bpd?.dialogLanguage ?? 0,
+                bpdVersion: this.parameters.reportedBpdVersion,
+                updVersion: anonymous ? 0 : this.parameters.reportedUpdVersion,
+                language: this.parameters.bankParameters?.dialogLanguage ?? 0,
                 productId: this.config.productId,
                 productVersion: this.config.productVersion,
             }),
         ];
     }
+    /**
+     * 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, which `PinGuard.pin` hands out, and the `tan`; without, it
+     * goes out unsigned, as in an anonymous dialog.
+     */
     async post(message) {
+        if (this.closing && !isDialogEnd(message.segments))
+            throw clientClosedError();
         const signing = message.signing;
-        if (signing !== undefined)
-            checkBeforeSigning(this.loginGuard, this.pin, this.bpd);
+        // The first message of a signed dialog logs in: from here on the bank may count the PIN.
+        const login = signing !== undefined && message.number === 1;
         const outgoing = buildMessage({
             dialogId: message.dialogId,
             messageNumber: message.number,
@@ -111,150 +71,40 @@ export class FinTs3Protocol {
                     bankCode: this.config.bankCode,
                     userId: this.config.userId,
                     systemId: signing.systemId,
-                    pin: this.pin,
+                    pin: login ? this.pinForLogin() : this.guard.pin,
                     securityFunction: signing.securityFunction,
                 },
             tan: message.tan,
         });
-        checkMessageSize(outgoing.bytes.length, this.bpd?.bankInfo.maxMessageSize);
+        checkMessageSize(outgoing.bytes.length, this.parameters.bankParameters?.bankInfo.maxMessageSize);
         this.connection.log('outgoing', () => outgoing.masked);
+        if (login)
+            this.guard.loginSent();
         const bytes = decodeTransport(await this.connection.post(encodeTransport(outgoing.bytes), 'text/plain'));
         this.connection.log('incoming', () => decodeBankText(bytes));
         return bytes;
     }
-    keepParameterData(response) {
-        this.keepBankParameters(response);
-        this.upd = Upd3.fromSegments(response.segments, this.config.bankCode, this.config.countryCode) ?? this.upd;
-        this.systemId = response.find('HISYN')?.text(1) ?? this.systemId;
-    }
-    keepBankParameters(response) {
-        this.bpd = Bpd3.fromSegments(response.segments, this.config.bankCode) ?? this.bpd;
-    }
-    /** Keeps the bank parameter data of an anonymous dialog, and nothing that belongs to a user. */
-    async fetchBankParametersAnonymously() {
-        const response = await this.requestBankParametersAnonymously();
-        this.keepBankParameters(response);
-        return response;
-    }
     /**
-     * Asks for the bank parameter data in an anonymous dialog that announces strong customer authentication; a bank that
-     * rejects the announcement, with a return code or by failing on it, is asked again without it.
+     * The PIN to sign a login with, the first message of a dialog.
      *
-     * A timeout or a broken connection is not a reason to ask again: it would only double the wait.
+     * Throws instead where the guard holds the PIN back (`PinGuard.pin`), or if the bank parameters rule out the PIN's
+     * length: the bank would count such a PIN as a failed attempt. The later messages of a dialog, its end included, take
+     * the PIN the bank has accepted, whatever the parameter data it delivered since say.
      */
-    async requestBankParametersAnonymously() {
-        let announced;
-        try {
-            announced = await this.anonymousDialog(true);
-        }
-        catch (error) {
-            if (error instanceof FinTsTransportError && error.statusCode === undefined)
-                throw error;
-            if (!(error instanceof FinTsError))
-                throw error;
-            return this.anonymousDialog(false);
-        }
-        if (!hasErrors(announced.feedback) || announced.find('HIBPA') !== undefined)
-            return announced;
-        return this.anonymousDialog(false);
-    }
-    async anonymousDialog(announceSca) {
-        const dialog = FinTs3Dialog.anonymous(this);
-        try {
-            return await dialog.requestBankParameters(announceSca);
-        }
-        finally {
-            await dialog.end();
-        }
-    }
-    newDialog(method, tanMedium) {
-        return FinTs3Dialog.signed(this, method, tanMedium);
-    }
-    combine(first, second) {
-        return IncomingMessage3.combine(first, second);
-    }
-    // --- Business transactions ---
-    version(transaction, implemented, options = {}) {
-        return offeredVersion(this.bpd, this.upd, transaction, new Set(implemented), options);
-    }
-    tanMedia() {
-        const version = this.version('HKTAB', [4, 5]);
-        if (version === undefined)
-            return undefined;
-        return {
-            order: () => Segments.tanMedia(version),
-            read: (pages) => all(pages, 'HITAB').flatMap(parseTanMedia),
-        };
-    }
-    sepaAccounts() {
-        const version = this.version('HKSPA', [1, 2, 3], { requiresEntry: true });
-        if (version === undefined)
-            return undefined;
-        return {
-            order: (continuation) => Segments.sepaAccounts(version, continuation),
-            read: (pages) => all(pages, 'HISPA').flatMap((s) => parseSepaAccounts(s, this.config.countryCode, this.config.bankCode)),
-        };
+    pinForLogin() {
+        const pin = this.guard.pin;
+        const length = this.parameters.bankParameters?.pinTan.pinLength;
+        requirePinLength(pin, length?.min, length?.max);
+        return pin;
     }
-    balance(account) {
-        const version = this.version('HKSAL', [6, 7, 8], { account });
-        if (version === undefined) {
-            throw new FinTsUnsupportedError('The bank reports no balance (HKSAL) for this account');
-        }
-        return balanceQuery(account, {
-            order: (continuation) => Segments.balance(version, account, continuation),
-            records: (pages) => all(pages, 'HISAL'),
-            accountOf: balanceAccount,
-            read: parseBalance,
-        });
-    }
-    transactions(account, format, from, to) {
-        const request = chooseTransactions(format, account, this.upd, {
-            camt: { name: 'HKCAZ', version: this.version('HKCAZ', [1], { account }) },
-            camtFormats: requireBankParameters(this.bpd).camtFormats,
-            mt940: { name: 'HKKAZ', version: this.version('HKKAZ', [6, 7], { account }) },
-        });
-        const version = request.version;
-        if (request.camt) {
-            return {
-                order: (continuation) => Segments.transactionsCamt(version, account, request.camtFormats, { from, to, continuation }),
-                // The third element group holds the booked documents, the fourth element the pending one.
-                read: (pages) => camtTransactions(all(pages, 'HICAZ').flatMap((s) => s
-                    .group(3)
-                    .filter((d) => !d.isEmpty)
-                    .map((d) => d.bytes)), all(pages, 'HICAZ')
-                    .map((s) => s.binary(4))
-                    .filter((d) => d !== undefined)),
-            };
-        }
-        return {
-            order: (continuation) => Segments.transactionsMt940(version, account, { from, to, continuation }),
-            // The first element holds the booked transactions, the second the pending ones.
-            read: (pages) => mt940Transactions(all(pages, 'HIKAZ')
-                .map((s) => s.binary(1))
-                .filter((d) => d !== undefined), all(pages, 'HIKAZ')
-                .map((s) => s.binary(2))
-                .filter((d) => d !== undefined), request.currency),
-        };
-    }
-    // --- Saved state ---
-    saveState() {
-        return {
-            systemId: this.systemId ?? null,
-            bpd: this.bpd === undefined ? null : encodeSegments(this.bpd.segments),
-            upd: this.upd === undefined ? null : encodeSegments(this.upd.segments),
-        };
-    }
-    restoreState(saved) {
-        const bpd = readOptionalString(saved, 'bpd');
-        const upd = readOptionalString(saved, 'upd');
-        const restoredSystemId = readOptionalString(saved, 'systemId');
-        const restoredBpd = bpd === undefined ? undefined : Bpd3.fromSegments(decodeSegments(bpd), this.config.bankCode);
-        const restoredUpd = upd === undefined
-            ? undefined
-            : Upd3.fromSegments(decodeSegments(upd), this.config.bankCode, this.config.countryCode);
-        this.systemId = restoredSystemId;
-        this.bpd = restoredBpd;
-        this.upd = restoredUpd;
+    /**
+     * Aborts the request on its way, and sends nothing but dialog ends from now on: any other message fails with
+     * `FinTsStateError` before it goes out, so that a call under way stops at its next one. The client calls it as soon as
+     * it is closed, and `close` once it has ended its dialog.
+     */
+    beginClose() {
+        this.closing = true;
+        this.connection.abortRequests();
     }
     close() {
         this.connection.close();

package/dist/v3/protocol.js.map

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

package/dist/v3/queries.d.ts

@@ -0,0 +1,51 @@
+import type { Account } from '../core/account.js';
+import type { Balance } from '../core/balance.js';
+import type { FinTsFeedback } from '../core/feedback.js';
+import type { Transaction, TransactionFormat } from '../core/transaction.js';
+import type { TanMedium } from '../tan/tan-models.js';
+import type { IncomingMessage3 } from './message.js';
+import type { ParameterStore } from './parameter-store.js';
+import type { Segment, SegmentSpec } from './syntax.js';
+/**
+ * A business transaction: the order to send for each page, and how to read all pages the bank sent.
+ *
+ * Where the bank does not offer the transaction, the builders of the lookups the session makes for itself, of the TAN
+ * media and the SEPA accounts, return `undefined`, and those of the app's queries, of a balance and of transactions,
+ * throw `FinTsUnsupportedError`.
+ */
+export interface Query<T> {
+    /** The order for the page at `continuation`; `undefined` for the first page. */
+    readonly order: (continuation: string | undefined) => SegmentSpec;
+    /** Reads the result; throws `FormatError` for malformed data. */
+    readonly read: (pages: readonly IncomingMessage3[]) => T;
+}
+/** Lists the TAN media, and keeps the names as the bank sent them in `parameters`; `undefined` if the bank does not. */
+export declare function tanMediaQuery(parameters: ParameterStore): Query<TanMedium[]> | undefined;
+/** Lists IBAN and BIC of the accounts; `undefined` if the bank does not offer it. */
+export declare function sepaAccountsQuery(parameters: ParameterStore): Query<Account[]> | undefined;
+/**
+ * The balance (HISAL) of `account` in `records`: the one whose account matches. A single record must match as well,
+ * though the query asked for this one account only: it names the account it is for.
+ *
+ * Throws `FinTsBankError` with the bank's `feedback` if there is none, and `FinTsProtocolError` if none matches.
+ *
+ * @internal Exported for the tests.
+ */
+export declare function balanceRecord(records: readonly Segment[], account: Account, feedback: readonly FinTsFeedback[]): Segment;
+/**
+ * The balance of `account`, which the session has taken as the bank knows it, with the transactions the bank permits
+ * for it (`SepaAccounts.complete`); throws `FinTsUnsupportedError` if the bank does not report balances.
+ */
+export declare function balanceQuery(parameters: ParameterStore, account: Account): Query<Balance>;
+/**
+ * The transactions of `account` in `format`, from the day of `from` to that of `to`. The session has taken `account` as
+ * the bank knows it, with the transactions the bank permits for it and its currency (`SepaAccounts.complete`).
+ *
+ * The client reads camt.052 only, so camt counts as offered only where the bank offers a camt.052 format. With `auto`
+ * the client takes camt where the bank offers it, unless the user parameter data list only MT940 transactions for the
+ * account.
+ *
+ * Throws `FinTsUnsupportedError` if the bank does not offer the chosen format for the account.
+ */
+export declare function transactionsQuery(parameters: ParameterStore, account: Account, format: TransactionFormat, from: Date | undefined, to: Date | undefined): Query<Transaction[]>;
+//# sourceMappingURL=queries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/v3/queries.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,KAAK,WAAW,CAAC;IAElE,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,KAAK,CAAC,CAAC;CAC1D;AAsBD,wHAAwH;AACxH,wBAAgB,aAAa,CAAC,UAAU,EAAE,cAAc,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,GAAG,SAAS,CAYxF;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,cAAc,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,SAAS,CAQ1F;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,SAAS,aAAa,EAAE,GACjC,OAAO,CAOT;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAiBzF;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,IAAI,GAAG,SAAS,EACtB,EAAE,EAAE,IAAI,GAAG,SAAS,GACnB,KAAK,CAAC,WAAW,EAAE,CAAC,CAqDtB"}

package/dist/v3/queries.js

@@ -0,0 +1,120 @@
+// Internal to the package, and named after the FinTS specification. Documentation is where the meaning is not evident.
+import { FinTsBankError, FinTsProtocolError, FinTsUnsupportedError } from '../core/errors.js';
+import { camtTransactions, mt940Transactions } from '../formats/readers.js';
+import { lists, offeredVersion, requireBankParameters } from './parameters.js';
+import { balanceAccount, camtAccount, parseBalance, parseSepaAccounts, parseTanMedia, Segments } from './segments.js';
+/** The segments of `type` in all `pages`. */
+function all(pages, type) {
+    return pages.flatMap((p) => p.findAll(type));
+}
+function version(parameters, transaction, implemented, options = {}) {
+    return offeredVersion(parameters.bankParameters, parameters.userParameters, transaction, new Set(implemented), options);
+}
+/** Lists the TAN media, and keeps the names as the bank sent them in `parameters`; `undefined` if the bank does not. */
+export function tanMediaQuery(parameters) {
+    const offered = version(parameters, 'HKTAB', [4, 5]);
+    if (offered === undefined)
+        return undefined;
+    return {
+        order: () => Segments.tanMedia(offered),
+        read: (pages) => {
+            const names = new Map();
+            const media = all(pages, 'HITAB').flatMap((s) => parseTanMedia(s, names));
+            parameters.keepTanMediumNames(names);
+            return media;
+        },
+    };
+}
+/** Lists IBAN and BIC of the accounts; `undefined` if the bank does not offer it. */
+export function sepaAccountsQuery(parameters) {
+    const offered = version(parameters, 'HKSPA', [1, 2, 3], { requiresEntry: true });
+    if (offered === undefined)
+        return undefined;
+    const { countryCode, bankCode } = parameters.config;
+    return {
+        order: (continuation) => Segments.sepaAccounts(offered, continuation),
+        read: (pages) => all(pages, 'HISPA').flatMap((s) => parseSepaAccounts(s, countryCode, bankCode)),
+    };
+}
+/**
+ * The balance (HISAL) of `account` in `records`: the one whose account matches. A single record must match as well,
+ * though the query asked for this one account only: it names the account it is for.
+ *
+ * Throws `FinTsBankError` with the bank's `feedback` if there is none, and `FinTsProtocolError` if none matches.
+ *
+ * @internal Exported for the tests.
+ */
+export function balanceRecord(records, account, feedback) {
+    if (records.length === 0)
+        throw new FinTsBankError(feedback, 'No balance returned');
+    const match = records.find((record) => balanceAccount(record).matches(account));
+    if (match === undefined) {
+        throw new FinTsProtocolError('The bank returned balances, but none for the requested account');
+    }
+    return match;
+}
+/**
+ * The balance of `account`, which the session has taken as the bank knows it, with the transactions the bank permits
+ * for it (`SepaAccounts.complete`); throws `FinTsUnsupportedError` if the bank does not report balances.
+ */
+export function balanceQuery(parameters, account) {
+    const offered = version(parameters, 'HKSAL', [6, 7, 8], { account });
+    if (offered === undefined) {
+        throw new FinTsUnsupportedError('The bank reports no balance (HKSAL) for this account');
+    }
+    return {
+        order: (continuation) => Segments.balance(offered, account, continuation),
+        read: (pages) => parseBalance(balanceRecord(all(pages, 'HISAL'), account, pages.flatMap((p) => p.feedback)), account),
+    };
+}
+/**
+ * The transactions of `account` in `format`, from the day of `from` to that of `to`. The session has taken `account` as
+ * the bank knows it, with the transactions the bank permits for it and its currency (`SepaAccounts.complete`).
+ *
+ * The client reads camt.052 only, so camt counts as offered only where the bank offers a camt.052 format. With `auto`
+ * the client takes camt where the bank offers it, unless the user parameter data list only MT940 transactions for the
+ * account.
+ *
+ * Throws `FinTsUnsupportedError` if the bank does not offer the chosen format for the account.
+ */
+export function transactionsQuery(parameters, account, format, from, to) {
+    const camtFormats = requireBankParameters(parameters.bankParameters).camtFormats.filter((f) => f.includes('camt.052'));
+    const camtVersion = camtFormats.length === 0 ? undefined : version(parameters, 'HKCAZ', [1], { account });
+    const camt = format === 'camt' ||
+        (format === 'auto' && camtVersion !== undefined && (lists(account, 'HKCAZ') || !lists(account, 'HKKAZ')));
+    const offered = camt ? camtVersion : version(parameters, 'HKKAZ', [6, 7], { account });
+    if (offered === undefined) {
+        throw new FinTsUnsupportedError(`The bank offers no ${camt ? 'camt ' : ''}transactions (${camt ? 'HKCAZ' : 'HKKAZ'}) for this account`);
+    }
+    if (camt) {
+        return {
+            order: (continuation) => Segments.transactionsCamt(offered, account, camtFormats, { from, to, continuation }),
+            // The first element names the account, the third element group holds the booked documents, the fourth
+            // element the pending one.
+            read: (pages) => {
+                const segments = all(pages, 'HICAZ');
+                if (!segments.every((s) => camtAccount(s).matches(account))) {
+                    throw new FinTsProtocolError('The bank returned the transactions of another account than the one asked for');
+                }
+                return camtTransactions(segments.flatMap((s) => s
+                    .group(3)
+                    .filter((d) => !d.isEmpty)
+                    .map((d) => d.bytes)), segments.map((s) => s.binary(4)).filter((d) => d !== undefined));
+            },
+        };
+    }
+    return {
+        order: (continuation) => Segments.transactionsMt940(offered, account, { from, to, continuation }),
+        // The first element holds the booked transactions, the second the pending ones. Unlike HICAZ, HIKAZ names no
+        // account, and banks write the account line of a statement (`:25:`) in many ways, so it is not compared with
+        // `account`: a strict comparison would fail every query of such a bank.
+        read: (pages) => mt940Transactions(all(pages, 'HIKAZ')
+            .map((s) => s.binary(1))
+            .filter((d) => d !== undefined), all(pages, 'HIKAZ')
+            .map((s) => s.binary(2))
+            .filter((d) => d !== undefined), 
+        // The currency of statements that state none.
+        account.currency),
+    };
+}
+//# sourceMappingURL=queries.js.map

package/dist/v3/queries.js.map

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

package/dist/v3/segments.d.ts

@@ -1,14 +1,18 @@
 import { Account } from '../core/account.js';
 import { Balance } from '../core/balance.js';
 import { TanMedium } from '../tan/tan-models.js';
-import { type Segment, SegmentSpec, type SegmentValue } from './syntax.js';
-/** Bank identification (KIK): country code and bank code. */
-export declare function bankIdentification(countryCode: string, bankCode: string): SegmentValue;
-/** National account (KTV): account number, sub-account and bank identification. */
-export declare function nationalAccount(a: Account): SegmentValue[];
-/** International account (KTI): IBAN, BIC, then the national account. */
-export declare function internationalAccount(a: Account): SegmentValue[];
-/** Builders for the request segments the client sends. */
+import { type Segment, SegmentSpec } from './syntax.js';
+/**
+ * The filler the specification names for a reference that does not exist.
+ *
+ * The bank puts it into a dummy answer when no approval is needed. The client sends it as the TAN medium name in the
+ * dialog that looks up the TAN media, before it knows a medium; the bank ignores it there (PIN/TAN B.4.3.1.3).
+ */
+export declare const noReference = "noref";
+/**
+ * Builders for the request segments the client sends. Values the bank issued, such as the customer system ID, the TAN
+ * order reference and the position to continue at, go back as `Verbatim`.
+ */
 export declare const Segments: Readonly<{
     /** HKIDN: who is logging in, from which customer system. */
     identification(parts: {
@@ -29,7 +33,10 @@ export declare const Segments: Readonly<{
     /** HKSYN: requests a new customer system ID. */
     synchronization(): SegmentSpec;
     dialogEnd(dialogId: string): SegmentSpec;
-    /** HKTAN process 4: asks for strong customer authentication of the `segmentType` sent in the same message. */
+    /**
+     * HKTAN process 4: asks for strong customer authentication of the `segmentType` sent in the same message, with the TAN
+     * medium `mediumName`, as the bank sent it.
+     */
     tanProcess4(version: number, segmentType: string, mediumName?: string): SegmentSpec;
     /** HKTAN process 2: submits the TAN (carried in the signature) for the order with `reference`. */
     tanProcess2(version: number, reference: string): SegmentSpec;
@@ -58,6 +65,7 @@ export declare const Segments: Readonly<{
 export declare class TanResponse {
     /** The TAN process the segment answers: `4` asks for an approval, `S` answers a status request. */
     readonly process: string | undefined;
+    /** The order reference, as `Segment.verbatim` reads it, to send back byte for byte. */
     readonly reference: string | undefined;
     readonly challenge: string | undefined;
     readonly hhdUc: Uint8Array | undefined;
@@ -65,7 +73,9 @@ export declare class TanResponse {
     readonly mediumName: string | undefined;
     constructor(
     /** The TAN process the segment answers: `4` asks for an approval, `S` answers a status request. */
-    process: string | undefined, reference: string | undefined, challenge: string | undefined, hhdUc: Uint8Array | undefined, validUntil: Date | undefined, mediumName: string | undefined);
+    process: string | undefined, 
+    /** The order reference, as `Segment.verbatim` reads it, to send back byte for byte. */
+    reference: string | undefined, challenge: string | undefined, hhdUc: Uint8Array | undefined, validUntil: Date | undefined, mediumName: string | undefined);
     static parse(s: Segment): TanResponse;
     /** Whether the bank needs no approval although it answered with a TAN segment. */
     get isDummy(): boolean;
@@ -79,11 +89,18 @@ export declare function parseBalance(s: Segment, account: Account): Balance;
  * The account a balance (HISAL) belongs to: international (IBAN, BIC, then national) from version 7, national before.
  */
 export declare function balanceAccount(s: Segment): Account;
+/** The account camt transactions (HICAZ) belong to, which the first element names (international). */
+export declare function camtAccount(s: Segment): Account;
 /**
  * Parses the SEPA account list (HISPA), one account per data element. An account the bank marks as no payment account
  * ("Kontoverwendung SEPA" N) is left out: it has no SEPA connection.
  */
 export declare function parseSepaAccounts(s: Segment, defaultCountry: string, defaultBank: string): Account[];
-/** Parses the TAN media list (HITAB versions 4 and 5, PIN/TAN "TAN-Medium-Liste"). */
-export declare function parseTanMedia(s: Segment): TanMedium[];
+/**
+ * Parses the TAN media list (HITAB versions 4 and 5, PIN/TAN "TAN-Medium-Liste").
+ *
+ * Each name whose text is not what `Segment.verbatim` reads, such as a name in UTF-8, goes into `namesAsSent`, keyed
+ * by its text: it has to go back as the bank sent it, which its text does not tell where it fits ISO 8859-1.
+ */
+export declare function parseTanMedia(s: Segment, namesAsSent?: Map<string, string>): TanMedium[];
 //# sourceMappingURL=segments.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"segments.d.ts","sourceRoot":"","sources":["../../src/v3/segments.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAqB,MAAM,sBAAsB,CAAC;AAGpE,OAAO,EAAE,KAAK,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3E,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAEtF;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,YAAY,EAAE,CAE1D;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,YAAY,EAAE,CAE/D;AAWD,0DAA0D;AAC1D,eAAO,MAAM,QAAQ;IACnB,4DAA4D;0BACtC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,gBAAgB,EAAE,OAAO,CAAC;KAC3B,GAAG,WAAW;IASf,2GAA2G;iCAC9E;QAC3B,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;KACxB,GAAG,WAAW;IAUf,gDAAgD;uBAC7B,WAAW;wBAIV,MAAM,GAAG,WAAW;IAIxC,8GAA8G;yBACzF,MAAM,eAAe,MAAM,eAAe,MAAM,GAAG,WAAW;IAInF,kGAAkG;yBAC7E,MAAM,aAAa,MAAM,GAAG,WAAW;IAI5D,gGAAgG;8BACtE,MAAM,aAAa,MAAM,GAAG,WAAW;IAIjE,+DAA+D;qBAC9C,MAAM,WAAW,OAAO,iBAAiB,MAAM,GAAG,WAAW;IAS9E,gDAAgD;+BAErC,MAAM,WACN,OAAO,UACR;QAAE,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;QAAC,EAAE,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAC5F,WAAW;IAWd,mEAAmE;8BAExD,MAAM,WACN,OAAO,WACP,SAAS,MAAM,EAAE,UAClB;QAAE,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;QAAC,EAAE,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAC5F,WAAW;IAYd,2CAA2C;0BACrB,MAAM,iBAAiB,MAAM,GAAG,WAAW;IAIjE,2CAA2C;sBACzB,MAAM,GAAG,WAAW;EAGtC,CAAC;AAKH,0CAA0C;AAC1C,qBAAa,WAAW;IAEpB,mGAAmG;IACnG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS;IACtC,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS;IACtC,QAAQ,CAAC,UAAU,EAAE,IAAI,GAAG,SAAS;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS;;IANvC,mGAAmG;IAC1F,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,UAAU,EAAE,IAAI,GAAG,SAAS,EAC5B,UAAU,EAAE,MAAM,GAAG,SAAS;IAGzC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,WAAW;IAWrC,kFAAkF;IAClF,IAAI,OAAO,IAAI,OAAO,CAErB;CACF;AA0BD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CA6BlE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAYlD;AAaD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,EAAE,CAiBpG;AAQD,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,SAAS,EAAE,CAgCrD"}
+{"version":3,"file":"segments.d.ts","sourceRoot":"","sources":["../../src/v3/segments.ts"],"names":[],"mappings":"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"}