@htilabs/platform-common-models 0.8.1 → 0.8.3

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 (38) hide show
  1. package/dist/constants/index.cjs +28 -5
  2. package/dist/constants/index.cjs.map +1 -1
  3. package/dist/constants/index.d.cts +1 -1
  4. package/dist/constants/index.d.ts +1 -1
  5. package/dist/constants/index.js +27 -5
  6. package/dist/constants/index.js.map +1 -1
  7. package/dist/cvcs/index.cjs +268 -1
  8. package/dist/cvcs/index.cjs.map +1 -1
  9. package/dist/cvcs/index.d.cts +1545 -1251
  10. package/dist/cvcs/index.d.ts +1545 -1251
  11. package/dist/cvcs/index.js +266 -1
  12. package/dist/cvcs/index.js.map +1 -1
  13. package/dist/index.cjs +332 -9
  14. package/dist/index.cjs.map +1 -1
  15. package/dist/index.d.cts +47 -6
  16. package/dist/index.d.ts +47 -6
  17. package/dist/index.js +327 -9
  18. package/dist/index.js.map +1 -1
  19. package/dist/{platform-auth-7dL99tZh.d.cts → platform-auth-BdnJUisw.d.cts} +16 -3
  20. package/dist/{platform-auth-7dL99tZh.d.ts → platform-auth-BdnJUisw.d.ts} +16 -3
  21. package/dist/schemas/index.cjs +25 -4
  22. package/dist/schemas/index.cjs.map +1 -1
  23. package/dist/schemas/index.js +25 -4
  24. package/dist/schemas/index.js.map +1 -1
  25. package/dist/types/index.d.cts +2 -2
  26. package/dist/types/index.d.ts +2 -2
  27. package/package.json +1 -1
  28. package/src/__tests__/__snapshots__/cvc-sot.snap +14 -6
  29. package/src/__tests__/cvc-sot-snapshot.test.ts +22 -7
  30. package/src/__tests__/cvc-structural.test.ts +2 -0
  31. package/src/constants/ic.ts +31 -3
  32. package/src/cvcs/highestEducationLevelCompleted.v1.0.0.json +9 -0
  33. package/src/cvcs/housingSubsidyTypes.v1.0.0.json +114 -0
  34. package/src/cvcs/incomeBenefitsSources.v1.0.0.json +9 -0
  35. package/src/cvcs/index.ts +4 -0
  36. package/src/cvcs/recencyBand.v1.0.0.json +105 -0
  37. package/src/cvcs/serviceStates.v1.0.0.json +23 -1
  38. package/src/generated/cvc-enums.ts +48 -3
@@ -1,5 +1,5 @@
1
- import { eg as PlatformToolValue, cO as FunctionStatusValue, eD as RoleLevelValue, eO as ShareViewValue, ec as PermissionStateValue } from '../platform-auth-7dL99tZh.cjs';
2
- export { h as AccommodationValue, i as AgeBinReportingValue, j as AppScopeValue, k as ApparentAgeValue, cE as DataQualityValue, cM as FormStatusValue, cN as FormTypeValue, cP as IC13Category, cR as IC13Value, cS as IC22Value, cT as IC23Value, cU as IC24Value, cV as IC25Value, cW as IC49ReferralOutcomeValue, cX as IC49ReferralVerificationValue, cY as IC49Value, cZ as IC4Value, c$ as IC56Value, d0 as IC57Value, d2 as IC58Value, d3 as IC59Value, d4 as IC5Value, dU as IncidentInvolvementRoleValue, dV as IncidentParticipationRoleValue, dW as InteractionTypeValue, dZ as MinorAdultStatusValue, ed as PersonDisplayCategoryValue, ee as PersonRoleValue, ef as PersonTypeValue, em as QuestionFormatValue, en as QuickStartTemplateId, ez as RecordStateValue, eB as RelationshipConcernValue, eC as RelationshipDynamicValue, eN as SessionStateValue, eP as SubmissionStateValue, eT as UserStatusValue } from '../platform-auth-7dL99tZh.cjs';
1
+ import { eh as PlatformToolValue, cO as FunctionStatusValue, eE as RoleLevelValue, eP as ShareViewValue, ed as PermissionStateValue } from '../platform-auth-BdnJUisw.cjs';
2
+ export { h as AccommodationValue, i as AgeBinReportingValue, j as AppScopeValue, k as ApparentAgeValue, cE as DataQualityValue, cM as FormStatusValue, cN as FormTypeValue, cP as IC13Category, cR as IC13Value, cS as IC22Value, cT as IC23Value, cU as IC24Value, cV as IC25Value, cW as IC49ReferralOutcomeValue, cX as IC49ReferralVerificationValue, cY as IC49Value, cZ as IC4Value, c$ as IC56Value, d0 as IC57Value, d2 as IC58Value, d3 as IC59Value, d4 as IC5Value, dV as IncidentInvolvementRoleValue, dW as IncidentParticipationRoleValue, dX as InteractionTypeValue, d_ as MinorAdultStatusValue, ee as PersonDisplayCategoryValue, ef as PersonRoleValue, eg as PersonTypeValue, en as QuestionFormatValue, eo as QuickStartTemplateId, eA as RecordStateValue, eC as RelationshipConcernValue, eD as RelationshipDynamicValue, eO as SessionStateValue, eQ as SubmissionStateValue, eU as UserStatusValue } from '../platform-auth-BdnJUisw.cjs';
3
3
 
