@supernova-studio/supernova-sdk-beta 2.4.9 → 2.4.12

package/build/types/core/resolvers/SDKDocsEntityItemResolver.d.ts

@@ -3,208 +3,208 @@ import { DocsEntityGroup } from "../../model/docs/entities/SDKDocsEntityGroup";
 import { DocsEntityPage } from "../../model/docs/entities/SDKDocsEntityPage";
 export declare class DocsEntityItemResolver {
     hashedItems: Map<string, {
-        type?: "Page";
-        id?: string;
-        designSystemVersionId?: string;
-        path?: string;
-        createdAt?: Date;
-        updatedAt?: Date;
-        persistentId?: string;
-        title?: string;
-        configuration?: {
-            showSidebar?: boolean;
-            isPrivate?: boolean;
-            isHidden?: boolean;
-            header?: {
-                description?: string;
-                alignment?: "Left" | "Center";
+        id: string;
+        designSystemVersionId: string;
+        createdAt: Date;
+        updatedAt: Date;
+        persistentId: string;
+        title: string;
+        isRoot: boolean;
+        childrenIds: string[];
+        groupBehavior: "Group" | "Tabs";
+        shortPersistentId: string;
+        configuration: {
+            showSidebar: boolean;
+            isPrivate: boolean;
+            isHidden: boolean;
+            header: {
+                description: string;
+                alignment: "Left" | "Center";
+                backgroundImageScaleType: "AspectFill" | "AspectFit";
+                showBackgroundOverlay: boolean;
+                showCoverText: boolean;
                 foregroundColor?: {
-                    value?: string;
+                    value: string;
                     referencedTokenId?: string;
                 };
                 backgroundColor?: {
-                    value?: string;
+                    value: string;
                     referencedTokenId?: string;
                 };
                 backgroundImageAsset?: {
-                    type?: "Resource" | "FigmaNode";
+                    type: "Resource" | "FigmaNode";
                     resource?: {
-                        url?: string;
-                        resourceId?: string;
+                        resourceId: string;
+                        url: string;
                     };
                     figmaNode?: {
-                        sourceId?: string;
-                        frameReferenceId?: string;
+                        sourceId: string;
+                        frameReferenceId: string;
                     };
                 };
-                backgroundImageScaleType?: "AspectFill" | "AspectFit";
-                showBackgroundOverlay?: boolean;
-                showCoverText?: boolean;
                 minHeight?: number;
             };
         };
-        shortPersistentId?: string;
+        type: "Group";
         slug?: string;
         userSlug?: string;
+        publishMetadata?: {
+            lastPublishedByUserId: string;
+            lastPublishedAt: Date;
+        };
+        approvalState?: {
+            persistentId: string;
+            groupPersistentId: string;
+            designSystemVersionId: string;
+            approvalState: "ReadyForReview" | "ChangesRequested" | "Approved";
+        };
         draftState?: {
-            changeType?: "Created";
+            changeType: "Created";
         } | {
-            changeType?: "Updated";
-            changes?: {
+            changeType: "Updated";
+            changes: {
                 previousTitle?: string;
                 previousConfiguration?: {
-                    showSidebar?: boolean;
-                    isPrivate?: boolean;
-                    isHidden?: boolean;
-                    header?: {
-                        description?: string;
-                        alignment?: "Left" | "Center";
+                    showSidebar: boolean;
+                    isPrivate: boolean;
+                    isHidden: boolean;
+                    header: {
+                        description: string;
+                        alignment: "Left" | "Center";
+                        backgroundImageScaleType: "AspectFill" | "AspectFit";
+                        showBackgroundOverlay: boolean;
+                        showCoverText: boolean;
                         foregroundColor?: {
-                            value?: string;
+                            value: string;
                             referencedTokenId?: string;
                         };
                         backgroundColor?: {
-                            value?: string;
+                            value: string;
                             referencedTokenId?: string;
                         };
                         backgroundImageAsset?: {
-                            type?: "Resource" | "FigmaNode";
+                            type: "Resource" | "FigmaNode";
                             resource?: {
-                                url?: string;
-                                resourceId?: string;
+                                resourceId: string;
+                                url: string;
                             };
                             figmaNode?: {
-                                sourceId?: string;
-                                frameReferenceId?: string;
+                                sourceId: string;
+                                frameReferenceId: string;
                             };
                         };
-                        backgroundImageScaleType?: "AspectFill" | "AspectFit";
-                        showBackgroundOverlay?: boolean;
-                        showCoverText?: boolean;
                         minHeight?: number;
                     };
                 };
                 previousContentHash?: string;
             };
         } | {
-            changeType?: "Deleted";
-            deletedAt?: Date;
-            deletedByUserId?: string;
+            changeType: "Deleted";
+            deletedAt: Date;
+            deletedByUserId: string;
         };
-        publishMetadata?: {
-            lastPublishedByUserId?: string;
-            lastPublishedAt?: Date;
-        };
-        approvalState?: {
-            designSystemVersionId?: string;
-            createdAt?: Date;
-            updatedAt?: Date;
-            approvalState?: "ReadyForReview" | "ChangesRequested" | "Approved";
-            pagePersistentId?: string;
-            updatedByUserId?: string;
-        };
-        liveblocksRoomId?: string;
     } | {
-        type?: "Group";
-        id?: string;
-        designSystemVersionId?: string;
-        createdAt?: Date;
-        updatedAt?: Date;
-        persistentId?: string;
-        title?: string;
-        configuration?: {
-            showSidebar?: boolean;
-            isPrivate?: boolean;
-            isHidden?: boolean;
-            header?: {
-                description?: string;
-                alignment?: "Left" | "Center";
+        id: string;
+        persistentId: string;
+        designSystemVersionId: string;
+        title: string;
+        configuration: {
+            showSidebar: boolean;
+            isPrivate: boolean;
+            isHidden: boolean;
+            header: {
+                description: string;
+                alignment: "Left" | "Center";
+                backgroundImageScaleType: "AspectFill" | "AspectFit";
+                showBackgroundOverlay: boolean;
+                showCoverText: boolean;
                 foregroundColor?: {
-                    value?: string;
+                    value: string;
                     referencedTokenId?: string;
                 };
                 backgroundColor?: {
-                    value?: string;
+                    value: string;
                     referencedTokenId?: string;
                 };
                 backgroundImageAsset?: {
-                    type?: "Resource" | "FigmaNode";
+                    type: "Resource" | "FigmaNode";
                     resource?: {
-                        url?: string;
-                        resourceId?: string;
+                        resourceId: string;
+                        url: string;
                     };
                     figmaNode?: {
-                        sourceId?: string;
-                        frameReferenceId?: string;
+                        sourceId: string;
+                        frameReferenceId: string;
                     };
                 };
-                backgroundImageScaleType?: "AspectFill" | "AspectFit";
-                showBackgroundOverlay?: boolean;
-                showCoverText?: boolean;
                 minHeight?: number;
             };
         };
-        shortPersistentId?: string;
+        shortPersistentId: string;
+        createdAt: Date;
+        updatedAt: Date;
+        path: string;
+        type: "Page";
         slug?: string;
         userSlug?: string;
+        publishMetadata?: {
+            lastPublishedByUserId: string;
+            lastPublishedAt: Date;
+        };
+        approvalState?: {
+            approvalState: "ReadyForReview" | "ChangesRequested" | "Approved";
+            pagePersistentId: string;
+            updatedByUserId: string;
+            designSystemVersionId: string;
+            updatedAt: Date;
+            createdAt: Date;
+        };
+        liveblocksRoomId?: string;
         draftState?: {
-            changeType?: "Created";
+            changeType: "Created";
         } | {
-            changeType?: "Updated";
-            changes?: {
+            changeType: "Updated";
+            changes: {
                 previousTitle?: string;
                 previousConfiguration?: {
-                    showSidebar?: boolean;
-                    isPrivate?: boolean;
-                    isHidden?: boolean;
-                    header?: {
-                        description?: string;
-                        alignment?: "Left" | "Center";
+                    showSidebar: boolean;
+                    isPrivate: boolean;
+                    isHidden: boolean;
+                    header: {
+                        description: string;
+                        alignment: "Left" | "Center";
+                        backgroundImageScaleType: "AspectFill" | "AspectFit";
+                        showBackgroundOverlay: boolean;
+                        showCoverText: boolean;
                         foregroundColor?: {
-                            value?: string;
+                            value: string;
                             referencedTokenId?: string;
                         };
                         backgroundColor?: {
-                            value?: string;
+                            value: string;
                             referencedTokenId?: string;
                         };
                         backgroundImageAsset?: {
-                            type?: "Resource" | "FigmaNode";
+                            type: "Resource" | "FigmaNode";
                             resource?: {
-                                url?: string;
-                                resourceId?: string;
+                                resourceId: string;
+                                url: string;
                             };
                             figmaNode?: {
-                                sourceId?: string;
-                                frameReferenceId?: string;
+                                sourceId: string;
+                                frameReferenceId: string;
                             };
                         };
-                        backgroundImageScaleType?: "AspectFill" | "AspectFit";
-                        showBackgroundOverlay?: boolean;
-                        showCoverText?: boolean;
                         minHeight?: number;
                     };
                 };
                 previousContentHash?: string;
             };
         } | {
-            changeType?: "Deleted";
-            deletedAt?: Date;
-            deletedByUserId?: string;
-        };
-        publishMetadata?: {
-            lastPublishedByUserId?: string;
-            lastPublishedAt?: Date;
-        };
-        approvalState?: {
-            designSystemVersionId?: string;
-            persistentId?: string;
-            approvalState?: "ReadyForReview" | "ChangesRequested" | "Approved";
-            groupPersistentId?: string;
+            changeType: "Deleted";
+            deletedAt: Date;
+            deletedByUserId: string;
         };
-        isRoot?: boolean;
-        childrenIds?: string[];
-        groupBehavior?: "Group" | "Tabs";
     }>;
     resolvedItems: Map<string, DocsEntityPage | DocsEntityGroup>;
     resolveMultiplayerItems(pageDetails: Array<DTODocumentationHierarchyV2["pages"][number]>, groupDetails: Array<DTODocumentationHierarchyV2["groups"][number]>): Array<DocsEntityGroup | DocsEntityPage>;

package/build/types/exports.d.ts

@@ -228,6 +228,7 @@ export { DocumentationLegacyRichText } from "./model/documentation/SDKDocumentat
 export { RichTextSpan } from "./model/documentation/SDKDocumentationLegacyRichTextSpan";
 export { RichTextSpanAttribute } from "./model/documentation/SDKDocumentationLegacyRichTextSpanAttribute";
 export { AssetGroup } from "./model/groups/SDKAssetGroup";
+export { ComponentGroup } from "./model/groups/SDKComponentGroup";
 export { DesignComponentGroup } from "./model/groups/SDKDesignComponentGroup";
 export { TokenGroup } from "./model/groups/SDKTokenGroup";
 export { DesignSystemCollection } from "./model/base/SDKDesignSystemCollection";

package/build/types/model/activity-events/SDKActivityEvent.d.ts

@@ -21,6 +21,7 @@ export declare class ActivityEvent {
     action: ActivityEventAction;
     targetType: ActivityEventTargetType;
     targetId: string;
+    targetName: ActivityEventRemoteModel["targetName"];
     targetSubtype: ActivityEventRemoteModel["targetSubtype"];
     parentId: string | undefined;
     changes: ActivityEventChange[];
@@ -38,6 +39,8 @@ export type ActivityEventListFilter = {
     versionId: string;
     /** Scopes the query to one entity's history; omitted reads the whole version */
     targetId?: string;
+    /** Brand persistent ids; the "null" sentinel adds workspace-level rows */
+    brandIds?: string[];
     /** "null" reads root events only, an id reads that parent's children */
     parentId?: DTOActivityEventListInput["parentId"];
     /** Keyset cursor from the previous page; omitted reads the newest page */

package/build/types/model/agent-chats/SDKAgentChat.d.ts

@@ -21,6 +21,9 @@ export declare class AgentChat {
     eveSessionId: string | undefined;
     name: string;
     isArchived: boolean;
+    isRead: boolean;
+    isInProgress: boolean;
+    lastMessageAt: Date;
     createdAt: Date;
     updatedAt: Date;
     constructor(model: AgentChatRemoteModel);

package/build/types/model/base/SDKDesignSystem.d.ts

@@ -5,7 +5,7 @@ export type DesignSystemSwitcher = {
     designSystemIds: Array<string>;
 };
 export type DesignSystemAccessMode = "Open" | "InviteOnly";
-export type DesignSystemTransportModel = Pick<DesignSystem, "id" | "name" | "description" | "isPublic" | "isMultiBrand" | "documentationSlug" | "documentationUserSlug" | "documentationExporterId" | "designSystemSwitcher" | "workspaceId">;
+export type DesignSystemTransportModel = Pick<DesignSystem, "id" | "name" | "description" | "isPublic" | "isMultiBrand" | "documentationSlug" | "documentationUserSlug" | "documentationExporterId" | "designSystemSwitcher" | "workspaceId" | "createdAt">;
 export declare class DesignSystem {
     /** Unique identifier of design system */
     id: string;
@@ -45,6 +45,8 @@ export declare class DesignSystem {
     isAvailableToUser: boolean;
     /** Unique identifier of the shared draft version of the design system */
     sharedDraftId: string;
+    /** When the design system was created */
+    createdAt: Date;
     constructor(model: Omit<DTODesignSystem, "isPublic"> & {
         isPublic: boolean;
     });

package/build/types/model/docs/blocks/properties/SDKDocsBlockContextProperty.d.ts

@@ -1,7 +1,7 @@
 import { PageBlockContextConnection, type PageBlockItemContextValue } from "@supernova-studio/model";
 import { DocsBlockItemPropertyType } from "../../../enums/SDKDocsBlockItemPropertyType";
 import { DocsBlockPropertyDefinition, DocsBlockPropertyDefinitionModel } from "./SDKDocsBlockProperty";
-export declare const DocsBlockContextPropertyConnectionValues: ["cursor", "claudeCode", "vsCode", "codex", "codeSnippet", "url"];
+export declare const DocsBlockContextPropertyConnectionValues: ("url" | "cursor" | "claudeCode" | "vsCode" | "codex" | "codeSnippet")[];
 export type DocsBlockContextPropertyConnection = PageBlockContextConnection;
 export type DocsBlockContextPropertyOptions = Record<string, never>;
 /** Context property - Data */

package/build/types/model/exporters/SDKPipeline.d.ts

@@ -16,7 +16,7 @@ export declare class Pipeline {
         documentation?: {
             environment: "Live" | "Preview";
         };
-        s3?: Record<string, unknown>;
+        s3?: Record<string, never>;
         github?: {
             url: string;
             branch: string;

package/build/types/model/exporters/exporter_builds/SDKExportDestinations.d.ts

@@ -82,6 +82,9 @@ export type DocsExportDestinationModel = {
     changes: DocsExportDestinationChanges | null;
 };
 export type DocsExportDestinationChanges = {
+    /** What the build publishes, absent on builds that publish everything */
+    pagePersistentIds?: string[];
+    groupPersistentIds?: string[];
     selectivePublishing: boolean | null;
 };
 /**

package/build/types/tools/token-preview/TokenUtilPreviewTypes.d.ts

@@ -74,6 +74,8 @@ export type TokenUtilPreviewReferenceInfo = {
 export type TokenUtilPreviewReferenceInfoPiece = {
     key?: Array<TokenUtilPreviewTokenValueSegment>;
     value?: Array<TokenUtilPreviewTokenValueSegment>;
+    /** Opaque hex of a colour row, for a swatch beside it. Opacity has its own row */
+    swatchColor?: string;
     icon?: string;
     fullWidth?: boolean;
     wrapSegments?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supernova-studio/supernova-sdk-beta",
-  "version": "2.4.9",
+  "version": "2.4.12",
   "description": "Supernova.io SDK",
   "main": "./build/supernova-sdk-typescript.js",
   "types": "./build/types/index.d.ts",