@coderoftime/fints 0.1.0 → 0.2.0

package/dist/session/parameter-data.d.ts

@@ -1,83 +0,0 @@
-import type { Account } from '../core/account.js';
-import type { Balance } from '../core/balance.js';
-import type { BankInfo } from '../core/bank-info.js';
-import type { TanMethod } from '../tan/tan-models.js';
-/** `parameters`, or `FinTsProtocolError` if the bank has not sent its parameter data yet. */
-export declare function requireBankParameters<T extends BankParameters>(parameters: T | undefined): T;
-/** The highest of the `offered` versions of a business transaction that the client `implemented`. */
-export declare function highestCommonVersion(offered: Iterable<number> | undefined, implemented: ReadonlySet<number>): number | undefined;
-/** Bank parameter data (BPD): what the bank offers. */
-export interface BankParameters {
-    /** The version of the parameter data, which the client reports back so that the bank sends newer ones only. */
-    readonly version: number;
-    /** General information about the bank. */
-    readonly bankInfo: BankInfo;
-    /** Two-step TAN methods the bank offers and the client can run. */
-    readonly tanMethods: readonly TanMethod[];
-    /** Security functions of the two-step methods the bank offers in a form the client cannot run. */
-    readonly unsupportedTanMethods: readonly string[];
-    /** The shortest and longest PIN the bank takes, as far as it says. */
-    readonly pinLength: {
-        readonly min: number | undefined;
-        readonly max: number | undefined;
-    };
-    /** Whether the bank allows `transaction` with PIN/TAN at all (HIPINS); `true` where it does not say. */
-    allowsWithPinTan(transaction: string): boolean;
-    /** The highest version of `transaction` that the bank offers and the client `implemented`. */
-    bestVersion(transaction: string, implemented: ReadonlySet<number>): number | undefined;
-}
-/** User parameter data (UPD): what the user may do. */
-export interface UserParameters {
-    /** The version of the parameter data, which the client reports back so that the bank sends newer ones only. */
-    readonly version: number;
-    /** The accounts the user may access. */
-    readonly accounts: readonly Account[];
-    /** Security functions of the TAN methods the user may use; empty when the UPD do not say. */
-    readonly allowedTanMethods: readonly string[];
-    /**
-     * Whether the lists of permitted transactions are complete: the bank permits nothing they leave out ("UPD-Verwendung"
-     * 0).
-     */
-    readonly listsAllTransactions: boolean;
-    /** The transactions any entry lists as permitted, with or without an account. */
-    readonly listedTransactions: ReadonlySet<string>;
-    /**
-     * The balance of `account` the user parameter data carry, where it holds all a balance query would deliver, so that
-     * the client asks for none (Formals E.3.1, F.3.2); `undefined` otherwise.
-     */
-    completeBalance(account: Account): Balance | undefined;
-}
-/**
- * The version of `transaction` to send, for `account` where it concerns one: the highest the bank offers and the client
- * `implemented`. `undefined` where there is none, or the parameter data do not permit the transaction
- * (`permitsTransaction`).
- */
-export declare function offeredVersion(bpd: BankParameters | undefined, upd: UserParameters | undefined, transaction: string, implemented: ReadonlySet<number>, options?: {
-    account?: Account;
-    requiresEntry?: boolean;
-}): number | undefined;
-/**
- * Whether the parameter data let the user send `transaction`, for `account` where it concerns one: the bank allows it
- * with PIN/TAN, and the user parameter data permit it (Formals E.1, F.3.4; PIN/TAN B.1, B.8.1).
- *
- * - A known account permits what it lists, and anything else only where the lists are incomplete ("UPD-Verwendung" 1).
- *   An unknown account permits anything.
- * - A transaction without account, such as the TAN media list, is permitted where some entry lists it or the lists are
- *   incomplete.
- * - One that `requiresEntry`, the SEPA account list, must be listed even where the lists are incomplete (Formals F.3.4),
- *   unless they list nothing at all, which tells nothing.
- */
-export declare function permitsTransaction(bpd: BankParameters | undefined, upd: UserParameters | undefined, transaction: string, options?: {
-    account?: Account;
-    requiresEntry?: boolean;
-}): boolean;
-/** Whether the bank lists `transaction`, such as `HKCAZ`, as permitted for `account`. */
-export declare function lists(account: Account, transaction: string): boolean;
-/**
- * Whether the bank may permit `transaction` on `account`: it lists it, or its list is not complete
- * (`Account.allowedTransactionsComplete`), so that only the bank can tell.
- */
-export declare function allows(account: Account, transaction: string): boolean;
-/** The account of the user parameter data `upd` that matches `account`; `account` itself if they do not know it. */
-export declare function knownAccount(upd: UserParameters | undefined, account: Account): Account;
-//# sourceMappingURL=parameter-data.d.ts.map

