@intlayer/api 9.6.0 → 9.7.0

package/dist/esm/getIntlayerAPI/audit.mjs

@@ -1,10 +1,64 @@
 import { fetcher } from "../fetcher.mjs";
 import { createEndpoint } from "../cms/createIntlayerCMS.mjs";
 import { editor } from "@intlayer/config/built";
+import { buildRouteURL } from "@intlayer/backend-contract/defineRoute";
+import { BACKEND_URL } from "@intlayer/config/defaultValues";
 
 //#region src/getIntlayerAPI/audit.ts
+/** Prefix of the routes, checked against the backend contract. */
+const scanGroup = { prefix: "/api/scan" };
+/**
+* Method and path of every route, checked against the backend contract at
+* compile time (the contract's zod schemas are never loaded).
+*/
+const scanEndpoints = {
+	scan: {
+		method: "GET",
+		path: "/"
+	},
+	getTechnologyUsage: {
+		method: "GET",
+		path: "/technologies"
+	},
+	getScannedHosts: {
+		method: "GET",
+		path: "/hosts"
+	},
+	getScannedHost: {
+		method: "GET",
+		path: "/hosts/:host"
+	},
+	reportHostDetection: {
+		method: "POST",
+		path: "/hosts/detections"
+	},
+	discoverUrls: {
+		method: "GET",
+		path: "/recursive/discover"
+	},
+	startRecursive: {
+		method: "POST",
+		path: "/recursive/start"
+	},
+	getRecursiveStatus: {
+		method: "GET",
+		path: "/recursive/:jobId"
+	},
+	cancelRecursive: {
+		method: "POST",
+		path: "/recursive/:jobId/cancel"
+	},
+	pauseRecursive: {
+		method: "POST",
+		path: "/recursive/:jobId/pause"
+	},
+	resumeRecursive: {
+		method: "POST",
+		path: "/recursive/:jobId/resume"
+	}
+};
 const getAuditAPI = (authAPIOptions = {}, intlayerConfig) => {
-	const AUDIT_API_ROUTE = `${intlayerConfig?.editor?.backendURL ?? editor.backendURL}/api/scan`;
+	const backendURL = intlayerConfig?.editor?.backendURL ?? editor.backendURL ?? BACKEND_URL;
 	/**
 	* Streams a single-page SEO audit as Server-Sent Events.
 	*
@@ -17,8 +71,8 @@ const getAuditAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* });
 	* ```
 	*/
-	const discoverUrls = async (params, otherOptions = {}) => await fetcher(`${AUDIT_API_ROUTE}/recursive/discover`, authAPIOptions, otherOptions, {
-		method: "GET",
+	const discoverUrls = async (params, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, scanGroup, scanEndpoints.discoverUrls), authAPIOptions, otherOptions, {
+		method: scanEndpoints.discoverUrls.method,
 		params
 	});
 	const scanUrl = async (body, otherOptions = {}) => {
@@ -26,9 +80,9 @@ const getAuditAPI = (authAPIOptions = {}, intlayerConfig) => {
 		const { url, refresh, onMessage, onDone } = body;
 		const params = new URLSearchParams({ url });
 		if (refresh) params.set("refresh", "true");
-		const endpoint = `${AUDIT_API_ROUTE}?${params.toString()}`;
+		const endpoint = `${buildRouteURL(backendURL, scanGroup, scanEndpoints.scan)}?${params.toString()}`;
 		const response = await fetch(endpoint, {
-			method: "GET",
+			method: scanEndpoints.scan.method,
 			headers: {
 				Accept: "text/event-stream",
 				...authAPIOptions.headers,
@@ -70,37 +124,37 @@ const getAuditAPI = (authAPIOptions = {}, intlayerConfig) => {
 	/**
 	* Starts a recursive audit job for the given URL.
 	*/
-	const startRecursiveAudit = async (body, otherOptions = {}) => await fetcher(`${AUDIT_API_ROUTE}/recursive/start`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const startRecursiveAudit = async (body, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, scanGroup, scanEndpoints.startRecursive), authAPIOptions, otherOptions, {
+		method: scanEndpoints.startRecursive.method,
 		params: body?.url ? { url: body.url } : void 0,
 		body: body?.urls !== void 0 ? { urls: body.urls } : void 0
 	});
 	/**
 	* Gets the status of a recursive audit job.
 	*/
-	const getRecursiveAuditStatus = async (params, otherOptions = {}) => await fetcher(`${AUDIT_API_ROUTE}/recursive/${params?.jobId}`, authAPIOptions, otherOptions, { method: "GET" });
-	const cancelRecursiveAudit = async (params, otherOptions = {}) => await fetcher(`${AUDIT_API_ROUTE}/recursive/${params?.jobId}/cancel`, authAPIOptions, otherOptions, { method: "POST" });
-	const pauseRecursiveAudit = async (params, otherOptions = {}) => await fetcher(`${AUDIT_API_ROUTE}/recursive/${params?.jobId}/pause`, authAPIOptions, otherOptions, { method: "POST" });
-	const resumeRecursiveAudit = async (params, otherOptions = {}) => await fetcher(`${AUDIT_API_ROUTE}/recursive/${params?.jobId}/resume`, authAPIOptions, otherOptions, { method: "POST" });
+	const getRecursiveAuditStatus = async (params, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, scanGroup, scanEndpoints.getRecursiveStatus, { jobId: String(params?.jobId) }), authAPIOptions, otherOptions, { method: scanEndpoints.getRecursiveStatus.method });
+	const cancelRecursiveAudit = async (params, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, scanGroup, scanEndpoints.cancelRecursive, { jobId: String(params?.jobId) }), authAPIOptions, otherOptions, { method: scanEndpoints.cancelRecursive.method });
+	const pauseRecursiveAudit = async (params, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, scanGroup, scanEndpoints.pauseRecursive, { jobId: String(params?.jobId) }), authAPIOptions, otherOptions, { method: scanEndpoints.pauseRecursive.method });
+	const resumeRecursiveAudit = async (params, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, scanGroup, scanEndpoints.resumeRecursive, { jobId: String(params?.jobId) }), authAPIOptions, otherOptions, { method: scanEndpoints.resumeRecursive.method });
 	/**
 	* Admin — number of scanned domains using each technology.
 	*/
-	const getTechnologyUsage = async (params, otherOptions = {}) => await fetcher(`${AUDIT_API_ROUTE}/technologies`, authAPIOptions, otherOptions, {
-		method: "GET",
+	const getTechnologyUsage = async (params, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, scanGroup, scanEndpoints.getTechnologyUsage), authAPIOptions, otherOptions, {
+		method: scanEndpoints.getTechnologyUsage.method,
 		params
 	});
 	/**
 	* Admin — scanned hosts, most recently scanned first, filterable by
 	* technology.
 	*/
-	const getScannedHosts = async (params, otherOptions = {}) => await fetcher(`${AUDIT_API_ROUTE}/hosts`, authAPIOptions, otherOptions, {
-		method: "GET",
+	const getScannedHosts = async (params, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, scanGroup, scanEndpoints.getScannedHosts), authAPIOptions, otherOptions, {
+		method: scanEndpoints.getScannedHosts.method,
 		params
 	});
 	/**
 	* Admin — a scanned host with its stored scans, newest first.
 	*/
-	const getScannedHost = async (params, otherOptions = {}) => await fetcher(`${AUDIT_API_ROUTE}/hosts/${encodeURIComponent(params?.host ?? "")}`, authAPIOptions, otherOptions, { method: "GET" });
+	const getScannedHost = async (params, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, scanGroup, scanEndpoints.getScannedHost, { host: params?.host ?? "" }), authAPIOptions, otherOptions, { method: scanEndpoints.getScannedHost.method });
 	return {
 		getTechnologyUsage,
 		getScannedHosts,

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

@@ -1 +1 @@
-{"version":3,"file":"audit.mjs","names":[],"sources":["../../../src/getIntlayerAPI/audit.ts"],"sourcesContent":["import type {\n  AuditEvent,\n  GetRecursiveAuditStatusResult,\n  GetScannedHostParams,\n  GetScannedHostResult,\n  GetScannedHostsQuery,\n  GetScannedHostsResult,\n  GetTechnologyUsageQuery,\n  GetTechnologyUsageResult,\n  StartRecursiveAuditResult,\n} from '@intlayer/backend';\nimport { editor } from '@intlayer/config/built';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { createEndpoint } from '../cms/createIntlayerCMS';\nimport { type FetcherOptions, fetcher } from '../fetcher';\n\nexport type {\n  AuditEvent,\n  GetRecursiveAuditStatusResult,\n  GetScannedHostParams,\n  GetScannedHostResult,\n  GetScannedHostsQuery,\n  GetScannedHostsResult,\n  GetTechnologyUsageQuery,\n  GetTechnologyUsageResult,\n  StartRecursiveAuditResult,\n};\n\nexport type ScanUrlBody = {\n  url: string;\n  /**\n   * Force a new audit. Without it, a URL audited less than an hour ago is\n   * replayed from cache (its first event carries `cachedAt`).\n   */\n  refresh?: boolean;\n  onMessage?: (event: AuditEvent) => void;\n  onDone?: () => void;\n};\n\nexport type DiscoverUrlsParams = {\n  url: string;\n};\n\nexport type DiscoverUrlsResult = {\n  urls: string[];\n};\n\nexport type StartRecursiveAuditBody = {\n  url: string;\n  urls?: string[];\n};\n\nexport type GetRecursiveAuditStatusParams = {\n  jobId: string;\n};\n\nexport type RecursiveAuditJobParams = {\n  jobId: string;\n};\n\nexport const getAuditAPI = (\n  authAPIOptions: FetcherOptions = {},\n  intlayerConfig?: IntlayerConfig\n) => {\n  const backendURL = intlayerConfig?.editor?.backendURL ?? editor.backendURL;\n\n  const AUDIT_API_ROUTE = `${backendURL}/api/scan`;\n\n  /**\n   * Streams a single-page SEO audit as Server-Sent Events.\n   *\n   * Usage:\n   * ```ts\n   * await audit.scanUrl({\n   *   url: 'https://example.com',\n   *   onMessage: (event) => console.log(event),\n   *   onDone: () => console.log('done'),\n   * });\n   * ```\n   */\n  const discoverUrls = async (\n    params?: DiscoverUrlsParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<DiscoverUrlsResult>(\n      `${AUDIT_API_ROUTE}/recursive/discover`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'GET',\n        params,\n      }\n    );\n\n  const scanUrl = async (\n    body?: ScanUrlBody,\n    otherOptions: FetcherOptions = {}\n  ) => {\n    if (!body?.url) return;\n\n    const { url, refresh, onMessage, onDone } = body;\n\n    const params = new URLSearchParams({ url });\n    if (refresh) params.set('refresh', 'true');\n    const endpoint = `${AUDIT_API_ROUTE}?${params.toString()}`;\n\n    const response = await fetch(endpoint, {\n      method: 'GET',\n      headers: {\n        Accept: 'text/event-stream',\n        ...authAPIOptions.headers,\n        ...otherOptions.headers,\n      },\n      credentials: 'include',\n      signal: otherOptions.signal,\n    });\n\n    if (!response.ok) {\n      let errorMessage = 'An error occurred';\n      try {\n        const errorData = await response.json();\n        errorMessage = JSON.stringify(errorData.error) ?? errorMessage;\n      } catch {\n        try {\n          const errorText = await response.text();\n          if (errorText) errorMessage = errorText;\n        } catch {\n          // ignore\n        }\n      }\n      throw new Error(errorMessage);\n    }\n\n    const reader = response.body?.getReader();\n    if (!reader) throw new Error('No reader available');\n\n    const decoder = new TextDecoder();\n    let buffer = '';\n\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        if (line.startsWith('data: ')) {\n          try {\n            const event = JSON.parse(line.slice(6)) as AuditEvent;\n            onMessage?.(event);\n          } catch {\n            // ignore malformed lines\n          }\n        }\n      }\n    }\n\n    onDone?.();\n  };\n\n  /**\n   * Starts a recursive audit job for the given URL.\n   */\n  const startRecursiveAudit = async (\n    body?: StartRecursiveAuditBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<StartRecursiveAuditResult>(\n      `${AUDIT_API_ROUTE}/recursive/start`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'POST',\n        params: body?.url ? { url: body.url } : undefined,\n        body: body?.urls !== undefined ? { urls: body.urls as any } : undefined,\n      }\n    );\n\n  /**\n   * Gets the status of a recursive audit job.\n   */\n  const getRecursiveAuditStatus = async (\n    params?: GetRecursiveAuditStatusParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetRecursiveAuditStatusResult>(\n      `${AUDIT_API_ROUTE}/recursive/${params?.jobId}`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'GET',\n      }\n    );\n\n  const cancelRecursiveAudit = async (\n    params?: RecursiveAuditJobParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<{ success: boolean }>(\n      `${AUDIT_API_ROUTE}/recursive/${params?.jobId}/cancel`,\n      authAPIOptions,\n      otherOptions,\n      { method: 'POST' }\n    );\n\n  const pauseRecursiveAudit = async (\n    params?: RecursiveAuditJobParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<{ success: boolean }>(\n      `${AUDIT_API_ROUTE}/recursive/${params?.jobId}/pause`,\n      authAPIOptions,\n      otherOptions,\n      { method: 'POST' }\n    );\n\n  const resumeRecursiveAudit = async (\n    params?: RecursiveAuditJobParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<{ success: boolean }>(\n      `${AUDIT_API_ROUTE}/recursive/${params?.jobId}/resume`,\n      authAPIOptions,\n      otherOptions,\n      { method: 'POST' }\n    );\n\n  /**\n   * Admin — number of scanned domains using each technology.\n   */\n  const getTechnologyUsage = async (\n    params?: GetTechnologyUsageQuery,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetTechnologyUsageResult>(\n      `${AUDIT_API_ROUTE}/technologies`,\n      authAPIOptions,\n      otherOptions,\n      { method: 'GET', params }\n    );\n\n  /**\n   * Admin — scanned hosts, most recently scanned first, filterable by\n   * technology.\n   */\n  const getScannedHosts = async (\n    params?: GetScannedHostsQuery,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetScannedHostsResult>(\n      `${AUDIT_API_ROUTE}/hosts`,\n      authAPIOptions,\n      otherOptions,\n      { method: 'GET', params }\n    );\n\n  /**\n   * Admin — a scanned host with its stored scans, newest first.\n   */\n  const getScannedHost = async (\n    params?: GetScannedHostParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetScannedHostResult>(\n      `${AUDIT_API_ROUTE}/hosts/${encodeURIComponent(params?.host ?? '')}`,\n      authAPIOptions,\n      otherOptions,\n      { method: 'GET' }\n    );\n\n  return {\n    getTechnologyUsage,\n    getScannedHosts,\n    getScannedHost,\n    discoverUrls,\n    scanUrl,\n    startRecursiveAudit,\n    getRecursiveAuditStatus,\n    cancelRecursiveAudit,\n    pauseRecursiveAudit,\n    resumeRecursiveAudit,\n  };\n};\n\n/**\n * Authenticated `audit` 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 auditEndpoint = createEndpoint(getAuditAPI);\n"],"mappings":";;;;;AA4DA,MAAa,eACX,iBAAiC,CAAC,GAClC,mBACG;CAGH,MAAM,kBAAkB,GAFL,gBAAgB,QAAQ,cAAc,OAAO,WAE1B;;;;;;;;;;;;;CActC,MAAM,eAAe,OACnB,QACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,gBAAgB,sBACnB,gBACA,cACA;EACE,QAAQ;EACR;CACF,CACF;CAEF,MAAM,UAAU,OACd,MACA,eAA+B,CAAC,MAC7B;EACH,IAAI,CAAC,MAAM,KAAK;EAEhB,MAAM,EAAE,KAAK,SAAS,WAAW,WAAW;EAE5C,MAAM,SAAS,IAAI,gBAAgB,EAAE,IAAI,CAAC;EAC1C,IAAI,SAAS,OAAO,IAAI,WAAW,MAAM;EACzC,MAAM,WAAW,GAAG,gBAAgB,GAAG,OAAO,SAAS;EAEvD,MAAM,WAAW,MAAM,MAAM,UAAU;GACrC,QAAQ;GACR,SAAS;IACP,QAAQ;IACR,GAAG,eAAe;IAClB,GAAG,aAAa;GAClB;GACA,aAAa;GACb,QAAQ,aAAa;EACvB,CAAC;EAED,IAAI,CAAC,SAAS,IAAI;GAChB,IAAI,eAAe;GACnB,IAAI;IACF,MAAM,YAAY,MAAM,SAAS,KAAK;IACtC,eAAe,KAAK,UAAU,UAAU,KAAK,KAAK;GACpD,QAAQ;IACN,IAAI;KACF,MAAM,YAAY,MAAM,SAAS,KAAK;KACtC,IAAI,WAAW,eAAe;IAChC,QAAQ,CAER;GACF;GACA,MAAM,IAAI,MAAM,YAAY;EAC9B;EAEA,MAAM,SAAS,SAAS,MAAM,UAAU;EACxC,IAAI,CAAC,QAAQ,MAAM,IAAI,MAAM,qBAAqB;EAElD,MAAM,UAAU,IAAI,YAAY;EAChC,IAAI,SAAS;EAEb,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,IAAI,KAAK,WAAW,QAAQ,GAC1B,IAAI;IACF,MAAM,QAAQ,KAAK,MAAM,KAAK,MAAM,CAAC,CAAC;IACtC,YAAY,KAAK;GACnB,QAAQ,CAER;EAGN;EAEA,SAAS;CACX;;;;CAKA,MAAM,sBAAsB,OAC1B,MACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,gBAAgB,mBACnB,gBACA,cACA;EACE,QAAQ;EACR,QAAQ,MAAM,MAAM,EAAE,KAAK,KAAK,IAAI,IAAI;EACxC,MAAM,MAAM,SAAS,SAAY,EAAE,MAAM,KAAK,KAAY,IAAI;CAChE,CACF;;;;CAKF,MAAM,0BAA0B,OAC9B,QACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,gBAAgB,aAAa,QAAQ,SACxC,gBACA,cACA,EACE,QAAQ,MACV,CACF;CAEF,MAAM,uBAAuB,OAC3B,QACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,gBAAgB,aAAa,QAAQ,MAAM,UAC9C,gBACA,cACA,EAAE,QAAQ,OAAO,CACnB;CAEF,MAAM,sBAAsB,OAC1B,QACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,gBAAgB,aAAa,QAAQ,MAAM,SAC9C,gBACA,cACA,EAAE,QAAQ,OAAO,CACnB;CAEF,MAAM,uBAAuB,OAC3B,QACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,gBAAgB,aAAa,QAAQ,MAAM,UAC9C,gBACA,cACA,EAAE,QAAQ,OAAO,CACnB;;;;CAKF,MAAM,qBAAqB,OACzB,QACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,gBAAgB,gBACnB,gBACA,cACA;EAAE,QAAQ;EAAO;CAAO,CAC1B;;;;;CAMF,MAAM,kBAAkB,OACtB,QACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,gBAAgB,SACnB,gBACA,cACA;EAAE,QAAQ;EAAO;CAAO,CAC1B;;;;CAKF,MAAM,iBAAiB,OACrB,QACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,gBAAgB,SAAS,mBAAmB,QAAQ,QAAQ,EAAE,KACjE,gBACA,cACA,EAAE,QAAQ,MAAM,CAClB;CAEF,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF;;;;;;;AAQA,MAAa,gBAAgB,eAAe,WAAW"}
+{"version":3,"file":"audit.mjs","names":[],"sources":["../../../src/getIntlayerAPI/audit.ts"],"sourcesContent":["import type { RouteEndpoints } from '@intlayer/backend-contract/defineRoute';\nimport { buildRouteURL } from '@intlayer/backend-contract/defineRoute';\nimport type {\n  AuditEvent,\n  GetRecursiveAuditStatusResult,\n  GetScannedHostParams,\n  GetScannedHostResult,\n  GetScannedHostsQuery,\n  GetScannedHostsResult,\n  GetTechnologyUsageQuery,\n  GetTechnologyUsageResult,\n  ScanRoutes,\n  StartRecursiveAuditResult,\n  scanContract,\n} from '@intlayer/backend-contract/scan';\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 {\n  AuditEvent,\n  GetRecursiveAuditStatusResult,\n  GetScannedHostParams,\n  GetScannedHostResult,\n  GetScannedHostsQuery,\n  GetScannedHostsResult,\n  GetTechnologyUsageQuery,\n  GetTechnologyUsageResult,\n  StartRecursiveAuditResult,\n};\n\nexport type ScanUrlBody = {\n  url: string;\n  /**\n   * Force a new audit. Without it, a URL audited less than an hour ago is\n   * replayed from cache (its first event carries `cachedAt`).\n   */\n  refresh?: boolean;\n  onMessage?: (event: AuditEvent) => void;\n  onDone?: () => void;\n};\n\nexport type DiscoverUrlsParams = {\n  url: string;\n};\n\nexport type DiscoverUrlsResult = {\n  urls: string[];\n};\n\nexport type StartRecursiveAuditBody = {\n  url: string;\n  urls?: string[];\n};\n\nexport type GetRecursiveAuditStatusParams = {\n  jobId: string;\n};\n\nexport type RecursiveAuditJobParams = {\n  jobId: string;\n};\n\n/** Prefix of the routes, checked against the backend contract. */\nconst scanGroup = {\n  prefix: '/api/scan',\n} as const satisfies Pick<typeof scanContract, '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 scanEndpoints = {\n  scan: { method: 'GET', path: '/' },\n  getTechnologyUsage: { method: 'GET', path: '/technologies' },\n  getScannedHosts: { method: 'GET', path: '/hosts' },\n  getScannedHost: { method: 'GET', path: '/hosts/:host' },\n  reportHostDetection: { method: 'POST', path: '/hosts/detections' },\n  discoverUrls: { method: 'GET', path: '/recursive/discover' },\n  startRecursive: { method: 'POST', path: '/recursive/start' },\n  getRecursiveStatus: { method: 'GET', path: '/recursive/:jobId' },\n  cancelRecursive: { method: 'POST', path: '/recursive/:jobId/cancel' },\n  pauseRecursive: { method: 'POST', path: '/recursive/:jobId/pause' },\n  resumeRecursive: { method: 'POST', path: '/recursive/:jobId/resume' },\n} as const satisfies RouteEndpoints<ScanRoutes>;\n\nexport const getAuditAPI = (\n  authAPIOptions: FetcherOptions = {},\n  intlayerConfig?: IntlayerConfig\n) => {\n  const backendURL =\n    intlayerConfig?.editor?.backendURL ?? editor.backendURL ?? BACKEND_URL;\n\n  /**\n   * Streams a single-page SEO audit as Server-Sent Events.\n   *\n   * Usage:\n   * ```ts\n   * await audit.scanUrl({\n   *   url: 'https://example.com',\n   *   onMessage: (event) => console.log(event),\n   *   onDone: () => console.log('done'),\n   * });\n   * ```\n   */\n  const discoverUrls = async (\n    params?: DiscoverUrlsParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<DiscoverUrlsResult>(\n      buildRouteURL(backendURL, scanGroup, scanEndpoints.discoverUrls),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: scanEndpoints.discoverUrls.method,\n        params,\n      }\n    );\n\n  const scanUrl = async (\n    body?: ScanUrlBody,\n    otherOptions: FetcherOptions = {}\n  ) => {\n    if (!body?.url) return;\n\n    const { url, refresh, onMessage, onDone } = body;\n\n    const params = new URLSearchParams({ url });\n    if (refresh) params.set('refresh', 'true');\n    const endpoint = `${buildRouteURL(backendURL, scanGroup, scanEndpoints.scan)}?${params.toString()}`;\n\n    const response = await fetch(endpoint, {\n      method: scanEndpoints.scan.method,\n      headers: {\n        Accept: 'text/event-stream',\n        ...authAPIOptions.headers,\n        ...otherOptions.headers,\n      },\n      credentials: 'include',\n      signal: otherOptions.signal,\n    });\n\n    if (!response.ok) {\n      let errorMessage = 'An error occurred';\n      try {\n        const errorData = await response.json();\n        errorMessage = JSON.stringify(errorData.error) ?? errorMessage;\n      } catch {\n        try {\n          const errorText = await response.text();\n          if (errorText) errorMessage = errorText;\n        } catch {\n          // ignore\n        }\n      }\n      throw new Error(errorMessage);\n    }\n\n    const reader = response.body?.getReader();\n    if (!reader) throw new Error('No reader available');\n\n    const decoder = new TextDecoder();\n    let buffer = '';\n\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        if (line.startsWith('data: ')) {\n          try {\n            const event = JSON.parse(line.slice(6)) as AuditEvent;\n            onMessage?.(event);\n          } catch {\n            // ignore malformed lines\n          }\n        }\n      }\n    }\n\n    onDone?.();\n  };\n\n  /**\n   * Starts a recursive audit job for the given URL.\n   */\n  const startRecursiveAudit = async (\n    body?: StartRecursiveAuditBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<StartRecursiveAuditResult>(\n      buildRouteURL(backendURL, scanGroup, scanEndpoints.startRecursive),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: scanEndpoints.startRecursive.method,\n        params: body?.url ? { url: body.url } : undefined,\n        body: body?.urls !== undefined ? { urls: body.urls as any } : undefined,\n      }\n    );\n\n  /**\n   * Gets the status of a recursive audit job.\n   */\n  const getRecursiveAuditStatus = async (\n    params?: GetRecursiveAuditStatusParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetRecursiveAuditStatusResult>(\n      buildRouteURL(backendURL, scanGroup, scanEndpoints.getRecursiveStatus, {\n        jobId: String(params?.jobId),\n      }),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: scanEndpoints.getRecursiveStatus.method,\n      }\n    );\n\n  const cancelRecursiveAudit = async (\n    params?: RecursiveAuditJobParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<{ success: boolean }>(\n      buildRouteURL(backendURL, scanGroup, scanEndpoints.cancelRecursive, {\n        jobId: String(params?.jobId),\n      }),\n      authAPIOptions,\n      otherOptions,\n      { method: scanEndpoints.cancelRecursive.method }\n    );\n\n  const pauseRecursiveAudit = async (\n    params?: RecursiveAuditJobParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<{ success: boolean }>(\n      buildRouteURL(backendURL, scanGroup, scanEndpoints.pauseRecursive, {\n        jobId: String(params?.jobId),\n      }),\n      authAPIOptions,\n      otherOptions,\n      { method: scanEndpoints.pauseRecursive.method }\n    );\n\n  const resumeRecursiveAudit = async (\n    params?: RecursiveAuditJobParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<{ success: boolean }>(\n      buildRouteURL(backendURL, scanGroup, scanEndpoints.resumeRecursive, {\n        jobId: String(params?.jobId),\n      }),\n      authAPIOptions,\n      otherOptions,\n      { method: scanEndpoints.resumeRecursive.method }\n    );\n\n  /**\n   * Admin — number of scanned domains using each technology.\n   */\n  const getTechnologyUsage = async (\n    params?: GetTechnologyUsageQuery,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetTechnologyUsageResult>(\n      buildRouteURL(backendURL, scanGroup, scanEndpoints.getTechnologyUsage),\n      authAPIOptions,\n      otherOptions,\n      { method: scanEndpoints.getTechnologyUsage.method, params }\n    );\n\n  /**\n   * Admin — scanned hosts, most recently scanned first, filterable by\n   * technology.\n   */\n  const getScannedHosts = async (\n    params?: GetScannedHostsQuery,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetScannedHostsResult>(\n      buildRouteURL(backendURL, scanGroup, scanEndpoints.getScannedHosts),\n      authAPIOptions,\n      otherOptions,\n      { method: scanEndpoints.getScannedHosts.method, params }\n    );\n\n  /**\n   * Admin — a scanned host with its stored scans, newest first.\n   */\n  const getScannedHost = async (\n    params?: GetScannedHostParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetScannedHostResult>(\n      buildRouteURL(backendURL, scanGroup, scanEndpoints.getScannedHost, {\n        host: params?.host ?? '',\n      }),\n      authAPIOptions,\n      otherOptions,\n      { method: scanEndpoints.getScannedHost.method }\n    );\n\n  return {\n    getTechnologyUsage,\n    getScannedHosts,\n    getScannedHost,\n    discoverUrls,\n    scanUrl,\n    startRecursiveAudit,\n    getRecursiveAuditStatus,\n    cancelRecursiveAudit,\n    pauseRecursiveAudit,\n    resumeRecursiveAudit,\n  };\n};\n\n/**\n * Authenticated `audit` 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 auditEndpoint = createEndpoint(getAuditAPI);\n"],"mappings":";;;;;;;;AAkEA,MAAM,YAAY,EAChB,QAAQ,YACV;;;;;AAMA,MAAM,gBAAgB;CACpB,MAAM;EAAE,QAAQ;EAAO,MAAM;CAAI;CACjC,oBAAoB;EAAE,QAAQ;EAAO,MAAM;CAAgB;CAC3D,iBAAiB;EAAE,QAAQ;EAAO,MAAM;CAAS;CACjD,gBAAgB;EAAE,QAAQ;EAAO,MAAM;CAAe;CACtD,qBAAqB;EAAE,QAAQ;EAAQ,MAAM;CAAoB;CACjE,cAAc;EAAE,QAAQ;EAAO,MAAM;CAAsB;CAC3D,gBAAgB;EAAE,QAAQ;EAAQ,MAAM;CAAmB;CAC3D,oBAAoB;EAAE,QAAQ;EAAO,MAAM;CAAoB;CAC/D,iBAAiB;EAAE,QAAQ;EAAQ,MAAM;CAA2B;CACpE,gBAAgB;EAAE,QAAQ;EAAQ,MAAM;CAA0B;CAClE,iBAAiB;EAAE,QAAQ;EAAQ,MAAM;CAA2B;AACtE;AAEA,MAAa,eACX,iBAAiC,CAAC,GAClC,mBACG;CACH,MAAM,aACJ,gBAAgB,QAAQ,cAAc,OAAO,cAAc;;;;;;;;;;;;;CAc7D,MAAM,eAAe,OACnB,QACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,WAAW,cAAc,YAAY,GAC/D,gBACA,cACA;EACE,QAAQ,cAAc,aAAa;EACnC;CACF,CACF;CAEF,MAAM,UAAU,OACd,MACA,eAA+B,CAAC,MAC7B;EACH,IAAI,CAAC,MAAM,KAAK;EAEhB,MAAM,EAAE,KAAK,SAAS,WAAW,WAAW;EAE5C,MAAM,SAAS,IAAI,gBAAgB,EAAE,IAAI,CAAC;EAC1C,IAAI,SAAS,OAAO,IAAI,WAAW,MAAM;EACzC,MAAM,WAAW,GAAG,cAAc,YAAY,WAAW,cAAc,IAAI,EAAE,GAAG,OAAO,SAAS;EAEhG,MAAM,WAAW,MAAM,MAAM,UAAU;GACrC,QAAQ,cAAc,KAAK;GAC3B,SAAS;IACP,QAAQ;IACR,GAAG,eAAe;IAClB,GAAG,aAAa;GAClB;GACA,aAAa;GACb,QAAQ,aAAa;EACvB,CAAC;EAED,IAAI,CAAC,SAAS,IAAI;GAChB,IAAI,eAAe;GACnB,IAAI;IACF,MAAM,YAAY,MAAM,SAAS,KAAK;IACtC,eAAe,KAAK,UAAU,UAAU,KAAK,KAAK;GACpD,QAAQ;IACN,IAAI;KACF,MAAM,YAAY,MAAM,SAAS,KAAK;KACtC,IAAI,WAAW,eAAe;IAChC,QAAQ,CAER;GACF;GACA,MAAM,IAAI,MAAM,YAAY;EAC9B;EAEA,MAAM,SAAS,SAAS,MAAM,UAAU;EACxC,IAAI,CAAC,QAAQ,MAAM,IAAI,MAAM,qBAAqB;EAElD,MAAM,UAAU,IAAI,YAAY;EAChC,IAAI,SAAS;EAEb,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,IAAI,KAAK,WAAW,QAAQ,GAC1B,IAAI;IACF,MAAM,QAAQ,KAAK,MAAM,KAAK,MAAM,CAAC,CAAC;IACtC,YAAY,KAAK;GACnB,QAAQ,CAER;EAGN;EAEA,SAAS;CACX;;;;CAKA,MAAM,sBAAsB,OAC1B,MACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,WAAW,cAAc,cAAc,GACjE,gBACA,cACA;EACE,QAAQ,cAAc,eAAe;EACrC,QAAQ,MAAM,MAAM,EAAE,KAAK,KAAK,IAAI,IAAI;EACxC,MAAM,MAAM,SAAS,SAAY,EAAE,MAAM,KAAK,KAAY,IAAI;CAChE,CACF;;;;CAKF,MAAM,0BAA0B,OAC9B,QACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,WAAW,cAAc,oBAAoB,EACrE,OAAO,OAAO,QAAQ,KAAK,EAC7B,CAAC,GACD,gBACA,cACA,EACE,QAAQ,cAAc,mBAAmB,OAC3C,CACF;CAEF,MAAM,uBAAuB,OAC3B,QACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,WAAW,cAAc,iBAAiB,EAClE,OAAO,OAAO,QAAQ,KAAK,EAC7B,CAAC,GACD,gBACA,cACA,EAAE,QAAQ,cAAc,gBAAgB,OAAO,CACjD;CAEF,MAAM,sBAAsB,OAC1B,QACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,WAAW,cAAc,gBAAgB,EACjE,OAAO,OAAO,QAAQ,KAAK,EAC7B,CAAC,GACD,gBACA,cACA,EAAE,QAAQ,cAAc,eAAe,OAAO,CAChD;CAEF,MAAM,uBAAuB,OAC3B,QACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,WAAW,cAAc,iBAAiB,EAClE,OAAO,OAAO,QAAQ,KAAK,EAC7B,CAAC,GACD,gBACA,cACA,EAAE,QAAQ,cAAc,gBAAgB,OAAO,CACjD;;;;CAKF,MAAM,qBAAqB,OACzB,QACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,WAAW,cAAc,kBAAkB,GACrE,gBACA,cACA;EAAE,QAAQ,cAAc,mBAAmB;EAAQ;CAAO,CAC5D;;;;;CAMF,MAAM,kBAAkB,OACtB,QACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,WAAW,cAAc,eAAe,GAClE,gBACA,cACA;EAAE,QAAQ,cAAc,gBAAgB;EAAQ;CAAO,CACzD;;;;CAKF,MAAM,iBAAiB,OACrB,QACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,WAAW,cAAc,gBAAgB,EACjE,MAAM,QAAQ,QAAQ,GACxB,CAAC,GACD,gBACA,cACA,EAAE,QAAQ,cAAc,eAAe,OAAO,CAChD;CAEF,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF;;;;;;;AAQA,MAAa,gBAAgB,eAAe,WAAW"}

package/dist/esm/getIntlayerAPI/bitbucket.mjs

@@ -1,28 +1,58 @@
 import { fetcher } from "../fetcher.mjs";
 import { createEndpoint } from "../cms/createIntlayerCMS.mjs";
 import { editor } from "@intlayer/config/built";
+import { buildRouteURL } from "@intlayer/backend-contract/defineRoute";
+import { BACKEND_URL } from "@intlayer/config/defaultValues";
 
 //#region src/getIntlayerAPI/bitbucket.ts
+/** Prefix of the routes, checked against the backend contract. */
+const bitbucketGroup = { prefix: "/api/bitbucket" };
+/**
+* Method and path of every route, checked against the backend contract at
+* compile time (the contract's zod schemas are never loaded).
+*/
+const bitbucketEndpoints = {
+	getAuthUrl: {
+		method: "GET",
+		path: "/auth-url"
+	},
+	authCallback: {
+		method: "POST",
+		path: "/auth"
+	},
+	listRepos: {
+		method: "GET",
+		path: "/repos"
+	},
+	checkConfig: {
+		method: "POST",
+		path: "/check-config"
+	},
+	getConfigFile: {
+		method: "POST",
+		path: "/get-config-file"
+	}
+};
 const getBitbucketAPI = (authAPIOptions = {}, intlayerConfig) => {
-	const BITBUCKET_API_ROUTE = `${intlayerConfig?.editor?.backendURL ?? editor.backendURL}/api/bitbucket`;
+	const backendURL = intlayerConfig?.editor?.backendURL ?? editor.backendURL ?? BACKEND_URL;
 	/**
 	* Get Bitbucket OAuth authorization URL
 	* @param redirectUri - Redirect URI after OAuth authorization
 	*/
-	const getAuthUrl = async (redirectUri, otherOptions = {}) => await fetcher(`${BITBUCKET_API_ROUTE}/auth-url`, authAPIOptions, otherOptions, { params: { redirectUri } });
+	const getAuthUrl = async (redirectUri, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, bitbucketGroup, bitbucketEndpoints.getAuthUrl), authAPIOptions, otherOptions, { params: { redirectUri } });
 	/**
 	* Exchange Bitbucket authorization code for access token
 	* @param code - Bitbucket authorization code
 	*/
-	const authenticate = async (code, otherOptions = {}) => await fetcher(`${BITBUCKET_API_ROUTE}/auth`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const authenticate = async (code, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, bitbucketGroup, bitbucketEndpoints.authCallback), authAPIOptions, otherOptions, {
+		method: bitbucketEndpoints.authCallback.method,
 		body: { code }
 	});
 	/**
 	* Get user's Bitbucket repositories
 	* @param token - Optional Bitbucket access token. If not provided, backend will use session.
 	*/
-	const getRepositories = async (token, otherOptions = {}) => await fetcher(`${BITBUCKET_API_ROUTE}/repos`, authAPIOptions, otherOptions, { params: token ? { token } : void 0 });
+	const getRepositories = async (token, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, bitbucketGroup, bitbucketEndpoints.listRepos), authAPIOptions, otherOptions, { params: token ? { token } : void 0 });
 	/**
 	* Check if intlayer.config.ts exists in a Bitbucket repository
 	* @param token - Optional Bitbucket access token. If not provided, backend will use session.
@@ -30,8 +60,8 @@ const getBitbucketAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* @param repoSlug - Repository slug
 	* @param branch - Branch name (default: 'main')
 	*/
-	const checkIntlayerConfig = async (token, workspace, repoSlug, branch = "main", otherOptions = {}) => await fetcher(`${BITBUCKET_API_ROUTE}/check-config`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const checkIntlayerConfig = async (token, workspace, repoSlug, branch = "main", otherOptions = {}) => await fetcher(buildRouteURL(backendURL, bitbucketGroup, bitbucketEndpoints.checkConfig), authAPIOptions, otherOptions, {
+		method: bitbucketEndpoints.checkConfig.method,
 		body: {
 			token: token ?? void 0,
 			workspace,
@@ -47,8 +77,8 @@ const getBitbucketAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* @param branch - Branch name (default: 'main')
 	* @param path - File path (default: 'intlayer.config.ts')
 	*/
-	const getConfigFile = async (token, workspace, repoSlug, branch = "main", path = "intlayer.config.ts", otherOptions = {}) => await fetcher(`${BITBUCKET_API_ROUTE}/get-config-file`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const getConfigFile = async (token, workspace, repoSlug, branch = "main", path = "intlayer.config.ts", otherOptions = {}) => await fetcher(buildRouteURL(backendURL, bitbucketGroup, bitbucketEndpoints.getConfigFile), authAPIOptions, otherOptions, {
+		method: bitbucketEndpoints.getConfigFile.method,
 		body: {
 			token: token ?? void 0,
 			workspace,

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

@@ -1 +1 @@
-{"version":3,"file":"bitbucket.mjs","names":[],"sources":["../../../src/getIntlayerAPI/bitbucket.ts"],"sourcesContent":["import { editor } from '@intlayer/config/built';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { createEndpoint } from '../cms/createIntlayerCMS';\nimport { type FetcherOptions, fetcher } from '../fetcher';\n\nexport type BitbucketRepository = {\n  uuid: string;\n  name: string;\n  full_name: string;\n  slug: string;\n  mainbranch?: {\n    name: string;\n    type: string;\n  };\n  links: {\n    html: {\n      href: string;\n    };\n  };\n  workspace: {\n    slug: string;\n    name: string;\n    uuid: string;\n  };\n  owner: {\n    display_name: string;\n    username?: string;\n    uuid: string;\n  };\n  updated_on: string;\n  is_private: boolean;\n};\n\nexport type BitbucketAuthCallbackBody = {\n  code: string;\n};\n\nexport type BitbucketAuthCallbackResult = {\n  data: {\n    token: string;\n  };\n};\n\nexport type BitbucketListReposResult = {\n  data: BitbucketRepository[];\n};\n\nexport type BitbucketCheckConfigBody = {\n  token?: string;\n  workspace: string;\n  repoSlug: string;\n  branch?: string;\n};\n\nexport type BitbucketCheckConfigResult = {\n  data: {\n    hasConfig: boolean;\n    configPaths: string[];\n  };\n};\n\nexport type BitbucketGetConfigFileBody = {\n  token?: string;\n  workspace: string;\n  repoSlug: string;\n  branch?: string;\n  path?: string;\n};\n\nexport type BitbucketGetConfigFileResult = {\n  data: {\n    content: string;\n  };\n};\n\nexport type BitbucketGetAuthUrlResult = {\n  data: {\n    authUrl: string;\n  };\n};\n\nexport const getBitbucketAPI = (\n  authAPIOptions: FetcherOptions = {},\n  intlayerConfig?: IntlayerConfig\n) => {\n  const backendURL = intlayerConfig?.editor?.backendURL ?? editor.backendURL;\n\n  const BITBUCKET_API_ROUTE = `${backendURL}/api/bitbucket`;\n\n  /**\n   * Get Bitbucket OAuth authorization URL\n   * @param redirectUri - Redirect URI after OAuth authorization\n   */\n  const getAuthUrl = async (\n    redirectUri: string,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<BitbucketGetAuthUrlResult>(\n      `${BITBUCKET_API_ROUTE}/auth-url`,\n      authAPIOptions,\n      otherOptions,\n      {\n        params: { redirectUri },\n      }\n    );\n\n  /**\n   * Exchange Bitbucket authorization code for access token\n   * @param code - Bitbucket authorization code\n   */\n  const authenticate = async (\n    code: string,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<BitbucketAuthCallbackResult>(\n      `${BITBUCKET_API_ROUTE}/auth`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'POST',\n        body: { code },\n      }\n    );\n\n  /**\n   * Get user's Bitbucket repositories\n   * @param token - Optional Bitbucket access token. If not provided, backend will use session.\n   */\n  const getRepositories = async (\n    token?: string | null,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<BitbucketListReposResult>(\n      `${BITBUCKET_API_ROUTE}/repos`,\n      authAPIOptions,\n      otherOptions,\n      {\n        params: token ? { token } : undefined,\n      }\n    );\n\n  /**\n   * Check if intlayer.config.ts exists in a Bitbucket repository\n   * @param token - Optional Bitbucket access token. If not provided, backend will use session.\n   * @param workspace - Bitbucket workspace slug\n   * @param repoSlug - Repository slug\n   * @param branch - Branch name (default: 'main')\n   */\n  const checkIntlayerConfig = async (\n    token: string | null | undefined,\n    workspace: string,\n    repoSlug: string,\n    branch: string = 'main',\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<BitbucketCheckConfigResult>(\n      `${BITBUCKET_API_ROUTE}/check-config`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'POST',\n        body: { token: token ?? undefined, workspace, repoSlug, branch },\n      }\n    );\n\n  /**\n   * Get intlayer.config.ts file contents from a Bitbucket repository\n   * @param token - Optional Bitbucket access token. If not provided, backend will use session.\n   * @param workspace - Bitbucket workspace slug\n   * @param repoSlug - Repository slug\n   * @param branch - Branch name (default: 'main')\n   * @param path - File path (default: 'intlayer.config.ts')\n   */\n  const getConfigFile = async (\n    token: string | null | undefined,\n    workspace: string,\n    repoSlug: string,\n    branch: string = 'main',\n    path: string = 'intlayer.config.ts',\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<BitbucketGetConfigFileResult>(\n      `${BITBUCKET_API_ROUTE}/get-config-file`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'POST',\n        body: {\n          token: token ?? undefined,\n          workspace,\n          repoSlug,\n          branch,\n          path,\n        },\n      }\n    );\n\n  return {\n    getAuthUrl,\n    authenticate,\n    getRepositories,\n    checkIntlayerConfig,\n    getConfigFile,\n  };\n};\n\n/**\n * Authenticated `bitbucket` 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 bitbucketEndpoint = createEndpoint(getBitbucketAPI);\n"],"mappings":";;;;;AAiFA,MAAa,mBACX,iBAAiC,CAAC,GAClC,mBACG;CAGH,MAAM,sBAAsB,GAFT,gBAAgB,QAAQ,cAAc,OAAO,WAEtB;;;;;CAM1C,MAAM,aAAa,OACjB,aACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,oBAAoB,YACvB,gBACA,cACA,EACE,QAAQ,EAAE,YAAY,EACxB,CACF;;;;;CAMF,MAAM,eAAe,OACnB,MACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,oBAAoB,QACvB,gBACA,cACA;EACE,QAAQ;EACR,MAAM,EAAE,KAAK;CACf,CACF;;;;;CAMF,MAAM,kBAAkB,OACtB,OACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,oBAAoB,SACvB,gBACA,cACA,EACE,QAAQ,QAAQ,EAAE,MAAM,IAAI,OAC9B,CACF;;;;;;;;CASF,MAAM,sBAAsB,OAC1B,OACA,WACA,UACA,SAAiB,QACjB,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,oBAAoB,gBACvB,gBACA,cACA;EACE,QAAQ;EACR,MAAM;GAAE,OAAO,SAAS;GAAW;GAAW;GAAU;EAAO;CACjE,CACF;;;;;;;;;CAUF,MAAM,gBAAgB,OACpB,OACA,WACA,UACA,SAAiB,QACjB,OAAe,sBACf,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,oBAAoB,mBACvB,gBACA,cACA;EACE,QAAQ;EACR,MAAM;GACJ,OAAO,SAAS;GAChB;GACA;GACA;GACA;EACF;CACF,CACF;CAEF,OAAO;EACL;EACA;EACA;EACA;EACA;CACF;AACF;;;;;;;AAQA,MAAa,oBAAoB,eAAe,eAAe"}
+{"version":3,"file":"bitbucket.mjs","names":[],"sources":["../../../src/getIntlayerAPI/bitbucket.ts"],"sourcesContent":["import type { RouteEndpoints } from '@intlayer/backend-contract/defineRoute';\nimport { buildRouteURL } from '@intlayer/backend-contract/defineRoute';\nimport type {\n  BitbucketRoutes,\n  bitbucketContract,\n} from '@intlayer/backend-contract/gitProviders';\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 BitbucketRepository = {\n  uuid: string;\n  name: string;\n  full_name: string;\n  slug: string;\n  mainbranch?: {\n    name: string;\n    type: string;\n  };\n  links: {\n    html: {\n      href: string;\n    };\n  };\n  workspace: {\n    slug: string;\n    name: string;\n    uuid: string;\n  };\n  owner: {\n    display_name: string;\n    username?: string;\n    uuid: string;\n  };\n  updated_on: string;\n  is_private: boolean;\n};\n\nexport type BitbucketAuthCallbackBody = {\n  code: string;\n};\n\nexport type BitbucketAuthCallbackResult = {\n  data: {\n    token: string;\n  };\n};\n\nexport type BitbucketListReposResult = {\n  data: BitbucketRepository[];\n};\n\nexport type BitbucketCheckConfigBody = {\n  token?: string;\n  workspace: string;\n  repoSlug: string;\n  branch?: string;\n};\n\nexport type BitbucketCheckConfigResult = {\n  data: {\n    hasConfig: boolean;\n    configPaths: string[];\n  };\n};\n\nexport type BitbucketGetConfigFileBody = {\n  token?: string;\n  workspace: string;\n  repoSlug: string;\n  branch?: string;\n  path?: string;\n};\n\nexport type BitbucketGetConfigFileResult = {\n  data: {\n    content: string;\n  };\n};\n\nexport type BitbucketGetAuthUrlResult = {\n  data: {\n    authUrl: string;\n  };\n};\n\n/** Prefix of the routes, checked against the backend contract. */\nconst bitbucketGroup = {\n  prefix: '/api/bitbucket',\n} as const satisfies Pick<typeof bitbucketContract, '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 bitbucketEndpoints = {\n  getAuthUrl: { method: 'GET', path: '/auth-url' },\n  authCallback: { method: 'POST', path: '/auth' },\n  listRepos: { method: 'GET', path: '/repos' },\n  checkConfig: { method: 'POST', path: '/check-config' },\n  getConfigFile: { method: 'POST', path: '/get-config-file' },\n} as const satisfies RouteEndpoints<BitbucketRoutes>;\n\nexport const getBitbucketAPI = (\n  authAPIOptions: FetcherOptions = {},\n  intlayerConfig?: IntlayerConfig\n) => {\n  const backendURL =\n    intlayerConfig?.editor?.backendURL ?? editor.backendURL ?? BACKEND_URL;\n\n  /**\n   * Get Bitbucket OAuth authorization URL\n   * @param redirectUri - Redirect URI after OAuth authorization\n   */\n  const getAuthUrl = async (\n    redirectUri: string,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<BitbucketGetAuthUrlResult>(\n      buildRouteURL(backendURL, bitbucketGroup, bitbucketEndpoints.getAuthUrl),\n      authAPIOptions,\n      otherOptions,\n      {\n        params: { redirectUri },\n      }\n    );\n\n  /**\n   * Exchange Bitbucket authorization code for access token\n   * @param code - Bitbucket authorization code\n   */\n  const authenticate = async (\n    code: string,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<BitbucketAuthCallbackResult>(\n      buildRouteURL(\n        backendURL,\n        bitbucketGroup,\n        bitbucketEndpoints.authCallback\n      ),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: bitbucketEndpoints.authCallback.method,\n        body: { code },\n      }\n    );\n\n  /**\n   * Get user's Bitbucket repositories\n   * @param token - Optional Bitbucket access token. If not provided, backend will use session.\n   */\n  const getRepositories = async (\n    token?: string | null,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<BitbucketListReposResult>(\n      buildRouteURL(backendURL, bitbucketGroup, bitbucketEndpoints.listRepos),\n      authAPIOptions,\n      otherOptions,\n      {\n        params: token ? { token } : undefined,\n      }\n    );\n\n  /**\n   * Check if intlayer.config.ts exists in a Bitbucket repository\n   * @param token - Optional Bitbucket access token. If not provided, backend will use session.\n   * @param workspace - Bitbucket workspace slug\n   * @param repoSlug - Repository slug\n   * @param branch - Branch name (default: 'main')\n   */\n  const checkIntlayerConfig = async (\n    token: string | null | undefined,\n    workspace: string,\n    repoSlug: string,\n    branch: string = 'main',\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<BitbucketCheckConfigResult>(\n      buildRouteURL(backendURL, bitbucketGroup, bitbucketEndpoints.checkConfig),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: bitbucketEndpoints.checkConfig.method,\n        body: { token: token ?? undefined, workspace, repoSlug, branch },\n      }\n    );\n\n  /**\n   * Get intlayer.config.ts file contents from a Bitbucket repository\n   * @param token - Optional Bitbucket access token. If not provided, backend will use session.\n   * @param workspace - Bitbucket workspace slug\n   * @param repoSlug - Repository slug\n   * @param branch - Branch name (default: 'main')\n   * @param path - File path (default: 'intlayer.config.ts')\n   */\n  const getConfigFile = async (\n    token: string | null | undefined,\n    workspace: string,\n    repoSlug: string,\n    branch: string = 'main',\n    path: string = 'intlayer.config.ts',\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<BitbucketGetConfigFileResult>(\n      buildRouteURL(\n        backendURL,\n        bitbucketGroup,\n        bitbucketEndpoints.getConfigFile\n      ),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: bitbucketEndpoints.getConfigFile.method,\n        body: {\n          token: token ?? undefined,\n          workspace,\n          repoSlug,\n          branch,\n          path,\n        },\n      }\n    );\n\n  return {\n    getAuthUrl,\n    authenticate,\n    getRepositories,\n    checkIntlayerConfig,\n    getConfigFile,\n  };\n};\n\n/**\n * Authenticated `bitbucket` 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 bitbucketEndpoint = createEndpoint(getBitbucketAPI);\n"],"mappings":";;;;;;;;AAyFA,MAAM,iBAAiB,EACrB,QAAQ,iBACV;;;;;AAMA,MAAM,qBAAqB;CACzB,YAAY;EAAE,QAAQ;EAAO,MAAM;CAAY;CAC/C,cAAc;EAAE,QAAQ;EAAQ,MAAM;CAAQ;CAC9C,WAAW;EAAE,QAAQ;EAAO,MAAM;CAAS;CAC3C,aAAa;EAAE,QAAQ;EAAQ,MAAM;CAAgB;CACrD,eAAe;EAAE,QAAQ;EAAQ,MAAM;CAAmB;AAC5D;AAEA,MAAa,mBACX,iBAAiC,CAAC,GAClC,mBACG;CACH,MAAM,aACJ,gBAAgB,QAAQ,cAAc,OAAO,cAAc;;;;;CAM7D,MAAM,aAAa,OACjB,aACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,gBAAgB,mBAAmB,UAAU,GACvE,gBACA,cACA,EACE,QAAQ,EAAE,YAAY,EACxB,CACF;;;;;CAMF,MAAM,eAAe,OACnB,MACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,YACA,gBACA,mBAAmB,YACrB,GACA,gBACA,cACA;EACE,QAAQ,mBAAmB,aAAa;EACxC,MAAM,EAAE,KAAK;CACf,CACF;;;;;CAMF,MAAM,kBAAkB,OACtB,OACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,gBAAgB,mBAAmB,SAAS,GACtE,gBACA,cACA,EACE,QAAQ,QAAQ,EAAE,MAAM,IAAI,OAC9B,CACF;;;;;;;;CASF,MAAM,sBAAsB,OAC1B,OACA,WACA,UACA,SAAiB,QACjB,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,gBAAgB,mBAAmB,WAAW,GACxE,gBACA,cACA;EACE,QAAQ,mBAAmB,YAAY;EACvC,MAAM;GAAE,OAAO,SAAS;GAAW;GAAW;GAAU;EAAO;CACjE,CACF;;;;;;;;;CAUF,MAAM,gBAAgB,OACpB,OACA,WACA,UACA,SAAiB,QACjB,OAAe,sBACf,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,YACA,gBACA,mBAAmB,aACrB,GACA,gBACA,cACA;EACE,QAAQ,mBAAmB,cAAc;EACzC,MAAM;GACJ,OAAO,SAAS;GAChB;GACA;GACA;GACA;EACF;CACF,CACF;CAEF,OAAO;EACL;EACA;EACA;EACA;EACA;CACF;AACF;;;;;;;AAQA,MAAa,oBAAoB,eAAe,eAAe"}

package/dist/esm/getIntlayerAPI/codeberg.mjs

@@ -0,0 +1,19 @@
+import { createEndpoint } from "../cms/createIntlayerCMS.mjs";
+import { createForgeAPI } from "./forge.mjs";
+
+//#region src/getIntlayerAPI/codeberg.ts
+/** Prefix of the routes, checked against the backend contract. */
+const codebergGroup = { prefix: "/api/codeberg" };
+/** Codeberg (Forgejo) repositories of the linked account. */
+const getCodebergAPI = createForgeAPI(codebergGroup);
+/**
+* Authenticated `codeberg` endpoint bound to an Intlayer CMS authenticator.
+*
+* Pass an authenticator created with `createIntlayerCMS`, or omit it to use
+* the build-time configuration (`@intlayer/config/built`).
+*/
+const codebergEndpoint = createEndpoint(getCodebergAPI);
+
+//#endregion
+export { codebergEndpoint, getCodebergAPI };
+//# sourceMappingURL=codeberg.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codeberg.mjs","names":[],"sources":["../../../src/getIntlayerAPI/codeberg.ts"],"sourcesContent":["import type { codebergContract } from '@intlayer/backend-contract/gitProviders';\nimport { createEndpoint } from '../cms/createIntlayerCMS';\nimport { createForgeAPI } from './forge';\n\n/** Prefix of the routes, checked against the backend contract. */\nconst codebergGroup = {\n  prefix: '/api/codeberg',\n} as const satisfies Pick<typeof codebergContract, 'prefix'>;\n\n/** Codeberg (Forgejo) repositories of the linked account. */\nexport const getCodebergAPI = createForgeAPI(codebergGroup);\n\n/**\n * Authenticated `codeberg` 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 codebergEndpoint = createEndpoint(getCodebergAPI);\n"],"mappings":";;;;;AAKA,MAAM,gBAAgB,EACpB,QAAQ,gBACV;;AAGA,MAAa,iBAAiB,eAAe,aAAa;;;;;;;AAQ1D,MAAa,mBAAmB,eAAe,cAAc"}

package/dist/esm/getIntlayerAPI/dictionary.mjs

@@ -1,32 +1,78 @@
 import { fetcher } from "../fetcher.mjs";
 import { createEndpoint } from "../cms/createIntlayerCMS.mjs";
 import { editor } from "@intlayer/config/built";
+import { buildRouteURL } from "@intlayer/backend-contract/defineRoute";
+import { BACKEND_URL } from "@intlayer/config/defaultValues";
 
 //#region src/getIntlayerAPI/dictionary.ts
+/** Prefix of the routes, checked against the backend contract. */
+const dictionaryGroup = { prefix: "/api/dictionary" };
+/**
+* Method and path of every route, checked against the backend contract at
+* compile time (the contract's zod schemas are never loaded).
+*/
+const dictionaryEndpoints = {
+	getDictionaries: {
+		method: "GET",
+		path: "/"
+	},
+	getDictionariesKeys: {
+		method: "GET",
+		path: "/keys"
+	},
+	getDictionariesUpdateTimestamp: {
+		method: "GET",
+		path: "/update"
+	},
+	getDictionariesByKeys: {
+		method: "GET",
+		path: "/by-keys"
+	},
+	getDictionary: {
+		method: "GET",
+		path: "/:dictionaryKey"
+	},
+	addDictionary: {
+		method: "POST",
+		path: "/"
+	},
+	pushDictionaries: {
+		method: "PATCH",
+		path: "/"
+	},
+	updateDictionary: {
+		method: "PUT",
+		path: "/:dictionaryId"
+	},
+	deleteDictionary: {
+		method: "DELETE",
+		path: "/:dictionaryId"
+	}
+};
 const getDictionaryAPI = (authAPIOptions = {}, intlayerConfig) => {
-	const PROJECT_API_ROUTE = `${intlayerConfig?.editor?.backendURL ?? editor.backendURL}/api/dictionary`;
+	const backendURL = intlayerConfig?.editor?.backendURL ?? editor.backendURL ?? BACKEND_URL;
 	/**
 	* Retrieves a list of dictionaries based on filters and pagination.
 	* @param filters - Filters and pagination options.
 	*/
-	const getDictionaries = async (filters, otherOptions = {}) => await fetcher(PROJECT_API_ROUTE, authAPIOptions, otherOptions, {
+	const getDictionaries = async (filters, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, dictionaryGroup, dictionaryEndpoints.getDictionaries), authAPIOptions, otherOptions, {
 		cache: "no-store",
 		params: filters
 	});
 	/**
 	* Retrieves a list of dictionary keys related to the project.
 	*/
-	const getDictionariesKeys = async (otherOptions = {}) => await fetcher(`${PROJECT_API_ROUTE}/keys`, authAPIOptions, otherOptions, { cache: "no-store" });
+	const getDictionariesKeys = async (otherOptions = {}) => await fetcher(buildRouteURL(backendURL, dictionaryGroup, dictionaryEndpoints.getDictionariesKeys), authAPIOptions, otherOptions, { cache: "no-store" });
 	/**
 	* Retrieves a list of dictionary keys related to the project.
 	*/
-	const getDictionariesUpdateTimestamp = async (otherOptions = {}) => await fetcher(`${PROJECT_API_ROUTE}/update`, authAPIOptions, otherOptions, { cache: "no-store" });
+	const getDictionariesUpdateTimestamp = async (otherOptions = {}) => await fetcher(buildRouteURL(backendURL, dictionaryGroup, dictionaryEndpoints.getDictionariesUpdateTimestamp), authAPIOptions, otherOptions, { cache: "no-store" });
 	/**
 	* Retrieves a dictionary by its key and version.
 	* @param dictionaryKey - Dictionary key.
 	* @param version - Dictionary version of content.
 	*/
-	const getDictionary = async (dictionaryKey, version, otherOptions = {}) => await fetcher(`${PROJECT_API_ROUTE}/${dictionaryKey}`, authAPIOptions, otherOptions, { params: version ? { version: version.toString() } : void 0 });
+	const getDictionary = async (dictionaryKey, version, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, dictionaryGroup, dictionaryEndpoints.getDictionary, { dictionaryKey }), authAPIOptions, otherOptions, { params: version ? { version: version.toString() } : void 0 });
 	/**
 	* Retrieves several dictionaries at once from their keys, in a single
 	* request. Keys matching no dictionary are absent from the result, so the
@@ -35,7 +81,7 @@ const getDictionaryAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* @param dictionaryKeys - Dictionary keys to retrieve.
 	* @param version - Dictionary version of content.
 	*/
-	const getDictionariesByKeys = async (dictionaryKeys, version, otherOptions = {}) => await fetcher(`${PROJECT_API_ROUTE}/by-keys`, authAPIOptions, otherOptions, {
+	const getDictionariesByKeys = async (dictionaryKeys, version, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, dictionaryGroup, dictionaryEndpoints.getDictionariesByKeys), authAPIOptions, otherOptions, {
 		cache: "no-store",
 		params: {
 			keys: dictionaryKeys.join(","),
@@ -46,27 +92,27 @@ const getDictionaryAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* Adds a new dictionary to the database.
 	* @param dictionary - Dictionary data.
 	*/
-	const addDictionary = async (body, otherOptions = {}) => await fetcher(`${PROJECT_API_ROUTE}`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const addDictionary = async (body, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, dictionaryGroup, dictionaryEndpoints.addDictionary), authAPIOptions, otherOptions, {
+		method: dictionaryEndpoints.addDictionary.method,
 		body
 	});
-	const pushDictionaries = async (dictionaries, otherOptions = {}) => await fetcher(`${PROJECT_API_ROUTE}`, authAPIOptions, otherOptions, {
-		method: "PATCH",
+	const pushDictionaries = async (dictionaries, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, dictionaryGroup, dictionaryEndpoints.pushDictionaries), authAPIOptions, otherOptions, {
+		method: dictionaryEndpoints.pushDictionaries.method,
 		body: { dictionaries }
 	});
 	/**
 	* Updates an existing dictionary in the database.
 	* @param dictionary - Updated dictionary data.
 	*/
-	const updateDictionary = async (dictionary, otherOptions = {}) => await fetcher(`${PROJECT_API_ROUTE}/${dictionary.id}`, authAPIOptions, otherOptions, {
-		method: "PUT",
+	const updateDictionary = async (dictionary, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, dictionaryGroup, dictionaryEndpoints.updateDictionary, { dictionaryId: String(dictionary.id) }), authAPIOptions, otherOptions, {
+		method: dictionaryEndpoints.updateDictionary.method,
 		body: dictionary
 	});
 	/**
 	* Deletes a dictionary from the database by its ID.
 	* @param id - Dictionary ID.
 	*/
-	const deleteDictionary = async (id, otherOptions = {}) => await fetcher(`${PROJECT_API_ROUTE}/${id}`, authAPIOptions, otherOptions, { method: "DELETE" });
+	const deleteDictionary = async (id, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, dictionaryGroup, dictionaryEndpoints.deleteDictionary, { dictionaryId: String(id) }), authAPIOptions, otherOptions, { method: dictionaryEndpoints.deleteDictionary.method });
 	return {
 		getDictionaries,
 		getDictionariesKeys,

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

@@ -1 +1 @@
-{"version":3,"file":"dictionary.mjs","names":[],"sources":["../../../src/getIntlayerAPI/dictionary.ts"],"sourcesContent":["import type {\n  AddDictionaryBody,\n  AddDictionaryResult,\n  DeleteDictionaryParam,\n  DeleteDictionaryResult,\n  GetDictionariesByKeysResult,\n  GetDictionariesKeysResult,\n  GetDictionariesParams,\n  GetDictionariesResult,\n  GetDictionariesUpdateTimestampResult,\n  GetDictionaryParams,\n  GetDictionaryQuery,\n  GetDictionaryResult,\n  PushDictionariesBody,\n  PushDictionariesResult,\n  UpdateDictionaryBody,\n  UpdateDictionaryResult,\n} from '@intlayer/backend';\nimport { editor } from '@intlayer/config/built';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { createEndpoint } from '../cms/createIntlayerCMS';\nimport { type FetcherOptions, fetcher } from '../fetcher';\n\nexport const getDictionaryAPI = (\n  authAPIOptions: FetcherOptions = {},\n  intlayerConfig?: IntlayerConfig\n) => {\n  const backendURL = intlayerConfig?.editor?.backendURL ?? editor.backendURL;\n\n  const PROJECT_API_ROUTE = `${backendURL}/api/dictionary`;\n\n  /**\n   * Retrieves a list of dictionaries based on filters and pagination.\n   * @param filters - Filters and pagination options.\n   */\n  const getDictionaries = async (\n    filters?: GetDictionariesParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetDictionariesResult>(\n      PROJECT_API_ROUTE,\n      authAPIOptions,\n      otherOptions,\n      {\n        cache: 'no-store',\n        // @ts-ignore Number of parameter will be stringified by the fetcher\n        params: filters,\n      }\n    );\n\n  /**\n   * Retrieves a list of dictionary keys related to the project.\n   */\n  const getDictionariesKeys = async (otherOptions: FetcherOptions = {}) =>\n    await fetcher<GetDictionariesKeysResult>(\n      `${PROJECT_API_ROUTE}/keys`,\n      authAPIOptions,\n      otherOptions,\n      {\n        cache: 'no-store',\n      }\n    );\n\n  /**\n   * Retrieves a list of dictionary keys related to the project.\n   */\n  const getDictionariesUpdateTimestamp = async (\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetDictionariesUpdateTimestampResult>(\n      `${PROJECT_API_ROUTE}/update`,\n      authAPIOptions,\n      otherOptions,\n      {\n        cache: 'no-store',\n      }\n    );\n\n  /**\n   * Retrieves a dictionary by its key and version.\n   * @param dictionaryKey - Dictionary key.\n   * @param version - Dictionary version of content.\n   */\n  const getDictionary = async (\n    dictionaryKey: GetDictionaryParams['dictionaryKey'],\n    version?: GetDictionaryQuery['version'],\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetDictionaryResult>(\n      `${PROJECT_API_ROUTE}/${dictionaryKey}`,\n      authAPIOptions,\n      otherOptions,\n      {\n        params: version ? { version: version.toString() } : undefined,\n      }\n    );\n\n  /**\n   * Retrieves several dictionaries at once from their keys, in a single\n   * request. Keys matching no dictionary are absent from the result, so the\n   * caller should reconcile the response against the requested keys.\n   *\n   * @param dictionaryKeys - Dictionary keys to retrieve.\n   * @param version - Dictionary version of content.\n   */\n  const getDictionariesByKeys = async (\n    dictionaryKeys: string[],\n    version?: GetDictionaryQuery['version'],\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetDictionariesByKeysResult>(\n      `${PROJECT_API_ROUTE}/by-keys`,\n      authAPIOptions,\n      otherOptions,\n      {\n        cache: 'no-store',\n        params: {\n          keys: dictionaryKeys.join(','),\n          version: version?.toString(),\n        },\n      }\n    );\n\n  /**\n   * Adds a new dictionary to the database.\n   * @param dictionary - Dictionary data.\n   */\n  const addDictionary = async (\n    body: AddDictionaryBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<AddDictionaryResult>(\n      `${PROJECT_API_ROUTE}`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'POST',\n        body,\n      }\n    );\n\n  const pushDictionaries = async (\n    dictionaries: PushDictionariesBody['dictionaries'],\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<PushDictionariesResult>(\n      `${PROJECT_API_ROUTE}`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'PATCH',\n        body: { dictionaries },\n      }\n    );\n\n  /**\n   * Updates an existing dictionary in the database.\n   * @param dictionary - Updated dictionary data.\n   */\n  const updateDictionary = async (\n    dictionary: UpdateDictionaryBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<UpdateDictionaryResult>(\n      `${PROJECT_API_ROUTE}/${dictionary.id}`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'PUT',\n        body: dictionary,\n      }\n    );\n\n  /**\n   * Deletes a dictionary from the database by its ID.\n   * @param id - Dictionary ID.\n   */\n  const deleteDictionary = async (\n    id: DeleteDictionaryParam['dictionaryId'],\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<DeleteDictionaryResult>(\n      `${PROJECT_API_ROUTE}/${id}`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'DELETE',\n      }\n    );\n\n  return {\n    getDictionaries,\n    getDictionariesKeys,\n    getDictionariesUpdateTimestamp,\n    getDictionary,\n    getDictionariesByKeys,\n    pushDictionaries,\n    addDictionary,\n    updateDictionary,\n    deleteDictionary,\n  };\n};\n\n/**\n * Authenticated `dictionary` 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 dictionaryEndpoint = createEndpoint(getDictionaryAPI);\n"],"mappings":";;;;;AAuBA,MAAa,oBACX,iBAAiC,CAAC,GAClC,mBACG;CAGH,MAAM,oBAAoB,GAFP,gBAAgB,QAAQ,cAAc,OAAO,WAExB;;;;;CAMxC,MAAM,kBAAkB,OACtB,SACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,mBACA,gBACA,cACA;EACE,OAAO;EAEP,QAAQ;CACV,CACF;;;;CAKF,MAAM,sBAAsB,OAAO,eAA+B,CAAC,MACjE,MAAM,QACJ,GAAG,kBAAkB,QACrB,gBACA,cACA,EACE,OAAO,WACT,CACF;;;;CAKF,MAAM,iCAAiC,OACrC,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,kBAAkB,UACrB,gBACA,cACA,EACE,OAAO,WACT,CACF;;;;;;CAOF,MAAM,gBAAgB,OACpB,eACA,SACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,kBAAkB,GAAG,iBACxB,gBACA,cACA,EACE,QAAQ,UAAU,EAAE,SAAS,QAAQ,SAAS,EAAE,IAAI,OACtD,CACF;;;;;;;;;CAUF,MAAM,wBAAwB,OAC5B,gBACA,SACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,kBAAkB,WACrB,gBACA,cACA;EACE,OAAO;EACP,QAAQ;GACN,MAAM,eAAe,KAAK,GAAG;GAC7B,SAAS,SAAS,SAAS;EAC7B;CACF,CACF;;;;;CAMF,MAAM,gBAAgB,OACpB,MACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,qBACH,gBACA,cACA;EACE,QAAQ;EACR;CACF,CACF;CAEF,MAAM,mBAAmB,OACvB,cACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,qBACH,gBACA,cACA;EACE,QAAQ;EACR,MAAM,EAAE,aAAa;CACvB,CACF;;;;;CAMF,MAAM,mBAAmB,OACvB,YACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,kBAAkB,GAAG,WAAW,MACnC,gBACA,cACA;EACE,QAAQ;EACR,MAAM;CACR,CACF;;;;;CAMF,MAAM,mBAAmB,OACvB,IACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,kBAAkB,GAAG,MACxB,gBACA,cACA,EACE,QAAQ,SACV,CACF;CAEF,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF;;;;;;;AAQA,MAAa,qBAAqB,eAAe,gBAAgB"}
+{"version":3,"file":"dictionary.mjs","names":[],"sources":["../../../src/getIntlayerAPI/dictionary.ts"],"sourcesContent":["import type { RouteEndpoints } from '@intlayer/backend-contract/defineRoute';\nimport { buildRouteURL } from '@intlayer/backend-contract/defineRoute';\nimport type {\n  AddDictionaryBody,\n  AddDictionaryResult,\n  DeleteDictionaryParam,\n  DeleteDictionaryResult,\n  DictionaryRoutes,\n  dictionaryContract,\n  GetDictionariesByKeysResult,\n  GetDictionariesKeysResult,\n  GetDictionariesParams,\n  GetDictionariesResult,\n  GetDictionariesUpdateTimestampResult,\n  GetDictionaryParams,\n  GetDictionaryQuery,\n  GetDictionaryResult,\n  PushDictionariesBody,\n  PushDictionariesResult,\n  UpdateDictionaryBody,\n  UpdateDictionaryResult,\n} from '@intlayer/backend-contract/dictionary';\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 dictionaryGroup = {\n  prefix: '/api/dictionary',\n} as const satisfies Pick<typeof dictionaryContract, '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 dictionaryEndpoints = {\n  getDictionaries: { method: 'GET', path: '/' },\n  getDictionariesKeys: { method: 'GET', path: '/keys' },\n  getDictionariesUpdateTimestamp: { method: 'GET', path: '/update' },\n  getDictionariesByKeys: { method: 'GET', path: '/by-keys' },\n  getDictionary: { method: 'GET', path: '/:dictionaryKey' },\n  addDictionary: { method: 'POST', path: '/' },\n  pushDictionaries: { method: 'PATCH', path: '/' },\n  updateDictionary: { method: 'PUT', path: '/:dictionaryId' },\n  deleteDictionary: { method: 'DELETE', path: '/:dictionaryId' },\n} as const satisfies RouteEndpoints<DictionaryRoutes>;\n\nexport const getDictionaryAPI = (\n  authAPIOptions: FetcherOptions = {},\n  intlayerConfig?: IntlayerConfig\n) => {\n  const backendURL =\n    intlayerConfig?.editor?.backendURL ?? editor.backendURL ?? BACKEND_URL;\n\n  /**\n   * Retrieves a list of dictionaries based on filters and pagination.\n   * @param filters - Filters and pagination options.\n   */\n  const getDictionaries = async (\n    filters?: GetDictionariesParams,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetDictionariesResult>(\n      buildRouteURL(\n        backendURL,\n        dictionaryGroup,\n        dictionaryEndpoints.getDictionaries\n      ),\n      authAPIOptions,\n      otherOptions,\n      {\n        cache: 'no-store',\n        // @ts-ignore Number of parameter will be stringified by the fetcher\n        params: filters,\n      }\n    );\n\n  /**\n   * Retrieves a list of dictionary keys related to the project.\n   */\n  const getDictionariesKeys = async (otherOptions: FetcherOptions = {}) =>\n    await fetcher<GetDictionariesKeysResult>(\n      buildRouteURL(\n        backendURL,\n        dictionaryGroup,\n        dictionaryEndpoints.getDictionariesKeys\n      ),\n      authAPIOptions,\n      otherOptions,\n      {\n        cache: 'no-store',\n      }\n    );\n\n  /**\n   * Retrieves a list of dictionary keys related to the project.\n   */\n  const getDictionariesUpdateTimestamp = async (\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetDictionariesUpdateTimestampResult>(\n      buildRouteURL(\n        backendURL,\n        dictionaryGroup,\n        dictionaryEndpoints.getDictionariesUpdateTimestamp\n      ),\n      authAPIOptions,\n      otherOptions,\n      {\n        cache: 'no-store',\n      }\n    );\n\n  /**\n   * Retrieves a dictionary by its key and version.\n   * @param dictionaryKey - Dictionary key.\n   * @param version - Dictionary version of content.\n   */\n  const getDictionary = async (\n    dictionaryKey: GetDictionaryParams['dictionaryKey'],\n    version?: GetDictionaryQuery['version'],\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetDictionaryResult>(\n      buildRouteURL(\n        backendURL,\n        dictionaryGroup,\n        dictionaryEndpoints.getDictionary,\n        { dictionaryKey }\n      ),\n      authAPIOptions,\n      otherOptions,\n      {\n        params: version ? { version: version.toString() } : undefined,\n      }\n    );\n\n  /**\n   * Retrieves several dictionaries at once from their keys, in a single\n   * request. Keys matching no dictionary are absent from the result, so the\n   * caller should reconcile the response against the requested keys.\n   *\n   * @param dictionaryKeys - Dictionary keys to retrieve.\n   * @param version - Dictionary version of content.\n   */\n  const getDictionariesByKeys = async (\n    dictionaryKeys: string[],\n    version?: GetDictionaryQuery['version'],\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetDictionariesByKeysResult>(\n      buildRouteURL(\n        backendURL,\n        dictionaryGroup,\n        dictionaryEndpoints.getDictionariesByKeys\n      ),\n      authAPIOptions,\n      otherOptions,\n      {\n        cache: 'no-store',\n        params: {\n          keys: dictionaryKeys.join(','),\n          version: version?.toString(),\n        },\n      }\n    );\n\n  /**\n   * Adds a new dictionary to the database.\n   * @param dictionary - Dictionary data.\n   */\n  const addDictionary = async (\n    body: AddDictionaryBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<AddDictionaryResult>(\n      buildRouteURL(\n        backendURL,\n        dictionaryGroup,\n        dictionaryEndpoints.addDictionary\n      ),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: dictionaryEndpoints.addDictionary.method,\n        body,\n      }\n    );\n\n  const pushDictionaries = async (\n    dictionaries: PushDictionariesBody['dictionaries'],\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<PushDictionariesResult>(\n      buildRouteURL(\n        backendURL,\n        dictionaryGroup,\n        dictionaryEndpoints.pushDictionaries\n      ),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: dictionaryEndpoints.pushDictionaries.method,\n        body: { dictionaries },\n      }\n    );\n\n  /**\n   * Updates an existing dictionary in the database.\n   * @param dictionary - Updated dictionary data.\n   */\n  const updateDictionary = async (\n    dictionary: UpdateDictionaryBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<UpdateDictionaryResult>(\n      buildRouteURL(\n        backendURL,\n        dictionaryGroup,\n        dictionaryEndpoints.updateDictionary,\n        { dictionaryId: String(dictionary.id) }\n      ),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: dictionaryEndpoints.updateDictionary.method,\n        body: dictionary,\n      }\n    );\n\n  /**\n   * Deletes a dictionary from the database by its ID.\n   * @param id - Dictionary ID.\n   */\n  const deleteDictionary = async (\n    id: DeleteDictionaryParam['dictionaryId'],\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<DeleteDictionaryResult>(\n      buildRouteURL(\n        backendURL,\n        dictionaryGroup,\n        dictionaryEndpoints.deleteDictionary,\n        { dictionaryId: String(id) }\n      ),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: dictionaryEndpoints.deleteDictionary.method,\n      }\n    );\n\n  return {\n    getDictionaries,\n    getDictionariesKeys,\n    getDictionariesUpdateTimestamp,\n    getDictionary,\n    getDictionariesByKeys,\n    pushDictionaries,\n    addDictionary,\n    updateDictionary,\n    deleteDictionary,\n  };\n};\n\n/**\n * Authenticated `dictionary` 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 dictionaryEndpoint = createEndpoint(getDictionaryAPI);\n"],"mappings":";;;;;;;;AA6BA,MAAM,kBAAkB,EACtB,QAAQ,kBACV;;;;;AAMA,MAAM,sBAAsB;CAC1B,iBAAiB;EAAE,QAAQ;EAAO,MAAM;CAAI;CAC5C,qBAAqB;EAAE,QAAQ;EAAO,MAAM;CAAQ;CACpD,gCAAgC;EAAE,QAAQ;EAAO,MAAM;CAAU;CACjE,uBAAuB;EAAE,QAAQ;EAAO,MAAM;CAAW;CACzD,eAAe;EAAE,QAAQ;EAAO,MAAM;CAAkB;CACxD,eAAe;EAAE,QAAQ;EAAQ,MAAM;CAAI;CAC3C,kBAAkB;EAAE,QAAQ;EAAS,MAAM;CAAI;CAC/C,kBAAkB;EAAE,QAAQ;EAAO,MAAM;CAAiB;CAC1D,kBAAkB;EAAE,QAAQ;EAAU,MAAM;CAAiB;AAC/D;AAEA,MAAa,oBACX,iBAAiC,CAAC,GAClC,mBACG;CACH,MAAM,aACJ,gBAAgB,QAAQ,cAAc,OAAO,cAAc;;;;;CAM7D,MAAM,kBAAkB,OACtB,SACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,YACA,iBACA,oBAAoB,eACtB,GACA,gBACA,cACA;EACE,OAAO;EAEP,QAAQ;CACV,CACF;;;;CAKF,MAAM,sBAAsB,OAAO,eAA+B,CAAC,MACjE,MAAM,QACJ,cACE,YACA,iBACA,oBAAoB,mBACtB,GACA,gBACA,cACA,EACE,OAAO,WACT,CACF;;;;CAKF,MAAM,iCAAiC,OACrC,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,YACA,iBACA,oBAAoB,8BACtB,GACA,gBACA,cACA,EACE,OAAO,WACT,CACF;;;;;;CAOF,MAAM,gBAAgB,OACpB,eACA,SACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,YACA,iBACA,oBAAoB,eACpB,EAAE,cAAc,CAClB,GACA,gBACA,cACA,EACE,QAAQ,UAAU,EAAE,SAAS,QAAQ,SAAS,EAAE,IAAI,OACtD,CACF;;;;;;;;;CAUF,MAAM,wBAAwB,OAC5B,gBACA,SACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,YACA,iBACA,oBAAoB,qBACtB,GACA,gBACA,cACA;EACE,OAAO;EACP,QAAQ;GACN,MAAM,eAAe,KAAK,GAAG;GAC7B,SAAS,SAAS,SAAS;EAC7B;CACF,CACF;;;;;CAMF,MAAM,gBAAgB,OACpB,MACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,YACA,iBACA,oBAAoB,aACtB,GACA,gBACA,cACA;EACE,QAAQ,oBAAoB,cAAc;EAC1C;CACF,CACF;CAEF,MAAM,mBAAmB,OACvB,cACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,YACA,iBACA,oBAAoB,gBACtB,GACA,gBACA,cACA;EACE,QAAQ,oBAAoB,iBAAiB;EAC7C,MAAM,EAAE,aAAa;CACvB,CACF;;;;;CAMF,MAAM,mBAAmB,OACvB,YACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,YACA,iBACA,oBAAoB,kBACpB,EAAE,cAAc,OAAO,WAAW,EAAE,EAAE,CACxC,GACA,gBACA,cACA;EACE,QAAQ,oBAAoB,iBAAiB;EAC7C,MAAM;CACR,CACF;;;;;CAMF,MAAM,mBAAmB,OACvB,IACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cACE,YACA,iBACA,oBAAoB,kBACpB,EAAE,cAAc,OAAO,EAAE,EAAE,CAC7B,GACA,gBACA,cACA,EACE,QAAQ,oBAAoB,iBAAiB,OAC/C,CACF;CAEF,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF;;;;;;;AAQA,MAAa,qBAAqB,eAAe,gBAAgB"}

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

@@ -1 +1 @@
-{"version":3,"file":"editor.mjs","names":[],"sources":["../../../src/getIntlayerAPI/editor.ts"],"sourcesContent":["import { editor } from '@intlayer/config/built';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type {\n  GetConfigurationResult,\n  GetEditorDictionariesResult,\n  WriteContentDeclarationBody,\n  WriteContentDeclarationResult,\n} from 'intlayer-editor';\nimport { createEndpoint } from '../cms/createIntlayerCMS';\nimport { type FetcherOptions, fetcher } from '../fetcher';\n\nexport const getEditorAPI = (\n  authAPIOptions: FetcherOptions = {},\n  intlayerConfig?: IntlayerConfig\n) => {\n  const editorURL = intlayerConfig?.editor?.editorURL ?? editor.editorURL;\n\n  const EDITOR_API_ROUTE = `${editorURL}/api`;\n\n  /**\n   * Get the Intlayer configuration\n   */\n  const getConfiguration = async (\n    otherOptions: FetcherOptions = {}\n  ): Promise<GetConfigurationResult> => {\n    const response = await fetcher<GetConfigurationResult>(\n      `${EDITOR_API_ROUTE}/config`,\n      authAPIOptions,\n      otherOptions\n    );\n\n    return response.data as unknown as GetConfigurationResult;\n  };\n\n  /**\n   * Get the Intlayer configuration\n   */\n  const getDictionaries = async (\n    otherOptions: FetcherOptions = {}\n  ): Promise<GetEditorDictionariesResult> => {\n    const response = await fetcher<GetEditorDictionariesResult>(\n      `${EDITOR_API_ROUTE}/dictionary`,\n      authAPIOptions,\n      otherOptions\n    );\n\n    return response.data as unknown as GetEditorDictionariesResult;\n  };\n\n  /**\n   * Adds a new dictionary to the database.\n   * @param dictionary - Dictionary data.\n   */\n  const writeDictionary = async (\n    body: WriteContentDeclarationBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<WriteContentDeclarationResult>(\n      `${EDITOR_API_ROUTE}/dictionary`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'POST',\n        body,\n      }\n    );\n\n  return {\n    getDictionaries,\n    getConfiguration,\n    writeDictionary,\n  };\n};\n\n/**\n * Authenticated `editor` 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 editorEndpoint = createEndpoint(getEditorAPI);\n"],"mappings":";;;;;AAWA,MAAa,gBACX,iBAAiC,CAAC,GAClC,mBACG;CAGH,MAAM,mBAAmB,GAFP,gBAAgB,QAAQ,aAAa,OAAO,UAExB;;;;CAKtC,MAAM,mBAAmB,OACvB,eAA+B,CAAC,MACI;EAOpC,QAAO,MANgB,QACrB,GAAG,iBAAiB,UACpB,gBACA,YACF,EAEe,CAAC;CAClB;;;;CAKA,MAAM,kBAAkB,OACtB,eAA+B,CAAC,MACS;EAOzC,QAAO,MANgB,QACrB,GAAG,iBAAiB,cACpB,gBACA,YACF,EAEe,CAAC;CAClB;;;;;CAMA,MAAM,kBAAkB,OACtB,MACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,iBAAiB,cACpB,gBACA,cACA;EACE,QAAQ;EACR;CACF,CACF;CAEF,OAAO;EACL;EACA;EACA;CACF;AACF;;;;;;;AAQA,MAAa,iBAAiB,eAAe,YAAY"}
+{"version":3,"file":"editor.mjs","names":[],"sources":["../../../src/getIntlayerAPI/editor.ts"],"sourcesContent":["import { editor } from '@intlayer/config/built';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type {\n  GetConfigurationResult,\n  GetEditorDictionariesResult,\n  WriteContentDeclarationBody,\n  WriteContentDeclarationResult,\n} from 'intlayer-editor';\n\nexport type {\n  GetConfigurationResult,\n  GetEditorDictionariesResult,\n  WriteContentDeclarationBody,\n  WriteContentDeclarationResult,\n};\n\nimport { createEndpoint } from '../cms/createIntlayerCMS';\nimport { type FetcherOptions, fetcher } from '../fetcher';\n\nexport const getEditorAPI = (\n  authAPIOptions: FetcherOptions = {},\n  intlayerConfig?: IntlayerConfig\n) => {\n  const editorURL = intlayerConfig?.editor?.editorURL ?? editor.editorURL;\n\n  const EDITOR_API_ROUTE = `${editorURL}/api`;\n\n  /**\n   * Get the Intlayer configuration\n   */\n  const getConfiguration = async (\n    otherOptions: FetcherOptions = {}\n  ): Promise<GetConfigurationResult> => {\n    const response = await fetcher<GetConfigurationResult>(\n      `${EDITOR_API_ROUTE}/config`,\n      authAPIOptions,\n      otherOptions\n    );\n\n    return response.data as unknown as GetConfigurationResult;\n  };\n\n  /**\n   * Get the Intlayer configuration\n   */\n  const getDictionaries = async (\n    otherOptions: FetcherOptions = {}\n  ): Promise<GetEditorDictionariesResult> => {\n    const response = await fetcher<GetEditorDictionariesResult>(\n      `${EDITOR_API_ROUTE}/dictionary`,\n      authAPIOptions,\n      otherOptions\n    );\n\n    return response.data as unknown as GetEditorDictionariesResult;\n  };\n\n  /**\n   * Adds a new dictionary to the database.\n   * @param dictionary - Dictionary data.\n   */\n  const writeDictionary = async (\n    body: WriteContentDeclarationBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<WriteContentDeclarationResult>(\n      `${EDITOR_API_ROUTE}/dictionary`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'POST',\n        body,\n      }\n    );\n\n  return {\n    getDictionaries,\n    getConfiguration,\n    writeDictionary,\n  };\n};\n\n/**\n * Authenticated `editor` 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 editorEndpoint = createEndpoint(getEditorAPI);\n"],"mappings":";;;;;AAmBA,MAAa,gBACX,iBAAiC,CAAC,GAClC,mBACG;CAGH,MAAM,mBAAmB,GAFP,gBAAgB,QAAQ,aAAa,OAAO,UAExB;;;;CAKtC,MAAM,mBAAmB,OACvB,eAA+B,CAAC,MACI;EAOpC,QAAO,MANgB,QACrB,GAAG,iBAAiB,UACpB,gBACA,YACF,EAEe,CAAC;CAClB;;;;CAKA,MAAM,kBAAkB,OACtB,eAA+B,CAAC,MACS;EAOzC,QAAO,MANgB,QACrB,GAAG,iBAAiB,cACpB,gBACA,YACF,EAEe,CAAC;CAClB;;;;;CAMA,MAAM,kBAAkB,OACtB,MACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,iBAAiB,cACpB,gBACA,cACA;EACE,QAAQ;EACR;CACF,CACF;CAEF,OAAO;EACL;EACA;EACA;CACF;AACF;;;;;;;AAQA,MAAa,iBAAiB,eAAe,YAAY"}

package/dist/esm/getIntlayerAPI/environment.mjs

@@ -1,23 +1,57 @@
 import { fetcher } from "../fetcher.mjs";
 import { createEndpoint } from "../cms/createIntlayerCMS.mjs";
 import { editor } from "@intlayer/config/built";
+import { buildRouteURL } from "@intlayer/backend-contract/defineRoute";
+import { BACKEND_URL } from "@intlayer/config/defaultValues";
 
 //#region src/getIntlayerAPI/environment.ts
-const getEnvironmentAPI = (authAPIOptions = {}, intlayerConfig) => {
-	const ENVIRONMENT_API_ROUTE = `${intlayerConfig?.editor?.backendURL ?? editor.backendURL}/api/project/environment`;
-	const addEnvironment = async (body, otherOptions = {}) => await fetcher(ENVIRONMENT_API_ROUTE, authAPIOptions, otherOptions, {
+/** Prefix of the routes, checked against the backend contract. */
+const environmentGroup = { prefix: "/api/project/environment" };
+/**
+* Method and path of every route, checked against the backend contract at
+* compile time (the contract's zod schemas are never loaded).
+*/
+const environmentEndpoints = {
+	addEnvironment: {
 		method: "POST",
+		path: "/"
+	},
+	updateEnvironment: {
+		method: "PUT",
+		path: "/:environmentId"
+	},
+	deleteEnvironment: {
+		method: "DELETE",
+		path: "/:environmentId"
+	},
+	resetToProductionEnvironment: {
+		method: "PUT",
+		path: "/production/select"
+	},
+	selectEnvironment: {
+		method: "PUT",
+		path: "/:environmentId/select"
+	},
+	migrateEnvironment: {
+		method: "POST",
+		path: "/migrate"
+	}
+};
+const getEnvironmentAPI = (authAPIOptions = {}, intlayerConfig) => {
+	const backendURL = intlayerConfig?.editor?.backendURL ?? editor.backendURL ?? BACKEND_URL;
+	const addEnvironment = async (body, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, environmentGroup, environmentEndpoints.addEnvironment), authAPIOptions, otherOptions, {
+		method: environmentEndpoints.addEnvironment.method,
 		body
 	});
-	const updateEnvironment = async (environmentId, body, otherOptions = {}) => await fetcher(`${ENVIRONMENT_API_ROUTE}/${environmentId}`, authAPIOptions, otherOptions, {
-		method: "PUT",
+	const updateEnvironment = async (environmentId, body, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, environmentGroup, environmentEndpoints.updateEnvironment, { environmentId }), authAPIOptions, otherOptions, {
+		method: environmentEndpoints.updateEnvironment.method,
 		body
 	});
-	const deleteEnvironment = async (environmentId, otherOptions = {}) => await fetcher(`${ENVIRONMENT_API_ROUTE}/${environmentId}`, authAPIOptions, otherOptions, { method: "DELETE" });
-	const selectEnvironment = async (environmentId, otherOptions = {}) => await fetcher(`${ENVIRONMENT_API_ROUTE}/${environmentId}/select`, authAPIOptions, otherOptions, { method: "PUT" });
-	const resetToProductionEnvironment = async (otherOptions = {}) => await fetcher(`${ENVIRONMENT_API_ROUTE}/production/select`, authAPIOptions, otherOptions, { method: "PUT" });
-	const migrateEnvironment = async (body, otherOptions = {}) => await fetcher(`${ENVIRONMENT_API_ROUTE}/migrate`, authAPIOptions, otherOptions, {
-		method: "POST",
+	const deleteEnvironment = async (environmentId, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, environmentGroup, environmentEndpoints.deleteEnvironment, { environmentId }), authAPIOptions, otherOptions, { method: environmentEndpoints.deleteEnvironment.method });
+	const selectEnvironment = async (environmentId, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, environmentGroup, environmentEndpoints.selectEnvironment, { environmentId }), authAPIOptions, otherOptions, { method: environmentEndpoints.selectEnvironment.method });
+	const resetToProductionEnvironment = async (otherOptions = {}) => await fetcher(buildRouteURL(backendURL, environmentGroup, environmentEndpoints.resetToProductionEnvironment), authAPIOptions, otherOptions, { method: environmentEndpoints.resetToProductionEnvironment.method });
+	const migrateEnvironment = async (body, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, environmentGroup, environmentEndpoints.migrateEnvironment), authAPIOptions, otherOptions, {
+		method: environmentEndpoints.migrateEnvironment.method,
 		body
 	});
 	return {