@ducatjs/money 0.0.0 → 0.2.0

package/dist/drizzle/sqlite.d.ts

@@ -0,0 +1,102 @@
+import type { CurrencyInput, Money } from '../money.js';
+/**
+ * An INTEGER column of minor units in a fixed currency (`1234` is 12.34 EUR), read back as
+ * `Money<C>`. Exact up to SQLite's limit of ±9.2·10^18 minor units. better-sqlite3 returns integers
+ * as numbers by default, which are exact only below 2^53; beyond that reading throws, so call
+ * `defaultSafeIntegers(true)` on the database for larger amounts. Writing another currency, or a
+ * value at a scale other than the currency's, throws.
+ *
+ *     total: moneyMinor('EUR')('total_minor').notNull()
+ */
+export declare function moneyMinor<const C extends CurrencyInput>(currency: C): {
+    (): import("drizzle-orm/sqlite-core").SQLiteCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "SQLiteCustomColumn";
+        data: Money<C>;
+        driverParam: number | bigint;
+        enumValues: undefined;
+    }>;
+    <TConfig extends Record<string, any>>(fieldConfig?: TConfig | undefined): import("drizzle-orm/sqlite-core").SQLiteCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "SQLiteCustomColumn";
+        data: Money<C>;
+        driverParam: number | bigint;
+        enumValues: undefined;
+    }>;
+    <TName extends string>(dbName: TName, fieldConfig?: unknown): import("drizzle-orm/sqlite-core").SQLiteCustomColumnBuilder<{
+        name: TName;
+        dataType: "custom";
+        columnType: "SQLiteCustomColumn";
+        data: Money<C>;
+        driverParam: number | bigint;
+        enumValues: undefined;
+    }>;
+};
+/**
+ * A TEXT column holding the exact decimal string (`12.34`), read back as `Money<C>`. SQLite's
+ * NUMERIC affinity would store some decimals as REAL and lose digits, so they are kept as text.
+ * Writing another currency, or a value at a scale other than the currency's, throws.
+ *
+ *     price: moneyDecimal('EUR')('price').notNull()
+ */
+export declare function moneyDecimal<const C extends CurrencyInput>(currency: C): {
+    (): import("drizzle-orm/sqlite-core").SQLiteCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "SQLiteCustomColumn";
+        data: Money<C>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+    <TConfig extends Record<string, any>>(fieldConfig?: TConfig | undefined): import("drizzle-orm/sqlite-core").SQLiteCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "SQLiteCustomColumn";
+        data: Money<C>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+    <TName extends string>(dbName: TName, fieldConfig?: unknown): import("drizzle-orm/sqlite-core").SQLiteCustomColumnBuilder<{
+        name: TName;
+        dataType: "custom";
+        columnType: "SQLiteCustomColumn";
+        data: Money<C>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+};
+/**
+ * A TEXT column holding `{"amount":"12.34","currency":"EUR"}`, with the currency in each value.
+ * Pass a currency to fix it: then a value in another currency throws, on write and on read.
+ *
+ *     refund: moneyJson()('refund')
+ */
+export declare function moneyJson<const C extends CurrencyInput = CurrencyInput>(currency?: C): {
+    (): import("drizzle-orm/sqlite-core").SQLiteCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "SQLiteCustomColumn";
+        data: Money<C>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+    <TConfig extends Record<string, any>>(fieldConfig?: TConfig | undefined): import("drizzle-orm/sqlite-core").SQLiteCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "SQLiteCustomColumn";
+        data: Money<C>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+    <TName extends string>(dbName: TName, fieldConfig?: unknown): import("drizzle-orm/sqlite-core").SQLiteCustomColumnBuilder<{
+        name: TName;
+        dataType: "custom";
+        columnType: "SQLiteCustomColumn";
+        data: Money<C>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+};
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/drizzle/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/drizzle/sqlite.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAUxD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,aAAa,EAAE,QAAQ,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;EAMpE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,aAAa,EAAE,QAAQ,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;EAStE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,EAAE,QAAQ,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;EAMpF"}

package/dist/drizzle/sqlite.js

@@ -0,0 +1,59 @@
+/**
+ * `@ducatjs/money/drizzle/sqlite`: Drizzle ORM column types for SQLite (better-sqlite3, libSQL,
+ * Bun). Selects return `Money`, inserts and updates accept it, and the currency is part of the
+ * column's type.
+ *
+ *     import { sqliteTable } from 'drizzle-orm/sqlite-core';
+ *     import { moneyMinor } from '@ducatjs/money/drizzle/sqlite';
+ *
+ *     const orders = sqliteTable('orders', { total: moneyMinor('EUR')('total_minor').notNull() });
+ */
+import { customType } from 'drizzle-orm/sqlite-core';
+import { currencyExponent } from '../currency.js';
+import { decimalFromDriver, decimalToDriver, jsonFromDriver, jsonToDriver, minorFromDriver, minorToDriver, } from '../sql.js';
+/**
+ * An INTEGER column of minor units in a fixed currency (`1234` is 12.34 EUR), read back as
+ * `Money<C>`. Exact up to SQLite's limit of ±9.2·10^18 minor units. better-sqlite3 returns integers
+ * as numbers by default, which are exact only below 2^53; beyond that reading throws, so call
+ * `defaultSafeIntegers(true)` on the database for larger amounts. Writing another currency, or a
+ * value at a scale other than the currency's, throws.
+ *
+ *     total: moneyMinor('EUR')('total_minor').notNull()
+ */
+export function moneyMinor(currency) {
+    return customType({
+        dataType: () => 'integer',
+        toDriver: (money) => minorToDriver(money, currency),
+        fromDriver: (value) => minorFromDriver(value, currency),
+    });
+}
+/**
+ * A TEXT column holding the exact decimal string (`12.34`), read back as `Money<C>`. SQLite's
+ * NUMERIC affinity would store some decimals as REAL and lose digits, so they are kept as text.
+ * Writing another currency, or a value at a scale other than the currency's, throws.
+ *
+ *     price: moneyDecimal('EUR')('price').notNull()
+ */
+export function moneyDecimal(currency) {
+    // fail at the schema definition, not on the first query, for an unknown currency
+    currencyExponent(currency);
+    return customType({
+        dataType: () => 'text',
+        toDriver: (money) => decimalToDriver(money, currency, undefined),
+        fromDriver: (value) => decimalFromDriver(value, currency),
+    });
+}
+/**
+ * A TEXT column holding `{"amount":"12.34","currency":"EUR"}`, with the currency in each value.
+ * Pass a currency to fix it: then a value in another currency throws, on write and on read.
+ *
+ *     refund: moneyJson()('refund')
+ */
+export function moneyJson(currency) {
+    return customType({
+        dataType: () => 'text',
+        toDriver: (money) => jsonToDriver(money, currency),
+        fromDriver: (value) => jsonFromDriver(value, currency),
+    });
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/drizzle/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../src/drizzle/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,GACd,MAAM,WAAW,CAAC;AAEnB;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAgC,QAAW;IACnE,OAAO,UAAU,CAAkD;QACjE,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS;QACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC;QACnD,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC;KACxD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAgC,QAAW;IACrE,iFAAiF;IACjF,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE3B,OAAO,UAAU,CAAyC;QACxD,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM;QACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC;QAChE,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC;KAC1D,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAgD,QAAY;IACnF,OAAO,UAAU,CAAyC;QACxD,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM;QACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;QAClD,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC;KACvD,CAAC,CAAC;AACL,CAAC"}

package/dist/ecb.d.ts

@@ -0,0 +1,52 @@
+import { type RateTable } from './provider.js';
+/**
+ * Parses eurofxref-daily.xml, eurofxref-hist-90d.xml or eurofxref-hist.xml into one EUR-based table
+ * per day, newest first. Each rate is EUR → currency, with `source: 'ECB'`, `type: 'reference'` and
+ * `asOf` the publication day. A day without any rates is left out, so a lookback goes on to the day
+ * before. A rate entry that can't be read throws SyntaxError.
+ *
+ *     const [latest] = parseEcbXml(await readFile('eurofxref-daily.xml', 'utf8'));
+ */
+export declare function parseEcbXml(xml: string): RateTable[];
+/**
+ * Parses eurofxref.csv or eurofxref-hist.csv (from the ECB's zips) the way parseEcbXml does.
+ * 'N/A' and blank cells (currencies not quoted that day) are listed in the table's `missing`, and a
+ * day with no rates at all is left out, so a lookback goes on to the day before.
+ */
+export declare function parseEcbCsv(csv: string): RateTable[];
+/** Options for parseEcbSdmxCsv. */
+export interface EcbSdmxOptions {
+    /**
+     * The decimals each currency is published with, for a file without the DECIMALS column (as
+     * fetched with `detail=dataonly`). A DECIMALS column in the file takes precedence.
+     */
+    readonly decimals?: Readonly<Record<string, number>>;
+}
+/**
+ * The DECIMALS of each series in an ECB SDMX-CSV file: the data file itself with full detail, or
+ * the series file the API returns with `detail=nodata`.
+ */
+export declare function parseEcbSdmxDecimals(csv: string): Record<string, number>;
+/**
+ * Parses the ECB Data Portal's SDMX-CSV (`format=csvdata`) for the daily euro reference rates
+ * (dataflow EXR, key `D.<currencies>.EUR.SP00.A`) into one EUR-based table per day, newest first,
+ * like parseEcbXml. Any date range back to 1999 comes in one file.
+ *
+ * The API strips trailing zeros ('136.8' for the published 136.80), so the published digits are
+ * rebuilt from each series' DECIMALS attribute: in the file with full detail, or from `decimals`
+ * (see parseEcbSdmxDecimals) for a `detail=dataonly` file. Two series overstate it (THB and LTL),
+ * and are padded only to the decimals the ECB actually published. Without DECIMALS, the digits
+ * stay as the file gives them; the values are exact either way. An empty or `NaN` value is a missing value.
+ * A row for another frequency, rate type or base currency, or with a UNIT_MULT other than 0,
+ * throws SyntaxError rather than being read as a daily rate. Discontinued series simply end, so
+ * the tables of their last days include them.
+ *
+ * No `availableAt` is set, as with parseEcbXml: the API gives no publication time, and the ECB
+ * publishes at about 16:00 CET. So a backtest that asks for 10:00 CET on a day still gets that
+ * day's rate; ask for the day before if that matters.
+ *
+ *     const tables = parseEcbSdmxCsv(await (await fetch(url)).text());
+ *     const history = rateHistory(tables); // from @ducatjs/money/convert/history
+ */
+export declare function parseEcbSdmxCsv(csv: string, options?: EcbSdmxOptions): RateTable[];
+//# sourceMappingURL=ecb.d.ts.map

package/dist/ecb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecb.d.ts","sourceRoot":"","sources":["../src/ecb.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAoE1D;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAgBpD;AAiCD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CA+BpD;AASD,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD;AA+CD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxE;AAWD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,EAAE,CAwDlF"}

package/dist/ecb.js

@@ -0,0 +1,285 @@
+// Offline parsers for the ECB euro foreign exchange reference rates (eurofxref). No I/O: fetch or
+// read the files yourself, or use ducat/convert/fetch. Rates are kept exactly as published.
+import { rateTable } from './provider.js';
+import { addDayRate, csvRows, newestFirst, readRateCell, withDecimals } from './rate-text.js';
+const MONTHS = [
+    'january',
+    'february',
+    'march',
+    'april',
+    'may',
+    'june',
+    'july',
+    'august',
+    'september',
+    'october',
+    'november',
+    'december',
+];
+const DAY_CUBE = /<Cube\s+time=["'](\d{4}-\d\d-\d\d)["']\s*>([\s\S]*?)<\/Cube>/g;
+// One <Cube .../> element, and its attributes in any order and with any quoting or spacing.
+const INNER_CUBE = /<Cube\b([^>]*?)\/?>/g;
+const ATTRIBUTE = /([A-Za-z]+)\s*=\s*(?:"([^"]*)"|'([^']*)')/g;
+const RATE_TEXT = /^\d+(?:\.\d+)?$/;
+const ISO_DAY = /^(\d{4})-(\d\d)-(\d\d)$/;
+/**
+ * The ECB's rates are typed 'reference', not 'mid': they are set once a day, around 14:10 CET, from
+ * a regular concertation between central banks, and published for information only. They are not a
+ * market mid-rate that anyone deals at.
+ */
+function ecbTable(asOf, rates) {
+    return rateTable({ base: 'EUR', asOf, source: 'ECB', type: 'reference', rates });
+}
+function notAnEcbFile() {
+    throw new SyntaxError('Not an ECB reference rate file');
+}
+function withoutByteOrderMark(text) {
+    return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+}
+/** The currency → rate attributes of the <Cube> elements in one day's cube. */
+function ratesOfDay(body) {
+    const rates = {};
+    for (const [, attributeText] of body.matchAll(INNER_CUBE)) {
+        const attributes = {};
+        for (const [, name, doubleQuoted, singleQuoted] of attributeText.matchAll(ATTRIBUTE)) {
+            attributes[name] = doubleQuoted ?? singleQuoted;
+        }
+        const currency = attributes['currency'];
+        const rate = attributes['rate'];
+        if (currency === undefined && rate === undefined) {
+            continue;
+        }
+        // Fail rather than silently drop a currency: a missing rate would look like "not quoted".
+        if (currency === undefined ||
+            !/^[A-Z]{3}$/.test(currency) ||
+            rate === undefined ||
+            !RATE_TEXT.test(rate)) {
+            throw new SyntaxError(`Malformed ECB rate entry <Cube${attributeText}>`);
+        }
+        rates[currency] = rate;
+    }
+    return rates;
+}
+/**
+ * Parses eurofxref-daily.xml, eurofxref-hist-90d.xml or eurofxref-hist.xml into one EUR-based table
+ * per day, newest first. Each rate is EUR → currency, with `source: 'ECB'`, `type: 'reference'` and
+ * `asOf` the publication day. A day without any rates is left out, so a lookback goes on to the day
+ * before. A rate entry that can't be read throws SyntaxError.
+ *
+ *     const [latest] = parseEcbXml(await readFile('eurofxref-daily.xml', 'utf8'));
+ */
+export function parseEcbXml(xml) {
+    let days = 0;
+    const tables = [];
+    for (const [, asOf, body] of withoutByteOrderMark(xml).matchAll(DAY_CUBE)) {
+        days++;
+        const day = isoDay(asOf);
+        const rates = ratesOfDay(body);
+        if (Object.keys(rates).length > 0) {
+            tables.push(ecbTable(day, rates));
+        }
+    }
+    if (days === 0) {
+        notAnEcbFile();
+    }
+    return newestFirst(tables);
+}
+/** The ISO date of year-month-day, or a SyntaxError when that day doesn't exist (32 November). */
+function calendarDay(year, month, day) {
+    const date = new Date(Date.UTC(year, month - 1, day));
+    if (date.getUTCFullYear() !== year ||
+        date.getUTCMonth() !== month - 1 ||
+        date.getUTCDate() !== day) {
+        throw new SyntaxError(`Not a calendar day: ${year}-${month}-${day}`);
+    }
+    return date.toISOString().slice(0, 10);
+}
+/** '2026-11-06', or '06 November 2026' as in the daily CSV, as an ISO date. */
+function isoDay(text) {
+    const iso = ISO_DAY.exec(text);
+    if (iso !== null) {
+        return calendarDay(Number(iso[1]), Number(iso[2]), Number(iso[3]));
+    }
+    const match = /^(\d{1,2}) ([A-Za-z]+) (\d{4})$/.exec(text);
+    if (match === null) {
+        notAnEcbFile();
+    }
+    const [, day, monthName, year] = match;
+    const month = MONTHS.indexOf(monthName.toLowerCase()) + 1;
+    if (month === 0) {
+        notAnEcbFile();
+    }
+    return calendarDay(Number(year), month, Number(day));
+}
+/**
+ * Parses eurofxref.csv or eurofxref-hist.csv (from the ECB's zips) the way parseEcbXml does.
+ * 'N/A' and blank cells (currencies not quoted that day) are listed in the table's `missing`, and a
+ * day with no rates at all is left out, so a lookback goes on to the day before.
+ */
+export function parseEcbCsv(csv) {
+    const lines = withoutByteOrderMark(csv)
+        .split(/\r?\n/)
+        .filter((line) => line.trim() !== '');
+    const columns = (lines[0] ?? '').split(',').map((cell) => cell.trim());
+    if (columns[0] !== 'Date') {
+        notAnEcbFile();
+    }
+    const tables = [];
+    for (const line of lines.slice(1)) {
+        const cells = line.split(',').map((cell) => cell.trim());
+        const day = isoDay(cells[0]);
+        const rates = {};
+        let quoted = 0;
+        for (let i = 1; i < columns.length; i++) {
+            const currency = columns[i];
+            if (!currency) {
+                continue;
+            }
+            const rate = readRateCell(cells[i] ?? '', `${currency} on ${day}`);
+            rates[currency] = rate;
+            if (rate !== null) {
+                quoted++;
+            }
+        }
+        if (quoted > 0) {
+            tables.push(ecbTable(day, rates));
+        }
+    }
+    return newestFirst(tables);
+}
+// Series whose DECIMALS attribute says more than the ECB has ever published for them. Evidence:
+// eurofxref-daily.xml publishes THB to 3 decimals (37.459 on 2026-11-06) while DECIMALS says 4,
+// and eurofxref-hist.xml (1999 to 2026) never has more than 4 for LTL, whose DECIMALS says 5.
+// Padding to the attribute would invent a digit. A cap only limits padding: a value published
+// with more digits keeps them all (withDecimals never drops digits).
+const PUBLISHED_DECIMALS = { THB: 3, LTL: 4 };
+/** A DECIMALS cell as a number of decimals, or SyntaxError. */
+function readDecimals(text, where) {
+    if (!/^\d{1,2}$/.test(text) || Number(text) > 30) {
+        throw new SyntaxError(`Malformed DECIMALS ${JSON.stringify(text)} (${where})`);
+    }
+    return Number(text);
+}
+/** A series' stated decimals, capped at what the ECB actually publishes for it. */
+function statedDecimals(currency, text) {
+    const stated = readDecimals(text, currency);
+    const published = PUBLISHED_DECIMALS[currency];
+    if (published !== undefined && published < stated) {
+        return published;
+    }
+    return stated;
+}
+/** The records of an SDMX-CSV file after its header, each with as many cells as the header. */
+function sdmxRecords(csv) {
+    const [header, ...rows] = csvRows(withoutByteOrderMark(csv));
+    if (header === undefined) {
+        throw new SyntaxError('Not an ECB SDMX-CSV file: it is empty');
+    }
+    for (const cells of rows) {
+        if (cells.length !== header.length) {
+            throw new SyntaxError(`Malformed ECB SDMX-CSV row: ${cells.length} cells, the header has ${header.length}`);
+        }
+    }
+    return { header, rows };
+}
+/** The columns of an SDMX-CSV file, by name, or SyntaxError when a required one is missing. */
+function sdmxColumns(header, required) {
+    const columns = new Map(header.map((name, i) => [name.trim(), i]));
+    for (const name of required) {
+        if (!columns.has(name)) {
+            throw new SyntaxError(`Not an ECB SDMX-CSV file: no ${name} column`);
+        }
+    }
+    return columns;
+}
+/**
+ * The DECIMALS of each series in an ECB SDMX-CSV file: the data file itself with full detail, or
+ * the series file the API returns with `detail=nodata`.
+ */
+export function parseEcbSdmxDecimals(csv) {
+    const { header, rows } = sdmxRecords(csv);
+    const columns = sdmxColumns(header, ['CURRENCY', 'DECIMALS']);
+    const decimals = {};
+    for (const cells of rows) {
+        const currency = cells[columns.get('CURRENCY')].trim();
+        decimals[currency] = statedDecimals(currency, cells[columns.get('DECIMALS')].trim());
+    }
+    return decimals;
+}
+/** The value of an optional column, or undefined when the file doesn't have it. */
+function optionalCell(cells, columns, name) {
+    const index = columns.get(name);
+    if (index === undefined) {
+        return undefined;
+    }
+    return cells[index]?.trim();
+}
+/**
+ * Parses the ECB Data Portal's SDMX-CSV (`format=csvdata`) for the daily euro reference rates
+ * (dataflow EXR, key `D.<currencies>.EUR.SP00.A`) into one EUR-based table per day, newest first,
+ * like parseEcbXml. Any date range back to 1999 comes in one file.
+ *
+ * The API strips trailing zeros ('136.8' for the published 136.80), so the published digits are
+ * rebuilt from each series' DECIMALS attribute: in the file with full detail, or from `decimals`
+ * (see parseEcbSdmxDecimals) for a `detail=dataonly` file. Two series overstate it (THB and LTL),
+ * and are padded only to the decimals the ECB actually published. Without DECIMALS, the digits
+ * stay as the file gives them; the values are exact either way. An empty or `NaN` value is a missing value.
+ * A row for another frequency, rate type or base currency, or with a UNIT_MULT other than 0,
+ * throws SyntaxError rather than being read as a daily rate. Discontinued series simply end, so
+ * the tables of their last days include them.
+ *
+ * No `availableAt` is set, as with parseEcbXml: the API gives no publication time, and the ECB
+ * publishes at about 16:00 CET. So a backtest that asks for 10:00 CET on a day still gets that
+ * day's rate; ask for the day before if that matters.
+ *
+ *     const tables = parseEcbSdmxCsv(await (await fetch(url)).text());
+ *     const history = rateHistory(tables); // from @ducatjs/money/convert/history
+ */
+export function parseEcbSdmxCsv(csv, options) {
+    const { header, rows } = sdmxRecords(csv);
+    const columns = sdmxColumns(header, ['CURRENCY', 'CURRENCY_DENOM', 'TIME_PERIOD', 'OBS_VALUE']);
+    const at = (cells, name) => cells[columns.get(name)]?.trim() ?? '';
+    const days = new Map();
+    for (const cells of rows) {
+        const currency = at(cells, 'CURRENCY');
+        const day = at(cells, 'TIME_PERIOD');
+        const where = `${currency} on ${day}`;
+        const unexpected = at(cells, 'CURRENCY_DENOM') !== 'EUR' ||
+            (optionalCell(cells, columns, 'FREQ') ?? 'D') !== 'D' ||
+            (optionalCell(cells, columns, 'EXR_TYPE') ?? 'SP00') !== 'SP00' ||
+            (optionalCell(cells, columns, 'EXR_SUFFIX') ?? 'A') !== 'A';
+        if (unexpected) {
+            throw new SyntaxError(`Not a daily EUR reference rate: ${cells.join(',')}`);
+        }
+        if (!/^[A-Z]{3}$/.test(currency) || !ISO_DAY.test(day)) {
+            throw new SyntaxError(`Malformed ECB SDMX-CSV row: ${cells.join(',')}`);
+        }
+        const multiplier = optionalCell(cells, columns, 'UNIT_MULT');
+        if (multiplier !== undefined && multiplier !== '' && multiplier !== '0') {
+            throw new SyntaxError(`Unsupported UNIT_MULT ${multiplier} (${where})`);
+        }
+        const value = at(cells, 'OBS_VALUE');
+        let rate = readRateCell(value, where);
+        if (rate !== null) {
+            // The file's own DECIMALS, capped like parseEcbSdmxDecimals; else the caller's, as given.
+            const stated = optionalCell(cells, columns, 'DECIMALS');
+            let decimals = options?.decimals?.[currency];
+            if (stated !== undefined && stated !== '') {
+                decimals = statedDecimals(currency, stated);
+            }
+            if (decimals !== undefined) {
+                rate = withDecimals(rate, decimals);
+            }
+        }
+        const isoDay = calendarDay(Number(day.slice(0, 4)), Number(day.slice(5, 7)), Number(day.slice(8)));
+        addDayRate(days, isoDay, currency, rate);
+    }
+    const tables = [];
+    for (const [day, rates] of days) {
+        if (Object.values(rates).some((rate) => rate !== null)) {
+            tables.push(ecbTable(day, rates));
+        }
+    }
+    return newestFirst(tables);
+}
+//# sourceMappingURL=ecb.js.map

package/dist/ecb.js.map

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

package/dist/exact.d.ts

@@ -0,0 +1,62 @@
+import { type Factor } from './decimal.js';
+import { type Money } from './money.js';
+import type { Rate } from './rate.js';
+import { type RoundingMode } from './rounding.js';
+/**
+ * A rounded value and what rounding left out: `value + residual` is exactly the unrounded amount.
+ */
+export interface Rounded<C extends string> {
+    readonly value: Money<C>;
+    readonly residual: ExactMoney<C>;
+}
+/**
+ * An exact amount of `currency`: num/den major units, reduced, den > 0. Build it with `exact()`.
+ */
+export declare class ExactMoney<C extends string = string> {
+    readonly currency: C;
+    readonly num: bigint;
+    readonly den: bigint;
+    /** @internal use exact() */
+    constructor(currency: C, numerator: bigint, denominator: bigint);
+    /** this + other, exactly. */
+    add(other: ExactMoney<C>): ExactMoney<C>;
+    /** this − other, exactly. */
+    subtract(other: ExactMoney<C>): ExactMoney<C>;
+    /** −this. */
+    negate(): ExactMoney<C>;
+    /** this × factor, exactly. */
+    multiply(factor: Factor): ExactMoney<C>;
+    /** this ÷ divisor, exactly. */
+    divide(divisor: Factor): ExactMoney<C>;
+    /** Converts exactly at `rate`; nothing is rounded. */
+    convert<To extends string>(rate: Rate<C, To>): ExactMoney<To>;
+    /** −1, 0 or 1. */
+    compare(other: ExactMoney<C>): -1 | 0 | 1;
+    /** Same currency and the same exact value. */
+    equals(other: ExactMoney): boolean;
+    /** −1, 0 or 1. */
+    sign(): -1 | 0 | 1;
+    /** Whether the amount is zero. */
+    isZero(): boolean;
+    /** Whether the amount fits `scale` (default: the currency's exponent) without rounding. */
+    isExact(scale?: number): boolean;
+    /** Rounds once to `scale` (default: the currency's exponent). */
+    round(rounding?: RoundingMode, scale?: number): Money<C>;
+    /** Rounds once and reports the difference, for booking it (e.g. an "FX rounding" ledger line). */
+    roundWithResidual(rounding?: RoundingMode, scale?: number): Rounded<C>;
+    /** "10/3 EUR", for debugging only. */
+    toString(): string;
+    /** Blocks `a + b` and `a > b`: round() first. */
+    [Symbol.toPrimitive](hint: string): string;
+}
+/**
+ * The exact value of `money`, for chained arithmetic: `exact(price).divide(3).round('halfEven')`.
+ */
+export declare function exact<C extends string>(money: Money<C>): ExactMoney<C>;
+/**
+ * The exact sum (zero of `currency` for an empty list). Round it once for a batch's rounding line.
+ */
+export declare function sumExact<C extends string>(items: readonly ExactMoney<C>[], currency?: C): ExactMoney<C>;
+/** Whether `value` is an ExactMoney. */
+export declare function isExactMoney(value: unknown): value is ExactMoney;
+//# sourceMappingURL=exact.d.ts.map

package/dist/exact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exact.d.ts","sourceRoot":"","sources":["../src/exact.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAA+B,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAA0C,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,MAAM;IACvC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC/C,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,4BAA4B;gBAChB,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAO/D,6BAA6B;IAC7B,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAMxC,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAI7C,aAAa;IACb,MAAM,IAAI,UAAU,CAAC,CAAC,CAAC;IAIvB,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAKvC,+BAA+B;IAC/B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAQtC,sDAAsD;IACtD,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC;IAO7D,kBAAkB;IAClB,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAczC,8CAA8C;IAC9C,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO;IAIlC,kBAAkB;IAClB,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAUlB,kCAAkC;IAClC,MAAM,IAAI,OAAO;IAIjB,2FAA2F;IAC3F,OAAO,CAAC,KAAK,GAAE,MAAwC,GAAG,OAAO;IAIjE,iEAAiE;IACjE,KAAK,CACH,QAAQ,GAAE,YAA+B,EACzC,KAAK,GAAE,MAAwC,GAC9C,KAAK,CAAC,CAAC,CAAC;IAKX,kGAAkG;IAClG,iBAAiB,CAAC,QAAQ,GAAE,YAA+B,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAMxF,sCAAsC;IACtC,QAAQ,IAAI,MAAM;IAOlB,iDAAiD;IACjD,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAM3C;AAQD;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAEtE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EACvC,KAAK,EAAE,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,EAC/B,QAAQ,CAAC,EAAE,CAAC,GACX,UAAU,CAAC,CAAC,CAAC,CAUf;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE"}