@intlayer/api 9.7.1 → 9.7.2

package/dist/cjs/getIntlayerAPI/ai.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_cms_createIntlayerCMS = require("../cms/createIntlayerCMS.cjs");
 const require_fetcher = require("../fetcher.cjs");
+const require_getIntlayerAPI_readServerSentEvents = require("./readServerSentEvents.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");
@@ -56,6 +57,14 @@ const aiEndpoints = {
 	getAIStats: {
 		method: "GET",
 		path: "/stats"
+	},
+	getAICredits: {
+		method: "GET",
+		path: "/credits"
+	},
+	getAICreditUsage: {
+		method: "GET",
+		path: "/credits/usage"
 	}
 };
 const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
@@ -135,7 +144,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((0, _intlayer_backend_contract_defineRoute.buildRouteURL)(backendURL, aiGroup, aiEndpoints.ask), {
@@ -167,24 +176,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 require_getIntlayerAPI_readServerSentEvents.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;
@@ -224,25 +220,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 require_getIntlayerAPI_readServerSentEvents.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;
@@ -264,6 +246,18 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* project.
 	*/
 	const getAIStats = async (otherOptions = {}) => await require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.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 require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.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 require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.buildRouteURL)(backendURL, aiGroup, aiEndpoints.getAICreditUsage), authAPIOptions, otherOptions, {
+		method: aiEndpoints.getAICreditUsage.method,
+		params
+	});
 	return {
 		customQuery,
 		translateJSON,
@@ -275,7 +269,9 @@ const getAiAPI = (authAPIOptions = {}, intlayerConfig) => {
 		chat,
 		autocomplete,
 		getDiscussions,
-		getAIStats
+		getAIStats,
+		getAICredits,
+		getAICreditUsage
 	};
 };
 /**

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

@@ -1 +1 @@
-{"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":";;;;;;;;;AA8DA,MAAM,UAAU,EACd,QAAQ,UACV;;;;;AAMA,MAAM,cAAc;CAClB,aAAa;EAAE,QAAQ;EAAQ,MAAM;CAAI;CACzC,eAAe;EAAE,QAAQ;EAAQ,MAAM;CAAkB;CACzD,yBAAyB;EAAE,QAAQ;EAAQ,MAAM;CAAoB;CACrE,8BAA8B;EAC5B,QAAQ;EACR,MAAM;CACR;CACA,iCAAiC;EAC/B,QAAQ;EACR,MAAM;CACR;CACA,UAAU;EAAE,QAAQ;EAAQ,MAAM;CAAa;CAC/C,KAAK;EAAE,QAAQ;EAAQ,MAAM;CAAO;CACpC,MAAM;EAAE,QAAQ;EAAQ,MAAM;CAAQ;CACtC,cAAc;EAAE,QAAQ;EAAQ,MAAM;CAAgB;CACtD,gBAAgB;EAAE,QAAQ;EAAO,MAAM;CAAe;CACtD,YAAY;EAAE,QAAQ;EAAO,MAAM;CAAS;AAC9C;AAEA,MAAa,YACX,iBAAiC,CAAC,GAClC,mBACG;CACH,MAAM,aACJ,gBAAgB,QAAQ,cAAcA,8BAAO,cAAcC;;;;;;CAO7D,MAAM,cAAc,OAClB,MACA,eAA+B,CAAC,MAEhC,MAAMC,4BACJC,sDAAc,YAAY,SAAS,YAAY,WAAW,GAC1D,gBACA,cACA;EACE,QAAQ,YAAY,YAAY;EAC1B;CACR,CACF;;;;;;CAOF,MAAM,gBAAgB,OACpB,MACA,eAA+B,CAAC,MAEhC,MAAMD,4BACJC,sDAAc,YAAY,SAAS,YAAY,aAAa,GAC5D,gBACA,cACA;EACE,QAAQ,YAAY,cAAc;EAC5B;CACR,CACF;;;;;;CAOF,MAAM,0BAA0B,OAC9B,MACA,eAA+B,CAAC,MAEhC,MAAMD,4BACJC,sDAAc,YAAY,SAAS,YAAY,uBAAuB,GACtE,gBACA,cACA;EACE,QAAQ,YAAY,wBAAwB;EACtC;CACR,CACF;;;;;;CAOF,MAAM,+BAA+B,OACnC,MACA,eAA+B,CAAC,MAEhC,MAAMD,4BACJC,sDACE,YACA,SACA,YAAY,4BACd,GACA,gBACA,cACA;EACE,QAAQ,YAAY,6BAA6B;EAC3C;CACR,CACF;;;;;;CAOF,MAAM,kCAAkC,OACtC,MACA,eAA+B,CAAC,MAEhC,MAAMD,4BACJC,sDACE,YACA,SACA,YAAY,+BACd,GACA,gBACA,cACA;EACE,QAAQ,YAAY,gCAAgC;EAC9C;CACR,CACF;;;;;;CAOF,MAAM,WAAW,OACf,MACA,eAA+B,CAAC,MAEhC,MAAMD,4BACJC,sDAAc,YAAY,SAAS,YAAY,QAAQ,GACvD,gBACA,cACA;EACE,QAAQ,YAAY,SAAS;EACvB;CACR,CACF;;;;;;;;;;;;;;;;;;;;CAqBF,MAAM,iBAAiB,OACrB,MACA,eAA+B,CAAC,MAC7B;EACH,IAAI,CAAC,MAAM;EAEX,MAAM,EAAE,WAAW,QAAQ,GAAG,SAAS;EACvC,MAAM,kBAAkB,IAAI,gBAAgB;EAE5C,IAAI;GACF,MAAM,WAAW,MAAM,UACrBA,sDAAc,YAAY,SAAS,YAAY,GAAG,GAClD;IACE,QAAQ,YAAY,IAAI;IACxB,SAAS;KACP,gBAAgB;KAChB,GAAG,eAAe;KAClB,GAAG,aAAa;IAClB;IACA,MAAM,KAAK,UAAU;KACnB,GAAG;KACH,GAAG,eAAe;KAClB,GAAG,aAAa;IAClB,CAAC;IACD,QAAQ,gBAAgB;IACxB,aAAa;GACf,CACF;GAEA,IAAI,CAAC,SAAS,IAAI;IAGhB,IAAI,eAAuB;IAE3B,IAAI;KAEF,MAAM,YAAY,MAAM,SAAS,KAAK;KACtC,MAAM,WAAW,UAAU,SAAS;KACpC,eAAe,KAAK,UAAU,QAAQ,KAAK;IAC7C,QAAQ;KAEN,IAAI;MACF,MAAM,YAAY,MAAM,SAAS,KAAK;MACtC,IAAI,WACF,eAAe;KAEnB,QAAQ,CAER;IACF;IAEA,MAAM,IAAI,MAAM,YAAY;GAC9B;GAEA,MAAM,SAAS,SAAS,MAAM,UAAU;GACxC,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,qBAAqB;GAGvC,MAAM,UAAU,IAAI,YAAY;GAChC,IAAI,SAAS;GAEb,OAAO,MAAM;IACX,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,KAAK;IAC1C,IAAI,MAAM;IAEV,UAAU,QAAQ,OAAO,OAAO,EAAE,QAAQ,KAAK,CAAC;IAChD,MAAM,QAAQ,OAAO,MAAM,IAAI;IAC/B,SAAS,MAAM,IAAI,KAAK;IAExB,KAAK,MAAM,QAAQ,OACjB,IAAI,KAAK,WAAW,QAAQ,GAC1B,IAAI;KACF,MAAM,OAAO,KAAK,MAAM,KAAK,MAAM,CAAC,CAAC;KACrC,IAAI,KAAK,OACP,YAAY,KAAK,KAAK;KAExB,IAAI,KAAK,QAAQ,KAAK,UACpB,SAAS,KAAK,QAAQ;IAE1B,SAAS,GAAG;KACV,QAAQ,MAAM,6BAA6B,CAAC;IAC9C;GAGN;EACF,SAAS,OAAO;GACd,QAAQ,MAAM,4BAA4B,KAAK;GAC/C,MAAM;EACR;CACF;CAEA,MAAM,OAAO,OAAO,MAAiB,eAA+B,CAAC,MAAM;EACzE,IAAI,CAAC,MAAM;EAEX,MAAM,EAAE,WAAW,QAAQ,UAAU,GAAG,SAAS;EACjD,MAAM,kBAAkB,IAAI,gBAAgB;EAE5C,IAAI;GACF,MAAM,WAAW,MAAM,UACrBA,sDAAc,YAAY,SAAS,YAAY,IAAI,GACnD;IACE,QAAQ,YAAY,KAAK;IACzB,SAAS;KACP,gBAAgB;KAChB,GAAG,eAAe;KAClB,GAAG,aAAa;IAClB;IACA,MAAM,KAAK,UAAU;KACnB,GAAG;KACH,GAAG,eAAe;KAClB,GAAG,aAAa;IAClB,CAAC;IACD,QAAQ,gBAAgB;IACxB,aAAa;GACf,CACF;GAEA,IAAI,CAAC,SAAS,IAAI;IAChB,IAAI,eAAuB;IAE3B,IAAI;KACF,MAAM,YAAY,MAAM,SAAS,KAAK;KACtC,MAAM,WAAW,UAAU,SAAS;KACpC,eAAe,KAAK,UAAU,QAAQ,KAAK;IAC7C,QAAQ;KACN,IAAI;MACF,MAAM,YAAY,MAAM,SAAS,KAAK;MACtC,IAAI,WACF,eAAe;KAEnB,QAAQ,CAER;IACF;IAEA,MAAM,IAAI,MAAM,YAAY;GAC9B;GAEA,MAAM,SAAS,SAAS,MAAM,UAAU;GACxC,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,qBAAqB;GAGvC,MAAM,UAAU,IAAI,YAAY;GAChC,IAAI,SAAS;GAEb,OAAO,MAAM;IACX,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,KAAK;IAC1C,IAAI,MAAM;IAEV,UAAU,QAAQ,OAAO,OAAO,EAAE,QAAQ,KAAK,CAAC;IAChD,MAAM,QAAQ,OAAO,MAAM,IAAI;IAC/B,SAAS,MAAM,IAAI,KAAK;IAExB,KAAK,MAAM,QAAQ,OACjB,IAAI,KAAK,WAAW,QAAQ,GAC1B,IAAI;KACF,MAAM,OAAO,KAAK,MAAM,KAAK,MAAM,CAAC,CAAC;KACrC,IAAI,KAAK,OACP,YAAY,KAAK,KAAK;KAExB,IAAI,KAAK,QACP,WAAW,KAAK,MAAM;KAExB,IAAI,KAAK,QAAQ,KAAK,UACpB,SAAS,KAAK,QAAQ;IAE1B,SAAS,GAAG;KACV,QAAQ,MAAM,6BAA6B,CAAC;IAC9C;GAGN;EACF,SAAS,OAAO;GACd,QAAQ,MAAM,kBAAkB,KAAK;GACrC,MAAM;EACR;CACF;CAEA,MAAM,eAAe,OACnB,MACA,eAA+B,CAAC,MAEhC,MAAMD,4BACJC,sDAAc,YAAY,SAAS,YAAY,YAAY,GAC3D,gBACA,cACA;EACE,QAAQ,YAAY,aAAa;EAC3B;CACR,CACF;;;;CAKF,MAAM,iBAAiB,OACrB,QACA,eAA+B,CAAC,MAEhC,MAAMD,4BACJC,sDAAc,YAAY,SAAS,YAAY,cAAc,GAC7D,gBACA,cACA;EACE,QAAQ,YAAY,eAAe;EAEnC;CACF,CACF;;;;;CAMF,MAAM,aAAa,OAAO,eAA+B,CAAC,MACxD,MAAMD,4BACJC,sDAAc,YAAY,SAAS,YAAY,UAAU,GACzD,gBACA,cACA,EACE,QAAQ,YAAY,WAAW,OACjC,CACF;CAEF,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF;;;;;;;AAQA,MAAa,aAAaC,6CAAe,QAAQ"}
+{"version":3,"file":"ai.cjs","names":["editor","BACKEND_URL","fetcher","buildRouteURL","readServerSentEvents","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  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/cjs/getIntlayerAPI/analytics.cjs

@@ -25,6 +25,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"
@@ -78,6 +86,25 @@ const getAnalyticsAPI = (authAPIOptions = {}, intlayerConfig) => {
 	*/
 	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 });
 	/**
+	* 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 require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.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 require_fetcher.fetcher((0, _intlayer_backend_contract_defineRoute.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.
@@ -90,6 +117,8 @@ const getAnalyticsAPI = (authAPIOptions = {}, intlayerConfig) => {
 		sendEvents,
 		getOverview,
 		getAudience,
+		getLiveVisitorFlow,
+		getPageFlow,
 		getContentStats,
 		getExperimentResults,
 		getPageMetadata

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

@@ -1 +1 @@
-{"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"}
+{"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  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,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;;;;;;;CAQF,MAAM,cAAc,OAClB,OACA,UACA,eAA+B,CAAC,MAEhC,MAAMD,4BACJC,sDAAc,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,MAAMD,4BACJC,sDACE,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,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;EACA;EACA;CACF;AACF;;;;;;;AAQA,MAAa,oBAAoBC,6CAAe,eAAe"}

package/dist/cjs/getIntlayerAPI/readServerSentEvents.cjs

@@ -0,0 +1,70 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+// src/getIntlayerAPI/readServerSentEvents.ts
+/**
+* Error raised when the server emits an `event: error` frame mid-stream.
+* `message` is the serialized payload, matching the `fetcher` convention so
+* callers can match backend error codes with `error.message.includes(code)`.
+*/
+var ServerSentEventError = class extends Error {
+	payload;
+	constructor(payload) {
+		super(JSON.stringify(payload));
+		this.name = "ServerSentEventError";
+		this.payload = payload;
+	}
+};
+/**
+* Reads a `text/event-stream` response and calls `onData` with each parsed
+* `data:` payload of the default event type.
+*
+* Throws a {@link ServerSentEventError} as soon as an `event: error` frame is
+* received, so stream failures reject the caller instead of resolving silently.
+*/
+const readServerSentEvents = async (response, onData) => {
+	const reader = response.body?.getReader();
+	if (!reader) throw new Error("No reader available");
+	const decoder = new TextDecoder();
+	let buffer = "";
+	let currentEventName = "message";
+	const handleLine = (line) => {
+		if (line === "") {
+			currentEventName = "message";
+			return;
+		}
+		if (line.startsWith("event:")) {
+			currentEventName = line.slice(6).trim();
+			return;
+		}
+		if (!line.startsWith("data:")) return;
+		const rawData = line.slice(5).trimStart();
+		let parsedData;
+		try {
+			parsedData = JSON.parse(rawData);
+		} catch {
+			if (currentEventName === "error") throw new ServerSentEventError({ message: rawData });
+			console.error("Failed to parse SSE data:", rawData);
+			return;
+		}
+		if (currentEventName === "error") throw new ServerSentEventError(parsedData);
+		onData(parsedData);
+	};
+	try {
+		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) handleLine(line.replace(/\r$/, ""));
+		}
+		buffer += decoder.decode();
+		if (buffer !== "") handleLine(buffer.replace(/\r$/, ""));
+	} catch (error) {
+		await reader.cancel().catch(() => void 0);
+		throw error;
+	}
+};
+
+exports.ServerSentEventError = ServerSentEventError;
+exports.readServerSentEvents = readServerSentEvents;
+//# sourceMappingURL=readServerSentEvents.cjs.map

