@yoryoboy/bi-mcp 1.13.0 → 1.14.2

package/dist/src/services/vtex/vtex-payments-write.js

@@ -0,0 +1,64 @@
+import { getVtexApiClients } from "./vtex-api.js";
+function normalizeCommercialConditionId(value) {
+  return String(value);
+}
+function normalizePayload(payload) {
+  if (payload.commercialConditionId === void 0) {
+    return payload;
+  }
+  return {
+    ...payload,
+    commercialConditionId: normalizeCommercialConditionId(payload.commercialConditionId)
+  };
+}
+async function createCommercialCondition(profileId, payload) {
+  const { vtexApi } = await getVtexApiClients(profileId);
+  const response = await vtexApi.post(
+    "/api/payments/pvt/commercial-condition",
+    payload
+  );
+  return response.data;
+}
+async function updateCommercialCondition(profileId, commercialConditionId, payload) {
+  const { vtexApi } = await getVtexApiClients(profileId);
+  const response = await vtexApi.put(
+    `/api/payments/pvt/commercial-condition/${normalizeCommercialConditionId(commercialConditionId)}`,
+    payload
+  );
+  return response.data;
+}
+async function deleteCommercialCondition(profileId, commercialConditionId) {
+  const { vtexApi } = await getVtexApiClients(profileId);
+  await vtexApi.delete(
+    `/api/payments/pvt/commercial-condition/${normalizeCommercialConditionId(commercialConditionId)}`
+  );
+}
+async function createPaymentRule(profileId, payload) {
+  const { vtexApi } = await getVtexApiClients(profileId);
+  const response = await vtexApi.post(
+    "/api/pvt/rules",
+    normalizePayload(payload)
+  );
+  return response.data;
+}
+async function updatePaymentRule(profileId, ruleId, payload) {
+  const { vtexApi } = await getVtexApiClients(profileId);
+  const response = await vtexApi.put(
+    `/api/pvt/rules/${ruleId}`,
+    normalizePayload(payload)
+  );
+  return response.data;
+}
+async function deletePaymentRule(profileId, ruleId) {
+  const { vtexApi } = await getVtexApiClients(profileId);
+  await vtexApi.delete(`/api/pvt/rules/${ruleId}`);
+}
+export {
+  createCommercialCondition,
+  createPaymentRule,
+  deleteCommercialCondition,
+  deletePaymentRule,
+  updateCommercialCondition,
+  updatePaymentRule
+};
+//# sourceMappingURL=vtex-payments-write.js.map

package/dist/src/services/vtex/vtex-payments-write.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/services/vtex/vtex-payments-write.ts"],
+  "sourcesContent": ["import { getVtexApiClients } from \"./vtex-api.js\";\n\nexport type VtexPaymentWriteRecord = Record<string, unknown>;\n\nexport interface VtexPaymentRuleWritePayload extends VtexPaymentWriteRecord {\n  commercialConditionId?: number;\n}\n\nfunction normalizeCommercialConditionId(value: number): string {\n  return String(value);\n}\n\nfunction normalizePayload(payload: VtexPaymentRuleWritePayload): VtexPaymentWriteRecord {\n  if (payload.commercialConditionId === undefined) {\n    return payload;\n  }\n\n  return {\n    ...payload,\n    commercialConditionId: normalizeCommercialConditionId(payload.commercialConditionId),\n  };\n}\n\nexport async function createCommercialCondition(\n  profileId: string,\n  payload: VtexPaymentWriteRecord\n): Promise<VtexPaymentWriteRecord> {\n  const { vtexApi } = await getVtexApiClients(profileId);\n  const response = await vtexApi.post<VtexPaymentWriteRecord>(\n    \"/api/payments/pvt/commercial-condition\",\n    payload\n  );\n\n  return response.data;\n}\n\nexport async function updateCommercialCondition(\n  profileId: string,\n  commercialConditionId: number,\n  payload: VtexPaymentWriteRecord\n): Promise<VtexPaymentWriteRecord> {\n  const { vtexApi } = await getVtexApiClients(profileId);\n  const response = await vtexApi.put<VtexPaymentWriteRecord>(\n    `/api/payments/pvt/commercial-condition/${normalizeCommercialConditionId(commercialConditionId)}`,\n    payload\n  );\n\n  return response.data;\n}\n\nexport async function deleteCommercialCondition(\n  profileId: string,\n  commercialConditionId: number\n): Promise<void> {\n  const { vtexApi } = await getVtexApiClients(profileId);\n  await vtexApi.delete(\n    `/api/payments/pvt/commercial-condition/${normalizeCommercialConditionId(commercialConditionId)}`\n  );\n}\n\nexport async function createPaymentRule(\n  profileId: string,\n  payload: VtexPaymentRuleWritePayload\n): Promise<VtexPaymentWriteRecord> {\n  const { vtexApi } = await getVtexApiClients(profileId);\n  const response = await vtexApi.post<VtexPaymentWriteRecord>(\n    \"/api/pvt/rules\",\n    normalizePayload(payload)\n  );\n\n  return response.data;\n}\n\nexport async function updatePaymentRule(\n  profileId: string,\n  ruleId: number,\n  payload: VtexPaymentRuleWritePayload\n): Promise<VtexPaymentWriteRecord> {\n  const { vtexApi } = await getVtexApiClients(profileId);\n  const response = await vtexApi.put<VtexPaymentWriteRecord>(\n    `/api/pvt/rules/${ruleId}`,\n    normalizePayload(payload)\n  );\n\n  return response.data;\n}\n\nexport async function deletePaymentRule(profileId: string, ruleId: number): Promise<void> {\n  const { vtexApi } = await getVtexApiClients(profileId);\n  await vtexApi.delete(`/api/pvt/rules/${ruleId}`);\n}\n"],
+  "mappings": "AAAA,SAAS,yBAAyB;AAQlC,SAAS,+BAA+B,OAAuB;AAC7D,SAAO,OAAO,KAAK;AACrB;AAEA,SAAS,iBAAiB,SAA8D;AACtF,MAAI,QAAQ,0BAA0B,QAAW;AAC/C,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,uBAAuB,+BAA+B,QAAQ,qBAAqB;AAAA,EACrF;AACF;AAEA,eAAsB,0BACpB,WACA,SACiC;AACjC,QAAM,EAAE,QAAQ,IAAI,MAAM,kBAAkB,SAAS;AACrD,QAAM,WAAW,MAAM,QAAQ;AAAA,IAC7B;AAAA,IACA;AAAA,EACF;AAEA,SAAO,SAAS;AAClB;AAEA,eAAsB,0BACpB,WACA,uBACA,SACiC;AACjC,QAAM,EAAE,QAAQ,IAAI,MAAM,kBAAkB,SAAS;AACrD,QAAM,WAAW,MAAM,QAAQ;AAAA,IAC7B,0CAA0C,+BAA+B,qBAAqB,CAAC;AAAA,IAC/F;AAAA,EACF;AAEA,SAAO,SAAS;AAClB;AAEA,eAAsB,0BACpB,WACA,uBACe;AACf,QAAM,EAAE,QAAQ,IAAI,MAAM,kBAAkB,SAAS;AACrD,QAAM,QAAQ;AAAA,IACZ,0CAA0C,+BAA+B,qBAAqB,CAAC;AAAA,EACjG;AACF;AAEA,eAAsB,kBACpB,WACA,SACiC;AACjC,QAAM,EAAE,QAAQ,IAAI,MAAM,kBAAkB,SAAS;AACrD,QAAM,WAAW,MAAM,QAAQ;AAAA,IAC7B;AAAA,IACA,iBAAiB,OAAO;AAAA,EAC1B;AAEA,SAAO,SAAS;AAClB;AAEA,eAAsB,kBACpB,WACA,QACA,SACiC;AACjC,QAAM,EAAE,QAAQ,IAAI,MAAM,kBAAkB,SAAS;AACrD,QAAM,WAAW,MAAM,QAAQ;AAAA,IAC7B,kBAAkB,MAAM;AAAA,IACxB,iBAAiB,OAAO;AAAA,EAC1B;AAEA,SAAO,SAAS;AAClB;AAEA,eAAsB,kBAAkB,WAAmB,QAA+B;AACxF,QAAM,EAAE,QAAQ,IAAI,MAAM,kBAAkB,SAAS;AACrD,QAAM,QAAQ,OAAO,kBAAkB,MAAM,EAAE;AACjD;",
+  "names": []
+}

