@acontplus/core 1.0.6 → 1.0.9

package/src/lib/pricing/calculations/discount.calculator.d.ts

@@ -0,0 +1,56 @@
+import { DiscountCalculation } from '../../types';
+/**
+ * Calculadora especializada para descuentos
+ */
+export declare class DiscountCalculator {
+    private decimales;
+    constructor(decimales?: number);
+    /**
+     * Calcula el valor del descuento a partir del porcentaje
+     * @param originalPrice - Precio antes del descuento
+     * @param discountPercentage - Porcentaje de descuento a aplicar (0-100)
+     * @returns Valor del descuento en moneda
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const valorDescuento = calculadora.calculateDiscountAmount(100, 10); // 10
+     * ```
+     */
+    calculateDiscountAmount(originalPrice: number, discountPercentage: number): number;
+    /**
+     * Aplica un descuento al precio original
+     * @param originalPrice - Precio antes del descuento
+     * @param discountPercentage - Porcentaje de descuento a aplicar
+     * @returns Precio final después del descuento
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const precioConDescuento = calculadora.applyDiscount(100, 10); // 90
+     * ```
+     */
+    applyDiscount(originalPrice: number, discountPercentage: number): number;
+    /**
+     * Calcula el porcentaje de descuento a partir de los valores
+     * @param originalPrice - Precio antes del descuento
+     * @param discountAmount - Valor del descuento aplicado
+     * @returns Porcentaje de descuento
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const porcentaje = calculadora.calculateDiscountPercentage(100, 10); // 10
+     * ```
+     */
+    calculateDiscountPercentage(originalPrice: number, discountAmount: number): number;
+    /**
+     * Obtiene los detalles completos del cálculo de descuento
+     * @param originalPrice - Precio antes del descuento
+     * @param discountPercentage - Porcentaje de descuento a aplicar
+     * @returns Objeto con todos los detalles del cálculo
+     * @example
+     * ```typescript
+     * const detalles = calculadora.getDiscountCalculationDetails(100, 10);
+     * // { originalPrice: 100, discountRate: 10, discountAmount: 10, finalPrice: 90 }
+     * ```
+     */
+    getDiscountCalculationDetails(originalPrice: number, discountPercentage: number): DiscountCalculation;
+}

package/src/lib/pricing/calculations/discount.calculator.js