package/dist/session/parameter-data.d.ts.map

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

package/dist/session/parameter-data.js

@@ -1,68 +0,0 @@
-import { FinTsProtocolError } from '../core/errors.js';
-/** `parameters`, or `FinTsProtocolError` if the bank has not sent its parameter data yet. */
-export function requireBankParameters(parameters) {
-    if (parameters === undefined)
-        throw new FinTsProtocolError('No bank parameter data available');
-    return parameters;
-}
-/** The highest of the `offered` versions of a business transaction that the client `implemented`. */
-export function highestCommonVersion(offered, implemented) {
-    let best;
-    for (const version of offered ?? []) {
-        if (implemented.has(version) && (best === undefined || version > best))
-            best = version;
-    }
-    return best;
-}
-/**
- * The version of `transaction` to send, for `account` where it concerns one: the highest the bank offers and the client
- * `implemented`. `undefined` where there is none, or the parameter data do not permit the transaction
- * (`permitsTransaction`).
- */
-export function offeredVersion(bpd, upd, transaction, implemented, options = {}) {
-    return permitsTransaction(bpd, upd, transaction, options) ? bpd?.bestVersion(transaction, implemented) : undefined;
-}
-/**
- * Whether the parameter data let the user send `transaction`, for `account` where it concerns one: the bank allows it
- * with PIN/TAN, and the user parameter data permit it (Formals E.1, F.3.4; PIN/TAN B.1, B.8.1).
- *
- * - A known account permits what it lists, and anything else only where the lists are incomplete ("UPD-Verwendung" 1).
- *   An unknown account permits anything.
- * - A transaction without account, such as the TAN media list, is permitted where some entry lists it or the lists are
- *   incomplete.
- * - One that `requiresEntry`, the SEPA account list, must be listed even where the lists are incomplete (Formals F.3.4),
- *   unless they list nothing at all, which tells nothing.
- */
-export function permitsTransaction(bpd, upd, transaction, options = {}) {
-    if (bpd !== undefined && !bpd.allowsWithPinTan(transaction))
-        return false;
-    if (upd === undefined)
-        return true;
-    if (options.account !== undefined)
-        return allows(knownAccount(upd, options.account), transaction);
-    const listed = upd.listedTransactions;
-    for (const t of listed)
-        if (names(t, transaction))
-            return true;
-    return !upd.listsAllTransactions && (!(options.requiresEntry ?? false) || listed.size === 0);
-}
-/** Whether the `listed` name of a transaction names `transaction`, also in a versioned form such as `AcctBal_2`. */
-function names(listed, transaction) {
-    return listed === transaction || listed.startsWith(`${transaction}_`);
-}
-/** Whether the bank lists `transaction`, such as `HKCAZ`, as permitted for `account`. */
-export function lists(account, transaction) {
-    return account.allowedTransactions.some((t) => names(t, transaction));
-}
-/**
- * Whether the bank may permit `transaction` on `account`: it lists it, or its list is not complete
- * (`Account.allowedTransactionsComplete`), so that only the bank can tell.
- */
-export function allows(account, transaction) {
-    return lists(account, transaction) || !account.allowedTransactionsComplete;
-}
-/** The account of the user parameter data `upd` that matches `account`; `account` itself if they do not know it. */
-export function knownAccount(upd, account) {
-    return upd?.accounts.find((a) => account.matches(a)) ?? account;
-}
-//# sourceMappingURL=parameter-data.js.map

