generaltranslation 9.4.2 → 9.5.0

package/dist/runtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.mjs","names":["_isValidLocale","translateWithConfig","translateManyWithConfig","_getRegionProperties","_requiresTranslation","_resolveCanonicalLocale","_resolveAliasLocale"],"sources":["../src/runtime.ts"],"sourcesContent":["// `generaltranslation` language toolkit\n// © 2026, General Translation, Inc.\n\n// ----- IMPORTS ----- //\n\nimport {\n  LocaleConfig,\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 type { UserTokenProvider } from '@generaltranslation/api';\nimport {\n  TranslateManyResult,\n  TranslationError,\n  TranslationRequestConfig,\n  TranslationResult,\n  TranslateManyEntry,\n} from './types';\nimport {\n  noSourceLocaleProvidedError,\n  noTargetLocaleProvidedError,\n  invalidLocaleError,\n  invalidLocalesError,\n} from './logging/errors';\nimport {\n  translate as translateWithConfig,\n  translateMany as translateManyWithConfig,\n} from './translate/runtimeTranslate';\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] - Deprecated alias for apiKey\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  /** @deprecated Pass the key as `apiKey`; there is one kind of API key. */\n  devApiKey?: string;\n  sourceLocale?: string;\n  targetLocale?: string;\n  locales?: string[];\n  projectId?: string;\n  baseUrl?: string;\n  customMapping?: CustomMapping;\n  userTokenProvider?: UserTokenProvider;\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  /** @deprecated Pass the key as `apiKey`; there is one kind of API key. */\n  devApiKey?: string;\n\n  /** User-token provider used when no API key is configured */\n  userTokenProvider?: UserTokenProvider;\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      // Deprecated with devApiKey; frameworks resolve the hot-reload key themselves.\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    userTokenProvider,\n  }: GTConstructorParams) {\n    const effectiveCustomMapping = customMapping ?? this.customMapping;\n\n    // ----- Environment properties ----- //\n    if (apiKey) this.apiKey = apiKey;\n    if (devApiKey) this.devApiKey = devApiKey;\n    if (projectId) this.projectId = projectId;\n    if (userTokenProvider) this.userTokenProvider = userTokenProvider;\n\n    // ----- Validate configured locale identities ----- //\n\n    // source locale\n    if (sourceLocale) {\n      this.sourceLocale = sourceLocale;\n      if (!_isValidLocale(this.sourceLocale, effectiveCustomMapping))\n        throw new Error(invalidLocaleError(this.sourceLocale));\n    }\n\n    // target locale\n    if (targetLocale) {\n      this.targetLocale = targetLocale;\n      if (!_isValidLocale(this.targetLocale, effectiveCustomMapping))\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        if (_isValidLocale(locale, effectiveCustomMapping)) {\n          result.push(locale);\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  /** Convert app identity only where a GT service expects a language code. */\n  protected resolveServiceLocale(locale: string): string {\n    return this.standardizeLocale(this.resolveCanonicalLocale(locale));\n  }\n\n  /**\n   * Recover configured spelling without negotiating an unrelated dialect.\n   * When several identities use the same service code and there is no request\n   * context to disambiguate them, the first configured identity wins.\n   */\n  protected resolveServiceResponseLocale(locale: string): string {\n    const canonical = this.standardizeLocale(locale);\n    const configured = [\n      ...(this.locales ?? []),\n      this.sourceLocale,\n      this.targetLocale,\n      ...Object.keys(this.customMapping ?? {}),\n    ];\n    return (\n      configured.find(\n        (candidate) =>\n          candidate && this.resolveServiceLocale(candidate) === canonical\n      ) ?? locale\n    );\n  }\n\n  protected _getTranslationConfig(): TranslationRequestConfig {\n    return {\n      baseUrl: this.baseUrl,\n      apiKey: this.apiKey || this.devApiKey,\n      projectId: this.projectId || '',\n      userTokenProvider: this.userTokenProvider,\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   * @param {number} [timeout] - Timeout in milliseconds; 0 or omitted selects the runtime default.\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    return translateWithConfig(\n      source,\n      options,\n      {\n        ...this._getTranslationConfig(),\n        customMapping: this.customMapping,\n        timeoutMs: timeout || undefined,\n      },\n      this\n    );\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   * @param {number} [timeout] - Timeout in milliseconds; 0 or omitted selects the runtime default.\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    return translateManyWithConfig(\n      sources,\n      options,\n      {\n        ...this._getTranslationConfig(),\n        customMapping: this.customMapping,\n        timeoutMs: timeout || undefined,\n      },\n      this\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 new LocaleConfig({ customMapping }).determineLocale(\n      locales,\n      approvedLocales ?? []\n    );\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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"}

