langctl 0.1.2 → 0.3.0

package/dist/commands/keys.js

@@ -1,396 +1,160 @@
 import chalk from 'chalk';
-import ora from 'ora';
-import { isAuthenticated, getApiKey } from '../auth.js';
-const EDGE_FUNCTION_URL = 'https://bcgnmvkgkbhbxzzflwdb.supabase.co/functions/v1/manage-translation-keys';
-const LIST_PROJECTS_URL = 'https://bcgnmvkgkbhbxzzflwdb.supabase.co/functions/v1/list-projects';
-/**
- * Get project by slug
- */
-async function getProjectBySlug(apiKey, slug) {
+import { CliError, ExitCode, usageError } from '../core/errors.js';
+import { getSession } from '../core/http.js';
+import { log, printJson, runtime, spinner, table } from '../core/output.js';
+import { confirm } from '../core/prompts.js';
+import { assertLanguages, getProject, listAllKeys, projectSlugFrom, requireKey } from '../core/project.js';
+export async function listKeysCommand(projectArg, opts) {
+    const session = await getSession();
+    const project = await getProject(session, projectSlugFrom(projectArg));
+    const spin = spinner('Fetching keys…');
+    let keys;
     try {
-        const response = await fetch(LIST_PROJECTS_URL, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'X-API-Key': apiKey
-            }
+        keys = await listAllKeys(session, project, {
+            module: opts.module,
+            search: opts.search,
+            published: opts.published ? true : opts.drafts ? false : undefined,
         });
-        if (!response.ok)
-            return null;
-        const data = await response.json();
-        if (!data.success || !data.projects)
-            return null;
-        return data.projects.find((p) => p.slug === slug) || null;
     }
-    catch (error) {
-        return null;
+    finally {
+        spin.stop();
     }
-}
-/**
- * List translation keys
- */
-export async function listKeysCommand(projectSlug, options) {
-    if (!isAuthenticated()) {
-        console.log(chalk.red('✗ Not authenticated. Please run "langctl auth <api-key>" first.\n'));
-        return;
-    }
-    const apiKey = getApiKey();
-    const spinner = ora('Fetching keys...').start();
-    try {
-        const project = await getProjectBySlug(apiKey, projectSlug);
-        if (!project) {
-            spinner.fail(chalk.red(`Project "${projectSlug}" not found`));
-            return;
-        }
-        const response = await fetch(EDGE_FUNCTION_URL, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'X-API-Key': apiKey
-            },
-            body: JSON.stringify({
-                action: 'list',
-                projectId: project.id,
-                module: options.module,
-                published: options.published,
-                search: options.search,
-                limit: options.limit || 100,
-                offset: options.offset || 0
-            })
-        });
-        const data = await response.json();
-        if (!data.success) {
-            throw new Error(data.error);
-        }
-        spinner.stop();
-        if (!data.keys || data.keys.length === 0) {
-            console.log(chalk.yellow('\nNo keys found\n'));
-            return;
-        }
-        console.log(chalk.blue.bold(`\n🔑 Translation Keys (${data.keys.length}${data.total ? ` of ${data.total}` : ''})\n`));
-        data.keys.forEach((key) => {
-            console.log(chalk.white.bold(key.key));
-            if (key.description) {
-                console.log(chalk.gray(`  Description: ${key.description}`));
-            }
-            if (key.module) {
-                console.log(chalk.gray(`  Module: ${key.module}`));
-            }
-            console.log(chalk.gray(`  Published: ${key.published ? chalk.green('Yes') : chalk.yellow('No')}`));
-            const langs = Object.keys(key.translations);
-            if (langs.length > 0) {
-                console.log(chalk.gray(`  Languages: ${langs.join(', ')}`));
-            }
-            console.log('');
-        });
+    const limit = opts.limit ? Number(opts.limit) : undefined;
+    if (limit !== undefined && (!Number.isInteger(limit) || limit < 1))
+        throw usageError('--limit must be a positive integer');
+    const shown = limit ? keys.slice(0, limit) : keys;
+    if (runtime.json) {
+        return printJson(shown.map(k => ({
+            key: k.key, published: k.published, module: k.module ?? null, description: k.description ?? null, translations: k.translations,
+        })));
     }
-    catch (error) {
-        spinner.fail(chalk.red('Failed to list keys'));
-        console.error(chalk.red(`Error: ${error.message}\n`));
-    }
-}
-/**
- * Get single key
- */
-export async function getKeyCommand(projectSlug, keyName) {
-    if (!isAuthenticated()) {
-        console.log(chalk.red('✗ Not authenticated. Please run "langctl auth <api-key>" first.\n'));
+    if (shown.length === 0) {
+        log.info('No keys match.');
         return;
     }
-    const apiKey = getApiKey();
-    const spinner = ora('Fetching key...').start();
-    try {
-        const project = await getProjectBySlug(apiKey, projectSlug);
-        if (!project) {
-            spinner.fail(chalk.red(`Project "${projectSlug}" not found`));
-            return;
-        }
-        // First list to find the key ID
-        const listResponse = await fetch(EDGE_FUNCTION_URL, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'X-API-Key': apiKey
-            },
-            body: JSON.stringify({
-                action: 'list',
-                projectId: project.id,
-                search: keyName,
-                limit: 1
-            })
-        });
-        const listData = await listResponse.json();
-        if (!listData.success || !listData.keys || listData.keys.length === 0) {
-            spinner.fail(chalk.red(`Key "${keyName}" not found`));
-            return;
-        }
-        const key = listData.keys.find((k) => k.key === keyName);
-        if (!key) {
-            spinner.fail(chalk.red(`Key "${keyName}" not found`));
-            return;
-        }
-        spinner.stop();
-        console.log(chalk.blue.bold('\n🔑 Translation Key Details\n'));
-        console.log(chalk.white.bold(`Key: ${key.key}`));
-        console.log(chalk.gray(`ID: ${key.id}`));
-        if (key.description) {
-            console.log(chalk.gray(`Description: ${key.description}`));
-        }
-        if (key.module) {
-            console.log(chalk.gray(`Module: ${key.module}`));
-        }
-        console.log(chalk.gray(`Published: ${key.published ? chalk.green('Yes') : chalk.yellow('No')}`));
-        console.log(chalk.blue.bold('\nTranslations:'));
-        Object.entries(key.translations).forEach(([lang, value]) => {
-            console.log(chalk.white(`  ${lang}: ${value}`));
-        });
-        console.log('');
-    }
-    catch (error) {
-        spinner.fail(chalk.red('Failed to get key'));
-        console.error(chalk.red(`Error: ${error.message}\n`));
-    }
+    table(shown.map(k => [
+        k.key,
+        k.published ? chalk.green('published') : chalk.yellow('draft'),
+        k.module ?? '',
+        `${project.languages.filter(l => k.translations?.[l]).length}/${project.languages.length}`,
+    ]), ['KEY', 'STATUS', 'MODULE', 'LANGS']);
+    if (limit && keys.length > limit)
+        log.info(chalk.dim(`Showing ${limit} of ${keys.length}. Use --json for scripting.`));
 }
