@yoryoboy/bi-mcp 1.0.1

package/dist/src/services/search-console/search-console-client.js

@@ -0,0 +1,45 @@
+import { refreshGoogleAccessToken } from "../analytics/oauth.js";
+const SEARCH_CONSOLE_BASE_URL = "https://www.googleapis.com/webmasters/v3";
+async function googleApiFetch(url, init) {
+  const accessToken = await refreshGoogleAccessToken();
+  const response = await fetch(url, {
+    ...init,
+    headers: {
+      Authorization: `Bearer ${accessToken.accessToken}`,
+      "Content-Type": "application/json",
+      ...init?.headers ?? {}
+    }
+  });
+  if (!response.ok) {
+    const payload = await response.json().catch(() => ({}));
+    const message = payload.error?.message ?? payload.error?.status ?? `Google Search Console API request failed with status ${response.status}`;
+    const normalizedMessage = message.toLowerCase();
+    if (response.status === 403 && normalizedMessage.includes("insufficient authentication scopes")) {
+      throw new Error(
+        "Request had insufficient authentication scopes. Reconnect the Google OAuth credentials with Search Console scope https://www.googleapis.com/auth/webmasters.readonly or https://www.googleapis.com/auth/webmasters."
+      );
+    }
+    throw new Error(message);
+  }
+  return await response.json();
+}
+async function listSearchConsoleSites() {
+  const payload = await googleApiFetch(
+    `${SEARCH_CONSOLE_BASE_URL}/sites`
+  );
+  return payload.siteEntry ?? [];
+}
+async function querySearchConsolePerformance(siteUrl, body) {
+  return googleApiFetch(
+    `${SEARCH_CONSOLE_BASE_URL}/sites/${encodeURIComponent(siteUrl)}/searchAnalytics/query`,
+    {
+      method: "POST",
+      body: JSON.stringify(body)
+    }
+  );
+}
+export {
+  listSearchConsoleSites,
+  querySearchConsolePerformance
+};
+//# sourceMappingURL=search-console-client.js.map

package/dist/src/services/search-console/search-console-client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/services/search-console/search-console-client.ts"],
+  "sourcesContent": ["import { refreshGoogleAccessToken } from \"../analytics/oauth.js\";\n\nconst SEARCH_CONSOLE_BASE_URL = \"https://www.googleapis.com/webmasters/v3\";\n\nexport interface SearchConsoleSiteEntry {\n  siteUrl: string;\n  permissionLevel?: string;\n}\n\nexport interface SearchConsoleSitesListResponse {\n  siteEntry?: SearchConsoleSiteEntry[];\n}\n\nexport interface SearchConsoleDimensionFilter {\n  dimension: string;\n  operator: string;\n  expression: string;\n}\n\nexport interface SearchConsoleDimensionFilterGroup {\n  groupType?: string;\n  filters: SearchConsoleDimensionFilter[];\n}\n\nexport interface SearchConsoleSearchAnalyticsRequest {\n  startDate: string;\n  endDate: string;\n  dimensions?: string[];\n  type?: string;\n  dimensionFilterGroups?: SearchConsoleDimensionFilterGroup[];\n  aggregationType?: string;\n  rowLimit?: number;\n  startRow?: number;\n}\n\nexport interface SearchConsoleSearchAnalyticsRow {\n  keys?: string[];\n  clicks?: number;\n  impressions?: number;\n  ctr?: number;\n  position?: number;\n}\n\nexport interface SearchConsoleSearchAnalyticsResponse {\n  rows?: SearchConsoleSearchAnalyticsRow[];\n  responseAggregationType?: string;\n}\n\ninterface GoogleApiErrorPayload {\n  error?: {\n    code?: number;\n    message?: string;\n    status?: string;\n  };\n}\n\nasync function googleApiFetch<T>(url: string, init?: RequestInit): Promise<T> {\n  const accessToken = await refreshGoogleAccessToken();\n\n  const response = await fetch(url, {\n    ...init,\n    headers: {\n      Authorization: `Bearer ${accessToken.accessToken}`,\n      \"Content-Type\": \"application/json\",\n      ...(init?.headers ?? {}),\n    },\n  });\n\n  if (!response.ok) {\n    const payload = (await response.json().catch(() => ({}))) as GoogleApiErrorPayload;\n    const message =\n      payload.error?.message ??\n      payload.error?.status ??\n      `Google Search Console API request failed with status ${response.status}`;\n\n    const normalizedMessage = message.toLowerCase();\n    if (\n      response.status === 403 &&\n      normalizedMessage.includes(\"insufficient authentication scopes\")\n    ) {\n      throw new Error(\n        \"Request had insufficient authentication scopes. Reconnect the Google OAuth credentials with Search Console scope https://www.googleapis.com/auth/webmasters.readonly or https://www.googleapis.com/auth/webmasters.\"\n      );\n    }\n\n    throw new Error(message);\n  }\n\n  return (await response.json()) as T;\n}\n\nexport async function listSearchConsoleSites(): Promise<SearchConsoleSiteEntry[]> {\n  const payload = await googleApiFetch<SearchConsoleSitesListResponse>(\n    `${SEARCH_CONSOLE_BASE_URL}/sites`\n  );\n\n  return payload.siteEntry ?? [];\n}\n\nexport async function querySearchConsolePerformance(\n  siteUrl: string,\n  body: SearchConsoleSearchAnalyticsRequest\n): Promise<SearchConsoleSearchAnalyticsResponse> {\n  return googleApiFetch<SearchConsoleSearchAnalyticsResponse>(\n    `${SEARCH_CONSOLE_BASE_URL}/sites/${encodeURIComponent(siteUrl)}/searchAnalytics/query`,\n    {\n      method: \"POST\",\n      body: JSON.stringify(body),\n    }\n  );\n}\n"],
+  "mappings": "AAAA,SAAS,gCAAgC;AAEzC,MAAM,0BAA0B;AAsDhC,eAAe,eAAkB,KAAa,MAAgC;AAC5E,QAAM,cAAc,MAAM,yBAAyB;AAEnD,QAAM,WAAW,MAAM,MAAM,KAAK;AAAA,IAChC,GAAG;AAAA,IACH,SAAS;AAAA,MACP,eAAe,UAAU,YAAY,WAAW;AAAA,MAChD,gBAAgB;AAAA,MAChB,GAAI,MAAM,WAAW,CAAC;AAAA,IACxB;AAAA,EACF,CAAC;AAED,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,UAAW,MAAM,SAAS,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AACvD,UAAM,UACJ,QAAQ,OAAO,WACf,QAAQ,OAAO,UACf,wDAAwD,SAAS,MAAM;AAEzE,UAAM,oBAAoB,QAAQ,YAAY;AAC9C,QACE,SAAS,WAAW,OACpB,kBAAkB,SAAS,oCAAoC,GAC/D;AACA,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,UAAM,IAAI,MAAM,OAAO;AAAA,EACzB;AAEA,SAAQ,MAAM,SAAS,KAAK;AAC9B;AAEA,eAAsB,yBAA4D;AAChF,QAAM,UAAU,MAAM;AAAA,IACpB,GAAG,uBAAuB;AAAA,EAC5B;AAEA,SAAO,QAAQ,aAAa,CAAC;AAC/B;AAEA,eAAsB,8BACpB,SACA,MAC+C;AAC/C,SAAO;AAAA,IACL,GAAG,uBAAuB,UAAU,mBAAmB,OAAO,CAAC;AAAA,IAC/D;AAAA,MACE,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,IAAI;AAAA,IAC3B;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/src/services/vtex/vtex-api.js

