@everfur/sdk 0.5.1 → 0.5.3

package/dist/bookingTypes-DCs8mmBb.d.cts

@@ -0,0 +1,188 @@
+/** The consult lifecycle, as the platform names it. `unknown` for a status this SDK build has not heard of. */
+declare const CONSULT_STATUSES: readonly ["scheduled", "in_progress", "awaiting_summary", "completed", "cancelled_owner", "cancelled_ops", "no_show_owner", "no_show_vet"];
+type ConsultStatus = (typeof CONSULT_STATUSES)[number] | 'unknown';
+/**
+ * Statuses after which a consult can never change again.
+ *
+ * `awaiting_summary` is deliberately NOT terminal: the call is over but the write-up has not landed, and that
+ * is precisely the window a summary surface polls through.
+ */
+declare const TERMINAL_CONSULT_STATUSES: ReadonlySet<ConsultStatus>;
+declare const CONSULT_KINDS: readonly ["wellness", "prescription"];
+type ConsultKind = (typeof CONSULT_KINDS)[number] | 'unknown';
+/**
+ * What a US state permits. TWO INDEPENDENT SERVER FACTS, not one.
+ *
+ * `wellnessAvailable` and `prescriptionsAvailable` are separate because "we cannot prescribe here but a
+ * wellness visit is available" is a real state the booking flow reads, not a copy decision.
+ */
+interface TelevetStatePolicy {
+    readonly state: string;
+    readonly wellnessAvailable: boolean;
+    readonly prescriptionsAvailable: boolean;
+    /**
+     * ALWAYS NULL against a real server, and kept only so a host that reads it still compiles.
+     *
+     * `StateCapabilitiesResponse` has no `cancellation_policy_text` and never did: it is the jurisdiction
+     * matrix, and its own docstring refuses to carry a booking acknowledgement. The terms live on
+     * `GET /cancellation-policy` with the version token that makes them reportable, which is what
+     * `TelevetCancellationPolicy` and `TelevetBookingController.cancellationPolicy` read. Prefer that; this
+     * field is a wire that was never connected, left in place rather than removed because dropping a public
+     * field is a release decision, and documented rather than quietly parsed so the next surface does not
+     * build a tick on it.
+     */
+    readonly cancellationPolicyText: string | null;
+}
+/**
+ * A clinician card. BIOS ONLY AT LAUNCH, per the platform's own docstring: `photoRef` is an image REF and not a
+ * URL, so a surface that has no presign path renders initials rather than a broken image.
+ */
+interface TelevetClinician {
+    readonly clinicianId: string;
+    readonly displayName: string;
+    readonly credentials: string | null;
+    /** Null below the platform's publication threshold. NEVER coerce to 0: no stars is not zero stars. */
+    readonly rating: number | null;
+    readonly ratingCount: number | null;
+    /** The clinician's own words, or null until they write one. Rendered verbatim, never summarised. */
+    readonly bio: string | null;
+    /** An image ref, not a URL. Null for a clinician without a photo. */
+    readonly photoRef: string | null;
+    /** Where they may practise and what they may do there. Empty until served. */
+    readonly licensedStates: readonly {
+        readonly state: string;
+        readonly canPrescribe: boolean;
+    }[];
+}
+/** One bookable opening. */
+interface TelevetSlot {
+    readonly slotId: string;
+    readonly startsAt: string;
+    readonly endsAt: string;
+}
+/**
+ * An awarded hold. NO HOLD ID: the hold is identified by the slot it sits on plus an expiry. The booking's
+ * idempotency key is therefore minted by the client when a hold is awarded (`televetBookingKey`), one per
+ * hold, rather than read from a hold reference that does not exist.
+ */
+interface TelevetSlotHold {
+    readonly slotId: string;
+    readonly expiresAt: string;
+}
+/** A booked consult, as the server created it. What we asked for is the draft; this is what we got. */
+interface TelevetConsult {
+    readonly consultId: string;
+    readonly petId: string;
+    readonly clinicianId: string;
+    /** The clinician's name, or null when the server has none. Never invented. */
+    readonly clinicianName: string | null;
+    /** What the owner wrote at booking, echoed back. */
+    readonly reasonText: string | null;
+    /** Attachment refs as stored against the consult. */
+    readonly mediaRefs: readonly string[];
+    readonly status: ConsultStatus;
+    readonly kind: ConsultKind;
+    readonly scheduledAt: string;
+    readonly emergencyFlagged: boolean;
+    /**
+     * Has the visit's video room been created? Read from the presence of `meeting_url`, which is the same
+     * signal the backend's `assert_joinable` checks; the URL itself is NOT kept, because the room credential
+     * is minted by the join and a list read is the last place to hold a link to a recorded clinical room.
+     * False moments after booking, while the provisioning outbox drains.
+     */
+    readonly hasRoom: boolean;
+}
+/** The televet entitlement verdict. True only for a live PAID subscription; promo and trial are not enough. */
+interface TelevetBookingEntitlement {
+    readonly active: boolean;
+}
+/**
+ * The cancellation terms, and the token that says WHICH terms they are.
+ *
+ * WHY THIS IS ITS OWN READ. `TelevetStatePolicy.cancellationPolicyText` was parsed off the state-policy
+ * response, and no such field exists on it: `StateCapabilitiesResponse` carries the jurisdiction matrix and
+ * says so in its own docstring, and its `policy_version` is the state matrix's effective date, not the
+ * cancellation terms. So the terms tick could never render and there was no version to report, which is why
+ * the booking body omitted the attestation pair entirely. The server has always served this on its own route
+ * (`GET /cancellation-policy`, CancellationPolicyResponse), unfenced by entitlement precisely so someone
+ * deciding whether to book can read what cancelling costs.
+ *
+ * NEITHER FIELD IS EVER LOCAL. `summary` is the sentence the server derives from the numbers it enforces (the
+ * consumer app shipped a placeholder and a wrong hardcoded fee before this route existed), and `version` is
+ * evidence of what was on screen: a client-authored token would make the audit row a fiction, and a stale one
+ * is refused with a typed 409 rather than recorded as agreement to terms nobody saw.
+ */
+interface TelevetCancellationPolicy {
+    /** The served sentence, rendered verbatim. Never composed, templated or abbreviated by a client. */
+    readonly summary: string;
+    /** The server's own version token, reported back in `cancellation_policy_version`. */
+    readonly version: string;
+}
+/**
+ * The booking request body, in the platform's own field names. Built by `buildBookingBody`, never by hand.
+ *
+ * THE ATTESTATION PAIR IS BOUND, and the binding is the server's, not a house convention. `BookConsultRequest`
+ * declares `state_attested` and `cancellation_policy_version` individually optional and then refuses a request
+ * carrying exactly one (`_attestation_evidence_is_whole`, a 422). The compatibility case the pair is optional
+ * FOR is a client that predates the review screen and sends neither; a client that renders the tick and the
+ * terms and reports half of what the owner did writes an audit row nobody can read. So the SDK models both
+ * fields as jointly present or jointly absent and `validateBookingBody` refuses the half pair locally, before
+ * it can become a 422 the owner reads as "booking failed".
+ */
+interface TelevetBookingBody {
+    readonly pet_id: string;
+    readonly clinician_id: string;
+    readonly slot_id: string;
+    readonly state: string;
+    readonly reason_text: string;
+    readonly species: string | null;
+    readonly media_refs: readonly string[];
+    readonly emergency_acknowledged: boolean;
+    readonly share_health_records: boolean;
+    /**
+     * The review screen's jurisdiction tick, as evidence.
+     *
+     * `true` ONLY, never `false`: the server's field is `Literal[True] | None` because persisting an explicit
+     * `false` is evidence of nothing and accepting it would let a client "attest false". An owner who has not
+     * ticked sends the pair absent, not a `false` half of it.
+     */
+    readonly state_attested?: true;
+    /**
+     * Which cancellation terms the owner was SHOWN: the served version token, never a client-authored value.
+     *
+     * Paired with `state_attested` above. A stale token is refused with a typed 409 rather than recorded as if
+     * the owner had read the current terms, which is why it is the SERVER's token and why there is no local
+     * default: a build with no version to report sends the pair absent and the audit row says so honestly.
+     */
+    readonly cancellation_policy_version?: string;
+}
+/** The server's own ceiling on `cancellation_policy_version` (`Field(max_length=64)`). */
+declare const CANCELLATION_POLICY_VERSION_MAX = 64;
+/** The server's own bound on `reason_text`. Enforced locally so an over-long description fails on the screen. */
+declare const REASON_TEXT_MAX = 2000;
+/** The server's own ceiling on `media_refs`. */
+declare const MEDIA_REFS_MAX = 10;
+/** A two-letter US state code, the only shape the booking wire accepts for `state`. */
+declare function isWellFormedStateCode(state: string | null | undefined): boolean;
+/**
+ * What cancelling cost, as the server recorded it (`CancelConsultResponse`).
+ *
+ * `summary` IS THE SERVER'S SENTENCE, rendered verbatim: it is derived from the amount the cancel transaction
+ * itself computed, and the backend states the one rule it keeps (a recorded fee is worded as recorded and
+ * payable, never as "you will not be charged"). A client-side sentence built from `feeCents` would be a
+ * second author for a commercial statement.
+ */
+interface TelevetCancelReceipt {
+    /** What was recorded against this cancellation, in cents. Zero inside the free window. */
+    readonly feeCents: number;
+    /** ISO-4217, lowercase. */
+    readonly currency: string;
+    /** The flag to branch on, rather than comparing `feeCents` to zero or parsing `summary`. */
+    readonly feeRecorded: boolean;
+    /** The served sentence for the confirmation. Null when the server sent none; never composed here. */
+    readonly summary: string | null;
+}
+/** The server's own bound on a cancellation reason (`PartnerCancelRequest.reason`, 1..240). */
+declare const CANCEL_REASON_MAX = 240;
+
+export { type ConsultStatus as C, MEDIA_REFS_MAX as M, REASON_TEXT_MAX as R, type TelevetConsult as T, type TelevetStatePolicy as a, type TelevetBookingEntitlement as b, type TelevetCancellationPolicy as c, type TelevetClinician as d, type TelevetSlot as e, type TelevetSlotHold as f, type TelevetBookingBody as g, type TelevetCancelReceipt as h, CANCELLATION_POLICY_VERSION_MAX as i, CANCEL_REASON_MAX as j, CONSULT_KINDS as k, CONSULT_STATUSES as l, type ConsultKind as m, TERMINAL_CONSULT_STATUSES as n, isWellFormedStateCode as o };

