@ducatjs/money 0.0.0 → 0.2.0

package/dist/testing/arbitraries.js

@@ -0,0 +1,98 @@
+/**
+ * `@ducatjs/money/testing/arbitraries`: fast-check arbitraries for property tests. They cover what
+ * hand-written cases tend to miss: amounts beyond 2^53 (bigint minor units), currencies with
+ * unusual exponents (JPY 0, KWD 3, CLF 4) and scales above the currency's exponent. fast-check is
+ * an optional peer dependency, needed only for this entry.
+ */
+import fc from 'fast-check';
+import { currencyExponent, ISO_EXPONENTS } from '../currency.js';
+import { MAX_DECIMAL_SCALE } from '../decimal.js';
+import { fromMinor, money } from '../money.js';
+/** A mix of exponents: the common two-decimal currencies and every unusual one. */
+const DEFAULT_CURRENCIES = ['EUR', 'USD', 'GBP', 'JPY', 'KRW', 'KWD', 'BHD', 'TND', 'CLF'];
+/**
+ * Currency codes, by default a representative mix of exponents 0, 2, 3 and 4 (JPY, EUR, KWD,
+ * CLF...). `{ all: true }` draws from every ISO 4217 code, `extra` adds codes (custom ones from
+ * `defineCurrency`), and `exponents` narrows whichever pool that is.
+ */
+export function arbCurrency(options = {}) {
+    const base = options.all === true ? Object.keys(ISO_EXPONENTS) : DEFAULT_CURRENCIES;
+    const pool = [...base, ...(options.extra ?? [])];
+    const exponents = options.exponents;
+    const codes = exponents === undefined
+        ? pool
+        : pool.filter((code) => exponents.includes(currencyExponent(code)));
+    if (codes.length === 0) {
+        throw new RangeError('No currency has the requested exponents');
+    }
+    return fc.constantFrom(...codes);
+}
+const BIG = 10n ** 30n;
+const SAFE = BigInt(Number.MAX_SAFE_INTEGER);
+/** Minor units weighted toward the interesting places: small, near 2^53, and far beyond it. */
+function arbMinor(min, max) {
+    const clamp = (low, high) => fc.bigInt({ min: low > min ? low : min, max: high < max ? high : max });
+    const parts = [];
+    if (min <= 10000n && max >= -10000n) {
+        parts.push(clamp(-10000n, 10000n));
+    }
+    if (min <= SAFE && max >= -SAFE) {
+        parts.push(clamp(-SAFE, SAFE));
+    }
+    // within 1000 of ±2^53, where number and bigint meet
+    for (const edge of [SAFE, -SAFE]) {
+        if (min <= edge + 1000n && max >= edge - 1000n) {
+            parts.push(clamp(edge - 1000n, edge + 1000n));
+        }
+    }
+    parts.push(fc.bigInt({ min, max }));
+    return fc.oneof(...parts);
+}
+/**
+ * Money values for property tests: `arbMoney()`, `arbMoney({ currency: 'EUR', min: '0', max:
+ * '100' })`. With bounds, every value is within them; without, minor units reach ±10^30.
+ */
+export function arbMoney(options = {}) {
+    const given = options.currency;
+    let currencies;
+    if (given === undefined) {
+        currencies = arbCurrency();
+    }
+    else if (typeof given === 'string') {
+        currencies = fc.constant(given);
+    }
+    else {
+        currencies = given;
+    }
+    return currencies.chain((currency) => {
+        const exponent = currencyExponent(currency);
+        const scaleOption = options.scale;
+        let scales;
+        if (typeof scaleOption === 'number') {
+            scales = fc.constant(scaleOption);
+        }
+        else if (scaleOption === undefined) {
+            scales = fc.oneof({ weight: 3, arbitrary: fc.constant(exponent) }, { weight: 1, arbitrary: fc.integer({ min: exponent + 1, max: exponent + 3 }) });
+        }
+        else {
+            scales = scaleOption;
+        }
+        return scales.chain((scale) => {
+            if (!(Number.isInteger(scale) && scale >= 0 && scale <= MAX_DECIMAL_SCALE)) {
+                throw new RangeError(`Invalid scale ${scale}`);
+            }
+            // Bounds in minor units at this scale; a bound between two units rounds inward.
+            const min = options.min === undefined
+                ? -BIG
+                : BigInt(money(options.min, currency, { scale, rounding: 'ceil' }).toMinor());
+            const max = options.max === undefined
+                ? BIG
+                : BigInt(money(options.max, currency, { scale, rounding: 'floor' }).toMinor());
+            if (min > max) {
+                throw new RangeError(`No ${currency} amount at scale ${scale} between min and max`);
+            }
+            return arbMinor(min, max).map((minor) => fromMinor(minor, currency, scale));
+        });
+    });
+}
+//# sourceMappingURL=arbitraries.js.map

