@everfur/sdk 0.1.1 → 0.3.0

package/dist/web/index.d.cts

@@ -0,0 +1,217 @@
+import { ReactNode, CSSProperties } from 'react';
+import { E as EverfurProviderProps } from '../context-XvTzq1tE.cjs';
+export { a as EverfurConfig, b as EverfurHandle, c as EverfurUser, U as UseEverfurPetProfileState, u as useCapability, d as useEverfur, e as useEverfurPetProfile, f as useEverfurTheme } from '../context-XvTzq1tE.cjs';
+import { C as CapabilityName, a as CapabilityDecision } from '../resolve-D4Ywz5OS.cjs';
+export { b as CapabilityDisabled, D as DisabledLevel } from '../resolve-D4Ywz5OS.cjs';
+import { U as UrgencyDisplayLevel, L as LifecyclePort, E as EverfurChatDraftStore } from '../attachments-D8T5re7e.cjs';
+export { C as ChatFeedbackReason, a as ChatFeedbackReasonOption, b as ChatSentiment, c as UseChatAttachmentsOptions, d as UseChatAttachmentsState, e as UseEverfurChatState, f as UseEverfurPetsState, u as useChatAttachments, g as useEverfurChat, h as useEverfurPets } from '../attachments-D8T5re7e.cjs';
+import { P as PetRef, C as ConversationId } from '../ids-B2GAAifq.cjs';
+export { B as Brand, a as ClientId, b as ResponseId, U as UserRef, _ as __brand, c as conversationId, p as petRef, u as userRef } from '../ids-B2GAAifq.cjs';
+import { a as ChatCheckinTarget } from '../ports-DEBzEhbp.cjs';
+export { C as ChatCheckin, b as ChatConversation, c as ChatConversationListOptions, d as ChatConversationPage, e as ChatFeedbackReceipt, f as ChatFeedbackType, g as ChatHistoryOptions, i as ChatMessage, h as ChatMessagePage, j as ChatStatus, k as Citation, P as PresignedPolicy, S as SendOptions, U as UploadPort } from '../ports-DEBzEhbp.cjs';
+import { P as PetProfileInput } from '../casesRepository-DHwtGRYY.cjs';
+export { C as CheckinAnswer, a as CheckinOutcome, c as PetProfilePatch, R as RegisteredPet, W as WatchCase, b as WidgetPet, d as WidgetPetProfile } from '../casesRepository-DHwtGRYY.cjs';
+export { d as EverfurConfigError, E as EverfurError, a as EverfurErrorCategory, b as EverfurErrorCode, c as EverfurResult, e as EverfurThrownError, f as categoryFor, i as isErr, g as isOk, h as isRetryableCode, u as unwrap, j as userFacingError } from '../EverfurResult-DN9pL2Ab.cjs';
+export { A as AttachmentError, a as AttachmentErrorCode, b as AttachmentOutcome, c as AttachmentQueue, d as AttachmentState, e as AttachmentStatus } from '../attachments-CQgFrEQ7.cjs';
+import { U as UploadTransport, F as FileHandle } from '../ports-BN6RHF9W.cjs';
+export { b as FilePort, a as UploadPolicyWire } from '../ports-BN6RHF9W.cjs';
+import { K as KvPort } from '../cacheEpoch-DknKn3S0.cjs';
+export { I as ImageCachePort } from '../cacheEpoch-DknKn3S0.cjs';
+export { L as LogLevel, a as LogRecord, b as LogSink, P as PrepareOptions, c as PrepareResult, d as PrepareStatus, S as SecureStorePort } from '../runtime-B8s-_hv8.cjs';
+export { T as TelemetryPort } from '../TelemetryPort-BDNr00hu.cjs';
+export { E as ErrorPolicyPort } from '../ErrorPolicyPort-CNf4uQZP.cjs';
+export { C as CameraPort, a as CaptureOptions, M as MediaSource } from '../CameraPort-Cv31Pz7g.cjs';
+export { A as AcceptedFrame, a as AnalysisCompleteFrame, b as AnalysisStartedFrame, D as DeltaFrame, c as DoneFrame, E as ErrorFrame, d as EverfurRequest, e as EverfurRequestBase, F as Frame, f as FrameBase, g as FrameKind, H as HeartbeatFrame, h as HttpMethod, M as MultipartBody, T as TransportPort, U as UnknownFrame, i as UrgencyLevel } from '../config-CzTZGlfF.cjs';
+import { c as EverfurThemeInput, E as EverfurFontWeight, a as EverfurTheme, b as EverfurFontFaceKey } from '../entitlementRepository-DKdXFgTo.cjs';
+export { d as EverfurColorTokens, e as EverfurFontFamilies, f as EverfurLetterSpacingTokens, g as EverfurLineHeightTokens, h as EverfurMotionDurationTokens, i as EverfurMotionTokens, j as EverfurRadiusTokens, k as EverfurSpaceTokens, l as EverfurSpringToken, m as EverfurTextColorTokens, n as EverfurThemeFontFaceKey, o as EverfurThemeFontUrlsInput, p as EverfurThemeFontsInput, q as EverfurThemeMeta, r as EverfurThemeSlot, s as EverfurThemeSlotInput, t as EverfurThemeSlotKey, u as EverfurThemeSlotName, v as EverfurThemeSlots, w as EverfurThemeSlotsInput, x as EverfurTypeSizeTokens, y as EverfurTypeTokens, z as EverfurWeightTokens, T as THEME_SLOT_KEYS, A as THEME_SLOT_NAMES, B as previewTheme } from '../entitlementRepository-DKdXFgTo.cjs';
+export { M as MintedToken, T as TokenProvider } from '../identity-DI4eVx9S.cjs';
+export { b as PetActivityLevel, c as PetAllergy, d as PetAllergySeverity, e as PetBirthDatePrecision, f as PetCondition, a as PetHealthProfile, P as PetHealthProfileInput, g as PetIndoorOutdoor, h as PetMedication, i as PetSex } from '../profile-CSs1wlXT.cjs';
+export { C as CanonicalPetSpecies, c as canonicalPetSpecies } from '../species-BXAIMh7I.cjs';
+export { E as EverfurFaceStyle, f as face } from '../typeStyle-0TydiZ1w.cjs';
+import '../requestFunnel-L-BQfi0z.cjs';
+
+/**
+ * Wrap the tree ONCE, high. Mounting constructs the runtime (transport, identity, registry,
+ * entitlement repository, pollers) exactly once and starts fail-closed: a bad manifest/entitlement
+ * fetch falls to the compiled default and children render immediately, never a blank page.
+ * A config that cannot be resolved yields a DISABLED runtime (children still render, every capability
+ * off at `sdk_config`), never a throw: see `createEverfurRuntime`.
+ */
+declare function EverfurProvider(props: EverfurProviderProps): ReactNode;
+
+interface CapabilityGateProps {
+    readonly capability: CapabilityName;
+    readonly children: ReactNode;
+    /** Override the default OffState. Receives the resolved decision (carries SAFE `disabled` copy). */
+    readonly renderDisabled?: (decision: CapabilityDecision) => ReactNode;
+    /** Override the default pending skeleton. */
+    readonly renderPending?: () => ReactNode;
+    /**
+     * Merged over the gate's own container style. `| undefined` is admitted so a surface can forward its own
+     * exact-optional prop straight through.
+     */
+    readonly style?: CSSProperties | undefined;
+    /** A class the host may hang its own layout rules on; the SDK sets no classes of its own. */
+    readonly className?: string | undefined;
+}
+declare function CapabilityGate(props: CapabilityGateProps): ReactNode;
+
+interface EverfurChatProps {
+    readonly petRef?: PetRef;
+    readonly conversationId?: ConversationId;
+    /** Merged over the surface's own container style (and the gate's off-state). */
+    readonly style?: CSSProperties;
+    /** A class the host may hang its own layout rules on; the SDK sets no classes of its own. */
+    readonly className?: string;
+    /**
+     * Your own placeholder for the two moments Everfur would otherwise draw a waiting view of its own: the
+     * entitlement verdict still pending, and the chat still bootstrapping on a cold mount. Return null to draw
+     * nothing. A mount `prepare()` warmed up never reaches either. Absent, Everfur's skeleton and delayed spinner.
+     */
+    readonly renderPending?: () => ReactNode;
+    /**
+     * Called after the owner picks another pet in the header's switcher (the provider's active pet has already
+     * been switched through `handle.setActivePet`), so your own screen can follow.
+     */
+    readonly onPetChange?: (petRef: PetRef) => void;
+    /**
+     * Where the empty state's "Help me prep for {pet}'s vet visit" chip goes. Absent, the chip appears only while
+     * Everfur's own vet visit entry for chat is switched on for this user, and then opens that visit; without
+     * either, the chip is not shown (it is never sent as text).
+     */
+    readonly onVetPrep?: (petRef: PetRef | null) => void;
+    /**
+     * The "Find a vet" action of an urgency banner when Everfur's own vet visit entry is not available to this
+     * user: called with the tier. Absent, the banner shows no action in that case.
+     */
+    readonly onFindVet?: (level: UrgencyDisplayLevel) => void;
+    /** Your own node in the banner's action slot (wins over both the vet visit entry and `onFindVet`). */
+    readonly renderVetAction?: (level: UrgencyDisplayLevel) => ReactNode;
+    /**
+     * Image attachments on the composer. On by default (the browser is the picker and the uploader); `false`
+     * removes the control; `maxPerMessage` caps the slots per message (at most 5, the server's cap).
+     */
+    readonly attachments?: false | {
+        readonly maxPerMessage?: number;
+    };
+    /**
+     * Voice dictation on the composer (the browser's own speech engine, no Everfur service). On by default; the
+     * control appears only in a browser that has an engine. `false` is the kill switch.
+     */
+    readonly dictation?: boolean;
+    /**
+     * The pet this chat is about, as YOUR system holds it: the whole partner pet body (name, species, breed,
+     * age, weight, and every health field, allergies, medications, supplements and conditions included). Given
+     * with `petRef`, the surface registers it with Everfur once, before the first conversation, and then names
+     * it in the header and the switcher. Nothing is trimmed: what you pass is what is sent.
+     */
+    readonly pet?: PetProfileInput;
+    /**
+     * Your own add-a-pet screen. Given, the switcher gets an `Add another pet` row, and a chat that cannot start
+     * because the `petRef` is not registered offers `Add a pet` in place of a retry that could only fail again.
+     * Absent, neither control is drawn: the partner plane never shows a route Everfur cannot honour.
+     */
+    readonly onAddPet?: () => void;
+    /**
+     * The check-in a tapped Everfur push is about: the `case` target `parseEverfurNotification` returned. Chat
+     * opens that thread on mount, once per target, so a due follow-up question is the first thing the member
+     * sees instead of something they would have to find in the history drawer. Absent, chat opens as usual.
+     */
+    readonly checkinTarget?: ChatCheckinTarget;
+    /**
+     * A question to ask on arrival, in a conversation of its own: the prompt one of your own screens built
+     * (an Everfur records "Ask Everfur" pill hands you one). It is asked once, after chat has finished
+     * opening, and the thread that was on screen is left behind so the answer is not buried in an unrelated
+     * conversation. Pass `composerSeed` instead when the user should decide whether to send it.
+     */
+    readonly initialAsk?: string;
+    /**
+     * Text to put in the composer on arrival. It is never sent for the user: they edit it, send it or clear
+     * it. Only an empty composer is seeded, so nothing they typed is ever replaced.
+     */
+    readonly composerSeed?: string;
+    /**
+     * Your app's lifecycle signals. Everfur has no socket and no polling here, so a message the platform
+     * writes into the thread (a follow-up check-in, a reminder) is not visible until something re-reads it.
+     * Tell Everfur when your page becomes visible again, when connectivity returns and when a push announced a
+     * change, and the thread and the unread dot catch up on that signal alone. Without this, chat refreshes
+     * only when the user does something.
+     */
+    readonly lifecycle?: LifecyclePort;
+    /**
+     * Your own storage for an unsent draft. Given, what the user typed and did not send survives leaving this
+     * screen; absent, the draft lives in memory for as long as the surface is mounted and nowhere else.
+     * Everfur writes a draft down only through this.
+     */
+    readonly draftStore?: EverfurChatDraftStore;
+    /**
+     * The KEY of a return destination your tenant registered with Everfur. Every vet entry inside chat (the
+     * header, the urgency banner's pill and the empty thread's vet-prep chip) then sends the user back to your
+     * app when the visit ends.
+     */
+    readonly vetReturnTo?: string;
+    /**
+     * The user's US state (for example `'CA'`). Set it and no vet entry is drawn until Everfur confirms a visit
+     * is available there, so it is never offered to someone who could not book.
+     */
+    readonly vetUsState?: string;
+}
+/**
+ * Entitlement-gated, four-state chat surface. Entitlement-OFF renders the CapabilityGate OffState; otherwise
+ * the body maps the controller snapshot to exactly one deliberate state. The surface fills the box it is
+ * given (`height: 100%`): give its parent a height and the transcript scrolls inside it.
+ */
+declare function EverfurChat(props: EverfurChatProps): ReactNode;
+
+interface WebAttachmentTransportOptions {
+    /** Test seam: the `fetch` to use. Defaults to the global one. A host has no reason to set it. */
+    readonly fetch?: typeof fetch;
+}
+/**
+ * The browser chat attachment transport. The prebuilt web `EverfurChat` binds it on its own (the browser is
+ * the picker and the uploader; a host wires nothing). A handle with no `blob` rejects before any request.
+ */
+declare function createWebAttachmentTransport(options?: WebAttachmentTransportOptions): UploadTransport;
+/**
+ * The chat `FileHandle` for a picked browser `File`: the bytes, the real size, the browser's type (the queue
+ * validates it against the accepted image types) and the local name, with a `blob:` preview URL as the `uri`.
+ * The caller owns the URL: `URL.revokeObjectURL(handle.uri)` when the preview is no longer shown.
+ */
+declare function fileToAttachmentHandle(file: File): FileHandle;
+
+interface EverfurThemeProviderProps {
+    /**
+     * The clamped client `theme` prop, a first-paint/offline fallback merged UNDER the server branding. Any
+     * shape is tolerated (parsed defensively); unknown keys are ignored. Omit for the compiled default.
+     */
+    readonly clientTheme?: EverfurThemeInput | null;
+    readonly children: ReactNode;
+}
+/** Compute + publish the resolved theme for a browser host. See `EverfurThemeProviderCore`. */
+declare function EverfurThemeProvider(props: EverfurThemeProviderProps): ReactNode;
+
+/** The CSS pair one face of the theme renders with. */
+interface EverfurFaceCss {
+    readonly fontFamily: string;
+    readonly fontWeight: EverfurFontWeight;
+}
+/**
+ * The CSS `font-family` and `font-weight` of one face: the face's family (a text face ahead of the system
+ * stack, a mono face ahead of the mono stack) and the weight to request.
+ *   - A base family (the platform font, `font_family`, or a `fonts` name repeated across weights) carries every
+ *     weight itself, so the face's own weight token is requested (`monoBold` asks for 700 of the mono family).
+ *   - A NAMED face (one per-weight name, the React Native convention: `Azeret-Bold`) has its weight baked in, so
+ *     no weight of its own is added: it is requested at the normal weight, which is the weight the SDK loads it
+ *     at (`loadBrandFont`) and the weight a host's plain `@font-face` declares. The browser matches it exactly
+ *     and never synthesizes a second bold over a face that is already bold.
+ * The same `fonts` map therefore renders the same weights here and on React Native (`face()`).
+ */
+declare function faceCss(theme: EverfurTheme, weight: EverfurFontFaceKey): EverfurFaceCss;
+
+/**
+ * A KvPort over `localStorage`, namespaced. Every method resolves; none rejects. Absent storage reads as
+ * empty and writes as no-ops, which the runtime already handles as its in-memory posture.
+ */
+declare function createLocalStorageKv(): KvPort;
+
+export { CapabilityDecision, CapabilityGate, type CapabilityGateProps, CapabilityName, ChatCheckinTarget, ConversationId, EverfurChat, EverfurChatDraftStore, type EverfurChatProps, type EverfurFaceCss, EverfurFontFaceKey, EverfurFontWeight, EverfurProvider, EverfurProviderProps, EverfurTheme, EverfurThemeInput, EverfurThemeProvider, type EverfurThemeProviderProps, FileHandle, KvPort, LifecyclePort, PetProfileInput, PetRef, UploadTransport, UrgencyDisplayLevel, type WebAttachmentTransportOptions, createLocalStorageKv, createWebAttachmentTransport, faceCss, fileToAttachmentHandle };

