@intlayer/api 9.6.0 → 9.7.1

package/dist/cjs/public/createPublicClient.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"createPublicClient.cjs","names":["editor"],"sources":["../../../src/public/createPublicClient.ts"],"sourcesContent":["import type { DictionaryAPI } from '@intlayer/backend';\nimport { editor } from '@intlayer/config/built';\nimport type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Browser-safe Intlayer client, authenticated without any confidential\n * credential.\n *\n * This is the Google-Analytics model applied to the whole SDK: the page ships\n * only the **public** `editor.clientId`, exchanges it for a short-lived scoped\n * token, and calls the API directly. No server route, no server action, and no\n * `clientSecret` in the bundle.\n *\n * What it can do is deliberately narrow, and that is what makes shipping the\n * key safe: read the project's published dictionary content — the content the\n * page already renders — and submit analytics events. Writing content, reading\n * a project, an organization or a user still require a real credential\n * (server-side) or a signed-in user.\n *\n * @example\n * ```ts\n * import { createPublicClient } from '@intlayer/api/public';\n *\n * const client = createPublicClient();\n *\n * const keys = await client.getDictionaryKeys();\n * const [dictionary] = await client.getDictionaries(['navbar']);\n * ```\n */\n\n/** `sessionStorage` key holding the cached token for this tab. */\nconst TOKEN_STORAGE_KEY = '__intlayer_public_token__';\n\n/**\n * Refresh margin: a token within this window of expiry is treated as expired,\n * so a request is never sent with a token that dies in flight.\n */\nconst EXPIRY_MARGIN_MS = 60 * 1000;\n\ntype CachedToken = {\n  token: string;\n  /** Epoch milliseconds. */\n  expiresAt: number;\n};\n\n/** Reads the cached token for this tab, ignoring an unusable cache. */\nconst readStoredToken = (): CachedToken | null => {\n  try {\n    const raw = globalThis.sessionStorage?.getItem(TOKEN_STORAGE_KEY);\n    if (!raw) return null;\n\n    const parsed = JSON.parse(raw) as CachedToken;\n\n    if (typeof parsed?.token !== 'string') return null;\n    if (typeof parsed?.expiresAt !== 'number') return null;\n\n    return parsed;\n  } catch {\n    // Private mode, disabled storage, or a corrupted entry — start fresh.\n    return null;\n  }\n};\n\n/** Persists the token for this tab. Best-effort: storage may be unavailable. */\nconst writeStoredToken = (cached: CachedToken): void => {\n  try {\n    globalThis.sessionStorage?.setItem(\n      TOKEN_STORAGE_KEY,\n      JSON.stringify(cached)\n    );\n  } catch {\n    /* ignore — the in-memory cache still applies for this page */\n  }\n};\n\n/** Options accepted by {@link createPublicClient}. */\nexport type PublicClientOptions = {\n  /** Overrides the build-time `editor` configuration. */\n  intlayerConfig?: Pick<IntlayerConfig, 'editor'>;\n};\n\n/** The credential-free client returned by {@link createPublicClient}. */\nexport type PublicClient = {\n  /**\n   * Returns the current token, exchanging the public `clientId` for one when\n   * needed. `null` when the project is unknown or the origin is not allowed.\n   */\n  getToken: () => Promise<string | null>;\n  /** Every dictionary key published for the project. */\n  getDictionaryKeys: () => Promise<string[]>;\n  /**\n   * Published dictionary content for the given keys.\n   *\n   * @param keys - Dictionary keys to fetch (at most 100 per call).\n   */\n  getDictionaries: (keys: string[]) => Promise<DictionaryAPI[]>;\n};\n\n/**\n * Creates a {@link PublicClient} for the configured project.\n *\n * @param options - Optional configuration override.\n * @returns A client that authenticates itself with the public project key.\n */\nexport const createPublicClient = ({\n  intlayerConfig,\n}: PublicClientOptions = {}): PublicClient => {\n  const resolvedEditor = intlayerConfig?.editor ?? editor;\n  const backendURL = (resolvedEditor?.backendURL ?? '').replace(/\\/$/, '');\n  const clientId = resolvedEditor?.clientId;\n\n  let cached: CachedToken | null = null;\n  let pendingExchange: Promise<string | null> | null = null;\n\n  const isUsable = (candidate: CachedToken | null): candidate is CachedToken =>\n    candidate !== null && candidate.expiresAt - EXPIRY_MARGIN_MS > Date.now();\n\n  const exchange = async (): Promise<string | null> => {\n    const response = await fetch(`${backendURL}/api/public/token`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ clientId }),\n      // Authorised by `Origin`, never by cookies.\n      credentials: 'omit',\n      mode: 'cors',\n    });\n\n    if (!response.ok) return null;\n\n    const payload = (await response.json()) as {\n      data?: { token?: string | null; expiresIn?: number };\n    };\n\n    const token = payload?.data?.token;\n    const expiresIn = payload?.data?.expiresIn ?? 0;\n\n    if (!token || expiresIn <= 0) return null;\n\n    cached = { token, expiresAt: Date.now() + expiresIn * 1000 };\n    writeStoredToken(cached);\n\n    return token;\n  };\n\n  const getToken = async (): Promise<string | null> => {\n    if (isUsable(cached)) return cached.token;\n\n    const stored = readStoredToken();\n    if (isUsable(stored)) {\n      cached = stored;\n      return stored.token;\n    }\n\n    if (!clientId) return null;\n\n    // De-duplicate concurrent exchanges so a burst of calls triggers one fetch.\n    pendingExchange ??= exchange().finally(() => {\n      pendingExchange = null;\n    });\n\n    return await pendingExchange;\n  };\n\n  /** Issues an authorised GET against the public surface. */\n  const request = async <Result>(\n    path: string,\n    fallback: Result\n  ): Promise<Result> => {\n    const token = await getToken();\n\n    if (!token) return fallback;\n\n    const response = await fetch(`${backendURL}/api/public${path}`, {\n      headers: { Authorization: `Bearer ${token}` },\n      credentials: 'omit',\n      mode: 'cors',\n    });\n\n    if (!response.ok) return fallback;\n\n    const payload = (await response.json()) as { data?: Result };\n\n    return payload?.data ?? fallback;\n  };\n\n  return {\n    getToken,\n    getDictionaryKeys: () => request<string[]>('/dictionaries/keys', []),\n    getDictionaries: (keys) =>\n      request<DictionaryAPI[]>(\n        `/dictionaries?keys=${encodeURIComponent(keys.join(','))}`,\n        []\n      ),\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAM,oBAAoB;;;;;AAM1B,MAAM,mBAAmB;;AASzB,MAAM,wBAA4C;CAChD,IAAI;EACF,MAAM,MAAM,WAAW,gBAAgB,QAAQ,iBAAiB;EAChE,IAAI,CAAC,KAAK,OAAO;EAEjB,MAAM,SAAS,KAAK,MAAM,GAAG;EAE7B,IAAI,OAAO,QAAQ,UAAU,UAAU,OAAO;EAC9C,IAAI,OAAO,QAAQ,cAAc,UAAU,OAAO;EAElD,OAAO;CACT,QAAQ;EAEN,OAAO;CACT;AACF;;AAGA,MAAM,oBAAoB,WAA8B;CACtD,IAAI;EACF,WAAW,gBAAgB,QACzB,mBACA,KAAK,UAAU,MAAM,CACvB;CACF,QAAQ,CAER;AACF;;;;;;;AA+BA,MAAa,sBAAsB,EACjC,mBACuB,CAAC,MAAoB;CAC5C,MAAM,iBAAiB,gBAAgB,UAAUA;CACjD,MAAM,cAAc,gBAAgB,cAAc,GAAE,CAAE,QAAQ,OAAO,EAAE;CACvE,MAAM,WAAW,gBAAgB;CAEjC,IAAI,SAA6B;CACjC,IAAI,kBAAiD;CAErD,MAAM,YAAY,cAChB,cAAc,QAAQ,UAAU,YAAY,mBAAmB,KAAK,IAAI;CAE1E,MAAM,WAAW,YAAoC;EACnD,MAAM,WAAW,MAAM,MAAM,GAAG,WAAW,oBAAoB;GAC7D,QAAQ;GACR,SAAS,EAAE,gBAAgB,mBAAmB;GAC9C,MAAM,KAAK,UAAU,EAAE,SAAS,CAAC;GAEjC,aAAa;GACb,MAAM;EACR,CAAC;EAED,IAAI,CAAC,SAAS,IAAI,OAAO;EAEzB,MAAM,UAAW,MAAM,SAAS,KAAK;EAIrC,MAAM,QAAQ,SAAS,MAAM;EAC7B,MAAM,YAAY,SAAS,MAAM,aAAa;EAE9C,IAAI,CAAC,SAAS,aAAa,GAAG,OAAO;EAErC,SAAS;GAAE;GAAO,WAAW,KAAK,IAAI,IAAI,YAAY;EAAK;EAC3D,iBAAiB,MAAM;EAEvB,OAAO;CACT;CAEA,MAAM,WAAW,YAAoC;EACnD,IAAI,SAAS,MAAM,GAAG,OAAO,OAAO;EAEpC,MAAM,SAAS,gBAAgB;EAC/B,IAAI,SAAS,MAAM,GAAG;GACpB,SAAS;GACT,OAAO,OAAO;EAChB;EAEA,IAAI,CAAC,UAAU,OAAO;EAGtB,oBAAoB,SAAS,CAAC,CAAC,cAAc;GAC3C,kBAAkB;EACpB,CAAC;EAED,OAAO,MAAM;CACf;;CAGA,MAAM,UAAU,OACd,MACA,aACoB;EACpB,MAAM,QAAQ,MAAM,SAAS;EAE7B,IAAI,CAAC,OAAO,OAAO;EAEnB,MAAM,WAAW,MAAM,MAAM,GAAG,WAAW,aAAa,QAAQ;GAC9D,SAAS,EAAE,eAAe,UAAU,QAAQ;GAC5C,aAAa;GACb,MAAM;EACR,CAAC;EAED,IAAI,CAAC,SAAS,IAAI,OAAO;EAIzB,QAAO,MAFgB,SAAS,KAAK,EAEvB,EAAE,QAAQ;CAC1B;CAEA,OAAO;EACL;EACA,yBAAyB,QAAkB,sBAAsB,CAAC,CAAC;EACnE,kBAAkB,SAChB,QACE,sBAAsB,mBAAmB,KAAK,KAAK,GAAG,CAAC,KACvD,CAAC,CACH;CACJ;AACF"}
+{"version":3,"file":"createPublicClient.cjs","names":["editor"],"sources":["../../../src/public/createPublicClient.ts"],"sourcesContent":["import type { RouteEndpoints } from '@intlayer/backend-contract/defineRoute';\nimport type { DictionaryAPI } from '@intlayer/backend-contract/dictionary';\nimport type {\n  PublicRoutes,\n  publicContract,\n} from '@intlayer/backend-contract/public';\nimport { editor } from '@intlayer/config/built';\nimport type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Browser-safe Intlayer client, authenticated without any confidential\n * credential.\n *\n * This is the Google-Analytics model applied to the whole SDK: the page ships\n * only the **public** `editor.clientId`, exchanges it for a short-lived scoped\n * token, and calls the API directly. No server route, no server action, and no\n * `clientSecret` in the bundle.\n *\n * What it can do is deliberately narrow, and that is what makes shipping the\n * key safe: read the project's published dictionary content — the content the\n * page already renders — and submit analytics events. Writing content, reading\n * a project, an organization or a user still require a real credential\n * (server-side) or a signed-in user.\n *\n * @example\n * ```ts\n * import { createPublicClient } from '@intlayer/api/public';\n *\n * const client = createPublicClient();\n *\n * const keys = await client.getDictionaryKeys();\n * const [dictionary] = await client.getDictionaries(['navbar']);\n * ```\n */\n\n/** `sessionStorage` key holding the cached token for this tab. */\nconst TOKEN_STORAGE_KEY = '__intlayer_public_token__';\n\n/**\n * Refresh margin: a token within this window of expiry is treated as expired,\n * so a request is never sent with a token that dies in flight.\n */\nconst EXPIRY_MARGIN_MS = 60 * 1000;\n\ntype CachedToken = {\n  token: string;\n  /** Epoch milliseconds. */\n  expiresAt: number;\n};\n\n/** Reads the cached token for this tab, ignoring an unusable cache. */\nconst readStoredToken = (): CachedToken | null => {\n  try {\n    const raw = globalThis.sessionStorage?.getItem(TOKEN_STORAGE_KEY);\n    if (!raw) return null;\n\n    const parsed = JSON.parse(raw) as CachedToken;\n\n    if (typeof parsed?.token !== 'string') return null;\n    if (typeof parsed?.expiresAt !== 'number') return null;\n\n    return parsed;\n  } catch {\n    // Private mode, disabled storage, or a corrupted entry — start fresh.\n    return null;\n  }\n};\n\n/** Persists the token for this tab. Best-effort: storage may be unavailable. */\nconst writeStoredToken = (cached: CachedToken): void => {\n  try {\n    globalThis.sessionStorage?.setItem(\n      TOKEN_STORAGE_KEY,\n      JSON.stringify(cached)\n    );\n  } catch {\n    /* ignore — the in-memory cache still applies for this page */\n  }\n};\n\n/** Options accepted by {@link createPublicClient}. */\nexport type PublicClientOptions = {\n  /** Overrides the build-time `editor` configuration. */\n  intlayerConfig?: Pick<IntlayerConfig, 'editor'>;\n};\n\n/** The credential-free client returned by {@link createPublicClient}. */\nexport type PublicClient = {\n  /**\n   * Returns the current token, exchanging the public `clientId` for one when\n   * needed. `null` when the project is unknown or the origin is not allowed.\n   */\n  getToken: () => Promise<string | null>;\n  /** Every dictionary key published for the project. */\n  getDictionaryKeys: () => Promise<string[]>;\n  /**\n   * Published dictionary content for the given keys.\n   *\n   * @param keys - Dictionary keys to fetch (at most 100 per call).\n   */\n  getDictionaries: (keys: string[]) => Promise<DictionaryAPI[]>;\n};\n\n/**\n * Creates a {@link PublicClient} for the configured project.\n *\n * @param options - Optional configuration override.\n * @returns A client that authenticates itself with the public project key.\n */\n/**\n * Public routes, checked against the backend contract at compile time. Kept\n * as plain strings: this client ships in end-user browser bundles.\n */\nconst publicPrefix = '/api/public' satisfies (typeof publicContract)['prefix'];\nconst publicEndpoints = {\n  createPublicBrowserToken: { method: 'POST', path: '/token' },\n  getPublicDictionaryKeys: { method: 'GET', path: '/dictionaries/keys' },\n  getPublicDictionaries: { method: 'GET', path: '/dictionaries' },\n} as const satisfies RouteEndpoints<PublicRoutes>;\n\nexport const createPublicClient = ({\n  intlayerConfig,\n}: PublicClientOptions = {}): PublicClient => {\n  const resolvedEditor = intlayerConfig?.editor ?? editor;\n  const backendURL = (resolvedEditor?.backendURL ?? '').replace(/\\/$/, '');\n  const clientId = resolvedEditor?.clientId;\n\n  let cached: CachedToken | null = null;\n  let pendingExchange: Promise<string | null> | null = null;\n\n  const isUsable = (candidate: CachedToken | null): candidate is CachedToken =>\n    candidate !== null && candidate.expiresAt - EXPIRY_MARGIN_MS > Date.now();\n\n  const exchange = async (): Promise<string | null> => {\n    const { method, path } = publicEndpoints.createPublicBrowserToken;\n    const response = await fetch(`${backendURL}${publicPrefix}${path}`, {\n      method,\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ clientId }),\n      // Authorised by `Origin`, never by cookies.\n      credentials: 'omit',\n      mode: 'cors',\n    });\n\n    if (!response.ok) return null;\n\n    const payload = (await response.json()) as {\n      data?: { token?: string | null; expiresIn?: number };\n    };\n\n    const token = payload?.data?.token;\n    const expiresIn = payload?.data?.expiresIn ?? 0;\n\n    if (!token || expiresIn <= 0) return null;\n\n    cached = { token, expiresAt: Date.now() + expiresIn * 1000 };\n    writeStoredToken(cached);\n\n    return token;\n  };\n\n  const getToken = async (): Promise<string | null> => {\n    if (isUsable(cached)) return cached.token;\n\n    const stored = readStoredToken();\n    if (isUsable(stored)) {\n      cached = stored;\n      return stored.token;\n    }\n\n    if (!clientId) return null;\n\n    // De-duplicate concurrent exchanges so a burst of calls triggers one fetch.\n    pendingExchange ??= exchange().finally(() => {\n      pendingExchange = null;\n    });\n\n    return await pendingExchange;\n  };\n\n  /** Issues an authorised GET against the public surface. */\n  const request = async <Result>(\n    path: string,\n    fallback: Result\n  ): Promise<Result> => {\n    const token = await getToken();\n\n    if (!token) return fallback;\n\n    const response = await fetch(`${backendURL}${publicPrefix}${path}`, {\n      headers: { Authorization: `Bearer ${token}` },\n      credentials: 'omit',\n      mode: 'cors',\n    });\n\n    if (!response.ok) return fallback;\n\n    const payload = (await response.json()) as { data?: Result };\n\n    return payload?.data ?? fallback;\n  };\n\n  return {\n    getToken,\n    getDictionaryKeys: () =>\n      request<string[]>(publicEndpoints.getPublicDictionaryKeys.path, []),\n    getDictionaries: (keys) =>\n      request<DictionaryAPI[]>(\n        `${publicEndpoints.getPublicDictionaries.path}?keys=${encodeURIComponent(keys.join(','))}`,\n        []\n      ),\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,MAAM,oBAAoB;;;;;AAM1B,MAAM,mBAAmB;;AASzB,MAAM,wBAA4C;CAChD,IAAI;EACF,MAAM,MAAM,WAAW,gBAAgB,QAAQ,iBAAiB;EAChE,IAAI,CAAC,KAAK,OAAO;EAEjB,MAAM,SAAS,KAAK,MAAM,GAAG;EAE7B,IAAI,OAAO,QAAQ,UAAU,UAAU,OAAO;EAC9C,IAAI,OAAO,QAAQ,cAAc,UAAU,OAAO;EAElD,OAAO;CACT,QAAQ;EAEN,OAAO;CACT;AACF;;AAGA,MAAM,oBAAoB,WAA8B;CACtD,IAAI;EACF,WAAW,gBAAgB,QACzB,mBACA,KAAK,UAAU,MAAM,CACvB;CACF,QAAQ,CAER;AACF;;;;;;;;;;;AAmCA,MAAM,eAAe;AACrB,MAAM,kBAAkB;CACtB,0BAA0B;EAAE,QAAQ;EAAQ,MAAM;CAAS;CAC3D,yBAAyB;EAAE,QAAQ;EAAO,MAAM;CAAqB;CACrE,uBAAuB;EAAE,QAAQ;EAAO,MAAM;CAAgB;AAChE;AAEA,MAAa,sBAAsB,EACjC,mBACuB,CAAC,MAAoB;CAC5C,MAAM,iBAAiB,gBAAgB,UAAUA;CACjD,MAAM,cAAc,gBAAgB,cAAc,GAAE,CAAE,QAAQ,OAAO,EAAE;CACvE,MAAM,WAAW,gBAAgB;CAEjC,IAAI,SAA6B;CACjC,IAAI,kBAAiD;CAErD,MAAM,YAAY,cAChB,cAAc,QAAQ,UAAU,YAAY,mBAAmB,KAAK,IAAI;CAE1E,MAAM,WAAW,YAAoC;EACnD,MAAM,EAAE,QAAQ,SAAS,gBAAgB;EACzC,MAAM,WAAW,MAAM,MAAM,GAAG,aAAa,eAAe,QAAQ;GAClE;GACA,SAAS,EAAE,gBAAgB,mBAAmB;GAC9C,MAAM,KAAK,UAAU,EAAE,SAAS,CAAC;GAEjC,aAAa;GACb,MAAM;EACR,CAAC;EAED,IAAI,CAAC,SAAS,IAAI,OAAO;EAEzB,MAAM,UAAW,MAAM,SAAS,KAAK;EAIrC,MAAM,QAAQ,SAAS,MAAM;EAC7B,MAAM,YAAY,SAAS,MAAM,aAAa;EAE9C,IAAI,CAAC,SAAS,aAAa,GAAG,OAAO;EAErC,SAAS;GAAE;GAAO,WAAW,KAAK,IAAI,IAAI,YAAY;EAAK;EAC3D,iBAAiB,MAAM;EAEvB,OAAO;CACT;CAEA,MAAM,WAAW,YAAoC;EACnD,IAAI,SAAS,MAAM,GAAG,OAAO,OAAO;EAEpC,MAAM,SAAS,gBAAgB;EAC/B,IAAI,SAAS,MAAM,GAAG;GACpB,SAAS;GACT,OAAO,OAAO;EAChB;EAEA,IAAI,CAAC,UAAU,OAAO;EAGtB,oBAAoB,SAAS,CAAC,CAAC,cAAc;GAC3C,kBAAkB;EACpB,CAAC;EAED,OAAO,MAAM;CACf;;CAGA,MAAM,UAAU,OACd,MACA,aACoB;EACpB,MAAM,QAAQ,MAAM,SAAS;EAE7B,IAAI,CAAC,OAAO,OAAO;EAEnB,MAAM,WAAW,MAAM,MAAM,GAAG,aAAa,eAAe,QAAQ;GAClE,SAAS,EAAE,eAAe,UAAU,QAAQ;GAC5C,aAAa;GACb,MAAM;EACR,CAAC;EAED,IAAI,CAAC,SAAS,IAAI,OAAO;EAIzB,QAAO,MAFgB,SAAS,KAAK,EAEvB,EAAE,QAAQ;CAC1B;CAEA,OAAO;EACL;EACA,yBACE,QAAkB,gBAAgB,wBAAwB,MAAM,CAAC,CAAC;EACpE,kBAAkB,SAChB,QACE,GAAG,gBAAgB,sBAAsB,KAAK,QAAQ,mBAAmB,KAAK,KAAK,GAAG,CAAC,KACvF,CAAC,CACH;CACJ;AACF"}

package/dist/cjs/public/index.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_public_createPublicClient = require('./createPublicClient.cjs');
+const require_public_createPublicClient = require("./createPublicClient.cjs");
 
 exports.createPublicClient = require_public_createPublicClient.createPublicClient;

package/dist/cjs/resolveInternalBackendUrl.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 let _intlayer_config_built = require("@intlayer/config/built");
 
-//#region src/resolveInternalBackendUrl.ts
+// src/resolveInternalBackendUrl.ts
 /**
 * Server-only override for the backend origin.
 *
@@ -45,7 +45,6 @@ const resolveInternalBackendUrl = (url, publicBackendUrl = _intlayer_config_buil
 	}
 };
 
-//#endregion
 exports.BACKEND_INTERNAL_URL_ENVIRONMENT_VARIABLE = BACKEND_INTERNAL_URL_ENVIRONMENT_VARIABLE;
 exports.resolveInternalBackendUrl = resolveInternalBackendUrl;
 //# sourceMappingURL=resolveInternalBackendUrl.cjs.map

package/dist/esm/cms/createAuthManager.mjs

@@ -3,7 +3,7 @@ import { editor } from "@intlayer/config/built";
 import { getEditorClientSecret } from "@intlayer/config/secrets";
 import { defu } from "defu";
 
-//#region src/cms/createAuthManager.ts
+// src/cms/createAuthManager.ts
 const ONE_MINUTE_MS = 6e4;
 /**
 * Process-wide token states, keyed by backend URL and credentials. Build
@@ -152,6 +152,5 @@ const createAuthManager = (intlayerConfig = { editor }, options = {}) => {
 	};
 };
 
-//#endregion
 export { clearAccessTokenCache, createAuthManager };
 //# sourceMappingURL=createAuthManager.mjs.map

package/dist/esm/cms/createIntlayerCMS.mjs

@@ -1,7 +1,7 @@
 import { createAuthManager } from "./createAuthManager.mjs";
 import { editor } from "@intlayer/config/built";
 
-//#region src/cms/createIntlayerCMS.ts
+// src/cms/createIntlayerCMS.ts
 /**
 * Creates an Intlayer CMS authenticator handling authentication automatically
 * (OAuth2 `client_credentials`, or a CLI session token).
@@ -57,6 +57,5 @@ const createIntlayerCMS = (intlayerConfig = { editor }, options = {}) => createA
 */
 const createEndpoint = (factory, options) => (cms = createIntlayerCMS()) => cms.bindSection(factory, options);
 
-//#endregion
 export { createEndpoint, createIntlayerCMS };
 //# sourceMappingURL=createIntlayerCMS.mjs.map

package/dist/esm/distantDictionary/fetchDistantDictionaries.mjs

@@ -1,7 +1,7 @@
 import { createIntlayerCMS } from "../cms/createIntlayerCMS.mjs";
 import { dictionaryEndpoint } from "../getIntlayerAPI/dictionary.mjs";
 
-//#region src/distantDictionary/fetchDistantDictionaries.ts
+// src/distantDictionary/fetchDistantDictionaries.ts
 /**
 * Fetch distant dictionary
 */
@@ -16,6 +16,5 @@ const fetchDistantDictionaries = async (intlayerConfig) => {
 	}
 };
 