package/dist/bookingTypes-DCs8mmBb.d.ts

@@ -0,0 +1,188 @@
+/** The consult lifecycle, as the platform names it. `unknown` for a status this SDK build has not heard of. */
+declare const CONSULT_STATUSES: readonly ["scheduled", "in_progress", "awaiting_summary", "completed", "cancelled_owner", "cancelled_ops", "no_show_owner", "no_show_vet"];
+type ConsultStatus = (typeof CONSULT_STATUSES)[number] | 'unknown';
+/**
+ * Statuses after which a consult can never change again.
+ *
+ * `awaiting_summary` is deliberately NOT terminal: the call is over but the write-up has not landed, and that
+ * is precisely the window a summary surface polls through.
+ */
+declare const TERMINAL_CONSULT_STATUSES: ReadonlySet<ConsultStatus>;
+declare const CONSULT_KINDS: readonly ["wellness", "prescription"];
+type ConsultKind = (typeof CONSULT_KINDS)[number] | 'unknown';
+/**
+ * What a US state permits. TWO INDEPENDENT SERVER FACTS, not one.
+ *
+ * `wellnessAvailable` and `prescriptionsAvailable` are separate because "we cannot prescribe here but a
+ * wellness visit is available" is a real state the booking flow reads, not a copy decision.
+ */
+interface TelevetStatePolicy {
+    readonly state: string;
+    readonly wellnessAvailable: boolean;
+    readonly prescriptionsAvailable: boolean;
+    /**
+     * ALWAYS NULL against a real server, and kept only so a host that reads it still compiles.
+     *
+     * `StateCapabilitiesResponse` has no `cancellation_policy_text` and never did: it is the jurisdiction
+     * matrix, and its own docstring refuses to carry a booking acknowledgement. The terms live on
+     * `GET /cancellation-policy` with the version token that makes them reportable, which is what
+     * `TelevetCancellationPolicy` and `TelevetBookingController.cancellationPolicy` read. Prefer that; this
+     * field is a wire that was never connected, left in place rather than removed because dropping a public
+     * field is a release decision, and documented rather than quietly parsed so the next surface does not
+     * build a tick on it.
+     */
+    readonly cancellationPolicyText: string | null;
+}
+/**
+ * A clinician card. BIOS ONLY AT LAUNCH, per the platform's own docstring: `photoRef` is an image REF and not a
+ * URL, so a surface that has no presign path renders initials rather than a broken image.
+ */
+interface TelevetClinician {
+    readonly clinicianId: string;
+    readonly displayName: string;
+    readonly credentials: string | null;
+    /** Null below the platform's publication threshold. NEVER coerce to 0: no stars is not zero stars. */
+    readonly rating: number | null;
+    readonly ratingCount: number | null;
+    /** The clinician's own words, or null until they write one. Rendered verbatim, never summarised. */
+    readonly bio: string | null;
+    /** An image ref, not a URL. Null for a clinician without a photo. */
+    readonly photoRef: string | null;
+    /** Where they may practise and what they may do there. Empty until served. */
+    readonly licensedStates: readonly {
+        readonly state: string;
+        readonly canPrescribe: boolean;
+    }[];
+}
+/** One bookable opening. */
+interface TelevetSlot {
+    readonly slotId: string;
+    readonly startsAt: string;
+    readonly endsAt: string;
+}
+/**
+ * An awarded hold. NO HOLD ID: the hold is identified by the slot it sits on plus an expiry. The booking's
+ * idempotency key is therefore minted by the client when a hold is awarded (`televetBookingKey`), one per
+ * hold, rather than read from a hold reference that does not exist.
+ */
+interface TelevetSlotHold {
+    readonly slotId: string;
+    readonly expiresAt: string;
+}
+/** A booked consult, as the server created it. What we asked for is the draft; this is what we got. */
+interface TelevetConsult {
+    readonly consultId: string;
+    readonly petId: string;
+    readonly clinicianId: string;
+    /** The clinician's name, or null when the server has none. Never invented. */
+    readonly clinicianName: string | null;
+    /** What the owner wrote at booking, echoed back. */
+    readonly reasonText: string | null;
+    /** Attachment refs as stored against the consult. */
+    readonly mediaRefs: readonly string[];
+    readonly status: ConsultStatus;
+    readonly kind: ConsultKind;
+    readonly scheduledAt: string;
+    readonly emergencyFlagged: boolean;
+    /**
+     * Has the visit's video room been created? Read from the presence of `meeting_url`, which is the same
+     * signal the backend's `assert_joinable` checks; the URL itself is NOT kept, because the room credential
+     * is minted by the join and a list read is the last place to hold a link to a recorded clinical room.
+     * False moments after booking, while the provisioning outbox drains.
+     */
+    readonly hasRoom: boolean;
+}
+/** The televet entitlement verdict. True only for a live PAID subscription; promo and trial are not enough. */
+interface TelevetBookingEntitlement {
+    readonly active: boolean;
+}
+/**
+ * The cancellation terms, and the token that says WHICH terms they are.
+ *
+ * WHY THIS IS ITS OWN READ. `TelevetStatePolicy.cancellationPolicyText` was parsed off the state-policy
+ * response, and no such field exists on it: `StateCapabilitiesResponse` carries the jurisdiction matrix and
+ * says so in its own docstring, and its `policy_version` is the state matrix's effective date, not the
+ * cancellation terms. So the terms tick could never render and there was no version to report, which is why
+ * the booking body omitted the attestation pair entirely. The server has always served this on its own route
+ * (`GET /cancellation-policy`, CancellationPolicyResponse), unfenced by entitlement precisely so someone
+ * deciding whether to book can read what cancelling costs.
+ *
+ * NEITHER FIELD IS EVER LOCAL. `summary` is the sentence the server derives from the numbers it enforces (the
+ * consumer app shipped a placeholder and a wrong hardcoded fee before this route existed), and `version` is
+ * evidence of what was on screen: a client-authored token would make the audit row a fiction, and a stale one
+ * is refused with a typed 409 rather than recorded as agreement to terms nobody saw.
+ */
+interface TelevetCancellationPolicy {
+    /** The served sentence, rendered verbatim. Never composed, templated or abbreviated by a client. */
+    readonly summary: string;
+    /** The server's own version token, reported back in `cancellation_policy_version`. */
+    readonly version: string;
+}
+/**
+ * The booking request body, in the platform's own field names. Built by `buildBookingBody`, never by hand.
+ *
+ * THE ATTESTATION PAIR IS BOUND, and the binding is the server's, not a house convention. `BookConsultRequest`
+ * declares `state_attested` and `cancellation_policy_version` individually optional and then refuses a request
+ * carrying exactly one (`_attestation_evidence_is_whole`, a 422). The compatibility case the pair is optional
+ * FOR is a client that predates the review screen and sends neither; a client that renders the tick and the
+ * terms and reports half of what the owner did writes an audit row nobody can read. So the SDK models both
+ * fields as jointly present or jointly absent and `validateBookingBody` refuses the half pair locally, before
+ * it can become a 422 the owner reads as "booking failed".
+ */
+interface TelevetBookingBody {
+    readonly pet_id: string;
+    readonly clinician_id: string;
+    readonly slot_id: string;
+    readonly state: string;
+    readonly reason_text: string;
+    readonly species: string | null;
+    readonly media_refs: readonly string[];
+    readonly emergency_acknowledged: boolean;
+    readonly share_health_records: boolean;
+    /**
+     * The review screen's jurisdiction tick, as evidence.
+     *
+     * `true` ONLY, never `false`: the server's field is `Literal[True] | None` because persisting an explicit
+     * `false` is evidence of nothing and accepting it would let a client "attest false". An owner who has not
+     * ticked sends the pair absent, not a `false` half of it.
+     */
+    readonly state_attested?: true;
+    /**
+     * Which cancellation terms the owner was SHOWN: the served version token, never a client-authored value.
+     *
+     * Paired with `state_attested` above. A stale token is refused with a typed 409 rather than recorded as if
+     * the owner had read the current terms, which is why it is the SERVER's token and why there is no local
+     * default: a build with no version to report sends the pair absent and the audit row says so honestly.
+     */
+    readonly cancellation_policy_version?: string;
+}
+/** The server's own ceiling on `cancellation_policy_version` (`Field(max_length=64)`). */
+declare const CANCELLATION_POLICY_VERSION_MAX = 64;
+/** The server's own bound on `reason_text`. Enforced locally so an over-long description fails on the screen. */
+declare const REASON_TEXT_MAX = 2000;
+/** The server's own ceiling on `media_refs`. */
+declare const MEDIA_REFS_MAX = 10;
+/** A two-letter US state code, the only shape the booking wire accepts for `state`. */
+declare function isWellFormedStateCode(state: string | null | undefined): boolean;
+/**
+ * What cancelling cost, as the server recorded it (`CancelConsultResponse`).
+ *
+ * `summary` IS THE SERVER'S SENTENCE, rendered verbatim: it is derived from the amount the cancel transaction
+ * itself computed, and the backend states the one rule it keeps (a recorded fee is worded as recorded and
+ * payable, never as "you will not be charged"). A client-side sentence built from `feeCents` would be a
+ * second author for a commercial statement.
+ */
+interface TelevetCancelReceipt {
+    /** What was recorded against this cancellation, in cents. Zero inside the free window. */
+    readonly feeCents: number;
+    /** ISO-4217, lowercase. */
+    readonly currency: string;
+    /** The flag to branch on, rather than comparing `feeCents` to zero or parsing `summary`. */
+    readonly feeRecorded: boolean;
+    /** The served sentence for the confirmation. Null when the server sent none; never composed here. */
+    readonly summary: string | null;
+}
+/** The server's own bound on a cancellation reason (`PartnerCancelRequest.reason`, 1..240). */
+declare const CANCEL_REASON_MAX = 240;
+
+export { type ConsultStatus as C, MEDIA_REFS_MAX as M, REASON_TEXT_MAX as R, type TelevetConsult as T, type TelevetStatePolicy as a, type TelevetBookingEntitlement as b, type TelevetCancellationPolicy as c, type TelevetClinician as d, type TelevetSlot as e, type TelevetSlotHold as f, type TelevetBookingBody as g, type TelevetCancelReceipt as h, CANCELLATION_POLICY_VERSION_MAX as i, CANCEL_REASON_MAX as j, CONSULT_KINDS as k, CONSULT_STATUSES as l, type ConsultKind as m, TERMINAL_CONSULT_STATUSES as n, isWellFormedStateCode as o };