package/dist/cjs/getIntlayerAPI/readServerSentEvents.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"readServerSentEvents.cjs","names":[],"sources":["../../../src/getIntlayerAPI/readServerSentEvents.ts"],"sourcesContent":["/**\n * Error raised when the server emits an `event: error` frame mid-stream.\n * `message` is the serialized payload, matching the `fetcher` convention so\n * callers can match backend error codes with `error.message.includes(code)`.\n */\nexport class ServerSentEventError<\n  Payload = Record<string, unknown>,\n> extends Error {\n  readonly payload: Payload;\n\n  constructor(payload: Payload) {\n    super(JSON.stringify(payload));\n    this.name = 'ServerSentEventError';\n    this.payload = payload;\n  }\n}\n\n/**\n * Reads a `text/event-stream` response and calls `onData` with each parsed\n * `data:` payload of the default event type.\n *\n * Throws a {@link ServerSentEventError} as soon as an `event: error` frame is\n * received, so stream failures reject the caller instead of resolving silently.\n */\nexport const readServerSentEvents = async <Data>(\n  response: Response,\n  onData: (data: Data) => void\n): Promise<void> => {\n  const reader = response.body?.getReader();\n\n  if (!reader) {\n    throw new Error('No reader available');\n  }\n\n  const decoder = new TextDecoder();\n  let buffer = '';\n  let currentEventName = 'message';\n\n  const handleLine = (line: string): void => {\n    // A blank line terminates the current event: reset its type\n    if (line === '') {\n      currentEventName = 'message';\n      return;\n    }\n\n    if (line.startsWith('event:')) {\n      currentEventName = line.slice('event:'.length).trim();\n      return;\n    }\n\n    if (!line.startsWith('data:')) return;\n\n    const rawData = line.slice('data:'.length).trimStart();\n\n    let parsedData: unknown;\n\n    try {\n      parsedData = JSON.parse(rawData);\n    } catch {\n      if (currentEventName === 'error') {\n        throw new ServerSentEventError({ message: rawData });\n      }\n\n      console.error('Failed to parse SSE data:', rawData);\n      return;\n    }\n\n    if (currentEventName === 'error') {\n      throw new ServerSentEventError(parsedData);\n    }\n\n    onData(parsedData as Data);\n  };\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n\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        handleLine(line.replace(/\\r$/, ''));\n      }\n    }\n\n    buffer += decoder.decode();\n\n    if (buffer !== '') {\n      handleLine(buffer.replace(/\\r$/, ''));\n    }\n  } catch (error) {\n    await reader.cancel().catch(() => undefined);\n    throw error;\n  }\n};\n"],"mappings":";;;;;;;AAKA,IAAa,uBAAb,cAEU,MAAM;CACd,AAAS;CAET,YAAY,SAAkB;EAC5B,MAAM,KAAK,UAAU,OAAO,CAAC;EAC7B,KAAK,OAAO;EACZ,KAAK,UAAU;CACjB;AACF;;;;;;;;AASA,MAAa,uBAAuB,OAClC,UACA,WACkB;CAClB,MAAM,SAAS,SAAS,MAAM,UAAU;CAExC,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,qBAAqB;CAGvC,MAAM,UAAU,IAAI,YAAY;CAChC,IAAI,SAAS;CACb,IAAI,mBAAmB;CAEvB,MAAM,cAAc,SAAuB;EAEzC,IAAI,SAAS,IAAI;GACf,mBAAmB;GACnB;EACF;EAEA,IAAI,KAAK,WAAW,QAAQ,GAAG;GAC7B,mBAAmB,KAAK,MAAM,CAAe,CAAC,CAAC,KAAK;GACpD;EACF;EAEA,IAAI,CAAC,KAAK,WAAW,OAAO,GAAG;EAE/B,MAAM,UAAU,KAAK,MAAM,CAAc,CAAC,CAAC,UAAU;EAErD,IAAI;EAEJ,IAAI;GACF,aAAa,KAAK,MAAM,OAAO;EACjC,QAAQ;GACN,IAAI,qBAAqB,SACvB,MAAM,IAAI,qBAAqB,EAAE,SAAS,QAAQ,CAAC;GAGrD,QAAQ,MAAM,6BAA6B,OAAO;GAClD;EACF;EAEA,IAAI,qBAAqB,SACvB,MAAM,IAAI,qBAAqB,UAAU;EAG3C,OAAO,UAAkB;CAC3B;CAEA,IAAI;EACF,OAAO,MAAM;GACX,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,KAAK;GAE1C,IAAI,MAAM;GAEV,UAAU,QAAQ,OAAO,OAAO,EAAE,QAAQ,KAAK,CAAC;GAChD,MAAM,QAAQ,OAAO,MAAM,IAAI;GAC/B,SAAS,MAAM,IAAI,KAAK;GAExB,KAAK,MAAM,QAAQ,OACjB,WAAW,KAAK,QAAQ,OAAO,EAAE,CAAC;EAEtC;EAEA,UAAU,QAAQ,OAAO;EAEzB,IAAI,WAAW,IACb,WAAW,OAAO,QAAQ,OAAO,EAAE,CAAC;CAExC,SAAS,OAAO;EACd,MAAM,OAAO,OAAO,CAAC,CAAC,YAAY,MAAS;EAC3C,MAAM;CACR;AACF"}

