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

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 (50) hide show
  1. package/README.md +44 -0
  2. package/dist/config/index.cjs +191 -0
  3. package/dist/config/index.cjs.map +1 -0
  4. package/dist/config/index.d.cts +101 -0
  5. package/dist/config/index.d.ts +101 -0
  6. package/dist/config/index.js +165 -0
  7. package/dist/config/index.js.map +1 -0
  8. package/dist/constants/index.cjs +46 -5
  9. package/dist/constants/index.cjs.map +1 -1
  10. package/dist/constants/index.d.cts +1 -1
  11. package/dist/constants/index.d.ts +1 -1
  12. package/dist/constants/index.js +42 -5
  13. package/dist/constants/index.js.map +1 -1
  14. package/dist/cvcs/index.cjs +321 -0
  15. package/dist/cvcs/index.cjs.map +1 -1
  16. package/dist/cvcs/index.d.cts +789 -436
  17. package/dist/cvcs/index.d.ts +789 -436
  18. package/dist/cvcs/index.js +318 -0
  19. package/dist/cvcs/index.js.map +1 -1
  20. package/dist/index.cjs +424 -6
  21. package/dist/index.cjs.map +1 -1
  22. package/dist/index.d.cts +94 -3
  23. package/dist/index.d.ts +94 -3
  24. package/dist/index.js +412 -6
  25. package/dist/index.js.map +1 -1
  26. package/dist/{platform-auth-CjC57132.d.cts → platform-auth-C97LpsRd.d.cts} +8 -4
  27. package/dist/{platform-auth-CjC57132.d.ts → platform-auth-C97LpsRd.d.ts} +8 -4
  28. package/dist/schemas/index.cjs +43 -6
  29. package/dist/schemas/index.cjs.map +1 -1
  30. package/dist/schemas/index.d.cts +4 -0
  31. package/dist/schemas/index.d.ts +4 -0
  32. package/dist/schemas/index.js +43 -6
  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 +9 -2
  37. package/src/__tests__/__snapshots__/cvc-sot.snap +12 -0
  38. package/src/__tests__/cvc-sot-snapshot.test.ts +24 -0
  39. package/src/__tests__/cvc-structural.test.ts +3 -0
  40. package/src/__tests__/runtime-contract-validator.test.ts +556 -0
  41. package/src/config/fixtures/valid.yaml +90 -0
  42. package/src/config/index.ts +352 -0
  43. package/src/constants/ic.ts +49 -6
  44. package/src/cvcs/hmisSex.v1.0.0.json +89 -0
  45. package/src/cvcs/index.ts +6 -0
  46. package/src/cvcs/juvenileJusticeEpisodeType.v1.0.0.json +96 -0
  47. package/src/cvcs/recencyBand.v1.0.0.json +124 -0
  48. package/src/generated/cvc-enums.ts +59 -0
  49. package/src/index.ts +20 -0
  50. package/src/schemas/common.ts +4 -0
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/config/index.ts"],"sourcesContent":["/**\n * @htilabs/platform-common-models — Runtime Config Contract Validator\n *\n * Implements contract R12.1 (platform-common home):\n * - validateAgainstContract(runtimeYamlPath, opts?) — startup validator (R3.2)\n * - createConfigEndpoint(runtimeYamlPath, opts?) — /api/config factory (R7)\n *\n * Consumers MUST call validateAgainstContract once at process startup, before\n * any other initialization that reads env vars. Build-phase variables\n * (phase: build) are NOT checked at runtime per R3.4.\n *\n * No secret VALUES are read, stored, or returned here. Secret env vars are\n * validated for presence but their values are never logged or exposed.\n *\n * Dual ESM + CJS via tsup. Plain JS consumers (pave, leads) use require():\n * const { validateAgainstContract } = require('@htilabs/platform-common-models/config');\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { parse } from \"yaml\";\n\n// ─── Schema types (mirrors thread's runtime-config-lib.ts VariableSpec) ──────\n\nexport interface VariableSpec {\n type: \"string\" | \"boolean\" | \"number\" | \"enum\" | \"url\" | \"json\";\n required: boolean;\n secret: boolean;\n description: string;\n phase?: \"runtime\" | \"build\";\n values?: string[];\n default?: Record<string, unknown>;\n provider?: string;\n name?: string;\n client_visible?: boolean;\n deprecated?: { since: string; remove_after?: string; replacement?: string };\n}\n\nexport interface ServiceContract {\n service: string;\n version: number;\n environments: string[];\n // Thread extensions (tolerated, not required — R1.1 note)\n port?: number;\n build_secrets?: string[];\n variables: Record<string, VariableSpec>;\n}\n\n/** Typed config accessor returned by validateAgainstContract. */\nexport type TypedConfig = Record<string, string | boolean | number | unknown>;\n\nexport interface ValidateOptions {\n /**\n * Environment name used to select per-env defaults (e.g. \"local\", \"test\").\n * Defaults to process.env.NODE_ENV, then \"local\".\n */\n env?: string;\n /**\n * If true, do not call process.exit(1) on failure; throw instead.\n * Useful for tests. Defaults to false (production mode exits).\n */\n throwOnFailure?: boolean;\n}\n\nexport interface EndpointOptions {\n /** Cache-Control header value. Defaults to \"private, no-store\". */\n cacheControl?: string;\n}\n\n/**\n * A framework-agnostic route handler that returns a JSON response.\n * Compatible with:\n * - Next.js App Router: export const GET = createConfigEndpoint(...)\n * - Fastify: instance.get('/api/config', createConfigEndpoint(...))\n * - Express: app.get('/api/config', createConfigEndpoint(...))\n */\nexport type RouteHandler = (\n req?: unknown,\n res?: unknown,\n) => Promise<Response | void> | Response | void;\n\n// ─── YAML parser ──────────────────────────────────────────────────────────────\n\nfunction loadContract(runtimeYamlPath: string): ServiceContract {\n let raw: string;\n try {\n raw = readFileSync(runtimeYamlPath, \"utf8\");\n } catch (err) {\n const msg =\n err instanceof Error ? err.message : String(err);\n throw new Error(\n `[platform-common/config] Cannot read ${runtimeYamlPath}: ${msg}`,\n );\n }\n const parsed = parse(raw) as ServiceContract | null;\n if (!parsed || typeof parsed !== \"object\") {\n throw new Error(\n `[platform-common/config] ${runtimeYamlPath}: not a YAML mapping`,\n );\n }\n if (parsed.version !== 1) {\n throw new Error(\n `[platform-common/config] ${runtimeYamlPath}: unsupported contract version ${parsed.version} (expected 1)`,\n );\n }\n if (!parsed.variables || typeof parsed.variables !== \"object\") {\n throw new Error(\n `[platform-common/config] ${runtimeYamlPath}: missing \"variables\" map`,\n );\n }\n return parsed;\n}\n\n// ─── Coercion ────────────────────────────────────────────────────────────────\n\n/**\n * Coerce a raw environment string value to the declared type.\n * Returns [ok, coerced] or [false, errorMessage].\n */\nfunction coerce(\n key: string,\n raw: string,\n spec: VariableSpec,\n): [true, unknown] | [false, string] {\n switch (spec.type) {\n case \"boolean\": {\n if (raw === \"true\" || raw === \"1\") return [true, true];\n if (raw === \"false\" || raw === \"0\") return [true, false];\n return [false, `${key}: expected boolean (\"true\"/\"false\"/\"1\"/\"0\"), got \"${raw}\"`];\n }\n case \"number\": {\n const n = Number(raw);\n if (!Number.isFinite(n)) {\n return [false, `${key}: expected number, got \"${raw}\"`];\n }\n return [true, n];\n }\n case \"enum\": {\n const vals = spec.values ?? [];\n if (!vals.includes(raw)) {\n return [false, `${key}: expected one of [${vals.join(\", \")}], got \"${raw}\"`];\n }\n return [true, raw];\n }\n case \"url\": {\n try {\n new URL(raw);\n return [true, raw];\n } catch {\n return [false, `${key}: expected a valid URL, got \"${raw}\"`];\n }\n }\n case \"json\": {\n try {\n const parsed = JSON.parse(raw) as unknown;\n return [true, parsed];\n } catch {\n return [false, `${key}: expected valid JSON, got \"${raw}\"`];\n }\n }\n default:\n // string\n return [true, raw];\n }\n}\n\n// ─── Default application ─────────────────────────────────────────────────────\n\n/**\n * Returns the default value for a variable in the given environment,\n * or undefined if no default applies.\n *\n * Exact env match only — defaults are per-environment and MUST NOT bleed\n * across envs. (A local default stays local; it does not fall back into prod.)\n */\nfunction resolveDefault(\n spec: VariableSpec,\n env: string,\n): string | undefined {\n if (!spec.default) return undefined;\n const v = spec.default[env];\n if (v === undefined) return undefined;\n return String(v);\n}\n\n// ─── validateAgainstContract ─────────────────────────────────────────────────\n\n/**\n * Parse `runtimeYamlPath`, coerce every runtime-phase variable from\n * `process.env` (with per-env defaults applied), and fail fast on any\n * missing or invalid required variable (R3.2).\n *\n * Build-phase variables (phase: build) are skipped per R3.4.\n *\n * Returns a typed config object keyed by variable name.\n */\nexport function validateAgainstContract(\n runtimeYamlPath: string,\n opts: ValidateOptions = {},\n): TypedConfig {\n const contract = loadContract(runtimeYamlPath);\n const env =\n opts.env ??\n (process.env.NODE_ENV as string | undefined) ??\n \"local\";\n\n const errors: string[] = [];\n const result: TypedConfig = {};\n\n for (const [key, spec] of Object.entries(contract.variables)) {\n // R3.4: skip build-phase variables entirely at runtime.\n if (spec.phase === \"build\") continue;\n\n const rawFromEnv = process.env[key];\n const defaultValue = resolveDefault(spec, env);\n const effective = rawFromEnv ?? defaultValue;\n\n if (effective === undefined || effective === \"\") {\n if (spec.required) {\n errors.push(\n `${key}: required but not set (no value in process.env and no default for env \"${env}\")`,\n );\n }\n // Not required and not set — omit from result.\n continue;\n }\n\n const [ok, coerced] = coerce(key, effective, spec);\n if (!ok) {\n errors.push(coerced as string);\n continue;\n }\n result[key] = coerced;\n }\n\n if (errors.length > 0) {\n const message = [\n `[platform-common/config] validateAgainstContract failed for ${runtimeYamlPath}`,\n `${errors.length} variable(s) missing or invalid:`,\n ...errors.map((e) => ` - ${e}`),\n ].join(\"\\n\");\n\n if (opts.throwOnFailure) {\n throw new Error(message);\n }\n console.error(message);\n process.exit(1);\n }\n\n return result;\n}\n\n// ─── createConfigEndpoint ────────────────────────────────────────────────────\n\n/**\n * Build a static JSON payload containing only variables that are\n * client_visible: true AND secret: false (R7.2, R7.3). Reads process.env\n * once at factory call time.\n */\nfunction buildClientPayload(\n contract: ServiceContract,\n env: string,\n): Record<string, unknown> {\n const payload: Record<string, unknown> = {};\n\n for (const [key, spec] of Object.entries(contract.variables)) {\n // R7.3: never expose secrets.\n if (spec.secret) continue;\n // R7.2: only expose client_visible vars.\n if (!spec.client_visible) continue;\n // R3.4: build-phase vars are not available at runtime.\n if (spec.phase === \"build\") continue;\n\n const raw = process.env[key] ?? resolveDefault(spec, env);\n if (raw === undefined) continue;\n\n const [ok, coerced] = coerce(key, raw, spec);\n payload[key] = ok ? coerced : raw;\n }\n\n return payload;\n}\n\n/**\n * Route-handler factory for GET /api/config (R7.1).\n *\n * Reads the contract and process.env once at factory-call time and caches\n * the JSON payload. The returned handler is compatible with:\n *\n * Next.js App Router:\n * export const GET = createConfigEndpoint(path);\n *\n * Fastify:\n * instance.get('/api/config', createConfigEndpoint(path));\n *\n * Express:\n * app.get('/api/config', createConfigEndpoint(path));\n *\n * The handler detects the calling convention at runtime:\n * - Next.js / fetch-native: called with no arguments; returns a Response.\n * - Express: called with (req, res); calls res.json() and returns void.\n * - Fastify: called with (req, reply); calls reply.send() and returns void.\n */\nexport function createConfigEndpoint(\n runtimeYamlPath: string,\n opts: EndpointOptions = {},\n): RouteHandler {\n const contract = loadContract(runtimeYamlPath);\n const env =\n (process.env.NODE_ENV as string | undefined) ?? \"local\";\n const payload = buildClientPayload(contract, env);\n const cacheControl = opts.cacheControl ?? \"private, no-store\";\n const body = JSON.stringify(payload);\n\n return function configHandler(\n _req?: unknown,\n res?: unknown,\n ): Promise<Response | void> | Response | void {\n // Express-shaped: res has .json()\n if (res && typeof (res as Record<string, unknown>)[\"json\"] === \"function\") {\n const r = res as {\n setHeader: (k: string, v: string) => void;\n json: (data: unknown) => void;\n };\n r.setHeader(\"Cache-Control\", cacheControl);\n r.setHeader(\"Content-Type\", \"application/json\");\n r.json(payload);\n return;\n }\n\n // Fastify-shaped: res has .send()\n if (res && typeof (res as Record<string, unknown>)[\"send\"] === \"function\") {\n const r = res as {\n header: (k: string, v: string) => void;\n type: (ct: string) => void;\n send: (data: string) => void;\n };\n r.header(\"Cache-Control\", cacheControl);\n r.type(\"application/json\");\n r.send(body);\n return;\n }\n\n // Next.js / fetch-native (no res argument, or unrecognised res)\n return new Response(body, {\n status: 200,\n headers: {\n \"Content-Type\": \"application/json\",\n \"Cache-Control\": cacheControl,\n },\n });\n };\n}\n"],"mappings":"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","names":[]}
@@ -140,7 +140,10 @@ __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,
143
145
  CVC_17_TRANSGENDER_VALUES: () => CVC_17_TRANSGENDER_VALUES,
