gtx-cli 2.5.0-alpha.0 → 2.5.0-alpha.2

package/dist/workflow/UserEditDiffsStep.d.ts

@@ -0,0 +1,11 @@
+import type { FileReference } from 'generaltranslation/types';
+import { WorkflowStep } from './Workflow.js';
+import { Settings } from '../types/index.js';
+export declare class UserEditDiffsStep extends WorkflowStep<FileReference[], FileReference[]> {
+    private settings;
+    private spinner;
+    private completed;
+    constructor(settings: Settings);
+    run(files: FileReference[]): Promise<FileReference[]>;
+    wait(): Promise<void>;
+}

package/dist/workflow/UserEditDiffsStep.js

@@ -0,0 +1,30 @@
+import { WorkflowStep } from './Workflow.js';
+import { createSpinner } from '../console/logging.js';
+import chalk from 'chalk';
+import { collectAndSendUserEditDiffs } from '../api/collectUserEditDiffs.js';
+export class UserEditDiffsStep extends WorkflowStep {
+    settings;
+    spinner = createSpinner('dots');
+    completed = false;
+    constructor(settings) {
+        super();
+        this.settings = settings;
+    }
+    async run(files) {
+        this.spinner.start('Updating translations...');
+        try {
+            await collectAndSendUserEditDiffs(files, this.settings);
+            this.completed = true;
+        }
+        catch {
+            // Non-fatal; keep going to enqueue
+            this.completed = true;
+        }
+        return files;
+    }
+    async wait() {
+        if (this.completed) {
+            this.spinner.stop(chalk.green('Updated translations'));
+        }
+    }
+}

package/dist/workflow/Workflow.d.ts

@@ -0,0 +1,4 @@
+export declare abstract class WorkflowStep<TInput = void, TOutput = void> {
+    abstract run(input: TInput): Promise<TOutput>;
+    abstract wait(): Promise<void>;
+}

package/dist/workflow/Workflow.js

@@ -0,0 +1,2 @@
+export class WorkflowStep {
+}

package/dist/workflow/download.d.ts

@@ -0,0 +1,22 @@
+import { Settings } from '../types/index.js';
+import { EnqueueFilesResult } from 'generaltranslation/types';
+import { BranchData } from '../types/branch.js';
+export type FileTranslationData = {
+    [fileId: string]: {
+        versionId: string;
+        fileName: string;
+    };
+};
+/**
+ * Checks the status of translations and downloads them using a workflow pattern
+ * @param fileVersionData - Mapping of file IDs to their version and name information
+ * @param jobData - Optional job data from enqueue operation
+ * @param locales - The locales to wait for
+ * @param timeoutDuration - The timeout duration for the wait in seconds
+ * @param resolveOutputPath - Function to resolve the output path for a given source path and locale
+ * @param options - Settings configuration
+ * @param forceRetranslation - Whether to force retranslation
+ * @param forceDownload - Whether to force download even if file exists
+ * @returns True if all translations are downloaded successfully, false otherwise
+ */
+export declare function downloadTranslations(fileVersionData: FileTranslationData, jobData: EnqueueFilesResult | undefined, branchData: BranchData | undefined, locales: string[], timeoutDuration: number, resolveOutputPath: (sourcePath: string, locale: string) => string | null, options: Settings, forceRetranslation?: boolean, forceDownload?: boolean): Promise<boolean>;

package/dist/workflow/download.js

