@healthcloudai/hc-sdk 3.21.0 → 3.23.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +212 -1
- package/dist/index.d.cts +821 -2
- package/dist/index.d.ts +821 -2
- package/dist/index.js +212 -1
- package/docs/clients/PatientClient.md +3 -0
- package/docs/clients/QuestClient.md +1 -1
- package/docs/docs-manifest.json +17 -3
- package/docs/examples/index.md +4 -1
- package/docs/index.md +4 -1
- package/docs/models/CatalogItemKind.md +15 -0
- package/docs/models/CatalogVendor.md +15 -0
- package/docs/models/CollectionModality.md +15 -0
- package/docs/models/EncounterClinicalState.md +31 -0
- package/docs/models/EncounterEffect.md +18 -0
- package/docs/models/EncounterOperationError.md +18 -0
- package/docs/models/EncounterOperationResponse.md +22 -0
- package/docs/models/EncounterSections.md +22 -0
- package/docs/models/GetTestOrderResponse.md +1 -0
- package/docs/models/ObservedEncounterResponse.md +26 -0
- package/docs/models/OrderItem.md +4 -0
- package/docs/models/PlaceTestOrderResponse.md +1 -0
- package/docs/models/QuestRetrieveCompendiumResponse.md +5 -0
- package/docs/models/SubmitEncounterOperationRequest.md +18 -0
- package/docs/models/TestOrder.md +1 -0
- package/docs/models/UnknownEncounterOperation.md +18 -0
- package/docs/models/index.md +11 -0
- package/docs/operations/connectors.questRetrieveCompendium.md +17 -2
- package/docs/operations/patient.getPatientEncounterClinicalState.md +170 -0
- package/docs/operations/patient.getPatientEncounterOperation.md +151 -0
- package/docs/operations/patient.getTestOrder.md +1 -0
- package/docs/operations/patient.listOrderItems.md +12 -4
- package/docs/operations/patient.listTestOrders.md +1 -0
- package/docs/operations/patient.placeTestOrder.md +2 -0
- package/docs/operations/patient.submitPatientEncounterOperation.md +161 -0
- package/docs/operations/patient.submitPatientIntakeOperation.md +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
# Execute or replay one keyed agent encounter operation
|
|
2
|
+
|
|
3
|
+
Operation ID: `patient.submitPatientEncounterOperation`
|
|
4
|
+
|
|
5
|
+
Derives tenant/patient from patient login and binds the key to exact reviewed public-conversation notes. A committed first-dispatch marker precedes the shared encounter pipeline. Existing pending/unknown keys return HTTP 202 without repeating writes; recorded responses replay under HTTP 200 with their original response_code and a sanitized observation body. Recorded is not independent proof that every clinical effect succeeded. Requires a separately provisioned operation journal; fails closed without it.
|
|
6
|
+
|
|
7
|
+
## Public method
|
|
8
|
+
|
|
9
|
+
`submitPatientEncounterOperation`
|
|
10
|
+
|
|
11
|
+
Signature: `patient.submitPatientEncounterOperation(request)`
|
|
12
|
+
|
|
13
|
+
Return type: `Promise<EncounterOperationResponse>`
|
|
14
|
+
|
|
15
|
+
## Authentication
|
|
16
|
+
|
|
17
|
+
Classification: **AUTHENTICATED**
|
|
18
|
+
|
|
19
|
+
Schemes: `bearerAuth`
|
|
20
|
+
|
|
21
|
+
## Prerequisites
|
|
22
|
+
|
|
23
|
+
None documented.
|
|
24
|
+
|
|
25
|
+
## HTTP
|
|
26
|
+
|
|
27
|
+
`POST /patients/encounter/operations`
|
|
28
|
+
|
|
29
|
+
## Path parameters
|
|
30
|
+
|
|
31
|
+
None.
|
|
32
|
+
|
|
33
|
+
## Query parameters
|
|
34
|
+
|
|
35
|
+
None.
|
|
36
|
+
|
|
37
|
+
## Body parameters
|
|
38
|
+
|
|
39
|
+
| Name | Type | Required | Format | Allowed values | Default | Nullable | Description |
|
|
40
|
+
|---|---|---:|---|---|---|---:|---|
|
|
41
|
+
| `body` | [`SubmitEncounterOperationRequest`](../models/SubmitEncounterOperationRequest.md) | Yes | | | | No | |
|
|
42
|
+
|
|
43
|
+
Request model: [`SubmitEncounterOperationRequest`](../models/SubmitEncounterOperationRequest.md)
|
|
44
|
+
|
|
45
|
+
## Request example
|
|
46
|
+
|
|
47
|
+
```json
|
|
48
|
+
{
|
|
49
|
+
"idempotency_key": "940be5cc-c1fd-4b38-ae7d-13516f9ac098",
|
|
50
|
+
"notes": "Synthetic encounter note."
|
|
51
|
+
}
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## Success responses
|
|
55
|
+
|
|
56
|
+
| Status | Shape | Content type | Description |
|
|
57
|
+
|---|---|---|---|
|
|
58
|
+
| `200` | [`EncounterOperationResponse`](../models/EncounterOperationResponse.md) | application/json | Scope/key-bound journal state; recorded HTTP response is not independent clinical success evidence |
|
|
59
|
+
| `202` | [`EncounterOperationResponse`](../models/EncounterOperationResponse.md) | application/json | Scope/key-bound journal state; recorded HTTP response is not independent clinical success evidence |
|
|
60
|
+
|
|
61
|
+
## Success response examples
|
|
62
|
+
|
|
63
|
+
None declared in canonical OpenAPI.
|
|
64
|
+
|
|
65
|
+
## Common errors
|
|
66
|
+
|
|
67
|
+
| Status | Shape | Content type | Description |
|
|
68
|
+
|---|---|---|---|
|
|
69
|
+
| `401` | [`EncounterOperationError`](../models/EncounterOperationError.md) | application/json | Patient login required |
|
|
70
|
+
| `403` | [`EncounterOperationError`](../models/EncounterOperationError.md) | application/json | Verified tenant required |
|
|
71
|
+
| `404` | [`EncounterOperationError`](../models/EncounterOperationError.md) | application/json | Patient or operation not found; an in-flight operation may still commit |
|
|
72
|
+
| `409` | [`EncounterOperationError`](../models/EncounterOperationError.md) | application/json | Key already bound to different raw terms |
|
|
73
|
+
| `422` | [`EncounterOperationError`](../models/EncounterOperationError.md) | application/json | Invalid key or encounter terms |
|
|
74
|
+
| `503` | [`EncounterOperationError`](../models/EncounterOperationError.md) | application/json | Coordination or outcome unavailable; look up the original key, never fall back to an unkeyed write |
|
|
75
|
+
|
|
76
|
+
## Error examples
|
|
77
|
+
|
|
78
|
+
### 401
|
|
79
|
+
|
|
80
|
+
```json
|
|
81
|
+
{
|
|
82
|
+
"error": "string"
|
|
83
|
+
}
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
### 403
|
|
87
|
+
|
|
88
|
+
```json
|
|
89
|
+
{
|
|
90
|
+
"error": "string"
|
|
91
|
+
}
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
### 404
|
|
95
|
+
|
|
96
|
+
```json
|
|
97
|
+
{
|
|
98
|
+
"error": "string"
|
|
99
|
+
}
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
### 409
|
|
103
|
+
|
|
104
|
+
```json
|
|
105
|
+
{
|
|
106
|
+
"error": "string"
|
|
107
|
+
}
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
### 422
|
|
111
|
+
|
|
112
|
+
```json
|
|
113
|
+
{
|
|
114
|
+
"error": "string"
|
|
115
|
+
}
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
### 503
|
|
119
|
+
|
|
120
|
+
```json
|
|
121
|
+
{
|
|
122
|
+
"error": "string"
|
|
123
|
+
}
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
## NodeJS / TypeScript implementation
|
|
127
|
+
|
|
128
|
+
```ts
|
|
129
|
+
import { HCSDK } from "@healthcloudai/hc-sdk";
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
```ts
|
|
133
|
+
const request = {
|
|
134
|
+
"idempotency_key": "940be5cc-c1fd-4b38-ae7d-13516f9ac098",
|
|
135
|
+
"notes": "Synthetic encounter note."
|
|
136
|
+
};
|
|
137
|
+
|
|
138
|
+
const result = await patient.submitPatientEncounterOperation(request);
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
## cURL
|
|
142
|
+
|
|
143
|
+
```bash
|
|
144
|
+
curl -X POST \
|
|
145
|
+
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
|
|
146
|
+
-H 'Content-Type: application/json' \
|
|
147
|
+
-d '{"idempotency_key":"940be5cc-c1fd-4b38-ae7d-13516f9ac098","notes":"Synthetic encounter note."}' \
|
|
148
|
+
'https://dev-api-patient.health.cloud/patients/encounter/operations'
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
## Notes
|
|
152
|
+
|
|
153
|
+
None.
|
|
154
|
+
|
|
155
|
+
## Prepared Test Console scenario
|
|
156
|
+
|
|
157
|
+
No canonical scenario is currently associated.
|
|
158
|
+
|
|
159
|
+
## Real response
|
|
160
|
+
|
|
161
|
+
No approved real integration response is currently published. Unapproved candidates are never rendered as examples.
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Operation ID: `patient.submitPatientIntakeOperation`
|
|
4
4
|
|
|
5
|
-
Derives tenant/patient from patient login and binds the key to exact raw section/summary. A committed first-dispatch marker precedes the shared intake pipeline. Existing pending/unknown keys return HTTP 202 without repeating writes; recorded responses replay under HTTP 200 with their original response_code
|
|
5
|
+
Derives tenant/patient from patient login and binds the key to exact raw section/summary. A committed first-dispatch marker precedes the shared intake pipeline. Existing pending/unknown keys return HTTP 202 without repeating writes; recorded responses replay under HTTP 200 with their original response_code and a sanitized observation body. Recorded is not independent proof that every clinical effect succeeded. Requires a separately provisioned operation journal; fails closed without it.
|
|
6
6
|
|
|
7
7
|
## Public method
|
|
8
8
|
|
package/package.json
CHANGED