@htilabs/platform-common-models 0.1.0-beta.3 → 0.2.0-beta.2

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 (43) hide show
  1. package/dist/constants/index.cjs +437 -153
  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 +414 -153
  6. package/dist/constants/index.js.map +1 -1
  7. package/dist/index.cjs +610 -154
  8. package/dist/index.cjs.map +1 -1
  9. package/dist/index.d.cts +3 -3
  10. package/dist/index.d.ts +3 -3
  11. package/dist/index.js +579 -154
  12. package/dist/index.js.map +1 -1
  13. package/dist/models/index.cjs +306 -1
  14. package/dist/models/index.cjs.map +1 -1
  15. package/dist/models/index.d.cts +99 -11
  16. package/dist/models/index.d.ts +99 -11
  17. package/dist/models/index.js +304 -1
  18. package/dist/models/index.js.map +1 -1
  19. package/dist/{index-Cww9rH3H.d.cts → platform-auth-C-G2qeGM.d.cts} +167 -56
  20. package/dist/{index-Cww9rH3H.d.ts → platform-auth-C-G2qeGM.d.ts} +167 -56
  21. package/dist/{scoring-rule-liZlPytD.d.cts → platform-role-AHv1l5Og.d.cts} +177 -1
  22. package/dist/{scoring-rule-liZlPytD.d.ts → platform-role-AHv1l5Og.d.ts} +177 -1
  23. package/dist/schemas/index.cjs +539 -153
  24. package/dist/schemas/index.cjs.map +1 -1
  25. package/dist/schemas/index.d.cts +1 -1
  26. package/dist/schemas/index.d.ts +1 -1
  27. package/dist/schemas/index.js +533 -153
  28. package/dist/schemas/index.js.map +1 -1
  29. package/dist/types/index.cjs.map +1 -1
  30. package/dist/types/index.d.cts +45 -1
  31. package/dist/types/index.d.ts +45 -1
  32. package/package.json +1 -1
  33. package/src/constants/ic.ts +254 -153
  34. package/src/constants/index.ts +1 -0
  35. package/src/constants/platform-auth.ts +189 -0
  36. package/src/models/index.ts +18 -1
  37. package/src/models/platformFunctionModel.ts +33 -0
  38. package/src/models/platformRoleModel.ts +33 -0
  39. package/src/schemas/index.ts +16 -0
  40. package/src/schemas/platform-function.ts +97 -0
  41. package/src/schemas/platform-role.ts +100 -0
  42. package/src/types/index.ts +14 -0
  43. package/src/types/platform-auth.ts +49 -0
@@ -2053,6 +2053,51 @@ export const CVC_93_LABELS: Record<CVC93Value, string> = {
2053
2053
  [CVC_93_CHILD_WELFARE_INVOLVEMENT.UNKNOWN]: "Unknown",
2054
2054
  };
2055
2055
 
2056
+ // ─── CVC-196: Child Welfare Episode Type ─────────────────────────────
2057
+ // Granular episode type details for child welfare involvement.
2058
+ // Use when child welfare involvement = current or previous.
2059
+
2060
+ export const CVC_196_CHILD_WELFARE_EPISODE_TYPE = {
2061
+ FOSTER_CARE_PLACEMENT: "foster_care_placement",
2062
+ GROUP_HOME_PLACEMENT: "group_home_placement",
2063
+ KINSHIP_GUARDIANSHIP_PLACEMENT: "kinship_guardianship_placement",
2064
+ RESIDENTIAL_TREATMENT_PLACEMENT: "residential_treatment_placement",
2065
+ IN_CUSTODY: "in_custody",
2066
+ CASE_OPEN: "case_open",
2067
+ DATA_NOT_COLLECTED: "DNC",
2068
+ UNKNOWN: "UNK",
2069
+ ANONYMOUS: "ANON",
2070
+ } as const;
2071
+
2072
+ export type CVC196Value =
2073
+ (typeof CVC_196_CHILD_WELFARE_EPISODE_TYPE)[keyof typeof CVC_196_CHILD_WELFARE_EPISODE_TYPE];
2074
+
2075
+ export const CVC_196_VALUES = [
2076
+ CVC_196_CHILD_WELFARE_EPISODE_TYPE.FOSTER_CARE_PLACEMENT,
2077
+ CVC_196_CHILD_WELFARE_EPISODE_TYPE.GROUP_HOME_PLACEMENT,
2078
+ CVC_196_CHILD_WELFARE_EPISODE_TYPE.KINSHIP_GUARDIANSHIP_PLACEMENT,
2079
+ CVC_196_CHILD_WELFARE_EPISODE_TYPE.RESIDENTIAL_TREATMENT_PLACEMENT,
2080
+ CVC_196_CHILD_WELFARE_EPISODE_TYPE.IN_CUSTODY,
2081
+ CVC_196_CHILD_WELFARE_EPISODE_TYPE.CASE_OPEN,
2082
+ CVC_196_CHILD_WELFARE_EPISODE_TYPE.DATA_NOT_COLLECTED,
2083
+ CVC_196_CHILD_WELFARE_EPISODE_TYPE.UNKNOWN,
2084
+ CVC_196_CHILD_WELFARE_EPISODE_TYPE.ANONYMOUS,
2085
+ ] as const;
2086
+
2087
+ export const CVC_196_LABELS: Record<CVC196Value, string> = {
2088
+ [CVC_196_CHILD_WELFARE_EPISODE_TYPE.FOSTER_CARE_PLACEMENT]: "Foster care placement",
2089
+ [CVC_196_CHILD_WELFARE_EPISODE_TYPE.GROUP_HOME_PLACEMENT]: "Group home placement",
2090
+ [CVC_196_CHILD_WELFARE_EPISODE_TYPE.KINSHIP_GUARDIANSHIP_PLACEMENT]:
2091
+ "Kinship placement / guardianship placement",
2092
+ [CVC_196_CHILD_WELFARE_EPISODE_TYPE.RESIDENTIAL_TREATMENT_PLACEMENT]:
2093
+ "Residential treatment placement (CW)",
2094
+ [CVC_196_CHILD_WELFARE_EPISODE_TYPE.IN_CUSTODY]: "In custody / ward of the state",
2095
+ [CVC_196_CHILD_WELFARE_EPISODE_TYPE.CASE_OPEN]: "Case open / investigation",
2096
+ [CVC_196_CHILD_WELFARE_EPISODE_TYPE.DATA_NOT_COLLECTED]: "Data not collected",
2097
+ [CVC_196_CHILD_WELFARE_EPISODE_TYPE.UNKNOWN]: "Unknown",
2098
+ [CVC_196_CHILD_WELFARE_EPISODE_TYPE.ANONYMOUS]: "Anonymous",
2099
+ };
2100
+
2056
2101
  // ─── CVC-95: Juvenile Justice Involvement Status ────────────────────
