@coderoftime/fints 0.0.0-stage → 0.1.0

package/dist/core/transaction.d.ts

@@ -0,0 +1,98 @@
+import type { Amount } from './amount.js';
+/** Whether a transaction is booked or still pending. */
+export type TransactionStatus = 'booked' | 'pending';
+/** Transaction format to request; `auto` prefers camt.052 when the bank supports it. */
+export type TransactionFormat = 
+/** camt.052 where the bank offers it, otherwise MT940. */
+'auto'
+/** SWIFT MT940 (booked) and MT942 (pending). */
+ | 'mt940'
+/** ISO 20022 camt.052. */
+ | 'camt';
+/** What `Transaction` takes; the parsers fill in what the bank states. */
+export interface TransactionInit {
+    status?: TransactionStatus;
+    bookingDate?: Date | undefined;
+    valueDate: Date;
+    amount: Amount;
+    isReversal?: boolean;
+    bookingText?: string | undefined;
+    purpose?: string | undefined;
+    counterpartyName?: string | undefined;
+    counterpartyIban?: string | undefined;
+    counterpartyBic?: string | undefined;
+    counterpartyAccountNumber?: string | undefined;
+    counterpartyBankCode?: string | undefined;
+    endToEndId?: string | undefined;
+    mandateId?: string | undefined;
+    creditorId?: string | undefined;
+    customerReference?: string | undefined;
+    bankReference?: string | undefined;
+    transactionCode?: string | undefined;
+    transactionTypeId?: string | undefined;
+    primaNota?: string | undefined;
+    ultimateCreditor?: string | undefined;
+    ultimateDebtor?: string | undefined;
+    purposeCodes?: ReadonlyMap<string, string>;
+}
+/** A single account transaction, parsed from camt.052 or MT940/MT942. */
+export declare class Transaction {
+    /** Whether the transaction is booked or pending. */
+    readonly status: TransactionStatus;
+    /**
+     * Booking date; `undefined` where the bank states none, as for some pending transactions and MT940 entries without an
+     * entry date. A local `Date` at midnight, like every calendar date.
+     */
+    readonly bookingDate: Date | undefined;
+    /** Value date (Valuta); for a camt entry that states its booking date only, the booking date. */
+    readonly valueDate: Date;
+    /** Signed amount; negative for debits. */
+    readonly amount: Amount;
+    /** Whether this is a reversal (Storno) of an earlier booking. */
+    readonly isReversal: boolean;
+    /** Booking type text, for example `SEPA-UEBERWEISUNG`. */
+    readonly bookingText: string | undefined;
+    /** Remittance information; the `SVWZ+` part when the bank sends SEPA keywords. */
+    readonly purpose: string | undefined;
+    /** Payee for debits, payer for credits; for a reversal, the counterparty of the booking it reverses. */
+    readonly counterpartyName: string | undefined;
+    /** IBAN of the counterparty. */
+    readonly counterpartyIban: string | undefined;
+    /** BIC of the counterparty's bank. */
+    readonly counterpartyBic: string | undefined;
+    /** National account number of the counterparty, where the bank does not state an IBAN. */
+    readonly counterpartyAccountNumber: string | undefined;
+    /** German bank code of the counterparty's bank, where the bank does not state a BIC. */
+    readonly counterpartyBankCode: string | undefined;
+    /** SEPA end-to-end reference (EREF). */
+    readonly endToEndId: string | undefined;
+    /** SEPA direct debit mandate reference (MREF). */
+    readonly mandateId: string | undefined;
+    /** SEPA creditor identifier (CRED). */
+    readonly creditorId: string | undefined;
+    /** Reference the customer gave the order. */
+    readonly customerReference: string | undefined;
+    /** Reference the bank gave the booking. */
+    readonly bankReference: string | undefined;
+    /** German business transaction code (Geschäftsvorfallcode, GVC). */
+    readonly transactionCode: string | undefined;
+    /** SWIFT transaction type, for example `NTRF`. */
+    readonly transactionTypeId: string | undefined;
+    /** Prima nota number of the booking. */
+    readonly primaNota: string | undefined;
+    /** The party the payee acts for, where that is not the payee itself. */
+    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, …). */
+    readonly purposeCodes: ReadonlyMap<string, string>;
+    constructor(init: TransactionInit);
+    /** Whether the transaction is still pending. */
+    get isPending(): boolean;
+    /**
+     * The date and status only, without amount, counterparty or purpose, so that logs and crash reports do not collect
+     * account data.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=transaction.d.ts.map

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

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

package/dist/core/transaction.js

@@ -0,0 +1,91 @@
+import { 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 {
+    /** Whether the transaction is booked or pending. */
+    status;
+    /**
+     * Booking date; `undefined` where the bank states none, as for some pending transactions and MT940 entries without an
+     * entry date. A local `Date` at midnight, like every calendar date.
+     */
+    bookingDate;
+    /** Value date (Valuta); for a camt entry that states its booking date only, the booking date. */
+    valueDate;
+    /** Signed amount; negative for debits. */
+    amount;
+    /** Whether this is a reversal (Storno) of an earlier booking. */
+    isReversal;
+    /** Booking type text, for example `SEPA-UEBERWEISUNG`. */
+    bookingText;
+    /** Remittance information; the `SVWZ+` part when the bank sends SEPA keywords. */
+    purpose;
+    /** Payee for debits, payer for credits; for a reversal, the counterparty of the booking it reverses. */
+    counterpartyName;
+    /** IBAN of the counterparty. */
+    counterpartyIban;
+    /** BIC of the counterparty's bank. */
+    counterpartyBic;
+    /** National account number of the counterparty, where the bank does not state an IBAN. */
+    counterpartyAccountNumber;
+    /** German bank code of the counterparty's bank, where the bank does not state a BIC. */
+    counterpartyBankCode;
+    /** SEPA end-to-end reference (EREF). */
+    endToEndId;
+    /** SEPA direct debit mandate reference (MREF). */
+    mandateId;
+    /** SEPA creditor identifier (CRED). */
+    creditorId;
+    /** Reference the customer gave the order. */
+    customerReference;
+    /** Reference the bank gave the booking. */
+    bankReference;
+    /** German business transaction code (Geschäftsvorfallcode, GVC). */
+    transactionCode;
+    /** SWIFT transaction type, for example `NTRF`. */
+    transactionTypeId;
+    /** Prima nota number of the booking. */
+    primaNota;
+    /** The party the payee acts for, where that is not the payee itself. */
+    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, …). */
+    purposeCodes;
+    constructor(init) {
+        this.status = init.status ?? 'booked';
+        this.bookingDate = init.bookingDate;
+        this.valueDate = init.valueDate;
+        this.amount = init.amount;
+        this.isReversal = init.isReversal ?? false;
+        this.bookingText = init.bookingText;
+        this.purpose = init.purpose;
+        this.counterpartyName = init.counterpartyName;
+        this.counterpartyIban = init.counterpartyIban;
+        this.counterpartyBic = init.counterpartyBic;
+        this.counterpartyAccountNumber = init.counterpartyAccountNumber;
+        this.counterpartyBankCode = init.counterpartyBankCode;
+        this.endToEndId = init.endToEndId;
+        this.mandateId = init.mandateId;
+        this.creditorId = init.creditorId;
+        this.customerReference = init.customerReference;
+        this.bankReference = init.bankReference;
+        this.transactionCode = init.transactionCode;
+        this.transactionTypeId = init.transactionTypeId;
+        this.primaNota = init.primaNota;
+        this.ultimateCreditor = init.ultimateCreditor;
+        this.ultimateDebtor = init.ultimateDebtor;
+        this.purposeCodes = new ImmutableMap(init.purposeCodes ?? []);
+    }
+    /** Whether the transaction is still pending. */
+    get isPending() {
+        return this.status === 'pending';
+    }
+    /**
+     * The date and status only, without amount, counterparty or purpose, so that logs and crash reports do not collect
+     * account data.
+     */
+    toString() {
+        return `Transaction(${formatIsoDate(this.bookingDate ?? this.valueDate)}, ${this.status}${this.isReversal ? ', reversal' : ''})`;
+    }
+}
+//# sourceMappingURL=transaction.js.map