4
4
  /**
5
5
  * @htilabs/platform-common-models — Platform Authorization Types
@@ -1,5 +1,5 @@
1
- import { eg as PlatformToolValue, cO as FunctionStatusValue, eD as RoleLevelValue, eO as ShareViewValue, ec as PermissionStateValue } from '../platform-auth-7dL99tZh.js';
2
- export { h as AccommodationValue, i as AgeBinReportingValue, j as AppScopeValue, k as ApparentAgeValue, cE as DataQualityValue, cM as FormStatusValue, cN as FormTypeValue, cP as IC13Category, cR as IC13Value, cS as IC22Value, cT as IC23Value, cU as IC24Value, cV as IC25Value, cW as IC49ReferralOutcomeValue, cX as IC49ReferralVerificationValue, cY as IC49Value, cZ as IC4Value, c$ as IC56Value, d0 as IC57Value, d2 as IC58Value, d3 as IC59Value, d4 as IC5Value, dU as IncidentInvolvementRoleValue, dV as IncidentParticipationRoleValue, dW as InteractionTypeValue, dZ as MinorAdultStatusValue, ed as PersonDisplayCategoryValue, ee as PersonRoleValue, ef as PersonTypeValue, em as QuestionFormatValue, en as QuickStartTemplateId, ez as RecordStateValue, eB as RelationshipConcernValue, eC as RelationshipDynamicValue, eN as SessionStateValue, eP as SubmissionStateValue, eT as UserStatusValue } from '../platform-auth-7dL99tZh.js';
1
+ import { eh as PlatformToolValue, cO as FunctionStatusValue, eE as RoleLevelValue, eP as ShareViewValue, ed as PermissionStateValue } from '../platform-auth-BdnJUisw.js';
2
+ export { h as AccommodationValue, i as AgeBinReportingValue, j as AppScopeValue, k as ApparentAgeValue, cE as DataQualityValue, cM as FormStatusValue, cN as FormTypeValue, cP as IC13Category, cR as IC13Value, cS as IC22Value, cT as IC23Value, cU as IC24Value, cV as IC25Value, cW as IC49ReferralOutcomeValue, cX as IC49ReferralVerificationValue, cY as IC49Value, cZ as IC4Value, c$ as IC56Value, d0 as IC57Value, d2 as IC58Value, d3 as IC59Value, d4 as IC5Value, dV as IncidentInvolvementRoleValue, dW as IncidentParticipationRoleValue, dX as InteractionTypeValue, d_ as MinorAdultStatusValue, ee as PersonDisplayCategoryValue, ef as PersonRoleValue, eg as PersonTypeValue, en as QuestionFormatValue, eo as QuickStartTemplateId, eA as RecordStateValue, eC as RelationshipConcernValue, eD as RelationshipDynamicValue, eO as SessionStateValue, eQ as SubmissionStateValue, eU as UserStatusValue } from '../platform-auth-BdnJUisw.js';
3
3
 
4
4
  /**
5
5
  * @htilabs/platform-common-models — Platform Authorization Types
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@htilabs/platform-common-models",
3
- "version": "0.8.1",
3
+ "version": "0.8.3",
4
4
  "description": "Shared constants, types, and models for HTI Labs applications",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",
@@ -7,8 +7,8 @@
7
7
  "hash": "d50072fd907c64496508282036790f320d659ce4756bd48ad25487442e8997af"
8
8
  },
9
9
  "service_states": {
10
- "count": 15,
11
- "hash": "b76a5eec570bc807fb028fd55324a1cdb4c95ab1603bc779d292bc2356ee727d"
10
+ "count": 17,
11
+ "hash": "5dd12b9fecae79f0edc3d8ceba435d3d6ea2a9acddfea0ae4751b8eb3530d85e"
12
12
  },
13
13
  "service_categories": {
14
14
  "count": 151,
@@ -91,8 +91,8 @@
91
91
  "hash": "8aae59799013ec2d66f0477b44e1b3d556d00a6b908b5d0e0117e4e9a41ce5aa"
92
92
  },
93
93
  "highest_education_level_completed": {
94
- "count": 12,
95
- "hash": "a8ba9ca9af5c9f4ac5f900065f9356a935ca0543bf182f871cae61db9a276172"
94
+ "count": 13,
95
+ "hash": "44913932f5ae942b8512f89b3f354aad83c1d0e99e9d3f848dda49fb5cfb50f0"
96
96
  },
97
97
  "preferred_contact_method": {
98
98
  "count": 4,
@@ -163,8 +163,8 @@
163
163
  "hash": "f78d52bf1960fb88e12cefb895a3defbdba971abda49618216460ae330f4addb"
164
164
  },
165
165
  "income_benefits_sources": {
166
- "count": 38,
167
- "hash": "f75a79ccd10cecdd37acf056d550f60eb86b8ef52b9b3f34bed49ef04c44dffc"
166
+ "count": 39,
167
+ "hash": "e5995e3f865bfa0de1a89ba348c180e39195810aa4cbf2395e3177f9a4d56d05"
168
168
  },
169
169
  "enrollment_application_status": {
170
170
  "count": 12,
@@ -501,6 +501,14 @@
501
501
  "relationship_concern": {
502
502
  "count": 11,
503
503
  "hash": "03e18352e1ffb13a4e9b63e1f4043923f1da7e0153649db6940d0bb2653917d8"
504
+ },
505
+ "recency_band": {
506
+ "count": 10,
507
+ "hash": "b215354a1492256e7b235bcfcf96988227105458b0eb9e49bbea42386b5d4e3c"
508
+ },
509
+ "housing_subsidy_types": {
510
+ "count": 11,
511
+ "hash": "79fdaa8ff5c9eed6131e9aa81449dd0ee674031c09e4ba5b56da122e8cba8272"
504
512
  }
505
513
  }
506
514
  }
@@ -61,8 +61,10 @@ const SOT_SPECS: readonly SotSpec[] = [
61
61
  // Spec §8.3 — "Entries: 4" + 4 missingness = 8
62
62
  { file: "serviceMechanisms.v1.0.0.json", domain: "service_mechanisms", expectedCount: 8 },
63
63
  // Spec §8.2 — "Entries: 10" + 4 missingness = 14; +1 (`unable_other_reason`
64
- // additive per Thread Phase-0 SOT Block D) = 15.
65
- { file: "serviceStates.v1.0.0.json", domain: "service_states", expectedCount: 15 },
64
+ // additive per Thread Phase-0 SOT Block D) = 15; +2 PROVISIONAL attempt-reason
65
+ // buckets (`unable_to_provide_service_fit`, `unable_to_provide_access_barrier`)
66
+ // for the Thread th-epqet.3 7-bucket lifecycle = 17.
67
+ { file: "serviceStates.v1.0.0.json", domain: "service_states", expectedCount: 17 },
66
68
  // Spec §8.1 — "Entries: 147" + 4 missingness = 151
67
69
  { file: "serviceCategories.v1.0.0.json", domain: "service_categories", expectedCount: 151 },
68
70
  // CVC-69 — 4 group parents + 11 role leaves + 4 missingness = 19
@@ -225,12 +227,13 @@ const SOT_SPECS: readonly SotSpec[] = [
225
227
  domain: "contact_safety_status",
226
228
  expectedCount: 6,
227
229
  },
228
- // CVC-180 — 7 flat Level-1 Census/ACS attainment entries + 1 missingness
229
- // root + 4 canonical missingness children (includes PNA) = 12.
230
+ // CVC-180 — 7 flat Level-1 Census/ACS attainment entries + 1 additive
231
+ // `trade_vocational` non-degree credential leaf (180-008) + 1 missingness
232
+ // root + 4 canonical missingness children (includes PNA) = 13.
230
233
  {
231
234
  file: "highestEducationLevelCompleted.v1.0.0.json",
232
235
  domain: "highest_education_level_completed",
233
- expectedCount: 12,
236
+ expectedCount: 13,
234
237
  },
235
238
  // CVC-185 — 4 flat preferred-contact-method entries. No missingness entries
236
239
  // (variant 0 per Notion: absence encodes "no preference") = 4.
@@ -363,11 +366,12 @@ const SOT_SPECS: readonly SotSpec[] = [
363
366
  domain: "referral_entity_category",
364
367
  expectedCount: 43,
365
368
  },
366
- // CVC-171 — 5 L1 type groups + 28 L2 source codes + 5 missingness = 38.
369
+ // CVC-171 — 5 L1 type groups + 28 L2 source codes + 1 additive L1
370
+ // `victim_compensation` group leaf (171-006) + 5 missingness = 39.
367
371
  {
368
372
  file: "incomeBenefitsSources.v1.0.0.json",
369
373
  domain: "income_benefits_sources",
370
- expectedCount: 38,
374
+ expectedCount: 39,
371
375
  },
372
376
  // CVC-175 — 8 flat Level-1 enrollment lifecycle statuses + 1 missingness
373
377
  // root + 3 canonical missingness children = 12.
@@ -566,6 +570,17 @@ const SOT_SPECS: readonly SotSpec[] = [
566
570
  // codes + 1 missingness root + 3 canonical missingness children = 11.
567
571
  // CVC number is PROVISIONAL pending codebook-session ratification.
568
572
  { file: "relationshipConcern.v1.0.0.json", domain: "relationship_concern", expectedCount: 11 },
573
+ // PROVISIONAL CVC-232 recency_band — 6 time-window bands (within_3_months,
574
+ // months_3_to_6, months_6_to_12, one_year_or_more, years_3_to_10,
575
+ // ten_plus_years) + 1 missingness root + 3 canonical missingness children = 10.
576
+ // CVC number is PROVISIONAL pending codebook-session ratification.
577
+ { file: "recencyBand.v1.0.0.json", domain: "recency_band", expectedCount: 10 },
578
+ // PROVISIONAL CVC-233 housing_subsidy_types — 7 HMIS-aligned subsidy types
579
+ // (housing_choice_voucher, public_housing, project_based_rental_assistance,
580
+ // permanent_supportive_housing, rapid_rehousing_assistance,
581
+ // other_housing_subsidy, no_subsidy) + 1 missingness root + 3 canonical
582
+ // missingness children = 11. CVC number is PROVISIONAL pending ratification.
583
+ { file: "housingSubsidyTypes.v1.0.0.json", domain: "housing_subsidy_types", expectedCount: 11 },
569
584
  ] as const;
570
585
 
571
586
  // ─── Helpers ────────────────────────────────────────────────────────────────
@@ -175,6 +175,8 @@ const SOT_FILES: readonly SotFile[] = [
175
175
  { file: "victimAbuseTypes.v1.0.0.json", expectedDomain: "victim_abuse_types" },
176
176
  { file: "htType.v1.0.0.json", expectedDomain: "ht_type" },
177
177
  { file: "relationshipConcern.v1.0.0.json", expectedDomain: "relationship_concern" },
178
+ { file: "recencyBand.v1.0.0.json", expectedDomain: "recency_band" },
179
+ { file: "housingSubsidyTypes.v1.0.0.json", expectedDomain: "housing_subsidy_types" },
178
180
  ] as const;
179
181
 
180
182
  function loadSot(file: string): unknown {
@@ -701,13 +701,27 @@ export const IC_56_SERVICE_DELIVERY_CHANNEL = {
701
701
  PHONE: 3,
702
702
  EMAIL_TEXT_CHAT: 4,
703
703
  VIRTUAL: 5,
704
+ // PROVISIONAL — group delivery channels surfaced by the Thread canonical
705
+ // "How was the service delivered?" picker. Authored ahead of codebook /
706
+ // Notion ratification; flagged provisional pending SOT sign-off.
707
+ GROUP_IN_PERSON: 6,
708
+ GROUP_REMOTE: 7,
704
709
  } as const;
705
710
 
706
711
  export type IC56Value =
707
712
  (typeof IC_56_SERVICE_DELIVERY_CHANNEL)[keyof typeof IC_56_SERVICE_DELIVERY_CHANNEL];
708
713
 
709
- /** Level 1 values only (excludes missingness codes). */
710
- export type IC56ChannelValue = 1 | 2 | 3 | 4 | 5;
714
+ /** Level 1 values only (excludes missingness codes). 6/7 are PROVISIONAL. */
715
+ export type IC56ChannelValue = 1 | 2 | 3 | 4 | 5 | 6 | 7;
716
+
717
+ /**
718
+ * PROVISIONAL IC-56 channel values pending codebook ratification.
719
+ * Consumers may gate on this set to surface a "draft" affordance.
720
+ */
721
+ export const IC_56_PROVISIONAL_CHANNELS: ReadonlySet<number> = new Set([
722
+ IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_IN_PERSON,
723
+ IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_REMOTE,
724
+ ]);
711
725
 
