@yoryoboy/bi-mcp 1.10.0 → 1.13.0

package/dist/src/services/vtex/__tests__/vtex-catalog-write-batch.test.js

@@ -0,0 +1,165 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const getMock = vi.fn();
+const postMock = vi.fn();
+const putMock = vi.fn();
+const deleteMock = vi.fn();
+vi.mock("../vtex-api.js", () => ({
+  getVtexApiClients: vi.fn(async () => ({
+    vtexApi: {
+      get: getMock,
+      post: postMock,
+      put: putMock,
+      delete: deleteMock
+    }
+  }))
+}));
+const catalogWrite = await import("../vtex-catalog-write.js");
+describe("VTEX catalog write batch planning and execution", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+  it("builds batch preflight summaries and destructive warnings from mixed operations", async () => {
+    const operations = [
+      {
+        type: "update_product_basic_fields",
+        productId: "product-1",
+        updates: { name: "New Product Name" }
+      },
+      {
+        type: "update_sku_basic_fields",
+        skuId: "sku-1",
+        updates: { measurementUnit: "un", unitMultiplier: 1 }
+      },
+      {
+        type: "replace_sku_eans",
+        skuId: "sku-2",
+        eans: ["111", "222"]
+      }
+    ];
+    await expect(catalogWrite.planCatalogBatch("profile-1", operations)).resolves.toEqual({
+      preflight: {
+        entities: 3,
+        entityTypes: ["product", "sku"],
+        destructive: true,
+        hasDeleteOrReplaceAll: true,
+        dependencyFailureCount: 0,
+        multiEntityCriticalReassignment: false
+      },
+      warnings: ["destructive_operation_detected"],
+      impactedEntityTypes: ["product", "sku"],
+      before: [
+        {
+          operation_index: 0,
+          operation_type: "update_product_basic_fields",
+          resource_id: "product-1"
+        },
+        {
+          operation_index: 1,
+          operation_type: "update_sku_basic_fields",
+          resource_id: "sku-1"
+        },
+        {
+          operation_index: 2,
+          operation_type: "replace_sku_eans",
+          resource_id: "sku-2"
+        }
+      ],
+      after: [
+        {
+          operation_index: 0,
+          operation_type: "update_product_basic_fields",
+          resource_id: "product-1",
+          updates: { name: "New Product Name" }
+        },
+        {
+          operation_index: 1,
+          operation_type: "update_sku_basic_fields",
+          resource_id: "sku-1",
+          updates: { measurementUnit: "un", unitMultiplier: 1 }
+        },
+        {
+          operation_index: 2,
+          operation_type: "replace_sku_eans",
+          resource_id: "sku-2",
+          planned_eans: ["111", "222"]
+        }
+      ]
+    });
+  });
+  it("aggregates batch successes and failures without aborting later operations", async () => {
+    const operations = [
+      {
+        type: "update_product_basic_fields",
+        productId: "product-1",
+        updates: { name: "Updated Product" }
+      },
+      {
+        type: "update_sku_basic_fields",
+        skuId: "sku-1",
+        updates: { name: "Updated SKU" }
+      },
+      {
+        type: "replace_sku_eans",
+        skuId: "sku-2",
+        eans: ["111", "222", "111"]
+      }
+    ];
+    getMock.mockResolvedValueOnce({
+      data: {
+        Name: "Original Product",
+        CategoryId: 10,
+        BrandId: 20
+      }
+    });
+    putMock.mockResolvedValueOnce({
+      data: {
+        Id: "product-1",
+        Name: "Updated Product"
+      }
+    });
+    getMock.mockRejectedValueOnce(new Error("sku fetch failed"));
+    deleteMock.mockResolvedValueOnce({});
+    postMock.mockResolvedValue({});
+    getMock.mockResolvedValueOnce({ data: ["111", "222"] });
+    await expect(catalogWrite.executeCatalogBatch("profile-1", operations)).resolves.toEqual({
+      successful: [
+        {
+          operation_index: 0,
+          operation_type: "update_product_basic_fields",
+          resource_id: "product-1",
+          result: {
+            Id: "product-1",
+            Name: "Updated Product"
+          }
+        },
+        {
+          operation_index: 2,
+          operation_type: "replace_sku_eans",
+          resource_id: "sku-2",
+          result: {
+            eans: ["111", "222"]
+          }
+        }
+      ],
+      failed: [
+        {
+          operation_index: 1,
+          operation_type: "update_sku_basic_fields",
+          resource_id: "sku-1",
+          message: "sku fetch failed"
+        }
+      ]
+    });
+    expect(deleteMock).toHaveBeenCalledWith("/api/catalog/pvt/stockkeepingunit/sku-2/ean");
+    expect(postMock).toHaveBeenNthCalledWith(
+      1,
+      "/api/catalog/pvt/stockkeepingunit/sku-2/ean/111"
+    );
+    expect(postMock).toHaveBeenNthCalledWith(
+      2,
+      "/api/catalog/pvt/stockkeepingunit/sku-2/ean/222"
+    );
+    expect(postMock).toHaveBeenCalledTimes(2);
+  });
+});
+//# sourceMappingURL=vtex-catalog-write-batch.test.js.map

