@nurama/sdk 1.4.6 → 1.4.7

package/dist/version.js

@@ -3,10 +3,10 @@
  * AUTO-GENERATED by scripts/generate-version-info.cjs - DO NOT EDIT MANUALLY
  */
 export const SDK_VERSION = {
-    version: '1.4.6',
-    buildTimestamp: '2026-10-30T09:37:39.703Z',
-    buildHash: '591a47b7ee697e4b2fd756a50b5b647e',
-    gitCommit: 'e46370d',
+    version: '1.4.7',
+    buildTimestamp: '2026-11-11T06:13:04.718Z',
+    buildHash: '18b104b8bee310a1409fe4e5ca11eb33',
+    gitCommit: 'dccf5ca',
     dirty: false,
 };
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nurama/sdk",
-  "version": "1.4.6",
+  "version": "1.4.7",
   "description": "Provides API, web-socket, and additional utilities for interfacing with the Nurama platform.",
   "main": "dist/NuramaClient.js",
   "module": "dist/NuramaClient.js",
@@ -33,7 +33,7 @@
   "dependencies": {
     "jwt-decode": "^4.0.0",
     "socket.io-client": "^4.7.2",
-    "@nurama/types": "1.4.6"
+    "@nurama/types": "1.4.7"
   },
   "devDependencies": {
     "@types/jest": "^29.5.14",

package/src/routes/asset.ts

@@ -23,7 +23,13 @@ export interface DocumentViewUrlResponse {
 
 import NuramaClient from '../NuramaClient.js';
 import { uploadSessionManager } from '../utils/uploadSessionManager.js';
-import { type Asset, type File, type AssetReferences } from '@nurama/types'; // Import Asset and File types
+import {
+  type Asset,
+  type File,
+  type AssetReferences,
+  type AssetOriginalStatus,
+  type AssetOriginalHistoryEntry,
+} from '@nurama/types';
 
 // --- Request Body Interfaces ---
 export interface UpdateAssetData {
@@ -300,6 +306,80 @@ export default function createAssetMethods(client: NuramaClient) {
       });
     },
 
+    /**
+     * 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: string): Promise<AssetOriginalStatus> {
+      if (!assetId) throw new Error('assetId is required.');
+      return client._request<AssetOriginalStatus>({
+        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: string): Promise<{ results: AssetOriginalHistoryEntry[] }> {
+      if (!assetId) throw new Error('assetId is required.');
+      return client._request<{ results: AssetOriginalHistoryEntry[] }>({
+        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: string): Promise<Asset> {
+      if (!assetId) throw new Error('assetId is required.');
+      return client._request<Asset>({
+        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: string): Promise<Asset> {
+      if (!assetId) throw new Error('assetId is required.');
+      return client._request<Asset>({
+        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: string, keepOriginal: boolean): Promise<Asset> {
+      if (!assetId) throw new Error('assetId is required.');
+      return client._request<Asset>({
+        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.

package/src/routes/product.ts

@@ -35,11 +35,12 @@ export default function createProductMethods(client: NuramaClient) {
     },
 
     /**
-     * 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(): Promise<ProductResponse[]> {
       return client._request<ProductResponse[]>({

package/src/routes/project.ts

@@ -20,6 +20,11 @@ import {
   type ListFeedEventsParams,
   type CursorPaginatedFeedEvents,
   type ReadState,
+  type AssetPruneSelection,
+  type AssetPrunePreview,
+  type AssetPruneRequestResult,
+  type AssetPruneCancelResult,
+  type ProjectPruningSummary,
 } from '@nurama/types';
 
 // Combine pagination metadata with a results array
@@ -1600,5 +1605,69 @@ export default function createProjectMethods(client: NuramaClient) {
         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: string, selection: AssetPruneSelection): Promise<AssetPrunePreview> {
+      if (!projectId) throw new Error('projectId is required.');
+      return client._request<AssetPrunePreview>({
+        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: string, selection: AssetPruneSelection): Promise<AssetPruneRequestResult> {
+      if (!projectId) throw new Error('projectId is required.');
+      return client._request<AssetPruneRequestResult>({
+        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: string, selection: AssetPruneSelection): Promise<AssetPruneCancelResult> {
+      if (!projectId) throw new Error('projectId is required.');
+      return client._request<AssetPruneCancelResult>({
+        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: string): Promise<ProjectPruningSummary> {
+      if (!projectId) throw new Error('projectId is required.');
+      return client._request<ProjectPruningSummary>({
+        method: 'GET',
+        endpoint: `/v1/projects/${projectId}/original-pruning/summary`,
+        sendJWT: true,
+      });
+    },
   };
 }

package/src/version.ts

@@ -14,9 +14,9 @@ export interface SDKVersionInfo {
 }
 
 export const SDK_VERSION: SDKVersionInfo = {
-  version: '1.4.6',
-  buildTimestamp: '2026-10-30T09:37:39.703Z',
-  buildHash: '591a47b7ee697e4b2fd756a50b5b647e',
-  gitCommit: 'e46370d',
+  version: '1.4.7',
+  buildTimestamp: '2026-11-11T06:13:04.718Z',
+  buildHash: '18b104b8bee310a1409fe4e5ca11eb33',
+  gitCommit: 'dccf5ca',
   dirty: false,
 };