@amboras-dev/money 0.1.0 → 0.2.0

package/dist/input.d.ts

@@ -1,5 +1,5 @@
-import { L as DecimalText, r as Money, y as FractionDigits } from "./money-CbhsT0fB.js";
-import { r as Rate } from "./rate-CmeTGNex.js";
+import { R as DecimalText, b as FractionDigits, i as Money } from "./money-B-3aFjNJ.js";
+import { r as Rate } from "./rate-DBPiYgT1.js";
 //#region src/input/amount.d.ts
 /** Why typed text is not an acceptable amount. */
 type ParseFailureReason = 'empty' | 'unparseable' | 'too_many_decimals' | 'negative' | 'zero' | 'below_min' | 'above_max';

package/dist/input.js

@@ -1,7 +1,7 @@
-import { Z as MoneyError, dt as toDecimalText, et as compareDecimal, it as fractionDigitsOf, lt as roundToScale, rt as formatDecimal, s as storedDecimal, z as decimalOf } from "./money-CIgELekG.js";
-import { n as readNumberText } from "./number-text-C82oh6JB.js";
-import { c as rateFromDecimal, o as rate } from "./rate-lLPViBuM.js";
-import { a as inputStep, i as inputPlaceholder, n as formatAmountInput, o as localeSeparators, r as groupDigits, s as parseAmountInput, t as decimalOfText } from "./amount-D7dj76nH.js";
+import { B as decimalOf, Q as MoneyError, at as fractionDigitsOf, dt as roundToScale, it as formatDecimal, pt as toDecimalText, s as storedDecimal, tt as compareDecimal } from "./money-WhnGiI00.js";
+import { n as readNumberText } from "./number-text-DE-q4jO5.js";
+import { c as rateFromDecimal, o as rate } from "./rate-DicStBue.js";
+import { a as inputStep, i as inputPlaceholder, n as formatAmountInput, o as localeSeparators, r as groupDigits, s as parseAmountInput, t as decimalOfText } from "./amount-BoYBMgK9.js";
 //#region src/input/import.ts
 /**
 * Amount text from a file or a third party to canonical DecimalText (major units, exactly as

package/dist/{iso-minor-CtaiIifs.js → iso-minor-CqkWDxHS.js}

@@ -1,4 +1,4 @@
-import { E as resolveCurrency, Q as describeValue, Y as mulDiv, Z as MoneyError, ct as pow10, k as storageExponent, s as storedDecimal, st as parseDecimal, t as boundedMoney } from "./money-CIgELekG.js";
+import { $ as describeValue, E as resolveCurrency, Q as MoneyError, X as mulDiv, k as storageExponent, lt as parseDecimal, s as storedDecimal, t as boundedMoney, ut as pow10 } from "./money-WhnGiI00.js";
 //#region src/iso-minor.ts
 /**
 * Internal: stored units per ISO minor unit at `digits`, `storageScale / 10^digits` (100 for

package/dist/{iso-minor--gQWI1f2.cjs → iso-minor-wSwJN57T.cjs}

@@ -1,4 +1,4 @@
-const require_money = require("./money-D5-vlv0h.cjs");
+const require_money = require("./money-B3wH_Z4S.cjs");
 //#region src/iso-minor.ts
 /**
 * Internal: stored units per ISO minor unit at `digits`, `storageScale / 10^digits` (100 for

package/dist/{medusa-DuQ3-KoD.d.cts → medusa-4K8N1pUc.d.cts}

@@ -1,4 +1,4 @@
-import { L as DecimalText, a as StoredAmount, i as ReadStoredOptions, r as Money } from "./money-CbhsT0fB.cjs";
+import { R as DecimalText, a as ReadStoredOptions, i as Money, o as StoredAmount } from "./money-B-3aFjNJ.cjs";
 //#region src/medusa.d.ts
 /**
  * `row['raw_' + key]` when it is not null/undefined (a failure to read it is final: no
@@ -31,6 +31,15 @@ declare function readStoredDecimal(raw: unknown, options?: ReadStoredDecimalOpti
   mode?: 'strict';
 }): DecimalText;
 declare function readStoredDecimal(raw: unknown, options?: ReadStoredDecimalOptions): DecimalText | null;
+/**
+ * A Medusa amount's literal, verbatim (`'4300.00'` stays `'4300.00'`), for SQL and ledger columns:
+ * `.value ?? .numeric ?? raw` when it is an unsigned decimal literal without leading zeros
+ * (`isDecimalLiteral(text, { leadingZeros: false })`), else null. A number counts only while all
+ * its digits are there (finite; a safe integer when whole) and is spelled `String(n)`. Unlike
+ * `readStoredDecimal` it neither canonicalizes nor reads `.raw.value`, a bigint or a BigNumber's
+ * `valueOf`: the literal is passed on as Medusa holds it.
+ */
+declare function readStoredLiteral(raw: unknown): string | null;
 /**
  * A variant's `calculated_price` (a number, or an object read through
  * `raw_calculated_amount` / `calculated_amount`) as Money in
@@ -75,4 +84,4 @@ declare function moneyFor(source: MoneyByCurrency | readonly PriceLike[], curren
 /** Whether unknown Medusa input holds an amount above zero. `''`, null and garbage are false, never a throw. */
 declare function isPositiveAmount(raw: unknown): boolean;
 //#endregion
