@choiceapps/communityservices-sdk 0.1.0

package/dist/esm/control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.js","sourceRoot":"","sources":["../../src/control.ts"],"names":[],"mappings":"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","sourcesContent":["import { WellSkyError } from \"./runtime.js\";\nimport type { ClientEvent, ClientHealth, ClientOptions } from \"./runtime.js\";\nimport { CooldownError } from \"./errors.js\";\n\ninterface Waiter { grant: () => void; signal: AbortSignal; abort: () => void }\nexport class Semaphore {\n  active = 0;\n  readonly #capacity: number;\n  readonly #queue: Waiter[] = [];\n  constructor(capacity: number) { this.#capacity = capacity; }\n  get queued(): number { return this.#queue.length; }\n  acquire(signal: AbortSignal, operation: string): Promise<() => void> {\n    return new Promise((resolve, reject) => {\n      let released = false;\n      const grant = () => {\n        signal.removeEventListener(\"abort\", abort);\n        this.active++;\n        resolve(() => {\n          if (released) return;\n          released = true; this.active--;\n          this.#queue.shift()?.grant();\n        });\n      };\n      const abort = () => {\n        const index = this.#queue.indexOf(waiter);\n        if (index >= 0) this.#queue.splice(index, 1);\n        reject(new WellSkyError(signal.reason instanceof DOMException && signal.reason.name === \"TimeoutError\" ? \"timeout\" : \"aborted\", operation));\n      };\n      const waiter: Waiter = { grant, signal, abort };\n      if (signal.aborted) { abort(); return; }\n      if (this.active < this.#capacity) grant();\n      else { this.#queue.push(waiter); signal.addEventListener(\"abort\", abort, { once: true }); }\n    });\n  }\n}\n\nexport interface SharedAuthentication {\n  cached?: { token: string; expiresAt: number } | undefined;\n  inFlight?: Promise<string> | undefined;\n}\nconst identities = new WeakMap<object, number>();\nlet nextIdentity = 1;\nexport function identity(value: object): number {\n  const prior = identities.get(value);\n  if (prior !== undefined) return prior;\n  const id = nextIdentity++; identities.set(value, id); return id;\n}\nconst authentication = new Map<string, SharedAuthentication>();\n/** Credentials are hashed for cache identity and never exposed in keys or diagnostics. */\nexport async function sharedAuthentication(scope: string, auth: ClientOptions[\"auth\"]): Promise<SharedAuthentication> {\n  const descriptor = auth.kind === \"credentials\" ? [scope, auth.kind, auth.username, auth.password] : auth.kind === \"provider\" ? [scope, auth.kind, identity(auth.getToken)] : [scope, auth.kind];\n  const digest = await crypto.subtle.digest(\"SHA-256\", new TextEncoder().encode(JSON.stringify(descriptor)));\n  const key = Array.from(new Uint8Array(digest), byte => byte.toString(16).padStart(2, \"0\")).join(\"\");\n  const prior = authentication.get(key);\n  if (prior) return prior;\n  const state: SharedAuthentication = {};\n  authentication.set(key, state);\n  return state;\n}\nexport const tokenMintQueue = new Semaphore(1);\n\nexport class RequestControl {\n  readonly semaphore: Semaphore;\n  readonly #settings: { threshold: number; windowMs: number; durationMs: number };\n  #failures: number[] = [];\n  #until = 0;\n  tokenMintCount = 0;\n  constructor(concurrency: number, settings: { threshold: number; windowMs: number; durationMs: number }) {\n    for (const value of [concurrency, settings.threshold, settings.windowMs, settings.durationMs]) if (!Number.isSafeInteger(value) || value < 1) throw new TypeError(\"Concurrency and cooldown settings must be positive integers\");\n    this.semaphore = new Semaphore(concurrency); this.#settings = { ...settings };\n  }\n  check(operation: string): void {\n    if (this.#until > Date.now()) throw new CooldownError(operation, this.#until);\n    if (this.#until !== 0) { this.#until = 0; this.#failures = []; }\n  }\n  failed(status: number): number | undefined {\n    if (status !== 401 && status !== 403 && status !== 429 && status < 500) return undefined;\n    const now = Date.now();\n    this.#failures = this.#failures.filter(time => time > now - this.#settings.windowMs);\n    this.#failures.push(now);\n    if (this.#failures.length >= this.#settings.threshold && this.#until <= now) { this.#until = now + this.#settings.durationMs; return this.#until; }\n    return undefined;\n  }\n  health(): ClientHealth {\n    return { state: this.#until > Date.now() ? \"open\" : \"closed\", until: this.#until > Date.now() ? new Date(this.#until).toISOString() : null, activeRequests: this.semaphore.active, queuedRequests: this.semaphore.queued, tokenMintCount: this.tokenMintCount };\n  }\n}\nconst controls = new Map<string, { signature: string; value: RequestControl }>();\nexport function requestControl(scope: string, options: ClientOptions): RequestControl {\n  const concurrency = options.maxConcurrency ?? 8;\n  const cooldown = options.cooldown ?? { threshold: 5, windowMs: 10_000, durationMs: 30_000 };\n  const signature = JSON.stringify([concurrency, cooldown.threshold, cooldown.windowMs, cooldown.durationMs]);\n  const existing = controls.get(scope);\n  if (existing && existing.signature !== signature) throw new TypeError(\"Clients sharing a tenant and transport must use the same concurrency/cooldown settings\");\n  if (existing) return existing.value;\n  const value = new RequestControl(concurrency, cooldown);\n  controls.set(scope, { signature, value }); return value;\n}\n\nexport function emit(options: Pick<ClientOptions, \"hooks\" | \"logger\">, event: ClientEvent): void {\n  const hooks = options.hooks;\n  const handler = event.type === \"request\" ? hooks?.onRequest : event.type === \"response\" ? hooks?.onResponse : event.type === \"tokenMint\" ? hooks?.onTokenMint : event.type === \"throttle\" ? hooks?.onThrottle : hooks?.onCooldown;\n  const safe = Object.freeze({ ...event });\n  // Observers must not turn a completed write into a thrown error or a replay.\n  try { void Promise.resolve(handler?.(safe)).catch(() => {}); } catch { /* Observer failures cannot change request outcomes. */ }\n  try { void Promise.resolve(options.logger?.(safe)).catch(() => {}); } catch { /* Same boundary for user-supplied loggers. */ }\n}\n"]}

package/dist/esm/effective-date.d.ts

