@yoryoboy/bi-mcp 1.16.0 → 1.19.0

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

@@ -0,0 +1,435 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { z } from "zod";
+import { MercadoLibreApiError } from "../../../services/mercadolibre/mercadolibre-api.js";
+const objectMock = vi.fn((value) => ({ kind: "object", value }));
+const errorMock = vi.fn((value) => ({ kind: "error", value }));
+const resolveMercadoLibreProfileOrSelectionMock = vi.fn();
+const resolveMercadoLibreProductAdsContextMock = vi.fn();
+const listMercadoLibreProductAdsAdvertisersMock = vi.fn();
+const searchMercadoLibreProductAdsAdsMock = vi.fn();
+vi.mock("mcp-use/server", () => ({
+  object: objectMock,
+  error: errorMock
+}));
+vi.mock("../profile-resolution.js", () => ({
+  resolveMercadoLibreProfileOrSelection: resolveMercadoLibreProfileOrSelectionMock
+}));
+vi.mock("../product-ads-helpers.js", () => ({
+  resolveMercadoLibreProductAdsContext: resolveMercadoLibreProductAdsContextMock,
+  mercadolibreProductAdsProfileIdSchemaField: z.string().optional(),
+  mercadolibreProductAdsSiteIdSchemaField: z.string().optional(),
+  mercadolibreProductAdsAdvertiserIdSchemaField: z.string().optional()
+}));
+vi.mock("../../../services/mercadolibre/mercadolibre-product-ads.js", () => ({
+  listMercadoLibreProductAdsAdvertisers: listMercadoLibreProductAdsAdvertisersMock,
+  searchMercadoLibreProductAdsAds: searchMercadoLibreProductAdsAdsMock
+}));
+const toolsModule = await import("../get-product-ads-advertisers.js");
+const adsModule = await import("../search-product-ads-ads.js");
+describe("mercadolibre product ads tools", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+  const searchParams = {
+    dateFrom: "2026-06-01",
+    dateTo: "2026-06-30",
+    metrics: ["direct_amount", "indirect_amount", "total_amount", "clicks", "impressions", "cost"]
+  };
+  function buildAdsRows(start, count) {
+    return Array.from({ length: count }, (_, index) => {
+      const adNumber = start + index;
+      return {
+        item_id: `item-${adNumber}`,
+        title: `Item ${adNumber}`,
+        status: adNumber % 2 === 0 ? "paused" : "active",
+        campaign_id: `campaign-${adNumber}`,
+        campaign_name: `Campaign ${adNumber}`,
+        ad_group_id: `ad-group-${adNumber}`,
+        ad_group_name: `Ad group ${adNumber}`,
+        channel: adNumber % 2 === 0 ? "marketplace" : "mshops",
+        brand_value_name: `Brand ${adNumber}`,
+        metrics: {
+          direct_amount: adNumber * 10,
+          indirect_amount: adNumber,
+          total_amount: adNumber * 11,
+          clicks: adNumber * 2,
+          impressions: adNumber * 20,
+          cost: adNumber * 3,
+          advertising_items_quantity: 1,
+          currency_id: "ARS"
+        }
+      };
+    });
+  }
+  it("returns a guided selection response when profile selection is required", async () => {
+    resolveMercadoLibreProfileOrSelectionMock.mockResolvedValueOnce({
+      ok: false,
+      response: { kind: "object", value: { selection_required: true } }
+    });
+    await expect(
+      toolsModule.meliListProductAdsAdvertisersHandler({ profileId: void 0 })
+    ).resolves.toEqual({ kind: "object", value: { selection_required: true } });
+  });
+  it("returns compact advertiser discovery rows", async () => {
+    resolveMercadoLibreProfileOrSelectionMock.mockResolvedValueOnce({
+      ok: true,
+      value: { profileId: "profile-1" }
+    });
+    listMercadoLibreProductAdsAdvertisersMock.mockResolvedValueOnce([
+      {
+        advertiser_id: "adv-1",
+        advertiser_site_id: "MLA",
+        account_name: "Main account",
+        business_name: "Main business",
+        status: "active"
+      }
+    ]);
+    await expect(
+      toolsModule.meliListProductAdsAdvertisersHandler({ profileId: "profile-1" })
+    ).resolves.toEqual({
+      kind: "object",
+      value: expect.objectContaining({
+        profile_id: "profile-1",
+        product: "PADS",
+        advertisers_schema: [
+          "advertiser_id",
+          "advertiser_site_id",
+          "account_name",
+          "business_name",
+          "status"
+        ],
+        advertisers: [["adv-1", "MLA", "Main account", "Main business", "active"]],
+        metadata: expect.objectContaining({
+          continuation: "Use one of the returned advertiser_site_id and advertiser_id pairs by passing them as siteId and advertiserId to the Product Ads search tool. That tool returns page metadata with next_offset when more rows remain."
+        })
+      })
+    });
+  });
+  it("rejects full_universe mode in the page-only ads search contract", () => {
+    expect(
+      adsModule.meliSearchProductAdsAdsSchema.safeParse({
+        profileId: "profile-1",
+        siteId: "MLA",
+        advertiserId: "adv-1",
+        dateFrom: searchParams.dateFrom,
+        dateTo: searchParams.dateTo,
+        metrics: searchParams.metrics,
+        mode: "full_universe"
+      }).success
+    ).toBe(false);
+    expect(
+      adsModule.meliSearchProductAdsAdsSchema.safeParse({
+        profileId: "profile-1",
+        siteId: "MLA",
+        advertiserId: "adv-1",
+        dateFrom: searchParams.dateFrom,
+        dateTo: searchParams.dateTo,
+        metrics: searchParams.metrics
+      }).success
+    ).toBe(true);
+  });
+  it("returns the context selection response when ads search cannot resolve advertiser scope", async () => {
+    resolveMercadoLibreProfileOrSelectionMock.mockResolvedValueOnce({
+      ok: true,
+      value: {
+        profileId: "profile-1"
+      }
+    });
+    resolveMercadoLibreProductAdsContextMock.mockResolvedValueOnce({
+      ok: false,
+      response: { kind: "object", value: { selection_required: true } }
+    });
+    await expect(
+      adsModule.meliSearchProductAdsAdsHandler({ profileId: "profile-1" })
+    ).resolves.toEqual({ kind: "object", value: { selection_required: true } });
+  });
+  it("uses explicit advertiser identifiers directly when both are provided", async () => {
+    resolveMercadoLibreProfileOrSelectionMock.mockResolvedValueOnce({
+      ok: true,
+      value: {
+        profileId: "profile-1"
+      }
+    });
+    searchMercadoLibreProductAdsAdsMock.mockResolvedValueOnce({
+      paging: { total: 150, limit: 50, offset: 0 },
+      results: buildAdsRows(1, 50)
+    });
+    const result = await adsModule.meliSearchProductAdsAdsHandler({
+      profileId: "profile-1",
+      siteId: "MLA",
+      advertiserId: "adv-1",
+      dateFrom: searchParams.dateFrom,
+      dateTo: searchParams.dateTo,
+      metrics: searchParams.metrics,
+      limit: 25,
+      offset: 0
+    });
+    expect(result).toEqual({
+      kind: "object",
+      value: expect.objectContaining({
+        profile_id: "profile-1",
+        site_id: "MLA",
+        advertiser_id: "adv-1",
+        product: "PADS",
+        mode: "page",
+        paging: { total: 150, limit: 50, offset: 0 },
+        results: buildAdsRows(1, 50),
+        metadata: expect.objectContaining({
+          entity: "ads",
+          fetch_mode: "page",
+          total: 150,
+          requested_limit: 25,
+          requested_offset: 0,
+          effective_limit: 50,
+          effective_offset: 0,
+          returned: 50,
+          has_more: true,
+          next_offset: 50,
+          continuation: "Re-run meli_search_product_ads_ads with mode=page and offset=50, limit=50 to continue."
+        }),
+        context_resolution: {
+          mode: "explicit",
+          advertiser_id: "adv-1",
+          advertiser_site_id: "MLA"
+        }
+      })
+    });
+    expect(resolveMercadoLibreProductAdsContextMock).not.toHaveBeenCalled();
+    expect(listMercadoLibreProductAdsAdvertisersMock).not.toHaveBeenCalled();
+    expect(searchMercadoLibreProductAdsAdsMock).toHaveBeenCalledWith(
+      "profile-1",
+      expect.objectContaining({
+        dateFrom: searchParams.dateFrom,
+        dateTo: searchParams.dateTo,
+        metrics: searchParams.metrics,
+        limit: 25,
+        offset: 0
+      })
+    );
+    expect(searchMercadoLibreProductAdsAdsMock).toHaveBeenCalledTimes(1);
+  });
+  it("returns a guided selection response when an explicit advertiser pair is rejected upstream", async () => {
+    resolveMercadoLibreProfileOrSelectionMock.mockResolvedValueOnce({
+      ok: true,
+      value: {
+        profileId: "profile-1"
+      }
+    });
+    searchMercadoLibreProductAdsAdsMock.mockRejectedValueOnce(new MercadoLibreApiError("not found", 404));
+    resolveMercadoLibreProductAdsContextMock.mockResolvedValueOnce({
+      ok: false,
+      response: { kind: "object", value: { selection_required: true, reason: "advertiser_context_not_found" } }
+    });
+    await expect(
+      adsModule.meliSearchProductAdsAdsHandler({
+        profileId: "profile-1",
+        siteId: "MLA",
+        advertiserId: "adv-1",
+        dateFrom: searchParams.dateFrom,
+        dateTo: searchParams.dateTo,
+        metrics: searchParams.metrics,
+        limit: 25,
+        offset: 0
+      })
+    ).resolves.toEqual({
+      kind: "object",
+      value: { selection_required: true, reason: "advertiser_context_not_found" }
+    });
+    expect(searchMercadoLibreProductAdsAdsMock).toHaveBeenCalledTimes(1);
+    expect(resolveMercadoLibreProductAdsContextMock).toHaveBeenCalledWith({
+      profileId: "profile-1",
+      siteId: "MLA",
+      advertiserId: "adv-1"
+    });
+  });
+  it.each([
+    [401, "unauthorized"],
+    [403, "forbidden"]
+  ])(
+    "preserves upstream %s auth failures instead of converting them to guided selection",
+    async (status, message) => {
+      resolveMercadoLibreProfileOrSelectionMock.mockResolvedValueOnce({
+        ok: true,
+        value: {
+          profileId: "profile-1"
+        }
+      });
+      searchMercadoLibreProductAdsAdsMock.mockRejectedValueOnce(new MercadoLibreApiError(message, status));
+      await expect(
+        adsModule.meliSearchProductAdsAdsHandler({
+          profileId: "profile-1",
+          siteId: "MLA",
+          advertiserId: "adv-1",
+          dateFrom: searchParams.dateFrom,
+          dateTo: searchParams.dateTo,
+          metrics: searchParams.metrics
+        })
+      ).resolves.toEqual({
+        kind: "error",
+        value: message
+      });
+      expect(searchMercadoLibreProductAdsAdsMock).toHaveBeenCalledTimes(1);
+      expect(resolveMercadoLibreProductAdsContextMock).not.toHaveBeenCalled();
+    }
+  );
+  it("marks an underfilled non-terminal page as not having a reliable continuation", async () => {
+    resolveMercadoLibreProfileOrSelectionMock.mockResolvedValueOnce({
+      ok: true,
+      value: {
+        profileId: "profile-1"
+      }
+    });
+    searchMercadoLibreProductAdsAdsMock.mockResolvedValueOnce({
+      paging: { total: 150, 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"
+          }
+        }
+      ]
+    });
+    const result = await adsModule.meliSearchProductAdsAdsHandler({
+      profileId: "profile-1",
+      siteId: "MLA",
+      advertiserId: "adv-1",
+      dateFrom: searchParams.dateFrom,
+      dateTo: searchParams.dateTo,
+      metrics: searchParams.metrics,
+      limit: 25,
+      offset: 0
+    });
+    expect(result).toEqual({
+      kind: "object",
+      value: expect.objectContaining({
+        metadata: expect.objectContaining({
+          requested_limit: 25,
+          effective_limit: 50,
+          returned: 1,
+          has_more: false,
+          continuation: "The returned page had fewer rows than the effective limit, so page-mode continuation is not reliable for this response."
+        })
+      })
+    });
+    expect(result.value.metadata).not.toHaveProperty(
+      "next_offset"
+    );
+    expect(resolveMercadoLibreProductAdsContextMock).not.toHaveBeenCalled();
+  });
+  it("keeps requested, effective, and page ads pagination metadata separate", async () => {
+    resolveMercadoLibreProfileOrSelectionMock.mockResolvedValueOnce({
+      ok: true,
+      value: {
+        profileId: "profile-1"
+      }
+    });
+    searchMercadoLibreProductAdsAdsMock.mockResolvedValueOnce({
+      paging: { total: 2, 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"
+          }
+        }
+      ]
+    });
+    const result = await adsModule.meliSearchProductAdsAdsHandler({
+      profileId: "profile-1",
+      siteId: "MLA",
+      advertiserId: "adv-1",
+      dateFrom: searchParams.dateFrom,
+      dateTo: searchParams.dateTo,
+      metrics: searchParams.metrics,
+      limit: 1,
+      offset: 0
+    });
+    expect(result).toEqual({
+      kind: "object",
+      value: expect.objectContaining({
+        mode: "page",
+        paging: { total: 2, 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"
+            }
+          }
+        ],
+        metadata: expect.objectContaining({
+          requested_limit: 1,
+          fetch_mode: "page",
+          requested_offset: 0,
+          effective_limit: 50,
+          effective_offset: 0,
+          returned: 1,
+          has_more: false
+        })
+      })
+    });
+    expect(result.value.metadata).not.toHaveProperty(
+      "next_offset"
+    );
+    expect(resolveMercadoLibreProductAdsContextMock).not.toHaveBeenCalled();
+    expect(searchMercadoLibreProductAdsAdsMock).toHaveBeenCalledWith(
+      "profile-1",
+      expect.objectContaining({
+        siteId: "MLA",
+        advertiserId: "adv-1",
+        dateFrom: searchParams.dateFrom,
+        dateTo: searchParams.dateTo,
+        metrics: searchParams.metrics,
+        limit: 1,
+        offset: 0
+      })
+    );
+  });
+});
+//# sourceMappingURL=product-ads-tools.test.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/tools/mercadolibre/__tests__/product-ads-tools.test.ts"],
+  "sourcesContent": ["import { beforeEach, describe, expect, it, vi } from \"vitest\";\nimport { z } from \"zod\";\n\nimport { MercadoLibreApiError } from \"../../../services/mercadolibre/mercadolibre-api.js\";\n\nconst objectMock = vi.fn((value) => ({ kind: \"object\", value }));\nconst errorMock = vi.fn((value) => ({ kind: \"error\", value }));\nconst resolveMercadoLibreProfileOrSelectionMock = vi.fn();\nconst resolveMercadoLibreProductAdsContextMock = vi.fn();\nconst listMercadoLibreProductAdsAdvertisersMock = vi.fn();\nconst searchMercadoLibreProductAdsAdsMock = vi.fn();\n\nvi.mock(\"mcp-use/server\", () => ({\n  object: objectMock,\n  error: errorMock,\n}));\n\nvi.mock(\"../profile-resolution.js\", () => ({\n  resolveMercadoLibreProfileOrSelection: resolveMercadoLibreProfileOrSelectionMock,\n}));\n\nvi.mock(\"../product-ads-helpers.js\", () => ({\n  resolveMercadoLibreProductAdsContext: resolveMercadoLibreProductAdsContextMock,\n  mercadolibreProductAdsProfileIdSchemaField: z.string().optional(),\n  mercadolibreProductAdsSiteIdSchemaField: z.string().optional(),\n  mercadolibreProductAdsAdvertiserIdSchemaField: z.string().optional(),\n}));\n\nvi.mock(\"../../../services/mercadolibre/mercadolibre-product-ads.js\", () => ({\n  listMercadoLibreProductAdsAdvertisers: listMercadoLibreProductAdsAdvertisersMock,\n  searchMercadoLibreProductAdsAds: searchMercadoLibreProductAdsAdsMock,\n}));\n\nconst toolsModule = await import(\"../get-product-ads-advertisers.js\");\nconst adsModule = await import(\"../search-product-ads-ads.js\");\n\ndescribe(\"mercadolibre product ads tools\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n  });\n\n  const searchParams = {\n    dateFrom: \"2026-06-01\",\n    dateTo: \"2026-06-30\",\n    metrics: [\"direct_amount\", \"indirect_amount\", \"total_amount\", \"clicks\", \"impressions\", \"cost\"],\n  };\n\n  function buildAdsRows(start: number, count: number) {\n    return Array.from({ length: count }, (_, index) => {\n      const adNumber = start + index;\n\n      return {\n        item_id: `item-${adNumber}`,\n        title: `Item ${adNumber}`,\n        status: adNumber % 2 === 0 ? \"paused\" : \"active\",\n        campaign_id: `campaign-${adNumber}`,\n        campaign_name: `Campaign ${adNumber}`,\n        ad_group_id: `ad-group-${adNumber}`,\n        ad_group_name: `Ad group ${adNumber}`,\n        channel: adNumber % 2 === 0 ? \"marketplace\" : \"mshops\",\n        brand_value_name: `Brand ${adNumber}`,\n        metrics: {\n          direct_amount: adNumber * 10,\n          indirect_amount: adNumber,\n          total_amount: adNumber * 11,\n          clicks: adNumber * 2,\n          impressions: adNumber * 20,\n          cost: adNumber * 3,\n          advertising_items_quantity: 1,\n          currency_id: \"ARS\",\n        },\n      };\n    });\n  }\n\n  it(\"returns a guided selection response when profile selection is required\", async () => {\n    resolveMercadoLibreProfileOrSelectionMock.mockResolvedValueOnce({\n      ok: false,\n      response: { kind: \"object\", value: { selection_required: true } },\n    });\n\n    await expect(\n      toolsModule.meliListProductAdsAdvertisersHandler({ profileId: undefined })\n    ).resolves.toEqual({ kind: \"object\", value: { selection_required: true } });\n  });\n\n  it(\"returns compact advertiser discovery rows\", async () => {\n    resolveMercadoLibreProfileOrSelectionMock.mockResolvedValueOnce({\n      ok: true,\n      value: { profileId: \"profile-1\" },\n    });\n    listMercadoLibreProductAdsAdvertisersMock.mockResolvedValueOnce([\n      {\n        advertiser_id: \"adv-1\",\n        advertiser_site_id: \"MLA\",\n        account_name: \"Main account\",\n        business_name: \"Main business\",\n        status: \"active\",\n      },\n    ]);\n\n    await expect(\n      toolsModule.meliListProductAdsAdvertisersHandler({ profileId: \"profile-1\" })\n    ).resolves.toEqual({\n      kind: \"object\",\n      value: expect.objectContaining({\n        profile_id: \"profile-1\",\n        product: \"PADS\",\n        advertisers_schema: [\n          \"advertiser_id\",\n          \"advertiser_site_id\",\n          \"account_name\",\n          \"business_name\",\n          \"status\",\n        ],\n        advertisers: [[\"adv-1\", \"MLA\", \"Main account\", \"Main business\", \"active\"]],\n        metadata: expect.objectContaining({\n          continuation:\n            \"Use one of the returned advertiser_site_id and advertiser_id pairs by passing them as siteId and advertiserId to the Product Ads search tool. That tool returns page metadata with next_offset when more rows remain.\",\n        }),\n      }),\n    });\n  });\n\n  it(\"rejects full_universe mode in the page-only ads search contract\", () => {\n    expect(\n      adsModule.meliSearchProductAdsAdsSchema.safeParse({\n        profileId: \"profile-1\",\n        siteId: \"MLA\",\n        advertiserId: \"adv-1\",\n        dateFrom: searchParams.dateFrom,\n        dateTo: searchParams.dateTo,\n        metrics: searchParams.metrics,\n        mode: \"full_universe\",\n      }).success\n    ).toBe(false);\n\n    expect(\n      adsModule.meliSearchProductAdsAdsSchema.safeParse({\n        profileId: \"profile-1\",\n        siteId: \"MLA\",\n        advertiserId: \"adv-1\",\n        dateFrom: searchParams.dateFrom,\n        dateTo: searchParams.dateTo,\n        metrics: searchParams.metrics,\n      }).success\n    ).toBe(true);\n  });\n\n  it(\"returns the context selection response when ads search cannot resolve advertiser scope\", async () => {\n    resolveMercadoLibreProfileOrSelectionMock.mockResolvedValueOnce({\n      ok: true,\n      value: {\n        profileId: \"profile-1\",\n      },\n    });\n    resolveMercadoLibreProductAdsContextMock.mockResolvedValueOnce({\n      ok: false,\n      response: { kind: \"object\", value: { selection_required: true } },\n    });\n\n    await expect(\n      adsModule.meliSearchProductAdsAdsHandler({ profileId: \"profile-1\" } as never)\n    ).resolves.toEqual({ kind: \"object\", value: { selection_required: true } });\n  });\n\n  it(\"uses explicit advertiser identifiers directly when both are provided\", async () => {\n    resolveMercadoLibreProfileOrSelectionMock.mockResolvedValueOnce({\n      ok: true,\n      value: {\n        profileId: \"profile-1\",\n      },\n    });\n    searchMercadoLibreProductAdsAdsMock.mockResolvedValueOnce({\n      paging: { total: 150, limit: 50, offset: 0 },\n      results: buildAdsRows(1, 50),\n    });\n\n    const result = await adsModule.meliSearchProductAdsAdsHandler({\n      profileId: \"profile-1\",\n      siteId: \"MLA\",\n      advertiserId: \"adv-1\",\n      dateFrom: searchParams.dateFrom,\n      dateTo: searchParams.dateTo,\n      metrics: searchParams.metrics,\n      limit: 25,\n      offset: 0,\n    } as never);\n\n    expect(result).toEqual({\n      kind: \"object\",\n      value: expect.objectContaining({\n        profile_id: \"profile-1\",\n        site_id: \"MLA\",\n        advertiser_id: \"adv-1\",\n        product: \"PADS\",\n        mode: \"page\",\n        paging: { total: 150, limit: 50, offset: 0 },\n        results: buildAdsRows(1, 50),\n        metadata: expect.objectContaining({\n          entity: \"ads\",\n          fetch_mode: \"page\",\n          total: 150,\n          requested_limit: 25,\n          requested_offset: 0,\n          effective_limit: 50,\n          effective_offset: 0,\n          returned: 50,\n          has_more: true,\n          next_offset: 50,\n          continuation: \"Re-run meli_search_product_ads_ads with mode=page and offset=50, limit=50 to continue.\",\n        }),\n        context_resolution: {\n          mode: \"explicit\",\n          advertiser_id: \"adv-1\",\n          advertiser_site_id: \"MLA\",\n        },\n      }),\n    });\n\n    expect(resolveMercadoLibreProductAdsContextMock).not.toHaveBeenCalled();\n    expect(listMercadoLibreProductAdsAdvertisersMock).not.toHaveBeenCalled();\n\n    expect(searchMercadoLibreProductAdsAdsMock).toHaveBeenCalledWith(\n      \"profile-1\",\n      expect.objectContaining({\n        dateFrom: searchParams.dateFrom,\n        dateTo: searchParams.dateTo,\n        metrics: searchParams.metrics,\n        limit: 25,\n        offset: 0,\n      })\n    );\n\n    expect(searchMercadoLibreProductAdsAdsMock).toHaveBeenCalledTimes(1);\n  });\n\n  it(\"returns a guided selection response when an explicit advertiser pair is rejected upstream\", async () => {\n    resolveMercadoLibreProfileOrSelectionMock.mockResolvedValueOnce({\n      ok: true,\n      value: {\n        profileId: \"profile-1\",\n      },\n    });\n    searchMercadoLibreProductAdsAdsMock.mockRejectedValueOnce(new MercadoLibreApiError(\"not found\", 404));\n    resolveMercadoLibreProductAdsContextMock.mockResolvedValueOnce({\n      ok: false,\n      response: { kind: \"object\", value: { selection_required: true, reason: \"advertiser_context_not_found\" } },\n    });\n\n    await expect(\n      adsModule.meliSearchProductAdsAdsHandler({\n        profileId: \"profile-1\",\n        siteId: \"MLA\",\n        advertiserId: \"adv-1\",\n        dateFrom: searchParams.dateFrom,\n        dateTo: searchParams.dateTo,\n        metrics: searchParams.metrics,\n        limit: 25,\n        offset: 0,\n      } as never)\n    ).resolves.toEqual({\n      kind: \"object\",\n      value: { selection_required: true, reason: \"advertiser_context_not_found\" },\n    });\n\n    expect(searchMercadoLibreProductAdsAdsMock).toHaveBeenCalledTimes(1);\n    expect(resolveMercadoLibreProductAdsContextMock).toHaveBeenCalledWith({\n      profileId: \"profile-1\",\n      siteId: \"MLA\",\n      advertiserId: \"adv-1\",\n    });\n  });\n\n  it.each([\n    [401, \"unauthorized\"],\n    [403, \"forbidden\"],\n  ] as const)(\n    \"preserves upstream %s auth failures instead of converting them to guided selection\",\n    async (status, message) => {\n      resolveMercadoLibreProfileOrSelectionMock.mockResolvedValueOnce({\n        ok: true,\n        value: {\n          profileId: \"profile-1\",\n        },\n      });\n      searchMercadoLibreProductAdsAdsMock.mockRejectedValueOnce(new MercadoLibreApiError(message, status));\n\n      await expect(\n        adsModule.meliSearchProductAdsAdsHandler({\n          profileId: \"profile-1\",\n          siteId: \"MLA\",\n          advertiserId: \"adv-1\",\n          dateFrom: searchParams.dateFrom,\n          dateTo: searchParams.dateTo,\n          metrics: searchParams.metrics,\n        } as never)\n      ).resolves.toEqual({\n        kind: \"error\",\n        value: message,\n      });\n\n      expect(searchMercadoLibreProductAdsAdsMock).toHaveBeenCalledTimes(1);\n      expect(resolveMercadoLibreProductAdsContextMock).not.toHaveBeenCalled();\n    }\n  );\n\n  it(\"marks an underfilled non-terminal page as not having a reliable continuation\", async () => {\n    resolveMercadoLibreProfileOrSelectionMock.mockResolvedValueOnce({\n      ok: true,\n      value: {\n        profileId: \"profile-1\",\n      },\n    });\n    searchMercadoLibreProductAdsAdsMock.mockResolvedValueOnce({\n      paging: { total: 150, limit: 50, offset: 0 },\n      results: [\n        {\n          item_id: \"item-1\",\n          title: \"Item one\",\n          status: \"active\",\n          campaign_id: \"campaign-1\",\n          campaign_name: \"Campaign one\",\n          ad_group_id: \"ad-group-1\",\n          ad_group_name: \"Ad group one\",\n          channel: \"mshops\",\n          brand_value_name: \"Brand one\",\n          metrics: {\n            direct_amount: 12.5,\n            indirect_amount: 2.5,\n            total_amount: 15,\n            clicks: 7,\n            impressions: 120,\n            cost: 9.75,\n            advertising_items_quantity: 1,\n            currency_id: \"ARS\",\n          },\n        },\n      ],\n    });\n\n    const result = await adsModule.meliSearchProductAdsAdsHandler({\n      profileId: \"profile-1\",\n      siteId: \"MLA\",\n      advertiserId: \"adv-1\",\n      dateFrom: searchParams.dateFrom,\n      dateTo: searchParams.dateTo,\n      metrics: searchParams.metrics,\n      limit: 25,\n      offset: 0,\n    } as never);\n\n    expect(result).toEqual({\n      kind: \"object\",\n      value: expect.objectContaining({\n        metadata: expect.objectContaining({\n          requested_limit: 25,\n          effective_limit: 50,\n          returned: 1,\n          has_more: false,\n          continuation:\n            \"The returned page had fewer rows than the effective limit, so page-mode continuation is not reliable for this response.\",\n        }),\n      }),\n    });\n\n    expect((result as unknown as { value: { metadata: Record<string, unknown> } }).value.metadata).not.toHaveProperty(\n      \"next_offset\"\n    );\n\n    expect(resolveMercadoLibreProductAdsContextMock).not.toHaveBeenCalled();\n  });\n  it(\"keeps requested, effective, and page ads pagination metadata separate\", async () => {\n    resolveMercadoLibreProfileOrSelectionMock.mockResolvedValueOnce({\n      ok: true,\n      value: {\n        profileId: \"profile-1\",\n      },\n    });\n    searchMercadoLibreProductAdsAdsMock.mockResolvedValueOnce({\n      paging: { total: 2, limit: 50, offset: 0 },\n      results: [\n        {\n          item_id: \"item-1\",\n          title: \"Item one\",\n          status: \"active\",\n          campaign_id: \"campaign-1\",\n          campaign_name: \"Campaign one\",\n          ad_group_id: \"ad-group-1\",\n          ad_group_name: \"Ad group one\",\n          channel: \"mshops\",\n          brand_value_name: \"Brand one\",\n          metrics: {\n            direct_amount: 12.5,\n            indirect_amount: 2.5,\n            total_amount: 15,\n            clicks: 7,\n            impressions: 120,\n            cost: 9.75,\n            advertising_items_quantity: 1,\n            currency_id: \"ARS\",\n          },\n        },\n      ],\n    });\n\n    const result = await adsModule.meliSearchProductAdsAdsHandler({\n      profileId: \"profile-1\",\n      siteId: \"MLA\",\n      advertiserId: \"adv-1\",\n      dateFrom: searchParams.dateFrom,\n      dateTo: searchParams.dateTo,\n      metrics: searchParams.metrics,\n      limit: 1,\n      offset: 0,\n    } as never);\n\n    expect(result).toEqual({\n      kind: \"object\",\n      value: expect.objectContaining({\n        mode: \"page\",\n        paging: { total: 2, limit: 50, offset: 0 },\n        results: [\n          {\n            item_id: \"item-1\",\n            title: \"Item one\",\n            status: \"active\",\n            campaign_id: \"campaign-1\",\n            campaign_name: \"Campaign one\",\n            ad_group_id: \"ad-group-1\",\n            ad_group_name: \"Ad group one\",\n            channel: \"mshops\",\n            brand_value_name: \"Brand one\",\n            metrics: {\n              direct_amount: 12.5,\n              indirect_amount: 2.5,\n              total_amount: 15,\n              clicks: 7,\n              impressions: 120,\n              cost: 9.75,\n              advertising_items_quantity: 1,\n              currency_id: \"ARS\",\n            },\n          },\n        ],\n        metadata: expect.objectContaining({\n          requested_limit: 1,\n          fetch_mode: \"page\",\n          requested_offset: 0,\n          effective_limit: 50,\n          effective_offset: 0,\n          returned: 1,\n          has_more: false,\n        }),\n      }),\n    });\n\n    expect((result as unknown as { value: { metadata: Record<string, unknown> } }).value.metadata).not.toHaveProperty(\n      \"next_offset\"\n    );\n\n    expect(resolveMercadoLibreProductAdsContextMock).not.toHaveBeenCalled();\n\n    expect(searchMercadoLibreProductAdsAdsMock).toHaveBeenCalledWith(\n      \"profile-1\",\n      expect.objectContaining({\n        siteId: \"MLA\",\n        advertiserId: \"adv-1\",\n        dateFrom: searchParams.dateFrom,\n        dateTo: searchParams.dateTo,\n        metrics: searchParams.metrics,\n        limit: 1,\n        offset: 0,\n      })\n    );\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/mercadolibre/__tests__/reconcile-buyer-data.test.js

@@ -0,0 +1,31 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const { errorMock, objectMock, reconcileMock, resolveProfileMock } = vi.hoisted(() => ({
+  errorMock: vi.fn((message) => ({ kind: "error", message })),
+  objectMock: vi.fn((payload) => ({ kind: "object", payload })),
+  reconcileMock: vi.fn(),
+  resolveProfileMock: vi.fn()
+}));
+vi.mock("mcp-use/server", () => ({ error: errorMock, object: objectMock }));
+vi.mock("../../../services/mercadolibre/mercadolibre-buyer-reconciliation.js", () => ({ reconcileMercadoLibreBuyerData: reconcileMock }));
+vi.mock("../profile-resolution.js", () => ({ resolveMercadoLibreProfileOrSelection: resolveProfileMock }));
+import { meliReconcileBuyerDataHandler, meliReconcileBuyerDataSchema } from "../reconcile-buyer-data.js";
+describe("meli_reconcile_buyer_data", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    resolveProfileMock.mockResolvedValue({ ok: true, value: { profileId: "triplim" } });
+  });
+  it("requires an explicit profile and bounds PII-rich references to five", () => {
+    expect(() => meliReconcileBuyerDataSchema.parse({ profileId: "triplim", saleReferences: ["order-1"] })).not.toThrow();
+    expect(() => meliReconcileBuyerDataSchema.parse({ profileId: "triplim", saleReferences: Array.from({ length: 6 }, () => "x") })).toThrow();
+    expect(() => meliReconcileBuyerDataSchema.parse({ profileId: "", saleReferences: ["x"] })).toThrow();
+    expect(() => meliReconcileBuyerDataSchema.parse({ profileId: "triplim", saleReferences: [" "] })).toThrow();
+  });
+  it("passes the explicit profile and returns the useful domain contract", async () => {
+    const response = { results: [{ sale_reference: "order-1", resolution: { kind: "order", status: "resolved" } }], summary: { requested: 1 } };
+    reconcileMock.mockResolvedValue(response);
+    const result = await meliReconcileBuyerDataHandler({ profileId: "triplim", saleReferences: ["order-1"] });
+    expect(result).toEqual({ kind: "object", payload: response });
+    expect(reconcileMock).toHaveBeenCalledWith("triplim", ["order-1"]);
+  });
+});
+//# sourceMappingURL=reconcile-buyer-data.test.js.map