package/dist/testing/arbitraries.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,67 @@
+import { type Money } from '../money.js';
+/** An equality tester, as Vitest and Jest's `expect.addEqualityTesters` take them. */
+export type MoneyEqualityTester = (left: unknown, right: unknown) => boolean | undefined;
+/**
+ * Money compares by value in `toEqual`, `toStrictEqual` and nested structures: same currency and
+ * the same amount, whatever the scale (`1.0` and `1.00`) and whether the minor units are a number
+ * or a bigint. For anything other than two Money values it returns undefined, so the usual
+ * comparison applies.
+ */
+export declare const moneyEquality: MoneyEqualityTester;
+/** A snapshot serializer that prints Money as `12.34 EUR` (unquoted, so it isn't a string). */
+export declare const moneySerializer: {
+    test: (value: unknown) => boolean;
+    serialize: (value: unknown) => string;
+};
+/** What the matchers receive as `this`, the part of Vitest's and Jest's matcher state used here. */
+export interface MoneyMatcherContext {
+    readonly isNot: boolean;
+}
+/** A matcher's result, as Vitest and Jest expect it. */
+export interface MoneyMatcherResult {
+    pass: boolean;
+    message: () => string;
+    actual?: unknown;
+    expected?: unknown;
+}
+/** The money matchers, typed for `declare module` augmentation of `Assertion` / `Matchers`. */
+export interface MoneyMatchers<R = unknown> {
+    /** The value is Money equal to `amount` in `currency`, at any scale: `toBeMoney('12.34', 'EUR')`. */
+    toBeMoney(amount: string | number | bigint, currency: string): R;
+    /** The value is Money in `currency`. */
+    toHaveCurrency(currency: string): R;
+    /** The value is Money greater than `other` (same currency). */
+    toBeGreaterThanMoney(other: Money): R;
+    /** The value is Money greater than or equal to `other` (same currency). */
+    toBeGreaterThanOrEqualMoney(other: Money): R;
+    /** The value is Money less than `other` (same currency). */
+    toBeLessThanMoney(other: Money): R;
+    /** The value is Money less than or equal to `other` (same currency). */
+    toBeLessThanOrEqualMoney(other: Money): R;
+    /** The value is a list of Money that sums exactly to `total`, as allocations must. */
+    toSumTo(total: Money): R;
+}
+/** The matcher implementations, for `expect.extend`. */
+export declare const moneyMatchers: {
+    toBeMoney(this: MoneyMatcherContext, received: unknown, amount: string | number | bigint, currency: string): MoneyMatcherResult;
+    toHaveCurrency(this: MoneyMatcherContext, received: unknown, currency: string): MoneyMatcherResult;
+    toBeGreaterThanMoney: (this: MoneyMatcherContext, received: unknown, other: Money) => MoneyMatcherResult;
+    toBeGreaterThanOrEqualMoney: (this: MoneyMatcherContext, received: unknown, other: Money) => MoneyMatcherResult;
+    toBeLessThanMoney: (this: MoneyMatcherContext, received: unknown, other: Money) => MoneyMatcherResult;
+    toBeLessThanOrEqualMoney: (this: MoneyMatcherContext, received: unknown, other: Money) => MoneyMatcherResult;
+    toSumTo(this: MoneyMatcherContext, received: unknown, total: Money): MoneyMatcherResult;
+};
+/** The parts of Vitest's and Jest's `expect` that `installMoneyMatchers` uses. */
+export interface ExpectWithExtensions {
+    extend(matchers: any): void;
+    addEqualityTesters?(testers: any[]): void;
+    addSnapshotSerializer?(serializer: any): void;
+}
+/**
+ * Installs everything on a test runner's `expect`: the matchers, value equality and the snapshot
+ * serializer. It also gives Money a Node inspect hook, so `console.log(price)` prints
+ * `Money(12.34 EUR)`. Safe to call more than once. A runner that lacks `addEqualityTesters` or
+ * `addSnapshotSerializer` (Bun supports neither) gets the matchers and the inspect hook.
+ */
+export declare function installMoneyMatchers(expect: ExpectWithExtensions): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAA8C,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAErF,sFAAsF;AACtF,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,SAAS,CAAC;AAEzF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,mBAO3B,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,eAAe;kBACZ,OAAO,KAAG,OAAO;uBACZ,OAAO,KAAG,MAAM;CACpC,CAAC;AAEF,oGAAoG;AACpG,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,wDAAwD;AACxD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,+FAA+F;AAC/F,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,qGAAqG;IACrG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC;IACjE,wCAAwC;IACxC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC;IACpC,+DAA+D;IAC/D,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC;IACtC,2EAA2E;IAC3E,2BAA2B,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC;IAC7C,4DAA4D;IAC5D,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC;IACnC,wEAAwE;IACxE,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC;IAC1C,sFAAsF;IACtF,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC;CAC1B;AA8ED,wDAAwD;AACxD,eAAO,MAAM,aAAa;oBAEhB,mBAAmB,YACf,OAAO,UACT,MAAM,GAAG,MAAM,GAAG,MAAM,YACtB,MAAM,GACf,kBAAkB;yBAOb,mBAAmB,YACf,OAAO,YACP,MAAM,GACf,kBAAkB;iCAzBb,mBAAmB,YAAY,OAAO,SAAS,KAAK,KAAK,kBAAkB;wCAA3E,mBAAmB,YAAY,OAAO,SAAS,KAAK,KAAK,kBAAkB;8BAA3E,mBAAmB,YAAY,OAAO,SAAS,KAAK,KAAK,kBAAkB;qCAA3E,mBAAmB,YAAY,OAAO,SAAS,KAAK,KAAK,kBAAkB;kBA6CrE,mBAAmB,YAAY,OAAO,SAAS,KAAK,GAAG,kBAAkB;CAqBxF,CAAC;AAEF,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IAEnC,MAAM,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAC;IAE5B,kBAAkB,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE1C,qBAAqB,CAAC,CAAC,UAAU,EAAE,GAAG,GAAG,IAAI,CAAC;CAC/C;AAID;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CA2BvE"}