package/dist/session/parameter-data.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"parameter-data.js","sourceRoot":"","sources":["../../src/session/parameter-data.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,6FAA6F;AAC7F,MAAM,UAAU,qBAAqB,CAA2B,UAAyB;IACvF,IAAI,UAAU,KAAK,SAAS;QAAE,MAAM,IAAI,kBAAkB,CAAC,kCAAkC,CAAC,CAAC;IAC/F,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,oBAAoB,CAClC,OAAqC,EACrC,WAAgC;IAEhC,IAAI,IAAwB,CAAC;IAC7B,KAAK,MAAM,OAAO,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC;QACpC,IAAI,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,GAAG,IAAI,CAAC;YAAE,IAAI,GAAG,OAAO,CAAC;IACzF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAqDD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,GAA+B,EAC/B,GAA+B,EAC/B,WAAmB,EACnB,WAAgC,EAChC,UAA0D,EAAE;IAE5D,OAAO,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAA+B,EAC/B,GAA+B,EAC/B,WAAmB,EACnB,UAA0D,EAAE;IAE5D,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1E,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC;IAClG,MAAM,MAAM,GAAG,GAAG,CAAC,kBAAkB,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,MAAM;QAAE,IAAI,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC;YAAE,OAAO,IAAI,CAAC;IAC/D,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;AAC/F,CAAC;AAED,oHAAoH;AACpH,SAAS,KAAK,CAAC,MAAc,EAAE,WAAmB;IAChD,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,WAAW,GAAG,CAAC,CAAC;AACxE,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,KAAK,CAAC,OAAgB,EAAE,WAAmB;IACzD,OAAO,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,OAAgB,EAAE,WAAmB;IAC1D,OAAO,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC;AAC7E,CAAC;AAED,oHAAoH;AACpH,MAAM,UAAU,YAAY,CAAC,GAA+B,EAAE,OAAgB;IAC5E,OAAO,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;AAClE,CAAC"}

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

@@ -1,54 +0,0 @@
-import type { Account } from '../core/account.js';
-import type { Balance } from '../core/balance.js';
-import type { BankInfo } from '../core/bank-info.js';
-import type { FinTsClient, FinTsClientOptions, MessageLogger, TransactionQuery } from '../core/client.js';
-import type { Transaction } from '../core/transaction.js';
-import type { TanMedium, TanMethod } from '../tan/tan-models.js';
-import type { BankResponse, PinTanProtocol } from './protocol.js';
-/**
- * PIN/TAN session logic; the `PinTanProtocol` builds and reads the messages.
- *
- * A call such as `getBalance` runs through these parts:
- * 1. `DialogRunner.open` reuses the session's dialog or logs in, through `SessionSetup.remedied`, which logs in once
- *    more for each refusal it can take care of.
- * 2. `SessionSetup.prepare` first settles what is open: the bank parameter data, the synchronization, and through
- *    `TanSelection` the TAN method and medium.
- * 3. `ResponseHandler.startDialog` sends the login and completes the strong authentication the bank asks for, a TAN or
- *    an app approval (`AppApprovalWait`).
- * 4. `DialogRunner.query` sends the order in that dialog, completes its approval the same way, and fetches all pages.
- *
- * `SepaAccounts` completes IBAN and BIC, and `UserPrompts` is everything the app is told or asked. The protocol's
- * `LoginGuard` decides which bank errors refuse the login, and keeps the PIN from going out after one.
- */
-export declare abstract class PinTanClient<R extends BankResponse, O> implements FinTsClient {
-    private readonly prompts;
-    private readonly protocol;
-    private readonly sessionState;
-    private readonly tans;
-    private readonly setup;
-    private readonly dialogs;
-    private readonly sepa;
-    private readonly queue;
-    private closed;
-    /** The call running now, which a call from inside its callbacks would wait for. */
-    private runningCall;
-    /**
-     * A client of the protocol `createProtocol` builds around the logger it is given (`UserPrompts.logger`), with the
-     * session restored from `FinTsClientOptions.state` where it was saved for this user and bank.
-     */
-    protected constructor(options: FinTsClientOptions, createProtocol: (logger: MessageLogger | undefined) => PinTanProtocol<R, O>);
-    get state(): string;
-    get selectedTanMethod(): string | undefined;
-    get selectedTanMedium(): string | undefined;
-    selectTanMethod(securityFunction: string, tanMedium?: string): Promise<void>;
-    getBankInfo(): Promise<BankInfo>;
-    getTanMethods(): Promise<TanMethod[]>;
-    getTanMedia(): Promise<TanMedium[]>;
-    getAccounts(): Promise<Account[]>;
-    getBalance(account: Account): Promise<Balance>;
-    getTransactions(account: Account, query?: TransactionQuery): Promise<Transaction[]>;
-    close(): Promise<void>;
-    private closeNow;
-    private serialized;
-}
-//# sourceMappingURL=pin-tan-client.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"pin-tan-client.d.ts","sourceRoot":"","sources":["../../src/session/pin-tan-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAMjE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAWlE;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,YAAY,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,CAAE,YAAW,WAAW;IAClF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,MAAM,CAA4B;IAE1C,mFAAmF;IACnF,OAAO,CAAC,WAAW,CAAqB;IAExC;;;OAGG;IACH,SAAS,aACP,OAAO,EAAE,kBAAkB,EAC3B,cAAc,EAAE,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,KAAK,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;IAa7E,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAE1C;IAED,IAAI,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAE1C;IAED,eAAe,CAAC,gBAAgB,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5E,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;IAIhC,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIrC,WAAW,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAcnC,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIjC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAa9C,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,GAAE,gBAAqB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAmBvF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,UAAU;CAmBnB"}

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

