@contentstorage/core 1.0.2 → 1.1.1

package/dist/contentstorage-config.d.ts

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

package/dist/contentstorage-config.js

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

package/dist/index.js

@@ -1,3 +1,4 @@
+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, };
@@ -24,7 +25,7 @@ function liveEditorReady(retries = 2, delay = 3000) {
             resolve(false);
             return;
         }
-        const cdnScriptUrl = `https://cdn.contentstorage.app/live-editor.js?contentstorage-live-editor=true`;
+        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');

package/dist/lib/contentManagement.d.ts

@@ -1,6 +1,6 @@
 import { AppConfig, ContentStructure, GetImageReturn, GetTextReturn, GetVariationReturn, LanguageCode } from '../types.js';
 export declare let activeContent: object | null;
-export declare let appConfig: Pick<AppConfig, 'contentKey' | 'languageCodes'> | 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.

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

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

package/dist/lib/functions/fetchContent.js

@@ -1,8 +1,10 @@
 import axios from 'axios';
 import { CONTENTSTORAGE_CONFIG } from '../../contentstorage-config.js';
 import { appConfig, setContentLanguage } from '../contentManagement.js';
-export async function fetchContent(language) {
+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`);
@@ -10,11 +12,29 @@ export async function fetchContent(language) {
     if (!appConfig) {
         throw Error(`No app config found`);
     }
-    const fileUrl = `${CONTENTSTORAGE_CONFIG.BASE_URL}/${appConfig.contentKey}/content/${languageToFetch}.json`;
+    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,
+        };
+    }
+    else {
+        fileUrl = `${CONTENTSTORAGE_CONFIG.BASE_URL}/${effectiveContentKey}/content/${languageToFetch}.json`;
+    }
     try {
         // Fetch data for the current language
-        const response = await axios.get(fileUrl);
-        const jsonData = response.data;
+        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}.`);
         }

package/dist/scripts/generate-types.js

@@ -17,7 +17,10 @@ export async function generateTypes() {
         if (arg.startsWith('--')) {
             const key = arg.substring(2);
             const value = args[i + 1];
-            if (value && !value.startsWith('--')) {
+            if (key === 'pending-changes') {
+                cliConfig.pendingChanges = true;
+            }
+            else if (value && !value.startsWith('--')) {
                 if (key === 'lang') {
                     cliConfig.languageCodes = [value.toUpperCase()];
                 }
@@ -103,12 +106,26 @@ export async function generateTypes() {
             if (!config.contentKey) {
                 throw new Error('Cannot generate types: contentKey is missing');
             }
-            const fileUrl = `${CONTENTSTORAGE_CONFIG.BASE_URL}/${config.contentKey}/content/${firstLanguageCode}.json`; // Adjust URL construction if necessary
+            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, { responseType: 'json' });
-                const jsonResponse = response.data;
+                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) {

package/dist/scripts/pull-content.js

@@ -7,13 +7,48 @@ import { loadConfig } from '../lib/configLoader.js';
 import { CONTENTSTORAGE_CONFIG } from '../contentstorage-config.js';
 export async function pullContent() {
     console.log(chalk.blue('Starting content pull...'));
-    // Load configuration (assuming this function is defined elsewhere and works)
-    const config = await loadConfig();
+    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 {
@@ -30,15 +65,29 @@ export async function pullContent() {
         await fs.mkdir(config.contentDir, { recursive: true });
         // Process each language code
         for (const languageCode of config.languageCodes) {
-            const fileUrl = `${CONTENTSTORAGE_CONFIG.BASE_URL}/${config.contentKey}/content/${languageCode}.json`;
+            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);
-                const jsonData = response.data;
+                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}.`);

package/dist/types.d.ts

@@ -3,6 +3,7 @@ export type AppConfig = {
     contentKey: string;
     contentDir: string;
     typesOutputFile: string;
+    pendingChanges?: 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';
 /**
@@ -11,14 +12,6 @@ export type LanguageCode = 'SQ' | 'BE' | 'BS' | 'BG' | 'HR' | 'CS' | 'DA' | 'NL'
  * consumers enable type-safe autocompletion for localization path strings
  * used with functions like `getText`.
  *
- * @example
- * // In consumer's project (e.g., in a .d.ts file):
- * import 'your-library-name'; // Your library's package name
- * import type { RootContentItem as AppSpecificRootItem } from './generated_content_types';
- *
- * declare module 'your-library-name' {
- * export interface ContentStructure extends AppSpecificRootItem {}
- * }
  */
 export interface ContentStructure {
 }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@contentstorage/core",
   "author": "Kaido Hussar <kaidohus@gmail.com>",
   "homepage": "https://contentstorage.app",
-  "version": "1.0.2",
+  "version": "1.1.1",
   "type": "module",
   "description": "Fetch content from contentstorage and generate TypeScript types",
   "module": "dist/index.js",
@@ -45,6 +45,9 @@
   "engines": {
     "node": ">=18.0.0"
   },
+  "sideEffects": [
+    "./dist/index.js"
+  ],
   "publishConfig": {
     "access": "public"
   },