@shipi18n/cli 1.1.5 → 2.3.0

package/src/lib/api.js

@@ -1,342 +0,0 @@
-import dotenv from 'dotenv';
-dotenv.config();
-
-const API_BASE_URL = process.env.SHIPI18N_API_URL || 'https://ydjkwckq3f.execute-api.us-east-1.amazonaws.com';
-
-/**
- * Shipi18n API Client
- */
-export class Shipi18nAPI {
-  constructor(apiKey) {
-    this.apiKey = apiKey || process.env.SHIPI18N_API_KEY;
-    this.baseUrl = API_BASE_URL;
-  }
-
-  /**
-   * Translate JSON file
-   * @param {Object} options
-   * @param {Object|string} options.json - JSON content to translate
-   * @param {string} options.sourceLanguage - Source language code
-   * @param {string[]} options.targetLanguages - Target language codes
-   * @param {boolean} options.preservePlaceholders - Preserve placeholders
-   * @param {string} options.htmlHandling - How to handle HTML: none, strip, decode, preserve
-   * @param {Object} options.fallback - Fallback options
-   * @param {boolean} options.fallback.fallbackToSource - Use source content when translation missing (default: true)
-   * @param {boolean} options.fallback.regionalFallback - Enable pt-BR -> pt fallback (default: true)
-   * @param {string} options.fallback.fallbackLanguage - Custom fallback language
-   * @param {string[]} options.skipKeys - Exact key paths to skip from translation
-   * @param {string[]} options.skipPaths - Glob patterns to skip (e.g., "nav.*", "config.*.secret")
-   * @param {Object} options.contextAnnotations - Per-key context hints for disambiguation
-   */
-  async translateJSON({
-    json,
-    sourceLanguage = 'en',
-    targetLanguages,
-    preservePlaceholders = true,
-    htmlHandling = 'none',
-    fallback = {},
-    skipKeys = [],
-    skipPaths = [],
-    contextAnnotations = {},
-  }) {
-    if (!this.apiKey) {
-      throw new Error('API key is required. Set SHIPI18N_API_KEY or run: shipi18n config set apiKey YOUR_KEY');
-    }
-
-    const {
-      fallbackToSource = true,
-      regionalFallback = true,
-      fallbackLanguage,
-    } = fallback;
-
-    const sourceContent = typeof json === 'string' ? JSON.parse(json) : json;
-    const jsonString = typeof json === 'string' ? json : JSON.stringify(json);
-
-    // Process regional languages - add base languages for fallback
-    const { processedTargets, regionalMap } = this.processRegionalLanguages(targetLanguages, regionalFallback);
-
-    const response = await fetch(`${this.baseUrl}/api/translate`, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'X-API-Key': this.apiKey,
-      },
-      body: JSON.stringify({
-        inputMethod: 'text',
-        text: jsonString,
-        sourceLanguage,
-        targetLanguages: JSON.stringify(processedTargets),
-        preservePlaceholders: String(preservePlaceholders),
-        htmlHandling,
-        skipKeys,
-        skipPaths,
-        contextAnnotations,
-      }),
-    });
-
-    if (!response.ok) {
-      const errorData = await response.json().catch(() => ({ error: { message: response.statusText } }));
-      const error = new Error(errorData.error?.message || errorData.message || `Translation failed: ${response.statusText}`);
-      error.code = errorData.error?.code;
-      error.status = response.status;
-      throw error;
-    }
-
-    const result = await response.json();
-
-    // Parse JSON strings back to objects
-    const parsed = {};
-    for (const [lang, jsonStr] of Object.entries(result)) {
-      if (lang === 'warnings' || lang === 'namespaceInfo' || lang === 'skipped' || lang === 'contextEnhanced') {
-        parsed[lang] = jsonStr;
-        continue;
-      }
-      try {
-        parsed[lang] = typeof jsonStr === 'string' ? JSON.parse(jsonStr) : jsonStr;
-      } catch (e) {
-        parsed[lang] = jsonStr;
-      }
-    }
-
-    // Apply fallback logic
-    return this.applyFallbacks(
-      parsed,
-      sourceContent,
-      targetLanguages,
-      sourceLanguage,
-      fallbackToSource,
-      regionalFallback,
-      fallbackLanguage,
-      regionalMap
-    );
-  }
-
-  /**
-   * Process regional language codes for fallback support
-   */
-  processRegionalLanguages(targetLanguages, regionalFallback) {
-    const regionalMap = {};
-    const processedTargets = [];
-    const baseLanguagesAdded = new Set();
-
-    for (const lang of targetLanguages) {
-      if (lang.includes('-') && regionalFallback) {
-        const baseLang = lang.split('-')[0];
-        regionalMap[lang] = baseLang;
-
-        if (!baseLanguagesAdded.has(baseLang) && !targetLanguages.includes(baseLang)) {
-          processedTargets.push(baseLang);
-          baseLanguagesAdded.add(baseLang);
-        }
-      }
-
-      if (!processedTargets.includes(lang)) {
-        processedTargets.push(lang);
-      }
-    }
-
-    return { processedTargets, regionalMap };
-  }
-
-  /**
-   * Apply fallback logic to translation results
-   */
-  applyFallbacks(result, sourceContent, targetLanguages, sourceLanguage, fallbackToSource, regionalFallback, fallbackLanguage, regionalMap) {
-    const fallbackInfo = {
-      used: false,
-      languagesFallbackToSource: [],
-      regionalFallbacks: {},
-      keysFallback: {},
-    };
-
-    for (const lang of targetLanguages) {
-      const translation = result[lang];
-
-      // Case 1: Entire language missing
-      if (!translation || Object.keys(translation).length === 0) {
-        // Try regional fallback first
-        if (regionalFallback && regionalMap[lang]) {
-          const baseLang = regionalMap[lang];
-          const baseTranslation = result[baseLang];
-
-          if (baseTranslation && Object.keys(baseTranslation).length > 0) {
-            result[lang] = { ...baseTranslation };
-            fallbackInfo.used = true;
-            fallbackInfo.regionalFallbacks[lang] = baseLang;
-            continue;
-          }
-        }
-
-        // Fall back to source
-        if (fallbackToSource) {
-          result[lang] = { ...sourceContent };
-          fallbackInfo.used = true;
-          fallbackInfo.languagesFallbackToSource.push(lang);
-        }
-        continue;
-      }
-
-      // Case 2: Check for missing keys
-      if (fallbackToSource && typeof translation === 'object') {
-        const missingKeys = this.findMissingKeys(sourceContent, translation);
-
-        if (missingKeys.length > 0) {
-          fallbackInfo.used = true;
-          fallbackInfo.keysFallback[lang] = missingKeys;
-
-          for (const key of missingKeys) {
-            const fallbackValue = this.getNestedValue(sourceContent, key);
-
-            // Try regional fallback first
-            if (regionalFallback && regionalMap[lang]) {
-              const baseLang = regionalMap[lang];
-              const baseTranslation = result[baseLang];
-              const baseValue = baseTranslation ? this.getNestedValue(baseTranslation, key) : undefined;
-
-              if (baseValue !== undefined) {
-                this.setNestedValue(translation, key, baseValue);
-                continue;
-              }
-            }
-
-            if (fallbackValue !== undefined) {
-              this.setNestedValue(translation, key, fallbackValue);
-            }
-          }
-        }
-      }
-    }
-
-    if (fallbackInfo.used) {
-      result.fallbackInfo = fallbackInfo;
-    }
-
-    return result;
-  }
-
-  /**
-   * Find missing keys in translation
-   */
-  findMissingKeys(source, translation, prefix = '') {
-    const missing = [];
-
-    for (const key of Object.keys(source)) {
-      const fullKey = prefix ? `${prefix}.${key}` : key;
-      const sourceValue = source[key];
-      const translationValue = translation[key];
-
-      if (translationValue === undefined || translationValue === null || translationValue === '') {
-        missing.push(fullKey);
-      } else if (
-        typeof sourceValue === 'object' &&
-        sourceValue !== null &&
-        !Array.isArray(sourceValue) &&
-        typeof translationValue === 'object' &&
-        translationValue !== null
-      ) {
-        missing.push(...this.findMissingKeys(sourceValue, translationValue, fullKey));
-      }
-    }
-
-    return missing;
-  }
-
-  /**
-   * Get nested value from object using dot notation
-   */
-  getNestedValue(obj, path) {
-    return path.split('.').reduce((current, key) => {
-      if (current && typeof current === 'object' && key in current) {
-        return current[key];
-      }
-      return undefined;
-    }, obj);
-  }
-
-  /**
-   * Set nested value in object using dot notation
-   */
-  setNestedValue(obj, path, value) {
-    const keys = path.split('.');
-    let current = obj;
-
-    for (let i = 0; i < keys.length - 1; i++) {
-      const key = keys[i];
-      if (!(key in current) || typeof current[key] !== 'object') {
-        current[key] = {};
-      }
-      current = current[key];
-    }
-
-    current[keys[keys.length - 1]] = value;
-  }
-
-  /**
-   * List translation keys
-   */
-  async listKeys() {
-    if (!this.apiKey) {
-      throw new Error('API key is required');
-    }
-
-    const response = await fetch(`${this.baseUrl}/api/keys`, {
-      method: 'GET',
-      headers: {
-        'X-API-Key': this.apiKey,
-      },
-    });
-
-    if (!response.ok) {
-      const errorData = await response.json().catch(() => ({ error: { message: response.statusText } }));
-      throw new Error(errorData.error?.message || errorData.message || 'Failed to list keys');
-    }
-
-    return response.json();
-  }
-
-  /**
-   * Delete a translation key
-   */
-  async deleteKey(keyId) {
-    if (!this.apiKey) {
-      throw new Error('API key is required');
-    }
-
-    const response = await fetch(`${this.baseUrl}/api/keys/${keyId}`, {
-      method: 'DELETE',
-      headers: {
-        'X-API-Key': this.apiKey,
-      },
-    });
-
-    if (!response.ok) {
-      const errorData = await response.json().catch(() => ({ error: { message: response.statusText } }));
-      throw new Error(errorData.error?.message || errorData.message || 'Failed to delete key');
-    }
-
-    return response.json();
-  }
-
-  /**
-   * Export translation keys
-   */
-  async exportKeys(format = 'json') {
-    if (!this.apiKey) {
-      throw new Error('API key is required');
-    }
-
-    const response = await fetch(`${this.baseUrl}/api/keys/export/${format}`, {
-      method: 'GET',
-      headers: {
-        'X-API-Key': this.apiKey,
-      },
-    });
-
-    if (!response.ok) {
-      const errorData = await response.json().catch(() => ({ error: { message: response.statusText } }));
-      throw new Error(errorData.error?.message || errorData.message || 'Failed to export keys');
-    }
-
-    return response.json();
-  }
-}

