@coderoftime/fints 0.0.0-stage → 0.2.0

package/dist/session/session-setup.js

@@ -0,0 +1,182 @@
+import { FinTsError, FinTsProtocolError, FinTsTransportError, parseBankData, tryLookUp } from '../core/errors.js';
+import { hasErrors } from '../core/feedback.js';
+import { FinTs3Dialog } from '../v3/dialog.js';
+import { requireBankParameters } from '../v3/parameters.js';
+import { tanMediaQuery } from '../v3/queries.js';
+import { SignedDialog } from './signed-dialog.js';
+/**
+ * What has to be settled before a login: the bank parameter data, the synchronization, and through `TanSelection` the
+ * TAN method and medium. Each of the dialogs this takes serves one purpose only.
+ *
+ * Where the bank refuses a login for a reason the session can take care of, `remedied` does so and logs in again.
+ */
+export class SessionSetup {
+    session;
+    protocol;
+    tans;
+    constructor(session, protocol, tans) {
+        this.session = session;
+        this.protocol = protocol;
+        this.tans = tans;
+    }
+    /**
+     * The bank's general information: from an anonymous dialog where the bank answers one, else from the synchronization.
+     * No TAN method or medium is chosen for it.
+     */
+    async bankInfo() {
+        if (this.session.parameters.bankParameters === undefined)
+            await this.fetchBankParametersAnonymously();
+        if (this.session.parameters.bankParameters === undefined)
+            await this.synchronizeIfDue();
+        return requireBankParameters(this.session.parameters.bankParameters).bankInfo;
+    }
+    /** The TAN methods the bank allows for this user, which the synchronization reports. */
+    async methods() {
+        await this.loadParameters();
+        return this.tans.available();
+    }
+    /**
+     * Settles what is still open: the bank parameter data, the synchronization, the TAN method and medium. Returns the TAN
+     * media it looked up to choose the medium; `undefined` where it looked up none, or the bank listed none.
+     */
+    async prepare() {
+        await this.loadParameters();
+        await this.tans.ensureMethodChosen();
+        if (!this.tans.mediumToLookUp)
+            return undefined;
+        const media = await this.lookUpTanMedia();
+        await this.tans.chooseMedium(media);
+        return media;
+    }
+    /** A new dialog signed with the TAN method and medium in use, once `prepare` has settled them. */
+    async newDialog() {
+        await this.prepare();
+        return new SignedDialog(this.tans.newDialog(), this.session);
+    }
+    /** Runs `attempt`, which may log in, once more after each refused login `remedy` takes care of. */
+    remedied(attempt) {
+        return this.session.guard.remedied(attempt, (reason, rejected) => this.remedy(reason, rejected));
+    }
+    /**
+     * Takes care of `reason`, given for refusing a login signed with `rejected`, with another TAN method or a new
+     * synchronization; returns whether it could.
+     */
+    async remedy(reason, rejected) {
+        switch (reason) {
+            case 'tanMethodNotAllowed':
+                // The parameter data name the methods to choose from; the refusal may be the first to deliver them.
+                if (this.session.parameters.bankParameters === undefined)
+                    await this.fetchBankParametersAnonymously();
+                return this.tans.replace(rejected);
+            case 'systemIdRejected':
+                // Without a customer system ID there is none to lose, and logging in once more would only send the PIN again.
+                return this.session.parameters.forgetSystemId();
+        }
+    }
+    /**
+     * Loads the bank parameter data if they are missing, then synchronizes if that is due.
+     *
+     * The bank parameter data come first, from an anonymous dialog: the dialogs signed with the PIN need them for the
+     * dialog language, the PIN length and the TAN methods (PIN/TAN B.4.3.1, Formals C.3.1.3). A bank that does not answer
+     * anonymously delivers them with the synchronization.
+     *
+     * After a refused login it throws the refusal right away, before the user is asked for a TAN method or medium.
+     */
+    async loadParameters() {
+        this.session.guard.check();
+        if (this.session.parameters.bankParameters === undefined)
+            await this.fetchBankParametersAnonymously();
+        await this.synchronizeIfDue();
+    }
+    /**
+     * Asks for the bank parameter data without logging in, keeps them where there are none from a dialog signed with the
+     * PIN (`ParameterStore.keepAnonymous`), and passes the bank's messages on: all an anonymous dialog tells, since the
+     * TAN methods it lists are not those of a user. A bank that does not answer anonymously is no error, but a failed
+     * connection is: the synchronization would only wait for the same server again.
+     */
+    async fetchBankParametersAnonymously() {
+        try {
+            const response = await this.requestBankParametersAnonymously();
+            this.session.parameters.keepAnonymous(response);
+            for (const message of response.bankMessages)
+                this.session.prompts.showBankMessage(message);
+        }
+        catch (error) {
+            // Optional: the login delivers the parameters as well.
+            if (error instanceof FinTsTransportError || !(error instanceof FinTsError))
+                throw error;
+        }
+    }
+    /**
+     * 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.
+     *
+     * A timeout or a broken connection is not a reason to ask again: it would only double the wait.
+     */
+    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.protocol);
+        try {
+            return await dialog.requestBankParameters(announceSca);
+        }
+        finally {
+            await dialog.end();
+        }
+    }
+    /**
+     * Runs the synchronization, a login in a dialog of its own, while there is no customer system ID, without which no
+     * regular dialog starts. It runs before the TAN method and medium are settled (`TanSelection.synchronizationDialog`
+     * tells which method signs it).
+     */
+    async synchronizeIfDue() {
+        if (this.session.parameters.systemId !== undefined)
+            return;
+        await this.once(this.tans.synchronizationDialog(), (dialog) => dialog.login(true));
+        // Set by the synchronization, which the compiler cannot see.
+        if (this.session.parameters.systemId === undefined) {
+            throw new FinTsProtocolError('The bank did not complete the synchronization');
+        }
+    }
+    /**
+     * The TAN media of the method in use; `undefined` if the bank does not list them or rejects the list, after which the
+     * client reports a missing medium before the login.
+     *
+     * The lookup runs in a dialog of its own, whose start asks for the list, since the regular dialog start needs the
+     * medium the list tells (PIN/TAN B.4.3.1.3).
+     */
+    async lookUpTanMedia() {
+        const query = tanMediaQuery(this.session.parameters);
+        if (query === undefined)
+            return undefined;
+        return tryLookUp(() => this.once(this.tans.lookupDialog(), async (dialog) => {
+            const answers = await dialog.loginWith(query.order(undefined));
+            return parseBankData(() => query.read(answers));
+        }));
+    }
+    /** Runs `use` in `dialog`, a dialog of its own, and ends it afterwards, however `use` ends. */
+    async once(dialog, use) {
+        const signed = new SignedDialog(dialog, this.session);
+        try {
+            return await use(signed);
+        }
+        finally {
+            await signed.end();
+        }
+    }
+}
+//# sourceMappingURL=session-setup.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,50 @@
+import { Account } from '../core/account.js';
+import { type JsonObject } from '../util/json.js';
+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 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. The refused login belongs to the user at the bank, so it comes first: it holds
+ * for another server or protocol version as well, and where the rest is damaged; a state saved by the Dart package or
+ * an earlier version has none.
+ */
+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.
+ */
+export declare class SessionState {
+    private allowedMethodsValue;
+    private tanMethodValue;
+    private tanMediumValue;
+    private sepaAccountsValue;
+    private sepaUpdVersion;
+    /** TAN methods the bank allows for this user (return code 3920); `undefined` until the bank has said. */
+    get allowedMethods(): readonly string[] | undefined;
+    /** Security function of the TAN method in use. */
+    get tanMethod(): string | undefined;
+    /** Name of the TAN medium in use. */
+    get tanMedium(): string | undefined;
+    /** Keeps the TAN methods the bank reports as allowed for this user. */
+    rememberAllowedMethods(securityFunctions: readonly string[]): void;
+    /**
+     * Switches to the TAN method `securityFunction` and the TAN `medium` together, so that no medium of another method
+     * stays behind; `undefined` leaves the choice to the next login.
+     */
+    useTanMethod(securityFunction: string | undefined, medium?: string): void;
+    /** Switches to the TAN `medium` of the method in use. */
+    useTanMedium(medium: string | undefined): void;
+    /** The SEPA account list read under the user parameter data of `updVersion`, if it is cached. */
+    sepaAccounts(updVersion: number | undefined): readonly Account[] | undefined;
+    /** Caches the SEPA account list `accounts`, read under the user parameter data of `updVersion`. */
+    cacheSepaAccounts(accounts: readonly Account[], updVersion: number | undefined): void;
+    /** Reads what `toJson` wrote; throws `FormatError` if `json` is damaged. */
+    static fromJson(json: JsonObject): SessionState;
+    /** The session as JSON data. */
+    toJson(): JsonObject;
+}
+//# sourceMappingURL=session-state.d.ts.map

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

