@supernova-studio/supernova-sdk-beta 2.5.2 → 2.5.3

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

@@ -3,6 +3,7 @@ import { ElementDataView } from "../../model/elements/SDKElementDataView";
 import { ElementDataViewColumn } from "../../model/elements/SDKElementDataViewColumn";
 import { ElementProperty, ElementPropertyCreationModel, ElementPropertyUpdateModel } from "../../model/elements/SDKElementProperty";
 import { ElementPropertyValue } from "../../model/elements/values/SDKElementPropertyValue";
+import { ActivityEventOptions } from "../data/requests/SDKDataCoreWriteRequests";
 import { TokenType } from "../../model/enums/SDKTokenType";
 import { TokenGroup } from "../../model/groups/SDKTokenGroup";
 import { TokenTheme } from "../../model/themes/SDKTokenTheme";
@@ -221,9 +222,9 @@ export declare class AreaTokens {
      */
     deleteTokenTheme(to: RemoteVersionIdentifier, idInVersion: string): Promise<void>;
     /** Warning: INTERNAL, DO NOT USE YET, NOT STABLE INTERFACE. Write tokens in bulk */
-    writeTokens(to: RemoteVersionIdentifier, tokens: Array<Token>, groups: Array<TokenGroup>, deleteTokens: Array<Token>, deleteTokenGroups: Array<TokenGroup>): Promise<void>;
+    writeTokens(to: RemoteVersionIdentifier, tokens: Array<Token>, groups: Array<TokenGroup>, deleteTokens: Array<Token>, deleteTokenGroups: Array<TokenGroup>, activityEventOptions?: ActivityEventOptions): Promise<void>;
     /** Warning: INTERNAL, DO NOT USE YET, NOT STABLE INTERFACE. Write theme in bulk */
-    writeTheme(to: RemoteVersionIdentifier, theme: TokenTheme): Promise<void>;
+    writeTheme(to: RemoteVersionIdentifier, theme: TokenTheme, activityEventOptions?: ActivityEventOptions): Promise<void>;
     /** Resolves tokens by applying themes to them and retrieves new token set where values correctly correspond to that theme */
     computeTokensByApplyingThemes(allTokens: Array<Token>, tokens: Array<Token>, themes: Array<TokenTheme>): Array<AnyToken>;
     computeInnerReferencesByApplyingThemesEfficient(tokensIndex: Map<string, Token>, themeOverridesIndex: Record<string, Map<string, Token>>, tokens: Array<Token>, themes: Array<TokenTheme>): Array<AnyToken>;

package/build/types/core/data/SDKDataCore.d.ts

@@ -114,6 +114,7 @@ import { ComponentUpdateTransactionData, TokenUpdateTransactionData } from "../a
 import { AIAgentPersona, AIGetRouteQueryTask, RelaySummarizeStrategy } from "../areas/SDKAreaRelay";
 import { DataCoreReadRequests } from "./requests/SDKDataCoreReadRequests";
 import { RenderedAssetRequestSettings } from "./requests/SDKDataCoreRenderRequests";
+import { ActivityEventOptions } from "./requests/SDKDataCoreWriteRequests";
 import { DataBridge } from "./SDKDataBridge";
 export declare class DataCore {
     /** Read part of the network calls */
@@ -228,8 +229,8 @@ export declare class DataCore {
     /** Update existing token theme in remote */
     updateTokenTheme(designSystemId: string, versionId: string, theme: TokenTheme): Promise<void>;
     /** Write the tokens to remote */
-    writeTokenData(designSystemId: string, versionId: string, tokens: Array<Token>, groups: Array<TokenGroup>, deleteTokens: Array<Token>, deleteGroups: Array<TokenGroup>): Promise<void>;
-    writeTokenThemeData(designSystemId: string, versionId: string, theme: TokenTheme): Promise<void>;
+    writeTokenData(designSystemId: string, versionId: string, tokens: Array<Token>, groups: Array<TokenGroup>, deleteTokens: Array<Token>, deleteGroups: Array<TokenGroup>, activityEventOptions?: ActivityEventOptions): Promise<void>;
+    writeTokenThemeData(designSystemId: string, versionId: string, theme: TokenTheme, activityEventOptions?: ActivityEventOptions): Promise<void>;
     /** Delete token from remote */
     deleteToken(designSystemId: string, versionId: string, tokenId: string): Promise<void>;
     /** Delete group from remote */

package/build/types/core/data/requests/SDKDataCoreWriteRequests.d.ts

@@ -44,6 +44,14 @@ import { WorkspaceScimTokenCreateResponse } from "../../../model/workspaces/SDKW
 import { WorkspaceSubscriptionUpdateModel } from "../../../model/workspaces/SDKWorkspaceSubscription";
 import { JSONObject } from "../../../utils/SDKJSONValue";
 import { DataBridge } from "../SDKDataBridge";
+/**
+ * Opt-in payload attached to a write. `parentId` today carries the parent event id; kept
+ * opaque so it can evolve to a server-issued adoption token later without renaming the field.
+ */
+export type ActivityEventOptions = {
+    actorSource: "Direct" | "TokenStudio" | "FigmaPlugin" | "FigmaSync" | "Agent" | "CLI";
+    parentId: string | null;
+};
 export declare class DataCoreWriteRequests {
     private bridge;
     constructor(bridge: DataBridge);
@@ -2056,8 +2064,8 @@ export declare class DataCoreWriteRequests {
     createRemoteTokenTheme(designSystemId: string, versionId: string, theme: TokenThemeRemoteModel): Promise<TokenThemeRemoteModel>;
     updateRemoteTokenTheme(designSystemId: string, versionId: string, group: TokenThemeRemoteModel): Promise<void>;
     deleteRemoteTokenTheme(designSystemId: string, versionId: string, themeId: string): Promise<void>;
-    writeTokenData(designSystemId: string, versionId: string, tokens: Array<TokenRemoteModel>, groups: Array<TokenGroupRemoteModel>, deleteTokens: Array<Token>, deleteTokenGroups: Array<TokenGroup>): Promise<void>;
-    writeTokenThemeData(designSystemId: string, versionId: string, theme: TokenThemeRemoteModel): Promise<void>;
+    writeTokenData(designSystemId: string, versionId: string, tokens: Array<TokenRemoteModel>, groups: Array<TokenGroupRemoteModel>, deleteTokens: Array<Token>, deleteTokenGroups: Array<TokenGroup>, activityEventOptions?: ActivityEventOptions): Promise<void>;
+    writeTokenThemeData(designSystemId: string, versionId: string, theme: TokenThemeRemoteModel, activityEventOptions?: ActivityEventOptions): Promise<void>;
     deleteElementPropertyValue(designSystemId: string, versionId: string, valueId: string): Promise<void>;
     createTokenProperty(designSystemId: string, versionId: string, model: object): Promise<ElementPropertyRemoteModel>;
     updateTokenProperty(designSystemId: string, versionId: string, propertyIdInVersion: string, model: object): Promise<void>;

package/build/types/tools/design-tokens/SDKToolsDesignTokensPlugin.d.ts

@@ -1,4 +1,5 @@
 import { Supernova } from "../../core/SDKSupernova";
+import { ActivityEventOptions } from "../../core/data/requests/SDKDataCoreWriteRequests";
 import { Brand } from "../../model/base/SDKBrand";
 import { TokenGroup } from "../../model/groups/SDKTokenGroup";
 import { Logger } from "../../model/support/SDKLogger";
@@ -28,7 +29,9 @@ export declare class SupernovaToolsDesignTokensPlugin {
     private logger;
     constructor(designSystemId: string, versionId: string, instance: Supernova, logger?: Logger);
     synchronizeTokensFromData(data: object, mapping: DTPluginToSupernovaMapPack, settings: DTPluginToSupernovaSettings): Promise<object>;
-    synchronizeTokensFromDataWithResults(data: object, mapping: DTPluginToSupernovaMapPack, settings: DTPluginToSupernovaSettings): Promise<{
+    synchronizeTokensFromDataWithResults(data: object, mapping: DTPluginToSupernovaMapPack, settings: DTPluginToSupernovaSettings, options?: {
+        activityEventOptions?: ActivityEventOptions;
+    }): Promise<{
         results: SupernovaToolsDesignTokensResult[];
         logs: string[];
     }>;
@@ -40,13 +43,13 @@ export declare class SupernovaToolsDesignTokensPlugin {
         groups: Array<TokenGroup>;
     };
     /** Loads remote source connected to this tool, then merges tokens and groups with it, creating union. Can optionally write to the source as well */
-    mergeWithRemoteSource(processedNodes: Array<DTProcessedTokenNode>, brand: Brand, write: boolean, verbose: boolean, preciseCopy: DTPluginPreciseCopyStrategy): Promise<{
+    mergeWithRemoteSource(processedNodes: Array<DTProcessedTokenNode>, brand: Brand, write: boolean, verbose: boolean, preciseCopy: DTPluginPreciseCopyStrategy, activityEventOptions?: ActivityEventOptions): Promise<{
         tokens: Array<Token>;
         groups: Array<TokenGroup>;
         diff: DTTokenMergeDiff;
     }>;
     /** Loads remote source connected to this tool, then creates the diff from the base tree and updates the associated theme. Can optionally write to the source as well */
-    mergeThemeWithRemoteSource(processedNodes: Array<DTProcessedTokenNode>, brand: Brand, theme: TokenTheme, write: boolean, verbose: boolean, preciseCopy?: DTPluginPreciseCopyStrategy, themeOverridesStrategy?: DTPluginThemeOverrideStrategy): Promise<{
+    mergeThemeWithRemoteSource(processedNodes: Array<DTProcessedTokenNode>, brand: Brand, theme: TokenTheme, write: boolean, verbose: boolean, preciseCopy?: DTPluginPreciseCopyStrategy, themeOverridesStrategy?: DTPluginThemeOverrideStrategy, activityEventOptions?: ActivityEventOptions): Promise<{
         theme: TokenTheme;
         tokens: Array<Token>;
     }>;

package/package.json

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