package/dist/src/services/vtex/__tests__/vtex-catalog-write-batch.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/services/vtex/__tests__/vtex-catalog-write-batch.test.ts"],
+  "sourcesContent": ["import { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nconst getMock = vi.fn();\nconst postMock = vi.fn();\nconst putMock = vi.fn();\nconst deleteMock = vi.fn();\n\nvi.mock(\"../vtex-api.js\", () => ({\n  getVtexApiClients: vi.fn(async () => ({\n    vtexApi: {\n      get: getMock,\n      post: postMock,\n      put: putMock,\n      delete: deleteMock,\n    },\n  })),\n}));\n\nconst catalogWrite = await import(\"../vtex-catalog-write.js\");\n\ndescribe(\"VTEX catalog write batch planning and execution\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n  });\n\n  it(\"builds batch preflight summaries and destructive warnings from mixed operations\", async () => {\n    const operations = [\n      {\n        type: \"update_product_basic_fields\" as const,\n        productId: \"product-1\",\n        updates: { name: \"New Product Name\" },\n      },\n      {\n        type: \"update_sku_basic_fields\" as const,\n        skuId: \"sku-1\",\n        updates: { measurementUnit: \"un\", unitMultiplier: 1 },\n      },\n      {\n        type: \"replace_sku_eans\" as const,\n        skuId: \"sku-2\",\n        eans: [\"111\", \"222\"],\n      },\n    ];\n\n    await expect(catalogWrite.planCatalogBatch(\"profile-1\", operations)).resolves.toEqual({\n      preflight: {\n        entities: 3,\n        entityTypes: [\"product\", \"sku\"],\n        destructive: true,\n        hasDeleteOrReplaceAll: true,\n        dependencyFailureCount: 0,\n        multiEntityCriticalReassignment: false,\n      },\n      warnings: [\"destructive_operation_detected\"],\n      impactedEntityTypes: [\"product\", \"sku\"],\n      before: [\n        {\n          operation_index: 0,\n          operation_type: \"update_product_basic_fields\",\n          resource_id: \"product-1\",\n        },\n        {\n          operation_index: 1,\n          operation_type: \"update_sku_basic_fields\",\n          resource_id: \"sku-1\",\n        },\n        {\n          operation_index: 2,\n          operation_type: \"replace_sku_eans\",\n          resource_id: \"sku-2\",\n        },\n      ],\n      after: [\n        {\n          operation_index: 0,\n          operation_type: \"update_product_basic_fields\",\n          resource_id: \"product-1\",\n          updates: { name: \"New Product Name\" },\n        },\n        {\n          operation_index: 1,\n          operation_type: \"update_sku_basic_fields\",\n          resource_id: \"sku-1\",\n          updates: { measurementUnit: \"un\", unitMultiplier: 1 },\n        },\n        {\n          operation_index: 2,\n          operation_type: \"replace_sku_eans\",\n          resource_id: \"sku-2\",\n          planned_eans: [\"111\", \"222\"],\n        },\n      ],\n    });\n  });\n\n  it(\"aggregates batch successes and failures without aborting later operations\", async () => {\n    const operations = [\n      {\n        type: \"update_product_basic_fields\" as const,\n        productId: \"product-1\",\n        updates: { name: \"Updated Product\" },\n      },\n      {\n        type: \"update_sku_basic_fields\" as const,\n        skuId: \"sku-1\",\n        updates: { name: \"Updated SKU\" },\n      },\n      {\n        type: \"replace_sku_eans\" as const,\n        skuId: \"sku-2\",\n        eans: [\"111\", \"222\", \"111\"],\n      },\n    ];\n\n    getMock.mockResolvedValueOnce({\n      data: {\n        Name: \"Original Product\",\n        CategoryId: 10,\n        BrandId: 20,\n      },\n    });\n    putMock.mockResolvedValueOnce({\n      data: {\n        Id: \"product-1\",\n        Name: \"Updated Product\",\n      },\n    });\n    getMock.mockRejectedValueOnce(new Error(\"sku fetch failed\"));\n    deleteMock.mockResolvedValueOnce({});\n    postMock.mockResolvedValue({});\n    getMock.mockResolvedValueOnce({ data: [\"111\", \"222\"] });\n\n    await expect(catalogWrite.executeCatalogBatch(\"profile-1\", operations)).resolves.toEqual({\n      successful: [\n        {\n          operation_index: 0,\n          operation_type: \"update_product_basic_fields\",\n          resource_id: \"product-1\",\n          result: {\n            Id: \"product-1\",\n            Name: \"Updated Product\",\n          },\n        },\n        {\n          operation_index: 2,\n          operation_type: \"replace_sku_eans\",\n          resource_id: \"sku-2\",\n          result: {\n            eans: [\"111\", \"222\"],\n          },\n        },\n      ],\n      failed: [\n        {\n          operation_index: 1,\n          operation_type: \"update_sku_basic_fields\",\n          resource_id: \"sku-1\",\n          message: \"sku fetch failed\",\n        },\n      ],\n    });\n\n    expect(deleteMock).toHaveBeenCalledWith(\"/api/catalog/pvt/stockkeepingunit/sku-2/ean\");\n    expect(postMock).toHaveBeenNthCalledWith(\n      1,\n      \"/api/catalog/pvt/stockkeepingunit/sku-2/ean/111\"\n    );\n    expect(postMock).toHaveBeenNthCalledWith(\n      2,\n      \"/api/catalog/pvt/stockkeepingunit/sku-2/ean/222\"\n    );\n    expect(postMock).toHaveBeenCalledTimes(2);\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/services/vtex/__tests__/vtex-catalog-write-eans.test.js

@@ -0,0 +1,92 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const getMock = vi.fn();
+const postMock = vi.fn();
+const deleteMock = vi.fn();
+vi.mock("../vtex-api.js", () => ({
+  getVtexApiClients: vi.fn(async () => ({
+    vtexApi: {
+      get: getMock,
+      post: postMock,
+      delete: deleteMock
+    }
+  }))
+}));
+const catalogWrite = await import("../vtex-catalog-write.js");
+describe("VTEX catalog write EAN helpers", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+  it("normalizes array EAN responses into strings and drops empty values", async () => {
+    getMock.mockResolvedValueOnce({ data: [789, "", "EAN-1"] });
+    await expect(catalogWrite.getSkuEans("profile-1", "sku-1")).resolves.toEqual(["789", "EAN-1"]);
+    expect(getMock).toHaveBeenCalledWith("/api/catalog/pvt/stockkeepingunit/sku-1/ean");
+  });
+  it("returns an empty array when VTEX returns null for SKU EANs", async () => {
+    getMock.mockResolvedValueOnce({ data: null });
+    await expect(catalogWrite.getSkuEans("profile-1", "sku-2")).resolves.toEqual([]);
+  });
+  it("wraps scalar VTEX EAN responses into an array", async () => {
+    getMock.mockResolvedValueOnce({ data: 1234567890123 });
+    await expect(catalogWrite.getSkuEans("profile-1", "sku-3")).resolves.toEqual([
+      "1234567890123"
+    ]);
+  });
+  it("posts createSkuEan to the SKU-specific EAN endpoint", async () => {
+    postMock.mockResolvedValueOnce({});
+    await expect(catalogWrite.createSkuEan("profile-1", "sku-4", "7791234567890")).resolves.toBeUndefined();
+    expect(postMock).toHaveBeenCalledWith(
+      "/api/catalog/pvt/stockkeepingunit/sku-4/ean/7791234567890"
+    );
+  });
+  it("deletes all EANs using the SKU EAN collection endpoint", async () => {
+    deleteMock.mockResolvedValueOnce({});
+    await expect(catalogWrite.deleteAllSkuEans("profile-1", "sku-5")).resolves.toBeUndefined();
+    expect(deleteMock).toHaveBeenCalledWith("/api/catalog/pvt/stockkeepingunit/sku-5/ean");
+  });
+  it("returns current EANs without posting when addSkuEan receives only whitespace", async () => {
+    getMock.mockResolvedValueOnce({ data: ["7791234567890"] });
+    await expect(catalogWrite.addSkuEan("profile-1", "sku-6", "   ")).resolves.toEqual([
+      "7791234567890"
+    ]);
+    expect(postMock).not.toHaveBeenCalled();
+    expect(getMock).toHaveBeenCalledTimes(1);
+  });
+  it("trims and posts new EANs before reloading the normalized SKU list", async () => {
+    postMock.mockResolvedValueOnce({});
+    getMock.mockResolvedValueOnce({ data: ["7791234567890", "7791234567891"] });
+    await expect(catalogWrite.addSkuEan("profile-1", "sku-7", " 7791234567891 ")).resolves.toEqual([
+      "7791234567890",
+      "7791234567891"
+    ]);
+    expect(postMock).toHaveBeenCalledWith(
+      "/api/catalog/pvt/stockkeepingunit/sku-7/ean/7791234567891"
+    );
+    expect(getMock).toHaveBeenCalledWith("/api/catalog/pvt/stockkeepingunit/sku-7/ean");
+  });
+  it("replaces SKU EANs by deleting first, then posting trimmed unique values in order", async () => {
+    deleteMock.mockResolvedValueOnce({});
+    postMock.mockResolvedValue({});
+    getMock.mockResolvedValueOnce({ data: ["111", "222", "333"] });
+    await expect(
+      catalogWrite.replaceSkuEans("profile-1", "sku-8", [" 111 ", "222", "111", "", " 222 ", "333 "])
+    ).resolves.toEqual(["111", "222", "333"]);
+    expect(deleteMock).toHaveBeenCalledWith("/api/catalog/pvt/stockkeepingunit/sku-8/ean");
+    expect(postMock).toHaveBeenNthCalledWith(
+      1,
+      "/api/catalog/pvt/stockkeepingunit/sku-8/ean/111"
+    );
+    expect(postMock).toHaveBeenNthCalledWith(
+      2,
+      "/api/catalog/pvt/stockkeepingunit/sku-8/ean/222"
+    );
+    expect(postMock).toHaveBeenNthCalledWith(
+      3,
+      "/api/catalog/pvt/stockkeepingunit/sku-8/ean/333"
+    );
+    expect(postMock).toHaveBeenCalledTimes(3);
+    expect(getMock).toHaveBeenCalledWith("/api/catalog/pvt/stockkeepingunit/sku-8/ean");
+    expect(deleteMock.mock.invocationCallOrder[0]).toBeLessThan(postMock.mock.invocationCallOrder[0]);
+    expect(postMock.mock.invocationCallOrder[2]).toBeLessThan(getMock.mock.invocationCallOrder[0]);
+  });
+});
+//# sourceMappingURL=vtex-catalog-write-eans.test.js.map

