gtx-cli 2.6.24 → 2.6.25

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # gtx-cli
 
+## 2.6.25
+
+### Patch Changes
+
+- [#1040](https://github.com/generaltranslation/gt/pull/1040) [`d7bc63f`](https://github.com/generaltranslation/gt/commit/d7bc63f497534eede92138c8836bc84169600ff1) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - chore: expose enqueue and upload commands
+
 ## 2.6.24
 
 ### Patch Changes

package/dist/api/downloadFileBatch.d.ts

@@ -1,5 +1,5 @@
 import { Settings } from '../types/index.js';
-import type { FileStatusTracker } from '../workflow/PollJobsStep.js';
+import type { FileStatusTracker } from '../workflows/steps/PollJobsStep.js';
 export type BatchedFiles = {
     branchId: string;
     fileId: string;

package/dist/api/saveLocalEdits.js

@@ -1,7 +1,7 @@
-import { aggregateFiles } from '../formats/files/translate.js';
+import { aggregateFiles } from '../formats/files/aggregateFiles.js';
 import { collectAndSendUserEditDiffs } from './collectUserEditDiffs.js';
 import { gt } from '../utils/gt.js';
-import { BranchStep } from '../workflow/BranchStep.js';
+import { BranchStep } from '../workflows/steps/BranchStep.js';
 import { logErrorAndExit } from '../console/logging.js';
 import { logger } from '../console/logger.js';
 import chalk from 'chalk';

package/dist/cli/base.d.ts

@@ -18,10 +18,34 @@ export declare class BaseCLI {
     execute(): void;
     protected setupSetupProjectCommand(): void;
     protected setupStageCommand(): void;
+    /**
+     * Enqueues translations for a given set of files
+     * @param initOptions - The options for the command
+     * @returns The results of the command
+     */
+    protected setupEnqueueCommand(): void;
+    /**
+     * Downloads translations that were originally staged
+     * @param initOptions - The options for the command
+     * @returns The results of the command
+     */
+    protected setupDownloadCommand(): void;
     protected setupTranslateCommand(): void;
     protected setupSendDiffsCommand(): void;
     protected handleSetupProject(initOptions: TranslateFlags): Promise<void>;
     protected handleStage(initOptions: TranslateFlags): Promise<void>;
+    /**
+     * Enqueues translations for a given set of files
+     * @param initOptions - The options for the command
+     * @returns The results of the command
+     */
+    protected handleEnqueue(initOptions: TranslateFlags): Promise<void>;
+    /**
+     * Downloads translations that were originally staged
+     * @param initOptions - The options for the command
+     * @returns The results of the command
+     */
+    protected handleDownload(initOptions: TranslateFlags): Promise<void>;
     protected handleTranslate(initOptions: TranslateFlags): Promise<void>;
     protected setupUploadCommand(): void;
     protected setupLoginCommand(): void;

package/dist/cli/base.js

@@ -14,11 +14,12 @@ import { installPackage } from '../utils/installPackage.js';
 import { getPackageManager } from '../utils/packageManager.js';
 import { retrieveCredentials, setCredentials } from '../utils/credentials.js';
 import { areCredentialsSet } from '../utils/credentials.js';
-import { upload } from '../formats/files/upload.js';
+import { upload } from './commands/upload.js';
 import { attachSharedFlags, attachTranslateFlags } from './flags.js';
 import { handleStage } from './commands/stage.js';
 import { handleSetupProject } from './commands/setupProject.js';
-import { handleDownload, handleTranslate, postProcessTranslations, } from './commands/translate.js';
+import { handleDownload } from './commands/download.js';
+import { handleTranslate, postProcessTranslations, } from './commands/translate.js';
 import { getDownloaded, clearDownloaded } from '../state/recentDownloads.js';
 import { clearWarnings } from '../state/translateWarnings.js';
 import { displayTranslateSummary } from '../console/displayTranslateSummary.js';
@@ -32,6 +33,7 @@ import { getFrameworkDisplayName, getReactFrameworkLibrary, } from '../setup/fra
 import { findAgentFiles, findAgentFilesWithInstructions, hasCursorRulesDir, CURSOR_GT_RULES_FILE, getAgentInstructions, appendAgentInstructions, } from '../setup/agentInstructions.js';
 import { determineLibrary } from '../fs/determineFramework.js';
 import { INLINE_LIBRARIES } from '../types/libraries.js';
+import { handleEnqueue } from './commands/enqueue.js';
 export class BaseCLI {
     library;
     additionalModules;
@@ -53,6 +55,8 @@ export class BaseCLI {
         this.setupSetupProjectCommand();
         this.setupStageCommand();
         this.setupTranslateCommand();
+        this.setupDownloadCommand();
+        this.setupEnqueueCommand();
     }
     // Execute is called by the main program
     execute() {
@@ -79,6 +83,34 @@ export class BaseCLI {
             logger.endCommand('Done!');
         });
     }
+    /**
+     * Enqueues translations for a given set of files
+     * @param initOptions - The options for the command
+     * @returns The results of the command
+     */
+    setupEnqueueCommand() {
+        attachTranslateFlags(this.program
+            .command('enqueue')
+            .description('Enqueues translations for a given set of files')).action(async (initOptions) => {
+            displayHeader('Enqueuing translations...');
+            await this.handleEnqueue(initOptions);
+            logger.endCommand('Done!');
+        });
+    }
+    /**
+     * Downloads translations that were originally staged
+     * @param initOptions - The options for the command
+     * @returns The results of the command
+     */
+    setupDownloadCommand() {
+        attachTranslateFlags(this.program
+            .command('download')
+            .description('Download translations that were originally staged')).action(async (initOptions) => {
+            displayHeader('Downloading translations...');
+            await this.handleDownload(initOptions);
+            logger.endCommand('Done!');
+        });
+    }
     setupTranslateCommand() {
         attachTranslateFlags(this.program
             .command('translate')
@@ -117,6 +149,24 @@ export class BaseCLI {
         }
         await handleStage(initOptions, settings, this.library, true);
     }
+    /**
+     * Enqueues translations for a given set of files
+     * @param initOptions - The options for the command
+     * @returns The results of the command
+     */
+    async handleEnqueue(initOptions) {
+        const settings = await generateSettings(initOptions);
+        await handleEnqueue(initOptions, settings, this.library);
+    }
+    /**
+     * Downloads translations that were originally staged
+     * @param initOptions - The options for the command
+     * @returns The results of the command
+     */
+    async handleDownload(initOptions) {
+        const settings = await generateSettings(initOptions);
+        await handleDownload(initOptions, settings, this.library);
+    }
     async handleTranslate(initOptions) {
         const settings = await generateSettings(initOptions);
         // Preprocess shared static assets if configured (move + rewrite sources)
@@ -128,7 +178,7 @@ export class BaseCLI {
             }
         }
         else {
-            await handleDownload(initOptions, settings);
+            await handleDownload(initOptions, settings, this.library);
         }
         // Only postprocess files downloaded in this run
         const include = getDownloaded();

package/dist/cli/commands/download.d.ts

@@ -0,0 +1,8 @@
+import { SupportedLibraries, TranslateFlags } from '../../types/index.js';
+import { Settings } from '../../types/index.js';
+/**
+ * Downloads translations that were originally staged
+ * @param options - The options for the command
+ * @param settings - The settings for the command
+ */
+export declare function handleDownload(options: TranslateFlags, settings: Settings, library: SupportedLibraries): Promise<undefined>;

package/dist/cli/commands/download.js

@@ -0,0 +1,51 @@
+import { noVersionIdError, noFilesError } from '../../console/index.js';
+import { createFileMapping } from '../../formats/files/fileMapping.js';
+import { getStagedVersions } from '../../fs/config/updateVersions.js';
+import { runDownloadWorkflow, } from '../../workflows/download.js';
+import { exitSync, logErrorAndExit } from '../../console/logging.js';
+import { convertToFileTranslationData } from '../../formats/files/convertToFileTranslationData.js';
+import { collectFiles } from '../../formats/files/collectFiles.js';
+import { hasValidCredentials, hasValidLocales } from './utils/validation.js';
+// Downloads translations that were originally staged
+/**
+ * Downloads translations that were originally staged
+ * @param options - The options for the command
+ * @param settings - The settings for the command
+ */
+export async function handleDownload(options, settings, library) {
+    if (!hasValidLocales(settings))
+        return exitSync(1);
+    // Validate credentials if not in dry run
+    if (!options.dryRun && !hasValidCredentials(settings))
+        return exitSync(1);
+    if (!settings._versionId) {
+        return logErrorAndExit(noVersionIdError);
+    }
+    if (!settings.files) {
+        return logErrorAndExit(noFilesError);
+    }
+    // Files
+    const { resolvedPaths, placeholderPaths, transformPaths } = settings.files;
+    const fileMapping = createFileMapping(resolvedPaths, placeholderPaths, transformPaths, settings.locales, settings.defaultLocale);
+    // Collect the hashes for all files we need to download
+    let fileVersionData;
+    if (settings.stageTranslations) {
+        fileVersionData = await getStagedVersions(settings.configDirectory);
+    }
+    else {
+        const { files } = await collectFiles(options, settings, library);
+        fileVersionData = convertToFileTranslationData(files);
+    }
+    // Check for remaining translations
+    await runDownloadWorkflow({
+        fileVersionData: fileVersionData,
+        jobData: undefined,
+        branchData: undefined,
+        locales: settings.locales,
+        timeoutDuration: options.timeout,
+        resolveOutputPath: (sourcePath, locale) => fileMapping[locale][sourcePath] ?? null,
+        options: settings,
+        forceRetranslation: false, // force is not applicable for downloading staged translations
+        forceDownload: options.force || options.forceDownload,
+    });
+}

package/dist/cli/commands/enqueue.d.ts

@@ -0,0 +1,9 @@
+import { EnqueueFilesResult } from 'generaltranslation/types';
+import { Settings, SupportedLibraries, TranslateFlags } from '../../types/index.js';
+/**
+ * Enqueues translations for a given set of files
+ * @param options - The options for the enqueue operation
+ * @param settings - The settings for the enqueue operation
+ * @returns {Promise<EnqueueFilesResult>} The enqueue result
+ */
+export declare function handleEnqueue(options: TranslateFlags, settings: Settings, library: SupportedLibraries): Promise<EnqueueFilesResult>;

package/dist/cli/commands/enqueue.js

@@ -0,0 +1,27 @@
+import { runEnqueueWorkflow } from '../../workflows/enqueue.js';
+import { collectFiles } from '../../formats/files/collectFiles.js';
+import { noFilesError, noVersionIdError } from '../../console/index.js';
+import { hasValidCredentials, hasValidLocales } from './utils/validation.js';
+import { exitSync, logErrorAndExit } from '../../console/logging.js';
+/**
+ * Enqueues translations for a given set of files
+ * @param options - The options for the enqueue operation
+ * @param settings - The settings for the enqueue operation
+ * @returns {Promise<EnqueueFilesResult>} The enqueue result
+ */
+export async function handleEnqueue(options, settings, library) {
+    if (!hasValidLocales(settings))
+        return exitSync(1);
+    // Validate credentials if not in dry run
+    if (!options.dryRun && !hasValidCredentials(settings))
+        return exitSync(1);
+    if (!settings._versionId) {
+        return logErrorAndExit(noVersionIdError);
+    }
+    if (!settings.files) {
+        return logErrorAndExit(noFilesError);
+    }
+    // Collect the data for all files we need to enqueue
+    const { files } = await collectFiles(options, settings, library);
+    return runEnqueueWorkflow({ files, options, settings });
+}

package/dist/cli/commands/setupProject.d.ts

@@ -1,5 +1,5 @@
 import { Settings, SupportedLibraries, TranslateFlags } from '../../types/index.js';
-import { FileTranslationData } from '../../workflow/download.js';
+import { FileTranslationData } from '../../workflows/download.js';
 import { BranchData } from '../../types/branch.js';
 export declare function handleSetupProject(options: TranslateFlags, settings: Settings, library: SupportedLibraries): Promise<{
     fileVersionData: FileTranslationData | undefined;

package/dist/cli/commands/setupProject.js

@@ -1,27 +1,14 @@
 import { logger } from '../../console/logger.js';
-import { logCollectedFiles, logErrorAndExit } from '../../console/logging.js';
-import { noLocalesError, noDefaultLocaleError, noApiKeyError, noProjectIdError, devApiKeyError, } from '../../console/index.js';
+import { exitSync, logCollectedFiles } from '../../console/logging.js';
 import { collectFiles } from '../../formats/files/collectFiles.js';
-import { setupProject } from '../../workflow/setupProject.js';
+import { runSetupProjectWorkflow } from '../../workflows/setupProject.js';
+import { hasValidCredentials, hasValidLocales } from './utils/validation.js';
 export async function handleSetupProject(options, settings, library) {
-    if (!settings.locales) {
-        return logErrorAndExit(noLocalesError);
-    }
-    if (!settings.defaultLocale) {
-        return logErrorAndExit(noDefaultLocaleError);
-    }
-    // Validate required settings are present if not in dry run
-    if (!options.dryRun) {
-        if (!settings.apiKey) {
-            return logErrorAndExit(noApiKeyError);
-        }
-        if (settings.apiKey.startsWith('gtx-dev-')) {
-            return logErrorAndExit(devApiKeyError);
-        }
-        if (!settings.projectId) {
-            return logErrorAndExit(noProjectIdError);
-        }
-    }
+    if (!hasValidLocales(settings))
+        return exitSync(1);
+    // Validate credentials if not in dry run
+    if (!options.dryRun && !hasValidCredentials(settings))
+        return exitSync(1);
     const { files: allFiles, reactComponents } = await collectFiles(options, settings, library);
     // Dry run
     if (options.dryRun) {
@@ -33,7 +20,7 @@ export async function handleSetupProject(options, settings, library) {
     let fileVersionData;
     let branchData;
     if (allFiles.length > 0) {
-        const { branchData: branchDataResult } = await setupProject(allFiles, options, settings);
+        const { branchData: branchDataResult } = await runSetupProjectWorkflow(allFiles, options, settings);
         branchData = branchDataResult;
         fileVersionData = Object.fromEntries(allFiles.map((file) => [
             file.fileId,

package/dist/cli/commands/stage.d.ts

@@ -1,6 +1,6 @@
 import { Settings, SupportedLibraries, TranslateFlags } from '../../types/index.js';
 import type { EnqueueFilesResult } from 'generaltranslation/types';
-import { FileTranslationData } from '../../workflow/download.js';
+import { FileTranslationData } from '../../workflows/download.js';
 import { BranchData } from '../../types/branch.js';
 export declare function handleStage(options: TranslateFlags, settings: Settings, library: SupportedLibraries, stage: boolean): Promise<{
     fileVersionData: FileTranslationData | undefined;

package/dist/cli/commands/stage.js

@@ -1,30 +1,18 @@
 import { logger } from '../../console/logger.js';
-import { logCollectedFiles, logErrorAndExit } from '../../console/logging.js';
-import { noLocalesError, noDefaultLocaleError, noApiKeyError, noProjectIdError, devApiKeyError, } from '../../console/index.js';
-import { stageFiles } from '../../workflow/stage.js';
+import { exitSync, logCollectedFiles } from '../../console/logging.js';
+import { runStageFilesWorkflow } from '../../workflows/stage.js';
 import { updateVersions } from '../../fs/config/updateVersions.js';
 import updateConfig from '../../fs/config/updateConfig.js';
 import { TEMPLATE_FILE_ID } from '../../utils/constants.js';
 import { collectFiles } from '../../formats/files/collectFiles.js';
+import { convertToFileTranslationData } from '../../formats/files/convertToFileTranslationData.js';
+import { hasValidCredentials, hasValidLocales } from './utils/validation.js';
 export async function handleStage(options, settings, library, stage) {
-    if (!settings.locales) {
-        return logErrorAndExit(noLocalesError);
-    }
-    if (!settings.defaultLocale) {
-        return logErrorAndExit(noDefaultLocaleError);
-    }
-    // Validate required settings are present if not in dry run
-    if (!options.dryRun) {
-        if (!settings.apiKey) {
-            return logErrorAndExit(noApiKeyError);
-        }
-        if (settings.apiKey.startsWith('gtx-dev-')) {
-            return logErrorAndExit(devApiKeyError);
-        }
-        if (!settings.projectId) {
-            return logErrorAndExit(noProjectIdError);
-        }
-    }
+    if (!hasValidLocales(settings))
+        return exitSync(1);
+    // Validate credentials if not in dry run
+    if (!options.dryRun && !hasValidCredentials(settings))
+        return exitSync(1);
     const { files: allFiles, reactComponents } = await collectFiles(options, settings, library);
     // Dry run
     if (options.dryRun) {
@@ -37,16 +25,10 @@ export async function handleStage(options, settings, library, stage) {
     let jobData;
     let branchData;
     if (allFiles.length > 0) {
-        const { branchData: branchDataResult, enqueueResult } = await stageFiles(allFiles, options, settings);
+        const { branchData: branchDataResult, enqueueResult } = await runStageFilesWorkflow({ files: allFiles, options, settings });
         jobData = enqueueResult;
         branchData = branchDataResult;
-        fileVersionData = Object.fromEntries(allFiles.map((file) => [
-            file.fileId,
-            {
-                fileName: file.fileName,
-                versionId: file.versionId,
-            },
-        ]));
+        fileVersionData = convertToFileTranslationData(allFiles);
         // This logic is a little scuffed because stage is async from the API
         if (stage) {
             await updateVersions({

package/dist/cli/commands/translate.d.ts

@@ -1,8 +1,7 @@
 import { EnqueueFilesResult } from 'generaltranslation/types';
 import { TranslateFlags } from '../../types/index.js';
 import { Settings } from '../../types/index.js';
-import { FileTranslationData } from '../../workflow/download.js';
+import { FileTranslationData } from '../../workflows/download.js';
 import { BranchData } from '../../types/branch.js';
 export declare function handleTranslate(options: TranslateFlags, settings: Settings, fileVersionData: FileTranslationData | undefined, jobData: EnqueueFilesResult | undefined, branchData: BranchData | undefined): Promise<void>;
-export declare function handleDownload(options: TranslateFlags, settings: Settings): Promise<void>;
 export declare function postProcessTranslations(settings: Settings, includeFiles?: Set<string>): Promise<void>;

package/dist/cli/commands/translate.js

@@ -1,15 +1,12 @@
-import { downloadTranslations, } from '../../workflow/download.js';
+import { runDownloadWorkflow, } from '../../workflows/download.js';
 import { createFileMapping } from '../../formats/files/fileMapping.js';
-import { getStagedVersions } from '../../fs/config/updateVersions.js';
 import copyFile from '../../fs/copyFile.js';
 import flattenJsonFiles from '../../utils/flattenJsonFiles.js';
 import localizeStaticUrls from '../../utils/localizeStaticUrls.js';
 import localizeRelativeAssets from '../../utils/localizeRelativeAssets.js';
 import processAnchorIds from '../../utils/processAnchorIds.js';
 import processOpenApi from '../../utils/processOpenApi.js';
-import { noFilesError, noVersionIdError } from '../../console/index.js';
 import localizeStaticImports from '../../utils/localizeStaticImports.js';
-import { logErrorAndExit } from '../../console/logging.js';
 import { getDownloadedMeta } from '../../state/recentDownloads.js';
 import { persistPostProcessHashes } from '../../utils/persistPostprocessHashes.js';
 // Downloads translations that were completed
@@ -18,26 +15,19 @@ export async function handleTranslate(options, settings, fileVersionData, jobDat
         const { resolvedPaths, placeholderPaths, transformPaths } = settings.files;
         const fileMapping = createFileMapping(resolvedPaths, placeholderPaths, transformPaths, settings.locales, settings.defaultLocale);
         // Check for remaining translations
-        await downloadTranslations(fileVersionData, jobData, branchData, settings.locales, options.timeout, (sourcePath, locale) => fileMapping[locale]?.[sourcePath] ?? null, settings, options.force, options.forceDownload || options.force // if force is true should also force download
-        );
+        await runDownloadWorkflow({
+            fileVersionData: fileVersionData,
+            jobData: jobData,
+            branchData: branchData,
+            locales: settings.locales,
+            timeoutDuration: options.timeout,
+            resolveOutputPath: (sourcePath, locale) => fileMapping[locale]?.[sourcePath] ?? null,
+            options: settings,
+            forceRetranslation: options.force,
+            forceDownload: options.forceDownload || options.force, // if force is true should also force download
+        });
     }
 }
-// Downloads translations that were originally staged
-export async function handleDownload(options, settings) {
-    if (!settings._versionId) {
-        logErrorAndExit(noVersionIdError);
-    }
-    if (!settings.files) {
-        logErrorAndExit(noFilesError);
-    }
-    // Files
-    const { resolvedPaths, placeholderPaths, transformPaths } = settings.files;
-    const fileMapping = createFileMapping(resolvedPaths, placeholderPaths, transformPaths, settings.locales, settings.defaultLocale);
-    const stagedVersionData = await getStagedVersions(settings.configDirectory);
-    // Check for remaining translations
-    await downloadTranslations(stagedVersionData, undefined, undefined, settings.locales, options.timeout, (sourcePath, locale) => fileMapping[locale][sourcePath] ?? null, settings, false, // force is not applicable for downloading staged translations
-    options.force || options.forceDownload);
-}
 export async function postProcessTranslations(settings, includeFiles) {
     // Mintlify OpenAPI localization (spec routing + validation)
     await processOpenApi(settings, includeFiles);

package/dist/{formats/files → cli/commands}/upload.d.ts

@@ -1,13 +1,13 @@
 import { ResolvedFiles, Settings, TransformFiles } from '../../types/index.js';
 import { DataFormat } from '../../types/data.js';
-import { UploadOptions } from '../../cli/base.js';
+import { UploadOptions } from '../base.js';
 /**
  * Sends multiple files to the API for translation
  * @param filePaths - Resolved file paths for different file types
  * @param placeholderPaths - Placeholder paths for translated files
  * @param transformPaths - Transform paths for file naming
  * @param dataFormat - Format of the data within the files
- * @param options - Translation options including API settings
+ * @param settings - Translation options including API settings
  * @returns Promise that resolves when translation is complete
  */
-export declare function upload(filePaths: ResolvedFiles, placeholderPaths: ResolvedFiles, transformPaths: TransformFiles, dataFormat: DataFormat | undefined, options: Settings & UploadOptions): Promise<void>;
+export declare function upload(filePaths: ResolvedFiles, placeholderPaths: ResolvedFiles, transformPaths: TransformFiles, dataFormat: DataFormat | undefined, settings: Settings & UploadOptions): Promise<void>;

package/dist/{formats/files → cli/commands}/upload.js

@@ -1,15 +1,16 @@
-import { noSupportedFormatError, noDefaultLocaleError, noApiKeyError, noProjectIdError, devApiKeyError, } from '../../console/index.js';
-import { logErrorAndExit } from '../../console/logging.js';
+import { noSupportedFormatError, noDefaultLocaleError, } from '../../console/index.js';
+import { exitSync, logErrorAndExit } from '../../console/logging.js';
 import { logger } from '../../console/logger.js';
 import { getRelative, readFile } from '../../fs/findFilepath.js';
-import { SUPPORTED_FILE_EXTENSIONS } from './supportedFiles.js';
+import { SUPPORTED_FILE_EXTENSIONS } from '../../formats/files/supportedFiles.js';
 import sanitizeFileContent from '../../utils/sanitizeFileContent.js';
-import { parseJson } from '../json/parseJson.js';
-import { uploadFiles } from '../../workflow/upload.js';
+import { parseJson } from '../../formats/json/parseJson.js';
+import { runUploadFilesWorkflow } from '../../workflows/upload.js';
 import { existsSync, readFileSync } from 'node:fs';
-import { createFileMapping } from './fileMapping.js';
-import parseYaml from '../yaml/parseYaml.js';
+import { createFileMapping } from '../../formats/files/fileMapping.js';
+import parseYaml from '../../formats/yaml/parseYaml.js';
 import { hashStringSync } from '../../utils/hash.js';
+import { hasValidCredentials } from './utils/validation.js';
 const SUPPORTED_DATA_FORMATS = ['JSX', 'ICU', 'I18NEXT'];
 /**
  * Sends multiple files to the API for translation
@@ -17,13 +18,13 @@ const SUPPORTED_DATA_FORMATS = ['JSX', 'ICU', 'I18NEXT'];
  * @param placeholderPaths - Placeholder paths for translated files
  * @param transformPaths - Transform paths for file naming
  * @param dataFormat - Format of the data within the files
- * @param options - Translation options including API settings
+ * @param settings - Translation options including API settings
  * @returns Promise that resolves when translation is complete
  */
-export async function upload(filePaths, placeholderPaths, transformPaths, dataFormat = 'JSX', options) {
+export async function upload(filePaths, placeholderPaths, transformPaths, dataFormat = 'JSX', settings) {
     // Collect all files to translate
     const allFiles = [];
-    const additionalOptions = options.options || {};
+    const additionalOptions = settings.options || {};
     // Process JSON files
     if (filePaths.json) {
         if (!SUPPORTED_DATA_FORMATS.includes(dataFormat)) {
@@ -31,14 +32,14 @@ export async function upload(filePaths, placeholderPaths, transformPaths, dataFo
         }
         const jsonFiles = filePaths.json.map((filePath) => {
             const content = readFile(filePath);
-            const parsedJson = parseJson(content, filePath, additionalOptions, options.defaultLocale);
+            const parsedJson = parseJson(content, filePath, additionalOptions, settings.defaultLocale);
             const relativePath = getRelative(filePath);
             return {
                 content: parsedJson,
                 fileName: relativePath,
                 fileFormat: 'JSON',
                 dataFormat,
-                locale: options.defaultLocale,
+                locale: settings.defaultLocale,
                 fileId: hashStringSync(relativePath),
                 versionId: hashStringSync(parsedJson),
             };
@@ -59,7 +60,7 @@ export async function upload(filePaths, placeholderPaths, transformPaths, dataFo
                 fileName: relativePath,
                 fileFormat,
                 dataFormat,
-                locale: options.defaultLocale,
+                locale: settings.defaultLocale,
                 fileId: hashStringSync(relativePath),
                 versionId: hashStringSync(parsedYaml),
             };
@@ -79,7 +80,7 @@ export async function upload(filePaths, placeholderPaths, transformPaths, dataFo
                     fileName: relativePath,
                     fileFormat: fileType.toUpperCase(),
                     dataFormat,
-                    locale: options.defaultLocale,
+                    locale: settings.defaultLocale,
                     fileId: hashStringSync(relativePath),
                     versionId: hashStringSync(sanitizedContent),
                 };
@@ -91,21 +92,14 @@ export async function upload(filePaths, placeholderPaths, transformPaths, dataFo
         logger.error('No files to upload were found. Please check your configuration and try again.');
         return;
     }
-    if (!options.defaultLocale) {
+    if (!settings.defaultLocale) {
         return logErrorAndExit(noDefaultLocaleError);
     }
-    if (!options.apiKey) {
-        return logErrorAndExit(noApiKeyError);
-    }
-    if (options.apiKey.startsWith('gtx-dev-')) {
-        return logErrorAndExit(devApiKeyError);
-    }
-    if (!options.projectId) {
-        return logErrorAndExit(noProjectIdError);
-    }
-    const locales = options.locales || [];
+    if (!hasValidCredentials(settings))
+        return exitSync(1);
+    const locales = settings.locales || [];
     // Create file mapping for all file types
-    const fileMapping = createFileMapping(filePaths, placeholderPaths, transformPaths, locales, options.defaultLocale);
+    const fileMapping = createFileMapping(filePaths, placeholderPaths, transformPaths, locales, settings.defaultLocale);
     // construct object
     const uploadData = allFiles.map((file) => {
         const sourceFile = {
@@ -140,7 +134,7 @@ export async function upload(filePaths, placeholderPaths, transformPaths, dataFo
     });
     try {
         // Send all files in a single API call
-        await uploadFiles(uploadData, options);
+        await runUploadFilesWorkflow({ files: uploadData, options: settings });
     }
     catch (error) {
         logErrorAndExit(`Error uploading files: ${error}`);

package/dist/cli/commands/utils/validation.d.ts

@@ -0,0 +1,13 @@
+import { Settings } from '../../../types/index.js';
+/**
+ * Validate locales
+ * @param settings - The settings to validate
+ * @returns True if has locales and default locale
+ */
+export declare function hasValidLocales(settings: Settings): boolean;
+/**
+ * Validate credentials
+ * @param settings - The settings to validate
+ * @returns True if has API key, project ID, and does not have a development API key
+ */
+export declare function hasValidCredentials(settings: Settings): boolean;

package/dist/cli/commands/utils/validation.js

@@ -0,0 +1,38 @@
+import { noDefaultLocaleError, noLocalesError, noApiKeyError, devApiKeyError, noProjectIdError, } from '../../../console/index.js';
+import { logger } from '../../../console/logger.js';
+/**
+ * Validate locales
+ * @param settings - The settings to validate
+ * @returns True if has locales and default locale
+ */
+export function hasValidLocales(settings) {
+    if (!settings.locales) {
+        logger.error(noLocalesError);
+        return false;
+    }
+    if (!settings.defaultLocale) {
+        logger.error(noDefaultLocaleError);
+        return false;
+    }
+    return true;
+}
+/**
+ * Validate credentials
+ * @param settings - The settings to validate
+ * @returns True if has API key, project ID, and does not have a development API key
+ */
+export function hasValidCredentials(settings) {
+    if (!settings.apiKey) {
+        logger.error(noApiKeyError);
+        return false;
+    }
+    if (settings.apiKey.startsWith('gtx-dev-')) {
+        logger.error(devApiKeyError);
+        return false;
+    }
+    if (!settings.projectId) {
+        logger.error(noProjectIdError);
+        return false;
+    }
+    return true;
+}