@choiceapps/communityservices-sdk 0.1.0

package/dist/cjs/metadata.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssessmentMetadata = void 0;
+exports.flattenQuestions = flattenQuestions;
+exports.buildAssessmentDefinition = buildAssessmentDefinition;
+exports.compareDefinition = compareDefinition;
+exports.resolvePicklistOption = resolvePicklistOption;
+const runtime_js_1 = require("./runtime.js");
+const errors_js_1 = require("./errors.js");
+const validation_js_1 = require("./validation.js");
+function numberOrNull(value) { return typeof value === "number" && Number.isSafeInteger(value) ? value : null; }
+function stringOrNull(value) { return typeof value === "string" ? value : null; }
+function boolOrNull(value) { return typeof value === "boolean" ? value : null; }
+function rows(value) {
+    const items = (0, validation_js_1.isRecord)(value) && Array.isArray(value.value) ? value.value : Array.isArray(value) ? value : value === null ? [] : [value];
+    if (!Array.isArray(items) || items.some(item => !(0, validation_js_1.isRecord)(item)))
+        throw new runtime_js_1.WellSkyError("protocol", "assessment metadata");
+    return items.filter(validation_js_1.isRecord);
+}
+function options(value) {
+    if (value === undefined || value === null)
+        return [];
+    return rows(value).map(raw => {
+        const id = numberOrNull(raw.picklist_value_id);
+        if (id === null)
+            throw new runtime_js_1.WellSkyError("protocol", "picklist metadata");
+        return { id, picklistId: numberOrNull(raw.picklist_id), code: stringOrNull(raw.code), picklistCode: stringOrNull(raw.picklist_code), name: stringOrNull(raw.name), displayOrder: numberOrNull(raw.disp_order), hudVisibility: numberOrNull(raw.show_on_hud_nonhud_site) };
+    });
+}
+function mergeQuestions(documents, depth = 0) {
+    if (depth > 30)
+        throw new runtime_js_1.WellSkyError("protocol", "assessment metadata");
+    const merged = new Map();
+    const childSources = new Map();
+    for (const document of documents)
+        for (const raw of rows(document)) {
+            const id = numberOrNull(raw.question_id);
+            const kind = stringOrNull(raw.question_type);
+            if (id === null || !kind)
+                throw new runtime_js_1.WellSkyError("protocol", "assessment metadata");
+            const fieldName = stringOrNull(raw.virt_field_name);
+            const key = fieldName ?? `#${id}`;
+            const prior = merged.get(key);
+            const picklistId = numberOrNull(raw.picklist_id);
+            if (prior && (prior.questionId !== id || prior.questionType !== kind || (prior.picklistId !== null && picklistId !== null && prior.picklistId !== picklistId)))
+                throw new errors_js_1.DefinitionDriftError([key]);
+            const optionMap = new Map((prior?.options ?? []).map(option => [option.id, option]));
+            for (const option of options(raw.picklist_value_list)) {
+                const previous = optionMap.get(option.id);
+                if (previous && JSON.stringify(previous) !== JSON.stringify(option))
+                    throw new errors_js_1.DefinitionDriftError([key]);
+                if (picklistId !== null && option.picklistId !== null && option.picklistId !== picklistId)
+                    throw new errors_js_1.DefinitionDriftError([key]);
+                optionMap.set(option.id, option);
+            }
+            merged.set(key, {
+                questionId: id, fieldName, questionType: kind,
+                description: stringOrNull(raw.description) ?? prior?.description ?? null,
+                displayOrder: numberOrNull(raw.disp_order) ?? prior?.displayOrder ?? null,
+                mandatory: boolOrNull(raw.mandatory_flag) ?? boolOrNull(raw.manditory_flag) ?? prior?.mandatory ?? null,
+                showOnPrevious: boolOrNull(raw.show_on_prev) ?? prior?.showOnPrevious ?? null,
+                picklistId: picklistId ?? prior?.picklistId ?? null,
+                options: [...optionMap.values()].sort((a, b) => (a.displayOrder ?? Infinity) - (b.displayOrder ?? Infinity) || a.id - b.id),
+                children: [],
+            });
+            const children = childSources.get(key) ?? [];
+            if (raw.sub_assessment_question_list != null)
+                children.push(raw.sub_assessment_question_list);
+            for (const record of rows(raw.sub_assessment_answer_list ?? []))
+                if (record.sub_assessment_list != null)
+                    children.push(record.sub_assessment_list);
+            childSources.set(key, children);
+        }
+    for (const [key, question] of merged)
+        question.children = mergeQuestions(childSources.get(key) ?? [], depth + 1);
+    return [...merged.values()].sort((a, b) => (a.displayOrder ?? Infinity) - (b.displayOrder ?? Infinity) || a.questionId - b.questionId);
+}
+function flattenQuestions(questions, parent = []) {
+    return questions.flatMap(question => {
+        const path = [...parent, question.fieldName ?? `#${question.questionId}`];
+        return [{ path, question }, ...flattenQuestions(question.children, path)];
+    });
+}
+/** Only metadata fields are copied; no answers, client IDs, recordsets, or staff IDs survive. */
+function buildAssessmentDefinition(input) {
+    const questions = mergeQuestions([input.mobile, input.generic]);
+    if (!questions.length)
+        throw new runtime_js_1.WellSkyError("protocol", "assessment metadata");
+    return { tenant: input.tenant, assessmentCode: input.assessmentCode, effectiveDate: input.effectiveDate ?? null, retrievedAt: new Date().toISOString(), picklistEffectiveDate: "current", questions, unresolvedPicklists: flattenQuestions(questions).filter(({ question }) => question.questionType === "lookup" && !question.options.length).map(({ path }) => path.join("/")) };
+}
+function compareDefinition(expected, definition) {
+    const old = new Map(expected.questions.map(q => [JSON.stringify(q.path), q]));
+    const current = new Map(flattenQuestions(definition.questions).map(q => [JSON.stringify(q.path), q]));
+    const added = [], removed = [], retyped = [], newlyMandatory = [];
+    for (const [key, entry] of current) {
+        const previous = old.get(key);
+        if (!previous)
+            added.push(entry.path.join("/"));
+        if (previous && previous.questionType !== entry.question.questionType)
+            retyped.push(entry.path.join("/"));
+        if (entry.question.mandatory === true && previous?.mandatory !== true)
+            newlyMandatory.push(entry.path.join("/"));
+    }
+    for (const [key, entry] of old)
+        if (!current.has(key))
+            removed.push(entry.path.join("/"));
+    return { breaking: Boolean(removed.length || retyped.length || newlyMandatory.length), added, removed, retyped, newlyMandatory };
+}
+function resolvePicklistOption(question, selector) {
+    let found = selector.code === undefined ? [] : question.options.filter(option => option.code === selector.code);
+    if (!found.length && selector.name !== undefined)
+        found = question.options.filter(option => option.name?.trim() === selector.name?.trim());
+    if (found.length !== 1 || !found[0])
+        throw new errors_js_1.UnknownPicklistValueError(question.fieldName ?? `#${question.questionId}`);
+    return structuredClone(found[0]);
+}
+class AssessmentMetadata {
+    #source;
+    #tenant;
+    #ttl;
+    #max;
+    #cache = new Map();
+    constructor(tenant, source, ttlMs = 60_000, maxEntries = 100) {
+        if (!Number.isSafeInteger(ttlMs) || ttlMs < 0 || !Number.isSafeInteger(maxEntries) || maxEntries < 1)
+            throw new errors_js_1.ValidationError("metadata configuration");
+        this.#tenant = tenant;
+        this.#source = source;
+        this.#ttl = ttlMs;
+        this.#max = maxEntries;
+    }
+    async getDefinition(context) {
+        context.signal?.throwIfAborted();
+        if (!Number.isSafeInteger(context.clientId) || context.clientId < 1 || !context.assessmentCode)
+            throw new errors_js_1.ValidationError("assessment metadata", ["clientId", "assessmentCode"]);
+        const key = JSON.stringify([context.clientId, context.assessmentCode, context.effectiveDate ?? null]);
+        const cached = this.#cache.get(key);
+        if (!context.refresh && cached && cached.expires > Date.now())
+            return structuredClone(cached.value);
+        const [mobile, generic] = await Promise.all([this.#source.mobile(context), this.#source.generic(context)]);
+        context.signal?.throwIfAborted();
+        const value = buildAssessmentDefinition({ tenant: this.#tenant, assessmentCode: context.assessmentCode, ...(context.effectiveDate === undefined ? {} : { effectiveDate: context.effectiveDate }), mobile, generic });
+        this.#cache.delete(key);
+        if (this.#cache.size >= this.#max) {
+            const first = this.#cache.keys().next().value;
+            if (first !== undefined)
+                this.#cache.delete(first);
+        }
+        this.#cache.set(key, { expires: Date.now() + this.#ttl, value });
+        return structuredClone(value);
+    }
+    async listQuestions(context) { return flattenQuestions((await this.getDefinition(context)).questions); }
+    async getQuestion(context) {
+        const matches = (await this.listQuestions(context)).filter(entry => entry.question.fieldName === context.fieldName && (context.parentPath === undefined || JSON.stringify(entry.path.slice(0, -1)) === JSON.stringify(context.parentPath)));
+        if (matches.length !== 1 || !matches[0])
+            throw new errors_js_1.ValidationError("question resolution", [context.fieldName]);
+        return matches[0].question;
+    }
+    async listPicklists(context) {
+        return (await this.listQuestions(context)).filter(({ question }) => question.questionType === "lookup" || question.options.length).map(({ path, question }) => ({ picklistId: question.picklistId, questionPath: path, options: question.options, status: question.options.length ? "enumerated" : "unresolved" }));
+    }
+    async resolve(context) { return resolvePicklistOption(await this.getQuestion(context), context); }
+    clearCache() { this.#cache.clear(); }
+}
+exports.AssessmentMetadata = AssessmentMetadata;
+//# sourceMappingURL=metadata.js.map

package/dist/cjs/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/metadata.ts"],"names":[],"mappings":"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","sourcesContent":["import { WellSkyError } from \"./runtime.js\";\nimport type { RequestOptions } from \"./runtime.js\";\nimport { DefinitionDriftError, UnknownPicklistValueError, ValidationError } from \"./errors.js\";\nimport { isRecord } from \"./validation.js\";\n\nexport interface AssessmentContext extends RequestOptions {\n  clientId: number;\n  assessmentCode: string;\n  effectiveDate?: string;\n  refresh?: boolean;\n}\nexport interface PicklistOption {\n  id: number;\n  picklistId: number | null;\n  code: string | null;\n  picklistCode: string | null;\n  /** Raw metadata name. Not proof of a valid standalone/enrollment write label. */\n  name: string | null;\n  displayOrder: number | null;\n  hudVisibility: number | null;\n}\nexport interface QuestionDefinition {\n  questionId: number;\n  fieldName: string | null;\n  description: string | null;\n  questionType: string;\n  displayOrder: number | null;\n  mandatory: boolean | null;\n  showOnPrevious: boolean | null;\n  picklistId: number | null;\n  options: PicklistOption[];\n  children: QuestionDefinition[];\n}\nexport interface AssessmentDefinition {\n  tenant: string;\n  assessmentCode: string;\n  effectiveDate: string | null;\n  retrievedAt: string;\n  /** The mobile metadata endpoint cannot filter its option catalog by date. */\n  picklistEffectiveDate: \"current\";\n  questions: QuestionDefinition[];\n  unresolvedPicklists: string[];\n}\nexport interface QuestionReference { fieldName: string; parentPath?: readonly string[] }\nexport interface QuestionEntry { path: string[]; question: QuestionDefinition }\nexport interface PicklistDefinition {\n  picklistId: number | null;\n  questionPath: string[];\n  options: PicklistOption[];\n  status: \"enumerated\" | \"unresolved\";\n}\nexport type PicklistSelector = { code: string; name?: string } | { name: string; code?: never };\nexport interface MetadataSource {\n  generic: (context: AssessmentContext) => Promise<unknown>;\n  mobile: (context: AssessmentContext) => Promise<unknown>;\n}\nexport interface DefinitionExpectation { questions: ReadonlyArray<{ path: readonly string[]; questionType: string; mandatory?: boolean | null }> }\nexport interface DefinitionDrift {\n  breaking: boolean;\n  added: string[];\n  removed: string[];\n  retyped: string[];\n  newlyMandatory: string[];\n}\n\nfunction numberOrNull(value: unknown): number | null { return typeof value === \"number\" && Number.isSafeInteger(value) ? value : null; }\nfunction stringOrNull(value: unknown): string | null { return typeof value === \"string\" ? value : null; }\nfunction boolOrNull(value: unknown): boolean | null { return typeof value === \"boolean\" ? value : null; }\nfunction rows(value: unknown): Record<string, unknown>[] {\n  const items: unknown = isRecord(value) && Array.isArray(value.value) ? value.value : Array.isArray(value) ? value : value === null ? [] : [value];\n  if (!Array.isArray(items) || items.some(item => !isRecord(item))) throw new WellSkyError(\"protocol\", \"assessment metadata\");\n  return items.filter(isRecord);\n}\n\nfunction options(value: unknown): PicklistOption[] {\n  if (value === undefined || value === null) return [];\n  return rows(value).map(raw => {\n    const id = numberOrNull(raw.picklist_value_id);\n    if (id === null) throw new WellSkyError(\"protocol\", \"picklist metadata\");\n    return { id, picklistId: numberOrNull(raw.picklist_id), code: stringOrNull(raw.code), picklistCode: stringOrNull(raw.picklist_code), name: stringOrNull(raw.name), displayOrder: numberOrNull(raw.disp_order), hudVisibility: numberOrNull(raw.show_on_hud_nonhud_site) };\n  });\n}\n\nfunction mergeQuestions(documents: unknown[], depth = 0): QuestionDefinition[] {\n  if (depth > 30) throw new WellSkyError(\"protocol\", \"assessment metadata\");\n  const merged = new Map<string, QuestionDefinition>();\n  const childSources = new Map<string, unknown[]>();\n  for (const document of documents) for (const raw of rows(document)) {\n    const id = numberOrNull(raw.question_id);\n    const kind = stringOrNull(raw.question_type);\n    if (id === null || !kind) throw new WellSkyError(\"protocol\", \"assessment metadata\");\n    const fieldName = stringOrNull(raw.virt_field_name);\n    const key = fieldName ?? `#${id}`;\n    const prior = merged.get(key);\n    const picklistId = numberOrNull(raw.picklist_id);\n    if (prior && (prior.questionId !== id || prior.questionType !== kind || (prior.picklistId !== null && picklistId !== null && prior.picklistId !== picklistId))) throw new DefinitionDriftError([key]);\n    const optionMap = new Map((prior?.options ?? []).map(option => [option.id, option]));\n    for (const option of options(raw.picklist_value_list)) {\n      const previous = optionMap.get(option.id);\n      if (previous && JSON.stringify(previous) !== JSON.stringify(option)) throw new DefinitionDriftError([key]);\n      if (picklistId !== null && option.picklistId !== null && option.picklistId !== picklistId) throw new DefinitionDriftError([key]);\n      optionMap.set(option.id, option);\n    }\n    merged.set(key, {\n      questionId: id, fieldName, questionType: kind,\n      description: stringOrNull(raw.description) ?? prior?.description ?? null,\n      displayOrder: numberOrNull(raw.disp_order) ?? prior?.displayOrder ?? null,\n      mandatory: boolOrNull(raw.mandatory_flag) ?? boolOrNull(raw.manditory_flag) ?? prior?.mandatory ?? null,\n      showOnPrevious: boolOrNull(raw.show_on_prev) ?? prior?.showOnPrevious ?? null,\n      picklistId: picklistId ?? prior?.picklistId ?? null,\n      options: [...optionMap.values()].sort((a, b) => (a.displayOrder ?? Infinity) - (b.displayOrder ?? Infinity) || a.id - b.id),\n      children: [],\n    });\n    const children = childSources.get(key) ?? [];\n    if (raw.sub_assessment_question_list != null) children.push(raw.sub_assessment_question_list);\n    for (const record of rows(raw.sub_assessment_answer_list ?? [])) if (record.sub_assessment_list != null) children.push(record.sub_assessment_list);\n    childSources.set(key, children);\n  }\n  for (const [key, question] of merged) question.children = mergeQuestions(childSources.get(key) ?? [], depth + 1);\n  return [...merged.values()].sort((a, b) => (a.displayOrder ?? Infinity) - (b.displayOrder ?? Infinity) || a.questionId - b.questionId);\n}\n\nexport function flattenQuestions(questions: readonly QuestionDefinition[], parent: readonly string[] = []): QuestionEntry[] {\n  return questions.flatMap(question => {\n    const path = [...parent, question.fieldName ?? `#${question.questionId}`];\n    return [{ path, question }, ...flattenQuestions(question.children, path)];\n  });\n}\n\n/** Only metadata fields are copied; no answers, client IDs, recordsets, or staff IDs survive. */\nexport function buildAssessmentDefinition(input: { tenant: string; assessmentCode: string; effectiveDate?: string; mobile: unknown; generic: unknown }): AssessmentDefinition {\n  const questions = mergeQuestions([input.mobile, input.generic]);\n  if (!questions.length) throw new WellSkyError(\"protocol\", \"assessment metadata\");\n  return { tenant: input.tenant, assessmentCode: input.assessmentCode, effectiveDate: input.effectiveDate ?? null, retrievedAt: new Date().toISOString(), picklistEffectiveDate: \"current\", questions, unresolvedPicklists: flattenQuestions(questions).filter(({ question }) => question.questionType === \"lookup\" && !question.options.length).map(({ path }) => path.join(\"/\")) };\n}\n\nexport function compareDefinition(expected: DefinitionExpectation, definition: AssessmentDefinition): DefinitionDrift {\n  const old = new Map(expected.questions.map(q => [JSON.stringify(q.path), q]));\n  const current = new Map(flattenQuestions(definition.questions).map(q => [JSON.stringify(q.path), q]));\n  const added: string[] = [], removed: string[] = [], retyped: string[] = [], newlyMandatory: string[] = [];\n  for (const [key, entry] of current) {\n    const previous = old.get(key);\n    if (!previous) added.push(entry.path.join(\"/\"));\n    if (previous && previous.questionType !== entry.question.questionType) retyped.push(entry.path.join(\"/\"));\n    if (entry.question.mandatory === true && previous?.mandatory !== true) newlyMandatory.push(entry.path.join(\"/\"));\n  }\n  for (const [key, entry] of old) if (!current.has(key)) removed.push(entry.path.join(\"/\"));\n  return { breaking: Boolean(removed.length || retyped.length || newlyMandatory.length), added, removed, retyped, newlyMandatory };\n}\n\nexport function resolvePicklistOption(question: QuestionDefinition, selector: PicklistSelector): PicklistOption {\n  let found = selector.code === undefined ? [] : question.options.filter(option => option.code === selector.code);\n  if (!found.length && selector.name !== undefined) found = question.options.filter(option => option.name?.trim() === selector.name?.trim());\n  if (found.length !== 1 || !found[0]) throw new UnknownPicklistValueError(question.fieldName ?? `#${question.questionId}`);\n  return structuredClone(found[0]);\n}\n\nexport class AssessmentMetadata {\n  readonly #source: MetadataSource;\n  readonly #tenant: string;\n  readonly #ttl: number;\n  readonly #max: number;\n  readonly #cache = new Map<string, { expires: number; value: AssessmentDefinition }>();\n  constructor(tenant: string, source: MetadataSource, ttlMs = 60_000, maxEntries = 100) {\n    if (!Number.isSafeInteger(ttlMs) || ttlMs < 0 || !Number.isSafeInteger(maxEntries) || maxEntries < 1) throw new ValidationError(\"metadata configuration\");\n    this.#tenant = tenant; this.#source = source; this.#ttl = ttlMs; this.#max = maxEntries;\n  }\n  async getDefinition(context: AssessmentContext): Promise<AssessmentDefinition> {\n    context.signal?.throwIfAborted();\n    if (!Number.isSafeInteger(context.clientId) || context.clientId < 1 || !context.assessmentCode) throw new ValidationError(\"assessment metadata\", [\"clientId\", \"assessmentCode\"]);\n    const key = JSON.stringify([context.clientId, context.assessmentCode, context.effectiveDate ?? null]);\n    const cached = this.#cache.get(key);\n    if (!context.refresh && cached && cached.expires > Date.now()) return structuredClone(cached.value);\n    const [mobile, generic] = await Promise.all([this.#source.mobile(context), this.#source.generic(context)]);\n    context.signal?.throwIfAborted();\n    const value = buildAssessmentDefinition({ tenant: this.#tenant, assessmentCode: context.assessmentCode, ...(context.effectiveDate === undefined ? {} : { effectiveDate: context.effectiveDate }), mobile, generic });\n    this.#cache.delete(key);\n    if (this.#cache.size >= this.#max) { const first = this.#cache.keys().next().value; if (first !== undefined) this.#cache.delete(first); }\n    this.#cache.set(key, { expires: Date.now() + this.#ttl, value });\n    return structuredClone(value);\n  }\n  async listQuestions(context: AssessmentContext): Promise<QuestionEntry[]> { return flattenQuestions((await this.getDefinition(context)).questions); }\n  async getQuestion(context: AssessmentContext & QuestionReference): Promise<QuestionDefinition> {\n    const matches = (await this.listQuestions(context)).filter(entry => entry.question.fieldName === context.fieldName && (context.parentPath === undefined || JSON.stringify(entry.path.slice(0, -1)) === JSON.stringify(context.parentPath)));\n    if (matches.length !== 1 || !matches[0]) throw new ValidationError(\"question resolution\", [context.fieldName]);\n    return matches[0].question;\n  }\n  async listPicklists(context: AssessmentContext): Promise<PicklistDefinition[]> {\n    return (await this.listQuestions(context)).filter(({ question }) => question.questionType === \"lookup\" || question.options.length).map(({ path, question }) => ({ picklistId: question.picklistId, questionPath: path, options: question.options, status: question.options.length ? \"enumerated\" : \"unresolved\" }));\n  }\n  async resolve(context: AssessmentContext & QuestionReference & PicklistSelector): Promise<PicklistOption> { return resolvePicklistOption(await this.getQuestion(context), context); }\n  clearCache(): void { this.#cache.clear(); }\n}\n"]}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/program-discovery.d.ts

@@ -0,0 +1,28 @@
+import type { WellSkyClient } from "./generated/v3.js";
+import type { Provider } from "./generated/v3-models.js";
+import type { RequestOptions } from "./runtime.js";
+export interface ProgramCatalogReader {
+    providers: Pick<WellSkyClient["providers"], "list">;
+}
+export interface ProgramCatalogRequest extends RequestOptions {
+    /** Optional immediate parent filter; this does not recursively include descendants. */
+    parentProviderId?: number;
+    /** Default true. Inactive/nonoperational records are omitted even if the server ignores filters. */
+    availableOnly?: boolean;
+    /** Stop with an error rather than return an incomplete catalog. Default 100 pages. */
+    maxPages?: number;
+}
+export interface ProgramCatalog {
+    source: "rest-providers";
+    /** Providers include agencies and parent organizations, not only enrollable programs.
+     * Visibility here does not prove the caller may enroll or record services at a provider. */
+    providers: Provider[];
+    /** Provider 0 is the vendor/system record, not an application program choice. */
+    excludedSystemProviderIds: number[];
+    retrievedAt: string;
+    assessmentAssignments: "requires-browser-discovery";
+}
+/** Uses the provider route's counted {count, values} envelope. That route returns 404
+ * beyond its final page, so generic empty-page pagination cannot prove completion. */
+export declare function readProgramCatalog(client: ProgramCatalogReader, options?: ProgramCatalogRequest): Promise<ProgramCatalog>;
+//# sourceMappingURL=program-discovery.d.ts.map

package/dist/cjs/program-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program-discovery.d.ts","sourceRoot":"","sources":["../../src/program-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAKnD,MAAM,WAAW,oBAAoB;IAAG,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE;AAC7F,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oGAAoG;IACpG,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,gBAAgB,CAAC;IACzB;gGAC4F;IAC5F,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,iFAAiF;IACjF,yBAAyB,EAAE,MAAM,EAAE,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,4BAA4B,CAAC;CACrD;AAWD;sFACsF;AACtF,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,cAAc,CAAC,CA4BnI"}

package/dist/cjs/program-discovery.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readProgramCatalog = readProgramCatalog;
+const runtime_js_1 = require("./runtime.js");
+const errors_js_1 = require("./errors.js");
+const validation_js_1 = require("./validation.js");
+function catalogProvider(value) {
+    if (!(0, validation_js_1.isRecord)(value) || typeof value.providerId !== "number" || !Number.isSafeInteger(value.providerId) || value.providerId < 0 ||
+        typeof value.providerName !== "string" || typeof value.active !== "boolean" || typeof value.operational !== "boolean" || typeof value.hudCompliant !== "boolean" ||
+        !(value.parentProviderID === null || (typeof value.parentProviderID === "number" && Number.isSafeInteger(value.parentProviderID) && value.parentProviderID >= 0)) ||
+        !(value.providerGrantType === null || typeof value.providerGrantType === "string") || typeof value.dateAdded !== "string" || typeof value.dateUpdated !== "string")
+        throw new runtime_js_1.WellSkyError("protocol", "program catalog");
+    return { providerId: value.providerId, providerName: value.providerName, active: value.active, operational: value.operational, hudCompliant: value.hudCompliant,
+        parentProviderID: value.parentProviderID, providerGrantType: value.providerGrantType, dateAdded: value.dateAdded, dateUpdated: value.dateUpdated };
+}
+/** Uses the provider route's counted {count, values} envelope. That route returns 404
+ * beyond its final page, so generic empty-page pagination cannot prove completion. */
+async function readProgramCatalog(client, options = {}) {
+    const { parentProviderId, availableOnly = true, maxPages = 100, ...request } = options;
+    if ((parentProviderId !== undefined && (!Number.isSafeInteger(parentProviderId) || parentProviderId < 1)) ||
+        typeof availableOnly !== "boolean" || !Number.isSafeInteger(maxPages) || maxPages < 1)
+        throw new errors_js_1.ValidationError("program catalog");
+    request.signal?.throwIfAborted();
+    // The live providerId sort and parentProviderID query aliases are broken upstream.
+    // Retain the server default order and filter the immediate parent locally.
+    const providers = [], ids = new Set(), excludedSystemProviderIds = [];
+    let expectedCount;
+    for (let page = 1; page <= maxPages; page++) {
+        const response = await client.providers.list({ ...request, query: { perPage: 100, startPage: page, total_count: true, ...(availableOnly ? { query: "active eq true and operational eq true" } : {}) } });
+        request.signal?.throwIfAborted();
+        if (!(0, validation_js_1.isRecord)(response) || typeof response.count !== "number" || !Number.isSafeInteger(response.count) || response.count < 0 || !Array.isArray(response.values))
+            throw new runtime_js_1.WellSkyError("protocol", "program catalog");
+        if (expectedCount !== undefined && response.count !== expectedCount)
+            throw new runtime_js_1.WellSkyError("protocol", "program catalog changed during pagination");
+        expectedCount = response.count;
+        for (const raw of response.values) {
+            const provider = catalogProvider(raw);
+            if (ids.has(provider.providerId))
+                throw new runtime_js_1.WellSkyError("protocol", "program catalog duplicate provider");
+            ids.add(provider.providerId);
+            if (provider.providerId === 0) {
+                excludedSystemProviderIds.push(0);
+                continue;
+            }
+            if (availableOnly && (provider.active !== true || provider.operational !== true))
+                continue;
+            if (parentProviderId !== undefined && provider.parentProviderID !== parentProviderId)
+                continue;
+            providers.push(provider);
+        }
+        if (ids.size > expectedCount || (!response.values.length && ids.size !== expectedCount))
+            throw new runtime_js_1.WellSkyError("protocol", "program catalog incomplete");
+        if (ids.size === expectedCount)
+            return { source: "rest-providers", providers, excludedSystemProviderIds, retrievedAt: new Date().toISOString(), assessmentAssignments: "requires-browser-discovery" };
+    }
+    throw new runtime_js_1.WellSkyError("pagination", "program catalog");
+}
+//# sourceMappingURL=program-discovery.js.map

package/dist/cjs/program-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program-discovery.js","sourceRoot":"","sources":["../../src/program-discovery.ts"],"names":[],"mappings":"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","sourcesContent":["import type { WellSkyClient } from \"./generated/v3.js\";\nimport type { Provider } from \"./generated/v3-models.js\";\nimport type { RequestOptions } from \"./runtime.js\";\nimport { WellSkyError } from \"./runtime.js\";\nimport { ValidationError } from \"./errors.js\";\nimport { isRecord } from \"./validation.js\";\n\nexport interface ProgramCatalogReader { providers: Pick<WellSkyClient[\"providers\"], \"list\"> }\nexport interface ProgramCatalogRequest extends RequestOptions {\n  /** Optional immediate parent filter; this does not recursively include descendants. */\n  parentProviderId?: number;\n  /** Default true. Inactive/nonoperational records are omitted even if the server ignores filters. */\n  availableOnly?: boolean;\n  /** Stop with an error rather than return an incomplete catalog. Default 100 pages. */\n  maxPages?: number;\n}\nexport interface ProgramCatalog {\n  source: \"rest-providers\";\n  /** Providers include agencies and parent organizations, not only enrollable programs.\n   * Visibility here does not prove the caller may enroll or record services at a provider. */\n  providers: Provider[];\n  /** Provider 0 is the vendor/system record, not an application program choice. */\n  excludedSystemProviderIds: number[];\n  retrievedAt: string;\n  assessmentAssignments: \"requires-browser-discovery\";\n}\n\nfunction catalogProvider(value: unknown): Provider & { providerId: number } {\n  if (!isRecord(value) || typeof value.providerId !== \"number\" || !Number.isSafeInteger(value.providerId) || value.providerId < 0 ||\n      typeof value.providerName !== \"string\" || typeof value.active !== \"boolean\" || typeof value.operational !== \"boolean\" || typeof value.hudCompliant !== \"boolean\" ||\n      !(value.parentProviderID === null || (typeof value.parentProviderID === \"number\" && Number.isSafeInteger(value.parentProviderID) && value.parentProviderID >= 0)) ||\n      !(value.providerGrantType === null || typeof value.providerGrantType === \"string\") || typeof value.dateAdded !== \"string\" || typeof value.dateUpdated !== \"string\") throw new WellSkyError(\"protocol\", \"program catalog\");\n  return {providerId:value.providerId, providerName:value.providerName, active:value.active, operational:value.operational, hudCompliant:value.hudCompliant,\n    parentProviderID:value.parentProviderID, providerGrantType:value.providerGrantType, dateAdded:value.dateAdded, dateUpdated:value.dateUpdated};\n}\n\n/** Uses the provider route's counted {count, values} envelope. That route returns 404\n * beyond its final page, so generic empty-page pagination cannot prove completion. */\nexport async function readProgramCatalog(client: ProgramCatalogReader, options: ProgramCatalogRequest = {}): Promise<ProgramCatalog> {\n  const { parentProviderId, availableOnly = true, maxPages = 100, ...request } = options;\n  if ((parentProviderId !== undefined && (!Number.isSafeInteger(parentProviderId) || parentProviderId < 1)) ||\n      typeof availableOnly !== \"boolean\" || !Number.isSafeInteger(maxPages) || maxPages < 1) throw new ValidationError(\"program catalog\");\n  request.signal?.throwIfAborted();\n  // The live providerId sort and parentProviderID query aliases are broken upstream.\n  // Retain the server default order and filter the immediate parent locally.\n  const providers: Provider[] = [], ids = new Set<number>(), excludedSystemProviderIds: number[] = [];\n  let expectedCount: number | undefined;\n  for (let page = 1; page <= maxPages; page++) {\n    const response: unknown = await client.providers.list({...request, query:{perPage:100,startPage:page,total_count:true,...(availableOnly?{query:\"active eq true and operational eq true\"}:{})}});\n    request.signal?.throwIfAborted();\n    if (!isRecord(response) || typeof response.count !== \"number\" || !Number.isSafeInteger(response.count) || response.count < 0 || !Array.isArray(response.values)) throw new WellSkyError(\"protocol\", \"program catalog\");\n    if (expectedCount !== undefined && response.count !== expectedCount) throw new WellSkyError(\"protocol\", \"program catalog changed during pagination\");\n    expectedCount = response.count;\n    for (const raw of response.values) {\n      const provider = catalogProvider(raw);\n      if (ids.has(provider.providerId)) throw new WellSkyError(\"protocol\", \"program catalog duplicate provider\");\n      ids.add(provider.providerId);\n      if (provider.providerId === 0) { excludedSystemProviderIds.push(0); continue; }\n      if (availableOnly && (provider.active !== true || provider.operational !== true)) continue;\n      if (parentProviderId !== undefined && provider.parentProviderID !== parentProviderId) continue;\n      providers.push(provider);\n    }\n    if (ids.size > expectedCount || (!response.values.length && ids.size !== expectedCount)) throw new WellSkyError(\"protocol\", \"program catalog incomplete\");\n    if (ids.size === expectedCount) return {source:\"rest-providers\", providers, excludedSystemProviderIds, retrievedAt:new Date().toISOString(), assessmentAssignments:\"requires-browser-discovery\"};\n  }\n  throw new WellSkyError(\"pagination\", \"program catalog\");\n}\n"]}

package/dist/cjs/race.d.ts

@@ -0,0 +1,4 @@
+import type { PicklistOption, PicklistSelector, QuestionDefinition } from "./metadata.js";
+/** HUD race is stored as one combination option, including single-category answers. */
+export declare function resolveRaceCombination(question: QuestionDefinition, selectors: readonly PicklistSelector[]): PicklistOption;
+//# sourceMappingURL=race.d.ts.map

package/dist/cjs/race.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"race.d.ts","sourceRoot":"","sources":["../../src/race.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAO1F,uFAAuF;AACvF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,gBAAgB,EAAE,GAAG,cAAc,CAwB3H"}

package/dist/cjs/race.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRaceCombination = resolveRaceCombination;
+const metadata_js_1 = require("./metadata.js");
+const errors_js_1 = require("./errors.js");
+const categories = ["AIAN", "ASN", "AFR", "HSP", "MES", "PI", "WHI"];
+const missing = new Map([["DONTKNOW", "DK"], ["REFUSE", "R"], ["DNC", "DNC"], ["DK", "DK"], ["R", "R"]]);
+/** HUD race is stored as one combination option, including single-category answers. */
+function resolveRaceCombination(question, selectors) {
+    const field = question.fieldName ?? "HUD_RACEETHNICITY";
+    if (!selectors.length)
+        throw new errors_js_1.ValidationError("race selection must not be empty", [field]);
+    const combinations = question.options.filter(option => option.code?.startsWith("RACE_ETH_COMBO_"));
+    const selected = new Set();
+    for (const selector of selectors) {
+        // Names can occur twice in metadata. Only the combination entry is a writable answer.
+        const option = selector.code === undefined
+            ? (0, metadata_js_1.resolvePicklistOption)({ ...question, options: combinations }, selector)
+            : (0, metadata_js_1.resolvePicklistOption)(question, { code: selector.code });
+        const code = option.code;
+        if (!code?.startsWith("RACE_ETH_"))
+            throw new errors_js_1.ValidationError("unsupported race option", [field]);
+        const suffix = code.slice(code.startsWith("RACE_ETH_COMBO_") ? "RACE_ETH_COMBO_".length : "RACE_ETH_".length);
+        const missingCode = missing.get(suffix);
+        if (missingCode)
+            selected.add(missingCode);
+        else
+            for (const category of suffix.split("_")) {
+                if (!categories.includes(category))
+                    throw new errors_js_1.ValidationError("unsupported race option", [field]);
+                selected.add(category);
+            }
+    }
+    const absent = [...selected].filter(code => !categories.includes(code));
+    if (absent.length && selected.size !== 1)
+        throw new errors_js_1.ValidationError("race categories cannot be mixed with missing-answer states", [field]);
+    const suffix = absent.length ? absent[0] : categories.filter(code => selected.has(code)).join("_");
+    return (0, metadata_js_1.resolvePicklistOption)({ ...question, options: combinations }, { code: `RACE_ETH_COMBO_${suffix}` });
+}
+//# sourceMappingURL=race.js.map

package/dist/cjs/race.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"race.js","sourceRoot":"","sources":["../../src/race.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\";\n\nconst categories = [\"AIAN\", \"ASN\", \"AFR\", \"HSP\", \"MES\", \"PI\", \"WHI\"];\nconst missing = new Map([[\"DONTKNOW\", \"DK\"], [\"REFUSE\", \"R\"], [\"DNC\", \"DNC\"], [\"DK\", \"DK\"], [\"R\", \"R\"]]);\n\n/** HUD race is stored as one combination option, including single-category answers. */\nexport function resolveRaceCombination(question: QuestionDefinition, selectors: readonly PicklistSelector[]): PicklistOption {\n  const field = question.fieldName ?? \"HUD_RACEETHNICITY\";\n  if (!selectors.length) throw new ValidationError(\"race selection must not be empty\", [field]);\n  const combinations = question.options.filter(option => option.code?.startsWith(\"RACE_ETH_COMBO_\"));\n  const selected = new Set<string>();\n  for (const selector of selectors) {\n    // Names can occur twice in metadata. Only the combination entry is a writable answer.\n    const option = selector.code === undefined\n      ? resolvePicklistOption({ ...question, options: combinations }, selector)\n      : resolvePicklistOption(question, { code: selector.code });\n    const code = option.code;\n    if (!code?.startsWith(\"RACE_ETH_\")) throw new ValidationError(\"unsupported race option\", [field]);\n    const suffix = code.slice(code.startsWith(\"RACE_ETH_COMBO_\") ? \"RACE_ETH_COMBO_\".length : \"RACE_ETH_\".length);\n    const missingCode = missing.get(suffix);\n    if (missingCode) selected.add(missingCode);\n    else for (const category of suffix.split(\"_\")) {\n      if (!categories.includes(category)) throw new ValidationError(\"unsupported race option\", [field]);\n      selected.add(category);\n    }\n  }\n  const absent = [...selected].filter(code => !categories.includes(code));\n  if (absent.length && selected.size !== 1) throw new ValidationError(\"race categories cannot be mixed with missing-answer states\", [field]);\n  const suffix = absent.length ? absent[0] : categories.filter(code => selected.has(code)).join(\"_\");\n  return resolvePicklistOption({ ...question, options: combinations }, { code: `RACE_ETH_COMBO_${suffix}` });\n}\n"]}

