@supernova-studio/supernova-sdk-beta 2.2.6 → 2.2.12

package/build/sdk-typescript/src/model/threads/SDKThreadMessageList.d.ts

@@ -0,0 +1,10 @@
+import { DTOThreadMessageListResponse } from "@supernova-studio/client";
+import { ThreadMessage } from "./SDKThreadMessage";
+import { ThreadMessageReaction } from "./SDKThreadMessageReaction";
+export declare class ThreadMessageList {
+    messages: Array<ThreadMessage>;
+    reactions: Array<ThreadMessageReaction>;
+    lastSeenMessageId?: string;
+    constructor(model: DTOThreadMessageListResponse);
+    toRemote(): DTOThreadMessageListResponse;
+}

package/build/sdk-typescript/src/model/threads/SDKThreadMessageReaction.d.ts

@@ -0,0 +1,9 @@
+import { DTOThreadReaction } from "@supernova-studio/client";
+export declare class ThreadMessageReaction {
+    messageId: string;
+    userId: string;
+    emoji: string;
+    createdAt: Date;
+    constructor(model: DTOThreadReaction);
+    toRemote(): DTOThreadReaction;
+}

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

@@ -75,4 +75,4 @@ export declare class ZIndexToken extends DimensionCategoryToken<ZIndexTokenValue
     tokenType: TokenType.zIndex;
 }
 export type AnyDimensionToken = DimensionToken | SizeToken | SpaceToken | OpacityToken | FontSizeToken | LineHeightToken | LetterSpacingToken | ParagraphSpacingToken | BorderWidthToken | RadiusToken | DurationToken | ZIndexToken;
-export declare const resolveDimension: <TK extends TokenType.radius | TokenType.borderWidth | TokenType.duration | TokenType.fontSize | TokenType.dimension | TokenType.letterSpacing | TokenType.lineHeight | TokenType.opacity | TokenType.paragraphSpacing | TokenType.size | TokenType.space | TokenType.zIndex>(type: TK) => TokenClassTypeMapToken[TK];
+export declare const resolveDimension: <TK extends DimensionTokenType>(type: TK) => TokenClassTypeMapToken[TK];

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

@@ -32,4 +32,4 @@ export declare class FontWeightToken extends StringCategoryToken<FontWeightToken
     tokenType: TokenType.fontWeight;
 }
 export type AnyStringToken = StringToken | ProductCopyToken | FontFamilyToken | FontWeightToken;
-export declare const resolveString: <TK extends TokenType.fontFamily | TokenType.fontWeight | TokenType.string | TokenType.productCopy>(type: TK) => TokenClassTypeMapToken[TK];
+export declare const resolveString: <TK extends StringTokenType>(type: TK) => TokenClassTypeMapToken[TK];

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

@@ -33,4 +33,5 @@ export declare class Token implements TokenValue {
     setSortOrder(order: number): void;
     toBaseWriteObject(): TokenRemoteModel;
     toWriteObject(): TokenRemoteModel;
+    copyWith<K extends "parentGroupId">(key: K, value: this[K]): this;
 }

package/build/sdk-typescript/src/model/trail-events/SDKTrailEvent.d.ts

@@ -0,0 +1,17 @@
+import type { DTOTrailEvent, DTOTrailEventCreate, DTOTrailEventListInput, DTOTrailEventListResponse, DTOTrailEventType } from "@supernova-studio/client";
+export type TrailEventRemoteModel = DTOTrailEvent;
+export type TrailEventCreateInput = DTOTrailEventCreate;
+export type TrailEventListInput = DTOTrailEventListInput;
+export type TrailEventListResponse = DTOTrailEventListResponse;
+export type TrailEventType = DTOTrailEventType;
+export declare class TrailEvent {
+    id: string;
+    projectId: string;
+    type: TrailEventType;
+    createdAt: Date;
+    updatedAt: Date | undefined;
+    userId: string;
+    payload: DTOTrailEvent["payload"];
+    constructor(model: DTOTrailEvent);
+    toRemote(): DTOTrailEvent;
+}

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

@@ -1,5 +1,7 @@
+import { DTOUserEmailSettings, DTOUserUpdatePayload } from "@supernova-studio/client";
 import { UserProfile, UserProfileRemoteModel, UserProfileTransportModel, UserThemeRemoteModel } from "./SDKUserProfile";
 type UserSource = "SignUp" | "Invite" | "SSO";
