@localheroai/cli 0.0.5 → 0.0.6

package/src/api/translations.js

@@ -1,58 +0,0 @@
-import { getApiKey } from '../utils/auth.js';
-import { apiRequest } from './client.js';
-import { getCurrentBranch } from '../utils/git.js';
-
-export async function createTranslationJob({ sourceFiles, targetLocales, projectId, targetPaths }) {
-  const apiKey = await getApiKey();
-  const branch = await getCurrentBranch();
-
-  const response = await apiRequest(`/api/v1/projects/${projectId}/translation_jobs`, {
-    method: 'POST',
-    body: JSON.stringify({
-      target_languages: targetLocales,
-      files: sourceFiles.map(file => ({
-        path: file.path,
-        content: file.content,
-        format: file.format,
-        target_paths: targetPaths
-      })),
-      ...(branch && { branch })
-    }),
-    apiKey
-  });
-
-  if (!response.jobs || !response.jobs.length) {
-    throw new Error('No translation jobs were created');
-  }
-
-  return {
-    jobs: response.jobs,
-    totalJobs: response.jobs.length
-  };
-}
-
-export async function checkJobStatus(jobId, includeTranslations = false) {
-  const apiKey = await getApiKey();
-  const endpoint = `/api/v1/translation_jobs/${jobId}${includeTranslations ? '?include_translations=true' : ''}`;
-  return apiRequest(endpoint, { apiKey });
-}
-
-export async function getTranslations(jobId) {
-  const apiKey = await getApiKey();
-  return apiRequest(`/api/v1/translation_jobs/${jobId}/translations`, { apiKey });
-}
-
-export async function getUpdates(projectId, { since, page = 1 }) {
-  const apiKey = await getApiKey();
-
-  if (!since) {
-    throw new Error('Missing required parameter: since (ISO 8601 timestamp)');
-  }
-
-  const queryParams = new URLSearchParams({
-    since,
-    page: page.toString()
-  });
-
-  return apiRequest(`/api/v1/projects/${projectId}/updates?${queryParams}`, { apiKey });
-}

package/src/cli.js

@@ -1,78 +0,0 @@
-#!/usr/bin/env node
-
-import { Command } from 'commander';
-import chalk from 'chalk';
-import { readFileSync } from 'fs';
-import { login } from './commands/login.js';
-import { init } from './commands/init.js';
-import { translate } from './commands/translate.js';
-import { sync } from './commands/sync.js';
-
-const program = new Command();
-
-function getVersion() {
-  const packageJson = JSON.parse(
-    readFileSync(new URL('../package.json', import.meta.url))
-  );
-  return packageJson.version;
-}
-
-function handleApiError(error) {
-  console.error(chalk.red(`❌ ${error.cliErrorMessage || error.message}`));
-
-  if (program.opts().debug) {
-    console.error(chalk.dim(error.stack || error));
-
-    if (error.cause) {
-      console.error(chalk.dim(error.cause.stack || error.cause));
-    }
-  } else {
-    console.error(chalk.dim('\nRun with --debug for more information'));
-  }
-
-  process.exit(1);
-}
-
-function wrapCommandAction(action) {
-  return function (...args) {
-    return Promise.resolve(action(...args)).catch(handleApiError);
-  };
-}
-
-program
-  .name('localhero')
-  .description('CLI tool for automatic I18n translations with LocalHero.ai, more info at https://localhero.ai.')
-  .version(getVersion())
-  .option('--debug', 'Show debug information when errors occur')
-  .action(() => {
-    console.log('LocalHero.ai is automatic I18n translations service that easily integrates with your dev workflow.');
-    console.log(`\nVersion: ${getVersion()}`);
-    console.log('\n🔗 Visit https://localhero.ai for more information');
-    console.log('👏 Set up your project with `npx @localheroai/cli init`');
-    console.log('💡 Use --help to see available commands');
-  });
-
-program
-  .command('login')
-  .description('Authenticate with LocalHero.ai using an API key')
-  .action(wrapCommandAction(() => login()));
-
-program
-  .command('init')
-  .description('Initialize a new LocalHero.ai project')
-  .action(wrapCommandAction(() => init()));
-
-program
-  .command('translate')
-  .description('Translate missing keys in your i18n files')
-  .option('-v, --verbose', 'Show detailed progress information')
-  .option('-c, --commit', 'Automatically commit changes (useful for CI/CD)')
-  .action(wrapCommandAction((options) => translate(options)));
-
-program
-  .command('sync')
-  .description('Sync updates from LocalHero.ai to your local files')
-  .option('-v, --verbose', 'Show detailed progress information')
-  .action(wrapCommandAction((options) => sync(options)));
-
-program.parse();

