@strapi/core 5.54.0 → 5.55.0

package/dist/services/content-structure/index.js

@@ -0,0 +1,304 @@
+'use strict';
+
+var path = require('path');
+var fse = require('fs-extra');
+var isGroupExpressionValid = require('./utils/isGroupExpressionValid.js');
+var validation = require('./validation.js');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var fse__default = /*#__PURE__*/_interopDefault(fse);
+
+const CONTENT_STRUCTURE_FILE_NAME = 'groups.json';
+const MAX_FOLDER_DEPTH = 3;
+const isRecord = (value)=>{
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+};
+function createContentStructureService(strapi) {
+    /**
+   * This cache exists to ensure all consumers recieve the same cleaned+resolved data, regardless of call order / invocation relative to the strapi reload.
+   */ let cache;
+    const warn = (message)=>{
+        strapi.log.warn(`[content-structure] ${message}`);
+    };
+    const cleanSection = (rawSection, sectionKey)=>{
+        const rawGroups = (()=>{
+            if (rawSection === undefined || rawSection === null) {
+                return [];
+            }
+            if (!isRecord(rawSection) || !Array.isArray(rawSection.groups)) {
+                warn(`Section "${sectionKey}" is malformed; ignoring it`);
+                return [];
+            }
+            return rawSection.groups;
+        })();
+        const seenGroupIds = new Map();
+        const groups = [];
+        for (const raw of rawGroups){
+            if (!isGroupExpressionValid.isGroupExpressionValid(raw)) {
+                warn(`Dropping a malformed group entry in section "${sectionKey}"`);
+                continue;
+            }
+            if (raw.name.trim() === '') {
+                warn(`Dropping group "${raw.id}" in section "${sectionKey}": empty name`);
+                continue;
+            }
+            if (seenGroupIds.has(raw.id)) {
+                warn(`Dropping duplicate group id "${raw.id}" in section "${sectionKey}"`);
+                continue;
+            }
+            const group = {
+                children: raw.children,
+                parent: raw.parent,
+                name: raw.name,
+                id: raw.id
+            };
+            seenGroupIds.set(group.id, group);
+            groups.push(group);
+        }
+        const reparentToRoot = (group, reason)=>{
+            group.parent = null;
+            groups.splice(groups.indexOf(group), 1);
+            groups.push(group);
+            warn(`Reparenting group "${group.id}" in section "${sectionKey}" to root: ${reason}`);
+        };
+        // oxlint-disable-next-line - Duplicating is necessary because the original array is mutated inside the iterator.
+        for (const group of [
+            ...groups
+        ]){
+            if (group.parent !== null && !seenGroupIds.has(group.parent)) {
+                reparentToRoot(group, `parent "${group.parent}" does not exist`);
+            }
+        }
+        // oxlint-disable-next-line - Duplicating is necessary because the original array is mutated inside the iterator.
+        for (const group of [
+            ...groups
+        ]){
+            const chain = new Set([
+                group.id
+            ]);
+            let current = group;
+            while(current.parent !== null){
+                if (chain.has(current.parent)) {
+                    reparentToRoot(group, 'its parent chain contains a cycle');
+                    break;
+                }
+                chain.add(current.parent);
+                current = seenGroupIds.get(current.parent);
+            }
+        }
+        // oxlint-disable-next-line - Duplicating is necessary because the original array is mutated inside the iterator.
+        for (const group of [
+            ...groups
+        ]){
+            let current = group;
+            let depth = 1;
+            while(current.parent !== null){
+                current = seenGroupIds.get(current.parent);
+                depth += 1;
+            }
+            if (depth > MAX_FOLDER_DEPTH) {
+                reparentToRoot(group, `it exceeds the maximum nesting depth of ${MAX_FOLDER_DEPTH}`);
+            }
+        }
+        const expectedKind = sectionKey === 'collectionTypes' ? 'collectionType' : 'singleType';
+        const seenGroupChildren = new Set();
+        const seenUids = new Set();
+        for (const group of groups){
+            const cleanedChildren = [];
+            for (const entry of group.children){
+                if (!isRecord(entry)) {
+                    warn(`Dropping a malformed child entry of group "${group.id}"`);
+                    continue;
+                }
+                if (entry.type === 'contentType') {
+                    const { uid } = entry;
+                    if (typeof uid !== 'string') {
+                        warn(`Dropping a contentType child of group "${group.id}": invalid uid`);
+                        continue;
+                    }
+                    const schema = strapi.contentTypes[uid];
+                    if (!schema) {
+                        warn(`Dropping unknown content type "${uid}" from group "${group.id}"`);
+                        continue;
+                    }
+                    // kind is optional on schemas; absent means collectionType.
+                    const kind = schema.kind ?? 'collectionType';
+                    if (kind !== expectedKind) {
+                        warn(`Dropping content type "${uid}" from group "${group.id}": its kind "${kind}" does not belong in section "${sectionKey}"`);
+                        continue;
+                    }
+                    if (seenUids.has(uid)) {
+                        warn(`Dropping duplicate reference to content type "${uid}" from group "${group.id}"`);
+                        continue;
+                    }
+                    cleanedChildren.push({
+                        type: 'contentType',
+                        uid: uid
+                    });
+                    seenUids.add(uid);
+                    continue;
+                }
+                if (entry.type === 'group') {
+                    const { id } = entry;
+                    if (typeof id !== 'string') {
+                        warn(`Dropping a group child of group "${group.id}": invalid id`);
+                        continue;
+                    }
+                    const target = seenGroupIds.get(id);
+                    if (!target || target.parent !== group.id) {
+                        warn(`Dropping group child "${id}" from group "${group.id}": inconsistent reference`);
+                        continue;
+                    }
+                    if (seenGroupChildren.has(id)) {
+                        warn(`Dropping duplicate group child "${id}" from group "${group.id}"`);
+                        continue;
+                    }
+                    cleanedChildren.push({
+                        type: 'group',
+                        id
+                    });
+                    seenGroupChildren.add(id);
+                    continue;
+                }
+                warn(`Dropping a child entry of group "${group.id}" with an unknown type`);
+            }
+            group.children = cleanedChildren;
+        }
+        for (const group of groups){
+            if (group.parent !== null && !seenGroupChildren.has(group.id)) {
+                const parent = seenGroupIds.get(group.parent);
+                parent.children.push({
+                    type: 'group',
+                    id: group.id
+                });
+                seenGroupChildren.add(group.id);
+                warn(`Group "${group.id}" was missing from the children of its parent "${parent.id}"; appended it`);
+            }
+        }
+        return {
+            groups
+        };
+    };
+    const resolveSection = (section)=>{
+        const byId = new Map(section.groups.map((group)=>[
+                group.id,
+                group
+            ]));
+        const toNode = (group)=>{
+            const cleanedChildren = group.children.map((entry)=>{
+                if (entry.type === 'contentType') {
+                    return {
+                        type: 'contentType',
+                        uid: entry.uid
+                    };
+                }
+                return toNode(byId.get(entry.id));
+            });
+            return {
+                children: cleanedChildren,
+                name: group.name,
+                type: 'group',
+                id: group.id
+            };
+        };
+        return section.groups.filter((group)=>group.parent === null).map(toNode);
+    };
+    async function read() {
+        const filePath = path.join(strapi.dirs.dist.contentStructure, CONTENT_STRUCTURE_FILE_NAME);
+        if (!await fse__default.default.pathExists(filePath)) {
+            return null;
+        }
+        let parsed;
+        try {
+            parsed = await fse__default.default.readJSON(filePath);
+        } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            strapi.log.error(`[content-structure] Could not parse ${filePath} (${message}); continuing without content-type folders`);
+            return null;
+        }
+        if (!isRecord(parsed) || !isRecord(parsed.sections)) {
+            strapi.log.error(`[content-structure] ${filePath} is not an object with a "sections" property; continuing without content-type folders`);
+            return null;
+        }
+        if (parsed.version !== 1) {
+            strapi.log.error(`[content-structure] Unknown version "${parsed.version}" in ${filePath} (expected 1); continuing without content-type folders`);
+            return null;
+        }
+        return parsed;
+    }
+    const load = ()=>{
+        if (!cache) {
+            cache = (async ()=>{
+                const file = await read();
+                if (!file) {
+                    return {
+                        cleaned: null,
+                        resolved: {
+                            collectionTypes: [],
+                            singleTypes: []
+                        }
+                    };
+                }
+                const cleaned = {
+                    version: 1,
+                    sections: {
+                        collectionTypes: cleanSection(file.sections.collectionTypes, 'collectionTypes'),
+                        singleTypes: cleanSection(file.sections.singleTypes, 'singleTypes')
+                    }
+                };
+                return {
+                    cleaned,
+                    resolved: {
+                        collectionTypes: resolveSection(cleaned.sections.collectionTypes),
+                        singleTypes: resolveSection(cleaned.sections.singleTypes)
+                    }
+                };
+            })();
+        }
+        return cache;
+    };
+    function invalidate() {
+        cache = undefined;
+    }
+    async function getCleanedFile() {
+        return (await load()).cleaned;
+    }
+    async function resolve() {
+        return (await load()).resolved;
+    }
+    async function write(structure) {
+        const dir = strapi.dirs.app.contentStructure;
+        await fse__default.default.ensureDir(dir);
+        await fse__default.default.writeJSON(path.join(dir, CONTENT_STRUCTURE_FILE_NAME), structure, {
+            spaces: 2
+        });
+        invalidate();
+    }
+    function validate(value) {
+        return validation.contentStructureFileSchema.parse(value);
+    }
+    async function countGroups() {
+        const { cleaned } = await load();
+        if (!cleaned) {
+            return 0;
+        }
+        const collectionTypesCount = cleaned.sections.collectionTypes.groups.length;
+        const singleTypesCount = cleaned.sections.singleTypes.groups.length;
+        return collectionTypesCount + singleTypesCount;
+    }
+    return {
+        getCleanedFile,
+        countGroups,
+        invalidate,
+        validate,
+        resolve,
+        write,
+        read
+    };
+}
+
+exports.CONTENT_STRUCTURE_FILE_NAME = CONTENT_STRUCTURE_FILE_NAME;
+exports.MAX_FOLDER_DEPTH = MAX_FOLDER_DEPTH;
+exports.createContentStructureService = createContentStructureService;
+//# sourceMappingURL=index.js.map