package/dist/src/services/vtex/__tests__/vtex-catalog-write-eans.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/services/vtex/__tests__/vtex-catalog-write-eans.test.ts"],
+  "sourcesContent": ["import { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nconst getMock = vi.fn();\nconst postMock = vi.fn();\nconst deleteMock = vi.fn();\n\nvi.mock(\"../vtex-api.js\", () => ({\n  getVtexApiClients: vi.fn(async () => ({\n    vtexApi: {\n      get: getMock,\n      post: postMock,\n      delete: deleteMock,\n    },\n  })),\n}));\n\nconst catalogWrite = await import(\"../vtex-catalog-write.js\");\n\ndescribe(\"VTEX catalog write EAN helpers\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n  });\n\n  it(\"normalizes array EAN responses into strings and drops empty values\", async () => {\n    getMock.mockResolvedValueOnce({ data: [789, \"\", \"EAN-1\"] });\n\n    await expect(catalogWrite.getSkuEans(\"profile-1\", \"sku-1\")).resolves.toEqual([\"789\", \"EAN-1\"]);\n\n    expect(getMock).toHaveBeenCalledWith(\"/api/catalog/pvt/stockkeepingunit/sku-1/ean\");\n  });\n\n  it(\"returns an empty array when VTEX returns null for SKU EANs\", async () => {\n    getMock.mockResolvedValueOnce({ data: null });\n\n    await expect(catalogWrite.getSkuEans(\"profile-1\", \"sku-2\")).resolves.toEqual([]);\n  });\n\n  it(\"wraps scalar VTEX EAN responses into an array\", async () => {\n    getMock.mockResolvedValueOnce({ data: 1234567890123 });\n\n    await expect(catalogWrite.getSkuEans(\"profile-1\", \"sku-3\")).resolves.toEqual([\n      \"1234567890123\",\n    ]);\n  });\n\n  it(\"posts createSkuEan to the SKU-specific EAN endpoint\", async () => {\n    postMock.mockResolvedValueOnce({});\n\n    await expect(catalogWrite.createSkuEan(\"profile-1\", \"sku-4\", \"7791234567890\")).resolves.toBeUndefined();\n\n    expect(postMock).toHaveBeenCalledWith(\n      \"/api/catalog/pvt/stockkeepingunit/sku-4/ean/7791234567890\"\n    );\n  });\n\n  it(\"deletes all EANs using the SKU EAN collection endpoint\", async () => {\n    deleteMock.mockResolvedValueOnce({});\n\n    await expect(catalogWrite.deleteAllSkuEans(\"profile-1\", \"sku-5\")).resolves.toBeUndefined();\n\n    expect(deleteMock).toHaveBeenCalledWith(\"/api/catalog/pvt/stockkeepingunit/sku-5/ean\");\n  });\n\n  it(\"returns current EANs without posting when addSkuEan receives only whitespace\", async () => {\n    getMock.mockResolvedValueOnce({ data: [\"7791234567890\"] });\n\n    await expect(catalogWrite.addSkuEan(\"profile-1\", \"sku-6\", \"   \")).resolves.toEqual([\n      \"7791234567890\",\n    ]);\n\n    expect(postMock).not.toHaveBeenCalled();\n    expect(getMock).toHaveBeenCalledTimes(1);\n  });\n\n  it(\"trims and posts new EANs before reloading the normalized SKU list\", async () => {\n    postMock.mockResolvedValueOnce({});\n    getMock.mockResolvedValueOnce({ data: [\"7791234567890\", \"7791234567891\"] });\n\n    await expect(catalogWrite.addSkuEan(\"profile-1\", \"sku-7\", \" 7791234567891 \")).resolves.toEqual([\n      \"7791234567890\",\n      \"7791234567891\",\n    ]);\n\n    expect(postMock).toHaveBeenCalledWith(\n      \"/api/catalog/pvt/stockkeepingunit/sku-7/ean/7791234567891\"\n    );\n    expect(getMock).toHaveBeenCalledWith(\"/api/catalog/pvt/stockkeepingunit/sku-7/ean\");\n  });\n\n  it(\"replaces SKU EANs by deleting first, then posting trimmed unique values in order\", async () => {\n    deleteMock.mockResolvedValueOnce({});\n    postMock.mockResolvedValue({});\n    getMock.mockResolvedValueOnce({ data: [\"111\", \"222\", \"333\"] });\n\n    await expect(\n      catalogWrite.replaceSkuEans(\"profile-1\", \"sku-8\", [\" 111 \", \"222\", \"111\", \"\", \" 222 \", \"333 \"])\n    ).resolves.toEqual([\"111\", \"222\", \"333\"]);\n\n    expect(deleteMock).toHaveBeenCalledWith(\"/api/catalog/pvt/stockkeepingunit/sku-8/ean\");\n    expect(postMock).toHaveBeenNthCalledWith(\n      1,\n      \"/api/catalog/pvt/stockkeepingunit/sku-8/ean/111\"\n    );\n    expect(postMock).toHaveBeenNthCalledWith(\n      2,\n      \"/api/catalog/pvt/stockkeepingunit/sku-8/ean/222\"\n    );\n    expect(postMock).toHaveBeenNthCalledWith(\n      3,\n      \"/api/catalog/pvt/stockkeepingunit/sku-8/ean/333\"\n    );\n    expect(postMock).toHaveBeenCalledTimes(3);\n    expect(getMock).toHaveBeenCalledWith(\"/api/catalog/pvt/stockkeepingunit/sku-8/ean\");\n    expect(deleteMock.mock.invocationCallOrder[0]).toBeLessThan(postMock.mock.invocationCallOrder[0]);\n    expect(postMock.mock.invocationCallOrder[2]).toBeLessThan(getMock.mock.invocationCallOrder[0]);\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/services/vtex/__tests__/vtex-catalog-write-products.test.js

@@ -0,0 +1,41 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const postMock = vi.fn();
+vi.mock("../vtex-api.js", () => ({
+  getVtexApiClients: vi.fn(async () => ({
+    vtexApi: {
+      post: postMock
+    }
+  }))
+}));
+const catalogWrite = await import("../vtex-catalog-write.js");
+describe("VTEX catalog write product and SKU HTTP contracts", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+  it("posts createProduct payloads to the VTEX product endpoint", async () => {
+    const payload = {
+      Name: "Running Shoe",
+      CategoryId: 12,
+      BrandId: 34,
+      RefId: "shoe-1"
+    };
+    const response = { Id: 501, Name: "Running Shoe" };
+    postMock.mockResolvedValueOnce({ data: response });
+    await expect(catalogWrite.createProduct("profile-1", payload)).resolves.toEqual(response);
+    expect(postMock).toHaveBeenCalledWith("/api/catalog/pvt/product", payload);
+  });
+  it("posts createSku payloads to the VTEX SKU endpoint", async () => {
+    const payload = {
+      ProductId: 501,
+      Name: "Running Shoe / Blue / 42",
+      RefId: "shoe-1-blue-42",
+      MeasurementUnit: "un",
+      UnitMultiplier: 1
+    };
+    const response = { Id: 801, ProductId: 501 };
+    postMock.mockResolvedValueOnce({ data: response });
+    await expect(catalogWrite.createSku("profile-1", payload)).resolves.toEqual(response);
+    expect(postMock).toHaveBeenCalledWith("/api/catalog/pvt/stockkeepingunit", payload);
+  });
+});
+//# sourceMappingURL=vtex-catalog-write-products.test.js.map

