@yoryoboy/bi-mcp 1.0.1

package/dist/src/tools/search-console/site-context.js

@@ -0,0 +1,43 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { listSearchConsoleSites } from "../../services/search-console/search-console-client.js";
+import {
+  inferSearchConsolePropertyType,
+  profileIdSchemaField,
+  resolveSearchConsoleSiteUrl,
+  siteUrlSchemaField
+} from "../../search-console/search-console-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const searchConsoleSiteContextSchema = z.object({
+  siteUrl: siteUrlSchemaField,
+  profileId: profileIdSchemaField
+});
+async function searchConsoleSiteContextHandler(params) {
+  try {
+    const resolvedSiteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);
+    const sites = await listSearchConsoleSites();
+    const matchingSite = sites.find((site) => site.siteUrl === resolvedSiteUrl);
+    if (!matchingSite) {
+      throw new Error(
+        `Search Console site "${resolvedSiteUrl}" is not accessible with the current credentials. Call gsc_list_accessible_sites to see the available properties.`
+      );
+    }
+    return object(
+      stripNulls({
+        site_url: resolvedSiteUrl,
+        source: params.siteUrl?.trim() ? "explicit_parameter" : "future_profile_resolution",
+        property_type: inferSearchConsolePropertyType(resolvedSiteUrl),
+        permission_level: matchingSite.permissionLevel?.toLowerCase(),
+        profile_id: params.profileId?.trim() || void 0,
+        is_accessible: true
+      })
+    );
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "Failed to resolve Search Console site context");
+  }
+}
+export {
+  searchConsoleSiteContextHandler,
+  searchConsoleSiteContextSchema
+};
+//# sourceMappingURL=site-context.js.map

package/dist/src/tools/search-console/site-context.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/search-console/site-context.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { listSearchConsoleSites } from \"../../services/search-console/search-console-client.js\";\nimport {\n  inferSearchConsolePropertyType,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  siteUrlSchemaField,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleSiteContextSchema = z.object({\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n});\n\nexport async function searchConsoleSiteContextHandler(\n  params: z.infer<typeof searchConsoleSiteContextSchema>\n) {\n  try {\n    const resolvedSiteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const sites = await listSearchConsoleSites();\n    const matchingSite = sites.find((site) => site.siteUrl === resolvedSiteUrl);\n\n    if (!matchingSite) {\n      throw new Error(\n        `Search Console site \"${resolvedSiteUrl}\" is not accessible with the current credentials. Call gsc_list_accessible_sites to see the available properties.`\n      );\n    }\n\n    return object(\n      stripNulls({\n        site_url: resolvedSiteUrl,\n        source: params.siteUrl?.trim() ? \"explicit_parameter\" : \"future_profile_resolution\",\n        property_type: inferSearchConsolePropertyType(resolvedSiteUrl),\n        permission_level: matchingSite.permissionLevel?.toLowerCase(),\n        profile_id: params.profileId?.trim() || undefined,\n        is_accessible: true,\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to resolve Search Console site context\");\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,8BAA8B;AACvC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAEpB,MAAM,iCAAiC,EAAE,OAAO;AAAA,EACrD,SAAS;AAAA,EACT,WAAW;AACb,CAAC;AAED,eAAsB,gCACpB,QACA;AACA,MAAI;AACF,UAAM,kBAAkB,4BAA4B,OAAO,SAAS,OAAO,SAAS;AACpF,UAAM,QAAQ,MAAM,uBAAuB;AAC3C,UAAM,eAAe,MAAM,KAAK,CAAC,SAAS,KAAK,YAAY,eAAe;AAE1E,QAAI,CAAC,cAAc;AACjB,YAAM,IAAI;AAAA,QACR,wBAAwB,eAAe;AAAA,MACzC;AAAA,IACF;AAEA,WAAO;AAAA,MACL,WAAW;AAAA,QACT,UAAU;AAAA,QACV,QAAQ,OAAO,SAAS,KAAK,IAAI,uBAAuB;AAAA,QACxD,eAAe,+BAA+B,eAAe;AAAA,QAC7D,kBAAkB,aAAa,iBAAiB,YAAY;AAAA,QAC5D,YAAY,OAAO,WAAW,KAAK,KAAK;AAAA,QACxC,eAAe;AAAA,MACjB,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,+CAA+C;AAAA,EACnG;AACF;",
+  "names": []
+}

package/dist/src/tools/search-console/visibility-declines.js

