@everfur/sdk 0.4.0 → 0.5.1

package/dist/web/index.d.cts

@@ -1,35 +1,38 @@
 import { ReactNode, CSSProperties } from 'react';
-import { E as EverfurProviderProps } from '../context-CL3lyuy1.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-CL3lyuy1.cjs';
+import { E as EverfurProviderProps } from '../context-CkqPM4Ml.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-CkqPM4Ml.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-D_SECjr1.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-D_SECjr1.cjs';
+import { U as UrgencyDisplayLevel, L as LifecyclePort, E as EverfurChatDraftStore } from '../attachments-CwsR-bPN.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-CwsR-bPN.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-BY2ph0_y.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-BY2ph0_y.cjs';
-import { P as PetProfileInput } from '../petsRepository-B_gKbAzJ.cjs';
-export { a as PetProfilePatch, R as RegisteredPet, W as WidgetPet, b as WidgetPetProfile } from '../petsRepository-B_gKbAzJ.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--Wu1Umhd.cjs';
-export { C as CheckinAnswer, a as CheckinOutcome, W as WatchCase } from '../casesRepository-DwtZVsbj.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-BorG422I.cjs';
+import { a as ChatCheckinTarget } from '../ports-DNXyyzZF.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-DNXyyzZF.cjs';
+import { P as PetProfileInput } from '../petsRepository-D1bnxDZg.cjs';
+export { a as PetProfilePatch, R as RegisteredPet, W as WidgetPet, b as WidgetPetProfile } from '../petsRepository-D1bnxDZg.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-6qS7Sohy.cjs';
+export { C as CheckinAnswer, a as CheckinOutcome, W as WatchCase } from '../casesRepository-aryld7fJ.cjs';
+export { E as EverfurError, a as EverfurErrorCategory, b as EverfurErrorCode, c as categoryFor, i as isRetryableCode, u as userFacingError } from '../EverfurError-DmELDpXp.cjs';
+export { A as AttachmentError, a as AttachmentErrorCode, b as AttachmentOutcome, c as AttachmentQueue, d as AttachmentState, e as AttachmentStatus } from '../attachments-Nk73Lll8.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 '../runtimeTypes-gZEJu-da.cjs';
+export { L as LogLevel, a as LogRecord, b as LogSink, P as PrepareOptions, c as PrepareResult, d as PrepareStatus, S as SecureStorePort } from '../runtimeTypes-RN-VXTFV.cjs';
 export { T as TelemetryPort } from '../TelemetryPort-BDNr00hu.cjs';
-export { E as ErrorPolicyPort } from '../ErrorPolicyPort-CNf4uQZP.cjs';
+export { E as ErrorPolicyPort } from '../ErrorPolicyPort-D6CybiqJ.cjs';
 export { C as CameraPort, a as CaptureOptions, M as MediaSource } from '../CameraPort-Cv31Pz7g.cjs';
-export { M as MintedToken, T as TokenProvider } from '../identity-C2-08BZW.cjs';
-export { E as EverfurFaceStyle, f as face, p as previewTheme } from '../typeStyle-CKqVYD6L.cjs';
-import { E as EverfurThemeInput, b as EverfurFontWeight, a as EverfurTheme, c as EverfurFontFaceKey } from '../branding-CsRdeNwK.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 } from '../branding-CsRdeNwK.cjs';
+export { a as EverfurConfigError, E as EverfurResult, b as EverfurThrownError, i as isErr, c as isOk, u as unwrap } from '../EverfurResult-ZtH-YV1h.cjs';
+export { M as MintedToken, T as TokenProvider } from '../identity-DjqhDm5Z.cjs';
+export { E as EverfurFaceStyle, f as face, p as previewTheme } from '../typeStyle-DHJzDaUo.cjs';
+import { E as EverfurThemeInput } from '../branding-Xb_wL8N1.cjs';
+export { a as EverfurThemeFontFaceKey, b as EverfurThemeFontUrlsInput, c as EverfurThemeFontsInput, d as EverfurThemeSlotInput, e as EverfurThemeSlotsInput } from '../branding-Xb_wL8N1.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';
-import '../requestFunnel-BjDpqqvm.cjs';
+import { a as EverfurFontWeight, E as EverfurTheme, b as EverfurFontFaceKey } from '../tokens-CIngRkvt.cjs';
+export { e as EverfurColorTokens, f as EverfurFontFamilies, g as EverfurLetterSpacingTokens, h as EverfurLineHeightTokens, i as EverfurMotionDurationTokens, j as EverfurMotionTokens, k as EverfurRadiusTokens, l as EverfurSpaceTokens, m as EverfurSpringToken, n as EverfurTextColorTokens, o as EverfurThemeMeta, p as EverfurThemeSlot, q as EverfurThemeSlotKey, c as EverfurThemeSlotName, d as EverfurThemeSlots, r as EverfurTypeSizeTokens, s as EverfurTypeTokens, t as EverfurWeightTokens, T as THEME_SLOT_KEYS, u as THEME_SLOT_NAMES } from '../tokens-CIngRkvt.cjs';
+import '../requestFunnel-Bqc1inM9.cjs';
 
 /**
  * Wrap the tree ONCE, high. Mounting constructs the runtime (transport, identity, registry,
@@ -156,6 +159,26 @@ interface EverfurChatProps {
      * is available there, so it is never offered to someone who could not book.
      */
     readonly vetUsState?: string;
