@intlayer/api 9.6.0 → 9.7.1

package/dist/cjs/cms/createAuthManager.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_getIntlayerAPI_oAuth = require('../getIntlayerAPI/oAuth.cjs');
+const require_getIntlayerAPI_oAuth = require("../getIntlayerAPI/oAuth.cjs");
 let _intlayer_config_built = require("@intlayer/config/built");
 let _intlayer_config_secrets = require("@intlayer/config/secrets");
 let defu = require("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
@@ -153,7 +153,6 @@ const createAuthManager = (intlayerConfig = { editor: _intlayer_config_built.edi
 	};
 };
 
-//#endregion
 exports.clearAccessTokenCache = clearAccessTokenCache;
 exports.createAuthManager = createAuthManager;
 //# sourceMappingURL=createAuthManager.cjs.map

package/dist/cjs/cms/createIntlayerCMS.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_cms_createAuthManager = require('./createAuthManager.cjs');
+const require_cms_createAuthManager = require("./createAuthManager.cjs");
 let _intlayer_config_built = require("@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).
@@ -58,7 +58,6 @@ const createIntlayerCMS = (intlayerConfig = { editor: _intlayer_config_built.edi
 */
 const createEndpoint = (factory, options) => (cms = createIntlayerCMS()) => cms.bindSection(factory, options);
 
-//#endregion
 exports.createEndpoint = createEndpoint;
 exports.createIntlayerCMS = createIntlayerCMS;
 //# sourceMappingURL=createIntlayerCMS.cjs.map

package/dist/cjs/cms/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_cms_createAuthManager = require('./createAuthManager.cjs');
-const require_cms_createIntlayerCMS = require('./createIntlayerCMS.cjs');
+const require_cms_createAuthManager = require("./createAuthManager.cjs");
+const require_cms_createIntlayerCMS = require("./createIntlayerCMS.cjs");
 
 exports.clearAccessTokenCache = require_cms_createAuthManager.clearAccessTokenCache;
 exports.createAuthManager = require_cms_createAuthManager.createAuthManager;

package/dist/cjs/distantDictionary/fetchDistantDictionaries.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_cms_createIntlayerCMS = require('../cms/createIntlayerCMS.cjs');
-const require_getIntlayerAPI_dictionary = require('../getIntlayerAPI/dictionary.cjs');
+const require_cms_createIntlayerCMS = require("../cms/createIntlayerCMS.cjs");
+const require_getIntlayerAPI_dictionary = require("../getIntlayerAPI/dictionary.cjs");
 
-//#region src/distantDictionary/fetchDistantDictionaries.ts
+// src/distantDictionary/fetchDistantDictionaries.ts
 /**
 * Fetch distant dictionary
 */
@@ -17,6 +17,5 @@ const fetchDistantDictionaries = async (intlayerConfig) => {
 	}
 };
 
-//#endregion
 exports.fetchDistantDictionaries = fetchDistantDictionaries;
 //# sourceMappingURL=fetchDistantDictionaries.cjs.map

package/dist/cjs/distantDictionary/fetchDistantDictionaries.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"fetchDistantDictionaries.cjs","names":["dictionaryEndpoint","createIntlayerCMS"],"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,MALTA,qDAAmBC,gDAAkB,cAAc,CAG3B,CAAC,CAAC,gBAAgB,EAEd,CAAC;CAGlD,SAAS,OAAO;EACd,QAAQ,MAAM,KAAK;EACnB;CACF;AACF"}
+{"version":3,"file":"fetchDistantDictionaries.cjs","names":["dictionaryEndpoint","createIntlayerCMS"],"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,MALTA,qDAAmBC,gDAAkB,cAAc,CAG3B,CAAC,CAAC,gBAAgB,EAEd,CAAC;CAGlD,SAAS,OAAO;EACd,QAAQ,MAAM,KAAK;EACnB;CACF;AACF"}

package/dist/cjs/distantDictionary/fetchDistantDictionary.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_cms_createIntlayerCMS = require('../cms/createIntlayerCMS.cjs');
-const require_getIntlayerAPI_dictionary = require('../getIntlayerAPI/dictionary.cjs');
+const require_cms_createIntlayerCMS = require("../cms/createIntlayerCMS.cjs");
+const require_getIntlayerAPI_dictionary = require("../getIntlayerAPI/dictionary.cjs");
 
-//#region src/distantDictionary/fetchDistantDictionary.ts
+// src/distantDictionary/fetchDistantDictionary.ts
 /**
 * Fetch distant dictionary
 */
@@ -19,6 +19,5 @@ const fetchDistantDictionary = async (dictionaryKey, intlayerConfig) => {
 	}
 };
 
-//#endregion
 exports.fetchDistantDictionary = fetchDistantDictionary;
 //# sourceMappingURL=fetchDistantDictionary.cjs.map

package/dist/cjs/distantDictionary/fetchDistantDictionary.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"fetchDistantDictionary.cjs","names":["dictionaryEndpoint","createIntlayerCMS"],"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,MALPA,qDAAmBC,gDAAkB,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.cjs","names":["dictionaryEndpoint","createIntlayerCMS"],"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,MALPA,qDAAmBC,gDAAkB,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/cjs/distantDictionary/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_distantDictionary_fetchDistantDictionaries = require('./fetchDistantDictionaries.cjs');
-const require_distantDictionary_fetchDistantDictionary = require('./fetchDistantDictionary.cjs');
+const require_distantDictionary_fetchDistantDictionaries = require("./fetchDistantDictionaries.cjs");
+const require_distantDictionary_fetchDistantDictionary = require("./fetchDistantDictionary.cjs");
 
 exports.fetchDistantDictionaries = require_distantDictionary_fetchDistantDictionaries.fetchDistantDictionaries;
 exports.fetchDistantDictionary = require_distantDictionary_fetchDistantDictionary.fetchDistantDictionary;

package/dist/cjs/fetcher.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_resolveInternalBackendUrl = require('./resolveInternalBackendUrl.cjs');
+const require_resolveInternalBackendUrl = require("./resolveInternalBackendUrl.cjs");
 
-//#region src/fetcher.ts
+// src/fetcher.ts
 /**
 * Error thrown when the backend answers with a non-ok response.
 *
@@ -145,7 +145,6 @@ const fetcher = async (url, ...options) => {
 	return await response.json();
 };
 
-//#endregion
 exports.FetcherError = FetcherError;
 exports.fetcher = fetcher;
 exports.fetcherOptions = fetcherOptions;

package/dist/cjs/fetcher.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"fetcher.cjs","names":["resolveInternalBackendUrl"],"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,YAAYA,4DAA0B,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.cjs","names":["resolveInternalBackendUrl"],"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,YAAYA,4DAA0B,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/cjs/getIntlayerAPI/ai.cjs

@@ -1,18 +1,72 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_fetcher = require('../fetcher.cjs');
-const require_cms_createIntlayerCMS = require('../cms/createIntlayerCMS.cjs');
+const require_cms_createIntlayerCMS = require("../cms/createIntlayerCMS.cjs");
+const require_fetcher = require("../fetcher.cjs");
 let _intlayer_config_built = require("@intlayer/config/built");
+let _intlayer_backend_contract_defineRoute = require("@intlayer/backend-contract/defineRoute");
+let _intlayer_config_defaultValues = require("@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 ?? _intlayer_config_built.editor.backendURL}/api/ai`;
+	const backendURL = intlayerConfig?.editor?.backendURL ?? _intlayer_config_built.editor.backendURL ?? _intlayer_config_defaultValues.BACKEND_URL;
 	/**
 	* Custom query
 	* @param body - Custom query parameters.
 	* @returns Custom query result.
 	*/
-	const customQuery = async (body, otherOptions = {}) => await require_fetcher.fetcher(AI_API_ROUTE, authAPIOptions, otherOptions, {
-		method: "POST",
+	const customQuery = async (body, otherOptions = {}) => await require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.buildRouteURL)(backendURL, aiGroup, aiEndpoints.customQuery), authAPIOptions, otherOptions, {
+		method: aiEndpoints.customQuery.method,
 		body
 	});
 	/**
@@ -20,8 +74,8 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* @param body - Audit file parameters.
 	* @returns Audited file content.
 	*/
-	const translateJSON = async (body, otherOptions = {}) => await require_fetcher.fetcher(`${AI_API_ROUTE}/translate/json`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const translateJSON = async (body, otherOptions = {}) => await require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.buildRouteURL)(backendURL, aiGroup, aiEndpoints.translateJSON), authAPIOptions, otherOptions, {
+		method: aiEndpoints.translateJSON.method,
 		body
 	});
 	/**
@@ -29,8 +83,8 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* @param body - Audit file parameters.
 	* @returns Audited file content.
 	*/
