@htilabs/platform-common-models 0.8.1 → 0.8.4

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 +335 -3
  8. package/dist/cvcs/index.cjs.map +1 -1
  9. package/dist/cvcs/index.d.cts +1621 -1255
  10. package/dist/cvcs/index.d.ts +1621 -1255
  11. package/dist/cvcs/index.js +333 -3
  12. package/dist/cvcs/index.js.map +1 -1
  13. package/dist/index.cjs +406 -11
  14. package/dist/index.cjs.map +1 -1
  15. package/dist/index.d.cts +54 -6
  16. package/dist/index.d.ts +54 -6
  17. package/dist/index.js +401 -11
  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 +27 -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 +159 -0
  34. package/src/cvcs/incomeBenefitsSources.v1.0.0.json +31 -2
  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 +55 -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.4",
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": 41,
167
+ "hash": "2c4c08fad1d49bf23f7cb3b1cec4f209b92cfac657b80e09ff0468420339a422"
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": 16,
511
+ "hash": "4341619e6016822fcc353987a635421c767391a85f2ff7602726ca02bfa0f4f7"
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,14 @@ 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 + 30 L2 source codes + 1 additive L1
370
+ // `victim_compensation` group leaf (171-006) + 5 missingness = 41.
371
+ // Additive orphan leaves: informal_income (171-001-002) under earned_income
372
+ // and family_friend_support (171-004-003) under transfer_support.
367
373
  {
368
374
  file: "incomeBenefitsSources.v1.0.0.json",
369
375
  domain: "income_benefits_sources",
370
- expectedCount: 38,
376
+ expectedCount: 41,
371
377
  },
372
378
  // CVC-175 — 8 flat Level-1 enrollment lifecycle statuses + 1 missingness
373
379
  // root + 3 canonical missingness children = 12.
@@ -566,6 +572,20 @@ const SOT_SPECS: readonly SotSpec[] = [
566
572
  // codes + 1 missingness root + 3 canonical missingness children = 11.
567
573
  // CVC number is PROVISIONAL pending codebook-session ratification.
568
574
  { file: "relationshipConcern.v1.0.0.json", domain: "relationship_concern", expectedCount: 11 },
575
+ // PROVISIONAL CVC-232 recency_band — 6 time-window bands (within_3_months,
576
+ // months_3_to_6, months_6_to_12, one_year_or_more, years_3_to_10,
577
+ // ten_plus_years) + 1 missingness root + 3 canonical missingness children = 10.
578
+ // CVC number is PROVISIONAL pending codebook-session ratification.
579
+ { file: "recencyBand.v1.0.0.json", domain: "recency_band", expectedCount: 10 },
580
+ // PROVISIONAL CVC-233 housing_subsidy_types — 12 HMIS-aligned subsidy types
581
+ // (housing_choice_voucher, public_housing, project_based_rental_assistance,
582
+ // permanent_supportive_housing, rapid_rehousing_assistance,
583
+ // other_housing_subsidy, no_subsidy, plus additive va_supportive_housing,
584
+ // grant_per_diem_transition_in_place, housing_stability_voucher,
585
+ // family_unification_program, foster_youth_to_independence) + 1 missingness
586
+ // root + 3 canonical missingness children = 16. CVC number is PROVISIONAL
587
+ // pending ratification.
588
+ { file: "housingSubsidyTypes.v1.0.0.json", domain: "housing_subsidy_types", expectedCount: 16 },
569
589
  ] as const;
570
590
 