@@ -0,0 +1,146 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { querySearchConsolePerformance } from "../../services/search-console/search-console-client.js";
+import {
+  buildComparisonMap,
+  buildSearchConsoleQueryBody,
+  computeChangePercent,
+  currentEndDateSchemaField,
+  currentStartDateSchemaField,
+  previousEndDateSchemaField,
+  previousStartDateSchemaField,
+  profileIdSchemaField,
+  resolveSearchConsoleSiteUrl,
+  searchTypeSchemaField,
+  siteUrlSchemaField,
+  normalizeSearchConsoleRow
+} from "../../search-console/search-console-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const searchConsoleVisibilityDeclinesSchema = z.object({
+  currentStartDate: currentStartDateSchemaField,
+  currentEndDate: currentEndDateSchemaField,
+  previousStartDate: previousStartDateSchemaField,
+  previousEndDate: previousEndDateSchemaField,
+  siteUrl: siteUrlSchemaField,
+  profileId: profileIdSchemaField,
+  searchType: searchTypeSchemaField,
+  entityType: z.enum(["page", "pattern"]).optional().describe("Analyze individual pages or a filtered page pattern."),
+  pageContains: z.string().optional().describe("Optional page substring filter to focus the visibility decline analysis."),
+  pageRegex: z.string().optional().describe("Optional regex page filter to focus the decline analysis."),
+  minImpressions: z.number().min(1).optional().describe("Minimum previous-period impressions required to include an entity in the decline analysis.")
+});
+async function searchConsoleVisibilityDeclinesHandler(params) {
+  try {
+    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);
+    const entityType = params.entityType ?? "page";
+    const minImpressions = params.minImpressions ?? 50;
+    const dimensionFilters = [];
+    if (params.pageContains?.trim()) {
+      dimensionFilters.push({
+        dimension: "page",
+        operator: "contains",
+        expression: params.pageContains.trim()
+      });
+    }
+    if (params.pageRegex?.trim()) {
+      dimensionFilters.push({
+        dimension: "page",
+        operator: "includingRegex",
+        expression: params.pageRegex.trim()
+      });
+    }
+    const [currentResponse, previousResponse] = await Promise.all([
+      querySearchConsolePerformance(
+        siteUrl,
+        buildSearchConsoleQueryBody({
+          startDate: params.currentStartDate,
+          endDate: params.currentEndDate,
+          dimensions: ["page"],
+          searchType: params.searchType,
+          dimensionFilters,
+          rowLimit: 250
+        })
+      ),
+      querySearchConsolePerformance(
+        siteUrl,
+        buildSearchConsoleQueryBody({
+          startDate: params.previousStartDate,
+          endDate: params.previousEndDate,
+          dimensions: ["page"],
+          searchType: params.searchType,
+          dimensionFilters,
+          rowLimit: 250
+        })
+      )
+    ]);
+    const currentRows = (currentResponse.rows ?? []).map(
+      (row) => normalizeSearchConsoleRow(row, ["page"])
+    );
+    const previousRows = (previousResponse.rows ?? []).map(
+      (row) => normalizeSearchConsoleRow(row, ["page"])
+    );
+    const previousMap = buildComparisonMap(previousRows, (row) => row.dimensions.page);
+    const currentMap = buildComparisonMap(currentRows, (row) => row.dimensions.page);
+    const allPages = /* @__PURE__ */ new Set([
+      ...currentRows.map((row) => row.dimensions.page),
+      ...previousRows.map((row) => row.dimensions.page)
+    ]);
+    const declines = Array.from(allPages).map((page) => {
+      const currentRow = currentMap.get(page);
+      const previousRow = previousMap.get(page);
+      return {
+        page,
+        current_clicks: currentRow?.clicks ?? 0,
+        previous_clicks: previousRow?.clicks ?? 0,
+        current_impressions: currentRow?.impressions ?? 0,
+        previous_impressions: previousRow?.impressions ?? 0,
+        current_ctr_percent: currentRow?.ctr_percent ?? 0,
+        previous_ctr_percent: previousRow?.ctr_percent ?? 0,
+        current_position: currentRow?.position ?? 0,
+        previous_position: previousRow?.position ?? 0
+      };
+    }).filter((row) => row.previous_impressions >= minImpressions).map((row) => ({
+      ...row,
+      clicks_change_percent: computeChangePercent(row.current_clicks, row.previous_clicks),
+      impressions_change_percent: computeChangePercent(
+        row.current_impressions,
+        row.previous_impressions
+      ),
+      ctr_change_percent: computeChangePercent(row.current_ctr_percent, row.previous_ctr_percent),
+      position_change: row.current_position - row.previous_position
+    })).filter(
+      (row) => (row.clicks_change_percent ?? 0) < 0 || (row.impressions_change_percent ?? 0) < 0 || row.position_change > 0
+    ).sort((left, right) => (left.clicks_change_percent ?? 0) - (right.clicks_change_percent ?? 0));
+    return object(
+      stripNulls({
+        site_url: siteUrl,
+        comparison: {
+          current_period: {
+            start_date: params.currentStartDate,
+            end_date: params.currentEndDate
+          },
+          previous_period: {
+            start_date: params.previousStartDate,
+            end_date: params.previousEndDate
+          }
+        },
+        filters: {
+          entity_type: entityType,
+          page_contains: params.pageContains,
+          page_regex: params.pageRegex,
+          min_impressions: minImpressions
+        },
+        declines
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to detect Search Console visibility declines"
+    );
+  }
+}
+export {
+  searchConsoleVisibilityDeclinesHandler,
+  searchConsoleVisibilityDeclinesSchema
+};
+//# sourceMappingURL=visibility-declines.js.map

package/dist/src/tools/search-console/visibility-declines.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/search-console/visibility-declines.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { querySearchConsolePerformance } from \"../../services/search-console/search-console-client.js\";\nimport {\n  buildComparisonMap,\n  buildSearchConsoleQueryBody,\n  computeChangePercent,\n  currentEndDateSchemaField,\n  currentStartDateSchemaField,\n  previousEndDateSchemaField,\n  previousStartDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  normalizeSearchConsoleRow,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleVisibilityDeclinesSchema = z.object({\n  currentStartDate: currentStartDateSchemaField,\n  currentEndDate: currentEndDateSchemaField,\n  previousStartDate: previousStartDateSchemaField,\n  previousEndDate: previousEndDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  entityType: z\n    .enum([\"page\", \"pattern\"])\n    .optional()\n    .describe(\"Analyze individual pages or a filtered page pattern.\"),\n  pageContains: z\n    .string()\n    .optional()\n    .describe(\"Optional page substring filter to focus the visibility decline analysis.\"),\n  pageRegex: z\n    .string()\n    .optional()\n    .describe(\"Optional regex page filter to focus the decline analysis.\"),\n  minImpressions: z\n    .number()\n    .min(1)\n    .optional()\n    .describe(\"Minimum previous-period impressions required to include an entity in the decline analysis.\"),\n});\n\nexport async function searchConsoleVisibilityDeclinesHandler(\n  params: z.infer<typeof searchConsoleVisibilityDeclinesSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const entityType = params.entityType ?? \"page\";\n    const minImpressions = params.minImpressions ?? 50;\n    const dimensionFilters = [];\n\n    if (params.pageContains?.trim()) {\n      dimensionFilters.push({\n        dimension: \"page\",\n        operator: \"contains\",\n        expression: params.pageContains.trim(),\n      });\n    }\n\n    if (params.pageRegex?.trim()) {\n      dimensionFilters.push({\n        dimension: \"page\",\n        operator: \"includingRegex\",\n        expression: params.pageRegex.trim(),\n      });\n    }\n\n    const [currentResponse, previousResponse] = await Promise.all([\n      querySearchConsolePerformance(\n        siteUrl,\n        buildSearchConsoleQueryBody({\n          startDate: params.currentStartDate,\n          endDate: params.currentEndDate,\n          dimensions: [\"page\"],\n          searchType: params.searchType,\n          dimensionFilters,\n          rowLimit: 250,\n        })\n      ),\n      querySearchConsolePerformance(\n        siteUrl,\n        buildSearchConsoleQueryBody({\n          startDate: params.previousStartDate,\n          endDate: params.previousEndDate,\n          dimensions: [\"page\"],\n          searchType: params.searchType,\n          dimensionFilters,\n          rowLimit: 250,\n        })\n      ),\n    ]);\n\n    const currentRows = (currentResponse.rows ?? []).map((row) =>\n      normalizeSearchConsoleRow(row, [\"page\"])\n    );\n    const previousRows = (previousResponse.rows ?? []).map((row) =>\n      normalizeSearchConsoleRow(row, [\"page\"])\n    );\n    const previousMap = buildComparisonMap(previousRows, (row) => row.dimensions.page);\n\n    const currentMap = buildComparisonMap(currentRows, (row) => row.dimensions.page);\n    const allPages = new Set([\n      ...currentRows.map((row) => row.dimensions.page),\n      ...previousRows.map((row) => row.dimensions.page),\n    ]);\n\n    const declines = Array.from(allPages)\n      .map((page) => {\n        const currentRow = currentMap.get(page);\n        const previousRow = previousMap.get(page);\n        return {\n          page,\n          current_clicks: currentRow?.clicks ?? 0,\n          previous_clicks: previousRow?.clicks ?? 0,\n          current_impressions: currentRow?.impressions ?? 0,\n          previous_impressions: previousRow?.impressions ?? 0,\n          current_ctr_percent: currentRow?.ctr_percent ?? 0,\n          previous_ctr_percent: previousRow?.ctr_percent ?? 0,\n          current_position: currentRow?.position ?? 0,\n          previous_position: previousRow?.position ?? 0,\n        };\n      })\n      .filter((row) => row.previous_impressions >= minImpressions)\n      .map((row) => ({\n        ...row,\n        clicks_change_percent: computeChangePercent(row.current_clicks, row.previous_clicks),\n        impressions_change_percent: computeChangePercent(\n          row.current_impressions,\n          row.previous_impressions\n        ),\n        ctr_change_percent: computeChangePercent(row.current_ctr_percent, row.previous_ctr_percent),\n        position_change: row.current_position - row.previous_position,\n      }))\n      .filter(\n        (row) =>\n          (row.clicks_change_percent ?? 0) < 0 ||\n          (row.impressions_change_percent ?? 0) < 0 ||\n          row.position_change > 0\n      )\n      .sort((left, right) => (left.clicks_change_percent ?? 0) - (right.clicks_change_percent ?? 0));\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        comparison: {\n          current_period: {\n            start_date: params.currentStartDate,\n            end_date: params.currentEndDate,\n          },\n          previous_period: {\n            start_date: params.previousStartDate,\n            end_date: params.previousEndDate,\n          },\n        },\n        filters: {\n          entity_type: entityType,\n          page_contains: params.pageContains,\n          page_regex: params.pageRegex,\n          min_impressions: minImpressions,\n        },\n        declines,\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to detect Search Console visibility declines\"\n    );\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/vtex/computed-price.js

@@ -0,0 +1,48 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { formatVtexError } from "../../services/vtex/vtex-api.js";
+import { getComputedPrice } from "../../services/vtex/vtex-pricing.js";
+import { moneyFromCentsOptional } from "../../utils/money.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const computedPriceSchema = z.object({
+  itemId: z.string().min(1).describe("SKU item identifier"),
+  priceTableId: z.string().min(1).describe("Price table or trade policy identifier"),
+  categoryId: z.number().int().positive().describe("Category identifier"),
+  brandId: z.number().int().positive().describe("Brand identifier"),
+  quantity: z.number().int().positive().describe("SKU quantity context")
+});
+async function computedPriceHandler({
+  itemId,
+  priceTableId,
+  categoryId,
+  brandId,
+  quantity
+}) {
+  try {
+    const computedPrice = await getComputedPrice(itemId, priceTableId, {
+      categoryId,
+      brandId,
+      quantity
+    });
+    return object(
+      stripNulls({
+        item_id: itemId,
+        price_table_id: priceTableId,
+        trade_policy_id: computedPrice.tradePolicyId,
+        list_price: moneyFromCentsOptional(computedPrice.listPrice),
+        cost_price: moneyFromCentsOptional(computedPrice.costPrice),
+        selling_price: moneyFromCentsOptional(computedPrice.sellingPrice),
+        price_valid_until: computedPrice.priceValidUntil
+      })
+    );
+  } catch (err) {
+    return error(
+      formatVtexError(err, `Failed to fetch computed price for item ${itemId} and table ${priceTableId}`)
+    );
+  }
+}
+export {
+  computedPriceHandler,
+  computedPriceSchema
+};
+//# sourceMappingURL=computed-price.js.map