2057
2102
  // Temporal status for involvement in juvenile justice system.
2058
2103
 
@@ -3262,6 +3307,7 @@ export const CVC_115_LABELS: Record<CVC115Value, string> = {
3262
3307
 
3263
3308
  /**
3264
3309
  * CVC-171 Categories (non-selectable accordion headers)
3310
+ * Based on HMIS 4.02 (Income) and 4.03 (Non-Cash Benefits) structure.
3265
3311
  */
3266
3312
  export const CVC_171_CATEGORY = {
3267
3313
  INCOME: "income",
@@ -3277,128 +3323,141 @@ export const CVC_171_CATEGORY_LABELS: Record<CVC171Category, string> = {
3277
3323
  };
3278
3324
 
3279
3325
  /**
3280
- * CVC-171 Income/Benefits Values (all selectable items)
3326
+ * CVC-171 Income/Benefits Values - CANONICAL CODEBOOK CODES
3327
+ * Aligned with ic-cvc-codebook CVC-171 entries.
3328
+ * See: platform-dev.cvc_entries where cvcKey = "CVC-171"
3281
3329
  */
3282
3330
  export const CVC_171_INCOME_BENEFITS = {
3283
- // Income - Earned
3284
- WAGES_SALARY: "wages_salary",
3285
- SELF_EMPLOYMENT: "self_employment",
3286
- TIPS_COMMISSIONS: "tips_commissions",
3287
- // Income - Other
3288
- PENSION: "pension",
3289
- CHILD_SUPPORT: "child_support",
3290
- ALIMONY: "alimony",
3291
- FAMILY_FRIENDS: "family_friends",
3292
- OTHER_INCOME: "other_income",
3293
- // Benefits - Social Security (hierarchical parent)
3294
- SSA: "ssa",
3295
- SSI: "ssi",
3296
- SSDI: "ssdi",
3297
- SSA_RET: "ssa_ret",
3298
- // Benefits - Veterans (hierarchical parent)
3299
- VA: "va",
3300
- VA_SCD: "va_scd",
3301
- VA_NSC_PEN: "va_nsc_pen",
3302
- // Benefits - TANF (hierarchical parent)
3303
- TANF: "tanf",
3304
- TANF_CC: "tanf_cc",
3305
- TANF_TRANS: "tanf_trans",
3306
- TANF_OTHER_SVC: "tanf_other_svc",
3307
- // Benefits - Other
3308
- UNEMPLOYMENT: "unemployment",
3309
- WORKERS_COMP: "workers_comp",
3310
- SNAP: "snap",
3311
- WIC: "wic",
3312
- HOUSING_ASSISTANCE: "housing_assistance",
3313
- MEDICAID: "medicaid",
3314
- MEDICARE: "medicare",
3315
- OTHER_BENEFITS: "other_benefits",
3316
- // Missingness (not shown in UI, used for data)
3317
- NONE: "none",
3318
- UNKNOWN: "unknown",
3319
- DECLINED: "declined",
3331
+ // Income - Earned (HMIS 4.02)
3332
+ EMP: "EMP", // Employment (wages, salary, tips, gig/contract work)
3333
+ // Income - Retirement/Pension
3334
+ PENSION_JOB: "PENSION_JOB", // Pension or retirement income from a former job
3335
+ PRIV_DIS: "PRIV_DIS", // Private disability insurance
3336
+ // Income - Social Security (hierarchical parent)
3337
+ SSA: "SSA", // Social Security (type unknown)
3338
+ SSI: "SSI", // SSI (Supplemental Security Income)
3339
+ SSDI: "SSDI", // SSDI (Social Security Disability Insurance)
3340
+ SSA_RET: "SSA_RET", // Retirement income from Social Security
3341
+ // Income - Veterans (hierarchical parent)
3342
+ VA: "VA", // VA benefits (type unknown)
3343
+ VA_SCD: "VA_SCD", // VA service-connected disability compensation
3344
+ VA_NSC_PEN: "VA_NSC_PEN", // VA non-service-connected disability pension
3345
+ // Income - Other cash
3346
+ UI: "UI", // Unemployment insurance / assistance
3347
+ WC: "WC", // Workers' compensation
3348
+ TANF: "TANF", // TANF / AFDC (cash assistance)
3349
+ GA: "GA", // General Assistance / state cash assistance
3350
+ CSUP: "CSUP", // Child Support
3351
+ ALIM: "ALIM", // Alimony / spousal support
3352
+ OTH_INCOME: "OTH_INCOME", // Other income (unspecified)
3353
+ // Benefits - Food & Nutrition (HMIS 4.03)
3354
+ SNAP: "SNAP", // SNAP (food assistance / food stamps)
3355
+ WIC: "WIC", // WIC (nutrition assistance)
3356
+ // Benefits - TANF Services (hierarchical under TANF conceptually, but non-cash)
3357
+ TANF_CC: "TANF_CC", // TANF child care services
3358
+ TANF_TRANS: "TANF_TRANS", // TANF transportation services
3359
+ TANF_OTHER_SVC: "TANF_OTHER_SVC", // Other TANF-funded services
3360
+ // Benefits - Other non-cash
3361
+ HSGA: "HSGA", // Housing assistance / rental subsidy
3362
+ MCD: "MCD", // Medicaid (health insurance)
3363
+ MCR: "MCR", // Medicare (health insurance)
3364
+ CCSUB: "CCSUB", // Childcare subsidy / assistance
3365
+ EDU: "EDU", // Education stipend / scholarship / training allowance
3366
+ OTH_BENEFIT: "OTH_BENEFIT", // Other benefit/support (unspecified)
3367
+ // Missingness
3368
+ UNK: "UNK", // Unknown
3369
+ DNC: "DNC", // Data not collected
3370
+ ANON: "ANON", // Anonymous
3320
3371
  } as const;
3321
3372
 
3322
3373
  export type CVC171Value =
3323
3374
  (typeof CVC_171_INCOME_BENEFITS)[keyof typeof CVC_171_INCOME_BENEFITS];
3324
3375
 
3376
+ /**
3377
+ * Labels matching canonical codebook entries exactly.
3378
+ */
3325
3379
  export const CVC_171_LABELS: Record<CVC171Value, string> = {
3326
3380
  // Income - Earned
3327
- [CVC_171_INCOME_BENEFITS.WAGES_SALARY]: "Wages / Salary",
3328
- [CVC_171_INCOME_BENEFITS.SELF_EMPLOYMENT]: "Self-employment income",
3329
- [CVC_171_INCOME_BENEFITS.TIPS_COMMISSIONS]: "Tips / Commissions",
3330
- // Income - Other
3331
- [CVC_171_INCOME_BENEFITS.PENSION]: "Pension / Retirement",
3332
- [CVC_171_INCOME_BENEFITS.CHILD_SUPPORT]: "Child support",
3333
- [CVC_171_INCOME_BENEFITS.ALIMONY]: "Alimony / Spousal support",
3334
- [CVC_171_INCOME_BENEFITS.FAMILY_FRIENDS]: "Support from family/friends",
3335
- [CVC_171_INCOME_BENEFITS.OTHER_INCOME]: "Other income",
3336
- // Benefits - Social Security
3337
- [CVC_171_INCOME_BENEFITS.SSA]: "Social Security (type unknown)",
3381
+ [CVC_171_INCOME_BENEFITS.EMP]: "Employment",
3382
+ // Income - Retirement/Pension
3383
+ [CVC_171_INCOME_BENEFITS.PENSION_JOB]: "Pension or retirement income from a former job",
3384
+ [CVC_171_INCOME_BENEFITS.PRIV_DIS]: "Private disability insurance",
3385
+ // Income - Social Security
3386
+ [CVC_171_INCOME_BENEFITS.SSA]: "Social Security",
3338
3387
  [CVC_171_INCOME_BENEFITS.SSI]: "SSI (Supplemental Security Income)",
3339
- [CVC_171_INCOME_BENEFITS.SSDI]: "SSDI (Social Security Disability)",
3340
- [CVC_171_INCOME_BENEFITS.SSA_RET]: "Social Security Retirement",
3341
- // Benefits - Veterans
3342
- [CVC_171_INCOME_BENEFITS.VA]: "VA Benefits (type unknown)",
3343
- [CVC_171_INCOME_BENEFITS.VA_SCD]: "VA Service-Connected Disability",
3344
- [CVC_171_INCOME_BENEFITS.VA_NSC_PEN]: "VA Non-Service-Connected Pension",
3345
- // Benefits - TANF
3346
- [CVC_171_INCOME_BENEFITS.TANF]: "TANF (type unknown)",
3347
- [CVC_171_INCOME_BENEFITS.TANF_CC]: "TANF Child Care",
3348
- [CVC_171_INCOME_BENEFITS.TANF_TRANS]: "TANF Transportation",
3349
- [CVC_171_INCOME_BENEFITS.TANF_OTHER_SVC]: "TANF Other Services",
3350
- // Benefits - Other
3351
- [CVC_171_INCOME_BENEFITS.UNEMPLOYMENT]: "Unemployment insurance",
3352
- [CVC_171_INCOME_BENEFITS.WORKERS_COMP]: "Workers' compensation",
3353
- [CVC_171_INCOME_BENEFITS.SNAP]: "SNAP (Food stamps)",
3354
- [CVC_171_INCOME_BENEFITS.WIC]: "WIC",
3355
- [CVC_171_INCOME_BENEFITS.HOUSING_ASSISTANCE]: "Housing assistance",
3356
- [CVC_171_INCOME_BENEFITS.MEDICAID]: "Medicaid",
3357
- [CVC_171_INCOME_BENEFITS.MEDICARE]: "Medicare",
3358
- [CVC_171_INCOME_BENEFITS.OTHER_BENEFITS]: "Other benefits",
3388
+ [CVC_171_INCOME_BENEFITS.SSDI]: "SSDI (Social Security Disability Insurance)",
3389
+ [CVC_171_INCOME_BENEFITS.SSA_RET]: "Retirement income from Social Security",
3390
+ // Income - Veterans
3391
+ [CVC_171_INCOME_BENEFITS.VA]: "VA benefits",
3392
+ [CVC_171_INCOME_BENEFITS.VA_SCD]: "VA service-connected disability compensation",
3393
+ [CVC_171_INCOME_BENEFITS.VA_NSC_PEN]: "VA non-service-connected disability pension",
3394
+ // Income - Other cash
3395
+ [CVC_171_INCOME_BENEFITS.UI]: "Unemployment insurance / assistance",
3396
+ [CVC_171_INCOME_BENEFITS.WC]: "Workers' compensation",
3397
+ [CVC_171_INCOME_BENEFITS.TANF]: "TANF / AFDC",
3398
+ [CVC_171_INCOME_BENEFITS.GA]: "General Assistance / state cash assistance",
3399
+ [CVC_171_INCOME_BENEFITS.CSUP]: "Child Support",
3400
+ [CVC_171_INCOME_BENEFITS.ALIM]: "Alimony / spousal support",
3401
+ [CVC_171_INCOME_BENEFITS.OTH_INCOME]: "Other income (unspecified)",
3402
+ // Benefits - Food & Nutrition
3403
+ [CVC_171_INCOME_BENEFITS.SNAP]: "SNAP (food assistance / food stamps)",
3404
+ [CVC_171_INCOME_BENEFITS.WIC]: "WIC (nutrition assistance)",
3405
+ // Benefits - TANF Services
3406
+ [CVC_171_INCOME_BENEFITS.TANF_CC]: "TANF child care services",
3407
+ [CVC_171_INCOME_BENEFITS.TANF_TRANS]: "TANF transportation services",
3408
+ [CVC_171_INCOME_BENEFITS.TANF_OTHER_SVC]: "Other TANF-funded services",
3409
+ // Benefits - Other non-cash
3410
+ [CVC_171_INCOME_BENEFITS.HSGA]: "Housing assistance / rental subsidy",
3411
+ [CVC_171_INCOME_BENEFITS.MCD]: "Medicaid (health insurance)",
3412
+ [CVC_171_INCOME_BENEFITS.MCR]: "Medicare (health insurance)",
3413
+ [CVC_171_INCOME_BENEFITS.CCSUB]: "Childcare subsidy / assistance",
3414
+ [CVC_171_INCOME_BENEFITS.EDU]: "Education stipend / scholarship / training allowance",
3415
+ [CVC_171_INCOME_BENEFITS.OTH_BENEFIT]: "Other benefit/support (unspecified)",
3359
3416
  // Missingness
3360
- [CVC_171_INCOME_BENEFITS.NONE]: "No income or benefits",
3361
- [CVC_171_INCOME_BENEFITS.UNKNOWN]: "Unknown",
3362
- [CVC_171_INCOME_BENEFITS.DECLINED]: "Declined to answer",
3417
+ [CVC_171_INCOME_BENEFITS.UNK]: "Unknown",
3418
+ [CVC_171_INCOME_BENEFITS.DNC]: "Data not collected",
3419
+ [CVC_171_INCOME_BENEFITS.ANON]: "Anonymous",
3363
3420
  };
3364
3421
 
3365
3422
  /**
3366
3423
  * Maps each value to its category (INCOME or BENEFITS)
3424
+ * Based on HMIS 4.02 (Income and Sources) vs 4.03 (Non-Cash Benefits).
3367
3425
  */
3368
3426
  export const CVC_171_VALUE_TO_CATEGORY: Record<CVC171Value, CVC171Category> = {
3369
- // Income
3370
- [CVC_171_INCOME_BENEFITS.WAGES_SALARY]: CVC_171_CATEGORY.INCOME,
3371
- [CVC_171_INCOME_BENEFITS.SELF_EMPLOYMENT]: CVC_171_CATEGORY.INCOME,
3372
- [CVC_171_INCOME_BENEFITS.TIPS_COMMISSIONS]: CVC_171_CATEGORY.INCOME,
3373
- [CVC_171_INCOME_BENEFITS.PENSION]: CVC_171_CATEGORY.INCOME,
3374
- [CVC_171_INCOME_BENEFITS.CHILD_SUPPORT]: CVC_171_CATEGORY.INCOME,
3375
- [CVC_171_INCOME_BENEFITS.ALIMONY]: CVC_171_CATEGORY.INCOME,
3376
- [CVC_171_INCOME_BENEFITS.FAMILY_FRIENDS]: CVC_171_CATEGORY.INCOME,
3377
- [CVC_171_INCOME_BENEFITS.OTHER_INCOME]: CVC_171_CATEGORY.INCOME,
3378
- // Benefits
3379
- [CVC_171_INCOME_BENEFITS.SSA]: CVC_171_CATEGORY.BENEFITS,
3380
- [CVC_171_INCOME_BENEFITS.SSI]: CVC_171_CATEGORY.BENEFITS,
3381
- [CVC_171_INCOME_BENEFITS.SSDI]: CVC_171_CATEGORY.BENEFITS,
3382
- [CVC_171_INCOME_BENEFITS.SSA_RET]: CVC_171_CATEGORY.BENEFITS,
3383
- [CVC_171_INCOME_BENEFITS.VA]: CVC_171_CATEGORY.BENEFITS,
3384
- [CVC_171_INCOME_BENEFITS.VA_SCD]: CVC_171_CATEGORY.BENEFITS,
3385
- [CVC_171_INCOME_BENEFITS.VA_NSC_PEN]: CVC_171_CATEGORY.BENEFITS,
3386
- [CVC_171_INCOME_BENEFITS.TANF]: CVC_171_CATEGORY.BENEFITS,
3427
+ // Income (HMIS 4.02 - cash income sources)
3428
+ [CVC_171_INCOME_BENEFITS.EMP]: CVC_171_CATEGORY.INCOME,
3429
+ [CVC_171_INCOME_BENEFITS.PENSION_JOB]: CVC_171_CATEGORY.INCOME,
3430
+ [CVC_171_INCOME_BENEFITS.PRIV_DIS]: CVC_171_CATEGORY.INCOME,
3431
+ [CVC_171_INCOME_BENEFITS.SSA]: CVC_171_CATEGORY.INCOME,
3432
+ [CVC_171_INCOME_BENEFITS.SSI]: CVC_171_CATEGORY.INCOME,
3433
+ [CVC_171_INCOME_BENEFITS.SSDI]: CVC_171_CATEGORY.INCOME,
3434
+ [CVC_171_INCOME_BENEFITS.SSA_RET]: CVC_171_CATEGORY.INCOME,
3435
+ [CVC_171_INCOME_BENEFITS.VA]: CVC_171_CATEGORY.INCOME,
3436
+ [CVC_171_INCOME_BENEFITS.VA_SCD]: CVC_171_CATEGORY.INCOME,
3437
+ [CVC_171_INCOME_BENEFITS.VA_NSC_PEN]: CVC_171_CATEGORY.INCOME,
3438
+ [CVC_171_INCOME_BENEFITS.UI]: CVC_171_CATEGORY.INCOME,
3439
+ [CVC_171_INCOME_BENEFITS.WC]: CVC_171_CATEGORY.INCOME,
3440
+ [CVC_171_INCOME_BENEFITS.TANF]: CVC_171_CATEGORY.INCOME,
3441
+ [CVC_171_INCOME_BENEFITS.GA]: CVC_171_CATEGORY.INCOME,
3442
+ [CVC_171_INCOME_BENEFITS.CSUP]: CVC_171_CATEGORY.INCOME,
3443
+ [CVC_171_INCOME_BENEFITS.ALIM]: CVC_171_CATEGORY.INCOME,
3444
+ [CVC_171_INCOME_BENEFITS.OTH_INCOME]: CVC_171_CATEGORY.INCOME,
3445
+ // Benefits (HMIS 4.03 - non-cash benefits)
3446
+ [CVC_171_INCOME_BENEFITS.SNAP]: CVC_171_CATEGORY.BENEFITS,
3447
+ [CVC_171_INCOME_BENEFITS.WIC]: CVC_171_CATEGORY.BENEFITS,
3387
3448
  [CVC_171_INCOME_BENEFITS.TANF_CC]: CVC_171_CATEGORY.BENEFITS,
3388
3449
  [CVC_171_INCOME_BENEFITS.TANF_TRANS]: CVC_171_CATEGORY.BENEFITS,
3389
3450
  [CVC_171_INCOME_BENEFITS.TANF_OTHER_SVC]: CVC_171_CATEGORY.BENEFITS,
3390
- [CVC_171_INCOME_BENEFITS.UNEMPLOYMENT]: CVC_171_CATEGORY.BENEFITS,
3391
- [CVC_171_INCOME_BENEFITS.WORKERS_COMP]: CVC_171_CATEGORY.BENEFITS,
3392
- [CVC_171_INCOME_BENEFITS.SNAP]: CVC_171_CATEGORY.BENEFITS,
3393
- [CVC_171_INCOME_BENEFITS.WIC]: CVC_171_CATEGORY.BENEFITS,
3394
- [CVC_171_INCOME_BENEFITS.HOUSING_ASSISTANCE]: CVC_171_CATEGORY.BENEFITS,
3395
- [CVC_171_INCOME_BENEFITS.MEDICAID]: CVC_171_CATEGORY.BENEFITS,
3396
- [CVC_171_INCOME_BENEFITS.MEDICARE]: CVC_171_CATEGORY.BENEFITS,
3397
- [CVC_171_INCOME_BENEFITS.OTHER_BENEFITS]: CVC_171_CATEGORY.BENEFITS,
3398
- // Missingness (categorized under Benefits for simplicity)
3399
- [CVC_171_INCOME_BENEFITS.NONE]: CVC_171_CATEGORY.BENEFITS,
3400
- [CVC_171_INCOME_BENEFITS.UNKNOWN]: CVC_171_CATEGORY.BENEFITS,
3401
- [CVC_171_INCOME_BENEFITS.DECLINED]: CVC_171_CATEGORY.BENEFITS,
3451
+ [CVC_171_INCOME_BENEFITS.HSGA]: CVC_171_CATEGORY.BENEFITS,
3452
+ [CVC_171_INCOME_BENEFITS.MCD]: CVC_171_CATEGORY.BENEFITS,
3453
+ [CVC_171_INCOME_BENEFITS.MCR]: CVC_171_CATEGORY.BENEFITS,
3454
+ [CVC_171_INCOME_BENEFITS.CCSUB]: CVC_171_CATEGORY.BENEFITS,
3455
+ [CVC_171_INCOME_BENEFITS.EDU]: CVC_171_CATEGORY.BENEFITS,
3456
+ [CVC_171_INCOME_BENEFITS.OTH_BENEFIT]: CVC_171_CATEGORY.BENEFITS,
3457
+ // Missingness (categorized under Benefits for display)
3458
+ [CVC_171_INCOME_BENEFITS.UNK]: CVC_171_CATEGORY.BENEFITS,
3459
+ [CVC_171_INCOME_BENEFITS.DNC]: CVC_171_CATEGORY.BENEFITS,
3460
+ [CVC_171_INCOME_BENEFITS.ANON]: CVC_171_CATEGORY.BENEFITS,
3402
3461
  };
3403
3462
 
3404
3463
  /** UI option type for hierarchical picker */
@@ -3412,22 +3471,23 @@ export interface CVC171Option {
3412
3471
  /**
3413
3472
  * Parent-to-children mapping for hierarchical picker.
3414
3473
  * Parents are selectable and children appear indented below.
3474
+ * Based on codebook level hierarchy (level 1 parents, level 0 children).
3415
3475
  */
3416
3476
  export const CVC_171_PARENT_CHILDREN: Record<string, string[]> = {
3477
+ // Social Security family (SSA is parent)
3417
3478
  [CVC_171_INCOME_BENEFITS.SSA]: [
3418
3479
  CVC_171_INCOME_BENEFITS.SSI,
3419
3480
  CVC_171_INCOME_BENEFITS.SSDI,
3420
3481
  CVC_171_INCOME_BENEFITS.SSA_RET,
3421
3482
  ],
3483
+ // Veterans benefits family (VA is parent)
3422
3484
  [CVC_171_INCOME_BENEFITS.VA]: [
3423
3485
  CVC_171_INCOME_BENEFITS.VA_SCD,
3424
3486
  CVC_171_INCOME_BENEFITS.VA_NSC_PEN,
3425
3487
  ],
3426
- [CVC_171_INCOME_BENEFITS.TANF]: [
3427
- CVC_171_INCOME_BENEFITS.TANF_CC,
3428
- CVC_171_INCOME_BENEFITS.TANF_TRANS,
3429
- CVC_171_INCOME_BENEFITS.TANF_OTHER_SVC,
3430
- ],
3488
+ // TANF services family (TANF cash is in Income, but services are in Benefits)
3489
+ // Note: TANF_CC, TANF_TRANS, TANF_OTHER_SVC are non-cash benefits
3490
+ // They are conceptually related to TANF but shown separately in Benefits category
3431
3491
  };
3432
3492
 
3433
3493
  /**
@@ -3440,49 +3500,52 @@ export const CVC_171_CHILD_TO_PARENT: Record<string, string> = {
3440
3500
  [CVC_171_INCOME_BENEFITS.SSA_RET]: CVC_171_INCOME_BENEFITS.SSA,
3441
3501
  [CVC_171_INCOME_BENEFITS.VA_SCD]: CVC_171_INCOME_BENEFITS.VA,
3442
3502
  [CVC_171_INCOME_BENEFITS.VA_NSC_PEN]: CVC_171_INCOME_BENEFITS.VA,
3443
- [CVC_171_INCOME_BENEFITS.TANF_CC]: CVC_171_INCOME_BENEFITS.TANF,
3444
- [CVC_171_INCOME_BENEFITS.TANF_TRANS]: CVC_171_INCOME_BENEFITS.TANF,
3445
- [CVC_171_INCOME_BENEFITS.TANF_OTHER_SVC]: CVC_171_INCOME_BENEFITS.TANF,
3446
3503
  };
3447
3504
 
3448
3505
  /**
3449
3506
  * All selectable values in display order.
3450
3507
  * Excludes missingness values which are handled separately.
3451
3508
  * Parents are listed before their children for correct rendering.
3509
+ * Order follows HMIS 4.02 (Income) then 4.03 (Benefits) structure.
3452
3510
  */
3453
3511
  const CVC_171_SELECTABLE_VALUES: CVC171Value[] = [
3454
- // Income
3455
- CVC_171_INCOME_BENEFITS.WAGES_SALARY,
3456
- CVC_171_INCOME_BENEFITS.SELF_EMPLOYMENT,
3457
- CVC_171_INCOME_BENEFITS.TIPS_COMMISSIONS,
3458
- CVC_171_INCOME_BENEFITS.PENSION,
3459
- CVC_171_INCOME_BENEFITS.CHILD_SUPPORT,
3460
- CVC_171_INCOME_BENEFITS.ALIMONY,
3461
- CVC_171_INCOME_BENEFITS.FAMILY_FRIENDS,
3462
- CVC_171_INCOME_BENEFITS.OTHER_INCOME,
3463
- // Benefits - Social Security (parent then children)
3512
+ // === INCOME (HMIS 4.02) ===
3513
+ // Earned income
3514
+ CVC_171_INCOME_BENEFITS.EMP,
3515
+ // Social Security (parent then children)
3464
3516
  CVC_171_INCOME_BENEFITS.SSA,
3465
3517
  CVC_171_INCOME_BENEFITS.SSI,
3466
3518
  CVC_171_INCOME_BENEFITS.SSDI,
3467
3519
  CVC_171_INCOME_BENEFITS.SSA_RET,
3468
- // Benefits - Veterans (parent then children)
3520
+ // Veterans (parent then children)
3469
3521
  CVC_171_INCOME_BENEFITS.VA,
3470
3522
  CVC_171_INCOME_BENEFITS.VA_SCD,
3471
3523
  CVC_171_INCOME_BENEFITS.VA_NSC_PEN,
3472
- // Benefits - TANF (parent then children)
3524
+ // Other cash income
3525
+ CVC_171_INCOME_BENEFITS.UI,
3526
+ CVC_171_INCOME_BENEFITS.WC,
3473
3527
  CVC_171_INCOME_BENEFITS.TANF,
3528
+ CVC_171_INCOME_BENEFITS.GA,
3529
+ CVC_171_INCOME_BENEFITS.PENSION_JOB,
3530
+ CVC_171_INCOME_BENEFITS.PRIV_DIS,
3531
+ CVC_171_INCOME_BENEFITS.CSUP,
3532
+ CVC_171_INCOME_BENEFITS.ALIM,
3533
+ CVC_171_INCOME_BENEFITS.OTH_INCOME,
3534
+ // === BENEFITS (HMIS 4.03 non-cash) ===
3535
+ // Food & Nutrition
3536
+ CVC_171_INCOME_BENEFITS.SNAP,
3537
+ CVC_171_INCOME_BENEFITS.WIC,
3538
+ // TANF Services
3474
3539
  CVC_171_INCOME_BENEFITS.TANF_CC,
3475
3540
  CVC_171_INCOME_BENEFITS.TANF_TRANS,
3476
3541
  CVC_171_INCOME_BENEFITS.TANF_OTHER_SVC,
3477
- // Benefits - Other
3478
- CVC_171_INCOME_BENEFITS.UNEMPLOYMENT,
3479
- CVC_171_INCOME_BENEFITS.WORKERS_COMP,
3480
- CVC_171_INCOME_BENEFITS.SNAP,
3481
- CVC_171_INCOME_BENEFITS.WIC,
3482
- CVC_171_INCOME_BENEFITS.HOUSING_ASSISTANCE,
3483
- CVC_171_INCOME_BENEFITS.MEDICAID,
3484
- CVC_171_INCOME_BENEFITS.MEDICARE,
3485
- CVC_171_INCOME_BENEFITS.OTHER_BENEFITS,
3542
+ // Other non-cash
3543
+ CVC_171_INCOME_BENEFITS.HSGA,
3544
+ CVC_171_INCOME_BENEFITS.MCD,
3545
+ CVC_171_INCOME_BENEFITS.MCR,
3546
+ CVC_171_INCOME_BENEFITS.CCSUB,
3547
+ CVC_171_INCOME_BENEFITS.EDU,
3548
+ CVC_171_INCOME_BENEFITS.OTH_BENEFIT,
3486
3549
  ];
3487
3550
 
3488
3551
  /**
@@ -3500,29 +3563,30 @@ export const CVC_171_SELECTABLE_OPTIONS: readonly CVC171Option[] =
3500
3563
  // ─── Legacy aliases for backward compatibility ──────────────────────
3501
3564
  // @deprecated Use CVC_171_INCOME_BENEFITS instead
3502
3565
  export const CVC_171_INCOME_SOURCES = {
3503
- WAGES_SALARY: CVC_171_INCOME_BENEFITS.WAGES_SALARY,
3504
- SELF_EMPLOYMENT: CVC_171_INCOME_BENEFITS.SELF_EMPLOYMENT,
3505
- TIPS_COMMISSIONS: CVC_171_INCOME_BENEFITS.TIPS_COMMISSIONS,
3566
+ // Map old descriptive names to new canonical codes
3567
+ WAGES_SALARY: CVC_171_INCOME_BENEFITS.EMP,
3568
+ SELF_EMPLOYMENT: CVC_171_INCOME_BENEFITS.EMP,
3569
+ TIPS_COMMISSIONS: CVC_171_INCOME_BENEFITS.EMP,
3506
3570
  SSI: CVC_171_INCOME_BENEFITS.SSI,
3507
3571
  SSDI: CVC_171_INCOME_BENEFITS.SSDI,
3508
3572
  SSA: CVC_171_INCOME_BENEFITS.SSA,
3509
3573
  TANF: CVC_171_INCOME_BENEFITS.TANF,
3510
- UNEMPLOYMENT: CVC_171_INCOME_BENEFITS.UNEMPLOYMENT,
3511
- VETERANS_BENEFITS: CVC_171_INCOME_BENEFITS.VA, // Mapped to new VA parent
3512
- PENSION: CVC_171_INCOME_BENEFITS.PENSION,
3513
- WORKERS_COMP: CVC_171_INCOME_BENEFITS.WORKERS_COMP,
3574
+ UNEMPLOYMENT: CVC_171_INCOME_BENEFITS.UI,
3575
+ VETERANS_BENEFITS: CVC_171_INCOME_BENEFITS.VA,
3576
+ PENSION: CVC_171_INCOME_BENEFITS.PENSION_JOB,
3577
+ WORKERS_COMP: CVC_171_INCOME_BENEFITS.WC,
3514
3578
  SNAP: CVC_171_INCOME_BENEFITS.SNAP,
3515
3579
  WIC: CVC_171_INCOME_BENEFITS.WIC,
3516
- HOUSING_ASSISTANCE: CVC_171_INCOME_BENEFITS.HOUSING_ASSISTANCE,
3517
- MEDICAID: CVC_171_INCOME_BENEFITS.MEDICAID,
3518
- MEDICARE: CVC_171_INCOME_BENEFITS.MEDICARE,
3519
- CHILD_SUPPORT: CVC_171_INCOME_BENEFITS.CHILD_SUPPORT,
3520
- ALIMONY: CVC_171_INCOME_BENEFITS.ALIMONY,
3521
- FAMILY_FRIENDS: CVC_171_INCOME_BENEFITS.FAMILY_FRIENDS,
3522
- OTHER: CVC_171_INCOME_BENEFITS.OTHER_INCOME,
3523
- NONE: CVC_171_INCOME_BENEFITS.NONE,
3524
- UNKNOWN: CVC_171_INCOME_BENEFITS.UNKNOWN,
3525
- DECLINED: CVC_171_INCOME_BENEFITS.DECLINED,
3580
+ HOUSING_ASSISTANCE: CVC_171_INCOME_BENEFITS.HSGA,
3581
+ MEDICAID: CVC_171_INCOME_BENEFITS.MCD,
3582
+ MEDICARE: CVC_171_INCOME_BENEFITS.MCR,
3583
+ CHILD_SUPPORT: CVC_171_INCOME_BENEFITS.CSUP,
3584
+ ALIMONY: CVC_171_INCOME_BENEFITS.ALIM,
3585
+ FAMILY_FRIENDS: CVC_171_INCOME_BENEFITS.OTH_INCOME, // No direct equivalent
3586
+ OTHER: CVC_171_INCOME_BENEFITS.OTH_INCOME,
3587
+ NONE: CVC_171_INCOME_BENEFITS.DNC, // Mapped to DNC
3588
+ UNKNOWN: CVC_171_INCOME_BENEFITS.UNK,
3589
+ DECLINED: CVC_171_INCOME_BENEFITS.ANON, // Closest equivalent
3526
3590
  } as const;
3527
3591
 
3528
3592
  // @deprecated Use CVC_171_SELECTABLE_VALUES
@@ -3669,7 +3733,7 @@ export const CVC_179_HIERARCHICAL_VALUES = {
3669
3733
  UNKNOWN: "unknown",
3670
3734
  CLIENT_DOESNT_KNOW: "client_doesnt_know",
3671
3735
  DATA_NOT_COLLECTED: "data_not_collected",
3672
- DOES_NOT_APPLY: "does_not_apply",
3736
+ DECLINED_TO_ANSWER: "declined_to_answer",
3673
3737
  ANONYMOUS: "anonymous",
3674
3738
  } as const;
3675
3739
 
@@ -3713,7 +3777,7 @@ export const CVC_179_HIERARCHICAL_LABELS: Record<
3713
3777
  [CVC_179_HIERARCHICAL_VALUES.UNKNOWN]: "Unknown",
3714
3778
  [CVC_179_HIERARCHICAL_VALUES.CLIENT_DOESNT_KNOW]: "Client doesn't know",
3715
3779
  [CVC_179_HIERARCHICAL_VALUES.DATA_NOT_COLLECTED]: "Data not collected",
3716
- [CVC_179_HIERARCHICAL_VALUES.DOES_NOT_APPLY]: "Does not apply",
3780
+ [CVC_179_HIERARCHICAL_VALUES.DECLINED_TO_ANSWER]: "Declined to answer",
3717
3781
  [CVC_179_HIERARCHICAL_VALUES.ANONYMOUS]: "Anonymous",
3718
3782
  };
3719
3783
 
@@ -3773,7 +3837,7 @@ export const CVC_179_VALUE_TO_CATEGORY: Record<
3773
3837
  CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS,
3774
3838
  [CVC_179_HIERARCHICAL_VALUES.DATA_NOT_COLLECTED]:
3775
3839
  CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS,
3776
- [CVC_179_HIERARCHICAL_VALUES.DOES_NOT_APPLY]:
3840
+ [CVC_179_HIERARCHICAL_VALUES.DECLINED_TO_ANSWER]:
3777
3841
  CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS,
3778
3842
  [CVC_179_HIERARCHICAL_VALUES.ANONYMOUS]:
3779
3843
  CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS,
@@ -4099,9 +4163,9 @@ export const CVC_179_SELECTABLE_OPTIONS: Array<{
4099
4163
  ],
4100
4164
  },
4101
4165
  {
4102
- value: CVC_179_HIERARCHICAL_VALUES.DOES_NOT_APPLY,
4166
+ value: CVC_179_HIERARCHICAL_VALUES.DECLINED_TO_ANSWER,
4103
4167
  label:
4104
- CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.DOES_NOT_APPLY],
4168
+ CVC_179_HIERARCHICAL_LABELS[CVC_179_HIERARCHICAL_VALUES.DECLINED_TO_ANSWER],
4105
4169
  category: CVC_179_HIERARCHICAL_CATEGORY.MISSINGNESS,
4106
4170
  categoryLabel:
4107
4171
  CVC_179_HIERARCHICAL_CATEGORY_LABELS[
@@ -5171,3 +5235,40 @@ export const CVC_136_OPTIONS: readonly CVC136Option[] = Object.entries(
5171
5235
  category,
5172
5236
  categoryLabel: CVC_136_CATEGORY_LABELS[category],
5173
5237
  }));
5238
+
5239
+ // ─── CVC-67: HMIS Sex ────────────────────────────────────────────────────────
5240
+ // Biological sex for HMIS (Homeless Management Information System) reporting.
5241
+ // HUD 4.21 mapping - single select. Effective Oct 1, 2025.
5242
+ // This is SEPARATE from gender identity (CVC-17) and cannot be inferred from gender.
5243
+ // Reference: https://www.notion.so/htilabs/CVC-67-HMIS-Sex
5244
+
5245
+ export const CVC_67_HMIS_SEX = {
5246
+ MALE: "male",
5247
+ FEMALE: "female",
5248
+ CLIENT_PREFERS_NOT_TO_ANSWER: "client_prefers_not_to_answer",
5249
+ CLIENT_DOESNT_KNOW: "client_doesn_t_know",
5250
+ DATA_NOT_COLLECTED: "data_not_collected",
5251
+ } as const;
5252
+
5253
+ export type CVC67Value = (typeof CVC_67_HMIS_SEX)[keyof typeof CVC_67_HMIS_SEX];
5254
+
5255
+ export const CVC_67_LABELS: Record<CVC67Value, string> = {
5256
+ [CVC_67_HMIS_SEX.MALE]: "Male",
5257
+ [CVC_67_HMIS_SEX.FEMALE]: "Female",
5258
+ [CVC_67_HMIS_SEX.CLIENT_PREFERS_NOT_TO_ANSWER]: "Client prefers not to answer",
5259
+ [CVC_67_HMIS_SEX.CLIENT_DOESNT_KNOW]: "Client doesn't know",
5260
+ [CVC_67_HMIS_SEX.DATA_NOT_COLLECTED]: "Data not collected",
5261
+ };
5262
+
5263
+ // Selectable values for UI dropdowns (excludes data_not_collected as it's a missingness code)
5264
+ export const CVC_67_SELECTABLE_VALUES: CVC67Value[] = [
5265
+ CVC_67_HMIS_SEX.MALE,
5266
+ CVC_67_HMIS_SEX.FEMALE,
5267
+ CVC_67_HMIS_SEX.CLIENT_PREFERS_NOT_TO_ANSWER,
5268
+ CVC_67_HMIS_SEX.CLIENT_DOESNT_KNOW,
5269
+ ];
5270
+
5271
+ // Missingness values (for reporting/validation)
5272
+ export const CVC_67_MISSINGNESS_VALUES: CVC67Value[] = [
5273
+ CVC_67_HMIS_SEX.DATA_NOT_COLLECTED,
5274
+ ];
@@ -11,3 +11,4 @@
11
11
 
12
12
  export * from "./ic.js";
13
13
  export * from "./service-catalog.js";
14
+ export * from "./platform-auth.js";