-	const auditContentDeclaration = async (body, otherOptions = {}) => await require_fetcher.fetcher(`${AI_API_ROUTE}/audit/dictionary`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const auditContentDeclaration = async (body, otherOptions = {}) => await require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.buildRouteURL)(backendURL, aiGroup, aiEndpoints.auditContentDeclaration), authAPIOptions, otherOptions, {
+		method: aiEndpoints.auditContentDeclaration.method,
 		body
 	});
 	/**
@@ -38,8 +92,8 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* @param body - Audit file parameters.
 	* @returns Audited file content.
 	*/
-	const auditContentDeclarationField = async (body, otherOptions = {}) => await require_fetcher.fetcher(`${AI_API_ROUTE}/audit/dictionary/field`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const auditContentDeclarationField = async (body, otherOptions = {}) => await require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.buildRouteURL)(backendURL, aiGroup, aiEndpoints.auditContentDeclarationField), authAPIOptions, otherOptions, {
+		method: aiEndpoints.auditContentDeclarationField.method,
 		body
 	});
 	/**
@@ -47,8 +101,8 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* @param body - Audit file parameters.
 	* @returns Audited file content.
 	*/
-	const auditContentDeclarationMetadata = async (body, otherOptions = {}) => await require_fetcher.fetcher(`${AI_API_ROUTE}/audit/dictionary/metadata`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const auditContentDeclarationMetadata = async (body, otherOptions = {}) => await require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.buildRouteURL)(backendURL, aiGroup, aiEndpoints.auditContentDeclarationMetadata), authAPIOptions, otherOptions, {
+		method: aiEndpoints.auditContentDeclarationMetadata.method,
 		body
 	});
 	/**
@@ -56,8 +110,8 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* @param body - Audit tag parameters.
 	* @returns Audited tag content.
 	*/