@@ -0,0 +1,3 @@
+/** Explicit deployment correction for an observed upstream mobile-write date shift. */
+export declare function correctMobileEffectiveDate(value: unknown, minutes: number, operation: string): string;
+//# sourceMappingURL=effective-date.d.ts.map

package/dist/esm/effective-date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-date.d.ts","sourceRoot":"","sources":["../../src/effective-date.ts"],"names":[],"mappings":"AAEA,uFAAuF;AACvF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAcrG"}

package/dist/esm/effective-date.js

@@ -0,0 +1,24 @@
+import { ValidationError } from "./errors.js";
+/** Explicit deployment correction for an observed upstream mobile-write date shift. */
+export function correctMobileEffectiveDate(value, minutes, operation) {
+    const invalid = () => new ValidationError(operation, ["dateEffective"]);
+    if (typeof value !== "string")
+        throw invalid();
+    const parts = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d{1,3}))?(Z|[+-]\d{2}:\d{2})$/.exec(value);
+    if (!parts)
+        throw invalid();
+    const [, year, month, day, hour, minute, second, , zone] = parts;
+    const date = new Date(`${year}-${month}-${day}T00:00:00.000Z`);
+    if (!Number.isFinite(date.getTime()) || date.toISOString().slice(0, 10) !== `${year}-${month}-${day}` || Number(hour) > 23 || Number(minute) > 59 || Number(second) > 59)
+        throw invalid();
+    if (zone !== "Z" && (!zone || Number(zone.slice(1, 3)) > 14 || Number(zone.slice(4)) > 59 || (Number(zone.slice(1, 3)) === 14 && Number(zone.slice(4)) !== 0)))
+        throw invalid();
+    const corrected = Date.parse(value) + minutes * 60_000;
+    if (!Number.isFinite(corrected))
+        throw invalid();
+    const encoded = new Date(corrected).toISOString();
+    if (!/^\d{4}-/.test(encoded))
+        throw invalid();
+    return encoded;
+}
+//# sourceMappingURL=effective-date.js.map

package/dist/esm/effective-date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-date.js","sourceRoot":"","sources":["../../src/effective-date.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,uFAAuF;AACvF,MAAM,UAAU,0BAA0B,CAAC,KAAc,EAAE,OAAe,EAAE,SAAiB;IAC3F,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,eAAe,CAAC,SAAS,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;IACxE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,OAAO,EAAE,CAAC;IAC/C,MAAM,KAAK,GAAG,sFAAsF,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjH,IAAI,CAAC,KAAK;QAAE,MAAM,OAAO,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,AAAD,EAAG,IAAI,CAAC,GAAG,KAAK,CAAC;IACjE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,gBAAgB,CAAC,CAAC;IAC/D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE;QAAE,MAAM,OAAO,EAAE,CAAC;IAC1L,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,MAAM,OAAO,EAAE,CAAC;IAChL,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,OAAO,GAAG,MAAM,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,MAAM,OAAO,EAAE,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,MAAM,OAAO,EAAE,CAAC;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import { ValidationError } from \"./errors.js\";\n\n/** Explicit deployment correction for an observed upstream mobile-write date shift. */\nexport function correctMobileEffectiveDate(value: unknown, minutes: number, operation: string): string {\n  const invalid = () => new ValidationError(operation, [\"dateEffective\"]);\n  if (typeof value !== \"string\") throw invalid();\n  const parts = /^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})(?:\\.(\\d{1,3}))?(Z|[+-]\\d{2}:\\d{2})$/.exec(value);\n  if (!parts) throw invalid();\n  const [, year, month, day, hour, minute, second, , zone] = parts;\n  const date = new Date(`${year}-${month}-${day}T00:00:00.000Z`);\n  if (!Number.isFinite(date.getTime()) || date.toISOString().slice(0, 10) !== `${year}-${month}-${day}` || Number(hour) > 23 || Number(minute) > 59 || Number(second) > 59) throw invalid();\n  if (zone !== \"Z\" && (!zone || Number(zone.slice(1, 3)) > 14 || Number(zone.slice(4)) > 59 || (Number(zone.slice(1, 3)) === 14 && Number(zone.slice(4)) !== 0))) throw invalid();\n  const corrected = Date.parse(value) + minutes * 60_000;\n  if (!Number.isFinite(corrected)) throw invalid();\n  const encoded = new Date(corrected).toISOString();\n  if (!/^\\d{4}-/.test(encoded)) throw invalid();\n  return encoded;\n}\n"]}

package/dist/esm/encoding.d.ts

@@ -0,0 +1,32 @@
+import type { PicklistOption, PicklistSelector, QuestionDefinition } from "./metadata.js";
+export type AnswerState = "client_doesnt_know" | "client_refused" | "data_not_collected";
+export type AnswerValue = {
+    value: string | number | boolean | string[];
+} | {
+    state: AnswerState;
+} | {
+    option: PicklistSelector;
+} | {
+    options: readonly PicklistSelector[];
+};
+export type Answers = Record<string, AnswerValue>;
+export interface EncodingOptions {
+    endpoint: "standalone" | "enrollment" | "mobile";
+    /** Tenant-verified display labels, including exact whitespace/HUD suffixes, for label-based endpoints. */
+    writeLabel?: (question: QuestionDefinition, option: PicklistOption) => string | undefined;
+    /** Application configuration supplies the relevant option codes. No answer-state labels are guessed. */
+    stateCodes?: Partial<Record<AnswerState, readonly string[]>>;
+    multiValue?: (question: QuestionDefinition, values: readonly string[]) => string;
+}
+export interface EncodedQuestion {
+    question_id: number;
+    question_type: string;
+    virt_field_name: string;
+    answer_value: string;
+}
+export declare function encodeAnswers(questions: readonly QuestionDefinition[], answers: Answers, options: EncodingOptions): EncodedQuestion[];
+/** Builds one new row only. Never accepts or echoes an existing recordset ID. */
+export declare function encodeNewSubassessmentRow(parent: QuestionDefinition, answers: Answers, options: EncodingOptions): {
+    subAssessments: EncodedQuestion[];
+};
+//# sourceMappingURL=encoding.d.ts.map

package/dist/esm/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../src/encoding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAK1F,MAAM,MAAM,WAAW,GAAG,oBAAoB,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;AACzF,MAAM,MAAM,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAAE,CAAC;AAC7K,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAClD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC;IACjD,0GAA0G;IAC1G,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,cAAc,KAAK,MAAM,GAAG,SAAS,CAAC;IAC1F,wGAAwG;IACxG,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IAC7D,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,CAAC;CAClF;AACD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AA2DD,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,eAAe,EAAE,CAgBrI;AAED,iFAAiF;AACjF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG;IAAE,cAAc,EAAE,eAAe,EAAE,CAAA;CAAE,CAUvJ"}