package/dist/src/tools/vtex/computed-price.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/computed-price.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { getComputedPrice } from \"../../services/vtex/vtex-pricing.js\";\nimport { moneyFromCentsOptional } from \"../../utils/money.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const computedPriceSchema = z.object({\n  itemId: z.string().min(1).describe(\"SKU item identifier\"),\n  priceTableId: z.string().min(1).describe(\"Price table or trade policy identifier\"),\n  categoryId: z.number().int().positive().describe(\"Category identifier\"),\n  brandId: z.number().int().positive().describe(\"Brand identifier\"),\n  quantity: z.number().int().positive().describe(\"SKU quantity context\"),\n});\n\nexport async function computedPriceHandler({\n  itemId,\n  priceTableId,\n  categoryId,\n  brandId,\n  quantity,\n}: z.infer<typeof computedPriceSchema>) {\n  try {\n    const computedPrice = await getComputedPrice(itemId, priceTableId, {\n      categoryId,\n      brandId,\n      quantity,\n    });\n\n    return object(\n      stripNulls({\n        item_id: itemId,\n        price_table_id: priceTableId,\n        trade_policy_id: computedPrice.tradePolicyId,\n        list_price: moneyFromCentsOptional(computedPrice.listPrice),\n        cost_price: moneyFromCentsOptional(computedPrice.costPrice),\n        selling_price: moneyFromCentsOptional(computedPrice.sellingPrice),\n        price_valid_until: computedPrice.priceValidUntil,\n      })\n    );\n  } catch (err) {\n    return error(\n      formatVtexError(err, `Failed to fetch computed price for item ${itemId} and table ${priceTableId}`)\n    );\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AACjC,SAAS,8BAA8B;AACvC,SAAS,kBAAkB;AAEpB,MAAM,sBAAsB,EAAE,OAAO;AAAA,EAC1C,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,qBAAqB;AAAA,EACxD,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,wCAAwC;AAAA,EACjF,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,qBAAqB;AAAA,EACtE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,kBAAkB;AAAA,EAChE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,sBAAsB;AACvE,CAAC;AAED,eAAsB,qBAAqB;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAwC;AACtC,MAAI;AACF,UAAM,gBAAgB,MAAM,iBAAiB,QAAQ,cAAc;AAAA,MACjE;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,WAAO;AAAA,MACL,WAAW;AAAA,QACT,SAAS;AAAA,QACT,gBAAgB;AAAA,QAChB,iBAAiB,cAAc;AAAA,QAC/B,YAAY,uBAAuB,cAAc,SAAS;AAAA,QAC1D,YAAY,uBAAuB,cAAc,SAAS;AAAA,QAC1D,eAAe,uBAAuB,cAAc,YAAY;AAAA,QAChE,mBAAmB,cAAc;AAAA,MACnC,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,gBAAgB,KAAK,2CAA2C,MAAM,cAAc,YAAY,EAAE;AAAA,IACpG;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/src/tools/vtex/index.js

