@supernova-studio/supernova-sdk-beta 2.0.31 → 2.0.36

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

@@ -1,3 +1,4 @@
+import { AreaAI } from "./areas/SDKAreaAI";
 import { AreaAssets } from "./areas/SDKAreaAssets";
 import { AreaAutomation } from "./areas/SDKAreaAutomation";
 import { AreaBrands } from "./areas/SDKAreaBrands";
@@ -6,10 +7,12 @@ import { AreaComponents } from "./areas/SDKAreaComponents";
 import { AreaDataSources } from "./areas/SDKAreaDataSources";
 import { AreaDesignSystems } from "./areas/SDKAreaDesignSystems";
 import { AreaDocumentation } from "./areas/SDKAreaDocumentation";
+import { AreaImport } from "./areas/SDKAreaImport";
 import { AreaIntegrations } from "./areas/SDKAreaIntegrations";
 import { AreaMe } from "./areas/SDKAreaMe";
 import { AreaMultiplayer } from "./areas/SDKAreaMultiplayer";
 import { AreaNetwork } from "./areas/SDKAreaNetwork";
+import { AreaRawData } from "./areas/SDKAreaRawData";
 import { AreaResources } from "./areas/SDKAreaResources";
 import { AreaStorage } from "./areas/SDKAreaStorage";
 import { AreaTokens } from "./areas/SDKAreaTokens";
@@ -57,12 +60,18 @@ export declare class Supernova {
     dataSources: AreaDataSources;
     /** Get, create, update, manipulate or delete data from Supernova en masse */
     bulkOperations: AreaBulkOperations;
+    /** Import data to Supernova directly */
+    import: AreaImport;
     /** Read and write data using Supernova key-value storage */
     storage: AreaStorage;
     /** Get access to network in exporter packages */
     network: AreaNetwork;
     /** Get access to multiplayer capabilities */
     multiplayer: AreaMultiplayer;
+    /** Get access to AI capabilities */
+    ai: AreaAI;
+    /** Get access to raw data for local-only restoration of data */
+    raw: AreaRawData;
     /**
      * Create new Supernova.io SDK object.
      * @param apiKey API key to use for authentication
@@ -77,4 +86,5 @@ export declare class Supernova {
         bypassEnvFetch?: boolean;
         proxyUrl?: string;
     });
+    get apiKeySet(): boolean;
 }

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

@@ -0,0 +1,34 @@
+import { DataCore } from "../data/SDKDataCore";
+import { RemoteVersionIdentifier, RemoteWorkspaceVersionIdentifier } from "./SDKRemoteIdentifiers";
+export declare class AreaAI {
+    /** Internal: Engine */
+    private dataCore;
+    constructor(dataCore: DataCore);
+    /** Generates code for the associated design system components for provided user prompt
+     * @param from - Design system to use
+     * @param prompt - Prompt to generate code for
+     * @param components - Components to generate code for
+     * @returns Forged component code
+     */
+    forgeCode(from: RemoteVersionIdentifier, prompt: string, components: Array<any>): Promise<string>;
+    /** Reforges code for the associated design system components for provided user prompt, taking into account existing code
+     * @param from - Design system to use
+     * @param prompt - Prompt to generate code for
+     * @param components - Components to generate code for
+     * @param existingCode - Existing code to reforge
+     * @returns Reforged component code
+     */
+    reforgeCode(from: RemoteVersionIdentifier, prompt: string, components: Array<any>, existingCode: string): Promise<string>;
+    /** Reforges code for the associated design system components for provided user prompt, taking into account existing code
+     * @param from - Design system to use
+     * @param prompt - Prompt to generate code for
+     * @param components - Components to generate code for
+     * @param existingCode - Existing code to reforge
+     * @returns Reforged component code
+     */
+    proposeTitle(from: RemoteVersionIdentifier, firstForgeQuery: string): Promise<string>;
+    /** Answers question based on the data of design system in natural language */
+    answerQuestion(from: RemoteWorkspaceVersionIdentifier, persona: "designer" | "developer" | "code", askQuery: string): Promise<string>;
+    /** Indexes a design system so it can be asked in natural language */
+    indexDS(from: RemoteWorkspaceVersionIdentifier): Promise<string>;
+}

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

@@ -1,4 +1,4 @@
-import { DTOFigmaNode, DTOFigmaNodeRenderInput } from "@supernova-studio/client";
+import { DTOFigmaNode, DTOFigmaNodeRenderIdInput, DTOFigmaNodeRenderInput, DTOFigmaNodeV2 } from "@supernova-studio/client";
 import { Asset } from "../../model/assets/SDKAsset";
 import { RenderedAsset } from "../../model/assets/SDKRenderedAsset";
 import { AssetFormat } from "../../model/enums/SDKAssetFormat";
@@ -37,7 +37,10 @@ export declare class AreaAssets {
      *
      * @returns Rendered Figma frames
      */
-    getRenderedFigmaFrames(from: RemoteVersionIdentifier, framesToRender: Array<DTOFigmaNodeRenderInput>): Promise<Array<DTOFigmaNode>>;
-    /** Passes data through Supernova CORS proxy to prevent issues with accessing foreign data from browser */
-    dataThroughCorsProxy(urlToRelay: string): Promise<ArrayBuffer | undefined>;
+    getRenderedFigmaFramesAsync(from: RemoteVersionIdentifier, nodesToRender: Array<DTOFigmaNodeRenderInput>): Promise<Array<DTOFigmaNodeV2>>;
+    /** Renders figma frames based on the source and node id. The result is a URL to the hosted image of the Figma frame that is stable across updates.
+     *
+     * @returns Rendered Figma frames
+     */
+    getRenderedFigmaFrames(from: RemoteVersionIdentifier, framesToRender: Array<DTOFigmaNodeRenderIdInput>): Promise<Array<DTOFigmaNode>>;
 }

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

