@choiceapps/communityservices-sdk 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.1.1 - 2026-11-02
+
+- Accept Basic, Standard, RHY, Basic Center Program Entry/Exit, PATH, Quick Call, and Transitional Living Program Entry/Exit in enrollment workflows alongside HUD and VA. Added per-type assessment display location mappings, with current provider discovery and existing journal verification.
+
 ## 0.1.0 - 2026-10-28
 
 Initial development release of `@choiceapps/communityservices-sdk`.

package/README.md

@@ -20,23 +20,6 @@ npm install @choiceapps/communityservices-sdk
 
 The public package uses the default npm registry. No registry token is needed to install it.
 
-### Install from GitLab
-
-Add this to your application's `.npmrc`:
-
-```ini
-@choiceapps:registry=https://gitlab.home.nmbgeek.com/api/v4/projects/48/packages/npm/
-//gitlab.home.nmbgeek.com/api/v4/projects/48/packages/npm/:_authToken=${GITLAB_NPM_TOKEN}
-```
-
-Supply a GitLab token with package-read access through `GITLAB_NPM_TOKEN`, then install:
-
-```sh
-npm install @choiceapps/communityservices-sdk
-```
-
-Keep token values out of version control. The GitLab token installs the package; your REST and browser credentials authenticate to Community Services separately.
-
 ## Run an offline example
 
 ```sh

package/browser/enrollment-workflow.d.mts

@@ -30,10 +30,13 @@ export interface EnrollmentAssessmentPlan {
   notApplicable?:Record<string,string>;
   carryForward?:string[];
 }
+export type EntryExitType = 'HUD'|'Basic'|'Standard'|'RHY'|'VA'|'Basic Center Program Entry/Exit'|'PATH'|'Quick Call'|'Transitional Living Program Entry/Exit';
+/** Exact location identifiers returned by getProviderAssessments, not assessment codes. */
+export interface EnrollmentAssessmentLocations {entry:string;interim:string;exit?:string;}
 export interface EnrollmentDiscoveryInput {
   clientId:number;
   providerId:number;
-  type:'HUD'|'VA';
+  type:EntryExitType;
   /** Timezone-qualified timestamp with whole-second precision. */
   entryDate:string;
 }
@@ -152,6 +155,9 @@ export interface HouseholdWorkflowStatus {
   members:Array<{clientId:number;key:string}&Partial<Omit<InterimWorkflowResult&ExitWorkflowResult,'clientId'|'key'>>>;
 }
 export interface EnrollmentWorkflowOptions {
+  /** HUD/VA have built-in mappings. Other types require locations from current provider discovery.
+   * A mapping replaces all built-in locations for that type. Retain it across retries. */
+  assessmentLocations?:Partial<Record<EntryExitType,EnrollmentAssessmentLocations>>;
   api:Pick<WellSkyClient,'tenant'|'clients'|'providers'|'enrollments'|'assessments'|'assessmentsMobile'|'subassessments'>&Partial<Pick<WellSkyClient,'households'>>;
   discovery:Pick<ProgramDiscovery,'getProviderAssessments'>;
   helpers:Pick<GwtEnrollmentHelpers,'createInterimUpdate'>&Partial<Pick<GwtEnrollmentHelpers,'addHouseholdMembers'>>;

package/browser/enrollment-workflow.mjs

@@ -6,6 +6,7 @@ import {readProgramCatalog,encodeAnswers,encodeNewSubassessmentRow,toItems} from
 
 const object=v=>v!==null&&typeof v==='object'&&!Array.isArray(v);
 const positive=v=>Number.isSafeInteger(v)&&v>0;
+const entryExitTypes=['HUD','Basic','Standard','RHY','VA','Basic Center Program Entry/Exit','PATH','Quick Call','Transitional Living Program Entry/Exit'];
 const canonical=v=>JSON.stringify(v,(_,x)=>object(x)?Object.fromEntries(Object.keys(x).sort().map(k=>[k,x[k]])):x);
 const hash=v=>createHash('sha256').update(canonical(v)).digest('hex');
 const fail=message=>{throw new EnrollmentWorkflowError(message);};
@@ -71,17 +72,25 @@ async function enrollments(api,clientId){
 
 /** Explicit orchestration for an existing client. All writers must share the durable store.
  * No automatic retries of uncertain REST writes. This is not a cross-system transaction. */
-export function createEnrollmentWorkflow({api,discovery,helpers,store,enrollmentSession,exitUi,memberEntryDatePort,birthDates}){
+export function createEnrollmentWorkflow({api,discovery,helpers,store,enrollmentSession,exitUi,memberEntryDatePort,birthDates,assessmentLocations={}}){
  const tenantScope=apiScope(api, discovery, helpers, enrollmentSession, exitUi);
  if(typeof discovery?.getProviderAssessments!=='function'||typeof helpers?.createInterimUpdate!=='function'||!store)fail('REST API, discovery, enrollment helpers and durable store required');
+ 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');
+  fields(locations,['entry','interim','exit']);
+  if(['entry','interim'].some(phase=>typeof locations[phase]!=='string'||!locations[phase].trim())||Object.values(locations).some(location=>typeof location!=='string'||!location.trim()))fail('entry and interim assessment locations required; exit location must be nonempty when supplied');
+ }
+ const locationsByType={HUD:{entry:'showHudEntry',interim:'showHudInterim',exit:'showHudExit'},VA:{entry:'showVaEntry',interim:'showVaInterim',exit:'showVaExit'},...structuredClone(assessmentLocations)};
  const discover=async(input,includeExit=false)=>{
-  fields(input,['clientId','providerId','type','entryDate']);if(!positive(input.clientId)||!positive(input.providerId)||!['HUD','VA'].includes(input.type))fail('client, provider and HUD/VA type required');const at=date(input.entryDate);
+  fields(input,['clientId','providerId','type','entryDate']);if(!positive(input.clientId)||!positive(input.providerId)||!entryExitTypes.includes(input.type))fail('client, provider and supported Entry/Exit type required');const at=date(input.entryDate);
+  const locations=locationsByType[input.type];if(!locations||includeExit&&!locations.exit)fail(`assessment locations required for ${input.type}${includeExit?' including exit':''}`);
   const client=toItems(await api.clients.get({path:{clientId:input.clientId}}));if(client.length!==1||client[0].clientId!==input.clientId||client[0].isActive===false)fail('active client required');
   const catalog=await readProgramCatalog(api);const providers=catalog.providers.filter(p=>p.providerId===input.providerId);if(providers.length!==1)fail('active operational program required');
   const configuration=await discovery.getProviderAssessments({providerId:input.providerId});if(configuration.providerId!==input.providerId)fail('provider discovery mismatch');
-  const prefix=input.type==='HUD'?'showHud':'showVa',resolved={};
-  for(const [phase,suffix]of [['entry','Entry'],['interim','Interim'],...(includeExit?[['exit','Exit']]:[])]){
-   const matches=configuration.defaults.filter(d=>d.location===prefix+suffix);if(matches.length!==1||matches[0].resolution!=='resolved'||!matches[0].assessment?.code)fail('program assessment default unresolved');
+  const resolved={};
+  for(const phase of ['entry','interim',...(includeExit?['exit']:[])]){
+   const matches=configuration.defaults.filter(d=>d.location===locations[phase]);if(matches.length!==1||matches[0].resolution!=='resolved'||!matches[0].assessment?.code)fail('program assessment default unresolved');
    const assessment=matches[0].assessment;const definition=await api.assessments.getDefinition({clientId:input.clientId,assessmentCode:assessment.code,effectiveDate:at,refresh:true});
    if(definition.tenant!==api.tenant||definition.assessmentCode!==assessment.code||definition.unresolvedPicklists.length)fail('assessment metadata incomplete');
    resolved[phase]={assessment,definition};
@@ -93,7 +102,7 @@ export function createEnrollmentWorkflow({api,discovery,helpers,store,enrollment
  const run=async(kind,raw,internal={})=>{
   fields(raw,kind==='entry'?['key','clientId','providerId','type','entryDate','assessment']:['key','enrollmentKey','clientId',kind==='exit'?'exitDate':'reviewDate','assessment']);
   const input=structuredClone(raw);key(input.key);if(!positive(input.clientId))fail('client ID required');
-  if(kind==='entry'){if(!positive(input.providerId)||!['HUD','VA'].includes(input.type))fail('program and HUD/VA type required');input.entryDate=date(input.entryDate);}else{key(input.enrollmentKey);if(kind==='addition')input.entryDate=date(input.entryDate);else if(kind==='exit')input.exitDate=date(input.exitDate);else input.reviewDate=date(input.reviewDate);}
+  if(kind==='entry'){if(!positive(input.providerId)||!entryExitTypes.includes(input.type))fail('program and supported Entry/Exit type required');input.entryDate=date(input.entryDate);}else{key(input.enrollmentKey);if(kind==='addition')input.entryDate=date(input.entryDate);else if(kind==='exit')input.exitDate=date(input.exitDate);else input.reviewDate=date(input.reviewDate);}
   if(!object(input.assessment))fail('assessment plan required');
   const locked=internal.locked?async(_scope,work)=>work():store.withLock.bind(store);
   return locked(scope(input.clientId),async()=>{
@@ -263,7 +272,7 @@ export function createEnrollmentWorkflow({api,discovery,helpers,store,enrollment
   for(const member of input.members){fields(member,['clientId','assessment']);if(!positive(member.clientId)||!object(member.assessment))fail('member client and assessment required');}
   input.members.sort((a,b)=>a.clientId-b.clientId);const ids=input.members.map(m=>m.clientId);
   if(new Set(ids).size!==ids.length||kind==='entry'&&!ids.includes(input.headClientId))fail('unique members including head required');
-  if(kind==='entry'){if(!positive(input.householdId)||!positive(input.providerId)||!['HUD','VA'].includes(input.type))fail('household and program required');input.entryDate=date(input.entryDate);}
+  if(kind==='entry'){if(!positive(input.householdId)||!positive(input.providerId)||!entryExitTypes.includes(input.type))fail('household, program and supported Entry/Exit type required');input.entryDate=date(input.entryDate);}
   else{key(input.enrollmentKey);if(kind==='addition')input.entryDate=date(input.entryDate);else if(kind==='exit')input.exitDate=date(input.exitDate);else input.reviewDate=date(input.reviewDate);}
   // Read the cohort under its journal lock, then acquire all client locks in order.
   // Recheck under both locks so concurrent membership growth cannot escape protection.

package/docs/enrollments.md

@@ -27,7 +27,26 @@ REST form metadata includes question paths, mandatory flags, current option IDs/
 
 ## Enrollment workflow from program discovery
 
-`createEnrollmentWorkflow` composes the provider catalog, current program assessment defaults, question/picklist metadata, REST enrollment and answer writes, and the durable GWT interim helper. It accepts an **existing client ID** and supports HUD and VA program defaults. It does not create clients or infer program eligibility, answers, conditional applicability, or which verification types a program requires.
+`createEnrollmentWorkflow` composes the provider catalog, current program assessment defaults, question/picklist metadata, REST enrollment and answer writes, and the durable GWT interim helper. It accepts an **existing client ID**. It does not create clients or infer program eligibility, answers, conditional applicability, or which verification types a program requires.
+
+The workflow's `EntryExitType` accepts `HUD`, `Basic`, `Standard`, `RHY`, `VA`, `Basic Center Program Entry/Exit`, `PATH`, `Quick Call`, and `Transitional Living Program Entry/Exit`. `type` identifies the Entry/Exit category; `assessmentCode` identifies its assessment instrument. The workflow sends the selected type unchanged to REST. The generated REST methods accept a string; neither contract guarantees that the server permits every type for a given provider.
+
+HUD and VA retain built-in provider display locations. For another type, supply `assessmentLocations` when constructing the workflow. First inspect `getProviderAssessments({providerId}).defaults`, including each item's `label`, then map the desired type's entry, interim, and optional exit phases to their exact `location` values. These values are display-control identifiers, not assessment names, IDs, or codes. The workflow resolves the instruments from fresh provider discovery on every operation. It rejects missing, duplicate, unset, or unresolved defaults before record writes and never falls back to another type.
+
+```ts
+const workflow = createEnrollmentWorkflow({
+  api, discovery, helpers, store,
+  assessmentLocations: {
+    PATH: {
+      entry: selectedPathEntry.location,
+      interim: selectedPathInterim.location,
+      exit: selectedPathExit.location,
+    },
+  },
+});
+```
+
+`assessmentLocations` is a partial map keyed by `EntryExitType`. Each supplied mapping requires nonempty `entry` and `interim` locations; `exit` is required for `discoverExit` and household exits. A supplied HUD or VA mapping replaces that type's built-in mapping. Keep the same configuration across retries and use separate workflow instances when providers need different location mappings. Existing journal checks still reject changed instruments or definitions. Additional types have synthetic workflow coverage, not new live acceptance evidence. The November 2, 2026 report of type rejection was traced to the SDK's former HUD/VA restriction, not a reproduced WellSky server failure.
 
 ```ts
 import {

package/docs/reference.md

@@ -36,7 +36,7 @@ Runtime exports: `AttachmentConflictError`, `EnrollmentWorkflowError`, `LoginErr
 | Profile fields and Sex | [Client profile](../browser/client-profile.d.mts) | `read`, `update` |
 | Calendar DOB | [Birth dates](../browser/date-of-birth.d.mts) | `read`, `validate`, `verify`, `update` |
 | Provider assessment defaults | [Discovery](../browser/program-discovery.d.mts) | `listAssessments`, `getProviderAssessments` |
-| Enrollment and household lifecycle | [Workflow](../browser/enrollment-workflow.d.mts) | Discovery, entry, member additions, interim, exit, journal status |
+| Enrollment and household lifecycle | [Workflow](../browser/enrollment-workflow.d.mts) | Discovery, entry, member additions, interim, exit, journal status; `EntryExitType` and per-type `assessmentLocations` in [enrollments](enrollments.md) |
 | Entry-date and exit UI ports | [Member entry](../browser/member-entry-date.d.mts), [exit](../browser/household-exit.d.mts) | Fresh reads and targeted completion |
 | Services and recovery diagnostics | [Service recording](../browser/service-recording.d.mts) | `record`, `recordBulk`, Funding Sources, `RecoveryDiagnostic` |
 | SSVF conditional rules | [SSVF types](../browser/ssvf-rules.d.mts) | [Field rules](../SSVF.md) and dated option snapshots |

package/docs/using-the-sdk.md

@@ -6,7 +6,7 @@ This guide takes an application from installation to its first REST read and bro
 
 ## 1. Install the package
 
-Install from the public npm registry. No registry token is required. For the private registry, follow [Install from GitLab](../README.md#install-from-gitlab).
+Install from the public npm registry. No registry token is required.
 
 ```sh
 npm install @choiceapps/communityservices-sdk
@@ -46,11 +46,10 @@ This runs the real SDK validation and transport through a fake that cannot conta
 
 The application supplies the tenant. Every tenant uses the same SDK operations; no environment switch or separate helper names are needed. Tenant IDs, provider IDs, client IDs, and picklist choices must come from the deployment you are connecting to.
 
-REST and browser credentials are separate. A registry token is only needed if you choose the private GitLab registry:
+REST and browser credentials are separate:
 
 | Credential | Used for |
 | --- | --- |
-| `GITLAB_NPM_TOKEN` | Downloading the package from GitLab |
 | REST username/password, token, or token provider | Authenticating `WellSkyClient` API requests |
 | `HMIS_UI_USER` and `HMIS_UI_PASSWORD` | Signing in to the web application through a browser helper |
 

package/examples/enrollment-workflow.mts

@@ -1,5 +1,6 @@
 import {
   createEnrollmentWorkflow,
+  type EntryExitType,
   type EnrollmentAssessmentPlan,
   type EnrollmentWorkflowDiscovery,
   type EnrollmentWorkflowResult,
@@ -7,13 +8,15 @@ import {
 } from '@choiceapps/communityservices-sdk/browser';
 
 /** Call with a REST client, authenticated discovery/enrollment adapters,
- * a birthDates adapter for DOB plans, and the same durable store on every run. This example does not log in or run itself. */
+ * a birthDates adapter for DOB plans, and the same durable store on every run.
+ * Types other than HUD/VA require dependencies.assessmentLocations from current provider discovery.
+ * This example does not log in or run itself. */
 export async function enrollAndReview(
   dependencies:EnrollmentWorkflowOptions,
   input:{
     clientId:number;
     providerId:number;
-    type:'HUD'|'VA';
+    type:EntryExitType;
     /** Stable application record ID, not a new UUID on each retry. */
     sourceId:string;
     entryDate:string;

package/package.json

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