-export { isPositiveAmount as a, readCalculatedPrice as c, toMedusaAmountInput as d, toMedusaRaw as f, ReadStoredDecimalOptions as i, readStoredDecimal as l, MoneyByCurrency as n, moneyByCurrency as o, PriceLike as r, moneyFor as s, MedusaRaw as t, readStoredField as u };
+export { isPositiveAmount as a, readCalculatedPrice as c, readStoredLiteral as d, toMedusaAmountInput as f, ReadStoredDecimalOptions as i, readStoredDecimal as l, MoneyByCurrency as n, moneyByCurrency as o, toMedusaRaw as p, PriceLike as r, moneyFor as s, MedusaRaw as t, readStoredField as u };

package/dist/{medusa-RwqxaDGq.d.ts → medusa-DBXJXXvF.d.ts}

@@ -1,4 +1,4 @@
-import { L as DecimalText, a as StoredAmount, i as ReadStoredOptions, r as Money } from "./money-CbhsT0fB.js";
+import { R as DecimalText, a as ReadStoredOptions, i as Money, o as StoredAmount } from "./money-B-3aFjNJ.js";
 //#region src/medusa.d.ts
 /**
  * `row['raw_' + key]` when it is not null/undefined (a failure to read it is final: no
@@ -31,6 +31,15 @@ declare function readStoredDecimal(raw: unknown, options?: ReadStoredDecimalOpti
   mode?: 'strict';
 }): DecimalText;
 declare function readStoredDecimal(raw: unknown, options?: ReadStoredDecimalOptions): DecimalText | null;
+/**
+ * A Medusa amount's literal, verbatim (`'4300.00'` stays `'4300.00'`), for SQL and ledger columns:
+ * `.value ?? .numeric ?? raw` when it is an unsigned decimal literal without leading zeros
+ * (`isDecimalLiteral(text, { leadingZeros: false })`), else null. A number counts only while all
+ * its digits are there (finite; a safe integer when whole) and is spelled `String(n)`. Unlike
+ * `readStoredDecimal` it neither canonicalizes nor reads `.raw.value`, a bigint or a BigNumber's
+ * `valueOf`: the literal is passed on as Medusa holds it.
+ */
+declare function readStoredLiteral(raw: unknown): string | null;
 /**
  * A variant's `calculated_price` (a number, or an object read through
  * `raw_calculated_amount` / `calculated_amount`) as Money in
@@ -75,4 +84,4 @@ declare function moneyFor(source: MoneyByCurrency | readonly PriceLike[], curren
 /** Whether unknown Medusa input holds an amount above zero. `''`, null and garbage are false, never a throw. */
 declare function isPositiveAmount(raw: unknown): boolean;
 //#endregion
-export { isPositiveAmount as a, readCalculatedPrice as c, toMedusaAmountInput as d, toMedusaRaw as f, ReadStoredDecimalOptions as i, readStoredDecimal as l, MoneyByCurrency as n, moneyByCurrency as o, PriceLike as r, moneyFor as s, MedusaRaw as t, readStoredField as u };
+export { isPositiveAmount as a, readCalculatedPrice as c, readStoredLiteral as d, toMedusaAmountInput as f, ReadStoredDecimalOptions as i, readStoredDecimal as l, MoneyByCurrency as n, moneyByCurrency as o, toMedusaRaw as p, PriceLike as r, moneyFor as s, MedusaRaw as t, readStoredField as u };

package/dist/{medusa-CmxCni-G.js → medusa-DqJY1qpj.js}

@@ -1,4 +1,4 @@
-import { D as sameCurrency, E as resolveCurrency, Q as describeValue, Z as MoneyError, a as money, at as isPositiveDecimal, b as firstCurrency, d as currencyCode, dt as toDecimalText, i as medusaAmountDecimal, o as readStored, r as isStoredAmount, s as storedDecimal, z as decimalOf } from "./money-CIgELekG.js";
+import { $ as describeValue, B as decimalOf, D as sameCurrency, E as resolveCurrency, G as isDecimalLiteral, Q as MoneyError, a as money, b as firstCurrency, d as currencyCode, ft as strictNumberDecimal, i as medusaAmountDecimal, o as readStored, ot as isPositiveDecimal, pt as toDecimalText, r as isStoredAmount, s as storedDecimal } from "./money-WhnGiI00.js";
 import { t as hasOwnKey } from "./own-D7544D3k.js";
 //#region src/medusa.ts
 const isObject = (value) => typeof value === "object" && value !== null;