package/dist/src/tools/mercadolibre/__tests__/reconcile-buyer-data.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/tools/mercadolibre/__tests__/reconcile-buyer-data.test.ts"],
+  "sourcesContent": ["import { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nconst { errorMock, objectMock, reconcileMock, resolveProfileMock } = vi.hoisted(() => ({\n  errorMock: vi.fn((message: string) => ({ kind: \"error\", message })),\n  objectMock: vi.fn((payload: unknown) => ({ kind: \"object\", payload })),\n  reconcileMock: vi.fn(),\n  resolveProfileMock: vi.fn(),\n}));\n\nvi.mock(\"mcp-use/server\", () => ({ error: errorMock, object: objectMock }));\nvi.mock(\"../../../services/mercadolibre/mercadolibre-buyer-reconciliation.js\", () => ({ reconcileMercadoLibreBuyerData: reconcileMock }));\nvi.mock(\"../profile-resolution.js\", () => ({ resolveMercadoLibreProfileOrSelection: resolveProfileMock }));\n\nimport { meliReconcileBuyerDataHandler, meliReconcileBuyerDataSchema } from \"../reconcile-buyer-data.js\";\n\ndescribe(\"meli_reconcile_buyer_data\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n    resolveProfileMock.mockResolvedValue({ ok: true, value: { profileId: \"triplim\" } });\n  });\n\n  it(\"requires an explicit profile and bounds PII-rich references to five\", () => {\n    expect(() => meliReconcileBuyerDataSchema.parse({ profileId: \"triplim\", saleReferences: [\"order-1\"] })).not.toThrow();\n    expect(() => meliReconcileBuyerDataSchema.parse({ profileId: \"triplim\", saleReferences: Array.from({ length: 6 }, () => \"x\") })).toThrow();\n    expect(() => meliReconcileBuyerDataSchema.parse({ profileId: \"\", saleReferences: [\"x\"] })).toThrow();\n    expect(() => meliReconcileBuyerDataSchema.parse({ profileId: \"triplim\", saleReferences: [\" \"] })).toThrow();\n  });\n\n  it(\"passes the explicit profile and returns the useful domain contract\", async () => {\n    const response = { results: [{ sale_reference: \"order-1\", resolution: { kind: \"order\", status: \"resolved\" } }], summary: { requested: 1 } };\n    reconcileMock.mockResolvedValue(response);\n    const result = await meliReconcileBuyerDataHandler({ profileId: \"triplim\", saleReferences: [\"order-1\"] });\n    expect(result).toEqual({ kind: \"object\", payload: response });\n    expect(reconcileMock).toHaveBeenCalledWith(\"triplim\", [\"order-1\"]);\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,YAAY,UAAU,QAAQ,IAAI,UAAU;AAErD,MAAM,EAAE,WAAW,YAAY,eAAe,mBAAmB,IAAI,GAAG,QAAQ,OAAO;AAAA,EACrF,WAAW,GAAG,GAAG,CAAC,aAAqB,EAAE,MAAM,SAAS,QAAQ,EAAE;AAAA,EAClE,YAAY,GAAG,GAAG,CAAC,aAAsB,EAAE,MAAM,UAAU,QAAQ,EAAE;AAAA,EACrE,eAAe,GAAG,GAAG;AAAA,EACrB,oBAAoB,GAAG,GAAG;AAC5B,EAAE;AAEF,GAAG,KAAK,kBAAkB,OAAO,EAAE,OAAO,WAAW,QAAQ,WAAW,EAAE;AAC1E,GAAG,KAAK,uEAAuE,OAAO,EAAE,gCAAgC,cAAc,EAAE;AACxI,GAAG,KAAK,4BAA4B,OAAO,EAAE,uCAAuC,mBAAmB,EAAE;AAEzG,SAAS,+BAA+B,oCAAoC;AAE5E,SAAS,6BAA6B,MAAM;AAC1C,aAAW,MAAM;AACf,OAAG,cAAc;AACjB,uBAAmB,kBAAkB,EAAE,IAAI,MAAM,OAAO,EAAE,WAAW,UAAU,EAAE,CAAC;AAAA,EACpF,CAAC;AAED,KAAG,uEAAuE,MAAM;AAC9E,WAAO,MAAM,6BAA6B,MAAM,EAAE,WAAW,WAAW,gBAAgB,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,IAAI,QAAQ;AACpH,WAAO,MAAM,6BAA6B,MAAM,EAAE,WAAW,WAAW,gBAAgB,MAAM,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ;AACzI,WAAO,MAAM,6BAA6B,MAAM,EAAE,WAAW,IAAI,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ;AACnG,WAAO,MAAM,6BAA6B,MAAM,EAAE,WAAW,WAAW,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ;AAAA,EAC5G,CAAC;AAED,KAAG,sEAAsE,YAAY;AACnF,UAAM,WAAW,EAAE,SAAS,CAAC,EAAE,gBAAgB,WAAW,YAAY,EAAE,MAAM,SAAS,QAAQ,WAAW,EAAE,CAAC,GAAG,SAAS,EAAE,WAAW,EAAE,EAAE;AAC1I,kBAAc,kBAAkB,QAAQ;AACxC,UAAM,SAAS,MAAM,8BAA8B,EAAE,WAAW,WAAW,gBAAgB,CAAC,SAAS,EAAE,CAAC;AACxG,WAAO,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,SAAS,SAAS,CAAC;AAC5D,WAAO,aAAa,EAAE,qBAAqB,WAAW,CAAC,SAAS,CAAC;AAAA,EACnE,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/src/tools/mercadolibre/__tests__/reconcile-claim-data.test.js

@@ -0,0 +1,36 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const { errorMock, objectMock, reconcileMock, resolveProfileMock } = vi.hoisted(() => ({
+  errorMock: vi.fn((message) => ({ kind: "error", message })),
+  objectMock: vi.fn((payload) => ({ kind: "object", payload })),
+  reconcileMock: vi.fn(),
+  resolveProfileMock: vi.fn()
+}));
+vi.mock("mcp-use/server", () => ({ error: errorMock, object: objectMock }));
+vi.mock("../../../services/mercadolibre/mercadolibre-claim-reconciliation.js", () => ({ reconcileMercadoLibreClaimData: reconcileMock }));
+vi.mock("../profile-resolution.js", () => ({ resolveMercadoLibreProfileOrSelection: resolveProfileMock }));
+import { meliReconcileClaimDataDescription, meliReconcileClaimDataHandler, meliReconcileClaimDataSchema } from "../reconcile-claim-data.js";
+describe("meli_reconcile_claim_data", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    resolveProfileMock.mockResolvedValue({ ok: true, value: { profileId: "triplim" } });
+  });
+  it("defaults to standard and applies the conditional reference bound", () => {
+    expect(meliReconcileClaimDataSchema.parse({ profileId: "triplim", saleReferences: ["a"] }).detailLevel).toBe("standard");
+    expect(meliReconcileClaimDataSchema.safeParse({ profileId: "triplim", saleReferences: ["1", "2", "3", "4", "5"] }).success).toBe(true);
+    expect(meliReconcileClaimDataSchema.safeParse({ profileId: "triplim", saleReferences: ["1", "2", "3", "4", "5", "6"] }).success).toBe(false);
+    expect(meliReconcileClaimDataSchema.safeParse({ profileId: "triplim", detailLevel: "full", saleReferences: ["1", "2"] }).success).toBe(true);
+    expect(meliReconcileClaimDataSchema.safeParse({ profileId: "triplim", detailLevel: "full", saleReferences: ["1", "2", "3"] }).success).toBe(false);
+  });
+  it("preserves the explicit profile and teaches the safety contract", async () => {
+    const response = { results: [], summary: { requested: 1 } };
+    reconcileMock.mockResolvedValue(response);
+    expect(meliReconcileClaimDataDescription).toContain("untrusted");
+    expect(meliReconcileClaimDataDescription).toContain("conversation or evidence-level detail");
+    expect(meliReconcileClaimDataDescription).toContain("normalized review");
+    expect(meliReconcileClaimDataDescription).toContain("normalized return cost");
+    const result = await meliReconcileClaimDataHandler({ profileId: "triplim", detailLevel: "standard", saleReferences: ["order-1"] });
+    expect(result).toEqual({ kind: "object", payload: { summary: { requested: 1 } } });
+    expect(reconcileMock).toHaveBeenCalledWith("triplim", ["order-1"], "standard");
+  });
+});
+//# sourceMappingURL=reconcile-claim-data.test.js.map

