gt 2.18.1 → 2.20.0

package/dist/translation/reviewSetupWarning.js.map

@@ -1 +1 @@
-{"version":3,"file":"reviewSetupWarning.js","names":[],"sources":["../../src/translation/reviewSetupWarning.ts"],"sourcesContent":["import path from 'node:path';\nimport chalk from 'chalk';\nimport type { FileToUpload } from 'generaltranslation/types';\nimport { logger } from '../console/logger.js';\nimport { gt } from '../utils/gt.js';\nimport { Settings } from '../types/index.js';\n\nconst PROJECT_INFO_TIMEOUT_MS = 10_000;\n\n/**\n * Warns when an upload contains review-gated content but the project\n * auto-approves new translations, pointing the user at the dashboard project\n * settings page. The CLI cannot change the auto-approve setting itself —\n * review setup happens in the dashboard.\n *\n * The project's auto-approve setting is fetched lazily (only when the upload\n * actually contains review-gated content):\n * - false: manual review is already the project workflow — no warning\n * - true: requiresReview config has no gating effect — warn\n * - unavailable (older API, dry runs without credentials): warn with\n *   conditional wording, since auto-approve is the platform default\n */\nexport async function warnManualReviewSetup(\n  settings: Settings,\n  files: FileToUpload[]\n): Promise<void> {\n  const requiresReviewPaths = settings.files?.requiresReviewPaths;\n\n  const hasReviewGatedFile = files.some((file) => {\n    if (file.fileFormat === 'GTJSON') {\n      // Uploaded GTJSON metadata carries the platform's snake_case key\n      return Object.values(file.formatMetadata ?? {}).some(\n        (metadata) =>\n          (metadata as { requires_review?: boolean })?.requires_review === true\n      );\n    }\n    return requiresReviewPaths?.has(path.resolve(process.cwd(), file.fileName));\n  });\n  if (!hasReviewGatedFile) return;\n\n  let autoApprove: boolean | undefined;\n  try {\n    autoApprove = (\n      await gt.getProjectInfo({ timeout: PROJECT_INFO_TIMEOUT_MS })\n    ).autoApprove;\n  } catch {\n    // Setting unavailable — fall through to the conditional wording\n  }\n  if (autoApprove === false) return;\n\n  const settingsUrl = settings.projectId\n    ? `${settings.dashboardUrl}/project/${settings.projectId}/settings`\n    : settings.dashboardUrl;\n  const autoApproveClause =\n    autoApprove === true\n      ? 'but this project approves new translations automatically.'\n      : 'but new translations are approved automatically unless auto-approval is turned off for this project.';\n  // \"Auto approve translations\" matches the dashboard setting title exactly.\n  const message =\n    `Some of your content requires review (requiresReview), ${autoApproveClause} ` +\n    `To review translations before they are used, disable \"Auto approve translations\" in your project settings:`;\n  logger.warn(\n    chalk.yellow(\n      [...wrapWords(message, 70), chalk.cyan(settingsUrl)].join('\\n')\n    )\n  );\n}\n\n/**\n * Greedy word wrap so warning lines render at a consistent width instead of\n * one terminal-width line followed by stubby fragments.\n */\nfunction wrapWords(text: string, width: number): string[] {\n  const lines: string[] = [];\n  let line = '';\n  for (const word of text.split(' ')) {\n    if (line && line.length + 1 + word.length > width) {\n      lines.push(line);\n      line = word;\n    } else {\n      line = line ? `${line} ${word}` : word;\n    }\n  }\n  if (line) lines.push(line);\n  return lines;\n}\n"],"mappings":";;;;;AAOA,MAAM,0BAA0B;;;;;;;;;;;;;;AAehC,eAAsB,sBACpB,UACA,OACe;CACf,MAAM,sBAAsB,SAAS,OAAO;AAY5C,KAAI,CAVuB,MAAM,MAAM,SAAS;AAC9C,MAAI,KAAK,eAAe,SAEtB,QAAO,OAAO,OAAO,KAAK,kBAAkB,EAAE,CAAC,CAAC,MAC7C,aACE,UAA4C,oBAAoB,KACpE;AAEH,SAAO,qBAAqB,IAAI,KAAK,QAAQ,QAAQ,KAAK,EAAE,KAAK,SAAS,CAAC;GAEtD,CAAE;CAEzB,IAAI;AACJ,KAAI;AACF,iBACE,MAAM,GAAG,eAAe,EAAE,SAAS,yBAAyB,CAAC,EAC7D;SACI;AAGR,KAAI,gBAAgB,MAAO;CAE3B,MAAM,cAAc,SAAS,YACzB,GAAG,SAAS,aAAa,WAAW,SAAS,UAAU,aACvD,SAAS;CAMb,MAAM,UACJ,0DALA,gBAAgB,OACZ,8DACA,uGAGwE;AAE9E,QAAO,KACL,MAAM,OACJ,CAAC,GAAG,UAAU,SAAS,GAAG,EAAE,MAAM,KAAK,YAAY,CAAC,CAAC,KAAK,KAAK,CAChE,CACF;;;;;;AAOH,SAAS,UAAU,MAAc,OAAyB;CACxD,MAAM,QAAkB,EAAE;CAC1B,IAAI,OAAO;AACX,MAAK,MAAM,QAAQ,KAAK,MAAM,IAAI,CAChC,KAAI,QAAQ,KAAK,SAAS,IAAI,KAAK,SAAS,OAAO;AACjD,QAAM,KAAK,KAAK;AAChB,SAAO;OAEP,QAAO,OAAO,GAAG,KAAK,GAAG,SAAS;AAGtC,KAAI,KAAM,OAAM,KAAK,KAAK;AAC1B,QAAO"}
+{"version":3,"file":"reviewSetupWarning.js","names":[],"sources":["../../src/translation/reviewSetupWarning.ts"],"sourcesContent":["import path from 'node:path';\nimport chalk from 'chalk';\nimport type { FileToUpload } from 'generaltranslation/types';\nimport { logger } from '../console/logger.js';\nimport { api } from '../utils/api.js';\nimport { Settings } from '../types/index.js';\n\nconst PROJECT_INFO_TIMEOUT_MS = 10_000;\n\n/**\n * Warns when an upload contains review-gated content but the project\n * auto-approves new translations, pointing the user at the dashboard project\n * settings page. The CLI cannot change the auto-approve setting itself —\n * review setup happens in the dashboard.\n *\n * The project's auto-approve setting is fetched lazily (only when the upload\n * actually contains review-gated content):\n * - false: manual review is already the project workflow — no warning\n * - true: requiresReview config has no gating effect — warn\n * - unavailable (older API, dry runs without credentials): warn with\n *   conditional wording, since auto-approve is the platform default\n */\nexport async function warnManualReviewSetup(\n  settings: Settings,\n  files: FileToUpload[]\n): Promise<void> {\n  const requiresReviewPaths = settings.files?.requiresReviewPaths;\n\n  const hasReviewGatedFile = files.some((file) => {\n    if (file.fileFormat === 'GTJSON') {\n      // Uploaded GTJSON metadata carries the platform's snake_case key\n      return Object.values(file.formatMetadata ?? {}).some(\n        (metadata) =>\n          typeof metadata === 'object' &&\n          metadata !== null &&\n          'requires_review' in metadata &&\n          metadata.requires_review === true\n      );\n    }\n    return requiresReviewPaths?.has(path.resolve(process.cwd(), file.fileName));\n  });\n  if (!hasReviewGatedFile) return;\n\n  let autoApprove: boolean | undefined;\n  try {\n    autoApprove = (await api.getProjectInfo(PROJECT_INFO_TIMEOUT_MS))\n      .autoApprove;\n  } catch {\n    // Setting unavailable — fall through to the conditional wording\n  }\n  if (autoApprove === false) return;\n\n  const settingsUrl = settings.projectId\n    ? `${settings.dashboardUrl}/project/${settings.projectId}/settings`\n    : settings.dashboardUrl;\n  const autoApproveClause =\n    autoApprove === true\n      ? 'but this project approves new translations automatically.'\n      : 'but new translations are approved automatically unless auto-approval is turned off for this project.';\n  // \"Auto approve translations\" matches the dashboard setting title exactly.\n  const message =\n    `Some of your content requires review (requiresReview), ${autoApproveClause} ` +\n    `To review translations before they are used, disable \"Auto approve translations\" in your project settings:`;\n  logger.warn(\n    chalk.yellow(\n      [...wrapWords(message, 70), chalk.cyan(settingsUrl)].join('\\n')\n    )\n  );\n}\n\n/**\n * Greedy word wrap so warning lines render at a consistent width instead of\n * one terminal-width line followed by stubby fragments.\n */\nfunction wrapWords(text: string, width: number): string[] {\n  const lines: string[] = [];\n  let line = '';\n  for (const word of text.split(' ')) {\n    if (line && line.length + 1 + word.length > width) {\n      lines.push(line);\n      line = word;\n    } else {\n      line = line ? `${line} ${word}` : word;\n    }\n  }\n  if (line) lines.push(line);\n  return lines;\n}\n"],"mappings":";;;;;AAOA,MAAM,0BAA0B;;;;;;;;;;;;;;AAehC,eAAsB,sBACpB,UACA,OACe;CACf,MAAM,sBAAsB,SAAS,OAAO;AAe5C,KAAI,CAbuB,MAAM,MAAM,SAAS;AAC9C,MAAI,KAAK,eAAe,SAEtB,QAAO,OAAO,OAAO,KAAK,kBAAkB,EAAE,CAAC,CAAC,MAC7C,aACC,OAAO,aAAa,YACpB,aAAa,QACb,qBAAqB,YACrB,SAAS,oBAAoB,KAChC;AAEH,SAAO,qBAAqB,IAAI,KAAK,QAAQ,QAAQ,KAAK,EAAE,KAAK,SAAS,CAAC;GAEtD,CAAE;CAEzB,IAAI;AACJ,KAAI;AACF,iBAAe,MAAM,IAAI,eAAe,wBAAwB,EAC7D;SACG;AAGR,KAAI,gBAAgB,MAAO;CAE3B,MAAM,cAAc,SAAS,YACzB,GAAG,SAAS,aAAa,WAAW,SAAS,UAAU,aACvD,SAAS;CAMb,MAAM,UACJ,0DALA,gBAAgB,OACZ,8DACA,uGAGwE;AAE9E,QAAO,KACL,MAAM,OACJ,CAAC,GAAG,UAAU,SAAS,GAAG,EAAE,MAAM,KAAK,YAAY,CAAC,CAAC,KAAK,KAAK,CAChE,CACF;;;;;;AAOH,SAAS,UAAU,MAAc,OAAyB;CACxD,MAAM,QAAkB,EAAE;CAC1B,IAAI,OAAO;AACX,MAAK,MAAM,QAAQ,KAAK,MAAM,IAAI,CAChC,KAAI,QAAQ,KAAK,SAAS,IAAI,KAAK,SAAS,OAAO;AACjD,QAAM,KAAK,KAAK;AAChB,SAAO;OAEP,QAAO,OAAO,GAAG,KAAK,GAAG,SAAS;AAGtC,KAAI,KAAM,OAAM,KAAK,KAAK;AAC1B,QAAO"}