package/src/commands/init.js

@@ -1,485 +0,0 @@
-import { promises as fs } from 'fs';
-import path from 'path';
-import chalk from 'chalk';
-import { createPromptService } from '../utils/prompt-service.js';
-import { createProject, listProjects } from '../api/projects.js';
-import { configService } from '../utils/config.js';
-import { checkAuth } from '../utils/auth.js';
-import { login } from './login.js';
-import { importService } from '../utils/import-service.js';
-import { createGitHubActionFile } from '../utils/github.js';
-import { directoryExists, findFirstExistingPath, getDirectoryContents } from '../utils/files.js';
-
-const PROJECT_TYPES = {
-  rails: {
-    directIndicators: ['config/application.rb', 'Gemfile'],
-    defaults: {
-      translationPath: 'config/locales/',
-      filePattern: '**/*.{yml,yaml}'
-    },
-    commonPaths: [
-      'config/locales'
-    ]
-  },
-  nextjs: {
-    directIndicators: ['next.config.js', 'next.config.mjs'],
-    packageCheck: {
-      requires: ['next'],
-      oneOf: ['next-i18next', 'next-translate']
-    },
-    defaults: {
-      translationPath: 'public/locales/',
-      filePattern: '**/*.json'
-    },
-    commonPaths: [
-      'public/locales',
-      'src/locales',
-      'locales'
-    ]
-  },
-  vueI18n: {
-    directIndicators: ['vue.config.js'],
-    packageCheck: {
-      oneOf: ['vue-i18n', '@nuxtjs/i18n']
-    },
-    defaults: {
-      translationPath: 'src/locales/',
-      filePattern: '**/*.json'
-    },
-    commonPaths: [
-      'src/locales',
-      'src/i18n',
-      'locales',
-      'i18n'
-    ]
-  },
-  i18next: {
-    directIndicators: ['i18next.config.js', 'i18n.js', 'i18n/index.js'],
-    packageCheck: {
-      requires: ['i18next']
-    },
-    defaults: {
-      translationPath: 'public/locales/',
-      filePattern: '**/*.json'
-    },
-    commonPaths: [
-      'public/locales',
-      'src/locales',
-      'locales',
-      'src/i18n',
-      'i18n'
-    ]
-  },
-  reactIntl: {
-    directIndicators: ['.babelrc'],
-    packageCheck: {
-      requires: ['react-intl']
-    },
-    defaults: {
-      translationPath: 'src/translations/',
-      filePattern: '**/*.json'
-    },
-    commonPaths: [
-      'src/i18n',
-      'src/translations',
-      'src/lang',
-      'src/locales',
-      'translations',
-      'locales'
-    ]
-  },
-  gatsbyReact: {
-    directIndicators: ['gatsby-config.js'],
-    packageCheck: {
-      requires: ['gatsby'],
-      oneOf: ['gatsby-plugin-intl', 'gatsby-plugin-i18n']
-    },
-    defaults: {
-      translationPath: 'src/data/i18n/',
-      filePattern: '**/*.json'
-    },
-    commonPaths: [
-      'src/data/i18n',
-      'src/i18n',
-      'src/locales',
-      'locales'
-    ]
-  },
-  react: {
-    directIndicators: ['src/App.js', 'src/App.jsx', 'src/index.js', 'src/index.jsx'],
-    packageCheck: {
-      requires: ['react']
-    },
-    defaults: {
-      translationPath: 'src/locales/',
-      filePattern: '**/*.{json,yml}'
-    },
-    commonPaths: [
-      'src/locales',
-      'public/locales',
-      'src/i18n',
-      'src/translations',
-      'src/lang',
-      'assets/i18n',
-      'locales'
-    ]
-  },
-  generic: {
-    directIndicators: [],
-    defaults: {
-      translationPath: 'locales/',
-      filePattern: '**/*.{json,yml,yaml}'
-    },
-    commonPaths: [
-      'locales',
-      'src/locales',
-      'public/locales',
-      'src/i18n',
-      'src/translations',
-      'src/lang',
-      'assets/i18n',
-      'i18n',
-      'translations',
-      'lang'
-    ]
-  }
-};
-
-async function checkPackageJson() {
-  try {
-    const content = await fs.readFile('package.json', 'utf8');
-    const pkg = JSON.parse(content);
-    return { ...pkg.dependencies, ...pkg.devDependencies };
-  } catch {
-    return null;
-  }
-}
-
-async function detectFramework(config) {
-  for (const indicator of config.directIndicators || []) {
-    try {
-      const stats = await fs.stat(indicator);
-      if (stats.isFile()) return true;
-    } catch {
-      continue;
-    }
-  }
-
-  if (config.packageCheck) {
-    const deps = await checkPackageJson();
-    if (deps) {
-      const { requires = [], oneOf = [] } = config.packageCheck;
-
-      if (requires.length && !requires.every(pkg => deps[pkg])) {
-        return false;
-      }
-
-      if (oneOf.length && !oneOf.some(pkg => deps[pkg])) {
-        return false;
-      }
-
-      return true;
-    }
-  }
-
-  return false;
-}
-
-async function detectProjectType() {
-  for (const [type, config] of Object.entries(PROJECT_TYPES)) {
-    if (!config.directIndicators?.length && !config.packageCheck) continue;
-
-    const isFramework = await detectFramework(config);
-    if (!isFramework) continue;
-
-    if (config.commonPaths) {
-      const translationPath = await findFirstExistingPath(config.commonPaths);
-      if (translationPath) {
-        return {
-          type,
-          defaults: {
-            ...config.defaults,
-            translationPath: `${translationPath}/`
-          }
-        };
-      }
-    }
-    return { type, defaults: config.defaults };
-  }
-
-  const translationPath = await findFirstExistingPath(PROJECT_TYPES.generic.commonPaths);
-  if (translationPath) {
-    const contents = await getDirectoryContents(translationPath);
-    if (contents) {
-      return {
-        type: 'detected',
-        defaults: {
-          translationPath: `${translationPath}/`,
-          filePattern: contents.jsonFiles.length > 0 && contents.yamlFiles.length === 0
-            ? '**/*.json'
-            : '**/*.{json,yml,yaml}'
-        }
-      };
-    }
-  }
-
-  return {
-    type: 'generic',
-    defaults: PROJECT_TYPES.generic.defaults
-  };
-}
-
-async function promptForConfig(projectDefaults, projectService, promptService, console = global.console) {
-  const { choice: projectChoice, project: existingProject } = await promptService.selectProject(projectService);
-  let projectId = projectChoice;
-  let newProject = false;
-  let config = await promptService.getProjectSetup();
-
-  if (!existingProject) {
-    config = {
-      projectName: await promptService.input({
-        message: 'Project name:',
-        default: path.basename(process.cwd()),
-      }),
-      sourceLocale: await promptService.input({
-        message: 'Source language - the language that we will translate from:',
-        default: 'en',
-        hint: 'Examples: "en" for en.json/en.yml, "en-US" for en-US.json, or directory name like "en" in /locales/en/common.json'
-      }),
-      outputLocales: (await promptService.input({
-        message: 'Target languages (comma-separated):',
-        hint: 'Must match your file names or directory names exactly. Examples: en.json → "en", fr-CA.json → "fr-CA", /locales/de/ → "de"'
-      })).split(',').map(lang => lang.trim()).filter(Boolean)
-    };
-
-    try {
-      newProject = await projectService.createProject({
-        name: config.projectName,
-        sourceLocale: config.sourceLocale,
-        targetLocales: config.outputLocales
-      });
-      projectId = newProject.id;
-    } catch (error) {
-      console.log(chalk.red(`\n✗ Failed to create project: ${error.message}`));
-      return null;
-    }
-  } else {
-    config = {
-      projectName: existingProject.name,
-      sourceLocale: existingProject.source_language,
-      outputLocales: existingProject.target_languages
-    };
-  }
-
-  const commonPaths = projectDefaults.commonPaths || PROJECT_TYPES.generic.commonPaths;
-  const existingDirs = [];
-
-  for (const dir of commonPaths) {
-    if (await directoryExists(dir)) {
-      existingDirs.push(dir);
-    }
-  }
-
-  let dirHint = `Directory containing your translation files for ${projectDefaults.type || 'your'} project`;
-  if (existingDirs.length > 0) {
-    dirHint += `. Found existing directories: ${existingDirs.map(d => `"${d}/"`).join(', ')}`;
-  } else {
-    dirHint += `. Common paths: ${commonPaths.slice(0, 3).map(d => `"${d}/"`).join(', ')}`;
-  }
-
-  const translationPath = await promptService.input({
-    message: 'Translation files path:',
-    default: projectDefaults.defaults.translationPath,
-    hint: dirHint
-  });
-
-  let filePattern = projectDefaults.defaults.filePattern;
-  const contents = await getDirectoryContents(translationPath);
-
-  if (contents) {
-    if (contents.jsonFiles.length > 0 && contents.yamlFiles.length === 0) {
-      filePattern = '**/*.json';
-    } else if (contents.jsonFiles.length === 0 && contents.yamlFiles.length > 0) {
-      filePattern = '**/*.{yml,yaml}';
-    } else if (contents.jsonFiles.length > 0 && contents.yamlFiles.length > 0) {
-      filePattern = '**/*.{json,yml,yaml}';
-    }
-  }
-
-  const ignorePaths = await promptService.input({
-    message: 'Paths to ignore (comma-separated, leave empty for none):',
-    hint: 'Example: "locales/ignored,locales/temp"'
-  });
-
-  return {
-    ...config,
-    projectId,
-    translationPath,
-    filePattern,
-    ignorePaths: ignorePaths.split(',').map(p => p.trim()).filter(Boolean),
-    newProject
-  };
-}
-
-export async function init(deps = {}) {
-  const {
-    console = global.console,
-    basePath = process.cwd(),
-    promptService = createPromptService({ inquirer: await import('@inquirer/prompts') }),
-    configUtils = configService,
-    authUtils = { checkAuth },
-    importUtils = importService,
-    projectApi = { createProject, listProjects },
-    login: loginFn = login
-  } = deps;
-
-  const existingConfig = await configUtils.getProjectConfig(basePath);
-  if (existingConfig) {
-    console.log(chalk.yellow('Existing configuration found in localhero.json. Skipping initialization.'));
-    return;
-  }
-
-  const isAuthenticated = await authUtils.checkAuth();
-  if (!isAuthenticated) {
-    console.log('LocalHero.ai - Automate your i18n translations\n');
-    console.log(chalk.yellow('No API key found. Let\'s get you authenticated.'));
-
-    await loginFn({
-      console,
-      basePath,
-      promptService,
-      configUtils,
-      verifyApiKey: authUtils.verifyApiKey,
-      isCalledFromInit: true
-    });
-  }
-
-  console.log('\nLet\'s set up configuration for your project.\n');
-
-  const projectDefaults = await detectProjectType();
-  const answers = await promptForConfig(projectDefaults, projectApi, promptService, console);
-
-  if (!answers) {
-    return;
-  }
-
-  const config = {
-    schemaVersion: '1.0',
-    projectId: answers.projectId,
-    sourceLocale: answers.sourceLocale,
-    outputLocales: answers.outputLocales,
-    translationFiles: {
-      paths: [answers.translationPath],
-      pattern: answers.filePattern,
-      ignore: answers.ignorePaths
-    }
-  };
-
-  await configUtils.saveProjectConfig(config, basePath);
-  console.log(chalk.green('\n✓ Created localhero.json'));
-
-  if (answers.newProject) {
-    console.log(chalk.green(`✓ Project created, view it at: https://localhero.ai/projects/${answers.projectId}`));
-  }
-
-  console.log('Configuration:');
-  console.log(JSON.stringify(config, null, 2));
-  console.log(' ');
-
-  const shouldSetupGitHubAction = await promptService.confirm({
-    message: 'Would you like to set up GitHub Actions for automatic translations?',
-    default: true
-  });
-
-  if (shouldSetupGitHubAction) {
-    try {
-      const workflowFile = await createGitHubActionFile(basePath, config.translationFiles.paths);
-      console.log(chalk.green(`\n✓ Created GitHub Action workflow at ${workflowFile}`));
-      console.log('\nNext steps:');
-      console.log('1. Add your API key to your repository\'s secrets:');
-      console.log('   - Go to Settings > Secrets > Actions > New repository secret');
-      console.log('   - Name: LOCALHERO_API_KEY');
-      console.log('   - Value: [Your API Key] (find this at https://localhero.ai/api-keys or in your local .localhero_key file)');
-      console.log('\n2. Commit and push the workflow file to enable automatic translations\n');
-    } catch (error) {
-      console.log(chalk.yellow('\nFailed to create GitHub Action workflow:'), error.message);
-    }
-  }
-
-  const shouldImport = await promptService.confirm({
-    message: 'Would you like to import existing translation files? (recommended)',
-    default: true
-  });
-
-  if (shouldImport) {
-    console.log('\nSearching for translation files...');
-    console.log(`Looking in: ${config.translationFiles.paths.join(', ')}`);
-
-    const importResult = await importUtils.importTranslations(config, basePath);
-
-    if (importResult.status === 'no_files') {
-      console.log(chalk.yellow('\nNo translation files found.'));
-      console.log('Make sure your translation files:');
-      console.log('1. Are in the specified path(s)');
-      console.log('2. Have the correct file extensions (.json, .yml, or .yaml)');
-      console.log('3. Follow the naming convention: [language-code].[extension] or are in language-specific directories');
-      console.log(`4. Include source language files (${config.sourceLocale}.[extension])`);
-      console.log('\nSupported JSON formats:');
-      console.log('- Nested format: { "navbar": { "home": "Home" } }');
-      console.log('- Flat format: { "navbar.home": "Home" }');
-      console.log('- With language wrapper: { "en": { "navbar": { "home": "Home" } } }');
-      console.log('\nSupported directory structures:');
-      console.log('- /locales/en.json, /locales/fr.json');
-      console.log('- /locales/en/common.json, /locales/fr/common.json');
-      console.log('- /locales/common.en.json, /locales/common.fr.json');
-    } else if (importResult.status === 'failed') {
-      console.log(chalk.red('\n✗ Failed to import translations'));
-      if (importResult.error) {
-        console.log(chalk.red(`Error: ${importResult.error}`));
-      }
-      return;
-    } else if (importResult.status === 'completed') {
-      console.log(chalk.green('\n✓ Successfully imported translations'));
-      await configUtils.updateLastSyncedAt();
-
-      if (importResult.files) {
-        console.log('\nImported files:');
-        [...importResult.files.source, ...importResult.files.target]
-          .sort((a, b) => a.path.localeCompare(b.path))
-          .forEach(file => {
-            const isSource = importResult.files.source.includes(file);
-            console.log(`- ${file.path}${isSource ? ' [source]' : ''}`);
-          });
-      }
-
-      if (importResult.sourceImport) {
-        console.log(`\nImported ${importResult.sourceImport.statistics.total_keys} source language keys`);
-
-        if (importResult.sourceImport.warnings?.length) {
-          console.log(chalk.yellow('\nWarnings:'));
-          importResult.sourceImport.warnings.forEach(warning => {
-            console.log(`- ${warning.message} (${warning.language})`);
-          });
-        }
-      }
-
-      console.log('\nTarget Languages:');
-      importResult.statistics.languages.forEach(lang => {
-        console.log(`${lang.code.toUpperCase()}: ${lang.translated}/${importResult.statistics.total_keys} translated`);
-      });
-
-      if (importResult.warnings?.length) {
-        console.log(chalk.yellow('\nWarnings:'));
-        importResult.warnings.forEach(warning => {
-          console.log(`- ${warning.message} (${warning.language})`);
-        });
-      }
-
-      if (importResult.translations_url) {
-        console.log(chalk.blue(`\nView your translations at: ${importResult.translations_url}`));
-      }
-    }
-  }
-
-  console.log('\n🚀 Done! Start translating with: npx @localheroai/cli translate');
-}