package/dist/services/content-structure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/services/content-structure/index.ts"],"sourcesContent":["import { join } from 'path';\nimport fse from 'fs-extra';\n\nimport type { Core, Modules, UID } from '@strapi/types';\nimport { isGroupExpressionValid } from './utils/isGroupExpressionValid';\nimport { contentStructureFileSchema } from './validation';\n\nexport const CONTENT_STRUCTURE_FILE_NAME = 'groups.json';\n\nexport const MAX_FOLDER_DEPTH = 3;\n\nexport interface ContentStructureService {\n  /**\n   * Reads the contents of groups.json directly with minimal sanitization.\n   */\n  read(): Promise<Modules.ContentStructure.ContentStructureFile | null>;\n\n  /**\n   * Yields an extremely tolerant version of the groups configuration file. Invalid references are repaired or ignored. Warnings fire for each repair/omission.\n   */\n  getCleanedFile(): Promise<Modules.ContentStructure.ContentStructureFile | null>;\n\n  /**\n   *  Returns the groups configuration transformed into nested trees.\n   */\n  resolve(): Promise<Modules.ContentStructure.ResolvedContentStructure>;\n\n  /**\n   * Writes a new config and invalidates the cache. Does NOT perform validation - this is\n   * left to the caller. The Save that triggers the write restarts the server via the\n   * standard update-schema flow, which reloads the file; this method only persists it.\n   */\n  write(structure: Modules.ContentStructure.ContentStructureFile): Promise<void>;\n\n  /**\n   * Strictly validates an unknown value against the canonical groups.json schema; throws if invalid.\n   */\n  validate(value: unknown): Modules.ContentStructure.ContentStructureFile;\n\n  /**\n   * Invalidates the cached parsed groups.json file.\n   */\n  invalidate(): void;\n\n  /**\n   * Total number of groups across both sections of the cleaned file.\n   */\n  countGroups(): Promise<number>;\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n};\n\ntype ContentStructureCache = Promise<{\n  cleaned: Modules.ContentStructure.ContentStructureFile | null;\n  resolved: Modules.ContentStructure.ResolvedContentStructure;\n}>;\n\nexport function createContentStructureService(strapi: Core.Strapi): ContentStructureService {\n  /**\n   * This cache exists to ensure all consumers recieve the same cleaned+resolved data, regardless of call order / invocation relative to the strapi reload.\n   */\n  let cache: ContentStructureCache | undefined;\n\n  const warn = (message: string) => {\n    strapi.log.warn(`[content-structure] ${message}`);\n  };\n\n  const cleanSection = (\n    rawSection: unknown,\n    sectionKey: Modules.ContentStructure.ContentStructureSectionKey\n  ): Modules.ContentStructure.ContentStructureSection => {\n    const rawGroups = (() => {\n      if (rawSection === undefined || rawSection === null) {\n        return [];\n      }\n\n      if (!isRecord(rawSection) || !Array.isArray(rawSection.groups)) {\n        warn(`Section \"${sectionKey}\" is malformed; ignoring it`);\n        return [];\n      }\n\n      return rawSection.groups;\n    })();\n\n    const seenGroupIds = new Map<string, Modules.ContentStructure.ContentStructureGroup>();\n    const groups: Modules.ContentStructure.ContentStructureGroup[] = [];\n\n    for (const raw of rawGroups) {\n      if (!isGroupExpressionValid(raw)) {\n        warn(`Dropping a malformed group entry in section \"${sectionKey}\"`);\n        continue;\n      }\n\n      if (raw.name.trim() === '') {\n        warn(`Dropping group \"${raw.id}\" in section \"${sectionKey}\": empty name`);\n        continue;\n      }\n\n      if (seenGroupIds.has(raw.id)) {\n        warn(`Dropping duplicate group id \"${raw.id}\" in section \"${sectionKey}\"`);\n        continue;\n      }\n\n      const group: Modules.ContentStructure.ContentStructureGroup = {\n        children: raw.children as Modules.ContentStructure.ContentStructureChild[],\n        parent: raw.parent,\n        name: raw.name,\n        id: raw.id,\n      };\n\n      seenGroupIds.set(group.id, group);\n      groups.push(group);\n    }\n\n    const reparentToRoot = (\n      group: Modules.ContentStructure.ContentStructureGroup,\n      reason: string\n    ) => {\n      group.parent = null;\n\n      groups.splice(groups.indexOf(group), 1);\n      groups.push(group);\n\n      warn(`Reparenting group \"${group.id}\" in section \"${sectionKey}\" to root: ${reason}`);\n    };\n\n    // oxlint-disable-next-line - Duplicating is necessary because the original array is mutated inside the iterator.\n    for (const group of [...groups]) {\n      if (group.parent !== null && !seenGroupIds.has(group.parent)) {\n        reparentToRoot(group, `parent \"${group.parent}\" does not exist`);\n      }\n    }\n\n    // oxlint-disable-next-line - Duplicating is necessary because the original array is mutated inside the iterator.\n    for (const group of [...groups]) {\n      const chain = new Set([group.id]);\n      let current = group;\n\n      while (current.parent !== null) {\n        if (chain.has(current.parent)) {\n          reparentToRoot(group, 'its parent chain contains a cycle');\n          break;\n        }\n\n        chain.add(current.parent);\n        current = seenGroupIds.get(current.parent)!;\n      }\n    }\n\n    // oxlint-disable-next-line - Duplicating is necessary because the original array is mutated inside the iterator.\n    for (const group of [...groups]) {\n      let current = group;\n      let depth = 1;\n\n      while (current.parent !== null) {\n        current = seenGroupIds.get(current.parent)!;\n        depth += 1;\n      }\n\n      if (depth > MAX_FOLDER_DEPTH) {\n        reparentToRoot(group, `it exceeds the maximum nesting depth of ${MAX_FOLDER_DEPTH}`);\n      }\n    }\n\n    const expectedKind = sectionKey === 'collectionTypes' ? 'collectionType' : 'singleType';\n    const seenGroupChildren = new Set<string>();\n    const seenUids = new Set<string>();\n\n    for (const group of groups) {\n      const cleanedChildren: Modules.ContentStructure.ContentStructureChild[] = [];\n\n      for (const entry of group.children) {\n        if (!isRecord(entry)) {\n          warn(`Dropping a malformed child entry of group \"${group.id}\"`);\n          continue;\n        }\n\n        if (entry.type === 'contentType') {\n          const { uid } = entry;\n\n          if (typeof uid !== 'string') {\n            warn(`Dropping a contentType child of group \"${group.id}\": invalid uid`);\n            continue;\n          }\n\n          const schema: { kind?: string } | undefined = strapi.contentTypes[uid as UID.ContentType];\n\n          if (!schema) {\n            warn(`Dropping unknown content type \"${uid}\" from group \"${group.id}\"`);\n            continue;\n          }\n\n          // kind is optional on schemas; absent means collectionType.\n          const kind = schema.kind ?? 'collectionType';\n\n          if (kind !== expectedKind) {\n            warn(\n              `Dropping content type \"${uid}\" from group \"${group.id}\": its kind \"${kind}\" does not belong in section \"${sectionKey}\"`\n            );\n            continue;\n          }\n\n          if (seenUids.has(uid)) {\n            warn(`Dropping duplicate reference to content type \"${uid}\" from group \"${group.id}\"`);\n            continue;\n          }\n\n          cleanedChildren.push({ type: 'contentType', uid: uid as UID.ContentType });\n          seenUids.add(uid);\n          continue;\n        }\n\n        if (entry.type === 'group') {\n          const { id } = entry;\n\n          if (typeof id !== 'string') {\n            warn(`Dropping a group child of group \"${group.id}\": invalid id`);\n            continue;\n          }\n\n          const target = seenGroupIds.get(id);\n\n          if (!target || target.parent !== group.id) {\n            warn(`Dropping group child \"${id}\" from group \"${group.id}\": inconsistent reference`);\n            continue;\n          }\n\n          if (seenGroupChildren.has(id)) {\n            warn(`Dropping duplicate group child \"${id}\" from group \"${group.id}\"`);\n            continue;\n          }\n\n          cleanedChildren.push({ type: 'group', id });\n          seenGroupChildren.add(id);\n          continue;\n        }\n\n        warn(`Dropping a child entry of group \"${group.id}\" with an unknown type`);\n      }\n\n      group.children = cleanedChildren;\n    }\n\n    for (const group of groups) {\n      if (group.parent !== null && !seenGroupChildren.has(group.id)) {\n        const parent = seenGroupIds.get(group.parent)!;\n\n        parent.children.push({ type: 'group', id: group.id });\n        seenGroupChildren.add(group.id);\n\n        warn(\n          `Group \"${group.id}\" was missing from the children of its parent \"${parent.id}\"; appended it`\n        );\n      }\n    }\n\n    return { groups };\n  };\n\n  const resolveSection = (\n    section: Modules.ContentStructure.ContentStructureSection\n  ): Modules.ContentStructure.ResolvedGroupNode[] => {\n    const byId = new Map(section.groups.map((group) => [group.id, group]));\n\n    const toNode = (\n      group: Modules.ContentStructure.ContentStructureGroup\n    ): Modules.ContentStructure.ResolvedGroupNode => {\n      const cleanedChildren = group.children.map(\n        (entry): Modules.ContentStructure.ResolvedStructureChild => {\n          if (entry.type === 'contentType') {\n            return { type: 'contentType', uid: entry.uid };\n          }\n\n          return toNode(byId.get(entry.id)!);\n        }\n      );\n\n      return {\n        children: cleanedChildren,\n        name: group.name,\n        type: 'group',\n        id: group.id,\n      };\n    };\n\n    return section.groups.filter((group) => group.parent === null).map(toNode);\n  };\n\n  async function read(): Promise<Modules.ContentStructure.ContentStructureFile | null> {\n    const filePath = join(strapi.dirs.dist.contentStructure, CONTENT_STRUCTURE_FILE_NAME);\n\n    if (!(await fse.pathExists(filePath))) {\n      return null;\n    }\n\n    let parsed: unknown;\n    try {\n      parsed = await fse.readJSON(filePath);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n\n      strapi.log.error(\n        `[content-structure] Could not parse ${filePath} (${message}); continuing without content-type folders`\n      );\n\n      return null;\n    }\n\n    if (!isRecord(parsed) || !isRecord(parsed.sections)) {\n      strapi.log.error(\n        `[content-structure] ${filePath} is not an object with a \"sections\" property; continuing without content-type folders`\n      );\n      return null;\n    }\n\n    if (parsed.version !== 1) {\n      strapi.log.error(\n        `[content-structure] Unknown version \"${parsed.version}\" in ${filePath} (expected 1); continuing without content-type folders`\n      );\n      return null;\n    }\n\n    return parsed as unknown as Modules.ContentStructure.ContentStructureFile;\n  }\n\n  const load = () => {\n    if (!cache) {\n      cache = (async () => {\n        const file = await read();\n\n        if (!file) {\n          return { cleaned: null, resolved: { collectionTypes: [], singleTypes: [] } };\n        }\n\n        const cleaned: Modules.ContentStructure.ContentStructureFile = {\n          version: 1,\n          sections: {\n            collectionTypes: cleanSection(file.sections.collectionTypes, 'collectionTypes'),\n            singleTypes: cleanSection(file.sections.singleTypes, 'singleTypes'),\n          },\n        };\n\n        return {\n          cleaned,\n          resolved: {\n            collectionTypes: resolveSection(cleaned.sections.collectionTypes),\n            singleTypes: resolveSection(cleaned.sections.singleTypes),\n          },\n        };\n      })();\n    }\n\n    return cache;\n  };\n\n  function invalidate() {\n    cache = undefined;\n  }\n\n  async function getCleanedFile() {\n    return (await load()).cleaned;\n  }\n\n  async function resolve() {\n    return (await load()).resolved;\n  }\n\n  async function write(structure: Modules.ContentStructure.ContentStructureFile) {\n    const dir = strapi.dirs.app.contentStructure;\n\n    await fse.ensureDir(dir);\n    await fse.writeJSON(join(dir, CONTENT_STRUCTURE_FILE_NAME), structure, { spaces: 2 });\n\n    invalidate();\n  }\n\n  function validate(value: unknown): Modules.ContentStructure.ContentStructureFile {\n    return contentStructureFileSchema.parse(value) as Modules.ContentStructure.ContentStructureFile;\n  }\n\n  async function countGroups() {\n    const { cleaned } = await load();\n\n    if (!cleaned) {\n      return 0;\n    }\n\n    const collectionTypesCount = cleaned.sections.collectionTypes.groups.length;\n    const singleTypesCount = cleaned.sections.singleTypes.groups.length;\n\n    return collectionTypesCount + singleTypesCount;\n  }\n\n  return {\n    getCleanedFile,\n    countGroups,\n    invalidate,\n    validate,\n    resolve,\n    write,\n    read,\n  };\n}\n"],"names":["CONTENT_STRUCTURE_FILE_NAME","MAX_FOLDER_DEPTH","isRecord","value","Array","isArray","createContentStructureService","strapi","cache","warn","message","log","cleanSection","rawSection","sectionKey","rawGroups","undefined","groups","seenGroupIds","Map","raw","isGroupExpressionValid","name","trim","id","has","group","children","parent","set","push","reparentToRoot","reason","splice","indexOf","chain","Set","current","add","get","depth","expectedKind","seenGroupChildren","seenUids","cleanedChildren","entry","type","uid","schema","contentTypes","kind","target","resolveSection","section","byId","map","toNode","filter","read","filePath","join","dirs","dist","contentStructure","fse","pathExists","parsed","readJSON","error","Error","String","sections","version","load","file","cleaned","resolved","collectionTypes","singleTypes","invalidate","getCleanedFile","resolve","write","structure","dir","app","ensureDir","writeJSON","spaces","validate","contentStructureFileSchema","parse","countGroups","collectionTypesCount","length","singleTypesCount"],"mappings":"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"}

package/dist/services/content-structure/index.mjs

@@ -0,0 +1,296 @@
+import { join } from 'path';
+import fse from 'fs-extra';
+import { isGroupExpressionValid } from './utils/isGroupExpressionValid.mjs';
+import { contentStructureFileSchema } from './validation.mjs';
+
+const CONTENT_STRUCTURE_FILE_NAME = 'groups.json';
+const MAX_FOLDER_DEPTH = 3;
+const isRecord = (value)=>{
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+};
+function createContentStructureService(strapi) {
+    /**
+   * This cache exists to ensure all consumers recieve the same cleaned+resolved data, regardless of call order / invocation relative to the strapi reload.
+   */ let cache;
+    const warn = (message)=>{
+        strapi.log.warn(`[content-structure] ${message}`);
+    };
+    const cleanSection = (rawSection, sectionKey)=>{
+        const rawGroups = (()=>{
+            if (rawSection === undefined || rawSection === null) {
+                return [];
+            }
+            if (!isRecord(rawSection) || !Array.isArray(rawSection.groups)) {
+                warn(`Section "${sectionKey}" is malformed; ignoring it`);
+                return [];
+            }
+            return rawSection.groups;
+        })();
+        const seenGroupIds = new Map();
+        const groups = [];
+        for (const raw of rawGroups){
+            if (!isGroupExpressionValid(raw)) {
+                warn(`Dropping a malformed group entry in section "${sectionKey}"`);
+                continue;
+            }
+            if (raw.name.trim() === '') {
+                warn(`Dropping group "${raw.id}" in section "${sectionKey}": empty name`);
+                continue;
+            }
+            if (seenGroupIds.has(raw.id)) {
+                warn(`Dropping duplicate group id "${raw.id}" in section "${sectionKey}"`);
+                continue;
+            }
+            const group = {
+                children: raw.children,
+                parent: raw.parent,
+                name: raw.name,
+                id: raw.id
+            };
+            seenGroupIds.set(group.id, group);
+            groups.push(group);
+        }
+        const reparentToRoot = (group, reason)=>{
+            group.parent = null;
+            groups.splice(groups.indexOf(group), 1);
+            groups.push(group);
+            warn(`Reparenting group "${group.id}" in section "${sectionKey}" to root: ${reason}`);
+        };
+        // oxlint-disable-next-line - Duplicating is necessary because the original array is mutated inside the iterator.
+        for (const group of [
+            ...groups
+        ]){
+            if (group.parent !== null && !seenGroupIds.has(group.parent)) {
+                reparentToRoot(group, `parent "${group.parent}" does not exist`);
+            }
+        }
+        // oxlint-disable-next-line - Duplicating is necessary because the original array is mutated inside the iterator.
+        for (const group of [
+            ...groups
+        ]){
+            const chain = new Set([
+                group.id
+            ]);
+            let current = group;
+            while(current.parent !== null){
+                if (chain.has(current.parent)) {
+                    reparentToRoot(group, 'its parent chain contains a cycle');
+                    break;
+                }
+                chain.add(current.parent);
+                current = seenGroupIds.get(current.parent);
+            }
+        }
+        // oxlint-disable-next-line - Duplicating is necessary because the original array is mutated inside the iterator.
+        for (const group of [
+            ...groups
+        ]){
+            let current = group;
+            let depth = 1;
+            while(current.parent !== null){
+                current = seenGroupIds.get(current.parent);
+                depth += 1;
+            }
+            if (depth > MAX_FOLDER_DEPTH) {
+                reparentToRoot(group, `it exceeds the maximum nesting depth of ${MAX_FOLDER_DEPTH}`);
+            }
+        }
+        const expectedKind = sectionKey === 'collectionTypes' ? 'collectionType' : 'singleType';
+        const seenGroupChildren = new Set();
+        const seenUids = new Set();
+        for (const group of groups){
+            const cleanedChildren = [];
+            for (const entry of group.children){
+                if (!isRecord(entry)) {
+                    warn(`Dropping a malformed child entry of group "${group.id}"`);
+                    continue;
+                }
+                if (entry.type === 'contentType') {
+                    const { uid } = entry;
+                    if (typeof uid !== 'string') {
+                        warn(`Dropping a contentType child of group "${group.id}": invalid uid`);
+                        continue;
+                    }
+                    const schema = strapi.contentTypes[uid];
+                    if (!schema) {
+                        warn(`Dropping unknown content type "${uid}" from group "${group.id}"`);
+                        continue;
+                    }
+                    // kind is optional on schemas; absent means collectionType.
+                    const kind = schema.kind ?? 'collectionType';
+                    if (kind !== expectedKind) {
+                        warn(`Dropping content type "${uid}" from group "${group.id}": its kind "${kind}" does not belong in section "${sectionKey}"`);
+                        continue;
+                    }
+                    if (seenUids.has(uid)) {
+                        warn(`Dropping duplicate reference to content type "${uid}" from group "${group.id}"`);
+                        continue;
+                    }
+                    cleanedChildren.push({
+                        type: 'contentType',
+                        uid: uid
+                    });
+                    seenUids.add(uid);
+                    continue;
+                }
+                if (entry.type === 'group') {
+                    const { id } = entry;
+                    if (typeof id !== 'string') {
+                        warn(`Dropping a group child of group "${group.id}": invalid id`);
+                        continue;
+                    }
+                    const target = seenGroupIds.get(id);
+                    if (!target || target.parent !== group.id) {
+                        warn(`Dropping group child "${id}" from group "${group.id}": inconsistent reference`);
+                        continue;
+                    }
+                    if (seenGroupChildren.has(id)) {
+                        warn(`Dropping duplicate group child "${id}" from group "${group.id}"`);
+                        continue;
+                    }
+                    cleanedChildren.push({
+                        type: 'group',
+                        id
+                    });
+                    seenGroupChildren.add(id);
+                    continue;
+                }
+                warn(`Dropping a child entry of group "${group.id}" with an unknown type`);
+            }
+            group.children = cleanedChildren;
+        }
+        for (const group of groups){
+            if (group.parent !== null && !seenGroupChildren.has(group.id)) {
+                const parent = seenGroupIds.get(group.parent);
+                parent.children.push({
+                    type: 'group',
+                    id: group.id
+                });
+                seenGroupChildren.add(group.id);
+                warn(`Group "${group.id}" was missing from the children of its parent "${parent.id}"; appended it`);
+            }
+        }
+        return {
+            groups
+        };
+    };
+    const resolveSection = (section)=>{
+        const byId = new Map(section.groups.map((group)=>[
+                group.id,
+                group
+            ]));
+        const toNode = (group)=>{
+            const cleanedChildren = group.children.map((entry)=>{
+                if (entry.type === 'contentType') {
+                    return {
+                        type: 'contentType',
+                        uid: entry.uid
+                    };
+                }
+                return toNode(byId.get(entry.id));
+            });
+            return {
+                children: cleanedChildren,
+                name: group.name,
+                type: 'group',
+                id: group.id
+            };
+        };
+        return section.groups.filter((group)=>group.parent === null).map(toNode);
+    };
+    async function read() {
+        const filePath = join(strapi.dirs.dist.contentStructure, CONTENT_STRUCTURE_FILE_NAME);
+        if (!await fse.pathExists(filePath)) {
+            return null;
+        }
+        let parsed;
+        try {
+            parsed = await fse.readJSON(filePath);
+        } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            strapi.log.error(`[content-structure] Could not parse ${filePath} (${message}); continuing without content-type folders`);
+            return null;
+        }
+        if (!isRecord(parsed) || !isRecord(parsed.sections)) {
+            strapi.log.error(`[content-structure] ${filePath} is not an object with a "sections" property; continuing without content-type folders`);
+            return null;
+        }
+        if (parsed.version !== 1) {
+            strapi.log.error(`[content-structure] Unknown version "${parsed.version}" in ${filePath} (expected 1); continuing without content-type folders`);
+            return null;
+        }
+        return parsed;
+    }
+    const load = ()=>{
+        if (!cache) {
+            cache = (async ()=>{
+                const file = await read();
+                if (!file) {
+                    return {
+                        cleaned: null,
+                        resolved: {
+                            collectionTypes: [],
+                            singleTypes: []
+                        }
+                    };
+                }
+                const cleaned = {
+                    version: 1,
+                    sections: {
+                        collectionTypes: cleanSection(file.sections.collectionTypes, 'collectionTypes'),
+                        singleTypes: cleanSection(file.sections.singleTypes, 'singleTypes')
+                    }
+                };
+                return {
+                    cleaned,
+                    resolved: {
+                        collectionTypes: resolveSection(cleaned.sections.collectionTypes),
+                        singleTypes: resolveSection(cleaned.sections.singleTypes)
+                    }
+                };
+            })();
+        }
+        return cache;
+    };
+    function invalidate() {
+        cache = undefined;
+    }
+    async function getCleanedFile() {
+        return (await load()).cleaned;
+    }
+    async function resolve() {
+        return (await load()).resolved;
+    }
+    async function write(structure) {
+        const dir = strapi.dirs.app.contentStructure;
+        await fse.ensureDir(dir);
+        await fse.writeJSON(join(dir, CONTENT_STRUCTURE_FILE_NAME), structure, {
+            spaces: 2
+        });
+        invalidate();
+    }
+    function validate(value) {
+        return contentStructureFileSchema.parse(value);
+    }
+    async function countGroups() {
+        const { cleaned } = await load();
+        if (!cleaned) {
+            return 0;
+        }
+        const collectionTypesCount = cleaned.sections.collectionTypes.groups.length;
+        const singleTypesCount = cleaned.sections.singleTypes.groups.length;
+        return collectionTypesCount + singleTypesCount;
+    }
+    return {
+        getCleanedFile,
+        countGroups,
+        invalidate,
+        validate,
+        resolve,
+        write,
+        read
+    };
+}
+
+export { CONTENT_STRUCTURE_FILE_NAME, MAX_FOLDER_DEPTH, createContentStructureService };
+//# sourceMappingURL=index.mjs.map