@supernova-studio/client 1.96.5 → 1.96.7

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

@@ -0,0 +1,14 @@
+import { DTODocumentationAnalyticsRequest, DTODocumentationPageAnalyticsResponse } from "../../dto";
+import { RequestExecutor } from "../../transport/request-executor";
+
+export class DesignSystemAnalyticsEndpoint {
+  constructor(private readonly requestExecutor: RequestExecutor) {}
+
+  get(designSystemId: string, versionId: string, body: DTODocumentationAnalyticsRequest) {
+    return this.requestExecutor.json(
+      `/design-systems/${designSystemId}/versions/${versionId}/documentation/analytics`,
+      DTODocumentationPageAnalyticsResponse,
+      { method: "POST", body }
+    );
+  }
+}

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

@@ -0,0 +1,13 @@
+import { DTOBffImportRequestBody, DTOImportJobResponse } from "../../dto";
+import { RequestExecutor } from "../../transport/request-executor";
+
+export class DesignSystemBffEndpoint {
+  constructor(private readonly requestExecutor: RequestExecutor) {}
+
+  import(dsId: string, payload: DTOBffImportRequestBody) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/bff/import`, DTOImportJobResponse, {
+      method: "POST",
+      body: payload,
+    });
+  }
+}

package/src/api/endpoints/design-system/code-snapshots.ts

@@ -0,0 +1,47 @@
+import {
+  DTOCodeSnapshotFinalizeResponse,
+  DTOCodeSnapshotProcessingRunResponse,
+  DTOCodeSnapshotProcessingRunStatusResponse,
+  DTOCodeSnapshotUploadInitResponse,
+} from "../../dto";
+import {
+  DTOCodeSnapshotFinalizePayload,
+  DTOCodeSnapshotStartProcessingRunPayload,
+  DTOCodeSnapshotUploadInitPayload,
+} from "../../payloads";
+import { RequestExecutor } from "../../transport";
+
+export class DesignSystemCodeSnapshotsEndpoint {
+  constructor(private readonly requestExecutor: RequestExecutor) {}
+
+  uploadInit(body: DTOCodeSnapshotUploadInitPayload) {
+    return this.requestExecutor.json(`/code-snapshots/upload`, DTOCodeSnapshotUploadInitResponse, {
+      method: "POST",
+      body,
+    });
+  }
+
+  finalize(snapshotId: string, body?: DTOCodeSnapshotFinalizePayload) {
+    return this.requestExecutor.json(`/code-snapshots/${snapshotId}/finalize`, DTOCodeSnapshotFinalizeResponse, {
+      method: "POST",
+      body,
+    });
+  }
+
+  startProcessingRun(body: DTOCodeSnapshotStartProcessingRunPayload) {
+    return this.requestExecutor.json(`/code-snapshots/process-run`, DTOCodeSnapshotProcessingRunResponse, {
+      method: "POST",
+      body,
+    });
+  }
+
+  getProcessingRunStatus(designSystemId: string) {
+    return this.requestExecutor.json(
+      `/code-snapshots/process-status/${encodeURIComponent(designSystemId)}`,
+      DTOCodeSnapshotProcessingRunStatusResponse,
+      {
+        method: "GET",
+      }
+    );
+  }
+}

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

@@ -0,0 +1,12 @@
+import { DTODesignSystemContactsResponse } from "../../dto";
+import { RequestExecutor } from "../../transport/request-executor";
+
+export class DesignSystemContactsEndpoint {
+  constructor(private readonly requestExecutor: RequestExecutor) {}
+
+  list(dsId: string) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/contacts`, DTODesignSystemContactsResponse, {
+      method: "GET",
+    });
+  }
+}

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