package/dist/esm/encoding.js

@@ -0,0 +1,117 @@
+import { resolvePicklistOption } from "./metadata.js";
+import { ValidationError } from "./errors.js";
+import { resolveRaceCombination } from "./race.js";
+function encodeValue(question, answer, options) {
+    const field = question.fieldName ?? `#${question.questionId}`;
+    if (["label", "blank", "sub_assessment"].includes(question.questionType))
+        throw new ValidationError("assessment encoding", [field]);
+    if (question.questionType === "provider" && options.endpoint === "mobile")
+        throw new ValidationError("mobile provider answers are unsupported", [field]);
+    if ("state" in answer) {
+        if (question.questionType !== "lookup")
+            return undefined;
+        const codes = options.stateCodes?.[answer.state];
+        if (!codes)
+            throw new ValidationError("answer-state code configuration required", [field]);
+        const found = question.options.filter(option => option.code !== null && codes.includes(option.code));
+        if (!found.length)
+            return undefined;
+        if (found.length !== 1 || !found[0])
+            throw new ValidationError("ambiguous answer-state option", [field]);
+        const option = question.fieldName === "HUD_RACEETHNICITY" && found[0].code !== null
+            ? resolveRaceCombination(question, [{ code: found[0].code }]) : found[0];
+        return lookupLabel(question, option, options);
+    }
+    if (question.questionType === "lookup") {
+        if (question.fieldName === "HUD_RACEETHNICITY") {
+            const selectors = "options" in answer ? answer.options : "option" in answer ? [answer.option]
+                : typeof answer.value === "string" ? [{ name: answer.value }]
+                    : Array.isArray(answer.value) ? answer.value.map(name => ({ name })) : undefined;
+            if (!selectors)
+                throw new ValidationError("race requires category selectors", [field]);
+            return lookupLabel(question, resolveRaceCombination(question, selectors), options);
+        }
+        if ("options" in answer)
+            throw new ValidationError("multiple options require a supported combination field", [field]);
+        if ("option" in answer)
+            return lookupLabel(question, resolvePicklistOption(question, answer.option), options);
+        if (typeof answer.value !== "string")
+            throw new ValidationError("lookup requires a code or name selector", [field]);
+        return lookupLabel(question, resolvePicklistOption(question, { name: answer.value }), options);
+    }
+    if (!("value" in answer))
+        throw new ValidationError("picklist selector on a non-lookup question", [field]);
+    const value = answer.value;
+    if (Array.isArray(value)) {
+        if (!options.multiValue)
+            throw new ValidationError("multi-value encoding requires an explicit encoder", [field]);
+        return options.multiValue(question, value);
+    }
+    switch (question.questionType) {
+        case "yes_no":
+            if (value === true || value === "Yes")
+                return "Yes";
+            if (value === false || value === "No")
+                return "No";
+            throw new ValidationError("yes_no encoding", [field]);
+        case "int":
+        case "provider":
+            if ((typeof value !== "number" && typeof value !== "string") || value === "" || !Number.isSafeInteger(Number(value)))
+                throw new ValidationError("integer encoding", [field]);
+            return String(value);
+        case "money":
+            if ((typeof value !== "number" && typeof value !== "string") || value === "" || !Number.isFinite(Number(value)))
+                throw new ValidationError("money encoding", [field]);
+            return String(value);
+        case "date":
+        case "textbox":
+        case "textarea": return String(value);
+        default: throw new ValidationError("unsupported question type", [field]);
+    }
+}
+function lookupLabel(question, option, options) {
+    if (options.endpoint === "mobile")
+        return String(option.id);
+    const label = options.writeLabel?.(question, option);
+    if (!label)
+        throw new ValidationError("verified lookup write label required", [question.fieldName ?? `#${question.questionId}`]);
+    return label;
+}
+export function encodeAnswers(questions, answers, options) {
+    const index = new Map();
+    for (const question of questions)
+        if (question.fieldName) {
+            if (index.has(question.fieldName))
+                throw new ValidationError("ambiguous question field", [question.fieldName]);
+            index.set(question.fieldName, question);
+        }
+    const unknown = Object.keys(answers).filter(field => !index.has(field));
+    if (unknown.length)
+        throw new ValidationError("unknown assessment fields", unknown);
+    const result = [];
+    for (const [field, answer] of Object.entries(answers)) {
+        const question = index.get(field);
+        if (!question)
+            throw new ValidationError("unknown assessment fields", [field]);
+        const value = encodeValue(question, answer, options);
+        if (value !== undefined)
+            result.push({ question_id: question.questionId, question_type: question.questionType, virt_field_name: field, answer_value: value });
+    }
+    return result;
+}
+/** Builds one new row only. Never accepts or echoes an existing recordset ID. */
+export function encodeNewSubassessmentRow(parent, answers, options) {
+    if (parent.questionType !== "sub_assessment")
+        throw new ValidationError("subassessment parent required");
+    const encoded = encodeAnswers(parent.children, answers, options);
+    const included = new Set(encoded.map(q => q.virt_field_name));
+    for (const question of parent.children) {
+        if (!question.fieldName || included.has(question.fieldName) || ["label", "blank", "yes_no"].includes(question.questionType))
+            continue;
+        if (question.questionType === "provider" && options.endpoint === "mobile")
+            throw new ValidationError("mobile provider answers are unsupported", [question.fieldName]);
+        encoded.push({ question_id: question.questionId, question_type: question.questionType, virt_field_name: question.fieldName, answer_value: "" });
+    }
+    return { subAssessments: encoded };
+}
+//# sourceMappingURL=encoding.js.map

