@yoryoboy/bi-mcp 1.16.0 → 1.19.0

package/dist/src/services/mercadolibre/__tests__/mercadolibre-product-ads-ad-groups.test.js

@@ -0,0 +1,143 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { MercadoLibreApiError, getMercadoLibreApiContext } from "../mercadolibre-api.js";
+import { searchMercadoLibreProductAdsAdGroups } from "../mercadolibre-product-ads.js";
+vi.mock("../mercadolibre-api.js", async () => {
+  const actual = await vi.importActual("../mercadolibre-api.js");
+  return { ...actual, getMercadoLibreApiContext: vi.fn() };
+});
+describe("mercadolibre product ads ad groups service", () => {
+  const getMock = vi.fn();
+  beforeEach(() => {
+    vi.clearAllMocks();
+    vi.mocked(getMercadoLibreApiContext).mockResolvedValue({
+      api: { get: getMock },
+      sellerId: "seller-1",
+      accessToken: "token-1"
+    });
+  });
+  it("uses the validated ad-groups search path, query contract, and Product Ads API version", async () => {
+    getMock.mockResolvedValueOnce({
+      data: {
+        paging: { total: 11, limit: 25, offset: 10 },
+        results: [{ id: "ag-1", campaign_id: "campaign-1", metrics: { clicks: 3 } }],
+        metrics_summary: { clicks: 3 }
+      }
+    });
+    await expect(
+      searchMercadoLibreProductAdsAdGroups("profile-1", {
+        siteId: "MLA",
+        advertiserId: "89015",
+        dateFrom: "2026-06-01",
+        dateTo: "2026-06-30",
+        metrics: ["clicks", "cost"],
+        metricsSummary: true,
+        sort: "desc",
+        sortBy: "clicks",
+        filters: { campaigns: "campaign-1", statuses: "active" },
+        limit: 25,
+        offset: 10
+      })
+    ).resolves.toEqual({
+      paging: { total: 11, limit: 25, offset: 10 },
+      results: [{ id: "ag-1", campaign_id: "campaign-1", metrics: { clicks: 3 } }],
+      metricsSummary: { clicks: 3 }
+    });
+    expect(getMock).toHaveBeenCalledWith(
+      "/advertising/MLA/advertisers/89015/product_ads/ad_groups/search",
+      {
+        params: {
+          date_from: "2026-06-01",
+          date_to: "2026-06-30",
+          metrics: "clicks,cost",
+          metrics_summary: true,
+          sort: "desc",
+          sort_by: "clicks",
+          "filters[campaigns]": "campaign-1",
+          "filters[statuses]": "active",
+          limit: 25,
+          offset: 10
+        },
+        headers: { "Api-Version": "v2" }
+      }
+    );
+  });
+  it("preserves the validated empty state without fabricating rows", async () => {
+    getMock.mockResolvedValueOnce({
+      data: { paging: { total: 0, limit: 50, offset: 0 }, results: [] }
+    });
+    await expect(
+      searchMercadoLibreProductAdsAdGroups("profile-1", {
+        siteId: "MLA",
+        advertiserId: "89015",
+        dateFrom: "2026-06-01",
+        dateTo: "2026-06-30"
+      })
+    ).resolves.toEqual({
+      paging: { total: 0, limit: 50, offset: 0 },
+      results: [],
+      metricsSummary: void 0
+    });
+  });
+  it.each([
+    { paging: {}, reason: "missing" },
+    { paging: { total: null, limit: null, offset: null }, reason: "null" },
+    { paging: { total: 2, limit: "not-a-number", offset: 0 }, reason: "invalid" },
+    { paging: { total: 2, limit: 0, offset: 0 }, reason: "zero-limit" },
+    { paging: { total: 2, limit: -1, offset: 0 }, reason: "negative-limit" }
+  ])("rejects $reason paging metadata instead of fabricating continuation", async ({ paging }) => {
+    getMock.mockResolvedValueOnce({ data: { paging, results: [] } });
+    await expect(
+      searchMercadoLibreProductAdsAdGroups("profile-1", {
+        siteId: "MLA",
+        advertiserId: "89015",
+        dateFrom: "2026-06-01",
+        dateTo: "2026-06-30"
+      })
+    ).rejects.toThrow("paging metadata; continuation cannot be determined safely");
+  });
+  it.each([
+    { results: void 0, reason: "missing" },
+    { results: {}, reason: "non-array" }
+  ])("rejects $reason results when paging reports data", async ({ results }) => {
+    getMock.mockResolvedValueOnce({
+      data: { paging: { total: 2, limit: 50, offset: 0 }, ...results === void 0 ? {} : { results } }
+    });
+    await expect(
+      searchMercadoLibreProductAdsAdGroups("profile-1", {
+        siteId: "MLA",
+        advertiserId: "89015",
+        dateFrom: "2026-06-01",
+        dateTo: "2026-06-30"
+      })
+    ).rejects.toThrow("missing or invalid results; page integrity cannot be determined safely");
+  });
+  it("rejects an underfilled page instead of advertising an unsafe continuation", async () => {
+    getMock.mockResolvedValueOnce({
+      data: {
+        paging: { total: 120, limit: 50, offset: 0 },
+        results: [{ id: "ag-1" }]
+      }
+    });
+    await expect(
+      searchMercadoLibreProductAdsAdGroups("profile-1", {
+        siteId: "MLA",
+        advertiserId: "89015",
+        dateFrom: "2026-06-01",
+        dateTo: "2026-06-30"
+      })
+    ).rejects.toThrow("underfilled or oversized page; continuation cannot be determined safely");
+  });
+  it.each([401, 403, 404])("preserves undocumented upstream %s errors", async (status) => {
+    getMock.mockRejectedValueOnce(new MercadoLibreApiError(`upstream ${status}`, status));
+    await expect(
+      searchMercadoLibreProductAdsAdGroups("profile-1", {
+        siteId: "MLA",
+        advertiserId: "89015",
+        dateFrom: "2026-06-01",
+        dateTo: "2026-06-30"
+      })
+    ).rejects.toMatchObject({ status, message: `upstream ${status}` });
+    expect(getMock).toHaveBeenCalledTimes(1);
+  });
+});
+//# sourceMappingURL=mercadolibre-product-ads-ad-groups.test.js.map