-/**
- * Create translation key
- */
-export async function createKeyCommand(projectSlug, keyName, options) {
-    if (!isAuthenticated()) {
-        console.log(chalk.red('✗ Not authenticated. Please run "langctl auth <api-key>" first.\n'));
-        return;
-    }
-    const apiKey = getApiKey();
-    const spinner = ora('Creating key...').start();
-    try {
-        const project = await getProjectBySlug(apiKey, projectSlug);
-        if (!project) {
-            spinner.fail(chalk.red(`Project "${projectSlug}" not found`));
-            return;
-        }
-        // Build translations object from --value-* options
-        const translations = {};
-        Object.keys(options).forEach(opt => {
-            if (opt.startsWith('value')) {
-                const lang = opt.replace('value', '').toLowerCase();
-                if (lang) {
-                    translations[lang] = options[opt];
-                }
-            }
-        });
-        const response = await fetch(EDGE_FUNCTION_URL, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'X-API-Key': apiKey
-            },
-            body: JSON.stringify({
-                action: 'create',
-                projectId: project.id,
-                key: keyName,
-                translations,
-                description: options.description,
-                module: options.module,
-                tags: options.tags ? options.tags.split(',') : []
-            })
-        });
-        const data = await response.json();
-        if (!data.success) {
-            throw new Error(data.error);
-        }
-        spinner.succeed(chalk.green(`Created key: ${keyName}`));
-        console.log('');
-    }
-    catch (error) {
-        spinner.fail(chalk.red('Failed to create key'));
-        console.error(chalk.red(`Error: ${error.message}\n`));
+export async function getKeyCommand(projectArg, keyName) {
+    const session = await getSession();
+    const project = await getProject(session, projectArg);
+    const key = await requireKey(session, project, keyName);
+    if (runtime.json)
+        return printJson(key);
+    log.out(chalk.bold(key.key) + '  ' + (key.published ? chalk.green('published') : chalk.yellow('draft')));
+    if (key.description)
+        log.out(chalk.dim(key.description));
+    if (key.module)
+        log.out(chalk.dim(`module: ${key.module}`));
+    for (const lang of project.languages) {
+        const v = key.translations?.[lang];
+        log.out(`  ${lang.padEnd(6)} ${v === undefined || v === '' ? chalk.dim('— missing') : v}`);
     }
 }
-/**
- * Delete translation key
- */
-export async function deleteKeyCommand(projectSlug, keyName) {
-    if (!isAuthenticated()) {
-        console.log(chalk.red('✗ Not authenticated. Please run "langctl auth <api-key>" first.\n'));
-        return;
-    }
-    const apiKey = getApiKey();
-    const spinner = ora('Deleting key...').start();
-    try {
-        const project = await getProjectBySlug(apiKey, projectSlug);
-        if (!project) {
-            spinner.fail(chalk.red(`Project "${projectSlug}" not found`));
-            return;
-        }
-        // Find key ID
-        const listResponse = await fetch(EDGE_FUNCTION_URL, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'X-API-Key': apiKey
-            },
-            body: JSON.stringify({
-                action: 'list',
-                projectId: project.id,
-                search: keyName,
-                limit: 1
-            })
-        });
-        const listData = await listResponse.json();
-        const key = listData.keys?.find((k) => k.key === keyName);
-        if (!key) {
-            spinner.fail(chalk.red(`Key "${keyName}" not found`));
-            return;
-        }
-        // Delete key
-        const response = await fetch(EDGE_FUNCTION_URL, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'X-API-Key': apiKey
-            },
-            body: JSON.stringify({
-                action: 'delete',
-                projectId: project.id,
-                keyId: key.id
-            })
-        });
-        const data = await response.json();
-        if (!data.success) {
-            throw new Error(data.error);
-        }
-        spinner.succeed(chalk.green(`Deleted key: ${keyName}`));
-        console.log('');
-    }
-    catch (error) {
-        spinner.fail(chalk.red('Failed to delete key'));
-        console.error(chalk.red(`Error: ${error.message}\n`));
-    }
+/** Collect `--value en=Hello --value es=Hola` plus the legacy `--value-en` style flags. */
+function collectValues(opts) {
+    const out = {};
+    for (const pair of opts.value ?? []) {
+        const i = pair.indexOf('=');
+        if (i < 1)
+            throw usageError(`--value expects LANG=TEXT, got "${pair}"`, 'Example: --value en="Welcome" --value es="Bienvenido"');
+        out[pair.slice(0, i).trim()] = pair.slice(i + 1);
+    }
+    for (const lang of ['en', 'es', 'fr', 'de']) {
+        const legacy = opts[`value${lang[0].toUpperCase()}${lang[1]}`];
+        if (typeof legacy === 'string')
+            out[lang] = legacy;
+    }
+    return out;
 }
