@choiceapps/communityservices-sdk 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.8.0 - 2026-11-11
+
+- Resolve full lookup write labels without existing answers using `enrollmentSession.readPicklistOptions` and `createCatalogWriteLabelResolver`.
+- Discover labels automatically in enrollment workflows when the configured session supports catalog reads and no explicit `writeLabel` override is supplied, including corrections and mandatory carry-forward.
+- Match option ID, picklist ID and code; preserve full names including HUD suffixes, and reject incomplete or mismatched catalogs before writes. Read explicit option IDs in bounded batches.
+- Read-only training verification matched 1,288 distinct catalog options to Coordinated Entry metadata from three synthetic clients, including the shared enhanced yes/no list and living-situation options. Live profile dropdowns matched the DOB-quality catalog labels. No new assessment writes were performed.
+
 ## 0.7.0 - 2026-11-10
 
 - Add `createReadBackWriteLabelResolver` for exact observed lookup labels, including HUD suffixes. Unobserved options remain unresolved; no suffix is inferred from metadata.

package/browser/enrollment-workflow.d.mts

@@ -1,5 +1,5 @@
 import type {DateOfBirth} from './date-of-birth.mjs';
-import type {Answers, AssessmentDefinition, EncodingOptions, GwtEnrollmentHelpers, Provider, WellSkyClient} from '../dist/esm/index.js';
+import type {PicklistCatalogSnapshot, Answers, AssessmentDefinition, EncodingOptions, GwtEnrollmentHelpers, Provider, WellSkyClient} from '../dist/esm/index.js';
 import type {UiMutationStore,EnrollmentReader} from './index.mjs';
 import type {ProviderAssessmentItem, ProgramDiscovery} from './program-discovery.mjs';
 import type {HouseholdExitUi,HouseholdExitDetailInput} from './household-exit.mjs';
