@coderoftime/fints 0.1.0 → 0.3.0

package/dist/session/session-setup.js.map

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

package/dist/session/session-state.d.ts

@@ -1,15 +1,19 @@
 import { Account } from '../core/account.js';
 import { type JsonObject } from '../util/json.js';
-import type { BankResponse, PinTanProtocol } from './protocol.js';
-/** The session and the protocol's parameter data as one JSON string, which `restoreSession` reads. */
-export declare function saveSession<R extends BankResponse, O>(protocol: PinTanProtocol<R, O>, session: SessionState): string;
+import type { ParameterStore } from '../v3/parameter-store.js';
+import type { LoginGuard } from './login-guard.js';
+/** The session, the parameter data and the guard's refusal as JSON, which `restoreSession` reads. */
+export declare function saveSession(parameters: ParameterStore, guard: LoginGuard, session: SessionState): string;
 /**
- * The session saved in `json`, and the protocol's parameter data restored from it.
+ * The session saved in `json`, and the parameter data and the guard's refused login restored from it.
  *
  * A missing or damaged state, or one saved for another user, bank, server or protocol version, gives a new session,
- * which only costs a new synchronization.
+ * which only costs a new synchronization. The refused login and the count of logins whose answer was lost belong to the
+ * user at the bank, so they come first: they hold for another server or protocol version as well, and where the rest is
+ * damaged; a state saved by fints-ts 0.1 or the Dart package 0.2.0 has neither. A damaged section of their own fails
+ * closed: it restores a refusal without return codes, since it may have held one.
  */
-export declare function restoreSession<R extends BankResponse, O>(json: string | undefined, protocol: PinTanProtocol<R, O>): SessionState;
+export declare function restoreSession(json: string | undefined, parameters: ParameterStore, guard: LoginGuard): SessionState;
 /**
  * The session data saved between app starts: the allowed TAN methods, the TAN method and medium in use, and the SEPA
  * account list.

package/dist/session/session-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../../src/session/session-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,OAAO,EAOL,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAQlE,sGAAsG;AACtG,wBAAgB,WAAW,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAQpH;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,EACtD,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7B,YAAY,CAoBd;AAOD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,mBAAmB,CAAgC;IAC3D,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,iBAAiB,CAAiC;IAC1D,OAAO,CAAC,cAAc,CAAqB;IAE3C,yGAAyG;IACzG,IAAI,cAAc,IAAI,SAAS,MAAM,EAAE,GAAG,SAAS,CAElD;IAED,kDAAkD;IAClD,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,qCAAqC;IACrC,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,uEAAuE;IACvE,sBAAsB,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAIlE;;;OAGG;IACH,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAKzE,yDAAyD;IACzD,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI9C,iGAAiG;IACjG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,OAAO,EAAE,GAAG,SAAS;IAI5E,mGAAmG;IACnG,iBAAiB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAKrF,4EAA4E;IAC5E,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY;IAW/C,gCAAgC;IAChC,MAAM,IAAI,UAAU;CASrB"}
+{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../../src/session/session-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAI7C,OAAO,EAQL,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,kBAAkB,CAAC;AAQpE,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAUxG;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,GAAG,YAAY,CAsBpH;AAYD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,mBAAmB,CAAgC;IAC3D,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,iBAAiB,CAAiC;IAC1D,OAAO,CAAC,cAAc,CAAqB;IAE3C,yGAAyG;IACzG,IAAI,cAAc,IAAI,SAAS,MAAM,EAAE,GAAG,SAAS,CAElD;IAED,kDAAkD;IAClD,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,qCAAqC;IACrC,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,uEAAuE;IACvE,sBAAsB,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAIlE;;;OAGG;IACH,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAKzE,yDAAyD;IACzD,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI9C,iGAAiG;IACjG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,OAAO,EAAE,GAAG,SAAS;IAI5E,mGAAmG;IACnG,iBAAiB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAKrF,4EAA4E;IAC5E,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY;IAa/C,gCAAgC;IAChC,MAAM,IAAI,UAAU;CASrB"}

package/dist/session/session-state.js

@@ -1,42 +1,55 @@
 import { Account } from '../core/account.js';
 import { hostOf } from '../core/config.js';
+import { FinTsFeedback } from '../core/feedback.js';
 import { FormatError } from '../util/errors.js';
-import { isJsonObject, isString, readObject, readOptionalInt, readOptionalList, readOptionalString, } from '../util/json.js';
+import { isJsonObject, isString, readObject, readOptionalInt, readOptionalObject, readOptionalList, readOptionalString, } from '../util/json.js';
 /** Layout of the saved session; a state of another layout is ignored. */
 const stateFormat = 1;
 /** The protocol version the state is for, named as the Dart package names it, so that both read each other's states. */
 const protocolVersion = 'v300';
