social-security-calculator 1.0.3 → 3.0.0

package/lib/constants.d.ts

@@ -1,10 +1,15 @@
 export declare const EARLY_RETIREMENT_AGE = 62;
 export declare const WAGE_INDEX_CUTOFF = 2023;
 export declare const MAX_RETIREMENT_AGE = 70;
-export declare const LOOKBACK_YEARS = 35;
+export declare const LOOKBACK_YEARS = 40;
+export declare const MAX_DROP_OUT_YEARS = 5;
+export declare const DROP_OUT_YEARS_DIVISOR = 5;
+export declare const ELAPSED_YEARS_START_AGE = 22;
 export declare const BEND_POINT_DIVISOR = 9779.44;
 export declare const FIRST_BEND_POINT_MULTIPLIER = 180;
 export declare const SECOND_BEND_POINT_MULTIPLIER = 1085;
+export declare const FAM_MAX_BASES: number[];
+export declare const CHILD_SURVIVOR_BENEFIT_PERCENTAGE = 0.75;
 export declare const PIA_PERCENTAGES: {
     readonly FIRST_BRACKET: 0.9;
     readonly SECOND_BRACKET: 0.32;

package/lib/constants.js

@@ -2,10 +2,19 @@
 export const EARLY_RETIREMENT_AGE = 62;
 export const WAGE_INDEX_CUTOFF = 2023;
 export const MAX_RETIREMENT_AGE = 70;
-export const LOOKBACK_YEARS = 35;
-export const BEND_POINT_DIVISOR = 9779.44;
+// LOOKBACK_YEARS This represents the working years between 22 and 62,
+// but it does not filter out the wages of years before and after that range.
+// There is also a drop out of 5 years, to intentionally ignore the lowest 5 years of earnings.
+// Therefore the effective lookback years for Reitirement AIME is 35 years (62 - 22 = 40, minus 5 drop out = 35).
+export const LOOKBACK_YEARS = 40;
+export const MAX_DROP_OUT_YEARS = 5; // Number of years to drop out for AIME calculation
+export const DROP_OUT_YEARS_DIVISOR = 5; // Number of years to divide by for AIME calculation
+export const ELAPSED_YEARS_START_AGE = 22;
+export const BEND_POINT_DIVISOR = 9779.44; // 1977's AWI - used by dividing against current AWI
 export const FIRST_BEND_POINT_MULTIPLIER = 180;
 export const SECOND_BEND_POINT_MULTIPLIER = 1085;
+export const FAM_MAX_BASES = [230, 332, 433];
+export const CHILD_SURVIVOR_BENEFIT_PERCENTAGE = 0.75; // 75% of PIA for child survivor benefits
 export const PIA_PERCENTAGES = {
     FIRST_BRACKET: 0.9,
     SECOND_BRACKET: 0.32,
@@ -13,6 +22,6 @@ export const PIA_PERCENTAGES = {
 };
 export const EARLY_RETIREMENT_REDUCTION = {
     FIRST_MONTHS: 36,
-    FIRST_MONTHS_RATE: 5 / 9 * 0.01,
+    FIRST_MONTHS_RATE: 5 / 9 * 0.01, // 5/9 of 1%
     ADDITIONAL_MONTHS_RATE: 5 / 12 * 0.01 // 5/12 of 1%
 };

package/lib/index.d.ts

@@ -1,7 +1,15 @@
-import { BenefitCalculationResult, Earnings } from './model';
+import { BenefitCalculationResult, RetirementDates, Earnings } from './model';
 export declare function calc(birthday: Date, retirementDate: Date, earnings: Earnings): BenefitCalculationResult;
-export declare function calcRetirementBenefit(birthday: Date, retirementDate: Date, AIME: number): BenefitCalculationResult;
+export declare function calcRetirement(birthday: Date, retirementDate: Date, earnings: Earnings): Partial<BenefitCalculationResult>;
+export declare function calculateRetirementDates(birthday: Date, retirementDate: Date): RetirementDates;
+export declare function retirementDateAdjustedPayment(dates: RetirementDates, colaAdjustedPIA: number): number;
 export declare function calculatePIA(AIME: number, baseYear?: number): number;
-export declare function calculateAIME(earnings: Earnings, baseYear?: number): number;
-export declare function getEnglishCommonLawDate(date: Date): Date;
+export declare function calculateAIME(earnings: Earnings, lookbackYears: number, baseYear?: number): number;
+export declare function getLookbackYears(elapsedYears: number): number;
+export declare function getLookbackYearsDisability(elapsedYears: number): number;
 export declare function getFullRetirementMonths(commonLawBirthDate: Date): number;
+/** Compute Family-Max bend points for an eligibility year given AWI_{year-2}. */
+export declare function getFamilyMaxBendPoints(baseYear: number): [number, number, number];
+/** Apply the family-maximum formula to a PIA using already-computed bend points. */
+export declare function calculateFamilyMaximum(pia: number, [bp1, bp2, bp3]: [number, number, number]): number;
+export declare function getEnglishCommonLawDate(date: Date): Date;

package/lib/index.js

@@ -1,8 +1,73 @@
 import { wageIndex } from './wage-index';
-import { EARLY_RETIREMENT_AGE, WAGE_INDEX_CUTOFF, MAX_RETIREMENT_AGE, LOOKBACK_YEARS, BEND_POINT_DIVISOR, FIRST_BEND_POINT_MULTIPLIER, SECOND_BEND_POINT_MULTIPLIER, PIA_PERCENTAGES, EARLY_RETIREMENT_REDUCTION } from './constants';
-// Main calculation function
+import { EARLY_RETIREMENT_AGE, WAGE_INDEX_CUTOFF, MAX_RETIREMENT_AGE, MAX_DROP_OUT_YEARS, DROP_OUT_YEARS_DIVISOR, BEND_POINT_DIVISOR, FIRST_BEND_POINT_MULTIPLIER, SECOND_BEND_POINT_MULTIPLIER, PIA_PERCENTAGES, EARLY_RETIREMENT_REDUCTION, ELAPSED_YEARS_START_AGE, LOOKBACK_YEARS, CHILD_SURVIVOR_BENEFIT_PERCENTAGE, FAM_MAX_BASES } from './constants';
+// Main entry point
 export function calc(birthday, retirementDate, earnings) {
-    // Validation
+    const retirementCalc = calcRetirement(birthday, retirementDate, earnings);
+    const survivorCalc = calcSurvivor(birthday, retirementDate, earnings);
+    retirementCalc.SurvivorBenefits = survivorCalc;
+    return retirementCalc;
+}
+// Core retirement calculation
+export function calcRetirement(birthday, retirementDate, earnings) {
+    const context = createCalculationContext(birthday, retirementDate, earnings);
+    const regularBenefit = calculateBenefitPipeline(earnings, context.yearAge60, getLookbackYears(context.totalYears));
+    const disabilityBenefit = calculateBenefitPipeline(earnings, context.yearAge60, getLookbackYearsDisability(context.totalYears));
+    const monthlyBenefit = retirementDateAdjustedPayment(context.dates, regularBenefit.colaAdjustedPIA);
+    const disabilityPIAFloored = context.retirementDate > context.dates.fullRetirement ? 0 : Math.floor(disabilityBenefit.colaAdjustedPIA);
+    return {
+        AIME: regularBenefit.aime,
+        PIA: regularBenefit.pia,
+        NormalMonthlyBenefit: monthlyBenefit,
+        DisabilityEarnings: disabilityPIAFloored,
+    };
+}
+// Reusable benefit calculation pipeline
+function calculateBenefitPipeline(earnings, yearAge60, lookbackYears) {
+    const aime = calculateAIME(earnings, lookbackYears, yearAge60);
+    const pia = calculatePIA(aime, yearAge60);
+    const colaAdjustedPIA = calculateCOLAAdjustments(pia, yearAge60 + 2);
+    return { aime, pia, colaAdjustedPIA };
+}
+// Survivor benefits calculation
+function calcSurvivor(birthday, retirementDate, earnings) {
+    const context = createCalculationContext(birthday, retirementDate, earnings);
+    const benefit = calculateBenefitPipeline(earnings, context.yearAge60, getLookbackYears(context.totalYears));
+    const survivorPIA = Math.floor(benefit.colaAdjustedPIA * CHILD_SURVIVOR_BENEFIT_PERCENTAGE);
+    const effectiveYear = Math.min(context.yearAge60, WAGE_INDEX_CUTOFF);
+    const wageIndexEntry = getWageIndexEntry(effectiveYear);
+    const wageIndexLastYear = wageIndexEntry.awi;
+    const familyMax = calculateFamilyMaximum(benefit.pia, getFamilyMaxBendPoints(wageIndexLastYear));
+    const colaAdjustedFamMax = calculateCOLAAdjustments(familyMax, context.yearAge60 + 2);
+    return {
+        survivingChild: survivorPIA,
+        careGivingSpouse: survivorPIA,
+        normalRetirementSpouse: Math.floor(benefit.colaAdjustedPIA),
+        familyMaximum: colaAdjustedFamMax
+    };
+}
+// Create shared calculation context to avoid duplication
+function createCalculationContext(birthday, retirementDate, earnings) {
+    validateInputs(birthday, retirementDate, earnings);
+    const dates = calculateRetirementDates(birthday, retirementDate);
+    const yearAge60 = birthday.getFullYear() + 60;
+    const yearStartCounting = birthday.getFullYear() + ELAPSED_YEARS_START_AGE - 1;
+    const dateStartCounting = new Date(birthday);
+    dateStartCounting.setFullYear(yearStartCounting);
+    const monthsDiff = monthsDifference(retirementDate, dateStartCounting) / 12;
+    const totalYears = Math.min(LOOKBACK_YEARS, monthsDiff);
+    return {
+        birthday,
+        retirementDate,
+        earnings,
+        dates,
+        yearAge60,
+        yearStartCounting,
+        dateStartCounting,
+        totalYears
+    };
+}
+// Extracted validation logic
+function validateInputs(birthday, retirementDate, earnings) {
     if (!birthday || !retirementDate) {
         throw new Error('Birthday and retirement date are required');
     }
@@ -12,36 +77,9 @@ export function calc(birthday, retirementDate, earnings) {
     if (retirementDate < birthday) {
         throw new Error('Retirement date cannot be before birthday');
     }
-    const yearAge60 = birthday.getFullYear() + 60;
-    const averageIndexedMonthlyEarnings = calculateAIME(earnings, yearAge60);
-    const results = calcRetirementBenefit(birthday, retirementDate, averageIndexedMonthlyEarnings);
-    return results;
-}
-export function calcRetirementBenefit(birthday, retirementDate, AIME) {
-    const dates = calculateRetirementDates(birthday, retirementDate);
-    const age60Year = dates.eclBirthDate.getFullYear() + 60;
-    const primaryInsuranceAmount = calculatePIA(AIME, age60Year);
-    // Calculate COLA adjustments
-    const colaAdjustedPIA = calculateCOLAAdjustments(primaryInsuranceAmount, age60Year + 2);
-    // Calculate early/delayed retirement adjustments
-    const earlyRetireMonths = monthsDifference(dates.adjusted, dates.fullRetirement);
-    let adjustedBenefits = colaAdjustedPIA;
-    if (retirementDate < dates.earliestRetirement) {
-        adjustedBenefits = 0;
-    }
-    else if (earlyRetireMonths < 0) {
-        adjustedBenefits = calculateEarlyRetirementReduction(colaAdjustedPIA, Math.abs(earlyRetireMonths));
-    }
-    else if (earlyRetireMonths > 0) {
-        adjustedBenefits = calculateDelayedRetirementIncrease(dates.eclBirthDate, colaAdjustedPIA, earlyRetireMonths);
-    }
-    const monthlyBenefit = Math.floor(adjustedBenefits);
-    return {
-        AIME: AIME,
-        NormalMonthlyBenefit: monthlyBenefit,
-    };
 }
-function calculateRetirementDates(birthday, retirementDate) {
+// Retirement date calculations
+export function calculateRetirementDates(birthday, retirementDate) {
     const eclBirthDate = getEnglishCommonLawDate(birthday);
     const fraMonths = getFullRetirementMonths(eclBirthDate);
     const earliestRetirement = new Date(eclBirthDate.getFullYear() + EARLY_RETIREMENT_AGE, eclBirthDate.getMonth(), eclBirthDate.getDate());
@@ -53,9 +91,26 @@ function calculateRetirementDates(birthday, retirementDate) {
         fullRetirement,
         maxRetirement,
         adjusted,
-        eclBirthDate
+        eclBirthDate,
+        retirementDate
     };
 }
+// Benefit amount calculations
+export function retirementDateAdjustedPayment(dates, colaAdjustedPIA) {
+    const earlyRetireMonths = monthsDifference(dates.adjusted, dates.fullRetirement);
+    let adjustedBenefits = colaAdjustedPIA;
+    if (dates.retirementDate < dates.earliestRetirement) {
+        adjustedBenefits = 0;
+    }
+    else if (earlyRetireMonths < 0) {
+        adjustedBenefits = calculateEarlyRetirementReduction(colaAdjustedPIA, Math.abs(earlyRetireMonths));
+    }
+    else if (earlyRetireMonths > 0) {
+        adjustedBenefits = calculateDelayedRetirementIncrease(dates.eclBirthDate, colaAdjustedPIA, earlyRetireMonths);
+    }
+    return Math.floor(adjustedBenefits);
+}
+// COLA adjustments
 function calculateCOLAAdjustments(PIA, startYear) {
     const currentYear = new Date().getFullYear();
     const colaRates = wageIndex
@@ -66,12 +121,10 @@ function calculateCOLAAdjustments(PIA, startYear) {
         return roundToFloorTenCents(adjustedAmount * multiplier);
     }, PIA);
 }
+// PIA calculation
 export function calculatePIA(AIME, baseYear) {
     const effectiveYear = baseYear ? Math.min(baseYear, WAGE_INDEX_CUTOFF) : WAGE_INDEX_CUTOFF;
-    const wageIndexEntry = wageIndex.find(val => val.year === effectiveYear);
-    if (!wageIndexEntry) {
-        throw new Error(`No wage index data found for year ${effectiveYear}`);
-    }
+    const wageIndexEntry = getWageIndexEntry(effectiveYear);
     const wageIndexLastYear = wageIndexEntry.awi;
     // Calculate bend points (rounded to nearest dollar per SSA rules)
     const firstBendPoint = Math.round(FIRST_BEND_POINT_MULTIPLIER * wageIndexLastYear / BEND_POINT_DIVISOR);
@@ -93,15 +146,13 @@ export function calculatePIA(AIME, baseYear) {
     }
     return roundToFloorTenCents(monthlyBenefit);
 }
-export function calculateAIME(earnings, baseYear) {
+// AIME calculation
+export function calculateAIME(earnings, lookbackYears, baseYear) {
     if (!earnings || earnings.length === 0) {
         return 0;
     }
     const effectiveYear = baseYear ? Math.min(baseYear, WAGE_INDEX_CUTOFF) : WAGE_INDEX_CUTOFF;
-    const wageIndexEntry = wageIndex.find(val => val.year === effectiveYear);
-    if (!wageIndexEntry) {
-        throw new Error(`No wage index data found for year ${effectiveYear}`);
-    }
+    const wageIndexEntry = getWageIndexEntry(effectiveYear);
     const wageIndexLastYear = wageIndexEntry.awi;
     const futureYearsFactor = 1;
     // Calculate wage index factors
@@ -114,15 +165,27 @@ export function calculateAIME(earnings, baseYear) {
         acc[year] = earnings * (wageIndexFactors[year] || futureYearsFactor);
         return acc;
     }, {});
-    // Get top 35 years of earnings
-    const top35YearsEarningsArr = Object.values(adjustedEarnings)
+    // Get top years of earnings based on lookback period
+    const topYearsEarningsArr = Object.values(adjustedEarnings)
         .sort((a, b) => b - a)
-        .slice(0, LOOKBACK_YEARS);
-    const totalEarnings = top35YearsEarningsArr.reduce((sum, earnings) => sum + earnings, 0);
+        .slice(0, lookbackYears);
+    const totalEarnings = topYearsEarningsArr.reduce((sum, earnings) => sum + earnings, 0);
     // Calculate AIME (rounded down to next lower dollar)
-    const averageIndexedMonthlyEarnings = Math.floor(totalEarnings / (12 * LOOKBACK_YEARS));
-    return averageIndexedMonthlyEarnings;
+    return Math.floor(totalEarnings / (12 * lookbackYears));
+}
+// Lookback year calculations
+export function getLookbackYears(elapsedYears) {
+    const minComputationYears = 2;
+    const adjustedLookbackYears = Math.floor(elapsedYears) - 5;
+    return Math.max(minComputationYears, adjustedLookbackYears);
 }
+export function getLookbackYearsDisability(elapsedYears) {
+    const minComputationYears = 2;
+    const dropOutYears = Math.min(Math.floor(elapsedYears / DROP_OUT_YEARS_DIVISOR), MAX_DROP_OUT_YEARS);
+    const adjustedLookbackYears = elapsedYears - dropOutYears;
+    return Math.max(minComputationYears, adjustedLookbackYears);
+}
+// Early retirement reduction
 function calculateEarlyRetirementReduction(amount, months) {
     if (months <= 0)
         return amount;
@@ -137,6 +200,7 @@ function calculateEarlyRetirementReduction(amount, months) {
     }
     return amount * (1 - reduction);
 }
+// Delayed retirement increase
 function calculateDelayedRetirementIncrease(birthday, initialAmount, numberOfMonths) {
     if (numberOfMonths <= 0)
         return initialAmount;
@@ -145,11 +209,11 @@ function calculateDelayedRetirementIncrease(birthday, initialAmount, numberOfMon
     const totalIncrease = monthlyRate * numberOfMonths;
     return initialAmount * (1 + totalIncrease);
 }
+// Delayed retirement rate lookup
 function getDelayedRetirementRate(birthYear) {
     if (birthYear < 1933) {
         throw new Error(`Invalid birth year for delayed retirement: ${birthYear}`);
     }
-    // Rates based on SSA rules
     if (birthYear <= 1934)
         return 11 / 24 / 100; // 11/24 of 1%
     if (birthYear <= 1936)
@@ -162,30 +226,19 @@ function getDelayedRetirementRate(birthYear) {
         return 5 / 8 / 100; // 5/8 of 1%
     return 2 / 3 / 100; // 2/3 of 1%
 }
-function roundToFloorTenCents(amount) {
-    // Convert to dimes, floor, then convert back to dollars
-    return Math.floor(amount * 10) / 10;
-}
-export function getEnglishCommonLawDate(date) {
-    // Create a new date to avoid mutating the original
-    const eclDate = new Date(date);
-    eclDate.setDate(eclDate.getDate() - 1);
-    return eclDate;
-}
+// Full retirement age calculation
 export function getFullRetirementMonths(commonLawBirthDate) {
     const year = commonLawBirthDate.getFullYear();
     if (year <= 1937) {
         return 65 * 12;
     }
     else if (year <= 1942) {
-        // Gradual increase from 65 years to 65 years 10 months
         return ((year - 1937) * 2) + (65 * 12);
     }
     else if (year <= 1954) {
         return 66 * 12;
     }
     else if (year <= 1959) {
-        // Gradual increase from 66 years to 66 years 10 months
         return ((year - 1954) * 2) + (66 * 12);
     }
     else if (year >= 1960) {
@@ -195,8 +248,42 @@ export function getFullRetirementMonths(commonLawBirthDate) {
         throw new Error(`Invalid birth year: ${year}`);
     }
 }
+/** Compute Family-Max bend points for an eligibility year given AWI_{year-2}. */
+export function getFamilyMaxBendPoints(baseYear) {
+    const [f1, f2, f3] = FAM_MAX_BASES.map(b => Math.round((b * baseYear / BEND_POINT_DIVISOR)));
+    return [f1, f2, f3];
+}
+/** Apply the family-maximum formula to a PIA using already-computed bend points. */
+export function calculateFamilyMaximum(pia, [bp1, bp2, bp3]) {
+    let max = 0;
+    max += 1.50 * Math.min(pia, bp1);
+    if (pia > bp1)
+        max += 2.72 * (Math.min(pia, bp2) - bp1);
+    if (pia > bp2)
+        max += 1.34 * (Math.min(pia, bp3) - bp2);
+    if (pia > bp3)
+        max += 1.75 * (pia - bp3);
+    // SSA: round total down to next lower $0.10
+    return Math.floor(max * 10) / 10;
+}
+// Utility functions
+export function getEnglishCommonLawDate(date) {
+    const eclDate = new Date(date);
+    eclDate.setDate(eclDate.getDate() - 1);
+    return eclDate;
+}
 function monthsDifference(date1, date2) {
     const months1 = date1.getFullYear() * 12 + date1.getMonth();
     const months2 = date2.getFullYear() * 12 + date2.getMonth();
     return months1 - months2;
 }
+function roundToFloorTenCents(amount) {
+    return Math.floor(amount * 10) / 10;
+}
+function getWageIndexEntry(effectiveYear) {
+    const wageIndexEntry = wageIndex.find(val => val.year === effectiveYear);
+    if (!wageIndexEntry) {
+        throw new Error(`No wage index data found for year ${effectiveYear}`);
+    }
+    return wageIndexEntry;
+}

package/lib/model.d.ts

@@ -2,23 +2,29 @@ export type Earnings = {
     year: number;
     earnings: number;
 }[];
-export type Wage = {
+export type WageIndex = {
     year: number;
-    retirement: number;
-    disability: number;
-    survivors: number;
     taxMax: number;
     cola: number;
     awi: number;
 };
-export type Wages = Wage[];
 export interface BenefitCalculationResult {
     AIME: number;
+    PIA: number;
     NormalMonthlyBenefit: number;
+    DisabilityEarnings: number;
+    SurvivorBenefits: {
+        survivingChild: number;
+        careGivingSpouse: number;
+        normalRetirementSpouse: number;
+        familyMaximum: number;
+    };
 }
 export interface RetirementDates {
     earliestRetirement: Date;
     fullRetirement: Date;
     maxRetirement: Date;
     adjusted: Date;
+    eclBirthDate: Date;
+    retirementDate: Date;
 }

package/lib/wage-index.d.ts

@@ -1,3 +1,3 @@
-import { Wage, Wages } from './model';
-export declare const wageIndex: Wages;
-export declare const wageIndexFuture: Partial<Wage>[];
+import { WageIndex } from './model';
+export declare const wageIndex: WageIndex[];
+export declare const wageIndexFuture: Partial<WageIndex>[];

package/lib/wage-index.js

@@ -2,675 +2,450 @@
 export const wageIndex = [
     {
         "year": 1951,
-        "retirement": 1802.95,
-        "disability": 1802.95,
-        "survivors": 1802.95,
         "taxMax": 3600,
         "cola": 0,
         "awi": 2799.16
     },
     {
         "year": 1952,
-        "retirement": 1697.35,
-        "disability": 1697.35,
-        "survivors": 1697.35,
         "taxMax": 3600,
         "cola": 0,
         "awi": 2973.32
     },
     {
         "year": 1953,
-        "retirement": 1607.53,
-        "disability": 1607.53,
-        "survivors": 1607.53,
         "taxMax": 3600,
         "cola": 0,
         "awi": 3139.44
     },
     {
         "year": 1954,
-        "retirement": 1599.28,
-        "disability": 1599.28,
-        "survivors": 1599.28,
         "taxMax": 3600,
         "cola": 0,
         "awi": 3155.64
     },
     {
         "year": 1955,
-        "retirement": 13757.87,
-        "disability": 13757.87,
-        "survivors": 13757.87,
         "taxMax": 4200,
         "cola": 0,
         "awi": 3301.44
     },
     {
         "year": 1956,
-        "retirement": 13810.96,
-        "disability": 13810.96,
-        "survivors": 13810.96,
         "taxMax": 4200,
         "cola": 0,
         "awi": 3532.36
     },
     {
         "year": 1957,
-        "retirement": 14320.1,
-        "disability": 14320.1,
-        "survivors": 14320.1,
         "taxMax": 4200,
         "cola": 0,
         "awi": 3641.72
     },
     {
         "year": 1958,
-        "retirement": 14195.05,
-        "disability": 14195.05,
-        "survivors": 14195.05,
         "taxMax": 4200,
         "cola": 0,
         "awi": 3673.8
     },
     {
         "year": 1959,
-        "retirement": 14833.9,
-        "disability": 14833.9,
-        "survivors": 14833.9,
         "taxMax": 4800,
         "cola": 0,
         "awi": 3855.8
     },
     {
         "year": 1960,
-        "retirement": 15113.36,
-        "disability": 15113.36,
-        "survivors": 15113.36,
         "taxMax": 4800,
         "cola": 0,
         "awi": 4007.12
     },
     {
         "year": 1961,
-        "retirement": 15230.47,
-        "disability": 15230.47,
-        "survivors": 15230.47,
         "taxMax": 4800,
         "cola": 0,
         "awi": 4086.76
     },
     {
         "year": 1962,
-        "retirement": 15680.21,
-        "disability": 15680.21,
-        "survivors": 15680.21,
         "taxMax": 4800,
         "cola": 0,
         "awi": 4291.4
     },
     {
         "year": 1963,
-        "retirement": 16070.12,
-        "disability": 16070.12,
-        "survivors": 16070.12,
         "taxMax": 4800,
         "cola": 0,
         "awi": 4396.64
     },
     {
         "year": 1964,
-        "retirement": 16174.36,
-        "disability": 16174.36,
-        "survivors": 16174.36,
         "taxMax": 4800,
         "cola": 0,
         "awi": 4576.32
     },
     {
         "year": 1965,
-        "retirement": 16610.47,
-        "disability": 16610.47,
-        "survivors": 16610.47,
         "taxMax": 4800,
         "cola": 0,
         "awi": 4658.72
     },
     {
         "year": 1966,
-        "retirement": 17032.49,
-        "disability": 17032.49,
-        "survivors": 17032.49,
         "taxMax": 6600,
         "cola": 0,
         "awi": 4938.36
     },
     {
         "year": 1967,
-        "retirement": 17101.82,
-        "disability": 17101.82,
-        "survivors": 17101.82,
         "taxMax": 6600,
         "cola": 0,
         "awi": 5213.44
     },
     {
         "year": 1968,
-        "retirement": 17511.62,
-        "disability": 17511.62,
-        "survivors": 17511.62,
         "taxMax": 7800,
         "cola": 0,
         "awi": 5571.76
     },
     {
         "year": 1969,
-        "retirement": 17982.04,
-        "disability": 17982.04,
-        "survivors": 17982.04,
         "taxMax": 7800,
         "cola": 0,
         "awi": 5893.76
     },
     {
         "year": 1970,
-        "retirement": 18219.6,
-        "disability": 18219.6,
-        "survivors": 18219.6,
         "taxMax": 7800,
         "cola": 0,
         "awi": 6186.24
     },
     {
         "year": 1971,
-        "retirement": 18642.54,
-        "disability": 18642.54,
-        "survivors": 18642.54,
         "taxMax": 7800,
         "cola": 0,
         "awi": 6497.08
     },
     {
         "year": 1972,
-        "retirement": 19100.95,
-        "disability": 19100.95,
-        "survivors": 19100.95,
         "taxMax": 9000,
         "cola": 0,
         "awi": 7133.8
     },
     {
         "year": 1973,
-        "retirement": 19307.75,
-        "disability": 19307.75,
-        "survivors": 19307.75,
         "taxMax": 10800,
         "cola": 0,
         "awi": 7580.16
     },
     {
         "year": 1974,
-        "retirement": 19690.74,
-        "disability": 19690.74,
-        "survivors": 19690.74,
         "taxMax": 13200,
         "cola": 0,
         "awi": 8030.76
     },
     {
         "year": 1975,
-        "retirement": 20270.62,
-        "disability": 20270.62,
-        "survivors": 20270.62,
         "taxMax": 14100,
         "cola": 8,
         "awi": 8630.92
     },
     {
         "year": 1976,
-        "retirement": 20603.13,
-        "disability": 20603.13,
-        "survivors": 20603.13,
         "taxMax": 15300,
         "cola": 6.4,
         "awi": 9226.48
     },
     {
         "year": 1977,
-        "retirement": 20986.34,
-        "disability": 20986.34,
-        "survivors": 20986.34,
         "taxMax": 16500,
         "cola": 5.9,
         "awi": 9779.44
     },
     {
         "year": 1978,
-        "retirement": 21354.77,
-        "disability": 21354.77,
-        "survivors": 21354.77,
         "taxMax": 17700,
         "cola": 6.5,
         "awi": 10556.03
     },
     {
         "year": 1979,
-        "retirement": 21835.12,
-        "disability": 21835.12,
-        "survivors": 21835.12,
         "taxMax": 22900,
         "cola": 9.9,
         "awi": 11479.46
     },
     {
         "year": 1980,
-        "retirement": 22316.26,
-        "disability": 22316.26,
-        "survivors": 22316.26,
         "taxMax": 25900,
         "cola": 14.3,
         "awi": 12513.46
     },
     {
         "year": 1981,
-        "retirement": 22718.1,
-        "disability": 22718.1,
-        "survivors": 22718.1,
         "taxMax": 29700,
         "cola": 11.2,
         "awi": 13773.1
     },
     {
         "year": 1982,
-        "retirement": 23153.42,
-        "disability": 23153.42,
-        "survivors": 23153.42,
         "taxMax": 32400,
         "cola": 7.4,
         "awi": 14531.34
     },
     {
         "year": 1983,
-        "retirement": 23623.34,
-        "disability": 23623.34,
-        "survivors": 23623.34,
         "taxMax": 35700,
         "cola": 3.5,
         "awi": 15239.24
     },
     {
         "year": 1984,
-        "retirement": 24084.18,
-        "disability": 24084.18,
-        "survivors": 24084.18,
         "taxMax": 37800,
         "cola": 3.5,
         "awi": 16135.07
     },
     {
         "year": 1985,
-        "retirement": 24600,
-        "disability": 24600,
-        "survivors": 24600,
         "taxMax": 39600,
         "cola": 3.1,
         "awi": 16822.51
     },
     {
         "year": 1986,
-        "retirement": 25800,
-        "disability": 25800,
-        "survivors": 25800,
         "taxMax": 42000,
         "cola": 1.3,
         "awi": 17321.82
     },
     {
         "year": 1987,
-        "retirement": 28000,
-        "disability": 28000,
-        "survivors": 28000,
         "taxMax": 43800,
         "cola": 4.2,
         "awi": 18426.51
     },
     {
         "year": 1988,
-        "retirement": 30000,
-        "disability": 30000,
-        "survivors": 30000,
         "taxMax": 45000,
         "cola": 4,
         "awi": 19334.04
     },
     {
         "year": 1989,
-        "retirement": 31800,
-        "disability": 31800,
-        "survivors": 31800,
         "taxMax": 48000,
         "cola": 4.7,
         "awi": 20099.55
     },
     {
         "year": 1990,
-        "retirement": 34000,
-        "disability": 34000,
-        "survivors": 34000,
         "taxMax": 51300,
         "cola": 5.4,
         "awi": 21027.98
     },
     {
         "year": 1991,
-        "retirement": 35900,
-        "disability": 35900,
-        "survivors": 35900,
         "taxMax": 53400,
         "cola": 3.7,
         "awi": 21811.6
     },
     {
         "year": 1992,
-        "retirement": 38500,
-        "disability": 38500,
-        "survivors": 38500,
         "taxMax": 55500,
         "cola": 3,
         "awi": 22935.42
     },
     {
         "year": 1993,
-        "retirement": 39600,
-        "disability": 39600,
-        "survivors": 39600,
         "taxMax": 57600,
         "cola": 2.6,
         "awi": 23132.67
     },
     {
         "year": 1994,
-        "retirement": 41500,
-        "disability": 41500,
-        "survivors": 41500,
         "taxMax": 60600,
         "cola": 2.8,
         "awi": 23753.53
     },
     {
         "year": 1995,
-        "retirement": 44000,
-        "disability": 44000,
-        "survivors": 44000,
         "taxMax": 61200,
         "cola": 2.6,
         "awi": 24705.66
     },
     {
         "year": 1996,
-        "retirement": 47100,
-        "disability": 47100,
-        "survivors": 47100,
         "taxMax": 62700,
         "cola": 2.9,
         "awi": 25913.9
     },
     {
         "year": 1997,
-        "retirement": 50900,
-        "disability": 50900,
-        "survivors": 50900,
         "taxMax": 65400,
         "cola": 2.1,
         "awi": 27426
     },
     {
         "year": 1998,
-        "retirement": 54600,
-        "disability": 54600,
-        "survivors": 54600,
         "taxMax": 68400,
         "cola": 1.3,
         "awi": 28861.44
     },
     {
         "year": 1999,
-        "retirement": 58800,
-        "disability": 58800,
-        "survivors": 58800,
         "taxMax": 72600,
         "cola": 2.5,
         "awi": 30469.84
     },
     {
         "year": 2000,
-        "retirement": 63300,
-        "disability": 63300,
-        "survivors": 63300,
         "taxMax": 76200,
         "cola": 3.5,
         "awi": 32154.82
     },
     {
         "year": 2001,
-        "retirement": 66100,
-        "disability": 66100,
-        "survivors": 66100,
         "taxMax": 80400,
         "cola": 2.6,
         "awi": 32921.92
     },
     {
         "year": 2002,
-        "retirement": 68100,
-        "disability": 68100,
-        "survivors": 68100,
         "taxMax": 84900,
         "cola": 1.4,
         "awi": 33252.09
     },
     {
         "year": 2003,
-        "retirement": 71200,
-        "disability": 71200,
-        "survivors": 71200,
         "taxMax": 87000,
         "cola": 2.1,
         "awi": 34064.95
     },
     {
         "year": 2004,
-        "retirement": 76000,
-        "disability": 76000,
-        "survivors": 76000,
         "taxMax": 87900,
         "cola": 2.7,
         "awi": 35648.55
     },
     {
         "year": 2005,
-        "retirement": 80300,
-        "disability": 80300,
-        "survivors": 80300,
         "taxMax": 90000,
         "cola": 4.1,
         "awi": 36952.94
     },
     {
         "year": 2006,
-        "retirement": 85700,
-        "disability": 85700,
-        "survivors": 85700,
         "taxMax": 94200,
         "cola": 3.3,
         "awi": 38651.41
     },
     {
         "year": 2007,
-        "retirement": 91400,
-        "disability": 91400,
-        "survivors": 91400,
         "taxMax": 97500,
         "cola": 2.3,
         "awi": 40405.48
     },
     {
         "year": 2008,
-        "retirement": 95300,
-        "disability": 95300,
-        "survivors": 95300,
         "taxMax": 102000,
         "cola": 5.8,
         "awi": 41334.97
     },
     {
         "year": 2009,
-        "retirement": 95800,
-        "disability": 95800,
-        "survivors": 95800,
         "taxMax": 106800,
         "cola": 0,
         "awi": 40711.61
     },
     {
         "year": 2010,
-        "retirement": 100000,
-        "disability": 100000,
-        "survivors": 100000,
         "taxMax": 106800,
         "cola": 0,
         "awi": 41673.83
     },
     {
         "year": 2011,
-        "retirement": 0,
-        "disability": 0,
-        "survivors": 0,
         "taxMax": 106800,
         "cola": 3.6,
         "awi": 42979.61
     },
     {
         "year": 2012,
-        "retirement": 0,
-        "disability": 0,
-        "survivors": 0,
         "taxMax": 110100,
         "cola": 1.7,
         "awi": 44321.67
     },
     {
         "year": 2013,
-        "retirement": 0,
-        "disability": 0,
-        "survivors": 0,
         "taxMax": 113700,
         "cola": 1.5,
         "awi": 44888.16
     },
     {
         "year": 2014,
-        "retirement": 0,
-        "disability": 0,
-        "survivors": 0,
         "taxMax": 117000,
         "cola": 1.7,
         "awi": 46481.52
     },
     {
         "year": 2015,
-        "retirement": 0,
-        "disability": 0,
-        "survivors": 0,
         "taxMax": 118500,
         "cola": 0,
         "awi": 48098.63
     },
     {
         "year": 2016,
-        "retirement": 0,
-        "disability": 0,
-        "survivors": 0,
         "taxMax": 118500,
         "cola": 0.3,
         "awi": 48642.15
     },
     {
         "year": 2017,
-        "retirement": 0,
-        "disability": 0,
-        "survivors": 0,
         "taxMax": 127200,
         "cola": 2,
         "awi": 50321.89
     },
     {
         "year": 2018,
-        "retirement": 0,
-        "disability": 0,
-        "survivors": 0,
         "taxMax": 128400,
         "cola": 2.8,
         "awi": 52145.8
     },
     {
         "year": 2019,
-        "retirement": 0,
-        "disability": 0,
-        "survivors": 0,
         "taxMax": 132900,
         "cola": 1.6,
         "awi": 54099.99
     },
     {
         "year": 2020,
-        "retirement": 0,
-        "disability": 0,
-        "survivors": 0,
         "taxMax": 137700,
         "cola": 1.3,
         "awi": 55628.6
     },
     {
         "year": 2021,
-        "retirement": 0,
-        "disability": 0,
-        "survivors": 0,
         "taxMax": 142800,
         "cola": 5.9,
         "awi": 60575.07
     },
     {
         "year": 2022,
-        "retirement": 0,
-        "disability": 0,
-        "survivors": 0,
         "taxMax": 147000,
         "cola": 8.7,
         "awi": 63795.13
     },
     {
         "year": 2023,
-        "retirement": 0,
-        "disability": 0,
-        "survivors": 0,
         "taxMax": 160200,
         "cola": 3.2,
         "awi": 66621.8
     },
     {
         "year": 2024,
-        "retirement": 0,
-        "disability": 0,
-        "survivors": 0,
         "taxMax": 168600,
         "cola": 2.5,
         "awi": 69472.44
     },
     {
         "year": 2025,
-        "retirement": 0,
-        "disability": 0,
-        "survivors": 0,
         "taxMax": 176100,
         "cola": 2.7,
         "awi": 72255.52

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "social-security-calculator",
-  "version": "1.0.3",
+  "version": "3.0.0",
   "description": "Calculate estimated Social Security Benefits",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -44,9 +44,10 @@
     "compound-calc": "^4.0.3",
     "csvtojson": "^2.0.10",
     "jest": "^29.7.0",
+    "minimist": "^1.2.8",
     "playwright": "^1.54.1",
     "ts-jest": "^29.1.1",
-    "typescript": "^4.8.3"
+    "typescript": "^5.9.2"
   },
   "dependencies": {
     "xml2js": "^0.6.2"