package/dist/runtimeTranslate-CVw143pQ.mjs

@@ -0,0 +1,506 @@
+import { t as createDiagnosticMessage } from "./diagnostics-DKA2SkZB.mjs";
+import { t as hashSource } from "./id-B2wA7-S-.mjs";
+import { t as ApiError } from "./ApiError-DxWKM0Xt.mjs";
+import { ModelProvider, createApiClient, translate } from "@generaltranslation/api";
+import { resolveCanonicalLocale, standardizeLocale } from "@generaltranslation/format";
+//#region src/settings/settings.ts
+const libraryDefaultLocale = "en";
+const defaultTimeout = 6e4;
+//#endregion
+//#region src/settings/settingsUrls.ts
+const defaultCacheUrl = "https://cdn.gtx.dev";
+const defaultBaseUrl = "https://api.gtx.dev";
+const defaultRuntimeApiUrl = "https://api.gtx.dev";
+//#endregion
+//#region src/logging/errors.ts
+const GT_SOURCE = "GT";
+const translationTimeoutError = (timeout) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: `Translation request timed out after ${timeout}ms`,
+	fix: "Try again, or increase the request timeout if the source content is large"
+});
+const apiError = (status, statusText, error) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: `The translation API returned ${status} ${statusText}`,
+	fix: "Check the request configuration and try again",
+	details: error
+});
+const noTargetLocaleProvidedError = (functionName) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: `Cannot call \`${functionName}\` without a specified locale`,
+	fix: `Pass a locale to \`${functionName}\` or specify targetLocale in the GT constructor`
+});
+const noSourceLocaleProvidedError = (functionName) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: `Cannot call \`${functionName}\` without a specified locale`,
+	fix: `Pass a locale to \`${functionName}\` or specify sourceLocale in the GT constructor`
+});
+const noProjectIdProvidedError = (functionName) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: `Cannot call \`${functionName}\` without a specified project ID`,
+	fix: `Pass a project ID to \`${functionName}\` or specify projectId in the GT constructor`
+});
+const noApiKeyProvidedError = (functionName) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: `Cannot call \`${functionName}\` without a specified API key`,
+	fix: `Pass an API key to \`${functionName}\` or specify apiKey in the GT constructor`
+});
+const invalidLocaleError = (locale) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: `Locale "${locale}" is not valid`,
+	fix: "Use a valid BCP 47 locale code or add a custom mapping"
+});
+const invalidLocalesError = (locales) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: `These locales are not valid: ${locales.join(", ")}`,
+	fix: "Use valid BCP 47 locale codes or add custom mappings"
+});
+//#endregion
+//#region src/logging/logger.ts
+const LOG_LEVELS = {
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3,
+	off: 4
+};
+const LOG_COLORS = {
+	debug: "\x1B[36m",
+	info: "\x1B[32m",
+	warn: "\x1B[33m",
+	error: "\x1B[31m",
+	off: ""
+};
+const RESET_COLOR = "\x1B[0m";
+/**
+* Get the configured log level from environment variable or default to 'warn'
+*/
+function getConfiguredLogLevel() {
+	if (typeof process !== "undefined" && process.env?._GT_LOG_LEVEL) {
+		const envLevel = process.env._GT_LOG_LEVEL.toLowerCase();
+		if (envLevel in LOG_LEVELS) return envLevel;
+	}
+	return "warn";
+}
+/**
+* Console log handler that outputs formatted messages to console
+*/
+var ConsoleLogHandler = class {
+	constructor(config) {
+		this.config = config;
+	}
+	handle(entry) {
+		const parts = [];
+		if (this.config.includeTimestamp) parts.push(`[${entry.timestamp.toISOString()}]`);
+		const colorCode = LOG_COLORS[entry.level];
+		const levelText = `[${entry.level.toUpperCase()}]`;
+		parts.push(`${colorCode}${levelText}${RESET_COLOR}`);
+		if (this.config.prefix) parts.push(`[${this.config.prefix}]`);
+		if (this.config.includeContext && entry.context) parts.push(`[${entry.context}]`);
+		parts.push(entry.message);
+		if (entry.metadata && Object.keys(entry.metadata).length > 0) parts.push(`\n  Metadata: ${JSON.stringify(entry.metadata, null, 2)}`);
+		const formattedMessage = parts.join(" ");
+		switch (entry.level) {
+			case "debug":
+				console.debug(formattedMessage);
+				break;
+			case "info":
+				console.info(formattedMessage);
+				break;
+			case "warn":
+				console.warn(formattedMessage);
+				break;
+			case "error":
+				console.error(formattedMessage);
+				break;
+		}
+	}
+};
+/**
+* Main Logger class providing structured logging capabilities.
+*/
+var Logger = class {
+	constructor(config = {}) {
+		this.config = {
+			level: getConfiguredLogLevel(),
+			includeTimestamp: true,
+			includeContext: true,
+			enableConsole: true,
+			handlers: [],
+			...config
+		};
+		this.handlers = [...this.config.handlers || []];
+		if (this.config.enableConsole) this.handlers.push(new ConsoleLogHandler(this.config));
+	}
+	/**
+	* Add a custom log handler
+	*/
+	addHandler(handler) {
+		this.handlers.push(handler);
+	}
+	/**
+	* Remove a log handler
+	*/
+	removeHandler(handler) {
+		const index = this.handlers.indexOf(handler);
+		if (index > -1) this.handlers.splice(index, 1);
+	}
+	/**
+	* Update logger configuration
+	*/
+	configure(config) {
+		this.config = {
+			...this.config,
+			...config
+		};
+	}
+	/**
+	* Check if a log level should be output based on current configuration
+	*/
+	shouldLog(level) {
+		return LOG_LEVELS[level] >= LOG_LEVELS[this.config.level];
+	}
+	/**
+	* Internal logging method that creates log entries and passes them to handlers
+	*/
+	log(level, message, context, metadata) {
+		if (!this.shouldLog(level)) return;
+		const entry = {
+			level,
+			message,
+			timestamp: /* @__PURE__ */ new Date(),
+			context,
+			metadata
+		};
+		this.handlers.forEach((handler) => {
+			try {
+				handler.handle(entry);
+			} catch (error) {
+				console.error("Error in log handler:", error);
+			}
+		});
+	}
+	/**
+	* Log a debug message
+	* Used for detailed diagnostic information, typically of interest only when diagnosing problems
+	*/
+	debug(message, context, metadata) {
+		this.log("debug", message, context, metadata);
+	}
+	/**
+	* Log an info message
+	* Used for general information about application operation.
+	*/
+	info(message, context, metadata) {
+		this.log("info", message, context, metadata);
+	}
+	/**
+	* Log a warning message
+	* Used for potentially problematic situations that don't prevent operation
+	*/
+	warn(message, context, metadata) {
+		this.log("warn", message, context, metadata);
+	}
+	/**
+	* Log an error message
+	* Used for error events that might still allow the application to continue.
+	*/
+	error(message, context, metadata) {
+		this.log("error", message, context, metadata);
+	}
+	/**
+	* Create a child logger with a specific context
+	*/
+	child(context) {
+		return new ContextLogger(this, context);
+	}
+	/**
+	* Get current logger configuration
+	*/
+	getConfig() {
+		return { ...this.config };
+	}
+};
+/**
+* Context logger that automatically includes context information.
+*/
+var ContextLogger = class ContextLogger {
+	constructor(logger, context) {
+		this.logger = logger;
+		this.context = context;
+	}
+	debug(message, metadata) {
+		this.logger.debug(message, this.context, metadata);
+	}
+	info(message, metadata) {
+		this.logger.info(message, this.context, metadata);
+	}
+	warn(message, metadata) {
+		this.logger.warn(message, this.context, metadata);
+	}
+	error(message, metadata) {
+		this.logger.error(message, this.context, metadata);
+	}
+	child(childContext) {
+		return new ContextLogger(this.logger, `${this.context}:${childContext}`);
+	}
+};
+const gtInstanceLogger = /* @__PURE__ */ (/* @__PURE__ */ new Logger({
+	level: getConfiguredLogLevel(),
+	includeTimestamp: true,
+	includeContext: true,
+	prefix: "GT"
+})).child("GT instance");
+//#endregion
+//#region src/adapter/modelProvider.ts
+const supportedModelProviders = /* @__PURE__ */ Object.values(ModelProvider);
+function isModelProvider(value) {
+	return supportedModelProviders.includes(value);
+}
+//#endregion
+//#region src/translate/utils/fetchWithTimeout.ts
+/**
+* @internal
+*
+* Wraps a fetch implementation with the runtime translation timeout.
+*
+* @param url - The URL to fetch.
+* @param options - The options to pass to the fetch function.
+* @param timeoutMs - The timeout in milliseconds. Omitted selects `defaultTimeout`,
+* `0` is a literal zero, and `false` disables the runtime-owned timer.
+* @param fetchImplementation - The fetch implementation to call. Defaults to global fetch.
+* @returns The response from the fetch function.
+*/
+async function fetchWithTimeout(url, options, timeoutMs = defaultTimeout, fetchImplementation = globalThis.fetch) {
+	const controller = new AbortController();
+	const signals = [controller.signal];
+	if (options.signal) signals.push(options.signal);
+	if (url instanceof Request) signals.push(url.signal);
+	const signal = AbortSignal.any(signals);
+	let timedOut = false;
+	const timeoutId = timeoutMs === false ? null : setTimeout(() => {
+		timedOut = !signal.aborted;
+		controller.abort();
+	}, timeoutMs);
+	try {
+		return await fetchImplementation(url, {
+			...options,
+			signal
+		});
+	} catch (error) {
+		if (timedOut && timeoutMs !== false && error === controller.signal.reason) throw translationTimeoutError(timeoutMs);
+		throw error;
+	} finally {
+		if (timeoutId) clearTimeout(timeoutId);
+	}
+}
+//#endregion
+//#region src/translate/utils/unwrapApiResult.ts
+function isErrorResult(error) {
+	return typeof error === "object" && error !== null && "error" in error && typeof error.error === "string";
+}
+function hasDecodedError(result) {
+	return isErrorResult(result.error) || typeof result.error === "string";
+}
+/**
+* Unwraps a `@generaltranslation/api` SDK result, returning its data or
+* throwing an `ApiError` built from the failed response.
+*/
+function unwrapApiResult(result) {
+	if (result.data !== void 0) return result.data;
+	if (result.response) {
+		const details = isErrorResult(result.error) ? result.error.error : typeof result.error === "string" ? result.error : result.response.statusText;
+		throw new ApiError(details, result.response.status, details);
+	}
+	throw result.error;
+}
+//#endregion
+//#region src/translate/utils/validateResponse.ts
+async function validateResponse(response) {
+	if (!response.ok) {
+		let errorMsg = "Unknown error";
+		try {
+			const text = await response.text();
+			try {
+				errorMsg = JSON.parse(text).error;
+			} catch {
+				errorMsg = text || "Unknown error";
+			}
+		} catch {}
+		throw new ApiError(apiError(response.status, response.statusText, errorMsg), response.status, errorMsg);
+	}
+}
+//#endregion
+//#region src/translate/runtimeTranslate.ts
+/**
+* @internal
+* Credential/provider errors are reported before the project error, and both
+* before any locale validation. GT/GTRuntime share this ordering.
+*/
+function validateAuth(functionName, config) {
+	const errors = [];
+	if (!config.apiKey && !config.userTokenProvider) errors.push(noApiKeyProvidedError(functionName));
+	if (!config.projectId) errors.push(noProjectIdProvidedError(functionName));
+	if (errors.length) throw new Error(errors.join("\n"));
+}
+/**
+* @internal
+*
+* Shared preparation for every translation surface (classes and the tooling
+* facade): normalize the string shorthand, validate auth, require a target
+* locale, default the source locale and canonicalize both for the wire.
+*
+* @param defaults - Instance defaults supplied by GT/GTRuntime. Facade calls pass none.
+*/
+function prepareTranslation(functionName, options, config, defaults = {}) {
+	if (typeof options === "string") options = { targetLocale: options };
+	validateAuth(functionName, config);
+	const targetLocale = options?.targetLocale || defaults.targetLocale;
+	if (!targetLocale) {
+		const error = noTargetLocaleProvidedError(functionName);
+		gtInstanceLogger.error(error);
+		throw new Error(error);
+	}
+	const { customMapping, ...requestConfig } = config;
+	const resolveServiceLocale = (locale) => standardizeLocale(resolveCanonicalLocale(locale, customMapping));
+	return {
+		options: {
+			...options,
+			targetLocale: resolveServiceLocale(targetLocale),
+			sourceLocale: resolveServiceLocale(options?.sourceLocale || defaults.sourceLocale || "en")
+		},
+		config: requestConfig
+	};
+}
+/**
+* @internal
+* Translates a single entry with explicit configuration and optional locale defaults.
+*/
+async function translate$1(source, options, config, defaults) {
+	const prepared = prepareTranslation("translate", options, config, defaults);
+	return (await executeTranslationBatch([source], prepared.options, prepared.config))[0];
+}
+async function translateMany(sources, options, config, defaults) {
+	const prepared = prepareTranslation("translateMany", options, config, defaults);
+	return await executeTranslationBatch(sources, prepared.options, prepared.config);
+}
+function isJsonObject(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isGtProp(value) {
+	if (!isJsonObject(value)) return false;
+	if (value.t !== void 0 && value.t !== "p" && value.t !== "b") return false;
+	if ([
+		"pl",
+		"ti",
+		"alt",
+		"arl",
+		"arb",
+		"ard"
+	].some((key) => value[key] !== void 0 && typeof value[key] !== "string")) return false;
+	return value.b === void 0 || isJsonObject(value.b) && Object.values(value.b).every(isJsxChildren);
+}
+function isJsxElement(value) {
+	if (!isJsonObject(value)) return false;
+	return (value.t === void 0 || typeof value.t === "string") && (value.i === void 0 || typeof value.i === "number") && (value.d === void 0 || isGtProp(value.d)) && (value.c === void 0 || isJsxChildren(value.c));
+}
+function isJsxChild(value) {
+	return typeof value === "string" || isJsxElement(value);
+}
+function isJsxChildren(value) {
+	return value === null || typeof value === "boolean" || isJsxChild(value) || Array.isArray(value) && value.every(isJsxChild);
+}
+function toTranslationResult(result) {
+	if (!result.success) return result;
+	if (result.dataFormat === "JSX" && isJsxChildren(result.translation)) return {
+		success: true,
+		translation: result.translation,
+		dataFormat: result.dataFormat,
+		locale: result.locale
+	};
+	if (result.dataFormat !== "JSX" && typeof result.translation === "string") return {
+		success: true,
+		translation: result.translation,
+		dataFormat: result.dataFormat,
+		locale: result.locale
+	};
+	return {
+		success: false,
+		error: "Invalid translation returned",
+		code: 500
+	};
+}
+async function executeTranslationBatch(requests, globalMetadata, config) {
+	const isArray = Array.isArray(requests);
+	const hashOrder = isArray ? [] : void 0;
+	const requestsObject = {};
+	const entries = isArray ? requests.map((r) => [void 0, r]) : Object.entries(requests);
+	for (const [key, request] of entries) {
+		const { source, metadata } = typeof request === "string" ? { source: request } : request;
+		const hash = key ?? metadata?.hash ?? hashSource({
+			source,
+			...metadata?.context && { context: metadata.context },
+			...metadata?.maxChars != null && { maxChars: metadata.maxChars },
+			...metadata?.fileFormat && { fileFormat: metadata.fileFormat },
+			dataFormat: metadata?.dataFormat ?? "STRING"
+		});
+		hashOrder?.push(hash);
+		requestsObject[hash] = {
+			source,
+			metadata
+		};
+	}
+	if (globalMetadata.modelProvider !== void 0 && !isModelProvider(globalMetadata.modelProvider)) throw new Error(createDiagnosticMessage({
+		source: "generaltranslation",
+		severity: "Error",
+		whatHappened: "The configured model provider is not supported",
+		details: String(globalMetadata.modelProvider),
+		fix: `Use one of: ${supportedModelProviders.join(", ")}`
+	}));
+	const client = createApiClient({
+		apiKey: config.apiKey,
+		apiVersion: config.apiVersion,
+		userTokenProvider: config.userTokenProvider,
+		baseUrl: config.baseUrl || "https://api.gtx.dev",
+		fetch: (input, init) => fetchWithTimeout(input, init ?? {}, config.timeoutMs, config.fetch),
+		projectId: config.projectId,
+		retryPolicy: "none",
+		timeoutMs: false
+	});
+	const result = await translate({
+		body: {
+			requests: requestsObject,
+			targetLocale: globalMetadata.targetLocale,
+			sourceLocale: globalMetadata.sourceLocale,
+			metadata: {
+				...globalMetadata,
+				modelProvider: globalMetadata.modelProvider
+			}
+		},
+		client
+	});
+	if (result.data === void 0 && result.response && !hasDecodedError(result)) {
+		await validateResponse(result.response);
+		throw result.error;
+	}
+	const runtimeResponse = unwrapApiResult(result);
+	const response = Object.fromEntries(Object.entries(runtimeResponse).map(([hash, translationResult]) => [hash, toTranslationResult(translationResult)]));
+	if (hashOrder) return hashOrder.map((hash) => response[hash] ?? {
+		success: false,
+		error: "No translation returned",
+		code: 500
+	});
+	return response;
+}
+//#endregion
+export { unwrapApiResult as a, gtInstanceLogger as c, noSourceLocaleProvidedError as d, noTargetLocaleProvidedError as f, libraryDefaultLocale as g, defaultRuntimeApiUrl as h, isErrorResult as i, invalidLocaleError as l, defaultCacheUrl as m, translateMany as n, isModelProvider as o, defaultBaseUrl as p, validateAuth as r, supportedModelProviders as s, translate$1 as t, invalidLocalesError as u };
+
+//# sourceMappingURL=runtimeTranslate-CVw143pQ.mjs.map