@@ -0,0 +1,90 @@
+import { z } from "zod";
+import {
+  DTODesignSystemCreateInput,
+  DTODesignSystemResponse,
+  DTODesignSystemsListResponse,
+  DTOUserDesignSystemsResponse,
+} from "../../dto";
+import {
+  DTODesignSystemUpdateAccessModeInput,
+  DTODesignSystemUpdateInput,
+  DTODesignSystemUpdateSwitcherInput,
+} from "../../payloads";
+import { RequestExecutor } from "../../transport/request-executor";
+import { DesignSystemAnalyticsEndpoint } from "./analytics";
+import { DesignSystemBffEndpoint } from "./bff";
+import { DesignSystemCodeSnapshotsEndpoint } from "./code-snapshots";
+import { DesignSystemContactsEndpoint } from "./contact";
+import { FigmaNodeStructuresEndpoint } from "./figma-node-structures";
+import { DesignSystemMembersEndpoint } from "./members";
+import { DesignSystemPageRedirectsEndpoint } from "./redirects";
+import { DesignSystemSourcesEndpoint } from "./sources";
+import { StorybookEntriesEndpoint } from "./storybook";
+import { DesignSystemVersionsEndpoint } from "./versions/versions";
+
+export class DesignSystemsEndpoint {
+  readonly members: DesignSystemMembersEndpoint;
+  readonly versions: DesignSystemVersionsEndpoint;
+  readonly bff: DesignSystemBffEndpoint;
+  readonly codeSnapshots: DesignSystemCodeSnapshotsEndpoint;
+  readonly sources: DesignSystemSourcesEndpoint;
+  readonly storybook: StorybookEntriesEndpoint;
+  readonly contacts: DesignSystemContactsEndpoint;
+  readonly redirects: DesignSystemPageRedirectsEndpoint;
+  readonly figmaNodeStructures: FigmaNodeStructuresEndpoint;
+  readonly analytics: DesignSystemAnalyticsEndpoint;
+
+  constructor(private readonly requestExecutor: RequestExecutor) {
+    this.members = new DesignSystemMembersEndpoint(requestExecutor);
+    this.versions = new DesignSystemVersionsEndpoint(requestExecutor);
+    this.bff = new DesignSystemBffEndpoint(requestExecutor);
+    this.codeSnapshots = new DesignSystemCodeSnapshotsEndpoint(requestExecutor);
+    this.sources = new DesignSystemSourcesEndpoint(requestExecutor);
+    this.storybook = new StorybookEntriesEndpoint(requestExecutor);
+    this.contacts = new DesignSystemContactsEndpoint(requestExecutor);
+    this.redirects = new DesignSystemPageRedirectsEndpoint(requestExecutor);
+    this.figmaNodeStructures = new FigmaNodeStructuresEndpoint(requestExecutor);
+    this.analytics = new DesignSystemAnalyticsEndpoint(requestExecutor);
+  }
+
+  create(body: DTODesignSystemCreateInput) {
+    return this.requestExecutor.json("/design-systems", DTODesignSystemResponse, { method: "POST", body });
+  }
+
+  list(wsId: string) {
+    return this.requestExecutor.json(`/workspaces/${wsId}/design-systems`, DTODesignSystemsListResponse);
+  }
+
+  listUserDesignSystems() {
+    return this.requestExecutor.json("/design-systems", DTOUserDesignSystemsResponse);
+  }
+
+  get(dsId: string) {
+    return this.requestExecutor.json(`/design-systems/${dsId}`, DTODesignSystemResponse);
+  }
+
+  delete(dsId: string) {
+    return this.requestExecutor.json(`/design-systems/${dsId}`, z.any(), { method: "DELETE" });
+  }
+
+  update(dsId: string, body: DTODesignSystemUpdateInput) {
+    return this.requestExecutor.json(`/design-systems/${dsId}`, DTODesignSystemResponse, {
+      method: "PUT",
+      body,
+    });
+  }
+
+  updateSwitcher(dsId: string, body: DTODesignSystemUpdateSwitcherInput) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/switcher`, DTODesignSystemResponse, {
+      method: "PUT",
+      body,
+    });
+  }
+
+  updateAccessMode(dsId: string, body: DTODesignSystemUpdateAccessModeInput) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/access-mode`, DTODesignSystemResponse, {
+      method: "PUT",
+      body,
+    });
+  }
+}

package/src/api/endpoints/design-system/figma-node-structures.ts

@@ -0,0 +1,20 @@
+import { DTOFigmaNodeStructureDetailResponse, DTOFigmaNodeStructureListResponse } from "../../dto";
+import { RequestExecutor } from "../../transport/request-executor";
+
+export class FigmaNodeStructuresEndpoint {
+  constructor(private readonly requestExecutor: RequestExecutor) {}
+
+  list(dsId: string) {
+    return this.requestExecutor.json(
+      `/design-systems/${dsId}/figma-node-structures`,
+      DTOFigmaNodeStructureListResponse
+    );
+  }
+
+  get(dsId: string, structureId: string) {
+    return this.requestExecutor.json(
+      `/design-systems/${dsId}/figma-node-structures/${structureId}`,
+      DTOFigmaNodeStructureDetailResponse
+    );
+  }
+}

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

