nextjs-cms 0.5.9 → 0.5.10

package/dist/core/factories/SectionFactory.js

@@ -1,415 +1,415 @@
-import { glob } from 'glob';
-import { cloneDeep } from 'lodash-es';
-import { resolve } from 'path';
-import chalk from 'chalk';
-import { eq } from 'drizzle-orm';
-import chokidar from 'chokidar';
-import fs from 'fs';
-import { db } from "../../db/client.js";
-import { AdminPrivilegesTable } from "../../db/schema.js";
-import { getCMSConfig } from "../config.js";
-const cmsConfig = getCMSConfig();
-const hotMarkerFile = resolve(process.cwd(), 'next-cms-sectioninfo.ts');
-const safeRequire = (id) => {
-    const req = eval('require');
-    return req(id);
-};
-/**
- * Register esbuild-register only once per process.
- * Node's require cache ensures each TS module is evaluated once.
- */
-let tsLoaderRegistered = false;
-/**
- * Require a TypeScript module at runtime.
- * @param absPath - The absolute path to the section file.
- * @returns The default export of the section file.
- */
-const requireModuleRuntime = (absPath) => {
-    const isTs = absPath.endsWith('.ts') || absPath.endsWith('.cts') || absPath.endsWith('.mts');
-    if (isTs && !tsLoaderRegistered) {
-        try {
-            const { register } = safeRequire('esbuild-register/dist/node');
-            register({ format: 'cjs', loader: 'ts' });
-            tsLoaderRegistered = true;
-        }
-        catch {
-            throw new Error(`Cannot load section file '${absPath}' (TypeScript). Install 'esbuild-register' in nextjs-cms/cms or provide JS files.`);
-        }
-    }
-    const mod = safeRequire(absPath);
-    // Only return the default export, ignore named exports
-    return mod?.default;
-};
-/**
- * Log a message to the console if debug mode is enabled
- * @param args - The arguments to log
- * @returns void
- */
-const log = (...args) => {
-    if (!cmsConfig.debug)
-        return;
-    console.log(chalk.black.bgGreen(`[${new Date().toISOString()}][next-cms-debug]`, ...args));
-};
-export class SectionFactory {
-    /**
-     * These are the fixed sections that can not be present in the sections folder.
-     */
-    static fixedSections = ['admins', 'analytics', 'emails', 'dashboard'];
-    static isDev = process.env.NODE_ENV !== 'production';
-    static isProd = !this.isDev;
-    static sectionProcessingErrors = {};
-    static sectionFetchingErrors = {};
-    static errorCount = 0;
-    /**
-     * Global in-process cache for all section configs.
-     * Populated once per Node process via loadAllSections(),
-     * reused by all get*() calls until the process is restarted,
-     * so all subsequent calls reuse this array.
-     */
-    static allSectionsPromise = null;
-    static allSectionsLoaded = false;
-    static watcherStarted = false;
-    static bumpHotMarker() {
-        if (!SectionFactory.isDev)
-            return;
-        const content = `/**\n` +
-            ` * AUTO-GENERATED. DO NOT EDIT.\n` +
-            ` * This file is used to track the last time the sections schema was updated.\n` +
-            ` * It is used to trigger a hot reload of the section schema in development mode.\n` +
-            ` */\n` +
-            `\n` +
-            `export const revalidate = 0\n` +
-            `\n` +
-            `// @refresh reset\n` +
-            `\n` +
-            `export const sectionSchemaLastUpdated = ${Date.now()}\n`;
-        try {
-            fs.writeFileSync(hotMarkerFile, content, 'utf8');
-            log('Bumped next-cms-sectioninfo.ts to trigger Next Fast Refresh');
-        }
-        catch (err) {
-            console.error('Failed to bump next-cms-sectioninfo.ts:', err);
-        }
-    }
-    // ---------- PUBLIC API ----------
-    /**
-     * Get all sections
-     * @param type - The type of sections to get
-     * @returns The sections
-     */
-    static async getSections(type) {
-        return await this.get({ type });
-    }
-    /**
-     * Get all accessible sections for an admin
-     * @param type - The type of section to get
-     * @param admin - The admin to get the sections for
-     * @returns The sections for the admin
-     */
-    static async getSectionsForAdmin({ type, admin, }) {
-        const sections = await this.get({ type, admin });
-        const privileges = await db
-            .select({
-            sectionName: AdminPrivilegesTable.sectionName,
-            operations: AdminPrivilegesTable.operations,
-        })
-            .from(AdminPrivilegesTable)
-            .where(eq(AdminPrivilegesTable.adminId, admin.id));
-        const fixedSections = privileges
-            .filter((privilege) => this.fixedSections.includes(privilege.sectionName))
-            .map((privilege) => privilege.sectionName);
-        const simpleSections = sections.filter((section) => section.type === 'simple');
-        const hasItemsSections = sections.filter((section) => section.type === 'has_items');
-        const categorySections = sections.filter((section) => section.type === 'category');
-        return {
-            simple: simpleSections,
-            has_items: hasItemsSections,
-            category: categorySections,
-            fixed: fixedSections,
-        };
-    }
-    /**
-     * Get a section
-     * @param name - The name of the section to get
-     * @param type - The type of section to get
-     * @returns The section
-     */
-    static async getSection({ name, type, }) {
-        const section = await this.get({ name, type });
-        return section[0] ? section[0] : null;
-    }
-    /**
-     * Get an accessible section for an admin
-     * @param name - The name of the section to get
-     * @param type - The type of section to get
-     * @param admin - The admin to get the section for
-     * @returns The section for the admin
-     */
-    static async getSectionForAdmin({ name, type, admin, }) {
-        const section = await this.get({ type, admin, name });
-        return section[0] ? section[0] : null;
-    }
-    /**
-     * Create a Section instance from a section config
-     * The config must have a build() method (created via helper functions like simpleSection(), hasItemsSection(), etc.)
-     *
-     * Note: This factory only accepts configs. If you already have a Section instance,
-     * use it directly - don't pass it to this factory.
-     *
-     * @param config - A section config object with a build() method
-     * @returns A Section instance
-     * @throws Error if config doesn't have a build() method
-     */
-    static create(config) {
-        if (typeof config.build === 'function') {
-            return config.build();
-        }
-        throw new Error('Section config must have a build() method. Use helper functions like simpleSection(), hasItemsSection(), categorySection() to create configs.');
-    }
-    // ---------- INTERNAL CORE ----------
-    /**
-     * Return a clone of the section(s) info to get a fresh copy of the section(s).
-     * Not cloning will cause the original section(s) (in *.section.ts file) to be modified!
-     * Each *.section.ts file must have exactly one default export (arrays are not allowed).
-
-     * @param name - The name of the section to get
-     * @param type - The type of section to get
-     * @param admin - The admin to get the section for
-     * @returns The section(s)
-     */
-    static async get({ name, type, admin, }) {
-        try {
-            const allSections = await this.loadAllSections();
-            /**
-             * Always show errors if there are any.
-             * This is to make sure the errors are shown on every request (technically, every time the section is requested).
-             * This way devs can notice the errors and fix them.
-             */
-            if (this.errorCount > 0) {
-                console.log(`\n${chalk.bgRed.bold(` Errors while fetching sections `)}${chalk.red.bold('-------')}\n`);
-                if (Object.keys(this.sectionProcessingErrors).length > 0) {
-                    console.log(`${chalk.bold.redBright(`Processing errors:`)}`);
-                    for (const [file, errors] of Object.entries(this.sectionProcessingErrors)) {
-                        console.log('');
-                        console.log(chalk.bold(`[${file}]:`));
-                        for (const error of errors) {
-                            console.error(error);
-                        }
-                        console.log('');
-                    }
-                }
-                if (Object.keys(this.sectionFetchingErrors).length > 0) {
-                    console.log(`\n${chalk.bold.redBright(`Importing errors:`)}`);
-                    for (const [file, errors] of Object.entries(this.sectionFetchingErrors)) {
-                        console.log('');
-                        console.log(chalk.bold(`[${file}]:`));
-                        for (const error of errors) {
-                            console.error(error);
-                        }
-                        console.log('');
-                    }
-                }
-                console.log(`${chalk.red.bold('-------')}`);
-            }
-            const types = type
-                ? Array.isArray(type)
-                    ? type
-                    : [type]
-                : ['has_items', 'simple', 'category'];
-            // Filter by type first
-            let filtered = allSections.filter((section) => types.includes(section.type));
-            // If admin is provided, restrict to privileged sections
-            if (admin && admin.id) {
-                const privileges = await db
-                    .select({
-                    sectionName: AdminPrivilegesTable.sectionName,
-                    operations: AdminPrivilegesTable.operations,
-                })
-                    .from(AdminPrivilegesTable)
-                    .where(eq(AdminPrivilegesTable.adminId, admin.id));
-                const privilegedSections = [];
-                privileges.forEach((privilege) => {
-                    if (admin.requiredRole) {
-                        if (privilege.operations.includes(admin.requiredRole)) {
-                            privilegedSections.push(privilege.sectionName);
-                        }
-                    }
-                    else {
-                        privilegedSections.push(privilege.sectionName);
-                    }
-                });
-                filtered = filtered.filter((section) => privilegedSections.includes(section.name));
-            }
-            if (name) {
-                const found = filtered.find((section) => section.name === name);
-                return found ? [cloneDeep(found)] : [];
-            }
-            return filtered.map((section) => cloneDeep(section));
-        }
-        catch (err) {
-            console.error('Error loading section configs:', err);
-            return [];
-        }
-    }
-    /**
-     * Load all *.section.ts files once, require their default exports,
-     * and cache the resulting configs for the lifetime of the process
-     * (until invalidated in dev by file changes).
-     */
-    static async loadAllSections() {
-        if (this.allSectionsPromise)
-            return this.allSectionsPromise;
-        if (this.isDev) {
-            // In dev, watch for changes and reload on demand
-            // This wll lazy load on first get() as well
-            this.startWatcher();
-        }
-        this.allSectionsPromise = (async () => {
-            if (!this.allSectionsLoaded) {
-                log('Loading all sections from disk...', this.isDev ? '(dev mode)' : '(production mode)');
-            }
-            const sections = [];
-            try {
-                const sectionFiles = await glob('**/*.section.ts', {
-                    cwd: cmsConfig.sectionsFolder,
-                });
-                for (const file of sectionFiles) {
-                    try {
-                        const absPath = resolve(cmsConfig.sectionsFolder, file);
-                        const defaultExport = requireModuleRuntime(absPath);
-                        if (!defaultExport) {
-                            if (!this.sectionFetchingErrors[file]) {
-                                this.sectionFetchingErrors[file] = [];
-                            }
-                            this.sectionFetchingErrors[file].push(chalk.rgb(255, 100, 0)('Section file must have a default export. Skipping.'));
-                            this.errorCount++;
-                            continue;
-                        }
-                        if (Array.isArray(defaultExport)) {
-                            if (!this.sectionFetchingErrors[file]) {
-                                this.sectionFetchingErrors[file] = [];
-                            }
-                            this.sectionFetchingErrors[file].push(chalk.rgb(255, 100, 0)('Section file exports an array. Each file must export exactly one section. Skipping.'));
-                            this.errorCount++;
-                            continue;
-                        }
-                        if (!defaultExport.type || !defaultExport.name) {
-                            if (!this.sectionFetchingErrors[file]) {
-                                this.sectionFetchingErrors[file] = [];
-                            }
-                            this.sectionFetchingErrors[file].push(chalk.rgb(255, 100, 0)('Section file default export must have "type" and "name". Skipping.'));
-                            this.errorCount++;
-                            continue;
-                        }
-                        sections.push(defaultExport);
-                    }
-                    catch (importErr) {
-                        if (importErr instanceof Error) {
-                            /**
-                             * Only display the error message, not the stack trace.
-                             */
-                            if (!this.sectionProcessingErrors[file]) {
-                                this.sectionProcessingErrors[file] = [];
-                            }
-                            this.sectionProcessingErrors[file].push(importErr.message);
-                        }
-                        else {
-                            if (!this.sectionFetchingErrors[file]) {
-                                this.sectionFetchingErrors[file] = [];
-                            }
-                            this.sectionFetchingErrors[file].push(chalk.rgb(255, 100, 0)(`Unknown error type: ${typeof importErr}`));
-                            throw new Error(`${chalk.bgRed(` Error importing ${file}: `)}, ${importErr}`);
-                        }
-                        this.errorCount++;
-                        /**
-                         * Remove the section from the cache so it will be reloaded next time.
-                         */
-                        delete require.cache[resolve(cmsConfig.sectionsFolder, file)];
-                    }
-                }
-            }
-            catch (err) {
-                console.error('Error finding section files:', err);
-            }
-            this.allSectionsLoaded = true;
-            /**
-             * If `strict` mode is enabled,
-             * don't return sections if there are errors.
-             */
-            if (cmsConfig.strict && this.errorCount > 0) {
-                return [];
-            }
-            log(`Loaded ${sections.length} section(s)`);
-            return sections;
-        })();
-        return this.allSectionsPromise;
-    }
-    // ---------- DEV WATCHER & CACHE INVALIDATION ----------
-    static startWatcher() {
-        if (!this.isDev || this.watcherStarted)
-            return;
-        this.watcherStarted = true;
-        const watcher = chokidar.watch('**/*.section.ts', {
-            cwd: cmsConfig.sectionsFolder,
-            ignoreInitial: true,
-        });
-        log('Starting section watcher in dev mode...');
-        /**
-         * This is triggering nextjs to reload the section module when a section file is changed.
-         * We used [refresh-reset](https://nextjs.org/docs/architecture/fast-refresh#:~:text=you%20can%20add-,//%20%40refresh%20reset,-anywhere%20in%20the) to let fast-refresh
-         * trigger a react-query invalidation in the form component to re-fetch the new section config.
-         * @param relPath
-         */
-        const invalidateForRelPath = (relPath) => {
-            const absPath = resolve(cmsConfig.sectionsFolder, relPath);
-            const req = eval('require');
-            try {
-                const resolved = req.resolve(absPath);
-                if (req.cache[resolved]) {
-                    delete req.cache[resolved];
-                    log('Cleared require cache for', relPath);
-                }
-                // Also clear the require cache for the hot marker file
-                if (req.cache[hotMarkerFile]) {
-                    delete req.cache[hotMarkerFile];
-                    log('Cleared require cache for', hotMarkerFile);
-                }
-                this.sectionProcessingErrors = {};
-                this.sectionFetchingErrors = {};
-                this.errorCount = 0;
-            }
-            catch {
-                // ignore if not resolvable
-            }
-            this.allSectionsPromise = null;
-            this.allSectionsLoaded = false;
-            log('Invalidated section cache due to change in', relPath);
-            this.bumpHotMarker();
-        };
-        watcher
-            .on('add', (path) => {
-            log('Section file added:', path);
-            invalidateForRelPath(path);
-        })
-            .on('change', (path) => {
-            log('Section file changed:', path);
-            invalidateForRelPath(path);
-        })
-            .on('unlink', (path) => {
-            log('Section file removed:', path);
-            invalidateForRelPath(path);
-        });
-    }
-    static init() {
-        if (this.isProd) {
-            // Preload all sections at startup in production
-            void this.loadAllSections();
-        }
-    }
-    /**
-     * Run initialization once when the module is loaded
-     */
-    static {
-        this.init();
-    }
-}
+import { glob } from 'glob';
+import { cloneDeep } from 'lodash-es';
+import { resolve } from 'path';
+import chalk from 'chalk';
+import { eq } from 'drizzle-orm';
+import chokidar from 'chokidar';
+import fs from 'fs';
+import { db } from '../../db/client.js';
+import { AdminPrivilegesTable } from '../../db/schema.js';
+import { getCMSConfig } from '../config/index.js';
+const cmsConfig = getCMSConfig();
+const hotMarkerFile = resolve(process.cwd(), 'next-cms-sectioninfo.js');
+const safeRequire = (id) => {
+    const req = eval('require');
+    return req(id);
+};
+/**
+ * Register esbuild-register only once per process.
+ * Node's require cache ensures each TS module is evaluated once.
+ */
+let tsLoaderRegistered = false;
+/**
+ * Require a TypeScript module at runtime.
+ * @param absPath - The absolute path to the section file.
+ * @returns The default export of the section file.
+ */
+const requireModuleRuntime = (absPath) => {
+    const isTs = absPath.endsWith('.js') || absPath.endsWith('.cts') || absPath.endsWith('.mts');
+    if (isTs && !tsLoaderRegistered) {
+        try {
+            const { register } = safeRequire('esbuild-register/dist/node');
+            register({ format: 'cjs', loader: 'ts' });
+            tsLoaderRegistered = true;
+        }
+        catch {
+            throw new Error(`Cannot load section file '${absPath}' (TypeScript). Install 'esbuild-register' in nextjs-cms/cms or provide JS files.`);
+        }
+    }
+    const mod = safeRequire(absPath);
+    // Only return the default export, ignore named exports
+    return mod?.default;
+};
+/**
+ * Log a message to the console if debug mode is enabled
+ * @param args - The arguments to log
+ * @returns void
+ */
+const log = (...args) => {
+    if (!cmsConfig.debug)
+        return;
+    console.log(chalk.black.bgGreen(`[${new Date().toISOString()}][next-cms-debug]`, ...args));
+};
+export class SectionFactory {
+    /**
+     * These are the fixed sections that can not be present in the sections folder.
+     */
+    static fixedSections = ['admins', 'analytics', 'emails', 'dashboard'];
+    static isDev = process.env.NODE_ENV !== 'production';
+    static isProd = !this.isDev;
+    static sectionProcessingErrors = {};
+    static sectionFetchingErrors = {};
+    static errorCount = 0;
+    /**
+     * Global in-process cache for all section configs.
+     * Populated once per Node process via loadAllSections(),
+     * reused by all get*() calls until the process is restarted,
+     * so all subsequent calls reuse this array.
+     */
+    static allSectionsPromise = null;
+    static allSectionsLoaded = false;
+    static watcherStarted = false;
+    static bumpHotMarker() {
+        if (!SectionFactory.isDev)
+            return;
+        const content = `/**\n` +
+            ` * AUTO-GENERATED. DO NOT EDIT.\n` +
+            ` * This file is used to track the last time the sections schema was updated.\n` +
+            ` * It is used to trigger a hot reload of the section schema in development mode.\n` +
+            ` */\n` +
+            `\n` +
+            `export const revalidate = 0\n` +
+            `\n` +
+            `// @refresh reset\n` +
+            `\n` +
+            `export const sectionSchemaLastUpdated = ${Date.now()}\n`;
+        try {
+            fs.writeFileSync(hotMarkerFile, content, 'utf8');
+            log('Bumped next-cms-sectioninfo.ts to trigger Next Fast Refresh');
+        }
+        catch (err) {
+            console.error('Failed to bump next-cms-sectioninfo.ts:', err);
+        }
+    }
+    // ---------- PUBLIC API ----------
+    /**
+     * Get all sections
+     * @param type - The type of sections to get
+     * @returns The sections
+     */
+    static async getSections(type) {
+        return await this.get({ type });
+    }
+    /**
+     * Get all accessible sections for an admin
+     * @param type - The type of section to get
+     * @param admin - The admin to get the sections for
+     * @returns The sections for the admin
+     */
+    static async getSectionsForAdmin({ type, admin, }) {
+        const sections = await this.get({ type, admin });
+        const privileges = await db
+            .select({
+            sectionName: AdminPrivilegesTable.sectionName,
+            operations: AdminPrivilegesTable.operations,
+        })
+            .from(AdminPrivilegesTable)
+            .where(eq(AdminPrivilegesTable.adminId, admin.id));
+        const fixedSections = privileges
+            .filter((privilege) => this.fixedSections.includes(privilege.sectionName))
+            .map((privilege) => privilege.sectionName);
+        const simpleSections = sections.filter((section) => section.type === 'simple');
+        const hasItemsSections = sections.filter((section) => section.type === 'has_items');
+        const categorySections = sections.filter((section) => section.type === 'category');
+        return {
+            simple: simpleSections,
+            has_items: hasItemsSections,
+            category: categorySections,
+            fixed: fixedSections,
+        };
+    }
+    /**
+     * Get a section
+     * @param name - The name of the section to get
+     * @param type - The type of section to get
+     * @returns The section
+     */
+    static async getSection({ name, type, }) {
+        const section = await this.get({ name, type });
+        return section[0] ? section[0] : null;
+    }
+    /**
+     * Get an accessible section for an admin
+     * @param name - The name of the section to get
+     * @param type - The type of section to get
+     * @param admin - The admin to get the section for
+     * @returns The section for the admin
+     */
+    static async getSectionForAdmin({ name, type, admin, }) {
+        const section = await this.get({ type, admin, name });
+        return section[0] ? section[0] : null;
+    }
+    /**
+     * Create a Section instance from a section config
+     * The config must have a build() method (created via helper functions like simpleSection(), hasItemsSection(), etc.)
+     *
+     * Note: This factory only accepts configs. If you already have a Section instance,
+     * use it directly - don't pass it to this factory.
+     *
+     * @param config - A section config object with a build() method
+     * @returns A Section instance
+     * @throws Error if config doesn't have a build() method
+     */
+    static create(config) {
+        if (typeof config.build === 'function') {
+            return config.build();
+        }
+        throw new Error('Section config must have a build() method. Use helper functions like simpleSection(), hasItemsSection(), categorySection() to create configs.');
+    }
+    // ---------- INTERNAL CORE ----------
+    /**
+     * Return a clone of the section(s) info to get a fresh copy of the section(s).
+     * Not cloning will cause the original section(s) (in *.section.ts file) to be modified!
+     * Each *.section.ts file must have exactly one default export (arrays are not allowed).
+
+     * @param name - The name of the section to get
+     * @param type - The type of section to get
+     * @param admin - The admin to get the section for
+     * @returns The section(s)
+     */
+    static async get({ name, type, admin, }) {
+        try {
+            const allSections = await this.loadAllSections();
+            /**
+             * Always show errors if there are any.
+             * This is to make sure the errors are shown on every request (technically, every time the section is requested).
+             * This way devs can notice the errors and fix them.
+             */
+            if (this.errorCount > 0) {
+                console.log(`\n${chalk.bgRed.bold(` Errors while fetching sections `)}${chalk.red.bold('-------')}\n`);
+                if (Object.keys(this.sectionProcessingErrors).length > 0) {
+                    console.log(`${chalk.bold.redBright(`Processing errors:`)}`);
+                    for (const [file, errors] of Object.entries(this.sectionProcessingErrors)) {
+                        console.log('');
+                        console.log(chalk.bold(`[${file}]:`));
+                        for (const error of errors) {
+                            console.error(error);
+                        }
+                        console.log('');
+                    }
+                }
+                if (Object.keys(this.sectionFetchingErrors).length > 0) {
+                    console.log(`\n${chalk.bold.redBright(`Importing errors:`)}`);
+                    for (const [file, errors] of Object.entries(this.sectionFetchingErrors)) {
+                        console.log('');
+                        console.log(chalk.bold(`[${file}]:`));
+                        for (const error of errors) {
+                            console.error(error);
+                        }
+                        console.log('');
+                    }
+                }
+                console.log(`${chalk.red.bold('-------')}`);
+            }
+            const types = type
+                ? Array.isArray(type)
+                    ? type
+                    : [type]
+                : ['has_items', 'simple', 'category'];
+            // Filter by type first
+            let filtered = allSections.filter((section) => types.includes(section.type));
+            // If admin is provided, restrict to privileged sections
+            if (admin && admin.id) {
+                const privileges = await db
+                    .select({
+                    sectionName: AdminPrivilegesTable.sectionName,
+                    operations: AdminPrivilegesTable.operations,
+                })
+                    .from(AdminPrivilegesTable)
+                    .where(eq(AdminPrivilegesTable.adminId, admin.id));
+                const privilegedSections = [];
+                privileges.forEach((privilege) => {
+                    if (admin.requiredRole) {
+                        if (privilege.operations.includes(admin.requiredRole)) {
+                            privilegedSections.push(privilege.sectionName);
+                        }
+                    }
+                    else {
+                        privilegedSections.push(privilege.sectionName);
+                    }
+                });
+                filtered = filtered.filter((section) => privilegedSections.includes(section.name));
+            }
+            if (name) {
+                const found = filtered.find((section) => section.name === name);
+                return found ? [cloneDeep(found)] : [];
+            }
+            return filtered.map((section) => cloneDeep(section));
+        }
+        catch (err) {
+            console.error('Error loading section configs:', err);
+            return [];
+        }
+    }
+    /**
+     * Load all *.section.ts files once, require their default exports,
+     * and cache the resulting configs for the lifetime of the process
+     * (until invalidated in dev by file changes).
+     */
+    static async loadAllSections() {
+        if (this.allSectionsPromise)
+            return this.allSectionsPromise;
+        if (this.isDev) {
+            // In dev, watch for changes and reload on demand
+            // This wll lazy load on first get() as well
+            this.startWatcher();
+        }
+        this.allSectionsPromise = (async () => {
+            if (!this.allSectionsLoaded) {
+                log('Loading all sections from disk...', this.isDev ? '(dev mode)' : '(production mode)');
+            }
+            const sections = [];
+            try {
+                const sectionFiles = await glob('**/*.section.js', {
+                    cwd: cmsConfig.sectionsFolder,
+                });
+                for (const file of sectionFiles) {
+                    try {
+                        const absPath = resolve(cmsConfig.sectionsFolder, file);
+                        const defaultExport = requireModuleRuntime(absPath);
+                        if (!defaultExport) {
+                            if (!this.sectionFetchingErrors[file]) {
+                                this.sectionFetchingErrors[file] = [];
+                            }
+                            this.sectionFetchingErrors[file].push(chalk.rgb(255, 100, 0)('Section file must have a default export. Skipping.'));
+                            this.errorCount++;
+                            continue;
+                        }
+                        if (Array.isArray(defaultExport)) {
+                            if (!this.sectionFetchingErrors[file]) {
+                                this.sectionFetchingErrors[file] = [];
+                            }
+                            this.sectionFetchingErrors[file].push(chalk.rgb(255, 100, 0)('Section file exports an array. Each file must export exactly one section. Skipping.'));
+                            this.errorCount++;
+                            continue;
+                        }
+                        if (!defaultExport.type || !defaultExport.name) {
+                            if (!this.sectionFetchingErrors[file]) {
+                                this.sectionFetchingErrors[file] = [];
+                            }
+                            this.sectionFetchingErrors[file].push(chalk.rgb(255, 100, 0)('Section file default export must have "type" and "name". Skipping.'));
+                            this.errorCount++;
+                            continue;
+                        }
+                        sections.push(defaultExport);
+                    }
+                    catch (importErr) {
+                        if (importErr instanceof Error) {
+                            /**
+                             * Only display the error message, not the stack trace.
+                             */
+                            if (!this.sectionProcessingErrors[file]) {
+                                this.sectionProcessingErrors[file] = [];
+                            }
+                            this.sectionProcessingErrors[file].push(importErr.message);
+                        }
+                        else {
+                            if (!this.sectionFetchingErrors[file]) {
+                                this.sectionFetchingErrors[file] = [];
+                            }
+                            this.sectionFetchingErrors[file].push(chalk.rgb(255, 100, 0)(`Unknown error type: ${typeof importErr}`));
+                            throw new Error(`${chalk.bgRed(` Error importing ${file}: `)}, ${importErr}`);
+                        }
+                        this.errorCount++;
+                        /**
+                         * Remove the section from the cache so it will be reloaded next time.
+                         */
+                        delete require.cache[resolve(cmsConfig.sectionsFolder, file)];
+                    }
+                }
+            }
+            catch (err) {
+                console.error('Error finding section files:', err);
+            }
+            this.allSectionsLoaded = true;
+            /**
+             * If `strict` mode is enabled,
+             * don't return sections if there are errors.
+             */
+            if (cmsConfig.strict && this.errorCount > 0) {
+                return [];
+            }
+            log(`Loaded ${sections.length} section(s)`);
+            return sections;
+        })();
+        return this.allSectionsPromise;
+    }
+    // ---------- DEV WATCHER & CACHE INVALIDATION ----------
+    static startWatcher() {
+        if (!this.isDev || this.watcherStarted)
+            return;
+        this.watcherStarted = true;
+        const watcher = chokidar.watch('**/*.section.js', {
+            cwd: cmsConfig.sectionsFolder,
+            ignoreInitial: true,
+        });
+        log('Starting section watcher in dev mode...');
+        /**
+         * This is triggering nextjs to reload the section module when a section file is changed.
+         * We used [refresh-reset](https://nextjs.org/docs/architecture/fast-refresh#:~:text=you%20can%20add-,//%20%40refresh%20reset,-anywhere%20in%20the) to let fast-refresh
+         * trigger a react-query invalidation in the form component to re-fetch the new section config.
+         * @param relPath
+         */
+        const invalidateForRelPath = (relPath) => {
+            const absPath = resolve(cmsConfig.sectionsFolder, relPath);
+            const req = eval('require');
+            try {
+                const resolved = req.resolve(absPath);
+                if (req.cache[resolved]) {
+                    delete req.cache[resolved];
+                    log('Cleared require cache for', relPath);
+                }
+                // Also clear the require cache for the hot marker file
+                if (req.cache[hotMarkerFile]) {
+                    delete req.cache[hotMarkerFile];
+                    log('Cleared require cache for', hotMarkerFile);
+                }
+                this.sectionProcessingErrors = {};
+                this.sectionFetchingErrors = {};
+                this.errorCount = 0;
+            }
+            catch {
+                // ignore if not resolvable
+            }
+            this.allSectionsPromise = null;
+            this.allSectionsLoaded = false;
+            log('Invalidated section cache due to change in', relPath);
+            this.bumpHotMarker();
+        };
+        watcher
+            .on('add', (path) => {
+            log('Section file added:', path);
+            invalidateForRelPath(path);
+        })
+            .on('change', (path) => {
+            log('Section file changed:', path);
+            invalidateForRelPath(path);
+        })
+            .on('unlink', (path) => {
+            log('Section file removed:', path);
+            invalidateForRelPath(path);
+        });
+    }
+    static init() {
+        if (this.isProd) {
+            // Preload all sections at startup in production
+            void this.loadAllSections();
+        }
+    }
+    /**
+     * Run initialization once when the module is loaded
+     */
+    static {
+        this.init();
+    }
+}