@aigentyc/chat-sdk 0.1.0

package/dist/interaction-tracker-D9P1Oq4j.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Supported interaction types for analytics.
+ */
+type InteractionType = "link_click" | "suggestion_click" | "source_click" | "copy" | "expand" | "collapse" | "button_click" | "landing_question_click" | "tool_ui_interaction" | "tool_action_click" | "tool_order_sample" | "tool_view_details" | "tool_back_to_list" | "tool_gallery_image_click" | "tool_contact_click" | "tool_pagination_next" | "tool_pagination_prev" | "feedback" | "flag" | "page_view";
+/**
+ * Arbitrary metadata attached to a tracked interaction.
+ */
+interface InteractionMetadata {
+    /** URL that was interacted with */
+    url?: string;
+    /** Visible text of the element */
+    text?: string;
+    /** Position / index in a list */
+    position?: number;
+    /** DOM element type (e.g. `"a"`, `"button"`) */
+    elementType?: string;
+    /** Additional key-value pairs */
+    [key: string]: unknown;
+}
+/**
+ * Parameters for a single `trackInteraction` call.
+ */
+interface TrackInteractionParams {
+    /** Interaction type */
+    type: InteractionType;
+    /** Identifier for the interacted element */
+    target?: string;
+    /** Human-readable label */
+    label?: string;
+    /** Extra metadata */
+    metadata?: InteractionMetadata;
+    /** Associated message ID (for per-message analytics) */
+    messageId?: string;
+    /** Server event ID (for correlation) */
+    eventId?: string;
+}
+/**
+ * Options for the `useInteractionTracker` hook.
+ */
+interface UseInteractionTrackerOptions {
+    /** Base API endpoint */
+    apiEndpoint: string;
+    /** Aigentyc project ID */
+    projectId: string;
+    /** Bearer API key (optional — falls back to session cookies) */
+    apiKey?: string;
+    /** Current page URL for contextual tracking */
+    pageUrl?: string;
+}
+/**
+ * React hook to track user interactions via the KB analytics API.
+ *
+ * Interactions are batched (up to `BATCH_SIZE`) and flushed after
+ * `BATCH_DELAY_MS` of inactivity.
+ *
+ * @param sessionId - Current chat session ID (tracking is skipped if `null`)
+ * @param options   - API configuration
+ * @returns `{ trackInteraction, flushOnUnmount }`
+ *
+ * @example
+ * ```tsx
+ * const { trackInteraction, flushOnUnmount } = useInteractionTracker(sessionId, {
+ *   apiEndpoint: "https://api.example.com",
+ *   projectId: "abc",
+ * });
+ *
+ * useEffect(() => () => flushOnUnmount(), [flushOnUnmount]);
+ *
+ * trackInteraction({ type: "link_click", target: "https://example.com" });
+ * ```
+ */
+declare function useInteractionTracker(sessionId: string | null, options: UseInteractionTrackerOptions): {
+    trackInteraction: (params: TrackInteractionParams) => void;
+    flushOnUnmount: () => void;
+};
+/**
+ * Generate a unique session ID for analytics.
+ *
+ * Format: `kb-<timestamp>-<random>`
+ */
+declare function generateSessionId(): string;
+
+export { type InteractionMetadata as I, type TrackInteractionParams as T, type UseInteractionTrackerOptions as U, type InteractionType as a, generateSessionId as g, useInteractionTracker as u };

package/dist/json-render.cjs

@@ -0,0 +1,23 @@
+"use client";
+'use strict';
+
+var chunkJ2H6MLQF_cjs = require('./chunk-J2H6MLQF.cjs');
+require('./chunk-Q7T3VAJV.cjs');
+require('./chunk-525KS5HM.cjs');
+
+
+
+Object.defineProperty(exports, "JsonRenderResult", {
+  enumerable: true,
+  get: function () { return chunkJ2H6MLQF_cjs.JsonRenderResult; }
+});
+Object.defineProperty(exports, "catalog", {
+  enumerable: true,
+  get: function () { return chunkJ2H6MLQF_cjs.catalog; }
+});
+Object.defineProperty(exports, "registry", {
+  enumerable: true,
+  get: function () { return chunkJ2H6MLQF_cjs.registry; }
+});
+//# sourceMappingURL=json-render.cjs.map
+//# sourceMappingURL=json-render.cjs.map

package/dist/json-render.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"json-render.cjs"}