@@ -1,5 +1,7 @@
+import { DTOExporterPropertyValueMap, DTOPipelineCreateBody, DTOPipelineUpdateBody } from "@supernova-studio/client";
 import { Exporter, NewExporterPayload } from "../../model/exporters/SDKExporter";
-import { NewPipelinePayload, Pipeline, PipelineUpdateModel } from "../../model/exporters/SDKPipeline";
+import { ExporterJobDestination } from "../../model/exporters/SDKExporterJobDestination";
+import { Pipeline } from "../../model/exporters/SDKPipeline";
 import { ExporterCustomBlockVariant } from "../../model/exporters/custom_blocks/SDKExporterCustomBlockVariant";
 import { ExporterConfigurationProperty } from "../../model/exporters/custom_properties/SDKExporterConfigurationProperty";
 import { ExportBuild } from "../../model/exporters/exporter_builds/SDKExportBuild";
@@ -18,6 +20,11 @@ export declare class AreaAutomation {
      * @param versionId - Identifier of the version where the pipeline is installed
      */
     getExportBuilds(workspaceId: string, versionId: string): Promise<Array<ExportBuild>>;
+    /** Fetches a single export build.
+     * @param workspaceId - Identifier of the workspace associated with the build.
+     * @param buildId - Identifier of the build.
+     */
+    getExportBuild(workspaceId: string, buildId: string): Promise<ExportBuild>;
     /** Fetches build logs of a specific build
      * @param workspaceId - Identifier of the workspace where the pipeline is installed
      * @param buildId - Identifier of the build to fetch logs for
@@ -77,28 +84,40 @@ export declare class AreaAutomation {
     scheduleImportJobForFigmaSources(from: RemoteVersionIdentifier, sourceIds: Array<string>, dryRun?: boolean): Promise<ImportJob>;
     /** Create pipeline
      * @param workspaceId string
-     * @param pipeline Pipeline
+     * @param payload
      * @returns Pipeline
      */
-    createPipeline(workspaceId: string, pipeline: NewPipelinePayload): Promise<Pipeline>;
+    createPipeline(workspaceId: string, payload: DTOPipelineCreateBody): Promise<Pipeline>;
     /** Update pipeline
-     * @param workspaceId string
-     * @param pipeline Pipeline
      * @returns Pipeline
+     * @param designSystemId
+     * @param pipelineId
+     * @param payload
      */
-    updatePipeline(workspaceId: string, pipelineUpdateModel: PipelineUpdateModel): Promise<void>;
+    updatePipeline(designSystemId: string, pipelineId: string, payload: DTOPipelineUpdateBody): Promise<Pipeline>;
     /**
      * Run pipeline
      * @param workspaceId string
      * @param designSystemVersionId string
      * @param pipelineId string
      */
-    runPipeline(workspaceId: string, designSystemVersionId: string, pipelineId: string): Promise<void>;
+    runPipeline(workspaceId: string, designSystemVersionId: string, pipelineId: string): Promise<ExportBuild>;
     /** Create exporter
      * @param workspaceId string
      * @param payload NewExporterPayload
      * @returns Exporter
      */
     createExporter(workspaceId: string, payload: NewExporterPayload): Promise<Exporter>;
+    /** Create exporter build
+     * @param workspaceId string
+     * @param designSystemId string
+     * @param versionId string
+     * @param exporterId string
+     * @param destinations
+     * @param brandId
+     * @param themePersistentIds
+     * @param exporterConfigurationProperties
+     */
+    createExporterBuild(workspaceId: string, designSystemId: string, versionId: string, exporterId: string, destinations: ExporterJobDestination, brandId: string | undefined, themePersistentIds: Array<string> | undefined, exporterConfigurationProperties: DTOExporterPropertyValueMap | undefined): Promise<ExportBuild>;
     deletePipeline(workspaceId: string, pipelineId: string): Promise<void>;
 }

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

@@ -1,4 +1,4 @@
-import { DTODocumentationLinkPreviewRequest, DTODocumentationPageApprovalStateChangeInput } from "@supernova-studio/client";
+import { DTODocumentationLinkPreviewRequest, DTODocumentationPageApprovalStateChangeInput, DTOPageRedirectCreateBody, DTOPageRedirectUpdateBody } from "@supernova-studio/client";
 import { DesignSystemInvite, DesignSystemInviteUpdate, DesignSystemMemberUpdate, DesignSystemPendingMemberInvite, DesignSystemUserInvitation } from "@supernova-studio/model";
 import { DesignSystem, DesignSystemAccessMode, DesignSystemSwitcher } from "../../model/base/SDKDesignSystem";
 import { DesignSystemContactList } from "../../model/base/SDKDesignSystemContactList";
@@ -24,6 +24,13 @@ export declare class AreaDesignSystems {
      * @returns custom domain information
      */
     designSystemCustomDomain(designSystemId: string): Promise<CustomDomain>;
+    /** Fetches design system stats
+     * @param dsId - Design system ID
+     * @param versionId - Version ID
+     * @param brandId - Brand ID to filter by
+     * @returns Design system stats
+     */
+    designSystemStats(dsId: string, versionId: string, brandId?: string): Promise<import("../../model/base/SDKDesignSystemVersionStats").DesignSystemVersionStats>;
     /** Fetches specific design system's memberships
      * @param designSystemId - Design system's identifier
      * @returns Design system's memberships
@@ -151,4 +158,15 @@ export declare class AreaDesignSystems {
      * @returns nothing
      */
     startSslGenerationForCustomDomain(designSystemId: string): Promise<void>;
+    getPageRedirects(designSystemId: string): Promise<{
+        path: string;
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        designSystemId: string;
+        pagePersistentId: string;
+    }[]>;
+    createPageRedirect(designSystemId: string, body: DTOPageRedirectCreateBody): Promise<void>;
+    updatePageRedirect(designSystemId: string, redirectId: string, body: DTOPageRedirectUpdateBody): Promise<void>;
+    deletePageRedirect(designSystemId: string, redirectId: string): Promise<void>;
 }

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