571
591
  // ─── 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,159 @@
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-008-000-000-000-000-000",
97
+ "key": "va_supportive_housing",
98
+ "title": "VA Supportive Housing (HUD-VASH)",
99
+ "selectable": true,
100
+ "parentCode": null,
101
+ "childCodes": [],
102
+ "definition": "HUD-VASH: a HUD Housing Choice Voucher paired with VA case management and clinical services for homeless Veterans."
103
+ },
104
+ {
105
+ "code": "233-009-000-000-000-000-000",
106
+ "key": "grant_per_diem_transition_in_place",
107
+ "title": "Grant and Per Diem Transition-in-Place (GPD TIP)",
108
+ "selectable": true,
109
+ "parentCode": null,
110
+ "childCodes": [],
111
+ "definition": "VA Grant and Per Diem Transition-in-Place: transitional housing that converts to permanent housing for the Veteran in the same unit."
112
+ },
113
+ {
114
+ "code": "233-010-000-000-000-000-000",
115
+ "key": "housing_stability_voucher",
116
+ "title": "Housing Stability Voucher (HSV)",
117
+ "selectable": true,
118
+ "parentCode": null,
119
+ "childCodes": [],
120
+ "definition": "Housing Stability Voucher: rental assistance for individuals and families who are homeless, at risk of homelessness, or fleeing domestic violence."
121
+ },
122
+ {
123
+ "code": "233-011-000-000-000-000-000",
124
+ "key": "family_unification_program",
125
+ "title": "Family Unification Program (FUP)",
126
+ "selectable": true,
127
+ "parentCode": null,
128
+ "childCodes": [],
129
+ "definition": "Family Unification Program: HUD vouchers for families at risk of child-welfare separation and for eligible youth aging out of foster care."
130
+ },
131
+ {
132
+ "code": "233-012-000-000-000-000-000",
133
+ "key": "foster_youth_to_independence",
134
+ "title": "Foster Youth to Independence (FYI)",
135
+ "selectable": true,
136
+ "parentCode": null,
137
+ "childCodes": [],
138
+ "definition": "Foster Youth to Independence: HUD vouchers for youth aging out of foster care who are homeless or at risk of homelessness."
139
+ },
140
+ {
141
+ "code": "233-006-000-000-000-000-000",
142
+ "key": "other_housing_subsidy",
143
+ "title": "Other housing subsidy",
144
+ "selectable": true,
145
+ "parentCode": null,
146
+ "childCodes": [],
147
+ "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."
148
+ },
149
+ {
150
+ "code": "233-007-000-000-000-000-000",
151
+ "key": "no_subsidy",
152
+ "title": "No housing subsidy",
153
+ "selectable": true,
154
+ "parentCode": null,
155
+ "childCodes": [],
156
+ "definition": "The household receives no housing subsidy or rental assistance (housing costs are paid in full without a subsidy)."
157
+ }
158
+ ]
159
+ }
@@ -65,7 +65,8 @@
65
65
  "selectable": false,
66
66
  "parentCode": null,
67
67
  "childCodes": [
68
- "171-001-001-000-000-000-000"
68
+ "171-001-001-000-000-000-000",
69
+ "171-001-002-000-000-000-000"
69
70
  ],
70
71
  "definition": "Income from wages, salary, tips, gig/contract work, or other paid employment."
71
72
  },
@@ -78,6 +79,15 @@
78
79
  "childCodes": [],
79
80
  "definition": "Income from wages, salary, tips, gig/contract work, or other paid employment. Includes informal earned income that is not supported by official documentation."
80
81
  },
82
+ {
83
+ "code": "171-001-002-000-000-000-000",
84
+ "key": "informal_income",
85
+ "title": "Informal / undocumented income",
86
+ "selectable": true,
87
+ "parentCode": "171-001-000-000-000-000-000",
88
+ "childCodes": [],
89
+ "definition": "Informal or undocumented income, e.g. cash work or side activity not captured by formal employment or a benefit program."
90
+ },
81
91
  {
82
92
  "code": "171-002-000-000-000-000-000",
83
93
  "key": "cash_benefit",
@@ -326,7 +336,8 @@
326
336
  "parentCode": null,
327
337
  "childCodes": [
328
338
  "171-004-001-000-000-000-000",
329
- "171-004-002-000-000-000-000"
339
+ "171-004-002-000-000-000-000",
340
+ "171-004-003-000-000-000-000"
330
341
  ],
331
342
  "definition": "Income received as interpersonal transfers or support payments (e.g., child support, spousal support)."
332
343
  },
@@ -348,6 +359,15 @@
348
359
  "childCodes": [],
349
360
  "definition": "All periodic payments received from an ex-spouse as alimony or spousal support. Excludes one-time property settlements."
350
361
  },
362
+ {
363
+ "code": "171-004-003-000-000-000-000",
364
+ "key": "family_friend_support",
365
+ "title": "Family / friend financial support",
366
+ "selectable": true,
367
+ "parentCode": "171-004-000-000-000-000-000",
368
+ "childCodes": [],
369
+ "definition": "Informal financial support from family or friends, not a documented benefit program."
370
+ },
351
371
  {
352
372
  "code": "171-005-000-000-000-000-000",
353
373
  "key": "other_unspecified",
@@ -387,6 +407,15 @@
387
407
  "parentCode": "171-005-000-000-000-000-000",
388
408
  "childCodes": [],
389
409
  "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)."
410
+ },
411
+ {
412
+ "code": "171-006-000-000-000-000-000",
413
+ "key": "victim_compensation",
414
+ "title": "Crime victim compensation",
415
+ "selectable": true,
416
+ "parentCode": null,
417
+ "childCodes": [],
418
+ "definition": "Income or benefits from a state or federal crime-victim compensation program (e.g. VOCA-funded victim compensation)."
390
419
  }
391
420
  ]
392
421
  }
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",