package/dist/src/services/mercadolibre/__tests__/mercadolibre-product-ads-ad-groups.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/services/mercadolibre/__tests__/mercadolibre-product-ads-ad-groups.test.ts"],
+  "sourcesContent": ["import { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nimport { MercadoLibreApiError, getMercadoLibreApiContext } from \"../mercadolibre-api.js\";\nimport { searchMercadoLibreProductAdsAdGroups } from \"../mercadolibre-product-ads.js\";\n\nvi.mock(\"../mercadolibre-api.js\", async () => {\n  const actual = await vi.importActual<typeof import(\"../mercadolibre-api.js\")>(\"../mercadolibre-api.js\");\n\n  return { ...actual, getMercadoLibreApiContext: vi.fn() };\n});\n\ndescribe(\"mercadolibre product ads ad groups service\", () => {\n  const getMock = vi.fn();\n\n  beforeEach(() => {\n    vi.clearAllMocks();\n    vi.mocked(getMercadoLibreApiContext).mockResolvedValue({\n      api: { get: getMock },\n      sellerId: \"seller-1\",\n      accessToken: \"token-1\",\n    } as never);\n  });\n\n  it(\"uses the validated ad-groups search path, query contract, and Product Ads API version\", async () => {\n    getMock.mockResolvedValueOnce({\n      data: {\n        paging: { total: 11, limit: 25, offset: 10 },\n        results: [{ id: \"ag-1\", campaign_id: \"campaign-1\", metrics: { clicks: 3 } }],\n        metrics_summary: { clicks: 3 },\n      },\n    });\n\n    await expect(\n      searchMercadoLibreProductAdsAdGroups(\"profile-1\", {\n        siteId: \"MLA\",\n        advertiserId: \"89015\",\n        dateFrom: \"2026-06-01\",\n        dateTo: \"2026-06-30\",\n        metrics: [\"clicks\", \"cost\"],\n        metricsSummary: true,\n        sort: \"desc\",\n        sortBy: \"clicks\",\n        filters: { campaigns: \"campaign-1\", statuses: \"active\" },\n        limit: 25,\n        offset: 10,\n      })\n    ).resolves.toEqual({\n      paging: { total: 11, limit: 25, offset: 10 },\n      results: [{ id: \"ag-1\", campaign_id: \"campaign-1\", metrics: { clicks: 3 } }],\n      metricsSummary: { clicks: 3 },\n    });\n\n    expect(getMock).toHaveBeenCalledWith(\n      \"/advertising/MLA/advertisers/89015/product_ads/ad_groups/search\",\n      {\n        params: {\n          date_from: \"2026-06-01\",\n          date_to: \"2026-06-30\",\n          metrics: \"clicks,cost\",\n          metrics_summary: true,\n          sort: \"desc\",\n          sort_by: \"clicks\",\n          \"filters[campaigns]\": \"campaign-1\",\n          \"filters[statuses]\": \"active\",\n          limit: 25,\n          offset: 10,\n        },\n        headers: { \"Api-Version\": \"v2\" },\n      }\n    );\n  });\n\n  it(\"preserves the validated empty state without fabricating rows\", async () => {\n    getMock.mockResolvedValueOnce({\n      data: { paging: { total: 0, limit: 50, offset: 0 }, results: [] },\n    });\n\n    await expect(\n      searchMercadoLibreProductAdsAdGroups(\"profile-1\", {\n        siteId: \"MLA\",\n        advertiserId: \"89015\",\n        dateFrom: \"2026-06-01\",\n        dateTo: \"2026-06-30\",\n      })\n    ).resolves.toEqual({\n      paging: { total: 0, limit: 50, offset: 0 },\n      results: [],\n      metricsSummary: undefined,\n    });\n  });\n\n  it.each([\n    { paging: {}, reason: \"missing\" },\n    { paging: { total: null, limit: null, offset: null }, reason: \"null\" },\n    { paging: { total: 2, limit: \"not-a-number\", offset: 0 }, reason: \"invalid\" },\n    { paging: { total: 2, limit: 0, offset: 0 }, reason: \"zero-limit\" },\n    { paging: { total: 2, limit: -1, offset: 0 }, reason: \"negative-limit\" },\n  ])(\"rejects $reason paging metadata instead of fabricating continuation\", async ({ paging }) => {\n    getMock.mockResolvedValueOnce({ data: { paging, results: [] } });\n\n    await expect(\n      searchMercadoLibreProductAdsAdGroups(\"profile-1\", {\n        siteId: \"MLA\",\n        advertiserId: \"89015\",\n        dateFrom: \"2026-06-01\",\n        dateTo: \"2026-06-30\",\n      })\n    ).rejects.toThrow(\"paging metadata; continuation cannot be determined safely\");\n  });\n\n  it.each([\n    { results: undefined, reason: \"missing\" },\n    { results: {}, reason: \"non-array\" },\n  ])(\"rejects $reason results when paging reports data\", async ({ results }) => {\n    getMock.mockResolvedValueOnce({\n      data: { paging: { total: 2, limit: 50, offset: 0 }, ...(results === undefined ? {} : { results }) },\n    });\n\n    await expect(\n      searchMercadoLibreProductAdsAdGroups(\"profile-1\", {\n        siteId: \"MLA\",\n        advertiserId: \"89015\",\n        dateFrom: \"2026-06-01\",\n        dateTo: \"2026-06-30\",\n      })\n    ).rejects.toThrow(\"missing or invalid results; page integrity cannot be determined safely\");\n  });\n\n  it(\"rejects an underfilled page instead of advertising an unsafe continuation\", async () => {\n    getMock.mockResolvedValueOnce({\n      data: {\n        paging: { total: 120, limit: 50, offset: 0 },\n        results: [{ id: \"ag-1\" }],\n      },\n    });\n\n    await expect(\n      searchMercadoLibreProductAdsAdGroups(\"profile-1\", {\n        siteId: \"MLA\",\n        advertiserId: \"89015\",\n        dateFrom: \"2026-06-01\",\n        dateTo: \"2026-06-30\",\n      })\n    ).rejects.toThrow(\"underfilled or oversized page; continuation cannot be determined safely\");\n  });\n\n  it.each([401, 403, 404])(\"preserves undocumented upstream %s errors\", async (status) => {\n    getMock.mockRejectedValueOnce(new MercadoLibreApiError(`upstream ${status}`, status));\n\n    await expect(\n      searchMercadoLibreProductAdsAdGroups(\"profile-1\", {\n        siteId: \"MLA\",\n        advertiserId: \"89015\",\n        dateFrom: \"2026-06-01\",\n        dateTo: \"2026-06-30\",\n      })\n    ).rejects.toMatchObject({ status, message: `upstream ${status}` });\n\n    expect(getMock).toHaveBeenCalledTimes(1);\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,YAAY,UAAU,QAAQ,IAAI,UAAU;AAErD,SAAS,sBAAsB,iCAAiC;AAChE,SAAS,4CAA4C;AAErD,GAAG,KAAK,0BAA0B,YAAY;AAC5C,QAAM,SAAS,MAAM,GAAG,aAAsD,wBAAwB;AAEtG,SAAO,EAAE,GAAG,QAAQ,2BAA2B,GAAG,GAAG,EAAE;AACzD,CAAC;AAED,SAAS,8CAA8C,MAAM;AAC3D,QAAM,UAAU,GAAG,GAAG;AAEtB,aAAW,MAAM;AACf,OAAG,cAAc;AACjB,OAAG,OAAO,yBAAyB,EAAE,kBAAkB;AAAA,MACrD,KAAK,EAAE,KAAK,QAAQ;AAAA,MACpB,UAAU;AAAA,MACV,aAAa;AAAA,IACf,CAAU;AAAA,EACZ,CAAC;AAED,KAAG,yFAAyF,YAAY;AACtG,YAAQ,sBAAsB;AAAA,MAC5B,MAAM;AAAA,QACJ,QAAQ,EAAE,OAAO,IAAI,OAAO,IAAI,QAAQ,GAAG;AAAA,QAC3C,SAAS,CAAC,EAAE,IAAI,QAAQ,aAAa,cAAc,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC;AAAA,QAC3E,iBAAiB,EAAE,QAAQ,EAAE;AAAA,MAC/B;AAAA,IACF,CAAC;AAED,UAAM;AAAA,MACJ,qCAAqC,aAAa;AAAA,QAChD,QAAQ;AAAA,QACR,cAAc;AAAA,QACd,UAAU;AAAA,QACV,QAAQ;AAAA,QACR,SAAS,CAAC,UAAU,MAAM;AAAA,QAC1B,gBAAgB;AAAA,QAChB,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,SAAS,EAAE,WAAW,cAAc,UAAU,SAAS;AAAA,QACvD,OAAO;AAAA,QACP,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,EAAE,SAAS,QAAQ;AAAA,MACjB,QAAQ,EAAE,OAAO,IAAI,OAAO,IAAI,QAAQ,GAAG;AAAA,MAC3C,SAAS,CAAC,EAAE,IAAI,QAAQ,aAAa,cAAc,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC;AAAA,MAC3E,gBAAgB,EAAE,QAAQ,EAAE;AAAA,IAC9B,CAAC;AAED,WAAO,OAAO,EAAE;AAAA,MACd;AAAA,MACA;AAAA,QACE,QAAQ;AAAA,UACN,WAAW;AAAA,UACX,SAAS;AAAA,UACT,SAAS;AAAA,UACT,iBAAiB;AAAA,UACjB,MAAM;AAAA,UACN,SAAS;AAAA,UACT,sBAAsB;AAAA,UACtB,qBAAqB;AAAA,UACrB,OAAO;AAAA,UACP,QAAQ;AAAA,QACV;AAAA,QACA,SAAS,EAAE,eAAe,KAAK;AAAA,MACjC;AAAA,IACF;AAAA,EACF,CAAC;AAED,KAAG,gEAAgE,YAAY;AAC7E,YAAQ,sBAAsB;AAAA,MAC5B,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,IAAI,QAAQ,EAAE,GAAG,SAAS,CAAC,EAAE;AAAA,IAClE,CAAC;AAED,UAAM;AAAA,MACJ,qCAAqC,aAAa;AAAA,QAChD,QAAQ;AAAA,QACR,cAAc;AAAA,QACd,UAAU;AAAA,QACV,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,EAAE,SAAS,QAAQ;AAAA,MACjB,QAAQ,EAAE,OAAO,GAAG,OAAO,IAAI,QAAQ,EAAE;AAAA,MACzC,SAAS,CAAC;AAAA,MACV,gBAAgB;AAAA,IAClB,CAAC;AAAA,EACH,CAAC;AAED,KAAG,KAAK;AAAA,IACN,EAAE,QAAQ,CAAC,GAAG,QAAQ,UAAU;AAAA,IAChC,EAAE,QAAQ,EAAE,OAAO,MAAM,OAAO,MAAM,QAAQ,KAAK,GAAG,QAAQ,OAAO;AAAA,IACrE,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,gBAAgB,QAAQ,EAAE,GAAG,QAAQ,UAAU;AAAA,IAC5E,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,EAAE,GAAG,QAAQ,aAAa;AAAA,IAClE,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,IAAI,QAAQ,EAAE,GAAG,QAAQ,iBAAiB;AAAA,EACzE,CAAC,EAAE,uEAAuE,OAAO,EAAE,OAAO,MAAM;AAC9F,YAAQ,sBAAsB,EAAE,MAAM,EAAE,QAAQ,SAAS,CAAC,EAAE,EAAE,CAAC;AAE/D,UAAM;AAAA,MACJ,qCAAqC,aAAa;AAAA,QAChD,QAAQ;AAAA,QACR,cAAc;AAAA,QACd,UAAU;AAAA,QACV,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,EAAE,QAAQ,QAAQ,2DAA2D;AAAA,EAC/E,CAAC;AAED,KAAG,KAAK;AAAA,IACN,EAAE,SAAS,QAAW,QAAQ,UAAU;AAAA,IACxC,EAAE,SAAS,CAAC,GAAG,QAAQ,YAAY;AAAA,EACrC,CAAC,EAAE,oDAAoD,OAAO,EAAE,QAAQ,MAAM;AAC5E,YAAQ,sBAAsB;AAAA,MAC5B,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,IAAI,QAAQ,EAAE,GAAG,GAAI,YAAY,SAAY,CAAC,IAAI,EAAE,QAAQ,EAAG;AAAA,IACpG,CAAC;AAED,UAAM;AAAA,MACJ,qCAAqC,aAAa;AAAA,QAChD,QAAQ;AAAA,QACR,cAAc;AAAA,QACd,UAAU;AAAA,QACV,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,EAAE,QAAQ,QAAQ,wEAAwE;AAAA,EAC5F,CAAC;AAED,KAAG,6EAA6E,YAAY;AAC1F,YAAQ,sBAAsB;AAAA,MAC5B,MAAM;AAAA,QACJ,QAAQ,EAAE,OAAO,KAAK,OAAO,IAAI,QAAQ,EAAE;AAAA,QAC3C,SAAS,CAAC,EAAE,IAAI,OAAO,CAAC;AAAA,MAC1B;AAAA,IACF,CAAC;AAED,UAAM;AAAA,MACJ,qCAAqC,aAAa;AAAA,QAChD,QAAQ;AAAA,QACR,cAAc;AAAA,QACd,UAAU;AAAA,QACV,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,EAAE,QAAQ,QAAQ,yEAAyE;AAAA,EAC7F,CAAC;AAED,KAAG,KAAK,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,6CAA6C,OAAO,WAAW;AACtF,YAAQ,sBAAsB,IAAI,qBAAqB,YAAY,MAAM,IAAI,MAAM,CAAC;AAEpF,UAAM;AAAA,MACJ,qCAAqC,aAAa;AAAA,QAChD,QAAQ;AAAA,QACR,cAAc;AAAA,QACd,UAAU;AAAA,QACV,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,EAAE,QAAQ,cAAc,EAAE,QAAQ,SAAS,YAAY,MAAM,GAAG,CAAC;AAEjE,WAAO,OAAO,EAAE,sBAAsB,CAAC;AAAA,EACzC,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/src/services/mercadolibre/__tests__/mercadolibre-product-ads-campaigns.test.js

@@ -0,0 +1,100 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { MercadoLibreApiError, getMercadoLibreApiContext } from "../mercadolibre-api.js";
+import { searchMercadoLibreProductAdsCampaigns } from "../mercadolibre-product-ads.js";
+vi.mock("../mercadolibre-api.js", async () => {
+  const actual = await vi.importActual("../mercadolibre-api.js");
+  return { ...actual, getMercadoLibreApiContext: vi.fn() };
+});
+describe("mercadolibre product ads campaigns service", () => {
+  const getMock = vi.fn();
+  const params = { siteId: "MLA", advertiserId: "89015", dateFrom: "2026-06-01", dateTo: "2026-06-30" };
+  beforeEach(() => {
+    vi.clearAllMocks();
+    vi.mocked(getMercadoLibreApiContext).mockResolvedValue({ api: { get: getMock } });
+  });
+  it("uses the validated campaigns search path, page query, and api-version 2 header", async () => {
+    const results = [{ id: "campaign-1", name: "Campaign", budget: { amount: 1e3 } }];
+    getMock.mockResolvedValueOnce({ data: { paging: { total: 5, limit: 1, offset: 1 }, results } });
+    await expect(searchMercadoLibreProductAdsCampaigns("triplim", { ...params, limit: 1, offset: 1 })).resolves.toEqual({
+      paging: { total: 5, limit: 1, offset: 1 },
+      results
+    });
+    expect(getMock).toHaveBeenCalledWith(
+      "/advertising/MLA/advertisers/89015/product_ads/campaigns/search",
+      {
+        params: { date_from: "2026-06-01", date_to: "2026-06-30", limit: 1, offset: 1 },
+        headers: { "api-version": "2" },
+        timeout: 1e4
+      }
+    );
+  });
+  it.each([{ paging: {} }, { paging: { total: 5, limit: "bad", offset: 0 } }])(
+    "rejects malformed paging instead of fabricating continuation",
+    async ({ paging }) => {
+      getMock.mockResolvedValueOnce({ data: { paging, results: [] } });
+      await expect(searchMercadoLibreProductAdsCampaigns("triplim", params)).rejects.toThrow(
+        "campaigns response has missing or invalid paging metadata"
+      );
+    }
+  );
+  it.each([401, 403, 404])("preserves upstream %s errors", async (status) => {
+    getMock.mockRejectedValueOnce(new MercadoLibreApiError(`upstream ${status}`, status));
+    await expect(searchMercadoLibreProductAdsCampaigns("triplim", params)).rejects.toMatchObject({ status, message: `upstream ${status}` });
+  });
+  it("rejects a zero limit before it can create a false terminal page", async () => {
+    await expect(searchMercadoLibreProductAdsCampaigns("triplim", { ...params, limit: 0 })).rejects.toThrow(
+      "limit must be an integer between 1 and 100"
+    );
+    expect(getMock).not.toHaveBeenCalled();
+  });
+  it.each([{}, { results: void 0 }, { results: {} }, { results: "not-an-array" }])(
+    "rejects missing or malformed results instead of treating it as an empty page",
+    async (payload) => {
+      getMock.mockResolvedValueOnce({ data: { paging: { total: 0, limit: 1, offset: 0 }, ...payload } });
+      await expect(searchMercadoLibreProductAdsCampaigns("triplim", params)).rejects.toThrow(
+        "campaigns response has missing or invalid results"
+      );
+    }
+  );
+  it("rejects underfilled pages so continuation can never skip undiscovered campaigns", async () => {
+    const onObservation = vi.fn();
+    getMock.mockResolvedValueOnce({
+      data: { paging: { total: 5, limit: 2, offset: 0 }, results: [{ id: "campaign-1" }] }
+    });
+    await expect(searchMercadoLibreProductAdsCampaigns("triplim", params, { onObservation })).rejects.toThrow(
+      "underfilled or oversized page"
+    );
+    expect(onObservation).toHaveBeenCalledWith(expect.objectContaining({ event: "payload_integrity_failure" }));
+  });
+  it("stops retrying when the campaign discovery latency budget cannot cover the next backoff", async () => {
+    const onObservation = vi.fn();
+    getMock.mockRejectedValueOnce(new MercadoLibreApiError("temporarily unavailable", 503));
+    await expect(
+      searchMercadoLibreProductAdsCampaigns("triplim", params, {
+        totalBudgetMs: 1,
+        baseRetryDelayMs: 50,
+        onObservation
+      })
+    ).rejects.toMatchObject({ code: "campaign_discovery_budget_exhausted" });
+    expect(getMock).toHaveBeenCalledTimes(1);
+    expect(onObservation).toHaveBeenCalledWith(expect.objectContaining({ event: "failure", reason: "latency_budget_exhausted" }));
+  });
+  it("emits retry and retry-exhaustion observations with a bounded per-attempt timeout", async () => {
+    const onObservation = vi.fn();
+    getMock.mockRejectedValue(new MercadoLibreApiError("temporarily unavailable", 503));
+    await expect(
+      searchMercadoLibreProductAdsCampaigns("triplim", params, {
+        maxRetries: 1,
+        baseRetryDelayMs: 50,
+        totalBudgetMs: 1e3,
+        requestTimeoutMs: 123,
+        onObservation
+      })
+    ).rejects.toThrow("temporarily unavailable");
+    expect(getMock).toHaveBeenCalledTimes(2);
+    expect(getMock.mock.calls[0]?.[1]).toEqual(expect.objectContaining({ timeout: 123 }));
+    expect(onObservation).toHaveBeenCalledWith(expect.objectContaining({ event: "retry", attempt: 1, status: 503 }));
+    expect(onObservation).toHaveBeenCalledWith(expect.objectContaining({ event: "failure", attempt: 2, reason: "retry_exhausted" }));
+  });
+});
+//# sourceMappingURL=mercadolibre-product-ads-campaigns.test.js.map

package/dist/src/services/mercadolibre/__tests__/mercadolibre-product-ads-campaigns.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/services/mercadolibre/__tests__/mercadolibre-product-ads-campaigns.test.ts"],
+  "sourcesContent": ["import { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nimport { MercadoLibreApiError, getMercadoLibreApiContext } from \"../mercadolibre-api.js\";\nimport { searchMercadoLibreProductAdsCampaigns } from \"../mercadolibre-product-ads.js\";\n\nvi.mock(\"../mercadolibre-api.js\", async () => {\n  const actual = await vi.importActual<typeof import(\"../mercadolibre-api.js\")>(\"../mercadolibre-api.js\");\n  return { ...actual, getMercadoLibreApiContext: vi.fn() };\n});\n\ndescribe(\"mercadolibre product ads campaigns service\", () => {\n  const getMock = vi.fn();\n  const params = { siteId: \"MLA\", advertiserId: \"89015\", dateFrom: \"2026-06-01\", dateTo: \"2026-06-30\" };\n\n  beforeEach(() => {\n    vi.clearAllMocks();\n    vi.mocked(getMercadoLibreApiContext).mockResolvedValue({ api: { get: getMock } } as never);\n  });\n\n  it(\"uses the validated campaigns search path, page query, and api-version 2 header\", async () => {\n    const results = [{ id: \"campaign-1\", name: \"Campaign\", budget: { amount: 1000 } }];\n    getMock.mockResolvedValueOnce({ data: { paging: { total: 5, limit: 1, offset: 1 }, results } });\n\n    await expect(searchMercadoLibreProductAdsCampaigns(\"triplim\", { ...params, limit: 1, offset: 1 })).resolves.toEqual({\n      paging: { total: 5, limit: 1, offset: 1 }, results,\n    });\n    expect(getMock).toHaveBeenCalledWith(\n      \"/advertising/MLA/advertisers/89015/product_ads/campaigns/search\",\n      {\n        params: { date_from: \"2026-06-01\", date_to: \"2026-06-30\", limit: 1, offset: 1 },\n        headers: { \"api-version\": \"2\" },\n        timeout: 10_000,\n      }\n    );\n  });\n\n  it.each([{ paging: {} }, { paging: { total: 5, limit: \"bad\", offset: 0 } }])(\n    \"rejects malformed paging instead of fabricating continuation\",\n    async ({ paging }) => {\n      getMock.mockResolvedValueOnce({ data: { paging, results: [] } });\n      await expect(searchMercadoLibreProductAdsCampaigns(\"triplim\", params)).rejects.toThrow(\n        \"campaigns response has missing or invalid paging metadata\"\n      );\n    }\n  );\n\n  it.each([401, 403, 404])(\"preserves upstream %s errors\", async (status) => {\n    getMock.mockRejectedValueOnce(new MercadoLibreApiError(`upstream ${status}`, status));\n    await expect(searchMercadoLibreProductAdsCampaigns(\"triplim\", params)).rejects.toMatchObject({ status, message: `upstream ${status}` });\n  });\n\n  it(\"rejects a zero limit before it can create a false terminal page\", async () => {\n    await expect(searchMercadoLibreProductAdsCampaigns(\"triplim\", { ...params, limit: 0 })).rejects.toThrow(\n      \"limit must be an integer between 1 and 100\"\n    );\n    expect(getMock).not.toHaveBeenCalled();\n  });\n\n  it.each([{}, { results: undefined }, { results: {} }, { results: \"not-an-array\" }])(\n    \"rejects missing or malformed results instead of treating it as an empty page\",\n    async (payload) => {\n      getMock.mockResolvedValueOnce({ data: { paging: { total: 0, limit: 1, offset: 0 }, ...payload } });\n      await expect(searchMercadoLibreProductAdsCampaigns(\"triplim\", params)).rejects.toThrow(\n        \"campaigns response has missing or invalid results\"\n      );\n    }\n  );\n\n  it(\"rejects underfilled pages so continuation can never skip undiscovered campaigns\", async () => {\n    const onObservation = vi.fn();\n    getMock.mockResolvedValueOnce({\n      data: { paging: { total: 5, limit: 2, offset: 0 }, results: [{ id: \"campaign-1\" }] },\n    });\n    await expect(searchMercadoLibreProductAdsCampaigns(\"triplim\", params, { onObservation })).rejects.toThrow(\n      \"underfilled or oversized page\"\n    );\n    expect(onObservation).toHaveBeenCalledWith(expect.objectContaining({ event: \"payload_integrity_failure\" }));\n  });\n\n  it(\"stops retrying when the campaign discovery latency budget cannot cover the next backoff\", async () => {\n    const onObservation = vi.fn();\n    getMock.mockRejectedValueOnce(new MercadoLibreApiError(\"temporarily unavailable\", 503));\n\n    await expect(\n      searchMercadoLibreProductAdsCampaigns(\"triplim\", params, {\n        totalBudgetMs: 1,\n        baseRetryDelayMs: 50,\n        onObservation,\n      })\n    ).rejects.toMatchObject({ code: \"campaign_discovery_budget_exhausted\" });\n\n    expect(getMock).toHaveBeenCalledTimes(1);\n    expect(onObservation).toHaveBeenCalledWith(expect.objectContaining({ event: \"failure\", reason: \"latency_budget_exhausted\" }));\n  });\n\n  it(\"emits retry and retry-exhaustion observations with a bounded per-attempt timeout\", async () => {\n    const onObservation = vi.fn();\n    getMock.mockRejectedValue(new MercadoLibreApiError(\"temporarily unavailable\", 503));\n\n    await expect(\n      searchMercadoLibreProductAdsCampaigns(\"triplim\", params, {\n        maxRetries: 1,\n        baseRetryDelayMs: 50,\n        totalBudgetMs: 1_000,\n        requestTimeoutMs: 123,\n        onObservation,\n      })\n    ).rejects.toThrow(\"temporarily unavailable\");\n\n    expect(getMock).toHaveBeenCalledTimes(2);\n    expect(getMock.mock.calls[0]?.[1]).toEqual(expect.objectContaining({ timeout: 123 }));\n    expect(onObservation).toHaveBeenCalledWith(expect.objectContaining({ event: \"retry\", attempt: 1, status: 503 }));\n    expect(onObservation).toHaveBeenCalledWith(expect.objectContaining({ event: \"failure\", attempt: 2, reason: \"retry_exhausted\" }));\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/services/mercadolibre/__tests__/mercadolibre-product-ads.test.js

@@ -0,0 +1,350 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { MercadoLibreApiError } from "../mercadolibre-api.js";
+import {
+  listMercadoLibreProductAdsAdvertisers,
+  searchMercadoLibreProductAdsAds,
+  searchMercadoLibreProductAdsAdsBatch
+} from "../mercadolibre-product-ads.js";
+import { getMercadoLibreApiContext, runMercadoLibreBatch } from "../mercadolibre-api.js";
+vi.mock("../mercadolibre-api.js", async () => {
+  const actual = await vi.importActual("../mercadolibre-api.js");
+  return {
+    ...actual,
+    getMercadoLibreApiContext: vi.fn(),
+    runMercadoLibreBatch: vi.fn()
+  };
+});
+describe("mercadolibre-product-ads service", () => {
+  const getMock = vi.fn();
+  const searchRequest = {
+    dateFrom: "2026-06-01",
+    dateTo: "2026-06-30",
+    metrics: ["direct_amount", "indirect_amount", "total_amount", "clicks", "impressions", "cost"],
+    metricsSummary: true,
+    campaignId: "campaign-1",
+    adGroupId: "ad-group-1",
+    itemId: "item-1",
+    channel: "mshops",
+    status: "active",
+    brandValueName: "Brand 1"
+  };
+  beforeEach(() => {
+    vi.clearAllMocks();
+    vi.useRealTimers();
+    vi.mocked(getMercadoLibreApiContext).mockResolvedValue({
+      api: { get: getMock },
+      sellerId: "seller-1",
+      accessToken: "token-1"
+    });
+  });
+  it("retries transient Product Ads advertiser discovery failures before succeeding", async () => {
+    const setTimeoutSpy = vi.spyOn(globalThis, "setTimeout").mockImplementation(((handler) => {
+      if (typeof handler === "function") {
+        handler();
+      }
+      return 0;
+    }));
+    getMock.mockRejectedValueOnce(new MercadoLibreApiError("rate limited", 429)).mockRejectedValueOnce(new MercadoLibreApiError("rate limited", 429)).mockResolvedValueOnce({
+      data: {
+        advertisers: [
+          {
+            advertiser_id: "adv-1",
+            advertiser_site_id: "MLA"
+          }
+        ]
+      }
+    });
+    const promise = listMercadoLibreProductAdsAdvertisers("profile-1");
+    await expect(promise).resolves.toEqual([
+      {
+        advertiser_id: "adv-1",
+        advertiser_site_id: "MLA",
+        account_name: "",
+        business_name: "",
+        status: void 0
+      }
+    ]);
+    expect(getMock).toHaveBeenCalledTimes(3);
+    setTimeoutSpy.mockRestore();
+  });
+  it("lists Product Ads advertisers with the expected discovery endpoint", async () => {
+    getMock.mockResolvedValueOnce({
+      data: {
+        advertisers: [
+          {
+            advertiser_id: "adv-1",
+            advertiser_site_id: "MLA",
+            account_name: "Main account",
+            business_name: "Main business",
+            status: "active"
+          }
+        ]
+      }
+    });
+    await expect(listMercadoLibreProductAdsAdvertisers("profile-1")).resolves.toEqual([
+      {
+        advertiser_id: "adv-1",
+        advertiser_site_id: "MLA",
+        account_name: "Main account",
+        business_name: "Main business",
+        status: "active"
+      }
+    ]);
+    expect(getMock).toHaveBeenCalledWith("/advertising/advertisers", {
+      params: { product_id: "PADS" },
+      headers: { "Api-Version": "v1" }
+    });
+  });
+  it("searches Product Ads ads with the expected site and advertiser path", async () => {
+    getMock.mockResolvedValueOnce({
+      data: {
+        paging: { total: 1, limit: 50, offset: 0 },
+        results: [
+          {
+            item_id: "item-1",
+            title: "Item one",
+            status: "active",
+            campaign_id: "campaign-1",
+            campaign_name: "Campaign one",
+            ad_group_id: "ad-group-1",
+            ad_group_name: "Ad group one",
+            channel: "mshops",
+            brand_value_name: "Brand one",
+            metrics: {
+              direct_amount: 12.5,
+              indirect_amount: 2.5,
+              total_amount: 15,
+              clicks: 7,
+              impressions: 120,
+              cost: 9.75,
+              advertising_items_quantity: 1,
+              currency_id: "ARS"
+            }
+          }
+        ]
+      }
+    });
+    await expect(
+      searchMercadoLibreProductAdsAds("profile-1", {
+        siteId: "MLA",
+        advertiserId: "89015",
+        dateFrom: searchRequest.dateFrom,
+        dateTo: searchRequest.dateTo,
+        metrics: searchRequest.metrics,
+        metricsSummary: searchRequest.metricsSummary,
+        campaignId: searchRequest.campaignId,
+        adGroupId: searchRequest.adGroupId,
+        itemId: searchRequest.itemId,
+        channel: searchRequest.channel,
+        status: searchRequest.status,
+        brandValueName: searchRequest.brandValueName,
+        limit: 25,
+        offset: 10
+      })
+    ).resolves.toEqual({
+      paging: { total: 1, limit: 50, offset: 0 },
+      results: [
+        {
+          item_id: "item-1",
+          title: "Item one",
+          status: "active",
+          campaign_id: "campaign-1",
+          campaign_name: "Campaign one",
+          ad_group_id: "ad-group-1",
+          ad_group_name: "Ad group one",
+          channel: "mshops",
+          brand_value_name: "Brand one",
+          metrics: {
+            direct_amount: 12.5,
+            indirect_amount: 2.5,
+            total_amount: 15,
+            clicks: 7,
+            impressions: 120,
+            cost: 9.75,
+            advertising_items_quantity: 1,
+            currency_id: "ARS"
+          }
+        }
+      ]
+    });
+    expect(getMock).toHaveBeenCalledWith(
+      "/advertising/MLA/advertisers/89015/product_ads/ads/search",
+      {
+        params: {
+          date_from: searchRequest.dateFrom,
+          date_to: searchRequest.dateTo,
+          metrics: searchRequest.metrics.join(","),
+          metrics_summary: searchRequest.metricsSummary,
+          campaign_id: searchRequest.campaignId,
+          ad_group_id: searchRequest.adGroupId,
+          item_id: searchRequest.itemId,
+          channel: searchRequest.channel,
+          status: searchRequest.status,
+          brand_value_name: searchRequest.brandValueName,
+          limit: 25,
+          offset: 10
+        },
+        headers: { "Api-Version": "v2" }
+      }
+    );
+  });
+  it("returns no fabricated ads rows when the search envelope has only paging metadata", async () => {
+    getMock.mockResolvedValueOnce({
+      data: {
+        paging: { total: 0, limit: 50, offset: 0 }
+      }
+    });
+    await expect(
+      searchMercadoLibreProductAdsAds("profile-1", {
+        siteId: "MLA",
+        advertiserId: "89015",
+        dateFrom: searchRequest.dateFrom,
+        dateTo: searchRequest.dateTo,
+        metrics: searchRequest.metrics,
+        limit: 25,
+        offset: 10
+      })
+    ).resolves.toEqual({
+      paging: { total: 0, limit: 50, offset: 0 },
+      results: []
+    });
+  });
+  it("exhausts retry attempts with a clear failure when Product Ads search keeps returning transient errors", async () => {
+    const setTimeoutSpy = vi.spyOn(globalThis, "setTimeout").mockImplementation(((handler) => {
+      if (typeof handler === "function") {
+        handler();
+      }
+      return 0;
+    }));
+    getMock.mockRejectedValue(new MercadoLibreApiError("temporarily unavailable", 503));
+    const promise = searchMercadoLibreProductAdsAds("profile-1", {
+      siteId: "MLA",
+      advertiserId: "89015",
+      dateFrom: searchRequest.dateFrom,
+      dateTo: searchRequest.dateTo,
+      metrics: searchRequest.metrics,
+      limit: 25,
+      offset: 10
+    });
+    await expect(promise).rejects.toMatchObject({
+      name: "MercadoLibreApiError",
+      status: 503,
+      message: "temporarily unavailable"
+    });
+    expect(getMock).toHaveBeenCalledTimes(3);
+    setTimeoutSpy.mockRestore();
+  });
+  it("delegates Product Ads page batches to the shared batch runner", async () => {
+    vi.mocked(runMercadoLibreBatch).mockImplementation(async (ids, fetcher) => ({
+      successful: [{ id: ids[0], document: await fetcher(ids[0]) }],
+      failed: []
+    }));
+    getMock.mockResolvedValueOnce({
+      data: {
+        paging: { total: 2, limit: 50, offset: 50 },
+        results: [
+          {
+            item_id: "item-2",
+            title: "Item two",
+            status: "paused",
+            campaign_id: "campaign-2",
+            campaign_name: "Campaign two",
+            ad_group_id: "ad-group-2",
+            ad_group_name: "Ad group two",
+            channel: "marketplace",
+            brand_value_name: "Brand two",
+            metrics: {
+              direct_amount: 25,
+              indirect_amount: 5,
+              total_amount: 30,
+              clicks: 14,
+              impressions: 240,
+              cost: 19.5,
+              advertising_items_quantity: 1,
+              currency_id: "ARS"
+            }
+          }
+        ]
+      }
+    });
+    await expect(
+      searchMercadoLibreProductAdsAdsBatch(
+        "profile-1",
+        {
+          siteId: "MLA",
+          advertiserId: "89015",
+          dateFrom: searchRequest.dateFrom,
+          dateTo: searchRequest.dateTo,
+          metrics: searchRequest.metrics,
+          metricsSummary: searchRequest.metricsSummary,
+          campaignId: searchRequest.campaignId,
+          adGroupId: searchRequest.adGroupId,
+          itemId: searchRequest.itemId,
+          channel: searchRequest.channel,
+          status: searchRequest.status,
+          brandValueName: searchRequest.brandValueName,
+          limit: 50
+        },
+        [50],
+        { maxConcurrency: 3 }
+      )
+    ).resolves.toEqual({
+      successful: [
+        {
+          id: "50",
+          document: {
+            paging: { total: 2, limit: 50, offset: 50 },
+            results: [
+              {
+                item_id: "item-2",
+                title: "Item two",
+                status: "paused",
+                campaign_id: "campaign-2",
+                campaign_name: "Campaign two",
+                ad_group_id: "ad-group-2",
+                ad_group_name: "Ad group two",
+                channel: "marketplace",
+                brand_value_name: "Brand two",
+                metrics: {
+                  direct_amount: 25,
+                  indirect_amount: 5,
+                  total_amount: 30,
+                  clicks: 14,
+                  impressions: 240,
+                  cost: 19.5,
+                  advertising_items_quantity: 1,
+                  currency_id: "ARS"
+                }
+              }
+            ]
+          }
+        }
+      ],
+      failed: []
+    });
+    expect(runMercadoLibreBatch).toHaveBeenCalledWith(["50"], expect.any(Function), {
+      maxConcurrency: 3
+    });
+    expect(getMock).toHaveBeenCalledWith(
+      "/advertising/MLA/advertisers/89015/product_ads/ads/search",
+      {
+        params: {
+          date_from: searchRequest.dateFrom,
+          date_to: searchRequest.dateTo,
+          metrics: searchRequest.metrics.join(","),
+          metrics_summary: searchRequest.metricsSummary,
+          campaign_id: searchRequest.campaignId,
+          ad_group_id: searchRequest.adGroupId,
+          item_id: searchRequest.itemId,
+          channel: searchRequest.channel,
+          status: searchRequest.status,
+          brand_value_name: searchRequest.brandValueName,
+          limit: 50,
+          offset: 50
+        },
+        headers: { "Api-Version": "v2" }
+      }
+    );
+  });
+});
+//# sourceMappingURL=mercadolibre-product-ads.test.js.map