-//#endregion
 export { fetchDistantDictionaries };
 //# sourceMappingURL=fetchDistantDictionaries.mjs.map

package/dist/esm/distantDictionary/fetchDistantDictionaries.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"fetchDistantDictionaries.mjs","names":[],"sources":["../../../src/distantDictionary/fetchDistantDictionaries.ts"],"sourcesContent":["import type { DictionaryAPI } from '@intlayer/backend';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { createIntlayerCMS } from '../cms/createIntlayerCMS';\nimport { dictionaryEndpoint } from '../getIntlayerAPI/dictionary';\n\n/**\n * Fetch distant dictionary\n */\nexport const fetchDistantDictionaries = async (\n  intlayerConfig: IntlayerConfig\n): Promise<DictionaryAPI[] | null | undefined> => {\n  try {\n    const { clientId, clientSecret } = intlayerConfig.editor;\n\n    if (!clientId || !clientSecret) {\n      throw new Error(\n        'Missing OAuth2 client ID or client secret. To get access token go to https://app.intlayer.org/project.'\n      );\n    }\n\n    const dictionary = dictionaryEndpoint(createIntlayerCMS(intlayerConfig));\n\n    // Fetch the dictionary list\n    const getDictionaryResult = await dictionary.getDictionaries();\n\n    const distantDictionaries = getDictionaryResult.data;\n\n    return distantDictionaries;\n  } catch (error) {\n    console.error(error);\n    return undefined;\n  }\n};\n"],"mappings":";;;;;;;AAQA,MAAa,2BAA2B,OACtC,mBACgD;CAChD,IAAI;EACF,MAAM,EAAE,UAAU,iBAAiB,eAAe;EAElD,IAAI,CAAC,YAAY,CAAC,cAChB,MAAM,IAAI,MACR,wGACF;EAUF,QAF4B,MALT,mBAAmB,kBAAkB,cAAc,CAG3B,CAAC,CAAC,gBAAgB,EAEd,CAAC;CAGlD,SAAS,OAAO;EACd,QAAQ,MAAM,KAAK;EACnB;CACF;AACF"}
+{"version":3,"file":"fetchDistantDictionaries.mjs","names":[],"sources":["../../../src/distantDictionary/fetchDistantDictionaries.ts"],"sourcesContent":["import type { DictionaryAPI } from '@intlayer/backend-contract/dictionary';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { createIntlayerCMS } from '../cms/createIntlayerCMS';\nimport { dictionaryEndpoint } from '../getIntlayerAPI/dictionary';\n\n/**\n * Fetch distant dictionary\n */\nexport const fetchDistantDictionaries = async (\n  intlayerConfig: IntlayerConfig\n): Promise<DictionaryAPI[] | null | undefined> => {\n  try {\n    const { clientId, clientSecret } = intlayerConfig.editor;\n\n    if (!clientId || !clientSecret) {\n      throw new Error(\n        'Missing OAuth2 client ID or client secret. To get access token go to https://app.intlayer.org/project.'\n      );\n    }\n\n    const dictionary = dictionaryEndpoint(createIntlayerCMS(intlayerConfig));\n\n    // Fetch the dictionary list\n    const getDictionaryResult = await dictionary.getDictionaries();\n\n    const distantDictionaries = getDictionaryResult.data;\n\n    return distantDictionaries;\n  } catch (error) {\n    console.error(error);\n    return undefined;\n  }\n};\n"],"mappings":";;;;;;;AAQA,MAAa,2BAA2B,OACtC,mBACgD;CAChD,IAAI;EACF,MAAM,EAAE,UAAU,iBAAiB,eAAe;EAElD,IAAI,CAAC,YAAY,CAAC,cAChB,MAAM,IAAI,MACR,wGACF;EAUF,QAF4B,MALT,mBAAmB,kBAAkB,cAAc,CAG3B,CAAC,CAAC,gBAAgB,EAEd,CAAC;CAGlD,SAAS,OAAO;EACd,QAAQ,MAAM,KAAK;EACnB;CACF;AACF"}

