@ducatjs/money 0.1.0 → 0.2.1

package/dist/kysely.js

@@ -0,0 +1,309 @@
+/**
+ * `@ducatjs/money/kysely`: Money in Kysely queries, without the plugin having to understand query
+ * shapes. A money value is selected as a self-describing JSON object built in SQL (marked, with the
+ * amount as exact text and the currency), and `MoneyResultPlugin` turns exactly those objects into
+ * Money, wherever they appear: unions, CTEs, subqueries, nested JSON, every `stream()` chunk, and
+ * under `CamelCasePlugin`. A raw column is never typed as Money.
+ *
+ *     const money = moneyHelpers('postgres');
+ *     const db = new Kysely<Database>({ dialect, plugins: [new MoneyResultPlugin()] });
+ *
+ *     await db.insertInto('payments').values({ id: 1, ...setMoney(fee, 'amount_minor', 'currency') });
+ *     await db
+ *       .selectFrom('payments')
+ *       .select((eb) => money.selectMoney(eb, 'amount_minor', 'currency').as('fee'))
+ *       .where((eb) => money.compareMoney(eb, 'amount_minor', 'currency', '>=', fee))
+ *       .execute();
+ */
+import { sql, } from 'kysely';
+import { currencyExponent } from './currency.js';
+import { CurrencyMismatchError } from './money.js';
+import { checkCurrency, checkDecimalSize, checkIsoScale, decimalFromDriver, DEFAULT_DECIMAL_SIZE, decimalToDriver, minorFromDriver, minorToDriver, } from './sql.js';
+export { DEFAULT_DECIMAL_SIZE } from './sql.js';
+/** Marks a column's currency as fixed: `selectMoney(eb, 'total_minor', fixed('EUR'))`. */
+export function fixed(currency) {
+    // an unknown code fails here, where the column is described, not on the first query
+    currencyExponent(currency);
+    return { fixed: currency };
+}
+function isFixed(currency) {
+    return typeof currency === 'object' && currency !== null && 'fixed' in currency;
+}
+const COMPARISONS = new Set(['=', '<>', '<', '<=', '>', '>=']);
+// The marker key of the JSON objects the helpers build. Its value carries a random nonce chosen
+// when this module loads, so data that merely looks like a marker (a user's JSON column, a text
+// value) is never read as money: forging one needs the nonce, which only appears in query text.
+const MARKER = '$ducat';
+const NONCE = Array.from(globalThis.crypto.getRandomValues(new Uint8Array(16)), (byte) => byte.toString(16).padStart(2, '0')).join('');
+const MINOR_MARKER = `${NONCE}:minor`;
+const DECIMAL_MARKER = `${NONCE}:decimal`;
+// nested JSON deeper than this is left as it is, so a hostile document can't exhaust the stack
+const MAX_DEPTH = 64;
+function markerFor(storage) {
+    return storage === 'minor' ? MINOR_MARKER : DECIMAL_MARKER;
+}
+export function setMoney(money, amount, currency) {
+    if (isFixed(currency)) {
+        return { [amount]: minorToDriver(money, currency.fixed).toString() };
+    }
+    return { [amount]: minorToDriver(money, undefined).toString(), [currency]: money.currency };
+}
+export function setDecimalMoney(money, amount, currency, size = DEFAULT_DECIMAL_SIZE) {
+    const decimal = decimalForColumn(money, isFixed(currency) ? currency.fixed : undefined, size);
+    if (isFixed(currency)) {
+        return { [amount]: decimal };
+    }
+    return { [amount]: decimal, [currency]: money.currency };
+}
+/**
+ * The decimal for a NUMERIC(p, s) column, or a throw if the column would round or clamp it: its
+ * scale must hold the currency's exponent, and the value must fit its integer digits.
+ */
+function decimalForColumn(money, currency, size) {
+    checkDecimalSize(money.currency, size);
+    return decimalToDriver(money, currency, size);
+}
+function jsonObjectWith(functionName) {
+    return (fields) => {
+        const parts = fields.map(([key, value]) => sql `${sql.lit(key)}, ${value}`);
+        return sql `${sql.raw(functionName)}(${sql.join(parts)})`;
+    };
+}
+// MySQL compares a DECIMAL with a string as doubles, so parameters are cast to its widest DECIMAL
+const MYSQL_DECIMAL_INTEGER_DIGITS = 35;
+const MYSQL_DECIMAL_SCALE = 30;
+const DIALECTS = {
+    postgres: {
+        // jsonb, which has equality, so UNION, DISTINCT and GROUP BY work on money values
+        jsonObject: jsonObjectWith('jsonb_build_object'),
+        asText: (expression) => sql `cast(${expression} as text)`,
+        minorParameter: (minor) => sql `cast(${minor.toString()} as bigint)`,
+        decimalParameter: (decimal) => sql `cast(${decimal} as numeric)`,
+        hasNumericDecimals: true,
+    },
+    mysql: {
+        jsonObject: jsonObjectWith('json_object'),
+        asText: (expression) => sql `cast(${expression} as char)`,
+        // a string compared with a BIGINT is compared as a double, which loses digits beyond 2^53
+        minorParameter: (minor) => sql `cast(${minor.toString()} as signed)`,
+        decimalParameter: (decimal) => {
+            const [integerPart, fraction = ''] = decimal.replace('-', '').split('.');
+            const fits = integerPart.length <= MYSQL_DECIMAL_INTEGER_DIGITS &&
+                fraction.length <= MYSQL_DECIMAL_SCALE;
+            if (!fits) {
+                throw new RangeError(`${decimal} is beyond MySQL's widest DECIMAL(65,30)`);
+            }
+            return sql `cast(${decimal} as decimal(65, 30))`;
+        },
+        hasNumericDecimals: true,
+    },
+    sqlite: {
+        jsonObject: jsonObjectWith('json_object'),
+        asText: (expression) => sql `cast(${expression} as text)`,
+        // a bound bigint is an INTEGER, which compares as a number even against a column without
+        // affinity (a CTE or subquery column), where a string would compare as text
+        minorParameter: (minor) => sql `${minor}`,
+        decimalParameter: (decimal) => sql `${decimal}`,
+        hasNumericDecimals: false,
+    },
+};
+/** The read, filter and sum helpers for one SQL dialect. */
+export function moneyHelpers(dialect) {
+    const dialectSql = DIALECTS[dialect];
+    if (dialectSql === undefined) {
+        throw new RangeError(`Unknown dialect "${String(dialect)}"; use postgres, mysql or sqlite`);
+    }
+    function currencyExpression(eb, currency) {
+        if (isFixed(currency)) {
+            return sql.lit(currency.fixed);
+        }
+        return eb.ref(currency);
+    }
+    function select(storage, eb, amount, currency) {
+        const amountRef = eb.ref(amount);
+        const object = dialectSql.jsonObject([
+            [MARKER, sql.lit(markerFor(storage))],
+            ['amount', dialectSql.asText(amountRef)],
+            ['currency', currencyExpression(eb, currency)],
+        ]);
+        // a NULL amount stays NULL rather than becoming a marker without an amount
+        return sql `case when ${amountRef} is null then null else ${object} end`;
+    }
+    function compare(storage, eb, amount, currency, operator, money, size = DEFAULT_DECIMAL_SIZE) {
+        if (!COMPARISONS.has(operator)) {
+            throw new RangeError(`Unsupported comparison "${operator}"`);
+        }
+        const isEquality = operator === '=' || operator === '<>';
+        if (storage === 'decimal' && !dialectSql.hasNumericDecimals && !isEquality) {
+            throw new RangeError('SQLite stores decimals as TEXT, which orders as text; compare minor units instead');
+        }
+        if (isFixed(currency)) {
+            checkCurrency(money, currency.fixed);
+        }
+        let value;
+        if (storage === 'minor') {
+            value = dialectSql.minorParameter(minorToDriver(money, undefined));
+        }
+        else {
+            value = dialectSql.decimalParameter(decimalForColumn(money, undefined, size));
+        }
+        const amountCondition = eb(eb.ref(amount), operator, value);
+        if (isFixed(currency)) {
+            return amountCondition;
+        }
+        const currencyRef = eb.ref(currency);
+        if (operator === '<>') {
+            return eb.or([eb(currencyRef, '<>', money.currency), amountCondition]);
+        }
+        return eb.and([eb(currencyRef, '=', money.currency), amountCondition]);
+    }
+    function sum(storage, eb, amount, currency) {
+        if (storage === 'decimal' && !dialectSql.hasNumericDecimals) {
+            throw new RangeError("SQLite's sum() over TEXT decimals is a REAL; sum minor units instead");
+        }
+        const amountRef = eb.ref(amount);
+        const fields = [
+            [MARKER, sql.lit(markerFor(storage))],
+            ['amount', dialectSql.asText(sql `sum(${amountRef})`)],
+        ];
+        if (isFixed(currency)) {
+            fields.push(['currency', sql.lit(currency.fixed)]);
+        }
+        else {
+            const currencyRef = eb.ref(currency);
+            // only rows with an amount count: a row with a NULL amount adds nothing to the sum
+            const currencyOfAmount = sql `case when ${amountRef} is not null then ${currencyRef} end`;
+            fields.push(['currency', sql `min(${currencyOfAmount})`]);
+            // more than one currency, or an amount without one: the reader throws
+            const withoutCurrency = sql `count(case when ${amountRef} is not null and ${currencyRef} is null then 1 end)`;
+            const isMixed = sql `${withoutCurrency} > 0 or count(distinct ${currencyOfAmount}) > 1`;
+            fields.push(['mixed', sql `case when ${isMixed} then 1 else 0 end`]);
+        }
+        const object = dialectSql.jsonObject(fields);
+        return sql `case when count(${amountRef}) = 0 then null else ${object} end`;
+    }
+    return {
+        selectMoney: ((eb, amount, currency) => select('minor', eb, amount, currency)),
+        selectDecimalMoney: ((eb, amount, currency) => select('decimal', eb, amount, currency)),
+        compareMoney: (eb, amount, currency, operator, money) => compare('minor', eb, amount, currency, operator, money),
+        compareDecimalMoney: (eb, amount, currency, operator, money, size) => compare('decimal', eb, amount, currency, operator, money, size),
+        sumMoney: ((eb, amount, currency) => sum('minor', eb, amount, currency)),
+        sumDecimalMoney: ((eb, amount, currency) => sum('decimal', eb, amount, currency)),
+    };
+}
+// ---------------------------------------------------------------------------------------------
+// The result plugin
+// ---------------------------------------------------------------------------------------------
+const SELECT_KEYS = ['$ducat', 'amount', 'currency'];
+const SUM_KEYS = ['$ducat', 'amount', 'currency', 'mixed'];
+function hasExactly(value, keys) {
+    const own = Object.keys(value);
+    return own.length === keys.length && keys.every((key) => Object.hasOwn(value, key));
+}
+/**
+ * Whether the object is a marker built by this module: exactly the expected keys, with this
+ * process's nonce. Anything else, however similar, is ordinary data.
+ */
+function isMarker(value) {
+    const marker = value[MARKER];
+    if (marker !== MINOR_MARKER && marker !== DECIMAL_MARKER) {
+        return false;
+    }
+    return hasExactly(value, SELECT_KEYS) || hasExactly(value, SUM_KEYS);
+}
+/** Money from one marker object, validating every field. */
+function moneyFromMarker(marker) {
+    const { amount, currency, mixed } = marker;
+    if (mixed === 1 || mixed === true) {
+        throw new CurrencyMismatchError('one currency', 'several, or an amount without a currency');
+    }
+    if (typeof currency !== 'string') {
+        throw new TypeError(`A money value needs a currency, got ${String(currency)}`);
+    }
+    if (marker[MARKER] === MINOR_MARKER) {
+        return minorFromDriver(amount, currency);
+    }
+    const parsed = decimalFromDriver(amount, currency);
+    checkIsoScale(parsed);
+    return parsed;
+}
+function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+/** A marker returned as text (SQLite's json_object, MySQL's JSON as a string), or undefined. */
+function markerFromText(text) {
+    // cheap test first: only text carrying this process's nonce can be a marker
+    if (!text.includes(NONCE)) {
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+    return isPlainObject(parsed) && isMarker(parsed) ? parsed : undefined;
+}
+/** The value with every money marker in it replaced by Money; other values are left as they are. */
+function convertMarkers(value, depth) {
+    if (depth > MAX_DEPTH) {
+        return value;
+    }
+    if (typeof value === 'string') {
+        const marker = markerFromText(value);
+        return marker === undefined ? value : moneyFromMarker(marker);
+    }
+    if (Array.isArray(value)) {
+        let changed;
+        for (let i = 0; i < value.length; i++) {
+            const converted = convertMarkers(value[i], depth + 1);
+            if (converted !== value[i]) {
+                changed ??= value.slice();
+                changed[i] = converted;
+            }
+        }
+        return changed ?? value;
+    }
+    if (!isPlainObject(value)) {
+        return value;
+    }
+    if (isMarker(value)) {
+        return moneyFromMarker(value);
+    }
+    let changed;
+    for (const key of Object.keys(value)) {
+        const converted = convertMarkers(value[key], depth + 1);
+        if (converted !== value[key]) {
+            // fromEntries defines own properties, so a "__proto__" key from JSON.parse stays a key
+            changed ??= Object.fromEntries(Object.entries(value));
+            changed[key] = converted;
+        }
+    }
+    return changed ?? value;
+}
+/**
+ * A Kysely plugin that turns the values built by `moneyHelpers` into Money, in every row and in
+ * JSON nested inside rows. It keeps no state between queries and doesn't touch the query, so it
+ * works with streams, prepared and repeated queries, and other plugins. For nested JSON that
+ * SQLite returns as text (`jsonArrayFrom`), put `ParseJSONResultsPlugin` before it.
+ */
+export class MoneyResultPlugin {
+    /** Leaves the query as it is. */
+    transformQuery(args) {
+        return args.node;
+    }
+    /** Converts the money values in every row. */
+    async transformResult(args) {
+        const rows = convertMarkers(args.result.rows, 0);
+        if (rows === args.result.rows) {
+            return args.result;
+        }
+        return { ...args.result, rows };
+    }
+}
+//# sourceMappingURL=kysely.js.map

package/dist/kysely.js.map

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

package/dist/money.d.ts

@@ -9,6 +9,48 @@ export interface MoneyJSON<C extends string = string> {
     readonly amount: string;
     readonly currency: C;
 }
+/**
+ * A reusable rounding rule: a scale, an increment at that scale and a rounding mode, such as "CHF
+ * cash" (scale 2, increment 5, half up) or "4 decimals, half even". Build one with `roundingPolicy()`
+ * from `@ducatjs/money/policy` (or `cashPolicy()` from `@ducatjs/money/cash`) and pass it wherever
+ * a rounding mode is accepted: `m.multiply('1.075', policy)`, `m.round(policy)`. A policy is also
+ * a function that rounds an amount, so `m.with(policy)` and `amounts.map(policy)` work too.
+ *
+ * Policies are plain values passed explicitly; they are never stored on amounts or set globally.
+ */
+export interface RoundingPolicy {
+    /** Rounds `money` to this policy (exactly like `round(money, policy)`). */
+    <C extends string>(money: Money<C>): Money<C>;
+    /** Decimal places of the result; `undefined` means the currency's ISO exponent. */
+    readonly scale: number | undefined;
+    /** The result is a multiple of this many 10^-scale units (1 for plain rounding, 5 for 0.05). */
+    readonly increment: number;
+    /** How to round to the increment. */
+    readonly rounding: RoundingMode;
+    /** The one currency the policy is for, if any; other currencies throw `CurrencyMismatchError`. */
+    readonly currency: string | undefined;
+    /**
+     * @internal money × factor, rounded once to this policy, under a key only this copy of the
+     * package can build. The core calls it for every operation given a policy, so the policy code
+     * stays out of bundles that never build one.
+     */
+    readonly [ROUND_PRODUCT]: <C extends string>(money: Money<C>, factor: Ratio) => Money<C>;
+}
+/**
+ * @internal The key a policy's rounding function is stored under. Module-private, so only
+ * `roundingPolicy` from this copy of the package makes values the core accepts as policies: a
+ * lookalike function, or a policy from a second installed copy (whose results would be that copy's
+ * Money), is rejected with a TypeError, as `isMoney` rejects the other copy's Money.
+ */
+export declare const ROUND_PRODUCT: unique symbol;
+/**
+ * @internal money × factor rounded by a policy. Anything not built by `roundingPolicy` lacks the
+ * private key, so calling it throws a TypeError; that is the whole check, kept this small because
+ * it is in every bundle.
+ */
+export declare const roundWithPolicy: <C extends string>(money: Money<C>, factor: Ratio, policy: RoundingPolicy) => Money<C>;
+/** What rounding parameters accept: a mode such as `'halfEven'`, or a `RoundingPolicy`. */
+export type RoundingInput = RoundingMode | RoundingPolicy;
 /** Thrown when two amounts in different currencies are combined. */
 export declare class CurrencyMismatchError extends TypeError {
     name: string;
@@ -50,13 +92,14 @@ declare class Money<C extends string = string> {
      * this * factor, rounded to this scale. `factor` is exact: integer, decimal string ('1.075'),
      * bigint or ratio().
      */
-    multiply(factor: Factor, rounding?: RoundingMode): Money<C>;
-    /** this / divisor, rounded to this scale */
-    divide(divisor: Factor, rounding?: RoundingMode): Money<C>;
+    multiply(factor: Factor, rounding?: RoundingInput): Money<C>;
+    /** this / divisor, rounded to this scale (or to a policy's scale and increment) */
+    divide(divisor: Factor, rounding?: RoundingInput): Money<C>;
     negate(): Money<C>;
     abs(): Money<C>;
-    /** Rounds to the currency's exponent (or `scale`). */
+    /** Rounds to the currency's exponent (or `scale`), or to a rounding policy. */
     round(rounding: RoundingMode, scale?: number): Money<C>;
+    round(policy: RoundingPolicy): Money<C>;
     /** Changes the scale; decreasing it rounds (default 'halfExpand'). */
     toScale(scale: number, rounding?: RoundingMode): Money<C>;
     /** -1, 0 or 1; throws on currency mismatch */
@@ -74,6 +117,17 @@ declare class Money<C extends string = string> {
     min(...others: Money<C>[]): Money<C>;
     max(...others: Money<C>[]): Money<C>;
     clamp(lo: Money<C>, hi: Money<C>): Money<C>;
+    /** Same currency, value and scale: 1.0 EUR is not identical to 1.00 EUR. */
+    identical(other: Money): boolean;
+    /**
+     * Applies `operation` to this amount and returns its result, so a rounding policy or a
+     * conversion reads as one step in a chain: `price.multiply('1.075').with(toCash)`.
+     */
+    with<R>(operation: (money: Money<C>) => R): R;
+    /** The whole major units, truncated toward zero: 12 for 12.34 EUR, -12 for -12.34 EUR. */
+    majorPart(): number | bigint;
+    /** The rest in 10^-scale units, with the amount's sign: 34 for 12.34 EUR, -34 for -12.34. */
+    minorPart(): number | bigint;
     /** Exact decimal string in major units: "12.34" */
     toDecimal(): string;
     /** Minor units as a bigint (BIGINT columns) */
@@ -84,6 +138,18 @@ declare class Money<C extends string = string> {
 export type { Money };
 /** Whether a value is a Money from this package. */
 export declare function isMoney(value: unknown): value is Money;
+/**
+ * Whether a value is a Money in `currency`. It narrows a currency known only at run time
+ * (`Money<string>`, or `unknown`) to the literal type:
+ *
+ *     if (isMoneyIn(price, 'EUR')) { price.add(money('1', 'EUR')) }
+ */
+export declare function isMoneyIn<C extends CurrencyInput>(value: unknown, currency: C): value is Money<C>;
+/**
+ * Narrows `money` to `Money<C>`, or throws a `CurrencyMismatchError` if it is in another
+ * currency. Use it where a different currency is a bug rather than a branch.
+ */
+export declare function assertCurrency<C extends CurrencyInput>(money: Money, currency: C): asserts money is Money<C>;
 /** Options for `extendMoney`. */
 export interface ExtendMoneyOptions {
     /**
@@ -161,16 +227,18 @@ export declare function abs<C extends string>(money: Money<C>): Money<C>;
  * bigint, or a `ratio()`. Rounding defaults to 'halfExpand' (ties away from zero); pass
  * 'unnecessary' to throw instead.
  */
-export declare function multiply<C extends string>(money: Money<C>, factor: Factor, rounding?: RoundingMode): Money<C>;
-/** @internal m * r, rounded */
-export declare function multiplyByRatio<C extends string>(money: Money<C>, factor: Ratio, rounding: RoundingMode, scale?: number): Money<C>;
-/** m / divisor, rounded to m's scale (default 'halfExpand'). */
-export declare function divide<C extends string>(money: Money<C>, divisor: Factor, rounding?: RoundingMode): Money<C>;
+export declare function multiply<C extends string>(money: Money<C>, factor: Factor, rounding?: RoundingInput): Money<C>;
+/** @internal m * r, rounded with a mode (at `scale`) or with a policy (at the policy's scale) */
+export declare function multiplyByRatio<C extends string>(money: Money<C>, factor: Ratio, rounding: RoundingInput, scale?: number): Money<C>;
+/** m / divisor, rounded to m's scale (default 'halfExpand'), or with a rounding policy. */
+export declare function divide<C extends string>(money: Money<C>, divisor: Factor, rounding?: RoundingInput): Money<C>;
 /**
  * Rounds to the currency's exponent (or `scale`): `round(money('1.005', 'EUR', {scale: 3}),
  * 'halfEven')`.
  */
 export declare function round<C extends string>(money: Money<C>, rounding: RoundingMode, scale?: number): Money<C>;
+/** Rounds to a policy's scale and increment: `round(money('10.03', 'CHF'), cashPolicy('CHF'))`. */
+export declare function round<C extends string>(money: Money<C>, policy: RoundingPolicy): Money<C>;
 /**
  * Changes the scale; increasing it is always exact, decreasing it rounds (default 'halfExpand').
  */
@@ -181,6 +249,12 @@ export declare function compare<C extends string>(money: Money<C>, other: Money<
  * Same currency and same value (1.0 EUR at scale 1 equals 1.00 EUR). Different currencies: false.
  */
 export declare function equals(money: Money, other: Money): boolean;
+/**
+ * Same currency, same value *and* same scale, with number and bigint minor units counted as equal.
+ * `equals` treats 1.0 EUR (scale 1) and 1.00 EUR as equal; `identical` does not. For round-trip
+ * tests, where the scale must survive too.
+ */
+export declare function identical(money: Money, other: Money): boolean;
 /** money < other (same currency; any scale). */
 export declare const lessThan: <C extends string>(money: Money<C>, other: Money<NoInfer<C>>) => boolean;
 /** money <= other */
@@ -207,6 +281,16 @@ export declare function clamp<C extends string>(money: Money<C>, lo: Money<NoInf
  * Exact decimal string in major units: "12.34", "-0.05", "1000" (JPY). For NUMERIC/DECIMAL columns.
  */
 export declare function toDecimal(money: Money): string;
+/**
+ * The whole major units, truncated toward zero: 12 for 12.34 EUR and -12 for -12.34 EUR. A number
+ * while it is a safe integer, a bigint beyond, like `minor`.
+ */
+export declare function majorPart(money: Money): number | bigint;
+/**
+ * What is left after `majorPart`, in 10^-scale units and with the amount's sign: 34 for 12.34
+ * EUR, -34 for -12.34 EUR, 5 for 1.005 EUR at scale 3.
+ */
+export declare function minorPart(money: Money): number | bigint;
 /** Minor units as a bigint (always safe; use for BIGINT columns). */
 export declare function toMinor(money: Money): bigint;
 /** Minor units as a number; throws if not a safe integer. */

package/dist/money.d.ts.map

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