@higher.archi/boe 1.0.0

package/dist/engines/pricing/compiler.js

@@ -0,0 +1,275 @@
+"use strict";
+/**
+ * Pricing Engine Compiler
+ *
+ * Compiles pricing rulesets for efficient execution:
+ * - Validates product types and scenario schemas
+ * - Compiles expressions in pricing/quantity/metrics
+ * - Validates scenario values against product type schemas
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compilePricingRuleSet = compilePricingRuleSet;
+exports.compilePricingRule = compilePricingRule;
+const core_1 = require("../../core");
+const types_1 = require("./types");
+// ========================================
+// Validation Helpers
+// ========================================
+/**
+ * Validate component's scenario values against product type schema.
+ */
+function validateScenarioValues(component, productType, scenarioIds, strict) {
+    if (!productType)
+        return;
+    const { scenarioSchema } = productType;
+    for (const scenarioId of scenarioIds) {
+        const values = component.scenarioValues[scenarioId] || {};
+        // Check required fields
+        for (const [field, schema] of Object.entries(scenarioSchema)) {
+            if (schema.required && values[field] === undefined && schema.default === undefined) {
+                if (strict) {
+                    throw new Error(`Component '${component.sku}' missing required scenario value '${field}' for scenario '${scenarioId}'`);
+                }
+            }
+        }
+        // Validate provided values
+        for (const [field, value] of Object.entries(values)) {
+            const schema = scenarioSchema[field];
+            if (!schema) {
+                throw new Error(`Component '${component.sku}' has unknown scenario field '${field}' for scenario '${scenarioId}'`);
+            }
+            validateValue(value, schema, `${component.sku}.${scenarioId}.${field}`);
+        }
+    }
+}
+/**
+ * Validate a value against its schema.
+ */
+function validateValue(value, schema, path) {
+    if (value === undefined || value === null)
+        return;
+    const actualType = Array.isArray(value) ? 'array' : typeof value;
+    if (actualType !== schema.type) {
+        throw new Error(`Invalid type for '${path}': expected ${schema.type}, got ${actualType}`);
+    }
+    if (schema.type === 'number' && typeof value === 'number') {
+        if (schema.min !== undefined && value < schema.min) {
+            throw new Error(`Value for '${path}' is below minimum: ${value} < ${schema.min}`);
+        }
+        if (schema.max !== undefined && value > schema.max) {
+            throw new Error(`Value for '${path}' exceeds maximum: ${value} > ${schema.max}`);
+        }
+    }
+    if (schema.type === 'string' && schema.enum && typeof value === 'string') {
+        if (!schema.enum.includes(value)) {
+            throw new Error(`Invalid value for '${path}': '${value}' not in [${schema.enum.join(', ')}]`);
+        }
+    }
+}
+// ========================================
+// Pricing Mode Compilation
+// ========================================
+function compileGraduatedTier(tier) {
+    return {
+        upTo: tier.upTo,
+        pricePerUnit: (0, core_1.compileOperand)(tier.pricePerUnit)
+    };
+}
+function compileVolumeBracket(bracket) {
+    return {
+        minVolume: bracket.minVolume,
+        pricePerUnit: (0, core_1.compileOperand)(bracket.pricePerUnit)
+    };
+}
+function compileMeter(meter) {
+    return {
+        id: meter.id,
+        name: meter.name || meter.id,
+        quantity: (0, core_1.compileOperand)(meter.quantity),
+        unit: meter.unit || 'units',
+        pricing: compilePricingMode(meter.pricing)
+    };
+}
+function compilePricingMode(pricing) {
+    switch (pricing.mode) {
+        case 'flat':
+            return {
+                mode: 'flat',
+                pricePerUnit: (0, core_1.compileOperand)(pricing.pricePerUnit)
+            };
+        case 'graduated':
+            // Validate tiers are in order
+            for (let i = 1; i < pricing.tiers.length; i++) {
+                if (pricing.tiers[i].upTo <= pricing.tiers[i - 1].upTo) {
+                    throw new Error(`Graduated tiers must be in ascending order by 'upTo' value`);
+                }
+            }
+            return {
+                mode: 'graduated',
+                tiers: pricing.tiers.map(compileGraduatedTier)
+            };
+        case 'volume':
+            // Validate brackets are in order
+            for (let i = 1; i < pricing.brackets.length; i++) {
+                if (pricing.brackets[i].minVolume <= pricing.brackets[i - 1].minVolume) {
+                    throw new Error(`Volume brackets must be in ascending order by 'minVolume' value`);
+                }
+            }
+            return {
+                mode: 'volume',
+                brackets: pricing.brackets.map(compileVolumeBracket)
+            };
+        case 'multi-meter':
+            return {
+                mode: 'multi-meter',
+                meters: pricing.meters.map(compileMeter)
+            };
+        case 'formula':
+            return {
+                mode: 'formula',
+                calculate: (0, core_1.compileOperand)(pricing.calculate)
+            };
+    }
+}
+// ========================================
+// Component Compilation
+// ========================================
+function compileComponent(component, productTypes, scenarioIds, strict) {
+    const productType = component.productType
+        ? productTypes[component.productType]
+        : undefined;
+    // Validate scenario values if product type exists
+    if (productType) {
+        validateScenarioValues(component, productType, scenarioIds, strict);
+    }
+    // Compile attributes
+    const attributes = {};
+    for (const [key, value] of Object.entries(component.attributes)) {
+        attributes[key] = (0, core_1.compileOperand)(value);
+    }
+    return {
+        sku: component.sku,
+        name: component.name || component.sku,
+        productType: component.productType,
+        attributes,
+        scenarioValues: component.scenarioValues,
+        quantity: (0, core_1.compileOperand)(component.quantity),
+        unit: component.unit || productType?.defaultUnit || 'units',
+        pricing: compilePricingMode(component.pricing)
+    };
+}
+// ========================================
+// Adjustment Compilation
+// ========================================
+function compileAdjustment(adjustment) {
+    switch (adjustment.type) {
+        case 'discount':
+            return {
+                type: 'discount',
+                name: adjustment.name,
+                percent: adjustment.percent,
+                amount: adjustment.amount,
+                condition: adjustment.condition
+                    ? (0, core_1.compileCondition)(adjustment.condition)
+                    : undefined
+            };
+        case 'minimum':
+            return {
+                type: 'minimum',
+                name: adjustment.name || 'Minimum charge',
+                amount: adjustment.amount
+            };
+        case 'maximum':
+            return {
+                type: 'maximum',
+                name: adjustment.name || 'Price cap',
+                amount: adjustment.amount
+            };
+    }
+}
+// ========================================
+// Metric Compilation
+// ========================================
+function compileMetric(metric) {
+    return {
+        id: metric.id,
+        name: metric.name,
+        calculate: (0, core_1.compileOperand)(metric.calculate),
+        format: metric.format || 'number'
+    };
+}
+// ========================================
+// Input Compilation
+// ========================================
+function compileInput(input) {
+    return {
+        name: input.name,
+        type: input.type,
+        where: input.where ? (0, core_1.compileCondition)(input.where) : undefined
+    };
+}
+// ========================================
+// Rule Compilation
+// ========================================
+function compileRule(rule, productTypes, scenarioIds, strict) {
+    return {
+        id: rule.id,
+        name: rule.name || rule.id,
+        description: rule.description,
+        inputs: (rule.inputs || []).map(compileInput),
+        components: rule.pricing.components.map(c => compileComponent(c, productTypes, scenarioIds, strict)),
+        adjustments: (rule.pricing.adjustments || []).map(compileAdjustment),
+        metrics: (rule.pricing.metrics || []).map(compileMetric)
+    };
+}
+// ========================================
+// RuleSet Compilation
+// ========================================
+/**
+ * Compile a pricing ruleset.
+ */
+function compilePricingRuleSet(ruleSet) {
+    const scenarioDefinitions = ruleSet.scenarios?.definitions || {};
+    const scenarioIds = Object.keys(scenarioDefinitions);
+    const productTypes = ruleSet.productTypes || {};
+    const strict = ruleSet.scenarios?.strict ?? false;
+    // Find default scenario
+    let defaultScenario;
+    for (const [id, def] of Object.entries(scenarioDefinitions)) {
+        if (def.isDefault) {
+            defaultScenario = id;
+            break;
+        }
+    }
+    if (!defaultScenario && scenarioIds.length > 0) {
+        defaultScenario = scenarioIds[0];
+    }
+    // Resolve currency config
+    const currency = ruleSet.config?.currency ?? 'USD';
+    const currencyInfo = (0, types_1.getCurrencyInfo)(currency);
+    const precision = ruleSet.config?.precision ?? currencyInfo.decimals;
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'pricing',
+        scenarios: {
+            definitions: scenarioDefinitions,
+            defaultScenario,
+            strict
+        },
+        productTypes,
+        config: {
+            currency,
+            currencyInfo,
+            precision
+        },
+        rules: ruleSet.rules.map(rule => compileRule(rule, productTypes, scenarioIds, strict))
+    };
+}
+/**
+ * Compile a single pricing rule (for direct rule compilation).
+ */
+function compilePricingRule(rule, productTypes = {}, scenarioIds = [], strict = false) {
+    return compileRule(rule, productTypes, scenarioIds, strict);
+}
+//# sourceMappingURL=compiler.js.map