@@ -1,12 +1,10 @@
-import { DTOCreateDocumentationGroupInput, DTOCreateDocumentationPageInputV2, DTOUpdateDocumentationGroupInput, DTOUpdateDocumentationPageInputV2, DTODuplicateDocumentationGroupInput, DTODuplicateDocumentationPageInputV2, DTODeleteDocumentationGroupInput, DTOMoveDocumentationPageInputV2, DTOMoveDocumentationGroupInput, DTOCreateDocumentationTabInput, DTODocumentationPageAnchor, DTODesignElementsDataDiffResponse, DTOPublishDocumentationRequest } from "@supernova-studio/client";
+import { DTOCreateDocumentationGroupInput, DTOCreateDocumentationPageInputV2, DTOUpdateDocumentationGroupInput, DTOUpdateDocumentationPageInputV2, DTODuplicateDocumentationGroupInput, DTODuplicateDocumentationPageInputV2, DTODeleteDocumentationGroupInput, DTOMoveDocumentationPageInputV2, DTOMoveDocumentationGroupInput, DTOCreateDocumentationTabInput, DTODocumentationPageAnchor, DTODesignElementsDataDiffResponse, DTOPublishDocumentationRequest, DTOElementActionInput, DTOElementActionOutput } from "@supernova-studio/client";
 import { DocumentationLegacy, DocumentationLegacyModel } from "../../model/base/SDKDocumentationLegacy";
 import { DocsBlockDefinition } from "../../model/docs/blocks/definition/SDKDocsBlockDefinition";
-import { DocsBlock } from "../../model/docs/blocks/usage/SDKDocsBlock";
-import { DocsEntity } from "../../model/docs/entities/SDKDocsEntity";
 import { DocsEntityGroupModel } from "../../model/docs/entities/SDKDocsEntityGroup";
 import { DocsEntityPageModel } from "../../model/docs/entities/SDKDocsEntityPage";
-import { DocsSection } from "../../model/docs/sections/SDKDocsSection";
 import { DocumentationLegacyGroup } from "../../model/documentation/SDKDocumentationLegacyGroup";
+import { DocumentationLegacyPage } from "../../model/documentation/SDKDocumentationLegacyPage";
 import { DocsPublishStatus } from "../../model/enums/SDKDocsPublishStatus";
 import { DocumentationEnvironment } from "../../model/enums/SDKDocumentationEnvironment";
 import { ExportBuild, ExportBuildStatus } from "../../model/exporters/exporter_builds/SDKExportBuild";
@@ -67,6 +65,8 @@ export declare class AreaDocumentation {
      * @returns Newly created documentation page
      */
     createDocumentationPage(from: RemoteWorkspaceVersionIdentifier, payload: Omit<DTOCreateDocumentationPageInputV2, "persistentId">): Promise<string>;
+    /** General element action */
+    elementAction(from: RemoteWorkspaceVersionIdentifier, payload: DTOElementActionInput): Promise<DTOElementActionOutput>;
     /** Creates a documentation group within documentation group
      * @param from - Remote version to fetch from
      * @param parentItemPersistentId - Peristent ID of the parent group
@@ -155,9 +155,9 @@ export declare class AreaDocumentation {
      * @param from - Remote version to fetch from
      * @param idInVersion - id of page or tab to be duplicated
      * @param newPersistentId - suggested persistent id of a new group or tabbed page
-     * @returns nothing
+     * @returns duplicated group persistent id
      */
-    duplicateDocumentationGroupOrTabbedPage(from: RemoteWorkspaceVersionIdentifier, payload: Omit<DTODuplicateDocumentationGroupInput, "persistentId">): Promise<void>;
+    duplicateDocumentationGroupOrTabbedPage(from: RemoteWorkspaceVersionIdentifier, payload: Omit<DTODuplicateDocumentationGroupInput, "persistentId">): Promise<string>;
     /** Ungroups a documentation group
      * @param from - Remote version to fetch from
      * @param idInVersion - id of a group
@@ -207,7 +207,10 @@ export declare class AreaDocumentation {
      * */
     publishDrafts(to: RemoteWorkspaceVersionIdentifier, environment: DocumentationEnvironment, changes: DTOPublishDocumentationRequest["changes"], isForcing?: boolean): Promise<ExportBuild>;
     getDocumentationPageAnchors(from: RemoteWorkspaceVersionIdentifier, pageId: string): Promise<Array<DTODocumentationPageAnchor>>;
-    getDocumentationMockedStructure(): Array<DocsEntity>;
-    getDocumentationMockedPageContent(pageId: string): Array<DocsBlock | DocsSection>;
     getDocumentationMockedEditorBlockDefinitions(): Array<DocsBlockDefinition>;
+    /** Fetches all documentation pages with content
+     * @param from - Remote version to fetch from
+     * @returns Array of documentation pages (legacy, non-multiplayer model)
+     */
+    getDocumentationPagesWithContentLegacy(from: RemoteWorkspaceVersionIdentifier): Promise<Array<DocumentationLegacyPage>>;
 }

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

