@intlayer/api 9.6.0 → 9.7.1

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

@@ -1 +1 @@
-{"version":3,"file":"analytics.mjs","names":[],"sources":["../../../src/getIntlayerAPI/analytics.ts"],"sourcesContent":["import type {\n  AudienceRange,\n  GetAnalyticsOverviewResult,\n  GetAudienceResult,\n  GetContentStatsResult,\n  GetExperimentResultsResult,\n  GetPageMetadataResult,\n  IngestAnalyticsBody,\n  IngestAnalyticsResult,\n} from '@intlayer/backend';\nimport { editor } from '@intlayer/config/built';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { createEndpoint } from '../cms/createIntlayerCMS';\nimport { type FetcherOptions, fetcher } from '../fetcher';\n\nexport const getAnalyticsAPI = (\n  authAPIOptions: FetcherOptions = {},\n  intlayerConfig?: IntlayerConfig\n) => {\n  const backendURL = intlayerConfig?.editor?.backendURL ?? editor.backendURL;\n\n  const ANALYTICS_API_ROUTE = `${backendURL}/api/analytics`;\n\n  /**\n   * Ingest a batch of analytics events. Public — attribution is by the\n   * project's `clientId` in the body.\n   * @param body - Session id, sdk version, and the collected events.\n   * @returns The number of accepted events.\n   */\n  const sendEvents = async (\n    body: IngestAnalyticsBody,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<IngestAnalyticsResult>(\n      `${ANALYTICS_API_ROUTE}/events`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'POST',\n        body,\n      }\n    );\n\n  /**\n   * Page/locale totals for the authenticated project.\n   * @returns Views grouped by url and locale.\n   */\n  const getOverview = async (otherOptions: FetcherOptions = {}) =>\n    await fetcher<GetAnalyticsOverviewResult>(\n      `${ANALYTICS_API_ROUTE}/overview`,\n      authAPIOptions,\n      otherOptions,\n      { method: 'GET' }\n    );\n\n  /**\n   * Audience report: distinct visitors (today / 7d / window), page views, the\n   * evolution series, and locale + country breakdowns.\n   * @param range - Rolling window, either a named range (`1h`, `24h`, `7d`,\n   *   `30d`, `90d`, `6mo`, `1y`, `3y`) or a number of days (default 30).\n   * @returns The audience statistics.\n   */\n  const getAudience = async (\n    range: AudienceRange | number = 30,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetAudienceResult>(\n      `${ANALYTICS_API_ROUTE}/audience`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'GET',\n        params: typeof range === 'number' ? { days: String(range) } : { range },\n      }\n    );\n\n  /**\n   * Per-content exposure totals — \"which content is actually shown\".\n   * @returns Exposures grouped by dictionary key, key path, and locale.\n   */\n  const getContentStats = async (otherOptions: FetcherOptions = {}) =>\n    await fetcher<GetContentStatsResult>(\n      `${ANALYTICS_API_ROUTE}/content-stats`,\n      authAPIOptions,\n      otherOptions,\n      { method: 'GET' }\n    );\n\n  /**\n   * A/B experiment results with per-variant conversion rates and significance.\n   * @param experimentKey - The experiment to evaluate.\n   * @returns The experiment result set.\n   */\n  const getExperimentResults = async (\n    experimentKey: string,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetExperimentResultsResult>(\n      `${ANALYTICS_API_ROUTE}/experiments/${experimentKey}`,\n      authAPIOptions,\n      otherOptions,\n      { method: 'GET' }\n    );\n\n  /**\n   * Page metadata (title and meta description) for a given url.\n   * @param url - The page url to inspect.\n   * @returns Title and description of the page.\n   */\n  const getPageMetadata = async (\n    url: string,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetPageMetadataResult>(\n      `${ANALYTICS_API_ROUTE}/page-metadata`,\n      authAPIOptions,\n      otherOptions,\n      {\n        method: 'GET',\n        params: { url },\n      }\n    );\n\n  return {\n    sendEvents,\n    getOverview,\n    getAudience,\n    getContentStats,\n    getExperimentResults,\n    getPageMetadata,\n  };\n};\n\n/**\n * Authenticated `analytics` endpoint bound to an Intlayer CMS authenticator.\n *\n * Pass an authenticator created with `createIntlayerCMS`, or omit it to use\n * the build-time configuration (`@intlayer/config/built`).\n */\nexport const analyticsEndpoint = createEndpoint(getAnalyticsAPI);\n"],"mappings":";;;;;AAeA,MAAa,mBACX,iBAAiC,CAAC,GAClC,mBACG;CAGH,MAAM,sBAAsB,GAFT,gBAAgB,QAAQ,cAAc,OAAO,WAEtB;;;;;;;CAQ1C,MAAM,aAAa,OACjB,MACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,oBAAoB,UACvB,gBACA,cACA;EACE,QAAQ;EACR;CACF,CACF;;;;;CAMF,MAAM,cAAc,OAAO,eAA+B,CAAC,MACzD,MAAM,QACJ,GAAG,oBAAoB,YACvB,gBACA,cACA,EAAE,QAAQ,MAAM,CAClB;;;;;;;;CASF,MAAM,cAAc,OAClB,QAAgC,IAChC,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,oBAAoB,YACvB,gBACA,cACA;EACE,QAAQ;EACR,QAAQ,OAAO,UAAU,WAAW,EAAE,MAAM,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM;CACxE,CACF;;;;;CAMF,MAAM,kBAAkB,OAAO,eAA+B,CAAC,MAC7D,MAAM,QACJ,GAAG,oBAAoB,iBACvB,gBACA,cACA,EAAE,QAAQ,MAAM,CAClB;;;;;;CAOF,MAAM,uBAAuB,OAC3B,eACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,oBAAoB,eAAe,iBACtC,gBACA,cACA,EAAE,QAAQ,MAAM,CAClB;;;;;;CAOF,MAAM,kBAAkB,OACtB,KACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,oBAAoB,iBACvB,gBACA,cACA;EACE,QAAQ;EACR,QAAQ,EAAE,IAAI;CAChB,CACF;CAEF,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;CACF;AACF;;;;;;;AAQA,MAAa,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  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"}