package/dist/esm/getIntlayerAPI/ai.mjs

@@ -1,5 +1,6 @@
 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";
@@ -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
 	};
 };
 /**

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

@@ -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

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/readServerSentEvents.mjs

@@ -0,0 +1,68 @@
+// src/getIntlayerAPI/readServerSentEvents.ts
+/**
+* Error raised when the server emits an `event: error` frame mid-stream.
+* `message` is the serialized payload, matching the `fetcher` convention so
+* callers can match backend error codes with `error.message.includes(code)`.
+*/
+var ServerSentEventError = class extends Error {
+	payload;
+	constructor(payload) {
+		super(JSON.stringify(payload));
+		this.name = "ServerSentEventError";
+		this.payload = payload;
+	}
+};
+/**
+* Reads a `text/event-stream` response and calls `onData` with each parsed
+* `data:` payload of the default event type.
+*
+* Throws a {@link ServerSentEventError} as soon as an `event: error` frame is
+* received, so stream failures reject the caller instead of resolving silently.
+*/
+const readServerSentEvents = async (response, onData) => {
+	const reader = response.body?.getReader();
+	if (!reader) throw new Error("No reader available");
+	const decoder = new TextDecoder();
+	let buffer = "";
+	let currentEventName = "message";
+	const handleLine = (line) => {
+		if (line === "") {
+			currentEventName = "message";
+			return;
+		}
+		if (line.startsWith("event:")) {
+			currentEventName = line.slice(6).trim();
+			return;
+		}
+		if (!line.startsWith("data:")) return;
+		const rawData = line.slice(5).trimStart();
+		let parsedData;
+		try {
+			parsedData = JSON.parse(rawData);
+		} catch {
+			if (currentEventName === "error") throw new ServerSentEventError({ message: rawData });
+			console.error("Failed to parse SSE data:", rawData);
+			return;
+		}
+		if (currentEventName === "error") throw new ServerSentEventError(parsedData);
+		onData(parsedData);
+	};
+	try {
+		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) handleLine(line.replace(/\r$/, ""));
+		}
+		buffer += decoder.decode();
+		if (buffer !== "") handleLine(buffer.replace(/\r$/, ""));
+	} catch (error) {
+		await reader.cancel().catch(() => void 0);
+		throw error;
+	}
+};
+
+export { ServerSentEventError, readServerSentEvents };
+//# sourceMappingURL=readServerSentEvents.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readServerSentEvents.mjs","names":[],"sources":["../../../src/getIntlayerAPI/readServerSentEvents.ts"],"sourcesContent":["/**\n * Error raised when the server emits an `event: error` frame mid-stream.\n * `message` is the serialized payload, matching the `fetcher` convention so\n * callers can match backend error codes with `error.message.includes(code)`.\n */\nexport class ServerSentEventError<\n  Payload = Record<string, unknown>,\n> extends Error {\n  readonly payload: Payload;\n\n  constructor(payload: Payload) {\n    super(JSON.stringify(payload));\n    this.name = 'ServerSentEventError';\n    this.payload = payload;\n  }\n}\n\n/**\n * Reads a `text/event-stream` response and calls `onData` with each parsed\n * `data:` payload of the default event type.\n *\n * Throws a {@link ServerSentEventError} as soon as an `event: error` frame is\n * received, so stream failures reject the caller instead of resolving silently.\n */\nexport const readServerSentEvents = async <Data>(\n  response: Response,\n  onData: (data: Data) => void\n): Promise<void> => {\n  const reader = response.body?.getReader();\n\n  if (!reader) {\n    throw new Error('No reader available');\n  }\n\n  const decoder = new TextDecoder();\n  let buffer = '';\n  let currentEventName = 'message';\n\n  const handleLine = (line: string): void => {\n    // A blank line terminates the current event: reset its type\n    if (line === '') {\n      currentEventName = 'message';\n      return;\n    }\n\n    if (line.startsWith('event:')) {\n      currentEventName = line.slice('event:'.length).trim();\n      return;\n    }\n\n    if (!line.startsWith('data:')) return;\n\n    const rawData = line.slice('data:'.length).trimStart();\n\n    let parsedData: unknown;\n\n    try {\n      parsedData = JSON.parse(rawData);\n    } catch {\n      if (currentEventName === 'error') {\n        throw new ServerSentEventError({ message: rawData });\n      }\n\n      console.error('Failed to parse SSE data:', rawData);\n      return;\n    }\n\n    if (currentEventName === 'error') {\n      throw new ServerSentEventError(parsedData);\n    }\n\n    onData(parsedData as Data);\n  };\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n\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        handleLine(line.replace(/\\r$/, ''));\n      }\n    }\n\n    buffer += decoder.decode();\n\n    if (buffer !== '') {\n      handleLine(buffer.replace(/\\r$/, ''));\n    }\n  } catch (error) {\n    await reader.cancel().catch(() => undefined);\n    throw error;\n  }\n};\n"],"mappings":";;;;;;AAKA,IAAa,uBAAb,cAEU,MAAM;CACd,AAAS;CAET,YAAY,SAAkB;EAC5B,MAAM,KAAK,UAAU,OAAO,CAAC;EAC7B,KAAK,OAAO;EACZ,KAAK,UAAU;CACjB;AACF;;;;;;;;AASA,MAAa,uBAAuB,OAClC,UACA,WACkB;CAClB,MAAM,SAAS,SAAS,MAAM,UAAU;CAExC,IAAI,CAAC,QACH,MAAM,IAAI,MAAM,qBAAqB;CAGvC,MAAM,UAAU,IAAI,YAAY;CAChC,IAAI,SAAS;CACb,IAAI,mBAAmB;CAEvB,MAAM,cAAc,SAAuB;EAEzC,IAAI,SAAS,IAAI;GACf,mBAAmB;GACnB;EACF;EAEA,IAAI,KAAK,WAAW,QAAQ,GAAG;GAC7B,mBAAmB,KAAK,MAAM,CAAe,CAAC,CAAC,KAAK;GACpD;EACF;EAEA,IAAI,CAAC,KAAK,WAAW,OAAO,GAAG;EAE/B,MAAM,UAAU,KAAK,MAAM,CAAc,CAAC,CAAC,UAAU;EAErD,IAAI;EAEJ,IAAI;GACF,aAAa,KAAK,MAAM,OAAO;EACjC,QAAQ;GACN,IAAI,qBAAqB,SACvB,MAAM,IAAI,qBAAqB,EAAE,SAAS,QAAQ,CAAC;GAGrD,QAAQ,MAAM,6BAA6B,OAAO;GAClD;EACF;EAEA,IAAI,qBAAqB,SACvB,MAAM,IAAI,qBAAqB,UAAU;EAG3C,OAAO,UAAkB;CAC3B;CAEA,IAAI;EACF,OAAO,MAAM;GACX,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,KAAK;GAE1C,IAAI,MAAM;GAEV,UAAU,QAAQ,OAAO,OAAO,EAAE,QAAQ,KAAK,CAAC;GAChD,MAAM,QAAQ,OAAO,MAAM,IAAI;GAC/B,SAAS,MAAM,IAAI,KAAK;GAExB,KAAK,MAAM,QAAQ,OACjB,WAAW,KAAK,QAAQ,OAAO,EAAE,CAAC;EAEtC;EAEA,UAAU,QAAQ,OAAO;EAEzB,IAAI,WAAW,IACb,WAAW,OAAO,QAAQ,OAAO,EAAE,CAAC;CAExC,SAAS,OAAO;EACd,MAAM,OAAO,OAAO,CAAC,CAAC,YAAY,MAAS;EAC3C,MAAM;CACR;AACF"}

