@arki/money 0.0.0-stage → 0.0.4

package/dist/stripe.js

@@ -0,0 +1,75 @@
+/**
+ * Stripe amounts. Stripe sends integers in its own units, which differ from
+ * ISO 4217 for some currencies. Rules from docs.stripe.com/currencies, read
+ * on 2026-10-12:
+ *
+ * - Zero-decimal: BIF CLP DJF GNF JPY KMF KRW MGA PYG RWF VND VUV XAF XOF XPF
+ *   (`500` is 500 JPY). MGA has 2 decimals in ISO but 0 at Stripe.
+ * - ISK and UGX: sent with two decimals that are always `00` (`500` is 5 ISK).
+ * - HUF and TWD: two-decimal charges; payouts must be divisible by 100.
+ * - Other currencies with 2 ISO decimals: two decimals.
+ *
+ * Stripe documents no rule for currencies with 3 or 4 ISO decimals, so those
+ * throw `ProviderAmountError` instead of being guessed. Whether your account
+ * can charge a currency, and its minimum and maximum amounts, are Stripe's to
+ * enforce; this module only gets the units right.
+ */
+import { toCurrency } from './currency.js';
+import { ProviderAmountError } from './errors.js';
+import { fromProviderUnits, toProviderUnits } from './provider.js';
+/** When Stripe's rules in this module were last checked. */
+export const STRIPE_RULES_VERSION = '2026-10-12';
+const ZERO_DECIMAL = new Set([
+    'BIF',
+    'CLP',
+    'DJF',
+    'GNF',
+    'JPY',
+    'KMF',
+    'KRW',
+    'MGA',
+    'PYG',
+    'RWF',
+    'VND',
+    'VUV',
+    'XAF',
+    'XOF',
+    'XPF',
+]);
+const WHOLE_UNITS_TWO_DECIMALS = new Set(['ISK', 'UGX']);
+const WHOLE_UNIT_PAYOUTS = new Set(['HUF', 'TWD']);
+/** Stripe's unit rule for a currency and operation. Throws `ProviderAmountError` where Stripe documents none. */
+export function stripeRule(currency, operation = 'charge') {
+    const target = toCurrency(currency);
+    const code = target.code;
+    if (!target.iso)
+        throw new ProviderAmountError(`${code} is a custom currency; Stripe has no rule for it`);
+    if (ZERO_DECIMAL.has(code))
+        return { scale: 0 };
+    if (WHOLE_UNITS_TWO_DECIMALS.has(code))
+        return { scale: 2, step: 100 };
+    if (WHOLE_UNIT_PAYOUTS.has(code))
+        return operation === 'payout' ? { scale: 2, step: 100 } : { scale: 2 };
+    if (target.scale === 2)
+        return { scale: 2 };
+    throw new ProviderAmountError(`Stripe documents no amount rule for ${code} (${target.scale} decimals in ISO 4217)`);
+}
+/**
+ * `toStripeAmount(money('10.99', 'USD'))` → `1099`; `money(5, 'ISK')` → `500`.
+ * Throws `ProviderAmountError` for a negative amount or one Stripe cannot express (`10.50 MGA`).
+ */
+export function toStripeAmount(amount, operation = 'charge') {
+    if (amount.isNegative())
+        throw new ProviderAmountError('Stripe amounts are never negative');
+    return toProviderUnits(amount, stripeRule(amount.currency, operation));
+}
+/** `fromStripeAmount(1099, 'usd')` → `10.99 USD`. Accepts Stripe's lower-case codes. */
+export function fromStripeAmount(amount, currency, operation = 'charge') {
+    const target = typeof currency === 'string' ? toCurrency(currency.toUpperCase()) : currency;
+    return fromProviderUnits(amount, target, stripeRule(target, operation));
+}
+/** The `{ amount, currency }` pair a Stripe request takes: `{ amount: 1099, currency: 'usd' }`. */
+export function toStripe(amount, operation = 'charge') {
+    return { amount: toStripeAmount(amount, operation), currency: amount.currency.code.toLowerCase() };
+}
+//# sourceMappingURL=stripe.js.map