package/dist/src/services/vtex/__tests__/vtex-catalog-write-products.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/services/vtex/__tests__/vtex-catalog-write-products.test.ts"],
+  "sourcesContent": ["import { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nconst postMock = vi.fn();\n\nvi.mock(\"../vtex-api.js\", () => ({\n  getVtexApiClients: vi.fn(async () => ({\n    vtexApi: {\n      post: postMock,\n    },\n  })),\n}));\n\nconst catalogWrite = await import(\"../vtex-catalog-write.js\");\n\ndescribe(\"VTEX catalog write product and SKU HTTP contracts\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n  });\n\n  it(\"posts createProduct payloads to the VTEX product endpoint\", async () => {\n    const payload = {\n      Name: \"Running Shoe\",\n      CategoryId: 12,\n      BrandId: 34,\n      RefId: \"shoe-1\",\n    };\n    const response = { Id: 501, Name: \"Running Shoe\" };\n\n    postMock.mockResolvedValueOnce({ data: response });\n\n    await expect(catalogWrite.createProduct(\"profile-1\", payload)).resolves.toEqual(response);\n\n    expect(postMock).toHaveBeenCalledWith(\"/api/catalog/pvt/product\", payload);\n  });\n\n  it(\"posts createSku payloads to the VTEX SKU endpoint\", async () => {\n    const payload = {\n      ProductId: 501,\n      Name: \"Running Shoe / Blue / 42\",\n      RefId: \"shoe-1-blue-42\",\n      MeasurementUnit: \"un\",\n      UnitMultiplier: 1,\n    };\n    const response = { Id: 801, ProductId: 501 };\n\n    postMock.mockResolvedValueOnce({ data: response });\n\n    await expect(catalogWrite.createSku(\"profile-1\", payload)).resolves.toEqual(response);\n\n    expect(postMock).toHaveBeenCalledWith(\"/api/catalog/pvt/stockkeepingunit\", payload);\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,YAAY,UAAU,QAAQ,IAAI,UAAU;AAErD,MAAM,WAAW,GAAG,GAAG;AAEvB,GAAG,KAAK,kBAAkB,OAAO;AAAA,EAC/B,mBAAmB,GAAG,GAAG,aAAa;AAAA,IACpC,SAAS;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF,EAAE;AACJ,EAAE;AAEF,MAAM,eAAe,MAAM,OAAO,0BAA0B;AAE5D,SAAS,qDAAqD,MAAM;AAClE,aAAW,MAAM;AACf,OAAG,cAAc;AAAA,EACnB,CAAC;AAED,KAAG,6DAA6D,YAAY;AAC1E,UAAM,UAAU;AAAA,MACd,MAAM;AAAA,MACN,YAAY;AAAA,MACZ,SAAS;AAAA,MACT,OAAO;AAAA,IACT;AACA,UAAM,WAAW,EAAE,IAAI,KAAK,MAAM,eAAe;AAEjD,aAAS,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEjD,UAAM,OAAO,aAAa,cAAc,aAAa,OAAO,CAAC,EAAE,SAAS,QAAQ,QAAQ;AAExF,WAAO,QAAQ,EAAE,qBAAqB,4BAA4B,OAAO;AAAA,EAC3E,CAAC;AAED,KAAG,qDAAqD,YAAY;AAClE,UAAM,UAAU;AAAA,MACd,WAAW;AAAA,MACX,MAAM;AAAA,MACN,OAAO;AAAA,MACP,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,IAClB;AACA,UAAM,WAAW,EAAE,IAAI,KAAK,WAAW,IAAI;AAE3C,aAAS,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEjD,UAAM,OAAO,aAAa,UAAU,aAAa,OAAO,CAAC,EAAE,SAAS,QAAQ,QAAQ;AAEpF,WAAO,QAAQ,EAAE,qBAAqB,qCAAqC,OAAO;AAAA,EACpF,CAAC;AACH,CAAC;",
+  "names": []
+}

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

