@healthcloudai/hc-sdk 3.13.4 → 3.15.1

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.
Files changed (61) hide show
  1. package/dist/index.cjs +495 -72
  2. package/dist/index.d.cts +2342 -1390
  3. package/dist/index.d.ts +2342 -1390
  4. package/dist/index.js +495 -72
  5. package/docs/clients/AthenaHealthClient.md +1 -1
  6. package/docs/clients/PatientClient.md +11 -0
  7. package/docs/docs-manifest.json +35 -3
  8. package/docs/examples/index.md +12 -1
  9. package/docs/index.md +12 -1
  10. package/docs/models/AssignImpiloDeviceRequest.md +17 -0
  11. package/docs/models/AssignImpiloDeviceResponse.md +20 -0
  12. package/docs/models/AthenaLabResult.md +2 -0
  13. package/docs/models/CancelTestOrderResponse.md +19 -0
  14. package/docs/models/CreateDeliveryOrderRequest.md +21 -0
  15. package/docs/models/DeliveryContact.md +24 -0
  16. package/docs/models/DeliveryOrder.md +30 -0
  17. package/docs/models/DeliveryPharmacy.md +25 -0
  18. package/docs/models/GetDefaultProviderResponse.md +2 -0
  19. package/docs/models/GetPatientResponse.md +1 -0
  20. package/docs/models/GetTestOrderResponse.md +44 -0
  21. package/docs/models/ImpiloDeviceItem.md +23 -0
  22. package/docs/models/ListDeliveryOrdersResponse.md +19 -0
  23. package/docs/models/ListImpiloDevicesResponse.md +18 -0
  24. package/docs/models/ListOrderItemsResponse.md +18 -0
  25. package/docs/models/ListTestOrdersResponse.md +18 -0
  26. package/docs/models/OrderItem.md +19 -0
  27. package/docs/models/OrderPriority.md +15 -0
  28. package/docs/models/OrderStatus.md +15 -0
  29. package/docs/models/PatientDemographics.md +1 -0
  30. package/docs/models/PlaceTestOrderRequest.md +43 -0
  31. package/docs/models/PlaceTestOrderResponse.md +44 -0
  32. package/docs/models/Specimen.md +30 -0
  33. package/docs/models/SpecimenStatus.md +15 -0
  34. package/docs/models/TestOrder.md +44 -0
  35. package/docs/models/_InsuranceOcrResult.md +1 -0
  36. package/docs/models/index.md +21 -0
  37. package/docs/operations/connectors.athenaAddLabResultDocument.md +2 -2
  38. package/docs/operations/connectors.athenaGetInsurancePackages.md +1 -1
  39. package/docs/operations/connectors.athenaGetLabResult.md +2 -0
  40. package/docs/operations/connectors.athenaListLabResults.md +2 -0
  41. package/docs/operations/fieldagent.listPatients.md +1 -0
  42. package/docs/operations/patient.addInsurance.md +48 -16
  43. package/docs/operations/patient.addPatientIntake.md +12 -1
  44. package/docs/operations/patient.assignImpiloDevice.md +112 -0
  45. package/docs/operations/patient.assistantOcrInsurance.md +64 -13
  46. package/docs/operations/patient.cancelTestOrder.md +152 -0
  47. package/docs/operations/patient.checkPatientInsuranceEligibility.md +133 -38
  48. package/docs/operations/patient.createDeliveryOrder.md +171 -0
  49. package/docs/operations/patient.getDefaultProvider.md +2 -0
  50. package/docs/operations/patient.getDeliveryOrder.md +156 -0
  51. package/docs/operations/patient.getPatient.md +1 -0
  52. package/docs/operations/patient.getPatientSidebarPatientSidebar.md +1 -0
  53. package/docs/operations/patient.getTestOrder.md +194 -0
  54. package/docs/operations/patient.importImpiloVitals.md +129 -0
  55. package/docs/operations/patient.listDeliveryOrders.md +156 -0
  56. package/docs/operations/patient.listImpiloDevices.md +100 -0
  57. package/docs/operations/patient.listOrderItems.md +129 -0
  58. package/docs/operations/patient.listTestOrders.md +201 -0
  59. package/docs/operations/patient.placeTestOrder.md +309 -0
  60. package/docs/operations/patient.submitPatientIntake.md +17 -3
  61. package/package.json +1 -1