package/dist/src/services/vtex/vtex-payments.js

@@ -0,0 +1,49 @@
+import { getVtexApiClients } from "./vtex-api.js";
+function toRecordArray(data) {
+  if (!Array.isArray(data)) {
+    return [];
+  }
+  return data.filter((item) => item !== null && typeof item === "object");
+}
+function normalizeCommercialConditionId(value) {
+  return String(value);
+}
+function matchesCommercialConditionSearch(record, search) {
+  if (!search) {
+    return true;
+  }
+  const normalizedSearch = search.trim().toLowerCase();
+  const name = [record.name, record.Name].find((value) => typeof value === "string");
+  return typeof name === "string" && name.toLowerCase().includes(normalizedSearch);
+}
+async function listCommercialConditions(profileId, search) {
+  const { vtexApi } = await getVtexApiClients(profileId);
+  const response = await vtexApi.get("/api/catalog_system/pvt/commercialcondition/list");
+  return toRecordArray(response.data).filter((record) => matchesCommercialConditionSearch(record, search));
+}
+async function getCommercialCondition(profileId, commercialConditionId) {
+  const { vtexApi } = await getVtexApiClients(profileId);
+  const response = await vtexApi.get(
+    `/api/catalog_system/pvt/commercialcondition/${normalizeCommercialConditionId(commercialConditionId)}`
+  );
+  return response.data;
+}
+async function listPaymentRules(profileId, filters) {
+  const { vtexApi } = await getVtexApiClients(profileId);
+  const response = await vtexApi.get("/api/pvt/rules", {
+    params: filters?.commercialConditionId === void 0 ? void 0 : { commercialConditionId: normalizeCommercialConditionId(filters.commercialConditionId) }
+  });
+  return toRecordArray(response.data);
+}
+async function getPaymentRule(profileId, ruleId) {
+  const { vtexApi } = await getVtexApiClients(profileId);
+  const response = await vtexApi.get(`/api/pvt/rules/${ruleId}`);
+  return response.data;
+}
+export {
+  getCommercialCondition,
+  getPaymentRule,
+  listCommercialConditions,
+  listPaymentRules
+};
+//# sourceMappingURL=vtex-payments.js.map