@@ -0,0 +1,99 @@
+import { DecimalConverter, InvalidParameterError, ParameterValidator } from '@acontplus/utils';
+import { PricingCalculationError } from './pricing-calculation.error';
+/**
+ * Calculadora especializada para descuentos
+ */
+export class DiscountCalculator {
+    constructor(decimales = 4) {
+        this.decimales = decimales;
+    }
+    /**
+     * Calcula el valor del descuento a partir del porcentaje
+     * @param originalPrice - Precio antes del descuento
+     * @param discountPercentage - Porcentaje de descuento a aplicar (0-100)
+     * @returns Valor del descuento en moneda
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const valorDescuento = calculadora.calculateDiscountAmount(100, 10); // 10
+     * ```
+     */
+    calculateDiscountAmount(originalPrice, discountPercentage) {
+        try {
+            ParameterValidator.validatePositiveNumber(originalPrice, 'originalPrice');
+            ParameterValidator.validatePercentage(discountPercentage, 'discountPercentage');
+            const percentage = DecimalConverter.divideAsNumber(discountPercentage, 100);
+            return DecimalConverter.multiplyAsNumber(originalPrice, percentage);
+        }
+        catch (error) {
+            throw new PricingCalculationError('calculateDiscountAmount', error);
+        }
+    }
+    /**
+     * Aplica un descuento al precio original
+     * @param originalPrice - Precio antes del descuento
+     * @param discountPercentage - Porcentaje de descuento a aplicar
+     * @returns Precio final después del descuento
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const precioConDescuento = calculadora.applyDiscount(100, 10); // 90
+     * ```
+     */
+    applyDiscount(originalPrice, discountPercentage) {
+        try {
+            const discountAmount = this.calculateDiscountAmount(originalPrice, discountPercentage);
+            return DecimalConverter.subtractAsNumber(originalPrice, discountAmount);
+        }
+        catch (error) {
+            throw new PricingCalculationError('applyDiscount', error);
+        }
+    }
+    /**
+     * Calcula el porcentaje de descuento a partir de los valores
+     * @param originalPrice - Precio antes del descuento
+     * @param discountAmount - Valor del descuento aplicado
+     * @returns Porcentaje de descuento
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const porcentaje = calculadora.calculateDiscountPercentage(100, 10); // 10
+     * ```
+     */
+    calculateDiscountPercentage(originalPrice, discountAmount) {
+        try {
+            ParameterValidator.validatePositiveNumber(originalPrice, 'originalPrice');
+            ParameterValidator.validatePositiveNumber(discountAmount, 'discountAmount');
+            if (discountAmount > originalPrice) {
+                throw new InvalidParameterError('discountAmount', 'No puede ser mayor que el precio original');
+            }
+            const percentage = DecimalConverter.divideAsNumber(discountAmount, originalPrice);
+            return DecimalConverter.multiplyAsNumber(percentage, 100);
+        }
+        catch (error) {
+            throw new PricingCalculationError('calculateDiscountPercentage', error);
+        }
+    }
+    /**
+     * Obtiene los detalles completos del cálculo de descuento
+     * @param originalPrice - Precio antes del descuento
+     * @param discountPercentage - Porcentaje de descuento a aplicar
+     * @returns Objeto con todos los detalles del cálculo
+     * @example
+     * ```typescript
+     * const detalles = calculadora.getDiscountCalculationDetails(100, 10);
+     * // { originalPrice: 100, discountRate: 10, discountAmount: 10, finalPrice: 90 }
+     * ```
+     */
+    getDiscountCalculationDetails(originalPrice, discountPercentage) {
+        const discountAmount = this.calculateDiscountAmount(originalPrice, discountPercentage);
+        const finalPrice = this.applyDiscount(originalPrice, discountPercentage);
+        return {
+            originalPrice,
+            discountRate: discountPercentage,
+            discountAmount,
+            finalPrice,
+        };
+    }
+}
+//# sourceMappingURL=discount.calculator.js.map

package/src/lib/pricing/calculations/discount.calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discount.calculator.js","sourceRoot":"","sources":["../../../../../../../packages/core/src/lib/pricing/calculations/discount.calculator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAGtE;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAC7B,YAAoB,YAAY,CAAC;QAAb,cAAS,GAAT,SAAS,CAAI;IAAG,CAAC;IAErC;;;;;;;;;;OAUG;IACH,uBAAuB,CAAC,aAAqB,EAAE,kBAA0B;QACvE,IAAI,CAAC;YACH,kBAAkB,CAAC,sBAAsB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;YAC1E,kBAAkB,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC;YAEhF,MAAM,UAAU,GAAG,gBAAgB,CAAC,cAAc,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;YAC5E,OAAO,gBAAgB,CAAC,gBAAgB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,uBAAuB,CAAC,yBAAyB,EAAE,KAAc,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,aAAa,CAAC,aAAqB,EAAE,kBAA0B;QAC7D,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,IAAI,CAAC,uBAAuB,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;YACvF,OAAO,gBAAgB,CAAC,gBAAgB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,uBAAuB,CAAC,eAAe,EAAE,KAAc,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,2BAA2B,CAAC,aAAqB,EAAE,cAAsB;QACvE,IAAI,CAAC;YACH,kBAAkB,CAAC,sBAAsB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;YAC1E,kBAAkB,CAAC,sBAAsB,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;YAE5E,IAAI,cAAc,GAAG,aAAa,EAAE,CAAC;gBACnC,MAAM,IAAI,qBAAqB,CAC7B,gBAAgB,EAChB,2CAA2C,CAC5C,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,cAAc,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;YAClF,OAAO,gBAAgB,CAAC,gBAAgB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,uBAAuB,CAAC,6BAA6B,EAAE,KAAc,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,6BAA6B,CAC3B,aAAqB,EACrB,kBAA0B;QAE1B,MAAM,cAAc,GAAG,IAAI,CAAC,uBAAuB,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;QACvF,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;QAEzE,OAAO;YACL,aAAa;YACb,YAAY,EAAE,kBAAkB;YAChC,cAAc;YACd,UAAU;SACX,CAAC;IACJ,CAAC;CACF"}