package/dist/web/index.d.ts

@@ -0,0 +1,217 @@
+import { ReactNode, CSSProperties } from 'react';
+import { E as EverfurProviderProps } from '../context-DXhqHlPU.js';
+export { a as EverfurConfig, b as EverfurHandle, c as EverfurUser, U as UseEverfurPetProfileState, u as useCapability, d as useEverfur, e as useEverfurPetProfile, f as useEverfurTheme } from '../context-DXhqHlPU.js';
+import { C as CapabilityName, a as CapabilityDecision } from '../resolve-D4Ywz5OS.js';
+export { b as CapabilityDisabled, D as DisabledLevel } from '../resolve-D4Ywz5OS.js';
+import { U as UrgencyDisplayLevel, L as LifecyclePort, E as EverfurChatDraftStore } from '../attachments-5NeobOCd.js';
+export { C as ChatFeedbackReason, a as ChatFeedbackReasonOption, b as ChatSentiment, c as UseChatAttachmentsOptions, d as UseChatAttachmentsState, e as UseEverfurChatState, f as UseEverfurPetsState, u as useChatAttachments, g as useEverfurChat, h as useEverfurPets } from '../attachments-5NeobOCd.js';
+import { P as PetRef, C as ConversationId } from '../ids-B2GAAifq.js';
+export { B as Brand, a as ClientId, b as ResponseId, U as UserRef, _ as __brand, c as conversationId, p as petRef, u as userRef } from '../ids-B2GAAifq.js';
+import { a as ChatCheckinTarget } from '../ports-DMolTRzU.js';
+export { C as ChatCheckin, b as ChatConversation, c as ChatConversationListOptions, d as ChatConversationPage, e as ChatFeedbackReceipt, f as ChatFeedbackType, g as ChatHistoryOptions, i as ChatMessage, h as ChatMessagePage, j as ChatStatus, k as Citation, P as PresignedPolicy, S as SendOptions, U as UploadPort } from '../ports-DMolTRzU.js';
+import { P as PetProfileInput } from '../casesRepository-ClLv6qMl.js';
+export { C as CheckinAnswer, a as CheckinOutcome, c as PetProfilePatch, R as RegisteredPet, W as WatchCase, b as WidgetPet, d as WidgetPetProfile } from '../casesRepository-ClLv6qMl.js';
+export { d as EverfurConfigError, E as EverfurError, a as EverfurErrorCategory, b as EverfurErrorCode, c as EverfurResult, e as EverfurThrownError, f as categoryFor, i as isErr, g as isOk, h as isRetryableCode, u as unwrap, j as userFacingError } from '../EverfurResult-DN9pL2Ab.js';
+export { A as AttachmentError, a as AttachmentErrorCode, b as AttachmentOutcome, c as AttachmentQueue, d as AttachmentState, e as AttachmentStatus } from '../attachments-Bw3iMQgu.js';
+import { U as UploadTransport, F as FileHandle } from '../ports-BN6RHF9W.js';
+export { b as FilePort, a as UploadPolicyWire } from '../ports-BN6RHF9W.js';
+import { K as KvPort } from '../cacheEpoch-DknKn3S0.js';
+export { I as ImageCachePort } from '../cacheEpoch-DknKn3S0.js';
+export { L as LogLevel, a as LogRecord, b as LogSink, P as PrepareOptions, c as PrepareResult, d as PrepareStatus, S as SecureStorePort } from '../runtime-BR9ysG0J.js';
+export { T as TelemetryPort } from '../TelemetryPort-BDNr00hu.js';
+export { E as ErrorPolicyPort } from '../ErrorPolicyPort-CwbfmxzJ.js';
+export { C as CameraPort, a as CaptureOptions, M as MediaSource } from '../CameraPort-Cv31Pz7g.js';
+export { A as AcceptedFrame, a as AnalysisCompleteFrame, b as AnalysisStartedFrame, D as DeltaFrame, c as DoneFrame, E as ErrorFrame, d as EverfurRequest, e as EverfurRequestBase, F as Frame, f as FrameBase, g as FrameKind, H as HeartbeatFrame, h as HttpMethod, M as MultipartBody, T as TransportPort, U as UnknownFrame, i as UrgencyLevel } from '../config-DW60uRb9.js';
+import { c as EverfurThemeInput, E as EverfurFontWeight, a as EverfurTheme, b as EverfurFontFaceKey } from '../entitlementRepository-DSbzuyAW.js';
+export { d as EverfurColorTokens, e as EverfurFontFamilies, f as EverfurLetterSpacingTokens, g as EverfurLineHeightTokens, h as EverfurMotionDurationTokens, i as EverfurMotionTokens, j as EverfurRadiusTokens, k as EverfurSpaceTokens, l as EverfurSpringToken, m as EverfurTextColorTokens, n as EverfurThemeFontFaceKey, o as EverfurThemeFontUrlsInput, p as EverfurThemeFontsInput, q as EverfurThemeMeta, r as EverfurThemeSlot, s as EverfurThemeSlotInput, t as EverfurThemeSlotKey, u as EverfurThemeSlotName, v as EverfurThemeSlots, w as EverfurThemeSlotsInput, x as EverfurTypeSizeTokens, y as EverfurTypeTokens, z as EverfurWeightTokens, T as THEME_SLOT_KEYS, A as THEME_SLOT_NAMES, B as previewTheme } from '../entitlementRepository-DSbzuyAW.js';
+export { M as MintedToken, T as TokenProvider } from '../identity-BMx2SUOM.js';
+export { b as PetActivityLevel, c as PetAllergy, d as PetAllergySeverity, e as PetBirthDatePrecision, f as PetCondition, a as PetHealthProfile, P as PetHealthProfileInput, g as PetIndoorOutdoor, h as PetMedication, i as PetSex } from '../profile-CSs1wlXT.js';
+export { C as CanonicalPetSpecies, c as canonicalPetSpecies } from '../species-BXAIMh7I.js';
+export { E as EverfurFaceStyle, f as face } from '../typeStyle-CWMsoe6b.js';
+import '../requestFunnel-CjW7uDuA.js';
+
+/**
+ * Wrap the tree ONCE, high. Mounting constructs the runtime (transport, identity, registry,
+ * entitlement repository, pollers) exactly once and starts fail-closed: a bad manifest/entitlement
+ * fetch falls to the compiled default and children render immediately, never a blank page.
+ * A config that cannot be resolved yields a DISABLED runtime (children still render, every capability
+ * off at `sdk_config`), never a throw: see `createEverfurRuntime`.
+ */
+declare function EverfurProvider(props: EverfurProviderProps): ReactNode;
+
+interface CapabilityGateProps {
+    readonly capability: CapabilityName;
+    readonly children: ReactNode;
+    /** Override the default OffState. Receives the resolved decision (carries SAFE `disabled` copy). */
+    readonly renderDisabled?: (decision: CapabilityDecision) => ReactNode;
+    /** Override the default pending skeleton. */
+    readonly renderPending?: () => ReactNode;
+    /**
+     * Merged over the gate's own container style. `| undefined` is admitted so a surface can forward its own
+     * exact-optional prop straight through.
+     */
+    readonly style?: CSSProperties | undefined;
+    /** A class the host may hang its own layout rules on; the SDK sets no classes of its own. */
+    readonly className?: string | undefined;
+}
+declare function CapabilityGate(props: CapabilityGateProps): ReactNode;
+
+interface EverfurChatProps {
+    readonly petRef?: PetRef;
+    readonly conversationId?: ConversationId;
+    /** Merged over the surface's own container style (and the gate's off-state). */
+    readonly style?: CSSProperties;
+    /** A class the host may hang its own layout rules on; the SDK sets no classes of its own. */
+    readonly className?: string;
+    /**
+     * Your own placeholder for the two moments Everfur would otherwise draw a waiting view of its own: the
+     * entitlement verdict still pending, and the chat still bootstrapping on a cold mount. Return null to draw
+     * nothing. A mount `prepare()` warmed up never reaches either. Absent, Everfur's skeleton and delayed spinner.
+     */
+    readonly renderPending?: () => ReactNode;
+    /**
+     * Called after the owner picks another pet in the header's switcher (the provider's active pet has already
+     * been switched through `handle.setActivePet`), so your own screen can follow.
+     */
+    readonly onPetChange?: (petRef: PetRef) => void;
+    /**
+     * Where the empty state's "Help me prep for {pet}'s vet visit" chip goes. Absent, the chip appears only while
+     * Everfur's own vet visit entry for chat is switched on for this user, and then opens that visit; without
+     * either, the chip is not shown (it is never sent as text).
+     */
+    readonly onVetPrep?: (petRef: PetRef | null) => void;
+    /**
+     * The "Find a vet" action of an urgency banner when Everfur's own vet visit entry is not available to this
+     * user: called with the tier. Absent, the banner shows no action in that case.
+     */
+    readonly onFindVet?: (level: UrgencyDisplayLevel) => void;
+    /** Your own node in the banner's action slot (wins over both the vet visit entry and `onFindVet`). */
+    readonly renderVetAction?: (level: UrgencyDisplayLevel) => ReactNode;
+    /**
+     * Image attachments on the composer. On by default (the browser is the picker and the uploader); `false`
+     * removes the control; `maxPerMessage` caps the slots per message (at most 5, the server's cap).
+     */
+    readonly attachments?: false | {
+        readonly maxPerMessage?: number;
+    };
+    /**
+     * Voice dictation on the composer (the browser's own speech engine, no Everfur service). On by default; the
+     * control appears only in a browser that has an engine. `false` is the kill switch.
+     */
+    readonly dictation?: boolean;
+    /**
+     * The pet this chat is about, as YOUR system holds it: the whole partner pet body (name, species, breed,
+     * age, weight, and every health field, allergies, medications, supplements and conditions included). Given
+     * with `petRef`, the surface registers it with Everfur once, before the first conversation, and then names
+     * it in the header and the switcher. Nothing is trimmed: what you pass is what is sent.
+     */
+    readonly pet?: PetProfileInput;
+    /**
+     * Your own add-a-pet screen. Given, the switcher gets an `Add another pet` row, and a chat that cannot start
+     * because the `petRef` is not registered offers `Add a pet` in place of a retry that could only fail again.
+     * Absent, neither control is drawn: the partner plane never shows a route Everfur cannot honour.
+     */
+    readonly onAddPet?: () => void;
+    /**
+     * The check-in a tapped Everfur push is about: the `case` target `parseEverfurNotification` returned. Chat
+     * opens that thread on mount, once per target, so a due follow-up question is the first thing the member
+     * sees instead of something they would have to find in the history drawer. Absent, chat opens as usual.
+     */
+    readonly checkinTarget?: ChatCheckinTarget;
+    /**
+     * A question to ask on arrival, in a conversation of its own: the prompt one of your own screens built
+     * (an Everfur records "Ask Everfur" pill hands you one). It is asked once, after chat has finished
+     * opening, and the thread that was on screen is left behind so the answer is not buried in an unrelated
+     * conversation. Pass `composerSeed` instead when the user should decide whether to send it.
+     */
+    readonly initialAsk?: string;
+    /**
+     * Text to put in the composer on arrival. It is never sent for the user: they edit it, send it or clear
+     * it. Only an empty composer is seeded, so nothing they typed is ever replaced.
+     */
+    readonly composerSeed?: string;
+    /**
+     * Your app's lifecycle signals. Everfur has no socket and no polling here, so a message the platform
+     * writes into the thread (a follow-up check-in, a reminder) is not visible until something re-reads it.
+     * Tell Everfur when your page becomes visible again, when connectivity returns and when a push announced a
+     * change, and the thread and the unread dot catch up on that signal alone. Without this, chat refreshes
+     * only when the user does something.
+     */
+    readonly lifecycle?: LifecyclePort;
+    /**
+     * Your own storage for an unsent draft. Given, what the user typed and did not send survives leaving this
+     * screen; absent, the draft lives in memory for as long as the surface is mounted and nowhere else.
+     * Everfur writes a draft down only through this.
+     */
+    readonly draftStore?: EverfurChatDraftStore;
+    /**
+     * The KEY of a return destination your tenant registered with Everfur. Every vet entry inside chat (the
+     * header, the urgency banner's pill and the empty thread's vet-prep chip) then sends the user back to your
+     * app when the visit ends.
+     */
+    readonly vetReturnTo?: string;
+    /**
+     * The user's US state (for example `'CA'`). Set it and no vet entry is drawn until Everfur confirms a visit
+     * is available there, so it is never offered to someone who could not book.
+     */
+    readonly vetUsState?: string;
+}
+/**
+ * Entitlement-gated, four-state chat surface. Entitlement-OFF renders the CapabilityGate OffState; otherwise
+ * the body maps the controller snapshot to exactly one deliberate state. The surface fills the box it is
+ * given (`height: 100%`): give its parent a height and the transcript scrolls inside it.
+ */
+declare function EverfurChat(props: EverfurChatProps): ReactNode;
+
+interface WebAttachmentTransportOptions {
+    /** Test seam: the `fetch` to use. Defaults to the global one. A host has no reason to set it. */
+    readonly fetch?: typeof fetch;
+}
+/**
+ * The browser chat attachment transport. The prebuilt web `EverfurChat` binds it on its own (the browser is
+ * the picker and the uploader; a host wires nothing). A handle with no `blob` rejects before any request.
+ */
+declare function createWebAttachmentTransport(options?: WebAttachmentTransportOptions): UploadTransport;
+/**
+ * The chat `FileHandle` for a picked browser `File`: the bytes, the real size, the browser's type (the queue
+ * validates it against the accepted image types) and the local name, with a `blob:` preview URL as the `uri`.
+ * The caller owns the URL: `URL.revokeObjectURL(handle.uri)` when the preview is no longer shown.
+ */
+declare function fileToAttachmentHandle(file: File): FileHandle;
+
+interface EverfurThemeProviderProps {
+    /**
+     * The clamped client `theme` prop, a first-paint/offline fallback merged UNDER the server branding. Any
+     * shape is tolerated (parsed defensively); unknown keys are ignored. Omit for the compiled default.
+     */
+    readonly clientTheme?: EverfurThemeInput | null;
+    readonly children: ReactNode;
+}
+/** Compute + publish the resolved theme for a browser host. See `EverfurThemeProviderCore`. */
+declare function EverfurThemeProvider(props: EverfurThemeProviderProps): ReactNode;
+
+/** The CSS pair one face of the theme renders with. */
+interface EverfurFaceCss {
+    readonly fontFamily: string;
+    readonly fontWeight: EverfurFontWeight;
+}
+/**
+ * The CSS `font-family` and `font-weight` of one face: the face's family (a text face ahead of the system
+ * stack, a mono face ahead of the mono stack) and the weight to request.
+ *   - A base family (the platform font, `font_family`, or a `fonts` name repeated across weights) carries every
+ *     weight itself, so the face's own weight token is requested (`monoBold` asks for 700 of the mono family).
+ *   - A NAMED face (one per-weight name, the React Native convention: `Azeret-Bold`) has its weight baked in, so
+ *     no weight of its own is added: it is requested at the normal weight, which is the weight the SDK loads it
+ *     at (`loadBrandFont`) and the weight a host's plain `@font-face` declares. The browser matches it exactly
+ *     and never synthesizes a second bold over a face that is already bold.
+ * The same `fonts` map therefore renders the same weights here and on React Native (`face()`).
+ */
+declare function faceCss(theme: EverfurTheme, weight: EverfurFontFaceKey): EverfurFaceCss;
+
+/**
+ * A KvPort over `localStorage`, namespaced. Every method resolves; none rejects. Absent storage reads as
+ * empty and writes as no-ops, which the runtime already handles as its in-memory posture.
+ */
+declare function createLocalStorageKv(): KvPort;
+
+export { CapabilityDecision, CapabilityGate, type CapabilityGateProps, CapabilityName, ChatCheckinTarget, ConversationId, EverfurChat, EverfurChatDraftStore, type EverfurChatProps, type EverfurFaceCss, EverfurFontFaceKey, EverfurFontWeight, EverfurProvider, EverfurProviderProps, EverfurTheme, EverfurThemeInput, EverfurThemeProvider, type EverfurThemeProviderProps, FileHandle, KvPort, LifecyclePort, PetProfileInput, PetRef, UploadTransport, UrgencyDisplayLevel, type WebAttachmentTransportOptions, createLocalStorageKv, createWebAttachmentTransport, faceCss, fileToAttachmentHandle };