package/src/commands/login.js

@@ -1,80 +0,0 @@
-import chalk from 'chalk';
-import { createPromptService } from '../utils/prompt-service.js';
-import { updateGitignore } from '../utils/git.js';
-import { verifyApiKey as defaultVerifyApiKey } from '../api/auth.js';
-import { configService } from '../utils/config.js';
-
-const API_KEY_PATTERN = /^tk_[a-zA-Z0-9]{48}$/;
-
-export async function login(deps = {}) {
-  const {
-    console = global.console,
-    basePath = process.cwd(),
-    promptService = createPromptService({ inquirer: await import('@inquirer/prompts') }),
-    verifyApiKey = defaultVerifyApiKey,
-    gitUtils = { updateGitignore },
-    configUtils = configService,
-    isCalledFromInit = false
-  } = deps;
-
-  const existingConfig = await configUtils.getAuthConfig(basePath);
-
-  if (existingConfig?.api_key) {
-    console.log(chalk.yellow('\n⚠️  Warning: This will replace your existing API key configuration'));
-  }
-
-  const apiKey = process.env.LOCALHERO_API_KEY || (
-    console.log('\n→ Get your API key from: https://localhero.ai/api-keys'),
-    console.log('→ New to LocalHero? Sign up at: https://localhero.ai/signup'),
-    console.log(chalk.gray('The API key will be saved to .localhero_key, and automatically added to your .gitignore file.\n')),
-    await promptService.getApiKey()
-  );
-
-  if (!apiKey) {
-    throw new Error('User cancelled');
-  }
-
-  if (!API_KEY_PATTERN.test(apiKey)) {
-    throw new Error('Invalid API key format');
-  }
-
-  const result = await verifyApiKey(apiKey);
-
-  if (result.error) {
-    if (result.error.code === 'invalid_api_key') {
-      console.log(chalk.red('\n❌ ' + result.error.message));
-      console.log(chalk.blue('\nℹ️  Get a new API key at https://localhero.ai/api-keys'));
-      process.exit(1);
-    }
-    throw new Error(result.error.message);
-  }
-
-  const config = {
-    api_key: apiKey,
-    last_verified: new Date().toISOString()
-  };
-
-  await configUtils.saveAuthConfig(config, basePath);
-  const gitignoreUpdated = await gitUtils.updateGitignore(basePath);
-
-  console.log(chalk.green('\n✓ API key verified and saved to .localhero_key'));
-  if (gitignoreUpdated) {
-    console.log(chalk.green('✓ Added .localhero_key to .gitignore'));
-  }
-
-  console.log(chalk.blue(`💼️  Organization: ${result.organization.name}`));
-  if (result.organization.projects.length > 0) {
-    console.log(chalk.blue(`\n📚  Projects: ${result.organization.projects.map(p => p.name).join(', ')}`));
-  }
-
-  const projectConfig = await configUtils.getProjectConfig(basePath);
-
-  if (!projectConfig && !isCalledFromInit) {
-    console.log(chalk.yellow('\n⚠️  Almost there! You need to set up your project configuration.'));
-    console.log(chalk.blue('Run this next:'));
-    console.log(chalk.white('\n  npx @localheroai/cli init\n'));
-  } else if (!isCalledFromInit) {
-    console.log('\nYou\'re ready to start translating!');
-    console.log('Try running: npx @localheroai/cli translate');
-  }
-}