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

package/build/types/core/SDKSupernova.d.ts

@@ -1,3 +1,5 @@
+import { AreaActivityEvents } from "./areas/SDKAreaActivityEvents";
+import { AreaAgentChats } from "./areas/SDKAreaAgentChats";
 import { AreaAssets } from "./areas/SDKAreaAssets";
 import { AreaAutomation } from "./areas/SDKAreaAutomation";
 import { AreaBrands } from "./areas/SDKAreaBrands";
@@ -9,6 +11,7 @@ import { AreaDataSources } from "./areas/SDKAreaDataSources";
 import { AreaDesignSystems } from "./areas/SDKAreaDesignSystems";
 import { AreaDocsAnalytics } from "./areas/SDKAreaDocsAnalytics";
 import { AreaDocumentation } from "./areas/SDKAreaDocumentation";
+import { SDKAreaImport } from "./areas/SDKAreaImport";
 import { AreaIntegrations } from "./areas/SDKAreaIntegrations";
 import { AreaMCP } from "./areas/SDKAreaMCP";
 import { AreaMe } from "./areas/SDKAreaMe";
@@ -62,6 +65,8 @@ export declare class Supernova {
     resources: AreaResources;
     /** Get, create, update, manipulate or delete documentation items */
     documentation: AreaDocumentation;
+    /** Validate and import markdown into documentation pages */
+    import: SDKAreaImport;
     /** Get published documentation items */
     docsAnalytics: AreaDocsAnalytics;
     /** Get, create, update, manipulate or delete pipelines and automation jobs */
@@ -92,6 +97,10 @@ export declare class Supernova {
     messaging: AreaMessaging;
     /** Get, create, update, manipulate or delete sandboxes */
     sandboxes: AreaSandboxes;
+    /** Get activity events */
+    activityEvents: AreaActivityEvents;
+    /** Get, create, update, archive or delete agent chats */
+    agentChats: AreaAgentChats;
     /** Get access to raw data for local-only restoration of data */
     raw: AreaRawData;
     /**

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

@@ -0,0 +1,7 @@
+import { ActivityEventListFilter, ActivityEventListResult } from "../../model/activity-events/SDKActivityEvent";
+import { DataCore } from "../data/SDKDataCore";
+export declare class AreaActivityEvents {
+    private dataCore;
+    constructor(dataCore: DataCore);
+    list(filter: ActivityEventListFilter): Promise<ActivityEventListResult>;
+}

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

@@ -0,0 +1,12 @@
+import type { AgentChat, AgentChatChangedEntity, AgentChatCreateInput, AgentChatDeleteResponse, AgentChatListFilter, AgentChatUpdateInput } from "../../model/agent-chats/SDKAgentChat";
+import { DataCore } from "../data/SDKDataCore";
+export declare class AreaAgentChats {
+    private dataCore;
+    constructor(dataCore: DataCore);
+    list(filter: AgentChatListFilter): Promise<AgentChat[]>;
+    getByEveSession(eveSessionId: string): Promise<AgentChat>;
+    listChangedEntities(chatId: string): Promise<AgentChatChangedEntity[]>;
+    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

@@ -53,9 +53,11 @@ export declare class AreaBulkOperations {
      * @returns Nothing
      */
     importTokens(designSystemId: string, brandId: string, sourceId: string, sourceName: string, sourceType: "FigmaVariablesPlugin", payload: unknown, isTokenTypeSplitEnabled?: boolean, version?: "1" | "2"): Promise<ImportJob>;
-    /** Batch updates, creates or deletes token data from Supernova at once. Use this method to perform multiple operations at once instead of chaining single update operations. Batch routine runs everything in a single transaction, so either all operations succeed or all fail.
+    /** Updates or creates token data in Supernova using the aggregated token endpoint. Token fields, its group, theme overrides and property values all travel in one request, which also records a single activity event for the change.
      *
-     * WARNING: This method is not yet complete and only supports limited set of operations. Also, doesn't work as transation just yet.
+     * WARNING: Not atomic. The server applies the parts of the payload in sequence, so a failure can leave earlier parts already written.
+     *
+     * In `create` mode, `data.token` has its `id` and `idInVersion` written back from the server response.
      * @param to - Remote version to write to
      * @param data - Update information. All keys except token and its parent are optional and any combination of optional properties is allowed.
      * @returns Nothing
@@ -69,126 +71,126 @@ export declare class AreaBulkOperations {
      */
     /** Bulk update properties */
     updateElementProperties(to: RemoteVersionIdentifier, data: DTOElementPropertyValuesEditActionInput["values"]): Promise<{
-        type?: "DocumentationPageCreate";
-        output?: {
-            success?: true;
+        type: "DocumentationPageCreate";
+        output: {
+            success: true;
         };
     } | {
-        type?: "DocumentationPageUpdate";
-        output?: {
-            success?: true;
+        type: "DocumentationPageUpdate";
+        output: {
+            success: true;
         };
     } | {
-        type?: "DocumentationPageUpdateDocument";
-        output?: {
-            success?: true;
+        type: "DocumentationPageUpdateDocument";
+        output: {
+            success: true;
         };
     } | {
-        type?: "DocumentationPageMove";
-        output?: {
-            success?: true;
+        type: "DocumentationPageMove";
+        output: {
+            success: true;
         };
     } | {
-        type?: "DocumentationPageDuplicate";
-        output?: {
-            success?: true;
+        type: "DocumentationPageDuplicate";
+        output: {
+            success: true;
         };
     } | {
-        type?: "DocumentationPageDelete";
-        output?: {
-            success?: true;
+        type: "DocumentationPageDelete";
+        output: {
+            success: true;
         };
     } | {
-        type?: "DocumentationGroupCreate";
-        output?: {
-            success?: true;
+        type: "DocumentationGroupCreate";
+        output: {
+            success: true;
         };
     } | {
-        type?: "DocumentationTabCreate";
-        output?: {
-            success?: true;
+        type: "DocumentationTabCreate";
+        output: {
+            success: true;
         };
     } | {
-        type?: "DocumentationGroupUpdate";
-        output?: {
-            success?: true;
+        type: "DocumentationGroupUpdate";
+        output: {
+            success: true;
         };
     } | {
-        type?: "DocumentationGroupMove";
-        output?: {
-            success?: true;
+        type: "DocumentationGroupMove";
+        output: {
+            success: true;
         };
     } | {
-        type?: "DocumentationGroupDuplicate";
-        output?: {
-            success?: true;
+        type: "DocumentationGroupDuplicate";
+        output: {
+            success: true;
         };
     } | {
-        type?: "DocumentationGroupDelete";
-        output?: {
-            success?: true;
+        type: "DocumentationGroupDelete";
+        output: {
+            success: true;
         };
     } | {
-        type?: "DocumentationTabGroupDelete";
-        output?: {
-            success?: true;
+        type: "DocumentationTabGroupDelete";
+        output: {
+            success: true;
         };
     } | {
-        type?: "FigmaNodeRenderAsync";
-        figmaNodes?: {
-            id?: string;
-            designSystemVersionId?: string;
-            createdAt?: Date;
-            updatedAt?: Date;
-            meta?: {
-                name?: string;
+        type: "FigmaNodeRenderAsync";
+        figmaNodes: {
+            id: string;
+            designSystemVersionId: string;
+            createdAt: Date;
+            updatedAt: Date;
+            meta: {
+                name: string;
                 description?: string;
             };
-            persistentId?: string;
-            data?: {
-                sceneNodeId?: string;
-                format?: "Png" | "Svg";
+            persistentId: string;
+            data: {
+                sceneNodeId: string;
+                format: "Png" | "Svg";
+                renderState: "Success" | "InProgress" | "Failed";
+                hasSource: boolean;
                 scale?: number;
-                renderState?: "Success" | "InProgress" | "Failed";
                 renderedImage?: {
-                    url?: string;
+                    resourceId: string;
+                    format: "Png" | "Svg";
+                    scale?: number;
                     width?: number;
                     height?: number;
-                    resourceId?: string;
-                    format?: "Png" | "Svg";
-                    scale?: number;
+                    url?: string;
                     originKey?: string;
                 };
                 renderError?: {
-                    type?: "MissingIntegration" | "NodeNotFound" | "RenderError";
+                    type: "MissingIntegration" | "NodeNotFound" | "RateLimitExceeded" | "RenderError";
                 };
-                hasSource?: boolean;
             };
-            origin?: {
-                sourceId?: string;
+            origin: {
+                sourceId: string;
                 fileId?: string;
                 parentName?: string;
             };
         }[];
     } | {
-        type?: "DocumentationPageRestore";
-        output?: {
-            success?: true;
+        type: "DocumentationPageRestore";
+        output: {
+            success: true;
         };
     } | {
-        type?: "DocumentationGroupRestore";
-        output?: {
-            success?: true;
+        type: "DocumentationGroupRestore";
+        output: {
+            success: true;
         };
     } | {
-        type?: "DocumentationPageApprovalStateChange";
-        output?: {
-            success?: true;
+        type: "DocumentationPageApprovalStateChange";
+        output: {
+            success: true;
         };
     } | {
-        type?: "ElementPropertyValuesEdit";
-        output?: {
-            success?: true;
+        type: "ElementPropertyValuesEdit";
+        output: {
+            success: true;
         };
     }>;
     /** Batch updates, creates or deletes component data from Supernova at once. Use this method to perform multiple operations at once instead of chaining single update operations. Batch routine runs everything in a single transaction, so either all operations succeed or all fail.

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

@@ -47,7 +47,7 @@ export declare class AreaDataSources {
             isUnpublishedContentFallbackEnabled: boolean;
         };
         autoImport: SourceRemoteModelCloud["autoImportMode"];
-        themeId: string | null;
+        themeId?: string | null;
     }): Promise<Source>;
     updateFigmaSource(from: RemoteVersionIdentifier, sourceId: string, options: {
         scopes?: {

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

@@ -69,18 +69,18 @@ export declare class AreaDesignSystems {
     createDesignSystem(workspaceId: string, name: string, description?: string, accessMode?: DesignSystemAccessMode, usersToInvite?: Array<DesignSystemUserInvitation>, invitesToInvite?: Array<DesignSystemPendingMemberInvite>, emailsToInvite?: Array<DesignSystemInvite>): Promise<DesignSystem>;
     getBlockDefinitions(designSystemId: string, versionId: string): Promise<import("../..").DocsBlockDefinition[]>;
     getUrlPreview(designSystemId: string, versionId: string, request: DTODocumentationLinkPreviewRequest): Promise<{
-        linkPreview?: {
-            description?: string;
+        linkPreview: {
             title?: string;
+            description?: string;
             thumbnail?: {
-                type?: "Resource" | "FigmaNode";
+                type: "Resource" | "FigmaNode";
                 resource?: {
-                    url?: string;
-                    resourceId?: string;
+                    resourceId: string;
+                    url: string;
                 };
                 figmaNode?: {
-                    sourceId?: string;
-                    frameReferenceId?: string;
+                    sourceId: string;
+                    frameReferenceId: string;
                 };
             };
         };
@@ -174,12 +174,12 @@ export declare class AreaDesignSystems {
      */
     startSslGenerationForCustomDomain(designSystemId: string): Promise<void>;
     getPageRedirects(designSystemId: string): Promise<{
-        id?: string;
-        path?: string;
-        createdAt?: Date;
-        updatedAt?: Date;
-        designSystemId?: string;
-        pagePersistentId?: string;
+        id: string;
+        pagePersistentId: string;
+        path: string;
+        createdAt: Date;
+        updatedAt: Date;
+        designSystemId: string;
     }[]>;
     createPageRedirect(designSystemId: string, body: DTOPageRedirectCreateBody): Promise<void>;
     updatePageRedirect(designSystemId: string, redirectId: string, body: DTOPageRedirectUpdateBody): Promise<void>;