@ducatjs/money 0.0.0-stage → 0.1.0

package/src/generated/cash.ts

@@ -0,0 +1,375 @@
+// GENERATED by scripts/gen-currencies.mjs from data/cash-rounding.json. Do not edit by hand.
+/* eslint-disable */
+
+export interface CashRule {
+  readonly currency: string;
+  /** Smallest cash step, in ISO minor units. */
+  readonly increment: number;
+  readonly countries: readonly string[];
+  readonly scope: string;
+  /** false: only secondary sources were found. */
+  readonly verified: boolean;
+  readonly source: string;
+}
+
+export const CASH_RULES: readonly CashRule[] = [
+  {
+    "currency": "CHF",
+    "increment": 5,
+    "countries": [
+      "CH",
+      "LI"
+    ],
+    "scope": "cash (practice; card/electronic to 0.01)",
+    "verified": false,
+    "source": "https://www.snb.ch/en/the-snb/mandates-goals/cash/coins"
+  },
+  {
+    "currency": "SEK",
+    "increment": 100,
+    "countries": [
+      "SE"
+    ],
+    "scope": "cash only",
+    "verified": true,
+    "source": "https://archive.riksbank.se/en/Web-archive/Published/Notices/2009/50-ore-coin-to-be-abolished-in-2010/index.html"
+  },
+  {
+    "currency": "DKK",
+    "increment": 50,
+    "countries": [
+      "DK",
+      "GL",
+      "FO"
+    ],
+    "scope": "cash only",
+    "verified": false,
+    "source": "https://lex.dk/afrunding"
+  },
+  {
+    "currency": "NOK",
+    "increment": 100,
+    "countries": [
+      "NO",
+      "SJ",
+      "BV"
+    ],
+    "scope": "cash only",
+    "verified": true,
+    "source": "https://www.norges-bank.no/en/news-events/news/Circulars/2011/Regulation-relating-to-withdrawal-of-50-ore-coins-as-legal-tender/"
+  },
+  {
+    "currency": "CAD",
+    "increment": 5,
+    "countries": [
+      "CA"
+    ],
+    "scope": "cash only",
+    "verified": true,
+    "source": "https://www.canada.ca/en/revenue-agency/services/forms-publications/publications/gi-131/phasing-penny.html"
+  },
+  {
+    "currency": "AUD",
+    "increment": 5,
+    "countries": [
+      "AU",
+      "CX",
+      "CC",
+      "NF",
+      "NR",
+      "KI",
+      "TV",
+      "HM"
+    ],
+    "scope": "cash only",
+    "verified": false,
+    "source": "https://en.wikipedia.org/wiki/Cash_rounding"
+  },
+  {
+    "currency": "NZD",
+    "increment": 10,
+    "countries": [
+      "NZ",
+      "CK",
+      "NU",
+      "PN",
+      "TK"
+    ],
+    "scope": "cash only",
+    "verified": false,
+    "source": "https://en.wikipedia.org/wiki/Cash_rounding"
+  },
+  {
+    "currency": "EUR",
+    "increment": 5,
+    "countries": [
+      "BE"
+    ],
+    "scope": "cash only (mandatory for in-person cash; optional for other methods; not allowed for distance sales)",
+    "verified": true,
+    "source": "https://economie.fgov.be/en/themes/sales/mandatory-rounding-cash"
+  },
+  {
+    "currency": "EUR",
+    "increment": 5,
+    "countries": [
+      "NL"
+    ],
+    "scope": "cash only (permitted, must be signposted)",
+    "verified": true,
+    "source": "https://www.rijksoverheid.nl/documenten/vraag-en-antwoord/betalingsverkeer/mogen-winkeliers-betalingen-afronden-op-0-eurocent-of-5-eurocent"
+  },
+  {
+    "currency": "EUR",
+    "increment": 5,
+    "countries": [
+      "FI"
+    ],
+    "scope": "cash only (statutory)",
+    "verified": false,
+    "source": "https://www.finlex.fi/fi/lainsaadanto/2000/890"
+  },
+  {
+    "currency": "EUR",
+    "increment": 5,
+    "countries": [
+      "IE"
+    ],
+    "scope": "cash only (voluntary)",
+    "verified": false,
+    "source": "https://www.irishtimes.com/news/ireland/irish-news/coin-rounding-begins-as-use-of-1-cent-2-cent-coins-reduced-1.2408459"
+  },
+  {
+    "currency": "EUR",
+    "increment": 5,
+    "countries": [
+      "IT"
+    ],
+    "scope": "cash only (voluntary practice)",
+    "verified": false,
+    "source": "https://en.wikipedia.org/wiki/Cash_rounding"
+  },
+  {
+    "currency": "EUR",
+    "increment": 5,
+    "countries": [
+      "SK"
+    ],
+    "scope": "cash only",
+    "verified": false,
+    "source": "https://en.wikipedia.org/wiki/Cash_rounding"
+  },
+  {
+    "currency": "EUR",
+    "increment": 5,
+    "countries": [
+      "EE"
+    ],
+    "scope": "cash only, at physical point of sale",
+    "verified": true,
+    "source": "https://www.eestipank.ee/en/press/rounding-rule-will-start-apply-payments-cash-new-year-27122024"
+  },
+  {
+    "currency": "EUR",
+    "increment": 5,
+    "countries": [
+      "LT"
+    ],
+    "scope": "cash only",
+    "verified": false,
+    "source": "https://www.baltictimes.com/lithuania_starts_rounding_off_cash_payments_to_phase_out_1__2_cent_coins"
+  },
+  {
+    "currency": "HUF",
+    "increment": 500,
+    "countries": [
+      "HU"
+    ],
+    "scope": "cash only (statutory)",
+    "verified": true,
+    "source": "https://njt.jog.gov.hu/jogszabaly/2008-3-00-00"
+  },
+  {
+    "currency": "CZK",
+    "increment": 100,
+    "countries": [
+      "CZ"
+    ],
+    "scope": "cash only",
+    "verified": true,
+    "source": "https://www.cnb.cz/en/faq/How-to-round-after-the-withdrawal-of-50-heller-coins"
+  },
+  {
+    "currency": "ILS",
+    "increment": 10,
+    "countries": [
+      "IL",
+      "PS"
+    ],
+    "scope": "cash only",
+    "verified": false,
+    "source": "https://boi.org.il/en/communication-and-publications/press-releases/the-bank-of-israel-asks-the-government-to-approve-abolishing-the-5-agorot-coin-as-legal-tender/"
+  },
+  {
+    "currency": "MYR",
+    "increment": 5,
+    "countries": [
+      "MY"
+    ],
+    "scope": "over-the-counter payments (originally cash and non-cash per 2007 announcement; current practice cash only)",
+    "verified": false,
+    "source": "https://www.bnm.gov.my/-/introduction-of-a-rounding-mechanism-for-over-the-counter-payments"
+  },
+  {
+    "currency": "SGD",
+    "increment": 5,
+    "countries": [
+      "SG"
+    ],
+    "scope": "cash (informal practice; always rounded down per Wikipedia)",
+    "verified": false,
+    "source": "https://en.wikipedia.org/wiki/Cash_rounding"
+  },
+  {
+    "currency": "RON",
+    "increment": 5,
+    "countries": [
+      "RO"
+    ],
+    "scope": "cash (practice)",
+    "verified": false,
+    "source": "https://en.wikipedia.org/wiki/Cash_rounding"
+  },
+  {
+    "currency": "XPF",
+    "increment": 5,
+    "countries": [
+      "PF",
+      "NC",
+      "WF"
+    ],
+    "scope": "cash only",
+    "verified": false,
+    "source": "https://www.ieom.fr/nouvelles-pieces/"
+  },
+  {
+    "currency": "BSD",
+    "increment": 5,
+    "countries": [
+      "BS"
+    ],
+    "scope": "cash",
+    "verified": false,
+    "source": "https://www.centralbankbahamas.com/download/075913500.pdf"
+  },
+  {
+    "currency": "TTD",
+    "increment": 5,
+    "countries": [
+      "TT"
+    ],
+    "scope": "cash",
+    "verified": false,
+    "source": "https://en.wikipedia.org/wiki/Cash_rounding"
+  },
+  {
+    "currency": "ZAR",
+    "increment": 10,
+    "countries": [
+      "ZA"
+    ],
+    "scope": "cash (practice)",
+    "verified": false,
+    "source": "https://en.wikipedia.org/wiki/Cash_rounding"
+  },
+  {
+    "currency": "HKD",
+    "increment": 10,
+    "countries": [
+      "HK"
+    ],
+    "scope": "cash (practice)",
+    "verified": false,
+    "source": "https://en.wikipedia.org/wiki/Cash_rounding"
+  },
+  {
+    "currency": "UAH",
+    "increment": 10,
+    "countries": [
+      "UA"
+    ],
+    "scope": "cash",
+    "verified": false,
+    "source": "https://www.bank.gov.ua/news/all/natsionalniy-bank-uporyadkovuye-nominalniy-ryad-banknot-i-monet-grivni"
+  },
+  {
+    "currency": "CLP",
+    "increment": 10,
+    "countries": [
+      "CL"
+    ],
+    "scope": "cash only",
+    "verified": false,
+    "source": "https://www.dgac.gob.cl/monedas-de-1-y-5-pesos-pasaran-a-la-historia-ley-n-20-956-ministerio-de-hacienda/"
+  },
+  {
+    "currency": "PEN",
+    "increment": 10,
+    "countries": [
+      "PE"
+    ],
+    "scope": "cash (practice)",
+    "verified": false,
+    "source": "https://en.wikipedia.org/wiki/Cash_rounding"
+  },
+  {
+    "currency": "THB",
+    "increment": 25,
+    "countries": [
+      "TH"
+    ],
+    "scope": "cash (practice)",
+    "verified": false,
+    "source": "https://en.wikipedia.org/wiki/Cash_rounding"
+  },
+  {
+    "currency": "AED",
+    "increment": 25,
+    "countries": [
+      "AE"
+    ],
+    "scope": "cash (practice)",
+    "verified": false,
+    "source": "https://en.wikipedia.org/wiki/Cash_rounding"
+  },
+  {
+    "currency": "INR",
+    "increment": 100,
+    "countries": [
+      "IN"
+    ],
+    "scope": "cash (practice)",
+    "verified": false,
+    "source": "https://en.wikipedia.org/wiki/Cash_rounding"
+  },
+  {
+    "currency": "JMD",
+    "increment": 100,
+    "countries": [
+      "JM"
+    ],
+    "scope": "cash",
+    "verified": false,
+    "source": "https://jis.gov.jm/information/get-the-facts/demonetisation-of-coins/"
+  },
+  {
+    "currency": "USD",
+    "increment": 5,
+    "countries": [
+      "US"
+    ],
+    "scope": "cash (permitted, not required; varies by state)",
+    "verified": false,
+    "source": "https://en.wikipedia.org/wiki/Cash_rounding"
+  }
+];

