gtx-cli 2.5.7 → 2.5.9

package/dist/setup/wizard.js

@@ -1,6 +1,6 @@
 import { detectFormatter } from '../hooks/postProcess.js';
-import { createSpinner, promptSelect } from '../console/logging.js';
-import { logInfo, logError, logStep, logWarning } from '../console/logging.js';
+import { promptSelect } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import chalk from 'chalk';
 import { promptConfirm } from '../console/logging.js';
 import findFilepath from '../fs/findFilepath.js';
@@ -13,6 +13,7 @@ import { installPackage } from '../utils/installPackage.js';
 import { createOrUpdateConfig } from '../fs/config/setupConfig.js';
 import { loadConfig } from '../fs/config/loadConfig.js';
 import { addVitePlugin } from '../react/parse/addVitePlugin/index.js';
+import { exitSync } from '../console/logging.js';
 export async function handleSetupReactCommand(options) {
     // Ask user for confirmation using inquirer
     const answer = await promptConfirm({
@@ -24,8 +25,8 @@ Make sure you have committed or stashed any changes. Do you want to continue?`),
         cancelMessage: 'Operation cancelled. You can re-run this wizard with: npx gtx-cli setup',
     });
     if (!answer) {
-        logInfo('Operation cancelled. You can re-run this wizard with: npx gtx-cli setup');
-        process.exit(0);
+        logger.info('Operation cancelled. You can re-run this wizard with: npx gtx-cli setup');
+        exitSync(0);
     }
     const frameworkType = await promptSelect({
         message: 'What framework are you using?',
@@ -41,9 +42,9 @@ Make sure you have committed or stashed any changes. Do you want to continue?`),
         defaultValue: 'next-app',
     });
     if (frameworkType === 'other') {
-        logError(`Sorry, other React frameworks are not currently supported. 
+        logger.error(`Sorry, other React frameworks are not currently supported. 
 Please let us know what you would like to see supported at https://github.com/generaltranslation/gt/issues`);
-        process.exit(0);
+        exitSync(0);
     }
     // ----- Create a starter gt.config.json file -----
     await createOrUpdateConfig(options.config || 'gt.config.json', {
@@ -51,14 +52,14 @@ Please let us know what you would like to see supported at https://github.com/ge
     });
     const packageJson = await getPackageJson();
     if (!packageJson) {
-        logError(chalk.red('No package.json found in the current directory. Please run this command from the root of your project.'));
-        process.exit(1);
+        logger.error(chalk.red('No package.json found in the current directory. Please run this command from the root of your project.'));
+        exitSync(1);
     }
     // Check if gt-next or gt-react is installed
     if (frameworkType === 'next-app' &&
         !isPackageInstalled('gt-next', packageJson)) {
         const packageManager = await getPackageManager();
-        const spinner = createSpinner('timer');
+        const spinner = logger.createSpinner('timer');
         spinner.start(`Installing gt-next with ${packageManager.name}...`);
         await installPackage('gt-next', packageManager);
         spinner.stop(chalk.green('Automatically installed gt-next.'));
@@ -66,7 +67,7 @@ Please let us know what you would like to see supported at https://github.com/ge
     else if (['next-pages', 'react', 'redwood', 'vite', 'gatsby'].includes(frameworkType) &&
         !isPackageInstalled('gt-react', packageJson)) {
         const packageManager = await getPackageManager();
-        const spinner = createSpinner('timer');
+        const spinner = logger.createSpinner('timer');
         spinner.start(`Installing gt-react with ${packageManager.name}...`);
         await installPackage('gt-react', packageManager);
         spinner.stop(chalk.green('Automatically installed gt-react.'));
@@ -86,8 +87,8 @@ Please let us know what you would like to see supported at https://github.com/ge
             './next.config.mts',
         ]);
         if (!nextConfigPath) {
-            logError('No next.config.[js|ts|mjs|mts] file found.');
-            process.exit(1);
+            logger.error('No next.config.[js|ts|mjs|mts] file found.');
+            exitSync(1);
         }
         const mergeOptions = {
             ...options,
@@ -96,7 +97,7 @@ Please let us know what you would like to see supported at https://github.com/ge
             skipTs: true,
             addGTProvider: true,
         };
-        const spinner = createSpinner();
+        const spinner = logger.createSpinner();
         spinner.start('Wrapping JSX content with <T> tags...');
         // Wrap all JSX elements in the src directory with a <T> tag, with unique ids
         const { filesUpdated: filesUpdatedNext } = await wrapContentNext(mergeOptions, 'gt-next', errors, warnings);
@@ -104,7 +105,7 @@ Please let us know what you would like to see supported at https://github.com/ge
         spinner.stop(chalk.green(`Success! Updated ${chalk.bold.cyan(filesUpdated.length)} files:\n`) + filesUpdated.map((file) => `${chalk.green('-')} ${file}`).join('\n'));
         // Add the withGTConfig() function to the next.config.js file
         await handleInitGT(nextConfigPath, errors, warnings, filesUpdated, packageJson, tsconfigJson);
-        logStep(chalk.green(`Added withGTConfig() to your ${nextConfigPath} file.`));
+        logger.step(chalk.green(`Added withGTConfig() to your ${nextConfigPath} file.`));
     }
     // Add gt compiler plugin
     if (frameworkType === 'vite') {
@@ -117,10 +118,10 @@ Please let us know what you would like to see supported at https://github.com/ge
         });
     }
     if (errors.length > 0) {
-        logError(chalk.red('Failed to write files:\n') + errors.join('\n'));
+        logger.error(chalk.red('Failed to write files:\n') + errors.join('\n'));
     }
     if (warnings.length > 0) {
-        logWarning(chalk.yellow('Warnings encountered:') +
+        logger.warn(chalk.yellow('Warnings encountered:') +
             '\n' +
             warnings.map((warning) => `${chalk.yellow('-')} ${warning}`).join('\n'));
     }

package/dist/translation/parse.js

@@ -1,10 +1,11 @@
 import fs from 'fs';
-import { logError } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import loadJSON from '../fs/loadJSON.js';
 import { createDictionaryUpdates } from '../react/parse/createDictionaryUpdates.js';
 import { createInlineUpdates } from '../react/parse/createInlineUpdates.js';
 import createESBuildConfig from '../react/config/createESBuildConfig.js';
 import chalk from 'chalk';
+import { exitSync } from '../console/logging.js';
 /**
  * Searches for gt-react or gt-next dictionary files and creates updates for them,
  * as well as inline updates for <T> tags and useGT()/getGT() calls
@@ -33,8 +34,8 @@ export async function createUpdates(options, src, sourceDictionary, pkg, validat
             if (options.jsconfig) {
                 const jsconfig = loadJSON(options.jsconfig);
                 if (!jsconfig) {
-                    logError(`Failed to resolve jsconfig.json or tsconfig.json at provided filepath: "${options.jsconfig}"`);
-                    process.exit(1);
+                    logger.error(`Failed to resolve jsconfig.json or tsconfig.json at provided filepath: "${options.jsconfig}"`);
+                    exitSync(1);
                 }
                 esbuildConfig = createESBuildConfig(jsconfig);
             }

package/dist/translation/stage.js

@@ -1,7 +1,7 @@
 import { logErrorAndExit } from '../console/logging.js';
 import chalk from 'chalk';
 import findFilepath from '../fs/findFilepath.js';
-import { logWarning, logError } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import { createUpdates } from './parse.js';
 export async function aggregateReactTranslations(options, settings, library) {
     if (!options.dictionary) {
@@ -17,14 +17,14 @@ export async function aggregateReactTranslations(options, settings, library) {
     // ---- CREATING UPDATES ---- //
     const { updates, errors, warnings } = await createUpdates(options, settings.src, options.dictionary, library, false, settings.parsingOptions);
     if (warnings.length > 0) {
-        logWarning(chalk.yellow(`CLI tool encountered ${warnings.length} warnings while scanning for translatable content.\n` +
+        logger.warn(chalk.yellow(`CLI tool encountered ${warnings.length} warnings while scanning for translatable content.\n` +
             warnings
                 .map((warning) => chalk.yellow('• Warning: ') + chalk.white(warning))
                 .join('\n')));
     }
     if (errors.length > 0) {
         if (options.ignoreErrors) {
-            logWarning(chalk.yellow(`Warning: CLI tool encountered ${errors.length} syntax errors while scanning for translatable content. These components will not be translated.\n` +
+            logger.warn(chalk.yellow(`Warning: CLI tool encountered ${errors.length} syntax errors while scanning for translatable content. These components will not be translated.\n` +
                 errors
                     .map((error) => chalk.yellow('• ') + chalk.white(error) + '\n')
                     .join('')));
@@ -37,7 +37,7 @@ export async function aggregateReactTranslations(options, settings, library) {
         }
     }
     if (updates.length == 0) {
-        logError(chalk.red(`No in-line content or dictionaries were found for ${chalk.green(library)}. Are you sure you're running this command in the right directory?`));
+        logger.error(chalk.red(`No in-line content or dictionaries were found for ${chalk.green(library)}. Are you sure you're running this command in the right directory?`));
         return updates;
     }
     return updates;

package/dist/translation/validate.js

@@ -1,7 +1,7 @@
-import { logErrorAndExit, logWarning } from '../console/logging.js';
+import { logErrorAndExit } from '../console/logging.js';
 import chalk from 'chalk';
 import findFilepath from '../fs/findFilepath.js';
-import { logError, logSuccess } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import { createUpdates } from './parse.js';
 import { createInlineUpdates } from '../react/parse/createInlineUpdates.js';
 export async function validateProject(settings, pkg, files) {
@@ -14,7 +14,7 @@ export async function validateProject(settings, pkg, files) {
                     .map((error) => chalk.red('• ') + chalk.white(error) + '\n')
                     .join('')));
         }
-        logSuccess(chalk.green(`Success! Found ${updates.length} translatable entries.`));
+        logger.success(chalk.green(`Success! Found ${updates.length} translatable entries.`));
         return;
     }
     if (!settings.dictionary) {
@@ -29,7 +29,7 @@ export async function validateProject(settings, pkg, files) {
     }
     const { updates, errors, warnings } = await createUpdates(settings, settings.src, settings.dictionary, pkg, true, settings.parsingOptions);
     if (warnings.length > 0) {
-        logWarning(chalk.yellow(`CLI tool encountered ${warnings.length} warnings while scanning for translatable content.`) +
+        logger.warn(chalk.yellow(`CLI tool encountered ${warnings.length} warnings while scanning for translatable content.`) +
             '\n' +
             warnings
                 .map((warning) => chalk.yellow('• ') + chalk.white(warning))
@@ -42,9 +42,9 @@ export async function validateProject(settings, pkg, files) {
                 .join('')));
     }
     if (updates.length === 0) {
-        logError(chalk.red(`No in-line content or dictionaries were found for ${chalk.green(pkg)}. Are you sure you're running this command in the right directory?`));
+        logger.error(chalk.red(`No in-line content or dictionaries were found for ${chalk.green(pkg)}. Are you sure you're running this command in the right directory?`));
     }
     else {
-        logSuccess(chalk.green(`Success! Found ${updates.length} translatable entries for ${chalk.green(pkg)}.`));
+        logger.success(chalk.green(`Success! Found ${updates.length} translatable entries for ${chalk.green(pkg)}.`));
     }
 }

package/dist/types/index.d.ts

@@ -41,6 +41,7 @@ export type TranslateFlags = {
     dryRun: boolean;
     saveLocal?: boolean;
     stageTranslations?: boolean;
+    setupProject?: boolean;
     publish?: boolean;
     force?: boolean;
     forceDownload?: boolean;

package/dist/utils/addExplicitAnchorIds.js

@@ -4,7 +4,7 @@ import remarkMdx from 'remark-mdx';
 import remarkFrontmatter from 'remark-frontmatter';
 import remarkStringify from 'remark-stringify';
 import { visit } from 'unist-util-visit';
-import { logWarning } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import escapeHtmlInTextNodes from 'gt-remark';
 /**
  * Generates a slug from heading text
@@ -90,7 +90,7 @@ export function addExplicitAnchorIds(translatedContent, sourceHeadingMap, settin
         const translatedFile = translatedPath
             ? `translated file: ${translatedPath}`
             : 'translated file';
-        logWarning(`Header count mismatch detected! ${sourceFile} has ${sourceHeadingMap.length} headers but ${translatedFile} has ${translatedHeadings.length} headers. ` +
+        logger.warn(`Header count mismatch detected! ${sourceFile} has ${sourceHeadingMap.length} headers but ${translatedFile} has ${translatedHeadings.length} headers. ` +
             `This likely means your source file was edited after translation was requested, causing a mismatch between ` +
             `the number of headers in your source file vs the translated file. Please re-translate this file to resolve the issue.`);
     }

package/dist/utils/constants.d.ts

@@ -1,2 +1,4 @@
 export declare const GT_DASHBOARD_URL = "https://dash.generaltranslation.com";
 export declare const GT_CONFIG_SCHEMA_URL = "https://assets.gtx.dev/config-schema.json";
+export declare const TEMPLATE_FILE_NAME = "__INTERNAL_GT_TEMPLATE_NAME__";
+export declare const TEMPLATE_FILE_ID: string;

package/dist/utils/constants.js

@@ -1,2 +1,5 @@
+import { hashStringSync } from './hash.js';
 export const GT_DASHBOARD_URL = 'https://dash.generaltranslation.com';
 export const GT_CONFIG_SCHEMA_URL = 'https://assets.gtx.dev/config-schema.json';
+export const TEMPLATE_FILE_NAME = '__INTERNAL_GT_TEMPLATE_NAME__';
+export const TEMPLATE_FILE_ID = hashStringSync(TEMPLATE_FILE_NAME);

package/dist/utils/credentials.js

@@ -1,4 +1,5 @@
-import { createSpinner, logErrorAndExit, logMessage, } from '../console/logging.js';
+import { logErrorAndExit } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import path from 'node:path';
 import fs from 'node:fs';
 import chalk from 'chalk';
@@ -10,8 +11,8 @@ export async function retrieveCredentials(settings, keyType) {
     await import('open').then((open) => open.default(urlToOpen, {
         wait: false,
     }));
-    logMessage(`${chalk.dim(`If the browser window didn't open automatically, please open the following link:`)}\n\n${chalk.cyan(urlToOpen)}`);
-    const spinner = createSpinner('dots');
+    logger.message(`${chalk.dim(`If the browser window didn't open automatically, please open the following link:`)}\n\n${chalk.cyan(urlToOpen)}`);
+    const spinner = logger.createSpinner('dots');
     spinner.start('Waiting for response from dashboard...');
     const credentials = await new Promise(async (resolve, reject) => {
         const interval = setInterval(async () => {

package/dist/utils/installPackage.js

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
 import { spawn } from 'child_process';
-import { logError, logInfo } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 export async function installPackage(packageName, packageManager, asDevDependency, cwd = process.cwd()) {
     return new Promise((resolve, reject) => {
         const command = packageManager.name;
@@ -19,8 +19,8 @@ export async function installPackage(packageName, packageManager, asDevDependenc
             });
         }
         childProcess.on('error', (error) => {
-            logError(chalk.red(`Installation error: ${error.message}`));
-            logInfo(`Please manually install ${packageName} with: ${packageManager.name} ${packageManager.installCommand} ${packageName}`);
+            logger.error(chalk.red(`Installation error: ${error.message}`));
+            logger.info(`Please manually install ${packageName} with: ${packageManager.name} ${packageManager.installCommand} ${packageName}`);
             reject(error);
         });
         childProcess.on('close', (code) => {
@@ -28,11 +28,11 @@ export async function installPackage(packageName, packageManager, asDevDependenc
                 resolve();
             }
             else {
-                logError(chalk.red(`Installation failed with exit code ${code}`));
+                logger.error(chalk.red(`Installation failed with exit code ${code}`));
                 if (errorOutput) {
-                    logError(chalk.red(`Error details: ${errorOutput}`));
+                    logger.error(chalk.red(`Error details: ${errorOutput}`));
                 }
-                logInfo(`Please manually install ${packageName} with: ${packageManager.name} ${packageManager.installCommand} ${packageName}`);
+                logger.info(`Please manually install ${packageName} with: ${packageManager.name} ${packageManager.installCommand} ${packageName}`);
                 reject(new Error(`Process exited with code ${code}`));
             }
         });
@@ -56,8 +56,8 @@ export async function installPackageGlobal(packageName, version) {
             });
         }
         childProcess.on('error', (error) => {
-            logError(chalk.red(`Installation error: ${error.message}`));
-            logInfo(`Please manually install ${packageName} with: npm install -g ${packageName}`);
+            logger.error(chalk.red(`Installation error: ${error.message}`));
+            logger.info(`Please manually install ${packageName} with: npm install -g ${packageName}`);
             reject(error);
         });
         childProcess.on('close', (code) => {
@@ -65,11 +65,11 @@ export async function installPackageGlobal(packageName, version) {
                 resolve();
             }
             else {
-                logError(chalk.red(`Installation failed with exit code ${code}`));
+                logger.error(chalk.red(`Installation failed with exit code ${code}`));
                 if (errorOutput) {
-                    logError(chalk.red(`Error details: ${errorOutput}`));
+                    logger.error(chalk.red(`Error details: ${errorOutput}`));
                 }
-                logInfo(`Please manually install ${packageName} with: npm install -g ${packageName}`);
+                logger.info(`Please manually install ${packageName} with: npm install -g ${packageName}`);
                 reject(new Error(`Process exited with code ${code}`));
             }
         });

package/dist/utils/packageJson.js

@@ -1,8 +1,9 @@
-import { logError } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import chalk from 'chalk';
 import path from 'node:path';
 import fs from 'node:fs';
 import { fromPackageRoot } from '../fs/getPackageResource.js';
+import { exitSync } from '../console/logging.js';
 // search for package.json such that we can run init in non-js projects
 export async function searchForPackageJson(cwd = process.cwd()) {
     // Get the current working directory (where the CLI is being run)
@@ -48,8 +49,8 @@ export async function updatePackageJson(packageJson, cwd = process.cwd()) {
         await fs.promises.writeFile(path.join(cwd, 'package.json'), JSON.stringify(packageJson, null, 2));
     }
     catch (error) {
-        logError(chalk.red('Error updating package.json: ' + String(error)));
-        process.exit(1);
+        logger.error(chalk.red('Error updating package.json: ' + String(error)));
+        exitSync(1);
     }
 }
 // check if a package is installed in the package.json file

package/dist/workflow/BranchStep.js

@@ -1,11 +1,12 @@
 import { WorkflowStep } from './Workflow.js';
-import { createSpinner, logError, logErrorAndExit, } from '../console/logging.js';
+import { logErrorAndExit } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import chalk from 'chalk';
 import { getCurrentBranch, getIncomingBranches, getCheckedOutBranches, } from '../git/branches.js';
 import { ApiError } from 'generaltranslation/errors';
 // Step 1: Resolve the current branch id & update API with branch information
 export class BranchStep extends WorkflowStep {
-    spinner = createSpinner('dots');
+    spinner = logger.createSpinner('dots');
     branchData;
     settings;
     gt;
@@ -70,7 +71,7 @@ export class BranchStep extends WorkflowStep {
         }
         else {
             if (!current) {
-                logErrorAndExit('Failed to determine the current branch. Please specify a custom branch or enable automatic branch detection.');
+                return logErrorAndExit('Failed to determine the current branch. Please specify a custom branch or enable automatic branch detection.');
             }
             const currentBranch = branchData.branches.find((b) => b.name === current.currentBranchName);
             if (!currentBranch) {
@@ -83,7 +84,7 @@ export class BranchStep extends WorkflowStep {
                 }
                 catch (error) {
                     if (error instanceof ApiError && error.code === 403) {
-                        logError('Failed to create branch. To enable branching, please upgrade your plan.');
+                        logger.error('Failed to create branch. To enable branching, please upgrade your plan.');
                         // retry with default branch
                         const createBranchResult = await this.gt.createBranch({
                             branchName: 'main', // name doesn't matter for default branch

package/dist/workflow/DownloadStep.js

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
 import { WorkflowStep } from './Workflow.js';
-import { createProgressBar, logError, logWarning } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import { downloadFileBatch, } from '../api/downloadFileBatch.js';
 export class DownloadTranslationsStep extends WorkflowStep {
     gt;
@@ -12,7 +12,7 @@ export class DownloadTranslationsStep extends WorkflowStep {
         this.settings = settings;
     }
     async run({ fileTracker, resolveOutputPath, forceDownload, }) {
-        this.spinner = createProgressBar(fileTracker.completed.size);
+        this.spinner = logger.createProgressBar(fileTracker.completed.size);
         this.spinner.start('Downloading files...');
         // Download ready files
         const success = await this.downloadFiles(fileTracker, resolveOutputPath, forceDownload);
@@ -73,7 +73,7 @@ export class DownloadTranslationsStep extends WorkflowStep {
                 const batchResult = await this.downloadFilesWithRetry(fileTracker, batchFiles, forceDownload);
                 this.spinner?.stop(chalk.green(`Downloaded ${batchResult.successful.length} files${batchResult.skipped.length > 0 ? `, skipped ${batchResult.skipped.length} files` : ''}`));
                 if (batchResult.failed.length > 0) {
-                    logWarning(`Failed to download ${batchResult.failed.length} files: ${batchResult.failed.map((f) => f.inputPath).join('\n')}`);
+                    logger.warn(`Failed to download ${batchResult.failed.length} files: ${batchResult.failed.map((f) => f.inputPath).join('\n')}`);
                 }
             }
             else {
@@ -83,7 +83,7 @@ export class DownloadTranslationsStep extends WorkflowStep {
         }
         catch (error) {
             this.spinner?.stop(chalk.red('An error occurred while downloading translations'));
-            logError(chalk.red('Error: ') + error);
+            logger.error(chalk.red('Error: ') + error);
             return false;
         }
     }
@@ -109,7 +109,7 @@ export class DownloadTranslationsStep extends WorkflowStep {
             }
             // Calculate exponential backoff delay
             const delay = initialDelay * Math.pow(2, retryCount);
-            logError(chalk.yellow(`Retrying ${batchResult.failed.length} failed file(s) in ${delay}ms (attempt ${retryCount + 1}/${maxRetries})...`));
+            logger.error(chalk.yellow(`Retrying ${batchResult.failed.length} failed file(s) in ${delay}ms (attempt ${retryCount + 1}/${maxRetries})...`));
             // Wait before retrying
             await new Promise((resolve) => setTimeout(resolve, delay));
             remainingFiles = batchResult.failed;

package/dist/workflow/EnqueueStep.js

@@ -1,11 +1,11 @@
 import { WorkflowStep } from './Workflow.js';
-import { createSpinner } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import chalk from 'chalk';
 export class EnqueueStep extends WorkflowStep {
     gt;
     settings;
     force;
-    spinner = createSpinner('dots');
+    spinner = logger.createSpinner('dots');
     result = null;
     constructor(gt, settings, force) {
         super();

package/dist/workflow/PollJobsStep.js

@@ -1,7 +1,7 @@
 import chalk from 'chalk';
 import { WorkflowStep } from './Workflow.js';
-import { createProgressBar, logError } from '../console/logging.js';
-import { TEMPLATE_FILE_NAME } from '../cli/commands/stage.js';
+import { logger } from '../console/logger.js';
+import { TEMPLATE_FILE_NAME } from '../utils/constants.js';
 export class PollTranslationJobsStep extends WorkflowStep {
     gt;
     spinner = null;
@@ -12,7 +12,7 @@ export class PollTranslationJobsStep extends WorkflowStep {
     }
     async run({ fileTracker, fileQueryData, jobData, timeoutDuration, forceRetranslation, }) {
         const startTime = Date.now();
-        this.spinner = createProgressBar(fileQueryData.length);
+        this.spinner = logger.createProgressBar(fileQueryData.length);
         const spinnerMessage = forceRetranslation
             ? 'Waiting for retranslation...'
             : 'Waiting for translation...';
@@ -144,7 +144,7 @@ export class PollTranslationJobsStep extends WorkflowStep {
                         }
                     }
                     catch (error) {
-                        logError(chalk.red('Error checking job status: ') + error);
+                        logger.error(chalk.red('Error checking job status: ') + error);
                     }
                 }, 5000);
             }, msUntilNextInterval);

package/dist/workflow/SetupStep.d.ts

@@ -11,6 +11,6 @@ export declare class SetupStep extends WorkflowStep<FileReference[], FileReferen
     private files;
     private completed;
     constructor(gt: GT, settings: Settings, timeoutMs: number);
-    run(files: FileReference[]): Promise<FileReference[]>;
+    run(files: FileReference[], force?: boolean): Promise<FileReference[]>;
     wait(): Promise<void>;
 }

package/dist/workflow/SetupStep.js

@@ -1,11 +1,11 @@
 import { WorkflowStep } from './Workflow.js';
-import { createSpinner } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import chalk from 'chalk';
 export class SetupStep extends WorkflowStep {
     gt;
     settings;
     timeoutMs;
-    spinner = createSpinner('dots');
+    spinner = logger.createSpinner('dots');
     setupJobId = null;
     files = null;
     completed = false;
@@ -15,7 +15,7 @@ export class SetupStep extends WorkflowStep {
         this.settings = settings;
         this.timeoutMs = timeoutMs;
     }
-    async run(files) {
+    async run(files, force = false) {
         this.files = files;
         this.spinner.start('Setting up project...');
         if (files.length === 0) {
@@ -24,6 +24,7 @@ export class SetupStep extends WorkflowStep {
         }
         const result = await this.gt.setupProject(files, {
             locales: this.settings.locales,
+            force,
         });
         if (result.status === 'completed') {
             this.completed = true;

package/dist/workflow/UploadStep.js

@@ -1,10 +1,10 @@
 import { WorkflowStep } from './Workflow.js';
-import { createSpinner, logInfo } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import chalk from 'chalk';
 export class UploadStep extends WorkflowStep {
     gt;
     settings;
-    spinner = createSpinner('dots');
+    spinner = logger.createSpinner('dots');
     result = null;
     constructor(gt, settings) {
         super();
@@ -13,7 +13,7 @@ export class UploadStep extends WorkflowStep {
     }
     async run({ files, branchData, }) {
         if (files.length === 0) {
-            logInfo('No files to upload found... skipping upload step');
+            logger.info('No files to upload found... skipping upload step');
             return [];
         }
         this.spinner.start(`Syncing ${files.length} file${files.length !== 1 ? 's' : ''} with General Translation API...`);

package/dist/workflow/UserEditDiffsStep.js

@@ -1,10 +1,10 @@
 import { WorkflowStep } from './Workflow.js';
-import { createSpinner } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import chalk from 'chalk';
 import { collectAndSendUserEditDiffs } from '../api/collectUserEditDiffs.js';
 export class UserEditDiffsStep extends WorkflowStep {
     settings;
-    spinner = createSpinner('dots');
+    spinner = logger.createSpinner('dots');
     completed = false;
     constructor(settings) {
         super();

package/dist/workflow/download.js

@@ -3,7 +3,8 @@ import { gt } from '../utils/gt.js';
 import { clearLocaleDirs } from '../fs/clearLocaleDirs.js';
 import { PollTranslationJobsStep } from './PollJobsStep.js';
 import { DownloadTranslationsStep } from './DownloadStep.js';
-import { logError, logErrorAndExit } from '../console/logging.js';
+import { logErrorAndExit } from '../console/logging.js';
+import { logger } from '../console/logger.js';
 import { BranchStep } from './BranchStep.js';
 import chalk from 'chalk';
 /**
@@ -25,7 +26,7 @@ export async function downloadTranslations(fileVersionData, jobData, branchData,
         const branchResult = await branchStep.run();
         await branchStep.wait();
         if (!branchResult) {
-            logErrorAndExit('Failed to resolve git branch information.');
+            return logErrorAndExit('Failed to resolve git branch information.');
         }
         branchData = branchResult;
     }
@@ -66,7 +67,7 @@ export async function downloadTranslations(fileVersionData, jobData, branchData,
         });
         await pollStep.wait();
         if (pollResult.fileTracker.failed.size > 0) {
-            logError(`${chalk.red(`${pollResult.fileTracker.failed.size} file(s) failed to translate:`)}\n${Array.from(pollResult.fileTracker.failed.entries())
+            logger.error(`${chalk.red(`${pollResult.fileTracker.failed.size} file(s) failed to translate:`)}\n${Array.from(pollResult.fileTracker.failed.entries())
                 .map(([key, value]) => `- ${value.fileName}`)
                 .join('\n')}`);
             return false;

package/dist/workflow/setupProject.d.ts

@@ -0,0 +1,13 @@
+import { Settings, TranslateFlags } from '../types/index.js';
+import { FileToUpload } from 'generaltranslation/types';
+import { BranchData } from '../types/branch.js';
+/**
+ * Sets up a project by uploading files running the setup step
+ * @param files - Array of file objects to upload
+ * @param options - The options for the API call
+ * @param settings - Settings configuration
+ * @returns The branch data
+ */
+export declare function setupProject(files: FileToUpload[], options: TranslateFlags, settings: Settings): Promise<{
+    branchData: BranchData;
+}>;

package/dist/workflow/setupProject.js

@@ -0,0 +1,48 @@
+import { logErrorAndExit } from '../console/logging.js';
+import { gt } from '../utils/gt.js';
+import { UploadStep } from './UploadStep.js';
+import { SetupStep } from './SetupStep.js';
+import { BranchStep } from './BranchStep.js';
+import { logCollectedFiles } from '../console/logging.js';
+/**
+ * Helper: Calculate timeout with validation
+ */
+function calculateTimeout(timeout) {
+    const value = timeout !== undefined ? Number(timeout) : 600;
+    return (Number.isFinite(value) ? value : 600) * 1000;
+}
+/**
+ * Sets up a project by uploading files running the setup step
+ * @param files - Array of file objects to upload
+ * @param options - The options for the API call
+ * @param settings - Settings configuration
+ * @returns The branch data
+ */
+export async function setupProject(files, options, settings) {
+    try {
+        // Log files to be translated
+        logCollectedFiles(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 setupStep = new SetupStep(gt, settings, timeoutMs);
+        // first run the branch step
+        const branchData = await branchStep.run();
+        await branchStep.wait();
+        if (!branchData) {
+            return logErrorAndExit('Failed to resolve git branch information.');
+        }
+        // then run the upload step
+        const uploadedFiles = await uploadStep.run({ files, branchData });
+        await uploadStep.wait();
+        // then run the setup step
+        await setupStep.run(uploadedFiles, options.force ?? false);
+        await setupStep.wait();
+        return { branchData };
+    }
+    catch (error) {
+        return logErrorAndExit('Failed to run project setup. ' + error);
+    }
+}