@contentstorage/core 0.3.27 → 0.3.29

package/dist/contentstorage-config.d.ts

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

package/dist/contentstorage-config.js

@@ -0,0 +1,3 @@
+export const CONTENTSTORAGE_CONFIG = {
+    BASE_URL: 'https://di0fmnnsdfsl2.cloudfront.net',
+};

package/dist/helpers/defineConfig.d.ts

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1,19 @@
+/**
+ * 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.js

@@ -31,7 +31,6 @@ export function flattenJson(data, prefix = '', result = {}) {
             });
         }
         else {
-            // It's an object (and not a special one that stops flattening, due to the preceding 'if' block)
             let isEmptyObject = true;
             for (const key in data) {
                 if (Object.prototype.hasOwnProperty.call(data, key)) {
@@ -48,7 +47,6 @@ export function flattenJson(data, prefix = '', result = {}) {
         }
     }
     else if (prefix) {
-        // Primitive value (string, number, boolean, null) and has a prefix
         result[prefix] = data;
     }
     // If the initial data is a primitive and prefix is empty, result remains empty.

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 import { AppConfig, LanguageCode, ContentStructure } from './types.js';
-import { setContentLanguage, getText, getImage } from './lib/contentManagement.js';
+import { setContentLanguage, getText, getImage, getVariation } from './lib/contentManagement.js';
 export { AppConfig, LanguageCode, ContentStructure };
-export { setContentLanguage, getText, getImage };
+export { setContentLanguage, getText, getImage, getVariation };

package/dist/index.js

@@ -1,2 +1,2 @@
-import { setContentLanguage, getText, getImage } from './lib/contentManagement.js';
-export { setContentLanguage, getText, getImage };
+import { setContentLanguage, getText, getImage, getVariation, } from './lib/contentManagement.js';
+export { setContentLanguage, getText, getImage, getVariation };

package/dist/lib/configLoader.js

@@ -32,14 +32,14 @@ export async function loadConfig() {
         ...userConfig,
     };
     // Validate required fields
-    if (!mergedConfig.contentUrl) {
+    if (!mergedConfig.contentKey) {
         console.error('Error: Configuration is missing the required "contentUrl" property.');
         process.exit(1); // Exit if required URL is missing
     }
     // Resolve paths relative to the user's project root (process.cwd())
     const finalConfig = {
         languageCodes: mergedConfig.languageCodes || [],
-        contentUrl: mergedConfig.contentUrl,
+        contentKey: mergedConfig.contentKey,
         contentDir: path.resolve(process.cwd(), mergedConfig.contentDir),
         typesOutputFile: path.resolve(process.cwd(), mergedConfig.typesOutputFile),
     };

package/dist/lib/contentManagement.d.ts

@@ -2,7 +2,7 @@ import { ContentStructure, ImageObject } from '../types.js';
 /**
  * Loads and sets the content for a specific language.
  * It will internally ensure the application configuration (for contentDir) is loaded.
- * @param languageCode The language code (e.g., 'EN', 'FR') for the JSON file to load.
+ * @param contentJson
  */
 export declare function setContentLanguage(contentJson: object): void;
 /**
@@ -16,8 +16,7 @@ export declare function setContentLanguage(contentJson: object): void;
  * @returns The text string from the JSON, or the fallbackValue, or undefined.
  */
 export declare function getText(pathString: keyof ContentStructure, fallbackValue?: string): string | undefined;
-export declare function getImage(pathString: string, // Using string for dynamic paths
-fallbackValue?: ImageObject): ImageObject | undefined;
+export declare function getImage(pathString: keyof ContentStructure, fallbackValue?: ImageObject): ImageObject | undefined;
 export declare function getVariation<Path extends keyof ContentStructure>(pathString: Path, variationKey?: ContentStructure[Path] extends {
     data: infer D;
 } ? keyof D : string, fallbackString?: string): string | undefined;

package/dist/lib/contentManagement.js

