@casomoltd/nhs-pay 0.10.4 → 0.12.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.
Files changed (69) hide show
  1. package/README.md +48 -0
  2. package/dist/award.d.ts +8 -8
  3. package/dist/award.js +8 -8
  4. package/dist/circulars/england-md-1-2026r.d.ts +2 -3
  5. package/dist/circulars/england-md-1-2026r.js +2 -3
  6. package/dist/circulars/england-md-1-2026r.js.map +1 -1
  7. package/dist/circulars/ni-hsc-tc8-05-2025.d.ts +2 -2
  8. package/dist/circulars/ni-hsc-tc8-05-2025.js +2 -2
  9. package/dist/circulars/scotland-pcs-dd-2025-01.d.ts +2 -3
  10. package/dist/circulars/scotland-pcs-dd-2025-01.js +2 -3
  11. package/dist/circulars/scotland-pcs-dd-2025-01.js.map +1 -1
  12. package/dist/circulars/scotland-pcs-dd-2026-01.d.ts +2 -2
  13. package/dist/circulars/scotland-pcs-dd-2026-01.js +2 -2
  14. package/dist/circulars/wales-mdw-01-2025.d.ts +2 -2
  15. package/dist/circulars/wales-mdw-01-2025.js +2 -2
  16. package/dist/circulars/wales-mdw-01-2026.d.ts +2 -2
  17. package/dist/circulars/wales-mdw-01-2026.js +2 -2
  18. package/dist/format.d.ts +8 -0
  19. package/dist/format.js +14 -0
  20. package/dist/format.js.map +1 -1
  21. package/dist/gad/erf-2023-06-30.d.ts +39 -3
  22. package/dist/gad/erf-2023-06-30.js +39 -3
  23. package/dist/gad/erf-2023-06-30.js.map +1 -1
  24. package/dist/gad/factor-table.d.ts +10 -0
  25. package/dist/gad/factor-table.js.map +1 -1
  26. package/dist/gad/lrf-2023-06-30.d.ts +39 -3
  27. package/dist/gad/lrf-2023-06-30.js +39 -3
  28. package/dist/gad/lrf-2023-06-30.js.map +1 -1
  29. package/dist/hcas-pcts.js +3 -1
  30. package/dist/hcas-pcts.js.map +1 -1
  31. package/dist/index.d.ts +15 -4
  32. package/dist/index.js +17 -5
  33. package/dist/index.js.map +1 -1
  34. package/dist/npa.d.ts +28 -0
  35. package/dist/npa.js +60 -0
  36. package/dist/npa.js.map +1 -0
  37. package/dist/pension/history.d.ts +105 -0
  38. package/dist/pension/history.js +115 -0
  39. package/dist/pension/history.js.map +1 -0
  40. package/dist/pension/ledger.d.ts +146 -0
  41. package/dist/pension/ledger.js +193 -0
  42. package/dist/pension/ledger.js.map +1 -0
  43. package/dist/pension/prices.d.ts +125 -0
  44. package/dist/pension/prices.js +108 -0
  45. package/dist/pension/prices.js.map +1 -0
  46. package/dist/pension/seed.d.ts +75 -0
  47. package/dist/pension/seed.js +82 -0
  48. package/dist/pension/seed.js.map +1 -0
  49. package/dist/pension/uplift.d.ts +151 -0
  50. package/dist/pension/uplift.js +135 -0
  51. package/dist/pension/uplift.js.map +1 -0
  52. package/dist/pension-projection.d.ts +249 -12
  53. package/dist/pension-projection.js +406 -101
  54. package/dist/pension-projection.js.map +1 -1
  55. package/dist/pension.js +9 -10
  56. package/dist/pension.js.map +1 -1
  57. package/dist/post.d.ts +24 -16
  58. package/dist/post.js +2 -3
  59. package/dist/post.js.map +1 -1
  60. package/dist/revaluation.d.ts +189 -0
  61. package/dist/revaluation.js +270 -0
  62. package/dist/revaluation.js.map +1 -0
  63. package/dist/scales.d.ts +17 -10
  64. package/dist/scales.js +17 -10
  65. package/dist/scales.js.map +1 -1
  66. package/dist/take-home.d.ts +9 -5
  67. package/dist/take-home.js +9 -5
  68. package/dist/take-home.js.map +1 -1
  69. package/package.json +2 -2
package/dist/pension.js CHANGED
@@ -113,9 +113,10 @@ const NATION_TO_SCHEME = {
113
113
  [NATION_KEYS.scotland]: PENSION_SCHEMES.sppa,
114
114
  [NATION_KEYS.northernIreland]: PENSION_SCHEMES.hsc,
115
115
  };