package/dist/core/transaction.js.map

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

package/dist/core/transport.d.ts

@@ -0,0 +1,37 @@
+/** Sends one FinTS message and returns the bank's reply; replace it for a relay, proxies, pinning or tests. */
+export interface FinTsTransport {
+    /**
+     * Posts `body` to `url` and returns the response body.
+     *
+     * Implementations report failures as `FinTsTransportError`.
+     */
+    post(url: URL, body: Uint8Array, contentType: string): 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. */
+    fetch?: typeof fetch;
+    /** Time for the whole exchange in milliseconds, from sending the request to the last byte of the response; 90 s. */
+    timeoutMs?: number;
+    /** Largest response accepted, so that a faulty server cannot exhaust the memory; 16 MiB. */
+    maxResponseBytes?: number;
+}
+/**
+ * Default `FinTsTransport`: HTTP POST with `fetch`.
+ *
+ * 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.
+ */
+export declare class HttpTransport implements FinTsTransport {
+    readonly timeoutMs: number;
+    readonly maxResponseBytes: number;
+    private readonly fetchFn;
+    constructor(options?: HttpTransportOptions);
+    post(url: URL, body: Uint8Array, contentType: string): Promise<Uint8Array>;
+    private exchange;
+    private readBody;
+    close(): void;
+}
+//# sourceMappingURL=transport.d.ts.map

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

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