package/dist/utils/api.d.ts

@@ -0,0 +1,194 @@
+import type { CustomMapping } from '@generaltranslation/format/types';
+import { type ApiClientConfig, type AwaitJobsOptions, type CreateBranchData, type CreateProjectData, type CreateTagData, type DownloadFilesData, type EnqueueFileTranslationsData, type GenerateProjectContextData, type GetBranchInfoData, type GetFileInfoData, type ProcessFileMovesData, type PublishFilesData, type SubmitUserEditDiffsData, type UploadSourceFilesData, type UploadTranslationsData } from 'generaltranslation/api';
+export declare function configureApiClient(config: ApiClientConfig & {
+    customMapping?: CustomMapping;
+}): void;
+export declare const api: {
+    queryBranchData(body: GetBranchInfoData["body"]): Promise<{
+        branches: Array<import("@generaltranslation/api").Branch>;
+        defaultBranch: import("@generaltranslation/api").Branch & ({
+            [key: string]: unknown;
+        } | null);
+    }>;
+    createBranch(body: CreateBranchData["body"]): Promise<{
+        branch: import("@generaltranslation/api").Branch;
+    }>;
+    queryFileData(body: GetFileInfoData["body"]): Promise<{
+        translatedFiles: {
+            locale: string;
+            branchId: string;
+            fileId: string;
+            versionId: string;
+            fileFormat: import("@generaltranslation/api").FileFormat;
+            dataFormat: string | null;
+            createdAt: string;
+            updatedAt: string;
+            approvedAt: string | null;
+            publishedAt: string | null;
+            completedAt: string | null;
+        }[];
+        sourceFiles: {
+            sourceLocale: string;
+            locales: string[];
+            branchId: string;
+            fileId: string;
+            versionId: string;
+            fileName: string;
+            fileFormat: import("@generaltranslation/api").FileFormat;
+            dataFormat: string | null;
+            createdAt: string;
+            updatedAt: string;
+            publishedAt: string | null;
+        }[];
+    }>;
+    checkJobStatus(jobIds: string[]): Promise<({
+        status: "queued";
+        jobId: string;
+    } | {
+        status: "processing";
+        jobId: string;
+    } | {
+        status: "failed";
+        jobId: string;
+        error: {
+            message: string | null;
+        };
+    } | {
+        status: "completed";
+        jobId: string;
+    } | {
+        status: "unknown";
+        jobId: string;
+    })[]>;
+    getProjectInfo(timeoutMs: number): Promise<{
+        id: string;
+        name: string;
+        orgId: string;
+        defaultLocale: string | null;
+        currentLocales: Array<string>;
+        autoApprove: boolean;
+    }>;
+    resolveAliasLocale(locale: string): string;
+    downloadFileBatch(files: DownloadFilesData["body"]): Promise<{
+        files: {
+            data: string;
+            locale?: string;
+            id: string;
+            branchId: string;
+            fileId: string;
+            versionId: string;
+            fileName?: string;
+            metadata: import("@generaltranslation/api").JsonObject;
+            fileFormat: import("@generaltranslation/api").FileFormat;
+        }[];
+        count: number;
+        pending: {
+            branchId: string;
+            fileId: string;
+            locale: string;
+            versionId: string;
+        }[];
+    }>;
+    publishFiles(files: PublishFilesData["body"]["files"]): Promise<{
+        results: Array<{
+            fileId: string;
+            versionId: string;
+            locale?: string;
+            branchId: string;
+            success: boolean;
+            error?: string;
+        }>;
+    }>;
+    submitUserEditDiffs(body: SubmitUserEditDiffsData["body"]): Promise<{
+        filesProcessed: number;
+        entriesReceived: number;
+        message: string;
+    }[]>;
+    createTag(body: CreateTagData["body"]): Promise<{
+        tag: {
+            id: string;
+            tagId: string;
+            message: string | null;
+            createdAt: string;
+            updatedAt: string;
+        };
+    }>;
+    createProject(body: CreateProjectData["body"]): Promise<{
+        project: {
+            id: string;
+            name: string;
+            orgId: string;
+            defaultLocale: string;
+        };
+    }>;
+    getOrphanedFiles(branchId: string, fileIds: string[]): Promise<{
+        orphanedFiles: Array<{
+            fileId: string;
+            versionId: string;
+            fileName: string;
+        }>;
+    }>;
+    processFileMoves(moves: ProcessFileMovesData["body"]["moves"], options: Pick<ProcessFileMovesData["body"], "branchId">): Promise<{
+        results: {
+            oldFileId: string;
+            newFileId: string;
+            success: boolean;
+            newSourceFileId?: string;
+            clonedTranslationsCount?: number;
+            error?: string;
+        }[];
+        summary: {
+            total: number;
+            succeeded: number;
+            failed: number;
+        };
+    }>;
+    setupProject(files: GenerateProjectContextData["body"]["files"], options?: Omit<GenerateProjectContextData["body"], "files">): Promise<{
+        status: "completed";
+    } | {
+        setupJobId: string;
+        status: "queued";
+    }>;
+    awaitJobs(jobIds: readonly string[], options?: AwaitJobsOptions): Promise<import("@generaltranslation/api").AwaitJobsResult>;
+    enqueueFiles(files: EnqueueFileTranslationsData["body"]["files"], options: {
+        sourceLocale?: string;
+        targetLocales: string[];
+        modelProvider?: string;
+        force?: boolean;
+    }): Promise<{
+        jobData: {
+            [k: string]: any;
+        };
+        locales: string[];
+        message: string;
+    }>;
+    uploadSourceFiles(files: Array<{
+        source: UploadSourceFilesData["body"]["data"][number]["source"];
+    }>, options: {
+        sourceLocale: string;
+    }): Promise<{
+        uploadedFiles: {
+            branchId?: string;
+            fileId: string;
+            versionId: string;
+            fileName: string;
+            fileFormat: import("@generaltranslation/api").FileFormat;
+            dataFormat?: string;
+            locale?: string;
+        }[];
+    }>;
+    uploadTranslations(files: UploadTranslationsData["body"]["data"], options: {
+        sourceLocale: string;
+    }): Promise<{
+        uploadedFiles: {
+            branchId?: string;
+            fileId: string;
+            versionId: string;
+            fileName: string;
+            fileFormat: import("@generaltranslation/api").FileFormat;
+            dataFormat?: string;
+            locale?: string;
+        }[];
+    }>;
+};
+export type ApiClient = typeof api;

