@yoryoboy/bi-mcp 1.13.0 → 1.14.0

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

@@ -0,0 +1,220 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { formatVtexError } from "../../services/vtex/vtex-api.js";
+import {
+  getCommercialCondition,
+  listCommercialConditions
+} from "../../services/vtex/vtex-payments.js";
+import {
+  createCommercialCondition,
+  deleteCommercialCondition,
+  updateCommercialCondition
+} from "../../services/vtex/vtex-payments-write.js";
+import { toSnakeCaseKeys } from "../../utils/case-conversion.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+import {
+  buildWriteSuccessResponse,
+  confirmationSchemaField,
+  handleVtexWriteError,
+  requireExplicitConfirmation,
+  resolveVtexWriteProfile
+} from "./write-helpers.js";
+const commercialConditionWarnings = {
+  delete: "Deleting a commercial condition can break linked payment rules and installment visibility until dependent rules are updated."
+};
+const requiredProfileIdSchemaField = z.string().trim().min(1).describe("Explicit VTEX profile id to use for this operation.");
+const commercialConditionIdSchemaField = z.number().int().positive().describe("Positive VTEX commercial condition identifier.");
+const conditionRowsSchema = ["id", "name", "is_active"];
+function readValue(record, ...keys) {
+  for (const key of keys) {
+    if (key in record) {
+      return record[key];
+    }
+  }
+  return void 0;
+}
+const listActionSchema = z.object({
+  action: z.literal("list"),
+  profileId: requiredProfileIdSchemaField,
+  search: z.string().trim().min(1).optional().describe("Optional text filter for condition name lookup.")
+});
+const getActionSchema = z.object({
+  action: z.literal("get"),
+  profileId: requiredProfileIdSchemaField,
+  commercialConditionId: commercialConditionIdSchemaField
+});
+const createActionSchema = z.object({
+  action: z.literal("create"),
+  profileId: requiredProfileIdSchemaField,
+  name: z.string().trim().min(1).describe("Commercial condition name."),
+  description: z.string().trim().min(1).optional().describe("Optional internal description."),
+  isActive: z.boolean().optional().describe("Whether the condition should remain active.")
+});
+const updateActionSchema = z.object({
+  action: z.literal("update"),
+  profileId: requiredProfileIdSchemaField,
+  commercialConditionId: commercialConditionIdSchemaField,
+  name: z.string().trim().min(1).optional().describe("Updated commercial condition name."),
+  description: z.string().trim().min(1).optional().describe("Updated internal description."),
+  isActive: z.boolean().optional().describe("Updated condition active flag.")
+}).refine((value) => value.name !== void 0 || value.description !== void 0 || value.isActive !== void 0, {
+  message: "At least one commercial condition field must be provided.",
+  path: ["name"]
+});
+const deleteActionSchema = z.object({
+  action: z.literal("delete"),
+  profileId: requiredProfileIdSchemaField,
+  commercialConditionId: commercialConditionIdSchemaField,
+  confirmed: confirmationSchemaField
+});
+const commercialConditionsSchema = z.discriminatedUnion("action", [
+  listActionSchema,
+  getActionSchema,
+  createActionSchema,
+  updateActionSchema,
+  deleteActionSchema
+]);
+async function commercialConditionsHandler(params) {
+  switch (params.action) {
+    case "list": {
+      try {
+        const conditions = await listCommercialConditions(params.profileId, params.search);
+        return object({
+          metadata: stripNulls({
+            total: conditions.length,
+            profile_id: params.profileId,
+            search: params.search
+          }),
+          conditions_schema: conditionRowsSchema,
+          conditions: conditions.map((condition) => [
+            readValue(condition, "id", "Id"),
+            readValue(condition, "name", "Name"),
+            readValue(condition, "isActive", "IsActive", "is_active")
+          ])
+        });
+      } catch (err) {
+        return error(formatVtexError(err, "Failed to list VTEX commercial conditions"));
+      }
+    }
+    case "get": {
+      try {
+        const condition = await getCommercialCondition(params.profileId, params.commercialConditionId);
+        return object({
+          profile_id: params.profileId,
+          commercial_condition_id: params.commercialConditionId,
+          condition: toSnakeCaseKeys(condition)
+        });
+      } catch (err) {
+        return error(
+          formatVtexError(
+            err,
+            `Failed to fetch VTEX commercial condition ${params.commercialConditionId}`
+          )
+        );
+      }
+    }
+    case "create": {
+      try {
+        const profileResolution = await resolveVtexWriteProfile(params.profileId);
+        if (!profileResolution.ok) {
+          return profileResolution.response;
+        }
+        const created = await createCommercialCondition(profileResolution.value.profileId, {
+          Name: params.name,
+          ...params.description !== void 0 ? { Description: params.description } : {},
+          ...params.isActive !== void 0 ? { IsActive: params.isActive } : {}
+        });
+        return buildWriteSuccessResponse({
+          profileId: profileResolution.value.profileId,
+          operation: "commercial_conditions_create",
+          resourceId: created.id == null ? void 0 : String(created.id),
+          riskLevel: "low",
+          message: "Commercial condition created. You can now link it to payment rules or SKU assignments as needed.",
+          before: null,
+          after: created
+        });
+      } catch (err) {
+        return handleVtexWriteError(err, "Failed to create VTEX commercial condition");
+      }
+    }
+    case "update": {
+      try {
+        const profileResolution = await resolveVtexWriteProfile(params.profileId);
+        if (!profileResolution.ok) {
+          return profileResolution.response;
+        }
+        const before = await getCommercialCondition(
+          profileResolution.value.profileId,
+          params.commercialConditionId
+        );
+        const updated = await updateCommercialCondition(
+          profileResolution.value.profileId,
+          params.commercialConditionId,
+          {
+            ...params.name !== void 0 ? { Name: params.name } : {},
+            ...params.description !== void 0 ? { Description: params.description } : {},
+            ...params.isActive !== void 0 ? { IsActive: params.isActive } : {}
+          }
+        );
+        return buildWriteSuccessResponse({
+          profileId: profileResolution.value.profileId,
+          operation: "commercial_conditions_update",
+          resourceId: String(params.commercialConditionId),
+          riskLevel: "medium",
+          message: "Commercial condition updated. Review linked payment rules and checkout behavior to confirm the intended installment strategy.",
+          before,
+          after: updated
+        });
+      } catch (err) {
+        return handleVtexWriteError(
+          err,
+          `Failed to update VTEX commercial condition ${params.commercialConditionId}`
+        );
+      }
+    }
+    case "delete": {
+      const confirmationResponse = requireExplicitConfirmation(
+        params.confirmed,
+        "commercial_conditions_delete",
+        {
+          commercial_condition_id: params.commercialConditionId,
+          warnings: [commercialConditionWarnings.delete]
+        }
+      );
+      if (confirmationResponse) {
+        return confirmationResponse;
+      }
+      try {
+        const profileResolution = await resolveVtexWriteProfile(params.profileId);
+        if (!profileResolution.ok) {
+          return profileResolution.response;
+        }
+        await deleteCommercialCondition(
+          profileResolution.value.profileId,
+          params.commercialConditionId
+        );
+        return buildWriteSuccessResponse({
+          profileId: profileResolution.value.profileId,
+          operation: "commercial_conditions_delete",
+          resourceId: String(params.commercialConditionId),
+          riskLevel: "high",
+          confirmed: true,
+          message: "Commercial condition deleted. Confirm linked payment rules and SKU assignments still reflect the intended installment strategy.",
+          warnings: [commercialConditionWarnings.delete],
+          before: null,
+          after: null
+        });
+      } catch (err) {
+        return handleVtexWriteError(
+          err,
+          `Failed to delete VTEX commercial condition ${params.commercialConditionId}`
+        );
+      }
+    }
+  }
+}
+export {
+  commercialConditionsHandler,
+  commercialConditionsSchema
+};
+//# sourceMappingURL=commercial-conditions.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/commercial-conditions.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport {\n  getCommercialCondition,\n  listCommercialConditions,\n} from \"../../services/vtex/vtex-payments.js\";\nimport {\n  createCommercialCondition,\n  deleteCommercialCondition,\n  updateCommercialCondition,\n} from \"../../services/vtex/vtex-payments-write.js\";\nimport { toSnakeCaseKeys } from \"../../utils/case-conversion.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport {\n  buildWriteSuccessResponse,\n  confirmationSchemaField,\n  handleVtexWriteError,\n  requireExplicitConfirmation,\n  resolveVtexWriteProfile,\n} from \"./write-helpers.js\";\n\nconst commercialConditionWarnings = {\n  delete:\n    \"Deleting a commercial condition can break linked payment rules and installment visibility until dependent rules are updated.\",\n} as const;\n\nconst requiredProfileIdSchemaField = z\n  .string()\n  .trim()\n  .min(1)\n  .describe(\"Explicit VTEX profile id to use for this operation.\");\n\nconst commercialConditionIdSchemaField = z\n  .number()\n  .int()\n  .positive()\n  .describe(\"Positive VTEX commercial condition identifier.\");\n\nconst conditionRowsSchema = [\"id\", \"name\", \"is_active\"] as const;\n\nfunction readValue(record: Record<string, unknown>, ...keys: string[]): unknown {\n  for (const key of keys) {\n    if (key in record) {\n      return record[key];\n    }\n  }\n\n  return undefined;\n}\n\nconst listActionSchema = z.object({\n  action: z.literal(\"list\"),\n  profileId: requiredProfileIdSchemaField,\n  search: z.string().trim().min(1).optional().describe(\"Optional text filter for condition name lookup.\"),\n});\n\nconst getActionSchema = z.object({\n  action: z.literal(\"get\"),\n  profileId: requiredProfileIdSchemaField,\n  commercialConditionId: commercialConditionIdSchemaField,\n});\n\nconst createActionSchema = z.object({\n  action: z.literal(\"create\"),\n  profileId: requiredProfileIdSchemaField,\n  name: z.string().trim().min(1).describe(\"Commercial condition name.\"),\n  description: z.string().trim().min(1).optional().describe(\"Optional internal description.\"),\n  isActive: z.boolean().optional().describe(\"Whether the condition should remain active.\"),\n});\n\nconst updateActionSchema = z\n  .object({\n    action: z.literal(\"update\"),\n    profileId: requiredProfileIdSchemaField,\n    commercialConditionId: commercialConditionIdSchemaField,\n    name: z.string().trim().min(1).optional().describe(\"Updated commercial condition name.\"),\n    description: z.string().trim().min(1).optional().describe(\"Updated internal description.\"),\n    isActive: z.boolean().optional().describe(\"Updated condition active flag.\"),\n  })\n  .refine((value) => value.name !== undefined || value.description !== undefined || value.isActive !== undefined, {\n    message: \"At least one commercial condition field must be provided.\",\n    path: [\"name\"],\n  });\n\nconst deleteActionSchema = z.object({\n  action: z.literal(\"delete\"),\n  profileId: requiredProfileIdSchemaField,\n  commercialConditionId: commercialConditionIdSchemaField,\n  confirmed: confirmationSchemaField,\n});\n\nexport const commercialConditionsSchema = z.discriminatedUnion(\"action\", [\n  listActionSchema,\n  getActionSchema,\n  createActionSchema,\n  updateActionSchema,\n  deleteActionSchema,\n]);\n\nexport async function commercialConditionsHandler(\n  params: z.infer<typeof commercialConditionsSchema>\n) {\n  switch (params.action) {\n    case \"list\": {\n      try {\n        const conditions = await listCommercialConditions(params.profileId, params.search);\n\n        return object({\n          metadata: stripNulls({\n            total: conditions.length,\n            profile_id: params.profileId,\n            search: params.search,\n          }),\n          conditions_schema: conditionRowsSchema,\n          conditions: conditions.map((condition) => [\n            readValue(condition, \"id\", \"Id\"),\n            readValue(condition, \"name\", \"Name\"),\n            readValue(condition, \"isActive\", \"IsActive\", \"is_active\"),\n          ]),\n        });\n      } catch (err) {\n        return error(formatVtexError(err, \"Failed to list VTEX commercial conditions\"));\n      }\n    }\n\n    case \"get\": {\n      try {\n        const condition = await getCommercialCondition(params.profileId, params.commercialConditionId);\n\n        return object({\n          profile_id: params.profileId,\n          commercial_condition_id: params.commercialConditionId,\n          condition: toSnakeCaseKeys(condition),\n        });\n      } catch (err) {\n        return error(\n          formatVtexError(\n            err,\n            `Failed to fetch VTEX commercial condition ${params.commercialConditionId}`\n          )\n        );\n      }\n    }\n\n    case \"create\": {\n      try {\n        const profileResolution = await resolveVtexWriteProfile(params.profileId);\n        if (!profileResolution.ok) {\n          return profileResolution.response;\n        }\n\n        const created = await createCommercialCondition(profileResolution.value.profileId, {\n          Name: params.name,\n          ...(params.description !== undefined ? { Description: params.description } : {}),\n          ...(params.isActive !== undefined ? { IsActive: params.isActive } : {}),\n        });\n\n        return buildWriteSuccessResponse({\n          profileId: profileResolution.value.profileId,\n          operation: \"commercial_conditions_create\",\n          resourceId: created.id == null ? undefined : String(created.id),\n          riskLevel: \"low\",\n          message:\n            \"Commercial condition created. You can now link it to payment rules or SKU assignments as needed.\",\n          before: null,\n          after: created,\n        });\n      } catch (err) {\n        return handleVtexWriteError(err, \"Failed to create VTEX commercial condition\");\n      }\n    }\n\n    case \"update\": {\n      try {\n        const profileResolution = await resolveVtexWriteProfile(params.profileId);\n        if (!profileResolution.ok) {\n          return profileResolution.response;\n        }\n\n        const before = await getCommercialCondition(\n          profileResolution.value.profileId,\n          params.commercialConditionId\n        );\n\n        const updated = await updateCommercialCondition(\n          profileResolution.value.profileId,\n          params.commercialConditionId,\n          {\n            ...(params.name !== undefined ? { Name: params.name } : {}),\n            ...(params.description !== undefined ? { Description: params.description } : {}),\n            ...(params.isActive !== undefined ? { IsActive: params.isActive } : {}),\n          }\n        );\n\n        return buildWriteSuccessResponse({\n          profileId: profileResolution.value.profileId,\n          operation: \"commercial_conditions_update\",\n          resourceId: String(params.commercialConditionId),\n          riskLevel: \"medium\",\n          message:\n            \"Commercial condition updated. Review linked payment rules and checkout behavior to confirm the intended installment strategy.\",\n          before,\n          after: updated,\n        });\n      } catch (err) {\n        return handleVtexWriteError(\n          err,\n          `Failed to update VTEX commercial condition ${params.commercialConditionId}`\n        );\n      }\n    }\n\n    case \"delete\": {\n      const confirmationResponse = requireExplicitConfirmation(\n        params.confirmed,\n        \"commercial_conditions_delete\",\n        {\n          commercial_condition_id: params.commercialConditionId,\n          warnings: [commercialConditionWarnings.delete],\n        }\n      );\n      if (confirmationResponse) {\n        return confirmationResponse;\n      }\n\n      try {\n        const profileResolution = await resolveVtexWriteProfile(params.profileId);\n        if (!profileResolution.ok) {\n          return profileResolution.response;\n        }\n\n        await deleteCommercialCondition(\n          profileResolution.value.profileId,\n          params.commercialConditionId\n        );\n\n        return buildWriteSuccessResponse({\n          profileId: profileResolution.value.profileId,\n          operation: \"commercial_conditions_delete\",\n          resourceId: String(params.commercialConditionId),\n          riskLevel: \"high\",\n          confirmed: true,\n          message:\n            \"Commercial condition deleted. Confirm linked payment rules and SKU assignments still reflect the intended installment strategy.\",\n          warnings: [commercialConditionWarnings.delete],\n          before: null,\n          after: null,\n        });\n      } catch (err) {\n        return handleVtexWriteError(\n          err,\n          `Failed to delete VTEX commercial condition ${params.commercialConditionId}`\n        );\n      }\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/vtex/create-sku.js

