@casomoltd/nhs-pay 0.31.0 → 0.33.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 (142) hide show
  1. package/README.md +25 -22
  2. package/dist/afc-scales.d.ts +43 -10
  3. package/dist/afc-scales.js +50 -16
  4. package/dist/afc-scales.js.map +1 -1
  5. package/dist/allowances.js +11 -11
  6. package/dist/allowances.js.map +1 -1
  7. package/dist/award.d.ts +3 -3
  8. package/dist/award.js +21 -21
  9. package/dist/award.js.map +1 -1
  10. package/dist/circulars/england-md-1-2026-r2.d.ts +13 -0
  11. package/dist/circulars/england-md-1-2026-r2.js +13 -0
  12. package/dist/circulars/england-md-1-2026-r2.js.map +1 -1
  13. package/dist/circulars/ni-hsc-tc8-05-2025.d.ts +22 -0
  14. package/dist/circulars/ni-hsc-tc8-05-2025.js +22 -0
  15. package/dist/circulars/ni-hsc-tc8-05-2025.js.map +1 -1
  16. package/dist/circulars/scotland-pcs-dd-2025-01.d.ts +20 -0
  17. package/dist/circulars/scotland-pcs-dd-2025-01.js +20 -0
  18. package/dist/circulars/scotland-pcs-dd-2025-01.js.map +1 -1
  19. package/dist/circulars/scotland-pcs-dd-2026-01.d.ts +19 -0
  20. package/dist/circulars/scotland-pcs-dd-2026-01.js +30 -10
  21. package/dist/circulars/scotland-pcs-dd-2026-01.js.map +1 -1
  22. package/dist/circulars/scotland-pcs-dd-2026-02.d.ts +10 -0
  23. package/dist/circulars/scotland-pcs-dd-2026-02.js +10 -0
  24. package/dist/circulars/scotland-pcs-dd-2026-02.js.map +1 -1
  25. package/dist/circulars/wales-mdw-01-2025.d.ts +17 -0
  26. package/dist/circulars/wales-mdw-01-2025.js +17 -0
  27. package/dist/circulars/wales-mdw-01-2025.js.map +1 -1
  28. package/dist/circulars/wales-mdw-01-2026.d.ts +20 -0
  29. package/dist/circulars/wales-mdw-01-2026.js +20 -0
  30. package/dist/circulars/wales-mdw-01-2026.js.map +1 -1
  31. package/dist/commutation.js +3 -2
  32. package/dist/commutation.js.map +1 -1
  33. package/dist/dental-grades.d.ts +25 -0
  34. package/dist/dental-grades.js +25 -0
  35. package/dist/dental-grades.js.map +1 -0
  36. package/dist/dental-scales.d.ts +5 -21
  37. package/dist/dental-scales.js +73 -72
  38. package/dist/dental-scales.js.map +1 -1
  39. package/dist/document-source.d.ts +32 -23
  40. package/dist/document-source.js +32 -10
  41. package/dist/document-source.js.map +1 -1
  42. package/dist/errors.d.ts +12 -1
  43. package/dist/errors.js +18 -1
  44. package/dist/errors.js.map +1 -1
  45. package/dist/factor-basis.d.ts +9 -3
  46. package/dist/factor-basis.js +40 -28
  47. package/dist/factor-basis.js.map +1 -1
  48. package/dist/format.js +3 -2
  49. package/dist/format.js.map +1 -1
  50. package/dist/hcas-pcts.d.ts +1 -1
  51. package/dist/hcas-zone.d.ts +23 -0
  52. package/dist/hcas-zone.js +17 -0
  53. package/dist/hcas-zone.js.map +1 -0
  54. package/dist/hcas.d.ts +26 -18
  55. package/dist/hcas.js +45 -24
  56. package/dist/hcas.js.map +1 -1
  57. package/dist/index.d.ts +27 -18
  58. package/dist/index.js +17 -13
  59. package/dist/index.js.map +1 -1
  60. package/dist/medical-grades.d.ts +33 -0
  61. package/dist/medical-grades.js +33 -0
  62. package/dist/medical-grades.js.map +1 -0
  63. package/dist/medical-scales.d.ts +10 -33
  64. package/dist/medical-scales.js +104 -158
  65. package/dist/medical-scales.js.map +1 -1
  66. package/dist/member/benefits.js +9 -4
  67. package/dist/member/benefits.js.map +1 -1
  68. package/dist/member/input-period.d.ts +18 -5
  69. package/dist/member/input-period.js +24 -13
  70. package/dist/member/input-period.js.map +1 -1
  71. package/dist/member/valuation.js +3 -6
  72. package/dist/member/valuation.js.map +1 -1
  73. package/dist/pay-round.js +3 -3
  74. package/dist/pay-round.js.map +1 -1
  75. package/dist/pay-year.d.ts +17 -0
  76. package/dist/pay-year.js +20 -0
  77. package/dist/pay-year.js.map +1 -0
  78. package/dist/pension/ledger.d.ts +7 -0
  79. package/dist/pension/ledger.js +26 -18
  80. package/dist/pension/ledger.js.map +1 -1
  81. package/dist/pension/money.d.ts +2 -0
  82. package/dist/pension/money.js +4 -0
  83. package/dist/pension/money.js.map +1 -1
  84. package/dist/pension/uplift.d.ts +25 -21
  85. package/dist/pension/uplift.js +27 -12
  86. package/dist/pension/uplift.js.map +1 -1
  87. package/dist/pension.js +2 -1
  88. package/dist/pension.js.map +1 -1
  89. package/dist/post.d.ts +20 -21
  90. package/dist/post.js +54 -53
  91. package/dist/post.js.map +1 -1
  92. package/dist/published/england-afc.d.ts +29 -0
  93. package/dist/published/england-afc.js +142 -0
  94. package/dist/published/england-afc.js.map +1 -0
  95. package/dist/published/hcas-zones.d.ts +18 -0
  96. package/dist/published/hcas-zones.js +46 -0
  97. package/dist/published/hcas-zones.js.map +1 -0
  98. package/dist/published/wales-living-wage.d.ts +36 -0
  99. package/dist/published/wales-living-wage.js +30 -0
  100. package/dist/published/wales-living-wage.js.map +1 -0
  101. package/dist/regions.d.ts +25 -14
  102. package/dist/regions.js +61 -71
  103. package/dist/regions.js.map +1 -1
  104. package/dist/resolver.d.ts +46 -41
  105. package/dist/resolver.js +70 -142
  106. package/dist/resolver.js.map +1 -1
  107. package/dist/revaluation.d.ts +27 -11
  108. package/dist/revaluation.js +46 -32
  109. package/dist/revaluation.js.map +1 -1
  110. package/dist/role.d.ts +3 -3
  111. package/dist/scale-point.d.ts +11 -7
  112. package/dist/scale-point.js +29 -1
  113. package/dist/scale-point.js.map +1 -1
  114. package/dist/scale-tables.d.ts +42 -60
  115. package/dist/scale-tables.js +65 -105
  116. package/dist/scale-tables.js.map +1 -1
  117. package/dist/scale-translators.d.ts +90 -0
  118. package/dist/scale-translators.js +97 -0
  119. package/dist/scale-translators.js.map +1 -0
  120. package/dist/scales.d.ts +138 -101
  121. package/dist/scales.js +221 -457
  122. package/dist/scales.js.map +1 -1
  123. package/dist/sections/final-salary.js +3 -11
  124. package/dist/sections/final-salary.js.map +1 -1
  125. package/dist/sections/section-2015.d.ts +1 -3
  126. package/dist/sections/section-2015.js +1 -1
  127. package/dist/sections/section-2015.js.map +1 -1
  128. package/dist/sources.d.ts +12 -12
  129. package/dist/sources.js +13 -15
  130. package/dist/sources.js.map +1 -1
  131. package/dist/take-home.js +1 -2
  132. package/dist/take-home.js.map +1 -1
  133. package/dist/values.d.ts +10 -3
  134. package/dist/values.js +11 -4
  135. package/dist/values.js.map +1 -1
  136. package/dist/working-week.d.ts +23 -8
  137. package/dist/working-week.js +55 -25
  138. package/dist/working-week.js.map +1 -1
  139. package/package.json +3 -3
  140. package/dist/bands.d.ts +0 -63
  141. package/dist/bands.js +0 -78
  142. package/dist/bands.js.map +0 -1