712
726
  export const IC_56_LABELS: Record<IC56Value, string> = {
713
727
  [IC_56_SERVICE_DELIVERY_CHANNEL.DATA_NOT_COLLECTED]: "Data Not Collected",
@@ -718,6 +732,8 @@ export const IC_56_LABELS: Record<IC56Value, string> = {
718
732
  [IC_56_SERVICE_DELIVERY_CHANNEL.PHONE]: "Phone",
719
733
  [IC_56_SERVICE_DELIVERY_CHANNEL.EMAIL_TEXT_CHAT]: "Email / Text / Chat",
720
734
  [IC_56_SERVICE_DELIVERY_CHANNEL.VIRTUAL]: "Virtual",
735
+ [IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_IN_PERSON]: "Group (in-person)",
736
+ [IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_REMOTE]: "Group (remote)",
721
737
  };
722
738
 
723
739
  export const IC_56_DESCRIPTIONS: Record<IC56Value, string> = {
@@ -734,6 +750,10 @@ export const IC_56_DESCRIPTIONS: Record<IC56Value, string> = {
734
750
  [IC_56_SERVICE_DELIVERY_CHANNEL.EMAIL_TEXT_CHAT]:
735
751
  "Email, text message, or chat",
736
752
  [IC_56_SERVICE_DELIVERY_CHANNEL.VIRTUAL]: "Virtual / video call",
753
+ [IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_IN_PERSON]:
754
+ "Group session delivered in person (support group, class, workshop)",
755
+ [IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_REMOTE]:
756
+ "Group session delivered remotely (virtual support group, webinar)",
737
757
  };
738
758
 
739
759
  /**
@@ -751,7 +771,7 @@ export function isIC56Missingness(code: number): boolean {
751
771
  * @returns True if the code represents an actual delivery channel
752
772
  */
753
773
  export function isIC56ValidChannel(code: number): code is IC56ChannelValue {
754
- return code >= 1 && code <= 5;
774
+ return code >= 1 && code <= 7;
755
775
  }
756
776
 
757
777
  /** Options array for dropdown/radio components (Level 1 only). */
@@ -776,6 +796,14 @@ export const IC_56_OPTIONS = [
776
796
  value: IC_56_SERVICE_DELIVERY_CHANNEL.VIRTUAL,
777
797
  label: IC_56_LABELS[IC_56_SERVICE_DELIVERY_CHANNEL.VIRTUAL],
778
798
  },
799
+ {
800
+ value: IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_IN_PERSON,
801
+ label: IC_56_LABELS[IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_IN_PERSON],
802
+ },
803
+ {
804
+ value: IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_REMOTE,
805
+ label: IC_56_LABELS[IC_56_SERVICE_DELIVERY_CHANNEL.GROUP_REMOTE],
806
+ },
779
807
  ] as const;
780
808
 
781
809
  // ─── IC-57: Service Audience / Beneficiary ──────────────────────────
@@ -70,6 +70,15 @@
70
70
  "childCodes": [],
71
71
  "definition": "Completed a master's, doctoral, or professional degree (MA, MS, MBA, JD, MD, PhD, or equivalent). Aligns with Census/ACS 'Graduate or professional degree'."
72
72
  },