package/dist/engines/pricing/compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.js","sourceRoot":"","sources":["../../../src/engines/pricing/compiler.ts"],"names":[],"mappings":"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"}

package/dist/engines/pricing/engine.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Pricing Engine
+ *
+ * Calculates costs for tiered/graduated pricing, package-based pricing
+ * with multiple SKUs, and enables scenario comparisons.
+ *
+ * Unlike other engines, the Pricing Engine does NOT use working memory.
+ * It takes direct input (ruleset + rule ID + options) and returns pricing results.
+ */
+import { CompiledPricingRuleSet, PricingRuleSet, PricingOptions, PricingResult, ScenarioComparisonResult } from './types';
+/**
+ * Pricing Engine.
+ *
+ * Calculates pricing based on tiered/graduated models, supports multiple
+ * pricing modes, adjustments, and scenario comparisons.
+ *
+ * @example
+ * ```typescript
+ * const engine = new PricingEngine();
+ * const compiled = compilePricingRuleSet(pricingRuleSet);
+ *
+ * // Single scenario calculation
+ * const result = engine.calculate(compiled, 'api-pricing', { scenario: 'standard' });
+ * console.log(`Total: ${result.summary.total}`);
+ *
+ * // Compare all scenarios
+ * const comparison = engine.calculateScenarios(compiled, 'api-pricing');
+ * console.log(comparison.toString());
+ * ```
+ */
+export declare class PricingEngine {
+    private strategy;
+    constructor();
+    /**
+     * Calculate pricing for a single scenario.
+     *
+     * @param ruleSet - Compiled or source pricing ruleset
+     * @param ruleId - ID of the rule to calculate
+     * @param options - Runtime options (scenario, overrides, callbacks)
+     * @returns Pricing result with component breakdown and totals
+     *
+     * @example
+     * ```typescript
+     * const result = engine.calculate(compiled, 'cloud-pricing', {
+     *   scenario: 'heavy-usage'
+     * });
+     *
+     * console.log(`Components Total: ${result.summary.componentsTotal}`);
+     * console.log(`After Adjustments: ${result.summary.total}`);
+     * console.log(result.toString());
+     * ```
+     */
+    calculate(ruleSet: CompiledPricingRuleSet | PricingRuleSet, ruleId: string, options?: PricingOptions): PricingResult;
+    /**
+     * Calculate pricing for multiple scenarios for comparison.
+     *
+     * @param ruleSet - Compiled or source pricing ruleset
+     * @param ruleId - ID of the rule to calculate
+     * @param scenarioIds - Optional array of scenario IDs (defaults to all scenarios)
+     * @returns Comparison result with all scenario results
+     *
+     * @example
+     * ```typescript
+     * const comparison = engine.calculateScenarios(compiled, 'saas-pricing');
+     *
+     * // Access individual scenario results
+     * const lightUsage = comparison.scenarios['light'];
+     * console.log(`Light: ${lightUsage.summary.total}`);
+     *
+     * // Print comparison table
+     * console.log(comparison.toString());
+     * ```
+     */
+    calculateScenarios(ruleSet: CompiledPricingRuleSet | PricingRuleSet, ruleId: string, scenarioIds?: string[]): ScenarioComparisonResult;
+    /**
+     * Ensure ruleset is compiled.
+     */
+    private ensureCompiled;
+    /**
+     * Get available scenario IDs from a ruleset.
+     *
+     * @param ruleSet - Compiled or source pricing ruleset
+     * @returns Array of scenario IDs
+     */
+    getScenarios(ruleSet: CompiledPricingRuleSet | PricingRuleSet): string[];
+    /**
+     * Get available rule IDs from a ruleset.
+     *
+     * @param ruleSet - Compiled or source pricing ruleset
+     * @returns Array of rule IDs
+     */
+    getRules(ruleSet: CompiledPricingRuleSet | PricingRuleSet): string[];
+    /**
+     * Get the default scenario ID for a ruleset.
+     *
+     * @param ruleSet - Compiled or source pricing ruleset
+     * @returns Default scenario ID or undefined
+     */
+    getDefaultScenario(ruleSet: CompiledPricingRuleSet | PricingRuleSet): string | undefined;
+}
+export declare const pricingEngine: PricingEngine;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engines/pricing/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/engines/pricing/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,aAAa,EACb,wBAAwB,EACzB,MAAM,SAAS,CAAC;AAKjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAkB;;IAMlC;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,CACP,OAAO,EAAE,sBAAsB,GAAG,cAAc,EAChD,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,cAAmB,GAC3B,aAAa;IAKhB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,kBAAkB,CAChB,OAAO,EAAE,sBAAsB,GAAG,cAAc,EAChD,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,wBAAwB;IAK3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,sBAAsB,GAAG,cAAc,GAAG,MAAM,EAAE;IAKxE;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,cAAc,GAAG,MAAM,EAAE;IAKpE;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,GAAG,cAAc,GAAG,MAAM,GAAG,SAAS;CAIzF;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/engines/pricing/engine.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * Pricing Engine
+ *
+ * Calculates costs for tiered/graduated pricing, package-based pricing
+ * with multiple SKUs, and enables scenario comparisons.
+ *
+ * Unlike other engines, the Pricing Engine does NOT use working memory.
+ * It takes direct input (ruleset + rule ID + options) and returns pricing results.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pricingEngine = exports.PricingEngine = void 0;
+const compiler_1 = require("./compiler");
+const strategy_1 = require("./strategy");
+/**
+ * Pricing Engine.
+ *
+ * Calculates pricing based on tiered/graduated models, supports multiple
+ * pricing modes, adjustments, and scenario comparisons.
+ *
+ * @example
+ * ```typescript
+ * const engine = new PricingEngine();
+ * const compiled = compilePricingRuleSet(pricingRuleSet);
+ *
+ * // Single scenario calculation
+ * const result = engine.calculate(compiled, 'api-pricing', { scenario: 'standard' });
+ * console.log(`Total: ${result.summary.total}`);
+ *
+ * // Compare all scenarios
+ * const comparison = engine.calculateScenarios(compiled, 'api-pricing');
+ * console.log(comparison.toString());
+ * ```
+ */
+class PricingEngine {
+    strategy;
+    constructor() {
+        this.strategy = new strategy_1.PricingStrategy();
+    }
+    /**
+     * Calculate pricing for a single scenario.
+     *
+     * @param ruleSet - Compiled or source pricing ruleset
+     * @param ruleId - ID of the rule to calculate
+     * @param options - Runtime options (scenario, overrides, callbacks)
+     * @returns Pricing result with component breakdown and totals
+     *
+     * @example
+     * ```typescript
+     * const result = engine.calculate(compiled, 'cloud-pricing', {
+     *   scenario: 'heavy-usage'
+     * });
+     *
+     * console.log(`Components Total: ${result.summary.componentsTotal}`);
+     * console.log(`After Adjustments: ${result.summary.total}`);
+     * console.log(result.toString());
+     * ```
+     */
+    calculate(ruleSet, ruleId, options = {}) {
+        const compiled = this.ensureCompiled(ruleSet);
+        return this.strategy.calculate(compiled, ruleId, options);
+    }
+    /**
+     * Calculate pricing for multiple scenarios for comparison.
+     *
+     * @param ruleSet - Compiled or source pricing ruleset
+     * @param ruleId - ID of the rule to calculate
+     * @param scenarioIds - Optional array of scenario IDs (defaults to all scenarios)
+     * @returns Comparison result with all scenario results
+     *
+     * @example
+     * ```typescript
+     * const comparison = engine.calculateScenarios(compiled, 'saas-pricing');
+     *
+     * // Access individual scenario results
+     * const lightUsage = comparison.scenarios['light'];
+     * console.log(`Light: ${lightUsage.summary.total}`);
+     *
+     * // Print comparison table
+     * console.log(comparison.toString());
+     * ```
+     */
+    calculateScenarios(ruleSet, ruleId, scenarioIds) {
+        const compiled = this.ensureCompiled(ruleSet);
+        return this.strategy.calculateScenarios(compiled, ruleId, scenarioIds);
+    }
+    /**
+     * Ensure ruleset is compiled.
+     */
+    ensureCompiled(ruleSet) {
+        // Check if already compiled by looking for compiled-specific properties
+        if ('config' in ruleSet && typeof ruleSet.config === 'object' && 'currency' in ruleSet.config && 'precision' in ruleSet.config) {
+            return ruleSet;
+        }
+        return (0, compiler_1.compilePricingRuleSet)(ruleSet);
+    }
+    /**
+     * Get available scenario IDs from a ruleset.
+     *
+     * @param ruleSet - Compiled or source pricing ruleset
+     * @returns Array of scenario IDs
+     */
+    getScenarios(ruleSet) {
+        const compiled = this.ensureCompiled(ruleSet);
+        return Object.keys(compiled.scenarios.definitions);
+    }
+    /**
+     * Get available rule IDs from a ruleset.
+     *
+     * @param ruleSet - Compiled or source pricing ruleset
+     * @returns Array of rule IDs
+     */
+    getRules(ruleSet) {
+        const compiled = this.ensureCompiled(ruleSet);
+        return compiled.rules.map(r => r.id);
+    }
+    /**
+     * Get the default scenario ID for a ruleset.
+     *
+     * @param ruleSet - Compiled or source pricing ruleset
+     * @returns Default scenario ID or undefined
+     */
+    getDefaultScenario(ruleSet) {
+        const compiled = this.ensureCompiled(ruleSet);
+        return compiled.scenarios.defaultScenario;
+    }
+}
+exports.PricingEngine = PricingEngine;
+// Export singleton for convenience
+exports.pricingEngine = new PricingEngine();
+//# sourceMappingURL=engine.js.map

