@ducatjs/money 0.1.0 → 0.2.0

package/dist/convert.js

@@ -4,7 +4,7 @@ import { exact } from './exact.js';
 import { ratio } from './decimal.js';
 import { make } from './money.js';
 import { rateOf } from './provider.js';
-import { isRate, multiplyByRatioAtScale } from './rate.js';
+import { convertWithPolicy, isRate, multiplyByRatioAtScale, } from './rate.js';
 import { DEFAULT_ROUNDING } from './rounding.js';
 export { exchangeRate, impliedRate, isRate, multiplyByRatioAtScale, Rate, RateExpiredError, rateFromJSON, } from './rate.js';
 export { bag, comparator, MoneyBag, sortByValue, sumByCurrency, } from './bag.js';
@@ -37,19 +37,29 @@ export function convert(money, rateOrTarget, roundingOrRate, optionsOrRounding,
         throw new RangeError('Exchange rate must be positive');
     }
     const rounding = optionsOrRounding ?? DEFAULT_ROUNDING;
+    if (typeof rounding === 'function') {
+        return convertWithPolicy(money, to, rate, rounding, maybeOptions);
+    }
     const scale = maybeOptions?.scale ?? currencyExponent(to);
     const minor = multiplyByRatioAtScale(money.minor, rate, scale - money.scale, rounding);
     return make(to, minor, scale);
 }
 /**
  * Converts at `rate` like convert(), and also reports the residual: `value + residual` is exactly
- * money × rate, so a ledger can book the rounding difference.
+ * money × rate, so a ledger can book the rounding difference. With a rounding policy, the value
+ * is on the policy's scale and increment, and the residual is still the exact difference.
  *
  *     const { value, residual } = convertDetailed(money('0.07', 'EUR'), eurUsd, 'halfEven');
  *     // value 0.08 USD, residual -0.001845 USD (as an exact ExactMoney)
  */
 export function convertDetailed(money, rate, rounding = DEFAULT_ROUNDING, options) {
-    const rounded = exact(money).convert(rate).roundWithResidual(rounding, options?.scale);
+    const converted = exact(money).convert(rate);
+    if (typeof rounding === 'function') {
+        // The policy rounds; the residual is still exactly what it left out.
+        const value = rate.convert(money, rounding, options);
+        return { value, residual: converted.subtract(exact(value)), rate };
+    }
+    const rounded = converted.roundWithResidual(rounding, options?.scale);
     return { value: rounded.value, residual: rounded.residual, rate };
 }
 //# sourceMappingURL=convert.js.map

package/dist/convert.js.map

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

package/dist/drizzle/mysql.d.ts