package/src/generated/checkout.ts

@@ -0,0 +1,151 @@
+// GENERATED by scripts/gen-currencies.mjs from data/checkout.json (https://www.checkout.com/docs/payments/accept-payments/format-the-amount-value, retrieved 2026-11-07). Do not edit by hand.
+/* eslint-disable */
+
+/** Checkout.com currencies: [API exponent, payment amount multiple, Standalone API (authentication) multiple]. CLP is two-decimal with a multiple of 100; three-decimal currencies need a multiple of 10. */
+export const CHECKOUT_RULES: Readonly<Record<string, readonly [exponent: number, multiple: number, standaloneMultiple: number]>> = {
+  AED: [2,1,1],
+  AFN: [2,1,1],
+  ALL: [2,1,1],
+  AMD: [2,1,1],
+  AOA: [2,1,1],
+  AUD: [2,1,1],
+  AWG: [2,1,1],
+  AZN: [2,1,1],
+  BAM: [2,1,1],
+  BBD: [2,1,1],
+  BDT: [2,1,1],
+  BHD: [3,10,10],
+  BIF: [0,1,1],
+  BMD: [2,1,1],
+  BND: [2,1,1],
+  BOB: [2,1,1],
+  BRL: [2,1,1],
+  BSD: [2,1,1],
+  BTN: [2,1,1],
+  BWP: [2,1,1],
+  BZD: [2,1,1],
+  CAD: [2,1,1],
+  CDF: [2,1,1],
+  CHF: [2,1,1],
+  CLP: [2,100,1],
+  CNY: [2,1,1],
+  COP: [2,1,1],
+  CRC: [2,1,1],
+  CUP: [2,1,1],
+  CVE: [2,1,1],
+  CZK: [2,1,1],
+  DJF: [0,1,1],
+  DKK: [2,1,1],
+  DOP: [2,1,1],
+  DZD: [2,1,1],
+  EGP: [2,1,1],
+  ERN: [2,1,1],
+  ETB: [2,1,1],
+  EUR: [2,1,1],
+  FJD: [2,1,1],
+  FKP: [2,1,1],
+  GBP: [2,1,1],
+  GEL: [2,1,1],
+  GIP: [2,1,1],
+  GNF: [0,1,1],
+  GTQ: [2,1,1],
+  GYD: [2,1,1],
+  HKD: [2,1,1],
+  HNL: [2,1,1],
+  HTG: [2,1,1],
+  HUF: [2,1,1],
+  IDR: [2,1,1],
+  ILS: [2,1,1],
+  INR: [2,1,1],
+  IQD: [3,10,10],
+  IRR: [2,1,1],
+  ISK: [0,1,1],
+  JMD: [2,1,1],
+  JOD: [3,10,10],
+  JPY: [0,1,1],
+  KES: [2,1,1],
+  KGS: [2,1,1],
+  KHR: [2,1,1],
+  KMF: [0,1,1],
+  KRW: [0,1,1],
+  KWD: [3,10,10],
+  KYD: [2,1,1],
+  KZT: [2,1,1],
+  LAK: [2,1,1],
+  LKR: [2,1,1],
+  LRD: [2,1,1],
+  LSL: [2,1,1],
+  LYD: [3,10,10],
+  MAD: [2,1,1],
+  MDL: [2,1,1],
+  MGA: [2,1,1],
+  MKD: [2,1,1],
+  MMK: [2,1,1],
+  MNT: [2,1,1],
+  MOP: [2,1,1],
+  MRU: [2,1,1],
+  MUR: [2,1,1],
+  MVR: [2,1,1],
+  MWK: [2,1,1],
+  MXN: [2,1,1],
+  MYR: [2,1,1],
+  MZN: [2,1,1],
+  NAD: [2,1,1],
+  NGN: [2,1,1],
+  NIO: [2,1,1],
+  NOK: [2,1,1],
+  NPR: [2,1,1],
+  NZD: [2,1,1],
+  OMR: [3,10,10],
+  PAB: [2,1,1],
+  PEN: [2,1,1],
+  PGK: [2,1,1],
+  PHP: [2,1,1],
+  PKR: [2,1,1],
+  PLN: [2,1,1],
+  PYG: [0,1,1],
+  QAR: [2,1,1],
+  RON: [2,1,1],
+  RSD: [2,1,1],
+  RWF: [0,1,1],
+  SAR: [2,1,1],
+  SBD: [2,1,1],
+  SCR: [2,1,1],
+  SEK: [2,1,1],
+  SGD: [2,1,1],
+  SHP: [2,1,1],
+  SLE: [2,1,1],
+  SLL: [2,1,1],
+  SOS: [2,1,1],
+  SRD: [2,1,1],
+  STN: [2,1,1],
+  SVC: [2,1,1],
+  SZL: [2,1,1],
+  THB: [2,1,1],
+  TJS: [2,1,1],
+  TMT: [2,1,1],
+  TND: [3,10,10],
+  TOP: [2,1,1],
+  TRY: [2,1,1],
+  TTD: [2,1,1],
+  TWD: [2,1,1],
+  TZS: [2,1,1],
+  UAH: [2,1,1],
+  UGX: [0,1,1],
+  USD: [2,1,1],
+  UYU: [2,1,1],
+  UZS: [2,1,1],
+  VES: [2,1,1],
+  VND: [0,1,1],
+  VUV: [0,1,1],
+  WST: [2,1,1],
+  XAF: [0,1,1],
+  XCD: [2,1,1],
+  XCG: [2,1,1],
+  XDR: [2,1,1],
+  XOF: [0,1,1],
+  XPF: [0,1,1],
+  YER: [2,1,1],
+  ZAR: [2,1,1],
+  ZMW: [2,1,1],
+};

