@intlayer/api 9.7.0 → 9.7.2

package/dist/cjs/proxy.cjs

@@ -1,32 +1,32 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_getIntlayerAPI_oAuth = require('./getIntlayerAPI/oAuth.cjs');
-const require_cms_createIntlayerCMS = require('./cms/createIntlayerCMS.cjs');
-const require_getIntlayerAPI_ai = require('./getIntlayerAPI/ai.cjs');
-const require_getIntlayerAPI_analytics = require('./getIntlayerAPI/analytics.cjs');
-const require_getIntlayerAPI_asset = require('./getIntlayerAPI/asset.cjs');
-const require_getIntlayerAPI_audit = require('./getIntlayerAPI/audit.cjs');
-const require_getIntlayerAPI_bitbucket = require('./getIntlayerAPI/bitbucket.cjs');
-const require_getIntlayerAPI_codeberg = require('./getIntlayerAPI/codeberg.cjs');
-const require_getIntlayerAPI_dictionary = require('./getIntlayerAPI/dictionary.cjs');
-const require_getIntlayerAPI_editor = require('./getIntlayerAPI/editor.cjs');
-const require_getIntlayerAPI_environment = require('./getIntlayerAPI/environment.cjs');
-const require_getIntlayerAPI_gitee = require('./getIntlayerAPI/gitee.cjs');
-const require_getIntlayerAPI_github = require('./getIntlayerAPI/github.cjs');
-const require_getIntlayerAPI_gitlab = require('./getIntlayerAPI/gitlab.cjs');
-const require_getIntlayerAPI_newsletter = require('./getIntlayerAPI/newsletter.cjs');
-const require_getIntlayerAPI_organization = require('./getIntlayerAPI/organization.cjs');
-const require_getIntlayerAPI_project = require('./getIntlayerAPI/project.cjs');
-const require_getIntlayerAPI_reviewer = require('./getIntlayerAPI/reviewer.cjs');
-const require_getIntlayerAPI_search = require('./getIntlayerAPI/search.cjs');
-const require_getIntlayerAPI_showcaseProject = require('./getIntlayerAPI/showcaseProject.cjs');
-const require_getIntlayerAPI_status = require('./getIntlayerAPI/status.cjs');
-const require_getIntlayerAPI_stripe = require('./getIntlayerAPI/stripe.cjs');
-const require_getIntlayerAPI_tag = require('./getIntlayerAPI/tag.cjs');
-const require_getIntlayerAPI_translate = require('./getIntlayerAPI/translate.cjs');
-const require_getIntlayerAPI_user = require('./getIntlayerAPI/user.cjs');
+const require_cms_createIntlayerCMS = require("./cms/createIntlayerCMS.cjs");
+const require_getIntlayerAPI_ai = require("./getIntlayerAPI/ai.cjs");
+const require_getIntlayerAPI_analytics = require("./getIntlayerAPI/analytics.cjs");
+const require_getIntlayerAPI_asset = require("./getIntlayerAPI/asset.cjs");
+const require_getIntlayerAPI_audit = require("./getIntlayerAPI/audit.cjs");
+const require_getIntlayerAPI_bitbucket = require("./getIntlayerAPI/bitbucket.cjs");
+const require_getIntlayerAPI_codeberg = require("./getIntlayerAPI/codeberg.cjs");
+const require_getIntlayerAPI_dictionary = require("./getIntlayerAPI/dictionary.cjs");
+const require_getIntlayerAPI_editor = require("./getIntlayerAPI/editor.cjs");
+const require_getIntlayerAPI_environment = require("./getIntlayerAPI/environment.cjs");
+const require_getIntlayerAPI_gitee = require("./getIntlayerAPI/gitee.cjs");
+const require_getIntlayerAPI_github = require("./getIntlayerAPI/github.cjs");
+const require_getIntlayerAPI_gitlab = require("./getIntlayerAPI/gitlab.cjs");
+const require_getIntlayerAPI_newsletter = require("./getIntlayerAPI/newsletter.cjs");
+const require_getIntlayerAPI_oAuth = require("./getIntlayerAPI/oAuth.cjs");
+const require_getIntlayerAPI_organization = require("./getIntlayerAPI/organization.cjs");
+const require_getIntlayerAPI_project = require("./getIntlayerAPI/project.cjs");
+const require_getIntlayerAPI_reviewer = require("./getIntlayerAPI/reviewer.cjs");
+const require_getIntlayerAPI_search = require("./getIntlayerAPI/search.cjs");
+const require_getIntlayerAPI_showcaseProject = require("./getIntlayerAPI/showcaseProject.cjs");
+const require_getIntlayerAPI_status = require("./getIntlayerAPI/status.cjs");
+const require_getIntlayerAPI_stripe = require("./getIntlayerAPI/stripe.cjs");
+const require_getIntlayerAPI_tag = require("./getIntlayerAPI/tag.cjs");
+const require_getIntlayerAPI_translate = require("./getIntlayerAPI/translate.cjs");
+const require_getIntlayerAPI_user = require("./getIntlayerAPI/user.cjs");
 let _intlayer_config_built = require("@intlayer/config/built");
 