@@ -11,121 +11,122 @@
11
11
  *
12
12
  * One canonical point per source row; no pay step collapsed.
13
13
  */
14
- import { NATION_KEYS, TAX_YEARS } from '@casomoltd/paye-calc';
14
+ import { NATION_KEYS, YEAR_LABELS } from '@casomoltd/paye-calc';
15
15
  import { HSC_TC8_05_2025, MD_W_01_2025, MD_W_01_2026, PC_MD_1_2026_R2, PCS_DD_2025_01, PCS_DD_2025_01_ADDENDUM, PCS_DD_2026_01, PCS_DD_2026_02, } from './sources.js';
16
- import { byCode, combineScales, fromDocument, byStage, bySpine, numbered, resolveGradeMetas, scaleSalaries, stepped, } from './scale-tables.js';
17
- import { ENGLAND_MD_1_2026_R2 as ENG } from './circulars/england-md-1-2026-r2.js';
16
+ import { combineScales, fromDocument, gradeFamily, } from './scale-tables.js';
17
+ import { byCode, byStage, bySpine, numbered, salariesOfCode, scaleSalaries, stepped, } from './scale-translators.js';
18
+ import { invariant } from './errors.js';
19
+ import { DENTAL_GRADE_IDS } from './dental-grades.js';
20
+ import { ENGLAND_MD_1_2026_R2 as ENG, ENGLAND_MD_1_2026_R2_CODES as ENG_CODES, } from './circulars/england-md-1-2026-r2.js';
18
21
  import { SCOTLAND_PCS_DD_2026_01 as SCO } from './circulars/scotland-pcs-dd-2026-01.js';
19
22
  import { SCOTLAND_PCS_DD_2025_01 as SCO25 } from './circulars/scotland-pcs-dd-2025-01.js';
20
23
  import { SCOTLAND_PCS_DD_2026_02 as SCO2 } from './circulars/scotland-pcs-dd-2026-02.js';