package/dist/src/services/vtex/vtex-payments.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/services/vtex/vtex-payments.ts"],
+  "sourcesContent": ["import { getVtexApiClients } from \"./vtex-api.js\";\n\nexport type VtexPaymentRecord = Record<string, unknown>;\n\nfunction toRecordArray(data: unknown): VtexPaymentRecord[] {\n  if (!Array.isArray(data)) {\n    return [];\n  }\n\n  return data.filter((item): item is VtexPaymentRecord => item !== null && typeof item === \"object\");\n}\n\nfunction normalizeCommercialConditionId(value: number): string {\n  return String(value);\n}\n\nfunction matchesCommercialConditionSearch(record: VtexPaymentRecord, search?: string): boolean {\n  if (!search) {\n    return true;\n  }\n\n  const normalizedSearch = search.trim().toLowerCase();\n  const name = [record.name, record.Name].find((value): value is string => typeof value === \"string\");\n\n  return typeof name === \"string\" && name.toLowerCase().includes(normalizedSearch);\n}\n\nexport async function listCommercialConditions(\n  profileId: string,\n  search?: string\n): Promise<VtexPaymentRecord[]> {\n  const { vtexApi } = await getVtexApiClients(profileId);\n  const response = await vtexApi.get<unknown>(\"/api/catalog_system/pvt/commercialcondition/list\");\n\n  return toRecordArray(response.data).filter((record) => matchesCommercialConditionSearch(record, search));\n}\n\nexport async function getCommercialCondition(\n  profileId: string,\n  commercialConditionId: number\n): Promise<VtexPaymentRecord> {\n  const { vtexApi } = await getVtexApiClients(profileId);\n  const response = await vtexApi.get<VtexPaymentRecord>(\n    `/api/catalog_system/pvt/commercialcondition/${normalizeCommercialConditionId(commercialConditionId)}`\n  );\n\n  return response.data;\n}\n\nexport async function listPaymentRules(\n  profileId: string,\n  filters?: { commercialConditionId?: number }\n): Promise<VtexPaymentRecord[]> {\n  const { vtexApi } = await getVtexApiClients(profileId);\n  const response = await vtexApi.get<unknown>(\"/api/pvt/rules\", {\n    params:\n      filters?.commercialConditionId === undefined\n        ? undefined\n        : { commercialConditionId: normalizeCommercialConditionId(filters.commercialConditionId) },\n  });\n\n  return toRecordArray(response.data);\n}\n\nexport async function getPaymentRule(profileId: string, ruleId: number): Promise<VtexPaymentRecord> {\n  const { vtexApi } = await getVtexApiClients(profileId);\n  const response = await vtexApi.get<VtexPaymentRecord>(`/api/pvt/rules/${ruleId}`);\n\n  return response.data;\n}\n"],
+  "mappings": "AAAA,SAAS,yBAAyB;AAIlC,SAAS,cAAc,MAAoC;AACzD,MAAI,CAAC,MAAM,QAAQ,IAAI,GAAG;AACxB,WAAO,CAAC;AAAA,EACV;AAEA,SAAO,KAAK,OAAO,CAAC,SAAoC,SAAS,QAAQ,OAAO,SAAS,QAAQ;AACnG;AAEA,SAAS,+BAA+B,OAAuB;AAC7D,SAAO,OAAO,KAAK;AACrB;AAEA,SAAS,iCAAiC,QAA2B,QAA0B;AAC7F,MAAI,CAAC,QAAQ;AACX,WAAO;AAAA,EACT;AAEA,QAAM,mBAAmB,OAAO,KAAK,EAAE,YAAY;AACnD,QAAM,OAAO,CAAC,OAAO,MAAM,OAAO,IAAI,EAAE,KAAK,CAAC,UAA2B,OAAO,UAAU,QAAQ;AAElG,SAAO,OAAO,SAAS,YAAY,KAAK,YAAY,EAAE,SAAS,gBAAgB;AACjF;AAEA,eAAsB,yBACpB,WACA,QAC8B;AAC9B,QAAM,EAAE,QAAQ,IAAI,MAAM,kBAAkB,SAAS;AACrD,QAAM,WAAW,MAAM,QAAQ,IAAa,kDAAkD;AAE9F,SAAO,cAAc,SAAS,IAAI,EAAE,OAAO,CAAC,WAAW,iCAAiC,QAAQ,MAAM,CAAC;AACzG;AAEA,eAAsB,uBACpB,WACA,uBAC4B;AAC5B,QAAM,EAAE,QAAQ,IAAI,MAAM,kBAAkB,SAAS;AACrD,QAAM,WAAW,MAAM,QAAQ;AAAA,IAC7B,+CAA+C,+BAA+B,qBAAqB,CAAC;AAAA,EACtG;AAEA,SAAO,SAAS;AAClB;AAEA,eAAsB,iBACpB,WACA,SAC8B;AAC9B,QAAM,EAAE,QAAQ,IAAI,MAAM,kBAAkB,SAAS;AACrD,QAAM,WAAW,MAAM,QAAQ,IAAa,kBAAkB;AAAA,IAC5D,QACE,SAAS,0BAA0B,SAC/B,SACA,EAAE,uBAAuB,+BAA+B,QAAQ,qBAAqB,EAAE;AAAA,EAC/F,CAAC;AAED,SAAO,cAAc,SAAS,IAAI;AACpC;AAEA,eAAsB,eAAe,WAAmB,QAA4C;AAClG,QAAM,EAAE,QAAQ,IAAI,MAAM,kBAAkB,SAAS;AACrD,QAAM,WAAW,MAAM,QAAQ,IAAuB,kBAAkB,MAAM,EAAE;AAEhF,SAAO,SAAS;AAClB;",
+  "names": []
+}

package/dist/src/tools/vtex/__tests__/commercial-condition-references.test.js

@@ -0,0 +1,14 @@
+import { describe, expect, it } from "vitest";
+const createSkuModule = await import("../create-sku.js");
+const updateSkuModule = await import("../catalog-admin-products-skus.js");
+describe("commercial condition field references", () => {
+  it("points SKU commercialConditionId fields to the action-based management tools", () => {
+    const createDescription = createSkuModule.createSkuSchema.shape.commercialConditionId.description;
+    const updateDescription = updateSkuModule.updateSkuBasicFieldsSchema.shape.commercialConditionId.description;
+    expect(createDescription).toContain("vtex_commercial_conditions");
+    expect(createDescription).toContain("vtex_payment_rules");
+    expect(updateDescription).toContain("vtex_commercial_conditions");
+    expect(updateDescription).toContain("vtex_payment_rules");
+  });
+});
+//# sourceMappingURL=commercial-condition-references.test.js.map

