@ducatjs/money 0.0.0 → 0.1.0

package/assets/CREDITS.md

@@ -0,0 +1,12 @@
+# Logo credits
+
+The ducat logo (`logo.png`, `logo-64.png`, `favicon.ico`) is derived from a photograph of a gold ducat of
+Doge Francesco Foscari of Venice (1423–1457), on display in a museum:
+
+- **Photo:** Francesco Bini, via Wikimedia Commons:
+  [Repubblica di venezia, francesco foscari, ducato in oro, con cristo entro mandorla, 1423-1457.jpg](https://commons.wikimedia.org/wiki/File:Repubblica_di_venezia,_francesco_foscari,_ducato_in_oro,_con_cristo_entro_mandorla,_1423-1457.jpg)
+- **Licence:** [Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)](https://creativecommons.org/licenses/by-sa/4.0/)
+- **Changes:** cropped to the coin, given a circular transparent mask, resized, and colour-quantised.
+
+These image files are therefore licensed under **CC BY-SA 4.0**, not under the MIT licence that covers
+ducat's code. The coin itself, struck in the 15th century, is in the public domain.

package/data/adyen-fx.json

@@ -0,0 +1,19 @@
+{
+  "source": "https://docs.adyen.com/reporting/settlement-reconciliation/transaction-level/settlement-details-report",
+  "retrieved": "2026-11-07",
+  "columns": {
+    "Gross Currency": "The three-character ISO currency code for the transaction currency.",
+    "Net Currency": "The three-character ISO currency code for the settlement currency.",
+    "Exchange Rate": "The exchange rate used for converting the gross amount into the net amount. This will be 1 if you process and settle in the same currency.",
+    "Creation Date": "The timestamp indicating when the payment was created on the Adyen payments platform. Format: YYYY-MM-DD HH:MM:SS",
+    "TimeZone": "The time zone of the Creation Date.",
+    "DCC Markup (NC)": "The DCC markup (in Net Currency)."
+  },
+  "notes": [
+    "For externally settled payments the listed exchange rate is Adyen's reference exchange rate, not the actual rate applied by the external acquirer.",
+    "Checkout dccQuote (ForexQuote, https://github.com/Adyen/adyen-openapi json/CheckoutService-v71.json at e7986c7): buy, sell and interbank are Amount objects ({currency, value} in minor units) described only as 'The buy rate.', 'The sell rate.' and 'The interbank amount.'; basePoints is an int32 'The base points.'; validTill is a date-time. How they map to a rate is not documented, so no adapter is provided for them."
+  ],
+  "vectors": [
+    { "row": { "Gross Currency": "GBP", "Gross Credit (GC)": "5.00", "Exchange Rate": "1", "Net Currency": "GBP", "Net Credit (NC)": "4.88" } }
+  ]
+}

package/data/adyen.json

@@ -0,0 +1,171 @@
+{
+  "source": "https://docs.adyen.com/development-resources/currency-codes",
+  "retrieved": "2026-11-07",
+  "footnote": "For CLP, CVE, IDR, and ISK the ISO 4217 standard has a different number of decimals than shown in our currency codes table. When submitting amounts in minor units, the decimals in the table on this page are leading. For example, ISK has zero decimals in the ISO 4217 standard, but to submit an ISK amount to Adyen you have to use two decimals as shown in the table.",
+  "terminalApi": "With the exception of Terminal API, our APIs expect you to submit transaction amount values in minor units: the smallest unit of a currency, depending on the number of decimals.",
+  "notInAdyenTable": [
+    "AFN",
+    "BIF",
+    "BTN",
+    "CDF",
+    "ERN",
+    "IRR",
+    "KPW",
+    "LBP",
+    "LRD",
+    "LSL",
+    "MGA",
+    "SDG",
+    "SSP",
+    "SYP",
+    "TJS",
+    "TMT",
+    "VED",
+    "VES",
+    "ZWG"
+  ],
+  "notInIso": [
+    "CNH",
+    "VEF"
+  ],
+  "exponents": {
+    "AED": 2,
+    "ALL": 2,
+    "AMD": 2,
+    "AOA": 2,
+    "ARS": 2,
+    "AUD": 2,
+    "AWG": 2,
+    "AZN": 2,
+    "BAM": 2,
+    "BBD": 2,
+    "BDT": 2,
+    "BHD": 3,
+    "BMD": 2,
+    "BND": 2,
+    "BOB": 2,
+    "BRL": 2,
+    "BSD": 2,
+    "BWP": 2,
+    "BYN": 2,
+    "BZD": 2,
+    "CAD": 2,
+    "CHF": 2,
+    "CLP": 2,
+    "CNH": 2,
+    "CNY": 2,
+    "COP": 2,
+    "CRC": 2,
+    "CUP": 2,
+    "CVE": 0,
+    "CZK": 2,
+    "DJF": 0,
+    "DKK": 2,
+    "DOP": 2,
+    "DZD": 2,
+    "EGP": 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": 0,
+    "ILS": 2,
+    "INR": 2,
+    "IQD": 3,
+    "ISK": 2,
+    "JMD": 2,
+    "JOD": 3,
+    "JPY": 0,
+    "KES": 2,
+    "KGS": 2,
+    "KHR": 2,
+    "KMF": 0,
+    "KRW": 0,
+    "KWD": 3,
+    "KYD": 2,
+    "KZT": 2,
+    "LAK": 2,
+    "LKR": 2,
+    "LYD": 3,
+    "MAD": 2,
+    "MDL": 2,
+    "MKD": 2,
+    "MMK": 2,
+    "MNT": 2,
+    "MOP": 2,
+    "MRU": 2,
+    "MUR": 2,
+    "MVR": 2,
+    "MWK": 2,
+    "MXN": 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,
+    "SEK": 2,
+    "SGD": 2,
+    "SHP": 2,
+    "SLE": 2,
+    "SOS": 2,
+    "SRD": 2,
+    "STN": 2,
+    "SVC": 2,
+    "SZL": 2,
+    "THB": 2,
+    "TND": 3,
+    "TOP": 2,
+    "TRY": 2,
+    "TTD": 2,
+    "TWD": 2,
+    "TZS": 2,
+    "UAH": 2,
+    "UGX": 0,
+    "USD": 2,
+    "UYU": 2,
+    "UZS": 2,
+    "VEF": 2,
+    "VND": 0,
+    "VUV": 0,
+    "WST": 2,
+    "XAF": 0,
+    "XCD": 2,
+    "XCG": 2,
+    "XOF": 0,
+    "XPF": 0,
+    "YER": 2,
+    "ZAR": 2,
+    "ZMW": 2
+  }
+}

package/data/braintree.json

@@ -0,0 +1,223 @@
+{
+  "processor": "Braintree",
+  "retrieved": "2026-11-07",
+  "amountFormat": "decimal-string",
+  "sources": {
+    "currencies": {
+      "url": "https://developer.paypal.com/braintree/docs/reference/general/currencies",
+      "quotes": [
+        "The following currency types are supported in the Braintree API. Available currencies will differ depending on your account setup and the country your company is located in.",
+        "*Zero-decimal currencies are marked with an asterisk.",
+        "BGN is no longer supported for authorization or settlement. Use EUR for all transactions involving Bulgaria."
+      ]
+    },
+    "sale": {
+      "url": "https://developer.paypal.com/braintree/docs/reference/request/transaction/sale",
+      "quotes": [
+        "This value must be greater than 0, and must match the currency format of the merchant account.",
+        "Can only contain numbers and one decimal point (e.g. `x.xx`).",
+        "Can't be greater than the maximum allowed by the processor.",
+        ":amount => \"10.00\""
+      ]
+    },
+    "errors": {
+      "url": "https://developer.paypal.com/braintree/docs/reference/general/validation-errors/all/",
+      "quotes": [
+        "81501 Amount cannot be negative. Even if creating a credit transaction, the amount should be given as x.xx, not -x.xx.",
+        "81503 Amount is an invalid format. Amount must be formatted like '10' or '10.00'. If the currency does not use decimal places, the amount cannot include decimal places.",
+        "81528 Amount is too large. The amount cannot be greater than the maximum allowed by the processor.",
+        "81531 Amount must be greater than zero. The amount of a transaction cannot be zero.",
+        "81536 Tax amount is too large. The tax amount cannot be longer than 9 digits."
+      ]
+    },
+    "graphql": {
+      "url": "https://developer.paypal.com/braintree/graphql/reference/types/amount",
+      "quotes": [
+        "A monetary amount, either a whole number or a number with exactly two or three decimal places."
+      ]
+    }
+  },
+  "defaultExponent": "iso",
+  "exponents": {
+    "BIF": 0,
+    "CLP": 0,
+    "DJF": 0,
+    "GNF": 0,
+    "HRK": 2,
+    "ISK": 0,
+    "JPY": 0,
+    "KMF": 0,
+    "KRW": 0,
+    "LAK": 0,
+    "LTL": 2,
+    "PYG": 0,
+    "RWF": 0,
+    "SLL": 2,
+    "STD": 2,
+    "UGX": 0,
+    "VND": 0,
+    "VUV": 0,
+    "XAF": 0,
+    "XOF": 0,
+    "XPF": 0,
+    "ZMK": 2,
+    "ZWD": 2
+  },
+  "currencies": [
+    "AED",
+    "AMD",
+    "AOA",
+    "ARS",
+    "AUD",
+    "AWG",
+    "AZN",
+    "BAM",
+    "BBD",
+    "BDT",
+    "BIF",
+    "BMD",
+    "BND",
+    "BOB",
+    "BRL",
+    "BSD",
+    "BWP",
+    "BYN",
+    "BZD",
+    "CAD",
+    "CHF",
+    "CLP",
+    "CNY",
+    "COP",
+    "CRC",
+    "CVE",
+    "CZK",
+    "DJF",
+    "DKK",
+    "DOP",
+    "DZD",
+    "EGP",
+    "ETB",
+    "EUR",
+    "FJD",
+    "FKP",
+    "GBP",
+    "GEL",
+    "GHS",
+    "GIP",
+    "GMD",
+    "GNF",
+    "GTQ",
+    "GYD",
+    "HKD",
+    "HNL",
+    "HRK",
+    "HTG",
+    "HUF",
+    "IDR",
+    "ILS",
+    "INR",
+    "ISK",
+    "JMD",
+    "JPY",
+    "KES",
+    "KGS",
+    "KHR",
+    "KMF",
+    "KRW",
+    "KYD",
+    "KZT",
+    "LAK",
+    "LBP",
+    "LKR",
+    "LRD",
+    "LSL",
+    "LTL",
+    "MAD",
+    "MDL",
+    "MKD",
+    "MNT",
+    "MOP",
+    "MUR",
+    "MVR",
+    "MWK",
+    "MXN",
+    "MYR",
+    "MZN",
+    "NAD",
+    "NGN",
+    "NIO",
+    "NOK",
+    "NPR",
+    "NZD",
+    "PAB",
+    "PEN",
+    "PGK",
+    "PHP",
+    "PKR",
+    "PLN",
+    "PYG",
+    "QAR",
+    "RON",
+    "RSD",
+    "RUB",
+    "RWF",
+    "SAR",
+    "SBD",
+    "SCR",
+    "SEK",
+    "SGD",
+    "SHP",
+    "SLL",
+    "SOS",
+    "SRD",
+    "STD",
+    "SVC",
+    "SYP",
+    "SZL",
+    "THB",
+    "TJS",
+    "TOP",
+    "TRY",
+    "TTD",
+    "TWD",
+    "TZS",
+    "UAH",
+    "UGX",
+    "USD",
+    "UYU",
+    "UZS",
+    "VES",
+    "VND",
+    "VUV",
+    "WST",
+    "XAF",
+    "XCD",
+    "XOF",
+    "XPF",
+    "YER",
+    "ZAR",
+    "ZMK",
+    "ZWD"
+  ],
+  "notes": [
+    "The amount is a decimal string in major units: '10.00', or '10' for a zero-decimal currency. Zero and negative amounts are errors (81531, 81501), refunds and credits included.",
+    "Zero-decimal (17 marked with an asterisk): the 16 ISO 0-decimal currencies listed, plus LAK (ISO 2). CLP, ISK and UGX are 0 as in ISO, unlike Adyen (CLP 2, ISK 2) and Stripe (ISK, UGX x100).",
+    "No ISO three-decimal currency (BHD, IQD, JOD, KWD, LYD, OMR, TND) is listed.",
+    "Withdrawn codes still listed: HRK, LTL, SLL, STD, ZMK and ZWD. The page marks none of them zero-decimal, so they are taken as 2.",
+    "The GraphQL Amount scalar allows three decimals; the REST sale page says x.xx. toBraintree emits the currency's decimals, which both accept."
+  ],
+  "unverified": [
+    {
+      "claim": "Withdrawn codes HRK, LTL, SLL, STD, ZMK and ZWD take 2 decimals (the page only says which currencies are zero-decimal).",
+      "verified": false
+    },
+    {
+      "claim": "Non-zero-decimal currencies take exactly their ISO 4217 decimals (the page gives no per-currency count).",
+      "verified": false
+    },
+    {
+      "claim": "Disbursements (payouts) use the same rules (no disbursement-specific amount format was found).",
+      "verified": false
+    }
+  ]
+}