langctl 0.2.0 → 0.3.0

package/dist/version.js

@@ -0,0 +1,4 @@
+import { createRequire } from 'module';
+// Single source of truth: package.json (was hardcoded in two places in 0.2.x)
+const pkg = createRequire(import.meta.url)('../package.json');
+export const VERSION = pkg.version;

package/package.json

@@ -1,18 +1,20 @@
 {
   "name": "langctl",
-  "version": "0.2.0",
-  "description": "Translation management CLI for developers. Manage i18n translations, export to 6 formats (iOS, Android, Flutter, i18next), import translations, and collaborate with teams. Affordable alternative to Lokalise and Crowdin.",
+  "version": "0.3.0",
+  "description": "Translation management CLI for developers: sync i18n files (JSON, Android, iOS, Flutter ARB) between your repo, CI and Langctl.",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
     "langctl": "dist/index.js"
   },
   "scripts": {
-    "build": "rm -rf dist && tsc",
+    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.build.json",
     "dev": "tsx src/index.ts",
     "start": "node dist/index.js",
-    "prepublishOnly": "npm run build",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:e2e": "bash test/e2e.sh",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
   },
   "keywords": [
     "translation",
@@ -77,26 +79,31 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/siddharthsaxena0/langctl.git"
+    "url": "git+https://github.com/litcode-pvt-ltd/langctl-cli.git"
   },
   "bugs": {
-    "url": "https://github.com/siddharthsaxena0/langctl/issues"
+    "url": "https://github.com/litcode-pvt-ltd/langctl-cli/issues"
   },
   "homepage": "https://langctl.com",
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=20"
   },
   "dependencies": {
     "chalk": "^5.6.2",
-    "commander": "^14.0.2",
-    "conf": "^15.0.2",
-    "inquirer": "^13.1.0",
-    "ora": "^9.0.0"
+    "commander": "^14.0.2"
   },
   "devDependencies": {
-    "@types/inquirer": "^9.0.9",
     "@types/node": "^25.0.3",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3"
-  }
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "!dist/**/*.d.ts",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ]
 }

package/.gitattributes

@@ -1,2 +0,0 @@
-# Auto detect text files and perform LF normalization
-* text=auto

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,26 +0,0 @@
----
-name: Bug Report
-about: Report a bug or unexpected behavior
-title: ''
-labels: bug
-assignees: ''
----
-
-**Describe the bug**
-A clear description of what the bug is.
-
-**To reproduce**
-Steps to reproduce:
-1. Run `langctl ...`
-2. ...
-
-**Expected behavior**
-What you expected to happen.
-
-**Environment**
-- OS: [e.g. macOS 14, Ubuntu 22.04]
-- Node.js version: [e.g. 18.17.0]
-- langctl version: [output of `langctl --version`]
-
-**Additional context**
-Add any other context, logs, or screenshots.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,19 +0,0 @@
----
-name: Feature Request
-about: Suggest a new feature or improvement
-title: ''
-labels: enhancement
-assignees: ''
----
-
-**Problem**
-What problem does this feature solve?
-
-**Proposed solution**
-Describe how you'd like this to work.
-
-**Alternatives considered**
-Any alternative solutions or workarounds you've tried.
-
-**Additional context**
-Any other context, examples, or references.

package/CONTRIBUTING.md