@@ -0,0 +1,51 @@
+import axios from "axios";
+import { vtexConfig } from "../../config/vtex.js";
+function createVtexClient(baseURL) {
+  const client = axios.create({
+    baseURL,
+    headers: {
+      "X-VTEX-API-AppKey": vtexConfig.apiKey,
+      "X-VTEX-API-AppToken": vtexConfig.apiToken,
+      Accept: "application/json",
+      "Content-Type": "application/json"
+    },
+    timeout: 3e4
+  });
+  client.interceptors.response.use(
+    (response) => response,
+    (error) => {
+      const method = error.config?.method?.toUpperCase() ?? "UNKNOWN";
+      const url = error.config?.url ?? "UNKNOWN_URL";
+      const status = error.response?.status ?? "NO_STATUS";
+      console.error(`[VTEX API ERROR] ${method} ${url} -> ${status}`);
+      if (error.response?.data) {
+        console.error("[VTEX API ERROR BODY]", error.response.data);
+      }
+      return Promise.reject(error);
+    }
+  );
+  return client;
+}
+const vtexApi = createVtexClient(vtexConfig.baseUrl);
+const vtexPricingApi = createVtexClient(vtexConfig.pricingBaseUrl);
+function formatVtexError(error, fallback = "Unexpected VTEX API error") {
+  if (axios.isAxiosError(error)) {
+    const status = error.response?.status;
+    const responseData = error.response?.data;
+    const responseMessage = typeof responseData === "object" && responseData !== null && "message" in responseData ? String(responseData.message) : typeof responseData === "string" ? responseData : void 0;
+    if (status) {
+      return `VTEX API request failed (${status}): ${responseMessage ?? error.message}`;
+    }
+    return `VTEX API request failed: ${responseMessage ?? error.message}`;
+  }
+  if (error instanceof Error) {
+    return error.message;
+  }
+  return fallback;
+}
+export {
+  formatVtexError,
+  vtexApi,
+  vtexPricingApi
+};
+//# sourceMappingURL=vtex-api.js.map

package/dist/src/services/vtex/vtex-api.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/services/vtex/vtex-api.ts"],
+  "sourcesContent": ["import axios from \"axios\";\nimport type { AxiosError, AxiosInstance } from \"axios\";\n\nimport { vtexConfig } from \"../../config/vtex.js\";\n\nfunction createVtexClient(baseURL: string): AxiosInstance {\n  const client = axios.create({\n    baseURL,\n    headers: {\n      \"X-VTEX-API-AppKey\": vtexConfig.apiKey,\n      \"X-VTEX-API-AppToken\": vtexConfig.apiToken,\n      Accept: \"application/json\",\n      \"Content-Type\": \"application/json\",\n    },\n    timeout: 30000,\n  });\n\n  client.interceptors.response.use(\n    (response) => response,\n    (error: AxiosError) => {\n      const method = error.config?.method?.toUpperCase() ?? \"UNKNOWN\";\n      const url = error.config?.url ?? \"UNKNOWN_URL\";\n      const status = error.response?.status ?? \"NO_STATUS\";\n\n      console.error(`[VTEX API ERROR] ${method} ${url} -> ${status}`);\n\n      if (error.response?.data) {\n        console.error(\"[VTEX API ERROR BODY]\", error.response.data);\n      }\n\n      return Promise.reject(error);\n    }\n  );\n\n  return client;\n}\n\nexport const vtexApi = createVtexClient(vtexConfig.baseUrl);\nexport const vtexPricingApi = createVtexClient(vtexConfig.pricingBaseUrl);\n\nexport function formatVtexError(error: unknown, fallback = \"Unexpected VTEX API error\"): string {\n  if (axios.isAxiosError(error)) {\n    const status = error.response?.status;\n    const responseData = error.response?.data;\n    const responseMessage =\n      typeof responseData === \"object\" && responseData !== null && \"message\" in responseData\n        ? String((responseData as { message?: unknown }).message)\n        : typeof responseData === \"string\"\n          ? responseData\n          : undefined;\n\n    if (status) {\n      return `VTEX API request failed (${status}): ${responseMessage ?? error.message}`;\n    }\n\n    return `VTEX API request failed: ${responseMessage ?? error.message}`;\n  }\n\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  return fallback;\n}\n"],
+  "mappings": "AAAA,OAAO,WAAW;AAGlB,SAAS,kBAAkB;AAE3B,SAAS,iBAAiB,SAAgC;AACxD,QAAM,SAAS,MAAM,OAAO;AAAA,IAC1B;AAAA,IACA,SAAS;AAAA,MACP,qBAAqB,WAAW;AAAA,MAChC,uBAAuB,WAAW;AAAA,MAClC,QAAQ;AAAA,MACR,gBAAgB;AAAA,IAClB;AAAA,IACA,SAAS;AAAA,EACX,CAAC;AAED,SAAO,aAAa,SAAS;AAAA,IAC3B,CAAC,aAAa;AAAA,IACd,CAAC,UAAsB;AACrB,YAAM,SAAS,MAAM,QAAQ,QAAQ,YAAY,KAAK;AACtD,YAAM,MAAM,MAAM,QAAQ,OAAO;AACjC,YAAM,SAAS,MAAM,UAAU,UAAU;AAEzC,cAAQ,MAAM,oBAAoB,MAAM,IAAI,GAAG,OAAO,MAAM,EAAE;AAE9D,UAAI,MAAM,UAAU,MAAM;AACxB,gBAAQ,MAAM,yBAAyB,MAAM,SAAS,IAAI;AAAA,MAC5D;AAEA,aAAO,QAAQ,OAAO,KAAK;AAAA,IAC7B;AAAA,EACF;AAEA,SAAO;AACT;AAEO,MAAM,UAAU,iBAAiB,WAAW,OAAO;AACnD,MAAM,iBAAiB,iBAAiB,WAAW,cAAc;AAEjE,SAAS,gBAAgB,OAAgB,WAAW,6BAAqC;AAC9F,MAAI,MAAM,aAAa,KAAK,GAAG;AAC7B,UAAM,SAAS,MAAM,UAAU;AAC/B,UAAM,eAAe,MAAM,UAAU;AACrC,UAAM,kBACJ,OAAO,iBAAiB,YAAY,iBAAiB,QAAQ,aAAa,eACtE,OAAQ,aAAuC,OAAO,IACtD,OAAO,iBAAiB,WACtB,eACA;AAER,QAAI,QAAQ;AACV,aAAO,4BAA4B,MAAM,MAAM,mBAAmB,MAAM,OAAO;AAAA,IACjF;AAEA,WAAO,4BAA4B,mBAAmB,MAAM,OAAO;AAAA,EACrE;AAEA,MAAI,iBAAiB,OAAO;AAC1B,WAAO,MAAM;AAAA,EACf;AAEA,SAAO;AACT;",
+  "names": []
+}

