social-security-calculator 3.0.0 → 3.1.0

package/lib/constants.d.ts

@@ -1,5 +1,5 @@
 export declare const EARLY_RETIREMENT_AGE = 62;
-export declare const WAGE_INDEX_CUTOFF = 2023;
+export declare const WAGE_INDEX_CUTOFF = 2024;
 export declare const MAX_RETIREMENT_AGE = 70;
 export declare const LOOKBACK_YEARS = 40;
 export declare const MAX_DROP_OUT_YEARS = 5;
@@ -10,6 +10,7 @@ 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 DISABILITY_LAST_EARNINGS_YEARS_THRESHOLD = 5;
 export declare const PIA_PERCENTAGES: {
     readonly FIRST_BRACKET: 0.9;
     readonly SECOND_BRACKET: 0.32;

package/lib/constants.js

@@ -1,6 +1,6 @@
 // Constants
 export const EARLY_RETIREMENT_AGE = 62;
-export const WAGE_INDEX_CUTOFF = 2023;
+export const WAGE_INDEX_CUTOFF = 2024;
 export const MAX_RETIREMENT_AGE = 70;
 // 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.
@@ -15,6 +15,8 @@ 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
+// Disability 5-year rule: if disability date is more than 5 years after last earnings year, disability benefit is zero
+export const DISABILITY_LAST_EARNINGS_YEARS_THRESHOLD = 5;
 export const PIA_PERCENTAGES = {
     FIRST_BRACKET: 0.9,
     SECOND_BRACKET: 0.32,

package/lib/index.d.ts

@@ -1,15 +1,6 @@
-import { BenefitCalculationResult, RetirementDates, Earnings } from './model';
+import { BenefitCalculationResult, Earnings } from './model';
 export declare function calc(birthday: Date, retirementDate: Date, earnings: Earnings): 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, 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,5 +1,5 @@
 import { wageIndex } from './wage-index';
-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';
+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, DISABILITY_LAST_EARNINGS_YEARS_THRESHOLD } from './constants';
 // Main entry point
 export function calc(birthday, retirementDate, earnings) {
     const retirementCalc = calcRetirement(birthday, retirementDate, earnings);
@@ -13,7 +13,11 @@ export function calcRetirement(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);
+    // Apply disability 5-year rule: if disability date is more than 5 years after last earnings year, benefit is zero
+    let disabilityPIAFloored = 0;
+    if (context.retirementDate <= context.dates.fullRetirement && !isDisabilityDateBeyondFiveYearRule(retirementDate, earnings)) {
+        disabilityPIAFloored = Math.floor(disabilityBenefit.colaAdjustedPIA);
+    }
     return {
         AIME: regularBenefit.aime,
         PIA: regularBenefit.pia,
@@ -79,7 +83,7 @@ function validateInputs(birthday, retirementDate, earnings) {
     }
 }
 // Retirement date calculations
-export function calculateRetirementDates(birthday, retirementDate) {
+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());
@@ -96,7 +100,7 @@ export function calculateRetirementDates(birthday, retirementDate) {
     };
 }
 // Benefit amount calculations
-export function retirementDateAdjustedPayment(dates, colaAdjustedPIA) {
+function retirementDateAdjustedPayment(dates, colaAdjustedPIA) {
     const earlyRetireMonths = monthsDifference(dates.adjusted, dates.fullRetirement);
     let adjustedBenefits = colaAdjustedPIA;
     if (dates.retirementDate < dates.earliestRetirement) {
@@ -174,12 +178,12 @@ export function calculateAIME(earnings, lookbackYears, baseYear) {
     return Math.floor(totalEarnings / (12 * lookbackYears));
 }
 // Lookback year calculations
-export function getLookbackYears(elapsedYears) {
+function getLookbackYears(elapsedYears) {
     const minComputationYears = 2;
     const adjustedLookbackYears = Math.floor(elapsedYears) - 5;
     return Math.max(minComputationYears, adjustedLookbackYears);
 }
-export function getLookbackYearsDisability(elapsedYears) {
+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;
@@ -227,7 +231,7 @@ function getDelayedRetirementRate(birthYear) {
     return 2 / 3 / 100; // 2/3 of 1%
 }
 // Full retirement age calculation
-export function getFullRetirementMonths(commonLawBirthDate) {
+function getFullRetirementMonths(commonLawBirthDate) {
     const year = commonLawBirthDate.getFullYear();
     if (year <= 1937) {
         return 65 * 12;
@@ -249,12 +253,12 @@ export function getFullRetirementMonths(commonLawBirthDate) {
     }
 }
 /** Compute Family-Max bend points for an eligibility year given AWI_{year-2}. */
-export function getFamilyMaxBendPoints(baseYear) {
+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]) {
+function calculateFamilyMaximum(pia, [bp1, bp2, bp3]) {
     let max = 0;
     max += 1.50 * Math.min(pia, bp1);
     if (pia > bp1)
@@ -266,6 +270,25 @@ export function calculateFamilyMaximum(pia, [bp1, bp2, bp3]) {
     // SSA: round total down to next lower $0.10
     return Math.floor(max * 10) / 10;
 }
+// Check if disability date violates the 5-year rule
+function isDisabilityDateBeyondFiveYearRule(disabilityDate, earnings) {
+    if (!earnings || earnings.length === 0) {
+        return true; // No earnings means no disability benefit
+    }
+    // Find the last year with non-zero earnings
+    const earningsWithValue = earnings.filter(e => e.earnings > 0);
+    if (earningsWithValue.length === 0) {
+        return true; // No non-zero earnings means no disability benefit
+    }
+    const lastEarningsYear = Math.max(...earningsWithValue.map(e => e.year));
+    // Last day of the last earnings year
+    const lastDayOfLastEarningsYear = new Date(lastEarningsYear, 11, 31); // December 31st
+    // Add exactly 5 years to the last day of last earnings year
+    const fiveYearsLater = new Date(lastDayOfLastEarningsYear);
+    fiveYearsLater.setFullYear(fiveYearsLater.getFullYear() + DISABILITY_LAST_EARNINGS_YEARS_THRESHOLD);
+    // Disability date must be after the 5-year threshold
+    return disabilityDate > fiveYearsLater;
+}
 // Utility functions
 export function getEnglishCommonLawDate(date) {
     const eclDate = new Date(date);

package/lib/wage-index.js

@@ -442,22 +442,28 @@ export const wageIndex = [
         "year": 2024,
         "taxMax": 168600,
         "cola": 2.5,
-        "awi": 69472.44
+        "awi": 69846.57
     },
     {
         "year": 2025,
         "taxMax": 176100,
-        "cola": 2.7,
-        "awi": 72255.52
+        "cola": 2.8,
+        "awi": 72644.64
+    },
+    {
+        "year": 2026,
+        "taxMax": 176100,
+        "cola": 2.5,
+        "awi": 75670.13
     }
 ];
+// 2026  60000.00     60000.00        0.00        0.00    176100   2.5  75670.13
 export const wageIndexFuture = [
-    { year: 2024, awi: 69472.44 },
-    { year: 2025, awi: 72255.52 },
-    { year: 2026, awi: 75264.81 },
-    { year: 2027, awi: 78304.32 },
-    { year: 2028, awi: 81522.64 },
-    { year: 2029, awi: 84736.18 },
+    { year: 2025, awi: 72644.64 },
+    { year: 2026, awi: 75670.13 },
+    { year: 2027, awi: 78726.01 },
+    { year: 2028, awi: 81961.66 },
+    { year: 2029, awi: 85192.51 },
     { year: 2030, awi: 88030.45 },
     { year: 2031, awi: 91479.46 },
     { year: 2032, awi: 95090.94 },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "social-security-calculator",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Calculate estimated Social Security Benefits",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -40,6 +40,7 @@
   "devDependencies": {
     "@jest/globals": "^29.7.0",
     "@types/jest": "^29.5.8",
+    "@types/minimist": "^1.2.5",
     "@types/xml2js": "^0.4.11",
     "compound-calc": "^4.0.3",
     "csvtojson": "^2.0.10",