@everfur/sdk 0.3.0 → 0.5.0

package/dist/web/index.d.cts

@@ -1,34 +1,38 @@
 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 { E as EverfurProviderProps } from '../context-B-dUM1Qf.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-B-dUM1Qf.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 { U as UrgencyDisplayLevel, L as LifecyclePort, E as EverfurChatDraftStore } from '../attachments-DHvnITuE.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-DHvnITuE.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 { a as ChatCheckinTarget } from '../ports-C2EVK416.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-C2EVK416.cjs';
+import { P as PetProfileInput } from '../petsRepository-DZZoEG3r.cjs';
+export { a as PetProfilePatch, R as RegisteredPet, W as WidgetPet, b as WidgetPetProfile } from '../petsRepository-DZZoEG3r.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-DAFbf721.cjs';
+export { C as CheckinAnswer, a as CheckinOutcome, W as WatchCase } from '../casesRepository-B-Eg8ZJ3.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-pIdGOQfm.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 { L as LogLevel, a as LogRecord, b as LogSink, P as PrepareOptions, c as PrepareResult, d as PrepareStatus, S as SecureStorePort } from '../runtimeTypes-D2C9uD85.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 { 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 { 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-C7uxGwfT.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';
-export { E as EverfurFaceStyle, f as face } from '../typeStyle-0TydiZ1w.cjs';
-import '../requestFunnel-L-BQfi0z.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-Djjwgoe9.cjs';
 
 /**
  * Wrap the tree ONCE, high. Mounting constructs the runtime (transport, identity, registry,
@@ -155,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
@@ -175,7 +199,7 @@ declare function createWebAttachmentTransport(options?: WebAttachmentTransportOp
 /**
  * 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.
+ * The caller owns the URL: `revokeObjectUrl(handle.uri)` when the preview is no longer shown.
  */
 declare function fileToAttachmentHandle(file: File): FileHandle;
 

package/dist/web/index.d.ts

@@ -1,34 +1,38 @@
 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 { E as EverfurProviderProps } from '../context-CZbgF_OH.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-CZbgF_OH.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 { U as UrgencyDisplayLevel, L as LifecyclePort, E as EverfurChatDraftStore } from '../attachments-C_vtFu2f.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-C_vtFu2f.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 { a as ChatCheckinTarget } from '../ports-BO3bzTJg.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-BO3bzTJg.js';
+import { P as PetProfileInput } from '../petsRepository-BjKJ8UsN.js';
+export { a as PetProfilePatch, R as RegisteredPet, W as WidgetPet, b as WidgetPetProfile } from '../petsRepository-BjKJ8UsN.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-ClI7QxB0.js';
+export { C as CheckinAnswer, a as CheckinOutcome, W as WatchCase } from '../casesRepository-DHgIYKN9.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-oD5U2fXI.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 { L as LogLevel, a as LogRecord, b as LogSink, P as PrepareOptions, c as PrepareResult, d as PrepareStatus, S as SecureStorePort } from '../runtimeTypes-CTL3yToK.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 { 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 { 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-CLAUq-K4.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';
-export { E as EverfurFaceStyle, f as face } from '../typeStyle-CWMsoe6b.js';
-import '../requestFunnel-CjW7uDuA.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-D7ipek3e.js';
 
 /**
  * Wrap the tree ONCE, high. Mounting constructs the runtime (transport, identity, registry,
@@ -155,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
@@ -175,7 +199,7 @@ declare function createWebAttachmentTransport(options?: WebAttachmentTransportOp
 /**
  * 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.
+ * The caller owns the URL: `revokeObjectUrl(handle.uri)` when the preview is no longer shown.
  */
 declare function fileToAttachmentHandle(file: File): FileHandle;