@@ -0,0 +1,80 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const getMock = vi.fn();
+vi.mock("../vtex-api.js", () => ({
+  getVtexApiClients: vi.fn(async () => ({
+    vtexApi: { get: getMock }
+  }))
+}));
+const catalog = await import("../vtex-catalog.js");
+describe("VTEX catalog read wrappers", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+  it("uses official category tree and category list endpoints", async () => {
+    getMock.mockResolvedValueOnce({ data: [{ id: 1 }] });
+    getMock.mockResolvedValueOnce({ data: [{ Id: 10 }, { Id: 11 }] });
+    const tree = await catalog.getCategoryTree("profile-1", 3);
+    const categories = await catalog.listCategories("profile-1", 2, 25);
+    expect(tree).toEqual([{ id: 1 }]);
+    expect(categories).toEqual({ items: [{ Id: 10 }, { Id: 11 }], total: 2 });
+    expect(getMock).toHaveBeenNthCalledWith(1, "/api/catalog_system/pub/category/tree/3");
+    expect(getMock).toHaveBeenNthCalledWith(2, "/api/catalog_system/pvt/category/list", {
+      params: { page: 2, pageSize: 25 }
+    });
+  });
+  it("uses official brand list and product id search endpoints", async () => {
+    getMock.mockResolvedValueOnce({ data: [{ Id: 7, Name: "Acme" }] });
+    getMock.mockResolvedValueOnce({ data: [{ Id: 90, Name: "General" }] });
+    getMock.mockResolvedValueOnce({ data: { data: [101, 102], range: { total: 30 } } });
+    getMock.mockResolvedValueOnce({
+      data: [
+        { productId: "200", productName: "Runner", brand: "Acme", categoryId: "42" }
+      ],
+      headers: { resources: "0-0/18" }
+    });
+    const brands = await catalog.listBrands("profile-1", 1, 10);
+    const specGroups = await catalog.listSpecificationGroupsByCategory(
+      "profile-1",
+      "42"
+    );
+    const products = await catalog.listProducts("profile-1", 1, 10, "runner");
+    const categoryProducts = await catalog.listProductsByCategory("profile-1", "42", 0, 24);
+    expect(brands).toEqual({ items: [{ Id: 7, Name: "Acme" }], total: 1 });
+    expect(specGroups).toEqual([{ Id: 90, Name: "General" }]);
+    expect(products).toEqual({ productIds: [101, 102], total: 30 });
+    expect(categoryProducts).toEqual({
+      items: [{ productId: "200", productName: "Runner", brand: "Acme", categoryId: "42" }],
+      total: 18
+    });
+    expect(getMock).toHaveBeenNthCalledWith(1, "/api/catalog_system/pvt/brand/list", {
+      params: { page: 1, pageSize: 10 }
+    });
+    expect(getMock).toHaveBeenNthCalledWith(
+      2,
+      "/api/catalog_system/pvt/specification/groupbycategory/42"
+    );
+    expect(getMock).toHaveBeenNthCalledWith(3, "/api/catalog_system/pvt/products/GetProductAndSkuIds", {
+      params: { _from: 1, _to: 10, keyword: "runner" }
+    });
+    expect(getMock).toHaveBeenNthCalledWith(4, "/api/catalog_system/pub/products/search", {
+      params: { category: "42", _from: 0, _to: 24 }
+    });
+  });
+  it("uses official SKU-by-product endpoint and normalizes non-array payloads", async () => {
+    getMock.mockResolvedValueOnce({ data: [{ Id: 501 }, { Id: 502 }] });
+    getMock.mockResolvedValueOnce({ data: null });
+    const skus = await catalog.listSkusByProduct("profile-1", "101");
+    const empty = await catalog.listSkusByProduct("profile-1", "102");
+    expect(skus).toEqual([{ Id: 501 }, { Id: 502 }]);
+    expect(empty).toEqual([]);
+    expect(getMock).toHaveBeenNthCalledWith(
+      1,
+      "/api/catalog_system/pvt/sku/stockkeepingunitByProductId/101"
+    );
+    expect(getMock).toHaveBeenNthCalledWith(
+      2,
+      "/api/catalog_system/pvt/sku/stockkeepingunitByProductId/102"
+    );
+  });
+});
+//# sourceMappingURL=vtex-catalog.test.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/services/vtex/__tests__/vtex-catalog.test.ts"],
+  "sourcesContent": ["import { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nconst getMock = vi.fn();\n\nvi.mock(\"../vtex-api.js\", () => ({\n  getVtexApiClients: vi.fn(async () => ({\n    vtexApi: { get: getMock },\n  })),\n}));\n\nconst catalog = await import(\"../vtex-catalog.js\");\n\ndescribe(\"VTEX catalog read wrappers\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n  });\n\n  it(\"uses official category tree and category list endpoints\", async () => {\n    getMock.mockResolvedValueOnce({ data: [{ id: 1 }] });\n    getMock.mockResolvedValueOnce({ data: [{ Id: 10 }, { Id: 11 }] });\n\n    const tree = await catalog.getCategoryTree(\"profile-1\", 3);\n    const categories = await catalog.listCategories(\"profile-1\", 2, 25);\n\n    expect(tree).toEqual([{ id: 1 }]);\n    expect(categories).toEqual({ items: [{ Id: 10 }, { Id: 11 }], total: 2 });\n    expect(getMock).toHaveBeenNthCalledWith(1, \"/api/catalog_system/pub/category/tree/3\");\n    expect(getMock).toHaveBeenNthCalledWith(2, \"/api/catalog_system/pvt/category/list\", {\n      params: { page: 2, pageSize: 25 },\n    });\n  });\n\n\tit(\"uses official brand list and product id search endpoints\", async () => {\n\t\tgetMock.mockResolvedValueOnce({ data: [{ Id: 7, Name: \"Acme\" }] });\n\t\tgetMock.mockResolvedValueOnce({ data: [{ Id: 90, Name: \"General\" }] });\n\t\tgetMock.mockResolvedValueOnce({ data: { data: [101, 102], range: { total: 30 } } });\n\t\tgetMock.mockResolvedValueOnce({\n\t\t\tdata: [\n\t\t\t\t{ productId: \"200\", productName: \"Runner\", brand: \"Acme\", categoryId: \"42\" },\n\t\t\t],\n\t\t\theaders: { resources: \"0-0/18\" },\n\t\t});\n\n\t\tconst brands = await catalog.listBrands(\"profile-1\", 1, 10);\n\t\tconst specGroups = await catalog.listSpecificationGroupsByCategory(\n\t\t\t\"profile-1\",\n\t\t\t\"42\",\n\t\t);\n\t\tconst products = await catalog.listProducts(\"profile-1\", 1, 10, \"runner\");\n\t\tconst categoryProducts = await catalog.listProductsByCategory(\"profile-1\", \"42\", 0, 24);\n\n\t\texpect(brands).toEqual({ items: [{ Id: 7, Name: \"Acme\" }], total: 1 });\n\t\texpect(specGroups).toEqual([{ Id: 90, Name: \"General\" }]);\n\t\texpect(products).toEqual({ productIds: [101, 102], total: 30 });\n\t\texpect(categoryProducts).toEqual({\n\t\t\titems: [{ productId: \"200\", productName: \"Runner\", brand: \"Acme\", categoryId: \"42\" }],\n\t\t\ttotal: 18,\n\t\t});\n\t\texpect(getMock).toHaveBeenNthCalledWith(1, \"/api/catalog_system/pvt/brand/list\", {\n\t\t\tparams: { page: 1, pageSize: 10 },\n\t\t});\n\t\texpect(getMock).toHaveBeenNthCalledWith(\n\t\t\t2,\n\t\t\t\"/api/catalog_system/pvt/specification/groupbycategory/42\",\n\t\t);\n\t\texpect(getMock).toHaveBeenNthCalledWith(3, \"/api/catalog_system/pvt/products/GetProductAndSkuIds\", {\n\t\t\tparams: { _from: 1, _to: 10, keyword: \"runner\" },\n\t\t});\n\t\texpect(getMock).toHaveBeenNthCalledWith(4, \"/api/catalog_system/pub/products/search\", {\n\t\t\tparams: { category: \"42\", _from: 0, _to: 24 },\n\t\t});\n\t});\n\n  it(\"uses official SKU-by-product endpoint and normalizes non-array payloads\", async () => {\n    getMock.mockResolvedValueOnce({ data: [{ Id: 501 }, { Id: 502 }] });\n    getMock.mockResolvedValueOnce({ data: null });\n\n    const skus = await catalog.listSkusByProduct(\"profile-1\", \"101\");\n    const empty = await catalog.listSkusByProduct(\"profile-1\", \"102\");\n\n    expect(skus).toEqual([{ Id: 501 }, { Id: 502 }]);\n    expect(empty).toEqual([]);\n    expect(getMock).toHaveBeenNthCalledWith(\n      1,\n      \"/api/catalog_system/pvt/sku/stockkeepingunitByProductId/101\"\n    );\n    expect(getMock).toHaveBeenNthCalledWith(\n      2,\n      \"/api/catalog_system/pvt/sku/stockkeepingunitByProductId/102\"\n    );\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/services/vtex/__tests__/vtex-orders-write-http.test.js

@@ -0,0 +1,85 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const postMock = vi.fn();
+const patchMock = vi.fn();
+const putMock = vi.fn();
+vi.mock("../vtex-api.js", () => ({
+  getVtexApiClients: vi.fn(async () => ({
+    vtexApi: {
+      post: postMock,
+      patch: patchMock,
+      put: putMock
+    }
+  }))
+}));
+const ordersWrite = await import("../vtex-orders-write.js");
+describe("VTEX order write HTTP contracts", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+  it("posts the cancel endpoint and sends the provided reason", async () => {
+    postMock.mockResolvedValueOnce({});
+    await expect(
+      ordersWrite.cancelOrder("profile-1", "order-1", "customer request")
+    ).resolves.toBeUndefined();
+    expect(postMock).toHaveBeenCalledWith("/api/oms/pvt/orders/order-1/cancel", {
+      reason: "customer request"
+    });
+  });
+  it("posts an empty payload when canceling without a reason", async () => {
+    postMock.mockResolvedValueOnce({});
+    await ordersWrite.cancelOrder("profile-1", "order-2");
+    expect(postMock).toHaveBeenCalledWith("/api/oms/pvt/orders/order-2/cancel", {});
+  });
+  it("posts invoice payloads to the OMS invoice endpoint", async () => {
+    postMock.mockResolvedValueOnce({});
+    const payload = {
+      type: "Output",
+      issuanceDate: "2026-06-06T10:00:00.000Z",
+      invoiceNumber: "INV-10",
+      invoiceValue: "12000",
+      items: [{ id: "sku-1", price: 12e3, quantity: 1, description: "Sneaker" }],
+      trackingNumber: "TRK-1"
+    };
+    await expect(ordersWrite.invoiceOrder("profile-1", "order-3", payload)).resolves.toBeUndefined();
+    expect(postMock).toHaveBeenCalledWith("/api/oms/pvt/orders/order-3/invoice", payload);
+  });
+  it("patches partial invoice tracking on the invoice-specific OMS endpoint", async () => {
+    patchMock.mockResolvedValueOnce({});
+    const payload = {
+      trackingNumber: "TRK-55",
+      trackingUrl: "https://carrier.test/TRK-55",
+      courier: "Andreani",
+      dispatchedDate: "2026-06-06T11:00:00.000Z"
+    };
+    await expect(
+      ordersWrite.updatePartialInvoiceTracking("profile-1", "order-4", "INV-55", payload)
+    ).resolves.toBeUndefined();
+    expect(patchMock).toHaveBeenCalledWith(
+      "/api/oms/pvt/orders/order-4/invoice/INV-55",
+      payload
+    );
+  });
+  it("puts full tracking status payloads on the OMS tracking endpoint", async () => {
+    putMock.mockResolvedValueOnce({});
+    const payload = {
+      isDelivered: false,
+      deliveredDate: null,
+      events: [
+        {
+          city: "Buenos Aires",
+          state: "AR-C",
+          description: "Package received by carrier",
+          date: "2026-06-06T12:00:00.000Z"
+        }
+      ]
+    };
+    await expect(
+      ordersWrite.updateOrderTrackingStatus("profile-1", "order-5", "INV-88", payload)
+    ).resolves.toBeUndefined();
+    expect(putMock).toHaveBeenCalledWith(
+      "/api/oms/pvt/orders/order-5/invoice/INV-88/tracking",
+      payload
+    );
+  });
+});
+//# sourceMappingURL=vtex-orders-write-http.test.js.map