+    /**
+     * Where every vet entry inside chat takes the member. Defaults to `'in-app'`: your registered presenter
+     * (`registerEverfurTelevetFlow`), else the in-page visit Everfur provides, which this surface mounts itself.
+     * `'redirect'` is the explicit opt-in to the hosted Everfur visit in a new tab.
+     */
+    readonly vetPrefer?: 'in-app' | 'redirect';
+    /**
+     * Your opener for a web page chat links to: today, the source page behind a card in an answer's sources
+     * deck (`kind` `'citation'`, always an https URL). Absent (the default), a source card is read-only: its
+     * title, meta line and excerpt show, and nothing takes the member off your page. Given, the card is a real
+     * link and a click calls this instead of navigating, so you can show the page in your own viewer; pass
+     * `(url) => { window.open(url, '_blank', 'noopener'); }` for the Everfur web app's new tab. Inside the CDN
+     * frame, which cannot carry a function, a source card is always read-only.
+     */
+    readonly onOpenUrl?: (url: string, kind: 'citation') => void | Promise<void>;
+    /**
+     * The heading level of the surface's own title (the empty thread's `What can we help {pet} with today?`),
+     * 1 to 6. Default 2: a drop-in widget does not claim your page's `<h1>`. Pass 1 when chat IS the page.
+     */
+    readonly headingLevel?: number;
 }
 /**
  * Entitlement-gated, four-state chat surface. Entitlement-OFF renders the CapabilityGate OffState; otherwise

package/dist/web/index.d.ts

@@ -1,35 +1,38 @@
 import { ReactNode, CSSProperties } from 'react';
-import { E as EverfurProviderProps } from '../context-CahAEha8.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-CahAEha8.js';
+import { E as EverfurProviderProps } from '../context-7f3Nb_xE.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-7f3Nb_xE.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-BrUWQYNK.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-BrUWQYNK.js';
+import { U as UrgencyDisplayLevel, L as LifecyclePort, E as EverfurChatDraftStore } from '../attachments-CzZ7in24.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-CzZ7in24.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-D7YW8qz9.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-D7YW8qz9.js';
-import { P as PetProfileInput } from '../petsRepository-Bk6GDwLs.js';
-export { a as PetProfilePatch, R as RegisteredPet, W as WidgetPet, b as WidgetPetProfile } from '../petsRepository-Bk6GDwLs.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-C7eb_IMD.js';
-export { C as CheckinAnswer, a as CheckinOutcome, W as WatchCase } from '../casesRepository-v6QczS9N.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-DpldrvIW.js';
+import { a as ChatCheckinTarget } from '../ports-C0m1G1fS.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-C0m1G1fS.js';
+import { P as PetProfileInput } from '../petsRepository-DhsX3GLw.js';
+export { a as PetProfilePatch, R as RegisteredPet, W as WidgetPet, b as WidgetPetProfile } from '../petsRepository-DhsX3GLw.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-X6BtwDwQ.js';
+export { C as CheckinAnswer, a as CheckinOutcome, W as WatchCase } from '../casesRepository-BTAecTnF.js';
+export { E as EverfurError, a as EverfurErrorCategory, b as EverfurErrorCode, c as categoryFor, i as isRetryableCode, u as userFacingError } from '../EverfurError-DmELDpXp.js';
+export { A as AttachmentError, a as AttachmentErrorCode, b as AttachmentOutcome, c as AttachmentQueue, d as AttachmentState, e as AttachmentStatus } from '../attachments-D3HCBmOE.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 '../runtimeTypes-w5KqBMcs.js';
+export { L as LogLevel, a as LogRecord, b as LogSink, P as PrepareOptions, c as PrepareResult, d as PrepareStatus, S as SecureStorePort } from '../runtimeTypes-C0yPBz89.js';
 export { T as TelemetryPort } from '../TelemetryPort-BDNr00hu.js';
-export { E as ErrorPolicyPort } from '../ErrorPolicyPort-CwbfmxzJ.js';
+export { E as ErrorPolicyPort } from '../ErrorPolicyPort-D22LUVrK.js';
 export { C as CameraPort, a as CaptureOptions, M as MediaSource } from '../CameraPort-Cv31Pz7g.js';
-export { M as MintedToken, T as TokenProvider } from '../identity-CEi9GRFZ.js';
-export { E as EverfurFaceStyle, f as face, p as previewTheme } from '../typeStyle-DmoyacDG.js';
-import { E as EverfurThemeInput, b as EverfurFontWeight, a as EverfurTheme, c as EverfurFontFaceKey } from '../branding-CsRdeNwK.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 } from '../branding-CsRdeNwK.js';
+export { a as EverfurConfigError, E as EverfurResult, b as EverfurThrownError, i as isErr, c as isOk, u as unwrap } from '../EverfurResult-SGvHKsCB.js';
+export { M as MintedToken, T as TokenProvider } from '../identity-Dy_L7Yq4.js';
+export { E as EverfurFaceStyle, f as face, p as previewTheme } from '../typeStyle-YPS_MXeI.js';
+import { E as EverfurThemeInput } from '../branding-xpQ056sM.js';
+export { a as EverfurThemeFontFaceKey, b as EverfurThemeFontUrlsInput, c as EverfurThemeFontsInput, d as EverfurThemeSlotInput, e as EverfurThemeSlotsInput } from '../branding-xpQ056sM.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';
-import '../requestFunnel-DFMGcluw.js';
+import { a as EverfurFontWeight, E as EverfurTheme, b as EverfurFontFaceKey } from '../tokens-CIngRkvt.js';
+export { e as EverfurColorTokens, f as EverfurFontFamilies, g as EverfurLetterSpacingTokens, h as EverfurLineHeightTokens, i as EverfurMotionDurationTokens, j as EverfurMotionTokens, k as EverfurRadiusTokens, l as EverfurSpaceTokens, m as EverfurSpringToken, n as EverfurTextColorTokens, o as EverfurThemeMeta, p as EverfurThemeSlot, q as EverfurThemeSlotKey, c as EverfurThemeSlotName, d as EverfurThemeSlots, r as EverfurTypeSizeTokens, s as EverfurTypeTokens, t as EverfurWeightTokens, T as THEME_SLOT_KEYS, u as THEME_SLOT_NAMES } from '../tokens-CIngRkvt.js';
+import '../requestFunnel-FvE5yLDD.js';
 
 /**
  * Wrap the tree ONCE, high. Mounting constructs the runtime (transport, identity, registry,
@@ -156,6 +159,26 @@ interface EverfurChatProps {
      * is available there, so it is never offered to someone who could not book.
      */
     readonly vetUsState?: string;
