@supernova-studio/client 1.0.0-alpha.3 → 1.0.0-alpha.5

package/dist/index.d.mts

@@ -1822,6 +1822,7 @@ declare function yjsToItemConfiguration(yDoc: Y.Doc): DTODocumentationPageRoomHe
 type VersionRoomDocsPage = DocumentationPageV2;
 type VersionRoomDocsPageGroup = ElementGroup;
 type VersionRoomBaseYDocState = {
+    isLoaded: boolean;
     pages: VersionRoomDocsPage[];
     pageSnapshots: DocumentationPageSnapshot[];
     pageContentHashes: Record<string, string>;
@@ -92488,13 +92489,19 @@ declare class DocsStructureRepository {
     private readonly localState;
     private readonly yDoc;
     private readonly yObserver;
-    private yState;
+    private _yState;
+    private _currentHierarchy;
     private readonly trxQueue;
     private readonly hierarchyObservers;
+    private readonly initCallbacks;
     constructor(yDoc: Y.Doc, transactionExecutor: TransactionExecutor);
+    private get yState();
+    get isInitialized(): boolean;
+    onInitialized(): Promise<void>;
     addHierarchyObserver(observer: HierarchyObserver): void;
     removeHierarchyObserver(observer: HierarchyObserver): void;
     dispose(): void;
+    get currentHierarchy(): DTODocumentationHierarchyV2;
     createPage(input: DocPageCreate): void;
     createPagePromise(input: DocPageCreate): Promise<void>;
     updatePage(update: DocPageUpdate): void;
@@ -92504,7 +92511,8 @@ declare class DocsStructureRepository {
     deletePage(persistentId: string): void;
     private createLocalPageUpdate;
     private lookupPage;
-    private recalculateHierarchy;
+    private refreshHierarchy;
+    private calculateHierarchy;
     private onYUpdate;
     private calculateSortOrder;
 }

package/dist/index.d.ts

@@ -1822,6 +1822,7 @@ declare function yjsToItemConfiguration(yDoc: Y.Doc): DTODocumentationPageRoomHe
 type VersionRoomDocsPage = DocumentationPageV2;
 type VersionRoomDocsPageGroup = ElementGroup;
 type VersionRoomBaseYDocState = {
+    isLoaded: boolean;
     pages: VersionRoomDocsPage[];
     pageSnapshots: DocumentationPageSnapshot[];
     pageContentHashes: Record<string, string>;
@@ -92488,13 +92489,19 @@ declare class DocsStructureRepository {
     private readonly localState;
     private readonly yDoc;
     private readonly yObserver;
-    private yState;
+    private _yState;
+    private _currentHierarchy;
     private readonly trxQueue;
     private readonly hierarchyObservers;
+    private readonly initCallbacks;
     constructor(yDoc: Y.Doc, transactionExecutor: TransactionExecutor);
+    private get yState();
+    get isInitialized(): boolean;
+    onInitialized(): Promise<void>;
     addHierarchyObserver(observer: HierarchyObserver): void;
     removeHierarchyObserver(observer: HierarchyObserver): void;
     dispose(): void;
+    get currentHierarchy(): DTODocumentationHierarchyV2;
     createPage(input: DocPageCreate): void;
     createPagePromise(input: DocPageCreate): Promise<void>;
     updatePage(update: DocPageUpdate): void;
@@ -92504,7 +92511,8 @@ declare class DocsStructureRepository {
     deletePage(persistentId: string): void;
     private createLocalPageUpdate;
     private lookupPage;
-    private recalculateHierarchy;
+    private refreshHierarchy;
+    private calculateHierarchy;
     private onYUpdate;
     private calculateSortOrder;
 }

package/dist/index.js

@@ -8074,12 +8074,15 @@ var VersionRoomBaseYDoc = class {
     this.yDoc = yDoc;
   }
   getState() {
+    const groups = this.getGroups();
+    const isLoaded = !!groups.length;
     return {
+      isLoaded,
+      groups,
+      pages: this.getPages(),
       approvals: this.getApprovals(),
-      groups: this.getGroups(),
       groupSnapshots: this.getGroupSnapshots(),
       pageContentHashes: this.getDocumentationPageContentHashes(),
-      pages: this.getPages(),
       pageSnapshots: this.getPageSnapshots(),
       settings: this.getDocumentationInternalSettings()
     };
@@ -12941,19 +12944,42 @@ var DocsStructureRepository = class {
     __publicField(this, "localState", new LocalStorage());
     __publicField(this, "yDoc");
     __publicField(this, "yObserver");
-    __publicField(this, "yState");
+    __publicField(this, "_yState");
+    __publicField(this, "_currentHierarchy");
     __publicField(this, "trxQueue");
     __publicField(this, "hierarchyObservers", /* @__PURE__ */ new Set());
+    __publicField(this, "initCallbacks", /* @__PURE__ */ new Set());
     this.yDoc = yDoc;
-    this.yState = new VersionRoomBaseYDoc(this.yDoc).getState();
     this.yObserver = yDoc.on("update", () => this.onYUpdate());
+    this.onYUpdate();
     this.trxQueue = new TransactionQueue(transactionExecutor);
   }
   //
+  // Convenience
+  //
+  get yState() {
+    const yState = this._yState;
+    if (!yState)
+      throw SupernovaException.shouldNotHappen(`Accessing Y state before it was loaded`);
+    return yState;
+  }
+  //
   // Lifecycle
   //
+  get isInitialized() {
+    return !!this._currentHierarchy;
+  }
+  onInitialized() {
+    if (this.isInitialized)
+      return Promise.resolve();
+    return new Promise((resolve) => {
+      this.initCallbacks.add(resolve);
+    });
+  }
   addHierarchyObserver(observer) {
     this.hierarchyObservers.add(observer);
+    if (this._currentHierarchy)
+      observer(this._currentHierarchy);
   }
   removeHierarchyObserver(observer) {
     this.hierarchyObservers.delete(observer);
@@ -12964,6 +12990,15 @@ var DocsStructureRepository = class {
     this.trxQueue.clear();
   }
   //
+  // Accessors
+  //
+  get currentHierarchy() {
+    const hierarchy = this._currentHierarchy;
+    if (!hierarchy)
+      throw new Error(`Hierarchy cannot be accessed while it's still loading`);
+    return hierarchy;
+  }
+  //
   // Actions
   //
   createPage(input) {
@@ -12982,7 +13017,7 @@ var DocsStructureRepository = class {
       sortOrder: this.calculateSortOrder(input.parentPersistentId, input.afterPersistentId),
       designSystemVersionId: ""
     });
-    this.recalculateHierarchy();
+    this.refreshHierarchy();
     return this.trxQueue.enqueue({
       type: "DocumentationPageCreate",
       input: {
@@ -12999,7 +13034,7 @@ var DocsStructureRepository = class {
   }
   updatePagePromise(update) {
     this.updatePageLocally(update);
-    this.recalculateHierarchy();
+    this.refreshHierarchy();
     return this.trxQueue.enqueue({
       type: "DocumentationPageUpdate",
       input: {
@@ -13016,7 +13051,7 @@ var DocsStructureRepository = class {
   deletePagePromise(persistentId) {
     this.lookupPage(persistentId);
     this.localState.deletePage(persistentId);
-    this.recalculateHierarchy();
+    this.refreshHierarchy();
     return this.trxQueue.enqueue({
       type: "DocumentationPageDelete",
       input: {
@@ -13056,26 +13091,41 @@ var DocsStructureRepository = class {
   //
   // Reactions
   //
-  recalculateHierarchy() {
-    const allPagesById = mapByUnique(this.yState.pages, (p) => p.persistentId);
+  refreshHierarchy() {
+    const hierarchy = this.calculateHierarchy();
+    if (!hierarchy)
+      return;
+    this._currentHierarchy = hierarchy;
+    this.initCallbacks.forEach((f) => f());
+    this.initCallbacks.clear();
+    this.hierarchyObservers.forEach((o) => o(hierarchy));
+  }
+  calculateHierarchy() {
+    const yState = this._yState;
+    if (!yState)
+      return;
+    const allPagesById = mapByUnique(yState.pages, (p) => p.persistentId);
     this.localState.getAllPages().forEach((p) => {
       allPagesById.set(p.persistentId, p);
     });
     this.localState.getAllDeletedPages().forEach((id) => allPagesById.delete(id));
     const hierarchy = computeDocsHierarchy({
-      approvals: this.yState.approvals,
-      groups: this.yState.groups,
-      groupSnapshots: this.yState.groupSnapshots,
-      pageContentHashes: this.yState.pageContentHashes,
+      approvals: yState.approvals,
+      groups: yState.groups,
+      groupSnapshots: yState.groupSnapshots,
+      pageContentHashes: yState.pageContentHashes,
       pages: Array.from(allPagesById.values()),
-      pageSnapshots: this.yState.pageSnapshots,
-      settings: this.yState.settings
+      pageSnapshots: yState.pageSnapshots,
+      settings: yState.settings
     });
-    this.hierarchyObservers.forEach((o) => o(hierarchy));
+    return hierarchy;
   }
   onYUpdate() {
-    this.yState = new VersionRoomBaseYDoc(this.yDoc).getState();
-    this.recalculateHierarchy();
+    const newState = new VersionRoomBaseYDoc(this.yDoc).getState();
+    if (newState.groups.length) {
+      this._yState = newState;
+      this.refreshHierarchy();
+    }
   }
   //
   // Utils