@haau3/sdk 0.2.1 → 0.2.2

package/dist/index.d.cts

@@ -5,6 +5,11 @@ import { Bundle, OperationOutcome } from "fhir/r4.js";
 interface ResponseMeta {
   /** The `X-Request-Id` the API sent. Quote it when you ask for help. */
   requestId: string | undefined;
+  /**
+   * The `correlationId` you sent, as the API returned it in `X-Correlation-Id`: proof it was kept
+   * with the API's record of the request. Unset when you sent none.
+   */
+  correlationId: string | undefined;
   /** Milliseconds from the first attempt to the answer, waits between attempts included. */
   durationMs: number;
   /** How many attempts were made. */
@@ -3966,6 +3971,396 @@ type ResponseOf<Op extends OperationId> = operations[Op]["responses"] extends {
   };
 } ? Content[keyof Content] : never;
 //#endregion
+//#region src/generated/types.d.ts
+type ListPublishersResponse = components["schemas"]["ListPublishersResponse"];
+type ListServiceTypesResponse = components["schemas"]["ListServiceTypesResponse"];
+type ListSpecialtiesResponse = components["schemas"]["ListSpecialtiesResponse"];
+type Problem = components["schemas"]["Problem"];
+type ProblemIssue = components["schemas"]["ProblemIssue"];
+type SchedulingProviderLocation = components["schemas"]["SchedulingProviderLocation"];
+type SchedulingPublisher = components["schemas"]["SchedulingPublisher"];
+type SchedulingServiceType = components["schemas"]["SchedulingServiceType"];
+type SchedulingSlot = components["schemas"]["SchedulingSlot"];
+type SchedulingSpecialty = components["schemas"]["SchedulingSpecialty"];
+type SearchProviderLocationsResponse = components["schemas"]["SearchProviderLocationsResponse"];
+type SearchSlotsResponse = components["schemas"]["SearchSlotsResponse"];
+/** The query parameters of `checkInsurancePlanNetwork`. */
+type CheckInsurancePlanNetworkParams = QueryOf<"checkInsurancePlanNetwork">;
+/** The query parameters of `codeSystemLookup`. */
+type CodeSystemLookupParams = QueryOf<"codeSystemLookup">;
+/** The query parameters of `codeSystemValidateCode`. */
+type CodeSystemValidateCodeParams = QueryOf<"codeSystemValidateCode">;
+/** The query parameters of `fhirMetadata`. */
+type FhirMetadataParams = QueryOf<"fhirMetadata">;
+/** The query parameters of `listInsurancePlanCounties`. */
+type ListInsurancePlanCountiesParams = QueryOf<"listInsurancePlanCounties">;
+/** The query parameters of `listServiceTypes`. */
+type ListServiceTypesParams = QueryOf<"listServiceTypes">;
+/** The query parameters of `listSpecialties`. */
+type ListSpecialtiesParams = QueryOf<"listSpecialties">;
+/** The query parameters of `searchEndpoint`. */
+type SearchEndpointParams = QueryOf<"searchEndpoint">;
+/** The query parameters of `searchHealthcareService`. */
+type SearchHealthcareServiceParams = QueryOf<"searchHealthcareService">;
+/** The query parameters of `searchInsurancePlan`. */
+type SearchInsurancePlanParams = QueryOf<"searchInsurancePlan">;
+/** The query parameters of `searchLocation`. */
+type SearchLocationParams = QueryOf<"searchLocation">;
+/** The query parameters of `searchOrganization`. */
+type SearchOrganizationParams = QueryOf<"searchOrganization">;
+/** The query parameters of `searchOrganizationAffiliation`. */
+type SearchOrganizationAffiliationParams = QueryOf<"searchOrganizationAffiliation">;
+/** The query parameters of `searchPractitioner`. */
+type SearchPractitionerParams = QueryOf<"searchPractitioner">;
+/** The query parameters of `searchPractitionerRole`. */
+type SearchPractitionerRoleParams = QueryOf<"searchPractitionerRole">;
+/** The query parameters of `searchProviderLocations`. */
+type SearchProviderLocationsParams = QueryOf<"searchProviderLocations">;
+/** The query parameters of `searchQuestionnaire`. */
+type SearchQuestionnaireParams = QueryOf<"searchQuestionnaire">;
+/** The query parameters of `searchSlots`. */
+type SearchSlotsParams = QueryOf<"searchSlots">;
+/** The query parameters of `valueSetExpand`. */
+type ValueSetExpandParams = QueryOf<"valueSetExpand">;
+/** The query parameters of `valueSetValidateCode`. */
+type ValueSetValidateCodeParams = QueryOf<"valueSetValidateCode">;
+//#endregion
+//#region src/errors.d.ts
+/**
+ * Why a request got no answer:
+ *
+ * - `timeout`: an attempt ran past its timeout, or the API answered 504.
+ * - `network`: the request never reached the API, or the connection failed.
+ * - `rate-limited`: the API answered 429. `retryAfter` says when to try again.
+ * - `unavailable`: the API, or a source it reads, could not answer (502, 503).
+ * - `server-error`: the API failed (500).
+ * - `unreadable`: the API answered with something that is not an answer: a body that is not JSON,
+ *   or a FHIR resource of another type than the operation answers with.
+ */
+type NoAnswerReason = "timeout" | "network" | "rate-limited" | "unavailable" | "server-error" | "unreadable";
+/**
+ * What {@link Haau3Error.toJSON} gives: the fields that are safe to log. Never a body the API
+ * answered with, never the error's `cause`. A message names the request by its method and the
+ * operation's path, never by a value you sent.
+ */
+interface Haau3ErrorJSON {
+  name: string;
+  message: string;
+  status?: number;
+  reason?: NoAnswerReason;
+  retryAfter?: number;
+  attempts?: number;
+  durationMs?: number;
+  requestId?: string;
+  correlationId?: string;
+}
+/** What every error this package throws has. */
+export declare class Haau3Error extends Error {
+  name: string;
+  /** The `X-Request-Id` the API sent, when it answered. Quote it when you ask for help. */
+  readonly requestId: string | undefined;
+  /** The `correlationId` you sent, as the API returned it in `X-Correlation-Id`, when it answered. */
+  readonly correlationId: string | undefined;
+  constructor(message: string, requestId?: string, options?: ErrorOptions & {
+    correlationId?: string | undefined;
+  });
+  /**
+   * The error as a plain object that is safe to log: its name, its message and every field that is
+   * set, and never the body the API answered with (`outcome`, `problem`) or the `cause`.
+   * `JSON.stringify(error)` and loggers that call `toJSON` print this.
+   *
+   * ```ts
+   * logger.warn({ error: error.toJSON() }, "the plan read failed");
+   * ```
+   */
+  toJSON(): Haau3ErrorJSON;
+}
+/** An error body as the SDK read it: an OperationOutcome under the FHIR base, a Problem elsewhere. */
+type AnswerBody = {
+  kind: "outcome";
+  value: OperationOutcome;
+} | {
+  kind: "problem";
+  value: Problem;
+};
+/** How long an answered request took, in how many attempts, and the correlation id it came back with. */
+interface Timing {
+  attempts: number;
+  durationMs: number;
+  correlationId?: string | undefined;
+}
+/** The API refused the key: none was sent, it is not one the API knows, or it was revoked (401, 403). */
+export declare class AuthError extends Haau3Error {
+  name: string;
+  readonly status: number;
+  /** How many attempts were made. */
+  readonly attempts: number;
+  /** Milliseconds from the first attempt to the answer. */
+  readonly durationMs: number | undefined;
+  /** The OperationOutcome the FHIR base answered with. Not enumerable, so it is never printed. */
+  readonly outcome?: OperationOutcome;
+  /** The problem the other services answered with. Not enumerable, so it is never printed. */
+  readonly problem?: Problem;
+  constructor(message: string, status: number, requestId?: string, body?: AnswerBody, timing?: Timing);
+}
+/**
+ * The API answered and refused the request: a parameter it does not take, a record that does not
+ * exist (404), a page that no longer exists (410), a body that is too large (413). `status` says
+ * which, and the body says why.
+ */
+export declare class RefusedError extends Haau3Error {
+  name: string;
+  readonly status: number;
+  /** How many attempts were made. */
+  readonly attempts: number;
+  /** Milliseconds from the first attempt to the answer. */
+  readonly durationMs: number | undefined;
+  /** The OperationOutcome the FHIR base answered with. Not enumerable, so it is never printed. */
+  readonly outcome?: OperationOutcome;
+  /** The problem the other services answered with. Not enumerable, so it is never printed. */
+  readonly problem?: Problem;
+  constructor(message: string, status: number, requestId?: string, body?: AnswerBody, timing?: Timing);
+}
+/**
+ * The request got no answer, after every attempt the client was allowed. This never means "no
+ * results": an empty search answers with an empty Bundle or list, not with this error.
+ */
+export declare class NoAnswerError extends Haau3Error {
+  name: string;
+  readonly reason: NoAnswerReason;
+  /** The last status the API answered with, when it answered at all. */
+  readonly status: number | undefined;
+  /** Seconds to wait before trying again, when the API said. */
+  readonly retryAfter: number | undefined;
+  /** How many attempts were made. */
+  readonly attempts: number;
+  /** Milliseconds from the first attempt to the last failure, waits between attempts included. */
+  readonly durationMs: number | undefined;
+  /** The OperationOutcome the FHIR base answered with. Not enumerable, so it is never printed. */
+  readonly outcome?: OperationOutcome;
+  /** The problem the other services answered with. Not enumerable, so it is never printed. */
+  readonly problem?: Problem;
+  constructor(message: string, details: {
+    reason: NoAnswerReason;
+    attempts: number;
+    durationMs?: number;
+    status?: number;
+    retryAfter?: number;
+    requestId?: string;
+    correlationId?: string | undefined;
+    body?: AnswerBody;
+    cause?: unknown;
+  });
+}
+//#endregion
+//#region src/batch.d.ts
+declare const answerType: unique symbol;
+/**
+ * One operation, ready to go in a batch. Made by the builder {@link Haau3.batch} hands you, and
+ * sent only as part of that batch. `T` is what the operation answers with.
+ */
+interface BatchEntry<T> {
+  readonly method: "GET" | "POST";
+  /** Where the entry goes, relative to the FHIR base, as the batch sends it. */
+  readonly url: string;
+  /** Carries the answer's type. Never set. */
+  readonly [answerType]?: T;
+}
+/** One entry's outcome: its answer, or the error a single call would have thrown. */
+type BatchResult<T> = {
+  ok: true;
+  data: T;
+  status: number;
+} | {
+  ok: false;
+  error: RefusedError | NoAnswerError;
+};
+/** One {@link BatchResult} per entry, in the order the entries were given. */
+type BatchResults<E extends readonly BatchEntry<unknown>[]> = { -readonly [K in keyof E]: BatchResult<E[K] extends BatchEntry<infer T> ? T : never>; };
+//#endregion
+//#region src/generated/batch.d.ts
+/**
+ * Every operation a batch can carry, each called as on {@link Haau3} and returning an entry for the
+ * batch instead of sending. Everything on the FHIR base but the batch itself and
+ * `reconcileMedications`.
+ */
+declare class BatchBuilder {
+  /**
+   * Check providers against a plan's network, as one entry of a batch. Called as `Haau3.checkInsurancePlanNetwork` is.
+   *
+   * `GET /v1/fhir/r4/InsurancePlan/{id}/$in-network`
+   */
+  checkInsurancePlanNetwork(id: string, params: CheckInsurancePlanNetworkParams): BatchEntry<ResponseOf<"checkInsurancePlanNetwork">>;
+  /**
+   * Look up a code, as one entry of a batch. Called as `Haau3.codeSystemLookup` is.
+   *
+   * `GET /v1/fhir/r4/CodeSystem/$lookup`
+   */
+  codeSystemLookup(params: CodeSystemLookupParams): BatchEntry<ResponseOf<"codeSystemLookup">>;
+  /**
+   * Look up a code, as one entry of a batch. Called as `Haau3.codeSystemLookupPost` is.
+   *
+   * `POST /v1/fhir/r4/CodeSystem/$lookup`
+   */
+  codeSystemLookupPost(body: BodyOf<"codeSystemLookupPost">): BatchEntry<ResponseOf<"codeSystemLookupPost">>;
+  /**
+   * Validate a code in a code system, as one entry of a batch. Called as `Haau3.codeSystemValidateCode` is.
+   *
+   * `GET /v1/fhir/r4/CodeSystem/$validate-code`
+   */
+  codeSystemValidateCode(params: CodeSystemValidateCodeParams): BatchEntry<ResponseOf<"codeSystemValidateCode">>;
+  /**
+   * Validate a code in a code system, as one entry of a batch. Called as `Haau3.codeSystemValidateCodePost` is.
+   *
+   * `POST /v1/fhir/r4/CodeSystem/$validate-code`
+   */
+  codeSystemValidateCodePost(body: BodyOf<"codeSystemValidateCodePost">): BatchEntry<ResponseOf<"codeSystemValidateCodePost">>;
+  /**
+   * Capability statement, as one entry of a batch. Called as `Haau3.fhirMetadata` is.
+   *
+   * `GET /v1/fhir/r4/metadata`
+   */
+  fhirMetadata(params?: FhirMetadataParams): BatchEntry<ResponseOf<"fhirMetadata">>;
+  /**
+   * List a state's counties, as one entry of a batch. Called as `Haau3.listInsurancePlanCounties` is.
+   *
+   * `GET /v1/fhir/r4/InsurancePlan/$counties`
+   */
+  listInsurancePlanCounties(params: ListInsurancePlanCountiesParams): BatchEntry<ResponseOf<"listInsurancePlanCounties">>;
+  /**
+   * Read an Endpoint, as one entry of a batch. Called as `Haau3.readEndpoint` is.
+   *
+   * `GET /v1/fhir/r4/Endpoint/{id}`
+   */
+  readEndpoint(id: string): BatchEntry<ResponseOf<"readEndpoint">>;
+  /**
+   * Read a HealthcareService, as one entry of a batch. Called as `Haau3.readHealthcareService` is.
+   *
+   * `GET /v1/fhir/r4/HealthcareService/{id}`
+   */
+  readHealthcareService(id: string): BatchEntry<ResponseOf<"readHealthcareService">>;
+  /**
+   * Read a plan, as one entry of a batch. Called as `Haau3.readInsurancePlan` is.
+   *
+   * `GET /v1/fhir/r4/InsurancePlan/{id}`
+   */
+  readInsurancePlan(id: string): BatchEntry<ResponseOf<"readInsurancePlan">>;
+  /**
+   * Read a Location, as one entry of a batch. Called as `Haau3.readLocation` is.
+   *
+   * `GET /v1/fhir/r4/Location/{id}`
+   */
+  readLocation(id: string): BatchEntry<ResponseOf<"readLocation">>;
+  /**
+   * Read an Organization, as one entry of a batch. Called as `Haau3.readOrganization` is.
+   *
+   * `GET /v1/fhir/r4/Organization/{id}`
+   */
+  readOrganization(id: string): BatchEntry<ResponseOf<"readOrganization">>;
+  /**
+   * Read an OrganizationAffiliation, as one entry of a batch. Called as `Haau3.readOrganizationAffiliation` is.
+   *
+   * `GET /v1/fhir/r4/OrganizationAffiliation/{id}`
+   */
+  readOrganizationAffiliation(id: string): BatchEntry<ResponseOf<"readOrganizationAffiliation">>;
+  /**
+   * Read a Practitioner, as one entry of a batch. Called as `Haau3.readPractitioner` is.
+   *
+   * `GET /v1/fhir/r4/Practitioner/{id}`
+   */
+  readPractitioner(id: string): BatchEntry<ResponseOf<"readPractitioner">>;
+  /**
+   * Read a PractitionerRole, as one entry of a batch. Called as `Haau3.readPractitionerRole` is.
+   *
+   * `GET /v1/fhir/r4/PractitionerRole/{id}`
+   */
+  readPractitionerRole(id: string): BatchEntry<ResponseOf<"readPractitionerRole">>;
+  /**
+   * Read a questionnaire, as one entry of a batch. Called as `Haau3.readQuestionnaire` is.
+   *
+   * `GET /v1/fhir/r4/Questionnaire/{id}`
+   */
+  readQuestionnaire(id: string): BatchEntry<ResponseOf<"readQuestionnaire">>;
+  /**
+   * Find endpoints, as one entry of a batch. Called as `Haau3.searchEndpoint` is.
+   *
+   * `GET /v1/fhir/r4/Endpoint`
+   */
+  searchEndpoint(params?: SearchEndpointParams): BatchEntry<ResponseOf<"searchEndpoint">>;
+  /**
+   * Find healthcare services, as one entry of a batch. Called as `Haau3.searchHealthcareService` is.
+   *
+   * `GET /v1/fhir/r4/HealthcareService`
+   */
+  searchHealthcareService(params?: SearchHealthcareServiceParams): BatchEntry<ResponseOf<"searchHealthcareService">>;
+  /**
+   * Find a plan, as one entry of a batch. Called as `Haau3.searchInsurancePlan` is.
+   *
+   * `GET /v1/fhir/r4/InsurancePlan`
+   */
+  searchInsurancePlan(params?: SearchInsurancePlanParams): BatchEntry<ResponseOf<"searchInsurancePlan">>;
+  /**
+   * Find practice locations, as one entry of a batch. Called as `Haau3.searchLocation` is.
+   *
+   * `GET /v1/fhir/r4/Location`
+   */
+  searchLocation(params?: SearchLocationParams): BatchEntry<ResponseOf<"searchLocation">>;
+  /**
+   * Find organizations, payers and networks, as one entry of a batch. Called as `Haau3.searchOrganization` is.
+   *
+   * `GET /v1/fhir/r4/Organization`
+   */
+  searchOrganization(params?: SearchOrganizationParams): BatchEntry<ResponseOf<"searchOrganization">>;
+  /**
+   * Find the organizations in a network, as one entry of a batch. Called as `Haau3.searchOrganizationAffiliation` is.
+   *
+   * `GET /v1/fhir/r4/OrganizationAffiliation`
+   */
+  searchOrganizationAffiliation(params?: SearchOrganizationAffiliationParams): BatchEntry<ResponseOf<"searchOrganizationAffiliation">>;
+  /**
+   * Find a practitioner by NPI or name, as one entry of a batch. Called as `Haau3.searchPractitioner` is.
+   *
+   * `GET /v1/fhir/r4/Practitioner`
+   */
+  searchPractitioner(params?: SearchPractitionerParams): BatchEntry<ResponseOf<"searchPractitioner">>;
+  /**
+   * Find practitioner roles, as one entry of a batch. Called as `Haau3.searchPractitionerRole` is.
+   *
+   * `GET /v1/fhir/r4/PractitionerRole`
+   */
+  searchPractitionerRole(params?: SearchPractitionerRoleParams): BatchEntry<ResponseOf<"searchPractitionerRole">>;
+  /**
+   * List or find a questionnaire, as one entry of a batch. Called as `Haau3.searchQuestionnaire` is.
+   *
+   * `GET /v1/fhir/r4/Questionnaire`
+   */
+  searchQuestionnaire(params?: SearchQuestionnaireParams): BatchEntry<ResponseOf<"searchQuestionnaire">>;
+  /**
+   * Expand a value set, as one entry of a batch. Called as `Haau3.valueSetExpand` is.
+   *
+   * `GET /v1/fhir/r4/ValueSet/$expand`
+   */
+  valueSetExpand(params?: ValueSetExpandParams): BatchEntry<ResponseOf<"valueSetExpand">>;
+  /**
+   * Expand a value set, as one entry of a batch. Called as `Haau3.valueSetExpandPost` is.
+   *
+   * `POST /v1/fhir/r4/ValueSet/$expand`
+   */
+  valueSetExpandPost(body: BodyOf<"valueSetExpandPost">): BatchEntry<ResponseOf<"valueSetExpandPost">>;
+  /**
+   * Validate a code against a value set, as one entry of a batch. Called as `Haau3.valueSetValidateCode` is.
+   *
+   * `GET /v1/fhir/r4/ValueSet/$validate-code`
+   */
+  valueSetValidateCode(params: ValueSetValidateCodeParams): BatchEntry<ResponseOf<"valueSetValidateCode">>;
+  /**
+   * Validate a code against a value set, as one entry of a batch. Called as `Haau3.valueSetValidateCodePost` is.
+   *
+   * `POST /v1/fhir/r4/ValueSet/$validate-code`
+   */
+  valueSetValidateCodePost(body: BodyOf<"valueSetValidateCodePost">): BatchEntry<ResponseOf<"valueSetValidateCodePost">>;
+}
+//#endregion
 //#region src/transport.d.ts
 /**
  * Options passed on to `fetch` with every request: anything the runtime's `RequestInit` takes, such
@@ -4005,7 +4400,15 @@ interface RequestOptions {
   maxRetries?: number;
   /** Ends the call when it aborts. The abort's reason is thrown as it is. */
   signal?: AbortSignal;