@@ -0,0 +1,104 @@
+import path from 'node:path';
+import { gt } from '../utils/gt.js';
+import { clearLocaleDirs } from '../fs/clearLocaleDirs.js';
+import { PollTranslationJobsStep } from './PollJobsStep.js';
+import { DownloadTranslationsStep } from './DownloadStep.js';
+import { logErrorAndExit } from '../console/logging.js';
+import { BranchStep } from './BranchStep.js';
+/**
+ * Checks the status of translations and downloads them using a workflow pattern
+ * @param fileVersionData - Mapping of file IDs to their version and name information
+ * @param jobData - Optional job data from enqueue operation
+ * @param locales - The locales to wait for
+ * @param timeoutDuration - The timeout duration for the wait in seconds
+ * @param resolveOutputPath - Function to resolve the output path for a given source path and locale
+ * @param options - Settings configuration
+ * @param forceRetranslation - Whether to force retranslation
+ * @param forceDownload - Whether to force download even if file exists
+ * @returns True if all translations are downloaded successfully, false otherwise
+ */
+export async function downloadTranslations(fileVersionData, jobData, branchData, locales, timeoutDuration, resolveOutputPath, options, forceRetranslation, forceDownload) {
+    if (!branchData) {
+        // Run the branch step
+        const branchStep = new BranchStep(gt, options);
+        const branchResult = await branchStep.run();
+        await branchStep.wait();
+        if (!branchResult) {
+            logErrorAndExit('Failed to resolve git branch information.');
+        }
+        branchData = branchResult;
+    }
+    // Prepare the query data
+    const fileQueryData = prepareFileQueryData(fileVersionData, locales, branchData);
+    // Clear translated files before any downloads (if enabled)
+    if (options.options?.experimentalClearLocaleDirs === true &&
+        fileQueryData.length > 0) {
+        const translatedFiles = new Set(fileQueryData
+            .map((file) => {
+            const outputPath = resolveOutputPath(file.fileName, file.locale);
+            // Only clear if the output path is different from the source (i.e., there's a transform)
+            return outputPath !== null && outputPath !== file.fileName
+                ? outputPath
+                : null;
+        })
+            .filter((path) => path !== null));
+        // Derive cwd from config path
+        const cwd = path.dirname(options.config);
+        await clearLocaleDirs(translatedFiles, locales, options.options?.clearLocaleDirsExclude, cwd);
+    }
+    // Initialize download status
+    const fileTracker = {
+        completed: new Map(),
+        inProgress: new Map(),
+        failed: new Map(),
+        skipped: new Map(),
+    };
+    // Step 1: Poll translation jobs if jobData exists
+    if (jobData) {
+        const pollStep = new PollTranslationJobsStep(gt);
+        const pollResult = await pollStep.run({
+            fileTracker,
+            fileQueryData,
+            jobData,
+            timeoutDuration,
+            forceRetranslation,
+        });
+        await pollStep.wait();
+        if (!pollResult.success) {
+            return false;
+        }
+    }
+    else {
+        for (const file of fileQueryData) {
+            // Staging - assume all files are completed
+            fileTracker.completed.set(`${file.branchId}:${file.fileId}:${file.versionId}:${file.locale}`, file);
+        }
+    }
+    // Step 2: Download translations
+    const downloadStep = new DownloadTranslationsStep(gt, options);
+    const downloadResult = await downloadStep.run({
+        fileTracker,
+        resolveOutputPath,
+        forceDownload,
+    });
+    await downloadStep.wait();
+    return downloadResult;
+}
+/**
+ * Prepares the file query data from input data and locales
+ */
+function prepareFileQueryData(fileVersionData, locales, branchData) {
+    const fileQueryData = [];
+    for (const fileId in fileVersionData) {
+        for (const locale of locales) {
+            fileQueryData.push({
+                versionId: fileVersionData[fileId].versionId,
+                fileName: fileVersionData[fileId].fileName,
+                fileId,
+                locale,
+                branchId: branchData.currentBranch.id,
+            });
+        }
+    }
+    return fileQueryData;
+}

package/dist/workflow/stage.d.ts

@@ -0,0 +1,14 @@
+import { Settings, TranslateFlags } from '../types/index.js';
+import { EnqueueFilesResult, FileToUpload } from 'generaltranslation/types';
+import { BranchData } from '../types/branch.js';
+/**
+ * Sends multiple files for translation to the API using a workflow pattern
+ * @param files - Array of file objects to translate
+ * @param options - The options for the API call
+ * @param settings - Settings configuration
+ * @returns The translated content or version ID
+ */
+export declare function stageFiles(files: FileToUpload[], options: TranslateFlags, settings: Settings): Promise<{
+    branchData: BranchData;
+    enqueueResult: EnqueueFilesResult;
+}>;

package/dist/workflow/stage.js