146
+ CVC_17_VALUES: () => CVC_17_VALUES,
144
147
  CVC_180_EDUCATION_LEVEL: () => CVC_180_EDUCATION_LEVEL,
145
148
  CVC_180_LABELS: () => CVC_180_LABELS,
146
149
  CVC_180_ORDINAL: () => CVC_180_ORDINAL,
@@ -159,6 +162,7 @@ __export(constants_exports, {
159
162
  CVC_67_LABELS: () => CVC_67_LABELS,
160
163
  CVC_67_MISSINGNESS_VALUES: () => CVC_67_MISSINGNESS_VALUES,
161
164
  CVC_67_SELECTABLE_VALUES: () => CVC_67_SELECTABLE_VALUES,
165
+ CVC_67_VALUES: () => CVC_67_VALUES,
162
166
  CVC_72_HT_TYPE: () => CVC_72_HT_TYPE,
163
167
  CVC_72_LABELS: () => CVC_72_LABELS,
164
168
  CVC_72_VALUES: () => CVC_72_VALUES,
@@ -348,8 +352,6 @@ var CVC_1_NAME_TYPE = {
348
352
  ALIAS: "alias",
349
353
  /** Trade name / business name - single unstructured name field */
350
354
  TRADE_NAME: "trade_name",
351
- /** Single-word name (e.g., "Madonna", "Prince") - single unstructured name field */
352
- MONONYM: "mononym",
353
355
  /** Nickname - single unstructured name field */
354
356
  NICKNAME: "nickname",
355
357
  /** Online handle or username - single unstructured name field */
@@ -361,7 +363,6 @@ var CVC_1_VALUES = [
361
363
  CVC_1_NAME_TYPE.LEGAL,
362
364
  CVC_1_NAME_TYPE.ALIAS,
363
365
  CVC_1_NAME_TYPE.TRADE_NAME,
364
- CVC_1_NAME_TYPE.MONONYM,
365
366
  CVC_1_NAME_TYPE.NICKNAME,
366
367
  CVC_1_NAME_TYPE.HANDLE,
367
368
  CVC_1_NAME_TYPE.UNKNOWN
@@ -370,7 +371,6 @@ var CVC_1_LABELS = {
370
371
  [CVC_1_NAME_TYPE.LEGAL]: "Legal Name",
371
372
  [CVC_1_NAME_TYPE.ALIAS]: "Alias / AKA",
372
373
  [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,7 +381,6 @@ 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,
385
384
  CVC_1_NAME_TYPE.NICKNAME,
386
385
  CVC_1_NAME_TYPE.HANDLE,
387
386
  CVC_1_NAME_TYPE.UNKNOWN
@@ -1327,7 +1326,10 @@ var CVC_17_CORE_GENDER_IDENTITY = {
1327
1326
  TRANSGENDER: "TRANSGENDER",
1328
1327
  NON_BINARY: "NON_BINARY",
1329
1328
  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",
1331
1333
  // Level 2 - Transgender subcategories
1332
1334
  TRANSGENDER_FTM: "TRANSGENDER_FTM",
1333
1335
  TRANSGENDER_MTF: "TRANSGENDER_MTF"
@@ -1339,6 +1341,8 @@ var CVC_17_LABELS = {
1339
1341
  [CVC_17_CORE_GENDER_IDENTITY.NON_BINARY]: "Non-Binary",
1340
1342
  [CVC_17_CORE_GENDER_IDENTITY.OTHER]: "Other",
1341
1343
  [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",
1342
1346
  [CVC_17_CORE_GENDER_IDENTITY.TRANSGENDER_FTM]: "Transgender - FTM",
1343
1347
  [CVC_17_CORE_GENDER_IDENTITY.TRANSGENDER_MTF]: "Transgender - MTF"
1344
1348
  };
@@ -1363,6 +1367,32 @@ function isTransgenderGenderIdentity(value) {
1363
1367
  if (!value) return false;
1364
1368
  return CVC_17_TRANSGENDER_VALUES.includes(value);
1365
1369
  }
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
+ ];
1366
1396
  var IC_24_RACE = {
1367
1397
  AMERICAN_INDIAN_ALASKA_NATIVE: 1,
1368
1398
  ASIAN: 2,
@@ -4288,6 +4318,13 @@ var CVC_67_SELECTABLE_VALUES = [
4288
4318
  var CVC_67_MISSINGNESS_VALUES = [
4289
4319
  CVC_67_HMIS_SEX.DATA_NOT_COLLECTED
4290
4320
  ];
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
+ ];
4291
4328
 
4292
4329
  // src/constants/service-catalog.json
4293
4330
  var service_catalog_default = {
@@ -5992,7 +6029,10 @@ var FUNCTION_STATUS_LABELS = {
5992
6029
  CVC_17_LABELS,
5993
6030
  CVC_17_LEVEL_1_OPTIONS,
5994
6031
  CVC_17_LEVEL_2_TRANSGENDER_OPTIONS,
6032
+ CVC_17_MISSINGNESS_VALUES,
6033
+ CVC_17_SELECTABLE_VALUES,
5995
6034
  CVC_17_TRANSGENDER_VALUES,
6035
+ CVC_17_VALUES,
5996
6036
  CVC_180_EDUCATION_LEVEL,
5997
6037
  CVC_180_LABELS,
5998
6038
  CVC_180_ORDINAL,
@@ -6011,6 +6051,7 @@ var FUNCTION_STATUS_LABELS = {
6011
6051
  CVC_67_LABELS,
6012
6052
  CVC_67_MISSINGNESS_VALUES,
6013
6053
  CVC_67_SELECTABLE_VALUES,
6054
+ CVC_67_VALUES,
6014
6055
  CVC_72_HT_TYPE,
6015
6056
  CVC_72_LABELS,
6016
6057
  CVC_72_VALUES,