package/dist/esm/encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.js","sourceRoot":"","sources":["../../src/encoding.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PicklistOption, PicklistSelector, QuestionDefinition } from \"./metadata.js\";\nimport { resolvePicklistOption } from \"./metadata.js\";\nimport { ValidationError } from \"./errors.js\";\nimport { resolveRaceCombination } from \"./race.js\";\n\nexport type AnswerState = \"client_doesnt_know\" | \"client_refused\" | \"data_not_collected\";\nexport type AnswerValue = { value: string | number | boolean | string[] } | { state: AnswerState } | { option: PicklistSelector } | { options: readonly PicklistSelector[] };\nexport type Answers = Record<string, AnswerValue>;\nexport interface EncodingOptions {\n  endpoint: \"standalone\" | \"enrollment\" | \"mobile\";\n  /** Tenant-verified display labels, including exact whitespace/HUD suffixes, for label-based endpoints. */\n  writeLabel?: (question: QuestionDefinition, option: PicklistOption) => string | undefined;\n  /** Application configuration supplies the relevant option codes. No answer-state labels are guessed. */\n  stateCodes?: Partial<Record<AnswerState, readonly string[]>>;\n  multiValue?: (question: QuestionDefinition, values: readonly string[]) => string;\n}\nexport interface EncodedQuestion {\n  question_id: number;\n  question_type: string;\n  virt_field_name: string;\n  answer_value: string;\n}\n\nfunction encodeValue(question: QuestionDefinition, answer: AnswerValue, options: EncodingOptions): string | undefined {\n  const field = question.fieldName ?? `#${question.questionId}`;\n  if ([\"label\", \"blank\", \"sub_assessment\"].includes(question.questionType)) throw new ValidationError(\"assessment encoding\", [field]);\n  if (question.questionType === \"provider\" && options.endpoint === \"mobile\") throw new ValidationError(\"mobile provider answers are unsupported\", [field]);\n  if (\"state\" in answer) {\n    if (question.questionType !== \"lookup\") return undefined;\n    const codes = options.stateCodes?.[answer.state];\n    if (!codes) throw new ValidationError(\"answer-state code configuration required\", [field]);\n    const found = question.options.filter(option => option.code !== null && codes.includes(option.code));\n    if (!found.length) return undefined;\n    if (found.length !== 1 || !found[0]) throw new ValidationError(\"ambiguous answer-state option\", [field]);\n    const option = question.fieldName === \"HUD_RACEETHNICITY\" && found[0].code !== null\n      ? resolveRaceCombination(question, [{ code: found[0].code }]) : found[0];\n    return lookupLabel(question, option, options);\n  }\n  if (question.questionType === \"lookup\") {\n    if (question.fieldName === \"HUD_RACEETHNICITY\") {\n      const selectors = \"options\" in answer ? answer.options : \"option\" in answer ? [answer.option]\n        : typeof answer.value === \"string\" ? [{ name: answer.value }]\n        : Array.isArray(answer.value) ? answer.value.map(name => ({ name })) : undefined;\n      if (!selectors) throw new ValidationError(\"race requires category selectors\", [field]);\n      return lookupLabel(question, resolveRaceCombination(question, selectors), options);\n    }\n    if (\"options\" in answer) throw new ValidationError(\"multiple options require a supported combination field\", [field]);\n    if (\"option\" in answer) return lookupLabel(question, resolvePicklistOption(question, answer.option), options);\n    if (typeof answer.value !== \"string\") throw new ValidationError(\"lookup requires a code or name selector\", [field]);\n    return lookupLabel(question, resolvePicklistOption(question, { name: answer.value }), options);\n  }\n  if (!(\"value\" in answer)) throw new ValidationError(\"picklist selector on a non-lookup question\", [field]);\n  const value = answer.value;\n  if (Array.isArray(value)) {\n    if (!options.multiValue) throw new ValidationError(\"multi-value encoding requires an explicit encoder\", [field]);\n    return options.multiValue(question, value);\n  }\n  switch (question.questionType) {\n    case \"yes_no\":\n      if (value === true || value === \"Yes\") return \"Yes\";\n      if (value === false || value === \"No\") return \"No\";\n      throw new ValidationError(\"yes_no encoding\", [field]);\n    case \"int\": case \"provider\":\n      if ((typeof value !== \"number\" && typeof value !== \"string\") || value === \"\" || !Number.isSafeInteger(Number(value))) throw new ValidationError(\"integer encoding\", [field]);\n      return String(value);\n    case \"money\":\n      if ((typeof value !== \"number\" && typeof value !== \"string\") || value === \"\" || !Number.isFinite(Number(value))) throw new ValidationError(\"money encoding\", [field]);\n      return String(value);\n    case \"date\": case \"textbox\": case \"textarea\": return String(value);\n    default: throw new ValidationError(\"unsupported question type\", [field]);\n  }\n}\n\nfunction lookupLabel(question: QuestionDefinition, option: PicklistOption, options: EncodingOptions): string {\n  if (options.endpoint === \"mobile\") return String(option.id);\n  const label = options.writeLabel?.(question, option);\n  if (!label) throw new ValidationError(\"verified lookup write label required\", [question.fieldName ?? `#${question.questionId}`]);\n  return label;\n}\n\nexport function encodeAnswers(questions: readonly QuestionDefinition[], answers: Answers, options: EncodingOptions): EncodedQuestion[] {\n  const index = new Map<string, QuestionDefinition>();\n  for (const question of questions) if (question.fieldName) {\n    if (index.has(question.fieldName)) throw new ValidationError(\"ambiguous question field\", [question.fieldName]);\n    index.set(question.fieldName, question);\n  }\n  const unknown = Object.keys(answers).filter(field => !index.has(field));\n  if (unknown.length) throw new ValidationError(\"unknown assessment fields\", unknown);\n  const result: EncodedQuestion[] = [];\n  for (const [field, answer] of Object.entries(answers)) {\n    const question = index.get(field);\n    if (!question) throw new ValidationError(\"unknown assessment fields\", [field]);\n    const value = encodeValue(question, answer, options);\n    if (value !== undefined) result.push({ question_id: question.questionId, question_type: question.questionType, virt_field_name: field, answer_value: value });\n  }\n  return result;\n}\n\n/** Builds one new row only. Never accepts or echoes an existing recordset ID. */\nexport function encodeNewSubassessmentRow(parent: QuestionDefinition, answers: Answers, options: EncodingOptions): { subAssessments: EncodedQuestion[] } {\n  if (parent.questionType !== \"sub_assessment\") throw new ValidationError(\"subassessment parent required\");\n  const encoded = encodeAnswers(parent.children, answers, options);\n  const included = new Set(encoded.map(q => q.virt_field_name));\n  for (const question of parent.children) {\n    if (!question.fieldName || included.has(question.fieldName) || [\"label\", \"blank\", \"yes_no\"].includes(question.questionType)) continue;\n    if (question.questionType === \"provider\" && options.endpoint === \"mobile\") throw new ValidationError(\"mobile provider answers are unsupported\", [question.fieldName]);\n    encoded.push({ question_id: question.questionId, question_type: question.questionType, virt_field_name: question.fieldName, answer_value: \"\" });\n  }\n  return { subAssessments: encoded };\n}\n"]}

package/dist/esm/enrollment-verifications.d.ts

