@caruuto/caruuto-js 0.7.0 → 0.9.0

package/index.js

@@ -1,6 +1,8 @@
 const CaruutoClient = function (caruutoUrl, caruutoApiKey, options = {}) {
   this.options = options
   this.options.caruutoUrl = caruutoUrl
+    .replace(/\/api\/?$/, '')
+    .replace(/\/$/, '')
   this.options.caruutoApiKey = caruutoApiKey
 
   this.options.version = '1'

package/lib/extensions/ai.js

@@ -220,21 +220,35 @@ module.exports = function (CaruutoClient, clientInstance) {
      * @param {'conversation'|'question_cache'} opts.source
      * @returns {Promise<{ id: string }>}  New conversation ID
      */
-    forkConversation: async function ({ sourceId, projectId, source = 'conversation' } = {}) {
+    forkConversation: async function ({
+      sourceId,
+      projectId,
+      source = 'conversation'
+    } = {}) {
       if (!sourceId) throw new Error('sourceId is required')
       if (!projectId) throw new Error('projectId is required')
 
       const url = `${this.options.caruutoUrl}/api/ai/conversations/${sourceId}/fork`
-      const response = await doFetch(this, url, { project_id: projectId, source })
+      const response = await doFetch(this, url, {
+        project_id: projectId,
+        source
+      })
       return response.json()
     }.bind(clientInstance),
 
-    shareConversation: async function ({ conversationId, projectId, visibility = 'public' } = {}) {
+    shareConversation: async function ({
+      conversationId,
+      projectId,
+      visibility = 'public'
+    } = {}) {
       if (!conversationId) throw new Error('conversationId is required')
       if (!projectId) throw new Error('projectId is required')
 
       const url = `${this.options.caruutoUrl}/api/ai/conversations/${conversationId}/share`
-      const response = await doFetch(this, url, { project_id: projectId, visibility })
+      const response = await doFetch(this, url, {
+        project_id: projectId,
+        visibility
+      })
       return response.json()
     }.bind(clientInstance),
 
@@ -276,7 +290,11 @@ module.exports = function (CaruutoClient, clientInstance) {
         throw new Error('projectId is required')
       }
 
-      const url = `${this.options.caruutoUrl}/api/ai/conversations/${conversationId}?project_id=${encodeURIComponent(projectId)}`
+      const url = `${
+        this.options.caruutoUrl
+      }/api/ai/conversations/${conversationId}?project_id=${encodeURIComponent(
+        projectId
+      )}`
       const response = await doGet(this, url)
       return response.json()
     }.bind(clientInstance),
@@ -319,6 +337,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)
   }
 }
@@ -384,7 +445,9 @@ async function doGet(client, url) {
       if (data.error) {
         err.message = data.error
       }
-    } catch (_) {}
+    } catch (_) {
+      // Ignore JSON parsing errors and use the default error message
+    }
 
     throw err
   }
@@ -413,7 +476,9 @@ async function doFetch(client, url, body) {
       if (data.error) {
         err.message = data.error
       }
-    } catch (_) {}
+    } catch (_) {
+      // Ignore JSON parsing errors and use the default error message
+    }
 
     throw err
   }

package/lib/performFetch.js

@@ -67,7 +67,9 @@ module.exports = function (CaruutoClient) {
         if (responseData.errors) {
           err.errors = responseData.errors
         }
-      } catch (_) {}
+      } catch (_) {
+        // Ignore JSON parsing errors and use the default error message
+      }
 
       return Promise.reject(err)
     }

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@caruuto/caruuto-js",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "A high-level library for interacting with Caruuto",
   "exports": "./index.js",
   "scripts": {
-    "test": "eslint --ext js,jsx . && prettier --write '**/*.{js,jsx,md,html,css}' && NODE_ENV=test mocha {test,core/test}/**/*.js",
+    "test": "eslint --ext js,jsx . && prettier --write '**/*.{js,jsx,md,html,css}' && NODE_ENV=test mocha test/**/*.js",
     "posttest": "./scripts/coverage.js"
   },
   "author": "Jim Lambie <jim@27.works>",
@@ -50,4 +50,4 @@
     "should": "^9.0.2",
     "sinon": "^4.5.0"
   }
-}
+}