@coderoftime/fints 0.0.0-stage → 0.2.0

package/dist/client.js

@@ -0,0 +1,199 @@
+import { FinTsConfig, requirePin } from './core/config.js';
+import { FinTsStateError, FinTsUnsupportedError } from './core/errors.js';
+import { DialogRunner } from './session/dialog-runner.js';
+import { LoginGuard } from './session/login-guard.js';
+import { SepaAccounts } from './session/sepa-accounts.js';
+import { SessionSetup } from './session/session-setup.js';
+import { restoreSession, saveSession } from './session/session-state.js';
+import { TanSelection } from './session/tan-selection.js';
+import { UserPrompts } from './session/user-prompts.js';
+import { TanMedium } from './tan/tan-models.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 { ParameterStore } from './v3/parameter-store.js';
+import { FinTs3Protocol } from './v3/protocol.js';
+import { balanceQuery, tanMediaQuery, transactionsQuery } from './v3/queries.js';
+/** A token of the client call running now, so that a call from inside its callbacks is recognized. */
+const runningCalls = new CallContext();
+/**
+ * The calendar day of `bound`, the `name` bound of a `TransactionQuery`: the bank takes dates without time of day.
+ * Throws `TypeError` for anything but a valid `Date`, such as an Invalid Date, which would go out as `0NaNNaNNaN`.
+ */
+function requestedDay(bound, name) {
+    if (bound === undefined)
+        return undefined;
+    if (!(bound instanceof Date) || Number.isNaN(bound.getTime()))
+        throw invalidArgument('Not a valid Date', name);
+    return calendarDay(bound);
+}
+/** FinTS 3.0 PIN/TAN client, the version German banks use. */
+export class FinTs3Client {
+    // 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. `SignedDialog.login` 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.
+    //
+    // `FinTs3Protocol` builds, signs and posts the messages of each `FinTs3Dialog`, the queries build the orders and read
+    // the answers, and the `ParameterStore` keeps the bank's parameter data and IDs. `SepaAccounts` completes IBAN and
+    // BIC, and `UserPrompts` is everything the app is told or asked. The `LoginGuard` holds the PIN: the protocol takes it
+    // from the guard for every message it signs, and `SignedDialog` has the guard judge every answer, so that the PIN does
+    // not go out after a refusal.
+    //
+    // The fields are ECMAScript private, so that neither `util.inspect` nor `JSON.stringify` of a client reaches the PIN
+    // or the account data behind them.
+    #prompts;
+    #guard;
+    #parameters;
+    #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 with the session restored from `FinTsClientOptions.state` where it was saved for this user and bank.
+     *
+     * Throws `TypeError` if the configuration is invalid, as the constructor of `FinTsConfig` tells, or the PIN is empty,
+     * begins or ends with a blank, or has characters FinTS 3.0 cannot send: it uses ISO 8859-1, so `€` and most
+     * non-Latin letters are not possible.
+     */
+    constructor(init) {
+        const config = init.config instanceof FinTsConfig ? init.config : new FinTsConfig(init.config);
+        this.#prompts = new UserPrompts(init.options);
+        this.#guard = new LoginGuard(requirePin(init.pin));
+        this.#parameters = new ParameterStore(config);
+        this.#protocol = new FinTs3Protocol(this.#parameters, this.#guard, init.options.transport, this.#prompts.logger);
+        this.#sessionState = restoreSession(init.options.state, this.#parameters, this.#guard);
+        this.#tans = new TanSelection(this.#protocol, this.#sessionState, this.#prompts);
+        const session = {
+            parameters: this.#parameters,
+            state: this.#sessionState,
+            prompts: this.#prompts,
+            guard: this.#guard,
+        };
+        this.#setup = new SessionSetup(session, this.#protocol, this.#tans);
+        this.#dialogs = new DialogRunner(this.#setup);
+        this.#sepa = new SepaAccounts(this.#parameters, this.#sessionState, this.#dialogs);
+    }
+    get state() {
+        return saveSession(this.#parameters, this.#guard, this.#sessionState);
+    }
+    get loginRefusal() {
+        return this.#guard.refusal;
+    }
+    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);
+        });
+    }
+    clearLoginRefusal(pin) {
+        return this.#serialized(async () => {
+            const sendable = requirePin(pin);
+            // The dialog ends with the PIN it was opened with.
+            await this.#dialogs.end();
+            this.#guard.replacePin(sendable);
+            this.#tans.forgetMedium();
+        });
+    }
+    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 () => {
+            // The session keeps the list of a lookup that found no medium; the app gets media of its own.
+            const lookedUp = (await this.#setup.remedied(() => this.#setup.prepare())) ?? this.#tans.lookedUpMedia;
+            return (lookedUp?.map((m) => new TanMedium(m)) ??
+                (await this.#dialogs.query(() => {
+                    const query = tanMediaQuery(this.#parameters);
+                    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.#parameters.userParameters?.completeBalance(completed) ??
+                (await this.#dialogs.query(() => balanceQuery(this.#parameters, completed))));
+        });
+    }
+    async getTransactions(account, query = {}) {
+        // Checked before the call waits for others; an async method, so that every argument error is a rejection.
+        const firstDay = requestedDay(query.from, 'from');
+        const lastDay = requestedDay(query.to, 'to');
+        if (firstDay !== undefined && lastDay !== undefined && firstDay.getTime() > lastDay.getTime()) {
+            throw 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(() => transactionsQuery(this.#parameters, 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();
+        this.#protocol.beginClose();
+        return this.#queue.run(() => this.#prompts.reportingCallbackErrors(async () => {
+            try {
+                await this.#dialogs.end();
+            }
+            finally {
+                this.#guard.close();
+                this.#protocol.close();
+            }
+        }));
+    }
+    #serialized(action) {
+        const caller = runningCalls.current;
+        if (caller !== undefined && 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 = {};
+            this.#runningCall = call;
+            try {
+                return await runningCalls.run(call, () => this.#guard.runCall(() => {
+                    this.#prompts.checkOpen();
+                    return this.#prompts.reportingCallbackErrors(action);
+                }));
+            }
+            finally {
+                this.#runningCall = undefined;
+            }
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAwB,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAA+B,MAAM,kBAAkB,CAAC;AAEvG,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAqB,MAAM,4BAA4B,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAkB,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAiBjF,sGAAsG;AACtG,MAAM,YAAY,GAAG,IAAI,WAAW,EAAU,CAAC;AAE/C;;;GAGG;AACH,SAAS,YAAY,CAAC,KAAc,EAAE,IAAY;IAChD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,CAAC,KAAK,YAAY,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAAE,MAAM,eAAe,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IAC/G,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,8DAA8D;AAC9D,MAAM,OAAO,YAAY;IACvB,wDAAwD;IACxD,qHAAqH;IACrH,gDAAgD;IAChD,kHAAkH;IAClH,+CAA+C;IAC/C,qHAAqH;IACrH,mCAAmC;IACnC,sHAAsH;IACtH,EAAE;IACF,sHAAsH;IACtH,mHAAmH;IACnH,uHAAuH;IACvH,uHAAuH;IACvH,8BAA8B;IAC9B,EAAE;IACF,qHAAqH;IACrH,mCAAmC;IAE1B,QAAQ,CAAc;IACtB,MAAM,CAAa;IACnB,WAAW,CAAiB;IAC5B,SAAS,CAAiB;IAC1B,aAAa,CAAe;IAC5B,KAAK,CAAe;IACpB,MAAM,CAAe;IACrB,QAAQ,CAAe;IACvB,KAAK,CAAe;IACpB,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;IACvC,OAAO,CAA4B;IAEnC,mFAAmF;IACnF,YAAY,CAAqB;IAEjC;;;;;;OAMG;IACH,YAAY,IAAsB;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,YAAY,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/F,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,WAAW,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjH,IAAI,CAAC,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACvF,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjF,MAAM,OAAO,GAAG;YACd,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,KAAK,EAAE,IAAI,CAAC,aAAa;YACzB,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,KAAK,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACpE,IAAI,CAAC,QAAQ,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,KAAK;QACP,OAAO,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC;IACtC,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC;IACtC,CAAC;IAED,eAAe,CAAC,gBAAwB,EAAE,SAAkB;QAC1D,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE;YACjC,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,iBAAiB,CAAC,GAAW;QAC3B,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE;YACjC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YACjC,mDAAmD;YACnD,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACpF,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE;YACjC,8FAA8F;YAC9F,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;YACvG,OAAO,CACL,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC;gBACtC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE;oBAC9B,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;oBAC9C,IAAI,KAAK,KAAK,SAAS;wBAAE,MAAM,IAAI,qBAAqB,CAAC,kCAAkC,CAAC,CAAC;oBAC7F,OAAO,KAAK,CAAC;gBACf,CAAC,CAAC,CAAC,CACJ,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,UAAU,CAAC,OAAgB;QACzB,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE;YACjC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACrD,gHAAgH;YAChH,sDAAsD;YACtD,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC3B,OAAO,CACL,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,eAAe,CAAC,SAAS,CAAC;gBAC3D,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAC7E,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAgB,EAAE,QAA0B,EAAE;QAClE,0GAA0G;QAC1G,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9F,MAAM,eAAe,CAAC,iCAAiC,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE;YACjC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACrD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAClD,iBAAiB,CACf,IAAI,CAAC,WAAW,EAChB,SAAS,EACT,KAAK,CAAC,MAAM,IAAI,MAAM,EACtB,aAAa,CAAC,QAAQ,CAAC,EACvB,aAAa,CAAC,OAAO,CAAC,CACvB,CACF,CAAC;YACF,6EAA6E;YAC7E,OAAO,YAAY,CAAC,IAAI,CACtB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAC9F,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,SAAS;QACP,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAC1B,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,KAAK,IAAI,EAAE;YAC/C,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YAC5B,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACpB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,WAAW,CAAI,MAAwB;QACrC,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC;QACpC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;YACzD,oGAAoG;YACpG,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,8DAA8D,CAAC,CAAC,CAAC;QAC7G,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YAChC,MAAM,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,IAAI,CAAC;gBACH,OAAO,MAAM,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,CACvC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;oBACvB,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;oBAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;gBACvD,CAAC,CAAC,CACH,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/core/account.d.ts

@@ -0,0 +1,168 @@
+/** Account kind derived from the FinTS account type code. */
+export type AccountCategory = 
+/** Current account (type codes 1 to 9). */
+'checking'
+/** Savings account (10 to 19). */
+ | 'savings'
+/** Fixed-term deposit (20 to 29). */
+ | 'fixedDeposit'
+/** Securities account (30 to 39). */
+ | 'securities'
+/** Loan account (40 to 49). */
+ | 'loan'
+/** Credit card account (50 to 59). */
+ | 'creditCard'
+/** Fund deposit (60 to 69). */
+ | 'fund'
+/** Home savings contract (70 to 79). */
+ | 'homeSavings'
+/** Insurance (80 to 89). */
+ | 'insurance'
+/** Any other type code. */
+ | 'other'
+/** The bank states no type code. */
+ | 'unknown';
+/** What `Account` takes; the bank states the details it knows. */
+export interface AccountInit {
+    accountNumber?: string | undefined;
+    subAccount?: string | undefined;
+    bankCode: string;
+    countryCode?: string | undefined;
+    iban?: string | undefined;
+    bic?: string | undefined;
+    customerId?: string | undefined;
+    currency?: string | undefined;
+    ownerName?: string | undefined;
+    productName?: string | undefined;
+    typeCode?: number | undefined;
+    allowedTransactions?: readonly string[] | undefined;
+    allowedTransactionsComplete?: boolean | undefined;
+    dataStatus?: AccountDataStatus | undefined;
+}
+/**
+ * A bank account as reported by the user parameter data or the SEPA account query.
+ *
+ * An account the app builds itself, such as from a stored IBAN, stands for the one of `getAccounts` it `matches`:
+ * queries take the details the bank states of that one, and the transactions the bank permits for it. One the bank
+ * names nowhere goes out with its account number, sub-account, IBAN, BIC, bank and country code and currency only, and
+ * is refused with `FinTsUnsupportedError` where the bank's lists of permitted transactions are complete. Queries never
+ * take the permitted transactions from the app's account.
+ */
+export declare class Account {
+    /** National account number. */
+    readonly accountNumber: string | undefined;
+    /** Sub-account characteristic (Unterkontomerkmal). */
+    readonly subAccount: string | undefined;
+    /** German bank code (BLZ) of the bank holding the account. */
+    readonly bankCode: string;
+    /** Numeric country code of the bank, `280` for Germany. */
+    readonly countryCode: string;
+    /**
+     * International bank account number, in its electronic format: without blanks and in capitals, however
+     * `AccountInit.iban` wrote it, such as in groups of four as printed.
+     */
+    readonly iban: string | undefined;
+    /** Bank identifier code of the bank holding the account, without blanks and in capitals. */
+    readonly bic: string | undefined;
+    /** Customer ID the account is assigned to; may differ from the login name. */
+    readonly customerId: string | undefined;
+    /** Currency of the account, for example `EUR`. */
+    readonly currency: string | undefined;
+    /** Name of the account holder. */
+    readonly ownerName: string | undefined;
+    /** The bank's name for the account, for example `Girokonto`. */
+    readonly productName: string | undefined;
+    /** Raw FinTS account type (1–99); see `category`. */
+    readonly typeCode: number | undefined;
+    /**
+     * The transactions the bank lists as permitted for this account, by their segment IDs, such as `HKSAL`.
+     *
+     * The client applies them itself: `getBalance` and `getTransactions` do not send a query they rule out, and fail with
+     * `FinTsUnsupportedError`.
+     */
+    readonly allowedTransactions: readonly string[];
+    /**
+     * Whether `allowedTransactions` is complete: the bank permits nothing it does not list (FinTS "UPD-Verwendung" 0).
+     * Otherwise the bank's lists say nothing about a transaction they leave out, and only the bank can tell.
+     */
+    readonly allowedTransactionsComplete: boolean;
+    /** What the bank tells about the data it holds for the account, where it does. */
+    readonly dataStatus: AccountDataStatus | undefined;
+    /** Takes copies of the permitted transactions and the data status of `init`, which no other account shares. */
+    constructor(init: AccountInit);
+    /** The kind of account, derived from `typeCode`. */
+    get category(): AccountCategory;
+    /**
+     * Whether `other` is the same account: by IBAN when both have one, otherwise by account number, sub-account and
+     * bank.
+     *
+     * Account numbers are compared without leading zeros, since banks pad them differently. An empty bank or country
+     * code, as of a balance record without bank identification, matches any.
+     */
+    matches(other: Account): boolean;
+    /** This account with the given details replaced; a detail that is `undefined` stays as it is. */
+    copyWith(changes: Omit<Partial<AccountInit>, 'bankCode' | 'countryCode'>): Account;
+    /**
+     * The product name and the last digits of the IBAN or account number only, so that logs and crash reports do not
+     * collect account data.
+     */
+    toString(): string;
+}
+/**
+ * Accounts by IBAN and by national account, to find the first one an account `matches` without comparing it with each:
+ * a bank may list tens of thousands.
+ *
+ * Bank and country codes count as they are, where `matches` takes an empty one for any: the accounts a bank lists state
+ * both.
+ */
+export declare class AccountIndex {
+    private readonly accounts;
+    private readonly byIban;
+    private readonly byNational;
+    /** Those without IBAN only: an account with IBAN matches one with IBAN by that alone. */
+    private readonly byNationalWithoutIban;
+    constructor(accounts: readonly Account[]);
+    /** The first of the accounts that `account` matches. */
+    find(account: Account): Account | undefined;
+}
+/**
+ * What the bank tells about the data it holds for an account, so that an app asks only for what has changed (FinTS 3.0
+ * user parameter data, "Erweiterung, kontobezogen", Formals E.3.1 and F).
+ *
+ * The rules are binding for an app that stores transactions; banks may refuse an app that ignores them:
+ * - Do not fetch the transactions again while the bank names the ID they were stored with (`mt940TransactionsId` or
+ *   `camtTransactionsId`, for the format the app asked for, so pass `format` to `getTransactions` explicitly), or, in
+ *   the older format, the timestamp `lastTransactions`.
+ * - Do not fetch them before `nextTransactionsAt`.
+ * - Do not ask for the balance separately where `transactionBalancesCurrent` says that the transactions carry the
+ *   current one.
+ */
+export declare class AccountDataStatus {
+    /**
+     * IDs of the data the bank holds for the user, keyed by the segment ID of the query that fetches them, for example
+     * `HKKAZ` (transactions as MT940) or `HKCAZ` (as camt): the data have changed when the ID changes. An empty ID means
+     * that the user has no such data; a query the map leaves out, that the bank tells nothing about it.
+     */
+    readonly inventory: ReadonlyMap<string, string>;
+    /**
+     * The timestamp of the last transactions the bank provided, in the older format of the extension (`umsltzt`);
+     * compared like an ID in `inventory`.
+     */
+    readonly lastTransactions: string | undefined;
+    /** The moment before which the bank provides no new transactions. */
+    readonly nextTransactionsAt: Date | undefined;
+    /** Whether the balances the transactions carry are the current ones. */
+    readonly transactionBalancesCurrent: boolean;
+    /** Takes copies of the inventory and the date of `init`, which no other status shares. */
+    constructor(init: {
+        inventory?: ReadonlyMap<string, string>;
+        lastTransactions?: string | undefined;
+        nextTransactionsAt?: Date | undefined;
+        transactionBalancesCurrent?: boolean;
+    });
+    /** The ID of the transactions the bank holds as MT940, its entry for `HKKAZ` in `inventory`. */
+    get mt940TransactionsId(): string | undefined;
+    /** The ID of the transactions the bank holds as camt, its entry for `HKCAZ` in `inventory`. */
+    get camtTransactionsId(): string | undefined;
+}
+//# sourceMappingURL=account.d.ts.map

package/dist/core/account.d.ts.map

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

package/dist/core/account.js

@@ -0,0 +1,245 @@
+import { copyDate } from '../util/dates.js';
+import { ImmutableMap } from '../util/immutable-map.js';
+import { maskedId, nonBlank } from '../util/text.js';
+import { defaultCountryCode } from './config.js';
+const categoriesByTens = [
+    'checking',
+    'savings',
+    'fixedDeposit',
+    'securities',
+    'loan',
+    'creditCard',
+    'fund',
+    'homeSavings',
+    'insurance',
+];
+/** The category of the FinTS account type `code`, which is `undefined` if the bank states none. */
+function accountCategoryOf(code) {
+    if (code === undefined || code < 1)
+        return 'unknown';
+    return categoriesByTens[Math.floor(code / 10)] ?? 'other';
+}
+/**
+ * A bank account as reported by the user parameter data or the SEPA account query.
+ *
+ * An account the app builds itself, such as from a stored IBAN, stands for the one of `getAccounts` it `matches`:
+ * queries take the details the bank states of that one, and the transactions the bank permits for it. One the bank
+ * names nowhere goes out with its account number, sub-account, IBAN, BIC, bank and country code and currency only, and
+ * is refused with `FinTsUnsupportedError` where the bank's lists of permitted transactions are complete. Queries never
+ * take the permitted transactions from the app's account.
+ */
+export class Account {
+    /** National account number. */
+    accountNumber;
+    /** Sub-account characteristic (Unterkontomerkmal). */
+    subAccount;
+    /** German bank code (BLZ) of the bank holding the account. */
+    bankCode;
+    /** Numeric country code of the bank, `280` for Germany. */
+    countryCode;
+    /**
+     * International bank account number, in its electronic format: without blanks and in capitals, however
+     * `AccountInit.iban` wrote it, such as in groups of four as printed.
+     */
+    iban;
+    /** Bank identifier code of the bank holding the account, without blanks and in capitals. */
+    bic;
+    /** Customer ID the account is assigned to; may differ from the login name. */
+    customerId;
+    /** Currency of the account, for example `EUR`. */
+    currency;
+    /** Name of the account holder. */
+    ownerName;
+    /** The bank's name for the account, for example `Girokonto`. */
+    productName;
+    /** Raw FinTS account type (1–99); see `category`. */
+    typeCode;
+    /**
+     * The transactions the bank lists as permitted for this account, by their segment IDs, such as `HKSAL`.
+     *
+     * The client applies them itself: `getBalance` and `getTransactions` do not send a query they rule out, and fail with
+     * `FinTsUnsupportedError`.
+     */
+    allowedTransactions;
+    /**
+     * Whether `allowedTransactions` is complete: the bank permits nothing it does not list (FinTS "UPD-Verwendung" 0).
+     * Otherwise the bank's lists say nothing about a transaction they leave out, and only the bank can tell.
+     */
+    allowedTransactionsComplete;
+    /** What the bank tells about the data it holds for the account, where it does. */
+    dataStatus;
+    /** Takes copies of the permitted transactions and the data status of `init`, which no other account shares. */
+    constructor(init) {
+        this.accountNumber = init.accountNumber;
+        this.subAccount = init.subAccount;
+        this.bankCode = init.bankCode;
+        this.countryCode = init.countryCode ?? defaultCountryCode;
+        this.iban = electronicFormat(init.iban);
+        this.bic = electronicFormat(init.bic);
+        this.customerId = init.customerId;
+        this.currency = init.currency;
+        this.ownerName = init.ownerName;
+        this.productName = init.productName;
+        this.typeCode = init.typeCode;
+        this.allowedTransactions = Object.freeze([...(init.allowedTransactions ?? [])]);
+        this.allowedTransactionsComplete = init.allowedTransactionsComplete ?? false;
+        this.dataStatus = init.dataStatus && new AccountDataStatus(init.dataStatus);
+    }
+    /** The kind of account, derived from `typeCode`. */
+    get category() {
+        return accountCategoryOf(this.typeCode);
+    }
+    /**
+     * Whether `other` is the same account: by IBAN when both have one, otherwise by account number, sub-account and
+     * bank.
+     *
+     * Account numbers are compared without leading zeros, since banks pad them differently. An empty bank or country
+     * code, as of a balance record without bank identification, matches any.
+     */
+    matches(other) {
+        if (this.iban !== undefined && other.iban !== undefined)
+            return this.iban === other.iban;
+        const number = nationalNumber(this);
+        return (number !== undefined &&
+            number === nationalNumber(other) &&
+            (this.subAccount ?? '') === (other.subAccount ?? '') &&
+            sameOrUnstated(this.bankCode, other.bankCode) &&
+            sameOrUnstated(this.countryCode, other.countryCode));
+    }
+    /** This account with the given details replaced; a detail that is `undefined` stays as it is. */
+    copyWith(changes) {
+        return new Account({
+            accountNumber: changes.accountNumber ?? this.accountNumber,
+            subAccount: changes.subAccount ?? this.subAccount,
+            bankCode: this.bankCode,
+            countryCode: this.countryCode,
+            iban: changes.iban ?? this.iban,
+            bic: changes.bic ?? this.bic,
+            customerId: changes.customerId ?? this.customerId,
+            currency: changes.currency ?? this.currency,
+            ownerName: changes.ownerName ?? this.ownerName,
+            productName: changes.productName ?? this.productName,
+            typeCode: changes.typeCode ?? this.typeCode,
+            allowedTransactions: changes.allowedTransactions ?? this.allowedTransactions,
+            allowedTransactionsComplete: changes.allowedTransactionsComplete ?? this.allowedTransactionsComplete,
+            dataStatus: changes.dataStatus ?? this.dataStatus,
+        });
+    }
+    /**
+     * The product name and the last digits of the IBAN or account number only, so that logs and crash reports do not
+     * collect account data.
+     */
+    toString() {
+        const id = this.iban ?? this.accountNumber;
+        const parts = [
+            ...(id === undefined ? [] : [maskedId(id)]),
+            ...(this.productName === undefined ? [] : [this.productName]),
+        ];
+        return `Account(${parts.join(', ')})`;
+    }
+}
+/**
+ * An IBAN or BIC in the form the bank sends and compares, without blanks and in capitals; `undefined` for blanks only.
+ */
+function electronicFormat(code) {
+    return nonBlank(code?.replace(/\s/g, '').toUpperCase());
+}
+function sameOrUnstated(a, b) {
+    return a === '' || b === '' || a === b;
+}
+/** The account number as `Account.matches` compares it: without leading zeros. */
+function nationalNumber(account) {
+    return account.accountNumber?.replace(/^0+/, '');
+}
+/**
+ * Accounts by IBAN and by national account, to find the first one an account `matches` without comparing it with each:
+ * a bank may list tens of thousands.
+ *
+ * Bank and country codes count as they are, where `matches` takes an empty one for any: the accounts a bank lists state
+ * both.
+ */
+export class AccountIndex {
+    accounts;
+    byIban = new Map();
+    byNational = new Map();
+    /** Those without IBAN only: an account with IBAN matches one with IBAN by that alone. */
+    byNationalWithoutIban = new Map();
+    constructor(accounts) {
+        this.accounts = accounts;
+        accounts.forEach((account, i) => {
+            const national = nationalKey(account);
+            if (account.iban !== undefined)
+                keepFirst(this.byIban, account.iban, i);
+            if (national === undefined)
+                return;
+            keepFirst(this.byNational, national, i);
+            if (account.iban === undefined)
+                keepFirst(this.byNationalWithoutIban, national, i);
+        });
+    }
+    /** The first of the accounts that `account` matches. */
+    find(account) {
+        const national = nationalKey(account);
+        const byNational = account.iban === undefined ? this.byNational : this.byNationalWithoutIban;
+        const found = [
+            account.iban === undefined ? undefined : this.byIban.get(account.iban),
+            national === undefined ? undefined : byNational.get(national),
+        ].filter((i) => i !== undefined);
+        return found.length === 0 ? undefined : this.accounts[Math.min(...found)];
+    }
+}
+function nationalKey(account) {
+    const number = nationalNumber(account);
+    return number === undefined
+        ? undefined
+        : JSON.stringify([number, account.subAccount ?? '', account.bankCode, account.countryCode]);
+}
+function keepFirst(index, key, position) {
+    if (!index.has(key))
+        index.set(key, position);
+}
+/**
+ * What the bank tells about the data it holds for an account, so that an app asks only for what has changed (FinTS 3.0
+ * user parameter data, "Erweiterung, kontobezogen", Formals E.3.1 and F).
+ *
+ * The rules are binding for an app that stores transactions; banks may refuse an app that ignores them:
+ * - Do not fetch the transactions again while the bank names the ID they were stored with (`mt940TransactionsId` or
+ *   `camtTransactionsId`, for the format the app asked for, so pass `format` to `getTransactions` explicitly), or, in
+ *   the older format, the timestamp `lastTransactions`.
+ * - Do not fetch them before `nextTransactionsAt`.
+ * - Do not ask for the balance separately where `transactionBalancesCurrent` says that the transactions carry the
+ *   current one.
+ */
+export class AccountDataStatus {
+    /**
+     * IDs of the data the bank holds for the user, keyed by the segment ID of the query that fetches them, for example
+     * `HKKAZ` (transactions as MT940) or `HKCAZ` (as camt): the data have changed when the ID changes. An empty ID means
+     * that the user has no such data; a query the map leaves out, that the bank tells nothing about it.
+     */
+    inventory;
+    /**
+     * The timestamp of the last transactions the bank provided, in the older format of the extension (`umsltzt`);
+     * compared like an ID in `inventory`.
+     */
+    lastTransactions;
+    /** The moment before which the bank provides no new transactions. */
+    nextTransactionsAt;
+    /** Whether the balances the transactions carry are the current ones. */
+    transactionBalancesCurrent;
+    /** Takes copies of the inventory and the date of `init`, which no other status shares. */
+    constructor(init) {
+        this.inventory = new ImmutableMap(init.inventory ?? []);
+        this.lastTransactions = init.lastTransactions;
+        this.nextTransactionsAt = copyDate(init.nextTransactionsAt);
+        this.transactionBalancesCurrent = init.transactionBalancesCurrent ?? false;
+    }
+    /** The ID of the transactions the bank holds as MT940, its entry for `HKKAZ` in `inventory`. */
+    get mt940TransactionsId() {
+        return this.inventory.get('HKKAZ');
+    }
+    /** The ID of the transactions the bank holds as camt, its entry for `HKCAZ` in `inventory`. */
+    get camtTransactionsId() {
+        return this.inventory.get('HKCAZ');
+    }
+}
+//# sourceMappingURL=account.js.map

package/dist/core/account.js.map

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