@@ -25,7 +25,9 @@ const createSkuSchema = z.object({
   measurementUnit: z.string().optional().describe("Measurement unit, for example `un`."),
   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 manage condition records and vtex_payment_rules to configure linked installment/payment behavior."
+  )
 });
 async function createSkuHandler({
   profileId,

package/dist/src/tools/vtex/create-sku.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/vtex/create-sku.ts"],
-  "sourcesContent": ["import { z } from \"zod\";\n\nimport { createSku, createSkuEan } from \"../../services/vtex/vtex-catalog-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nexport const createSkuSchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  productId: z.number().int().positive().describe(\"Parent product ID.\"),\n  name: z.string().min(1).describe(\"SKU name.\"),\n  refId: z.string().min(1).describe(\"Internal SKU reference code.\"),\n  ean: z.string().optional().describe(\"Optional EAN to attach after SKU creation.\"),\n  packagedHeight: z.number().nonnegative().describe(\"Packaged height.\"),\n  packagedLength: z.number().nonnegative().describe(\"Packaged length.\"),\n  packagedWidth: z.number().nonnegative().describe(\"Packaged width.\"),\n  packagedWeightKg: z.number().nonnegative().describe(\"Packaged weight in kg.\"),\n  height: z.number().nonnegative().optional().describe(\"Physical height.\"),\n  length: z.number().nonnegative().optional().describe(\"Physical length.\"),\n  width: z.number().nonnegative().optional().describe(\"Physical width.\"),\n  weightKg: z.number().nonnegative().optional().describe(\"Physical weight in kg.\"),\n  isActive: z\n    .boolean()\n    .optional()\n    .describe(\"Whether the SKU should be created as active. VTEX recommends false during creation.\"),\n  activateIfPossible: z\n    .boolean()\n    .optional()\n    .describe(\"Whether VTEX should auto-activate the SKU when an image or active component exists.\"),\n  measurementUnit: z.string().optional().describe(\"Measurement unit, for example `un`.\"),\n  unitMultiplier: z.number().positive().optional().describe(\"Unit multiplier.\"),\n  manufacturerCode: z.string().optional().describe(\"Manufacturer code.\"),\n  commercialConditionId: z.number().int().positive().optional().describe(\"Commercial condition ID.\"),\n});\n\nexport async function createSkuHandler({\n  profileId,\n  productId,\n  name,\n  refId,\n  ean,\n  packagedHeight,\n  packagedLength,\n  packagedWidth,\n  packagedWeightKg,\n  height,\n  length,\n  width,\n  weightKg,\n  isActive,\n  activateIfPossible,\n  measurementUnit,\n  unitMultiplier,\n  manufacturerCode,\n  commercialConditionId,\n}: z.infer<typeof createSkuSchema>) {\n  try {\n    const profileResolution = await resolveVtexWriteProfile(profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const resolvedProfileId = profileResolution.value.profileId;\n    const payload: Record<string, unknown> = {\n      ProductId: productId,\n      Name: name,\n      RefId: refId,\n      PackagedHeight: packagedHeight,\n      PackagedLength: packagedLength,\n      PackagedWidth: packagedWidth,\n      PackagedWeightKg: packagedWeightKg,\n      ActivateIfPossible: activateIfPossible ?? true,\n      IsActive: isActive ?? false,\n    };\n\n    if (height !== undefined) payload.Height = height;\n    if (length !== undefined) payload.Length = length;\n    if (width !== undefined) payload.Width = width;\n    if (weightKg !== undefined) payload.WeightKg = weightKg;\n    if (measurementUnit !== undefined) payload.MeasurementUnit = measurementUnit;\n    if (unitMultiplier !== undefined) payload.UnitMultiplier = unitMultiplier;\n    if (manufacturerCode !== undefined) payload.ManufacturerCode = manufacturerCode;\n    if (commercialConditionId !== undefined) payload.CommercialConditionId = commercialConditionId;\n\n    const createdSku = await createSku(resolvedProfileId, payload);\n    const resourceId = createdSku.Id == null ? undefined : String(createdSku.Id);\n\n    if (resourceId && ean?.trim()) {\n      await createSkuEan(resolvedProfileId, resourceId, ean.trim());\n      createdSku.Eans = [ean.trim()];\n    }\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"create_sku\",\n      resourceId,\n      riskLevel: \"low\",\n      message: \"SKU created successfully.\",\n      before: null,\n      after: createdSku,\n      details: {\n        product_id: productId,\n        sku_id: resourceId,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, \"Failed to create SKU in VTEX\");\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,SAAS;AAElB,SAAS,WAAW,oBAAoB;AACxC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,kBAAkB,EAAE,OAAO;AAAA,EACtC,WAAW;AAAA,EACX,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,oBAAoB;AAAA,EACpE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,WAAW;AAAA,EAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,8BAA8B;AAAA,EAChE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,4CAA4C;AAAA,EAChF,gBAAgB,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,kBAAkB;AAAA,EACpE,gBAAgB,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,kBAAkB;AAAA,EACpE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,iBAAiB;AAAA,EAClE,kBAAkB,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,wBAAwB;AAAA,EAC5E,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,kBAAkB;AAAA,EACvE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,kBAAkB;AAAA,EACvE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,iBAAiB;AAAA,EACrE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,wBAAwB;AAAA,EAC/E,UAAU,EACP,QAAQ,EACR,SAAS,EACT,SAAS,qFAAqF;AAAA,EACjG,oBAAoB,EACjB,QAAQ,EACR,SAAS,EACT,SAAS,qFAAqF;AAAA,EACjG,iBAAiB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,qCAAqC;AAAA,EACrF,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,kBAAkB;AAAA,EAC5E,kBAAkB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,oBAAoB;AAAA,EACrE,uBAAuB,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,0BAA0B;AACnG,CAAC;AAED,eAAsB,iBAAiB;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAoC;AAClC,MAAI;AACF,UAAM,oBAAoB,MAAM,wBAAwB,SAAS;AACjE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,UAAmC;AAAA,MACvC,WAAW;AAAA,MACX,MAAM;AAAA,MACN,OAAO;AAAA,MACP,gBAAgB;AAAA,MAChB,gBAAgB;AAAA,MAChB,eAAe;AAAA,MACf,kBAAkB;AAAA,MAClB,oBAAoB,sBAAsB;AAAA,MAC1C,UAAU,YAAY;AAAA,IACxB;AAEA,QAAI,WAAW,OAAW,SAAQ,SAAS;AAC3C,QAAI,WAAW,OAAW,SAAQ,SAAS;AAC3C,QAAI,UAAU,OAAW,SAAQ,QAAQ;AACzC,QAAI,aAAa,OAAW,SAAQ,WAAW;AAC/C,QAAI,oBAAoB,OAAW,SAAQ,kBAAkB;AAC7D,QAAI,mBAAmB,OAAW,SAAQ,iBAAiB;AAC3D,QAAI,qBAAqB,OAAW,SAAQ,mBAAmB;AAC/D,QAAI,0BAA0B,OAAW,SAAQ,wBAAwB;AAEzE,UAAM,aAAa,MAAM,UAAU,mBAAmB,OAAO;AAC7D,UAAM,aAAa,WAAW,MAAM,OAAO,SAAY,OAAO,WAAW,EAAE;AAE3E,QAAI,cAAc,KAAK,KAAK,GAAG;AAC7B,YAAM,aAAa,mBAAmB,YAAY,IAAI,KAAK,CAAC;AAC5D,iBAAW,OAAO,CAAC,IAAI,KAAK,CAAC;AAAA,IAC/B;AAEA,WAAO,0BAA0B;AAAA,MAC/B,WAAW;AAAA,MACX,WAAW;AAAA,MACX;AAAA,MACA,WAAW;AAAA,MACX,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,OAAO;AAAA,MACP,SAAS;AAAA,QACP,YAAY;AAAA,QACZ,QAAQ;AAAA,MACV;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,qBAAqB,KAAK,8BAA8B;AAAA,EACjE;AACF;",
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport { createSku, createSkuEan } from \"../../services/vtex/vtex-catalog-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nexport const createSkuSchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  productId: z.number().int().positive().describe(\"Parent product ID.\"),\n  name: z.string().min(1).describe(\"SKU name.\"),\n  refId: z.string().min(1).describe(\"Internal SKU reference code.\"),\n  ean: z.string().optional().describe(\"Optional EAN to attach after SKU creation.\"),\n  packagedHeight: z.number().nonnegative().describe(\"Packaged height.\"),\n  packagedLength: z.number().nonnegative().describe(\"Packaged length.\"),\n  packagedWidth: z.number().nonnegative().describe(\"Packaged width.\"),\n  packagedWeightKg: z.number().nonnegative().describe(\"Packaged weight in kg.\"),\n  height: z.number().nonnegative().optional().describe(\"Physical height.\"),\n  length: z.number().nonnegative().optional().describe(\"Physical length.\"),\n  width: z.number().nonnegative().optional().describe(\"Physical width.\"),\n  weightKg: z.number().nonnegative().optional().describe(\"Physical weight in kg.\"),\n  isActive: z\n    .boolean()\n    .optional()\n    .describe(\"Whether the SKU should be created as active. VTEX recommends false during creation.\"),\n  activateIfPossible: z\n    .boolean()\n    .optional()\n    .describe(\"Whether VTEX should auto-activate the SKU when an image or active component exists.\"),\n  measurementUnit: z.string().optional().describe(\"Measurement unit, for example `un`.\"),\n  unitMultiplier: z.number().positive().optional().describe(\"Unit multiplier.\"),\n  manufacturerCode: z.string().optional().describe(\"Manufacturer code.\"),\n  commercialConditionId: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe(\n      \"Commercial condition ID. Use vtex_commercial_conditions to manage condition records and vtex_payment_rules to configure linked installment/payment behavior.\"\n    ),\n});\n\nexport async function createSkuHandler({\n  profileId,\n  productId,\n  name,\n  refId,\n  ean,\n  packagedHeight,\n  packagedLength,\n  packagedWidth,\n  packagedWeightKg,\n  height,\n  length,\n  width,\n  weightKg,\n  isActive,\n  activateIfPossible,\n  measurementUnit,\n  unitMultiplier,\n  manufacturerCode,\n  commercialConditionId,\n}: z.infer<typeof createSkuSchema>) {\n  try {\n    const profileResolution = await resolveVtexWriteProfile(profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const resolvedProfileId = profileResolution.value.profileId;\n    const payload: Record<string, unknown> = {\n      ProductId: productId,\n      Name: name,\n      RefId: refId,\n      PackagedHeight: packagedHeight,\n      PackagedLength: packagedLength,\n      PackagedWidth: packagedWidth,\n      PackagedWeightKg: packagedWeightKg,\n      ActivateIfPossible: activateIfPossible ?? true,\n      IsActive: isActive ?? false,\n    };\n\n    if (height !== undefined) payload.Height = height;\n    if (length !== undefined) payload.Length = length;\n    if (width !== undefined) payload.Width = width;\n    if (weightKg !== undefined) payload.WeightKg = weightKg;\n    if (measurementUnit !== undefined) payload.MeasurementUnit = measurementUnit;\n    if (unitMultiplier !== undefined) payload.UnitMultiplier = unitMultiplier;\n    if (manufacturerCode !== undefined) payload.ManufacturerCode = manufacturerCode;\n    if (commercialConditionId !== undefined) payload.CommercialConditionId = commercialConditionId;\n\n    const createdSku = await createSku(resolvedProfileId, payload);\n    const resourceId = createdSku.Id == null ? undefined : String(createdSku.Id);\n\n    if (resourceId && ean?.trim()) {\n      await createSkuEan(resolvedProfileId, resourceId, ean.trim());\n      createdSku.Eans = [ean.trim()];\n    }\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"create_sku\",\n      resourceId,\n      riskLevel: \"low\",\n      message: \"SKU created successfully.\",\n      before: null,\n      after: createdSku,\n      details: {\n        product_id: productId,\n        sku_id: resourceId,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, \"Failed to create SKU in VTEX\");\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB,SAAS,WAAW,oBAAoB;AACxC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,kBAAkB,EAAE,OAAO;AAAA,EACtC,WAAW;AAAA,EACX,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,oBAAoB;AAAA,EACpE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,WAAW;AAAA,EAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,8BAA8B;AAAA,EAChE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,4CAA4C;AAAA,EAChF,gBAAgB,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,kBAAkB;AAAA,EACpE,gBAAgB,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,kBAAkB;AAAA,EACpE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,iBAAiB;AAAA,EAClE,kBAAkB,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,wBAAwB;AAAA,EAC5E,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,kBAAkB;AAAA,EACvE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,kBAAkB;AAAA,EACvE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,iBAAiB;AAAA,EACrE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,wBAAwB;AAAA,EAC/E,UAAU,EACP,QAAQ,EACR,SAAS,EACT,SAAS,qFAAqF;AAAA,EACjG,oBAAoB,EACjB,QAAQ,EACR,SAAS,EACT,SAAS,qFAAqF;AAAA,EACjG,iBAAiB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,qCAAqC;AAAA,EACrF,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,kBAAkB;AAAA,EAC5E,kBAAkB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,oBAAoB;AAAA,EACrE,uBAAuB,EACpB,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,EACT;AAAA,IACC;AAAA,EACF;AACJ,CAAC;AAED,eAAsB,iBAAiB;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAoC;AAClC,MAAI;AACF,UAAM,oBAAoB,MAAM,wBAAwB,SAAS;AACjE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,UAAmC;AAAA,MACvC,WAAW;AAAA,MACX,MAAM;AAAA,MACN,OAAO;AAAA,MACP,gBAAgB;AAAA,MAChB,gBAAgB;AAAA,MAChB,eAAe;AAAA,MACf,kBAAkB;AAAA,MAClB,oBAAoB,sBAAsB;AAAA,MAC1C,UAAU,YAAY;AAAA,IACxB;AAEA,QAAI,WAAW,OAAW,SAAQ,SAAS;AAC3C,QAAI,WAAW,OAAW,SAAQ,SAAS;AAC3C,QAAI,UAAU,OAAW,SAAQ,QAAQ;AACzC,QAAI,aAAa,OAAW,SAAQ,WAAW;AAC/C,QAAI,oBAAoB,OAAW,SAAQ,kBAAkB;AAC7D,QAAI,mBAAmB,OAAW,SAAQ,iBAAiB;AAC3D,QAAI,qBAAqB,OAAW,SAAQ,mBAAmB;AAC/D,QAAI,0BAA0B,OAAW,SAAQ,wBAAwB;AAEzE,UAAM,aAAa,MAAM,UAAU,mBAAmB,OAAO;AAC7D,UAAM,aAAa,WAAW,MAAM,OAAO,SAAY,OAAO,WAAW,EAAE;AAE3E,QAAI,cAAc,KAAK,KAAK,GAAG;AAC7B,YAAM,aAAa,mBAAmB,YAAY,IAAI,KAAK,CAAC;AAC5D,iBAAW,OAAO,CAAC,IAAI,KAAK,CAAC;AAAA,IAC/B;AAEA,WAAO,0BAA0B;AAAA,MAC/B,WAAW;AAAA,MACX,WAAW;AAAA,MACX;AAAA,MACA,WAAW;AAAA,MACX,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,OAAO;AAAA,MACP,SAAS;AAAA,QACP,YAAY;AAAA,QACZ,QAAQ;AAAA,MACV;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,qBAAqB,KAAK,8BAA8B;AAAA,EACjE;AACF;",
   "names": []
 }

package/dist/src/tools/vtex/index.js

@@ -31,6 +31,8 @@ export * from "./update-product-basic-fields.js";
 export * from "./update-sku-basic-fields.js";
 export * from "./create-product.js";
 export * from "./create-sku.js";
+export * from "./commercial-conditions.js";
+export * from "./payment-rules.js";
 export * from "./create-brand.js";
 export * from "./update-brand.js";
 export * from "./create-category.js";

package/dist/src/tools/vtex/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/vtex/index.ts"],
-  "sourcesContent": ["export * from \"./orders-summary.js\";\nexport * from \"./order-details.js\";\nexport * from \"./inventory-check.js\";\nexport * from \"./warehouse-inventory.js\";\nexport * from \"./update-inventory.js\";\nexport * from \"./update-lead-time.js\";\nexport * from \"./toggle-unlimited-quantity.js\";\nexport * from \"./sku-price.js\";\nexport * from \"./computed-price.js\";\nexport * from \"./product-offers.js\";\nexport * from \"./sku-offers.js\";\nexport * from \"./get-category-tree.js\";\nexport * from \"./list-categories.js\";\nexport * from \"./get-category.js\";\nexport * from \"./get-brand.js\";\nexport * from \"./list-brands.js\";\nexport * from \"./list-specification-groups.js\";\nexport * from \"./get-product.js\";\nexport * from \"./get-product-specifications.js\";\nexport * from \"./list-products.js\";\nexport * from \"./list-products-by-category.js\";\nexport * from \"./get-sku.js\";\nexport * from \"./list-skus-by-product.js\";\nexport * from \"./update-sku-price.js\";\nexport * from \"./delete-sku-price.js\";\nexport * from \"./upsert-fixed-price.js\";\nexport * from \"./delete-fixed-price.js\";\nexport * from \"./activate-sku.js\";\nexport * from \"./deactivate-sku.js\";\nexport * from \"./update-product-basic-fields.js\";\nexport * from \"./update-sku-basic-fields.js\";\nexport * from \"./create-product.js\";\nexport * from \"./create-sku.js\";\n// Helper-only flow: create-product-with-sku stays internal until dedicated\n// product/SKU admin wrappers complete full rationalization.\nexport * from \"./create-brand.js\";\nexport * from \"./update-brand.js\";\nexport * from \"./create-category.js\";\nexport * from \"./update-category.js\";\nexport * from \"./move-category.js\";\nexport * from \"./create-specification.js\";\nexport * from \"./create-specification-value.js\";\nexport * from \"./associate-specification.js\";\nexport * from \"./delete-product-specification.js\";\nexport * from \"./delete-all-product-specifications.js\";\nexport * from \"./delete-brand.js\";\nexport * from \"./delete-catalog-image.js\";\nexport * from \"./delete-sku-specification.js\";\nexport * from \"./delete-all-sku-specifications.js\";\nexport * from \"./attach-catalog-image.js\";\nexport * from \"./catalog-admin-products-skus.js\";\nexport * from \"./cancel-order.js\";\nexport * from \"./invoice-order.js\";\nexport * from \"./add-order-tracking.js\";\nexport * from \"./profile-resolution.js\";\n"],
-  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "sourcesContent": ["export * from \"./orders-summary.js\";\nexport * from \"./order-details.js\";\nexport * from \"./inventory-check.js\";\nexport * from \"./warehouse-inventory.js\";\nexport * from \"./update-inventory.js\";\nexport * from \"./update-lead-time.js\";\nexport * from \"./toggle-unlimited-quantity.js\";\nexport * from \"./sku-price.js\";\nexport * from \"./computed-price.js\";\nexport * from \"./product-offers.js\";\nexport * from \"./sku-offers.js\";\nexport * from \"./get-category-tree.js\";\nexport * from \"./list-categories.js\";\nexport * from \"./get-category.js\";\nexport * from \"./get-brand.js\";\nexport * from \"./list-brands.js\";\nexport * from \"./list-specification-groups.js\";\nexport * from \"./get-product.js\";\nexport * from \"./get-product-specifications.js\";\nexport * from \"./list-products.js\";\nexport * from \"./list-products-by-category.js\";\nexport * from \"./get-sku.js\";\nexport * from \"./list-skus-by-product.js\";\nexport * from \"./update-sku-price.js\";\nexport * from \"./delete-sku-price.js\";\nexport * from \"./upsert-fixed-price.js\";\nexport * from \"./delete-fixed-price.js\";\nexport * from \"./activate-sku.js\";\nexport * from \"./deactivate-sku.js\";\nexport * from \"./update-product-basic-fields.js\";\nexport * from \"./update-sku-basic-fields.js\";\nexport * from \"./create-product.js\";\nexport * from \"./create-sku.js\";\nexport * from \"./commercial-conditions.js\";\nexport * from \"./payment-rules.js\";\n// Helper-only flow: create-product-with-sku stays internal until dedicated\n// product/SKU admin wrappers complete full rationalization.\nexport * from \"./create-brand.js\";\nexport * from \"./update-brand.js\";\nexport * from \"./create-category.js\";\nexport * from \"./update-category.js\";\nexport * from \"./move-category.js\";\nexport * from \"./create-specification.js\";\nexport * from \"./create-specification-value.js\";\nexport * from \"./associate-specification.js\";\nexport * from \"./delete-product-specification.js\";\nexport * from \"./delete-all-product-specifications.js\";\nexport * from \"./delete-brand.js\";\nexport * from \"./delete-catalog-image.js\";\nexport * from \"./delete-sku-specification.js\";\nexport * from \"./delete-all-sku-specifications.js\";\nexport * from \"./attach-catalog-image.js\";\nexport * from \"./catalog-admin-products-skus.js\";\nexport * from \"./cancel-order.js\";\nexport * from \"./invoice-order.js\";\nexport * from \"./add-order-tracking.js\";\nexport * from \"./profile-resolution.js\";\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

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

@@ -0,0 +1,229 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { formatVtexError } from "../../services/vtex/vtex-api.js";
+import { getPaymentRule, listPaymentRules } from "../../services/vtex/vtex-payments.js";
+import {
+  createPaymentRule,
+  deletePaymentRule,
+  updatePaymentRule
+} from "../../services/vtex/vtex-payments-write.js";
+import { toSnakeCaseKeys } from "../../utils/case-conversion.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+import {
+  buildWriteSuccessResponse,
+  confirmationSchemaField,
+  handleVtexWriteError,
+  requireExplicitConfirmation,
+  resolveVtexWriteProfile
+} from "./write-helpers.js";
+const requiredProfileIdSchemaField = z.string().trim().min(1).describe("Explicit VTEX profile id to use for this operation.");
+const positiveIntegerSchemaField = (description) => z.number().int().positive().describe(description);
+const installmentsSchemaField = z.array(
+  z.object({
+    count: positiveIntegerSchemaField("Installment count."),
+    interest: z.boolean().describe("Whether this installment carries interest.")
+  })
+).min(1).describe("Installment configuration rows for the payment rule.");
+const paymentRuleWarnings = {
+  delete: "Deleting a payment rule can immediately remove installment options from checkout for affected shoppers."
+};
+const paymentRuleRowsSchema = [
+  "id",
+  "commercial_condition_id",
+  "payment_system",
+  "sales_channel",
+  "restricted_by_condition"
+];
+function readValue(record, ...keys) {
+  for (const key of keys) {
+    if (key in record) {
+      return record[key];
+    }
+  }
+  return void 0;
+}
+const listActionSchema = z.object({
+  action: z.literal("list"),
+  profileId: requiredProfileIdSchemaField,
+  commercialConditionId: positiveIntegerSchemaField(
+    "Optional commercial condition filter for payment rules."
+  ).optional()
+});
+const getActionSchema = z.object({
+  action: z.literal("get"),
+  profileId: requiredProfileIdSchemaField,
+  ruleId: positiveIntegerSchemaField("Positive VTEX payment rule identifier.")
+});
+const createActionSchema = z.object({
+  action: z.literal("create"),
+  profileId: requiredProfileIdSchemaField,
+  commercialConditionId: positiveIntegerSchemaField(
+    "Commercial condition identifier linked to this payment rule."
+  ),
+  paymentSystem: z.string().trim().min(1).describe("VTEX payment system identifier."),
+  salesChannel: z.string().trim().min(1).optional().describe("Optional VTEX sales channel identifier."),
+  restrictedByCondition: z.boolean().optional().describe("Whether checkout should restrict this rule to the linked commercial condition."),
+  installments: installmentsSchemaField
+});
+const updateActionSchema = z.object({
+  action: z.literal("update"),
+  profileId: requiredProfileIdSchemaField,
+  ruleId: positiveIntegerSchemaField("Positive VTEX payment rule identifier."),
+  commercialConditionId: positiveIntegerSchemaField(
+    "Commercial condition identifier linked to this payment rule."
+  ).optional(),
+  paymentSystem: z.string().trim().min(1).optional().describe("Updated VTEX payment system identifier."),
+  salesChannel: z.string().trim().min(1).optional().describe("Updated VTEX sales channel identifier."),
+  restrictedByCondition: z.boolean().optional().describe("Updated restricted-by-condition flag."),
+  installments: installmentsSchemaField.optional()
+}).refine(
+  (value) => value.commercialConditionId !== void 0 || value.paymentSystem !== void 0 || value.salesChannel !== void 0 || value.restrictedByCondition !== void 0 || value.installments !== void 0,
+  {
+    message: "At least one payment rule field must be provided.",
+    path: ["paymentSystem"]
+  }
+);
+const deleteActionSchema = z.object({
+  action: z.literal("delete"),
+  profileId: requiredProfileIdSchemaField,
+  ruleId: positiveIntegerSchemaField("Positive VTEX payment rule identifier."),
+  confirmed: confirmationSchemaField
+});
+const paymentRulesSchema = z.discriminatedUnion("action", [
+  listActionSchema,
+  getActionSchema,
+  createActionSchema,
+  updateActionSchema,
+  deleteActionSchema
+]);
+async function paymentRulesHandler(params) {
+  switch (params.action) {
+    case "list": {
+      try {
+        const rules = await listPaymentRules(params.profileId, {
+          commercialConditionId: params.commercialConditionId
+        });
+        return object({
+          metadata: stripNulls({
+            total: rules.length,
+            profile_id: params.profileId,
+            filters: params.commercialConditionId === void 0 ? void 0 : { commercial_condition_id: params.commercialConditionId }
+          }),
+          payment_rules_schema: paymentRuleRowsSchema,
+          payment_rules: rules.map((rule) => [
+            readValue(rule, "id", "Id"),
+            readValue(rule, "commercialConditionId", "CommercialConditionId", "commercial_condition_id"),
+            readValue(rule, "paymentSystem", "PaymentSystem", "payment_system"),
+            readValue(rule, "salesChannel", "SalesChannel", "sales_channel"),
+            readValue(
+              rule,
+              "restrictedByCondition",
+              "RestrictedByCondition",
+              "restricted_by_condition"
+            )
+          ])
+        });
+      } catch (err) {
+        return error(formatVtexError(err, "Failed to list VTEX payment rules"));
+      }
+    }
+    case "get": {
+      try {
+        const rule = await getPaymentRule(params.profileId, params.ruleId);
+        return object({
+          profile_id: params.profileId,
+          rule_id: params.ruleId,
+          payment_rule: toSnakeCaseKeys(rule)
+        });
+      } catch (err) {
+        return error(formatVtexError(err, `Failed to fetch VTEX payment rule ${params.ruleId}`));
+      }
+    }
+    case "create": {
+      try {
+        const profileResolution = await resolveVtexWriteProfile(params.profileId);
+        if (!profileResolution.ok) {
+          return profileResolution.response;
+        }
+        const created = await createPaymentRule(profileResolution.value.profileId, {
+          commercialConditionId: params.commercialConditionId,
+          paymentSystem: params.paymentSystem,
+          ...params.salesChannel !== void 0 ? { salesChannel: params.salesChannel } : {},
+          ...params.restrictedByCondition !== void 0 ? { restrictedByCondition: params.restrictedByCondition } : {},
+          installments: params.installments
+        });
+        return buildWriteSuccessResponse({
+          profileId: profileResolution.value.profileId,
+          operation: "payment_rules_create",
+          resourceId: created.id == null ? void 0 : String(created.id),
+          riskLevel: "medium",
+          message: "Payment rule created. Review checkout installments and condition targeting to confirm the expected shopper experience.",
+          before: null,
+          after: created
+        });
+      } catch (err) {
+        return handleVtexWriteError(err, "Failed to create VTEX payment rule");
+      }
+    }
+    case "update": {
+      try {
+        const profileResolution = await resolveVtexWriteProfile(params.profileId);
+        if (!profileResolution.ok) {
+          return profileResolution.response;
+        }
+        const updated = await updatePaymentRule(profileResolution.value.profileId, params.ruleId, {
+          ...params.commercialConditionId !== void 0 ? { commercialConditionId: params.commercialConditionId } : {},
+          ...params.paymentSystem !== void 0 ? { paymentSystem: params.paymentSystem } : {},
+          ...params.salesChannel !== void 0 ? { salesChannel: params.salesChannel } : {},
+          ...params.restrictedByCondition !== void 0 ? { restrictedByCondition: params.restrictedByCondition } : {},
+          ...params.installments !== void 0 ? { installments: params.installments } : {}
+        });
+        return buildWriteSuccessResponse({
+          profileId: profileResolution.value.profileId,
+          operation: "payment_rules_update",
+          resourceId: String(params.ruleId),
+          riskLevel: "medium",
+          message: "Payment rule updated. Review checkout installments to confirm the expected payment options.",
+          before: null,
+          after: updated
+        });
+      } catch (err) {
+        return handleVtexWriteError(err, `Failed to update VTEX payment rule ${params.ruleId}`);
+      }
+    }
+    case "delete": {
+      const confirmationResponse = requireExplicitConfirmation(params.confirmed, "payment_rules_delete", {
+        rule_id: params.ruleId,
+        warnings: [paymentRuleWarnings.delete]
+      });
+      if (confirmationResponse) {
+        return confirmationResponse;
+      }
+      try {
+        const profileResolution = await resolveVtexWriteProfile(params.profileId);
+        if (!profileResolution.ok) {
+          return profileResolution.response;
+        }
+        await deletePaymentRule(profileResolution.value.profileId, params.ruleId);
+        return buildWriteSuccessResponse({
+          profileId: profileResolution.value.profileId,
+          operation: "payment_rules_delete",
+          resourceId: String(params.ruleId),
+          riskLevel: "high",
+          confirmed: true,
+          message: "Payment rule deleted. Verify checkout no longer exposes the removed installment option to affected shoppers.",
+          warnings: [paymentRuleWarnings.delete],
+          before: null,
+          after: null
+        });
+      } catch (err) {
+        return handleVtexWriteError(err, `Failed to delete VTEX payment rule ${params.ruleId}`);
+      }
+    }
+  }
+}
+export {
+  paymentRulesHandler,
+  paymentRulesSchema
+};
+//# sourceMappingURL=payment-rules.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/payment-rules.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { getPaymentRule, listPaymentRules } from \"../../services/vtex/vtex-payments.js\";\nimport {\n  createPaymentRule,\n  deletePaymentRule,\n  updatePaymentRule,\n} from \"../../services/vtex/vtex-payments-write.js\";\nimport { toSnakeCaseKeys } from \"../../utils/case-conversion.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\nimport {\n  buildWriteSuccessResponse,\n  confirmationSchemaField,\n  handleVtexWriteError,\n  requireExplicitConfirmation,\n  resolveVtexWriteProfile,\n} from \"./write-helpers.js\";\n\nconst requiredProfileIdSchemaField = z\n  .string()\n  .trim()\n  .min(1)\n  .describe(\"Explicit VTEX profile id to use for this operation.\");\n\nconst positiveIntegerSchemaField = (description: string) =>\n  z.number().int().positive().describe(description);\n\nconst installmentsSchemaField = z\n  .array(\n    z.object({\n      count: positiveIntegerSchemaField(\"Installment count.\"),\n      interest: z.boolean().describe(\"Whether this installment carries interest.\"),\n    })\n  )\n  .min(1)\n  .describe(\"Installment configuration rows for the payment rule.\");\n\nconst paymentRuleWarnings = {\n  delete:\n    \"Deleting a payment rule can immediately remove installment options from checkout for affected shoppers.\",\n} as const;\n\nconst paymentRuleRowsSchema = [\n  \"id\",\n  \"commercial_condition_id\",\n  \"payment_system\",\n  \"sales_channel\",\n  \"restricted_by_condition\",\n] as const;\n\nfunction readValue(record: Record<string, unknown>, ...keys: string[]): unknown {\n  for (const key of keys) {\n    if (key in record) {\n      return record[key];\n    }\n  }\n\n  return undefined;\n}\n\nconst listActionSchema = z.object({\n  action: z.literal(\"list\"),\n  profileId: requiredProfileIdSchemaField,\n  commercialConditionId: positiveIntegerSchemaField(\n    \"Optional commercial condition filter for payment rules.\"\n  ).optional(),\n});\n\nconst getActionSchema = z.object({\n  action: z.literal(\"get\"),\n  profileId: requiredProfileIdSchemaField,\n  ruleId: positiveIntegerSchemaField(\"Positive VTEX payment rule identifier.\"),\n});\n\nconst createActionSchema = z.object({\n  action: z.literal(\"create\"),\n  profileId: requiredProfileIdSchemaField,\n  commercialConditionId: positiveIntegerSchemaField(\n    \"Commercial condition identifier linked to this payment rule.\"\n  ),\n  paymentSystem: z.string().trim().min(1).describe(\"VTEX payment system identifier.\"),\n  salesChannel: z.string().trim().min(1).optional().describe(\"Optional VTEX sales channel identifier.\"),\n  restrictedByCondition: z\n    .boolean()\n    .optional()\n    .describe(\"Whether checkout should restrict this rule to the linked commercial condition.\"),\n  installments: installmentsSchemaField,\n});\n\nconst updateActionSchema = z\n  .object({\n    action: z.literal(\"update\"),\n    profileId: requiredProfileIdSchemaField,\n    ruleId: positiveIntegerSchemaField(\"Positive VTEX payment rule identifier.\"),\n    commercialConditionId: positiveIntegerSchemaField(\n      \"Commercial condition identifier linked to this payment rule.\"\n    ).optional(),\n    paymentSystem: z.string().trim().min(1).optional().describe(\"Updated VTEX payment system identifier.\"),\n    salesChannel: z.string().trim().min(1).optional().describe(\"Updated VTEX sales channel identifier.\"),\n    restrictedByCondition: z\n      .boolean()\n      .optional()\n      .describe(\"Updated restricted-by-condition flag.\"),\n    installments: installmentsSchemaField.optional(),\n  })\n  .refine(\n    (value) =>\n      value.commercialConditionId !== undefined ||\n      value.paymentSystem !== undefined ||\n      value.salesChannel !== undefined ||\n      value.restrictedByCondition !== undefined ||\n      value.installments !== undefined,\n    {\n      message: \"At least one payment rule field must be provided.\",\n      path: [\"paymentSystem\"],\n    }\n  );\n\nconst deleteActionSchema = z.object({\n  action: z.literal(\"delete\"),\n  profileId: requiredProfileIdSchemaField,\n  ruleId: positiveIntegerSchemaField(\"Positive VTEX payment rule identifier.\"),\n  confirmed: confirmationSchemaField,\n});\n\nexport const paymentRulesSchema = z.discriminatedUnion(\"action\", [\n  listActionSchema,\n  getActionSchema,\n  createActionSchema,\n  updateActionSchema,\n  deleteActionSchema,\n]);\n\nexport async function paymentRulesHandler(params: z.infer<typeof paymentRulesSchema>) {\n  switch (params.action) {\n    case \"list\": {\n      try {\n        const rules = await listPaymentRules(params.profileId, {\n          commercialConditionId: params.commercialConditionId,\n        });\n\n        return object({\n          metadata: stripNulls({\n            total: rules.length,\n            profile_id: params.profileId,\n            filters:\n              params.commercialConditionId === undefined\n                ? undefined\n                : { commercial_condition_id: params.commercialConditionId },\n          }),\n          payment_rules_schema: paymentRuleRowsSchema,\n          payment_rules: rules.map((rule) => [\n            readValue(rule, \"id\", \"Id\"),\n            readValue(rule, \"commercialConditionId\", \"CommercialConditionId\", \"commercial_condition_id\"),\n            readValue(rule, \"paymentSystem\", \"PaymentSystem\", \"payment_system\"),\n            readValue(rule, \"salesChannel\", \"SalesChannel\", \"sales_channel\"),\n            readValue(\n              rule,\n              \"restrictedByCondition\",\n              \"RestrictedByCondition\",\n              \"restricted_by_condition\"\n            ),\n          ]),\n        });\n      } catch (err) {\n        return error(formatVtexError(err, \"Failed to list VTEX payment rules\"));\n      }\n    }\n\n    case \"get\": {\n      try {\n        const rule = await getPaymentRule(params.profileId, params.ruleId);\n\n        return object({\n          profile_id: params.profileId,\n          rule_id: params.ruleId,\n          payment_rule: toSnakeCaseKeys(rule),\n        });\n      } catch (err) {\n        return error(formatVtexError(err, `Failed to fetch VTEX payment rule ${params.ruleId}`));\n      }\n    }\n\n    case \"create\": {\n      try {\n        const profileResolution = await resolveVtexWriteProfile(params.profileId);\n        if (!profileResolution.ok) {\n          return profileResolution.response;\n        }\n\n        const created = await createPaymentRule(profileResolution.value.profileId, {\n          commercialConditionId: params.commercialConditionId,\n          paymentSystem: params.paymentSystem,\n          ...(params.salesChannel !== undefined ? { salesChannel: params.salesChannel } : {}),\n          ...(params.restrictedByCondition !== undefined\n            ? { restrictedByCondition: params.restrictedByCondition }\n            : {}),\n          installments: params.installments,\n        });\n\n        return buildWriteSuccessResponse({\n          profileId: profileResolution.value.profileId,\n          operation: \"payment_rules_create\",\n          resourceId: created.id == null ? undefined : String(created.id),\n          riskLevel: \"medium\",\n          message:\n            \"Payment rule created. Review checkout installments and condition targeting to confirm the expected shopper experience.\",\n          before: null,\n          after: created,\n        });\n      } catch (err) {\n        return handleVtexWriteError(err, \"Failed to create VTEX payment rule\");\n      }\n    }\n\n    case \"update\": {\n      try {\n        const profileResolution = await resolveVtexWriteProfile(params.profileId);\n        if (!profileResolution.ok) {\n          return profileResolution.response;\n        }\n\n        const updated = await updatePaymentRule(profileResolution.value.profileId, params.ruleId, {\n          ...(params.commercialConditionId !== undefined\n            ? { commercialConditionId: params.commercialConditionId }\n            : {}),\n          ...(params.paymentSystem !== undefined ? { paymentSystem: params.paymentSystem } : {}),\n          ...(params.salesChannel !== undefined ? { salesChannel: params.salesChannel } : {}),\n          ...(params.restrictedByCondition !== undefined\n            ? { restrictedByCondition: params.restrictedByCondition }\n            : {}),\n          ...(params.installments !== undefined ? { installments: params.installments } : {}),\n        });\n\n        return buildWriteSuccessResponse({\n          profileId: profileResolution.value.profileId,\n          operation: \"payment_rules_update\",\n          resourceId: String(params.ruleId),\n          riskLevel: \"medium\",\n          message:\n            \"Payment rule updated. Review checkout installments to confirm the expected payment options.\",\n          before: null,\n          after: updated,\n        });\n      } catch (err) {\n        return handleVtexWriteError(err, `Failed to update VTEX payment rule ${params.ruleId}`);\n      }\n    }\n\n    case \"delete\": {\n      const confirmationResponse = requireExplicitConfirmation(params.confirmed, \"payment_rules_delete\", {\n        rule_id: params.ruleId,\n        warnings: [paymentRuleWarnings.delete],\n      });\n      if (confirmationResponse) {\n        return confirmationResponse;\n      }\n\n      try {\n        const profileResolution = await resolveVtexWriteProfile(params.profileId);\n        if (!profileResolution.ok) {\n          return profileResolution.response;\n        }\n\n        await deletePaymentRule(profileResolution.value.profileId, params.ruleId);\n\n        return buildWriteSuccessResponse({\n          profileId: profileResolution.value.profileId,\n          operation: \"payment_rules_delete\",\n          resourceId: String(params.ruleId),\n          riskLevel: \"high\",\n          confirmed: true,\n          message:\n            \"Payment rule deleted. Verify checkout no longer exposes the removed installment option to affected shoppers.\",\n          warnings: [paymentRuleWarnings.delete],\n          before: null,\n          after: null,\n        });\n      } catch (err) {\n        return handleVtexWriteError(err, `Failed to delete VTEX payment rule ${params.ruleId}`);\n      }\n    }\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,gBAAgB,wBAAwB;AACjD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAC3B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,MAAM,+BAA+B,EAClC,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,qDAAqD;AAEjE,MAAM,6BAA6B,CAAC,gBAClC,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,WAAW;AAElD,MAAM,0BAA0B,EAC7B;AAAA,EACC,EAAE,OAAO;AAAA,IACP,OAAO,2BAA2B,oBAAoB;AAAA,IACtD,UAAU,EAAE,QAAQ,EAAE,SAAS,4CAA4C;AAAA,EAC7E,CAAC;AACH,EACC,IAAI,CAAC,EACL,SAAS,sDAAsD;AAElE,MAAM,sBAAsB;AAAA,EAC1B,QACE;AACJ;AAEA,MAAM,wBAAwB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,SAAS,UAAU,WAAoC,MAAyB;AAC9E,aAAW,OAAO,MAAM;AACtB,QAAI,OAAO,QAAQ;AACjB,aAAO,OAAO,GAAG;AAAA,IACnB;AAAA,EACF;AAEA,SAAO;AACT;AAEA,MAAM,mBAAmB,EAAE,OAAO;AAAA,EAChC,QAAQ,EAAE,QAAQ,MAAM;AAAA,EACxB,WAAW;AAAA,EACX,uBAAuB;AAAA,IACrB;AAAA,EACF,EAAE,SAAS;AACb,CAAC;AAED,MAAM,kBAAkB,EAAE,OAAO;AAAA,EAC/B,QAAQ,EAAE,QAAQ,KAAK;AAAA,EACvB,WAAW;AAAA,EACX,QAAQ,2BAA2B,wCAAwC;AAC7E,CAAC;AAED,MAAM,qBAAqB,EAAE,OAAO;AAAA,EAClC,QAAQ,EAAE,QAAQ,QAAQ;AAAA,EAC1B,WAAW;AAAA,EACX,uBAAuB;AAAA,IACrB;AAAA,EACF;AAAA,EACA,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,iCAAiC;AAAA,EAClF,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,yCAAyC;AAAA,EACpG,uBAAuB,EACpB,QAAQ,EACR,SAAS,EACT,SAAS,gFAAgF;AAAA,EAC5F,cAAc;AAChB,CAAC;AAED,MAAM,qBAAqB,EACxB,OAAO;AAAA,EACN,QAAQ,EAAE,QAAQ,QAAQ;AAAA,EAC1B,WAAW;AAAA,EACX,QAAQ,2BAA2B,wCAAwC;AAAA,EAC3E,uBAAuB;AAAA,IACrB;AAAA,EACF,EAAE,SAAS;AAAA,EACX,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,yCAAyC;AAAA,EACrG,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,wCAAwC;AAAA,EACnG,uBAAuB,EACpB,QAAQ,EACR,SAAS,EACT,SAAS,uCAAuC;AAAA,EACnD,cAAc,wBAAwB,SAAS;AACjD,CAAC,EACA;AAAA,EACC,CAAC,UACC,MAAM,0BAA0B,UAChC,MAAM,kBAAkB,UACxB,MAAM,iBAAiB,UACvB,MAAM,0BAA0B,UAChC,MAAM,iBAAiB;AAAA,EACzB;AAAA,IACE,SAAS;AAAA,IACT,MAAM,CAAC,eAAe;AAAA,EACxB;AACF;AAEF,MAAM,qBAAqB,EAAE,OAAO;AAAA,EAClC,QAAQ,EAAE,QAAQ,QAAQ;AAAA,EAC1B,WAAW;AAAA,EACX,QAAQ,2BAA2B,wCAAwC;AAAA,EAC3E,WAAW;AACb,CAAC;AAEM,MAAM,qBAAqB,EAAE,mBAAmB,UAAU;AAAA,EAC/D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,eAAsB,oBAAoB,QAA4C;AACpF,UAAQ,OAAO,QAAQ;AAAA,IACrB,KAAK,QAAQ;AACX,UAAI;AACF,cAAM,QAAQ,MAAM,iBAAiB,OAAO,WAAW;AAAA,UACrD,uBAAuB,OAAO;AAAA,QAChC,CAAC;AAED,eAAO,OAAO;AAAA,UACZ,UAAU,WAAW;AAAA,YACnB,OAAO,MAAM;AAAA,YACb,YAAY,OAAO;AAAA,YACnB,SACE,OAAO,0BAA0B,SAC7B,SACA,EAAE,yBAAyB,OAAO,sBAAsB;AAAA,UAChE,CAAC;AAAA,UACD,sBAAsB;AAAA,UACtB,eAAe,MAAM,IAAI,CAAC,SAAS;AAAA,YACjC,UAAU,MAAM,MAAM,IAAI;AAAA,YAC1B,UAAU,MAAM,yBAAyB,yBAAyB,yBAAyB;AAAA,YAC3F,UAAU,MAAM,iBAAiB,iBAAiB,gBAAgB;AAAA,YAClE,UAAU,MAAM,gBAAgB,gBAAgB,eAAe;AAAA,YAC/D;AAAA,cACE;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,YACF;AAAA,UACF,CAAC;AAAA,QACH,CAAC;AAAA,MACH,SAAS,KAAK;AACZ,eAAO,MAAM,gBAAgB,KAAK,mCAAmC,CAAC;AAAA,MACxE;AAAA,IACF;AAAA,IAEA,KAAK,OAAO;AACV,UAAI;AACF,cAAM,OAAO,MAAM,eAAe,OAAO,WAAW,OAAO,MAAM;AAEjE,eAAO,OAAO;AAAA,UACZ,YAAY,OAAO;AAAA,UACnB,SAAS,OAAO;AAAA,UAChB,cAAc,gBAAgB,IAAI;AAAA,QACpC,CAAC;AAAA,MACH,SAAS,KAAK;AACZ,eAAO,MAAM,gBAAgB,KAAK,qCAAqC,OAAO,MAAM,EAAE,CAAC;AAAA,MACzF;AAAA,IACF;AAAA,IAEA,KAAK,UAAU;AACb,UAAI;AACF,cAAM,oBAAoB,MAAM,wBAAwB,OAAO,SAAS;AACxE,YAAI,CAAC,kBAAkB,IAAI;AACzB,iBAAO,kBAAkB;AAAA,QAC3B;AAEA,cAAM,UAAU,MAAM,kBAAkB,kBAAkB,MAAM,WAAW;AAAA,UACzE,uBAAuB,OAAO;AAAA,UAC9B,eAAe,OAAO;AAAA,UACtB,GAAI,OAAO,iBAAiB,SAAY,EAAE,cAAc,OAAO,aAAa,IAAI,CAAC;AAAA,UACjF,GAAI,OAAO,0BAA0B,SACjC,EAAE,uBAAuB,OAAO,sBAAsB,IACtD,CAAC;AAAA,UACL,cAAc,OAAO;AAAA,QACvB,CAAC;AAED,eAAO,0BAA0B;AAAA,UAC/B,WAAW,kBAAkB,MAAM;AAAA,UACnC,WAAW;AAAA,UACX,YAAY,QAAQ,MAAM,OAAO,SAAY,OAAO,QAAQ,EAAE;AAAA,UAC9D,WAAW;AAAA,UACX,SACE;AAAA,UACF,QAAQ;AAAA,UACR,OAAO;AAAA,QACT,CAAC;AAAA,MACH,SAAS,KAAK;AACZ,eAAO,qBAAqB,KAAK,oCAAoC;AAAA,MACvE;AAAA,IACF;AAAA,IAEA,KAAK,UAAU;AACb,UAAI;AACF,cAAM,oBAAoB,MAAM,wBAAwB,OAAO,SAAS;AACxE,YAAI,CAAC,kBAAkB,IAAI;AACzB,iBAAO,kBAAkB;AAAA,QAC3B;AAEA,cAAM,UAAU,MAAM,kBAAkB,kBAAkB,MAAM,WAAW,OAAO,QAAQ;AAAA,UACxF,GAAI,OAAO,0BAA0B,SACjC,EAAE,uBAAuB,OAAO,sBAAsB,IACtD,CAAC;AAAA,UACL,GAAI,OAAO,kBAAkB,SAAY,EAAE,eAAe,OAAO,cAAc,IAAI,CAAC;AAAA,UACpF,GAAI,OAAO,iBAAiB,SAAY,EAAE,cAAc,OAAO,aAAa,IAAI,CAAC;AAAA,UACjF,GAAI,OAAO,0BAA0B,SACjC,EAAE,uBAAuB,OAAO,sBAAsB,IACtD,CAAC;AAAA,UACL,GAAI,OAAO,iBAAiB,SAAY,EAAE,cAAc,OAAO,aAAa,IAAI,CAAC;AAAA,QACnF,CAAC;AAED,eAAO,0BAA0B;AAAA,UAC/B,WAAW,kBAAkB,MAAM;AAAA,UACnC,WAAW;AAAA,UACX,YAAY,OAAO,OAAO,MAAM;AAAA,UAChC,WAAW;AAAA,UACX,SACE;AAAA,UACF,QAAQ;AAAA,UACR,OAAO;AAAA,QACT,CAAC;AAAA,MACH,SAAS,KAAK;AACZ,eAAO,qBAAqB,KAAK,sCAAsC,OAAO,MAAM,EAAE;AAAA,MACxF;AAAA,IACF;AAAA,IAEA,KAAK,UAAU;AACb,YAAM,uBAAuB,4BAA4B,OAAO,WAAW,wBAAwB;AAAA,QACjG,SAAS,OAAO;AAAA,QAChB,UAAU,CAAC,oBAAoB,MAAM;AAAA,MACvC,CAAC;AACD,UAAI,sBAAsB;AACxB,eAAO;AAAA,MACT;AAEA,UAAI;AACF,cAAM,oBAAoB,MAAM,wBAAwB,OAAO,SAAS;AACxE,YAAI,CAAC,kBAAkB,IAAI;AACzB,iBAAO,kBAAkB;AAAA,QAC3B;AAEA,cAAM,kBAAkB,kBAAkB,MAAM,WAAW,OAAO,MAAM;AAExE,eAAO,0BAA0B;AAAA,UAC/B,WAAW,kBAAkB,MAAM;AAAA,UACnC,WAAW;AAAA,UACX,YAAY,OAAO,OAAO,MAAM;AAAA,UAChC,WAAW;AAAA,UACX,WAAW;AAAA,UACX,SACE;AAAA,UACF,UAAU,CAAC,oBAAoB,MAAM;AAAA,UACrC,QAAQ;AAAA,UACR,OAAO;AAAA,QACT,CAAC;AAAA,MACH,SAAS,KAAK;AACZ,eAAO,qBAAqB,KAAK,sCAAsC,OAAO,MAAM,EAAE;AAAA,MACxF;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/tests/vtex/vtex-commercial-conditions-docs.test.js

@@ -0,0 +1,26 @@
+import { readFile } from "node:fs/promises";
+import { describe, expect, it } from "vitest";
+describe("VTEX commercial conditions documentation", () => {
+  it("documents the new VTEX payments capability across project docs", async () => {
+    const projectStatus = await readFile(new URL("../../docs/PROJECT_STATUS.md", import.meta.url), "utf8");
+    const keyEndpoints = await readFile(
+      new URL("../../src/services/vtex/docs/vtex-key-endpoints.md", import.meta.url),
+      "utf8"
+    );
+    const dashboardCapabilities = await readFile(
+      new URL("../../../bi-mcp-dashboard/docs/content/CAPACIDADES_MCP.md", import.meta.url),
+      "utf8"
+    );
+    expect(projectStatus).toContain("`35` tools VTEX.");
+    expect(projectStatus).toContain("condiciones comerciales y reglas de pago");
+    expect(keyEndpoints).toContain("Legacy payments endpoints exposed with sandbox caveat");
+    expect(keyEndpoints).toContain("`vtex_commercial_conditions`");
+    expect(keyEndpoints).toContain("`vtex_payment_rules`");
+    expect(dashboardCapabilities).toContain(
+      "Gesti\xF3n de Condiciones Comerciales y Reglas de Pago"
+    );
+    expect(dashboardCapabilities).toContain("`vtex_commercial_conditions`");
+    expect(dashboardCapabilities).toContain("`vtex_payment_rules`");
+  });
+});
+//# sourceMappingURL=vtex-commercial-conditions-docs.test.js.map