@@ -0,0 +1,16 @@
+import { DTODocumentationPageUpdateDocumentActionInputV2 } from "@supernova-studio/client";
+import { DataCore } from "../data/SDKDataCore";
+import { RemoteWorkspaceVersionIdentifier } from "./SDKRemoteIdentifiers";
+export type DocumentationPageContent = DTODocumentationPageUpdateDocumentActionInputV2["input"]["documentItems"];
+export declare class AreaImport {
+    /** Internal: Engine */
+    private dataCore;
+    constructor(dataCore: DataCore);
+    /** Imports documentation page content
+     * @param from - Remote version to import to
+     * @param pageId - ID of the page to import content into
+     * @param content - Content to import
+     * @returns nothing
+     */
+    importDocumentationPage(from: RemoteWorkspaceVersionIdentifier, pageId: string, content: DocumentationPageContent): Promise<void>;
+}

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

@@ -0,0 +1,84 @@
+import { Asset } from "../../model/assets/SDKAsset";
+import { Brand, BrandRemoteModel } from "../../model/base/SDKBrand";
+import { DesignSystem, // @ts-expect-error TS(2305): Module '"../../model/base/SDKDesignSystem"' has no exported member named 'DesignSystemRemoteModel'.
+DesignSystemRemoteModel } from "../../model/base/SDKDesignSystem";
+import { DesignSystemVersion, DesignSystemVersionRemoteModel } from "../../model/base/SDKDesignSystemVersion";
+import { Component, ComponentRemoteModel } from "../../model/components/SDKComponent";
+import { DesignComponentRemoteModel } from "../../model/components/SDKDesignComponent";
+import { ElementDataView, ElementDataViewRemoteModel } from "../../model/elements/SDKElementDataView";
+import { ElementProperty, ElementPropertyRemoteModel } from "../../model/elements/SDKElementProperty";
+import { ElementPropertyValue, ElementPropertyValueRemoteModel } from "../../model/elements/values/SDKElementPropertyValue";
+import { AssetGroup } from "../../model/groups/SDKAssetGroup";
+import { ComponentGroup, ComponentGroupRemoteModel } from "../../model/groups/SDKComponentGroup";
+import { DesignComponentGroupRemoteModel } from "../../model/groups/SDKDesignComponentGroup";
+import { TokenGroup, TokenGroupRemoteModel } from "../../model/groups/SDKTokenGroup";
+import { Membership, MembershipRemoteModel } from "../../model/membership/SDKMembership";
+import { Source, SourceRemoteModel } from "../../model/support/SDKSource";
+import { Token } from "../../model/tokens/SDKToken";
+import { TokenRemoteModel } from "../../model/tokens/remote/SDKRemoteTokenModel";
+import { DataCore } from "../data/SDKDataCore";
+export declare class AreaRawData {
+    /** Internal: Engine */
+    private dataCore;
+    constructor(dataCore: DataCore);
+    /** Fetches raw data necessary for construction of components */
+    getRawComponentModelData(designSystemId: string, versionId: string): Promise<Array<ComponentRemoteModel>>;
+    /** Fetches raw data necessary for component groups */
+    getRawComponentGroupModelData(designSystemId: string, versionId: string): Promise<Array<ComponentGroupRemoteModel>>;
+    /** Fetches raw data necessary for assets */
+    getRawAssetModelData(designSystemId: string, versionId: string): Promise<Array<DesignComponentRemoteModel>>;
+    /** Fetches raw data necessary for asset groups */
+    getRawAssetGroupModelData(designSystemId: string, versionId: string): Promise<Array<DesignComponentGroupRemoteModel>>;
+    /** Fetches raw data necessary for tokens */
+    getRawTokenModelData(designSystemId: string, versionId: string): Promise<Array<TokenRemoteModel>>;
+    /** Fetches raw data necessary for token groups */
+    getRawTokenGroupModelData(designSystemId: string, versionId: string): Promise<Array<TokenGroupRemoteModel>>;
+    /** Fetches raw data necessary for elements */
+    getRawElementModelData(designSystemId: string, versionId: string): Promise<{
+        propertyValues: Array<ElementPropertyValueRemoteModel>;
+        propertyViews: Array<ElementDataViewRemoteModel>;
+        propertyDefinitions: Array<ElementPropertyRemoteModel>;
+    }>;
+    /** Fetches raw source data */
+    getRawSourceModelData(designSystemId: string): Promise<Array<SourceRemoteModel>>;
+    /** Fetches raw membership */
+    getRawMembershipModelData(userId: string): Promise<Array<MembershipRemoteModel>>;
+    /** Fetches raw design systems */
+    getRawDesignSystemModelData(workspaceId: string): Promise<Array<DesignSystemRemoteModel>>;
+    /** Fetches raw versions */
+    getRawVersionModelData(designSystemId: string): Promise<Array<DesignSystemVersionRemoteModel>>;
+    /** Fetches raw brands */
+    getRawBrandModelData(designSystemId: string, versionId: string): Promise<Array<BrandRemoteModel>>;
+    /** Builds components from raw data */
+    buildComponentsFromRaw(rawData: Array<ComponentRemoteModel>, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>): Array<Component>;
+    /** Build component groups */
+    buildComponentGroupsFromRaw(rawData: Array<ComponentGroupRemoteModel>, components: Array<Component>): Array<ComponentGroup>;
+    /** Builds assets from raw data */
+    buildAssetsFromRaw(rawData: Array<DesignComponentRemoteModel>, sources: Array<Source>): Array<Asset>;
+    /** Build asset groups */
+    buildAssetGroupsFromRaw(rawData: Array<DesignComponentGroupRemoteModel>, assets: Array<Asset>): Array<AssetGroup>;
+    /** Builds tokens from raw data */
+    buildTokensFromRaw(rawData: Array<TokenRemoteModel>, properties: Array<ElementProperty>, propertyValues: Array<ElementPropertyValue>, propertyViews: Array<ElementDataView>, tokenGroups: Array<TokenGroup>, sources: Array<Source>, designSystemId: string, versionId: string): Array<Token>;
+    /** Build token groups */
+    buildTokenGroupsFromRaw(rawData: Array<TokenGroupRemoteModel>): Array<TokenGroup>;
+    /** Builds elements from raw data */
+    buildElementsFromRaw(rawData: {
+        propertyValues: Array<ElementPropertyValueRemoteModel>;
+        propertyViews: Array<ElementDataViewRemoteModel>;
+        propertyDefinitions: Array<ElementPropertyRemoteModel>;
+    }): {
+        propertyValues: Array<ElementPropertyValue>;
+        propertyViews: Array<ElementDataView>;
+        propertyDefinitions: Array<ElementProperty>;
+    };
+    /** Build sources */
+    buildSourcesFromRaw(rawData: Array<SourceRemoteModel>): Array<Source>;
+    /** Builds memberships */
+    buildMembershipsFromRaw(rawData: Array<MembershipRemoteModel>): Array<Membership>;
+    /** Builds design systems */
+    buildDesignSystemsFromRaw(rawData: Array<DesignSystemRemoteModel>): Array<DesignSystem>;
+    /** Builds versions */
+    buildVersionsFromRaw(rawData: Array<DesignSystemVersionRemoteModel>): Array<DesignSystemVersion>;
+    /** Builds brands */
+    buildBrandsFromRaw(rawData: Array<BrandRemoteModel>): Array<Brand>;
+}

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