-/**
- * Update single translation
- */
-export async function translateKeyCommand(projectSlug, keyName, options) {
-    if (!isAuthenticated()) {
-        console.log(chalk.red('✗ Not authenticated. Please run "langctl auth <api-key>" first.\n'));
-        return;
-    }
-    const apiKey = getApiKey();
-    const spinner = ora('Updating translation...').start();
-    try {
-        const project = await getProjectBySlug(apiKey, projectSlug);
-        if (!project) {
-            spinner.fail(chalk.red(`Project "${projectSlug}" not found`));
-            return;
-        }
-        // Find key ID
-        const listResponse = await fetch(EDGE_FUNCTION_URL, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'X-API-Key': apiKey
-            },
-            body: JSON.stringify({
-                action: 'list',
-                projectId: project.id,
-                search: keyName,
-                limit: 1
-            })
-        });
-        const listData = await listResponse.json();
-        const key = listData.keys?.find((k) => k.key === keyName);
-        if (!key) {
-            spinner.fail(chalk.red(`Key "${keyName}" not found`));
-            return;
-        }
-        // Update translation
-        const response = await fetch(EDGE_FUNCTION_URL, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'X-API-Key': apiKey
-            },
-            body: JSON.stringify({
-                action: 'translate',
-                projectId: project.id,
-                keyId: key.id,
-                language: options.language,
-                value: options.value
-            })
-        });
-        const data = await response.json();
-        if (!data.success) {
-            throw new Error(data.error);
-        }
-        spinner.succeed(chalk.green(`Updated ${options.language} translation for ${keyName}`));
-        console.log('');
-    }
-    catch (error) {
-        spinner.fail(chalk.red('Failed to update translation'));
-        console.error(chalk.red(`Error: ${error.message}\n`));
-    }
+export async function createKeyCommand(projectArg, keyName, opts) {
+    const session = await getSession();
+    const project = await getProject(session, projectArg);
+    const translations = collectValues(opts);
+    assertLanguages(project, Object.keys(translations));
+    const key = await session.api.post(`/orgs/${session.orgId}/projects/${project.id}/keys`, {
+        key: keyName,
+        translations,
+        description: opts.description,
+        module: opts.module,
+        tags: typeof opts.tags === 'string' ? opts.tags.split(',').map(t => t.trim()).filter(Boolean) : undefined,
+        published: Boolean(opts.publish),
+    });
+    if (runtime.json)
+        return printJson(key);
+    log.success(`Created ${chalk.bold(keyName)}${opts.publish ? ' (published)' : ' (draft — publish with "langctl keys publish")'}`);
 }
