@haau3/sdk 0.1.2 → 0.2.1

package/dist/index.d.cts

@@ -1,5 +1,44 @@
 import * as fhir4 from "fhir/r4.js";
 import { Bundle, OperationOutcome } from "fhir/r4.js";
+//#region src/api-promise.d.ts
+/** What the API answered besides the body: the same names {@link Transport.request} uses. */
+interface ResponseMeta {
+  /** The `X-Request-Id` the API sent. Quote it when you ask for help. */
+  requestId: string | undefined;
+  /** Milliseconds from the first attempt to the answer, waits between attempts included. */
+  durationMs: number;
+  /** How many attempts were made. */
+  attempts: number;
+  status: number;
+  headers: Headers;
+}
+/** A typed call's answer together with what came with it. */
+type WithResponse<T> = ResponseMeta & {
+  data: T;
+};
+/**
+ * What every typed method returns: a promise of the answer, as before, that can also give the
+ * request id and timing that came with it.
+ *
+ * ```ts
+ * const plan = await haau3.readInsurancePlan(id);
+ * const { data, requestId, durationMs } = await haau3.readInsurancePlan(id).withResponse();
+ * ```
+ *
+ * The request is sent once, when the method is called, whichever way it is awaited.
+ */
+export declare class APIPromise<T> extends Promise<T> {
+  #private;
+  constructor(response: Promise<WithResponse<T>>);
+  /** The answer, its request id, its timing, its status and its headers. */
+  withResponse(): Promise<WithResponse<T>>;
+  then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+  catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): Promise<T | TResult>;
+  finally(onfinally?: (() => void) | null): Promise<T>;
+  /** `Promise.prototype.then` and friends build plain promises from an APIPromise. */
+  static get [Symbol.species](): PromiseConstructor;
+}
+//#endregion
 //#region src/generated/openapi.d.ts
 interface components {
   schemas: {
@@ -3928,6 +3967,15 @@ type ResponseOf<Op extends OperationId> = operations[Op]["responses"] extends {
 } ? Content[keyof Content] : never;
 //#endregion
 //#region src/transport.d.ts
+/**
+ * Options passed on to `fetch` with every request: anything the runtime's `RequestInit` takes, such
+ * as `cache`, undici's `dispatcher`, Cloudflare's `cf` or Next.js's `next`. The SDK's own method,
+ * headers, body, signal and redirect always win. `cache` is declared here because Node's own `RequestInit` type leaves it out,
+ * though Node's fetch takes it.
+ */
+type FetchOptions = Omit<RequestInit, "method" | "headers" | "body" | "signal" | "redirect" | "cache"> & {
+  cache?: "default" | "force-cache" | "no-cache" | "no-store" | "only-if-cached" | "reload" | undefined;
+};
 /** How to construct the client. Every option has a default. */
 interface ClientOptions {
   /** Your platform API key (`haau3_sk_…`). Defaults to `process.env.HAAU3_API_KEY`. */
@@ -3940,6 +3988,14 @@ interface ClientOptions {
   maxRetries?: number;
   /** The fetch to send requests with. Defaults to the global `fetch`. */
   fetch?: typeof fetch;
+  /**
+   * Passed on to `fetch` with every request: anything the runtime's fetch takes, such as undici's
+   * `dispatcher` for a proxy in Node, Cloudflare's `cf` or Next.js's `next`. Unless it sets `cache`
+   * (or Next.js's `next`), every request is sent with `cache: "no-store"` where the runtime takes
+   * the field: an API answer is live data for one key, never one a fetch cache should keep. Pass
+   * `{ cache: undefined }` to send no `cache` at all.
+   */
+  fetchOptions?: FetchOptions;
 }
 /** Options for one call. Each overrides the client's own for that call only. */
 interface RequestOptions {
@@ -3951,6 +4007,8 @@ interface RequestOptions {
   signal?: AbortSignal;
   /** Extra headers for this call, such as `X-Request-Id` with your own UUID. */
   headers?: Record<string, string>;
+  /** Passed on to `fetch` for this call, over the client's own `fetchOptions`. */
+  fetchOptions?: FetchOptions;
 }
 /** A query parameter's value. A list sends the parameter once per value. */
 type QueryValue = string | number | boolean | ReadonlyArray<string | number | boolean> | undefined;
@@ -3964,15 +4022,9 @@ interface RawRequest extends RequestOptions {
   body?: unknown;
 }
 /** What the API answered, whatever its status. */
-interface RawResponse {
-  status: number;
-  headers: Headers;
+interface RawResponse extends ResponseMeta {
   /** The body, parsed when it is JSON, else its text. */
   body: unknown;
-  /** The `X-Request-Id` the API sent. */
-  requestId: string | undefined;
-  attempts: number;
-  durationMs: number;
 }
 /** What a generated method passes to {@link Transport.operation}. */
 interface OperationCall {
@@ -3981,6 +4033,8 @@ interface OperationCall {
   pathParams?: Record<string, string>;
   query?: object;
   body?: unknown;
+  /** The FHIR resource types the operation answers with, from the spec. Unset for other answers. */
+  expects?: readonly string[];
 }
 /** The connection, retries and errors every operation shares. */
 declare abstract class Transport {
@@ -3997,13 +4051,19 @@ declare abstract class Transport {
    * answer arrived ({@link NoAnswerError}), or for a URL that is not on the client's own `baseURL`.
    */
   request(request: RawRequest): Promise<RawResponse>;
-  /** Runs one operation of the spec and returns its answer, or throws one of the three errors. */
-  protected operation<T>(call: OperationCall, options?: RequestOptions): Promise<T>;
+  /**
+   * Runs one operation of the spec and returns its answer, or throws one of the three errors. The
+   * answer's `.withResponse()` gives its request id and timing too.
+   */
+  protected operation<T>(call: OperationCall, options?: RequestOptions): APIPromise<T>;
+  /** Sends a request and returns its answer only. See {@link Transport.respond}. */
+  protected answer<T>(method: "GET" | "POST", url: URL, body: unknown, options: RequestOptions, label: string, expects?: readonly string[]): Promise<T>;
   /**
    * Sends a request and reads its answer. `label` names the request in an error message: the
    * operation's path with its `{id}` left in, so no value a caller sent ends up in a message.
+   * `expects`, when set, are the FHIR resource types the answer may be; any other is not an answer.
    */
-  protected answer<T>(method: "GET" | "POST", url: URL, body: unknown, options: RequestOptions, label: string): Promise<T>;
+  protected respond<T>(method: "GET" | "POST", url: URL, body: unknown, options: RequestOptions, label: string, expects?: readonly string[]): Promise<WithResponse<T>>;
   /** A URL on this client's base, refusing any other host so the key is never sent to one. */
   protected url(pathOrUrl: string): URL;
 }
@@ -4072,7 +4132,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/InsurancePlan/{id}/$in-network`
    */
-  checkInsurancePlanNetwork(id: string, params: CheckInsurancePlanNetworkParams, options?: RequestOptions): Promise<ResponseOf<"checkInsurancePlanNetwork">>;
+  checkInsurancePlanNetwork(id: string, params: CheckInsurancePlanNetworkParams, options?: RequestOptions): APIPromise<ResponseOf<"checkInsurancePlanNetwork">>;
   /**
    * Look up a code
    *
@@ -4080,7 +4140,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/CodeSystem/$lookup`
    */
-  codeSystemLookup(params: CodeSystemLookupParams, options?: RequestOptions): Promise<ResponseOf<"codeSystemLookup">>;
+  codeSystemLookup(params: CodeSystemLookupParams, options?: RequestOptions): APIPromise<ResponseOf<"codeSystemLookup">>;
   /**
    * Look up a code
    *
@@ -4088,7 +4148,7 @@ declare abstract class Operations extends Transport {
    *
    * `POST /v1/fhir/r4/CodeSystem/$lookup`
    */
-  codeSystemLookupPost(body: BodyOf<"codeSystemLookupPost">, options?: RequestOptions): Promise<ResponseOf<"codeSystemLookupPost">>;
+  codeSystemLookupPost(body: BodyOf<"codeSystemLookupPost">, options?: RequestOptions): APIPromise<ResponseOf<"codeSystemLookupPost">>;
   /**
    * Validate a code in a code system
    *
@@ -4096,7 +4156,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/CodeSystem/$validate-code`
    */
-  codeSystemValidateCode(params: CodeSystemValidateCodeParams, options?: RequestOptions): Promise<ResponseOf<"codeSystemValidateCode">>;
+  codeSystemValidateCode(params: CodeSystemValidateCodeParams, options?: RequestOptions): APIPromise<ResponseOf<"codeSystemValidateCode">>;
   /**
    * Validate a code in a code system
    *
@@ -4104,7 +4164,7 @@ declare abstract class Operations extends Transport {
    *
    * `POST /v1/fhir/r4/CodeSystem/$validate-code`
    */
-  codeSystemValidateCodePost(body: BodyOf<"codeSystemValidateCodePost">, options?: RequestOptions): Promise<ResponseOf<"codeSystemValidateCodePost">>;
+  codeSystemValidateCodePost(body: BodyOf<"codeSystemValidateCodePost">, options?: RequestOptions): APIPromise<ResponseOf<"codeSystemValidateCodePost">>;
   /**
    * Run several operations in one request (batch)
    *
@@ -4112,7 +4172,7 @@ declare abstract class Operations extends Transport {
    *
    * `POST /v1/fhir/r4`
    */
-  fhirBatch(body: BodyOf<"fhirBatch">, options?: RequestOptions): Promise<ResponseOf<"fhirBatch">>;
+  fhirBatch(body: BodyOf<"fhirBatch">, options?: RequestOptions): APIPromise<ResponseOf<"fhirBatch">>;
   /**
    * Capability statement
    *
@@ -4120,7 +4180,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/metadata`
    */
-  fhirMetadata(params?: FhirMetadataParams, options?: RequestOptions): Promise<ResponseOf<"fhirMetadata">>;
+  fhirMetadata(params?: FhirMetadataParams, options?: RequestOptions): APIPromise<ResponseOf<"fhirMetadata">>;
   /**
    * List a state's counties
    *
@@ -4128,7 +4188,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/InsurancePlan/$counties`
    */
-  listInsurancePlanCounties(params: ListInsurancePlanCountiesParams, options?: RequestOptions): Promise<ResponseOf<"listInsurancePlanCounties">>;
+  listInsurancePlanCounties(params: ListInsurancePlanCountiesParams, options?: RequestOptions): APIPromise<ResponseOf<"listInsurancePlanCounties">>;
   /**
    * List scheduling publishers
    *
@@ -4136,7 +4196,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/scheduling/publishers`
    */
-  listPublishers(options?: RequestOptions): Promise<ResponseOf<"listPublishers">>;
+  listPublishers(options?: RequestOptions): APIPromise<ResponseOf<"listPublishers">>;
   /**
    * List service types
    *
@@ -4144,7 +4204,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/scheduling/service-types`
    */
-  listServiceTypes(params?: ListServiceTypesParams, options?: RequestOptions): Promise<ResponseOf<"listServiceTypes">>;
+  listServiceTypes(params?: ListServiceTypesParams, options?: RequestOptions): APIPromise<ResponseOf<"listServiceTypes">>;
   /**
    * List specialties
    *
@@ -4152,7 +4212,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/scheduling/specialties`
    */
-  listSpecialties(params?: ListSpecialtiesParams, options?: RequestOptions): Promise<ResponseOf<"listSpecialties">>;
+  listSpecialties(params?: ListSpecialtiesParams, options?: RequestOptions): APIPromise<ResponseOf<"listSpecialties">>;
   /**
    * Read an Endpoint
    *
@@ -4160,7 +4220,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/Endpoint/{id}`
    */
-  readEndpoint(id: string, options?: RequestOptions): Promise<ResponseOf<"readEndpoint">>;
+  readEndpoint(id: string, options?: RequestOptions): APIPromise<ResponseOf<"readEndpoint">>;
   /**
    * Read a HealthcareService
    *
@@ -4168,7 +4228,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/HealthcareService/{id}`
    */
-  readHealthcareService(id: string, options?: RequestOptions): Promise<ResponseOf<"readHealthcareService">>;
+  readHealthcareService(id: string, options?: RequestOptions): APIPromise<ResponseOf<"readHealthcareService">>;
   /**
    * Read a plan
    *
@@ -4176,7 +4236,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/InsurancePlan/{id}`
    */
-  readInsurancePlan(id: string, options?: RequestOptions): Promise<ResponseOf<"readInsurancePlan">>;
+  readInsurancePlan(id: string, options?: RequestOptions): APIPromise<ResponseOf<"readInsurancePlan">>;
   /**
    * Read a Location
    *
@@ -4184,7 +4244,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/Location/{id}`
    */
-  readLocation(id: string, options?: RequestOptions): Promise<ResponseOf<"readLocation">>;
+  readLocation(id: string, options?: RequestOptions): APIPromise<ResponseOf<"readLocation">>;
   /**
    * Read an Organization
    *
@@ -4192,7 +4252,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/Organization/{id}`
    */
-  readOrganization(id: string, options?: RequestOptions): Promise<ResponseOf<"readOrganization">>;
+  readOrganization(id: string, options?: RequestOptions): APIPromise<ResponseOf<"readOrganization">>;
   /**
    * Read an OrganizationAffiliation
    *
@@ -4200,7 +4260,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/OrganizationAffiliation/{id}`
    */
-  readOrganizationAffiliation(id: string, options?: RequestOptions): Promise<ResponseOf<"readOrganizationAffiliation">>;
+  readOrganizationAffiliation(id: string, options?: RequestOptions): APIPromise<ResponseOf<"readOrganizationAffiliation">>;
   /**
    * Read a Practitioner
    *
@@ -4208,7 +4268,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/Practitioner/{id}`
    */
-  readPractitioner(id: string, options?: RequestOptions): Promise<ResponseOf<"readPractitioner">>;
+  readPractitioner(id: string, options?: RequestOptions): APIPromise<ResponseOf<"readPractitioner">>;
   /**
    * Read a PractitionerRole
    *
@@ -4216,7 +4276,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/PractitionerRole/{id}`
    */
-  readPractitionerRole(id: string, options?: RequestOptions): Promise<ResponseOf<"readPractitionerRole">>;
+  readPractitionerRole(id: string, options?: RequestOptions): APIPromise<ResponseOf<"readPractitionerRole">>;
   /**
    * Read a questionnaire
    *
@@ -4226,7 +4286,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/Questionnaire/{id}`
    */
-  readQuestionnaire(id: string, options?: RequestOptions): Promise<ResponseOf<"readQuestionnaire">>;
+  readQuestionnaire(id: string, options?: RequestOptions): APIPromise<ResponseOf<"readQuestionnaire">>;
   /**
    * Reconcile one patient's medication records
    *
@@ -4234,7 +4294,7 @@ declare abstract class Operations extends Transport {
    *
    * `POST /v1/fhir/r4/$reconcile-medications`
    */
-  reconcileMedications(body: BodyOf<"reconcileMedications">, options?: RequestOptions): Promise<ResponseOf<"reconcileMedications">>;
+  reconcileMedications(body: BodyOf<"reconcileMedications">, options?: RequestOptions): APIPromise<ResponseOf<"reconcileMedications">>;
   /**
    * Find endpoints
    *
@@ -4242,7 +4302,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/Endpoint`
    */
-  searchEndpoint(params?: SearchEndpointParams, options?: RequestOptions): Promise<ResponseOf<"searchEndpoint">>;
+  searchEndpoint(params?: SearchEndpointParams, options?: RequestOptions): APIPromise<ResponseOf<"searchEndpoint">>;
   /**
    * Find healthcare services
    *
@@ -4250,7 +4310,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/HealthcareService`
    */
-  searchHealthcareService(params?: SearchHealthcareServiceParams, options?: RequestOptions): Promise<ResponseOf<"searchHealthcareService">>;
+  searchHealthcareService(params?: SearchHealthcareServiceParams, options?: RequestOptions): APIPromise<ResponseOf<"searchHealthcareService">>;
   /**
    * Find a plan
    *
@@ -4264,7 +4324,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/InsurancePlan`
    */
-  searchInsurancePlan(params?: SearchInsurancePlanParams, options?: RequestOptions): Promise<ResponseOf<"searchInsurancePlan">>;
+  searchInsurancePlan(params?: SearchInsurancePlanParams, options?: RequestOptions): APIPromise<ResponseOf<"searchInsurancePlan">>;
   /**
    * Find practice locations
    *
@@ -4272,7 +4332,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/Location`
    */
-  searchLocation(params?: SearchLocationParams, options?: RequestOptions): Promise<ResponseOf<"searchLocation">>;
+  searchLocation(params?: SearchLocationParams, options?: RequestOptions): APIPromise<ResponseOf<"searchLocation">>;
   /**
    * Find organizations, payers and networks
    *
@@ -4284,7 +4344,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/Organization`
    */
-  searchOrganization(params?: SearchOrganizationParams, options?: RequestOptions): Promise<ResponseOf<"searchOrganization">>;
+  searchOrganization(params?: SearchOrganizationParams, options?: RequestOptions): APIPromise<ResponseOf<"searchOrganization">>;
   /**
    * Find the organizations in a network
    *
@@ -4292,7 +4352,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/OrganizationAffiliation`
    */
-  searchOrganizationAffiliation(params?: SearchOrganizationAffiliationParams, options?: RequestOptions): Promise<ResponseOf<"searchOrganizationAffiliation">>;
+  searchOrganizationAffiliation(params?: SearchOrganizationAffiliationParams, options?: RequestOptions): APIPromise<ResponseOf<"searchOrganizationAffiliation">>;
   /**
    * Find a practitioner by NPI or name
    *
@@ -4304,7 +4364,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/Practitioner`
    */
-  searchPractitioner(params?: SearchPractitionerParams, options?: RequestOptions): Promise<ResponseOf<"searchPractitioner">>;
+  searchPractitioner(params?: SearchPractitionerParams, options?: RequestOptions): APIPromise<ResponseOf<"searchPractitioner">>;
   /**
    * Find practitioner roles
    *
@@ -4316,7 +4376,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/PractitionerRole`
    */
-  searchPractitionerRole(params?: SearchPractitionerRoleParams, options?: RequestOptions): Promise<ResponseOf<"searchPractitionerRole">>;
+  searchPractitionerRole(params?: SearchPractitionerRoleParams, options?: RequestOptions): APIPromise<ResponseOf<"searchPractitionerRole">>;
   /**
    * Search provider locations
    *
@@ -4324,7 +4384,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/scheduling/provider-locations`
    */
-  searchProviderLocations(params?: SearchProviderLocationsParams, options?: RequestOptions): Promise<ResponseOf<"searchProviderLocations">>;
+  searchProviderLocations(params?: SearchProviderLocationsParams, options?: RequestOptions): APIPromise<ResponseOf<"searchProviderLocations">>;
   /**
    * List or find a questionnaire
    *
@@ -4340,7 +4400,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/Questionnaire`
    */
-  searchQuestionnaire(params?: SearchQuestionnaireParams, options?: RequestOptions): Promise<ResponseOf<"searchQuestionnaire">>;
+  searchQuestionnaire(params?: SearchQuestionnaireParams, options?: RequestOptions): APIPromise<ResponseOf<"searchQuestionnaire">>;
   /**
    * Search appointment slots
    *
@@ -4348,7 +4408,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/scheduling/slots`
    */
-  searchSlots(params?: SearchSlotsParams, options?: RequestOptions): Promise<ResponseOf<"searchSlots">>;
+  searchSlots(params?: SearchSlotsParams, options?: RequestOptions): APIPromise<ResponseOf<"searchSlots">>;
   /**
    * Expand a value set
    *
@@ -4356,7 +4416,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/ValueSet/$expand`
    */
-  valueSetExpand(params?: ValueSetExpandParams, options?: RequestOptions): Promise<ResponseOf<"valueSetExpand">>;
+  valueSetExpand(params?: ValueSetExpandParams, options?: RequestOptions): APIPromise<ResponseOf<"valueSetExpand">>;
   /**
    * Expand a value set
    *
@@ -4364,7 +4424,7 @@ declare abstract class Operations extends Transport {
    *
    * `POST /v1/fhir/r4/ValueSet/$expand`
    */
-  valueSetExpandPost(body: BodyOf<"valueSetExpandPost">, options?: RequestOptions): Promise<ResponseOf<"valueSetExpandPost">>;
+  valueSetExpandPost(body: BodyOf<"valueSetExpandPost">, options?: RequestOptions): APIPromise<ResponseOf<"valueSetExpandPost">>;
   /**
    * Validate a code against a value set
    *
@@ -4372,7 +4432,7 @@ declare abstract class Operations extends Transport {
    *
    * `GET /v1/fhir/r4/ValueSet/$validate-code`
    */
-  valueSetValidateCode(params: ValueSetValidateCodeParams, options?: RequestOptions): Promise<ResponseOf<"valueSetValidateCode">>;
+  valueSetValidateCode(params: ValueSetValidateCodeParams, options?: RequestOptions): APIPromise<ResponseOf<"valueSetValidateCode">>;
   /**
    * Validate a code against a value set
    *
@@ -4380,7 +4440,7 @@ declare abstract class Operations extends Transport {
    *
    * `POST /v1/fhir/r4/ValueSet/$validate-code`
    */
-  valueSetValidateCodePost(body: BodyOf<"valueSetValidateCodePost">, options?: RequestOptions): Promise<ResponseOf<"valueSetValidateCodePost">>;
+  valueSetValidateCodePost(body: BodyOf<"valueSetValidateCodePost">, options?: RequestOptions): APIPromise<ResponseOf<"valueSetValidateCodePost">>;
 }
 //#endregion
 //#region src/client.d.ts
@@ -4423,8 +4483,8 @@ export declare class Haau3 extends Operations {
  * - `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, such as a body that is
- *   not JSON.
+ * - `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. */
@@ -4442,15 +4502,24 @@ type AnswerBody = {
   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);
+  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
@@ -4460,11 +4529,15 @@ export declare class AuthError extends Haau3Error {
 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);
+  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
@@ -4479,6 +4552,8 @@ export declare class NoAnswerError extends Haau3Error {
   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. */
@@ -4486,6 +4561,7 @@ export declare class NoAnswerError extends Haau3Error {
   constructor(message: string, details: {
     reason: NoAnswerReason;
     attempts: number;
+    durationMs?: number;
     status?: number;
     retryAfter?: number;
     requestId?: string;
@@ -4496,6 +4572,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.2";
+export declare const VERSION = "0.2.1";
 //#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 };
+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 };