@@ -1,33 +0,0 @@
-# Contributing to langctl
-
-Thanks for your interest in contributing! Here's how to get started.
-
-## Development Setup
-
-```bash
-git clone https://github.com/siddharthsaxena0/langctl.git
-cd langctl
-npm install
-npm run dev   # runs tsx watch
-```
-
-## Making Changes
-
-1. Fork the repo and create a feature branch from `main`
-2. Make your changes
-3. Test locally with `npm run dev`
-4. Submit a pull request
-
-## Reporting Bugs
-
-Use the [bug report template](https://github.com/siddharthsaxena0/langctl/issues/new?template=bug_report.md) and include your `langctl --version`, Node.js version, and OS.
-
-## Code Style
-
-- TypeScript with strict mode
-- Use `commander` for CLI commands
-- Keep commands in `src/commands/`
-
-## License
-
-By contributing, you agree that your contributions will be licensed under the MIT License.

package/dist/api.d.ts

@@ -1,20 +0,0 @@
-export declare class ApiClient {
-    private baseUrl;
-    private apiKey;
-    constructor(baseUrl: string, apiKey: string);
-    private request;
-    get<T>(path: string, params?: Record<string, string>): Promise<T>;
-    post<T>(path: string, body?: unknown): Promise<T>;
-    patch<T>(path: string, body: unknown): Promise<T>;
-    delete<T>(path: string): Promise<T>;
-}
-/**
- * Create an API client from the current config.
- * Throws if not authenticated.
- */
-export declare function getApiClient(): ApiClient;
-/**
- * Create an API client with a specific API key (for auth flow before key is saved).
- */
-export declare function createApiClient(apiKey: string): ApiClient;
-//# sourceMappingURL=api.d.ts.map

package/dist/api.js

@@ -1,75 +0,0 @@
-import { config } from './config.js';
-const DEFAULT_API_URL = 'https://api.langctl.com/api/v1';
-export class ApiClient {
-    constructor(baseUrl, apiKey) {
-        this.baseUrl = baseUrl.replace(/\/$/, '');
-        this.apiKey = apiKey;
-    }
-    async request(method, path, body, params) {
-        let url = `${this.baseUrl}${path}`;
-        if (params && Object.keys(params).length > 0) {
-            const searchParams = new URLSearchParams();
-            for (const [key, value] of Object.entries(params)) {
-                if (value !== undefined && value !== null && value !== '') {
-                    searchParams.append(key, value);
-                }
-            }
-            const qs = searchParams.toString();
-            if (qs)
-                url += `?${qs}`;
-        }
-        const headers = {
-            'X-API-Key': this.apiKey,
-        };
-        if (body !== undefined) {
-            headers['Content-Type'] = 'application/json';
-        }
-        const response = await fetch(url, {
-            method,
-            headers,
-            body: body !== undefined ? JSON.stringify(body) : undefined,
-            signal: AbortSignal.timeout(30000),
-        });
-        if (!response.ok) {
-            const errorData = await response.json().catch(() => ({}));
-            throw new Error(errorData.error || errorData.message || `HTTP ${response.status}: ${response.statusText}`);
-        }
-        // Handle 204 No Content
-        if (response.status === 204) {
-            return undefined;
-        }
-        return response.json();
-    }
-    async get(path, params) {
-        return this.request('GET', path, undefined, params);
-    }
-    async post(path, body) {
-        return this.request('POST', path, body);
-    }
-    async patch(path, body) {
-        return this.request('PATCH', path, body);
-    }
-    async delete(path) {
-        return this.request('DELETE', path);
-    }
-}
-/**
- * Create an API client from the current config.
- * Throws if not authenticated.
- */
-export function getApiClient() {
-    const apiKey = config.get('apiKey');
-    const baseUrl = config.get('apiBaseUrl') || DEFAULT_API_URL;
-    if (!apiKey) {
-        throw new Error('Not authenticated. Please run "langctl auth <api-key>" first.');
-    }
-    return new ApiClient(baseUrl, apiKey);
-}
-/**
- * Create an API client with a specific API key (for auth flow before key is saved).
- */
-export function createApiClient(apiKey) {
-    const baseUrl = config.get('apiBaseUrl') || DEFAULT_API_URL;
-    return new ApiClient(baseUrl, apiKey);
-}
-//# sourceMappingURL=api.js.map

package/dist/auth.d.ts

@@ -1,38 +0,0 @@
-export interface ApiKeyData {
-    organizationId: string;
-    organization: {
-        id: string;
-        name: string;
-        slug: string;
-        plan: string;
-    };
-}
-/**
- * Verify API key via Fastify API
- */
-export declare function verifyApiKey(plainTextKey: string): Promise<ApiKeyData | null>;
-/**
- * Authenticate and save credentials to config
- */
-export declare function authenticate(apiKey: string): Promise<{
-    success: boolean;
-    message: string;
-    data?: ApiKeyData;
-}>;
-/**
- * Check if user is authenticated
- */
-export declare function isAuthenticated(): boolean;
-/**
- * Get current organization ID
- */
-export declare function getOrganizationId(): string | undefined;
-/**
- * Get current API key
- */
-export declare function getApiKey(): string | undefined;
-/**
- * Logout (clear authentication)
- */
-export declare function logout(): void;
-//# sourceMappingURL=auth.d.ts.map

package/dist/auth.js

@@ -1,106 +0,0 @@
-import { config } from './config.js';
-import { createApiClient } from './api.js';
-// Normalize and validate API key input
-function sanitizeApiKey(input) {
-    const raw = (input || '').trim().toLowerCase();
-    if (!raw.startsWith('lc_')) {
-        return { ok: false, message: 'API key must start with lc_' };
-    }
-    const hex = raw.slice(3); // after lc_
-    const hexOnly = hex.replace(/[^a-f0-9]/g, '');
-    if (hexOnly.length !== 64) {
-        return { ok: false, message: 'Invalid API key format. Expected lc_ followed by 64 hex characters' };
-    }
-    return { ok: true, key: `lc_${hexOnly}` };
-}
-/**
- * Verify API key via Fastify API
- */
-export async function verifyApiKey(plainTextKey) {
-    try {
-        const sanitized = sanitizeApiKey(plainTextKey);
-        if (!sanitized.ok || !sanitized.key) {
-            return null;
-        }
-        // Create a temporary API client with the key to validate
-        const client = createApiClient(sanitized.key);
-        // Validate the API key
-        const validateResult = await client.post('/api-keys/validate', {
-            apiKey: sanitized.key,
-        });
-        if (!validateResult.valid) {
-            return null;
-        }
-        // Fetch organization details
-        const org = await client.get(`/orgs/${validateResult.organizationId}`);
-        return {
-            organizationId: validateResult.organizationId,
-            organization: {
-                id: org.id,
-                name: org.name,
-                slug: org.slug,
-                plan: org.plan,
-            },
-        };
-    }
-    catch (error) {
-        return null;
-    }
-}
-/**
- * Authenticate and save credentials to config
- */
-export async function authenticate(apiKey) {
-    const sanitized = sanitizeApiKey(apiKey);
-    if (!sanitized.ok || !sanitized.key) {
-        return {
-            success: false,
-            message: sanitized.message || 'Invalid API key format. Expected format: lc_[64 hex characters]',
-        };
-    }
-    // Verify via Fastify API
-    const keyData = await verifyApiKey(sanitized.key);
-    if (!keyData) {
-        return {
-            success: false,
-            message: 'Invalid or revoked API key. Please check your key and try again.',
-        };
-    }
-    // Save to config
-    config.set('apiKey', sanitized.key);
-    config.set('organizationId', keyData.organizationId);
-    config.set('organizationName', keyData.organization.name);
-    return {
-        success: true,
-        message: `Successfully authenticated as ${keyData.organization.name}`,
-        data: keyData,
-    };
-}
-/**
- * Check if user is authenticated
- */
-export function isAuthenticated() {
-    return !!(config.get('apiKey') && config.get('organizationId'));
-}
-/**
- * Get current organization ID
- */
-export function getOrganizationId() {
-    return config.get('organizationId');
-}
-/**
- * Get current API key
- */
-export function getApiKey() {
-    return config.get('apiKey');
-}
-/**
- * Logout (clear authentication)
- */
-export function logout() {
-    config.delete('apiKey');
-    config.delete('organizationId');
-    config.delete('organizationName');
-    config.delete('defaultProject');
-}
-//# sourceMappingURL=auth.js.map

package/dist/commands/auth.d.ts

@@ -1,3 +0,0 @@
-export declare function authCommand(apiKey: string): Promise<void>;
-export declare function logoutCommand(): Promise<void>;
-//# sourceMappingURL=auth.d.ts.map

package/dist/commands/config.d.ts

@@ -1,2 +0,0 @@
-export declare function configCommand(): void;
-//# sourceMappingURL=config.d.ts.map

package/dist/commands/debug.d.ts

@@ -1,3 +0,0 @@
-export declare function debugListApiKeys(): Promise<void>;
-export declare function debugListOrganizations(): Promise<void>;
-//# sourceMappingURL=debug.d.ts.map

package/dist/commands/debug.js

@@ -1,61 +0,0 @@
-import chalk from 'chalk';
-import ora from 'ora';
-import { isAuthenticated } from '../auth.js';
-import { getApiClient } from '../api.js';
-import { config } from '../config.js';
-export async function debugListApiKeys() {
-    if (!isAuthenticated()) {
-        console.log(chalk.red('✗ Not authenticated.\n'));
-        process.exitCode = 1;
-        return;
-    }
-    const orgId = config.get('organizationId');
-    if (!orgId) {
-        console.log(chalk.red('✗ No organization configured.\n'));
-        process.exitCode = 1;
-        return;
-    }
-    const spinner = ora('Testing API connection...').start();
-    try {
-        const api = getApiClient();
-        const org = await api.get(`/orgs/${orgId}`);
-        spinner.succeed(chalk.green(`API connection successful`));
-        console.log(chalk.blue.bold('\n🔧 Debug Info\n'));
-        console.log(chalk.white(`Organization: ${org.name}`));
-        console.log(chalk.white(`Plan: ${org.plan}`));
-        console.log(chalk.gray(`API URL: ${config.get('apiBaseUrl') || 'https://api.langctl.com/api/v1'}`));
-        console.log(chalk.gray(`Config: ${config.getConfigPath()}`));
-        console.log('');
-    }
-    catch (error) {
-        spinner.fail(chalk.red('API connection failed'));
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exitCode = 1;
-    }
-}
-export async function debugListOrganizations() {
-    if (!isAuthenticated()) {
-        console.log(chalk.red('✗ Not authenticated.\n'));
-        process.exitCode = 1;
-        return;
-    }
-    const orgId = config.get('organizationId');
-    if (!orgId) {
-        console.log(chalk.red('✗ No organization configured.\n'));
-        process.exitCode = 1;
-        return;
-    }
-    const spinner = ora('Fetching organization...').start();
-    try {
-        const api = getApiClient();
-        const org = await api.get(`/orgs/${orgId}`);
-        spinner.succeed(chalk.green('Found organization'));
-        console.log(`${chalk.cyan(org.id)}  ${chalk.white(org.name)}  plan=${chalk.magenta(org.plan)}  created=${chalk.gray(org.createdAt)}`);
-    }
-    catch (error) {
-        spinner.fail(chalk.red('Failed to fetch organization'));
-        console.error(chalk.red(`Error: ${error.message}\n`));
-        process.exitCode = 1;
-    }
-}
-//# sourceMappingURL=debug.js.map

package/dist/commands/export.d.ts

@@ -1,13 +0,0 @@
-interface ExportOptions {
-    language?: string;
-    format?: string;
-    output?: string;
-    module?: string;
-    includeUnpublished?: boolean;
-}
-/**
- * Export translations command
- */
-export declare function exportCommand(projectSlug: string, options: ExportOptions): Promise<void>;
-export {};
-//# sourceMappingURL=export.d.ts.map

package/dist/commands/import.d.ts

@@ -1,12 +0,0 @@
-interface ImportOptions {
-    language: string;
-    overwrite?: boolean;
-    module?: string;
-    publish?: boolean;
-}
-/**
- * Import translations command
- */
-export declare function importCommand(projectSlug: string, filePath: string, options: ImportOptions): Promise<void>;
-export {};
-//# sourceMappingURL=import.d.ts.map

package/dist/commands/init.d.ts

@@ -1,2 +0,0 @@
-export declare function initCommand(): Promise<void>;
-//# sourceMappingURL=init.d.ts.map

package/dist/commands/keys.d.ts

@@ -1,25 +0,0 @@
-/**
- * List translation keys
- */
-export declare function listKeysCommand(projectSlug: string, options: any): Promise<void>;
-/**
- * Get single key
- */
-export declare function getKeyCommand(projectSlug: string, keyName: string): Promise<void>;
-/**
- * Create translation key
- */
-export declare function createKeyCommand(projectSlug: string, keyName: string, options: any): Promise<void>;
-/**
- * Delete translation key
- */
-export declare function deleteKeyCommand(projectSlug: string, keyName: string): Promise<void>;
-/**
- * Update single translation
- */
-export declare function translateKeyCommand(projectSlug: string, keyName: string, options: any): Promise<void>;
-/**
- * Publish/unpublish keys
- */
-export declare function publishKeysCommand(projectSlug: string, keys: string[], options: any): Promise<void>;
-//# sourceMappingURL=keys.d.ts.map

package/dist/commands/org.d.ts

@@ -1,13 +0,0 @@
-/**
- * Get organization information
- */
-export declare function orgInfoCommand(): Promise<void>;
-/**
- * Get organization statistics
- */
-export declare function orgStatsCommand(): Promise<void>;
-/**
- * Get organization plan and limits
- */
-export declare function orgPlanCommand(): Promise<void>;
-//# sourceMappingURL=org.d.ts.map

package/dist/commands/projects.d.ts

@@ -1,33 +0,0 @@
-/**
- * List all projects
- */
-export declare function projectsListCommand(): Promise<void>;
-/**
- * Create new project
- */
-export declare function projectsCreateCommand(name: string, options: any): Promise<void>;
-/**
- * Get project details
- */
-export declare function projectsGetCommand(slug: string): Promise<void>;
-/**
- * Update project
- */
-export declare function projectsUpdateCommand(slug: string, options: any): Promise<void>;
-/**
- * Delete project
- */
-export declare function projectsDeleteCommand(slug: string): Promise<void>;
-/**
- * Add language to project
- */
-export declare function projectsAddLanguageCommand(slug: string, language: string): Promise<void>;
-/**
- * Remove language from project
- */
-export declare function projectsRemoveLanguageCommand(slug: string, language: string): Promise<void>;
-/**
- * Get project statistics
- */
-export declare function projectsStatsCommand(slug: string): Promise<void>;
-//# sourceMappingURL=projects.d.ts.map

package/dist/commands/pull.d.ts

@@ -1,9 +0,0 @@
-export interface PullOptions {
-    language?: string;
-    format?: string;
-    output?: string;
-    dir?: string;
-    publishedOnly?: boolean;
-}
-export declare function pullCommand(projectIdentifier: string, options: PullOptions): Promise<void>;
-//# sourceMappingURL=pull.d.ts.map

package/dist/commands/team.d.ts

@@ -1,29 +0,0 @@
-/**
- * List all team members
- */
-export declare function listTeamCommand(): Promise<void>;
-/**
- * Get team member details
- */
-export declare function getTeamMemberCommand(email: string): Promise<void>;
-/**
- * Invite team member
- */
-export declare function inviteTeamMemberCommand(email: string, options: any): Promise<void>;
-/**
- * Remove team member
- */
-export declare function removeTeamMemberCommand(email: string): Promise<void>;
-/**
- * Update team member role
- */
-export declare function updateTeamRoleCommand(email: string, role: string): Promise<void>;
-/**
- * List invitations
- */
-export declare function listInvitationsCommand(options: any): Promise<void>;
-/**
- * Revoke invitation
- */
-export declare function revokeInvitationCommand(email: string): Promise<void>;
-//# sourceMappingURL=team.d.ts.map

package/dist/config.d.ts

@@ -1,48 +0,0 @@
-export interface LangctlConfig {
-    apiKey?: string;
-    organizationId?: string;
-    organizationName?: string;
-    apiBaseUrl?: string;
-    defaultProject?: string;
-    defaultLanguage?: string;
-}
-declare class ConfigManager {
-    private config;
-    private configDir;
-    constructor();
-    /**
-     * Get a configuration value
-     */
-    get<K extends keyof LangctlConfig>(key: K): LangctlConfig[K] | undefined;
-    /**
-     * Set a configuration value
-     */
-    set<K extends keyof LangctlConfig>(key: K, value: LangctlConfig[K]): void;
-    /**
-     * Get all configuration
-     */
-    getAll(): LangctlConfig;
-    /**
-     * Set multiple configuration values
-     */
-    setAll(config: Partial<LangctlConfig>): void;
-    /**
-     * Delete a configuration value
-     */
-    delete(key: keyof LangctlConfig): void;
-    /**
-     * Clear all configuration
-     */
-    clear(): void;
-    /**
-     * Check if user is authenticated
-     */
-    isConfigured(): boolean;
-    /**
-     * Get the configuration file path
-     */
-    getConfigPath(): string;
-}
-export declare const config: ConfigManager;
-export {};
-//# sourceMappingURL=config.d.ts.map