@@ -0,0 +1,11 @@
+export * from "./orders-summary.js";
+export * from "./order-details.js";
+export * from "./inventory-check.js";
+export * from "./warehouse-inventory.js";
+export * from "./update-inventory.js";
+export * from "./update-lead-time.js";
+export * from "./sku-price.js";
+export * from "./computed-price.js";
+export * from "./product-offers.js";
+export * from "./sku-offers.js";
+//# sourceMappingURL=index.js.map

package/dist/src/tools/vtex/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/index.ts"],
+  "sourcesContent": ["export * from \"./orders-summary.js\";\nexport * from \"./order-details.js\";\nexport * from \"./inventory-check.js\";\nexport * from \"./warehouse-inventory.js\";\nexport * from \"./update-inventory.js\";\nexport * from \"./update-lead-time.js\";\nexport * from \"./sku-price.js\";\nexport * from \"./computed-price.js\";\nexport * from \"./product-offers.js\";\nexport * from \"./sku-offers.js\";\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/src/tools/vtex/inventory-check.js

@@ -0,0 +1,148 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { formatVtexError } from "../../services/vtex/vtex-api.js";
+import { getInventoryBySkuBatch } from "../../services/vtex/vtex-logistics.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const MAX_SKU_IDS = 50;
+const MAX_CONCURRENT_REQUESTS = 10;
+const MAX_RETRIES_PER_SKU = 2;
+function inferHealthStatus(globalAvailableQuantity, hasUnlimitedQuantity) {
+  if (hasUnlimitedQuantity) {
+    return "HEALTHY";
+  }
+  if (globalAvailableQuantity <= 0) {
+    return "OUT_OF_STOCK";
+  }
+  if (globalAvailableQuantity < 5) {
+    return "CRITICAL_LOW_STOCK";
+  }
+  if (globalAvailableQuantity < 20) {
+    return "LOW_STOCK";
+  }
+  return "HEALTHY";
+}
+function toNumber(value) {
+  const parsedValue = Number(value);
+  return Number.isFinite(parsedValue) ? parsedValue : 0;
+}
+function formatCompactUtcDate(dateTime) {
+  if (!dateTime) {
+    return "";
+  }
+  const match = dateTime.match(/^(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2})/);
+  if (!match) {
+    return dateTime;
+  }
+  return `${match[1]} ${match[2]}`;
+}
+const inventoryCheckSchema = z.object({
+  skuIds: z.array(z.string().trim().min(1).describe("SKU identifier")).min(1).max(MAX_SKU_IDS).describe("List of SKU identifiers to fetch (up to 50 IDs)")
+});
+async function inventoryCheckHandler({ skuIds }) {
+  try {
+    const uniqueSkuIds = Array.from(new Set(skuIds));
+    const batchResult = await getInventoryBySkuBatch(uniqueSkuIds, {
+      maxConcurrency: MAX_CONCURRENT_REQUESTS,
+      maxRetries: MAX_RETRIES_PER_SKU
+    });
+    const hasAnyTimeToRefill = batchResult.successful.some(
+      ({ document }) => (Array.isArray(document.balance) ? document.balance : []).some(
+        (balance) => typeof balance.timeToRefill === "string" && balance.timeToRefill.trim().length > 0
+      )
+    );
+    const hasAnyDateOfSupplyUtc = batchResult.successful.some(
+      ({ document }) => (Array.isArray(document.balance) ? document.balance : []).some(
+        (balance) => typeof balance.dateOfSupplyUtc === "string" && balance.dateOfSupplyUtc.trim().length > 0
+      )
+    );
+    const warehouseBalanceSchema = ["warehouseName", "totalQuantity", "reservedQuantity", "hasUnlimitedQuantity"];
+    if (hasAnyTimeToRefill) {
+      warehouseBalanceSchema.push("timeToRefill");
+    }
+    if (hasAnyDateOfSupplyUtc) {
+      warehouseBalanceSchema.push("dateOfSupplyUtc");
+    }
+    const inventory = batchResult.successful.map(({ skuId, document }) => {
+      const balances = Array.isArray(document.balance) ? document.balance : [];
+      const warehouses = balances.map((balance) => {
+        const totalQuantity = toNumber(balance.totalQuantity);
+        const reservedQuantity = toNumber(balance.reservedQuantity);
+        const availableQuantityRaw = balance.availableQuantity;
+        const availableQuantity = availableQuantityRaw === void 0 ? Math.max(0, totalQuantity - reservedQuantity) : toNumber(availableQuantityRaw);
+        const hasUnlimitedQuantity2 = Boolean(
+          balance.hasUnlimitedQuantity ?? balance.isUnlimited ?? false
+        );
+        const warehouseBase = [
+          balance.warehouseName ?? balance.warehouseId ?? "unknown",
+          totalQuantity,
+          reservedQuantity,
+          hasUnlimitedQuantity2
+        ];
+        if (hasAnyTimeToRefill && hasAnyDateOfSupplyUtc) {
+          return [
+            ...warehouseBase,
+            balance.timeToRefill ?? "",
+            formatCompactUtcDate(balance.dateOfSupplyUtc)
+          ];
+        }
+        if (hasAnyTimeToRefill) {
+          return [...warehouseBase, balance.timeToRefill ?? ""];
+        }
+        if (hasAnyDateOfSupplyUtc) {
+          return [...warehouseBase, formatCompactUtcDate(balance.dateOfSupplyUtc)];
+        }
+        return warehouseBase;
+      });
+      const globalAvailableQuantity = balances.reduce((accumulator, balance) => {
+        const totalQuantity = toNumber(balance.totalQuantity);
+        const reservedQuantity = toNumber(balance.reservedQuantity);
+        const availableQuantityRaw = balance.availableQuantity;
+        const availableQuantity = availableQuantityRaw === void 0 ? Math.max(0, totalQuantity - reservedQuantity) : toNumber(availableQuantityRaw);
+        return accumulator + availableQuantity;
+      }, 0);
+      const hasUnlimitedQuantity = balances.some(
+        (balance) => Boolean(balance.hasUnlimitedQuantity ?? balance.isUnlimited ?? false)
+      );
+      const skuRow = [
+        document.skuId ?? skuId,
+        globalAvailableQuantity,
+        inferHealthStatus(globalAvailableQuantity, hasUnlimitedQuantity)
+      ];
+      return {
+        sku: skuRow,
+        warehouses
+      };
+    });
+    return object(
+      stripNulls({
+        metadata: {
+          requested_ids: skuIds.length,
+          unique_ids: uniqueSkuIds.length,
+          max_parallel_requests: MAX_CONCURRENT_REQUESTS,
+          successful_items: batchResult.successful.length,
+          failed_items: batchResult.failed.length,
+          has_failures: batchResult.failed.length > 0
+        },
+        inventory_schema: {
+          sku: ["sku_id", "global_available_quantity", "health_status"],
+          warehouse_balance: warehouseBalanceSchema
+        },
+        inventory,
+        failures: batchResult.failed.map((failure) => ({
+          sku_id: failure.skuId,
+          message: failure.message,
+          status_code: failure.statusCode,
+          attempts: failure.attempts,
+          retryable: failure.retryable
+        }))
+      })
+    );
+  } catch (err) {
+    return error(formatVtexError(err, "Failed to check inventory batch"));
+  }
+}
+export {
+  inventoryCheckHandler,
+  inventoryCheckSchema
+};
+//# sourceMappingURL=inventory-check.js.map

