@contentstorage/i18next-plugin 1.0.1

package/dist/index.js

@@ -0,0 +1,391 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Checks if the code is running in a browser environment
+ */
+function isBrowser() {
+    return typeof window !== 'undefined' && typeof document !== 'undefined';
+}
+/**
+ * Gets the ContentStorage window object with type safety
+ */
+function getContentStorageWindow() {
+    if (!isBrowser())
+        return null;
+    return window;
+}
+/**
+ * Detects if the application is running in ContentStorage live editor mode
+ *
+ * @param liveEditorParam - Query parameter name to check
+ * @param forceLiveMode - Force live mode regardless of environment
+ * @returns true if in live editor mode
+ */
+function detectLiveEditorMode(liveEditorParam = 'contentstorage_live_editor', forceLiveMode = false) {
+    if (forceLiveMode)
+        return true;
+    if (!isBrowser())
+        return false;
+    try {
+        const win = getContentStorageWindow();
+        if (!win)
+            return false;
+        // Check 1: Running in an iframe
+        const inIframe = win.self !== win.top;
+        // Check 2: URL has the live editor marker
+        const urlParams = new URLSearchParams(win.location.search);
+        const hasMarker = urlParams.has(liveEditorParam);
+        return !!(inIframe && hasMarker);
+    }
+    catch (e) {
+        // Cross-origin restrictions might block window.top access
+        // This is expected when not in live editor mode
+        return false;
+    }
+}
+/**
+ * Initializes the global memory map if it doesn't exist
+ */
+function initializeMemoryMap() {
+    const win = getContentStorageWindow();
+    if (!win)
+        return null;
+    if (!win.memoryMap) {
+        win.memoryMap = new Map();
+    }
+    return win.memoryMap;
+}
+/**
+ * Gets the global memory map
+ */
+function getMemoryMap() {
+    const win = getContentStorageWindow();
+    return (win === null || win === void 0 ? void 0 : win.memoryMap) || null;
+}
+/**
+ * Normalizes i18next key format to consistent dot notation
+ * Converts namespace:key format to namespace.key
+ *
+ * @param key - The translation key
+ * @param namespace - Optional namespace
+ * @returns Normalized key in dot notation
+ */
+function normalizeKey(key, namespace) {
+    let normalizedKey = key;
+    // Convert colon notation to dot notation
+    if (normalizedKey.includes(':')) {
+        normalizedKey = normalizedKey.replace(':', '.');
+    }
+    // Prepend namespace if provided and not already in key
+    if (namespace && !normalizedKey.startsWith(`${namespace}.`)) {
+        normalizedKey = `${namespace}.${normalizedKey}`;
+    }
+    return normalizedKey;
+}
+/**
+ * Tracks a translation in the memory map
+ *
+ * @param translationValue - The actual translated text
+ * @param translationKey - The content ID (i18next key)
+ * @param namespace - Optional namespace
+ * @param language - Optional language code
+ * @param debug - Enable debug logging
+ */
+function trackTranslation(translationValue, translationKey, namespace, language, debug = false) {
+    const memoryMap = getMemoryMap();
+    if (!memoryMap)
+        return;
+    // Normalize the key
+    const normalizedKey = normalizeKey(translationKey, namespace);
+    // Get or create entry
+    const existingEntry = memoryMap.get(translationValue);
+    const idSet = existingEntry ? existingEntry.ids : new Set();
+    idSet.add(normalizedKey);
+    const entry = {
+        ids: idSet,
+        type: 'text',
+        metadata: {
+            namespace,
+            language,
+            trackedAt: Date.now(),
+        },
+    };
+    memoryMap.set(translationValue, entry);
+    if (debug) {
+        console.log('[ContentStorage] Tracked translation:', {
+            value: translationValue,
+            key: normalizedKey,
+            namespace,
+            language,
+        });
+    }
+}
+/**
+ * Cleans up old entries from memory map when size exceeds limit
+ * Removes oldest entries first (based on trackedAt timestamp)
+ *
+ * @param maxSize - Maximum number of entries to keep
+ */
+function cleanupMemoryMap(maxSize) {
+    const memoryMap = getMemoryMap();
+    if (!memoryMap || memoryMap.size <= maxSize)
+        return;
+    // Convert to array with timestamps
+    const entries = Array.from(memoryMap.entries()).map(([key, value]) => {
+        var _a;
+        return ({
+            key,
+            value,
+            timestamp: ((_a = value.metadata) === null || _a === void 0 ? void 0 : _a.trackedAt) || 0,
+        });
+    });
+    // Sort by timestamp (oldest first)
+    entries.sort((a, b) => a.timestamp - b.timestamp);
+    // Calculate how many to remove
+    const toRemove = memoryMap.size - maxSize;
+    // Remove oldest entries
+    for (let i = 0; i < toRemove; i++) {
+        memoryMap.delete(entries[i].key);
+    }
+}
+/**
+ * Deeply traverses a translation object and extracts all string values with their keys
+ *
+ * @param obj - Translation object to traverse
+ * @param prefix - Current key prefix (for nested objects)
+ * @returns Array of [key, value] pairs
+ */
+function flattenTranslations(obj, prefix = '') {
+    const results = [];
+    for (const key in obj) {
+        if (!Object.prototype.hasOwnProperty.call(obj, key))
+            continue;
+        const value = obj[key];
+        const fullKey = prefix ? `${prefix}.${key}` : key;
+        if (typeof value === 'string') {
+            results.push([fullKey, value]);
+        }
+        else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            // Recurse into nested objects
+            results.push(...flattenTranslations(value, fullKey));
+        }
+    }
+    return results;
+}
+/**
+ * Debug helper to log memory map contents
+ */
+function debugMemoryMap() {
+    const memoryMap = getMemoryMap();
+    if (!memoryMap) {
+        console.log('[ContentStorage] Memory map not initialized');
+        return;
+    }
+    console.log('[ContentStorage] Memory map contents:');
+    console.log(`Total entries: ${memoryMap.size}`);
+    const entries = Array.from(memoryMap.entries()).slice(0, 10);
+    console.table(entries.map(([value, entry]) => {
+        var _a;
+        return ({
+            value: value.substring(0, 50),
+            keys: Array.from(entry.ids).join(', '),
+            namespace: ((_a = entry.metadata) === null || _a === void 0 ? void 0 : _a.namespace) || 'N/A',
+        });
+    }));
+    if (memoryMap.size > 10) {
+        console.log(`... and ${memoryMap.size - 10} more entries`);
+    }
+}
+
+/**
+ * ContentStorage i18next Backend Plugin
+ *
+ * This plugin enables translation tracking for the ContentStorage live editor
+ * by maintaining a memory map of translations and their keys.
+ *
+ * Features:
+ * - Automatic live editor mode detection
+ * - Translation tracking with memory map
+ * - Support for nested translations
+ * - Memory management with size limits
+ * - Custom CDN or load path support
+ *
+ * @example
+ * ```typescript
+ * import i18next from 'i18next';
+ * import ContentStorageBackend from '@contentstorage/i18next-plugin';
+ *
+ * i18next
+ *   .use(ContentStorageBackend)
+ *   .init({
+ *     backend: {
+ *       contentKey: 'your-content-key',
+ *       debug: true
+ *     }
+ *   });
+ * ```
+ */
+class ContentStorageBackend {
+    constructor(_services, options, _i18nextOptions) {
+        this.type = 'backend';
+        this.isLiveMode = false;
+        this.options = options || {};
+        // Initialize if services and i18nextOptions are provided
+        // This allows i18next to initialize the plugin automatically
+        if (_services && _i18nextOptions) {
+            this.init(_services, options, _i18nextOptions);
+        }
+    }
+    /**
+     * Initialize the plugin
+     * Called by i18next during initialization
+     */
+    init(services, backendOptions = {}, i18nextOptions = {}) {
+        this.options = {
+            cdnBaseUrl: 'https://cdn.contentstorage.app',
+            debug: false,
+            maxMemoryMapSize: 10000,
+            liveEditorParam: 'contentstorage_live_editor',
+            forceLiveMode: false,
+            ...backendOptions,
+        };
+        // Detect live editor mode
+        this.isLiveMode = detectLiveEditorMode(this.options.liveEditorParam, this.options.forceLiveMode);
+        if (this.isLiveMode) {
+            // Initialize memory map
+            initializeMemoryMap();
+            if (this.options.debug) {
+                console.log('[ContentStorage] Live editor mode enabled');
+                console.log('[ContentStorage] Plugin initialized with options:', this.options);
+            }
+        }
+        else if (this.options.debug) {
+            console.log('[ContentStorage] Running in normal mode (not live editor)');
+        }
+    }
+    /**
+     * Read translations for a given language and namespace
+     * This is the main method called by i18next to load translations
+     */
+    read(language, namespace, callback) {
+        if (this.options.debug) {
+            console.log(`[ContentStorage] Loading translations: ${language}/${namespace}`);
+        }
+        this.loadTranslations(language, namespace)
+            .then((translations) => {
+            // Track translations if in live mode
+            if (this.isLiveMode && this.shouldTrackNamespace(namespace)) {
+                this.trackTranslations(translations, namespace, language);
+                // Cleanup if needed
+                if (this.options.maxMemoryMapSize) {
+                    cleanupMemoryMap(this.options.maxMemoryMapSize);
+                }
+            }
+            callback(null, translations);
+        })
+            .catch((error) => {
+            if (this.options.debug) {
+                console.error('[ContentStorage] Failed to load translations:', error);
+            }
+            callback(error, false);
+        });
+    }
+    /**
+     * Load translations from CDN or custom source
+     */
+    async loadTranslations(language, namespace) {
+        const url = this.getLoadPath(language, namespace);
+        if (this.options.debug) {
+            console.log(`[ContentStorage] Fetching from: ${url}`);
+        }
+        try {
+            const fetchFn = this.options.request || this.defaultFetch.bind(this);
+            return await fetchFn(url, {
+                method: 'GET',
+                headers: {
+                    'Accept': 'application/json',
+                },
+            });
+        }
+        catch (error) {
+            if (this.options.debug) {
+                console.error('[ContentStorage] Fetch error:', error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Default fetch implementation
+     */
+    async defaultFetch(url, options) {
+        const response = await fetch(url, options);
+        if (!response.ok) {
+            throw new Error(`Failed to load translations: ${response.status} ${response.statusText}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get the URL to load translations from
+     */
+    getLoadPath(language, namespace) {
+        const { loadPath, cdnBaseUrl, contentKey } = this.options;
+        // Custom load path function
+        if (typeof loadPath === 'function') {
+            return loadPath(language, namespace);
+        }
+        // Custom load path string with interpolation
+        if (typeof loadPath === 'string') {
+            return loadPath
+                .replace('{{lng}}', language)
+                .replace('{{ns}}', namespace);
+        }
+        // Default CDN path
+        if (!contentKey) {
+            throw new Error('[ContentStorage] contentKey is required when using default CDN path');
+        }
+        return `${cdnBaseUrl}/${contentKey}/content/${language}/${namespace}.json`;
+    }
+    /**
+     * Check if a namespace should be tracked
+     */
+    shouldTrackNamespace(namespace) {
+        const { trackNamespaces } = this.options;
+        // If no filter specified, track all namespaces
+        if (!trackNamespaces || trackNamespaces.length === 0) {
+            return true;
+        }
+        return trackNamespaces.includes(namespace);
+    }
+    /**
+     * Track all translations in the loaded data
+     */
+    trackTranslations(translations, namespace, language) {
+        if (!isBrowser())
+            return;
+        const flatTranslations = flattenTranslations(translations);
+        for (const [key, value] of flatTranslations) {
+            // Skip empty values
+            if (!value)
+                continue;
+            trackTranslation(value, key, namespace, language, this.options.debug);
+        }
+        if (this.options.debug) {
+            console.log(`[ContentStorage] Tracked ${flatTranslations.length} translations for ${namespace}`);
+        }
+    }
+}
+ContentStorageBackend.type = 'backend';
+/**
+ * Create a new instance of the ContentStorage backend
+ */
+function createContentStorageBackend(options) {
+    return new ContentStorageBackend(undefined, options);
+}
+
+exports.ContentStorageBackend = ContentStorageBackend;
+exports.createContentStorageBackend = createContentStorageBackend;
+exports.debugMemoryMap = debugMemoryMap;
+exports.default = ContentStorageBackend;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/utils.ts","../src/plugin.ts"],"sourcesContent":["import type { ContentStorageWindow, MemoryMap, MemoryMapEntry } from './types';\n\n/**\n * Checks if the code is running in a browser environment\n */\nexport function isBrowser(): boolean {\n  return typeof window !== 'undefined' && typeof document !== 'undefined';\n}\n\n/**\n * Gets the ContentStorage window object with type safety\n */\nexport function getContentStorageWindow(): ContentStorageWindow | null {\n  if (!isBrowser()) return null;\n  return window as ContentStorageWindow;\n}\n\n/**\n * Detects if the application is running in ContentStorage live editor mode\n *\n * @param liveEditorParam - Query parameter name to check\n * @param forceLiveMode - Force live mode regardless of environment\n * @returns true if in live editor mode\n */\nexport function detectLiveEditorMode(\n  liveEditorParam: string = 'contentstorage_live_editor',\n  forceLiveMode: boolean = false\n): boolean {\n  if (forceLiveMode) return true;\n  if (!isBrowser()) return false;\n\n  try {\n    const win = getContentStorageWindow();\n    if (!win) return false;\n\n    // Check 1: Running in an iframe\n    const inIframe = win.self !== win.top;\n\n    // Check 2: URL has the live editor marker\n    const urlParams = new URLSearchParams(win.location.search);\n    const hasMarker = urlParams.has(liveEditorParam);\n\n    return !!(inIframe && hasMarker);\n  } catch (e) {\n    // Cross-origin restrictions might block window.top access\n    // This is expected when not in live editor mode\n    return false;\n  }\n}\n\n/**\n * Initializes the global memory map if it doesn't exist\n */\nexport function initializeMemoryMap(): MemoryMap | null {\n  const win = getContentStorageWindow();\n  if (!win) return null;\n\n  if (!win.memoryMap) {\n    win.memoryMap = new Map<string, MemoryMapEntry>();\n  }\n\n  return win.memoryMap;\n}\n\n/**\n * Gets the global memory map\n */\nexport function getMemoryMap(): MemoryMap | null {\n  const win = getContentStorageWindow();\n  return win?.memoryMap || null;\n}\n\n/**\n * Normalizes i18next key format to consistent dot notation\n * Converts namespace:key format to namespace.key\n *\n * @param key - The translation key\n * @param namespace - Optional namespace\n * @returns Normalized key in dot notation\n */\nexport function normalizeKey(key: string, namespace?: string): string {\n  let normalizedKey = key;\n\n  // Convert colon notation to dot notation\n  if (normalizedKey.includes(':')) {\n    normalizedKey = normalizedKey.replace(':', '.');\n  }\n\n  // Prepend namespace if provided and not already in key\n  if (namespace && !normalizedKey.startsWith(`${namespace}.`)) {\n    normalizedKey = `${namespace}.${normalizedKey}`;\n  }\n\n  return normalizedKey;\n}\n\n/**\n * Extracts the base translation key without interpolation context\n * Handles plural forms, contexts, and other i18next features\n *\n * Examples:\n * - 'welcome' -> 'welcome'\n * - 'items_plural' -> 'items'\n * - 'friend_male' -> 'friend'\n *\n * @param key - The translation key\n * @returns Base key without suffixes\n */\nexport function extractBaseKey(key: string): string {\n  // Remove plural suffixes (_zero, _one, _two, _few, _many, _other, _plural)\n  let baseKey = key.replace(/_(zero|one|two|few|many|other|plural)$/, '');\n\n  // Remove context suffixes (anything after last underscore that's not a nested key)\n  // Be careful not to remove underscores that are part of the actual key\n  // This is a heuristic - contexts usually come at the end\n  const lastUnderscore = baseKey.lastIndexOf('_');\n  if (lastUnderscore > 0) {\n    // Only remove if it looks like a context (short suffix, typically lowercase)\n    const suffix = baseKey.substring(lastUnderscore + 1);\n    if (suffix.length < 10 && suffix.toLowerCase() === suffix) {\n      // This might be a context, but we'll keep it for now to avoid false positives\n      // Real context handling should be done at a higher level\n    }\n  }\n\n  return baseKey;\n}\n\n/**\n * Removes interpolation variables from a translated string\n *\n * Examples:\n * - 'Hello {{name}}!' -> 'Hello !'\n * - 'You have {{count}} items' -> 'You have  items'\n *\n * @param value - The translated string\n * @returns String with interpolations removed\n */\nexport function removeInterpolation(value: string): string {\n  // Remove i18next interpolation syntax: {{variable}}\n  return value.replace(/\\{\\{[^}]+\\}\\}/g, '').trim();\n}\n\n/**\n * Tracks a translation in the memory map\n *\n * @param translationValue - The actual translated text\n * @param translationKey - The content ID (i18next key)\n * @param namespace - Optional namespace\n * @param language - Optional language code\n * @param debug - Enable debug logging\n */\nexport function trackTranslation(\n  translationValue: string,\n  translationKey: string,\n  namespace?: string,\n  language?: string,\n  debug: boolean = false\n): void {\n  const memoryMap = getMemoryMap();\n  if (!memoryMap) return;\n\n  // Normalize the key\n  const normalizedKey = normalizeKey(translationKey, namespace);\n\n  // Get or create entry\n  const existingEntry = memoryMap.get(translationValue);\n  const idSet = existingEntry ? existingEntry.ids : new Set<string>();\n  idSet.add(normalizedKey);\n\n  const entry: MemoryMapEntry = {\n    ids: idSet,\n    type: 'text',\n    metadata: {\n      namespace,\n      language,\n      trackedAt: Date.now(),\n    },\n  };\n\n  memoryMap.set(translationValue, entry);\n\n  if (debug) {\n    console.log('[ContentStorage] Tracked translation:', {\n      value: translationValue,\n      key: normalizedKey,\n      namespace,\n      language,\n    });\n  }\n}\n\n/**\n * Cleans up old entries from memory map when size exceeds limit\n * Removes oldest entries first (based on trackedAt timestamp)\n *\n * @param maxSize - Maximum number of entries to keep\n */\nexport function cleanupMemoryMap(maxSize: number): void {\n  const memoryMap = getMemoryMap();\n  if (!memoryMap || memoryMap.size <= maxSize) return;\n\n  // Convert to array with timestamps\n  const entries = Array.from(memoryMap.entries()).map(([key, value]) => ({\n    key,\n    value,\n    timestamp: value.metadata?.trackedAt || 0,\n  }));\n\n  // Sort by timestamp (oldest first)\n  entries.sort((a, b) => a.timestamp - b.timestamp);\n\n  // Calculate how many to remove\n  const toRemove = memoryMap.size - maxSize;\n\n  // Remove oldest entries\n  for (let i = 0; i < toRemove; i++) {\n    memoryMap.delete(entries[i].key);\n  }\n}\n\n/**\n * Deeply traverses a translation object and extracts all string values with their keys\n *\n * @param obj - Translation object to traverse\n * @param prefix - Current key prefix (for nested objects)\n * @returns Array of [key, value] pairs\n */\nexport function flattenTranslations(\n  obj: any,\n  prefix: string = ''\n): Array<[string, string]> {\n  const results: Array<[string, string]> = [];\n\n  for (const key in obj) {\n    if (!Object.prototype.hasOwnProperty.call(obj, key)) continue;\n\n    const value = obj[key];\n    const fullKey = prefix ? `${prefix}.${key}` : key;\n\n    if (typeof value === 'string') {\n      results.push([fullKey, value]);\n    } else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {\n      // Recurse into nested objects\n      results.push(...flattenTranslations(value, fullKey));\n    }\n  }\n\n  return results;\n}\n\n/**\n * Debug helper to log memory map contents\n */\nexport function debugMemoryMap(): void {\n  const memoryMap = getMemoryMap();\n  if (!memoryMap) {\n    console.log('[ContentStorage] Memory map not initialized');\n    return;\n  }\n\n  console.log('[ContentStorage] Memory map contents:');\n  console.log(`Total entries: ${memoryMap.size}`);\n\n  const entries = Array.from(memoryMap.entries()).slice(0, 10);\n  console.table(\n    entries.map(([value, entry]) => ({\n      value: value.substring(0, 50),\n      keys: Array.from(entry.ids).join(', '),\n      namespace: entry.metadata?.namespace || 'N/A',\n    }))\n  );\n\n  if (memoryMap.size > 10) {\n    console.log(`... and ${memoryMap.size - 10} more entries`);\n  }\n}\n","import type {\n  BackendModule,\n  ReadCallback,\n  Services,\n  InitOptions,\n} from 'i18next';\nimport type {\n  ContentStoragePluginOptions,\n  TranslationData,\n} from './types';\nimport {\n  detectLiveEditorMode,\n  initializeMemoryMap,\n  trackTranslation,\n  cleanupMemoryMap,\n  flattenTranslations,\n  isBrowser,\n} from './utils';\n\n/**\n * ContentStorage i18next Backend Plugin\n *\n * This plugin enables translation tracking for the ContentStorage live editor\n * by maintaining a memory map of translations and their keys.\n *\n * Features:\n * - Automatic live editor mode detection\n * - Translation tracking with memory map\n * - Support for nested translations\n * - Memory management with size limits\n * - Custom CDN or load path support\n *\n * @example\n * ```typescript\n * import i18next from 'i18next';\n * import ContentStorageBackend from '@contentstorage/i18next-plugin';\n *\n * i18next\n *   .use(ContentStorageBackend)\n *   .init({\n *     backend: {\n *       contentKey: 'your-content-key',\n *       debug: true\n *     }\n *   });\n * ```\n */\nexport class ContentStorageBackend implements BackendModule<ContentStoragePluginOptions> {\n  static type: 'backend' = 'backend';\n  type: 'backend' = 'backend';\n\n  private options: ContentStoragePluginOptions;\n  private isLiveMode: boolean = false;\n\n  constructor(_services?: Services, options?: ContentStoragePluginOptions, _i18nextOptions?: InitOptions) {\n    this.options = options || {};\n\n    // Initialize if services and i18nextOptions are provided\n    // This allows i18next to initialize the plugin automatically\n    if (_services && _i18nextOptions) {\n      this.init(_services, options, _i18nextOptions);\n    }\n  }\n\n  /**\n   * Initialize the plugin\n   * Called by i18next during initialization\n   */\n  init(\n    services: Services,\n    backendOptions: ContentStoragePluginOptions = {},\n    i18nextOptions: InitOptions = {}\n  ): void {\n    // Store services and i18nextOptions for potential future use\n    // Note: Currently not used but kept in signature for i18next compatibility\n    void services;\n    void i18nextOptions;\n\n    this.options = {\n      cdnBaseUrl: 'https://cdn.contentstorage.app',\n      debug: false,\n      maxMemoryMapSize: 10000,\n      liveEditorParam: 'contentstorage_live_editor',\n      forceLiveMode: false,\n      ...backendOptions,\n    };\n\n    // Detect live editor mode\n    this.isLiveMode = detectLiveEditorMode(\n      this.options.liveEditorParam,\n      this.options.forceLiveMode\n    );\n\n    if (this.isLiveMode) {\n      // Initialize memory map\n      initializeMemoryMap();\n\n      if (this.options.debug) {\n        console.log('[ContentStorage] Live editor mode enabled');\n        console.log('[ContentStorage] Plugin initialized with options:', this.options);\n      }\n    } else if (this.options.debug) {\n      console.log('[ContentStorage] Running in normal mode (not live editor)');\n    }\n  }\n\n  /**\n   * Read translations for a given language and namespace\n   * This is the main method called by i18next to load translations\n   */\n  read(\n    language: string,\n    namespace: string,\n    callback: ReadCallback\n  ): void {\n    if (this.options.debug) {\n      console.log(`[ContentStorage] Loading translations: ${language}/${namespace}`);\n    }\n\n    this.loadTranslations(language, namespace)\n      .then((translations) => {\n        // Track translations if in live mode\n        if (this.isLiveMode && this.shouldTrackNamespace(namespace)) {\n          this.trackTranslations(translations, namespace, language);\n\n          // Cleanup if needed\n          if (this.options.maxMemoryMapSize) {\n            cleanupMemoryMap(this.options.maxMemoryMapSize);\n          }\n        }\n\n        callback(null, translations);\n      })\n      .catch((error) => {\n        if (this.options.debug) {\n          console.error('[ContentStorage] Failed to load translations:', error);\n        }\n        callback(error, false);\n      });\n  }\n\n  /**\n   * Load translations from CDN or custom source\n   */\n  private async loadTranslations(\n    language: string,\n    namespace: string\n  ): Promise<TranslationData> {\n    const url = this.getLoadPath(language, namespace);\n\n    if (this.options.debug) {\n      console.log(`[ContentStorage] Fetching from: ${url}`);\n    }\n\n    try {\n      const fetchFn = this.options.request || this.defaultFetch.bind(this);\n      return await fetchFn(url, {\n        method: 'GET',\n        headers: {\n          'Accept': 'application/json',\n        },\n      });\n    } catch (error) {\n      if (this.options.debug) {\n        console.error('[ContentStorage] Fetch error:', error);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Default fetch implementation\n   */\n  private async defaultFetch(url: string, options: RequestInit): Promise<any> {\n    const response = await fetch(url, options);\n\n    if (!response.ok) {\n      throw new Error(\n        `Failed to load translations: ${response.status} ${response.statusText}`\n      );\n    }\n\n    return response.json();\n  }\n\n  /**\n   * Get the URL to load translations from\n   */\n  private getLoadPath(language: string, namespace: string): string {\n    const { loadPath, cdnBaseUrl, contentKey } = this.options;\n\n    // Custom load path function\n    if (typeof loadPath === 'function') {\n      return loadPath(language, namespace);\n    }\n\n    // Custom load path string with interpolation\n    if (typeof loadPath === 'string') {\n      return loadPath\n        .replace('{{lng}}', language)\n        .replace('{{ns}}', namespace);\n    }\n\n    // Default CDN path\n    if (!contentKey) {\n      throw new Error(\n        '[ContentStorage] contentKey is required when using default CDN path'\n      );\n    }\n\n    return `${cdnBaseUrl}/${contentKey}/content/${language}/${namespace}.json`;\n  }\n\n  /**\n   * Check if a namespace should be tracked\n   */\n  private shouldTrackNamespace(namespace: string): boolean {\n    const { trackNamespaces } = this.options;\n\n    // If no filter specified, track all namespaces\n    if (!trackNamespaces || trackNamespaces.length === 0) {\n      return true;\n    }\n\n    return trackNamespaces.includes(namespace);\n  }\n\n  /**\n   * Track all translations in the loaded data\n   */\n  private trackTranslations(\n    translations: TranslationData,\n    namespace: string,\n    language: string\n  ): void {\n    if (!isBrowser()) return;\n\n    const flatTranslations = flattenTranslations(translations);\n\n    for (const [key, value] of flatTranslations) {\n      // Skip empty values\n      if (!value) continue;\n\n      trackTranslation(\n        value,\n        key,\n        namespace,\n        language,\n        this.options.debug\n      );\n    }\n\n    if (this.options.debug) {\n      console.log(\n        `[ContentStorage] Tracked ${flatTranslations.length} translations for ${namespace}`\n      );\n    }\n  }\n}\n\n/**\n * Create a new instance of the ContentStorage backend\n */\nexport function createContentStorageBackend(\n  options?: ContentStoragePluginOptions\n): ContentStorageBackend {\n  return new ContentStorageBackend(undefined, options);\n}\n\n// Default export\nexport default ContentStorageBackend;\n"],"names":[],"mappings":"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"}

package/dist/plugin.d.ts

@@ -0,0 +1,73 @@
+import type { BackendModule, ReadCallback, Services, InitOptions } from 'i18next';
+import type { ContentStoragePluginOptions } from './types';
+/**
+ * ContentStorage i18next Backend Plugin
+ *
+ * This plugin enables translation tracking for the ContentStorage live editor
+ * by maintaining a memory map of translations and their keys.
+ *
+ * Features:
+ * - Automatic live editor mode detection
+ * - Translation tracking with memory map
+ * - Support for nested translations
+ * - Memory management with size limits
+ * - Custom CDN or load path support
+ *
+ * @example
+ * ```typescript
+ * import i18next from 'i18next';
+ * import ContentStorageBackend from '@contentstorage/i18next-plugin';
+ *
+ * i18next
+ *   .use(ContentStorageBackend)
+ *   .init({
+ *     backend: {
+ *       contentKey: 'your-content-key',
+ *       debug: true
+ *     }
+ *   });
+ * ```
+ */
+export declare class ContentStorageBackend implements BackendModule<ContentStoragePluginOptions> {
+    static type: 'backend';
+    type: 'backend';
+    private options;
+    private isLiveMode;
+    constructor(_services?: Services, options?: ContentStoragePluginOptions, _i18nextOptions?: InitOptions);
+    /**
+     * Initialize the plugin
+     * Called by i18next during initialization
+     */
+    init(services: Services, backendOptions?: ContentStoragePluginOptions, i18nextOptions?: InitOptions): void;
+    /**
+     * Read translations for a given language and namespace
+     * This is the main method called by i18next to load translations
+     */
+    read(language: string, namespace: string, callback: ReadCallback): void;
+    /**
+     * Load translations from CDN or custom source
+     */
+    private loadTranslations;
+    /**
+     * Default fetch implementation
+     */
+    private defaultFetch;
+    /**
+     * Get the URL to load translations from
+     */
+    private getLoadPath;
+    /**
+     * Check if a namespace should be tracked
+     */
+    private shouldTrackNamespace;
+    /**
+     * Track all translations in the loaded data
+     */
+    private trackTranslations;
+}
+/**
+ * Create a new instance of the ContentStorage backend
+ */
+export declare function createContentStorageBackend(options?: ContentStoragePluginOptions): ContentStorageBackend;
+export default ContentStorageBackend;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,WAAW,EACZ,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EACV,2BAA2B,EAE5B,MAAM,SAAS,CAAC;AAUjB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,qBAAsB,YAAW,aAAa,CAAC,2BAA2B,CAAC;IACtF,MAAM,CAAC,IAAI,EAAE,SAAS,CAAa;IACnC,IAAI,EAAE,SAAS,CAAa;IAE5B,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,UAAU,CAAkB;gBAExB,SAAS,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,2BAA2B,EAAE,eAAe,CAAC,EAAE,WAAW;IAUtG;;;OAGG;IACH,IAAI,CACF,QAAQ,EAAE,QAAQ,EAClB,cAAc,GAAE,2BAAgC,EAChD,cAAc,GAAE,WAAgB,GAC/B,IAAI;IAkCP;;;OAGG;IACH,IAAI,CACF,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,YAAY,GACrB,IAAI;IA2BP;;OAEG;YACW,gBAAgB;IA0B9B;;OAEG;YACW,YAAY;IAY1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAyBnB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA4B1B;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,CAAC,EAAE,2BAA2B,GACpC,qBAAqB,CAEvB;AAGD,eAAe,qBAAqB,CAAC"}

package/dist/post-processor.d.ts

@@ -0,0 +1,42 @@
+import type { PostProcessorModule } from 'i18next';
+import type { ContentStoragePluginOptions } from './types';
+/**
+ * ContentStorage Post-Processor
+ *
+ * This post-processor tracks translations at the point of resolution,
+ * capturing the actual values returned by i18next including interpolations
+ * and plural forms.
+ *
+ * Use this in addition to or instead of the backend plugin for more
+ * comprehensive tracking, especially for dynamic translations.
+ *
+ * @example
+ * ```typescript
+ * import i18next from 'i18next';
+ * import { ContentStoragePostProcessor } from '@contentstorage/i18next-plugin';
+ *
+ * i18next
+ *   .use(new ContentStoragePostProcessor({ debug: true }))
+ *   .init({
+ *     // ... your config
+ *   });
+ * ```
+ */
+export declare class ContentStoragePostProcessor implements PostProcessorModule {
+    static type: 'postProcessor';
+    type: 'postProcessor';
+    name: string;
+    private options;
+    private isLiveMode;
+    constructor(options?: ContentStoragePluginOptions);
+    /**
+     * Process the translated value
+     * Called by i18next after translation resolution
+     */
+    process(value: string, key: string | string[], options: any, translator: any): string;
+}
+/**
+ * Create a new instance of the ContentStorage post-processor
+ */
+export declare function createContentStoragePostProcessor(options?: ContentStoragePluginOptions): ContentStoragePostProcessor;
+//# sourceMappingURL=post-processor.d.ts.map

package/dist/post-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-processor.d.ts","sourceRoot":"","sources":["../src/post-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAG3D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,2BAA4B,YAAW,mBAAmB;IACrE,MAAM,CAAC,IAAI,EAAE,eAAe,CAAmB;IAC/C,IAAI,EAAE,eAAe,CAAmB;IACxC,IAAI,EAAE,MAAM,CAA2B;IAEvC,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,UAAU,CAAkB;gBAExB,OAAO,GAAE,2BAAgC;IAuBrD;;;OAGG;IACH,OAAO,CACL,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EACtB,OAAO,EAAE,GAAG,EACZ,UAAU,EAAE,GAAG,GACd,MAAM;CA+BV;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,CAAC,EAAE,2BAA2B,GACpC,2BAA2B,CAE7B"}

package/dist/types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Entry in the memory map that tracks translation metadata
+ */
+export interface MemoryMapEntry {
+    /** Set of translation keys (content IDs) that map to this value */
+    ids: Set<string>;
+    /** Type of content - always 'text' for translations */
+    type: 'text';
+    /** Optional metadata for debugging */
+    metadata?: {
+        /** Namespace where this translation was found */
+        namespace?: string;
+        /** Language code */
+        language?: string;
+        /** Timestamp when tracked */
+        trackedAt?: number;
+    };
+}
+/**
+ * Global memory map for translation tracking
+ * Maps translation values to their content IDs
+ */
+export type MemoryMap = Map<string, MemoryMapEntry>;
+/**
+ * Window interface extended with ContentStorage properties
+ */
+export interface ContentStorageWindow extends Window {
+    memoryMap?: MemoryMap;
+    __contentStorageDebug?: boolean;
+}
+/**
+ * Plugin configuration options
+ */
+export interface ContentStoragePluginOptions {
+    /**
+     * Your ContentStorage content key
+     * Used to construct CDN URLs for fetching translations
+     */
+    contentKey?: string;
+    /**
+     * Custom CDN base URL
+     * @default 'https://cdn.contentstorage.app'
+     */
+    cdnBaseUrl?: string;
+    /**
+     * Enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Maximum number of entries in memoryMap
+     * When exceeded, oldest entries are removed
+     * @default 10000
+     */
+    maxMemoryMapSize?: number;
+    /**
+     * Custom function to load translations
+     * If provided, overrides the default CDN loading
+     */
+    loadPath?: string | ((language: string, namespace: string) => string);
+    /**
+     * Custom fetch implementation
+     * Useful for adding auth headers or custom logic
+     */
+    request?: (url: string, options: RequestInit) => Promise<any>;
+    /**
+     * Query parameter name for live editor detection
+     * @default 'contentstorage_live_editor'
+     */
+    liveEditorParam?: string;
+    /**
+     * Allow manual override of live editor mode
+     * Useful for testing
+     */
+    forceLiveMode?: boolean;
+    /**
+     * Namespaces to track
+     * If specified, only these namespaces will be tracked
+     * If not specified, all namespaces are tracked
+     */
+    trackNamespaces?: string[];
+}
+/**
+ * Translation data structure
+ * Can be a nested object with string values
+ */
+export type TranslationData = {
+    [key: string]: string | TranslationData;
+};
+/**
+ * Callback for i18next backend read method
+ */
+export type ReadCallback = (error: Error | null, data: TranslationData | boolean | null | undefined) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,QAAQ,CAAC,EAAE;QACT,iDAAiD;QACjD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,oBAAoB;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,6BAA6B;QAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,MAAM;IAClD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IAEtE;;;OAGG;IACH,OAAO,CAAC,EAAE,CACR,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,GAAG,CAAC,CAAC;IAElB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,eAAe,CAAC;CACzC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,IAAI,EAAE,eAAe,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,KAC/C,IAAI,CAAC"}