@leadcms/sdk 1.2.91-pre → 2.0.0-pre

package/dist/lib/cms.js

@@ -1,33 +1,35 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLeadCMSConfig = getLeadCMSConfig;
-exports.getAvailableLanguages = getAvailableLanguages;
-exports.getContentDirForLocale = getContentDirForLocale;
-exports.getAllContentSlugsForLocale = getAllContentSlugsForLocale;
-exports.getCMSContentBySlugForLocaleWithDraftSupport = getCMSContentBySlugForLocaleWithDraftSupport;
-exports.getCMSContentBySlugForLocale = getCMSContentBySlugForLocale;
-exports.getContentTranslations = getContentTranslations;
-exports.getAllContentRoutes = getAllContentRoutes;
-exports.extractUserUidFromSlug = extractUserUidFromSlug;
-exports.getAllContentSlugs = getAllContentSlugs;
-exports.getCMSContentBySlug = getCMSContentBySlug;
-exports.loadContentConfig = loadContentConfig;
-exports.getHeaderConfig = getHeaderConfig;
-exports.getFooterConfig = getFooterConfig;
-exports.getLocaleFromPath = getLocaleFromPath;
-exports.makeLocaleAwareLink = makeLocaleAwareLink;
-exports.loadContentConfigStrict = loadContentConfigStrict;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const gray_matter_1 = __importDefault(require("gray-matter"));
-const config_1 = require("./config");
+import fs from "fs";
+import path from "path";
+import matter from "gray-matter";
+import { getConfig } from "./config.js";
 // Default language - internal fallback only when configuration is not available
 const DEFAULT_LANGUAGE = "en";
 const contentCache = new Map();
 const CONTENT_CACHE_TTL = 30000; // 30 seconds cache TTL for content files
+/**
+ * Check if content is a draft based on publishedAt field
+ * Content is considered draft if:
+ * - publishedAt is null/undefined
+ * - publishedAt is a future date (after current time)
+ *
+ * @param content - The content to check
+ * @returns true if content is draft, false otherwise
+ */
+export function isContentDraft(content) {
+    if (!content.publishedAt) {
+        return true;
+    }
+    const publishedDate = content.publishedAt instanceof Date
+        ? content.publishedAt
+        : new Date(content.publishedAt);
+    const publishedTime = publishedDate.getTime();
+    // If the date is invalid (NaN), treat as draft
+    if (isNaN(publishedTime)) {
+        return true;
+    }
+    const now = Date.now();
+    return publishedTime > now;
+}
 /**
  * Get LeadCMS configuration with fallbacks
  * This function attempts to load the LeadCMS configuration and falls back to environment variables
@@ -35,9 +37,9 @@ const CONTENT_CACHE_TTL = 30000; // 30 seconds cache TTL for content files
  *
  * @returns Complete LeadCMS configuration object with all required fields
  */