package/dist/utils/api.js

@@ -0,0 +1,268 @@
+import { unwrapApiResult } from "generaltranslation/internal";
+import { resolveAliasLocale, resolveCanonicalLocale } from "@generaltranslation/format";
+import { DEFAULT_BATCH_SIZE, createApiClient, createBranch, createProject, createTag, decodeFileContent, downloadFiles, encodeFileContent, enqueueFileTranslations, generateProjectContext, getBranchInfo, getFileInfo, getOrphanedFiles, getProjectInfo, getTranslationJobInfo, pollJobs, processBatches, processFileMoves, publishFiles, submitUserEditDiffs, uploadSourceFiles, uploadTranslations } from "generaltranslation/api";
+//#region src/utils/api.ts
+let client;
+let configuredClientConfig;
+let customMapping;
+function getConfiguredClient() {
+	if (!client || !configuredClientConfig) throw new Error("API client not configured — call configureApiClient first");
+	return {
+		client,
+		config: configuredClientConfig
+	};
+}
+function getClient() {
+	return getConfiguredClient().client;
+}
+function getClientConfig() {
+	return getConfiguredClient().config;
+}
+function configureApiClient(config) {
+	const { customMapping: mapping, ...clientConfig } = config;
+	client = createApiClient(clientConfig);
+	configuredClientConfig = clientConfig;
+	customMapping = mapping;
+}
+const api = {
+	async queryBranchData(body) {
+		return unwrapApiResult(await getBranchInfo({
+			body,
+			client: getClient()
+		}));
+	},
+	async createBranch(body) {
+		return unwrapApiResult(await createBranch({
+			body,
+			client: getClient()
+		}));
+	},
+	async queryFileData(body) {
+		const result = unwrapApiResult(await getFileInfo({
+			body: {
+				...body,
+				translatedFiles: body.translatedFiles?.map((file) => ({
+					...file,
+					locale: resolveCanonicalLocale(file.locale, customMapping)
+				}))
+			},
+			client: getClient()
+		}));
+		return {
+			...result,
+			translatedFiles: result.translatedFiles.map((file) => ({
+				...file,
+				locale: resolveAliasLocale(file.locale, customMapping)
+			})),
+			sourceFiles: result.sourceFiles.map((file) => ({
+				...file,
+				sourceLocale: resolveAliasLocale(file.sourceLocale, customMapping),
+				locales: file.locales.map((locale) => resolveAliasLocale(locale, customMapping))
+			}))
+		};
+	},
+	async checkJobStatus(jobIds) {
+		return unwrapApiResult(await getTranslationJobInfo({
+			body: { jobIds },
+			client: getClient()
+		}));
+	},
+	async getProjectInfo(timeoutMs) {
+		const config = getClientConfig();
+		if (!config.projectId) throw new Error("Project ID is required to fetch project information");
+		return unwrapApiResult(await getProjectInfo({
+			client: createApiClient({
+				...config,
+				timeoutMs
+			}),
+			path: { projectId: config.projectId }
+		}));
+	},
+	resolveAliasLocale(locale) {
+		return resolveAliasLocale(locale, customMapping);
+	},
+	async downloadFileBatch(files) {
+		if (files.length === 0) return {
+			files: [],
+			count: 0,
+			pending: []
+		};
+		const request = async (batch) => unwrapApiResult(await downloadFiles({
+			body: batch.map((file) => ({
+				...file,
+				locale: file.locale ? resolveCanonicalLocale(file.locale, customMapping) : void 0
+			})),
+			client: getClient()
+		}));
+		const responses = await processBatches(files, async (batch) => [await request(batch)]);
+		return {
+			files: responses.flatMap((response) => response.files.map((file) => ({
+				...file,
+				...file.locale && { locale: resolveAliasLocale(file.locale, customMapping) },
+				data: decodeFileContent(file.data, file.fileFormat)
+			}))),
+			count: responses.reduce((count, response) => count + response.count, 0),
+			pending: responses.flatMap((response) => response.pending ?? [])
+		};
+	},
+	async publishFiles(files) {
+		return unwrapApiResult(await publishFiles({
+			body: { files },
+			client: getClient()
+		}));
+	},
+	async submitUserEditDiffs(body) {
+		return processBatches(body.diffs, async (diffs) => [unwrapApiResult(await submitUserEditDiffs({
+			body: {
+				projectId: body.projectId,
+				diffs: diffs.map((diff) => ({
+					...diff,
+					locale: resolveCanonicalLocale(diff.locale, customMapping)
+				}))
+			},
+			client: getClient()
+		}))]);
+	},
+	async createTag(body) {
+		return unwrapApiResult(await createTag({
+			body,
+			client: getClient()
+		}));
+	},
+	async createProject(body) {
+		return unwrapApiResult(await createProject({
+			body: {
+				...body,
+				defaultLocale: resolveCanonicalLocale(body.defaultLocale, customMapping)
+			},
+			client: getClient()
+		}));
+	},
+	async getOrphanedFiles(branchId, fileIds) {
+		const request = async (batch) => unwrapApiResult(await getOrphanedFiles({
+			body: {
+				branchId,
+				fileIds: batch
+			},
+			client: getClient()
+		}));
+		if (fileIds.length === 0) return request([]);
+		const results = await processBatches(fileIds, async (batch) => [await request(batch)]);
+		const orphanedFiles = new Map(results[0].orphanedFiles.map((file) => [file.fileId, file]));
+		for (const result of results.slice(1)) {
+			const batchFileIds = new Set(result.orphanedFiles.map((file) => file.fileId));
+			for (const fileId of orphanedFiles.keys()) if (!batchFileIds.has(fileId)) orphanedFiles.delete(fileId);
+		}
+		return { orphanedFiles: [...orphanedFiles.values()] };
+	},
+	async processFileMoves(moves, options) {
+		const result = await processBatches(moves, async (batch) => {
+			return unwrapApiResult(await processFileMoves({
+				body: {
+					branchId: options.branchId,
+					moves: batch
+				},
+				client: getClient()
+			})).results;
+		});
+		const succeeded = result.filter(({ success }) => success).length;
+		return {
+			results: result,
+			summary: {
+				total: moves.length,
+				succeeded,
+				failed: result.length - succeeded
+			}
+		};
+	},
+	async setupProject(files, options = {}) {
+		return unwrapApiResult(await generateProjectContext({
+			body: {
+				files: files.map(({ branchId, fileId, versionId }) => ({
+					branchId,
+					fileId,
+					versionId
+				})),
+				locales: options.locales?.map((locale) => resolveCanonicalLocale(locale, customMapping)),
+				force: options.force
+			},
+			client: getClient()
+		}));
+	},
+	async awaitJobs(jobIds, options) {
+		return pollJobs(jobIds, async (pendingJobIds, signal) => unwrapApiResult(await getTranslationJobInfo({
+			body: { jobIds: pendingJobIds },
+			client: getClient(),
+			signal
+		})), options);
+	},
+	async enqueueFiles(files, options) {
+		const targetLocales = options.targetLocales.map((locale) => resolveCanonicalLocale(locale, customMapping));
+		const result = await processBatches(files, async (batch) => {
+			const response = unwrapApiResult(await enqueueFileTranslations({
+				body: {
+					files: batch.map(({ branchId, fileId, versionId, fileName, transformFormat }) => ({
+						branchId,
+						fileId,
+						versionId,
+						fileName,
+						transformFormat
+					})),
+					targetLocales,
+					sourceLocale: options.sourceLocale ? resolveCanonicalLocale(options.sourceLocale, customMapping) : void 0,
+					modelProvider: options.modelProvider,
+					force: options.force
+				},
+				client: getClient()
+			}));
+			const jobData = "jobData" in response ? response.jobData : response.data;
+			return Object.entries(jobData);
+		});
+		return {
+			jobData: Object.fromEntries(result),
+			locales: targetLocales,
+			message: `Successfully enqueued ${result.length} file translation jobs in ${Math.ceil(files.length / DEFAULT_BATCH_SIZE)} batch(es)`
+		};
+	},
+	async uploadSourceFiles(files, options) {
+		const sourceLocale = resolveCanonicalLocale(options.sourceLocale, customMapping);
+		return { uploadedFiles: await processBatches(files, async (batch) => {
+			return unwrapApiResult(await uploadSourceFiles({
+				body: {
+					data: batch.map(({ source }) => ({ source: {
+						...source,
+						content: encodeFileContent(source.content, source.fileFormat),
+						locale: resolveCanonicalLocale(source.locale, customMapping)
+					} })),
+					sourceLocale
+				},
+				client: getClient()
+			})).uploadedFiles;
+		}) };
+	},
+	async uploadTranslations(files, options) {
+		return { uploadedFiles: await processBatches(files, async (batch) => {
+			return unwrapApiResult(await uploadTranslations({
+				body: {
+					data: batch.map(({ source, translations }) => ({
+						source: {
+							...source,
+							content: encodeFileContent(source.content, source.fileFormat)
+						},
+						translations: translations.map((translation) => ({
+							...translation,
+							locale: resolveCanonicalLocale(translation.locale, customMapping),
+							content: encodeFileContent(translation.content, translation.fileFormat)
+						}))
+					})),
+					sourceLocale: resolveCanonicalLocale(options.sourceLocale, customMapping)
+				},
+				client: getClient()
+			})).uploadedFiles;
+		}) };
+	}
+};
+//#endregion
+export { api, configureApiClient };
+
+//# sourceMappingURL=api.js.map