-//#region src/proxy.ts
+// src/proxy.ts
 const sectionFactories = {
 	asset: require_getIntlayerAPI_asset.getAssetAPI,
 	organization: require_getIntlayerAPI_organization.getOrganizationAPI,
@@ -96,6 +96,5 @@ const getIntlayerAPIProxy = (baseAuthOptions = {}, intlayerConfig = { editor: _i
 	});
 };
 
-//#endregion
 exports.getIntlayerAPIProxy = getIntlayerAPIProxy;
 //# sourceMappingURL=proxy.cjs.map

package/dist/cjs/public/createPublicClient.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 let _intlayer_config_built = require("@intlayer/config/built");
 
-//#region src/public/createPublicClient.ts
+// src/public/createPublicClient.ts
 /**
 * Browser-safe Intlayer client, authenticated without any confidential
 * credential.
@@ -138,6 +138,5 @@ const createPublicClient = ({ intlayerConfig } = {}) => {
 	};
 };
 
-//#endregion
 exports.createPublicClient = createPublicClient;
 //# sourceMappingURL=createPublicClient.cjs.map

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/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/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/getIntlayerAPI/ai.mjs

@@ -1,10 +1,11 @@
-import { fetcher } from "../fetcher.mjs";
 import { createEndpoint } from "../cms/createIntlayerCMS.mjs";
+import { fetcher } from "../fetcher.mjs";
+import { readServerSentEvents } from "./readServerSentEvents.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" };
 /**
@@ -55,6 +56,14 @@ const aiEndpoints = {
 	getAIStats: {
 		method: "GET",
 		path: "/stats"
+	},
+	getAICredits: {
+		method: "GET",
+		path: "/credits"
+	},
+	getAICreditUsage: {
+		method: "GET",
+		path: "/credits/usage"
 	}
 };
 const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
@@ -134,7 +143,7 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 	*/
 	const askDocQuestion = async (body, otherOptions = {}) => {
 		if (!body) return;
-		const { onMessage, onDone, ...rest } = body;
+		const { onMessage, onReasoning, onDone, ...rest } = body;
 		const abortController = new AbortController();
 		try {
 			const response = await fetch(buildRouteURL(backendURL, aiGroup, aiEndpoints.ask), {
@@ -166,24 +175,11 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 				}
 				throw new Error(errorMessage);
 			}
-			const reader = response.body?.getReader();
-			if (!reader) throw new Error("No reader available");
-			const decoder = new TextDecoder();
-			let buffer = "";
-			while (true) {
-				const { done, value } = await reader.read();
-				if (done) break;
-				buffer += decoder.decode(value, { stream: true });
-				const lines = buffer.split("\n");
-				buffer = lines.pop() ?? "";
-				for (const line of lines) if (line.startsWith("data: ")) try {
-					const data = JSON.parse(line.slice(6));
-					if (data.chunk) onMessage?.(data.chunk);
-					if (data.done && data.response) onDone?.(data.response);
-				} catch (e) {
-					console.error("Failed to parse SSE data:", e);
-				}
-			}
+			await readServerSentEvents(response, (data) => {
+				if (data.reasoning) onReasoning?.(data.reasoning);
+				if (data.chunk) onMessage?.(data.chunk);
+				if (data.done && data.response) onDone?.(data.response);
+			});
 		} catch (error) {
 			console.error("Error in askDocQuestion:", error);
 			throw error;
@@ -223,25 +219,11 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 				}
 				throw new Error(errorMessage);
 			}