package/src/lib/pricing/calculations/index.d.ts

@@ -0,0 +1,5 @@
+export * from './discount.calculator';
+export * from './line-item.calculator';
+export * from './pricing.calculator';
+export * from './profit.calculator';
+export * from './tax.calculator';

package/src/lib/pricing/calculations/index.js

@@ -0,0 +1,6 @@
+export * from './discount.calculator';
+export * from './line-item.calculator';
+export * from './pricing.calculator';
+export * from './profit.calculator';
+export * from './tax.calculator';
+//# sourceMappingURL=index.js.map

package/src/lib/pricing/calculations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/core/src/lib/pricing/calculations/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}

package/src/lib/pricing/calculations/line-item.calculator.d.ts

@@ -0,0 +1,34 @@
+import { LineItemCalculation } from '../../types';
+/**
+ * Calculadora especializada para líneas de productos/servicios en facturas
+ */
+export declare class LineItemCalculator {
+    private decimales;
+    constructor(decimales?: number);
+    /**
+     * Calcula el total de una línea de producto incluyendo descuentos e impuestos
+     * @param unitPrice - Precio por unidad del producto
+     * @param quantity - Cantidad de productos
+     * @param discountAmount - Valor del descuento a aplicar (por defecto 0)
+     * @param taxAmount - Valor del impuesto a aplicar (por defecto 0)
+     * @returns Objeto con todos los cálculos de la línea
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const linea = calculadora.calcularTotalLinea(50, 2, 10, 8.4);
+     * // Resultado: subtotal: 100, con descuento: 90, total con impuesto: 98.4
+     * ```
+     */
+    calculateLineItemTotal(unitPrice: number, quantity: number, discountAmount?: number, taxAmount?: number): LineItemCalculation;
+    /**
+     * Calcula el subtotal antes de aplicar descuentos
+     * @param unitPrice - Precio por unidad
+     * @param quantity - Cantidad de productos
+     * @returns Subtotal calculado
+     * @example
+     * ```typescript
+     * const subtotal = calculadora.calculateSubtotal(25, 4); // 100
+     * ```
+     */
+    calculateSubtotal(unitPrice: number, quantity: number): number;
+}

package/src/lib/pricing/calculations/line-item.calculator.js

@@ -0,0 +1,61 @@
+import { DecimalConverter, ParameterValidator } from '@acontplus/utils';
+import { PricingCalculationError } from './pricing-calculation.error';
+/**
+ * Calculadora especializada para líneas de productos/servicios en facturas
+ */
+export class LineItemCalculator {
+    constructor(decimales = 4) {
+        this.decimales = decimales;
+    }
+    /**
+     * Calcula el total de una línea de producto incluyendo descuentos e impuestos
+     * @param unitPrice - Precio por unidad del producto
+     * @param quantity - Cantidad de productos
+     * @param discountAmount - Valor del descuento a aplicar (por defecto 0)
+     * @param taxAmount - Valor del impuesto a aplicar (por defecto 0)
+     * @returns Objeto con todos los cálculos de la línea
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const linea = calculadora.calcularTotalLinea(50, 2, 10, 8.4);
+     * // Resultado: subtotal: 100, con descuento: 90, total con impuesto: 98.4
+     * ```
+     */
+    calculateLineItemTotal(unitPrice, quantity, discountAmount = 0, taxAmount = 0) {
+        try {
+            ParameterValidator.validatePositiveNumber(unitPrice, 'unitPrice');
+            ParameterValidator.validatePositiveNumber(quantity, 'quantity');
+            ParameterValidator.validatePositiveNumber(discountAmount, 'discountAmount');
+            ParameterValidator.validatePositiveNumber(taxAmount, 'taxAmount');
+            const subtotal = DecimalConverter.multiplyAsNumber(unitPrice, quantity);
+            const subtotalAfterDiscount = DecimalConverter.subtractAsNumber(subtotal, discountAmount);
+            const total = DecimalConverter.addAsNumber(subtotalAfterDiscount, taxAmount);
+            return {
+                unitPrice,
+                quantity,
+                subtotal,
+                discountAmount,
+                subtotalAfterDiscount,
+                taxAmount,
+                total,
+            };
+        }
+        catch (error) {
+            throw new PricingCalculationError('calcularTotalLinea', error);
+        }
+    }
+    /**
+     * Calcula el subtotal antes de aplicar descuentos
+     * @param unitPrice - Precio por unidad
+     * @param quantity - Cantidad de productos
+     * @returns Subtotal calculado
+     * @example
+     * ```typescript
+     * const subtotal = calculadora.calculateSubtotal(25, 4); // 100
+     * ```
+     */
+    calculateSubtotal(unitPrice, quantity) {
+        return DecimalConverter.multiplyAsNumber(unitPrice, quantity);
+    }
+}
+//# sourceMappingURL=line-item.calculator.js.map