package/src/generated/iso4217.ts

@@ -0,0 +1,179 @@
+// GENERATED by scripts/gen-currencies.mjs from data/iso4217-list-one.xml. Do not edit by hand.
+/* eslint-disable */
+
+/** Publication date of the ISO 4217 List One snapshot the table was generated from. */
+export const ISO_4217_PUBLISHED = "2026-09-17";
+
+/** ISO 4217 minor-unit exponent for every active code that has one (165 codes). */
+export const ISO_EXPONENTS = {
+  AED: 2,
+  AFN: 2,
+  ALL: 2,
+  AMD: 2,
+  AOA: 2,
+  ARS: 2,
+  AUD: 2,
+  AWG: 2,
+  AZN: 2,
+  BAM: 2,
+  BBD: 2,
+  BDT: 2,
+  BHD: 3,
+  BIF: 0,
+  BMD: 2,
+  BND: 2,
+  BOB: 2,
+  BOV: 2,
+  BRL: 2,
+  BSD: 2,
+  BTN: 2,
+  BWP: 2,
+  BYN: 2,
+  BZD: 2,
+  CAD: 2,
+  CDF: 2,
+  CHE: 2,
+  CHF: 2,
+  CHW: 2,
+  CLF: 4,
+  CLP: 0,
+  CNY: 2,
+  COP: 2,
+  COU: 2,
+  CRC: 2,
+  CUP: 2,
+  CVE: 2,
+  CZK: 2,
+  DJF: 0,
+  DKK: 2,
+  DOP: 2,
+  DZD: 2,
+  EGP: 2,
+  ERN: 2,
+  ETB: 2,
+  EUR: 2,
+  FJD: 2,
+  FKP: 2,
+  GBP: 2,
+  GEL: 2,
+  GHS: 2,
+  GIP: 2,
+  GMD: 2,
+  GNF: 0,
+  GTQ: 2,
+  GYD: 2,
+  HKD: 2,
+  HNL: 2,
+  HTG: 2,
+  HUF: 2,
+  IDR: 2,
+  ILS: 2,
+  INR: 2,
+  IQD: 3,
+  IRR: 2,
+  ISK: 0,
+  JMD: 2,
+  JOD: 3,
+  JPY: 0,
+  KES: 2,
+  KGS: 2,
+  KHR: 2,
+  KMF: 0,
+  KPW: 2,
+  KRW: 0,
+  KWD: 3,
+  KYD: 2,
+  KZT: 2,
+  LAK: 2,
+  LBP: 2,
+  LKR: 2,
+  LRD: 2,
+  LSL: 2,
+  LYD: 3,
+  MAD: 2,
+  MDL: 2,
+  MGA: 2,
+  MKD: 2,
+  MMK: 2,
+  MNT: 2,
+  MOP: 2,
+  MRU: 2,
+  MUR: 2,
+  MVR: 2,
+  MWK: 2,
+  MXN: 2,
+  MXV: 2,
+  MYR: 2,
+  MZN: 2,
+  NAD: 2,
+  NGN: 2,
+  NIO: 2,
+  NOK: 2,
+  NPR: 2,
+  NZD: 2,
+  OMR: 3,
+  PAB: 2,
+  PEN: 2,
+  PGK: 2,
+  PHP: 2,
+  PKR: 2,
+  PLN: 2,
+  PYG: 0,
+  QAR: 2,
+  RON: 2,
+  RSD: 2,
+  RUB: 2,
+  RWF: 0,
+  SAR: 2,
+  SBD: 2,
+  SCR: 2,
+  SDG: 2,
+  SEK: 2,
+  SGD: 2,
+  SHP: 2,
+  SLE: 2,
+  SOS: 2,
+  SRD: 2,
+  SSP: 2,
+  STN: 2,
+  SVC: 2,
+  SYP: 2,
+  SZL: 2,
+  THB: 2,
+  TJS: 2,
+  TMT: 2,
+  TND: 3,
+  TOP: 2,
+  TRY: 2,
+  TTD: 2,
+  TWD: 2,
+  TZS: 2,
+  UAH: 2,
+  UGX: 0,
+  USD: 2,
+  USN: 2,
+  UYI: 0,
+  UYU: 2,
+  UYW: 4,
+  UZS: 2,
+  VED: 2,
+  VES: 2,
+  VND: 0,
+  VUV: 0,
+  WST: 2,
+  XAD: 2,
+  XAF: 0,
+  XCD: 2,
+  XCG: 2,
+  XOF: 0,
+  XPF: 0,
+  YER: 2,
+  ZAR: 2,
+  ZMW: 2,
+  ZWG: 2,
+} as const;
+
+export type IsoCurrencyCode = keyof typeof ISO_EXPONENTS;
+
+/** Active codes whose minor unit is "N.A." (precious metals, SDR, testing): not monetary, not in ISO_EXPONENTS. */
+export const ISO_NON_MONETARY = ["XAG","XAU","XBA","XBB","XBC","XBD","XDR","XPD","XPT","XSU","XTS","XUA","XXX"] as const;