@@ -21,6 +21,21 @@ function readStoredDecimal(raw, options = {}) {
 	throw new MoneyError("amount_invalid", `Invalid stored amount: ${describeValue(raw)}`, { field: options.field });
 }
 /**
+* A Medusa amount's literal, verbatim (`'4300.00'` stays `'4300.00'`), for SQL and ledger columns:
+* `.value ?? .numeric ?? raw` when it is an unsigned decimal literal without leading zeros
+* (`isDecimalLiteral(text, { leadingZeros: false })`), else null. A number counts only while all
+* its digits are there (finite; a safe integer when whole) and is spelled `String(n)`. Unlike
+* `readStoredDecimal` it neither canonicalizes nor reads `.raw.value`, a bigint or a BigNumber's
+* `valueOf`: the literal is passed on as Medusa holds it.
+*/
+function readStoredLiteral(raw) {
+	const picked = isObject(raw) ? raw.value ?? raw.numeric ?? raw : raw;
+	let literal = null;
+	if (typeof picked === "string") literal = picked;
+	else if (typeof picked === "number" && strictNumberDecimal(picked) !== null) literal = String(picked);
+	return literal !== null && isDecimalLiteral(literal, { leadingZeros: false }) ? literal : null;
+}
+/**
 * A variant's `calculated_price` (a number, or an object read through
 * `raw_calculated_amount` / `calculated_amount`) as Money in
 * `firstCurrency(calculated_price.currency_code, fallbackCurrency)`. Null on anything
@@ -98,4 +113,4 @@ function isPositiveAmount(raw) {
 	return value !== null && isPositiveDecimal(value);
 }
 //#endregion
-export { readStoredDecimal as a, toMedusaAmountInput as c, readCalculatedPrice as i, toMedusaRaw as l, moneyByCurrency as n, readStoredField as o, moneyFor as r, storedFieldValue as s, isPositiveAmount as t };
+export { readStoredDecimal as a, storedFieldValue as c, readCalculatedPrice as i, toMedusaAmountInput as l, moneyByCurrency as n, readStoredField as o, moneyFor as r, readStoredLiteral as s, isPositiveAmount as t, toMedusaRaw as u };

package/dist/{medusa-OJ2TJOxt.cjs → medusa-lRY9xlsf.cjs}

@@ -1,4 +1,4 @@
-const require_money = require("./money-D5-vlv0h.cjs");
+const require_money = require("./money-B3wH_Z4S.cjs");
 const require_own = require("./own-oP9DXFWv.cjs");
 //#region src/medusa.ts
 const isObject = (value) => typeof value === "object" && value !== null;
@@ -21,6 +21,21 @@ function readStoredDecimal(raw, options = {}) {
 	throw new require_money.MoneyError("amount_invalid", `Invalid stored amount: ${require_money.describeValue(raw)}`, { field: options.field });
 }
 /**
+* A Medusa amount's literal, verbatim (`'4300.00'` stays `'4300.00'`), for SQL and ledger columns:
+* `.value ?? .numeric ?? raw` when it is an unsigned decimal literal without leading zeros
+* (`isDecimalLiteral(text, { leadingZeros: false })`), else null. A number counts only while all
+* its digits are there (finite; a safe integer when whole) and is spelled `String(n)`. Unlike
+* `readStoredDecimal` it neither canonicalizes nor reads `.raw.value`, a bigint or a BigNumber's
+* `valueOf`: the literal is passed on as Medusa holds it.
+*/
+function readStoredLiteral(raw) {
+	const picked = isObject(raw) ? raw.value ?? raw.numeric ?? raw : raw;
+	let literal = null;
+	if (typeof picked === "string") literal = picked;
+	else if (typeof picked === "number" && require_money.strictNumberDecimal(picked) !== null) literal = String(picked);
+	return literal !== null && require_money.isDecimalLiteral(literal, { leadingZeros: false }) ? literal : null;
+}
+/**
 * A variant's `calculated_price` (a number, or an object read through
 * `raw_calculated_amount` / `calculated_amount`) as Money in
 * `firstCurrency(calculated_price.currency_code, fallbackCurrency)`. Null on anything
@@ -134,6 +149,12 @@ Object.defineProperty(exports, "readStoredField", {
 		return readStoredField;
 	}
 });
+Object.defineProperty(exports, "readStoredLiteral", {
+	enumerable: true,
+	get: function() {
+		return readStoredLiteral;
+	}
+});
 Object.defineProperty(exports, "storedFieldValue", {
 	enumerable: true,
 	get: function() {

package/dist/{money-CbhsT0fB.d.cts → money-B-3aFjNJ.d.cts}

@@ -145,6 +145,16 @@ interface Money {
   readonly amount: StoredAmount;
   readonly currency: CurrencyCode;
 }
+/**
+ * A stored amount that may hold a fraction of a storage unit, as Medusa keeps unrounded totals (a
+ * tax line can leave 107.8175): a finite number (a safe integer when whole) or plain decimal text
+ * (`readStoredDecimal`'s result). `Money` is always whole; the PSP codecs and comparators take
+ * either, and `formatStored` formats one.
+ */
+interface FractionalMoney {
+  readonly amount: number | DecimalText;
+  readonly currency: string;
+}
 interface FromMajorOptions {
   /**
    * More fraction digits than the currency stores: `'reject'` (default) throws
@@ -176,6 +186,11 @@ interface ToMajorDecimalOptions {
 interface ReadStoredOptions {
   /** `'strict'` (default) throws `amount_invalid` on a bad amount; `'lenient'` returns null. Never 0. */
   mode?: 'strict' | 'lenient';
+  /**
+   * A fractional stored amount (Medusa's unrounded totals, 107.8175): `'reject'` (default) reads it
+   * as invalid; `'round'` rounds it half-up, exactly, to a whole storage unit (107.8175 gives 108).
+   */
+  precision?: 'reject' | 'round';
   /** Names the input field in errors. */
   field?: string;
 }
@@ -217,8 +232,9 @@ declare function toMajorNumber(m: Money, options?: ToMajorDecimalOptions): numbe
  * A stored amount as Medusa hands it over (a number, a numeric string, a raw
  * `{ value: '4300', precision: 20 }`, a live BigNumber) as Money. Precedence
  * `.value ?? .raw.value ?? .raw_.value`, then `.numeric ?? .numeric_`, then the
