@vocoder/cli 0.14.0 → 0.15.0

package/dist/lib.d.mts

@@ -1,3 +1,15 @@
+interface ExtractedString {
+    key: string;
+    /** Source text. null for id-only entries (<T id="key" /> with no message or children). */
+    text: string | null;
+    file: string;
+    line: number;
+    context?: string;
+    formality?: "formal" | "informal" | "neutral" | "auto";
+    /** Detected UI role from JSX parent element or prop. e.g. "button_label", "heading", "input_placeholder" */
+    uiRole?: string;
+}
+
 /**
  * Supported app industry classifications.
  * Set once in vocoder.config.ts; synced to App at extraction time.
@@ -14,6 +26,11 @@ type AppIndustry = "ecommerce" | "saas" | "healthcare" | "fintech" | "gaming" |
  */
 type Formality = "formal" | "informal" | "neutral";
 interface VocoderConfig {
+    /**
+     * Unique identifier for this app. Written by `vocoder init` — do not edit manually.
+     * Used by the CLI to identify which app to update when syncing locales.
+     */
+    appId?: string;
     /** Glob patterns for files to extract strings from. */
     include?: string[];
     /** Glob patterns to exclude. */
@@ -58,16 +75,6 @@ declare function defineConfig(config: VocoderConfig): VocoderConfig;
  */
 declare function loadVocoderConfig(cwd: string): VocoderConfig | null;
 
-interface ExtractedString {
-    key: string;
-    text: string;
-    file: string;
-    line: number;
-    context?: string;
-    formality?: "formal" | "informal" | "neutral" | "auto";
-    /** Detected UI role from JSX parent element or prop. e.g. "button_label", "heading", "input_placeholder" */
-    uiRole?: string;
-}
 declare class StringExtractor {
     extractFromProject(pattern: string | string[], projectRoot?: string, excludePattern?: string | string[]): Promise<ExtractedString[]>;
 }
@@ -97,7 +104,6 @@ interface LocalConfig {
 interface APIAppConfig {
     projectName: string;
     organizationName: string;
-    shortCode: string;
     sourceLocale: string;
     targetLocales: string[];
     targetBranches: string[];
@@ -106,7 +112,8 @@ interface APIAppConfig {
 }
 interface TranslationStringEntry {
     key: string;
-    text: string;
+    /** Source text. null for id-only entries (<T id="key" /> with no message). */
+    text: string | null;
     context?: string;
     formality?: "formal" | "informal" | "neutral" | "auto";
     uiRole?: string;
@@ -336,26 +343,30 @@ declare class VocoderAPI {
      * Revoke the given CLI user token server-side.
      */
     revokeCliToken(userToken: string): Promise<void>;
-    listWorkspaces(userToken: string, params?: {
+    listOrganizations(userToken: string, params?: {
         repo?: string;
     }): Promise<{
-        workspaces: Array<{
+        organizations: Array<{
             id: string;
             name: string;
             planId: string;
-            maxProjects: number;
-            projectCount: number;
+            /** Plan limit on total apps across all projects (-1 = unlimited). */
+            maxApps: number;
+            /** Current total app count across all projects in this organization. */
+            appCount: number;
             hasGitHubConnection: boolean;
             connectionLabel: string | null;
             /** null when no `repo` param was provided */
             coversRepo: boolean | null;
             installationConfigureUrl: string | null;
         }>;
-        canCreateWorkspace: boolean;
+        canCreateOrganization: boolean;
     }>;
     listApps(userToken: string, organizationId: string): Promise<Array<{
-        id: string;
+        appId: string;
+        projectId: string;
         name: string;
+        appDir: string;
         sourceLocale: string;
         targetLocales: string[];
         targetBranches: string[];
@@ -409,7 +420,7 @@ declare class VocoderAPI {
      * @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<{
+    addLocale(locale: string, repoCanonical?: string, appId?: string): Promise<{
         targetLocales: string[];
     }>;
     /**
@@ -419,7 +430,7 @@ declare class VocoderAPI {
      *
      * @throws {VocoderAPIError} on auth or server errors
      */
-    removeLocale(locale: string, repoCanonical?: string): Promise<{
+    removeLocale(locale: string, repoCanonical?: string, appId?: string): Promise<{
         targetLocales: string[];
     }>;
     listLocales(userToken: string): Promise<{
@@ -456,6 +467,10 @@ declare class VocoderAPI {
         targetBranches: string[];
         repositoryBound: boolean;
         configureUrl?: string;
+        apps: Array<{
+            appDir: string;
+            appId: string;
+        }>;
     }>;
     /**
      * Look up all project apps for a given repo. Returns info about exact matches,
@@ -467,6 +482,7 @@ declare class VocoderAPI {
         appDir: string;
     }): Promise<{
         exactMatch: {
+            appId: string;
             projectId: string;
             projectName: string;
             organizationName: string;
@@ -475,11 +491,18 @@ declare class VocoderAPI {
         } | null;
         existingApps: Array<{
             appDir: string;
+            /** Unique identifier for this app — written to vocoder.config.ts. */
+            appId: string;
             projectId: string;
             projectName: string;
             organizationName: string;
         }>;
         hasWholeRepoApp: boolean;
+        /** Present when this repo is linked to a Vocoder organization (with or without a project). */
+        organizationContext: {
+            organizationId: string;
+            organizationName: string;
+        } | null;
     }>;
     /**
      * Add a new App to an existing project (monorepo: new app directory).
@@ -496,7 +519,6 @@ declare class VocoderAPI {
         appId: string;
         projectId: string;
         projectName: string;
-        apiKey: string;
         appDir: string;
     }>;
 }

package/dist/lib.mjs

@@ -12,7 +12,7 @@ import {
   readAuthData,
   verifyStoredAuth,
   writeAuthData
-} from "./chunk-T4BLNDJ3.mjs";
+} from "./chunk-62KCB6C6.mjs";
 
 // ../config/src/index.ts
 function defineConfig(config) {

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 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":[]}
+{"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/**\n\t * Unique identifier for this app. Written by `vocoder init` — do not edit manually.\n\t * Used by the CLI to identify which app to update when syncing locales.\n\t */\n\tappId?: string;\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// Canonical translation bundle format — defined in @vocoder/core and re-exported here\n// so consumers can import it from either package.\nexport type { VocoderTranslationData } from \"@vocoder/core\";\n"],"mappings":";;;;;;;;;;;;;;;;;AA6DO,SAAS,aAAa,QAAsC;AAClE,SAAO;AACR;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vocoder/cli",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "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/config": "0.14.0",
-    "@vocoder/extractor": "0.14.0"
+    "@vocoder/extractor": "0.15.0",
+    "@vocoder/config": "0.15.0"
   },
   "engines": {
     "node": ">=18"