@novha/calc-engines 7.0.0 → 8.0.0

package/dist/types/mortgage/japan/domain/types.d.ts

@@ -0,0 +1,39 @@
+import { OtherFees } from "../../domain/types";
+export interface MortgageRules {
+    loanConstraints: LoanConstraints;
+    interest: InterestRules;
+    acquisitionTax: AcquisitionTaxRules;
+}
+export interface LoanConstraints {
+    maxLtvPercent: number;
+    maxAmortizationYears: number;
+}
+export interface InterestRules {
+    compounding: 'MONTHLY';
+}
+export interface AcquisitionTaxRules {
+    rate: number;
+}
+export interface AmortizationScheduleItem {
+    year: number;
+    principal: number;
+    interest: number;
+    balance: number;
+}
+export interface MortgageInput {
+    propertyPrice: number;
+    downPayment: number;
+    annualInterestRate: number;
+    amortizationYears: number;
+    isFirstTimeBuyer: boolean;
+}
+export interface MortgageOutput {
+    loanAmount: number;
+    totalMortgage: number;
+    monthlyPayment: number;
+    totalInterestPaid: number;
+    totalPaid: number;
+    acquisitionTax: number;
+    amortizationSchedule: AmortizationScheduleItem[];
+    otherFees: OtherFees;
+}

package/dist/types/mortgage/spain/SpainMortgageService.d.ts

@@ -0,0 +1,4 @@
+import { MortgageInput, MortgageOutput, MortgageRules } from "./domain/types";
+export interface SpainMortgageService {
+    calculate(input: MortgageInput, rules: MortgageRules): MortgageOutput;
+}

package/dist/types/mortgage/spain/SpainMortgageServiceImpl.d.ts

@@ -0,0 +1,8 @@
+import { SpainMortgageService } from "./SpainMortgageService";
+import { MortgageInput, MortgageOutput, MortgageRules } from "./domain/types";
+export declare class SpainMortgageServiceImpl implements SpainMortgageService {
+    calculate(input: MortgageInput, rules: MortgageRules): MortgageOutput;
+    private calculateTransferTax;
+    private calculateAmortizationSchedule;
+    private calculatePayment;
+}

package/dist/types/mortgage/spain/domain/types.d.ts

