@haau3/sdk 0.1.0 → 0.1.2

package/README.md

@@ -29,21 +29,40 @@ const haau3 = new Haau3(); // reads HAAU3_API_KEY
 
 ```ts
 const plan = await haau3.readInsurancePlan("H2406-013-000");
-console.log(plan.name);
-
-const { providerLocations } = await haau3.searchProviderLocations({ state: "MA", limit: 10 });
+console.log(plan.name); // "AARP Medicare Advantage from UHC FL-0021 (PPO)"
 ```
 
-Every operation in the [API reference](https://docs.haau3.com) is a method named by its
-operationId, with its parameters and its answer typed from the published spec. FHIR answers are
-[@types/fhir](https://www.npmjs.com/package/@types/fhir)'s R4 types, also exported as `fhir4`:
+FHIR answers are [@types/fhir](https://www.npmjs.com/package/@types/fhir)'s R4 types, also
+exported as `fhir4` (`import type { fhir4 } from "@haau3/sdk"`).
+
+## One call per service
 
 ```ts
-import type { fhir4 } from "@haau3/sdk";
+// Scheduling: open appointment slots, here in Boston.
+const { slots, total } = await haau3.searchSlots({ city: "Boston", state: "MA", limit: 10 });
+
+// Provider directory: a practitioner by NPI, from CMS's National Provider Directory.
+const practitioners = await haau3.searchPractitioner({ identifier: "1093209884" });
+
+// Terminology: a LOINC code's display and properties.
+const glucose = await haau3.codeSystemLookup({ system: "http://loinc.org", code: "2345-7" });
 
-const bundle: fhir4.Bundle = await haau3.searchPractitioner({ identifier: "http://hl7.org/fhir/sid/us-npi|1518929058" });
+// Questionnaires: a form by its id, such as the PHQ-9.
+const phq9 = await haau3.readQuestionnaire("44249-1");
+
+// Plan Benefits: a Medicare Advantage or ACA Marketplace plan, and which providers are in its network.
+const plan = await haau3.readInsurancePlan("H2406-013-000");
+const network = await haau3.checkInsurancePlanNetwork("H3359-038-000", { npi: ["1518929058"] });
+
+// MedList: one reconciled medication list from one patient's FHIR medication records. It receives
+// patient data, so send it only under an executed agreement.
+const list = await haau3.reconcileMedications(records);
 ```
 
+Every method, grouped by service, with its request and a link to its page on docs.haau3.com, is in
+[api.md](https://github.com/haau3/haau3-node/blob/main/api.md). Each is named by its operationId,
+with its parameters and its answer typed from the published spec.
+
 ## Options
 
 | Option | Default | |
@@ -127,7 +146,8 @@ const { status, body, requestId } = await haau3.request({ method: "GET", path: "
 ## Versions
 
 The SDK is `0.y.z` while the API is in preview: a minor release may change what a method takes or
-answers, and a patch release never does.
+answers, and a patch release never does. [CHANGELOG.md](CHANGELOG.md) lists every release, and a
+release that takes a new version of the API's spec names that version.
 
 ## License
 

package/dist/index.cjs

@@ -74,7 +74,7 @@ var NoAnswerError = class extends Haau3Error {
 //#endregion
 //#region src/version.ts
 /** This package's version, sent in the `User-Agent` header. A test holds it to package.json. */
-const VERSION = "0.1.0";
+const VERSION = "0.1.2";
 //#endregion
 //#region src/transport.ts
 const DEFAULT_BASE_URL = "https://api.haau3.com";

package/dist/index.d.cts

@@ -4496,6 +4496,6 @@ export declare class NoAnswerError extends Haau3Error {
 //#endregion
 //#region src/version.d.ts
 /** This package's version, sent in the `User-Agent` header. A test holds it to package.json. */
-export declare const VERSION = "0.1.0";
+export declare const VERSION = "0.1.2";
 //#endregion
 export type { CheckInsurancePlanNetworkParams, ClientOptions, CodeSystemLookupParams, CodeSystemValidateCodeParams, FhirMetadataParams, ListInsurancePlanCountiesParams, ListPublishersResponse, ListServiceTypesParams, ListServiceTypesResponse, ListSpecialtiesParams, ListSpecialtiesResponse, NoAnswerReason, OperationId, Problem, ProblemIssue, QueryValue, RawRequest, RawResponse, RequestOptions, SchedulingProviderLocation, SchedulingPublisher, SchedulingServiceType, SchedulingSlot, SchedulingSpecialty, SearchEndpointParams, SearchHealthcareServiceParams, SearchInsurancePlanParams, SearchLocationParams, SearchOrganizationAffiliationParams, SearchOrganizationParams, SearchPractitionerParams, SearchPractitionerRoleParams, SearchProviderLocationsParams, SearchProviderLocationsResponse, SearchQuestionnaireParams, SearchSlotsParams, SearchSlotsResponse, ValueSetExpandParams, ValueSetValidateCodeParams, fhir4 };

package/dist/index.d.mts

@@ -4496,6 +4496,6 @@ export declare class NoAnswerError extends Haau3Error {
 //#endregion
 //#region src/version.d.ts
 /** This package's version, sent in the `User-Agent` header. A test holds it to package.json. */
-export declare const VERSION = "0.1.0";
+export declare const VERSION = "0.1.2";
 //#endregion
 export type { CheckInsurancePlanNetworkParams, ClientOptions, CodeSystemLookupParams, CodeSystemValidateCodeParams, FhirMetadataParams, ListInsurancePlanCountiesParams, ListPublishersResponse, ListServiceTypesParams, ListServiceTypesResponse, ListSpecialtiesParams, ListSpecialtiesResponse, NoAnswerReason, OperationId, Problem, ProblemIssue, QueryValue, RawRequest, RawResponse, RequestOptions, SchedulingProviderLocation, SchedulingPublisher, SchedulingServiceType, SchedulingSlot, SchedulingSpecialty, SearchEndpointParams, SearchHealthcareServiceParams, SearchInsurancePlanParams, SearchLocationParams, SearchOrganizationAffiliationParams, SearchOrganizationParams, SearchPractitionerParams, SearchPractitionerRoleParams, SearchProviderLocationsParams, SearchProviderLocationsResponse, SearchQuestionnaireParams, SearchSlotsParams, SearchSlotsResponse, ValueSetExpandParams, ValueSetValidateCodeParams, fhir4 };

package/dist/index.mjs

@@ -73,7 +73,7 @@ var NoAnswerError = class extends Haau3Error {
 //#endregion
 //#region src/version.ts
 /** This package's version, sent in the `User-Agent` header. A test holds it to package.json. */
-const VERSION = "0.1.0";
+const VERSION = "0.1.2";
 //#endregion
 //#region src/transport.ts
 const DEFAULT_BASE_URL = "https://api.haau3.com";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haau3/sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "TypeScript SDK for the haau3 platform API: scheduling, provider directory, terminology, questionnaires, plan benefits and medication lists, as typed calls.",
   "license": "MIT",
   "homepage": "https://docs.haau3.com",
@@ -53,7 +53,8 @@
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "lint": "eslint .",
-    "check:package": "publint --strict && attw --pack ."
+    "check:package": "publint --strict && attw --pack .",
+    "check:public-text": "tsx scripts/check-public-text.ts"
   },
   "dependencies": {
     "@types/fhir": "~0.0.44"
@@ -69,6 +70,7 @@
     "tsx": "^4.23.15",
     "typescript": "6.0.3",
     "typescript-eslint": "^8.71.2",
-    "vitest": "^5.0.5"
+    "vitest": "^5.0.5",
+    "yaml": "^2.9.1"
   }
 }