@coderoftime/fints 0.1.0 → 0.2.0

package/dist/core/errors.js

@@ -1,46 +1,57 @@
 import { FormatError } from '../util/errors.js';
-import { endsDialog, FeedbackCodes } from './feedback.js';
-/** Base class of all errors the client raises about the bank and its data. */
+import { nonBlank } from '../util/text.js';
+import { endsDialog, FeedbackCodes, hasCode } from './feedback.js';
+/**
+ * Base class of all errors the client raises about the bank and its data.
+ *
+ * Each error class states its `name`: a minifier renames classes, and `constructor.name` would show a meaningless one.
+ */
 export class FinTsError extends Error {
-    constructor(name, message, cause) {
-        super(message, cause === undefined ? undefined : { cause });
-        // Set explicitly: a minifier renames classes, and `constructor.name` would show a meaningless name.
-        this.name = name;
-    }
 }
-/** The connection to the bank failed or returned an HTTP error. */
+/**
+ * The connection to the bank failed or returned an HTTP error.
+ *
+ * It carries no `cause`: the transport's own error may hold the message it was sending, PIN and TAN included.
+ */
 export class FinTsTransportError extends FinTsError {
-    /** The HTTP status code of the response, `undefined` if there was none, for example after a timeout. */
+    name = 'FinTsTransportError';
+    /**
+     * The HTTP status code of the bank's answer, `undefined` where none came, for example after a timeout; the client
+     * acts on it (`FinTsTransport.post`).
+     */
     statusCode;
     constructor(message, options) {
-        super('FinTsTransportError', message, options?.cause);
+        super(message);
         this.statusCode = options?.statusCode;
     }
 }
 /** The bank's response could not be understood. */
 export class FinTsProtocolError extends FinTsError {
-    constructor(message) {
-        super('FinTsProtocolError', message);
-    }
+    name = 'FinTsProtocolError';
 }
 /** The bank does not offer the requested business transaction. */
 export class FinTsUnsupportedError extends FinTsError {
-    constructor(message) {
-        super('FinTsUnsupportedError', message);
-    }
+    name = 'FinTsUnsupportedError';
 }
 /**
- * The bank rejected the request; `feedback` holds all return codes.
+ * The client has no TAN method or medium to log in with: the method in use needs a TAN medium the client could not
+ * learn, or the bank offers the user only TAN methods the client cannot run. Pass a medium to
+ * `FinTsClient.selectTanMethod`, or choose another method.
  *
- * After a refused login every later call that would send the PIN fails with the same error, without contacting the
- * bank; create a new client to try again. The README tells which errors refuse a login.
+ * The client does not send a login the bank would refuse for it, but the steps before, such as the synchronization or
+ * the lookup of the TAN media, may have gone out.
  */
