open-pricing-engine

A configurable, framework-agnostic pricing engine for any business domain.

Install

npm install open-pricing-engine

Usage

import { PricingEngine } from 'open-pricing-engine';

const engine = new PricingEngine({
  rules: [
    {
      name: 'flat-surface',
      type: 'area-based',
      unitPrice: 12.5,
      unit: 'm2',
      minCharge: 25.0,
    },
  ],
});

const result = engine.calculate({
  rule: 'flat-surface',
  dimensions: { width: 2.0, height: 1.5 },
  quantity: 10,
});

// Result:
// {
//   rule: 'flat-surface',
//   area: 3.0,
//   unitPrice: 12.50,
//   subtotal: 37.50,
//   quantity: 10,
//   total: 375.00
// }

Features

• Config-driven — define pricing rules in JSON
• Area-based pricing — calculations from dimensions (m², ft², units)
• Minimum charge — guaranteed price floor per item
• TypeScript-first — full type safety
• Zod validation — descriptive errors for invalid config
• 100% test coverage

Documentation

Full documentation, roadmap, and contributing guide: GitHub

License

MIT