generaltranslation 9.1.13 → 9.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/CHANGELOG.md +31 -0
  2. package/dist/api.cjs +9 -0
  3. package/dist/api.d.cts +1 -0
  4. package/dist/api.d.mts +1 -0
  5. package/dist/api.d.ts +1 -0
  6. package/dist/api.js +1 -0
  7. package/dist/api.mjs +2 -0
  8. package/dist/{derive-C3nzgrzy.mjs → derive-BRvTJxLf.mjs} +3 -2
  9. package/dist/{derive-C3nzgrzy.mjs.map → derive-BRvTJxLf.mjs.map} +1 -1
  10. package/dist/{file-D7gKavRj.cjs → file-B37WkCqM.cjs} +6 -6
  11. package/dist/file-B37WkCqM.cjs.map +1 -0
  12. package/dist/{file-Cgk1Xk9d.mjs → file-Dga6cyM8.mjs} +6 -6
  13. package/dist/file-Dga6cyM8.mjs.map +1 -0
  14. package/dist/id.d.cts +1 -1
  15. package/dist/id.d.mts +1 -1
  16. package/dist/index.cjs +130 -25
  17. package/dist/index.cjs.map +1 -1
  18. package/dist/index.d.cts +1 -1
  19. package/dist/index.d.mts +1 -1
  20. package/dist/index.mjs +109 -5
  21. package/dist/index.mjs.map +1 -1
  22. package/dist/internal.cjs +16 -8
  23. package/dist/internal.cjs.map +1 -1
  24. package/dist/internal.d.cts +18 -6
  25. package/dist/internal.d.mts +18 -6
  26. package/dist/internal.d.ts +1 -0
  27. package/dist/internal.js +1 -0
  28. package/dist/internal.mjs +3 -3
  29. package/dist/openapi.json +6184 -0
  30. package/dist/{runtime-hWpzl6v_.mjs → runtime-CqKaoInO.mjs} +23 -114
  31. package/dist/runtime-CqKaoInO.mjs.map +1 -0
  32. package/dist/{runtime-DoOLkKJT.cjs → runtime-DeF1Ef5w.cjs} +45 -136
  33. package/dist/{runtime-DoOLkKJT.cjs.map → runtime-DeF1Ef5w.cjs.map} +1 -1
  34. package/dist/runtime.cjs +1 -1
  35. package/dist/runtime.d.cts +1 -1
  36. package/dist/runtime.d.mts +1 -1
  37. package/dist/runtime.mjs +1 -1
  38. package/dist/settings/settingsUrls.d.ts +2 -2
  39. package/dist/settings/settingsUrls.js +2 -2
  40. package/dist/translate/api.d.ts +4 -1
  41. package/dist/translate/api.js +4 -1
  42. package/dist/translate/translateMany.js +34 -13
  43. package/dist/translate/utils/apiRequest.js +3 -3
  44. package/dist/translate/utils/fetchWithTimeout.js +7 -2
  45. package/dist/translate/utils/unwrapApiResult.d.ts +15 -0
  46. package/dist/translate/utils/unwrapApiResult.js +30 -0
  47. package/dist/{types-C8sSACgY.d.mts → types-BUNfoXph.d.mts} +6 -6
  48. package/dist/{types-DO3dc8ST.d.cts → types-Do446qa9.d.cts} +6 -6
  49. package/dist/types-dir/api/file.d.ts +4 -4
  50. package/dist/types-dir/api/file.js +5 -5
  51. package/dist/types.cjs +1 -1
  52. package/dist/types.d.cts +1 -1
  53. package/dist/types.d.mts +1 -1
  54. package/dist/types.mjs +1 -1
  55. package/dist/{api-rqq7klYe.mjs → unwrapApiResult-BzGfPw75.mjs} +24 -6
  56. package/dist/unwrapApiResult-BzGfPw75.mjs.map +1 -0
  57. package/dist/{api-tMgy8sHj.cjs → unwrapApiResult-Dv6Mfw_K.cjs} +41 -11
  58. package/dist/unwrapApiResult-Dv6Mfw_K.cjs.map +1 -0
  59. package/package.json +16 -2
  60. package/dist/api-rqq7klYe.mjs.map +0 -1
  61. package/dist/api-tMgy8sHj.cjs.map +0 -1
  62. package/dist/file-Cgk1Xk9d.mjs.map +0 -1
  63. package/dist/file-D7gKavRj.cjs.map +0 -1
  64. package/dist/runtime-hWpzl6v_.mjs.map +0 -1
@@ -1,6 +1,7 @@
1
- import { a as createDiagnosticMessage, s as defaultTimeout, t as API_VERSION } from "./api-rqq7klYe.mjs";
1
+ import { l as defaultTimeout, r as unwrapApiResult, s as createDiagnosticMessage, t as hasDecodedError } from "./unwrapApiResult-BzGfPw75.mjs";
2
2
  import { t as ApiError } from "./ApiError-CUKcz3YS.mjs";
3
3
  import { t as hashSource } from "./id-BMOKDfiZ.mjs";
4
+ import { createApiClient, translate } from "@generaltranslation/api";
4
5
  import { LocaleConfig, determineLocale, getRegionProperties, isValidLocale, requiresTranslation, resolveAliasLocale, resolveCanonicalLocale, standardizeLocale } from "@generaltranslation/format";
5
6
  //#region src/logging/errors.ts
6
7
  const GT_SOURCE = "GT";
@@ -278,7 +279,10 @@ const gtInstanceLogger = defaultLogger.child("GT instance");
278
279
  */