73
+ {
74
+ "code": "180-008-000-000-000-000-000",
75
+ "key": "trade_vocational",
76
+ "title": "Trade or vocational credential",
77
+ "selectable": true,
78
+ "parentCode": null,
79
+ "childCodes": [],
80
+ "definition": "Completed a trade, vocational, or technical credential (apprenticeship, licensure, or postsecondary non-degree award) rather than an academic degree."
81
+ },
73
82
  {
74
83
  "code": "180-000-000-000-000-000-000",
75
84
  "key": "missingness_root",
@@ -0,0 +1,114 @@
1
+ {
2
+ "domain": "housing_subsidy_types",
3
+ "name": "Core Housing Subsidy Types (PROVISIONAL CVC-233 — pending codebook ratification)",
4
+ "version": "1.0.0",
5
+ "levels": {
6
+ "0": "Unknown or Missing",
7
+ "1": "Housing subsidy type"
8
+ },
9
+ "entries": [
10
+ {
11
+ "code": "233-000-000-000-000-000-000",
12
+ "key": "missingness_root",
13
+ "title": "Unknown, Redacted, or Missing",
14
+ "selectable": false,
15
+ "parentCode": null,
16
+ "childCodes": [
17
+ "233-000-000-000-000-000-001",
18
+ "233-000-000-000-000-000-002",
19
+ "233-000-000-000-000-000-003"
20
+ ],
21
+ "definition": "Root group for values indicating absent, withheld, or uncollected data."
22
+ },
23
+ {
24
+ "code": "233-000-000-000-000-000-001",
25
+ "key": "unknown",
26
+ "title": "Unknown / not captured",
27
+ "selectable": true,
28
+ "parentCode": "233-000-000-000-000-000-000",
29
+ "childCodes": [],
30
+ "definition": "The housing subsidy type is unknown or cannot be determined from the available information."
31
+ },
32
+ {
33
+ "code": "233-000-000-000-000-000-002",
34
+ "key": "anonymous",
35
+ "title": "Anonymous / declined to answer",
36
+ "selectable": true,
37
+ "parentCode": "233-000-000-000-000-000-000",
38
+ "childCodes": [],
39
+ "definition": "The housing subsidy type may be withheld by preference or due to redaction; identity is anonymous or redacted."
40
+ },
41
+ {
42
+ "code": "233-000-000-000-000-000-003",
43
+ "key": "data_not_collected",
44
+ "title": "Data not collected",
45
+ "selectable": true,
46
+ "parentCode": "233-000-000-000-000-000-000",
47
+ "childCodes": [],
48
+ "definition": "No attempt was made to collect the housing subsidy type."
49
+ },
50
+ {
51
+ "code": "233-001-000-000-000-000-000",
52
+ "key": "housing_choice_voucher",
53
+ "title": "Housing Choice Voucher (Section 8 HCV)",
54
+ "selectable": true,
55
+ "parentCode": null,
56
+ "childCodes": [],
57
+ "definition": "Tenant-based rental assistance through the HUD Housing Choice Voucher program (Section 8 HCV), which subsidizes rent in private-market units chosen by the tenant."
58
+ },
59
+ {
60
+ "code": "233-002-000-000-000-000-000",
61
+ "key": "public_housing",
62
+ "title": "Public housing",
63
+ "selectable": true,
64
+ "parentCode": null,
65
+ "childCodes": [],
66
+ "definition": "Residence in a public housing unit owned and operated by a public housing authority (PHA), with rent set as a subsidized share of household income."
67
+ },
68
+ {
69
+ "code": "233-003-000-000-000-000-000",
70
+ "key": "project_based_rental_assistance",
71
+ "title": "Project-based rental assistance",
72
+ "selectable": true,
73
+ "parentCode": null,
74
+ "childCodes": [],
75
+ "definition": "Rental assistance tied to a specific housing development or unit (e.g. project-based Section 8, project-based vouchers, or other site-based subsidy) rather than to the tenant."
76
+ },
77
+ {
78
+ "code": "233-004-000-000-000-000-000",
79
+ "key": "permanent_supportive_housing",
80
+ "title": "Permanent supportive housing (PSH)",
81
+ "selectable": true,
82
+ "parentCode": null,
83
+ "childCodes": [],
84
+ "definition": "Permanent housing that pairs a long-term rental subsidy with voluntary supportive services for people with disabilities or chronic homelessness (HUD CoC PSH)."
85
+ },
86
+ {
87
+ "code": "233-005-000-000-000-000-000",
88
+ "key": "rapid_rehousing_assistance",
89
+ "title": "Rapid re-housing assistance",
90
+ "selectable": true,
91
+ "parentCode": null,
92
+ "childCodes": [],
93
+ "definition": "Time-limited rental assistance and housing-stabilization services to help a household quickly exit homelessness into permanent housing (HUD CoC/ESG rapid re-housing)."
94
+ },
95
+ {
96
+ "code": "233-006-000-000-000-000-000",
97
+ "key": "other_housing_subsidy",
98
+ "title": "Other housing subsidy",
99
+ "selectable": true,
100
+ "parentCode": null,
101
+ "childCodes": [],
102
+ "definition": "A housing subsidy or rental-assistance program not covered by the other codes (e.g. state or local subsidy, HOME TBRA, or other program). Record program name and free-text detail alongside this code to preserve analytic value."
103
+ },
104
+ {
105
+ "code": "233-007-000-000-000-000-000",
106
+ "key": "no_subsidy",
107
+ "title": "No housing subsidy",
108
+ "selectable": true,
109
+ "parentCode": null,
110
+ "childCodes": [],
111
+ "definition": "The household receives no housing subsidy or rental assistance (housing costs are paid in full without a subsidy)."
112
+ }
113
+ ]
114
+ }
@@ -387,6 +387,15 @@
387
387
  "parentCode": "171-005-000-000-000-000-000",
388
388
  "childCodes": [],
389
389
  "definition": "Income received as a stipend, scholarship refund, training allowance, or other education-related payment that can function as income for living expenses. Funder-specific exclusions may apply (e.g., SSVF)."
390
+ },
391
+ {
392
+ "code": "171-006-000-000-000-000-000",
393
+ "key": "victim_compensation",
394
+ "title": "Crime victim compensation",
395
+ "selectable": true,
396
+ "parentCode": null,
397
+ "childCodes": [],
398
+ "definition": "Income or benefits from a state or federal crime-victim compensation program (e.g. VOCA-funded victim compensation)."
390
399
  }
