@coderoftime/fints 0.1.0 → 0.3.0

package/dist/core/transport.js

@@ -1,8 +1,19 @@
-import { concatBytes } from '../util/bytes.js';
+import { invalidArgument } from '../util/errors.js';
+import { trimBlanks } from '../util/text.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`.
  *
+ * Without the `fetch` option it sends with the global `fetch` as it is at each request, and cannot bypass what that
+ * does, for plain http to a local server (`FinTsConfig.allowInsecureUrl`) as for https: whatever replaces that `fetch`
+ * or handles its requests, such as a test's stub of `globalThis.fetch` or on Node.js a global dispatcher (undici's
+ * `setGlobalDispatcher`), gets every message, PIN and TAN included, and a proxy that the runtime takes from the
+ * environment, as Node.js does with `NODE_USE_ENV_PROXY=1`, and Deno and Bun do from `HTTP_PROXY`, sees the PIN of
+ * plain http unencrypted. Exempt the host with `NO_PROXY`, such as `localhost,127.0.0.1,::1`, or pass a `fetch` that
+ * connects directly.
+ *
  * In a browser it only reaches servers that allow the page's origin (CORS), which bank servers do not: a web app needs
  * a server of its own between browser and bank, reached with a `FinTsTransport` of its own.
  */
@@ -10,33 +21,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) {
@@ -46,47 +76,114 @@ export class HttpTransport {
             headers: { 'Content-Type': contentType, 'Cache-Control': 'no-cache', Pragma: 'no-cache' },
             // The PIN travels in the body: never let the request be repeated at another address.
             redirect: 'manual',
+            // In a browser: no cookies of the page and no referrer go with the PIN, and no cache keeps the exchange.
+            credentials: 'omit',
+            referrerPolicy: 'no-referrer',
+            cache: 'no-store',
             signal,
         });
         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);
-            throw new FinTsTransportError(`HTTP ${response.status} ${response.statusText}`.trim(), {
+            await discard(response);
+            throw new FinTsTransportError(trimBlanks(`HTTP ${response.status} ${response.statusText}`), {
                 statusCode: response.status,
             });
         }
+        const announced = response.headers.get('Content-Length');
+        if (announced !== null && /^\d+$/.test(announced) && Number(announced) > this.maxResponseBytes) {
+            await discard(response);
+            throw this.tooLarge();
+        }
         return this.readBody(response);
     }
     async readBody(response) {
-        const reader = response.body?.getReader();
-        if (reader === undefined)
-            return new Uint8Array(await response.arrayBuffer());
-        const chunks = [];
+        // 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();
+        // Copied as they arrive: many tiny chunks kept as they are would take many times the bytes they hold, and a `fetch`
+        // may refill the chunk it handed out.
+        let bytes = new Uint8Array(0);
         let size = 0;
         for (;;) {
             const { done, value } = await reader.read();
             if (done)
                 break;
-            chunks.push(value);
-            size += value.length;
-            if (size > this.maxResponseBytes) {
+            const end = size + value.length;
+            if (end > this.maxResponseBytes) {
                 await reader.cancel().catch(() => undefined);
-                throw new FinTsTransportError(`Response larger than ${this.maxResponseBytes} bytes`);
+                throw this.tooLarge();
+            }
+            if (end > bytes.length) {
+                const grown = new Uint8Array(Math.min(Math.max(2 * bytes.length, end), this.maxResponseBytes));
+                grown.set(bytes.subarray(0, size));
+                bytes = grown;
             }
+            bytes.set(value, size);
+            size = end;
         }
-        return concatBytes(chunks);
+        return bytes.slice(0, size);
+    }
+    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 reason its cause gives: Node.js reports `fetch failed` and the reason in the
+ * cause. Only messages and codes, 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;
-    return cause instanceof Error ? `${error.message}: ${cause.message}` : error.message;
+    const reason = error.cause instanceof Error ? reasonOf(error.cause) : '';
+    return reason ? `${error.message}: ${reason}` : error.message;
+}
+/**
+ * The message of `cause`, or where it has none, the distinct messages of its `errors` or its `code`: Node.js reports a
+ * failed connection to a host with IPv6 and IPv4 addresses as an `AggregateError` without a message.
+ */
+function reasonOf(cause) {
+    if (cause.message)
+        return cause.message;
+    if (cause instanceof AggregateError) {
+        const messages = cause.errors.flatMap((error) => (error instanceof Error && error.message ? [error.message] : []));
+        if (messages.length > 0)
+            return [...new Set(messages)].join('; ');
+    }
+    const code = cause.code;
+    return typeof code === 'string' ? code : '';
 }
 //# sourceMappingURL=transport.js.map

