@registrystack/client 0.40.0 → 0.41.0

package/README.md

@@ -9,7 +9,7 @@ Engine, Casework, Messaging, and Scheduling client APIs in Registry Stack.
 npm install "@registrystack/client@<version>"
 ```
 
-Requires Node.js 22.12 or newer. Supported targets are macOS arm64, Linux
+Requires Node.js 24.11 or newer. Supported targets are macOS arm64, Linux
 arm64 with glibc, and Linux x64 with glibc; installing the package pulls in
 one platform-specific optional dependency containing all six native
 bindings.

package/casework/client.d.ts

@@ -37,15 +37,21 @@ export interface TaskPermission { collection: string; operations: ReadonlyArray<
 export interface SchedulingTaskPermission { service: string; location: string; actions: ReadonlyArray<string> }
 export interface EvidenceRequesterContext { requesterTags: ReadonlyArray<string>; audience: string }
 export interface TaskApprovalRequest { templateId: string; templateVersion: string }
+/** Deferred authority keeps its approved deadline; execution credentials stay short-lived. */
+export type TaskAuthorizationMode = 'immediate' | 'deferred'
 export interface TaskTemplatePreview {
   id: string; version: string; label: string; agent: IssuerPrincipal; client: string; resource: string; scopes: ReadonlyArray<string>; purpose: string
   evidenceContext?: EvidenceRequesterContext; bounds: TaskGrantBounds; subjects: { readonly [key: string]: Exclude<JsonScalar, null> }; lifetimeSeconds: SafeInteger
+  /** Omitted for the existing immediate mode. */
+  authorizationMode?: TaskAuthorizationMode
 }
 export interface TaskTemplatePreviews { itemRevision: SafeInteger; templates: ReadonlyArray<TaskTemplatePreview> }
 /** Grant metadata deliberately excludes stored subject values. */
 export interface TaskGrantView {
   id: string; templateId: string; templateVersion: string; agent: IssuerPrincipal; client: string; resource: string; scopes: ReadonlyArray<string>; purpose: string
   evidenceContext?: EvidenceRequesterContext; bounds: TaskGrantBounds; expiresAt: SafeInteger; invalidated: boolean
+  /** Omitted for the existing immediate mode. */
+  authorizationMode?: TaskAuthorizationMode
 }
 export interface TaskGrantList { grants: ReadonlyArray<TaskGrantView> }
 export interface TaskGrantRevocation { id: string; invalidated: boolean }

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.41.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.41.0",
   "description": "Unified Node.js client for Registry Stack products.",
   "license": "Apache-2.0",
   "homepage": "https://docs.registrystack.org/reference/client-api/",
@@ -46,7 +46,7 @@
     "scheduling"
   ],
   "engines": {
-    "node": ">=22.12.0"
+    "node": ">=24.11.0"
   },
   "scripts": {
     "sync": "python3 ../../release/scripts/sync-registry-client-node.py",
@@ -55,12 +55,12 @@
     "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.1",
     "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.41.0",
+    "@registrystack/client-linux-arm64-gnu": "0.41.0",
+    "@registrystack/client-linux-x64-gnu": "0.41.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>