Package Exports

globalprice
globalprice/src/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (globalprice) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🌍 globalprice

Smart and dynamic pricing engine for global applications, supporting real-time currency conversion, quantity, discounts, tax calculations, and formatted output.

🚀 Features

🌐 Supports 160+ currencies
🔄 Auto-fetches latest exchange rates
🧾 VAT / GST / custom tax support
💸 Discount by percentage or fixed value
📦 Quantity multiplier
🪙 Currency symbol & locale-aware formatting
🧠 Works offline using cached or fallback rates
🔐 .env support for premium API keys

📦 Installation

npm install globalprice

✨ Usage Example

const { calculatePrice, updateRates } = require("globalprice");

await updateRates(); // optional, updates latest rates

const result = await calculatePrice({
  basePrice: 100,
  quantity: 2,
  currency: "LKR",
  discount: { type: "percent", value: 10 },
  tax: { type: "VAT", rate: 12 },
  format: true
});

console.log(result.formatted); // 'Rs 7320.00'

🧪 Test Locally

npm test

🔐 Environment Setup

Add .env for custom API keys:

EXCHANGE_API_KEY=your_api_key_here

📁 Folder Structure

globalprice/
├── src/
│   ├── index.js
│   ├── rates.js
│   └── currencies.js
├── cache/
│   └── exchangeRates.json
├── test/
│   └── globalprice.test.js
├── .env
├── package.json
├── LICENSE
└── README.md

globalprice