package/dist/cjs/runtime.d.ts

@@ -0,0 +1,108 @@
+/** Matching credentials/providers share cached authentication in-process. No environment or disk reads. */
+export type Authentication = {
+    kind: "credentials";
+    username: string;
+    password: string;
+} | {
+    kind: "token";
+    token: string;
+} | {
+    kind: "provider";
+    getToken: (context: {
+        forceRefresh: boolean;
+        signal: AbortSignal;
+    }) => string | Promise<string>;
+} | {
+    kind: "none";
+};
+export interface ClientOptions {
+    tenant: string;
+    auth: Authentication;
+    maxConcurrency?: number;
+    cooldown?: {
+        threshold: number;
+        windowMs: number;
+        durationMs: number;
+    };
+    hooks?: ClientHooks;
+    /** Receives the same allowlisted events as hooks. No raw request/response data. */
+    logger?: (event: ClientEvent) => void;
+    metadataCacheTtlMs?: number;
+    metadataCacheMaxEntries?: number;
+    /** Opt-in correction for a measured upstream mobile assessment dateEffective shift.
+     * Added to the requested instant on POST AddAssessmentAnswer only. No default timezone is assumed.
+     * Revalidate against saved effective dates when the server's offset changes. */
+    mobileAssessmentDateCorrectionMinutes?: number;
+    /** Defaults to the public production API URL. Supply the target environment explicitly when needed. */
+    baseUrl?: string;
+    /** Inject a fetch-compatible transport for tests or network routing. */
+    fetch?: typeof globalThis.fetch;
+    /** Total request deadline including auth, read retries, and backoff. Default 30 seconds. */
+    timeoutMs?: number;
+    /** Additional attempts for GET only. Default 2; writes are never replayed. */
+    maxReadRetries?: number;
+    retryBaseDelayMs?: number;
+    maxRetryDelayMs?: number;
+}
+export interface RequestOptions {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    correlationId?: string;
+}
+export interface ClientEvent {
+    type: "request" | "response" | "tokenMint" | "throttle" | "cooldown";
+    operation: string;
+    correlationId: string;
+    retryCount: number;
+    durationMs?: number;
+    status?: number;
+    retryAfterMs?: number;
+    until?: string;
+}
+export interface ClientHooks {
+    onRequest?: (event: ClientEvent) => void;
+    onResponse?: (event: ClientEvent) => void;
+    onTokenMint?: (event: ClientEvent) => void;
+    onThrottle?: (event: ClientEvent) => void;
+    onCooldown?: (event: ClientEvent) => void;
+}
+export interface ClientHealth {
+    state: "closed" | "open";
+    until: string | null;
+    activeRequests: number;
+    queuedRequests: number;
+    tokenMintCount: number;
+}
+export interface PaginationOptions {
+    /** Safety limit. Reaching it throws rather than silently returning partial data. Default 10,000. */
+    maxPages?: number;
+}
+export interface ODataCollection<T> {
+    value: T[];
+    "@odata.count"?: number;
+    "@odata.nextLink"?: string;
+}
+/** WellSky's total_count response. Count covers the result set, not just this page. */
+export interface CountedCollection<T> {
+    count: number;
+    values: T[];
+}
+/** WellSky may return an object, an array, or either collection envelope for the same model. */
+export type ApiResponse<T> = T | T[] | ODataCollection<T> | CountedCollection<T> | null;
+export declare function toItems<T>(response: ApiResponse<T>): T[];
+export type ErrorKind = "http" | "network" | "timeout" | "aborted" | "validation" | "protocol" | "pagination" | "tenant_mismatch" | "auth" | "throttled" | "cooldown" | "ambiguous_commit" | "definition_drift" | "unknown_picklist_value";
+/** Deliberately contains no credentials, query values, response bodies, or client IDs. */
+export declare class WellSkyError extends Error {
+    readonly kind: ErrorKind;
+    readonly status: number | undefined;
+    readonly operation: string;
+    readonly requestId: string | undefined;
+    readonly retryAfterMs: number | undefined;
+    correlationId: string | undefined;
+    constructor(kind: ErrorKind, operation: string, details?: {
+        status?: number;
+        requestId?: string;
+        retryAfterMs?: number;
+    });
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/cjs/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime.ts"],"names":[],"mappings":"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"}

package/dist/cjs/runtime.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WellSkyError = void 0;
+exports.toItems = toItems;
+function toItems(response) {
+    if (response === null)
+        return [];
+    if (Array.isArray(response))
+        return response;
+    if (typeof response === "object" && "value" in response && Array.isArray(response.value)) {
+        return response.value;
+    }
+    if (typeof response === "object" && "count" in response && "values" in response && Array.isArray(response.values)) {
+        return response.values;
+    }
+    // The envelope branch above has been checked at the boundary.
+    return [response];
+}
+/** Deliberately contains no credentials, query values, response bodies, or client IDs. */
+class WellSkyError extends Error {
+    kind;
+    status;
+    operation;
+    requestId;
+    retryAfterMs;
+    correlationId;
+    constructor(kind, operation, details = {}) {
+        super(`WellSky ${operation}: ${kind}${details.status === undefined ? "" : ` (HTTP ${details.status})`}`);
+        this.name = "WellSkyError";
+        this.kind = kind;
+        this.operation = operation;
+        this.status = details.status;
+        this.requestId = details.requestId;
+        this.retryAfterMs = details.retryAfterMs;
+    }
+}
+exports.WellSkyError = WellSkyError;
+//# sourceMappingURL=runtime.js.map

package/dist/cjs/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/runtime.ts"],"names":[],"mappings":";;;AAqFA,0BAWC;AAXD,SAAgB,OAAO,CAAI,QAAwB;IACjD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC7C,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,IAAI,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzF,OAAO,QAAQ,CAAC,KAAK,CAAC;IACxB,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,IAAI,QAAQ,IAAI,QAAQ,IAAI,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAClH,OAAO,QAAQ,CAAC,MAAM,CAAC;IACzB,CAAC;IACD,8DAA8D;IAC9D,OAAO,CAAC,QAAa,CAAC,CAAC;AACzB,CAAC;AAID,0FAA0F;AAC1F,MAAa,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAY;IAChB,MAAM,CAAqB;IAC3B,SAAS,CAAS;IAClB,SAAS,CAAqB;IAC9B,YAAY,CAAqB;IAC1C,aAAa,CAAqB;IAElC,YAAY,IAAe,EAAE,SAAiB,EAAE,UAA0E,EAAE;QAC1H,KAAK,CAAC,WAAW,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QACzG,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C,CAAC;CACF;AAjBD,oCAiBC","sourcesContent":["/** Matching credentials/providers share cached authentication in-process. No environment or disk reads. */\nexport type Authentication =\n  | { kind: \"credentials\"; username: string; password: string }\n  | { kind: \"token\"; token: string }\n  | { kind: \"provider\"; getToken: (context: { forceRefresh: boolean; signal: AbortSignal }) => string | Promise<string> }\n  | { kind: \"none\" };\n\nexport interface ClientOptions {\n  tenant: string;\n  auth: Authentication;\n\n  maxConcurrency?: number;\n  cooldown?: { threshold: number; windowMs: number; durationMs: number };\n  hooks?: ClientHooks;\n  /** Receives the same allowlisted events as hooks. No raw request/response data. */\n  logger?: (event: ClientEvent) => void;\n  metadataCacheTtlMs?: number;\n  metadataCacheMaxEntries?: number;\n  /** Opt-in correction for a measured upstream mobile assessment dateEffective shift.\n   * Added to the requested instant on POST AddAssessmentAnswer only. No default timezone is assumed.\n   * Revalidate against saved effective dates when the server's offset changes. */\n  mobileAssessmentDateCorrectionMinutes?: number;\n  /** Defaults to the public production API URL. Supply the target environment explicitly when needed. */\n  baseUrl?: string;\n  /** Inject a fetch-compatible transport for tests or network routing. */\n  fetch?: typeof globalThis.fetch;\n  /** Total request deadline including auth, read retries, and backoff. Default 30 seconds. */\n  timeoutMs?: number;\n  /** Additional attempts for GET only. Default 2; writes are never replayed. */\n  maxReadRetries?: number;\n  retryBaseDelayMs?: number;\n  maxRetryDelayMs?: number;\n}\n\nexport interface RequestOptions {\n  signal?: AbortSignal;\n  timeoutMs?: number;\n  correlationId?: string;\n}\n\nexport interface ClientEvent {\n  type: \"request\" | \"response\" | \"tokenMint\" | \"throttle\" | \"cooldown\";\n  operation: string;\n  correlationId: string;\n  retryCount: number;\n  durationMs?: number;\n  status?: number;\n  retryAfterMs?: number;\n  until?: string;\n}\nexport interface ClientHooks {\n  onRequest?: (event: ClientEvent) => void;\n  onResponse?: (event: ClientEvent) => void;\n  onTokenMint?: (event: ClientEvent) => void;\n  onThrottle?: (event: ClientEvent) => void;\n  onCooldown?: (event: ClientEvent) => void;\n}\nexport interface ClientHealth {\n  state: \"closed\" | \"open\";\n  until: string | null;\n  activeRequests: number;\n  queuedRequests: number;\n  tokenMintCount: number;\n}\n\nexport interface PaginationOptions {\n  /** Safety limit. Reaching it throws rather than silently returning partial data. Default 10,000. */\n  maxPages?: number;\n}\n\nexport interface ODataCollection<T> {\n  value: T[];\n  \"@odata.count\"?: number;\n  \"@odata.nextLink\"?: string;\n}\n\n/** WellSky's total_count response. Count covers the result set, not just this page. */\nexport interface CountedCollection<T> {\n  count: number;\n  values: T[];\n}\n\n/** WellSky may return an object, an array, or either collection envelope for the same model. */\nexport type ApiResponse<T> = T | T[] | ODataCollection<T> | CountedCollection<T> | null;\n\nexport function toItems<T>(response: ApiResponse<T>): T[] {\n  if (response === null) return [];\n  if (Array.isArray(response)) return response;\n  if (typeof response === \"object\" && \"value\" in response && Array.isArray(response.value)) {\n    return response.value;\n  }\n  if (typeof response === \"object\" && \"count\" in response && \"values\" in response && Array.isArray(response.values)) {\n    return response.values;\n  }\n  // The envelope branch above has been checked at the boundary.\n  return [response as T];\n}\n\nexport type ErrorKind = \"http\" | \"network\" | \"timeout\" | \"aborted\" | \"validation\" | \"protocol\" | \"pagination\" | \"tenant_mismatch\" | \"auth\" | \"throttled\" | \"cooldown\" | \"ambiguous_commit\" | \"definition_drift\" | \"unknown_picklist_value\";\n\n/** Deliberately contains no credentials, query values, response bodies, or client IDs. */\nexport class WellSkyError extends Error {\n  readonly kind: ErrorKind;\n  readonly status: number | undefined;\n  readonly operation: string;\n  readonly requestId: string | undefined;\n  readonly retryAfterMs: number | undefined;\n  correlationId: string | undefined;\n\n  constructor(kind: ErrorKind, operation: string, details: { status?: number; requestId?: string; retryAfterMs?: number } = {}) {\n    super(`WellSky ${operation}: ${kind}${details.status === undefined ? \"\" : ` (HTTP ${details.status})`}`);\n    this.name = \"WellSkyError\";\n    this.kind = kind;\n    this.operation = operation;\n    this.status = details.status;\n    this.requestId = details.requestId;\n    this.retryAfterMs = details.retryAfterMs;\n  }\n}\n"]}

