@nurama/sdk 1.4.4 → 1.4.6

package/README.md

@@ -5,7 +5,7 @@ Provides API, web-socket, and additional utilities for interfacing with the Nura
 ## Installation
 
 ```bash
-npm install nurama-sdk
+npm install @nurama/sdk
 ```
 
 ## Usage
@@ -13,7 +13,7 @@ npm install nurama-sdk
 ### Basic API Usage
 
 ```javascript
-import NuramaClient from 'nurama-sdk';
+import NuramaClient from '@nurama/sdk';
 
 // Create client instance
 const client = new NuramaClient('https://api.nurama.com', {
@@ -36,7 +36,7 @@ console.log(workspaces);
 The SDK provides WebSocket functionality for real-time notifications and events. Socket.IO is used under the hood, which handles protocol conversion automatically.
 
 ```javascript
-import NuramaClient from 'nurama-sdk';
+import NuramaClient from '@nurama/sdk';
 
 // Create client instance with a separate WebSocket server URL if needed
 const client = new NuramaClient('https://api.nurama.com', {
@@ -185,7 +185,7 @@ The `NuramaClient` constructor accepts various options for customization:
 
 ```javascript
 // Import the client
-import NuramaClient from 'nurama-sdk';
+import NuramaClient from '@nurama/sdk';
 
 // Initialize with options
 const nurama = new NuramaClient('https://api.nurama.com', {
@@ -668,7 +668,7 @@ await client.notification.getNotifications({
 The URL parameter utility can also be used independently:
 
 ```javascript
-import { parseUrlParams, paramsToUrlSearchParams } from 'nurama-sdk/utils/urlParams';
+import { parseUrlParams, paramsToUrlSearchParams } from '@nurama/sdk/utils/urlParams';
 
 // Convert parameters to string record
 const stringParams = parseUrlParams({
@@ -691,7 +691,7 @@ console.log(urlParams.toString()); // "page=1&limit=10&active=true"
 The utility supports configuration options (though the defaults work well for the Nurama API):
 
 ```javascript
-import { parseUrlParams } from 'nurama-sdk/utils/urlParams';
+import { parseUrlParams } from '@nurama/sdk/utils/urlParams';
 
 const result = parseUrlParams(params, {
   arrayFormat: 'comma',      // 'comma' or 'brackets' (key[]=val1&key[]=val2)
@@ -983,7 +983,7 @@ console.log('Git Commit:', versionInfo.gitCommit);
 **TypeScript Type:**
 
 ```typescript
-import { type SDKVersionInfo } from 'nurama-sdk';
+import { type SDKVersionInfo } from '@nurama/sdk';
 
 interface SDKVersionInfo {
   version: string;           // Semantic version (e.g., "1.3.3")

package/dist/browser/nurama-bot-sdk.js

@@ -5973,6 +5973,39 @@
           sendJWT: true
         });
       },
+      /**
+       * Gets your reading position in a project's highlights: when you last
+       * caught up, and how many messages others have highlighted since. If you
+       * have never caught up, it counts from when read tracking began.
+       * @param {string} projectId - The project ID.
+       * @param {'creator' | 'reviewer'} visibility - Which highlights.
+       * @returns {Promise<ReadState>} Your reading position.
+       */
+      async getHighlightsReadState(projectId, visibility) {
+        if (!projectId) throw new Error("projectId is required.");
+        if (!visibility) throw new Error("visibility is required.");
+        return client._request({
+          method: "GET",
+          endpoint: `/v1/projects/${projectId}/${visibility}/highlighted-messages/read-state`,
+          sendJWT: true
+        });
+      },
+      /**
+       * Marks a project's highlights as read. Pass `lastReadAt` (epoch ms) — the
+       * `highlightedAt` of the newest highlight you had loaded; omit it to catch
+       * up to now. The marker only moves forward and never past the present.
+       * @returns {Promise<ReadState>} Your updated reading position.
+       */
+      async markHighlightsCaughtUp(projectId, visibility, lastReadAt) {
+        if (!projectId) throw new Error("projectId is required.");
+        if (!visibility) throw new Error("visibility is required.");
+        return client._request({
+          method: "POST",
+          endpoint: `/v1/projects/${projectId}/${visibility}/highlighted-messages/read-state`,
+          body: lastReadAt === void 0 ? {} : { lastReadAt },
+          sendJWT: true
+        });
+      },
       /**
        * Top-N assets in a project by access-activity event type (plays, downloads, embeds).
        * Requires project read access. Returns asset IDs and counts only; hydrate names and
@@ -11556,10 +11589,10 @@
 
   // src/version.ts
   var SDK_VERSION = {
-    version: "1.4.4",
-    buildTimestamp: "2026-10-23T15:39:41.191Z",
-    buildHash: "b0bbfd265120e5fd826237cc63c5bf7d",
-    gitCommit: "7c333f8",
+    version: "1.4.6",
+    buildTimestamp: "2026-10-30T09:37:39.703Z",
+    buildHash: "591a47b7ee697e4b2fd756a50b5b647e",
+    gitCommit: "e46370d",
     dirty: false
   };