-/** The session and the protocol's parameter data as one JSON string, which `restoreSession` reads. */
-export function saveSession(protocol, session) {
+/** The session, the parameter data and the guard's refusal as JSON, which `restoreSession` reads. */
+export function saveSession(parameters, guard, session) {
     return JSON.stringify({
         format: stateFormat,
         version: protocolVersion,
-        owner: ownerOf(protocol.config),
+        owner: ownerOf(parameters.config),
         session: session.toJson(),
-        protocol: protocol.saveState(),
+        // Under the key the Dart package reads as well.
+        protocol: parameters.saveState(),
+        loginGuard: guardStateToJson(guard.saveState()),
     });
 }
 /**
- * The session saved in `json`, and the protocol's parameter data restored from it.
+ * The session saved in `json`, and the parameter data and the guard's refused login restored from it.
  *
  * A missing or damaged state, or one saved for another user, bank, server or protocol version, gives a new session,
- * which only costs a new synchronization.
+ * which only costs a new synchronization. The refused login and the count of logins whose answer was lost belong to the
+ * user at the bank, so they come first: they hold for another server or protocol version as well, and where the rest is
+ * damaged; a state saved by fints-ts 0.1 or the Dart package 0.2.0 has neither. A damaged section of their own fails
+ * closed: it restores a refusal without return codes, since it may have held one.
  */
-export function restoreSession(json, protocol) {
+export function restoreSession(json, parameters, guard) {
     if (json === undefined)
         return new SessionState();
     try {
         const saved = JSON.parse(json);
-        if (!isJsonObject(saved) || saved.format !== stateFormat || saved.version !== protocolVersion) {
+        if (!isJsonObject(saved) || saved.format !== stateFormat)
             return new SessionState();
-        }
-        const owner = readOptionalList(saved, 'owner', isString);
-        const expected = ownerOf(protocol.config);
-        if (owner?.length !== expected.length || owner.some((value, i) => value !== expected[i])) {
+        // Entries of another type differ like any other value, so that a damaged server entry keeps the refused login.
+        const owner = saved.owner ?? [];
+        if (!Array.isArray(owner))
+            return new SessionState();
+        const [server, ...user] = owner;
+        const expected = userOf(parameters.config);
+        if (user.length !== expected.length || user.some((value, i) => value !== expected[i]))
+            return new SessionState();
+        const guardState = savedGuardState(saved);
+        if (guardState !== undefined)
+            guard.restoreState(guardState);
+        if (server !== hostOf(parameters.config.url) || saved.version !== protocolVersion)
             return new SessionState();
-        }
         const session = SessionState.fromJson(readObject(saved, 'session'));
-        protocol.restoreState(readObject(saved, 'protocol'));
+        parameters.restoreState(readObject(saved, 'protocol'), session.tanMedium);
         return session;
     }
     catch (error) {
@@ -46,9 +59,13 @@ export function restoreSession(json, protocol) {
         throw error;
     }
 }
-/** Whose data a state holds, so that the state of another user or bank is never used. */
+/** Whose data a state holds, so that the state of another user or bank is never used: the server, then `userOf`. */
 function ownerOf(config) {
-    return [hostOf(config.url), config.bankCode, config.userId, config.customerId];
+    return [hostOf(config.url), ...userOf(config)];
+}
+/** The user at the bank, whom a refused login belongs to. */
+function userOf(config) {
+    return [config.bankCode, config.userId, config.customerId];
 }
 /**
  * The session data saved between app starts: the allowed TAN methods, the TAN method and medium in use, and the SEPA
@@ -106,7 +123,9 @@ export class SessionState {
         state.useTanMethod(readOptionalString(json, 'tanMethod'), readOptionalString(json, 'tanMedium'));
         if (allowedMethods !== undefined)
             state.rememberAllowedMethods(allowedMethods);
-        if (sepaAccounts !== undefined)
+        // fints-ts 0.1 and the Dart package 0.2.0 saved an empty list as well, which completes nothing; without it, the
+        // list is asked for again.
+        if (sepaAccounts !== undefined && sepaAccounts.length > 0)
             state.cacheSepaAccounts(sepaAccounts, sepaUpdVersion);
         return state;
     }
@@ -144,4 +163,39 @@ function accountFromJson(json) {
         bankCode,
     });
 }
+function guardStateToJson(state) {
+    return { refusal: state.refusal?.map(feedbackToJson) ?? null, unreadLogins: state.unreadLogins };
+}
+/** The guard's section of `saved`, `undefined` where there is none; a damaged one is a refusal without return codes. */
+function savedGuardState(saved) {
+    try {
+        const json = readOptionalObject(saved, 'loginGuard');
+        return json === undefined ? undefined : guardStateFromJson(json);
+    }
+    catch (error) {
+        if (error instanceof FormatError)
+            return { refusal: [], unreadLogins: 0 };
+        throw error;
+    }
+}
+function guardStateFromJson(json) {
+    return {
+        refusal: readOptionalList(json, 'refusal', isJsonObject)?.map(feedbackFromJson),
+        unreadLogins: readOptionalInt(json, 'unreadLogins') ?? 0,
+    };
+}
+function feedbackToJson(f) {
+    return { code: f.code, reference: f.reference ?? null, text: f.text, parameters: [...f.parameters] };
+}
+function feedbackFromJson(json) {
+    const code = readOptionalString(json, 'code');
+    if (code === undefined)
+        throw new FormatError('Saved state: return code without code');
+    return new FinTsFeedback({
+        code,
+        reference: readOptionalString(json, 'reference'),
+        text: readOptionalString(json, 'text') ?? '',
+        parameters: readOptionalList(json, 'parameters', isString) ?? [],
+    });
+}
 //# sourceMappingURL=session-state.js.map

package/dist/session/session-state.js.map

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

package/dist/session/signed-dialog.d.ts

@@ -0,0 +1,83 @@
+import type { FinTs3Dialog } from '../v3/dialog.js';
+import { IncomingMessage3 } from '../v3/message.js';
+import type { ParameterStore } from '../v3/parameter-store.js';
+import type { SegmentSpec } from '../v3/syntax.js';
+import type { LoginGuard } from './login-guard.js';
+import type { SessionState } from './session-state.js';
+import type { UserPrompts } from './user-prompts.js';
+/** The parts of the session that every `SignedDialog` reports to. */
+export interface SessionParts {
+    readonly parameters: ParameterStore;
+    readonly state: SessionState;
+    readonly prompts: UserPrompts;
+    readonly guard: LoginGuard;
+}
+/**
+ * A dialog signed with the PIN, which settles each answer before it hands it out: it keeps the parameter data of the
+ * dialog's opening, passes the notices on, has the `LoginGuard` judge the answer and throws its errors, and completes
+ * the approval the bank asks for. The session sends every message signed with the PIN through it, so that the guard
+ * judges every answer, that to the dialog's end included.
+ */
+export declare class SignedDialog {
+    private readonly dialog;
+    private readonly session;
+    constructor(dialog: FinTs3Dialog, session: SessionParts);
+    /** Whether the bank knows this dialog and it has not ended. */
+    get isActive(): boolean;
+    /** Logs in, which opens the dialog; with `synchronize` the bank also assigns a customer system ID. */
+    login(synchronize?: boolean): Promise<IncomingMessage3>;
+    /**
+     * Logs in, asking strong authentication for `order`, then sends `order` in a message of its own, as for listing the
+     * TAN media while no medium is chosen yet (`FinTs3Dialog.startWith`); returns both answers.
+     */
+    loginWith(order: SegmentSpec): Promise<IncomingMessage3[]>;
+    /**
+     * Sends `order` and completes the approval the bank asks for. `admitApproval` runs before the user is asked, and
+     * refuses the approval by throwing.
+     */
+    send(order: SegmentSpec, admitApproval?: () => void): Promise<IncomingMessage3>;
+    /**
+     * Ends the dialog at the bank; does nothing if it is not active. Of the answer only a rejected PIN counts, which the
+     * guard judges: the dialog is over either way.
+     */
+    end(): Promise<void>;
+    /**
+     * Receives `response`, the answer to a request of `kind`: keeps its parameter data where it answers the `opening` of
+     * the dialog, the login or its approval, even alongside errors, since the remedy for a refused login may need them;
+     * passes its notices on; and has the guard judge it, then throws its errors, as the refusal of the login where they
+     * amount to one.
+     */
+    private receive;
+    /**
+     * Sends the login `send` and settles its answer. New login data next to an error in the answer to its approval are
+     * retired all the same (`retireLoginData`), although the guard counts that error as no refusal; next to an error in
+     * the answer to the login they are its refusal already (`loginRefusalFor`).
+     */
+    private settleLogin;
+    /**
+     * Where `response` answers a login, a request of `kind` other than `order`, or its approval with new login data,
+     * retires them (`retireLoginData`). It runs before any approval, which would cost the user a TAN for a session that
+     * ends anyway.
+     */
+    private retireOldLoginData;
+    /**
+     * Ends the dialog, whose answer to a request of `kind` brought new login data with `feedback`, stops the client from
+     * logging in with the old ones, and fails the call with `FinTsLoginDataChangedError` (Rückmeldungscodes C.6).
+     */
+    private retireLoginData;
+    /**
+     * Receives `response`, the answer to a request of `kind`, then completes the approval it asks for, once
+     * `admitApproval` has let it; returns it joined with the response that completes the approval.
+     *
+     * Throws `FinTsProtocolError` if that response asks for an approval once more: the bank has not executed the message
+     * then either, and read as done it would report an empty result.
+     */
+    private settle;
+    /** Passes on the notices in `response`: the TAN methods the user may use (3920), the bank's messages and warnings. */
+    private readNotices;
+    /** Asks the user for the TAN `approval` takes and sends it; `opening` tells whether it approves the login. */
+    private enterTan;
+    /** Waits for the user to approve in the banking app; `opening` tells whether the approval is that of the login. */
+    private awaitAppApproval;
+}
+//# sourceMappingURL=signed-dialog.d.ts.map

package/dist/session/signed-dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signed-dialog.d.ts","sourceRoot":"","sources":["../../src/session/signed-dialog.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAY,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,YAAY;IAGxC,+DAA+D;IAC/D,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,sGAAsG;IACtG,KAAK,CAAC,WAAW,UAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIrD;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAMhE;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIrF;;;OAGG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAO1B;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAUf;;;;OAIG;YACW,WAAW;IAezB;;;;OAIG;YACW,kBAAkB;IAKhC;;;OAGG;YACW,eAAe;IAM7B;;;;;;OAMG;YACW,MAAM;IAqBpB,sHAAsH;IACtH,OAAO,CAAC,WAAW;IAOnB,8GAA8G;YAChG,QAAQ;IAatB,mHAAmH;IACnH,OAAO,CAAC,gBAAgB;CAUzB"}

package/dist/session/signed-dialog.js

@@ -0,0 +1,185 @@
+import { requireLatin1 } from '../core/config.js';
+import { bankErrorFor, FinTsBankError, FinTsLoginDataChangedError, FinTsLoginRefusedError, FinTsProtocolError, FinTsTanCancelledError, } from '../core/errors.js';
+import { allowedTanMethodsIn, FeedbackCodes, hasCode, hasErrors, userWarnings, } from '../core/feedback.js';
+import { invalidArgument } from '../util/errors.js';
+import { trimBlanks, withAsciiForms } from '../util/text.js';
+import { IncomingMessage3 } from '../v3/message.js';
+import { appApprovalWait } from './app-approval.js';
+/**
+ * A dialog signed with the PIN, which settles each answer before it hands it out: it keeps the parameter data of the
+ * dialog's opening, passes the notices on, has the `LoginGuard` judge the answer and throws its errors, and completes
+ * the approval the bank asks for. The session sends every message signed with the PIN through it, so that the guard
+ * judges every answer, that to the dialog's end included.
+ */
+export class SignedDialog {
+    dialog;
+    session;
+    constructor(dialog, session) {
+        this.dialog = dialog;
+        this.session = session;
+    }
+    /** Whether the bank knows this dialog and it has not ended. */
+    get isActive() {
+        return this.dialog.isActive;
+    }
+    /** Logs in, which opens the dialog; with `synchronize` the bank also assigns a customer system ID. */
+    login(synchronize = false) {
+        return this.settleLogin(() => this.dialog.start(synchronize));
+    }
+    /**
+     * Logs in, asking strong authentication for `order`, then sends `order` in a message of its own, as for listing the
+     * TAN media while no medium is chosen yet (`FinTs3Dialog.startWith`); returns both answers.
+     */
+    async loginWith(order) {
+        const start = this.dialog.startWith(order);
+        const login = await this.settleLogin(start.login);
+        return [login, await this.settle(await start.order(), 'order')];
+    }
+    /**
+     * Sends `order` and completes the approval the bank asks for. `admitApproval` runs before the user is asked, and
+     * refuses the approval by throwing.
+     */
+    async send(order, admitApproval) {
+        return this.settle(await this.dialog.send(order), 'order', admitApproval);
+    }
+    /**
+     * Ends the dialog at the bank; does nothing if it is not active. Of the answer only a rejected PIN counts, which the
+     * guard judges: the dialog is over either way.
+     */
+    async end() {
+        const response = await this.dialog.end();
+        if (response !== undefined && hasErrors(response.feedback)) {
+            this.session.guard.judge(bankErrorFor(response.feedback), 'order', this.dialog.method);
+        }
+    }
+    /**
+     * Receives `response`, the answer to a request of `kind`: keeps its parameter data where it answers the `opening` of
+     * the dialog, the login or its approval, even alongside errors, since the remedy for a refused login may need them;
+     * passes its notices on; and has the guard judge it, then throws its errors, as the refusal of the login where they
+     * amount to one.
+     */
+    receive(response, kind, opening) {
+        if (opening)
+            this.session.parameters.keep(response);
+        this.readNotices(response);
+        const error = hasErrors(response.feedback) ? bankErrorFor(response.feedback, kind === 'approval') : undefined;
+        const refusal = this.session.guard.judge(error, kind, this.dialog.method);
+        // Every further message of a refused login's dialog would carry the refused PIN.
+        if (refusal !== undefined)
+            this.dialog.discard();
+        if (error !== undefined)
+            throw refusal ?? error;
+    }
+    /**
+     * Sends the login `send` and settles its answer. New login data next to an error in the answer to its approval are
+     * retired all the same (`retireLoginData`), although the guard counts that error as no refusal; next to an error in
+     * the answer to the login they are its refusal already (`loginRefusalFor`).
+     */
+    async settleLogin(send) {
+        try {
+            return await this.settle(await send(), 'login');
+        }
+        catch (error) {
+            if (!(error instanceof FinTsBankError) ||
+                error instanceof FinTsLoginRefusedError ||
+                !hasCode(error.feedback, FeedbackCodes.newLoginData)) {
+                throw error;
+            }
+            return this.retireLoginData(error.feedback, 'approval');
+        }
+    }
+    /**
+     * Where `response` answers a login, a request of `kind` other than `order`, or its approval with new login data,
+     * retires them (`retireLoginData`). It runs before any approval, which would cost the user a TAN for a session that
+     * ends anyway.
+     */
+    async retireOldLoginData(response, kind) {
+        if (kind === 'order' || !hasCode(response.feedback, FeedbackCodes.newLoginData))
+            return;
+        await this.retireLoginData(response.feedback, kind);
+    }
+    /**
+     * Ends the dialog, whose answer to a request of `kind` brought new login data with `feedback`, stops the client from
+     * logging in with the old ones, and fails the call with `FinTsLoginDataChangedError` (Rückmeldungscodes C.6).
+     */
+    async retireLoginData(feedback, kind) {
+        await this.end();
+        const error = new FinTsLoginDataChangedError(feedback);
+        throw this.session.guard.judge(error, kind, this.dialog.method) ?? error;
+    }
+    /**
+     * Receives `response`, the answer to a request of `kind`, then completes the approval it asks for, once
+     * `admitApproval` has let it; returns it joined with the response that completes the approval.
+     *
+     * Throws `FinTsProtocolError` if that response asks for an approval once more: the bank has not executed the message
+     * then either, and read as done it would report an empty result.
+     */
+    async settle(response, kind, admitApproval) {
+        const opening = kind !== 'order';
+        this.receive(response, kind, opening);
+        await this.retireOldLoginData(response, kind);
+        const approval = this.dialog.approvalAskedIn(response);
+        if (approval === undefined)
+            return response;
+        admitApproval?.();
+        const approved = approval.challenge.isDecoupled
+            ? await this.awaitAppApproval(approval, opening)
+            : await this.enterTan(approval, opening);
+        await this.retireOldLoginData(approved, kind);
+        if (this.dialog.approvalAskedIn(approved) !== undefined) {
+            throw new FinTsProtocolError('The bank asks for another approval in answer to the approval');
+        }
+        return IncomingMessage3.combine(response, approved);
+    }
+    /** Passes on the notices in `response`: the TAN methods the user may use (3920), the bank's messages and warnings. */
+    readNotices(response) {
+        const allowed = allowedTanMethodsIn(response.feedback);
+        if (allowed.length > 0)
+            this.session.state.rememberAllowedMethods(allowed);
+        for (const message of response.bankMessages)
+            this.session.prompts.showBankMessage(message);
+        for (const warning of userWarnings(response.feedback))
+            this.session.prompts.showWarning(warning);
+    }
+    /** Asks the user for the TAN `approval` takes and sends it; `opening` tells whether it approves the login. */
+    async enterTan(approval, opening) {
+        const answer = await this.session.prompts.askTan(approval.challenge);
+        if (answer.kind === 'approved') {
+            throw invalidArgument('Answered a TAN challenge with an approval in the banking app', 'tanCallback');
+        }
+        // Not NFKC, which also changes characters FinTS 3.0 sends as they are, such as `²`, in a TAN the bank compares.
+        const tan = answer.kind === 'tan' ? trimBlanks(withAsciiForms(answer.tan)) : '';
+        if (tan === '')
+            throw new FinTsTanCancelledError();
+        const response = await approval.submitTan(requireTanOf(approval.challenge.method, tan));
+        this.receive(response, 'approval', opening);
+        return response;
+    }
+    /** Waits for the user to approve in the banking app; `opening` tells whether the approval is that of the login. */
+    awaitAppApproval(approval, opening) {
+        const prompts = this.session.prompts;
+        return appApprovalWait(approval, {
+            ask: (challenge) => prompts.askTan(challenge),
+            pause: (delayMs, interrupt) => prompts.pause(delayMs, interrupt),
+            receive: (response) => {
+                this.receive(response, 'approval', opening);
+            },
+        }).run();
+    }
+}
+/**
+ * Throws `TypeError` for a TAN that `method` rules out, which the bank would count as a failed attempt: one longer than
+ * `TanMethod.maxTanLength`, or with other characters than digits for a `TanMethod.numericTan` method; and for one that
+ * FinTS 3.0 cannot send. The message leaves out the TAN.
+ */
+function requireTanOf(method, tan) {
+    const max = method.maxTanLength;
+    if (max !== undefined && max > 0 && tan.length > max) {
+        throw invalidArgument(`The TAN method ${method.name} takes TANs of at most ${max} characters`, 'tan');
+    }
+    if (method.numericTan && !/^[0-9]+$/.test(tan)) {
+        throw invalidArgument(`The TAN method ${method.name} takes digits only`, 'tan');
+    }
+    return requireLatin1(tan, 'tan');
+}
+//# sourceMappingURL=signed-dialog.js.map

package/dist/session/signed-dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signed-dialog.js","sourceRoot":"","sources":["../../src/session/signed-dialog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACL,YAAY,EACZ,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,OAAO,EACP,SAAS,EACT,YAAY,GAEb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAapD;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IAEJ;IACA;IAFnB,YACmB,MAAoB,EACpB,OAAqB;QADrB,WAAM,GAAN,MAAM,CAAc;QACpB,YAAO,GAAP,OAAO,CAAc;IACrC,CAAC;IAEJ,+DAA+D;IAC/D,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED,sGAAsG;IACtG,KAAK,CAAC,WAAW,GAAG,KAAK;QACvB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,KAAkB;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClD,OAAO,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,KAAkB,EAAE,aAA0B;QACvD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG;QACP,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QACzC,IAAI,QAAQ,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,OAAO,CAAC,QAA0B,EAAE,IAAiB,EAAE,OAAgB;QAC7E,IAAI,OAAO;YAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC3B,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9G,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1E,iFAAiF;QACjF,IAAI,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,OAAO,IAAI,KAAK,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,WAAW,CAAC,IAAqC;QAC7D,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IACE,CAAC,CAAC,KAAK,YAAY,cAAc,CAAC;gBAClC,KAAK,YAAY,sBAAsB;gBACvC,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,EACpD,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;YACD,OAAO,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,kBAAkB,CAAC,QAA0B,EAAE,IAAiB;QAC5E,IAAI,IAAI,KAAK,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC;YAAE,OAAO;QACxF,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,eAAe,CAAC,QAAkC,EAAE,IAAiB;QACjF,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,IAAI,0BAA0B,CAAC,QAAQ,CAAC,CAAC;QACvD,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;IAC3E,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,MAAM,CAClB,QAA0B,EAC1B,IAAiB,EACjB,aAA0B;QAE1B,MAAM,OAAO,GAAG,IAAI,KAAK,OAAO,CAAC;QACjC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QACvD,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QAC5C,aAAa,EAAE,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,WAAW;YAC7C,CAAC,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC;YAChD,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;YACxD,MAAM,IAAI,kBAAkB,CAAC,8DAA8D,CAAC,CAAC;QAC/F,CAAC;QACD,OAAO,gBAAgB,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED,sHAAsH;IAC9G,WAAW,CAAC,QAA0B;QAC5C,MAAM,OAAO,GAAG,mBAAmB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACvD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC3E,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,YAAY;YAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC3F,KAAK,MAAM,OAAO,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACnG,CAAC;IAED,8GAA8G;IACtG,KAAK,CAAC,QAAQ,CAAC,QAAoC,EAAE,OAAgB;QAC3E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACrE,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM,eAAe,CAAC,8DAA8D,EAAE,aAAa,CAAC,CAAC;QACvG,CAAC;QACD,gHAAgH;QAChH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,IAAI,GAAG,KAAK,EAAE;YAAE,MAAM,IAAI,sBAAsB,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;QACxF,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,mHAAmH;IAC3G,gBAAgB,CAAC,QAAoC,EAAE,OAAgB;QAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACrC,OAAO,eAAe,CAAC,QAAQ,EAAE;YAC/B,GAAG,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;YAC7C,KAAK,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC;YAChE,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;gBACpB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YAC9C,CAAC;SACF,CAAC,CAAC,GAAG,EAAE,CAAC;IACX,CAAC;CACF;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,MAAiB,EAAE,GAAW;IAClD,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC;IAChC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACrD,MAAM,eAAe,CAAC,kBAAkB,MAAM,CAAC,IAAI,0BAA0B,GAAG,aAAa,EAAE,KAAK,CAAC,CAAC;IACxG,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,eAAe,CAAC,kBAAkB,MAAM,CAAC,IAAI,oBAAoB,EAAE,KAAK,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACnC,CAAC"}

package/dist/session/tan-selection.d.ts

@@ -1,40 +1,47 @@
 import { TanMethod, type TanMedium } from '../tan/tan-models.js';
-import { type BankResponse, type PinTanProtocol, type ProtocolDialog } from './protocol.js';
+import { FinTs3Dialog } from '../v3/dialog.js';
+import type { FinTs3Protocol } from '../v3/protocol.js';
 import type { SessionState } from './session-state.js';
 import type { UserPrompts } from './user-prompts.js';
 /**
  * The TAN method and medium the session's messages are signed with, chosen by the user among what the bank offers and
  * the user may use, and kept in the session state.
  */
-export declare class TanSelection<R extends BankResponse, O> {
+export declare class TanSelection {
     private readonly protocol;
     private readonly state;
     private readonly prompts;
-    /** TAN methods whose media were looked up in this session. A lookup is not repeated, even where it gave no medium. */
-    private readonly mediaLookedUp;
-    /** The list the last lookup gave, until `takeLookedUpMedia` hands it out. */
-    private lookedUpMedia;
+    /**
+     * The lookups of this session that found no medium to choose, by TAN method, with the list each gave; `undefined`
+     * where the bank gave none. Such a lookup is not repeated for its method until `select` or `forgetMedium` drops it.
+     */
+    private readonly lookupsWithoutMedium;
     /** Whether the bank refused a login signed with the one-step method in this session. */
     private oneStepRefused;
-    constructor(protocol: PinTanProtocol<R, O>, state: SessionState, prompts: UserPrompts);
+    constructor(protocol: FinTs3Protocol, state: SessionState, prompts: UserPrompts);
     /** The TAN method in use; the one-step method until one is chosen. */
     get method(): TanMethod;
     /** Switches to `securityFunction` and `tanMedium` for the dialogs to come. */
     select(securityFunction: string, tanMedium: string | undefined): void;
+    /**
+     * Forgets the medium in use and the lookups of this session, so that the next login looks the media up anew where the
+     * method needs one: the bank may have refused the medium, such as that of a phone the user has replaced.
+     */
+    forgetMedium(): void;
     /**
      * A dialog signed with the TAN method in use and its medium.
      *
-     * Throws `FinTsUnsupportedError` if the method needs a medium the user has not chosen: the bank would refuse the
+     * Throws `FinTsTanSetupError` if the method needs a medium the user has not chosen: the bank would refuse the
      * login, and the client would not send the PIN again.
      */
-    newDialog(): ProtocolDialog<R, O>;
+    newDialog(): FinTs3Dialog;
     /**
      * The dialog that looks up the TAN media, signed with the TAN method in use.
      *
      * It runs before the medium is known, so it names a placeholder where the method needs one; the bank ignores the
      * medium in this dialog (PIN/TAN B.4.3.1.3).
      */
-    lookupDialog(): ProtocolDialog<R, O>;
+    lookupDialog(): FinTs3Dialog;
     /**
      * The synchronization dialog. It runs before the TAN media are looked up, so its method must do without a medium the
      * user has not chosen: the placeholder for one is meant for the lookup only (PIN/TAN B.4.3.1.3). The first method
@@ -44,16 +51,16 @@ export declare class TanSelection<R extends BankResponse, O> {
      *    a one-step login;
      * 3. another two-step method the user may use.
      *
-     * Throws `FinTsUnsupportedError` if none does, before the bank could refuse the login.
+     * Throws `FinTsTanSetupError` if none does, before the bank could refuse the login.
      */
-    synchronizationDialog(): ProtocolDialog<R, O>;
+    synchronizationDialog(): FinTs3Dialog;
     /** Whether `method` needs a medium the user has not chosen. */
     private lacksMedium;
     /**
      * The two-step TAN methods the bank offers, the user may use and this client can run; the one-step method if there
      * are none.
      *
-     * Throws `FinTsUnsupportedError` if the bank offers the user nothing but methods the client cannot run.
+     * Throws `FinTsTanSetupError` if the bank offers the user nothing but methods the client cannot run.
      */
     available(): TanMethod[];
     /**
@@ -67,7 +74,7 @@ export declare class TanSelection<R extends BankResponse, O> {
     ensureMethodChosen(): Promise<void>;
     /**
      * Whether the media of the method in use have to be looked up: it needs a medium the user has not chosen, and they
-     * were not looked up for it in this session.
+     * were not looked up in vain for it in this session.
      */
     get mediumToLookUp(): boolean;
     /**
@@ -76,12 +83,13 @@ export declare class TanSelection<R extends BankResponse, O> {
      */
     chooseMedium(media: TanMedium[] | undefined): Promise<void>;
     /**
-     * The list of the last lookup, once; `undefined` if there was none since the last time.
+     * The list of the lookup that found no medium for the method in use; `undefined` where there was none, or the bank
+     * gave no list.
      *
-     * `getTanMedia` takes it, so that the list is not asked for twice in a row. It also outlasts a call that failed for
-     * want of an active medium, so that the app can show the user the list that tells why; later calls ask anew.
+     * It outlasts the call that failed for want of the medium, so that `getTanMedia` can show the user the list that tells
+     * why: the client neither looks the media up again for the method nor can list them in a dialog without a medium.
      */
-    takeLookedUpMedia(): TanMedium[] | undefined;
+    get lookedUpMedia(): TanMedium[] | undefined;
     /** The name of the medium the user chooses among the active ones in `media`; `undefined` if none is active. */
     private chooseMediumOf;
 }