@supernova-studio/supernova-sdk-beta 1.6.19 → 1.6.21

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

@@ -1,4 +1,4 @@
-import { Brand } from "../../model/base/SDKBrand";
+import { Brand, BrandUpdateModel } from "../../model/base/SDKBrand";
 import { DataCore } from "../data/SDKDataCore";
 import { RemoteBrandIdentifier, RemoteVersionIdentifier } from "./SDKRemoteIdentifiers";
 export declare class AreaBrands {
@@ -15,4 +15,21 @@ export declare class AreaBrands {
      * @returns All brands in the specified version
      */
     getBrand(from: RemoteBrandIdentifier): Promise<Brand>;
+    /** Creates new brand and retrieves the newly created brand object.
+     * @param from - Remote brand to fetch from
+     * @param model - new brand model
+     * @returns Newly created brand object
+     */
+    createBrand(from: RemoteVersionIdentifier, model: BrandUpdateModel): Promise<Brand>;
+    /** Edits brand
+     * @param from - Remote brand to fetch from
+     * @param model - new version model
+     * @returns nothing
+     */
+    editBrand(from: RemoteBrandIdentifier, brand: Brand): Promise<void>;
+    /** Deletes brand
+     * @param from - Remote brand to fetch from
+     * @returns nothing
+     */
+    deleteBrand(from: RemoteBrandIdentifier): Promise<void>;
 }

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

@@ -1,4 +1,4 @@
-import { DesignSystemVersion } from "../../model/base/SDKDesignSystemVersion";
+import { DesignSystemVersion, DesignSystemVersionUpdateModel } from "../../model/base/SDKDesignSystemVersion";
 import { DataCore } from "../data/SDKDataCore";
 import { RemoteVersionIdentifier } from "./SDKRemoteIdentifiers";
 export declare class AreaVersions {
@@ -7,6 +7,25 @@ export declare class AreaVersions {
     constructor(dataCore: DataCore);
     /** Fetches active design system version - the one to which all changes are being written currently. There is always one active version available for any provided design system. */
     getActiveVersion(designSystemId: string): Promise<DesignSystemVersion | null>;
+    /** Creates new version and retrieves the newly created version object.
+     * @param designSystemId - ID of the design system
+     * @param model - new version model
+     * @returns Newly created version object
+     */
+    createVersion(designSystemId: string, model: DesignSystemVersionUpdateModel): Promise<DesignSystemVersion>;
+    /** Edits version
+     * @param designSystemId - ID of the design system
+     * @param versionId - ID of version
+     * @param model - new version model
+     * @returns nothing
+     */
+    editVersion(designSystemId: string, versionId: string, model: DesignSystemVersionUpdateModel): Promise<void>;
+    /** Deletes version
+     * @param designSystemId - ID of the design system
+     * @param versionId - ID of version
+     * @returns nothing
+     */
+    deleteVersion(designSystemId: string, versionId: string): Promise<void>;
     /** Fetches all design system versions of provided design system */
     getVersions(designSystemId: string): Promise<Array<DesignSystemVersion>>;
     /** Fetches design system version by id */

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

@@ -72,6 +72,14 @@ export declare class AreaWorkspaces {
      * @returns Nothing
      */
     updateWorkspaceProfile(workspaceId: string, update: WorkspaceProfileUpdateModel): Promise<void>;
+    /** tests accessibility of IP allowlist settings
+     * @param workspaceId - ID of the workspace
+     * @param ipWhitelistSettings - settings to test
+     * @returns information if workspace is accesible by your IP
+     */
+    testIpWhitelistSettings(workspaceId: string, ipWhitelistSettings: WorkspaceIPWhitelistSettingsUpdateModel): Promise<{
+        accessible: boolean;
+    }>;
     /** Updates workspace onboarding state for a specific workspace
      * @param workspaceId - ID of the workspace
      * @param update - New onboarding state

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

@@ -1,9 +1,9 @@
 import { Acl } from "../../model/acl/SDKAcl";
 import { Asset } from "../../model/assets/SDKAsset";
 import { RenderedAsset } from "../../model/assets/SDKRenderedAsset";
-import { Brand } from "../../model/base/SDKBrand";
+import { Brand, BrandUpdateModel } from "../../model/base/SDKBrand";
 import { DesignSystem } from "../../model/base/SDKDesignSystem";
-import { DesignSystemVersion } from "../../model/base/SDKDesignSystemVersion";
+import { DesignSystemVersion, DesignSystemVersionUpdateModel } from "../../model/base/SDKDesignSystemVersion";
 import { Documentation } from "../../model/base/SDKDocumentation";
 import { Component } from "../../model/components/SDKComponent";
 import { DesignComponent } from "../../model/components/SDKDesignComponent";
@@ -231,6 +231,12 @@ export declare class DataCore {
     /** Download information about a single workspace and retrieve it resolved */
     workspace(workspaceId: string): Promise<Workspace>;
     createWorkspace(name: string, handle?: string): Promise<Workspace>;
+    createVersion(designSystemId: string, model: DesignSystemVersionUpdateModel): Promise<DesignSystemVersion>;
+    editVersion(designSystemId: string, versionId: string, model: DesignSystemVersionUpdateModel): Promise<void>;
+    deleteVersion(designSystemId: string, versionId: string): Promise<void>;
+    createBrand(designSystemId: string, versionId: any, model: BrandUpdateModel): Promise<Brand>;
+    editBrand(designSystemId: string, versionId: string, brandId: string, brand: Brand): Promise<void>;
+    deleteBrand(designSystemId: string, versionId: string, brandId: string): Promise<void>;
     /** Validate that workspace handle is available */
     validateIsWorkspaceHandleAvailable(handle: string): Promise<boolean>;
     workspaceOnboarding(workspaceId: string): Promise<WorkspaceOnboarding>;
@@ -238,6 +244,9 @@ export declare class DataCore {
     workspaceNPMRegistrySettings(workspaceId: string): Promise<WorkspaceNPMRegistrySettings | null>;
     workspaceSSOSettings(workspaceId: string): Promise<WorkspaceSSOSettings | null>;
     updateWorkspaceProfile(workspaceId: string, profile: WorkspaceProfileUpdateModel): Promise<void>;
+    testIpWhitelistSettings(workspaceId: string, ipWhitelistSettings: WorkspaceIPWhitelistSettingsUpdateModel): Promise<{
+        accessible: boolean;
+    }>;
     updateWorkspaceOnboarding(workspaceId: string, state: WorkspaceOnboardingUpdateModel): Promise<void>;
     updateWorkspaceAvatar(workspaceId: string, avatar: File): Promise<void>;
     updateWorkspaceSSOSettings(workspaceId: string, ssoSettings: WorkspaceSSOSettingsUpdateModel): Promise<void>;

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

@@ -18,6 +18,8 @@ import { WorkspaceOnboardingUpdateModel } from "../../../model/workspaces/SDKWor
 import { WorkspaceProfileUpdateModel } from "../../../model/workspaces/SDKWorkspaceProfile";
 import { WorkspaceSSOSettingsUpdateModel } from "../../../model/workspaces/SDKWorkspaceSSOSettings";
 import { DataBridge } from "../SDKDataBridge";
+import { Brand, BrandRemoteModel, BrandUpdateModel } from "model/base/SDKBrand";
+import { DesignSystemVersionRemoteModel, DesignSystemVersionUpdateModel } from "model/base/SDKDesignSystemVersion";
 export declare class DataCoreWriteRequests {
     private bridge;
     constructor(bridge: DataBridge);
@@ -35,8 +37,23 @@ export declare class DataCoreWriteRequests {
     logoutRemoteCurrentUser(): Promise<void>;
     /** Remote: Creates a new workspace */
     createRemoteWorkspace(name: string, handle?: string): Promise<WorkspaceRemoteModel>;
+    /** Remote: Creates a new version */
+    createRemoteVersion(designSystemId: string, model: DesignSystemVersionUpdateModel): Promise<DesignSystemVersionRemoteModel>;
+    /** Remote: Updates a version */
+    updateRemoteVersion(designSystemId: string, versionId: string, model: DesignSystemVersionUpdateModel): Promise<void>;
+    /** Remote: Deletes a version */
+    deleteRemoteVersion(designSystemId: string, versionId: string): Promise<void>;
+    /** Remote: Creates a new brand */
+    createRemoteBrand(designSystemId: string, versionId: string, model: BrandUpdateModel): Promise<BrandRemoteModel>;
+    /** Remote: Updates a brand */
+    updateRemoteBrand(designSystemId: string, versionId: string, brandId: string, brand: Brand): Promise<void>;
+    /** Remote: Deletes a brand */
+    deleteRemoteBrand(designSystemId: string, versionId: string, brandId: string): Promise<void>;
     /** Remote: Updates a workspace profile */
     updateRemoteWorkspaceProfile(workspaceId: string, profile: WorkspaceProfileUpdateModel): Promise<void>;
+    testIpWhitelistSettings(workspaceId: string, ipWhitelistSettings: WorkspaceIPWhitelistSettingsUpdateModel): Promise<{
+        accessible: boolean;
+    }>;
     /** Remote: Updates a workspace avatar */
     updateRemoteWorkspaceAvatar(workspaceId: string, avatar: File): Promise<void>;
     /** Remote: Updates a workspace onboarding */

package/build/sdk-typescript/src/exports.d.ts

@@ -115,6 +115,7 @@ export { WorkspaceSubscriptionStatus } from "./model/enums/SDKWorkspaceSubscript
 export { WorkspaceSubscriptionStatusInternal } from "./model/enums/SDKWorkspaceSubscriptionStatusInternal";
 export { WorkspaceNPMRegistryAuthType } from "./model/enums/SDKWorkspaceNPMRegistryAuthType";
 export { WorkspaceNPMRegistryType } from "./model/enums/SDKWorkspaceNPMRegistryType";
+export { SourceType } from "./model/enums/SDKSourceType";
 export { DesignComponentOrigin } from "./model/support/SDKDesignComponentOrigin";
 export { Source } from "./model/support/SDKSource";
 export { Size } from "./model/support/SDKSize";

package/build/sdk-typescript/src/model/base/SDKBrand.d.ts

@@ -4,9 +4,13 @@ export type BrandRemoteModel = {
     persistentId: string;
     meta: {
         name: string;
-        description: string;
+        description?: string;
     };
 };
+export type BrandUpdateModel = {
+    name: string;
+    description?: string;
+};
 type BrandTransportModel = Pick<Brand, "idInVersion" | "id" | "designSystemVersionId" | "name" | "description">;
 export declare class Brand {
     /** Unique identifier of the brand in this specific version */

package/build/sdk-typescript/src/model/base/SDKDesignSystemVersion.d.ts

@@ -10,6 +10,11 @@ export type DesignSystemVersionRemoteModel = {
     createdAt: string;
     changeLog: string;
 };
+export type DesignSystemVersionUpdateModel = {
+    version: string;
+    name?: string;
+    description?: string;
+};
 export type DesignSystemVersionTransportModel = Pick<DesignSystemVersion, "id" | "designSystemId" | "isReadonly" | "name" | "description" | "version" | "changeLog"> & {
     createdAt: string;
 };

package/build/sdk-typescript/src/model/support/SDKSource.d.ts

@@ -9,67 +9,29 @@ export type SourceRemoteModel = {
         fileId: string;
         lastImportedAt?: string;
     };
-    cloud?: {
-        fileId: string;
-        autoImportMode: "Never" | "Hourly";
-        fileThumbnailUrl?: string;
-        lastUpdatesCheckedAt?: string;
-        lastImportedVersion?: {
-            id: string;
-            created_at: string;
-            label?: string;
-            description: string;
-        };
-        lastImportedAt?: string;
-        lastImportResult?: {
-            sourceId: string;
-            brandId: string;
-            tokensCreated: number;
-            tokensUpdated: number;
-            tokensDeleted: number;
-            componentsCreated: number;
-            componentsUpdated: number;
-            componentsDeleted: number;
-            componentAssetsCreated: number;
-            componentAssetsUpdated: number;
-            componentAssetsDeleted: number;
-            isFailed: boolean;
-            versionId: string;
-            fileSize?: number;
-        };
-        lastImportFramesResult?: {
-            sourceId: string;
-            isFailed: string;
-            error?: string;
-            assetsInFile?: {
-                frames: number;
-                components: number;
-            };
-            invalidReferencesCount?: number;
-        };
-        ownerId: string;
-        ownerUserName: string;
-        state: string;
-    };
+    cloud?: SourceRemoteModelCloud;
+    tokenStudio?: SourceRemoteModelTokensStudio;
+    scope: SourceScope;
 };
-export type SourceTransportModel = Pick<Source, "type" | "id" | "fileName" | "fileId" | "autoImportMode" | "fileThumbnailUrl" | "lastImportedVersion" | "lastImportResult" | "lastImportFramesResult" | "ownerId" | "ownerUserName" | "state" | "linkType" | "brandId"> & {
-    lastUpdatesCheckedAt?: string;
-    lastImportedAt?: string;
+export type SourceScope = {
+    tokens: boolean;
+    components: boolean;
+    assets: boolean;
+    documentationFrames: boolean;
 };
-export declare class Source {
-    type: SourceType;
-    id: string;
-    fileName: string | null;
-    fileId: string | null;
-    autoImportMode: "Never" | "Hourly" | null;
-    fileThumbnailUrl: string | null;
-    lastImportedVersion: {
+export type SourceRemoteModelCloud = {
+    fileId?: string;
+    autoImportMode: "Never" | "Hourly";
+    fileThumbnailUrl?: string;
+    lastUpdatesCheckedAt?: string;
+    lastImportedVersion?: {
         id: string;
         created_at: string;
-        label: string | null;
+        label?: string;
         description: string;
-    } | null;
-    lastImportResult: {
+    };
+    lastImportedAt?: string;
+    lastImportResult?: {
         sourceId: string;
         brandId: string;
         tokensCreated: number;
@@ -83,30 +45,74 @@ export declare class Source {
         componentAssetsDeleted: number;
         isFailed: boolean;
         versionId: string;
-        fileSize: number | null;
-    } | null;
-    lastImportFramesResult: {
+        fileSize?: number;
+        warnings?: Array<{
+            warningType: string;
+        }>;
+    };
+    lastImportFramesResult?: {
         sourceId: string;
         isFailed: string;
-        error: string | null;
-        assetsInFile: {
+        error?: string;
+        assetsInFile?: {
             frames: number;
             components: number;
-        } | null;
-        invalidReferencesCount: number | null;
-    } | null;
-    ownerId: string | null;
-    ownerUserName: string | null;
-    state: string | null;
+        };
+        invalidReferencesCount?: number;
+    };
+    ownerId: string;
+    ownerUserName: string;
+    state: string;
+};
+export type SourceRemoteModelTokensStudio = {
+    connectionName: string;
+    lastImportedAt?: string;
+    settings?: {
+        dryRun?: boolean;
+        verbose?: boolean;
+        preciseCopy?: boolean;
+    };
+    lastImportedResults?: Array<{
+        mapping: {
+            tokensTheme?: string;
+            tokenSets?: string[];
+            supernovaBrand?: string;
+            supernovaTheme?: string;
+        };
+        tokensCreated: number;
+        tokensUpdated: number;
+        tokensDeleted: number;
+        isFailed: boolean;
+        error?: string;
+        themeId?: string;
+    }>;
+};
+export type SourceModelTokenStudio = Omit<SourceRemoteModelTokensStudio, "lastUpdatesCheckedAt" | "lastImportedAt"> & {
+    lastUpdatesCheckedAt?: Date;
+    lastImportedAt?: Date;
+};
+export type SourceModelCloud = Omit<SourceRemoteModelCloud, "lastUpdatesCheckedAt" | "lastImportedAt"> & {
+    lastUpdatesCheckedAt?: Date;
+    lastImportedAt?: Date;
+};
+export type SourceTransportModel = Pick<Source, "type" | "id" | "fileName" | "linkType" | "brandId" | "scope"> & {
+    cloud?: SourceRemoteModelCloud | null;
+};
+export declare class Source {
+    type: SourceType;
+    id: string;
+    fileName: string | null;
     linkType: "Design" | "Frames";
     brandId: string | null;
-    lastUpdatesCheckedAt: Date | null;
-    lastImportedAt: Date | null;
+    cloud: SourceModelCloud | null;
+    tokenStudio?: SourceModelTokenStudio | null;
+    scope: SourceScope;
+    get hasError(): boolean;
     constructor(model: SourceRemoteModel);
     /** Constructs representation that can be used to write full object to remote */
     toRemote(): SourceRemoteModel;
     /** Constructs representation that can be used to transport the instantiated object as JSON, for example for SSR <> Client use-cases. Reconstruct to class instance using `fromTransport` */
     toTransport(): SourceTransportModel;
     /** Reconstructs class from the transport model */
-    static fromTransport(model: SourceTransportModel): Source;
+    static fromTransport(model: SourceTransportModel): SourceRemoteModel;
 }

package/build/sdk-typescript/src/model/support/SDKTokenOrigin.d.ts

@@ -7,5 +7,7 @@ export declare class TokenOrigin {
     id: string | null;
     name: string | null;
     sourceId: string | null;
+    referenceOriginId?: string | null;
+    referencePersistentId?: string | null;
     constructor(model: TokenOriginModel);
 }

package/build/sdk-typescript/src/model/tokens/SDKTokenValue.d.ts

@@ -198,3 +198,4 @@ export declare const checkSingleReferencedTokenById: (token: AnyToken, candidate
 export declare const replaceReferencedTokenIds: (token: AnyToken, currentId: string, newId: string, allTokens: Map<string, Token>) => void;
 export declare const replaceReferencedToken: (token: Token, existingToken: AnyToken, newToken: AnyToken) => void;
 export declare const replaceReferencedTokenByIds: (token: Token, existingTokenId: string, newTokenId: string) => void;
+export declare const replaceOriginReferencePersistentIdByIds: (token: Token, existingTokenId: string, newTokenId: string) => void;

package/build/sdk-typescript/src/model/tokens/remote/SDKRemoteTokenModel.d.ts

@@ -14,6 +14,8 @@ export type TokenRemoteModel = {
         id?: string;
         name?: string;
         sourceId?: string;
+        referenceOriginId?: string;
+        referencePersistentId?: string;
     };
     data: {
         aliasTo?: string;

package/build/sdk-typescript/src/model/users/SDKUser.d.ts

@@ -4,10 +4,21 @@ export type UserRemoteModel = {
     email: string;
     createdAt: string;
     profile: UserProfileRemoteModel;
+    linkedIntegrations?: LinkedIntegrations;
+};
+export type LinkedIntegrations = {
+    figma?: UserLinkedIntegration;
+};
+type UserLinkedIntegration = {
+    id: string;
+    email?: string;
+    handle?: string;
+    avatarUrl?: string;
 };
 export type UserTransportModel = Pick<User, "id" | "email"> & {
     createdAt: string;
     profile: UserProfileTransportModel;
+    linkedIntegrations?: LinkedIntegrations;
 };
 export type UserAvatarUpdateModel = {
     avatar?: string;
@@ -21,6 +32,8 @@ export declare class User {
     createdAt: Date | null;
     /** User profile */
     profile: UserProfile;
+    /** Linked integrations */
+    linkedIntegrations: LinkedIntegrations | null;
     constructor(model: UserRemoteModel);
     /** Constructs representation that can be used to write full object to remote */
     toRemote(): UserRemoteModel;
@@ -29,3 +42,4 @@ export declare class User {
     /** Reconstructs class from the transport model */
     static fromTransport(model: UserTransportModel): User;
 }
+export {};

package/build/sdk-typescript/src/model/workspaces/SDKWorkspaceIPWhitelistSettings.d.ts

@@ -1,6 +1,6 @@
 export type IPWhitelistEntry = {
     isEnabled: boolean;
-    name: string;
+    name?: string;
     range: string;
 };
 export type WorkspaceIPWhitelistSettingsRemoteModel = {

package/build/sdk-typescript/src/tests/Enterprise/PluginFigmaTokens.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/build/sdk-typescript/src/tools/design-tokens/utilities/SDKDTJSONConverter.d.ts

@@ -17,6 +17,7 @@ export declare class DTJSONConverter {
     referenceResolver: DTTokenReferenceResolver;
     constructor(versionId: string, mapping: DTPluginToSupernovaMapPack);
     convertNodesToTokens(nodes: Array<DTParsedNode>, brand: Brand): Array<DTProcessedTokenNode>;
+    private remapRootNodeKey;
     private remapRootNodeKeys;
     private convertNodesToTokensForSupportedNodeTypes;
     private convertAtomicNode;

package/build/sdk-typescript/src/tools/design-tokens/utilities/SDKDTTokenReferenceResolver.d.ts

@@ -12,6 +12,7 @@ export declare class DTTokenReferenceResolver {
     unmappedValues(): Array<DTProcessedTokenNode>;
     tokensOfType(type: TokenType): Array<Token>;
     lookupReferencedToken(reference: string): Token | undefined;
+    lookupReferencedNode(reference: string): DTProcessedTokenNode | undefined;
     lookupAllReferencedTokens(reference: string): Array<{
         token: Token;
         key: string;