+export type UserUpdateModel = DTOUserUpdatePayload;
 export type UserRemoteModel = {
     id: string;
     email: string;
@@ -8,6 +10,7 @@ export type UserRemoteModel = {
     profile: UserProfileRemoteModel;
     theme?: UserThemeRemoteModel;
     linkedIntegrations?: LinkedIntegrations;
+    emailSettings?: UserEmailSettingsRemoteModel;
 };
 export type LinkedIntegrations = {
     figma?: UserLinkedIntegration;
@@ -24,10 +27,12 @@ type UserLinkedIntegration = {
     avatarUrl?: string;
     customUrl?: string;
 };
+export type UserEmailSettingsRemoteModel = DTOUserEmailSettings;
 export type UserTransportModel = Pick<User, "id" | "email" | "source"> & {
     createdAt: string;
     profile: UserProfileTransportModel;
     linkedIntegrations?: LinkedIntegrations;
+    emailSettings?: UserEmailSettingsRemoteModel;
 };
 export type UserAvatarUpdateModel = {
     avatar?: string;
@@ -45,6 +50,8 @@ export declare class User {
     source: UserSource | null;
     /** Linked integrations */
     linkedIntegrations: LinkedIntegrations | null;
+    /** Email settings */
+    emailSettings: UserEmailSettingsRemoteModel | null;
     constructor(model: UserRemoteModel);
     /** Constructs representation that can be used to write full object to remote */
     toRemote(): UserRemoteModel;

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

@@ -1,9 +1,12 @@
 import { UserRole } from "../enums/SDKUserRole";
+import { WorkspaceSeatType } from "../enums/SDKWorkspaceSeatType";
 import { User, UserRemoteModel } from "./SDKUser";
 export type UserMembershipRemoteModel = {
     user: UserRemoteModel;
     role: UserRole;
     effectiveRole: UserRole;
+    seatType: WorkspaceSeatType;
+    effectiveSeatType: WorkspaceSeatType;
 };
 export declare class UserMembership {
     /** Full user object */
@@ -15,6 +18,15 @@ export declare class UserMembership {
      * when the workspace is suspended etc.
      */
     effectiveRole: UserRole;
+    /** Seat of the user in the workspace. */
+    seatType: WorkspaceSeatType;
+    /**
+     * Effective seat of the user in the workspace, which can be different from the regular seat
+     * when the workspace is suspended etc.
+     */
+    effectiveSeatType: WorkspaceSeatType;
+    /** Whether the user is deactivated and can no longer access the workspace. */
+    isDeactivated: boolean;
     constructor(model: UserMembershipRemoteModel);
     /** Constructs representation that can be used to write full object to remote */
     toRemote(): UserMembershipRemoteModel;

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

@@ -1,17 +1,20 @@
-import { WorkspaceProfile, WorkspaceProfileRemoteModel, WorkspaceProfileTransportModel } from "./SDKWorkspaceProfile";
-export type WorkspaceRemoteModel = {
-    id: string;
-    profile: WorkspaceProfileRemoteModel;
-};
-export type WorkspaceTransportModel = {
-    id: string;
-    profile: WorkspaceProfileTransportModel;
-};
+import { DTOWorkspace } from "@supernova-studio/client";
+import { WorkspaceProfile } from "./SDKWorkspaceProfile";
+export type WorkspaceRemoteModel = Pick<DTOWorkspace, "id" | "profile" | "aiFeaturesEnabled" | "aiAskFeaturesEnabled" | "aiCustomInstruction" | "projectsEnabled">;
+export type WorkspaceTransportModel = WorkspaceRemoteModel;
 export declare class Workspace {
     /** Unique identifier of the workspace */
     id: string;
     /** Workspace profile with all information about billing, workspace, avatars etc. */
     profile: WorkspaceProfile;
+    /** Whether AI features are enabled for the workspace */
+    aiFeaturesEnabled: boolean;
+    /** Whether AI Ask features (Portal) are enabled for the workspace */
+    aiAskFeaturesEnabled: boolean;
+    /** Whether AI Projects features (Portal) are enabled for the workspace */
+    projectsEnabled: boolean;
+    /** Custom instructions for AI */
+    aiCustomInstruction: string | null;
     constructor(model: WorkspaceRemoteModel);
     /** Constructs representation that can be used to write full object to remote */
     toRemote(): WorkspaceRemoteModel;

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

@@ -1,13 +1,7 @@
+import { DTOWorkspaceInvitation } from "@supernova-studio/client";
 import { UserRole } from "../enums/SDKUserRole";
-export type WorkspaceInvitationRemoteModel = {
-    id: string;
-    email: string;
-    createdAt: string;
-    resentAt?: string;
-    role: UserRole;
-    workspaceId: string;
-    invitedBy: string;
-};
+import { WorkspaceSeatType } from "../enums/SDKWorkspaceSeatType";
+export type WorkspaceInvitationRemoteModel = DTOWorkspaceInvitation;
 export type WorkspaceInvitationTransportModel = WorkspaceInvitationRemoteModel;
 export type WorkspaceInvitationUpdateModel = {
     email: string;
@@ -24,6 +18,20 @@ export declare class WorkspaceInvitation {
     resentAt: Date | null;
     /** Role assigned to the user being invited */
     role: UserRole;
+    /**
+     * Effective role of the user in the workspace, which can be different from the regular role
+     * e.g., when the workspace is suspended.
+     */
+    effectiveRole: UserRole;
+    /** Seat assigned to the user being invited */
+    seatType: WorkspaceSeatType;
+    /**
+     * Effective seat type of the invitation in the workspace, which can be different from the regular role,
+     * e.g., when the workspace is suspended.
+     */
+    effectiveSeatType: WorkspaceSeatType;
+    /** Whether the invitation is deactivated and can no longer access the workspace. */
+    isDeactivated: boolean;
     /** ID of the workspace associated with the invitation */
     workspaceId: string;
     /** User who sent the invitation */

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

@@ -0,0 +1,12 @@
+import { DTOPortalSettings, DTOPortalSettingsTheme, DTOPortalSettingsSidebar, DTOPortalSettingsUpdatePayload } from "@supernova-studio/client";
+export type PortalSettingsRemoteModel = DTOPortalSettings;
+export type PortalSettingsUpdateRemoteModel = DTOPortalSettingsUpdatePayload;
+export declare class PortalSettings {
+    id: string;
+    workspaceId: string;
+    enabledDesignSystemIds: Array<string>;
+    enabledBrandPersistentIds: Array<string>;
+    theme?: DTOPortalSettingsTheme;
+    sidebar?: DTOPortalSettingsSidebar;
+    constructor(model: DTOPortalSettings);
+}

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

@@ -9,8 +9,8 @@ export type ProductFeature = {
 export type SubscriptionProductFeaturesRemoteModel = {
     free: ProductFeature;
     team: ProductFeature;
-    team_test: ProductFeature;
     company: ProductFeature;
+    pro: ProductFeature;
     enterprise: ProductFeature;
 };
 export type FeaturePermissionResolution = {
@@ -25,8 +25,8 @@ export type FeaturePermissionResolution = {
 export declare class SubscriptionProductFeatures {
     free: ProductFeature;
     team: ProductFeature;
-    team_test: ProductFeature;
     company: ProductFeature;
+    pro: ProductFeature;
     enterprise: ProductFeature;
     constructor(model: SubscriptionProductFeaturesRemoteModel);
 }

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

@@ -1,3 +1,4 @@
+import { WorkspaceSeatType } from "../enums/SDKWorkspaceSeatType";
 import { WorkspaceSubscriptionPlanInterval } from "../enums/SDKWorkspaceSubscriptionPlanInterval";
 export type WorkspaceProductPriceRemoteModel = {
     stripePriceId: string;
@@ -7,9 +8,11 @@ export type WorkspaceProductPriceRemoteModel = {
     stripeProductAdditionalFeatures: Array<string>;
     active: boolean;
     amount: number;
+    seatType?: WorkspaceSeatType;
     interval: WorkspaceSubscriptionPlanInterval;
     isPricePerCreator: boolean;
     legacyVersion?: string;
+    monthlyCreditGrant?: number;
 };
 export type WorkspaceProductPriceTransportModel = WorkspaceProductPriceRemoteModel;
 export declare class WorkspaceProductPrice {
@@ -27,12 +30,16 @@ export declare class WorkspaceProductPrice {
     active: boolean;
     /** The amount to be charged for the product, in the smallest currency unit (e.g., cents) */
     amount: number;
+    /** The matching seat (builder or full). Omitted for free plans */
+    seatType?: WorkspaceSeatType;
     /** The billing interval (e.g., monthly, yearly) */
     interval: WorkspaceSubscriptionPlanInterval;
     /** Indicates whether the price is per creator (self-serve) or not */
     isPricePerCreator: boolean;
     /** An optional legacy version identifier, if applicable */
     legacyVersion?: string | null;
+    /** The number of credits to be granted per month by this price */
+    monthlyCreditGrant: number | null;
     constructor(model: WorkspaceProductPriceRemoteModel);
     toRemote(): WorkspaceProductPriceRemoteModel;
     toTransport(): WorkspaceProductPriceTransportModel;

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

@@ -1,27 +1,5 @@
-export type WorkspaceProfileRemoteModel = {
-    name: string;
-    color: string;
-    billingDetails?: WorkspaceProfileBillingDetailsRemoteModel;
-    avatar?: string;
-};
-export type WorkspaceProfileBillingDetailsRemoteModel = {
-    firstName?: string;
-    lastName?: string;
-    email?: string;
-    companyName?: string;
-    companyId?: string;
-    notes?: string;
-    vat?: string;
-    address?: WorkspaceProfileAddressRemoteModel;
-};
-export type WorkspaceProfileAddressRemoteModel = {
-    postal?: string;
-    street1?: string;
-    street2?: string;
-    city?: string;
-    country?: string;
-    state?: string;
-};
+import type { DTOWorkspaceProfile } from "@supernova-studio/client";
+export type WorkspaceProfileRemoteModel = DTOWorkspaceProfile;
 export type WorkspaceProfileTransportModel = WorkspaceProfileRemoteModel;
 export type WorkspaceProfileUpdateModel = {
     name: string;
@@ -34,10 +12,13 @@ export declare class WorkspaceProfile {
     color: string;
     /** Workspace avatar URL */
     avatar: string | null;
+    /**
+     * @deprecated
+     * Not used anymore, will be removed in the future.
+     * */
+    handle: string;
     /** Workspace billing details object */
     billingDetails: {
-        firstName: string | null;
-        lastName: string | null;
         address: {
             postal: string | null;
             street1: string | null;
@@ -51,6 +32,7 @@ export declare class WorkspaceProfile {
         companyId: string | null;
         notes: string | null;
         vat: string | null;
+        poNumber: string | null;
     } | null;
     constructor(model: WorkspaceProfileRemoteModel);
     /** Constructs directly manipulable update object for workspace profile */

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

@@ -1,56 +1,53 @@
+import { DTOSubscriptionResponse, DTOSubscriptionUpdateInput, DTOSubscriptionUpdatePreview } from "@supernova-studio/client";
 import { WorkspaceSubscriptionPlanInterval } from "../enums/SDKWorkspaceSubscriptionPlanInterval";
 import { WorkspaceSubscriptionProductCode } from "../enums/SDKWorkspaceSubscriptionProduct";
 import { WorkspaceSubscriptionStatus } from "../enums/SDKWorkspaceSubscriptionStatus";
 import { ProductFeature } from "./SDKWorkspaceProductFeatures";
-export type WorkspaceSubscriptionRemoteModel = {
-    status: WorkspaceSubscriptionStatus;
-    seatLimit: number;
-    seats: number;
-    product: WorkspaceSubscriptionProductCode;
-    planInterval: WorkspaceSubscriptionPlanInterval;
-    planPriceId: string;
-    stripeCustomerId?: string;
-    stripeSubscriptionId?: string;
-    card?: WorkspaceSubscriptionCardRemoteModel;
-    currentPeriodStart?: string;
-    currentPeriodEnd?: string;
-    amount: number;
-    stripeProductDescription: string;
-    subscriptionStatusUpdatedAt?: string;
-    legacyVersion?: number;
-    isPricePerCreator: boolean;
-    stripeProductFeatures: Array<string>;
-    stripeProductAdditionalFeatures: Array<string>;
-    featuresSummary: ProductFeature;
-};
-export type WorkspaceSubscriptionCardRemoteModel = {
-    last4?: string;
-    expiryMonth?: string;
-    expiryYear?: string;
-    brand?: string;
-};
+export type WorkspaceSubscriptionRemoteModel = DTOSubscriptionResponse;
 export type WorkspaceSubscriptionTransportModel = WorkspaceSubscriptionRemoteModel;
-export type WorkspaceSubscriptionUpdateModel = {
+/**
+ * @deprecated use `WorkspaceSubscriptionUpdateModel`
+ * TODO (Seva): remove
+ */
+export type WorkspaceSubscriptionUpdateModelLegacy = {
     priceId: string;
     numberOfSeats: number;
 };
+export type WorkspaceSubscriptionUpdateModel = DTOSubscriptionUpdateInput;
+export type WorkspaceSubscriptionUpdatePreviewModel = DTOSubscriptionUpdatePreview;
 export declare class WorkspaceSubscription {
     /** Main status of the workspace subscription */
     status: WorkspaceSubscriptionStatus;
-    /** Maximum seats workspace can have assigned. This limits number of editors+ only, visitors are always unlimited */
-    seatLimit: number;
-    /** Current amount of seats workspace uses */
-    seats: number;
+    /** Maximum number of Builders seats */
+    builderSeatLimit: number;
+    /** Current number of Builder seats the workspace uses */
+    builderSeats: number;
+    /** Maximum number of DSM (Full) seats */
+    fullSeatLimit: number;
+    /** Current number of DSM (Full) seats the workspace uses */
+    fullSeats: number;
     /** Subscription tier */
     product: WorkspaceSubscriptionProductCode;
     /** Subscription cycle interval */
     planInterval: WorkspaceSubscriptionPlanInterval;
-    /** Subscription price id */
-    planPriceId: string;
+    /**
+     * Stripe price id for a Full seat.
+     */
+    fullSeatPriceId: string;
+    /**
+     * Stripe price id for a Builder seat.
+     * Can be optional if no Builder subscription was created on Stripe (e.g., on legacy plans).
+     */
+    builderSeatPriceId: string | null;
     /** Starting date of the current billing cycle */
     currentPeriodStart: Date | null;
     /** Ending date of the current billing cycle */
     currentPeriodEnd: Date | null;
+    /**
+     * Only available if the subscription is still active but scheduled to be canceled.
+     * Also used to check for this particular status, as we are still getting `status: active` in that case.
+     */
+    cancelAt: Date | null;
     /** Stripe customer ID. Note: visible only for Owner and Admin role */
     stripeCustomerId: string | null;
     /** Stripe subscription ID. Note: visible only for Owner and Admin role */
@@ -65,11 +62,11 @@ export declare class WorkspaceSubscription {
     /** Price of the subscription, in the smallest currency unit (e.g., cents) */
     amount: number;
     /** Product description */
-    stripeProductDescription: string;
+    stripeProductDescription: string | null;
     /** Date when subscription status was updated */
     subscriptionStatusUpdatedAt: Date | null;
     /** Product version when it is legacy */
-    legacyVersion: number | null;
+    legacyVersion: string | null;
     /** Indicates whether the price is per creator (self-serve) or not */
     isPricePerCreator: boolean;
     /** List of features available to this product price */
@@ -78,8 +75,48 @@ export declare class WorkspaceSubscription {
     stripeProductAdditionalFeatures: Array<string>;
     /** List of features defined in a machine-readable way */
     featuresSummary: ProductFeature;
+    creditsPrices: {
+        creditsToCentsConversionRate: number;
+        purchaseTopUpCreditsToCentsConversionRate: number;
+    };
+    creditBalance: {
+        free: {
+            credits: {
+                total: number;
+                used: number;
+                balance: number;
+                resetAt: Date | null;
+            };
+            spendingLimit: {
+                total: number;
+                used: number;
+                balance: number;
+                resetAt: Date | null;
+            };
+        } | null;
+        /** Paid top-up credits balance */
+        paidTopUp: {
+            total: number;
+            used: number;
+            balance: number;
+        } | null;
+        /** Paid recurring credits balance */
+        paidRecurring: {
+            total: number;
+            used: number;
+            balance: number;
+            resetAt: Date | null;
+        } | null;
+    } | null;
+    /**
+     * Description of what the subscription will change to in the next billing cycle.
+     */
+    subscriptionUpcomingChange: {
+        effectiveAt: Date;
+        fullSeatLimit: number | null;
+        builderSeatLimit: number | null;
+        additionalCredits: number | null;
+    } | null;
     constructor(model: WorkspaceSubscriptionRemoteModel);
-    toRemote(): WorkspaceSubscriptionRemoteModel;
-    toTransport(): WorkspaceSubscriptionTransportModel;
     static fromTransport(model: WorkspaceSubscriptionTransportModel): WorkspaceSubscription;
 }

package/build/sdk-typescript/src/tests/Areas/AreaRelay.spec.d.ts

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

package/build/sdk-typescript/src/tests/Areas/AreaThreads.spec.d.ts

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

package/build/sdk-typescript/src/tests/helpers.d.ts

@@ -4,6 +4,7 @@ import { TestContext, TestFunction } from "vitest";
 export declare const testInstance: Supernova;
 export declare const testVersionIdentifier: RemoteVersionIdentifier;
 export declare const testWorkspaceVersionIdentifier: RemoteWorkspaceVersionIdentifier;
+export declare const testAIWorkspaceVersionIdentifier: RemoteWorkspaceVersionIdentifier;
 export declare const randomAlphabeticalOnlyIdentifier: (length: number) => string;
 export declare const randomNumberInRange: (min: number, max: number) => number;
 export declare const testRetryBefore: (beforeFn?: (ctx: any) => Promise<any>) => (name: string, assertFn: TestFunction<TestContext & object>) => void;

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

@@ -15,7 +15,7 @@ export declare enum DTPluginPreciseCopyStrategy {
     deleteAll = "deleteAll",// preciseCopy = true
     keepManualTokens = "keepManualTokens"
 }
-export declare const isPreciseCopyEnabled: (preciseCopy: DTPluginPreciseCopyStrategy) => boolean;
+export declare const isPreciseCopyEnabled: (preciseCopy: DTPluginPreciseCopyStrategy) => preciseCopy is DTPluginPreciseCopyStrategy.deleteAll | DTPluginPreciseCopyStrategy.keepManualTokens;
 export declare const toPreciseCopyStrategy: (preciseCopy?: boolean | DTPluginPreciseCopyStrategy) => DTPluginPreciseCopyStrategy;
 export type DTPluginToSupernovaMap = {
     type: DTPluginToSupernovaMapType;

package/build/sdk-typescript/src/tools/docs-block-builder/SDKDocsBlockBuilder.d.ts

@@ -14,9 +14,10 @@ import { DocsBlockDividerPropertyDefinition, DocsBlockDividerPropertyOptions } f
 import { DocsBlockEmbedUrlPropertyDefinition, DocsBlockEmbedUrlPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockEmbedUrlProperty";
 import { DocsBlockFigmaComponentPropertyDefinition, DocsBlockFigmaComponentPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockFigmaComponentProperty";
 import { DocsBlockFigmaNodePropertyDefinition, DocsBlockFigmaNodePropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockFigmaNodeProperty";
+import { DocsBlockFilePropertyDefinition, DocsBlockFilePropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockFileProperty";
 import { DocsBlockImagePropertyDefinition, DocsBlockImagePropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockImageProperty";
 import { DocsBlockMarkdownPropertyDefinition, DocsBlockMarkdownPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockMarkdownProperty";
-import { DocsBlockMultiRichTextPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockMultiRichTextProperty";
+import { DocsBlockMultiRichTextPropertyDefinition, DocsBlockMultiRichTextPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockMultiRichTextProperty";
 import { DocsBlockMultiSelectPropertyDefinition, DocsBlockMultiSelectPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockMultiSelectProperty";
 import { DocsBlockNumberPropertyDefinition, DocsBlockNumberPropertyOptions } from "../../model/docs/blocks/properties/SDKDocsBlockNumberProperty";
 import { DocsBlockItemPropertyAnyDefinition } from "../../model/docs/blocks/properties/SDKDocsBlockProperty";
@@ -204,7 +205,7 @@ export declare class DocsBlockBuilder {
         variants?: {
             [key: string]: DocsBlockMultiRichTextPropertyOptions;
         };
-    }): DocsBlockRichTextPropertyDefinition;
+    }): DocsBlockMultiRichTextPropertyDefinition;
     /** Create a block property with type .multiRichText and its specific options */
     richTextEditorProperty(configuration: {
         id: string;
@@ -435,4 +436,14 @@ export declare class DocsBlockBuilder {
             [key: string]: DocsBlockDividerPropertyOptions;
         };
     }): DocsBlockDividerPropertyDefinition;
+    /** Create a block property with type .file and its specific options */
+    fileProperty(configuration: {
+        id: string;
+        name: string;
+        description?: string;
+        options: DocsBlockFilePropertyOptions;
+        variants?: {
+            [key: string]: DocsBlockFilePropertyOptions;
+        };
+    }): DocsBlockFilePropertyDefinition;
 }

package/build/sdk-typescript/src/tools/markdown-transform/SDKToolsMarkdownLinkResolver.d.ts

@@ -0,0 +1,39 @@
+import { Supernova } from "../../core/SDKSupernova";
+import { DocumentationLegacyGroup } from "../../model/documentation/SDKDocumentationLegacyGroup";
+import { DocumentationLegacyPage } from "../../model/documentation/SDKDocumentationLegacyPage";
+import { MarkdownTransformBlockConfig } from "./SDKToolsMarkdownTransformBlock";
+/** Utility class for resolving links in markdown transformation */
+export declare class MarkdownLinkResolver {
+    private documentationData;
+    private config;
+    private sdkInstance;
+    private designSystemId;
+    private versionId;
+    private cachedDocumentationBaseUrl;
+    constructor(documentationData: {
+        rootGroup: DocumentationLegacyGroup;
+        allPages: Array<DocumentationLegacyPage>;
+        allGroups: Array<DocumentationLegacyGroup>;
+    }, config: MarkdownTransformBlockConfig, sdkInstance: Supernova, designSystemId: string, versionId: string);
+    /**
+     * Resolves a link based on external URL or internal documentation item ID
+     * @param externalUrl - Direct external URL if available
+     * @param documentationItemId - Internal documentation item ID if available
+     * @param pageContext - Current page context for relative path resolution
+     * @returns Promise<string> - Resolved URL
+     */
+    resolveLink(externalUrl: string | null, documentationItemId: string | null, pageContext: DocumentationLegacyPage): Promise<string>;
+    /**
+     * Generates relative path from current page to target page
+     * @param targetPage - Page to link to
+     * @param currentPage - Current page context
+     * @returns string - Relative path
+     */
+    private relativePathToPage;
+    /**
+     * Retrieves the base documentation URL for deployed documentation
+     * Uses caching to avoid repeated API calls
+     * @returns string | null - Base documentation URL or null if not available
+     */
+    private getDocumentationBaseUrl;
+}

package/build/sdk-typescript/src/tools/markdown-transform/SDKToolsMarkdownTransform.d.ts

@@ -1,7 +1,7 @@
 import { Supernova } from "../../core/SDKSupernova";
 import { DocumentationLegacyPage } from "../../model/documentation/SDKDocumentationLegacyPage";
 import { DocumentationLegacyPageBlockType } from "../../model/enums/SDKDocumentationLegacyPageBlockType";
-import { MarkdownTransformBlock } from "./SDKToolsMarkdownTransformBlock";
+import { MarkdownTransformBlock, MarkdownTransformBlockConfig } from "./SDKToolsMarkdownTransformBlock";
 /** Output markdown mode. Commonmark and GitHub is currently supported */
 export declare enum MarkdownTransformType {
     commonmark = "commonmark",
@@ -11,7 +11,7 @@ export declare enum MarkdownTransformType {
 export declare class MarkdownTransform {
     conversionType: MarkdownTransformType;
     blockTransformer: MarkdownTransformBlock;
-    constructor(type: MarkdownTransformType, instance: Supernova, designSystemId: string, workspaceId: string, versionId: string);
+    constructor(type: MarkdownTransformType, instance: Supernova, designSystemId: string, workspaceId: string, versionId: string, config?: MarkdownTransformBlockConfig);
     /** Converts entire definition of the page, including its metadata like title and description, to markdown */
     convertPageToMarkdown(page: DocumentationLegacyPage): Promise<string>;
     /** Creates flattened structure of the blocks, even from the contained blocks, so it is easier to iterate through them */