@supernova-studio/client 0.58.8 → 0.58.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supernova-studio/client",
-  "version": "0.58.8",
+  "version": "0.58.9",
   "description": "Supernova Data Models",
   "source": "src/index.ts",
   "main": "dist/index.js",

package/src/api/dto/design-systems/data-source.ts

@@ -10,6 +10,12 @@ import {
 } from "@supernova-studio/model";
 import { z } from "zod";
 
+//
+// Read
+//
+
+export const DTODataSourceFigmaScope = DataSourceFigmaScope;
+
 const DTODataSourceFigmaFileVersion = z.object({
   id: z.string(),
   created_at: z.coerce.date(),
@@ -36,7 +42,7 @@ export const DTODataSourceFigma = z.object({
   id: z.string(),
   type: z.literal(DataSourceRemoteType.Enum.Figma),
   fileName: z.string(),
-  scope: DataSourceFigmaScope,
+  scope: DTODataSourceFigmaScope,
   brandId: z.string(),
   themeId: z.string().nullish(),
   cloud: DTODataSourceFigmaCloud.nullish(),
@@ -104,7 +110,7 @@ export const DTODataSourcesListResponse = z.object({
   sources: z.array(DTODataSource),
 });
 
-export const DTODataSourceCreationResponse = z.object({
+export const DTODataSourceResponse = z.object({
   source: DTODataSource,
 });
 
@@ -112,5 +118,24 @@ export type DTODataSourceFigma = z.infer<typeof DTODataSourceFigma>;
 export type DTODataSourceTokenStudio = z.infer<typeof DTODataSourceTokenStudio>;
 export type DTODataSourceFigmaVariablesPlugin = z.infer<typeof DTODataSourceFigmaVariablesPlugin>;
 export type DTODataSource = z.infer<typeof DTODataSource>;
-export type DTODataSourceCreationResponse = z.infer<typeof DTODataSourceCreationResponse>;
+export type DTODataSourceResponse = z.infer<typeof DTODataSourceResponse>;
 export type DTODataSourcesListResponse = z.infer<typeof DTODataSourcesListResponse>;
+
+//
+// Write
+//
+
+export const DTODataSourceFigmaCreatePayload = z.object({
+  brandPersistentId: z.string(),
+  figmaFileUrl: z.string(),
+  scope: DTODataSourceFigmaScope,
+  autoImportMode: DataSourceAutoImportMode,
+});
+
+export const DTODataSourceFigmaImportPayload = z.object({
+  sourceIds: z.array(z.string()),
+});
+
+export type DTODataSourceFigmaScope = z.infer<typeof DTODataSourceFigmaScope>;
+export type DTODataSourceFigmaCreatePayload = z.infer<typeof DTODataSourceFigmaCreatePayload>;
+export type DTODataSourceFigmaImportPayload = z.infer<typeof DTODataSourceFigmaImportPayload>;

package/src/api/endpoints/design-system/sources.ts

@@ -1,10 +1,23 @@
 import { z } from "zod";
-import { DTODataSourcesListResponse } from "../../dto";
+import {
+  DTODataSourceFigmaCreatePayload,
+  DTODataSourceFigmaImportPayload,
+  DTODataSourceResponse,
+  DTODataSourcesListResponse,
+  DTOImportJobResponse,
+} from "../../dto";
 import { RequestExecutor } from "../../transport/request-executor";
 
 export class DesignSystemSourcesEndpoint {
   constructor(private readonly requestExecutor: RequestExecutor) {}
 
+  create(dsId: string, payload: DTODataSourceFigmaCreatePayload) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/sources`, DTODataSourceResponse, {
+      method: "POST",
+      body: payload,
+    });
+  }
+
   list(dsId: string) {
     return this.requestExecutor.json(`/design-systems/${dsId}/sources`, DTODataSourcesListResponse);
   }
@@ -12,4 +25,11 @@ export class DesignSystemSourcesEndpoint {
   delete(dsId: string, sourceId: string) {
     return this.requestExecutor.json(`/design-systems/${dsId}/sources/${sourceId}`, z.any(), { method: "DELETE" });
   }
+
+  figmaImport(dsId: string, payload: DTODataSourceFigmaImportPayload) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/versions/head/cloud-import`, DTOImportJobResponse, {
+      method: "POST",
+      body: payload,
+    });
+  }
 }

package/src/api/endpoints/design-system/versions/elements-action.ts

@@ -2,8 +2,6 @@ import {
   DTOCreateDocumentationGroupInput,
   DTOCreateDocumentationPageInputV2,
   DTOCreateDocumentationTabInput,
-  DTODocumentationStructure,
-  DTODocumentationStructureItem,
   DTOElementActionOutput,
   DTOMoveDocumentationGroupInput,
   DTOUpdateDocumentationGroupInput,
@@ -11,7 +9,7 @@ import {
 } from "../../../dto";
 import { RequestExecutor } from "../../../transport/request-executor";
 
-export class ElementsActionsEndpoint {
+export class ElementsActionEndpoint {
   constructor(private readonly requestExecutor: RequestExecutor) {}
 
   async createDocPage(dsId: string, vId: string, input: DTOCreateDocumentationPageInputV2) {

package/src/api/endpoints/design-system/versions/index.ts

@@ -2,7 +2,6 @@ export * from "./brands";
 export * from "./components";
 export * from "./documentation";
 export * from "./elements-action";
-export * from "./elements-actions";
 export * from "./import-jobs";
 export * from "./overrides";
 export * from "./property-definitions";

package/src/api/endpoints/design-system/versions/versions.ts

@@ -8,7 +8,7 @@ import { RequestExecutor } from "../../../transport/request-executor";
 import { BrandsEndpoint } from "./brands";
 import { DesignSystemComponentEndpoint } from "./components";
 import { DocumentationEndpoint } from "./documentation";
-import { ElementsActionsEndpoint } from "./elements-actions";
+import { ElementsActionEndpoint } from "./elements-action";
 import { ImportJobsEndpoint } from "./import-jobs";
 import { ElementPropertyDefinitionsEndpoint } from "./property-definitions";
 import { ElementPropertyValuesEndpoint } from "./property-values";
@@ -28,7 +28,7 @@ export class DesignSystemVersionsEndpoint {
   readonly stats: VersionStatsEndpoint;
   readonly elementPropertyDefinitions: ElementPropertyDefinitionsEndpoint;
   readonly elementPropertyValues: ElementPropertyValuesEndpoint;
-  readonly elementsActions: ElementsActionsEndpoint;
+  readonly elementsAction: ElementsActionEndpoint;
   readonly designSystemComponents: DesignSystemComponentEndpoint;
   readonly documentation: DocumentationEndpoint;
 
@@ -42,7 +42,7 @@ export class DesignSystemVersionsEndpoint {
     this.stats = new VersionStatsEndpoint(requestExecutor);
     this.elementPropertyDefinitions = new ElementPropertyDefinitionsEndpoint(requestExecutor);
     this.elementPropertyValues = new ElementPropertyValuesEndpoint(requestExecutor);
-    this.elementsActions = new ElementsActionsEndpoint(requestExecutor);
+    this.elementsAction = new ElementsActionEndpoint(requestExecutor);
     this.designSystemComponents = new DesignSystemComponentEndpoint(requestExecutor);
     this.documentation = new DocumentationEndpoint(requestExecutor);
   }

package/src/api/endpoints/design-system/versions/elements-actions.ts

@@ -1,20 +0,0 @@
-import { DTOCreateDocumentationPageInputV2, DTOElementActionOutput } from "../../../dto";
-import { RequestExecutor } from "../../../transport/request-executor";
-
-export class ElementsActionsEndpoint {
-  constructor(private readonly requestExecutor: RequestExecutor) {}
-
-  async createDocPage(dsId: string, vId: string, input: DTOCreateDocumentationPageInputV2) {
-    return this.requestExecutor.json(
-      `/design-systems/${dsId}/versions/${vId}/elements-action`,
-      DTOElementActionOutput,
-      {
-        body: {
-          type: "DocumentationPageCreate",
-          input,
-        },
-        method: "POST",
-      }
-    );
-  }
-}