@caruuto/caruuto-js 0.7.0 → 0.8.0

package/lib/extensions/ai.js

@@ -319,6 +319,49 @@ module.exports = function (CaruutoClient, clientInstance) {
       const url = `${this.options.caruutoUrl}/api/ai/conversations/${conversationId}/turn`
       const response = await doFetch(this, url, body)
       return response.json()
+    }.bind(clientInstance),
+
+    /**
+     * Record a click on a link surfaced in an assistant response — powers the
+     * CTA-click and conversion panels on the analytics dashboard. Caruuto
+     * classifies the link as 'internal' or 'external' relative to the
+     * project's site_domain and persists it to ai_link_click_events.
+     *
+     * @param {Object} opts
+     * @param {string} opts.conversationId   - The conversation the link appeared in
+     * @param {string} opts.projectId
+     * @param {string} opts.url              - The full clicked URL, exactly as rendered
+     * @param {string} [opts.linkLabel]      - The link's visible text
+     * @param {number} [opts.messageIndex]   - Position of the assistant message clicked from
+     * @returns {Promise<{ ok: boolean }>}
+     */
+    trackLinkClick: async function ({
+      conversationId,
+      projectId,
+      url,
+      linkLabel,
+      messageIndex
+    } = {}) {
+      if (!conversationId) {
+        throw new Error('conversationId is required')
+      }
+
+      if (!projectId) {
+        throw new Error('projectId is required')
+      }
+
+      if (!url) {
+        throw new Error('url is required')
+      }
+
+      const body = { project_id: projectId, url }
+
+      if (linkLabel) body.link_label = linkLabel
+      if (messageIndex !== undefined) body.message_index = messageIndex
+
+      const trackUrl = `${this.options.caruutoUrl}/api/ai/conversations/${conversationId}/link-click`
+      const response = await doFetch(this, trackUrl, body)
+      return response.json()
     }.bind(clientInstance)
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caruuto/caruuto-js",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "A high-level library for interacting with Caruuto",
   "exports": "./index.js",
   "scripts": {