package/dist/core/transport.js

@@ -0,0 +1,92 @@
+import { concatBytes } from '../util/bytes.js';
+import { FinTsTransportError } from './errors.js';
+/**
+ * Default `FinTsTransport`: HTTP POST with `fetch`.
+ *
+ * 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.
+ */
+export class HttpTransport {
+    timeoutMs;
+    maxResponseBytes;
+    fetchFn;
+    constructor(options = {}) {
+        this.fetchFn = options.fetch ?? ((input, init) => fetch(input, init));
+        this.timeoutMs = options.timeoutMs ?? 90_000;
+        this.maxResponseBytes = options.maxResponseBytes ?? 16 << 20;
+    }
+    async post(url, body, contentType) {
+        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);
+        });
+        try {
+            return await Promise.race([this.exchange(url, body, contentType, controller.signal), timedOut]);
+        }
+        catch (error) {
+            if (error instanceof FinTsTransportError)
+                throw error;
+            if (controller.signal.aborted)
+                throw new FinTsTransportError('Request timed out');
+            throw new FinTsTransportError(describe(error));
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async exchange(url, body, contentType, signal) {
+        const response = await this.fetchFn(url, {
+            method: 'POST',
+            body: body,
+            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',
+            signal,
+        });
+        if (response.type === 'opaqueredirect') {
+            throw new FinTsTransportError('The server redirects the request, which the client does not follow');
+        }
+        if (response.status < 200 || response.status > 299) {
+            await response.body?.cancel().catch(() => undefined);
+            throw new FinTsTransportError(`HTTP ${response.status} ${response.statusText}`.trim(), {
+                statusCode: response.status,
+            });
+        }
+        return this.readBody(response);
+    }
+    async readBody(response) {
+        const reader = response.body?.getReader();
+        if (reader === undefined)
+            return new Uint8Array(await response.arrayBuffer());
+        const chunks = [];
+        let size = 0;
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            chunks.push(value);
+            size += value.length;
+            if (size > this.maxResponseBytes) {
+                await reader.cancel().catch(() => undefined);
+                throw new FinTsTransportError(`Response larger than ${this.maxResponseBytes} bytes`);
+            }
+        }
+        return concatBytes(chunks);
+    }
+    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) {
+    if (!(error instanceof Error))
+        return String(error);
+    const cause = error.cause;
+    return cause instanceof Error ? `${error.message}: ${cause.message}` : error.message;
+}
+//# sourceMappingURL=transport.js.map

