@everfur/sdk 0.5.1 → 0.5.3

package/dist/{attachments-CzZ7in24.d.ts → attachments-TXOhN36S.d.ts}

@@ -1,12 +1,12 @@
 import { E as EverfurError } from './EverfurError-DmELDpXp.js';
 import { E as EverfurResult } from './EverfurResult-SGvHKsCB.js';
 import { C as ConversationId, P as PetRef, b as ResponseId } from './ids-B2GAAifq.js';
-import { f as ChatFeedbackType, j as ChatStatus, i as ChatMessage, c as ChatConversationListOptions, d as ChatConversationPage, g as ChatHistoryOptions, h as ChatMessagePage, a as ChatCheckinTarget, e as ChatFeedbackReceipt } from './ports-C0m1G1fS.js';
-import { C as CheckinAnswer, a as CheckinOutcome } from './casesRepository-BTAecTnF.js';
-import { i as UrgencyLevel } from './config-X6BtwDwQ.js';
-import { W as WidgetPet } from './petsRepository-DhsX3GLw.js';
+import { f as ChatFeedbackType, j as ChatStatus, i as ChatMessage, c as ChatConversationListOptions, d as ChatConversationPage, g as ChatHistoryOptions, h as ChatMessagePage, a as ChatCheckinTarget, e as ChatFeedbackReceipt } from './ports-DNIvfzBP.js';
+import { C as CheckinAnswer, a as CheckinOutcome } from './casesRepository-YCI0OVwl.js';
+import { i as UrgencyLevel } from './config-BXVgTLCh.js';
+import { W as WidgetPet } from './petsRepository-BaTOwJ5L.js';
 import { U as UploadTransport, F as FileHandle } from './ports-BN6RHF9W.js';
-import { c as AttachmentQueue, d as AttachmentState, A as AttachmentError, b as AttachmentOutcome } from './attachments-D3HCBmOE.js';
+import { c as AttachmentQueue, d as AttachmentState, A as AttachmentError, b as AttachmentOutcome } from './attachments-5_p7kE38.js';
 
 /** The three thumbs. `'neutral'` is the app's rotated thumbs-down glyph. */
 type ChatSentiment = 'up' | 'neutral' | 'down';

package/dist/{attachments-Nk73Lll8.d.cts → attachments-affGN_Uv.d.cts}

@@ -1,7 +1,7 @@
 import { E as EverfurError } from './EverfurError-DmELDpXp.cjs';
-import { R as RequestFunnel } from './requestFunnel-Bqc1inM9.cjs';
+import { R as RequestFunnel } from './requestFunnel-DrigK6q_.cjs';
 import { F as FileHandle, U as UploadTransport, a as UploadPolicyWire } from './ports-BN6RHF9W.cjs';
-import { R as ReadableStore, T as Timers } from './ports-DNXyyzZF.cjs';
+import { R as ReadableStore, T as Timers } from './ports-Dof7AQjk.cjs';
 
 /** The image MIME types the chat accepts (the server's `CHAT_ATTACHMENT` rule, plus the `image/jpg` alias). */
 declare const ATTACHMENT_MIME_TYPES: readonly string[];

package/dist/{bookingCopy-SDkXaxDf.d.ts → bookingCopy-BQ7Pg7qg.d.ts}

@@ -1,197 +1,12 @@
+import { a as TelevetStatePolicy, b as TelevetBookingEntitlement, c as TelevetCancellationPolicy, d as TelevetClinician, e as TelevetSlot, f as TelevetSlotHold, g as TelevetBookingBody, T as TelevetConsult, h as TelevetCancelReceipt, C as ConsultStatus } from './bookingTypes-DCs8mmBb.js';
 import { E as EverfurError } from './EverfurError-DmELDpXp.js';
 import { E as EverfurResult } from './EverfurResult-SGvHKsCB.js';
-import { R as RequestFunnel } from './requestFunnel-FvE5yLDD.js';
-import { A as AuthContext } from './identity-Dy_L7Yq4.js';
+import { R as RequestFunnel } from './requestFunnel-CJC_q4BZ.js';
+import { A as AuthContext } from './identity-AuoeDRTh.js';
 import { E as ErrorPolicyPort } from './ErrorPolicyPort-D22LUVrK.js';
 import { T as TelemetryPort } from './TelemetryPort-BDNr00hu.js';
 import { b as VetCallCredential, c as VetCallJoinRefusal } from './callRoom-7wrE3RP2.js';
 
