langctl 0.0.1 → 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,49 @@
+export interface LangctlConfig {
+    supabaseUrl?: string;
+    supabaseAnonKey?: string;
+    apiKey?: string;
+    organizationId?: string;
+    organizationName?: 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 configuration is complete
+     */
+    isConfigured(): boolean;
+    /**
+     * Get the configuration file path
+     */
+    getConfigPath(): string;
+}
+export declare const config: ConfigManager;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.js

@@ -0,0 +1,71 @@
+import Conf from 'conf';
+import { join } from 'path';
+import { homedir } from 'os';
+class ConfigManager {
+    constructor() {
+        this.configDir = join(homedir(), '.langctl');
+        this.config = new Conf({
+            projectName: 'langctl',
+            cwd: this.configDir,
+            configName: 'config'
+        });
+    }
+    /**
+     * Get a configuration value
+     */
+    get(key) {
+        return this.config.get(key);
+    }
+    /**
+     * Set a configuration value
+     */
+    set(key, value) {
+        this.config.set(key, value);
+    }
+    /**
+     * Get all configuration
+     */
+    getAll() {
+        return this.config.store;
+    }
+    /**
+     * Set multiple configuration values
+     */
+    setAll(config) {
+        Object.entries(config).forEach(([key, value]) => {
+            if (value !== undefined) {
+                this.config.set(key, value);
+            }
+        });
+    }
+    /**
+     * Delete a configuration value
+     */
+    delete(key) {
+        this.config.delete(key);
+    }
+    /**
+     * Clear all configuration
+     */
+    clear() {
+        this.config.clear();
+    }
+    /**
+     * Check if configuration is complete
+     */
+    isConfigured() {
+        return !!(this.config.get('supabaseUrl') &&
+            this.config.get('supabaseAnonKey') &&
+            this.config.get('apiKey') &&
+            this.config.get('organizationId'));
+    }
+    /**
+     * Get the configuration file path
+     */
+    getConfigPath() {
+        return this.config.path;
+    }
+}
+// Singleton instance
+export const config = new ConfigManager();
+//# sourceMappingURL=config.js.map

package/dist/exporters/index.d.ts

@@ -0,0 +1,36 @@
+export interface TranslationKey {
+    key: string;
+    translations: Record<string, string>;
+    description?: string;
+    module?: string;
+}
+export type ExportFormat = 'json' | 'json-nested' | 'ios' | 'android' | 'flutter';
+export interface ExportResult {
+    content: string;
+    filename: string;
+}
+/**
+ * Export as flat JSON (simple key-value pairs)
+ */
+export declare function exportFlatJson(keys: TranslationKey[], languageCode: string): ExportResult;
+/**
+ * Export as nested JSON (organized by key structure)
+ */
+export declare function exportNestedJson(keys: TranslationKey[], languageCode: string): ExportResult;
+/**
+ * Export as iOS .strings format
+ */
+export declare function exportIosStrings(keys: TranslationKey[], languageCode: string): ExportResult;
+/**
+ * Export as Android XML format
+ */
+export declare function exportAndroidXml(keys: TranslationKey[], languageCode: string): ExportResult;
+/**
+ * Export as Flutter ARB format
+ */
+export declare function exportFlutterArb(keys: TranslationKey[], languageCode: string): ExportResult;
+/**
+ * Export translations in the specified format
+ */
+export declare function exportTranslations(keys: TranslationKey[], languageCode: string, format: ExportFormat): ExportResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/exporters/index.js

