gt 2.14.35 → 2.14.36

package/dist/utils/validateMdx.js

@@ -1,25 +1,28 @@
-import { unified } from 'unified';
-import remarkParse from 'remark-parse';
-import remarkMdx from 'remark-mdx';
-import remarkFrontmatter from 'remark-frontmatter';
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkMdx from "remark-mdx";
+import remarkFrontmatter from "remark-frontmatter";
+//#region src/utils/validateMdx.ts
 /**
- * Validates if an MDX file content can be parsed as a valid AST
- * @param content - The MDX file content to validate
- * @param filePath - The file path for error reporting
- * @returns object with isValid boolean and optional error message
- */
-export function isValidMdx(content, _filePath) {
-    try {
-        const parseProcessor = unified()
-            .use(remarkParse)
-            .use(remarkFrontmatter, ['yaml', 'toml'])
-            .use(remarkMdx);
-        const ast = parseProcessor.parse(content);
-        parseProcessor.runSync(ast);
-        return { isValid: true };
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        return { isValid: false, error: errorMessage };
-    }
+* Validates if an MDX file content can be parsed as a valid AST
+* @param content - The MDX file content to validate
+* @param filePath - The file path for error reporting
+* @returns object with isValid boolean and optional error message
+*/
+function isValidMdx(content, _filePath) {
+	try {
+		const parseProcessor = unified().use(remarkParse).use(remarkFrontmatter, ["yaml", "toml"]).use(remarkMdx);
+		const ast = parseProcessor.parse(content);
+		parseProcessor.runSync(ast);
+		return { isValid: true };
+	} catch (error) {
+		return {
+			isValid: false,
+			error: error instanceof Error ? error.message : String(error)
+		};
+	}
 }
+//#endregion
+export { isValidMdx };
+
+//# sourceMappingURL=validateMdx.js.map

package/dist/utils/validateMdx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateMdx.js","names":[],"sources":["../../src/utils/validateMdx.ts"],"sourcesContent":["import { unified } from 'unified';\nimport remarkParse from 'remark-parse';\nimport remarkMdx from 'remark-mdx';\nimport remarkFrontmatter from 'remark-frontmatter';\n\n/**\n * Validates if an MDX file content can be parsed as a valid AST\n * @param content - The MDX file content to validate\n * @param filePath - The file path for error reporting\n * @returns object with isValid boolean and optional error message\n */\nexport function isValidMdx(\n  content: string,\n  _filePath: string\n): {\n  isValid: boolean;\n  error?: string;\n} {\n  try {\n    const parseProcessor = unified()\n      .use(remarkParse)\n      .use(remarkFrontmatter, ['yaml', 'toml'])\n      .use(remarkMdx);\n\n    const ast = parseProcessor.parse(content);\n    parseProcessor.runSync(ast);\n    return { isValid: true };\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    return { isValid: false, error: errorMessage };\n  }\n}\n"],"mappings":";;;;;;;;;;;AAWA,SAAgB,WACd,SACA,WAIA;AACA,KAAI;EACF,MAAM,iBAAiB,SAAS,CAC7B,IAAI,YAAY,CAChB,IAAI,mBAAmB,CAAC,QAAQ,OAAO,CAAC,CACxC,IAAI,UAAU;EAEjB,MAAM,MAAM,eAAe,MAAM,QAAQ;AACzC,iBAAe,QAAQ,IAAI;AAC3B,SAAO,EAAE,SAAS,MAAM;UACjB,OAAO;AAEd,SAAO;GAAE,SAAS;GAAO,OADJ,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC7B"}

package/dist/utils/wrapPlainUrls.js

@@ -1,72 +1,60 @@
-import { unified } from 'unified';
-import remarkParse from 'remark-parse';
-import remarkMdx from 'remark-mdx';
-import remarkFrontmatter from 'remark-frontmatter';
-import { visit } from 'unist-util-visit';
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkMdx from "remark-mdx";
+import remarkFrontmatter from "remark-frontmatter";
+import { visit } from "unist-util-visit";
+//#region src/utils/wrapPlainUrls.ts
 /**
- * Wraps plain URLs in markdown link syntax [url](url) so that
- * translation pipelines preserve the URL separately from surrounding text.
- *
- * Uses remark AST parsing to identify URLs that appear in text nodes only.
- *
- */
-export default function wrapPlainUrls(content) {
-    const URL_REGEX = /https?:\/\/[^\s<>\u005b\u005d]*[^\s<>\u005b\u005d.,;:!?'"\u005d}>]/g;
-    let ast;
-    try {
-        const processor = unified()
-            .use(remarkParse)
-            .use(remarkFrontmatter, ['yaml', 'toml'])
-            .use(remarkMdx);
-        ast = processor.parse(content);
-        ast = processor.runSync(ast);
-    }
-    catch {
-        // If parsing fails, return content unchanged
-        return content;
-    }
-    // Collect all URL replacements from text nodes with their positions
-    const replacements = [];
-    visit(ast, 'text', (node, _index, parent) => {
-        // Skip text nodes inside links — those are already display text for a link
-        if (parent && parent.type === 'link')
-            return;
-        const pos = node.position;
-        if (!pos)
-            return;
-        const value = node.value;
-        let match;
-        while ((match = URL_REGEX.exec(value)) !== null) {
-            let url = match[0];
-            const nodeStartOffset = pos.start.offset;
-            if (nodeStartOffset === undefined)
-                continue;
-            // Trim unbalanced trailing ')' so that prose like "(see https://example.com)"
-            // doesn't absorb the surrounding paren, while Wikipedia-style URLs with
-            // balanced parens (e.g. /wiki/Unix_(operating_system)) are kept intact.
-            while (url.endsWith(')')) {
-                const open = url.split('(').length - 1;
-                const close = url.split(')').length - 1;
-                if (close > open) {
-                    url = url.slice(0, -1);
-                }
-                else {
-                    break;
-                }
-            }
-            // Calculate the absolute offset in the original content
-            const urlStart = nodeStartOffset + match.index;
-            const urlEnd = urlStart + url.length;
-            replacements.push({ start: urlStart, end: urlEnd, url });
-        }
-    });
-    if (replacements.length === 0)
-        return content;
-    // Apply replacements in reverse order to preserve positions
-    let result = content;
-    for (let i = replacements.length - 1; i >= 0; i--) {
-        const { start, end, url } = replacements[i];
-        result = result.slice(0, start) + `[${url}](${url})` + result.slice(end);
-    }
-    return result;
+* Wraps plain URLs in markdown link syntax [url](url) so that
+* translation pipelines preserve the URL separately from surrounding text.
+*
+* Uses remark AST parsing to identify URLs that appear in text nodes only.
+*
+*/
+function wrapPlainUrls(content) {
+	const URL_REGEX = /https?:\/\/[^\s<>\u005b\u005d]*[^\s<>\u005b\u005d.,;:!?'"\u005d}>]/g;
+	let ast;
+	try {
+		const processor = unified().use(remarkParse).use(remarkFrontmatter, ["yaml", "toml"]).use(remarkMdx);
+		ast = processor.parse(content);
+		ast = processor.runSync(ast);
+	} catch {
+		return content;
+	}
+	const replacements = [];
+	visit(ast, "text", (node, _index, parent) => {
+		if (parent && parent.type === "link") return;
+		const pos = node.position;
+		if (!pos) return;
+		const value = node.value;
+		let match;
+		while ((match = URL_REGEX.exec(value)) !== null) {
+			let url = match[0];
+			const nodeStartOffset = pos.start.offset;
+			if (nodeStartOffset === void 0) continue;
+			while (url.endsWith(")")) {
+				const open = url.split("(").length - 1;
+				if (url.split(")").length - 1 > open) url = url.slice(0, -1);
+				else break;
+			}
+			const urlStart = nodeStartOffset + match.index;
+			const urlEnd = urlStart + url.length;
+			replacements.push({
+				start: urlStart,
+				end: urlEnd,
+				url
+			});
+		}
+	});
+	if (replacements.length === 0) return content;
+	let result = content;
+	for (let i = replacements.length - 1; i >= 0; i--) {
+		const { start, end, url } = replacements[i];
+		result = result.slice(0, start) + `[${url}](${url})` + result.slice(end);
+	}
+	return result;
 }
+//#endregion
+export { wrapPlainUrls as default };
+
+//# sourceMappingURL=wrapPlainUrls.js.map

package/dist/utils/wrapPlainUrls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapPlainUrls.js","names":[],"sources":["../../src/utils/wrapPlainUrls.ts"],"sourcesContent":["import { unified } from 'unified';\nimport remarkParse from 'remark-parse';\nimport remarkMdx from 'remark-mdx';\nimport remarkFrontmatter from 'remark-frontmatter';\nimport { visit } from 'unist-util-visit';\nimport type { Root, Text } from 'mdast';\n\n/**\n * Wraps plain URLs in markdown link syntax [url](url) so that\n * translation pipelines preserve the URL separately from surrounding text.\n *\n * Uses remark AST parsing to identify URLs that appear in text nodes only.\n *\n */\nexport default function wrapPlainUrls(content: string): string {\n  const URL_REGEX =\n    /https?:\\/\\/[^\\s<>\\u005b\\u005d]*[^\\s<>\\u005b\\u005d.,;:!?'\"\\u005d}>]/g;\n  let ast: Root;\n  try {\n    const processor = unified()\n      .use(remarkParse)\n      .use(remarkFrontmatter, ['yaml', 'toml'])\n      .use(remarkMdx);\n\n    ast = processor.parse(content);\n    ast = processor.runSync(ast) as Root;\n  } catch {\n    // If parsing fails, return content unchanged\n    return content;\n  }\n\n  // Collect all URL replacements from text nodes with their positions\n  const replacements: { start: number; end: number; url: string }[] = [];\n\n  visit(ast, 'text', (node: Text, _index, parent) => {\n    // Skip text nodes inside links — those are already display text for a link\n    if (parent && parent.type === 'link') return;\n\n    const pos = node.position;\n    if (!pos) return;\n\n    const value = node.value;\n    let match: RegExpExecArray | null;\n\n    while ((match = URL_REGEX.exec(value)) !== null) {\n      let url = match[0];\n      const nodeStartOffset = pos.start.offset;\n      if (nodeStartOffset === undefined) continue;\n\n      // Trim unbalanced trailing ')' so that prose like \"(see https://example.com)\"\n      // doesn't absorb the surrounding paren, while Wikipedia-style URLs with\n      // balanced parens (e.g. /wiki/Unix_(operating_system)) are kept intact.\n      while (url.endsWith(')')) {\n        const open = url.split('(').length - 1;\n        const close = url.split(')').length - 1;\n        if (close > open) {\n          url = url.slice(0, -1);\n        } else {\n          break;\n        }\n      }\n\n      // Calculate the absolute offset in the original content\n      const urlStart = nodeStartOffset + match.index;\n      const urlEnd = urlStart + url.length;\n\n      replacements.push({ start: urlStart, end: urlEnd, url });\n    }\n  });\n\n  if (replacements.length === 0) return content;\n\n  // Apply replacements in reverse order to preserve positions\n  let result = content;\n  for (let i = replacements.length - 1; i >= 0; i--) {\n    const { start, end, url } = replacements[i];\n    result = result.slice(0, start) + `[${url}](${url})` + result.slice(end);\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,SAAwB,cAAc,SAAyB;CAC7D,MAAM,YACJ;CACF,IAAI;AACJ,KAAI;EACF,MAAM,YAAY,SAAS,CACxB,IAAI,YAAY,CAChB,IAAI,mBAAmB,CAAC,QAAQ,OAAO,CAAC,CACxC,IAAI,UAAU;AAEjB,QAAM,UAAU,MAAM,QAAQ;AAC9B,QAAM,UAAU,QAAQ,IAAI;SACtB;AAEN,SAAO;;CAIT,MAAM,eAA8D,EAAE;AAEtE,OAAM,KAAK,SAAS,MAAY,QAAQ,WAAW;AAEjD,MAAI,UAAU,OAAO,SAAS,OAAQ;EAEtC,MAAM,MAAM,KAAK;AACjB,MAAI,CAAC,IAAK;EAEV,MAAM,QAAQ,KAAK;EACnB,IAAI;AAEJ,UAAQ,QAAQ,UAAU,KAAK,MAAM,MAAM,MAAM;GAC/C,IAAI,MAAM,MAAM;GAChB,MAAM,kBAAkB,IAAI,MAAM;AAClC,OAAI,oBAAoB,KAAA,EAAW;AAKnC,UAAO,IAAI,SAAS,IAAI,EAAE;IACxB,MAAM,OAAO,IAAI,MAAM,IAAI,CAAC,SAAS;AAErC,QADc,IAAI,MAAM,IAAI,CAAC,SAAS,IAC1B,KACV,OAAM,IAAI,MAAM,GAAG,GAAG;QAEtB;;GAKJ,MAAM,WAAW,kBAAkB,MAAM;GACzC,MAAM,SAAS,WAAW,IAAI;AAE9B,gBAAa,KAAK;IAAE,OAAO;IAAU,KAAK;IAAQ;IAAK,CAAC;;GAE1D;AAEF,KAAI,aAAa,WAAW,EAAG,QAAO;CAGtC,IAAI,SAAS;AACb,MAAK,IAAI,IAAI,aAAa,SAAS,GAAG,KAAK,GAAG,KAAK;EACjD,MAAM,EAAE,OAAO,KAAK,QAAQ,aAAa;AACzC,WAAS,OAAO,MAAM,GAAG,MAAM,GAAG,IAAI,IAAI,IAAI,IAAI,KAAK,OAAO,MAAM,IAAI;;AAG1E,QAAO"}

package/dist/workflows/download.js

@@ -1,131 +1,97 @@
-import path from 'node:path';
-import { gt } from '../utils/gt.js';
-import { clearLocaleDirs } from '../fs/clearLocaleDirs.js';
-import { PollTranslationJobsStep, } from './steps/PollJobsStep.js';
-import { DownloadTranslationsStep } from './steps/DownloadStep.js';
-import { logErrorAndExit } from '../console/logging.js';
-import { logger } from '../console/logger.js';
-import { recordWarning } from '../state/translateWarnings.js';
-import { BranchStep } from './steps/BranchStep.js';
-import chalk from 'chalk';
+import { logger } from "../console/logger.js";
+import { gt } from "../utils/gt.js";
+import { logErrorAndExit } from "../console/logging.js";
+import { branchResolutionError } from "../console/index.js";
+import { BranchStep } from "./steps/BranchStep.js";
+import { recordWarning } from "../state/translateWarnings.js";
+import { clearLocaleDirs } from "../fs/clearLocaleDirs.js";
+import { PollTranslationJobsStep } from "./steps/PollJobsStep.js";
+import { DownloadTranslationsStep } from "./steps/DownloadStep.js";
+import chalk from "chalk";
+import path from "node:path";
+//#region src/workflows/download.ts
 /**
- * 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 runDownloadWorkflow({ 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) {
-            return 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
-    let pollTimedOut = false;
-    if (jobData) {
-        const pollStep = new PollTranslationJobsStep(gt);
-        const pollResult = await pollStep.run({
-            fileTracker,
-            fileQueryData,
-            jobData,
-            timeoutDuration,
-            forceRetranslation,
-        });
-        await pollStep.wait();
-        if (pollResult.fileTracker.failed.size > 0) {
-            logger.error(`${chalk.red(`${pollResult.fileTracker.failed.size} file(s) failed to translate:`)}\n${Array.from(pollResult.fileTracker.failed.entries())
-                .map(([, value]) => `- ${value.fileName}`)
-                .join('\n')}`);
-            for (const [, value] of pollResult.fileTracker.failed) {
-                recordWarning('failed_translation', value.fileName, `Failed to translate for locale ${value.locale}`);
-            }
-            // If all files failed translation, exit early
-            if (pollResult.fileTracker.completed.size === 0) {
-                return false;
-            }
-        }
-        // Even if polling timed out, still download whatever completed successfully
-        if (!pollResult.success) {
-            pollTimedOut = true;
-            if (pollResult.fileTracker.completed.size > 0) {
-                logger.warn(chalk.yellow(`Timed out, but ${pollResult.fileTracker.completed.size} translation(s) completed successfully. Downloading completed files...`));
-            }
-            else {
-                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();
-    // If polling timed out, report failure even though we downloaded what we could
-    if (pollTimedOut) {
-        return false;
-    }
-    return downloadResult;
+* 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
+*/
+async function runDownloadWorkflow({ fileVersionData, jobData, branchData, locales, timeoutDuration, resolveOutputPath, options, forceRetranslation, forceDownload }) {
+	if (!branchData) {
+		const branchStep = new BranchStep(gt, options);
+		const branchResult = await branchStep.run();
+		await branchStep.wait();
+		if (!branchResult) return logErrorAndExit(branchResolutionError);
+		branchData = branchResult;
+	}
+	const fileQueryData = prepareFileQueryData(fileVersionData, locales, branchData);
+	if (options.options?.experimentalClearLocaleDirs === true && fileQueryData.length > 0) {
+		const translatedFiles = new Set(fileQueryData.map((file) => {
+			const outputPath = resolveOutputPath(file.fileName, file.locale);
+			return outputPath !== null && outputPath !== file.fileName ? outputPath : null;
+		}).filter((path) => path !== null));
+		const cwd = path.dirname(options.config);
+		await clearLocaleDirs(translatedFiles, locales, options.options?.clearLocaleDirsExclude, cwd);
+	}
+	const fileTracker = {
+		completed: /* @__PURE__ */ new Map(),
+		inProgress: /* @__PURE__ */ new Map(),
+		failed: /* @__PURE__ */ new Map(),
+		skipped: /* @__PURE__ */ new Map()
+	};
+	let pollTimedOut = false;
+	if (jobData) {
+		const pollStep = new PollTranslationJobsStep(gt);
+		const pollResult = await pollStep.run({
+			fileTracker,
+			fileQueryData,
+			jobData,
+			timeoutDuration,
+			forceRetranslation
+		});
+		await pollStep.wait();
+		if (pollResult.fileTracker.failed.size > 0) {
+			logger.error(`${chalk.red(`${pollResult.fileTracker.failed.size} file(s) failed to translate:`)}\n${Array.from(pollResult.fileTracker.failed.entries()).map(([, value]) => `- ${value.fileName}`).join("\n")}`);
+			for (const [, value] of pollResult.fileTracker.failed) recordWarning("failed_translation", value.fileName, `Failed to translate for locale ${value.locale}`);
+			if (pollResult.fileTracker.completed.size === 0) return false;
+		}
+		if (!pollResult.success) {
+			pollTimedOut = true;
+			if (pollResult.fileTracker.completed.size > 0) logger.warn(chalk.yellow(`Timed out, but ${pollResult.fileTracker.completed.size} translation(s) completed successfully. Downloading completed files...`));
+			else return false;
+		}
+	} else for (const file of fileQueryData) fileTracker.completed.set(`${file.branchId}:${file.fileId}:${file.versionId}:${file.locale}`, file);
+	const downloadStep = new DownloadTranslationsStep(gt, options);
+	const downloadResult = await downloadStep.run({
+		fileTracker,
+		resolveOutputPath,
+		forceDownload
+	});
+	await downloadStep.wait();
+	if (pollTimedOut) return false;
+	return downloadResult;
 }
 /**
- * Prepares the file query data from input data and locales
- */
+* 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;
+	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;
 }
+//#endregion
+export { runDownloadWorkflow };
+
+//# sourceMappingURL=download.js.map

package/dist/workflows/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","names":[],"sources":["../../src/workflows/download.ts"],"sourcesContent":["import path from 'node:path';\nimport { Settings } from '../types/index.js';\nimport { gt } from '../utils/gt.js';\nimport { EnqueueFilesResult } from 'generaltranslation/types';\nimport { clearLocaleDirs } from '../fs/clearLocaleDirs.js';\nimport {\n  FileStatusTracker,\n  PollTranslationJobsStep,\n} from './steps/PollJobsStep.js';\nimport { DownloadTranslationsStep } from './steps/DownloadStep.js';\nimport { BranchData } from '../types/branch.js';\nimport { branchResolutionError } from '../console/index.js';\nimport { logErrorAndExit } from '../console/logging.js';\nimport { logger } from '../console/logger.js';\nimport { recordWarning } from '../state/translateWarnings.js';\nimport { BranchStep } from './steps/BranchStep.js';\nimport { FileProperties } from '../types/files.js';\nimport chalk from 'chalk';\n\nexport type FileTranslationData = {\n  [fileId: string]: {\n    versionId: string;\n    fileName: string;\n  };\n};\n\n/**\n * Checks the status of translations and downloads them using a workflow pattern\n * @param fileVersionData - Mapping of file IDs to their version and name information\n * @param jobData - Optional job data from enqueue operation\n * @param locales - The locales to wait for\n * @param timeoutDuration - The timeout duration for the wait in seconds\n * @param resolveOutputPath - Function to resolve the output path for a given source path and locale\n * @param options - Settings configuration\n * @param forceRetranslation - Whether to force retranslation\n * @param forceDownload - Whether to force download even if file exists\n * @returns True if all translations are downloaded successfully, false otherwise\n */\nexport async function runDownloadWorkflow({\n  fileVersionData,\n  jobData,\n  branchData,\n  locales,\n  timeoutDuration,\n  resolveOutputPath,\n  options,\n  forceRetranslation,\n  forceDownload,\n}: {\n  fileVersionData: FileTranslationData;\n  jobData: EnqueueFilesResult | undefined;\n  branchData: BranchData | undefined;\n  locales: string[];\n  timeoutDuration: number;\n  resolveOutputPath: (sourcePath: string, locale: string) => string | null;\n  options: Settings;\n  forceRetranslation?: boolean;\n  forceDownload?: boolean;\n}): Promise<boolean> {\n  if (!branchData) {\n    // Run the branch step\n    const branchStep = new BranchStep(gt, options);\n    const branchResult = await branchStep.run();\n    await branchStep.wait();\n    if (!branchResult) {\n      return logErrorAndExit(branchResolutionError);\n    }\n    branchData = branchResult;\n  }\n  // Prepare the query data\n  const fileQueryData = prepareFileQueryData(\n    fileVersionData,\n    locales,\n    branchData\n  );\n\n  // Clear translated files before any downloads (if enabled)\n  if (\n    options.options?.experimentalClearLocaleDirs === true &&\n    fileQueryData.length > 0\n  ) {\n    const translatedFiles = new Set(\n      fileQueryData\n        .map((file) => {\n          const outputPath = resolveOutputPath(file.fileName, file.locale);\n          // Only clear if the output path is different from the source (i.e., there's a transform)\n          return outputPath !== null && outputPath !== file.fileName\n            ? outputPath\n            : null;\n        })\n        .filter((path): path is string => path !== null)\n    );\n\n    // Derive cwd from config path\n    const cwd = path.dirname(options.config);\n\n    await clearLocaleDirs(\n      translatedFiles,\n      locales,\n      options.options?.clearLocaleDirsExclude,\n      cwd\n    );\n  }\n\n  // Initialize download status\n  const fileTracker: FileStatusTracker = {\n    completed: new Map<string, FileProperties>(),\n    inProgress: new Map<string, FileProperties>(),\n    failed: new Map<string, FileProperties>(),\n    skipped: new Map<string, FileProperties>(),\n  };\n\n  // Step 1: Poll translation jobs if jobData exists\n  let pollTimedOut = false;\n  if (jobData) {\n    const pollStep = new PollTranslationJobsStep(gt);\n    const pollResult = await pollStep.run({\n      fileTracker,\n      fileQueryData,\n      jobData,\n      timeoutDuration,\n      forceRetranslation,\n    });\n    await pollStep.wait();\n\n    if (pollResult.fileTracker.failed.size > 0) {\n      logger.error(\n        `${chalk.red(`${pollResult.fileTracker.failed.size} file(s) failed to translate:`)}\\n${Array.from(\n          pollResult.fileTracker.failed.entries()\n        )\n          .map(([, value]) => `- ${value.fileName}`)\n          .join('\\n')}`\n      );\n      for (const [, value] of pollResult.fileTracker.failed) {\n        recordWarning(\n          'failed_translation',\n          value.fileName,\n          `Failed to translate for locale ${value.locale}`\n        );\n      }\n\n      // If all files failed translation, exit early\n      if (pollResult.fileTracker.completed.size === 0) {\n        return false;\n      }\n    }\n\n    // Even if polling timed out, still download whatever completed successfully\n    if (!pollResult.success) {\n      pollTimedOut = true;\n      if (pollResult.fileTracker.completed.size > 0) {\n        logger.warn(\n          chalk.yellow(\n            `Timed out, but ${pollResult.fileTracker.completed.size} translation(s) completed successfully. Downloading completed files...`\n          )\n        );\n      } else {\n        return false;\n      }\n    }\n  } else {\n    for (const file of fileQueryData) {\n      // Staging - assume all files are completed\n      fileTracker.completed.set(\n        `${file.branchId}:${file.fileId}:${file.versionId}:${file.locale}`,\n        file\n      );\n    }\n  }\n\n  // Step 2: Download translations\n  const downloadStep = new DownloadTranslationsStep(gt, options);\n  const downloadResult = await downloadStep.run({\n    fileTracker,\n    resolveOutputPath,\n    forceDownload,\n  });\n  await downloadStep.wait();\n\n  // If polling timed out, report failure even though we downloaded what we could\n  if (pollTimedOut) {\n    return false;\n  }\n\n  return downloadResult;\n}\n\n/**\n * Prepares the file query data from input data and locales\n */\nfunction prepareFileQueryData(\n  fileVersionData: FileTranslationData,\n  locales: string[],\n  branchData: BranchData\n): FileProperties[] {\n  const fileQueryData: FileProperties[] = [];\n\n  for (const fileId in fileVersionData) {\n    for (const locale of locales) {\n      fileQueryData.push({\n        versionId: fileVersionData[fileId].versionId,\n        fileName: fileVersionData[fileId].fileName,\n        fileId,\n        locale,\n        branchId: branchData.currentBranch.id,\n      });\n    }\n  }\n\n  return fileQueryData;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAsCA,eAAsB,oBAAoB,EACxC,iBACA,SACA,YACA,SACA,iBACA,mBACA,SACA,oBACA,iBAWmB;AACnB,KAAI,CAAC,YAAY;EAEf,MAAM,aAAa,IAAI,WAAW,IAAI,QAAQ;EAC9C,MAAM,eAAe,MAAM,WAAW,KAAK;AAC3C,QAAM,WAAW,MAAM;AACvB,MAAI,CAAC,aACH,QAAO,gBAAgB,sBAAsB;AAE/C,eAAa;;CAGf,MAAM,gBAAgB,qBACpB,iBACA,SACA,WACD;AAGD,KACE,QAAQ,SAAS,gCAAgC,QACjD,cAAc,SAAS,GACvB;EACA,MAAM,kBAAkB,IAAI,IAC1B,cACG,KAAK,SAAS;GACb,MAAM,aAAa,kBAAkB,KAAK,UAAU,KAAK,OAAO;AAEhE,UAAO,eAAe,QAAQ,eAAe,KAAK,WAC9C,aACA;IACJ,CACD,QAAQ,SAAyB,SAAS,KAAK,CACnD;EAGD,MAAM,MAAM,KAAK,QAAQ,QAAQ,OAAO;AAExC,QAAM,gBACJ,iBACA,SACA,QAAQ,SAAS,wBACjB,IACD;;CAIH,MAAM,cAAiC;EACrC,2BAAW,IAAI,KAA6B;EAC5C,4BAAY,IAAI,KAA6B;EAC7C,wBAAQ,IAAI,KAA6B;EACzC,yBAAS,IAAI,KAA6B;EAC3C;CAGD,IAAI,eAAe;AACnB,KAAI,SAAS;EACX,MAAM,WAAW,IAAI,wBAAwB,GAAG;EAChD,MAAM,aAAa,MAAM,SAAS,IAAI;GACpC;GACA;GACA;GACA;GACA;GACD,CAAC;AACF,QAAM,SAAS,MAAM;AAErB,MAAI,WAAW,YAAY,OAAO,OAAO,GAAG;AAC1C,UAAO,MACL,GAAG,MAAM,IAAI,GAAG,WAAW,YAAY,OAAO,KAAK,+BAA+B,CAAC,IAAI,MAAM,KAC3F,WAAW,YAAY,OAAO,SAAS,CACxC,CACE,KAAK,GAAG,WAAW,KAAK,MAAM,WAAW,CACzC,KAAK,KAAK,GACd;AACD,QAAK,MAAM,GAAG,UAAU,WAAW,YAAY,OAC7C,eACE,sBACA,MAAM,UACN,kCAAkC,MAAM,SACzC;AAIH,OAAI,WAAW,YAAY,UAAU,SAAS,EAC5C,QAAO;;AAKX,MAAI,CAAC,WAAW,SAAS;AACvB,kBAAe;AACf,OAAI,WAAW,YAAY,UAAU,OAAO,EAC1C,QAAO,KACL,MAAM,OACJ,kBAAkB,WAAW,YAAY,UAAU,KAAK,wEACzD,CACF;OAED,QAAO;;OAIX,MAAK,MAAM,QAAQ,cAEjB,aAAY,UAAU,IACpB,GAAG,KAAK,SAAS,GAAG,KAAK,OAAO,GAAG,KAAK,UAAU,GAAG,KAAK,UAC1D,KACD;CAKL,MAAM,eAAe,IAAI,yBAAyB,IAAI,QAAQ;CAC9D,MAAM,iBAAiB,MAAM,aAAa,IAAI;EAC5C;EACA;EACA;EACD,CAAC;AACF,OAAM,aAAa,MAAM;AAGzB,KAAI,aACF,QAAO;AAGT,QAAO;;;;;AAMT,SAAS,qBACP,iBACA,SACA,YACkB;CAClB,MAAM,gBAAkC,EAAE;AAE1C,MAAK,MAAM,UAAU,gBACnB,MAAK,MAAM,UAAU,QACnB,eAAc,KAAK;EACjB,WAAW,gBAAgB,QAAQ;EACnC,UAAU,gBAAgB,QAAQ;EAClC;EACA;EACA,UAAU,WAAW,cAAc;EACpC,CAAC;AAIN,QAAO"}

package/dist/workflows/enqueue.js

@@ -1,59 +1,52 @@
-import { logCollectedFiles, logErrorAndExit } from '../console/logging.js';
-import { gt } from '../utils/gt.js';
-import { EnqueueStep } from './steps/EnqueueStep.js';
-import { BranchStep } from './steps/BranchStep.js';
-import { logger } from '../console/logger.js';
+import { logger } from "../console/logger.js";
+import { gt } from "../utils/gt.js";
+import { logCollectedFiles, logErrorAndExit } from "../console/logging.js";
+import { branchResolutionError, withOriginalError } from "../console/index.js";
+import { BranchStep } from "./steps/BranchStep.js";
+import { EnqueueStep } from "./steps/EnqueueStep.js";
+//#region src/workflows/enqueue.ts
 /**
- * Enqueues translations for a given set of files
- *  - Only enqueues uploaded files
- *  - Don't have to worry about double enqueuing files because dedupe on API side
- *
- * @param {FileTranslationData} fileVersionData - The file version data
- * @param {TranslateFlags} options - The options for the enqueue operation
- * @param {Settings} settings - The settings for the enqueue operation
- * @returns {Promise<EnqueueFilesResult>} The enqueue result
- */
-export async function runEnqueueWorkflow({ files, options, settings, }) {
-    try {
-        // Log files to be enqueued
-        logCollectedFiles(files);
-        logger.debug('Files: ' + JSON.stringify(files, null, 2));
-        // Create workflow with steps
-        const branchStep = new BranchStep(gt, settings);
-        // const queryFileDataStep = new QueryFileDataStep(gt);
-        const enqueueStep = new EnqueueStep(gt, settings, options.force);
-        // (1) run the branch step
-        const branchData = await branchStep.run();
-        await branchStep.wait();
-        if (!branchData) {
-            return logErrorAndExit('Failed to resolve git branch information.');
-        }
-        logger.debug('Branch data: ' + JSON.stringify(branchData, null, 2));
-        // (2) Enqueue the files
-        const enqueueResult = await enqueueStep.run(files.map((files) => ({
-            branchId: branchData.currentBranch.id,
-            ...files,
-        })));
-        await enqueueStep.wait();
-        logger.debug('Enqueue result: ' + JSON.stringify(enqueueResult, null, 2));
-        logEnqueueResult(enqueueResult, files);
-        return enqueueResult;
-    }
-    catch (error) {
-        return logErrorAndExit('Failed to enqueue translations. ' + error);
-    }
+* Enqueues translations for a given set of files
+*  - Only enqueues uploaded files
+*  - Don't have to worry about double enqueuing files because dedupe on API side
+*
+* @param {FileTranslationData} fileVersionData - The file version data
+* @param {TranslateFlags} options - The options for the enqueue operation
+* @param {Settings} settings - The settings for the enqueue operation
+* @returns {Promise<EnqueueFilesResult>} The enqueue result
+*/
+async function runEnqueueWorkflow({ files, options, settings }) {
+	try {
+		logCollectedFiles(files);
+		logger.debug("Files: " + JSON.stringify(files, null, 2));
+		const branchStep = new BranchStep(gt, settings);
+		const enqueueStep = new EnqueueStep(gt, settings, options.force);
+		const branchData = await branchStep.run();
+		await branchStep.wait();
+		if (!branchData) return logErrorAndExit(branchResolutionError);
+		logger.debug("Branch data: " + JSON.stringify(branchData, null, 2));
+		const enqueueResult = await enqueueStep.run(files.map((files) => ({
+			branchId: branchData.currentBranch.id,
+			...files
+		})));
+		await enqueueStep.wait();
+		logger.debug("Enqueue result: " + JSON.stringify(enqueueResult, null, 2));
+		logEnqueueResult(enqueueResult, files);
+		return enqueueResult;
+	} catch (error) {
+		return logErrorAndExit(withOriginalError("Translations could not be enqueued. Check the files, branch configuration, and API credentials, then try again.", error));
+	}
 }
-// ----- Helper functions ----- //
 /**
- * Logs the enqueue result
- * @param enqueueResult - The enqueue result
- * @returns void
- */
+* Logs the enqueue result
+* @param enqueueResult - The enqueue result
+* @returns void
+*/
 function logEnqueueResult(enqueueResult, files) {
-    if (Object.keys(enqueueResult.jobData).length === 0) {
-        logger.success(`All ${files.length} files already translated. 0 files enqueued.`);
-    }
-    else {
-        logger.success(enqueueResult.message);
-    }
+	if (Object.keys(enqueueResult.jobData).length === 0) logger.success(`All ${files.length} files already translated. 0 files enqueued.`);
+	else logger.success(enqueueResult.message);
 }
+//#endregion
+export { runEnqueueWorkflow };
+
+//# sourceMappingURL=enqueue.js.map

package/dist/workflows/enqueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enqueue.js","names":[],"sources":["../../src/workflows/enqueue.ts"],"sourcesContent":["import { logCollectedFiles, logErrorAndExit } from '../console/logging.js';\nimport { branchResolutionError, withOriginalError } from '../console/index.js';\nimport { Settings, TranslateFlags } from '../types/index.js';\nimport { gt } from '../utils/gt.js';\nimport { EnqueueFilesResult, FileToUpload } from 'generaltranslation/types';\nimport { EnqueueStep } from './steps/EnqueueStep.js';\nimport { BranchStep } from './steps/BranchStep.js';\nimport { logger } from '../console/logger.js';\n\n/**\n * Enqueues translations for a given set of files\n *  - Only enqueues uploaded files\n *  - Don't have to worry about double enqueuing files because dedupe on API side\n *\n * @param {FileTranslationData} fileVersionData - The file version data\n * @param {TranslateFlags} options - The options for the enqueue operation\n * @param {Settings} settings - The settings for the enqueue operation\n * @returns {Promise<EnqueueFilesResult>} The enqueue result\n */\nexport async function runEnqueueWorkflow({\n  files,\n  options,\n  settings,\n}: {\n  files: FileToUpload[];\n  options: TranslateFlags;\n  settings: Settings;\n}): Promise<EnqueueFilesResult> {\n  try {\n    // Log files to be enqueued\n    logCollectedFiles(files);\n\n    logger.debug('Files: ' + JSON.stringify(files, null, 2));\n\n    // Create workflow with steps\n    const branchStep = new BranchStep(gt, settings);\n    // const queryFileDataStep = new QueryFileDataStep(gt);\n    const enqueueStep = new EnqueueStep(gt, settings, options.force);\n\n    // (1) run the branch step\n    const branchData = await branchStep.run();\n    await branchStep.wait();\n    if (!branchData) {\n      return logErrorAndExit(branchResolutionError);\n    }\n    logger.debug('Branch data: ' + JSON.stringify(branchData, null, 2));\n\n    // (2) Enqueue the files\n    const enqueueResult = await enqueueStep.run(\n      files.map((files) => ({\n        branchId: branchData.currentBranch.id,\n        ...files,\n      }))\n    );\n    await enqueueStep.wait();\n\n    logger.debug('Enqueue result: ' + JSON.stringify(enqueueResult, null, 2));\n\n    logEnqueueResult(enqueueResult, files);\n    return enqueueResult;\n  } catch (error) {\n    return logErrorAndExit(\n      withOriginalError(\n        'Translations could not be enqueued. Check the files, branch configuration, and API credentials, then try again.',\n        error\n      )\n    );\n  }\n}\n\n// ----- Helper functions ----- //\n\n/**\n * Logs the enqueue result\n * @param enqueueResult - The enqueue result\n * @returns void\n */\nfunction logEnqueueResult(\n  enqueueResult: EnqueueFilesResult,\n  files: FileToUpload[]\n): void {\n  if (Object.keys(enqueueResult.jobData).length === 0) {\n    logger.success(\n      `All ${files.length} files already translated. 0 files enqueued.`\n    );\n  } else {\n    logger.success(enqueueResult.message);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAmBA,eAAsB,mBAAmB,EACvC,OACA,SACA,YAK8B;AAC9B,KAAI;AAEF,oBAAkB,MAAM;AAExB,SAAO,MAAM,YAAY,KAAK,UAAU,OAAO,MAAM,EAAE,CAAC;EAGxD,MAAM,aAAa,IAAI,WAAW,IAAI,SAAS;EAE/C,MAAM,cAAc,IAAI,YAAY,IAAI,UAAU,QAAQ,MAAM;EAGhE,MAAM,aAAa,MAAM,WAAW,KAAK;AACzC,QAAM,WAAW,MAAM;AACvB,MAAI,CAAC,WACH,QAAO,gBAAgB,sBAAsB;AAE/C,SAAO,MAAM,kBAAkB,KAAK,UAAU,YAAY,MAAM,EAAE,CAAC;EAGnE,MAAM,gBAAgB,MAAM,YAAY,IACtC,MAAM,KAAK,WAAW;GACpB,UAAU,WAAW,cAAc;GACnC,GAAG;GACJ,EAAE,CACJ;AACD,QAAM,YAAY,MAAM;AAExB,SAAO,MAAM,qBAAqB,KAAK,UAAU,eAAe,MAAM,EAAE,CAAC;AAEzE,mBAAiB,eAAe,MAAM;AACtC,SAAO;UACA,OAAO;AACd,SAAO,gBACL,kBACE,mHACA,MACD,CACF;;;;;;;;AAWL,SAAS,iBACP,eACA,OACM;AACN,KAAI,OAAO,KAAK,cAAc,QAAQ,CAAC,WAAW,EAChD,QAAO,QACL,OAAO,MAAM,OAAO,8CACrB;KAED,QAAO,QAAQ,cAAc,QAAQ"}