-/** 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, which is why the
- * booking's idempotency key is derived from the SLOT and not 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;
-
 /** The partner booking surface, relative to the API base. One prefix, so a dark tenant is dark for all of it. */
 declare const TELEVET_BOOKING_BASE = "/widget/v1/televet";
 /**
@@ -249,9 +64,14 @@ interface TelevetBookingController {
     /**
      * Create the consult.
      *
-     * `idempotencyKey` is the IDENTITY of this booking, derived once from the held slot when the draft is
-     * composed. It seeds the header the funnel writes, so a resubmit after a timeout is the same booking and
-     * cannot create a second consult. It is not itself the header: see `book` in the factory below.
+     * `idempotencyKey` is the IDENTITY of ONE booking attempt, minted when a hold is awarded
+     * (`televetBookingKey`) and kept for as long as that hold is the one being booked. It seeds the header the
+     * funnel writes, so a resubmit after a timeout is the same attempt and cannot create a second consult, while
+     * a new hold, even on the same slot, is a new attempt with a new key. It is not itself the header: see
+     * `book` in the factory below.
+     *
+     * A 2xx carrying a consult that is not live settles as an error (`televetBookingNotLiveError`), never as a
+     * booking: see `LIVE_CONSULT_STATUSES`.
      */
     book(body: TelevetBookingBody, idempotencyKey: string): Promise<EverfurResult<TelevetConsult>>;
     /** Move an existing consult to an already-held slot. One server operation, not a book-then-cancel. */
@@ -500,10 +320,10 @@ interface TelevetBookingDraft {
     /** The consent tick that mints a records grant in the booking transaction. */
     readonly shareHealthRecords: boolean;
     /**
-     * Minted ONCE per composed booking and reused across retries.
+     * Minted ONCE per awarded hold (`televetBookingKey`) and reused across retries of that booking.
      *
-     * Derived from the SLOT rather than a hold id, which this wire does not have. A timeout followed by a retry
-     * must not create a second consult.
+     * One attempt, not one slot: a timeout followed by a retry must not create a second consult, and a new hold
+     * on the same slot (after a cancel, say) must not be answered with the old consult.
      */
     readonly idempotencyKey: string | null;
 }
@@ -583,7 +403,21 @@ declare function canConfirm(draft: TelevetBookingDraft, reasonText: string): boo
  */
 declare function isHoldExpired(draft: TelevetBookingDraft, nowMs: number): boolean;
 /**
- * The idempotency key for a composed booking, derived from the SLOT.
+ * The idempotency key for ONE booking attempt: minted when a hold is awarded, and a NEW key on every call.
+ *
+ * CALL IT ONCE PER AWARDED HOLD and keep the result in the draft (`idempotencyKey`). Every submit of that draft
+ * then reuses it, so a Confirm pressed again after a timeout is the same booking and the server answers with the
+ * consult it recorded rather than creating a second one. That is what the key is for.
+ *
+ * IT USED TO BE DERIVED FROM THE SLOT ALONE (`televet.book.<slotId>`), and that made two DIFFERENT bookings of
+ * one slot the same booking to the server. On staging, 2026-09-23: a member booked a slot, cancelled the visit,
+ * and booked the same slot again; the server treated the second booking as a replay of the first and answered
+ * 201 with the first consult, cancelled, and the flow said "You're booked". No visit existed. A slot can be
+ * booked, released and booked again; a hold cannot, so the key belongs to the hold.
+ *
+ * THE ATTEMPT COMES FIRST and the slot after it, because the funnel caps a seeded key at 128 characters (the
+ * route's own bound) by cutting the tail: a long slot id may lose its end, the part that tells two attempts
+ * apart never does. The slot stays in the key so a server log still says which slot an attempt was for.
  *
  * One definition, because the reducer clears it and the flow mints it: two spellings would let a retry after a
  * cleared draft create a second consult.
@@ -625,7 +459,11 @@ declare function attestation(stateAttested: boolean, termsAttested: boolean, pol
 type TelevetBookingFailure = 'taken' | 'expired' | 'failed' | 'not_entitled'
 /** The remedy is a DIFFERENT VET, not a different time: re-picking a slot with the same clinician refuses again. */
  | 'clinician_unavailable'
