lezu 0.0.11

package/README.md

@@ -0,0 +1,454 @@
+# Lezu CLI
+
+The official command-line interface for Lezu translation management platform.
+
+## Installation
+
+```bash
+# Use directly with npx (recommended)
+npx lezu
+
+# Or install globally
+npm install -g lezu
+```
+
+## Quick Start
+
+1. **Interactive Mode** (recommended for first-time users):
+   ```bash
+   npx lezu
+   ```
+
+2. **Direct Commands**:
+   ```bash
+   # Download translations
+   npx lezu load --project=YOUR_PROJECT_ID --api-key=YOUR_API_KEY
+
+   # Add a new translation key
+   npx lezu add --key=common.save --en="Save" --es="Guardar"
+
+   # Get project information
+   npx lezu get project
+
+   # Create a release
+   npx lezu release create --version=1.0.0
+   ```
+
+## Configuration
+
+### Environment Variables
+```bash
+LEZU_PROJECT_ID=your_project_id
+LEZU_API_KEY=your_api_key
+LEZU_API_URL=https://api.lezu.app  # Optional, defaults to production
+```
+
+### Configuration File
+Create a `.lezurc` or `.lezurc.json` file in your project root:
+
+```json
+{
+  "projectId": "your_project_id",
+  "apiKey": "your_api_key",
+  "dest": "./src/i18n",
+  "format": "json",
+  "environment": "production"
+}
+```
+
+### Configuration Priority
+1. Command-line arguments (highest priority)
+2. Environment variables
+3. Configuration file
+4. Defaults (lowest priority)
+
+## Commands
+
+### `lezu load`
+Download translation files from Lezu.
+
+**Usage:**
+```bash
+lezu load [options]
+```
+
+**Options:**
+- `-p, --project <id>` - Project ID
+- `-k, --api-key <key>` - API key
+- `-d, --dest <path>` - Destination folder (default: `./src/i18n`)
+- `-f, --format <format>` - Output format: `json`, `js`, `ts`, `yaml`, `po` (default: `json`)
+- `-l, --languages <languages>` - Comma-separated list of languages to download
+- `-r, --release <id>` - Specific release ID to download
+- `-e, --environment <env>` - Environment (default: `production`)
+- `--flatten` - Flatten nested keys (e.g., `common.save` instead of `{ common: { save: "..." } }`)
+- `--namespace` - Use namespace folder structure (`locales/en.json`)
+- `--include-empty` - Include empty translations
+- `-w, --watch` - Watch for changes and auto-update
+- `--watch-interval <ms>` - Watch interval in milliseconds (default: `5000`)
+- `--api-url <url>` - API URL (default: `https://api.lezu.app`)
+
+**Examples:**
+```bash
+# Basic usage
+lezu load --project=proj_123 --api-key=lk_456
+
+# Download specific languages only
+lezu load --languages=en,es,fr
+
+# Download from a specific release
+lezu load --release=rel_789
+
+# Flatten keys and output as TypeScript
+lezu load --flatten --format=ts
+
+# Export as gettext .po files
+lezu load --format=po
+
+# Watch mode for development
+lezu load --watch --watch-interval=2000
+```
+
+**Output Formats:**
+
+- **JSON** (default):
+  ```json
+  {
+    "common": {
+      "save": "Save",
+      "cancel": "Cancel"
+    }
+  }
+  ```
+
+- **JavaScript (ES modules)**:
+  ```javascript
+  export default {
+    common: {
+      save: "Save",
+      cancel: "Cancel"
+    }
+  }
+  ```
+
+- **TypeScript**:
+  ```typescript
+  export default {
+    common: {
+      save: "Save",
+      cancel: "Cancel"
+    }
+  } as const
+  ```
+
+- **YAML**:
+  ```yaml
+  common:
+    save: Save
+    cancel: Cancel
+  ```
+
+- **Gettext (.po)**:
+  ```po
+  # Translation file for en
+  # Generated by Lezu CLI on 2024-01-15T10:30:00.000Z
+  msgid ""
+  msgstr ""
+  "Language: en\n"
+  "MIME-Version: 1.0\n"
+  "Content-Type: text/plain; charset=UTF-8\n"
+  "Content-Transfer-Encoding: 8bit\n"
+  "Generated-By: Lezu CLI\n"
+
+  msgid "common.save"
+  msgstr "Save"
+
+  msgid "common.cancel"
+  msgstr "Cancel"
+  ```
+
+### `lezu add`
+Add a new translation key with values.
+
+**Usage:**
+```bash
+lezu add --key=<key> [options]
+```
+
+**Options:**
+- `-k, --key <key>` - **Required.** Translation key (e.g., "common.save")
+- `-v, --value <value>` - Value for the source language
+- `--en <value>` - English translation
+- `--es <value>` - Spanish translation
+- `--fr <value>` - French translation
+- `--de <value>` - German translation
+- `--nl <value>` - Dutch translation
+- `--it <value>` - Italian translation
+- `--pt <value>` - Portuguese translation
+- `--ru <value>` - Russian translation
+- `--ja <value>` - Japanese translation
+- `--ko <value>` - Korean translation
+- `--zh <value>` - Chinese translation
+- `--ar <value>` - Arabic translation
+- `-d, --description <desc>` - Description for the translation key
+- `--auto` - Auto-translate to all enabled languages using AI
+- `-p, --project <id>` - Project ID
+- `-a, --api-key <key>` - API key
+
+**Examples:**
+```bash
+# Add key with specific translations
+lezu add --key=common.save --en="Save" --es="Guardar" --fr="Enregistrer"
+
+# Add key with auto-translation
+lezu add --key=common.delete --en="Delete" --auto
+
+# Add key with description
+lezu add --key=error.validation --description="Validation error message" --en="This field is required"
+```
+
+**Subscription Requirements:**
+- **Free**: Cannot add keys
+- **Basic+**: Can add keys and translations
+- **Pro+**: Can add keys with auto-translation
+
+### `lezu get`
+Get information about your project.
+
+#### `lezu get project`
+Get project information and statistics.
+
+**Usage:**
+```bash
+lezu get project [options]
+```
+
+**Options:**
+- `--stats` - Include detailed statistics
+- `--json` - Output as JSON
+- `-p, --project <id>` - Project ID
+- `-a, --api-key <key>` - API key
+
+**Example:**
+```bash
+lezu get project --stats
+```
+
+#### `lezu get languages`
+List all languages in your project.
+
+**Usage:**
+```bash
+lezu get languages [options]
+```
+
+**Options:**
+- `--include-disabled` - Include disabled languages
+- `--json` - Output as JSON
+- `-p, --project <id>` - Project ID
+- `-a, --api-key <key>` - API key
+
+**Example:**
+```bash
+lezu get languages --include-disabled
+```
+
+#### `lezu get releases`
+List all releases in your project.
+
+**Usage:**
+```bash
+lezu get releases [options]
+```
+
+**Options:**
+- `-e, --environment <env>` - Environment (default: `production`)
+- `--limit <n>` - Limit number of results (default: `10`)
+- `--json` - Output as JSON
+- `-p, --project <id>` - Project ID
+- `-a, --api-key <key>` - API key
+
+**Example:**
+```bash
+lezu get releases --environment=staging --limit=20
+```
+
+### `lezu release`
+Manage releases.
+
+#### `lezu release create`
+Create a new release.
+
+**Usage:**
+```bash
+lezu release create [options]
+```
+
+**Options:**
+- `-v, --version <version>` - Release version (e.g., "1.0.0")
+- `-n, --name <name>` - Release name
+- `-d, --description <desc>` - Release description
+- `-e, --environment <env>` - Environment (default: `production`)
+- `--reviewed-only` - Include only reviewed translations
+- `--set-current` - Set this release as the current release
+- `--timestamp <iso>` - Specific timestamp for the release (ISO format)
+- `--languages <langs>` - Comma-separated list of languages to include
+- `--json` - Output as JSON
+- `-p, --project <id>` - Project ID
+- `-a, --api-key <key>` - API key
+
+**Examples:**
+```bash
+# Create a basic release
+lezu release create --version=1.0.0
+
+# Create release with specific timestamp and set as current
+lezu release create --version=1.1.0 --timestamp=2024-01-15T10:00:00Z --set-current
+
+# Create release with only reviewed translations
+lezu release create --version=1.0.1 --reviewed-only --name="Hotfix Release"
+```
+
+**Subscription Requirements:**
+- **Free**: Cannot create releases
+- **Basic**: Cannot create releases
+- **Pro+**: Can create releases
+
+#### `lezu release current <releaseId>`
+Set a release as current.
+
+**Usage:**
+```bash
+lezu release current <releaseId> [options]
+```
+
+**Example:**
+```bash
+lezu release current rel_123abc456def
+```
+
+#### `lezu release list`
+List all releases (alias for `lezu get releases`).
+
+## API Keys and Authentication
+
+### Getting an API Key
+1. Go to [Lezu Dashboard](https://app.lezu.app)
+2. Navigate to your project settings
+3. Go to the "API Keys" section
+4. Click "Create API Key"
+5. Copy the generated key (it will only be shown once)
+
+### API Key Scopes
+API keys have different capabilities based on your subscription:
+
+**Free Plan:**
+- ✅ Download translations (`load`)
+- ✅ Get project information (`get`)
+- ❌ Add keys (`add`)
+- ❌ Create releases (`release create`)
+
+**Basic Plan:**
+- ✅ All Free features
+- ✅ Add translation keys (`add`)
+- ✅ Update translations
+- ❌ Create releases
+
+**Pro+ Plans:**
+- ✅ All Basic features
+- ✅ Create releases (`release create`)
+- ✅ Auto-translation with AI
+- ✅ Higher rate limits
+
+### Rate Limits
+Rate limits are applied per API key per minute:
+
+| Plan | Requests/min | Translations/min |
+|------|-------------|------------------|
+| Free | 50 | 10 |
+| Basic | 500 | 100 |
+| Pro | 5,000 | 1,000 |
+| Team | 10,000 | 2,000 |
+| Enterprise | 50,000 | 10,000 |
+
+## Error Handling
+
+The CLI provides clear error messages for common issues:
+
+- **401 Unauthorized**: Invalid API key
+- **402 Payment Required**: Subscription required or expired
+- **403 Forbidden**: Feature requires subscription upgrade
+- **404 Not Found**: Project or resource not found
+- **429 Too Many Requests**: Rate limit exceeded
+
+## Troubleshooting
+
+### Common Issues
+
+**"Configuration errors: Project ID is required"**
+- Set `LEZU_PROJECT_ID` environment variable
+- Or use `--project` flag
+- Or add `projectId` to `.lezurc` file
+
+**"API request failed: 401 Unauthorized"**
+- Check your API key is correct
+- Ensure the API key hasn't expired
+- Verify the API key belongs to the correct project
+
+**"Subscription upgrade required"**
+- Your current plan doesn't support this feature
+- Upgrade your subscription at [app.lezu.app/billing](https://app.lezu.app/billing)
+
+**"Rate limit exceeded"**
+- Wait for the rate limit window to reset
+- Consider upgrading your subscription for higher limits
+
+### Debug Mode
+Set the `DEBUG` environment variable to see detailed logs:
+
+```bash
+DEBUG=lezu* npx lezu load
+```
+
+## Integration Examples
+
+### CI/CD Pipeline
+```yaml
+# GitHub Actions example
+- name: Download translations
+  run: npx lezu load
+  env:
+    LEZU_PROJECT_ID: ${{ secrets.LEZU_PROJECT_ID }}
+    LEZU_API_KEY: ${{ secrets.LEZU_API_KEY }}
+```
+
+### Package.json Scripts
+```json
+{
+  "scripts": {
+    "i18n:pull": "lezu load",
+    "i18n:watch": "lezu load --watch",
+    "i18n:release": "lezu release create --version=$npm_package_version"
+  }
+}
+```
+
+### Pre-build Hook
+```json
+{
+  "scripts": {
+    "prebuild": "lezu load --format=js",
+    "build": "vite build"
+  }
+}
+```
+
+## Support
+
+- 📖 [Documentation](https://docs.lezu.app)
+- 💬 [Discord Community](https://discord.gg/lezu)
+- 📧 [Email Support](mailto:support@lezu.app)
+- 🐛 [Report Issues](https://github.com/lezu-app/cli/issues)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.

package/dist/api-CS5JMU72.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import {
+  LezuApiClient
+} from "./chunk-UN7HQJOX.js";
+export {
+  LezuApiClient
+};
+//# sourceMappingURL=api-CS5JMU72.js.map

package/dist/api-CS5JMU72.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-2MDUFSO7.js

@@ -0,0 +1,249 @@
+#!/usr/bin/env node
+import {
+  loadConfig,
+  validateConfig
+} from "./chunk-VGQICGPH.js";
+import {
+  LezuApiClient
+} from "./chunk-UN7HQJOX.js";
+
+// src/commands/load.ts
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+
+// src/writer.ts
+import { writeFileSync, mkdirSync } from "fs";
+import { dirname, join } from "path";
+var TranslationWriter = class {
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  write(translations) {
+    mkdirSync(this.config.dest, { recursive: true });
+    for (const [language, content] of Object.entries(translations)) {
+      const processedContent = this.processContent(content);
+      const filePath = this.getFilePath(language);
+      mkdirSync(dirname(filePath), { recursive: true });
+      const fileContent = this.formatContent(processedContent, language);
+      writeFileSync(filePath, fileContent, "utf-8");
+      console.log(`\u2705 Written ${language} translations to ${filePath}`);
+    }
+  }
+  processContent(content) {
+    if (this.config.flatten) {
+      return this.flattenObject(content);
+    }
+    if (!this.config.includeEmpty) {
+      return this.removeEmptyValues(content);
+    }
+    return content;
+  }
+  flattenObject(obj, prefix = "") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+      const newKey = prefix ? `${prefix}.${key}` : key;
+      if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+        Object.assign(result, this.flattenObject(value, newKey));
+      } else {
+        result[newKey] = value;
+      }
+    }
+    return result;
+  }
+  removeEmptyValues(obj) {
+    if (typeof obj !== "object" || obj === null) {
+      return obj;
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+      if (typeof value === "object" && value !== null) {
+        const cleaned = this.removeEmptyValues(value);
+        if (Object.keys(cleaned).length > 0) {
+          result[key] = cleaned;
+        }
+      } else if (value !== "" && value !== null && value !== void 0) {
+        result[key] = value;
+      }
+    }
+    return result;
+  }
+  getFilePath(language) {
+    const extension = this.getFileExtension();
+    if (this.config.namespace) {
+      return join(this.config.dest, "locales", `${language}.${extension}`);
+    } else {
+      return join(this.config.dest, `${language}.${extension}`);
+    }
+  }
+  getFileExtension() {
+    switch (this.config.format) {
+      case "json":
+        return "json";
+      case "js":
+        return "js";
+      case "ts":
+        return "ts";
+      case "yaml":
+        return "yaml";
+      case "po":
+        return "po";
+      default:
+        return "json";
+    }
+  }
+  formatContent(content, language) {
+    switch (this.config.format) {
+      case "json":
+        return JSON.stringify(content, null, 2);
+      case "js":
+        return `export default ${JSON.stringify(content, null, 2)}`;
+      case "ts":
+        return `const translations = ${JSON.stringify(content, null, 2)} as const
+
+export default translations`;
+      case "yaml":
+        return this.toYaml(content);
+      case "po":
+        return this.toPo(content, language);
+      default:
+        return JSON.stringify(content, null, 2);
+    }
+  }
+  toYaml(obj, indent = 0) {
+    let result = "";
+    const spaces = " ".repeat(indent);
+    for (const [key, value] of Object.entries(obj)) {
+      if (typeof value === "object" && value !== null) {
+        result += `${spaces}${key}:
+${this.toYaml(value, indent + 2)}`;
+      } else {
+        const escapedValue = String(value).includes(":") || String(value).includes("#") ? `"${String(value).replace(/"/g, '\\"')}"` : value;
+        result += `${spaces}${key}: ${escapedValue}
+`;
+      }
+    }
+    return result;
+  }
+  toPo(obj, language) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    let result = `# Translation file for ${language}
+# Generated by Lezu CLI on ${now}
+msgid ""
+msgstr ""
+"Language: ${language}\\n"
+"MIME-Version: 1.0\\n"
+"Content-Type: text/plain; charset=UTF-8\\n"
+"Content-Transfer-Encoding: 8bit\\n"
+"Generated-By: Lezu CLI\\n"
+
+`;
+    const flatEntries = this.flattenForPo(obj);
+    for (const [key, value] of Object.entries(flatEntries)) {
+      const escapedKey = this.escapePoString(key);
+      const escapedValue = this.escapePoString(String(value));
+      result += `msgid "${escapedKey}"
+`;
+      result += `msgstr "${escapedValue}"
+
+`;
+    }
+    return result;
+  }
+  flattenForPo(obj, prefix = "") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+      const fullKey = prefix ? `${prefix}.${key}` : key;
+      if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+        Object.assign(result, this.flattenForPo(value, fullKey));
+      } else {
+        result[fullKey] = String(value);
+      }
+    }
+    return result;
+  }
+  escapePoString(str) {
+    return str.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t");
+  }
+};
+
+// src/commands/load.ts
+function createLoadCommand() {
+  const command = new Command("load").description("Download translation files from Lezu").option("-p, --project <id>", "Project ID").option("-k, --api-key <key>", "API key").option("-d, --dest <path>", "Destination folder", "./src/i18n").option("-f, --format <format>", "Output format (json, js, ts, yaml, po)", "json").option("-l, --languages <languages>", "Comma-separated list of languages to download").option("-r, --release <id>", "Specific release ID").option("-e, --environment <env>", "Environment", "production").option("--api-url <url>", "API URL", "https://api.lezu.app").option("--flatten", "Flatten nested keys").option("--namespace", "Use namespace folder structure").option("--include-empty", "Include empty translations").option("-w, --watch", "Watch for changes").option("--watch-interval <ms>", "Watch interval in milliseconds", "5000").action(async (options) => {
+    try {
+      if (options.languages) {
+        options.languages = options.languages.split(",").map((l) => l.trim());
+      }
+      if (options.watchInterval) {
+        options.watchInterval = parseInt(options.watchInterval, 10);
+      }
+      const config = loadConfig(options);
+      const errors = validateConfig(config);
+      if (errors.length > 0) {
+        console.error(chalk.red("Configuration errors:"));
+        errors.forEach((error) => console.error(chalk.red(`  \u2022 ${error}`)));
+        process.exit(1);
+      }
+      await syncTranslations(config);
+      if (config.watch) {
+        console.log(chalk.cyan(`
+\u{1F441}  Watching for changes every ${config.watchInterval}ms...`));
+        console.log(chalk.gray("Press Ctrl+C to stop"));
+        setInterval(async () => {
+          console.log(chalk.gray("\n\u{1F504} Checking for updates..."));
+          await syncTranslations(config);
+        }, config.watchInterval);
+      }
+    } catch (error) {
+      console.error(chalk.red("\n\u274C Error:"), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+  return command;
+}
+async function syncTranslations(config) {
+  const spinner = ora("Connecting to Lezu API...").start();
+  try {
+    const client = new LezuApiClient(config);
+    if (!config.release && config.environment) {
+      spinner.text = "Fetching latest release...";
+      const latestRelease = await client.getLatestRelease();
+      if (latestRelease) {
+        config.release = latestRelease;
+        spinner.succeed(`Using latest release: ${latestRelease}`);
+        spinner.start("Fetching translations...");
+      } else {
+        spinner.info("No releases found, fetching current translations...");
+        spinner.start();
+      }
+    }
+    spinner.text = "Fetching translations...";
+    const response = await client.getTranslations();
+    if (!response.translations || Object.keys(response.translations).length === 0) {
+      spinner.fail("No translations found");
+      return;
+    }
+    spinner.succeed(`Fetched translations for ${Object.keys(response.translations).length} languages`);
+    const writer = new TranslationWriter(config);
+    writer.write(response.translations);
+    console.log(chalk.green("\n\u2728 Translations synced successfully!"));
+    console.log(chalk.gray("\nSummary:"));
+    console.log(chalk.gray(`  \u2022 Project: ${config.projectId}`));
+    console.log(chalk.gray(`  \u2022 Languages: ${Object.keys(response.translations).join(", ")}`));
+    console.log(chalk.gray(`  \u2022 Destination: ${config.dest}`));
+    console.log(chalk.gray(`  \u2022 Format: ${config.format}`));
+    if (response.meta?.version) {
+      console.log(chalk.gray(`  \u2022 Version: ${response.meta.version}`));
+    }
+  } catch (error) {
+    spinner.fail("Failed to sync translations");
+    throw error;
+  }
+}
+
+export {
+  createLoadCommand,
+  syncTranslations
+};
+//# sourceMappingURL=chunk-2MDUFSO7.js.map