package/dist/stripe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.js","sourceRoot":"","sources":["../src/stripe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEnE,4DAA4D;AAC5D,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAIjD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;CACN,CAAC,CAAC;AACH,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AACzD,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAEnD,iHAAiH;AACjH,MAAM,UAAU,UAAU,CAAC,QAAsB,EAAE,SAAS,GAAoB,QAAQ;IACtF,MAAM,MAAM,GAAa,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,IAAI,CAAC,MAAM,CAAC,GAAG;QAAE,MAAM,IAAI,mBAAmB,CAAC,GAAG,IAAI,kDAAkD,CAAC,CAAC;IAC1G,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAChD,IAAI,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACvE,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACzG,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC5C,MAAM,IAAI,mBAAmB,CAAC,uCAAuC,IAAI,KAAK,MAAM,CAAC,KAAK,wBAAwB,CAAC,CAAC;AACtH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAa,EAAE,SAAS,GAAoB,QAAQ;IACjF,IAAI,MAAM,CAAC,UAAU,EAAE;QAAE,MAAM,IAAI,mBAAmB,CAAC,mCAAmC,CAAC,CAAC;IAC5F,OAAO,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,gBAAgB,CAC9B,MAAgC,EAChC,QAA2B,EAC3B,SAAS,GAAoB,QAAQ;IAErC,MAAM,MAAM,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC5F,OAAO,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,QAAQ,CAAC,MAAa,EAAE,SAAS,GAAoB,QAAQ;IAC3E,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;AACrG,CAAC"}

package/dist/zod.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Zod 4 schemas that turn input into `Money`. Optional: needs `zod` installed.
+ *
+ * ```ts
+ * const order = z.object({ total: moneySchema('EUR', { min: money(0, 'EUR') }) });
+ * order.parse({ total: { amount: '19.99', currency: 'EUR' } }).total; // Money<'EUR'>
+ * ```
+ *
+ * The input type is the JSON shape `{ amount: string; currency: string }`, so
+ * RPC clients (tRPC, oRPC) infer what to send; the output type is `Money`.
+ */
+import { z } from 'zod';
+import type { CurrencyLike } from './currency.js';
+import type { Money, MoneyOptions } from './money.js';
+import type { ParseOptions } from './parse.js';
+import { Currency } from './currency.js';
+export type MoneySchemaOptions<C extends string> = {
+    /** Inclusive bounds. */
+    min?: Money<C>;
+    max?: Money<C>;
+    /** Extra digits are rounded with this mode instead of rejected. */
+    rounding?: MoneyOptions['rounding'];
+};
+export type AnyMoneySchemaOptions = MoneySchemaOptions<string> & {
+    /** Custom currencies to resolve by code. */
+    currencies?: readonly Currency[];
+};
+/**
+ * `{ amount: '19.99', currency: 'EUR' }` → `Money<'EUR'>`. Another currency,
+ * a bad amount or a value out of bounds becomes a Zod issue.
+ */
+export declare function moneySchema<const C extends string>(currency: CurrencyLike<C>, options?: MoneySchemaOptions<C>): z.ZodPipe<z.ZodObject<{
+    amount: z.ZodString;
+    currency: z.ZodString;
+}, z.core.$strip>, z.ZodTransform<Money<C>, {
+    amount: string;
+    currency: string;
+}>>;
+/** `{ amount, currency }` in any ISO (or listed custom) currency → `Money`. */
+export declare function anyMoneySchema(options?: AnyMoneySchemaOptions): z.ZodPipe<z.ZodObject<{
+    amount: z.ZodString;
+    currency: z.ZodString;
+}, z.core.$strip>, z.ZodTransform<Money<string>, {
+    amount: string;
+    currency: string;
+}>>;
+/**
+ * A form field: locale text such as `'1.234,56 €'` → `Money<C>`, with the
+ * strict rules of `@arki/money/parse`.
+ */
+export declare function moneyInputSchema<const C extends string>(currency: CurrencyLike<C>, options?: ParseOptions & Pick<MoneySchemaOptions<C>, 'min' | 'max'>): z.ZodPipe<z.ZodString, z.ZodTransform<Money<C>, string>>;
+/** An ISO 4217 code from the shipped table, such as `'EUR'`. */
+export declare const currencyCodeSchema: z.ZodString;
+//# 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;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAA+B,MAAM,eAAe,CAAC;AAKtE,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,IAAI;IACjD,wBAAwB;IACxB,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACf,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACf,mEAAmE;IACnE,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,CAAC,MAAM,CAAC,GAAG;IAC/D,4CAA4C;IAC5C,UAAU,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;CAClC,CAAC;AAkCF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,kBAAkB,CAAC,CAAC,CAAM;;;;;;IASjH;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B;;;;;;IAYjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EACrD,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EACzB,OAAO,GAAE,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAAM,4DAcxE;AAED,gEAAgE;AAChE,eAAO,MAAM,kBAAkB,aAEyD,CAAC"}