package/dist/core/transport.js.map

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

package/dist/formats/camt.d.ts

@@ -0,0 +1,12 @@
+import { Transaction, type TransactionStatus } from '../core/transaction.js';
+/** Parser for ISO 20022 camt.052 and camt.053 account reports. */
+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.
+     */
+    parseTransactions(xml: string, status?: TransactionStatus): Transaction[];
+}>;
+//# sourceMappingURL=camt.d.ts.map

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

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

package/dist/formats/camt.js

@@ -0,0 +1,159 @@
+import { Amount } from '../core/amount.js';
+import { Transaction } from '../core/transaction.js';
+import { parseIsoDate } from '../util/dates.js';
+import { FormatError } from '../util/errors.js';
+import { parseXml } from '../util/xml.js';
+import { providedReference, SepaPurpose } from './sepa-purpose.js';
+/** Parser for ISO 20022 camt.052 and camt.053 account reports. */
+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.
+     */
+    parseTransactions(xml, status) {
+        const root = parseXml(xml.trim());
+        return root.descendantsNamed('Ntry').flatMap((entry) => new CamtEntry(entry, status).transactions());
+    },
+});
+/** 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.
+ *
+ * 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;
+    amountElement;
+    currency;
+    debit;
+    reversal;
+    status;
+    bookingDate;
+    valueDate;
+    /** German banks send `transaction type+GVC+prima nota`, for example `NDDT+105+9310`. */
+    proprietaryCode;
+    constructor(entry, forcedStatus) {
+        this.entry = entry;
+        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');
+        this.reversal = ['true', '1'].includes(entry.textAt(['RvslInd']) ?? '');
+        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.proprietaryCode = entry.textAt(['BkTxCd', 'Prtry', 'Cd'])?.split('+') ?? [];
+    }
+    statusOfEntry() {
+        const code = this.entry.textAt(['Sts', 'Cd']) ?? this.entry.textAt(['Sts']);
+        return code === 'PDNG' || code === 'INFO' ? 'pending' : 'booked';
+    }
+    transactions() {
+        const total = Amount.parseDecimal(this.amountElement.innerText, this.currency);
+        const details = this.entry.descendantsNamed('TxDtls');
+        if (details.length <= 1)
+            return [this.transaction(details[0], 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);
+        });
+    }
+    /** A transaction of `amount`, booked as a debit if `debit`, with what `details` tell about it. */
+    transaction(details, amount, debit) {
+        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 keywords = SepaPurpose.parseParts(purposeParts);
+        const endToEndId = providedReference(details?.textAt(['Refs', 'EndToEndId']));
+        const mandateId = details?.textAt(['Refs', 'MndtId']);
+        const creditorId = creditorIdOf(parties);
+        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);
+        if (purposeCode !== undefined)
+            purposeCodes.set('PURP', purposeCode);
+        return new Transaction({
+            status: this.status,
+            bookingDate: this.bookingDate,
+            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),
+            counterpartyName: partyName(parties?.child(counterparty)),
+            counterpartyIban: parties?.child(`${counterparty}Acct`)?.textAt(['Id', 'IBAN']),
+            counterpartyAccountNumber: parties?.child(`${counterparty}Acct`)?.textAt(['Id', 'Othr', 'Id']),
+            counterpartyBic: bicOf(agents?.child(`${counterparty}Agt`)),
+            endToEndId,
+            mandateId,
+            creditorId,
+            customerReference: details?.textAt(['Refs', 'InstrId']) ?? details?.textAt(['Refs', 'PmtInfId']),
+            bankReference: details?.textAt(['Refs', 'AcctSvcrRef']) ?? this.entry.textAt(['AcctSvcrRef']),
+            transactionCode: this.proprietaryCode[1],
+            transactionTypeId: typeId,
+            primaNota: this.proprietaryCode[2],
+            ultimateCreditor: partyName(parties?.child('UltmtCdtr')),
+            ultimateDebtor: partyName(parties?.child('UltmtDbtr')),
+            purposeCodes,
+        });
+    }
+}
+function fail(message) {
+    throw new FormatError(message);
+}
+/** `true` for `DBIT`, `false` for `CRDT`, `undefined` if `indicator` is missing; throws for any other value. */
+function debitIndicator(indicator) {
+    switch (indicator) {
+        case 'DBIT':
+            return true;
+        case 'CRDT':
+            return false;
+        case undefined:
+            return undefined;
+        default:
+            throw new FormatError('camt credit/debit indicator is neither CRDT nor DBIT', indicator);
+    }
+}
+function dateOf(e) {
+    return parseIsoDate(e?.textAt(['Dt']) ?? e?.textAt(['DtTm']));
+}
+function partyName(party) {
+    return party?.textAt(['Nm']) ?? party?.textAt(['Pty', 'Nm']);
+}
+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;
+}
+//# sourceMappingURL=camt.js.map

