@ekwo-ai/camt053 0.4.0

package/dist/types.d.ts

@@ -0,0 +1,210 @@
+/**
+ * What a statement is once it has been read: an account, two balances and
+ * lines. The shape is declared here and imported from nowhere — it names no
+ * table, no ledger and no country, so anything that keeps books can take it.
+ *
+ * Every amount is a **decimal string**, signed from the account holder's side:
+ * money in is positive, money out is negative, an overdrawn balance is
+ * negative. No figure of a statement passes through a `number`.
+ */
+/**
+ * How an account is identified. ISO 20022 gives a choice and so does this
+ * type: an IBAN (ISO 13616) **or** anything else — a domestic account number,
+ * a routing number and an account, whatever the bank's country uses. Half the
+ * world has no IBAN, and a reader that only returned one would read half the
+ * statements.
+ */
+export type AccountIdentifier = {
+    kind: 'iban';
+    /** As written, without spaces, upper case. */
+    value: string;
+} | {
+    kind: 'other';
+    /** `Othr/Id`, as written. */
+    value: string;
+    /** `SchmeNm/Cd` (an ISO external code such as `BBAN`) or `SchmeNm/Prtry`. */
+    scheme: string | null;
+    /** `Othr/Issr`, who assigned it. */
+    issuer: string | null;
+};
+export interface StatementAccount {
+    identifier: AccountIdentifier;
+    /** `Acct/Ccy`. Null when the bank does not say; the balances still do. */
+    currency: string | null;
+    name: string | null;
+    ownerName: string | null;
+    /** BIC of the institution servicing the account, when given. */
+    servicerBic: string | null;
+}
+export interface StatementBalance {
+    /**
+     * `Tp/CdOrPrtry/Cd` — `OPBD` opening booked, `CLBD` closing booked, `PRCD`
+     * previous closing, `ITBD` interim, `CLAV` closing available… — or the
+     * proprietary label when the bank uses one.
+     */
+    type: string;
+    /** Signed: a debit balance is negative. */
+    amount: string;
+    currency: string;
+    /** The day, `YYYY-MM-DD`, as the bank wrote it — no timezone is applied. */
+    date: string | null;
+}
+export interface StructuredReference {
+    /** `CdtrRefInf/Ref`: the creditor reference itself. */
+    reference: string;
+    /** `CdtrRefInf/Tp/CdOrPrtry/Cd`, usually `SCOR`; or the proprietary label. */
+    type: string | null;
+    /** `CdtrRefInf/Tp/Issr`: who defined the reference — `ISO` for an RF one. */
+    issuer: string | null;
+}
+export interface Remittance {
+    /** Every `RmtInf/Ustrd`, in order. Free text: what a person typed. */
+    unstructured: string[];
+    /** Every `RmtInf/Strd/CdtrRefInf` that carries a reference, in order. */
+    structured: StructuredReference[];
+}
+export interface Counterparty {
+    name: string | null;
+    account: AccountIdentifier | null;
+    /** BIC of the counterparty's bank, when given. */
+    agentBic: string | null;
+    /** The ultimate debtor or creditor behind the counterparty, when named. */
+    ultimateName: string | null;
+}
+export interface BankTransactionCode {
+    /** ISO 20022 external code set: domain, family, sub-family. */
+    domain: string | null;
+    family: string | null;
+    subFamily: string | null;
+    /** The bank's own code, and who issued the code list. */
+    proprietary: string | null;
+    proprietaryIssuer: string | null;
+}
+export interface StatementLine {
+    /** Position among the statement's lines, from 1. */
+    index: number;
+    /** Position of the `Ntry` this line comes from, from 1. */
+    entry: number;
+    /**
+     * When the entry was a batch split into its transactions: which one this is,
+     * from 1, and out of how many. Both null when the line is the whole entry.
+     */
+    detail: number | null;
+    detailCount: number | null;
+    /**
+     * `BOOK`, `PDNG`, `INFO`, `FUTR`, or the proprietary label. Only booked
+     * entries move the balance, and only they are counted in the balance check.
+     */
+    status: string;
+    booked: boolean;
+    /** `RvslInd`: this entry reverses an earlier one. */
+    reversal: boolean;
+    /** `BookgDt`, `YYYY-MM-DD`. Falls back to nothing: a missing date is reported. */
+    bookingDate: string | null;
+    /** `ValDt`, `YYYY-MM-DD`. */
+    valueDate: string | null;
+    /** Signed: positive is money in. Null when the file's figure is unreadable. */
+    amount: string | null;
+    currency: string | null;
+    /** Signed amount of the whole entry when this line is one part of it. */
+    entryAmount: string | null;
+    /**
+     * The bank's own reference for this movement: the transaction's
+     * `Refs/AcctSvcrRef`, else the entry's `AcctSvcrRef`. Unique per movement at
+     * a given bank when present — and optional in the schema, so it may be null.
+     */
+    bankReference: string | null;
+    /** `NtryRef`: unique within the statement, by the message definition. */
+    entryReference: string | null;
+    /** As written — including the placeholder `NOTPROVIDED` when the bank writes it. */
+    endToEndId: string | null;
+    transactionId: string | null;
+    instructionId: string | null;
+    paymentInformationId: string | null;
+    mandateId: string | null;
+    counterparty: Counterparty | null;
+    remittance: Remittance;
+    bankTransactionCode: BankTransactionCode | null;
+    /** `RtrInf/Rsn`: why a payment came back — ISO code or proprietary label. */
+    returnReason: string | null;
+    /**
+     * `AmtDtls/InstdAmt`: what was ordered, in the currency it was ordered in,
+     * unsigned as the file writes it. The line's `amount` stays what moved on
+     * the account; nothing is converted here.
+     */
+    instructedAmount: {
+        amount: string;
+        currency: string;
+    } | null;
+    /** `AmtDtls/…/CcyXchg/XchgRate`, as written. */
+    exchangeRate: string | null;
+    /** `AddtlTxInf`, else `AddtlNtryInf`. */
+    additionalInformation: string | null;
+}
+export interface Statement {
+    /** `Stmt/Id`. */
+    id: string;
+    electronicSequenceNumber: string | null;
+    legalSequenceNumber: string | null;
+    /** `CreDtTm`, as written. */
+    createdAt: string | null;
+    /** `FrToDt`, by day. */
+    period: {
+        from: string | null;
+        to: string | null;
+    } | null;
+    /** `StmtPgntn`, from version 03 on: a statement delivered in several files. */
+    page: {
+        number: string;
+        last: boolean;
+    } | null;
+    account: StatementAccount;
+    /** `OPBD`, else `PRCD`. */
+    openingBalance: StatementBalance | null;
+    /** `CLBD`. */
+    closingBalance: StatementBalance | null;
+    /** Every `Bal`, in file order, including the two above. */
+    balances: StatementBalance[];
+    lines: StatementLine[];
+    /**
+     * Opening balance plus booked entries equals closing balance: true, false,
+     * or null when it could not be checked (a balance missing, a figure
+     * unreadable, an entry in another currency). False is reported as
+     * `balance_mismatch` and **never corrected**.
+     */
+    balanced: boolean | null;
+}
+export interface Violation {
+    /** A stable token, for a caller that branches on it. */
+    code: ViolationCode;
+    /** What is wrong, in a sentence. */
+    message: string;
+    /** Which statement of the file, from 1. */
+    statement: number;
+    /** Which line of that statement (`StatementLine.index`), where there is one. */
+    line?: number;
+}
+export type ViolationCode = 'version_not_verified' | 'balance_mismatch' | 'opening_balance_missing' | 'closing_balance_missing' | 'balance_currency_mismatch' | 'foreign_currency_entry' | 'invalid_amount' | 'invalid_direction' | 'invalid_date' | 'booking_date_missing' | 'invalid_iban' | 'duplicate_bank_reference' | 'duplicate_entry_reference' | 'batch_not_split' | 'batch_count_mismatch';
+export interface StatementFile {
+    /** The namespace of the document element: the version that was read. */
+    namespace: string;
+    /** `02`, `08`… — the last part of the message identifier. */
+    version: string;
+    /** Whether this package's tests hold that version against its schema. */
+    versionVerified: boolean;
+    /** `GrpHdr/MsgId`. */
+    messageId: string | null;
+    /** `GrpHdr/CreDtTm`, as written. */
+    createdAt: string | null;
+    statements: Statement[];
+    violations: Violation[];
+}
+export interface ReadOptions {
+    /** Refuse a larger file unread. Default 32 MiB. */
+    maxBytes?: number;
+    /** Refuse deeper nesting. Default 64; the deepest path of the schema is under 20. */
+    maxDepth?: number;
+    /** Refuse more elements. Default 2,000,000. */
+    maxElements?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,11 @@
+/**
+ * What a statement is once it has been read: an account, two balances and
+ * lines. The shape is declared here and imported from nowhere — it names no
+ * table, no ledger and no country, so anything that keeps books can take it.
+ *
+ * Every amount is a **decimal string**, signed from the account holder's side:
+ * money in is positive, money out is negative, an overdrawn balance is
+ * negative. No figure of a statement passes through a `number`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/xml.d.ts

@@ -0,0 +1,40 @@
+/**
+ * A strict, small XML reader, written here because a statement comes from
+ * outside and this package depends on nothing.
+ *
+ * It reads the XML a bank writes and refuses the XML an attacker writes:
+ *
+ * - **no DOCTYPE at all**, so no internal subset, no entity declaration, no
+ *   external entity, no parameter entity — the billion-laughs family and the
+ *   XXE family both start with `<!DOCTYPE` and both stop there;
+ * - the five predefined entities and numeric character references, and any
+ *   other `&name;` is an error rather than an empty string;
+ * - a size limit applied before anything is read, a depth limit and an element
+ *   limit applied while reading, and no recursion: nesting costs heap the
+ *   limits bound, never stack;
+ * - UTF-8 only, decoded fatally: a byte that is not UTF-8 is an error and not a
+ *   replacement character in somebody's name;
+ * - namespaces resolved, because a bank may write `<Document xmlns="…">` or
+ *   `<ns2:Document xmlns:ns2="…">` and both are the same statement.
+ *
+ * It is not a general XML parser and says so: element and attribute names are
+ * ASCII (every ISO 20022 name is), and nothing is validated against a schema.
+ */
+export interface XmlElement {
+    /** Local name, without prefix. */
+    name: string;
+    /** Namespace URI, `''` when the element is in none. */
+    namespace: string;
+    /** Attributes by the name they were written under; `xmlns` ones left out. */
+    attributes: Record<string, string>;
+    children: XmlElement[];
+    /** The element's own character data, concatenated; children's is theirs. */
+    text: string;
+}
+export interface XmlLimits {
+    maxBytes: number;
+    maxDepth: number;
+    maxElements: number;
+}
+export declare function parseXml(input: string | Uint8Array, limits: XmlLimits): XmlElement;
+//# sourceMappingURL=xml.d.ts.map

package/dist/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../src/xml.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAwID,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,MAAM,EAAE,SAAS,GAAG,UAAU,CAsKlF"}

package/dist/xml.js

@@ -0,0 +1,274 @@
+import { StatementFileError } from './errors.js';
+const NAME = /[A-Za-z_][A-Za-z0-9_.-]*(?::[A-Za-z_][A-Za-z0-9_.-]*)?/y;
+const ATTRIBUTE = /\s+([A-Za-z_][A-Za-z0-9_.-]*(?::[A-Za-z_][A-Za-z0-9_.-]*)?)\s*=\s*(?:"([^<"]*)"|'([^<']*)')/y;
+const DECLARATION = /^<\?xml\s+version\s*=\s*(?:"1\.[0-9]+"|'1\.[0-9]+')(?:\s+encoding\s*=\s*(?:"([A-Za-z][A-Za-z0-9._-]*)"|'([A-Za-z][A-Za-z0-9._-]*)'))?(?:\s+standalone\s*=\s*(?:"(?:yes|no)"|'(?:yes|no)'))?\s*\?>/;
+const REFERENCE = /&(?:#x([0-9a-fA-F]+)|#([0-9]+)|([A-Za-z_][A-Za-z0-9_.-]*));/g;
+const PREDEFINED = {
+    lt: '<',
+    gt: '>',
+    amp: '&',
+    quot: '"',
+    apos: "'",
+};
+const XML_NAMESPACE = 'http://www.w3.org/XML/1998/namespace';
+function malformed(what, at) {
+    return new StatementFileError('malformed_xml', `${what} (at character ${at})`);
+}
+/** XML 1.0 `Char`, by code point. */
+function isXmlChar(code) {
+    return (code === 0x9 ||
+        code === 0xa ||
+        code === 0xd ||
+        (code >= 0x20 && code <= 0xd7ff) ||
+        (code >= 0xe000 && code <= 0xfffd) ||
+        (code >= 0x10000 && code <= 0x10ffff));
+}
+/** The first code unit XML does not allow in a document, or -1. */
+function firstForbiddenCharacter(source) {
+    for (let index = 0; index < source.length; index += 1) {
+        const code = source.charCodeAt(index);
+        if (code >= 0x20 && code < 0xfffe)
+            continue;
+        if (code === 0x9 || code === 0xa || code === 0xd)
+            continue;
+        return index;
+    }
+    return -1;
+}
+function decodeReferences(raw, at) {
+    if (!raw.includes('&'))
+        return raw;
+    let out = '';
+    let last = 0;
+    for (const match of raw.matchAll(REFERENCE)) {
+        const index = match.index;
+        const between = raw.slice(last, index);
+        if (between.includes('&'))
+            throw malformed('a bare "&"', at + last + between.indexOf('&'));
+        out += between;
+        if (match[3] !== undefined) {
+            const value = PREDEFINED[match[3]];
+            if (value === undefined) {
+                throw new StatementFileError('undefined_entity', `entity &${match[3]}; is not one of the five XML predefines, and this reader declares no other (at character ${at + index})`);
+            }
+            out += value;
+        }
+        else {
+            const code = match[1] !== undefined ? parseInt(match[1], 16) : parseInt(match[2], 10);
+            if (!isXmlChar(code)) {
+                throw malformed(`character reference ${match[0]} is not an XML character`, at + index);
+            }
+            out += String.fromCodePoint(code);
+        }
+        last = index + match[0].length;
+    }
+    const rest = raw.slice(last);
+    if (rest.includes('&'))
+        throw malformed('a bare "&"', at + last + rest.indexOf('&'));
+    return out + rest;
+}
+function decode(input, limits) {
+    if (typeof input === 'string') {
+        // A string has no bytes to count; its length is the closest honest bound,
+        // and UTF-8 never encodes a code unit in less than one byte.
+        if (input.length > limits.maxBytes) {
+            throw new StatementFileError('too_large', `the file is ${input.length} characters, over the limit of ${limits.maxBytes}`);
+        }
+        return input.charCodeAt(0) === 0xfeff ? input.slice(1) : input;
+    }
+    if (input.byteLength > limits.maxBytes) {
+        throw new StatementFileError('too_large', `the file is ${input.byteLength} bytes, over the limit of ${limits.maxBytes}`);
+    }
+    const first = input[0];
+    const second = input[1];
+    if ((first === 0xfe && second === 0xff) || (first === 0xff && second === 0xfe)) {
+        throw new StatementFileError('unsupported_encoding', 'the file is UTF-16; this reader takes UTF-8');
+    }
+    let text;
+    try {
+        text = new TextDecoder('utf-8', { fatal: true }).decode(input);
+    }
+    catch {
+        throw new StatementFileError('unsupported_encoding', 'the file is not valid UTF-8; decode it first and pass the string');
+    }
+    const declaration = DECLARATION.exec(text);
+    const encoding = declaration?.[1] ?? declaration?.[2];
+    if (encoding !== undefined && !/^utf-?8$/i.test(encoding)) {
+        throw new StatementFileError('unsupported_encoding', `the file declares encoding ${encoding}; this reader takes UTF-8 — decode it first and pass the string`);
+    }
+    return text;
+}
+function isSpace(character) {
+    return character === ' ' || character === '\n' || character === '\t';
+}
+export function parseXml(input, limits) {
+    const source = decode(input, limits).replace(/\r\n?/g, '\n');
+    const forbidden = firstForbiddenCharacter(source);
+    if (forbidden !== -1)
+        throw malformed('a control character XML does not allow', forbidden);
+    let at = 0;
+    const declaration = DECLARATION.exec(source);
+    if (declaration)
+        at = declaration[0].length;
+    const rootScope = new Map([['xml', XML_NAMESPACE]]);
+    const stack = [];
+    let root;
+    let elements = 0;
+    const addText = (raw, where, literal) => {
+        const top = stack[stack.length - 1];
+        if (top === undefined) {
+            if (raw.trim() !== '')
+                throw malformed('text outside the document element', where);
+            return;
+        }
+        top.text.push(literal ? raw : decodeReferences(raw, where));
+    };
+    while (at < source.length) {
+        const lt = source.indexOf('<', at);
+        if (lt === -1) {
+            addText(source.slice(at), at, false);
+            at = source.length;
+            break;
+        }
+        if (lt > at)
+            addText(source.slice(at, lt), at, false);
+        at = lt;
+        if (source.startsWith('<!--', at)) {
+            const end = source.indexOf('-->', at + 4);
+            if (end === -1)
+                throw malformed('a comment that never ends', at);
+            at = end + 3;
+            continue;
+        }
+        if (source.startsWith('<![CDATA[', at)) {
+            if (stack.length === 0)
+                throw malformed('a CDATA section outside the document element', at);
+            const end = source.indexOf(']]>', at + 9);
+            if (end === -1)
+                throw malformed('a CDATA section that never ends', at);
+            addText(source.slice(at + 9, end), at, true);
+            at = end + 3;
+            continue;
+        }
+        if (source.startsWith('<!DOCTYPE', at)) {
+            throw new StatementFileError('doctype_forbidden', 'the file carries a DOCTYPE; a statement needs none, and entity declarations are refused unread');
+        }
+        if (source.startsWith('<!', at))
+            throw malformed('a markup declaration', at);
+        if (source.startsWith('<?', at)) {
+            const end = source.indexOf('?>', at + 2);
+            if (end === -1)
+                throw malformed('a processing instruction that never ends', at);
+            if (/^<\?xml[\s?]/i.test(source.slice(at, at + 6))) {
+                throw malformed('an XML declaration anywhere but the first character', at);
+            }
+            at = end + 2;
+            continue;
+        }
+        if (source.startsWith('</', at)) {
+            NAME.lastIndex = at + 2;
+            const name = NAME.exec(source);
+            if (!name)
+                throw malformed('a closing tag without a name', at);
+            let end = NAME.lastIndex;
+            while (isSpace(source[end]))
+                end += 1;
+            if (source[end] !== '>')
+                throw malformed('a closing tag that never ends', at);
+            const open = stack.pop();
+            if (open === undefined || open.qualifiedName !== name[0]) {
+                throw malformed(`</${name[0]}> closes ${open ? `<${open.qualifiedName}>` : 'nothing'}`, at);
+            }
+            open.element.text = open.text.join('');
+            at = end + 1;
+            continue;
+        }
+        // An opening tag.
+        NAME.lastIndex = at + 1;
+        const name = NAME.exec(source);
+        if (!name)
+            throw malformed('a "<" that opens nothing', at);
+        if (root !== undefined && stack.length === 0) {
+            throw malformed('a second document element', at);
+        }
+        elements += 1;
+        if (elements > limits.maxElements) {
+            throw new StatementFileError('too_many_elements', `the file holds more than ${limits.maxElements} elements`);
+        }
+        if (stack.length >= limits.maxDepth) {
+            throw new StatementFileError('too_deep', `elements are nested deeper than ${limits.maxDepth}`);
+        }
+        let cursor = NAME.lastIndex;
+        const written = [];
+        for (;;) {
+            ATTRIBUTE.lastIndex = cursor;
+            const attribute = ATTRIBUTE.exec(source);
+            if (!attribute)
+                break;
+            const raw = (attribute[2] ?? attribute[3]);
+            written.push([
+                attribute[1],
+                decodeReferences(raw, cursor).replace(/[\t\n]/g, ' '),
+            ]);
+            cursor = ATTRIBUTE.lastIndex;
+        }
+        while (isSpace(source[cursor]))
+            cursor += 1;
+        const selfClosing = source[cursor] === '/';
+        if (selfClosing)
+            cursor += 1;
+        if (source[cursor] !== '>')
+            throw malformed(`<${name[0]}> is not a well-formed tag`, at);
+        const parentScope = stack[stack.length - 1]?.scope ?? rootScope;
+        let scope = parentScope;
+        const attributes = {};
+        const seen = new Set();
+        for (const [key, value] of written) {
+            if (seen.has(key))
+                throw malformed(`attribute ${key} is written twice on <${name[0]}>`, at);
+            seen.add(key);
+            if (key === 'xmlns' || key.startsWith('xmlns:')) {
+                if (scope === parentScope)
+                    scope = new Map(parentScope);
+                const prefix = key === 'xmlns' ? '' : key.slice(6);
+                if (prefix === 'xml' || prefix === 'xmlns') {
+                    throw malformed(`prefix ${prefix} cannot be declared`, at);
+                }
+                if (prefix !== '' && value === '')
+                    throw malformed(`prefix ${prefix} is bound to nothing`, at);
+                scope.set(prefix, value);
+            }
+            else {
+                attributes[key] = value;
+            }
+        }
+        const colon = name[0].indexOf(':');
+        const prefix = colon === -1 ? '' : name[0].slice(0, colon);
+        const namespace = scope.get(prefix);
+        if (namespace === undefined && prefix !== '') {
+            throw malformed(`prefix ${prefix} is bound to no namespace`, at);
+        }
+        const element = {
+            name: colon === -1 ? name[0] : name[0].slice(colon + 1),
+            namespace: namespace ?? '',
+            attributes,
+            children: [],
+            text: '',
+        };
+        const parent = stack[stack.length - 1];
+        if (parent)
+            parent.element.children.push(element);
+        else
+            root = element;
+        if (!selfClosing)
+            stack.push({ element, qualifiedName: name[0], scope, text: [] });
+        at = cursor + 1;
+    }
+    const unclosed = stack[stack.length - 1];
+    if (unclosed)
+        throw malformed(`<${unclosed.qualifiedName}> is never closed`, source.length);
+    if (root === undefined)
+        throw malformed('no document element', 0);
+    return root;
+}
+//# sourceMappingURL=xml.js.map

package/dist/xml.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@ekwo-ai/camt053",
+  "version": "0.4.0",
+  "description": "Reads an ISO 20022 bank-to-customer statement (camt.053) into plain objects in TypeScript: account, balances and lines, amounts as decimal strings, and what does not add up. Zero dependencies, its own strict XML reader.",
+  "keywords": [
+    "camt.053",
+    "camt053",
+    "iso20022",
+    "bank-statement",
+    "bank-to-customer-statement",
+    "reconciliation",
+    "sepa",
+    "xml",
+    "parser"
+  ],
+  "license": "MIT",
+  "author": "Ekwo AI",
+  "homepage": "https://github.com/Ekwo-ai/ekwo-os/tree/main/packages/formats/camt053#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ekwo-ai/ekwo-os.git",
+    "directory": "packages/formats/camt053"
+  },
+  "bugs": {
+    "url": "https://github.com/Ekwo-ai/ekwo-os/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.0",
+    "vitest": "^3.2.0",
+    "xmllint-wasm": "^5.3.0"
+  }
+}