@supernova-studio/client 1.60.2 → 1.61.0

package/dist/index.mjs

@@ -7018,6 +7018,7 @@ var Variable = z235.object({
   name: z235.string(),
   key: z235.string(),
   variableCollectionId: z235.string(),
+  variableCollectionKey: z235.string().optional(),
   resolvedType: ResolvedVariableType,
   valuesByMode: z235.record(VariableValue),
   remote: z235.boolean(),
@@ -7028,27 +7029,34 @@ var Variable = z235.object({
 });
 var VariableMode = z235.object({
   modeId: z235.string(),
-  name: z235.string()
+  name: z235.string(),
+  parentModeId: z235.string().optional()
 });
 var Collection2 = z235.object({
   id: z235.string(),
   name: z235.string(),
+  key: z235.string().optional(),
   modes: z235.array(VariableMode),
   defaultModeId: z235.string(),
   remote: z235.boolean(),
-  hiddenFromPublishing: z235.boolean()
+  hiddenFromPublishing: z235.boolean(),
+  isExtension: z235.boolean().optional(),
+  parentVariableCollectionId: z235.string().optional(),
+  parentVariableCollectionKey: z235.string().optional(),
+  variableOverrides: z235.record(z235.string(), z235.record(z235.string(), VariableValue)).optional()
 });
 var VariablesMapping = z235.object({
   variableCollections: z235.array(z235.string()).min(1),
+  variableCollectionKeys: z235.array(z235.string()).optional(),
   variableMode: z235.string().min(1),
   supernovaBrand: z235.string().min(1),
-  supernovaTheme: z235.string().min(1).optional().or(z235.null())
+  supernovaTheme: z235.string().min(1).nullable().optional()
 });
 var FormattedCollections = z235.object({
-  variables: z235.record(z235.string(), Variable),
   variableCollections: z235.record(z235.string(), Collection2),
-  mappings: z235.array(VariablesMapping).optional(),
-  variablesOrder: z235.string().array().optional()
+  variables: z235.record(z235.string(), Variable),
+  variablesOrder: z235.string().array().optional(),
+  mappings: z235.array(VariablesMapping).optional()
 });
 
 // src/api/dto/design-systems/file.ts
@@ -19988,6 +19996,174 @@ var TransactionQueue2 = class {
     this.queue.clear();
   }
 };
+
+// src/test-data-builders/fvp/base.ts
+import { randomUUID } from "crypto";
+var TestFVPDataBuilder = class {
+  constructor(input) {
+    __publicField(this, "input");
+    __publicField(this, "collections");
+    __publicField(this, "figmaIdCounter", 0);
+    this.input = input;
+    this.collections = {
+      variableCollections: {},
+      variables: {},
+      variablesOrder: []
+    };
+  }
+  //
+  // Bulk
+  //
+  addBulk(data) {
+    const collection = this.addCollection({
+      collection: data.collection,
+      modes: data.modes
+    });
+    const fullVariables = data.variables.map((v) => {
+      return {
+        ...v,
+        variableCollectionId: collection.id
+      };
+    });
+    const variables = fullVariables.map((v) => this.addVariable(v));
+    return { collection, variables };
+  }
+  //
+  // Collections
+  //
+  addCollection(collectionWithModes) {
+    const { collection, modes } = collectionWithModes;
+    if (!modes.length) {
+      throw SupernovaException.validationError(`At least one mode is required per collection`);
+    }
+    const fullCollection = {
+      ...collection,
+      id: this.nextCollectionId(),
+      modes: [],
+      defaultModeId: "",
+      hiddenFromPublishing: collection.hiddenFromPublishing ?? false,
+      remote: collection.remote ?? false
+    };
+    this.collections.variableCollections[fullCollection.id] = fullCollection;
+    const createdModes = modes.map((m) => this.addModeToCollection(m, fullCollection));
+    fullCollection.defaultModeId = createdModes[0].modeId;
+    return fullCollection;
+  }
+  updateCollection(collectionId, collectionUpdate) {
+    const collection = this.collections.variableCollections[collectionId];
+    if (!collection) throw SupernovaException.notFound(`Collection ${collectionId} was not found`);
+    collection.name = collectionUpdate.name ?? collection.name;
+  }
+  deleteCollection(collectionId) {
+    const deleted = delete this.collections.variableCollections[collectionId];
+    if (!deleted) throw SupernovaException.notFound(`Collection ${collectionId} was not found`);
+  }
+  //
+  // Modes
+  //
+  addMode(mode) {
+    const { collectionId, ...rest } = mode;
+    const collection = this.collections.variableCollections[collectionId];
+    if (!collection) {
+      throw SupernovaException.notFound(`Collection ${collectionId} was not found`);
+    }
+    return this.addModeToCollection(rest, collection);
+  }
+  addModeToCollection(mode, collection) {
+    const fullMode = {
+      ...mode,
+      modeId: this.nextModeId()
+    };
+    collection.modes.push(fullMode);
+    Object.values(this.collections.variables).forEach((v) => {
+      if (v.variableCollectionId !== collection.id) return;
+      const defaultValue = v.valuesByMode[collection.defaultModeId];
+      if (!defaultValue) {
+        throw SupernovaException.shouldNotHappen(`Could not resolve default value for variable ${v.id}`);
+      }
+      v.valuesByMode[fullMode.modeId] = defaultValue;
+    });
+    return fullMode;
+  }
+  //
+  // Variables
+  //
+  addVariable(variable) {
+    const collection = this.collections.variableCollections[variable.variableCollectionId];
+    if (!collection) {
+      const availableCollections = Object.keys(this.collections.variableCollections).join(",");
+      throw SupernovaException.notFound(
+        `Variable ${variable.name} references non-existent collection ${variable.variableCollectionId}, available collections are: [${availableCollections}]. Make sure you've added collection using '.addCollection()' before adding variable to it`
+      );
+    }
+    return this.addVariableToCollection(variable, collection);
+  }
+  updateVariable(variableId, data) {
+    const variable = this.collections.variables[variableId];
+    if (!variable) throw SupernovaException.notFound(`Variable ${variableId} was not found`);
+    variable.scopes = data.scopes ?? variable.scopes;
+  }
+  deleteVariable(variableId) {
+    const deleted = delete this.collections.variables[variableId];
+    if (!deleted) throw SupernovaException.notFound(`Variable ${variableId} was not found`);
+    this.collections.variablesOrder = this.collections.variablesOrder?.filter((id) => id !== variableId);
+  }
+  addVariableToCollection(variable, collection) {
+    const valuesByMode = {};
+    for (const mode of collection.modes) {
+      valuesByMode[mode.modeId] = variable.defaultValue;
+    }
+    const { defaultValue, ...rest } = variable;
+    const fullVariable = {
+      ...rest,
+      id: this.nextVariableId(),
+      description: variable.description ?? "",
+      hiddenFromPublishing: variable.hiddenFromPublishing ?? false,
+      remote: variable.remote ?? false,
+      valuesByMode,
+      key: randomUUID(),
+      scopes: variable.scopes ?? ["ALL_SCOPES"]
+    };
+    this.collections.variables[fullVariable.id] = fullVariable;
+    this.collections.variablesOrder.push(fullVariable.id);
+    return fullVariable;
+  }
+  //
+  // Output
+  //
+  buildPayload(payloadPart = {}) {
+    return {
+      ...payloadPart,
+      isTokenTypeSplitEnabled: payloadPart.isTokenTypeSplitEnabled ?? true,
+      type: "FigmaVariablesPlugin",
+      remoteId: payloadPart.remoteId ?? "test-fvp-source",
+      sourceName: "Test FVP source",
+      brandPersistentId: this.input.brandPersistentId,
+      payload: this.buildCollections()
+    };
+  }
+  buildCollections() {
+    return structuredClone(this.collections);
+  }
+  //
+  // ID Generation
+  //
+  nextModeId() {
+    return this.nextId();
+  }
+  nextCollectionId() {
+    return this.nextId("VariableCollectionId");
+  }
+  nextVariableId() {
+    return this.nextId("VariableID");
+  }
+  nextId(prefix) {
+    let id = `1:${this.figmaIdCounter}`;
+    this.figmaIdCounter++;
+    if (prefix) id = `${prefix}:${id}`;
+    return id;
+  }
+};
 export {
   BackendFeatureRoomYDoc,
   BackendForgeProjectRoomYDoc,
@@ -20845,6 +21021,7 @@ export {
   StorybookHostingEndpoint,
   StringVariableScopeType,
   SupernovaApiClient,
+  TestFVPDataBuilder,
   ThemesEndpoint,
   ThreadRoomBaseYDoc,
   ThreadsEndpoint,