generaltranslation 9.4.2 → 9.5.0

package/dist/index.cjs

@@ -1,688 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_unwrapApiResult = require("./unwrapApiResult-Dv6Mfw_K.cjs");
-const require_runtime = require("./runtime-C25lwh9m.cjs");
-const require_derive = require("./derive-2CDqwrvS.cjs");
-const require_file = require("./file-B37WkCqM.cjs");
+const require_runtimeTranslate = require("./runtimeTranslate-DJioRjb6.cjs");
+const require_derive = require("./derive-t_E3ftJN.cjs");
+const require_runtime = require("./runtime.cjs");
 let _generaltranslation_format = require("@generaltranslation/format");
-let _generaltranslation_api = require("@generaltranslation/api");
-//#region src/translate/utils/handleFetchError.ts
-function handleFetchError(error, timeout) {
-	if (error instanceof Error && error.name === "AbortError") {
-		const errorMessage = require_runtime.translationTimeoutError(timeout);
-		require_runtime.fetchLogger.error(errorMessage);
-		throw new Error(errorMessage);
-	}
-	const errorMessage = require_runtime.translationRequestFailedError(error instanceof Error ? error.message : String(error));
-	require_runtime.fetchLogger.error(errorMessage);
-	throw error;
-}
-//#endregion
-//#region src/translate/utils/generateRequestHeaders.ts
-function generateRequestHeaders(config, excludeContentType = false) {
-	const authHeaders = {
-		...!excludeContentType && { "Content-Type": "application/json" },
-		"gt-project-id": config.projectId
-	};
-	if (config.apiKey) authHeaders["Authorization"] = `Bearer ${config.apiKey}`;
-	authHeaders["gt-api-version"] = _generaltranslation_api.API_VERSION;
-	return authHeaders;
-}
-//#endregion
-//#region src/translate/utils/apiRequest.ts
-const MAX_RETRIES = 3;
-const INITIAL_DELAY_MS = 500;
-const RATE_LIMIT_RETRY_DELAY_MS = 6e4;
-const MS_PER_SECOND = 1e3;
-function sleep(ms) {
-	return new Promise((resolve) => setTimeout(resolve, ms));
-}
-function getRetryDelay(policy, attempt) {
-	switch (policy) {
-		case "linear": return INITIAL_DELAY_MS * (attempt + 1);
-		case "exponential": return INITIAL_DELAY_MS * 2 ** attempt;
-		default: return 0;
-	}
-}
-function parseDelayMs(value) {
-	if (!value) return;
-	const seconds = Number(value.split(",")[0].split(";")[0].trim());
-	if (!Number.isFinite(seconds) || seconds < 0) return;
-	return seconds * MS_PER_SECOND;
-}
-function parseRetryAfter(value) {
-	const delayMs = parseDelayMs(value);
-	if (delayMs !== void 0) return delayMs;
-	if (!value) return;
-	const retryDate = Date.parse(value);
-	if (Number.isNaN(retryDate)) return;
-	return Math.max(retryDate - Date.now(), 0);
-}
-function getRateLimitRetryDelay(response) {
-	return parseRetryAfter(response.headers.get("Retry-After")) ?? parseDelayMs(response.headers.get("RateLimit-Reset")) ?? RATE_LIMIT_RETRY_DELAY_MS;
-}
-function getResponseRetryDelay(response, policy, attempt) {
-	if (response.status === 429) return getRateLimitRetryDelay(response);
-	return getRetryDelay(policy, attempt);
-}
-/**
-* @internal
-*
-* Makes an API request with automatic retry for 429 and 5XX errors.
-*
-* Encapsulates URL construction, fetch with timeout, error handling,
-* response validation, and JSON parsing.
-*
-* @param config - The configuration for the API call.
-* @param endpoint - The API endpoint path (e.g. '/v2/project/jobs/info')
-* @param options - Optional request options.
-* @returns The parsed JSON response.
-*/
-async function apiRequest(config, endpoint, options) {
-	const timeout = options?.timeout ?? 6e4;
-	const retryPolicy = options?.retryPolicy ?? "exponential";
-	const url = `${config.baseUrl || "https://api.gtx.dev"}${endpoint}`;
-	const method = options?.method ?? "POST";
-	const maxRetries = retryPolicy === "none" ? 0 : MAX_RETRIES;
-	const requestInit = {
-		method,
-		headers: generateRequestHeaders(config)
-	};
-	if (options?.body !== void 0) requestInit.body = JSON.stringify(options.body);
-	for (let attempt = 0; attempt <= maxRetries; attempt++) {
-		let response;
-		try {
-			response = await require_runtime.fetchWithTimeout(url, requestInit, timeout);
-		} catch (error) {
-			if (attempt < maxRetries) {
-				await sleep(getRetryDelay(retryPolicy, attempt));
-				continue;
-			}
-			handleFetchError(error, timeout);
-		}
-		if ((response.status === 429 || response.status >= 500) && attempt < maxRetries) {
-			await sleep(getResponseRetryDelay(response, retryPolicy, attempt));
-			continue;
-		}
-		await require_runtime.validateResponse(response);
-		return await response.json();
-	}
-	throw new Error("Max retries exceeded");
-}
-//#endregion
-//#region src/translate/setupProject.ts
-/**
-* @internal
-* Enqueues files for project setup the General Translation API.
-* @param files - References of files to translate (file content already uploaded)
-* @param config - The configuration for the API call.
-* @param timeoutMS - The timeout in milliseconds
-* @returns The result of the API call.
-*/
-async function _setupProject(files, config, options) {
-	return apiRequest(config, "/v2/project/setup/generate", {
-		body: {
-			files: files.map((f) => ({
-				branchId: f.branchId,
-				fileId: f.fileId,
-				versionId: f.versionId
-			})),
-			locales: options?.locales,
-			force: options?.force
-		},
-		timeout: options?.timeoutMs
-	});
-}
-//#endregion
-//#region src/translate/utils/batch.ts
-/**
-* Splits an array into batches of a specified size.
-* @param items - The array to split into batches.
-* @param batchSize - The maximum size of each batch.
-* @returns An array of batches.
-*/
-function createBatches(items, batchSize) {
-	const batches = [];
-	for (let i = 0; i < items.length; i += batchSize) batches.push(items.slice(i, i + batchSize));
-	return batches;
-}
-/**
-* Processes items in batches using a provided processor function.
-*
-* @param items - The items to process.
-* @param processor - Async function that processes a single batch and returns items.
-* @param options - Optional configuration for batch processing.
-* @returns Promise that resolves to a BatchList containing all processed items.
-*
-* @example
-* ```typescript
-* const result = await processBatches(
-*   files,
-*   async (batch) => {
-*     const response = await uploadFiles(batch);
-*     return response.uploadedFiles;
-*   },
-*   { batchSize: 100 }
-* );
-*
-* console.log(result.data); // All items
-* console.log(result.count); // Total count
-* console.log(result.batchCount); // Number of batches processed
-* ```
-*/
-async function processBatches(items, processor, options = {}) {
-	const { batchSize = 100, parallel = true } = options;
-	if (items.length === 0) return {
-		data: [],
-		count: 0,
-		batchCount: 0
-	};
-	const batches = createBatches(items, batchSize);
-	const allItems = [];
-	if (parallel) {
-		const results = await Promise.all(batches.map((batch) => processor(batch)));
-		for (const result of results) if (result) allItems.push(...result);
-	} else for (const batch of batches) {
-		const result = await processor(batch);
-		if (result) allItems.push(...result);
-	}
-	return {
-		data: allItems,
-		count: allItems.length,
-		batchCount: batches.length
-	};
-}
-//#endregion
-//#region src/translate/utils/validateFileFormatTransform.ts
-/**
-* Returns a user-facing validation error when a requested file format transform
-* is missing source format context or is not currently supported.
-*/
-function getFileFormatTransformError(file) {
-	if (!file.transformFormat) return void 0;
-	const fileLabel = file.fileName ?? file.fileId ?? "unknown file";
-	if (!file.fileFormat) return `fileFormat is required when transformFormat is provided for ${fileLabel}`;
-	if (!require_derive.isSupportedFileFormatTransform(file.fileFormat, file.transformFormat)) return `Unsupported file format transform: ${file.fileFormat} -> ${file.transformFormat}`;
-}
-/**
-* Validates file format transforms before sending upload/enqueue requests.
-*/
-function validateFileFormatTransforms(files) {
-	for (const file of files) {
-		const error = getFileFormatTransformError(file);
-		if (error) throw new Error(error);
-	}
-}
-//#endregion
-//#region src/translate/enqueueFiles.ts
-/**
-* @internal
-* Enqueues files for translation in the General Translation API.
-* @param files - References of files to translate (file content already uploaded)
-* @param options - The options for the API call.
-* @param config - The configuration for the API call.
-* @returns The result of the API call.
-*/
-async function _enqueueFiles(files, options, config) {
-	validateFileFormatTransforms(files);
-	const result = await processBatches(files, async (batch) => {
-		const apiResult = await apiRequest(config, "/v2/project/translations/enqueue", {
-			body: {
-				files: batch.map((f) => ({
-					branchId: f.branchId,
-					fileId: f.fileId,
-					versionId: f.versionId,
-					fileName: f.fileName,
-					transformFormat: f.transformFormat
-				})),
-				targetLocales: options.targetLocales,
-				sourceLocale: options.sourceLocale,
-				modelProvider: options.modelProvider,
-				force: options.force
-			},
-			timeout: options.timeout
-		});
-		return Array.from(Object.entries(apiResult.jobData));
-	}, { batchSize: 100 });
-	return {
-		jobData: Object.fromEntries(result.data.map(([jobId, jobData]) => [jobId, jobData])),
-		locales: options.targetLocales,
-		message: `Successfully enqueued ${result.count} file translation jobs in ${result.batchCount} batch(es)`
-	};
-}
-//#endregion
-//#region src/translate/createTag.ts
-/**
-* @internal
-* Creates or upserts a file tag in the General Translation API.
-* @param options - The tag creation options.
-* @param config - The configuration for the API call.
-* @returns The created or updated tag.
-*/
-async function _createTag(options, config) {
-	return await apiRequest(config, "/v2/project/tags/create", { body: {
-		tagId: options.tagId,
-		files: options.files,
-		...options.message && { message: options.message }
-	} });
-}
-//#endregion
-//#region src/translate/downloadFileBatch.ts
-/**
-* @internal
-* Downloads multiple translation files in batches.
-* @param files - Array of files to download
-* @param options - The options for the API call.
-* @param config - The configuration for the request.
-* @returns Promise resolving to a BatchList with all downloaded files
-*/
-async function _downloadFileBatch(requests, options, config) {
-	return processBatches(requests, async (batch) => {
-		return (await apiRequest(config, "/v2/project/files/download", {
-			body: batch,
-			timeout: options.timeout
-		})).files.map((file) => ({
-			...file,
-			data: require_file.isBinaryFileFormat(file.fileFormat) ? file.data : require_derive.decode(file.data)
-		}));
-	}, { batchSize: 100 });
-}
-//#endregion
-//#region src/translate/submitUserEditDiffs.ts
-/**
-* @internal
-* Submits user edit diffs so the service can learn/persist user-intended rules.
-*/
-async function _submitUserEditDiffs(payload, config, options = {}) {
-	await processBatches(payload.diffs, async (batch) => {
-		await apiRequest(config, "/v2/project/files/diffs", {
-			body: { diffs: batch },
-			timeout: options.timeout
-		});
-		return [{ success: true }];
-	}, { batchSize: 100 });
-	return { success: true };
-}
-//#endregion
-//#region src/translate/uploadSourceFiles.ts
-/**
-* @internal
-* Uploads source files to the General Translation API in batches.
-* @param files - The files to upload.
-* @param options - The options for the API call.
-* @param config - The configuration for the API call.
-* @returns Promise resolving to a BatchList with all uploaded files
-*/
-async function _uploadSourceFiles(files, options, config) {
-	return processBatches(files, async (batch) => {
-		return (await apiRequest(config, "/v2/project/files/upload-files", {
-			body: {
-				data: batch.map(({ source }) => ({ source: {
-					content: require_file.isBinaryFileFormat(source.fileFormat) ? source.content : require_derive.encode(source.content),
-					fileName: source.fileName,
-					fileFormat: source.fileFormat,
-					locale: source.locale,
-					dataFormat: source.dataFormat,
-					formatMetadata: source.formatMetadata,
-					fileId: source.fileId,
-					versionId: source.versionId,
-					branchId: source.branchId,
-					incomingBranchId: source.incomingBranchId,
-					checkedOutBranchId: source.checkedOutBranchId
-				} })),
-				sourceLocale: options.sourceLocale
-			},
-			timeout: options.timeout
-		})).uploadedFiles || [];
-	}, { batchSize: 100 });
-}
-//#endregion
-//#region src/translate/uploadFonts.ts
-const FONT_UPLOAD_BATCH_SIZE = 50;
-/**
-* @internal
-* Uploads project fonts to the General Translation API in batches. Idempotent
-* on the server (re-running only stores genuinely new fonts). `content` is
-* already base64-encoded by the caller (fonts are binary).
-*/
-async function _uploadFonts(fonts, options, config) {
-	return processBatches(fonts, async (batch) => {
-		return (await apiRequest(config, "/v2/project/assets", {
-			body: { assets: batch.map((font) => ({
-				assetType: font.assetType,
-				content: font.content,
-				fileName: font.fileName
-			})) },
-			timeout: options.timeout
-		})).assets || [];
-	}, { batchSize: FONT_UPLOAD_BATCH_SIZE });
-}
-//#endregion
-//#region src/translate/uploadTranslations.ts
-/**
-* @internal
-* Uploads multiple translations to the General Translation API in batches.
-* @param files - Translations to upload with their source
-* @param options - The options for the API call.
-* @param config - The configuration for the API call.
-* @returns Promise resolving to a BatchList with all uploaded files
-*/
-async function _uploadTranslations(files, options, config) {
-	validateFileFormatTransforms(files.map(({ source }) => source));
-	return processBatches(files, async (batch) => {
-		return (await apiRequest(config, "/v2/project/files/upload-translations", {
-			body: {
-				data: batch.map(({ source, translations }) => ({
-					source: {
-						content: require_file.isBinaryFileFormat(source.fileFormat) ? source.content : require_derive.encode(source.content),
-						fileName: source.fileName,
-						fileFormat: source.fileFormat,
-						transformFormat: source.transformFormat,
-						locale: source.locale,
-						dataFormat: source.dataFormat,
-						formatMetadata: source.formatMetadata,
-						fileId: source.fileId,
-						versionId: source.versionId,
-						branchId: source.branchId
-					},
-					translations: translations.map((t) => ({
-						content: require_file.isBinaryFileFormat(t.fileFormat) ? t.content : require_derive.encode(t.content),
-						fileName: t.fileName,
-						fileFormat: t.fileFormat,
-						locale: t.locale,
-						dataFormat: t.dataFormat,
-						fileId: t.fileId,
-						versionId: t.versionId,
-						branchId: t.branchId
-					}))
-				})),
-				sourceLocale: options.sourceLocale
-			},
-			timeout: options.timeout
-		})).uploadedFiles || [];
-	}, { batchSize: 100 });
-}
-//#endregion
-//#region src/translate/querySourceFile.ts
-/**
-* @internal
-* Gets the source file and translation information for a given file ID and version ID.
-* @param query - The file ID and version ID to get the source file and translation information for
-* @param options - The options for the API call.
-* @param config - The configuration for the request.
-* @returns The source file and translation information for the given file ID and version ID
-*/
-async function _querySourceFile(query, options, config) {
-	const branchId = query.branchId;
-	const versionId = query.versionId;
-	const fileId = query.fileId;
-	const searchParams = new URLSearchParams();
-	if (branchId) searchParams.set("branchId", branchId);
-	if (versionId) searchParams.set("versionId", versionId);
-	return apiRequest(config, `/v2/project/translations/files/status/${encodeURIComponent(fileId)}?${searchParams.toString()}`, {
-		method: "GET",
-		timeout: options.timeout
-	});
-}
-//#endregion
-//#region src/projects/getProjectData.ts
-/**
-* @internal
-* Gets the project data for a given project ID.
-* @param projectId - The project ID to get the project data for
-* @param options - The options for the API call.
-* @param config - The configuration for the request.
-* @returns The project data for the given project ID.
-*/
-async function _getProjectData(projectId, options, config) {
-	const { baseUrl } = config;
-	const timeout = options.timeout ? options.timeout : require_unwrapApiResult.defaultTimeout;
-	const url = `${baseUrl || "https://api.gtx.dev"}/v2/project/info/${encodeURIComponent(projectId)}`;
-	let response;
-	try {
-		response = await require_runtime.fetchWithTimeout(url, {
-			method: "GET",
-			headers: generateRequestHeaders(config)
-		}, timeout);
-	} catch (error) {
-		handleFetchError(error, timeout);
-	}
-	await require_runtime.validateResponse(response);
-	return await response.json();
-}
-//#endregion
-//#region src/translate/checkJobStatus.ts
-/**
-* @internal
-* Queries job statuses for a project.
-* @param jobIds - Job IDs.
-* @param config - The configuration for the API call.
-* @param timeoutMs - The timeout in milliseconds.
-* @returns The result of the API call.
-*/
-async function _checkJobStatus(jobIds, config, timeoutMs) {
-	return apiRequest(config, "/v2/project/jobs/info", {
-		body: { jobIds },
-		timeout: timeoutMs
-	});
-}
-//#endregion
-//#region src/translate/awaitJobs.ts
-/**
-* @internal
-* Polls job statuses until all jobs are finished or the timeout is reached.
-* @param jobIds - Job IDs to poll.
-* @param options - Polling configuration.
-* @param config - API credentials and configuration.
-* @returns The final status of all jobs.
-*/
-async function _awaitJobIds(jobIds, options, config) {
-	const pollingInterval = (options?.pollingIntervalSeconds ?? 5) * 1e3;
-	const timeout = options?.timeoutSeconds !== void 0 ? options.timeoutSeconds * 1e3 : 600 * 1e3;
-	if (jobIds.length === 0) return {
-		complete: true,
-		jobs: []
-	};
-	const deadline = Date.now() + timeout;
-	const finalStatuses = new Map(jobIds.map((id) => [id, {
-		jobId: id,
-		status: "unknown"
-	}]));
-	const pendingJobIds = new Set(jobIds);
-	while (pendingJobIds.size > 0) {
-		const remainingTime = deadline - Date.now();
-		if (remainingTime <= 0) break;
-		let statuses;
-		try {
-			statuses = await _checkJobStatus(Array.from(pendingJobIds), config, Math.min(remainingTime, require_unwrapApiResult.defaultTimeout));
-		} catch (error) {
-			if (Date.now() >= deadline) break;
-			throw error;
-		}
-		if (Date.now() >= deadline) break;
-		const returnedJobIds = new Set(statuses.map(({ jobId }) => jobId));
-		for (const job of statuses) if (job.status === "completed" || job.status === "failed" || job.status === "unknown") {
-			finalStatuses.set(job.jobId, {
-				jobId: job.jobId,
-				status: job.status,
-				...job.error ? { error: job.error } : {}
-			});
-			pendingJobIds.delete(job.jobId);
-		} else finalStatuses.set(job.jobId, {
-			jobId: job.jobId,
-			status: job.status
-		});
-		for (const jobId of Array.from(pendingJobIds)) if (!returnedJobIds.has(jobId)) {
-			finalStatuses.set(jobId, {
-				jobId,
-				status: "unknown"
-			});
-			pendingJobIds.delete(jobId);
-		}
-		if (pendingJobIds.size === 0) break;
-		const remainingSleepTime = deadline - Date.now();
-		if (remainingSleepTime <= 0) break;
-		await new Promise((resolve) => setTimeout(resolve, Math.min(pollingInterval, remainingSleepTime)));
-	}
-	return {
-		complete: pendingJobIds.size === 0,
-		jobs: Array.from(finalStatuses.values())
-	};
-}
-//#endregion
-//#region src/translate/queryFileData.ts
-/**
-* @internal
-* Queries data about one or more source or translation files.
-* @param data - Object mapping source or translation file information
-* @param options - The options for the API call.
-* @param config - The configuration for the API call.
-* @returns The file data.
-*/
-async function _queryFileData(data, options = {}, config) {
-	return apiRequest(config, "/v2/project/files/info", {
-		body: {
-			sourceFiles: data.sourceFiles?.map((item) => ({
-				fileId: item.fileId,
-				versionId: item.versionId,
-				branchId: item.branchId
-			})),
-			translatedFiles: data.translatedFiles?.map((item) => ({
-				fileId: item.fileId,
-				versionId: item.versionId,
-				branchId: item.branchId,
-				locale: item.locale
-			}))
-		},
-		timeout: options.timeout
-	});
-}
-//#endregion
-//#region src/translate/getProjectInfo.ts
-/**
-* @internal
-* Fetches project info (name, locales, review settings) for a project.
-* @param options - The options for the API call.
-* @param config - The configuration for the API call.
-* @returns The project info.
-*/
-async function _getProjectInfo(options, config) {
-	return apiRequest(config, `/v2/project/info/${config.projectId}`, {
-		method: "GET",
-		timeout: options.timeout
-	});
-}
-//#endregion
-//#region src/translate/queryBranchData.ts
-/**
-* @internal
-* Queries branch information from the API.
-* @param query - Object mapping the current branch and incoming branches
-* @param config - The configuration for the API call.
-* @returns The branch information.
-*/
-async function _queryBranchData(query, config) {
-	return apiRequest(config, "/v2/project/branches/info", { body: query });
-}
-//#endregion
-//#region src/translate/createBranch.ts
-/**
-* @internal
-* Creates a new branch in the API.
-* @param query - Object mapping the branch name and default branch flag
-* @param config - The configuration for the API call.
-* @returns The created branch information.
-*/
-async function _createBranch(query, config) {
-	return apiRequest(config, "/v2/project/branches/create", { body: query });
-}
-//#endregion
-//#region src/translate/processFileMoves.ts
-/**
-* @internal
-* Processes file moves by cloning source files and translations with new fileIds.
-* Called when the CLI detects that files have been moved/renamed.
-* @param moves - Array of move mappings (old fileId to new fileId)
-* @param options - Options including branchId and timeout
-* @param config - The configuration for the API call.
-* @returns Promise resolving to the move results
-*/
-async function _processFileMoves(moves, options, config) {
-	if (moves.length === 0) return {
-		results: [],
-		summary: {
-			total: 0,
-			succeeded: 0,
-			failed: 0
-		}
-	};
-	const batchResult = await processBatches(moves, async (batch) => {
-		return (await apiRequest(config, "/v2/project/files/moves", {
-			body: {
-				branchId: options.branchId,
-				moves: batch
-			},
-			timeout: options.timeout
-		})).results;
-	}, { batchSize: 100 });
-	const succeeded = batchResult.data.filter((r) => r.success).length;
-	const failed = batchResult.data.filter((r) => !r.success).length;
-	return {
-		results: batchResult.data,
-		summary: {
-			total: moves.length,
-			succeeded,
-			failed
-		}
-	};
-}
-//#endregion
-//#region src/translate/getOrphanedFiles.ts
-/**
-* @internal
-* Gets orphaned files for a branch - files that exist on the branch
-* but whose fileIds are not in the provided list.
-* Used for move detection.
-* @param branchId - The branch to check for orphaned files
-* @param fileIds - List of current file IDs (files that are NOT orphaned)
-* @param options - The options for the API call
-* @param config - The configuration for the API call
-* @returns The orphaned files
-*/
-async function _getOrphanedFiles(branchId, fileIds, options = {}, config) {
-	const makeRequest = (batchFileIds) => apiRequest(config, "/v2/project/files/orphaned", {
-		body: {
-			branchId,
-			fileIds: batchFileIds
-		},
-		timeout: options.timeout
-	});
-	if (fileIds.length === 0) return makeRequest([]);
-	const batches = createBatches(fileIds, 100);
-	const batchResults = await Promise.all(batches.map((batch) => makeRequest(batch)));
-	if (batchResults.length === 1) return batchResults[0];
-	const orphanedFileMap = /* @__PURE__ */ new Map();
-	for (const orphan of batchResults[0].orphanedFiles) orphanedFileMap.set(orphan.fileId, orphan);
-	for (let i = 1; i < batchResults.length; i++) {
-		const batchOrphanIds = new Set(batchResults[i].orphanedFiles.map((f) => f.fileId));
-		Array.from(orphanedFileMap.keys()).forEach((fileId) => {
-			if (!batchOrphanIds.has(fileId)) orphanedFileMap.delete(fileId);
-		});
-	}
-	return { orphanedFiles: Array.from(orphanedFileMap.values()) };
-}
-//#endregion
-//#region src/translate/publishFiles.ts
-/**
-* @internal
-* Publishes or unpublishes files on the CDN.
-* @param files - Array of file entries with publish flags
-* @param config - The configuration for the API call.
-* @returns The result of the API call.
-*/
-async function _publishFiles(files, config) {
-	return await apiRequest(config, "/v2/project/files/publish", { body: { files } });
-}
-//#endregion
 //#region src/index.ts
 /**
 * GT is the core driver for the General Translation library.
@@ -704,6 +24,23 @@ async function _publishFiles(files, config) {
 * });
 */
 var GT = class extends require_runtime.GTRuntime {
+	setConfig(params) {
+		try {
+			super.setConfig(params);
+		} finally {
+			this._apiAdapter = void 0;
+		}
+	}
+	_getApiAdapter() {
+		this._apiAdapter ??= require_derive.createGtApiAdapter({
+			apiKey: this.apiKey || this.devApiKey,
+			userTokenProvider: this.userTokenProvider,
+			baseUrl: this.baseUrl || "https://api.gtx.dev",
+			projectId: this.projectId,
+			customMapping: this.customMapping
+		});
+		return this._apiAdapter;
+	}
 	/**
 	* Queries branch information from the API.
 	*
@@ -711,8 +48,8 @@ var GT = class extends require_runtime.GTRuntime {
 	* @returns {Promise<BranchDataResult>} The branch information.
 	*/
 	async queryBranchData(query) {
-		this._validateAuth("queryBranchData");
-		return await _queryBranchData(query, this._getTranslationConfig());
+		require_runtimeTranslate.validateAuth("queryBranchData", this._getTranslationConfig());
+		return await this._getApiAdapter().queryBranchData(query);
 	}
 	/**
 	* Creates a new branch in the API. If the branch already exists, it will be returned.
@@ -721,8 +58,8 @@ var GT = class extends require_runtime.GTRuntime {
 	* @returns {Promise<CreateBranchResult>} The created branch information.
 	*/
 	async createBranch(query) {
-		this._validateAuth("createBranch");
-		return await _createBranch(query, this._getTranslationConfig());
+		require_runtimeTranslate.validateAuth("createBranch", this._getTranslationConfig());
+		return await this._getApiAdapter().createBranch(query);
 	}
 	/**
 	* Processes file moves by cloning source files and translations with new fileIds.
@@ -738,8 +75,8 @@ var GT = class extends require_runtime.GTRuntime {
 	* ], { branchId: 'main' });
 	*/
 	async processFileMoves(moves, options = {}) {
-		this._validateAuth("processFileMoves");
-		return await _processFileMoves(moves, options, this._getTranslationConfig());
+		require_runtimeTranslate.validateAuth("processFileMoves", this._getTranslationConfig());
+		return await this._getApiAdapter().processFileMoves(moves, options);
 	}
 	/**
 	* Gets orphaned files for a branch - files that exist on the branch
@@ -755,8 +92,8 @@ var GT = class extends require_runtime.GTRuntime {
 	* const result = await gt.getOrphanedFiles('branch-id', ['file-1', 'file-2']);
 	*/
 	async getOrphanedFiles(branchId, fileIds, options = {}) {
-		this._validateAuth("getOrphanedFiles");
-		return await _getOrphanedFiles(branchId, fileIds, options, this._getTranslationConfig());
+		require_runtimeTranslate.validateAuth("getOrphanedFiles", this._getTranslationConfig());
+		return await this._getApiAdapter().getOrphanedFiles(branchId, fileIds, options);
 	}
 	/**
 	* Enqueues project setup job using the specified file references
@@ -771,12 +108,12 @@ var GT = class extends require_runtime.GTRuntime {
 	* @returns {Promise<SetupProjectResult>} Object containing the jobId and status
 	*/
 	async setupProject(files, options) {
-		this._validateAuth("setupProject");
+		require_runtimeTranslate.validateAuth("setupProject", this._getTranslationConfig());
 		options = {
 			...options,
 			locales: options?.locales?.map((locale) => this.resolveServiceLocale(locale))
 		};
-		return await _setupProject(files, this._getTranslationConfig(), options);
+		return await this._getApiAdapter().setupProject(files, options);
 	}
 	/**
 	* Checks the current status of one or more project jobs by their unique identifiers.
@@ -795,8 +132,8 @@ var GT = class extends require_runtime.GTRuntime {
 	* ], 10000);
 	*/
 	async checkJobStatus(jobIds, timeoutMs) {
-		this._validateAuth("checkJobStatus");
-		return await _checkJobStatus(jobIds, this._getTranslationConfig(), timeoutMs);
+		require_runtimeTranslate.validateAuth("checkJobStatus", this._getTranslationConfig());
+		return await this._getApiAdapter().checkJobStatus(jobIds, timeoutMs);
 	}
 	/**
 	* Polls job statuses until all jobs are finished or the timeout is reached.
@@ -806,8 +143,9 @@ var GT = class extends require_runtime.GTRuntime {
 	* @returns {Promise<AwaitJobsResult>} The final status of all jobs and whether they all completed.
 	*/
 	async awaitJobs(jobs, options) {
-		this._validateAuth("awaitJobs");
-		return await _awaitJobIds(Array.isArray(jobs) ? jobs : Object.keys(jobs.jobData), options, this._getTranslationConfig());
+		require_runtimeTranslate.validateAuth("awaitJobs", this._getTranslationConfig());
+		const jobIds = Array.isArray(jobs) ? jobs : Object.keys(jobs.jobData);
+		return await this._getApiAdapter().awaitJobs(jobIds, options);
 	}
 	/**
 	* Enqueues translation jobs for previously uploaded source files.
@@ -823,20 +161,20 @@ var GT = class extends require_runtime.GTRuntime {
 	* @returns {Promise<EnqueueFilesResult>} Result containing job IDs, queue status, and processing information.
 	*/
 	async enqueueFiles(files, options) {
-		this._validateAuth("enqueueFiles");
+		require_runtimeTranslate.validateAuth("enqueueFiles", this._getTranslationConfig());
 		let mergedOptions = {
 			...options,
 			sourceLocale: options.sourceLocale ?? this.sourceLocale,
 			targetLocales: options.targetLocales ?? [this.targetLocale]
 		};
 		if (!mergedOptions.sourceLocale) {
-			const error = require_runtime.noSourceLocaleProvidedError("enqueueFiles");
-			require_runtime.gtInstanceLogger.error(error);
+			const error = require_runtimeTranslate.noSourceLocaleProvidedError("enqueueFiles");
+			require_runtimeTranslate.gtInstanceLogger.error(error);
 			throw new Error(error);
 		}
 		if (!mergedOptions.targetLocales || mergedOptions.targetLocales.length === 0) {
-			const error = require_runtime.noTargetLocaleProvidedError("enqueueFiles");
-			require_runtime.gtInstanceLogger.error(error);
+			const error = require_runtimeTranslate.noTargetLocaleProvidedError("enqueueFiles");
+			require_runtimeTranslate.gtInstanceLogger.error(error);
 			throw new Error(error);
 		}
 		const targetLocaleIdentities = [...mergedOptions.targetLocales];
@@ -846,7 +184,7 @@ var GT = class extends require_runtime.GTRuntime {
 			targetLocales: mergedOptions.targetLocales.map((locale) => this.resolveServiceLocale(locale))
 		};
 		return {
-			...await _enqueueFiles(files, mergedOptions, this._getTranslationConfig()),
+			...await this._getApiAdapter().enqueueFiles(files, mergedOptions),
 			locales: targetLocaleIdentities
 		};
 	}
@@ -858,8 +196,8 @@ var GT = class extends require_runtime.GTRuntime {
 	* @returns {Promise<CreateTagResult>} The created or updated tag.
 	*/
 	async createTag(options) {
-		this._validateAuth("createTag");
-		return await _createTag(options, this._getTranslationConfig());
+		require_runtimeTranslate.validateAuth("createTag", this._getTranslationConfig());
+		return await this._getApiAdapter().createTag(options);
 	}
 	/**
 	* Publishes or unpublishes files on the CDN.
@@ -868,8 +206,8 @@ var GT = class extends require_runtime.GTRuntime {
 	* @returns {Promise<PublishFilesResult>} Result containing per-file success/failure
 	*/
 	async publishFiles(files) {
-		this._validateAuth("publishFiles");
-		return { results: (await _publishFiles(files, this._getTranslationConfig())).results.map((item) => ({
+		require_runtimeTranslate.validateAuth("publishFiles", this._getTranslationConfig());
+		return { results: (await this._getApiAdapter().publishFiles(files)).results.map((item) => ({
 			...item,
 			...item.locale && { locale: this.resolveServiceResponseLocale(item.locale) }
 		})) };
@@ -881,14 +219,15 @@ var GT = class extends require_runtime.GTRuntime {
 	* @returns {Promise<void>} Resolves when submission succeeds.
 	*/
 	async submitUserEditDiffs(payload) {
-		this._validateAuth("submitUserEditDiffs");
-		await _submitUserEditDiffs({
+		require_runtimeTranslate.validateAuth("submitUserEditDiffs", this._getTranslationConfig());
+		const normalized = {
 			...payload,
 			diffs: (payload.diffs || []).map((d) => ({
 				...d,
 				locale: this.resolveServiceLocale(d.locale)
 			}))
-		}, this._getTranslationConfig());
+		};
+		await this._getApiAdapter().submitUserEditDiffs(normalized);
 	}
 	/**
 	* Queries data about one or more source or translation files.
@@ -917,8 +256,8 @@ var GT = class extends require_runtime.GTRuntime {
 	* @returns The project info.
 	*/
 	async getProjectInfo(options = {}) {
-		this._validateAuth("getProjectInfo");
-		const result = await _getProjectInfo(options, this._getTranslationConfig());
+		require_runtimeTranslate.validateAuth("getProjectInfo", this._getTranslationConfig());
+		const result = await this._getApiAdapter().getProjectInfo(void 0, options.timeout);
 		return {
 			...result,
 			defaultLocale: this.resolveServiceResponseLocale(result.defaultLocale),
@@ -926,12 +265,12 @@ var GT = class extends require_runtime.GTRuntime {
 		};
 	}
 	async queryFileData(data, options = {}) {
-		this._validateAuth("queryFileData");
+		require_runtimeTranslate.validateAuth("queryFileData", this._getTranslationConfig());
 		data.translatedFiles = data.translatedFiles?.map((item) => ({
 			...item,
 			locale: this.resolveServiceLocale(item.locale)
 		}));
-		const result = await _queryFileData(data, options, this._getTranslationConfig());
+		const result = await this._getApiAdapter().queryFileData(data, options.timeout);
 		result.translatedFiles = result.translatedFiles?.map((item) => ({
 			...item,
 			...item.locale && { locale: this.resolveServiceResponseLocale(item.locale) }
@@ -958,8 +297,11 @@ var GT = class extends require_runtime.GTRuntime {
 	*
 	*/
 	async querySourceFile(data, options = {}) {
-		this._validateAuth("querySourceFile");
-		const result = await _querySourceFile(data, options, this._getTranslationConfig());
+		require_runtimeTranslate.validateAuth("querySourceFile", this._getTranslationConfig());
+		const result = await this._getApiAdapter().querySourceFile({ fileId: data.fileId }, {
+			branchId: data.branchId,
+			versionId: data.versionId
+		}, options.timeout);
 		result.translations = result.translations.map((item) => ({
 			...item,
 			...item.locale && { locale: this.resolveServiceResponseLocale(item.locale) }
@@ -971,6 +313,9 @@ var GT = class extends require_runtime.GTRuntime {
 	/**
 	* Get project data for a given project ID.
 	*
+	* @deprecated Use `getProjectInfo()` on a `GT` instance configured with the
+	* target `projectId`; it reads the same resource and also returns
+	* `autoApprove`. This method will be removed in the next major version.
 	* @param {string} projectId - The ID of the project to get the data for.
 	* @returns {Promise<ProjectData>} The project data.
 	*
@@ -981,11 +326,13 @@ var GT = class extends require_runtime.GTRuntime {
 	*
 	*/
 	async getProjectData(projectId, options = {}) {
-		this._validateAuth("getProjectData");
-		const result = await _getProjectData(projectId, options, this._getTranslationConfig());
-		result.currentLocales = result.currentLocales.map((item) => this.resolveServiceResponseLocale(item));
-		result.defaultLocale = this.resolveServiceResponseLocale(result.defaultLocale);
-		return result;
+		require_runtimeTranslate.validateAuth("getProjectData", this._getTranslationConfig());
+		const { autoApprove: _autoApprove, ...project } = await this._getApiAdapter().getProjectInfo(projectId, options.timeout);
+		return {
+			...project,
+			defaultLocale: this.resolveServiceResponseLocale(project.defaultLocale),
+			currentLocales: project.currentLocales.map((item) => this.resolveServiceResponseLocale(item))
+		};
 	}
 	/**
 	* Downloads a single file.
@@ -1009,14 +356,11 @@ var GT = class extends require_runtime.GTRuntime {
 	* });
 	*/
 	async downloadFile(file, options = {}) {
-		this._validateAuth("downloadTranslatedFile");
-		return (await _downloadFileBatch([{
-			fileId: file.fileId,
-			branchId: file.branchId,
-			locale: file.locale ? this.resolveServiceLocale(file.locale) : void 0,
-			versionId: file.versionId,
-			useLatestAvailableVersion: file.useLatestAvailableVersion
-		}], options, this._getTranslationConfig())).data?.[0]?.data ?? "";
+		require_runtimeTranslate.validateAuth("downloadTranslatedFile", this._getTranslationConfig());
+		return (await this._getApiAdapter().downloadFileBatch([{
+			...file,
+			locale: file.locale ? this.resolveServiceLocale(file.locale) : void 0
+		}], options)).files[0]?.data ?? "";
 	}
 	/**
 	* Downloads multiple files in a batch.
@@ -1035,7 +379,7 @@ var GT = class extends require_runtime.GTRuntime {
 	* });
 	*/
 	async downloadFileBatch(requests, options = {}) {
-		this._validateAuth("downloadFileBatch");
+		require_runtimeTranslate.validateAuth("downloadFileBatch", this._getTranslationConfig());
 		const requestedFiles = /* @__PURE__ */ new Map();
 		requests = requests.map((request) => {
 			const locale = request.locale ? this.resolveServiceLocale(request.locale) : void 0;
@@ -1050,11 +394,11 @@ var GT = class extends require_runtime.GTRuntime {
 				locale
 			};
 		});
-		const result = await _downloadFileBatch(requests, options, this._getTranslationConfig());
+		const result = await this._getApiAdapter().downloadFileBatch(requests, options);
 		return {
-			files: result.data.map((file) => {
+			files: result.files.map((file) => {
 				if (!file.locale) return file;
-				const serviceLocale = this.standardizeLocale(file.locale);
+				const serviceLocale = this.resolveServiceLocale(file.locale);
 				const matchingRequests = (requestedFiles.get(JSON.stringify([file.fileId, serviceLocale])) ?? []).filter((request) => (!request.branchId || request.branchId === file.branchId) && (!request.versionId || request.versionId === file.versionId));
 				return {
 					...file,
@@ -1077,7 +421,7 @@ var GT = class extends require_runtime.GTRuntime {
 	* @returns {Promise<UploadFilesResponse>} Upload result containing file IDs, version information, and upload status.
 	*/
 	async uploadSourceFiles(files, options) {
-		this._validateAuth("uploadSourceFiles");
+		require_runtimeTranslate.validateAuth("uploadSourceFiles", this._getTranslationConfig());
 		const mergedOptions = {
 			...options,
 			sourceLocale: this.resolveServiceLocale(options.sourceLocale ?? this.sourceLocale ?? "en")
@@ -1089,11 +433,11 @@ var GT = class extends require_runtime.GTRuntime {
 				locale: this.resolveServiceLocale(f.source.locale)
 			}
 		}));
-		const result = await _uploadSourceFiles(files, mergedOptions, this._getTranslationConfig());
+		const { uploadedFiles } = await this._getApiAdapter().uploadSourceFiles(files, mergedOptions);
 		return {
-			uploadedFiles: result.data,
-			count: result.count,
-			message: `Successfully uploaded ${result.count} files in ${result.batchCount} batch(es)`
+			uploadedFiles,
+			count: uploadedFiles.length,
+			message: `Successfully uploaded ${uploadedFiles.length} files in ${Math.ceil(files.length / 100)} batch(es)`
 		};
 	}
 	/**
@@ -1102,15 +446,11 @@ var GT = class extends require_runtime.GTRuntime {
 	* re-running only stores new fonts.
 	* @param {AssetUpload[]} fonts - Fonts to upload (`content` base64-encoded).
 	* @param {UploadAssetsOptions} options - Optional settings (e.g. timeout).
-	* @returns {Promise<UploadAssetsResponse>} The stored/deduped assets.
+	* @returns {Promise<UploadAssetsResponse>} The stored assets.
 	*/
 	async uploadFonts(fonts, options = {}) {
-		this._validateAuth("uploadFonts");
-		const result = await _uploadFonts(fonts, options, this._getTranslationConfig());
-		return {
-			assets: result.data,
-			count: result.count
-		};
+		require_runtimeTranslate.validateAuth("uploadFonts", this._getTranslationConfig());
+		return await this._getApiAdapter().uploadFonts(fonts, options);
 	}
 	/**
 	* Uploads translation files that correspond to previously uploaded source files.
@@ -1127,18 +467,18 @@ var GT = class extends require_runtime.GTRuntime {
 	* @returns {Promise<UploadFilesResponse>} Upload result containing translation IDs, status, and processing information.
 	*/
 	async uploadTranslations(files, options) {
-		this._validateAuth("uploadTranslations");
+		require_runtimeTranslate.validateAuth("uploadTranslations", this._getTranslationConfig());
 		const mergedOptions = {
 			...options,
 			sourceLocale: options.sourceLocale ?? this.sourceLocale
 		};
 		if (!mergedOptions.sourceLocale) {
-			const error = require_runtime.noSourceLocaleProvidedError("uploadTranslations");
-			require_runtime.gtInstanceLogger.error(error);
+			const error = require_runtimeTranslate.noSourceLocaleProvidedError("uploadTranslations");
+			require_runtimeTranslate.gtInstanceLogger.error(error);
 			throw new Error(error);
 		}
 		mergedOptions.sourceLocale = this.resolveServiceLocale(mergedOptions.sourceLocale);
-		const result = await _uploadTranslations(files.map((f) => ({
+		const targetFiles = files.map((f) => ({
 			...f,
 			source: {
 				...f.source,
@@ -1148,11 +488,12 @@ var GT = class extends require_runtime.GTRuntime {
 				...t,
 				locale: this.resolveServiceLocale(t.locale)
 			}))
-		})), mergedOptions, this._getTranslationConfig());
+		}));
+		const { uploadedFiles } = await this._getApiAdapter().uploadTranslations(targetFiles, mergedOptions);
 		return {
-			uploadedFiles: result.data,
-			count: result.count,
-			message: `Successfully uploaded ${result.count} files in ${result.batchCount} batch(es)`
+			uploadedFiles,
+			count: uploadedFiles.length,
+			message: `Successfully uploaded ${uploadedFiles.length} files in ${Math.ceil(files.length / 100)} batch(es)`
 		};
 	}
 };