package/dist/src/tools/vtex/__tests__/commercial-condition-references.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/tools/vtex/__tests__/commercial-condition-references.test.ts"],
+  "sourcesContent": ["import { describe, expect, it } from \"vitest\";\n\nconst createSkuModule = await import(\"../create-sku.js\");\nconst updateSkuModule = await import(\"../catalog-admin-products-skus.js\");\n\ndescribe(\"commercial condition field references\", () => {\n  it(\"points SKU commercialConditionId fields to the action-based management tools\", () => {\n    const createDescription = createSkuModule.createSkuSchema.shape.commercialConditionId.description;\n    const updateDescription = updateSkuModule.updateSkuBasicFieldsSchema.shape.commercialConditionId.description;\n\n    expect(createDescription).toContain(\"vtex_commercial_conditions\");\n    expect(createDescription).toContain(\"vtex_payment_rules\");\n    expect(updateDescription).toContain(\"vtex_commercial_conditions\");\n    expect(updateDescription).toContain(\"vtex_payment_rules\");\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,UAAU,QAAQ,UAAU;AAErC,MAAM,kBAAkB,MAAM,OAAO,kBAAkB;AACvD,MAAM,kBAAkB,MAAM,OAAO,mCAAmC;AAExE,SAAS,yCAAyC,MAAM;AACtD,KAAG,gFAAgF,MAAM;AACvF,UAAM,oBAAoB,gBAAgB,gBAAgB,MAAM,sBAAsB;AACtF,UAAM,oBAAoB,gBAAgB,2BAA2B,MAAM,sBAAsB;AAEjG,WAAO,iBAAiB,EAAE,UAAU,4BAA4B;AAChE,WAAO,iBAAiB,EAAE,UAAU,oBAAoB;AACxD,WAAO,iBAAiB,EAAE,UAAU,4BAA4B;AAChE,WAAO,iBAAiB,EAAE,UAAU,oBAAoB;AAAA,EAC1D,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/src/tools/vtex/__tests__/commercial-conditions.test.js

@@ -0,0 +1,107 @@
+import { z } from "zod";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const objectMock = vi.fn((value) => ({ kind: "object", value }));
+const errorMock = vi.fn((message) => ({ kind: "error", message }));
+const listCommercialConditionsMock = vi.fn();
+const getCommercialConditionMock = vi.fn();
+vi.mock("mcp-use/server", () => ({
+  object: objectMock,
+  error: errorMock
+}));
+vi.mock("../../../services/vtex/vtex-payments.js", () => ({
+  listCommercialConditions: listCommercialConditionsMock,
+  getCommercialCondition: getCommercialConditionMock
+}));
+vi.mock("../write-helpers.js", () => ({
+  vtexProfileIdSchemaField: z.string().trim().min(1).optional().describe("profile")
+}));
+const module = await import("../commercial-conditions.js");
+describe("vtex_commercial_conditions tool", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+  it("requires profileId and validates numeric commercialConditionId across actions", () => {
+    expect(() => module.commercialConditionsSchema.parse({ action: "list" })).toThrow();
+    expect(
+      () => module.commercialConditionsSchema.parse({
+        action: "get",
+        profileId: "profile-1",
+        commercialConditionId: 1.5
+      })
+    ).toThrow();
+    expect(
+      module.commercialConditionsSchema.parse({
+        action: "list",
+        profileId: "profile-1",
+        search: "9 cuotas"
+      })
+    ).toEqual({
+      action: "list",
+      profileId: "profile-1",
+      search: "9 cuotas"
+    });
+    expect(
+      module.commercialConditionsSchema.parse({
+        action: "get",
+        profileId: "profile-1",
+        commercialConditionId: 10
+      })
+    ).toEqual({
+      action: "get",
+      profileId: "profile-1",
+      commercialConditionId: 10
+    });
+    expect(
+      () => module.commercialConditionsSchema.parse({
+        action: "create",
+        profileId: "profile-1",
+        name: "9 cuotas"
+      })
+    ).toThrow();
+  });
+  it("returns compact list responses for commercial conditions", async () => {
+    listCommercialConditionsMock.mockResolvedValue([
+      { id: 10, name: "9 cuotas", isActive: true },
+      { id: 11, name: "12 cuotas", IsActive: false }
+    ]);
+    const result = await module.commercialConditionsHandler({
+      action: "list",
+      profileId: "profile-1",
+      search: "cuotas"
+    });
+    expect(listCommercialConditionsMock).toHaveBeenCalledWith("profile-1", "cuotas");
+    expect(result).toEqual({
+      kind: "object",
+      value: {
+        metadata: {
+          total: 2,
+          profile_id: "profile-1",
+          search: "cuotas"
+        },
+        conditions_schema: ["id", "name", "is_active"],
+        conditions: [
+          [10, "9 cuotas", true],
+          [11, "12 cuotas", false]
+        ]
+      }
+    });
+  });
+  it("gets commercial conditions through the service layer", async () => {
+    getCommercialConditionMock.mockResolvedValueOnce({ id: 10, name: "9 cuotas", isActive: true });
+    const fetched = await module.commercialConditionsHandler({
+      action: "get",
+      profileId: "profile-1",
+      commercialConditionId: 10
+    });
+    expect(getCommercialConditionMock).toHaveBeenCalledWith("profile-1", 10);
+    expect(fetched).toEqual({
+      kind: "object",
+      value: {
+        profile_id: "profile-1",
+        commercial_condition_id: 10,
+        condition: { id: 10, name: "9 cuotas", is_active: true }
+      }
+    });
+  });
+});
+//# sourceMappingURL=commercial-conditions.test.js.map

