@amboras-dev/money 0.0.0-stage → 0.1.0

package/dist/medusa-RwqxaDGq.d.ts

@@ -0,0 +1,78 @@
+import { L as DecimalText, a as StoredAmount, i as ReadStoredOptions, r as Money } from "./money-CbhsT0fB.js";
+//#region src/medusa.d.ts
+/**
+ * `row['raw_' + key]` when it is not null/undefined (a failure to read it is final: no
+ * fallback to the lossy plain key), else `row[key]`, read like `readStored`.
+ */
+declare function readStoredField(row: unknown, key: string, currency: string, options: ReadStoredOptions & {
+  mode: 'lenient';
+}): Money | null;
+declare function readStoredField(row: unknown, key: string, currency: string, options?: ReadStoredOptions & {
+  mode?: 'strict';
+}): Money;
+declare function readStoredField(row: unknown, key: string, currency: string, options?: ReadStoredOptions): Money | null;
+interface ReadStoredDecimalOptions {
+  /** `'strict'` (default) throws `amount_invalid`; `'lenient'` returns null. Never 0. */
+  mode?: 'strict' | 'lenient';
+  /** Allow negative values. Default true. */
+  signed?: boolean;
+  /** Names the input field in errors. */
+  field?: string;
+}
+/**
+ * Like `readStored` but keeps fractions (Medusa fractional totals, ledger literals) and needs
+ * no currency: the canonical DecimalText (`{ value: '107.81750000000000000000' }` gives
+ * `'107.8175'`). Same shape precedence.
+ */
+declare function readStoredDecimal(raw: unknown, options: ReadStoredDecimalOptions & {
+  mode: 'lenient';
+}): DecimalText | null;
+declare function readStoredDecimal(raw: unknown, options?: ReadStoredDecimalOptions & {
+  mode?: 'strict';
+}): DecimalText;
+declare function readStoredDecimal(raw: unknown, options?: ReadStoredDecimalOptions): DecimalText | 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
+ * missing or unreadable.
+ */
+declare function readCalculatedPrice(variant: unknown, fallbackCurrency?: string): Money | null;
+/** Medusa's raw amount column shape. */
+interface MedusaRaw {
+  readonly value: string;
+  readonly precision: number;
+}
+/**
+ * `{ value, precision }` for a Medusa raw column: `value` is plain decimal text, never an
+ * exponent (`1e21` gives `'1000000000000000000000'`). NaN and Infinity throw `amount_invalid`.
+ */
+declare function toMedusaRaw(value: Money | DecimalText | number | bigint, precision?: number): MedusaRaw;
+/** A Money for a Medusa amount input: `'0'` for zero (Medusa drops numeric 0 on order-edit updates), else the number. */
+declare function toMedusaAmountInput(m: Money): number | string;
+/** A per-currency setting: upper-case currency code to stored amount. Build one with `moneyByCurrency`. */
+type MoneyByCurrency = {
+  readonly [code: string]: StoredAmount;
+};
+/**
+ * Validates an object of `code -> stored amount` (keys through `currencyCode`, values
+ * non-negative safe integers), upper-cases the keys and freezes it. A key given twice in
+ * different cases throws `currency_invalid`.
+ */
+declare function moneyByCurrency(input: unknown): MoneyByCurrency;
+/** A Medusa price row, or anything shaped like one. */
+interface PriceLike {
+  readonly amount: unknown;
+  readonly currency_code: string;
+  readonly price_list_id?: string | null;
+}
+/**
+ * The amount for `currency` from a MoneyByCurrency or a Medusa price list (base prices only:
+ * rows with a `price_list_id` are skipped). Exact currency match, any case; the amount is read
+ * strictly. Null when there is none.
+ */
+declare function moneyFor(source: MoneyByCurrency | readonly PriceLike[], currency: string): Money | null;
+/** 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 };