package/dist/types/distantDictionary/fetchDistantDictionaries.d.ts

@@ -1,5 +1,5 @@
-import { IntlayerConfig } from "@intlayer/types/config";
 import { DictionaryAPI } from "@intlayer/backend-contract/dictionary";
+import { IntlayerConfig } from "@intlayer/types/config";
 /**
  * Fetch distant dictionary
  */

package/dist/types/distantDictionary/fetchDistantDictionary.d.ts

@@ -1,5 +1,5 @@
-import { IntlayerConfig } from "@intlayer/types/config";
 import { DictionaryAPI } from "@intlayer/backend-contract/dictionary";
+import { IntlayerConfig } from "@intlayer/types/config";
 /**
  * Fetch distant dictionary
  */

package/dist/types/getIntlayerAPI/ai.d.ts

@@ -1,8 +1,8 @@
 import "../index.js";
 import { CMSEndpoint } from "../cms/createIntlayerCMS.js";
 import { FetcherOptions } from "../fetcher.js";
+import { AIOptions, AskDocQuestionResult, AuditContentDeclarationBody, AuditContentDeclarationFieldBody, AuditContentDeclarationFieldResult, AuditContentDeclarationMetadataBody, AuditContentDeclarationMetadataResult, AuditContentDeclarationResult, AuditTagBody, AuditTagResult, AutocompleteResponse, ChatCompletionRequestMessage, ChatResult, CustomQueryBody, CustomQueryResult, GetAICreditUsageParams, GetAICreditUsageResult, GetAICreditsResult, GetAIStatsResult, GetDiscussionsParams, GetDiscussionsResult, TranslateJSONBody, TranslateJSONResult } from "@intlayer/backend-contract/ai";
 import { IntlayerConfig } from "@intlayer/types/config";
