@supernal/interface 1.0.12 → 1.1.0

package/dist/cjs/src/tracking/hooks.js

@@ -0,0 +1,233 @@
+"use strict";
+/**
+ * SI Tracking React Hooks
+ *
+ * React hooks for integrating Supernal Interface tracking into components.
+ *
+ * @packageDocumentation
+ */
+'use client';
+/**
+ * SI Tracking React Hooks
+ *
+ * React hooks for integrating Supernal Interface tracking into components.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SITrackerProvider = void 0;
+exports.useTracker = useTracker;
+exports.useSITrackingInit = useSITrackingInit;
+exports.useTrackClick = useTrackClick;
+exports.useTrackView = useTrackView;
+exports.useTrackEngagement = useTrackEngagement;
+exports.useTrackScrollDepth = useTrackScrollDepth;
+exports.useTrackVisibility = useTrackVisibility;
+exports.createComponentTrackingHook = createComponentTrackingHook;
+const react_1 = require("react");
+// Context for providing tracker instance
+const SITrackerContext = (0, react_1.createContext)(null);
+exports.SITrackerProvider = SITrackerContext.Provider;
+/**
+ * Get the tracker instance from context
+ */
+function useTracker() {
+    return (0, react_1.useContext)(SITrackerContext);
+}
+/**
+ * Hook to sync auth state with tracker
+ * Place this once in your app layout
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const { user } = useAuth();
+ *   useSITrackingInit(tracker, user?.id);
+ *   return <div>...</div>;
+ * }
+ * ```
+ */
+function useSITrackingInit(tracker, userId) {
+    (0, react_1.useEffect)(() => {
+        if (tracker) {
+            tracker.setUserId(userId ?? null);
+        }
+    }, [tracker, userId]);
+}
+/**
+ * Hook for tracking click events
+ *
+ * @example
+ * ```tsx
+ * const trackClick = useTrackClick(tracker, 'PostCard');
+ * <button onClick={() => trackClick('like', postId)}>Like</button>
+ * ```
+ */
+function useTrackClick(tracker, componentId) {
+    return (0, react_1.useCallback)((action, targetId, metadata) => {
+        if (tracker) {
+            tracker.trackClick(componentId, action, targetId, metadata);
+        }
+    }, [tracker, componentId]);
+}
+/**
+ * Hook for tracking component views (impressions)
+ * Automatically tracks when component mounts
+ *
+ * @example
+ * ```tsx
+ * useTrackView(tracker, 'PostCard', post.id);
+ * ```
+ */
+function useTrackView(tracker, componentId, targetId, options) {
+    const { trackOnMount = true } = options ?? {};
+    (0, react_1.useEffect)(() => {
+        if (tracker && trackOnMount) {
+            tracker.trackView(componentId, targetId);
+        }
+    }, [tracker, componentId, targetId, trackOnMount]);
+}
+/**
+ * Hook for tracking engagement time on a specific target
+ * Automatically handles start/end of engagement session
+ *
+ * @example
+ * ```tsx
+ * const { recordInteraction } = useTrackEngagement(tracker, post.id);
+ * <button onClick={recordInteraction}>Interact</button>
+ * ```
+ */
+function useTrackEngagement(tracker, targetId, componentId = 'Content') {
+    const engagementStarted = (0, react_1.useRef)(false);
+    (0, react_1.useEffect)(() => {
+        if (!tracker || !targetId)
+            return;
+        // Start engagement tracking
+        tracker.startEngagement(targetId);
+        engagementStarted.current = true;
+        return () => {
+            // End engagement tracking on unmount
+            if (engagementStarted.current && tracker) {
+                tracker.endEngagement(targetId, componentId);
+                engagementStarted.current = false;
+            }
+        };
+    }, [tracker, targetId, componentId]);
+    const recordInteraction = (0, react_1.useCallback)(() => {
+        if (tracker) {
+            tracker.recordEngagementInteraction(targetId);
+        }
+    }, [tracker, targetId]);
+    return { recordInteraction };
+}
+/**
+ * Hook for tracking scroll depth in feed
+ * Attach to a scrollable container
+ *
+ * @example
+ * ```tsx
+ * const { handleScroll, resetScroll } = useTrackScrollDepth(tracker);
+ * <div onScroll={handleScroll}>...</div>
+ * ```
+ */
+function useTrackScrollDepth(tracker, componentId = 'Feed') {
+    const handleScroll = (0, react_1.useCallback)((event) => {
+        if (!tracker)
+            return;
+        const target = event.currentTarget;
+        const scrollHeight = target.scrollHeight - target.clientHeight;
+        if (scrollHeight <= 0)
+            return;
+        const scrollPercent = Math.round((target.scrollTop / scrollHeight) * 100);
+        tracker.trackScrollDepth(scrollPercent, componentId);
+    }, [tracker, componentId]);
+    const resetScroll = (0, react_1.useCallback)(() => {
+        if (tracker) {
+            tracker.resetScrollTracking();
+        }
+    }, [tracker]);
+    // Reset on mount
+    (0, react_1.useEffect)(() => {
+        if (tracker) {
+            tracker.resetScrollTracking();
+        }
+    }, [tracker]);
+    return { handleScroll, resetScroll };
+}
+/**
+ * Hook for tracking intersection observer visibility
+ * Useful for tracking when components come into view in feed
+ *
+ * @example
+ * ```tsx
+ * const ref = useTrackVisibility(tracker, 'PostCard', post.id);
+ * <div ref={ref}>...</div>
+ * ```
+ */
+function useTrackVisibility(tracker, componentId, targetId, options) {
+    const { threshold = 0.5 } = options ?? {};
+    const hasTracked = (0, react_1.useRef)(false);
+    const observerRef = (0, react_1.useRef)(null);
+    const refCallback = (0, react_1.useCallback)((element) => {
+        // Cleanup previous observer
+        if (observerRef.current) {
+            observerRef.current.disconnect();
+            observerRef.current = null;
+        }
+        if (!element || !tracker)
+            return;
+        // Create new observer
+        observerRef.current = new IntersectionObserver((entries) => {
+            entries.forEach((entry) => {
+                if (entry.isIntersecting && !hasTracked.current) {
+                    tracker.trackView(componentId, targetId);
+                    hasTracked.current = true;
+                }
+            });
+        }, { threshold });
+        observerRef.current.observe(element);
+    }, [tracker, componentId, targetId, threshold]);
+    // Reset tracking flag when targetId changes
+    (0, react_1.useEffect)(() => {
+        hasTracked.current = false;
+    }, [targetId]);
+    // Cleanup on unmount
+    (0, react_1.useEffect)(() => {
+        return () => {
+            if (observerRef.current) {
+                observerRef.current.disconnect();
+            }
+        };
+    }, []);
+    return refCallback;
+}
+/**
+ * Create a component-specific tracking hook factory
+ *
+ * @example
+ * ```typescript
+ * // Define your actions
+ * type PostActions = 'like' | 'unlike' | 'share' | 'bookmark';
+ *
+ * // Create hooks for PostCard
+ * export function usePostCardTracking(tracker: SITracker<PostActions>, postId: string) {
+ *   const trackClick = useTrackClick(tracker, 'PostCard');
+ *   const visibilityRef = useTrackVisibility(tracker, 'PostCard', postId);
+ *
+ *   return {
+ *     trackLike: () => trackClick('like', postId),
+ *     trackShare: () => trackClick('share', postId),
+ *     visibilityRef,
+ *   };
+ * }
+ * ```
+ */
+function createComponentTrackingHook(componentId, factory) {
+    return function useComponentTracking(tracker, targetId) {
+        const trackClick = useTrackClick(tracker, componentId);
+        if (!tracker)
+            return null;
+        return factory(trackClick, tracker, targetId);
+    };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/cjs/src/tracking/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../../src/tracking/hooks.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/tracking/index.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Supernal Interface Tracking Module
+ *
+ * Analytics and interaction tracking for SI-enabled applications.
+ * Automatically batches events, handles offline scenarios, and provides
+ * React hooks for easy integration.
+ *
+ * @packageDocumentation
+ *
+ * @example
+ * ```typescript
+ * // Create a tracker
+ * import { createTracker, TrackingProvider, useTrackClick } from '@supernal/interface/tracking';
+ *
+ * const tracker = createTracker({
+ *   endpoint: '/api/v1/analytics',
+ *   batchSize: 10,
+ *   debug: process.env.NODE_ENV === 'development',
+ * });
+ *
+ * // Provide to React tree
+ * function App() {
+ *   const { user } = useAuth();
+ *   return (
+ *     <TrackingProvider tracker={tracker} userId={user?.id}>
+ *       <YourApp />
+ *     </TrackingProvider>
+ *   );
+ * }
+ *
+ * // Use in components
+ * function PostCard({ post }) {
+ *   const tracker = useTracker();
+ *   const trackClick = useTrackClick(tracker, 'PostCard');
+ *   const visibilityRef = useTrackVisibility(tracker, 'PostCard', post.id);
+ *
+ *   return (
+ *     <div ref={visibilityRef}>
+ *       <button onClick={() => trackClick('like', post.id)}>Like</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withTracking = exports.TrackingProvider = exports.createComponentTrackingHook = exports.useTrackVisibility = exports.useTrackScrollDepth = exports.useTrackEngagement = exports.useTrackView = exports.useTrackClick = exports.useSITrackingInit = exports.useTracker = exports.SITrackerProvider = exports.createTracker = exports.SITracker = void 0;
+// Core tracker
+var tracker_1 = require("./tracker");
+Object.defineProperty(exports, "SITracker", { enumerable: true, get: function () { return tracker_1.SITracker; } });
+Object.defineProperty(exports, "createTracker", { enumerable: true, get: function () { return tracker_1.createTracker; } });
+// React hooks
+var hooks_1 = require("./hooks");
+Object.defineProperty(exports, "SITrackerProvider", { enumerable: true, get: function () { return hooks_1.SITrackerProvider; } });
+Object.defineProperty(exports, "useTracker", { enumerable: true, get: function () { return hooks_1.useTracker; } });
+Object.defineProperty(exports, "useSITrackingInit", { enumerable: true, get: function () { return hooks_1.useSITrackingInit; } });
+Object.defineProperty(exports, "useTrackClick", { enumerable: true, get: function () { return hooks_1.useTrackClick; } });
+Object.defineProperty(exports, "useTrackView", { enumerable: true, get: function () { return hooks_1.useTrackView; } });
+Object.defineProperty(exports, "useTrackEngagement", { enumerable: true, get: function () { return hooks_1.useTrackEngagement; } });
+Object.defineProperty(exports, "useTrackScrollDepth", { enumerable: true, get: function () { return hooks_1.useTrackScrollDepth; } });
+Object.defineProperty(exports, "useTrackVisibility", { enumerable: true, get: function () { return hooks_1.useTrackVisibility; } });
+Object.defineProperty(exports, "createComponentTrackingHook", { enumerable: true, get: function () { return hooks_1.createComponentTrackingHook; } });
+// React provider component
+var SITrackingProvider_1 = require("./SITrackingProvider");
+Object.defineProperty(exports, "TrackingProvider", { enumerable: true, get: function () { return SITrackingProvider_1.TrackingProvider; } });
+Object.defineProperty(exports, "withTracking", { enumerable: true, get: function () { return SITrackingProvider_1.withTracking; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/src/tracking/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tracking/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;;;AAEH,eAAe;AACf,qCAMmB;AALjB,oGAAA,SAAS,OAAA;AACT,wGAAA,aAAa,OAAA;AAMf,cAAc;AACd,iCAUiB;AATf,0GAAA,iBAAiB,OAAA;AACjB,mGAAA,UAAU,OAAA;AACV,0GAAA,iBAAiB,OAAA;AACjB,sGAAA,aAAa,OAAA;AACb,qGAAA,YAAY,OAAA;AACZ,2GAAA,kBAAkB,OAAA;AAClB,4GAAA,mBAAmB,OAAA;AACnB,2GAAA,kBAAkB,OAAA;AAClB,oHAAA,2BAA2B,OAAA;AAG7B,2BAA2B;AAC3B,2DAAoG;AAA3F,sHAAA,gBAAgB,OAAA;AAAE,kHAAA,YAAY,OAAA"}

package/dist/cjs/src/tracking/tracker.js

@@ -0,0 +1,289 @@
+"use strict";
+/**
+ * Supernal Interface Interaction Tracking
+ *
+ * Tracks user interactions with SI components for analytics and AI analysis.
+ * Batches events to minimize network requests and handles offline gracefully.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SITracker = void 0;
+exports.createTracker = createTracker;
+/**
+ * SI Tracker - Core tracking class
+ *
+ * @example
+ * ```typescript
+ * const tracker = new SITracker({ endpoint: '/api/analytics' });
+ * tracker.track('PostCard', 'view', 'post-123');
+ * ```
+ */
+class SITracker {
+    constructor(config = {}) {
+        this.queue = [];
+        this.flushInterval = null;
+        this.engagementSessions = new Map();
+        this.scrollState = {
+            maxDepth: 0,
+            lastReportedDepth: 0,
+            lastUpdateTime: Date.now(),
+        };
+        this.userId = null;
+        this.config = {
+            endpoint: config.endpoint ?? '/api/v1/analytics',
+            batchSize: config.batchSize ?? 10,
+            flushIntervalMs: config.flushIntervalMs ?? 5000,
+            minEngagementMs: config.minEngagementMs ?? 3000,
+            scrollDebounceMs: config.scrollDebounceMs ?? 500,
+            debug: config.debug ?? false,
+            customFetch: config.customFetch ?? fetch,
+        };
+        this.isClient = typeof window !== 'undefined';
+        this.sessionId = this.generateSessionId();
+        if (this.isClient) {
+            this.startFlushInterval();
+            this.setupBeforeUnload();
+        }
+    }
+    /** Generate a unique session ID */
+    generateSessionId() {
+        if (!this.isClient)
+            return 'server-session';
+        // Try to reuse session ID from sessionStorage
+        const stored = sessionStorage.getItem('si_session_id');
+        if (stored)
+            return stored;
+        const id = `si_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 9)}`;
+        sessionStorage.setItem('si_session_id', id);
+        return id;
+    }
+    /** Log debug message */
+    log(...args) {
+        if (this.config.debug) {
+            console.log('[SI Tracking]', ...args);
+        }
+    }
+    /** Set the current user ID for tracking */
+    setUserId(userId) {
+        this.userId = userId;
+    }
+    /** Get current session ID */
+    getSessionId() {
+        return this.sessionId;
+    }
+    /** Get queue length (for testing) */
+    getQueueLength() {
+        return this.queue.length;
+    }
+    /**
+     * Track an interaction
+     */
+    track(componentId, action, targetId, metadata) {
+        if (!this.isClient)
+            return;
+        const interaction = {
+            componentId,
+            action,
+            targetId,
+            metadata,
+            timestamp: Date.now(),
+            sessionId: this.sessionId,
+        };
+        this.queue.push(interaction);
+        this.log('Queued:', action, targetId);
+        // Flush if queue is full
+        if (this.queue.length >= this.config.batchSize) {
+            this.flush();
+        }
+    }
+    /** Alias for track - for click events */
+    trackClick(componentId, action, targetId, metadata) {
+        this.track(componentId, action, targetId, metadata);
+    }
+    /** Track view (impression) of a component */
+    trackView(componentId, targetId) {
+        this.track(componentId, 'view', targetId);
+    }
+    /** Start engagement tracking for a target */
+    startEngagement(targetId) {
+        if (!this.isClient)
+            return;
+        this.engagementSessions.set(targetId, {
+            targetId,
+            startTime: Date.now(),
+            scrollDepth: 0,
+            interactions: 0,
+        });
+        this.log('Engagement started:', targetId);
+    }
+    /** Record an interaction during engagement */
+    recordEngagementInteraction(targetId) {
+        const session = this.engagementSessions.get(targetId);
+        if (session) {
+            session.interactions++;
+        }
+    }
+    /** Update scroll depth for engagement session */
+    updateEngagementScrollDepth(targetId, depth) {
+        const session = this.engagementSessions.get(targetId);
+        if (session && depth > session.scrollDepth) {
+            session.scrollDepth = depth;
+        }
+    }
+    /** End engagement tracking and log the session */
+    endEngagement(targetId, componentId = 'Content') {
+        if (!this.isClient)
+            return;
+        const session = this.engagementSessions.get(targetId);
+        if (!session)
+            return;
+        const duration = Date.now() - session.startTime;
+        // Only track if engagement was meaningful
+        if (duration >= this.config.minEngagementMs) {
+            this.track(componentId, 'view', targetId, {
+                engagementDuration: duration,
+                scrollDepth: session.scrollDepth,
+                interactions: session.interactions,
+            });
+            this.log('Engagement ended:', targetId, { duration, ...session });
+        }
+        this.engagementSessions.delete(targetId);
+    }
+    /** Track scroll depth in feed */
+    trackScrollDepth(depth, componentId = 'Feed') {
+        if (!this.isClient)
+            return;
+        const now = Date.now();
+        // Only update if depth increased
+        if (depth > this.scrollState.maxDepth) {
+            this.scrollState.maxDepth = depth;
+        }
+        // Debounce reporting
+        if (now - this.scrollState.lastUpdateTime < this.config.scrollDebounceMs) {
+            return;
+        }
+        // Report at 25%, 50%, 75%, 100% milestones
+        const milestones = [25, 50, 75, 100];
+        const currentMilestone = milestones.find((m) => this.scrollState.maxDepth >= m && this.scrollState.lastReportedDepth < m);
+        if (currentMilestone) {
+            this.track(componentId, 'scroll', undefined, {
+                depth: currentMilestone,
+                maxDepth: this.scrollState.maxDepth,
+            });
+            this.scrollState.lastReportedDepth = currentMilestone;
+            this.log('Scroll milestone:', currentMilestone);
+        }
+        this.scrollState.lastUpdateTime = now;
+    }
+    /** Reset scroll tracking (e.g., on page navigation) */
+    resetScrollTracking() {
+        this.scrollState = {
+            maxDepth: 0,
+            lastReportedDepth: 0,
+            lastUpdateTime: Date.now(),
+        };
+    }
+    /** Start periodic flush interval */
+    startFlushInterval() {
+        if (this.flushInterval)
+            return;
+        this.flushInterval = setInterval(() => {
+            this.flush();
+        }, this.config.flushIntervalMs);
+    }
+    /** Stop flush interval */
+    stopFlushInterval() {
+        if (this.flushInterval) {
+            clearInterval(this.flushInterval);
+            this.flushInterval = null;
+        }
+    }
+    /** Setup beforeunload handler to flush remaining events */
+    setupBeforeUnload() {
+        window.addEventListener('beforeunload', () => {
+            // End all engagement sessions
+            for (const targetId of this.engagementSessions.keys()) {
+                this.endEngagement(targetId);
+            }
+            // Use sendBeacon for reliable delivery
+            this.flushWithBeacon();
+        });
+        // Also handle visibility change for mobile
+        document.addEventListener('visibilitychange', () => {
+            if (document.visibilityState === 'hidden') {
+                this.flushWithBeacon();
+            }
+        });
+    }
+    /** Flush queued events to the API */
+    async flush() {
+        if (!this.isClient || this.queue.length === 0)
+            return;
+        const events = [...this.queue];
+        this.queue = [];
+        this.log('Flushing', events.length, 'events');
+        try {
+            const response = await this.config.customFetch(this.config.endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    events,
+                    userId: this.userId,
+                }),
+            });
+            if (!response.ok) {
+                // Re-queue events on failure (with limit to prevent infinite growth)
+                if (this.queue.length < this.config.batchSize * 3) {
+                    this.queue.unshift(...events);
+                }
+                this.log('Flush failed, re-queued');
+            }
+        }
+        catch (error) {
+            // Re-queue events on network error
+            if (this.queue.length < this.config.batchSize * 3) {
+                this.queue.unshift(...events);
+            }
+            console.warn('[SI Tracking] Failed to flush events:', error);
+        }
+    }
+    /** Flush using sendBeacon (for unload events) */
+    flushWithBeacon() {
+        if (!this.isClient || this.queue.length === 0)
+            return;
+        const events = [...this.queue];
+        this.queue = [];
+        try {
+            const blob = new Blob([JSON.stringify({ events, userId: this.userId })], {
+                type: 'application/json',
+            });
+            navigator.sendBeacon(this.config.endpoint, blob);
+            this.log('Beacon sent', events.length, 'events');
+        }
+        catch (error) {
+            console.warn('[SI Tracking] Beacon failed:', error);
+        }
+    }
+    /** Cleanup (for testing or unmounting) */
+    destroy() {
+        this.stopFlushInterval();
+        this.flush();
+        this.engagementSessions.clear();
+    }
+}
+exports.SITracker = SITracker;
+/**
+ * Create a singleton tracker instance
+ *
+ * @example
+ * ```typescript
+ * export const tracker = createTracker({ endpoint: '/api/analytics' });
+ * ```
+ */
+function createTracker(config) {
+    return new SITracker(config);
+}
+//# sourceMappingURL=tracker.js.map

package/dist/cjs/src/tracking/tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.js","sourceRoot":"","sources":["../../../../src/tracking/tracker.ts"],"names":[],"mappings":"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"}

package/dist/esm/names/Components.d.ts

@@ -16,6 +16,18 @@ export declare const Components: {
     readonly ChatToggleButton: "chat-bubble-toggle";
     readonly ChatMessageList: "chat-message-list";
     readonly ChatTypingIndicator: "chat-typing-indicator";
+    readonly ChatMoreMenu: "chat-more-menu";
+    readonly ChatMoreMenuButton: "chat-more-menu-button";
+    readonly ApiKeySection: "api-key-section";
+    readonly ApiKeyInput: "api-key-input";
+    readonly ApiKeySubmitButton: "api-key-submit-button";
+    readonly ApiKeyClearButton: "api-key-clear-button";
+    readonly ApiKeyConfigureButton: "api-key-configure-button";
+    readonly ApiKeyStatus: "api-key-status";
+    readonly ApiKeyMasked: "api-key-masked";
+    readonly ApiKeyError: "api-key-error";
+    readonly ApiKeyShowToggle: "api-key-show-toggle";
+    readonly ApiKeyCancelButton: "api-key-cancel-button";
     readonly OpenMenuButton: "open-main-menu";
     readonly CloseMenuButton: "close-main-menu";
     readonly FeatureToggle: "feature-toggle";

package/dist/esm/names/Components.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Components.d.ts","sourceRoot":"","sources":["../../../names/Components.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEb,CAAC;AAEX;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAiB/E;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,UAAU,CAAC;AAC9C,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC"}
+{"version":3,"file":"Components.d.ts","sourceRoot":"","sources":["../../../names/Components.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqFb,CAAC;AAEX;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAiB/E;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,UAAU,CAAC;AAC9C,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC"}

package/dist/esm/names/Components.js

@@ -17,6 +17,19 @@ export const Components = {
     ChatToggleButton: 'chat-bubble-toggle',
     ChatMessageList: 'chat-message-list',
     ChatTypingIndicator: 'chat-typing-indicator',
+    ChatMoreMenu: 'chat-more-menu',
+    ChatMoreMenuButton: 'chat-more-menu-button',
+    // API Key configuration components (BYOK mode)
+    ApiKeySection: 'api-key-section',
+    ApiKeyInput: 'api-key-input',
+    ApiKeySubmitButton: 'api-key-submit-button',
+    ApiKeyClearButton: 'api-key-clear-button',
+    ApiKeyConfigureButton: 'api-key-configure-button',
+    ApiKeyStatus: 'api-key-status',
+    ApiKeyMasked: 'api-key-masked',
+    ApiKeyError: 'api-key-error',
+    ApiKeyShowToggle: 'api-key-show-toggle',
+    ApiKeyCancelButton: 'api-key-cancel-button',
     // Demo widget components - buttons
     OpenMenuButton: 'open-main-menu',
     CloseMenuButton: 'close-main-menu',