-/** Per-owner caps. The remedy is WAITING, so this must never render as an invitation to press again. */
+/**
+ * Per-owner caps. Kept apart from `failed` so a host can tell them apart, and both steps render the same
+ * generic line for it, "That did not book. Try again.", never the server's own sentence: the owner's
+ * decision of 2026-09-24, matching consumer web, which shows its generic booking failure for a 429.
+ */
  | 'rate_limited'
 /** The partner booking surface is dark here. No retry can fix it, so the flow says so and offers its exit. */
  | 'unavailable' | null;
@@ -817,9 +655,9 @@ type TelevetBookingRefusal =
     /**
      * The SERVER'S OWN wording, when it sends any.
      *
-     * Carried rather than replaced with a string written here: a wait message is the server's to phrase, it
-     * can change without an app release, and this SDK does not author user-facing copy. Null renders no line
-     * at all rather than a placeholder.
+     * Carried for a host that reads it, and rendered by no SDK screen: since the owner's decision of
+     * 2026-09-24 the booking steps and the visits list show their existing generic line for a 429, as
+     * consumer web does. The SDK writes no rate-limit sentence of its own.
      */
     readonly message: string | null;
 }
@@ -1132,4 +970,4 @@ type TelevetBookingCopy = typeof TELEVET_BOOKING_COPY;
  */
 declare function isTelevetBookingCopyReady(): boolean;
 