package/dist/utils/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","names":[],"sources":["../../src/utils/api.ts"],"sourcesContent":["import {\n  resolveAliasLocale,\n  resolveCanonicalLocale,\n} from '@generaltranslation/format';\nimport type { CustomMapping } from '@generaltranslation/format/types';\nimport {\n  createApiClient,\n  createBranch,\n  createProject,\n  createTag,\n  decodeFileContent,\n  DEFAULT_BATCH_SIZE,\n  downloadFiles,\n  encodeFileContent,\n  enqueueFileTranslations,\n  generateProjectContext,\n  getBranchInfo,\n  getFileInfo,\n  getOrphanedFiles,\n  getProjectInfo,\n  getTranslationJobInfo,\n  pollJobs,\n  processBatches,\n  processFileMoves,\n  publishFiles,\n  submitUserEditDiffs,\n  uploadSourceFiles,\n  uploadTranslations,\n  type ApiClientConfig,\n  type AwaitJobsOptions,\n  type CreateBranchData,\n  type CreateProjectData,\n  type CreateTagData,\n  type DownloadFilesData,\n  type EnqueueFileTranslationsData,\n  type GenerateProjectContextData,\n  type GetBranchInfoData,\n  type GetFileInfoData,\n  type ProcessFileMovesData,\n  type PublishFilesData,\n  type SubmitUserEditDiffsData,\n  type UploadSourceFilesData,\n  type UploadTranslationsData,\n} from 'generaltranslation/api';\nimport { unwrapApiResult } from 'generaltranslation/internal';\n\nlet client: ReturnType<typeof createApiClient> | undefined;\nlet configuredClientConfig: ApiClientConfig | undefined;\nlet customMapping: CustomMapping | undefined;\n\nfunction getConfiguredClient(): {\n  client: ReturnType<typeof createApiClient>;\n  config: ApiClientConfig;\n} {\n  if (!client || !configuredClientConfig) {\n    throw new Error(\n      'API client not configured — call configureApiClient first'\n    );\n  }\n  return { client, config: configuredClientConfig };\n}\n\nfunction getClient(): ReturnType<typeof createApiClient> {\n  return getConfiguredClient().client;\n}\n\nfunction getClientConfig(): ApiClientConfig {\n  return getConfiguredClient().config;\n}\n\nexport function configureApiClient(\n  config: ApiClientConfig & { customMapping?: CustomMapping }\n): void {\n  const { customMapping: mapping, ...clientConfig } = config;\n  client = createApiClient(clientConfig);\n  // Retain the resolved config for the one project-info call that deliberately\n  // uses a shorter timeout than normal translation requests.\n  configuredClientConfig = clientConfig;\n  customMapping = mapping;\n}\n\nexport const api = {\n  async queryBranchData(body: GetBranchInfoData['body']) {\n    return unwrapApiResult(await getBranchInfo({ body, client: getClient() }));\n  },\n\n  async createBranch(body: CreateBranchData['body']) {\n    return unwrapApiResult(await createBranch({ body, client: getClient() }));\n  },\n\n  async queryFileData(body: GetFileInfoData['body']) {\n    const result = unwrapApiResult(\n      await getFileInfo({\n        body: {\n          ...body,\n          translatedFiles: body.translatedFiles?.map((file) => ({\n            ...file,\n            locale: resolveCanonicalLocale(file.locale, customMapping),\n          })),\n        },\n        client: getClient(),\n      })\n    );\n    return {\n      ...result,\n      translatedFiles: result.translatedFiles.map((file) => ({\n        ...file,\n        locale: resolveAliasLocale(file.locale, customMapping),\n      })),\n      sourceFiles: result.sourceFiles.map((file) => ({\n        ...file,\n        sourceLocale: resolveAliasLocale(file.sourceLocale, customMapping),\n        locales: file.locales.map((locale) =>\n          resolveAliasLocale(locale, customMapping)\n        ),\n      })),\n    };\n  },\n\n  async checkJobStatus(jobIds: string[]) {\n    return unwrapApiResult(\n      await getTranslationJobInfo({\n        body: { jobIds },\n        client: getClient(),\n      })\n    );\n  },\n\n  async getProjectInfo(timeoutMs: number) {\n    const config = getClientConfig();\n    if (!config.projectId) {\n      throw new Error('Project ID is required to fetch project information');\n    }\n    const projectInfoClient = createApiClient({ ...config, timeoutMs });\n    return unwrapApiResult(\n      await getProjectInfo({\n        client: projectInfoClient,\n        path: { projectId: config.projectId },\n      })\n    );\n  },\n\n  resolveAliasLocale(locale: string) {\n    return resolveAliasLocale(locale, customMapping);\n  },\n\n  async downloadFileBatch(files: DownloadFilesData['body']) {\n    if (files.length === 0) return { files: [], count: 0, pending: [] };\n\n    const request = async (batch: DownloadFilesData['body']) =>\n      unwrapApiResult(\n        await downloadFiles({\n          body: batch.map((file) => ({\n            ...file,\n            locale: file.locale\n              ? resolveCanonicalLocale(file.locale, customMapping)\n              : undefined,\n          })),\n          client: getClient(),\n        })\n      );\n    const responses = await processBatches(files, async (batch) => [\n      await request(batch),\n    ]);\n    return {\n      files: responses.flatMap((response) =>\n        response.files.map((file) => ({\n          ...file,\n          ...(file.locale && {\n            locale: resolveAliasLocale(file.locale, customMapping),\n          }),\n          data: decodeFileContent(file.data, file.fileFormat),\n        }))\n      ),\n      count: responses.reduce((count, response) => count + response.count, 0),\n      pending: responses.flatMap((response) => response.pending ?? []),\n    };\n  },\n\n  async publishFiles(files: PublishFilesData['body']['files']) {\n    return unwrapApiResult(\n      await publishFiles({ body: { files }, client: getClient() })\n    );\n  },\n\n  async submitUserEditDiffs(body: SubmitUserEditDiffsData['body']) {\n    return processBatches(body.diffs, async (diffs) => [\n      unwrapApiResult(\n        await submitUserEditDiffs({\n          body: {\n            projectId: body.projectId,\n            diffs: diffs.map((diff) => ({\n              ...diff,\n              locale: resolveCanonicalLocale(diff.locale, customMapping),\n            })),\n          },\n          client: getClient(),\n        })\n      ),\n    ]);\n  },\n\n  async createTag(body: CreateTagData['body']) {\n    return unwrapApiResult(await createTag({ body, client: getClient() }));\n  },\n\n  async createProject(body: CreateProjectData['body']) {\n    return unwrapApiResult(\n      await createProject({\n        body: {\n          ...body,\n          defaultLocale: resolveCanonicalLocale(\n            body.defaultLocale,\n            customMapping\n          ),\n        },\n        client: getClient(),\n      })\n    );\n  },\n\n  // ponytail: duplicates core/src/translate/getOrphanedFiles.ts batching +\n  // intersection; delete one copy when utils/gt.ts is removed.\n  async getOrphanedFiles(branchId: string, fileIds: string[]) {\n    const request = async (batch: string[]) =>\n      unwrapApiResult(\n        await getOrphanedFiles({\n          body: { branchId, fileIds: batch },\n          client: getClient(),\n        })\n      );\n\n    if (fileIds.length === 0) return request([]);\n\n    const results = await processBatches(fileIds, async (batch) => [\n      await request(batch),\n    ]);\n    const orphanedFiles = new Map(\n      results[0].orphanedFiles.map((file) => [file.fileId, file])\n    );\n    for (const result of results.slice(1)) {\n      const batchFileIds = new Set(\n        result.orphanedFiles.map((file) => file.fileId)\n      );\n      for (const fileId of orphanedFiles.keys()) {\n        if (!batchFileIds.has(fileId)) orphanedFiles.delete(fileId);\n      }\n    }\n    return { orphanedFiles: [...orphanedFiles.values()] };\n  },\n\n  async processFileMoves(\n    moves: ProcessFileMovesData['body']['moves'],\n    options: Pick<ProcessFileMovesData['body'], 'branchId'>\n  ) {\n    const result = await processBatches(moves, async (batch) => {\n      const response = unwrapApiResult(\n        await processFileMoves({\n          body: { branchId: options.branchId, moves: batch },\n          client: getClient(),\n        })\n      );\n      return response.results;\n    });\n    const succeeded = result.filter(({ success }) => success).length;\n\n    return {\n      results: result,\n      summary: {\n        total: moves.length,\n        succeeded,\n        failed: result.length - succeeded,\n      },\n    };\n  },\n\n  async setupProject(\n    files: GenerateProjectContextData['body']['files'],\n    options: Omit<GenerateProjectContextData['body'], 'files'> = {}\n  ) {\n    return unwrapApiResult(\n      await generateProjectContext({\n        body: {\n          files: files.map(({ branchId, fileId, versionId }) => ({\n            branchId,\n            fileId,\n            versionId,\n          })),\n          locales: options.locales?.map((locale) =>\n            resolveCanonicalLocale(locale, customMapping)\n          ),\n          force: options.force,\n        },\n        client: getClient(),\n      })\n    );\n  },\n\n  async awaitJobs(jobIds: readonly string[], options?: AwaitJobsOptions) {\n    // Poll through unwrapApiResult so HTTP failures throw ApiError with the\n    // status code instead of the decoded response body.\n    return pollJobs(\n      jobIds,\n      async (pendingJobIds, signal) =>\n        unwrapApiResult(\n          await getTranslationJobInfo({\n            body: { jobIds: pendingJobIds },\n            client: getClient(),\n            signal,\n          })\n        ),\n      options\n    );\n  },\n\n  async enqueueFiles(\n    files: EnqueueFileTranslationsData['body']['files'],\n    options: {\n      sourceLocale?: string;\n      targetLocales: string[];\n      modelProvider?: string;\n      force?: boolean;\n    }\n  ) {\n    const targetLocales = options.targetLocales.map((locale) =>\n      resolveCanonicalLocale(locale, customMapping)\n    );\n    const result = await processBatches(files, async (batch) => {\n      const response = unwrapApiResult(\n        await enqueueFileTranslations({\n          body: {\n            files: batch.map(\n              ({ branchId, fileId, versionId, fileName, transformFormat }) => ({\n                branchId,\n                fileId,\n                versionId,\n                fileName,\n                transformFormat,\n              })\n            ),\n            targetLocales,\n            sourceLocale: options.sourceLocale\n              ? resolveCanonicalLocale(options.sourceLocale, customMapping)\n              : undefined,\n            // The CLI intentionally accepts custom model-provider strings beyond\n            // the OpenAPI ANTHROPIC|OPENAI|XAI|GOOGLE enum; preserve wire behavior.\n            modelProvider:\n              options.modelProvider as EnqueueFileTranslationsData['body']['modelProvider'],\n            force: options.force,\n          },\n          client: getClient(),\n        })\n      );\n      const jobData = 'jobData' in response ? response.jobData : response.data;\n      return Object.entries(jobData);\n    });\n\n    return {\n      jobData: Object.fromEntries(result),\n      locales: targetLocales,\n      message: `Successfully enqueued ${result.length} file translation jobs in ${Math.ceil(files.length / DEFAULT_BATCH_SIZE)} batch(es)`,\n    };\n  },\n\n  async uploadSourceFiles(\n    files: Array<{\n      source: UploadSourceFilesData['body']['data'][number]['source'];\n    }>,\n    options: { sourceLocale: string }\n  ) {\n    const sourceLocale = resolveCanonicalLocale(\n      options.sourceLocale,\n      customMapping\n    );\n    const result = await processBatches(files, async (batch) => {\n      const response = unwrapApiResult(\n        await uploadSourceFiles({\n          body: {\n            data: batch.map(({ source }) => ({\n              source: {\n                ...source,\n                content: encodeFileContent(source.content, source.fileFormat),\n                locale: resolveCanonicalLocale(source.locale, customMapping),\n              },\n            })),\n            sourceLocale,\n          },\n          client: getClient(),\n        })\n      );\n      return response.uploadedFiles;\n    });\n\n    return { uploadedFiles: result };\n  },\n\n  async uploadTranslations(\n    files: UploadTranslationsData['body']['data'],\n    options: { sourceLocale: string }\n  ) {\n    const result = await processBatches(files, async (batch) => {\n      const response = unwrapApiResult(\n        await uploadTranslations({\n          body: {\n            data: batch.map(({ source, translations }) => ({\n              source: {\n                ...source,\n                content: encodeFileContent(source.content, source.fileFormat),\n              },\n              translations: translations.map((translation) => ({\n                ...translation,\n                locale: resolveCanonicalLocale(\n                  translation.locale,\n                  customMapping\n                ),\n                content: encodeFileContent(\n                  translation.content,\n                  translation.fileFormat\n                ),\n              })),\n            })),\n            sourceLocale: resolveCanonicalLocale(\n              options.sourceLocale,\n              customMapping\n            ),\n          },\n          client: getClient(),\n        })\n      );\n      return response.uploadedFiles;\n    });\n\n    return { uploadedFiles: result };\n  },\n};\n\nexport type ApiClient = typeof api;\n"],"mappings":"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"}

package/dist/utils/persistPostprocessHashes.d.ts

@@ -1,12 +1,6 @@
+import type { DownloadMeta } from '../state/recentDownloads.js';
 import type { Settings } from '../types/index.js';
-type DownloadMeta = {
-    branchId: string;
-    fileId: string;
-    versionId: string;
-    locale: string;
-};
 /**
  * Persist postprocessed content hashes for recently downloaded files into gt-lock.json.
  */
 export declare function persistPostProcessHashes(settings: Settings, includeFiles: Set<string> | undefined, downloadedMeta: Map<string, DownloadMeta>): void;
-export {};

package/dist/utils/persistPostprocessHashes.js

@@ -1,4 +1,9 @@
+import { logger } from "../console/logger.js";
 import { hashStringSync } from "./hash.js";
+import { getRelative } from "../fs/findFilepath.js";
+import { fileEncodingSkipReason } from "../console/index.js";
+import { readFileContent } from "../fs/fileContent.js";
+import { recordWarning } from "../state/translateWarnings.js";
 import { findOrCreateEntry, readLockfile, writeLockfile } from "../fs/config/downloadedVersions.js";
 import * as fs$1 from "node:fs";
 //#region src/utils/persistPostprocessHashes.ts
@@ -18,7 +23,16 @@ function persistPostProcessHashes(settings, includeFiles, downloadedMeta) {
 		const meta = downloadedMeta.get(filePath);
 		if (!meta) continue;
 		if (!fs$1.existsSync(filePath)) continue;
-		const hash = hashStringSync(fs$1.readFileSync(filePath, "utf8"));
+		let hash;
+		try {
+			hash = hashStringSync(readFileContent(filePath, meta.fileFormat));
+		} catch (error) {
+			const relativePath = getRelative(filePath);
+			const reason = fileEncodingSkipReason(error);
+			logger.warn(`Skipping ${relativePath}: ${reason}`);
+			recordWarning("skipped_file", relativePath, reason);
+			continue;
+		}
 		const entry = findOrCreateEntry(entryMap, data.entries, meta.fileId, meta.versionId);
 		const existing = entry.translations[meta.locale] || {};
 		if (existing.postProcessHash !== hash) {

package/dist/utils/persistPostprocessHashes.js.map

@@ -1 +1 @@
-{"version":3,"file":"persistPostprocessHashes.js","names":["fs"],"sources":["../../src/utils/persistPostprocessHashes.ts"],"sourcesContent":["import * as fs from 'node:fs';\nimport {\n  findOrCreateEntry,\n  readLockfile,\n  writeLockfile,\n} from '../fs/config/downloadedVersions.js';\nimport { hashStringSync } from './hash.js';\nimport type { Settings } from '../types/index.js';\n\ntype DownloadMeta = {\n  branchId: string;\n  fileId: string;\n  versionId: string;\n  locale: string;\n};\n\n/**\n * Persist postprocessed content hashes for recently downloaded files into gt-lock.json.\n */\nexport function persistPostProcessHashes(\n  settings: Settings,\n  includeFiles: Set<string> | undefined,\n  downloadedMeta: Map<string, DownloadMeta>\n): void {\n  if (!includeFiles || includeFiles.size === 0 || downloadedMeta.size === 0) {\n    return;\n  }\n\n  const branchId = findDownloadedBranchId(includeFiles, downloadedMeta);\n  if (!branchId) return;\n\n  const { data, entryMap, originalV1 } = readLockfile({\n    ...settings,\n    _branchId: branchId,\n  });\n  let lockUpdated = false;\n\n  for (const filePath of includeFiles) {\n    const meta = downloadedMeta.get(filePath);\n    if (!meta) continue;\n    if (!fs.existsSync(filePath)) continue;\n\n    const content = fs.readFileSync(filePath, 'utf8');\n    const hash = hashStringSync(content);\n\n    const entry = findOrCreateEntry(\n      entryMap,\n      data.entries,\n      meta.fileId,\n      meta.versionId\n    );\n\n    const existing = entry.translations[meta.locale] || {};\n\n    if (existing.postProcessHash !== hash) {\n      entry.translations[meta.locale] = {\n        ...existing,\n        postProcessHash: hash,\n      };\n      lockUpdated = true;\n    }\n  }\n\n  if (lockUpdated) {\n    writeLockfile(data, originalV1);\n  }\n}\n\nfunction findDownloadedBranchId(\n  includeFiles: Set<string>,\n  downloadedMeta: Map<string, DownloadMeta>\n): string | undefined {\n  for (const filePath of includeFiles) {\n    const meta = downloadedMeta.get(filePath);\n    if (meta) return meta.branchId;\n  }\n  return undefined;\n}\n"],"mappings":";;;;;;;AAmBA,SAAgB,yBACd,UACA,cACA,gBACM;AACN,KAAI,CAAC,gBAAgB,aAAa,SAAS,KAAK,eAAe,SAAS,EACtE;CAGF,MAAM,WAAW,uBAAuB,cAAc,eAAe;AACrE,KAAI,CAAC,SAAU;CAEf,MAAM,EAAE,MAAM,UAAU,eAAe,aAAa;EAClD,GAAG;EACH,WAAW;EACZ,CAAC;CACF,IAAI,cAAc;AAElB,MAAK,MAAM,YAAY,cAAc;EACnC,MAAM,OAAO,eAAe,IAAI,SAAS;AACzC,MAAI,CAAC,KAAM;AACX,MAAI,CAACA,KAAG,WAAW,SAAS,CAAE;EAG9B,MAAM,OAAO,eADGA,KAAG,aAAa,UAAU,OACP,CAAC;EAEpC,MAAM,QAAQ,kBACZ,UACA,KAAK,SACL,KAAK,QACL,KAAK,UACN;EAED,MAAM,WAAW,MAAM,aAAa,KAAK,WAAW,EAAE;AAEtD,MAAI,SAAS,oBAAoB,MAAM;AACrC,SAAM,aAAa,KAAK,UAAU;IAChC,GAAG;IACH,iBAAiB;IAClB;AACD,iBAAc;;;AAIlB,KAAI,YACF,eAAc,MAAM,WAAW;;AAInC,SAAS,uBACP,cACA,gBACoB;AACpB,MAAK,MAAM,YAAY,cAAc;EACnC,MAAM,OAAO,eAAe,IAAI,SAAS;AACzC,MAAI,KAAM,QAAO,KAAK"}
+{"version":3,"file":"persistPostprocessHashes.js","names":["fs"],"sources":["../../src/utils/persistPostprocessHashes.ts"],"sourcesContent":["import * as fs from 'node:fs';\nimport {\n  findOrCreateEntry,\n  readLockfile,\n  writeLockfile,\n} from '../fs/config/downloadedVersions.js';\nimport { hashStringSync } from './hash.js';\nimport { fileEncodingSkipReason } from '../console/index.js';\nimport { logger } from '../console/logger.js';\nimport { getRelative } from '../fs/findFilepath.js';\nimport { recordWarning } from '../state/translateWarnings.js';\nimport { readFileContent } from '../fs/fileContent.js';\nimport type { DownloadMeta } from '../state/recentDownloads.js';\nimport type { Settings } from '../types/index.js';\n\n/**\n * Persist postprocessed content hashes for recently downloaded files into gt-lock.json.\n */\nexport function persistPostProcessHashes(\n  settings: Settings,\n  includeFiles: Set<string> | undefined,\n  downloadedMeta: Map<string, DownloadMeta>\n): void {\n  if (!includeFiles || includeFiles.size === 0 || downloadedMeta.size === 0) {\n    return;\n  }\n\n  const branchId = findDownloadedBranchId(includeFiles, downloadedMeta);\n  if (!branchId) return;\n\n  const { data, entryMap, originalV1 } = readLockfile({\n    ...settings,\n    _branchId: branchId,\n  });\n  let lockUpdated = false;\n\n  for (const filePath of includeFiles) {\n    const meta = downloadedMeta.get(filePath);\n    if (!meta) continue;\n    if (!fs.existsSync(filePath)) continue;\n\n    // The hash stands for the file's pipeline content, which is what every\n    // other producer and consumer of it compares against.\n    let hash: string;\n    try {\n      hash = hashStringSync(readFileContent(filePath, meta.fileFormat));\n    } catch (error) {\n      // The translation is already written; failing here would lose the whole\n      // run's lockfile update over one unreadable file. Skip it and report it\n      const relativePath = getRelative(filePath);\n      const reason = fileEncodingSkipReason(error);\n      logger.warn(`Skipping ${relativePath}: ${reason}`);\n      recordWarning('skipped_file', relativePath, reason);\n      continue;\n    }\n\n    const entry = findOrCreateEntry(\n      entryMap,\n      data.entries,\n      meta.fileId,\n      meta.versionId\n    );\n\n    const existing = entry.translations[meta.locale] || {};\n\n    if (existing.postProcessHash !== hash) {\n      entry.translations[meta.locale] = {\n        ...existing,\n        postProcessHash: hash,\n      };\n      lockUpdated = true;\n    }\n  }\n\n  if (lockUpdated) {\n    writeLockfile(data, originalV1);\n  }\n}\n\nfunction findDownloadedBranchId(\n  includeFiles: Set<string>,\n  downloadedMeta: Map<string, DownloadMeta>\n): string | undefined {\n  for (const filePath of includeFiles) {\n    const meta = downloadedMeta.get(filePath);\n    if (meta) return meta.branchId;\n  }\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;AAkBA,SAAgB,yBACd,UACA,cACA,gBACM;AACN,KAAI,CAAC,gBAAgB,aAAa,SAAS,KAAK,eAAe,SAAS,EACtE;CAGF,MAAM,WAAW,uBAAuB,cAAc,eAAe;AACrE,KAAI,CAAC,SAAU;CAEf,MAAM,EAAE,MAAM,UAAU,eAAe,aAAa;EAClD,GAAG;EACH,WAAW;EACZ,CAAC;CACF,IAAI,cAAc;AAElB,MAAK,MAAM,YAAY,cAAc;EACnC,MAAM,OAAO,eAAe,IAAI,SAAS;AACzC,MAAI,CAAC,KAAM;AACX,MAAI,CAACA,KAAG,WAAW,SAAS,CAAE;EAI9B,IAAI;AACJ,MAAI;AACF,UAAO,eAAe,gBAAgB,UAAU,KAAK,WAAW,CAAC;WAC1D,OAAO;GAGd,MAAM,eAAe,YAAY,SAAS;GAC1C,MAAM,SAAS,uBAAuB,MAAM;AAC5C,UAAO,KAAK,YAAY,aAAa,IAAI,SAAS;AAClD,iBAAc,gBAAgB,cAAc,OAAO;AACnD;;EAGF,MAAM,QAAQ,kBACZ,UACA,KAAK,SACL,KAAK,QACL,KAAK,UACN;EAED,MAAM,WAAW,MAAM,aAAa,KAAK,WAAW,EAAE;AAEtD,MAAI,SAAS,oBAAoB,MAAM;AACrC,SAAM,aAAa,KAAK,UAAU;IAChC,GAAG;IACH,iBAAiB;IAClB;AACD,iBAAc;;;AAIlB,KAAI,YACF,eAAc,MAAM,WAAW;;AAInC,SAAS,uBACP,cACA,gBACoB;AACpB,MAAK,MAAM,YAAY,cAAc;EACnC,MAAM,OAAO,eAAe,IAAI,SAAS;AACzC,MAAI,KAAM,QAAO,KAAK"}

package/dist/workflows/download.js

@@ -1,7 +1,7 @@
 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 { api } from "../utils/api.js";
 import { BranchStep } from "./steps/BranchStep.js";
 import { recordWarning } from "../state/translateWarnings.js";
 import { clearLocaleDirs } from "../fs/clearLocaleDirs.js";
@@ -24,7 +24,7 @@ import path from "node:path";
 */
 async function runDownloadWorkflow({ fileVersionData, jobData, branchData, locales, timeoutDuration, resolveOutputPath, options, inlineLibrary, forceRetranslation, forceDownload }) {
 	if (!branchData) {
-		const branchResult = await new BranchStep(gt, options).run();
+		const branchResult = await new BranchStep(api, options).run();
 		if (!branchResult) return logErrorAndExit(branchResolutionError);
 		branchData = branchResult;
 	}
@@ -41,7 +41,7 @@ async function runDownloadWorkflow({ fileVersionData, jobData, branchData, local
 	};
 	let pollTimedOut = false;
 	if (jobData) {
-		const pollResult = await new PollTranslationJobsStep(gt, inlineLibrary).run({
+		const pollResult = await new PollTranslationJobsStep(api, inlineLibrary).run({
 			fileTracker,
 			fileQueryData,
 			jobData,
@@ -65,7 +65,7 @@ async function runDownloadWorkflow({ fileVersionData, jobData, branchData, local
 		resolveOutputPath,
 		options
 	});
-	const downloadResult = await new DownloadTranslationsStep(gt, settingsForBranch, inlineLibrary).run({
+	const downloadResult = await new DownloadTranslationsStep(api, settingsForBranch, inlineLibrary).run({
 		fileTracker,
 		resolveOutputPath,
 		forceDownload