social-security-calculator 0.0.6 → 0.0.7

package/LICENSE.txt

@@ -0,0 +1,13 @@
+Copyright 2022 RYAN ANTKOWIAK, CHARLES MCNULTY
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy,
+modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS
+OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
+OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -4,14 +4,11 @@ TypeScript to calculate estimated Social Security Benefits
 
  This module will calculate your expected retirement benefits
  from Social Security given your annual earnings
- Inputs:
-           1) EarningsRecord -
-               Dictionary mapping a year to the amount of Social
-               Security eligible earnings in that particular year
 
-           2) NationalAverageWageIndexSeries -
-               Data pulled directly from the Social Security website for the
-               national average wage data
+ Input:
 
-Adapted from python originally written by Ryan Antkowiak (antkowiak@gmail.com) and updated by Kevin Fowlks (fowlk1kd@gmail.com)
+ Dictionary mapping a year to the amount of Social
+ Security eligible earnings in that particular year
 
+
+Adapted from python originally written by Ryan Antkowiak

package/lib/estimatedEarnings/index.js

@@ -0,0 +1,49 @@
+import { wageIndex } from '../wage-index';
+const YOUTH_FACTOR = 8;
+const YOUTH_FACTOR_AGE = 21;
+const WORK_START_AGE = 18;
+const CURRENT_YEAR_INCREASE = .945; //.96
+const CURRENT_YEAR = new Date().getFullYear();
+export function getEstimatedEarnings(age, lastWage, lastYearWorked = CURRENT_YEAR, earningGrowthRate = 0) {
+    if (age <= 22) {
+        throw new Error('Age must be greater than 22');
+    }
+    if (lastYearWorked > CURRENT_YEAR) {
+        throw new Error('Last year worked cannot be in the future');
+    }
+    const workStartYear = CURRENT_YEAR - age + WORK_START_AGE;
+    const yearTurned22 = CURRENT_YEAR - age + YOUTH_FACTOR_AGE;
+    const wageResults = {};
+    let i = lastYearWorked;
+    for (; i >= workStartYear; i--) {
+        const reductionFactor = getReductionFactor(i) / (1 + earningGrowthRate);
+        const youthFactor = i === yearTurned22 ? YOUTH_FACTOR : 1;
+        const year = i;
+        const nextYear = (i + 1);
+        if (i === lastYearWorked) {
+            wageResults[year] = lastWage;
+        }
+        else {
+            wageResults[year] = (wageResults[nextYear] * reductionFactor) / youthFactor;
+        }
+    }
+    return wageResults;
+}
+function getReductionFactor(year) {
+    const lastYear = year - 1;
+    const nextYear = year + 1;
+    if (year === CURRENT_YEAR && !wageIndex[lastYear]) {
+        throw new Error(`Wage index for previous year (${lastYear}) is required`);
+        // return CURRENT_YEAR_INCREASE
+    }
+    if (year === CURRENT_YEAR) {
+        return 1;
+    }
+    else if (year === CURRENT_YEAR - 1) {
+        return CURRENT_YEAR_INCREASE;
+    }
+    else {
+        return (wageIndex[year] / wageIndex[nextYear]);
+    }
+}
+// console.log(getEstimatedEarnings(70, 100000, 2020, .02));

package/lib/index.js