21
- import { WALES_MDW_01_2025 as WAL } from './circulars/wales-mdw-01-2025.js';
22
- import { WALES_MDW_01_2026 as WAL26 } from './circulars/wales-mdw-01-2026.js';
23
- import { NI_HSC_TC8_05_2025 as NI } from './circulars/ni-hsc-tc8-05-2025.js';
24
- /** Salaried-dental grade identifiers wired into the domain. */
25
- export const DENTAL_GRADES = {
26
- salariedDental: 'salaried-dental',
27
- dentalCoreTraining: 'dental-core-training',
28
- dentalSpecialtyTraining: 'dental-specialty-training',
29
- dentalEducator: 'dental-educator',
30
- salariedDentist: 'salaried-dentist',
31
- seniorSalariedDentist: 'senior-salaried-dentist',
32
- assistantClinicalDirectorDentist: 'assistant-clinical-director-dentist',
33
- clinicalDirectorDentist: 'clinical-director-dentist',
34
- communityDentalOfficer: 'community-dental-officer',
35
- seniorCommunityDentalOfficer: 'senior-community-dental-officer',
36
- assistantCommunityDentalClinicalDirector: 'assistant-community-dental-clinical-director',
37
- specialistCommunityDentist: 'specialist-community-dentist',
38
- communityDentalClinicalDirector: 'community-dental-clinical-director',
39
- };
40
- /** Ordered grade IDs — stable iteration/enumeration. */
41
- export const DENTAL_GRADE_IDS = Object.values(DENTAL_GRADES);
42
- // England §1 dentists in training: CT1-3 = core, ST1-8 = specialty.
24
+ import { WALES_MDW_01_2025 as WAL, WALES_MDW_01_2025_CODES as WAL_CODES, } from './circulars/wales-mdw-01-2025.js';
25
+ import { WALES_MDW_01_2026 as WAL26, WALES_MDW_01_2026_CODES as WAL26_CODES, } from './circulars/wales-mdw-01-2026.js';
26
+ import { NI_HSC_TC8_05_2025 as NI, NI_HSC_TC8_05_2025_CODES as NI_CODES, } from './circulars/ni-hsc-tc8-05-2025.js';
27
+ // England §1 dentists in training: CT1-3 = core, ST1-8 = specialty, told
28
+ // apart by the stage each row prints.
43
29
  const engDentists = ENG.dentistsInTraining;
44
- // The England spine prints the band in its pay-scale code (LD01/11/21),
45
- // not a band column; map the code to the band so a relabelled boundary
46
- // stays correct (matches Wales's explicit "Band X Point N" labels).
30
+ /** The printed stage prefixes of the two kinds of dental training row. */
31
+ const TRAINING_STAGE = { core: 'CT', specialty: 'ST' };
32
+ const trainingRows = (prefix) => engDentists.filter((r) => r.stage.startsWith(prefix));
33
+ /** The bands Northern Ireland's salaried dental table numbers. */
34
+ const NI_DENTAL_BANDS = {
35
+ salaried: 1, senior: 2, assistantDirector: 3, clinicalDirector: 4,
36
+ };
37
+ /** The bands England's salaried dental spine is printed in. */
38
+ const SPINE_BANDS = { a: 'A', b: 'B', c: 'C' };
47
39
  const LD_BAND = {
48
- LD01: 'A', LD11: 'B', LD21: 'C',
40
+ [ENG_CODES.salariedDentalBandA]: SPINE_BANDS.a,
41
+ [ENG_CODES.salariedDentalBandB]: SPINE_BANDS.b,
42
+ [ENG_CODES.salariedDentalBandC]: SPINE_BANDS.c,
49
43
  };