package/dist/src/tools/vtex/inventory-check.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/inventory-check.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { getInventoryBySkuBatch } from \"../../services/vtex/vtex-logistics.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\ntype HealthStatus = \"HEALTHY\" | \"LOW_STOCK\" | \"CRITICAL_LOW_STOCK\" | \"OUT_OF_STOCK\";\ntype SkuInventoryRow = [string, number, HealthStatus];\ntype WarehouseBalanceBaseRow = [string, number, number, boolean];\ntype WarehouseBalanceWithRefillRow = [...WarehouseBalanceBaseRow, string];\ntype WarehouseBalanceWithDateRow = [...WarehouseBalanceBaseRow, string];\ntype WarehouseBalanceFullRow = [...WarehouseBalanceBaseRow, string, string];\ntype WarehouseBalanceRow =\n  | WarehouseBalanceBaseRow\n  | WarehouseBalanceWithRefillRow\n  | WarehouseBalanceWithDateRow\n  | WarehouseBalanceFullRow;\n\nconst MAX_SKU_IDS = 50;\nconst MAX_CONCURRENT_REQUESTS = 10;\nconst MAX_RETRIES_PER_SKU = 2;\n\nfunction inferHealthStatus(globalAvailableQuantity: number, hasUnlimitedQuantity: boolean): HealthStatus {\n  if (hasUnlimitedQuantity) {\n    return \"HEALTHY\";\n  }\n\n  if (globalAvailableQuantity <= 0) {\n    return \"OUT_OF_STOCK\";\n  }\n\n  if (globalAvailableQuantity < 5) {\n    return \"CRITICAL_LOW_STOCK\";\n  }\n\n  if (globalAvailableQuantity < 20) {\n    return \"LOW_STOCK\";\n  }\n\n  return \"HEALTHY\";\n}\n\nfunction toNumber(value: unknown): number {\n  const parsedValue = Number(value);\n  return Number.isFinite(parsedValue) ? parsedValue : 0;\n}\n\nfunction formatCompactUtcDate(dateTime?: string): string {\n  if (!dateTime) {\n    return \"\";\n  }\n\n  const match = dateTime.match(/^(\\d{4}-\\d{2}-\\d{2})T(\\d{2}:\\d{2})/);\n  if (!match) {\n    return dateTime;\n  }\n\n  return `${match[1]} ${match[2]}`;\n}\n\nexport const inventoryCheckSchema = z.object({\n  skuIds: z\n    .array(z.string().trim().min(1).describe(\"SKU identifier\"))\n    .min(1)\n    .max(MAX_SKU_IDS)\n    .describe(\"List of SKU identifiers to fetch (up to 50 IDs)\"),\n});\n\nexport async function inventoryCheckHandler({ skuIds }: z.infer<typeof inventoryCheckSchema>) {\n  try {\n    const uniqueSkuIds = Array.from(new Set(skuIds));\n    const batchResult = await getInventoryBySkuBatch(uniqueSkuIds, {\n      maxConcurrency: MAX_CONCURRENT_REQUESTS,\n      maxRetries: MAX_RETRIES_PER_SKU,\n    });\n\n    const hasAnyTimeToRefill = batchResult.successful.some(({ document }) =>\n      (Array.isArray(document.balance) ? document.balance : []).some(\n        (balance) => typeof balance.timeToRefill === \"string\" && balance.timeToRefill.trim().length > 0\n      )\n    );\n    const hasAnyDateOfSupplyUtc = batchResult.successful.some(({ document }) =>\n      (Array.isArray(document.balance) ? document.balance : []).some(\n        (balance) =>\n          typeof balance.dateOfSupplyUtc === \"string\" && balance.dateOfSupplyUtc.trim().length > 0\n      )\n    );\n\n    const warehouseBalanceSchema = [\"warehouseName\", \"totalQuantity\", \"reservedQuantity\", \"hasUnlimitedQuantity\"];\n    if (hasAnyTimeToRefill) {\n      warehouseBalanceSchema.push(\"timeToRefill\");\n    }\n    if (hasAnyDateOfSupplyUtc) {\n      warehouseBalanceSchema.push(\"dateOfSupplyUtc\");\n    }\n\n    const inventory = batchResult.successful.map(({ skuId, document }) => {\n      const balances = Array.isArray(document.balance) ? document.balance : [];\n      const warehouses: WarehouseBalanceRow[] = balances.map((balance) => {\n        const totalQuantity = toNumber(balance.totalQuantity);\n        const reservedQuantity = toNumber(balance.reservedQuantity);\n        const availableQuantityRaw = balance.availableQuantity;\n        const availableQuantity =\n          availableQuantityRaw === undefined\n            ? Math.max(0, totalQuantity - reservedQuantity)\n            : toNumber(availableQuantityRaw);\n        const hasUnlimitedQuantity = Boolean(\n          balance.hasUnlimitedQuantity ?? balance.isUnlimited ?? false\n        );\n\n        const warehouseBase: WarehouseBalanceBaseRow = [\n          balance.warehouseName ?? balance.warehouseId ?? \"unknown\",\n          totalQuantity,\n          reservedQuantity,\n          hasUnlimitedQuantity,\n        ];\n\n        if (hasAnyTimeToRefill && hasAnyDateOfSupplyUtc) {\n          return [\n            ...warehouseBase,\n            balance.timeToRefill ?? \"\",\n            formatCompactUtcDate(balance.dateOfSupplyUtc),\n          ];\n        }\n\n        if (hasAnyTimeToRefill) {\n          return [...warehouseBase, balance.timeToRefill ?? \"\"];\n        }\n\n        if (hasAnyDateOfSupplyUtc) {\n          return [...warehouseBase, formatCompactUtcDate(balance.dateOfSupplyUtc)];\n        }\n\n        return warehouseBase;\n      });\n\n      const globalAvailableQuantity = balances.reduce((accumulator, balance) => {\n        const totalQuantity = toNumber(balance.totalQuantity);\n        const reservedQuantity = toNumber(balance.reservedQuantity);\n        const availableQuantityRaw = balance.availableQuantity;\n        const availableQuantity =\n          availableQuantityRaw === undefined\n            ? Math.max(0, totalQuantity - reservedQuantity)\n            : toNumber(availableQuantityRaw);\n        return accumulator + availableQuantity;\n      }, 0);\n      const hasUnlimitedQuantity = balances.some((balance) =>\n        Boolean(balance.hasUnlimitedQuantity ?? balance.isUnlimited ?? false)\n      );\n      const skuRow: SkuInventoryRow = [\n        document.skuId ?? skuId,\n        globalAvailableQuantity,\n        inferHealthStatus(globalAvailableQuantity, hasUnlimitedQuantity),\n      ];\n\n      return {\n        sku: skuRow,\n        warehouses,\n      };\n    });\n\n    return object(\n      stripNulls({\n        metadata: {\n          requested_ids: skuIds.length,\n          unique_ids: uniqueSkuIds.length,\n          max_parallel_requests: MAX_CONCURRENT_REQUESTS,\n          successful_items: batchResult.successful.length,\n          failed_items: batchResult.failed.length,\n          has_failures: batchResult.failed.length > 0,\n        },\n        inventory_schema: {\n          sku: [\"sku_id\", \"global_available_quantity\", \"health_status\"],\n          warehouse_balance: warehouseBalanceSchema,\n        },\n        inventory,\n        failures: batchResult.failed.map((failure) => ({\n          sku_id: failure.skuId,\n          message: failure.message,\n          status_code: failure.statusCode,\n          attempts: failure.attempts,\n          retryable: failure.retryable,\n        })),\n      })\n    );\n  } catch (err) {\n    return error(formatVtexError(err, \"Failed to check inventory batch\"));\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["hasUnlimitedQuantity"]
+}