@@ -1,4 +1,4 @@
-import { DTOFigmaNode } from "@supernova-studio/client";
+import { DTOFigmaNode, DTOFigmaNodeV2 } from "@supernova-studio/client";
 import { DocsImageRef, ResourceAsset, ResourceFont } from "../../exports";
 import { DataCore } from "../data/SDKDataCore";
 import { RemoteVersionIdentifier } from "./SDKRemoteIdentifiers";
@@ -21,6 +21,11 @@ export declare class AreaResources {
      * @returns All font resources in the specified version
      */
     getFigmaFrames(from: RemoteVersionIdentifier): Promise<Array<DTOFigmaNode>>;
+    /** Fetches all Figma frames that were rendered font resources in the version (V2 of the API)
+     * @param from - Remote version to fetch from
+     * @returns All font resources in the specified version
+     */
+    getFigmaFramesV2(from: RemoteVersionIdentifier): Promise<Array<DTOFigmaNodeV2>>;
     /**
      * @param from - Remote version to fetch from
      * @param frameReferenceId  - Unique stable identifier of the Figma frame (Supernova id, not Figma id)

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

@@ -1,6 +1,6 @@
-import { DTOCreateDocumentationGroupInput, DTOCreateDocumentationPageInputV2, DTOCreateDocumentationTabInput, DTODeleteDocumentationGroupInput, DTODeleteDocumentationPageInputV2, DTODeleteDocumentationTabGroupInput, DTODesignElementsDataDiffResponse, DTODocumentationLinkPreviewRequest, DTODocumentationPageAnchor, DTODocumentationPageApprovalStateChangeInput, DTODuplicateDocumentationGroupInput, DTODuplicateDocumentationPageInputV2, DTOFigmaNode, DTOFigmaNodeRenderInput, DTOMoveDocumentationGroupInput, DTOMoveDocumentationPageInputV2, DTOPublishDocumentationRequest, DTORestoreDocumentationGroupInput, DTORestoreDocumentationPageInput, DTOUpdateDocumentationGroupInput, DTOUpdateDocumentationPageInputV2 } from "@supernova-studio/client";
+import { DTOCreateDocumentationGroupInput, DTOCreateDocumentationPageInputV2, DTOCreateDocumentationTabInput, DTODeleteDocumentationGroupInput, DTODeleteDocumentationPageInputV2, DTODeleteDocumentationTabGroupInput, DTODesignElementsDataDiffResponse, DTODocumentationLinkPreviewRequest, DTODocumentationPageAnchor, DTODocumentationPageApprovalStateChangeInput, DTODuplicateDocumentationGroupInput, DTODuplicateDocumentationPageInputV2, DTOElementActionInput, DTOExporterPropertyValueMap, DTOFigmaNode, DTOFigmaNodeRenderIdInput, DTOFigmaNodeRenderInput, DTOFigmaNodeV2, DTOMoveDocumentationGroupInput, DTOMoveDocumentationPageInputV2, DTOPageRedirectCreateBody, DTOPageRedirectUpdateBody, DTOPipelineCreateBody, DTOPipelineUpdateBody, DTOPublishDocumentationRequest, DTORestoreDocumentationGroupInput, DTORestoreDocumentationPageInput, DTOUpdateDocumentationGroupInput, DTOUpdateDocumentationPageInputV2 } from "@supernova-studio/client";
 import { DesignSystemInvite, DesignSystemInviteUpdate, DesignSystemMemberUpdate, DesignSystemPendingMemberInvite, DesignSystemUserInvitation } from "@supernova-studio/model";
-import { DesignSystemAccessMode, DocsBlockDefinition, ExportBuildStatus, ResourceFont, TokenThemeOverrideTranserObject, UserRole } from "../../exports";
+import { DesignSystemAccessMode, DocsBlockDefinition, DocumentationLegacyPage, ExportBuildStatus, ExporterJobDestination, RemoteWorkspaceVersionIdentifier, ResourceFont, TokenThemeOverrideTranserObject, UserRole } from "../../exports";
 import { Acl } from "../../model/acl/SDKAcl";
 import { Asset } from "../../model/assets/SDKAsset";
 import { RenderedAsset } from "../../model/assets/SDKRenderedAsset";
@@ -11,6 +11,7 @@ import { DesignSystemCollection } from "../../model/base/SDKDesignSystemCollecti
 import { DesignSystemContactList } from "../../model/base/SDKDesignSystemContactList";
 import { DesignSystemMemberList } from "../../model/base/SDKDesignSystemMemberList";
 import { DesignSystemVersion, DesignSystemVersionCreate, DesignSystemVersionCreationJob, DesignSystemVersionUpdateModel } from "../../model/base/SDKDesignSystemVersion";
+import { DesignSystemVersionStats } from "../../model/base/SDKDesignSystemVersionStats";
 import { DocumentationLegacy, DocumentationLegacyModel } from "../../model/base/SDKDocumentationLegacy";
 import { Component } from "../../model/components/SDKComponent";
 import { DesignComponent } from "../../model/components/SDKDesignComponent";
@@ -25,7 +26,7 @@ import { DocumentationEnvironment } from "../../model/enums/SDKDocumentationEnvi
 import { TokenType } from "../../model/enums/SDKTokenType";
 import { AzurePersonalAccessTokenConnectionPayload, PersonalAccessTokenConnectionPayload } from "../../model/exporters/SDKConnections";
 import { Exporter, ExporterProvider, NewExporterPayload } from "../../model/exporters/SDKExporter";
-import { NewPipelinePayload, Pipeline, PipelineUpdateModel } from "../../model/exporters/SDKPipeline";
+import { Pipeline } from "../../model/exporters/SDKPipeline";
 import { ExporterCustomBlock } from "../../model/exporters/custom_blocks/SDKExporterCustomBlock";
 import { ExporterCustomBlockVariant } from "../../model/exporters/custom_blocks/SDKExporterCustomBlockVariant";
 import { ExporterConfigurationProperty } from "../../model/exporters/custom_properties/SDKExporterConfigurationProperty";
@@ -70,28 +71,41 @@ import { GitProvidersOrganizations } from "../../model/workspaces/integrations/G
 import { GitProvidersProjects } from "../../model/workspaces/integrations/GitProvidersProjects";
 import { GitProvidersRepositories } from "../../model/workspaces/integrations/GitProvidersRepositories";
 import { ComponentUpdateTransactionData, TokenUpdateTransactionData } from "../areas/SDKAreaBulkOperations";
+import { DocumentationPageContent } from "../areas/SDKAreaImport";
+import { DataCoreReadRequests } from "./requests/SDKDataCoreReadRequests";
 import { RenderedAssetRequestSettings } from "./requests/SDKDataCoreRenderRequests";
 import { DataBridge } from "./SDKDataBridge";
 import { RequestInfo, RequestInit, Response } from "node-fetch";
 export declare class DataCore {
     /** Read part of the network calls */
-    private read;
+    read: DataCoreReadRequests;
     /** Write part of the network calls */
     private write;
     /** Asset generation part of the network calls */
     private render;
+    /** AI */
+    private ai;
     /** Bridge */
     private bridge;
     constructor(bridge: DataBridge);
     /** Only for internal functionality */
     getBridgeInternal(): DataBridge;
     fetch(url: RequestInfo, init?: RequestInit): Promise<Response>;
-    dataThroughCorsProxy(urlToRalay: string): Promise<ArrayBuffer | undefined>;
     bootstrapData(preferredWorkspaceId?: string, preferredDesignSystemId?: string, preferredVersionId?: string, preferredBrandId?: string): Promise<BootstrapData>;
     /** Remote: Get single-use multiplayer token */
     multiplayerToken(room: string | undefined): Promise<{
         token: string;
     }>;
+    /** Remote: Forges code based on user prompt */
+    forgeCode(designSystemId: string, versionId: string, prompt: string, components: Array<any>): Promise<string>;
+    /** Remote: Reforges code based on user prompt */
+    reforgeCode(designSystemId: string, versionId: string, prompt: string, components: Array<any>, existingCode: string): Promise<string>;
+    /** Remote: Proposes title for generated code */
+    proposeTitle(designSystemId: string, versionId: string, firstForgeQuery: string): Promise<string>;
+    /** Remote: Answers question based on the data of design system in natural language */
+    answerQuestion(workspaceId: string, designSystemId: string, versionId: string, persona: "designer" | "developer" | "code", askQuery: string): Promise<string>;
+    /** Remote: Index a design system so it can be asked in natural language */
+    indexDS(workspaceId: string, designSystemId: string, versionId: string): Promise<string>;
     /** Remote: Get information about currently logged in user */
     currentUser(): Promise<User>;
     /** Remote: Get information about a specific user */
@@ -188,6 +202,8 @@ export declare class DataCore {
     }>;
     /** Create a page within documentation */
     createDocumentationPage(designSystemId: string, versionId: string, payload: Omit<DTOCreateDocumentationPageInputV2, "persistentId">): Promise<string>;
+    /** General element action */
+    elementAction(designSystemId: string, versionId: string, data: DTOElementActionInput): Promise<any>;
     /** Update page approval state */
     updateApprovalState(designSystemId: string, versionId: string, payload: DTODocumentationPageApprovalStateChangeInput): Promise<string>;
     /** Update design system's access mode and, if switching to invite-only, also the member list */
@@ -292,12 +308,19 @@ export declare class DataCore {
     /** Render assets as PNG, SVG, PDF, or combinations of it */
     renderedAssets(designSystemId: string, versionId: string, assets: Array<Asset>, groups: Array<AssetGroup>, settings: RenderedAssetRequestSettings): Promise<Array<RenderedAsset>>;
     /** Render Figma frames */
-    renderedFigmaFrames(designSystemId: string, versionId: string, payload: Array<DTOFigmaNodeRenderInput>): Promise<Array<DTOFigmaNode>>;
+    renderedFigmaFrames(designSystemId: string, versionId: string, payload: Array<DTOFigmaNodeRenderIdInput>): Promise<Array<DTOFigmaNode>>;
+    /** Render Figma frames async */
+    renderedFigmaFramesAsync(designSystemId: string, versionId: string, payload: Array<DTOFigmaNodeRenderInput>): Promise<Array<DTOFigmaNodeV2>>;
     /** Fetches all Figma frames that were rendered under specific version
      * @param from - Remote version to fetch from
      * @returns All Figma frames in the specified version (only rendered, for documentation etc.)
      */
     figmaFrames(designSystemId: string, versionId: string): Promise<Array<DTOFigmaNode>>;
+    /** Fetches all Figma frames that were rendered under specific version (V2 of the API)
+     * @param from - Remote version to fetch from
+     * @returns All Figma frames in the specified version (only rendered, for documentation etc.)
+     */
+    figmaFramesV2(designSystemId: string, versionId: string): Promise<Array<DTOFigmaNodeV2>>;
     /** Retrieve the main documentation object through which all docs data can be accessed */
     documentation(workspaceId: string, designSystemId: string, versionId: string): Promise<DocumentationLegacy>;
     getDocumentationStructure(designSystemId: string, versionId: string): Promise<(DocsEntityPageModel | DocsEntityGroupModel)[]>;
@@ -331,9 +354,9 @@ export declare class DataCore {
     /** Delete any multiple resources */
     deleteResources(designSystemId: string, versionId: string, resourceIds: string[]): Promise<void>;
     pipelines(workspaceId: string, designSystemId?: string): Promise<Array<Pipeline>>;
-    createPipeline(workspaceId: string, pipeline: NewPipelinePayload): Promise<Pipeline>;
-    updatePipeline(workspaceId: string, pipelineUpdateModel: PipelineUpdateModel): Promise<void>;
-    runPipeline(workspaceId: string, designSystemVersionId: string, pipelineId: string): Promise<void>;
+    createPipeline(workspaceId: string, payload: DTOPipelineCreateBody): Promise<Pipeline>;
+    updatePipeline(designSystemId: string, pipelineId: string, payload: DTOPipelineUpdateBody): Promise<Pipeline>;
+    runPipeline(workspaceId: string, designSystemVersionId: string, pipelineId: string): Promise<ExportBuild>;
     deletePipeline(workspaceId: string, pipelineId: string): Promise<void>;
     /** Download information about current exporter custom blocks and retrieve them resolved */
     documentationExporterCustomBlocks(designSystemId: string, versionId: string): Promise<Array<ExporterCustomBlock>>;
@@ -365,10 +388,12 @@ export declare class DataCore {
     /** Pull updates for exporter */
     pullLatestExporter(workspaceId: string, exporterId: string): Promise<Exporter>;
     exportBuilds(workspaceId: string, versionId: string): Promise<Array<ExportBuild>>;
-    documentationBuild(workspaceId: string, buildId: string): Promise<ExportBuild>;
+    exportBuild(workspaceId: string, buildId: string): Promise<ExportBuild>;
     /** Download information about documentation builds and retrieve it resolved */
     documentationBuilds(workspaceId: string, versionId: string, environment: DocumentationEnvironment, status?: ExportBuildStatus, createdByUserId?: string, limit?: number): Promise<Array<ExportBuild>>;
     buildLogs(workspaceId: string, buildId: string): Promise<Array<ExportBuildResultLog>>;
+    /** Create a new exporter build */
+    createExporterBuild(workspaceId: string, designSystemId: string, versionId: string, exporterId: string, destinations: ExporterJobDestination, brandId: string | undefined, themePersistentIds: Array<string> | undefined, exporterConfigurationProperties: DTOExporterPropertyValueMap | undefined): Promise<ExportBuild>;
     workspaceProductFeatures(workspaceId: string): Promise<SubscriptionProductFeatures>;
     /** Download information about a single workspace and retrieve it resolved */
     workspace(workspaceId: string): Promise<Workspace>;
@@ -503,6 +528,8 @@ export declare class DataCore {
     deleteDesignSystem(designSystemId: string): Promise<void>;
     /** Download information about a custom domain */
     designSystemCustomDomain(designSystemId: string): Promise<CustomDomain>;
+    /** Get design system stats */
+    designSystemStats(dsId: string, versionId: string, brandId?: string): Promise<DesignSystemVersionStats>;
     /** Download information about a desing system source within a design system design and retrieve it resolved */
     designSystemSource(designSystemId: string, sourceId: string): Promise<Source>;
     /** Download information about all design system sources within a design system design and retrieve it resolved */
@@ -558,4 +585,19 @@ export declare class DataCore {
     readKeyValueStorageData(designSystemId: string, key: string): Promise<string | object | undefined>;
     setKeyValueStorageData(designSystemId: string, key: string, value: string | object): Promise<void>;
     unsetKeyValueStorageData(designSystemId: string, key: string): Promise<void>;
+    getPageRedirects(designSystemId: string): Promise<{
+        path: string;
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        designSystemId: string;
+        pagePersistentId: string;
+    }[]>;
+    createPageRedirect(designSystemId: string, body: DTOPageRedirectCreateBody): Promise<void>;
+    updatePageRedirect(designSystemId: string, redirectId: string, body: DTOPageRedirectUpdateBody): Promise<void>;
+    deletePageRedirect(designSystemId: string, redirectId: string): Promise<void>;
+    /** Import content into a documentation page */
+    importDocumentationPage(designSystemId: string, versionId: string, pageId: string, content: DocumentationPageContent): Promise<void>;
+    /** All pages created within documentation presented as flat structure. Each page contains all data neccessary to render it pre-fetched and resolved for convenience */
+    getDocumentationPagesWithContent(from: RemoteWorkspaceVersionIdentifier): Promise<Array<DocumentationLegacyPage>>;
 }

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

@@ -0,0 +1,15 @@
+import { DataBridge } from "../SDKDataBridge";
+export declare class DataCoreAIRequests {
+    private bridge;
+    constructor(bridge: DataBridge);
+    /** Remote: Forges code based on user prompt */
+    forgeCode(designSystemId: string, versionId: string, prompt: string, components: Array<any>): Promise<string>;
+    /** Remote: Reforges code based on user prompt */
+    reforgeCode(designSystemId: string, versionId: string, prompt: string, components: Array<any>, existingCode: string): Promise<string>;
+    /** Remote: Proposes title for the forged code */
+    proposeTitle(designSystemId: string, versionId: string, firstForgeQuery: string): Promise<string>;
+    /** Remote: Answers question based on the data of design system in natural language */
+    answerQuestion(workspaceId: string, designSystemId: string, versionId: string, persona: "designer" | "developer" | "code", askQuery: string): Promise<string>;
+    /** Remote: Index a design system so it can be asked in natural language */
+    indexDS(workspaceId: string, designSystemId: string, versionId: string): Promise<string>;
+}

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

@@ -1,4 +1,5 @@
-import { DTODesignElementsDataDiffResponse, DTODesignSystem, DTODesignSystemContactsResponse, DTODesignSystemMemberListResponse, DTODocumentationLinkPreviewRequest, DTOFigmaNode, DTOGetDocumentationPageAnchorsResponse, DTOPipeline, DTOTokenCollection } from "@supernova-studio/client";
+import { DTODesignElementsDataDiffResponse, DTODesignSystem, DTODesignSystemContactsResponse, DTODesignSystemMemberListResponse, DTODesignSystemVersionStats, DTODocumentationLinkPreviewRequest, DTOFigmaNode, DTOFigmaNodeV2, DTOGetDocumentationPageAnchorsResponse, DTOPipeline, DTOTokenCollection } from "@supernova-studio/client";
+import { DocumentationLegacyGroupModel } from "../../../exports";
 import { AclRemoteModel } from "../../../model/acl/SDKAcl";
 import { BootstrapDataRemoteModel } from "../../../model/base/SDKBootstrapData";
 import { BrandRemoteModel } from "../../../model/base/SDKBrand";
@@ -50,11 +51,11 @@ import { WorkspaceProductRemoteModel } from "../../../model/workspaces/SDKWorksp
 import { SubscriptionProductFeaturesRemoteModel } from "../../../model/workspaces/SDKWorkspaceProductFeatures";
 import { WorkspaceSSOSettingsRemoteModel } from "../../../model/workspaces/SDKWorkspaceSSOSettings";
 import { WorkspaceSubscriptionRemoteModel } from "../../../model/workspaces/SDKWorkspaceSubscription";
+import { RemoteWorkspaceVersionIdentifier } from "../../areas/SDKRemoteIdentifiers";
 import { DataBridge } from "../SDKDataBridge";
 export declare class DataCoreReadRequests {
     private bridge;
     constructor(bridge: DataBridge);
-    getDataThroughCorsProxy(url: string): Promise<ArrayBuffer | undefined>;
     getRemoteBootstrapData(preferredWorkspaceId?: string, preferredDesignSystemId?: string, preferredVersionId?: string, preferredBrandId?: string): Promise<BootstrapDataRemoteModel>;
     /** Remote: Get information about currently logged in user */
     getRemoteMultiplayerToken(room: string | undefined): Promise<{
@@ -108,6 +109,8 @@ export declare class DataCoreReadRequests {
     getRemoteDesignSystems(workspaceId: string): Promise<Array<DTODesignSystem>>;
     /** Remote: Get custom domain */
     getRemoteCustomDomain(designSystemId: string): Promise<CustomDomainRemoteModel>;
+    /** Remote: Get design system stats */
+    getRemoteDesignSystemStats(dsId: string, versionId: string, brandId?: string): Promise<DTODesignSystemVersionStats>;
     /** Remote: Get a single design source */
     getRemoteSource(designSystemId: string, sourceId: string): Promise<SourceRemoteModel>;
     /** Remote: Get all design sources of a single design system */
@@ -213,6 +216,7 @@ export declare class DataCoreReadRequests {
     /** Remote: Get all property values that were set by the user for each elemen */
     getRemoteElementPropertyValues(designSystemId: string, versionId: string): Promise<ElementPropertyValueRemoteModel[]>;
     getRemoteFigmaFrames(designSystemId: string, versionId: string): Promise<Array<DTOFigmaNode>>;
+    getRemoteFigmaFramesV2(designSystemId: string, versionId: string): Promise<Array<DTOFigmaNodeV2>>;
     getRemoteTokenCollections(designSystemId: string, versionId: string): Promise<Array<DTOTokenCollection>>;
     getRemotePipelines(workspaceId: string, designSystemId?: string): Promise<DTOPipeline[]>;
     getRemoteBuild(workspaceId: string, buildId: string): Promise<ExportBuildModel>;
@@ -230,4 +234,17 @@ export declare class DataCoreReadRequests {
     getImportJob(designSystemId: string, versionId: string, jobId: string): Promise<ImportJobRemoteModel>;
     getKeyValueStorageData(designSystemId: string, keys: Array<string>): Promise<Record<string, string>>;
     getTokenStudioData(designSystemId: string, versionId: string): Promise<object>;
+    getPageRedirects(designSystemId: string): Promise<{
+        path: string;
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        designSystemId: string;
+        pagePersistentId: string;
+    }[]>;
+    /** All pages created within documentation presented as flat structure. Each page contains all data neccessary to render it pre-fetched and resolved for convenience */
+    getDocumentationPagesWithContent(from: RemoteWorkspaceVersionIdentifier): Promise<{
+        pageDetails: Array<DocumentationLegacyPageModel>;
+        groupDetails: Array<DocumentationLegacyGroupModel>;
+    }>;
 }