package/dist/zod.js

@@ -0,0 +1,96 @@
+/**
+ * Zod 4 schemas that turn input into `Money`. Optional: needs `zod` installed.
+ *
+ * ```ts
+ * const order = z.object({ total: moneySchema('EUR', { min: money(0, 'EUR') }) });
+ * order.parse({ total: { amount: '19.99', currency: 'EUR' } }).total; // Money<'EUR'>
+ * ```
+ *
+ * The input type is the JSON shape `{ amount: string; currency: string }`, so
+ * RPC clients (tRPC, oRPC) infer what to send; the output type is `Money`.
+ */
+import { z } from 'zod';
+import { Currency, resolveCurrency, toCurrency } from './currency.js';
+import { MathError } from './errors.js';
+import { Money as MoneyClass } from './money.js';
+import { createMoneyParser } from './parse.js';
+function message(error) {
+    return error instanceof Error ? error.message : 'Invalid money';
+}
+function checkBounds(value, options, ctx) {
+    if (options.min !== undefined && value.lt(options.min)) {
+        ctx.addIssue({ code: 'custom', message: `Must be at least ${options.min.toString()}` });
+    }
+    if (options.max !== undefined && value.gt(options.max)) {
+        ctx.addIssue({ code: 'custom', message: `Must be at most ${options.max.toString()}` });
+    }
+}
+const moneyJsonShape = z.object({ amount: z.string(), currency: z.string() });
+function settle(amount, currency, options, ctx) {
+    try {
+        const value = MoneyClass.of(amount, currency, { rounding: options.rounding });
+        checkBounds(value, options, ctx);
+        return value;
+    }
+    catch (error) {
+        if (!(error instanceof MathError))
+            throw error;
+        ctx.addIssue({ code: 'custom', message: message(error), path: ['amount'] });
+        return z.NEVER;
+    }
+}
+/**
+ * `{ amount: '19.99', currency: 'EUR' }` → `Money<'EUR'>`. Another currency,
+ * a bad amount or a value out of bounds becomes a Zod issue.
+ */
+export function moneySchema(currency, options = {}) {
+    const expected = toCurrency(currency);
+    return moneyJsonShape.transform((input, ctx) => {
+        if (input.currency !== expected.code) {
+            ctx.addIssue({ code: 'custom', message: `Expected ${expected.code}, got ${input.currency}`, path: ['currency'] });
+            return z.NEVER;
+        }
+        return settle(input.amount, expected, options, ctx);
+    });
+}
+/** `{ amount, currency }` in any ISO (or listed custom) currency → `Money`. */
+export function anyMoneySchema(options = {}) {
+    return moneyJsonShape.transform((input, ctx) => {
+        let currency;
+        try {
+            currency = resolveCurrency(input.currency, options.currencies);
+        }
+        catch (error) {
+            if (!(error instanceof MathError))
+                throw error;
+            ctx.addIssue({ code: 'custom', message: message(error), path: ['currency'] });
+            return z.NEVER;
+        }
+        return settle(input.amount, currency, options, ctx);
+    });
+}
+/**
+ * A form field: locale text such as `'1.234,56 €'` → `Money<C>`, with the
+ * strict rules of `@arki/money/parse`.
+ */
+export function moneyInputSchema(currency, options = {}) {
+    const parser = createMoneyParser(currency, options);
+    return z.string().transform((text, ctx) => {
+        try {
+            const value = parser.parse(text);
+            checkBounds(value, options, ctx);
+            return value;
+        }
+        catch (error) {
+            if (!(error instanceof MathError))
+                throw error;
+            ctx.addIssue({ code: 'custom', message: message(error) });
+            return z.NEVER;
+        }
+    });
+}
+/** An ISO 4217 code from the shipped table, such as `'EUR'`. */
+export const currencyCodeSchema = z
+    .string()
+    .refine(code => Currency.isKnown(code), { message: 'Unknown ISO 4217 currency code' });
+//# sourceMappingURL=zod.js.map

package/dist/zod.js.map

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

package/package.json