package/dist/core/transport.js.map

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

package/dist/formats/camt.d.ts

@@ -1,12 +1,35 @@
 import { Transaction, type TransactionStatus } from '../core/transaction.js';
-/** Parser for ISO 20022 camt.052 and camt.053 account reports. */
+import { RecordBudget } from './record-budget.js';
+/** One report (camt.052), statement (camt.053) or notification (camt.054): the entries of one account. */
+export interface CamtStatement {
+    /** The bank's identification of the statement (`Id`). */
+    readonly reference: string | undefined;
+    /** The account the statement is for: its IBAN, or the bank's other identification of it where it states none. */
+    readonly accountId: string | undefined;
+    /** The currency of the account, where the statement states it. */
+    readonly currency: string | undefined;
+    /** The transactions of the statement, in the order the bank lists them. */
+    readonly transactions: readonly Transaction[];
+}
+/** Parser for ISO 20022 camt.052, camt.053 and camt.054 account reports, statements and notifications. */
 export declare const Camt: Readonly<{
     /**
-     * Parses all entries; throws `FormatError` for malformed XML, and for an entry without amount, currency, credit/debit
-     * indicator or date.
-     *
-     * `status` overrides the booking status stated in the entries.
+     * Parses the transactions of all statements in one list, which does not tell the account of each: a document may hold
+     * statements of several accounts, which `parse` keeps apart. Throws as `parse` does.
      */
     parseTransactions(xml: string, status?: TransactionStatus): Transaction[];
+    /**
+     * Parses all statements, each with the account it is for. Throws `FormatError` for malformed XML, for XML nested more
+     * than 100 levels deep or of more than 500,000 nodes besides text or one per 16 characters, whichever is more, for a
+     * document without any statement, for an entry without amount, currency, credit/debit indicator or date, for a date
+     * it cannot read, for remittance information of more than 65,536 characters, and for more than 200,000 statements and
+     * transactions.
+     *
+     * `status` overrides the booking status stated in the entries, unless it is `undefined` or `null`; throws `TypeError`
+     * for one other than `booked` and `pending`.
+     */
+    parse(xml: string, status?: TransactionStatus): CamtStatement[];
 }>;
+/** `Camt.parse`, which takes each statement and transaction from `budget`, before it builds it. */
+export declare function parseCamt(xml: string, status: TransactionStatus | undefined, budget: RecordBudget): CamtStatement[];
 //# sourceMappingURL=camt.d.ts.map