-			const reader = response.body?.getReader();
-			if (!reader) throw new Error("No reader available");
-			const decoder = new TextDecoder();
-			let buffer = "";
-			while (true) {
-				const { done, value } = await reader.read();
-				if (done) break;
-				buffer += decoder.decode(value, { stream: true });
-				const lines = buffer.split("\n");
-				buffer = lines.pop() ?? "";
-				for (const line of lines) if (line.startsWith("data: ")) try {
-					const data = JSON.parse(line.slice(6));
-					if (data.chunk) onMessage?.(data.chunk);
-					if (data.action) onAction?.(data.action);
-					if (data.done && data.response) onDone?.(data.response);
-				} catch (e) {
-					console.error("Failed to parse SSE data:", e);
-				}
-			}
+			await readServerSentEvents(response, (data) => {
+				if (data.chunk) onMessage?.(data.chunk);
+				if (data.action) onAction?.(data.action);
+				if (data.done && data.response) onDone?.(data.response);
+			});
 		} catch (error) {
 			console.error("Error in chat:", error);
 			throw error;
@@ -263,6 +245,18 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* project.
 	*/
 	const getAIStats = async (otherOptions = {}) => await fetcher(buildRouteURL(backendURL, aiGroup, aiEndpoints.getAIStats), authAPIOptions, otherOptions, { method: aiEndpoints.getAIStats.method });
+	/**
+	* Retrieves the AI credit balance of the selected organization for the
+	* current monthly period.
+	*/
+	const getAICredits = async (otherOptions = {}) => await fetcher(buildRouteURL(backendURL, aiGroup, aiEndpoints.getAICredits), authAPIOptions, otherOptions, { method: aiEndpoints.getAICredits.method });
+	/**
+	* Retrieves the day-by-day AI credit usage of the selected organization.
+	*/
+	const getAICreditUsage = async (params, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, aiGroup, aiEndpoints.getAICreditUsage), authAPIOptions, otherOptions, {
+		method: aiEndpoints.getAICreditUsage.method,
+		params
+	});
 	return {
 		customQuery,
 		translateJSON,
@@ -274,7 +268,9 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 		chat,
 		autocomplete,
 		getDiscussions,
-		getAIStats
+		getAIStats,
+		getAICredits,
+		getAICreditUsage
 	};
 };
 /**
@@ -285,6 +281,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  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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"}
+{"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  GetAICreditsResult,\n  GetAICreditUsageParams,\n  GetAICreditUsageResult,\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';\nimport { readServerSentEvents } from './readServerSentEvents';\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  /** Receives the summarized reasoning of the model as it streams. */\n  onReasoning?: (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\n/** `data:` payload streamed by the `ask` endpoint. */\ntype AskDocQuestionStreamData = {\n  chunk?: string;\n  reasoning?: string;\n  done?: boolean;\n  response?: AskDocQuestionResult;\n};\n\n/** `data:` payload streamed by the `chat` endpoint. */\ntype ChatStreamData = {\n  chunk?: string;\n  action?: ClientAction;\n  done?: boolean;\n  response?: ChatResult;\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  getAICredits: { method: 'GET', path: '/credits' },\n  getAICreditUsage: { method: 'GET', path: '/credits/usage' },\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, onReasoning, 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      await readServerSentEvents<AskDocQuestionStreamData>(response, (data) => {\n        if (data.reasoning) {\n          onReasoning?.(data.reasoning);\n        }\n        if (data.chunk) {\n          onMessage?.(data.chunk);\n        }\n        if (data.done && data.response) {\n          onDone?.(data.response);\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      await readServerSentEvents<ChatStreamData>(response, (data) => {\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      });\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  /**\n   * Retrieves the AI credit balance of the selected organization for the\n   * current monthly period.\n   */\n  const getAICredits = async (otherOptions: FetcherOptions = {}) =>\n    await fetcher<GetAICreditsResult>(\n      buildRouteURL(backendURL, aiGroup, aiEndpoints.getAICredits),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: aiEndpoints.getAICredits.method,\n      }\n    );\n\n  /**\n   * Retrieves the day-by-day AI credit usage of the selected organization.\n   */\n  const getAICreditUsage = async (\n    params?: GetAICreditUsageParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetAICreditUsageResult>(\n      buildRouteURL(backendURL, aiGroup, aiEndpoints.getAICreditUsage),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: aiEndpoints.getAICreditUsage.method,\n        params,\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    getAICredits,\n    getAICreditUsage,\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,10 +1,10 @@
-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" };
 /**
@@ -24,6 +24,14 @@ const analyticsEndpoints = {
 		method: "GET",
 		path: "/audience"
 	},
+	getPageFlow: {
+		method: "GET",
+		path: "/page-flow"
+	},
+	getLiveVisitorFlow: {
+		method: "GET",
+		path: "/audience/live/visitors/:visitorId"
+	},
 	getContentStats: {
 		method: "GET",
 		path: "/content-stats"
@@ -77,6 +85,25 @@ const getAnalyticsAPI = (authAPIOptions = {}, intlayerConfig) => {
 	*/
 	const getExperimentResults = async (experimentKey, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, analyticsGroup, analyticsEndpoints.getExperimentResults, { experimentKey }), authAPIOptions, otherOptions, { method: analyticsEndpoints.getExperimentResults.method });
 	/**
+	* Averaged page-to-page navigation flow from a starting page.
+	* @param range - Rolling window of the report.
+	* @param startUrl - Starting page pathname (default `/`).
+	* @returns The flow steps and the links between them.
+	*/
+	const getPageFlow = async (range, startUrl, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, analyticsGroup, analyticsEndpoints.getPageFlow), authAPIOptions, otherOptions, {
+		method: analyticsEndpoints.getPageFlow.method,
+		params: {
+			range,
+			startUrl
+		}
+	});
+	/**
+	* Page journey of a visitor active in the last 30 minutes.
+	* @param visitorId - The visitor id from the `live` audience report.
+	* @returns The visitor and its steps (`visitor: null` once it went quiet).
+	*/
+	const getLiveVisitorFlow = async (visitorId, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, analyticsGroup, analyticsEndpoints.getLiveVisitorFlow, { visitorId }), authAPIOptions, otherOptions, { method: analyticsEndpoints.getLiveVisitorFlow.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.
@@ -89,6 +116,8 @@ const getAnalyticsAPI = (authAPIOptions = {}, intlayerConfig) => {
 		sendEvents,
 		getOverview,
 		getAudience,
+		getLiveVisitorFlow,
+		getPageFlow,
 		getContentStats,
 		getExperimentResults,
 		getPageMetadata
@@ -102,6 +131,5 @@ const getAnalyticsAPI = (authAPIOptions = {}, intlayerConfig) => {
 */
 const analyticsEndpoint = createEndpoint(getAnalyticsAPI);
 
-//#endregion
 export { analyticsEndpoint, getAnalyticsAPI };
 //# sourceMappingURL=analytics.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"analytics.mjs","names":[],"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,cAAc,OAAO,cAAc;;;;;;;CAQ7D,MAAM,aAAa,OACjB,MACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,YACA,gBACA,mBAAmB,qBACrB,GACA,gBACA,cACA;EACE,QAAQ,mBAAmB,sBAAsB;EACjD;CACF,CACF;;;;;CAMF,MAAM,cAAc,OAAO,eAA+B,CAAC,MACzD,MAAM,QACJ,cACE,YACA,gBACA,mBAAmB,oBACrB,GACA,gBACA,cACA,EAAE,QAAQ,mBAAmB,qBAAqB,OAAO,CAC3D;;;;;;;;CASF,MAAM,cAAc,OAClB,QAAgC,IAChC,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,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,MAAM,QACJ,cACE,YACA,gBACA,mBAAmB,eACrB,GACA,gBACA,cACA,EAAE,QAAQ,mBAAmB,gBAAgB,OAAO,CACtD;;;;;;CAOF,MAAM,uBAAuB,OAC3B,eACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,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,MAAM,QACJ,cACE,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,oBAAoB,eAAe,eAAe"}
+{"version":3,"file":"analytics.mjs","names":[],"sources":["../../../src/getIntlayerAPI/analytics.ts"],"sourcesContent":["import type {\n  AnalyticsRoutes,\n  AudienceRange,\n  analyticsContract,\n  GetAnalyticsOverviewResult,\n  GetAudienceResult,\n  GetContentStatsResult,\n  GetExperimentResultsResult,\n  GetLiveVisitorFlowResult,\n  GetPageFlowResult,\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  getPageFlow: { method: 'GET', path: '/page-flow' },\n  getLiveVisitorFlow: {\n    method: 'GET',\n    path: '/audience/live/visitors/:visitorId',\n  },\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   * Averaged page-to-page navigation flow from a starting page.\n   * @param range - Rolling window of the report.\n   * @param startUrl - Starting page pathname (default `/`).\n   * @returns The flow steps and the links between them.\n   */\n  const getPageFlow = async (\n    range: AudienceRange,\n    startUrl: string,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetPageFlowResult>(\n      buildRouteURL(backendURL, analyticsGroup, analyticsEndpoints.getPageFlow),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: analyticsEndpoints.getPageFlow.method,\n        params: { range, startUrl },\n      }\n    );\n\n  /**\n   * Page journey of a visitor active in the last 30 minutes.\n   * @param visitorId - The visitor id from the `live` audience report.\n   * @returns The visitor and its steps (`visitor: null` once it went quiet).\n   */\n  const getLiveVisitorFlow = async (\n    visitorId: string,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetLiveVisitorFlowResult>(\n      buildRouteURL(\n        backendURL,\n        analyticsGroup,\n        analyticsEndpoints.getLiveVisitorFlow,\n        { visitorId }\n      ),\n      authAPIOptions,\n      otherOptions,\n      { method: analyticsEndpoints.getLiveVisitorFlow.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    getLiveVisitorFlow,\n    getPageFlow,\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":";;;;;;;;AAuBA,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,aAAa;EAAE,QAAQ;EAAO,MAAM;CAAa;CACjD,oBAAoB;EAClB,QAAQ;EACR,MAAM;CACR;CACA,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,cAAc,OAAO,cAAc;;;;;;;CAQ7D,MAAM,aAAa,OACjB,MACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,YACA,gBACA,mBAAmB,qBACrB,GACA,gBACA,cACA;EACE,QAAQ,mBAAmB,sBAAsB;EACjD;CACF,CACF;;;;;CAMF,MAAM,cAAc,OAAO,eAA+B,CAAC,MACzD,MAAM,QACJ,cACE,YACA,gBACA,mBAAmB,oBACrB,GACA,gBACA,cACA,EAAE,QAAQ,mBAAmB,qBAAqB,OAAO,CAC3D;;;;;;;;CASF,MAAM,cAAc,OAClB,QAAgC,IAChC,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,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,MAAM,QACJ,cACE,YACA,gBACA,mBAAmB,eACrB,GACA,gBACA,cACA,EAAE,QAAQ,mBAAmB,gBAAgB,OAAO,CACtD;;;;;;CAOF,MAAM,uBAAuB,OAC3B,eACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,YACA,gBACA,mBAAmB,sBACnB,EAAE,cAAc,CAClB,GACA,gBACA,cACA,EAAE,QAAQ,mBAAmB,qBAAqB,OAAO,CAC3D;;;;;;;CAQF,MAAM,cAAc,OAClB,OACA,UACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,gBAAgB,mBAAmB,WAAW,GACxE,gBACA,cACA;EACE,QAAQ,mBAAmB,YAAY;EACvC,QAAQ;GAAE;GAAO;EAAS;CAC5B,CACF;;;;;;CAOF,MAAM,qBAAqB,OACzB,WACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,YACA,gBACA,mBAAmB,oBACnB,EAAE,UAAU,CACd,GACA,gBACA,cACA,EAAE,QAAQ,mBAAmB,mBAAmB,OAAO,CACzD;;;;;;CAOF,MAAM,kBAAkB,OACtB,KACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,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;EACA;EACA;CACF;AACF;;;;;;;AAQA,MAAa,oBAAoB,eAAe,eAAe"}

package/dist/esm/getIntlayerAPI/asset.mjs

@@ -1,10 +1,10 @@
-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/asset.ts
+// src/getIntlayerAPI/asset.ts
 /** Prefix of the routes, checked against the backend contract. */
 const assetGroup = { prefix: "/api/assets" };
 /**
@@ -118,6 +118,5 @@ const getAssetAPI = (authAPIOptions = {}, intlayerConfig) => {
 */
 const assetEndpoint = createEndpoint(getAssetAPI);
 
-//#endregion
 export { assetEndpoint, getAssetAPI };
 //# sourceMappingURL=asset.mjs.map

package/dist/esm/getIntlayerAPI/audit.mjs

@@ -1,10 +1,10 @@
-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/audit.ts
+// src/getIntlayerAPI/audit.ts
 /** Prefix of the routes, checked against the backend contract. */
 const scanGroup = { prefix: "/api/scan" };
 /**
@@ -176,6 +176,5 @@ const getAuditAPI = (authAPIOptions = {}, intlayerConfig) => {
 */
 const auditEndpoint = createEndpoint(getAuditAPI);
 
-//#endregion
 export { auditEndpoint, getAuditAPI };
 //# sourceMappingURL=audit.mjs.map

package/dist/esm/getIntlayerAPI/bitbucket.mjs

@@ -1,10 +1,10 @@
-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/bitbucket.ts
+// src/getIntlayerAPI/bitbucket.ts
 /** Prefix of the routes, checked against the backend contract. */
 const bitbucketGroup = { prefix: "/api/bitbucket" };
 /**
@@ -103,6 +103,5 @@ const getBitbucketAPI = (authAPIOptions = {}, intlayerConfig) => {
 */
 const bitbucketEndpoint = createEndpoint(getBitbucketAPI);
 
-//#endregion
 export { bitbucketEndpoint, getBitbucketAPI };
 //# sourceMappingURL=bitbucket.mjs.map

package/dist/esm/getIntlayerAPI/codeberg.mjs

@@ -1,7 +1,7 @@
 import { createEndpoint } from "../cms/createIntlayerCMS.mjs";
 import { createForgeAPI } from "./forge.mjs";
 
-//#region src/getIntlayerAPI/codeberg.ts
+// src/getIntlayerAPI/codeberg.ts
 /** Prefix of the routes, checked against the backend contract. */
 const codebergGroup = { prefix: "/api/codeberg" };
 /** Codeberg (Forgejo) repositories of the linked account. */
@@ -14,6 +14,5 @@ const getCodebergAPI = createForgeAPI(codebergGroup);
 */
 const codebergEndpoint = createEndpoint(getCodebergAPI);
 
-//#endregion
 export { codebergEndpoint, getCodebergAPI };
 //# sourceMappingURL=codeberg.mjs.map

package/dist/esm/getIntlayerAPI/dictionary.mjs

@@ -1,10 +1,10 @@
-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/dictionary.ts
+// src/getIntlayerAPI/dictionary.ts
 /** Prefix of the routes, checked against the backend contract. */
 const dictionaryGroup = { prefix: "/api/dictionary" };
 /**
@@ -133,6 +133,5 @@ const getDictionaryAPI = (authAPIOptions = {}, intlayerConfig) => {
 */
 const dictionaryEndpoint = createEndpoint(getDictionaryAPI);
 
-//#endregion
 export { dictionaryEndpoint, getDictionaryAPI };
 //# sourceMappingURL=dictionary.mjs.map