@htilabs/platform-common-models 0.7.0-beta.1 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/README.md +0 -44
  2. package/dist/constants/index.cjs +5 -46
  3. package/dist/constants/index.cjs.map +1 -1
  4. package/dist/constants/index.d.cts +1 -1
  5. package/dist/constants/index.d.ts +1 -1
  6. package/dist/constants/index.js +5 -42
  7. package/dist/constants/index.js.map +1 -1
  8. package/dist/{cvcEntry-BCj1OWqL.d.cts → cvcEntry-DaDrEuTa.d.cts} +36 -36
  9. package/dist/{cvcEntry-BCj1OWqL.d.ts → cvcEntry-DaDrEuTa.d.ts} +36 -36
  10. package/dist/cvcs/index.cjs +1085 -126
  11. package/dist/cvcs/index.cjs.map +1 -1
  12. package/dist/cvcs/index.d.cts +1652 -595
  13. package/dist/cvcs/index.d.ts +1652 -595
  14. package/dist/cvcs/index.js +1074 -123
  15. package/dist/cvcs/index.js.map +1 -1
  16. package/dist/{index-I-DiX9eQ.d.ts → index-C0J3f169.d.ts} +1 -1
  17. package/dist/{index-CoVr1jIV.d.cts → index-EPjPjR0z.d.cts} +1 -1
  18. package/dist/index.cjs +1253 -228
  19. package/dist/index.cjs.map +1 -1
  20. package/dist/index.d.cts +193 -77
  21. package/dist/index.d.ts +193 -77
  22. package/dist/index.js +1231 -216
  23. package/dist/index.js.map +1 -1
  24. package/dist/models/index.d.cts +2 -2
  25. package/dist/models/index.d.ts +2 -2
  26. package/dist/{platform-auth-C97LpsRd.d.cts → platform-auth-CjC57132.d.cts} +4 -8
  27. package/dist/{platform-auth-C97LpsRd.d.ts → platform-auth-CjC57132.d.ts} +4 -8
  28. package/dist/schemas/index.cjs +6 -43
  29. package/dist/schemas/index.cjs.map +1 -1
  30. package/dist/schemas/index.d.cts +11 -15
  31. package/dist/schemas/index.d.ts +11 -15
  32. package/dist/schemas/index.js +6 -43
  33. package/dist/schemas/index.js.map +1 -1
  34. package/dist/types/index.d.cts +2 -2
  35. package/dist/types/index.d.ts +2 -2
  36. package/package.json +18 -24
  37. package/src/__tests__/__snapshots__/cvc-sot.snap +39 -7
  38. package/src/__tests__/cvc-sot-snapshot.test.ts +80 -16
  39. package/src/__tests__/cvc-structural.test.ts +11 -3
  40. package/src/constants/ic.ts +6 -49
  41. package/src/cvcs/contactInfoUseType.v1.0.0.json +87 -0
  42. package/src/cvcs/determinationLevel.v1.0.0.json +96 -0
  43. package/src/cvcs/index.ts +22 -6
  44. package/src/cvcs/inferenceType.v1.0.0.json +78 -0
  45. package/src/cvcs/qualityFlags.v1.0.0.json +96 -0
  46. package/src/cvcs/roleContext.v1.0.0.json +78 -0
  47. package/src/cvcs/sessionState.v1.0.0.json +96 -0
  48. package/src/cvcs/sourceCategory.v1.1.0.json +96 -0
  49. package/src/cvcs/sourceSubtype.v1.1.0.json +330 -0
  50. package/src/cvcs/supportStrength.v1.0.0.json +114 -0
  51. package/src/cvcs/timeScope.v1.0.0.json +69 -0
  52. package/src/cvcs/verificationMethod.v1.0.0.json +96 -0
  53. package/src/generated/cvc-enums.ts +211 -41
  54. package/src/index.ts +0 -20
  55. package/src/schemas/common.ts +0 -4
  56. package/dist/config/index.cjs +0 -191
  57. package/dist/config/index.cjs.map +0 -1
  58. package/dist/config/index.d.cts +0 -101
  59. package/dist/config/index.d.ts +0 -101
  60. package/dist/config/index.js +0 -165
  61. package/dist/config/index.js.map +0 -1
  62. package/src/__tests__/runtime-contract-validator.test.ts +0 -556
  63. package/src/config/fixtures/valid.yaml +0 -90
  64. package/src/config/index.ts +0 -352
  65. package/src/cvcs/hmisSex.v1.0.0.json +0 -89
  66. package/src/cvcs/juvenileJusticeEpisodeType.v1.0.0.json +0 -96
  67. package/src/cvcs/recencyBand.v1.0.0.json +0 -124