@@ -0,0 +1,76 @@
+import chalk from 'chalk';
+import { logErrorAndExit, logMessage } from '../console/logging.js';
+import { gt } from '../utils/gt.js';
+import { TEMPLATE_FILE_NAME } from '../cli/commands/stage.js';
+import { UploadStep } from './UploadStep.js';
+import { SetupStep } from './SetupStep.js';
+import { EnqueueStep } from './EnqueueStep.js';
+import { BranchStep } from './BranchStep.js';
+import { UserEditDiffsStep } from './UserEditDiffsStep.js';
+/**
+ * Helper: Calculate timeout with validation
+ */
+function calculateTimeout(timeout) {
+    const value = timeout !== undefined ? Number(timeout) : 600;
+    return (Number.isFinite(value) ? value : 600) * 1000;
+}
+/**
+ * Helper: Log files to be translated
+ */
+function logFilesToTranslate(files) {
+    logMessage(chalk.cyan('Files found in project:') +
+        '\n' +
+        files
+            .map((file) => {
+            if (file.fileName === TEMPLATE_FILE_NAME) {
+                return `- <React Elements>`;
+            }
+            return `- ${file.fileName}`;
+        })
+            .join('\n'));
+}
+/**
+ * Sends multiple files for translation to the API using a workflow pattern
+ * @param files - Array of file objects to translate
+ * @param options - The options for the API call
+ * @param settings - Settings configuration
+ * @returns The translated content or version ID
+ */
+export async function stageFiles(files, options, settings) {
+    try {
+        // Log files to be translated
+        logFilesToTranslate(files);
+        // Calculate timeout for setup step
+        const timeoutMs = calculateTimeout(options.timeout);
+        // Create workflow with steps
+        const branchStep = new BranchStep(gt, settings);
+        const uploadStep = new UploadStep(gt, settings);
+        const userEditDiffsStep = new UserEditDiffsStep(settings);
+        const setupStep = new SetupStep(gt, settings, timeoutMs);
+        const enqueueStep = new EnqueueStep(gt, settings, options.force);
+        // first run the branch step
+        const branchData = await branchStep.run();
+        await branchStep.wait();
+        if (!branchData) {
+            logErrorAndExit('Failed to resolve git branch information.');
+        }
+        // then run the upload step
+        const uploadedFiles = await uploadStep.run({ files, branchData });
+        await uploadStep.wait();
+        // optionally run the user edit diffs step
+        if (options?.saveLocal) {
+            await userEditDiffsStep.run(uploadedFiles);
+            await userEditDiffsStep.wait();
+        }
+        // then run the setup step
+        await setupStep.run(uploadedFiles);
+        await setupStep.wait();
+        // then run the enqueue step
+        const enqueueResult = await enqueueStep.run(uploadedFiles);
+        await enqueueStep.wait();
+        return { branchData, enqueueResult };
+    }
+    catch (error) {
+        logErrorAndExit('Failed to send files for translation. ' + error);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gtx-cli",
-  "version": "2.5.0-alpha.0",
+  "version": "2.5.0-alpha.2",
   "main": "dist/index.js",
   "bin": "dist/main.js",
   "files": [
@@ -67,7 +67,7 @@
     "@babel/parser": "^7.25.7",
     "@babel/plugin-transform-react-jsx": "^7.25.9",
     "@babel/traverse": "^7.25.7",
-    "@clack/prompts": "^1.0.0-alpha.1",
+    "@clack/prompts": "^1.0.0-alpha.6",
     "@formatjs/icu-messageformat-parser": "^2.11.4",
     "chalk": "^5.4.1",
     "commander": "^12.1.0",
@@ -84,7 +84,6 @@
     "mdast-util-find-and-replace": "^3.0.2",
     "micromatch": "^4.0.8",
     "open": "^10.1.1",
-    "ora": "^8.2.0",
     "remark-frontmatter": "^5.0.0",
     "remark-mdx": "^3.1.0",
     "remark-parse": "^11.0.0",
@@ -94,7 +93,7 @@
     "unified": "^11.0.5",
     "unist-util-visit": "^5.0.0",
     "yaml": "^2.8.0",
-    "generaltranslation": "7.9.0"
+    "generaltranslation": "8.0.0-alpha.1"
   },
   "devDependencies": {
     "@babel/types": "^7.28.4",

package/dist/api/checkFileTranslations.d.ts

@@ -1,23 +0,0 @@
-import { Settings } from '../types/index.js';
-export type CheckFileTranslationData = {
-    [key: string]: {
-        versionId: string;
-        fileName: string;
-    };
-};
-/**
- * Checks the status of translations for a given version ID
- * @param apiKey - The API key for the General Translation API
- * @param baseUrl - The base URL for the General Translation API
- * @param versionId - The version ID of the project
- * @param locales - The locales to wait for
- * @param startTime - The start time of the wait
- * @param timeoutDuration - The timeout duration for the wait in seconds
- * @returns True if all translations are deployed, false otherwise
- */
-export declare function checkFileTranslations(data: {
-    [key: string]: {
-        versionId: string;
-        fileName: string;
-    };
-}, locales: string[], timeoutDuration: number, resolveOutputPath: (sourcePath: string, locale: string) => string | null, options: Settings, forceRetranslation?: boolean, forceDownload?: boolean): Promise<boolean>;

package/dist/api/checkFileTranslations.js

@@ -1,281 +0,0 @@
-import chalk from 'chalk';
-import { createOraSpinner, logError } from '../console/logging.js';
-import { getLocaleProperties } from 'generaltranslation';
-import { downloadFileBatch } from './downloadFileBatch.js';
-import { gt } from '../utils/gt.js';
-import { TEMPLATE_FILE_NAME } from '../cli/commands/stage.js';
-import { clearLocaleDirs } from '../fs/clearLocaleDirs.js';
-import path from 'node:path';
-/**
- * Checks the status of translations for a given version ID
- * @param apiKey - The API key for the General Translation API
- * @param baseUrl - The base URL for the General Translation API
- * @param versionId - The version ID of the project
- * @param locales - The locales to wait for
- * @param startTime - The start time of the wait
- * @param timeoutDuration - The timeout duration for the wait in seconds
- * @returns True if all translations are deployed, false otherwise
- */
-export async function checkFileTranslations(data, locales, timeoutDuration, resolveOutputPath, options, forceRetranslation, forceDownload) {
-    const startTime = Date.now();
-    console.log();
-    const spinner = await createOraSpinner();
-    const spinnerMessage = forceRetranslation
-        ? 'Waiting for retranslation...'
-        : 'Waiting for translation...';
-    spinner.start(spinnerMessage);
-    // Initialize the query data
-    const fileQueryData = prepareFileQueryData(data, locales);
-    // Clear translated files before any downloads (if enabled)
-    if (options.options?.experimentalClearLocaleDirs === true &&
-        fileQueryData.length > 0) {
-        const translatedFiles = new Set(fileQueryData
-            .map((file) => {
-            const outputPath = resolveOutputPath(file.fileName, file.locale);
-            // Only clear if the output path is different from the source (i.e., there's a transform)
-            return outputPath !== null && outputPath !== file.fileName
-                ? outputPath
-                : null;
-        })
-            .filter((path) => path !== null));
-        // Derive cwd from config path
-        const cwd = path.dirname(options.config);
-        await clearLocaleDirs(translatedFiles, locales, options.options?.clearLocaleDirsExclude, cwd);
-    }
-    const downloadStatus = {
-        downloaded: new Set(),
-        failed: new Set(),
-        skipped: new Set(),
-    };
-    // Do first check immediately, but skip if force retranslation is enabled
-    if (!forceRetranslation) {
-        const initialCheck = await checkTranslationDeployment(fileQueryData, downloadStatus, spinner, resolveOutputPath, options, forceDownload);
-        if (initialCheck) {
-            spinner.succeed(chalk.green('Files translated!'));
-            return true;
-        }
-    }
-    // Calculate time until next 5-second interval since startTime
-    const msUntilNextInterval = Math.max(0, 5000 - ((Date.now() - startTime) % 5000));
-    return new Promise((resolve) => {
-        let intervalCheck;
-        // Start the interval aligned with the original request time
-        setTimeout(() => {
-            intervalCheck = setInterval(async () => {
-                const isDeployed = await checkTranslationDeployment(fileQueryData, downloadStatus, spinner, resolveOutputPath, options, forceDownload);
-                const elapsed = Date.now() - startTime;
-                if (isDeployed || elapsed >= timeoutDuration * 1000) {
-                    clearInterval(intervalCheck);
-                    if (isDeployed) {
-                        spinner.succeed(chalk.green('All files translated!'));
-                        resolve(true);
-                    }
-                    else {
-                        spinner.fail(chalk.red('Timed out waiting for translations'));
-                        resolve(false);
-                    }
-                }
-            }, 5000);
-        }, msUntilNextInterval);
-    });
-}
-/**
- * Prepares the file query data from input data and locales
- */
-function prepareFileQueryData(data, locales) {
-    const fileQueryData = [];
-    for (const file in data) {
-        for (const locale of locales) {
-            fileQueryData.push({
-                versionId: data[file].versionId,
-                fileName: data[file].fileName,
-                locale,
-            });
-        }
-    }
-    return fileQueryData;
-}
-/**
- * Generates a formatted status text showing translation progress
- * @param downloadedFiles - Set of downloaded file+locale combinations
- * @param fileQueryData - Array of file query data objects
- * @returns Formatted status text
- */
-function generateStatusSuffixText(downloadStatus, fileQueryData) {
-    // Simple progress indicator
-    const progressText = chalk.green(`[${downloadStatus.downloaded.size +
-        downloadStatus.failed.size +
-        downloadStatus.skipped.size}/${fileQueryData.length}]`) + ` translations completed`;
-    // Get terminal height to adapt our output
-    const terminalHeight = process.stdout.rows || 24; // Default to 24 if undefined
-    // If terminal is very small, just show the basic progress
-    if (terminalHeight < 6) {
-        return `${progressText}`;
-    }
-    const newSuffixText = [`${progressText}`];
-    // Organize data by filename
-    const fileStatus = new Map();
-    // Initialize with all files and locales from fileQueryData
-    for (const item of fileQueryData) {
-        if (!fileStatus.has(item.fileName)) {
-            fileStatus.set(item.fileName, {
-                completed: new Set(),
-                pending: new Set([item.locale]),
-                failed: new Set(),
-                skipped: new Set(),
-            });
-        }
-        else {
-            fileStatus.get(item.fileName)?.pending.add(item.locale);
-        }
-    }
-    // Mark which ones are completed or failed
-    for (const fileLocale of downloadStatus.downloaded) {
-        const [fileName, locale] = fileLocale.split(':');
-        const status = fileStatus.get(fileName);
-        if (status) {
-            status.pending.delete(locale);
-            status.completed.add(locale);
-        }
-    }
-    for (const fileLocale of downloadStatus.failed) {
-        const [fileName, locale] = fileLocale.split(':');
-        const status = fileStatus.get(fileName);
-        if (status) {
-            status.pending.delete(locale);
-            status.failed.add(locale);
-        }
-    }
-    for (const fileLocale of downloadStatus.skipped) {
-        const [fileName, locale] = fileLocale.split(':');
-        const status = fileStatus.get(fileName);
-        if (status) {
-            status.pending.delete(locale);
-            status.skipped.add(locale);
-        }
-    }
-    // Calculate how many files we can show based on terminal height
-    const filesArray = Array.from(fileStatus.entries());
-    const maxFilesToShow = Math.min(filesArray.length, terminalHeight - 3 // Header + progress + buffer
-    );
-    // Display each file with its status on a single line
-    for (let i = 0; i < maxFilesToShow; i++) {
-        const [fileName, status] = filesArray[i];
-        // Create condensed locale status
-        const localeStatuses = [];
-        // Add completed locales
-        if (status.completed.size > 0) {
-            const completedCodes = Array.from(status.completed)
-                .map((locale) => getLocaleProperties(locale).code)
-                .join(', ');
-            localeStatuses.push(chalk.green(`${completedCodes}`));
-        }
-        // Add (translated but not downloaded) skipped locales
-        if (status.skipped.size > 0) {
-            const skippedCodes = Array.from(status.skipped)
-                .map((locale) => getLocaleProperties(locale).code)
-                .join(', ');
-            localeStatuses.push(chalk.green(`${skippedCodes}`));
-        }
-        // Add failed locales
-        if (status.failed.size > 0) {
-            const failedCodes = Array.from(status.failed)
-                .map((locale) => getLocaleProperties(locale).code)
-                .join(', ');
-            localeStatuses.push(chalk.red(`${failedCodes}`));
-        }
-        // Add pending locales
-        if (status.pending.size > 0) {
-            const pendingCodes = Array.from(status.pending)
-                .map((locale) => getLocaleProperties(locale).code)
-                .join(', ');
-            localeStatuses.push(chalk.yellow(`${pendingCodes}`));
-        }
-        // Format the line
-        const prettyFileName = fileName === TEMPLATE_FILE_NAME ? '<React Elements>' : fileName;
-        newSuffixText.push(`${chalk.bold(prettyFileName)} [${localeStatuses.join(', ')}]`);
-    }
-    // If we couldn't show all files, add an indicator
-    if (filesArray.length > maxFilesToShow) {
-        newSuffixText.push(`... and ${filesArray.length - maxFilesToShow} more files`);
-    }
-    return newSuffixText.join('\n');
-}
-/**
- * Checks translation status and downloads ready files
- */
-async function checkTranslationDeployment(fileQueryData, downloadStatus, spinner, resolveOutputPath, options, forceDownload) {
-    try {
-        // Only query for files that haven't been downloaded yet
-        const currentQueryData = fileQueryData.filter((item) => !downloadStatus.downloaded.has(`${item.fileName}:${item.locale}`) &&
-            !downloadStatus.failed.has(`${item.fileName}:${item.locale}`) &&
-            !downloadStatus.skipped.has(`${item.fileName}:${item.locale}`));
-        // If all files have been downloaded, we're done
-        if (currentQueryData.length === 0) {
-            return true;
-        }
-        // Check for translations
-        const responseData = await gt.checkFileTranslations(currentQueryData);
-        const translations = responseData.translations || [];
-        // Filter for ready translations
-        const readyTranslations = translations.filter((translation) => translation.isReady && translation.fileName);
-        if (readyTranslations.length > 0) {
-            // Build version map by fileName:locale for this batch
-            const versionMap = new Map(fileQueryData.map((item) => [
-                `${item.fileName}:${gt.resolveAliasLocale(item.locale)}`,
-                item.versionId,
-            ]));
-            // Prepare batch download data
-            const batchFiles = readyTranslations
-                .map((translation) => {
-                const locale = gt.resolveAliasLocale(translation.locale);
-                const fileName = translation.fileName;
-                const translationId = translation.id;
-                const outputPath = resolveOutputPath(fileName, locale);
-                // Skip downloading GTJSON files that are not in the files configuration
-                if (outputPath === null) {
-                    downloadStatus.skipped.add(`${fileName}:${locale}`);
-                    return null;
-                }
-                return {
-                    translationId,
-                    inputPath: fileName,
-                    outputPath,
-                    locale,
-                    fileLocale: `${fileName}:${locale}`,
-                    fileId: translation.fileId,
-                    versionId: versionMap.get(`${fileName}:${locale}`),
-                };
-            })
-                .filter((file) => file !== null);
-            if (batchFiles.length > 0) {
-                const batchResult = await downloadFileBatch(batchFiles, options, 3, 1000, Boolean(forceDownload));
-                // Process results
-                batchFiles.forEach((file) => {
-                    const { translationId, fileLocale } = file;
-                    if (batchResult.successful.includes(translationId)) {
-                        downloadStatus.downloaded.add(fileLocale);
-                    }
-                    else if (batchResult.failed.includes(translationId)) {
-                        downloadStatus.failed.add(fileLocale);
-                    }
-                });
-            }
-        }
-        // Force a refresh of the spinner display
-        const statusText = generateStatusSuffixText(downloadStatus, fileQueryData);
-        // Clear and reapply the suffix to force a refresh
-        spinner.text = statusText;
-        // If all files have been downloaded, we're done
-        if (downloadStatus.downloaded.size +
-            downloadStatus.failed.size +
-            downloadStatus.skipped.size ===
-            fileQueryData.length) {
-            return true;
-        }
-    }
-    catch (error) {
-        logError(chalk.red('Error checking translation status: ') + error);
-    }
-    return false;
-}

package/dist/api/sendFiles.d.ts

@@ -1,17 +0,0 @@
-import { Settings, TranslateFlags } from '../types/index.js';
-import { CompletedFileTranslationData, FileToTranslate } from 'generaltranslation/types';
-export type SendFilesResult = {
-    data: Record<string, {
-        fileName: string;
-        versionId: string;
-    }>;
-    locales: string[];
-    translations: CompletedFileTranslationData[];
-};
-/**
- * Sends multiple files for translation to the API
- * @param files - Array of file objects to translate
- * @param options - The options for the API call
- * @returns The translated content or version ID
- */
-export declare function sendFiles(files: FileToTranslate[], options: TranslateFlags, settings: Settings): Promise<SendFilesResult>;