package/dist/engines/pricing/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/engines/pricing/engine.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAUH,yCAAmD;AACnD,yCAA6C;AAE7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,aAAa;IAChB,QAAQ,CAAkB;IAElC;QACE,IAAI,CAAC,QAAQ,GAAG,IAAI,0BAAe,EAAE,CAAC;IACxC,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,CACP,OAAgD,EAChD,MAAc,EACd,UAA0B,EAAE;QAE5B,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,kBAAkB,CAChB,OAAgD,EAChD,MAAc,EACd,WAAsB;QAEtB,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,OAAgD;QACrE,wEAAwE;QACxE,IAAI,QAAQ,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,UAAU,IAAI,OAAO,CAAC,MAAM,IAAI,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAC/H,OAAO,OAAiC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAA,gCAAqB,EAAC,OAAyB,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,OAAgD;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC9C,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAAgD;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC9C,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,OAAgD;QACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC9C,OAAO,QAAQ,CAAC,SAAS,CAAC,eAAe,CAAC;IAC5C,CAAC;CACF;AA3GD,sCA2GC;AAED,mCAAmC;AACtB,QAAA,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC"}

package/dist/engines/pricing/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Pricing Engine - Tiered/Graduated Pricing & Scenario Comparison
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   PricingEngine,
+ *   compilePricingRuleSet,
+ *   PricingRuleSet
+ * } from '@higher.archi/boe';
+ *
+ * const ruleSet: PricingRuleSet = {
+ *   id: 'cloud-pricing',
+ *   mode: 'pricing',
+ *   scenarios: {
+ *     definitions: {
+ *       light: { name: 'Light Usage' },
+ *       standard: { name: 'Standard Usage', isDefault: true },
+ *       heavy: { name: 'Heavy Usage' }
+ *     }
+ *   },
+ *   rules: [{
+ *     id: 'api-pricing',
+ *     pricing: {
+ *       mode: 'package',
+ *       components: [{
+ *         sku: 'api-requests',
+ *         scenarioValues: {
+ *           light: { requests: 100_000 },
+ *           standard: { requests: 1_000_000 },
+ *           heavy: { requests: 10_000_000 }
+ *         },
+ *         quantity: '$requests',
+ *         pricing: {
+ *           mode: 'graduated',
+ *           tiers: [
+ *             { upTo: 1_000_000, pricePerUnit: 0.0002 },
+ *             { upTo: 5_000_000, pricePerUnit: 0.0001 },
+ *             { upTo: Infinity, pricePerUnit: 0.00005 }
+ *           ]
+ *         }
+ *       }]
+ *     }
+ *   }]
+ * };
+ *
+ * const compiled = compilePricingRuleSet(ruleSet);
+ * const engine = new PricingEngine();
+ *
+ * // Single scenario
+ * const result = engine.calculate(compiled, 'api-pricing', { scenario: 'standard' });
+ * console.log(result.toString());
+ *
+ * // Compare all scenarios
+ * const comparison = engine.calculateScenarios(compiled, 'api-pricing');
+ * console.log(comparison.toString());
+ * ```
+ */
+export type { CurrencyCode, CurrencyInfo, ScenarioDefinition, ScenarioDefinitions, AttributeSchema, ProductType, FlatPricing, GraduatedTier, GraduatedPricing, VolumeBracket, VolumePricing, Meter, MultiMeterPricing, FormulaPricing, PricingMode, PricingComponent, DiscountAdjustment, MinimumAdjustment, MaximumAdjustment, Adjustment, Metric, PricingInput, PricingPackage, PricingRule, PricingConfig, PricingRuleSet, CompiledGraduatedTier, CompiledVolumeBracket, CompiledMeter, CompiledPricingMode, CompiledPricingComponent, CompiledAdjustment, CompiledMetric, CompiledPricingInput, CompiledPricingRule, ResolvedPricingConfig, CompiledPricingRuleSet, TierBreakdown, MeterResult, ComponentResult, AdjustmentResult, PricingSummary, ScenarioResult, PricingResult, ScenarioComparisonResult, PricingOptions } from './types';
+export { CURRENCIES, getCurrencyInfo } from './types';
+export { compilePricingRuleSet, compilePricingRule } from './compiler';
+export { calculateFlat, calculateGraduated, calculateVolume, formatCurrency, formatNumber, formatPercent, round, calculateDiscount, applyMinMax } from './calculator';
+export type { CalculatorContext, TierCalculationResult } from './calculator';
+export { PricingStrategy, pricingStrategy } from './strategy';
+export { PricingEngine, pricingEngine } from './engine';
+//# sourceMappingURL=index.d.ts.map

package/dist/engines/pricing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engines/pricing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAGH,YAAY,EAEV,YAAY,EACZ,YAAY,EAGZ,kBAAkB,EAClB,mBAAmB,EAGnB,eAAe,EACf,WAAW,EAGX,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,KAAK,EACL,iBAAiB,EACjB,cAAc,EACd,WAAW,EAGX,gBAAgB,EAGhB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EAGV,MAAM,EAGN,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EAGd,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EAGtB,aAAa,EACb,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,aAAa,EACb,wBAAwB,EAGxB,cAAc,EACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAGtD,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGvE,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,aAAa,EACb,KAAK,EACL,iBAAiB,EACjB,WAAW,EACZ,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}