-export { createTelevetBookingController as $, type TelevetBookingCopy as A, type TelevetBookingDraft as B, CANCELLATION_POLICY_VERSION_MAX as C, type TelevetBookingEntitlement as D, type TelevetBookingFailure as E, type TelevetBookingRefusal as F, type TelevetBookingState as G, type TelevetCancellationPolicy as H, type TelevetClinician as I, type TelevetEarlyTriage as J, type TelevetEmptyRosterView as K, type TelevetJoinReadiness as L, MEDIA_REFS_MAX as M, NO_MEDIA_SHORTFALL as N, type TelevetJoinState as O, type TelevetMediaRefusal as P, type TelevetRead as Q, REASON_TEXT_MAX as R, type TelevetSlotHold as S, type TelevetEmptyRosterCause as T, type TelevetStateInterestReason as U, type TelevetStatePolicy as V, type TelevetTriageVerdict as W, type TelevetWrite as X, attestation as Y, canConfirm as Z, canManageTelevetVisit as _, type TelevetStateInterestAction as a, currentStep as a0, emptyTelevetDraft as a1, formatVisitRange as a2, formatWhen as a3, formatWhenWithDay as a4, hasPreviousStep as a5, initialTelevetBookingState as a6, isHoldExpired as a7, isMediaShortfallEmpty as a8, isSkipped as a9, useTelevetJoin as aA, useTelevetNextSlot as aB, useTelevetRescheduleConsult as aC, useTelevetSlots as aD, useTelevetStatePolicy as aE, validateBookingBody as aF, withUnsentPicks as aG, type TelevetJoinBlock as aH, type TelevetJoinDecision as aI, televetJoinDecision as aJ, isTelevetBookingCopyReady as aa, isWellFormedStateCode as ab, mediaShortfallFromUnsentPicks as ac, splitTelevetVisits as ad, televetBookingKey as ae, televetBookingReducer as af, televetBookingRefusal as ag, televetCancelCall as ah, televetConsultCall as ai, televetEmptyRosterCause as aj, televetEmptyRosterView as ak, televetHoldCall as al, televetJoinCall as am, televetJoinOpensAtMs as an, televetJoinReadiness as ao, televetMediaShortfallLines as ap, televetRescheduleCall as aq, useEarlyTriage as ar, useStateInterest as as, useTelevetBookConsult as at, useTelevetBookingAvailable as au, useTelevetBookingController as av, useTelevetBookingEntitlement as aw, useTelevetCancellationPolicy as ax, useTelevetClinicians as ay, useTelevetHoldSlot as az, type TelevetMediaShortfall as b, type TelevetConsult as c, type TelevetBookingStep as d, type TelevetBookingController as e, type TelevetTriageRead as f, type TelevetStateInterestWrite as g, type TelevetCancelReceipt as h, type TelevetSlot as i, CANCEL_REASON_MAX as j, CONSULT_KINDS as k, CONSULT_MINUTES as l, CONSULT_STATUSES as m, type ConsultKind as n, type ConsultStatus as o, TELEVET_BOOKING_BASE as p, TELEVET_BOOKING_COPY as q, TELEVET_BOOKING_STEPS as r, TELEVET_CONSULT_PAGE_LIMIT as s, TELEVET_JOIN_CLOSES_MINUTES_AFTER as t, TELEVET_JOIN_OPENS_MINUTES_BEFORE as u, TERMINAL_CONSULT_STATUSES as v, type TelevetBookingAction as w, type TelevetBookingBody as x, type TelevetBookingContext as y, type TelevetBookingControllerDeps as z };
+export { televetConsultCall as $, type TelevetStateInterestReason as A, type TelevetTriageVerdict as B, CONSULT_MINUTES as C, type TelevetWrite as D, attestation as E, canConfirm as F, canManageTelevetVisit as G, createTelevetBookingController as H, currentStep as I, emptyTelevetDraft as J, formatVisitRange as K, formatWhen as L, formatWhenWithDay as M, NO_MEDIA_SHORTFALL as N, hasPreviousStep as O, initialTelevetBookingState as P, isHoldExpired as Q, isMediaShortfallEmpty as R, isSkipped as S, type TelevetEmptyRosterCause as T, isTelevetBookingCopyReady as U, mediaShortfallFromUnsentPicks as V, splitTelevetVisits as W, televetBookingKey as X, televetBookingReducer as Y, televetBookingRefusal as Z, televetCancelCall as _, type TelevetStateInterestAction as a, televetEmptyRosterCause as a0, televetEmptyRosterView as a1, televetHoldCall as a2, televetJoinCall as a3, televetJoinOpensAtMs as a4, televetJoinReadiness as a5, televetMediaShortfallLines as a6, televetRescheduleCall as a7, useEarlyTriage as a8, useStateInterest as a9, useTelevetBookConsult as aa, useTelevetBookingAvailable as ab, useTelevetBookingController as ac, useTelevetBookingEntitlement as ad, useTelevetCancellationPolicy as ae, useTelevetClinicians as af, useTelevetHoldSlot as ag, useTelevetJoin as ah, useTelevetNextSlot as ai, useTelevetRescheduleConsult as aj, useTelevetSlots as ak, useTelevetStatePolicy as al, validateBookingBody as am, withUnsentPicks as an, type TelevetJoinBlock as ao, type TelevetJoinDecision as ap, televetJoinDecision as aq, type TelevetMediaShortfall as b, type TelevetBookingStep as c, type TelevetBookingController as d, type TelevetTriageRead as e, type TelevetStateInterestWrite as f, TELEVET_BOOKING_BASE as g, TELEVET_BOOKING_COPY as h, TELEVET_BOOKING_STEPS as i, TELEVET_CONSULT_PAGE_LIMIT as j, TELEVET_JOIN_CLOSES_MINUTES_AFTER as k, TELEVET_JOIN_OPENS_MINUTES_BEFORE as l, type TelevetBookingAction as m, type TelevetBookingContext as n, type TelevetBookingControllerDeps as o, type TelevetBookingCopy as p, type TelevetBookingDraft as q, type TelevetBookingFailure as r, type TelevetBookingRefusal as s, type TelevetBookingState as t, type TelevetEarlyTriage as u, type TelevetEmptyRosterView as v, type TelevetJoinReadiness as w, type TelevetJoinState as x, type TelevetMediaRefusal as y, type TelevetRead as z };

package/dist/{bookingCopy-Dv8rKqyV.d.cts → bookingCopy-BpZvZO1S.d.cts}

@@ -1,197 +1,12 @@
+import { a as TelevetStatePolicy, b as TelevetBookingEntitlement, c as TelevetCancellationPolicy, d as TelevetClinician, e as TelevetSlot, f as TelevetSlotHold, g as TelevetBookingBody, T as TelevetConsult, h as TelevetCancelReceipt, C as ConsultStatus } from './bookingTypes-DCs8mmBb.cjs';
 import { E as EverfurError } from './EverfurError-DmELDpXp.cjs';
 import { E as EverfurResult } from './EverfurResult-ZtH-YV1h.cjs';
