@healthcloudai/hc-sdk 3.13.2 → 3.13.4

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.
@@ -17,7 +17,7 @@
17
17
  - [`createFamilyHistory`](../operations/connectors.athenaCreateFamilyHistory.md) — Add one family-history problem for a relative
18
18
  - [`createImmunization`](../operations/connectors.athenaCreateImmunization.md) — Create immunization (athenahealth)
19
19
  - [`createInsurance`](../operations/connectors.athenaCreateInsurance.md) — Deprecated: thin alias for create_insurance_package
20
- - [`createInsurancePackage`](../operations/connectors.athenaCreateInsurancePackage.md) — Create an insurance record from an insurance package
20
+ - [`createInsurancePackage`](../operations/connectors.athenaCreateInsurancePackage.md) — Create an insurance record or update the same existing package
21
21
  - [`createLabOrder`](../operations/connectors.athenaCreateLabOrder.md) — Create lab order (athenahealth)
22
22
  - [`createMedication`](../operations/connectors.athenaCreateMedication.md) — Create medication (athenahealth)
23
23
  - [`createOpenAppointmentSlot`](../operations/connectors.athenaCreateOpenAppointmentSlot.md) — Create an open appointment slot
@@ -1,5 +1,5 @@
1
1
  {
2
- "docsDataContentDigest": "sha256:2594a9f19a9d96f724822c71d6705dd6787f3df22ac0a88d42319db1a6abb013",
2
+ "docsDataContentDigest": "sha256:f371dffcc058374e7bfc9dbb824ca38f4b16dc774cee5c8eeffaf2cba872f0b7",
3
3
  "generatedFiles": [
4
4
  "authentication.md",
5
5
  "clients/AmsClient.md",
@@ -31,7 +31,7 @@ Generated call examples use exact public surface signatures. Workflow examples r
31
31
  - [Add one family-history problem for a relative](../operations/connectors.athenaCreateFamilyHistory.md)
32
32
  - [Create immunization (athenahealth)](../operations/connectors.athenaCreateImmunization.md)
33
33
  - [Deprecated: thin alias for create_insurance_package](../operations/connectors.athenaCreateInsurance.md)
34
- - [Create an insurance record from an insurance package](../operations/connectors.athenaCreateInsurancePackage.md)
34
+ - [Create an insurance record or update the same existing package](../operations/connectors.athenaCreateInsurancePackage.md)
35
35
  - [Create lab order (athenahealth)](../operations/connectors.athenaCreateLabOrder.md)
36
36
  - [Create medication (athenahealth)](../operations/connectors.athenaCreateMedication.md)
37
37
  - [Create an open appointment slot](../operations/connectors.athenaCreateOpenAppointmentSlot.md)
package/docs/index.md CHANGED
@@ -39,7 +39,7 @@ This directory is generated from the shared structured docs data. Do not edit ge
39
39
  - [Add one family-history problem for a relative](operations/connectors.athenaCreateFamilyHistory.md) (`connectors.athenaCreateFamilyHistory`)
40
40
  - [Create immunization (athenahealth)](operations/connectors.athenaCreateImmunization.md) (`connectors.athenaCreateImmunization`)
41
41
  - [Deprecated: thin alias for create_insurance_package](operations/connectors.athenaCreateInsurance.md) (`connectors.athenaCreateInsurance`)
42
- - [Create an insurance record from an insurance package](operations/connectors.athenaCreateInsurancePackage.md) (`connectors.athenaCreateInsurancePackage`)
42
+ - [Create an insurance record or update the same existing package](operations/connectors.athenaCreateInsurancePackage.md) (`connectors.athenaCreateInsurancePackage`)
43
43
  - [Create lab order (athenahealth)](operations/connectors.athenaCreateLabOrder.md) (`connectors.athenaCreateLabOrder`)
44
44
  - [Create medication (athenahealth)](operations/connectors.athenaCreateMedication.md) (`connectors.athenaCreateMedication`)
45
45
  - [Create an open appointment slot](operations/connectors.athenaCreateOpenAppointmentSlot.md) (`connectors.athenaCreateOpenAppointmentSlot`)
@@ -1,8 +1,8 @@
1
- # Create an insurance record from an insurance package
1
+ # Create an insurance record or update the same existing package
2
2
 
3
3
  Operation ID: `connectors.athenaCreateInsurancePackage`
4
4
 
5
- Create an insurance record from an insurance package. Tries sequence numbers 1 → 2 → 3 (Athena's primary/secondary/tertiary insurance slots) since an occupied slot rejects the write. Raises the last error (e.g. an invalid ``package_id``) if none of the three slots accept it, rather than swallowing it — silently returning None here left callers unable to tell "no free slot" apart from "Athena rejected this package outright", both by AthenaInsuranceSync and by direct API/MCP callers of this connector method.
5
+ Create an insurance record or update the same existing package. Repeated submissions must update the matching patient's policy rather than POST a duplicate. Never replace/deactivate an unrelated package. Verify updated member details by reading the policy back from Athena. Tries sequence numbers 1 → 2 → 3 (Athena's primary/secondary/tertiary insurance slots) since an occupied slot rejects the write. Raises the last error (e.g. an invalid ``package_id``) if none of the three slots accept it, rather than swallowing it — silently returning None here left callers unable to tell "no free slot" apart from "Athena rejected this package outright", both by AthenaInsuranceSync and by direct API/MCP callers of this connector method.
6
6
 
7
7
  ## Public method
8
8
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Operation ID: `connectors.athenaUpdateDriversLicense`
4
4
 
5
- Create or replace the patient's Athena driver's-license image. POST is required when the singleton image is absent and PUT when it already exists. Only Athena's 404 response is treated as absent. ``license_fields`` optionally carries the Athena-native text fields (``driverslicensenumber``, ``driverslicensestateid``, ``driverslicenseexpirationdate``, ``driverslicenseyn``) which are written to the patient *record* via ``PUT /patients/{id}`` after the image upload. The image and the demographic fields live on separate Athena resources, so two HTTP calls are issued; the image call is the primary one (its result is returned) and the record update is best-effort (a failure is logged but not raised so a successful image upload is never discarded by a demographic-field write error).
5
+ Create or replace the patient's Athena driver's-license image. POST is required when the singleton image is absent and PUT when it already exists. Only Athena's 404 response is treated as absent. ``license_fields`` optionally carries the Athena-native text fields (``driverslicensenumber``, ``driverslicensestateid``, ``driverslicenseexpirationdate``, ``driverslicenseyn``) which are written to the patient *record* via ``PUT /patients/{id}``. Omitted images must not trigger an empty image upload. If either requested write fails, propagate the error so the caller cannot report both image and text as linked. A successful earlier write is not undone.
6
6
 
7
7
  ## Public method
8
8
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  Operation ID: `patient.assistantOcrInsurance`
4
4
 
5
- Extract insurance-card fields (member id, group number, plan, RxBIN/PCN/GRP, etc.) from a photo of the card's front using a vision-capable LLM. Mirrors the request/error shape of `patient.assistantOcr`. No authentication is required.
5
+ Extract insurance-card fields (member id, group number, plan, RxBIN/PCN/GRP, etc.) from a photo of the card's front using a vision-capable LLM. Mirrors the request/error shape of `patient.assistantOcr`. Masked member IDs are verified against high-confidence, explicitly labelled document text; unverifiable IDs return an OCR error rather than a guessed value. No authentication is required.
6
6
 
7
7
  ## Public method
8
8
 
@@ -82,7 +82,7 @@ Request model: [`AssistantOcrInsuranceRequest`](../models/AssistantOcrInsuranceR
82
82
  | Status | Shape | Content type | Description |
83
83
  |---|---|---|---|
84
84
  | `400` | `object` | application/json | The image is missing, too large, not a valid data URI, or an unsupported MIME type |
85
- | `422` | `object` | application/json | The LLM is not configured, the call failed, or the card was not legible |
85
+ | `422` | `object` | application/json | The LLM is not configured, the call failed, the card was not legible, or a masked member ID could not be verified |
86
86
 
87
87
  ## Error examples
88
88
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@healthcloudai/hc-sdk",
3
- "version": "3.13.2",
3
+ "version": "3.13.4",
4
4
  "description": "All-in-one HealthCloud SDK with typed platform APIs and secure connector clients.",
5
5
  "author": "Healthcheck Systems Inc",
6
6
  "license": "MIT",
@@ -65,7 +65,7 @@
65
65
  "vitest": "^5.0.1"
66
66
  },
67
67
  "engines": {
68
- "node": ">=18"
68
+ "node": "^22.23.4 || ^24.22.1 || ^26.12.1"
69
69
  },
70
70
  "overrides": {
71
71
  "source-map-js": "^1.2.2"