@casomoltd/nhs-pay 0.29.0 → 0.30.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -3
- package/dist/dates.d.ts +3 -0
- package/dist/dates.js +7 -2
- package/dist/dates.js.map +1 -1
- package/dist/member/benefits.js +27 -32
- package/dist/member/benefits.js.map +1 -1
- package/dist/member/input-period.d.ts +41 -0
- package/dist/member/input-period.js +166 -0
- package/dist/member/input-period.js.map +1 -0
- package/dist/member/service.d.ts +4 -1
- package/dist/member/service.js +12 -1
- package/dist/member/service.js.map +1 -1
- package/dist/member/types.d.ts +32 -7
- package/dist/member/types.js.map +1 -1
- package/dist/member/valuation.d.ts +64 -8
- package/dist/member/valuation.js +104 -19
- package/dist/member/valuation.js.map +1 -1
- package/dist/sections/final-salary.d.ts +64 -47
- package/dist/sections/final-salary.js +127 -69
- package/dist/sections/final-salary.js.map +1 -1
- package/package.json +3 -3
|
@@ -1,18 +1,22 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Each section's award for a member, valued at one set of dates: the
|
|
3
3
|
* legacy section on final salary, the 2015 Section and a remedy window
|
|
4
|
-
* on its basis as career average walks,
|
|
5
|
-
*
|
|
6
|
-
*
|
|
4
|
+
* on its basis as career average walks. Beside them, what the member
|
|
5
|
+
* holds before any drawing: today's holdings, and the final-salary value
|
|
6
|
+
* and undrawn walk a tax year's pension input reads on a date. `Built`
|
|
7
|
+
* is everything about the member, derived once, that all of it reads.
|
|
8
|
+
* The owner in `benefits.ts` decides which awards a drawing has and sums
|
|
9
|
+
* them.
|
|
7
10
|
*/
|
|
8
|
-
import type { Award, Holdings, Member, Position, ServicePeriod } from './types.js';
|
|
9
|
-
import type { LegacySectionId, SectionId } from './types.js';
|
|
11
|
+
import type { Award, Holdings, Member, MemberBenefits, Position, ServicePeriod } from './types.js';
|
|
12
|
+
import type { LegacySectionId, RemedyBasis, SectionId } from './types.js';
|
|
10
13
|
import type { LegacyHolding } from './service.js';
|
|
11
14
|
import type { JoiningHistory } from '../pension/ages.js';
|
|
12
15
|
import type { PayPath } from '../pay-path.js';
|
|
16
|
+
import type { MemberLedger } from '../pension/ledger.js';
|
|
13
17
|
import type { Prices } from '../pension/prices.js';
|
|
14
18
|
import type { LedgerSeed } from '../pension/seed.js';
|
|
15
|
-
import type { FinalSalaryRules } from '../sections/final-salary.js';
|
|
19
|
+
import type { FinalSalaryRules, UnreducedPension } from '../sections/final-salary.js';
|
|
16
20
|
import { careerAverage } from '../sections/section-2015.js';
|
|
17
21
|
/** Everything about the member, derived once, that every question
|
|
18
22
|
* asked of them reads. */
|
|
@@ -25,6 +29,9 @@ export interface Built {
|
|
|
25
29
|
readonly npaOn: Date;
|
|
26
30
|
readonly payPath: PayPath;
|
|
27
31
|
readonly legacy: LegacyHolding | null;
|
|
32
|
+
/** Whether the member has a remedy window, and so must elect a basis
|
|
33
|
+
* for it, as every refusal of an election reads it. */
|
|
34
|
+
readonly remedy: boolean;
|
|
28
35
|
readonly ordinary2015: ServicePeriod;
|
|
29
36
|
readonly cashPrices: Prices;
|
|
30
37
|
readonly todaysPrices: Prices;
|
|
@@ -49,19 +56,68 @@ interface CareerWindow {
|
|
|
49
56
|
readonly window: ServicePeriod;
|
|
50
57
|
readonly seedFor: (prices: Prices) => LedgerSeed;
|
|
51
58
|
}
|
|
59
|
+
/** One walk: a window, its seed, and the price series it walks in. */
|
|
60
|
+
interface Walk {
|
|
61
|
+
readonly window: ServicePeriod;
|
|
62
|
+
readonly seed: LedgerSeed;
|
|
63
|
+
readonly prices: Prices;
|
|
64
|
+
}
|
|
65
|
+
/** The legacy periods valued on final salary, which the election decides,
|
|
66
|
+
* and the section whose rules value them. */
|
|
67
|
+
interface FinalSalaryValued {
|
|
68
|
+
readonly section: LegacySectionId;
|
|
69
|
+
readonly valued: readonly ServicePeriod[];
|
|
70
|
+
}
|
|
71
|
+
/** A final-salary pension and automatic lump sum, unreduced, in today's
|
|
72
|
+
* money. */
|
|
73
|
+
type FinalSalaryHeld = Pick<UnreducedPension, 'pension' | 'automaticLumpSum'>;
|
|
52
74
|
/** Each legacy section's statute. */
|
|
53
75
|
export declare const RULES: Record<LegacySectionId, FinalSalaryRules>;
|
|
76
|
+
/** Whether an election walks the remedy window as career average. */
|
|
77
|
+
export declare function walksWindow(basis: RemedyBasis): boolean;
|
|
78
|
+
/** The legacy periods final salary values under an election: every one on
|
|
79
|
+
* the legacy basis; on the 2015 basis the section's own service alone,
|
|
80
|
+
* the remedy window leaving it for a career average walk. */
|
|
81
|
+
export declare function finalSalaryValued(legacy: LegacyHolding, basis: RemedyBasis): FinalSalaryValued;
|
|
82
|
+
/** A remedy window's seed on the 2015 basis: it walks from its first day,
|
|
83
|
+
* since no statement counts the remedy years in the 2015 Section. */
|
|
84
|
+
export declare function windowSeed(window: ServicePeriod): LedgerSeed;
|
|
54
85
|
/** The 2015 Section's own seed: its statement, or its first day. */
|
|
55
86
|
export declare function seed2015(b: Built, { leaving, drawing }: Drawing, prices: Prices): LedgerSeed;
|
|
56
87
|
/** What the member holds today, with the remedy window on the legacy
|
|
57
|
-
* basis: unreduced, since nothing is drawn.
|
|
88
|
+
* basis: unreduced, since nothing is drawn. A member who has left holds
|
|
89
|
+
* their deferred benefits, final pay measured at leaving. */
|
|
58
90
|
export declare function holdings(b: Built): Holdings;
|
|
59
91
|
/** The legacy section's final-salary award over the periods valued on
|
|
60
92
|
* final salary, which the election decides. */
|
|
61
|
-
export declare function legacyAward(b: Built,
|
|
93
|
+
export declare function legacyAward(b: Built, { section, valued }: FinalSalaryValued, dates: Drawing): Award;
|
|
62
94
|
/** A career average award over one window, walked in both rulers. */
|
|
63
95
|
export declare function careerAward(b: Built, { section, window, seedFor }: CareerWindow, dates: Drawing): CareerAward;
|
|
64
96
|
/** The 2015 Section's balance, with its estimated run-up before a
|
|
65
97
|
* statement, as the ledgers, history and curve a `Position` carries. */
|
|
66
98
|
export declare function section2015(b: Built, own: CareerAward, { leaving, drawing }: Drawing): Pick<Position, 'ledger' | 'todaysMoneyLedger' | 'estimatedHistory' | 'curve'>;
|
|
99
|
+
/**
|
|
100
|
+
* The same walk as the ledger alone, with no drawing on it, through the
|
|
101
|
+
* scheme year ending in `through`: what the window holds on any date to
|
|
102
|
+
* then, before any early or late factor. A valuation that never draws has
|
|
103
|
+
* no factor to read, and a factor read for a drawing far past the pension
|
|
104
|
+
* age is one GAD's tables may not price.
|
|
105
|
+
*/
|
|
106
|
+
export declare function accruedLedger(b: Built, { window, seed, prices }: Walk, { leaving, drawing }: Drawing, through: number): MemberLedger;
|
|
107
|
+
/** Refuse a leaving after the one the member declared, naming `asked`,
|
|
108
|
+
* the call a caller was answering: service that has ended cannot run on. */
|
|
109
|
+
export declare function refuseLeavingAfterDeclared(asked: keyof MemberBenefits, b: Built, leaving: Date): void;
|
|
110
|
+
/**
|
|
111
|
+
* The legacy section's final-salary pension and automatic lump sum held on
|
|
112
|
+
* `on`, unreduced, in today's money: membership to that day, on final pay
|
|
113
|
+
* measured back from it, as a leaving on it is measured. Where the member
|
|
114
|
+
* `left` before `on`, both are measured at leaving. `left` is the caller's:
|
|
115
|
+
* today's holdings read the declared leaving, and a tax year's input the
|
|
116
|
+
* leaving it was asked about.
|
|
117
|
+
*/
|
|
118
|
+
export declare function finalSalaryHeldOn(b: Built, { section, valued }: FinalSalaryValued, on: Date, left: Date | null): FinalSalaryHeld;
|
|
119
|
+
/** The dates a walk that never draws runs to: leaving, and a drawing at
|
|
120
|
+
* the pension age or at leaving where that is later. It reads no factor,
|
|
121
|
+
* so the drawing decides only which years after leaving are deferred. */
|
|
122
|
+
export declare function walkDates(b: Built, leaving: Date): Drawing;
|
|
67
123
|
export {};
|
package/dist/member/valuation.js
CHANGED
|
@@ -1,9 +1,10 @@
|
|
|
1
|
-
import { ACCRUALS, SECTIONS } from './types.js';
|
|
1
|
+
import { ACCRUALS, REMEDY_BASES, SECTIONS } from './types.js';
|
|
2
2
|
import { legacyPeriodsOf, until } from './service.js';
|
|
3
3
|
import { isoToDate } from '../iso-date.js';
|
|
4
4
|
import { normalPensionAge } from '../pension/ages.js';
|
|
5
5
|
import { earliest } from '../dates.js';
|
|
6
6
|
import { buildCurve, walkThrough } from '../pension/curve.js';
|
|
7
|
+
import { buildLedger } from '../pension/ledger.js';
|
|
7
8
|
import { seedFromBalanceAt } from '../pension/uplift.js';
|
|
8
9
|
import { estimateHistory } from '../pension/history.js';
|
|
9
10
|
import { moneyAt, sumMoney } from '../pension/money.js';
|
|
@@ -17,6 +18,33 @@ export const RULES = {
|
|
|
17
18
|
[SECTIONS.s1995]: RULES_1995,
|
|
18
19
|
[SECTIONS.s2008]: RULES_2008,
|
|
19
20
|
};
|
|
21
|
+
/** How each election values the remedy window: on final salary, as more
|
|
22
|
+
* legacy service, or as a career average walk paid from the legacy
|
|
23
|
+
* section. No election means no window, so nothing walks. Total over
|
|
24
|
+
* `RemedyBasis`, so a new basis fails the build until it says which. */
|
|
25
|
+
const WINDOW_ACCRUAL = {
|
|
26
|
+
[REMEDY_BASES.none]: ACCRUALS.finalSalary,
|
|
27
|
+
[REMEDY_BASES.legacy]: ACCRUALS.finalSalary,
|
|
28
|
+
[REMEDY_BASES.section2015]: ACCRUALS.careerAverage,
|
|
29
|
+
};
|
|
30
|
+
/** Whether an election walks the remedy window as career average. */
|
|
31
|
+
export function walksWindow(basis) {
|
|
32
|
+
return WINDOW_ACCRUAL[basis] === ACCRUALS.careerAverage;
|
|
33
|
+
}
|
|
34
|
+
/** The legacy periods final salary values under an election: every one on
|
|
35
|
+
* the legacy basis; on the 2015 basis the section's own service alone,
|
|
36
|
+
* the remedy window leaving it for a career average walk. */
|
|
37
|
+
export function finalSalaryValued(legacy, basis) {
|
|
38
|
+
return {
|
|
39
|
+
section: legacy.section,
|
|
40
|
+
valued: walksWindow(basis) ? [legacy.own] : legacyPeriodsOf(legacy),
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
/** A remedy window's seed on the 2015 basis: it walks from its first day,
|
|
44
|
+
* since no statement counts the remedy years in the 2015 Section. */
|
|
45
|
+
export function windowSeed(window) {
|
|
46
|
+
return seedFromJoinDate(isoToDate(window.from));
|
|
47
|
+
}
|
|
20
48
|
/** The 2015 Section's own seed: its statement, or its first day. */
|
|
21
49
|
export function seed2015(b, { leaving, drawing }, prices) {
|
|
22
50
|
const { statement } = b.member;
|
|
@@ -25,13 +53,15 @@ export function seed2015(b, { leaving, drawing }, prices) {
|
|
|
25
53
|
: seedFromBalanceAt(statement.accruedPension, isoToDate(statement.asAt), leaving, drawing, prices);
|
|
26
54
|
}
|
|
27
55
|
/** What the member holds today, with the remedy window on the legacy
|
|
28
|
-
* basis: unreduced, since nothing is drawn.
|
|
56
|
+
* basis: unreduced, since nothing is drawn. A member who has left holds
|
|
57
|
+
* their deferred benefits, final pay measured at leaving. */
|
|
29
58
|
export function holdings(b) {
|
|
30
59
|
const { today } = b;
|
|
60
|
+
const left = declaredLeaving(b);
|
|
31
61
|
const bySection = [];
|
|
32
62
|
const flat = (x) => moneyAt({ nominal: x, real: x }, today);
|
|
33
63
|
if (b.legacy !== null) {
|
|
34
|
-
const { pension, automaticLumpSum } =
|
|
64
|
+
const { pension, automaticLumpSum } = finalSalaryHeldOn(b, finalSalaryValued(b.legacy, REMEDY_BASES.legacy), today, left);
|
|
35
65
|
bySection.push({
|
|
36
66
|
section: b.legacy.section,
|
|
37
67
|
pension: flat(pension),
|
|
@@ -40,10 +70,7 @@ export function holdings(b) {
|
|
|
40
70
|
}
|
|
41
71
|
// Any leaving and drawing after today give the same balance today;
|
|
42
72
|
// these are only where the walk has to stop.
|
|
43
|
-
const
|
|
44
|
-
? b.npaOn
|
|
45
|
-
: isoToDate(b.ordinary2015.to);
|
|
46
|
-
const dates = { leaving, drawing: leaving < b.npaOn ? b.npaOn : leaving };
|
|
73
|
+
const dates = walkDates(b, left ?? b.npaOn);
|
|
47
74
|
const accrued = walk(b, {
|
|
48
75
|
window: b.ordinary2015,
|
|
49
76
|
seed: seed2015(b, dates, b.todaysPrices),
|
|
@@ -60,21 +87,22 @@ export function holdings(b) {
|
|
|
60
87
|
}
|
|
61
88
|
/** The legacy section's final-salary award over the periods valued on
|
|
62
89
|
* final salary, which the election decides. */
|
|
63
|
-
export function legacyAward(b,
|
|
64
|
-
const rules = RULES[
|
|
90
|
+
export function legacyAward(b, { section, valued }, dates) {
|
|
91
|
+
const rules = RULES[section];
|
|
65
92
|
const benefit = finalSalaryBenefit(rules, {
|
|
66
93
|
windows: membershipOf(valued, dates.leaving),
|
|
67
94
|
payPath: b.payPath, dateOfBirth: b.born, ...dates,
|
|
68
95
|
prices: b.cashPrices,
|
|
69
96
|
});
|
|
70
97
|
return {
|
|
71
|
-
section
|
|
98
|
+
section,
|
|
72
99
|
periods: valued,
|
|
73
|
-
|
|
100
|
+
pensionBeforeFactor: benefit.pensionBeforeFactor,
|
|
74
101
|
pension: benefit.pension,
|
|
75
102
|
automaticLumpSum: benefit.automaticLumpSum,
|
|
76
103
|
automaticLumpSumBeforeFactor: benefit.automaticLumpSumBeforeFactor,
|
|
77
|
-
|
|
104
|
+
pensionFactor: benefit.pensionFactor,
|
|
105
|
+
automaticLumpSumFactor: benefit.automaticLumpSumFactor,
|
|
78
106
|
ledgers: null,
|
|
79
107
|
provenance: {
|
|
80
108
|
accrual: ACCRUALS.finalSalary,
|
|
@@ -97,11 +125,12 @@ export function careerAward(b, { section, window, seedFor }, dates) {
|
|
|
97
125
|
award: {
|
|
98
126
|
section,
|
|
99
127
|
periods: [window],
|
|
100
|
-
|
|
128
|
+
pensionBeforeFactor: moneyAt({ nominal: cash.revalued, real: todays.revalued }, dates.drawing),
|
|
101
129
|
pension: moneyAt({ nominal: cash.drawn, real: todays.drawn }, dates.drawing),
|
|
102
130
|
automaticLumpSum: noLumpSum,
|
|
103
131
|
automaticLumpSumBeforeFactor: noLumpSum,
|
|
104
|
-
|
|
132
|
+
pensionFactor: cash.factor,
|
|
133
|
+
automaticLumpSumFactor: null,
|
|
105
134
|
ledgers: { cash: cash.ledger, todaysMoney: todays.ledger },
|
|
106
135
|
provenance: { accrual: ACCRUALS.careerAverage },
|
|
107
136
|
},
|
|
@@ -137,15 +166,62 @@ export function section2015(b, own, { leaving, drawing }) {
|
|
|
137
166
|
curve: buildCurve(run(own.cash, cashHistory), run(own.todays, todaysHistory)),
|
|
138
167
|
};
|
|
139
168
|
}
|
|
169
|
+
/**
|
|
170
|
+
* The same walk as the ledger alone, with no drawing on it, through the
|
|
171
|
+
* scheme year ending in `through`: what the window holds on any date to
|
|
172
|
+
* then, before any early or late factor. A valuation that never draws has
|
|
173
|
+
* no factor to read, and a factor read for a drawing far past the pension
|
|
174
|
+
* age is one GAD's tables may not price.
|
|
175
|
+
*/
|
|
176
|
+
export function accruedLedger(b, { window, seed, prices }, { leaving, drawing }, through) {
|
|
177
|
+
return buildLedger({
|
|
178
|
+
seed,
|
|
179
|
+
payIn: payInside(b, window, leaving),
|
|
180
|
+
exitDate: leaving,
|
|
181
|
+
retirementDate: drawing,
|
|
182
|
+
prices,
|
|
183
|
+
through,
|
|
184
|
+
drawingFor: () => null,
|
|
185
|
+
});
|
|
186
|
+
}
|
|
187
|
+
/** Refuse a leaving after the one the member declared, naming `asked`,
|
|
188
|
+
* the call a caller was answering: service that has ended cannot run on. */
|
|
189
|
+
export function refuseLeavingAfterDeclared(asked, b, leaving) {
|
|
190
|
+
const left = declaredLeaving(b);
|
|
191
|
+
if (left !== null && left < leaving) {
|
|
192
|
+
throw new RangeError(`${asked}: leaving after the member already left, on `
|
|
193
|
+
+ `${b.ordinary2015.to}`);
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
/**
|
|
197
|
+
* The legacy section's final-salary pension and automatic lump sum held on
|
|
198
|
+
* `on`, unreduced, in today's money: membership to that day, on final pay
|
|
199
|
+
* measured back from it, as a leaving on it is measured. Where the member
|
|
200
|
+
* `left` before `on`, both are measured at leaving. `left` is the caller's:
|
|
201
|
+
* today's holdings read the declared leaving, and a tax year's input the
|
|
202
|
+
* leaving it was asked about.
|
|
203
|
+
*/
|
|
204
|
+
export function finalSalaryHeldOn(b, { section, valued }, on, left) {
|
|
205
|
+
const asAt = left === null ? on : earliest(left, on);
|
|
206
|
+
const { pension, automaticLumpSum } = unreducedPension(RULES[section], membershipOf(valued, asAt), b.payPath, asAt);
|
|
207
|
+
return { pension, automaticLumpSum };
|
|
208
|
+
}
|
|
209
|
+
/** The dates a walk that never draws runs to: leaving, and a drawing at
|
|
210
|
+
* the pension age or at leaving where that is later. It reads no factor,
|
|
211
|
+
* so the drawing decides only which years after leaving are deferred. */
|
|
212
|
+
export function walkDates(b, leaving) {
|
|
213
|
+
return { leaving, drawing: leaving < b.npaOn ? b.npaOn : leaving };
|
|
214
|
+
}
|
|
215
|
+
/** The member's last day of service, as they declared it; null while they
|
|
216
|
+
* serve. The 2015 Section is the one every member serves in last. */
|
|
217
|
+
function declaredLeaving(b) {
|
|
218
|
+
return b.ordinary2015.to === null ? null : isoToDate(b.ordinary2015.to);
|
|
219
|
+
}
|
|
140
220
|
/** A career average walk over `window`, accruing only inside it. */
|
|
141
221
|
function walk(b, { window, seed, prices }, { leaving, drawing }) {
|
|
142
|
-
const first = schemeYearEndFor(isoToDate(window.from));
|
|
143
|
-
const last = schemeYearEndFor(until(window, leaving));
|
|
144
222
|
return careerAverage({
|
|
145
223
|
seed,
|
|
146
|
-
payIn: (
|
|
147
|
-
? b.payPath.payFor(year)
|
|
148
|
-
: null),
|
|
224
|
+
payIn: payInside(b, window, leaving),
|
|
149
225
|
dateOfBirth: b.born,
|
|
150
226
|
leaving,
|
|
151
227
|
drawing,
|
|
@@ -153,6 +229,15 @@ function walk(b, { window, seed, prices }, { leaving, drawing }) {
|
|
|
153
229
|
through: walkThrough(drawing, b.npaOn),
|
|
154
230
|
});
|
|
155
231
|
}
|
|
232
|
+
/** Pay for the scheme years `window` accrues in, to `leaving`; none
|
|
233
|
+
* outside it. */
|
|
234
|
+
function payInside(b, window, leaving) {
|
|
235
|
+
const first = schemeYearEndFor(isoToDate(window.from));
|
|
236
|
+
const last = schemeYearEndFor(until(window, leaving));
|
|
237
|
+
return (year) => (year >= first && year <= last
|
|
238
|
+
? b.payPath.payFor(year)
|
|
239
|
+
: null);
|
|
240
|
+
}
|
|
156
241
|
/** The legacy windows as final-salary membership, to `leaving`. */
|
|
157
242
|
function membershipOf(valued, leaving) {
|
|
158
243
|
return valued
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"valuation.js","sourceRoot":"","sources":["../../src/member/valuation.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"valuation.js","sourceRoot":"","sources":["../../src/member/valuation.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,34 +1,15 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* The final-salary engine the 1995 and 2008 Sections share. What
|
|
3
|
-
* differs between them is statute — the denominator, the pay measure,
|
|
4
|
-
* the lump sum, which factors apply — and each section holds its own
|
|
5
|
-
* rules privately, so no caller can compose a combination the scheme
|
|
6
|
-
* lacks, such as a 60 denominator on best-single-year pay.
|
|
7
|
-
*/
|
|
8
1
|
import type { FactorOutcome } from '../factor-basis.js';
|
|
9
2
|
import type { PayPath } from '../pay-path.js';
|
|
10
3
|
import type { ProjectionMoney } from '../pension/money.js';
|
|
11
4
|
import type { Prices } from '../pension/prices.js';
|
|
12
|
-
/**
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
/** The last day of service in it, inclusive. */
|
|
16
|
-
readonly to: Date;
|
|
17
|
-
}
|
|
18
|
-
/** How a section measures final pay, named for an award's provenance.
|
|
19
|
-
* The measuring itself is each section's own `finalPay`. */
|
|
20
|
-
export declare const PAY_MEASURES: {
|
|
21
|
-
readonly bestSingleOf3: "best-single-of-3";
|
|
22
|
-
readonly meanOf3ConsecutiveIn10: "mean-of-3-consecutive-in-10";
|
|
23
|
-
};
|
|
24
|
-
export type PayMeasure = (typeof PAY_MEASURES)[keyof typeof PAY_MEASURES];
|
|
25
|
-
/** A factor for a final-salary benefit drawn on `drawn`. */
|
|
26
|
-
type FactorFor = (dateOfBirth: Date, leaving: Date, drawn: Date) => FactorOutcome;
|
|
5
|
+
/** The fraction of final pay a year of membership earns: an 80th in the
|
|
6
|
+
* 1995 Section, a 60th in the 2008. */
|
|
7
|
+
type Denominator = 80 | 60;
|
|
27
8
|
/** One section's statute, private to that section: each rule is the
|
|
28
9
|
* section's own behaviour, so the engine never branches on which
|
|
29
10
|
* section it is valuing. */
|
|
30
11
|
export interface FinalSalaryRules {
|
|
31
|
-
readonly denominator:
|
|
12
|
+
readonly denominator: Denominator;
|
|
32
13
|
readonly payMeasure: PayMeasure;
|
|
33
14
|
/** The age the section's pension is payable unreduced, in whole
|
|
34
15
|
* years: what its early and late factors are measured from. */
|
|
@@ -37,9 +18,8 @@ export interface FinalSalaryRules {
|
|
|
37
18
|
* section's `pensionFactor` must agree, which
|
|
38
19
|
* `section-factors.test.ts` asserts. */
|
|
39
20
|
readonly lateUplift: boolean;
|
|
40
|
-
/** Final pay in today's money
|
|
41
|
-
|
|
42
|
-
finalPay(payPath: PayPath, lastYear: number): number;
|
|
21
|
+
/** Final pay in today's money, measured back from `leaving`. */
|
|
22
|
+
finalPay(payPath: PayPath, leaving: Date): number;
|
|
43
23
|
readonly pensionFactor: FactorFor;
|
|
44
24
|
/** The automatic lump sum, as a multiple of the unreduced pension,
|
|
45
25
|
* and the factor it is reduced by; null where the section pays
|
|
@@ -49,35 +29,40 @@ export interface FinalSalaryRules {
|
|
|
49
29
|
readonly factor: FactorFor;
|
|
50
30
|
} | null;
|
|
51
31
|
}
|
|
52
|
-
/**
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
*
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
pension: number;
|
|
69
|
-
automaticLumpSum: number;
|
|
70
|
-
};
|
|
32
|
+
/** A factor for a final-salary benefit drawn on `drawn`. */
|
|
33
|
+
type FactorFor = (dateOfBirth: Date, leaving: Date, drawn: Date) => FactorOutcome;
|
|
34
|
+
/** A window of service valued on final salary, as dates. */
|
|
35
|
+
export interface Membership {
|
|
36
|
+
readonly from: Date;
|
|
37
|
+
/** The last day of service in it, inclusive. */
|
|
38
|
+
readonly to: Date;
|
|
39
|
+
}
|
|
40
|
+
/** A final-salary pension before any factor, and what it is measured
|
|
41
|
+
* from, in today's money. */
|
|
42
|
+
export interface UnreducedPension {
|
|
43
|
+
readonly membership: number;
|
|
44
|
+
readonly finalPay: number;
|
|
45
|
+
readonly pension: number;
|
|
46
|
+
readonly automaticLumpSum: number;
|
|
47
|
+
}
|
|
71
48
|
/** A final-salary pension and lump sum, before and after factors. */
|
|
72
49
|
interface FinalSalaryBenefit {
|
|
73
|
-
readonly
|
|
50
|
+
readonly pensionBeforeFactor: ProjectionMoney;
|
|
74
51
|
readonly pension: ProjectionMoney;
|
|
75
52
|
readonly automaticLumpSum: ProjectionMoney;
|
|
76
53
|
readonly automaticLumpSumBeforeFactor: ProjectionMoney;
|
|
77
|
-
readonly
|
|
54
|
+
readonly pensionFactor: FactorOutcome;
|
|
55
|
+
readonly automaticLumpSumFactor: FactorOutcome | null;
|
|
78
56
|
readonly membership: number;
|
|
79
57
|
readonly finalPay: number;
|
|
80
58
|
}
|
|
59
|
+
/** How a section measures final pay, named for an award's provenance.
|
|
60
|
+
* The measuring itself is each section's own `finalPay`. */
|
|
61
|
+
export declare const PAY_MEASURES: {
|
|
62
|
+
readonly bestSingleOf3: "best-single-of-3";
|
|
63
|
+
readonly meanOf3ConsecutiveIn10: "mean-of-3-consecutive-in-10";
|
|
64
|
+
};
|
|
65
|
+
export type PayMeasure = (typeof PAY_MEASURES)[keyof typeof PAY_MEASURES];
|
|
81
66
|
/**
|
|
82
67
|
* Value final-salary membership at a drawing.
|
|
83
68
|
*
|
|
@@ -95,4 +80,36 @@ export declare function finalSalaryBenefit(rules: FinalSalaryRules, { windows, p
|
|
|
95
80
|
readonly drawing: Date;
|
|
96
81
|
readonly prices: Prices;
|
|
97
82
|
}): FinalSalaryBenefit;
|
|
83
|
+
/**
|
|
84
|
+
* A final-salary pension before any factor, in today's money: the
|
|
85
|
+
* membership, over the denominator, times final pay measured back from
|
|
86
|
+
* `leaving`. The one place the formula is written, so the pension
|
|
87
|
+
* held today and the pension drawn cannot come to disagree.
|
|
88
|
+
*/
|
|
89
|
+
export declare function unreducedPension(rules: FinalSalaryRules, windows: readonly Membership[], payPath: PayPath, leaving: Date): UnreducedPension;
|
|
90
|
+
/**
|
|
91
|
+
* The 1995 Section's measure: the best single year of the last three,
|
|
92
|
+
* each year the 12 months ending on a leaving anniversary. SI 1995/300
|
|
93
|
+
* reg C1(6): "final year's pensionable pay" is "pensionable pay in
|
|
94
|
+
* respect of the member's last year of pensionable employment, ending on
|
|
95
|
+
* the date the member ceases to be in such employment", unless "pensionable
|
|
96
|
+
* pay was greater in either or both of the 2 consecutive years immediately
|
|
97
|
+
* preceding the last year".
|
|
98
|
+
*/
|
|
99
|
+
export declare function bestSingleOf3(payPath: PayPath, leaving: Date): number;
|
|
100
|
+
/**
|
|
101
|
+
* The 2008 Section's measure: the best average of three consecutive
|
|
102
|
+
* years in the last ten, measured back from leaving, each "revalued to
|
|
103
|
+
* current terms", which a path already in today's money is. SI 2008/653
|
|
104
|
+
* reg 2.A.10(5)(b) compares "the period of 1095 days immediately
|
|
105
|
+
* preceding the relevant day (Period 1)", then "the period of 1095 days
|
|
106
|
+
* which overlaps Period 1 by 730 days (Period 2)", "and so on", and
|
|
107
|
+
* 2.A.10(6) takes the one that begins "within the period of 10 years
|
|
108
|
+
* ending with the relevant day" with the highest pay; for a leaver,
|
|
109
|
+
* 2.A.10(5)(a)(i) makes the relevant day "the day on which the member's
|
|
110
|
+
* active membership ceases". The short-service rule of 2.A.10(7), for
|
|
111
|
+
* under 1095 days' service in the ten years, is not modelled: it moves
|
|
112
|
+
* only a member with less than three years' service before leaving.
|
|
113
|
+
*/
|
|
114
|
+
export declare function meanOf3ConsecutiveIn10(payPath: PayPath, leaving: Date): number;
|
|
98
115
|
export {};
|