-import { R as RequestFunnel } from './requestFunnel-Bqc1inM9.cjs';
-import { A as AuthContext } from './identity-DjqhDm5Z.cjs';
+import { R as RequestFunnel } from './requestFunnel-DrigK6q_.cjs';
+import { A as AuthContext } from './identity-Z0yj-fC_.cjs';
 import { E as ErrorPolicyPort } from './ErrorPolicyPort-D6CybiqJ.cjs';
 import { T as TelemetryPort } from './TelemetryPort-BDNr00hu.cjs';
 import { b as VetCallCredential, c as VetCallJoinRefusal } from './callRoom-B_EqaUzx.cjs';
 
-/** 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, which is why the
- * booking's idempotency key is derived from the SLOT and not 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;
-
 /** The partner booking surface, relative to the API base. One prefix, so a dark tenant is dark for all of it. */
 declare const TELEVET_BOOKING_BASE = "/widget/v1/televet";
 /**
@@ -249,9 +64,14 @@ interface TelevetBookingController {
     /**
      * Create the consult.
      *
-     * `idempotencyKey` is the IDENTITY of this booking, derived once from the held slot when the draft is
-     * composed. It seeds the header the funnel writes, so a resubmit after a timeout is the same booking and
-     * cannot create a second consult. It is not itself the header: see `book` in the factory below.
+     * `idempotencyKey` is the IDENTITY of ONE booking attempt, minted when a hold is awarded
+     * (`televetBookingKey`) and kept for as long as that hold is the one being booked. It seeds the header the
+     * funnel writes, so a resubmit after a timeout is the same attempt and cannot create a second consult, while
+     * a new hold, even on the same slot, is a new attempt with a new key. It is not itself the header: see
+     * `book` in the factory below.
+     *
+     * A 2xx carrying a consult that is not live settles as an error (`televetBookingNotLiveError`), never as a
+     * booking: see `LIVE_CONSULT_STATUSES`.
      */
     book(body: TelevetBookingBody, idempotencyKey: string): Promise<EverfurResult<TelevetConsult>>;
     /** Move an existing consult to an already-held slot. One server operation, not a book-then-cancel. */
@@ -500,10 +320,10 @@ interface TelevetBookingDraft {
     /** The consent tick that mints a records grant in the booking transaction. */
     readonly shareHealthRecords: boolean;
     /**
-     * Minted ONCE per composed booking and reused across retries.
+     * Minted ONCE per awarded hold (`televetBookingKey`) and reused across retries of that booking.
      *
-     * Derived from the SLOT rather than a hold id, which this wire does not have. A timeout followed by a retry
-     * must not create a second consult.
+     * One attempt, not one slot: a timeout followed by a retry must not create a second consult, and a new hold
+     * on the same slot (after a cancel, say) must not be answered with the old consult.
      */
     readonly idempotencyKey: string | null;
 }
@@ -583,7 +403,21 @@ declare function canConfirm(draft: TelevetBookingDraft, reasonText: string): boo
  */
 declare function isHoldExpired(draft: TelevetBookingDraft, nowMs: number): boolean;
 /**
- * The idempotency key for a composed booking, derived from the SLOT.
+ * The idempotency key for ONE booking attempt: minted when a hold is awarded, and a NEW key on every call.
+ *
+ * CALL IT ONCE PER AWARDED HOLD and keep the result in the draft (`idempotencyKey`). Every submit of that draft
+ * then reuses it, so a Confirm pressed again after a timeout is the same booking and the server answers with the
+ * consult it recorded rather than creating a second one. That is what the key is for.
+ *
+ * IT USED TO BE DERIVED FROM THE SLOT ALONE (`televet.book.<slotId>`), and that made two DIFFERENT bookings of
+ * one slot the same booking to the server. On staging, 2026-09-23: a member booked a slot, cancelled the visit,
+ * and booked the same slot again; the server treated the second booking as a replay of the first and answered
+ * 201 with the first consult, cancelled, and the flow said "You're booked". No visit existed. A slot can be
+ * booked, released and booked again; a hold cannot, so the key belongs to the hold.
+ *
+ * THE ATTEMPT COMES FIRST and the slot after it, because the funnel caps a seeded key at 128 characters (the
+ * route's own bound) by cutting the tail: a long slot id may lose its end, the part that tells two attempts
+ * apart never does. The slot stays in the key so a server log still says which slot an attempt was for.
  *
  * One definition, because the reducer clears it and the flow mints it: two spellings would let a retry after a
  * cleared draft create a second consult.
@@ -625,7 +459,11 @@ declare function attestation(stateAttested: boolean, termsAttested: boolean, pol
 type TelevetBookingFailure = 'taken' | 'expired' | 'failed' | 'not_entitled'
 /** The remedy is a DIFFERENT VET, not a different time: re-picking a slot with the same clinician refuses again. */
  | 'clinician_unavailable'