@@ -1,6 +1,139 @@
 {
   "name": "@arki/money",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.4",
+  "description": "Exact, fast money for every JavaScript runtime — amounts kept as whole units (plain numbers, bigint only when huge), a shipped ISO 4217 currency table, exact-or-throw rounding, fair allocation, and currencies checked by the type system.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/arki-labs/arki.git"
+  },
+  "homepage": "https://arki.dev",
+  "bugs": {
+    "url": "https://github.com/arki-labs/arki/issues"
+  },
+  "keywords": [
+    "arki",
+    "typescript",
+    "money",
+    "currency",
+    "iso4217",
+    "monetary",
+    "decimal",
+    "rounding",
+    "allocate",
+    "bigint",
+    "finance",
+    "price",
+    "exchange",
+    "stripe",
+    "parse"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./currency": {
+      "types": "./dist/currency.d.ts",
+      "import": "./dist/currency.js",
+      "default": "./dist/currency.js"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.js",
+      "default": "./dist/errors.js"
+    },
+    "./exact": {
+      "types": "./dist/exact.d.ts",
+      "import": "./dist/exact.js",
+      "default": "./dist/exact.js"
+    },
+    "./format": {
+      "types": "./dist/format.d.ts",
+      "import": "./dist/format.js",
+      "default": "./dist/format.js"
+    },
+    "./parse": {
+      "types": "./dist/parse.d.ts",
+      "import": "./dist/parse.js",
+      "default": "./dist/parse.js"
+    },
+    "./exchange": {
+      "types": "./dist/exchange.d.ts",
+      "import": "./dist/exchange.js",
+      "default": "./dist/exchange.js"
+    },
+    "./provider": {
+      "types": "./dist/provider.d.ts",
+      "import": "./dist/provider.js",
+      "default": "./dist/provider.js"
+    },
+    "./stripe": {
+      "types": "./dist/stripe.d.ts",
+      "import": "./dist/stripe.js",
+      "default": "./dist/stripe.js"
+    },
+    "./rational": {
+      "types": "./dist/rational.d.ts",
+      "import": "./dist/rational.js",
+      "default": "./dist/rational.js"
+    },
+    "./bag": {
+      "types": "./dist/bag.d.ts",
+      "import": "./dist/bag.js",
+      "default": "./dist/bag.js"
+    },
+    "./zod": {
+      "types": "./dist/zod.d.ts",
+      "import": "./dist/zod.js",
+      "default": "./dist/zod.js"
+    },
+    "./drizzle/pg": {
+      "types": "./dist/drizzle/pg.d.ts",
+      "import": "./dist/drizzle/pg.js",
+      "default": "./dist/drizzle/pg.js"
+    },
+    "./drizzle/mysql": {
+      "types": "./dist/drizzle/mysql.d.ts",
+      "import": "./dist/drizzle/mysql.js",
+      "default": "./dist/drizzle/mysql.js"
+    },
+    "./drizzle/sqlite": {
+      "types": "./dist/drizzle/sqlite.d.ts",
+      "import": "./dist/drizzle/sqlite.js",
+      "default": "./dist/drizzle/sqlite.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/**",
+    "src/**",
+    "!src/**/*.test.*",
+    "!src/**/*.spec.*",
+    "!src/**/__tests__/**",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "dependencies": {
+    "@arki/math": "0.0.5"
+  },
+  "peerDependencies": {
+    "drizzle-orm": ">=1.0.0-rc.4 <2",
+    "zod": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "drizzle-orm": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/bag.ts

@@ -0,0 +1,128 @@
+/**
+ * A wallet of several currencies: `10 EUR + 5 USD` stays two balances. It never
+ * pretends mixed amounts have one total until you convert it, and then it
+ * converts each balance exactly and rounds once.
+ *
+ * ```ts
+ * const cart = MoneyBag.of(money(10, 'EUR'), money(5, 'USD')).plus(money('2.50', 'EUR'));
+ * cart.get('EUR').toString();                                   // '25/2 EUR'
+ * cart.convert(fx, 'EUR', { rounding: 'halfEven' });            // one EUR total
+ * ```
+ */
+
+import { ratio } from '@arki/math/rational';
+
+import type { Currency, CurrencyLike } from './currency.js';
+import type { Converter } from './exchange.js';
+import type { MoneyJSON, MoneyOptions } from './money.js';
+import type { ExactMoney } from './rational.js';
+import { assertSameCurrency, toCurrency } from './currency.js';
+import { Money } from './money.js';
+import { RationalMoney } from './rational.js';
+
+const BRAND = Symbol('MoneyBag');
+
+function exact(value: ExactMoney): RationalMoney {
+  return value instanceof RationalMoney ? value : RationalMoney.from(value);
+}
+
+/** An immutable set of balances, at most one per currency. Zero balances are dropped. */
+export class MoneyBag {
+  private readonly balances: ReadonlyMap<string, RationalMoney>;
+
+  private constructor(balances: ReadonlyMap<string, RationalMoney>, brand: typeof BRAND) {
+    if (brand !== BRAND) throw new TypeError('Use MoneyBag.of() instead of new MoneyBag()');
+    this.balances = balances;
+  }
+
+  static empty(): MoneyBag {
+    return new MoneyBag(new Map(), BRAND);
+  }
+
+  /** `MoneyBag.of(money(10, 'EUR'), money(5, 'USD'))`. */
+  static of(...items: (ExactMoney | MoneyBag)[]): MoneyBag {
+    return MoneyBag.empty().plus(...items);
+  }
+
+  /** Adds amounts or whole bags. Returns a new bag. */
+  plus(...items: (ExactMoney | MoneyBag)[]): MoneyBag {
+    return this.combine(items, false);
+  }
+
+  /** Subtracts amounts or whole bags. Balances may go negative. Returns a new bag. */
+  minus(...items: (ExactMoney | MoneyBag)[]): MoneyBag {
+    return this.combine(items, true);
+  }
+
+  /** The exact balance in one currency; zero when the bag holds none. */
+  get<const C extends string>(currency: CurrencyLike<C>): RationalMoney<C> {
+    const target = toCurrency(currency);
+    const found = this.balances.get(target.code);
+    if (found === undefined) return RationalMoney.zero(target);
+    assertSameCurrency(found.currency, target);
+    return RationalMoney.create(found.amount, target);
+  }
+
+  /** The currencies with a non-zero balance, sorted by code. */
+  currencies(): Currency[] {
+    return this.entries().map(entry => entry.currency);
+  }
+
+  /** The non-zero balances, sorted by currency code. */
+  entries(): RationalMoney[] {
+    return [...this.balances.values()].sort((a, b) => (a.currency.code < b.currency.code ? -1 : 1));
+  }
+
+  /** `true` when every balance is zero. */
+  isZero(): boolean {
+    return this.balances.size === 0;
+  }
+
+  /**
+   * One total in `currency`: each balance is converted exactly, the results are
+   * added, and the sum is rounded once. Missing rates throw `ExchangeRateError`.
+   */
+  convert<const C extends string>(converter: Converter, currency: CurrencyLike<C>, options?: MoneyOptions): Money<C> {
+    const target = toCurrency(currency);
+    let total = ratio(0);
+    for (const balance of this.balances.values()) {
+      const rate = converter.rate(balance.currency, target);
+      total = total.plus(balance.amount.times(ratio(BigInt(rate.numerator), BigInt(rate.denominator))));
+    }
+    return Money.of(total, target, options);
+  }
+
+  /** `[{ amount: '25/2', currency: 'EUR' }, ...]`, sorted by currency code. */
+  toJSON(): MoneyJSON[] {
+    return this.entries().map(entry => entry.toJSON());
+  }
+
+  /** `'12.5 EUR + 5 USD'`-style text with exact fractions: `'25/2 EUR + 5 USD'`. Empty bag: `'0'`. */
+  toString(): string {
+    const entries = this.entries();
+    return entries.length === 0 ? '0' : entries.map(String).join(' + ');
+  }
+
+  [Symbol.for('nodejs.util.inspect.custom')](): string {
+    return `MoneyBag(${this.toString()})`;
+  }
+
+  [Symbol.for('Deno.customInspect')](): string {
+    return `MoneyBag(${this.toString()})`;
+  }
+
+  private combine(items: readonly (ExactMoney | MoneyBag)[], subtract: boolean): MoneyBag {
+    const next = new Map(this.balances);
+    const add = (value: RationalMoney): void => {
+      const code = value.currency.code;
+      const current = next.get(code);
+      const delta = subtract ? value.negated() : value;
+      next.set(code, current === undefined ? delta : current.plus(delta));
+    };
+    for (const item of items) {
+      if (item instanceof MoneyBag) for (const balance of item.balances.values()) add(balance);
+      else add(exact(item));
+    }
+    return new MoneyBag(new Map([...next].filter(([, balance]) => !balance.isZero())), BRAND);
+  }
+}