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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. package/build/supernova-sdk-typescript.js +1 -1
  2. package/build/supernova-sdk-typescript.js.map +1 -1
  3. package/build/types/core/areas/SDKAreaBulkOperations.d.ts +1 -1
  4. package/build/types/core/areas/SDKAreaDocumentation.d.ts +4 -4
  5. package/build/types/core/areas/SDKAreaTokens.d.ts +3 -2
  6. package/build/types/core/data/SDKDataCore.d.ts +9 -8
  7. package/build/types/core/data/requests/SDKDataCoreWriteRequests.d.ts +26 -18
  8. package/build/types/core/resolvers/SDKDocsEntityItemResolver.d.ts +6 -6
  9. package/build/types/model/activity-events/SDKActivityEvent.d.ts +19 -6687
  10. package/build/types/tools/design-tokens/SDKToolsDesignTokensPlugin.d.ts +6 -3
  11. package/build/types/utils/TokenUtils.d.ts +1 -1
  12. package/package.json +3 -3
package/build/types/core/areas/SDKAreaBulkOperations.d.ts CHANGED
@@ -139,9 +139,9 @@ export declare class AreaBulkOperations {
139
139
  type: "FigmaNodeRenderAsync";
140
140
  figmaNodes: {
141
141
  id: string;
142
- createdAt: Date;
143
142
  designSystemVersionId: string;
144
143
  persistentId: string;
144
+ createdAt: Date;
145
145
  updatedAt: Date;
146
146
  meta: {
147
147
  name: string;
package/build/types/core/areas/SDKAreaDocumentation.d.ts CHANGED
@@ -178,9 +178,9 @@ export declare class AreaDocumentation {
178
178
  type: "FigmaNodeRenderAsync";
179
179
  figmaNodes: {
180
180
  id: string;
181
- createdAt: Date;
182
181
  designSystemVersionId: string;
183
182
  persistentId: string;
183
+ createdAt: Date;
184
184
  updatedAt: Date;
185
185
  meta: {
186
186
  name: string;
@@ -306,9 +306,9 @@ export declare class AreaDocumentation {
306
306
  type: "FigmaNodeRenderAsync";
307
307
  figmaNodes: {
308
308
  id: string;
309
- createdAt: Date;
310
309
  designSystemVersionId: string;
311
310
  persistentId: string;
311
+ createdAt: Date;
312
312
  updatedAt: Date;
313
313
  meta: {
314
314
  name: string;
@@ -434,9 +434,9 @@ export declare class AreaDocumentation {
434
434
  type: "FigmaNodeRenderAsync";
435
435
  figmaNodes: {
436
436
  id: string;
437
- createdAt: Date;
438
437
  designSystemVersionId: string;
439
438
  persistentId: string;
439
+ createdAt: Date;
440
440
  updatedAt: Date;
441
441
  meta: {
442
442
  name: string;
@@ -601,9 +601,9 @@ export declare class AreaDocumentation {
601
601
  type: "FigmaNodeRenderAsync";
602
602
  figmaNodes: {
603
603
  id: string;
604
- createdAt: Date;
605
604
  designSystemVersionId: string;
606
605
  persistentId: string;
606
+ createdAt: Date;
607
607
  updatedAt: Date;
608
608
  meta: {
609
609
  name: string;
package/build/types/core/areas/SDKAreaTokens.d.ts CHANGED
@@ -3,6 +3,7 @@ import { ElementDataView } from "../../model/elements/SDKElementDataView";
3
3
  import { ElementDataViewColumn } from "../../model/elements/SDKElementDataViewColumn";
4
4
  import { ElementProperty, ElementPropertyCreationModel, ElementPropertyUpdateModel } from "../../model/elements/SDKElementProperty";
5
5
  import { ElementPropertyValue } from "../../model/elements/values/SDKElementPropertyValue";
6
+ import { ActivityEventOptions } from "../data/requests/SDKDataCoreWriteRequests";
6
7
  import { TokenType } from "../../model/enums/SDKTokenType";
7
8
  import { TokenGroup } from "../../model/groups/SDKTokenGroup";
8
9
  import { TokenTheme } from "../../model/themes/SDKTokenTheme";
@@ -221,9 +222,9 @@ export declare class AreaTokens {
221
222
  */
222
223
  deleteTokenTheme(to: RemoteVersionIdentifier, idInVersion: string): Promise<void>;
223
224
  /** Warning: INTERNAL, DO NOT USE YET, NOT STABLE INTERFACE. Write tokens in bulk */
224
- writeTokens(to: RemoteVersionIdentifier, tokens: Array<Token>, groups: Array<TokenGroup>, deleteTokens: Array<Token>, deleteTokenGroups: Array<TokenGroup>): Promise<void>;
225
+ writeTokens(to: RemoteVersionIdentifier, tokens: Array<Token>, groups: Array<TokenGroup>, deleteTokens: Array<Token>, deleteTokenGroups: Array<TokenGroup>, activityEventOptions?: ActivityEventOptions): Promise<void>;
225
226
  /** Warning: INTERNAL, DO NOT USE YET, NOT STABLE INTERFACE. Write theme in bulk */
226
- writeTheme(to: RemoteVersionIdentifier, theme: TokenTheme): Promise<void>;
227
+ writeTheme(to: RemoteVersionIdentifier, theme: TokenTheme, activityEventOptions?: ActivityEventOptions): Promise<void>;
227
228
  /** Resolves tokens by applying themes to them and retrieves new token set where values correctly correspond to that theme */
228
229
  computeTokensByApplyingThemes(allTokens: Array<Token>, tokens: Array<Token>, themes: Array<TokenTheme>): Array<AnyToken>;
229
230
  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 CHANGED
@@ -114,6 +114,7 @@ import { ComponentUpdateTransactionData, TokenUpdateTransactionData } from "../a
114
114
  import { AIAgentPersona, AIGetRouteQueryTask, RelaySummarizeStrategy } from "../areas/SDKAreaRelay";
115
115
  import { DataCoreReadRequests } from "./requests/SDKDataCoreReadRequests";
116
116
  import { RenderedAssetRequestSettings } from "./requests/SDKDataCoreRenderRequests";
117
+ import { ActivityEventOptions } from "./requests/SDKDataCoreWriteRequests";
117
118
  import { DataBridge } from "./SDKDataBridge";
118
119
  export declare class DataCore {
119
120
  /** Read part of the network calls */
@@ -228,8 +229,8 @@ export declare class DataCore {
228
229
  /** Update existing token theme in remote */
229
230
  updateTokenTheme(designSystemId: string, versionId: string, theme: TokenTheme): Promise<void>;
230
231
  /** Write the tokens to remote */
231
- writeTokenData(designSystemId: string, versionId: string, tokens: Array<Token>, groups: Array<TokenGroup>, deleteTokens: Array<Token>, deleteGroups: Array<TokenGroup>): Promise<void>;
232
- writeTokenThemeData(designSystemId: string, versionId: string, theme: TokenTheme): Promise<void>;
232
+ writeTokenData(designSystemId: string, versionId: string, tokens: Array<Token>, groups: Array<TokenGroup>, deleteTokens: Array<Token>, deleteGroups: Array<TokenGroup>, activityEventOptions?: ActivityEventOptions): Promise<void>;
233
+ writeTokenThemeData(designSystemId: string, versionId: string, theme: TokenTheme, activityEventOptions?: ActivityEventOptions): Promise<void>;
233
234
  /** Delete token from remote */
234
235
  deleteToken(designSystemId: string, versionId: string, tokenId: string): Promise<void>;
235
236
  /** Delete group from remote */
@@ -321,9 +322,9 @@ export declare class DataCore {
321
322
  type: "FigmaNodeRenderAsync";
322
323
  figmaNodes: {
323
324
  id: string;
324
- createdAt: Date;
325
325
  designSystemVersionId: string;
326
326
  persistentId: string;
327
+ createdAt: Date;
327
328
  updatedAt: Date;
328
329
  meta: {
329
330
  name: string;
@@ -449,9 +450,9 @@ export declare class DataCore {
449
450
  type: "FigmaNodeRenderAsync";
450
451
  figmaNodes: {
451
452
  id: string;
452
- createdAt: Date;
453
453
  designSystemVersionId: string;
454
454
  persistentId: string;
455
+ createdAt: Date;
455
456
  updatedAt: Date;
456
457
  meta: {
457
458
  name: string;
@@ -591,9 +592,9 @@ export declare class DataCore {
591
592
  type: "FigmaNodeRenderAsync";
592
593
  figmaNodes: {
593
594
  id: string;
594
- createdAt: Date;
595
595
  designSystemVersionId: string;
596
596
  persistentId: string;
597
+ createdAt: Date;
597
598
  updatedAt: Date;
598
599
  meta: {
599
600
  name: string;
@@ -715,9 +716,9 @@ export declare class DataCore {
715
716
  type: "FigmaNodeRenderAsync";
716
717
  figmaNodes: {
717
718
  id: string;
718
- createdAt: Date;
719
719
  designSystemVersionId: string;
720
720
  persistentId: string;
721
+ createdAt: Date;
721
722
  updatedAt: Date;
722
723
  meta: {
723
724
  name: string;
@@ -839,9 +840,9 @@ export declare class DataCore {
839
840
  type: "FigmaNodeRenderAsync";
840
841
  figmaNodes: {
841
842
  id: string;
842
- createdAt: Date;
843
843
  designSystemVersionId: string;
844
844
  persistentId: string;
845
+ createdAt: Date;
845
846
  updatedAt: Date;
846
847
  meta: {
847
848
  name: string;
@@ -963,9 +964,9 @@ export declare class DataCore {
963
964
  type: "FigmaNodeRenderAsync";
964
965
  figmaNodes: {
965
966
  id: string;
966
- createdAt: Date;
967
967
  designSystemVersionId: string;
968
968
  persistentId: string;
969
+ createdAt: Date;
969
970
  updatedAt: Date;
970
971
  meta: {
971
972
  name: string;
package/build/types/core/data/requests/SDKDataCoreWriteRequests.d.ts CHANGED
@@ -44,6 +44,14 @@ import { WorkspaceScimTokenCreateResponse } from "../../../model/workspaces/SDKW
44
44
  import { WorkspaceSubscriptionUpdateModel } from "../../../model/workspaces/SDKWorkspaceSubscription";
45
45
  import { JSONObject } from "../../../utils/SDKJSONValue";
46
46
  import { DataBridge } from "../SDKDataBridge";
47
+ /**
48
+ * Opt-in payload attached to a write. `parentId` today carries the parent event id; kept
49
+ * opaque so it can evolve to a server-issued adoption token later without renaming the field.
50
+ */
51
+ export type ActivityEventOptions = {
52
+ actorSource: "Direct" | "TokenStudio" | "FigmaPlugin" | "FigmaSync" | "Agent" | "CLI";
53
+ parentId: string | null;
54
+ };
47
55
  export declare class DataCoreWriteRequests {
48
56
  private bridge;
49
57
  constructor(bridge: DataBridge);
@@ -240,9 +248,9 @@ export declare class DataCoreWriteRequests {
240
248
  type: "FigmaNodeRenderAsync";
241
249
  figmaNodes: {
242
250
  id: string;
243
- createdAt: Date;
244
251
  designSystemVersionId: string;
245
252
  persistentId: string;
253
+ createdAt: Date;
246
254
  updatedAt: Date;
247
255
  meta: {
248
256
  name: string;
@@ -363,9 +371,9 @@ export declare class DataCoreWriteRequests {
363
371
  type: "FigmaNodeRenderAsync";
364
372
  figmaNodes: {
365
373
  id: string;
366
- createdAt: Date;
367
374
  designSystemVersionId: string;
368
375
  persistentId: string;
376
+ createdAt: Date;
369
377
  updatedAt: Date;
370
378
  meta: {
371
379
  name: string;
@@ -487,9 +495,9 @@ export declare class DataCoreWriteRequests {
487
495
  type: "FigmaNodeRenderAsync";
488
496
  figmaNodes: {
489
497
  id: string;
490
- createdAt: Date;
491
498
  designSystemVersionId: string;
492
499
  persistentId: string;
500
+ createdAt: Date;
493
501
  updatedAt: Date;
494
502
  meta: {
495
503
  name: string;
@@ -611,9 +619,9 @@ export declare class DataCoreWriteRequests {
611
619
  type: "FigmaNodeRenderAsync";
612
620
  figmaNodes: {
613
621
  id: string;
614
- createdAt: Date;
615
622
  designSystemVersionId: string;
616
623
  persistentId: string;
624
+ createdAt: Date;
617
625
  updatedAt: Date;
618
626
  meta: {
619
627
  name: string;
@@ -735,9 +743,9 @@ export declare class DataCoreWriteRequests {
735
743
  type: "FigmaNodeRenderAsync";
736
744
  figmaNodes: {
737
745
  id: string;
738
- createdAt: Date;
739
746
  designSystemVersionId: string;
740
747
  persistentId: string;
748
+ createdAt: Date;
741
749
  updatedAt: Date;
742
750
  meta: {
743
751
  name: string;
@@ -859,9 +867,9 @@ export declare class DataCoreWriteRequests {
859
867
  type: "FigmaNodeRenderAsync";
860
868
  figmaNodes: {
861
869
  id: string;
862
- createdAt: Date;
863
870
  designSystemVersionId: string;
864
871
  persistentId: string;
872
+ createdAt: Date;
865
873
  updatedAt: Date;
866
874
  meta: {
867
875
  name: string;
@@ -983,9 +991,9 @@ export declare class DataCoreWriteRequests {
983
991
  type: "FigmaNodeRenderAsync";
984
992
  figmaNodes: {
985
993
  id: string;
986
- createdAt: Date;
987
994
  designSystemVersionId: string;
988
995
  persistentId: string;
996
+ createdAt: Date;
989
997
  updatedAt: Date;
990
998
  meta: {
991
999
  name: string;
@@ -1107,9 +1115,9 @@ export declare class DataCoreWriteRequests {
1107
1115
  type: "FigmaNodeRenderAsync";
1108
1116
  figmaNodes: {
1109
1117
  id: string;
1110
- createdAt: Date;
1111
1118
  designSystemVersionId: string;
1112
1119
  persistentId: string;
1120
+ createdAt: Date;
1113
1121
  updatedAt: Date;
1114
1122
  meta: {
1115
1123
  name: string;
@@ -1231,9 +1239,9 @@ export declare class DataCoreWriteRequests {
1231
1239
  type: "FigmaNodeRenderAsync";
1232
1240
  figmaNodes: {
1233
1241
  id: string;
1234
- createdAt: Date;
1235
1242
  designSystemVersionId: string;
1236
1243
  persistentId: string;
1244
+ createdAt: Date;
1237
1245
  updatedAt: Date;
1238
1246
  meta: {
1239
1247
  name: string;
@@ -1355,9 +1363,9 @@ export declare class DataCoreWriteRequests {
1355
1363
  type: "FigmaNodeRenderAsync";
1356
1364
  figmaNodes: {
1357
1365
  id: string;
1358
- createdAt: Date;
1359
1366
  designSystemVersionId: string;
1360
1367
  persistentId: string;
1368
+ createdAt: Date;
1361
1369
  updatedAt: Date;
1362
1370
  meta: {
1363
1371
  name: string;
@@ -1479,9 +1487,9 @@ export declare class DataCoreWriteRequests {
1479
1487
  type: "FigmaNodeRenderAsync";
1480
1488
  figmaNodes: {
1481
1489
  id: string;
1482
- createdAt: Date;
1483
1490
  designSystemVersionId: string;
1484
1491
  persistentId: string;
1492
+ createdAt: Date;
1485
1493
  updatedAt: Date;
1486
1494
  meta: {
1487
1495
  name: string;
@@ -1603,9 +1611,9 @@ export declare class DataCoreWriteRequests {
1603
1611
  type: "FigmaNodeRenderAsync";
1604
1612
  figmaNodes: {
1605
1613
  id: string;
1606
- createdAt: Date;
1607
1614
  designSystemVersionId: string;
1608
1615
  persistentId: string;
1616
+ createdAt: Date;
1609
1617
  updatedAt: Date;
1610
1618
  meta: {
1611
1619
  name: string;
@@ -1726,9 +1734,9 @@ export declare class DataCoreWriteRequests {
1726
1734
  type: "FigmaNodeRenderAsync";
1727
1735
  figmaNodes: {
1728
1736
  id: string;
1729
- createdAt: Date;
1730
1737
  designSystemVersionId: string;
1731
1738
  persistentId: string;
1739
+ createdAt: Date;
1732
1740
  updatedAt: Date;
1733
1741
  meta: {
1734
1742
  name: string;
@@ -1849,9 +1857,9 @@ export declare class DataCoreWriteRequests {
1849
1857
  type: "FigmaNodeRenderAsync";
1850
1858
  figmaNodes: {
1851
1859
  id: string;
1852
- createdAt: Date;
1853
1860
  designSystemVersionId: string;
1854
1861
  persistentId: string;
1862
+ createdAt: Date;
1855
1863
  updatedAt: Date;
1856
1864
  meta: {
1857
1865
  name: string;
@@ -1910,7 +1918,7 @@ export declare class DataCoreWriteRequests {
1910
1918
  createdAt: string;
1911
1919
  authors: string[];
1912
1920
  createdByUserId?: string;
1913
- reason?: "Publish" | "Manual" | "Restore";
1921
+ reason?: "Manual" | "Publish" | "Restore";
1914
1922
  name?: string;
1915
1923
  restoredFromVersionId?: string;
1916
1924
  publishedAt?: string;
@@ -1987,9 +1995,9 @@ export declare class DataCoreWriteRequests {
1987
1995
  type: "FigmaNodeRenderAsync";
1988
1996
  figmaNodes: {
1989
1997
  id: string;
1990
- createdAt: Date;
1991
1998
  designSystemVersionId: string;
1992
1999
  persistentId: string;
2000
+ createdAt: Date;
1993
2001
  updatedAt: Date;
1994
2002
  meta: {
1995
2003
  name: string;
@@ -2056,8 +2064,8 @@ export declare class DataCoreWriteRequests {
2056
2064
  createRemoteTokenTheme(designSystemId: string, versionId: string, theme: TokenThemeRemoteModel): Promise<TokenThemeRemoteModel>;
2057
2065
  updateRemoteTokenTheme(designSystemId: string, versionId: string, group: TokenThemeRemoteModel): Promise<void>;
2058
2066
  deleteRemoteTokenTheme(designSystemId: string, versionId: string, themeId: string): Promise<void>;
2059
- writeTokenData(designSystemId: string, versionId: string, tokens: Array<TokenRemoteModel>, groups: Array<TokenGroupRemoteModel>, deleteTokens: Array<Token>, deleteTokenGroups: Array<TokenGroup>): Promise<void>;
2060
- writeTokenThemeData(designSystemId: string, versionId: string, theme: TokenThemeRemoteModel): Promise<void>;
2067
+ writeTokenData(designSystemId: string, versionId: string, tokens: Array<TokenRemoteModel>, groups: Array<TokenGroupRemoteModel>, deleteTokens: Array<Token>, deleteTokenGroups: Array<TokenGroup>, activityEventOptions?: ActivityEventOptions): Promise<void>;
2068
+ writeTokenThemeData(designSystemId: string, versionId: string, theme: TokenThemeRemoteModel, activityEventOptions?: ActivityEventOptions): Promise<void>;
2061
2069
  deleteElementPropertyValue(designSystemId: string, versionId: string, valueId: string): Promise<void>;
2062
2070
  createTokenProperty(designSystemId: string, versionId: string, model: object): Promise<ElementPropertyRemoteModel>;
2063
2071
  updateTokenProperty(designSystemId: string, versionId: string, propertyIdInVersion: string, model: object): Promise<void>;
package/build/types/core/resolvers/SDKDocsEntityItemResolver.d.ts CHANGED
@@ -4,14 +4,14 @@ import { DocsEntityPage } from "../../model/docs/entities/SDKDocsEntityPage";
4
4
  export declare class DocsEntityItemResolver {
5
5
  hashedItems: Map<string, {
6
6
  id: string;
7
- createdAt: Date;
8
7
  designSystemVersionId: string;
9
8
  persistentId: string;
9
+ createdAt: Date;
10
10
  updatedAt: Date;
11
11
  title: string;
12
12
  isRoot: boolean;
13
13
  childrenIds: string[];
14
- groupBehavior: "Group" | "Tabs";
14
+ groupBehavior: "Tabs" | "Group";
15
15
  shortPersistentId: string;
16
16
  configuration: {
17
17
  showSidebar: boolean;
@@ -19,7 +19,7 @@ export declare class DocsEntityItemResolver {
19
19
  isHidden: boolean;
20
20
  header: {
21
21
  description: string;
22
- alignment: "Center" | "Left";
22
+ alignment: "Left" | "Center";
23
23
  backgroundImageScaleType: "AspectFill" | "AspectFit";
24
24
  showBackgroundOverlay: boolean;
25
25
  showCoverText: boolean;
@@ -70,7 +70,7 @@ export declare class DocsEntityItemResolver {
70
70
  isHidden: boolean;
71
71
  header: {
72
72
  description: string;
73
- alignment: "Center" | "Left";
73
+ alignment: "Left" | "Center";
74
74
  backgroundImageScaleType: "AspectFill" | "AspectFit";
75
75
  showBackgroundOverlay: boolean;
76
76
  showCoverText: boolean;
@@ -114,7 +114,7 @@ export declare class DocsEntityItemResolver {
114
114
  isHidden: boolean;
115
115
  header: {
116
116
  description: string;
117
- alignment: "Center" | "Left";
117
+ alignment: "Left" | "Center";
118
118
  backgroundImageScaleType: "AspectFill" | "AspectFit";
119
119
  showBackgroundOverlay: boolean;
120
120
  showCoverText: boolean;
@@ -172,7 +172,7 @@ export declare class DocsEntityItemResolver {
172
172
  isHidden: boolean;
173
173
  header: {
174
174
  description: string;
175
- alignment: "Center" | "Left";
175
+ alignment: "Left" | "Center";
176
176
  backgroundImageScaleType: "AspectFill" | "AspectFit";
177
177
  showBackgroundOverlay: boolean;
178
178
  showCoverText: boolean;