-import { AIOptions, AskDocQuestionResult, AuditContentDeclarationBody, AuditContentDeclarationFieldBody, AuditContentDeclarationFieldResult, AuditContentDeclarationMetadataBody, AuditContentDeclarationMetadataResult, AuditContentDeclarationResult, AuditTagBody, AuditTagResult, AutocompleteResponse, ChatCompletionRequestMessage, ChatResult, CustomQueryBody, CustomQueryResult, GetAIStatsResult, GetDiscussionsParams, GetDiscussionsResult, TranslateJSONBody, TranslateJSONResult } from "@intlayer/backend-contract/ai";
 export type AutocompleteBody = {
   text: string;
   aiOptions?: AIOptions;
@@ -14,6 +14,8 @@ export type AskDocQuestionBody = {
   messages: ChatCompletionRequestMessage[];
   discussionId: string;
   onMessage?: (chunk: string) => void;
+  /** Receives the summarized reasoning of the model as it streams. */
+  onReasoning?: (chunk: string) => void;
   onDone?: (response: AskDocQuestionResult) => void;
 };
 export type ClientAction = {
@@ -41,6 +43,8 @@ export declare const getAiAPI: (authAPIOptions?: FetcherOptions, intlayerConfig?
   autocomplete: (body?: AutocompleteBody, otherOptions?: FetcherOptions) => Promise<AutocompleteResponse>;
   getDiscussions: (params?: GetDiscussionsParams, otherOptions?: FetcherOptions) => Promise<GetDiscussionsResult>;
   getAIStats: (otherOptions?: FetcherOptions) => Promise<GetAIStatsResult>;
+  getAICredits: (otherOptions?: FetcherOptions) => Promise<GetAICreditsResult>;
+  getAICreditUsage: (params?: GetAICreditUsageParams, otherOptions?: FetcherOptions) => Promise<GetAICreditUsageResult>;
 };
 /**
  * Authenticated `ai` endpoint bound to an Intlayer CMS authenticator.
@@ -60,6 +64,8 @@ export declare const aiEndpoint: CMSEndpoint<{
   autocomplete: (body?: AutocompleteBody, otherOptions?: FetcherOptions) => Promise<AutocompleteResponse>;
   getDiscussions: (params?: GetDiscussionsParams, otherOptions?: FetcherOptions) => Promise<GetDiscussionsResult>;
   getAIStats: (otherOptions?: FetcherOptions) => Promise<GetAIStatsResult>;
+  getAICredits: (otherOptions?: FetcherOptions) => Promise<GetAICreditsResult>;
+  getAICreditUsage: (params?: GetAICreditUsageParams, otherOptions?: FetcherOptions) => Promise<GetAICreditUsageResult>;
 }>;
 export type { AskDocQuestionResult, ChatResult };
 //# sourceMappingURL=ai.d.ts.map

package/dist/types/getIntlayerAPI/ai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai.d.ts","names":["_$__0.CMSEndpoint"],"sources":["../../../src/getIntlayerAPI/ai.ts"],"mappings":";;;;;YAgCY;EACV;EACA,YAAY;EACZ;EACA;EACA;;YAGU;EACV,UAAU;EACV;EACA,aAAa;EACb,UAAU,UAAU;;YAGV;EACN;EAAkB;;EAClB;;YAEM;EACV,UAAU;EACV;EACA,aAAa;EACb,UAAU,UAAU;EACpB,YAAY,QAAQ;;qBAkCT,WAAQ,iBACH,gBAAc,iBACb;EAWR,cAAA,OAAA,iBAAe,eACR,mBAAc,QAAA;EAkBrB,gBAAA,OAAA,mBAAiB,eACV,mBAAc,QAAA;EAkBrB,0BAAA,OAAA,6BAA2B,eACpB,mBAAc,QAAA;EAkBrB,+BAAA,OAAA,kCAAgC,eACzB,mBAAc,QAAA;EAsBrB,kCAAA,OAAA,qCAAmC,eAC5B,mBAAc,QAAA;EAsBrB,WAAA,OAAA,cAAY,eACL,mBAAc,QAAA;EAgCrB,iBAAA,OAAA,oBAAkB,eACX,mBAAc;EA0FH,OAAA,OAAA,UAAQ,eAAgB,mBAAc;EAyFxD,eAAA,OAAA,kBAAgB,eACT,mBAAc,QAAA;EAgBnB,iBAAA,SAAA,sBAAoB,eACf,mBAAc,QAAA;EAiBU,aAAA,eAAA,mBAAc,QAAA;;;;;;;;qBA+B3C,YA/B2CA;EA/V7C,cAAA,OAAA,iBAAe,eACR,mBAAc,QAAA;EAkBrB,gBAAA,OAAA,mBAAiB,eACV,mBAAc,QAAA;EAkBrB,0BAAA,OAAA,6BAA2B,eACpB,mBAAc,QAAA;EAkBrB,+BAAA,OAAA,kCAAgC,eACzB,mBAAc,QAAA;EAsBrB,kCAAA,OAAA,qCAAmC,eAC5B,mBAAc,QAAA;EAsBrB,WAAA,OAAA,cAAY,eACL,mBAAc,QAAA;EAgCrB,iBAAA,OAAA,oBAAkB,eACX,mBAAc;EA0FH,OAAA,OAAA,UAAQ,eAAgB,mBAAc;EAyFxD,eAAA,OAAA,kBAAgB,eACT,mBAAc,QAAA;EAgBnB,iBAAA,SAAA,sBAAoB,eACf,mBAAc,QAAA;EAiBU,aAAA,eAAA,mBAAc,QAAA"}
+{"version":3,"file":"ai.d.ts","names":["_$__0.CMSEndpoint"],"sources":["../../../src/getIntlayerAPI/ai.ts"],"mappings":";;;;;YAoCY;EACV;EACA,YAAY;EACZ;EACA;EACA;;YAGU;EACV,UAAU;EACV;EACA,aAAa;;EAEb,eAAe;EACf,UAAU,UAAU;;YAGV;EACN;EAAkB;;EAClB;;YAEM;EACV,UAAU;EACV;EACA,aAAa;EACb,UAAU,UAAU;EACpB,YAAY,QAAQ;;qBAoDT,WAAQ,iBACH,gBAAc,iBACb;EAWR,cAAA,OAAA,iBAAe,eACR,mBAAc,QAAA;EAkBrB,gBAAA,OAAA,mBAAiB,eACV,mBAAc,QAAA;EAkBrB,0BAAA,OAAA,6BAA2B,eACpB,mBAAc,QAAA;EAkBrB,+BAAA,OAAA,kCAAgC,eACzB,mBAAc,QAAA;EAsBrB,kCAAA,OAAA,qCAAmC,eAC5B,mBAAc,QAAA;EAsBrB,WAAA,OAAA,cAAY,eACL,mBAAc,QAAA;EAgCrB,iBAAA,OAAA,oBAAkB,eACX,mBAAc;EAqEH,OAAA,OAAA,UAAQ,eAAgB,mBAAc;EAiExD,eAAA,OAAA,kBAAgB,eACT,mBAAc,QAAA;EAgBnB,iBAAA,SAAA,sBAAoB,eACf,mBAAc,QAAA;EAiBU,aAAA,eAAA,mBAAc,QAAA;EAcZ,eAAA,eAAA,mBAAc,QAAA;EAc7C,mBAAA,SAAA,wBAAsB,eACjB,mBAAc,QAAA;;;;;;;;qBAmCnB,YAnCmBA;EA/UrB,cAAA,OAAA,iBAAe,eACR,mBAAc,QAAA;EAkBrB,gBAAA,OAAA,mBAAiB,eACV,mBAAc,QAAA;EAkBrB,0BAAA,OAAA,6BAA2B,eACpB,mBAAc,QAAA;EAkBrB,+BAAA,OAAA,kCAAgC,eACzB,mBAAc,QAAA;EAsBrB,kCAAA,OAAA,qCAAmC,eAC5B,mBAAc,QAAA;EAsBrB,WAAA,OAAA,cAAY,eACL,mBAAc,QAAA;EAgCrB,iBAAA,OAAA,oBAAkB,eACX,mBAAc;EAqEH,OAAA,OAAA,UAAQ,eAAgB,mBAAc;EAiExD,eAAA,OAAA,kBAAgB,eACT,mBAAc,QAAA;EAgBnB,iBAAA,SAAA,sBAAoB,eACf,mBAAc,QAAA;EAiBU,aAAA,eAAA,mBAAc,QAAA;EAcZ,eAAA,eAAA,mBAAc,QAAA;EAc7C,mBAAA,SAAA,wBAAsB,eACjB,mBAAc,QAAA"}

package/dist/types/getIntlayerAPI/analytics.d.ts

@@ -2,11 +2,13 @@ import "../index.js";
 import { CMSEndpoint } from "../cms/createIntlayerCMS.js";
 import { FetcherOptions } from "../fetcher.js";
 import { IntlayerConfig } from "@intlayer/types/config";
-import { AudienceRange, GetAnalyticsOverviewResult, GetAudienceResult, GetContentStatsResult, GetExperimentResultsResult, GetPageMetadataResult, IngestAnalyticsBody, IngestAnalyticsResult } from "@intlayer/backend-contract/analytics";
+import { AudienceRange, GetAnalyticsOverviewResult, GetAudienceResult, GetContentStatsResult, GetExperimentResultsResult, GetLiveVisitorFlowResult, GetPageFlowResult, GetPageMetadataResult, IngestAnalyticsBody, IngestAnalyticsResult } from "@intlayer/backend-contract/analytics";
 export declare const getAnalyticsAPI: (authAPIOptions?: FetcherOptions, intlayerConfig?: IntlayerConfig) => {
   sendEvents: (body: IngestAnalyticsBody, otherOptions?: FetcherOptions) => Promise<IngestAnalyticsResult>;
   getOverview: (otherOptions?: FetcherOptions) => Promise<GetAnalyticsOverviewResult>;
   getAudience: (range?: AudienceRange | number, otherOptions?: FetcherOptions) => Promise<GetAudienceResult>;
+  getLiveVisitorFlow: (visitorId: string, otherOptions?: FetcherOptions) => Promise<GetLiveVisitorFlowResult>;
+  getPageFlow: (range: AudienceRange, startUrl: string, otherOptions?: FetcherOptions) => Promise<GetPageFlowResult>;
   getContentStats: (otherOptions?: FetcherOptions) => Promise<GetContentStatsResult>;
   getExperimentResults: (experimentKey: string, otherOptions?: FetcherOptions) => Promise<GetExperimentResultsResult>;
   getPageMetadata: (url: string, otherOptions?: FetcherOptions) => Promise<GetPageMetadataResult>;
@@ -21,6 +23,8 @@ export declare const analyticsEndpoint: CMSEndpoint<{
   sendEvents: (body: IngestAnalyticsBody, otherOptions?: FetcherOptions) => Promise<IngestAnalyticsResult>;
   getOverview: (otherOptions?: FetcherOptions) => Promise<GetAnalyticsOverviewResult>;
   getAudience: (range?: AudienceRange | number, otherOptions?: FetcherOptions) => Promise<GetAudienceResult>;
+  getLiveVisitorFlow: (visitorId: string, otherOptions?: FetcherOptions) => Promise<GetLiveVisitorFlowResult>;
+  getPageFlow: (range: AudienceRange, startUrl: string, otherOptions?: FetcherOptions) => Promise<GetPageFlowResult>;
   getContentStats: (otherOptions?: FetcherOptions) => Promise<GetContentStatsResult>;
   getExperimentResults: (experimentKey: string, otherOptions?: FetcherOptions) => Promise<GetExperimentResultsResult>;
   getPageMetadata: (url: string, otherOptions?: FetcherOptions) => Promise<GetPageMetadataResult>;

package/dist/types/getIntlayerAPI/analytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.d.ts","names":["_$__0.CMSEndpoint"],"sources":["../../../src/getIntlayerAPI/analytics.ts"],"mappings":";;;;;qBAsCa,kBAAe,iBACV,gBAAc,iBACb;EAYT,aAAA,MAAA,qBAAmB,eACX,mBAAc,QAAA;EAoBW,cAAA,eAAA,mBAAc,QAAA;EAoB9C,cAAA,QAAA,wBAAsB,eACf,mBAAc,QAAA;EAoBe,kBAAA,eAAA,mBAAc,QAAA;EAkB1C,uBAAA,uBAAM,eACP,mBAAc,QAAA;EAoBvB,kBAAA,aAAM,eACG,mBAAc,QAAA;;;;;;;;qBAgCnB,mBAhCmBA;EAtGtB,aAAA,MAAA,qBAAmB,eACX,mBAAc,QAAA;EAoBW,cAAA,eAAA,mBAAc,QAAA;EAoB9C,cAAA,QAAA,wBAAsB,eACf,mBAAc,QAAA;EAoBe,kBAAA,eAAA,mBAAc,QAAA;EAkB1C,uBAAA,uBAAM,eACP,mBAAc,QAAA;EAoBvB,kBAAA,aAAM,eACG,mBAAc,QAAA"}
+{"version":3,"file":"analytics.d.ts","names":["_$__0.CMSEndpoint"],"sources":["../../../src/getIntlayerAPI/analytics.ts"],"mappings":";;;;;qBA6Ca,kBAAe,iBACV,gBAAc,iBACb;EAYT,aAAA,MAAA,qBAAmB,eACX,mBAAc,QAAA;EAoBW,cAAA,eAAA,mBAAc,QAAA;EAoB9C,cAAA,QAAA,wBAAsB,eACf,mBAAc,QAAA;EAgFjB,qBAAA,mBAAM,eACH,mBAAc,QAAA;EArBrB,cAAA,OAAA,eAAa,kBACJ,eACF,mBAAc,QAAA;EA1Ce,kBAAA,eAAA,mBAAc,QAAA;EAkB1C,uBAAA,uBAAM,eACP,mBAAc,QAAA;EA8DvB,kBAAA,aAAM,eACG,mBAAc,QAAA;;;;;;;;qBAkCnB,mBAlCmBA;EAhJtB,aAAA,MAAA,qBAAmB,eACX,mBAAc,QAAA;EAoBW,cAAA,eAAA,mBAAc,QAAA;EAoB9C,cAAA,QAAA,wBAAsB,eACf,mBAAc,QAAA;EAgFjB,qBAAA,mBAAM,eACH,mBAAc,QAAA;EArBrB,cAAA,OAAA,eAAa,kBACJ,eACF,mBAAc,QAAA;EA1Ce,kBAAA,eAAA,mBAAc,QAAA;EAkB1C,uBAAA,uBAAM,eACP,mBAAc,QAAA;EA8DvB,kBAAA,aAAM,eACG,mBAAc,QAAA"}

package/dist/types/getIntlayerAPI/codeberg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codeberg.d.ts","names":["_$__0.FetcherOptions","_$__0.CMSEndpoint"],"sources":["../../../src/getIntlayerAPI/codeberg.ts"],"mappings":";;;;qBAUa,iBAAc,iBAAdA,gBAAc,kDAAA;E,wDAAAA,mB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAQd,kB;E,wDAAAA,mB"}
+{"version":3,"file":"codeberg.d.ts","names":["_$__0.FetcherOptions"],"sources":["../../../src/getIntlayerAPI/codeberg.ts"],"mappings":";;;;qBAUa,iBAAc,iBAAdA,gBAAc,kDAAA;E,wDAAAA,mB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAQd,kB;E,wDAAAA,mB"}

package/dist/types/getIntlayerAPI/dictionary.d.ts

@@ -1,8 +1,8 @@
 import "../index.js";
 import { CMSEndpoint } from "../cms/createIntlayerCMS.js";
 import { FetcherOptions } from "../fetcher.js";
-import { IntlayerConfig } from "@intlayer/types/config";
 import { AddDictionaryBody, AddDictionaryResult, DeleteDictionaryParam, DeleteDictionaryResult, GetDictionariesByKeysResult, GetDictionariesKeysResult, GetDictionariesParams, GetDictionariesResult, GetDictionariesUpdateTimestampResult, GetDictionaryParams, GetDictionaryQuery, GetDictionaryResult, PushDictionariesBody, PushDictionariesResult, UpdateDictionaryBody, UpdateDictionaryResult } from "@intlayer/backend-contract/dictionary";
+import { IntlayerConfig } from "@intlayer/types/config";
 export declare const getDictionaryAPI: (authAPIOptions?: FetcherOptions, intlayerConfig?: IntlayerConfig) => {
   getDictionaries: (filters?: GetDictionariesParams, otherOptions?: FetcherOptions) => Promise<GetDictionariesResult>;
   getDictionariesKeys: (otherOptions?: FetcherOptions) => Promise<GetDictionariesKeysResult>;

package/dist/types/getIntlayerAPI/gitee.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gitee.d.ts","names":["_$__0.FetcherOptions","_$__0.CMSEndpoint"],"sources":["../../../src/getIntlayerAPI/gitee.ts"],"mappings":";;;;qBAUa,cAAW,iBAAXA,gBAAW,kDAAA;E,wDAAAA,mB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAQX,e;E,wDAAAA,mB"}
+{"version":3,"file":"gitee.d.ts","names":["_$__0.FetcherOptions"],"sources":["../../../src/getIntlayerAPI/gitee.ts"],"mappings":";;;;qBAUa,cAAW,iBAAXA,gBAAW,kDAAA;E,wDAAAA,mB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAQX,e;E,wDAAAA,mB"}

package/dist/types/getIntlayerAPI/project.d.ts

@@ -1,8 +1,8 @@
 import "../index.js";
 import { CMSEndpoint } from "../cms/createIntlayerCMS.js";
 import { FetcherOptions } from "../fetcher.js";
-import { IntlayerConfig } from "@intlayer/types/config";
 import { AddNewAccessKeyBody, AddNewAccessKeyResponse, AddProjectBody, AddProjectResult, DeleteAccessKeyBody, DeleteAccessKeyResponse, DeleteProjectResult, GetProjectInsightsResult, GetProjectsParams, GetProjectsResult, PushProjectConfigurationBody, PushProjectConfigurationResult, RefreshAccessKeyBody, RefreshAccessKeyResponse, SelectProjectParam, SelectProjectResult, TriggerBuildResult, TriggerWebhookBody, TriggerWebhookResult, UnselectProjectResult, UpdateMemberAccessBody, UpdateMemberAccessResult, UpdateProjectBody, UpdateProjectMembersBody, UpdateProjectMembersResult, UpdateProjectResult } from "@intlayer/backend-contract/project";
+import { IntlayerConfig } from "@intlayer/types/config";
 import { ResponseData } from "@intlayer/backend-contract/responseData";
 export declare const getProjectAPI: (authAPIOptions?: FetcherOptions, intlayerConfig?: IntlayerConfig) => {
   getProjects: (filters?: GetProjectsParams, otherOptions?: FetcherOptions) => Promise<GetProjectsResult>;

package/dist/types/getIntlayerAPI/readServerSentEvents.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Error raised when the server emits an `event: error` frame mid-stream.
+ * `message` is the serialized payload, matching the `fetcher` convention so
+ * callers can match backend error codes with `error.message.includes(code)`.
+ */
+export declare class ServerSentEventError<Payload = Record<string, unknown>> extends Error {
+  readonly payload: Payload;
+  constructor(payload: Payload);
+}
+/**
+ * Reads a `text/event-stream` response and calls `onData` with each parsed
+ * `data:` payload of the default event type.
+ *
+ * Throws a {@link ServerSentEventError} as soon as an `event: error` frame is
+ * received, so stream failures reject the caller instead of resolving silently.
+ */
+export declare const readServerSentEvents: <Data>(response: Response, onData: (data: Data) => void) => Promise<void>;
+//# sourceMappingURL=readServerSentEvents.d.ts.map

package/dist/types/getIntlayerAPI/readServerSentEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readServerSentEvents.d.ts","names":[],"sources":["../../../src/getIntlayerAPI/readServerSentEvents.ts"],"mappings":";;;;;qBAKa,qBACX,UAAU,iCACF;WACC,SAAS;EAElB,YAAY,SAAS;;;;;;;;;qBAcV,uBAA8B,MAAI,UACnC,UAAQ,SACT,MAAM,kBACd"}

package/dist/types/index.d.ts

@@ -1,11 +1,11 @@
 import "./cms/index.js";
+import "./distantDictionary/index.js";
+import { FetcherError, FetcherOptions, fetcher, fetcherOptions } from "./fetcher.js";
 import { AuthManager, AuthManagerOptions, BindSectionOptions, clearAccessTokenCache, createAuthManager } from "./cms/createAuthManager.js";
 import { CMSEndpoint, IntlayerCMS, IntlayerCMSOptions, createEndpoint, createIntlayerCMS } from "./cms/createIntlayerCMS.js";
-import "./distantDictionary/index.js";
+import { IntlayerAPI, getIntlayerAPI } from "./getIntlayerAPI/index.js";
 import { fetchDistantDictionaries } from "./distantDictionary/fetchDistantDictionaries.js";
 import { fetchDistantDictionary } from "./distantDictionary/fetchDistantDictionary.js";
-import { FetcherError, FetcherOptions, fetcher, fetcherOptions } from "./fetcher.js";
-import { IntlayerAPI, getIntlayerAPI } from "./getIntlayerAPI/index.js";
 import { AskDocQuestionBody, AskDocQuestionResult, AutocompleteBody, ChatBody, ChatResult, ClientAction, aiEndpoint, getAiAPI } from "./getIntlayerAPI/ai.js";
 import { analyticsEndpoint, getAnalyticsAPI } from "./getIntlayerAPI/analytics.js";
 import { assetEndpoint, getAssetAPI } from "./getIntlayerAPI/asset.js";

package/dist/types/public/createPublicClient.d.ts

@@ -1,5 +1,5 @@
-import { IntlayerConfig } from "@intlayer/types/config";
 import { DictionaryAPI } from "@intlayer/backend-contract/dictionary";
+import { IntlayerConfig } from "@intlayer/types/config";
 /** Options accepted by {@link createPublicClient}. */
 export type PublicClientOptions = {
   /** Overrides the build-time `editor` configuration. */

package/dist/types/types.d.ts

@@ -1,5 +1,5 @@
-import { DictionaryAPI } from "@intlayer/backend-contract/dictionary";
-import { EnvironmentAPI, ProjectAPI } from "@intlayer/backend-contract/project";
 import { AIOptions } from "@intlayer/backend-contract/ai";
+import { DictionaryAPI } from "@intlayer/backend-contract/dictionary";
 import { MessageEventData } from "@intlayer/backend-contract/eventListener";
+import { EnvironmentAPI, ProjectAPI } from "@intlayer/backend-contract/project";
 export type { AIOptions, DictionaryAPI, EnvironmentAPI, MessageEventData, ProjectAPI };

package/package.json

@@ -1,24 +1,20 @@
 {
   "name": "@intlayer/api",
-  "version": "9.7.1",
+  "version": "9.7.2",
   "private": false,
   "description": "SDK for interacting with the Intlayer API, enabling content auditing, and managing organizations, projects, and users.",
   "keywords": [
-    "intlayer",
-    "application",
     "api",
+    "application",
     "backend",
     "i18n",
-    "internationalization"
+    "internationalization",
+    "intlayer"
   ],
   "homepage": "https://intlayer.org",
   "bugs": {
     "url": "https://github.com/aymericzip/intlayer/issues"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/aymericzip/intlayer.git"
-  },
   "license": "Apache-2.0",
   "author": {
     "name": "Aymeric PINEAU",
@@ -31,7 +27,103 @@
       "url": "https://github.com/aymericzip"
     }
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aymericzip/intlayer.git"
+  },
+  "files": [
+    "./dist",
+    "./package.json"
+  ],
   "sideEffects": false,
+  "main": "dist/cjs/index.cjs",
+  "module": "dist/esm/index.mjs",
+  "types": "dist/types/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "ai": [
+        "./dist/types/getIntlayerAPI/ai.d.ts"
+      ],
+      "analytics": [
+        "./dist/types/getIntlayerAPI/analytics.d.ts"
+      ],
+      "public": [
+        "./dist/types/public/index.d.ts"
+      ],
+      "audit": [
+        "./dist/types/getIntlayerAPI/audit.d.ts"
+      ],
+      "bitbucket": [
+        "./dist/types/getIntlayerAPI/bitbucket.d.ts"
+      ],
+      "gitee": [
+        "./dist/types/getIntlayerAPI/gitee.d.ts"
+      ],
+      "codeberg": [
+        "./dist/types/getIntlayerAPI/codeberg.d.ts"
+      ],
+      "asset": [
+        "./dist/types/getIntlayerAPI/asset.d.ts"
+      ],
+      "cms": [
+        "./dist/types/cms/index.d.ts"
+      ],
+      "dictionary": [
+        "./dist/types/getIntlayerAPI/dictionary.d.ts"
+      ],
+      "editor": [
+        "./dist/types/getIntlayerAPI/editor.d.ts"
+      ],
+      "github": [
+        "./dist/types/getIntlayerAPI/github.d.ts"
+      ],
+      "gitlab": [
+        "./dist/types/getIntlayerAPI/gitlab.d.ts"
+      ],
+      "newsletter": [
+        "./dist/types/getIntlayerAPI/newsletter.d.ts"
+      ],
+      "oAuth": [
+        "./dist/types/getIntlayerAPI/oAuth.d.ts"
+      ],
+      "environment": [
+        "./dist/types/getIntlayerAPI/environment.d.ts"
+      ],
+      "organization": [
+        "./dist/types/getIntlayerAPI/organization.d.ts"
+      ],
+      "project": [
+        "./dist/types/getIntlayerAPI/project.d.ts"
+      ],
+      "search": [
+        "./dist/types/getIntlayerAPI/search.d.ts"
+      ],
+      "showcaseProject": [
+        "./dist/types/getIntlayerAPI/showcaseProject.d.ts"
+      ],
+      "status": [
+        "./dist/types/getIntlayerAPI/status.d.ts"
+      ],
+      "stripe": [
+        "./dist/types/getIntlayerAPI/stripe.d.ts"
+      ],
+      "tag": [
+        "./dist/types/getIntlayerAPI/tag.d.ts"
+      ],
+      "translate": [
+        "./dist/types/getIntlayerAPI/translate.d.ts"
+      ],
+      "reviewer": [
+        "./dist/types/getIntlayerAPI/reviewer.d.ts"
+      ],
+      "user": [
+        "./dist/types/getIntlayerAPI/user.d.ts"
+      ],
+      "package.json": [
+        "./package.json"
+      ]
+    }
+  },
   "exports": {
     ".": {
       "types": "./dist/types/index.d.ts",
@@ -170,107 +262,15 @@
     },
     "./package.json": "./package.json"
   },