package/src/lib/pricing/calculations/line-item.calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-item.calculator.js","sourceRoot":"","sources":["../../../../../../../packages/core/src/lib/pricing/calculations/line-item.calculator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAC7B,YAAoB,YAAY,CAAC;QAAb,cAAS,GAAT,SAAS,CAAI;IAAG,CAAC;IAErC;;;;;;;;;;;;;OAaG;IACH,sBAAsB,CACpB,SAAiB,EACjB,QAAgB,EAChB,cAAc,GAAG,CAAC,EAClB,SAAS,GAAG,CAAC;QAEb,IAAI,CAAC;YACH,kBAAkB,CAAC,sBAAsB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAClE,kBAAkB,CAAC,sBAAsB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YAChE,kBAAkB,CAAC,sBAAsB,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;YAC5E,kBAAkB,CAAC,sBAAsB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAElE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACxE,MAAM,qBAAqB,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;YAC1F,MAAM,KAAK,GAAG,gBAAgB,CAAC,WAAW,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC;YAE7E,OAAO;gBACL,SAAS;gBACT,QAAQ;gBACR,QAAQ;gBACR,cAAc;gBACd,qBAAqB;gBACrB,SAAS;gBACT,KAAK;aACN,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,uBAAuB,CAAC,oBAAoB,EAAE,KAAc,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,iBAAiB,CAAC,SAAiB,EAAE,QAAgB;QACnD,OAAO,gBAAgB,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAW,CAAC;IAC1E,CAAC;CACF"}

package/src/lib/pricing/calculations/pricing-calculation.error.d.ts

@@ -0,0 +1,3 @@
+export declare class PricingCalculationError extends Error {
+    constructor(operation: string, originalError?: Error);
+}

package/src/lib/pricing/calculations/pricing-calculation.error.js

@@ -0,0 +1,7 @@
+export class PricingCalculationError extends Error {
+    constructor(operation, originalError) {
+        super(`Pricing calculation failed for operation: ${operation}. ${originalError?.message || ''}`);
+        this.name = 'PricingCalculationError';
+    }
+}
+//# sourceMappingURL=pricing-calculation.error.js.map

package/src/lib/pricing/calculations/pricing-calculation.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing-calculation.error.js","sourceRoot":"","sources":["../../../../../../../packages/core/src/lib/pricing/calculations/pricing-calculation.error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,SAAiB,EAAE,aAAqB;QAClD,KAAK,CACH,6CAA6C,SAAS,KAAK,aAAa,EAAE,OAAO,IAAI,EAAE,EAAE,CAC1F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}

package/src/lib/pricing/calculations/pricing.calculator.d.ts

@@ -0,0 +1,15 @@
+import { DiscountCalculator } from './discount.calculator';
+import { LineItemCalculator } from './line-item.calculator';
+import { ProfitCalculator } from './profit.calculator';
+import { TaxCalculator } from './tax.calculator';
+import { PricingConfig } from '../../types';
+export declare class PricingCalculator {
+    private config;
+    readonly tax: TaxCalculator;
+    readonly discount: DiscountCalculator;
+    readonly profit: ProfitCalculator;
+    readonly lineItem: LineItemCalculator;
+    constructor(config?: PricingConfig);
+    updateConfig(newConfig: Partial<PricingConfig>): void;
+    getConfig(): PricingConfig;
+}

package/src/lib/pricing/calculations/pricing.calculator.js

