@localheroai/cli 0.0.5 → 0.0.7

package/{README → README.md}

@@ -13,9 +13,9 @@ LocalHero.ai is an AI-powered I18n translation service that seamlessly integrate
 
 ## Getting Started 🏁
 
-1. Sign up for a free trial at [localhero.ai](https://localhero.ai/) (currently closed beta, get in touch if you are interested in trying it out)
+1. Sign up for a free trial at [localhero.ai](https://localhero.ai/).
 2. Get your API key from [localhero.ai/api-keys](https://localhero.ai/api-keys)
-3. Run the init command in your project:
+3. Run the init command in your project to setup the configuration:
    ```bash
    npx @localheroai/cli init
    ```
@@ -29,6 +29,7 @@ npx @localheroai/cli init
 ```
 
 The init command helps you set up your project with LocalHero.ai. It will:
+- Setup your API key if it hasn't been done already
 - Detect your project type (Rails, React, or generic)
 - Link to an existing LocalHero.ai project
 - Configure translation paths and file patterns
@@ -49,7 +50,9 @@ The configuration file is used by the tool to interact with your translations an
 npx @localheroai/cli login
 ```
 
-Authenticate with your LocalHero.ai account. Use this when:
+Authenticate with the API using your API key.  This will save your API key to `.localhero_key` and add the file to .gitignore if needed.
+
+Use this when:
 - Setting up a new development environment
 - Updating your API key
 - Verifying your authentication status
@@ -63,10 +66,26 @@ npx @localheroai/cli translate
 Translating your missing keys:
 - Automatically detects missing translations and sends them to the Localhero.ai translation API for translation
 - Updates translation files with any new or update translations
-- It's run manually or by GitHub Actions
+- It's run manually or by GitHub Actions. When run as a GitHub action any new translations are automatically committed to git.
+
+### Pull / push
+
+```bash
+npx @localheroai/cli pull
+```
+
+Pull the latest translation updates from LocalHero.ai to your local files. This command will download any new or modified translations from the service to your local files.
+
+```bash
+npx @localheroai/cli push
+```
+
+Push updates from your local translation files to LocalHero.ai. This command will upload any new or modified translations from your local files to the service.
 
 ## Environment Variables ⚙️
 
+Typically you don't need to set these. The cli will use `LOCALHERO_API_KEY` if it's set, otherwise it will check the file `.localhero_key` for a API key.
+
 Configure the CLI behavior with these environment variables:
 
 | Variable | Description | Default |
@@ -79,19 +98,18 @@ Configure the CLI behavior with these environment variables:
 LocalHero.ai automatically translate your I18n files when you push changes. During the `init` command, you'll be prompted to set up GitHub Actions.
 
 1. Add your API key to your repository secrets:
-   - Go to Settings > Secrets > Actions
+   - Go to Settings > Secrets and variables > Actions
    - Create a new secret named `LOCALHERO_API_KEY`
    - Add your API key as the value
 
 2. The workflow will:
-   - Run on push to your main branch
-   - Check for missing translations
-   - Create a pull request with new translations
+   - Run on push to pull requests
+   - Check for missing translations and add new/updated translations to the repo.
 
 ## Support 💬
 
-- Documentation: [localhero.ai/docs](https://docs.localhero.ai/docs)
-- Email: support@localhero.ai
+- Documentation: [localhero.ai/docs](https://localhero.ai/docs)
+- Email: hi@localhero.ai
 
 ## License 📄
 

package/dist/api/auth.d.ts

@@ -0,0 +1,2 @@
+import { VerifyApiKeyResult } from '../types/index.js';
+export declare function verifyApiKey(apiKey: string): Promise<VerifyApiKeyResult>;

package/dist/api/auth.js

@@ -0,0 +1,28 @@
+import { apiRequest } from './client.js';
+import { ApiResponseError } from '../types/index.js';
+export async function verifyApiKey(apiKey) {
+    try {
+        return await apiRequest('/api/v1/auth/verify', {
+            apiKey
+        });
+    }
+    catch (error) {
+        if (error instanceof ApiResponseError) {
+            return {
+                error: {
+                    code: error.code,
+                    message: error.message
+                }
+            };
+        }
+        return {
+            error: {
+                code: error.code || 'verification_failed',
+                message: error instanceof Error && error.message
+                    ? error.message
+                    : 'Failed to verify API key'
+            }
+        };
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/api/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/api/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAWrD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc;IAC/C,IAAI,CAAC;QACH,OAAO,MAAM,UAAU,CAAC,qBAAqB,EAAE;YAC7C,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;YACtC,OAAO;gBACL,KAAK,EAAE;oBACL,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;iBACvB;aACF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EAAG,KAAa,CAAC,IAAI,IAAI,qBAAqB;gBAClD,OAAO,EAAE,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO;oBAC9C,CAAC,CAAC,KAAK,CAAC,OAAO;oBACf,CAAC,CAAC,0BAA0B;aAC/B;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/api/client.d.ts

@@ -0,0 +1,3 @@
+import { ApiRequestOptions } from '../types/index.js';
+export declare function getApiHost(): string;
+export declare function apiRequest<T = any>(endpoint: string, options?: ApiRequestOptions): Promise<T>;

package/dist/api/client.js

@@ -0,0 +1,80 @@
+import { ApiResponseError } from '../types/index.js';
+const DEFAULT_API_HOST = 'https://api.localhero.ai';
+export function getApiHost() {
+    return process.env.LOCALHERO_API_HOST || DEFAULT_API_HOST;
+}
+function getNetworkErrorMessage(error) {
+    if (error.code === 'ECONNREFUSED') {
+        return `Unable to connect to ${getApiHost()}. Please check your internet connection and try again.`;
+    }
+    if (error.cause?.code === 'ENOTFOUND') {
+        return `Could not resolve host ${getApiHost()}. Please check your internet connection and try again.`;
+    }
+    if (error.cause?.code === 'ETIMEDOUT') {
+        return `Connection to ${getApiHost()} timed out. Please try again later.`;
+    }
+    return `Network error while connecting to ${getApiHost()}. Please check your internet connection and try again.`;
+}
+export async function apiRequest(endpoint, options = {}) {
+    const apiHost = getApiHost();
+    const url = `${apiHost}${endpoint}`;
+    const apiKey = process.env.LOCALHERO_API_KEY || options.apiKey;
+    const headers = {
+        'Content-Type': 'application/json',
+        ...options.headers
+    };
+    if (apiKey) {
+        headers['Authorization'] = `Bearer ${apiKey}`;
+    }
+    const fetchOptions = {
+        method: options.method || 'GET',
+        headers,
+    };
+    if (options.body) {
+        fetchOptions.body = JSON.stringify(options.body);
+    }
+    let response;
+    try {
+        response = await fetch(url, fetchOptions);
+    }
+    catch (error) {
+        const networkError = error;
+        const message = getNetworkErrorMessage(networkError);
+        networkError.message = message;
+        networkError.cliErrorMessage = message;
+        throw networkError;
+    }
+    let data;
+    try {
+        data = await response.json();
+    }
+    catch (error) {
+        const parseError = error;
+        const message = 'Failed to parse API response. Error: ' + error;
+        parseError.message = message;
+        parseError.cliErrorMessage = message;
+        throw parseError;
+    }
+    if (!response.ok) {
+        if (response.status === 401 && data?.error?.code === 'invalid_api_key') {
+            const message = 'Your API key is invalid or has been revoked. Please run `npx @localheroai/cli login` to update your API key.';
+            const error = new ApiResponseError(message);
+            error.cliErrorMessage = message;
+            error.code = 'invalid_api_key';
+            error.data = data;
+            error.details = null;
+            throw error;
+        }
+        const message = Array.isArray(data?.errors)
+            ? data.errors.map((err) => typeof err === 'string' ? err : err.message).join(', ')
+            : data?.error?.message || 'API request failed';
+        const error = new ApiResponseError(message);
+        error.cliErrorMessage = message;
+        error.code = data?.error?.code || 'API_ERROR';
+        error.details = data?.error?.details || null;
+        error.data = data;
+        throw error;
+    }
+    return data;
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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"}

package/dist/api/imports.d.ts

@@ -0,0 +1,5 @@
+export function createImport({ projectId, translations }: {
+    projectId: any;
+    translations: any;
+}): Promise<any>;
+export function checkImportStatus(projectId: any, importId: any): Promise<any>;

package/dist/api/imports.js

@@ -0,0 +1,43 @@
+import { getApiKey } from '../utils/auth.js';
+import { apiRequest } from './client.js';
+/**
+ * Create a new import of translations
+ * @param params Import parameters
+ * @returns The created import details
+ */
+export async function createImport(params) {
+    const apiKey = await getApiKey();
+    const response = await apiRequest(`/api/v1/projects/${params.projectId}/imports`, {
+        method: 'POST',
+        body: {
+            translations: params.translations
+        },
+        apiKey
+    });
+    return response;
+}
+export async function bulkUpdateTranslations(params) {
+    const apiKey = await getApiKey();
+    const response = await apiRequest(`/api/v1/projects/${params.projectId}/imports`, {
+        method: 'PATCH',
+        body: {
+            translations: params.translations
+        },
+        apiKey
+    });
+    return response;
+}
+/**
+ * Check the status of an import
+ * @param projectId The ID of the project
+ * @param importId The ID of the import to check
+ * @returns The import status response
+ */
+export async function checkImportStatus(projectId, importId) {
+    const apiKey = await getApiKey();
+    const response = await apiRequest(`/api/v1/projects/${projectId}/imports/${importId}`, {
+        apiKey
+    });
+    return response;
+}
+//# sourceMappingURL=imports.js.map

package/dist/api/imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.js","sourceRoot":"","sources":["../../src/api/imports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA6CzC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAA0B;IAC3D,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,oBAAoB,MAAM,CAAC,SAAS,UAAU,EAAE;QAChF,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;YACJ,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC;QACD,MAAM;KACP,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAoC;IAC/E,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,oBAAoB,MAAM,CAAC,SAAS,UAAU,EAAE;QAChF,MAAM,EAAE,OAAO;QACf,IAAI,EAAE;YACJ,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC;QACD,MAAM;KACP,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAiB,EAAE,QAAgB;IACzE,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,oBAAoB,SAAS,YAAY,QAAQ,EAAE,EAAE;QACrF,MAAM;KACP,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/api/projects.d.ts

@@ -0,0 +1,2 @@
+export function listProjects(): Promise<any>;
+export function createProject(data: any): Promise<any>;

package/dist/api/projects.js

@@ -0,0 +1,42 @@
+import { getApiKey } from '../utils/auth.js';
+import { apiRequest } from './client.js';
+/**
+ * List all projects the user has access to
+ * @returns Array of project details
+ */
+export async function listProjects() {
+    const apiKey = await getApiKey();
+    const response = await apiRequest('/api/v1/projects', { apiKey });
+    return response.projects;
+}
+/**
+ * Create a new project
+ * @param data Project creation parameters
+ * @returns The created project details
+ */
+export async function createProject(data) {
+    const apiKey = await getApiKey();
+    const response = await apiRequest('/api/v1/projects', {
+        method: 'POST',
+        body: {
+            project: {
+                name: data.name,
+                source_language: data.sourceLocale,
+                target_languages: data.targetLocales
+            }
+        },
+        apiKey
+    });
+    return response.project;
+}
+/**
+ * Get details for a specific project
+ * @param projectId The ID of the project to fetch
+ * @returns The project details
+ */
+export async function getProject(projectId) {
+    const apiKey = await getApiKey();
+    const response = await apiRequest(`/api/v1/projects/${projectId}`, { apiKey });
+    return response.project;
+}
+//# sourceMappingURL=projects.js.map

package/dist/api/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/api/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAczC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,kBAAkB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAClE,OAAO,QAAQ,CAAC,QAAQ,CAAC;AAC3B,CAAC;AAWD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAyB;IAC3D,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,kBAAkB,EAAE;QACpD,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;YACJ,OAAO,EAAE;gBACP,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,eAAe,EAAE,IAAI,CAAC,YAAY;gBAClC,gBAAgB,EAAE,IAAI,CAAC,aAAa;aACrC;SACF;QACD,MAAM;KACP,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB;IAChD,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,oBAAoB,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/E,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC"}

package/dist/api/translations.d.ts

@@ -0,0 +1,15 @@
+export function createTranslationJob({ sourceFiles, targetLocales, projectId, targetPaths }: {
+    sourceFiles: any;
+    targetLocales: any;
+    projectId: any;
+    targetPaths: any;
+}): Promise<{
+    jobs: any;
+    totalJobs: any;
+}>;
+export function checkJobStatus(jobId: any, includeTranslations?: boolean): Promise<any>;
+export function getTranslations(jobId: any): Promise<any>;
+export function getUpdates(projectId: any, { since, page }: {
+    since: any;
+    page?: number | undefined;
+}): Promise<any>;

package/dist/api/translations.js

@@ -0,0 +1,71 @@
+import { getApiKey } from '../utils/auth.js';
+import { apiRequest } from './client.js';
+import { getCurrentBranch } from '../utils/git.js';
+/**
+ * Create a new translation job
+ * @param params Job parameters
+ * @returns The created translation jobs
+ */
+export async function createTranslationJob(params) {
+    const apiKey = await getApiKey();
+    const branch = await getCurrentBranch();
+    const response = await apiRequest(`/api/v1/projects/${params.projectId}/translation_jobs`, {
+        method: 'POST',
+        body: {
+            target_languages: params.targetLocales,
+            files: params.sourceFiles.map(file => ({
+                path: file.path,
+                content: file.content,
+                format: file.format,
+                target_paths: params.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
+    };
+}
+/**
+ * Check the status of a translation job
+ * @param jobId The ID of the job to check
+ * @param includeTranslations Whether to include translations in the response
+ * @returns The job status
+ */
+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 });
+}
+/**
+ * Get translations for a completed job
+ * @param jobId The ID of the job
+ * @returns The translations
+ */
+export async function getTranslations(jobId) {
+    const apiKey = await getApiKey();
+    return apiRequest(`/api/v1/translation_jobs/${jobId}/translations`, { apiKey });
+}
+/**
+ * Get translation updates for a project
+ * @param projectId The ID of the project
+ * @param params Parameters for the request
+ * @returns The updates
+ */
+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 });
+}
+//# sourceMappingURL=translations.js.map

package/dist/api/translations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations.js","sourceRoot":"","sources":["../../src/api/translations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AA+BnD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAAkC;IAC3E,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAExC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,oBAAoB,MAAM,CAAC,SAAS,mBAAmB,EAAE;QACzF,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;YACJ,gBAAgB,EAAE,MAAM,CAAC,aAAa;YACtC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACrC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,YAAY,EAAE,MAAM,CAAC,WAAW;aACjC,CAAC,CAAC;YACH,GAAG,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,CAAC;SAC1B;QACD,MAAM;KACP,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;KAChC,CAAC;AACJ,CAAC;AAgBD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAa,EACb,mBAAmB,GAAG,KAAK;IAE3B,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,4BAA4B,KAAK,GAAG,mBAAmB,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC/G,OAAO,UAAU,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AAC1C,CAAC;AAOD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAa;IACjD,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IACjC,OAAO,UAAU,CAAC,4BAA4B,KAAK,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AAClF,CAAC;AA2BD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,SAAiB,EACjB,EAAE,KAAK,EAAE,IAAI,GAAG,CAAC,EAAoB;IAErC,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;IAEjC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC;QACtC,KAAK;QACL,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;KACtB,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC,oBAAoB,SAAS,YAAY,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AACxF,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+import { login } from './commands/login.js';
+import { pull } from './commands/pull.js';
+import { push } from './commands/push.js';
+import { init } from './commands/init.js';
+import { translate } from './commands/translate.js';
+import { configService } from './utils/config.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const program = new Command();
+function getVersion() {
+    const packageJson = JSON.parse(readFileSync(resolve(__dirname, '../package.json'), 'utf-8'));
+    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('pull')
+    .description('Pull updates from LocalHero.ai to your local files')
+    .option('-v, --verbose', 'Show detailed progress information')
+    .action(wrapCommandAction((options) => pull(options)));
+program
+    .command('push')
+    .description('Push updates from your local files to LocalHero.ai')
+    .option('-v, --verbose', 'Show detailed progress information')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .action(wrapCommandAction(async (options) => {
+    const config = await configService.getValidProjectConfig();
+    return push(config, options);
+}));
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/_sync.js

@@ -0,0 +1,22 @@
+import { syncService as defaultSyncService } from '../utils/sync-service.js';
+import chalk from 'chalk';
+export async function sync({ verbose = false } = {}, deps = { syncService: defaultSyncService }) {
+    const { syncService } = deps;
+    const { hasUpdates, updates } = await syncService.checkForUpdates({ verbose });
+    if (!hasUpdates) {
+        console.log(chalk.green('✓ All translations are up to date'));
+        return;
+    }
+    const result = await syncService.applyUpdates(updates, { verbose });
+    const { totalUpdates = 0, totalDeleted = 0 } = result;
+    if (!verbose) {
+        if (totalUpdates > 0) {
+            console.log(chalk.green(`✓ Updated ${totalUpdates} translations`));
+        }
+        if (totalDeleted > 0) {
+            console.log(chalk.green(`✓ Deleted ${totalDeleted} keys`));
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=_sync.js.map

package/dist/commands/_sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_sync.js","sourceRoot":"","sources":["../../src/commands/_sync.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,WAAW,EAAE,kBAAkB,EAAE;IAC7F,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAE/E,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAEpE,MAAM,EAAE,YAAY,GAAG,CAAC,EAAE,YAAY,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC;IAEtD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,YAAY,eAAe,CAAC,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,YAAY,OAAO,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/commands/_translate.js

@@ -0,0 +1,3 @@
+// This is a compatibility wrapper for the TypeScript implementation
+export { translate } from './translate.ts';
+//# sourceMappingURL=_translate.js.map

package/dist/commands/_translate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_translate.js","sourceRoot":"","sources":["../../src/commands/_translate.js"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1 @@
+export function init(deps?: {}): Promise<void>;