116
- // NHSBSA (England & Wales). Sources (member contribution rates):
117
- // 2025/26 https://www.nhsbsa.nhs.uk/nhs-pensions-contribution-rates-202526
118
- // 2026/27 https://www.nhsbsa.nhs.uk/member-hub/cost-being-scheme
116
+ // NHSBSA (England & Wales). Sources (member contribution rates),
117
+ // named as in docs/source-archive.md:
118
+ // 2025/26 "NHSBSA — contribution rates 2025/26"
119
+ // 2026/27 "NHSBSA — cost of being in the Scheme"
119
120
  // Six tiers; rates unchanged year-on-year, thresholds re-based to the
120
121
  // AfC award. Pinned in tests/fixtures/pension-tiers.csv.
121
122
  const NHSBSA_2025_26 = [
@@ -139,10 +140,9 @@ const NHSBSA_2026_27 = [
139
140
  // — bands in the current scheme year's terms, applied to a member's
140
141
  // current-year annualised pensionable pay). Pinned in
141
142
  // tests/fixtures/pension-tiers.csv.
142
- // 2025/26 SPPA circular 2025/07 (3 Jul 2025), Table 2:
143
- // https://pensions.gov.scot/sites/default/files/2025-07/NHS_Circular_2025-07_Employee_contribution_tiers_2025-26.pdf
144
- // 2026/27 SPPA circular 2026/03 (9 Mar 2026), Table 2:
145
- // https://pensions.gov.scot/sites/default/files/2026-03/2026_03_-_NHS_Employee_contribution_tier_bandings_from_1_April_2026.pdf
143
+ // 2025/26: "SPPA, NHS Circular 2025/07" (3 Jul 2025), Table 2
144
+ // 2026/27: "SPPA, NHS Circular 2026/03" (9 Mar 2026), Table 2
145
+ // Both in docs/source-archive.md.
146
146
  const SPPA_2025_26 = [
147
147
  { tier: 1, min: 0, max: 13330, rate: 0.057 },
148
148
  { tier: 2, min: 13331, max: 27899, rate: 0.064 },
@@ -165,9 +165,8 @@ const SPPA_2026_27 = [
165
165
  { tier: 8, min: 59370, max: 83026, rate: 0.116 },
166
166
  { tier: 9, min: 83027, max: Infinity, rate: 0.127 },
167
167
  ];
168
- // HSC (Northern Ireland). Source: HSC Pension Service member
169
- // contribution rates:
170
- // https://hscpensions.hscni.net/hsc-pension-scheme/hsc-pension-members-section/membership-contributions-pay/
168
+ // HSC (Northern Ireland). Source: "HSC Pensions NI — member
169
+ // contributions" — see docs/source-archive.md.
171
170
  // Six tiers; rates higher than NHSBSA in tiers 2-6. HSC sets its own
172
171
  // thresholds AND rates — the 2025/26 bands differ from NHSBSA 2025/26.
173
172
  const HSC_2025_26 = [
@@ -1 +1 @@
1
- {"version":3,"file":"pension.js","sourceRoot":"","sources":["../src/pension.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"pension.js","sourceRoot":"","sources":["../src/pension.ts"],"names":[],"mappings":"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"}
package/dist/post.d.ts CHANGED
@@ -35,22 +35,31 @@ export interface PostAdjustments {
35
35
  * 1 October 2022 the contribution tier and pension are based on
36
36
  * ACTUAL (pro-rated) pensionable pay, not whole-time-equivalent —
37
37
  * so FTE scales pensionable pay before the tier is chosen.
38
- * Source: NHSBSA pay & contributions
39
- * https://www.nhsbsa.nhs.uk/employer-hub/technical-guidance/pay-and-contributions
38
+ * Source: "NHSBSA — employer pay & contributions" — see
39
+ * docs/source-archive.md.
40
40
  */
41
41
  readonly fte: number;
42
42
  /**
43
- * Annual salary sacrificed (£). A genuine sacrifice reduces
44
- * contractual pay, so it lowers the tax- and NI-assessable gross
45
- * AND — in the default NHS model (England/Wales, and Scotland since
46
- * December 2023) — pensionable pay too, dropping the pension tier
47
- * and base. NOT modelled: the Scotland carve-out where cycle-to-work
48
- * and childcare vouchers leave pensionable pay untouched, and OpRA
49
- * (post-2017) valuation for non-exempt benefits. In any case salary
50
- * sacrifice is unavailable to most staff on standard AfC contracts.
51
- * Sources: BMA salary-sacrifice
52
- * https://www.bma.org.uk/pay-and-contracts/pensions/pensions-tax/salary-sacrifice-schemes ;
53
- * NHS Employers https://www.nhsemployers.org/articles/salary-sacrifice-schemes
43
+ * Annual salary sacrificed (£). This field carries the NHS half
44
+ * of the rule only: in the default NHS model (England/Wales, and
45
+ * Scotland since December 2023) a sacrifice reduces PENSIONABLE
46
+ * pay, dropping the contribution tier and the base it applies to.
47
+ * NOT modelled: the Scotland carve-out where cycle-to-work and
48
+ * childcare vouchers leave pensionable pay untouched. In any case
49
+ * salary sacrifice is unavailable to most staff on standard AfC
50
+ * contracts.
51
+ * Sources: "NHSBSA 2015 Members' Guide V13" (#sa-38) and
52
+ * "NHSBSA — cost of being in the Scheme" (#sa-20) — see
53
+ * docs/source-archive.md.
54
+ *
55
+ * That a sacrifice also lowers the tax- and NI-assessable gross
56
+ * is GENERIC PAYE, not NHS practice, and is paye-calc's rule to
57
+ * state and to cite — it is applied there, by `PensionBasis
58
+ * .SalarySacrifice`. Likewise OpRA (post-2017) valuation of
59
+ * non-exempt benefits, which neither library models. This
60
+ * library subtracts the sacrifice once, from pensionable pay,
61
+ * and hands the reduced figure over; it should not carry a
62
+ * second, borrowed citation for what happens next.
54
63
  */
55
64
  readonly salarySacrifice: number;
56
65
  /** Student-loan plans being repaid — forwarded to paye-calc. */
@@ -91,9 +100,8 @@ export declare class Post {
91
100
  * ACTUAL (not whole-time-equivalent) pensionable pay. Under this
92
101
  * model all salary sacrifice reduces both bases, so pensionable pay
93
102
  * also serves as the tax/NI-assessable gross handed to the engine.
94
- * Sources: NHSBSA 2015 Members Guide
95
- * https://www.nhsbsa.nhs.uk/sites/default/files/2024-05/2015%20Members%20Guide%20%28V13%29%2005.2024.pdf ;
96
- * cost of being in the scheme https://www.nhsbsa.nhs.uk/member-hub/cost-being-scheme
103
+ * Sources: "NHSBSA 2015 Members' Guide V13" and "NHSBSA —
104
+ * cost of being in the Scheme" — see docs/source-archive.md.
97
105
  */
98
106
  get pensionablePay(): number;
99
107
  /**
package/dist/post.js CHANGED
@@ -57,9 +57,8 @@ export class Post {
57
57
  * ACTUAL (not whole-time-equivalent) pensionable pay. Under this
58
58
  * model all salary sacrifice reduces both bases, so pensionable pay
59
59
  * also serves as the tax/NI-assessable gross handed to the engine.
60
- * Sources: NHSBSA 2015 Members Guide
61
- * https://www.nhsbsa.nhs.uk/sites/default/files/2024-05/2015%20Members%20Guide%20%28V13%29%2005.2024.pdf ;
62
- * cost of being in the scheme https://www.nhsbsa.nhs.uk/member-hub/cost-being-scheme
60
+ * Sources: "NHSBSA 2015 Members' Guide V13" and "NHSBSA —
61
+ * cost of being in the Scheme" — see docs/source-archive.md.
63
62
  */
64
63
  get pensionablePay() {
65
64
  const fteSalary = Math.round(this.salary * this.adjustments.fte);
package/dist/post.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"post.js","sourceRoot":"","sources":["../src/post.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"post.js","sourceRoot":"","sources":["../src/post.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,189 @@
1
+ /**
2
+ * In-service (CARE) revaluation for the NHS 2015 Scheme.
3
+ *
4
+ * An active member's accrued pension is revalued each year at
5
+ * **CPI + 1.5 percentage points**, where CPI is the Treasury
6
+ * Order figure (September to September). The emphasis is the
7
+ * point: it is ADDED, not compounded. 3.1% CPI gives 4.6%,
8
+ * not the 4.6465% that (1.031 x 1.015) would produce.
9
+ *
10
+ * Sources — the legal one first. Each is named as it appears in
11
+ * docs/source-archive.md, which holds every publisher URL and
12
+ * archived copy so that this file names documents and links
13
+ * none:
14
+ *
15
+ * HM Treasury Public Service Pensions Revaluation Orders, made
16
+ * under s.9(2) Public Service Pensions Act 2013. These are the
17
+ * legal source of the prices figure; each row below carries the
18
+ * SI that made it, and an SI number resolves on
19
+ * legislation.gov.uk without a link from here.
20
+ *
21
+ * "HM Treasury HCWS437 — Public Service Pension
22
+ * Scheme Indexation and Revaluation 2025", the
23
+ * Chief Secretary's annual written ministerial statement. Its
24
+ * per-scheme table gives NHS active revaluation as 3.2%
25
+ * independently of the Order and of the valuation report, and
26
+ * states why the date moved to 6 April.
27
+ *
28
+ * "SPPA NHS Circular 2023/01 — pension indexation and CARE
29
+ * revaluation" — the clearest annual statement of the exact NHS
30
+ * in-service rate. Scotland, but the same CPI + 1.5% rule and
31
+ * the same rate as England and Wales.
32
+ *
33
+ * "NHS Pension Scheme Valuation Report 2020", Appendix E
34
+ * "Inter-valuation events" — the in-service revaluation as
35
+ * ACTUALLY APPLIED, year by year from April 2016. This is the
36
+ * rate column's source, and it is independent of the orders.
37
+ *
38
+ * "SI 2015/94 Sch 9 para 3 — revaluation": the NHS Pension
39
+ * Scheme Regulations 2015 add 1.5 to the prices "increase or
40
+ * decrease", and pro-rate a leaver's final year by COMPLETE
41
+ * MONTHS.
42
+ *
43
+ * "NHSBSA KA-02728 — how your pension is revalued", on how it is
44
+ * applied to members and on the date change below.
45
+ *
46
+ * Cross-checked against the "Revaluation" column of a member's
47
+ * Annual Benefit Statement (2015 Section, updated to
48
+ * 31/03/2025; name and membership number redacted), which
49
+ * quoted 4.6, 11.6, 8.2 and 3.2 for the years to 2025 — the
50
+ * rates above as actually applied to a real record, rather
51
+ * than as legislated. Nothing else from that document is used
52
+ * here: the earnings beside that column are the member's.
53
+ * Archived as "Annual Benefit Statement, 2015 Section,
54
+ * redacted" — see docs/source-archive.md.
55
+ *
56
+ * ── Three facts this data carries ───────────────────
57
+ *
58
+ * **The revaluation date moved.** It was 1 April; from 2023 it
59
+ * is 6 April, changed to manage the interaction with the
60
+ * annual allowance. `appliedOn` records it per year rather
61
+ * than letting a scheme-year boundary be assumed.
62
+ *
63
+ * **CPI is sourced independently of the rate**, never derived
64
+ * from it. Taking `septemberCpiPct = ratePct - 1.5` would make
65
+ * the test that checks the +1.5 rule agree with itself, which
66
+ * is no test at all. So the two columns come from two
67
+ * documents that do not cite each other: prices from each
68
+ * Treasury Order's own operative words, and the rate AS
69
+ * APPLIED from the 2020 valuation report's inter-valuation
70
+ * table. They agree on all eleven years.
71
+ *
72
+ * **A negative prices figure is carried through, not floored.**
73
+ * September 2015 CPI was -0.1% and the 2016 order specifies a
74
+ * DECREASE. The scheme applied 1.4% — that decrease with 1.5
75
+ * added — because Sch 9 para 3 of the 2015 Regulations says to
76
+ * add 1.5 to the percentage increase "or decrease" in prices.
77
+ * The zero floor people expect belongs to a different
78
+ * instrument: the Pensions Increase (Review) Order, which gave
79
+ * deferred members and pensions in payment 0.0% that same
80
+ * April. Active and deferred genuinely diverge in a deflation
81
+ * year, so neither can be modelled as the other.
82
+ *
83
+ * ── This table is COMPLETE ──────────────────────────
84
+ *
85
+ * The 2015 Scheme began on 1 April 2015, so the first
86
+ * in-service revaluation was applied in April 2016. All eleven
87
+ * years to 2026 are here, which is what lets a projection walk
88
+ * a member's whole membership rather than only the part since
89
+ * their statement. `revaluationFor` still returns null rather
90
+ * than guessing for a year not held — which now means only a
91
+ * year whose order has not yet been made.
92
+ *
93
+ * The projection in pension-projection.ts compounds rather
94
+ * than adds — https://github.com/casomoltd/nhs-pay/issues/10
95
+ *
96
+ * ── Not this table ──────────────────────────────────
97
+ *
98
+ * Deferred 2015 benefits and all pensions in payment rise by
99
+ * CPI ALONE, under the Pensions Increase (Review) Orders — a
100
+ * different instrument. For 1995/2008 practitioners the
101
+ * equivalent uplift is earnings dynamisation, not this.
102
+ */
103
+ /** One scheme year's revaluation, and what set it. */
104
+ export interface RevaluationYear {
105
+ /** Scheme year END, e.g. 2022 for the 2021/22 year. */
106
+ readonly yearEnd: number;
107
+ /** The Treasury Order prices figure — the previous
108
+ * September's CPI, as a percentage. Sourced, not derived. */
109
+ readonly septemberCpiPct: number;
110
+ /** The in-service revaluation applied, as a percentage. */
111
+ readonly ratePct: number;
112
+ /** ISO date the MEMBER'S POT moves — not the date the order
113
+ * commences. Every Revaluation Order commences 1 April; the
114
+ * NHS scheme moved its own application to 6 April from 2023
115
+ * to manage the annual-allowance interaction, and SI
116
+ * 2026/254 accommodates that with an express later date for
117
+ * specific schemes. So: 1 April through 2022, 6 April from
118
+ * 2023.
119
+ *
120
+ * Not the Pensions Increase date either, which is a third
121
+ * date again (11 April in 2022, 6 April in 2026) belonging
122
+ * to a different instrument. That is the trap on the 2022
123
+ * row, where 11 April is the date a search turns up. */
124
+ readonly appliedOn: string;
125
+ /** The statutory instrument that made it. */
126
+ readonly si: string;
127
+ }
128
+ /** The bonus the scheme adds to CPI while a member is paying
129
+ * in, in PERCENTAGE POINTS. Added, never compounded. */
130
+ export declare const ACTIVE_REVAL_BONUS_PCT = 1.5;
131
+ /** In-service revaluation, oldest first. Extend when the next
132
+ * Revaluation Order is made — a year's rate is known months
133
+ * before the year it applies to ends. */
134
+ export declare const IN_SERVICE_REVALUATION: readonly RevaluationYear[];
135
+ /** The published rate for a scheme year, or null where the
136
+ * year isn't published — never a silent fallback. */
137
+ export declare function revaluationFor(yearEnd: number): RevaluationYear | null;
138
+ /**
139
+ * The date the pot moves for a given scheme year: 6 April from
140
+ * 2023, 1 April before it — read off the table, never assumed.
141
+ *
142
+ * Lives here rather than with the uplift rule because two
143
+ * callers need it and they must agree: the pension steps on
144
+ * these days, and so must the ruler that reads it. When they
145
+ * disagreed by the five days between 1 and 6 April, a ruler
146
+ * anchored in the pre-2023 era counted its own anchor step and
147
+ * deflated a year that had not passed.
148
+ */
149
+ export declare function appliedOnFor(yearEnd: number): Date;
150
+ /** What prices did between two dates, as far as the published
151
+ * orders reach. */
152
+ export interface PublishedInflation {
153
+ /** Compounded CPI factor for every uplift APPLIED in
154
+ * `(from, to]`. 1 when none fall in the window. */
155
+ readonly factor: number;
156
+ /** The date the last counted uplift was applied, or `from`
157
+ * where none were. Everything after it is unpublished and is
158
+ * the caller's problem — normally an assumed rate. */
159
+ readonly publishedTo: Date;
160
+ }
161
+ /**
162
+ * How much prices rose between two dates, using the Treasury
163
+ * Order figures rather than a forecast.
164
+ *
165
+ * **This exists because a past period is a matter of record.**
166
+ * Restating a member's own statement figure in today's money
167
+ * means dividing out the inflation since the statement was
168
+ * made, and that inflation has already happened and already
169
+ * been legislated. Using an assumed CPI there quietly reports
170
+ * a forecast as history.
171
+ *
172
+ * Found by reconciling the statement this file already cites
173
+ * (updated to 31/03/2025, linked above). Between its date and
174
+ * a reading in August 2026 the orders compound to 1.017 x
175
+ * 1.038, where an assumed 2% over the same window gives about
176
+ * 1.028 — so the figure was restated some 2.7% light, and
177
+ * every projection derived from it inherited the gap.
178
+ *
179
+ * **The uplift date is what counts, not the scheme year.** Each
180
+ * order names the day it applies (1 April through 2022, 6 April
181
+ * from 2023), and a member's statement is dated wherever it
182
+ * falls between two of them — so the window is tested against
183
+ * `appliedOn` and nothing is apportioned within a year.
184
+ *
185
+ * Returns how far the published record actually reaches, so a
186
+ * caller can price the remainder itself rather than being
187
+ * handed a number that silently stops early.
188
+ */
189
+ export declare function publishedInflationBetween(from: Date, to: Date): PublishedInflation;
@@ -0,0 +1,270 @@
1
+ /**
2
+ * In-service (CARE) revaluation for the NHS 2015 Scheme.
3
+ *
4
+ * An active member's accrued pension is revalued each year at
5
+ * **CPI + 1.5 percentage points**, where CPI is the Treasury
6
+ * Order figure (September to September). The emphasis is the
7
+ * point: it is ADDED, not compounded. 3.1% CPI gives 4.6%,
8
+ * not the 4.6465% that (1.031 x 1.015) would produce.
9
+ *
10
+ * Sources — the legal one first. Each is named as it appears in
11
+ * docs/source-archive.md, which holds every publisher URL and
12
+ * archived copy so that this file names documents and links
13
+ * none:
14
+ *
15
+ * HM Treasury Public Service Pensions Revaluation Orders, made
16
+ * under s.9(2) Public Service Pensions Act 2013. These are the
17
+ * legal source of the prices figure; each row below carries the
18
+ * SI that made it, and an SI number resolves on
19
+ * legislation.gov.uk without a link from here.
20
+ *
21
+ * "HM Treasury HCWS437 — Public Service Pension
22
+ * Scheme Indexation and Revaluation 2025", the
23
+ * Chief Secretary's annual written ministerial statement. Its
24
+ * per-scheme table gives NHS active revaluation as 3.2%
25
+ * independently of the Order and of the valuation report, and
26
+ * states why the date moved to 6 April.
27
+ *
28
+ * "SPPA NHS Circular 2023/01 — pension indexation and CARE
29
+ * revaluation" — the clearest annual statement of the exact NHS
30
+ * in-service rate. Scotland, but the same CPI + 1.5% rule and
31
+ * the same rate as England and Wales.
32
+ *
33
+ * "NHS Pension Scheme Valuation Report 2020", Appendix E
34
+ * "Inter-valuation events" — the in-service revaluation as
35
+ * ACTUALLY APPLIED, year by year from April 2016. This is the
36
+ * rate column's source, and it is independent of the orders.
37
+ *
38
+ * "SI 2015/94 Sch 9 para 3 — revaluation": the NHS Pension
39
+ * Scheme Regulations 2015 add 1.5 to the prices "increase or
40
+ * decrease", and pro-rate a leaver's final year by COMPLETE
41
+ * MONTHS.
42
+ *
43
+ * "NHSBSA KA-02728 — how your pension is revalued", on how it is
44
+ * applied to members and on the date change below.
45
+ *
46
+ * Cross-checked against the "Revaluation" column of a member's
47
+ * Annual Benefit Statement (2015 Section, updated to
48
+ * 31/03/2025; name and membership number redacted), which
49
+ * quoted 4.6, 11.6, 8.2 and 3.2 for the years to 2025 — the
50
+ * rates above as actually applied to a real record, rather
51
+ * than as legislated. Nothing else from that document is used
52
+ * here: the earnings beside that column are the member's.
53
+ * Archived as "Annual Benefit Statement, 2015 Section,
54
+ * redacted" — see docs/source-archive.md.
55
+ *
56
+ * ── Three facts this data carries ───────────────────
57
+ *
58
+ * **The revaluation date moved.** It was 1 April; from 2023 it
59
+ * is 6 April, changed to manage the interaction with the
60
+ * annual allowance. `appliedOn` records it per year rather
61
+ * than letting a scheme-year boundary be assumed.
62
+ *
63
+ * **CPI is sourced independently of the rate**, never derived
64
+ * from it. Taking `septemberCpiPct = ratePct - 1.5` would make
65
+ * the test that checks the +1.5 rule agree with itself, which
66
+ * is no test at all. So the two columns come from two
67
+ * documents that do not cite each other: prices from each
68
+ * Treasury Order's own operative words, and the rate AS
69
+ * APPLIED from the 2020 valuation report's inter-valuation
70
+ * table. They agree on all eleven years.
71
+ *
72
+ * **A negative prices figure is carried through, not floored.**
73
+ * September 2015 CPI was -0.1% and the 2016 order specifies a
74
+ * DECREASE. The scheme applied 1.4% — that decrease with 1.5
75
+ * added — because Sch 9 para 3 of the 2015 Regulations says to
76
+ * add 1.5 to the percentage increase "or decrease" in prices.
77
+ * The zero floor people expect belongs to a different
78
+ * instrument: the Pensions Increase (Review) Order, which gave
79
+ * deferred members and pensions in payment 0.0% that same
80
+ * April. Active and deferred genuinely diverge in a deflation
81
+ * year, so neither can be modelled as the other.
82
+ *
83
+ * ── This table is COMPLETE ──────────────────────────
84
+ *
85
+ * The 2015 Scheme began on 1 April 2015, so the first
86
+ * in-service revaluation was applied in April 2016. All eleven
87
+ * years to 2026 are here, which is what lets a projection walk
88
+ * a member's whole membership rather than only the part since
89
+ * their statement. `revaluationFor` still returns null rather
90
+ * than guessing for a year not held — which now means only a
91
+ * year whose order has not yet been made.
92
+ *
93
+ * The projection in pension-projection.ts compounds rather
94
+ * than adds — https://github.com/casomoltd/nhs-pay/issues/10
95
+ *
96
+ * ── Not this table ──────────────────────────────────
97
+ *
98
+ * Deferred 2015 benefits and all pensions in payment rise by
99
+ * CPI ALONE, under the Pensions Increase (Review) Orders — a
100
+ * different instrument. For 1995/2008 practitioners the
101
+ * equivalent uplift is earnings dynamisation, not this.
102
+ */
103
+ /** The bonus the scheme adds to CPI while a member is paying
104
+ * in, in PERCENTAGE POINTS. Added, never compounded. */
105
+ export const ACTIVE_REVAL_BONUS_PCT = 1.5;
106
+ /** In-service revaluation, oldest first. Extend when the next
107
+ * Revaluation Order is made — a year's rate is known months
108
+ * before the year it applies to ends. */
109
+ export const IN_SERVICE_REVALUATION = [
110
+ {
111
+ // The scheme's FIRST uplift, and the only one from a
112
+ // negative prices figure: September 2015 CPI was -0.1%
113
+ // and the order says so in terms ("a decrease of 0.1 per
114
+ // cent"). The scheme added 1.5 to that decrease rather
115
+ // than flooring it at zero first, which is why this row
116
+ // is 1.4 and not 1.5 - see the header. Its SI is titled
117
+ // "Revaluation (Prices) Order"; later years drop the
118
+ // qualifier.
119
+ yearEnd: 2016,
120
+ septemberCpiPct: -0.1,
121
+ ratePct: 1.4,
122
+ appliedOn: '2016-04-01',
123
+ si: 'SI 2016/438',
124
+ },
125
+ {
126
+ yearEnd: 2017,
127
+ septemberCpiPct: 1.0,
128
+ ratePct: 2.5,
129
+ appliedOn: '2017-04-01',
130
+ si: 'SI 2017/242',
131
+ },
132
+ {
133
+ yearEnd: 2018,
134
+ septemberCpiPct: 3.0,
135
+ ratePct: 4.5,
136
+ appliedOn: '2018-04-01',
137
+ si: 'SI 2018/338',
138
+ },
139
+ {
140
+ yearEnd: 2019,
141
+ septemberCpiPct: 2.4,
142
+ ratePct: 3.9,
143
+ appliedOn: '2019-04-01',
144
+ si: 'SI 2019/455',
145
+ },
146
+ {
147
+ yearEnd: 2020,
148
+ septemberCpiPct: 1.7,
149
+ ratePct: 3.2,
150
+ appliedOn: '2020-04-01',
151
+ si: 'SI 2020/230',
152
+ },
153
+ {
154
+ yearEnd: 2021,
155
+ septemberCpiPct: 0.5,
156
+ ratePct: 2.0,
157
+ appliedOn: '2021-04-01',
158
+ si: 'SI 2021/276',
159
+ },
160
+ {
161
+ yearEnd: 2022,
162
+ septemberCpiPct: 3.1,
163
+ ratePct: 4.6,
164
+ appliedOn: '2022-04-01',
165
+ si: 'SI 2022/215',
166
+ },
167
+ {
168
+ yearEnd: 2023,
169
+ septemberCpiPct: 10.1,
170
+ ratePct: 11.6,
171
+ appliedOn: '2023-04-06',
172
+ si: 'SI 2023/252',
173
+ },
174
+ {
175
+ yearEnd: 2024,
176
+ septemberCpiPct: 6.7,
177
+ ratePct: 8.2,
178
+ appliedOn: '2024-04-06',
179
+ si: 'SI 2024/290',
180
+ },
181
+ {
182
+ yearEnd: 2025,
183
+ septemberCpiPct: 1.7,
184
+ ratePct: 3.2,
185
+ appliedOn: '2025-04-06',
186
+ si: 'SI 2025/252',
187
+ },
188
+ {
189
+ yearEnd: 2026,
190
+ septemberCpiPct: 3.8,
191
+ ratePct: 5.3,
192
+ appliedOn: '2026-04-06',
193
+ si: 'SI 2026/254',
194
+ },
195
+ ];
196
+ /** The published rate for a scheme year, or null where the
197
+ * year isn't published — never a silent fallback. */
198
+ export function revaluationFor(yearEnd) {
199
+ return IN_SERVICE_REVALUATION.find((year) => year.yearEnd === yearEnd) ?? null;
200
+ }
201
+ /**
202
+ * The date the pot moves for a given scheme year: 6 April from
203
+ * 2023, 1 April before it — read off the table, never assumed.
204
+ *
205
+ * Lives here rather than with the uplift rule because two
206
+ * callers need it and they must agree: the pension steps on
207
+ * these days, and so must the ruler that reads it. When they
208
+ * disagreed by the five days between 1 and 6 April, a ruler
209
+ * anchored in the pre-2023 era counted its own anchor step and
210
+ * deflated a year that had not passed.
211
+ */
212
+ export function appliedOnFor(yearEnd) {
213
+ const published = revaluationFor(yearEnd);
214
+ if (published === null)
215
+ return new Date(yearEnd, 3, 6);
216
+ const [y, m, d] = published.appliedOn.split('-').map(Number);
217
+ // Built LOCAL, matching every other date in this library:
218
+ // parsing the ISO string gives UTC midnight, and under BST
219
+ // the two conventions sit an hour apart.
220
+ return new Date(y, m - 1, d);
221
+ }
222
+ /**
223
+ * How much prices rose between two dates, using the Treasury
224
+ * Order figures rather than a forecast.
225
+ *
226
+ * **This exists because a past period is a matter of record.**
227
+ * Restating a member's own statement figure in today's money
228
+ * means dividing out the inflation since the statement was
229
+ * made, and that inflation has already happened and already
230
+ * been legislated. Using an assumed CPI there quietly reports
231
+ * a forecast as history.
232
+ *
233
+ * Found by reconciling the statement this file already cites
234
+ * (updated to 31/03/2025, linked above). Between its date and
235
+ * a reading in August 2026 the orders compound to 1.017 x
236
+ * 1.038, where an assumed 2% over the same window gives about
237
+ * 1.028 — so the figure was restated some 2.7% light, and
238
+ * every projection derived from it inherited the gap.
239
+ *
240
+ * **The uplift date is what counts, not the scheme year.** Each
241
+ * order names the day it applies (1 April through 2022, 6 April
242
+ * from 2023), and a member's statement is dated wherever it
243
+ * falls between two of them — so the window is tested against
244
+ * `appliedOn` and nothing is apportioned within a year.
245
+ *
246
+ * Returns how far the published record actually reaches, so a
247
+ * caller can price the remainder itself rather than being
248
+ * handed a number that silently stops early.
249
+ */
250
+ export function publishedInflationBetween(from, to) {
251
+ let factor = 1;
252
+ let publishedTo = from;
253
+ for (const year of IN_SERVICE_REVALUATION) {
254
+ // Built as a LOCAL date, matching how every other date in
255
+ // this library is constructed. Parsing the ISO string
256
+ // instead makes it UTC midnight, and under BST the two
257
+ // conventions sit an hour apart — which is nothing in
258
+ // money but is enough to stop an exact test being exact,
259
+ // and exactness is the only way to tell this arithmetic
260
+ // is right.
261
+ const [y, m, d] = year.appliedOn.split('-').map(Number);
262
+ const applied = new Date(y, m - 1, d);
263
+ if (applied > from && applied <= to) {
264
+ factor *= 1 + year.septemberCpiPct / 100;
265
+ publishedTo = applied;
266
+ }
267
+ }
268
+ return { factor, publishedTo };
269
+ }
270
+ //# sourceMappingURL=revaluation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"revaluation.js","sourceRoot":"","sources":["../src/revaluation.ts"],"names":[],"mappings":"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"}