-  "main": "dist/cjs/index.cjs",
-  "module": "dist/esm/index.mjs",
-  "types": "dist/types/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "ai": [
-        "./dist/types/getIntlayerAPI/ai.d.ts"
-      ],
-      "analytics": [
-        "./dist/types/getIntlayerAPI/analytics.d.ts"
-      ],
-      "public": [
-        "./dist/types/public/index.d.ts"
-      ],
-      "audit": [
-        "./dist/types/getIntlayerAPI/audit.d.ts"
-      ],
-      "bitbucket": [
-        "./dist/types/getIntlayerAPI/bitbucket.d.ts"
-      ],
-      "gitee": [
-        "./dist/types/getIntlayerAPI/gitee.d.ts"
-      ],
-      "codeberg": [
-        "./dist/types/getIntlayerAPI/codeberg.d.ts"
-      ],
-      "asset": [
-        "./dist/types/getIntlayerAPI/asset.d.ts"
-      ],
-      "cms": [
-        "./dist/types/cms/index.d.ts"
-      ],
-      "dictionary": [
-        "./dist/types/getIntlayerAPI/dictionary.d.ts"
-      ],
-      "editor": [
-        "./dist/types/getIntlayerAPI/editor.d.ts"
-      ],
-      "github": [
-        "./dist/types/getIntlayerAPI/github.d.ts"
-      ],
-      "gitlab": [
-        "./dist/types/getIntlayerAPI/gitlab.d.ts"
-      ],
-      "newsletter": [
-        "./dist/types/getIntlayerAPI/newsletter.d.ts"
-      ],
-      "oAuth": [
-        "./dist/types/getIntlayerAPI/oAuth.d.ts"
-      ],
-      "environment": [
-        "./dist/types/getIntlayerAPI/environment.d.ts"
-      ],
-      "organization": [
-        "./dist/types/getIntlayerAPI/organization.d.ts"
-      ],
-      "project": [
-        "./dist/types/getIntlayerAPI/project.d.ts"
-      ],
-      "search": [
-        "./dist/types/getIntlayerAPI/search.d.ts"
-      ],
-      "showcaseProject": [
-        "./dist/types/getIntlayerAPI/showcaseProject.d.ts"
-      ],
-      "status": [
-        "./dist/types/getIntlayerAPI/status.d.ts"
-      ],
-      "stripe": [
-        "./dist/types/getIntlayerAPI/stripe.d.ts"
-      ],
-      "tag": [
-        "./dist/types/getIntlayerAPI/tag.d.ts"
-      ],
-      "translate": [
-        "./dist/types/getIntlayerAPI/translate.d.ts"
-      ],
-      "reviewer": [
-        "./dist/types/getIntlayerAPI/reviewer.d.ts"
-      ],
-      "user": [
-        "./dist/types/getIntlayerAPI/user.d.ts"
-      ],
-      "package.json": [
-        "./package.json"
-      ]
-    }
-  },
-  "files": [
-    "./dist",
-    "./package.json"
-  ],
   "scripts": {
     "build": "bun --bun tsdown --config tsdown.config.ts",
     "build:ci": "bun --bun tsdown --config tsdown.config.ts",
     "clean": "bun --bun rimraf ./dist .turbo",
     "dev": "bun --bun tsdown --config tsdown.config.ts --watch",
-    "format": "bun --bun biome format . --check",
-    "format:fix": "bun --bun biome format --write .",
-    "lint": "bun --bun biome lint .",
-    "lint:fix": "bun --bun biome lint --write .",
+    "format": "oxfmt --check .",
+    "format:fix": "oxfmt .",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
     "prepublish": "cp -f ../../../README.md ./README.md",
     "publish": "bun publish || true",
     "publish:canary": "bun publish --access public --tag canary || true",
@@ -281,9 +281,9 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/backend-contract": "9.7.1",
-    "@intlayer/config": "9.7.1",
-    "@intlayer/types": "9.7.1",
+    "@intlayer/backend-contract": "9.7.2",
+    "@intlayer/config": "9.7.2",
+    "@intlayer/types": "9.7.2",
     "defu": "6.1.7"
   },
   "devDependencies": {
@@ -291,8 +291,8 @@
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",
-    "rimraf": "6.1.3",
-    "tsdown": "0.23.4",
+    "rimraf": "6.1.4",
+    "tsdown": "0.23.7",
     "typescript": "7.0.2",
     "vitest": "5.1.0"
   },