package/src/lib/config.js

@@ -1,74 +0,0 @@
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
-import YAML from 'yaml';
-
-const CONFIG_DIR = join(homedir(), '.shipi18n');
-const CONFIG_FILE = join(CONFIG_DIR, 'config.yml');
-
-/**
- * Get configuration from file or environment variables
- */
-export function getConfig() {
-  const config = {
-    apiKey: process.env.SHIPI18N_API_KEY,
-    sourceLanguage: process.env.SHIPI18N_SOURCE_LANG || 'en',
-    targetLanguages: process.env.SHIPI18N_TARGET_LANGS?.split(','),
-    outputDir: process.env.SHIPI18N_OUTPUT_DIR || './locales',
-    saveKeys: process.env.SHIPI18N_SAVE_KEYS === 'true',
-  };
-
-  // Try to read from config file
-  if (existsSync(CONFIG_FILE)) {
-    try {
-      const fileContent = readFileSync(CONFIG_FILE, 'utf8');
-      const fileConfig = YAML.parse(fileContent);
-
-      // Merge with priority: env vars > config file
-      Object.keys(fileConfig).forEach((key) => {
-        if (config[key] === undefined || config[key] === null) {
-          config[key] = fileConfig[key];
-        }
-      });
-    } catch (error) {
-      console.warn(`Warning: Could not read config file: ${error.message}`);
-    }
-  }
-
-  return config;
-}
-
-/**
- * Save configuration to file
- */
-export function saveConfig(config) {
-  try {
-    // Create directory if it doesn't exist
-    if (!existsSync(CONFIG_DIR)) {
-      mkdirSync(CONFIG_DIR, { recursive: true });
-    }
-
-    const yamlContent = YAML.stringify(config);
-    writeFileSync(CONFIG_FILE, yamlContent, 'utf8');
-    return true;
-  } catch (error) {
-    throw new Error(`Failed to save config: ${error.message}`);
-  }
-}
-
-/**
- * Get a specific config value
- */
-export function getConfigValue(key) {
-  const config = getConfig();
-  return config[key];
-}
-
-/**
- * Set a specific config value
- */
-export function setConfigValue(key, value) {
-  const config = getConfig();
-  config[key] = value;
-  saveConfig(config);
-}

