@nurama/sdk 1.4.5 → 1.4.7

package/dist/browser/nurama-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
@@ -5990,6 +6023,66 @@
           params,
           sendJWT: true
         });
+      },
+      /**
+       * What pruning the originals of a selection of the project's assets would
+       * do, without doing it. Needs `canPruneAsset` on the project.
+       * @param {string} projectId - The project ID.
+       * @param {AssetPruneSelection} selection - Asset ids, creator-tree paths, or both.
+       * @returns {Promise<AssetPrunePreview>} Each asset's eligibility, and the totals.
+       */
+      async previewPruneOriginals(projectId, selection) {
+        if (!projectId) throw new Error("projectId is required.");
+        return client._request({
+          method: "POST",
+          endpoint: `/v1/projects/${projectId}/original-pruning/preview`,
+          body: selection,
+          sendJWT: true
+        });
+      },
+      /**
+       * Requests prunes for every asset in the selection that can be pruned.
+       * Needs `canPruneAsset` on the project.
+       * @param {string} projectId - The project ID.
+       * @param {AssetPruneSelection} selection - Asset ids, creator-tree paths, or both.
+       * @returns {Promise<AssetPruneRequestResult>} The requested and skipped assets.
+       */
+      async pruneOriginals(projectId, selection) {
+        if (!projectId) throw new Error("projectId is required.");
+        return client._request({
+          method: "POST",
+          endpoint: `/v1/projects/${projectId}/original-pruning/prune`,
+          body: selection,
+          sendJWT: true
+        });
+      },
+      /**
+       * Cancels every waiting prune in the selection. Needs `canPruneAsset` on the project.
+       * @param {string} projectId - The project ID.
+       * @param {AssetPruneSelection} selection - Asset ids, creator-tree paths, or both.
+       * @returns {Promise<AssetPruneCancelResult>} The cancelled assets, and those with nothing waiting.
+       */
+      async cancelPruneOriginals(projectId, selection) {
+        if (!projectId) throw new Error("projectId is required.");
+        return client._request({
+          method: "POST",
+          endpoint: `/v1/projects/${projectId}/original-pruning/cancel`,
+          body: selection,
+          sendJWT: true
+        });
+      },
+      /**
+       * The project's pruning policy and what it has done. Needs `canManageProjectSettings`.
+       * @param {string} projectId - The project ID.
+       * @returns {Promise<ProjectPruningSummary>} The summary.
+       */
+      async getOriginalPruningSummary(projectId) {
+        if (!projectId) throw new Error("projectId is required.");
+        return client._request({
+          method: "GET",
+          endpoint: `/v1/projects/${projectId}/original-pruning/summary`,
+          sendJWT: true
+        });
       }
     };
   }
@@ -6377,6 +6470,75 @@
           sendJWT: true
         });
       },
+      /**
+       * Where an asset's original is, what the project's pruning policy will do
+       * with it, and whether it can be pruned by hand now. Needs `canGetAssetOriginal`.
+       * @param {string} assetId - The ID of the asset.
+       * @returns {Promise<AssetOriginalStatus>} The original's state.
+       */
+      async getOriginal(assetId) {
+        if (!assetId) throw new Error("assetId is required.");
+        return client._request({
+          method: "GET",
+          endpoint: `/v1/assets/${assetId}/original`,
+          sendJWT: true
+        });
+      },
+      /**
+       * The history of an asset's original, newest first. Needs `canGetAssetOriginal`.
+       * @param {string} assetId - The ID of the asset.
+       * @returns {Promise<{ results: AssetOriginalHistoryEntry[] }>} The history.
+       */
+      async getOriginalHistory(assetId) {
+        if (!assetId) throw new Error("assetId is required.");
+        return client._request({
+          method: "GET",
+          endpoint: `/v1/assets/${assetId}/original/history`,
+          sendJWT: true
+        });
+      },
+      /**
+       * Requests that an asset's original be pruned once the undo window has
+       * passed (`pruneAfter`). Needs `canPruneAsset`.
+       * @param {string} assetId - The ID of the asset.
+       * @returns {Promise<Asset>} The asset, now waiting to be pruned.
+       */
+      async pruneOriginal(assetId) {
+        if (!assetId) throw new Error("assetId is required.");
+        return client._request({
+          method: "POST",
+          endpoint: `/v1/assets/${assetId}/original/prune`,
+          sendJWT: true
+        });
+      },
+      /**
+       * Cancels a requested prune before it runs. Needs `canPruneAsset`.
+       * @param {string} assetId - The ID of the asset.
+       * @returns {Promise<Asset>} The asset, with its original back to `stored`.
+       */
+      async cancelPruneOriginal(assetId) {
+        if (!assetId) throw new Error("assetId is required.");
+        return client._request({
+          method: "DELETE",
+          endpoint: `/v1/assets/${assetId}/original/prune`,
+          sendJWT: true
+        });
+      },
+      /**
+       * Exempts an asset from pruning, or lifts the exemption. Needs `canPruneAsset`.
+       * @param {string} assetId - The ID of the asset.
+       * @param {boolean} keepOriginal - True to exempt the asset.
+       * @returns {Promise<Asset>} The asset.
+       */
+      async setKeepOriginal(assetId, keepOriginal) {
+        if (!assetId) throw new Error("assetId is required.");
+        return client._request({
+          method: "PUT",
+          endpoint: `/v1/assets/${assetId}/original/keep`,
+          body: { keepOriginal },
+          sendJWT: true
+        });
+      },
       /**
        * Updates an asset.
        * @param {string} assetId - The ID of the asset to update.
@@ -8589,11 +8751,12 @@
         });
       },
       /**
-       * List active starter-package "plans" available to the caller,
-       * scoped by user-level restrictions but NOT bound to a workspace.
-       * Used by the post-signup plan-selection overlay before any
-       * workspace exists.
-       * @returns {Promise<ProductResponse[]>} Active starter-package plans.
+       * The base-plan catalogue. Works signed out: without a session it is the
+       * public catalogue (active, unrestricted plans). With one it also has the
+       * promo plans restricted to the caller (`restricted: true`) and leaves out
+       * a Demo they've already used. Plans carry only their public fields —
+       * no `restrictTo`, `notes` or payment-provider ids.
+       * @returns {Promise<ProductResponse[]>} Base plans available to the caller.
        */
       async listPlans() {
         return client._request({
@@ -11556,10 +11719,10 @@
 
   // src/version.ts
   var SDK_VERSION = {
-    version: "1.4.5",
-    buildTimestamp: "2026-10-29T06:59:31.498Z",
-    buildHash: "b0bbfd265120e5fd826237cc63c5bf7d",
-    gitCommit: "9307f8f",
+    version: "1.4.7",
+    buildTimestamp: "2026-11-11T06:13:04.718Z",
+    buildHash: "18b104b8bee310a1409fe4e5ca11eb33",
+    gitCommit: "dccf5ca",
     dirty: false
   };