+    /**
+     * Where every vet entry inside chat takes the member. Defaults to `'in-app'`: your registered presenter
+     * (`registerEverfurTelevetFlow`), else the in-page visit Everfur provides, which this surface mounts itself.
+     * `'redirect'` is the explicit opt-in to the hosted Everfur visit in a new tab.
+     */
+    readonly vetPrefer?: 'in-app' | 'redirect';
+    /**
+     * Your opener for a web page chat links to: today, the source page behind a card in an answer's sources
+     * deck (`kind` `'citation'`, always an https URL). Absent (the default), a source card is read-only: its
+     * title, meta line and excerpt show, and nothing takes the member off your page. Given, the card is a real
+     * link and a click calls this instead of navigating, so you can show the page in your own viewer; pass
+     * `(url) => { window.open(url, '_blank', 'noopener'); }` for the Everfur web app's new tab. Inside the CDN
+     * frame, which cannot carry a function, a source card is always read-only.
+     */
+    readonly onOpenUrl?: (url: string, kind: 'citation') => void | Promise<void>;
+    /**
+     * The heading level of the surface's own title (the empty thread's `What can we help {pet} with today?`),
+     * 1 to 6. Default 2: a drop-in widget does not claim your page's `<h1>`. Pass 1 when chat IS the page.
+     */
+    readonly headingLevel?: number;
 }
 /**
  * Entitlement-gated, four-state chat surface. Entitlement-OFF renders the CapabilityGate OffState; otherwise