@supernova-studio/client 0.48.13 → 0.48.14

package/package.json

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

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

@@ -18,6 +18,8 @@ export const DTODocumentationDraftStateUpdated = z.object({
 
 export const DTODocumentationDraftStateDeleted = z.object({
   changeType: z.literal(DTODocumentationDraftChangeType.enum.Deleted),
+  deletedAt: z.coerce.date(),
+  deletedByUserId: z.string(),
 });
 
 export const DTODocumentationDraftState = z.discriminatedUnion("changeType", [

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

@@ -2,6 +2,7 @@ import { DocumentationGroupBehavior, ElementGroup } from "@supernova-studio/mode
 import { z } from "zod";
 import { DTODocumentationDraftState } from "./draft-state";
 import { DTODocumentationItemConfigurationV2 } from "./item-configuration-v2";
+import { DTODocumentationPublishMetadata } from "./metadata";
 
 //
 // Read
@@ -26,6 +27,9 @@ export const DTODocumentationGroupV2 = ElementGroup.omit({
 
   /** Defined when a group has changed since last publish and can be included into a partial publish */
   draftState: DTODocumentationDraftState.optional(),
+
+  /** Defined if a group was published at least once and contains metadata about last publish */
+  publishMetadata: DTODocumentationPublishMetadata.optional(),
 });
 
 export type DTODocumentationGroupV2 = z.infer<typeof DTODocumentationGroupV2>;

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

@@ -17,20 +17,6 @@ export const DTODocumentationHierarchyV2 = z.object({
       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

@@ -5,6 +5,7 @@ export * from "./group-v2";
 export * from "./hierarchy";
 export * from "./item-configuration-v1";
 export * from "./item-configuration-v2";
+export * from "./metadata";
 export * from "./page-actions-v2";
 export * from "./page-content";
 export * from "./page-v1";

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

@@ -0,0 +1,8 @@
+import { z } from "zod";
+
+export const DTODocumentationPublishMetadata = z.object({
+  lastPublishedByUserId: z.string(),
+  lastPublishedAt: z.coerce.date(),
+});
+
+export type DTODocumentationPublishMetadata = z.infer<typeof DTODocumentationPublishMetadata>;

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

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { DTODocumentationDraftState } from "./draft-state";
 import { DTODocumentationItemConfigurationV2 } from "./item-configuration-v2";
+import { DTODocumentationPublishMetadata } from "./metadata";
 
 //
 // Read
@@ -28,6 +29,9 @@ export const DTODocumentationPageV2 = z.object({
   /** Defined when a page has changed since last publish and can be included into a partial publish */
   draftState: DTODocumentationDraftState.optional(),
 
+  /** Defined if a page was published at least once and contains metadata about last publish */
+  publishMetadata: DTODocumentationPublishMetadata.optional(),
+
   // Backward compatibility
   type: z.literal("Page"),
 });

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

@@ -6,6 +6,8 @@ import {
   ElementGroupSnapshot,
   defaultDocumentationItemConfigurationV2,
   mapByUnique,
+  pickLatestGroupSnapshots,
+  pickLatestPageSnapshots,
 } from "@supernova-studio/model";
 import * as Y from "yjs";
 import {
@@ -16,6 +18,7 @@ import {
   documentationPagesToDTOV2,
   elementGroupsToDocumentationGroupDTOV2,
 } from "../../api";
+import { DTODocumentationPublishMetadata } from "../../api/dto/elements/documentation/metadata";
 import { generateHash } from "../../utils";
 import { DocumentationPageEditorModel } from "../docs-editor";
 import { VersionRoomBaseYDoc } from "./base";
@@ -38,7 +41,9 @@ export class FrontendVersionRoomYDoc {
   // Hierarchy
   //
 
-  getDocumentationHierarchy(): DTODocumentationHierarchyV2 {
+  getDocumentationHierarchy(options: { includeDeletedContent?: boolean } = {}): DTODocumentationHierarchyV2 {
+    const { includeDeletedContent } = options;
+
     const doc = new VersionRoomBaseYDoc(this.yDoc);
 
     // Read current room data
@@ -58,59 +63,68 @@ export class FrontendVersionRoomYDoc {
       return {
         pages: pageDTOs,
         groups: groupDTOs,
-        deletedGroups: [],
-        deletedPages: [],
       };
     }
 
     const pageDraftStates = this.buildPageDraftStates(pages, pageSnapshots);
+    const pagePublishedMetadata = this.buildPagePublishedMetadata(pages, pageSnapshots);
+
     pageDTOs.forEach(p => {
+      // Assign draft state
       const draftState = pageDraftStates.get(p.id);
       draftState && (p.draftState = draftState);
+
+      // Assign publish metadata
+      const publishMetadata = pagePublishedMetadata.get(p.id);
+      publishMetadata && (p.publishMetadata = publishMetadata);
     });
 
     const groupDraftStates = this.buildGroupDraftStates(groups, groupSnapshots);
+    const groupPublishedMetadata = this.buildGroupPublishedMetadata(groups, groupSnapshots);
+
     groupDTOs.forEach(g => {
+      // Assign draft state
       const draftState = groupDraftStates.get(g.id);
       draftState && (g.draftState = draftState);
-    });
 
-    // Read deleted pages
-    const pageIds = new Set(pages.map(p => p.id));
-    const deletedPagesMap = mapByUnique(
-      pageSnapshots.filter(s => !pageIds.has(s.page.id)).map(s => s.page),
-      p => p.id
-    );
-    const deletedPages = Array.from(deletedPagesMap.values());
-
-    // Read deleted groups
-    const groupIds = new Set(groups.map(p => p.id));
-    const deletedGroupsMap = mapByUnique(
-      groupSnapshots.filter(s => !groupIds.has(s.group.id)).map(s => s.group),
-      g => g.id
-    );
-    const deletedGroups = Array.from(deletedGroupsMap.values());
-
-    // Convert deleted pages to DTOs with draft states
-    const deletedPageDTOs = documentationPagesToDTOV2(
-      deletedPages,
-      [...groups, ...deletedGroups],
-      settings.routingVersion
-    ).map(p => {
-      return { ...p, draftState: { changeType: "Deleted" } } as const;
+      // Assign publish metadata
+      const publishMetadata = groupPublishedMetadata.get(g.id);
+      publishMetadata && (g.publishMetadata = publishMetadata);
     });
 
-    // Convert deleted groups to DTOs with draft states
-    const deletedGroupDTOs = elementGroupsToDocumentationGroupDTOV2(deletedGroups, deletedPages).map(g => {
-      return { ...g, draftState: { changeType: "Deleted" } } as const;
-    });
+    // // Read deleted pages
+    // const pageIds = new Set(pages.map(p => p.id));
+    // const deletedPagesMap = mapByUnique(
+    //   pageSnapshots.filter(s => !pageIds.has(s.page.id)).map(s => s.page),
+    //   p => p.id
+    // );
+    // const deletedPages = Array.from(deletedPagesMap.values());
+
+    // // Read deleted groups
+    // const groupIds = new Set(groups.map(p => p.id));
+    // const deletedGroupsMap = mapByUnique(
+    //   groupSnapshots.filter(s => !groupIds.has(s.group.id)).map(s => s.group),
+    //   g => g.id
+    // );
+    // const deletedGroups = Array.from(deletedGroupsMap.values());
+
+    // // Convert deleted pages to DTOs with draft states
+    // const deletedPageDTOs = documentationPagesToDTOV2(
+    //   deletedPages,
+    //   [...groups, ...deletedGroups],
+    //   settings.routingVersion
+    // ).map(p => {
+    //   return { ...p, draftState: { changeType: "Deleted" } } as const;
+    // });
+
+    // // Convert deleted groups to DTOs with draft states
+    // const deletedGroupDTOs = elementGroupsToDocumentationGroupDTOV2(deletedGroups, deletedPages).map(g => {
+    //   return { ...g, draftState: { changeType: "Deleted" } } as const;
+    // });
 
     return {
       pages: pageDTOs,
       groups: groupDTOs,
-
-      deletedPages: deletedPageDTOs,
-      deletedGroups: deletedGroupDTOs,
     };
   }
 
@@ -157,6 +171,54 @@ export class FrontendVersionRoomYDoc {
     return result;
   }
 
+  private buildPagePublishedMetadata(
+    pages: DocumentationPageV2[],
+    pageSnapshots: DocumentationPageSnapshot[]
+  ): Map<string, DTODocumentationPublishMetadata> {
+    const publishedPageSnapshotsById = mapByUnique(
+      pickLatestPageSnapshots(pageSnapshots.filter(s => s.reason === "Publish")),
+      s => s.page.id
+    );
+
+    const result = new Map<string, DTODocumentationPublishMetadata>();
+
+    pages.forEach(p => {
+      const publishedSnapshot = publishedPageSnapshotsById.get(p.id);
+      if (!publishedSnapshot) return;
+
+      result.set(p.id, {
+        lastPublishedAt: publishedSnapshot.createdAt,
+        lastPublishedByUserId: publishedSnapshot.createdByUserId,
+      });
+    });
+
+    return result;
+  }
+
+  private buildGroupPublishedMetadata(
+    groups: ElementGroup[],
+    groupSnapshots: ElementGroupSnapshot[]
+  ): Map<string, DTODocumentationPublishMetadata> {
+    const publishedGroupSnapshotsById = mapByUnique(
+      pickLatestGroupSnapshots(groupSnapshots.filter(s => s.reason === "Publish")),
+      s => s.group.id
+    );
+
+    const result = new Map<string, DTODocumentationPublishMetadata>();
+
+    groups.forEach(g => {
+      const publishedSnapshot = publishedGroupSnapshotsById.get(g.id);
+      if (!publishedSnapshot) return;
+
+      result.set(g.id, {
+        lastPublishedAt: publishedSnapshot.createdAt,
+        lastPublishedByUserId: publishedSnapshot.createdByUserId,
+      });
+    });
+
+    return result;
+  }
+
   private itemStateFromPage(page: DocumentationPageV2, pageContentHash: string): ItemState {
     return {
       title: page.meta.name,
@@ -295,4 +357,13 @@ export class FrontendVersionRoomYDoc {
     const settings = doc.getDocumentationInternalSettings();
     return settings.isDraftFeatureAdopted;
   }
+
+  hasPublishedDocumentationContent() {
+    const doc = new VersionRoomBaseYDoc(this.yDoc);
+
+    return (
+      doc.getPageSnapshots().filter(s => s.reason === "Publish").length > 0 ||
+      doc.getGroupSnapshots().filter(s => s.reason === "Publish").length > 0
+    );
+  }
 }