+export class FinTsTanSetupError extends FinTsError {
+    name = 'FinTsTanSetupError';
+}
+/** The bank rejected the request; `feedback` holds all return codes. A refused login is a `FinTsLoginRefusedError`. */
 export class FinTsBankError extends FinTsError {
+    name = 'FinTsBankError';
     /** All return codes of the response, warnings and successes included. */
     feedback;
     /** A rejection with the return codes in `feedback`; `message` defaults to the errors among them. */
-    constructor(feedback, message, name = 'FinTsBankError') {
-        super(name, message ??
+    constructor(feedback, message) {
+        super(message ??
             feedback
                 .filter((f) => f.isError)
                 .map((f) => f.toString())
@@ -52,27 +63,40 @@ export class FinTsBankError extends FinTsError {
         return this.feedback.map((f) => f.code);
     }
 }
-/** Wrong or blocked PIN, a refused login as `FinTsBankError` describes it. */
-export class FinTsPinError extends FinTsBankError {
-    constructor(feedback) {
-        super(feedback, undefined, 'FinTsPinError');
-    }
+/**
+ * The bank refused the login, so the client sends the PIN no more: every later call that would send it fails with this
+ * error without contacting the bank, also in a client restored from the saved state, until
+ * `FinTsClient.clearLoginRefusal` takes a PIN the user has entered anew; for good where the bank has changed the login
+ * data (`FinTsLoginDataChangedError`).
+ *
+ * Banks lock the access after a few failed logins, and a return code does not always tell whether the PIN was the
+ * reason, so any error in the answer to a login refuses it, also one that ends the dialog, and so does a wrong PIN
+ * wherever the bank reports it. Only where the bank names a reason the client can take care of, another TAN method or a
+ * new customer system ID, does the same call log in once more, for each reason once. The client refuses the login
+ * itself where it could not read the answers to two logins in a row, which the bank may have counted as failed
+ * attempts; `feedback` is empty then.
+ */
+export class FinTsLoginRefusedError extends FinTsBankError {
+    name = 'FinTsLoginRefusedError';
+}
+/** Wrong or blocked PIN. */
+export class FinTsPinError extends FinTsLoginRefusedError {
+    name = 'FinTsPinError';
 }
 /** Invalid, expired or rejected TAN, as the bank reports it in answer to a TAN or to an approval status request. */
 export class FinTsTanError extends FinTsBankError {
-    constructor(feedback) {
-        super(feedback, undefined, 'FinTsTanError');
-    }
+    name = 'FinTsTanError';
 }
 /**
  * The bank has changed the user's login data and expects the new ones from now on (return code 3072).
  *
- * The client has ended the dialog, and every later call fails with this error. Create a new client with the new data; a
- * `loginName` replaces user ID and customer ID: pass it as `userId`, without a customer ID.
+ * The client has ended the dialog, where the bank opened one, and logs in with the old data no more. Create a new
+ * client with the new data; a `loginName` replaces user ID and customer ID: pass it as `userId`, without a customer ID.
  */
-export class FinTsLoginDataChangedError extends FinTsBankError {
+export class FinTsLoginDataChangedError extends FinTsLoginRefusedError {
+    name = 'FinTsLoginDataChangedError';
     constructor(feedback) {
-        super(feedback, 'The bank has changed the login data', 'FinTsLoginDataChangedError');
+        super(feedback, 'The bank has changed the login data');
     }
     /** The new user ID (Benutzerkennung); `undefined` where the bank names none. */
     get userId() {
@@ -88,26 +112,31 @@ export class FinTsLoginDataChangedError extends FinTsBankError {
     }
     parameter(index) {
         const change = this.feedback.find((f) => f.code === FeedbackCodes.newLoginData);
-        const value = change?.parameters[index]?.trim();
-        return value === undefined || value === '' ? undefined : value;
+        return nonBlank(change?.parameters[index]);
     }
 }
-/** The bank ended the dialog, for example after a timeout. */
+/**
+ * The bank ended the dialog, for example after a timeout; the next call logs in anew. Where the bank ends the dialog
+ * in answer to a login, the call fails with `FinTsLoginRefusedError` instead.
+ */
 export class FinTsDialogAbortedError extends FinTsBankError {
-    constructor(feedback) {
-        super(feedback, undefined, 'FinTsDialogAbortedError');
-    }
+    name = 'FinTsDialogAbortedError';
 }
 /** The user cancelled the TAN entry or the approval in the banking app. */
 export class FinTsTanCancelledError extends FinTsError {
+    name = 'FinTsTanCancelledError';
     constructor() {
-        super('FinTsTanCancelledError', 'TAN entry cancelled');
+        super('TAN entry cancelled');
     }
 }
-/** The user did not approve in the banking app within the bank's polling limit. */
+/**
+ * The user did not approve in the banking app in time: within the status requests the bank allows, 60 where it states
+ * none, and 10 minutes of polling at most.
+ */
 export class FinTsDecoupledTimeoutError extends FinTsError {
+    name = 'FinTsDecoupledTimeoutError';
     constructor() {
-        super('FinTsDecoupledTimeoutError', 'Approval on the separate device was not completed in time');
+        super('Approval on the separate device was not completed in time');
     }
 }
 /**
@@ -116,10 +145,11 @@ export class FinTsDecoupledTimeoutError extends FinTsError {
  * It does not extend `FinTsError`: it tells about the app's use of the client, not about the bank.
  */
 export class FinTsStateError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'FinTsStateError';
-    }
+    name = 'FinTsStateError';
+}
+/** The error of whatever a closed client is asked to do. */
+export function clientClosedError() {
+    return new FinTsStateError('The FinTS client is closed');
 }
 /**
  * Return codes for a wrong or blocked PIN, from the FinTS return code list (Rückmeldungscodes): 9340 signature (PIN)
@@ -168,7 +198,24 @@ export function bankErrorFor(feedback, completesApproval = false) {
         return new FinTsDialogAbortedError(feedback);
     return new FinTsBankError(feedback);
 }
-/** Runs `parse` on data from the bank and reports malformed data as `FinTsProtocolError`. */
+/**
+ * The refusal of a login whose answer carried `feedback`: `FinTsPinError` for a rejected PIN, else
+ * `FinTsLoginDataChangedError` for new login data, also next to other errors, and `FinTsLoginRefusedError` for anything
+ * else. The same for a refusal restored from the saved state, which keeps only `feedback`.
+ *
+ * New login data end the old ones for good, so the session takes care of no other reason the answer names.
+ */
+export function loginRefusalFor(feedback) {
+    if (feedback.some(isPinError))
+        return new FinTsPinError(feedback);
+    if (hasCode(feedback, FeedbackCodes.newLoginData))
+        return new FinTsLoginDataChangedError(feedback);
+    return new FinTsLoginRefusedError(feedback);
+}
+/**
+ * Runs `parse` on data from the bank and reports malformed data as `FinTsProtocolError`, whose message leaves the data
+ * out (`FormatError`).
+ */
 export function parseBankData(parse) {
     try {
         return parse();
@@ -179,4 +226,22 @@ export function parseBankData(parse) {
         throw error;
     }
 }
+/**
+ * Runs `lookup`, which only completes data, such as the SEPA account list; `undefined` where the bank rejects it, so
+ * that the caller carries on without it. An aborted dialog counts as a rejection: banks end the dialog along with many.
+ * A refused login and a rejected TAN fail the call: the user must hear of them.
+ */
+export async function tryLookUp(lookup) {
+    try {
+        return await lookup();
+    }
+    catch (error) {
+        if (!(error instanceof FinTsBankError) ||
+            error instanceof FinTsLoginRefusedError ||
+            error instanceof FinTsTanError) {
+            throw error;
+        }
+        return undefined;
+    }
+}
 //# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

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

package/dist/core/feedback.d.ts

@@ -6,7 +6,10 @@ export declare class FinTsFeedback {
     readonly reference: string | undefined;
     /** The bank's explanation of the code. */
     readonly text: string;
-    /** Values the bank adds to the code, such as the position to continue at. */
+    /**
+     * Values the bank adds to the code, such as the position to continue at: one character per byte the bank sent (ISO
+     * 8859-1, the FinTS character set), since the client and the app send them back as they came.
+     */
     readonly parameters: readonly string[];
     constructor(init: {
         code: string;

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

@@ -1 +1 @@
-{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/core/feedback.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,qBAAa,aAAa;IACxB,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;gBAE3B,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE;IAOhH,wCAAwC;IACxC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,qCAAqC;IACrC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,oCAAoC;IACpC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,QAAQ,IAAI,MAAM;CAGnB;AAED,qGAAqG;AACrG,eAAO,MAAM,aAAa;IACxB,6GAA6G;;IAE7G,kHAAkH;;IAElH;;;OAGG;;IAEH,qEAAqE;;IAErE,mHAAmH;;IAEnH,4FAA4F;;IAE5F,6DAA6D;;IAE7D,sDAAsD;;IAEtD;;;OAGG;;IAEH,0HAA0H;;EAE1H,CAAC;AA0BH,4DAA4D;AAC5D,wBAAgB,OAAO,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjF;AAED,2CAA2C;AAC3C,wBAAgB,SAAS,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAErE;AAED,sGAAsG;AACtG,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAO7E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,EAAE,CAOhF;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAEtE;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,aAAa,EAAE,CAEhF"}
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/core/feedback.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,qBAAa,aAAa;IACxB,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;gBAE3B,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE;IAOhH,wCAAwC;IACxC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,qCAAqC;IACrC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,oCAAoC;IACpC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,QAAQ,IAAI,MAAM;CAGnB;AAED,qGAAqG;AACrG,eAAO,MAAM,aAAa;IACxB,6GAA6G;;IAE7G,kHAAkH;;IAElH;;;OAGG;;IAEH,qEAAqE;;IAErE,mHAAmH;;IAEnH,4FAA4F;;IAE5F,6DAA6D;;IAE7D,sDAAsD;;IAEtD;;;OAGG;;IAEH,0HAA0H;;EAE1H,CAAC;AA0BH,4DAA4D;AAC5D,wBAAgB,OAAO,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjF;AAED,2CAA2C;AAC3C,wBAAgB,SAAS,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAErE;AAED,sGAAsG;AACtG,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAO7E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,EAAE,CAOhF;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAEtE;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,aAAa,EAAE,CAEhF"}

package/dist/core/feedback.js

@@ -6,7 +6,10 @@ export class FinTsFeedback {
     reference;
     /** The bank's explanation of the code. */
     text;
-    /** Values the bank adds to the code, such as the position to continue at. */
+    /**
+     * Values the bank adds to the code, such as the position to continue at: one character per byte the bank sent (ISO
+     * 8859-1, the FinTS character set), since the client and the app send them back as they came.
+     */
     parameters;
     constructor(init) {
         this.code = init.code;

package/dist/core/feedback.js.map

@@ -1 +1 @@
-{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../../src/core/feedback.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,OAAO,aAAa;IACxB,0FAA0F;IACjF,IAAI,CAAS;IAEtB,4EAA4E;IACnE,SAAS,CAAqB;IAEvC,0CAA0C;IACjC,IAAI,CAAS;IAEtB,6EAA6E;IACpE,UAAU,CAAoB;IAEvC,YAAY,IAAoG;QAC9G,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,wCAAwC;IACxC,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,qCAAqC;IACrC,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,oCAAoC;IACpC,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,QAAQ;QACN,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/G,CAAC;CACF;AAED,qGAAqG;AACrG,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,6GAA6G;IAC7G,WAAW,EAAE,MAAM;IACnB,kHAAkH;IAClH,QAAQ,EAAE,MAAM;IAChB;;;OAGG;IACH,YAAY,EAAE,MAAM;IACpB,qEAAqE;IACrE,iBAAiB,EAAE,MAAM;IACzB,mHAAmH;IACnH,gBAAgB,EAAE,MAAM;IACxB,4FAA4F;IAC5F,qBAAqB,EAAE,MAAM;IAC7B,6DAA6D;IAC7D,oBAAoB,EAAE,MAAM;IAC5B,sDAAsD;IACtD,aAAa,EAAE,MAAM;IACrB;;;OAGG;IACH,WAAW,EAAE,MAAM;IACnB,0HAA0H;IAC1H,mBAAmB,EAAE,MAAM;CAC5B,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAS,CAAC,aAAa,CAAC,aAAa,EAAE,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvH;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAS;IACvC,aAAa,CAAC,QAAQ;IACtB,MAAM;IACN,aAAa,CAAC,YAAY;IAC1B,MAAM;IACN,aAAa,CAAC,iBAAiB;IAC/B,aAAa,CAAC,gBAAgB;IAC9B,aAAa,CAAC,qBAAqB;IACnC,aAAa,CAAC,oBAAoB;CACnC,CAAC,CAAC;AAEH,oFAAoF;AAEpF,4DAA4D;AAC5D,MAAM,UAAU,OAAO,CAAC,QAAkC,EAAE,IAAY;IACtE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,SAAS,CAAC,QAAkC;IAC1D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,aAAa,CAAC,QAAkC;IAC9D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,QAAQ,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE;YAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9G,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAkC;IACpE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,iBAAiB;YAAE,SAAS;QACzD,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,UAAU;YAAE,IAAI,IAAI,KAAK,EAAE;gBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,UAAU,CAAC,QAAkC;IAC3D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAAC,QAAkC;IAC7D,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9E,CAAC"}
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../../src/core/feedback.ts"],"names":[],"mappings":"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"}

package/dist/core/transaction.d.ts

@@ -84,8 +84,13 @@ export declare class Transaction {
     readonly ultimateCreditor: string | undefined;
     /** The party the payer acts for, where that is not the payer itself. */
     readonly ultimateDebtor: string | undefined;
-    /** All SEPA keywords found in the purpose, keyed by keyword (EREF, KREF, MREF, CRED, SVWZ, …). */
+    /**
+     * The SEPA keywords of the purpose, keyed by keyword (EREF, KREF, MREF, CRED, SVWZ, …): those `SepaPurpose` reads. In
+     * camt, EREF, MREF and CRED are those of `endToEndId`, `mandateId` and `creditorId`, which the bank states apart,
+     * never keywords of the remittance text the payer or the payee writes.
+     */
     readonly purposeCodes: ReadonlyMap<string, string>;
+    /** Takes copies of the dates and purpose codes of `init`: each transaction has its own, which no other one shares. */
     constructor(init: TransactionInit);
     /** Whether the transaction is still pending. */
     get isPending(): boolean;

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

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

package/dist/core/transaction.js

@@ -1,4 +1,4 @@
-import { formatIsoDate } from '../util/dates.js';
+import { copyDate, formatIsoDate } from '../util/dates.js';
 import { ImmutableMap } from '../util/immutable-map.js';
 /** A single account transaction, parsed from camt.052 or MT940/MT942. */
 export class Transaction {
@@ -49,12 +49,17 @@ export class Transaction {
     ultimateCreditor;
     /** The party the payer acts for, where that is not the payer itself. */
     ultimateDebtor;
-    /** All SEPA keywords found in the purpose, keyed by keyword (EREF, KREF, MREF, CRED, SVWZ, …). */
+    /**
+     * The SEPA keywords of the purpose, keyed by keyword (EREF, KREF, MREF, CRED, SVWZ, …): those `SepaPurpose` reads. In
+     * camt, EREF, MREF and CRED are those of `endToEndId`, `mandateId` and `creditorId`, which the bank states apart,
+     * never keywords of the remittance text the payer or the payee writes.
+     */
     purposeCodes;
+    /** Takes copies of the dates and purpose codes of `init`: each transaction has its own, which no other one shares. */
     constructor(init) {
         this.status = init.status ?? 'booked';
-        this.bookingDate = init.bookingDate;
-        this.valueDate = init.valueDate;
+        this.bookingDate = copyDate(init.bookingDate);
+        this.valueDate = copyDate(init.valueDate);
         this.amount = init.amount;
         this.isReversal = init.isReversal ?? false;
         this.bookingText = init.bookingText;

package/dist/core/transaction.js.map

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

package/dist/core/transport.d.ts

@@ -3,19 +3,35 @@ export interface FinTsTransport {
     /**
      * Posts `body` to `url` and returns the response body.
      *
-     * Implementations report failures as `FinTsTransportError`.
+     * The client aborts `signal` once it is closed: a transport that stops the request then keeps `close` from waiting
+     * for the answer.
+     *
+     * Implementations report failures as `FinTsTransportError`, with the HTTP status as `statusCode` where the bank
+     * answered with an HTTP error: an anonymous request for the bank parameter data that fails so goes out once more,
+     * without the announcement of strong authentication, which some banks fail on. Of any other error, another
+     * `FinTsError` included, the client keeps only its message and that of its cause, as a `FinTsTransportError` without
+     * `statusCode`. `body` holds PIN and TAN in plain text: keep it out of error messages and logs.
      */
-    post(url: URL, body: Uint8Array, contentType: string): Promise<Uint8Array>;
+    post(url: URL, body: Uint8Array, contentType: string, signal: AbortSignal): Promise<Uint8Array>;
     /** Releases the connection; the client calls it when it is closed. */
     close(): void;
 }
 /** What `HttpTransport` takes; all optional. */
 export interface HttpTransportOptions {
-    /** The `fetch` to send with, for example one with a proxy agent; the global `fetch` by default. */
+    /**
+     * The `fetch` to send with, for example one with a proxy agent; the global `fetch` by default.
+     *
+     * It must post to the URL it is given: an answer from another URL counts as a redirect, which fails the request. Of
+     * an answer whose `body` is no `ReadableStream`, as with node-fetch, the size can only be checked once it is read
+     * whole.
+     */
     fetch?: typeof fetch;
-    /** Time for the whole exchange in milliseconds, from sending the request to the last byte of the response; 90 s. */
+    /**
+     * Time for the whole exchange in milliseconds, from sending the request to the last byte of the response; 90 s. At
+     * most 2147483647 (about 24 days), the longest `setTimeout` waits.
+     */
     timeoutMs?: number;
-    /** Largest response accepted, so that a faulty server cannot exhaust the memory; 16 MiB. */
+    /** Largest response accepted in bytes, so that a faulty server cannot exhaust the memory; 16 MiB. */
     maxResponseBytes?: number;
 }
 /**
@@ -28,10 +44,21 @@ export declare class HttpTransport implements FinTsTransport {
     readonly timeoutMs: number;
     readonly maxResponseBytes: number;
     private readonly fetchFn;
+    /**
+     * Throws `TypeError` if `timeoutMs` is not a positive number of at most 2147483647, or `maxResponseBytes` is not a
+     * positive number.
+     */
     constructor(options?: HttpTransportOptions);
-    post(url: URL, body: Uint8Array, contentType: string): Promise<Uint8Array>;
+    /** Fails with `FinTsTransportError` at the timeout or once `signal` is aborted; sends nothing if it is already. */
+    post(url: URL, body: Uint8Array, contentType: string, signal?: AbortSignal): Promise<Uint8Array>;
     private exchange;
     private readBody;
+    private tooLarge;
     close(): void;
 }
+/**
+ * The message of a failed request, with the message of its cause: Node.js reports `fetch failed` and the reason in the
+ * cause. Only the messages, since the error may hold the request, PIN and TAN included.
+ */
+export declare function failureMessage(error: unknown): string;
 //# sourceMappingURL=transport.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/core/transport.ts"],"names":[],"mappings":"AAGA,+GAA+G;AAC/G,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE3E,sEAAsE;IACtE,KAAK,IAAI,IAAI,CAAC;CACf;AAED,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,mGAAmG;IACnG,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,oHAAoH;IACpH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAE3B,OAAO,GAAE,oBAAyB;IAMxC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;YAqBlE,QAAQ;YAqBR,QAAQ;IAkBtB,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/core/transport.ts"],"names":[],"mappings":"AAIA,+GAA+G;AAC/G,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEhG,sEAAsE;IACtE,KAAK,IAAI,IAAI,CAAC;CACf;AAED,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qGAAqG;IACrG,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAKD;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IAEvC;;;OAGG;gBACS,OAAO,GAAE,oBAAyB;IAY9C,mHAAmH;IAC7G,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;YA2BxF,QAAQ;YA0BR,QAAQ;IAwBtB,OAAO,CAAC,QAAQ;IAIhB,KAAK,IAAI,IAAI;CAGd;AAsBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIrD"}

package/dist/core/transport.js

@@ -1,5 +1,8 @@
 import { concatBytes } from '../util/bytes.js';
+import { invalidArgument } from '../util/errors.js';
 import { FinTsTransportError } from './errors.js';
+/** The longest delay `setTimeout` takes; it fires at once for a longer one, such as `Infinity`. */
+const maxTimeoutMs = 2 ** 31 - 1;
 /**
  * Default `FinTsTransport`: HTTP POST with `fetch`.
  *
@@ -10,33 +13,52 @@ export class HttpTransport {
     timeoutMs;
     maxResponseBytes;
     fetchFn;
+    /**
+     * Throws `TypeError` if `timeoutMs` is not a positive number of at most 2147483647, or `maxResponseBytes` is not a
+     * positive number.
+     */
     constructor(options = {}) {
-        this.fetchFn = options.fetch ?? ((input, init) => fetch(input, init));
+        const custom = options.fetch;
+        // Called as a plain function: a browser's native `fetch` fails as a method of another object.
+        this.fetchFn = custom === undefined ? (input, init) => fetch(input, init) : (input, init) => custom(input, init);
         this.timeoutMs = options.timeoutMs ?? 90_000;
         this.maxResponseBytes = options.maxResponseBytes ?? 16 << 20;
+        if (!isPositive(this.timeoutMs) || this.timeoutMs > maxTimeoutMs) {
+            throw invalidArgument(`Must be a positive number of at most ${maxTimeoutMs}`, 'timeoutMs');
+        }
+        if (!isPositive(this.maxResponseBytes))
+            throw invalidArgument('Must be a positive number', 'maxResponseBytes');
     }
-    async post(url, body, contentType) {
+    /** Fails with `FinTsTransportError` at the timeout or once `signal` is aborted; sends nothing if it is already. */
+    async post(url, body, contentType, signal) {
+        if (signal?.aborted)
+            throw new FinTsTransportError('Request aborted');
         const controller = new AbortController();
-        let timer;
-        // Waiting for the timeout as well covers a `fetch` that cannot abort a request.
-        const timedOut = new Promise((_, reject) => {
-            timer = setTimeout(() => {
-                controller.abort();
-                reject(new FinTsTransportError('Request timed out'));
-            }, this.timeoutMs);
+        // Raced with the exchange, for a `fetch` that cannot abort a request.
+        const stopped = new Promise((_, reject) => {
+            controller.signal.addEventListener('abort', () => {
+                reject(controller.signal.reason);
+            });
         });
+        const stop = (message) => () => {
+            controller.abort(new FinTsTransportError(message));
+        };
+        const timer = setTimeout(stop('Request timed out'), this.timeoutMs);
+        const abort = stop('Request aborted');
+        signal?.addEventListener('abort', abort);
         try {
-            return await Promise.race([this.exchange(url, body, contentType, controller.signal), timedOut]);
+            return await Promise.race([this.exchange(url, body, contentType, controller.signal), stopped]);
         }
         catch (error) {
+            if (controller.signal.aborted)
+                throw controller.signal.reason;
             if (error instanceof FinTsTransportError)
                 throw error;
-            if (controller.signal.aborted)
-                throw new FinTsTransportError('Request timed out');
-            throw new FinTsTransportError(describe(error));
+            throw new FinTsTransportError(failureMessage(error));
         }
         finally {
             clearTimeout(timer);
+            signal?.removeEventListener('abort', abort);
         }
     }
     async exchange(url, body, contentType, signal) {
@@ -51,8 +73,13 @@ export class HttpTransport {
         if (response.type === 'opaqueredirect') {
             throw new FinTsTransportError('The server redirects the request, which the client does not follow');
         }
+        // A `fetch` that ignores `redirect`, as one over XMLHttpRequest does, shows a redirect it followed only here.
+        if (response.redirected || (response.url && response.url !== withoutFragment(url))) {
+            await discard(response);
+            throw new FinTsTransportError('The fetch followed a redirect: the request may have gone to another address');
+        }
         if (response.status < 200 || response.status > 299) {
-            await response.body?.cancel().catch(() => undefined);
+            await discard(response);
             throw new FinTsTransportError(`HTTP ${response.status} ${response.statusText}`.trim(), {
                 statusCode: response.status,
             });
@@ -60,9 +87,15 @@ export class HttpTransport {
         return this.readBody(response);
     }
     async readBody(response) {
-        const reader = response.body?.getReader();
-        if (reader === undefined)
-            return new Uint8Array(await response.arrayBuffer());
+        // A `fetch` that does not stream, as one over XMLHttpRequest or node-fetch, gives no body or one of another kind.
+        const body = response.body;
+        if (typeof body?.getReader !== 'function') {
+            const bytes = new Uint8Array(await response.arrayBuffer());
+            if (bytes.length > this.maxResponseBytes)
+                throw this.tooLarge();
+            return bytes;
+        }
+        const reader = body.getReader();
         const chunks = [];
         let size = 0;
         for (;;) {
@@ -73,17 +106,41 @@ export class HttpTransport {
             size += value.length;
             if (size > this.maxResponseBytes) {
                 await reader.cancel().catch(() => undefined);
-                throw new FinTsTransportError(`Response larger than ${this.maxResponseBytes} bytes`);
+                throw this.tooLarge();
             }
         }
         return concatBytes(chunks);
     }
+    tooLarge() {
+        return new FinTsTransportError(`Response larger than ${this.maxResponseBytes} bytes`);
+    }
     close() {
         // `fetch` keeps no connection the transport could release.
     }
 }
-/** The message of a `fetch` failure, with its cause: Node.js reports `fetch failed` and the reason in the cause. */
-function describe(error) {
+/** `url` as `Response.url` gives it: without fragment. */
+function withoutFragment(url) {
+    const copy = new URL(url);
+    copy.hash = '';
+    return copy.href;
+}
+/** Cancels the body of a response the transport rejects, unless it cannot be cancelled, as a Node.js stream cannot. */
+async function discard(response) {
+    try {
+        await response.body?.cancel();
+    }
+    catch {
+        // The response is rejected all the same.
+    }
+}
+function isPositive(value) {
+    return Number.isFinite(value) && value > 0;
+}
+/**
+ * The message of a failed request, with the message of its cause: Node.js reports `fetch failed` and the reason in the
+ * cause. Only the messages, since the error may hold the request, PIN and TAN included.
+ */
+export function failureMessage(error) {
     if (!(error instanceof Error))
         return String(error);
     const cause = error.cause;