package/dist/src/tools/vtex/order-details.js

@@ -0,0 +1,56 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { getOrderDocumentsBatch } from "../../services/vtex/vtex-orders.js";
+import { formatVtexError } from "../../services/vtex/vtex-api.js";
+import { formatOrderDetails } from "../../utils/format-order-details.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const MAX_ORDER_IDS = 50;
+const MAX_CONCURRENT_REQUESTS = 10;
+const MAX_RETRIES_PER_ORDER = 2;
+const orderDetailsSchema = z.object({
+  orderIds: z.array(z.string().trim().min(3).describe("VTEX order identifier")).min(1).max(MAX_ORDER_IDS).describe("List of VTEX order identifiers to fetch (up to 50 IDs)"),
+  reason: z.string().trim().min(1).optional().describe("Optional reason for requesting unmasked PII data when required")
+});
+async function orderDetailsHandler({ orderIds, reason }) {
+  try {
+    const uniqueOrderIds = Array.from(new Set(orderIds));
+    const batchResult = await getOrderDocumentsBatch(uniqueOrderIds, {
+      reason,
+      maxConcurrency: MAX_CONCURRENT_REQUESTS,
+      maxRetries: MAX_RETRIES_PER_ORDER
+    });
+    const formattedOrders = batchResult.successful.map(({ document }) => formatOrderDetails(document));
+    return object(
+      stripNulls({
+        metadata: {
+          requested: uniqueOrderIds.length,
+          successful: batchResult.successful.length,
+          failed: batchResult.failed.length
+        },
+        schemas: {
+          item: ["id", "ref", "name", "qty", "price", "list"],
+          shipping: ["carrier", "estimate", "delivery_date"],
+          payment: ["system", "installments", "value"],
+          payment_validation: {
+            payments_total: "Sum of all payment values",
+            payment_delta: "Difference between payments_total and order total",
+            payment_mismatch: "True if |payment_delta| > 0.5 (potential issue)"
+          }
+        },
+        orders: formattedOrders,
+        failures: batchResult.failed.map((failure) => ({
+          order_id: failure.orderId,
+          message: failure.message,
+          status_code: failure.statusCode
+        }))
+      })
+    );
+  } catch (err) {
+    return error(formatVtexError(err, "Failed to fetch order details batch"));
+  }
+}
+export {
+  orderDetailsHandler,
+  orderDetailsSchema
+};
+//# sourceMappingURL=order-details.js.map