44
+ const isSpineCode = (code) => Object.hasOwn(LD_BAND, code);
50
45
  const ldBand = (code) => {
51
- const band = LD_BAND[code];
52
- if (!band) {
46
+ if (!isSpineCode(code)) {
53
47
  throw new Error(`dental-scales: unknown spine code "${code}"`);
54
48
  }
55
- return band;
49
+ return LD_BAND[code];
56
50
  };
57
- const england = fromDocument(PC_MD_1_2026_R2, {
58
- 'salaried-dental': ENG.salariedDentalSpine.map((r) => ({
59
- label: `Band ${ldBand(r.code)} Point ${r.point}`,
60
- salary: r.salary,
61
- })),
62
- 'dental-core-training': byStage(engDentists.slice(0, 3)),
63
- 'dental-specialty-training': byStage(engDentists.slice(3)),
51
+ // Every training row is core or specialty training by its printed stage,
52
+ // so a row with another stage fails at load rather than going unread.
53
+ invariant(engDentists.every((r) => Object.values(TRAINING_STAGE)
54
+ .some((prefix) => r.stage.startsWith(prefix))), 'dental-scales: a dentists-in-training stage is neither core nor specialty');
55
+ // Both ways: every row's code is a band (`ldBand`), and every band's code
56
+ // is printed on some row, so a code the circular drops fails at load.
57
+ for (const code of Object.keys(LD_BAND)) {
58
+ invariant(ENG.salariedDentalSpine.some((r) => r.code === code), `dental-scales: England's dental spine prints no ${code} row`);
59
+ }
60
+ const england2026 = fromDocument(PC_MD_1_2026_R2, {
61
+ 'salaried-dental': bySpine(ENG.salariedDentalSpine.map((r) => ({
62
+ band: ldBand(r.code), point: r.point, salary: r.salary,
63
+ }))),
64
+ 'dental-core-training': byStage(trainingRows(TRAINING_STAGE.core)),
65
+ 'dental-specialty-training': byStage(trainingRows(TRAINING_STAGE.specialty)),
64
66
  'dental-educator': byCode(ENG.dentalEducators),
65
67
  });
66
68
  // The Public Dental Service spine comes from PCS(DD)2026/02 Annex G,
67
69
  // uplifted 3.75% (its para 3) rather than the 3.5% the rest of that
68
70
  // circular carries; dental core training from PCS(DD)2026/01.
69
- const scotland = combineScales(fromDocument(PCS_DD_2026_02, {
71
+ const scotland2026 = combineScales(fromDocument(PCS_DD_2026_02, {
70
72
  'salaried-dental': bySpine(SCO2.salariedDentalSpine),
71
73
  }), fromDocument(PCS_DD_2026_01, {
72
- 'dental-core-training': [
73
- {
74
- label: SCO.dentalCoreTraining.stage,
75
- salary: SCO.dentalCoreTraining.salary,
76
- },
77
- ],
74
+ 'dental-core-training': byStage([SCO.dentalCoreTraining]),
78
75
  }));
79
- const wales = fromDocument(MD_W_01_2025, {
76
+ const wales2025 = fromDocument(MD_W_01_2025, {
80
77
  'salaried-dental': bySpine(WAL.salariedDentalSpine),
81
- 'dental-core-training': stepped(scaleSalaries(WAL.trainingGrades, (g) => g.code === 'MN21', 'Wal MN21')),
78
+ 'dental-core-training': stepped(salariesOfCode(WAL.trainingGrades, WAL_CODES.dentalCoreTraining)),
82
79
  });
83
- const northernIreland = fromDocument(HSC_TC8_05_2025, {
84
- 'salaried-dentist': numbered(scaleSalaries(NI.salariedDental, (g) => g.band === 1, 'NI dental band 1')),
85
- 'senior-salaried-dentist': numbered(scaleSalaries(NI.salariedDental, (g) => g.band === 2, 'NI dental band 2')),
86
- 'assistant-clinical-director-dentist': numbered(scaleSalaries(NI.salariedDental, (g) => g.band === 3, 'NI dental band 3')),
87
- 'clinical-director-dentist': numbered(scaleSalaries(NI.salariedDental, (g) => g.band === 4, 'NI dental band 4')),
88
- 'dental-core-training': stepped(scaleSalaries(NI.residentGrades, (g) => g.code === 'M242', 'NI M242')),
89
- 'community-dental-officer': numbered(scaleSalaries(NI.communityDentalService, (g) => g.code === 'M431', 'NI M431')),
90
- 'senior-community-dental-officer': numbered(scaleSalaries(NI.communityDentalService, (g) => g.code === 'M432', 'NI M432')),
91
- 'assistant-community-dental-clinical-director': numbered(scaleSalaries(NI.communityDentalService, (g) => g.code === 'M433', 'NI M433')),
92
- 'specialist-community-dentist': numbered(scaleSalaries(NI.communityDentalService, (g) => g.code === 'M434', 'NI M434')),
93
- 'community-dental-clinical-director': numbered(scaleSalaries(NI.communityDentalService, (g) => g.code === 'M435', 'NI M435')),
80
+ const northernIreland2025 = fromDocument(HSC_TC8_05_2025, {
81
+ 'salaried-dentist': niDentalBand(NI_DENTAL_BANDS.salaried),
82
+ 'senior-salaried-dentist': niDentalBand(NI_DENTAL_BANDS.senior),
83
+ 'assistant-clinical-director-dentist': niDentalBand(NI_DENTAL_BANDS.assistantDirector),
84
+ 'clinical-director-dentist': niDentalBand(NI_DENTAL_BANDS.clinicalDirector),
85
+ 'dental-core-training': stepped(salariesOfCode(NI.residentGrades, NI_CODES.coreTraining)),
86
+ 'community-dental-officer': numbered(salariesOfCode(NI.communityDentalService, NI_CODES.communityDentalOfficer)),
87
+ 'senior-community-dental-officer': numbered(salariesOfCode(NI.communityDentalService, NI_CODES.seniorCommunityDentalOfficer)),
88
+ 'assistant-community-dental-clinical-director': numbered(salariesOfCode(NI.communityDentalService, NI_CODES.assistantCommunityDentalClinicalDirector)),
89
+ 'specialist-community-dentist': numbered(salariesOfCode(NI.communityDentalService, NI_CODES.specialistCommunityDentist)),
90
+ 'community-dental-clinical-director': numbered(salariesOfCode(NI.communityDentalService, NI_CODES.communityDentalClinicalDirector)),
94
91
  });
95
92
  // Wales 2026/27 — salaried dental spine + dental core training, uplifted.
96
93
  const wales2026 = fromDocument(MD_W_01_2026, {
97
94
  'salaried-dental': bySpine(WAL26.salariedDentalSpine),
98
- 'dental-core-training': stepped(scaleSalaries(WAL26.trainingGrades, (g) => g.code === 'MN21', 'Wal26 MN21')),
95
+ 'dental-core-training': stepped(salariesOfCode(WAL26.trainingGrades, WAL26_CODES.dentalCoreTraining)),
99
96
  });
100
97
  // Scotland 2025/26 — the Public Dental Service spine (Annex G) and dental
101
98
  // core training (addendum).
102
99
  const scotland2025 = combineScales(fromDocument(PCS_DD_2025_01, {
103
100
  'salaried-dental': bySpine(SCO25.salariedDentalSpine),
104
101
  }), fromDocument(PCS_DD_2025_01_ADDENDUM, {
105
- 'dental-core-training': [
106
- { label: SCO25.dentalCoreTraining.stage, salary: SCO25.dentalCoreTraining.salary },
107
- ],
102
+ 'dental-core-training': byStage([SCO25.dentalCoreTraining]),
108
103
  }));
109
104
  const DENTAL_SCALES = {
110
- [TAX_YEARS.Y2026_27]: {
111
- [NATION_KEYS.england]: england,
112
- [NATION_KEYS.scotland]: scotland,
105
+ [YEAR_LABELS.Y2026_27]: {
106
+ [NATION_KEYS.england]: england2026,
107
+ [NATION_KEYS.scotland]: scotland2026,
113
108
  [NATION_KEYS.wales]: wales2026,
114
109
  },
115
- [TAX_YEARS.Y2025_26]: {
116
- [NATION_KEYS.wales]: wales,
117
- [NATION_KEYS.northernIreland]: northernIreland,
110
+ [YEAR_LABELS.Y2025_26]: {
111
+ [NATION_KEYS.wales]: wales2025,
112
+ [NATION_KEYS.northernIreland]: northernIreland2025,
118
113
  [NATION_KEYS.scotland]: scotland2025,
119
114
  },
120
115
  };
116
+ /** Every read over the dental tables. */
117
+ export const DENTAL_FAMILY = gradeFamily(DENTAL_SCALES, DENTAL_GRADE_IDS);
121
118
  /** Pay years this family publishes, newest first (derived from data). */
122
- export const DENTAL_PAY_YEARS = Object.keys(DENTAL_SCALES).sort().reverse();
119
+ export const DENTAL_PAY_YEARS = DENTAL_FAMILY.years;
123
120
  /**
124
- * Published salaried dental grades for a nation and tax year, each with
121
+ * Published salaried dental grades for a nation and pay year, each with
125
122
  * its scale points and salary range. Both args required; an absent
126
123
  * combination throws `ScaleUnavailable`.
127
124
  */
128
125
  export function getDentalScales(year, nation) {
129
- return resolveGradeMetas(DENTAL_SCALES, DENTAL_GRADE_IDS, year, nation);
126
+ return DENTAL_FAMILY.scalesFor(year, nation);
127
+ }
128
+ /** One band of Northern Ireland's salaried dental table, by number. */
129
+ function niDentalBand(band) {
130
+ return numbered(scaleSalaries(NI.salariedDental, (g) => g.band === band, `NI dental band ${band}`));
130
131
  }
131
132
  //# sourceMappingURL=dental-scales.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"dental-scales.js","sourceRoot":"","sources":["../src/dental-scales.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"dental-scales.js","sourceRoot":"","sources":["../src/dental-scales.ts"],"names":[],"mappings":"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"}
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * The published document a figure in this library was read from.
3
3
  *
4
- * One record type for any cited document, because the library cites
5
- * three different KINDS and a reader must not confuse them: the
4
+ * One record type for any dated cited document. The library cites five
5
+ * KINDS (listed in `sources.ts`), three of which are easily confused: the
6
6
  * instrument that ENACTED an award, the circular that PUBLISHES a pay
7
7
  * scale, and the letter that sets an allowance. They are different
8
8
  * documents in every nation — England's 2026-27 medical award was
@@ -73,11 +73,27 @@ export interface DocumentSourceFields {
73
73
  * CPI for the calendar year, so a revision was a scheduled
74
74
  * contingency with a knowable date — CPI confirms in January — and
75
75
  * it duly arrived on 23 January 2026, moving 4.25% to 4.4%. A
76
- * foreseeable revision that nothing was watching for is how 50 pay
77
- * points stayed understated for a year.
76
+ * scheduled revision with no date recorded lapses unseen, and every
77
+ * figure it moves stays wrong until someone happens to look.
78
78
  */
79
79
  readonly nextExpectedReason?: string;
80
80
  }
81
+ /**
82
+ * A publisher's web page that prints no issue date: what it is, and the
83
+ * day it was read. Its own type rather than a {@link DocumentSource},
84
+ * whose `issued` a consumer prints as the date of publication, so an
85
+ * undated page cannot be shown as published on the day it was read.
86
+ */
87
+ export interface PageSource {
88
+ /** Who publishes it — 'NHSBSA'. */
89
+ readonly issuer: string;
90
+ /** The page's own title, as printed. */
91
+ readonly reference: string;
92
+ /** The page itself, for a consumer to link. */
93
+ readonly url: string;
94
+ /** ISO date the page was read; it prints no date of its own. */
95
+ readonly retrieved: IsoDate;
96
+ }
81
97
  /**
82
98
  * A document this library cites — not commentary about it. Held on the
83
99
  * record so a consumer cites the document rather than keeping its own
@@ -117,9 +133,12 @@ export declare class DocumentSource {
117
133
  * Takes `now` rather than reading the clock, and is a method rather
118
134
  * than a stored flag, because currency is a question about a moment
119
135
  * and not a property of the record. A boolean computed at module
120
- * load would freeze the answer for the life of the process — the
121
- * same shape as the year defect this round exists to fix — and a
136
+ * load would freeze the answer for the life of the process, and a
122
137
  * caller could not ask "was this current when the page was built?".
138
+ *
139
+ * `now` is compared as the calendar day it falls on in the reader's
140
+ * own frame, never its UTC day, which is the day before for a local
141
+ * midnight in summer time.
123
142
  */
124
143
  currencyAt(now: Date): SourceCurrency;
125
144
  }
@@ -138,20 +157,10 @@ export declare class DocumentSource {
138
157
  * position is to state the gap: an unchecked citation should not look
139
158
  * identical to a fresh one.
140
159
  */
141
- export type SourceCurrency = 'current' | 'lapsed' | 'unknown';
142
- /**
143
- * A publisher's web page that prints no issue date: what it is, and the
144
- * day it was read. Its own type rather than a {@link DocumentSource},
145
- * whose `issued` a consumer prints as the date of publication, so an
146
- * undated page cannot be shown as published on the day it was read.
147
- */
148
- export interface PageSource {
149
- /** Who publishes it — 'NHSBSA'. */
150
- readonly issuer: string;
151
- /** The page's own title, as printed. */
152
- readonly reference: string;
153
- /** The page itself, for a consumer to link. */
154
- readonly url: string;
155
- /** ISO date the page was read; it prints no date of its own. */
156
- readonly retrieved: IsoDate;
157
- }
160
+ export declare const SOURCE_CURRENCIES: {
161
+ readonly current: "current";
162
+ readonly lapsed: "lapsed";
163
+ readonly unknown: "unknown";
164
+ };
165
+ /** One of {@link SOURCE_CURRENCIES}. */
166
+ export type SourceCurrency = (typeof SOURCE_CURRENCIES)[keyof typeof SOURCE_CURRENCIES];
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * The published document a figure in this library was read from.
3
3
  *
4
- * One record type for any cited document, because the library cites
5
- * three different KINDS and a reader must not confuse them: the
4
+ * One record type for any dated cited document. The library cites five
5
+ * KINDS (listed in `sources.ts`), three of which are easily confused: the
6
6
  * instrument that ENACTED an award, the circular that PUBLISHES a pay
7
7
  * scale, and the letter that sets an allowance. They are different
8
8
  * documents in every nation — England's 2026-27 medical award was
@@ -18,8 +18,7 @@
18
18
  * scale carries one too, and `award.ts` imports every scale module —
19
19
  * so defining it there would make a scale citing its source a cycle.
20
20
  */
21
- /** The characters of an ISO timestamp that are its date, `YYYY-MM-DD`. */
22
- const ISO_DATE_LENGTH = 10;
21
+ import { isoDateOf } from './iso-date.js';
23
22
  /**
24
23
  * A document this library cites — not commentary about it. Held on the
25
24
  * record so a consumer cites the document rather than keeping its own
@@ -66,17 +65,40 @@ export class DocumentSource {
66
65
  * Takes `now` rather than reading the clock, and is a method rather
67
66
  * than a stored flag, because currency is a question about a moment
68
67
  * and not a property of the record. A boolean computed at module
69
- * load would freeze the answer for the life of the process — the
70
- * same shape as the year defect this round exists to fix — and a
68
+ * load would freeze the answer for the life of the process, and a
71
69
  * caller could not ask "was this current when the page was built?".
70
+ *
71
+ * `now` is compared as the calendar day it falls on in the reader's
72
+ * own frame, never its UTC day, which is the day before for a local
73
+ * midnight in summer time.
72
74
  */
73
75
  currencyAt(now) {
74
76
  if (!this.nextExpected) {
75
- return 'unknown';
77
+ return SOURCE_CURRENCIES.unknown;
76
78
  }
77
- return this.nextExpected >= now.toISOString().slice(0, ISO_DATE_LENGTH)
78
- ? 'current'
79
- : 'lapsed';
79
+ return this.nextExpected >= isoDateOf(now)
80
+ ? SOURCE_CURRENCIES.current
81
+ : SOURCE_CURRENCIES.lapsed;
80
82
  }
81
83
  }
84
+ /**
85
+ * Whether a source is still within the window in which it is the
86
+ * newest document expected to exist.
87
+ *
88
+ * `lapsed` means the date we expected a successor by has passed and
89
+ * we hold no successor — so either the publisher is late, or one
90
+ * exists and we have not transcribed it. Both are worth surfacing;
91
+ * the caller decides which it is.
92
+ *
93
+ * `unknown` where no `nextExpected` is recorded. Absence of a date is
94
+ * not evidence of currency, and a consumer must never render it as
95
+ * "current" — nor render nothing, which reads the same way. House
96
+ * position is to state the gap: an unchecked citation should not look
97
+ * identical to a fresh one.
98
+ */
99
+ export const SOURCE_CURRENCIES = {
100
+ current: 'current',
101
+ lapsed: 'lapsed',
102
+ unknown: 'unknown',
103
+ };
82
104
  //# sourceMappingURL=document-source.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"document-source.js","sourceRoot":"","sources":["../src/document-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,0EAA0E;AAC1E,MAAM,eAAe,GAAG,EAAE,CAAC;AA8D3B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,cAAc;IACzB,8DAA8D;IACrD,MAAM,CAAS;IACxB,mEAAmE;IAC1D,SAAS,CAAS;IAC3B,+CAA+C;IACtC,GAAG,CAAS;IACrB,wCAAwC;IAC/B,MAAM,CAAU;IACzB,sDAAsD;IAC7C,YAAY,CAAW;IAChC;iCAC6B;IACpB,kBAAkB,CAAU;IAErC,YAAY,MAA4B;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC;IACtD,CAAC;IAED;;;;;;;;;;OAUG;IACH,UAAU,CAAC,GAAS;QAClB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC;YACrE,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,QAAQ,CAAC;IACf,CAAC;CACF"}
1
+ {"version":3,"file":"document-source.js","sourceRoot":"","sources":["../src/document-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAC,SAAS,EAAC,MAAM,eAAe,CAAC;AAgFxC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,cAAc;IACzB,8DAA8D;IACrD,MAAM,CAAS;IACxB,mEAAmE;IAC1D,SAAS,CAAS;IAC3B,+CAA+C;IACtC,GAAG,CAAS;IACrB,wCAAwC;IAC/B,MAAM,CAAU;IACzB,sDAAsD;IAC7C,YAAY,CAAW;IAChC;iCAC6B;IACpB,kBAAkB,CAAU;IAErC,YAAY,MAA4B;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,GAAS;QAClB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,iBAAiB,CAAC,OAAO,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,IAAI,SAAS,CAAC,GAAG,CAAC;YACxC,CAAC,CAAC,iBAAiB,CAAC,OAAO;YAC3B,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC;IAC/B,CAAC;CACF;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CACV,CAAC"}
package/dist/errors.d.ts CHANGED
@@ -7,7 +7,8 @@
7
7
  * ({@link PayPathUnavailable}), service it does not model
8
8
  * ({@link BenefitNotModelled}, keyed by a {@link NOT_MODELLED}
9
9
  * code), and a read before a member's statement, where no balance
10
- * exists ({@link BeforeStatement}).
10
+ * exists ({@link BeforeStatement}, its boundary
11
+ * {@link isBeforeStatement}, which a caller can check first).
11
12
  * - RangeError, thrown where a caller's input cannot be true.
12
13
  * - {@link invariant} — an internal consistency guard. Its failure
13
14
  * is a library bug, not an input problem, so no caller catches it;
@@ -210,6 +211,16 @@ export declare class AdditionalPensionUnavailable extends Error {
210
211
  readonly code: AdditionalPensionRefusal;
211
212
  constructor(code: AdditionalPensionRefusal, detail: string);
212
213
  }
214
+ /**
215
+ * Whether a read on `on` falls before the first date a statement answers,
216
+ * and so is one {@link BeforeStatement} refuses. `answersFrom` is that date,
217
+ * the statement's 31 March (`MemberBenefits.statementAnswersFrom`), or null
218
+ * where there is no statement and every date is answered. The one
219
+ * definition of the boundary, so a caller checking its own dates first and
220
+ * the library refusing them cannot disagree on the day itself, which is
221
+ * answered.
222
+ */
223
+ export declare function isBeforeStatement(on: Date, answersFrom: Date | null): boolean;
213
224
  /**
214
225
  * Assert a domain invariant that must ALWAYS hold. Throws a bare
215
226
  * Error when `condition` is false. Unlike the absent-data errors
package/dist/errors.js CHANGED
@@ -7,7 +7,8 @@
7
7
  * ({@link PayPathUnavailable}), service it does not model
8
8
  * ({@link BenefitNotModelled}, keyed by a {@link NOT_MODELLED}
9
9
  * code), and a read before a member's statement, where no balance
10
- * exists ({@link BeforeStatement}).
10
+ * exists ({@link BeforeStatement}, its boundary
11
+ * {@link isBeforeStatement}, which a caller can check first).
11
12
  * - RangeError, thrown where a caller's input cannot be true.
12
13
  * - {@link invariant} — an internal consistency guard. Its failure
13
14
  * is a library bug, not an input problem, so no caller catches it;
@@ -221,6 +222,10 @@ export class BeforeStatement extends Error {
221
222
  this.read = read;
222
223
  this.on = on;
223
224
  this.statementDate = statementDate;
225
+ // A read on or after the statement has a balance to answer with, so
226
+ // refusing one would be the library's own bug, not the caller's.
227
+ invariant(isBeforeStatement(on, statementDate), `BeforeStatement for ${on.toDateString()}, not before the `
228
+ + `statement's ${statementDate.toDateString()}`);
224
229
  this.name = 'BeforeStatement';
225
230
  }
226
231
  }
@@ -253,6 +258,18 @@ export class AdditionalPensionUnavailable extends Error {
253
258
  this.name = 'AdditionalPensionUnavailable';
254
259
  }
255
260
  }
261
+ /**
262
+ * Whether a read on `on` falls before the first date a statement answers,
263
+ * and so is one {@link BeforeStatement} refuses. `answersFrom` is that date,
264
+ * the statement's 31 March (`MemberBenefits.statementAnswersFrom`), or null
265
+ * where there is no statement and every date is answered. The one
266
+ * definition of the boundary, so a caller checking its own dates first and
267
+ * the library refusing them cannot disagree on the day itself, which is
268
+ * answered.
269
+ */
270
+ export function isBeforeStatement(on, answersFrom) {
271
+ return answersFrom !== null && on < answersFrom;
272
+ }
256
273
  /**
257
274
  * Assert a domain invariant that must ALWAYS hold. Throws a bare
258
275
  * Error when `condition` is false. Unlike the absent-data errors
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
@@ -55,9 +55,6 @@ declare const TABLES: {
55
55
  readonly firstAge: 65;
56
56
  }>;
57
57
  };
58
- /** Every table the library reads, by its GAD reference. The one set of
59
- * instances, so two callers cannot read the same table two ways. */
60
- export declare function factorTable<K extends keyof typeof TABLES>(ref: K): (typeof TABLES)[K];
61
58
  /** Which benefit a factor applies to, where two benefits measured from
62
59
  * one pension age read different tables: a 1995 Section pension and its
63
60
  * automatic lump sum, and 2015 Section additional pension. */
@@ -136,10 +133,19 @@ export interface Factored<F extends FactorOutcome | null = FactorOutcome> {
136
133
  readonly after: ProjectionMoney;
137
134
  readonly factor: F;
138
135
  }
136
+ /** Every table the library reads, by its GAD reference. The one set of
137
+ * instances, so two callers cannot read the same table two ways. */
138
+ export declare function factorTable<K extends keyof typeof TABLES>(ref: K): (typeof TABLES)[K];
139
139
  /**
140
140
  * Read the factor for a drawing. The date decides the direction as well
141
141
  * as the cell, so a basis whose direction the dates contradict is a bug
142
142
  * in the section that derived it and fails loud.
143
143
  */
144
144
  export declare function readFactor(basis: FactorBasis, dateOfBirth: Date, drawn: Date): FactorOutcome;
145
+ /**
146
+ * A figure with its factor applied: the one place `after` is made, so it
147
+ * is always `beforeFactor` times the factor, in both rulers. No factor
148
+ * means the rules pay nothing, so nothing is paid after it.
149
+ */
150
+ export declare function factored<F extends FactorOutcome | null>(beforeFactor: ProjectionMoney, factor: F): Factored<F>;
145
151
  export {};
@@ -20,6 +20,7 @@ import { periodInYearsMonths, npaDate } from './dates.js';
20
20
  import { invariant } from './errors.js';
21
21
  import { LEGACY_PENSION_AGES } from './pension/ages.js';
22
22
  import { FactorTable } from './gad/factor-table.js';
23
+ import { timesMoney } from './pension/money.js';
23
24
  import { ERF_0_420 } from './gad/erf-2023-06-30.js';
24
25
  import { LRF_0_421 } from './gad/lrf-2023-06-30.js';
25
26
  import { LRF_0_422 } from './gad/lrf-0-422-2023-06-30.js';
@@ -62,11 +63,6 @@ const TABLES = {
62
63
  [FACTOR_TABLES.earlyAge65]: new FactorTable(ERF_1_402),
63
64
  [FACTOR_TABLES.late2008]: new FactorTable(LRF_2_416),
64
65
  };
65
- /** Every table the library reads, by its GAD reference. The one set of
66
- * instances, so two callers cannot read the same table two ways. */
67
- export function factorTable(ref) {
68
- return TABLES[ref];
69
- }
70
66
  /** Which benefit a factor applies to, where two benefits measured from
71
67
  * one pension age read different tables: a 1995 Section pension and its
72
68
  * automatic lump sum, and 2015 Section additional pension. */
@@ -95,30 +91,11 @@ export const FACTOR_SOURCES = {
95
91
  atPensionAge: 'at-normal-pension-age',
96
92
  noLateUplift: 'section-awards-no-late-uplift',
97
93
  };
98
- /** The table a basis reads, and how it is keyed. */
99
- function tableFor(basis) {
100
- const section2015 = basis.against === MEMBERS_NPA;
101
- const section1995 = basis.against === LEGACY_PENSION_AGES.section1995;
102
- const early = basis.direction === FACTOR_DIRECTIONS.early;
103
- if (section2015) {
104
- const additionalPension = basis.applies === FACTOR_APPLIES.additionalPension;
105
- if (early)
106
- return TABLES[FACTOR_TABLES.early2015];
107
- return additionalPension
108
- ? TABLES[FACTOR_TABLES.late2015AdditionalPension]
109
- : TABLES[FACTOR_TABLES.late2015];
110
- }
111
- if (section1995) {
112
- const pension = basis.applies === FACTOR_APPLIES.pension;
113
- return pension
114
- ? TABLES[FACTOR_TABLES.early1995Pension]
115
- : TABLES[FACTOR_TABLES.early1995LumpSum];
116
- }
117
- return early
118
- ? TABLES[FACTOR_TABLES.earlyAge65]
119
- : TABLES[FACTOR_TABLES.late2008];
94
+ /** Every table the library reads, by its GAD reference. The one set of
95
+ * instances, so two callers cannot read the same table two ways. */
96
+ export function factorTable(ref) {
97
+ return TABLES[ref];
120
98
  }
121
- const keyedByAge = (table) => table.index.by === 'age';
122
99
  /**
123
100
  * Read the factor for a drawing. The date decides the direction as well
124
101
  * as the cell, so a basis whose direction the dates contradict is a bug
@@ -158,4 +135,39 @@ export function readFactor(basis, dateOfBirth, drawn) {
158
135
  provenance: table.provenance,
159
136
  };
160
137
  }
138
+ /**
139
+ * A figure with its factor applied: the one place `after` is made, so it
140
+ * is always `beforeFactor` times the factor, in both rulers. No factor
141
+ * means the rules pay nothing, so nothing is paid after it.
142
+ */
143
+ export function factored(beforeFactor, factor) {
144
+ const times = factor === null ? 0 : factor.factor;
145
+ return { beforeFactor, after: timesMoney(beforeFactor, times), factor };
146
+ }
147
+ /** The table a basis reads, and how it is keyed. */
148
+ function tableFor(basis) {
149
+ const section2015 = basis.against === MEMBERS_NPA;
150
+ const section1995 = basis.against === LEGACY_PENSION_AGES.section1995;
151
+ const early = basis.direction === FACTOR_DIRECTIONS.early;
152
+ if (section2015) {
153
+ const additionalPension = basis.applies === FACTOR_APPLIES.additionalPension;
154
+ if (early)
155
+ return TABLES[FACTOR_TABLES.early2015];
156
+ return additionalPension
157
+ ? TABLES[FACTOR_TABLES.late2015AdditionalPension]
158
+ : TABLES[FACTOR_TABLES.late2015];
159
+ }
160
+ if (section1995) {
161
+ const pension = basis.applies === FACTOR_APPLIES.pension;
162
+ return pension
163
+ ? TABLES[FACTOR_TABLES.early1995Pension]
164
+ : TABLES[FACTOR_TABLES.early1995LumpSum];
165
+ }
166
+ return early
167
+ ? TABLES[FACTOR_TABLES.earlyAge65]
168
+ : TABLES[FACTOR_TABLES.late2008];
169
+ }
170
+ function keyedByAge(table) {
171
+ return table.index.by === 'age';
172
+ }
161
173
  //# sourceMappingURL=factor-basis.js.map