-/** Per-owner caps. The remedy is WAITING, so this must never render as an invitation to press again. */
+/**
+ * Per-owner caps. Kept apart from `failed` so a host can tell them apart, and both steps render the same
+ * generic line for it, "That did not book. Try again.", never the server's own sentence: the owner's
+ * decision of 2026-09-24, matching consumer web, which shows its generic booking failure for a 429.
+ */
  | 'rate_limited'
 /** The partner booking surface is dark here. No retry can fix it, so the flow says so and offers its exit. */
  | 'unavailable' | null;
@@ -817,9 +655,9 @@ type TelevetBookingRefusal =
     /**
      * The SERVER'S OWN wording, when it sends any.
      *
-     * Carried rather than replaced with a string written here: a wait message is the server's to phrase, it
-     * can change without an app release, and this SDK does not author user-facing copy. Null renders no line
-     * at all rather than a placeholder.
+     * Carried for a host that reads it, and rendered by no SDK screen: since the owner's decision of
+     * 2026-09-24 the booking steps and the visits list show their existing generic line for a 429, as
+     * consumer web does. The SDK writes no rate-limit sentence of its own.
      */
     readonly message: string | null;
 }
@@ -1132,4 +970,4 @@ type TelevetBookingCopy = typeof TELEVET_BOOKING_COPY;
  */
 declare function isTelevetBookingCopyReady(): boolean;
 