package/dist/src/tools/mercadolibre/__tests__/reconcile-claim-data.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/tools/mercadolibre/__tests__/reconcile-claim-data.test.ts"],
+  "sourcesContent": ["import { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nconst { errorMock, objectMock, reconcileMock, resolveProfileMock } = vi.hoisted(() => ({\n  errorMock: vi.fn((message: string) => ({ kind: \"error\", message })),\n  objectMock: vi.fn((payload: unknown) => ({ kind: \"object\", payload })),\n  reconcileMock: vi.fn(),\n  resolveProfileMock: vi.fn(),\n}));\n\nvi.mock(\"mcp-use/server\", () => ({ error: errorMock, object: objectMock }));\nvi.mock(\"../../../services/mercadolibre/mercadolibre-claim-reconciliation.js\", () => ({ reconcileMercadoLibreClaimData: reconcileMock }));\nvi.mock(\"../profile-resolution.js\", () => ({ resolveMercadoLibreProfileOrSelection: resolveProfileMock }));\n\nimport { meliReconcileClaimDataDescription, meliReconcileClaimDataHandler, meliReconcileClaimDataSchema } from \"../reconcile-claim-data.js\";\n\ndescribe(\"meli_reconcile_claim_data\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n    resolveProfileMock.mockResolvedValue({ ok: true, value: { profileId: \"triplim\" } });\n  });\n\n  it(\"defaults to standard and applies the conditional reference bound\", () => {\n    expect(meliReconcileClaimDataSchema.parse({ profileId: \"triplim\", saleReferences: [\"a\"] }).detailLevel).toBe(\"standard\");\n    expect(meliReconcileClaimDataSchema.safeParse({ profileId: \"triplim\", saleReferences: [\"1\", \"2\", \"3\", \"4\", \"5\"] }).success).toBe(true);\n    expect(meliReconcileClaimDataSchema.safeParse({ profileId: \"triplim\", saleReferences: [\"1\", \"2\", \"3\", \"4\", \"5\", \"6\"] }).success).toBe(false);\n    expect(meliReconcileClaimDataSchema.safeParse({ profileId: \"triplim\", detailLevel: \"full\", saleReferences: [\"1\", \"2\"] }).success).toBe(true);\n    expect(meliReconcileClaimDataSchema.safeParse({ profileId: \"triplim\", detailLevel: \"full\", saleReferences: [\"1\", \"2\", \"3\"] }).success).toBe(false);\n  });\n\n  it(\"preserves the explicit profile and teaches the safety contract\", async () => {\n    const response = { results: [], summary: { requested: 1 } };\n    reconcileMock.mockResolvedValue(response);\n    expect(meliReconcileClaimDataDescription).toContain(\"untrusted\");\n    expect(meliReconcileClaimDataDescription).toContain(\"conversation or evidence-level detail\");\n    expect(meliReconcileClaimDataDescription).toContain(\"normalized review\");\n    expect(meliReconcileClaimDataDescription).toContain(\"normalized return cost\");\n    const result = await meliReconcileClaimDataHandler({ profileId: \"triplim\", detailLevel: \"standard\", saleReferences: [\"order-1\"] });\n    expect(result).toEqual({ kind: \"object\", payload: { summary: { requested: 1 } } });\n    expect(reconcileMock).toHaveBeenCalledWith(\"triplim\", [\"order-1\"], \"standard\");\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,YAAY,UAAU,QAAQ,IAAI,UAAU;AAErD,MAAM,EAAE,WAAW,YAAY,eAAe,mBAAmB,IAAI,GAAG,QAAQ,OAAO;AAAA,EACrF,WAAW,GAAG,GAAG,CAAC,aAAqB,EAAE,MAAM,SAAS,QAAQ,EAAE;AAAA,EAClE,YAAY,GAAG,GAAG,CAAC,aAAsB,EAAE,MAAM,UAAU,QAAQ,EAAE;AAAA,EACrE,eAAe,GAAG,GAAG;AAAA,EACrB,oBAAoB,GAAG,GAAG;AAC5B,EAAE;AAEF,GAAG,KAAK,kBAAkB,OAAO,EAAE,OAAO,WAAW,QAAQ,WAAW,EAAE;AAC1E,GAAG,KAAK,uEAAuE,OAAO,EAAE,gCAAgC,cAAc,EAAE;AACxI,GAAG,KAAK,4BAA4B,OAAO,EAAE,uCAAuC,mBAAmB,EAAE;AAEzG,SAAS,mCAAmC,+BAA+B,oCAAoC;AAE/G,SAAS,6BAA6B,MAAM;AAC1C,aAAW,MAAM;AACf,OAAG,cAAc;AACjB,uBAAmB,kBAAkB,EAAE,IAAI,MAAM,OAAO,EAAE,WAAW,UAAU,EAAE,CAAC;AAAA,EACpF,CAAC;AAED,KAAG,oEAAoE,MAAM;AAC3E,WAAO,6BAA6B,MAAM,EAAE,WAAW,WAAW,gBAAgB,CAAC,GAAG,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,UAAU;AACvH,WAAO,6BAA6B,UAAU,EAAE,WAAW,WAAW,gBAAgB,CAAC,KAAK,KAAK,KAAK,KAAK,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,IAAI;AACrI,WAAO,6BAA6B,UAAU,EAAE,WAAW,WAAW,gBAAgB,CAAC,KAAK,KAAK,KAAK,KAAK,KAAK,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,KAAK;AAC3I,WAAO,6BAA6B,UAAU,EAAE,WAAW,WAAW,aAAa,QAAQ,gBAAgB,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,IAAI;AAC3I,WAAO,6BAA6B,UAAU,EAAE,WAAW,WAAW,aAAa,QAAQ,gBAAgB,CAAC,KAAK,KAAK,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,KAAK;AAAA,EACnJ,CAAC;AAED,KAAG,kEAAkE,YAAY;AAC/E,UAAM,WAAW,EAAE,SAAS,CAAC,GAAG,SAAS,EAAE,WAAW,EAAE,EAAE;AAC1D,kBAAc,kBAAkB,QAAQ;AACxC,WAAO,iCAAiC,EAAE,UAAU,WAAW;AAC/D,WAAO,iCAAiC,EAAE,UAAU,uCAAuC;AAC3F,WAAO,iCAAiC,EAAE,UAAU,mBAAmB;AACvE,WAAO,iCAAiC,EAAE,UAAU,wBAAwB;AAC5E,UAAM,SAAS,MAAM,8BAA8B,EAAE,WAAW,WAAW,aAAa,YAAY,gBAAgB,CAAC,SAAS,EAAE,CAAC;AACjI,WAAO,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;AACjF,WAAO,aAAa,EAAE,qBAAqB,WAAW,CAAC,SAAS,GAAG,UAAU;AAAA,EAC/E,CAAC;AACH,CAAC;",
+  "names": []
+}