@@ -0,0 +1,39 @@
+import type { WellSkyClient } from "./generated/v3.js";
+import type { SubAssessmentAnswer } from "./generated/v3-models.js";
+import type { RequestOptions } from "./runtime.js";
+/** Structural interface accepted by both V2 and V3 clients. Only a GET is used. */
+export interface VerificationAssessmentReader {
+    assessments: Pick<WellSkyClient["assessments"], "get">;
+}
+export interface EnrollmentVerificationRequest extends RequestOptions {
+    clientId: number;
+    /** An instrument exposing all four standard verification groups. */
+    assessmentCode: string;
+    /** Exact enrollment instant with Z or a numeric offset. No host timezone is inferred. */
+    enrollmentDate: string;
+}
+export type VerificationField = "MONTHLYINCOME" | "SVP_NONCASHBENEFITS" | "HUDHEALTHINSURANCESUBA" | "DISABILITIES_1";
+export type VerificationRecord = SubAssessmentAnswer & {
+    recordset_id: number;
+};
+export interface VerificationGroupSnapshot {
+    fieldName: VerificationField;
+    records: VerificationRecord[];
+    excluded: {
+        record: VerificationRecord;
+        reason: "not_started" | "ended";
+    }[];
+}
+export interface EnrollmentVerificationSnapshot {
+    clientId: number;
+    assessmentCode: string;
+    enrollmentDate: string;
+    /** Current recorded versions filtered by row dates, not an answer-history reconstruction. */
+    source: "current-assessment";
+    groups: VerificationGroupSnapshot[];
+}
+/** Read current recorded verification rows and select start <= enrollment <= end.
+ * Never writes, changes dates, applies a seven-hour correction, or treats isActive as a date filter.
+ * Missing groups, ambiguous rows and invalid/zoneless dates fail rather than imply no records. */
+export declare function readEnrollmentVerifications(client: VerificationAssessmentReader, input: EnrollmentVerificationRequest): Promise<EnrollmentVerificationSnapshot>;
+//# sourceMappingURL=enrollment-verifications.d.ts.map

package/dist/esm/enrollment-verifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrollment-verifications.d.ts","sourceRoot":"","sources":["../../src/enrollment-verifications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,mFAAmF;AACnF,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,CAAC;CACxD;AACD,MAAM,WAAW,6BAA8B,SAAQ,cAAc;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB,yFAAyF;IACzF,cAAc,EAAE,MAAM,CAAC;CACxB;AACD,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG,qBAAqB,GAAG,wBAAwB,GAAG,gBAAgB,CAAC;AACtH,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAChF,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,QAAQ,EAAE;QAAE,MAAM,EAAE,kBAAkB,CAAC;QAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAA;KAAE,EAAE,CAAC;CAC7E;AACD,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,6FAA6F;IAC7F,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,yBAAyB,EAAE,CAAC;CACrC;AAsCD;;kGAEkG;AAClG,wBAAsB,2BAA2B,CAAC,MAAM,EAAE,4BAA4B,EAAE,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAoCrK"}

package/dist/esm/enrollment-verifications.js

@@ -0,0 +1,93 @@
+import { ValidationError } from "./errors.js";
+import { toItems, WellSkyError } from "./runtime.js";
+const fields = [
+    { field: "MONTHLYINCOME", start: "MONTHLYINCOMESTART", end: "MONTHLYINCOMEEND" },
+    { field: "SVP_NONCASHBENEFITS", start: "SVP_NONCASHBENEFITSSTART", end: "SVP_NONCASHBENEFITSEND" },
+    { field: "HUDHEALTHINSURANCESUBA", start: "HUDHEALTHINSURANCESUBASTART", end: "HUDHEALTHINSURANCESUBAEND" },
+    { field: "DISABILITIES_1", start: "DISABILITIES_1START", end: "DISABILITIES_1END" },
+];
+/** Parses ISO and WellSky's offset-bearing SQL date strings without local-time conversion.
+ * Nanoseconds preserve fractional boundaries instead of rounding a future row into the snapshot. */
+function verificationInstant(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const parts = /^(\d{4}-\d{2}-\d{2})[T ](\d{2}):(\d{2}):(\d{2})(?:\.(\d{1,9}))?(Z|[+-]\d{2}(?::?\d{2})?)$/.exec(value);
+    if (!parts)
+        return undefined;
+    const [, calendar, hour, minute, second, fraction = "", zone] = parts;
+    if (!calendar || !zone || Number(hour) > 23 || Number(minute) > 59 || Number(second) > 59)
+        return undefined;
+    const day = new Date(`${calendar}T00:00:00Z`);
+    if (!Number.isFinite(day.getTime()) || day.toISOString().slice(0, 10) !== calendar)
+        return undefined;
+    const offset = zone.slice(1).replace(":", "");
+    const offsetHours = zone === "Z" ? 0 : Number(offset.slice(0, 2));
+    const offsetMinutes = zone === "Z" ? 0 : Number(offset.slice(2) || "0");
+    if (offsetHours > 14 || offsetMinutes > 59 || (offsetHours === 14 && offsetMinutes !== 0))
+        return undefined;
+    const signedOffset = (zone.startsWith("-") ? -1 : 1) * (offsetHours * 60 + offsetMinutes);
+    const millis = day.getTime() + (Number(hour) * 3600 + Number(minute) * 60 + Number(second) - signedOffset * 60) * 1000;
+    return BigInt(millis) * 1000000n + BigInt(fraction.padEnd(9, "0"));
+}
+function recordDate(record, field) {
+    const matches = record.sub_assessment_list?.filter(q => q.virt_field_name === field) ?? [];
+    const question = matches[0];
+    if (matches.length !== 1 || !question || question.question_type !== "date")
+        throw new WellSkyError("protocol", `verification date field ${field}`);
+    const value = question.answer_value;
+    if (value === null || value === undefined || value === "")
+        return null;
+    if (typeof value !== "string")
+        throw new WellSkyError("protocol", `verification date field ${field}`);
+    return value;
+}
+/** Read current recorded verification rows and select start <= enrollment <= end.
+ * Never writes, changes dates, applies a seven-hour correction, or treats isActive as a date filter.
+ * Missing groups, ambiguous rows and invalid/zoneless dates fail rather than imply no records. */
+export async function readEnrollmentVerifications(client, input) {
+    const operation = "read enrollment verifications";
+    const at = verificationInstant(input.enrollmentDate);
+    if (at === undefined)
+        throw new ValidationError(operation, ["enrollmentDate"]);
+    if (!Number.isSafeInteger(input.clientId) || input.clientId < 1)
+        throw new ValidationError(operation, ["clientId"]);
+    if (typeof input.assessmentCode !== "string" || !input.assessmentCode.trim())
+        throw new ValidationError(operation, ["assessmentCode"]);
+    // Do not send dateEffective: it can suppress backdated rows needed for this projection.
+    const response = await client.assessments.get({
+        path: { clientId: input.clientId, assessmentCode: input.assessmentCode },
+        ...(input.signal === undefined ? {} : { signal: input.signal }),
+        ...(input.timeoutMs === undefined ? {} : { timeoutMs: input.timeoutMs }),
+        ...(input.correlationId === undefined ? {} : { correlationId: input.correlationId }),
+    });
+    const questions = toItems(response);
+    const groups = [];
+    const seenIds = new Set();
+    for (const { field, start, end } of fields) {
+        const matches = questions.filter(q => q.virt_field_name === field);
+        const parent = matches[0];
+        if (matches.length !== 1 || !parent || parent.question_type !== "sub_assessment" || !Array.isArray(parent.sub_assessment_answer_list))
+            throw new WellSkyError("protocol", `verification group ${field}`);
+        const group = { fieldName: field, records: [], excluded: [] };
+        for (const raw of parent.sub_assessment_answer_list) {
+            const id = raw.recordset_id;
+            if (typeof id !== "number" || !Number.isSafeInteger(id) || id < 1 || seenIds.has(id))
+                throw new WellSkyError("protocol", "verification record identity");
+            seenIds.add(id);
+            const record = { ...structuredClone(raw), recordset_id: id };
+            const startValue = recordDate(record, start), endValue = recordDate(record, end);
+            const from = verificationInstant(startValue), through = endValue === null ? null : verificationInstant(endValue);
+            if (from === undefined || through === undefined || (through !== null && through < from))
+                throw new WellSkyError("protocol", `verification interval ${field}`);
+            if (from > at)
+                group.excluded.push({ record, reason: "not_started" });
+            else if (through !== null && through < at)
+                group.excluded.push({ record, reason: "ended" });
+            else
+                group.records.push(record);
+        }
+        groups.push(group);
+    }
+    return { clientId: input.clientId, assessmentCode: input.assessmentCode, enrollmentDate: input.enrollmentDate, source: "current-assessment", groups };
+}
+//# sourceMappingURL=enrollment-verifications.js.map

