@contentstorage/core 2.1.1 → 2.2.0

package/README.md

@@ -1,17 +1,17 @@
 # @contentstorage/core
 
-> CLI tool for managing translations and generating TypeScript types from ContentStorage
+> CLI tool for managing translations and generating TypeScript types from Contentstorage
 
 [![npm version](https://img.shields.io/npm/v/@contentstorage/core.svg)](https://www.npmjs.com/package/@contentstorage/core)
 [![License](https://img.shields.io/npm/l/@contentstorage/core.svg)](https://github.com/kaidohussar/contentstorage-core/blob/master/LICENSE)
 
 ## Overview
 
-ContentStorage Core is a powerful CLI tool for managing translations and content. It pulls content from ContentStorage CDN, generates TypeScript types, and integrates seamlessly with popular i18n libraries.
+Contentstorage Core is a powerful CLI tool for managing translations and content. It pulls content from Contentstorage CDN, generates TypeScript types, and integrates seamlessly with popular i18n libraries.
 
 ## Features
 
-- **Translation Management** - Pull content from ContentStorage CDN
+- **Translation Management** - Pull content from Contentstorage CDN
 - **TypeScript Generation** - Automatic type generation from your content
 - **Translation Statistics** - Analyze translation completeness across languages
 - **Multi-Language Support** - Built-in support for 40+ languages
@@ -48,7 +48,7 @@ export default {
 ### 2. Pull Content & Generate Types
 
 ```bash
-# Pull content from ContentStorage CDN
+# Pull content from Contentstorage CDN
 npx contentstorage pull
 
 # Generate TypeScript type definitions
@@ -69,7 +69,7 @@ npm install @contentstorage/plugin-react-intl
 npx contentstorage-react-intl export
 ```
 
-**With ContentStorage SDK (for advanced features like variations and images):**
+**With Contentstorage SDK (for advanced features like variations and images):**
 ```bash
 npm install @contentstorage/sdk
 ```
@@ -78,7 +78,7 @@ npm install @contentstorage/sdk
 
 ### `contentstorage pull`
 
-Pull content from ContentStorage CDN
+Pull content from Contentstorage CDN
 
 ```bash
 npx contentstorage pull [options]
@@ -193,13 +193,13 @@ EN, FR, DE, ES, IT, PT, NL, PL, RU, TR, SV, NO, DA, FI, CS, SK, HU, RO, BG, HR,
 
 ### Option 1: Use with i18n Libraries (Recommended for most projects)
 
-For standard i18n needs, use ContentStorage CLI with popular i18n libraries:
+For standard i18n needs, use Contentstorage CLI with popular i18n libraries:
 
 - **[@contentstorage/plugin-i18next](https://www.npmjs.com/package/@contentstorage/plugin-i18next)** - i18next integration
 - **[@contentstorage/plugin-react-intl](https://www.npmjs.com/package/@contentstorage/plugin-react-intl)** - react-intl (FormatJS) integration
 - **[@contentstorage/plugin-vue-i18n](https://www.npmjs.com/package/@contentstorage/plugin-vue-i18n)** - Vue i18n integration
 
-### Option 2: Use with ContentStorage SDK (Advanced features)
+### Option 2: Use with Contentstorage SDK (Advanced features)
 
 If you need advanced features like variations (A/B testing) and image management:
 
@@ -306,7 +306,7 @@ npm run content:sync    # Pull and generate in one command
 
 ## SDK Extract
 
-The `/sdk-extract` folder contains the ContentStorage SDK code ready to be moved to a separate repository. This SDK provides runtime features like:
+The `/sdk-extract` folder contains the Contentstorage SDK code ready to be moved to a separate repository. This SDK provides runtime features like:
 - getText/getImage/getVariation functions
 - Content variations (A/B testing)
 - Image management
@@ -335,4 +335,4 @@ Kaido Hussar - [kaidohus@gmail.com](mailto:kaidohus@gmail.com)
 
 ## Support
 
-For issues and questions, please [open an issue](https://github.com/kaidohussar/contentstorage-core/issues) on GitHub.
+For issues and questions, please [open an issue](https://github.com/kaidohussar/contentstorage-core/issues) on GitHub.

package/dist/commands/cli.js

@@ -13,6 +13,7 @@ const COMMANDS = {
             '  --content-dir <dir>    Directory to save content files',
             '  --lang <code>          Language code (e.g., EN, FR)',
             '  --pending-changes      Fetch pending/draft content',
+            '  --flatten              Output flattened key-value pairs',
         ],
     },
     'generate-types': {
@@ -38,7 +39,7 @@ const COMMANDS = {
     },
 };
 function showHelp() {
-    console.log(chalk.bold('\nContentStorage CLI'));
+    console.log(chalk.bold('\nContentstorage CLI'));
     console.log(chalk.dim('Manage content and generate TypeScript types\n'));
     console.log(chalk.bold('Usage:'));
     console.log('  contentstorage <command> [options]\n');

package/dist/commands/pull.js

@@ -5,6 +5,7 @@ import path from 'path';
 import chalk from 'chalk';
 import { loadConfig } from '../core/config-loader.js';
 import { CONTENTSTORAGE_CONFIG } from '../utils/constants.js';
+import { flattenJson } from '../utils/flatten-json.js';
 export async function pullContent() {
     console.log(chalk.blue('Starting content pull...'));
     const args = process.argv.slice(2);
@@ -17,6 +18,9 @@ export async function pullContent() {
             if (key === 'pending-changes') {
                 cliConfig.pendingChanges = true;
             }
+            else if (key === 'flatten') {
+                cliConfig.flatten = true;
+            }
             else if (value && !value.startsWith('--')) {
                 if (key === 'lang') {
                     cliConfig.languageCodes = [value.toUpperCase()];
@@ -102,7 +106,8 @@ export async function pullContent() {
                     throw new Error(`Expected a single JSON object from ${fileUrl} for language ${languageCode}, but received type ${Array.isArray(jsonData) ? 'array' : typeof jsonData}. Cannot save the file.`);
                 }
                 console.log(chalk.green(`Received JSON for ${languageCode}. Saving to ${outputPath}`));
-                await fs.writeFile(outputPath, JSON.stringify(jsonData, null, 2));
+                const outputData = config.flatten ? flattenJson(jsonData) : jsonData;
+                await fs.writeFile(outputPath, JSON.stringify(outputData, null, 2));
                 console.log(chalk.green(`Successfully saved ${outputPath}`));
             }
             catch (error) {

package/dist/types.d.ts

@@ -4,6 +4,7 @@ export type AppConfig = {
     contentDir: string;
     typesOutputFile: string;
     pendingChanges?: boolean;
+    flatten?: boolean;
 };
 export type LanguageCode = 'SQ' | 'BE' | 'BS' | 'BG' | 'HR' | 'CS' | 'DA' | 'NL' | 'EN' | 'ET' | 'FI' | 'FR' | 'DE' | 'EL' | 'HU' | 'GA' | 'IT' | 'LV' | 'LT' | 'MK' | 'NO' | 'PL' | 'PT' | 'RO' | 'RU' | 'SR' | 'SK' | 'SL' | 'ES' | 'SV' | 'TR' | 'UK';
 /**

package/package.json

@@ -2,9 +2,9 @@
   "name": "@contentstorage/core",
   "author": "Kaido Hussar <kaido@contentstorage.app>",
   "homepage": "https://contentstorage.app",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "type": "module",
-  "description": "ContentStorage CLI for managing translations and generating TypeScript types",
+  "description": "Contentstorage CLI for managing translations and generating TypeScript types",
   "license": "MIT",
   "bin": {
     "contentstorage": "dist/commands/cli.js"

package/dist/contentstorage-config.d.ts

@@ -1,4 +0,0 @@
-export declare const CONTENTSTORAGE_CONFIG: {
-    BASE_URL: string;
-    API_URL: string;
-};

package/dist/contentstorage-config.js

@@ -1,4 +0,0 @@
-export const CONTENTSTORAGE_CONFIG = {
-    BASE_URL: 'https://cdn.contentstorage.app',
-    API_URL: 'https://api.contentstorage.app',
-};

package/dist/helpers/defineConfig.d.ts

@@ -1,6 +0,0 @@
-import { AppConfig } from '../types.js';
-/**
- * Helper function to define your application configuration.
- * Provides autocompletion and type-checking for contentstorage.config.js files.
- */
-export declare function defineConfig(config: AppConfig): AppConfig;

package/dist/helpers/defineConfig.js

@@ -1,19 +0,0 @@
-/**
- * Helper function to define your application configuration.
- * Provides autocompletion and type-checking for contentstorage.config.js files.
- */
-export function defineConfig(config) {
-    // You can add basic runtime validation here if desired,
-    // e.g., check if contentUrl is a valid URL format,
-    // or if languageCodes is not empty.
-    if (!config.languageCodes || config.languageCodes.length === 0) {
-        console.warn('Warning: languageCodes array is empty or missing in the configuration.');
-    }
-    if (!config.contentDir) {
-        // This would typically be a hard error, but defineConfig is more for type safety at edit time.
-        // Runtime validation (see point 3) is better for hard errors.
-        console.warn('Warning: contentDir is missing in the configuration.');
-    }
-    // ... other checks
-    return config;
-}

package/dist/helpers/flattenJson.d.ts

@@ -1 +0,0 @@
-export declare function flattenJson(data: any, prefix?: string, result?: Record<string, any>): Record<string, any>;

package/dist/helpers/flattenJson.js

@@ -1,56 +0,0 @@
-export function flattenJson(data, prefix = '', result = {}) {
-    const stopFlatteningIfKeyExists = 'contentstorage_type';
-    // Check if the current data is an object that should not be flattened further
-    if (typeof data === 'object' &&
-        data !== null &&
-        !Array.isArray(data) && // Must be an object, not an array
-        Object.prototype.hasOwnProperty.call(data, stopFlatteningIfKeyExists)) {
-        if (prefix) {
-            // If there's a prefix, this object is nested. Assign it directly.
-            result[prefix] = data;
-        }
-        else {
-            // This is the root object itself having the 'stopFlatteningIfKeyExists' key.
-            // Consistent with how root primitives are handled (result remains empty),
-            // we don't add it to the result if there's no prefix. The function's
-            // purpose is to flatten *into* key-value pairs. If the root itself
-            // is one of these "don't flatten" types, 'result' will remain empty,
-            // which is consistent with the original function's behavior for root primitives.
-        }
-    }
-    else if (typeof data === 'object' && data !== null) {
-        // It's an object or array that should be processed further
-        if (Array.isArray(data)) {
-            if (data.length === 0 && prefix) {
-                // Handle empty arrays if prefix exists
-                result[prefix] = [];
-            }
-            data.forEach((item, index) => {
-                // Recursively call, the check for 'stopFlatteningIfKeyExists' will apply to 'item'
-                flattenJson(item, prefix ? `${prefix}.${index}` : `${index}`, result);
-            });
-        }
-        else {
-            let isEmptyObject = true;
-            for (const key in data) {
-                if (Object.prototype.hasOwnProperty.call(data, key)) {
-                    isEmptyObject = false;
-                    const newPrefix = prefix ? `${prefix}.${key}` : key;
-                    // Recursively call, the check for 'stopFlatteningIfKeyExists' will apply to 'data[key]'
-                    flattenJson(data[key], newPrefix, result);
-                }
-            }
-            if (isEmptyObject && prefix) {
-                // Handle empty objects (that were not 'special') if prefix exists
-                result[prefix] = {};
-            }
-        }
-    }
-    else if (prefix) {
-        result[prefix] = data;
-    }
-    // If the initial data is a primitive and prefix is empty, result remains empty.
-    // If the initial data is a 'special' object (contains 'stopFlatteningIfKeyExists')
-    // and prefix is empty, result also remains empty based on the logic above.
-    return result;
-}

package/dist/helpers/populateTextWithVariables.d.ts

@@ -1 +0,0 @@
-export declare function populateTextWithVariables(text: string, variables: Record<string, any>, textKey: string): string;

package/dist/helpers/populateTextWithVariables.js

@@ -1,10 +0,0 @@
-export function populateTextWithVariables(text, variables, textKey) {
-    return text.replace(/\{(\w+)}/g, (placeholder, variableName) => {
-        if (Object.prototype.hasOwnProperty.call(variables, variableName)) {
-            const value = variables[variableName];
-            return String(value);
-        }
-        console.warn(`[getText] Variable "${variableName}" for text id "${textKey}" not found in provided variables. Placeholder "${placeholder}" will be replaced with an empty string.`);
-        return placeholder;
-    });
-}

package/dist/index.d.ts

@@ -1,6 +0,0 @@
-import { AppConfig, LanguageCode, ContentStructure } from './types.js';
-import { setContentLanguage, getText, getImage, getVariation, initContentStorage } from './lib/contentManagement.js';
-import { fetchContent } from './lib/functions/fetchContent.js';
-export { AppConfig, LanguageCode, ContentStructure };
-export { initContentStorage, fetchContent, setContentLanguage, getText, getImage, getVariation, liveEditorReady, };
-declare function liveEditorReady(retries?: number, delay?: number): Promise<boolean>;

package/dist/index.js

@@ -1,62 +0,0 @@
-import { CONTENTSTORAGE_CONFIG } from './contentstorage-config.js';
-import { setContentLanguage, getText, getImage, getVariation, initContentStorage, } from './lib/contentManagement.js';
-import { fetchContent } from './lib/functions/fetchContent.js';
-export { initContentStorage, fetchContent, setContentLanguage, getText, getImage, getVariation, liveEditorReady, };
-let liveEditorReadyPromise = null;
-async function isLiveEditorMode() {
-    try {
-        const inIframe = window.self !== window.top;
-        const urlParams = new URLSearchParams(window.location.search);
-        const iframeMarkerFromParent = urlParams.get('contentstorage_live_editor');
-        return !!(inIframe && iframeMarkerFromParent);
-    }
-    catch (e) {
-        console.warn('Error accessing window.top:', e);
-        return false;
-    }
-}
-function liveEditorReady(retries = 2, delay = 3000) {
-    if (liveEditorReadyPromise) {
-        return liveEditorReadyPromise;
-    }
-    liveEditorReadyPromise = new Promise(async (resolve) => {
-        const isLiveMode = await isLiveEditorMode();
-        if (!isLiveMode) {
-            resolve(false);
-            return;
-        }
-        const cdnScriptUrl = `${CONTENTSTORAGE_CONFIG.BASE_URL}/live-editor.js?contentstorage-live-editor=true`;
-        const loadScript = (attempt = 1) => {
-            console.log(`Attempting to load Contentstorage live editor script (attempt ${attempt}/${retries})`);
-            const scriptElement = document.createElement('script');
-            scriptElement.type = 'text/javascript';
-            scriptElement.src = cdnScriptUrl;
-            scriptElement.onload = () => {
-                console.log(`Script loaded successfully from: ${cdnScriptUrl}`);
-                resolve(true);
-            };
-            scriptElement.onerror = (error) => {
-                // Clean up the failed script element to avoid clutter
-                scriptElement.remove();
-                console.error(`Failed to load script (attempt ${attempt}/${retries})`, error);
-                if (attempt < retries) {
-                    setTimeout(() => loadScript(attempt + 1), delay);
-                }
-                else {
-                    console.error(`All ${retries} attempts to load the script failed.`);
-                    resolve(false);
-                }
-            };
-            document.head.appendChild(scriptElement);
-        };
-        loadScript();
-    });
-    return liveEditorReadyPromise;
-}
-if (typeof window !== 'undefined') {
-    liveEditorReady().then((result) => {
-        if (result === true) {
-            console.log('Contentstorage live editor script loaded!');
-        }
-    });
-}

package/dist/lib/configLoader.d.ts

@@ -1,2 +0,0 @@
-import { AppConfig } from '../types.js';
-export declare function loadConfig(): Promise<AppConfig>;

package/dist/lib/configLoader.js

@@ -1,42 +0,0 @@
-import path from 'path';
-import fs from 'fs';
-import chalk from 'chalk';
-const DEFAULT_CONFIG = {
-    languageCodes: [],
-    contentDir: path.join('src', 'content', 'json'),
-    typesOutputFile: path.join('src', 'content', 'content-types.ts'),
-};
-export async function loadConfig() {
-    const configPath = path.resolve(process.cwd(), 'contentstorage.config.js'); // Look in user's current working dir
-    let userConfig = {};
-    if (fs.existsSync(configPath)) {
-        try {
-            // Use require for JS config file
-            const loadedModule = await import(configPath);
-            userConfig = loadedModule.default || loadedModule;
-            console.log(chalk.blue('Loaded config', JSON.stringify(userConfig)));
-            console.log(chalk.blue(`Loaded configuration from ${configPath}`));
-        }
-        catch (error) {
-            console.error(chalk.red(`Error loading configuration from ${configPath}:`, error));
-            // Decide if you want to proceed with defaults or exit
-            // For now, we'll proceed with defaults but warn
-            console.warn(chalk.yellow('Proceeding with default configuration.'));
-            userConfig = {}; // Reset in case of partial load failure
-        }
-    }
-    else {
-        console.log(chalk.blue('No content.config.js found. Continuing.'));
-    }
-    const mergedConfig = {
-        ...DEFAULT_CONFIG,
-        ...userConfig,
-    };
-    const finalConfig = {
-        languageCodes: mergedConfig.languageCodes || [],
-        contentKey: mergedConfig.contentKey || '',
-        contentDir: path.resolve(process.cwd(), mergedConfig.contentDir),
-        typesOutputFile: path.resolve(process.cwd(), mergedConfig.typesOutputFile),
-    };
-    return finalConfig;
-}

package/dist/lib/contentManagement.d.ts

@@ -1,32 +0,0 @@
-import { AppConfig, ContentStructure, GetImageReturn, GetTextReturn, GetVariationReturn, LanguageCode } from '../types.js';
-export declare let activeContent: object | null;
-export declare let appConfig: Pick<AppConfig, 'contentKey' | 'languageCodes' | 'pendingChanges'> | null;
-/**
- * Loads and sets the content for a specific language.
- * It will internally ensure the application configuration (for contentDir) is loaded.
- * @param contentJson
- * Language code which is used for live editor to manage pending changes
- * @param languageCode
- */
-export declare function setContentLanguage({ languageCode, contentJson, }: {
-    languageCode: LanguageCode;
-    contentJson: object;
-}): void;
-export declare function initContentStorage(config: Pick<AppConfig, 'contentKey' | 'languageCodes'>): void;
-/**
- * Retrieves the text string from the loaded JSON content for the given path.
- * Autocompletion for pathString is enabled via module augmentation of CustomContentStructure.
- * `setContentLanguage()` must be called successfully before using this.
- *
- * @param contentId A dot-notation path string (e.g., 'HomePage.Login'). Autocompletion is provided.
- * @param variables Variables help to render dynamic content inside text strings
- * If not provided, and path is not found/value not string, undefined is returned.
- * @returns The text string from the JSON, or the fallbackValue, or undefined.
- */
-export declare function getText<Path extends keyof ContentStructure>(contentId: Path, variables?: ContentStructure[Path] extends {
-    variables: infer Vars;
-} ? keyof Vars : Record<string, any>): GetTextReturn;
-export declare function getImage(contentId: keyof ContentStructure): GetImageReturn | undefined;
-export declare function getVariation<Path extends keyof ContentStructure>(contentId: Path, variationKey?: ContentStructure[Path] extends {
-    data: infer D;
-} ? keyof D : string, variables?: Record<string, any>): GetVariationReturn;

package/dist/lib/contentManagement.js

@@ -1,257 +0,0 @@
-import { populateTextWithVariables } from '../helpers/populateTextWithVariables.js';
-export let activeContent = null;
-export let appConfig = null;
-/**
- * NB! Only used when live editor mode is on
- */
-window.memoryMap = new Map();
-window.currentLanguageCode = null;
-/**
- * Loads and sets the content for a specific language.
- * It will internally ensure the application configuration (for contentDir) is loaded.
- * @param contentJson
- * Language code which is used for live editor to manage pending changes
- * @param languageCode
- */
-export function setContentLanguage({ languageCode, contentJson, }) {
-    if (!contentJson || typeof contentJson !== 'object') {
-        throw new Error('[Contentstorage] Invalid contentJson might be provided which caused setContentLanguage to fail.');
-    }
-    try {
-        activeContent = contentJson; // Relies on augmentation
-        if (typeof window !== 'undefined') {
-            window.currentLanguageCode = languageCode;
-        }
-        console.log(`[Contentstorage] Content loaded.`);
-    }
-    catch (error) {
-        activeContent = null; // Reset on failure
-        window.currentLanguageCode = null;
-        console.error(`[Contentstorage] Failed to load content. Error: ${error.message}`);
-    }
-}
-export function initContentStorage(config) {
-    if (!config ||
-        typeof config !== 'object' ||
-        !config.contentKey ||
-        !Array.isArray(config.languageCodes)) {
-        if (!config.contentKey) {
-            throw new Error('[Contentstorage] No contentKey provided in initContentStorage function.');
-        }
-        if (!Array.isArray(config.languageCodes)) {
-            throw new Error('[Contentstorage] No languageCodes provided in initContentStorage function.');
-        }
-        throw new Error('[Contentstorage] Invalid config.');
-    }
-    appConfig = config;
-}
-/**
- * Retrieves the text string from the loaded JSON content for the given path.
- * Autocompletion for pathString is enabled via module augmentation of CustomContentStructure.
- * `setContentLanguage()` must be called successfully before using this.
- *
- * @param contentId A dot-notation path string (e.g., 'HomePage.Login'). Autocompletion is provided.
- * @param variables Variables help to render dynamic content inside text strings
- * If not provided, and path is not found/value not string, undefined is returned.
- * @returns The text string from the JSON, or the fallbackValue, or undefined.
- */
-export function getText(contentId, variables) {
-    const defaultVal = {
-        contentId,
-        text: '',
-    };
-    if (!activeContent) {
-        const msg = `[Contentstorage] getText: Content not loaded (Key: "${String(contentId)}"). Ensure setContentLanguage() was called and completed successfully.`;
-        console.warn(msg);
-        return defaultVal;
-    }
-    const keys = contentId.split('.');
-    let current = activeContent;
-    for (const key of keys) {
-        if (current && typeof current === 'object' && key in current) {
-            current = current[key];
-        }
-        else {
-            const msg = `[Contentstorage] getText: Path "${String(contentId)}" not found in loaded content.`;
-            console.warn(msg);
-            return defaultVal;
-        }
-    }
-    if (typeof current === 'string') {
-        if (window.parent && window.parent !== window) {
-            const key = current;
-            const existingEntry = window.memoryMap.get(key);
-            const idSet = existingEntry ? existingEntry.ids : new Set();
-            idSet.add(contentId); // Add the current ID to the set.
-            window.memoryMap.set(key, {
-                ids: idSet,
-                type: 'text',
-            });
-        }
-        if (!variables || Object.keys(variables).length === 0) {
-            return {
-                contentId,
-                text: current,
-            };
-        }
-        return {
-            contentId,
-            text: populateTextWithVariables(current, variables, contentId),
-        };
-    }
-    else {
-        const msg = `[Contentstorage] getText: Value at path "${String(contentId)}" is not a string (actual type: ${typeof current}).`;
-        console.warn(msg);
-        return defaultVal;
-    }
-}
-export function getImage(contentId) {
-    const defaultVal = {
-        contentId,
-        data: { url: '', altText: '', contentstorage_type: 'image' },
-    };
-    if (!activeContent) {
-        const msg = `[Contentstorage] getImage: Content not loaded (Content Id: "${contentId}"). Ensure setContentLanguage() was called and completed successfully.`;
-        console.warn(msg);
-        return {
-            contentId,
-            data: { url: '', altText: '', contentstorage_type: 'image' },
-        };
-    }
-    const keys = contentId.split('.');
-    let current = activeContent;
-    for (const key of keys) {
-        if (current && typeof current === 'object' && key in current) {
-            current = current[key];
-        }
-        else {
-            const msg = `[Contentstorage] getImage: Path "${contentId}" not found in loaded content.`;
-            console.warn(msg);
-            return defaultVal;
-        }
-    }
-    if (current &&
-        typeof current === 'object' &&
-        current.contentstorage_type === 'image' &&
-        typeof current.url === 'string') {
-        const currentData = current;
-        const key = `https://cdn.contentstorage.app/${currentData.url}`;
-        if (window.parent && window.parent !== window) {
-            const existingEntry = window.memoryMap.get(key);
-            const idSet = existingEntry ? existingEntry.ids : new Set();
-            idSet.add(contentId); // Add the current ID to the set.
-            window.memoryMap.set(key, {
-                ids: idSet,
-                type: 'image',
-            });
-        }
-        console.log('currentData.url', currentData.url);
-        return {
-            contentId,
-            data: {
-                ...currentData,
-                url: key,
-            },
-        };
-    }
-    else {
-        const msg = `[Contentstorage] getImage: Value at path "${contentId}" is not a valid image object (actual value: ${JSON.stringify(current)}).`;
-        console.warn(msg);
-        return defaultVal;
-    }
-}
-export function getVariation(contentId, variationKey, variables) {
-    const defaultVal = {
-        contentId,
-        text: '',
-    };
-    if (!activeContent) {
-        const msg = `[Contentstorage] getVariation: Content not loaded (Content Id: "${contentId}", Variation: "${variationKey?.toString()}"). Ensure setContentLanguage() was called and completed successfully.`;
-        console.warn(msg);
-        return defaultVal;
-    }
-    const keys = contentId.split('.');
-    let current = activeContent;
-    for (const key of keys) {
-        if (current && typeof current === 'object' && key in current) {
-            current = current[key];
-        }
-        else {
-            const msg = `[Contentstorage] getVariation: Path "${contentId}" for variation object not found in loaded content.`;
-            console.warn(msg);
-            return defaultVal;
-        }
-    }
-    if (current &&
-        typeof current === 'object' &&
-        current.contentstorage_type === 'variation' &&
-        typeof current.data === 'object' &&
-        current.data !== null) {
-        const variationObject = current;
-        if (variationKey &&
-            typeof variationKey === 'string' &&
-            variationKey in variationObject.data) {
-            if (typeof variationObject.data[variationKey] === 'string') {
-                const current = variationObject.data[variationKey];
-                if (window.parent && window.parent !== window) {
-                    const key = current;
-                    const existingEntry = window.memoryMap.get(key);
-                    const idSet = existingEntry ? existingEntry.ids : new Set();
-                    idSet.add(contentId); // Add the current ID to the set.
-                    window.memoryMap.set(key, {
-                        ids: idSet,
-                        type: 'variation',
-                        variation: variationKey,
-                    });
-                }
-                if (!variables || Object.keys(variables).length === 0) {
-                    return {
-                        contentId,
-                        text: current,
-                    };
-                }
-                return {
-                    contentId,
-                    text: populateTextWithVariables(current, variables, contentId),
-                };
-            }
-            else {
-                const msg = `[Contentstorage] getVariation: Variation value for key "${variationKey}" at path "${contentId}" is not a string (actual type: ${typeof variationObject.data[variationKey]}).`;
-                console.warn(msg);
-            }
-        }
-        // If specific variationKey is not found or not provided, try to return the 'default' variation
-        if ('default' in variationObject.data && typeof variationKey === 'string') {
-            if (typeof variationObject.data.default === 'string') {
-                if (variationKey && variationKey !== 'default') {
-                    console.warn(`[Contentstorage] getVariation: Variation key "${variationKey}" not found at path "${contentId}". Returning 'default' variation.`);
-                }
-                if (window.parent && window.parent !== window) {
-                    const key = current;
-                    const existingEntry = window.memoryMap.get(key);
-                    const idSet = existingEntry ? existingEntry.ids : new Set();
-                    idSet.add(contentId); // Add the current ID to the set.
-                    window.memoryMap.set(key, {
-                        ids: idSet,
-                        type: 'variation',
-                        variation: 'default',
-                    });
-                }
-                return {
-                    contentId,
-                    text: variationObject.data.default,
-                };
-            }
-            else {
-                console.warn(`[Contentstorage] getVariation: 'default' variation value at path "${contentId}" is not a string (actual type: ${typeof variationObject.data.default}).`);
-            }
-        }
-        // If neither specific key nor 'default' is found or valid
-        console.warn(`[Contentstorage] getVariation: Neither variation key "${variationKey?.toString()}" nor 'default' variation found or valid at path "${contentId}".`);
-        return defaultVal;
-    }
-    else {
-        console.warn(`[Contentstorage] getVariation: Value at path "${contentId}" is not a valid variation object (actual value: ${JSON.stringify(current)}).`);
-        return defaultVal;
-    }
-}

package/dist/lib/functions/fetchContent.d.ts

@@ -1,7 +0,0 @@
-import { LanguageCode } from '../../types.js';
-interface FetchContentOptions {
-    withPendingChanges?: boolean;
-    contentKey?: string;
-}
-export declare function fetchContent(language?: LanguageCode, options?: FetchContentOptions): Promise<void>;
-export {};

package/dist/lib/functions/fetchContent.js

@@ -1,141 +0,0 @@
-import axios from 'axios';
-import { CONTENTSTORAGE_CONFIG } from '../../contentstorage-config.js';
-import { appConfig, setContentLanguage } from '../contentManagement.js';
-// Map of request keys to their debounce timers
-const debounceTimers = new Map();
-// Map of request keys to their cancel token sources
-const cancelTokenSources = new Map();
-// Fixed debounce delay in milliseconds
-const DEBOUNCE_MS = 200;
-export async function fetchContent(language, options = {}) {
-    const { withPendingChanges, contentKey } = options;
-    const languageToFetch = language || appConfig?.languageCodes?.[0];
-    const usePendingChangesToFetch = withPendingChanges || appConfig?.pendingChanges;
-    console.log(`Starting content fetch for language ${language}...`);
-    if (!languageToFetch) {
-        throw Error(`No language found`);
-    }
-    if (!appConfig) {
-        throw Error(`No app config found`);
-    }
-    const effectiveContentKey = contentKey || appConfig.contentKey;
-    let fileUrl;
-    let requestConfig = {};
-    if (usePendingChangesToFetch) {
-        if (!effectiveContentKey) {
-            throw Error(`No contentKey found`);
-        }
-        fileUrl = `${CONTENTSTORAGE_CONFIG.API_URL}/pending-changes/get-json?languageCode=${languageToFetch}`;
-        requestConfig.headers = {
-            'X-Content-Key': effectiveContentKey,
-        };
-        // Apply debouncing and cancellation only for pending-changes API endpoint
-        const requestKey = `${languageToFetch}:${effectiveContentKey}`;
-        // Cancel any existing in-flight request for the same parameters
-        const existingCancelSource = cancelTokenSources.get(requestKey);
-        if (existingCancelSource) {
-            existingCancelSource.cancel('Request cancelled due to new request');
-            cancelTokenSources.delete(requestKey);
-        }
-        // Clear any existing debounce timer for the same parameters
-        const existingTimer = debounceTimers.get(requestKey);
-        if (existingTimer) {
-            clearTimeout(existingTimer);
-            debounceTimers.delete(requestKey);
-        }
-        // Return a promise that will resolve after debouncing
-        return new Promise((resolve, reject) => {
-            const timer = setTimeout(async () => {
-                debounceTimers.delete(requestKey);
-                // Create a cancel token for this request
-                const cancelTokenSource = axios.CancelToken.source();
-                requestConfig.cancelToken = cancelTokenSource.token;
-                cancelTokenSources.set(requestKey, cancelTokenSource);
-                try {
-                    // Fetch data for the current language
-                    const response = await axios.get(fileUrl, requestConfig);
-                    let jsonData = response.data;
-                    // Handle API response structure - only for pending changes API
-                    if (jsonData && typeof jsonData === 'object' && 'data' in jsonData) {
-                        jsonData = jsonData.data;
-                    }
-                    if (jsonData === undefined || jsonData === null) {
-                        throw new Error(`No data received from ${fileUrl} for language ${languageToFetch}.`);
-                    }
-                    // Validate that jsonData is a single, non-null JSON object (not an array)
-                    if (typeof jsonData !== 'object') {
-                        throw new Error(`Expected a single JSON object from ${fileUrl} for language ${languageToFetch}, but received type ${typeof jsonData}. Cannot proceed.`);
-                    }
-                    console.log(`Received JSON for ${languageToFetch}`);
-                    setContentLanguage({
-                        languageCode: languageToFetch,
-                        contentJson: jsonData,
-                    });
-                    // Clean up cancel token source
-                    cancelTokenSources.delete(requestKey);
-                    resolve();
-                }
-                catch (error) {
-                    // Clean up cancel token source
-                    cancelTokenSources.delete(requestKey);
-                    // Don't log cancelled requests as errors
-                    if (axios.isCancel(error)) {
-                        console.log(`Request cancelled for language ${languageToFetch}`);
-                        resolve();
-                        return;
-                    }
-                    // Catch errors related to fetching or saving a single language file
-                    console.error(`\nError processing language ${languageToFetch} from ${fileUrl}:`);
-                    if (axios.isAxiosError(error)) {
-                        console.error(`  Status: ${error.response?.status}`);
-                        console.error(`Response Data: ${error.response?.data ? JSON.stringify(error.response.data) : 'N/A'}`);
-                        console.error(`  Message: ${error.message}`);
-                    }
-                    else {
-                        console.error(`  Error: ${error.message}`);
-                    }
-                    reject(error);
-                }
-            }, DEBOUNCE_MS);
-            debounceTimers.set(requestKey, timer);
-        });
-    }
-    else {
-        fileUrl = `${CONTENTSTORAGE_CONFIG.BASE_URL}/${effectiveContentKey}/content/${languageToFetch}.json`;
-    }
-    try {
-        // Fetch data for the current language (CDN endpoint - no debouncing)
-        const response = await axios.get(fileUrl, requestConfig);
-        let jsonData = response.data;
-        // Handle API response structure - only for pending changes API
-        if (usePendingChangesToFetch && jsonData && typeof jsonData === 'object' && 'data' in jsonData) {
-            jsonData = jsonData.data;
-        }
-        if (jsonData === undefined || jsonData === null) {
-            throw new Error(`No data received from ${fileUrl} for language ${languageToFetch}.`);
-        }
-        // Validate that jsonData is a single, non-null JSON object (not an array)
-        // This check mirrors the original code's expectation for the content of a JSON file.
-        if (typeof jsonData !== 'object') {
-            throw new Error(`Expected a single JSON object from ${fileUrl} for language ${languageToFetch}, but received type ${typeof jsonData}. Cannot proceed.`);
-        }
-        console.log(`Received JSON for ${languageToFetch}`);
-        setContentLanguage({
-            languageCode: languageToFetch,
-            contentJson: jsonData,
-        });
-    }
-    catch (error) {
-        // Catch errors related to fetching or saving a single language file
-        console.error(`\nError processing language ${languageToFetch} from ${fileUrl}:`);
-        if (axios.isAxiosError(error)) {
-            console.error(`  Status: ${error.response?.status}`);
-            console.error(`Response Data: ${error.response?.data ? JSON.stringify(error.response.data) : 'N/A'}`);
-            console.error(`  Message: ${error.message}`); // Axios error message
-        }
-        else {
-            // For non-Axios errors (e.g., manually thrown errors, fs errors)
-            console.error(`  Error: ${error.message}`);
-        }
-    }
-}

package/dist/scripts/cli.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/scripts/cli.js

@@ -1,96 +0,0 @@
-#!/usr/bin/env node
-import chalk from 'chalk';
-import { pullContent } from './pull-content.js';
-import { generateTypes } from './generate-types.js';
-const COMMANDS = {
-    pull: {
-        name: 'pull',
-        description: 'Pull content from Contentstorage CDN',
-        usage: 'contentstorage pull [options]',
-        options: [
-            '  --content-key <key>    Content key for your project',
-            '  --content-dir <dir>    Directory to save content files',
-            '  --lang <code>          Language code (e.g., EN, FR)',
-            '  --pending-changes      Fetch pending/draft content',
-        ],
-    },
-    'generate-types': {
-        name: 'generate-types',
-        description: 'Generate TypeScript type definitions from content',
-        usage: 'contentstorage generate-types [options]',
-        options: [
-            '  --output <file>        Output file for generated types',
-            '  --content-key <key>    Content key for your project',
-            '  --lang <code>          Language code (e.g., EN, FR)',
-            '  --pending-changes      Use pending/draft content',
-        ],
-    },
-};
-function showHelp() {
-    console.log(chalk.bold('\nContentStorage CLI'));
-    console.log(chalk.dim('Manage content and generate TypeScript types\n'));
-    console.log(chalk.bold('Usage:'));
-    console.log('  contentstorage <command> [options]\n');
-    console.log(chalk.bold('Commands:'));
-    Object.values(COMMANDS).forEach((cmd) => {
-        console.log(`  ${chalk.cyan(cmd.name.padEnd(20))} ${cmd.description}`);
-    });
-    console.log(chalk.bold('\nOptions:'));
-    console.log('  --help                 Show help for a command\n');
-    console.log(chalk.dim('Examples:'));
-    console.log(chalk.dim('  contentstorage pull --content-key abc123'));
-    console.log(chalk.dim('  contentstorage generate-types --output types.ts'));
-    console.log(chalk.dim('  contentstorage pull --help    # Show help for pull command\n'));
-}
-function showCommandHelp(commandName) {
-    const cmd = COMMANDS[commandName];
-    if (!cmd) {
-        console.error(chalk.red(`Unknown command: ${commandName}`));
-        process.exit(1);
-    }
-    console.log(chalk.bold(`\n${cmd.name}`));
-    console.log(chalk.dim(cmd.description + '\n'));
-    console.log(chalk.bold('Usage:'));
-    console.log(`  ${cmd.usage}\n`);
-    if (cmd.options.length > 0) {
-        console.log(chalk.bold('Options:'));
-        cmd.options.forEach((opt) => console.log(opt));
-        console.log('');
-    }
-}
-async function main() {
-    const args = process.argv.slice(2);
-    // No arguments - show help
-    if (args.length === 0) {
-        showHelp();
-        process.exit(0);
-    }
-    const command = args[0];
-    // Global --help flag
-    if (command === '--help' || command === '-h') {
-        showHelp();
-        process.exit(0);
-    }
-    // Command-specific --help
-    if (args.includes('--help') || args.includes('-h')) {
-        showCommandHelp(command);
-        process.exit(0);
-    }
-    // Route to commands
-    switch (command) {
-        case 'pull':
-            await pullContent();
-            break;
-        case 'generate-types':
-            await generateTypes();
-            break;
-        default:
-            console.error(chalk.red(`Unknown command: ${command}\n`));
-            console.log(chalk.dim('Run "contentstorage --help" for usage'));
-            process.exit(1);
-    }
-}
-main().catch((error) => {
-    console.error(chalk.red('Unexpected error:'), error);
-    process.exit(1);
-});

package/dist/scripts/generate-types.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export declare function generateTypes(): Promise<void>;

package/dist/scripts/generate-types.js

@@ -1,174 +0,0 @@
-#!/usr/bin/env node
-// ^ Ensures the script is executed with Node.js
-import fs from 'fs/promises';
-import path from 'path';
-import axios from 'axios';
-import chalk from 'chalk'; // Optional: for colored output
-import { loadConfig } from '../lib/configLoader.js';
-import { flattenJson } from '../helpers/flattenJson.js';
-import { CONTENTSTORAGE_CONFIG } from '../contentstorage-config.js';
-import { jsonToTS } from '../type-generation/index.js';
-export async function generateTypes() {
-    console.log(chalk.blue('Starting type generation...'));
-    const args = process.argv.slice(2);
-    const cliConfig = {};
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (arg.startsWith('--')) {
-            const key = arg.substring(2);
-            const value = args[i + 1];
-            if (key === 'pending-changes') {
-                cliConfig.pendingChanges = true;
-            }
-            else if (value && !value.startsWith('--')) {
-                if (key === 'lang') {
-                    cliConfig.languageCodes = [value.toUpperCase()];
-                }
-                else if (key === 'content-key') {
-                    cliConfig.contentKey = value;
-                }
-                else if (key === 'output') {
-                    cliConfig.typesOutputFile = value;
-                }
-                // Skip the value in the next iteration
-                i++;
-            }
-        }
-    }
-    let fileConfig = {};
-    try {
-        fileConfig = await loadConfig();
-    }
-    catch {
-        console.log(chalk.yellow('Could not load a configuration file. Proceeding with CLI arguments.'));
-    }
-    const config = { ...fileConfig, ...cliConfig };
-    if (!config.typesOutputFile) {
-        console.error(chalk.red.bold("Configuration error: 'typesOutputFile' is missing."));
-        process.exit(1);
-    }
-    if (!config.languageCodes ||
-        !Array.isArray(config.languageCodes) ||
-        config.languageCodes.length === 0) {
-        console.error(chalk.red.bold("Configuration error: 'languageCodes' must be a non-empty array."));
-        process.exit(1);
-    }
-    console.log(chalk.blue(`TypeScript types will be saved to: ${config.typesOutputFile}`));
-    let jsonObject; // To hold the JSON data from either local or remote source
-    let dataSourceDescription = ''; // For clearer logging
-    const firstLanguageCode = config.languageCodes[0];
-    try {
-        let attemptLocalLoad = false;
-        if (config.contentDir) {
-            try {
-                await fs.stat(config.contentDir); // Check if directory exists
-                attemptLocalLoad = true;
-                console.log(chalk.blue(`Local content directory found: ${config.contentDir}`));
-            }
-            catch (statError) {
-                if (statError.code === 'ENOENT') {
-                    console.log(chalk.yellow(`Local content directory specified but not found: ${config.contentDir}. Will attempt to fetch from URL.`));
-                    // attemptLocalLoad remains false
-                }
-                else {
-                    // Other errors accessing contentDir (e.g., permissions)
-                    throw new Error(`Error accessing content directory ${config.contentDir}: ${statError.message}`);
-                }
-            }
-        }
-        else {
-            console.log(chalk.yellow(`Local content directory (config.contentDir) not specified. Attempting to fetch from URL.`));
-        }
-        if (attemptLocalLoad && config.contentDir) {
-            // --- Load from local file system ---
-            const targetFilename = `${firstLanguageCode}.json`;
-            const jsonFilePath = path.join(config.contentDir, targetFilename);
-            dataSourceDescription = `local file (${jsonFilePath})`;
-            console.log(chalk.blue(`Attempting to read JSON from: ${jsonFilePath}`));
-            try {
-                const jsonContentString = await fs.readFile(jsonFilePath, 'utf-8');
-                console.log(chalk.blue('Parsing JSON'));
-                const parsendJsonObject = JSON.parse(jsonContentString);
-                console.log(chalk.blue('Flattening JSON for type generation'));
-                jsonObject = flattenJson(parsendJsonObject);
-                console.log(chalk.green(`Successfully read and parsed JSON from ${jsonFilePath}.`));
-            }
-            catch (fileError) {
-                if (fileError.code === 'ENOENT') {
-                    throw new Error(`Target JSON file not found at ${jsonFilePath}. ` +
-                        `Ensure content for language code '${firstLanguageCode}' has been pulled and exists locally, ` +
-                        `or ensure 'contentDir' is not set if you intend to fetch from URL.`);
-                }
-                throw new Error(`Failed to read or parse JSON from ${jsonFilePath}: ${fileError.message}`);
-            }
-        }
-        else {
-            if (!config.contentKey) {
-                throw new Error('Cannot generate types: contentKey is missing');
-            }
-            let fileUrl;
-            const requestConfig = { responseType: 'json' };
-            if (config.pendingChanges) {
-                fileUrl = `${CONTENTSTORAGE_CONFIG.API_URL}/pending-changes/get-json?languageCode=${firstLanguageCode}`;
-                requestConfig.headers = {
-                    'X-Content-Key': config.contentKey,
-                };
-            }
-            else {
-                fileUrl = `${CONTENTSTORAGE_CONFIG.BASE_URL}/${config.contentKey}/content/${firstLanguageCode}.json`;
-            }
-            dataSourceDescription = `remote URL (${fileUrl})`;
-            console.log(chalk.blue(`Attempting to fetch JSON from: ${fileUrl}`));
-            try {
-                const response = await axios.get(fileUrl, requestConfig);
-                let jsonResponse = response.data;
-                // Handle API response structure - API returns { data: actualContent }
-                if (config.pendingChanges && jsonResponse && typeof jsonResponse === 'object' && 'data' in jsonResponse) {
-                    jsonResponse = jsonResponse.data;
-                }
-                console.log(chalk.blue('Flattening JSON for type generation'));
-                jsonObject = flattenJson(jsonResponse);
-                if (typeof jsonObject !== 'object' || jsonObject === null) {
-                    throw new Error(`Workspaceed data from ${fileUrl} is not a valid JSON object. Received type: ${typeof jsonObject}`);
-                }
-                console.log(chalk.green(`Successfully fetched and parsed JSON from ${fileUrl}. This content will not be saved locally.`));
-            }
-            catch (fetchError) {
-                let errorDetail = fetchError.message;
-                if (axios.isAxiosError(fetchError)) {
-                    errorDetail = `Status: ${fetchError.response?.status}, Response: ${JSON.stringify(fetchError.response?.data)}`;
-                }
-                throw new Error(`Failed to fetch JSON from ${fileUrl}: ${errorDetail}`);
-            }
-        }
-        // Validate the obtained jsonObject (must be an object or array for json-to-ts)
-        if (typeof jsonObject !== 'object' || jsonObject === null) {
-            // jsonToTS can handle root arrays too, but if it's primitive it's an issue.
-            // Allowing arrays here explicitly based on jsonToTS capability.
-            if (!Array.isArray(jsonObject)) {
-                throw new Error(`The content obtained from ${dataSourceDescription} is not a JSON object or array (type: ${typeof jsonObject}). Cannot generate types.`);
-            }
-        }
-        // Generate TypeScript interfaces using json-to-ts
-        const rootTypeName = 'ContentRoot';
-        console.log(chalk.blue(`Generating TypeScript types with root name '${rootTypeName}'...`));
-        const typeDeclarations = jsonToTS(jsonObject, {
-            rootName: rootTypeName,
-        });
-        if (!typeDeclarations || typeDeclarations.length === 0) {
-            throw new Error(`Could not generate types from the content of ${dataSourceDescription}. 'json-to-ts' returned no declarations.`);
-        }
-        const outputContent = typeDeclarations.join('\n\n');
-        // Ensure the output directory exists for the types file
-        const outputDir = path.dirname(config.typesOutputFile);
-        await fs.mkdir(outputDir, { recursive: true });
-        // Write the generated types to the output file
-        await fs.writeFile(config.typesOutputFile, outputContent, 'utf-8');
-        console.log(chalk.green(`TypeScript types generated successfully at ${config.typesOutputFile} using data from ${dataSourceDescription}.`));
-    }
-    catch (error) {
-        console.error(chalk.red.bold('\nError generating TypeScript types:'));
-        console.error(chalk.red(error.message));
-        process.exit(1);
-    }
-}

package/dist/scripts/pull-content.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export declare function pullContent(): Promise<void>;

package/dist/scripts/pull-content.js

@@ -1,137 +0,0 @@
-#!/usr/bin/env node
-import axios from 'axios';
-import fs from 'fs/promises';
-import path from 'path';
-import chalk from 'chalk';
-import { loadConfig } from '../lib/configLoader.js';
-import { CONTENTSTORAGE_CONFIG } from '../contentstorage-config.js';
-export async function pullContent() {
-    console.log(chalk.blue('Starting content pull...'));
-    const args = process.argv.slice(2);
-    const cliConfig = {};
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (arg.startsWith('--')) {
-            const key = arg.substring(2);
-            const value = args[i + 1];
-            if (key === 'pending-changes') {
-                cliConfig.pendingChanges = true;
-            }
-            else if (value && !value.startsWith('--')) {
-                if (key === 'lang') {
-                    cliConfig.languageCodes = [value.toUpperCase()];
-                }
-                else if (key === 'content-key') {
-                    cliConfig.contentKey = value;
-                }
-                else if (key === 'content-dir') {
-                    cliConfig.contentDir = value;
-                }
-                // Skip the value in the next iteration
-                i++;
-            }
-        }
-    }
-    let fileConfig = {};
-    try {
-        fileConfig = await loadConfig();
-    }
-    catch {
-        console.log(chalk.yellow('Could not load a configuration file. Proceeding with CLI arguments.'));
-    }
-    const config = { ...fileConfig, ...cliConfig };
-    // Validate required fields
-    if (!config.contentKey) {
-        console.error(chalk.red('Error: Configuration is missing the required "contentKey" property.'));
-        process.exit(1);
-    }
-    if (!config.contentDir) {
-        console.error(chalk.red('Error: Configuration is missing the required "contentDir" property.'));
-        process.exit(1);
-    }
-    console.log(chalk.blue(`Content key: ${config.contentKey}`));
-    console.log(chalk.blue(`Saving content to: ${config.contentDir}`));
-    try {
-        // Validate languageCodes array
-        if (!Array.isArray(config.languageCodes)) {
-            console.log(chalk.red(`Expected array from config.languageCodes, but received type ${typeof config.languageCodes}. Cannot pull files.`));
-            return; // Exit if languageCodes is not an array
-        }
-        if (config.languageCodes.length === 0) {
-            console.log(chalk.yellow('config.languageCodes array is empty. No files to pull.'));
-            return; // Exit if languageCodes array is empty
-        }
-        // Ensure the output directory exists (create it once before the loop)
-        await fs.mkdir(config.contentDir, { recursive: true });
-        // Process each language code
-        for (const languageCode of config.languageCodes) {
-            let fileUrl;
-            const requestConfig = {};
-            if (config.pendingChanges) {
-                fileUrl = `${CONTENTSTORAGE_CONFIG.API_URL}/pending-changes/get-json?languageCode=${languageCode}`;
-                requestConfig.headers = {
-                    'X-Content-Key': config.contentKey
-                };
-            }
-            else {
-                fileUrl = `${CONTENTSTORAGE_CONFIG.BASE_URL}/${config.contentKey}/content/${languageCode}.json`;
-            }
-            const filename = `${languageCode}.json`;
-            const outputPath = path.join(config.contentDir, filename);
-            console.log(chalk.blue(`\nProcessing language: ${languageCode}`));
-            console.log(chalk.blue(`Using following contentKey to fetch json: ${config.contentKey}`));
-            try {
-                // Fetch data for the current language
-                const response = await axios.get(fileUrl, requestConfig);
-                let jsonData = response.data;
-                // Handle API response structure - only for pending changes API
-                if (config.pendingChanges && jsonData && typeof jsonData === 'object' && 'data' in jsonData) {
-                    jsonData = jsonData.data;
-                }
-                // Basic check for data existence, although axios usually throws for non-2xx responses
-                if (jsonData === undefined || jsonData === null) {
-                    throw new Error(`No data received from ${fileUrl} for language ${languageCode}.`);
-                }
-                // Validate that jsonData is a single, non-null JSON object (not an array)
-                // This check mirrors the original code's expectation for the content of a JSON file.
-                if (typeof jsonData !== 'object' ||
-                    Array.isArray(jsonData) /* jsonData === null is already covered */) {
-                    throw new Error(`Expected a single JSON object from ${fileUrl} for language ${languageCode}, but received type ${Array.isArray(jsonData) ? 'array' : typeof jsonData}. Cannot save the file.`);
-                }
-                console.log(chalk.green(`Received JSON for ${languageCode}. Saving to ${outputPath}`));
-                await fs.writeFile(outputPath, JSON.stringify(jsonData, null, 2));
-                console.log(chalk.green(`Successfully saved ${outputPath}`));
-            }
-            catch (error) {
-                // Catch errors related to fetching or saving a single language file
-                console.error(chalk.red(`\nError processing language ${languageCode} from ${fileUrl}:`));
-                if (axios.isAxiosError(error)) {
-                    console.error(chalk.red(`  Status: ${error.response?.status}`));
-                    console.error(chalk.red(`Response Data: ${error.response?.data ? JSON.stringify(error.response.data) : 'N/A'}`));
-                    console.error(chalk.red(`  Message: ${error.message}`)); // Axios error message
-                }
-                else {
-                    // For non-Axios errors (e.g., manually thrown errors, fs errors)
-                    console.error(chalk.red(`  Error: ${error.message}`));
-                }
-                // Re-throw the error to be caught by the outer try-catch block,
-                // which will then call process.exit(1), maintaining original exit behavior on error.
-                throw error;
-            }
-        }
-        console.log(chalk.green('\nAll content successfully pulled and saved.'));
-    }
-    catch {
-        // Outer catch for setup errors (like loadConfig) or re-thrown errors from the loop
-        // The specific error details for a file operation would have been logged by the inner catch.
-        // This block provides a general failure message and ensures the process exits with an error code.
-        console.error(chalk.red('\n-----------------------------------------------------'));
-        console.error(chalk.red('Content pull failed due to an error. See details above.'));
-        // error.message from the re-thrown error will be implicitly part of the error object logged by some environments,
-        // or if you add console.error(error) here.
-        // The original code logged error.message at this level:
-        // if (error.message) console.error(chalk.red(`Underlying error: ${error.message}`));
-        console.error(chalk.red('-----------------------------------------------------'));
-        process.exit(1); // Exit with error code
-    }
-}