-export { createTelevetBookingController as $, type TelevetBookingCopy as A, type TelevetBookingDraft as B, CANCELLATION_POLICY_VERSION_MAX as C, type TelevetBookingEntitlement as D, type TelevetBookingFailure as E, type TelevetBookingRefusal as F, type TelevetBookingState as G, type TelevetCancellationPolicy as H, type TelevetClinician as I, type TelevetEarlyTriage as J, type TelevetEmptyRosterView as K, type TelevetJoinReadiness as L, MEDIA_REFS_MAX as M, NO_MEDIA_SHORTFALL as N, type TelevetJoinState as O, type TelevetMediaRefusal as P, type TelevetRead as Q, REASON_TEXT_MAX as R, type TelevetSlotHold as S, type TelevetEmptyRosterCause as T, type TelevetStateInterestReason as U, type TelevetStatePolicy as V, type TelevetTriageVerdict as W, type TelevetWrite as X, attestation as Y, canConfirm as Z, canManageTelevetVisit as _, type TelevetStateInterestAction as a, currentStep as a0, emptyTelevetDraft as a1, formatVisitRange as a2, formatWhen as a3, formatWhenWithDay as a4, hasPreviousStep as a5, initialTelevetBookingState as a6, isHoldExpired as a7, isMediaShortfallEmpty as a8, isSkipped as a9, useTelevetJoin as aA, useTelevetNextSlot as aB, useTelevetRescheduleConsult as aC, useTelevetSlots as aD, useTelevetStatePolicy as aE, validateBookingBody as aF, withUnsentPicks as aG, type TelevetJoinBlock as aH, type TelevetJoinDecision as aI, televetJoinDecision as aJ, isTelevetBookingCopyReady as aa, isWellFormedStateCode as ab, mediaShortfallFromUnsentPicks as ac, splitTelevetVisits as ad, televetBookingKey as ae, televetBookingReducer as af, televetBookingRefusal as ag, televetCancelCall as ah, televetConsultCall as ai, televetEmptyRosterCause as aj, televetEmptyRosterView as ak, televetHoldCall as al, televetJoinCall as am, televetJoinOpensAtMs as an, televetJoinReadiness as ao, televetMediaShortfallLines as ap, televetRescheduleCall as aq, useEarlyTriage as ar, useStateInterest as as, useTelevetBookConsult as at, useTelevetBookingAvailable as au, useTelevetBookingController as av, useTelevetBookingEntitlement as aw, useTelevetCancellationPolicy as ax, useTelevetClinicians as ay, useTelevetHoldSlot as az, type TelevetMediaShortfall as b, type TelevetConsult as c, type TelevetBookingStep as d, type TelevetBookingController as e, type TelevetTriageRead as f, type TelevetStateInterestWrite as g, type TelevetCancelReceipt as h, type TelevetSlot as i, CANCEL_REASON_MAX as j, CONSULT_KINDS as k, CONSULT_MINUTES as l, CONSULT_STATUSES as m, type ConsultKind as n, type ConsultStatus as o, TELEVET_BOOKING_BASE as p, TELEVET_BOOKING_COPY as q, TELEVET_BOOKING_STEPS as r, TELEVET_CONSULT_PAGE_LIMIT as s, TELEVET_JOIN_CLOSES_MINUTES_AFTER as t, TELEVET_JOIN_OPENS_MINUTES_BEFORE as u, TERMINAL_CONSULT_STATUSES as v, type TelevetBookingAction as w, type TelevetBookingBody as x, type TelevetBookingContext as y, type TelevetBookingControllerDeps as z };
+export { televetConsultCall as $, type TelevetStateInterestReason as A, type TelevetTriageVerdict as B, CONSULT_MINUTES as C, type TelevetWrite as D, attestation as E, canConfirm as F, canManageTelevetVisit as G, createTelevetBookingController as H, currentStep as I, emptyTelevetDraft as J, formatVisitRange as K, formatWhen as L, formatWhenWithDay as M, NO_MEDIA_SHORTFALL as N, hasPreviousStep as O, initialTelevetBookingState as P, isHoldExpired as Q, isMediaShortfallEmpty as R, isSkipped as S, type TelevetEmptyRosterCause as T, isTelevetBookingCopyReady as U, mediaShortfallFromUnsentPicks as V, splitTelevetVisits as W, televetBookingKey as X, televetBookingReducer as Y, televetBookingRefusal as Z, televetCancelCall as _, type TelevetStateInterestAction as a, televetEmptyRosterCause as a0, televetEmptyRosterView as a1, televetHoldCall as a2, televetJoinCall as a3, televetJoinOpensAtMs as a4, televetJoinReadiness as a5, televetMediaShortfallLines as a6, televetRescheduleCall as a7, useEarlyTriage as a8, useStateInterest as a9, useTelevetBookConsult as aa, useTelevetBookingAvailable as ab, useTelevetBookingController as ac, useTelevetBookingEntitlement as ad, useTelevetCancellationPolicy as ae, useTelevetClinicians as af, useTelevetHoldSlot as ag, useTelevetJoin as ah, useTelevetNextSlot as ai, useTelevetRescheduleConsult as aj, useTelevetSlots as ak, useTelevetStatePolicy as al, validateBookingBody as am, withUnsentPicks as an, type TelevetJoinBlock as ao, type TelevetJoinDecision as ap, televetJoinDecision as aq, type TelevetMediaShortfall as b, type TelevetBookingStep as c, type TelevetBookingController as d, type TelevetTriageRead as e, type TelevetStateInterestWrite as f, TELEVET_BOOKING_BASE as g, TELEVET_BOOKING_COPY as h, TELEVET_BOOKING_STEPS as i, TELEVET_CONSULT_PAGE_LIMIT as j, TELEVET_JOIN_CLOSES_MINUTES_AFTER as k, TELEVET_JOIN_OPENS_MINUTES_BEFORE as l, type TelevetBookingAction as m, type TelevetBookingContext as n, type TelevetBookingControllerDeps as o, type TelevetBookingCopy as p, type TelevetBookingDraft as q, type TelevetBookingFailure as r, type TelevetBookingRefusal as s, type TelevetBookingState as t, type TelevetEarlyTriage as u, type TelevetEmptyRosterView as v, type TelevetJoinReadiness as w, type TelevetJoinState as x, type TelevetMediaRefusal as y, type TelevetRead as z };