391
400
  ]
392
401
  }
package/src/cvcs/index.ts CHANGED
@@ -144,6 +144,8 @@ import hmisRelationshipToHohSot from "./hmisRelationshipToHoh.v1.0.0.json" with
144
144
  import victimAbuseTypesSot from "./victimAbuseTypes.v1.0.0.json" with { type: "json" };
145
145
  import htTypeSot from "./htType.v1.0.0.json" with { type: "json" };
146
146
  import relationshipConcernSot from "./relationshipConcern.v1.0.0.json" with { type: "json" };
147
+ import recencyBandSot from "./recencyBand.v1.0.0.json" with { type: "json" };
148
+ import housingSubsidyTypesSot from "./housingSubsidyTypes.v1.0.0.json" with { type: "json" };
147
149
 
148
150
  export {
149
151
  serviceCategoriesSot,
@@ -271,4 +273,6 @@ export {
271
273
  victimAbuseTypesSot,
272
274
  htTypeSot,
273
275
  relationshipConcernSot,
276
+ recencyBandSot,
277
+ housingSubsidyTypesSot,
274
278
  };
@@ -0,0 +1,105 @@
1
+ {
2
+ "domain": "recency_band",
3
+ "name": "Core Recency Band (PROVISIONAL CVC-232 — pending codebook ratification)",
4
+ "version": "1.0.0",
5
+ "levels": {
6
+ "0": "Unknown or Missing",
7
+ "1": "Recency band"
8
+ },
9
+ "entries": [
10
+ {
11
+ "code": "232-000-000-000-000-000-000",
12
+ "key": "missingness_root",
13
+ "title": "Unknown, Redacted, or Missing",
14
+ "selectable": false,
15
+ "parentCode": null,
16
+ "childCodes": [
17
+ "232-000-000-000-000-000-001",
18
+ "232-000-000-000-000-000-002",
19
+ "232-000-000-000-000-000-003"
20
+ ],
21
+ "definition": "Root group for values indicating absent, withheld, or uncollected data."
22
+ },
23
+ {
24
+ "code": "232-000-000-000-000-000-001",
25
+ "key": "unknown",
26
+ "title": "Unknown / not captured",
27
+ "selectable": true,
28
+ "parentCode": "232-000-000-000-000-000-000",
29
+ "childCodes": [],
30
+ "definition": "The recency band is unknown or cannot be determined from the available information."
31
+ },
32
+ {
33
+ "code": "232-000-000-000-000-000-002",
34
+ "key": "anonymous",
35
+ "title": "Anonymous / declined to answer",
36
+ "selectable": true,
37
+ "parentCode": "232-000-000-000-000-000-000",
38
+ "childCodes": [],
39
+ "definition": "The recency band may be withheld by preference or due to redaction; identity is anonymous or redacted."
40
+ },
41
+ {
42
+ "code": "232-000-000-000-000-000-003",
43
+ "key": "data_not_collected",
44
+ "title": "Data not collected",
45
+ "selectable": true,
46
+ "parentCode": "232-000-000-000-000-000-000",
47
+ "childCodes": [],
48
+ "definition": "No attempt was made to collect the recency band."
49
+ },
50
+ {
51
+ "code": "232-001-000-000-000-000-000",
52
+ "key": "within_3_months",
53
+ "title": "Within the last 3 months",
54
+ "selectable": true,
55
+ "parentCode": null,
56
+ "childCodes": [],
57
+ "definition": "The event or condition occurred within the most recent 3 months (0 up to and including 3 months before time_as_of)."
58
+ },
59
+ {
60
+ "code": "232-002-000-000-000-000-000",
61
+ "key": "months_3_to_6",
62
+ "title": "3 to 6 months ago",
63
+ "selectable": true,
64
+ "parentCode": null,
65
+ "childCodes": [],
66
+ "definition": "The event or condition occurred more than 3 and up to and including 6 months before time_as_of."
67
+ },
68
+ {
69
+ "code": "232-003-000-000-000-000-000",
70
+ "key": "months_6_to_12",
71
+ "title": "6 to 12 months ago",
72
+ "selectable": true,
73
+ "parentCode": null,
74
+ "childCodes": [],
75
+ "definition": "The event or condition occurred more than 6 and up to and including 12 months before time_as_of."
76
+ },
77
+ {
78
+ "code": "232-004-000-000-000-000-000",
79
+ "key": "one_year_or_more",
80
+ "title": "1 year or more ago",
81
+ "selectable": true,
82
+ "parentCode": null,
83
+ "childCodes": [],
84
+ "definition": "The event or condition occurred at least 1 year before time_as_of. Use a finer-grained band (years_3_to_10 or ten_plus_years) when the source supports it."
85
+ },
86
+ {
87
+ "code": "232-005-000-000-000-000-000",
88
+ "key": "years_3_to_10",
89
+ "title": "3 to 10 years ago",
90
+ "selectable": true,
91
+ "parentCode": null,
92
+ "childCodes": [],
93
+ "definition": "The event or condition occurred more than 3 and up to and including 10 years before time_as_of."
94
+ },
95
+ {
96
+ "code": "232-006-000-000-000-000-000",
97
+ "key": "ten_plus_years",
98
+ "title": "More than 10 years ago",
99
+ "selectable": true,
100
+ "parentCode": null,
101
+ "childCodes": [],
102
+ "definition": "The event or condition occurred more than 10 years before time_as_of."
103
+ }
104
+ ]
105
+ }
@@ -72,7 +72,9 @@
72
72
  "049-007-001-000-000-000-000",
73
73
  "049-007-002-000-000-000-000",
74
74
  "049-007-003-000-000-000-000",
75
- "049-007-004-000-000-000-000"
75
+ "049-007-004-000-000-000-000",
76
+ "049-007-005-000-000-000-000",
77
+ "049-007-006-000-000-000-000"
76
78
  ],