@@ -0,0 +1,214 @@
+/**
+ * Helper: Set nested value in object based on dot-notation key
+ */
+function setNestedValue(obj, path, value) {
+    const keys = path.split('.');
+    let current = obj;
+    for (let i = 0; i < keys.length - 1; i++) {
+        const key = keys[i];
+        if (!current[key] || typeof current[key] !== 'object') {
+            current[key] = {};
+        }
+        current = current[key];
+    }
+    current[keys[keys.length - 1]] = value;
+}
+/**
+ * Helper: Convert i18n format {{param}} to Android format %1$s, %2$s, etc.
+ */
+function convertToAndroidFormat(text) {
+    const matches = text.match(/\{\{([^}]+)\}\}/g);
+    if (!matches)
+        return text;
+    let result = text;
+    matches.forEach((match, index) => {
+        const paramNum = index + 1;
+        result = result.replace(match, `%${paramNum}$s`);
+    });
+    return result;
+}
+/**
+ * Helper: Convert i18n format {{param}} to iOS format %1$@, %2$@, etc.
+ */
+function convertToIosFormat(text) {
+    const matches = text.match(/\{\{([^}]+)\}\}/g);
+    if (!matches)
+        return text;
+    let result = text;
+    matches.forEach((match, index) => {
+        const paramNum = index + 1;
+        result = result.replace(match, `%${paramNum}$@`);
+    });
+    return result;
+}
+/**
+ * Helper: Convert i18n format {{param}} to Flutter format {param}
+ */
+function convertToFlutterFormat(text) {
+    return text.replace(/\{\{([^}]+)\}\}/g, '{$1}');
+}
+/**
+ * Helper: Extract placeholder names from Flutter format {param}
+ */
+function extractPlaceholders(text) {
+    const matches = text.match(/\{([^}]+)\}/g);
+    if (!matches)
+        return [];
+    return matches.map(match => match.slice(1, -1));
+}
+/**
+ * Helper: Escape XML special characters
+ */
+function escapeXml(text) {
+    return text
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+/**
+ * Helper: Escape .strings special characters
+ */
+function escapeStrings(text) {
+    return text
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t');
+}
+/**
+ * Export as flat JSON (simple key-value pairs)
+ */
+export function exportFlatJson(keys, languageCode) {
+    const translations = {};
+    keys.forEach(key => {
+        const translation = key.translations[languageCode];
+        if (translation) {
+            translations[key.key] = translation;
+        }
+    });
+    return {
+        content: JSON.stringify(translations, null, 2),
+        filename: `${languageCode}.json`
+    };
+}
+/**
+ * Export as nested JSON (organized by key structure)
+ */
+export function exportNestedJson(keys, languageCode) {
+    const translations = {};
+    keys.forEach(key => {
+        const translation = key.translations[languageCode];
+        if (translation) {
+            setNestedValue(translations, key.key, translation);
+        }
+    });
+    return {
+        content: JSON.stringify(translations, null, 2),
+        filename: `${languageCode}.json`
+    };
+}
+/**
+ * Export as iOS .strings format
+ */
+export function exportIosStrings(keys, languageCode) {
+    let content = '';
+    keys.forEach(key => {
+        const translation = key.translations[languageCode];
+        if (translation) {
+            const iosTranslation = convertToIosFormat(translation);
+            const escapedTranslation = escapeStrings(iosTranslation);
+            if (key.description) {
+                content += `/* ${key.description} */\n`;
+            }
+            content += `"${key.key}" = "${escapedTranslation}";\n\n`;
+        }
+    });
+    return {
+        content,
+        filename: `Localizable.strings`
+    };
+}
+/**
+ * Export as Android XML format
+ */
+export function exportAndroidXml(keys, languageCode) {
+    let xml = '<?xml version="1.0" encoding="utf-8"?>\n';
+    xml += '<resources>\n';
+    keys.forEach(key => {
+        const translation = key.translations[languageCode];
+        if (translation) {
+            const androidTranslation = convertToAndroidFormat(translation);
+            const escapedTranslation = escapeXml(androidTranslation);
+            if (key.description) {
+                xml += `  <!-- ${escapeXml(key.description)} -->\n`;
+            }
+            xml += `  <string name="${key.key}">${escapedTranslation}</string>\n`;
+        }
+    });
+    xml += '</resources>\n';
+    return {
+        content: xml,
+        filename: `strings.xml`
+    };
+}
+/**
+ * Export as Flutter ARB format
+ */
+export function exportFlutterArb(keys, languageCode) {
+    const arb = {
+        '@@locale': languageCode,
+        '@@last_modified': new Date().toISOString()
+    };
+    keys.forEach(key => {
+        const translation = key.translations[languageCode];
+        if (translation) {
+            const flutterTranslation = convertToFlutterFormat(translation);
+            arb[key.key] = flutterTranslation;
+            // Add metadata
+            const metadata = {};
+            if (key.description) {
+                metadata.description = key.description;
+            }
+            // Extract placeholders from translation
+            const placeholders = extractPlaceholders(flutterTranslation);
+            if (placeholders.length > 0) {
+                metadata.placeholders = {};
+                placeholders.forEach(placeholder => {
+                    metadata.placeholders[placeholder] = {
+                        type: 'String'
+                    };
+                });
+            }
+            if (Object.keys(metadata).length > 0) {
+                arb[`@${key.key}`] = metadata;
+            }
+        }
+    });
+    return {
+        content: JSON.stringify(arb, null, 2),
+        filename: `intl_${languageCode}.arb`
+    };
+}
+/**
+ * Export translations in the specified format
+ */
+export function exportTranslations(keys, languageCode, format) {
+    switch (format) {
+        case 'json':
+            return exportFlatJson(keys, languageCode);
+        case 'json-nested':
+            return exportNestedJson(keys, languageCode);
+        case 'ios':
+            return exportIosStrings(keys, languageCode);
+        case 'android':
+            return exportAndroidXml(keys, languageCode);
+        case 'flutter':
+            return exportFlutterArb(keys, languageCode);
+        default:
+            throw new Error(`Unsupported export format: ${format}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { initCommand } from './commands/init.js';
+import { authCommand, logoutCommand } from './commands/auth.js';
+import { configCommand } from './commands/config.js';
+import { projectsListCommand } from './commands/projects.js';
+import { pullCommand } from './commands/pull.js';
+import { debugListApiKeys, debugListOrganizations } from './commands/debug.js';
+import { showLogo } from './utils/banner.js';
+const program = new Command();
+// Package info
+const packageJson = {
+    name: 'langctl',
+    version: '0.1.0',
+    description: 'CLI-first translation management for developers'
+};
+program
+    .name('langctl')
+    .description(packageJson.description)
+    .version(packageJson.version, '-v, --version', 'Show version number');
+// Init command
+program
+    .command('init')
+    .description('Interactive setup wizard')
+    .action(async () => {
+    try {
+        await initCommand();
+    }
+    catch (error) {
+        console.error(chalk.red(`Error: ${error.message}\n`));
+        process.exit(1);
+    }
+});
+// Auth command
+program
+    .command('auth <api-key>')
+    .description('Authenticate and save credentials')
+    .action(async (apiKey) => {
+    try {
+        await authCommand(apiKey);
+    }
+    catch (error) {
+        console.error(chalk.red(`Error: ${error.message}\n`));
+        process.exit(1);
+    }
+});
+// Logout command
+program
+    .command('logout')
+    .description('Clear authentication credentials')
+    .action(async () => {
+    try {
+        await logoutCommand();
+    }
+    catch (error) {
+        console.error(chalk.red(`Error: ${error.message}\n`));
+        process.exit(1);
+    }
+});
+// Config command
+program
+    .command('config')
+    .description('View current configuration')
+    .action(() => {
+    try {
+        configCommand();
+    }
+    catch (error) {
+        console.error(chalk.red(`Error: ${error.message}\n`));
+        process.exit(1);
+    }
+});
+// Projects command
+const projects = program
+    .command('projects')
+    .description('Manage projects');
+projects
+    .command('list')
+    .description('Show all accessible projects')
+    .action(async () => {
+    try {
+        await projectsListCommand();
+    }
+    catch (error) {
+        console.error(chalk.red(`Error: ${error.message}\n`));
+        process.exit(1);
+    }
+});
+// Pull command
+program
+    .command('pull <project>')
+    .description('Pull translations from a project (all languages by default)')
+    .option('-l, --language <code>', 'Pull specific language only (default: all)')
+    .option('-f, --format <type>', 'Export format: json, json-nested, ios, android, flutter (default: json)')
+    .option('-d, --dir <path>', 'Output directory (default: ./translations)')
+    .option('-o, --output <path>', 'Specific output file path (optional)')
+    .option('--no-published-only', 'Include unpublished translations')
+    .action(async (project, options) => {
+    try {
+        await pullCommand(project, options);
+    }
+    catch (error) {
+        console.error(chalk.red(`Error: ${error.message}\n`));
+        process.exit(1);
+    }
+});
+// Debug command
+const debug = program
+    .command('debug')
+    .description('Debug helpers');
+debug
+    .command('list-api-keys')
+    .description('List API keys visible to current Supabase credentials')
+    .action(async () => {
+    try {
+        await debugListApiKeys();
+    }
+    catch (error) {
+        console.error(chalk.red(`Error: ${error.message}\n`));
+        process.exit(1);
+    }
+});
+debug
+    .command('list-organizations')
+    .description('List organizations visible to current Supabase credentials')
+    .action(async () => {
+    try {
+        await debugListOrganizations();
+    }
+    catch (error) {
+        console.error(chalk.red(`Error: ${error.message}\n`));
+        process.exit(1);
+    }
+});
+// Help command
+program.on('--help', () => {
+    console.log('');
+    console.log('Examples:');
+    console.log('  $ langctl init');
+    console.log('  $ langctl auth lc_abc123...');
+    console.log('  $ langctl projects list');
+    console.log('');
+    console.log('  # Pull all languages as JSON to ./translations/i18n/');
+    console.log('  $ langctl pull litcode');
+    console.log('');
+    console.log('  # Pull to custom directory (e.g., ./src/i18n/)');
+    console.log('  $ langctl pull litcode --dir ./src/i18n');
+    console.log('');
+    console.log('  # Pull specific language');
+    console.log('  $ langctl pull litcode --language en');
+    console.log('');
+    console.log('  # Pull all languages in iOS format to ./ios/localization/');
+    console.log('  $ langctl pull litcode --format ios --dir ./ios/localization');
+    console.log('');
+    console.log('For more information, visit: https://langctl.com/docs');
+    console.log('');
+});
+// Parse arguments
+program.parse(process.argv);
+// Show help if no command provided
+if (!process.argv.slice(2).length) {
+    showLogo();
+    program.outputHelp();
+}
+//# sourceMappingURL=index.js.map

package/dist/supabase.d.ts

@@ -0,0 +1,14 @@
+import { SupabaseClient } from '@supabase/supabase-js';
+/**
+ * Initialize Supabase client
+ */
+export declare function initializeSupabase(url?: string, anonKey?: string): SupabaseClient;
+/**
+ * Get existing Supabase client or throw error
+ */
+export declare function getSupabase(): SupabaseClient;
+/**
+ * Reset Supabase client (useful for tests or configuration changes)
+ */
+export declare function resetSupabase(): void;
+//# sourceMappingURL=supabase.d.ts.map

package/dist/supabase.js

@@ -0,0 +1,33 @@
+import { createClient } from '@supabase/supabase-js';
+import { config } from './config.js';
+let supabaseClient = null;
+/**
+ * Initialize Supabase client
+ */
+export function initializeSupabase(url, anonKey) {
+    const supabaseUrl = url || config.get('supabaseUrl');
+    const supabaseAnonKey = anonKey || config.get('supabaseAnonKey');
+    if (!supabaseUrl || !supabaseAnonKey) {
+        throw new Error('Supabase credentials not found. Please run "langctl init" first.');
+    }
+    if (!supabaseClient) {
+        supabaseClient = createClient(supabaseUrl, supabaseAnonKey);
+    }
+    return supabaseClient;
+}
+/**
+ * Get existing Supabase client or throw error
+ */
+export function getSupabase() {
+    if (!supabaseClient) {
+        return initializeSupabase();
+    }
+    return supabaseClient;
+}
+/**
+ * Reset Supabase client (useful for tests or configuration changes)
+ */
+export function resetSupabase() {
+    supabaseClient = null;
+}
+//# sourceMappingURL=supabase.js.map

package/dist/utils/banner.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Langctl ASCII Logo - Emerald Green
+ */
+export declare function showLogo(): void;
+/**
+ * Simple banner for quick commands
+ */
+export declare function showBanner(title: string): void;
+//# sourceMappingURL=banner.d.ts.map

package/dist/utils/banner.js

@@ -0,0 +1,24 @@
+import chalk from 'chalk';
+/**
+ * Langctl ASCII Logo - Emerald Green
+ */
+export function showLogo() {
+    const logo = `
+ ██╗      █████╗ ███╗   ██╗ ██████╗  ██████╗████████╗██╗     
+ ██║     ██╔══██╗████╗  ██║██╔════╝ ██╔════╝╚══██╔══╝██║     
+ ██║     ███████║██╔██╗ ██║██║  ███╗██║        ██║   ██║     
+ ██║     ██╔══██║██║╚██╗██║██║   ██║██║        ██║   ██║     
+ ███████╗██║  ██║██║ ╚████║╚██████╔╝╚██████╗   ██║   ███████╗
+ ╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝  ╚═════╝   ╚═╝   ╚══════╝
+`;
+    console.log(chalk.hex('#10b981')(logo)); // Emerald-500
+    console.log(chalk.gray('  CLI-first translation management for developers\n'));
+}
+/**
+ * Simple banner for quick commands
+ */
+export function showBanner(title) {
+    console.log(chalk.hex('#10b981').bold(`\n${title}`));
+    console.log(chalk.gray('─'.repeat(title.length)));
+}
+//# sourceMappingURL=banner.js.map

package/package.json

@@ -1,12 +1,17 @@
 {
   "name": "langctl",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "CLI-first translation management for developers. Affordable, AI-powered, and built for modern workflows.",
-  "main": "index.js",
+  "main": "dist/index.js",
+  "type": "module",
   "bin": {
-    "langctl": "./bin/langctl.js"
+    "langctl": "./dist/index.js"
   },
   "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "keywords": [
@@ -33,5 +38,19 @@
   "homepage": "https://langctl.com",
   "engines": {
     "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "@supabase/supabase-js": "^2.89.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.2",
+    "conf": "^15.0.2",
+    "inquirer": "^13.1.0",
+    "ora": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^25.0.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
   }
 }

package/translations/en.json

@@ -0,0 +1,5 @@
+{
+  "home.translation_mgmt": "Translation Management",
+  "home.welcome_message": "Welcome Home",
+  "new_item": "New Item"
+}

package/translations/en.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+  <!-- Hero text -->
+  <string name="home.translation_mgmt">Translation Management</string>
+  <!-- Homepage wlecome message -->
+  <string name="home.welcome_message">Welcome Home</string>
+  <!-- This is a new item -->
+  <string name="new_item">New Item</string>
+</resources>

package/translations/fr.json

@@ -0,0 +1,4 @@
+{
+  "home.translation_mgmt": "Gestion des traductions",
+  "home.welcome_message": "bienvenue à la maison"
+}