@supernova-studio/supernova-sdk-beta 2.4.11 → 2.5.1

package/build/types/core/areas/SDKAreaAgentChats.d.ts

@@ -1,4 +1,4 @@
-import type { AgentChat, AgentChatChangedEntity, AgentChatCreateInput, AgentChatDeleteResponse, AgentChatListFilter, AgentChatUpdateInput } from "../../model/agent-chats/SDKAgentChat";
+import type { AgentChat, AgentChatChangedEntity, AgentChatCreateInput, AgentChatDeleteResponse, AgentChatListFilter, AgentChatUpdateInput, AgentTurnRating, AgentTurnRatingInput } from "../../model/agent-chats/SDKAgentChat";
 import { DataCore } from "../data/SDKDataCore";
 export declare class AreaAgentChats {
     private dataCore;
@@ -6,6 +6,9 @@ export declare class AreaAgentChats {
     list(filter: AgentChatListFilter): Promise<AgentChat[]>;
     getByEveSession(eveSessionId: string): Promise<AgentChat>;
     listChangedEntities(chatId: string): Promise<AgentChatChangedEntity[]>;
+    listTurnRatings(chatId: string): Promise<AgentTurnRating[]>;
+    /** Stores the rating for one assistant turn, replacing an earlier one */
+    rateTurn(chatId: string, turnId: string, input: AgentTurnRatingInput): Promise<AgentTurnRating>;
     create(input: AgentChatCreateInput): Promise<AgentChat>;
     update(chatId: string, input: AgentChatUpdateInput): Promise<AgentChat>;
     delete(chatId: string): Promise<AgentChatDeleteResponse>;

package/build/types/core/areas/SDKAreaBulkOperations.d.ts

@@ -139,18 +139,18 @@ export declare class AreaBulkOperations {
         type: "FigmaNodeRenderAsync";
         figmaNodes: {
             id: string;
-            designSystemVersionId: string;
             createdAt: Date;
+            designSystemVersionId: string;
+            persistentId: string;
             updatedAt: Date;
             meta: {
                 name: string;
                 description?: string;
             };
-            persistentId: string;
             data: {
                 sceneNodeId: string;
                 format: "Png" | "Svg";
-                renderState: "Success" | "InProgress" | "Failed";
+                renderState: "InProgress" | "Success" | "Failed";
                 hasSource: boolean;
                 scale?: number;
                 renderedImage?: {

package/build/types/core/areas/SDKAreaComponents.d.ts

@@ -19,6 +19,12 @@ export declare class AreaComponents {
     getComponents(from: RemoteVersionIdentifier, filter?: {
         brandId?: string;
     }): Promise<Array<Component>>;
+    /** Fetches a remote component in the version
+     * @param from - Remote version to fetch from
+     * @param componentIdInVersion - Component idInVersion to fetch
+     * @returns The component with its resolved properties and values
+     */
+    getComponent(from: RemoteVersionIdentifier, componentIdInVersion: string): Promise<Component>;
     /** Fetches all remote component groups in the version
      * @param from - Remote version to fetch from
      * @returns All component groups in the specified version
@@ -68,17 +74,7 @@ export declare class AreaComponents {
      * @returns New component filled with default values not associated with remote (yet)
      */
     createLocalComponent(versionId: string, brandId: string): Component;
-    /** Creates remote component group. This method can only be used once per group and will assign persistent id to the group. Calling this version on group that already has id assigned will result in error
-     * @param to - Remote version to write to
-     * @param group - Group to create
-     * @param parentId - Id of the group to add the group to. This is id of the group, not the versioned id
-     * @returns New remote component group ids
-     */
-    createComponentGroup(to: RemoteVersionIdentifier, group: ComponentGroup): Promise<{
-        id: string;
-        idInVersion: string;
-    }>;
-    /** Creates local component group. This group doesn't have id associated with it on remote, and must be created once with `createComponentGroup` to be stored in design system
+    /** Creates a local component group without persisting it to the remote design system
      * @param versionId - Id of the version to create the group in
      * @param brandId - Id of the brand to create the group in
      * @returns New group with id assigned
@@ -90,12 +86,6 @@ export declare class AreaComponents {
      * @returns Nothing
      */
     updateComponent(to: RemoteVersionIdentifier, component: Component): Promise<void>;
-    /** Updates remote component groups. This method can only be used on component groups that already exist in the version
-     * @param to - Remote version to write to
-     * @param component - Component group to update
-     * @returns Nothing
-     */
-    updateComponentGroup(to: RemoteVersionIdentifier, group: ComponentGroup): Promise<void>;
     /** Updates remote component property value. This also creates the property value if it doesn't exist
      * @param to - Remote version to write to
      * @param newValue - Value to set - this can be multiple things, from ID to raw string value to others
@@ -145,18 +135,4 @@ export declare class AreaComponents {
      * @returns Nothing
      */
     deleteComponent(to: RemoteVersionIdentifier, componentIdInVersion: string): Promise<void>;
-    /** Deletes remote component group. This method will also fix the component group tree by moving any subgroups to parent - do note it will NOT delete contents of the group. Calling this method on group that doesn't exist in the version will result in error
-     * @param to - Remote version to write to
-     * @param componentGroupIdInVersion - Component group idInVersion to delete
-     * @returns Nothing
-     */
-    ungroupComponentGroup(to: RemoteVersionIdentifier, componentGroupIdInVersion: string): Promise<void>;
-    /** Deletes remote component group and all its descendants. All items (groups and components) underneath will be deleted. Calling this method on group that doesn't exist in the version will result in error
-     * @param to - Remote version to write to
-     * @param componentGroupToDelete - Component group to delete
-     * @param allComponents - Components for lookup
-     * @param allComponentGroup - Component group for lookup
-     * @returns Nothing
-     */
-    deleteComponentGroup(to: RemoteVersionIdentifier, componentGroupToDelete: ComponentGroup, components: Array<Component>, componentGroups: Array<ComponentGroup>): Promise<void>;
 }

package/build/types/core/areas/SDKAreaDataSources.d.ts

@@ -25,6 +25,11 @@ export declare class AreaDataSources {
     getDataSources(from: {
         designSystemId: string;
     }): Promise<Array<Source>>;
+    /** Retrieves how many Figma sources count against the plan limit
+     * @param workspaceId - Workspace to count across; the limit applies to all its design systems
+     * @returns Number of Figma sources in the workspace
+     */
+    getWorkspaceFigmaSourceCount(workspaceId: string): Promise<number>;
     /** Retrieves all figma frames structures
      * @param from - Remote version to fetch from
      * @returns All data sources in the specified version

package/build/types/core/areas/SDKAreaDocumentation.d.ts

@@ -9,6 +9,7 @@ import { DocsSection } from "../../model/docs/sections/SDKDocsSection";
 import { DocumentationLegacyGroup } from "../../model/documentation/SDKDocumentationLegacyGroup";
 import { DocumentationLegacyPage } from "../../model/documentation/SDKDocumentationLegacyPage";
 import { PageHistoryVersion, PageHistoryVersionContent } from "../../model/documentation/SDKPageHistoryVersion";
+import { PublishedDocsSite } from "../../model/documentation/SDKPublishedDocsSite";
 import { DocsPublishStatus } from "../../model/enums/SDKDocsPublishStatus";
 import { DocumentationEnvironment } from "../../model/enums/SDKDocumentationEnvironment";
 import { ExportBuild, ExportBuildStatus } from "../../model/exporters/exporter_builds/SDKExportBuild";
@@ -51,6 +52,8 @@ export declare class AreaDocumentation {
      * @returns documentation url string
      */
     getDocumentationUrl(from: RemoteVersionIdentifier): Promise<string | null>;
+    /** Fetches published documentation site metadata for the version. */
+    getPublishedDocsSites(from: RemoteVersionIdentifier): Promise<PublishedDocsSite[]>;
     /** Retrieve information for an ongoing publishing build if any exists. */
     isPublishing(to: RemoteWorkspaceVersionIdentifier, environment: DocumentationEnvironment): Promise<{
         status: DocsPublishStatus.inProgress;
@@ -175,18 +178,18 @@ export declare class AreaDocumentation {
         type: "FigmaNodeRenderAsync";
         figmaNodes: {
             id: string;
-            designSystemVersionId: string;
             createdAt: Date;
+            designSystemVersionId: string;
+            persistentId: string;
             updatedAt: Date;
             meta: {
                 name: string;
                 description?: string;
             };
-            persistentId: string;
             data: {
                 sceneNodeId: string;
                 format: "Png" | "Svg";
-                renderState: "Success" | "InProgress" | "Failed";
+                renderState: "InProgress" | "Success" | "Failed";
                 hasSource: boolean;
                 scale?: number;
                 renderedImage?: {
@@ -303,18 +306,18 @@ export declare class AreaDocumentation {
         type: "FigmaNodeRenderAsync";
         figmaNodes: {
             id: string;
-            designSystemVersionId: string;
             createdAt: Date;
+            designSystemVersionId: string;
+            persistentId: string;
             updatedAt: Date;
             meta: {
                 name: string;
                 description?: string;
             };
-            persistentId: string;
             data: {
                 sceneNodeId: string;
                 format: "Png" | "Svg";
-                renderState: "Success" | "InProgress" | "Failed";
+                renderState: "InProgress" | "Success" | "Failed";
                 hasSource: boolean;
                 scale?: number;
                 renderedImage?: {
@@ -431,18 +434,18 @@ export declare class AreaDocumentation {
         type: "FigmaNodeRenderAsync";
         figmaNodes: {
             id: string;
-            designSystemVersionId: string;
             createdAt: Date;
+            designSystemVersionId: string;
+            persistentId: string;
             updatedAt: Date;
             meta: {
                 name: string;
                 description?: string;
             };
-            persistentId: string;
             data: {
                 sceneNodeId: string;
                 format: "Png" | "Svg";
-                renderState: "Success" | "InProgress" | "Failed";
+                renderState: "InProgress" | "Success" | "Failed";
                 hasSource: boolean;
                 scale?: number;
                 renderedImage?: {
@@ -598,18 +601,18 @@ export declare class AreaDocumentation {
         type: "FigmaNodeRenderAsync";
         figmaNodes: {
             id: string;
-            designSystemVersionId: string;
             createdAt: Date;
+            designSystemVersionId: string;
+            persistentId: string;
             updatedAt: Date;
             meta: {
                 name: string;
                 description?: string;
             };
-            persistentId: string;
             data: {
                 sceneNodeId: string;
                 format: "Png" | "Svg";
-                renderState: "Success" | "InProgress" | "Failed";
+                renderState: "InProgress" | "Success" | "Failed";
                 hasSource: boolean;
                 scale?: number;
                 renderedImage?: {
@@ -706,15 +709,10 @@ export declare class AreaDocumentation {
      * @param to - Remote version where the build should be created
      * @param environment - Environment to publish to
      * @param isForcing - If true, a new build will be created regardless if an in-progress build already exists.
+     * @param changes - Specific page/group ids to publish. Omit to publish everything.
      * */
-    publish(to: RemoteWorkspaceVersionIdentifier, environment: DocumentationEnvironment, isForcing?: boolean): Promise<ExportBuild>;
-    /** Publish documentation drafts. This queues a build on Supernova's server that will be processed by the asynchronous CI/CD pipeline.
-     * You can request status of the build with associated `isPublishing` method. New endpoint supports publishing drafts.
-     * @param to - Remote version where the build should be created
-     * @param environment - Environment to publish to
-     * @param changes - Specific page/group ids that needs to be published
-     * @param isForcing - If true, a new build will be created regardless if an in-progress build already exists.
-     * */
+    publish(to: RemoteWorkspaceVersionIdentifier, environment: DocumentationEnvironment, isForcing?: boolean, changes?: DTOPublishDocumentationRequest["changes"]): Promise<ExportBuild>;
+    /** @deprecated Use `publish(to, environment, isForcing, changes)` */
     publishDrafts(to: RemoteWorkspaceVersionIdentifier, environment: DocumentationEnvironment, changes: DTOPublishDocumentationRequest["changes"], isForcing?: boolean): Promise<ExportBuild>;
     getDocumentationPageAnchors(from: RemoteWorkspaceVersionIdentifier, pageId: string): Promise<Array<DTODocumentationPageAnchor>>;
     getDocumentationDependencies(from: RemoteVersionIdentifier): Promise<DTODocumentationPageDependenciesGetResponse["dependencies"]>;

package/build/types/core/areas/SDKAreaMCP.d.ts

@@ -34,12 +34,13 @@ export declare class AreaMCP {
      */
     getConsumerCount(workspaceId: string, contextId?: string, designSystemId?: string): Promise<number>;
     /**
-     * Retrieves MCP analytics for a design system and date range.
-     * @param designSystemId - The ID of the design system.
+     * Retrieves MCP analytics for a date range, optionally scoped to a design system.
+     * @param workspaceId - The ID of the workspace to scope analytics to.
+     * @param designSystemId - The ID of the design system, or null for unscoped analytics.
      * @param filters - The connection and date filters.
      * @returns The MCP analytics data.
      */
-    getAnalytics(designSystemId: string, filters: Pick<DTOMCPAnalyticsFiltersQuery, "connectionType" | "contextIds" | "start" | "end">): Promise<DTOMCPAnalyticsResponse>;
+    getAnalytics(workspaceId: string, designSystemId: string | null, filters: Pick<DTOMCPAnalyticsFiltersQuery, "connectionType" | "contextIds" | "start" | "end">): Promise<DTOMCPAnalyticsResponse>;
     /**
      * Updates the user's MCP stream with the provided data.
      * @param data - The update input containing optional projectFeatureId and projectDocumentId.

package/build/types/core/areas/SDKAreaMe.d.ts

@@ -17,8 +17,6 @@ export declare class AreaMe {
     updateAvatar(userId: string, avatar: File): Promise<void>;
     /** Deletes the current user user based on the API key provided to Supernova instance. Also removes all owned workspaces and updates memberships where user belongs. */
     deleteMe(userId: string): Promise<void>;
-    /** Checks whether user can be deleted. There are certain restrictions, like users who don't have all bills settled in their associated workspaces can't be deleted, for example */
-    canDeleteMe(userId: string): Promise<boolean>;
     /** Updates the avatar of the current user */
     deleteAvatar(userId: string): Promise<void>;
 }