- * primitive. `'4300.00'` is accepted; a fractional, non-finite, unsafe or unreadable
- * amount throws `amount_invalid`, or gives null with `mode: 'lenient'` (never 0).
+ * primitive. `'4300.00'` is accepted; a fractional amount is rounded half-up to a whole
+ * storage unit with `precision: 'round'`; otherwise a fractional, non-finite, unsafe or
+ * unreadable amount throws `amount_invalid`, or gives null with `mode: 'lenient'` (never 0).
  * An unknown currency always throws.
  */
 declare function readStored(raw: unknown, currency: string, options: ReadStoredOptions & {
@@ -229,4 +245,4 @@ declare function readStored(raw: unknown, currency: string, options?: ReadStored
 }): Money;
 declare function readStored(raw: unknown, currency: string, options?: ReadStoredOptions): Money | null;
 //#endregion
-export { localeForCurrency as A, currencyLabel as C, displayDigits as D, currencySymbol as E, storageDigits as F, storageScale as I, DecimalText as L, medusaEpsilon as M, parseCurrencyCode as N, firstCurrency as O, sameCurrency as P, RoundingMode as R, currencyInfo as S, currencyOptions as T, CurrencyInfo as _, StoredAmount as a, StorageScale as b, fromMajor as c, readStored as d, toMajorDecimal as f, CurrencyCodeOptions as g, CurrencyCode as h, ReadStoredOptions as i, medusaCurrencyCode as j, isCurrencyCode as k, isStoredAmount as l, CURRENCIES as m, MajorDecimal as n, StoredAmountOptions as o, toMajorNumber as p, Money as r, ToMajorDecimalOptions as s, FromMajorOptions as t, money as u, CurrencyStatus as v, currencyName as w, currencyCode as x, FractionDigits as y };
+export { isCurrencyCode as A, currencyInfo as C, currencySymbol as D, currencyOptions as E, sameCurrency as F, storageDigits as I, storageScale as L, medusaCurrencyCode as M, medusaEpsilon as N, displayDigits as O, parseCurrencyCode as P, DecimalText as R, currencyCode as S, currencyName as T, CurrencyCodeOptions as _, ReadStoredOptions as a, FractionDigits as b, ToMajorDecimalOptions as c, money as d, readStored as f, CurrencyCode as g, CURRENCIES as h, Money as i, localeForCurrency as j, firstCurrency as k, fromMajor as l, toMajorNumber as m, FromMajorOptions as n, StoredAmount as o, toMajorDecimal as p, MajorDecimal as r, StoredAmountOptions as s, FractionalMoney as t, isStoredAmount as u, CurrencyInfo as v, currencyLabel as w, StorageScale as x, CurrencyStatus as y, RoundingMode as z };

package/dist/{money-CbhsT0fB.d.ts → money-B-3aFjNJ.d.ts}

@@ -145,6 +145,16 @@ interface Money {
   readonly amount: StoredAmount;
   readonly currency: CurrencyCode;
 }
+/**
+ * A stored amount that may hold a fraction of a storage unit, as Medusa keeps unrounded totals (a
+ * tax line can leave 107.8175): a finite number (a safe integer when whole) or plain decimal text
+ * (`readStoredDecimal`'s result). `Money` is always whole; the PSP codecs and comparators take
+ * either, and `formatStored` formats one.
+ */
+interface FractionalMoney {
+  readonly amount: number | DecimalText;
+  readonly currency: string;
+}
 interface FromMajorOptions {
   /**
    * More fraction digits than the currency stores: `'reject'` (default) throws
@@ -176,6 +186,11 @@ interface ToMajorDecimalOptions {
 interface ReadStoredOptions {
   /** `'strict'` (default) throws `amount_invalid` on a bad amount; `'lenient'` returns null. Never 0. */
   mode?: 'strict' | 'lenient';
+  /**
+   * A fractional stored amount (Medusa's unrounded totals, 107.8175): `'reject'` (default) reads it
+   * as invalid; `'round'` rounds it half-up, exactly, to a whole storage unit (107.8175 gives 108).
+   */
+  precision?: 'reject' | 'round';
   /** Names the input field in errors. */
   field?: string;
 }
@@ -217,8 +232,9 @@ declare function toMajorNumber(m: Money, options?: ToMajorDecimalOptions): numbe
  * A stored amount as Medusa hands it over (a number, a numeric string, a raw
  * `{ value: '4300', precision: 20 }`, a live BigNumber) as Money. Precedence
  * `.value ?? .raw.value ?? .raw_.value`, then `.numeric ?? .numeric_`, then the
- * primitive. `'4300.00'` is accepted; a fractional, non-finite, unsafe or unreadable
- * amount throws `amount_invalid`, or gives null with `mode: 'lenient'` (never 0).
+ * primitive. `'4300.00'` is accepted; a fractional amount is rounded half-up to a whole
+ * storage unit with `precision: 'round'`; otherwise a fractional, non-finite, unsafe or
+ * unreadable amount throws `amount_invalid`, or gives null with `mode: 'lenient'` (never 0).
  * An unknown currency always throws.
  */
 declare function readStored(raw: unknown, currency: string, options: ReadStoredOptions & {
@@ -229,4 +245,4 @@ declare function readStored(raw: unknown, currency: string, options?: ReadStored
 }): Money;
 declare function readStored(raw: unknown, currency: string, options?: ReadStoredOptions): Money | null;
 //#endregion
-export { localeForCurrency as A, currencyLabel as C, displayDigits as D, currencySymbol as E, storageDigits as F, storageScale as I, DecimalText as L, medusaEpsilon as M, parseCurrencyCode as N, firstCurrency as O, sameCurrency as P, RoundingMode as R, currencyInfo as S, currencyOptions as T, CurrencyInfo as _, StoredAmount as a, StorageScale as b, fromMajor as c, readStored as d, toMajorDecimal as f, CurrencyCodeOptions as g, CurrencyCode as h, ReadStoredOptions as i, medusaCurrencyCode as j, isCurrencyCode as k, isStoredAmount as l, CURRENCIES as m, MajorDecimal as n, StoredAmountOptions as o, toMajorNumber as p, Money as r, ToMajorDecimalOptions as s, FromMajorOptions as t, money as u, CurrencyStatus as v, currencyName as w, currencyCode as x, FractionDigits as y };
+export { isCurrencyCode as A, currencyInfo as C, currencySymbol as D, currencyOptions as E, sameCurrency as F, storageDigits as I, storageScale as L, medusaCurrencyCode as M, medusaEpsilon as N, displayDigits as O, parseCurrencyCode as P, DecimalText as R, currencyCode as S, currencyName as T, CurrencyCodeOptions as _, ReadStoredOptions as a, FractionDigits as b, ToMajorDecimalOptions as c, money as d, readStored as f, CurrencyCode as g, CURRENCIES as h, Money as i, localeForCurrency as j, firstCurrency as k, fromMajor as l, toMajorNumber as m, FromMajorOptions as n, StoredAmount as o, toMajorDecimal as p, MajorDecimal as r, StoredAmountOptions as s, FractionalMoney as t, isStoredAmount as u, CurrencyInfo as v, currencyLabel as w, StorageScale as x, CurrencyStatus as y, RoundingMode as z };

package/dist/{money-D5-vlv0h.cjs → money-B3wH_Z4S.cjs}

@@ -276,6 +276,18 @@ function decimalRound(a, options) {
 function decimalCompare(a, b) {
 	return compareDecimal(decimalOf(a), decimalOf(b));
 }
+/**
+* Whether `a` and `b` are the same decimal, exactly (`'43.0'` equals `'43.00'` and `43`). Takes what
+* `decimalCompare` takes, but never throws: anything that is not plain decimal text, a finite number
+* or a bigint is never equal, not even to itself.
+*/
+function decimalEquals(a, b) {
+	try {
+		return compareDecimal(decimalOf(a), decimalOf(b)) === 0;
+	} catch {
+		return false;
+	}
+}
 /** `a` limited to `[min, max]` (either bound optional). `min` above `max` throws `amount_invalid`. */
 function decimalClamp(a, bounds) {
 	const value = decimalOf(a);
@@ -3553,16 +3565,16 @@ function medusaAmountDecimal(raw) {
 	return typeof primitive === "string" ? parseDecimal(primitive) : null;
 }
 const SAFE_LIMIT = BigInt(Number.MAX_SAFE_INTEGER);
-/** A stored integer from Medusa's shapes, or null when it is fractional, unsafe or unreadable. */
-function unwrapStored(raw) {
+/** A stored integer from Medusa's shapes (a fraction rounded half-up with `round`), or null when it is fractional, unsafe or unreadable. */
+function unwrapStored(raw, round) {
 	const parsed = medusaAmountDecimal(raw);
-	if (!parsed || fractionDigitsOf(parsed) !== 0) return null;
-	const whole = roundToScale(parsed, 0, "down");
+	if (!parsed || !round && fractionDigitsOf(parsed) !== 0) return null;
+	const whole = roundToScale(parsed, 0, "half-up");
 	return unitsWithin(whole, SAFE_LIMIT) ? Number(whole.units) : null;
 }
 function readStored(raw, currency, options = {}) {
 	const info = anyKnownCurrency(currency, options.field);
-	const amount = unwrapStored(raw);
+	const amount = unwrapStored(raw, options.precision === "round");
 	if (amount !== null) return storedFrom(amount, info);
 	if (options.mode === "lenient") return null;
 	throw new MoneyError("amount_invalid", `Invalid stored amount: ${describeValue(raw)}`, { field: options.field });
@@ -3670,6 +3682,12 @@ Object.defineProperty(exports, "decimalDivide", {
 		return decimalDivide;
 	}
 });
+Object.defineProperty(exports, "decimalEquals", {
+	enumerable: true,
+	get: function() {
+		return decimalEquals;
+	}
+});
 Object.defineProperty(exports, "decimalFromNumber", {
 	enumerable: true,
 	get: function() {
@@ -3832,6 +3850,12 @@ Object.defineProperty(exports, "multiplyDecimal", {
 		return multiplyDecimal;
 	}
 });
+Object.defineProperty(exports, "normalizeDecimal", {
+	enumerable: true,
+	get: function() {
+		return normalizeDecimal;
+	}
+});
 Object.defineProperty(exports, "numberFormat", {
 	enumerable: true,
 	get: function() {
@@ -3958,3 +3982,9 @@ Object.defineProperty(exports, "trimDecimalZeros", {
 		return trimDecimalZeros;
 	}
 });
+Object.defineProperty(exports, "unitsWithin", {
+	enumerable: true,
+	get: function() {
+		return unitsWithin;
+	}
+});

package/dist/{money-CIgELekG.js → money-WhnGiI00.js}

@@ -276,6 +276,18 @@ function decimalRound(a, options) {
 function decimalCompare(a, b) {
 	return compareDecimal(decimalOf(a), decimalOf(b));
 }
+/**
+* Whether `a` and `b` are the same decimal, exactly (`'43.0'` equals `'43.00'` and `43`). Takes what
+* `decimalCompare` takes, but never throws: anything that is not plain decimal text, a finite number
+* or a bigint is never equal, not even to itself.
+*/
+function decimalEquals(a, b) {
+	try {
+		return compareDecimal(decimalOf(a), decimalOf(b)) === 0;
+	} catch {
+		return false;
+	}
+}
 /** `a` limited to `[min, max]` (either bound optional). `min` above `max` throws `amount_invalid`. */
 function decimalClamp(a, bounds) {
 	const value = decimalOf(a);
@@ -3553,19 +3565,19 @@ function medusaAmountDecimal(raw) {
 	return typeof primitive === "string" ? parseDecimal(primitive) : null;
 }
 const SAFE_LIMIT = BigInt(Number.MAX_SAFE_INTEGER);
-/** A stored integer from Medusa's shapes, or null when it is fractional, unsafe or unreadable. */
-function unwrapStored(raw) {
+/** A stored integer from Medusa's shapes (a fraction rounded half-up with `round`), or null when it is fractional, unsafe or unreadable. */
+function unwrapStored(raw, round) {
 	const parsed = medusaAmountDecimal(raw);
-	if (!parsed || fractionDigitsOf(parsed) !== 0) return null;
-	const whole = roundToScale(parsed, 0, "down");
+	if (!parsed || !round && fractionDigitsOf(parsed) !== 0) return null;
+	const whole = roundToScale(parsed, 0, "half-up");
 	return unitsWithin(whole, SAFE_LIMIT) ? Number(whole.units) : null;
 }
 function readStored(raw, currency, options = {}) {
 	const info = anyKnownCurrency(currency, options.field);
-	const amount = unwrapStored(raw);
+	const amount = unwrapStored(raw, options.precision === "round");
 	if (amount !== null) return storedFrom(amount, info);
 	if (options.mode === "lenient") return null;
 	throw new MoneyError("amount_invalid", `Invalid stored amount: ${describeValue(raw)}`, { field: options.field });
 }
 //#endregion
-export { addDecimal as $, storageScale as A, decimalRound as B, medusaCurrencyCode as C, sameCurrency as D, resolveCurrency as E, decimalClamp as F, parseDecimalText as G, decimalSum as H, decimalCompare as I, gcd as J, trimDecimalZeros as K, decimalDivide as L, resolveLocale as M, separatorsOf as N, storageDigits as O, assertDecimalLiteral as P, describeValue as Q, decimalMultiply as R, localeForCurrency as S, parseCurrencyCode as T, decimalWithin as U, decimalSubtract as V, isDecimalLiteral as W, ratioToDecimal as X, mulDiv as Y, MoneyError as Z, currencySymbol as _, money as a, isPositiveDecimal as at, firstCurrency as b, toMajorDecimal as c, pow10 as ct, currencyCode as d, toDecimalText as dt, compareDecimal as et, currencyInfo as f, currencyOptions as g, currencyName as h, medusaAmountDecimal as i, fractionDigitsOf as it, numberFormat as j, storageExponent as k, toMajorNumber as l, roundToScale as lt, currencyMarks as m, fromMajor as n, divRound as nt, readStored as o, multiplyDecimal as ot, currencyLabel as p, compareRatio as q, isStoredAmount as r, formatDecimal as rt, storedDecimal as s, parseDecimal as st, boundedMoney as t, decimalFromNumber as tt, CURRENCIES as u, strictNumberDecimal as ut, displayDigits as v, medusaEpsilon as w, isCurrencyCode as x, findCurrency as y, decimalOf as z };
+export { describeValue as $, storageScale as A, decimalOf as B, medusaCurrencyCode as C, sameCurrency as D, resolveCurrency as E, decimalClamp as F, isDecimalLiteral as G, decimalSubtract as H, decimalCompare as I, compareRatio as J, parseDecimalText as K, decimalDivide as L, resolveLocale as M, separatorsOf as N, storageDigits as O, assertDecimalLiteral as P, MoneyError as Q, decimalEquals as R, localeForCurrency as S, parseCurrencyCode as T, decimalSum as U, decimalRound as V, decimalWithin as W, mulDiv as X, gcd as Y, ratioToDecimal as Z, currencySymbol as _, money as a, fractionDigitsOf as at, firstCurrency as b, toMajorDecimal as c, normalizeDecimal as ct, currencyCode as d, roundToScale as dt, addDecimal as et, currencyInfo as f, strictNumberDecimal as ft, currencyOptions as g, currencyName as h, medusaAmountDecimal as i, formatDecimal as it, numberFormat as j, storageExponent as k, toMajorNumber as l, parseDecimal as lt, currencyMarks as m, unitsWithin as mt, fromMajor as n, decimalFromNumber as nt, readStored as o, isPositiveDecimal as ot, currencyLabel as p, toDecimalText as pt, trimDecimalZeros as q, isStoredAmount as r, divRound as rt, storedDecimal as s, multiplyDecimal as st, boundedMoney as t, compareDecimal as tt, CURRENCIES as u, pow10 as ut, displayDigits as v, medusaEpsilon as w, isCurrencyCode as x, findCurrency as y, decimalMultiply as z };

package/dist/{number-text-BpvN6NAo.cjs → number-text-BWu67jUq.cjs}

@@ -1,4 +1,4 @@
-const require_money = require("./money-D5-vlv0h.cjs");
+const require_money = require("./money-B3wH_Z4S.cjs");
 //#region src/internal/number-text.ts
 const MINUS = /^[-−]/;
 const escapeRegExp = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");

package/dist/{number-text-C82oh6JB.js → number-text-DE-q4jO5.js}

@@ -1,4 +1,4 @@
-import { E as resolveCurrency, Q as describeValue, lt as roundToScale, m as currencyMarks } from "./money-CIgELekG.js";
+import { $ as describeValue, E as resolveCurrency, dt as roundToScale, m as currencyMarks } from "./money-WhnGiI00.js";
 //#region src/internal/number-text.ts
 const MINUS = /^[-−]/;
 const escapeRegExp = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");

package/dist/{percent-Dt8vNIAW.cjs → percent-C0InC2t2.cjs}

@@ -1,4 +1,4 @@
-const require_money = require("./money-D5-vlv0h.cjs");
+const require_money = require("./money-B3wH_Z4S.cjs");
 //#region src/internal/percent.ts
 /** 100% for a percent written with `scale` fraction digits: the denominator of its units. */
 function hundredPercent(scale) {

package/dist/{percent-CKVI_c-m.js → percent-D1VB9xXG.js}

@@ -1,4 +1,4 @@
-import { X as ratioToDecimal, Y as mulDiv, ct as pow10 } from "./money-CIgELekG.js";
+import { X as mulDiv, Z as ratioToDecimal, ut as pow10 } from "./money-WhnGiI00.js";
 //#region src/internal/percent.ts
 /** 100% for a percent written with `scale` fraction digits: the denominator of its units. */
 function hundredPercent(scale) {

package/dist/{rate-DGPfB_jc.cjs → rate-CVeMii4a.cjs}

@@ -1,4 +1,4 @@
-const require_money = require("./money-D5-vlv0h.cjs");
+const require_money = require("./money-B3wH_Z4S.cjs");
 const require_own = require("./own-oP9DXFWv.cjs");
 //#region src/fx/rate.ts
 /** Denominator of every locked rate (`store_currency_rate.rate_denominator` default): 7 decimals. */

package/dist/{rate-CmeTGNex.d.ts → rate-DBPiYgT1.d.ts}

@@ -1,4 +1,4 @@
-import { L as DecimalText } from "./money-CbhsT0fB.js";
+import { R as DecimalText } from "./money-B-3aFjNJ.js";
 //#region src/fx/rate.d.ts
 /** 1 base unit = numerator / denominator quote units, both in major units. Positive integers. */
 interface Rate {

package/dist/{rate-lLPViBuM.js → rate-DicStBue.js}

@@ -1,4 +1,4 @@
-import { Q as describeValue, X as ratioToDecimal, Z as MoneyError, ct as pow10, dt as toDecimalText, lt as roundToScale, q as compareRatio, st as parseDecimal, z as decimalOf } from "./money-CIgELekG.js";
+import { $ as describeValue, B as decimalOf, J as compareRatio, Q as MoneyError, Z as ratioToDecimal, dt as roundToScale, lt as parseDecimal, pt as toDecimalText, ut as pow10 } from "./money-WhnGiI00.js";
 import { t as hasOwnKey } from "./own-D7544D3k.js";
 //#region src/fx/rate.ts
 /** Denominator of every locked rate (`store_currency_rate.rate_denominator` default): 7 decimals. */

package/dist/{rate-toyS3EMf.d.cts → rate-tqK8ijG0.d.cts}

@@ -1,4 +1,4 @@
-import { L as DecimalText } from "./money-CbhsT0fB.cjs";
+import { R as DecimalText } from "./money-B-3aFjNJ.cjs";
 //#region src/fx/rate.d.ts
 /** 1 base unit = numerator / denominator quote units, both in major units. Positive integers. */
 interface Rate {

package/dist/{reporting-DEM97DhQ.d.cts → reporting-CG-ai2sM.d.cts}

@@ -1,5 +1,5 @@
-import { L as DecimalText, h as CurrencyCode, r as Money } from "./money-CbhsT0fB.cjs";
-import { a as RateRow } from "./rate-toyS3EMf.cjs";
+import { R as DecimalText, g as CurrencyCode, i as Money } from "./money-B-3aFjNJ.cjs";
+import { a as RateRow } from "./rate-tqK8ijG0.cjs";
 //#region src/fx/reporting.d.ts
 /** `factors[lower code]` takes a stored amount in that currency to a stored amount in `base`. */
 interface FactorTable {

package/dist/{reporting-5xby-Zas.d.ts → reporting-tpGJbqYp.d.ts}

@@ -1,5 +1,5 @@
-import { L as DecimalText, h as CurrencyCode, r as Money } from "./money-CbhsT0fB.js";
-import { a as RateRow } from "./rate-CmeTGNex.js";
+import { R as DecimalText, g as CurrencyCode, i as Money } from "./money-B-3aFjNJ.js";
+import { a as RateRow } from "./rate-DBPiYgT1.js";
 //#region src/fx/reporting.d.ts
 /** `factors[lower code]` takes a stored amount in that currency to a stored amount in `base`. */
 interface FactorTable {

package/dist/{retail-BsvpNv1F.js → retail-1mu888J1.js}

@@ -1,6 +1,6 @@
-import { E as resolveCurrency, Q as describeValue, Z as MoneyError, nt as divRound, s as storedDecimal, t as boundedMoney } from "./money-CIgELekG.js";
-import { a as unitSize, t as mulDivToUnit } from "./rounding-CVAPEfq_.js";
-import { r as percentOfUnits } from "./percent-CKVI_c-m.js";
+import { $ as describeValue, E as resolveCurrency, Q as MoneyError, rt as divRound, s as storedDecimal, t as boundedMoney } from "./money-WhnGiI00.js";
+import { a as unitSize, t as mulDivToUnit } from "./rounding-g9rvye0k.js";
+import { r as percentOfUnits } from "./percent-D1VB9xXG.js";
 //#region src/fx/retail.ts
 const RETAIL_ROUNDINGS = [
 	"none",

package/dist/{retail-Mqd-sPMF.d.cts → retail-C_BPLvMj.d.cts}

@@ -1,4 +1,4 @@
-import { r as Money } from "./money-CbhsT0fB.cjs";
+import { i as Money } from "./money-B-3aFjNJ.cjs";
 //#region src/fx/retail.d.ts
 /**
  * - `'none'`: Medusa `applyRounding` 'none': a zero-decimal currency is rounded to a whole

package/dist/{retail-DTk2XAMM.cjs → retail-Cml8YSKg.cjs}

@@ -1,6 +1,6 @@
-const require_money = require("./money-D5-vlv0h.cjs");
-const require_rounding = require("./rounding-oZ832yTD.cjs");
-const require_percent = require("./percent-Dt8vNIAW.cjs");
+const require_money = require("./money-B3wH_Z4S.cjs");
+const require_rounding = require("./rounding-DHBtNCHG.cjs");
+const require_percent = require("./percent-C0InC2t2.cjs");
 //#region src/fx/retail.ts
 const RETAIL_ROUNDINGS = [
 	"none",

package/dist/{retail-BwcFJcVN.d.ts → retail-DRUTTQoJ.d.ts}

@@ -1,4 +1,4 @@
-import { r as Money } from "./money-CbhsT0fB.js";
+import { i as Money } from "./money-B-3aFjNJ.js";
 //#region src/fx/retail.d.ts
 /**
  * - `'none'`: Medusa `applyRounding` 'none': a zero-decimal currency is rounded to a whole

package/dist/{rounding-oZ832yTD.cjs → rounding-DHBtNCHG.cjs}

@@ -1,4 +1,4 @@
-const require_money = require("./money-D5-vlv0h.cjs");
+const require_money = require("./money-B3wH_Z4S.cjs");
 //#region src/rounding.ts
 /** Internal: the size of `unit` in storage units. */
 function unitSize(info, unit) {

package/dist/{rounding-CVAPEfq_.js → rounding-g9rvye0k.js}

@@ -1,4 +1,4 @@
-import { E as resolveCurrency, Y as mulDiv, Z as MoneyError, ct as pow10, lt as roundToScale, rt as formatDecimal, s as storedDecimal, t as boundedMoney, z as decimalOf } from "./money-CIgELekG.js";
+import { B as decimalOf, E as resolveCurrency, Q as MoneyError, X as mulDiv, dt as roundToScale, it as formatDecimal, s as storedDecimal, t as boundedMoney, ut as pow10 } from "./money-WhnGiI00.js";
 //#region src/rounding.ts
 /** Internal: the size of `unit` in storage units. */
 function unitSize(info, unit) {

package/dist/sql.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_money = require("./money-D5-vlv0h.cjs");
-const require_rate = require("./rate-DGPfB_jc.cjs");
-const require_retail = require("./retail-DTk2XAMM.cjs");
+const require_money = require("./money-B3wH_Z4S.cjs");
+const require_rate = require("./rate-CVeMii4a.cjs");
+const require_retail = require("./retail-Cml8YSKg.cjs");
 //#region src/sql/guard.ts
 const STATEMENT_BREAKERS = /;|--|\/\*|\*\/|\0/;
 const refuse = (name, value) => new require_money.MoneyError("parse", `${name} must be a SQL expression written in code, got ${require_money.describeValue(value)}`);

package/dist/sql.d.cts

@@ -1,5 +1,5 @@
-import { r as Rate } from "./rate-toyS3EMf.cjs";
-import { t as FactorTable } from "./reporting-DEM97DhQ.cjs";
+import { r as Rate } from "./rate-tqK8ijG0.cjs";
+import { t as FactorTable } from "./reporting-CG-ai2sM.cjs";
 //#region src/sql/guard.d.ts
 type SqlBinding = string | number;
 /** Text with knex `?` placeholders and the values they bind, in order: `knex.raw(f.sql, f.bindings)`. */

package/dist/sql.d.ts

@@ -1,5 +1,5 @@
-import { r as Rate } from "./rate-CmeTGNex.js";
-import { t as FactorTable } from "./reporting-5xby-Zas.js";
+import { r as Rate } from "./rate-DBPiYgT1.js";
+import { t as FactorTable } from "./reporting-tpGJbqYp.js";
 //#region src/sql/guard.d.ts
 type SqlBinding = string | number;
 /** Text with knex `?` placeholders and the values they bind, in order: `knex.raw(f.sql, f.bindings)`. */

package/dist/sql.js

@@ -1,6 +1,6 @@
-import { A as storageScale, E as resolveCurrency, Q as describeValue, Z as MoneyError, u as CURRENCIES } from "./money-CIgELekG.js";
-import { r as checkRate } from "./rate-lLPViBuM.js";
-import { t as priceRoundingParams } from "./retail-BsvpNv1F.js";
+import { $ as describeValue, A as storageScale, E as resolveCurrency, Q as MoneyError, u as CURRENCIES } from "./money-WhnGiI00.js";
+import { r as checkRate } from "./rate-DicStBue.js";
+import { t as priceRoundingParams } from "./retail-1mu888J1.js";
 //#region src/sql/guard.ts
 const STATEMENT_BREAKERS = /;|--|\/\*|\*\/|\0/;
 const refuse = (name, value) => new MoneyError("parse", `${name} must be a SQL expression written in code, got ${describeValue(value)}`);