@@ -0,0 +1,156 @@
1
+ # List the patient's delivery orders
2
+
3
+ Operation ID: `patient.listDeliveryOrders`
4
+
5
+ List the patient's delivery orders
6
+
7
+ ## Public method
8
+
9
+ `listDeliveryOrders`
10
+
11
+ Signature: `patient.listDeliveryOrders(query)`
12
+
13
+ Return type: `Promise<ListDeliveryOrdersResponse>`
14
+
15
+ ## Authentication
16
+
17
+ Classification: **AUTHENTICATED**
18
+
19
+ Schemes: `bearerAuth`
20
+
21
+ ## Prerequisites
22
+
23
+ None documented.
24
+
25
+ ## HTTP
26
+
27
+ `GET /patients/delivery-orders`
28
+
29
+ ## Path parameters
30
+
31
+ None.
32
+
33
+ ## Query parameters
34
+
35
+ | Name | Type | Required | Format | Allowed values | Default | Nullable | Description |
36
+ |---|---|---:|---|---|---|---:|---|
37
+ | `limit` | `integer` | No | | | `50` | No | |
38
+ | `offset` | `integer` | No | | | `0` | No | |
39
+
40
+ ## Body parameters
41
+
42
+ None.
43
+
44
+ Request model: None.
45
+
46
+ ## Request example
47
+
48
+ None declared in canonical OpenAPI.
49
+
50
+ ## Success responses
51
+
52
+ | Status | Shape | Content type | Description |
53
+ |---|---|---|---|
54
+ | `200` | [`ListDeliveryOrdersResponse`](../models/ListDeliveryOrdersResponse.md) | application/json | Patient-scoped delivery ledger; statuses are last observed values |
55
+
56
+ ## Success response examples
57
+
58
+ ### 200
59
+
60
+ ```json
61
+ {
62
+ "limit": 0,
63
+ "offset": 0,
64
+ "orders": []
65
+ }
66
+ ```
67
+
68
+ ## Common errors
69
+
70
+ | Status | Shape | Content type | Description |
71
+ |---|---|---|---|
72
+ | `401` | [`patient.ErrorResponse`](../models/patient.ErrorResponse.md) | application/json | Authorization required — missing or invalid Bearer JWT |
73
+ | `404` | [`patient.ErrorResponse`](../models/patient.ErrorResponse.md) | application/json | |
74
+ | `422` | [`patient.ErrorResponse`](../models/patient.ErrorResponse.md) | application/json | |
75
+ | `503` | [`patient.ErrorResponse`](../models/patient.ErrorResponse.md) | application/json | |
76
+
77
+ ## Error examples
78
+
79
+ ### 401
80
+
81
+ ```json
82
+ {
83
+ "details": [
84
+ {}
85
+ ],
86
+ "error": "string"
87
+ }
88
+ ```
89
+
90
+ ### 404
91
+
92
+ ```json
93
+ {
94
+ "details": [
95
+ {}
96
+ ],
97
+ "error": "string"
98
+ }
99
+ ```
100
+
101
+ ### 422
102
+
103
+ ```json
104
+ {
105
+ "details": [
106
+ {}
107
+ ],
108
+ "error": "string"
109
+ }
110
+ ```
111
+
112
+ ### 503
113
+
114
+ ```json
115
+ {
116
+ "details": [
117
+ {}
118
+ ],
119
+ "error": "string"
120
+ }
121
+ ```
122
+
123
+ ## NodeJS / TypeScript implementation
124
+
125
+ ```ts
126
+ import { HCSDK } from "@healthcloudai/hc-sdk";
127
+ ```
128
+
129
+ ```ts
130
+ const query = {
131
+ "limit": 50,
132
+ "offset": 0
133
+ };
134
+
135
+ const result = await patient.listDeliveryOrders(query);
136
+ ```
137
+
138
+ ## cURL
139
+
140
+ ```bash
141
+ curl -X GET \
142
+ -H 'Authorization: Bearer <ACCESS_TOKEN>' \
143
+ 'https://dev-api-patient.health.cloud/patients/delivery-orders?limit=50&offset=0'
144
+ ```
145
+
146
+ ## Notes
147
+
148
+ None.
149
+
150
+ ## Prepared Test Console scenario
151
+
152
+ No canonical scenario is currently associated.
153
+
154
+ ## Real response
155
+
156
+ No approved real integration response is currently published. Unapproved candidates are never rendered as examples.
@@ -0,0 +1,100 @@
1
+ # List Impilo device types
2
+
3
+ Operation ID: `patient.listImpiloDevices`
4
+
5
+ List available Impilo RPM device types and brands. Returns the full catalog of device items from the Impilo API including manufacturer, model, SKU, and reading type. Requires a patient Bearer JWT.
6
+
7
+ ## Public method
8
+
9
+ `listImpiloDevices`
10
+
11
+ Signature: `patient.listImpiloDevices()`
12
+
13
+ Return type: `Promise<JsonValue>`
14
+
15
+ ## Authentication
16
+
17
+ Classification: **AUTHENTICATED**
18
+
19
+ Schemes: `bearerAuth`
20
+
21
+ ## Prerequisites
22
+
23
+ None documented.
24
+
25
+ ## HTTP
26
+
27
+ `GET /patients/vitals/devices/impilo`
28
+
29
+ ## Path parameters
30
+
31
+ None.
32
+
33
+ ## Query parameters
34
+
35
+ None.
36
+
37
+ ## Body parameters
38
+
39
+ None.
40
+
41
+ Request model: None.
42
+
43
+ ## Request example
44
+
45
+ None declared in canonical OpenAPI.
46
+
47
+ ## Success responses
48
+
49
+ | Status | Shape | Content type | Description |
50
+ |---|---|---|---|
51
+ | `200` | [`ListImpiloDevicesResponse`](../models/ListImpiloDevicesResponse.md) | application/json | Available Impilo device types |
52
+
53
+ ## Success response examples
54
+
55
+ ### 200
56
+
57
+ ```json
58
+ {
59
+ "devices": [],
60
+ "total": 0
61
+ }
62
+ ```
63
+
64
+ ## Common errors
65
+
66
+ None declared in canonical OpenAPI.
67
+
68
+ ## Error examples
69
+
70
+ None declared in canonical OpenAPI.
71
+
72
+ ## NodeJS / TypeScript implementation
73
+
74
+ ```ts
75
+ import { HCSDK } from "@healthcloudai/hc-sdk";
76
+ ```
77
+
78
+ ```ts
79
+ const result = await patient.listImpiloDevices();
80
+ ```
81
+
82
+ ## cURL
83
+
84
+ ```bash
85
+ curl -X GET \
86
+ -H 'Authorization: Bearer <ACCESS_TOKEN>' \
87
+ 'https://dev-api-patient.health.cloud/patients/vitals/devices/impilo'
88
+ ```
89
+
90
+ ## Notes
91
+
92
+ None.
93
+
94
+ ## Prepared Test Console scenario
95
+
96
+ No canonical scenario is currently associated.
97
+
98
+ ## Real response
99
+
100
+ No approved real integration response is currently published. Unapproved candidates are never rendered as examples.
@@ -0,0 +1,129 @@
1
+ # List order items
2
+
3
+ Operation ID: `patient.listOrderItems`
4
+
5
+ List order items
6
+
7
+ ## Public method
8
+
9
+ `listOrderItems`
10
+
11
+ Signature: `patient.listOrderItems()`
12
+
13
+ Return type: `Promise<ListOrderItemsResponse>`
14
+
15
+ ## Authentication
16
+
17
+ Classification: **AUTHENTICATED**
18
+
19
+ Schemes: `bearerAuth`
20
+
21
+ ## Prerequisites
22
+
23
+ None documented.
24
+
25
+ ## HTTP
26
+
27
+ `GET /patients/order-items`
28
+
29
+ ## Path parameters
30
+
31
+ None.
32
+
33
+ ## Query parameters
34
+
35
+ None.
36
+
37
+ ## Body parameters
38
+
39
+ None.
40
+
41
+ Request model: None.
42
+
43
+ ## Request example
44
+
45
+ None declared in canonical OpenAPI.
46
+
47
+ ## Success responses
48
+
49
+ | Status | Shape | Content type | Description |
50
+ |---|---|---|---|
51
+ | `200` | [`ListOrderItemsResponse`](../models/ListOrderItemsResponse.md) | application/json | Orderable catalog items: id, name and image |
52
+
53
+ ## Success response examples
54
+
55
+ ### 200
56
+
57
+ ```json
58
+ {
59
+ "items": [
60
+ {
61
+ "id": "00000000-0000-0000-0000-000000000000",
62
+ "image": "string",
63
+ "name": "string"
64
+ }
65
+ ],
66
+ "total": 0
67
+ }
68
+ ```
69
+
70
+ ## Common errors
71
+
72
+ | Status | Shape | Content type | Description |
73
+ |---|---|---|---|
74
+ | `401` | [`patient.ErrorResponse`](../models/patient.ErrorResponse.md) | application/json | Authorization required — missing or invalid Bearer JWT |
75
+ | `503` | [`patient.ErrorResponse`](../models/patient.ErrorResponse.md) | application/json | |
76
+
77
+ ## Error examples
78
+
79
+ ### 401
80
+
81
+ ```json
82
+ {
83
+ "details": [
84
+ {}
85
+ ],
86
+ "error": "string"
87
+ }
88
+ ```
89
+
90
+ ### 503
91
+
92
+ ```json
93
+ {
94
+ "details": [
95
+ {}
96
+ ],
97
+ "error": "string"
98
+ }
99
+ ```
100
+
101
+ ## NodeJS / TypeScript implementation
102
+
103
+ ```ts
104
+ import { HCSDK } from "@healthcloudai/hc-sdk";
105
+ ```
106
+
107
+ ```ts
108
+ const result = await patient.listOrderItems();
109
+ ```
110
+
111
+ ## cURL
112
+
113
+ ```bash
114
+ curl -X GET \
115
+ -H 'Authorization: Bearer <ACCESS_TOKEN>' \
116
+ 'https://dev-api-patient.health.cloud/patients/order-items'
117
+ ```
118
+
119
+ ## Notes
120
+
121
+ None.
122
+
123
+ ## Prepared Test Console scenario
124
+
125
+ No canonical scenario is currently associated.
126
+
127
+ ## Real response
128
+
129
+ No approved real integration response is currently published. Unapproved candidates are never rendered as examples.
@@ -0,0 +1,201 @@
1
+ # List diagnostic test orders
2
+
3
+ Operation ID: `patient.listTestOrders`
4
+
5
+ List diagnostic test orders
6
+
7
+ ## Public method
8
+
9
+ `listTestOrders`
10
+
11
+ Signature: `patient.listTestOrders(query)`
12
+
13
+ Return type: `Promise<ListTestOrdersResponse>`
14
+
15
+ ## Authentication
16
+
17
+ Classification: **AUTHENTICATED**
18
+
19
+ Schemes: `bearerAuth`
20
+
21
+ ## Prerequisites
22
+
23
+ None documented.
24
+
25
+ ## HTTP
26
+
27
+ `GET /patients/orders`
28
+
29
+ ## Path parameters
30
+
31
+ None.
32
+
33
+ ## Query parameters
34
+
35
+ | Name | Type | Required | Format | Allowed values | Default | Nullable | Description |
36
+ |---|---|---:|---|---|---|---:|---|
37
+ | `status` | `string` | No | | | | No | FHIR ServiceRequest status, e.g. active, completed, revoked |
38
+
39
+ ## Body parameters
40
+
41
+ None.
42
+
43
+ Request model: None.
44
+
45
+ ## Request example
46
+
47
+ None declared in canonical OpenAPI.
48
+
49
+ ## Success responses
50
+
51
+ | Status | Shape | Content type | Description |
52
+ |---|---|---|---|
53
+ | `200` | [`ListTestOrdersResponse`](../models/ListTestOrdersResponse.md) | application/json | The patient's test orders |
54
+
55
+ ## Success response examples
56
+
57
+ ### 200
58
+
59
+ ```json
60
+ {
61
+ "orders": [
62
+ {
63
+ "athena_encounter_id": "string",
64
+ "athena_order_id": "string",
65
+ "athena_order_status": "string",
66
+ "authored_on": "2026-01-01",
67
+ "cpt_code": "string",
68
+ "diagnosis_codes": [
69
+ "string"
70
+ ],
71
+ "display": "string",
72
+ "encounter_id": "string",
73
+ "fasting_required": false,
74
+ "fhir_id": "string",
75
+ "intent": "order",
76
+ "lab_name": "string",
77
+ "loinc_code": "string",
78
+ "notes": "string",
79
+ "occurrence_date": "2026-01-01",
80
+ "occurrence_datetime": "2026-01-01T09:00:00Z",
81
+ "order_id": "string",
82
+ "patient_fhir_id": "string",
83
+ "performer_name": "string",
84
+ "priority": "routine",
85
+ "reason": "string",
86
+ "requester_name": "string",
87
+ "requester_npi": "string",
88
+ "requisition_number": "string",
89
+ "snomed_code": "string",
90
+ "specimen": {
91
+ "accession_number": "string",
92
+ "body_site": "string",
93
+ "collected_by": "string",
94
+ "collection_date": "2026-01-01",
95
+ "collection_datetime": "2026-01-01T09:00:00Z",
96
+ "condition": "string",
97
+ "container": "string",
98
+ "fhir_id": "string",
99
+ "notes": "string",
100
+ "received_datetime": "2026-01-01T09:00:00Z",
101
+ "specimen_id": "00000000-0000-0000-0000-000000000000",
102
+ "status": "available",
103
+ "type": "blood",
104
+ "volume_ml": 1
105
+ },
106
+ "standing_order": false,
107
+ "status": "active"
108
+ }
109
+ ],
110
+ "total": 0
111
+ }
112
+ ```
113
+
114
+ ## Common errors
115
+
116
+ | Status | Shape | Content type | Description |
117
+ |---|---|---|---|
118
+ | `401` | [`patient.ErrorResponse`](../models/patient.ErrorResponse.md) | application/json | Authorization required — missing or invalid Bearer JWT |
119
+ | `404` | [`patient.ErrorResponse`](../models/patient.ErrorResponse.md) | application/json | |
120
+ | `409` | [`patient.ErrorResponse`](../models/patient.ErrorResponse.md) | application/json | |
121
+ | `502` | [`patient.ErrorResponse`](../models/patient.ErrorResponse.md) | application/json | |
122
+
123
+ ## Error examples
124
+
125
+ ### 401
126
+
127
+ ```json
128
+ {
129
+ "details": [
130
+ {}
131
+ ],
132
+ "error": "string"
133
+ }
134
+ ```
135
+
136
+ ### 404
137
+
138
+ ```json
139
+ {
140
+ "details": [
141
+ {}
142
+ ],
143
+ "error": "string"
144
+ }
145
+ ```
146
+
147
+ ### 409
148
+
149
+ ```json
150
+ {
151
+ "details": [
152
+ {}
153
+ ],
154
+ "error": "string"
155
+ }
156
+ ```
157
+
158
+ ### 502
159
+
160
+ ```json
161
+ {
162
+ "details": [
163
+ {}
164
+ ],
165
+ "error": "string"
166
+ }
167
+ ```
168
+
169
+ ## NodeJS / TypeScript implementation
170
+
171
+ ```ts
172
+ import { HCSDK } from "@healthcloudai/hc-sdk";
173
+ ```
174
+
175
+ ```ts
176
+ const query = {
177
+ "status": "<STATUS>"
178
+ };
179
+
180
+ const result = await patient.listTestOrders(query);
181
+ ```
182
+
183
+ ## cURL
184
+
185
+ ```bash
186
+ curl -X GET \
187
+ -H 'Authorization: Bearer <ACCESS_TOKEN>' \
188
+ 'https://dev-api-patient.health.cloud/patients/orders?status=%3CSTATUS%3E'
189
+ ```
190
+
191
+ ## Notes
192
+
193
+ None.
194
+
195
+ ## Prepared Test Console scenario
196
+
197
+ No canonical scenario is currently associated.
198
+
199
+ ## Real response
200
+
201
+ No approved real integration response is currently published. Unapproved candidates are never rendered as examples.