@supernova-studio/supernova-sdk-beta 2.2.12 → 2.2.52

package/README.md

@@ -111,26 +111,43 @@ With cache disabled, every request will download all necessary information for e
 
 ### Release
 
-SDK should be released via CI by opening PR `develop -> publish-sdk` branch once we need to release it.
+**Before releasing:**
 
-Please, in this PR:
+- Bump version in `sdk-typescript/scripts/packages/**.json` files
+- Ensure versions of `@supernova-studio/client` and `@supernova-studio/model` are:
+  - Up-to-date with main `package.json` in root folder of whole repository
+  - The same version is present in `package.json` and `sdk-typescript/scripts/packages/**.json` files
 
-- bump a version in `sdk-typescript/scripts/packages/**.json` files
-- check that versions of `@supernova-studio/client` and `@supernova-studio/model` are:
-- - up-to-date with main `package.json` in root folder of whole repository
-- - the same version is present in `package.json` and `sdk-typescript/scripts/packages/**.json` files.
+SDK can be released via CI in two ways:
 
-Several packages are released:
+#### 1. Manual Release (via GitHub Actions)
 
-- `@supernovaio/sdk` - main SDK used by customers, Pulsar etc
+You can trigger the SDK publish workflow manually:
+
+1. Go to the [GitHub Actions page](https://github.com/Supernova-Studio/cloud-ji/actions)
+2. Select the "Publish SDK & SDK-Exporters to NPM" workflow
+3. Click "Run workflow"
+4. Select the branch (typically `develop`)
+5. Click "Run workflow" button
+
+**Note:** Manual release does not run tests automatically.
+
+#### 2. Standard Release (via Pull Request)
+
+Open a PR from `develop` → `publish-sdk` branch when you need to release. This will automatically trigger the publish workflow when the PR is merged.
+
+#### 3. **Emergency release (from CLI)**
+
+Can be done manually via scripts like `npm run publish-package-sdk`, but CI is preferred.
+
+**Packages released:**
+
+- `@supernovaio/sdk` - Main SDK used by customers, Pulsar etc
 - `@supernovaio/sdk-exporters` - SDK used by exporters helpers
 - `@supernova-studio/supernova-sdk-beta` - SDK used by old BE during Token Studio import only
 
 Having separate version for old BE makes it simpler to release BE without necessity to update & release Pulsar, when we only need changes/fixes in SDK for Token Studio (which happens more often than changes we need for Pulsar).
 
-Emergency release could be done manually via scripts, like `npm run publish-package-sdk`.
-Please, avoid this and try using CI instead, and it helps you with ensuring tests are passed.
-
 ## What's next
 
 As this is still beta, we are working hard on improving it before the first official release. The following are areas we'd like to solve before general release:

package/build/sdk-typescript/src/core/SDKSupernova.d.ts

@@ -9,6 +9,7 @@ import { AreaDesignSystems } from "./areas/SDKAreaDesignSystems";
 import { AreaDocsAnalytics } from "./areas/SDKAreaDocsAnalytics";
 import { AreaDocumentation } from "./areas/SDKAreaDocumentation";
 import { AreaIntegrations } from "./areas/SDKAreaIntegrations";
+import { AreaMCP } from "./areas/SDKAreaMCP";
 import { AreaMe } from "./areas/SDKAreaMe";
 import { AreaMessaging } from "./areas/SDKAreaMessaging";
 import { AreaMultiplayer } from "./areas/SDKAreaMultiplayer";
@@ -24,7 +25,7 @@ import { AreaUsers } from "./areas/SDKAreaUsers";
 import { AreaVersions } from "./areas/SDKAreaVersions";
 import { AreaWorkspaceIntegrations } from "./areas/SDKAreaWorkspaceIntegrations";
 import { AreaWorkspaces } from "./areas/SDKAreaWorkspaces";
-import { DataBridgeRequestHook } from "./data/SDKDataBridge";
+import { DataBridgeRequestHook, DebugRequestObserver, DebugResponseObserver } from "./data/SDKDataBridge";
 /** Main Supernova.io SDK object. Use this to connect to your data instance and retrieve workspace / design system / version from which you can access all neccessary data. */
 export declare class Supernova {
     private apiKey;
@@ -67,6 +68,8 @@ export declare class Supernova {
     me: AreaMe;
     /** Get, create, update, manipulate or delete integrations */
     integrations: AreaIntegrations;
+    /** Get access to Supernova MCP stream capabilities */
+    mcp: AreaMCP;
     /** Get, create, update, manipulate or delete workspace integrations */
     workspaceIntegrations: AreaWorkspaceIntegrations;
     /** Get, create, update, manipulate or delete data sources */
@@ -98,10 +101,13 @@ export declare class Supernova {
         apiUrl?: string;
         aiApiUrl?: string;
         requestHook?: DataBridgeRequestHook;
+        debugRequestObserver?: DebugRequestObserver | null;
+        debugResponseObserver?: DebugResponseObserver | null;
         customFetchLib?: any;
         customProxyLib?: any;
         isPreview?: boolean;
         jobId?: string;
+        useDataCoreCached?: boolean;
     });
     get apiKeySet(): boolean;
 }

package/build/sdk-typescript/src/core/areas/SDKAreaMCP.d.ts

@@ -0,0 +1,24 @@
+import { DTOMCPStreamUpdateInput } from "@supernova-studio/client";
+import { MCPStream } from "../../model/mcp/SDKMCPStream";
+import { DataCore } from "../data/SDKDataCore";
+export declare class AreaMCP {
+    private dataCore;
+    constructor(dataCore: DataCore);
+    /**
+     * Retrieves an MCP stream by ID. Users can only access MCP streams associated with themselves.
+     * @param streamId - The ID of the MCP stream to retrieve.
+     * @returns The MCPStream object.
+     */
+    getMCPStream(streamId: string): Promise<MCPStream>;
+    /**
+     * Retrieves the user's MCP stream. If no MCP stream exists for the user, an empty MCP stream is created automatically.
+     * @returns The user's MCPStream object.
+     */
+    getUserMCPStream(): Promise<MCPStream>;
+    /**
+     * Updates the user's MCP stream with the provided data.
+     * @param data - The update input containing optional projectFeatureId and projectDocumentId.
+     * @returns The updated MCPStream object.
+     */
+    updateUserMCPStream(data: DTOMCPStreamUpdateInput): Promise<MCPStream>;
+}

package/build/sdk-typescript/src/core/areas/SDKAreaProjects.d.ts

@@ -1,6 +1,6 @@
 import { DTOForgeProjectCreate, DTOForgeProjectUpdate, DTOUpdateForgeProjectMember, DTORemoveForgeProjectMember, DTOForgeProjectFeatureCreateInput, DTOForgeProjectFeatureUpdateInput, DTOForgeProjectFeatureDeleteInput, DTOForgeProjectFeatureMoveInput, DTOForgeProjectArtifactCreateInput, DTOForgeProjectArtifactUpdateInput, DTOForgeProjectArtifactDeleteInput, DTOForgeProjectArtifactMoveInput, DTOForgeSectionCreateInput, DTOForgeSectionUpdateInput, DTOForgeSectionDeleteInput, DTOForgeSectionMoveInput, DTOForgeProjectAction, DTOFeatureMessageCreateInput, DTOFeatureMessageReactionCreateInput, DTOFeatureMessageReactionDeleteInput, DTOFeatureArtifactCreateInput, DTOFeatureArtifactDeleteInput, DTOAddMembersToForgeProject, DTOFeatureIterationCreateInput, DTOFeatureIterationUpdateArtifactsInput, DTOFeatureAgentWorkFinalizeInput, DTOFeatureIterationUpdateInput, DTOFeatureIterationPromoteInput, DTOFeatureIterationSetLatestInput, DTOFeatureIterationUpdateArtifactsByMessageInput, DTOFeatureUpdateThemeInput } from "@supernova-studio/client";
 import { ForgeProject } from "../../model/projects/SDKForgeProject";
-import { ForgeProjectContextCreateInput, ForgeProjectContextUpdateInput, ForgeProjectContext } from "../../model/projects/SDKForgeProjectContext";
+import { ForgeProjectContextCreateInput, ForgeProjectContextUpdateInput, ForgeProjectContext, type ForgeProjectTheme } from "../../model/projects/SDKForgeProjectContext";
 import { ForgeProjectDocument } from "../../model/projects/SDKForgeProjectDocument";
 import { ForgeProjectFeature } from "../../model/projects/SDKForgeProjectFeature";
 import { ForgeProjectMembership } from "../../model/projects/SDKForgeProjectMembership";
@@ -1106,6 +1106,18 @@ export declare class AreaProjects {
         description?: string | undefined;
         designSystemId?: string | undefined;
         brandId?: string | undefined;
+        thumbnail?: {
+            id: string;
+            url: string;
+            name?: string | undefined;
+            source?: {
+                type: "UserUpload";
+                userId: string;
+            } | {
+                type: "Figma";
+                renderMode: "Image" | "HTML" | "JSON";
+            } | undefined;
+        } | undefined;
         defaultTokenThemeSetId?: string | undefined;
         productContext?: string | undefined;
         additionalContext?: string | undefined;
@@ -2082,6 +2094,18 @@ export declare class AreaProjects {
         description?: string | undefined;
         designSystemId?: string | undefined;
         brandId?: string | undefined;
+        thumbnail?: {
+            id: string;
+            url: string;
+            name?: string | undefined;
+            source?: {
+                type: "UserUpload";
+                userId: string;
+            } | {
+                type: "Figma";
+                renderMode: "Image" | "HTML" | "JSON";
+            } | undefined;
+        } | undefined;
         defaultTokenThemeSetId?: string | undefined;
         productContext?: string | undefined;
         additionalContext?: string | undefined;
@@ -2093,6 +2117,11 @@ export declare class AreaProjects {
         }[] | undefined;
     }>;
     deleteProjectContext(id: string): Promise<void>;
+    updateProjectContextOverride(wsId: string, projectId: string, data: {
+        theme: Partial<ForgeProjectTheme> | null;
+    }, options?: {
+        updateSharedContext?: boolean;
+    }): Promise<import("../../model/projects/SDKForgeProjectContextOverride").ForgeProjectContextOverrideResponse>;
     getProjectTrailEvents(projectId: string): Promise<import("../..").TrailEvent[]>;
     constructor(dataCore: DataCore);
 }

package/build/sdk-typescript/src/core/areas/SDKAreaRawData.d.ts

@@ -1,4 +1,4 @@
-import type { DTODesignSystemContactsResponse, DTOFeatureArtifactListResponse, DTOFeatureIteration, DTOForgeAgent, DTOForgeChatExportResponse, DTOForgeProjectFeature, DTOForgeProjectMember, DTOThreadMessageListResponse, DTOTrailEventListResponse } from "@supernova-studio/client";
+import type { DTODesignSystemContactsResponse, DTOFeatureArtifactListResponse, DTOFeatureIteration, DTOForgeAgent, DTOForgeChatExportResponse, DTOForgeProjectFeature, DTOForgeProjectMember, DTOThreadMessageListResponse, DTOTrailEventListResponse, DTOMCPStreamResponse } from "@supernova-studio/client";
 import { DTODesignSystem, DTOForgeChatMessageListResponse, DTOForgeChatThreadListResponse, DTOPortalSettings } from "@supernova-studio/client";
 import { ForgeProjectRemoteModel } from "../../exports";
 import { BrandRemoteModel } from "../../model/base/SDKBrand";
@@ -22,6 +22,7 @@ import { SourceRemoteModel } from "../../model/support/SDKSource";
 import { TokenRemoteModel } from "../../model/tokens/remote/SDKRemoteTokenModel";
 import { UserRemoteModel } from "../../model/users/SDKUser";
 import { UserMembershipRemoteModel } from "../../model/users/SDKUserMembership";
+import { WorkspaceRemoteModel } from "../../model/workspaces/SDKWorkspace";
 import { WorkspaceIntegrationsRemoteModel } from "../../model/workspaces/SDKWorkspaceIntegration";
 import { SubscriptionProductFeaturesRemoteModel } from "../../model/workspaces/SDKWorkspaceProductFeatures";
 import { WorkspaceSubscriptionRemoteModel } from "../../model/workspaces/SDKWorkspaceSubscription";
@@ -1060,6 +1061,18 @@ export declare class AreaRawData {
         description?: string | undefined;
         designSystemId?: string | undefined;
         brandId?: string | undefined;
+        thumbnail?: {
+            id: string;
+            url: string;
+            name?: string | undefined;
+            source?: {
+                type: "UserUpload";
+                userId: string;
+            } | {
+                type: "Figma";
+                renderMode: "Image" | "HTML" | "JSON";
+            } | undefined;
+        } | undefined;
         defaultTokenThemeSetId?: string | undefined;
         productContext?: string | undefined;
         additionalContext?: string | undefined;
@@ -2040,6 +2053,18 @@ export declare class AreaRawData {
         description?: string | undefined;
         designSystemId?: string | undefined;
         brandId?: string | undefined;
+        thumbnail?: {
+            id: string;
+            url: string;
+            name?: string | undefined;
+            source?: {
+                type: "UserUpload";
+                userId: string;
+            } | {
+                type: "Figma";
+                renderMode: "Image" | "HTML" | "JSON";
+            } | undefined;
+        } | undefined;
         defaultTokenThemeSetId?: string | undefined;
         productContext?: string | undefined;
         additionalContext?: string | undefined;
@@ -2050,6 +2075,7 @@ export declare class AreaRawData {
             tokenThemeIds: string[];
         }[] | undefined;
     }[]>;
+    getRawForgeProjectContextOverride(wsId: string, projectId: string): Promise<import("../../model/projects/SDKForgeProjectContextOverride").ForgeProjectContextOverrideResponse>;
     getRawForgeAgents(workspaceId: string, projectId: string): Promise<Array<DTOForgeAgent>>;
     getRawChatThreads(workspaceId: string, limit?: number, offset?: number): Promise<DTOForgeChatThreadListResponse>;
     getRawChatThreadMessages(workspaceId: string, threadId: string): Promise<DTOForgeChatMessageListResponse>;
@@ -2064,4 +2090,7 @@ export declare class AreaRawData {
     getRawForgeProjectFeatureIterations(workspaceId: string, projectId: string, featureId: string): Promise<Array<DTOFeatureIteration>>;
     getRawForgeProjectFeatureArtifacts(workspaceId: string, projectId: string, featureId: string): Promise<DTOFeatureArtifactListResponse>;
     getRawForgeProjectTrailEvents(projectId: string): Promise<DTOTrailEventListResponse>;
+    getRawWorkspaceDetail(workspaceId: string): Promise<WorkspaceRemoteModel>;
+    getRawMCPStream(streamId: string): Promise<DTOMCPStreamResponse>;
+    getRawUserMCPStream(): Promise<DTOMCPStreamResponse>;
 }

package/build/sdk-typescript/src/core/areas/SDKAreaWorkspaces.d.ts

@@ -1,4 +1,4 @@
-import { DTOPortalSettingsUpdatePayload } from "@supernova-studio/client";
+import { DTOPortalSettingsUpdatePayload, DTOWorkspaceUntypedDataListResponse, DTOWorkspaceUntypedDataResponse } from "@supernova-studio/client";
 import { WorkspaceSeatType } from "@supernova-studio/model";
 import { UserRole } from "../../model/enums/SDKUserRole";
 import { WorkspaceSubscriptionPlanInterval } from "../../model/enums/SDKWorkspaceSubscriptionPlanInterval";
@@ -6,7 +6,7 @@ import { SubscriptionCheckoutProductCode } from "../../model/enums/SDKWorkspaceS
 import { Membership } from "../../model/membership/SDKMembership";
 import { UserMembership } from "../../model/users/SDKUserMembership";
 import { UserWorkspaceNotificationSettings, UserWorkspaceNotificationSettingsUpdateModel } from "../../model/users/SDKUserWorkspaceNotificationSettings";
-import { Workspace } from "../../model/workspaces/SDKWorkspace";
+import { DefaultProjectAccessMode, DefaultProjectRole, Workspace } from "../../model/workspaces/SDKWorkspace";
 import { WorkspaceIPWhitelistSettings, WorkspaceIPWhitelistSettingsUpdateModel } from "../../model/workspaces/SDKWorkspaceIPWhitelistSettings";
 import { WorkspaceInvitation, WorkspaceInvitationUpdateModel } from "../../model/workspaces/SDKWorkspaceInvitation";
 import { WorkspaceInvoice } from "../../model/workspaces/SDKWorkspaceInvoice";
@@ -17,7 +17,7 @@ import { WorkspaceProduct } from "../../model/workspaces/SDKWorkspaceProduct";
 import { SubscriptionProductFeatures } from "../../model/workspaces/SDKWorkspaceProductFeatures";
 import { WorkspaceProfileUpdateModel } from "../../model/workspaces/SDKWorkspaceProfile";
 import { WorkspaceSSOSettings, WorkspaceSSOSettingsUpdateModel } from "../../model/workspaces/SDKWorkspaceSSOSettings";
-import { WorkspaceSubscription, WorkspaceSubscriptionUpdateModel, WorkspaceSubscriptionUpdateModelLegacy, WorkspaceSubscriptionUpdatePreviewModel } from "../../model/workspaces/SDKWorkspaceSubscription";
+import { WorkspaceSubscription, WorkspaceSubscriptionUpdateModel, WorkspaceSubscriptionUpdatePreviewModel } from "../../model/workspaces/SDKWorkspaceSubscription";
 import { DataCore } from "../data/SDKDataCore";
 export declare class AreaWorkspaces {
     /** Internal: Engine */
@@ -133,6 +133,8 @@ export declare class AreaWorkspaces {
         projectsEnabled?: boolean;
         aiAskFeaturesEnabled?: boolean;
         aiCustomInstruction?: string;
+        defaultProjectRole?: DefaultProjectRole;
+        defaultProjectAccessMode?: DefaultProjectAccessMode;
     }): Promise<void>;
     /** tests accessibility of IP allowlist settings
      * @param workspaceId - ID of the workspace
@@ -230,11 +232,10 @@ export declare class AreaWorkspaces {
     /** Creates a new Stripe customer portal session.
      * @param workspaceId - ID of the workspace
      * @param returnUrl - URL to redirect to from the portal
-     * @param update - describes the subscription updates to be applied
      * @param cancel - describes if the subscription must be cancelled
      * @returns string - URL to the Stripe customer portal
      */
-    createPortalSession(workspaceId: string, returnUrl: string, update?: WorkspaceSubscriptionUpdateModelLegacy | null, cancel?: boolean | null): Promise<string>;
+    createPortalSession(workspaceId: string, returnUrl: string, cancel?: boolean | null): Promise<string>;
     /** Update an existing subscription.
      * @param workspaceId - ID of the workspace
      * @param update - describes the subscription updates to be applied
@@ -289,4 +290,38 @@ export declare class AreaWorkspaces {
      * @returns Nothing
      */
     deleteWorkspaceInvitation(workspaceId: string, invitationId: string): Promise<void>;
+    /**
+   * Lists all untyped data for a given workspace.
+   * @param workspaceId - The ID of the workspace.
+   * @returns A promise that resolves to the list of untyped data.
+   */
+    listUntypedData(workspaceId: string): Promise<DTOWorkspaceUntypedDataListResponse>;
+    /**
+     * Creates new untyped data in the specified workspace.
+     * @param workspaceId - The ID of the workspace.
+     * @param data - The data to create. Must be a valid JSON object.
+     * @returns A promise that resolves to the created untyped data.
+     */
+    createUntypedData(workspaceId: string, data: any): Promise<DTOWorkspaceUntypedDataResponse>;
+    /**
+     * Deletes all untyped data in the specified workspace.
+     * @param workspaceId - The ID of the workspace.
+     * @returns A promise that resolves when the operation is complete.
+     */
+    deleteAllUntypedData(workspaceId: string): Promise<void>;
+    /**
+     * Updates specific untyped data in the specified workspace.
+     * @param workspaceId - The ID of the workspace.
+     * @param id - The ID of the untyped data to update.
+     * @param data - The updated data. Must be a valid JSON object.
+     * @returns A promise that resolves to the updated untyped data.
+     */
+    updateUntypedData(workspaceId: string, id: string, data: any): Promise<DTOWorkspaceUntypedDataResponse>;
+    /**
+     * Deletes specific untyped data in the specified workspace.
+     * @param workspaceId - The ID of the workspace.
+     * @param id - The ID of the untyped data to delete.
+     * @returns A promise that resolves when the operation is complete.
+     */
+    deleteUntypedData(workspaceId: string, id: string): Promise<void>;
 }

package/build/sdk-typescript/src/core/data/SDKDataBridge.d.ts

@@ -2,16 +2,19 @@ import { GitProviderValues } from "../../model/workspaces/SDKWorkspaceIntegratio
 type DataBridgeRequestHookResult = {
     skipDefaultAuth?: boolean;
 };
+export type FetchFunction = typeof fetch;
 export type DataBridgeRequestHook = (request: any) => void | DataBridgeRequestHookResult | Promise<void | DataBridgeRequestHookResult>;
 export type DebugResponseObserver = (info: {
     requestUrl: string;
-    response: any;
+    response?: any;
     executionTime: number;
-    error?: Error;
+    error?: any;
 }) => void;
 export type DebugRequestObserver = (info: {
     requestUrl: string;
     requestMethod: string;
+    asData?: boolean;
+    isStreamed?: boolean;
 }) => void;
 export type DataBridgeConfiguration = {
     apiUrl: string;
@@ -42,10 +45,10 @@ export declare class DataBridge {
     debugResponseObserver: DebugResponseObserver | null;
     constructor(conf: DataBridgeConfiguration);
     delete(endpoint: string, payload?: any | null): Promise<any>;
-    get(endpoint: string): Promise<any>;
+    get<T = any>(endpoint: string): Promise<T>;
     getStreamed(endpoint: string): Promise<ReadableStreamDefaultReader<Uint8Array>>;
     getAsData(endpoint: string): Promise<any>;
-    put(endpoint: string, payload: any | null): Promise<any>;
+    put<T = any>(endpoint: string, payload: any | null): Promise<T>;
     post(endpoint: string, payload: any | null): Promise<any>;
     postStreamed(endpoint: string, payload: any | null): Promise<ReadableStreamDefaultReader<Uint8Array>>;
     upload(endpoint: string, formData: FormData, method?: "PUT" | "POST"): Promise<any>;
@@ -61,6 +64,7 @@ export declare class DataBridge {
     getBaseEndpoint(fragment: string | null): string;
     getPublicEndpoint(fragment: string): string;
     getAclEndpoint(resource?: string): string;
+    getMCPStreamEndpoint(fragment?: string): string;
     getUserEndpoint(userId: string, fragment: string | null): string;
     getUserWorkspaceEndpoint(userId: string, wsId: string, fragment: string | null): string;
     getWorkspaceEndpoint(wsId: string, fragment: string | null): string;

package/build/sdk-typescript/src/core/data/SDKDataCore.d.ts

@@ -1,4 +1,4 @@
-import { DTOCreateDocumentationGroupInput, DTOCreateDocumentationPageInputV2, DTOCreateDocumentationTabInput, DTODataSourceStorybookCreatePayload, DTODeleteDocumentationGroupInput, DTODeleteDocumentationPageInputV2, DTODeleteDocumentationTabGroupInput, DTODesignElementsDataDiffResponse, DTODocumentationAnalyticsTimeFrame, DTODocumentationLinkPreviewRequest, DTODocumentationPageAnchor, DTODocumentationPageApprovalStateChangeInput, DTODocumentationPageDependenciesGetResponse, DTODuplicateDocumentationGroupInput, DTODuplicateDocumentationPageInputV2, DTOElementActionInput, DTOElementPropertyValuesEditActionInput, DTOExporterPropertyValueMap, DTOFigmaNode, DTOFigmaNodeRenderIdInput, DTOFigmaNodeRenderInput, DTOFigmaNodeV2, DTOForgeChatMessageScoreInput, DTOForgeChatMessageTagInput, DTOMoveDocumentationGroupInput, DTOMoveDocumentationPageInputV2, DTOPageRedirectCreateBody, DTOPageRedirectUpdateBody, DTOPipelineCreateBody, DTOPipelineUpdateBody, DTOPortalSettingsUpdatePayload, DTOPublishDocumentationRequest, DTORestoreDocumentationGroupInput, DTORestoreDocumentationPageInput, DTOStorybookEntryReplaceAction, DTOStorybookImportPayload, DTOUpdateDocumentationGroupInput, DTOUpdateDocumentationPageInputV2, DTOUpdateForgeProjectMember, DTORemoveForgeProjectMember, DTOForgeProjectFeatureCreateInput, DTOForgeProjectFeatureUpdateInput, DTOForgeProjectFeatureDeleteInput, DTOForgeProjectFeatureMoveInput, DTOForgeProjectArtifactCreateInput, DTOForgeProjectArtifactUpdateInput, DTOForgeProjectArtifactDeleteInput, DTOForgeProjectArtifactMoveInput, DTOForgeSectionCreateInput, DTOForgeSectionUpdateInput, DTOForgeSectionDeleteInput, DTOForgeSectionMoveInput, DTOForgeProjectAction, DTOFeatureMessageCreateInput, DTOFeatureMessageReactionCreateInput, DTOFeatureMessageReactionDeleteInput, DTOFeatureArtifactCreateInput, DTOFeatureArtifactDeleteInput, DTOFileUploadPayload, DTOForgeProjectFileUploadPayload, DTOAddMembersToForgeProject, DTOFeatureIterationCreateInput, DTOFeatureIterationUpdateArtifactsInput, DTOFeatureAgentWorkFinalizeInput, DTOForgeProjectCreate, DTOForgeProjectUpdate, DTOFeatureIterationUpdateInput, DTOFeatureIterationPromoteInput, DTOFeatureIterationSetLatestInput, DTOThreadMessageCreateInput, DTOThreadReactionCreateInput, DTOThreadReactionDeleteInput, DTOThreadMessageFinalizeInput, DTOBillingCheckoutInput, DTOFileUploadBulkPayload, DTOFileFinalizeBulkPayload, DTOFeatureIterationUpdateArtifactsByMessageInput, DTOUserUpdatePayload, DTOFeatureUpdateThemeInput } from "@supernova-studio/client";
+import { DTOAddMembersToForgeProject, DTOBillingCheckoutInput, DTOCreateDocumentationGroupInput, DTOCreateDocumentationPageInputV2, DTOCreateDocumentationTabInput, DTODataSourceStorybookCreatePayload, DTODeleteDocumentationGroupInput, DTODeleteDocumentationPageInputV2, DTODeleteDocumentationTabGroupInput, DTODesignElementsDataDiffResponse, DTODocumentationAnalyticsTimeFrame, DTODocumentationLinkPreviewRequest, DTODocumentationPageAnchor, DTODocumentationPageApprovalStateChangeInput, DTODocumentationPageDependenciesGetResponse, DTODuplicateDocumentationGroupInput, DTODuplicateDocumentationPageInputV2, DTOElementActionInput, DTOElementPropertyValuesEditActionInput, DTOExporterPropertyValueMap, DTOFeatureAgentWorkFinalizeInput, DTOFeatureArtifactCreateInput, DTOFeatureArtifactDeleteInput, DTOFeatureIterationCreateInput, DTOFeatureIterationPromoteInput, DTOFeatureIterationSetLatestInput, DTOFeatureIterationUpdateArtifactsByMessageInput, DTOFeatureIterationUpdateArtifactsInput, DTOFeatureIterationUpdateInput, DTOFeatureMessageCreateInput, DTOFeatureMessageReactionCreateInput, DTOFeatureMessageReactionDeleteInput, DTOFeatureUpdateThemeInput, DTOFigmaNode, DTOFigmaNodeRenderIdInput, DTOFigmaNodeRenderInput, DTOFigmaNodeV2, DTOFileFinalizeBulkPayload, DTOFileUploadBulkPayload, DTOFileUploadPayload, DTOForgeChatMessageScoreInput, DTOForgeChatMessageTagInput, DTOForgeProjectAction, DTOForgeProjectArtifactCreateInput, DTOForgeProjectArtifactDeleteInput, DTOForgeProjectArtifactMoveInput, DTOForgeProjectArtifactUpdateInput, DTOForgeProjectCreate, DTOForgeProjectFeatureCreateInput, DTOForgeProjectFeatureDeleteInput, DTOForgeProjectFeatureMoveInput, DTOForgeProjectFeatureUpdateInput, DTOForgeProjectFileUploadPayload, DTOForgeProjectUpdate, DTOForgeSectionCreateInput, DTOForgeSectionDeleteInput, DTOForgeSectionMoveInput, DTOForgeSectionUpdateInput, DTOMCPStreamUpdateInput, DTOMoveDocumentationGroupInput, DTOMoveDocumentationPageInputV2, DTOPageRedirectCreateBody, DTOPageRedirectUpdateBody, DTOPipelineCreateBody, DTOPipelineUpdateBody, DTOPortalSettingsUpdatePayload, DTOPublishDocumentationRequest, DTORemoveForgeProjectMember, DTORestoreDocumentationGroupInput, DTORestoreDocumentationPageInput, DTOStorybookEntryReplaceAction, DTOStorybookImportPayload, DTOThreadMessageCreateInput, DTOThreadMessageFinalizeInput, DTOThreadReactionCreateInput, DTOThreadReactionDeleteInput, DTOUpdateDocumentationGroupInput, DTOUpdateDocumentationPageInputV2, DTOUpdateForgeProjectMember, DTOUserUpdatePayload, DTOWorkspaceUntypedDataListResponse, DTOWorkspaceUntypedDataResponse } from "@supernova-studio/client";
 import { DesignSystemInvite, DesignSystemInviteUpdate, DesignSystemMemberUpdate, DesignSystemPendingMemberInvite, DesignSystemUserInvitation, WorkspaceSeatType } from "@supernova-studio/model";
 import { DesignSystemAccessMode, DocsBlockDefinition, DocumentationLegacyGroup, DocumentationLegacyPage, ExportBuildStatus, ExporterJobDestination, ForgeProjectFeatureIteration, ResourceFont, TokenThemeOverrideTranserObject, UserRole, WorkspaceSubscriptionUpdatePreviewModel } from "../../exports";
 import { Asset } from "../../model/assets/SDKAsset";
@@ -39,12 +39,13 @@ import { ComponentGroup } from "../../model/groups/SDKComponentGroup";
 import { DesignComponentGroup } from "../../model/groups/SDKDesignComponentGroup";
 import { TokenGroup } from "../../model/groups/SDKTokenGroup";
 import { ImportJob } from "../../model/jobs/SDKImportJob";
+import { MCPStream } from "../../model/mcp/SDKMCPStream";
 import { Membership } from "../../model/membership/SDKMembership";
 import { ChatThread } from "../../model/messaging/SDKChatThread";
 import { ChatThreadMessage, ChatThreadMessageInput } from "../../model/messaging/SDKChatThreadMessage";
 import { ForgeAgent } from "../../model/projects/SDKForgeAgent";
 import { ForgeProject } from "../../model/projects/SDKForgeProject";
-import { ForgeProjectContext, ForgeProjectContextCreateInput, ForgeProjectContextUpdateInput } from "../../model/projects/SDKForgeProjectContext";
+import { ForgeProjectContext, ForgeProjectContextCreateInput, ForgeProjectContextUpdateInput, type ForgeProjectTheme } from "../../model/projects/SDKForgeProjectContext";
 import { ForgeProjectDocument } from "../../model/projects/SDKForgeProjectDocument";
 import { ForgeProjectFeature } from "../../model/projects/SDKForgeProjectFeature";
 import { ForgeProjectFeatureArtifact } from "../../model/projects/SDKForgeProjectFeatureArtifact";
@@ -69,7 +70,7 @@ import { User } from "../../model/users/SDKUser";
 import { UserMembership } from "../../model/users/SDKUserMembership";
 import { UserProfileUpdateModel } from "../../model/users/SDKUserProfile";
 import { UserWorkspaceNotificationSettings, UserWorkspaceNotificationSettingsUpdateModel } from "../../model/users/SDKUserWorkspaceNotificationSettings";
-import { Workspace } from "../../model/workspaces/SDKWorkspace";
+import { DefaultProjectAccessMode, DefaultProjectRole, Workspace } from "../../model/workspaces/SDKWorkspace";
 import { WorkspaceIPWhitelistSettings, WorkspaceIPWhitelistSettingsUpdateModel } from "../../model/workspaces/SDKWorkspaceIPWhitelistSettings";
 import { WorkspaceIntegrations, WorkspaceIntegrationsRemoteModel, WorkspaceIntegrationType } from "../../model/workspaces/SDKWorkspaceIntegration";
 import { WorkspaceIntegrationAccessTokenPayload } from "../../model/workspaces/SDKWorkspaceIntegrationAccessToken";
@@ -85,7 +86,7 @@ import { WorkspaceProduct } from "../../model/workspaces/SDKWorkspaceProduct";
 import { SubscriptionProductFeatures } from "../../model/workspaces/SDKWorkspaceProductFeatures";
 import { WorkspaceProfileUpdateModel } from "../../model/workspaces/SDKWorkspaceProfile";
 import { WorkspaceSSOSettings, WorkspaceSSOSettingsUpdateModel } from "../../model/workspaces/SDKWorkspaceSSOSettings";
-import { WorkspaceSubscription, WorkspaceSubscriptionUpdateModel, WorkspaceSubscriptionUpdateModelLegacy } from "../../model/workspaces/SDKWorkspaceSubscription";
+import { WorkspaceSubscription, WorkspaceSubscriptionUpdateModel } from "../../model/workspaces/SDKWorkspaceSubscription";
 import { GitProvidersBranches } from "../../model/workspaces/integrations/GitProvidersBranches";
 import { GitProvidersOrganizations } from "../../model/workspaces/integrations/GitProvidersOrganizations";
 import { GitProvidersProjects } from "../../model/workspaces/integrations/GitProvidersProjects";
@@ -1650,6 +1651,18 @@ export declare class DataCore {
         description?: string | undefined;
         designSystemId?: string | undefined;
         brandId?: string | undefined;
+        thumbnail?: {
+            id: string;
+            url: string;
+            name?: string | undefined;
+            source?: {
+                type: "UserUpload";
+                userId: string;
+            } | {
+                type: "Figma";
+                renderMode: "Image" | "HTML" | "JSON";
+            } | undefined;
+        } | undefined;
         defaultTokenThemeSetId?: string | undefined;
         productContext?: string | undefined;
         additionalContext?: string | undefined;
@@ -2625,6 +2638,18 @@ export declare class DataCore {
         description?: string | undefined;
         designSystemId?: string | undefined;
         brandId?: string | undefined;
+        thumbnail?: {
+            id: string;
+            url: string;
+            name?: string | undefined;
+            source?: {
+                type: "UserUpload";
+                userId: string;
+            } | {
+                type: "Figma";
+                renderMode: "Image" | "HTML" | "JSON";
+            } | undefined;
+        } | undefined;
         defaultTokenThemeSetId?: string | undefined;
         productContext?: string | undefined;
         additionalContext?: string | undefined;
@@ -2640,6 +2665,11 @@ export declare class DataCore {
         workspaceId: string;
     }): Promise<ForgeProjectContext[]>;
     getForgeProjectContext(contextId: string): Promise<ForgeProjectContext>;
+    updateForgeProjectContextOverride(wsId: string, projectId: string, data: {
+        theme: Partial<ForgeProjectTheme> | null;
+    }, options?: {
+        updateSharedContext?: boolean;
+    }): Promise<import("../../model/projects/SDKForgeProjectContextOverride").ForgeProjectContextOverrideResponse>;
     createForgeProjectSection(workspaceId: string, projectId: string, input: DTOForgeSectionCreateInput, tId?: string): Promise<void>;
     updateForgeProjectSection(workspaceId: string, projectId: string, input: DTOForgeSectionUpdateInput, tId?: string): Promise<void>;
     deleteForgeProjectSection(workspaceId: string, projectId: string, input: DTOForgeSectionDeleteInput, tId?: string): Promise<void>;
@@ -2730,6 +2760,8 @@ export declare class DataCore {
         projectsEnabled?: boolean;
         aiAskFeaturesEnabled?: boolean;
         aiCustomInstruction?: string;
+        defaultProjectRole?: DefaultProjectRole;
+        defaultProjectAccessMode?: DefaultProjectAccessMode;
     }): Promise<void>;
     testIpWhitelistSettings(workspaceId: string, ipWhitelistSettings: WorkspaceIPWhitelistSettingsUpdateModel): Promise<{
         accessible: boolean;
@@ -2750,7 +2782,7 @@ export declare class DataCore {
     deleteWorkspaceMember(workspaceId: string, userId: string): Promise<void>;
     deleteWorkspaceInvitation(workspaceId: string, invitationId: string): Promise<void>;
     createCheckoutSession(workspaceId: string, data: DTOBillingCheckoutInput): Promise<string>;
-    createPortalSession(workspaceId: string, returnUrl: string, update?: WorkspaceSubscriptionUpdateModelLegacy | null, cancel?: boolean | null): Promise<string>;
+    createPortalSession(workspaceId: string, returnUrl: string, cancel?: boolean | null): Promise<string>;
     updateSubscription(workspaceId: string, update: WorkspaceSubscriptionUpdateModel): Promise<void>;
     previewSubscriptionUpdate(workspaceId: string, update: WorkspaceSubscriptionUpdateModel): Promise<WorkspaceSubscriptionUpdatePreviewModel>;
     resendWorkspaceInvitation(workspaceId: string, invitationId: string, designSystemId: string | undefined): Promise<void>;
@@ -2885,4 +2917,41 @@ export declare class DataCore {
     getWorkspaceCreditsAvailability(workspaceId: string): Promise<{
         canSpendCredits: boolean;
     }>;
+    getMCPStream(streamId: string): Promise<MCPStream>;
+    getUserMCPStream(): Promise<MCPStream>;
+    updateUserMCPStream(input: DTOMCPStreamUpdateInput): Promise<MCPStream>;
+    /**
+    * Lists all untyped data for a given workspace.
+    * @param workspaceId - The ID of the workspace.
+    * @returns A promise that resolves to the list of untyped data.
+    */
+    listUntypedData(workspaceId: string): Promise<DTOWorkspaceUntypedDataListResponse>;
+    /**
+     * Creates new untyped data in the specified workspace.
+     * @param workspaceId - The ID of the workspace.
+     * @param data - The data to create.
+     * @returns A promise that resolves to the created untyped data.
+     */
+    createUntypedData(workspaceId: string, data: any): Promise<DTOWorkspaceUntypedDataResponse>;
+    /**
+     * Deletes all untyped data in the specified workspace.
+     * @param workspaceId - The ID of the workspace.
+     * @returns A promise that resolves when the operation is complete.
+     */
+    deleteAllUntypedData(workspaceId: string): Promise<void>;
+    /**
+     * Updates specific untyped data in the specified workspace.
+     * @param workspaceId - The ID of the workspace.
+     * @param id - The ID of the untyped data to update.
+     * @param data - The updated data.
+     * @returns A promise that resolves to the updated untyped data.
+     */
+    updateUntypedData(workspaceId: string, id: string, data: any): Promise<DTOWorkspaceUntypedDataResponse>;
+    /**
+     * Deletes specific untyped data in the specified workspace.
+     * @param workspaceId - The ID of the workspace.
+     * @param id - The ID of the untyped data to delete.
+     * @returns A promise that resolves when the operation is complete.
+     */
+    deleteUntypedData(workspaceId: string, id: string): Promise<void>;
 }

package/build/sdk-typescript/src/core/data/SDKDataCoreCached.d.ts

@@ -0,0 +1,50 @@
+import { ElementDataView } from "../../model/elements/SDKElementDataView";
+import { ElementProperty, ElementPropertyTargetElementType } from "../../model/elements/SDKElementProperty";
+import { ElementPropertyValue } from "../../model/elements/values/SDKElementPropertyValue";
+import { TokenType } from "../../model/enums/SDKTokenType";
+import { TokenGroup } from "../../model/groups/SDKTokenGroup";
+import { Component } from "../../model/components/SDKComponent";
+import { ComponentGroup } from "../../model/groups/SDKComponentGroup";
+import { DesignComponentGroup } from "../../model/groups/SDKDesignComponentGroup";
+import { DesignComponent } from "../../model/components/SDKDesignComponent";
+import { Source } from "../../model/support/SDKSource";
+import { TokenTheme } from "../../model/themes/SDKTokenTheme";
+import { Token } from "../../model/tokens/SDKToken";
+import { DataCore } from "./SDKDataCore";
+export declare class DataCoreCached extends DataCore {
+    private tokensCache;
+    private tokenGroupsCache;
+    private designSystemSourcesCache;
+    private themesCache;
+    private elementPropertyDefinitionsCache;
+    private elementPropertyValuesCache;
+    private elementViewsCache;
+    private componentsCache;
+    private componentGroupsCache;
+    private designComponentsCache;
+    private designComponentGroupsCache;
+    tokens(designSystemId: string, versionId: string, filter?: {
+        type?: TokenType;
+        brandId?: string;
+    }): Promise<Token[]>;
+    tokenGroups(designSystemId: string, versionId: string, filter?: {
+        type?: TokenType;
+        brandId?: string;
+    }): Promise<TokenGroup[]>;
+    designSystemSources(designSystemId: string): Promise<Source[]>;
+    themes(designSystemId: string, versionId: string): Promise<TokenTheme[]>;
+    elementPropertyDefinitions(designSystemId: string, versionId: string, type: ElementPropertyTargetElementType): Promise<ElementProperty[]>;
+    elementPropertyValues(designSystemId: string, versionId: string): Promise<ElementPropertyValue[]>;
+    elementViews(designSystemId: string, versionId: string, type: ElementPropertyTargetElementType): Promise<ElementDataView[]>;
+    components(designSystemId: string, versionId: string, filter?: {
+        brandId?: string;
+    }): Promise<Component[]>;
+    componentGroups(designSystemId: string, versionId: string): Promise<ComponentGroup[]>;
+    designComponents(designSystemId: string, versionId: string, filter?: {
+        brandId?: string;
+    }): Promise<DesignComponent[]>;
+    designComponentGroups(designSystemId: string, versionId: string, filter?: {
+        brandId?: string;
+    }): Promise<DesignComponentGroup[]>;
+    private cached;
+}