package/dist/esm/distantDictionary/fetchDistantDictionary.mjs

@@ -1,7 +1,7 @@
 import { createIntlayerCMS } from "../cms/createIntlayerCMS.mjs";
 import { dictionaryEndpoint } from "../getIntlayerAPI/dictionary.mjs";
 
-//#region src/distantDictionary/fetchDistantDictionary.ts
+// src/distantDictionary/fetchDistantDictionary.ts
 /**
 * Fetch distant dictionary
 */
@@ -18,6 +18,5 @@ const fetchDistantDictionary = async (dictionaryKey, intlayerConfig) => {
 	}
 };
 
-//#endregion
 export { fetchDistantDictionary };
 //# sourceMappingURL=fetchDistantDictionary.mjs.map

package/dist/esm/distantDictionary/fetchDistantDictionary.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"fetchDistantDictionary.mjs","names":[],"sources":["../../../src/distantDictionary/fetchDistantDictionary.ts"],"sourcesContent":["import type { DictionaryAPI } from '@intlayer/backend';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { createIntlayerCMS } from '../cms/createIntlayerCMS';\nimport { dictionaryEndpoint } from '../getIntlayerAPI/dictionary';\n\n/**\n * Fetch distant dictionary\n */\nexport const fetchDistantDictionary = async (\n  dictionaryKey: string,\n  intlayerConfig: IntlayerConfig\n): Promise<DictionaryAPI | undefined> => {\n  try {\n    const { clientId, clientSecret } = intlayerConfig.editor;\n\n    if (!clientId || !clientSecret) {\n      throw new Error(\n        'Missing OAuth2 client ID or client secret. To get access token go to https://app.intlayer.org/project.'\n      );\n    }\n\n    const dictionary = dictionaryEndpoint(createIntlayerCMS(intlayerConfig));\n\n    // Fetch the dictionary\n    const getDictionaryResult = await dictionary.getDictionary(dictionaryKey);\n\n    const distantDictionary = getDictionaryResult.data;\n\n    if (!distantDictionary) {\n      throw new Error(`Dictionary ${dictionaryKey} not found on remote`);\n    }\n\n    return distantDictionary;\n  } catch (error) {\n    console.error(error);\n    return undefined;\n  }\n};\n"],"mappings":";;;;;;;AAQA,MAAa,yBAAyB,OACpC,eACA,mBACuC;CACvC,IAAI;EACF,MAAM,EAAE,UAAU,iBAAiB,eAAe;EAElD,IAAI,CAAC,YAAY,CAAC,cAChB,MAAM,IAAI,MACR,wGACF;EAQF,MAAM,qBAAoB,MALP,mBAAmB,kBAAkB,cAAc,CAG3B,CAAC,CAAC,cAAc,aAAa,EAE3B,CAAC;EAE9C,IAAI,CAAC,mBACH,MAAM,IAAI,MAAM,cAAc,cAAc,qBAAqB;EAGnE,OAAO;CACT,SAAS,OAAO;EACd,QAAQ,MAAM,KAAK;EACnB;CACF;AACF"}
+{"version":3,"file":"fetchDistantDictionary.mjs","names":[],"sources":["../../../src/distantDictionary/fetchDistantDictionary.ts"],"sourcesContent":["import type { DictionaryAPI } from '@intlayer/backend-contract/dictionary';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { createIntlayerCMS } from '../cms/createIntlayerCMS';\nimport { dictionaryEndpoint } from '../getIntlayerAPI/dictionary';\n\n/**\n * Fetch distant dictionary\n */\nexport const fetchDistantDictionary = async (\n  dictionaryKey: string,\n  intlayerConfig: IntlayerConfig\n): Promise<DictionaryAPI | undefined> => {\n  try {\n    const { clientId, clientSecret } = intlayerConfig.editor;\n\n    if (!clientId || !clientSecret) {\n      throw new Error(\n        'Missing OAuth2 client ID or client secret. To get access token go to https://app.intlayer.org/project.'\n      );\n    }\n\n    const dictionary = dictionaryEndpoint(createIntlayerCMS(intlayerConfig));\n\n    // Fetch the dictionary\n    const getDictionaryResult = await dictionary.getDictionary(dictionaryKey);\n\n    const distantDictionary = getDictionaryResult.data;\n\n    if (!distantDictionary) {\n      throw new Error(`Dictionary ${dictionaryKey} not found on remote`);\n    }\n\n    return distantDictionary;\n  } catch (error) {\n    console.error(error);\n    return undefined;\n  }\n};\n"],"mappings":";;;;;;;AAQA,MAAa,yBAAyB,OACpC,eACA,mBACuC;CACvC,IAAI;EACF,MAAM,EAAE,UAAU,iBAAiB,eAAe;EAElD,IAAI,CAAC,YAAY,CAAC,cAChB,MAAM,IAAI,MACR,wGACF;EAQF,MAAM,qBAAoB,MALP,mBAAmB,kBAAkB,cAAc,CAG3B,CAAC,CAAC,cAAc,aAAa,EAE3B,CAAC;EAE9C,IAAI,CAAC,mBACH,MAAM,IAAI,MAAM,cAAc,cAAc,qBAAqB;EAGnE,OAAO;CACT,SAAS,OAAO;EACd,QAAQ,MAAM,KAAK;EACnB;CACF;AACF"}

package/dist/esm/fetcher.mjs

@@ -1,6 +1,6 @@
 import { resolveInternalBackendUrl } from "./resolveInternalBackendUrl.mjs";
 