package/dist/src/tools/vtex/__tests__/commercial-conditions.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/tools/vtex/__tests__/commercial-conditions.test.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\nimport { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nconst objectMock = vi.fn((value) => ({ kind: \"object\", value }));\nconst errorMock = vi.fn((message) => ({ kind: \"error\", message }));\nconst listCommercialConditionsMock = vi.fn();\nconst getCommercialConditionMock = vi.fn();\n\nvi.mock(\"mcp-use/server\", () => ({\n  object: objectMock,\n  error: errorMock,\n}));\n\nvi.mock(\"../../../services/vtex/vtex-payments.js\", () => ({\n  listCommercialConditions: listCommercialConditionsMock,\n  getCommercialCondition: getCommercialConditionMock,\n}));\n\nvi.mock(\"../write-helpers.js\", () => ({\n  vtexProfileIdSchemaField: z.string().trim().min(1).optional().describe(\"profile\"),\n}));\n\nconst module = await import(\"../commercial-conditions.js\");\n\ndescribe(\"vtex_commercial_conditions tool\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n  });\n\n  it(\"requires profileId and validates numeric commercialConditionId across actions\", () => {\n    expect(() => module.commercialConditionsSchema.parse({ action: \"list\" })).toThrow();\n    expect(() =>\n      module.commercialConditionsSchema.parse({\n        action: \"get\",\n        profileId: \"profile-1\",\n        commercialConditionId: 1.5,\n      })\n    ).toThrow();\n\n    expect(\n      module.commercialConditionsSchema.parse({\n        action: \"list\",\n        profileId: \"profile-1\",\n        search: \"9 cuotas\",\n      })\n    ).toEqual({\n      action: \"list\",\n      profileId: \"profile-1\",\n      search: \"9 cuotas\",\n    });\n\n    expect(\n      module.commercialConditionsSchema.parse({\n        action: \"get\",\n        profileId: \"profile-1\",\n        commercialConditionId: 10,\n      })\n    ).toEqual({\n      action: \"get\",\n      profileId: \"profile-1\",\n      commercialConditionId: 10,\n    });\n\n    expect(() =>\n      module.commercialConditionsSchema.parse({\n        action: \"create\",\n        profileId: \"profile-1\",\n        name: \"9 cuotas\",\n      })\n    ).toThrow();\n  });\n\n  it(\"returns compact list responses for commercial conditions\", async () => {\n    listCommercialConditionsMock.mockResolvedValue([\n      { id: 10, name: \"9 cuotas\", isActive: true },\n      { id: 11, name: \"12 cuotas\", IsActive: false },\n    ]);\n\n    const result = await module.commercialConditionsHandler({\n      action: \"list\",\n      profileId: \"profile-1\",\n      search: \"cuotas\",\n    });\n\n    expect(listCommercialConditionsMock).toHaveBeenCalledWith(\"profile-1\", \"cuotas\");\n    expect(result).toEqual({\n      kind: \"object\",\n      value: {\n        metadata: {\n          total: 2,\n          profile_id: \"profile-1\",\n          search: \"cuotas\",\n        },\n        conditions_schema: [\"id\", \"name\", \"is_active\"],\n        conditions: [\n          [10, \"9 cuotas\", true],\n          [11, \"12 cuotas\", false],\n        ],\n      },\n    });\n  });\n\n  it(\"gets commercial conditions through the service layer\", async () => {\n    getCommercialConditionMock.mockResolvedValueOnce({ id: 10, name: \"9 cuotas\", isActive: true });\n\n    const fetched = await module.commercialConditionsHandler({\n      action: \"get\",\n      profileId: \"profile-1\",\n      commercialConditionId: 10,\n    });\n\n    expect(getCommercialConditionMock).toHaveBeenCalledWith(\"profile-1\", 10);\n    expect(fetched).toEqual({\n      kind: \"object\",\n      value: {\n        profile_id: \"profile-1\",\n        commercial_condition_id: 10,\n        condition: { id: 10, name: \"9 cuotas\", is_active: true },\n      },\n    });\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/vtex/__tests__/payment-rules.test.js

@@ -0,0 +1,254 @@
+import { z } from "zod";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const objectMock = vi.fn((value) => ({ kind: "object", value }));
+const errorMock = vi.fn((message) => ({ kind: "error", message }));
+const listPaymentRulesMock = vi.fn();
+const getPaymentRuleMock = vi.fn();
+const createPaymentRuleMock = vi.fn();
+const updatePaymentRuleMock = vi.fn();
+const deletePaymentRuleMock = vi.fn();
+const resolveVtexWriteProfileMock = vi.fn();
+const buildWriteSuccessResponseMock = vi.fn((value) => ({ kind: "write", value }));
+const handleVtexWriteErrorMock = vi.fn((_err, fallback) => ({ kind: "error", message: fallback }));
+const requireExplicitConfirmationMock = vi.fn();
+vi.mock("mcp-use/server", () => ({
+  object: objectMock,
+  error: errorMock
+}));
+vi.mock("../../../services/vtex/vtex-payments.js", () => ({
+  listPaymentRules: listPaymentRulesMock,
+  getPaymentRule: getPaymentRuleMock
+}));
+vi.mock("../../../services/vtex/vtex-payments-write.js", () => ({
+  createPaymentRule: createPaymentRuleMock,
+  updatePaymentRule: updatePaymentRuleMock,
+  deletePaymentRule: deletePaymentRuleMock
+}));
+vi.mock("../write-helpers.js", () => ({
+  vtexProfileIdSchemaField: z.string().trim().min(1).optional().describe("profile"),
+  confirmationSchemaField: z.boolean().optional().describe("confirmed"),
+  resolveVtexWriteProfile: resolveVtexWriteProfileMock,
+  buildWriteSuccessResponse: buildWriteSuccessResponseMock,
+  handleVtexWriteError: handleVtexWriteErrorMock,
+  requireExplicitConfirmation: requireExplicitConfirmationMock
+}));
+const module = await import("../payment-rules.js");
+describe("vtex_payment_rules tool", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    resolveVtexWriteProfileMock.mockResolvedValue({
+      ok: true,
+      value: { profileId: "profile-1" }
+    });
+    requireExplicitConfirmationMock.mockReturnValue(null);
+  });
+  it("requires profileId and validates payment rule action payloads", () => {
+    expect(() => module.paymentRulesSchema.parse({ action: "list" })).toThrow();
+    expect(
+      () => module.paymentRulesSchema.parse({
+        action: "create",
+        profileId: "profile-1",
+        commercialConditionId: 10,
+        paymentSystem: "2"
+      })
+    ).toThrow(/installments/i);
+    expect(
+      module.paymentRulesSchema.parse({
+        action: "create",
+        profileId: "profile-1",
+        commercialConditionId: 10,
+        paymentSystem: "2",
+        salesChannel: "1",
+        restrictedByCondition: true,
+        installments: [
+          { count: 9, interest: false },
+          { count: 12, interest: true }
+        ]
+      })
+    ).toEqual({
+      action: "create",
+      profileId: "profile-1",
+      commercialConditionId: 10,
+      paymentSystem: "2",
+      salesChannel: "1",
+      restrictedByCondition: true,
+      installments: [
+        { count: 9, interest: false },
+        { count: 12, interest: true }
+      ]
+    });
+    expect(
+      module.paymentRulesSchema.parse({
+        action: "delete",
+        profileId: "profile-1",
+        ruleId: 77,
+        confirmed: true
+      })
+    ).toEqual({
+      action: "delete",
+      profileId: "profile-1",
+      ruleId: 77,
+      confirmed: true
+    });
+  });
+  it("returns compact list responses for payment rules", async () => {
+    listPaymentRulesMock.mockResolvedValue([
+      {
+        id: 51,
+        commercialConditionId: 10,
+        paymentSystem: "2",
+        salesChannel: "1",
+        restrictedByCondition: true
+      }
+    ]);
+    const result = await module.paymentRulesHandler({
+      action: "list",
+      profileId: "profile-1",
+      commercialConditionId: 10
+    });
+    expect(listPaymentRulesMock).toHaveBeenCalledWith("profile-1", { commercialConditionId: 10 });
+    expect(result).toEqual({
+      kind: "object",
+      value: {
+        metadata: {
+          total: 1,
+          profile_id: "profile-1",
+          filters: { commercial_condition_id: 10 }
+        },
+        payment_rules_schema: [
+          "id",
+          "commercial_condition_id",
+          "payment_system",
+          "sales_channel",
+          "restricted_by_condition"
+        ],
+        payment_rules: [[51, 10, "2", "1", true]]
+      }
+    });
+  });
+  it("gets, creates, updates and deletes payment rules through the service layer", async () => {
+    getPaymentRuleMock.mockResolvedValue({
+      id: 51,
+      commercialConditionId: 10,
+      paymentSystem: "2",
+      installments: [{ count: 9, interest: false }]
+    });
+    createPaymentRuleMock.mockResolvedValue({ id: 51, paymentSystem: "2" });
+    updatePaymentRuleMock.mockResolvedValue({ id: 51, paymentSystem: "2" });
+    deletePaymentRuleMock.mockResolvedValue(void 0);
+    const fetched = await module.paymentRulesHandler({
+      action: "get",
+      profileId: "profile-1",
+      ruleId: 51
+    });
+    const created = await module.paymentRulesHandler({
+      action: "create",
+      profileId: "profile-1",
+      commercialConditionId: 10,
+      paymentSystem: "2",
+      installments: [{ count: 9, interest: false }]
+    });
+    const updated = await module.paymentRulesHandler({
+      action: "update",
+      profileId: "profile-1",
+      ruleId: 51,
+      installments: [{ count: 12, interest: true }]
+    });
+    const deleted = await module.paymentRulesHandler({
+      action: "delete",
+      profileId: "profile-1",
+      ruleId: 51,
+      confirmed: true
+    });
+    expect(getPaymentRuleMock).toHaveBeenCalledWith("profile-1", 51);
+    expect(fetched).toEqual({
+      kind: "object",
+      value: {
+        profile_id: "profile-1",
+        rule_id: 51,
+        payment_rule: {
+          id: 51,
+          commercial_condition_id: 10,
+          payment_system: "2",
+          installments: [{ count: 9, interest: false }]
+        }
+      }
+    });
+    expect(createPaymentRuleMock).toHaveBeenCalledWith("profile-1", {
+      commercialConditionId: 10,
+      paymentSystem: "2",
+      installments: [{ count: 9, interest: false }]
+    });
+    expect(buildWriteSuccessResponseMock).toHaveBeenNthCalledWith(
+      1,
+      expect.objectContaining({
+        operation: "payment_rules_create",
+        resourceId: "51",
+        message: "Payment rule created. Review checkout installments and condition targeting to confirm the expected shopper experience.",
+        after: { id: 51, paymentSystem: "2" }
+      })
+    );
+    expect(buildWriteSuccessResponseMock).toHaveBeenNthCalledWith(
+      2,
+      expect.objectContaining({
+        operation: "payment_rules_update",
+        resourceId: "51",
+        message: "Payment rule updated. Review checkout installments to confirm the expected payment options.",
+        after: { id: 51, paymentSystem: "2" }
+      })
+    );
+    expect(updatePaymentRuleMock).toHaveBeenCalledWith("profile-1", 51, {
+      installments: [{ count: 12, interest: true }]
+    });
+    expect(deletePaymentRuleMock).toHaveBeenCalledWith("profile-1", 51);
+    expect(created).toMatchObject({
+      kind: "write",
+      value: {
+        operation: "payment_rules_create",
+        riskLevel: "medium",
+        message: "Payment rule created. Review checkout installments and condition targeting to confirm the expected shopper experience."
+      }
+    });
+    expect(updated).toMatchObject({
+      kind: "write",
+      value: {
+        operation: "payment_rules_update",
+        riskLevel: "medium",
+        message: "Payment rule updated. Review checkout installments to confirm the expected payment options."
+      }
+    });
+    expect(deleted).toMatchObject({
+      kind: "write",
+      value: {
+        operation: "payment_rules_delete",
+        riskLevel: "high",
+        warnings: [
+          "Deleting a payment rule can immediately remove installment options from checkout for affected shoppers."
+        ]
+      }
+    });
+    expect(JSON.stringify(created)).not.toContain("sandbox");
+    expect(JSON.stringify(created)).not.toContain("production");
+    expect(JSON.stringify(created)).not.toContain("legacy");
+    expect(JSON.stringify(updated)).not.toContain("sandbox");
+    expect(JSON.stringify(updated)).not.toContain("production");
+    expect(JSON.stringify(updated)).not.toContain("legacy");
+  });
+  it("requires explicit confirmation before deleting a payment rule", async () => {
+    requireExplicitConfirmationMock.mockReturnValueOnce({
+      kind: "object",
+      value: { success: false, risk_level: "high" }
+    });
+    const result = await module.paymentRulesHandler({
+      action: "delete",
+      profileId: "profile-1",
+      ruleId: 51
+    });
+    expect(deletePaymentRuleMock).not.toHaveBeenCalled();
+    expect(result).toEqual({
+      kind: "object",
+      value: { success: false, risk_level: "high" }
+    });
+  });
+});
+//# sourceMappingURL=payment-rules.test.js.map

package/dist/src/tools/vtex/__tests__/payment-rules.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/tools/vtex/__tests__/payment-rules.test.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\nimport { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nconst objectMock = vi.fn((value) => ({ kind: \"object\", value }));\nconst errorMock = vi.fn((message) => ({ kind: \"error\", message }));\nconst listPaymentRulesMock = vi.fn();\nconst getPaymentRuleMock = vi.fn();\nconst createPaymentRuleMock = vi.fn();\nconst updatePaymentRuleMock = vi.fn();\nconst deletePaymentRuleMock = vi.fn();\nconst resolveVtexWriteProfileMock = vi.fn();\nconst buildWriteSuccessResponseMock = vi.fn((value) => ({ kind: \"write\", value }));\nconst handleVtexWriteErrorMock = vi.fn((_err, fallback) => ({ kind: \"error\", message: fallback }));\nconst requireExplicitConfirmationMock = vi.fn();\n\nvi.mock(\"mcp-use/server\", () => ({\n  object: objectMock,\n  error: errorMock,\n}));\n\nvi.mock(\"../../../services/vtex/vtex-payments.js\", () => ({\n  listPaymentRules: listPaymentRulesMock,\n  getPaymentRule: getPaymentRuleMock,\n}));\n\nvi.mock(\"../../../services/vtex/vtex-payments-write.js\", () => ({\n  createPaymentRule: createPaymentRuleMock,\n  updatePaymentRule: updatePaymentRuleMock,\n  deletePaymentRule: deletePaymentRuleMock,\n}));\n\nvi.mock(\"../write-helpers.js\", () => ({\n  vtexProfileIdSchemaField: z.string().trim().min(1).optional().describe(\"profile\"),\n  confirmationSchemaField: z.boolean().optional().describe(\"confirmed\"),\n  resolveVtexWriteProfile: resolveVtexWriteProfileMock,\n  buildWriteSuccessResponse: buildWriteSuccessResponseMock,\n  handleVtexWriteError: handleVtexWriteErrorMock,\n  requireExplicitConfirmation: requireExplicitConfirmationMock,\n}));\n\nconst module = await import(\"../payment-rules.js\");\n\ndescribe(\"vtex_payment_rules tool\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n    resolveVtexWriteProfileMock.mockResolvedValue({\n      ok: true,\n      value: { profileId: \"profile-1\" },\n    });\n    requireExplicitConfirmationMock.mockReturnValue(null);\n  });\n\n  it(\"requires profileId and validates payment rule action payloads\", () => {\n    expect(() => module.paymentRulesSchema.parse({ action: \"list\" })).toThrow();\n    expect(() =>\n      module.paymentRulesSchema.parse({\n        action: \"create\",\n        profileId: \"profile-1\",\n        commercialConditionId: 10,\n        paymentSystem: \"2\",\n      })\n    ).toThrow(/installments/i);\n\n    expect(\n      module.paymentRulesSchema.parse({\n        action: \"create\",\n        profileId: \"profile-1\",\n        commercialConditionId: 10,\n        paymentSystem: \"2\",\n        salesChannel: \"1\",\n        restrictedByCondition: true,\n        installments: [\n          { count: 9, interest: false },\n          { count: 12, interest: true },\n        ],\n      })\n    ).toEqual({\n      action: \"create\",\n      profileId: \"profile-1\",\n      commercialConditionId: 10,\n      paymentSystem: \"2\",\n      salesChannel: \"1\",\n      restrictedByCondition: true,\n      installments: [\n        { count: 9, interest: false },\n        { count: 12, interest: true },\n      ],\n    });\n\n    expect(\n      module.paymentRulesSchema.parse({\n        action: \"delete\",\n        profileId: \"profile-1\",\n        ruleId: 77,\n        confirmed: true,\n      })\n    ).toEqual({\n      action: \"delete\",\n      profileId: \"profile-1\",\n      ruleId: 77,\n      confirmed: true,\n    });\n  });\n\n  it(\"returns compact list responses for payment rules\", async () => {\n    listPaymentRulesMock.mockResolvedValue([\n      {\n        id: 51,\n        commercialConditionId: 10,\n        paymentSystem: \"2\",\n        salesChannel: \"1\",\n        restrictedByCondition: true,\n      },\n    ]);\n\n    const result = await module.paymentRulesHandler({\n      action: \"list\",\n      profileId: \"profile-1\",\n      commercialConditionId: 10,\n    });\n\n    expect(listPaymentRulesMock).toHaveBeenCalledWith(\"profile-1\", { commercialConditionId: 10 });\n    expect(result).toEqual({\n      kind: \"object\",\n      value: {\n        metadata: {\n          total: 1,\n          profile_id: \"profile-1\",\n          filters: { commercial_condition_id: 10 },\n        },\n        payment_rules_schema: [\n          \"id\",\n          \"commercial_condition_id\",\n          \"payment_system\",\n          \"sales_channel\",\n          \"restricted_by_condition\",\n        ],\n        payment_rules: [[51, 10, \"2\", \"1\", true]],\n      },\n    });\n  });\n\n  it(\"gets, creates, updates and deletes payment rules through the service layer\", async () => {\n    getPaymentRuleMock.mockResolvedValue({\n      id: 51,\n      commercialConditionId: 10,\n      paymentSystem: \"2\",\n      installments: [{ count: 9, interest: false }],\n    });\n    createPaymentRuleMock.mockResolvedValue({ id: 51, paymentSystem: \"2\" });\n    updatePaymentRuleMock.mockResolvedValue({ id: 51, paymentSystem: \"2\" });\n    deletePaymentRuleMock.mockResolvedValue(undefined);\n\n    const fetched = await module.paymentRulesHandler({\n      action: \"get\",\n      profileId: \"profile-1\",\n      ruleId: 51,\n    });\n    const created = await module.paymentRulesHandler({\n      action: \"create\",\n      profileId: \"profile-1\",\n      commercialConditionId: 10,\n      paymentSystem: \"2\",\n      installments: [{ count: 9, interest: false }],\n    });\n    const updated = await module.paymentRulesHandler({\n      action: \"update\",\n      profileId: \"profile-1\",\n      ruleId: 51,\n      installments: [{ count: 12, interest: true }],\n    });\n    const deleted = await module.paymentRulesHandler({\n      action: \"delete\",\n      profileId: \"profile-1\",\n      ruleId: 51,\n      confirmed: true,\n    });\n\n    expect(getPaymentRuleMock).toHaveBeenCalledWith(\"profile-1\", 51);\n    expect(fetched).toEqual({\n      kind: \"object\",\n      value: {\n        profile_id: \"profile-1\",\n        rule_id: 51,\n        payment_rule: {\n          id: 51,\n          commercial_condition_id: 10,\n          payment_system: \"2\",\n          installments: [{ count: 9, interest: false }],\n        },\n      },\n    });\n    expect(createPaymentRuleMock).toHaveBeenCalledWith(\"profile-1\", {\n      commercialConditionId: 10,\n      paymentSystem: \"2\",\n      installments: [{ count: 9, interest: false }],\n    });\n    expect(buildWriteSuccessResponseMock).toHaveBeenNthCalledWith(\n      1,\n      expect.objectContaining({\n        operation: \"payment_rules_create\",\n        resourceId: \"51\",\n        message:\n          \"Payment rule created. Review checkout installments and condition targeting to confirm the expected shopper experience.\",\n        after: { id: 51, paymentSystem: \"2\" },\n      })\n    );\n    expect(buildWriteSuccessResponseMock).toHaveBeenNthCalledWith(\n      2,\n      expect.objectContaining({\n        operation: \"payment_rules_update\",\n        resourceId: \"51\",\n        message:\n          \"Payment rule updated. Review checkout installments to confirm the expected payment options.\",\n        after: { id: 51, paymentSystem: \"2\" },\n      })\n    );\n    expect(updatePaymentRuleMock).toHaveBeenCalledWith(\"profile-1\", 51, {\n      installments: [{ count: 12, interest: true }],\n    });\n    expect(deletePaymentRuleMock).toHaveBeenCalledWith(\"profile-1\", 51);\n    expect(created).toMatchObject({\n      kind: \"write\",\n      value: {\n        operation: \"payment_rules_create\",\n        riskLevel: \"medium\",\n        message:\n          \"Payment rule created. Review checkout installments and condition targeting to confirm the expected shopper experience.\",\n      },\n    });\n    expect(updated).toMatchObject({\n      kind: \"write\",\n      value: {\n        operation: \"payment_rules_update\",\n        riskLevel: \"medium\",\n        message:\n          \"Payment rule updated. Review checkout installments to confirm the expected payment options.\",\n      },\n    });\n    expect(deleted).toMatchObject({\n      kind: \"write\",\n      value: {\n        operation: \"payment_rules_delete\",\n        riskLevel: \"high\",\n        warnings: [\n          \"Deleting a payment rule can immediately remove installment options from checkout for affected shoppers.\",\n        ],\n      },\n    });\n    expect(JSON.stringify(created)).not.toContain(\"sandbox\");\n    expect(JSON.stringify(created)).not.toContain(\"production\");\n    expect(JSON.stringify(created)).not.toContain(\"legacy\");\n    expect(JSON.stringify(updated)).not.toContain(\"sandbox\");\n    expect(JSON.stringify(updated)).not.toContain(\"production\");\n    expect(JSON.stringify(updated)).not.toContain(\"legacy\");\n  });\n\n  it(\"requires explicit confirmation before deleting a payment rule\", async () => {\n    requireExplicitConfirmationMock.mockReturnValueOnce({\n      kind: \"object\",\n      value: { success: false, risk_level: \"high\" },\n    });\n\n    const result = await module.paymentRulesHandler({\n      action: \"delete\",\n      profileId: \"profile-1\",\n      ruleId: 51,\n    });\n\n    expect(deletePaymentRuleMock).not.toHaveBeenCalled();\n    expect(result).toEqual({\n      kind: \"object\",\n      value: { success: false, risk_level: \"high\" },\n    });\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/vtex/catalog-admin-products-skus.js

@@ -125,7 +125,9 @@ const updateSkuBasicFieldsSchema = z.object({
   measurementUnit: z.string().optional().describe("Measurement unit."),
   unitMultiplier: z.number().positive().optional().describe("Unit multiplier."),
   manufacturerCode: z.string().optional().describe("Manufacturer code."),
-  commercialConditionId: z.number().int().positive().optional().describe("Commercial condition ID."),
+  commercialConditionId: z.number().int().positive().optional().describe(
+    "Commercial condition ID. Use vtex_commercial_conditions to inspect available condition IDs and vtex_payment_rules to configure linked installment/payment behavior."
+  ),
   isActive: z.boolean().optional().describe("Whether the SKU should remain active."),
   activateIfPossible: z.boolean().optional().describe("Whether VTEX should auto-activate the SKU when possible.")
 }).refine(