package/dist/formats/camt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"camt.d.ts","sourceRoot":"","sources":["../../src/formats/camt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAM7E,kEAAkE;AAClE,eAAO,MAAM,IAAI;IACf;;;;;OAKG;2BACoB,MAAM,WAAW,iBAAiB,GAAG,WAAW,EAAE;EAIzE,CAAC"}
+{"version":3,"file":"camt.d.ts","sourceRoot":"","sources":["../../src/formats/camt.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAO5F,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,0GAA0G;AAC1G,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,iHAAiH;IACjH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;CAC/C;AAKD,0GAA0G;AAC1G,eAAO,MAAM,IAAI;IACf;;;OAGG;2BACoB,MAAM,WAAW,iBAAiB,GAAG,WAAW,EAAE;IAIzE;;;;;;;;;OASG;eACQ,MAAM,WAAW,iBAAiB,GAAG,aAAa,EAAE;EAG/D,CAAC;AAOH,mGAAmG;AACnG,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,aAAa,EAAE,CAoBnH"}

package/dist/formats/camt.js

@@ -1,33 +1,72 @@
-import { Amount } from '../core/amount.js';
-import { Transaction } from '../core/transaction.js';
+import { addsUpTo, Amount } from '../core/amount.js';
+import { requireStatus, Transaction } from '../core/transaction.js';
 import { parseIsoDate } from '../util/dates.js';
-import { FormatError } from '../util/errors.js';
+import { fail, FormatError } from '../util/errors.js';
+import { frozenWithInspect } from '../util/inspect.js';
+import { counted, maskedId, nonBlank, trimBlanks } from '../util/text.js';
 import { parseXml } from '../util/xml.js';
+import { maxFieldLength } from './mt940.js';
+import { RecordBudget } from './record-budget.js';
 import { providedReference, SepaPurpose } from './sepa-purpose.js';
-/** Parser for ISO 20022 camt.052 and camt.053 account reports. */
+/** Local names of the elements of a document that hold the entries of one account. */
+const statementNames = new Set(['Rpt', 'Stmt', 'Ntfctn']);
+/** Parser for ISO 20022 camt.052, camt.053 and camt.054 account reports, statements and notifications. */
 export const Camt = Object.freeze({
     /**
-     * Parses all entries; throws `FormatError` for malformed XML, and for an entry without amount, currency, credit/debit
-     * indicator or date.
-     *
-     * `status` overrides the booking status stated in the entries.
+     * Parses the transactions of all statements in one list, which does not tell the account of each: a document may hold
+     * statements of several accounts, which `parse` keeps apart. Throws as `parse` does.
      */
     parseTransactions(xml, status) {
-        const root = parseXml(xml.trim());
-        return root.descendantsNamed('Ntry').flatMap((entry) => new CamtEntry(entry, status).transactions());
+        return Camt.parse(xml, status).flatMap((s) => s.transactions);
+    },
+    /**
+     * Parses all statements, each with the account it is for. Throws `FormatError` for malformed XML, for XML nested more
+     * than 100 levels deep or of more than 500,000 nodes besides text or one per 16 characters, whichever is more, for a
+     * document without any statement, for an entry without amount, currency, credit/debit indicator or date, for a date
+     * it cannot read, for remittance information of more than 65,536 characters, and for more than 200,000 statements and
+     * transactions.
+     *
+     * `status` overrides the booking status stated in the entries, unless it is `undefined` or `null`; throws `TypeError`
+     * for one other than `booked` and `pending`.
+     */
+    parse(xml, status) {
+        return parseCamt(xml, forcedStatus(status), new RecordBudget());
     },
 });
+/** The `status` of `Camt.parse`; `undefined` for `null`, the status the entries state. */
+function forcedStatus(status) {
+    return status === undefined || status === null ? undefined : requireStatus(status);
+}
+/** `Camt.parse`, which takes each statement and transaction from `budget`, before it builds it. */
+export function parseCamt(xml, status, budget) {
+    const root = parseXml(trimBlanks(xml));
+    const statements = root.childElements.flatMap((message) => message.childElements.filter((c) => statementNames.has(c.localName)));
+    if (statements.length === 0)
+        throw new FormatError('camt document without report, statement or notification');
+    return statements.map((statement) => {
+        budget.take();
+        const account = statement.child('Acct');
+        const entries = statement.childrenNamed('Ntry');
+        return frozenWithInspect({
+            reference: statement.textAt(['Id']),
+            accountId: account?.textAt(['Id', 'IBAN']) ?? account?.textAt(['Id', 'Othr', 'Id']),
+            currency: account?.textAt(['Ccy']),
+            transactions: Object.freeze(entries.flatMap((entry) => new CamtEntry(entry, status, budget).transactions())),
+        }, (s) => `CamtStatement(${maskedId(s.accountId ?? '')}, ${counted(s.transactions.length, 'transaction')})`);
+    });
+}
 /** Width of the purpose lines banks cut the remittance information into, as in MT940 and DTAUS. */
 const cutLineLength = 35;
 /**
- * One booking (`Ntry`) of a report; a batch booking yields one transaction per transaction detail (`TxDtls`) when every
- * detail states its amount.
+ * One booking (`Ntry`) of a report; a batch booking yields one transaction per transaction detail (`TxDtls`) when the
+ * details state their amounts and these add up to the booked amount.
  *
  * Nothing is guessed: what the entry lacks, and what the reader needs, is a `FormatError`. The one exception is the
  * value date, which `Transaction.valueDate` requires: an entry with a booking date only takes that.
  */
 class CamtEntry {
     entry;
+    budget;
     amountElement;
     currency;
     debit;
@@ -35,10 +74,13 @@ class CamtEntry {
     status;
     bookingDate;
     valueDate;
+    bookingText;
+    bankReference;
     /** German banks send `transaction type+GVC+prima nota`, for example `NDDT+105+9310`. */
     proprietaryCode;
-    constructor(entry, forcedStatus) {
+    constructor(entry, forcedStatus, budget) {
         this.entry = entry;
+        this.budget = budget;
         this.amountElement = entry.child('Amt') ?? fail('camt entry without amount');
         this.currency = this.amountElement.getAttribute('Ccy') ?? fail('camt amount without currency');
         this.debit = debitIndicator(entry.textAt(['CdtDbtInd'])) ?? fail('camt entry without credit/debit indicator');
@@ -46,6 +88,8 @@ class CamtEntry {
         this.status = forcedStatus ?? this.statusOfEntry();
         this.bookingDate = dateOf(entry.child('BookgDt'));
         this.valueDate = dateOf(entry.child('ValDt')) ?? this.bookingDate ?? fail('camt entry without date');
+        this.bookingText = entry.textAt(['AddtlNtryInf']);
+        this.bankReference = entry.textAt(['AcctSvcrRef']);
         this.proprietaryCode = entry.textAt(['BkTxCd', 'Prtry', 'Cd'])?.split('+') ?? [];
     }
     statusOfEntry() {
@@ -53,48 +97,53 @@ class CamtEntry {
         return code === 'PDNG' || code === 'INFO' ? 'pending' : 'booked';
     }
     transactions() {
-        const total = Amount.parseDecimal(this.amountElement.innerText, this.currency);
-        const details = this.entry.descendantsNamed('TxDtls');
+        const total = amountOf(this.amountElement, this.currency);
+        const details = this.entry.childrenNamed('NtryDtls').flatMap((d) => d.childrenNamed('TxDtls'));
         if (details.length <= 1)
             return [this.transaction(details[0], total, this.debit)];
+        // A batch is split only into details that make up its booking: each states its amount, and they add up to the
+        // booked one, in its currency. It stays one booking otherwise, without the details of any one of them, which would
+        // describe the others wrongly.
+        const booking = this.transaction(undefined, total, this.debit);
         const amounts = details.map((detail) => detail.at(['AmtDtls', 'TxAmt', 'Amt']) ?? detail.child('Amt'));
-        // Without the amount of every detail the batch cannot be split. It stays one booking then, without the details of
-        // any one of them, which would describe the others wrongly.
         if (amounts.includes(undefined))
-            return [this.transaction(undefined, total, this.debit)];
-        return details.map((detail, i) => {
-            const amount = amounts[i];
-            return this.transaction(detail, Amount.parseDecimal(amount.innerText, amount.getAttribute('Ccy') ?? this.currency), 
-            // A detail may book in the other direction than the batch as a whole.
-            debitIndicator(detail.textAt(['CdtDbtInd'])) ?? this.debit);
-        });
+            return [booking];
+        const split = details.map((detail, i) => this.transaction(detail, amountOf(amounts[i], this.currency), 
+        // A detail may book in the other direction than the batch as a whole.
+        debitIndicator(detail.textAt(['CdtDbtInd'])) ?? this.debit));
+        const parts = split.map((t) => t.amount);
+        return addsUpTo(parts, booking.amount) ? split : [booking];
     }
     /** A transaction of `amount`, booked as a debit if `debit`, with what `details` tell about it. */
     transaction(details, amount, debit) {
+        this.budget.take();
         const parties = details?.child('RltdPties');
         const agents = details?.child('RltdAgts');
         // The related parties describe the original operation, which a reversal books the other way round (ISO 20022
         // `RvslInd`: with `CRDT` the original operation was a debit, with `DBIT` a credit).
         const originalDebit = debit !== this.reversal;
         const counterparty = originalDebit ? 'Cdtr' : 'Dbtr';
-        const lines = (details?.descendantsNamed('Ustrd') ?? [])
-            .map((line) => line.innerText.trim())
-            .filter((text) => text !== '');
-        const purposeParts = lines.map((line, i) => (i > 0 && lines[i - 1].length !== cutLineLength ? ` ${line}` : line));
-        const purpose = purposeParts.join('');
+        const lines = (details?.child('RmtInf')?.childrenNamed('Ustrd') ?? [])
+            .map((line) => line.innerText)
+            .filter((text) => trimBlanks(text) !== '');
+        // A line of 35 characters goes on in the next one as it is, maybe in the middle of a word or before a blank; any
+        // other line ends a phrase, which the next one follows after a blank.
+        const cut = (i) => lines[i]?.length === cutLineLength;
+        const purposeParts = lines.map((line, i) => {
+            const part = cut(i) ? line : trimBlanks(line, { start: false });
+            return i === 0 || cut(i - 1) ? part : ` ${trimBlanks(part, { end: false })}`;
+        });
+        const remittance = purposeParts.join('');
+        // As long as an MT940 field: the keywords of megabytes of text would take memory without limit.
+        if (remittance.length > maxFieldLength)
+            throw new FormatError('camt remittance information too long');
         const keywords = SepaPurpose.parseParts(purposeParts);
         const endToEndId = providedReference(details?.textAt(['Refs', 'EndToEndId']));
         const mandateId = details?.textAt(['Refs', 'MndtId']);
-        const creditorId = creditorIdOf(parties);
+        const creditorId = creditorIdOf(parties?.child('Cdtr'));
         const purposeCode = details?.textAt(['Purp', 'Cd']);
         const typeId = this.proprietaryCode[0]?.length === 4 ? this.proprietaryCode[0] : undefined;
-        const purposeCodes = new Map(keywords);
-        if (endToEndId !== undefined)
-            purposeCodes.set('EREF', endToEndId);
-        if (mandateId !== undefined)
-            purposeCodes.set('MREF', mandateId);
-        if (creditorId !== undefined)
-            purposeCodes.set('CRED', creditorId);
+        const purposeCodes = withKeywordsStatedApart(keywords, { EREF: endToEndId, MREF: mandateId, CRED: creditorId });
         if (purposeCode !== undefined)
             purposeCodes.set('PURP', purposeCode);
         return new Transaction({
@@ -103,8 +152,11 @@ class CamtEntry {
             valueDate: this.valueDate,
             amount: debit ? amount.negate() : amount,
             isReversal: this.reversal,
-            bookingText: this.entry.textAt(['AddtlNtryInf']) ?? details?.textAt(['AddtlTxInf']),
-            purpose: keywords.get('SVWZ') ?? (purpose === '' ? details?.textAt(['AddtlTxInf']) : purpose),
+            bookingText: this.bookingText ?? details?.textAt(['AddtlTxInf']),
+            purpose: keywords.get('SVWZ') ??
+                nonBlank(remittance) ??
+                details?.textAt(['RmtInf', 'Strd', 'CdtrRefInf', 'Ref']) ??
+                details?.textAt(['AddtlTxInf']),
             counterpartyName: partyName(parties?.child(counterparty)),
             counterpartyIban: parties?.child(`${counterparty}Acct`)?.textAt(['Id', 'IBAN']),
             counterpartyAccountNumber: parties?.child(`${counterparty}Acct`)?.textAt(['Id', 'Othr', 'Id']),
@@ -113,7 +165,7 @@ class CamtEntry {
             mandateId,
             creditorId,
             customerReference: details?.textAt(['Refs', 'InstrId']) ?? details?.textAt(['Refs', 'PmtInfId']),
-            bankReference: details?.textAt(['Refs', 'AcctSvcrRef']) ?? this.entry.textAt(['AcctSvcrRef']),
+            bankReference: details?.textAt(['Refs', 'AcctSvcrRef']) ?? this.bankReference,
             transactionCode: this.proprietaryCode[1],
             transactionTypeId: typeId,
             primaNota: this.proprietaryCode[2],
@@ -123,8 +175,30 @@ class CamtEntry {
         });
     }
 }
-function fail(message) {
-    throw new FormatError(message);
+/**
+ * The amount `element` states, in its currency or else in `currency`; throws `FormatError` for a negative one, whose
+ * sign the credit/debit indicator would turn: the indicator alone gives the direction.
+ */
+function amountOf(element, currency) {
+    const amount = Amount.parseDecimal(element.innerText, element.getAttribute('Ccy') ?? currency);
+    if (amount.isNegative)
+        throw new FormatError('Negative camt amount', element.innerText);
+    return amount;
+}
+/**
+ * `keywords` with the values of EREF, MREF and CRED that the bank `stated` apart, as `endToEndId`, `mandateId` and
+ * `creditorId`, in the place the text gives them, and without those it does not state: in the remittance text, which
+ * the payer or the payee writes, a creditor ID or mandate reference could be that of a creditor the app trusts.
+ */
+function withKeywordsStatedApart(keywords, stated) {
+    const codes = new Map(keywords);
+    for (const [keyword, value] of Object.entries(stated)) {
+        if (value === undefined)
+            codes.delete(keyword);
+        else
+            codes.set(keyword, value);
+    }
+    return codes;
 }
 /** `true` for `DBIT`, `false` for `CRDT`, `undefined` if `indicator` is missing; throws for any other value. */
 function debitIndicator(indicator) {
@@ -139,8 +213,15 @@ function debitIndicator(indicator) {
             throw new FormatError('camt credit/debit indicator is neither CRDT nor DBIT', indicator);
     }
 }
+/**
+ * The calendar date of `e`: its date (`Dt`), or else its date and time (`DtTm`), both read by `parseIsoDate`, so that
+ * a date and time, which may be stated in UTC or another offset, counts on its German day; `undefined` if it states
+ * neither. Throws `FormatError` for one it cannot read, which would pass for a missing one otherwise, such as a value
+ * date the booking date stands in for.
+ */
 function dateOf(e) {
-    return parseIsoDate(e?.textAt(['Dt']) ?? e?.textAt(['DtTm']));
+    const date = e?.textAt(['Dt']) ?? e?.textAt(['DtTm']);
+    return date === undefined ? undefined : (parseIsoDate(date) ?? fail('Unreadable camt date', date));
 }
 function partyName(party) {
     return party?.textAt(['Nm']) ?? party?.textAt(['Pty', 'Nm']);
@@ -148,12 +229,13 @@ function partyName(party) {
 function bicOf(agent) {
     return agent?.textAt(['FinInstnId', 'BIC']) ?? agent?.textAt(['FinInstnId', 'BICFI']);
 }
-/** The SEPA creditor identifier: the `Othr` identification in the scheme `SEPA`. */
-function creditorIdOf(parties) {
-    for (const other of parties?.descendantsNamed('Othr') ?? []) {
-        if (other.textAt(['SchmeNm', 'Prtry']) === 'SEPA')
-            return other.textAt(['Id']);
-    }
-    return undefined;
+/**
+ * The SEPA creditor identifier of the `creditor`: its private `Othr` identification in the scheme `SEPA`. The other
+ * parties' identifications are the creditor's or the debtor's to choose, and may be in that scheme as well.
+ */
+function creditorIdOf(creditor) {
+    const identifications = creditor?.at(['Id', 'PrvtId']) ?? creditor?.at(['Pty', 'Id', 'PrvtId']);
+    const sepa = identifications?.childrenNamed('Othr').find((other) => other.textAt(['SchmeNm', 'Prtry']) === 'SEPA');
+    return sepa?.textAt(['Id']);
 }
 //# sourceMappingURL=camt.js.map

package/dist/formats/camt.js.map

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