77
79
  "definition": "Program could not provide the service."
78
80
  },
@@ -112,6 +114,26 @@
112
114
  "childCodes": [],
113
115
  "definition": "Program could not provide the Service for a reason other than eligibility, capacity, or resources."
114
116
  },
117
+ {
118
+ "code": "049-007-005-000-000-000-000",
119
+ "key": "unable_to_provide_service_fit",
120
+ "title": "Unable due to service fit",
121
+ "selectable": true,
122
+ "parentCode": "049-007-000-000-000-000-000",
123
+ "childCodes": [],
124
+ "definition": "Program's services were not an appropriate fit for the client's presenting needs.",
125
+ "provisional": true
126
+ },
127
+ {
128
+ "code": "049-007-006-000-000-000-000",
129
+ "key": "unable_to_provide_access_barrier",
130
+ "title": "Unable due to access barrier",
131
+ "selectable": true,
132
+ "parentCode": "049-007-000-000-000-000-000",
133
+ "childCodes": [],
134
+ "definition": "An access barrier (e.g. language, transportation, location, hours, technology) prevented service delivery.",
135
+ "provisional": true
136
+ },
115
137
  {
116
138
  "code": "049-000-000-000-000-000-000",
117
139
  "key": "missingness_root",
@@ -173,7 +173,7 @@ export type ServiceCategoryKey = keyof typeof ServiceCategoryKeys;
173
173
  /**
174
174
  * Key → positional code map for the `service_states` CVC domain.
175
175
  *
176
- * Domain: `service_states` · Version: 1.0.0 · Entries: 15
176
+ * Domain: `service_states` · Version: 1.0.0 · Entries: 17
177
177
  */
178
178
  export const ServiceStateKeys = {
179
179
  missingness_root: "049-000-000-000-000-000-000",
@@ -191,6 +191,8 @@ export const ServiceStateKeys = {
191
191
  unable_to_provide_capacity: "049-007-002-000-000-000-000",
192
192
  unable_to_provide_resource: "049-007-003-000-000-000-000",
193
193
  unable_other_reason: "049-007-004-000-000-000-000",
194
+ unable_to_provide_service_fit: "049-007-005-000-000-000-000",
195
+ unable_to_provide_access_barrier: "049-007-006-000-000-000-000",
194
196
  } as const;
195
197
 
196
198
  export type ServiceStateKey = keyof typeof ServiceStateKeys;
@@ -835,7 +837,7 @@ export type ContactSafetyStatusKey = keyof typeof ContactSafetyStatusKeys;
835
837
  /**
836
838
  * Key → positional code map for the `highest_education_level_completed` CVC domain.
837
839
  *
838
- * Domain: `highest_education_level_completed` · Version: 1.0.0 · Entries: 12
840
+ * Domain: `highest_education_level_completed` · Version: 1.0.0 · Entries: 13
839
841
  */
840
842
  export const HighestEducationLevelCompletedKeys = {
841
843
  missingness_root: "180-000-000-000-000-000-000",
@@ -850,6 +852,7 @@ export const HighestEducationLevelCompletedKeys = {
850
852
  associates: "180-005-000-000-000-000-000",
851
853
  bachelors: "180-006-000-000-000-000-000",
852
854
  graduate_professional: "180-007-000-000-000-000-000",
855
+ trade_vocational: "180-008-000-000-000-000-000",
853
856
  } as const;
854
857
 
855
858
  export type HighestEducationLevelCompletedKey = keyof typeof HighestEducationLevelCompletedKeys;
@@ -1368,7 +1371,7 @@ export type ReferralEntityCategoryKey = keyof typeof ReferralEntityCategoryKeys;
1368
1371
  /**
1369
1372
  * Key → positional code map for the `income_benefits_sources` CVC domain.
1370
1373
  *
1371
- * Domain: `income_benefits_sources` · Version: 1.0.0 · Entries: 38
1374
+ * Domain: `income_benefits_sources` · Version: 1.0.0 · Entries: 39
1372
1375
  */
1373
1376
  export const IncomeBenefitsSourcesKeys = {
1374
1377
  missingness_root: "171-000-000-000-000-000-000",
@@ -1409,6 +1412,7 @@ export const IncomeBenefitsSourcesKeys = {
1409
1412
  other_income: "171-005-001-000-000-000-000",
1410
1413
  other_benefit: "171-005-002-000-000-000-000",
1411
1414
  education_stipend: "171-005-003-000-000-000-000",
1415
+ victim_compensation: "171-006-000-000-000-000-000",
1412
1416
  } as const;
1413
1417
 
1414
1418
  export type IncomeBenefitsSourcesKey = keyof typeof IncomeBenefitsSourcesKeys;
@@ -3450,3 +3454,44 @@ export const RelationshipConcernKeys = {
3450
3454
  } as const;
3451
3455
 
3452
3456
  export type RelationshipConcernKey = keyof typeof RelationshipConcernKeys;
3457
+
3458
+ /**
3459
+ * Key → positional code map for the `recency_band` CVC domain (PROVISIONAL CVC-232 — pending codebook ratification).
3460
+ *
3461
+ * Domain: `recency_band` · Version: 1.0.0 · Entries: 10
3462
+ */
3463
+ export const RecencyBandKeys = {
3464
+ missingness_root: "232-000-000-000-000-000-000",
3465
+ unknown: "232-000-000-000-000-000-001",
3466
+ anonymous: "232-000-000-000-000-000-002",
3467
+ data_not_collected: "232-000-000-000-000-000-003",
3468
+ within_3_months: "232-001-000-000-000-000-000",
3469
+ months_3_to_6: "232-002-000-000-000-000-000",
3470
+ months_6_to_12: "232-003-000-000-000-000-000",
3471
+ one_year_or_more: "232-004-000-000-000-000-000",
3472
+ years_3_to_10: "232-005-000-000-000-000-000",
3473
+ ten_plus_years: "232-006-000-000-000-000-000",
3474
+ } as const;
3475
+
3476
+ export type RecencyBandKey = keyof typeof RecencyBandKeys;
3477
+
3478
+ /**
3479
+ * Key → positional code map for the `housing_subsidy_types` CVC domain (PROVISIONAL CVC-233 — pending codebook ratification).
3480
+ *
3481
+ * Domain: `housing_subsidy_types` · Version: 1.0.0 · Entries: 11
3482
+ */
3483
+ export const HousingSubsidyTypesKeys = {
3484
+ missingness_root: "233-000-000-000-000-000-000",
3485
+ unknown: "233-000-000-000-000-000-001",
3486
+ anonymous: "233-000-000-000-000-000-002",
3487
+ data_not_collected: "233-000-000-000-000-000-003",
3488
+ housing_choice_voucher: "233-001-000-000-000-000-000",
3489
+ public_housing: "233-002-000-000-000-000-000",
3490
+ project_based_rental_assistance: "233-003-000-000-000-000-000",
3491
+ permanent_supportive_housing: "233-004-000-000-000-000-000",
3492
+ rapid_rehousing_assistance: "233-005-000-000-000-000-000",
3493
+ other_housing_subsidy: "233-006-000-000-000-000-000",
3494
+ no_subsidy: "233-007-000-000-000-000-000",
3495
+ } as const;
3496
+
3497
+ export type HousingSubsidyTypesKey = keyof typeof HousingSubsidyTypesKeys;