package/dist/src/services/vtex/vtex-catalog.js

@@ -0,0 +1,18 @@
+import { vtexApi } from "./vtex-api.js";
+async function getProductOffers(productId) {
+  const response = await vtexApi.get(
+    `/api/catalog_system/pub/products/offers/${productId}`
+  );
+  return response.data;
+}
+async function getSkuOffers(productId, skuId) {
+  const response = await vtexApi.get(
+    `/api/catalog_system/pub/products/offers/${productId}/sku/${skuId}`
+  );
+  return response.data;
+}
+export {
+  getProductOffers,
+  getSkuOffers
+};
+//# sourceMappingURL=vtex-catalog.js.map

package/dist/src/services/vtex/vtex-catalog.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/services/vtex/vtex-catalog.ts"],
+  "sourcesContent": ["import { vtexApi } from \"./vtex-api.js\";\n\nexport type ProductOffersResponse = Record<string, unknown>[];\n\nexport async function getProductOffers(productId: string): Promise<ProductOffersResponse> {\n  const response = await vtexApi.get<ProductOffersResponse>(\n    `/api/catalog_system/pub/products/offers/${productId}`\n  );\n\n  return response.data;\n}\n\nexport async function getSkuOffers(productId: string, skuId: string): Promise<ProductOffersResponse> {\n  const response = await vtexApi.get<ProductOffersResponse>(\n    `/api/catalog_system/pub/products/offers/${productId}/sku/${skuId}`\n  );\n\n  return response.data;\n}\n"],
+  "mappings": "AAAA,SAAS,eAAe;AAIxB,eAAsB,iBAAiB,WAAmD;AACxF,QAAM,WAAW,MAAM,QAAQ;AAAA,IAC7B,2CAA2C,SAAS;AAAA,EACtD;AAEA,SAAO,SAAS;AAClB;AAEA,eAAsB,aAAa,WAAmB,OAA+C;AACnG,QAAM,WAAW,MAAM,QAAQ;AAAA,IAC7B,2CAA2C,SAAS,QAAQ,KAAK;AAAA,EACnE;AAEA,SAAO,SAAS;AAClB;",
+  "names": []
+}

package/dist/src/services/vtex/vtex-logistics.js