@@ -1,153 +0,0 @@
-import { FinTsStateError, FinTsUnsupportedError } from '../core/errors.js';
-import { SerialExecutor } from '../util/async.js';
-import { CallContext } from '../util/call-context.js';
-import { calendarDay, notAfterToday } from '../util/dates.js';
-import { invalidArgument } from '../util/errors.js';
-import { DialogRunner } from './dialog-runner.js';
-import { ResponseHandler } from './response-handler.js';
-import { SepaAccounts } from './sepa-accounts.js';
-import { SessionSetup } from './session-setup.js';
-import { restoreSession, saveSession } from './session-state.js';
-import { TanSelection } from './tan-selection.js';
-import { UserPrompts } from './user-prompts.js';
-/** The call running now, by the client it belongs to, so that a call from inside its callbacks is recognized. */
-const runningCalls = new CallContext();
-/**
- * PIN/TAN session logic; the `PinTanProtocol` builds and reads the messages.
- *
- * A call such as `getBalance` runs through these parts:
- * 1. `DialogRunner.open` reuses the session's dialog or logs in, through `SessionSetup.remedied`, which logs in once
- *    more for each refusal it can take care of.
- * 2. `SessionSetup.prepare` first settles what is open: the bank parameter data, the synchronization, and through
- *    `TanSelection` the TAN method and medium.
- * 3. `ResponseHandler.startDialog` sends the login and completes the strong authentication the bank asks for, a TAN or
- *    an app approval (`AppApprovalWait`).
- * 4. `DialogRunner.query` sends the order in that dialog, completes its approval the same way, and fetches all pages.
- *
- * `SepaAccounts` completes IBAN and BIC, and `UserPrompts` is everything the app is told or asked. The protocol's
- * `LoginGuard` decides which bank errors refuse the login, and keeps the PIN from going out after one.
- */
-export class PinTanClient {
-    prompts;
-    protocol;
-    sessionState;
-    tans;
-    setup;
-    dialogs;
-    sepa;
-    queue = new SerialExecutor();
-    closed;
-    /** The call running now, which a call from inside its callbacks would wait for. */
-    runningCall;
-    /**
-     * A client of the protocol `createProtocol` builds around the logger it is given (`UserPrompts.logger`), with the
-     * session restored from `FinTsClientOptions.state` where it was saved for this user and bank.
-     */
-    constructor(options, createProtocol) {
-        this.prompts = new UserPrompts(options);
-        this.protocol = createProtocol(this.prompts.logger);
-        this.sessionState = restoreSession(options.state, this.protocol);
-        const guard = this.protocol.loginGuard;
-        const responses = new ResponseHandler(this.protocol, this.sessionState, this.prompts, guard);
-        this.tans = new TanSelection(this.protocol, this.sessionState, this.prompts);
-        this.setup = new SessionSetup(this.protocol, responses, this.tans, guard);
-        this.dialogs = new DialogRunner(this.setup, responses, this.prompts);
-        this.sepa = new SepaAccounts(this.protocol, this.sessionState, this.dialogs, guard);
-    }
-    get state() {
-        return saveSession(this.protocol, this.sessionState);
-    }
-    get selectedTanMethod() {
-        return this.sessionState.tanMethod;
-    }
-    get selectedTanMedium() {
-        return this.sessionState.tanMedium;
-    }
-    selectTanMethod(securityFunction, tanMedium) {
-        return this.serialized(async () => {
-            await this.dialogs.end();
-            this.tans.select(securityFunction, tanMedium);
-        });
-    }
-    getBankInfo() {
-        return this.serialized(() => this.setup.remedied(() => this.setup.bankInfo()));
-    }
-    getTanMethods() {
-        return this.serialized(() => this.setup.remedied(() => this.setup.methods()));
-    }
-    getTanMedia() {
-        return this.serialized(async () => {
-            await this.setup.remedied(() => this.setup.prepare());
-            return (this.tans.takeLookedUpMedia() ??
-                (await this.dialogs.query(() => {
-                    const query = this.protocol.tanMedia();
-                    if (query === undefined)
-                        throw new FinTsUnsupportedError('The bank does not list TAN media');
-                    return query;
-                })));
-        });
-    }
-    getAccounts() {
-        return this.serialized(() => this.sepa.completedAccounts());
-    }
-    getBalance(account) {
-        return this.serialized(async () => {
-            const completed = await this.sepa.complete(account);
-            // The dialog start delivers the user parameter data, which may carry the complete balance: then the client must
-            // not ask for it separately (Formals E.3.1.1, F.3.2).
-            await this.dialogs.open();
-            return (this.protocol.userParameters?.completeBalance(completed) ??
-                (await this.dialogs.query(() => this.protocol.balance(completed))));
-        });
-    }
-    getTransactions(account, query = {}) {
-        // Only the days count: the bank takes dates without time of day. Checked before the call waits for others.
-        const firstDay = query.from === undefined ? undefined : calendarDay(query.from);
-        const lastDay = query.to === undefined ? undefined : calendarDay(query.to);
-        if (firstDay !== undefined && lastDay !== undefined && firstDay.getTime() > lastDay.getTime()) {
-            return Promise.reject(invalidArgument('`from` lies on a day after `to`', 'from'));
-        }
-        return this.serialized(async () => {
-            const completed = await this.sepa.complete(account);
-            const transactions = await this.dialogs.query(() => this.protocol.transactions(completed, query.format ?? 'auto', notAfterToday(firstDay), notAfterToday(lastDay)));
-            // A stable sort, so that transactions of the same day keep the bank's order.
-            return transactions.sort((a, b) => (a.bookingDate ?? a.valueDate).getTime() - (b.bookingDate ?? b.valueDate).getTime());
-        });
-    }
-    close() {
-        this.closed ??= this.closeNow();
-        return this.closed;
-    }
-    closeNow() {
-        this.prompts.close();
-        return this.queue.run(() => this.prompts.reportingCallbackErrors(async () => {
-            try {
-                await this.dialogs.end();
-            }
-            finally {
-                this.protocol.close();
-            }
-        }));
-    }
-    serialized(action) {
-        const caller = runningCalls.current;
-        if (caller !== undefined && caller.client === this && caller === this.runningCall) {
-            // The call would wait behind the running one, which waits for the callback: neither would ever end.
-            return Promise.reject(new FinTsStateError('The FinTS client was called from inside one of its callbacks'));
-        }
-        return this.queue.run(async () => {
-            const call = { client: this };
-            this.runningCall = call;
-            try {
-                return await runningCalls.run(call, () => {
-                    this.prompts.checkOpen();
-                    return this.prompts.reportingCallbackErrors(action);
-                });
-            }
-            finally {
-                this.runningCall = undefined;
-            }
-        });
-    }
-}
-//# sourceMappingURL=pin-tan-client.js.map

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

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