@@ -0,0 +1,24 @@
+import { DiscountCalculator } from './discount.calculator';
+import { LineItemCalculator } from './line-item.calculator';
+import { ProfitCalculator } from './profit.calculator';
+import { TaxCalculator } from './tax.calculator';
+export class PricingCalculator {
+    constructor(config = {}) {
+        this.config = {
+            defaultDecimals: config.defaultDecimals ?? 4,
+            roundingMode: config.roundingMode ?? 'round',
+            errorHandling: config.errorHandling ?? 'throw',
+        };
+        this.tax = new TaxCalculator(this.config.defaultDecimals);
+        this.discount = new DiscountCalculator(this.config.defaultDecimals);
+        this.profit = new ProfitCalculator(this.config.defaultDecimals);
+        this.lineItem = new LineItemCalculator(this.config.defaultDecimals);
+    }
+    updateConfig(newConfig) {
+        this.config = { ...this.config, ...newConfig };
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+}
+//# sourceMappingURL=pricing.calculator.js.map

package/src/lib/pricing/calculations/pricing.calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.calculator.js","sourceRoot":"","sources":["../../../../../../../packages/core/src/lib/pricing/calculations/pricing.calculator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,MAAM,OAAO,iBAAiB;IAO5B,YAAY,SAAwB,EAAE;QACpC,IAAI,CAAC,MAAM,GAAG;YACZ,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,CAAC;YAC5C,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,OAAO;YAC5C,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,OAAO;SAC/C,CAAC;QAEF,IAAI,CAAC,GAAG,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC1D,IAAI,CAAC,QAAQ,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAChE,IAAI,CAAC,QAAQ,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACtE,CAAC;IAED,YAAY,CAAC,SAAiC;QAC5C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;IACjD,CAAC;IAED,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/src/lib/pricing/calculations/profit.calculator.d.ts

@@ -0,0 +1,56 @@
+import { ProfitMarginCalculation } from '../../types';
+/**
+ * Calculadora especializada para márgenes de ganancia y utilidades
+ */
+export declare class ProfitCalculator {
+    private decimals;
+    constructor(decimals?: number);
+    /**
+     * Calcula el precio de venta a partir del costo y el margen de ganancia
+     * @param cost - Costo del producto o servicio
+     * @param profitMarginPercentage - Porcentaje de margen de ganancia deseado
+     * @returns Precio de venta calculado
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const precioVenta = calculadora.calculateSalePriceFromMargin(80, 25); // 100
+     * ```
+     */
+    calculateSalePriceFromMargin(cost: number, profitMarginPercentage: number): number;
+    /**
+     * Calcula el porcentaje de margen de ganancia a partir del precio de venta y costo
+     * @param salePrice - Precio de venta del producto
+     * @param cost - Costo del producto
+     * @returns Porcentaje de margen de ganancia
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const margen = calculadora.calculateProfitMarginPercentage(100, 80); // 25
+     * ```
+     */
+    calculateProfitMarginPercentage(salePrice: number, cost: number): number;
+    /**
+     * Calcula el valor de la ganancia
+     * @param salePrice - Precio de venta
+     * @param cost - Costo del producto
+     * @returns Valor de la ganancia obtenida
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const ganancia = calculadora.calculateProfitAmount(100, 80); // 20
+     * ```
+     */
+    calculateProfitAmount(salePrice: number, cost: number): number;
+    /**
+     * Obtiene los detalles completos del cálculo de ganancia
+     * @param salePrice - Precio de venta
+     * @param cost - Costo del producto
+     * @returns Objeto con todos los detalles del cálculo
+     * @example
+     * ```typescript
+     * const detalles = calculadora.obtenerDetallesCalculoGanancia(100, 80);
+     * // { salePrice: 100, cost: 80, profitAmount: 20, profitMargin: 25 }
+     * ```
+     */
+    getProfitCalculationDetails(salePrice: number, cost: number): ProfitMarginCalculation;
+}

package/src/lib/pricing/calculations/profit.calculator.js

@@ -0,0 +1,102 @@
+import { DecimalConverter, InvalidParameterError, ParameterValidator } from '@acontplus/utils';
+import { PricingCalculationError } from './pricing-calculation.error';
+/**
+ * Calculadora especializada para márgenes de ganancia y utilidades
+ */
+export class ProfitCalculator {
+    constructor(decimals = 4) {
+        this.decimals = decimals;
+    }
+    /**
+     * Calcula el precio de venta a partir del costo y el margen de ganancia
+     * @param cost - Costo del producto o servicio
+     * @param profitMarginPercentage - Porcentaje de margen de ganancia deseado
+     * @returns Precio de venta calculado
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const precioVenta = calculadora.calculateSalePriceFromMargin(80, 25); // 100
+     * ```
+     */
+    calculateSalePriceFromMargin(cost, profitMarginPercentage) {
+        try {
+            ParameterValidator.validatePositiveNumber(cost, 'cost');
+            ParameterValidator.validatePositiveNumber(profitMarginPercentage, 'profitMarginPercentage');
+            const marginMultiplier = DecimalConverter.divideAsNumber(profitMarginPercentage, 100);
+            const profitAmount = DecimalConverter.multiplyAsNumber(cost, marginMultiplier);
+            return DecimalConverter.addAsNumber(cost, profitAmount);
+        }
+        catch (error) {
+            throw new PricingCalculationError('calculateSalePriceFromMargin', error);
+        }
+    }
+    /**
+     * Calcula el porcentaje de margen de ganancia a partir del precio de venta y costo
+     * @param salePrice - Precio de venta del producto
+     * @param cost - Costo del producto
+     * @returns Porcentaje de margen de ganancia
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const margen = calculadora.calculateProfitMarginPercentage(100, 80); // 25
+     * ```
+     */
+    calculateProfitMarginPercentage(salePrice, cost) {
+        try {
+            ParameterValidator.validatePositiveNumber(salePrice, 'salePrice');
+            ParameterValidator.validatePositiveNumber(cost, 'cost');
+            if (salePrice < cost) {
+                throw new InvalidParameterError('salePrice', 'El precio de venta no puede ser menor que el costo');
+            }
+            const profitAmount = DecimalConverter.subtractAsNumber(salePrice, cost);
+            const profitRatio = DecimalConverter.divideAsNumber(profitAmount, cost);
+            return DecimalConverter.multiplyAsNumber(profitRatio, 100);
+        }
+        catch (error) {
+            throw new PricingCalculationError('calculateProfitMarginPercentage', error);
+        }
+    }
+    /**
+     * Calcula el valor de la ganancia
+     * @param salePrice - Precio de venta
+     * @param cost - Costo del producto
+     * @returns Valor de la ganancia obtenida
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const ganancia = calculadora.calculateProfitAmount(100, 80); // 20
+     * ```
+     */
+    calculateProfitAmount(salePrice, cost) {
+        try {
+            ParameterValidator.validatePositiveNumber(salePrice, 'salePrice');
+            ParameterValidator.validatePositiveNumber(cost, 'cost');
+            return DecimalConverter.subtractAsNumber(salePrice, cost);
+        }
+        catch (error) {
+            throw new PricingCalculationError('calculateProfitAmount', error);
+        }
+    }
+    /**
+     * Obtiene los detalles completos del cálculo de ganancia
+     * @param salePrice - Precio de venta
+     * @param cost - Costo del producto
+     * @returns Objeto con todos los detalles del cálculo
+     * @example
+     * ```typescript
+     * const detalles = calculadora.obtenerDetallesCalculoGanancia(100, 80);
+     * // { salePrice: 100, cost: 80, profitAmount: 20, profitMargin: 25 }
+     * ```
+     */
+    getProfitCalculationDetails(salePrice, cost) {
+        const profitAmount = this.calculateProfitAmount(salePrice, cost);
+        const profitMargin = this.calculateProfitMarginPercentage(salePrice, cost);
+        return {
+            salePrice,
+            cost,
+            profitAmount,
+            profitMargin,
+        };
+    }
+}
+//# sourceMappingURL=profit.calculator.js.map

package/src/lib/pricing/calculations/profit.calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profit.calculator.js","sourceRoot":"","sources":["../../../../../../../packages/core/src/lib/pricing/calculations/profit.calculator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAGtE;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAC3B,YAAoB,WAAW,CAAC;QAAZ,aAAQ,GAAR,QAAQ,CAAI;IAAG,CAAC;IAEpC;;;;;;;;;;OAUG;IACH,4BAA4B,CAAC,IAAY,EAAE,sBAA8B;QACvE,IAAI,CAAC;YACH,kBAAkB,CAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACxD,kBAAkB,CAAC,sBAAsB,CAAC,sBAAsB,EAAE,wBAAwB,CAAC,CAAC;YAE5F,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,cAAc,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;YACtF,MAAM,YAAY,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;YAC/E,OAAO,gBAAgB,CAAC,WAAW,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,uBAAuB,CAAC,8BAA8B,EAAE,KAAc,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,+BAA+B,CAAC,SAAiB,EAAE,IAAY;QAC7D,IAAI,CAAC;YACH,kBAAkB,CAAC,sBAAsB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAClE,kBAAkB,CAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAExD,IAAI,SAAS,GAAG,IAAI,EAAE,CAAC;gBACrB,MAAM,IAAI,qBAAqB,CAC7B,WAAW,EACX,oDAAoD,CACrD,CAAC;YACJ,CAAC;YAED,MAAM,YAAY,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACxE,MAAM,WAAW,GAAG,gBAAgB,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YACxE,OAAO,gBAAgB,CAAC,gBAAgB,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,uBAAuB,CAAC,iCAAiC,EAAE,KAAc,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,qBAAqB,CAAC,SAAiB,EAAE,IAAY;QACnD,IAAI,CAAC;YACH,kBAAkB,CAAC,sBAAsB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAClE,kBAAkB,CAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAExD,OAAO,gBAAgB,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAW,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,uBAAuB,CAAC,uBAAuB,EAAE,KAAc,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,2BAA2B,CAAC,SAAiB,EAAE,IAAY;QACzD,MAAM,YAAY,GAAG,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACjE,MAAM,YAAY,GAAG,IAAI,CAAC,+BAA+B,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAE3E,OAAO;YACL,SAAS;YACT,IAAI;YACJ,YAAY;YACZ,YAAY;SACb,CAAC;IACJ,CAAC;CACF"}

package/src/lib/pricing/calculations/tax.calculator.d.ts

@@ -0,0 +1,57 @@
+import { TaxCalculation } from '../../types';
+/**
+ * Calculadora especializada para impuestos (IVA, IGV, etc.)
+ */
+export declare class TaxCalculator {
+    private decimales;
+    constructor(decimales?: number);
+    /**
+     * Calcula el valor del impuesto basado en el precio base y la tasa
+     * @param basePrice - Precio sin impuestos
+     * @param taxRate - Porcentaje del impuesto (ej: 21 para 21%)
+     * @returns Valor del impuesto calculado
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const calculadora = new TaxCalculator();
+     * const valorIva = calculadora.calculateTaxAmount(100, 21); // 21
+     * ```
+     */
+    calculateTaxAmount(basePrice: number, taxRate: number): number;
+    /**
+     * Calcula el precio incluyendo impuestos
+     * @param basePrice - Precio sin impuestos
+     * @param taxRate - Porcentaje del impuesto
+     * @returns Precio total con impuestos incluidos
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const precioConIva = calculadora.calculatePriceWithTax(100, 21); // 121
+     * ```
+     */
+    calculatePriceWithTax(basePrice: number, taxRate: number): number;
+    /**
+     * Calcula el precio base a partir de un precio que ya incluye impuestos
+     * @param priceWithTax - Precio que incluye impuestos
+     * @param taxRate - Porcentaje del impuesto aplicado
+     * @returns Precio base sin impuestos
+     * @throws {PricingCalculationError} Si ocurre un error en el cálculo
+     * @example
+     * ```typescript
+     * const precioBase = calculadora.calculateBasePriceFromTaxIncluded(121, 21); // 100
+     * ```
+     */
+    calculateBasePriceFromTaxIncluded(priceWithTax: number, taxRate: number): number;
+    /**
+     * Obtiene los detalles completos del cálculo de impuestos
+     * @param basePrice - Precio sin impuestos
+     * @param taxRate - Porcentaje del impuesto
+     * @returns Objeto con todos los detalles del cálculo
+     * @example
+     * ```typescript
+     * const detalles = calculadora.getTaxCalculationDetails(100, 21);
+     * // { montoBase: 100, taxRate: 21, valorImpuesto: 21, montoTotal: 121 }
+     * ```
+     */
+    getTaxCalculationDetails(basePrice: number, taxRate: number): TaxCalculation;
+}