@@ -0,0 +1,151 @@
+import axios from "axios";
+import { vtexApi } from "./vtex-api.js";
+const RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([408, 429, 500, 502, 503, 504]);
+const DEFAULT_BATCH_CONCURRENCY = 10;
+const DEFAULT_MAX_RETRIES = 2;
+const DEFAULT_BASE_RETRY_DELAY_MS = 250;
+async function getInventoryBySku(skuId) {
+  const response = await vtexApi.get(`/api/logistics/pvt/inventory/skus/${skuId}`);
+  return response.data;
+}
+function sleep(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
+function parseRetryAfterMs(headerValue) {
+  if (Array.isArray(headerValue)) {
+    return parseRetryAfterMs(headerValue[0]);
+  }
+  if (typeof headerValue === "number" && Number.isFinite(headerValue)) {
+    return Math.max(0, Math.floor(headerValue * 1e3));
+  }
+  if (typeof headerValue !== "string") {
+    return void 0;
+  }
+  const trimmedValue = headerValue.trim();
+  if (!trimmedValue) {
+    return void 0;
+  }
+  const seconds = Number(trimmedValue);
+  if (Number.isFinite(seconds)) {
+    return Math.max(0, Math.floor(seconds * 1e3));
+  }
+  const absoluteDateMs = Date.parse(trimmedValue);
+  if (Number.isNaN(absoluteDateMs)) {
+    return void 0;
+  }
+  return Math.max(0, absoluteDateMs - Date.now());
+}
+function computeBackoffDelayMs(attempt, baseDelayMs) {
+  const exponential = baseDelayMs * 2 ** Math.max(0, attempt - 1);
+  const jitter = Math.floor(Math.random() * 150);
+  return exponential + jitter;
+}
+function isRetryableRequestError(error) {
+  if (!axios.isAxiosError(error)) {
+    return false;
+  }
+  if (!error.response?.status) {
+    return true;
+  }
+  return RETRYABLE_STATUS_CODES.has(error.response.status);
+}
+function toInventoryFetchError(skuId, source, attempts, retryable) {
+  const statusCode = axios.isAxiosError(source) ? source.response?.status : void 0;
+  const message = source instanceof Error ? source.message : typeof source === "string" ? source : "Unexpected error while fetching inventory details";
+  const error = new Error(message);
+  error.skuId = skuId;
+  error.statusCode = statusCode;
+  error.attempts = attempts;
+  error.retryable = retryable;
+  return error;
+}
+function isInventoryFetchError(error) {
+  if (!(error instanceof Error)) {
+    return false;
+  }
+  return "skuId" in error && "attempts" in error && "retryable" in error && typeof error.skuId === "string";
+}
+async function getInventoryBySkuWithRetry(skuId, options) {
+  const maxRetries = Math.max(0, Math.floor(options.maxRetries ?? DEFAULT_MAX_RETRIES));
+  const baseRetryDelayMs = Math.max(
+    50,
+    Math.floor(options.baseRetryDelayMs ?? DEFAULT_BASE_RETRY_DELAY_MS)
+  );
+  let attempts = 0;
+  while (true) {
+    attempts += 1;
+    try {
+      const document = await getInventoryBySku(skuId);
+      return { skuId, document };
+    } catch (error) {
+      const retryable = isRetryableRequestError(error);
+      if (!retryable || attempts > maxRetries) {
+        throw toInventoryFetchError(skuId, error, attempts, retryable);
+      }
+      const retryAfterHeader = axios.isAxiosError(error) ? error.response?.headers?.["retry-after"] : void 0;
+      const retryAfterMs = parseRetryAfterMs(retryAfterHeader);
+      const delayMs = retryAfterMs ?? computeBackoffDelayMs(attempts, baseRetryDelayMs);
+      await sleep(delayMs);
+    }
+  }
+}
+async function getInventoryBySkuBatch(skuIds, options = {}) {
+  const maxConcurrency = Math.max(
+    1,
+    Math.floor(options.maxConcurrency ?? DEFAULT_BATCH_CONCURRENCY)
+  );
+  const successful = [];
+  const failed = [];
+  for (let start = 0; start < skuIds.length; start += maxConcurrency) {
+    const chunk = skuIds.slice(start, start + maxConcurrency);
+    const settledChunk = await Promise.allSettled(
+      chunk.map((skuId) => getInventoryBySkuWithRetry(skuId, options))
+    );
+    settledChunk.forEach((result, index) => {
+      const skuId = chunk[index];
+      if (result.status === "fulfilled") {
+        successful.push(result.value);
+        return;
+      }
+      if (isInventoryFetchError(result.reason)) {
+        failed.push({
+          skuId: result.reason.skuId,
+          message: result.reason.message,
+          statusCode: result.reason.statusCode,
+          attempts: result.reason.attempts,
+          retryable: result.reason.retryable
+        });
+        return;
+      }
+      failed.push({
+        skuId,
+        message: result.reason instanceof Error ? result.reason.message : "Unexpected error while fetching inventory details",
+        attempts: 1,
+        retryable: false
+      });
+    });
+  }
+  return { successful, failed };
+}
+async function getInventoryByWarehouse(skuId, warehouseId) {
+  const response = await vtexApi.get(
+    `/api/logistics/pvt/inventory/items/${skuId}/warehouses/${warehouseId}`
+  );
+  return response.data;
+}
+async function updateInventoryQuantity(skuId, warehouseId, payload) {
+  await vtexApi.patch(`/api/logistics/pvt/inventory/skus/${skuId}/warehouses/${warehouseId}/quantity`, payload);
+}
+async function updateInventoryLeadTime(skuId, warehouseId, payload) {
+  await vtexApi.patch(`/api/logistics/pvt/inventory/skus/${skuId}/warehouses/${warehouseId}/lead-time`, payload);
+}
+export {
+  getInventoryBySku,
+  getInventoryBySkuBatch,
+  getInventoryByWarehouse,
+  updateInventoryLeadTime,
+  updateInventoryQuantity
+};
+//# sourceMappingURL=vtex-logistics.js.map

package/dist/src/services/vtex/vtex-logistics.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/services/vtex/vtex-logistics.ts"],
+  "sourcesContent": ["import axios from \"axios\";\nimport { vtexApi } from \"./vtex-api.js\";\n\nexport interface WarehouseBalance {\n  warehouseId?: string;\n  warehouseName?: string;\n  totalQuantity?: number;\n  reservedQuantity?: number;\n  availableQuantity?: number;\n  isUnlimited?: boolean;\n  hasUnlimitedQuantity?: boolean;\n  timeToRefill?: string;\n  dateOfSupplyUtc?: string;\n  leadTime?: string;\n}\n\nexport interface InventoryBySkuResponse {\n  skuId?: string;\n  balance?: WarehouseBalance[];\n}\n\nexport interface InventoryByWarehouseItem {\n  skuId?: string;\n  warehouseId?: string;\n  totalQuantity?: number;\n  reservedQuantity?: number;\n  availableQuantity?: number;\n  isUnlimited?: boolean;\n  keepSellingAfterExpiration?: boolean;\n}\n\nexport interface UpdateInventoryQuantityPayload {\n  quantity: number;\n  unlimitedQuantity: boolean;\n  dateUtcOnBalanceSystem?: string;\n}\n\nexport interface UpdateLeadTimePayload {\n  leadTime: string;\n}\n\nexport interface GetInventoryBatchOptions {\n  maxConcurrency?: number;\n  maxRetries?: number;\n  baseRetryDelayMs?: number;\n}\n\nexport interface InventoryBatchSuccess {\n  skuId: string;\n  document: InventoryBySkuResponse;\n}\n\nexport interface InventoryBatchFailure {\n  skuId: string;\n  message: string;\n  statusCode?: number;\n  attempts: number;\n  retryable: boolean;\n}\n\nexport interface InventoryBatchResult {\n  successful: InventoryBatchSuccess[];\n  failed: InventoryBatchFailure[];\n}\n\ninterface InventoryFetchError extends Error {\n  skuId: string;\n  statusCode?: number;\n  attempts: number;\n  retryable: boolean;\n}\n\nconst RETRYABLE_STATUS_CODES = new Set([408, 429, 500, 502, 503, 504]);\nconst DEFAULT_BATCH_CONCURRENCY = 10;\nconst DEFAULT_MAX_RETRIES = 2;\nconst DEFAULT_BASE_RETRY_DELAY_MS = 250;\n\nexport async function getInventoryBySku(skuId: string): Promise<InventoryBySkuResponse> {\n  const response = await vtexApi.get<InventoryBySkuResponse>(`/api/logistics/pvt/inventory/skus/${skuId}`);\n  return response.data;\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n}\n\nfunction parseRetryAfterMs(headerValue: unknown): number | undefined {\n  if (Array.isArray(headerValue)) {\n    return parseRetryAfterMs(headerValue[0]);\n  }\n\n  if (typeof headerValue === \"number\" && Number.isFinite(headerValue)) {\n    return Math.max(0, Math.floor(headerValue * 1000));\n  }\n\n  if (typeof headerValue !== \"string\") {\n    return undefined;\n  }\n\n  const trimmedValue = headerValue.trim();\n  if (!trimmedValue) {\n    return undefined;\n  }\n\n  const seconds = Number(trimmedValue);\n  if (Number.isFinite(seconds)) {\n    return Math.max(0, Math.floor(seconds * 1000));\n  }\n\n  const absoluteDateMs = Date.parse(trimmedValue);\n  if (Number.isNaN(absoluteDateMs)) {\n    return undefined;\n  }\n\n  return Math.max(0, absoluteDateMs - Date.now());\n}\n\nfunction computeBackoffDelayMs(attempt: number, baseDelayMs: number): number {\n  const exponential = baseDelayMs * 2 ** Math.max(0, attempt - 1);\n  const jitter = Math.floor(Math.random() * 150);\n  return exponential + jitter;\n}\n\nfunction isRetryableRequestError(error: unknown): boolean {\n  if (!axios.isAxiosError(error)) {\n    return false;\n  }\n\n  if (!error.response?.status) {\n    return true;\n  }\n\n  return RETRYABLE_STATUS_CODES.has(error.response.status);\n}\n\nfunction toInventoryFetchError(\n  skuId: string,\n  source: unknown,\n  attempts: number,\n  retryable: boolean\n): InventoryFetchError {\n  const statusCode = axios.isAxiosError(source) ? source.response?.status : undefined;\n  const message =\n    source instanceof Error\n      ? source.message\n      : typeof source === \"string\"\n        ? source\n        : \"Unexpected error while fetching inventory details\";\n\n  const error = new Error(message) as InventoryFetchError;\n  error.skuId = skuId;\n  error.statusCode = statusCode;\n  error.attempts = attempts;\n  error.retryable = retryable;\n  return error;\n}\n\nfunction isInventoryFetchError(error: unknown): error is InventoryFetchError {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n\n  return (\n    \"skuId\" in error &&\n    \"attempts\" in error &&\n    \"retryable\" in error &&\n    typeof (error as Partial<InventoryFetchError>).skuId === \"string\"\n  );\n}\n\nasync function getInventoryBySkuWithRetry(\n  skuId: string,\n  options: GetInventoryBatchOptions\n): Promise<InventoryBatchSuccess> {\n  const maxRetries = Math.max(0, Math.floor(options.maxRetries ?? DEFAULT_MAX_RETRIES));\n  const baseRetryDelayMs = Math.max(\n    50,\n    Math.floor(options.baseRetryDelayMs ?? DEFAULT_BASE_RETRY_DELAY_MS)\n  );\n  let attempts = 0;\n\n  while (true) {\n    attempts += 1;\n\n    try {\n      const document = await getInventoryBySku(skuId);\n      return { skuId, document };\n    } catch (error) {\n      const retryable = isRetryableRequestError(error);\n\n      if (!retryable || attempts > maxRetries) {\n        throw toInventoryFetchError(skuId, error, attempts, retryable);\n      }\n\n      const retryAfterHeader = axios.isAxiosError(error)\n        ? error.response?.headers?.[\"retry-after\"]\n        : undefined;\n      const retryAfterMs = parseRetryAfterMs(retryAfterHeader);\n      const delayMs = retryAfterMs ?? computeBackoffDelayMs(attempts, baseRetryDelayMs);\n      await sleep(delayMs);\n    }\n  }\n}\n\nexport async function getInventoryBySkuBatch(\n  skuIds: string[],\n  options: GetInventoryBatchOptions = {}\n): Promise<InventoryBatchResult> {\n  const maxConcurrency = Math.max(\n    1,\n    Math.floor(options.maxConcurrency ?? DEFAULT_BATCH_CONCURRENCY)\n  );\n  const successful: InventoryBatchSuccess[] = [];\n  const failed: InventoryBatchFailure[] = [];\n\n  for (let start = 0; start < skuIds.length; start += maxConcurrency) {\n    const chunk = skuIds.slice(start, start + maxConcurrency);\n    const settledChunk = await Promise.allSettled(\n      chunk.map((skuId) => getInventoryBySkuWithRetry(skuId, options))\n    );\n\n    settledChunk.forEach((result, index) => {\n      const skuId = chunk[index];\n\n      if (result.status === \"fulfilled\") {\n        successful.push(result.value);\n        return;\n      }\n\n      if (isInventoryFetchError(result.reason)) {\n        failed.push({\n          skuId: result.reason.skuId,\n          message: result.reason.message,\n          statusCode: result.reason.statusCode,\n          attempts: result.reason.attempts,\n          retryable: result.reason.retryable,\n        });\n        return;\n      }\n\n      failed.push({\n        skuId,\n        message:\n          result.reason instanceof Error\n            ? result.reason.message\n            : \"Unexpected error while fetching inventory details\",\n        attempts: 1,\n        retryable: false,\n      });\n    });\n  }\n\n  return { successful, failed };\n}\n\nexport async function getInventoryByWarehouse(\n  skuId: string,\n  warehouseId: string\n): Promise<InventoryByWarehouseItem[]> {\n  const response = await vtexApi.get<InventoryByWarehouseItem[]>(\n    `/api/logistics/pvt/inventory/items/${skuId}/warehouses/${warehouseId}`\n  );\n  return response.data;\n}\n\nexport async function updateInventoryQuantity(\n  skuId: string,\n  warehouseId: string,\n  payload: UpdateInventoryQuantityPayload\n): Promise<void> {\n  await vtexApi.patch(`/api/logistics/pvt/inventory/skus/${skuId}/warehouses/${warehouseId}/quantity`, payload);\n}\n\nexport async function updateInventoryLeadTime(\n  skuId: string,\n  warehouseId: string,\n  payload: UpdateLeadTimePayload\n): Promise<void> {\n  await vtexApi.patch(`/api/logistics/pvt/inventory/skus/${skuId}/warehouses/${warehouseId}/lead-time`, payload);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/services/vtex/vtex-orders.js

@@ -0,0 +1,143 @@
+import axios from "axios";
+import { vtexApi } from "./vtex-api.js";
+const RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([408, 429, 500, 502, 503, 504]);
+const DEFAULT_BATCH_CONCURRENCY = 10;
+const DEFAULT_MAX_RETRIES = 2;
+const DEFAULT_BASE_RETRY_DELAY_MS = 250;
+async function listOrders(params) {
+  const response = await vtexApi.get("/api/oms/pvt/orders", { params });
+  return response.data;
+}
+async function getOrderDocument(orderId, reason) {
+  const response = await vtexApi.get(`/api/orders/pvt/document/${orderId}`, {
+    params: reason ? { reason } : void 0
+  });
+  return response.data;
+}
+function sleep(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
+function parseRetryAfterMs(headerValue) {
+  if (Array.isArray(headerValue)) {
+    return parseRetryAfterMs(headerValue[0]);
+  }
+  if (typeof headerValue === "number" && Number.isFinite(headerValue)) {
+    return Math.max(0, Math.floor(headerValue * 1e3));
+  }
+  if (typeof headerValue !== "string") {
+    return void 0;
+  }
+  const trimmedValue = headerValue.trim();
+  if (!trimmedValue) {
+    return void 0;
+  }
+  const seconds = Number(trimmedValue);
+  if (Number.isFinite(seconds)) {
+    return Math.max(0, Math.floor(seconds * 1e3));
+  }
+  const absoluteDateMs = Date.parse(trimmedValue);
+  if (Number.isNaN(absoluteDateMs)) {
+    return void 0;
+  }
+  return Math.max(0, absoluteDateMs - Date.now());
+}
+function computeBackoffDelayMs(attempt, baseDelayMs) {
+  const exponential = baseDelayMs * 2 ** Math.max(0, attempt - 1);
+  const jitter = Math.floor(Math.random() * 150);
+  return exponential + jitter;
+}
+function isRetryableRequestError(error) {
+  if (!axios.isAxiosError(error)) {
+    return false;
+  }
+  if (!error.response?.status) {
+    return true;
+  }
+  return RETRYABLE_STATUS_CODES.has(error.response.status);
+}
+function toOrderDocumentFetchError(orderId, source, attempts, retryable) {
+  const statusCode = axios.isAxiosError(source) ? source.response?.status : void 0;
+  const message = source instanceof Error ? source.message : typeof source === "string" ? source : "Unexpected error while fetching order details";
+  const error = new Error(message);
+  error.orderId = orderId;
+  error.statusCode = statusCode;
+  error.attempts = attempts;
+  error.retryable = retryable;
+  return error;
+}
+function isOrderDocumentFetchError(error) {
+  if (!(error instanceof Error)) {
+    return false;
+  }
+  return "orderId" in error && "attempts" in error && "retryable" in error && typeof error.orderId === "string";
+}
+async function getOrderDocumentWithRetry(orderId, options) {
+  const maxRetries = Math.max(0, Math.floor(options.maxRetries ?? DEFAULT_MAX_RETRIES));
+  const baseRetryDelayMs = Math.max(
+    50,
+    Math.floor(options.baseRetryDelayMs ?? DEFAULT_BASE_RETRY_DELAY_MS)
+  );
+  let attempts = 0;
+  while (true) {
+    attempts += 1;
+    try {
+      const document = await getOrderDocument(orderId, options.reason);
+      return { orderId, document };
+    } catch (error) {
+      const retryable = isRetryableRequestError(error);
+      if (!retryable || attempts > maxRetries) {
+        throw toOrderDocumentFetchError(orderId, error, attempts, retryable);
+      }
+      const retryAfterHeader = axios.isAxiosError(error) ? error.response?.headers?.["retry-after"] : void 0;
+      const retryAfterMs = parseRetryAfterMs(retryAfterHeader);
+      const delayMs = retryAfterMs ?? computeBackoffDelayMs(attempts, baseRetryDelayMs);
+      await sleep(delayMs);
+    }
+  }
+}
+async function getOrderDocumentsBatch(orderIds, options = {}) {
+  const maxConcurrency = Math.max(
+    1,
+    Math.floor(options.maxConcurrency ?? DEFAULT_BATCH_CONCURRENCY)
+  );
+  const successful = [];
+  const failed = [];
+  for (let start = 0; start < orderIds.length; start += maxConcurrency) {
+    const chunk = orderIds.slice(start, start + maxConcurrency);
+    const settledChunk = await Promise.allSettled(
+      chunk.map((orderId) => getOrderDocumentWithRetry(orderId, options))
+    );
+    settledChunk.forEach((result, index) => {
+      const orderId = chunk[index];
+      if (result.status === "fulfilled") {
+        successful.push(result.value);
+        return;
+      }
+      if (isOrderDocumentFetchError(result.reason)) {
+        failed.push({
+          orderId: result.reason.orderId,
+          message: result.reason.message,
+          statusCode: result.reason.statusCode,
+          attempts: result.reason.attempts,
+          retryable: result.reason.retryable
+        });
+        return;
+      }
+      failed.push({
+        orderId,
+        message: result.reason instanceof Error ? result.reason.message : "Unexpected error while fetching order details",
+        attempts: 1,
+        retryable: false
+      });
+    });
+  }
+  return { successful, failed };
+}
+export {
+  getOrderDocument,
+  getOrderDocumentsBatch,
+  listOrders
+};
+//# sourceMappingURL=vtex-orders.js.map

package/dist/src/services/vtex/vtex-orders.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/services/vtex/vtex-orders.ts"],
+  "sourcesContent": ["import axios from \"axios\";\nimport { vtexApi } from \"./vtex-api.js\";\n\nexport interface VtexOrderListItem {\n  orderId: string;\n  creationDate?: string;\n  status?: string;\n  totalValue?: number;\n  currencyCode?: string;\n  paymentNames?: string;\n  salesChannel?: string;\n  origin?: string;\n  totalItems?: number;\n  lastChange?: string;\n  orderIsComplete?: boolean;\n  authorizedDate?: string;\n  paymentApprovedDate?: string;\n  readyForHandlingDate?: string;\n}\n\nexport interface VtexOrdersPaging {\n  total?: number;\n  pages?: number;\n  currentPage?: number;\n  perPage?: number;\n}\n\nexport interface VtexOrdersListResponse {\n  list: VtexOrderListItem[];\n  paging: VtexOrdersPaging;\n  stats?: unknown;\n}\n\nexport interface ListOrdersParams {\n  page?: number;\n  per_page?: number;\n  orderBy?: string;\n  f_creationDate?: string;\n  f_invoicedDate?: string;\n  f_status?: string;\n  f_salesChannel?: string;\n  f_paymentNames?: string;\n  f_UtmSource?: string;\n  q?: string;\n}\n\nexport interface GetOrderDocumentsBatchOptions {\n  reason?: string;\n  maxConcurrency?: number;\n  maxRetries?: number;\n  baseRetryDelayMs?: number;\n}\n\nexport interface OrderDocumentSuccess {\n  orderId: string;\n  document: Record<string, unknown>;\n}\n\nexport interface OrderDocumentFailure {\n  orderId: string;\n  message: string;\n  statusCode?: number;\n  attempts: number;\n  retryable: boolean;\n}\n\nexport interface OrderDocumentsBatchResult {\n  successful: OrderDocumentSuccess[];\n  failed: OrderDocumentFailure[];\n}\n\nconst RETRYABLE_STATUS_CODES = new Set([408, 429, 500, 502, 503, 504]);\nconst DEFAULT_BATCH_CONCURRENCY = 10;\nconst DEFAULT_MAX_RETRIES = 2;\nconst DEFAULT_BASE_RETRY_DELAY_MS = 250;\n\nexport async function listOrders(params: ListOrdersParams): Promise<VtexOrdersListResponse> {\n  const response = await vtexApi.get<VtexOrdersListResponse>(\"/api/oms/pvt/orders\", { params });\n  return response.data;\n}\n\nexport async function getOrderDocument(\n  orderId: string,\n  reason?: string\n): Promise<Record<string, unknown>> {\n  const response = await vtexApi.get<Record<string, unknown>>(`/api/orders/pvt/document/${orderId}`, {\n    params: reason ? { reason } : undefined,\n  });\n\n  return response.data;\n}\n\ninterface OrderDocumentFetchError extends Error {\n  orderId: string;\n  statusCode?: number;\n  attempts: number;\n  retryable: boolean;\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n}\n\nfunction parseRetryAfterMs(headerValue: unknown): number | undefined {\n  if (Array.isArray(headerValue)) {\n    return parseRetryAfterMs(headerValue[0]);\n  }\n\n  if (typeof headerValue === \"number\" && Number.isFinite(headerValue)) {\n    return Math.max(0, Math.floor(headerValue * 1000));\n  }\n\n  if (typeof headerValue !== \"string\") {\n    return undefined;\n  }\n\n  const trimmedValue = headerValue.trim();\n  if (!trimmedValue) {\n    return undefined;\n  }\n\n  const seconds = Number(trimmedValue);\n  if (Number.isFinite(seconds)) {\n    return Math.max(0, Math.floor(seconds * 1000));\n  }\n\n  const absoluteDateMs = Date.parse(trimmedValue);\n  if (Number.isNaN(absoluteDateMs)) {\n    return undefined;\n  }\n\n  return Math.max(0, absoluteDateMs - Date.now());\n}\n\nfunction computeBackoffDelayMs(attempt: number, baseDelayMs: number): number {\n  const exponential = baseDelayMs * 2 ** Math.max(0, attempt - 1);\n  const jitter = Math.floor(Math.random() * 150);\n  return exponential + jitter;\n}\n\nfunction isRetryableRequestError(error: unknown): boolean {\n  if (!axios.isAxiosError(error)) {\n    return false;\n  }\n\n  if (!error.response?.status) {\n    return true;\n  }\n\n  return RETRYABLE_STATUS_CODES.has(error.response.status);\n}\n\nfunction toOrderDocumentFetchError(\n  orderId: string,\n  source: unknown,\n  attempts: number,\n  retryable: boolean\n): OrderDocumentFetchError {\n  const statusCode = axios.isAxiosError(source) ? source.response?.status : undefined;\n  const message =\n    source instanceof Error\n      ? source.message\n      : typeof source === \"string\"\n        ? source\n        : \"Unexpected error while fetching order details\";\n\n  const error = new Error(message) as OrderDocumentFetchError;\n  error.orderId = orderId;\n  error.statusCode = statusCode;\n  error.attempts = attempts;\n  error.retryable = retryable;\n  return error;\n}\n\nfunction isOrderDocumentFetchError(error: unknown): error is OrderDocumentFetchError {\n  if (!(error instanceof Error)) {\n    return false;\n  }\n\n  return (\n    \"orderId\" in error &&\n    \"attempts\" in error &&\n    \"retryable\" in error &&\n    typeof (error as Partial<OrderDocumentFetchError>).orderId === \"string\"\n  );\n}\n\nasync function getOrderDocumentWithRetry(\n  orderId: string,\n  options: GetOrderDocumentsBatchOptions\n): Promise<OrderDocumentSuccess> {\n  const maxRetries = Math.max(0, Math.floor(options.maxRetries ?? DEFAULT_MAX_RETRIES));\n  const baseRetryDelayMs = Math.max(\n    50,\n    Math.floor(options.baseRetryDelayMs ?? DEFAULT_BASE_RETRY_DELAY_MS)\n  );\n  let attempts = 0;\n\n  while (true) {\n    attempts += 1;\n\n    try {\n      const document = await getOrderDocument(orderId, options.reason);\n      return { orderId, document };\n    } catch (error) {\n      const retryable = isRetryableRequestError(error);\n\n      if (!retryable || attempts > maxRetries) {\n        throw toOrderDocumentFetchError(orderId, error, attempts, retryable);\n      }\n\n      const retryAfterHeader = axios.isAxiosError(error)\n        ? error.response?.headers?.[\"retry-after\"]\n        : undefined;\n      const retryAfterMs = parseRetryAfterMs(retryAfterHeader);\n      const delayMs = retryAfterMs ?? computeBackoffDelayMs(attempts, baseRetryDelayMs);\n      await sleep(delayMs);\n    }\n  }\n}\n\nexport async function getOrderDocumentsBatch(\n  orderIds: string[],\n  options: GetOrderDocumentsBatchOptions = {}\n): Promise<OrderDocumentsBatchResult> {\n  const maxConcurrency = Math.max(\n    1,\n    Math.floor(options.maxConcurrency ?? DEFAULT_BATCH_CONCURRENCY)\n  );\n  const successful: OrderDocumentSuccess[] = [];\n  const failed: OrderDocumentFailure[] = [];\n\n  for (let start = 0; start < orderIds.length; start += maxConcurrency) {\n    const chunk = orderIds.slice(start, start + maxConcurrency);\n    const settledChunk = await Promise.allSettled(\n      chunk.map((orderId) => getOrderDocumentWithRetry(orderId, options))\n    );\n\n    settledChunk.forEach((result, index) => {\n      const orderId = chunk[index];\n\n      if (result.status === \"fulfilled\") {\n        successful.push(result.value);\n        return;\n      }\n\n      if (isOrderDocumentFetchError(result.reason)) {\n        failed.push({\n          orderId: result.reason.orderId,\n          message: result.reason.message,\n          statusCode: result.reason.statusCode,\n          attempts: result.reason.attempts,\n          retryable: result.reason.retryable,\n        });\n        return;\n      }\n\n      failed.push({\n        orderId,\n        message:\n          result.reason instanceof Error\n            ? result.reason.message\n            : \"Unexpected error while fetching order details\",\n        attempts: 1,\n        retryable: false,\n      });\n    });\n  }\n\n  return { successful, failed };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/services/vtex/vtex-pricing.js

@@ -0,0 +1,17 @@
+import { vtexPricingApi } from "./vtex-api.js";
+async function getSkuPrice(itemId) {
+  const response = await vtexPricingApi.get(`/pricing/prices/${itemId}`);
+  return response.data;
+}
+async function getComputedPrice(itemId, priceTableId, params) {
+  const response = await vtexPricingApi.get(
+    `/pricing/prices/${itemId}/computed/${priceTableId}`,
+    { params }
+  );
+  return response.data;
+}
+export {
+  getComputedPrice,
+  getSkuPrice
+};
+//# sourceMappingURL=vtex-pricing.js.map

package/dist/src/services/vtex/vtex-pricing.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/services/vtex/vtex-pricing.ts"],
+  "sourcesContent": ["import { vtexPricingApi } from \"./vtex-api.js\";\n\nexport interface SkuFixedPrice {\n  value?: number;\n  listPrice?: number;\n  minQuantity?: number;\n  dateRange?: {\n    from?: string;\n    to?: string;\n  };\n  tradePolicyId?: string;\n}\n\nexport interface SkuPriceResponse {\n  itemId: string;\n  listPrice: number;\n  costPrice: number;\n  markup: number;\n  basePrice: number;\n  fixedPrices: SkuFixedPrice[];\n}\n\nexport interface ComputedPriceParams {\n  categoryId: number;\n  brandId: number;\n  quantity: number;\n}\n\nexport interface ComputedPriceResponse {\n  tradePolicyId: string;\n  listPrice: number;\n  costPrice?: number;\n  sellingPrice: number;\n  priceValidUntil: string;\n}\n\nexport async function getSkuPrice(itemId: string): Promise<SkuPriceResponse> {\n  const response = await vtexPricingApi.get<SkuPriceResponse>(`/pricing/prices/${itemId}`);\n  return response.data;\n}\n\nexport async function getComputedPrice(\n  itemId: string,\n  priceTableId: string,\n  params: ComputedPriceParams\n): Promise<ComputedPriceResponse> {\n  const response = await vtexPricingApi.get<ComputedPriceResponse>(\n    `/pricing/prices/${itemId}/computed/${priceTableId}`,\n    { params }\n  );\n\n  return response.data;\n}\n"],
+  "mappings": "AAAA,SAAS,sBAAsB;AAoC/B,eAAsB,YAAY,QAA2C;AAC3E,QAAM,WAAW,MAAM,eAAe,IAAsB,mBAAmB,MAAM,EAAE;AACvF,SAAO,SAAS;AAClB;AAEA,eAAsB,iBACpB,QACA,cACA,QACgC;AAChC,QAAM,WAAW,MAAM,eAAe;AAAA,IACpC,mBAAmB,MAAM,aAAa,YAAY;AAAA,IAClD,EAAE,OAAO;AAAA,EACX;AAEA,SAAO,SAAS;AAClB;",
+  "names": []
+}

package/dist/src/tools/analytics/attribution-gaps.js

@@ -0,0 +1,109 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import {
+  detectSeverity,
+  extractQuotaSnapshot,
+  getDimensionValue,
+  getMetricValueByName,
+  isProblematicAttributionValue,
+  resolveGa4PropertyId,
+  round,
+  toPercent
+} from "../../analytics/ga4-report-utils.js";
+import { runReport } from "../../services/analytics/ga4-client.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
+const attributionGapsSchema = z.object({
+  startDate: z.string().regex(dateRegex).describe("Start date in YYYY-MM-DD format"),
+  endDate: z.string().regex(dateRegex).describe("End date in YYYY-MM-DD format"),
+  propertyId: z.string().optional().describe("GA4 property ID. If omitted, uses GA4_PROPERTY_ID"),
+  limit: z.number().int().min(10).max(100).optional().describe("Maximum source / medium rows to inspect")
+});
+async function attributionGapsHandler(params) {
+  try {
+    const propertyId = resolveGa4PropertyId(params.propertyId);
+    const limit = params.limit ?? 50;
+    const [channelReport, sourceMediumReport, totalReport] = await Promise.all([
+      runReport(propertyId, {
+        dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],
+        dimensions: [{ name: "sessionDefaultChannelGroup" }],
+        metrics: [{ name: "sessions" }, { name: "totalUsers" }]
+      }),
+      runReport(propertyId, {
+        dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],
+        dimensions: [{ name: "sessionSourceMedium" }],
+        metrics: [{ name: "sessions" }, { name: "totalUsers" }],
+        orderBys: [{ metric: { metricName: "sessions" }, desc: true }],
+        limit,
+        returnPropertyQuota: true
+      }),
+      runReport(propertyId, {
+        dateRanges: [{ startDate: params.startDate, endDate: params.endDate }],
+        metrics: [{ name: "sessions" }]
+      })
+    ]);
+    const totalSessions = getMetricValueByName(
+      totalReport.rows?.[0] ?? {},
+      totalReport.metricHeaders,
+      "sessions"
+    );
+    const unassignedChannel = (channelReport.rows ?? []).find(
+      (row) => getDimensionValue(row) === "Unassigned"
+    );
+    const unassignedSessions = getMetricValueByName(
+      unassignedChannel ?? {},
+      channelReport.metricHeaders,
+      "sessions"
+    );
+    const problematicSourceMediumRows = (sourceMediumReport.rows ?? []).filter((row) => isProblematicAttributionValue(getDimensionValue(row))).map((row) => {
+      const sessions = getMetricValueByName(row, sourceMediumReport.metricHeaders, "sessions");
+      const users = getMetricValueByName(row, sourceMediumReport.metricHeaders, "totalUsers");
+      return {
+        source_medium: getDimensionValue(row),
+        sessions,
+        users,
+        session_share_percent: round(toPercent(sessions, totalSessions))
+      };
+    });
+    const problematicSourceMediumSessions = problematicSourceMediumRows.reduce(
+      (total, row) => total + row.sessions,
+      0
+    );
+    const unassignedSharePercent = round(toPercent(unassignedSessions, totalSessions));
+    const problematicSourceMediumSharePercent = round(
+      toPercent(problematicSourceMediumSessions, totalSessions)
+    );
+    return object(
+      stripNulls({
+        property_id: propertyId,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        overview: {
+          total_sessions: totalSessions,
+          attribution_warning: "Las se\xF1ales se reportan por separado para evitar doble conteo entre dimensiones distintas de GA4."
+        },
+        unassigned_channel_group: {
+          sessions: unassignedSessions,
+          session_share_percent: unassignedSharePercent,
+          severity: detectSeverity(unassignedSharePercent)
+        },
+        problematic_source_medium: {
+          sessions: problematicSourceMediumSessions,
+          session_share_percent: problematicSourceMediumSharePercent,
+          severity: detectSeverity(problematicSourceMediumSharePercent)
+        },
+        problematic_source_mediums: problematicSourceMediumRows,
+        quota: extractQuotaSnapshot(sourceMediumReport)
+      })
+    );
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "Failed to detect GA4 attribution gaps");
+  }
+}
+export {
+  attributionGapsHandler,
+  attributionGapsSchema
+};
+//# sourceMappingURL=attribution-gaps.js.map