@vocoder/cli 0.11.0 → 0.12.1

package/dist/lib.d.mts

@@ -1,6 +1,6 @@
 /**
  * Supported app industry classifications.
- * Set once in vocoder.config.ts; synced to ProjectApp at extraction time.
+ * Set once in vocoder.config.ts; synced to App at extraction time.
  * Cannot be edited from the dashboard — config file is the source of truth.
  *
  * Keep in sync with APP_INDUSTRIES in
@@ -32,13 +32,13 @@ interface VocoderConfig {
      * The industry or domain of this application.
      * Used to improve translation quality for domain-specific terminology
      * and to isolate cache entries by industry in the global translation cache.
-     * Synced to ProjectApp at extraction time.
+     * Synced to App at extraction time.
      */
     appIndustry?: AppIndustry;
     /**
      * Project-wide default formality level for translations.
      * Can be overridden per-string via <T formality="..."> on the AI plan.
-     * Synced to ProjectApp at extraction time.
+     * Synced to App at extraction time.
      */
     formality?: Formality;
 }
@@ -149,7 +149,7 @@ interface TranslationSnapshotResponse {
 }
 interface LimitErrorResponse {
     errorCode: "LIMIT_EXCEEDED" | "INSUFFICIENT_CREDITS";
-    limitType: "organizations" | "projects" | "git_connections" | "members" | "providers" | "translation_chars" | "source_strings" | "credits";
+    limitType: "organizations" | "projects" | "git_connections" | "members" | "providers" | "translation_chars" | "source_strings" | "target_locales" | "credits";
     planId: string;
     current: number;
     required: number;
@@ -266,7 +266,7 @@ declare class VocoderAPI {
         requestedMaxWaitMs?: number;
         clientRunId?: string;
         force?: boolean;
-        /** From vocoder.config.ts — synced to ProjectApp on every push */
+        /** From vocoder.config.ts — synced to App on every push */
         appIndustry?: string;
     }, repoIdentity?: RepoIdentityPayload): Promise<TranslationBatchResponse>;
     /**
@@ -401,6 +401,27 @@ declare class VocoderAPI {
         connectionLabel: string;
         repoCount: number;
     }>;
+    /**
+     * Add a target locale to the project.
+     * Idempotent: returns the current list unchanged if the locale is already configured.
+     * Project determined from API key.
+     *
+     * @throws {VocoderAPIError} status 422 for invalid/unsupported locale code
+     * @throws {VocoderAPIError} status 403 with limitError.limitType "target_locales" when plan limit reached
+     */
+    addLocale(locale: string, repoCanonical?: string): Promise<{
+        targetLocales: string[];
+    }>;
+    /**
+     * Remove a target locale from the project.
+     * Idempotent: returns the current list unchanged if the locale is not configured.
+     * Project determined from API key.
+     *
+     * @throws {VocoderAPIError} on auth or server errors
+     */
+    removeLocale(locale: string, repoCanonical?: string): Promise<{
+        targetLocales: string[];
+    }>;
     listLocales(userToken: string): Promise<{
         sourceLocales: Array<{
             code: string;
@@ -461,10 +482,10 @@ declare class VocoderAPI {
         hasWholeRepoApp: boolean;
     }>;
     /**
-     * Add a new ProjectApp to an existing project (monorepo: new app directory).
+     * Add a new App to an existing project (monorepo: new app directory).
      * Does not check plan limits — no new project is created.
      */
-    createProjectApp(userToken: string, params: {
+    createApp(userToken: string, params: {
         projectId: string;
         appDir: string;
         sourceLocale: string;
@@ -489,6 +510,33 @@ interface AuthData {
 }
 declare function readAuthData(): AuthData | null;
 declare function writeAuthData(data: AuthData): void;
+/**
+ * Result of checking a stored CLI auth token against the API:
+ * - "valid"   — token is good; user info is returned
+ * - "expired" — token rejected (non-404); user record still exists → reauth,
+ *               do NOT run the GitHub App install flow again
+ * - "gone"    — 404; user record deleted → treat as first-time setup
+ * - "none"    — no token on disk
+ */
+type StoredAuthStatus = {
+    status: "valid";
+    token: string;
+    userId: string;
+    email: string;
+    name: string | null;
+} | {
+    status: "expired";
+} | {
+    status: "gone";
+} | {
+    status: "none";
+};
+/**
+ * Verify the stored CLI auth token. Clears the token on failure.
+ * Shared by the CLI (`commands/init.ts`) and the MCP (`tools/project-init.ts`)
+ * so reauth detection stays in sync.
+ */
+declare function verifyStoredAuth(api: VocoderAPI): Promise<StoredAuthStatus>;
 declare function clearAuthData(): void;
 
 interface SetupSnippets {
@@ -513,6 +561,7 @@ declare function getSetupSnippets(params: {
     ecosystem: DetectedEcosystem;
     sourceLocale: string;
     targetBranches: string[];
+    appDir?: string;
 }): SetupSnippets;
 
-export { type APIProjectConfig, type AuthData, type DetectedEcosystem, type DetectedFramework, type ExtractedString, type LimitErrorResponse, type LocalDetectionResult, type LocaleInfo, type LocalesMap, type PackageManager, type SetupSnippets, StringExtractor, type SyncPolicyConfig, type SyncPolicyErrorResponse, type TranslationBatchResponse, type TranslationSnapshotResponse, type TranslationStatusResponse, VocoderAPI, VocoderAPIError, type VocoderConfig, buildInstallCommand, clearAuthData, defineConfig, detectLocalEcosystem, getPackagesToInstall, getSetupSnippets, loadVocoderConfig, readAuthData, writeAuthData };
+export { type APIProjectConfig, type AuthData, type DetectedEcosystem, type DetectedFramework, type ExtractedString, type LimitErrorResponse, type LocalDetectionResult, type LocaleInfo, type LocalesMap, type PackageManager, type SetupSnippets, type StoredAuthStatus, StringExtractor, type SyncPolicyConfig, type SyncPolicyErrorResponse, type TranslationBatchResponse, type TranslationSnapshotResponse, type TranslationStatusResponse, VocoderAPI, VocoderAPIError, type VocoderConfig, buildInstallCommand, clearAuthData, defineConfig, detectLocalEcosystem, getPackagesToInstall, getSetupSnippets, loadVocoderConfig, readAuthData, verifyStoredAuth, writeAuthData };

package/dist/lib.mjs

@@ -10,8 +10,9 @@ import {
   getSetupSnippets,
   loadVocoderConfig,
   readAuthData,
+  verifyStoredAuth,
   writeAuthData
-} from "./chunk-XF3KGGYQ.mjs";
+} from "./chunk-SR6SDGUI.mjs";
 
 // ../config/src/index.ts
 function defineConfig(config) {
@@ -29,6 +30,7 @@ export {
   getSetupSnippets,
   loadVocoderConfig,
   readAuthData,
+  verifyStoredAuth,
   writeAuthData
 };
 //# sourceMappingURL=lib.mjs.map

package/dist/lib.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../config/src/index.ts"],"sourcesContent":["/**\n * Supported app industry classifications.\n * Set once in vocoder.config.ts; synced to ProjectApp at extraction time.\n * Cannot be edited from the dashboard — config file is the source of truth.\n *\n * Keep in sync with APP_INDUSTRIES in\n * vocoder-app/lib/vocoder/translation/context-constants.ts.\n */\nexport type AppIndustry =\n\t| \"ecommerce\"\n\t| \"saas\"\n\t| \"healthcare\"\n\t| \"fintech\"\n\t| \"gaming\"\n\t| \"education\"\n\t| \"media\"\n\t| \"productivity\";\n\n/**\n * Translation formality level.\n * Can be set project-wide in vocoder.config.ts or overridden per-string\n * via <T formality=\"formal\"> (requires allowAiTranslations plan).\n */\nexport type Formality = \"formal\" | \"informal\" | \"neutral\";\n\nexport interface VocoderConfig {\n\t/** Glob patterns for files to extract strings from. */\n\tinclude?: string[];\n\t/** Glob patterns to exclude. */\n\texclude?: string[];\n\t/**\n\t * Git branches that trigger string extraction and translation.\n\t * Synced to the Vocoder dashboard on each push — change here to update.\n\t */\n\ttargetBranches?: string[];\n\t/**\n\t * Directory to write translated locale files after sync (optional).\n\t * If set, `vocoder sync` writes {locale}.json files to this path.\n\t */\n\tlocalesPath?: string;\n\t/**\n\t * The industry or domain of this application.\n\t * Used to improve translation quality for domain-specific terminology\n\t * and to isolate cache entries by industry in the global translation cache.\n\t * Synced to ProjectApp at extraction time.\n\t */\n\tappIndustry?: AppIndustry;\n\t/**\n\t * Project-wide default formality level for translations.\n\t * Can be overridden per-string via <T formality=\"...\"> on the AI plan.\n\t * Synced to ProjectApp at extraction time.\n\t */\n\tformality?: Formality;\n}\n\n/** Type helper for vocoder.config.ts — provides autocomplete and type checking. */\nexport function defineConfig(config: VocoderConfig): VocoderConfig {\n\treturn config;\n}\n\n/**\n * Canonical translation bundle format shared by the build plugin and CLI.\n * Both read and write this shape — keeps cache files identical regardless of\n * which tool produced them.\n *\n * translations: locale → sourceKey (hash) → translated text\n * config.locales: locale metadata snapshot for the runtime\n */\nexport interface VocoderTranslationData {\n\tconfig: {\n\t\tsourceLocale: string;\n\t\ttargetLocales: string[];\n\t\tlocales: Record<string, {\n\t\t\tnativeName: string;\n\t\t\tdir?: \"rtl\";\n\t\t\tcurrencyCode?: string;\n\t\t\tordinalForms?: { type: \"suffix\"; suffixes: { zero?: string; one?: string; two?: string; few?: string; many?: string; other: string } } | { type: \"word\"; words: Record<string, Record<number, string>> };\n\t\t}>;\n\t};\n\ttranslations: Record<string, Record<string, string>>;\n\tupdatedAt: string | null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAwDO,SAAS,aAAa,QAAsC;AAClE,SAAO;AACR;","names":[]}
+{"version":3,"sources":["../../config/src/index.ts"],"sourcesContent":["/**\n * Supported app industry classifications.\n * Set once in vocoder.config.ts; synced to App at extraction time.\n * Cannot be edited from the dashboard — config file is the source of truth.\n *\n * Keep in sync with APP_INDUSTRIES in\n * vocoder-app/lib/vocoder/translation/context-constants.ts.\n */\nexport type AppIndustry =\n\t| \"ecommerce\"\n\t| \"saas\"\n\t| \"healthcare\"\n\t| \"fintech\"\n\t| \"gaming\"\n\t| \"education\"\n\t| \"media\"\n\t| \"productivity\";\n\n/**\n * Translation formality level.\n * Can be set project-wide in vocoder.config.ts or overridden per-string\n * via <T formality=\"formal\"> (requires allowAiTranslations plan).\n */\nexport type Formality = \"formal\" | \"informal\" | \"neutral\";\n\nexport interface VocoderConfig {\n\t/** Glob patterns for files to extract strings from. */\n\tinclude?: string[];\n\t/** Glob patterns to exclude. */\n\texclude?: string[];\n\t/**\n\t * Git branches that trigger string extraction and translation.\n\t * Synced to the Vocoder dashboard on each push — change here to update.\n\t */\n\ttargetBranches?: string[];\n\t/**\n\t * Directory to write translated locale files after sync (optional).\n\t * If set, `vocoder sync` writes {locale}.json files to this path.\n\t */\n\tlocalesPath?: string;\n\t/**\n\t * The industry or domain of this application.\n\t * Used to improve translation quality for domain-specific terminology\n\t * and to isolate cache entries by industry in the global translation cache.\n\t * Synced to App at extraction time.\n\t */\n\tappIndustry?: AppIndustry;\n\t/**\n\t * Project-wide default formality level for translations.\n\t * Can be overridden per-string via <T formality=\"...\"> on the AI plan.\n\t * Synced to App at extraction time.\n\t */\n\tformality?: Formality;\n}\n\n/** Type helper for vocoder.config.ts — provides autocomplete and type checking. */\nexport function defineConfig(config: VocoderConfig): VocoderConfig {\n\treturn config;\n}\n\n/**\n * Canonical translation bundle format shared by the build plugin and CLI.\n * Both read and write this shape — keeps cache files identical regardless of\n * which tool produced them.\n *\n * translations: locale → sourceKey (hash) → translated text\n * config.locales: locale metadata snapshot for the runtime\n */\nexport interface VocoderTranslationData {\n\tconfig: {\n\t\tsourceLocale: string;\n\t\ttargetLocales: string[];\n\t\tlocales: Record<string, {\n\t\t\tnativeName: string;\n\t\t\tdir?: \"rtl\";\n\t\t\tcurrencyCode?: string;\n\t\t\tordinalForms?: { type: \"suffix\"; suffixes: { zero?: string; one?: string; two?: string; few?: string; many?: string; other: string } } | { type: \"word\"; words: Record<string, Record<number, string>> };\n\t\t}>;\n\t};\n\ttranslations: Record<string, Record<string, string>>;\n\tupdatedAt: string | null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAwDO,SAAS,aAAa,QAAsC;AAClE,SAAO;AACR;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vocoder/cli",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "description": "CLI tool for Vocoder translation workflow",
   "files": [
     "dist"
@@ -51,8 +51,8 @@
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
     "vitest": "^1.0.0",
-    "@vocoder/extractor": "0.11.0",
-    "@vocoder/config": "0.11.0"
+    "@vocoder/extractor": "0.12.1",
+    "@vocoder/config": "0.12.1"
   },
   "engines": {
     "node": ">=18"