package/src/utils/incremental.js

@@ -1,90 +0,0 @@
-/**
- * Utilities for incremental translation
- */
-
-/**
- * Flatten a nested object into dot-notation keys
- * @param {Object} obj - Nested object
- * @param {string} prefix - Key prefix (used for recursion)
- * @returns {Object} Flattened object with dot-notation keys
- */
-export function flattenObject(obj, prefix = '') {
-  const result = {};
-  for (const [key, value] of Object.entries(obj)) {
-    const newKey = prefix ? `${prefix}.${key}` : key;
-    if (value && typeof value === 'object' && !Array.isArray(value)) {
-      Object.assign(result, flattenObject(value, newKey));
-    } else {
-      result[newKey] = value;
-    }
-  }
-  return result;
-}
-
-/**
- * Unflatten dot-notation keys back into nested object
- * @param {Object} obj - Flattened object with dot-notation keys
- * @returns {Object} Nested object
- */
-export function unflattenObject(obj) {
-  const result = {};
-  for (const [key, value] of Object.entries(obj)) {
-    const keys = key.split('.');
-    let current = result;
-    for (let i = 0; i < keys.length - 1; i++) {
-      if (!current[keys[i]]) {
-        current[keys[i]] = {};
-      }
-      current = current[keys[i]];
-    }
-    current[keys[keys.length - 1]] = value;
-  }
-  return result;
-}
-
-/**
- * Deep merge two objects
- * @param {Object} target - Target object
- * @param {Object} source - Source object to merge in
- * @returns {Object} Merged object
- */
-export function deepMerge(target, source) {
-  const result = { ...target };
-  for (const [key, value] of Object.entries(source)) {
-    if (value && typeof value === 'object' && !Array.isArray(value)) {
-      result[key] = deepMerge(result[key] || {}, value);
-    } else {
-      result[key] = value;
-    }
-  }
-  return result;
-}
-
-/**
- * Find keys that exist in source but not in target
- * @param {Object} sourceJson - Source JSON object
- * @param {Object} targetJson - Target JSON object
- * @returns {Object} Object containing only missing keys
- */
-export function findMissingKeys(sourceJson, targetJson) {
-  const sourceFlat = flattenObject(sourceJson);
-  const targetFlat = flattenObject(targetJson);
-
-  const missingKeys = {};
-  for (const [key, value] of Object.entries(sourceFlat)) {
-    if (!(key in targetFlat)) {
-      missingKeys[key] = value;
-    }
-  }
-
-  return unflattenObject(missingKeys);
-}
-
-/**
- * Count the number of leaf keys in a nested object
- * @param {Object} obj - Object to count keys in
- * @returns {number} Number of leaf keys
- */
-export function countKeys(obj) {
-  return Object.keys(flattenObject(obj)).length;
-}

