@supernova-studio/client 1.16.0 → 1.16.1

package/dist/index.mjs

@@ -5265,7 +5265,8 @@ var ForgeProjectRoomUpdate = z183.object({
   artifacts: z183.array(ForgeProjectArtifact).optional(),
   artifactIdsToDelete: z183.array(z183.string()).optional(),
   features: z183.array(ProjectFeature).optional(),
-  featureIdsToDelete: z183.array(z183.string()).optional()
+  featureIdsToDelete: z183.array(z183.string()).optional(),
+  executedTransactionIds: z183.string().array().optional()
 });
 var RoomTypeEnum = /* @__PURE__ */ ((RoomTypeEnum2) => {
   RoomTypeEnum2["DocumentationPageOld"] = "documentation-page";
@@ -9085,22 +9086,17 @@ var DTOForgeSectionItemMoveInput = z310.object({
 });
 
 // src/api/dto/forge/project-artifact.ts
-var omitProps = {
-  projectId: true,
-  createdByUserId: true,
-  createdAt: true,
-  updatedAt: true,
-  sortOrder: true
-};
 var DTOForgeProjectArtifact = ForgeProjectArtifact;
-var DTOForgeProjectArtifactUpdateInput = DTOForgeProjectArtifact.omit({
-  ...omitProps,
-  iterationId: true
-}).partial().extend({
-  id: ForgeProjectArtifact.shape.id
-  // explicitly reintroduce required id
-});
-var DTOForgeProjectArtifactCreateInput = DTOForgeProjectArtifact.omit(omitProps);
+var DTOForgeProjectArtifactUpdateInput = z311.object({
+  id: z311.string(),
+  title: z311.string().optional()
+});
+var DTOForgeProjectArtifactCreateInput = z311.object({
+  id: z311.string(),
+  title: z311.string(),
+  sectionId: z311.string().optional(),
+  afterArtifactId: z311.string().optional().nullable()
+});
 var DTOForgeProjectArtifactDeleteInput = z311.object({
   id: Id
 });
@@ -9158,7 +9154,7 @@ var DTOForgeProjectActionFeatureCreate = z313.object({
 });
 var DTOForgeProjectActionFeatureUpdate = z313.object({
   type: z313.literal("FeatureUpdate"),
-  input: DTOForgeProjectFeatureCreateInput
+  input: DTOForgeProjectFeatureUpdateInput
 });
 var DTOForgeProjectActionFeatureMove = z313.object({
   type: z313.literal("FeatureMove"),
@@ -9216,7 +9212,11 @@ var DTOForgeProjectAction = z313.discriminatedUnion("type", [
   DTOForgeProjectActionSectionUpdate,
   DTOForgeProjectActionSectionDelete,
   DTOForgeProjectActionSectionMove
-]);
+]).and(
+  z313.object({
+    tId: z313.string().optional()
+  })
+);
 
 // src/api/dto/forge/project-artifact-room.ts
 import { z as z314 } from "zod";
@@ -11534,110 +11534,400 @@ var DTOEventDataSourcesImported = z342.object({
 import { z as z343 } from "zod";
 var DTOEvent = z343.discriminatedUnion("type", [DTOEventDataSourcesImported, DTOEventFigmaNodesRendered]);
 
-// src/sync/docs-structure-repo.ts
-import PQueue from "p-queue";
-
-// src/yjs/design-system-content/documentation-hierarchy.ts
-import { z as z344 } from "zod";
-
-// src/yjs/version-room/base.ts
-var VersionRoomBaseYDoc = class {
-  constructor(yDoc) {
-    __publicField(this, "yDoc");
-    this.yDoc = yDoc;
+// src/sync/docs-local-action-executor.ts
+function applyActionsLocally(input) {
+  const actionExecutor = new LocalDocsElementActionExecutor(input);
+  actionExecutor.applyActions(input.actions);
+  return actionExecutor.localState;
+}
+var LocalDocsElementActionExecutor = class {
+  constructor(config) {
+    __publicField(this, "userId");
+    __publicField(this, "designSystemVersionId");
+    __publicField(this, "pages");
+    __publicField(this, "groups");
+    __publicField(this, "approvalStates");
+    __publicField(this, "pageLiveblockRoomIds");
+    const { designSystemVersionId, remoteState, userId } = config;
+    this.userId = userId;
+    this.designSystemVersionId = designSystemVersionId;
+    this.pages = mapByUnique(remoteState.pages, (p) => p.persistentId);
+    this.groups = mapByUnique(remoteState.groups, (p) => p.persistentId);
+    this.approvalStates = mapByUnique(remoteState.approvals, (a) => a.pagePersistentId);
+    this.pageLiveblockRoomIds = { ...remoteState.pageLiveblockRoomIds };
   }
-  getState() {
-    const groups = this.getGroups();
-    const isLoaded = !!groups.length;
+  get localState() {
     return {
-      isLoaded,
-      groups,
-      pages: this.getPages(),
-      approvals: this.getApprovals(),
-      groupSnapshots: this.getGroupSnapshots(),
-      pageContentHashes: this.getDocumentationPageContentHashes(),
-      pageSnapshots: this.getPageSnapshots(),
-      settings: this.getDocumentationInternalSettings(),
-      pageLiveblockRoomIds: this.getDocumentationPageLiveblocksRoomIds(),
-      executedTransactionIds: this.getExecutedTransactionIds()
+      pages: Array.from(this.pages.values()),
+      groups: Array.from(this.groups.values()),
+      approvals: Array.from(this.approvalStates.values()),
+      pageLiveblockRoomIds: this.pageLiveblockRoomIds
     };
   }
-  //
-  // Pages
-  //
-  getPages() {
-    return this.getObjects(this.pagesYMap, DocumentationPageV2);
-  }
-  updatePages(pages) {
-    pages = pages.map((page) => {
-      return {
-        ...page,
-        data: {
-          configuration: page.data.configuration
-        }
-      };
-    });
-    this.setObjects(this.pagesYMap, pages);
-  }
-  deletePages(ids) {
-    this.deleteObjects(this.pagesYMap, ids);
+  applyActions(trx) {
+    trx.forEach((trx2) => this.applyTransaction(trx2));
   }
-  get pagesYMap() {
-    return this.yDoc.getMap("documentationPages");
+  applyTransaction(trx) {
+    switch (trx.type) {
+      // Groups
+      case "DocumentationGroupCreate":
+        return this.documentationGroupCreate(trx);
+      case "DocumentationGroupUpdate":
+        return this.documentationGroupUpdate(trx);
+      case "DocumentationGroupMove":
+        return this.documentationGroupMove(trx);
+      // Groups - unsupported
+      case "DocumentationGroupDelete":
+      case "DocumentationGroupDuplicate":
+      case "DocumentationGroupRestore":
+        throw new Error(`Transaction type ${trx.type} is not yet implemented`);
+      // Pages
+      case "DocumentationPageCreate":
+        return this.documentationPageCreate(trx);
+      case "DocumentationPageUpdate":
+        return this.documentationPageUpdate(trx);
+      case "DocumentationPageMove":
+        return this.documentationPageMove(trx);
+      case "DocumentationPageDelete":
+        return this.documentationPageDelete(trx);
+      // Pages - unsupported
+      case "DocumentationPageApprovalStateChange":
+        return this.documentationApprovalStateUpdate(trx);
+      case "DocumentationPageDuplicate":
+      case "DocumentationPageRestore":
+        throw new Error(`Transaction type ${trx.type} is not yet implemented`);
+      // Tabs
+      case "DocumentationTabCreate":
+        return this.documentationTabCreate(trx);
+      case "DocumentationTabGroupDelete":
+        throw new Error(`Transaction type ${trx.type} is not yet implemented`);
+      // Won't ever be supported
+      case "FigmaNodeRender":
+      case "FigmaNodeRenderAsync":
+        throw new Error(`Transaction type ${trx.type} is not a documentation element action`);
+    }
   }
   //
-  // Groups
+  // Pages
   //
-  getGroups() {
-    return this.getObjects(this.groupsYMap, ElementGroup);
+  documentationPageCreate(trx) {
+    const { input } = trx;
+    const { persistentId } = input;
+    if (this.pages.has(input.persistentId)) {
+      return;
+    }
+    if (!this.groups.has(input.parentPersistentId)) {
+      throw new Error(`Cannot create page: parent persistent id ${input.parentPersistentId} was not found`);
+    }
+    const localPage = {
+      persistentId,
+      createdAt: /* @__PURE__ */ new Date(),
+      parentPersistentId: input.parentPersistentId,
+      shortPersistentId: generateShortPersistentId(),
+      slug: slugify(input.title),
+      meta: { name: input.title },
+      updatedAt: /* @__PURE__ */ new Date(),
+      data: {
+        // TODO Artem: move somewhere reusable
+        configuration: input.configuration ? { ...defaultDocumentationItemConfigurationV2, ...input.configuration } : input.configuration
+      },
+      sortOrder: this.calculateSortOrder(input.parentPersistentId, input.afterPersistentId),
+      designSystemVersionId: this.designSystemVersionId
+    };
+    this.pages.set(persistentId, localPage);
+    const roomId = `${RoomType.DocumentationPage}:${this.designSystemVersionId}:${persistentId}`;
+    this.pageLiveblockRoomIds[persistentId] = roomId;
   }
-  updateGroups(groups) {
-    this.setObjects(this.groupsYMap, groups);
+  documentationPageUpdate(trx) {
+    const { input } = trx;
+    const existingPage = this.pages.get(input.id);
+    if (!existingPage) {
+      throw new Error(`Cannot update page: page id ${input.id} was not found`);
+    }
+    const localPage = {
+      ...existingPage,
+      userSlug: void 0,
+      meta: {
+        ...existingPage.meta,
+        name: input.title ?? existingPage.meta.name
+      },
+      data: {
+        // TODO Artem: move somewhere reusable
+        configuration: input.configuration ? { ...existingPage.data.configuration ?? defaultDocumentationItemConfigurationV2, ...input.configuration } : existingPage.data.configuration
+      }
+    };
+    this.pages.set(localPage.persistentId, localPage);
   }
-  deleteGroups(ids) {
-    this.deleteObjects(this.groupsYMap, ids);
+  documentationPageMove(trx) {
+    const { input } = trx;
+    if (!this.groups.has(input.parentPersistentId)) {
+      throw new Error(`Cannot move page: page parent id ${input.parentPersistentId} was not found`);
+    }
+    const existingPage = this.pages.get(input.id);
+    if (!existingPage) {
+      throw new Error(`Cannot update page: page id ${input.id} was not found`);
+    }
+    const localPage = {
+      ...existingPage,
+      userSlug: void 0,
+      sortOrder: this.calculateSortOrder(input.parentPersistentId, input.afterPersistentId),
+      parentPersistentId: input.parentPersistentId
+    };
+    this.pages.set(localPage.persistentId, localPage);
   }
-  get groupsYMap() {
-    return this.yDoc.getMap("documentationGroups");
+  documentationPageDelete(trx) {
+    const { input } = trx;
+    if (!this.pages.delete(trx.input.id)) {
+      throw new Error(`Cannot delete page: page id ${input.id} was not found`);
+    }
+    delete this.pageLiveblockRoomIds[trx.input.id];
   }
   //
-  // Documentation internal settings
+  // Group
   //
-  getDocumentationInternalSettings() {
-    const map = this.internalSettingsYMap;
-    const rawSettings = {
-      routingVersion: map.get("routingVersion"),
-      isDraftFeatureAdopted: map.get("isDraftFeatureAdopted") ?? false,
-      isApprovalFeatureEnabled: map.get("isApprovalFeatureEnabled") ?? false,
-      approvalRequiredForPublishing: map.get("approvalRequiredForPublishing") ?? false
-    };
-    const settingsParseResult = DocumentationHierarchySettings.safeParse(rawSettings);
-    if (!settingsParseResult.success) {
-      return {
-        routingVersion: "2",
-        isDraftFeatureAdopted: false,
-        isApprovalFeatureEnabled: false,
-        approvalRequiredForPublishing: false
-      };
+  documentationGroupCreate(trx) {
+    const { input } = trx;
+    if (this.groups.has(input.persistentId)) {
+      return;
     }
-    return settingsParseResult.data;
-  }
-  updateDocumentationInternalSettings(settings) {
-    const map = this.internalSettingsYMap;
-    map.set("routingVersion", settings.routingVersion ?? map.get("routingVersion"));
-    map.set("isDraftFeatureAdopted", settings.isDraftFeatureAdopted ?? map.get("isDraftFeatureAdopted"));
-    map.set("isApprovalFeatureEnabled", settings.isApprovalFeatureEnabled ?? map.get("isApprovalFeatureEnabled"));
-    map.set(
-      "approvalRequiredForPublishing",
-      settings.approvalRequiredForPublishing ?? map.get("approvalRequiredForPublishing")
-    );
-  }
-  get internalSettingsYMap() {
-    return this.yDoc.getMap("documentationInternalSettings");
+    const localGroup = {
+      parentPersistentId: input.parentPersistentId,
+      persistentId: input.persistentId,
+      shortPersistentId: generateShortPersistentId(),
+      slug: slugify(input.title),
+      meta: { name: input.title },
+      createdAt: /* @__PURE__ */ new Date(),
+      updatedAt: /* @__PURE__ */ new Date(),
+      data: {
+        // TODO Artem: move somewhere reusable
+        configuration: input.configuration ? { ...defaultDocumentationItemConfigurationV2, ...input.configuration } : input.configuration
+      },
+      sortOrder: this.calculateSortOrder(input.parentPersistentId, input.afterPersistentId),
+      designSystemVersionId: this.designSystemVersionId
+    };
+    this.groups.set(localGroup.persistentId, localGroup);
   }
-  //
-  // Documentation page snapshot
-  //
+  documentationGroupUpdate(trx) {
+    const { input } = trx;
+    const existingGroup = this.groups.get(input.id);
+    if (!existingGroup) {
+      throw new Error(`Cannot update group: group id ${input.id} was not found`);
+    }
+    const localGroup = {
+      ...existingGroup,
+      userSlug: void 0,
+      meta: {
+        ...existingGroup.meta,
+        name: input.title ?? existingGroup.meta.name
+      },
+      data: {
+        ...existingGroup.data,
+        // TODO Artem: move somewhere reusable
+        configuration: input.configuration ? {
+          ...existingGroup.data?.configuration ?? defaultDocumentationItemConfigurationV2,
+          ...input.configuration
+        } : existingGroup.data?.configuration
+      }
+    };
+    this.groups.set(localGroup.persistentId, localGroup);
+  }
+  documentationGroupMove(trx) {
+    const { input } = trx;
+    if (!this.groups.has(input.parentPersistentId)) {
+      throw new Error(`Cannot move group: group parent id ${input.parentPersistentId} was not found`);
+    }
+    const existingGroup = this.groups.get(input.id);
+    if (!existingGroup) {
+      throw new Error(`Cannot update group: group id ${input.id} was not found`);
+    }
+    const localGroup = {
+      ...existingGroup,
+      userSlug: void 0,
+      sortOrder: this.calculateSortOrder(input.parentPersistentId, input.afterPersistentId),
+      parentPersistentId: input.parentPersistentId
+    };
+    this.groups.set(localGroup.persistentId, localGroup);
+  }
+  //
+  // Tabs
+  //
+  documentationTabCreate(trx) {
+    const { input } = trx;
+    const page = this.pages.get(input.fromItemPersistentId);
+    if (!page) {
+      throw new Error(`Cannot create tab: page id ${input.fromItemPersistentId} was not found`);
+    }
+    const tabGroup = {
+      parentPersistentId: page.parentPersistentId,
+      persistentId: input.persistentId,
+      shortPersistentId: generateShortPersistentId(),
+      slug: page.slug,
+      meta: page.meta,
+      createdAt: /* @__PURE__ */ new Date(),
+      updatedAt: /* @__PURE__ */ new Date(),
+      data: {
+        behavior: "Tabs",
+        configuration: page?.data.configuration
+      },
+      sortOrder: page.sortOrder,
+      designSystemVersionId: this.designSystemVersionId
+    };
+    this.groups.set(input.persistentId, tabGroup);
+    const newLocalPage = {
+      ...page,
+      userSlug: void 0,
+      sortOrder: 0,
+      parentPersistentId: input.persistentId,
+      meta: { name: input.tabName }
+    };
+    this.pages.set(newLocalPage.persistentId, newLocalPage);
+  }
+  //
+  // Approval states
+  //
+  documentationApprovalStateUpdate(trx) {
+    const { input } = trx;
+    const existingApproval = this.approvalStates.get(input.persistentId);
+    if (input.approvalState) {
+      this.approvalStates.set(input.persistentId, {
+        approvalState: input.approvalState,
+        createdAt: existingApproval?.createdAt ?? /* @__PURE__ */ new Date(),
+        designSystemVersionId: this.designSystemVersionId,
+        pagePersistentId: input.persistentId,
+        updatedAt: /* @__PURE__ */ new Date(),
+        updatedByUserId: this.userId
+      });
+    } else {
+      this.approvalStates.delete(input.persistentId);
+    }
+  }
+  //
+  // Utils
+  //
+  calculateSortOrder(parentPersistentId, afterPersistentId) {
+    const sortOrderStep = Math.pow(2, 16);
+    const neighbours = [
+      ...Array.from(this.pages.values()).filter((p) => p.parentPersistentId === parentPersistentId),
+      ...Array.from(this.groups.values()).filter((g) => g.parentPersistentId === parentPersistentId)
+    ];
+    if (!neighbours.length) return 0;
+    neighbours.sort((lhs, rhs) => lhs.sortOrder - rhs.sortOrder);
+    if (afterPersistentId === null) return neighbours[0].sortOrder - sortOrderStep;
+    if (!afterPersistentId) return neighbours[neighbours.length - 1].sortOrder + sortOrderStep;
+    const index = neighbours.findIndex((e) => e.persistentId === afterPersistentId);
+    if (index < 0 || index === neighbours.length - 1) {
+      return neighbours[neighbours.length - 1].sortOrder + sortOrderStep;
+    }
+    const left = neighbours[index].sortOrder;
+    const right = neighbours[index + 1]?.sortOrder ?? left + sortOrderStep * 2;
+    return (right + left) / 2;
+  }
+};
+
+// src/sync/docs-structure-repo.ts
+import PQueue from "p-queue";
+
+// src/yjs/design-system-content/documentation-hierarchy.ts
+import { z as z344 } from "zod";
+
+// src/yjs/version-room/base.ts
+var VersionRoomBaseYDoc = class {
+  constructor(yDoc) {
+    __publicField(this, "yDoc");
+    this.yDoc = yDoc;
+  }
+  getState() {
+    const groups = this.getGroups();
+    const isLoaded = !!groups.length;
+    return {
+      isLoaded,
+      groups,
+      pages: this.getPages(),
+      approvals: this.getApprovals(),
+      groupSnapshots: this.getGroupSnapshots(),
+      pageContentHashes: this.getDocumentationPageContentHashes(),
+      pageSnapshots: this.getPageSnapshots(),
+      settings: this.getDocumentationInternalSettings(),
+      pageLiveblockRoomIds: this.getDocumentationPageLiveblocksRoomIds(),
+      executedTransactionIds: this.getExecutedTransactionIds()
+    };
+  }
+  //
+  // Pages
+  //
+  getPages() {
+    return this.getObjects(this.pagesYMap, DocumentationPageV2);
+  }
+  updatePages(pages) {
+    pages = pages.map((page) => {
+      return {
+        ...page,
+        data: {
+          configuration: page.data.configuration
+        }
+      };
+    });
+    this.setObjects(this.pagesYMap, pages);
+  }
+  deletePages(ids) {
+    this.deleteObjects(this.pagesYMap, ids);
+  }
+  get pagesYMap() {
+    return this.yDoc.getMap("documentationPages");
+  }
+  //
+  // Groups
+  //
+  getGroups() {
+    return this.getObjects(this.groupsYMap, ElementGroup);
+  }
+  updateGroups(groups) {
+    this.setObjects(this.groupsYMap, groups);
+  }
+  deleteGroups(ids) {
+    this.deleteObjects(this.groupsYMap, ids);
+  }
+  get groupsYMap() {
+    return this.yDoc.getMap("documentationGroups");
+  }
+  //
+  // Documentation internal settings
+  //
+  getDocumentationInternalSettings() {
+    const map = this.internalSettingsYMap;
+    const rawSettings = {
+      routingVersion: map.get("routingVersion"),
+      isDraftFeatureAdopted: map.get("isDraftFeatureAdopted") ?? false,
+      isApprovalFeatureEnabled: map.get("isApprovalFeatureEnabled") ?? false,
+      approvalRequiredForPublishing: map.get("approvalRequiredForPublishing") ?? false
+    };
+    const settingsParseResult = DocumentationHierarchySettings.safeParse(rawSettings);
+    if (!settingsParseResult.success) {
+      return {
+        routingVersion: "2",
+        isDraftFeatureAdopted: false,
+        isApprovalFeatureEnabled: false,
+        approvalRequiredForPublishing: false
+      };
+    }
+    return settingsParseResult.data;
+  }
+  updateDocumentationInternalSettings(settings) {
+    const map = this.internalSettingsYMap;
+    map.set("routingVersion", settings.routingVersion ?? map.get("routingVersion"));
+    map.set("isDraftFeatureAdopted", settings.isDraftFeatureAdopted ?? map.get("isDraftFeatureAdopted"));
+    map.set("isApprovalFeatureEnabled", settings.isApprovalFeatureEnabled ?? map.get("isApprovalFeatureEnabled"));
+    map.set(
+      "approvalRequiredForPublishing",
+      settings.approvalRequiredForPublishing ?? map.get("approvalRequiredForPublishing")
+    );
+  }
+  get internalSettingsYMap() {
+    return this.yDoc.getMap("documentationInternalSettings");
+  }
+  //
+  // Documentation page snapshot
+  //
   getPageSnapshots() {
     return this.getObjects(this.documentationPagePublishedStatesYMap, DocumentationPageSnapshot);
   }
@@ -16488,11 +16778,13 @@ var ForgeProjectRoomBaseYDoc = class {
   getState() {
     const artifacts = this.getArtifacts();
     const features = this.getFeatures();
+    const executedTransactionIds = this.getExecutedTransactionIds();
     const isLoaded = true;
     return {
       isLoaded,
       artifacts,
-      features
+      features,
+      executedTransactionIds
     };
   }
   //
@@ -16526,6 +16818,27 @@ var ForgeProjectRoomBaseYDoc = class {
     return this.yDoc.getMap("forgeProjectFeatures");
   }
   //
+  // Executed transactions
+  //
+  updateExecutedTransactionIds(transactionIds) {
+    transactionIds = Array.from(new Set(transactionIds));
+    if (!transactionIds.length) return;
+    const array = this.executedTransactionIdsArray;
+    array.push(transactionIds);
+    if (array.length > 100) {
+      array.delete(0, array.length - 100);
+    }
+  }
+  getExecutedTransactionIds() {
+    const array = this.executedTransactionIdsArray;
+    const transactionIds = [];
+    array.forEach((e) => typeof e === "string" && transactionIds.push(e));
+    return transactionIds;
+  }
+  get executedTransactionIdsArray() {
+    return this.yDoc.getArray("executedTransactionIds");
+  }
+  //
   // Utility methods
   //
   getObjects(map, schema) {
@@ -16554,6 +16867,7 @@ var BackendForgeProjectRoomYDoc = class {
       transaction.artifacts && yDoc.updateArtifacts(transaction.artifacts);
       transaction.featureIdsToDelete && yDoc.deleteFeatures(transaction.featureIdsToDelete);
       transaction.features && yDoc.updateFeatures(transaction.features);
+      transaction.executedTransactionIds && yDoc.updateExecutedTransactionIds(transaction.executedTransactionIds);
     });
   }
 };
@@ -16591,298 +16905,8 @@ var BackendVersionRoomYDoc = class {
   }
 };
 
-// src/sync/local-action-executor.ts
-function applyActionsLocally(input) {
-  const actionExecutor = new LocalDocsElementActionExecutor(input);
-  actionExecutor.applyActions(input.actions);
-  return actionExecutor.localState;
-}
-var LocalDocsElementActionExecutor = class {
-  constructor(config) {
-    __publicField(this, "userId");
-    __publicField(this, "designSystemVersionId");
-    __publicField(this, "pages");
-    __publicField(this, "groups");
-    __publicField(this, "approvalStates");
-    __publicField(this, "pageLiveblockRoomIds");
-    const { designSystemVersionId, remoteState, userId } = config;
-    this.userId = userId;
-    this.designSystemVersionId = designSystemVersionId;
-    this.pages = mapByUnique(remoteState.pages, (p) => p.persistentId);
-    this.groups = mapByUnique(remoteState.groups, (p) => p.persistentId);
-    this.approvalStates = mapByUnique(remoteState.approvals, (a) => a.pagePersistentId);
-    this.pageLiveblockRoomIds = { ...remoteState.pageLiveblockRoomIds };
-  }
-  get localState() {
-    return {
-      pages: Array.from(this.pages.values()),
-      groups: Array.from(this.groups.values()),
-      approvals: Array.from(this.approvalStates.values()),
-      pageLiveblockRoomIds: this.pageLiveblockRoomIds
-    };
-  }
-  applyActions(trx) {
-    trx.forEach((trx2) => this.applyTransaction(trx2));
-  }
-  applyTransaction(trx) {
-    switch (trx.type) {
-      // Groups
-      case "DocumentationGroupCreate":
-        return this.documentationGroupCreate(trx);
-      case "DocumentationGroupUpdate":
-        return this.documentationGroupUpdate(trx);
-      case "DocumentationGroupMove":
-        return this.documentationGroupMove(trx);
-      // Groups - unsupported
-      case "DocumentationGroupDelete":
-      case "DocumentationGroupDuplicate":
-      case "DocumentationGroupRestore":
-        throw new Error(`Transaction type ${trx.type} is not yet implemented`);
-      // Pages
-      case "DocumentationPageCreate":
-        return this.documentationPageCreate(trx);
-      case "DocumentationPageUpdate":
-        return this.documentationPageUpdate(trx);
-      case "DocumentationPageMove":
-        return this.documentationPageMove(trx);
-      case "DocumentationPageDelete":
-        return this.documentationPageDelete(trx);
-      // Pages - unsupported
-      case "DocumentationPageApprovalStateChange":
-        return this.documentationApprovalStateUpdate(trx);
-      case "DocumentationPageDuplicate":
-      case "DocumentationPageRestore":
-        throw new Error(`Transaction type ${trx.type} is not yet implemented`);
-      // Tabs
-      case "DocumentationTabCreate":
-        return this.documentationTabCreate(trx);
-      case "DocumentationTabGroupDelete":
-        throw new Error(`Transaction type ${trx.type} is not yet implemented`);
-      // Won't ever be supported
-      case "FigmaNodeRender":
-      case "FigmaNodeRenderAsync":
-        throw new Error(`Transaction type ${trx.type} is not a documentation element action`);
-    }
-  }
-  //
-  // Pages
-  //
-  documentationPageCreate(trx) {
-    const { input } = trx;
-    const { persistentId } = input;
-    if (this.pages.has(input.persistentId)) {
-      return;
-    }
-    if (!this.groups.has(input.parentPersistentId)) {
-      throw new Error(`Cannot create page: parent persistent id ${input.parentPersistentId} was not found`);
-    }
-    const localPage = {
-      persistentId,
-      createdAt: /* @__PURE__ */ new Date(),
-      parentPersistentId: input.parentPersistentId,
-      shortPersistentId: generateShortPersistentId(),
-      slug: slugify(input.title),
-      meta: { name: input.title },
-      updatedAt: /* @__PURE__ */ new Date(),
-      data: {
-        // TODO Artem: move somewhere reusable
-        configuration: input.configuration ? { ...defaultDocumentationItemConfigurationV2, ...input.configuration } : input.configuration
-      },
-      sortOrder: this.calculateSortOrder(input.parentPersistentId, input.afterPersistentId),
-      designSystemVersionId: this.designSystemVersionId
-    };
-    this.pages.set(persistentId, localPage);
-    const roomId = `${RoomType.DocumentationPage}:${this.designSystemVersionId}:${persistentId}`;
-    this.pageLiveblockRoomIds[persistentId] = roomId;
-  }
-  documentationPageUpdate(trx) {
-    const { input } = trx;
-    const existingPage = this.pages.get(input.id);
-    if (!existingPage) {
-      throw new Error(`Cannot update page: page id ${input.id} was not found`);
-    }
-    const localPage = {
-      ...existingPage,
-      userSlug: void 0,
-      meta: {
-        ...existingPage.meta,
-        name: input.title ?? existingPage.meta.name
-      },
-      data: {
-        // TODO Artem: move somewhere reusable
-        configuration: input.configuration ? { ...existingPage.data.configuration ?? defaultDocumentationItemConfigurationV2, ...input.configuration } : existingPage.data.configuration
-      }
-    };
-    this.pages.set(localPage.persistentId, localPage);
-  }
-  documentationPageMove(trx) {
-    const { input } = trx;
-    if (!this.groups.has(input.parentPersistentId)) {
-      throw new Error(`Cannot move page: page parent id ${input.parentPersistentId} was not found`);
-    }
-    const existingPage = this.pages.get(input.id);
-    if (!existingPage) {
-      throw new Error(`Cannot update page: page id ${input.id} was not found`);
-    }
-    const localPage = {
-      ...existingPage,
-      userSlug: void 0,
-      sortOrder: this.calculateSortOrder(input.parentPersistentId, input.afterPersistentId),
-      parentPersistentId: input.parentPersistentId
-    };
-    this.pages.set(localPage.persistentId, localPage);
-  }
-  documentationPageDelete(trx) {
-    const { input } = trx;
-    if (!this.pages.delete(trx.input.id)) {
-      throw new Error(`Cannot delete page: page id ${input.id} was not found`);
-    }
-    delete this.pageLiveblockRoomIds[trx.input.id];
-  }
-  //
-  // Group
-  //
-  documentationGroupCreate(trx) {
-    const { input } = trx;
-    if (this.groups.has(input.persistentId)) {
-      return;
-    }
-    const localGroup = {
-      parentPersistentId: input.parentPersistentId,
-      persistentId: input.persistentId,
-      shortPersistentId: generateShortPersistentId(),
-      slug: slugify(input.title),
-      meta: { name: input.title },
-      createdAt: /* @__PURE__ */ new Date(),
-      updatedAt: /* @__PURE__ */ new Date(),
-      data: {
-        // TODO Artem: move somewhere reusable
-        configuration: input.configuration ? { ...defaultDocumentationItemConfigurationV2, ...input.configuration } : input.configuration
-      },
-      sortOrder: this.calculateSortOrder(input.parentPersistentId, input.afterPersistentId),
-      designSystemVersionId: this.designSystemVersionId
-    };
-    this.groups.set(localGroup.persistentId, localGroup);
-  }
-  documentationGroupUpdate(trx) {
-    const { input } = trx;
-    const existingGroup = this.groups.get(input.id);
-    if (!existingGroup) {
-      throw new Error(`Cannot update group: group id ${input.id} was not found`);
-    }
-    const localGroup = {
-      ...existingGroup,
-      userSlug: void 0,
-      meta: {
-        ...existingGroup.meta,
-        name: input.title ?? existingGroup.meta.name
-      },
-      data: {
-        ...existingGroup.data,
-        // TODO Artem: move somewhere reusable
-        configuration: input.configuration ? {
-          ...existingGroup.data?.configuration ?? defaultDocumentationItemConfigurationV2,
-          ...input.configuration
-        } : existingGroup.data?.configuration
-      }
-    };
-    this.groups.set(localGroup.persistentId, localGroup);
-  }
-  documentationGroupMove(trx) {
-    const { input } = trx;
-    if (!this.groups.has(input.parentPersistentId)) {
-      throw new Error(`Cannot move group: group parent id ${input.parentPersistentId} was not found`);
-    }
-    const existingGroup = this.groups.get(input.id);
-    if (!existingGroup) {
-      throw new Error(`Cannot update group: group id ${input.id} was not found`);
-    }
-    const localGroup = {
-      ...existingGroup,
-      userSlug: void 0,
-      sortOrder: this.calculateSortOrder(input.parentPersistentId, input.afterPersistentId),
-      parentPersistentId: input.parentPersistentId
-    };
-    this.groups.set(localGroup.persistentId, localGroup);
-  }
-  //
-  // Tabs
-  //
-  documentationTabCreate(trx) {
-    const { input } = trx;
-    const page = this.pages.get(input.fromItemPersistentId);
-    if (!page) {
-      throw new Error(`Cannot create tab: page id ${input.fromItemPersistentId} was not found`);
-    }
-    const tabGroup = {
-      parentPersistentId: page.parentPersistentId,
-      persistentId: input.persistentId,
-      shortPersistentId: generateShortPersistentId(),
-      slug: page.slug,
-      meta: page.meta,
-      createdAt: /* @__PURE__ */ new Date(),
-      updatedAt: /* @__PURE__ */ new Date(),
-      data: {
-        behavior: "Tabs",
-        configuration: page?.data.configuration
-      },
-      sortOrder: page.sortOrder,
-      designSystemVersionId: this.designSystemVersionId
-    };
-    this.groups.set(input.persistentId, tabGroup);
-    const newLocalPage = {
-      ...page,
-      userSlug: void 0,
-      sortOrder: 0,
-      parentPersistentId: input.persistentId,
-      meta: { name: input.tabName }
-    };
-    this.pages.set(newLocalPage.persistentId, newLocalPage);
-  }
-  //
-  // Approval states
-  //
-  documentationApprovalStateUpdate(trx) {
-    const { input } = trx;
-    const existingApproval = this.approvalStates.get(input.persistentId);
-    if (input.approvalState) {
-      this.approvalStates.set(input.persistentId, {
-        approvalState: input.approvalState,
-        createdAt: existingApproval?.createdAt ?? /* @__PURE__ */ new Date(),
-        designSystemVersionId: this.designSystemVersionId,
-        pagePersistentId: input.persistentId,
-        updatedAt: /* @__PURE__ */ new Date(),
-        updatedByUserId: this.userId
-      });
-    } else {
-      this.approvalStates.delete(input.persistentId);
-    }
-  }
-  //
-  // Utils
-  //
-  calculateSortOrder(parentPersistentId, afterPersistentId) {
-    const sortOrderStep = Math.pow(2, 16);
-    const neighbours = [
-      ...Array.from(this.pages.values()).filter((p) => p.parentPersistentId === parentPersistentId),
-      ...Array.from(this.groups.values()).filter((g) => g.parentPersistentId === parentPersistentId)
-    ];
-    if (!neighbours.length) return 0;
-    neighbours.sort((lhs, rhs) => lhs.sortOrder - rhs.sortOrder);
-    if (afterPersistentId === null) return neighbours[0].sortOrder - sortOrderStep;
-    if (!afterPersistentId) return neighbours[neighbours.length - 1].sortOrder + sortOrderStep;
-    const index = neighbours.findIndex((e) => e.persistentId === afterPersistentId);
-    if (index < 0 || index === neighbours.length - 1) {
-      return neighbours[neighbours.length - 1].sortOrder + sortOrderStep;
-    }
-    const left = neighbours[index].sortOrder;
-    const right = neighbours[index + 1]?.sortOrder ?? left + sortOrderStep * 2;
-    return (right + left) / 2;
-  }
-};
-
-// src/sync/docs-structure-repo.ts
-var DocsStructureRepository = class {
+// src/sync/docs-structure-repo.ts
+var DocsStructureRepository = class {
   constructor(config) {
     __publicField(this, "userId");
     __publicField(this, "designSystemVersionId");
@@ -17065,6 +17089,276 @@ var TransactionQueue = class {
     this.queue.clear();
   }
 };
+
+// src/sync/project-content-repo.ts
+import PQueue2 from "p-queue";
+
+// src/sync/project-local-action-executor.ts
+function applyProjectActionsLocally(input) {
+  const actionExecutor = new LocalProjectActionExecutor(input);
+  actionExecutor.applyActions(input.actions);
+  return actionExecutor.localState;
+}
+var LocalProjectActionExecutor = class {
+  constructor(config) {
+    __publicField(this, "userId");
+    __publicField(this, "projectId");
+    __publicField(this, "artifacts");
+    __publicField(this, "features");
+    const { projectId, remoteState, userId } = config;
+    this.userId = userId;
+    this.projectId = projectId;
+    this.artifacts = mapByUnique(remoteState.artifacts, (p) => p.id);
+    this.features = mapByUnique(remoteState.features, (p) => p.id);
+  }
+  get localState() {
+    return {
+      artifacts: Array.from(this.artifacts.values()),
+      features: Array.from(this.features.values())
+    };
+  }
+  applyActions(trx) {
+    trx.forEach((trx2) => this.applyTransaction(trx2));
+  }
+  applyTransaction(trx) {
+    switch (trx.type) {
+      case "ArtifactCreate":
+        return this.artifactCreate(trx);
+      case "ArtifactUpdate":
+        return this.artifactUpdate(trx);
+      case "ArtifactDelete":
+        return this.artifactDelete(trx);
+      case "FeatureCreate":
+        return this.featureCreate(trx);
+      case "FeatureDelete":
+        return this.featureDelete(trx);
+      case "FeatureUpdate":
+        return this.featureUpdate(trx);
+    }
+  }
+  //
+  // Artifacts
+  //
+  artifactCreate(trx) {
+    const { input } = trx;
+    const { id } = input;
+    this.artifacts.set(id, {
+      id,
+      projectId: this.projectId,
+      sortOrder: 0,
+      title: input.title,
+      updatedAt: /* @__PURE__ */ new Date(),
+      createdAt: /* @__PURE__ */ new Date(),
+      createdByUserId: this.userId
+    });
+  }
+  artifactUpdate(trx) {
+    const { input } = trx;
+    const { id } = input;
+    const existingArtifact = this.artifacts.get(id);
+    if (!existingArtifact) {
+      throw new Error(`Cannot update artifact: artifact ${id} was not found in local storage`);
+    }
+    const mergedArtifact = {
+      ...existingArtifact,
+      title: input.title ?? existingArtifact.title,
+      updatedAt: /* @__PURE__ */ new Date()
+    };
+    this.artifacts.set(id, mergedArtifact);
+  }
+  artifactDelete(trx) {
+    const { input } = trx;
+    const { id } = input;
+    if (!this.artifacts.delete(id)) {
+      throw new Error(`Cannot delete artifact: artifact ${id} was not found in local storage`);
+    }
+  }
+  //
+  // Feature
+  //
+  featureCreate(trx) {
+    const { input } = trx;
+    const { id } = input;
+    this.features.set(id, {
+      id,
+      projectId: this.projectId,
+      description: input.description,
+      isArchived: false,
+      sectionId: input.sectionId,
+      sortOrder: 0,
+      name: input.name,
+      updatedAt: /* @__PURE__ */ new Date(),
+      createdAt: /* @__PURE__ */ new Date(),
+      createdByUserId: this.userId
+    });
+  }
+  featureUpdate(trx) {
+    const { input } = trx;
+    const { id } = input;
+    const existingFeature = this.features.get(id);
+    if (!existingFeature) {
+      throw new Error(`Cannot update feature: feature ${id} was not found in local storage`);
+    }
+    const mergedFeature = {
+      ...existingFeature,
+      name: input.name ?? existingFeature.name,
+      description: input.description ?? existingFeature.description,
+      isArchived: input.isArchived ?? existingFeature.isArchived,
+      updatedAt: /* @__PURE__ */ new Date()
+    };
+    this.features.set(id, mergedFeature);
+  }
+  featureDelete(trx) {
+    const { input } = trx;
+    const { id } = input;
+    if (!this.features.delete(id)) {
+      throw new Error(`Cannot delete feature: feature ${id} was not found in local storage`);
+    }
+  }
+};
+
+// src/sync/project-content-repo.ts
+var ForgeProjectContentRepository = class {
+  constructor(config) {
+    __publicField(this, "userId");
+    __publicField(this, "projectId");
+    __publicField(this, "yDoc");
+    __publicField(this, "yObserver");
+    __publicField(this, "_yState");
+    __publicField(this, "_currentProjectContent");
+    __publicField(this, "localActions", []);
+    __publicField(this, "actionQueue");
+    __publicField(this, "projectContentObservers", /* @__PURE__ */ new Set());
+    __publicField(this, "errorObservers", /* @__PURE__ */ new Set());
+    __publicField(this, "initCallbacks", /* @__PURE__ */ new Set());
+    __publicField(this, "transactionIdGenerator");
+    __publicField(this, "transactionExecutor");
+    this.userId = config.userId;
+    this.projectId = config.projectId;
+    this.yDoc = config.yDoc;
+    this.yObserver = this.yDoc.on("update", () => this.onYUpdate());
+    this.onYUpdate();
+    this.transactionExecutor = config.transactionExecutor;
+    this.transactionIdGenerator = config.transactionIdGenerator;
+    this.actionQueue = new TransactionQueue2((action) => this.executeInternalAction(action));
+  }
+  //
+  // Lifecycle
+  //
+  get isInitialized() {
+    return !!this._currentProjectContent;
+  }
+  onInitialized() {
+    if (this.isInitialized) return Promise.resolve();
+    return new Promise((resolve) => {
+      this.initCallbacks.add(resolve);
+    });
+  }
+  addProjectContentObserver(observer) {
+    this.projectContentObservers.add(observer);
+    if (this._currentProjectContent) observer(this._currentProjectContent);
+  }
+  removeProjectContentObserver(observer) {
+    this.projectContentObservers.delete(observer);
+  }
+  addErrorObserver(observer) {
+    this.errorObservers.add(observer);
+  }
+  removeErrorObserver(observer) {
+    this.errorObservers.delete(observer);
+  }
+  dispose() {
+    this.yDoc.off("update", this.yObserver);
+    this.projectContentObservers.clear();
+    this.errorObservers.clear();
+    this.actionQueue.clear();
+  }
+  //
+  // Accessors
+  //
+  get currentProjectContent() {
+    const projectContent = this._currentProjectContent;
+    if (!projectContent) throw new Error(`Project content cannot be accessed while it's still loading`);
+    return projectContent;
+  }
+  //
+  // Actions
+  //
+  executeAction(action, metadata) {
+    void this.executeActionPromise(action, metadata);
+  }
+  executeActionPromise(action, metadata) {
+    const fullAction = { ...action, tId: this.transactionIdGenerator() };
+    this.localActions.push(fullAction);
+    this.refreshProjectContent();
+    return this.actionQueue.enqueue({ action: fullAction, metadata });
+  }
+  async executeInternalAction(action) {
+    try {
+      return await this.transactionExecutor(action.action);
+    } catch (e) {
+      this.localActions = this.localActions.filter((a) => a.tId !== action.action.tId);
+      this.refreshProjectContent();
+      this.errorObservers.forEach((o) => o(e, action.metadata));
+    }
+  }
+  //
+  // Reactions
+  //
+  refreshState() {
+    this.refreshProjectContent();
+  }
+  refreshProjectContent() {
+    const yState = this._yState;
+    if (!yState) return;
+    const projectContent = this.calculateProjectState(yState);
+    if (!projectContent) return;
+    this._currentProjectContent = projectContent;
+    this.projectContentObservers.forEach((o) => o(projectContent));
+  }
+  calculateProjectState(yState) {
+    const executedTransactionIds = new Set(yState.executedTransactionIds);
+    const localActions = this.localActions.filter((a) => a.tId && !executedTransactionIds.has(a.tId));
+    this.localActions = localActions;
+    const state = applyProjectActionsLocally({
+      userId: this.userId,
+      projectId: this.projectId,
+      remoteState: yState,
+      actions: localActions
+    });
+    return {
+      artifacts: state.artifacts,
+      features: state.features
+    };
+  }
+  onYUpdate() {
+    const newState = new ForgeProjectRoomBaseYDoc(this.yDoc).getState();
+    if (newState.isLoaded) {
+      this._yState = newState;
+      this.refreshState();
+      this.initCallbacks.forEach((f) => f());
+      this.initCallbacks.clear();
+    }
+  }
+};
+var TransactionQueue2 = class {
+  constructor(executor) {
+    __publicField(this, "executor");
+    __publicField(this, "queue", new PQueue2({
+      concurrency: 1
+    }));
+    this.executor = executor;
+  }
+  enqueue(trx) {
+    return this.queue.add(() => this.executor(trx));
+  }
+  onEmpty() {
+    return this.queue.onEmpty();
+  }
+  clear() {
+    this.queue.clear();
+  }
+};
 export {
   BackendForgeProjectRoomYDoc,
   BackendVersionRoomYDoc,
@@ -17660,6 +17954,7 @@ export {
   ForgeFeaturesEndpoint,
   ForgeIterationMessagesEndpoint,
   ForgeParticipantsEndpoint,
+  ForgeProjectContentRepository,
   ForgeProjectContextsEndpoint,
   ForgeProjectFeaturesEndpoint,
   ForgeProjectInvitationsEndpoint,