@supernova-studio/client 0.47.43 → 0.47.45

package/package.json

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

package/src/api/conversion/documentation/documentation-group-v2-to-dto.ts

@@ -5,7 +5,7 @@ import {
   ElementGroup,
   groupBy,
 } from "@supernova-studio/model";
-import { DTODocumentationGroupStructureV2, DTODocumentationGroupV2 } from "../../dto";
+import { DTODocumentationGroupV2 } from "../../dto";
 import {
   documentationItemConfigurationToDTOV2,
   getDtoDefaultItemConfigurationV2,
@@ -18,15 +18,6 @@ import { applyPrivacyConfigurationToNestedItems } from "./documentation-page-to-
 //
 // Please do not put more DTO conversion here unless you know what you're doing.
 
-export function elementGroupsToDocumentationGroupStructureDTOV2(
-  groups: ElementGroup[],
-  pages: (DocumentationPageV1 | DocumentationPageV2)[]
-): DTODocumentationGroupStructureV2[] {
-  const childrenIdsMap = calculateChildrenIdsMapV2(pages, groups);
-
-  return groups.map(group => elementGroupToDocumentationGroupStructureDTOV2(group, childrenIdsMap));
-}
-
 export function elementGroupsToDocumentationGroupDTOV2(
   groups: ElementGroup[],
   pages: (DocumentationPageV1 | DocumentationPageV2)[]
@@ -54,7 +45,7 @@ export function elementGroupsToDocumentationGroupFixedConfigurationDTOV2(
 function elementGroupToDocumentationGroupStructureDTOV2(
   group: ElementGroup,
   childrenIdsMap: Map<string, string[]>
-): DTODocumentationGroupStructureV2 {
+): DTODocumentationGroupV2 {
   const childrenIds = childrenIdsMap.get(group.persistentId) ?? [];
 
   if (!group.shortPersistentId) {

package/src/api/conversion/documentation/documentation-page-v2-to-dto.ts

@@ -1,10 +1,10 @@
 import { DocumentationItemConfigurationV2, DocumentationPageV2, ElementGroup } from "@supernova-studio/model";
-import { DTODocumentationPageStructureV2, DTODocumentationPageV2 } from "../../dto";
+import { DTODocumentationPageV2 } from "../../dto";
 import {
   documentationItemConfigurationToDTOV2,
   getDtoDefaultItemConfigurationV2,
 } from "./documentation-item-configuration-v2-to-dto";
-import { buildDocPagePublishPaths, applyPrivacyConfigurationToNestedItems } from "./documentation-page-to-dto-utils";
+import { applyPrivacyConfigurationToNestedItems, buildDocPagePublishPaths } from "./documentation-page-to-dto-utils";
 
 // The fact that DTO conversion is located here instead of main backend code is due to the fact
 // that we store page and group data in YJS documents in the same way as they are stored in the database.
@@ -12,13 +12,13 @@ import { buildDocPagePublishPaths, applyPrivacyConfigurationToNestedItems } from
 //
 // Please do not put more DTO conversion here unless you know what you're doing.
 
-export function documentationPagesToStructureDTOV2(
-  pages: DocumentationPageV2[],
+export function documentationPageToDTOV2(
+  page: DocumentationPageV2,
   groups: ElementGroup[],
   routingVersion: string
-): DTODocumentationPageStructureV2[] {
-  const pathsMap = buildDocPagePublishPaths(groups, pages, routingVersion);
-  return pages.map(page => documentationPageToStructureDTOV2(page, pathsMap));
+): DTODocumentationPageV2 {
+  const pathsMap = buildDocPagePublishPaths(groups, [page], routingVersion);
+  return _documentationPageToDTOV2(page, pathsMap);
 }
 
 export function documentationPagesToDTOV2(
@@ -27,8 +27,7 @@ export function documentationPagesToDTOV2(
   routingVersion: string
 ): DTODocumentationPageV2[] {
   const pathsMap = buildDocPagePublishPaths(groups, pages, routingVersion);
-
-  return pages.map(page => documentationPageToStructureDTOV2(page, pathsMap));
+  return pages.map(page => _documentationPageToDTOV2(page, pathsMap));
 }
 
 export function documentationPagesFixedConfigurationToDTOV2(
@@ -44,13 +43,13 @@ export function documentationPagesFixedConfigurationToDTOV2(
     DocumentationItemConfigurationV2
   >(pages, groups, getDtoDefaultItemConfigurationV2);
 
-  return fixedPages.map(page => documentationPageToStructureDTOV2(page, pathsMap));
+  return fixedPages.map(page => _documentationPageToDTOV2(page, pathsMap));
 }
 
-function documentationPageToStructureDTOV2(
+function _documentationPageToDTOV2(
   page: DocumentationPageV2,
   pagePathMap: Map<string, string>
-): DTODocumentationPageStructureV2 {
+): DTODocumentationPageV2 {
   let path = pagePathMap.get(page.persistentId);
   if (!path) throw new Error(`Path for page ${page.id} was not calculated`);
 

package/src/api/conversion/documentation/index.ts

@@ -1,4 +1,3 @@
-export * from "./documentation-elements-to-hierarchy-v2-dto";
 export * from "./documentation-group-v1-to-dto";
 export * from "./documentation-group-v2-to-dto";
 export * from "./documentation-item-configuration-v1-to-dto";

package/src/api/dto/documentation/documentation-page-snapshot.ts

@@ -0,0 +1,18 @@
+import { DesignElementSnapshotReason } from "@supernova-studio/model";
+import { z } from "zod";
+import { DTODocumentationPageV2 } from "../elements/documentation/page-v2";
+
+export const DTODocumentationPageSnapshot = z.object({
+  id: z.string(),
+  designSystemVersionId: z.string(),
+
+  createdAt: z.string(),
+  updatedAt: z.string(),
+
+  documentationPage: DTODocumentationPageV2,
+  pageContentHash: z.string(),
+
+  reason: DesignElementSnapshotReason,
+});
+
+export type DTODocumentationPageSnapshot = z.infer<typeof DTODocumentationPageSnapshot>;

package/src/api/dto/documentation/index.ts

@@ -1,2 +1,3 @@
 export * from "./anchor";
+export * from "./documentation-page-snapshot";
 export * from "./link-preview";

package/src/api/dto/elements/documentation/draft-state.ts

@@ -3,8 +3,12 @@ import { DTODocumentationItemConfigurationV2 } from "./item-configuration-v2";
 
 export const DTODocumentationDraftChangeType = z.enum(["Created", "Updated", "Deleted"]);
 
-export const DTODocumentationDraftState = z.object({
-  changeType: DTODocumentationDraftChangeType,
+export const DTODocumentationDraftStateCreated = z.object({
+  changeType: z.literal(DTODocumentationDraftChangeType.enum.Created),
+});
+
+export const DTODocumentationDraftStateUpdated = z.object({
+  changeType: z.literal(DTODocumentationDraftChangeType.enum.Updated),
   changes: z.object({
     previousTitle: z.string().optional(),
     previousConfiguration: DTODocumentationItemConfigurationV2.optional(),
@@ -12,5 +16,20 @@ export const DTODocumentationDraftState = z.object({
   }),
 });
 
+export const DTODocumentationDraftStateDeleted = z.object({
+  changeType: z.literal(DTODocumentationDraftChangeType.enum.Deleted),
+});
+
+export const DTODocumentationDraftState = z.discriminatedUnion("changeType", [
+  DTODocumentationDraftStateCreated,
+  DTODocumentationDraftStateUpdated,
+  DTODocumentationDraftStateDeleted,
+]);
+
 export type DTODocumentationDraftChangeType = z.infer<typeof DTODocumentationDraftChangeType>;
+
+export type DTODocumentationDraftStateCreated = z.infer<typeof DTODocumentationDraftStateCreated>;
+export type DTODocumentationDraftStateUpdated = z.infer<typeof DTODocumentationDraftStateUpdated>;
+export type DTODocumentationDraftStateDeleted = z.infer<typeof DTODocumentationDraftStateDeleted>;
+
 export type DTODocumentationDraftState = z.infer<typeof DTODocumentationDraftState>;

package/src/api/dto/elements/documentation/group-v2.ts

@@ -7,10 +7,6 @@ import { DTODocumentationItemConfigurationV2 } from "./item-configuration-v2";
 // Read
 //
 
-/**
- * Structure DTO is element properties minus element data (in other words data required
- * to display the element in the left panel)
- */
 export const DTODocumentationGroupV2 = ElementGroup.omit({
   sortOrder: true,
   parentPersistentId: true,
@@ -32,10 +28,7 @@ export const DTODocumentationGroupV2 = ElementGroup.omit({
   draftState: DTODocumentationDraftState.optional(),
 });
 
-export const DTODocumentationGroupStructureV2 = DTODocumentationGroupV2;
-
 export type DTODocumentationGroupV2 = z.infer<typeof DTODocumentationGroupV2>;
-export type DTODocumentationGroupStructureV2 = DTODocumentationGroupV2;
 
 //
 // Write

package/src/api/dto/elements/documentation/hierarchy.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { DTODocumentationDraftState } from "./draft-state";
+import { DTODocumentationGroupV2 } from "./group-v2";
+import { DTODocumentationPageV2 } from "./page-v2";
+
+export const DTODocumentationHierarchyV2 = z.object({
+  pages: z.array(
+    DTODocumentationPageV2.extend({
+      /** Defined when a page has changed since last publish and can be included into a partial publish */
+      draftState: DTODocumentationDraftState.optional(),
+    })
+  ),
+
+  groups: z.array(
+    DTODocumentationGroupV2.extend({
+      /** Defined when a page has changed since last publish and can be included into a partial publish */
+      draftState: DTODocumentationDraftState.optional(),
+    })
+  ),
+
+  deletedPages: z.array(
+    DTODocumentationPageV2.extend({
+      /** Deleted page is always a draft change */
+      draftState: DTODocumentationDraftState,
+    })
+  ),
+
+  deletedGroups: z.array(
+    DTODocumentationGroupV2.extend({
+      /** Deleted page is always a draft change */
+      draftState: DTODocumentationDraftState,
+    })
+  ),
+});
+
+export type DTODocumentationHierarchyV2 = z.infer<typeof DTODocumentationHierarchyV2>;

package/src/api/dto/elements/documentation/index.ts

@@ -2,6 +2,7 @@ export * from "./draft-state";
 export * from "./group-action";
 export * from "./group-v1";
 export * from "./group-v2";
+export * from "./hierarchy";
 export * from "./item-configuration-v1";
 export * from "./item-configuration-v2";
 export * from "./page-actions-v2";

package/src/api/dto/elements/documentation/page-v2.ts

@@ -1,44 +1,38 @@
-import { DocumentationPageV2 } from "@supernova-studio/model";
 import { z } from "zod";
-import { DTODocumentationGroupStructureV2 } from "./group-v2";
-import { DTODocumentationItemConfigurationV2 } from "./item-configuration-v2";
 import { DTODocumentationDraftState } from "./draft-state";
+import { DTODocumentationItemConfigurationV2 } from "./item-configuration-v2";
+
 //
 // Read
 //
 
-/**
- * Structure DTO is element properties minus element data (in other words data required
- * to display the element in the left panel)
- */
-export const DTODocumentationPageV2 = DocumentationPageV2.omit({
-  data: true,
-  meta: true,
-  parentPersistentId: true,
-  sortOrder: true,
-}).extend({
+export const DTODocumentationPageV2 = z.object({
+  id: z.string(),
+  persistentId: z.string(),
+
+  designSystemVersionId: z.string(),
+
   title: z.string(),
-  path: z.string(),
-  type: z.literal("Page"),
   configuration: DTODocumentationItemConfigurationV2,
 
-  /** Defined when a page has changed since last publish and can be included into a partial publish */
-  draftState: DTODocumentationDraftState.optional(),
-});
+  shortPersistentId: z.string(),
+
+  slug: z.string().optional(),
+  userSlug: z.string().optional(),
+
+  createdAt: z.coerce.date(),
+  updatedAt: z.coerce.date(),
 
-export const DTODocumentationPageStructureV2 = DTODocumentationPageV2;
+  path: z.string(),
 
-export const DTODocumentationHierarchyV2 = z.object({
-  pages: z.array(DTODocumentationPageStructureV2),
-  groups: z.array(DTODocumentationGroupStructureV2),
+  /** Defined when a page has changed since last publish and can be included into a partial publish */
+  draftState: DTODocumentationDraftState.optional(),
 
-  deletedPages: z.array(DTODocumentationPageStructureV2),
-  deletedGroups: z.array(DTODocumentationGroupStructureV2),
+  // Backward compatibility
+  type: z.literal("Page"),
 });
 
 export type DTODocumentationPageV2 = z.infer<typeof DTODocumentationPageV2>;
-export type DTODocumentationPageStructureV2 = DTODocumentationPageV2;
-export type DTODocumentationHierarchyV2 = z.infer<typeof DTODocumentationHierarchyV2>;
 
 //
 // Write

package/src/yjs/version-room/backend.ts

@@ -1,16 +1,33 @@
-import { DesignElementSnapshot, DocumentationPageV2, ElementGroup } from "@supernova-studio/model";
+import {
+  DocumentationPageSnapshot,
+  DocumentationPageV2,
+  ElementGroup,
+  ElementGroupSnapshot,
+} from "@supernova-studio/model";
 import * as Y from "yjs";
 import { DocumentationHierarchySettings } from "../design-system-content";
 import { VersionRoomBaseYDoc } from "./base";
 
 type DocumentationHierarchyTransaction = {
-  pages: DocumentationPageV2[];
-  groups: ElementGroup[];
-  pageIdsToDelete: string[];
-  groupIdsToDelete: string[];
-  publishedPageSnapshots: DesignElementSnapshot[];
+  pages?: DocumentationPageV2[];
+  pageIdsToDelete?: string[];
 
-  internalSettings: DocumentationHierarchySettings | undefined;
+  groups?: ElementGroup[];
+  groupIdsToDelete?: string[];
+
+  publishedPageSnapshots?: DocumentationPageSnapshot[];
+  publishedPageSnapshotIdsToDelete?: string[];
+
+  publishedGroupSnapshots?: ElementGroupSnapshot[];
+  publishedGroupSnapshotIdsToDelete?: string[];
+
+  deletedPageSnapshots?: DocumentationPageSnapshot[];
+  deletedPageSnapshotIdsToDelete?: string[];
+
+  deletedGroupSnapshots?: ElementGroupSnapshot[];
+  deletedGroupSnapshotIdsToDelete?: string[];
+
+  internalSettings?: DocumentationHierarchySettings;
 };
 
 export class BackendVersionRoomYDoc {
@@ -25,15 +42,32 @@ export class BackendVersionRoomYDoc {
       const yDoc = new VersionRoomBaseYDoc(trx.doc);
 
       // Pages
-      transaction.pageIdsToDelete.length && yDoc.deleteDocumentationPages(transaction.pageIdsToDelete);
-      transaction.pages.length && yDoc.updateDocumentationPages(transaction.pages);
+      transaction.pageIdsToDelete && yDoc.deletePages(transaction.pageIdsToDelete);
+      transaction.pages && yDoc.updatePages(transaction.pages);
 
       // Groups
-      transaction.groupIdsToDelete.length && yDoc.deleteDocumentationGroups(transaction.groupIdsToDelete);
-      transaction.groups.length && yDoc.updateDocumentationGroups(transaction.groups);
+      transaction.groupIdsToDelete && yDoc.deleteGroups(transaction.groupIdsToDelete);
+      transaction.groups && yDoc.updateGroups(transaction.groups);
+
+      // Snapshots - published pages
+      transaction.publishedPageSnapshotIdsToDelete &&
+        yDoc.deletePagePublishedSnapshots(transaction.publishedPageSnapshotIdsToDelete);
+      transaction.publishedPageSnapshots && yDoc.updatePagePublishedSnapshots(transaction.publishedPageSnapshots);
+
+      // Snapshots - published groups
+      transaction.publishedGroupSnapshotIdsToDelete &&
+        yDoc.deleteGroupPublishedSnapshots(transaction.publishedGroupSnapshotIdsToDelete);
+      transaction.publishedGroupSnapshots && yDoc.updateGroupPublishedSnapshots(transaction.publishedGroupSnapshots);
+
+      // Snapshots - deleted pages
+      transaction.deletedPageSnapshotIdsToDelete &&
+        yDoc.deletePageDeletedSnapshots(transaction.deletedPageSnapshotIdsToDelete);
+      transaction.deletedPageSnapshots && yDoc.updatePageDeletedSnapshots(transaction.deletedPageSnapshots);
 
-      // Snapshots
-      // TODO Artem
+      // Snapshots - deleted groups
+      transaction.deletedGroupSnapshotIdsToDelete &&
+        yDoc.deleteGroupDeletedSnapshots(transaction.deletedGroupSnapshotIdsToDelete);
+      transaction.deletedGroupSnapshots && yDoc.updateGroupDeletedSnapshots(transaction.deletedGroupSnapshots);
 
       // Settings
       transaction.internalSettings && yDoc.updateDocumentationInternalSettings(transaction.internalSettings);

package/src/yjs/version-room/base.ts

@@ -1,19 +1,14 @@
-import { DesignElementSnapshot, DocumentationPageV2, ElementGroup } from "@supernova-studio/model";
+import {
+  DocumentationPageSnapshot,
+  DocumentationPageV2,
+  ElementGroup,
+  ElementGroupSnapshot,
+} from "@supernova-studio/model";
 import * as Y from "yjs";
+import { ZodSchema, ZodTypeDef } from "zod";
 import { DocumentationHierarchySettings } from "../design-system-content";
 
-//
-// Types
-//
-
-type DocumentationHierarchyTransaction = {
-  pages: DocumentationPageV2[];
-  groups: ElementGroup[];
-  pageIdsToDelete: string[];
-  groupIdsToDelete: string[];
-
-  internalSettings: DocumentationHierarchySettings | undefined;
-};
+type YJSSerializable = { id: string };
 
 export class VersionRoomBaseYDoc {
   private readonly yDoc: Y.Doc;
@@ -26,74 +21,50 @@ export class VersionRoomBaseYDoc {
   // Pages
   //
 
-  getDocumentationPages(): DocumentationPageV2[] {
-    const pagesMap = this.pagesYMap;
-
-    // Read pages
-    const pages: DocumentationPageV2[] = [];
-    pagesMap.forEach(page => {
-      pages.push(DocumentationPageV2.parse(page));
-    });
-
-    return pages;
+  getPages(): DocumentationPageV2[] {
+    return this.getObjects(this.pagesYMap, DocumentationPageV2);
   }
 
-  updateDocumentationPages(pages: DocumentationPageV2[]) {
-    const pagesMap = this.pagesYMap;
-
-    pages.forEach(page => {
+  updatePages(pages: DocumentationPageV2[]) {
+    pages = pages.map(page => {
       // We remove blocks from the payload here because it will not get parsed anyway
-      const sanitizedPage: DocumentationPageV2 = {
+      return {
         ...page,
         data: {
           configuration: page.data.configuration,
         },
       };
-
-      pagesMap.set(page.id, JSON.parse(JSON.stringify(sanitizedPage)));
     });
+
+    this.setObjects(this.pagesYMap, pages);
   }
 
-  deleteDocumentationPages(ids: string[]) {
-    const pagesMap = this.pagesYMap;
-    ids.forEach(id => pagesMap.delete(id));
+  deletePages(ids: string[]) {
+    this.deleteObjects(this.pagesYMap, ids);
   }
 
   private get pagesYMap() {
-    return this.yDoc.getMap<DocumentationPageV2>("documentationPages");
+    return this.yDoc.getMap<object>("documentationPages");
   }
 
   //
   // Groups
   //
 
-  getDocumentationGroups(): ElementGroup[] {
-    const groupsMap = this.groupsYMap;
-
-    // Read groups
-    const groups: ElementGroup[] = [];
-    groupsMap.forEach(group => {
-      groups.push(ElementGroup.parse(group));
-    });
-
-    return groups;
+  getGroups(): ElementGroup[] {
+    return this.getObjects(this.groupsYMap, ElementGroup);
   }
 
-  updateDocumentationGroups(groups: ElementGroup[]) {
-    const groupsMap = this.groupsYMap;
-
-    groups.forEach(group => {
-      groupsMap.set(group.id, JSON.parse(JSON.stringify(group)));
-    });
+  updateGroups(groups: ElementGroup[]) {
+    this.setObjects(this.groupsYMap, groups);
   }
 
-  deleteDocumentationGroups(ids: string[]) {
-    const groupsMap = this.groupsYMap;
-    ids.forEach(id => groupsMap.delete(id));
+  deleteGroups(ids: string[]) {
+    this.deleteObjects(this.groupsYMap, ids);
   }
 
   private get groupsYMap() {
-    return this.yDoc.getMap<ElementGroup>("documentationGroups");
+    return this.yDoc.getMap<object>("documentationGroups");
   }
 
   //
@@ -133,12 +104,16 @@ export class VersionRoomBaseYDoc {
   // Documentation page published snapshot
   //
 
-  getDocumentationPagePublishedSnapshots(): DesignElementSnapshot[] {
-    return this.getSnapshots(this.documentationPagePublishedStatesYMap);
+  getPagePublishedSnapshots(): DocumentationPageSnapshot[] {
+    return this.getObjects(this.documentationPagePublishedStatesYMap, DocumentationPageSnapshot);
+  }
+
+  updatePagePublishedSnapshots(snapshots: DocumentationPageSnapshot[]) {
+    this.setObjects(this.documentationPagePublishedStatesYMap, snapshots);
   }
 
-  updateDocumentationPagePublishedSnapshots(snapshots: DesignElementSnapshot[]) {
-    this.setSnapshots(this.documentationPagePublishedStatesYMap, snapshots);
+  deletePagePublishedSnapshots(ids: string[]) {
+    this.deleteObjects(this.documentationPagePublishedStatesYMap, ids);
   }
 
   private get documentationPagePublishedStatesYMap() {
@@ -149,12 +124,16 @@ export class VersionRoomBaseYDoc {
   // Documentation page deleted snapshot
   //
 
-  getDocumentationPageDeletedSnapshots(): DesignElementSnapshot[] {
-    return this.getSnapshots(this.documentationPageDeletedStatesYMap);
+  getPageDeletedSnapshots(): DocumentationPageSnapshot[] {
+    return this.getObjects(this.documentationPageDeletedStatesYMap, DocumentationPageSnapshot);
   }
 
-  updateDocumentationPageDeletedSnapshots(snapshots: DesignElementSnapshot[]) {
-    this.setSnapshots(this.documentationPageDeletedStatesYMap, snapshots);
+  updatePageDeletedSnapshots(snapshots: DocumentationPageSnapshot[]) {
+    this.setObjects(this.documentationPageDeletedStatesYMap, snapshots);
+  }
+
+  deletePageDeletedSnapshots(ids: string[]) {
+    this.deleteObjects(this.documentationPageDeletedStatesYMap, ids);
   }
 
   private get documentationPageDeletedStatesYMap() {
@@ -165,12 +144,16 @@ export class VersionRoomBaseYDoc {
   // Documentation group published snapshots
   //
 
-  getDocumentationGroupPublishedSnapshots(): DesignElementSnapshot[] {
-    return this.getSnapshots(this.documentationGroupPublishedStatesYMap);
+  getGroupPublishedSnapshots(): ElementGroupSnapshot[] {
+    return this.getObjects(this.documentationGroupPublishedStatesYMap, ElementGroupSnapshot);
+  }
+
+  updateGroupPublishedSnapshots(snapshots: ElementGroupSnapshot[]) {
+    this.setObjects(this.documentationGroupPublishedStatesYMap, snapshots);
   }
 
-  updateDocumentationGroupPublishedSnapshots(snapshots: DesignElementSnapshot[]) {
-    this.setSnapshots(this.documentationGroupPublishedStatesYMap, snapshots);
+  deleteGroupPublishedSnapshots(ids: string[]) {
+    this.deleteObjects(this.documentationGroupPublishedStatesYMap, ids);
   }
 
   private get documentationGroupPublishedStatesYMap() {
@@ -181,12 +164,16 @@ export class VersionRoomBaseYDoc {
   // Documentation group deleted snapshots
   //
 
-  getDocumentationGroupDeletedSnapshots(): DesignElementSnapshot[] {
-    return this.getSnapshots(this.documentationGroupDeletedStatesYMap);
+  getGroupDeletedSnapshots(): ElementGroupSnapshot[] {
+    return this.getObjects(this.documentationGroupDeletedStatesYMap, ElementGroupSnapshot);
+  }
+
+  updateGroupDeletedSnapshots(snapshots: ElementGroupSnapshot[]) {
+    this.setObjects(this.documentationGroupDeletedStatesYMap, snapshots);
   }
 
-  updateDocumentationGroupDeletedSnapshots(snapshots: DesignElementSnapshot[]) {
-    this.setSnapshots(this.documentationGroupDeletedStatesYMap, snapshots);
+  deleteGroupDeletedSnapshots(ids: string[]) {
+    this.deleteObjects(this.documentationGroupDeletedStatesYMap, ids);
   }
 
   private get documentationGroupDeletedStatesYMap() {
@@ -194,22 +181,21 @@ export class VersionRoomBaseYDoc {
   }
 
   //
-  // Snapshot utils
+  // Utils
   //
 
-  private getSnapshots(map: Y.Map<object>): DesignElementSnapshot[] {
-    const snapshots: DesignElementSnapshot[] = [];
-    map.forEach(snapshot => {
-      snapshots.push(DesignElementSnapshot.parse(snapshot));
-    });
+  private getObjects<T extends YJSSerializable, I>(map: Y.Map<object>, schema: ZodSchema<T, ZodTypeDef, I>): T[] {
+    const results: T[] = [];
+    map.forEach(object => results.push(schema.parse(object)));
+    return results;
+  }
 
-    return snapshots;
+  private setObjects<T extends YJSSerializable>(map: Y.Map<object>, objects: T[]) {
+    objects.forEach(o => map.set(o.id, JSON.parse(JSON.stringify(o))));
   }
 
-  private setSnapshots(map: Y.Map<object>, snapshots: DesignElementSnapshot[]) {
-    snapshots.forEach(snapshot => {
-      map.set(snapshot.id, JSON.parse(JSON.stringify(snapshot)));
-    });
+  private deleteObjects(map: Y.Map<object>, ids: string[]) {
+    ids.forEach(id => map.delete(id));
   }
 
   //