package/src/utils/logger.js

@@ -1,46 +0,0 @@
-import chalk from 'chalk';
-import ora from 'ora';
-
-export const logger = {
-  success: (message) => {
-    console.log(chalk.green('✓'), message);
-  },
-
-  error: (message) => {
-    console.log(chalk.red('✗'), message);
-  },
-
-  warn: (message) => {
-    console.log(chalk.yellow('⚠'), message);
-  },
-
-  info: (message) => {
-    console.log(chalk.blue('ℹ'), message);
-  },
-
-  log: (message) => {
-    console.log(message);
-  },
-
-  spinner: (text) => {
-    return ora(text).start();
-  },
-};
-
-export function formatError(error) {
-  if (error.code === 'ENOTFOUND') {
-    return chalk.red('Network error: Could not connect to Shipi18n API');
-  }
-
-  if (error.message.includes('Language limit exceeded')) {
-    return chalk.red(error.message) + '\n' +
-      chalk.yellow('💡 Upgrade your plan at https://shipi18n.com to translate to more languages');
-  }
-
-  if (error.message.includes('API key')) {
-    return chalk.red(error.message) + '\n' +
-      chalk.yellow('💡 Get your free API key at https://shipi18n.com or run: shipi18n config set apiKey YOUR_KEY');
-  }
-
-  return chalk.red(error.message);
-}