@@ -0,0 +1,44 @@
+import { OtherFees } from "../../domain/types";
+export interface MortgageRules {
+    loanConstraints: LoanConstraints;
+    interest: InterestRules;
+    transferTax: TransferTaxRules;
+}
+export interface LoanConstraints {
+    maxLtvPercent: number;
+    maxAmortizationYears: number;
+}
+export interface InterestRules {
+    compounding: 'MONTHLY';
+}
+export interface TransferTaxBracket {
+    upTo?: number;
+    above?: number;
+    rate: number;
+}
+export interface TransferTaxRules {
+    brackets: TransferTaxBracket[];
+}
+export interface AmortizationScheduleItem {
+    year: number;
+    principal: number;
+    interest: number;
+    balance: number;
+}
+export interface MortgageInput {
+    propertyPrice: number;
+    downPayment: number;
+    annualInterestRate: number;
+    amortizationYears: number;
+    isFirstTimeBuyer: boolean;
+}
+export interface MortgageOutput {
+    loanAmount: number;
+    totalMortgage: number;
+    monthlyPayment: number;
+    totalInterestPaid: number;
+    totalPaid: number;
+    transferTax: number;
+    amortizationSchedule: AmortizationScheduleItem[];
+    otherFees: OtherFees;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@novha/calc-engines",
-  "version": "7.0.0",
+  "version": "8.0.0",
   "main": "dist/index.js",
   "types": "dist/types/index.d.ts",
   "scripts": {

package/src/capital-gains/brazil/BrazilCapitalGainsService.ts

@@ -0,0 +1,5 @@
+import { Result } from "../domain/types";
+
+export interface BrazilCapitalGainsService {
+    calculate(): Result;
+}

package/src/capital-gains/brazil/BrazilCapitalGainsServiceImpl.ts

@@ -0,0 +1,69 @@
+import { Breakdown, Result } from "../domain/types";
+import { BrazilCapitalGainsService } from "./BrazilCapitalGainsService";
+import { CapitalGainsBracket, Input, Rules } from "./domain/types";
+
+export class BrazilCapitalGainsServiceImpl implements BrazilCapitalGainsService {
+    private _input: Input;
+    private _rules: Rules;
+
+    constructor(input: Input, rules: Rules) {
+        this._input = input;
+        this._rules = rules;
+    }
+
+    calculate(): Result {
+        const gain = this._input.capitalGain;
+
+        if (gain <= 0) {
+            return {
+                taxableGain: 0,
+                capitalGainTax: 0,
+                socialContributions: 0,
+                netInvestmentIncomeTax: 0,
+                totalTax: 0,
+                effectiveRate: 0,
+                breakdowns: [],
+            };
+        }
+
+        const { tax, breakdowns } = this.applyBrackets(gain, this._rules.brackets);
+
+        return {
+            taxableGain: gain,
+            capitalGainTax: tax,
+            socialContributions: 0,
+            netInvestmentIncomeTax: 0,
+            totalTax: tax,
+            effectiveRate: (tax / gain) * 100,
+            breakdowns,
+        };
+    }
+
+    private applyBrackets(
+        gain: number,
+        brackets: CapitalGainsBracket[],
+    ): { tax: number; breakdowns: Breakdown[] } {
+        let tax = 0;
+        const breakdowns: Breakdown[] = [];
+
+        for (const bracket of brackets) {
+            if (gain <= bracket.from) break;
+
+            const upper = bracket.to ?? gain;
+            const taxable = Math.min(upper, gain) - bracket.from;
+
+            if (taxable > 0) {
+                const bracketTax = taxable * bracket.rate;
+                tax += bracketTax;
+                breakdowns.push({
+                    from: `${bracket.from}`,
+                    to: `${bracket.to ?? 'Above'}`,
+                    rate: bracket.rate,
+                    amount: bracketTax,
+                });
+            }
+        }
+
+        return { tax, breakdowns };
+    }
+}

package/src/capital-gains/brazil/domain/types.ts

@@ -0,0 +1,15 @@
+import { Breakdown } from "../../domain/types";
+
+export interface CapitalGainsBracket {
+    from: number;
+    to: number | null;
+    rate: number;
+}
+
+export interface Rules {
+    brackets: CapitalGainsBracket[];
+}
+
+export interface Input {
+    capitalGain: number;
+}

package/src/capital-gains/index.ts

@@ -48,6 +48,34 @@ import {
 } from './germany/domain/types';
 import { Result } from './domain/types';
 
+// Capital Gains - Brazil
+import { BrazilCapitalGainsServiceImpl as BrazilCapitalGainsService } from './brazil/BrazilCapitalGainsServiceImpl';
+import {
+    Input as BrazilCapitalGainsInput,
+    Rules as BrazilCapitalGainsRules
+} from './brazil/domain/types';
+
+// Capital Gains - Spain
+import { SpainCapitalGainsServiceImpl as SpainCapitalGainsService } from './spain/SpainCapitalGainsServiceImpl';
+import {
+    Input as SpainCapitalGainsInput,
+    Rules as SpainCapitalGainsRules
+} from './spain/domain/types';
+
+// Capital Gains - India
+import { IndiaCapitalGainsServiceImpl as IndiaCapitalGainsService } from './india/IndiaCapitalGainsServiceImpl';
+import {
+    Input as IndiaCapitalGainsInput,
+    Rules as IndiaCapitalGainsRules
+} from './india/domain/types';
+
+// Capital Gains - Japan
+import { JapanCapitalGainsServiceImpl as JapanCapitalGainsService } from './japan/JapanCapitalGainsServiceImpl';
+import {
+    Input as JapanCapitalGainsInput,
+    Rules as JapanCapitalGainsRules
+} from './japan/domain/types';
+
 export {
     CanadaCapitalGainsService,
     CanadaCapitalGainsInput,
@@ -70,5 +98,17 @@ export {
     GermanyCapitalGainsService,
     GermanyCapitalGainsInput,
     GermanyCapitalGainsRules,
+    BrazilCapitalGainsService,
+    BrazilCapitalGainsInput,
+    BrazilCapitalGainsRules,
+    SpainCapitalGainsService,
+    SpainCapitalGainsInput,
+    SpainCapitalGainsRules,
+    IndiaCapitalGainsService,
+    IndiaCapitalGainsInput,
+    IndiaCapitalGainsRules,
+    JapanCapitalGainsService,
+    JapanCapitalGainsInput,
+    JapanCapitalGainsRules,
     Result
 };

package/src/capital-gains/india/IndiaCapitalGainsService.ts

@@ -0,0 +1,5 @@
+import { Result } from "../domain/types";
+
+export interface IndiaCapitalGainsService {
+    calculate(): Result;
+}

package/src/capital-gains/india/IndiaCapitalGainsServiceImpl.ts

@@ -0,0 +1,64 @@
+import { Breakdown, Result } from "../domain/types";
+import { IndiaCapitalGainsService } from "./IndiaCapitalGainsService";
+import { Input, Rules } from "./domain/types";
+
+export class IndiaCapitalGainsServiceImpl implements IndiaCapitalGainsService {
+    private _input: Input;
+    private _rules: Rules;
+
+    constructor(input: Input, rules: Rules) {
+        this._input = input;
+        this._rules = rules;
+    }
+
+    calculate(): Result {
+        const gain = this._input.capitalGain;
+
+        if (gain <= 0) {
+            return {
+                taxableGain: 0,
+                capitalGainTax: 0,
+                socialContributions: 0,
+                netInvestmentIncomeTax: 0,
+                totalTax: 0,
+                effectiveRate: 0,
+                breakdowns: [],
+            };
+        }
+
+        const isLongTerm = this._input.holdingPeriodMonths >= 12;
+        const breakdowns: Breakdown[] = [];
+        let tax = 0;
+
+        if (isLongTerm) {
+            const taxableGain = Math.max(0, gain - this._rules.longTermExemption);
+            tax = taxableGain * this._rules.longTermRate;
+            if (taxableGain > 0) {
+                breakdowns.push({
+                    from: `${this._rules.longTermExemption}`,
+                    to: 'Above',
+                    rate: this._rules.longTermRate,
+                    amount: tax,
+                });
+            }
+        } else {
+            tax = gain * this._rules.shortTermRate;
+            breakdowns.push({
+                from: '0',
+                to: 'All',
+                rate: this._rules.shortTermRate,
+                amount: tax,
+            });
+        }
+
+        return {
+            taxableGain: gain,
+            capitalGainTax: tax,
+            socialContributions: 0,
+            netInvestmentIncomeTax: 0,
+            totalTax: tax,
+            effectiveRate: gain > 0 ? (tax / gain) * 100 : 0,
+            breakdowns,
+        };
+    }
+}

package/src/capital-gains/india/domain/types.ts

@@ -0,0 +1,12 @@
+import { Breakdown } from "../../domain/types";
+
+export interface Rules {
+    shortTermRate: number;
+    longTermRate: number;
+    longTermExemption: number;
+}
+
+export interface Input {
+    capitalGain: number;
+    holdingPeriodMonths: number;
+}

package/src/capital-gains/japan/JapanCapitalGainsService.ts

@@ -0,0 +1,5 @@
+import { Result } from "../domain/types";
+
+export interface JapanCapitalGainsService {
+    calculate(): Result;
+}

package/src/capital-gains/japan/JapanCapitalGainsServiceImpl.ts

@@ -0,0 +1,47 @@
+import { Breakdown, Result } from "../domain/types";
+import { JapanCapitalGainsService } from "./JapanCapitalGainsService";
+import { Input, Rules } from "./domain/types";
+
+export class JapanCapitalGainsServiceImpl implements JapanCapitalGainsService {
+    private _input: Input;
+    private _rules: Rules;
+
+    constructor(input: Input, rules: Rules) {
+        this._input = input;
+        this._rules = rules;
+    }
+
+    calculate(): Result {
+        const gain = this._input.capitalGain;
+
+        if (gain <= 0) {
+            return {
+                taxableGain: 0,
+                capitalGainTax: 0,
+                socialContributions: 0,
+                netInvestmentIncomeTax: 0,
+                totalTax: 0,
+                effectiveRate: 0,
+                breakdowns: [],
+            };
+        }
+
+        const tax = gain * this._rules.flatRate;
+        const breakdowns: Breakdown[] = [{
+            from: '0',
+            to: 'All',
+            rate: this._rules.flatRate,
+            amount: tax,
+        }];
+
+        return {
+            taxableGain: gain,
+            capitalGainTax: tax,
+            socialContributions: 0,
+            netInvestmentIncomeTax: 0,
+            totalTax: tax,
+            effectiveRate: (tax / gain) * 100,
+            breakdowns,
+        };
+    }
+}

package/src/capital-gains/japan/domain/types.ts

@@ -0,0 +1,9 @@
+import { Breakdown } from "../../domain/types";
+
+export interface Rules {
+    flatRate: number;
+}
+
+export interface Input {
+    capitalGain: number;
+}

package/src/capital-gains/spain/SpainCapitalGainsService.ts

@@ -0,0 +1,5 @@
+import { Result } from "../domain/types";
+
+export interface SpainCapitalGainsService {
+    calculate(): Result;
+}

package/src/capital-gains/spain/SpainCapitalGainsServiceImpl.ts

@@ -0,0 +1,69 @@
+import { Breakdown, Result } from "../domain/types";
+import { SpainCapitalGainsService } from "./SpainCapitalGainsService";
+import { CapitalGainsBracket, Input, Rules } from "./domain/types";
+
+export class SpainCapitalGainsServiceImpl implements SpainCapitalGainsService {
+    private _input: Input;
+    private _rules: Rules;
+
+    constructor(input: Input, rules: Rules) {
+        this._input = input;
+        this._rules = rules;
+    }
+
+    calculate(): Result {
+        const gain = this._input.capitalGain;
+
+        if (gain <= 0) {
+            return {
+                taxableGain: 0,
+                capitalGainTax: 0,
+                socialContributions: 0,
+                netInvestmentIncomeTax: 0,
+                totalTax: 0,
+                effectiveRate: 0,
+                breakdowns: [],
+            };
+        }
+
+        const { tax, breakdowns } = this.applyBrackets(gain, this._rules.brackets);
+
+        return {
+            taxableGain: gain,
+            capitalGainTax: tax,
+            socialContributions: 0,
+            netInvestmentIncomeTax: 0,
+            totalTax: tax,
+            effectiveRate: (tax / gain) * 100,
+            breakdowns,
+        };
+    }
+
+    private applyBrackets(
+        gain: number,
+        brackets: CapitalGainsBracket[],
+    ): { tax: number; breakdowns: Breakdown[] } {
+        let tax = 0;
+        const breakdowns: Breakdown[] = [];
+
+        for (const bracket of brackets) {
+            if (gain <= bracket.from) break;
+
+            const upper = bracket.to ?? gain;
+            const taxable = Math.min(upper, gain) - bracket.from;
+
+            if (taxable > 0) {
+                const bracketTax = taxable * bracket.rate;
+                tax += bracketTax;
+                breakdowns.push({
+                    from: `${bracket.from}`,
+                    to: `${bracket.to ?? 'Above'}`,
+                    rate: bracket.rate,
+                    amount: bracketTax,
+                });
+            }
+        }
+
+        return { tax, breakdowns };
+    }
+}

package/src/capital-gains/spain/domain/types.ts

@@ -0,0 +1,15 @@
+import { Breakdown } from "../../domain/types";
+
+export interface CapitalGainsBracket {
+    from: number;
+    to: number | null;
+    rate: number;
+}
+
+export interface Rules {
+    brackets: CapitalGainsBracket[];
+}
+
+export interface Input {
+    capitalGain: number;
+}

package/src/corporate/brazil/BrazilCorporateTaxService.ts

@@ -0,0 +1,5 @@
+import { Result } from "./domain/types";
+
+export interface BrazilCorporateTaxService {
+    calculate(): Result;
+}

package/src/corporate/brazil/BrazilCorporateTaxServiceImpl.ts

@@ -0,0 +1,40 @@
+import { Breakdown } from "../domain/types";
+import { BrazilCorporateTaxService } from "./BrazilCorporateTaxService";
+import { Input, Result, Rules } from "./domain/types";
+
+export class BrazilCorporateTaxServiceImpl implements BrazilCorporateTaxService {
+    private _input: Input;
+    private _rules: Rules;
+
+    constructor(input: Input, rules: Rules) {
+        this._input = input;
+        this._rules = rules;
+    }
+
+    calculate(): Result {
+        const income = this._input.taxableIncome;
+
+        if (income <= 0) {
+            return { corporateTax: 0, effectiveTaxRate: 0, breakdowns: [] };
+        }
+
+        const irpjBase = income * this._rules.irpj.baseRate;
+        const surcharge = income > this._rules.irpj.surchargeThreshold
+            ? (income - this._rules.irpj.surchargeThreshold) * this._rules.irpj.surchargeRate
+            : 0;
+        const csll = income * this._rules.csll.rate;
+        const corporateTax = irpjBase + surcharge + csll;
+
+        const breakdowns: Breakdown[] = [
+            { from: '0', to: 'All', rate: this._rules.irpj.baseRate, amount: irpjBase },
+            { from: `${this._rules.irpj.surchargeThreshold}`, to: 'Surcharge', rate: this._rules.irpj.surchargeRate, amount: surcharge },
+            { from: '0', to: 'CSLL', rate: this._rules.csll.rate, amount: csll },
+        ];
+
+        return {
+            corporateTax,
+            effectiveTaxRate: (corporateTax / income) * 100,
+            breakdowns,
+        };
+    }
+}

package/src/corporate/brazil/domain/types.ts

@@ -0,0 +1,16 @@
+import { Breakdown } from "../../domain/types";
+
+export interface Rules {
+    irpj: { baseRate: number; surchargeRate: number; surchargeThreshold: number };
+    csll: { rate: number };
+}
+
+export interface Input {
+    taxableIncome: number;
+}
+
+export interface Result {
+    corporateTax: number;
+    effectiveTaxRate: number;
+    breakdowns: Breakdown[];
+}

package/src/corporate/index.ts

@@ -47,6 +47,34 @@ import {
     Result as CanadaCorporateTaxResult,
 } from './canada/domain/types';
 
+import { BrazilCorporateTaxServiceImpl as BrazilCorporateTaxService } from './brazil/BrazilCorporateTaxServiceImpl';
+import {
+    Input as BrazilCorporateTaxInput,
+    Rules as BrazilCorporateTaxRules,
+    Result as BrazilCorporateTaxResult,
+} from './brazil/domain/types';
+
+import { SpainCorporateTaxServiceImpl as SpainCorporateTaxService } from './spain/SpainCorporateTaxServiceImpl';
+import {
+    Input as SpainCorporateTaxInput,
+    Rules as SpainCorporateTaxRules,
+    Result as SpainCorporateTaxResult,
+} from './spain/domain/types';
+
+import { IndiaCorporateTaxServiceImpl as IndiaCorporateTaxService } from './india/IndiaCorporateTaxServiceImpl';
+import {
+    Input as IndiaCorporateTaxInput,
+    Rules as IndiaCorporateTaxRules,
+    Result as IndiaCorporateTaxResult,
+} from './india/domain/types';
+
+import { JapanCorporateTaxServiceImpl as JapanCorporateTaxService } from './japan/JapanCorporateTaxServiceImpl';
+import {
+    Input as JapanCorporateTaxInput,
+    Rules as JapanCorporateTaxRules,
+    Result as JapanCorporateTaxResult,
+} from './japan/domain/types';
+
 export {
     USACorporateTaxService,
     USACorporateTaxInput,
@@ -75,5 +103,21 @@ export {
     CanadaCorporateTaxService,
     CanadaCorporateTaxInput,
     CanadaCorporateTaxRules,
-    CanadaCorporateTaxResult
+    CanadaCorporateTaxResult,
+    BrazilCorporateTaxService,
+    BrazilCorporateTaxInput,
+    BrazilCorporateTaxRules,
+    BrazilCorporateTaxResult,
+    SpainCorporateTaxService,
+    SpainCorporateTaxInput,
+    SpainCorporateTaxRules,
+    SpainCorporateTaxResult,
+    IndiaCorporateTaxService,
+    IndiaCorporateTaxInput,
+    IndiaCorporateTaxRules,
+    IndiaCorporateTaxResult,
+    JapanCorporateTaxService,
+    JapanCorporateTaxInput,
+    JapanCorporateTaxRules,
+    JapanCorporateTaxResult
 };

package/src/corporate/india/IndiaCorporateTaxService.ts

@@ -0,0 +1,5 @@
+import { Result } from "./domain/types";
+
+export interface IndiaCorporateTaxService {
+    calculate(): Result;
+}

package/src/corporate/india/IndiaCorporateTaxServiceImpl.ts

@@ -0,0 +1,35 @@
+import { Breakdown } from "../domain/types";
+import { IndiaCorporateTaxService } from "./IndiaCorporateTaxService";
+import { Input, Result, Rules } from "./domain/types";
+
+export class IndiaCorporateTaxServiceImpl implements IndiaCorporateTaxService {
+    private _input: Input;
+    private _rules: Rules;
+
+    constructor(input: Input, rules: Rules) {
+        this._input = input;
+        this._rules = rules;
+    }
+
+    calculate(): Result {
+        const income = this._input.taxableIncome;
+
+        if (income <= 0) {
+            return { corporateTax: 0, effectiveTaxRate: 0, breakdowns: [] };
+        }
+
+        const tax = income * this._rules.regime.rate;
+        const breakdowns: Breakdown[] = [{
+            from: '0',
+            to: 'All',
+            rate: this._rules.regime.rate,
+            amount: tax,
+        }];
+
+        return {
+            corporateTax: tax,
+            effectiveTaxRate: (tax / income) * 100,
+            breakdowns,
+        };
+    }
+}

package/src/corporate/india/domain/types.ts

@@ -0,0 +1,15 @@
+import { Breakdown } from "../../domain/types";
+
+export interface Rules {
+    regime: { type: 'flat'; rate: number };
+}
+
+export interface Input {
+    taxableIncome: number;
+}
+
+export interface Result {
+    corporateTax: number;
+    effectiveTaxRate: number;
+    breakdowns: Breakdown[];
+}