@@ -2,7 +2,7 @@ let activeContent = null;
 /**
  * Loads and sets the content for a specific language.
  * It will internally ensure the application configuration (for contentDir) is loaded.
- * @param languageCode The language code (e.g., 'EN', 'FR') for the JSON file to load.
+ * @param contentJson
  */
 export function setContentLanguage(contentJson) {
     if (!contentJson || typeof contentJson !== 'object') {
@@ -54,8 +54,7 @@ export function getText(pathString, fallbackValue) {
         return fallbackValue;
     }
 }
-export function getImage(pathString, // Using string for dynamic paths
-fallbackValue) {
+export function getImage(pathString, fallbackValue) {
     if (!activeContent) {
         const msg = `[Contentstorage] getImage: Content not loaded (Key: "${pathString}"). Ensure setContentLanguage() was called and completed successfully.`;
         console.warn(msg);
@@ -110,7 +109,9 @@ export function getVariation(pathString, variationKey, fallbackString) {
         typeof current.data === 'object' &&
         current.data !== null) {
         const variationObject = current;
-        if (variationKey && typeof variationKey === 'string' && variationKey in variationObject.data) {
+        if (variationKey &&
+            typeof variationKey === 'string' &&
+            variationKey in variationObject.data) {
             if (typeof variationObject.data[variationKey] === 'string') {
                 return variationObject.data[variationKey];
             }
@@ -122,7 +123,8 @@ export function getVariation(pathString, variationKey, fallbackString) {
         // 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') { // Warn if specific key was requested but default is being returned
+                if (variationKey && variationKey !== 'default') {
+                    // Warn if specific key was requested but default is being returned
                     const msg = `[Contentstorage] getVariation: Variation key "${variationKey}" not found at path "${pathString}". Returning 'default' variation.`;
                     console.warn(msg);
                 }

package/dist/scripts/generate-types.js

@@ -7,6 +7,7 @@ import jsonToTS from 'json-to-ts'; // Import the library
 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';
 export async function generateTypes() {
     console.log(chalk.blue('Starting type generation...'));
     const config = await loadConfig();
@@ -70,11 +71,10 @@ export async function generateTypes() {
             }
         }
         else {
-            // --- Fetch from URL ---
-            if (!config.contentUrl) {
-                throw new Error("Cannot generate types: 'contentDir' is not accessible or not specified, and 'contentUrl' is also missing in configuration.");
+            if (!config.contentKey) {
+                throw new Error('Cannot generate types: contentKey is missing');
             }
-            const fileUrl = `${config.contentUrl}/${firstLanguageCode}.json`; // Adjust URL construction if necessary
+            const fileUrl = `${CONTENTSTORAGE_CONFIG.BASE_URL}/${config.contentKey}/content/${firstLanguageCode}.json`; // Adjust URL construction if necessary
             dataSourceDescription = `remote URL (${fileUrl})`;
             console.log(chalk.gray(`Attempting to fetch JSON from: ${fileUrl}`));
             try {
@@ -123,10 +123,6 @@ export async function generateTypes() {
     catch (error) {
         console.error(chalk.red.bold('\nError generating TypeScript types:'));
         console.error(chalk.red(error.message));
-        // Optionally log stack for more details during development
-        // if (error.stack && process.env.NODE_ENV === 'development') {
-        //   console.error(chalk.gray(error.stack));
-        // }
         process.exit(1);
     }
 }

package/dist/scripts/pull-content.js

@@ -4,11 +4,12 @@ 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...'));
     // Load configuration (assuming this function is defined elsewhere and works)
     const config = await loadConfig();
-    console.log(chalk.gray(`Content base URL: ${config.contentUrl}`));
+    console.log(chalk.gray(`Content key: ${config.contentKey}`));
     console.log(chalk.gray(`Saving content to: ${config.contentDir}`));
     try {
         // Validate languageCodes array
@@ -24,7 +25,7 @@ export async function pullContent() {
         await fs.mkdir(config.contentDir, { recursive: true });
         // Process each language code
         for (const languageCode of config.languageCodes) {
-            const fileUrl = `${config.contentUrl}/${languageCode}.json`;
+            const 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}`));

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 export type AppConfig = {
     languageCodes: LanguageCode[];
-    contentUrl: string;
+    contentKey: string;
     contentDir: string;
     typesOutputFile: string;
 };
@@ -23,7 +23,7 @@ export type LanguageCode = 'SQ' | 'BE' | 'BS' | 'BG' | 'HR' | 'CS' | 'DA' | 'NL'
 export interface ContentStructure {
 }
 export interface ImageObject {
-    contentstorage_type: "image";
+    contentstorage_type: 'image';
     url: string;
     altText: string;
 }
@@ -31,6 +31,6 @@ export interface VariationData {
     [key: string]: string;
 }
 export interface VariationObject {
-    contentstorage_type: "variation";
+    contentstorage_type: 'variation';
     data: VariationData;
 }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@contentstorage/core",
   "author": "Kaido Hussar <kaidohus@gmail.com>",
   "homepage": "https://contentstorage.app",
-  "version": "0.3.27",
+  "version": "0.3.29",
   "type": "module",
   "description": "Fetch content from contentstorage and generate TypeScript types",
   "module": "dist/index.js",