package/dist/{callCopy-rDH9JTFo.d.cts → callCopy-CPe9mbwG.d.cts}

@@ -1,4 +1,9 @@
-/** The consult length the lobby quotes, in minutes. everfur-mobile-2026-7 televetTime.ts:85 `CONSULT_MINUTES`. */
+/**
+ * The consumer mobile app's consult-length constant, in minutes (everfur-mobile-2026-7 televetTime.ts:85
+ * `CONSULT_MINUTES`). NOT the length of any particular visit: the join response serves that as
+ * `call_limits.consult_minutes` (`VetCallCredential.callLimits.consultMinutes`), and a surface that has it uses
+ * it. The web lobby no longer falls back to this number.
+ */
 declare const VET_CALL_CONSULT_MINUTES = 10;
 declare const VET_CALL_COPY: Readonly<{
     /** Controls, shared by the lobby and the live call. */
@@ -24,7 +29,7 @@ declare const VET_CALL_COPY: Readonly<{
     lobbyTitle: (clinicianName: string | null | undefined) => string;
     /** `{pet}` is DATA from the roster. Absent, the pet-free form is used instead. */
     lobbyPrep: (petName: string | null | undefined) => string;
-    /** `{n}` is `VET_CALL_CONSULT_MINUTES`, never a hardcoded number. */
+    /** `{n}` is the visit length in minutes: the served `call_limits.consult_minutes` where the surface has it. */
     lobbyDuration: (minutes: number) => string;
     /** The consumer app's `visit.joinFailedReason` (:735), shown when the call object errors. */
     joinFailedReason: "That did not open. Try again.";

package/dist/{callCopy-rDH9JTFo.d.ts → callCopy-CPe9mbwG.d.ts}

@@ -1,4 +1,9 @@
-/** The consult length the lobby quotes, in minutes. everfur-mobile-2026-7 televetTime.ts:85 `CONSULT_MINUTES`. */
+/**
+ * The consumer mobile app's consult-length constant, in minutes (everfur-mobile-2026-7 televetTime.ts:85
+ * `CONSULT_MINUTES`). NOT the length of any particular visit: the join response serves that as
+ * `call_limits.consult_minutes` (`VetCallCredential.callLimits.consultMinutes`), and a surface that has it uses
+ * it. The web lobby no longer falls back to this number.
+ */
 declare const VET_CALL_CONSULT_MINUTES = 10;
 declare const VET_CALL_COPY: Readonly<{
     /** Controls, shared by the lobby and the live call. */
@@ -24,7 +29,7 @@ declare const VET_CALL_COPY: Readonly<{
     lobbyTitle: (clinicianName: string | null | undefined) => string;
     /** `{pet}` is DATA from the roster. Absent, the pet-free form is used instead. */
     lobbyPrep: (petName: string | null | undefined) => string;
-    /** `{n}` is `VET_CALL_CONSULT_MINUTES`, never a hardcoded number. */
+    /** `{n}` is the visit length in minutes: the served `call_limits.consult_minutes` where the surface has it. */
     lobbyDuration: (minutes: number) => string;
     /** The consumer app's `visit.joinFailedReason` (:735), shown when the call object errors. */
     joinFailedReason: "That did not open. Try again.";

package/dist/{casesRepository-BTAecTnF.d.ts → casesRepository-YCI0OVwl.d.ts}

@@ -1,5 +1,5 @@
 import { E as EverfurResult } from './EverfurResult-SGvHKsCB.js';
-import { A as AuthContext } from './identity-Dy_L7Yq4.js';
+import { A as AuthContext } from './identity-AuoeDRTh.js';
 import { P as PetRef } from './ids-B2GAAifq.js';
 
 /** The owner's answer to a check-in, the wire values of the consumer `CheckinResponse` enum. */

package/dist/{casesRepository-aryld7fJ.d.cts → casesRepository-z2JAFlKA.d.cts}

@@ -1,5 +1,5 @@
 import { E as EverfurResult } from './EverfurResult-ZtH-YV1h.cjs';
-import { A as AuthContext } from './identity-DjqhDm5Z.cjs';
+import { A as AuthContext } from './identity-Z0yj-fC_.cjs';
 import { P as PetRef } from './ids-B2GAAifq.cjs';
 
 /** The owner's answer to a check-in, the wire values of the consumer `CheckinResponse` enum. */