package/dist/src/tools/vtex/order-details.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/order-details.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { getOrderDocumentsBatch } from \"../../services/vtex/vtex-orders.js\";\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { formatOrderDetails } from \"../../utils/format-order-details.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nconst MAX_ORDER_IDS = 50;\nconst MAX_CONCURRENT_REQUESTS = 10;\nconst MAX_RETRIES_PER_ORDER = 2;\n\nexport const orderDetailsSchema = z.object({\n  orderIds: z\n    .array(z.string().trim().min(3).describe(\"VTEX order identifier\"))\n    .min(1)\n    .max(MAX_ORDER_IDS)\n    .describe(\"List of VTEX order identifiers to fetch (up to 50 IDs)\"),\n  reason: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\"Optional reason for requesting unmasked PII data when required\"),\n});\n\nexport async function orderDetailsHandler({ orderIds, reason }: z.infer<typeof orderDetailsSchema>) {\n  try {\n    const uniqueOrderIds = Array.from(new Set(orderIds));\n    const batchResult = await getOrderDocumentsBatch(uniqueOrderIds, {\n      reason,\n      maxConcurrency: MAX_CONCURRENT_REQUESTS,\n      maxRetries: MAX_RETRIES_PER_ORDER,\n    });\n    \n    const formattedOrders = batchResult.successful.map(({ document }) => formatOrderDetails(document));\n\n    return object(\n      stripNulls({\n        metadata: {\n          requested: uniqueOrderIds.length,\n          successful: batchResult.successful.length,\n          failed: batchResult.failed.length,\n        },\n        schemas: {\n          item: [\"id\", \"ref\", \"name\", \"qty\", \"price\", \"list\"],\n          shipping: [\"carrier\", \"estimate\", \"delivery_date\"],\n          payment: [\"system\", \"installments\", \"value\"],\n          payment_validation: {\n            payments_total: \"Sum of all payment values\",\n            payment_delta: \"Difference between payments_total and order total\",\n            payment_mismatch: \"True if |payment_delta| > 0.5 (potential issue)\",\n          },\n        },\n        orders: formattedOrders,\n        failures: batchResult.failed.map((failure) => ({\n          order_id: failure.orderId,\n          message: failure.message,\n          status_code: failure.statusCode,\n        })),\n      })\n    );\n  } catch (err) {\n    return error(formatVtexError(err, \"Failed to fetch order details batch\"));\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,8BAA8B;AACvC,SAAS,uBAAuB;AAChC,SAAS,0BAA0B;AACnC,SAAS,kBAAkB;AAE3B,MAAM,gBAAgB;AACtB,MAAM,0BAA0B;AAChC,MAAM,wBAAwB;AAEvB,MAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,UAAU,EACP,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,uBAAuB,CAAC,EAChE,IAAI,CAAC,EACL,IAAI,aAAa,EACjB,SAAS,wDAAwD;AAAA,EACpE,QAAQ,EACL,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT,SAAS,gEAAgE;AAC9E,CAAC;AAED,eAAsB,oBAAoB,EAAE,UAAU,OAAO,GAAuC;AAClG,MAAI;AACF,UAAM,iBAAiB,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC;AACnD,UAAM,cAAc,MAAM,uBAAuB,gBAAgB;AAAA,MAC/D;AAAA,MACA,gBAAgB;AAAA,MAChB,YAAY;AAAA,IACd,CAAC;AAED,UAAM,kBAAkB,YAAY,WAAW,IAAI,CAAC,EAAE,SAAS,MAAM,mBAAmB,QAAQ,CAAC;AAEjG,WAAO;AAAA,MACL,WAAW;AAAA,QACT,UAAU;AAAA,UACR,WAAW,eAAe;AAAA,UAC1B,YAAY,YAAY,WAAW;AAAA,UACnC,QAAQ,YAAY,OAAO;AAAA,QAC7B;AAAA,QACA,SAAS;AAAA,UACP,MAAM,CAAC,MAAM,OAAO,QAAQ,OAAO,SAAS,MAAM;AAAA,UAClD,UAAU,CAAC,WAAW,YAAY,eAAe;AAAA,UACjD,SAAS,CAAC,UAAU,gBAAgB,OAAO;AAAA,UAC3C,oBAAoB;AAAA,YAClB,gBAAgB;AAAA,YAChB,eAAe;AAAA,YACf,kBAAkB;AAAA,UACpB;AAAA,QACF;AAAA,QACA,QAAQ;AAAA,QACR,UAAU,YAAY,OAAO,IAAI,CAAC,aAAa;AAAA,UAC7C,UAAU,QAAQ;AAAA,UAClB,SAAS,QAAQ;AAAA,UACjB,aAAa,QAAQ;AAAA,QACvB,EAAE;AAAA,MACJ,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,gBAAgB,KAAK,qCAAqC,CAAC;AAAA,EAC1E;AACF;",
+  "names": []
+}