package/dist/session/pin-tan-dialog.d.ts

@@ -1,71 +0,0 @@
-import type { TanMethod } from '../tan/tan-models.js';
-import type { BankParameters } from './parameter-data.js';
-import type { Approval, BankResponse, ProtocolDialog, StartWithOrder } from './protocol.js';
-/** What `PinTanDialog.approvalOf` takes besides the response. */
-export interface ApprovalParts<R> {
-    readonly reference: string;
-    readonly message: string | undefined;
-    readonly hhdUc: Uint8Array | undefined;
-    readonly validUntil: Date | undefined;
-    readonly tanMediumName: string | undefined;
-    readonly submitTan: (tan: string) => Promise<R>;
-    readonly checkStatus: () => Promise<R>;
-    readonly instructionsIn: (response: R) => string | undefined;
-}
-/** The dialog logic of PIN/TAN: the TAN method and medium, the message count, the dialog's end, and the approvals. */
-export declare abstract class PinTanDialog<R extends BankResponse, O> implements ProtocolDialog<R, O> {
-    readonly method: TanMethod;
-    /** The TAN medium the messages name, where the method takes one. */
-    readonly tanMedium: string | undefined;
-    private messageNumber;
-    private ended;
-    /** When the bank last answered without rejecting the whole message, which shows it still knows the dialog. */
-    private lastAnswer;
-    constructor(method: TanMethod, 
-    /** The TAN medium the messages name, where the method takes one. */
-    tanMedium: string | undefined);
-    abstract readonly isActive: boolean;
-    abstract start(synchronize?: boolean): Promise<R>;
-    abstract startWith(order: O): StartWithOrder<R>;
-    abstract send(order: O): Promise<R>;
-    /** The bank parameter data received so far, which tell how long the bank keeps an idle dialog. */
-    protected abstract get bankParameters(): BankParameters | undefined;
-    /**
-     * Whether the dialog has ended, on either side.
-     *
-     * The bank ends a dialog idle for longer than its maximum timeout (HIBPA, Formals C.9), or five minutes where it
-     * states none. Such a dialog is neither used nor ended again: the bank would refuse any message in it.
-     */
-    get hasEnded(): boolean;
-    private get idleTooLong();
-    /** Whether the messages are signed with a two-step TAN method, so that the bank may ask for approvals. */
-    get isTwoStep(): boolean;
-    /** The TAN medium name the messages send: the dialog's, unless the method takes none. */
-    get mediumName(): string | undefined;
-    end(): Promise<void>;
-    /** Sends the message that ends the dialog. */
-    protected abstract sendEnd(): Promise<void>;
-    discard(): void;
-    /**
-     * Sends the next message through `post`, which takes its number, and reads the answer with `read`. The message counts
-     * once the bank has answered, whatever it answered.
-     *
-     * The dialog ends on the client's side, without a dialog end, where it is over for the bank: after a return code that
-     * ends it, such as 9800, and after a rejected opening message (Formals C.1.2), or a broken connection (C.6).
-     *
-     * Only an answer that does not reject the whole message starts the idle time anew (`hasEnded`): a rejection may come
-     * from a bank that has ended the dialog without saying so.
-     */
-    protected transmit<A>(post: (number: number) => Promise<A>, read: (answer: A) => R): Promise<R>;
-    /** Reads what `response` tells about the dialog itself, such as the ID the bank assigns it. */
-    protected abstract readDialogData(response: R): void;
-    approvalAskedIn(response: R): Approval<R> | undefined;
-    /**
-     * The approval whose challenge `response` carries; `undefined` where it carries none, or only the dummy one of a
-     * message the bank exempts from strong authentication.
-     */
-    protected abstract approvalIn(response: R): Approval<R> | undefined;
-    /** The approval `response` asks for, with the challenge for the order the bank calls `reference`. */
-    protected approvalOf(response: R, parts: ApprovalParts<R>): Approval<R>;
-}
-//# sourceMappingURL=pin-tan-dialog.d.ts.map

