langctl 0.1.2 → 0.2.0

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,26 @@
+---
+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

@@ -0,0 +1,19 @@
+---
+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

@@ -0,0 +1,33 @@
+# 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/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Langctl
+Copyright (c) 2026 Litcode Private Limited
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,6 +1,21 @@
-# Langctl CLI
+<div align="center">
 
-> CLI-first translation management for developers
+# Langctl
+
+**CLI-first translation management for developers**
+
+[![npm version](https://img.shields.io/npm/v/langctl.svg)](https://www.npmjs.com/package/langctl)
+[![license](https://img.shields.io/npm/l/langctl.svg)](https://github.com/siddharthsaxena0/langctl/blob/main/LICENSE)
+[![npm downloads](https://img.shields.io/npm/dm/langctl.svg)](https://www.npmjs.com/package/langctl)
+
+**[Website](https://langctl.com)** · **[Documentation](https://langctl.com/docs)** · **[Get Started](https://app.langctl.com/signup)**
+
+<!-- Add a demo GIF here: -->
+<!-- ![langctl demo](assets/demo.gif) -->
+
+</div>
+
+---
 
 Langctl is a powerful command-line tool that lets you manage translations directly from your terminal. Create projects, manage translation keys, invite team members, export in multiple formats, and integrate seamlessly into your CI/CD pipeline.
 
@@ -29,13 +44,17 @@ npx langctl --help
 
 ## Quick Start
 
+> **📌 First time here?** Check out our [Getting Started Guide](https://langctl.com/docs/getting-started/introduction) on the website for a complete walkthrough!
+
 ### 1. Get Your API Key
 
-1. Visit [app.langctl.com](https://app.langctl.com) and sign in
+1. Visit **[app.langctl.com](https://app.langctl.com/signup)** and create a free account
 2. Go to **Settings → API Keys**
 3. Click **"Generate New Key"**
 4. Copy the key (it's only shown once!)
 
+> **💡 Tip:** Learn more about API keys and authentication at [langctl.com/docs/cli/authentication](https://langctl.com/docs/cli/authentication)
+
 ### 2. Authenticate
 
 ```bash
@@ -1163,20 +1182,34 @@ A: Yes! Store your API key as a secret and use it in your workflow. See [CI/CD I
 
 ---
 
-## Links
+## 🌟 Why Langctl?
 
-- **Website:** [langctl.com](https://langctl.com)
-- **Dashboard:** [app.langctl.com](https://app.langctl.com)
-- **Documentation:** [langctl.com/docs](https://langctl.com/docs)
-- **GitHub:** [github.com/siddharthsaxena0/langctl](https://github.com/siddharthsaxena0/langctl)
-- **Report Issues:** [github.com/siddharthsaxena0/langctl/issues](https://github.com/siddharthsaxena0/langctl/issues)
-- **Email Support:** [hello@langctl.com](mailto:hello@langctl.com)
+Tired of expensive translation management tools? Langctl offers:
+- ✅ **Free to start** - No credit card required
+- ✅ **90% cheaper** than enterprise alternatives
+- ✅ **Developer-first** - Built for your workflow
+- ✅ **AI-powered** - Context-aware translations
+- ✅ **Open source CLI** - Inspect, fork, contribute
+
+**[See pricing and compare features →](https://langctl.com/pricing)**
+
+---
+
+## 📚 Resources & Support
+
+- 🌐 **[Website](https://langctl.com)** - Features, pricing, and comparisons
+- 📖 **[Full Documentation](https://langctl.com/docs)** - Guides, tutorials, and best practices
+- 🎯 **[Quick Start Tutorial](https://langctl.com/docs/getting-started/quickstart)** - Step-by-step walkthrough
+- 💡 **[Integration Guides](https://langctl.com/docs/integrations/overview)** - React, Angular, Vue, iOS, Android, Flutter
+- 📊 **[Dashboard](https://app.langctl.com)** - Manage translations visually
+- 💬 **[Get Support](https://langctl.com/contact)** - Email us at [hello@langctl.com](mailto:hello@langctl.com)
+- 🐛 **[Report Issues](https://github.com/siddharthsaxena0/langctl/issues)** - Bug reports and feature requests
 
 ---
 
 ## Contributing
 
-We welcome contributions! Please see our [contributing guidelines](CONTRIBUTING.md) for details.
+We welcome contributions! This is an open-source project and we'd love your help making it better.
 
 ---
 
@@ -1184,8 +1217,16 @@ We welcome contributions! Please see our [contributing guidelines](CONTRIBUTING.
 
 MIT License - see [LICENSE](LICENSE) file for details.
 
+Copyright © 2026 Litcode Private Limited. All rights reserved.
+
 ---
 
+<div align="center">
+
 **Built with ❤️ by the Langctl team**
 
 *Making translation management simple, fast, and developer-friendly.*
+
+**[Get Started Free →](https://app.langctl.com/signup)**
+
+</div>

package/dist/api.d.ts

@@ -0,0 +1,20 @@
+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

@@ -0,0 +1,75 @@
+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,13 +1,14 @@
 export interface ApiKeyData {
-    organization_id: string;
+    organizationId: string;
     organization: {
         id: string;
         name: string;
+        slug: string;
         plan: string;
     };
 }
 /**
- * Verify API key via Edge Function
+ * Verify API key via Fastify API
  */
 export declare function verifyApiKey(plainTextKey: string): Promise<ApiKeyData | null>;
 /**

package/dist/auth.js

@@ -1,6 +1,5 @@
 import { config } from './config.js';
-// Edge Function URL
-const EDGE_FUNCTION_URL = 'https://bcgnmvkgkbhbxzzflwdb.supabase.co/functions/v1/verify-api-key';
+import { createApiClient } from './api.js';
 // Normalize and validate API key input
 function sanitizeApiKey(input) {
     const raw = (input || '').trim().toLowerCase();
@@ -15,7 +14,7 @@ function sanitizeApiKey(input) {
     return { ok: true, key: `lc_${hexOnly}` };
 }
 /**
- * Verify API key via Edge Function
+ * Verify API key via Fastify API
  */
 export async function verifyApiKey(plainTextKey) {
     try {
@@ -23,33 +22,28 @@ export async function verifyApiKey(plainTextKey) {
         if (!sanitized.ok || !sanitized.key) {
             return null;
         }
-        // Call Edge Function
-        const response = await fetch(EDGE_FUNCTION_URL, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify({ apiKey: sanitized.key })
+        // 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 (!response.ok) {
-            return null;
-        }
-        const data = await response.json();
-        if (!data.success) {
+        if (!validateResult.valid) {
             return null;
         }
-        // Map Edge Function response to ApiKeyData format
+        // Fetch organization details
+        const org = await client.get(`/orgs/${validateResult.organizationId}`);
         return {
-            organization_id: data.organizationId,
+            organizationId: validateResult.organizationId,
             organization: {
-                id: data.organizationId,
-                name: data.organizationName,
-                plan: data.plan
-            }
+                id: org.id,
+                name: org.name,
+                slug: org.slug,
+                plan: org.plan,
+            },
         };
     }
     catch (error) {
-        console.error('Error verifying API key:', error);
         return null;
     }
 }
@@ -61,25 +55,25 @@ export async function authenticate(apiKey) {
     if (!sanitized.ok || !sanitized.key) {
         return {
             success: false,
-            message: sanitized.message || 'Invalid API key format. Expected format: lc_[64 hex characters]'
+            message: sanitized.message || 'Invalid API key format. Expected format: lc_[64 hex characters]',
         };
     }
-    // Verify via Edge Function
+    // 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.'
+            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.organization_id);
+    config.set('organizationId', keyData.organizationId);
     config.set('organizationName', keyData.organization.name);
     return {
         success: true,
         message: `Successfully authenticated as ${keyData.organization.name}`,
-        data: keyData
+        data: keyData,
     };
 }
 /**

package/dist/commands/auth.js

@@ -2,16 +2,7 @@ import chalk from 'chalk';
 import ora from 'ora';
 import { authenticate, logout } from '../auth.js';
 import { config } from '../config.js';
-import { initializeSupabase } from '../supabase.js';
 export async function authCommand(apiKey) {
-    // Initialize Supabase (with hardcoded credentials)
-    try {
-        initializeSupabase();
-    }
-    catch (error) {
-        console.log(chalk.red('✗ Failed to connect to Langctl servers.\n'));
-        return;
-    }
     const spinner = ora('Authenticating...').start();
     const result = await authenticate(apiKey);
     if (result.success) {
@@ -20,10 +11,11 @@ export async function authCommand(apiKey) {
     }
     else {
         spinner.fail(chalk.red(result.message));
+        process.exitCode = 1;
         console.log(chalk.yellow('\nTroubleshooting:'));
         console.log(chalk.white('  - Check that your API key is correct'));
         console.log(chalk.white('  - Verify the key is not revoked in the dashboard'));
-        console.log(chalk.white('  - Generate a new key: https://langctl.com/dashboard/settings/api-keys\n'));
+        console.log(chalk.white('  - Generate a new key: https://app.langctl.com/dashboard/settings/api-keys\n'));
     }
 }
 export async function logoutCommand() {

package/dist/commands/config.js

@@ -9,6 +9,7 @@ export function configCommand() {
     }
     // Display config with masked sensitive values
     const displayConfig = {
+        apiBaseUrl: allConfig.apiBaseUrl || 'https://api.langctl.com/api/v1 (default)',
         apiKey: allConfig.apiKey ? maskApiKey(allConfig.apiKey) : undefined,
         organizationId: allConfig.organizationId,
         organizationName: allConfig.organizationName,

package/dist/commands/debug.js

@@ -1,57 +1,61 @@
 import chalk from 'chalk';
 import ora from 'ora';
-import { getSupabase, initializeSupabase } from '../supabase.js';
+import { isAuthenticated } from '../auth.js';
+import { getApiClient } from '../api.js';
+import { config } from '../config.js';
 export async function debugListApiKeys() {
-    // Initialize supabase (with hardcoded credentials)
-    try {
-        initializeSupabase();
-    }
-    catch (e) {
-        console.error(chalk.red('✗ Failed to connect to Langctl servers.'));
+    if (!isAuthenticated()) {
+        console.log(chalk.red('✗ Not authenticated.\n'));
+        process.exitCode = 1;
         return;
     }
-    const supabase = getSupabase();
-    const spinner = ora('Fetching API keys (debug)...').start();
-    const { data, error } = await supabase
-        .from('api_keys')
-        .select('id, name, key_prefix, organization_id, revoked, created_at, last_used_at')
-        .limit(100);
-    if (error) {
-        spinner.fail(chalk.red(`Error fetching API keys: ${error.message}`));
-        console.log(chalk.yellow('Hint: This is a debug command and may require elevated permissions.'));
+    const orgId = config.get('organizationId');
+    if (!orgId) {
+        console.log(chalk.red('✗ No organization configured.\n'));
+        process.exitCode = 1;
         return;
     }
-    spinner.succeed(chalk.green(`Found ${data?.length || 0} API keys`));
-    if (!data || data.length === 0) {
-        console.log(chalk.yellow('No API keys visible with current permissions.'));
-        return;
-    }
-    for (const row of data) {
-        console.log(`${chalk.cyan(row.id)}  ${chalk.white(row.name)}  prefix=${chalk.magenta(row.key_prefix)}  org=${chalk.yellow(row.organization_id)}  revoked=${row.revoked ? chalk.red('true') : chalk.green('false')}  last_used=${chalk.gray(row.last_used_at || 'never')}`);
+    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() {
-    // Initialize supabase (with hardcoded credentials)
-    try {
-        initializeSupabase();
-    }
-    catch (e) {
-        console.error(chalk.red('✗ Failed to connect to Langctl servers.'));
+    if (!isAuthenticated()) {
+        console.log(chalk.red('✗ Not authenticated.\n'));
+        process.exitCode = 1;
         return;
     }
-    const supabase = getSupabase();
-    const spinner = ora('Fetching organizations (debug)...').start();
-    const { data, error } = await supabase
-        .from('organizations')
-        .select('id, name, plan, created_at')
-        .limit(100);
-    if (error) {
-        spinner.fail(chalk.red(`Error fetching organizations: ${error.message}`));
+    const orgId = config.get('organizationId');
+    if (!orgId) {
+        console.log(chalk.red('✗ No organization configured.\n'));
+        process.exitCode = 1;
         return;
     }
-    spinner.succeed(chalk.green(`Found ${data?.length || 0} organizations`));
-    (data || []).forEach(o => {
-        console.log(`${chalk.cyan(o.id)}  ${chalk.white(o.name)}  plan=${chalk.magenta(o.plan)}  created=${chalk.gray(o.created_at)}`);
-    });
+    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,7 +1,6 @@
-type ExportFormat = 'i18n-json' | 'android-xml' | 'ios-strings' | 'flutter-arb' | 'flat-json' | 'nested-json';
 interface ExportOptions {
     language?: string;
-    format?: ExportFormat;
+    format?: string;
     output?: string;
     module?: string;
     includeUnpublished?: boolean;