@@ -0,0 +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;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;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,GAAG,YAAY,CAmBpH;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;IAW/C,gCAAgC;IAChC,MAAM,IAAI,UAAU;CASrB"}

package/dist/session/session-state.js

@@ -0,0 +1,182 @@
+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, 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, 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(parameters.config),
+        session: session.toJson(),
+        // Under the key the Dart package reads as well.
+        protocol: parameters.saveState(),
+        loginGuard: guardStateToJson(guard.saveState()),
+    });
+}
+/**
+ * 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. The refused login belongs to the user at the bank, so it comes first: it holds
+ * for another server or protocol version as well, and where the rest is damaged; a state saved by the Dart package or
+ * an earlier version has none.
+ */
+export function restoreSession(json, parameters, guard) {
+    if (json === undefined)
+        return new SessionState();
+    try {
+        const saved = JSON.parse(json);
+        if (!isJsonObject(saved) || saved.format !== stateFormat)
+            return new SessionState();
+        const [server, ...user] = readOptionalList(saved, 'owner', isString) ?? [];
+        const expected = userOf(parameters.config);
+        if (user.length !== expected.length || user.some((value, i) => value !== expected[i]))
+            return new SessionState();
+        const loginGuard = readOptionalObject(saved, 'loginGuard');
+        if (loginGuard !== undefined)
+            guard.restoreState(guardStateFromJson(loginGuard));
+        if (server !== hostOf(parameters.config.url) || saved.version !== protocolVersion)
+            return new SessionState();
+        const session = SessionState.fromJson(readObject(saved, 'session'));
+        parameters.restoreState(readObject(saved, 'protocol'));
+        return session;
+    }
+    catch (error) {
+        // Damaged JSON, base64 or parameter data, and values of the wrong type, only cost a new synchronization.
+        if (error instanceof FormatError || error instanceof SyntaxError)
+            return new SessionState();
+        throw error;
+    }
+}
+/** 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), ...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
+ * account list.
+ */
+export class SessionState {
+    allowedMethodsValue;
+    tanMethodValue;
+    tanMediumValue;
+    sepaAccountsValue;
+    sepaUpdVersion;
+    /** TAN methods the bank allows for this user (return code 3920); `undefined` until the bank has said. */
+    get allowedMethods() {
+        return this.allowedMethodsValue;
+    }
+    /** Security function of the TAN method in use. */
+    get tanMethod() {
+        return this.tanMethodValue;
+    }
+    /** Name of the TAN medium in use. */
+    get tanMedium() {
+        return this.tanMediumValue;
+    }
+    /** Keeps the TAN methods the bank reports as allowed for this user. */
+    rememberAllowedMethods(securityFunctions) {
+        this.allowedMethodsValue = Object.freeze([...securityFunctions]);
+    }
+    /**
+     * Switches to the TAN method `securityFunction` and the TAN `medium` together, so that no medium of another method
+     * stays behind; `undefined` leaves the choice to the next login.
+     */
+    useTanMethod(securityFunction, medium) {
+        this.tanMethodValue = securityFunction;
+        this.tanMediumValue = medium;
+    }
+    /** Switches to the TAN `medium` of the method in use. */
+    useTanMedium(medium) {
+        this.tanMediumValue = medium;
+    }
+    /** The SEPA account list read under the user parameter data of `updVersion`, if it is cached. */
+    sepaAccounts(updVersion) {
+        return updVersion !== undefined && updVersion === this.sepaUpdVersion ? this.sepaAccountsValue : undefined;
+    }
+    /** Caches the SEPA account list `accounts`, read under the user parameter data of `updVersion`. */
+    cacheSepaAccounts(accounts, updVersion) {
+        this.sepaAccountsValue = Object.freeze([...accounts]);
+        this.sepaUpdVersion = updVersion;
+    }
+    /** Reads what `toJson` wrote; throws `FormatError` if `json` is damaged. */
+    static fromJson(json) {
+        const allowedMethods = readOptionalList(json, 'allowedMethods', isString);
+        const sepaAccounts = readOptionalList(json, 'sepaAccounts', isJsonObject)?.map(accountFromJson);
+        const sepaUpdVersion = readOptionalInt(json, 'sepaUpdVersion');
+        const state = new SessionState();
+        state.useTanMethod(readOptionalString(json, 'tanMethod'), readOptionalString(json, 'tanMedium'));
+        if (allowedMethods !== undefined)
+            state.rememberAllowedMethods(allowedMethods);
+        if (sepaAccounts !== undefined)
+            state.cacheSepaAccounts(sepaAccounts, sepaUpdVersion);
+        return state;
+    }
+    /** The session as JSON data. */
+    toJson() {
+        return {
+            allowedMethods: this.allowedMethodsValue ?? null,
+            tanMethod: this.tanMethodValue ?? null,
+            tanMedium: this.tanMediumValue ?? null,
+            sepaUpdVersion: this.sepaUpdVersion ?? null,
+            sepaAccounts: this.sepaAccountsValue?.map(accountToJson) ?? null,
+        };
+    }
+}
+function accountToJson(a) {
+    return {
+        iban: a.iban ?? null,
+        bic: a.bic ?? null,
+        accountNumber: a.accountNumber ?? null,
+        subAccount: a.subAccount ?? null,
+        countryCode: a.countryCode,
+        bankCode: a.bankCode,
+    };
+}
+function accountFromJson(json) {
+    const bankCode = readOptionalString(json, 'bankCode');
+    if (bankCode === undefined)
+        throw new FormatError('Saved state: account without bank code');
+    return new Account({
+        iban: readOptionalString(json, 'iban'),
+        bic: readOptionalString(json, 'bic'),
+        accountNumber: readOptionalString(json, 'accountNumber'),
+        subAccount: readOptionalString(json, 'subAccount'),
+        countryCode: readOptionalString(json, 'countryCode'),
+        bankCode,
+    });
+}
+function guardStateToJson(state) {
+    return { refusal: state.refusal?.map(feedbackToJson) ?? null, unreadLogins: state.unreadLogins };
+}
+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

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.js","sourceRoot":"","sources":["../../src/session/session-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAoB,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,GAEnB,MAAM,iBAAiB,CAAC;AAIzB,yEAAyE;AACzE,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,wHAAwH;AACxH,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,qGAAqG;AACrG,MAAM,UAAU,WAAW,CAAC,UAA0B,EAAE,KAAiB,EAAE,OAAqB;IAC9F,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,eAAe;QACxB,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;QACjC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE;QACzB,gDAAgD;QAChD,QAAQ,EAAE,UAAU,CAAC,SAAS,EAAE;QAChC,UAAU,EAAE,gBAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;KAChD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAAwB,EAAE,UAA0B,EAAE,KAAiB;IACpG,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,YAAY,EAAE,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW;YAAE,OAAO,IAAI,YAAY,EAAE,CAAC;QACpF,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC3E,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,YAAY,EAAE,CAAC;QACjH,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAC3D,IAAI,UAAU,KAAK,SAAS;YAAE,KAAK,CAAC,YAAY,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC;QACjF,IAAI,MAAM,KAAK,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,KAAK,eAAe;YAAE,OAAO,IAAI,YAAY,EAAE,CAAC;QAC7G,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;QACpE,UAAU,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;QACvD,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yGAAyG;QACzG,IAAI,KAAK,YAAY,WAAW,IAAI,KAAK,YAAY,WAAW;YAAE,OAAO,IAAI,YAAY,EAAE,CAAC;QAC5F,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,oHAAoH;AACpH,SAAS,OAAO,CAAC,MAAmB;IAClC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,6DAA6D;AAC7D,SAAS,MAAM,CAAC,MAAmB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,mBAAmB,CAAgC;IACnD,cAAc,CAAqB;IACnC,cAAc,CAAqB;IACnC,iBAAiB,CAAiC;IAClD,cAAc,CAAqB;IAE3C,yGAAyG;IACzG,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,mBAAmB,CAAC;IAClC,CAAC;IAED,kDAAkD;IAClD,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,qCAAqC;IACrC,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,uEAAuE;IACvE,sBAAsB,CAAC,iBAAoC;QACzD,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,gBAAoC,EAAE,MAAe;QAChE,IAAI,CAAC,cAAc,GAAG,gBAAgB,CAAC;QACvC,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;IAC/B,CAAC;IAED,yDAAyD;IACzD,YAAY,CAAC,MAA0B;QACrC,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;IAC/B,CAAC;IAED,iGAAiG;IACjG,YAAY,CAAC,UAA8B;QACzC,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7G,CAAC;IAED,mGAAmG;IACnG,iBAAiB,CAAC,QAA4B,EAAE,UAA8B;QAC5E,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC;IACnC,CAAC;IAED,4EAA4E;IAC5E,MAAM,CAAC,QAAQ,CAAC,IAAgB;QAC9B,MAAM,cAAc,GAAG,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAC1E,MAAM,YAAY,GAAG,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;QAChG,MAAM,cAAc,GAAG,eAAe,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAC;QACjC,KAAK,CAAC,YAAY,CAAC,kBAAkB,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,kBAAkB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;QACjG,IAAI,cAAc,KAAK,SAAS;YAAE,KAAK,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC;QAC/E,IAAI,YAAY,KAAK,SAAS;YAAE,KAAK,CAAC,iBAAiB,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QACtF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gCAAgC;IAChC,MAAM;QACJ,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,mBAAmB,IAAI,IAAI;YAChD,SAAS,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;YACtC,SAAS,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;YACtC,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;YAC3C,YAAY,EAAE,IAAI,CAAC,iBAAiB,EAAE,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI;SACjE,CAAC;IACJ,CAAC;CACF;AAED,SAAS,aAAa,CAAC,CAAU;IAC/B,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI;QACpB,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,IAAI;QAClB,aAAa,EAAE,CAAC,CAAC,aAAa,IAAI,IAAI;QACtC,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;QAChC,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;KACrB,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,IAAgB;IACvC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACtD,IAAI,QAAQ,KAAK,SAAS;QAAE,MAAM,IAAI,WAAW,CAAC,wCAAwC,CAAC,CAAC;IAC5F,OAAO,IAAI,OAAO,CAAC;QACjB,IAAI,EAAE,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC;QACtC,GAAG,EAAE,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC;QACpC,aAAa,EAAE,kBAAkB,CAAC,IAAI,EAAE,eAAe,CAAC;QACxD,UAAU,EAAE,kBAAkB,CAAC,IAAI,EAAE,YAAY,CAAC;QAClD,WAAW,EAAE,kBAAkB,CAAC,IAAI,EAAE,aAAa,CAAC;QACpD,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAsB;IAC9C,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,cAAc,CAAC,IAAI,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC;AACnG,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAgB;IAC1C,OAAO;QACL,OAAO,EAAE,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,GAAG,CAAC,gBAAgB,CAAC;QAC/E,YAAY,EAAE,eAAe,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,CAAgB;IACtC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;AACvG,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAgB;IACxC,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9C,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,WAAW,CAAC,uCAAuC,CAAC,CAAC;IACvF,OAAO,IAAI,aAAa,CAAC;QACvB,IAAI;QACJ,SAAS,EAAE,kBAAkB,CAAC,IAAI,EAAE,WAAW,CAAC;QAChD,IAAI,EAAE,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;QAC5C,UAAU,EAAE,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE;KACjE,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,77 @@
+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`, the first page of a query, and completes the approval the bank asks for. */
+    send(order: SegmentSpec): Promise<IncomingMessage3>;
+    /**
+     * Sends `order` for a further page of a query (Formals B.6.3), whose answer must not ask for an approval: the client
+     * completes that of the first page only, so that a bank that asks anew for every page cannot prompt the user once per
+     * page. Throws `FinTsProtocolError` if it asks for one.
+     */
+    sendFurtherPage(order: SegmentSpec): 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;
+    /**
+     * Where `response` answers a login, a request of `kind` other than `order`, or its approval with new login data: ends
+     * the dialog, stops the client from logging in with the old ones, and fails the call with
+     * `FinTsLoginDataChangedError` (Rückmeldungscodes C.6). It runs before any approval, which would cost the user a TAN
+     * for a session that ends anyway. New login data next to an error are the login's refusal already
+     * (`loginRefusalFor`).
+     */
+    private retireOldLoginData;
+    /**
+     * Receives `response`, the answer to a request of `kind`, then completes the approval it asks for; 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":"AAUA,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;IAChG,KAAK,CAAC,WAAW,UAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI3D;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAMhE,8FAA8F;IACxF,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIzD;;;;OAIG;IACG,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IASpE;;;OAGG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAO1B;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAUf;;;;;;OAMG;YACW,kBAAkB;IAOhC;;;;;;OAMG;YACW,MAAM;IAgBpB,sHAAsH;IACtH,OAAO,CAAC,WAAW;IAOnB,8GAA8G;YAChG,QAAQ;IAatB,mHAAmH;IACnH,OAAO,CAAC,gBAAgB;CAUzB"}