package/README.md CHANGED
@@ -16,50 +16,6 @@ Package exports are organized into a public root API and a small number of
16
16
  dedicated subpaths (`/validation`, `/cvcs`) — consult `package.json` for the
17
17
  authoritative `exports` map.
18
18
 
19
- ## Seeding CVCs
20
-
21
- The CVC Source-of-Truth catalogs under `src/cvcs/` are seeded into MongoDB with:
22
-
23
- ```bash
24
- # one domain
25
- MONGO_URI="<cluster>/platform-test" pnpm seed:cvc -- --domain service_categories --version 1.0.0
26
-
27
- # every domain + the default platform registry
28
- MONGO_URI="<cluster>/platform-test" pnpm seed:cvc:all
29
- ```
30
-
31
- The connection URI comes from `MONGO_URI` (or `--mongo-uri`); the target database
32
- is whatever the URI's path says. Pass `--dry-run` to validate and report counts
33
- without writing anything.
34
-
35
- ### Production-DB seed guard
36
-
37
- Both seeders run a DB-name safety guard after the target URI is resolved and
38
- before any write connection, so a production database cannot be seeded silently.
39
- The target database name is parsed from the Mongo URI (`mongodb://` and
40
- `mongodb+srv://`, the path segment after the host, before any `?`).
41
-
42
- - **Test databases** — a database whose name ends in `-test` (e.g.
43
- `platform-test`) seeds with **no prompt**. Agents and CI can run it freely:
44
-
45
- ```bash
46
- MONGO_URI="<cluster>/platform-test" pnpm seed:cvc:all
47
- ```
48
-
49
- - **Any other (prod-shaped) database** — e.g. `platform`, `platform-db`, or a URI
50
- with no database name — requires an **interactive human confirmation**: you
51
- must type the exact target database name at the terminal (read from
52
- `/dev/tty`). There is **no** flag or environment variable to skip this — no
53
- `--yes`, no `--force`, no `FORCE=1`.
54
-
55
- If stdin is not a TTY (agent, CI, pipe, `nohup`, background) the seeder
56
- **aborts** with a non-zero exit (`refusing to seed non-test DB '<name>'
57
- without interactive confirmation`). This non-TTY abort is what makes the guard
58
- un-bypassable by non-interactive callers.
59
-
60
- - **`--dry-run`** never prompts or aborts for any database (it writes nothing),
61
- but its output states whether a real run *would* proceed, prompt, or abort.
62
-
63
19
  ## Service Catalog: Deprecation Notice
64
20
 
65
21
  The hardcoded `IC_48_*` constants and helpers in