@@ -1,23 +1,32 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const wage_index_1 = require("./wage-index");
-function calc(earnings) {
+import { wageIndex } from './wage-index';
+export const calc = (earnings) => {
     const lookbackYears = 35;
     const futureYearsFactor = 1;
     const bendPointDivisor = 9779.44;
-    const firstBendPointMultiplier = 180.0;
-    const secondBendPointMultiplier = 1085.0;
-    const averageWageLastYear = Math.max(...Object.keys(wage_index_1.wageIndex).map(val => parseInt(val)));
-    const firstBendPoint = Math.round(firstBendPointMultiplier * wage_index_1.wageIndex[averageWageLastYear] / bendPointDivisor);
-    const secondBendPoint = Math.round(secondBendPointMultiplier * wage_index_1.wageIndex[averageWageLastYear] / bendPointDivisor);
-    const wageIndexFactors = Object.entries(wage_index_1.wageIndex).reduce((acc, [i, val]) => ((acc[i] = 1 + (wage_index_1.wageIndex[averageWageLastYear] - val) / val) && acc), {});
-    const adjustedEarnings = Object.entries(earnings).reduce((acc, [i, val]) => ((acc[i] = val * (wageIndexFactors[i] || futureYearsFactor)) && acc), {});
-    const top35YearsEarnings = Object.values(adjustedEarnings)
+    const firstBendPointMultiplier = 180;
+    const secondBendPointMultiplier = 1085;
+    const averageWageLastYear = Math.max(...Object.keys(wageIndex).map(val => parseInt(val)));
+    const wageIndexLastYear = wageIndex[averageWageLastYear];
+    // https://www.ssa.gov/oact/COLA/piaformula.html
+    // Per examples, bend points are rounded to the nearest dollar
+    const firstBendPoint = Math.round(firstBendPointMultiplier * wageIndexLastYear / bendPointDivisor);
+    const secondBendPoint = Math.round(secondBendPointMultiplier * wageIndexLastYear / bendPointDivisor);
+    // calculate the wage index factors
+    const wageIndexFactors = Object.entries(wageIndex).reduce((acc, [i, val]) => ((acc[parseInt(i)] = 1 + (wageIndexLastYear - val) / val), acc), {});
+    // adjust the earnings according to the wage index factor,
+    // factor is 1 for any earnings record without a wage-factor
+    const adjustedEarnings = Object.entries(earnings).reduce((acc, [i, val]) => ((acc[parseInt(i)] = val * (wageIndexFactors[parseInt(i)] || futureYearsFactor)), acc), {});
+    const top35YearsEarningsArr = Object.values(adjustedEarnings)
         .sort((a, b) => b - a) // sort the earnings from highest to lowest amount
-        .slice(0, lookbackYears) // grab the highest 35 earnings years
-        .reduce((partialSum, a) => partialSum + a, 0); // and finally sum them
-    const AIME = top35YearsEarnings / (12 * lookbackYears);
-    const normalMonthlyBenefit = (() => {
+        .slice(0, lookbackYears); // grab the highest 35 earnings years
+    console.log(top35YearsEarningsArr);
+    const top35YearsEarnings = top35YearsEarningsArr.reduce((partialSum, a) => partialSum + a, 0); // and finally sum them
+    // https://www.ssa.gov/oact/cola/Benefits.html
+    // "We then round the resulting average amount down to the next lower dollar amount"
+    const AIME = Math.floor(top35YearsEarnings / (12 * lookbackYears));
+    // https://www.ssa.gov/OP_Home/handbook/handbook.07/handbook-0738.html
+    // Calculations that are not a multiple of 10 cents are rounded to the next lower multiple of 10 cents. For example, $100.18 is rounded down to $100.10.
+    const PIA = (() => {
         let monthlyBenefit = 0;
         if (AIME <= firstBendPoint) {
             monthlyBenefit = 0.9 * AIME;
@@ -30,20 +39,27 @@ function calc(earnings) {
                 monthlyBenefit = 0.9 * firstBendPoint + 0.32 * (secondBendPoint - firstBendPoint) + 0.15 * (AIME - secondBendPoint);
             }
         }
-        return Math.floor(monthlyBenefit * 10.0) / 10.0;
-        ;
+        return roundToFloorTenCents(monthlyBenefit);
     })();
-    const reducedMonthlyBenefit = Math.floor(((0.7 * normalMonthlyBenefit) * 10) / 10);
+    const reducedMonthlyBenefit = Math.floor(0.7 * PIA);
+    const normalMonthlyBenefit = Math.floor(PIA);
     const results = {
-        "Top35YearsEarnings": top35YearsEarnings.toFixed(2),
-        "AIME": AIME.toFixed(2),
-        "FirstBendPoint": firstBendPoint.toFixed(2),
-        "SecondBendPoint": secondBendPoint.toFixed(2),
-        "NormalMonthlyBenefit": normalMonthlyBenefit.toFixed(2),
-        "NormalAnnualBenefit": (normalMonthlyBenefit * 12).toFixed(2),
-        "ReducedMonthlyBenefit": reducedMonthlyBenefit.toFixed(2),
-        "ReducedAnnualBenefit": (reducedMonthlyBenefit * 12).toFixed(2),
+        "Top35YearsEarnings": top35YearsEarnings,
+        "AIME": AIME,
+        "FirstBendPoint": firstBendPoint,
+        "SecondBendPoint": secondBendPoint,
+        "NormalMonthlyBenefit": normalMonthlyBenefit,
+        "NormalAnnualBenefit": PIA * 12,
+        "ReducedMonthlyBenefit": reducedMonthlyBenefit,
+        "ReducedAnnualBenefit": reducedMonthlyBenefit * 12,
     };
     return results;
+};
+function roundToFloorTenCents(amount) {
+    // Convert the amount to fractional dimes
+    let dimes = amount * 10;
+    // floor to only whole dimes
+    dimes = Math.floor(dimes);
+    // Convert back to dollars and return
+    return (dimes / 10);
 }
-module.exports = calc;

package/lib/model.js

@@ -0,0 +1 @@
+export {};

package/lib/parseStatement/index.js

@@ -0,0 +1,17 @@
+import xml2js from 'xml2js';
+import fs from 'fs/promises';
+const NS = 'osss';
+const parser = new xml2js.Parser();
+const supportedVersion = "http://ssa.gov/osss/schemas/2.0";
+async function getWages(fileName) {
+    const data = await fs.readFile(fileName);
+    const result = await parser.parseStringPromise(data);
+    const schema = result[`${NS}:OnlineSocialSecurityStatementData`]['$'][`xmlns:${NS}`];
+    if (schema !== supportedVersion) {
+        throw `${schema} is not supported (${supportedVersion})`;
+    }
+    const results = result[`${NS}:OnlineSocialSecurityStatementData`][`${NS}:EarningsRecord`][0][`${NS}:Earnings`];
+    const earnings = results.reduce((acc, earn) => (acc[earn['$'].startYear] = parseInt(earn[`${NS}:FicaEarnings`][0]), acc), {});
+    return earnings;
+}
+export default getWages;

package/lib/wage-index.js

@@ -1,8 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.wageIndex = void 0;
-const compound = require('compound-calc');
-exports.wageIndex = {
+import { compound } from 'compound-calc';
+// https://www.ssa.gov/OACT/COLA/awiseries.html
+export const wageIndex = {
     1951: 2799.16,
     1952: 2973.32,
     1953: 3139.44,
@@ -73,44 +71,46 @@ exports.wageIndex = {
     2018: 52145.8,
     2019: 54099.99,
     2020: 55628.6,
+    2021: 60575.07,
+    2022: 63795.13
 };
 const shortRangeIntermediate = {
-    2021: 58743.07,
-    2022: 62583.15,
-    2023: 65571.72,
-    2024: 68371.79,
-    2025: 71147.65,
-    2026: 73980.60,
-    2027: 76857.74,
-    2028: 79761.29,
-    2029: 82702.63,
-    2030: 85713.03,
-    2031: 88836.46,
+    2023: 66147.17,
+    2024: 68627.58,
+    2025: 71411.99,
+    2026: 74348.48,
+    2027: 77393.67,
+    2028: 80510.73,
+    2029: 83757.03,
+    2030: 87106.49,
+    2031: 90574.48,
+    2032: 93995.33,
 };
 const longRangeIntermediate = {
-    2035: 102530.83,
-    2040: 122417.01,
-    2045: 145582.26,
-    2050: 172887.64,
-    2055: 205634.94,
-    2060: 244870.78,
-    2065: 291767.28,
-    2070: 347552.77,
-    2075: 413851.91,
-    2080: 492391.60,
-    2085: 585488.00,
-    2090: 696610.41,
-    2095: 829710.10,
-    2100: 988243.75,
+    2035: 104726.27,
+    2040: 125312.66,
+    2045: 149423.47,
+    2050: 177750.26,
+    2055: 211432.09,
+    2060: 251610.19,
+    2065: 299758.28,
+    2070: 357187.25,
+    2075: 425523.96,
+    2080: 506962.67,
+    2085: 603863.51,
+    2090: 719124.11,
+    2095: 856091.73,
+    2100: 1019162.94,
 };
 const fillBlanks = (vals) => Object.entries(vals).reduce((acc, [year, P], index, arr) => {
     let thing;
+    const iYear = parseInt(year);
     if (arr[index + 1]) {
         const [nextYear, A] = arr[index + 1];
         const t = parseInt(nextYear) - parseInt(year);
         const r = Math.pow((A / P), (1 / t)) - 1;
         const vals = compound(P, 0, t, r).result.slice(0, -1);
-        const ret = vals.reduce((accx, cur, i) => ((accx[(parseInt(year) + i).toString()] = cur) && accx), {});
+        const ret = vals.reduce((accx, cur, i) => ((accx[iYear + i] = cur) && accx), {});
         thing = Object.assign(Object.assign({}, acc), ret);
     }
     else {
@@ -118,5 +118,3 @@ const fillBlanks = (vals) => Object.entries(vals).reduce((acc, [year, P], index,
     }
     return thing;
 }, {});
-// console.log(fillBlanks(longRangeIntermediate));
-console.log(fillBlanks({ 2000: 38915, 2021: 108494 }));

package/package.json

@@ -1,29 +1,41 @@
 {
   "name": "social-security-calculator",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "Calculate estimated Social Security Benefits",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
+  "type": "module",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "test": "NODE_OPTIONS='--experimental-vm-modules' jest",
     "build": "tsc"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cmcnulty/SocialSecurityCalculator.git"
   },
-  "keywords": [],
+  "keywords": [
+    "calculator",
+    "social",
+    "security",
+    "ssi"
+  ],
   "author": "",
-  "license": "ISC",
+  "license": "MIT",
   "bugs": {
     "url": "https://github.com/cmcnulty/SocialSecurityCalculator/issues"
   },
   "homepage": "https://github.com/cmcnulty/SocialSecurityCalculator#readme",
   "devDependencies": {
+    "@jest/globals": "^29.7.0",
+    "@types/jest": "^29.5.8",
+    "@types/xml2js": "^0.4.11",
+    "compound-calc": "^4.0.3",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1",
     "typescript": "^4.8.3"
   },
   "dependencies": {
-    "compound-calc": "^2.0.0"
+    "xml2js": "^0.6.2"
   },
   "files": [
     "lib"

package/lib/index.d.ts

@@ -1,15 +0,0 @@
-export = calc;
-declare function calc(earnings: any): {
-    Top35YearsEarnings: any;
-    AIME: string;
-    FirstBendPoint: string;
-    SecondBendPoint: string;
-    NormalMonthlyBenefit: string;
-    NormalAnnualBenefit: string;
-    ReducedMonthlyBenefit: string;
-    ReducedAnnualBenefit: string;
-};
-declare namespace calc {
-    export { __esModule };
-}
-declare const __esModule: boolean;

package/lib/package.bak

@@ -1,31 +0,0 @@
-{
-  "name": "social-security-calculator",
-  "version": "0.0.5",
-  "description": "Calculate estimated Social Security Benefits",
-  "main": "index.js",
-  "types": "index.d.ts",
-  "files": [
-    "**/*"
-  ],
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "build": "tsc"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/cmcnulty/SocialSecurityCalculator.git"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "bugs": {
-    "url": "https://github.com/cmcnulty/SocialSecurityCalculator/issues"
-  },
-  "homepage": "https://github.com/cmcnulty/SocialSecurityCalculator#readme",
-  "devDependencies": {
-    "typescript": "^4.8.3"
-  },
-  "dependencies": {
-    "compound-calc": "^2.0.0"
-  }
-}