@@ -0,0 +1,11 @@
+export * from "./versions";
+export * from "./analytics";
+export * from "./bff";
+export * from "./code-snapshots";
+export * from "./contact";
+export * from "./design-systems";
+export * from "./figma-node-structures";
+export * from "./members";
+export * from "./redirects";
+export * from "./sources";
+export * from "./storybook";

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

@@ -0,0 +1,24 @@
+import {
+  DTODesignSystemMemberListResponse,
+  DTODesignSystemMembersUpdatePayload,
+  DTODesignSystemMembersUpdateResponse,
+  DTOUserGetResponse,
+} from "../../dto";
+import { RequestExecutor } from "../../transport/request-executor";
+
+export class DesignSystemMembersEndpoint {
+  constructor(private readonly requestExecutor: RequestExecutor) {}
+
+  list(dsId: string) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/members`, DTODesignSystemMemberListResponse, {
+      method: "GET",
+    });
+  }
+
+  update(dsId: string, body: DTODesignSystemMembersUpdatePayload) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/members`, DTODesignSystemMembersUpdateResponse, {
+      method: "POST",
+      body,
+    });
+  }
+}

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

@@ -0,0 +1,46 @@
+import {
+  DTOPageRedirectDeleteResponse,
+  DTOPageRedirectListResponse,
+  DTOPageRedirectResponse,
+  DTOPageRedirectCreateBody,
+  DTOPageRedirectUpdateBody,
+} from "../../dto/design-systems/redirects";
+import { RequestExecutor } from "../../transport/request-executor";
+
+export class DesignSystemPageRedirectsEndpoint {
+  constructor(private readonly requestExecutor: RequestExecutor) {}
+
+  create(dsId: string, body: DTOPageRedirectCreateBody) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/documentation/redirects`, DTOPageRedirectResponse, {
+      body,
+      method: "POST",
+    });
+  }
+
+  list(dsId: string) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/documentation/redirects`, DTOPageRedirectListResponse, {
+      method: "GET",
+    });
+  }
+
+  update(dsId: string, redirectId: string, body: DTOPageRedirectUpdateBody) {
+    return this.requestExecutor.json(
+      `/design-systems/${dsId}/documentation/redirects/${redirectId}`,
+      DTOPageRedirectResponse,
+      {
+        body,
+        method: "PUT",
+      }
+    );
+  }
+
+  delete(dsId: string, redirectId: string) {
+    return this.requestExecutor.json(
+      `/design-systems/${dsId}/documentation/redirects/${redirectId}`,
+      DTOPageRedirectDeleteResponse,
+      {
+        method: "DELETE",
+      }
+    );
+  }
+}

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

