@yoryoboy/bi-mcp 1.10.0 → 1.13.0

package/dist/tests/meli/mercadolibre-tool-handlers-medium-batch4.test.js

@@ -0,0 +1,678 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { meliSearchItemsHandler } from "../../src/tools/mercadolibre/search-items.js";
+import { meliGetStorePerformanceHandler } from "../../src/tools/mercadolibre/get-store-performance.js";
+import { meliGetSalesByItemHandler } from "../../src/tools/mercadolibre/get-sales-by-item.js";
+import { meliGetSalesTrendHandler } from "../../src/tools/mercadolibre/get-sales-trend.js";
+import { meliGetOrderDetailsHandler } from "../../src/tools/mercadolibre/get-order-details.js";
+import { resolveMercadoLibreProfileOrSelection } from "../../src/tools/mercadolibre/profile-resolution.js";
+import { getMercadoLibreAccessForProfile } from "../../src/config/mercadolibre.js";
+import {
+  formatMercadoLibreError,
+  normalizeMercadoLibrePaging
+} from "../../src/services/mercadolibre/mercadolibre-api.js";
+import {
+  getMercadoLibreItemDetailsBatch,
+  getMercadoLibreItemDetailsWithFallbackBatch,
+  getMercadoLibreUserItemsVisits,
+  searchMercadoLibreItems
+} from "../../src/services/mercadolibre/mercadolibre-items.js";
+import {
+  getMercadoLibreOrder,
+  getMercadoLibreOrderDetailsBatch,
+  searchMercadoLibreOrders,
+  searchMercadoLibreOrdersBatch
+} from "../../src/services/mercadolibre/mercadolibre-orders.js";
+vi.mock("mcp-use/server", () => ({
+  object: vi.fn((payload) => ({ kind: "object", payload })),
+  error: vi.fn((message) => ({ kind: "error", message }))
+}));
+vi.mock("../../src/tools/mercadolibre/profile-resolution.js", () => ({
+  resolveMercadoLibreProfileOrSelection: vi.fn()
+}));
+vi.mock("../../src/config/mercadolibre.js", () => ({
+  getMercadoLibreAccessForProfile: vi.fn()
+}));
+vi.mock("../../src/services/mercadolibre/mercadolibre-api.js", () => ({
+  formatMercadoLibreError: vi.fn(
+    (err, fallback) => `formatted:${fallback}:${err instanceof Error ? err.message : String(err)}`
+  ),
+  normalizeMercadoLibrePaging: vi.fn((paging) => paging)
+}));
+vi.mock("../../src/services/mercadolibre/mercadolibre-items.js", () => ({
+  searchMercadoLibreItems: vi.fn(),
+  searchMercadoLibreItemsBatch: vi.fn(),
+  getMercadoLibreItemDetailsBatch: vi.fn(),
+  getMercadoLibreItemDetailsWithFallbackBatch: vi.fn(),
+  getMercadoLibreUserItemsVisits: vi.fn()
+}));
+vi.mock("../../src/services/mercadolibre/mercadolibre-orders.js", () => ({
+  searchMercadoLibreOrders: vi.fn(),
+  searchMercadoLibreOrdersBatch: vi.fn(),
+  getMercadoLibreOrder: vi.fn(),
+  getMercadoLibreOrderDetailsBatch: vi.fn()
+}));
+describe("MercadoLibre medium tool handlers batch 4", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    vi.mocked(resolveMercadoLibreProfileOrSelection).mockResolvedValue({
+      ok: true,
+      value: { profileId: "meli-profile-1" }
+    });
+    vi.mocked(getMercadoLibreAccessForProfile).mockResolvedValue({
+      sellerId: "seller-99",
+      scopes: ["read"],
+      expiresAt: "2026-07-01T00:00:00.000Z"
+    });
+    vi.mocked(normalizeMercadoLibrePaging).mockImplementation((paging) => paging);
+  });
+  it("searches items with the default active status and compact item rows", async () => {
+    vi.mocked(searchMercadoLibreItems).mockResolvedValue({
+      results: ["MLA1", "MLA2"],
+      paging: { total: 2, limit: 50, offset: 0 }
+    });
+    vi.mocked(getMercadoLibreItemDetailsBatch).mockResolvedValue([
+      {
+        id: "MLA1",
+        title: "Boots",
+        status: "active",
+        price: 100,
+        currency_id: "ARS",
+        available_quantity: 3,
+        sold_quantity: 8,
+        listing_type_id: "gold_special",
+        category_id: "MLA123"
+      },
+      {
+        id: "MLA2",
+        title: "Sneakers",
+        status: "paused",
+        price: 250,
+        currency_id: "USD",
+        available_quantity: 1,
+        sold_quantity: 2,
+        listing_type_id: "gold_pro",
+        category_id: "MLA456"
+      }
+    ]);
+    vi.mocked(getMercadoLibreItemDetailsWithFallbackBatch).mockResolvedValue({
+      successful: [],
+      failed: []
+    });
+    const result = await meliSearchItemsHandler({ profileId: "meli-profile-1" });
+    expect(searchMercadoLibreItems).toHaveBeenCalledWith("meli-profile-1", {
+      sellerId: "seller-99",
+      status: "active",
+      q: void 0,
+      category: void 0,
+      listingTypeId: void 0,
+      orders: void 0,
+      limit: 50,
+      offset: 0
+    });
+    expect(getMercadoLibreItemDetailsBatch).toHaveBeenCalledWith("meli-profile-1", ["MLA1", "MLA2"], [
+      "id",
+      "title",
+      "status",
+      "price",
+      "currency_id",
+      "available_quantity",
+      "sold_quantity",
+      "listing_type_id",
+      "category_id"
+    ]);
+    expect(result).toEqual({
+      kind: "object",
+      payload: {
+        profile_id: "meli-profile-1",
+        metadata: {
+          total: 2,
+          limit: 2,
+          offset: 0,
+          returned: 2,
+          has_more: false,
+          continuation: "No more pages for this query.",
+          applied_status: "active",
+          default_status_notice: "Solo se devolvieron publicaciones active por default. Tambi\xE9n se puede pedir status expl\xEDcito como paused, closed, under_review, inactive, not_yet_active, payment_required o deleted.",
+          available_status_filters: [
+            "active",
+            "paused",
+            "closed",
+            "under_review",
+            "inactive",
+            "not_yet_active",
+            "payment_required",
+            "deleted"
+          ],
+          detail_coverage: {
+            detail_failures: 0,
+            details_complete: true
+          },
+          pages_requested: 1,
+          pages_succeeded: 1,
+          pages_failed: 0,
+          universe_fully_fetched: true
+        },
+        items_schema: [
+          "item_id",
+          "title",
+          "status",
+          "price",
+          "currency_id",
+          "available_quantity",
+          "sold_quantity",
+          "listing_type_id",
+          "category_id"
+        ],
+        items: [
+          ["MLA1", "Boots", "active", 100, "ARS", 3, 8, "gold_special", "MLA123"],
+          ["MLA2", "Sneakers", "paused", 250, "USD", 1, 2, "gold_pro", "MLA456"]
+        ]
+      }
+    });
+  });
+  it("reports partial item detail coverage when fallback misses items", async () => {
+    vi.mocked(searchMercadoLibreItems).mockResolvedValue({
+      results: ["MLA1", "MLA2", "MLA3"],
+      paging: { total: 3, limit: 50, offset: 0 }
+    });
+    vi.mocked(getMercadoLibreItemDetailsBatch).mockResolvedValue([{ id: "MLA1", title: "Boots" }]);
+    vi.mocked(getMercadoLibreItemDetailsWithFallbackBatch).mockResolvedValue({
+      successful: [{ id: "MLA2", document: { id: "MLA2", title: "Sneakers" } }],
+      failed: [{ id: "MLA3", message: "missing", attempts: 2, retryable: false, statusCode: 404 }]
+    });
+    const result = await meliSearchItemsHandler({
+      profileId: "meli-profile-1",
+      status: "paused",
+      limit: 3,
+      offset: 0
+    });
+    expect(getMercadoLibreItemDetailsWithFallbackBatch).toHaveBeenCalledWith("meli-profile-1", ["MLA2", "MLA3"], {
+      maxConcurrency: 10,
+      maxRetries: 1
+    });
+    expect(result).toEqual({
+      kind: "object",
+      payload: {
+        profile_id: "meli-profile-1",
+        metadata: {
+          total: 3,
+          limit: 3,
+          offset: 0,
+          returned: 2,
+          has_more: true,
+          next_offset: 2,
+          continuation: "Se recuper\xF3 cobertura parcial. Reintentar la misma tool con offset=0 y limit=3. Luego continuar con offset=2 si hace falta.",
+          applied_status: "paused",
+          available_status_filters: [
+            "active",
+            "paused",
+            "closed",
+            "under_review",
+            "inactive",
+            "not_yet_active",
+            "payment_required",
+            "deleted"
+          ],
+          detail_coverage: {
+            detail_failures: 1,
+            details_complete: false
+          },
+          pages_requested: 1,
+          pages_succeeded: 1,
+          pages_failed: 0,
+          universe_fully_fetched: true
+        },
+        items_schema: [
+          "item_id",
+          "title",
+          "status",
+          "price",
+          "currency_id",
+          "available_quantity",
+          "sold_quantity",
+          "listing_type_id",
+          "category_id"
+        ],
+        items: [
+          ["MLA1", "Boots", "", 0, "UNKNOWN", 0, 0, "", ""],
+          ["MLA2", "Sneakers", "", 0, "UNKNOWN", 0, 0, "", ""]
+        ]
+      }
+    });
+  });
+  it("builds store performance summaries with service wiring, ordering, and warnings", async () => {
+    vi.mocked(searchMercadoLibreOrders).mockResolvedValue({
+      results: [
+        {
+          currency_id: "ARS",
+          total_amount: 200.5,
+          order_items: [
+            {
+              quantity: 2,
+              unit_price: 50.25,
+              item: { id: "MLA1", title: "Boots" }
+            }
+          ]
+        },
+        {
+          currency_id: "USD",
+          total_amount: 75.255,
+          order_items: [
+            {
+              quantity: 1,
+              unit_price: 75.255,
+              item: { id: "MLA2", title: "Sneakers" }
+            }
+          ]
+        }
+      ]
+    });
+    vi.mocked(searchMercadoLibreItems).mockResolvedValue({
+      results: ["MLA1", "MLA2", "MLA3"]
+    });
+    vi.mocked(getMercadoLibreUserItemsVisits).mockResolvedValue({ results: [] });
+    const result = await meliGetStorePerformanceHandler({
+      profileId: "meli-profile-1",
+      startDate: "2026-03-01",
+      endDate: "2026-03-31",
+      ordersLimit: 2,
+      itemsLimit: 5
+    });
+    expect(searchMercadoLibreOrders).toHaveBeenCalledWith("meli-profile-1", {
+      seller: "seller-99",
+      from: "2026-03-01",
+      to: "2026-03-31",
+      limit: 2,
+      offset: 0
+    });
+    expect(searchMercadoLibreItems).toHaveBeenCalledWith("meli-profile-1", {
+      sellerId: "seller-99",
+      limit: 5,
+      offset: 0
+    });
+    expect(getMercadoLibreUserItemsVisits).toHaveBeenCalledWith(
+      "meli-profile-1",
+      "seller-99",
+      "2026-03-01",
+      "2026-03-31"
+    );
+    expect(result).toEqual({
+      kind: "object",
+      payload: {
+        profile_id: "meli-profile-1",
+        seller_id: "seller-99",
+        executive_summary: {
+          orders_sampled: 2,
+          active_items_sampled: 3,
+          total_visits: 0,
+          revenue_by_currency: {
+            ARS: { orders: 1, revenue: 200.5 },
+            USD: { orders: 1, revenue: 75.25 }
+          }
+        },
+        top_items: [
+          { item_id: "MLA1", title: "Boots", units: 2, revenue: 100.5 },
+          { item_id: "MLA2", title: "Sneakers", units: 1, revenue: 75.25 }
+        ],
+        warnings: [
+          "La muestra de \xF3rdenes puede ser parcial. Si necesit\xE1s totales completos, reenviar con mayor rango paginado.",
+          "MercadoLibre no devolvi\xF3 filas de visitas para el rango indicado."
+        ]
+      }
+    });
+  });
+  it("aggregates sales by item across paginated order batches", async () => {
+    vi.mocked(searchMercadoLibreOrders).mockResolvedValue({
+      paging: { total: 3, limit: 2, offset: 0 },
+      results: [
+        {
+          currency_id: "ARS",
+          date_created: "2026-03-10T14:45:55.000Z",
+          order_items: [
+            {
+              quantity: 2,
+              unit_price: 100,
+              item: { id: "MLA1", title: "Boots", variation_id: "V1" }
+            }
+          ]
+        },
+        {
+          currency_id: "USD",
+          date_created: "2026-03-11T08:10:00.000Z",
+          order_items: [
+            {
+              quantity: 1,
+              unit_price: 50,
+              item: { id: "MLA2", title: "Sneakers" }
+            }
+          ]
+        }
+      ]
+    });
+    vi.mocked(searchMercadoLibreOrdersBatch).mockResolvedValue({
+      successful: [
+        {
+          id: "2",
+          document: {
+            results: [
+              {
+                currency_id: "ARS",
+                date_created: "2026-03-12T09:15:00.000Z",
+                order_items: [
+                  {
+                    quantity: 1,
+                    unit_price: 120,
+                    item: { id: "MLA1", title: "Boots", variation_id: "V1" }
+                  }
+                ]
+              }
+            ]
+          }
+        }
+      ],
+      failed: []
+    });
+    const result = await meliGetSalesByItemHandler({
+      profileId: "meli-profile-1",
+      startDate: "2026-03-01",
+      endDate: "2026-03-31",
+      status: "paid",
+      limit: 2,
+      offset: 0
+    });
+    expect(searchMercadoLibreOrders).toHaveBeenCalledWith("meli-profile-1", {
+      seller: "",
+      from: "2026-03-01",
+      to: "2026-03-31",
+      status: "paid",
+      limit: 2,
+      offset: 0
+    });
+    expect(searchMercadoLibreOrdersBatch).toHaveBeenCalledWith(
+      "meli-profile-1",
+      {
+        seller: "",
+        from: "2026-03-01",
+        to: "2026-03-31",
+        status: "paid",
+        limit: 2
+      },
+      [2],
+      {
+        maxConcurrency: 15,
+        maxRetries: 2
+      }
+    );
+    expect(result).toEqual({
+      kind: "object",
+      payload: {
+        profile_id: "meli-profile-1",
+        metadata: {
+          total: 3,
+          limit: 2,
+          offset: 0,
+          returned: 3,
+          orders_aggregated: 3,
+          has_more: false,
+          continuation: "Agregado completo. No more pages for this query.",
+          fetch_mode: "full_aggregate",
+          pages_requested: 2,
+          pages_succeeded: 2,
+          pages_failed: 0,
+          universe_fully_fetched: true
+        },
+        sales_by_item_schema: [
+          "item_id",
+          "title",
+          "variation_id",
+          "orders",
+          "units",
+          "revenue",
+          "last_order_date"
+        ],
+        sales_by_currency: {
+          ARS: [["MLA1", "Boots", "V1", 2, 3, 320, "2026-03-12 09:15"]],
+          USD: [["MLA2", "Sneakers", "", 1, 1, 50, "2026-03-11 08:10"]]
+        }
+      }
+    });
+  });
+  it("reports partial weekly sales trends when follow-up pages fail", async () => {
+    vi.mocked(searchMercadoLibreOrders).mockResolvedValue({
+      paging: { total: 3, limit: 2, offset: 0 },
+      results: [
+        {
+          currency_id: "ARS",
+          total_amount: 100,
+          date_created: "2026-03-10T23:30:00.000Z"
+        },
+        {
+          currency_id: "ARS",
+          total_amount: 50,
+          date_created: "2026-03-13T03:00:00.000Z"
+        }
+      ]
+    });
+    vi.mocked(searchMercadoLibreOrdersBatch).mockResolvedValue({
+      successful: [],
+      failed: [{ id: "2", message: "timeout", attempts: 2, retryable: true, statusCode: 504 }]
+    });
+    const result = await meliGetSalesTrendHandler({
+      profileId: "meli-profile-1",
+      startDate: "2026-03-01",
+      endDate: "2026-03-31",
+      granularity: "week",
+      limit: 2,
+      offset: 0
+    });
+    expect(result).toEqual({
+      kind: "object",
+      payload: {
+        profile_id: "meli-profile-1",
+        granularity: "week",
+        trend_by_currency: {
+          ARS: [{ bucket: "2026-03-09", orders: 2, revenue: 150 }]
+        },
+        metadata: {
+          total_matching_orders: 3,
+          limit: 2,
+          offset: 0,
+          returned: 2,
+          orders_aggregated: 2,
+          continuation: "Agregado parcial por paginas fallidas. Reintentar la misma tool con los mismos filtros para recomputar el trend completo. Offsets fallidos: 2.",
+          fetch_mode: "full_aggregate",
+          pages_requested: 2,
+          pages_succeeded: 1,
+          pages_failed: 1,
+          universe_fully_fetched: false
+        },
+        failed_pages: [
+          {
+            offset: 2,
+            limit: 2,
+            page_number: 2,
+            message: "timeout",
+            status_code: 504,
+            attempts: 2,
+            retryable: true
+          }
+        ]
+      }
+    });
+  });
+  it("uses the single-order path when all requested order ids collapse to one unique id", async () => {
+    vi.mocked(getMercadoLibreOrder).mockResolvedValue({
+      id: 100,
+      status: "paid",
+      status_detail: "accredited",
+      date_created: "2026-03-10T14:45:55.000Z",
+      date_closed: "2026-03-10T15:00:00.000Z",
+      currency_id: "ARS",
+      total_amount: 200,
+      paid_amount: 200,
+      shipping: { id: 1, status: "ready_to_ship", logistic_type: "drop_off" },
+      buyer: { id: 10, nickname: "buyer-1" },
+      seller: { id: 20, nickname: "seller-1" },
+      order_items: [
+        {
+          quantity: 2,
+          unit_price: 100,
+          full_unit_price: 120,
+          item: { id: "MLA1", title: "Boots", variation_id: "V1" }
+        }
+      ],
+      payments: [
+        {
+          id: 999,
+          status: "approved",
+          payment_type: "credit_card",
+          installments: 3,
+          total_paid_amount: 200
+        }
+      ],
+      tags: ["packed"]
+    });
+    const result = await meliGetOrderDetailsHandler({
+      profileId: "meli-profile-1",
+      orderIds: ["100", "100"]
+    });
+    expect(getMercadoLibreOrder).toHaveBeenCalledWith("meli-profile-1", "100");
+    expect(getMercadoLibreOrderDetailsBatch).not.toHaveBeenCalled();
+    expect(result).toEqual({
+      kind: "object",
+      payload: {
+        metadata: {
+          profile_id: "meli-profile-1",
+          requested: 1,
+          successful: 1,
+          failed: 0
+        },
+        orders: [
+          {
+            buyer: { id: "", nickname: "buyer-1" },
+            currency_id: "ARS",
+            date_closed: "2026-03-10 15:00",
+            date_created: "2026-03-10 14:45",
+            items: [
+              {
+                item_id: "MLA1",
+                title: "Boots",
+                variation_id: "V1",
+                quantity: 2,
+                unit_price: 100,
+                full_unit_price: 120
+              }
+            ],
+            order_id: "",
+            total_amount: 200,
+            paid_amount: 200,
+            payments: [
+              {
+                id: "",
+                status: "approved",
+                payment_type: "credit_card",
+                installments: 3,
+                total_paid_amount: 200
+              }
+            ],
+            seller: { id: "", nickname: "seller-1" },
+            shipping: {
+              id: "",
+              status: "ready_to_ship",
+              substatus: "",
+              mode: "",
+              logistic_type: "drop_off"
+            },
+            status: "paid",
+            status_detail: "accredited",
+            tags: ["packed"]
+          }
+        ]
+      }
+    });
+  });
+  it("returns batch order details with normalized failures", async () => {
+    vi.mocked(getMercadoLibreOrderDetailsBatch).mockResolvedValue({
+      successful: [
+        {
+          id: "100",
+          document: {
+            id: "100",
+            status: "paid",
+            currency_id: "ARS",
+            total_amount: 100,
+            paid_amount: 100,
+            order_items: [],
+            payments: []
+          }
+        }
+      ],
+      failed: [{ id: "101", message: "not found", statusCode: 404, attempts: 2, retryable: false }]
+    });
+    const result = await meliGetOrderDetailsHandler({
+      profileId: "meli-profile-1",
+      orderIds: ["100", "101", "100"]
+    });
+    expect(getMercadoLibreOrderDetailsBatch).toHaveBeenCalledWith("meli-profile-1", ["100", "101"], {
+      maxConcurrency: 10,
+      maxRetries: 2
+    });
+    expect(result).toEqual({
+      kind: "object",
+      payload: {
+        metadata: {
+          profile_id: "meli-profile-1",
+          requested: 2,
+          successful: 1,
+          failed: 1,
+          has_failures: true
+        },
+        orders: [
+          {
+            buyer: { id: "", nickname: "" },
+            order_id: "100",
+            status: "paid",
+            status_detail: "",
+            currency_id: "ARS",
+            total_amount: 100,
+            paid_amount: 100,
+            shipping: {
+              id: "",
+              status: "",
+              substatus: "",
+              mode: "",
+              logistic_type: ""
+            },
+            seller: { id: "", nickname: "" }
+          }
+        ],
+        failures: [
+          {
+            order_id: "101",
+            message: "not found",
+            status_code: 404,
+            attempts: 2,
+            retryable: false
+          }
+        ]
+      }
+    });
+  });
+  it("formats medium-handler failures through MercadoLibre error helpers", async () => {
+    vi.mocked(searchMercadoLibreOrders).mockRejectedValue(new Error("orders-boom"));
+    const result = await meliGetSalesTrendHandler({
+      profileId: "meli-profile-1",
+      startDate: "2026-03-01",
+      endDate: "2026-03-31"
+    });
+    expect(formatMercadoLibreError).toHaveBeenCalledWith(
+      expect.any(Error),
+      "Failed to build MercadoLibre sales trend"
+    );
+    expect(result).toEqual({
+      kind: "error",
+      message: "formatted:Failed to build MercadoLibre sales trend:orders-boom"
+    });
+  });
+});
+//# sourceMappingURL=mercadolibre-tool-handlers-medium-batch4.test.js.map