-	const auditTag = async (body, otherOptions = {}) => await require_fetcher.fetcher(`${AI_API_ROUTE}/audit/tag`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const auditTag = async (body, otherOptions = {}) => await require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.buildRouteURL)(backendURL, aiGroup, aiEndpoints.auditTag), authAPIOptions, otherOptions, {
+		method: aiEndpoints.auditTag.method,
 		body
 	});
 	/**
@@ -84,8 +138,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((0, _intlayer_backend_contract_defineRoute.buildRouteURL)(backendURL, aiGroup, aiEndpoints.ask), {
+				method: aiEndpoints.ask.method,
 				headers: {
 					"Content-Type": "application/json",
 					...authAPIOptions.headers,
@@ -141,8 +195,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((0, _intlayer_backend_contract_defineRoute.buildRouteURL)(backendURL, aiGroup, aiEndpoints.chat), {
+				method: aiEndpoints.chat.method,
 				headers: {
 					"Content-Type": "application/json",
 					...authAPIOptions.headers,
@@ -194,22 +248,22 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 			throw error;
 		}
 	};
-	const autocomplete = async (body, otherOptions = {}) => await require_fetcher.fetcher(`${AI_API_ROUTE}/autocomplete`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const autocomplete = async (body, otherOptions = {}) => await require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.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 require_fetcher.fetcher(`${AI_API_ROUTE}/discussions`, authAPIOptions, otherOptions, {
-		method: "GET",
+	const getDiscussions = async (params, otherOptions = {}) => await require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.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 require_fetcher.fetcher(`${AI_API_ROUTE}/stats`, authAPIOptions, otherOptions, { method: "GET" });
+	const getAIStats = async (otherOptions = {}) => await require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.buildRouteURL)(backendURL, aiGroup, aiEndpoints.getAIStats), authAPIOptions, otherOptions, { method: aiEndpoints.getAIStats.method });
 	return {
 		customQuery,
 		translateJSON,
@@ -232,7 +286,6 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 */
 const aiEndpoint = require_cms_createIntlayerCMS.createEndpoint(getAiAPI);
 
-//#endregion
 exports.aiEndpoint = aiEndpoint;
 exports.getAiAPI = getAiAPI;
 //# sourceMappingURL=ai.cjs.map

package/dist/cjs/getIntlayerAPI/ai.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ai.cjs","names":["editor","fetcher","createEndpoint"],"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.cjs","names":["editor","BACKEND_URL","fetcher","buildRouteURL","createEndpoint"],"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/cjs/getIntlayerAPI/analytics.cjs