-//#region src/fetcher.ts
+// src/fetcher.ts
 /**
 * Error thrown when the backend answers with a non-ok response.
 *
@@ -144,6 +144,5 @@ const fetcher = async (url, ...options) => {
 	return await response.json();
 };
 
-//#endregion
 export { FetcherError, fetcher, fetcherOptions };
 //# sourceMappingURL=fetcher.mjs.map

package/dist/esm/fetcher.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"fetcher.mjs","names":[],"sources":["../../src/fetcher.ts"],"sourcesContent":["import { resolveInternalBackendUrl } from './resolveInternalBackendUrl';\n\n/**\n * Error thrown when the backend answers with a non-ok response.\n *\n * Carries the HTTP status and the backend error code alongside the message, so\n * callers can tell a transient failure (5xx, network) from a deterministic one\n * (4xx) instead of blindly retrying.\n */\nexport class FetcherError extends Error {\n  /** HTTP status code of the response. */\n  public readonly status: number;\n  /** Error code returned by the backend, when available (ex: `DICTIONARY_NOT_FOUND`). */\n  public readonly code?: string;\n  /** Raw error payload returned by the backend. */\n  public readonly data?: unknown;\n\n  constructor(\n    message: string,\n    details: { status: number; code?: string; data?: unknown }\n  ) {\n    super(message);\n\n    this.name = 'FetcherError';\n    this.status = details.status;\n    this.code = details.code;\n    this.data = details.data;\n  }\n}\n\n/**\n * Type definition for options used in the fetcher function.\n * Extends the standard RequestInit interface (excluding 'body'),\n * and adds 'body' and 'params' properties for convenience.\n */\nexport type FetcherOptions = Omit<RequestInit, 'body'> & {\n  /**\n   * Body of the request. Should be a key-value pair object.\n   */\n  body?: Record<string, unknown>;\n  /**\n   * Query parameters to be appended to the URL.\n   */\n  params?:\n    | Record<string, string | string[] | undefined>\n    | string[]\n    | URLSearchParams;\n};\n\n/**\n * Default options for the fetcher function.\n * Sets the default method to 'GET', the 'Content-Type' header to 'application/json',\n * and includes credentials in the request.\n */\nexport const fetcherOptions: FetcherOptions = {\n  method: 'GET', // Default HTTP method\n  headers: {\n    'Content-Type': 'application/json', // Default content type\n  },\n  credentials: 'include',\n};\n\n/**\n * Utility function to remove properties with undefined values from an object.\n * This helps prevent sending undefined values in the request options.\n *\n * @param obj - The object to clean.\n * @returns The cleaned object without undefined values.\n */\nconst removeUndefined = (obj: object) => {\n  Object.keys(obj).forEach((key) => {\n    if (obj[key as keyof typeof obj] === undefined) {\n      delete obj[key as keyof typeof obj];\n    }\n  });\n  return obj;\n};\n\n/**\n * Deeply merges an array of objects into a single object.\n * Later objects in the array overwrite properties of earlier ones.\n *\n * @template T - The type of objects being merged.\n * @param objects - An array of objects to merge.\n * @returns The merged object.\n */\nconst deepMerge = <T extends object>(objects: (T | undefined)[]): T =>\n  objects.reduce((acc, obj) => {\n    const acc1: T = (acc ?? {}) as T;\n    const obj1: T = removeUndefined(obj ?? {}) as T;\n\n    if (typeof acc1 === 'object' && typeof obj1 === 'object') {\n      // Merge the two objects\n      return { ...acc1, ...obj1 };\n    }\n\n    // If one of them is not an object, return the defined one\n    return obj1 ?? acc1;\n  }, {} as T)!;\n\n/**\n * Fetcher function to make HTTP requests.\n * It merges default options with user-provided options,\n * handles query parameters and request body,\n * and returns the parsed JSON response.\n *\n * @template T - The expected type of the response data.\n * @param url - The endpoint URL.\n * @param options - Additional options to customize the request.\n * @returns A promise that resolves with the response data of type T.\n *\n * @example\n * ```typescript\n * // Making a GET request with query parameters\n * const data = await fetcher<MyResponseType>('https://api.example.com/data', {\n *   params: { search: 'query' },\n * });\n *\n * // Making a POST request with a JSON body\n * const result = await fetcher<AnotherResponseType>('https://api.example.com/submit', {\n *   method: 'POST',\n *   body: { key: 'value' },\n * });\n *\n * // Merge body, headers, and params\n * const result = await fetcher<AnotherResponseType>('https://api.example.com/submit', {\n *   method: 'POST',\n *   body: { key: 'value' },\n *   headers: { 'Content-Type': 'application/json' },\n *   params: { search: 'query' },\n * },\n * {\n *   headers: { 'Content-Type': 'application/x-www-form-urlencoded' },\n *   params: { page: 1 },\n * });\n * ```\n *\n * Result:\n * ```typescript\n * {\n *   method: 'POST',\n *   headers: { 'Content-Type': 'application/x-www-form-urlencoded' },\n *   params: { page: 1, search: 'query' },\n *   body: { key: 'value' },\n * }\n * ```\n */\nexport const fetcher = async <T>(\n  url: string,\n  ...options: FetcherOptions[]\n): Promise<T> => {\n  const { signal } = new AbortController();\n\n  // Initialize query parameters string and request body string\n  let paramsString = '';\n  let bodyString: string | undefined;\n\n  // Extract other options excluding 'body', 'params', and 'headers'\n  const otherOptions = options.map(\n    ({ body, params, headers, ...otherOptions }) => otherOptions\n  );\n\n  // Merge default options with user-provided options\n  const mergedOptions = deepMerge([fetcherOptions, ...otherOptions]);\n\n  // Merge default headers with user-provided headers\n  const mergedHeaders = deepMerge([\n    fetcherOptions.headers,\n    ...options.map((option) => option.headers),\n  ]);\n\n  // Merge query parameters\n  const params = deepMerge(options.map((option) => option.params));\n\n  const method = mergedOptions.method;\n\n  // If the request method is not 'GET' or 'HEAD', prepare the request body\n  if (method !== 'GET' && method !== 'HEAD') {\n    // Merge all 'body' options\n    const body = deepMerge(options.map((option) => option.body));\n    if (\n      mergedHeaders?.['Content-Type' as keyof HeadersInit] ===\n      'application/x-www-form-urlencoded'\n    ) {\n      // If the content type is 'application/x-www-form-urlencoded', encode the body accordingly\n      bodyString = new URLSearchParams(\n        body as Record<string, string>\n      ).toString();\n    } else {\n      // Otherwise, stringify the body as JSON\n      bodyString = JSON.stringify(body);\n    }\n  }\n\n  // If there are query parameters, append them to the URL\n  if (Object.entries(params).length > 0) {\n    paramsString = `?${new URLSearchParams(\n      params as Record<string, string>\n    ).toString()}`;\n  }\n\n  // Prepare the final request options\n  const formattedOptions: RequestInit = {\n    ...mergedOptions,\n    headers: mergedHeaders,\n    body: bodyString,\n    signal,\n  };\n\n  // Construct the full URL with query parameters. Server code inside a private\n  // network may need to reach the backend under another origin — see\n  // `resolveInternalBackendUrl`.\n  const urlResult = resolveInternalBackendUrl(`${url}${paramsString}`);\n\n  // Make the HTTP request using fetch\n  const response = await fetch(urlResult, formattedOptions);\n\n  if (!response.ok) {\n    const result = await response.json().catch(() => undefined);\n\n    // You can customize the error message or include more details\n    throw new FetcherError(\n      JSON.stringify(result?.error) ?? 'An error occurred',\n      {\n        status: response.status,\n        code: result?.error?.code,\n        data: result?.error,\n      }\n    );\n  }\n  return await response.json();\n};\n"],"mappings":";;;;;;;;;;AASA,IAAa,eAAb,cAAkC,MAAM;;CAEtC,AAAgB;;CAEhB,AAAgB;;CAEhB,AAAgB;CAEhB,YACE,SACA,SACA;EACA,MAAM,OAAO;EAEb,KAAK,OAAO;EACZ,KAAK,SAAS,QAAQ;EACtB,KAAK,OAAO,QAAQ;EACpB,KAAK,OAAO,QAAQ;CACtB;AACF;;;;;;AA0BA,MAAa,iBAAiC;CAC5C,QAAQ;CACR,SAAS,EACP,gBAAgB,mBAClB;CACA,aAAa;AACf;;;;;;;;AASA,MAAM,mBAAmB,QAAgB;CACvC,OAAO,KAAK,GAAG,CAAC,CAAC,SAAS,QAAQ;EAChC,IAAI,IAAI,SAA6B,QACnC,OAAO,IAAI;CAEf,CAAC;CACD,OAAO;AACT;;;;;;;;;AAUA,MAAM,aAA+B,YACnC,QAAQ,QAAQ,KAAK,QAAQ;CAC3B,MAAM,OAAW,OAAO,CAAC;CACzB,MAAM,OAAU,gBAAgB,OAAO,CAAC,CAAC;CAEzC,IAAI,OAAO,SAAS,YAAY,OAAO,SAAS,UAE9C,OAAO;EAAE,GAAG;EAAM,GAAG;CAAK;CAI5B,OAAO,QAAQ;AACjB,GAAG,CAAC,CAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDZ,MAAa,UAAU,OACrB,KACA,GAAG,YACY;CACf,MAAM,EAAE,WAAW,IAAI,gBAAgB;CAGvC,IAAI,eAAe;CACnB,IAAI;CAGJ,MAAM,eAAe,QAAQ,KAC1B,EAAE,MAAM,QAAQ,SAAS,GAAG,mBAAmB,YAClD;CAGA,MAAM,gBAAgB,UAAU,CAAC,gBAAgB,GAAG,YAAY,CAAC;CAGjE,MAAM,gBAAgB,UAAU,CAC9B,eAAe,SACf,GAAG,QAAQ,KAAK,WAAW,OAAO,OAAO,CAC3C,CAAC;CAGD,MAAM,SAAS,UAAU,QAAQ,KAAK,WAAW,OAAO,MAAM,CAAC;CAE/D,MAAM,SAAS,cAAc;CAG7B,IAAI,WAAW,SAAS,WAAW,QAAQ;EAEzC,MAAM,OAAO,UAAU,QAAQ,KAAK,WAAW,OAAO,IAAI,CAAC;EAC3D,IACE,gBAAgB,oBAChB,qCAGA,aAAa,IAAI,gBACf,IACF,CAAC,CAAC,SAAS;OAGX,aAAa,KAAK,UAAU,IAAI;CAEpC;CAGA,IAAI,OAAO,QAAQ,MAAM,CAAC,CAAC,SAAS,GAClC,eAAe,IAAI,IAAI,gBACrB,MACF,CAAC,CAAC,SAAS;CAIb,MAAM,mBAAgC;EACpC,GAAG;EACH,SAAS;EACT,MAAM;EACN;CACF;CAKA,MAAM,YAAY,0BAA0B,GAAG,MAAM,cAAc;CAGnE,MAAM,WAAW,MAAM,MAAM,WAAW,gBAAgB;CAExD,IAAI,CAAC,SAAS,IAAI;EAChB,MAAM,SAAS,MAAM,SAAS,KAAK,CAAC,CAAC,YAAY,MAAS;EAG1D,MAAM,IAAI,aACR,KAAK,UAAU,QAAQ,KAAK,KAAK,qBACjC;GACE,QAAQ,SAAS;GACjB,MAAM,QAAQ,OAAO;GACrB,MAAM,QAAQ;EAChB,CACF;CACF;CACA,OAAO,MAAM,SAAS,KAAK;AAC7B"}
+{"version":3,"file":"fetcher.mjs","names":[],"sources":["../../src/fetcher.ts"],"sourcesContent":["import { resolveInternalBackendUrl } from './resolveInternalBackendUrl';\n\n/**\n * Error thrown when the backend answers with a non-ok response.\n *\n * Carries the HTTP status and the backend error code alongside the message, so\n * callers can tell a transient failure (5xx, network) from a deterministic one\n * (4xx) instead of blindly retrying.\n */\nexport class FetcherError extends Error {\n  /** HTTP status code of the response. */\n  public readonly status: number;\n  /** Error code returned by the backend, when available (ex: `DICTIONARY_NOT_FOUND`). */\n  public readonly code?: string;\n  /** Raw error payload returned by the backend. */\n  public readonly data?: unknown;\n\n  constructor(\n    message: string,\n    details: { status: number; code?: string; data?: unknown }\n  ) {\n    super(message);\n\n    this.name = 'FetcherError';\n    this.status = details.status;\n    this.code = details.code;\n    this.data = details.data;\n  }\n}\n\n/**\n * Type definition for options used in the fetcher function.\n * Extends the standard RequestInit interface (excluding 'body'),\n * and adds 'body' and 'params' properties for convenience.\n */\nexport type FetcherOptions = Omit<RequestInit, 'body'> & {\n  /**\n   * Body of the request. Should be a key-value pair object.\n   */\n  body?: Record<string, unknown>;\n  /**\n   * Query parameters to be appended to the URL.\n   */\n  params?:\n    | Record<\n        string,\n        string | number | boolean | (string | number)[] | undefined\n      >\n    | string[]\n    | URLSearchParams;\n};\n\n/**\n * Default options for the fetcher function.\n * Sets the default method to 'GET', the 'Content-Type' header to 'application/json',\n * and includes credentials in the request.\n */\nexport const fetcherOptions: FetcherOptions = {\n  method: 'GET', // Default HTTP method\n  headers: {\n    'Content-Type': 'application/json', // Default content type\n  },\n  credentials: 'include',\n};\n\n/**\n * Utility function to remove properties with undefined values from an object.\n * This helps prevent sending undefined values in the request options.\n *\n * @param obj - The object to clean.\n * @returns The cleaned object without undefined values.\n */\nconst removeUndefined = (obj: object) => {\n  Object.keys(obj).forEach((key) => {\n    if (obj[key as keyof typeof obj] === undefined) {\n      delete obj[key as keyof typeof obj];\n    }\n  });\n  return obj;\n};\n\n/**\n * Deeply merges an array of objects into a single object.\n * Later objects in the array overwrite properties of earlier ones.\n *\n * @template T - The type of objects being merged.\n * @param objects - An array of objects to merge.\n * @returns The merged object.\n */\nconst deepMerge = <T extends object>(objects: (T | undefined)[]): T =>\n  objects.reduce((acc, obj) => {\n    const acc1: T = (acc ?? {}) as T;\n    const obj1: T = removeUndefined(obj ?? {}) as T;\n\n    if (typeof acc1 === 'object' && typeof obj1 === 'object') {\n      // Merge the two objects\n      return { ...acc1, ...obj1 };\n    }\n\n    // If one of them is not an object, return the defined one\n    return obj1 ?? acc1;\n  }, {} as T)!;\n\n/**\n * Fetcher function to make HTTP requests.\n * It merges default options with user-provided options,\n * handles query parameters and request body,\n * and returns the parsed JSON response.\n *\n * @template T - The expected type of the response data.\n * @param url - The endpoint URL.\n * @param options - Additional options to customize the request.\n * @returns A promise that resolves with the response data of type T.\n *\n * @example\n * ```typescript\n * // Making a GET request with query parameters\n * const data = await fetcher<MyResponseType>('https://api.example.com/data', {\n *   params: { search: 'query' },\n * });\n *\n * // Making a POST request with a JSON body\n * const result = await fetcher<AnotherResponseType>('https://api.example.com/submit', {\n *   method: 'POST',\n *   body: { key: 'value' },\n * });\n *\n * // Merge body, headers, and params\n * const result = await fetcher<AnotherResponseType>('https://api.example.com/submit', {\n *   method: 'POST',\n *   body: { key: 'value' },\n *   headers: { 'Content-Type': 'application/json' },\n *   params: { search: 'query' },\n * },\n * {\n *   headers: { 'Content-Type': 'application/x-www-form-urlencoded' },\n *   params: { page: 1 },\n * });\n * ```\n *\n * Result:\n * ```typescript\n * {\n *   method: 'POST',\n *   headers: { 'Content-Type': 'application/x-www-form-urlencoded' },\n *   params: { page: 1, search: 'query' },\n *   body: { key: 'value' },\n * }\n * ```\n */\nexport const fetcher = async <T>(\n  url: string,\n  ...options: FetcherOptions[]\n): Promise<T> => {\n  const { signal } = new AbortController();\n\n  // Initialize query parameters string and request body string\n  let paramsString = '';\n  let bodyString: string | undefined;\n\n  // Extract other options excluding 'body', 'params', and 'headers'\n  const otherOptions = options.map(\n    ({ body, params, headers, ...otherOptions }) => otherOptions\n  );\n\n  // Merge default options with user-provided options\n  const mergedOptions = deepMerge([fetcherOptions, ...otherOptions]);\n\n  // Merge default headers with user-provided headers\n  const mergedHeaders = deepMerge([\n    fetcherOptions.headers,\n    ...options.map((option) => option.headers),\n  ]);\n\n  // Merge query parameters\n  const params = deepMerge(options.map((option) => option.params));\n\n  const method = mergedOptions.method;\n\n  // If the request method is not 'GET' or 'HEAD', prepare the request body\n  if (method !== 'GET' && method !== 'HEAD') {\n    // Merge all 'body' options\n    const body = deepMerge(options.map((option) => option.body));\n    if (\n      mergedHeaders?.['Content-Type' as keyof HeadersInit] ===\n      'application/x-www-form-urlencoded'\n    ) {\n      // If the content type is 'application/x-www-form-urlencoded', encode the body accordingly\n      bodyString = new URLSearchParams(\n        body as Record<string, string>\n      ).toString();\n    } else {\n      // Otherwise, stringify the body as JSON\n      bodyString = JSON.stringify(body);\n    }\n  }\n\n  // If there are query parameters, append them to the URL\n  if (Object.entries(params).length > 0) {\n    paramsString = `?${new URLSearchParams(\n      params as Record<string, string>\n    ).toString()}`;\n  }\n\n  // Prepare the final request options\n  const formattedOptions: RequestInit = {\n    ...mergedOptions,\n    headers: mergedHeaders,\n    body: bodyString,\n    signal,\n  };\n\n  // Construct the full URL with query parameters. Server code inside a private\n  // network may need to reach the backend under another origin — see\n  // `resolveInternalBackendUrl`.\n  const urlResult = resolveInternalBackendUrl(`${url}${paramsString}`);\n\n  // Make the HTTP request using fetch\n  const response = await fetch(urlResult, formattedOptions);\n\n  if (!response.ok) {\n    const result = await response.json().catch(() => undefined);\n\n    // You can customize the error message or include more details\n    throw new FetcherError(\n      JSON.stringify(result?.error) ?? 'An error occurred',\n      {\n        status: response.status,\n        code: result?.error?.code,\n        data: result?.error,\n      }\n    );\n  }\n  return await response.json();\n};\n"],"mappings":";;;;;;;;;;AASA,IAAa,eAAb,cAAkC,MAAM;;CAEtC,AAAgB;;CAEhB,AAAgB;;CAEhB,AAAgB;CAEhB,YACE,SACA,SACA;EACA,MAAM,OAAO;EAEb,KAAK,OAAO;EACZ,KAAK,SAAS,QAAQ;EACtB,KAAK,OAAO,QAAQ;EACpB,KAAK,OAAO,QAAQ;CACtB;AACF;;;;;;AA6BA,MAAa,iBAAiC;CAC5C,QAAQ;CACR,SAAS,EACP,gBAAgB,mBAClB;CACA,aAAa;AACf;;;;;;;;AASA,MAAM,mBAAmB,QAAgB;CACvC,OAAO,KAAK,GAAG,CAAC,CAAC,SAAS,QAAQ;EAChC,IAAI,IAAI,SAA6B,QACnC,OAAO,IAAI;CAEf,CAAC;CACD,OAAO;AACT;;;;;;;;;AAUA,MAAM,aAA+B,YACnC,QAAQ,QAAQ,KAAK,QAAQ;CAC3B,MAAM,OAAW,OAAO,CAAC;CACzB,MAAM,OAAU,gBAAgB,OAAO,CAAC,CAAC;CAEzC,IAAI,OAAO,SAAS,YAAY,OAAO,SAAS,UAE9C,OAAO;EAAE,GAAG;EAAM,GAAG;CAAK;CAI5B,OAAO,QAAQ;AACjB,GAAG,CAAC,CAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDZ,MAAa,UAAU,OACrB,KACA,GAAG,YACY;CACf,MAAM,EAAE,WAAW,IAAI,gBAAgB;CAGvC,IAAI,eAAe;CACnB,IAAI;CAGJ,MAAM,eAAe,QAAQ,KAC1B,EAAE,MAAM,QAAQ,SAAS,GAAG,mBAAmB,YAClD;CAGA,MAAM,gBAAgB,UAAU,CAAC,gBAAgB,GAAG,YAAY,CAAC;CAGjE,MAAM,gBAAgB,UAAU,CAC9B,eAAe,SACf,GAAG,QAAQ,KAAK,WAAW,OAAO,OAAO,CAC3C,CAAC;CAGD,MAAM,SAAS,UAAU,QAAQ,KAAK,WAAW,OAAO,MAAM,CAAC;CAE/D,MAAM,SAAS,cAAc;CAG7B,IAAI,WAAW,SAAS,WAAW,QAAQ;EAEzC,MAAM,OAAO,UAAU,QAAQ,KAAK,WAAW,OAAO,IAAI,CAAC;EAC3D,IACE,gBAAgB,oBAChB,qCAGA,aAAa,IAAI,gBACf,IACF,CAAC,CAAC,SAAS;OAGX,aAAa,KAAK,UAAU,IAAI;CAEpC;CAGA,IAAI,OAAO,QAAQ,MAAM,CAAC,CAAC,SAAS,GAClC,eAAe,IAAI,IAAI,gBACrB,MACF,CAAC,CAAC,SAAS;CAIb,MAAM,mBAAgC;EACpC,GAAG;EACH,SAAS;EACT,MAAM;EACN;CACF;CAKA,MAAM,YAAY,0BAA0B,GAAG,MAAM,cAAc;CAGnE,MAAM,WAAW,MAAM,MAAM,WAAW,gBAAgB;CAExD,IAAI,CAAC,SAAS,IAAI;EAChB,MAAM,SAAS,MAAM,SAAS,KAAK,CAAC,CAAC,YAAY,MAAS;EAG1D,MAAM,IAAI,aACR,KAAK,UAAU,QAAQ,KAAK,KAAK,qBACjC;GACE,QAAQ,SAAS;GACjB,MAAM,QAAQ,OAAO;GACrB,MAAM,QAAQ;EAChB,CACF;CACF;CACA,OAAO,MAAM,SAAS,KAAK;AAC7B"}

package/dist/esm/getIntlayerAPI/ai.mjs

@@ -1,17 +1,71 @@
-import { fetcher } from "../fetcher.mjs";
 import { createEndpoint } from "../cms/createIntlayerCMS.mjs";
+import { fetcher } from "../fetcher.mjs";
 import { editor } from "@intlayer/config/built";
+import { buildRouteURL } from "@intlayer/backend-contract/defineRoute";
+import { BACKEND_URL } from "@intlayer/config/defaultValues";
 
-//#region src/getIntlayerAPI/ai.ts
+// src/getIntlayerAPI/ai.ts
+/** Prefix of the routes, checked against the backend contract. */
+const aiGroup = { prefix: "/api/ai" };
+/**
+* Method and path of every route, checked against the backend contract at
+* compile time (the contract's zod schemas are never loaded).
+*/
+const aiEndpoints = {
+	customQuery: {
+		method: "POST",
+		path: "/"
+	},
+	translateJSON: {
+		method: "POST",
+		path: "/translate/json"
+	},
+	auditContentDeclaration: {
+		method: "POST",
+		path: "/audit/dictionary"
+	},
+	auditContentDeclarationField: {
+		method: "POST",
+		path: "/audit/dictionary/field"
+	},
+	auditContentDeclarationMetadata: {
+		method: "POST",
+		path: "/audit/dictionary/metadata"
+	},
+	auditTag: {
+		method: "POST",
+		path: "/audit/tag"
+	},
+	ask: {
+		method: "POST",
+		path: "/ask"
+	},
+	chat: {
+		method: "POST",
+		path: "/chat"
+	},
+	autocomplete: {
+		method: "POST",
+		path: "/autocomplete"
+	},
+	getDiscussions: {
+		method: "GET",
+		path: "/discussions"
+	},
+	getAIStats: {
+		method: "GET",
+		path: "/stats"
+	}
+};
 const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
-	const AI_API_ROUTE = `${intlayerConfig?.editor?.backendURL ?? editor.backendURL}/api/ai`;
+	const backendURL = intlayerConfig?.editor?.backendURL ?? editor.backendURL ?? BACKEND_URL;
 	/**
 	* Custom query
 	* @param body - Custom query parameters.
 	* @returns Custom query result.
 	*/
-	const customQuery = async (body, otherOptions = {}) => await fetcher(AI_API_ROUTE, authAPIOptions, otherOptions, {
-		method: "POST",
+	const customQuery = async (body, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, aiGroup, aiEndpoints.customQuery), authAPIOptions, otherOptions, {
+		method: aiEndpoints.customQuery.method,
 		body
 	});
 	/**
@@ -19,8 +73,8 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* @param body - Audit file parameters.
 	* @returns Audited file content.
 	*/
-	const translateJSON = async (body, otherOptions = {}) => await fetcher(`${AI_API_ROUTE}/translate/json`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const translateJSON = async (body, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, aiGroup, aiEndpoints.translateJSON), authAPIOptions, otherOptions, {
+		method: aiEndpoints.translateJSON.method,
 		body
 	});
 	/**
@@ -28,8 +82,8 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* @param body - Audit file parameters.
 	* @returns Audited file content.
 	*/
-	const auditContentDeclaration = async (body, otherOptions = {}) => await fetcher(`${AI_API_ROUTE}/audit/dictionary`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const auditContentDeclaration = async (body, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, aiGroup, aiEndpoints.auditContentDeclaration), authAPIOptions, otherOptions, {
+		method: aiEndpoints.auditContentDeclaration.method,
 		body
 	});
 	/**
@@ -37,8 +91,8 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* @param body - Audit file parameters.
 	* @returns Audited file content.
 	*/
-	const auditContentDeclarationField = async (body, otherOptions = {}) => await fetcher(`${AI_API_ROUTE}/audit/dictionary/field`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const auditContentDeclarationField = async (body, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, aiGroup, aiEndpoints.auditContentDeclarationField), authAPIOptions, otherOptions, {
+		method: aiEndpoints.auditContentDeclarationField.method,
 		body
 	});
 	/**
@@ -46,8 +100,8 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* @param body - Audit file parameters.
 	* @returns Audited file content.
 	*/
-	const auditContentDeclarationMetadata = async (body, otherOptions = {}) => await fetcher(`${AI_API_ROUTE}/audit/dictionary/metadata`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const auditContentDeclarationMetadata = async (body, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, aiGroup, aiEndpoints.auditContentDeclarationMetadata), authAPIOptions, otherOptions, {
+		method: aiEndpoints.auditContentDeclarationMetadata.method,
 		body
 	});
 	/**
@@ -55,8 +109,8 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* @param body - Audit tag parameters.
 	* @returns Audited tag content.
 	*/
-	const auditTag = async (body, otherOptions = {}) => await fetcher(`${AI_API_ROUTE}/audit/tag`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const auditTag = async (body, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, aiGroup, aiEndpoints.auditTag), authAPIOptions, otherOptions, {
+		method: aiEndpoints.auditTag.method,
 		body
 	});
 	/**
@@ -83,8 +137,8 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 		const { onMessage, onDone, ...rest } = body;
 		const abortController = new AbortController();
 		try {
-			const response = await fetch(`${AI_API_ROUTE}/ask`, {
-				method: "POST",
+			const response = await fetch(buildRouteURL(backendURL, aiGroup, aiEndpoints.ask), {
+				method: aiEndpoints.ask.method,
 				headers: {
 					"Content-Type": "application/json",
 					...authAPIOptions.headers,
@@ -140,8 +194,8 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 		const { onMessage, onDone, onAction, ...rest } = body;
 		const abortController = new AbortController();
 		try {
-			const response = await fetch(`${AI_API_ROUTE}/chat`, {
-				method: "POST",
+			const response = await fetch(buildRouteURL(backendURL, aiGroup, aiEndpoints.chat), {
+				method: aiEndpoints.chat.method,
 				headers: {
 					"Content-Type": "application/json",
 					...authAPIOptions.headers,
@@ -193,22 +247,22 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 			throw error;
 		}
 	};
-	const autocomplete = async (body, otherOptions = {}) => await fetcher(`${AI_API_ROUTE}/autocomplete`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const autocomplete = async (body, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, aiGroup, aiEndpoints.autocomplete), authAPIOptions, otherOptions, {
+		method: aiEndpoints.autocomplete.method,
 		body
 	});
 	/**
 	* Retrieves discussions with filters and pagination. Only user or admin can access.
 	*/
-	const getDiscussions = async (params, otherOptions = {}) => await fetcher(`${AI_API_ROUTE}/discussions`, authAPIOptions, otherOptions, {
-		method: "GET",
+	const getDiscussions = async (params, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, aiGroup, aiEndpoints.getDiscussions), authAPIOptions, otherOptions, {
+		method: aiEndpoints.getDiscussions.method,
 		params
 	});
 	/**
 	* Retrieves aggregated AI token-usage statistics for the currently selected
 	* project.
 	*/
-	const getAIStats = async (otherOptions = {}) => await fetcher(`${AI_API_ROUTE}/stats`, authAPIOptions, otherOptions, { method: "GET" });
+	const getAIStats = async (otherOptions = {}) => await fetcher(buildRouteURL(backendURL, aiGroup, aiEndpoints.getAIStats), authAPIOptions, otherOptions, { method: aiEndpoints.getAIStats.method });
 	return {
 		customQuery,
 		translateJSON,
@@ -231,6 +285,5 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 */
 const aiEndpoint = createEndpoint(getAiAPI);
 
-//#endregion
 export { aiEndpoint, getAiAPI };
 //# sourceMappingURL=ai.mjs.map

package/dist/esm/getIntlayerAPI/ai.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ai.mjs","names":[],"sources":["../../../src/getIntlayerAPI/ai.ts"],"sourcesContent":["import type {\n  AIOptions,\n  AskDocQuestionResult,\n  AuditContentDeclarationBody,\n  AuditContentDeclarationFieldBody,\n  AuditContentDeclarationFieldResult,\n  AuditContentDeclarationMetadataBody,\n  AuditContentDeclarationMetadataResult,\n  AuditContentDeclarationResult,\n  AuditTagBody,\n  AuditTagResult,\n  AutocompleteResponse,\n  ChatCompletionRequestMessage,\n  ChatResult,\n  CustomQueryBody,\n  CustomQueryResult,\n  GetAIStatsResult,\n  GetDiscussionsParams,\n  GetDiscussionsResult,\n  TranslateJSONBody,\n  TranslateJSONResult,\n} from '@intlayer/backend';\nimport { editor } from '@intlayer/config/built';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { createEndpoint } from '../cms/createIntlayerCMS';\nimport { type FetcherOptions, fetcher } from '../fetcher';\n\nexport type AutocompleteBody = {\n  text: string;\n  aiOptions?: AIOptions;\n  contextBefore?: string;\n  currentLine?: string;\n  contextAfter?: string;\n};\n\nexport type AskDocQuestionBody = {\n  messages: ChatCompletionRequestMessage[];\n  discussionId: string;\n  onMessage?: (chunk: string) => void;\n  onDone?: (response: AskDocQuestionResult) => void;\n};\n\nexport type ClientAction =\n  | { type: 'navigate'; path: string }\n  | { type: 'invalidate_queries' };\n\nexport type ChatBody = {\n  messages: ChatCompletionRequestMessage[];\n  discussionId: string;\n  onMessage?: (chunk: string) => void;\n  onDone?: (response: ChatResult) => void;\n  onAction?: (action: ClientAction) => void;\n};\n\nexport type { AskDocQuestionResult, ChatResult };\n\nexport const getAiAPI = (\n  authAPIOptions: FetcherOptions = {},\n  intlayerConfig?: IntlayerConfig\n) => {\n  const backendURL = intlayerConfig?.editor?.backendURL ?? editor.backendURL;\n\n  const AI_API_ROUTE = `${backendURL}/api/ai`;\n\n  /**\n   * Custom query\n   * @param body - Custom query parameters.\n   * @returns Custom query result.\n   */\n  const customQuery = async (\n    body?: CustomQueryBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<CustomQueryResult>(\n      AI_API_ROUTE,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'POST',\n        body: body,\n      }\n    );\n\n  /**\n   * Translate a JSON\n   * @param body - Audit file parameters.\n   * @returns Audited file content.\n   */\n  const translateJSON = async (\n    body?: TranslateJSONBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<TranslateJSONResult>(\n      `${AI_API_ROUTE}/translate/json`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'POST',\n        body: body,\n      }\n    );\n\n  /**\n   * Audits a content declaration file\n   * @param body - Audit file parameters.\n   * @returns Audited file content.\n   */\n  const auditContentDeclaration = async (\n    body?: AuditContentDeclarationBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<AuditContentDeclarationResult>(\n      `${AI_API_ROUTE}/audit/dictionary`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'POST',\n        body: body,\n      }\n    );\n\n  /**\n   * Audits a content declaration field\n   * @param body - Audit file parameters.\n   * @returns Audited file content.\n   */\n  const auditContentDeclarationField = async (\n    body?: AuditContentDeclarationFieldBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<AuditContentDeclarationFieldResult>(\n      `${AI_API_ROUTE}/audit/dictionary/field`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'POST',\n        body: body,\n      }\n    );\n\n  /**\n   * Audits a content declaration file to retrieve title, description and tags\n   * @param body - Audit file parameters.\n   * @returns Audited file content.\n   */\n  const auditContentDeclarationMetadata = async (\n    body?: AuditContentDeclarationMetadataBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<AuditContentDeclarationMetadataResult>(\n      `${AI_API_ROUTE}/audit/dictionary/metadata`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'POST',\n        body: body,\n      }\n    );\n\n  /**\n   * Audits a tag\n   * @param body - Audit tag parameters.\n   * @returns Audited tag content.\n   */\n  const auditTag = async (\n    body?: AuditTagBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<AuditTagResult>(\n      `${AI_API_ROUTE}/audit/tag`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'POST',\n        body: body,\n      }\n    );\n\n  /**\n   * Asks a question to the AI related to the documentation **and streams the\n   * answer as Server‑Sent Events (SSE)**.\n   *\n   * The function **returns immediately** with a handle exposing:\n   * - `promise` → resolves when the stream completes (or rejects on error)\n   * - `abort()` → allows canceling the request on demand\n   *\n   * Usage example:\n   * ```ts\n   * const { promise, abort } = ai.askDocQuestion({\n   *   ...body,\n   *   onMessage: console.log,\n   *   onDone: (full) => console.log(\"✔\", full),\n   * });\n   * // later → abort();\n   * await promise; // waits for completion if desired\n   * ```\n   */\n  const askDocQuestion = async (\n    body?: AskDocQuestionBody,\n    otherOptions: FetcherOptions = {}\n  ) => {\n    if (!body) return;\n\n    const { onMessage, onDone, ...rest } = body;\n    const abortController = new AbortController();\n\n    try {\n      const response = await fetch(`${AI_API_ROUTE}/ask`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          ...authAPIOptions.headers,\n          ...otherOptions.headers,\n        },\n        body: JSON.stringify({\n          ...rest,\n          ...authAPIOptions.body,\n          ...otherOptions.body,\n        }),\n        signal: abortController.signal,\n        credentials: 'include',\n      });\n\n      if (!response.ok) {\n        // Align error handling with generic `fetcher` utility so that callers receive\n        // meaningful messages (e.g. for 429 \"Too Many Requests\" responses).\n        let errorMessage: string = 'An error occurred';\n\n        try {\n          // Attempt to parse JSON error payload produced by backend\n          const errorData = await response.json();\n          const errorObj = errorData.error ?? errorData;\n          errorMessage = JSON.stringify(errorObj) ?? 'An error occurred';\n        } catch {\n          // Fallback to plain-text body or HTTP status text\n          try {\n            const errorText = await response.text();\n            if (errorText) {\n              errorMessage = errorText;\n            }\n          } catch {\n            // ignore – we already have a default message\n          }\n        }\n\n        throw new Error(errorMessage);\n      }\n\n      const reader = response.body?.getReader();\n      if (!reader) {\n        throw new Error('No reader available');\n      }\n\n      const decoder = new TextDecoder();\n      let buffer = '';\n\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split('\\n');\n        buffer = lines.pop() ?? '';\n\n        for (const line of lines) {\n          if (line.startsWith('data: ')) {\n            try {\n              const data = JSON.parse(line.slice(6));\n              if (data.chunk) {\n                onMessage?.(data.chunk);\n              }\n              if (data.done && data.response) {\n                onDone?.(data.response);\n              }\n            } catch (e) {\n              console.error('Failed to parse SSE data:', e);\n            }\n          }\n        }\n      }\n    } catch (error) {\n      console.error('Error in askDocQuestion:', error);\n      throw error;\n    }\n  };\n\n  const chat = async (body?: ChatBody, otherOptions: FetcherOptions = {}) => {\n    if (!body) return;\n\n    const { onMessage, onDone, onAction, ...rest } = body;\n    const abortController = new AbortController();\n\n    try {\n      const response = await fetch(`${AI_API_ROUTE}/chat`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          ...authAPIOptions.headers,\n          ...otherOptions.headers,\n        },\n        body: JSON.stringify({\n          ...rest,\n          ...authAPIOptions.body,\n          ...otherOptions.body,\n        }),\n        signal: abortController.signal,\n        credentials: 'include',\n      });\n\n      if (!response.ok) {\n        let errorMessage: string = 'An error occurred';\n\n        try {\n          const errorData = await response.json();\n          const errorObj = errorData.error ?? errorData;\n          errorMessage = JSON.stringify(errorObj) ?? 'An error occurred';\n        } catch {\n          try {\n            const errorText = await response.text();\n            if (errorText) {\n              errorMessage = errorText;\n            }\n          } catch {\n            // ignore\n          }\n        }\n\n        throw new Error(errorMessage);\n      }\n\n      const reader = response.body?.getReader();\n      if (!reader) {\n        throw new Error('No reader available');\n      }\n\n      const decoder = new TextDecoder();\n      let buffer = '';\n\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split('\\n');\n        buffer = lines.pop() ?? '';\n\n        for (const line of lines) {\n          if (line.startsWith('data: ')) {\n            try {\n              const data = JSON.parse(line.slice(6));\n              if (data.chunk) {\n                onMessage?.(data.chunk);\n              }\n              if (data.action) {\n                onAction?.(data.action);\n              }\n              if (data.done && data.response) {\n                onDone?.(data.response);\n              }\n            } catch (e) {\n              console.error('Failed to parse SSE data:', e);\n            }\n          }\n        }\n      }\n    } catch (error) {\n      console.error('Error in chat:', error);\n      throw error;\n    }\n  };\n\n  const autocomplete = async (\n    body?: AutocompleteBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<AutocompleteResponse>(\n      `${AI_API_ROUTE}/autocomplete`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'POST',\n        body: body,\n      }\n    );\n\n  /**\n   * Retrieves discussions with filters and pagination. Only user or admin can access.\n   */\n  const getDiscussions = async (\n    params?: GetDiscussionsParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetDiscussionsResult>(\n      `${AI_API_ROUTE}/discussions`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'GET',\n        // @ts-ignore Number of parameter will be stringified by the fetcher\n        params,\n      }\n    );\n\n  /**\n   * Retrieves aggregated AI token-usage statistics for the currently selected\n   * project.\n   */\n  const getAIStats = async (otherOptions: FetcherOptions = {}) =>\n    await fetcher<GetAIStatsResult>(\n      `${AI_API_ROUTE}/stats`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'GET',\n      }\n    );\n\n  return {\n    customQuery,\n    translateJSON,\n    auditContentDeclaration,\n    auditContentDeclarationField,\n    auditContentDeclarationMetadata,\n    auditTag,\n    askDocQuestion,\n    chat,\n    autocomplete,\n    getDiscussions,\n    getAIStats,\n  };\n};\n\n/**\n * Authenticated `ai` endpoint bound to an Intlayer CMS authenticator.\n *\n * Pass an authenticator created with `createIntlayerCMS`, or omit it to use\n * the build-time configuration (`@intlayer/config/built`).\n */\nexport const aiEndpoint = createEndpoint(getAiAPI);\n"],"mappings":"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"}
+{"version":3,"file":"ai.mjs","names":[],"sources":["../../../src/getIntlayerAPI/ai.ts"],"sourcesContent":["import type {\n  AIOptions,\n  AIRoutes,\n  AskDocQuestionResult,\n  AuditContentDeclarationBody,\n  AuditContentDeclarationFieldBody,\n  AuditContentDeclarationFieldResult,\n  AuditContentDeclarationMetadataBody,\n  AuditContentDeclarationMetadataResult,\n  AuditContentDeclarationResult,\n  AuditTagBody,\n  AuditTagResult,\n  AutocompleteResponse,\n  aiContract,\n  ChatCompletionRequestMessage,\n  ChatResult,\n  CustomQueryBody,\n  CustomQueryResult,\n  GetAIStatsResult,\n  GetDiscussionsParams,\n  GetDiscussionsResult,\n  TranslateJSONBody,\n  TranslateJSONResult,\n} from '@intlayer/backend-contract/ai';\nimport type { RouteEndpoints } from '@intlayer/backend-contract/defineRoute';\nimport { buildRouteURL } from '@intlayer/backend-contract/defineRoute';\nimport { editor } from '@intlayer/config/built';\nimport { BACKEND_URL } from '@intlayer/config/defaultValues';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { createEndpoint } from '../cms/createIntlayerCMS';\nimport { type FetcherOptions, fetcher } from '../fetcher';\n\nexport type AutocompleteBody = {\n  text: string;\n  aiOptions?: AIOptions;\n  contextBefore?: string;\n  currentLine?: string;\n  contextAfter?: string;\n};\n\nexport type AskDocQuestionBody = {\n  messages: ChatCompletionRequestMessage[];\n  discussionId: string;\n  onMessage?: (chunk: string) => void;\n  onDone?: (response: AskDocQuestionResult) => void;\n};\n\nexport type ClientAction =\n  | { type: 'navigate'; path: string }\n  | { type: 'invalidate_queries' };\n\nexport type ChatBody = {\n  messages: ChatCompletionRequestMessage[];\n  discussionId: string;\n  onMessage?: (chunk: string) => void;\n  onDone?: (response: ChatResult) => void;\n  onAction?: (action: ClientAction) => void;\n};\n\nexport type { AskDocQuestionResult, ChatResult };\n\n/** Prefix of the routes, checked against the backend contract. */\nconst aiGroup = {\n  prefix: '/api/ai',\n} as const satisfies Pick<typeof aiContract, 'prefix'>;\n\n/**\n * Method and path of every route, checked against the backend contract at\n * compile time (the contract's zod schemas are never loaded).\n */\nconst aiEndpoints = {\n  customQuery: { method: 'POST', path: '/' },\n  translateJSON: { method: 'POST', path: '/translate/json' },\n  auditContentDeclaration: { method: 'POST', path: '/audit/dictionary' },\n  auditContentDeclarationField: {\n    method: 'POST',\n    path: '/audit/dictionary/field',\n  },\n  auditContentDeclarationMetadata: {\n    method: 'POST',\n    path: '/audit/dictionary/metadata',\n  },\n  auditTag: { method: 'POST', path: '/audit/tag' },\n  ask: { method: 'POST', path: '/ask' },\n  chat: { method: 'POST', path: '/chat' },\n  autocomplete: { method: 'POST', path: '/autocomplete' },\n  getDiscussions: { method: 'GET', path: '/discussions' },\n  getAIStats: { method: 'GET', path: '/stats' },\n} as const satisfies RouteEndpoints<AIRoutes>;\n\nexport const getAiAPI = (\n  authAPIOptions: FetcherOptions = {},\n  intlayerConfig?: IntlayerConfig\n) => {\n  const backendURL =\n    intlayerConfig?.editor?.backendURL ?? editor.backendURL ?? BACKEND_URL;\n\n  /**\n   * Custom query\n   * @param body - Custom query parameters.\n   * @returns Custom query result.\n   */\n  const customQuery = async (\n    body?: CustomQueryBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<CustomQueryResult>(\n      buildRouteURL(backendURL, aiGroup, aiEndpoints.customQuery),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: aiEndpoints.customQuery.method,\n        body: body,\n      }\n    );\n\n  /**\n   * Translate a JSON\n   * @param body - Audit file parameters.\n   * @returns Audited file content.\n   */\n  const translateJSON = async (\n    body?: TranslateJSONBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<TranslateJSONResult>(\n      buildRouteURL(backendURL, aiGroup, aiEndpoints.translateJSON),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: aiEndpoints.translateJSON.method,\n        body: body,\n      }\n    );\n\n  /**\n   * Audits a content declaration file\n   * @param body - Audit file parameters.\n   * @returns Audited file content.\n   */\n  const auditContentDeclaration = async (\n    body?: AuditContentDeclarationBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<AuditContentDeclarationResult>(\n      buildRouteURL(backendURL, aiGroup, aiEndpoints.auditContentDeclaration),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: aiEndpoints.auditContentDeclaration.method,\n        body: body,\n      }\n    );\n\n  /**\n   * Audits a content declaration field\n   * @param body - Audit file parameters.\n   * @returns Audited file content.\n   */\n  const auditContentDeclarationField = async (\n    body?: AuditContentDeclarationFieldBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<AuditContentDeclarationFieldResult>(\n      buildRouteURL(\n        backendURL,\n        aiGroup,\n        aiEndpoints.auditContentDeclarationField\n      ),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: aiEndpoints.auditContentDeclarationField.method,\n        body: body,\n      }\n    );\n\n  /**\n   * Audits a content declaration file to retrieve title, description and tags\n   * @param body - Audit file parameters.\n   * @returns Audited file content.\n   */\n  const auditContentDeclarationMetadata = async (\n    body?: AuditContentDeclarationMetadataBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<AuditContentDeclarationMetadataResult>(\n      buildRouteURL(\n        backendURL,\n        aiGroup,\n        aiEndpoints.auditContentDeclarationMetadata\n      ),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: aiEndpoints.auditContentDeclarationMetadata.method,\n        body: body,\n      }\n    );\n\n  /**\n   * Audits a tag\n   * @param body - Audit tag parameters.\n   * @returns Audited tag content.\n   */\n  const auditTag = async (\n    body?: AuditTagBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<AuditTagResult>(\n      buildRouteURL(backendURL, aiGroup, aiEndpoints.auditTag),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: aiEndpoints.auditTag.method,\n        body: body,\n      }\n    );\n\n  /**\n   * Asks a question to the AI related to the documentation **and streams the\n   * answer as Server‑Sent Events (SSE)**.\n   *\n   * The function **returns immediately** with a handle exposing:\n   * - `promise` → resolves when the stream completes (or rejects on error)\n   * - `abort()` → allows canceling the request on demand\n   *\n   * Usage example:\n   * ```ts\n   * const { promise, abort } = ai.askDocQuestion({\n   *   ...body,\n   *   onMessage: console.log,\n   *   onDone: (full) => console.log(\"✔\", full),\n   * });\n   * // later → abort();\n   * await promise; // waits for completion if desired\n   * ```\n   */\n  const askDocQuestion = async (\n    body?: AskDocQuestionBody,\n    otherOptions: FetcherOptions = {}\n  ) => {\n    if (!body) return;\n\n    const { onMessage, onDone, ...rest } = body;\n    const abortController = new AbortController();\n\n    try {\n      const response = await fetch(\n        buildRouteURL(backendURL, aiGroup, aiEndpoints.ask),\n        {\n          method: aiEndpoints.ask.method,\n          headers: {\n            'Content-Type': 'application/json',\n            ...authAPIOptions.headers,\n            ...otherOptions.headers,\n          },\n          body: JSON.stringify({\n            ...rest,\n            ...authAPIOptions.body,\n            ...otherOptions.body,\n          }),\n          signal: abortController.signal,\n          credentials: 'include',\n        }\n      );\n\n      if (!response.ok) {\n        // Align error handling with generic `fetcher` utility so that callers receive\n        // meaningful messages (e.g. for 429 \"Too Many Requests\" responses).\n        let errorMessage: string = 'An error occurred';\n\n        try {\n          // Attempt to parse JSON error payload produced by backend\n          const errorData = await response.json();\n          const errorObj = errorData.error ?? errorData;\n          errorMessage = JSON.stringify(errorObj) ?? 'An error occurred';\n        } catch {\n          // Fallback to plain-text body or HTTP status text\n          try {\n            const errorText = await response.text();\n            if (errorText) {\n              errorMessage = errorText;\n            }\n          } catch {\n            // ignore – we already have a default message\n          }\n        }\n\n        throw new Error(errorMessage);\n      }\n\n      const reader = response.body?.getReader();\n      if (!reader) {\n        throw new Error('No reader available');\n      }\n\n      const decoder = new TextDecoder();\n      let buffer = '';\n\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split('\\n');\n        buffer = lines.pop() ?? '';\n\n        for (const line of lines) {\n          if (line.startsWith('data: ')) {\n            try {\n              const data = JSON.parse(line.slice(6));\n              if (data.chunk) {\n                onMessage?.(data.chunk);\n              }\n              if (data.done && data.response) {\n                onDone?.(data.response);\n              }\n            } catch (e) {\n              console.error('Failed to parse SSE data:', e);\n            }\n          }\n        }\n      }\n    } catch (error) {\n      console.error('Error in askDocQuestion:', error);\n      throw error;\n    }\n  };\n\n  const chat = async (body?: ChatBody, otherOptions: FetcherOptions = {}) => {\n    if (!body) return;\n\n    const { onMessage, onDone, onAction, ...rest } = body;\n    const abortController = new AbortController();\n\n    try {\n      const response = await fetch(\n        buildRouteURL(backendURL, aiGroup, aiEndpoints.chat),\n        {\n          method: aiEndpoints.chat.method,\n          headers: {\n            'Content-Type': 'application/json',\n            ...authAPIOptions.headers,\n            ...otherOptions.headers,\n          },\n          body: JSON.stringify({\n            ...rest,\n            ...authAPIOptions.body,\n            ...otherOptions.body,\n          }),\n          signal: abortController.signal,\n          credentials: 'include',\n        }\n      );\n\n      if (!response.ok) {\n        let errorMessage: string = 'An error occurred';\n\n        try {\n          const errorData = await response.json();\n          const errorObj = errorData.error ?? errorData;\n          errorMessage = JSON.stringify(errorObj) ?? 'An error occurred';\n        } catch {\n          try {\n            const errorText = await response.text();\n            if (errorText) {\n              errorMessage = errorText;\n            }\n          } catch {\n            // ignore\n          }\n        }\n\n        throw new Error(errorMessage);\n      }\n\n      const reader = response.body?.getReader();\n      if (!reader) {\n        throw new Error('No reader available');\n      }\n\n      const decoder = new TextDecoder();\n      let buffer = '';\n\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split('\\n');\n        buffer = lines.pop() ?? '';\n\n        for (const line of lines) {\n          if (line.startsWith('data: ')) {\n            try {\n              const data = JSON.parse(line.slice(6));\n              if (data.chunk) {\n                onMessage?.(data.chunk);\n              }\n              if (data.action) {\n                onAction?.(data.action);\n              }\n              if (data.done && data.response) {\n                onDone?.(data.response);\n              }\n            } catch (e) {\n              console.error('Failed to parse SSE data:', e);\n            }\n          }\n        }\n      }\n    } catch (error) {\n      console.error('Error in chat:', error);\n      throw error;\n    }\n  };\n\n  const autocomplete = async (\n    body?: AutocompleteBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<AutocompleteResponse>(\n      buildRouteURL(backendURL, aiGroup, aiEndpoints.autocomplete),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: aiEndpoints.autocomplete.method,\n        body: body,\n      }\n    );\n\n  /**\n   * Retrieves discussions with filters and pagination. Only user or admin can access.\n   */\n  const getDiscussions = async (\n    params?: GetDiscussionsParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetDiscussionsResult>(\n      buildRouteURL(backendURL, aiGroup, aiEndpoints.getDiscussions),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: aiEndpoints.getDiscussions.method,\n        // @ts-ignore Number of parameter will be stringified by the fetcher\n        params,\n      }\n    );\n\n  /**\n   * Retrieves aggregated AI token-usage statistics for the currently selected\n   * project.\n   */\n  const getAIStats = async (otherOptions: FetcherOptions = {}) =>\n    await fetcher<GetAIStatsResult>(\n      buildRouteURL(backendURL, aiGroup, aiEndpoints.getAIStats),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: aiEndpoints.getAIStats.method,\n      }\n    );\n\n  return {\n    customQuery,\n    translateJSON,\n    auditContentDeclaration,\n    auditContentDeclarationField,\n    auditContentDeclarationMetadata,\n    auditTag,\n    askDocQuestion,\n    chat,\n    autocomplete,\n    getDiscussions,\n    getAIStats,\n  };\n};\n\n/**\n * Authenticated `ai` endpoint bound to an Intlayer CMS authenticator.\n *\n * Pass an authenticator created with `createIntlayerCMS`, or omit it to use\n * the build-time configuration (`@intlayer/config/built`).\n */\nexport const aiEndpoint = createEndpoint(getAiAPI);\n"],"mappings":"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"}

package/dist/esm/getIntlayerAPI/analytics.mjs

@@ -1,25 +1,59 @@
-import { fetcher } from "../fetcher.mjs";
 import { createEndpoint } from "../cms/createIntlayerCMS.mjs";
+import { fetcher } from "../fetcher.mjs";
 import { editor } from "@intlayer/config/built";
+import { buildRouteURL } from "@intlayer/backend-contract/defineRoute";
+import { BACKEND_URL } from "@intlayer/config/defaultValues";
 
-//#region src/getIntlayerAPI/analytics.ts
+// src/getIntlayerAPI/analytics.ts
+/** Prefix of the routes, checked against the backend contract. */
+const analyticsGroup = { prefix: "/api/analytics" };
+/**
+* Method and path of every route, checked against the backend contract at
+* compile time (the contract's zod schemas are never loaded).
+*/
+const analyticsEndpoints = {
+	ingestAnalyticsEvents: {
+		method: "POST",
+		path: "/events"
+	},
+	getAnalyticsOverview: {
+		method: "GET",
+		path: "/overview"
+	},
+	getAnalyticsAudience: {
+		method: "GET",
+		path: "/audience"
+	},
+	getContentStats: {
+		method: "GET",
+		path: "/content-stats"
+	},
+	getExperimentResults: {
+		method: "GET",
+		path: "/experiments/:experimentKey"
+	},
+	getPageMetadata: {
+		method: "GET",
+		path: "/page-metadata"
+	}
+};
 const getAnalyticsAPI = (authAPIOptions = {}, intlayerConfig) => {
-	const ANALYTICS_API_ROUTE = `${intlayerConfig?.editor?.backendURL ?? editor.backendURL}/api/analytics`;
+	const backendURL = intlayerConfig?.editor?.backendURL ?? editor.backendURL ?? BACKEND_URL;
 	/**
 	* Ingest a batch of analytics events. Public — attribution is by the
 	* project's `clientId` in the body.
 	* @param body - Session id, sdk version, and the collected events.
 	* @returns The number of accepted events.
 	*/
-	const sendEvents = async (body, otherOptions = {}) => await fetcher(`${ANALYTICS_API_ROUTE}/events`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const sendEvents = async (body, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, analyticsGroup, analyticsEndpoints.ingestAnalyticsEvents), authAPIOptions, otherOptions, {
+		method: analyticsEndpoints.ingestAnalyticsEvents.method,
 		body
 	});
 	/**
 	* Page/locale totals for the authenticated project.
 	* @returns Views grouped by url and locale.
 	*/
-	const getOverview = async (otherOptions = {}) => await fetcher(`${ANALYTICS_API_ROUTE}/overview`, authAPIOptions, otherOptions, { method: "GET" });
+	const getOverview = async (otherOptions = {}) => await fetcher(buildRouteURL(backendURL, analyticsGroup, analyticsEndpoints.getAnalyticsOverview), authAPIOptions, otherOptions, { method: analyticsEndpoints.getAnalyticsOverview.method });
 	/**
 	* Audience report: distinct visitors (today / 7d / window), page views, the
 	* evolution series, and locale + country breakdowns.
@@ -27,28 +61,28 @@ const getAnalyticsAPI = (authAPIOptions = {}, intlayerConfig) => {
 	*   `30d`, `90d`, `6mo`, `1y`, `3y`) or a number of days (default 30).
 	* @returns The audience statistics.
 	*/
-	const getAudience = async (range = 30, otherOptions = {}) => await fetcher(`${ANALYTICS_API_ROUTE}/audience`, authAPIOptions, otherOptions, {
-		method: "GET",
+	const getAudience = async (range = 30, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, analyticsGroup, analyticsEndpoints.getAnalyticsAudience), authAPIOptions, otherOptions, {
+		method: analyticsEndpoints.getAnalyticsAudience.method,
 		params: typeof range === "number" ? { days: String(range) } : { range }
 	});
 	/**
 	* Per-content exposure totals — "which content is actually shown".
 	* @returns Exposures grouped by dictionary key, key path, and locale.
 	*/
-	const getContentStats = async (otherOptions = {}) => await fetcher(`${ANALYTICS_API_ROUTE}/content-stats`, authAPIOptions, otherOptions, { method: "GET" });
+	const getContentStats = async (otherOptions = {}) => await fetcher(buildRouteURL(backendURL, analyticsGroup, analyticsEndpoints.getContentStats), authAPIOptions, otherOptions, { method: analyticsEndpoints.getContentStats.method });
 	/**
 	* A/B experiment results with per-variant conversion rates and significance.
 	* @param experimentKey - The experiment to evaluate.
 	* @returns The experiment result set.
 	*/
-	const getExperimentResults = async (experimentKey, otherOptions = {}) => await fetcher(`${ANALYTICS_API_ROUTE}/experiments/${experimentKey}`, authAPIOptions, otherOptions, { method: "GET" });
+	const getExperimentResults = async (experimentKey, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, analyticsGroup, analyticsEndpoints.getExperimentResults, { experimentKey }), authAPIOptions, otherOptions, { method: analyticsEndpoints.getExperimentResults.method });
 	/**
 	* Page metadata (title and meta description) for a given url.
 	* @param url - The page url to inspect.
 	* @returns Title and description of the page.
 	*/
-	const getPageMetadata = async (url, otherOptions = {}) => await fetcher(`${ANALYTICS_API_ROUTE}/page-metadata`, authAPIOptions, otherOptions, {
-		method: "GET",
+	const getPageMetadata = async (url, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, analyticsGroup, analyticsEndpoints.getPageMetadata), authAPIOptions, otherOptions, {
+		method: analyticsEndpoints.getPageMetadata.method,
 		params: { url }
 	});
 	return {
@@ -68,6 +102,5 @@ const getAnalyticsAPI = (authAPIOptions = {}, intlayerConfig) => {
 */
 const analyticsEndpoint = createEndpoint(getAnalyticsAPI);
 
-//#endregion
 export { analyticsEndpoint, getAnalyticsAPI };
 //# sourceMappingURL=analytics.mjs.map