package/dist/cjs/subassessments.d.ts

@@ -0,0 +1,29 @@
+import type { RequestOptions } from "./runtime.js";
+import type { WriteResult } from "./verification.js";
+import type { AddSubAssessmentQuestionWithAnswerViewModel } from "./generated/v3-models.js";
+export interface SubassessmentContext extends RequestOptions {
+    clientId: number;
+    assessmentCode: string;
+    effectiveDate?: string;
+}
+export interface EndDateRequest extends SubassessmentContext {
+    parentField: string;
+    recordsetId: number;
+    endDateField: string;
+    endDate: string;
+    /** Optional caller preflight for program-specific review-date or other policies. */
+    preflight?: (options: RequestOptions) => Promise<void>;
+}
+export interface SubassessmentSource {
+    read: (context: SubassessmentContext) => Promise<unknown>;
+    write: (context: SubassessmentContext, body: AddSubAssessmentQuestionWithAnswerViewModel[]) => Promise<unknown>;
+}
+/** Generic recordset editing; no program names, assessment codes, or replacement policy. */
+export declare class SubassessmentEditor {
+    #private;
+    constructor(tenant: string, source: SubassessmentSource);
+    setEndDate(input: EndDateRequest): Promise<WriteResult<{
+        recordsetId: number;
+    }>>;
+}
+//# sourceMappingURL=subassessments.d.ts.map

package/dist/cjs/subassessments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subassessments.d.ts","sourceRoot":"","sources":["../../src/subassessments.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,2CAA2C,EAAE,MAAM,0BAA0B,CAAC;AAE5F,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AACD,MAAM,WAAW,cAAe,SAAQ,oBAAoB;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AACD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1D,KAAK,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,IAAI,EAAE,2CAA2C,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACjH;AA8BD,4FAA4F;AAC5F,qBAAa,mBAAmB;;gBAGlB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB;IAEjD,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CA8CvF"}