package/dist/formats/camt.js.map

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

package/dist/formats/mt940.d.ts

@@ -0,0 +1,42 @@
+import { Amount } from '../core/amount.js';
+import { Transaction, type TransactionStatus } from '../core/transaction.js';
+/** One statement from an MT940 or MT942 file, with its balances and transactions. */
+export interface Mt940Statement {
+    /** The sender's reference of the statement (field 20). */
+    readonly reference: string | undefined;
+    /** The account the statement is for (field 25). */
+    readonly accountId: string | undefined;
+    /** Statement and sequence number (field 28C). */
+    readonly statementNumber: string | undefined;
+    /** Currency of the statement; `undefined` for a statement without balances and transactions. */
+    readonly currency: string | undefined;
+    /** The balance at the start of the statement (field 60), negative for a debit. */
+    readonly openingBalance: Amount | undefined;
+    /** The date of `openingBalance`. */
+    readonly openingDate: Date | undefined;
+    /** The balance at the end of the statement (field 62), negative for a debit. */
+    readonly closingBalance: Amount | undefined;
+    /** The date of `closingBalance`. */
+    readonly closingDate: Date | undefined;
+    /** The transactions of the statement, in the order the bank lists them. */
+    readonly transactions: readonly Transaction[];
+}
+/** What the MT940 parser takes besides the text. */
+export interface Mt940Options {
+    /** The status of the transactions: `booked` (MT940, the default) or `pending` (MT942). */
+    status?: TransactionStatus;
+    /** The currency of statements that state none in their balances. */
+    currency?: string | undefined;
+}
+/** Parser for SWIFT MT940/MT942 statements, including German structured `:86:` fields. */
+export declare const Mt940: Readonly<{
+    /** Parses all transactions; see `parse`. */
+    parseTransactions(text: string, options?: Mt940Options): Transaction[];
+    /**
+     * Parses all statements.
+     *
+     * Throws `FormatError` if a transaction line (`:61:`) cannot be read or the currency of a transaction is unknown.
+     */
+    parse(text: string, options?: Mt940Options): Mt940Statement[];
+}>;
+//# sourceMappingURL=mt940.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mt940.d.ts","sourceRoot":"","sources":["../../src/formats/mt940.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAM7E,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,iDAAiD;IACjD,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,gGAAgG;IAChG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,kFAAkF;IAClF,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,oCAAoC;IACpC,QAAQ,CAAC,WAAW,EAAE,IAAI,GAAG,SAAS,CAAC;IACvC,gFAAgF;IAChF,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,oCAAoC;IACpC,QAAQ,CAAC,WAAW,EAAE,IAAI,GAAG,SAAS,CAAC;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;CAC/C;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,0FAA0F;IAC1F,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAMD,0FAA0F;AAC1F,eAAO,MAAM,KAAK;IAChB,4CAA4C;4BACpB,MAAM,YAAW,YAAY,GAAQ,WAAW,EAAE;IAI1E;;;;OAIG;gBACS,MAAM,YAAW,YAAY,GAAQ,cAAc,EAAE;EAuBjE,CAAC"}