@v-tilt/browser 1.12.0 → 1.13.1

package/dist/module.d.ts

@@ -37,6 +37,25 @@ interface SendChatMessageOptions {
      * `markdown` and `html` use the same sanitized rendering as AI/agent messages.
      */
     format?: "text" | "markdown" | "html";
+    /**
+     * Marks the message as automatically injected by your site (form submit, CTA,
+     * etc.) rather than typed by the visitor in the widget. Stored on the message
+     * as `message_source` metadata so the AI can respond appropriately — e.g.
+     * `source: "landing_form"`. Slug-like: letters, numbers, `_`, `-`, max 64 chars.
+     */
+    source?: string;
+}
+/**
+ * Pixel inset of the chat bubble from the viewport edges.
+ * Use to clear host floating buttons, cookie banners, or mobile tab bars.
+ */
+interface BubbleOffset {
+    /** Distance from the bottom edge (default: 20) */
+    bottom?: number;
+    /** Distance from the right edge when `position` is `bottom-right` (default: 20) */
+    right?: number;
+    /** Distance from the left edge when `position` is `bottom-left` (default: 20) */
+    left?: number;
 }
 /**
  * Chat bubble appearance and behavior configuration
@@ -46,6 +65,12 @@ interface BubbleConfig {
     draggable?: boolean;
     /** Show the bubble on load (default: true). Set to false to control via vt.chat.show() */
     visible?: boolean;
+    /**
+     * Viewport inset in pixels. Prefer this over custom CSS so positioning
+     * survives widget UI updates. Pass `null` in `vt.updateConfig({ chat: { bubble: { offset: null } } })` to reset
+     * to SDK defaults (20px).
+     */
+    offset?: BubbleOffset | null;
 }
 
 /**
@@ -1664,7 +1689,7 @@ declare class VTilt {
      * Send a chat message. By default uses the active conversation; pass options to
      * start a new conversation, target a channel, or open the widget panel.
      */
-    sendChatMessage(content: SendChatMessageContent, options?: SendChatMessageOptions): void;
+    sendChatMessage(content: SendChatMessageContent, options?: SendChatMessageOptions): Promise<void>;
     /**
      * Raw `gtag(...)` passthrough. Queues calls made before the feature is
      * enabled or before `gtag.js` has loaded, flushed FIFO once ready. Safe
@@ -1710,6 +1735,11 @@ declare class VTilt {
     getDistinctId(): string;
     getAnonymousId(): string;
     toString(): string;
+    /**
+     * Merge a partial config patch into the live SDK config and notify all features.
+     * Use for any post-`init()` change (autocapture, `chat`, persistence, etc.).
+     * Top-level keys shallow-merge; nested `chat` deep-merges.
+     */
     updateConfig(config: Partial<VTiltConfig>): void;
     buildUrl(): string;
     buildEndpointUrl(path: string): string;
@@ -1733,7 +1763,22 @@ declare class VTilt {
     _dom_loaded(): void;
 }
 
+/**
+ * Method names registered on the inline `window.vt` stub before `array.js` loads.
+ *
+ * npm / ESM imports (`import { vt } from '@v-tilt/browser'`) do **not** use this
+ * list — `vt` is the real SDK instance. Only the HTML snippet's loader IIFE
+ * needs these names so calls queue in `window.vt._i` until the bundle loads.
+ *
+ * When adding a new public `vt.*` method that integrators may call before
+ * `init()` completes, append it here and update public install docs.
+ */
+declare const VTILT_SNIPPET_STUB_METHOD_NAMES: readonly ["init", "capture", "identify", "setUserProperties", "resetUser", "getUserIdentity", "getDeviceId", "getUserState", "alias", "getConfig", "getSessionId", "updateConfig", "setConsent", "on", "once", "off", "startAutocapture", "stopAutocapture", "startSessionRecording", "stopSessionRecording", "openChat", "closeChat", "toggleChat", "showChat", "hideChat", "sendChatMessage", "gtag", "setGoogleUserData"];
+/** Space-separated stub method string for the minified install snippet. */
+declare const VTILT_SNIPPET_STUB_METHODS: string;
+type VtiltSnippetStubMethodName = (typeof VTILT_SNIPPET_STUB_METHOD_NAMES)[number];
+
 declare const vt: VTilt;
 
-export { ALL_WEB_VITALS_METRICS, DEFAULT_WEB_VITALS_METRICS, VTilt, vt as default, vt };
-export type { AutocaptureOptions, CaptureOptions, CapturePerformanceConfig, CaptureResult, ChatWidgetConfig, EventPayload, FeatureFlagsConfig, GeolocationData, GoogleAdsConversionMapping, GoogleConsentOverride, GoogleConsentValue, GoogleTagClientConfig, GoogleTagEventMapping, GoogleTagParamMapping, GoogleTagProxyMode, GroupsConfig, IdentityUpdate, PersistenceMethod, Properties, Property, PropertyOperations, RemoteConfig, RequestOptions, SessionData, SessionIdChangedCallback, SessionRecordingMaskInputOptions, SessionRecordingOptions, SupportedWebVitalsMetric, TrackingEvent, UserIdentity, UserProperties, VTiltConfig, WebVitalMetric };
+export { ALL_WEB_VITALS_METRICS, DEFAULT_WEB_VITALS_METRICS, VTILT_SNIPPET_STUB_METHODS, VTILT_SNIPPET_STUB_METHOD_NAMES, VTilt, vt as default, vt };
+export type { AutocaptureOptions, CaptureOptions, CapturePerformanceConfig, CaptureResult, ChatWidgetConfig, EventPayload, FeatureFlagsConfig, GeolocationData, GoogleAdsConversionMapping, GoogleConsentOverride, GoogleConsentValue, GoogleTagClientConfig, GoogleTagEventMapping, GoogleTagParamMapping, GoogleTagProxyMode, GroupsConfig, IdentityUpdate, PersistenceMethod, Properties, Property, PropertyOperations, RemoteConfig, RequestOptions, SessionData, SessionIdChangedCallback, SessionRecordingMaskInputOptions, SessionRecordingOptions, SupportedWebVitalsMetric, TrackingEvent, UserIdentity, UserProperties, VTiltConfig, VtiltSnippetStubMethodName, WebVitalMetric };