@@ -0,0 +1,80 @@
+import { z } from "zod";
+import {
+  DTODataSourceFigmaCreatePayload,
+  DTODataSourceFigmaImportPayload,
+  DTODataSourceResponse,
+  DTODataSourcesListResponse,
+  DTODataSourcesStorybookResponse,
+  DTODataSourceStorybookCreatePayload,
+  DTOFigmaSourceUpdatePayload,
+  DTOImportJobResponse,
+  DTOStorybookImportPayload,
+  DTOStorybookSourceUpdatePayload,
+} from "../../dto";
+import { RequestExecutor } from "../../transport/request-executor";
+
+export class DesignSystemSourcesEndpoint {
+  constructor(private readonly requestExecutor: RequestExecutor) {}
+
+  create(dsId: string, payload: DTODataSourceFigmaCreatePayload | DTODataSourceStorybookCreatePayload) {
+    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);
+  }
+
+  get(dsId: string, sourceId: string) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/sources/${sourceId}`, DTODataSourceResponse);
+  }
+
+  delete(dsId: string, sourceId: string) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/sources/${sourceId}`, z.any(), { method: "DELETE" });
+  }
+
+  updateFigmaSource(dsId: string, sourceId: string, payload: DTOFigmaSourceUpdatePayload) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/sources/${sourceId}`, DTODataSourceResponse, {
+      method: "PUT",
+      body: payload,
+    });
+  }
+
+  updateStorybookSource(dsId: string, sourceId: string, payload: DTOStorybookSourceUpdatePayload) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/sources/${sourceId}`, DTODataSourceResponse, {
+      method: "PUT",
+      body: payload,
+    });
+  }
+
+  figmaImport(dsId: string, payload: DTODataSourceFigmaImportPayload) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/versions/head/cloud-import`, DTOImportJobResponse, {
+      method: "POST",
+      body: payload,
+    });
+  }
+
+  storybookImport(dsId: string, payload: DTOStorybookImportPayload) {
+    return this.requestExecutor.json(
+      `/design-systems/${dsId}/versions/head/storybook-import`,
+      DTODataSourcesStorybookResponse,
+      {
+        method: "POST",
+        body: payload,
+      }
+    );
+  }
+
+  updateStorybookImport(dsId: string, versionId: string, payload: DTOStorybookImportPayload) {
+    return this.requestExecutor.json(
+      `/design-systems/${dsId}/versions/${versionId}/storybook-import`,
+      DTODataSourcesStorybookResponse,
+      {
+        method: "POST",
+        body: payload,
+      }
+    );
+  }
+}

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

@@ -0,0 +1,28 @@
+import { pickDefined } from "@supernova-studio/model";
+import { z } from "zod";
+import { DTOStorybookEntryListResponse, DTOStorybookEntryQuery, DTOStorybookEntryReplaceAction } from "../../dto";
+import { RequestExecutor } from "../../transport/request-executor";
+
+export class StorybookEntriesEndpoint {
+  constructor(private readonly requestExecutor: RequestExecutor) {}
+
+  list(dsId: string, query: DTOStorybookEntryQuery = {}) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/versions/head/storybook`, DTOStorybookEntryListResponse, {
+      query: new URLSearchParams(pickDefined(query)),
+    });
+  }
+
+  replace(dsId: string, entryId: string) {
+    return this.requestExecutor.json(
+      `/design-systems/${dsId}/versions/head/storybook/${entryId}`,
+      DTOStorybookEntryReplaceAction,
+      { method: "PUT" }
+    );
+  }
+
+  delete(dsId: string, entryId: string) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/versions/head/storybook/${entryId}`, z.any(), {
+      method: "DELETE",
+    });
+  }
+}

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

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { DTOBrandCreatePayload, DTOBrandGetResponse, DTOBrandsListResponse, DTOBrandUpdatePayload } from "../../../dto";
+import { RequestExecutor } from "../../../transport/request-executor";
+
+export class BrandsEndpoint {
+  constructor(private readonly requestExecutor: RequestExecutor) {}
+
+  get(designSystemId: string, versionId: string, brandId: string) {
+    return this.requestExecutor.json(
+      `/design-systems/${designSystemId}/versions/${versionId}/brands/${brandId}`,
+      DTOBrandGetResponse
+    );
+  }
+
+  list(designSystemId: string, versionId: string) {
+    return this.requestExecutor.json(
+      `/design-systems/${designSystemId}/versions/${versionId}/brands`,
+      DTOBrandsListResponse
+    );
+  }
+
+  create(designSystemId: string, versionId: string, body: DTOBrandCreatePayload) {
+    return this.requestExecutor.json(
+      `/design-systems/${designSystemId}/versions/${versionId}/brands`,
+      DTOBrandGetResponse,
+      {
+        method: "POST",
+        body,
+      }
+    );
+  }
+
+  update(dsId: string, vId: string, brandId: string, body: DTOBrandUpdatePayload) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/versions/${vId}/brands/${brandId}`, DTOBrandGetResponse, {
+      method: "PUT",
+      body,
+    });
+  }
+
+  delete(dsId: string, vId: string, brandId: string) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/versions/${vId}/brands/${brandId}`, z.any(), {
+      method: "DELETE",
+    });
+  }
+}

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

@@ -0,0 +1,107 @@
+import {
+  DTODocumentationConfigurationResponse,
+  DTODocumentationContentResponse,
+  DTODocumentationMinimalPageListResponse,
+  DTODocumentationPageContentGetResponse,
+  DTODocumentationPageRoomResponse,
+  DTODocumentationSearchIndexResponse,
+  DTODocumentationSearchQuery,
+  DTODocumentationSearchResponse,
+  DTODocumentationStructure,
+  DTOPublishDocumentationRequest,
+  DTOPublishDocumentationResponse,
+} from "../../../dto";
+import { DTOGetBlockDefinitionsOutput } from "../../../payloads";
+import { RequestExecutor } from "../../../transport/request-executor";
+
+export class DocumentationEndpoint {
+  constructor(private readonly requestExecutor: RequestExecutor) {}
+
+  async getConfiguration(designSystemId: string, versionId: string) {
+    return await this.requestExecutor.json(
+      `/design-systems/${designSystemId}/versions/${versionId}/documentation`,
+      DTODocumentationConfigurationResponse
+    );
+  }
+
+  async getStructure(designSystemId: string, versionId: string) {
+    return await this.requestExecutor.json(
+      `/design-systems/${designSystemId}/versions/${versionId}/documentation/structure`,
+      DTODocumentationStructure
+    );
+  }
+
+  async getDocStructure(dsId: string, vId: string) {
+    return await this.requestExecutor.json(
+      `/design-systems/${dsId}/versions/${vId}/documentation/structure`,
+      DTODocumentationStructure
+    );
+  }
+
+  async getPageRoom(dsId: string, vId: string, pageId: string) {
+    return await this.requestExecutor.json(
+      `/design-systems/${dsId}/versions/${vId}/documentation/pages/${pageId}/room`,
+      DTODocumentationPageRoomResponse
+    );
+  }
+
+  async getBlockDefinitions(dsId: string, vId: string) {
+    return await this.requestExecutor.json(
+      `/design-systems/${dsId}/versions/${vId}/documentation/block-definitions`,
+      DTOGetBlockDefinitionsOutput
+    );
+  }
+
+  async publish(dsId: string, vId: string, body: DTOPublishDocumentationRequest) {
+    return await this.requestExecutor.json(
+      `/design-systems/${dsId}/versions/${vId}/documentation/publish`,
+      DTOPublishDocumentationResponse,
+      {
+        method: "POST",
+        body,
+      }
+    );
+  }
+
+  documentationPageContent(dsId: string, versionId: string, pageId: string) {
+    return this.requestExecutor.json(
+      `/design-systems/${dsId}/versions/${versionId}/documentation/pages/${pageId}/content`,
+      DTODocumentationPageContentGetResponse
+    );
+  }
+
+  list(dsId: string, versionId: string) {
+    return this.requestExecutor.json(
+      `/design-systems/${dsId}/versions/${versionId}/documentation/pages`,
+      DTODocumentationMinimalPageListResponse
+    );
+  }
+
+  getContent(dsId: string, versionId: string, pageIds: string[]) {
+    return this.requestExecutor.json(
+      `/design-systems/${dsId}/versions/${versionId}/documentation/content`,
+      DTODocumentationContentResponse,
+      {
+        query: new URLSearchParams({
+          pageIds: pageIds.join(","),
+        }),
+      }
+    );
+  }
+
+  buildSearchIndex(dsId: string) {
+    return this.requestExecutor.json(
+      `/design-systems/${dsId}/documentation-search/index`,
+      DTODocumentationSearchIndexResponse,
+      { method: "POST" }
+    );
+  }
+
+  search(dsId: string, body: DTODocumentationSearchQuery) {
+    return this.requestExecutor.json(
+      `/design-systems/${dsId}/documentation-search/query`,
+      DTODocumentationSearchResponse,
+      { method: "POST", body }
+    );
+  }
+}

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

@@ -0,0 +1,30 @@
+import { pickDefined } from "@supernova-studio/model";
+import {
+  DTODesignSystemComponentCreateInput,
+  DTODesignSystemComponentListResponse,
+  DTODesignSystemComponentResponse,
+} from "../../../dto/design-systems/component";
+import { RequestExecutor } from "../../../transport/request-executor";
+
+export class DesignSystemComponentEndpoint {
+  constructor(private readonly requestExecutor: RequestExecutor) {}
+
+  async list(dsId: string, vId: string, brandId?: string) {
+    return this.requestExecutor.json(
+      `/design-systems/${dsId}/versions/${vId}/design-system-components`,
+      DTODesignSystemComponentListResponse,
+      { query: new URLSearchParams(pickDefined({ brandId })) }
+    );
+  }
+
+  async create(dsId: string, vId: string, body: DTODesignSystemComponentCreateInput) {
+    return this.requestExecutor.json(
+      `/design-systems/${dsId}/versions/${vId}/design-system-components`,
+      DTODesignSystemComponentResponse,
+      {
+        body,
+        method: "POST",
+      }
+    );
+  }
+}

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

@@ -0,0 +1,65 @@
+import {
+  DTOCreateDocumentationGroupInput,
+  DTOCreateDocumentationPageInputV2,
+  DTOCreateDocumentationTabInput,
+  DTOElementActionInput,
+  DTOElementActionOutput,
+  DTOElementPropertyValueUpsertPaylod,
+  DTOFigmaNodeRenderInput,
+  DTOMoveDocumentationGroupInput,
+  DTOUpdateDocumentationGroupInput,
+  DTOUpdateDocumentationPageDocumentInputV2,
+  DTOUpdateDocumentationPageInputV2,
+} from "../../../dto";
+import { RequestExecutor } from "../../../transport/request-executor";
+
+export class ElementsActionEndpoint {
+  constructor(private readonly requestExecutor: RequestExecutor) {}
+
+  async createDocPage(dsId: string, vId: string, input: DTOCreateDocumentationPageInputV2) {
+    return this.action(dsId, vId, { type: "DocumentationPageCreate", input });
+  }
+
+  async createDocGroup(dsId: string, vId: string, input: DTOCreateDocumentationGroupInput) {
+    return this.action(dsId, vId, { type: "DocumentationGroupCreate", input });
+  }
+
+  async moveDocGroup(dsId: string, vId: string, input: DTOMoveDocumentationGroupInput) {
+    return this.action(dsId, vId, { type: "DocumentationGroupMove", input });
+  }
+
+  async updateDocPage(dsId: string, vId: string, input: DTOUpdateDocumentationPageInputV2) {
+    return this.action(dsId, vId, { type: "DocumentationPageUpdate", input });
+  }
+
+  async updateDocPageDocument(dsId: string, vId: string, input: DTOUpdateDocumentationPageDocumentInputV2) {
+    return this.action(dsId, vId, { type: "DocumentationPageUpdateDocument", input });
+  }
+
+  async updateDocGroup(dsId: string, vId: string, input: DTOUpdateDocumentationGroupInput) {
+    return this.action(dsId, vId, { type: "DocumentationGroupUpdate", input });
+  }
+
+  async createDocTab(dsId: string, vId: string, input: DTOCreateDocumentationTabInput) {
+    return this.action(dsId, vId, { type: "DocumentationTabCreate", input });
+  }
+
+  async renderNodesAsync(dsId: string, vId: string, nodes: DTOFigmaNodeRenderInput[]) {
+    return this.action(dsId, vId, { type: "FigmaNodeRenderAsync", nodes });
+  }
+
+  async bulkEditPropertyValues(dsId: string, vId: string, values: DTOElementPropertyValueUpsertPaylod[]) {
+    return this.action(dsId, vId, { type: "ElementPropertyValuesEdit", values });
+  }
+
+  private async action(dsId: string, vId: string, input: DTOElementActionInput) {
+    return this.requestExecutor.json(
+      `/design-systems/${dsId}/versions/${vId}/elements-action`,
+      DTOElementActionOutput,
+      {
+        body: input,
+        method: "POST",
+      }
+    );
+  }
+}

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

@@ -0,0 +1,27 @@
+import { OmitStrict } from "@supernova-studio/model";
+import { serializeQuery } from "../../../../utils";
+import { DTOElementsGetOutput, DTOElementsGetOutputV2, DTOElementsGetQueryParsed } from "../../../dto";
+import { RequestExecutor } from "../../../transport/request-executor";
+
+type GetElementsQuery = OmitStrict<DTOElementsGetQueryParsed, "responseVersion">;
+
+export class ElementsEndpoint {
+  constructor(private readonly requestExecutor: RequestExecutor) {}
+
+  getElementsV1(dsId: string, vId: string, query: GetElementsQuery) {
+    return this.requestExecutor.json(`/design-systems/${dsId}/versions/${vId}/elements`, DTOElementsGetOutput, {
+      query: serializeQuery(query),
+    });
+  }
+
+  getElementsV2(dsId: string, vId: string, query: GetElementsQuery) {
+    const fullQuery: DTOElementsGetQueryParsed = {
+      ...query,
+      responseVersion: 2,
+    };
+
+    return this.requestExecutor.json(`/design-systems/${dsId}/versions/${vId}/elements`, DTOElementsGetOutputV2, {
+      query: serializeQuery(fullQuery),
+    });
+  }
+}