package/dist/esm/getIntlayerAPI/asset.mjs

@@ -1,17 +1,47 @@
-import { fetcher } from "../fetcher.mjs";
 import { createEndpoint } from "../cms/createIntlayerCMS.mjs";
+import { fetcher } from "../fetcher.mjs";
 import { editor } from "@intlayer/config/built";
+import { buildRouteURL } from "@intlayer/backend-contract/defineRoute";
+import { BACKEND_URL } from "@intlayer/config/defaultValues";
 
-//#region src/getIntlayerAPI/asset.ts
+// src/getIntlayerAPI/asset.ts
+/** Prefix of the routes, checked against the backend contract. */
+const assetGroup = { prefix: "/api/assets" };
+/**
+* Method and path of every route, checked against the backend contract at
+* compile time (the contract's zod schemas are never loaded).
+*/
+const assetEndpoints = {
+	getAssets: {
+		method: "GET",
+		path: "/"
+	},
+	getAssetById: {
+		method: "GET",
+		path: "/:assetId"
+	},
+	uploadAsset: {
+		method: "POST",
+		path: "/"
+	},
+	updateAsset: {
+		method: "PATCH",
+		path: "/:assetId"
+	},
+	deleteAsset: {
+		method: "DELETE",
+		path: "/:assetId"
+	}
+};
 const getAssetAPI = (authAPIOptions = {}, intlayerConfig) => {
-	const ASSET_API_ROUTE = `${intlayerConfig?.editor?.backendURL ?? editor.backendURL}/api/assets`;
+	const backendURL = intlayerConfig?.editor?.backendURL ?? editor.backendURL ?? BACKEND_URL;
 	/**
 	* Retrieves all assets for the current session project, paginated.
 	* @param page - Page number (1-based).
 	* @param pageSize - Number of items per page.
 	* @returns Paginated list of assets.
 	*/
-	const getAssets = async (page, pageSize, otherOptions = {}) => await fetcher(ASSET_API_ROUTE, authAPIOptions, otherOptions, {
+	const getAssets = async (page, pageSize, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, assetGroup, assetEndpoints.getAssets), authAPIOptions, otherOptions, {
 		cache: "no-store",
 		params: {
 			...page !== void 0 && { page: String(page) },
@@ -23,7 +53,7 @@ const getAssetAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* @param assetId - The asset document ID.
 	* @returns The asset.
 	*/
-	const getAssetById = async (assetId, otherOptions = {}) => await fetcher(`${ASSET_API_ROUTE}/${assetId}`, authAPIOptions, otherOptions, { cache: "no-store" });
+	const getAssetById = async (assetId, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, assetGroup, assetEndpoints.getAssetById, { assetId: String(assetId) }), authAPIOptions, otherOptions, { cache: "no-store" });
 	/**
 	* Uploads a new asset image.
 	* @param file - The image File object.
@@ -40,8 +70,8 @@ const getAssetAPI = (authAPIOptions = {}, intlayerConfig) => {
 		if (alt) headers["X-Alt-Text"] = alt;
 		if (caption) headers["X-Caption"] = caption;
 		const authHeaders = authAPIOptions.headers ?? {};
-		const response = await fetch(ASSET_API_ROUTE, {
-			method: "POST",
+		const response = await fetch(buildRouteURL(backendURL, assetGroup, assetEndpoints.uploadAsset), {
+			method: assetEndpoints.uploadAsset.method,
 			credentials: "include",
 			headers: {
 				...authHeaders,
@@ -62,8 +92,8 @@ const getAssetAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* @param data - Fields to update.
 	* @returns The updated asset record.
 	*/
-	const updateAsset = async (assetId, data, otherOptions = {}) => await fetcher(`${ASSET_API_ROUTE}/${assetId}`, authAPIOptions, otherOptions, {
-		method: "PATCH",
+	const updateAsset = async (assetId, data, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, assetGroup, assetEndpoints.updateAsset, { assetId: String(assetId) }), authAPIOptions, otherOptions, {
+		method: assetEndpoints.updateAsset.method,
 		body: data
 	});
 	/**
@@ -71,7 +101,7 @@ const getAssetAPI = (authAPIOptions = {}, intlayerConfig) => {
 	* @param assetId - The asset document ID.
 	* @returns Confirmation response.
 	*/
-	const deleteAsset = async (assetId, otherOptions = {}) => await fetcher(`${ASSET_API_ROUTE}/${assetId}`, authAPIOptions, otherOptions, { method: "DELETE" });
+	const deleteAsset = async (assetId, otherOptions = {}) => await fetcher(buildRouteURL(backendURL, assetGroup, assetEndpoints.deleteAsset, { assetId: String(assetId) }), authAPIOptions, otherOptions, { method: assetEndpoints.deleteAsset.method });
 	return {
 		getAssets,
 		getAssetById,
@@ -88,6 +118,5 @@ const getAssetAPI = (authAPIOptions = {}, intlayerConfig) => {
 */
 const assetEndpoint = createEndpoint(getAssetAPI);
 
-//#endregion
 export { assetEndpoint, getAssetAPI };
 //# sourceMappingURL=asset.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"asset.mjs","names":[],"sources":["../../../src/getIntlayerAPI/asset.ts"],"sourcesContent":["import type {\n  DeleteAssetResult,\n  GetAssetByIdResult,\n  GetAssetsResult,\n  UpdateAssetResult,\n  UploadAssetResult,\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 getAssetAPI = (\n  authAPIOptions: FetcherOptions = {},\n  intlayerConfig?: IntlayerConfig\n) => {\n  const backendURL = intlayerConfig?.editor?.backendURL ?? editor.backendURL;\n\n  const ASSET_API_ROUTE = `${backendURL}/api/assets`;\n\n  /**\n   * Retrieves all assets for the current session project, paginated.\n   * @param page - Page number (1-based).\n   * @param pageSize - Number of items per page.\n   * @returns Paginated list of assets.\n   */\n  const getAssets = async (\n    page?: number,\n    pageSize?: number,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetAssetsResult>(\n      ASSET_API_ROUTE,\n      authAPIOptions,\n      otherOptions,\n      {\n        cache: 'no-store',\n        params: {\n          ...(page !== undefined && { page: String(page) }),\n          ...(pageSize !== undefined && { pageSize: String(pageSize) }),\n        },\n      }\n    );\n\n  /**\n   * Retrieves a single asset by ID.\n   * @param assetId - The asset document ID.\n   * @returns The asset.\n   */\n  const getAssetById = async (\n    assetId: string,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetAssetByIdResult>(\n      `${ASSET_API_ROUTE}/${assetId}`,\n      authAPIOptions,\n      otherOptions,\n      { cache: 'no-store' }\n    );\n\n  /**\n   * Uploads a new asset image.\n   * @param file - The image File object.\n   * @param alt - Optional alt text.\n   * @param caption - Optional caption.\n   * @returns The created asset record with its public URL.\n   */\n  const uploadAsset = async (\n    file: File,\n    alt?: string,\n    caption?: string,\n    otherOptions: FetcherOptions = {}\n  ) => {\n    const buffer = await file.arrayBuffer();\n\n    const headers: Record<string, string> = {\n      'Content-Type': file.type || 'image/jpeg',\n      'X-File-Name': file.name,\n    };\n\n    if (alt) headers['X-Alt-Text'] = alt;\n    if (caption) headers['X-Caption'] = caption;\n\n    const authHeaders =\n      (authAPIOptions.headers as Record<string, string> | undefined) ?? {};\n\n    const response = await fetch(ASSET_API_ROUTE, {\n      method: 'POST',\n      credentials: 'include',\n      headers: { ...authHeaders, ...headers },\n      body: buffer,\n      signal: otherOptions.signal as AbortSignal | undefined,\n    });\n\n    if (!response.ok) {\n      const result = await response.json();\n      throw new Error(JSON.stringify(result.error) ?? 'Asset upload failed');\n    }\n\n    return (await response.json()) as UploadAssetResult;\n  };\n\n  /**\n   * Updates mutable metadata (name, alt text, caption) of an asset.\n   * @param assetId - The asset document ID.\n   * @param data - Fields to update.\n   * @returns The updated asset record.\n   */\n  const updateAsset = async (\n    assetId: string,\n    data: { originalName?: string; alt?: string; caption?: string },\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<UpdateAssetResult>(\n      `${ASSET_API_ROUTE}/${assetId}`,\n      authAPIOptions,\n      otherOptions,\n      { method: 'PATCH', body: data as unknown as Record<string, unknown> }\n    );\n\n  /**\n   * Deletes an asset by ID.\n   * @param assetId - The asset document ID.\n   * @returns Confirmation response.\n   */\n  const deleteAsset = async (\n    assetId: string,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<DeleteAssetResult>(\n      `${ASSET_API_ROUTE}/${assetId}`,\n      authAPIOptions,\n      otherOptions,\n      { method: 'DELETE' }\n    );\n\n  return {\n    getAssets,\n    getAssetById,\n    uploadAsset,\n    updateAsset,\n    deleteAsset,\n  };\n};\n\n/**\n * Authenticated `asset` 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 assetEndpoint = createEndpoint(getAssetAPI);\n"],"mappings":";;;;;AAYA,MAAa,eACX,iBAAiC,CAAC,GAClC,mBACG;CAGH,MAAM,kBAAkB,GAFL,gBAAgB,QAAQ,cAAc,OAAO,WAE1B;;;;;;;CAQtC,MAAM,YAAY,OAChB,MACA,UACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,iBACA,gBACA,cACA;EACE,OAAO;EACP,QAAQ;GACN,GAAI,SAAS,UAAa,EAAE,MAAM,OAAO,IAAI,EAAE;GAC/C,GAAI,aAAa,UAAa,EAAE,UAAU,OAAO,QAAQ,EAAE;EAC7D;CACF,CACF;;;;;;CAOF,MAAM,eAAe,OACnB,SACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,gBAAgB,GAAG,WACtB,gBACA,cACA,EAAE,OAAO,WAAW,CACtB;;;;;;;;CASF,MAAM,cAAc,OAClB,MACA,KACA,SACA,eAA+B,CAAC,MAC7B;EACH,MAAM,SAAS,MAAM,KAAK,YAAY;EAEtC,MAAM,UAAkC;GACtC,gBAAgB,KAAK,QAAQ;GAC7B,eAAe,KAAK;EACtB;EAEA,IAAI,KAAK,QAAQ,gBAAgB;EACjC,IAAI,SAAS,QAAQ,eAAe;EAEpC,MAAM,cACH,eAAe,WAAkD,CAAC;EAErE,MAAM,WAAW,MAAM,MAAM,iBAAiB;GAC5C,QAAQ;GACR,aAAa;GACb,SAAS;IAAE,GAAG;IAAa,GAAG;GAAQ;GACtC,MAAM;GACN,QAAQ,aAAa;EACvB,CAAC;EAED,IAAI,CAAC,SAAS,IAAI;GAChB,MAAM,SAAS,MAAM,SAAS,KAAK;GACnC,MAAM,IAAI,MAAM,KAAK,UAAU,OAAO,KAAK,KAAK,qBAAqB;EACvE;EAEA,OAAQ,MAAM,SAAS,KAAK;CAC9B;;;;;;;CAQA,MAAM,cAAc,OAClB,SACA,MACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,gBAAgB,GAAG,WACtB,gBACA,cACA;EAAE,QAAQ;EAAS,MAAM;CAA2C,CACtE;;;;;;CAOF,MAAM,cAAc,OAClB,SACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,GAAG,gBAAgB,GAAG,WACtB,gBACA,cACA,EAAE,QAAQ,SAAS,CACrB;CAEF,OAAO;EACL;EACA;EACA;EACA;EACA;CACF;AACF;;;;;;;AAQA,MAAa,gBAAgB,eAAe,WAAW"}
+{"version":3,"file":"asset.mjs","names":[],"sources":["../../../src/getIntlayerAPI/asset.ts"],"sourcesContent":["import type {\n  AssetRoutes,\n  assetContract,\n  DeleteAssetResult,\n  GetAssetByIdResult,\n  GetAssetsResult,\n  UpdateAssetResult,\n  UploadAssetResult,\n} from '@intlayer/backend-contract/asset';\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 assetGroup = {\n  prefix: '/api/assets',\n} as const satisfies Pick<typeof assetContract, '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 assetEndpoints = {\n  getAssets: { method: 'GET', path: '/' },\n  getAssetById: { method: 'GET', path: '/:assetId' },\n  uploadAsset: { method: 'POST', path: '/' },\n  updateAsset: { method: 'PATCH', path: '/:assetId' },\n  deleteAsset: { method: 'DELETE', path: '/:assetId' },\n} as const satisfies RouteEndpoints<AssetRoutes>;\n\nexport const getAssetAPI = (\n  authAPIOptions: FetcherOptions = {},\n  intlayerConfig?: IntlayerConfig\n) => {\n  const backendURL =\n    intlayerConfig?.editor?.backendURL ?? editor.backendURL ?? BACKEND_URL;\n\n  /**\n   * Retrieves all assets for the current session project, paginated.\n   * @param page - Page number (1-based).\n   * @param pageSize - Number of items per page.\n   * @returns Paginated list of assets.\n   */\n  const getAssets = async (\n    page?: number,\n    pageSize?: number,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetAssetsResult>(\n      buildRouteURL(backendURL, assetGroup, assetEndpoints.getAssets),\n      authAPIOptions,\n      otherOptions,\n      {\n        cache: 'no-store',\n        params: {\n          ...(page !== undefined && { page: String(page) }),\n          ...(pageSize !== undefined && { pageSize: String(pageSize) }),\n        },\n      }\n    );\n\n  /**\n   * Retrieves a single asset by ID.\n   * @param assetId - The asset document ID.\n   * @returns The asset.\n   */\n  const getAssetById = async (\n    assetId: string,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<GetAssetByIdResult>(\n      buildRouteURL(backendURL, assetGroup, assetEndpoints.getAssetById, {\n        assetId: String(assetId),\n      }),\n      authAPIOptions,\n      otherOptions,\n      { cache: 'no-store' }\n    );\n\n  /**\n   * Uploads a new asset image.\n   * @param file - The image File object.\n   * @param alt - Optional alt text.\n   * @param caption - Optional caption.\n   * @returns The created asset record with its public URL.\n   */\n  const uploadAsset = async (\n    file: File,\n    alt?: string,\n    caption?: string,\n    otherOptions: FetcherOptions = {}\n  ) => {\n    const buffer = await file.arrayBuffer();\n\n    const headers: Record<string, string> = {\n      'Content-Type': file.type || 'image/jpeg',\n      'X-File-Name': file.name,\n    };\n\n    if (alt) headers['X-Alt-Text'] = alt;\n    if (caption) headers['X-Caption'] = caption;\n\n    const authHeaders =\n      (authAPIOptions.headers as Record<string, string> | undefined) ?? {};\n\n    const response = await fetch(\n      buildRouteURL(backendURL, assetGroup, assetEndpoints.uploadAsset),\n      {\n        method: assetEndpoints.uploadAsset.method,\n        credentials: 'include',\n        headers: { ...authHeaders, ...headers },\n        body: buffer,\n        signal: otherOptions.signal as AbortSignal | undefined,\n      }\n    );\n\n    if (!response.ok) {\n      const result = await response.json();\n      throw new Error(JSON.stringify(result.error) ?? 'Asset upload failed');\n    }\n\n    return (await response.json()) as UploadAssetResult;\n  };\n\n  /**\n   * Updates mutable metadata (name, alt text, caption) of an asset.\n   * @param assetId - The asset document ID.\n   * @param data - Fields to update.\n   * @returns The updated asset record.\n   */\n  const updateAsset = async (\n    assetId: string,\n    data: { originalName?: string; alt?: string; caption?: string },\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<UpdateAssetResult>(\n      buildRouteURL(backendURL, assetGroup, assetEndpoints.updateAsset, {\n        assetId: String(assetId),\n      }),\n      authAPIOptions,\n      otherOptions,\n      {\n        method: assetEndpoints.updateAsset.method,\n        body: data as unknown as Record<string, unknown>,\n      }\n    );\n\n  /**\n   * Deletes an asset by ID.\n   * @param assetId - The asset document ID.\n   * @returns Confirmation response.\n   */\n  const deleteAsset = async (\n    assetId: string,\n    otherOptions: FetcherOptions = {}\n  ) =>\n    await fetcher<DeleteAssetResult>(\n      buildRouteURL(backendURL, assetGroup, assetEndpoints.deleteAsset, {\n        assetId: String(assetId),\n      }),\n      authAPIOptions,\n      otherOptions,\n      { method: assetEndpoints.deleteAsset.method }\n    );\n\n  return {\n    getAssets,\n    getAssetById,\n    uploadAsset,\n    updateAsset,\n    deleteAsset,\n  };\n};\n\n/**\n * Authenticated `asset` 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 assetEndpoint = createEndpoint(getAssetAPI);\n"],"mappings":";;;;;;;;AAkBA,MAAM,aAAa,EACjB,QAAQ,cACV;;;;;AAMA,MAAM,iBAAiB;CACrB,WAAW;EAAE,QAAQ;EAAO,MAAM;CAAI;CACtC,cAAc;EAAE,QAAQ;EAAO,MAAM;CAAY;CACjD,aAAa;EAAE,QAAQ;EAAQ,MAAM;CAAI;CACzC,aAAa;EAAE,QAAQ;EAAS,MAAM;CAAY;CAClD,aAAa;EAAE,QAAQ;EAAU,MAAM;CAAY;AACrD;AAEA,MAAa,eACX,iBAAiC,CAAC,GAClC,mBACG;CACH,MAAM,aACJ,gBAAgB,QAAQ,cAAc,OAAO,cAAc;;;;;;;CAQ7D,MAAM,YAAY,OAChB,MACA,UACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,YAAY,eAAe,SAAS,GAC9D,gBACA,cACA;EACE,OAAO;EACP,QAAQ;GACN,GAAI,SAAS,UAAa,EAAE,MAAM,OAAO,IAAI,EAAE;GAC/C,GAAI,aAAa,UAAa,EAAE,UAAU,OAAO,QAAQ,EAAE;EAC7D;CACF,CACF;;;;;;CAOF,MAAM,eAAe,OACnB,SACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,YAAY,eAAe,cAAc,EACjE,SAAS,OAAO,OAAO,EACzB,CAAC,GACD,gBACA,cACA,EAAE,OAAO,WAAW,CACtB;;;;;;;;CASF,MAAM,cAAc,OAClB,MACA,KACA,SACA,eAA+B,CAAC,MAC7B;EACH,MAAM,SAAS,MAAM,KAAK,YAAY;EAEtC,MAAM,UAAkC;GACtC,gBAAgB,KAAK,QAAQ;GAC7B,eAAe,KAAK;EACtB;EAEA,IAAI,KAAK,QAAQ,gBAAgB;EACjC,IAAI,SAAS,QAAQ,eAAe;EAEpC,MAAM,cACH,eAAe,WAAkD,CAAC;EAErE,MAAM,WAAW,MAAM,MACrB,cAAc,YAAY,YAAY,eAAe,WAAW,GAChE;GACE,QAAQ,eAAe,YAAY;GACnC,aAAa;GACb,SAAS;IAAE,GAAG;IAAa,GAAG;GAAQ;GACtC,MAAM;GACN,QAAQ,aAAa;EACvB,CACF;EAEA,IAAI,CAAC,SAAS,IAAI;GAChB,MAAM,SAAS,MAAM,SAAS,KAAK;GACnC,MAAM,IAAI,MAAM,KAAK,UAAU,OAAO,KAAK,KAAK,qBAAqB;EACvE;EAEA,OAAQ,MAAM,SAAS,KAAK;CAC9B;;;;;;;CAQA,MAAM,cAAc,OAClB,SACA,MACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,YAAY,eAAe,aAAa,EAChE,SAAS,OAAO,OAAO,EACzB,CAAC,GACD,gBACA,cACA;EACE,QAAQ,eAAe,YAAY;EACnC,MAAM;CACR,CACF;;;;;;CAOF,MAAM,cAAc,OAClB,SACA,eAA+B,CAAC,MAEhC,MAAM,QACJ,cAAc,YAAY,YAAY,eAAe,aAAa,EAChE,SAAS,OAAO,OAAO,EACzB,CAAC,GACD,gBACA,cACA,EAAE,QAAQ,eAAe,YAAY,OAAO,CAC9C;CAEF,OAAO;EACL;EACA;EACA;EACA;EACA;CACF;AACF;;;;;;;AAQA,MAAa,gBAAgB,eAAe,WAAW"}

package/dist/esm/getIntlayerAPI/audit.mjs

@@ -1,10 +1,64 @@
-import { fetcher } from "../fetcher.mjs";
 import { createEndpoint } from "../cms/createIntlayerCMS.mjs";
+import { fetcher } from "../fetcher.mjs";
 import { editor } from "@intlayer/config/built";
+import { buildRouteURL } from "@intlayer/backend-contract/defineRoute";
+import { BACKEND_URL } from "@intlayer/config/defaultValues";
 
-//#region src/getIntlayerAPI/audit.ts
+// src/getIntlayerAPI/audit.ts
+/** Prefix of the routes, checked against the backend contract. */
+const scanGroup = { prefix: "/api/scan" };
+/**
+* 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,
@@ -122,6 +176,5 @@ const getAuditAPI = (authAPIOptions = {}, intlayerConfig) => {
 */
 const auditEndpoint = createEndpoint(getAuditAPI);
 
-//#endregion
 export { auditEndpoint, getAuditAPI };
 //# sourceMappingURL=audit.mjs.map

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":"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"}
+{"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":"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"}

package/dist/esm/getIntlayerAPI/bitbucket.mjs

@@ -1,28 +1,58 @@
-import { fetcher } from "../fetcher.mjs";
 import { createEndpoint } from "../cms/createIntlayerCMS.mjs";
+import { fetcher } from "../fetcher.mjs";
 import { editor } from "@intlayer/config/built";
+import { buildRouteURL } from "@intlayer/backend-contract/defineRoute";
+import { BACKEND_URL } from "@intlayer/config/defaultValues";
 
-//#region src/getIntlayerAPI/bitbucket.ts
+// src/getIntlayerAPI/bitbucket.ts
+/** Prefix of the routes, checked against the backend contract. */
+const bitbucketGroup = { prefix: "/api/bitbucket" };
+/**
+* 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,
@@ -73,6 +103,5 @@ const getBitbucketAPI = (authAPIOptions = {}, intlayerConfig) => {
 */
 const bitbucketEndpoint = createEndpoint(getBitbucketAPI);
 
-//#endregion
 export { bitbucketEndpoint, getBitbucketAPI };
 //# sourceMappingURL=bitbucket.mjs.map

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,18 @@
+import { createEndpoint } from "../cms/createIntlayerCMS.mjs";
+import { createForgeAPI } from "./forge.mjs";
+
+// 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);
+
+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"}