@@ -140,10 +140,7 @@ __export(constants_exports, {
140
140
  CVC_17_LABELS: () => CVC_17_LABELS,
141
141
  CVC_17_LEVEL_1_OPTIONS: () => CVC_17_LEVEL_1_OPTIONS,
142
142
  CVC_17_LEVEL_2_TRANSGENDER_OPTIONS: () => CVC_17_LEVEL_2_TRANSGENDER_OPTIONS,
143
- CVC_17_MISSINGNESS_VALUES: () => CVC_17_MISSINGNESS_VALUES,
144
- CVC_17_SELECTABLE_VALUES: () => CVC_17_SELECTABLE_VALUES,
145
143
  CVC_17_TRANSGENDER_VALUES: () => CVC_17_TRANSGENDER_VALUES,
146
- CVC_17_VALUES: () => CVC_17_VALUES,
147
144
  CVC_180_EDUCATION_LEVEL: () => CVC_180_EDUCATION_LEVEL,
148
145
  CVC_180_LABELS: () => CVC_180_LABELS,
149
146
  CVC_180_ORDINAL: () => CVC_180_ORDINAL,
@@ -162,7 +159,6 @@ __export(constants_exports, {
162
159
  CVC_67_LABELS: () => CVC_67_LABELS,
163
160
  CVC_67_MISSINGNESS_VALUES: () => CVC_67_MISSINGNESS_VALUES,
164
161
  CVC_67_SELECTABLE_VALUES: () => CVC_67_SELECTABLE_VALUES,
165
- CVC_67_VALUES: () => CVC_67_VALUES,
166
162
  CVC_72_HT_TYPE: () => CVC_72_HT_TYPE,
167
163
  CVC_72_LABELS: () => CVC_72_LABELS,
168
164
  CVC_72_VALUES: () => CVC_72_VALUES,
@@ -352,6 +348,8 @@ var CVC_1_NAME_TYPE = {
352
348
  ALIAS: "alias",
353
349
  /** Trade name / business name - single unstructured name field */
354
350
  TRADE_NAME: "trade_name",
351
+ /** Single-word name (e.g., "Madonna", "Prince") - single unstructured name field */
352
+ MONONYM: "mononym",
355
353
  /** Nickname - single unstructured name field */
356
354
  NICKNAME: "nickname",
357
355
  /** Online handle or username - single unstructured name field */
@@ -363,6 +361,7 @@ var CVC_1_VALUES = [
363
361
  CVC_1_NAME_TYPE.LEGAL,
364
362
  CVC_1_NAME_TYPE.ALIAS,
365
363
  CVC_1_NAME_TYPE.TRADE_NAME,
364
+ CVC_1_NAME_TYPE.MONONYM,
366
365
  CVC_1_NAME_TYPE.NICKNAME,
367
366
  CVC_1_NAME_TYPE.HANDLE,
368
367
  CVC_1_NAME_TYPE.UNKNOWN
@@ -371,6 +370,7 @@ var CVC_1_LABELS = {
371
370
  [CVC_1_NAME_TYPE.LEGAL]: "Legal Name",
372
371
  [CVC_1_NAME_TYPE.ALIAS]: "Alias / AKA",
373
372
  [CVC_1_NAME_TYPE.TRADE_NAME]: "Trade Name",
373
+ [CVC_1_NAME_TYPE.MONONYM]: "Mononym",
374
374
  [CVC_1_NAME_TYPE.NICKNAME]: "Nickname",
375
375
  [CVC_1_NAME_TYPE.HANDLE]: "Handle / Username",
376
376
  [CVC_1_NAME_TYPE.UNKNOWN]: "Unknown"
@@ -381,6 +381,7 @@ var CVC_1_STRUCTURED_NAME_TYPES = [
381
381
  var CVC_1_UNSTRUCTURED_NAME_TYPES = [
382
382
  CVC_1_NAME_TYPE.ALIAS,
383
383
  CVC_1_NAME_TYPE.TRADE_NAME,
384
+ CVC_1_NAME_TYPE.MONONYM,
384
385
  CVC_1_NAME_TYPE.NICKNAME,
385
386
  CVC_1_NAME_TYPE.HANDLE,
386
387
  CVC_1_NAME_TYPE.UNKNOWN
@@ -1326,10 +1327,7 @@ var CVC_17_CORE_GENDER_IDENTITY = {
1326
1327
  TRANSGENDER: "TRANSGENDER",
1327
1328
  NON_BINARY: "NON_BINARY",
1328
1329
  OTHER: "OTHER",
1329
- // Level 0 - Missingness codes (codebook canonical set)
1330
1330
  UNKNOWN: "UNK",
1331
- DATA_NOT_COLLECTED: "DNC",
1332
- PREFER_NOT_TO_ANSWER: "PNA",
1333
1331
  // Level 2 - Transgender subcategories
1334
1332
  TRANSGENDER_FTM: "TRANSGENDER_FTM",
1335
1333
  TRANSGENDER_MTF: "TRANSGENDER_MTF"
@@ -1341,8 +1339,6 @@ var CVC_17_LABELS = {
1341
1339
  [CVC_17_CORE_GENDER_IDENTITY.NON_BINARY]: "Non-Binary",
1342
1340
  [CVC_17_CORE_GENDER_IDENTITY.OTHER]: "Other",
1343
1341
  [CVC_17_CORE_GENDER_IDENTITY.UNKNOWN]: "Unknown",
1344
- [CVC_17_CORE_GENDER_IDENTITY.DATA_NOT_COLLECTED]: "Data not collected",
1345
- [CVC_17_CORE_GENDER_IDENTITY.PREFER_NOT_TO_ANSWER]: "Client prefers not to answer",
1346
1342
  [CVC_17_CORE_GENDER_IDENTITY.TRANSGENDER_FTM]: "Transgender - FTM",
1347
1343
  [CVC_17_CORE_GENDER_IDENTITY.TRANSGENDER_MTF]: "Transgender - MTF"
1348
1344
  };
@@ -1367,32 +1363,6 @@ function isTransgenderGenderIdentity(value) {
1367
1363
  if (!value) return false;
1368
1364
  return CVC_17_TRANSGENDER_VALUES.includes(value);
1369
1365
  }
1370
- var CVC_17_SELECTABLE_VALUES = [
1371
- CVC_17_CORE_GENDER_IDENTITY.MALE,
1372
- CVC_17_CORE_GENDER_IDENTITY.FEMALE,
1373
- CVC_17_CORE_GENDER_IDENTITY.TRANSGENDER,
1374
- CVC_17_CORE_GENDER_IDENTITY.TRANSGENDER_FTM,
1375
- CVC_17_CORE_GENDER_IDENTITY.TRANSGENDER_MTF,
1376
- CVC_17_CORE_GENDER_IDENTITY.NON_BINARY,
1377
- CVC_17_CORE_GENDER_IDENTITY.OTHER
1378
- ];
1379
- var CVC_17_MISSINGNESS_VALUES = [
1380
- CVC_17_CORE_GENDER_IDENTITY.UNKNOWN,
1381
- CVC_17_CORE_GENDER_IDENTITY.DATA_NOT_COLLECTED,
1382
- CVC_17_CORE_GENDER_IDENTITY.PREFER_NOT_TO_ANSWER
1383
- ];
1384
- var CVC_17_VALUES = [
1385
- CVC_17_CORE_GENDER_IDENTITY.MALE,
1386
- CVC_17_CORE_GENDER_IDENTITY.FEMALE,
1387
- CVC_17_CORE_GENDER_IDENTITY.TRANSGENDER,
1388
- CVC_17_CORE_GENDER_IDENTITY.NON_BINARY,
1389
- CVC_17_CORE_GENDER_IDENTITY.OTHER,
1390
- CVC_17_CORE_GENDER_IDENTITY.UNKNOWN,
1391
- CVC_17_CORE_GENDER_IDENTITY.DATA_NOT_COLLECTED,
1392
- CVC_17_CORE_GENDER_IDENTITY.PREFER_NOT_TO_ANSWER,
1393
- CVC_17_CORE_GENDER_IDENTITY.TRANSGENDER_FTM,
1394
- CVC_17_CORE_GENDER_IDENTITY.TRANSGENDER_MTF
1395
- ];
1396
1366
  var IC_24_RACE = {
1397
1367
  AMERICAN_INDIAN_ALASKA_NATIVE: 1,
1398
1368
  ASIAN: 2,
@@ -4318,13 +4288,6 @@ var CVC_67_SELECTABLE_VALUES = [
4318
4288
  var CVC_67_MISSINGNESS_VALUES = [
4319
4289
  CVC_67_HMIS_SEX.DATA_NOT_COLLECTED
4320
4290
  ];
4321
- var CVC_67_VALUES = [
4322
- CVC_67_HMIS_SEX.MALE,
4323
- CVC_67_HMIS_SEX.FEMALE,
4324
- CVC_67_HMIS_SEX.CLIENT_PREFERS_NOT_TO_ANSWER,
4325
- CVC_67_HMIS_SEX.CLIENT_DOESNT_KNOW,
4326
- CVC_67_HMIS_SEX.DATA_NOT_COLLECTED
4327
- ];
4328
4291
 
4329
4292
  // src/constants/service-catalog.json
4330
4293
  var service_catalog_default = {
@@ -6029,10 +5992,7 @@ var FUNCTION_STATUS_LABELS = {
6029
5992
  CVC_17_LABELS,
6030
5993
  CVC_17_LEVEL_1_OPTIONS,
6031
5994
  CVC_17_LEVEL_2_TRANSGENDER_OPTIONS,
6032
- CVC_17_MISSINGNESS_VALUES,
6033
- CVC_17_SELECTABLE_VALUES,
6034
5995
  CVC_17_TRANSGENDER_VALUES,
6035
- CVC_17_VALUES,
6036
5996
  CVC_180_EDUCATION_LEVEL,
6037
5997
  CVC_180_LABELS,
6038
5998
  CVC_180_ORDINAL,
@@ -6051,7 +6011,6 @@ var FUNCTION_STATUS_LABELS = {
6051
6011
  CVC_67_LABELS,
6052
6012
  CVC_67_MISSINGNESS_VALUES,
6053
6013
  CVC_67_SELECTABLE_VALUES,
6054
- CVC_67_VALUES,
6055
6014
  CVC_72_HT_TYPE,
6056
6015
  CVC_72_LABELS,
6057
6016
  CVC_72_VALUES,