-function getLeadCMSConfig() {
+export function getLeadCMSConfig() {
     try {
-        return (0, config_1.getConfig)();
+        return getConfig();
     }
     catch (error) {
         // If config loading fails, return minimal config with environment fallbacks
@@ -59,7 +61,7 @@ function getAvailableLanguagesFromDir(contentDir) {
     const config = getLeadCMSConfig();
     const defaultLanguage = config.defaultLanguage || DEFAULT_LANGUAGE;
     try {
-        const entries = fs_1.default.readdirSync(contentDir, { withFileTypes: true });
+        const entries = fs.readdirSync(contentDir, { withFileTypes: true });
         const languages = [defaultLanguage]; // Always include default language
         for (const entry of entries) {
             if (entry.isDirectory() && entry.name.length === 2) {
@@ -78,7 +80,7 @@ function getAvailableLanguagesFromDir(contentDir) {
 /**
  * Get all available languages from the content directory structure
  */
-function getAvailableLanguages() {
+export function getAvailableLanguages() {
     const config = getLeadCMSConfig();
     const defaultLanguage = config.defaultLanguage || DEFAULT_LANGUAGE;
     const contentDir = config.contentDir;
@@ -90,14 +92,14 @@ function getAvailableLanguages() {
 /**
  * Get content directory for a specific locale
  */
-function getContentDirForLocale(contentDir, locale) {
+export function getContentDirForLocale(contentDir, locale) {
     const config = getLeadCMSConfig();
     const defaultLanguage = config.defaultLanguage || DEFAULT_LANGUAGE;
     const actualLocale = locale || defaultLanguage;
     if (actualLocale === defaultLanguage) {
         return contentDir;
     }
-    return path_1.default.join(contentDir, actualLocale);
+    return path.join(contentDir, actualLocale);
 }
 /**
  * Get all content slugs for a specific locale with draft filtering options (internal helper)
@@ -117,7 +119,7 @@ function getAllContentSlugsForLocaleFromDir(contentDir, locale, contentTypes, in
         slugs = getAllContentSlugsFromDir(localeContentDir, contentTypes);
     }
     // Apply draft filtering logic
-    return applyDraftFiltering(slugs, includeDrafts, draftUserUid);
+    return applyDraftFiltering(slugs, includeDrafts, draftUserUid, contentDir, locale);
 }
 /**
  * Get all content slugs for a specific locale with draft filtering options
@@ -126,7 +128,7 @@ function getAllContentSlugsForLocaleFromDir(contentDir, locale, contentTypes, in
  * @param includeDrafts - Whether to include draft content (default: null = false)
  * @param draftUserUid - Specific user UID for draft content (only relevant if includeDrafts is true)
  */
-function getAllContentSlugsForLocale(locale, contentTypes, includeDrafts, draftUserUid) {
+export function getAllContentSlugsForLocale(locale, contentTypes, includeDrafts, draftUserUid) {
     const config = getLeadCMSConfig();
     const contentDir = config.contentDir;
     if (!contentDir) {
@@ -140,19 +142,31 @@ function getAllContentSlugsForLocale(locale, contentTypes, includeDrafts, draftU
  * @param slugs - Array of all slugs
  * @param includeDrafts - Whether to include draft content (null/false = filter out drafts)
  * @param draftUserUid - Specific user UID for draft content (only relevant if includeDrafts is true)
+ * @param contentDir - Content directory to load content from for publishedAt checking
+ * @param locale - Locale for content loading
  */
-function applyDraftFiltering(slugs, includeDrafts, draftUserUid) {
+function applyDraftFiltering(slugs, includeDrafts, draftUserUid, contentDir, locale) {
     // If includeDrafts is false or null, filter out all draft content
     if (!includeDrafts) {
-        return filterOutDraftSlugs(slugs);
-    }
-    // If includeDrafts is true but no specific user UID, return all slugs as-is
-    if (!draftUserUid) {
-        return slugs;
+        let filteredSlugs = filterOutDraftSlugs(slugs);
+        // Also filter based on publishedAt if contentDir is available
+        if (contentDir) {
+            filteredSlugs = filteredSlugs.filter(slug => {
+                const localeContentDir = getContentDirForLocale(contentDir, locale);
+                const content = getCMSContentBySlugFromDir(slug, localeContentDir);
+                return content && !isContentDraft(content);
+            });
+        }
+        return filteredSlugs;
     }
     // If includeDrafts is true and draftUserUid is specified,
     // return base content with user's drafts overriding the originals
-    return getBaseContentWithUserDraftOverrides(slugs, draftUserUid);
+    // User-specific drafts are always included regardless of publishedAt
+    if (draftUserUid) {
+        return getBaseContentWithUserDraftOverrides(slugs, draftUserUid);
+    }
+    // If includeDrafts is true but no specific user UID, return all slugs as-is
+    return slugs;
 }
 /**
  * Filter out draft slugs (those that have a corresponding base slug)
@@ -169,20 +183,20 @@ function filterOutDraftSlugs(slugs) {
 }
 /**
  * Get base content slugs with user-specific draft overrides
- * Returns only the user's draft versions when they exist, otherwise the base content
+ * Returns base slugs, but when content is fetched, user's version will be preferred
+ * Also includes user-only drafts (drafts that don't have a base version)
  */
 function getBaseContentWithUserDraftOverrides(slugs, draftUserUid) {
     // First, get all base slugs (non-draft)
     const baseSlugs = filterOutDraftSlugs(slugs);
-    // For each base slug, check if user has a draft version and prefer it
-    const result = [];
-    for (const baseSlug of baseSlugs) {
-        const userDraftSlug = `${baseSlug}-${draftUserUid}`;
-        // If user has a draft version, use it; otherwise use the base version
-        if (slugs.includes(userDraftSlug)) {
-            result.push(userDraftSlug);
-        }
-        else {
+    const result = [...baseSlugs]; // Start with all base slugs
+    // Find user-only drafts (drafts that don't have a corresponding base slug)
+    const userDraftPattern = new RegExp(`-${draftUserUid}$`);
+    const userDrafts = slugs.filter(slug => userDraftPattern.test(slug));
+    for (const userDraft of userDrafts) {
+        const baseSlug = userDraft.replace(userDraftPattern, '');
+        // If this is a user-only draft (no base version exists), add the base slug
+        if (!baseSlugs.includes(baseSlug)) {
             result.push(baseSlug);
         }
     }
@@ -195,7 +209,7 @@ function getAllContentSlugsExcludingLanguageDirs(contentDir, contentTypes, rootC
         ? getAvailableLanguagesFromDir(rootContentDir)
         : [config.defaultLanguage];
     function walk(dir, prefix = "") {
-        const entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
         const slugs = [];
         for (const entry of entries) {
             if (entry.isDirectory()) {
@@ -206,7 +220,7 @@ function getAllContentSlugsExcludingLanguageDirs(contentDir, contentTypes, rootC
                     entry.name !== defaultLanguage) {
                     continue;
                 }
-                const subSlugs = walk(path_1.default.join(dir, entry.name), prefix ? `${prefix}/${entry.name}` : entry.name);
+                const subSlugs = walk(path.join(dir, entry.name), prefix ? `${prefix}/${entry.name}` : entry.name);
                 slugs.push(...subSlugs);
             }
             else if (entry.isFile() && (entry.name.endsWith(".mdx") || entry.name.endsWith(".json"))) {
@@ -214,7 +228,7 @@ function getAllContentSlugsExcludingLanguageDirs(contentDir, contentTypes, rootC
                 const slug = (prefix ? `${prefix}/` : "") + entry.name.replace(new RegExp(`\\${ext}$`), "");
                 // If content types filter is provided, check the file's type
                 if (contentTypes && contentTypes.length > 0) {
-                    const filePath = path_1.default.join(dir, entry.name);
+                    const filePath = path.join(dir, entry.name);
                     try {
                         const fileType = getFileTypeOptimized(filePath, ext);
                         // Only include if the type matches the filter
@@ -242,8 +256,9 @@ function getAllContentSlugsExcludingLanguageDirs(contentDir, contentTypes, rootC
  * @param slug - Content slug
  * @param locale - Locale code
  * @param userUid - Optional user UID for draft content
+ * @param includeDrafts - Whether to include content that is draft based on publishedAt (default: false)
  */
-function getCMSContentBySlugForLocaleWithDraftSupport(slug, locale, userUid) {
+export function getCMSContentBySlugForLocaleWithDraftSupport(slug, locale, userUid, includeDrafts = false) {
     const config = getLeadCMSConfig();
     const contentDir = config.contentDir;
     if (!contentDir) {
@@ -255,11 +270,17 @@ function getCMSContentBySlugForLocaleWithDraftSupport(slug, locale, userUid) {
         const draftSlug = `${slug}-${userUid}`;
         const draftContent = getCMSContentBySlugForLocaleFromDir(draftSlug, contentDir, locale);
         if (draftContent) {
+            // Always return user-specific draft content when found, ignoring publishedAt logic
             return draftContent;
         }
     }
     // Fall back to regular content
-    return getCMSContentBySlugForLocaleFromDir(slug, contentDir, locale);
+    const content = getCMSContentBySlugForLocaleFromDir(slug, contentDir, locale);
+    // Filter out drafts by default unless explicitly requested
+    if (content && !includeDrafts && isContentDraft(content)) {
+        return null;
+    }
+    return content;
 }
 /**
  * Get content by slug for a specific locale (internal helper)
@@ -277,19 +298,26 @@ function getCMSContentBySlugForLocaleFromDir(slug, contentDir, locale) {
 /**
  * Get content by slug for a specific locale
  */
-function getCMSContentBySlugForLocale(slug, locale) {
+export function getCMSContentBySlugForLocale(slug, locale, includeDrafts = false) {
     const config = getLeadCMSConfig();
     const contentDir = config.contentDir;
     if (!contentDir) {
         console.warn('[LeadCMS] No contentDir configured. Please set up your LeadCMS configuration.');
         return null;
     }
-    return getCMSContentBySlugForLocaleFromDir(slug, contentDir, locale);
+    const content = getCMSContentBySlugForLocaleFromDir(slug, contentDir, locale);
+    // Filter out drafts by default unless explicitly requested
+    if (content && !includeDrafts && isContentDraft(content)) {
+        return null;
+    }
+    return content;
 }
 /**
  * Get all translations of a content item by translationKey
+ * @param translationKey - The translation key to search for
+ * @param includeDrafts - Whether to include draft content (default: false)
  */
-function getContentTranslations(translationKey) {
+export function getContentTranslations(translationKey, includeDrafts = false) {
     const config = getLeadCMSConfig();
     const contentDir = config.contentDir;
     if (!contentDir) {
@@ -302,10 +330,14 @@ function getContentTranslations(translationKey) {
         const localeContentDir = getContentDirForLocale(contentDir, locale);
         // Search for content with matching translationKey
         try {
-            const slugs = getAllContentSlugsFromDir(localeContentDir);
+            const slugs = getAllContentSlugsForLocaleFromDir(contentDir, locale, undefined, includeDrafts);
             for (const slug of slugs) {
                 const content = getCMSContentBySlugFromDir(slug, localeContentDir);
                 if (content && content.translationKey === translationKey) {
+                    // Filter out drafts by default unless explicitly requested
+                    if (!includeDrafts && isContentDraft(content)) {
+                        continue;
+                    }
                     content.language = content.language || locale;
                     translations.push({ locale, content });
                     break; // Found the translation for this locale
@@ -322,8 +354,11 @@ function getContentTranslations(translationKey) {
 /**
  * Get all content routes for all locales in a framework-agnostic format
  * Returns an array of route objects with locale and slug information
+ * @param contentTypes - Optional array of content types to filter
+ * @param includeDrafts - Whether to include draft content (default: false)
+ * @param draftUserUid - Specific user UID for draft content (only relevant if includeDrafts is true)
  */
-function getAllContentRoutes(contentTypes, includeDrafts, draftUserUid) {
+export function getAllContentRoutes(contentTypes, includeDrafts = false, draftUserUid) {
     const config = getLeadCMSConfig();
     const contentDir = config.contentDir;
     const defaultLanguage = config.defaultLanguage;
@@ -355,28 +390,49 @@ function getAllContentRoutes(contentTypes, includeDrafts, draftUserUid) {
  * @param slug - The slug to check for userUid
  * @returns userUid if found, null otherwise
  */
-function extractUserUidFromSlug(slug) {
+export function extractUserUidFromSlug(slug) {
     // GUID pattern: 8-4-4-4-12 hexadecimal characters with a preceding dash
     const draftSlugPattern = /-([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i;
     const match = slug.match(draftSlugPattern);
     return match ? match[1] : null;
 }
-function getAllContentSlugs(contentTypes) {
+export function getAllContentSlugs(contentTypes, includeDrafts = false) {
     const config = getLeadCMSConfig();
     const contentDir = config.contentDir;
     if (!contentDir) {
         console.warn('[LeadCMS] No contentDir configured. Please set up your LeadCMS configuration.');
         return [];
     }
-    return getAllContentSlugsFromDir(contentDir, contentTypes);
+    const allSlugs = getAllContentSlugsFromDir(contentDir, contentTypes);
+    // Always filter out user-specific draft slugs (with GUID pattern) - these should never appear in general listings
+    let filteredSlugs = filterOutDraftSlugs(allSlugs);
+    // Filter out draft content based on publishedAt if includeDrafts is false
+    if (!includeDrafts) {
+        // Then filter based on publishedAt
+        return filteredSlugs.filter(slug => {
+            const content = getCMSContentBySlugFromDir(slug, contentDir);
+            return content && !isContentDraft(content);
+        });
+    }
+    return filteredSlugs;
 }
 function getAllContentSlugsFromDir(contentDir, contentTypes) {
     function walk(dir, prefix = "") {
-        const entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch (error) {
+            // If directory doesn't exist or can't be read, return empty array
+            if (error.code === 'ENOENT' || error.code === 'EACCES') {
+                return [];
+            }
+            throw error;
+        }
         const slugs = [];
         for (const entry of entries) {
             if (entry.isDirectory()) {
-                const subSlugs = walk(path_1.default.join(dir, entry.name), prefix ? `${prefix}/${entry.name}` : entry.name);
+                const subSlugs = walk(path.join(dir, entry.name), prefix ? `${prefix}/${entry.name}` : entry.name);
                 slugs.push(...subSlugs);
             }
             else if (entry.isFile() && (entry.name.endsWith(".mdx") || entry.name.endsWith(".json"))) {
@@ -384,7 +440,7 @@ function getAllContentSlugsFromDir(contentDir, contentTypes) {
                 const slug = (prefix ? `${prefix}/` : "") + entry.name.replace(new RegExp(`\\${ext}$`), "");
                 // If content types filter is provided, check the file's type
                 if (contentTypes && contentTypes.length > 0) {
-                    const filePath = path_1.default.join(dir, entry.name);
+                    const filePath = path.join(dir, entry.name);
                     try {
                         const fileType = getFileTypeOptimized(filePath, ext);
                         // Only include if the type matches the filter
@@ -407,24 +463,33 @@ function getAllContentSlugsFromDir(contentDir, contentTypes) {
     }
     return walk(contentDir);
 }
-function getCMSContentBySlug(slug) {
+export function getCMSContentBySlug(slug, includeDrafts = false) {
     const config = getLeadCMSConfig();
     const contentDir = config.contentDir;
     if (!contentDir) {
         console.warn('[LeadCMS] No contentDir configured. Please set up your LeadCMS configuration.');
         return null;
     }
-    return getCMSContentBySlugFromDir(slug, contentDir);
+    const content = getCMSContentBySlugFromDir(slug, contentDir);
+    // Filter out drafts by default unless explicitly requested
+    if (content && !includeDrafts && isContentDraft(content)) {
+        return null;
+    }
+    return content;
 }
 function getCMSContentBySlugFromDir(slug, contentDir) {
     // Try both .mdx and .json extensions
-    const mdxPath = path_1.default.join(contentDir, `${slug}.mdx`);
-    const jsonPath = path_1.default.join(contentDir, `${slug}.json`);
+    const mdxPath = path.join(contentDir, `${slug}.mdx`);
+    const jsonPath = path.join(contentDir, `${slug}.json`);
     try {
         // Try MDX first - combine existence check with read operation
         try {
-            const file = fs_1.default.readFileSync(mdxPath, "utf8");
-            const { data, content } = (0, gray_matter_1.default)(file);
+            const file = fs.readFileSync(mdxPath, "utf8");
+            const { data, content } = matter(file);
+            // Convert publishedAt string to Date if present
+            if (data.publishedAt && typeof data.publishedAt === 'string') {
+                data.publishedAt = new Date(data.publishedAt);
+            }
             return {
                 ...data,
                 slug,
@@ -440,8 +505,12 @@ function getCMSContentBySlugFromDir(slug, contentDir) {
         }
         // Try JSON
         try {
-            const file = fs_1.default.readFileSync(jsonPath, "utf8");
+            const file = fs.readFileSync(jsonPath, "utf8");
             const data = JSON.parse(file);
+            // Convert publishedAt string to Date if present
+            if (data.publishedAt && typeof data.publishedAt === 'string') {
+                data.publishedAt = new Date(data.publishedAt);
+            }
             return {
                 ...data,
                 slug,
@@ -480,7 +549,7 @@ function getFileTypeOptimized(filePath, ext) {
  */
 function extractTypeFromMDXFrontmatter(filePath) {
     try {
-        const file = fs_1.default.readFileSync(filePath, "utf8");
+        const file = fs.readFileSync(filePath, "utf8");
         // Quick check if file starts with frontmatter
         if (!file.startsWith("---\n") && !file.startsWith("---\r\n")) {
             return undefined;
@@ -495,7 +564,7 @@ function extractTypeFromMDXFrontmatter(filePath) {
         }
         // Extract and parse only the frontmatter
         const frontmatterContent = file.slice(4, endIndex);
-        const { data } = (0, gray_matter_1.default)(`---\n${frontmatterContent}\n---`);
+        const { data } = matter(`---\n${frontmatterContent}\n---`);
         return data.type;
     }
     catch {
@@ -508,7 +577,7 @@ function extractTypeFromMDXFrontmatter(filePath) {
  */
 function extractTypeFromJSON(filePath) {
     try {
-        const file = fs_1.default.readFileSync(filePath, "utf8");
+        const file = fs.readFileSync(filePath, "utf8");
         // For small files, just parse normally
         if (file.length < 100) {
             const data = JSON.parse(file);
@@ -543,7 +612,7 @@ function loadConfigWithDraftSupport(contentDir, locale, configName, userUid) {
         let cacheKey;
         // If userUid is provided, try draft version first
         if (userUid) {
-            const draftConfigPath = path_1.default.join(localeContentDir, `${configName}-${userUid}.json`);
+            const draftConfigPath = path.join(localeContentDir, `${configName}-${userUid}.json`);
             cacheKey = `${draftConfigPath}:${locale}:${configName}:${userUid}`;
             // Check cache first for draft
             const cached = contentCache.get(cacheKey);
@@ -551,8 +620,8 @@ function loadConfigWithDraftSupport(contentDir, locale, configName, userUid) {
             if (cached && (now - cached.timestamp) < CONTENT_CACHE_TTL) {
                 return cached.content;
             }
-            if (fs_1.default.existsSync(draftConfigPath)) {
-                const draftConfigContent = fs_1.default.readFileSync(draftConfigPath, "utf-8");
+            if (fs.existsSync(draftConfigPath)) {
+                const draftConfigContent = fs.readFileSync(draftConfigPath, "utf-8");
                 const parsed = JSON.parse(draftConfigContent);
                 // Cache the result
                 contentCache.set(cacheKey, {
@@ -564,7 +633,7 @@ function loadConfigWithDraftSupport(contentDir, locale, configName, userUid) {
             }
         }
         // Fall back to regular config file
-        const configPath = path_1.default.join(localeContentDir, `${configName}.json`);
+        const configPath = path.join(localeContentDir, `${configName}.json`);
         cacheKey = `${configPath}:${locale}:${configName}`;
         // Check cache for regular config
         const cached = contentCache.get(cacheKey);
@@ -572,7 +641,7 @@ function loadConfigWithDraftSupport(contentDir, locale, configName, userUid) {
         if (cached && (now - cached.timestamp) < CONTENT_CACHE_TTL) {
             return cached.content;
         }
-        if (!fs_1.default.existsSync(configPath)) {
+        if (!fs.existsSync(configPath)) {
             // Cache the null result too to avoid repeated file system checks
             contentCache.set(cacheKey, {
                 content: null,
@@ -587,7 +656,7 @@ function loadConfigWithDraftSupport(contentDir, locale, configName, userUid) {
             error.filePath = configPath;
             throw error;
         }
-        const configContent = fs_1.default.readFileSync(configPath, "utf-8");
+        const configContent = fs.readFileSync(configPath, "utf-8");
         const parsed = JSON.parse(configContent);
         // Cache the result
         contentCache.set(cacheKey, {
@@ -602,7 +671,7 @@ function loadConfigWithDraftSupport(contentDir, locale, configName, userUid) {
         if (error instanceof Error && error.name === 'MissingConfigurationFile') {
             console.error(`[LeadCMS] ${error.message}`);
             // Re-throw with more context for debugging
-            const detailedError = new Error(`Missing configuration files - configName: '${configName}', locale: '${locale}', expected path: ${path_1.default.join(getContentDirForLocale(contentDir, locale), `${configName}.json`)}`);
+            const detailedError = new Error(`Missing configuration files - configName: '${configName}', locale: '${locale}', expected path: ${path.join(getContentDirForLocale(contentDir, locale), `${configName}.json`)}`);
             detailedError.name = 'MissingConfigurationFile';
             detailedError.configName = configName;
             detailedError.locale = locale;
@@ -627,7 +696,7 @@ function loadConfigWithDraftSupport(contentDir, locale, configName, userUid) {
  * @param userUid - Optional user UID for draft content
  * @returns Parsed config object or null if not found
  */
-function loadContentConfig(configName, locale, userUid) {
+export function loadContentConfig(configName, locale, userUid) {
     const config = getLeadCMSConfig();
     const actualLocale = locale || config.defaultLanguage;
     const contentDir = config.contentDir;
@@ -697,7 +766,7 @@ function getFooterConfigInternal(contentDir, locale, userUid) {
  * @param locale - Locale code (optional, uses default language from config if not provided)
  * @param userUid - Optional user UID for draft content
  */
-function getHeaderConfig(locale, userUid) {
+export function getHeaderConfig(locale, userUid) {
     return loadContentConfig('header', locale, userUid);
 }
 /**
@@ -705,7 +774,7 @@ function getHeaderConfig(locale, userUid) {
  * @param locale - Locale code (optional, uses default language from config if not provided)
  * @param userUid - Optional user UID for draft content
  */
-function getFooterConfig(locale, userUid) {
+export function getFooterConfig(locale, userUid) {
     return loadContentConfig('footer', locale, userUid);
 }
 /**
@@ -713,7 +782,7 @@ function getFooterConfig(locale, userUid) {
  * @param pathname - The pathname to extract locale from
  * @param contentDir - Content directory path (optional, uses configured contentDir if not provided)
  */
-function getLocaleFromPath(pathname) {
+export function getLocaleFromPath(pathname) {
     const config = getLeadCMSConfig();
     const contentDir = config.contentDir;
     const defaultLanguage = config.defaultLanguage;
@@ -752,7 +821,7 @@ function getLocaleFromPath(pathname) {
  * @param href - The href to make locale-aware
  * @param currentLocale - The current locale
  */
-function makeLocaleAwareLink(href, currentLocale) {
+export function makeLocaleAwareLink(href, currentLocale) {
     // Don't modify external links or anchors
     if (href.startsWith("http") || href.startsWith("#")) {
         return href;
@@ -782,7 +851,7 @@ function makeLocaleAwareLink(href, currentLocale) {
  * @returns Parsed config object (never returns null)
  * @throws {Error} With detailed information about missing files including configName, locale, and expected path
  */
-function loadContentConfigStrict(configName, locale, userUid) {
+export function loadContentConfigStrict(configName, locale, userUid) {
     const config = getLeadCMSConfig();
     const actualLocale = locale || config.defaultLanguage;
     const contentDir = config.contentDir;