generaltranslation 9.1.13 → 9.2.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # generaltranslation
 
+## 9.2.0
+
+### Minor Changes
+
+- [#2179](https://github.com/generaltranslation/gt/pull/2179) [`4496e16`](https://github.com/generaltranslation/gt/commit/4496e161d7885f329bdfd7f4d04a7a58ed12d9d1) Thanks [@chenxin-yan](https://github.com/chenxin-yan)! - Expose the generated API SDK from the `generaltranslation/api` subpath.
+
+### Patch Changes
+
+- [#2233](https://github.com/generaltranslation/gt/pull/2233) [`8725a5c`](https://github.com/generaltranslation/gt/commit/8725a5c9235926cf1653a9306cca44045874c0dc) Thanks [@eoinest](https://github.com/eoinest)! - Fix UTF-16 `.strings` and `.stringsdict` files being corrupted or rejected on upload.
+
+  Older Xcode wrote both formats as UTF-16, and legacy repositories still contain them. The CLI read every file as UTF-8 text, so a UTF-16 `.stringsdict` reached the API as mojibake and its XML parser rejected it outright — the file could not be uploaded at all. A UTF-16 `.strings` file did upload, but came back as byte-order-mark-less UTF-8, so every one of them showed as rewritten in `git diff`.
+
+  Encoding is now handled entirely by the CLI, which is the only part of the pipeline that touches the filesystem, and within the CLI by a single module at the disk boundary. Reads decode by byte order mark, so the API only ever receives UTF-8 text. Writes re-encode to the source file's own encoding, which the CLI already knows because it just read that file, so a UTF-16 repository stays UTF-16 and a UTF-8 one gains no byte order mark. This also fixes re-downloading a UTF-16 `.stringsdict` source, which previously produced a file `plutil` rejected with `Unexpected character ã at line 1`.
+
+  If the source file has been moved or deleted since it was uploaded, the translation already on disk is used as the record of the encoding instead, so those files keep their encoding rather than being rewritten as UTF-8.
+
+  The content hash recorded for a downloaded translation is now taken from its decoded text as well, so a file stored in UTF-16 stops reading as edited on every run because its hash had been computed from bytes read as UTF-8.
+
+  A file with no byte order mark is treated as UTF-8 even when its bytes are plainly UTF-16, matching Foundation: `plutil` rejects those files too, so guessing would translate content the platform itself cannot read.
+
+  `DOT_STRINGS` leaves `BINARY_FILE_FORMATS`, which now contains only `LOTTIE`. Every `.strings` file's version id changes once, because it is now hashed from the decoded text rather than the base64 payload, so each one re-translates a single time.
+
+- [#2240](https://github.com/generaltranslation/gt/pull/2240) [`0e5d7e0`](https://github.com/generaltranslation/gt/commit/0e5d7e0efd48f98659a8229f7e48273070981f5b) Thanks [@eoinest](https://github.com/eoinest)! - Send default API and runtime translation requests to `https://api.gtx.dev` while preserving their existing paths and custom URL overrides.
+
+- [#2180](https://github.com/generaltranslation/gt/pull/2180) [`3c33a75`](https://github.com/generaltranslation/gt/commit/3c33a75c738c2f433cfdf4e19d75b189c0100f38) Thanks [@chenxin-yan](https://github.com/chenxin-yan)! - Route runtime and Sanity API requests through the generated General Translation API SDK while preserving the existing public interfaces and caller-configured runtime timeouts.
+
+- [#2202](https://github.com/generaltranslation/gt/pull/2202) [`6ac4ba3`](https://github.com/generaltranslation/gt/commit/6ac4ba33a0230fb8aecae7c7677cfd38c361bd9c) Thanks [@chenxin-yan](https://github.com/chenxin-yan)! - Expose `spec/openapi.json` through the API and core package exports.
+
+- Updated dependencies [[`3c33a75`](https://github.com/generaltranslation/gt/commit/3c33a75c738c2f433cfdf4e19d75b189c0100f38), [`6ac4ba3`](https://github.com/generaltranslation/gt/commit/6ac4ba33a0230fb8aecae7c7677cfd38c361bd9c), [`33ea383`](https://github.com/generaltranslation/gt/commit/33ea383b5d1593793b0a704b35b8a750ea8c3274)]:
+  - @generaltranslation/api@0.1.0
+
 ## 9.1.13
 
 ### Patch Changes

package/dist/api.cjs

@@ -0,0 +1,9 @@
+var _generaltranslation_api = require("@generaltranslation/api");
+Object.keys(_generaltranslation_api).forEach(function(k) {
+	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function() {
+			return _generaltranslation_api[k];
+		}
+	});
+});

package/dist/api.d.cts

@@ -0,0 +1 @@
+export * from "@generaltranslation/api";

package/dist/api.d.mts

@@ -0,0 +1 @@
+export * from "@generaltranslation/api";

package/dist/api.d.ts

@@ -0,0 +1 @@
+export * from '@generaltranslation/api';

package/dist/api.js

@@ -0,0 +1 @@
+export * from '@generaltranslation/api';

package/dist/api.mjs

@@ -0,0 +1,2 @@
+export * from "@generaltranslation/api";
+export {};

package/dist/{derive-C3nzgrzy.mjs → derive-BRvTJxLf.mjs}

@@ -1,3 +1,4 @@
+import { API_VERSION } from "@generaltranslation/api";
 import { TYPE, parse } from "@generaltranslation/icu";
 //#region src/utils/isSupportedFileFormatTransform.ts
 const SUPPORTED_TRANSFORMATIONS = {
@@ -219,6 +220,6 @@ function derive(content) {
 	return content;
 }
 //#endregion
-export { isGTUnindexedSelectElement as a, decode as c, isGTIndexedSelectElement as i, encode as l, declareVar as n, VAR_IDENTIFIER as o, decodeVars as r, traverseIcu as s, derive as t, isSupportedFileFormatTransform as u };
+export { isGTUnindexedSelectElement as a, decode as c, API_VERSION as d, isGTIndexedSelectElement as i, encode as l, declareVar as n, VAR_IDENTIFIER as o, decodeVars as r, traverseIcu as s, derive as t, isSupportedFileFormatTransform as u };
 
-//# sourceMappingURL=derive-C3nzgrzy.mjs.map
+//# sourceMappingURL=derive-BRvTJxLf.mjs.map

package/dist/{derive-C3nzgrzy.mjs.map → derive-BRvTJxLf.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"derive-C3nzgrzy.mjs","names":[],"sources":["../src/utils/isSupportedFileFormatTransform.ts","../src/utils/base64.ts","../src/derive/utils/traverseIcu.ts","../src/derive/utils/constants.ts","../src/derive/utils/regex.ts","../src/derive/utils/traverseHelpers.ts","../src/derive/decodeVars.ts","../src/derive/utils/sanitizeVar.ts","../src/derive/declareVar.ts","../src/derive/derive.ts"],"sourcesContent":["import type { FileFormat } from '../types-dir/api/file';\n\nconst SUPPORTED_TRANSFORMATIONS = {\n  GTJSON: ['GTJSON'],\n  JSON: ['JSON'],\n  PO: ['PO'],\n  // POT templates can produce translated PO catalog files.\n  POT: ['POT', 'PO'],\n  YAML: ['YAML'],\n  MDX: ['MDX'],\n  MD: ['MD'],\n  TS: ['TS'],\n  JS: ['JS'],\n  HTML: ['HTML'],\n  TXT: ['TXT'],\n  TWILIO_CONTENT_JSON: ['TWILIO_CONTENT_JSON'],\n  LOTTIE: ['LOTTIE'],\n  SVG: ['SVG'],\n  DOT_STRINGS: ['DOT_STRINGS'],\n  DOT_STRINGSDICT: ['DOT_STRINGSDICT'],\n  ANDROID_STRINGS: ['ANDROID_STRINGS'],\n} as const satisfies Record<FileFormat, FileFormat[]>;\n\n/**\n * This function checks if a file format transformation is supported during translation\n * @param from - The source file format.\n * @param to - The target file format.\n * @returns True if the transformation is supported, false otherwise\n */\nexport function isSupportedFileFormatTransform(\n  from: FileFormat,\n  to: FileFormat\n): boolean {\n  const toFormats: FileFormat[] | undefined = SUPPORTED_TRANSFORMATIONS[from];\n  return toFormats?.includes(to) ?? false;\n}\n","// Encode a string to base64\nexport function encode(data: string): string {\n  if (typeof Buffer !== 'undefined') {\n    // Node.js path.\n    return Buffer.from(data, 'utf8').toString('base64');\n  }\n  // Browser path.\n  const bytes = new TextEncoder().encode(data);\n  let binary = '';\n  for (let i = 0; i < bytes.length; i++) {\n    binary += String.fromCharCode(bytes[i]);\n  }\n  return btoa(binary);\n}\n\n// Decode a base64 string to a string\nexport function decode(base64: string): string {\n  if (typeof Buffer !== 'undefined') {\n    // Node.js path.\n    return Buffer.from(base64, 'base64').toString('utf8');\n  }\n  // Browser path.\n  const binary = atob(base64);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i);\n  }\n  return new TextDecoder().decode(bytes);\n}\n","import {\n  parse,\n  TYPE,\n  type MessageFormatElement,\n  type ParserOptions,\n} from '@generaltranslation/icu';\n\ntype TraverseIcuOptions = ParserOptions & {\n  recurseIntoVisited?: boolean;\n};\n\n/**\n * Given an ICU string, traverse the AST and call the visitor function for each element that matches the type T\n * @param icu - The ICU string to traverse\n * @param shouldVisit - A function that returns true if the element should be visited\n * @param visitor - A function that is called for each element that matches the type T\n * @returns The modified AST of the ICU string.\n *\n * @note This function is a heavy operation, use sparingly\n */\nexport function traverseIcu<T extends MessageFormatElement>({\n  icuString,\n  shouldVisit,\n  visitor,\n  options: { recurseIntoVisited = true, ...otherOptions },\n}: {\n  icuString: string;\n  shouldVisit: (element: MessageFormatElement) => element is T;\n  visitor: (element: T) => void;\n  options: TraverseIcuOptions;\n}): MessageFormatElement[] {\n  const ast = parse(icuString, otherOptions);\n  handleChildren(ast);\n  return ast;\n\n  function handleChildren(children: MessageFormatElement[]): void {\n    children.map(handleChild);\n  }\n\n  function handleChild(child: MessageFormatElement) {\n    // handle select var\n    let visited = false;\n    if (shouldVisit(child)) {\n      visitor(child);\n      visited = true;\n    }\n    // recurse on children\n    if (!visited || recurseIntoVisited) {\n      if (child.type === TYPE.select || child.type === TYPE.plural) {\n        Object.values(child.options)\n          .map((option) => option.value)\n          .map(handleChildren);\n      } else if (child.type === TYPE.tag) {\n        handleChildren(child.children);\n      }\n    }\n  }\n}\n","export const VAR_IDENTIFIER = '_gt_';\nexport const VAR_NAME_IDENTIFIER = '_gt_var_name';\n","import { VAR_IDENTIFIER } from './constants';\n\n// Regex  for _gt_# select\nexport const GT_INDEXED_IDENTIFIER_REGEX = new RegExp(\n  `^${VAR_IDENTIFIER}\\\\d+$`\n);\n\nexport const GT_UNINDEXED_IDENTIFIER_REGEX = new RegExp(`^${VAR_IDENTIFIER}$`);\n","import {\n  GT_INDEXED_IDENTIFIER_REGEX,\n  GT_UNINDEXED_IDENTIFIER_REGEX,\n} from './regex';\nimport { GTIndexedSelectElement, GTUnindexedSelectElement } from './types';\nimport { TYPE, type MessageFormatElement } from '@generaltranslation/icu';\n\n// Visit any _gt_# select\nexport function isGTIndexedSelectElement(\n  child: MessageFormatElement\n): child is GTIndexedSelectElement {\n  return (\n    child.type === TYPE.select &&\n    GT_INDEXED_IDENTIFIER_REGEX.test(child.value) &&\n    !!child.options.other &&\n    (child.options.other.value.length === 0 ||\n      (child.options.other.value.length > 0 &&\n        child.options.other.value[0]?.type === TYPE.literal))\n  );\n}\n\n// Visit any _gt_ select\nexport function isGTUnindexedSelectElement(\n  child: MessageFormatElement\n): child is GTUnindexedSelectElement {\n  return (\n    child.type === TYPE.select &&\n    GT_UNINDEXED_IDENTIFIER_REGEX.test(child.value) &&\n    !!child.options.other &&\n    (child.options.other.value.length === 0 ||\n      (child.options.other.value.length > 0 &&\n        child.options.other.value[0]?.type === TYPE.literal))\n  );\n}\n","import { traverseIcu } from './utils/traverseIcu';\nimport { VAR_IDENTIFIER } from './utils/constants';\nimport { GTUnindexedSelectElement } from './utils/types';\nimport { isGTUnindexedSelectElement } from './utils/traverseHelpers';\n\ntype Location = {\n  start: number;\n  end: number;\n  value: string;\n};\n\n/**\n * Given an encoded ICU string, interpolate only _gt_ variables that have been marked with declareVar()\n * @example\n * const encodedIcu = \"Hi\" + declareVar(\"Brian\") + \", my name is {name}\"\n * // 'Hi {_gt_, select, other {Brian}}, my name is {name}'\n * decodeVars(encodedIcu)\n * // 'Hi Brian, my name is {name}'\n */\nexport function decodeVars(icuString: string): string {\n  // Check if the string contains _gt_\n  if (!icuString.includes(VAR_IDENTIFIER)) {\n    return icuString;\n  }\n\n  // Record the location of the variable\n  const variableLocations: Location[] = [];\n  function visitor(child: GTUnindexedSelectElement): void {\n    variableLocations.push({\n      start: child.location?.start.offset ?? 0,\n      end: child.location?.end.offset ?? 0,\n      value:\n        child.options.other.value.length > 0\n          ? child.options.other.value[0].value\n          : '',\n    });\n  }\n\n  // Find all variable identifiers.\n  traverseIcu({\n    icuString,\n    shouldVisit: isGTUnindexedSelectElement,\n    visitor,\n    options: {\n      recurseIntoVisited: false,\n      captureLocation: true,\n    },\n  });\n\n  // Construct output string\n  let previousIndex = 0;\n  const outputList = [];\n  for (let i = 0; i < variableLocations.length; i++) {\n    outputList.push(icuString.slice(previousIndex, variableLocations[i].start));\n    outputList.push(variableLocations[i].value);\n    previousIndex = variableLocations[i].end;\n  }\n  if (previousIndex < icuString.length) {\n    outputList.push(icuString.slice(previousIndex));\n  }\n  const outputString = outputList.join('');\n\n  return outputString;\n}\n","/**\n * Sanitizes string by escaping ICU syntax\n *\n * Sanitize arbitrary string so it does not break the following ICU message syntax:\n * {_gt_, select, other {string_here}}\n *\n * Escapes ICU special characters by:\n * 1. Doubling all single quotes (U+0027 ')\n * 2. Adding a single quote before the first special character ({}<>)\n * 3. Adding a single quote after the last special character ({}<>)\n */\nexport function sanitizeVar(string: string): string {\n  // First, double all single quotes (both ASCII and Unicode).\n  let result = string.replace(/'/g, \"''\");\n\n  // Find first and last positions of special characters\n  const specialChars = /[{}<>]/;\n  const firstSpecialIndex = result.search(specialChars);\n\n  if (firstSpecialIndex === -1) {\n    // No special characters; return with just doubled quotes.\n    return result;\n  }\n\n  // Find last special character position\n  let lastSpecialIndex = -1;\n  for (let i = result.length - 1; i >= 0; i--) {\n    if (specialChars.test(result[i])) {\n      lastSpecialIndex = i;\n      break;\n    }\n  }\n\n  // Insert quotes around the special character region.\n  result =\n    result.slice(0, firstSpecialIndex) +\n    \"'\" +\n    result.slice(firstSpecialIndex, lastSpecialIndex + 1) +\n    \"'\" +\n    result.slice(lastSpecialIndex + 1);\n\n  return result;\n}\n","import { VAR_IDENTIFIER, VAR_NAME_IDENTIFIER } from './utils/constants';\nimport { sanitizeVar } from './utils/sanitizeVar';\n\n/**\n * Mark as a non-translatable string. Use within a derive() call to mark content as not derivable (e.g., not possible to statically analyze).\n *\n * @example\n * function nonDerivableFunction() {\n *   return Math.random();\n * }\n *\n * function derivableFunction() {\n *   if (condition) {\n *     return declareVar(nonDerivableFunction())\n *   }\n *   return 'John Doe';\n * }\n *\n * const gt = useGT();\n * gt(`My name is ${derive(derivableFunction())}`);\n *\n * @param {string | number | boolean | null | undefined} variable - The variable to sanitize.\n * @param {Object} [options] - The options for the sanitization.\n * @param {string} [options.$name] - The name of the variable.\n * @returns {string} The sanitized value.\n */\nexport function declareVar(\n  variable: string | number | boolean | null | undefined,\n  options?: { $name?: string }\n): string {\n  // Variable section.\n  const sanitizedVariable = sanitizeVar(String(variable ?? ''));\n  const variableSection = ` other {${sanitizedVariable}}`;\n\n  // Name section.\n  let nameSection = '';\n  if (options?.$name) {\n    const sanitizedName = sanitizeVar(options.$name);\n    nameSection = ` ${VAR_NAME_IDENTIFIER} {${sanitizedName}}`;\n  }\n\n  // interpolate\n  return `{${VAR_IDENTIFIER}, select,${variableSection}${nameSection}}`;\n}\n","/**\n * Marks content as derivable by the GT compiler and CLI.\n *\n * Use `derive()` when a translation string or context needs content that is\n * computed from source code, but should still be discovered during extraction\n * instead of treated as a runtime interpolation variable. The CLI attempts to\n * resolve the derivable expression into every possible static value and\n * includes those values in the source content that gets translated.\n *\n * `derive()` returns its argument unchanged at runtime.\n *\n * Run `gt validate` after adding or changing `derive()` calls to verify that\n * each derivable expression can be resolved by the CLI before translating or\n * building.\n *\n * @example\n * ```jsx\n * function getSubject() {\n *   return (Math.random() > 0.5) ? \"Alice\" : \"Brian\";\n * }\n * ...\n * gt(`My name is ${derive(getSubject())}`);\n * ```\n *\n * @param {T extends string | boolean | number | null | undefined} content - Content to derive for translation extraction.\n * @returns {T} The same content, unchanged at runtime.\n */\nexport function derive<T extends string | boolean | number | null | undefined>(\n  content: T\n): T {\n  return content;\n}\n"],"mappings":";;AAEA,MAAM,4BAA4B;CAChC,QAAQ,CAAC,SAAS;CAClB,MAAM,CAAC,OAAO;CACd,IAAI,CAAC,KAAK;CAEV,KAAK,CAAC,OAAO,KAAK;CAClB,MAAM,CAAC,OAAO;CACd,KAAK,CAAC,MAAM;CACZ,IAAI,CAAC,KAAK;CACV,IAAI,CAAC,KAAK;CACV,IAAI,CAAC,KAAK;CACV,MAAM,CAAC,OAAO;CACd,KAAK,CAAC,MAAM;CACZ,qBAAqB,CAAC,sBAAsB;CAC5C,QAAQ,CAAC,SAAS;CAClB,KAAK,CAAC,MAAM;CACZ,aAAa,CAAC,cAAc;CAC5B,iBAAiB,CAAC,kBAAkB;CACpC,iBAAiB,CAAC,kBAAkB;CACrC;;;;;;;AAQD,SAAgB,+BACd,MACA,IACS;AAET,QAD4C,0BAA0B,OACpD,SAAS,GAAG,IAAI;;;;ACjCpC,SAAgB,OAAO,MAAsB;AAC3C,KAAI,OAAO,WAAW,YAEpB,QAAO,OAAO,KAAK,MAAM,OAAO,CAAC,SAAS,SAAS;CAGrD,MAAM,QAAQ,IAAI,aAAa,CAAC,OAAO,KAAK;CAC5C,IAAI,SAAS;AACb,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,IAChC,WAAU,OAAO,aAAa,MAAM,GAAG;AAEzC,QAAO,KAAK,OAAO;;AAIrB,SAAgB,OAAO,QAAwB;AAC7C,KAAI,OAAO,WAAW,YAEpB,QAAO,OAAO,KAAK,QAAQ,SAAS,CAAC,SAAS,OAAO;CAGvD,MAAM,SAAS,KAAK,OAAO;CAC3B,MAAM,QAAQ,IAAI,WAAW,OAAO,OAAO;AAC3C,MAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,IACjC,OAAM,KAAK,OAAO,WAAW,EAAE;AAEjC,QAAO,IAAI,aAAa,CAAC,OAAO,MAAM;;;;;;;;;;;;;ACPxC,SAAgB,YAA4C,EAC1D,WACA,aACA,SACA,SAAS,EAAE,qBAAqB,MAAM,GAAG,kBAMhB;CACzB,MAAM,MAAM,MAAM,WAAW,aAAa;AAC1C,gBAAe,IAAI;AACnB,QAAO;CAEP,SAAS,eAAe,UAAwC;AAC9D,WAAS,IAAI,YAAY;;CAG3B,SAAS,YAAY,OAA6B;EAEhD,IAAI,UAAU;AACd,MAAI,YAAY,MAAM,EAAE;AACtB,WAAQ,MAAM;AACd,aAAU;;AAGZ,MAAI,CAAC,WAAW;OACV,MAAM,SAAS,KAAK,UAAU,MAAM,SAAS,KAAK,OACpD,QAAO,OAAO,MAAM,QAAQ,CACzB,KAAK,WAAW,OAAO,MAAM,CAC7B,IAAI,eAAe;YACb,MAAM,SAAS,KAAK,IAC7B,gBAAe,MAAM,SAAS;;;;;;ACrDtC,MAAa,iBAAiB;AAC9B,MAAa,sBAAsB;;;ACEnC,MAAa,8BAA8B,IAAI,OAC7C,IAAI,eAAe,OACpB;AAED,MAAa,gCAAgC,IAAI,OAAO,IAAI,eAAe,GAAG;;;ACC9E,SAAgB,yBACd,OACiC;AACjC,QACE,MAAM,SAAS,KAAK,UACpB,4BAA4B,KAAK,MAAM,MAAM,IAC7C,CAAC,CAAC,MAAM,QAAQ,UACf,MAAM,QAAQ,MAAM,MAAM,WAAW,KACnC,MAAM,QAAQ,MAAM,MAAM,SAAS,KAClC,MAAM,QAAQ,MAAM,MAAM,IAAI,SAAS,KAAK;;AAKpD,SAAgB,2BACd,OACmC;AACnC,QACE,MAAM,SAAS,KAAK,UACpB,8BAA8B,KAAK,MAAM,MAAM,IAC/C,CAAC,CAAC,MAAM,QAAQ,UACf,MAAM,QAAQ,MAAM,MAAM,WAAW,KACnC,MAAM,QAAQ,MAAM,MAAM,SAAS,KAClC,MAAM,QAAQ,MAAM,MAAM,IAAI,SAAS,KAAK;;;;;;;;;;;;ACZpD,SAAgB,WAAW,WAA2B;AAEpD,KAAI,CAAC,UAAU,SAAA,OAAwB,CACrC,QAAO;CAIT,MAAM,oBAAgC,EAAE;CACxC,SAAS,QAAQ,OAAuC;AACtD,oBAAkB,KAAK;GACrB,OAAO,MAAM,UAAU,MAAM,UAAU;GACvC,KAAK,MAAM,UAAU,IAAI,UAAU;GACnC,OACE,MAAM,QAAQ,MAAM,MAAM,SAAS,IAC/B,MAAM,QAAQ,MAAM,MAAM,GAAG,QAC7B;GACP,CAAC;;AAIJ,aAAY;EACV;EACA,aAAa;EACb;EACA,SAAS;GACP,oBAAoB;GACpB,iBAAiB;GAClB;EACF,CAAC;CAGF,IAAI,gBAAgB;CACpB,MAAM,aAAa,EAAE;AACrB,MAAK,IAAI,IAAI,GAAG,IAAI,kBAAkB,QAAQ,KAAK;AACjD,aAAW,KAAK,UAAU,MAAM,eAAe,kBAAkB,GAAG,MAAM,CAAC;AAC3E,aAAW,KAAK,kBAAkB,GAAG,MAAM;AAC3C,kBAAgB,kBAAkB,GAAG;;AAEvC,KAAI,gBAAgB,UAAU,OAC5B,YAAW,KAAK,UAAU,MAAM,cAAc,CAAC;AAIjD,QAFqB,WAAW,KAAK,GAElB;;;;;;;;;;;;;;;ACnDrB,SAAgB,YAAY,QAAwB;CAElD,IAAI,SAAS,OAAO,QAAQ,MAAM,KAAK;CAGvC,MAAM,eAAe;CACrB,MAAM,oBAAoB,OAAO,OAAO,aAAa;AAErD,KAAI,sBAAsB,GAExB,QAAO;CAIT,IAAI,mBAAmB;AACvB,MAAK,IAAI,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,IACtC,KAAI,aAAa,KAAK,OAAO,GAAG,EAAE;AAChC,qBAAmB;AACnB;;AAKJ,UACE,OAAO,MAAM,GAAG,kBAAkB,GAClC,MACA,OAAO,MAAM,mBAAmB,mBAAmB,EAAE,GACrD,MACA,OAAO,MAAM,mBAAmB,EAAE;AAEpC,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;ACfT,SAAgB,WACd,UACA,SACQ;CAGR,MAAM,kBAAkB,WADE,YAAY,OAAO,YAAY,GAAG,CACR,CAAC;CAGrD,IAAI,cAAc;AAClB,KAAI,SAAS,MAEX,eAAc,IAAI,oBAAoB,IADhB,YAAY,QAAQ,MACa,CAAC;AAI1D,QAAO,IAAI,eAAe,WAAW,kBAAkB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACfrE,SAAgB,OACd,SACG;AACH,QAAO"}
+{"version":3,"file":"derive-BRvTJxLf.mjs","names":[],"sources":["../src/utils/isSupportedFileFormatTransform.ts","../src/utils/base64.ts","../src/derive/utils/traverseIcu.ts","../src/derive/utils/constants.ts","../src/derive/utils/regex.ts","../src/derive/utils/traverseHelpers.ts","../src/derive/decodeVars.ts","../src/derive/utils/sanitizeVar.ts","../src/derive/declareVar.ts","../src/derive/derive.ts"],"sourcesContent":["import type { FileFormat } from '../types-dir/api/file';\n\nconst SUPPORTED_TRANSFORMATIONS = {\n  GTJSON: ['GTJSON'],\n  JSON: ['JSON'],\n  PO: ['PO'],\n  // POT templates can produce translated PO catalog files.\n  POT: ['POT', 'PO'],\n  YAML: ['YAML'],\n  MDX: ['MDX'],\n  MD: ['MD'],\n  TS: ['TS'],\n  JS: ['JS'],\n  HTML: ['HTML'],\n  TXT: ['TXT'],\n  TWILIO_CONTENT_JSON: ['TWILIO_CONTENT_JSON'],\n  LOTTIE: ['LOTTIE'],\n  SVG: ['SVG'],\n  DOT_STRINGS: ['DOT_STRINGS'],\n  DOT_STRINGSDICT: ['DOT_STRINGSDICT'],\n  ANDROID_STRINGS: ['ANDROID_STRINGS'],\n} as const satisfies Record<FileFormat, FileFormat[]>;\n\n/**\n * This function checks if a file format transformation is supported during translation\n * @param from - The source file format.\n * @param to - The target file format.\n * @returns True if the transformation is supported, false otherwise\n */\nexport function isSupportedFileFormatTransform(\n  from: FileFormat,\n  to: FileFormat\n): boolean {\n  const toFormats: FileFormat[] | undefined = SUPPORTED_TRANSFORMATIONS[from];\n  return toFormats?.includes(to) ?? false;\n}\n","// Encode a string to base64\nexport function encode(data: string): string {\n  if (typeof Buffer !== 'undefined') {\n    // Node.js path.\n    return Buffer.from(data, 'utf8').toString('base64');\n  }\n  // Browser path.\n  const bytes = new TextEncoder().encode(data);\n  let binary = '';\n  for (let i = 0; i < bytes.length; i++) {\n    binary += String.fromCharCode(bytes[i]);\n  }\n  return btoa(binary);\n}\n\n// Decode a base64 string to a string\nexport function decode(base64: string): string {\n  if (typeof Buffer !== 'undefined') {\n    // Node.js path.\n    return Buffer.from(base64, 'base64').toString('utf8');\n  }\n  // Browser path.\n  const binary = atob(base64);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i);\n  }\n  return new TextDecoder().decode(bytes);\n}\n","import {\n  parse,\n  TYPE,\n  type MessageFormatElement,\n  type ParserOptions,\n} from '@generaltranslation/icu';\n\ntype TraverseIcuOptions = ParserOptions & {\n  recurseIntoVisited?: boolean;\n};\n\n/**\n * Given an ICU string, traverse the AST and call the visitor function for each element that matches the type T\n * @param icu - The ICU string to traverse\n * @param shouldVisit - A function that returns true if the element should be visited\n * @param visitor - A function that is called for each element that matches the type T\n * @returns The modified AST of the ICU string.\n *\n * @note This function is a heavy operation, use sparingly\n */\nexport function traverseIcu<T extends MessageFormatElement>({\n  icuString,\n  shouldVisit,\n  visitor,\n  options: { recurseIntoVisited = true, ...otherOptions },\n}: {\n  icuString: string;\n  shouldVisit: (element: MessageFormatElement) => element is T;\n  visitor: (element: T) => void;\n  options: TraverseIcuOptions;\n}): MessageFormatElement[] {\n  const ast = parse(icuString, otherOptions);\n  handleChildren(ast);\n  return ast;\n\n  function handleChildren(children: MessageFormatElement[]): void {\n    children.map(handleChild);\n  }\n\n  function handleChild(child: MessageFormatElement) {\n    // handle select var\n    let visited = false;\n    if (shouldVisit(child)) {\n      visitor(child);\n      visited = true;\n    }\n    // recurse on children\n    if (!visited || recurseIntoVisited) {\n      if (child.type === TYPE.select || child.type === TYPE.plural) {\n        Object.values(child.options)\n          .map((option) => option.value)\n          .map(handleChildren);\n      } else if (child.type === TYPE.tag) {\n        handleChildren(child.children);\n      }\n    }\n  }\n}\n","export const VAR_IDENTIFIER = '_gt_';\nexport const VAR_NAME_IDENTIFIER = '_gt_var_name';\n","import { VAR_IDENTIFIER } from './constants';\n\n// Regex  for _gt_# select\nexport const GT_INDEXED_IDENTIFIER_REGEX = new RegExp(\n  `^${VAR_IDENTIFIER}\\\\d+$`\n);\n\nexport const GT_UNINDEXED_IDENTIFIER_REGEX = new RegExp(`^${VAR_IDENTIFIER}$`);\n","import {\n  GT_INDEXED_IDENTIFIER_REGEX,\n  GT_UNINDEXED_IDENTIFIER_REGEX,\n} from './regex';\nimport { GTIndexedSelectElement, GTUnindexedSelectElement } from './types';\nimport { TYPE, type MessageFormatElement } from '@generaltranslation/icu';\n\n// Visit any _gt_# select\nexport function isGTIndexedSelectElement(\n  child: MessageFormatElement\n): child is GTIndexedSelectElement {\n  return (\n    child.type === TYPE.select &&\n    GT_INDEXED_IDENTIFIER_REGEX.test(child.value) &&\n    !!child.options.other &&\n    (child.options.other.value.length === 0 ||\n      (child.options.other.value.length > 0 &&\n        child.options.other.value[0]?.type === TYPE.literal))\n  );\n}\n\n// Visit any _gt_ select\nexport function isGTUnindexedSelectElement(\n  child: MessageFormatElement\n): child is GTUnindexedSelectElement {\n  return (\n    child.type === TYPE.select &&\n    GT_UNINDEXED_IDENTIFIER_REGEX.test(child.value) &&\n    !!child.options.other &&\n    (child.options.other.value.length === 0 ||\n      (child.options.other.value.length > 0 &&\n        child.options.other.value[0]?.type === TYPE.literal))\n  );\n}\n","import { traverseIcu } from './utils/traverseIcu';\nimport { VAR_IDENTIFIER } from './utils/constants';\nimport { GTUnindexedSelectElement } from './utils/types';\nimport { isGTUnindexedSelectElement } from './utils/traverseHelpers';\n\ntype Location = {\n  start: number;\n  end: number;\n  value: string;\n};\n\n/**\n * Given an encoded ICU string, interpolate only _gt_ variables that have been marked with declareVar()\n * @example\n * const encodedIcu = \"Hi\" + declareVar(\"Brian\") + \", my name is {name}\"\n * // 'Hi {_gt_, select, other {Brian}}, my name is {name}'\n * decodeVars(encodedIcu)\n * // 'Hi Brian, my name is {name}'\n */\nexport function decodeVars(icuString: string): string {\n  // Check if the string contains _gt_\n  if (!icuString.includes(VAR_IDENTIFIER)) {\n    return icuString;\n  }\n\n  // Record the location of the variable\n  const variableLocations: Location[] = [];\n  function visitor(child: GTUnindexedSelectElement): void {\n    variableLocations.push({\n      start: child.location?.start.offset ?? 0,\n      end: child.location?.end.offset ?? 0,\n      value:\n        child.options.other.value.length > 0\n          ? child.options.other.value[0].value\n          : '',\n    });\n  }\n\n  // Find all variable identifiers.\n  traverseIcu({\n    icuString,\n    shouldVisit: isGTUnindexedSelectElement,\n    visitor,\n    options: {\n      recurseIntoVisited: false,\n      captureLocation: true,\n    },\n  });\n\n  // Construct output string\n  let previousIndex = 0;\n  const outputList = [];\n  for (let i = 0; i < variableLocations.length; i++) {\n    outputList.push(icuString.slice(previousIndex, variableLocations[i].start));\n    outputList.push(variableLocations[i].value);\n    previousIndex = variableLocations[i].end;\n  }\n  if (previousIndex < icuString.length) {\n    outputList.push(icuString.slice(previousIndex));\n  }\n  const outputString = outputList.join('');\n\n  return outputString;\n}\n","/**\n * Sanitizes string by escaping ICU syntax\n *\n * Sanitize arbitrary string so it does not break the following ICU message syntax:\n * {_gt_, select, other {string_here}}\n *\n * Escapes ICU special characters by:\n * 1. Doubling all single quotes (U+0027 ')\n * 2. Adding a single quote before the first special character ({}<>)\n * 3. Adding a single quote after the last special character ({}<>)\n */\nexport function sanitizeVar(string: string): string {\n  // First, double all single quotes (both ASCII and Unicode).\n  let result = string.replace(/'/g, \"''\");\n\n  // Find first and last positions of special characters\n  const specialChars = /[{}<>]/;\n  const firstSpecialIndex = result.search(specialChars);\n\n  if (firstSpecialIndex === -1) {\n    // No special characters; return with just doubled quotes.\n    return result;\n  }\n\n  // Find last special character position\n  let lastSpecialIndex = -1;\n  for (let i = result.length - 1; i >= 0; i--) {\n    if (specialChars.test(result[i])) {\n      lastSpecialIndex = i;\n      break;\n    }\n  }\n\n  // Insert quotes around the special character region.\n  result =\n    result.slice(0, firstSpecialIndex) +\n    \"'\" +\n    result.slice(firstSpecialIndex, lastSpecialIndex + 1) +\n    \"'\" +\n    result.slice(lastSpecialIndex + 1);\n\n  return result;\n}\n","import { VAR_IDENTIFIER, VAR_NAME_IDENTIFIER } from './utils/constants';\nimport { sanitizeVar } from './utils/sanitizeVar';\n\n/**\n * Mark as a non-translatable string. Use within a derive() call to mark content as not derivable (e.g., not possible to statically analyze).\n *\n * @example\n * function nonDerivableFunction() {\n *   return Math.random();\n * }\n *\n * function derivableFunction() {\n *   if (condition) {\n *     return declareVar(nonDerivableFunction())\n *   }\n *   return 'John Doe';\n * }\n *\n * const gt = useGT();\n * gt(`My name is ${derive(derivableFunction())}`);\n *\n * @param {string | number | boolean | null | undefined} variable - The variable to sanitize.\n * @param {Object} [options] - The options for the sanitization.\n * @param {string} [options.$name] - The name of the variable.\n * @returns {string} The sanitized value.\n */\nexport function declareVar(\n  variable: string | number | boolean | null | undefined,\n  options?: { $name?: string }\n): string {\n  // Variable section.\n  const sanitizedVariable = sanitizeVar(String(variable ?? ''));\n  const variableSection = ` other {${sanitizedVariable}}`;\n\n  // Name section.\n  let nameSection = '';\n  if (options?.$name) {\n    const sanitizedName = sanitizeVar(options.$name);\n    nameSection = ` ${VAR_NAME_IDENTIFIER} {${sanitizedName}}`;\n  }\n\n  // interpolate\n  return `{${VAR_IDENTIFIER}, select,${variableSection}${nameSection}}`;\n}\n","/**\n * Marks content as derivable by the GT compiler and CLI.\n *\n * Use `derive()` when a translation string or context needs content that is\n * computed from source code, but should still be discovered during extraction\n * instead of treated as a runtime interpolation variable. The CLI attempts to\n * resolve the derivable expression into every possible static value and\n * includes those values in the source content that gets translated.\n *\n * `derive()` returns its argument unchanged at runtime.\n *\n * Run `gt validate` after adding or changing `derive()` calls to verify that\n * each derivable expression can be resolved by the CLI before translating or\n * building.\n *\n * @example\n * ```jsx\n * function getSubject() {\n *   return (Math.random() > 0.5) ? \"Alice\" : \"Brian\";\n * }\n * ...\n * gt(`My name is ${derive(getSubject())}`);\n * ```\n *\n * @param {T extends string | boolean | number | null | undefined} content - Content to derive for translation extraction.\n * @returns {T} The same content, unchanged at runtime.\n */\nexport function derive<T extends string | boolean | number | null | undefined>(\n  content: T\n): T {\n  return content;\n}\n"],"mappings":"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"}

package/dist/{file-D7gKavRj.cjs → file-B37WkCqM.cjs}

@@ -4,12 +4,12 @@
 * base64-encoded, so the usual UTF-8 encode/decode steps are skipped and the
 * bytes reach the API unaltered.
 *
-* LOTTIE qualifies because it is a zip bundle. DOT_STRINGS qualifies because
-* older Xcode wrote `.strings` as UTF-16: the API chooses a decoder from the
-* byte order mark, and a UTF-8 round trip anywhere in between replaces those
-* bytes with U+FFFD.
+* LOTTIE qualifies because it is a zip bundle. Apple's `.strings` and
+* `.stringsdict` do not: they are text in whichever encoding Xcode wrote, and
+* the client decodes that to UTF-8 before upload and restores it on write, so
+* only the client ever handles their bytes.
 */
-const BINARY_FILE_FORMATS = new Set(["LOTTIE", "DOT_STRINGS"]);
+const BINARY_FILE_FORMATS = new Set(["LOTTIE"]);
 /**
 * Whether a file format's content is carried as base64 end-to-end rather than
 * as a UTF-8 text string.
@@ -31,4 +31,4 @@ Object.defineProperty(exports, "isBinaryFileFormat", {
 	}
 });
 
-//# sourceMappingURL=file-D7gKavRj.cjs.map
+//# sourceMappingURL=file-B37WkCqM.cjs.map

package/dist/file-B37WkCqM.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-B37WkCqM.cjs","names":[],"sources":["../src/types-dir/api/file.ts"],"sourcesContent":["import type { DataFormat } from '@generaltranslation/format/types';\nimport { Updates } from './enqueueFiles';\nimport type { JsonObject } from './json';\n\nexport type FileFormat = import('@generaltranslation/api').FileFormat;\n\n/**\n * File formats whose content travels through the pipeline already\n * base64-encoded, so the usual UTF-8 encode/decode steps are skipped and the\n * bytes reach the API unaltered.\n *\n * LOTTIE qualifies because it is a zip bundle. Apple's `.strings` and\n * `.stringsdict` do not: they are text in whichever encoding Xcode wrote, and\n * the client decodes that to UTF-8 before upload and restores it on write, so\n * only the client ever handles their bytes.\n */\nexport const BINARY_FILE_FORMATS: ReadonlySet<FileFormat> = new Set<FileFormat>(\n  ['LOTTIE']\n);\n\n/**\n * Whether a file format's content is carried as base64 end-to-end rather than\n * as a UTF-8 text string.\n */\nexport function isBinaryFileFormat(fileFormat: FileFormat): boolean {\n  return BINARY_FILE_FORMATS.has(fileFormat);\n}\n\n/**\n * Metadata for files or entries.\n */\nexport type FormatMetadata = JsonObject | Updates[number]['metadata'];\n\n/**\n * File object structure for uploading files.\n * @see {@link FileReferenceOptionalBranchId}\n * @property {string} content - Content of the file.\n * @property {string} locale - The locale of the file (e.g. 'en', 'de', 'es', etc.)\n * @property {FormatMetadata} [formatMetadata] - Optional metadata for the file, specific to the format of the file\n * @property {string} [incomingBranchId] - The ID of the incoming branch of the file.\n * @property {string} [checkedOutBranchId] - The ID of the checked-out branch of the file.\n */\nexport type FileToUpload = Omit<FileReference, 'branchId'> & {\n  content: string;\n  locale: string;\n  // Optional output format requested for generated translations.\n  transformFormat?: FileFormat;\n  formatMetadata?: FormatMetadata;\n  branchId?: string;\n  incomingBranchId?: string;\n  checkedOutBranchId?: string;\n};\n\n/**\n * File object structure for referencing files.\n * @property {string} fileId - The ID of the file.\n * @property {string} versionId - The ID of the version of the file\n * @property {string} branchId - The ID of the branch of the file\n * @property {string} locale - The locale of the file (e.g. 'en', 'de', 'es', etc.)\n * @property {string} fileName - The name of the file.\n * @property {FileFormat} fileFormat - The format of the file (JSON, MDX, MD, etc.).\n * @property {DataFormat} [dataFormat] - Optional format of the data within the file.\n */\nexport type FileReference = {\n  fileId: string;\n  versionId: string;\n  branchId: string;\n  fileName: string;\n  fileFormat: FileFormat;\n  // Optional output format requested for generated translations.\n  transformFormat?: FileFormat;\n  dataFormat?: DataFormat;\n};\n\n/**\n * File reference object structure for referencing files.\n * @see {@link FileReference}\n * @property {string} [branchId] - The ID of the branch of the file\n */\nexport type FileReferenceIds = Omit<\n  FileReference,\n  'branchId' | 'fileName' | 'fileFormat' | 'dataFormat'\n> & {\n  branchId?: string;\n  fileName?: string;\n  fileFormat?: FileFormat;\n  transformFormat?: FileFormat;\n  dataFormat?: DataFormat;\n};\n"],"mappings":";;;;;;;;;;;AAgBA,MAAa,sBAA+C,IAAI,IAC9D,CAAC,SAAS,CACX;;;;;AAMD,SAAgB,mBAAmB,YAAiC;AAClE,QAAO,oBAAoB,IAAI,WAAW"}

package/dist/{file-Cgk1Xk9d.mjs → file-Dga6cyM8.mjs}

@@ -4,12 +4,12 @@
 * base64-encoded, so the usual UTF-8 encode/decode steps are skipped and the
 * bytes reach the API unaltered.
 *
-* LOTTIE qualifies because it is a zip bundle. DOT_STRINGS qualifies because
-* older Xcode wrote `.strings` as UTF-16: the API chooses a decoder from the
-* byte order mark, and a UTF-8 round trip anywhere in between replaces those
-* bytes with U+FFFD.
+* LOTTIE qualifies because it is a zip bundle. Apple's `.strings` and
+* `.stringsdict` do not: they are text in whichever encoding Xcode wrote, and
+* the client decodes that to UTF-8 before upload and restores it on write, so
+* only the client ever handles their bytes.
 */
-const BINARY_FILE_FORMATS = new Set(["LOTTIE", "DOT_STRINGS"]);
+const BINARY_FILE_FORMATS = new Set(["LOTTIE"]);
 /**
 * Whether a file format's content is carried as base64 end-to-end rather than
 * as a UTF-8 text string.
@@ -20,4 +20,4 @@ function isBinaryFileFormat(fileFormat) {
 //#endregion
 export { isBinaryFileFormat as n, BINARY_FILE_FORMATS as t };
 
-//# sourceMappingURL=file-Cgk1Xk9d.mjs.map
+//# sourceMappingURL=file-Dga6cyM8.mjs.map

package/dist/file-Dga6cyM8.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-Dga6cyM8.mjs","names":[],"sources":["../src/types-dir/api/file.ts"],"sourcesContent":["import type { DataFormat } from '@generaltranslation/format/types';\nimport { Updates } from './enqueueFiles';\nimport type { JsonObject } from './json';\n\nexport type FileFormat = import('@generaltranslation/api').FileFormat;\n\n/**\n * File formats whose content travels through the pipeline already\n * base64-encoded, so the usual UTF-8 encode/decode steps are skipped and the\n * bytes reach the API unaltered.\n *\n * LOTTIE qualifies because it is a zip bundle. Apple's `.strings` and\n * `.stringsdict` do not: they are text in whichever encoding Xcode wrote, and\n * the client decodes that to UTF-8 before upload and restores it on write, so\n * only the client ever handles their bytes.\n */\nexport const BINARY_FILE_FORMATS: ReadonlySet<FileFormat> = new Set<FileFormat>(\n  ['LOTTIE']\n);\n\n/**\n * Whether a file format's content is carried as base64 end-to-end rather than\n * as a UTF-8 text string.\n */\nexport function isBinaryFileFormat(fileFormat: FileFormat): boolean {\n  return BINARY_FILE_FORMATS.has(fileFormat);\n}\n\n/**\n * Metadata for files or entries.\n */\nexport type FormatMetadata = JsonObject | Updates[number]['metadata'];\n\n/**\n * File object structure for uploading files.\n * @see {@link FileReferenceOptionalBranchId}\n * @property {string} content - Content of the file.\n * @property {string} locale - The locale of the file (e.g. 'en', 'de', 'es', etc.)\n * @property {FormatMetadata} [formatMetadata] - Optional metadata for the file, specific to the format of the file\n * @property {string} [incomingBranchId] - The ID of the incoming branch of the file.\n * @property {string} [checkedOutBranchId] - The ID of the checked-out branch of the file.\n */\nexport type FileToUpload = Omit<FileReference, 'branchId'> & {\n  content: string;\n  locale: string;\n  // Optional output format requested for generated translations.\n  transformFormat?: FileFormat;\n  formatMetadata?: FormatMetadata;\n  branchId?: string;\n  incomingBranchId?: string;\n  checkedOutBranchId?: string;\n};\n\n/**\n * File object structure for referencing files.\n * @property {string} fileId - The ID of the file.\n * @property {string} versionId - The ID of the version of the file\n * @property {string} branchId - The ID of the branch of the file\n * @property {string} locale - The locale of the file (e.g. 'en', 'de', 'es', etc.)\n * @property {string} fileName - The name of the file.\n * @property {FileFormat} fileFormat - The format of the file (JSON, MDX, MD, etc.).\n * @property {DataFormat} [dataFormat] - Optional format of the data within the file.\n */\nexport type FileReference = {\n  fileId: string;\n  versionId: string;\n  branchId: string;\n  fileName: string;\n  fileFormat: FileFormat;\n  // Optional output format requested for generated translations.\n  transformFormat?: FileFormat;\n  dataFormat?: DataFormat;\n};\n\n/**\n * File reference object structure for referencing files.\n * @see {@link FileReference}\n * @property {string} [branchId] - The ID of the branch of the file\n */\nexport type FileReferenceIds = Omit<\n  FileReference,\n  'branchId' | 'fileName' | 'fileFormat' | 'dataFormat'\n> & {\n  branchId?: string;\n  fileName?: string;\n  fileFormat?: FileFormat;\n  transformFormat?: FileFormat;\n  dataFormat?: DataFormat;\n};\n"],"mappings":";;;;;;;;;;;AAgBA,MAAa,sBAA+C,IAAI,IAC9D,CAAC,SAAS,CACX;;;;;AAMD,SAAgB,mBAAmB,YAAiC;AAClE,QAAO,oBAAoB,IAAI,WAAW"}

package/dist/id.d.cts

@@ -1,4 +1,4 @@
-import { kt as HashMetadata, m as JsxChildren } from "./types-DO3dc8ST.cjs";
+import { kt as HashMetadata, m as JsxChildren } from "./types-Do446qa9.cjs";
 
 //#region src/id/hashSource.d.ts
 /**

package/dist/id.d.mts

@@ -1,4 +1,4 @@
-import { kt as HashMetadata, m as JsxChildren } from "./types-C8sSACgY.mjs";
+import { kt as HashMetadata, m as JsxChildren } from "./types-BUNfoXph.mjs";
 
 //#region src/id/hashSource.d.ts
 /**

package/dist/index.cjs

@@ -1,9 +1,114 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_api = require("./api-tMgy8sHj.cjs");
-const require_runtime = require("./runtime-DoOLkKJT.cjs");
+const require_unwrapApiResult = require("./unwrapApiResult-Dv6Mfw_K.cjs");
+const require_runtime = require("./runtime-DeF1Ef5w.cjs");
 const require_derive = require("./derive-bDBg-KyF.cjs");
-const require_file = require("./file-D7gKavRj.cjs");
+const require_file = require("./file-B37WkCqM.cjs");
 let _generaltranslation_format = require("@generaltranslation/format");
+let _generaltranslation_api = require("@generaltranslation/api");
+//#region src/translate/utils/handleFetchError.ts
+function handleFetchError(error, timeout) {
+	if (error instanceof Error && error.name === "AbortError") {
+		const errorMessage = require_runtime.translationTimeoutError(timeout);
+		require_runtime.fetchLogger.error(errorMessage);
+		throw new Error(errorMessage);
+	}
+	const errorMessage = require_runtime.translationRequestFailedError(error instanceof Error ? error.message : String(error));
+	require_runtime.fetchLogger.error(errorMessage);
+	throw error;
+}
+//#endregion
+//#region src/translate/utils/generateRequestHeaders.ts
+function generateRequestHeaders(config, excludeContentType = false) {
+	const authHeaders = {
+		...!excludeContentType && { "Content-Type": "application/json" },
+		"gt-project-id": config.projectId
+	};
+	if (config.apiKey) authHeaders["Authorization"] = `Bearer ${config.apiKey}`;
+	authHeaders["gt-api-version"] = _generaltranslation_api.API_VERSION;
+	return authHeaders;
+}
+//#endregion
+//#region src/translate/utils/apiRequest.ts
+const MAX_RETRIES = 3;
+const INITIAL_DELAY_MS = 500;
+const RATE_LIMIT_RETRY_DELAY_MS = 6e4;
+const MS_PER_SECOND = 1e3;
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function getRetryDelay(policy, attempt) {
+	switch (policy) {
+		case "linear": return INITIAL_DELAY_MS * (attempt + 1);
+		case "exponential": return INITIAL_DELAY_MS * 2 ** attempt;
+		default: return 0;
+	}
+}
+function parseDelayMs(value) {
+	if (!value) return;
+	const seconds = Number(value.split(",")[0].split(";")[0].trim());
+	if (!Number.isFinite(seconds) || seconds < 0) return;
+	return seconds * MS_PER_SECOND;
+}
+function parseRetryAfter(value) {
+	const delayMs = parseDelayMs(value);
+	if (delayMs !== void 0) return delayMs;
+	if (!value) return;
+	const retryDate = Date.parse(value);
+	if (Number.isNaN(retryDate)) return;
+	return Math.max(retryDate - Date.now(), 0);
+}
+function getRateLimitRetryDelay(response) {
+	return parseRetryAfter(response.headers.get("Retry-After")) ?? parseDelayMs(response.headers.get("RateLimit-Reset")) ?? RATE_LIMIT_RETRY_DELAY_MS;
+}
+function getResponseRetryDelay(response, policy, attempt) {
+	if (response.status === 429) return getRateLimitRetryDelay(response);
+	return getRetryDelay(policy, attempt);
+}
+/**
+* @internal
+*
+* Makes an API request with automatic retry for 429 and 5XX errors.
+*
+* Encapsulates URL construction, fetch with timeout, error handling,
+* response validation, and JSON parsing.
+*
+* @param config - The configuration for the API call.
+* @param endpoint - The API endpoint path (e.g. '/v2/project/jobs/info')
+* @param options - Optional request options.
+* @returns The parsed JSON response.
+*/
+async function apiRequest(config, endpoint, options) {
+	const timeout = options?.timeout ?? 6e4;
+	const retryPolicy = options?.retryPolicy ?? "exponential";
+	const url = `${config.baseUrl || "https://api.gtx.dev"}${endpoint}`;
+	const method = options?.method ?? "POST";
+	const maxRetries = retryPolicy === "none" ? 0 : MAX_RETRIES;
+	const requestInit = {
+		method,
+		headers: generateRequestHeaders(config)
+	};
+	if (options?.body !== void 0) requestInit.body = JSON.stringify(options.body);
+	for (let attempt = 0; attempt <= maxRetries; attempt++) {
+		let response;
+		try {
+			response = await require_runtime.fetchWithTimeout(url, requestInit, timeout);
+		} catch (error) {
+			if (attempt < maxRetries) {
+				await sleep(getRetryDelay(retryPolicy, attempt));
+				continue;
+			}
+			handleFetchError(error, timeout);
+		}
+		if ((response.status === 429 || response.status >= 500) && attempt < maxRetries) {
+			await sleep(getResponseRetryDelay(response, retryPolicy, attempt));
+			continue;
+		}
+		await require_runtime.validateResponse(response);
+		return await response.json();
+	}
+	throw new Error("Max retries exceeded");
+}
+//#endregion
 //#region src/translate/setupProject.ts
 /**
 * @internal
@@ -14,7 +119,7 @@ let _generaltranslation_format = require("@generaltranslation/format");
 * @returns The result of the API call.
 */
 async function _setupProject(files, config, options) {
-	return require_runtime.apiRequest(config, "/v2/project/setup/generate", {
+	return apiRequest(config, "/v2/project/setup/generate", {
 		body: {
 			files: files.map((f) => ({
 				branchId: f.branchId,
@@ -120,7 +225,7 @@ function validateFileFormatTransforms(files) {
 async function _enqueueFiles(files, options, config) {
 	validateFileFormatTransforms(files);
 	const result = await processBatches(files, async (batch) => {
-		const apiResult = await require_runtime.apiRequest(config, "/v2/project/translations/enqueue", {
+		const apiResult = await apiRequest(config, "/v2/project/translations/enqueue", {
 			body: {
 				files: batch.map((f) => ({
 					branchId: f.branchId,
@@ -154,7 +259,7 @@ async function _enqueueFiles(files, options, config) {
 * @returns The created or updated tag.
 */
 async function _createTag(options, config) {
-	return await require_runtime.apiRequest(config, "/v2/project/tags/create", { body: {
+	return await apiRequest(config, "/v2/project/tags/create", { body: {
 		tagId: options.tagId,
 		files: options.files,
 		...options.message && { message: options.message }
@@ -172,7 +277,7 @@ async function _createTag(options, config) {
 */
 async function _downloadFileBatch(requests, options, config) {
 	return processBatches(requests, async (batch) => {
-		return (await require_runtime.apiRequest(config, "/v2/project/files/download", {
+		return (await apiRequest(config, "/v2/project/files/download", {
 			body: batch,
 			timeout: options.timeout
 		})).files.map((file) => ({
@@ -189,7 +294,7 @@ async function _downloadFileBatch(requests, options, config) {
 */
 async function _submitUserEditDiffs(payload, config, options = {}) {
 	await processBatches(payload.diffs, async (batch) => {
-		await require_runtime.apiRequest(config, "/v2/project/files/diffs", {
+		await apiRequest(config, "/v2/project/files/diffs", {
 			body: { diffs: batch },
 			timeout: options.timeout
 		});
@@ -209,7 +314,7 @@ async function _submitUserEditDiffs(payload, config, options = {}) {
 */
 async function _uploadSourceFiles(files, options, config) {
 	return processBatches(files, async (batch) => {
-		return (await require_runtime.apiRequest(config, "/v2/project/files/upload-files", {
+		return (await apiRequest(config, "/v2/project/files/upload-files", {
 			body: {
 				data: batch.map(({ source }) => ({ source: {
 					content: require_file.isBinaryFileFormat(source.fileFormat) ? source.content : require_derive.encode(source.content),
@@ -241,7 +346,7 @@ const FONT_UPLOAD_BATCH_SIZE = 50;
 */
 async function _uploadFonts(fonts, options, config) {
 	return processBatches(fonts, async (batch) => {
-		return (await require_runtime.apiRequest(config, "/v2/project/assets", {
+		return (await apiRequest(config, "/v2/project/assets", {
 			body: { assets: batch.map((font) => ({
 				assetType: font.assetType,
 				content: font.content,
@@ -264,7 +369,7 @@ async function _uploadFonts(fonts, options, config) {
 async function _uploadTranslations(files, options, config) {
 	validateFileFormatTransforms(files.map(({ source }) => source));
 	return processBatches(files, async (batch) => {
-		return (await require_runtime.apiRequest(config, "/v2/project/files/upload-translations", {
+		return (await apiRequest(config, "/v2/project/files/upload-translations", {
 			body: {
 				data: batch.map(({ source, translations }) => ({
 					source: {
@@ -313,7 +418,7 @@ async function _querySourceFile(query, options, config) {
 	const searchParams = new URLSearchParams();
 	if (branchId) searchParams.set("branchId", branchId);
 	if (versionId) searchParams.set("versionId", versionId);
-	return require_runtime.apiRequest(config, `/v2/project/translations/files/status/${encodeURIComponent(fileId)}?${searchParams.toString()}`, {
+	return apiRequest(config, `/v2/project/translations/files/status/${encodeURIComponent(fileId)}?${searchParams.toString()}`, {
 		method: "GET",
 		timeout: options.timeout
 	});
@@ -330,16 +435,16 @@ async function _querySourceFile(query, options, config) {
 */
 async function _getProjectData(projectId, options, config) {
 	const { baseUrl } = config;
-	const timeout = options.timeout ? options.timeout : require_api.defaultTimeout;
-	const url = `${baseUrl || "https://api2.gtx.dev"}/v2/project/info/${encodeURIComponent(projectId)}`;
+	const timeout = options.timeout ? options.timeout : require_unwrapApiResult.defaultTimeout;
+	const url = `${baseUrl || "https://api.gtx.dev"}/v2/project/info/${encodeURIComponent(projectId)}`;
 	let response;
 	try {
 		response = await require_runtime.fetchWithTimeout(url, {
 			method: "GET",
-			headers: require_runtime.generateRequestHeaders(config)
+			headers: generateRequestHeaders(config)
 		}, timeout);
 	} catch (error) {
-		require_runtime.handleFetchError(error, timeout);
+		handleFetchError(error, timeout);
 	}
 	await require_runtime.validateResponse(response);
 	return await response.json();
@@ -355,7 +460,7 @@ async function _getProjectData(projectId, options, config) {
 * @returns The result of the API call.
 */
 async function _checkJobStatus(jobIds, config, timeoutMs) {
-	return require_runtime.apiRequest(config, "/v2/project/jobs/info", {
+	return apiRequest(config, "/v2/project/jobs/info", {
 		body: { jobIds },
 		timeout: timeoutMs
 	});
@@ -388,7 +493,7 @@ async function _awaitJobIds(jobIds, options, config) {
 		if (remainingTime <= 0) break;
 		let statuses;
 		try {
-			statuses = await _checkJobStatus(Array.from(pendingJobIds), config, Math.min(remainingTime, require_api.defaultTimeout));
+			statuses = await _checkJobStatus(Array.from(pendingJobIds), config, Math.min(remainingTime, require_unwrapApiResult.defaultTimeout));
 		} catch (error) {
 			if (Date.now() >= deadline) break;
 			throw error;
@@ -434,7 +539,7 @@ async function _awaitJobIds(jobIds, options, config) {
 * @returns The file data.
 */
 async function _queryFileData(data, options = {}, config) {
-	return require_runtime.apiRequest(config, "/v2/project/files/info", {
+	return apiRequest(config, "/v2/project/files/info", {
 		body: {
 			sourceFiles: data.sourceFiles?.map((item) => ({
 				fileId: item.fileId,
@@ -461,7 +566,7 @@ async function _queryFileData(data, options = {}, config) {
 * @returns The project info.
 */
 async function _getProjectInfo(options, config) {
-	return require_runtime.apiRequest(config, `/v2/project/info/${config.projectId}`, {
+	return apiRequest(config, `/v2/project/info/${config.projectId}`, {
 		method: "GET",
 		timeout: options.timeout
 	});
@@ -476,7 +581,7 @@ async function _getProjectInfo(options, config) {
 * @returns The branch information.
 */
 async function _queryBranchData(query, config) {
-	return require_runtime.apiRequest(config, "/v2/project/branches/info", { body: query });
+	return apiRequest(config, "/v2/project/branches/info", { body: query });
 }
 //#endregion
 //#region src/translate/createBranch.ts
@@ -488,7 +593,7 @@ async function _queryBranchData(query, config) {
 * @returns The created branch information.
 */
 async function _createBranch(query, config) {
-	return require_runtime.apiRequest(config, "/v2/project/branches/create", { body: query });
+	return apiRequest(config, "/v2/project/branches/create", { body: query });
 }
 //#endregion
 //#region src/translate/processFileMoves.ts
@@ -511,7 +616,7 @@ async function _processFileMoves(moves, options, config) {
 		}
 	};
 	const batchResult = await processBatches(moves, async (batch) => {
-		return (await require_runtime.apiRequest(config, "/v2/project/files/moves", {
+		return (await apiRequest(config, "/v2/project/files/moves", {
 			body: {
 				branchId: options.branchId,
 				moves: batch
@@ -544,7 +649,7 @@ async function _processFileMoves(moves, options, config) {
 * @returns The orphaned files
 */
 async function _getOrphanedFiles(branchId, fileIds, options = {}, config) {
-	const makeRequest = (batchFileIds) => require_runtime.apiRequest(config, "/v2/project/files/orphaned", {
+	const makeRequest = (batchFileIds) => apiRequest(config, "/v2/project/files/orphaned", {
 		body: {
 			branchId,
 			fileIds: batchFileIds
@@ -575,7 +680,7 @@ async function _getOrphanedFiles(branchId, fileIds, options = {}, config) {
 * @returns The result of the API call.
 */
 async function _publishFiles(files, config) {
-	return await require_runtime.apiRequest(config, "/v2/project/files/publish", { body: { files } });
+	return await apiRequest(config, "/v2/project/files/publish", { body: { files } });
 }
 //#endregion
 //#region src/index.ts