-  /** Extra headers for this call, such as `X-Request-Id` with your own UUID. */
+  /**
+   * An id of your own for this call, a UUID, such as your job's or your trace's. Sent as
+   * `X-Request-Id`; the API keeps it with its record of the request and returns it in
+   * `X-Correlation-Id`, which `.withResponse()` and every error the API answered give back as
+   * `correlationId`. The API takes only a UUID and drops anything else without a word, so the SDK
+   * refuses anything else before sending.
+   */
+  correlationId?: string;
+  /** Extra headers for this call. `correlationId` is the way to send your own `X-Request-Id`. */
   headers?: Record<string, string>;
   /** Passed on to `fetch` for this call, over the client's own `fetchOptions`. */
   fetchOptions?: FetchOptions;
@@ -4068,60 +4471,6 @@ declare abstract class Transport {
   protected url(pathOrUrl: string): URL;
 }
 //#endregion
-//#region src/generated/types.d.ts
-type ListPublishersResponse = components["schemas"]["ListPublishersResponse"];
-type ListServiceTypesResponse = components["schemas"]["ListServiceTypesResponse"];
-type ListSpecialtiesResponse = components["schemas"]["ListSpecialtiesResponse"];
-type Problem = components["schemas"]["Problem"];
-type ProblemIssue = components["schemas"]["ProblemIssue"];
-type SchedulingProviderLocation = components["schemas"]["SchedulingProviderLocation"];
-type SchedulingPublisher = components["schemas"]["SchedulingPublisher"];
-type SchedulingServiceType = components["schemas"]["SchedulingServiceType"];
-type SchedulingSlot = components["schemas"]["SchedulingSlot"];
-type SchedulingSpecialty = components["schemas"]["SchedulingSpecialty"];
-type SearchProviderLocationsResponse = components["schemas"]["SearchProviderLocationsResponse"];
-type SearchSlotsResponse = components["schemas"]["SearchSlotsResponse"];
-/** The query parameters of `checkInsurancePlanNetwork`. */
-type CheckInsurancePlanNetworkParams = QueryOf<"checkInsurancePlanNetwork">;
-/** The query parameters of `codeSystemLookup`. */
-type CodeSystemLookupParams = QueryOf<"codeSystemLookup">;
-/** The query parameters of `codeSystemValidateCode`. */
-type CodeSystemValidateCodeParams = QueryOf<"codeSystemValidateCode">;
-/** The query parameters of `fhirMetadata`. */
-type FhirMetadataParams = QueryOf<"fhirMetadata">;
-/** The query parameters of `listInsurancePlanCounties`. */
-type ListInsurancePlanCountiesParams = QueryOf<"listInsurancePlanCounties">;
-/** The query parameters of `listServiceTypes`. */
-type ListServiceTypesParams = QueryOf<"listServiceTypes">;
-/** The query parameters of `listSpecialties`. */
-type ListSpecialtiesParams = QueryOf<"listSpecialties">;
-/** The query parameters of `searchEndpoint`. */
-type SearchEndpointParams = QueryOf<"searchEndpoint">;
-/** The query parameters of `searchHealthcareService`. */
-type SearchHealthcareServiceParams = QueryOf<"searchHealthcareService">;
-/** The query parameters of `searchInsurancePlan`. */
-type SearchInsurancePlanParams = QueryOf<"searchInsurancePlan">;
-/** The query parameters of `searchLocation`. */
-type SearchLocationParams = QueryOf<"searchLocation">;
-/** The query parameters of `searchOrganization`. */
-type SearchOrganizationParams = QueryOf<"searchOrganization">;
-/** The query parameters of `searchOrganizationAffiliation`. */
-type SearchOrganizationAffiliationParams = QueryOf<"searchOrganizationAffiliation">;
-/** The query parameters of `searchPractitioner`. */
-type SearchPractitionerParams = QueryOf<"searchPractitioner">;
-/** The query parameters of `searchPractitionerRole`. */
-type SearchPractitionerRoleParams = QueryOf<"searchPractitionerRole">;
-/** The query parameters of `searchProviderLocations`. */
-type SearchProviderLocationsParams = QueryOf<"searchProviderLocations">;
-/** The query parameters of `searchQuestionnaire`. */
-type SearchQuestionnaireParams = QueryOf<"searchQuestionnaire">;
-/** The query parameters of `searchSlots`. */
-type SearchSlotsParams = QueryOf<"searchSlots">;
-/** The query parameters of `valueSetExpand`. */
-type ValueSetExpandParams = QueryOf<"valueSetExpand">;
-/** The query parameters of `valueSetValidateCode`. */
-type ValueSetValidateCodeParams = QueryOf<"valueSetValidateCode">;
-//#endregion
 //#region src/generated/methods.d.ts
 /** Every operation of the haau3 platform API. {@link Haau3} is the class to construct. */
 declare abstract class Operations extends Transport {
@@ -4458,6 +4807,7 @@ declare abstract class Operations extends Transport {
  * constructor refuses to run in a browser, where a key would be public.
  */
 export declare class Haau3 extends Operations {
+  #private;
   constructor(options?: ClientOptions);
   /**
    * Every page of a FHIR search, starting with the one you have, following each `next` link
@@ -4472,106 +4822,32 @@ export declare class Haau3 extends Operations {
    * ```
    */
   pages(first: Bundle, options?: RequestOptions): AsyncGenerator<Bundle, void, undefined>;
-}
-//#endregion
-//#region src/errors.d.ts
-/**
- * Why a request got no answer:
- *
- * - `timeout`: an attempt ran past its timeout, or the API answered 504.
- * - `network`: the request never reached the API, or the connection failed.
- * - `rate-limited`: the API answered 429. `retryAfter` says when to try again.
- * - `unavailable`: the API, or a source it reads, could not answer (502, 503).
- * - `server-error`: the API failed (500).
- * - `unreadable`: the API answered with something that is not an answer: a body that is not JSON,
- *   or a FHIR resource of another type than the operation answers with.
- */
-type NoAnswerReason = "timeout" | "network" | "rate-limited" | "unavailable" | "server-error" | "unreadable";
-/** What every error this package throws has. */
-export declare class Haau3Error extends Error {
-  name: string;
-  /** The `X-Request-Id` the API sent, when it answered. Quote it when you ask for help. */
-  readonly requestId: string | undefined;
-  constructor(message: string, requestId?: string, options?: ErrorOptions);
-}
-/** An error body as the SDK read it: an OperationOutcome under the FHIR base, a Problem elsewhere. */
-type AnswerBody = {
-  kind: "outcome";
-  value: OperationOutcome;
-} | {
-  kind: "problem";
-  value: Problem;
-};
-/** How long an answered request took, and in how many attempts. */
-interface Timing {
-  attempts: number;
-  durationMs: number;
-}
-/** The API refused the key: none was sent, it is not one the API knows, or it was revoked (401, 403). */
-export declare class AuthError extends Haau3Error {
-  name: string;
-  readonly status: number;
-  /** How many attempts were made. */
-  readonly attempts: number;
-  /** Milliseconds from the first attempt to the answer. */
-  readonly durationMs: number | undefined;
-  /** The OperationOutcome the FHIR base answered with. Not enumerable, so it is never printed. */
-  readonly outcome?: OperationOutcome;
-  /** The problem the other services answered with. Not enumerable, so it is never printed. */
-  readonly problem?: Problem;
-  constructor(message: string, status: number, requestId?: string, body?: AnswerBody, timing?: Timing);
-}
-/**
- * The API answered and refused the request: a parameter it does not take, a record that does not
- * exist (404), a page that no longer exists (410), a body that is too large (413). `status` says
- * which, and the body says why.
- */
-export declare class RefusedError extends Haau3Error {
-  name: string;
-  readonly status: number;
-  /** How many attempts were made. */
-  readonly attempts: number;
-  /** Milliseconds from the first attempt to the answer. */
-  readonly durationMs: number | undefined;
-  /** The OperationOutcome the FHIR base answered with. Not enumerable, so it is never printed. */
-  readonly outcome?: OperationOutcome;
-  /** The problem the other services answered with. Not enumerable, so it is never printed. */
-  readonly problem?: Problem;
-  constructor(message: string, status: number, requestId?: string, body?: AnswerBody, timing?: Timing);
-}
-/**
- * The request got no answer, after every attempt the client was allowed. This never means "no
- * results": an empty search answers with an empty Bundle or list, not with this error.
- */
-export declare class NoAnswerError extends Haau3Error {
-  name: string;
-  readonly reason: NoAnswerReason;
-  /** The last status the API answered with, when it answered at all. */
-  readonly status: number | undefined;
-  /** Seconds to wait before trying again, when the API said. */
-  readonly retryAfter: number | undefined;
-  /** How many attempts were made. */
-  readonly attempts: number;
-  /** Milliseconds from the first attempt to the last failure, waits between attempts included. */
-  readonly durationMs: number | undefined;
-  /** The OperationOutcome the FHIR base answered with. Not enumerable, so it is never printed. */
-  readonly outcome?: OperationOutcome;
-  /** The problem the other services answered with. Not enumerable, so it is never printed. */
-  readonly problem?: Problem;
-  constructor(message: string, details: {
-    reason: NoAnswerReason;
-    attempts: number;
-    durationMs?: number;
-    status?: number;
-    retryAfter?: number;
-    requestId?: string;
-    body?: AnswerBody;
-    cause?: unknown;
-  });
+  /**
+   * Several operations of the FHIR base in one request, each with its own answer or error, in the
+   * order given. The function you pass gets a builder with every operation a batch can carry, called
+   * as on this client; what it returns is sent.
+   *
+   * ```ts
+   * const [plan, counties] = await haau3.batch((b) => [
+   *   b.readInsurancePlan("H2406-013-000"),
+   *   b.listInsurancePlanCounties({ state: "NC" }),
+   * ]);
+   * if (plan.ok) plan.data; // fhir4.InsurancePlan
+   * else plan.error; // RefusedError or NoAnswerError, as the call alone would have thrown
+   * ```
+   *
+   * Each entry is checked as the call alone is, and fails alone: its result is `{ ok: false, error }`
+   * and the others still answer. An entry that fails is not retried. The batch itself is retried,
+   * and throws, as any call does: an {@link AuthError}, a {@link NoAnswerError} when no answer came
+   * back, a {@link RefusedError} when the API refused the whole batch. The API takes up to 100
+   * entries in up to 1 MiB, and gives a batch 60 seconds; a larger batch is refused, so send several.
+   * `reconcileMedications` cannot go in a batch.
+   */
+  batch<const E extends readonly BatchEntry<unknown>[]>(build: (b: BatchBuilder) => E, options?: RequestOptions): APIPromise<BatchResults<E>>;
 }
 //#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.2.1";
+export declare const VERSION = "0.2.2";
 //#endregion
-export type { CheckInsurancePlanNetworkParams, ClientOptions, CodeSystemLookupParams, CodeSystemValidateCodeParams, FetchOptions, FhirMetadataParams, ListInsurancePlanCountiesParams, ListPublishersResponse, ListServiceTypesParams, ListServiceTypesResponse, ListSpecialtiesParams, ListSpecialtiesResponse, NoAnswerReason, OperationId, Problem, ProblemIssue, QueryValue, RawRequest, RawResponse, RequestOptions, ResponseMeta, SchedulingProviderLocation, SchedulingPublisher, SchedulingServiceType, SchedulingSlot, SchedulingSpecialty, SearchEndpointParams, SearchHealthcareServiceParams, SearchInsurancePlanParams, SearchLocationParams, SearchOrganizationAffiliationParams, SearchOrganizationParams, SearchPractitionerParams, SearchPractitionerRoleParams, SearchProviderLocationsParams, SearchProviderLocationsResponse, SearchQuestionnaireParams, SearchSlotsParams, SearchSlotsResponse, ValueSetExpandParams, ValueSetValidateCodeParams, WithResponse, fhir4 };
+export type { BatchBuilder, BatchEntry, BatchResult, BatchResults, BodyOf, CheckInsurancePlanNetworkParams, ClientOptions, CodeSystemLookupParams, CodeSystemValidateCodeParams, FetchOptions, FhirMetadataParams, Haau3ErrorJSON, ListInsurancePlanCountiesParams, ListPublishersResponse, ListServiceTypesParams, ListServiceTypesResponse, ListSpecialtiesParams, ListSpecialtiesResponse, NoAnswerReason, OperationId, Problem, ProblemIssue, QueryOf, QueryValue, RawRequest, RawResponse, RequestOptions, ResponseMeta, ResponseOf, SchedulingProviderLocation, SchedulingPublisher, SchedulingServiceType, SchedulingSlot, SchedulingSpecialty, SearchEndpointParams, SearchHealthcareServiceParams, SearchInsurancePlanParams, SearchLocationParams, SearchOrganizationAffiliationParams, SearchOrganizationParams, SearchPractitionerParams, SearchPractitionerRoleParams, SearchProviderLocationsParams, SearchProviderLocationsResponse, SearchQuestionnaireParams, SearchSlotsParams, SearchSlotsResponse, ValueSetExpandParams, ValueSetValidateCodeParams, WithResponse, fhir4 };