package/dist/testing/index.js

@@ -0,0 +1,159 @@
+/**
+ * `@ducatjs/money/testing`: makes Money pleasant to test with Vitest and Jest. It provides value
+ * equality for `toEqual`, readable snapshots and failure output (`12.34 EUR`), and money matchers.
+ * Call `installMoneyMatchers(expect)` in a setup file, or import `@ducatjs/money/testing/vitest`
+ * or `@ducatjs/money/testing/jest`, which do that for you. Nothing here changes production code.
+ */
+import { currencyExponent } from '../currency.js';
+import { parseDecimal } from '../decimal.js';
+import { compare, equals, isMoney, money, sum, zero } from '../money.js';
+/**
+ * Money compares by value in `toEqual`, `toStrictEqual` and nested structures: same currency and
+ * the same amount, whatever the scale (`1.0` and `1.00`) and whether the minor units are a number
+ * or a bigint. For anything other than two Money values it returns undefined, so the usual
+ * comparison applies.
+ */
+export const moneyEquality = (left, right) => {
+    if (isMoney(left) && isMoney(right)) {
+        return equals(left, right);
+    }
+    // Anything else, including a Money from a second installed copy of the package (which isMoney
+    // does not recognise), is left to the runner's own field-by-field comparison.
+    return undefined;
+};
+/** A snapshot serializer that prints Money as `12.34 EUR` (unquoted, so it isn't a string). */
+export const moneySerializer = {
+    test: (value) => isMoney(value),
+    serialize: (value) => String(value),
+};
+/**
+ * Prints a received value for a failure message. JSON.stringify would throw on a bigint or a
+ * cycle, and a matcher must fail cleanly, not throw while explaining the failure.
+ */
+function show(value, seen = new Set()) {
+    if (isMoney(value)) {
+        return String(value);
+    }
+    if (typeof value === 'bigint') {
+        return `${value}n`;
+    }
+    if (typeof value === 'string') {
+        return JSON.stringify(value);
+    }
+    if (typeof value !== 'object' || value === null) {
+        return String(value);
+    }
+    if (seen.has(value)) {
+        return '[Circular]';
+    }
+    seen.add(value);
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => show(item, seen)).join(', ')}]`;
+    }
+    const fields = Object.entries(value).map(([key, field]) => `${key}: ${show(field, seen)}`);
+    return `{ ${fields.join(', ')} }`;
+}
+function result(context, pass, received, expectation, expected) {
+    return {
+        pass,
+        message: () => `expected ${show(received)} ${context.isNot ? 'not ' : ''}${expectation}`,
+        actual: received,
+        expected,
+    };
+}
+/**
+ * Comparing amounts in different currencies, or something that isn't Money, is a mistake in the
+ * test, so it throws instead of failing; otherwise `.not` would quietly pass on it.
+ */
+function requireComparable(matcher, received, other) {
+    if (!isMoney(received) || !isMoney(other)) {
+        throw new TypeError(`${matcher}: expected two Money values, got ${show(received)} and ${show(other)}`);
+    }
+    if (received.currency !== other.currency) {
+        throw new TypeError(`${matcher}: cannot compare ${received.currency} with ${other.currency}`);
+    }
+}
+/** Decimal places in an amount as `money()` takes it, so `toBeMoney` can keep every digit. */
+function decimalsOf(amount) {
+    // parseDecimal understands exponent notation ('1.5e-7'), as money() does
+    return typeof amount === 'bigint' ? 0 : parseDecimal(String(amount)).scale;
+}
+function comparison(name, wording, accepts) {
+    return function (received, other) {
+        requireComparable(name, received, other);
+        const pass = accepts(compare(received, other));
+        return result(this, pass, received, `${wording} ${show(other)}`);
+    };
+}
+/** The matcher implementations, for `expect.extend`. */
+export const moneyMatchers = {
+    toBeMoney(received, amount, currency) {
+        const scale = Math.max(decimalsOf(amount), currencyExponent(currency));
+        const expected = money(amount, currency, { scale });
+        const pass = isMoney(received) && equals(received, expected);
+        return result(this, pass, received, `to be ${expected}`, expected);
+    },
+    toHaveCurrency(received, currency) {
+        const pass = isMoney(received) && received.currency === currency;
+        return result(this, pass, received, `to have currency ${currency}`);
+    },
+    toBeGreaterThanMoney: comparison('toBeGreaterThanMoney', 'to be greater than', (order) => order > 0),
+    toBeGreaterThanOrEqualMoney: comparison('toBeGreaterThanOrEqualMoney', 'to be greater than or equal to', (order) => order >= 0),
+    toBeLessThanMoney: comparison('toBeLessThanMoney', 'to be less than', (order) => order < 0),
+    toBeLessThanOrEqualMoney: comparison('toBeLessThanOrEqualMoney', 'to be less than or equal to', (order) => order <= 0),
+    toSumTo(received, total) {
+        // Not a list of Money, or parts in another currency, is a mistake in the test: throw.
+        if (!Array.isArray(received) || !isMoney(total)) {
+            throw new TypeError(`toSumTo: expected a list of Money and a Money total, got ${show(received)}`);
+        }
+        for (const part of received) {
+            requireComparable('toSumTo', part, total);
+        }
+        const partsSum = sum(received, total.currency);
+        const pass = equals(partsSum, total);
+        return {
+            pass,
+            message: () => `expected ${show(received)} ${this.isNot ? 'not ' : ''}to sum to ${show(total)}` +
+                (this.isNot ? '' : `; they sum to ${partsSum}`),
+            actual: partsSum,
+            expected: total,
+        };
+    },
+};
+const INSPECT = Symbol.for('nodejs.util.inspect.custom');
+/**
+ * Installs everything on a test runner's `expect`: the matchers, value equality and the snapshot
+ * serializer. It also gives Money a Node inspect hook, so `console.log(price)` prints
+ * `Money(12.34 EUR)`. Safe to call more than once. A runner that lacks `addEqualityTesters` or
+ * `addSnapshotSerializer` (Bun supports neither) gets the matchers and the inspect hook.
+ */
+export function installMoneyMatchers(expect) {
+    expect.extend(moneyMatchers);
+    // Optional runner features: Bun has no equality testers, and its addSnapshotSerializer throws
+    // "Not implemented". The matchers work without either.
+    try {
+        expect.addEqualityTesters?.([moneyEquality]);
+    }
+    catch {
+        // not supported by this runner
+    }
+    try {
+        expect.addSnapshotSerializer?.(moneySerializer);
+    }
+    catch {
+        // not supported by this runner
+    }
+    // The inspect hook is the one change to Money itself; only test setups call this function.
+    const prototype = Object.getPrototypeOf(zero('EUR'));
+    if (!Object.hasOwn(prototype, INSPECT)) {
+        Object.defineProperty(prototype, INSPECT, {
+            value() {
+                return `Money(${String(this)})`;
+            },
+            writable: true,
+            configurable: true,
+            enumerable: false,
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

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

package/dist/testing/jest.d.ts

@@ -0,0 +1,2 @@
+export * from './index.js';
+//# sourceMappingURL=jest.d.ts.map

package/dist/testing/jest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest.d.ts","sourceRoot":"","sources":["../../src/testing/jest.ts"],"names":[],"mappings":"AASA,cAAc,YAAY,CAAC"}

package/dist/testing/jest.js

@@ -0,0 +1,15 @@
+/**
+ * `@ducatjs/money/testing/jest`: one import in a Jest setup file (`setupFilesAfterEnv`) installs
+ * the money matchers, value equality and the snapshot serializer on Jest's global `expect`. It
+ * needs no Jest package of its own. For the types, add `MoneyMatchers` to Jest's `Matchers` in a
+ * declaration file (see the README): augmenting Jest's global namespace from here would clash
+ * with Vitest's types in projects that have both.
+ */
+import { installMoneyMatchers } from './index.js';
+export * from './index.js';
+const globalExpect = globalThis.expect;
+if (globalExpect === undefined) {
+    throw new Error('@ducatjs/money/testing/jest needs Jest’s global expect; import it from a setup file, or call installMoneyMatchers(expect)');
+}
+installMoneyMatchers(globalExpect);
+//# sourceMappingURL=jest.js.map

package/dist/testing/jest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest.js","sourceRoot":"","sources":["../../src/testing/jest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,oBAAoB,EAA6B,MAAM,YAAY,CAAC;AAE7E,cAAc,YAAY,CAAC;AAE3B,MAAM,YAAY,GAAI,UAAgD,CAAC,MAAM,CAAC;AAC9E,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;IAC/B,MAAM,IAAI,KAAK,CACb,2HAA2H,CAC5H,CAAC;AACJ,CAAC;AACD,oBAAoB,CAAC,YAAY,CAAC,CAAC"}

package/dist/testing/vitest.d.ts

@@ -0,0 +1,7 @@
+import { type MoneyMatchers } from './index.js';
+export * from './index.js';
+declare module 'vitest' {
+    interface Matchers<T = any> extends MoneyMatchers<T> {
+    }
+}
+//# sourceMappingURL=vitest.d.ts.map

package/dist/testing/vitest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.d.ts","sourceRoot":"","sources":["../../src/testing/vitest.ts"],"names":[],"mappings":"AAQA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEtE,cAAc,YAAY,CAAC;AAE3B,OAAO,QAAQ,QAAQ,CAAC;IAEtB,UAAU,QAAQ,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;KAAG;CACxD"}

package/dist/testing/vitest.js

@@ -0,0 +1,12 @@
+/**
+ * `@ducatjs/money/testing/vitest`: one import in a Vitest setup file installs the money matchers,
+ * value equality and the snapshot serializer, and types the matchers on `expect`:
+ *
+ *     // vitest.config.ts: test: { setupFiles: ['./test/setup.ts'] }
+ *     import '@ducatjs/money/testing/vitest';
+ */
+import { expect } from 'vitest';
+import { installMoneyMatchers } from './index.js';
+export * from './index.js';
+installMoneyMatchers(expect);
+//# sourceMappingURL=vitest.js.map

package/dist/testing/vitest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.js","sourceRoot":"","sources":["../../src/testing/vitest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAsB,MAAM,YAAY,CAAC;AAEtE,cAAc,YAAY,CAAC;AAO3B,oBAAoB,CAAC,MAAM,CAAC,CAAC"}

package/dist/valibot.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `@ducatjs/money/valibot`: Valibot schemas for the JSON form of Money, `{ "amount": "12.34",
+ * "currency": "EUR" }`, for API boundaries. Valibot is an optional peer dependency: only this entry
+ * imports it.
+ */
+import * as valibot from 'valibot';
+import { type MoneyJSON } from './money.js';
+import { type MoneyFor, type MoneySchemaOptions } from './schema.js';
+export type { MoneyFor, MoneySchemaOptions } from './schema.js';
+declare const jsonShape: valibot.ObjectSchema<{
+    readonly amount: valibot.StringSchema<undefined>;
+    readonly currency: valibot.StringSchema<undefined>;
+}, undefined>;
+/** The schema type both functions return: the JSON shape, then a transformation. */
+export type MoneySchema<TOutput> = valibot.SchemaWithPipe<readonly [typeof jsonShape, valibot.RawTransformAction<MoneyJSON, TOutput>]>;
+/**
+ * Parses `{ amount, currency }` into Money, accepting exactly what the Zod entry accepts (see its
+ * `moneySchema`): an exact decimal string with no more decimals than the scale and at most
+ * `maxDigits` digits, padded to the scale, and a listed or known currency. Problems are Valibot
+ * issues on `amount` or `currency`; other keys are dropped. Bad options throw when the schema is
+ * built. Valibot has no codecs, so encode with `money.toJSON()` (or `JSON.stringify`), which this
+ * schema reads back.
+ *
+ *     const Order = valibot.object({ total: moneySchema({ currency: 'EUR' }) })
+ *     v.parse(Order, { total: { amount: '12.34', currency: 'EUR' } }).total   // Money<'EUR'>
+ */
+export declare function moneySchema<C extends string = string>(options?: MoneySchemaOptions<C>): MoneySchema<MoneyFor<C>>;
+/**
+ * Like `moneySchema`, but the output stays the JSON object: it checks that the input would parse,
+ * for code that passes the JSON on rather than computing with it.
+ */
+export declare function moneyJSONSchema<C extends string = string>(options?: MoneySchemaOptions<C>): MoneySchema<MoneyJSON<C>>;
+//# sourceMappingURL=valibot.d.ts.map

package/dist/valibot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valibot.d.ts","sourceRoot":"","sources":["../src/valibot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAGL,KAAK,QAAQ,EAEb,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEhE,QAAA,MAAM,SAAS;;;aAA2E,CAAC;AAE3F,oFAAoF;AACpF,MAAM,MAAM,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC,cAAc,CACvD,SAAS,CAAC,OAAO,SAAS,EAAE,OAAO,CAAC,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAC5E,CAAC;AAeF;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACnD,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC9B,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAc1B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACvD,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC9B,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAc3B"}

package/dist/valibot.js

@@ -0,0 +1,61 @@
+/**
+ * `@ducatjs/money/valibot`: Valibot schemas for the JSON form of Money, `{ "amount": "12.34",
+ * "currency": "EUR" }`, for API boundaries. Valibot is an optional peer dependency: only this entry
+ * imports it.
+ */
+import * as valibot from 'valibot';
+import { isMoney } from './money.js';
+import { checkSchemaOptions, readMoneyJSON, } from './schema.js';
+const jsonShape = valibot.object({ amount: valibot.string(), currency: valibot.string() });
+/** A Valibot issue path pointing at the field that is wrong. */
+function pathTo(json, issue) {
+    return [
+        {
+            type: 'object',
+            origin: 'value',
+            input: json,
+            key: issue.field,
+            value: json[issue.field],
+        },
+    ];
+}
+/**
+ * Parses `{ amount, currency }` into Money, accepting exactly what the Zod entry accepts (see its
+ * `moneySchema`): an exact decimal string with no more decimals than the scale and at most
+ * `maxDigits` digits, padded to the scale, and a listed or known currency. Problems are Valibot
+ * issues on `amount` or `currency`; other keys are dropped. Bad options throw when the schema is
+ * built. Valibot has no codecs, so encode with `money.toJSON()` (or `JSON.stringify`), which this
+ * schema reads back.
+ *
+ *     const Order = valibot.object({ total: moneySchema({ currency: 'EUR' }) })
+ *     v.parse(Order, { total: { amount: '12.34', currency: 'EUR' } }).total   // Money<'EUR'>
+ */
+export function moneySchema(options) {
+    checkSchemaOptions(options);
+    return valibot.pipe(jsonShape, valibot.rawTransform(({ dataset, addIssue, NEVER }) => {
+        const json = dataset.value;
+        const result = readMoneyJSON(json, options);
+        if (isMoney(result)) {
+            return result;
+        }
+        addIssue({ message: result.message, path: pathTo(json, result) });
+        return NEVER;
+    }));
+}
+/**
+ * Like `moneySchema`, but the output stays the JSON object: it checks that the input would parse,
+ * for code that passes the JSON on rather than computing with it.
+ */
+export function moneyJSONSchema(options) {
+    checkSchemaOptions(options);
+    return valibot.pipe(jsonShape, valibot.rawTransform(({ dataset, addIssue, NEVER }) => {
+        const json = dataset.value;
+        const result = readMoneyJSON(json, options);
+        if (isMoney(result)) {
+            return json;
+        }
+        addIssue({ message: result.message, path: pathTo(json, result) });
+        return NEVER;
+    }));
+}
+//# sourceMappingURL=valibot.js.map

package/dist/valibot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"valibot.js","sourceRoot":"","sources":["../src/valibot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,OAAO,EAA8B,MAAM,YAAY,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,aAAa,GAId,MAAM,aAAa,CAAC;AAIrB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAO3F,gEAAgE;AAChE,SAAS,MAAM,CAAC,IAAe,EAAE,KAAiB;IAChD,OAAO;QACL;YACE,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,IAA0C;YACjD,GAAG,EAAE,KAAK,CAAC,KAAK;YAChB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;SACzB;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CACzB,OAA+B;IAE/B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,OAAO,CAAC,IAAI,CACjB,SAAS,EACT,OAAO,CAAC,YAAY,CAAyB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QAC5E,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,OAAO,MAA8B,CAAC;QACxC,CAAC;QACD,QAAQ,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,OAA+B;IAE/B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,OAAO,CAAC,IAAI,CACjB,SAAS,EACT,OAAO,CAAC,YAAY,CAA0B,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QAC7E,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,OAAO,IAAoB,CAAC;QAC9B,CAAC;QACD,QAAQ,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/zod.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `@ducatjs/money/zod`: Zod schemas for the JSON form of Money, `{ "amount": "12.34", "currency":
+ * "EUR" }`, for API boundaries. Zod is an optional peer dependency: only this entry imports it.
+ */
+import { z } from 'zod';
+import { type MoneyJSON } from './money.js';
+import { type MoneyFor, type MoneySchemaOptions } from './schema.js';
+export type { MoneyFor, MoneySchemaOptions } from './schema.js';
+declare const jsonShape: z.ZodObject<{
+    amount: z.ZodString;
+    currency: z.ZodString;
+}, z.core.$strip>;
+/** The schema `moneySchema` returns: a Zod codec between the JSON form and Money. */
+export type MoneyCodec<C extends string> = z.ZodCodec<typeof jsonShape, z.ZodCustom<MoneyFor<C>>>;
+/**
+ * Parses `{ amount, currency }` into Money, and encodes Money back to that JSON form. It is a Zod
+ * codec, so `schema.parse(json)` (or `z.decode`) gives Money and `z.encode(schema, money)` gives
+ * `{ amount, currency }`, written at the amount's own scale.
+ *
+ * The amount must be an exact decimal string with no more decimals than the scale (the
+ * currency's exponent unless `scale` is given; `rounding` allows more), and at most `maxDigits`
+ * digits. The currency must be one of `currency`, or any known code. Shorter amounts are padded to
+ * the scale ("1.5" EUR gives 1.50 EUR). Problems are Zod issues on `amount` or `currency`; keys
+ * other than those two are dropped. Bad options throw when the schema is built.
+ *
+ *     const Order = z.object({ total: moneySchema({ currency: 'EUR' }) })
+ *     Order.parse({ total: { amount: '12.34', currency: 'EUR' } }).total   // Money<'EUR'>
+ */
+export declare function moneySchema<C extends string = string>(options?: MoneySchemaOptions<C>): MoneyCodec<C>;
+/**
+ * Like `moneySchema`, but the output stays the JSON object (with only `amount` and `currency`): it
+ * checks that the input would parse, for code that passes the JSON on rather than computing with
+ * it.
+ */
+export declare function moneyJSONSchema<C extends string = string>(options?: MoneySchemaOptions<C>): z.ZodType<MoneyJSON<C>, MoneyJSON>;
+//# sourceMappingURL=zod.d.ts.map

package/dist/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../src/zod.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEhE,QAAA,MAAM,SAAS;;;iBAAyD,CAAC;AAEzE,qFAAqF;AACrF,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAElG;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACnD,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC9B,UAAU,CAAC,CAAC,CAAC,CAsBf;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACvD,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC9B,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAUpC"}

package/dist/zod.js

@@ -0,0 +1,58 @@
+/**
+ * `@ducatjs/money/zod`: Zod schemas for the JSON form of Money, `{ "amount": "12.34", "currency":
+ * "EUR" }`, for API boundaries. Zod is an optional peer dependency: only this entry imports it.
+ */
+import { z } from 'zod';
+import { isMoney } from './money.js';
+import { checkSchemaOptions, readMoneyJSON, } from './schema.js';
+const jsonShape = z.object({ amount: z.string(), currency: z.string() });
+/**
+ * Parses `{ amount, currency }` into Money, and encodes Money back to that JSON form. It is a Zod
+ * codec, so `schema.parse(json)` (or `z.decode`) gives Money and `z.encode(schema, money)` gives
+ * `{ amount, currency }`, written at the amount's own scale.
+ *
+ * The amount must be an exact decimal string with no more decimals than the scale (the
+ * currency's exponent unless `scale` is given; `rounding` allows more), and at most `maxDigits`
+ * digits. The currency must be one of `currency`, or any known code. Shorter amounts are padded to
+ * the scale ("1.5" EUR gives 1.50 EUR). Problems are Zod issues on `amount` or `currency`; keys
+ * other than those two are dropped. Bad options throw when the schema is built.
+ *
+ *     const Order = z.object({ total: moneySchema({ currency: 'EUR' }) })
+ *     Order.parse({ total: { amount: '12.34', currency: 'EUR' } }).total   // Money<'EUR'>
+ */
+export function moneySchema(options) {
+    checkSchemaOptions(options);
+    return z.codec(jsonShape, z.custom((value) => isMoney(value)), {
+        decode: (json, payload) => {
+            const result = readMoneyJSON(json, options);
+            if (isMoney(result)) {
+                return result;
+            }
+            payload.issues.push({
+                code: 'custom',
+                message: result.message,
+                input: json,
+                path: [result.field],
+            });
+            return z.NEVER;
+        },
+        encode: (value) => value.toJSON(),
+    });
+}
+/**
+ * Like `moneySchema`, but the output stays the JSON object (with only `amount` and `currency`): it
+ * checks that the input would parse, for code that passes the JSON on rather than computing with
+ * it.
+ */
+export function moneyJSONSchema(options) {
+    checkSchemaOptions(options);
+    return jsonShape.transform((json, context) => {
+        const result = readMoneyJSON(json, options);
+        if (isMoney(result)) {
+            return json;
+        }
+        context.addIssue({ code: 'custom', message: result.message, path: [result.field] });
+        return z.NEVER;
+    });
+}
+//# sourceMappingURL=zod.js.map

package/dist/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../src/zod.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAA8B,MAAM,YAAY,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,aAAa,GAGd,MAAM,aAAa,CAAC;AAIrB,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAKzE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CACzB,OAA+B;IAE/B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,CAAC,CAAC,KAAK,CACZ,SAAS,EACT,CAAC,CAAC,MAAM,CAAc,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAChD;QACE,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YACxB,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5C,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpB,OAAO,MAA8B,CAAC;YACxC,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;gBAClB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;aACrB,CAAC,CAAC;YACH,OAAO,CAAC,CAAC,KAAK,CAAC;QACjB,CAAC;QACD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAE,KAAe,CAAC,MAAM,EAAE;KAC7C,CACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,OAA+B;IAE/B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,OAAO,IAAoB,CAAC;QAC9B,CAAC;QACD,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpF,OAAO,CAAC,CAAC,KAAK,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC"}