@registrystack/client 0.40.0 → 0.42.0

package/casework/client.js

@@ -13,7 +13,7 @@ class CaseworkClientError extends Error {
     this.name = 'CaseworkClientError';
     this.kind = envelope.kind;
     this.outcomeUnknown = envelope.outcomeUnknown === true;
-    for (const field of ['code', 'detail', 'status', 'traceId', 'originalAttemptId', 'validation', 'transportKind', 'protocolFailure']) {
+    for (const field of ['code', 'detail', 'status', 'traceId', 'validation', 'transportKind', 'protocolFailure']) {
       if (envelope[field] !== undefined && envelope[field] !== null) this[field] = envelope[field];
     }
   }
@@ -112,16 +112,16 @@ for (const [method, jsonIndexes] of [
   ['reviewResult', [2]],
   ['reviewResults', [2]],
   ['cancelReviewRequest', [2, 4]],
-  ['reviewKinds', []],
-  ['reviewKind', []],
+  ['reviewPolicies', []],
+  ['reviewPolicy', []],
   ['reviewTasks', [2]],
   ['ownReviewDecisions', [2]],
   ['supervisoryReviewTasks', [2]],
   ['reviewTask', []],
   ['reviewTaskContext', []],
-  ['previewReviewTaskTemplates', []],
-  ['listReviewTaskGrants', []],
-  ['approveReviewTaskGrant', [6]],
+  ['previewReviewTaskTemplates', [2]],
+  ['listReviewTaskGrants', [2]],
+  ['approveReviewTaskGrant', [5]],
   ['revokeReviewTaskGrant', []],
   ['claimReviewTask', []],
   ['releaseReviewTask', []],
@@ -135,30 +135,14 @@ for (const [method, jsonIndexes] of [
   ['addReviewNote', [4]],
   ['reviewClocks', []],
   ['reviewAccountability', []],
-  ['listWorkItems', [3]],
-  ['nextWorkItem', [3]],
-  ['getWorkItem', []],
-  ['previewTaskTemplates', []],
-  ['listTaskGrants', []],
-  ['approveTaskGrant', [6]],
-  ['revokeTaskGrant', []],
   ['taskAssertion', []],
   ['taskGrantStatus', []],
-  ['claimWorkItem', [3]],
-  ['releaseWorkItem', [3]],
-  ['getDraft', []],
-  ['saveDraft', [6]],
-  ['deleteDraft', []],
-  ['decideWorkItem', [3, 5]],
-  ['recoverDecision', [5]],
-  ['recoverDecisionByKey', [5]],
-  ['workItemHistory', [4]],
-  ['holdings', [3]],
+  ['nextReviewTask', [2]],
+  ['reviewTaskHoldings', [2]],
   ['directory', []],
   ['directoryTargets', [2]],
   ['bootstrapDirectory', [4]],
   ['updateDirectoryTeam', [5]],
-  ['workItemClocks', []],
   ['holidayRevision', []],
   ['createHolidayRevision', [3]],
   ['previewClockRecompute', [2]],
@@ -167,9 +151,7 @@ for (const [method, jsonIndexes] of [
   ['createAbsence', [4]],
   ['updateAbsence', [5]],
   ['deleteAbsence', []],
-  ['assignWorkItem', [5]],
-  ['delegateWorkItem', [5]],
-  ['previewCaseloadMove', [2, 3]],
+  ['previewCaseloadMove', [2]],
   ['applyCaseloadMove', [3]],
 ]) {
   CaseworkClient.prototype[method] = function (...args) {
@@ -184,4 +166,14 @@ for (const [method, jsonIndexes] of [
   };
 }
 
-module.exports = { CaseworkClient, CaseworkClientError };
+// Hash the same sanitized request that admission sends. Rust owns canonical
+// ordering, portable JSON validation, and the producer/namespace binding.
+function submissionDigest(producer, sourceNamespace, request) {
+  try {
+    return native.submissionDigest(producer, sourceNamespace, sanitize(request, 'invalid-request'));
+  } catch (error) {
+    throw normalized(error, 'invalid-request');
+  }
+}
+
+module.exports = { CaseworkClient, CaseworkClientError, submissionDigest };

package/casework/index.d.ts

@@ -9,16 +9,18 @@ export declare class CaseworkClient {
   reviewResult(token: string, profile: string, accepted: any): Promise<CaseworkOutcome>
   reviewResults(token: string, profile: string, query?: any | undefined | null): Promise<CaseworkOutcome>
   cancelReviewRequest(token: string, profile: string, accepted: any, idempotencyKey: string, request: any): Promise<CaseworkOutcome>
-  reviewKinds(token: string, profile: string): Promise<CaseworkOutcome>
-  reviewKind(token: string, profile: string, kindId: string): Promise<CaseworkOutcome>
+  reviewPolicies(token: string, profile: string): Promise<CaseworkOutcome>
+  reviewPolicy(token: string, profile: string, policyId: string): Promise<CaseworkOutcome>
   reviewTasks(token: string, profile: string, query?: any | undefined | null, sourceProfile?: string | undefined | null): Promise<CaseworkOutcome>
+  nextReviewTask(token: string, profile: string, query?: any | undefined | null, sourceProfile?: string | undefined | null): Promise<CaseworkOutcome>
+  reviewTaskHoldings(token: string, profile: string, query?: any | undefined | null, sourceProfile?: string | undefined | null): Promise<CaseworkOutcome>
   reviewTask(token: string, profile: string, taskId: string, sourceProfile?: string | undefined | null): Promise<CaseworkOutcome>
   ownReviewDecisions(token: string, profile: string, query?: any | undefined | null, sourceProfile?: string | undefined | null): Promise<CaseworkOutcome>
   supervisoryReviewTasks(token: string, profile: string, query?: any | undefined | null, sourceProfile?: string | undefined | null): Promise<CaseworkOutcome>
   reviewTaskContext(token: string, profile: string, taskId: string, sourceProfile?: string | undefined | null): Promise<CaseworkOutcome>
-  previewReviewTaskTemplates(token: string, profile: string, sourceProfile: string, taskId: string): Promise<CaseworkOutcome>
-  listReviewTaskGrants(token: string, profile: string, sourceProfile: string, taskId: string): Promise<CaseworkOutcome>
-  approveReviewTaskGrant(token: string, profile: string, sourceProfile: string, taskId: string, expectedRevision: number, idempotencyKey: string, approval: any): Promise<CaseworkOutcome>
+  previewReviewTaskTemplates(token: string, profile: string, options: ReviewTaskGrantReadOptions): Promise<CaseworkOutcome>
+  listReviewTaskGrants(token: string, profile: string, options: ReviewTaskGrantReadOptions): Promise<CaseworkOutcome>
+  approveReviewTaskGrant(token: string, profile: string, taskId: string, expectedRevision: number, idempotencyKey: string, approval: any, sourceProfile?: string | undefined | null): Promise<CaseworkOutcome>
   revokeReviewTaskGrant(token: string, profile: string, taskId: string, grantId: string): Promise<CaseworkOutcome>
   claimReviewTask(token: string, profile: string, taskId: string, expectedRevision: number, idempotencyKey: string, sourceProfile?: string | undefined | null): Promise<CaseworkOutcome>
   releaseReviewTask(token: string, profile: string, taskId: string, expectedRevision: number, idempotencyKey: string): Promise<CaseworkOutcome>
@@ -32,26 +34,9 @@ export declare class CaseworkClient {
   addReviewNote(token: string, profile: string, requestId: string, idempotencyKey: string, note: any, sourceProfile?: string | undefined | null): Promise<CaseworkOutcome>
   reviewClocks(token: string, profile: string, requestId: string, sourceProfile?: string | undefined | null): Promise<CaseworkOutcome>
   reviewAccountability(token: string, profile: string, eventId: string): Promise<CaseworkOutcome>
-  listWorkItems(token: string, profile: string, sourceProfile: string, query: any): Promise<CaseworkOutcome>
-  nextWorkItem(token: string, profile: string, sourceProfile: string, query?: any | undefined | null): Promise<CaseworkOutcome>
-  getWorkItem(token: string, profile: string, sourceProfile: string, itemId: string): Promise<CaseworkOutcome>
-  previewTaskTemplates(token: string, profile: string, sourceProfile: string, itemId: string): Promise<CaseworkOutcome>
-  listTaskGrants(token: string, profile: string, sourceProfile: string, itemId: string): Promise<CaseworkOutcome>
-  approveTaskGrant(token: string, profile: string, sourceProfile: string, itemId: string, expectedRevision: number, idempotencyKey: string, approval: any): Promise<CaseworkOutcome>
-  revokeTaskGrant(token: string, profile: string, sourceProfile: string, itemId: string, grantId: string): Promise<CaseworkOutcome>
   taskAssertion(token: string, grantId: string): Promise<CaseworkOutcome>
   taskAssertionEndpoint(grantId: string): string
   taskGrantStatus(token: string, grantId: string): Promise<CaseworkOutcome>
-  claimWorkItem(token: string, profile: string, sourceProfile: string, action: any, idempotencyKey: string): Promise<CaseworkOutcome>
-  releaseWorkItem(token: string, profile: string, sourceProfile: string, action: any, idempotencyKey: string): Promise<CaseworkOutcome>
-  getDraft(token: string, profile: string, sourceProfile: string, itemId: string): Promise<CaseworkOutcome>
-  saveDraft(token: string, profile: string, sourceProfile: string, itemId: string, expectedRevision: number, idempotencyKey: string, draft: any): Promise<CaseworkOutcome>
-  deleteDraft(token: string, profile: string, sourceProfile: string, itemId: string, expectedRevision: number, idempotencyKey: string): Promise<CaseworkOutcome>
-  decideWorkItem(token: string, profile: string, sourceProfile: string, action: any, idempotencyKey: string, decision: any): Promise<CaseworkOutcome>
-  recoverDecision(token: string, profile: string, sourceProfile: string, itemId: string, attemptId: string, recovery: any): Promise<CaseworkOutcome>
-  recoverDecisionByKey(token: string, profile: string, sourceProfile: string, itemId: string, idempotencyKey: string, recovery: any): Promise<CaseworkOutcome>
-  workItemHistory(token: string, profile: string, sourceProfile: string, itemId: string, query?: any | undefined | null): Promise<CaseworkOutcome>
-  holdings(token: string, profile: string, sourceProfile: string, query?: any | undefined | null): Promise<CaseworkOutcome>
   directory(token: string, profile: string): Promise<CaseworkOutcome>
   directoryTargets(token: string, profile: string, query: any): Promise<CaseworkOutcome>
   bootstrapDirectory(token: string, profile: string, expectedRevision: number, idempotencyKey: string, bootstrap: any): Promise<CaseworkOutcome>
@@ -59,12 +44,9 @@ export declare class CaseworkClient {
   createAbsence(token: string, profile: string, expectedRevision: number, idempotencyKey: string, request: any): Promise<CaseworkOutcome>
   updateAbsence(token: string, profile: string, absenceId: string, expectedRevision: number, idempotencyKey: string, request: any): Promise<CaseworkOutcome>
   deleteAbsence(token: string, profile: string, absenceId: string, expectedRevision: number, idempotencyKey: string): Promise<CaseworkOutcome>
-  assignWorkItem(token: string, profile: string, itemId: string, expectedRevision: number, idempotencyKey: string, request: any, sourceProfile?: string | undefined | null): Promise<CaseworkOutcome>
-  delegateWorkItem(token: string, profile: string, itemId: string, expectedRevision: number, idempotencyKey: string, request: any, sourceProfile?: string | undefined | null): Promise<CaseworkOutcome>
-  previewCaseloadMove(token: string, profile: string, movement: any, query?: any | undefined | null, sourceProfile?: string | undefined | null): Promise<CaseworkOutcome>
+  previewCaseloadMove(token: string, profile: string, movement: any, sourceProfile?: string | undefined | null): Promise<CaseworkOutcome>
   applyCaseloadMove(token: string, profile: string, idempotencyKey: string, request: any, sourceProfile?: string | undefined | null): Promise<CaseworkOutcome>
   updateDirectoryTeam(token: string, profile: string, teamId: string, expectedRevision: number, idempotencyKey: string, request: any): Promise<CaseworkOutcome>
-  workItemClocks(token: string, profile: string, sourceProfile: string, itemId: string): Promise<CaseworkOutcome>
   holidayRevision(token: string, profile: string, holidaySet: string, revision: number): Promise<CaseworkOutcome>
   createHolidayRevision(token: string, profile: string, idempotencyKey: string, request: any): Promise<CaseworkOutcome>
   previewClockRecompute(token: string, profile: string, request: any): Promise<CaseworkOutcome>
@@ -90,3 +72,12 @@ export interface CaseworkOutcome {
   value: any
   traceId: string
 }
+
+/** Identify a human task grant read without positional string ambiguity. */
+export interface ReviewTaskGrantReadOptions {
+  taskId: string
+  sourceProfile?: string
+}
+
+/** Compute the canonical producer submission digest locally, without I/O. */
+export declare function submissionDigest(producer: string, sourceNamespace: string, request: any): string

package/discovery/client.d.ts

@@ -169,9 +169,6 @@ export function selectEvidenceService(
  */
 export function validateSelectionStructure<T extends CommonServiceSelection>(selection: T): T;
 
-/** @deprecated Use validateSelectionStructure. This operation is structural, not trust. */
-export function validateSelection<T extends CommonServiceSelection>(selection: T): T;
-
 export class AcceptedServiceSelection<T extends CommonServiceSelection> {
   private constructor();
   private readonly __acceptedServiceSelectionBrand: void;

package/discovery/client.js

@@ -275,10 +275,6 @@ function validateSelectionStructure(selection) {
   }
 }
 
-function validateSelection(selection) {
-  return validateSelectionStructure(selection);
-}
-
 function acceptSelection(selection, accepts) {
   const checked = validateSelectionStructure(selection);
   if (typeof accepts !== 'function') throw inputError('query');
@@ -304,6 +300,5 @@ module.exports = {
   selectEvidenceAlternative,
   selectEvidenceService,
   selectExact,
-  validateSelection,
   validateSelectionStructure,
 };

package/discovery/index.d.ts

@@ -27,6 +27,4 @@ export declare function selectEvidenceService(response: any, request: any): any
 
 export declare function selectExact(response: any, request: any): any
 
-export declare function validateSelection(selection: any): any
-
 export declare function validateSelectionStructure(selection: any): any

package/messaging/client.d.ts

@@ -109,6 +109,7 @@ export type MessagingProblemCode =
   | 'profile.not-authorized'
   | 'quota.exceeded'
   | 'rate-limit.exceeded'
+  | 'receipt.unresolved'
   | 'request.body-too-large'
   | 'request.invalid'
   | 'request.method-not-allowed'
@@ -156,6 +157,8 @@ export class MessagingClient {
   health(): Promise<MessagingOutcome<null>>
   ready(): Promise<MessagingOutcome<null>>
   submit(token: string, idempotencyKey: string, request: SubmitMessageRequest): Promise<MessagingOutcome<MessageReceipt>>
+  /** Observe the original success using the same body/key and current token; never resend or mutate. */
+  messageReceipt(token: string, idempotencyKey: string, request: SubmitMessageRequest): Promise<MessagingOutcome<MessageReceipt>>
   message(token: string, messageId: MessageId): Promise<MessagingOutcome<MessageView>>
   cancel(token: string, messageId: MessageId): Promise<MessagingOutcome<MessageView>>
   preview(token: string, templateId: string, version: string, request: TemplatePreviewRequest): Promise<MessagingOutcome<TemplatePreview>>

package/messaging/client.js

@@ -113,6 +113,7 @@ for (const [method, jsonIndexes] of [
   ['health', []],
   ['ready', []],
   ['submit', [2]],
+  ['messageReceipt', [2]],
   ['message', []],
   ['cancel', []],
   ['preview', [3]],

package/messaging/index.d.ts

@@ -6,6 +6,7 @@ export declare class MessagingClient {
   health(): Promise<MessagingOutcome>
   ready(): Promise<MessagingOutcome>
   submit(token: string, idempotencyKey: string, request: any): Promise<MessagingOutcome>
+  messageReceipt(token: string, idempotencyKey: string, request: any): Promise<MessagingOutcome>
   message(token: string, messageId: string): Promise<MessagingOutcome>
   cancel(token: string, messageId: string): Promise<MessagingOutcome>
   preview(token: string, templateId: string, version: string, request: any): Promise<MessagingOutcome>

package/native.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const PACKAGE_VERSION = '0.40.0';
+const PACKAGE_VERSION = '0.42.0';
 const PRODUCTS = new Set(['discovery', 'evidence', 'breg', 'casework', 'messaging', 'scheduling']);
 
 function target() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@registrystack/client",
-  "version": "0.40.0",
+  "version": "0.42.0",
   "description": "Unified Node.js client for Registry Stack products.",
   "license": "Apache-2.0",
   "homepage": "https://docs.registrystack.org/reference/client-api/",
@@ -46,21 +46,21 @@
     "scheduling"
   ],
   "engines": {
-    "node": ">=22.12.0"
+    "node": ">=24.11.0"
   },
   "scripts": {
     "sync": "python3 ../../release/scripts/sync-registry-client-node.py",
     "sync:check": "python3 ../../release/scripts/sync-registry-client-node.py --check",
-    "test": "npm run sync:check && node --test __test__/*.test.js",
+    "test": "npm run sync:check && node ../../scripts/run-node-tests.mjs __test__/*.test.js",
     "check:types": "tsc --noEmit --strict --skipLibCheck false --types node --moduleResolution node16 --module node16 --target es2022 index.d.ts __test__/facade.test-d.ts"
   },
   "devDependencies": {
-    "@types/node": "22.20.5",
+    "@types/node": "24.19.2",
     "typescript": "6.0.3"
   },
   "optionalDependencies": {
-    "@registrystack/client-darwin-arm64": "0.40.0",
-    "@registrystack/client-linux-arm64-gnu": "0.40.0",
-    "@registrystack/client-linux-x64-gnu": "0.40.0"
+    "@registrystack/client-darwin-arm64": "0.42.0",
+    "@registrystack/client-linux-arm64-gnu": "0.42.0",
+    "@registrystack/client-linux-x64-gnu": "0.42.0"
   }
 }

package/scheduling/client.d.ts

@@ -170,6 +170,7 @@ export type SchedulingProblemCode =
   | 'precondition.required'
   | 'prerequisite.missing'
   | 'profile.not-authorized'
+  | 'receipt.unresolved'
   | 'request.body-too-large'
   | 'request.invalid'
   | 'request.method-not-allowed'
@@ -216,6 +217,8 @@ export class SchedulingClient {
   createHold(token: string, idempotencyKey: string, request: AdmissionRequest): Promise<SchedulingOutcome<HoldDocument>>
   releaseHold(token: string, holdId: string): Promise<SchedulingOutcome<null>>
   createAppointment(token: string, idempotencyKey: string, request: CreateAppointmentRequest): Promise<SchedulingOutcome<AppointmentDocument>>
+  /** Observe the original success using the same body/key and current token; never resend or mutate. */
+  appointmentReceipt(token: string, idempotencyKey: string, request: CreateAppointmentRequest): Promise<SchedulingOutcome<AppointmentDocument>>
   getAppointment(token: string, appointmentId: string): Promise<SchedulingOutcome<AppointmentDocument>>
   listAppointments(token: string, reference: ExternalReference, page?: PageQuery | null): Promise<SchedulingOutcome<PageDocument<AppointmentDocument>>>
   rescheduleAppointment(token: string, appointmentId: string, idempotencyKey: string, request: RescheduleAppointmentRequest): Promise<SchedulingOutcome<AppointmentDocument>>

package/scheduling/client.js

@@ -118,6 +118,7 @@ for (const [method, jsonIndexes] of [
   ['createHold', [2]],
   ['releaseHold', []],
   ['createAppointment', [2]],
+  ['appointmentReceipt', [2]],
   ['getAppointment', []],
   ['listAppointments', [1, 2]],
   ['rescheduleAppointment', [3]],

package/scheduling/index.d.ts

@@ -11,6 +11,7 @@ export declare class SchedulingClient {
   createHold(token: string, idempotencyKey: string, request: any): Promise<SchedulingOutcome>
   releaseHold(token: string, holdId: string): Promise<SchedulingOutcome>
   createAppointment(token: string, idempotencyKey: string, request: any): Promise<SchedulingOutcome>
+  appointmentReceipt(token: string, idempotencyKey: string, request: any): Promise<SchedulingOutcome>
   getAppointment(token: string, appointmentId: string): Promise<SchedulingOutcome>
   listAppointments(token: string, reference: any, page?: any | undefined | null): Promise<SchedulingOutcome>
   rescheduleAppointment(token: string, appointmentId: string, idempotencyKey: string, request: any): Promise<SchedulingOutcome>