@@ -0,0 +1,105 @@
+import type { CurrencyInput, Money, MoneyJSON } from '../money.js';
+import { type DecimalColumnSize } from '../sql.js';
+export { DEFAULT_DECIMAL_SIZE, type DecimalColumnSize } from '../sql.js';
+/**
+ * A BIGINT column of minor units in a fixed currency (`1234` is 12.34 EUR), read back as
+ * `Money<C>`. Exact up to the column's limit of ±9.2·10^18 minor units. mysql2 returns BIGINT as a
+ * number by default, which is exact only below 2^53; beyond that it throws, so set
+ * `supportBigNumbers: true` (with `bigNumberStrings: true`) on the connection 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/mysql-core").MySqlCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Money<C>;
+        driverParam: string | number | bigint;
+        enumValues: undefined;
+    }>;
+    <TConfig extends Record<string, any>>(fieldConfig?: TConfig | undefined): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Money<C>;
+        driverParam: string | number | bigint;
+        enumValues: undefined;
+    }>;
+    <TName extends string>(dbName: TName, fieldConfig?: unknown): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: TName;
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Money<C>;
+        driverParam: string | number | bigint;
+        enumValues: undefined;
+    }>;
+};
+/**
+ * A DECIMAL(precision, scale) column, DECIMAL(19,4) by default, read back as `Money<C>`. The driver
+ * must return DECIMAL as a string (mysql2's default; don't set `decimalNumbers`): a number has been
+ * through a float and throws. Writing a value the column could not hold unchanged throws (outside
+ * strict mode MySQL would clamp it), and so does a column scale below the currency's exponent.
+ *
+ *     price: moneyDecimal('EUR', { precision: 19, scale: 4 })('price').notNull()
+ */
+export declare function moneyDecimal<const C extends CurrencyInput>(currency: C, size?: DecimalColumnSize): {
+    (): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Money<C>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+    <TConfig extends Record<string, any>>(fieldConfig?: TConfig | undefined): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Money<C>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+    <TName extends string>(dbName: TName, fieldConfig?: unknown): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: TName;
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Money<C>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+};
+/**
+ * A JSON 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/mysql-core").MySqlCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Money<C>;
+        driverParam: string | MoneyJSON<string>;
+        enumValues: undefined;
+    }>;
+    <TConfig extends Record<string, any>>(fieldConfig?: TConfig | undefined): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Money<C>;
+        driverParam: string | MoneyJSON<string>;
+        enumValues: undefined;
+    }>;
+    <TName extends string>(dbName: TName, fieldConfig?: unknown): import("drizzle-orm/mysql-core").MySqlCustomColumnBuilder<{
+        name: TName;
+        dataType: "custom";
+        columnType: "MySqlCustomColumn";
+        data: Money<C>;
+        driverParam: string | MoneyJSON<string>;
+        enumValues: undefined;
+    }>;
+};
+//# sourceMappingURL=mysql.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../src/drizzle/mysql.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EASL,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEzE;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,aAAa,EAAE,QAAQ,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;EAMpE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,aAAa,EACxD,QAAQ,EAAE,CAAC,EACX,IAAI,GAAE,iBAAwC;;;;;;;;;;;;;;;;;;;;;;;;;EAS/C;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,EAAE,QAAQ,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;EAOpF"}

package/dist/drizzle/mysql.js

@@ -0,0 +1,60 @@
+/**
+ * `@ducatjs/money/drizzle/mysql`: Drizzle ORM column types for MySQL and MariaDB (mysql2,
+ * PlanetScale). Selects return `Money`, inserts and updates accept it, and the currency is part of
+ * the column's type.
+ *
+ *     import { mysqlTable } from 'drizzle-orm/mysql-core';
+ *     import { moneyMinor } from '@ducatjs/money/drizzle/mysql';
+ *
+ *     const orders = mysqlTable('orders', { total: moneyMinor('EUR')('total_minor').notNull() });
+ */
+import { customType } from 'drizzle-orm/mysql-core';
+import { checkDecimalSize, decimalFromDriver, decimalToDriver, DEFAULT_DECIMAL_SIZE, jsonFromDriver, jsonToDriver, minorFromDriver, minorToDriver, } from '../sql.js';
+export { DEFAULT_DECIMAL_SIZE } from '../sql.js';
+/**
+ * A BIGINT column of minor units in a fixed currency (`1234` is 12.34 EUR), read back as
+ * `Money<C>`. Exact up to the column's limit of ±9.2·10^18 minor units. mysql2 returns BIGINT as a
+ * number by default, which is exact only below 2^53; beyond that it throws, so set
+ * `supportBigNumbers: true` (with `bigNumberStrings: true`) on the connection 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: () => 'bigint',
+        toDriver: (money) => minorToDriver(money, currency).toString(),
+        fromDriver: (value) => minorFromDriver(value, currency),
+    });
+}
+/**
+ * A DECIMAL(precision, scale) column, DECIMAL(19,4) by default, read back as `Money<C>`. The driver
+ * must return DECIMAL as a string (mysql2's default; don't set `decimalNumbers`): a number has been
+ * through a float and throws. Writing a value the column could not hold unchanged throws (outside
+ * strict mode MySQL would clamp it), and so does a column scale below the currency's exponent.
+ *
+ *     price: moneyDecimal('EUR', { precision: 19, scale: 4 })('price').notNull()
+ */
+export function moneyDecimal(currency, size = DEFAULT_DECIMAL_SIZE) {
+    checkDecimalSize(currency, size);
+    return customType({
+        dataType: () => `decimal(${size.precision}, ${size.scale})`,
+        toDriver: (money) => decimalToDriver(money, currency, size),
+        fromDriver: (value) => decimalFromDriver(value, currency),
+    });
+}
+/**
+ * A JSON 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: () => 'json',
+        toDriver: (money) => jsonToDriver(money, currency),
+        // mysql2 parses JSON columns itself; other drivers may return the text
+        fromDriver: (value) => jsonFromDriver(value, currency),
+    });
+}
+//# sourceMappingURL=mysql.js.map

package/dist/drizzle/mysql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.js","sourceRoot":"","sources":["../../src/drizzle/mysql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,GAEd,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,oBAAoB,EAA0B,MAAM,WAAW,CAAC;AAEzE;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAgC,QAAW;IACnE,OAAO,UAAU,CAA2D;QAC1E,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ;QACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE;QAC9D,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC;KACxD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAW,EACX,OAA0B,oBAAoB;IAE9C,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAEjC,OAAO,UAAU,CAAyC;QACxD,QAAQ,EAAE,GAAG,EAAE,CAAC,WAAW,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,KAAK,GAAG;QAC3D,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC;QAC3D,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,CAAqD;QACpE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM;QACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;QAClD,uEAAuE;QACvE,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC;KACvD,CAAC,CAAC;AACL,CAAC"}

package/dist/drizzle/pg.d.ts

@@ -0,0 +1,103 @@
+import type { CurrencyInput, Money, MoneyJSON } from '../money.js';
+import { type DecimalColumnSize } from '../sql.js';
+export { DEFAULT_DECIMAL_SIZE, type DecimalColumnSize } from '../sql.js';
+/**
+ * A BIGINT column of minor units in a fixed currency (`1234` is 12.34 EUR), read back as
+ * `Money<C>`. Exact up to the column's limit of ±9.2·10^18 minor units. 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/pg-core").PgCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "PgCustomColumn";
+        data: Money<C>;
+        driverParam: string | number | bigint;
+        enumValues: undefined;
+    }>;
+    <TConfig extends Record<string, any>>(fieldConfig?: TConfig | undefined): import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "PgCustomColumn";
+        data: Money<C>;
+        driverParam: string | number | bigint;
+        enumValues: undefined;
+    }>;
+    <TName extends string>(dbName: TName, fieldConfig?: unknown): import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
+        name: TName;
+        dataType: "custom";
+        columnType: "PgCustomColumn";
+        data: Money<C>;
+        driverParam: string | number | bigint;
+        enumValues: undefined;
+    }>;
+};
+/**
+ * A NUMERIC(precision, scale) column, NUMERIC(19,4) by default, read back as `Money<C>`. The
+ * driver must return NUMERIC as a string (node-postgres and postgres.js do); a number has been
+ * through a float and throws, as do `NaN` and `Infinity`. Writing a value the column could not hold
+ * unchanged throws, and so does a column scale below the currency's exponent.
+ *
+ *     price: moneyDecimal('EUR', { precision: 19, scale: 4 })('price').notNull()
+ */
+export declare function moneyDecimal<const C extends CurrencyInput>(currency: C, size?: DecimalColumnSize): {
+    (): import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "PgCustomColumn";
+        data: Money<C>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+    <TConfig extends Record<string, any>>(fieldConfig?: TConfig | undefined): import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "PgCustomColumn";
+        data: Money<C>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+    <TName extends string>(dbName: TName, fieldConfig?: unknown): import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
+        name: TName;
+        dataType: "custom";
+        columnType: "PgCustomColumn";
+        data: Money<C>;
+        driverParam: string;
+        enumValues: undefined;
+    }>;
+};
+/**
+ * A JSONB 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/pg-core").PgCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "PgCustomColumn";
+        data: Money<C>;
+        driverParam: string | MoneyJSON<string>;
+        enumValues: undefined;
+    }>;
+    <TConfig extends Record<string, any>>(fieldConfig?: TConfig | undefined): import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
+        name: "";
+        dataType: "custom";
+        columnType: "PgCustomColumn";
+        data: Money<C>;
+        driverParam: string | MoneyJSON<string>;
+        enumValues: undefined;
+    }>;
+    <TName extends string>(dbName: TName, fieldConfig?: unknown): import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
+        name: TName;
+        dataType: "custom";
+        columnType: "PgCustomColumn";
+        data: Money<C>;
+        driverParam: string | MoneyJSON<string>;
+        enumValues: undefined;
+    }>;
+};
+//# sourceMappingURL=pg.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pg.d.ts","sourceRoot":"","sources":["../../src/drizzle/pg.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EASL,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEzE;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,aAAa,EAAE,QAAQ,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;EAQpE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,aAAa,EACxD,QAAQ,EAAE,CAAC,EACX,IAAI,GAAE,iBAAwC;;;;;;;;;;;;;;;;;;;;;;;;;EAS/C;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,EAAE,QAAQ,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;EAOpF"}

package/dist/drizzle/pg.js

@@ -0,0 +1,60 @@
+/**
+ * `@ducatjs/money/drizzle/pg`: Drizzle ORM column types for Postgres (node-postgres, postgres.js,
+ * PGlite, Neon). Selects return `Money`, inserts and updates accept it, and the currency is part of
+ * the column's type.
+ *
+ *     import { pgTable } from 'drizzle-orm/pg-core';
+ *     import { moneyMinor } from '@ducatjs/money/drizzle/pg';
+ *
+ *     const orders = pgTable('orders', { total: moneyMinor('EUR')('total_minor').notNull() });
+ */
+import { customType } from 'drizzle-orm/pg-core';
+import { checkDecimalSize, decimalFromDriver, decimalToDriver, DEFAULT_DECIMAL_SIZE, jsonFromDriver, jsonToDriver, minorFromDriver, minorToDriver, } from '../sql.js';
+export { DEFAULT_DECIMAL_SIZE } from '../sql.js';
+/**
+ * A BIGINT column of minor units in a fixed currency (`1234` is 12.34 EUR), read back as
+ * `Money<C>`. Exact up to the column's limit of ±9.2·10^18 minor units. 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: () => 'bigint',
+        // a string, not a bigint: node-postgres cannot bind a bigint parameter
+        toDriver: (money) => minorToDriver(money, currency).toString(),
+        // node-postgres returns int8 as a string, postgres.js as a string or a bigint
+        fromDriver: (value) => minorFromDriver(value, currency),
+    });
+}
+/**
+ * A NUMERIC(precision, scale) column, NUMERIC(19,4) by default, read back as `Money<C>`. The
+ * driver must return NUMERIC as a string (node-postgres and postgres.js do); a number has been
+ * through a float and throws, as do `NaN` and `Infinity`. Writing a value the column could not hold
+ * unchanged throws, and so does a column scale below the currency's exponent.
+ *
+ *     price: moneyDecimal('EUR', { precision: 19, scale: 4 })('price').notNull()
+ */
+export function moneyDecimal(currency, size = DEFAULT_DECIMAL_SIZE) {
+    checkDecimalSize(currency, size);
+    return customType({
+        dataType: () => `numeric(${size.precision}, ${size.scale})`,
+        toDriver: (money) => decimalToDriver(money, currency, size),
+        fromDriver: (value) => decimalFromDriver(value, currency),
+    });
+}
+/**
+ * A JSONB 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: () => 'jsonb',
+        toDriver: (money) => jsonToDriver(money, currency),
+        // node-postgres parses JSONB itself; other drivers may return the text
+        fromDriver: (value) => jsonFromDriver(value, currency),
+    });
+}
+//# sourceMappingURL=pg.js.map

package/dist/drizzle/pg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg.js","sourceRoot":"","sources":["../../src/drizzle/pg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,GAEd,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,oBAAoB,EAA0B,MAAM,WAAW,CAAC;AAEzE;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAgC,QAAW;IACnE,OAAO,UAAU,CAA2D;QAC1E,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ;QACxB,uEAAuE;QACvE,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE;QAC9D,8EAA8E;QAC9E,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC;KACxD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAW,EACX,OAA0B,oBAAoB;IAE9C,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAEjC,OAAO,UAAU,CAAyC;QACxD,QAAQ,EAAE,GAAG,EAAE,CAAC,WAAW,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,KAAK,GAAG;QAC3D,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC;QAC3D,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,CAAqD;QACpE,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO;QACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;QAClD,uEAAuE;QACvE,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC;KACvD,CAAC,CAAC;AACL,CAAC"}

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

@@ -10,8 +10,43 @@ import { type RateTable } from './provider.js';
 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 skipped, and a day with no rates at
- * all is left out, so a lookback goes on to the day before.
+ * '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

@@ -1 +1 @@
-{"version":3,"file":"ecb.d.ts","sourceRoot":"","sources":["../src/ecb.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAuE1D;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAgBpD;AAiCD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CA0BpD"}
+{"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"}