package/dist/session/pin-tan-dialog.d.ts.map

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

package/dist/session/pin-tan-dialog.js

@@ -1,124 +0,0 @@
-import { FinTsError, FinTsProtocolError, FinTsTransportError, parseBankData } from '../core/errors.js';
-import { endsDialog, FeedbackCodes, hasCode, hasErrors } from '../core/feedback.js';
-import { challengeText, TanChallenge } from '../tan/challenge.js';
-/**
- * How long a dialog may stay idle where the bank states no timeout: on the safe side, since a dialog given up too early
- * only costs a new login, while one kept too long fails the next call.
- */
-const defaultIdleLimitMs = 5 * 60_000;
-/** The dialog logic of PIN/TAN: the TAN method and medium, the message count, the dialog's end, and the approvals. */
-export class PinTanDialog {
-    method;
-    tanMedium;
-    messageNumber = 1;
-    ended = false;
-    /** When the bank last answered without rejecting the whole message, which shows it still knows the dialog. */
-    lastAnswer;
-    constructor(method, 
-    /** The TAN medium the messages name, where the method takes one. */
-    tanMedium) {
-        this.method = method;
-        this.tanMedium = tanMedium;
-    }
-    /**
-     * Whether the dialog has ended, on either side.
-     *
-     * The bank ends a dialog idle for longer than its maximum timeout (HIBPA, Formals C.9), or five minutes where it
-     * states none. Such a dialog is neither used nor ended again: the bank would refuse any message in it.
-     */
-    get hasEnded() {
-        return this.ended || this.idleTooLong;
-    }
-    get idleTooLong() {
-        const last = this.lastAnswer;
-        const timeout = this.bankParameters?.bankInfo.maxTimeout;
-        // A timeout of 0 or below: the bank keeps idle dialogs without limit.
-        const limit = timeout === undefined ? defaultIdleLimitMs : timeout <= 0 ? undefined : timeout * 1000;
-        return last !== undefined && limit !== undefined && Date.now() - last > limit;
-    }
-    /** Whether the messages are signed with a two-step TAN method, so that the bank may ask for approvals. */
-    get isTwoStep() {
-        return !this.method.isOneStep;
-    }
-    /** The TAN medium name the messages send: the dialog's, unless the method takes none. */
-    get mediumName() {
-        return this.method.mediumRequirement === 'notAllowed' ? undefined : this.tanMedium;
-    }
-    async end() {
-        if (!this.isActive)
-            return;
-        this.ended = true;
-        try {
-            await this.sendEnd();
-        }
-        catch (error) {
-            // The bank may have ended the dialog on its side already.
-            if (!(error instanceof FinTsError))
-                throw error;
-        }
-    }
-    discard() {
-        this.ended = true;
-    }
-    /**
-     * Sends the next message through `post`, which takes its number, and reads the answer with `read`. The message counts
-     * once the bank has answered, whatever it answered.
-     *
-     * The dialog ends on the client's side, without a dialog end, where it is over for the bank: after a return code that
-     * ends it, such as 9800, and after a rejected opening message (Formals C.1.2), or a broken connection (C.6).
-     *
-     * Only an answer that does not reject the whole message starts the idle time anew (`hasEnded`): a rejection may come
-     * from a bank that has ended the dialog without saying so.
-     */
-    async transmit(post, read) {
-        const number = this.messageNumber;
-        let answer;
-        try {
-            answer = await post(number);
-        }
-        catch (error) {
-            if (error instanceof FinTsTransportError)
-                this.discard();
-            throw error;
-        }
-        this.messageNumber++;
-        const response = parseBankData(() => read(answer));
-        this.readDialogData(response);
-        if (!response.messageRejected)
-            this.lastAnswer = Date.now();
-        if (endsDialog(response.feedback) || (number === 1 && response.messageRejected))
-            this.discard();
-        return response;
-    }
-    approvalAskedIn(response) {
-        const feedback = response.feedback;
-        const asks = !hasErrors(feedback) &&
-            (hasCode(feedback, FeedbackCodes.tanRequired) || hasCode(feedback, FeedbackCodes.decoupledPending));
-        if (!asks)
-            return undefined;
-        const approval = this.approvalIn(response);
-        if (approval === undefined)
-            throw new FinTsProtocolError('The bank asks for an approval, but sends no challenge');
-        return approval;
-    }
-    /** The approval `response` asks for, with the challenge for the order the bank calls `reference`. */
-    approvalOf(response, parts) {
-        const feedback = response.feedback;
-        return {
-            challenge: TanChallenge.create({
-                method: this.method,
-                reference: parts.reference,
-                message: parts.message,
-                hhdUc: parts.hhdUc,
-                isDecoupled: hasCode(feedback, FeedbackCodes.decoupledPending) || this.method.decoupled,
-                validUntil: parts.validUntil,
-                tanMediumName: parts.tanMediumName ?? this.tanMedium,
-            }),
-            submitTan: parts.submitTan,
-            checkStatus: parts.checkStatus,
-            waitForPush: hasCode(feedback, FeedbackCodes.decoupledWaitForPush),
-            instructionsIn: (status) => challengeText(parts.instructionsIn(status)),
-        };
-    }
-}
-//# sourceMappingURL=pin-tan-dialog.js.map

package/dist/session/pin-tan-dialog.js.map

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