package/dist/esm/enrollment-verifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrollment-verifications.js","sourceRoot":"","sources":["../../src/enrollment-verifications.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AA8BrD,MAAM,MAAM,GAA+D;IACzE,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,oBAAoB,EAAE,GAAG,EAAE,kBAAkB,EAAE;IAChF,EAAE,KAAK,EAAE,qBAAqB,EAAE,KAAK,EAAE,0BAA0B,EAAE,GAAG,EAAE,wBAAwB,EAAE;IAClG,EAAE,KAAK,EAAE,wBAAwB,EAAE,KAAK,EAAE,6BAA6B,EAAE,GAAG,EAAE,2BAA2B,EAAE;IAC3G,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,qBAAqB,EAAE,GAAG,EAAE,mBAAmB,EAAE;CACpF,CAAC;AAEF;oGACoG;AACpG,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,KAAK,GAAG,2FAA2F,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtH,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,EAAE,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IACtE,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE;QAAE,OAAO,SAAS,CAAC;IAC5G,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,QAAQ,YAAY,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACrG,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,aAAa,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACxE,IAAI,WAAW,GAAG,EAAE,IAAI,aAAa,GAAG,EAAE,IAAI,CAAC,WAAW,KAAK,EAAE,IAAI,aAAa,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5G,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,GAAG,EAAE,GAAG,aAAa,CAAC,CAAC;IAC1F,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,YAAY,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC;IACvH,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,QAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,UAAU,CAAC,MAA0B,EAAE,KAAa;IAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3F,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,aAAa,KAAK,MAAM;QAAE,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,2BAA2B,KAAK,EAAE,CAAC,CAAC;IACnJ,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC;IACpC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACvE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,2BAA2B,KAAK,EAAE,CAAC,CAAC;IACtG,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;kGAEkG;AAClG,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,MAAoC,EAAE,KAAoC;IAC1H,MAAM,SAAS,GAAG,+BAA+B,CAAC;IAClD,MAAM,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACrD,IAAI,EAAE,KAAK,SAAS;QAAE,MAAM,IAAI,eAAe,CAAC,SAAS,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC/E,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IACpH,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,eAAe,CAAC,SAAS,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACvI,wFAAwF;IACxF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC;QAC5C,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE;QACxE,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;QAC/D,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;QACxE,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;KACrF,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,MAAM,GAAgC,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,MAAM,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,KAAK,KAAK,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,aAAa,KAAK,gBAAgB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,0BAA0B,CAAC;YAAE,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,sBAAsB,KAAK,EAAE,CAAC,CAAC;QACzM,MAAM,KAAK,GAA8B,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QACzF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,0BAA0B,EAAE,CAAC;YACpD,MAAM,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC;YAC5B,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,8BAA8B,CAAC,CAAC;YACzJ,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,MAAM,MAAM,GAAuB,EAAE,GAAG,eAAe,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;YACjF,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACjF,MAAM,IAAI,GAAG,mBAAmB,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YACjH,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,GAAG,IAAI,CAAC;gBAAE,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,yBAAyB,KAAK,EAAE,CAAC,CAAC;YAC9J,IAAI,IAAI,GAAG,EAAE;gBAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;iBACjE,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,GAAG,EAAE;gBAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;;gBACvF,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAC;AACxJ,CAAC","sourcesContent":["import type { WellSkyClient } from \"./generated/v3.js\";\nimport type { SubAssessmentAnswer } from \"./generated/v3-models.js\";\nimport { ValidationError } from \"./errors.js\";\nimport { toItems, WellSkyError } from \"./runtime.js\";\nimport type { RequestOptions } from \"./runtime.js\";\n\n/** Structural interface accepted by both V2 and V3 clients. Only a GET is used. */\nexport interface VerificationAssessmentReader {\n  assessments: Pick<WellSkyClient[\"assessments\"], \"get\">;\n}\nexport interface EnrollmentVerificationRequest extends RequestOptions {\n  clientId: number;\n  /** An instrument exposing all four standard verification groups. */\n  assessmentCode: string;\n  /** Exact enrollment instant with Z or a numeric offset. No host timezone is inferred. */\n  enrollmentDate: string;\n}\nexport type VerificationField = \"MONTHLYINCOME\" | \"SVP_NONCASHBENEFITS\" | \"HUDHEALTHINSURANCESUBA\" | \"DISABILITIES_1\";\nexport type VerificationRecord = SubAssessmentAnswer & { recordset_id: number };\nexport interface VerificationGroupSnapshot {\n  fieldName: VerificationField;\n  records: VerificationRecord[];\n  excluded: { record: VerificationRecord; reason: \"not_started\" | \"ended\" }[];\n}\nexport interface EnrollmentVerificationSnapshot {\n  clientId: number;\n  assessmentCode: string;\n  enrollmentDate: string;\n  /** Current recorded versions filtered by row dates, not an answer-history reconstruction. */\n  source: \"current-assessment\";\n  groups: VerificationGroupSnapshot[];\n}\n\nconst fields: { field: VerificationField; start: string; end: string }[] = [\n  { field: \"MONTHLYINCOME\", start: \"MONTHLYINCOMESTART\", end: \"MONTHLYINCOMEEND\" },\n  { field: \"SVP_NONCASHBENEFITS\", start: \"SVP_NONCASHBENEFITSSTART\", end: \"SVP_NONCASHBENEFITSEND\" },\n  { field: \"HUDHEALTHINSURANCESUBA\", start: \"HUDHEALTHINSURANCESUBASTART\", end: \"HUDHEALTHINSURANCESUBAEND\" },\n  { field: \"DISABILITIES_1\", start: \"DISABILITIES_1START\", end: \"DISABILITIES_1END\" },\n];\n\n/** Parses ISO and WellSky's offset-bearing SQL date strings without local-time conversion.\n * Nanoseconds preserve fractional boundaries instead of rounding a future row into the snapshot. */\nfunction verificationInstant(value: unknown): bigint | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const parts = /^(\\d{4}-\\d{2}-\\d{2})[T ](\\d{2}):(\\d{2}):(\\d{2})(?:\\.(\\d{1,9}))?(Z|[+-]\\d{2}(?::?\\d{2})?)$/.exec(value);\n  if (!parts) return undefined;\n  const [, calendar, hour, minute, second, fraction = \"\", zone] = parts;\n  if (!calendar || !zone || Number(hour) > 23 || Number(minute) > 59 || Number(second) > 59) return undefined;\n  const day = new Date(`${calendar}T00:00:00Z`);\n  if (!Number.isFinite(day.getTime()) || day.toISOString().slice(0, 10) !== calendar) return undefined;\n  const offset = zone.slice(1).replace(\":\", \"\");\n  const offsetHours = zone === \"Z\" ? 0 : Number(offset.slice(0, 2));\n  const offsetMinutes = zone === \"Z\" ? 0 : Number(offset.slice(2) || \"0\");\n  if (offsetHours > 14 || offsetMinutes > 59 || (offsetHours === 14 && offsetMinutes !== 0)) return undefined;\n  const signedOffset = (zone.startsWith(\"-\") ? -1 : 1) * (offsetHours * 60 + offsetMinutes);\n  const millis = day.getTime() + (Number(hour) * 3600 + Number(minute) * 60 + Number(second) - signedOffset * 60) * 1000;\n  return BigInt(millis) * 1_000_000n + BigInt(fraction.padEnd(9, \"0\"));\n}\n\nfunction recordDate(record: VerificationRecord, field: string): string | null {\n  const matches = record.sub_assessment_list?.filter(q => q.virt_field_name === field) ?? [];\n  const question = matches[0];\n  if (matches.length !== 1 || !question || question.question_type !== \"date\") throw new WellSkyError(\"protocol\", `verification date field ${field}`);\n  const value = question.answer_value;\n  if (value === null || value === undefined || value === \"\") return null;\n  if (typeof value !== \"string\") throw new WellSkyError(\"protocol\", `verification date field ${field}`);\n  return value;\n}\n\n/** Read current recorded verification rows and select start <= enrollment <= end.\n * Never writes, changes dates, applies a seven-hour correction, or treats isActive as a date filter.\n * Missing groups, ambiguous rows and invalid/zoneless dates fail rather than imply no records. */\nexport async function readEnrollmentVerifications(client: VerificationAssessmentReader, input: EnrollmentVerificationRequest): Promise<EnrollmentVerificationSnapshot> {\n  const operation = \"read enrollment verifications\";\n  const at = verificationInstant(input.enrollmentDate);\n  if (at === undefined) throw new ValidationError(operation, [\"enrollmentDate\"]);\n  if (!Number.isSafeInteger(input.clientId) || input.clientId < 1) throw new ValidationError(operation, [\"clientId\"]);\n  if (typeof input.assessmentCode !== \"string\" || !input.assessmentCode.trim()) throw new ValidationError(operation, [\"assessmentCode\"]);\n  // Do not send dateEffective: it can suppress backdated rows needed for this projection.\n  const response = await client.assessments.get({\n    path: { clientId: input.clientId, assessmentCode: input.assessmentCode },\n    ...(input.signal === undefined ? {} : { signal: input.signal }),\n    ...(input.timeoutMs === undefined ? {} : { timeoutMs: input.timeoutMs }),\n    ...(input.correlationId === undefined ? {} : { correlationId: input.correlationId }),\n  });\n  const questions = toItems(response);\n  const groups: VerificationGroupSnapshot[] = [];\n  const seenIds = new Set<number>();\n  for (const { field, start, end } of fields) {\n    const matches = questions.filter(q => q.virt_field_name === field);\n    const parent = matches[0];\n    if (matches.length !== 1 || !parent || parent.question_type !== \"sub_assessment\" || !Array.isArray(parent.sub_assessment_answer_list)) throw new WellSkyError(\"protocol\", `verification group ${field}`);\n    const group: VerificationGroupSnapshot = { fieldName: field, records: [], excluded: [] };\n    for (const raw of parent.sub_assessment_answer_list) {\n      const id = raw.recordset_id;\n      if (typeof id !== \"number\" || !Number.isSafeInteger(id) || id < 1 || seenIds.has(id)) throw new WellSkyError(\"protocol\", \"verification record identity\");\n      seenIds.add(id);\n      const record: VerificationRecord = { ...structuredClone(raw), recordset_id: id };\n      const startValue = recordDate(record, start), endValue = recordDate(record, end);\n      const from = verificationInstant(startValue), through = endValue === null ? null : verificationInstant(endValue);\n      if (from === undefined || through === undefined || (through !== null && through < from)) throw new WellSkyError(\"protocol\", `verification interval ${field}`);\n      if (from > at) group.excluded.push({ record, reason: \"not_started\" });\n      else if (through !== null && through < at) group.excluded.push({ record, reason: \"ended\" });\n      else group.records.push(record);\n    }\n    groups.push(group);\n  }\n  return { clientId: input.clientId, assessmentCode: input.assessmentCode, enrollmentDate: input.enrollmentDate, source: \"current-assessment\", groups };\n}\n"]}