@@ -1,26 +1,60 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_fetcher = require('../fetcher.cjs');
-const require_cms_createIntlayerCMS = require('../cms/createIntlayerCMS.cjs');
+const require_cms_createIntlayerCMS = require("../cms/createIntlayerCMS.cjs");
+const require_fetcher = require("../fetcher.cjs");
 let _intlayer_config_built = require("@intlayer/config/built");
+let _intlayer_backend_contract_defineRoute = require("@intlayer/backend-contract/defineRoute");
+let _intlayer_config_defaultValues = require("@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 ?? _intlayer_config_built.editor.backendURL}/api/analytics`;
+	const backendURL = intlayerConfig?.editor?.backendURL ?? _intlayer_config_built.editor.backendURL ?? _intlayer_config_defaultValues.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 require_fetcher.fetcher(`${ANALYTICS_API_ROUTE}/events`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const sendEvents = async (body, otherOptions = {}) => await require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.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 require_fetcher.fetcher(`${ANALYTICS_API_ROUTE}/overview`, authAPIOptions, otherOptions, { method: "GET" });
+	const getOverview = async (otherOptions = {}) => await require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.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.
@@ -28,28 +62,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 require_fetcher.fetcher(`${ANALYTICS_API_ROUTE}/audience`, authAPIOptions, otherOptions, {
-		method: "GET",
+	const getAudience = async (range = 30, otherOptions = {}) => await require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.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 require_fetcher.fetcher(`${ANALYTICS_API_ROUTE}/content-stats`, authAPIOptions, otherOptions, { method: "GET" });
+	const getContentStats = async (otherOptions = {}) => await require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.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 require_fetcher.fetcher(`${ANALYTICS_API_ROUTE}/experiments/${experimentKey}`, authAPIOptions, otherOptions, { method: "GET" });
+	const getExperimentResults = async (experimentKey, otherOptions = {}) => await require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.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 require_fetcher.fetcher(`${ANALYTICS_API_ROUTE}/page-metadata`, authAPIOptions, otherOptions, {
-		method: "GET",
+	const getPageMetadata = async (url, otherOptions = {}) => await require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.buildRouteURL)(backendURL, analyticsGroup, analyticsEndpoints.getPageMetadata), authAPIOptions, otherOptions, {
+		method: analyticsEndpoints.getPageMetadata.method,
 		params: { url }
 	});
 	return {
@@ -69,7 +103,6 @@ const getAnalyticsAPI = (authAPIOptions = {}, intlayerConfig) => {
 */
 const analyticsEndpoint = require_cms_createIntlayerCMS.createEndpoint(getAnalyticsAPI);
 
-//#endregion
 exports.analyticsEndpoint = analyticsEndpoint;
 exports.getAnalyticsAPI = getAnalyticsAPI;
 //# sourceMappingURL=analytics.cjs.map

package/dist/cjs/getIntlayerAPI/analytics.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.cjs","names":["editor","fetcher","createEndpoint"],"sources":["../../../src/getIntlayerAPI/analytics.ts"],"sourcesContent":["import type {\n  AudienceRange,\n  GetAnalyticsOverviewResult,\n  GetAudienceResult,\n  GetContentStatsResult,\n  GetExperimentResultsResult,\n  GetPageMetadataResult,\n  IngestAnalyticsBody,\n  IngestAnalyticsResult,\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 const getAnalyticsAPI = (\n  authAPIOptions: FetcherOptions = {},\n  intlayerConfig?: IntlayerConfig\n) => {\n  const backendURL = intlayerConfig?.editor?.backendURL ?? editor.backendURL;\n\n  const ANALYTICS_API_ROUTE = `${backendURL}/api/analytics`;\n\n  /**\n   * Ingest a batch of analytics events. Public — attribution is by the\n   * project's `clientId` in the body.\n   * @param body - Session id, sdk version, and the collected events.\n   * @returns The number of accepted events.\n   */\n  const sendEvents = async (\n    body: IngestAnalyticsBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<IngestAnalyticsResult>(\n      `${ANALYTICS_API_ROUTE}/events`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'POST',\n        body,\n      }\n    );\n\n  /**\n   * Page/locale totals for the authenticated project.\n   * @returns Views grouped by url and locale.\n   */\n  const getOverview = async (otherOptions: FetcherOptions = {}) =>\n    await fetcher<GetAnalyticsOverviewResult>(\n      `${ANALYTICS_API_ROUTE}/overview`,\n      authAPIOptions,\n      otherOptions,\n      { method: 'GET' }\n    );\n\n  /**\n   * Audience report: distinct visitors (today / 7d / window), page views, the\n   * evolution series, and locale + country breakdowns.\n   * @param range - Rolling window, either a named range (`1h`, `24h`, `7d`,\n   *   `30d`, `90d`, `6mo`, `1y`, `3y`) or a number of days (default 30).\n   * @returns The audience statistics.\n   */\n  const getAudience = async (\n    range: AudienceRange | number = 30,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetAudienceResult>(\n      `${ANALYTICS_API_ROUTE}/audience`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'GET',\n        params: typeof range === 'number' ? { days: String(range) } : { range },\n      }\n    );\n\n  /**\n   * Per-content exposure totals — \"which content is actually shown\".\n   * @returns Exposures grouped by dictionary key, key path, and locale.\n   */\n  const getContentStats = async (otherOptions: FetcherOptions = {}) =>\n    await fetcher<GetContentStatsResult>(\n      `${ANALYTICS_API_ROUTE}/content-stats`,\n      authAPIOptions,\n      otherOptions,\n      { method: 'GET' }\n    );\n\n  /**\n   * A/B experiment results with per-variant conversion rates and significance.\n   * @param experimentKey - The experiment to evaluate.\n   * @returns The experiment result set.\n   */\n  const getExperimentResults = async (\n    experimentKey: string,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetExperimentResultsResult>(\n      `${ANALYTICS_API_ROUTE}/experiments/${experimentKey}`,\n      authAPIOptions,\n      otherOptions,\n      { method: 'GET' }\n    );\n\n  /**\n   * Page metadata (title and meta description) for a given url.\n   * @param url - The page url to inspect.\n   * @returns Title and description of the page.\n   */\n  const getPageMetadata = async (\n    url: string,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetPageMetadataResult>(\n      `${ANALYTICS_API_ROUTE}/page-metadata`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'GET',\n        params: { url },\n      }\n    );\n\n  return {\n    sendEvents,\n    getOverview,\n    getAudience,\n    getContentStats,\n    getExperimentResults,\n    getPageMetadata,\n  };\n};\n\n/**\n * Authenticated `analytics` 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 analyticsEndpoint = createEndpoint(getAnalyticsAPI);\n"],"mappings":";;;;;;AAeA,MAAa,mBACX,iBAAiC,CAAC,GAClC,mBACG;CAGH,MAAM,sBAAsB,GAFT,gBAAgB,QAAQ,cAAcA,8BAAO,WAEtB;;;;;;;CAQ1C,MAAM,aAAa,OACjB,MACA,eAA+B,CAAC,MAEhC,MAAMC,wBACJ,GAAG,oBAAoB,UACvB,gBACA,cACA;EACE,QAAQ;EACR;CACF,CACF;;;;;CAMF,MAAM,cAAc,OAAO,eAA+B,CAAC,MACzD,MAAMA,wBACJ,GAAG,oBAAoB,YACvB,gBACA,cACA,EAAE,QAAQ,MAAM,CAClB;;;;;;;;CASF,MAAM,cAAc,OAClB,QAAgC,IAChC,eAA+B,CAAC,MAEhC,MAAMA,wBACJ,GAAG,oBAAoB,YACvB,gBACA,cACA;EACE,QAAQ;EACR,QAAQ,OAAO,UAAU,WAAW,EAAE,MAAM,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM;CACxE,CACF;;;;;CAMF,MAAM,kBAAkB,OAAO,eAA+B,CAAC,MAC7D,MAAMA,wBACJ,GAAG,oBAAoB,iBACvB,gBACA,cACA,EAAE,QAAQ,MAAM,CAClB;;;;;;CAOF,MAAM,uBAAuB,OAC3B,eACA,eAA+B,CAAC,MAEhC,MAAMA,wBACJ,GAAG,oBAAoB,eAAe,iBACtC,gBACA,cACA,EAAE,QAAQ,MAAM,CAClB;;;;;;CAOF,MAAM,kBAAkB,OACtB,KACA,eAA+B,CAAC,MAEhC,MAAMA,wBACJ,GAAG,oBAAoB,iBACvB,gBACA,cACA;EACE,QAAQ;EACR,QAAQ,EAAE,IAAI;CAChB,CACF;CAEF,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;CACF;AACF;;;;;;;AAQA,MAAa,oBAAoBC,6CAAe,eAAe"}
+{"version":3,"file":"analytics.cjs","names":["editor","BACKEND_URL","fetcher","buildRouteURL","createEndpoint"],"sources":["../../../src/getIntlayerAPI/analytics.ts"],"sourcesContent":["import type {\n  AnalyticsRoutes,\n  AudienceRange,\n  analyticsContract,\n  GetAnalyticsOverviewResult,\n  GetAudienceResult,\n  GetContentStatsResult,\n  GetExperimentResultsResult,\n  GetPageMetadataResult,\n  IngestAnalyticsBody,\n  IngestAnalyticsResult,\n} from '@intlayer/backend-contract/analytics';\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\n/** Prefix of the routes, checked against the backend contract. */\nconst analyticsGroup = {\n  prefix: '/api/analytics',\n} as const satisfies Pick<typeof analyticsContract, '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 analyticsEndpoints = {\n  ingestAnalyticsEvents: { method: 'POST', path: '/events' },\n  getAnalyticsOverview: { method: 'GET', path: '/overview' },\n  getAnalyticsAudience: { method: 'GET', path: '/audience' },\n  getContentStats: { method: 'GET', path: '/content-stats' },\n  getExperimentResults: { method: 'GET', path: '/experiments/:experimentKey' },\n  getPageMetadata: { method: 'GET', path: '/page-metadata' },\n} as const satisfies RouteEndpoints<AnalyticsRoutes>;\n\nexport const getAnalyticsAPI = (\n  authAPIOptions: FetcherOptions = {},\n  intlayerConfig?: IntlayerConfig\n) => {\n  const backendURL =\n    intlayerConfig?.editor?.backendURL ?? editor.backendURL ?? BACKEND_URL;\n\n  /**\n   * Ingest a batch of analytics events. Public — attribution is by the\n   * project's `clientId` in the body.\n   * @param body - Session id, sdk version, and the collected events.\n   * @returns The number of accepted events.\n   */\n  const sendEvents = async (\n    body: IngestAnalyticsBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<IngestAnalyticsResult>(\n      buildRouteURL(\n        backendURL,\n        analyticsGroup,\n        analyticsEndpoints.ingestAnalyticsEvents\n      ),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: analyticsEndpoints.ingestAnalyticsEvents.method,\n        body,\n      }\n    );\n\n  /**\n   * Page/locale totals for the authenticated project.\n   * @returns Views grouped by url and locale.\n   */\n  const getOverview = async (otherOptions: FetcherOptions = {}) =>\n    await fetcher<GetAnalyticsOverviewResult>(\n      buildRouteURL(\n        backendURL,\n        analyticsGroup,\n        analyticsEndpoints.getAnalyticsOverview\n      ),\n      authAPIOptions,\n      otherOptions,\n      { method: analyticsEndpoints.getAnalyticsOverview.method }\n    );\n\n  /**\n   * Audience report: distinct visitors (today / 7d / window), page views, the\n   * evolution series, and locale + country breakdowns.\n   * @param range - Rolling window, either a named range (`1h`, `24h`, `7d`,\n   *   `30d`, `90d`, `6mo`, `1y`, `3y`) or a number of days (default 30).\n   * @returns The audience statistics.\n   */\n  const getAudience = async (\n    range: AudienceRange | number = 30,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetAudienceResult>(\n      buildRouteURL(\n        backendURL,\n        analyticsGroup,\n        analyticsEndpoints.getAnalyticsAudience\n      ),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: analyticsEndpoints.getAnalyticsAudience.method,\n        params: typeof range === 'number' ? { days: String(range) } : { range },\n      }\n    );\n\n  /**\n   * Per-content exposure totals — \"which content is actually shown\".\n   * @returns Exposures grouped by dictionary key, key path, and locale.\n   */\n  const getContentStats = async (otherOptions: FetcherOptions = {}) =>\n    await fetcher<GetContentStatsResult>(\n      buildRouteURL(\n        backendURL,\n        analyticsGroup,\n        analyticsEndpoints.getContentStats\n      ),\n      authAPIOptions,\n      otherOptions,\n      { method: analyticsEndpoints.getContentStats.method }\n    );\n\n  /**\n   * A/B experiment results with per-variant conversion rates and significance.\n   * @param experimentKey - The experiment to evaluate.\n   * @returns The experiment result set.\n   */\n  const getExperimentResults = async (\n    experimentKey: string,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetExperimentResultsResult>(\n      buildRouteURL(\n        backendURL,\n        analyticsGroup,\n        analyticsEndpoints.getExperimentResults,\n        { experimentKey }\n      ),\n      authAPIOptions,\n      otherOptions,\n      { method: analyticsEndpoints.getExperimentResults.method }\n    );\n\n  /**\n   * Page metadata (title and meta description) for a given url.\n   * @param url - The page url to inspect.\n   * @returns Title and description of the page.\n   */\n  const getPageMetadata = async (\n    url: string,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetPageMetadataResult>(\n      buildRouteURL(\n        backendURL,\n        analyticsGroup,\n        analyticsEndpoints.getPageMetadata\n      ),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: analyticsEndpoints.getPageMetadata.method,\n        params: { url },\n      }\n    );\n\n  return {\n    sendEvents,\n    getOverview,\n    getAudience,\n    getContentStats,\n    getExperimentResults,\n    getPageMetadata,\n  };\n};\n\n/**\n * Authenticated `analytics` 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 analyticsEndpoint = createEndpoint(getAnalyticsAPI);\n"],"mappings":";;;;;;;;;AAqBA,MAAM,iBAAiB,EACrB,QAAQ,iBACV;;;;;AAMA,MAAM,qBAAqB;CACzB,uBAAuB;EAAE,QAAQ;EAAQ,MAAM;CAAU;CACzD,sBAAsB;EAAE,QAAQ;EAAO,MAAM;CAAY;CACzD,sBAAsB;EAAE,QAAQ;EAAO,MAAM;CAAY;CACzD,iBAAiB;EAAE,QAAQ;EAAO,MAAM;CAAiB;CACzD,sBAAsB;EAAE,QAAQ;EAAO,MAAM;CAA8B;CAC3E,iBAAiB;EAAE,QAAQ;EAAO,MAAM;CAAiB;AAC3D;AAEA,MAAa,mBACX,iBAAiC,CAAC,GAClC,mBACG;CACH,MAAM,aACJ,gBAAgB,QAAQ,cAAcA,8BAAO,cAAcC;;;;;;;CAQ7D,MAAM,aAAa,OACjB,MACA,eAA+B,CAAC,MAEhC,MAAMC,4BACJC,sDACE,YACA,gBACA,mBAAmB,qBACrB,GACA,gBACA,cACA;EACE,QAAQ,mBAAmB,sBAAsB;EACjD;CACF,CACF;;;;;CAMF,MAAM,cAAc,OAAO,eAA+B,CAAC,MACzD,MAAMD,4BACJC,sDACE,YACA,gBACA,mBAAmB,oBACrB,GACA,gBACA,cACA,EAAE,QAAQ,mBAAmB,qBAAqB,OAAO,CAC3D;;;;;;;;CASF,MAAM,cAAc,OAClB,QAAgC,IAChC,eAA+B,CAAC,MAEhC,MAAMD,4BACJC,sDACE,YACA,gBACA,mBAAmB,oBACrB,GACA,gBACA,cACA;EACE,QAAQ,mBAAmB,qBAAqB;EAChD,QAAQ,OAAO,UAAU,WAAW,EAAE,MAAM,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM;CACxE,CACF;;;;;CAMF,MAAM,kBAAkB,OAAO,eAA+B,CAAC,MAC7D,MAAMD,4BACJC,sDACE,YACA,gBACA,mBAAmB,eACrB,GACA,gBACA,cACA,EAAE,QAAQ,mBAAmB,gBAAgB,OAAO,CACtD;;;;;;CAOF,MAAM,uBAAuB,OAC3B,eACA,eAA+B,CAAC,MAEhC,MAAMD,4BACJC,sDACE,YACA,gBACA,mBAAmB,sBACnB,EAAE,cAAc,CAClB,GACA,gBACA,cACA,EAAE,QAAQ,mBAAmB,qBAAqB,OAAO,CAC3D;;;;;;CAOF,MAAM,kBAAkB,OACtB,KACA,eAA+B,CAAC,MAEhC,MAAMD,4BACJC,sDACE,YACA,gBACA,mBAAmB,eACrB,GACA,gBACA,cACA;EACE,QAAQ,mBAAmB,gBAAgB;EAC3C,QAAQ,EAAE,IAAI;CAChB,CACF;CAEF,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;CACF;AACF;;;;;;;AAQA,MAAa,oBAAoBC,6CAAe,eAAe"}