@@ -41,6 +41,8 @@ export interface EnrollmentDiscoveryInput {
   entryDate:string;
 }
 export interface EnrollmentWorkflowDiscovery {
+  /** Current exact label catalog when automatic browser discovery is available. */
+  picklistOptions?:PicklistCatalogSnapshot;
   provider:Provider;
   entry:{assessment:ProviderAssessmentItem;definition:AssessmentDefinition};
   interim:{assessment:ProviderAssessmentItem;definition:AssessmentDefinition};
@@ -254,7 +256,7 @@ export interface EnrollmentWorkflowOptions {
    * `standard` writes them through `assessments.create` with every mandatory answer, after the mobile scalars;
    * every mandatory question must be a lookup. An unfinished journal never reconciles in the other mode. */
   yesNoWrites?:'mobile'|'standard';
-  /** Required for `yesNoWrites: 'standard'`: tenant-verified labels for mandatory lookup answers. */
+  /** Explicit tenant-verified override. When omitted, a configured readPicklistOptions reader supplies exact catalog labels automatically. */
   writeLabel?:EncodingOptions['writeLabel'];
 }
 export class EnrollmentWorkflowError extends Error {

package/browser/enrollment-workflow.mjs

@@ -6,7 +6,7 @@ import {createEntryRowRegistrar} from './entry-row-registration.mjs';
 import {createHouseholdEnrollmentDiscovery} from './household-enrollment-discovery.mjs';
 import {workflowErrorCode} from './workflow-error-codes.mjs';
 import {createHash} from 'node:crypto';
-import {readProgramCatalog,encodeAnswers,encodeNewSubassessmentRow,toItems,parseRestInstant} from '../dist/esm/index.js';
+import {readProgramCatalog,flattenQuestions,createCatalogWriteLabelResolver,encodeAnswers,encodeNewSubassessmentRow,toItems,parseRestInstant} from '../dist/esm/index.js';
 
 const object=v=>v!==null&&typeof v==='object'&&!Array.isArray(v);
 const positive=v=>Number.isSafeInteger(v)&&v>0;
@@ -128,7 +128,7 @@ export function createEnrollmentWorkflow({api,discovery,helpers,store,enrollment
   }
  };
  if(typeof discovery?.getProviderAssessments!=='function'||typeof helpers?.createInterimUpdate!=='function'||!store)fail('REST API, discovery, enrollment helpers and durable store required');
- if(!['mobile','standard'].includes(yesNoWrites)||yesNoWrites==='standard'&&(typeof writeLabel!=='function'||typeof api.assessments?.create!=='function'))fail('yesNoWrites must be mobile, or standard with writeLabel and assessments.create');
+ if(!['mobile','standard'].includes(yesNoWrites)||yesNoWrites==='standard'&&(typeof writeLabel!=='function'&&typeof enrollmentSession?.readPicklistOptions!=='function'||typeof api.assessments?.create!=='function'))fail('yesNoWrites must be mobile, or standard with writeLabel and assessments.create');
  if(!object(assessmentLocations))fail('assessment locations must be a map by Entry/Exit type');
  for(const [type,locations]of Object.entries(assessmentLocations)){
   if(!entryExitTypes.includes(type))fail('unsupported Entry/Exit type in assessment locations');
@@ -149,7 +149,14 @@ export function createEnrollmentWorkflow({api,discovery,helpers,store,enrollment
    if(definition.tenant!==api.tenant||definition.assessmentCode!==assessment.code||definition.unresolvedPicklists.length)fail('assessment metadata incomplete');
    resolved[phase]={assessment,definition};
   }
-  return {provider:providers[0],...resolved};
+  let picklistOptions;
+  if(writeLabel===undefined&&typeof enrollmentSession?.readPicklistOptions==='function'){
+   const optionIds=[...new Set(Object.values(resolved).flatMap(({definition})=>flattenQuestions(definition.questions).filter(({question})=>question.questionType==='lookup').flatMap(({question})=>question.options.map(o=>o.id))))];
+   picklistOptions=await enrollmentSession.readPicklistOptions({clientId:input.clientId,optionIds});
+   if(picklistOptions?.clientId!==input.clientId)fail('picklist catalog client mismatch',{code:'PICKLIST_CATALOG_CONTEXT_MISMATCH'});
+   for(const {definition}of Object.values(resolved))createCatalogWriteLabelResolver(definition,picklistOptions);
+  }
+  return {provider:providers[0],...resolved,...(picklistOptions?{picklistOptions}:{})};
  };
  const scope=clientId=>JSON.stringify([tenantScope,'enrollment-workflow',clientId]);
  const reservationScope=clientId=>JSON.stringify([tenantScope,'household-workflow-reservation',clientId]);
@@ -210,7 +217,8 @@ export function createEnrollmentWorkflow({api,discovery,helpers,store,enrollment
    const definition=discovered[kind].definition,code=definition.assessmentCode,at=kind==='entry'?input.entryDate:(input.exitDate??input.reviewDate);
    const exitSchemaHash=kind==='exit'?hash({assessment:discovered.exit.assessment,questions:definition.questions}):undefined;
    if(record&&kind==='exit'&&record.exitSchemaHash!==exitSchemaHash)fail('exit assessment configuration changed');
-   const plan=compile(definition,input.assessment,{yesNoWrites,writeLabel});
+   const operationWriteLabel=writeLabel??(discovered.picklistOptions?createCatalogWriteLabelResolver(definition,discovered.picklistOptions):undefined);
+   const plan=compile(definition,input.assessment,{yesNoWrites,writeLabel:operationWriteLabel});
    const carriesBirthDate=plan.carry.includes('SVPPROFDOB'),hasBirthDate=plan.dateOfBirth!==undefined||carriesBirthDate;
    let carriedBirthDate;
    if(hasBirthDate){
@@ -266,7 +274,7 @@ export function createEnrollmentWorkflow({api,discovery,helpers,store,enrollment
     const recorded=initial.find(q=>q.virt_field_name===m.virt_field_name)?.answer_value;
     if(m.carry){
      const question=definition.questions.find(q=>q.fieldName===m.virt_field_name),options=question.options.filter(o=>String(o.id)===String(recorded));
-     const label=options.length===1?writeLabel(question,options[0]):undefined;
+     const label=options.length===1?operationWriteLabel?.(question,options[0]):undefined;
      if(!label)fail(`carried mandatory answer ${m.virt_field_name} has no verified write label`,{code:'LOOKUP_WRITE_LABEL_UNAVAILABLE',fields:[m.virt_field_name]});
      if(m.virt_field_name==='HUD_RELATIONTOHOH')checkHeadAnswer(recorded);
      return {question_id:m.question_id,question_type:m.question_type,virt_field_name:m.virt_field_name,answer_value:label,expected:String(recorded)};

package/browser/entry-correction.mjs

@@ -1,5 +1,5 @@
 import {createHash} from 'node:crypto';
-import {encodeAnswers,parseRestInstant,toItems} from '../dist/esm/index.js';
+import {createCatalogWriteLabelResolver,encodeAnswers,parseRestInstant,toItems} from '../dist/esm/index.js';
 
 const object=v=>v!==null&&typeof v==='object'&&!Array.isArray(v);
 const canonical=v=>JSON.stringify(v,(_,x)=>object(x)?Object.fromEntries(Object.keys(x).sort().map(k=>[k,x[k]])):x);
@@ -24,7 +24,7 @@ export function createEntryCorrector({api,store,enrollmentSession,writeLabel,dis
   if(type==='int'||type==='money'){const n=Number(v);if(!Number.isFinite(n))fail('invalid stored correction number');return n;}
   return String(v);
  };
- const encode=(questions,answers,clear,endpoint)=>{
+ const encode=(questions,answers,clear,endpoint,writeLabel)=>{
   if(!object(answers)||!Array.isArray(clear)||new Set(clear).size!==clear.length||clear.some(f=>typeof f!=='string'||Object.hasOwn(answers,f)))fail('invalid or conflicting correction answers and clears');
   const index=new Map(questions.map(q=>[q.fieldName,q]));
   const unsupportedClears=clear.filter(field=>index.get(field)?.questionType==='yes_no');
@@ -94,7 +94,7 @@ export function createEntryCorrector({api,store,enrollmentSession,writeLabel,dis
    const discovered=await discover({clientId:input.clientId,providerId,type,entryDate:at});
    const schemaHash=hash({providerId:discovered.provider.providerId,entry:{assessment:discovered.entry.assessment,questions:discovered.entry.definition.questions},interim:{assessment:discovered.interim.assessment,questions:discovered.interim.definition.questions}});
    if(schemaHash!==entry.schemaHash||record&&schemaHash!==record.schemaHash)fail('program assessment configuration changed');
-   const definition=discovered.entry.definition,code=definition.assessmentCode;
+   const definition=discovered.entry.definition,operationWriteLabel=writeLabel??(discovered.picklistOptions?createCatalogWriteLabelResolver(discovered.entry.definition,discovered.picklistOptions):undefined),code=definition.assessmentCode;
    const snapshot=async()=>{
     const raw=await readQuestions(input.clientId,code,readAt),current=await readQuestions(input.clientId,code,new Date(Math.max(Date.now(),parseRestInstant(readAt))).toISOString());
     const scalars={},rows={};
@@ -145,7 +145,7 @@ export function createEntryCorrector({api,store,enrollmentSession,writeLabel,dis
    if(!record){
     readOverrides(observed);
     const answers=input.answers??{},clear=input.clear??[];
-    const scalarBody=encode(definition.questions,answers,clear,'standalone'),scalarExpected=expected(definition.questions,scalarBody,answers);
+    const scalarBody=encode(definition.questions,answers,clear,'standalone',operationWriteLabel),scalarExpected=expected(definition.questions,scalarBody,answers);
     // The standard endpoint requires every mandatory scalar, even if this patch leaves it unchanged.
     if(scalarBody.length)for(const q of definition.questions.filter(q=>q.mandatory&&!['label','blank','sub_assessment'].includes(q.questionType)&&!scalarBody.some(c=>c.virt_field_name===q.fieldName))){
      if(q.fieldName==='SVPPROFDOB'||!scalarTypes.has(q.questionType))fail('unsupported mandatory correction field');
@@ -153,10 +153,10 @@ export function createEntryCorrector({api,store,enrollmentSession,writeLabel,dis
      if(prior?.answer_value===null||prior?.answer_value===undefined||prior?.answer_value==='')fail('mandatory correction field requires an explicit answer or clear');
      let body;
      if(q.questionType==='lookup'){
-      const options=q.options.filter(o=>String(o.id)===String(prior.answer_value)),label=options.length===1?writeLabel?.(q,options[0]):undefined;
+      const options=q.options.filter(o=>String(o.id)===String(prior.answer_value)),label=options.length===1?operationWriteLabel?.(q,options[0]):undefined;
       if(!label)fail('mandatory correction lookup label unavailable');
       body=[{question_id:q.questionId,question_type:q.questionType,virt_field_name:q.fieldName,answer_value:label}];
-     }else body=encodeAnswers([q],{[q.fieldName]:{value:prior.answer_value}},{endpoint:'standalone',writeLabel});
+     }else body=encodeAnswers([q],{[q.fieldName]:{value:prior.answer_value}},{endpoint:'standalone',writeLabel:operationWriteLabel});
      if(body.length!==1)fail('mandatory correction field could not be encoded');scalarBody.push(body[0]);
      scalarExpected.push({...body[0],answer_value:prior.answer_value});
     }
@@ -165,7 +165,7 @@ export function createEntryCorrector({api,store,enrollmentSession,writeLabel,dis
      fields(patch,['key','parentField','answers','clear']);key(patch.key);
      const id=entry.rows[patch.key],parent=definition.questions.find(q=>q.fieldName===patch.parentField&&q.questionType==='sub_assessment');
      if(!positive(id)||ids.has(id)||!parent||!observed.rows[parent.fieldName]?.[id]||entry.rowParents?.[patch.key]&&entry.rowParents[patch.key]!==patch.parentField)fail('correction requires an existing entry row key and matching parent');ids.add(id);
-     const cells=encode(parent.children,patch.answers??{},patch.clear??[],'mobile');if(!cells.length)fail('empty row correction');
+     const cells=encode(parent.children,patch.answers??{},patch.clear??[],'mobile',operationWriteLabel);if(!cells.length)fail('empty row correction');
      rowPlans.push({id,parentField:parent.fieldName,questionId:parent.questionId,cells});
     }
     if(!scalarBody.length&&!rowPlans.length)fail('empty entry correction');

package/browser/index.d.mts

@@ -1,6 +1,6 @@
 import type {UiConnection,UiConnectionOptions} from './connection.mjs';
 import type {Browser, BrowserContext, BrowserType, Page} from 'playwright-core';
-import type {GwtEnrollmentExit,GwtEnrollmentHelpers,GwtEnrollmentSession,GwtEnrollmentSnapshot,GwtMutationStore} from '../dist/esm/index.js';
+import type {PicklistCatalogSnapshot,GwtEnrollmentExit,GwtEnrollmentHelpers,GwtEnrollmentSession,GwtEnrollmentSnapshot,GwtMutationStore} from '../dist/esm/index.js';
 export interface LoginOptions extends UiConnectionOptions {
   chromium: BrowserType;
   envFile?: string;
@@ -29,12 +29,15 @@ export interface EnrollmentListSnapshot {
 }
 export interface EnrollmentReader {
   readonly connection?:UiConnection;
+  /** Exact full names for explicit REST option IDs; does not read existing answers. */
+  readPicklistOptions?(target:{clientId:number;optionIds:readonly number[]}):Promise<PicklistCatalogSnapshot>;
   readEnrollment(target:{clientId:number;enrollmentId:number}):Promise<PlaywrightEnrollmentSnapshot>;
   /** Built-in sessions supply this complete, counted list, including exited entries.
    * Legacy custom readers without it retain REST list behavior. */
   listEnrollments?(target:{clientId:number}):Promise<EnrollmentListSnapshot>;
 }
 export interface EnrollmentCatalogReader extends EnrollmentReader {
+ readPicklistOptions(target:{clientId:number;optionIds:readonly number[]}):Promise<PicklistCatalogSnapshot>;
  listEnrollments(target:{clientId:number}):Promise<EnrollmentListSnapshot>;
 }
 export function openUiSession(options:LoginOptions):Promise<UiSession>;

package/browser/index.mjs

@@ -10,7 +10,7 @@ export async function openEnrollmentSession({store,...loginOptions}) {
   try {
     const helpers=createPlaywrightEnrollmentHelpers({page:session.page,store,...session.connection});
     const reader=createPlaywrightGwtSession({page:session.page,...session.connection});
-    const enrollmentSession={connection:session.connection,readEnrollment:target=>withPageLock(session.page,()=>reader.readEnrollment(target)),listEnrollments:target=>withPageLock(session.page,()=>reader.listEnrollments(target))};
+    const enrollmentSession={connection:session.connection,readEnrollment:target=>withPageLock(session.page,()=>reader.readEnrollment(target)),listEnrollments:target=>withPageLock(session.page,()=>reader.listEnrollments(target)),readPicklistOptions:target=>withPageLock(session.page,()=>reader.readPicklistOptions(target))};
     return Object.assign(session,{helpers,enrollmentSession,workflows:createClientWorkflows({page:session.page,store})});
   }catch(error){await session.close();throw error;}
 }

package/browser/playwright-session.mjs

@@ -84,10 +84,10 @@ export function createPlaywrightGwtSession({page,tenant,moduleBaseUrl}) {
       try{const r=await fetch(url,{method:'POST',headers,body,credentials:'same-origin',redirect:'error',signal:controller.signal});return {status:r.status,body:await r.text()};}finally{clearTimeout(timer);}
     },request);
   };
-  const mapped=async query=>{
+  const mapped=async(query,limit=1001)=>{
     if(!wire||!/^SELECT /.test(query)||/[|\\\r\n]/.test(query))throw Error('Invalid mapped read');
-    const strings=[moduleBaseUrl,wire.policy,rpcInterface,'getMappedResults','java.lang.String/2004016611','java.util.HashMap/1797211028','I','Z',query+' LIMIT 1001,0'];
-    const body=['7','0',strings.length,...strings,1,2,3,4,5,5,6,7,7,8,9,0,0,1001,1,''].join('|');
+    const strings=[moduleBaseUrl,wire.policy,rpcInterface,'getMappedResults','java.lang.String/2004016611','java.util.HashMap/1797211028','I','Z',query+` LIMIT ${limit},0`];
+    const body=['7','0',strings.length,...strings,1,2,3,4,5,5,6,7,7,8,9,0,0,limit,1,''].join('|');
     const response=await post({url:moduleBaseUrl+'service/MetaQueryService',headers:wire.headers,body});if(response.status!==200)throw Error('Mapped read failed');
     const data=decodeMappedResponse(response.body);if(data.total!==data.rows.length||data.total>1000)throw Error('Incomplete enrollment list');return data.rows;
   };
@@ -100,7 +100,7 @@ export function createPlaywrightGwtSession({page,tenant,moduleBaseUrl}) {
     if(ids.some(n=>!Number.isSafeInteger(n)||n<=0))throw Error('Invalid household tree');
     await closeDialogs();return [...new Set([target.clientId,...ids])].sort((a,b)=>a-b);
   };
-  const listEnrollments=async({clientId})=>{
+  const openReadContext=async clientId=>{
     id(clientId);await guard();wire=undefined;let captured;
     const listener=request=>{
       if(request.url()===moduleBaseUrl+'service/MetaQueryService'&&request.postData()?.startsWith('7|0|')){
@@ -111,6 +111,9 @@ export function createPlaywrightGwtSession({page,tenant,moduleBaseUrl}) {
     page.on('request',listener);
     try{await openClient(clientId);wire=await captured;}finally{page.off('request',listener);}
     if(!wire?.policy||Object.values(wire.headers).some(v=>!v))throw Error('Fresh enrollment list context unavailable');
+  };
+  const listEnrollments=async({clientId})=>{
+    await openReadContext(clientId);
     const rows=await mapped(`SELECT e.entryExitId AS enrollmentId, e.clientId AS clientId, e.entryDate AS projectStartDate, e.exitDate AS projectExitDate, e.providerId AS enrollmentProvider, e.typeEntryExit.name AS type, e.groupId AS groupId FROM SpEntryExit AS e WHERE e.active = TRUE AND e.client.active = TRUE AND e.clientId = ${clientId} ORDER BY e.entryExitId`);
     const ids=new Set();
     for(const row of rows){
@@ -120,6 +123,18 @@ export function createPlaywrightGwtSession({page,tenant,moduleBaseUrl}) {
     }
     return {source:'gwt-rpc',tenant,clientId,count:rows.length,values:rows.map(row=>({...row,isActive:true,grouped:row.groupId!==null}))};
   };
+  const readPicklistOptions=async({clientId,optionIds})=>{
+    id(clientId);if(!Array.isArray(optionIds)||optionIds.length>10000)throw Error('Invalid picklist option IDs');
+    const ids=[...new Set(optionIds.map(id))].sort((a,b)=>a-b),values=[];
+    if(ids.length)await openReadContext(clientId);
+    for(let offset=0;offset<ids.length;offset+=200){
+      const chunk=ids.slice(offset,offset+200);
+      const rows=await mapped(`SELECT v.picklistValueId AS optionId, v.picklistId AS picklistId, v.name AS name, v.code AS code FROM SpPicklistValue AS v WHERE v.picklistValueId IN (${chunk.join(',')}) ORDER BY v.picklistValueId`,200);
+      if(rows.length!==chunk.length||new Set(rows.map(r=>r.optionId)).size!==chunk.length||rows.some(r=>!chunk.includes(r.optionId)||!Number.isSafeInteger(r.picklistId)||r.picklistId<=0||typeof r.name!=='string'||!r.name.trim()||r.code!==null&&typeof r.code!=='string'))throw Error('Incomplete picklist option catalog');
+      values.push(...rows);
+    }
+    return {source:'gwt-rpc',tenant,clientId,count:values.length,values};
+  };
   const readEnrollment=async target=>{
     const model=await openTarget(target),householdClientIds=await householdIds(target);
     const entries=await mapped(`SELECT e.entryExitId AS enrollmentId, e.clientId AS clientId, e.entryDate AS projectStartDate, e.groupId AS groupId, e.providerId AS providerId, e.typeEntryExit.name AS enrollmentType FROM SpEntryExit AS e WHERE e.active = TRUE AND e.entryExitId = ${id(target.enrollmentId)} AND e.clientId = ${id(target.clientId)}`);
@@ -213,7 +228,7 @@ export function createPlaywrightGwtSession({page,tenant,moduleBaseUrl}) {
     try{await save.click();const result=await Promise.race([captured,new Promise(resolve=>{timer=setTimeout(()=>resolve(null),15000);})]);if(!result)throw Error('Expected mutation was not captured');pending=digest(JSON.stringify({url:result.url,headers:result.headers,body:result.body}));return result;}
     finally{clearTimeout(timer);await page.unroute('**/service/**',handler);await ready();await closeDialogs();}
   };
-  return {connection:resolveUiConnection({tenant,moduleBaseUrl}),readEnrollment,listEnrollments,prepare,async send(request){
+  return {connection:resolveUiConnection({tenant,moduleBaseUrl}),readEnrollment,listEnrollments,readPicklistOptions,prepare,async send(request){
     checkGeneration();const fingerprint=digest(JSON.stringify(request));if(!pending||fingerprint!==pending)throw Error('Only the newly prepared request can be sent once');pending=undefined;return post(request);
   }};
 }

package/dist/cjs/picklist-labels.d.ts

@@ -0,0 +1,22 @@
+import type { AssessmentDefinition } from './metadata.js';
+import type { EncodingOptions } from './encoding.js';
+export interface PicklistCatalogOption {
+    optionId: number;
+    picklistId: number;
+    code: string | null;
+    name: string;
+}
+export interface PicklistCatalogSnapshot {
+    source: 'gwt-rpc';
+    tenant: string;
+    clientId: number;
+    count: number;
+    values: PicklistCatalogOption[];
+}
+export type CatalogWriteLabelResolver = NonNullable<EncodingOptions['writeLabel']> & {
+    readonly tenant: string;
+};
+/** Exact catalog names joined by identity, without reading any stored answer.
+ * Only choices present in the supplied assessment definition can resolve. */
+export declare function createCatalogWriteLabelResolver(definition: AssessmentDefinition, catalog: PicklistCatalogSnapshot): CatalogWriteLabelResolver;
+//# sourceMappingURL=picklist-labels.d.ts.map

package/dist/cjs/picklist-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"picklist-labels.d.ts","sourceRoot":"","sources":["../../src/picklist-labels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,oBAAoB,EAAmC,MAAM,eAAe,CAAC;AAE1F,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,eAAe,CAAC;AAGnD,MAAM,WAAW,qBAAqB;IAAE,QAAQ,EAAC,MAAM,CAAC;IAAA,UAAU,EAAC,MAAM,CAAC;IAAA,IAAI,EAAC,MAAM,GAAC,IAAI,CAAC;IAAA,IAAI,EAAC,MAAM,CAAC;CAAC;AACxG,MAAM,WAAW,uBAAuB;IAAE,MAAM,EAAC,SAAS,CAAC;IAAA,MAAM,EAAC,MAAM,CAAC;IAAA,QAAQ,EAAC,MAAM,CAAC;IAAA,KAAK,EAAC,MAAM,CAAC;IAAA,MAAM,EAAC,qBAAqB,EAAE,CAAC;CAAC;AACtI,MAAM,MAAM,yBAAyB,GAAG,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,GAAG;IAAC,QAAQ,CAAC,MAAM,EAAC,MAAM,CAAA;CAAC,CAAC;AAE9G;6EAC6E;AAC7E,wBAAgB,+BAA+B,CAAC,UAAU,EAAC,oBAAoB,EAAC,OAAO,EAAC,uBAAuB,GAAE,yBAAyB,CAoBzI"}

package/dist/cjs/picklist-labels.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCatalogWriteLabelResolver = createCatalogWriteLabelResolver;
+const metadata_js_1 = require("./metadata.js");
+const errors_js_1 = require("./errors.js");
+/** Exact catalog names joined by identity, without reading any stored answer.
+ * Only choices present in the supplied assessment definition can resolve. */
+function createCatalogWriteLabelResolver(definition, catalog) {
+    const fail = () => { throw new errors_js_1.ValidationError('incomplete or mismatched picklist label catalog'); };
+    if (catalog?.source !== 'gwt-rpc' || catalog.tenant !== definition.tenant || !Number.isSafeInteger(catalog.clientId) || catalog.clientId <= 0 || !Array.isArray(catalog.values) || catalog.count !== catalog.values.length)
+        fail();
+    const rows = new Map();
+    for (const row of catalog.values) {
+        if (!row || !Number.isSafeInteger(row.optionId) || row.optionId <= 0 || !Number.isSafeInteger(row.picklistId) || row.picklistId <= 0 || row.code !== null && typeof row.code !== 'string' || typeof row.name !== 'string' || !row.name.trim() || rows.has(row.optionId))
+            fail();
+        rows.set(row.optionId, { ...row });
+    }
+    const signature = (q, o) => JSON.stringify([q.questionId, q.fieldName, q.questionType, o.id, o.picklistId, o.code, o.picklistCode, o.name, o.hudVisibility]);
+    const labels = new Map();
+    for (const { question } of (0, metadata_js_1.flattenQuestions)(definition.questions)) {
+        if (question.questionType !== 'lookup')
+            continue;
+        for (const option of question.options) {
+            const row = rows.get(option.id);
+            if (!row || row.picklistId !== option.picklistId || row.code !== option.code) {
+                fail();
+                continue;
+            }
+            labels.set(signature(question, option), row.name);
+        }
+    }
+    const resolver = (question, option) => labels.get(signature(question, option));
+    return Object.freeze(Object.assign(resolver, { tenant: definition.tenant }));
+}
+//# sourceMappingURL=picklist-labels.js.map

package/dist/cjs/picklist-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"picklist-labels.js","sourceRoot":"","sources":["../../src/picklist-labels.ts"],"names":[],"mappings":"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","sourcesContent":["import type {AssessmentDefinition,PicklistOption,QuestionDefinition} from './metadata.js';\nimport {flattenQuestions} from './metadata.js';\nimport type {EncodingOptions} from './encoding.js';\nimport {ValidationError} from './errors.js';\n\nexport interface PicklistCatalogOption {optionId:number;picklistId:number;code:string|null;name:string;}\nexport interface PicklistCatalogSnapshot {source:'gwt-rpc';tenant:string;clientId:number;count:number;values:PicklistCatalogOption[];}\nexport type CatalogWriteLabelResolver = NonNullable<EncodingOptions['writeLabel']> & {readonly tenant:string};\n\n/** Exact catalog names joined by identity, without reading any stored answer.\n * Only choices present in the supplied assessment definition can resolve. */\nexport function createCatalogWriteLabelResolver(definition:AssessmentDefinition,catalog:PicklistCatalogSnapshot):CatalogWriteLabelResolver{\n const fail=()=>{throw new ValidationError('incomplete or mismatched picklist label catalog');};\n if(catalog?.source!=='gwt-rpc'||catalog.tenant!==definition.tenant||!Number.isSafeInteger(catalog.clientId)||catalog.clientId<=0||!Array.isArray(catalog.values)||catalog.count!==catalog.values.length)fail();\n const rows=new Map<number,PicklistCatalogOption>();\n for(const row of catalog.values){\n  if(!row||!Number.isSafeInteger(row.optionId)||row.optionId<=0||!Number.isSafeInteger(row.picklistId)||row.picklistId<=0||row.code!==null&&typeof row.code!=='string'||typeof row.name!=='string'||!row.name.trim()||rows.has(row.optionId))fail();\n  rows.set(row.optionId,{...row});\n }\n const signature=(q:QuestionDefinition,o:PicklistOption)=>JSON.stringify([q.questionId,q.fieldName,q.questionType,o.id,o.picklistId,o.code,o.picklistCode,o.name,o.hudVisibility]);\n const labels=new Map<string,string>();\n for(const {question}of flattenQuestions(definition.questions)){\n  if(question.questionType!=='lookup')continue;\n  for(const option of question.options){\n   const row=rows.get(option.id);\n   if(!row||row.picklistId!==option.picklistId||row.code!==option.code){fail();continue;}\n   labels.set(signature(question,option),row.name);\n  }\n }\n const resolver=(question:QuestionDefinition,option:PicklistOption)=>labels.get(signature(question,option));\n return Object.freeze(Object.assign(resolver,{tenant:definition.tenant}));\n}\n"]}

package/dist/cjs/v2.d.ts

@@ -12,4 +12,6 @@ export * from "./gwt-enrollments.js";
 export * from "./program-discovery.js";
 export * from "./mobile-preflight.js";
 export * from "./write-labels.js";
+export { createCatalogWriteLabelResolver } from './picklist-labels.js';
+export type { PicklistCatalogOption, PicklistCatalogSnapshot, CatalogWriteLabelResolver } from './picklist-labels.js';
 //# sourceMappingURL=v2.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"v2.d.ts","sourceRoot":"","sources":["../../src/v2.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"v2.d.ts","sourceRoot":"","sources":["../../src/v2.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAC,+BAA+B,EAAC,MAAM,sBAAsB,CAAC;AACrE,YAAY,EAAC,qBAAqB,EAAC,uBAAuB,EAAC,yBAAyB,EAAC,MAAM,sBAAsB,CAAC"}

package/dist/cjs/v2.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCatalogWriteLabelResolver = void 0;
 __exportStar(require("./generated/v2.js"), exports);
 __exportStar(require("./generated/v2-models.js"), exports);
 __exportStar(require("./runtime.js"), exports);
@@ -28,4 +29,6 @@ __exportStar(require("./gwt-enrollments.js"), exports);
 __exportStar(require("./program-discovery.js"), exports);
 __exportStar(require("./mobile-preflight.js"), exports);
 __exportStar(require("./write-labels.js"), exports);
+var picklist_labels_js_1 = require("./picklist-labels.js");
+Object.defineProperty(exports, "createCatalogWriteLabelResolver", { enumerable: true, get: function () { return picklist_labels_js_1.createCatalogWriteLabelResolver; } });
 //# sourceMappingURL=v2.js.map

package/dist/cjs/v2.js.map

@@ -1 +1 @@
-{"version":3,"file":"v2.js","sourceRoot":"","sources":["../../src/v2.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,2DAAyC;AACzC,+CAA6B;AAC7B,gDAA8B;AAC9B,8CAA4B;AAC5B,gDAA8B;AAC9B,oDAAkC;AAClC,4CAA0B;AAC1B,sDAAoC;AACpC,gEAA8C;AAE9C,uDAAqC;AACrC,yDAAuC;AACvC,wDAAsC;AACtC,oDAAkC","sourcesContent":["export * from \"./generated/v2.js\";\nexport * from \"./generated/v2-models.js\";\nexport * from \"./runtime.js\";\nexport * from \"./metadata.js\";\nexport * from \"./errors.js\";\nexport * from \"./encoding.js\";\nexport * from \"./verification.js\";\nexport * from \"./bulk.js\";\nexport * from \"./subassessments.js\";\nexport * from \"./enrollment-verifications.js\";\n\nexport * from \"./gwt-enrollments.js\";\nexport * from \"./program-discovery.js\";\nexport * from \"./mobile-preflight.js\";\nexport * from \"./write-labels.js\";\n"]}
+{"version":3,"file":"v2.js","sourceRoot":"","sources":["../../src/v2.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,2DAAyC;AACzC,+CAA6B;AAC7B,gDAA8B;AAC9B,8CAA4B;AAC5B,gDAA8B;AAC9B,oDAAkC;AAClC,4CAA0B;AAC1B,sDAAoC;AACpC,gEAA8C;AAE9C,uDAAqC;AACrC,yDAAuC;AACvC,wDAAsC;AACtC,oDAAkC;AAElC,2DAAqE;AAA7D,qIAAA,+BAA+B,OAAA","sourcesContent":["export * from \"./generated/v2.js\";\nexport * from \"./generated/v2-models.js\";\nexport * from \"./runtime.js\";\nexport * from \"./metadata.js\";\nexport * from \"./errors.js\";\nexport * from \"./encoding.js\";\nexport * from \"./verification.js\";\nexport * from \"./bulk.js\";\nexport * from \"./subassessments.js\";\nexport * from \"./enrollment-verifications.js\";\n\nexport * from \"./gwt-enrollments.js\";\nexport * from \"./program-discovery.js\";\nexport * from \"./mobile-preflight.js\";\nexport * from \"./write-labels.js\";\n\nexport {createCatalogWriteLabelResolver} from './picklist-labels.js';\nexport type {PicklistCatalogOption,PicklistCatalogSnapshot,CatalogWriteLabelResolver} from './picklist-labels.js';\n"]}

package/dist/cjs/v3.d.ts

@@ -12,4 +12,6 @@ export * from "./gwt-enrollments.js";
 export * from "./program-discovery.js";
 export * from "./mobile-preflight.js";
 export * from "./write-labels.js";
+export { createCatalogWriteLabelResolver } from './picklist-labels.js';
+export type { PicklistCatalogOption, PicklistCatalogSnapshot, CatalogWriteLabelResolver } from './picklist-labels.js';
 //# sourceMappingURL=v3.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"v3.d.ts","sourceRoot":"","sources":["../../src/v3.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"v3.d.ts","sourceRoot":"","sources":["../../src/v3.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAC,+BAA+B,EAAC,MAAM,sBAAsB,CAAC;AACrE,YAAY,EAAC,qBAAqB,EAAC,uBAAuB,EAAC,yBAAyB,EAAC,MAAM,sBAAsB,CAAC"}

package/dist/cjs/v3.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCatalogWriteLabelResolver = void 0;
 __exportStar(require("./generated/v3.js"), exports);
 __exportStar(require("./generated/v3-models.js"), exports);
 __exportStar(require("./runtime.js"), exports);
@@ -28,4 +29,6 @@ __exportStar(require("./gwt-enrollments.js"), exports);
 __exportStar(require("./program-discovery.js"), exports);
 __exportStar(require("./mobile-preflight.js"), exports);
 __exportStar(require("./write-labels.js"), exports);
+var picklist_labels_js_1 = require("./picklist-labels.js");
+Object.defineProperty(exports, "createCatalogWriteLabelResolver", { enumerable: true, get: function () { return picklist_labels_js_1.createCatalogWriteLabelResolver; } });
 //# sourceMappingURL=v3.js.map

package/dist/cjs/v3.js.map

@@ -1 +1 @@
-{"version":3,"file":"v3.js","sourceRoot":"","sources":["../../src/v3.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,2DAAyC;AACzC,+CAA6B;AAC7B,gDAA8B;AAC9B,8CAA4B;AAC5B,gDAA8B;AAC9B,oDAAkC;AAClC,4CAA0B;AAC1B,sDAAoC;AACpC,gEAA8C;AAE9C,uDAAqC;AACrC,yDAAuC;AACvC,wDAAsC;AACtC,oDAAkC","sourcesContent":["export * from \"./generated/v3.js\";\nexport * from \"./generated/v3-models.js\";\nexport * from \"./runtime.js\";\nexport * from \"./metadata.js\";\nexport * from \"./errors.js\";\nexport * from \"./encoding.js\";\nexport * from \"./verification.js\";\nexport * from \"./bulk.js\";\nexport * from \"./subassessments.js\";\nexport * from \"./enrollment-verifications.js\";\n\nexport * from \"./gwt-enrollments.js\";\nexport * from \"./program-discovery.js\";\nexport * from \"./mobile-preflight.js\";\nexport * from \"./write-labels.js\";\n"]}
+{"version":3,"file":"v3.js","sourceRoot":"","sources":["../../src/v3.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,2DAAyC;AACzC,+CAA6B;AAC7B,gDAA8B;AAC9B,8CAA4B;AAC5B,gDAA8B;AAC9B,oDAAkC;AAClC,4CAA0B;AAC1B,sDAAoC;AACpC,gEAA8C;AAE9C,uDAAqC;AACrC,yDAAuC;AACvC,wDAAsC;AACtC,oDAAkC;AAElC,2DAAqE;AAA7D,qIAAA,+BAA+B,OAAA","sourcesContent":["export * from \"./generated/v3.js\";\nexport * from \"./generated/v3-models.js\";\nexport * from \"./runtime.js\";\nexport * from \"./metadata.js\";\nexport * from \"./errors.js\";\nexport * from \"./encoding.js\";\nexport * from \"./verification.js\";\nexport * from \"./bulk.js\";\nexport * from \"./subassessments.js\";\nexport * from \"./enrollment-verifications.js\";\n\nexport * from \"./gwt-enrollments.js\";\nexport * from \"./program-discovery.js\";\nexport * from \"./mobile-preflight.js\";\nexport * from \"./write-labels.js\";\n\nexport {createCatalogWriteLabelResolver} from './picklist-labels.js';\nexport type {PicklistCatalogOption,PicklistCatalogSnapshot,CatalogWriteLabelResolver} from './picklist-labels.js';\n"]}

package/dist/esm/picklist-labels.d.ts

@@ -0,0 +1,22 @@
+import type { AssessmentDefinition } from './metadata.js';
+import type { EncodingOptions } from './encoding.js';
+export interface PicklistCatalogOption {
+    optionId: number;
+    picklistId: number;
+    code: string | null;
+    name: string;
+}
+export interface PicklistCatalogSnapshot {
+    source: 'gwt-rpc';
+    tenant: string;
+    clientId: number;
+    count: number;
+    values: PicklistCatalogOption[];
+}
+export type CatalogWriteLabelResolver = NonNullable<EncodingOptions['writeLabel']> & {
+    readonly tenant: string;
+};
+/** Exact catalog names joined by identity, without reading any stored answer.
+ * Only choices present in the supplied assessment definition can resolve. */
+export declare function createCatalogWriteLabelResolver(definition: AssessmentDefinition, catalog: PicklistCatalogSnapshot): CatalogWriteLabelResolver;
+//# sourceMappingURL=picklist-labels.d.ts.map

package/dist/esm/picklist-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"picklist-labels.d.ts","sourceRoot":"","sources":["../../src/picklist-labels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,oBAAoB,EAAmC,MAAM,eAAe,CAAC;AAE1F,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,eAAe,CAAC;AAGnD,MAAM,WAAW,qBAAqB;IAAE,QAAQ,EAAC,MAAM,CAAC;IAAA,UAAU,EAAC,MAAM,CAAC;IAAA,IAAI,EAAC,MAAM,GAAC,IAAI,CAAC;IAAA,IAAI,EAAC,MAAM,CAAC;CAAC;AACxG,MAAM,WAAW,uBAAuB;IAAE,MAAM,EAAC,SAAS,CAAC;IAAA,MAAM,EAAC,MAAM,CAAC;IAAA,QAAQ,EAAC,MAAM,CAAC;IAAA,KAAK,EAAC,MAAM,CAAC;IAAA,MAAM,EAAC,qBAAqB,EAAE,CAAC;CAAC;AACtI,MAAM,MAAM,yBAAyB,GAAG,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,GAAG;IAAC,QAAQ,CAAC,MAAM,EAAC,MAAM,CAAA;CAAC,CAAC;AAE9G;6EAC6E;AAC7E,wBAAgB,+BAA+B,CAAC,UAAU,EAAC,oBAAoB,EAAC,OAAO,EAAC,uBAAuB,GAAE,yBAAyB,CAoBzI"}

package/dist/esm/picklist-labels.js

@@ -0,0 +1,32 @@
+import { flattenQuestions } from './metadata.js';
+import { ValidationError } from './errors.js';
+/** Exact catalog names joined by identity, without reading any stored answer.
+ * Only choices present in the supplied assessment definition can resolve. */
+export function createCatalogWriteLabelResolver(definition, catalog) {
+    const fail = () => { throw new ValidationError('incomplete or mismatched picklist label catalog'); };
+    if (catalog?.source !== 'gwt-rpc' || catalog.tenant !== definition.tenant || !Number.isSafeInteger(catalog.clientId) || catalog.clientId <= 0 || !Array.isArray(catalog.values) || catalog.count !== catalog.values.length)
+        fail();
+    const rows = new Map();
+    for (const row of catalog.values) {
+        if (!row || !Number.isSafeInteger(row.optionId) || row.optionId <= 0 || !Number.isSafeInteger(row.picklistId) || row.picklistId <= 0 || row.code !== null && typeof row.code !== 'string' || typeof row.name !== 'string' || !row.name.trim() || rows.has(row.optionId))
+            fail();
+        rows.set(row.optionId, { ...row });
+    }
+    const signature = (q, o) => JSON.stringify([q.questionId, q.fieldName, q.questionType, o.id, o.picklistId, o.code, o.picklistCode, o.name, o.hudVisibility]);
+    const labels = new Map();
+    for (const { question } of flattenQuestions(definition.questions)) {
+        if (question.questionType !== 'lookup')
+            continue;
+        for (const option of question.options) {
+            const row = rows.get(option.id);
+            if (!row || row.picklistId !== option.picklistId || row.code !== option.code) {
+                fail();
+                continue;
+            }
+            labels.set(signature(question, option), row.name);
+        }
+    }
+    const resolver = (question, option) => labels.get(signature(question, option));
+    return Object.freeze(Object.assign(resolver, { tenant: definition.tenant }));
+}
+//# sourceMappingURL=picklist-labels.js.map

package/dist/esm/picklist-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"picklist-labels.js","sourceRoot":"","sources":["../../src/picklist-labels.ts"],"names":[],"mappings":"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","sourcesContent":["import type {AssessmentDefinition,PicklistOption,QuestionDefinition} from './metadata.js';\nimport {flattenQuestions} from './metadata.js';\nimport type {EncodingOptions} from './encoding.js';\nimport {ValidationError} from './errors.js';\n\nexport interface PicklistCatalogOption {optionId:number;picklistId:number;code:string|null;name:string;}\nexport interface PicklistCatalogSnapshot {source:'gwt-rpc';tenant:string;clientId:number;count:number;values:PicklistCatalogOption[];}\nexport type CatalogWriteLabelResolver = NonNullable<EncodingOptions['writeLabel']> & {readonly tenant:string};\n\n/** Exact catalog names joined by identity, without reading any stored answer.\n * Only choices present in the supplied assessment definition can resolve. */\nexport function createCatalogWriteLabelResolver(definition:AssessmentDefinition,catalog:PicklistCatalogSnapshot):CatalogWriteLabelResolver{\n const fail=()=>{throw new ValidationError('incomplete or mismatched picklist label catalog');};\n if(catalog?.source!=='gwt-rpc'||catalog.tenant!==definition.tenant||!Number.isSafeInteger(catalog.clientId)||catalog.clientId<=0||!Array.isArray(catalog.values)||catalog.count!==catalog.values.length)fail();\n const rows=new Map<number,PicklistCatalogOption>();\n for(const row of catalog.values){\n  if(!row||!Number.isSafeInteger(row.optionId)||row.optionId<=0||!Number.isSafeInteger(row.picklistId)||row.picklistId<=0||row.code!==null&&typeof row.code!=='string'||typeof row.name!=='string'||!row.name.trim()||rows.has(row.optionId))fail();\n  rows.set(row.optionId,{...row});\n }\n const signature=(q:QuestionDefinition,o:PicklistOption)=>JSON.stringify([q.questionId,q.fieldName,q.questionType,o.id,o.picklistId,o.code,o.picklistCode,o.name,o.hudVisibility]);\n const labels=new Map<string,string>();\n for(const {question}of flattenQuestions(definition.questions)){\n  if(question.questionType!=='lookup')continue;\n  for(const option of question.options){\n   const row=rows.get(option.id);\n   if(!row||row.picklistId!==option.picklistId||row.code!==option.code){fail();continue;}\n   labels.set(signature(question,option),row.name);\n  }\n }\n const resolver=(question:QuestionDefinition,option:PicklistOption)=>labels.get(signature(question,option));\n return Object.freeze(Object.assign(resolver,{tenant:definition.tenant}));\n}\n"]}

package/dist/esm/v2.d.ts

@@ -12,4 +12,6 @@ export * from "./gwt-enrollments.js";
 export * from "./program-discovery.js";
 export * from "./mobile-preflight.js";
 export * from "./write-labels.js";
+export { createCatalogWriteLabelResolver } from './picklist-labels.js';
+export type { PicklistCatalogOption, PicklistCatalogSnapshot, CatalogWriteLabelResolver } from './picklist-labels.js';
 //# sourceMappingURL=v2.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"v2.d.ts","sourceRoot":"","sources":["../../src/v2.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"v2.d.ts","sourceRoot":"","sources":["../../src/v2.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAC,+BAA+B,EAAC,MAAM,sBAAsB,CAAC;AACrE,YAAY,EAAC,qBAAqB,EAAC,uBAAuB,EAAC,yBAAyB,EAAC,MAAM,sBAAsB,CAAC"}

package/dist/esm/v2.js

@@ -12,4 +12,5 @@ export * from "./gwt-enrollments.js";
 export * from "./program-discovery.js";
 export * from "./mobile-preflight.js";
 export * from "./write-labels.js";
+export { createCatalogWriteLabelResolver } from './picklist-labels.js';
 //# sourceMappingURL=v2.js.map

package/dist/esm/v2.js.map

@@ -1 +1 @@
-{"version":3,"file":"v2.js","sourceRoot":"","sources":["../../src/v2.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC","sourcesContent":["export * from \"./generated/v2.js\";\nexport * from \"./generated/v2-models.js\";\nexport * from \"./runtime.js\";\nexport * from \"./metadata.js\";\nexport * from \"./errors.js\";\nexport * from \"./encoding.js\";\nexport * from \"./verification.js\";\nexport * from \"./bulk.js\";\nexport * from \"./subassessments.js\";\nexport * from \"./enrollment-verifications.js\";\n\nexport * from \"./gwt-enrollments.js\";\nexport * from \"./program-discovery.js\";\nexport * from \"./mobile-preflight.js\";\nexport * from \"./write-labels.js\";\n"]}
+{"version":3,"file":"v2.js","sourceRoot":"","sources":["../../src/v2.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAC,+BAA+B,EAAC,MAAM,sBAAsB,CAAC","sourcesContent":["export * from \"./generated/v2.js\";\nexport * from \"./generated/v2-models.js\";\nexport * from \"./runtime.js\";\nexport * from \"./metadata.js\";\nexport * from \"./errors.js\";\nexport * from \"./encoding.js\";\nexport * from \"./verification.js\";\nexport * from \"./bulk.js\";\nexport * from \"./subassessments.js\";\nexport * from \"./enrollment-verifications.js\";\n\nexport * from \"./gwt-enrollments.js\";\nexport * from \"./program-discovery.js\";\nexport * from \"./mobile-preflight.js\";\nexport * from \"./write-labels.js\";\n\nexport {createCatalogWriteLabelResolver} from './picklist-labels.js';\nexport type {PicklistCatalogOption,PicklistCatalogSnapshot,CatalogWriteLabelResolver} from './picklist-labels.js';\n"]}

package/dist/esm/v3.d.ts

@@ -12,4 +12,6 @@ export * from "./gwt-enrollments.js";
 export * from "./program-discovery.js";
 export * from "./mobile-preflight.js";
 export * from "./write-labels.js";
+export { createCatalogWriteLabelResolver } from './picklist-labels.js';
+export type { PicklistCatalogOption, PicklistCatalogSnapshot, CatalogWriteLabelResolver } from './picklist-labels.js';
 //# sourceMappingURL=v3.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"v3.d.ts","sourceRoot":"","sources":["../../src/v3.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"v3.d.ts","sourceRoot":"","sources":["../../src/v3.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAC,+BAA+B,EAAC,MAAM,sBAAsB,CAAC;AACrE,YAAY,EAAC,qBAAqB,EAAC,uBAAuB,EAAC,yBAAyB,EAAC,MAAM,sBAAsB,CAAC"}

package/dist/esm/v3.js

@@ -12,4 +12,5 @@ export * from "./gwt-enrollments.js";
 export * from "./program-discovery.js";
 export * from "./mobile-preflight.js";
 export * from "./write-labels.js";
+export { createCatalogWriteLabelResolver } from './picklist-labels.js';
 //# sourceMappingURL=v3.js.map

package/dist/esm/v3.js.map

@@ -1 +1 @@
-{"version":3,"file":"v3.js","sourceRoot":"","sources":["../../src/v3.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC","sourcesContent":["export * from \"./generated/v3.js\";\nexport * from \"./generated/v3-models.js\";\nexport * from \"./runtime.js\";\nexport * from \"./metadata.js\";\nexport * from \"./errors.js\";\nexport * from \"./encoding.js\";\nexport * from \"./verification.js\";\nexport * from \"./bulk.js\";\nexport * from \"./subassessments.js\";\nexport * from \"./enrollment-verifications.js\";\n\nexport * from \"./gwt-enrollments.js\";\nexport * from \"./program-discovery.js\";\nexport * from \"./mobile-preflight.js\";\nexport * from \"./write-labels.js\";\n"]}
+{"version":3,"file":"v3.js","sourceRoot":"","sources":["../../src/v3.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAE9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAC,+BAA+B,EAAC,MAAM,sBAAsB,CAAC","sourcesContent":["export * from \"./generated/v3.js\";\nexport * from \"./generated/v3-models.js\";\nexport * from \"./runtime.js\";\nexport * from \"./metadata.js\";\nexport * from \"./errors.js\";\nexport * from \"./encoding.js\";\nexport * from \"./verification.js\";\nexport * from \"./bulk.js\";\nexport * from \"./subassessments.js\";\nexport * from \"./enrollment-verifications.js\";\n\nexport * from \"./gwt-enrollments.js\";\nexport * from \"./program-discovery.js\";\nexport * from \"./mobile-preflight.js\";\nexport * from \"./write-labels.js\";\n\nexport {createCatalogWriteLabelResolver} from './picklist-labels.js';\nexport type {PicklistCatalogOption,PicklistCatalogSnapshot,CatalogWriteLabelResolver} from './picklist-labels.js';\n"]}

package/docs/assessments.md

@@ -29,7 +29,25 @@ The default metadata cache TTL is 60 seconds with 100 entries per client. Config
 
 WellSky requires a client context and known assessment code for these reads. There is no documented global assessment-list or standalone picklist-list endpoint. Mobile option metadata has no effective-date filter, so definitions explicitly identify its options as current even when the generic assessment read is dated. Metadata also does not provide a complete questionnaire branching engine.
 
-Use the raw `assessments.get`, `assessmentsMobile.getAnswers`, and `enrollments.getAssessment` methods for recorded answers. Use `encodeAnswers` and `encodeNewSubassessmentRow` for endpoint-specific encoding. Mobile lookups use option IDs; standalone/enrollment lookups require an explicit `writeLabel` resolver with tenant-verified labels. Raw option names are not assumed to be valid write labels. Some HUD-marked choices require `(HUD)` in the full write label even when metadata `name` omits it. Do not infer this from trailing whitespace or append the suffix to every option. Continue supplying tenant-verified labels until a label resolver has authoritative metadata; recorded `answer_value_text` is useful evidence for the corresponding option. Provider answers are refused for mobile writes because that endpoint can silently discard them. Answer-state code mappings and multi-value serialization are caller-supplied; a refusal is never converted to `No`.
+Use the raw `assessments.get`, `assessmentsMobile.getAnswers`, and `enrollments.getAssessment` methods for recorded answers. Use `encodeAnswers` and `encodeNewSubassessmentRow` for endpoint-specific encoding. Mobile lookups use option IDs; standalone/enrollment lookups require an explicit `writeLabel` resolver with tenant-verified labels. Raw option names are not assumed to be valid write labels. Some HUD-marked choices require `(HUD)` in the full write label even when metadata `name` omits it. Do not infer this from trailing whitespace or append the suffix to every option. Use the catalog resolver below for exact labels without existing answers, or retain an explicitly verified callback; recorded `answer_value_text` also supplies evidence for observed options. Provider answers are refused for mobile writes because that endpoint can silently discard them. Answer-state code mappings and multi-value serialization are caller-supplied; a refusal is never converted to `No`.
+
+## Resolve lookup labels before an answer exists
+
+The browser enrollment session exposes `readPicklistOptions({clientId, optionIds})`. It reads the current GWT picklist catalog and returns complete, counted rows with `optionId`, `picklistId`, `code`, and the exact full `name`. It needs an authenticated session and client context, but no existing enrollment or answer. Only explicit positive option IDs are queried, in batches of 200; missing, duplicated or malformed results stop discovery.
+
+```ts
+import {flattenQuestions, createCatalogWriteLabelResolver} from '@choiceapps/communityservices-sdk';
+const definition = await api.assessments.getDefinition({clientId, assessmentCode});
+const optionIds = [...new Set(flattenQuestions(definition.questions)
+  .filter(({question}) => question.questionType === 'lookup')
+  .flatMap(({question}) => question.options.map(option => option.id)))];
+const catalog = await session.enrollmentSession.readPicklistOptions({clientId, optionIds});
+const writeLabel = createCatalogWriteLabelResolver(definition, catalog);
+```
+
+The resolver matches option ID, picklist ID and code, preserves the full catalog name, and permits only options already allowed by the question definition. HUD and non-HUD choices have distinct IDs. It never appends a suffix, guesses from whitespace, or broadens the question's allowed list. Missing identity evidence or a tenant mismatch throws before encoding. The immutable resolver returns `undefined` if called with changed option metadata.
+
+`createEnrollmentWorkflow` uses this catalog automatically when its `enrollmentSession` has `readPicklistOptions` and `writeLabel` is omitted. This covers standard entry/interim/exit batches, mandatory carry-forward and `correctEntry`. Explicit callbacks take precedence and skip automatic catalog reads. Legacy custom sessions without this reader still need a callback. Raw REST clients do not acquire UI access implicitly. See [the typed example](../examples/catalog-write-labels.mts) and [read-only evidence](vendor-issues/lookup-write-labels.md).
 
 ## Resolve exact lookup write labels from readback
 

package/docs/capabilities.md

@@ -98,4 +98,10 @@ The integrator reports these training-tenant results on November 10 and 11, 2026
 
 The integrator has not tested household adoption followed by `createHouseholdInterim`, scalar correction on an adopted enrollment, or a new correction key after resolution. Synthetic tests do not replace that acceptance.
 
-The 0.7.0 label resolver, group flags, household discovery, row registration, error codes and mobile collision preflight have local regression coverage, not new live tenant acceptance. Full write labels remain unresolved for unobserved options. Household discovery refuses ambiguous current-membership matches. Yes/no blanking remains unsupported; no alternative route has been verified.
+The 0.7.0 label resolver, group flags, household discovery, row registration, error codes and mobile collision preflight have local regression coverage, not new live tenant acceptance. In 0.7.0, full write labels remained unresolved for unobserved options; the 0.8.0 catalog reader below removes that limitation when UI catalog access is available. Household discovery refuses ambiguous current-membership matches. Yes/no blanking remains unsupported; no alternative route has been verified.
+
+## Catalog label verification, November 11, 2026
+
+Read-only training checks matched all 1,288 distinct option IDs in the Coordinated Entry instrument to current GWT catalog rows across three synthetic clients (4,089 question/option pairs). Catalog names differed from REST metadata names for 139 option occurrences in one definition. The five enhanced yes/no HUD questions shared a catalog; plain yes/no alternatives had separate option IDs. The visible profile DOB-quality dropdown matched the catalog's full labels. This establishes metadata identity and displayed labels without prior-answer evidence, not fresh acceptance of every standard write. Existing enrollment and answer records were left unchanged.
+
+SDK 0.8.0 uses the catalog automatically for workflows with a built-in enrollment session. REST-only applications can supply a catalog resolver or retain their explicit callback. See [catalog evidence and limitations](vendor-issues/lookup-write-labels.md).

package/docs/enrollments.md

@@ -130,7 +130,7 @@ Every mandatory label is resolved before the first write. The `yesno` stage veri
 
 ## Correct an existing entry assessment
 
-`correctEntry` patches an entry at its original effective timestamp. Supply the verified `createEnrollment` key as `enrollmentKey` and a new stable `key` for each correction. Configure `enrollmentSession` and a `writeLabel` resolver for tenant-verified lookup labels. A correction requires an open enrollment with no interim reviews or exit workflows.
+`correctEntry` patches an entry at its original effective timestamp. Supply the verified `createEnrollment` key as `enrollmentKey` and a new stable `key` for each correction. Configure `enrollmentSession`; built-in sessions discover exact lookup labels automatically. An explicit `writeLabel` callback overrides that discovery. A correction requires an open enrollment with no interim reviews or exit workflows.
 
 ```ts
 const corrected = await workflow.correctEntry({
@@ -234,6 +234,8 @@ const detail = await session.enrollmentSession.readEnrollment({
 
 Use the session returned by `openEnrollmentSession`. Lists include open and exited entries, validate complete counts, and refuse more than 1,000 records. List rows and details include `groupId` and `grouped`. The flag describes a stored group link, including a group with one participant; it is not a member count and requires no per-row detail reads. These fields are required on managed catalog rows and optional on custom detail-reader contracts for compatibility. `groupId` is never a household ID. For a verified household match from a head enrollment, use `discoverHouseholdEnrollment` below.
 
+The same session also exposes `readPicklistOptions({clientId, optionIds})` for exact labels before answers exist. It uses fresh read context, validates counted results, and makes no record writes. Enrollment workflows use it automatically unless `writeLabel` is supplied. See [catalog lookup labels](assessments.md#resolve-lookup-labels-before-an-answer-exists).
+
 ## Individual enrollment exits
 
 Use `exitEnrollment` to end a standalone person's program enrollment. It requires a verified `createEnrollment` entry in the same durable store. Supply `enrollmentSession: session.enrollmentSession` and `exitUi: createHouseholdExitUi({page: session.page})` when constructing the workflow. The same exit UI port serves individual and household forms.

package/docs/reference.md

@@ -8,14 +8,14 @@ Only the package export paths below are supported import entry points. Declarati
 
 Import from `@choiceapps/communityservices-sdk`, `@choiceapps/communityservices-sdk/v3`, or `@choiceapps/communityservices-sdk/v2`. The root selects V3 and also exports the testing helpers. Each version supplies its own generated HTTP models and fixed version header.
 
-Runtime exports at the root: `MobileAnswerPreflightError`, `writeMobileAnswersChecked`, `createReadBackWriteLabelResolver`, `AmbiguousCommitError`, `AssessmentMetadata`, `AuthError`, `CooldownError`, `DefinitionDriftError`, `FakeControl`, `FakeWellSkyClient`, `GwtEnrollmentConflictError`, `GwtEnrollmentHelpers`, `SubassessmentEditor`, `TenantMismatchError`, `ThrottledError`, `UnknownPicklistValueError`, `UpstreamError`, `ValidationError`, `WellSkyClient`, `WellSkyError`, `apiVersion`, `buildAssessmentDefinition`, `compareDefinition`, `createFakeWellSkyClient`, `createInMemoryGwtMutationStore`, `createWellSkyClient`, `encodeAnswers`, `encodeNewSubassessmentRow`, `flattenQuestions`, `mapBulk`, `operationRoutes`, `parseRestInstant`, `readEnrollmentVerifications`, `readOutcome`, `readProgramCatalog`, `resolvePicklistOption`, `semanticHash`, `specSha256`, `toItems`, `verifyWrite`.
+Runtime exports at the root: `MobileAnswerPreflightError`, `writeMobileAnswersChecked`, `createReadBackWriteLabelResolver`, `createCatalogWriteLabelResolver`, `AmbiguousCommitError`, `AssessmentMetadata`, `AuthError`, `CooldownError`, `DefinitionDriftError`, `FakeControl`, `FakeWellSkyClient`, `GwtEnrollmentConflictError`, `GwtEnrollmentHelpers`, `SubassessmentEditor`, `TenantMismatchError`, `ThrottledError`, `UnknownPicklistValueError`, `UpstreamError`, `ValidationError`, `WellSkyClient`, `WellSkyError`, `apiVersion`, `buildAssessmentDefinition`, `compareDefinition`, `createFakeWellSkyClient`, `createInMemoryGwtMutationStore`, `createWellSkyClient`, `encodeAnswers`, `encodeNewSubassessmentRow`, `flattenQuestions`, `mapBulk`, `operationRoutes`, `parseRestInstant`, `readEnrollmentVerifications`, `readOutcome`, `readProgramCatalog`, `resolvePicklistOption`, `semanticHash`, `specSha256`, `toItems`, `verifyWrite`.
 
 | Contract | Declaration | Guide |
 | --- | --- | --- |
 | HTTP clients and generated models | [V3](../dist/esm/generated/v3.d.ts), [V2](../dist/esm/generated/v2.d.ts) | [REST](rest-client.md), [API table](../API.md) |
 | Authentication, transport, responses and errors | [Runtime](../dist/esm/runtime.d.ts) | [Configuration](configuration.md), [recovery](troubleshooting.md) |
 | Metadata and picklists | [Metadata](../dist/esm/metadata.d.ts) | [Assessments](assessments.md) |
-| Checked mobile inserts and exact lookup labels | [Preflight](../dist/esm/mobile-preflight.d.ts), [labels](../dist/esm/write-labels.d.ts) | [Assessments](assessments.md) |
+| Checked mobile inserts and exact lookup labels | [Preflight](../dist/esm/mobile-preflight.d.ts), [readback labels](../dist/esm/write-labels.d.ts), [catalog labels](../dist/esm/picklist-labels.d.ts) | [Assessments](assessments.md) |
 | Answer encoding | [Encoding](../dist/esm/encoding.d.ts) | [Dates and answers](dates-and-answers.md) |
 | Write verification | [Verification](../dist/esm/verification.d.ts) | [REST](rest-client.md) |
 | Program catalog | [Program discovery](../dist/esm/program-discovery.d.ts) | [Enrollments](enrollments.md) |

package/docs/vendor-issues/lookup-write-labels.md

@@ -0,0 +1,13 @@
+# Exact lookup write labels from the UI catalog
+
+On November 11, 2026, read-only inspection of the training application's current GWT catalog established a way to discover full lookup labels before an answer exists.
+
+REST assessment option metadata can omit `(HUD)` from `name`. The current UI's `SpPicklistValue.name` retains it. A mapped query returns `picklistValueId`, `picklistId`, `code` and `name` together. HUD and non-HUD enhanced yes/no choices are separate catalog records. `show_on_hud_nonhud_site` and trailing whitespace are not reliable substitutes for those identities.
+
+The read used the application's observed `MetaQueryService` / `GenericService.getMappedResults` wire context and selected only explicit option IDs already enumerated by REST metadata. The [browser reader](../../browser/playwright-session.mjs) implements the same query with bounded batches and counted result validation. The [public resolver contract](../../dist/esm/picklist-labels.d.ts) joins IDs and codes while retaining the question's allowed choices.
+
+Evidence: Coordinated Entry definitions for three synthetic clients matched all 1,288 distinct option IDs (4,089 question/option pairs). Full names differed from REST metadata for 139 occurrences in a definition. Disabling condition, domestic violence, non-cash benefits, health insurance and income-source questions shared the enhanced yes/no list. Living-situation and homelessness-history options were included. The visible profile DOB-quality dropdown matched its full catalog names, including all displayed options rather than only the selected answer.
+
+No enrollment or assessment was saved during this inspection. No new REST writes were made to test acceptance of every returned label. Private captures, client identifiers and tenant-specific catalogs are excluded from the package. This internal GWT route is not part of the published REST Swagger; schema, permission, count or identity failures must stop discovery. Explicit application callbacks remain available for deployments without the catalog reader.
+
+See [assessment integration](../assessments.md#resolve-lookup-labels-before-an-answer-exists) for usage.

package/examples/README.md

@@ -15,6 +15,7 @@ Every file here ships with the package and imports the public `@choiceapps/commu
 | [program-discovery.ts](program-discovery.ts) | Program and VA-entry assessment discovery | Exported function; authenticated page required |
 | [enrollment-workflow.mts](enrollment-workflow.mts) | Single entry and interim assessment plans | Exported function; caller supplies plans and dependencies |
 | [individual-exit-workflow.mts](individual-exit-workflow.mts) | Standalone program enrollment exit and assessment | Verified entry key, enrollment reader, exit UI port and durable store required |
+| [catalog-write-labels.mts](catalog-write-labels.mts) | Discover full lookup labels without existing answers; automatic workflow configuration | Authenticated enrollment session and current assessment definition required |
 | [checked-assessment-writes.mts](checked-assessment-writes.mts) | Exact readback lookup labels and checked mobile scalar inserts | Unobserved labels remain unresolved; preflight does not make writes atomic |
 | [enrollment-discovery-and-correction.mts](enrollment-discovery-and-correction.mts) | Discover/adopt from the head and bind existing correction rows | Explicit row IDs and unique verified household membership required |
 | [entry-correction-workflow.mts](entry-correction-workflow.mts) | Same-date scalar clears and existing row edits | Original entry/row keys, verified lookup labels and durable store required |

package/examples/catalog-write-labels.mts

@@ -0,0 +1,15 @@
+import {createCatalogWriteLabelResolver,flattenQuestions,type WellSkyClient} from '@choiceapps/communityservices-sdk';
+import {createEnrollmentWorkflow,type EnrollmentCatalogReader,type EnrollmentWorkflowOptions} from '@choiceapps/communityservices-sdk/browser';
+
+/** Standalone encoders can discover exact labels before any option has been answered. */
+export async function discoverLabels(api:WellSkyClient,enrollmentSession:EnrollmentCatalogReader,input:{clientId:number;assessmentCode:string}){
+ const definition=await api.assessments.getDefinition(input);
+ const optionIds=[...new Set(flattenQuestions(definition.questions).filter(({question})=>question.questionType==='lookup').flatMap(({question})=>question.options.map(o=>o.id)))];
+ const catalog=await enrollmentSession.readPicklistOptions({clientId:input.clientId,optionIds});
+ return {definition,writeLabel:createCatalogWriteLabelResolver(definition,catalog)};
+}
+
+/** Built-in enrollment sessions discover labels automatically when writeLabel is omitted. */
+export function automaticWorkflow(options:Omit<EnrollmentWorkflowOptions,'writeLabel'|'yesNoWrites'|'enrollmentSession'>&{enrollmentSession:EnrollmentCatalogReader}){
+ return createEnrollmentWorkflow({...options,yesNoWrites:'standard'});
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@choiceapps/communityservices-sdk",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "SDK for WellSky Community Services (HMIS), formerly ServicePoint, Client API V2 and V3",
   "type": "module",
   "main": "./dist/cjs/index.js",