@robinpath/money

Currency formatting, safe arithmetic, conversion, tax, discount, and exchange rates

Why use this module?

The money module lets you:

• Format number as currency
• Parse currency string to number
• Safe addition
• Safe subtraction
• Safe multiplication

All functions are callable directly from RobinPath scripts with a simple, consistent API.

Installation

npm install @robinpath/money

Quick Start

No credentials needed — start using it right away:

money.parse "$1,234.56"

Available Functions

| Function | Description | |----------|-------------| | money.format | Format number as currency | | money.parse | Parse currency string to number | | money.add | Safe addition | | money.subtract | Safe subtraction | | money.multiply | Safe multiplication | | money.divide | Safe division | | money.round | Round to currency precision | | money.convert | Convert between currencies | | money.fetchRate | Fetch live exchange rate | | money.split | Split amount evenly | | money.percentage | Calculate percentage | | money.discount | Apply discount | | money.tax | Add tax | | money.currencyInfo | Get currency info | | money.listCurrencies | List all currency codes | | money.isValidCode | Check if currency code is valid |

Examples

Parse currency string to number

money.parse "$1,234.56"

Safe addition

money.add 0.1 0.2

Safe subtraction

money.subtract 10.50 3.25

Integration with RobinPath

import { RobinPath } from "@wiredwp/robinpath";
import Module from "@robinpath/money";

const rp = new RobinPath();
rp.registerModule(Module.name, Module.functions);
rp.registerModuleMeta(Module.name, Module.functionMetadata);

const result = await rp.executeScript(`
  money.parse "$1,234.56"
`);

Full API Reference

See MODULE.md for complete documentation including all parameters, return types, error handling, and advanced examples.

Related Modules

• @robinpath/json — JSON module for complementary functionality

License

MIT