@supernova-studio/client 0.15.0 → 0.17.0

package/dist/index.mjs

@@ -126,6 +126,7 @@ import { z as z122 } from "zod";
 import { z as z123 } from "zod";
 import { z as z124 } from "zod";
 import { z as z125 } from "zod";
+import slugifyImplementation from "@sindresorhus/slugify";
 var PluginOAuthRequestSchema = z.object({
   id: z.string(),
   codeChallenge: z.string(),
@@ -2605,6 +2606,16 @@ var DesignSystemVersionRoom = Entity.extend({
   designSystemVersionId: z119.string(),
   liveblocksId: z119.string()
 });
+var DesignSystemVersionRoomInitialState = z119.object({
+  pages: z119.array(DocumentationPageV2),
+  groups: z119.array(ElementGroup),
+  deletedPagePersistentIds: z119.array(z119.string()),
+  deletedGroupPersistentIds: z119.array(z119.string())
+});
+var DesignSystemVersionRoomUpdate = DesignSystemVersionRoomInitialState.extend({
+  deletedPagePersistentIds: z119.array(z119.string()),
+  deletedGroupPersistentIds: z119.array(z119.string())
+});
 var DocumentationPageRoom = Entity.extend({
   designSystemVersionId: z120.string(),
   documentationPageId: z120.string(),
@@ -2653,6 +2664,86 @@ var PersonalAccessToken = z124.object({
   expireAt: z124.date().optional(),
   scope: z124.string().optional()
 });
+var SupernovaException = class _SupernovaException extends Error {
+  //
+  // Properties
+  //
+  constructor(type, message) {
+    super(`${type}: ${message}`);
+    this.type = type;
+  }
+  static wrongFormat(message) {
+    return new _SupernovaException("WrongFormat", message);
+  }
+  static accessDenied(message) {
+    return new _SupernovaException("AccessDenied", message);
+  }
+  static notFound(message) {
+    return new _SupernovaException("ResourceNotFound", message);
+  }
+  static timeout(message) {
+    return new _SupernovaException("Timeout", message);
+  }
+  static conflict(message) {
+    return new _SupernovaException("Conflict", message);
+  }
+  static notImplemented(message) {
+    return new _SupernovaException("NotImplemented", message);
+  }
+  static wrongActionOrder(message) {
+    return new _SupernovaException("WrongActionOrder", message);
+  }
+  static invalidOperation(message) {
+    return new _SupernovaException("InvalidOperation", message);
+  }
+  static shouldNotHappen(message) {
+    return new _SupernovaException("UnexpectedError", message);
+  }
+  static ipRestricted(message) {
+    return new _SupernovaException("IPRestricted", message);
+  }
+  static planRestricted(message) {
+    return new _SupernovaException("PlanRestricted", message);
+  }
+  static missingWorkspacePermission(message) {
+    return new _SupernovaException("MissingWorkspacePermission", message);
+  }
+  static missingExporterPermission(message) {
+    return new _SupernovaException("MissingExporterPermission", message);
+  }
+  static missingIntegration(message) {
+    return new _SupernovaException("AccessDenied", message);
+  }
+  static noAccess(message) {
+    return new _SupernovaException("NoAccess", message);
+  }
+  //
+  // To refactor
+  //
+  static badRequest(message) {
+    return new _SupernovaException("BadRequest", message);
+  }
+};
+function mapByUnique(items, keyFn) {
+  const result = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    result.set(keyFn(item), item);
+  }
+  return result;
+}
+function groupBy(items, keyFn) {
+  const result = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    const key = keyFn(item);
+    const array = result.get(key);
+    if (array) {
+      array.push(item);
+    } else {
+      result.set(key, [item]);
+    }
+  }
+  return result;
+}
 var ContentLoadInstruction = z125.object({
   from: z125.string(),
   to: z125.string(),
@@ -2674,33 +2765,803 @@ var ContentLoaderPayload = z125.object({
     location: z125.string()
   })
 );
+function slugify(str, options) {
+  const slug = slugifyImplementation(str ?? "", options);
+  return slug?.length > 0 ? slug : "item";
+}
+var RESERVED_SLUGS = [
+  "workspaces",
+  "workspace",
+  "api0",
+  "api1",
+  "api2",
+  "custom",
+  "x-sn-reserved",
+  // further elements copied from https://github.com/shouldbee/reserved-usernames/blob/master/reserved-usernames.json
+  "0",
+  "about",
+  "access",
+  "account",
+  "accounts",
+  "activate",
+  "activities",
+  "activity",
+  "ad",
+  "add",
+  "address",
+  "adm",
+  "admin",
+  "administration",
+  "administrator",
+  "ads",
+  "adult",
+  "advertising",
+  "affiliate",
+  "affiliates",
+  "ajax",
+  "all",
+  "alpha",
+  "analysis",
+  "analytics",
+  "android",
+  "anon",
+  "anonymous",
+  "api",
+  "app",
+  "apps",
+  "archive",
+  "archives",
+  "article",
+  "asct",
+  "asset",
+  "assets",
+  "atom",
+  "auth",
+  "authentication",
+  "avatar",
+  "backup",
+  "balancer-manager",
+  "banner",
+  "banners",
+  "beta",
+  "billing",
+  "bin",
+  "blog",
+  "blogs",
+  "board",
+  "book",
+  "bookmark",
+  "bot",
+  "bots",
+  "bug",
+  "business",
+  "cache",
+  "cadastro",
+  "calendar",
+  "call",
+  "campaign",
+  "cancel",
+  "captcha",
+  "career",
+  "careers",
+  "cart",
+  "categories",
+  "category",
+  "cgi",
+  "cgi-bin",
+  "changelog",
+  "chat",
+  "check",
+  "checking",
+  "checkout",
+  "client",
+  "cliente",
+  "clients",
+  "code",
+  "codereview",
+  "comercial",
+  "comment",
+  "comments",
+  "communities",
+  "community",
+  "company",
+  "compare",
+  "compras",
+  "config",
+  "configuration",
+  "connect",
+  "contact",
+  "contact-us",
+  "contact_us",
+  "contactus",
+  "contest",
+  "contribute",
+  "corp",
+  "create",
+  "css",
+  "dashboard",
+  "data",
+  "db",
+  "default",
+  "delete",
+  "demo",
+  "design",
+  "designer",
+  "destroy",
+  "dev",
+  "devel",
+  "developer",
+  "developers",
+  "diagram",
+  "diary",
+  "dict",
+  "dictionary",
+  "die",
+  "dir",
+  "direct_messages",
+  "directory",
+  "dist",
+  "doc",
+  "docs",
+  "documentation",
+  "domain",
+  "download",
+  "downloads",
+  "ecommerce",
+  "edit",
+  "editor",
+  "edu",
+  "education",
+  "email",
+  "employment",
+  "empty",
+  "end",
+  "enterprise",
+  "entries",
+  "entry",
+  "error",
+  "errors",
+  "eval",
+  "event",
+  "exit",
+  "explore",
+  "facebook",
+  "faq",
+  "favorite",
+  "favorites",
+  "feature",
+  "features",
+  "feed",
+  "feedback",
+  "feeds",
+  "file",
+  "files",
+  "first",
+  "flash",
+  "fleet",
+  "fleets",
+  "flog",
+  "follow",
+  "followers",
+  "following",
+  "forgot",
+  "form",
+  "forum",
+  "forums",
+  "founder",
+  "free",
+  "friend",
+  "friends",
+  "ftp",
+  "gadget",
+  "gadgets",
+  "game",
+  "games",
+  "get",
+  "ghost",
+  "gift",
+  "gifts",
+  "gist",
+  "github",
+  "graph",
+  "group",
+  "groups",
+  "guest",
+  "guests",
+  "help",
+  "home",
+  "homepage",
+  "host",
+  "hosting",
+  "hostmaster",
+  "hostname",
+  "howto",
+  "hpg",
+  "html",
+  "http",
+  "httpd",
+  "https",
+  "i",
+  "iamges",
+  "icon",
+  "icons",
+  "id",
+  "idea",
+  "ideas",
+  "image",
+  "images",
+  "imap",
+  "img",
+  "index",
+  "indice",
+  "info",
+  "information",
+  "inquiry",
+  "instagram",
+  "intranet",
+  "invitations",
+  "invite",
+  "ipad",
+  "iphone",
+  "irc",
+  "is",
+  "issue",
+  "issues",
+  "it",
+  "item",
+  "items",
+  "java",
+  "javascript",
+  "job",
+  "jobs",
+  "join",
+  "js",
+  "json",
+  "jump",
+  "knowledgebase",
+  "language",
+  "languages",
+  "last",
+  "ldap-status",
+  "legal",
+  "license",
+  "link",
+  "links",
+  "linux",
+  "list",
+  "lists",
+  "log",
+  "log-in",
+  "log-out",
+  "log_in",
+  "log_out",
+  "login",
+  "logout",
+  "logs",
+  "m",
+  "mac",
+  "mail",
+  "mail1",
+  "mail2",
+  "mail3",
+  "mail4",
+  "mail5",
+  "mailer",
+  "mailing",
+  "maintenance",
+  "manager",
+  "manual",
+  "map",
+  "maps",
+  "marketing",
+  "master",
+  "me",
+  "media",
+  "member",
+  "members",
+  "message",
+  "messages",
+  "messenger",
+  "microblog",
+  "microblogs",
+  "mine",
+  "mis",
+  "mob",
+  "mobile",
+  "movie",
+  "movies",
+  "mp3",
+  "msg",
+  "msn",
+  "music",
+  "musicas",
+  "mx",
+  "my",
+  "mysql",
+  "name",
+  "named",
+  "nan",
+  "navi",
+  "navigation",
+  "net",
+  "network",
+  "new",
+  "news",
+  "newsletter",
+  "nick",
+  "nickname",
+  "notes",
+  "noticias",
+  "notification",
+  "notifications",
+  "notify",
+  "ns",
+  "ns1",
+  "ns10",
+  "ns2",
+  "ns3",
+  "ns4",
+  "ns5",
+  "ns6",
+  "ns7",
+  "ns8",
+  "ns9",
+  "null",
+  "oauth",
+  "oauth_clients",
+  "offer",
+  "offers",
+  "official",
+  "old",
+  "online",
+  "openid",
+  "operator",
+  "order",
+  "orders",
+  "organization",
+  "organizations",
+  "overview",
+  "owner",
+  "owners",
+  "page",
+  "pager",
+  "pages",
+  "panel",
+  "password",
+  "payment",
+  "perl",
+  "phone",
+  "photo",
+  "photoalbum",
+  "photos",
+  "php",
+  "phpmyadmin",
+  "phppgadmin",
+  "phpredisadmin",
+  "pic",
+  "pics",
+  "ping",
+  "plan",
+  "plans",
+  "plugin",
+  "plugins",
+  "policy",
+  "pop",
+  "pop3",
+  "popular",
+  "portal",
+  "post",
+  "postfix",
+  "postmaster",
+  "posts",
+  "pr",
+  "premium",
+  "press",
+  "price",
+  "pricing",
+  "privacy",
+  "privacy-policy",
+  "privacy_policy",
+  "privacypolicy",
+  "private",
+  "product",
+  "products",
+  "profile",
+  "project",
+  "projects",
+  "promo",
+  "pub",
+  "public",
+  "purpose",
+  "put",
+  "python",
+  "query",
+  "random",
+  "ranking",
+  "read",
+  "readme",
+  "recent",
+  "recruit",
+  "recruitment",
+  "register",
+  "registration",
+  "release",
+  "remove",
+  "replies",
+  "report",
+  "reports",
+  "repositories",
+  "repository",
+  "req",
+  "request",
+  "requests",
+  "reset",
+  "roc",
+  "root",
+  "rss",
+  "ruby",
+  "rule",
+  "sag",
+  "sale",
+  "sales",
+  "sample",
+  "samples",
+  "save",
+  "school",
+  "script",
+  "scripts",
+  "search",
+  "secure",
+  "security",
+  "self",
+  "send",
+  "server",
+  "server-info",
+  "server-status",
+  "service",
+  "services",
+  "session",
+  "sessions",
+  "setting",
+  "settings",
+  "setup",
+  "share",
+  "shop",
+  "show",
+  "sign-in",
+  "sign-up",
+  "sign_in",
+  "sign_up",
+  "signin",
+  "signout",
+  "signup",
+  "site",
+  "sitemap",
+  "sites",
+  "smartphone",
+  "smtp",
+  "soporte",
+  "source",
+  "spec",
+  "special",
+  "sql",
+  "src",
+  "ssh",
+  "ssl",
+  "ssladmin",
+  "ssladministrator",
+  "sslwebmaster",
+  "staff",
+  "stage",
+  "staging",
+  "start",
+  "stat",
+  "state",
+  "static",
+  "stats",
+  "status",
+  "store",
+  "stores",
+  "stories",
+  "style",
+  "styleguide",
+  "stylesheet",
+  "stylesheets",
+  "subdomain",
+  "subscribe",
+  "subscriptions",
+  "suporte",
+  "support",
+  "svn",
+  "swf",
+  "sys",
+  "sysadmin",
+  "sysadministrator",
+  "system",
+  "tablet",
+  "tablets",
+  "tag",
+  "talk",
+  "task",
+  "tasks",
+  "team",
+  "teams",
+  "tech",
+  "telnet",
+  "term",
+  "terms",
+  "terms-of-service",
+  "terms_of_service",
+  "termsofservice",
+  "test",
+  "test1",
+  "test2",
+  "test3",
+  "teste",
+  "testing",
+  "tests",
+  "theme",
+  "themes",
+  "thread",
+  "threads",
+  "tmp",
+  "todo",
+  "tool",
+  "tools",
+  "top",
+  "topic",
+  "topics",
+  "tos",
+  "tour",
+  "translations",
+  "trends",
+  "tutorial",
+  "tux",
+  "tv",
+  "twitter",
+  "undef",
+  "unfollow",
+  "unsubscribe",
+  "update",
+  "upload",
+  "uploads",
+  "url",
+  "usage",
+  "user",
+  "username",
+  "users",
+  "usuario",
+  "vendas",
+  "ver",
+  "version",
+  "video",
+  "videos",
+  "visitor",
+  "watch",
+  "weather",
+  "web",
+  "webhook",
+  "webhooks",
+  "webmail",
+  "webmaster",
+  "website",
+  "websites",
+  "welcome",
+  "widget",
+  "widgets",
+  "wiki",
+  "win",
+  "windows",
+  "word",
+  "work",
+  "works",
+  "workshop",
+  "ww",
+  "wws",
+  "www",
+  "www1",
+  "www2",
+  "www3",
+  "www4",
+  "www5",
+  "www6",
+  "www7",
+  "wwws",
+  "wwww",
+  "xfn",
+  "xml",
+  "xmpp",
+  "xpg",
+  "xxx",
+  "yaml",
+  "year",
+  "yml",
+  "you",
+  "yourdomain",
+  "yourname",
+  "yoursite",
+  "yourusername",
+  "latest",
+  "live",
+  "preview",
+  "learn",
+  "supernova",
+  "super-nova"
+];
+var RESERVED_SLUGS_SET = new Set(RESERVED_SLUGS);
+
+// src/api/conversion/documentation/documentation-page-to-dto-utils.ts
+function buildDocPagePublishPaths(groups, pages) {
+  const groupPersistentIdToGroupMap = mapByUnique(groups, (group) => group.persistentId);
+  const result = /* @__PURE__ */ new Map();
+  for (const page of pages) {
+    const parentChain = calculateElementParentChain(page.parentPersistentId, groupPersistentIdToGroupMap);
+    let pathV1 = `${page.userSlug || page.slug}.html`;
+    let pathV2 = `${slugify(page.meta.name)}-${page.shortPersistentId}`;
+    for (const parent of parentChain) {
+      if (!parent.parentPersistentId)
+        continue;
+      pathV1 = `${parent.userSlug || parent.slug}/${pathV1}`;
+      pathV2 = `${slugify(parent.meta.name)}/${pathV2}`;
+    }
+    pathV1 = `/${pathV1}`;
+    pathV2 = `/${pathV2}`;
+    result.set(page.persistentId, pathV2);
+  }
+  return result;
+}
+function calculateElementParentChain(elementParentPersistentId, groupPersistentIdToGroupMap) {
+  const result = [];
+  let parentId = elementParentPersistentId;
+  while (parentId) {
+    const parent = groupPersistentIdToGroupMap.get(parentId);
+    if (parent)
+      result.push(parent);
+    parentId = parent?.parentPersistentId;
+  }
+  return result;
+}
+
+// src/api/conversion/documentation/documentation-page-v2-to-dto.ts
+function documentationPagesToStructureDTOV2(pages, groups) {
+  const pathsMap = buildDocPagePublishPaths(groups, pages);
+  return pages.map((page) => documentationPageToStructureDTOV2(page, pathsMap));
+}
+function documentationPagesToDTOV2(pages, groups) {
+  const pathsMap = buildDocPagePublishPaths(groups, pages);
+  return pages.map((page) => {
+    return {
+      ...documentationPageToStructureDTOV2(page, pathsMap),
+      configuration: page.data.configuration ?? {
+        showSidebar: true,
+        header: defaultDocumentationItemHeader
+      }
+    };
+  });
+}
+function documentationPageToStructureDTOV2(page, pagePathMap) {
+  let path = pagePathMap.get(page.persistentId);
+  if (!path)
+    throw new Error(`Path for page ${page.id} was not calculated`);
+  if (path.startsWith("/"))
+    path = path.substring(1);
+  return {
+    id: page.id,
+    designSystemVersionId: page.designSystemVersionId,
+    persistentId: page.persistentId,
+    shortPersistentId: page.shortPersistentId,
+    title: page.meta.name,
+    slug: page.slug,
+    userSlug: page.userSlug,
+    createdAt: page.createdAt,
+    updatedAt: page.updatedAt,
+    path
+  };
+}
+
+// src/api/conversion/documentation/documentation-group-to-dto.ts
+function elementGroupsToDocumentationGroupStructureDTO(groups, pages) {
+  const childrenIdsMap = calculateChildrenIdsMap(pages, groups);
+  return groups.map((group) => elementGroupToDocumentationGroupStructureDTO(group, childrenIdsMap));
+}
+function elementGroupsToDocumentationGroupDTO(groups, pages) {
+  const childrenIdsMap = calculateChildrenIdsMap(pages, groups);
+  return groups.map((group) => {
+    return {
+      ...elementGroupToDocumentationGroupStructureDTO(group, childrenIdsMap),
+      configuration: group.data?.configuration ?? {
+        showSidebar: true,
+        header: defaultDocumentationItemHeader
+      }
+    };
+  });
+}
+function elementGroupToDocumentationGroupStructureDTO(group, childrenIdsMap) {
+  const childrenIds = childrenIdsMap.get(group.persistentId) ?? [];
+  if (!group.shortPersistentId) {
+    throw new Error(`Short persistent id is required for docs groups, group id: ${group.id}`);
+  }
+  return {
+    id: group.id,
+    designSystemVersionId: group.designSystemVersionId,
+    persistentId: group.persistentId,
+    slug: group.slug,
+    userSlug: group.userSlug,
+    createdAt: group.createdAt,
+    updatedAt: group.updatedAt,
+    title: group.meta.name,
+    childrenIds,
+    isRoot: !group.parentPersistentId,
+    groupBehavior: group.data?.behavior ?? "Group",
+    shortPersistentId: group.shortPersistentId
+  };
+}
+function calculateChildrenIdsMap(elements, groups) {
+  const byParentId = groupBy([...elements, ...groups], (e) => e.parentPersistentId);
+  const childrenIdsMap = /* @__PURE__ */ new Map();
+  for (const [parentPersistentId, children] of byParentId) {
+    if (!parentPersistentId)
+      continue;
+    children.sort((lhs, rhs) => lhs.sortOrder - rhs.sortOrder);
+    childrenIdsMap.set(
+      parentPersistentId,
+      children.map((c) => c.persistentId)
+    );
+  }
+  return childrenIdsMap;
+}
+
+// src/api/conversion/documentation/documentation-elements-to-hierarchy-v2-dto.ts
+function documentationElementsToHierarchyDto(docPages, docGroups) {
+  return {
+    pages: documentationPagesToStructureDTOV2(docPages, docGroups),
+    groups: elementGroupsToDocumentationGroupStructureDTO(docGroups, docPages)
+  };
+}
+
+// src/api/conversion/documentation/documentation-page-v1-to-dto.ts
+function documentationPagesToDTOV1(pages, groups) {
+  const pathsMap = buildDocPagePublishPaths(groups, pages);
+  return pages.map((page) => {
+    let path = pathsMap.get(page.persistentId);
+    if (!path)
+      throw SupernovaException.conflict(`Path for page ${page.id} was not calculated`);
+    if (path.startsWith("/"))
+      path = path.substring(1);
+    return {
+      id: page.id,
+      designSystemVersionId: page.designSystemVersionId,
+      persistentId: page.persistentId,
+      shortPersistentId: page.shortPersistentId,
+      title: page.meta.name,
+      blocks: page.data.blocks,
+      slug: page.slug,
+      userSlug: page.userSlug,
+      configuration: page.data.configuration ?? {
+        showSidebar: true,
+        header: defaultDocumentationItemHeader
+      },
+      createdAt: page.createdAt,
+      updatedAt: page.updatedAt,
+      path
+    };
+  });
+}
 
-// src/api/dto/design-system.ts
-var DesignSystemDTO = DesignSystem.omit({
+// src/api/dto/design-systems/design-system.ts
+var DTODesignSystem = DesignSystem.omit({
   name: true,
   description: true
 }).extend({
   meta: ObjectMeta
 });
 
-// src/api/dto/documentation-v1.ts
-import { z as z126 } from "zod";
-var DocumentationPageV1DTO = DocumentationPageV1.omit({
-  data: true,
-  meta: true,
-  parentPersistentId: true,
-  sortOrder: true
-}).extend(DocumentationPageV1.shape.data.shape).extend({
-  title: z126.string(),
-  path: z126.string()
-});
-
-// src/api/dto/documentation-v2.ts
-import { z as z128 } from "zod";
-
-// src/api/dto/documentation.ts
+// src/api/dto/elements/documentation/group-action.ts
 import { z as z127 } from "zod";
-var DocumentationGroupStructureDTO = ElementGroup.omit({
+
+// src/api/dto/elements/documentation/group.ts
+import { z as z126 } from "zod";
+var DTODocumentationGroupStructure = ElementGroup.omit({
   sortOrder: true,
   parentPersistentId: true,
   brandPersistentId: true,
@@ -2709,92 +3570,284 @@ var DocumentationGroupStructureDTO = ElementGroup.omit({
   data: true,
   shortPersistentId: true
 }).extend({
-  title: z127.string(),
-  isRoot: z127.boolean(),
-  childrenIds: z127.array(z127.string()),
+  title: z126.string(),
+  isRoot: z126.boolean(),
+  childrenIds: z126.array(z126.string()),
   groupBehavior: DocumentationGroupBehavior,
-  shortPersistentId: z127.string()
+  shortPersistentId: z126.string()
 });
-var DocumentationGroupDTO = DocumentationGroupStructureDTO.extend({
+var DTODocumentationGroup = DTODocumentationGroupStructure.extend({
   configuration: DocumentationItemConfiguration
 });
+var DTOCreateDocumentationGroupInput = z126.object({
+  // Identifier
+  persistentId: z126.string().uuid(),
+  // Group properties
+  title: z126.string(),
+  configuration: DocumentationItemConfiguration.optional(),
+  groupBehavior: DocumentationGroupBehavior,
+  // Group placement properties
+  afterPersistentId: z126.string().uuid().optional(),
+  parentPersistentId: z126.string().uuid()
+});
+var DTOUpdateDocumentationGroupInput = z126.object({
+  // Identifier of the group to update
+  id: z126.string().uuid(),
+  // Group properties
+  title: z126.string().optional(),
+  configuration: DocumentationItemConfiguration.optional()
+});
+var DTODuplicateDocumentationGroupInput = z126.object({
+  // Identifier of the group to duplicate from
+  id: z126.string(),
+  // New group persistent id
+  persistentId: z126.string().uuid(),
+  // Group placement properties
+  afterPersistentId: z126.string().uuid().optional(),
+  parentPersistentId: z126.string().uuid()
+});
+var DTODeleteDocumentationGroupInput = z126.object({
+  // Identifier
+  id: z126.string(),
+  // Deletion options
+  deleteSubtree: z126.boolean().default(false)
+});
 
-// src/api/dto/documentation-v2.ts
+// src/api/dto/elements/documentation/group-action.ts
+var DTODocumentationGroupCreateActionOutputV2 = z127.object({
+  type: z127.literal("DocumentationGroupCreate"),
+  output: DTODocumentationGroup
+});
+var DTODocumentationGroupUpdateActionOutputV2 = z127.object({
+  type: z127.literal("DocumentationGroupUpdate"),
+  output: DTODocumentationGroup
+});
+var DTODocumentationGroupDuplicateActionOutputV2 = z127.object({
+  type: z127.literal("DocumentationGroupDuplicate"),
+  output: DTODocumentationGroup
+});
+var DTODocumentationGroupDeleteActionOutputV2 = z127.object({
+  type: z127.literal("DocumentationGroupDelete"),
+  output: z127.string()
+});
+var DTODocumentationGroupCreateActionInputV2 = z127.object({
+  type: z127.literal("DocumentationGroupCreate"),
+  input: DTOCreateDocumentationGroupInput
+});
+var DTODocumentationGroupUpdateActionInputV2 = z127.object({
+  type: z127.literal("DocumentationGroupUpdate"),
+  input: DTOUpdateDocumentationGroupInput
+});
+var DTODocumentationGroupDuplicateActionInputV2 = z127.object({
+  type: z127.literal("DocumentationGroupDuplicate"),
+  input: DTODuplicateDocumentationGroupInput
+});
+var DTODocumentationGroupDeleteActionInputV2 = z127.object({
+  type: z127.literal("DocumentationGroupDelete"),
+  input: DTODeleteDocumentationGroupInput
+});
+
+// src/api/dto/elements/documentation/group-bulk-action.ts
+import { z as z128 } from "zod";
+var DTODocumentationGroupBulkActionOutputV2 = z128.object({
+  created: z128.array(DTODocumentationGroup),
+  updated: z128.array(DTODocumentationGroup),
+  deleted: z128.array(z128.string())
+});
+var DTODocumentationGroupBulkActionInputV2 = z128.object({
+  create: z128.array(DTOCreateDocumentationGroupInput).optional(),
+  update: z128.array(DTOUpdateDocumentationGroupInput).optional(),
+  duplicate: z128.array(DTODuplicateDocumentationGroupInput).optional(),
+  delete: z128.array(z128.string()).optional()
+});
+
+// src/api/dto/elements/documentation/page-actions-v2.ts
+import { z as z130 } from "zod";
+
+// src/api/dto/elements/documentation/page-v2.ts
+import { z as z129 } from "zod";
 var DTODocumentationPageStructureV2 = DocumentationPageV2.omit({
   data: true,
   meta: true,
   parentPersistentId: true,
   sortOrder: true
 }).extend({
-  title: z128.string(),
-  path: z128.string()
+  title: z129.string(),
+  path: z129.string()
 });
-var DTODocumentationPageV2 = DTODocumentationPageStructureV2.extend(DocumentationPageV2.shape.data.shape);
-var DTODocumentationHierarchyV2 = z128.object({
-  pages: z128.array(DTODocumentationPageStructureV2),
-  groups: z128.array(DocumentationGroupStructureDTO)
+var DTODocumentationPageV2 = DTODocumentationPageStructureV2.extend({
+  configuration: DocumentationItemConfiguration
 });
-
-// src/api/requests/elements/elements-transaction-v2.ts
-import { z as z129 } from "zod";
-var DTOCreateDocumentationPageInput = z129.object({
-  parentPersistentId: z129.string().uuid(),
+var DTODocumentationHierarchyV2 = z129.object({
+  pages: z129.array(DTODocumentationPageStructureV2),
+  groups: z129.array(DTODocumentationGroupStructure)
+});
+var DTOCreateDocumentationPageInputV2 = z129.object({
+  // Identifier
   persistentId: z129.string().uuid(),
+  // Page properties
   title: z129.string(),
   configuration: DocumentationItemConfiguration.optional(),
+  // Page placement properties
+  parentPersistentId: z129.string().uuid(),
   afterPersistentId: z129.string().uuid().optional()
 });
-var DTOUpdateDocumentationPageInput = z129.object({
+var DTOUpdateDocumentationPageInputV2 = z129.object({
+  // Identifier of the group to update
   id: z129.string(),
+  // Page properties
   title: z129.string().optional(),
   configuration: DocumentationItemConfiguration.optional(),
+  // Page placement properties
   parentPersistentId: z129.string().optional(),
   afterPersistentId: z129.string().optional()
 });
-var DTODuplicateDocumentationPageInput = z129.object({
+var DTODuplicateDocumentationPageInputV2 = z129.object({
+  // Identifier of the page to duplicate from
   id: z129.string(),
+  // New page persistent id
   persistentId: z129.string().uuid(),
+  // Page placement properties
   parentPersistentId: z129.string().uuid(),
   afterPersistentId: z129.string().uuid().optional()
 });
-var DTODocumentationTransactionInput = z129.object({
-  create: z129.array(DTOCreateDocumentationPageInput).optional(),
-  update: z129.array(DTOUpdateDocumentationPageInput).optional(),
-  duplicate: z129.array(DTODuplicateDocumentationPageInput).optional(),
-  delete: z129.array(z129.string()).optional()
-});
-var DTOElementsTransactionInput = z129.object({
-  documentationPages: DTODocumentationTransactionInput
+var DTODeleteDocumentationPageInputV2 = z129.object({
+  // Identifier
+  id: z129.string()
 });
 
-// src/api/requests/post-liveblocks-auth.ts
-import { z as z130 } from "zod";
-var PostLiveblocksAuth = z130.object({
-  room: z130.string()
+// src/api/dto/elements/documentation/page-actions-v2.ts
+var DTODocumentationPageCreateActionOutputV2 = z130.object({
+  type: z130.literal("DocumentationPageCreate"),
+  output: DTODocumentationPageV2
+});
+var DTODocumentationPageUpdateActionOutputV2 = z130.object({
+  type: z130.literal("DocumentationPageUpdate"),
+  output: DTODocumentationPageV2
+});
+var DTODocumentationPageDuplicateActionOutputV2 = z130.object({
+  type: z130.literal("DocumentationPageDuplicate"),
+  output: DTODocumentationPageV2
+});
+var DTODocumentationPageDeleteActionOutputV2 = z130.object({
+  type: z130.literal("DocumentationPageDelete"),
+  output: z130.string()
+});
+var DTODocumentationPageCreateActionInputV2 = z130.object({
+  type: z130.literal("DocumentationPageCreate"),
+  input: DTOCreateDocumentationPageInputV2
+});
+var DTODocumentationPageUpdateActionInputV2 = z130.object({
+  type: z130.literal("DocumentationPageUpdate"),
+  input: DTOUpdateDocumentationPageInputV2
+});
+var DTODocumentationPageDuplicateActionInputV2 = z130.object({
+  type: z130.literal("DocumentationPageDuplicate"),
+  input: DTODuplicateDocumentationPageInputV2
+});
+var DTODocumentationPageDeleteActionInputV2 = z130.object({
+  type: z130.literal("DocumentationPageDelete"),
+  input: DTODeleteDocumentationPageInputV2
 });
 
-// src/api/responses/get-block-definitions.ts
+// src/api/dto/elements/documentation/page-bulk-action-v2.ts
 import { z as z131 } from "zod";
-var GetBlockDefinitionsResponse = z131.object({
-  definitions: z131.array(PageBlockDefinition)
+var DTODocumentationPageBulkActionOutputV2 = z131.object({
+  created: z131.array(DTODocumentationPageV2),
+  updated: z131.array(DTODocumentationPageV2),
+  deleted: z131.array(z131.string())
+});
+var DTODocumentationPageBulkActionInputV2 = z131.object({
+  create: z131.array(DTOCreateDocumentationPageInputV2).optional(),
+  update: z131.array(DTOUpdateDocumentationPageInputV2).optional(),
+  duplicate: z131.array(DTODuplicateDocumentationPageInputV2).optional(),
+  delete: z131.array(DTODeleteDocumentationPageInputV2).optional()
+});
+
+// src/api/dto/elements/documentation/page-v1.ts
+import { z as z132 } from "zod";
+var DocumentationPageV1DTO = DocumentationPageV1.omit({
+  data: true,
+  meta: true,
+  parentPersistentId: true,
+  sortOrder: true
+}).extend(DocumentationPageV1.shape.data.shape).extend({
+  title: z132.string(),
+  path: z132.string()
 });
 
-// src/design-system-content/documentation-hierarchy.ts
-function documentationHierarchyToYjs(doc, documentationHierarchy, itemsToDelete) {
+// src/api/dto/elements/elements-action-v2.ts
+import { z as z133 } from "zod";
+var DTOElementActionOutput = z133.discriminatedUnion("type", [
+  // Documentation pages
+  DTODocumentationPageCreateActionOutputV2,
+  DTODocumentationPageUpdateActionOutputV2,
+  DTODocumentationPageDuplicateActionOutputV2,
+  DTODocumentationPageDeleteActionOutputV2,
+  // Documentation groups
+  DTODocumentationGroupCreateActionOutputV2,
+  DTODocumentationGroupUpdateActionOutputV2,
+  DTODocumentationGroupDuplicateActionOutputV2,
+  DTODocumentationGroupDeleteActionOutputV2
+]);
+var DTOElementActionInput = z133.discriminatedUnion("type", [
+  // Documentation pages
+  DTODocumentationPageCreateActionInputV2,
+  DTODocumentationPageUpdateActionInputV2,
+  DTODocumentationPageDuplicateActionInputV2,
+  DTODocumentationPageDeleteActionInputV2,
+  // Documentation groups
+  DTODocumentationGroupCreateActionInputV2,
+  DTODocumentationGroupUpdateActionInputV2,
+  DTODocumentationGroupDuplicateActionInputV2,
+  DTODocumentationGroupDeleteActionInputV2
+]);
+
+// src/api/dto/elements/elements-bulk-action-v2.ts
+import { z as z134 } from "zod";
+var DTOElementsBulkActionOutputV2 = z134.object({
+  documentationPages: DTODocumentationPageBulkActionOutputV2
+});
+var DTOElementsBulkActionInputV2 = z134.object({
+  documentationPages: DTODocumentationPageBulkActionInputV2
+});
+
+// src/api/payloads/documentation/block-definitions.ts
+import { z as z135 } from "zod";
+var DTOGetBlockDefinitionsOutput = z135.object({
+  definitions: z135.array(PageBlockDefinition)
+});
+
+// src/api/payloads/liveblocks/auth.ts
+import { z as z136 } from "zod";
+var DTOLiveblocksAuthRequest = z136.object({
+  room: z136.string()
+});
+
+// src/yjs/design-system-content/documentation-hierarchy.ts
+function documentationHierarchyToYjs(doc, transaction) {
   doc.transact((trx) => {
     const pagesMap = getPagesYMap(trx.doc);
-    itemsToDelete.pagePersistentIdsToDelete.forEach((persistentId) => {
-      pagesMap.delete(persistentId);
+    transaction.pageIdsToDelete.forEach((pageId) => {
+      pagesMap.delete(pageId);
     });
-    documentationHierarchy.pages.forEach((page) => {
-      pagesMap.set(page.persistentId, page);
+    transaction.pages.forEach((page) => {
+      const sanitizedPage = {
+        ...page,
+        data: {}
+      };
+      pagesMap.set(page.id, sanitizedPage);
     });
     const groupsMap = getGroupsYMap(trx.doc);
-    itemsToDelete.groupPersistentIdsToDelete.forEach((persistentId) => {
-      groupsMap.delete(persistentId);
+    transaction.groupIdsToDelete.forEach((id) => {
+      groupsMap.delete(id);
     });
-    documentationHierarchy.groups.forEach((group) => {
-      groupsMap.set(group.persistentId, group);
+    transaction.groups.forEach((group) => {
+      const sanitizedGroup = {
+        ...group,
+        data: {}
+      };
+      groupsMap.set(group.id, group);
     });
   });
   return doc;
@@ -2804,16 +3857,14 @@ function yjsToDocumentationHierarchy(doc) {
   const groupsMap = getGroupsYMap(doc);
   const pages = [];
   pagesMap.forEach((page) => {
-    pages.push(DTODocumentationPageStructureV2.parse(page));
+    pages.push(DocumentationPageV2.parse(page));
   });
   const groups = [];
   groupsMap.forEach((group) => {
-    groups.push(DocumentationGroupStructureDTO.parse(group));
+    groups.push(ElementGroup.parse(group));
   });
-  return {
-    pages,
-    groups
-  };
+  const hierarchy = documentationElementsToHierarchyDto(pages, groups);
+  return hierarchy;
 }
 function getPagesYMap(doc) {
   return doc.getMap("documentationPages");
@@ -2822,7 +3873,7 @@ function getGroupsYMap(doc) {
   return doc.getMap("documentationGroups");
 }
 
-// src/design-system-content/item-configuration.ts
+// src/yjs/design-system-content/item-configuration.ts
 function itemConfigurationToYjs(yDoc, item) {
   yDoc.transact((trx) => {
     const header = item.header;
@@ -2865,20 +3916,20 @@ function yjsToItemConfiguration(yDoc) {
   return DocumentationItemConfiguration.parse(rawConfig);
 }
 
-// src/docs-editor/model/block.ts
-import { z as z132 } from "zod";
-var PageBlockEditorModel = z132.object({
-  id: z132.string(),
+// src/yjs/docs-editor/model/block.ts
+import { z as z137 } from "zod";
+var PageBlockEditorModel = z137.object({
+  id: z137.string(),
   data: PageBlockDataV2
 });
 
-// src/docs-editor/model/page.ts
-import { z as z133 } from "zod";
-var DocumentationPageEditorModel = z133.object({
-  blocks: z133.array(PageBlockEditorModel)
+// src/yjs/docs-editor/model/page.ts
+import { z as z138 } from "zod";
+var DocumentationPageEditorModel = z138.object({
+  blocks: z138.array(PageBlockEditorModel)
 });
 
-// src/docs-editor/prosemirror/schema.ts
+// src/yjs/docs-editor/prosemirror/schema.ts
 import { Schema } from "prosemirror-model";
 var newSchema = {
   nodes: {
@@ -3554,7 +4605,7 @@ var newSchema = {
 };
 var pmSchema = new Schema(newSchema);
 
-// src/docs-editor/utils.ts
+// src/yjs/docs-editor/utils.ts
 var BlockParsingUtils = {
   singleBlockItem(block) {
     if (!block.data.items.length)
@@ -3639,7 +4690,7 @@ var BlockDefinitionUtils = {
   }
 };
 
-// src/docs-editor/blocks-to-prosemirror.ts
+// src/yjs/docs-editor/blocks-to-prosemirror.ts
 import { prosemirrorJSONToYXmlFragment } from "y-prosemirror";
 function pageToYXmlFragment(page, definitions, fragment) {
   const doc = pageToProsemirrorDoc(page, definitions);
@@ -4013,7 +5064,7 @@ function nonNullFilter(item) {
   return !!item;
 }
 
-// src/docs-editor/mock.ts
+// src/yjs/docs-editor/mock.ts
 function getMockPageBlockDefinitions() {
   return blocks;
 }
@@ -6506,9 +7557,9 @@ var blocks = [
   }
 ];
 
-// src/docs-editor/prosemirror-to-blocks.ts
+// src/yjs/docs-editor/prosemirror-to-blocks.ts
 import { yXmlFragmentToProsemirrorJSON } from "y-prosemirror";
-import { z as z134 } from "zod";
+import { z as z139 } from "zod";
 function yDocToPage(yDoc, definitions) {
   return yXmlFragmentToPage(yDoc.getXmlFragment("default"), definitions);
 }
@@ -6517,10 +7568,10 @@ function yXmlFragmentToPage(fragment, definitions) {
   return prosemirrorDocToPage(prosemirrorJson, definitions);
 }
 function prosemirrorDocToPage(prosemirrorDoc, definitions) {
-  const definitionsById = mapByUnique(definitions, (d) => d.id);
+  const definitionsById = mapByUnique2(definitions, (d) => d.id);
   return {
     blocks: (prosemirrorDoc.content ?? []).map((prosemirrorNode) => {
-      const definitionId = getProsemirrorAttribute(prosemirrorNode, "definitionId", z134.string());
+      const definitionId = getProsemirrorAttribute(prosemirrorNode, "definitionId", z139.string());
       if (!definitionId) {
         console.warn(
           `definitionId on ${prosemirrorNode.type} is required to be interpreted as a block, skipping node`
@@ -6562,7 +7613,7 @@ function parseAsRichText(prosemirrorNode, definition, property) {
   if (!id)
     return null;
   const variantId = getProsemirrorBlockVariantId(prosemirrorNode);
-  const calloutType = parseCalloutType(getProsemirrorAttribute(prosemirrorNode, "type", z134.string().optional()));
+  const calloutType = parseCalloutType(getProsemirrorAttribute(prosemirrorNode, "type", z139.string().optional()));
   return {
     // TODO Artem: indent
     id,
@@ -6662,8 +7713,8 @@ function parseRichTextAttribute(mark) {
     case "code":
       return { type: "Code" };
     case "link":
-      const itemId = getProsemirrorAttribute(mark, "itemId", z134.string().optional());
-      const href = getProsemirrorAttribute(mark, "href", z134.string().optional());
+      const itemId = getProsemirrorAttribute(mark, "itemId", z139.string().optional());
+      const href = getProsemirrorAttribute(mark, "href", z139.string().optional());
       return {
         type: "Link",
         openInNewWindow: mark.attrs?.target !== "_self",
@@ -6678,7 +7729,7 @@ function parseAsTable(prosemirrorNode, definition, property) {
   if (!id)
     return null;
   const variantId = getProsemirrorBlockVariantId(prosemirrorNode);
-  const hasBorder = getProsemirrorAttribute(prosemirrorNode, "hasBorder", z134.boolean().optional()) !== false;
+  const hasBorder = getProsemirrorAttribute(prosemirrorNode, "hasBorder", z139.boolean().optional()) !== false;
   const tableChild = prosemirrorNode.content?.find((c) => c.type === "table");
   if (!tableChild) {
     return emptyTable(id, variantId, 0);
@@ -6724,9 +7775,9 @@ function parseAsTableCell(prosemirrorNode) {
   const id = getProsemirrorBlockId(prosemirrorNode);
   if (!id)
     return null;
-  const textAlign = getProsemirrorAttribute(prosemirrorNode, "textAlign", z134.string().optional());
+  const textAlign = getProsemirrorAttribute(prosemirrorNode, "textAlign", z139.string().optional());
   let columnWidth;
-  const columnWidthArray = getProsemirrorAttribute(prosemirrorNode, "colwidth", z134.array(z134.number()).optional());
+  const columnWidthArray = getProsemirrorAttribute(prosemirrorNode, "colwidth", z139.array(z139.number()).optional());
   if (columnWidthArray) {
     columnWidth = columnWidthArray[0];
   }
@@ -6760,7 +7811,7 @@ function parseAsTableNode(prosemirrorNode) {
         value: parseRichText(prosemirrorNode.content ?? [])
       };
     case "image":
-      const url = getProsemirrorAttribute(prosemirrorNode, "src", z134.string().optional());
+      const url = getProsemirrorAttribute(prosemirrorNode, "src", z139.string().optional());
       if (!url)
         return null;
       return {
@@ -6854,7 +7905,7 @@ function parseAsCustomBlock(prosemirrorNode, definition) {
   };
 }
 function parseBlockItems(prosemirrorNode, definition) {
-  const itemsString = getProsemirrorAttribute(prosemirrorNode, "items", z134.string());
+  const itemsString = getProsemirrorAttribute(prosemirrorNode, "items", z139.string());
   if (!itemsString)
     return null;
   const itemsJson = JSON.parse(itemsString);
@@ -6866,11 +7917,11 @@ function parseBlockItems(prosemirrorNode, definition) {
 }
 function parseAppearance(prosemirrorNode) {
   const appearance = {};
-  const columns = getProsemirrorAttribute(prosemirrorNode, "columns", z134.number().optional());
+  const columns = getProsemirrorAttribute(prosemirrorNode, "columns", z139.number().optional());
   if (columns) {
     appearance.numberOfColumns = columns;
   }
-  const backgroundColor = getProsemirrorAttribute(prosemirrorNode, "backgroundColor", z134.string().optional());
+  const backgroundColor = getProsemirrorAttribute(prosemirrorNode, "backgroundColor", z139.string().optional());
   if (backgroundColor) {
     const parsedColor = PageBlockColorV2.safeParse(JSON.parse(backgroundColor));
     if (parsedColor.success) {
@@ -6961,13 +8012,13 @@ function valueSchemaForPropertyType(type) {
   }
 }
 function getProsemirrorBlockId(prosemirrorNode) {
-  const id = getProsemirrorAttribute(prosemirrorNode, "id", z134.string());
+  const id = getProsemirrorAttribute(prosemirrorNode, "id", z139.string());
   if (!id)
     console.warn(`Prosemirror attribute "id" on ${prosemirrorNode.type} is required`);
   return id;
 }
 function getProsemirrorBlockVariantId(prosemirrorNode) {
-  return getProsemirrorAttribute(prosemirrorNode, "variantId", nullishToOptional(z134.string()));
+  return getProsemirrorAttribute(prosemirrorNode, "variantId", nullishToOptional(z139.string()));
 }
 function getProsemirrorAttribute(prosemirrorNode, attributeName, validationSchema) {
   const parsedAttr = validationSchema.safeParse(prosemirrorNode.attrs?.[attributeName]);
@@ -6982,7 +8033,7 @@ function getProsemirrorAttribute(prosemirrorNode, attributeName, validationSchem
 function nonNullFilter2(item) {
   return item !== null;
 }
-function mapByUnique(items, keyFn) {
+function mapByUnique2(items, keyFn) {
   const result = /* @__PURE__ */ new Map();
   for (const item of items) {
     result.set(keyFn(item), item);
@@ -6992,25 +8043,60 @@ function mapByUnique(items, keyFn) {
 export {
   BlockDefinitionUtils,
   BlockParsingUtils,
-  DTOCreateDocumentationPageInput,
+  DTOCreateDocumentationGroupInput,
+  DTOCreateDocumentationPageInputV2,
+  DTODeleteDocumentationGroupInput,
+  DTODeleteDocumentationPageInputV2,
+  DTODesignSystem,
+  DTODocumentationGroup,
+  DTODocumentationGroupBulkActionInputV2,
+  DTODocumentationGroupBulkActionOutputV2,
+  DTODocumentationGroupCreateActionInputV2,
+  DTODocumentationGroupCreateActionOutputV2,
+  DTODocumentationGroupDeleteActionInputV2,
+  DTODocumentationGroupDeleteActionOutputV2,
+  DTODocumentationGroupDuplicateActionInputV2,
+  DTODocumentationGroupDuplicateActionOutputV2,
+  DTODocumentationGroupStructure,
+  DTODocumentationGroupUpdateActionInputV2,
+  DTODocumentationGroupUpdateActionOutputV2,
   DTODocumentationHierarchyV2,
+  DTODocumentationPageBulkActionInputV2,
+  DTODocumentationPageBulkActionOutputV2,
+  DTODocumentationPageCreateActionInputV2,
+  DTODocumentationPageCreateActionOutputV2,
+  DTODocumentationPageDeleteActionInputV2,
+  DTODocumentationPageDeleteActionOutputV2,
+  DTODocumentationPageDuplicateActionInputV2,
+  DTODocumentationPageDuplicateActionOutputV2,
   DTODocumentationPageStructureV2,
+  DTODocumentationPageUpdateActionInputV2,
+  DTODocumentationPageUpdateActionOutputV2,
   DTODocumentationPageV2,
-  DTODocumentationTransactionInput,
-  DTODuplicateDocumentationPageInput,
-  DTOElementsTransactionInput,
-  DTOUpdateDocumentationPageInput,
-  DesignSystemDTO,
-  DocumentationGroupDTO,
-  DocumentationGroupStructureDTO,
+  DTODuplicateDocumentationGroupInput,
+  DTODuplicateDocumentationPageInputV2,
+  DTOElementActionInput,
+  DTOElementActionOutput,
+  DTOElementsBulkActionInputV2,
+  DTOElementsBulkActionOutputV2,
+  DTOGetBlockDefinitionsOutput,
+  DTOLiveblocksAuthRequest,
+  DTOUpdateDocumentationGroupInput,
+  DTOUpdateDocumentationPageInputV2,
   DocumentationPageEditorModel,
   DocumentationPageV1DTO,
-  GetBlockDefinitionsResponse,
   PageBlockEditorModel,
-  PostLiveblocksAuth,
   blockDefinitionForBlock,
   blockToProsemirrorNode,
+  buildDocPagePublishPaths,
+  calculateElementParentChain,
+  documentationElementsToHierarchyDto,
   documentationHierarchyToYjs,
+  documentationPagesToDTOV1,
+  documentationPagesToDTOV2,
+  documentationPagesToStructureDTOV2,
+  elementGroupsToDocumentationGroupDTO,
+  elementGroupsToDocumentationGroupStructureDTO,
   getMockPageBlockDefinitions,
   itemConfigurationToYjs,
   pageToProsemirrorDoc,