package/dist/src/tools/vtex/orders-summary.js

@@ -0,0 +1,83 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { listOrders } from "../../services/vtex/vtex-orders.js";
+import { formatVtexError } from "../../services/vtex/vtex-api.js";
+import { buildCurrencyMetrics } from "../../utils/currency.js";
+import { moneyFromCents } from "../../utils/money.js";
+import { normalizeOrderStatus } from "../../utils/order-status.js";
+import { createPaginationMetadata } from "../../utils/pagination.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
+function buildDateFilter(startDate, endDate) {
+  return `creationDate:[${startDate}T00:00:00.000Z TO ${endDate}T23:59:59.999Z]`;
+}
+function formatCompactDate(dateTime) {
+  if (!dateTime) {
+    return "";
+  }
+  const match = dateTime.match(/^(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2})/);
+  if (!match) {
+    return dateTime;
+  }
+  return `${match[1]} ${match[2]}`;
+}
+const ordersSchema = ["id", "date", "status", "value", "currency", "payment", "channel", "items"];
+const metricsSchema = {
+  breakdown: ["count", "revenue"]
+};
+const ordersSummarySchema = 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"),
+  page: z.number().int().min(1).max(30).optional().describe("Page number (1-30)"),
+  perPage: z.number().int().min(1).max(100).optional().describe("Orders per page (1-100)"),
+  status: z.string().optional().describe("Optional VTEX status filter (f_status)"),
+  salesChannel: z.string().optional().describe("Optional sales channel filter (f_salesChannel)"),
+  paymentName: z.string().optional().describe("Optional payment filter (f_paymentNames)"),
+  utmSource: z.string().optional().describe("Optional UTM source filter (f_UtmSource)"),
+  orderBy: z.string().optional().describe("Sort order in VTEX format, e.g. creationDate,desc")
+});
+async function ordersSummaryHandler(params) {
+  try {
+    const page = params.page ?? 1;
+    const perPage = params.perPage ?? 100;
+    const ordersResponse = await listOrders({
+      page,
+      per_page: perPage,
+      orderBy: params.orderBy,
+      f_creationDate: buildDateFilter(params.startDate, params.endDate),
+      f_status: params.status,
+      f_salesChannel: params.salesChannel,
+      f_paymentNames: params.paymentName,
+      f_UtmSource: params.utmSource
+    });
+    const orders = Array.isArray(ordersResponse.list) ? ordersResponse.list : [];
+    const metadata = createPaginationMetadata(ordersResponse.paging ?? {}, perPage, orders.length);
+    const metrics = buildCurrencyMetrics(orders);
+    const compactOrders = orders.map((order) => [
+      order.orderId,
+      formatCompactDate(order.creationDate),
+      normalizeOrderStatus(order.status),
+      moneyFromCents(order.totalValue),
+      order.currencyCode ?? "",
+      order.paymentNames ?? "",
+      order.salesChannel ?? "",
+      Number(order.totalItems ?? 0)
+    ]);
+    return object(
+      stripNulls({
+        metadata,
+        metrics_schema: metricsSchema,
+        metrics,
+        orders_schema: ordersSchema,
+        orders: compactOrders
+      })
+    );
+  } catch (err) {
+    return error(formatVtexError(err, "Failed to fetch orders summary"));
+  }
+}
+export {
+  ordersSummaryHandler,
+  ordersSummarySchema
+};
+//# sourceMappingURL=orders-summary.js.map