279
280
  async function fetchWithTimeout(url, options, timeout) {
280
281
  const controller = new AbortController();
281
- const signal = controller.signal;
282
+ const signals = [controller.signal];
283
+ if (options.signal) signals.push(options.signal);
284
+ if (url instanceof Request) signals.push(url.signal);
285
+ const signal = AbortSignal.any(signals);
282
286
  timeout = timeout ? timeout : defaultTimeout;
283
287
  const timeoutId = timeout ? setTimeout(() => controller.abort(), timeout) : null;
284
288
  try {
@@ -310,110 +314,6 @@ async function validateResponse(response) {
310
314
  }
311
315
  }
312
316
  //#endregion
313
- //#region src/translate/utils/handleFetchError.ts
314
- function handleFetchError(error, timeout) {
315
- if (error instanceof Error && error.name === "AbortError") {
316
- const errorMessage = translationTimeoutError(timeout);
317
- fetchLogger.error(errorMessage);
318
- throw new Error(errorMessage);
319
- }
320
- const errorMessage = translationRequestFailedError(error instanceof Error ? error.message : String(error));
321
- fetchLogger.error(errorMessage);
322
- throw error;
323
- }
324
- //#endregion
325
- //#region src/translate/utils/generateRequestHeaders.ts
326
- function generateRequestHeaders(config, excludeContentType = false) {
327
- const authHeaders = {
328
- ...!excludeContentType && { "Content-Type": "application/json" },
329
- "gt-project-id": config.projectId
330
- };
331
- if (config.apiKey) authHeaders["Authorization"] = `Bearer ${config.apiKey}`;
332
- authHeaders["gt-api-version"] = API_VERSION;
333
- return authHeaders;
334
- }
335
- //#endregion
336
- //#region src/translate/utils/apiRequest.ts
337
- const MAX_RETRIES = 3;
338
- const INITIAL_DELAY_MS = 500;
339
- const RATE_LIMIT_RETRY_DELAY_MS = 6e4;
340
- const MS_PER_SECOND = 1e3;
341
- function sleep(ms) {
342
- return new Promise((resolve) => setTimeout(resolve, ms));
343
- }
344
- function getRetryDelay(policy, attempt) {
345
- switch (policy) {
346
- case "linear": return INITIAL_DELAY_MS * (attempt + 1);
347
- case "exponential": return INITIAL_DELAY_MS * 2 ** attempt;
348
- default: return 0;
349
- }
350
- }
351
- function parseDelayMs(value) {
352
- if (!value) return;
353
- const seconds = Number(value.split(",")[0].split(";")[0].trim());
354
- if (!Number.isFinite(seconds) || seconds < 0) return;
355
- return seconds * MS_PER_SECOND;
356
- }
357
- function parseRetryAfter(value) {
358
- const delayMs = parseDelayMs(value);
359
- if (delayMs !== void 0) return delayMs;
360
- if (!value) return;
361
- const retryDate = Date.parse(value);
362
- if (Number.isNaN(retryDate)) return;
363
- return Math.max(retryDate - Date.now(), 0);
364
- }
365
- function getRateLimitRetryDelay(response) {
366
- return parseRetryAfter(response.headers.get("Retry-After")) ?? parseDelayMs(response.headers.get("RateLimit-Reset")) ?? RATE_LIMIT_RETRY_DELAY_MS;
367
- }
368
- function getResponseRetryDelay(response, policy, attempt) {
369
- if (response.status === 429) return getRateLimitRetryDelay(response);
370
- return getRetryDelay(policy, attempt);
371
- }
372
- /**
373
- * @internal
374
- *
375
- * Makes an API request with automatic retry for 429 and 5XX errors.
376
- *
377
- * Encapsulates URL construction, fetch with timeout, error handling,
378
- * response validation, and JSON parsing.
379
- *
380
- * @param config - The configuration for the API call.
381
- * @param endpoint - The API endpoint path (e.g. '/v2/project/jobs/info')
382
- * @param options - Optional request options.
383
- * @returns The parsed JSON response.
384
- */
385
- async function apiRequest(config, endpoint, options) {
386
- const timeout = options?.timeout ?? 6e4;
387
- const url = `${config.baseUrl || "https://api2.gtx.dev"}${endpoint}`;
388
- const method = options?.method ?? "POST";
389
- const retryPolicy = options?.retryPolicy ?? "exponential";
390
- const maxRetries = retryPolicy === "none" ? 0 : MAX_RETRIES;
391
- const requestInit = {
392
- method,
393
- headers: generateRequestHeaders(config)
394
- };
395
- if (options?.body !== void 0) requestInit.body = JSON.stringify(options.body);
396
- for (let attempt = 0; attempt <= maxRetries; attempt++) {
397
- let response;
398
- try {
399
- response = await fetchWithTimeout(url, requestInit, timeout);
400
- } catch (error) {
401
- if (attempt < maxRetries) {
402
- await sleep(getRetryDelay(retryPolicy, attempt));
403
- continue;
404
- }
405
- handleFetchError(error, timeout);
406
- }
407
- if ((response.status === 429 || response.status >= 500) && attempt < maxRetries) {
408
- await sleep(getResponseRetryDelay(response, retryPolicy, attempt));
409
- continue;
410
- }
411
- await validateResponse(response);
412
- return await response.json();
413
- }
414
- throw new Error("Max retries exceeded");
415
- }
416
- //#endregion
417
317
  //#region src/translate/translateMany.ts
418
318
  async function _translateMany(requests, globalMetadata, config, timeout) {
419
319
  const isArray = Array.isArray(requests);
@@ -434,19 +334,28 @@ async function _translateMany(requests, globalMetadata, config, timeout) {
434
334
  metadata
435
335
  };
436
336
  }
437
- const response = await apiRequest({
438
- ...config,
439
- baseUrl: config.baseUrl || "https://runtime2.gtx.dev"
440
- }, `/v2/translate`, {
337
+ const client = createApiClient({
338
+ apiKey: config.apiKey,
339
+ baseUrl: config.baseUrl || "https://api.gtx.dev",
340
+ fetch: (input, init) => fetchWithTimeout(input, init ?? {}, timeout),
341
+ projectId: config.projectId,
342
+ retryPolicy: "none",
343
+ timeoutMs: false
344
+ });
345
+ const result = await translate({
441
346
  body: {
442
347
  requests: requestsObject,
443
348
  targetLocale: globalMetadata.targetLocale,
444
349
  sourceLocale: globalMetadata.sourceLocale,
445
350
  metadata: globalMetadata
446
351
  },
447
- timeout,
448
- retryPolicy: "none"
352
+ client
449
353
  });
354
+ if (result.data === void 0 && result.response && !hasDecodedError(result)) {
355
+ await validateResponse(result.response);
356
+ throw result.error;
357
+ }
358
+ const response = unwrapApiResult(result);
450
359
  if (hashOrder) return hashOrder.map((hash) => response[hash] ?? {
451
360
  success: false,
452
361
  error: "No translation returned",
@@ -1041,6 +950,6 @@ var GTRuntime = class {
1041
950
  }
1042
951
  };
1043
952
  //#endregion
1044
- export { validateResponse as a, noSourceLocaleProvidedError as c, handleFetchError as i, noTargetLocaleProvidedError as l, apiRequest as n, fetchWithTimeout as o, generateRequestHeaders as r, gtInstanceLogger as s, GTRuntime as t };
953
+ export { gtInstanceLogger as a, translationRequestFailedError as c, fetchLogger as i, translationTimeoutError as l, validateResponse as n, noSourceLocaleProvidedError as o, fetchWithTimeout as r, noTargetLocaleProvidedError as s, GTRuntime as t };
1045
954
 
1046
- //# sourceMappingURL=runtime-hWpzl6v_.mjs.map
955
+ //# sourceMappingURL=runtime-CqKaoInO.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-CqKaoInO.mjs","names":["_standardizeLocale","_isValidLocale","_getRegionProperties","_requiresTranslation","_determineLocale","_resolveCanonicalLocale","_resolveAliasLocale"],"sources":["../src/logging/errors.ts","../src/logging/logger.ts","../src/translate/utils/fetchWithTimeout.ts","../src/translate/utils/validateResponse.ts","../src/translate/translateMany.ts","../src/runtime.ts"],"sourcesContent":["import { createDiagnosticMessage } from './diagnostics';\n\nconst GT_SOURCE = 'GT';\n\nexport const translationTimeoutError = (timeout: number) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Translation request timed out after ${timeout}ms`,\n fix: 'Try again, or increase the request timeout if the source content is large',\n });\n\nexport const translationRequestFailedError = (error: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: 'Translation request could not be completed',\n fix: 'Check your network connection and translation credentials, then try again',\n details: error,\n });\n\nexport const apiError = (status: number, statusText: string, error: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `The translation API returned ${status} ${statusText}`,\n fix: 'Check the request configuration and try again',\n details: error,\n });\n\nexport const invalidAuthError = createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: 'Authentication failed',\n fix: 'Check that your API key and project ID are correct',\n});\n\nexport const noTargetLocaleProvidedError = (functionName: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Cannot call \\`${functionName}\\` without a specified locale`,\n fix: `Pass a locale to \\`${functionName}\\` or specify targetLocale in the GT constructor`,\n });\n\nexport const noSourceLocaleProvidedError = (functionName: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Cannot call \\`${functionName}\\` without a specified locale`,\n fix: `Pass a locale to \\`${functionName}\\` or specify sourceLocale in the GT constructor`,\n });\n\nexport const noProjectIdProvidedError = (functionName: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Cannot call \\`${functionName}\\` without a specified project ID`,\n fix: `Pass a project ID to \\`${functionName}\\` or specify projectId in the GT constructor`,\n });\n\nexport const noApiKeyProvidedError = (functionName: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Cannot call \\`${functionName}\\` without a specified API key`,\n fix: `Pass an API key to \\`${functionName}\\` or specify apiKey in the GT constructor`,\n });\n\nexport const invalidLocaleError = (locale: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Locale \"${locale}\" is not valid`,\n fix: 'Use a valid BCP 47 locale code or add a custom mapping',\n });\n\nexport const invalidLocalesError = (locales: string[]) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `These locales are not valid: ${locales.join(', ')}`,\n fix: 'Use valid BCP 47 locale codes or add custom mappings',\n });\n","/**\n * Comprehensive logging system for the General Translation library.\n * Provides structured logging with multiple levels and configurable output.\n */\n\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'off';\n\nexport type LogMetadataValue =\n | string\n | number\n | boolean\n | null\n | undefined\n | Date\n | Error\n | LogMetadataValue[]\n | { [key: string]: LogMetadataValue };\n\nexport type LogMetadata = Record<string, LogMetadataValue>;\n\nexport interface LogEntry {\n level: LogLevel;\n message: string;\n timestamp: Date;\n context?: string;\n metadata?: LogMetadata;\n}\n\nexport interface LoggerConfig {\n /** Minimum log level to output. */\n level: LogLevel;\n /** Whether to include timestamps in log output. */\n includeTimestamp: boolean;\n /** Whether to include context information. */\n includeContext: boolean;\n /** Custom prefix for all log messages. */\n prefix?: string;\n /** Whether to output to console (default: true) */\n enableConsole: boolean;\n /** Custom log handlers. */\n handlers?: LogHandler[];\n}\n\nexport interface LogHandler {\n handle(entry: LogEntry): void;\n}\n\nconst LOG_LEVELS: Record<LogLevel, number> = {\n debug: 0,\n info: 1,\n warn: 2,\n error: 3,\n off: 4,\n};\n\nconst LOG_COLORS: Record<LogLevel, string> = {\n debug: '\\x1b[36m', // Cyan\n info: '\\x1b[32m', // Green\n warn: '\\x1b[33m', // Yellow\n error: '\\x1b[31m', // Red\n off: '', // No color needed since 'off' level logs are never displayed\n};\n\nconst RESET_COLOR = '\\x1b[0m';\n\n/**\n * Get the configured log level from environment variable or default to 'warn'\n */\nfunction getConfiguredLogLevel(): LogLevel {\n if (typeof process !== 'undefined' && process.env?._GT_LOG_LEVEL) {\n const envLevel = process.env._GT_LOG_LEVEL.toLowerCase();\n if (envLevel in LOG_LEVELS) {\n return envLevel as LogLevel;\n }\n }\n return 'warn';\n}\n\n/**\n * Console log handler that outputs formatted messages to console\n */\nexport class ConsoleLogHandler implements LogHandler {\n private config: LoggerConfig;\n\n constructor(config: LoggerConfig) {\n this.config = config;\n }\n\n handle(entry: LogEntry): void {\n const parts: string[] = [];\n\n // Add timestamp if enabled\n if (this.config.includeTimestamp) {\n parts.push(`[${entry.timestamp.toISOString()}]`);\n }\n\n // Add level with color\n const colorCode = LOG_COLORS[entry.level];\n const levelText = `[${entry.level.toUpperCase()}]`;\n parts.push(`${colorCode}${levelText}${RESET_COLOR}`);\n\n // Add prefix if configured\n if (this.config.prefix) {\n parts.push(`[${this.config.prefix}]`);\n }\n\n // Add context if available and enabled.\n if (this.config.includeContext && entry.context) {\n parts.push(`[${entry.context}]`);\n }\n\n // Add the main message\n parts.push(entry.message);\n\n // Format metadata if available.\n if (entry.metadata && Object.keys(entry.metadata).length > 0) {\n parts.push(`\\n Metadata: ${JSON.stringify(entry.metadata, null, 2)}`);\n }\n\n const formattedMessage = parts.join(' ');\n\n // Output to appropriate console method based on level\n switch (entry.level) {\n case 'debug':\n // eslint-disable-next-line no-console\n console.debug(formattedMessage);\n break;\n case 'info':\n // eslint-disable-next-line no-console\n console.info(formattedMessage);\n break;\n case 'warn':\n console.warn(formattedMessage);\n break;\n case 'error':\n console.error(formattedMessage);\n break;\n }\n }\n}\n\n/**\n * Main Logger class providing structured logging capabilities.\n */\nexport class Logger {\n private config: LoggerConfig;\n private handlers: LogHandler[];\n\n constructor(config: Partial<LoggerConfig> = {}) {\n this.config = {\n level: getConfiguredLogLevel(),\n includeTimestamp: true,\n includeContext: true,\n enableConsole: true,\n handlers: [],\n ...config,\n };\n\n this.handlers = [...(this.config.handlers || [])];\n\n // Add console handler if enabled\n if (this.config.enableConsole) {\n this.handlers.push(new ConsoleLogHandler(this.config));\n }\n }\n\n /**\n * Add a custom log handler\n */\n addHandler(handler: LogHandler): void {\n this.handlers.push(handler);\n }\n\n /**\n * Remove a log handler\n */\n removeHandler(handler: LogHandler): void {\n const index = this.handlers.indexOf(handler);\n if (index > -1) {\n this.handlers.splice(index, 1);\n }\n }\n\n /**\n * Update logger configuration\n */\n configure(config: Partial<LoggerConfig>): void {\n this.config = { ...this.config, ...config };\n }\n\n /**\n * Check if a log level should be output based on current configuration\n */\n private shouldLog(level: LogLevel): boolean {\n return LOG_LEVELS[level] >= LOG_LEVELS[this.config.level];\n }\n\n /**\n * Internal logging method that creates log entries and passes them to handlers\n */\n private log(\n level: LogLevel,\n message: string,\n context?: string,\n metadata?: LogMetadata\n ): void {\n if (!this.shouldLog(level)) {\n return;\n }\n\n const entry: LogEntry = {\n level,\n message,\n timestamp: new Date(),\n context,\n metadata,\n };\n\n // Pass to all handlers\n this.handlers.forEach((handler) => {\n try {\n handler.handle(entry);\n } catch (error) {\n // Prevent logging errors from breaking the application\n console.error('Error in log handler:', error);\n }\n });\n }\n\n /**\n * Log a debug message\n * Used for detailed diagnostic information, typically of interest only when diagnosing problems\n */\n debug(message: string, context?: string, metadata?: LogMetadata): void {\n this.log('debug', message, context, metadata);\n }\n\n /**\n * Log an info message\n * Used for general information about application operation.\n */\n info(message: string, context?: string, metadata?: LogMetadata): void {\n this.log('info', message, context, metadata);\n }\n\n /**\n * Log a warning message\n * Used for potentially problematic situations that don't prevent operation\n */\n warn(message: string, context?: string, metadata?: LogMetadata): void {\n this.log('warn', message, context, metadata);\n }\n\n /**\n * Log an error message\n * Used for error events that might still allow the application to continue.\n */\n error(message: string, context?: string, metadata?: LogMetadata): void {\n this.log('error', message, context, metadata);\n }\n\n /**\n * Create a child logger with a specific context\n */\n child(context: string): ContextLogger {\n return new ContextLogger(this, context);\n }\n\n /**\n * Get current logger configuration\n */\n getConfig(): LoggerConfig {\n return { ...this.config };\n }\n}\n\n/**\n * Context logger that automatically includes context information.\n */\nexport class ContextLogger {\n private logger: Logger;\n private context: string;\n\n constructor(logger: Logger, context: string) {\n this.logger = logger;\n this.context = context;\n }\n\n debug(message: string, metadata?: LogMetadata): void {\n this.logger.debug(message, this.context, metadata);\n }\n\n info(message: string, metadata?: LogMetadata): void {\n this.logger.info(message, this.context, metadata);\n }\n\n warn(message: string, metadata?: LogMetadata): void {\n this.logger.warn(message, this.context, metadata);\n }\n\n error(message: string, metadata?: LogMetadata): void {\n this.logger.error(message, this.context, metadata);\n }\n\n child(childContext: string): ContextLogger {\n return new ContextLogger(this.logger, `${this.context}:${childContext}`);\n }\n}\n\n// Default logger instance.\nexport const defaultLogger = new Logger({\n level: getConfiguredLogLevel(),\n includeTimestamp: true,\n includeContext: true,\n prefix: 'GT',\n});\n\n// Convenience functions using the default logger.\nexport const debug = (\n message: string,\n context?: string,\n metadata?: LogMetadata\n) => defaultLogger.debug(message, context, metadata);\n\nexport const info = (\n message: string,\n context?: string,\n metadata?: LogMetadata\n) => defaultLogger.info(message, context, metadata);\n\nexport const warn = (\n message: string,\n context?: string,\n metadata?: LogMetadata\n) => defaultLogger.warn(message, context, metadata);\n\nexport const error = (\n message: string,\n context?: string,\n metadata?: LogMetadata\n) => defaultLogger.error(message, context, metadata);\n\n// Create context-specific loggers for different parts of the system\nexport const fetchLogger = defaultLogger.child('fetch');\nexport const gtInstanceLogger = defaultLogger.child('GT instance');\n\n// Export types and classes\nexport { Logger as GTLogger };\n","import { translationTimeoutError } from '../../logging/errors';\nimport { defaultTimeout } from '../../settings/settings';\n\n/**\n * @internal\n *\n * Wraps the fetch function with a timeout.\n *\n * @param url - The URL to fetch.\n * @param options - The options to pass to the fetch function.\n * @param timeout - The timeout in milliseconds.\n * @returns The response from the fetch function.\n */\nexport async function fetchWithTimeout(\n url: string | URL | globalThis.Request,\n options: RequestInit,\n timeout?: number\n) {\n const controller = new AbortController();\n const signals = [controller.signal];\n if (options.signal) signals.push(options.signal);\n if (url instanceof Request) signals.push(url.signal);\n const signal = AbortSignal.any(signals);\n\n timeout = timeout ? timeout : defaultTimeout;\n const timeoutId = timeout\n ? setTimeout(() => controller.abort(), timeout)\n : null;\n\n try {\n const response = await fetch(url, { ...options, signal });\n return response;\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n throw translationTimeoutError(timeout);\n }\n throw error;\n } finally {\n if (timeoutId) clearTimeout(timeoutId);\n }\n}\n","import { apiError } from '../../logging/errors';\nimport { ApiError } from '../../errors/ApiError';\n\nexport async function validateResponse(response: Response) {\n if (!response.ok) {\n let errorMsg = 'Unknown error';\n try {\n const text = await response.text();\n try {\n const errorJson = JSON.parse(text) as { error: string };\n errorMsg = errorJson.error;\n } catch {\n errorMsg = text || 'Unknown error';\n }\n } catch {\n // response.text() failed, keep 'Unknown error'\n }\n const errorMessage = apiError(\n response.status,\n response.statusText,\n errorMsg\n );\n const error = new ApiError(errorMessage, response.status, errorMsg);\n throw error;\n }\n}\n","import {\n createApiClient,\n translate,\n type TranslateData,\n} from '@generaltranslation/api';\nimport {\n TranslationRequestConfig,\n TranslateManyResult,\n TranslationResult,\n} from '../types';\nimport { defaultRuntimeApiUrl } from '../settings/settingsUrls';\nimport {\n TranslateManyEntry,\n TranslateOptions,\n EntryMetadata,\n} from '../types-dir/api/entry';\nimport type { Content } from '@generaltranslation/format/types';\nimport { hashSource } from '../id';\nimport { fetchWithTimeout } from './utils/fetchWithTimeout';\nimport { hasDecodedError, unwrapApiResult } from './utils/unwrapApiResult';\nimport { validateResponse } from './utils/validateResponse';\n\n/**\n * @internal\n *\n * Translates multiple entries in a single API request for better performance.\n * This function batches multiple translation requests together and sends them\n * to the GT translation API in one call.\n *\n * @param requests - The entries to translate. Can be an array (entries are hashed and results returned in order) or a record keyed by hash (skips hash calculation, returns a record).\n * @param globalMetadata - The metadata for the translation.\n * @param config - The configuration for the translation.\n * @returns The results of the translation. An array if requests was an array, a record if requests was a record.\n */\nexport async function _translateMany<\n T extends TranslateManyEntry[] | Record<string, TranslateManyEntry>,\n>(\n requests: T,\n globalMetadata: {\n targetLocale: string;\n sourceLocale: string;\n } & TranslateOptions,\n config: TranslationRequestConfig,\n timeout?: number\n): Promise<\n T extends TranslateManyEntry[]\n ? TranslateManyResult\n : Record<string, TranslationResult>\n>;\nexport async function _translateMany(\n requests: TranslateManyEntry[] | Record<string, TranslateManyEntry>,\n globalMetadata: {\n targetLocale: string;\n sourceLocale: string;\n } & TranslateOptions,\n config: TranslationRequestConfig,\n timeout?: number\n): Promise<TranslateManyResult | Record<string, TranslationResult>> {\n const isArray = Array.isArray(requests);\n\n // normalize and map from requests to requests record\n const hashOrder: string[] | undefined = isArray ? [] : undefined;\n const requestsObject: Record<\n string,\n { source: Content; metadata?: EntryMetadata }\n > = {};\n\n const entries: [string | undefined, TranslateManyEntry][] = isArray\n ? requests.map((r) => [undefined, r])\n : Object.entries(requests);\n\n for (const [key, request] of entries) {\n const normalized =\n typeof request === 'string' ? { source: request } : request;\n const { source, metadata } = normalized;\n const hash =\n key ??\n metadata?.hash ??\n hashSource({\n source,\n ...(metadata?.context && { context: metadata.context }),\n ...(metadata?.maxChars != null && { maxChars: metadata.maxChars }),\n dataFormat: metadata?.dataFormat ?? 'STRING',\n });\n hashOrder?.push(hash);\n requestsObject[hash] = {\n source,\n metadata: metadata,\n };\n }\n\n const client = createApiClient({\n apiKey: config.apiKey,\n baseUrl: config.baseUrl || defaultRuntimeApiUrl,\n fetch: (input, init) => fetchWithTimeout(input, init ?? {}, timeout),\n projectId: config.projectId,\n retryPolicy: 'none',\n timeoutMs: false,\n });\n const body = {\n requests: requestsObject,\n targetLocale: globalMetadata.targetLocale,\n sourceLocale: globalMetadata.sourceLocale,\n // Core intentionally accepts custom model-provider strings beyond the\n // OpenAPI ANTHROPIC|OPENAI|XAI|GOOGLE enum; preserve the pre-migration\n // wire behavior at this boundary.\n metadata: globalMetadata as TranslateData['body']['metadata'],\n } satisfies TranslateData['body'];\n const result = await translate({ body, client });\n\n // The generated client only decodes JSON errors, so non-JSON response bodies\n // must be re-read here to preserve legacy ApiError details.\n if (\n result.data === undefined &&\n result.response &&\n !hasDecodedError(result)\n ) {\n await validateResponse(result.response);\n throw result.error;\n }\n\n const runtimeResponse = unwrapApiResult(result);\n // OpenAPI allows an optional JsonValue translation, while core's published\n // result requires the format-specific Content union.\n const response = runtimeResponse as Record<string, TranslationResult>;\n\n // If input was an array, map the record response back to an array in input order\n if (hashOrder) {\n return hashOrder.map(\n (hash) =>\n response[hash] ?? {\n success: false,\n error: 'No translation returned',\n code: 500,\n }\n );\n }\n\n // If input was a record, return the record response directly\n return response;\n}\n","// `generaltranslation` language toolkit\n// © 2026, General Translation, Inc.\n\n// ----- IMPORTS ----- //\n\nimport {\n LocaleConfig,\n determineLocale as _determineLocale,\n getRegionProperties as _getRegionProperties,\n isValidLocale as _isValidLocale,\n requiresTranslation as _requiresTranslation,\n resolveAliasLocale as _resolveAliasLocale,\n resolveCanonicalLocale as _resolveCanonicalLocale,\n standardizeLocale as _standardizeLocale,\n} from '@generaltranslation/format';\nimport type {\n CustomMapping,\n CustomRegionMapping,\n CutoffFormatOptions,\n FormatVariables,\n LocaleProperties,\n StringFormat,\n} from '@generaltranslation/format/types';\nimport {\n TranslateManyResult,\n TranslationError,\n TranslationRequestConfig,\n TranslationResult,\n TranslateManyEntry,\n} from './types';\nimport { libraryDefaultLocale } from './settings/settings';\nimport {\n noSourceLocaleProvidedError,\n noTargetLocaleProvidedError,\n invalidLocaleError,\n invalidLocalesError,\n noProjectIdProvidedError,\n noApiKeyProvidedError,\n} from './logging/errors';\nimport { gtInstanceLogger } from './logging/logger';\nimport { _translateMany } from './translate/translateMany';\nimport { TranslateOptions } from './types-dir/api/entry';\n\n// ============================================================ //\n// Runtime Class //\n// ============================================================ //\n/**\n * Type representing the constructor parameters for the GT and GTRuntime classes.\n * @typedef {Object} GTConstructorParams\n * @property {string} [apiKey] - The API key for accessing the translation service\n * @property {string} [devApiKey] - The development API key for accessing the translation service\n * @property {string} [sourceLocale] - The default source locale for translations\n * @property {string} [targetLocale] - The default target locale for translations\n * @property {string[]} [locales] - Array of supported locales\n * @property {string} [projectId] - The project ID for the translation service\n * @property {string} [baseUrl] - The base URL for the translation service\n * @property {CustomMapping} [customMapping] - Custom mapping of locale codes to their names\n */\nexport type GTConstructorParams = {\n apiKey?: string;\n devApiKey?: string;\n sourceLocale?: string;\n targetLocale?: string;\n locales?: string[];\n projectId?: string;\n baseUrl?: string;\n customMapping?: CustomMapping;\n};\n\n/**\n * GTRuntime is the runtime core of the GT driver: locale management,\n * formatting, and runtime translation requests.\n *\n * Browser-facing SDK code constructs this class (via `generaltranslation/runtime`)\n * so production bundles do not ship the project/file management API client\n * that lives on the GT class exported from the main entry.\n *\n * @example\n * const gt = new GTRuntime({\n * sourceLocale: 'en-US',\n * targetLocale: 'es-ES',\n * locales: ['en-US', 'es-ES', 'fr-FR']\n * });\n */\nexport class GTRuntime {\n /** Base URL for the translation service API */\n baseUrl?: string;\n\n /** Project ID for the translation service */\n projectId?: string;\n\n /** API key for accessing the translation service */\n apiKey?: string;\n\n /** Development API key for accessing the translation service */\n devApiKey?: string;\n\n /** Source locale for translations */\n sourceLocale?: string;\n\n /** Target locale for translations */\n targetLocale?: string;\n\n /** Array of supported locales */\n locales?: string[];\n\n /** Custom mapping for locale codes to their names */\n customMapping?: CustomMapping;\n\n /** Lazily derived reverse custom mapping for alias locales */\n reverseCustomMapping?: Record<string, string>;\n\n /** Lazily derived custom mapping for regions */\n customRegionMapping?: CustomRegionMapping;\n\n /** Runtime-safe locale and formatting helpers (backing field) */\n private _localeConfig!: LocaleConfig;\n\n /** Runtime-safe locale and formatting helpers */\n get localeConfig() {\n return this._localeConfig;\n }\n\n /**\n * Constructs an instance of the GTRuntime class.\n *\n * @param {GTConstructorParams} [params] - The parameters for initializing the GTRuntime instance\n * @throws {Error} If an invalid locale is provided\n * @throws {Error} If any of the provided locales are invalid\n *\n * @example\n * const gt = new GTRuntime({\n * apiKey: 'your-api-key',\n * sourceLocale: 'en-US',\n * targetLocale: 'es-ES',\n * locales: ['en-US', 'es-ES', 'fr-FR']\n * });\n */\n constructor(params: GTConstructorParams = {}) {\n // Read environment\n if (typeof process !== 'undefined') {\n this.apiKey ||= process.env?.GT_API_KEY;\n this.devApiKey ||= process.env?.GT_DEV_API_KEY;\n this.projectId ||= process.env?.GT_PROJECT_ID;\n }\n // Set up config\n this.setConfig(params);\n }\n\n setConfig({\n apiKey,\n devApiKey,\n sourceLocale,\n targetLocale,\n locales,\n projectId,\n customMapping,\n baseUrl,\n }: GTConstructorParams) {\n // ----- Environment properties ----- //\n if (apiKey) this.apiKey = apiKey;\n if (devApiKey) this.devApiKey = devApiKey;\n if (projectId) this.projectId = projectId;\n\n // ----- Standardize locales ----- //\n\n // source locale\n if (sourceLocale) {\n this.sourceLocale = _standardizeLocale(sourceLocale);\n if (!_isValidLocale(this.sourceLocale, customMapping))\n throw new Error(invalidLocaleError(this.sourceLocale));\n }\n\n // target locale\n if (targetLocale) {\n this.targetLocale = _standardizeLocale(targetLocale);\n if (!_isValidLocale(this.targetLocale, customMapping))\n throw new Error(invalidLocaleError(this.targetLocale));\n }\n\n // locales\n if (locales) {\n const result: string[] = [];\n const invalidLocales: string[] = [];\n locales.forEach((locale) => {\n const standardizedLocale = _standardizeLocale(locale);\n if (_isValidLocale(standardizedLocale)) {\n result.push(standardizedLocale);\n } else {\n invalidLocales.push(locale);\n }\n });\n if (invalidLocales.length > 0) {\n throw new Error(invalidLocalesError(invalidLocales));\n }\n this.locales = result;\n }\n\n // ----- Other properties ----- //\n if (baseUrl) this.baseUrl = baseUrl;\n if (customMapping) {\n this.customMapping = customMapping;\n this.reverseCustomMapping = Object.fromEntries(\n Object.entries(customMapping)\n .filter(\n ([, value]) => value && typeof value === 'object' && 'code' in value\n )\n .map(([key, value]) => [(value as { code: string }).code, key])\n );\n }\n this._localeConfig = new LocaleConfig({\n defaultLocale: this.sourceLocale,\n locales: this.locales ?? [],\n customMapping: this.customMapping,\n });\n }\n\n // -------------- Private Methods -------------- //\n\n protected _getTranslationConfig(): TranslationRequestConfig {\n return {\n baseUrl: this.baseUrl,\n apiKey: this.apiKey || this.devApiKey,\n projectId: this.projectId || '',\n };\n }\n\n protected _validateAuth(functionName: string) {\n const errors: string[] = [];\n if (!this.apiKey && !this.devApiKey) {\n const error = noApiKeyProvidedError(functionName);\n errors.push(error);\n }\n if (!this.projectId) {\n const error = noProjectIdProvidedError(functionName);\n errors.push(error);\n }\n if (errors.length) {\n throw new Error(errors.join('\\n'));\n }\n }\n\n /**\n * Translates a single source string to the target locale.\n * Routes through {@link translateMany} under the hood.\n *\n * @param {string} source - The source string to translate.\n * @param {object} options - Translation options including targetLocale and optional entry metadata.\n * @returns {Promise<TranslationResult | TranslationError>} The translated content.\n *\n * @example\n * const result = await gt.translate('Hello, world!', { targetLocale: 'es' });\n *\n * @example\n * const result = await gt.translate('Hello, world!', {\n * targetLocale: 'es',\n * dataFormat: 'ICU',\n * context: 'A formal greeting',\n * });\n */\n async translate(\n source: TranslateManyEntry,\n options: string | TranslateOptions,\n timeout?: number\n ): Promise<TranslationResult | TranslationError> {\n // Normalize string shorthand to options object\n if (typeof options === 'string') {\n options = { targetLocale: options };\n }\n\n // Validation\n this._validateAuth('translate');\n\n // Require target locale\n let targetLocale = options?.targetLocale || this.targetLocale;\n if (!targetLocale) {\n const error = noTargetLocaleProvidedError('translate');\n gtInstanceLogger.error(error);\n throw new Error(error);\n }\n\n // Replace target locale with canonical locale\n targetLocale = this.resolveCanonicalLocale(targetLocale);\n\n const sourceLocale = this.resolveCanonicalLocale(\n options?.sourceLocale || this.sourceLocale || libraryDefaultLocale\n );\n\n // Request the translation.\n const results = await _translateMany(\n [source],\n {\n ...options,\n targetLocale,\n sourceLocale,\n },\n this._getTranslationConfig(),\n timeout\n );\n return results[0];\n }\n\n /**\n * Translates multiple source strings to the target locale.\n * Each entry can be a plain string or an object with source and metadata fields.\n *\n * @param {TranslateManyEntry[] | Record<string, TranslateManyEntry>} sources - The source entries to translate. Can be an array or a record keyed by hash.\n * @param {object} options - Translation options including targetLocale.\n * @returns {Promise<TranslateManyResult | Record<string, TranslationResult>>} The translated contents. An array if sources was an array, a record if sources was a record.\n *\n * @example\n * const result = await gt.translateMany(\n * ['Hello, world!', 'Goodbye, world!'],\n * { targetLocale: 'es' }\n * );\n *\n * @example\n * const result = await gt.translateMany(\n * [{ source: 'Hello, world!', dataFormat: 'ICU' }],\n * { targetLocale: 'es' }\n * );\n *\n * @example\n * const result = await gt.translateMany(\n * { 'my-hash': 'Hello, world!' },\n * { targetLocale: 'es' }\n * );\n */\n async translateMany(\n sources: TranslateManyEntry[],\n options: string | TranslateOptions,\n timeout?: number\n ): Promise<TranslateManyResult>;\n async translateMany(\n sources: Record<string, TranslateManyEntry>,\n options: string | TranslateOptions,\n timeout?: number\n ): Promise<Record<string, TranslationResult>>;\n async translateMany(\n sources: TranslateManyEntry[] | Record<string, TranslateManyEntry>,\n options: string | TranslateOptions,\n timeout?: number\n ): Promise<TranslateManyResult | Record<string, TranslationResult>> {\n // Normalize string shorthand to options object\n if (typeof options === 'string') {\n options = { targetLocale: options };\n }\n\n // Validation\n this._validateAuth('translateMany');\n\n // Require target locale\n let targetLocale = options?.targetLocale || this.targetLocale;\n if (!targetLocale) {\n const error = noTargetLocaleProvidedError('translateMany');\n gtInstanceLogger.error(error);\n throw new Error(error);\n }\n\n // Replace target locale with canonical locale\n targetLocale = this.resolveCanonicalLocale(targetLocale);\n\n const sourceLocale = this.resolveCanonicalLocale(\n options?.sourceLocale || this.sourceLocale || libraryDefaultLocale\n );\n\n // Request the translation.\n return await _translateMany(\n sources,\n {\n ...options,\n targetLocale,\n sourceLocale,\n },\n this._getTranslationConfig(),\n timeout\n );\n }\n\n // -------------- Formatting -------------- //\n\n /**\n * Formats a string with cutoff behavior, applying a terminator when the string exceeds the maximum character limit.\n *\n * This method uses the GT instance's rendering locales by default for locale-specific terminator selection,\n * but can be overridden with custom locales in the options.\n *\n * @param {string} value - The string value to format with cutoff behavior.\n * @param {Object} [options] - Configuration options for cutoff formatting.\n * @param {string | string[]} [options.locales] - The locales to use for terminator selection. Defaults to instance's rendering locales.\n * @param {number} [options.maxChars] - The maximum number of characters to display.\n * - Undefined values are treated as no cutoff.\n * - Negative values follow .slice() behavior and terminator will be added before the value.\n * - 0 will result in an empty string.\n * - If cutoff results in an empty string, no terminator is added.\n * @param {CutoffFormatStyle} [options.style='ellipsis'] - The style of the terminator.\n * @param {string} [options.terminator] - Optional override the terminator to use.\n * @param {string} [options.separator] - Optional override the separator to use between the terminator and the value.\n * - If no terminator is provided, then separator is ignored.\n * @returns {string} The formatted string with terminator applied if cutoff occurs.\n *\n * @example\n * const gt = new GTRuntime({ targetLocale: 'en-US' });\n * gt.formatCutoff('Hello, world!', { maxChars: 8 });\n * // Returns: 'Hello, w...'\n *\n * @example\n * gt.formatCutoff('Hello, world!', { maxChars: -3 });\n * // Returns: '...ld!'\n */\n formatCutoff(\n value: string,\n options?: {\n locales?: string | string[];\n } & CutoffFormatOptions\n ): string {\n return this.localeConfig.formatCutoff(value, this.targetLocale, options);\n }\n\n /**\n * Formats a message according to the specified locales and options.\n *\n * @param {string} message - The message to format.\n * @param {string | string[]} [locales=libraryDefaultLocale] - The locales to use for formatting.\n * @param {FormatVariables} [variables={}] - The variables to use for formatting.\n * @param {StringFormat} [dataFormat='ICU'] - The format of the message.\n * @returns {string} The formatted message.\n *\n * @example\n * gt.formatMessage('Hello {name}', { name: 'John' });\n * // Returns: \"Hello John\"\n *\n * gt.formatMessage('Hello {name}', { name: 'John' }, { locales: ['fr'] });\n * // Returns: \"Bonjour John\"\n */\n formatMessage(\n message: string,\n options?: {\n locales?: string | string[];\n variables?: FormatVariables;\n dataFormat?: StringFormat;\n }\n ): string {\n return this.localeConfig.formatMessage(message, this.targetLocale, options);\n }\n /**\n * Formats a number according to the specified locales and options.\n *\n * @param {number} number - The number to format.\n * @param {Object} [options] - Additional options for number formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.NumberFormatOptions} [options] - Additional Intl.NumberFormat options.\n * @returns {string} The formatted number.\n *\n * @example\n * gt.formatNum(1234.56, { style: 'currency', currency: 'USD' });\n * // Returns: \"$1,234.56\"\n */\n formatNum(\n number: number,\n options?: {\n locales?: string | string[];\n } & Intl.NumberFormatOptions\n ): string {\n return this.localeConfig.formatNum(number, this.targetLocale, options);\n }\n\n /**\n * Formats a date according to the specified locales and options.\n *\n * @param {Date} date - The date to format.\n * @param {Object} [options] - Additional options for date formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.DateTimeFormatOptions} [options] - Additional Intl.DateTimeFormat options.\n * @returns {string} The formatted date.\n *\n * @example\n * gt.formatDateTime(new Date(), { dateStyle: 'full', timeStyle: 'long' });\n * // Returns: \"Thursday, March 14, 2024 at 2:30:45 PM GMT-7\"\n */\n formatDateTime(\n date: Date,\n options?: {\n locales?: string | string[];\n } & Intl.DateTimeFormatOptions\n ): string {\n return this.localeConfig.formatDateTime(date, this.targetLocale, options);\n }\n\n /**\n * Formats a currency value according to the specified locales and options.\n *\n * @param {number} value - The currency value to format.\n * @param {string} currency - The currency code (e.g., 'USD', 'EUR')\n * @param {Object} [options] - Additional options for currency formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.NumberFormatOptions} [options] - Additional Intl.NumberFormat options.\n * @returns {string} The formatted currency value.\n *\n * @example\n * gt.formatCurrency(1234.56, 'USD', { style: 'currency' });\n * // Returns: \"$1,234.56\"\n */\n formatCurrency(\n value: number,\n currency: string,\n options?: {\n locales?: string | string[];\n } & Intl.NumberFormatOptions\n ): string {\n return this.localeConfig.formatCurrency(\n value,\n currency,\n this.targetLocale,\n options\n );\n }\n\n /**\n * Formats a list of items according to the specified locales and options.\n *\n * @param {Array<string | number>} array - The list of items to format.\n * @param {Object} [options] - Additional options for list formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.ListFormatOptions} [options] - Additional Intl.ListFormat options.\n * @returns {string} The formatted list.\n *\n * @example\n * gt.formatList(['apple', 'banana', 'orange'], { type: 'conjunction' });\n * // Returns: \"apple, banana, and orange\"\n */\n formatList(\n array: Array<string | number>,\n options?: {\n locales?: string | string[];\n } & Intl.ListFormatOptions\n ) {\n return this.localeConfig.formatList(array, this.targetLocale, options);\n }\n\n /**\n * Formats a list of items according to the specified locales and options.\n * @param {Array<T>} array - The list of items to format.\n * @param {Object} [options] - Additional options for list formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.ListFormatOptions} [options] - Additional Intl.ListFormat options.\n * @returns {Array<T | string>} The formatted list parts.\n *\n * @example\n * gt.formatListToParts(['apple', 42, { foo: 'bar' }], { type: 'conjunction', style: 'short', locales: ['en'] });\n * // Returns: ['apple', ', ', 42, ' and ', '{ foo: \"bar\" }']\n */\n formatListToParts<T>(\n array: Array<T>,\n options?: {\n locales?: string | string[];\n } & Intl.ListFormatOptions\n ): Array<T | string> {\n return this.localeConfig.formatListToParts<T>(\n array,\n this.targetLocale,\n options\n );\n }\n\n /**\n * Formats a relative time value according to the specified locales and options.\n *\n * @param {number} value - The relative time value to format.\n * @param {Intl.RelativeTimeFormatUnit} unit - The unit of time (e.g., 'second', 'minute', 'hour', 'day', 'week', 'month', 'year')\n * @param {Object} options - Additional options for relative time formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.RelativeTimeFormatOptions} [options] - Additional Intl.RelativeTimeFormat options.\n * @returns {string} The formatted relative time string.\n *\n * @example\n * gt.formatRelativeTime(-1, 'day', { locales: ['en-US'], numeric: 'auto' });\n * // Returns: \"yesterday\"\n */\n formatRelativeTime(\n value: number,\n unit: Intl.RelativeTimeFormatUnit,\n options?: {\n locales?: string | string[];\n } & Omit<Intl.RelativeTimeFormatOptions, 'locales'>\n ): string {\n return this.localeConfig.formatRelativeTime(\n value,\n unit,\n this.targetLocale,\n options\n );\n }\n\n /**\n * Formats a relative time string from a Date, automatically selecting the best unit.\n *\n * @param {Date} date - The date to format relative to now.\n * @param {Object} [options] - Additional options for relative time formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @returns {string} The formatted relative time string (e.g., \"2 hours ago\", \"in 3 days\")\n *\n * @example\n * gt.formatRelativeTimeFromDate(new Date(Date.now() - 3600000));\n * // Returns: \"1 hour ago\"\n */\n formatRelativeTimeFromDate(\n date: Date,\n options?: {\n locales?: string | string[];\n baseDate?: Date;\n } & Omit<Intl.RelativeTimeFormatOptions, 'locales'>\n ): string {\n return this.localeConfig.formatRelativeTimeFromDate(\n date,\n this.targetLocale,\n options\n );\n }\n\n // -------------- Locale Properties -------------- //\n\n /**\n * Retrieves the display name of a locale code using Intl.DisplayNames, returning an empty string if no name is found.\n *\n * @param {string} [locale=this.targetLocale] - A BCP-47 locale code.\n * @returns {string} The display name corresponding to the code.\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.getLocaleName('es-ES');\n * // Returns: \"Spanish (Spain)\"\n */\n getLocaleName(locale = this.targetLocale): string {\n if (!locale) throw new Error(noTargetLocaleProvidedError('getLocaleName'));\n return this.localeConfig.getLocaleName(locale);\n }\n\n /**\n * Retrieves an emoji based on a given locale code.\n * Uses the locale's region (if present) to select an emoji or falls back on default emojis.\n *\n * @param {string} [locale=this.targetLocale] - A BCP-47 locale code (e.g., 'en-US', 'fr-CA')\n * @returns {string} The emoji representing the locale or its region.\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.getLocaleEmoji('es-ES');\n * // Returns: \"🇪🇸\"\n */\n getLocaleEmoji(locale = this.targetLocale): string {\n if (!locale) throw new Error(noTargetLocaleProvidedError('getLocaleEmoji'));\n return this.localeConfig.getLocaleEmoji(locale);\n }\n\n /**\n * Generates linguistic details for a given locale code.\n *\n * This function returns information about the locale,\n * script, and region of a given language code both in a standard form and in a maximized form (with likely script and region).\n * The function provides these names in both your default language and native forms, and an associated emoji.\n *\n * @param {string} [locale=this.targetLocale] - The locale code to get properties for (e.g., \"de-AT\").\n * @returns {LocaleProperties} - An object containing detailed information about the locale.\n *\n * @property {string} code - The full locale code, e.g., \"de-AT\".\n * @property {string} name - Language name in the default display language, e.g., \"Austrian German\".\n * @property {string} nativeName - Language name in the locale's native language, e.g., \"Österreichisches Deutsch\".\n * @property {string} languageCode - The base language code, e.g., \"de\".\n * @property {string} languageName - The language name in the default display language, e.g., \"German\".\n * @property {string} nativeLanguageName - The language name in the native language, e.g., \"Deutsch\".\n * @property {string} nameWithRegionCode - Language name with region in the default language, e.g., \"German (AT)\".\n * @property {string} nativeNameWithRegionCode - Language name with region in the native language, e.g., \"Deutsch (AT)\".\n * @property {string} regionCode - The region code from maximization, e.g., \"AT\".\n * @property {string} regionName - The region name in the default display language, e.g., \"Austria\".\n * @property {string} nativeRegionName - The region name in the native language, e.g., \"Österreich\".\n * @property {string} scriptCode - The script code from maximization, e.g., \"Latn\".\n * @property {string} scriptName - The script name in the default display language, e.g., \"Latin\".\n * @property {string} nativeScriptName - The script name in the native language, e.g., \"Lateinisch\".\n * @property {string} maximizedCode - The maximized locale code, e.g., \"de-Latn-AT\".\n * @property {string} maximizedName - Maximized locale name with likely script in the default language, e.g., \"Austrian German (Latin)\".\n * @property {string} nativeMaximizedName - Maximized locale name in the native language, e.g., \"Österreichisches Deutsch (Lateinisch)\".\n * @property {string} minimizedCode - Minimized locale code, e.g., \"de-AT\" (or \"de\" for \"de-DE\").\n * @property {string} minimizedName - Minimized language name in the default language, e.g., \"Austrian German\".\n * @property {string} nativeMinimizedName - Minimized language name in the native language, e.g., \"Österreichisches Deutsch\".\n * @property {string} emoji - The emoji associated with the locale's region, if applicable.\n */\n getLocaleProperties(locale = this.targetLocale): LocaleProperties {\n if (!locale)\n throw new Error(noTargetLocaleProvidedError('getLocaleProperties'));\n return this.localeConfig.getLocaleProperties(locale);\n }\n\n /**\n * Retrieves multiple properties for a given region code, including:\n * - `code`: the original region code\n * - `name`: the localized display name\n * - `emoji`: the associated flag or symbol\n *\n * Behavior:\n * - Accepts ISO 3166-1 alpha-2 or UN M.49 region codes (e.g., `\"US\"`, `\"FR\"`, `\"419\"`).\n * - Uses the instance's `targetLocale` to localize the region name for the user.\n * - If `customMapping` contains a `name` or `emoji` for the region, those override the default values.\n * - Otherwise, uses `Intl.DisplayNames` to get the localized region name, falling back to `libraryDefaultLocale`.\n * - Falls back to the region code as `name` if display name resolution fails.\n * - Falls back to a default emoji if no emoji mapping is found in built-in data or `customMapping`.\n *\n * @param {string} [region=this.getLocaleProperties().regionCode] - The region code to look up (e.g., `\"US\"`, `\"GB\"`, `\"DE\"`).\n * @param {CustomRegionMapping} [customMapping] - Optional mapping of region codes to custom names and/or emojis.\n * @returns {{ code: string, name: string, emoji: string }} An object containing:\n * - `code`: the input region code\n * - `name`: the localized or custom region name\n * - `emoji`: the matching emoji flag or symbol\n *\n * @throws {Error} If no target locale is available to determine region properties.\n *\n * @example\n * const gt = new GTRuntime({ targetLocale: 'en-US' });\n * gt.getRegionProperties('US');\n * // => { code: 'US', name: 'United States', emoji: '🇺🇸' }\n *\n * @example\n * const gt = new GTRuntime({ targetLocale: 'fr-FR' });\n * gt.getRegionProperties('US');\n * // => { code: 'US', name: 'États-Unis', emoji: '🇺🇸' }\n *\n * @example\n * gt.getRegionProperties('US', { US: { name: 'USA', emoji: '🗽' } });\n * // => { code: 'US', name: 'USA', emoji: '🗽' }\n */\n getRegionProperties(\n region = this.getLocaleProperties().regionCode,\n customMapping?: CustomRegionMapping\n ): { code: string; name: string; emoji: string } {\n if (!customMapping) {\n if (this.customMapping && !this.customRegionMapping) {\n // Lazy derive custom region mapping from customMapping\n const customRegionMapping: CustomRegionMapping = {};\n for (const [locale, lp] of Object.entries(this.customMapping)) {\n if (\n lp &&\n typeof lp === 'object' &&\n lp.regionCode &&\n !customRegionMapping[lp.regionCode]\n ) {\n const { regionName: name, emoji } = lp;\n customRegionMapping[lp.regionCode] = {\n locale,\n ...(name && { name }),\n ...(emoji && { emoji }),\n };\n }\n }\n this.customRegionMapping = customRegionMapping;\n }\n customMapping = this.customRegionMapping;\n }\n return _getRegionProperties(\n region,\n this.targetLocale, // this.targetLocale because we want it in the user's language\n customMapping\n );\n }\n\n /**\n * Determines whether a translation is required based on the source and target locales.\n *\n * @param {string} [sourceLocale=this.sourceLocale] - The locale code for the original content.\n * @param {string} [targetLocale=this.targetLocale] - The locale code to translate into.\n * @param {string[]} [approvedLocales=this.locales] - Optional array of approved target locales.\n * @returns {boolean} True if translation is required, false otherwise\n * @throws {Error} If no source locale is provided.\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.requiresTranslation('en-US', 'es-ES');\n * // Returns: true\n */\n requiresTranslation(\n sourceLocale = this.sourceLocale,\n targetLocale = this.targetLocale,\n approvedLocales: string[] | undefined = this.locales,\n customMapping: CustomMapping | undefined = this.customMapping\n ): boolean {\n if (!sourceLocale)\n throw new Error(noSourceLocaleProvidedError('requiresTranslation'));\n if (!targetLocale)\n throw new Error(noTargetLocaleProvidedError('requiresTranslation'));\n if (customMapping === this.customMapping) {\n return this.localeConfig.requiresTranslation(\n targetLocale,\n sourceLocale,\n approvedLocales\n );\n }\n return _requiresTranslation(\n sourceLocale,\n targetLocale,\n approvedLocales,\n customMapping\n );\n }\n\n /**\n * Determines the best matching locale from the provided approved locales list.\n *\n * @param {string | string[]} locales - A single locale or array of locales in preference order.\n * @param {string[]} [approvedLocales=this.locales] - Array of approved locales in preference order.\n * @returns {string | undefined} The best matching locale, or undefined if no match is found.\n *\n * @example\n * gt.determineLocale(['fr-CA', 'fr-FR'], ['en-US', 'fr-FR', 'es-ES']);\n * // Returns: \"fr-FR\"\n */\n determineLocale(\n locales: string | string[],\n approvedLocales: string[] | undefined = this.locales || [],\n customMapping: CustomMapping | undefined = this.customMapping\n ): string | undefined {\n if (customMapping === this.customMapping) {\n return this.localeConfig.determineLocale(locales, approvedLocales ?? []);\n }\n return _determineLocale(locales, approvedLocales, customMapping);\n }\n\n /**\n * Gets the text direction for a given locale code.\n *\n * @param {string} [locale=this.targetLocale] - A BCP-47 locale code.\n * @returns {'ltr' | 'rtl'} 'rtl' if the locale is right-to-left; otherwise 'ltr'.\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.getLocaleDirection('ar-SA');\n * // Returns: \"rtl\"\n */\n getLocaleDirection(locale = this.targetLocale): 'ltr' | 'rtl' {\n if (!locale)\n throw new Error(noTargetLocaleProvidedError('getLocaleDirection'));\n return this.localeConfig.getLocaleDirection(locale);\n }\n\n /**\n * Checks if a given BCP 47 locale code is valid.\n *\n * @param {string} [locale=this.targetLocale] - The BCP 47 locale code to validate.\n * @param {CustomMapping} [customMapping=this.customMapping] - The custom mapping to use for validation.\n * @returns {boolean} True if the locale code is valid, false otherwise\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.isValidLocale('en-US');\n * // Returns: true\n */\n isValidLocale(\n locale = this.targetLocale,\n customMapping: CustomMapping | undefined = this.customMapping\n ): boolean {\n if (!locale) throw new Error(noTargetLocaleProvidedError('isValidLocale'));\n if (customMapping === this.customMapping) {\n return this.localeConfig.isValidLocale(locale);\n }\n return _isValidLocale(locale, customMapping);\n }\n\n /**\n * Resolves the canonical locale for a given locale.\n * @param locale - The locale to resolve the canonical locale for\n * @param customMapping - The custom mapping to use for resolving the canonical locale\n * @returns The canonical locale, or the input locale when no canonical mapping exists.\n */\n resolveCanonicalLocale(\n locale: string | undefined = this.targetLocale,\n customMapping: CustomMapping | undefined = this.customMapping\n ): string {\n if (!locale)\n throw new Error(noTargetLocaleProvidedError('resolveCanonicalLocale'));\n if (customMapping === this.customMapping) {\n return this.localeConfig.resolveCanonicalLocale(locale);\n }\n return _resolveCanonicalLocale(locale, customMapping);\n }\n\n /**\n * Resolves the alias locale for a given locale.\n * @param locale - The locale to resolve the alias locale for\n * @param customMapping - The custom mapping to use for resolving the alias locale\n * @returns The configured alias for a canonical locale, or the input locale when already an alias or no alias mapping exists.\n */\n resolveAliasLocale(\n locale: string,\n customMapping: CustomMapping | undefined = this.customMapping\n ): string {\n if (!locale)\n throw new Error(noTargetLocaleProvidedError('resolveAliasLocale'));\n if (customMapping === this.customMapping) {\n return this.localeConfig.resolveAliasLocale(locale);\n }\n return _resolveAliasLocale(locale, customMapping);\n }\n\n /**\n * Standardizes a BCP 47 locale code to ensure correct formatting.\n *\n * @param {string} [locale=this.targetLocale] - The BCP 47 locale code to standardize.\n * @returns {string} The standardized locale code, or the input string if it cannot be standardized.\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.standardizeLocale('en_us');\n * // Returns: \"en-US\"\n */\n standardizeLocale(locale = this.targetLocale): string {\n if (!locale)\n throw new Error(noTargetLocaleProvidedError('standardizeLocale'));\n return this.localeConfig.standardizeLocale(locale);\n }\n\n /**\n * Checks if multiple BCP 47 locale codes represent the same dialect.\n *\n * @param {...(string | string[])} locales - The BCP 47 locale codes to compare.\n * @returns {boolean} True if all codes represent the same dialect, false otherwise\n *\n * @example\n * gt.isSameDialect('en-US', 'en-GB');\n * // Returns: false\n *\n * gt.isSameDialect('en', 'en-US');\n * // Returns: true\n */\n isSameDialect(...locales: (string | string[])[]): boolean {\n return this.localeConfig.isSameDialect(...locales);\n }\n\n /**\n * Checks if multiple BCP 47 locale codes represent the same language.\n *\n * @param {...(string | string[])} locales - The BCP 47 locale codes to compare.\n * @returns {boolean} True if all codes represent the same language, false otherwise\n *\n * @example\n * gt.isSameLanguage('en-US', 'en-GB');\n * // Returns: true\n */\n isSameLanguage(...locales: (string | string[])[]): boolean {\n return this.localeConfig.isSameLanguage(...locales);\n }\n\n /**\n * Checks if a locale is a superset of another locale.\n *\n * @param {string} superLocale - The locale to check if it is a superset\n * @param {string} subLocale - The locale to check if it is a subset\n * @returns {boolean} True if superLocale is a superset of subLocale, false otherwise\n *\n * @example\n * gt.isSupersetLocale('en', 'en-US');\n * // Returns: true\n *\n * gt.isSupersetLocale('en-US', 'en');\n * // Returns: false\n */\n isSupersetLocale(superLocale: string, subLocale: string): boolean {\n return this.localeConfig.isSupersetLocale(superLocale, subLocale);\n }\n}\n"],"mappings":"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"}
@@ -1,66 +1,67 @@
1
- const require_api = require("./api-tMgy8sHj.cjs");
1
+ const require_unwrapApiResult = require("./unwrapApiResult-Dv6Mfw_K.cjs");
2
2
  const require_ApiError = require("./ApiError-BcjcnTAr.cjs");
3
3
  const require_id = require("./id-BpSNpXZu.cjs");
4
+ let _generaltranslation_api = require("@generaltranslation/api");
4
5
  let _generaltranslation_format = require("@generaltranslation/format");
5
6
  //#region src/logging/errors.ts
6
7
  const GT_SOURCE = "GT";
7
- const translationTimeoutError = (timeout) => require_api.createDiagnosticMessage({
8
+ const translationTimeoutError = (timeout) => require_unwrapApiResult.createDiagnosticMessage({
8
9
  source: GT_SOURCE,
9
10
  severity: "Error",
10
11
  whatHappened: `Translation request timed out after ${timeout}ms`,
11
12
  fix: "Try again, or increase the request timeout if the source content is large"
12
13
  });
13
- const translationRequestFailedError = (error) => require_api.createDiagnosticMessage({
14
+ const translationRequestFailedError = (error) => require_unwrapApiResult.createDiagnosticMessage({
14
15
  source: GT_SOURCE,
15
16
  severity: "Error",
16
17
  whatHappened: "Translation request could not be completed",
17
18
  fix: "Check your network connection and translation credentials, then try again",
18
19
  details: error
19
20
  });
20
- const apiError = (status, statusText, error) => require_api.createDiagnosticMessage({
21
+ const apiError = (status, statusText, error) => require_unwrapApiResult.createDiagnosticMessage({
21
22
  source: GT_SOURCE,
22
23
  severity: "Error",
23
24
  whatHappened: `The translation API returned ${status} ${statusText}`,
24
25
  fix: "Check the request configuration and try again",
25
26
  details: error
26
27
  });
27
- require_api.createDiagnosticMessage({
28
+ require_unwrapApiResult.createDiagnosticMessage({
28
29
  source: GT_SOURCE,
29
30
  severity: "Error",
30
31
  whatHappened: "Authentication failed",
31
32
  fix: "Check that your API key and project ID are correct"
32
33
  });
33
- const noTargetLocaleProvidedError = (functionName) => require_api.createDiagnosticMessage({
34
+ const noTargetLocaleProvidedError = (functionName) => require_unwrapApiResult.createDiagnosticMessage({
34
35
  source: GT_SOURCE,
35
36
  severity: "Error",
36
37
  whatHappened: `Cannot call \`${functionName}\` without a specified locale`,
37
38
  fix: `Pass a locale to \`${functionName}\` or specify targetLocale in the GT constructor`
38
39
  });
39
- const noSourceLocaleProvidedError = (functionName) => require_api.createDiagnosticMessage({
40
+ const noSourceLocaleProvidedError = (functionName) => require_unwrapApiResult.createDiagnosticMessage({
40
41
  source: GT_SOURCE,
41
42
  severity: "Error",
42
43
  whatHappened: `Cannot call \`${functionName}\` without a specified locale`,
43
44
  fix: `Pass a locale to \`${functionName}\` or specify sourceLocale in the GT constructor`
44
45
  });
45
- const noProjectIdProvidedError = (functionName) => require_api.createDiagnosticMessage({
46
+ const noProjectIdProvidedError = (functionName) => require_unwrapApiResult.createDiagnosticMessage({
46
47
  source: GT_SOURCE,
47
48
  severity: "Error",
48
49
  whatHappened: `Cannot call \`${functionName}\` without a specified project ID`,
49
50
  fix: `Pass a project ID to \`${functionName}\` or specify projectId in the GT constructor`
50
51
  });
51
- const noApiKeyProvidedError = (functionName) => require_api.createDiagnosticMessage({
52
+ const noApiKeyProvidedError = (functionName) => require_unwrapApiResult.createDiagnosticMessage({
52
53
  source: GT_SOURCE,
53
54
  severity: "Error",
54
55
  whatHappened: `Cannot call \`${functionName}\` without a specified API key`,
55
56
  fix: `Pass an API key to \`${functionName}\` or specify apiKey in the GT constructor`
56
57
  });
57
- const invalidLocaleError = (locale) => require_api.createDiagnosticMessage({
58
+ const invalidLocaleError = (locale) => require_unwrapApiResult.createDiagnosticMessage({
58
59
  source: GT_SOURCE,
59
60
  severity: "Error",
60
61
  whatHappened: `Locale "${locale}" is not valid`,
61
62
  fix: "Use a valid BCP 47 locale code or add a custom mapping"
62
63
  });
63
- const invalidLocalesError = (locales) => require_api.createDiagnosticMessage({
64
+ const invalidLocalesError = (locales) => require_unwrapApiResult.createDiagnosticMessage({
64
65
  source: GT_SOURCE,
65
66
  severity: "Error",
66
67
  whatHappened: `These locales are not valid: ${locales.join(", ")}`,
@@ -278,8 +279,11 @@ const gtInstanceLogger = defaultLogger.child("GT instance");
278
279
  */
279
280
  async function fetchWithTimeout(url, options, timeout) {
280
281
  const controller = new AbortController();
281
- const signal = controller.signal;
282
- timeout = timeout ? timeout : require_api.defaultTimeout;
282
+ const signals = [controller.signal];
283
+ if (options.signal) signals.push(options.signal);
284
+ if (url instanceof Request) signals.push(url.signal);
285
+ const signal = AbortSignal.any(signals);
286
+ timeout = timeout ? timeout : require_unwrapApiResult.defaultTimeout;
283
287
  const timeoutId = timeout ? setTimeout(() => controller.abort(), timeout) : null;
284
288
  try {
285
289
  return await fetch(url, {
@@ -310,110 +314,6 @@ async function validateResponse(response) {
310
314
  }
311
315
  }
312
316
  //#endregion
313
- //#region src/translate/utils/handleFetchError.ts
314
- function handleFetchError(error, timeout) {
315
- if (error instanceof Error && error.name === "AbortError") {
316
- const errorMessage = translationTimeoutError(timeout);
317
- fetchLogger.error(errorMessage);
318
- throw new Error(errorMessage);
319
- }
320
- const errorMessage = translationRequestFailedError(error instanceof Error ? error.message : String(error));
321
- fetchLogger.error(errorMessage);
322
- throw error;
323
- }
324
- //#endregion
325
- //#region src/translate/utils/generateRequestHeaders.ts
326
- function generateRequestHeaders(config, excludeContentType = false) {
327
- const authHeaders = {
328
- ...!excludeContentType && { "Content-Type": "application/json" },
329
- "gt-project-id": config.projectId
330
- };
331
- if (config.apiKey) authHeaders["Authorization"] = `Bearer ${config.apiKey}`;
332
- authHeaders["gt-api-version"] = require_api.API_VERSION;
333
- return authHeaders;
334
- }
335
- //#endregion
336
- //#region src/translate/utils/apiRequest.ts
337
- const MAX_RETRIES = 3;
338
- const INITIAL_DELAY_MS = 500;
339
- const RATE_LIMIT_RETRY_DELAY_MS = 6e4;
340
- const MS_PER_SECOND = 1e3;
341
- function sleep(ms) {
342
- return new Promise((resolve) => setTimeout(resolve, ms));
343
- }
344
- function getRetryDelay(policy, attempt) {
345
- switch (policy) {
346
- case "linear": return INITIAL_DELAY_MS * (attempt + 1);
347
- case "exponential": return INITIAL_DELAY_MS * 2 ** attempt;
348
- default: return 0;
349
- }
350
- }
351
- function parseDelayMs(value) {
352
- if (!value) return;
353
- const seconds = Number(value.split(",")[0].split(";")[0].trim());
354
- if (!Number.isFinite(seconds) || seconds < 0) return;
355
- return seconds * MS_PER_SECOND;
356
- }
357
- function parseRetryAfter(value) {
358
- const delayMs = parseDelayMs(value);
359
- if (delayMs !== void 0) return delayMs;
360
- if (!value) return;
361
- const retryDate = Date.parse(value);
362
- if (Number.isNaN(retryDate)) return;
363
- return Math.max(retryDate - Date.now(), 0);
364
- }
365
- function getRateLimitRetryDelay(response) {
366
- return parseRetryAfter(response.headers.get("Retry-After")) ?? parseDelayMs(response.headers.get("RateLimit-Reset")) ?? RATE_LIMIT_RETRY_DELAY_MS;
367
- }
368
- function getResponseRetryDelay(response, policy, attempt) {
369
- if (response.status === 429) return getRateLimitRetryDelay(response);
370
- return getRetryDelay(policy, attempt);
371
- }
372
- /**
373
- * @internal
374
- *
375
- * Makes an API request with automatic retry for 429 and 5XX errors.
376
- *
377
- * Encapsulates URL construction, fetch with timeout, error handling,
378
- * response validation, and JSON parsing.
379
- *
380
- * @param config - The configuration for the API call.
381
- * @param endpoint - The API endpoint path (e.g. '/v2/project/jobs/info')
382
- * @param options - Optional request options.
383
- * @returns The parsed JSON response.
384
- */
385
- async function apiRequest(config, endpoint, options) {
386
- const timeout = options?.timeout ?? 6e4;
387
- const url = `${config.baseUrl || "https://api2.gtx.dev"}${endpoint}`;
388
- const method = options?.method ?? "POST";
389
- const retryPolicy = options?.retryPolicy ?? "exponential";
390
- const maxRetries = retryPolicy === "none" ? 0 : MAX_RETRIES;
391
- const requestInit = {
392
- method,
393
- headers: generateRequestHeaders(config)
394
- };
395
- if (options?.body !== void 0) requestInit.body = JSON.stringify(options.body);
396
- for (let attempt = 0; attempt <= maxRetries; attempt++) {
397
- let response;
398
- try {
399
- response = await fetchWithTimeout(url, requestInit, timeout);
400
- } catch (error) {
401
- if (attempt < maxRetries) {
402
- await sleep(getRetryDelay(retryPolicy, attempt));
403
- continue;
404
- }
405
- handleFetchError(error, timeout);
406
- }
407
- if ((response.status === 429 || response.status >= 500) && attempt < maxRetries) {
408
- await sleep(getResponseRetryDelay(response, retryPolicy, attempt));
409
- continue;
410
- }
411
- await validateResponse(response);
412
- return await response.json();
413
- }
414
- throw new Error("Max retries exceeded");
415
- }
416
- //#endregion
417
317
  //#region src/translate/translateMany.ts
418
318
  async function _translateMany(requests, globalMetadata, config, timeout) {
419
319
  const isArray = Array.isArray(requests);
@@ -434,19 +334,28 @@ async function _translateMany(requests, globalMetadata, config, timeout) {
434
334
  metadata
435
335
  };
436
336
  }
437
- const response = await apiRequest({
438
- ...config,
439
- baseUrl: config.baseUrl || "https://runtime2.gtx.dev"
440
- }, `/v2/translate`, {
337
+ const client = (0, _generaltranslation_api.createApiClient)({
338
+ apiKey: config.apiKey,
339
+ baseUrl: config.baseUrl || "https://api.gtx.dev",
340
+ fetch: (input, init) => fetchWithTimeout(input, init ?? {}, timeout),
341
+ projectId: config.projectId,
342
+ retryPolicy: "none",
343
+ timeoutMs: false
344
+ });
345
+ const result = await (0, _generaltranslation_api.translate)({
441
346
  body: {
442
347
  requests: requestsObject,
443
348
  targetLocale: globalMetadata.targetLocale,
444
349
  sourceLocale: globalMetadata.sourceLocale,
445
350
  metadata: globalMetadata
446
351
  },
447
- timeout,
448
- retryPolicy: "none"
352
+ client
449
353
  });
354
+ if (result.data === void 0 && result.response && !require_unwrapApiResult.hasDecodedError(result)) {
355
+ await validateResponse(result.response);
356
+ throw result.error;
357
+ }
358
+ const response = require_unwrapApiResult.unwrapApiResult(result);
450
359
  if (hashOrder) return hashOrder.map((hash) => response[hash] ?? {
451
360
  success: false,
452
361
  error: "No translation returned",
@@ -1047,10 +956,10 @@ Object.defineProperty(exports, "GTRuntime", {
1047
956
  return GTRuntime;
1048
957
  }
1049
958
  });
1050
- Object.defineProperty(exports, "apiRequest", {
959
+ Object.defineProperty(exports, "fetchLogger", {
1051
960
  enumerable: true,
1052
961
  get: function() {
1053
- return apiRequest;
962
+ return fetchLogger;
1054
963
  }
1055
964
  });
1056
965
  Object.defineProperty(exports, "fetchWithTimeout", {
@@ -1059,34 +968,34 @@ Object.defineProperty(exports, "fetchWithTimeout", {
1059
968
  return fetchWithTimeout;
1060
969
  }
1061
970
  });
1062
- Object.defineProperty(exports, "generateRequestHeaders", {
971
+ Object.defineProperty(exports, "gtInstanceLogger", {
1063
972
  enumerable: true,
1064
973
  get: function() {
1065
- return generateRequestHeaders;
974
+ return gtInstanceLogger;
1066
975
  }
1067
976
  });
1068
- Object.defineProperty(exports, "gtInstanceLogger", {
977
+ Object.defineProperty(exports, "noSourceLocaleProvidedError", {
1069
978
  enumerable: true,
1070
979
  get: function() {
1071
- return gtInstanceLogger;
980
+ return noSourceLocaleProvidedError;
1072
981
  }
1073
982
  });
1074
- Object.defineProperty(exports, "handleFetchError", {
983
+ Object.defineProperty(exports, "noTargetLocaleProvidedError", {
1075
984
  enumerable: true,
1076
985
  get: function() {
1077
- return handleFetchError;
986
+ return noTargetLocaleProvidedError;
1078
987
  }
1079
988
  });
1080
- Object.defineProperty(exports, "noSourceLocaleProvidedError", {
989
+ Object.defineProperty(exports, "translationRequestFailedError", {
1081
990
  enumerable: true,
1082
991
  get: function() {
1083
- return noSourceLocaleProvidedError;
992
+ return translationRequestFailedError;
1084
993
  }
1085
994
  });
1086
- Object.defineProperty(exports, "noTargetLocaleProvidedError", {
995
+ Object.defineProperty(exports, "translationTimeoutError", {
1087
996
  enumerable: true,
1088
997
  get: function() {
1089
- return noTargetLocaleProvidedError;
998
+ return translationTimeoutError;
1090
999
  }
1091
1000
  });
1092
1001
  Object.defineProperty(exports, "validateResponse", {
@@ -1096,4 +1005,4 @@ Object.defineProperty(exports, "validateResponse", {
1096
1005
  }
1097
1006
  });
1098
1007
 
1099
- //# sourceMappingURL=runtime-DoOLkKJT.cjs.map
1008
+ //# sourceMappingURL=runtime-DeF1Ef5w.cjs.map