-/**
- * Publish/unpublish keys
- */
-export async function publishKeysCommand(projectSlug, keys, options) {
-    if (!isAuthenticated()) {
-        console.log(chalk.red('✗ Not authenticated. Please run "langctl auth <api-key>" first.\n'));
-        return;
-    }
-    const apiKey = getApiKey();
-    const action = options.unpublish ? 'unpublish' : 'publish';
-    const spinner = ora(`${action === 'publish' ? 'Publishing' : 'Unpublishing'} keys...`).start();
-    try {
-        const project = await getProjectBySlug(apiKey, projectSlug);
-        if (!project) {
-            spinner.fail(chalk.red(`Project "${projectSlug}" not found`));
-            return;
-        }
-        // Get key IDs
-        const listResponse = await fetch(EDGE_FUNCTION_URL, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'X-API-Key': apiKey
-            },
-            body: JSON.stringify({
-                action: 'list',
-                projectId: project.id,
-                limit: 1000
-            })
-        });
-        const listData = await listResponse.json();
-        const keyIds = listData.keys
-            ?.filter((k) => keys.includes(k.key))
-            .map((k) => k.id) || [];
-        if (keyIds.length === 0) {
-            spinner.fail(chalk.red('No matching keys found'));
-            return;
-        }
-        // Publish/unpublish keys
-        const response = await fetch(EDGE_FUNCTION_URL, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'X-API-Key': apiKey
-            },
-            body: JSON.stringify({
-                action: 'publish',
-                projectId: project.id,
-                keyIds,
-                published: !options.unpublish
-            })
-        });
-        const data = await response.json();
-        if (!data.success) {
-            throw new Error(data.error);
-        }
-        spinner.succeed(chalk.green(data.message));
-        console.log('');
-    }
-    catch (error) {
-        spinner.fail(chalk.red(`Failed to ${action} keys`));
-        console.error(chalk.red(`Error: ${error.message}\n`));
+export async function updateKeyCommand(projectArg, keyName, opts) {
+    const session = await getSession();
+    const project = await getProject(session, projectArg);
+    const key = await requireKey(session, project, keyName);
+    const translations = collectValues(opts);
+    // legacy: keys translate <project> <key> -l es -v "Hola"
+    if (typeof opts.language === 'string') {
+        if (typeof opts.text !== 'string')
+            throw usageError('--language needs --text (or use --value LANG=TEXT)');
+        translations[opts.language] = opts.text;
+    }
+    assertLanguages(project, Object.keys(translations));
+    const body = {};
+    if (Object.keys(translations).length)
+        body.translations = { ...key.translations, ...translations };
+    if (opts.description !== undefined)
+        body.description = opts.description;
+    if (opts.module !== undefined)
+        body.module = opts.module;
+    if (Object.keys(body).length === 0)
+        throw usageError('Nothing to update.', 'Pass --value LANG=TEXT, --description or --module.');
+    const updated = await session.api.patch(`/orgs/${session.orgId}/projects/${project.id}/keys/${key.id}`, body);
+    if (runtime.json)
+        return printJson(updated);
+    log.success(`Updated ${chalk.bold(keyName)}${Object.keys(translations).length ? ` (${Object.keys(translations).join(', ')})` : ''}`);
+}
+export async function deleteKeyCommand(projectArg, keyNames) {
+    const session = await getSession();
+    const project = await getProject(session, projectArg);
+    const keys = [];
+    for (const name of keyNames)
+        keys.push(await requireKey(session, project, name));
+    if (!(await confirm(`Delete ${keys.length === 1 ? `key "${keys[0].key}"` : `${keys.length} keys`} from ${project.slug}?`))) {
+        throw new CliError('Cancelled.', ExitCode.Error);
+    }
+    for (const k of keys)
+        await session.api.delete(`/orgs/${session.orgId}/projects/${project.id}/keys/${k.id}`);
+    if (runtime.json)
+        return printJson({ deleted: keys.map(k => k.key) });
+    log.success(`Deleted ${keys.map(k => chalk.bold(k.key)).join(', ')}`);
+}
+export async function publishKeysCommand(projectArg, keyNames, opts, publish = true) {
+    const published = publish && !opts.unpublish;
+    const session = await getSession();
+    const project = await getProject(session, projectSlugFrom(projectArg));
+    let names = keyNames;
+    if (opts.all || opts.module) {
+        if (names.length)
+            throw usageError('Pass key names or --all/--module, not both.');
+        names = (await listAllKeys(session, project, { module: opts.module, published: !published })).map(k => k.key);
+    }
+    else if (names.length === 0) {
+        throw usageError('No keys given.', `Example: langctl keys ${published ? 'publish' : 'unpublish'} ${project.slug} home.title home.subtitle  (or --all / --module <name>)`);
+    }
+    if (names.length === 0) {
+        if (runtime.json)
+            return printJson({ count: 0, notFound: [] });
+        return log.info(`Nothing to ${published ? 'publish' : 'unpublish'}.`);
+    }
+    const res = await session.api.post(`/orgs/${session.orgId}/projects/${project.id}/keys/bulk-publish`, { keys: names, published }, true);
+    if (runtime.json)
+        printJson(res);
+    else
+        log.success(`${published ? 'Published' : 'Unpublished'} ${res.count} key(s)`);
+    if (res.notFound?.length) {
+        throw new CliError(`Not found: ${res.notFound.join(', ')}`, ExitCode.NotFound);
     }
 }
-//# sourceMappingURL=keys.js.map