package/dist/esm/errors.d.ts

@@ -0,0 +1,33 @@
+import { WellSkyError } from "./runtime.js";
+export declare class TenantMismatchError extends WellSkyError {
+    constructor(operation: string);
+}
+export declare class AuthError extends WellSkyError {
+    constructor(operation: string, status?: number);
+}
+export declare class ThrottledError extends WellSkyError {
+    constructor(operation: string, retryAfterMs: number, status?: number, requestId?: string);
+}
+export declare class CooldownError extends WellSkyError {
+    readonly until: string;
+    constructor(operation: string, until: number);
+}
+export declare class ValidationError extends WellSkyError {
+    readonly fields: readonly string[];
+    constructor(operation: string, fields?: readonly string[]);
+}
+export declare class UpstreamError extends WellSkyError {
+    constructor(operation: string, status: number, requestId?: string, retryAfterMs?: number);
+}
+export declare class AmbiguousCommitError extends WellSkyError {
+    constructor(operation: string);
+}
+export declare class DefinitionDriftError extends WellSkyError {
+    readonly fields: readonly string[];
+    constructor(fields: readonly string[]);
+}
+export declare class UnknownPicklistValueError extends WellSkyError {
+    readonly field: string;
+    constructor(field: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,SAAS,EAAE,MAAM;CAC9B;AACD,qBAAa,SAAU,SAAQ,YAAY;gBAC7B,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAC/C;AACD,qBAAa,cAAe,SAAQ,YAAY;gBAClC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CACtF;AACD,qBAAa,aAAc,SAAQ,YAAY;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBACX,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAC7C;AACD,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;gBACvB,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,SAAS,MAAM,EAAO;CAC9D;AACD,qBAAa,aAAc,SAAQ,YAAY;gBACjC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CACzF;AACD,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,SAAS,EAAE,MAAM;CAC9B;AACD,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;gBACvB,MAAM,EAAE,SAAS,MAAM,EAAE;CACtC;AACD,qBAAa,yBAA0B,SAAQ,YAAY;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBACX,KAAK,EAAE,MAAM;CAC1B"}

package/dist/esm/errors.js

@@ -0,0 +1,33 @@
+import { WellSkyError } from "./runtime.js";
+export class TenantMismatchError extends WellSkyError {
+    constructor(operation) { super("tenant_mismatch", operation); this.name = "TenantMismatchError"; }
+}
+export class AuthError extends WellSkyError {
+    constructor(operation, status) { super("auth", operation, status === undefined ? {} : { status }); this.name = "AuthError"; }
+}
+export class ThrottledError extends WellSkyError {
+    constructor(operation, retryAfterMs, status = 429, requestId) { super("throttled", operation, { status, retryAfterMs, ...(requestId === undefined ? {} : { requestId }) }); this.name = "ThrottledError"; }
+}
+export class CooldownError extends WellSkyError {
+    until;
+    constructor(operation, until) { super("cooldown", operation); this.name = "CooldownError"; this.until = new Date(until).toISOString(); }
+}
+export class ValidationError extends WellSkyError {
+    fields;
+    constructor(operation, fields = []) { super("validation", operation); this.name = "ValidationError"; this.fields = [...fields]; }
+}
+export class UpstreamError extends WellSkyError {
+    constructor(operation, status, requestId, retryAfterMs) { super("http", operation, { status, ...(requestId === undefined ? {} : { requestId }), ...(retryAfterMs === undefined ? {} : { retryAfterMs }) }); this.name = "UpstreamError"; }
+}
+export class AmbiguousCommitError extends WellSkyError {
+    constructor(operation) { super("ambiguous_commit", operation); this.name = "AmbiguousCommitError"; }
+}
+export class DefinitionDriftError extends WellSkyError {
+    fields;
+    constructor(fields) { super("definition_drift", "assessment metadata"); this.name = "DefinitionDriftError"; this.fields = [...fields]; }
+}
+export class UnknownPicklistValueError extends WellSkyError {
+    field;
+    constructor(field) { super("unknown_picklist_value", "picklist resolution"); this.name = "UnknownPicklistValueError"; this.field = field; }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"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","sourcesContent":["import { WellSkyError } from \"./runtime.js\";\n\nexport class TenantMismatchError extends WellSkyError {\n  constructor(operation: string) { super(\"tenant_mismatch\", operation); this.name = \"TenantMismatchError\"; }\n}\nexport class AuthError extends WellSkyError {\n  constructor(operation: string, status?: number) { super(\"auth\", operation, status === undefined ? {} : { status }); this.name = \"AuthError\"; }\n}\nexport class ThrottledError extends WellSkyError {\n  constructor(operation: string, retryAfterMs: number, status = 429, requestId?: string) { super(\"throttled\", operation, { status, retryAfterMs, ...(requestId === undefined ? {} : { requestId }) }); this.name = \"ThrottledError\"; }\n}\nexport class CooldownError extends WellSkyError {\n  readonly until: string;\n  constructor(operation: string, until: number) { super(\"cooldown\", operation); this.name = \"CooldownError\"; this.until = new Date(until).toISOString(); }\n}\nexport class ValidationError extends WellSkyError {\n  readonly fields: readonly string[];\n  constructor(operation: string, fields: readonly string[] = []) { super(\"validation\", operation); this.name = \"ValidationError\"; this.fields = [...fields]; }\n}\nexport class UpstreamError extends WellSkyError {\n  constructor(operation: string, status: number, requestId?: string, retryAfterMs?: number) { super(\"http\", operation, { status, ...(requestId === undefined ? {} : { requestId }), ...(retryAfterMs === undefined ? {} : { retryAfterMs }) }); this.name = \"UpstreamError\"; }\n}\nexport class AmbiguousCommitError extends WellSkyError {\n  constructor(operation: string) { super(\"ambiguous_commit\", operation); this.name = \"AmbiguousCommitError\"; }\n}\nexport class DefinitionDriftError extends WellSkyError {\n  readonly fields: readonly string[];\n  constructor(fields: readonly string[]) { super(\"definition_drift\", \"assessment metadata\"); this.name = \"DefinitionDriftError\"; this.fields = [...fields]; }\n}\nexport class UnknownPicklistValueError extends WellSkyError {\n  readonly field: string;\n  constructor(field: string) { super(\"unknown_picklist_value\", \"picklist resolution\"); this.name = \"UnknownPicklistValueError\"; this.field = field; }\n}\n"]}