package/dist/src/services/vtex/__tests__/vtex-orders-write-http.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/services/vtex/__tests__/vtex-orders-write-http.test.ts"],
+  "sourcesContent": ["import { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nconst postMock = vi.fn();\nconst patchMock = vi.fn();\nconst putMock = vi.fn();\n\nvi.mock(\"../vtex-api.js\", () => ({\n  getVtexApiClients: vi.fn(async () => ({\n    vtexApi: {\n      post: postMock,\n      patch: patchMock,\n      put: putMock,\n    },\n  })),\n}));\n\nconst ordersWrite = await import(\"../vtex-orders-write.js\");\n\ndescribe(\"VTEX order write HTTP contracts\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n  });\n\n  it(\"posts the cancel endpoint and sends the provided reason\", async () => {\n    postMock.mockResolvedValueOnce({});\n\n    await expect(\n      ordersWrite.cancelOrder(\"profile-1\", \"order-1\", \"customer request\")\n    ).resolves.toBeUndefined();\n\n    expect(postMock).toHaveBeenCalledWith(\"/api/oms/pvt/orders/order-1/cancel\", {\n      reason: \"customer request\",\n    });\n  });\n\n  it(\"posts an empty payload when canceling without a reason\", async () => {\n    postMock.mockResolvedValueOnce({});\n\n    await ordersWrite.cancelOrder(\"profile-1\", \"order-2\");\n\n    expect(postMock).toHaveBeenCalledWith(\"/api/oms/pvt/orders/order-2/cancel\", {});\n  });\n\n  it(\"posts invoice payloads to the OMS invoice endpoint\", async () => {\n    postMock.mockResolvedValueOnce({});\n\n    const payload = {\n      type: \"Output\" as const,\n      issuanceDate: \"2026-06-06T10:00:00.000Z\",\n      invoiceNumber: \"INV-10\",\n      invoiceValue: \"12000\",\n      items: [{ id: \"sku-1\", price: 12000, quantity: 1, description: \"Sneaker\" }],\n      trackingNumber: \"TRK-1\",\n    };\n\n    await expect(ordersWrite.invoiceOrder(\"profile-1\", \"order-3\", payload)).resolves.toBeUndefined();\n\n    expect(postMock).toHaveBeenCalledWith(\"/api/oms/pvt/orders/order-3/invoice\", payload);\n  });\n\n  it(\"patches partial invoice tracking on the invoice-specific OMS endpoint\", async () => {\n    patchMock.mockResolvedValueOnce({});\n\n    const payload = {\n      trackingNumber: \"TRK-55\",\n      trackingUrl: \"https://carrier.test/TRK-55\",\n      courier: \"Andreani\",\n      dispatchedDate: \"2026-06-06T11:00:00.000Z\",\n    };\n\n    await expect(\n      ordersWrite.updatePartialInvoiceTracking(\"profile-1\", \"order-4\", \"INV-55\", payload)\n    ).resolves.toBeUndefined();\n\n    expect(patchMock).toHaveBeenCalledWith(\n      \"/api/oms/pvt/orders/order-4/invoice/INV-55\",\n      payload\n    );\n  });\n\n  it(\"puts full tracking status payloads on the OMS tracking endpoint\", async () => {\n    putMock.mockResolvedValueOnce({});\n\n    const payload = {\n      isDelivered: false,\n      deliveredDate: null,\n      events: [\n        {\n          city: \"Buenos Aires\",\n          state: \"AR-C\",\n          description: \"Package received by carrier\",\n          date: \"2026-06-06T12:00:00.000Z\",\n        },\n      ],\n    };\n\n    await expect(\n      ordersWrite.updateOrderTrackingStatus(\"profile-1\", \"order-5\", \"INV-88\", payload)\n    ).resolves.toBeUndefined();\n\n    expect(putMock).toHaveBeenCalledWith(\n      \"/api/oms/pvt/orders/order-5/invoice/INV-88/tracking\",\n      payload\n    );\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,YAAY,UAAU,QAAQ,IAAI,UAAU;AAErD,MAAM,WAAW,GAAG,GAAG;AACvB,MAAM,YAAY,GAAG,GAAG;AACxB,MAAM,UAAU,GAAG,GAAG;AAEtB,GAAG,KAAK,kBAAkB,OAAO;AAAA,EAC/B,mBAAmB,GAAG,GAAG,aAAa;AAAA,IACpC,SAAS;AAAA,MACP,MAAM;AAAA,MACN,OAAO;AAAA,MACP,KAAK;AAAA,IACP;AAAA,EACF,EAAE;AACJ,EAAE;AAEF,MAAM,cAAc,MAAM,OAAO,yBAAyB;AAE1D,SAAS,mCAAmC,MAAM;AAChD,aAAW,MAAM;AACf,OAAG,cAAc;AAAA,EACnB,CAAC;AAED,KAAG,2DAA2D,YAAY;AACxE,aAAS,sBAAsB,CAAC,CAAC;AAEjC,UAAM;AAAA,MACJ,YAAY,YAAY,aAAa,WAAW,kBAAkB;AAAA,IACpE,EAAE,SAAS,cAAc;AAEzB,WAAO,QAAQ,EAAE,qBAAqB,sCAAsC;AAAA,MAC1E,QAAQ;AAAA,IACV,CAAC;AAAA,EACH,CAAC;AAED,KAAG,0DAA0D,YAAY;AACvE,aAAS,sBAAsB,CAAC,CAAC;AAEjC,UAAM,YAAY,YAAY,aAAa,SAAS;AAEpD,WAAO,QAAQ,EAAE,qBAAqB,sCAAsC,CAAC,CAAC;AAAA,EAChF,CAAC;AAED,KAAG,sDAAsD,YAAY;AACnE,aAAS,sBAAsB,CAAC,CAAC;AAEjC,UAAM,UAAU;AAAA,MACd,MAAM;AAAA,MACN,cAAc;AAAA,MACd,eAAe;AAAA,MACf,cAAc;AAAA,MACd,OAAO,CAAC,EAAE,IAAI,SAAS,OAAO,MAAO,UAAU,GAAG,aAAa,UAAU,CAAC;AAAA,MAC1E,gBAAgB;AAAA,IAClB;AAEA,UAAM,OAAO,YAAY,aAAa,aAAa,WAAW,OAAO,CAAC,EAAE,SAAS,cAAc;AAE/F,WAAO,QAAQ,EAAE,qBAAqB,uCAAuC,OAAO;AAAA,EACtF,CAAC;AAED,KAAG,yEAAyE,YAAY;AACtF,cAAU,sBAAsB,CAAC,CAAC;AAElC,UAAM,UAAU;AAAA,MACd,gBAAgB;AAAA,MAChB,aAAa;AAAA,MACb,SAAS;AAAA,MACT,gBAAgB;AAAA,IAClB;AAEA,UAAM;AAAA,MACJ,YAAY,6BAA6B,aAAa,WAAW,UAAU,OAAO;AAAA,IACpF,EAAE,SAAS,cAAc;AAEzB,WAAO,SAAS,EAAE;AAAA,MAChB;AAAA,MACA;AAAA,IACF;AAAA,EACF,CAAC;AAED,KAAG,mEAAmE,YAAY;AAChF,YAAQ,sBAAsB,CAAC,CAAC;AAEhC,UAAM,UAAU;AAAA,MACd,aAAa;AAAA,MACb,eAAe;AAAA,MACf,QAAQ;AAAA,QACN;AAAA,UACE,MAAM;AAAA,UACN,OAAO;AAAA,UACP,aAAa;AAAA,UACb,MAAM;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,UAAM;AAAA,MACJ,YAAY,0BAA0B,aAAa,WAAW,UAAU,OAAO;AAAA,IACjF,EAAE,SAAS,cAAc;AAEzB,WAAO,OAAO,EAAE;AAAA,MACd;AAAA,MACA;AAAA,IACF;AAAA,EACF,CAAC;AACH,CAAC;",
+  "names": []
+}