@yoryoboy/bi-mcp 1.2.0 → 1.3.0

package/dist/src/tools/vtex/invoice-order.js

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import {
+  getOrderStateSnapshot,
+  invoiceOrder,
+  validateOrderForInvoice
+} from "../../services/vtex/vtex-orders-write.js";
+import {
+  buildWriteSuccessResponse,
+  confirmationNoteSchemaField,
+  confirmationSchemaField,
+  handleVtexWriteError,
+  requireExplicitConfirmation,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const invoiceItemSchema = z.object({
+  id: z.string().min(1).describe("SKU ID being invoiced."),
+  price: z.number().int().positive().describe("Unit price in cents, without decimal separator."),
+  quantity: z.number().int().positive().describe("Quantity being invoiced."),
+  description: z.string().optional().describe("Optional extra description for this line.")
+});
+const invoiceOrderSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  orderId: z.string().min(1).describe("VTEX order identifier to invoice."),
+  confirmed: confirmationSchemaField,
+  confirmationNote: confirmationNoteSchemaField,
+  type: z.enum(["Output", "Input"]).describe("Invoice type."),
+  issuanceDate: z.string().min(1).describe("Invoice issuance timestamp."),
+  invoiceNumber: z.string().min(1).describe("Invoice number."),
+  invoiceValue: z.string().min(1).describe("Invoice total in cents, represented as a string without decimal separator."),
+  items: z.array(invoiceItemSchema).min(1).describe("Items being invoiced."),
+  invoiceKey: z.string().optional().describe("Optional invoice key."),
+  invoiceUrl: z.string().url().optional().describe("Optional invoice URL."),
+  invoiceOrderNumber: z.string().optional().describe("Optional order number from merchant ERP."),
+  courier: z.string().optional().describe("Optional carrier name."),
+  trackingNumber: z.string().optional().describe("Optional tracking number."),
+  trackingUrl: z.string().url().optional().describe("Optional tracking URL.")
+});
+async function invoiceOrderHandler({
+  profileId,
+  orderId,
+  confirmed,
+  confirmationNote,
+  ...payload
+}) {
+  const confirmationResponse = requireExplicitConfirmation(confirmed, "invoice_order", {
+    order_id: orderId
+  });
+  if (confirmationResponse) {
+    return confirmationResponse;
+  }
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const beforeOrder = await validateOrderForInvoice(resolvedProfileId, orderId);
+    await invoiceOrder(resolvedProfileId, orderId, payload);
+    const afterOrder = await getOrderStateSnapshot(resolvedProfileId, orderId);
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "invoice_order",
+      resourceId: orderId,
+      riskLevel: "high",
+      confirmed: true,
+      confirmationNote,
+      message: "Order invoiced successfully.",
+      before: beforeOrder,
+      after: afterOrder,
+      details: {
+        order_id: orderId,
+        invoice_number: payload.invoiceNumber
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, `Failed to invoice order ${orderId}`);
+  }
+}
+export {
+  invoiceOrderHandler,
+  invoiceOrderSchema
+};
+//# sourceMappingURL=invoice-order.js.map

package/dist/src/tools/vtex/invoice-order.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/invoice-order.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  getOrderStateSnapshot,\n  invoiceOrder,\n  validateOrderForInvoice,\n} from \"../../services/vtex/vtex-orders-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  confirmationNoteSchemaField,\n  confirmationSchemaField,\n  handleVtexWriteError,\n  requireExplicitConfirmation,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nconst invoiceItemSchema = z.object({\n  id: z.string().min(1).describe(\"SKU ID being invoiced.\"),\n  price: z\n    .number()\n    .int()\n    .positive()\n    .describe(\"Unit price in cents, without decimal separator.\"),\n  quantity: z.number().int().positive().describe(\"Quantity being invoiced.\"),\n  description: z.string().optional().describe(\"Optional extra description for this line.\"),\n});\n\nexport const invoiceOrderSchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  orderId: z.string().min(1).describe(\"VTEX order identifier to invoice.\"),\n  confirmed: confirmationSchemaField,\n  confirmationNote: confirmationNoteSchemaField,\n  type: z.enum([\"Output\", \"Input\"]).describe(\"Invoice type.\"),\n  issuanceDate: z.string().min(1).describe(\"Invoice issuance timestamp.\"),\n  invoiceNumber: z.string().min(1).describe(\"Invoice number.\"),\n  invoiceValue: z\n    .string()\n    .min(1)\n    .describe(\"Invoice total in cents, represented as a string without decimal separator.\"),\n  items: z.array(invoiceItemSchema).min(1).describe(\"Items being invoiced.\"),\n  invoiceKey: z.string().optional().describe(\"Optional invoice key.\"),\n  invoiceUrl: z.string().url().optional().describe(\"Optional invoice URL.\"),\n  invoiceOrderNumber: z.string().optional().describe(\"Optional order number from merchant ERP.\"),\n  courier: z.string().optional().describe(\"Optional carrier name.\"),\n  trackingNumber: z.string().optional().describe(\"Optional tracking number.\"),\n  trackingUrl: z.string().url().optional().describe(\"Optional tracking URL.\"),\n});\n\nexport async function invoiceOrderHandler({\n  profileId,\n  orderId,\n  confirmed,\n  confirmationNote,\n  ...payload\n}: z.infer<typeof invoiceOrderSchema>) {\n  const confirmationResponse = requireExplicitConfirmation(confirmed, \"invoice_order\", {\n    order_id: orderId,\n  });\n  if (confirmationResponse) {\n    return confirmationResponse;\n  }\n\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 beforeOrder = await validateOrderForInvoice(resolvedProfileId, orderId);\n    await invoiceOrder(resolvedProfileId, orderId, payload);\n    const afterOrder = await getOrderStateSnapshot(resolvedProfileId, orderId);\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"invoice_order\",\n      resourceId: orderId,\n      riskLevel: \"high\",\n      confirmed: true,\n      confirmationNote,\n      message: \"Order invoiced successfully.\",\n      before: beforeOrder as unknown as Record<string, unknown>,\n      after: afterOrder as unknown as Record<string, unknown>,\n      details: {\n        order_id: orderId,\n        invoice_number: payload.invoiceNumber,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, `Failed to invoice order ${orderId}`);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,MAAM,oBAAoB,EAAE,OAAO;AAAA,EACjC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,wBAAwB;AAAA,EACvD,OAAO,EACJ,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,iDAAiD;AAAA,EAC7D,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,0BAA0B;AAAA,EACzE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,2CAA2C;AACzF,CAAC;AAEM,MAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,WAAW;AAAA,EACX,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,mCAAmC;AAAA,EACvE,WAAW;AAAA,EACX,kBAAkB;AAAA,EAClB,MAAM,EAAE,KAAK,CAAC,UAAU,OAAO,CAAC,EAAE,SAAS,eAAe;AAAA,EAC1D,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,6BAA6B;AAAA,EACtE,eAAe,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,iBAAiB;AAAA,EAC3D,cAAc,EACX,OAAO,EACP,IAAI,CAAC,EACL,SAAS,4EAA4E;AAAA,EACxF,OAAO,EAAE,MAAM,iBAAiB,EAAE,IAAI,CAAC,EAAE,SAAS,uBAAuB;AAAA,EACzE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,uBAAuB;AAAA,EAClE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,uBAAuB;AAAA,EACxE,oBAAoB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,0CAA0C;AAAA,EAC7F,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,wBAAwB;AAAA,EAChE,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,2BAA2B;AAAA,EAC1E,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,wBAAwB;AAC5E,CAAC;AAED,eAAsB,oBAAoB;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAuC;AACrC,QAAM,uBAAuB,4BAA4B,WAAW,iBAAiB;AAAA,IACnF,UAAU;AAAA,EACZ,CAAC;AACD,MAAI,sBAAsB;AACxB,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,oBAAoB,MAAM,wBAAwB,SAAS;AACjE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,cAAc,MAAM,wBAAwB,mBAAmB,OAAO;AAC5E,UAAM,aAAa,mBAAmB,SAAS,OAAO;AACtD,UAAM,aAAa,MAAM,sBAAsB,mBAAmB,OAAO;AAEzE,WAAO,0BAA0B;AAAA,MAC/B,WAAW;AAAA,MACX,WAAW;AAAA,MACX,YAAY;AAAA,MACZ,WAAW;AAAA,MACX,WAAW;AAAA,MACX;AAAA,MACA,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,OAAO;AAAA,MACP,SAAS;AAAA,QACP,UAAU;AAAA,QACV,gBAAgB,QAAQ;AAAA,MAC1B;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,qBAAqB,KAAK,2BAA2B,OAAO,EAAE;AAAA,EACvE;AACF;",
+  "names": []
+}

package/dist/src/tools/vtex/toggle-unlimited-quantity.js

@@ -0,0 +1,65 @@
+import { z } from "zod";
+import {
+  getInventoryByWarehouse,
+  updateInventoryQuantity
+} from "../../services/vtex/vtex-logistics.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const toggleUnlimitedQuantitySchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  skuId: z.string().min(1).describe("SKU identifier."),
+  warehouseId: z.string().min(1).describe("Warehouse identifier."),
+  unlimitedQuantity: z.boolean().describe("New unlimited availability mode for this SKU in the selected warehouse.")
+});
+async function toggleUnlimitedQuantityHandler({
+  profileId,
+  skuId,
+  warehouseId,
+  unlimitedQuantity
+}) {
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const beforeInventory = await getInventoryByWarehouse(resolvedProfileId, skuId, warehouseId);
+    const currentInventory = beforeInventory[0];
+    if (!currentInventory) {
+      throw new Error(`Inventory record not found for SKU ${skuId} in warehouse ${warehouseId}`);
+    }
+    await updateInventoryQuantity(resolvedProfileId, skuId, warehouseId, {
+      quantity: Number(currentInventory.totalQuantity ?? 0),
+      unlimitedQuantity
+    });
+    const afterInventory = await getInventoryByWarehouse(resolvedProfileId, skuId, warehouseId);
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "toggle_unlimited_quantity",
+      resourceId: skuId,
+      riskLevel: "low",
+      message: "Unlimited quantity mode updated successfully.",
+      before: currentInventory,
+      after: afterInventory[0] ?? null,
+      details: {
+        sku_id: skuId,
+        warehouse_id: warehouseId,
+        unlimited_quantity: unlimitedQuantity
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(
+      err,
+      `Failed to update unlimited quantity mode for SKU ${skuId} in ${warehouseId}`
+    );
+  }
+}
+export {
+  toggleUnlimitedQuantityHandler,
+  toggleUnlimitedQuantitySchema
+};
+//# sourceMappingURL=toggle-unlimited-quantity.js.map

package/dist/src/tools/vtex/toggle-unlimited-quantity.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/toggle-unlimited-quantity.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  getInventoryByWarehouse,\n  updateInventoryQuantity,\n} from \"../../services/vtex/vtex-logistics.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nexport const toggleUnlimitedQuantitySchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  skuId: z.string().min(1).describe(\"SKU identifier.\"),\n  warehouseId: z.string().min(1).describe(\"Warehouse identifier.\"),\n  unlimitedQuantity: z\n    .boolean()\n    .describe(\"New unlimited availability mode for this SKU in the selected warehouse.\"),\n});\n\nexport async function toggleUnlimitedQuantityHandler({\n  profileId,\n  skuId,\n  warehouseId,\n  unlimitedQuantity,\n}: z.infer<typeof toggleUnlimitedQuantitySchema>) {\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 beforeInventory = await getInventoryByWarehouse(resolvedProfileId, skuId, warehouseId);\n    const currentInventory = beforeInventory[0];\n\n    if (!currentInventory) {\n      throw new Error(`Inventory record not found for SKU ${skuId} in warehouse ${warehouseId}`);\n    }\n\n    await updateInventoryQuantity(resolvedProfileId, skuId, warehouseId, {\n      quantity: Number(currentInventory.totalQuantity ?? 0),\n      unlimitedQuantity,\n    });\n\n    const afterInventory = await getInventoryByWarehouse(resolvedProfileId, skuId, warehouseId);\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"toggle_unlimited_quantity\",\n      resourceId: skuId,\n      riskLevel: \"low\",\n      message: \"Unlimited quantity mode updated successfully.\",\n      before: currentInventory as Record<string, unknown>,\n      after: (afterInventory[0] as Record<string, unknown> | undefined) ?? null,\n      details: {\n        sku_id: skuId,\n        warehouse_id: warehouseId,\n        unlimited_quantity: unlimitedQuantity,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(\n      err,\n      `Failed to update unlimited quantity mode for SKU ${skuId} in ${warehouseId}`\n    );\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,gCAAgC,EAAE,OAAO;AAAA,EACpD,WAAW;AAAA,EACX,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,iBAAiB;AAAA,EACnD,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,uBAAuB;AAAA,EAC/D,mBAAmB,EAChB,QAAQ,EACR,SAAS,yEAAyE;AACvF,CAAC;AAED,eAAsB,+BAA+B;AAAA,EACnD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAkD;AAChD,MAAI;AACF,UAAM,oBAAoB,MAAM,wBAAwB,SAAS;AACjE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,kBAAkB,MAAM,wBAAwB,mBAAmB,OAAO,WAAW;AAC3F,UAAM,mBAAmB,gBAAgB,CAAC;AAE1C,QAAI,CAAC,kBAAkB;AACrB,YAAM,IAAI,MAAM,sCAAsC,KAAK,iBAAiB,WAAW,EAAE;AAAA,IAC3F;AAEA,UAAM,wBAAwB,mBAAmB,OAAO,aAAa;AAAA,MACnE,UAAU,OAAO,iBAAiB,iBAAiB,CAAC;AAAA,MACpD;AAAA,IACF,CAAC;AAED,UAAM,iBAAiB,MAAM,wBAAwB,mBAAmB,OAAO,WAAW;AAE1F,WAAO,0BAA0B;AAAA,MAC/B,WAAW;AAAA,MACX,WAAW;AAAA,MACX,YAAY;AAAA,MACZ,WAAW;AAAA,MACX,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,OAAQ,eAAe,CAAC,KAA6C;AAAA,MACrE,SAAS;AAAA,QACP,QAAQ;AAAA,QACR,cAAc;AAAA,QACd,oBAAoB;AAAA,MACtB;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO;AAAA,MACL;AAAA,MACA,oDAAoD,KAAK,OAAO,WAAW;AAAA,IAC7E;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/src/tools/vtex/update-inventory.js

@@ -1,16 +1,22 @@
-import { error, object } from "mcp-use/server";
 import { z } from "zod";
-import { formatVtexError } from "../../services/vtex/vtex-api.js";
-import { updateInventoryQuantity } from "../../services/vtex/vtex-logistics.js";
-import { resolveVtexProfileOrSelection } from "./profile-resolution.js";
+import {
+  getInventoryByWarehouse,
+  updateInventoryQuantity
+} from "../../services/vtex/vtex-logistics.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
 const updateInventorySchema = z.object({
-  profileId: z.string().trim().min(1).optional().describe(
-    "Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles."
-  ),
+  profileId: vtexProfileIdSchemaField,
   skuId: z.string().min(1).describe("SKU identifier"),
   warehouseId: z.string().min(1).describe("Warehouse identifier"),
   quantity: z.number().int().min(0).describe("Inventory quantity to set"),
-  unlimitedQuantity: z.boolean().describe("When true, SKU remains available regardless of stock quantity"),
+  unlimitedQuantity: z.boolean().describe(
+    "When true, VTEX keeps the SKU available regardless of stock. This overwrites the current unlimited mode for the SKU in the selected warehouse."
+  ),
   dateUtcOnBalanceSystem: z.string().optional().describe("Optional UTC timestamp for inventory update synchronization")
 });
 async function updateInventoryHandler({
@@ -22,28 +28,37 @@ async function updateInventoryHandler({
   dateUtcOnBalanceSystem
 }) {
   try {
-    const profileResolution = await resolveVtexProfileOrSelection(profileId);
+    const profileResolution = await resolveVtexWriteProfile(profileId);
     if (!profileResolution.ok) {
       return profileResolution.response;
     }
     const resolvedProfileId = profileResolution.value.profileId;
+    const beforeInventory = await getInventoryByWarehouse(resolvedProfileId, skuId, warehouseId);
     await updateInventoryQuantity(resolvedProfileId, skuId, warehouseId, {
       quantity,
       unlimitedQuantity,
       dateUtcOnBalanceSystem
     });
-    return object({
-      success: true,
-      profile_id: resolvedProfileId,
-      sku_id: skuId,
-      warehouse_id: warehouseId,
-      quantity,
-      unlimited_quantity: unlimitedQuantity,
-      message: "Inventory quantity updated successfully"
+    const afterInventory = await getInventoryByWarehouse(resolvedProfileId, skuId, warehouseId);
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "update_inventory",
+      resourceId: skuId,
+      riskLevel: "low",
+      message: "Inventory quantity updated successfully.",
+      before: beforeInventory[0] ?? null,
+      after: afterInventory[0] ?? null,
+      details: {
+        sku_id: skuId,
+        warehouse_id: warehouseId,
+        quantity,
+        unlimited_quantity: unlimitedQuantity
+      }
     });
   } catch (err) {
-    return error(
-      formatVtexError(err, `Failed to update inventory quantity for SKU ${skuId} in ${warehouseId}`)
+    return handleVtexWriteError(
+      err,
+      `Failed to update inventory quantity for SKU ${skuId} in ${warehouseId}`
     );
   }
 }

package/dist/src/tools/vtex/update-inventory.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/vtex/update-inventory.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { updateInventoryQuantity } from \"../../services/vtex/vtex-logistics.js\";\nimport { resolveVtexProfileOrSelection } from \"./profile-resolution.js\";\n\nexport const updateInventorySchema = z.object({\n  profileId: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\n      \"Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles.\"\n    ),\n  skuId: z.string().min(1).describe(\"SKU identifier\"),\n  warehouseId: z.string().min(1).describe(\"Warehouse identifier\"),\n  quantity: z.number().int().min(0).describe(\"Inventory quantity to set\"),\n  unlimitedQuantity: z\n    .boolean()\n    .describe(\"When true, SKU remains available regardless of stock quantity\"),\n  dateUtcOnBalanceSystem: z\n    .string()\n    .optional()\n    .describe(\"Optional UTC timestamp for inventory update synchronization\"),\n});\n\nexport async function updateInventoryHandler({\n  profileId,\n  skuId,\n  warehouseId,\n  quantity,\n  unlimitedQuantity,\n  dateUtcOnBalanceSystem,\n}: z.infer<typeof updateInventorySchema>) {\n  try {\n    const profileResolution = await resolveVtexProfileOrSelection(profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const resolvedProfileId = profileResolution.value.profileId;\n\n    await updateInventoryQuantity(resolvedProfileId, skuId, warehouseId, {\n      quantity,\n      unlimitedQuantity,\n      dateUtcOnBalanceSystem,\n    });\n\n    return object({\n      success: true,\n      profile_id: resolvedProfileId,\n      sku_id: skuId,\n      warehouse_id: warehouseId,\n      quantity,\n      unlimited_quantity: unlimitedQuantity,\n      message: \"Inventory quantity updated successfully\",\n    });\n  } catch (err) {\n    return error(\n      formatVtexError(err, `Failed to update inventory quantity for SKU ${skuId} in ${warehouseId}`)\n    );\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,+BAA+B;AACxC,SAAS,qCAAqC;AAEvC,MAAM,wBAAwB,EAAE,OAAO;AAAA,EAC5C,WAAW,EACR,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,gBAAgB;AAAA,EAClD,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,sBAAsB;AAAA,EAC9D,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,SAAS,2BAA2B;AAAA,EACtE,mBAAmB,EAChB,QAAQ,EACR,SAAS,+DAA+D;AAAA,EAC3E,wBAAwB,EACrB,OAAO,EACP,SAAS,EACT,SAAS,6DAA6D;AAC3E,CAAC;AAED,eAAsB,uBAAuB;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA0C;AACxC,MAAI;AACF,UAAM,oBAAoB,MAAM,8BAA8B,SAAS;AACvE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAElD,UAAM,wBAAwB,mBAAmB,OAAO,aAAa;AAAA,MACnE;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,WAAO,OAAO;AAAA,MACZ,SAAS;AAAA,MACT,YAAY;AAAA,MACZ,QAAQ;AAAA,MACR,cAAc;AAAA,MACd;AAAA,MACA,oBAAoB;AAAA,MACpB,SAAS;AAAA,IACX,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,gBAAgB,KAAK,+CAA+C,KAAK,OAAO,WAAW,EAAE;AAAA,IAC/F;AAAA,EACF;AACF;",
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  getInventoryByWarehouse,\n  updateInventoryQuantity,\n} from \"../../services/vtex/vtex-logistics.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nexport const updateInventorySchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  skuId: z.string().min(1).describe(\"SKU identifier\"),\n  warehouseId: z.string().min(1).describe(\"Warehouse identifier\"),\n  quantity: z.number().int().min(0).describe(\"Inventory quantity to set\"),\n  unlimitedQuantity: z\n    .boolean()\n    .describe(\n      \"When true, VTEX keeps the SKU available regardless of stock. This overwrites the current unlimited mode for the SKU in the selected warehouse.\"\n    ),\n  dateUtcOnBalanceSystem: z\n    .string()\n    .optional()\n    .describe(\"Optional UTC timestamp for inventory update synchronization\"),\n});\n\nexport async function updateInventoryHandler({\n  profileId,\n  skuId,\n  warehouseId,\n  quantity,\n  unlimitedQuantity,\n  dateUtcOnBalanceSystem,\n}: z.infer<typeof updateInventorySchema>) {\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 beforeInventory = await getInventoryByWarehouse(resolvedProfileId, skuId, warehouseId);\n\n    await updateInventoryQuantity(resolvedProfileId, skuId, warehouseId, {\n      quantity,\n      unlimitedQuantity,\n      dateUtcOnBalanceSystem,\n    });\n\n    const afterInventory = await getInventoryByWarehouse(resolvedProfileId, skuId, warehouseId);\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"update_inventory\",\n      resourceId: skuId,\n      riskLevel: \"low\",\n      message: \"Inventory quantity updated successfully.\",\n      before: (beforeInventory[0] as Record<string, unknown> | undefined) ?? null,\n      after: (afterInventory[0] as Record<string, unknown> | undefined) ?? null,\n      details: {\n        sku_id: skuId,\n        warehouse_id: warehouseId,\n        quantity,\n        unlimited_quantity: unlimitedQuantity,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(\n      err,\n      `Failed to update inventory quantity for SKU ${skuId} in ${warehouseId}`\n    );\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,wBAAwB,EAAE,OAAO;AAAA,EAC5C,WAAW;AAAA,EACX,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,gBAAgB;AAAA,EAClD,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,sBAAsB;AAAA,EAC9D,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,SAAS,2BAA2B;AAAA,EACtE,mBAAmB,EAChB,QAAQ,EACR;AAAA,IACC;AAAA,EACF;AAAA,EACF,wBAAwB,EACrB,OAAO,EACP,SAAS,EACT,SAAS,6DAA6D;AAC3E,CAAC;AAED,eAAsB,uBAAuB;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA0C;AACxC,MAAI;AACF,UAAM,oBAAoB,MAAM,wBAAwB,SAAS;AACjE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,kBAAkB,MAAM,wBAAwB,mBAAmB,OAAO,WAAW;AAE3F,UAAM,wBAAwB,mBAAmB,OAAO,aAAa;AAAA,MACnE;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,UAAM,iBAAiB,MAAM,wBAAwB,mBAAmB,OAAO,WAAW;AAE1F,WAAO,0BAA0B;AAAA,MAC/B,WAAW;AAAA,MACX,WAAW;AAAA,MACX,YAAY;AAAA,MACZ,WAAW;AAAA,MACX,SAAS;AAAA,MACT,QAAS,gBAAgB,CAAC,KAA6C;AAAA,MACvE,OAAQ,eAAe,CAAC,KAA6C;AAAA,MACrE,SAAS;AAAA,QACP,QAAQ;AAAA,QACR,cAAc;AAAA,QACd;AAAA,QACA,oBAAoB;AAAA,MACtB;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO;AAAA,MACL;AAAA,MACA,+CAA+C,KAAK,OAAO,WAAW;AAAA,IACxE;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/src/tools/vtex/update-lead-time.js

@@ -1,15 +1,21 @@
-import { error, object } from "mcp-use/server";
 import { z } from "zod";
-import { formatVtexError } from "../../services/vtex/vtex-api.js";
-import { updateInventoryLeadTime } from "../../services/vtex/vtex-logistics.js";
-import { resolveVtexProfileOrSelection } from "./profile-resolution.js";
+import {
+  getInventoryByWarehouse,
+  updateInventoryLeadTime
+} from "../../services/vtex/vtex-logistics.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
 const updateLeadTimeSchema = z.object({
-  profileId: z.string().trim().min(1).optional().describe(
-    "Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles."
-  ),
+  profileId: vtexProfileIdSchemaField,
   skuId: z.string().min(1).describe("SKU identifier"),
   warehouseId: z.string().min(1).describe("Warehouse identifier"),
-  leadTime: z.string().min(1).describe("Lead time value for the SKU in VTEX expected format (e.g. 1.00:00:00)")
+  leadTime: z.string().min(1).describe(
+    "Lead time value for the SKU in VTEX expected format (for example `1.00:00:00`). This overwrites the current lead time for the selected warehouse."
+  )
 });
 async function updateLeadTimeHandler({
   profileId,
@@ -18,22 +24,33 @@ async function updateLeadTimeHandler({
   leadTime
 }) {
   try {
-    const profileResolution = await resolveVtexProfileOrSelection(profileId);
+    const profileResolution = await resolveVtexWriteProfile(profileId);
     if (!profileResolution.ok) {
       return profileResolution.response;
     }
     const resolvedProfileId = profileResolution.value.profileId;
+    const beforeInventory = await getInventoryByWarehouse(resolvedProfileId, skuId, warehouseId);
     await updateInventoryLeadTime(resolvedProfileId, skuId, warehouseId, { leadTime });
-    return object({
-      success: true,
-      profile_id: resolvedProfileId,
-      sku_id: skuId,
-      warehouse_id: warehouseId,
-      lead_time: leadTime,
-      message: "Lead time updated successfully"
+    const afterInventory = await getInventoryByWarehouse(resolvedProfileId, skuId, warehouseId);
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "update_lead_time",
+      resourceId: skuId,
+      riskLevel: "low",
+      message: "Lead time updated successfully.",
+      before: beforeInventory[0] ?? null,
+      after: afterInventory[0] ?? null,
+      details: {
+        sku_id: skuId,
+        warehouse_id: warehouseId,
+        lead_time: leadTime
+      }
     });
   } catch (err) {
-    return error(formatVtexError(err, `Failed to update lead time for SKU ${skuId} in ${warehouseId}`));
+    return handleVtexWriteError(
+      err,
+      `Failed to update lead time for SKU ${skuId} in ${warehouseId}`
+    );
   }
 }
 export {

package/dist/src/tools/vtex/update-lead-time.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/tools/vtex/update-lead-time.ts"],
-  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { formatVtexError } from \"../../services/vtex/vtex-api.js\";\nimport { updateInventoryLeadTime } from \"../../services/vtex/vtex-logistics.js\";\nimport { resolveVtexProfileOrSelection } from \"./profile-resolution.js\";\n\nexport const updateLeadTimeSchema = z.object({\n  profileId: z\n    .string()\n    .trim()\n    .min(1)\n    .optional()\n    .describe(\n      \"Explicit VTEX profile id to use. If omitted, the tool returns a guided selection payload with available active profiles.\"\n    ),\n  skuId: z.string().min(1).describe(\"SKU identifier\"),\n  warehouseId: z.string().min(1).describe(\"Warehouse identifier\"),\n  leadTime: z\n    .string()\n    .min(1)\n    .describe(\"Lead time value for the SKU in VTEX expected format (e.g. 1.00:00:00)\"),\n});\n\nexport async function updateLeadTimeHandler({\n  profileId,\n  skuId,\n  warehouseId,\n  leadTime,\n}: z.infer<typeof updateLeadTimeSchema>) {\n  try {\n    const profileResolution = await resolveVtexProfileOrSelection(profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const resolvedProfileId = profileResolution.value.profileId;\n    await updateInventoryLeadTime(resolvedProfileId, skuId, warehouseId, { leadTime });\n\n    return object({\n      success: true,\n      profile_id: resolvedProfileId,\n      sku_id: skuId,\n      warehouse_id: warehouseId,\n      lead_time: leadTime,\n      message: \"Lead time updated successfully\",\n    });\n  } catch (err) {\n    return error(formatVtexError(err, `Failed to update lead time for SKU ${skuId} in ${warehouseId}`));\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,uBAAuB;AAChC,SAAS,+BAA+B;AACxC,SAAS,qCAAqC;AAEvC,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,WAAW,EACR,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,gBAAgB;AAAA,EAClD,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,sBAAsB;AAAA,EAC9D,UAAU,EACP,OAAO,EACP,IAAI,CAAC,EACL,SAAS,uEAAuE;AACrF,CAAC;AAED,eAAsB,sBAAsB;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAyC;AACvC,MAAI;AACF,UAAM,oBAAoB,MAAM,8BAA8B,SAAS;AACvE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,wBAAwB,mBAAmB,OAAO,aAAa,EAAE,SAAS,CAAC;AAEjF,WAAO,OAAO;AAAA,MACZ,SAAS;AAAA,MACT,YAAY;AAAA,MACZ,QAAQ;AAAA,MACR,cAAc;AAAA,MACd,WAAW;AAAA,MACX,SAAS;AAAA,IACX,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,MAAM,gBAAgB,KAAK,sCAAsC,KAAK,OAAO,WAAW,EAAE,CAAC;AAAA,EACpG;AACF;",
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  getInventoryByWarehouse,\n  updateInventoryLeadTime,\n} from \"../../services/vtex/vtex-logistics.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nexport const updateLeadTimeSchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  skuId: z.string().min(1).describe(\"SKU identifier\"),\n  warehouseId: z.string().min(1).describe(\"Warehouse identifier\"),\n  leadTime: z\n    .string()\n    .min(1)\n    .describe(\n      \"Lead time value for the SKU in VTEX expected format (for example `1.00:00:00`). This overwrites the current lead time for the selected warehouse.\"\n    ),\n});\n\nexport async function updateLeadTimeHandler({\n  profileId,\n  skuId,\n  warehouseId,\n  leadTime,\n}: z.infer<typeof updateLeadTimeSchema>) {\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 beforeInventory = await getInventoryByWarehouse(resolvedProfileId, skuId, warehouseId);\n    await updateInventoryLeadTime(resolvedProfileId, skuId, warehouseId, { leadTime });\n    const afterInventory = await getInventoryByWarehouse(resolvedProfileId, skuId, warehouseId);\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"update_lead_time\",\n      resourceId: skuId,\n      riskLevel: \"low\",\n      message: \"Lead time updated successfully.\",\n      before: (beforeInventory[0] as Record<string, unknown> | undefined) ?? null,\n      after: (afterInventory[0] as Record<string, unknown> | undefined) ?? null,\n      details: {\n        sku_id: skuId,\n        warehouse_id: warehouseId,\n        lead_time: leadTime,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(\n      err,\n      `Failed to update lead time for SKU ${skuId} in ${warehouseId}`\n    );\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,WAAW;AAAA,EACX,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,gBAAgB;AAAA,EAClD,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,sBAAsB;AAAA,EAC9D,UAAU,EACP,OAAO,EACP,IAAI,CAAC,EACL;AAAA,IACC;AAAA,EACF;AACJ,CAAC;AAED,eAAsB,sBAAsB;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAyC;AACvC,MAAI;AACF,UAAM,oBAAoB,MAAM,wBAAwB,SAAS;AACjE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,kBAAkB,MAAM,wBAAwB,mBAAmB,OAAO,WAAW;AAC3F,UAAM,wBAAwB,mBAAmB,OAAO,aAAa,EAAE,SAAS,CAAC;AACjF,UAAM,iBAAiB,MAAM,wBAAwB,mBAAmB,OAAO,WAAW;AAE1F,WAAO,0BAA0B;AAAA,MAC/B,WAAW;AAAA,MACX,WAAW;AAAA,MACX,YAAY;AAAA,MACZ,WAAW;AAAA,MACX,SAAS;AAAA,MACT,QAAS,gBAAgB,CAAC,KAA6C;AAAA,MACvE,OAAQ,eAAe,CAAC,KAA6C;AAAA,MACrE,SAAS;AAAA,QACP,QAAQ;AAAA,QACR,cAAc;AAAA,QACd,WAAW;AAAA,MACb;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO;AAAA,MACL;AAAA,MACA,sCAAsC,KAAK,OAAO,WAAW;AAAA,IAC/D;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/src/tools/vtex/update-product-basic-fields.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import {
+  buildProductUpdatePayload,
+  getProduct,
+  updateProduct
+} from "../../services/vtex/vtex-catalog-write.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const updateProductBasicFieldsSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  productId: z.string().min(1).describe("VTEX product identifier."),
+  name: z.string().min(1).optional().describe("New product name."),
+  categoryId: z.number().int().positive().optional().describe("New category identifier."),
+  brandId: z.number().int().positive().optional().describe("New brand identifier."),
+  description: z.string().optional().describe("New product description."),
+  descriptionShort: z.string().optional().describe("New short description."),
+  title: z.string().optional().describe("New SEO title."),
+  linkId: z.string().optional().describe("New product slug."),
+  refId: z.string().optional().describe("New internal reference code."),
+  isVisible: z.boolean().optional().describe("Whether the product should remain visible in listings."),
+  isActive: z.boolean().optional().describe("Whether the product should remain active."),
+  keyWords: z.string().optional().describe("New keywords string."),
+  releaseDate: z.string().optional().describe("New release date in ISO format."),
+  metaTagDescription: z.string().optional().describe("New meta description."),
+  showWithoutStock: z.boolean().optional().describe("Whether the product can stay visible without stock.")
+}).refine(
+  (value) => value.name !== void 0 || value.categoryId !== void 0 || value.brandId !== void 0 || value.description !== void 0 || value.descriptionShort !== void 0 || value.title !== void 0 || value.linkId !== void 0 || value.refId !== void 0 || value.isVisible !== void 0 || value.isActive !== void 0 || value.keyWords !== void 0 || value.releaseDate !== void 0 || value.metaTagDescription !== void 0 || value.showWithoutStock !== void 0,
+  {
+    message: "At least one product field must be provided.",
+    path: ["name"]
+  }
+);
+async function updateProductBasicFieldsHandler({
+  profileId,
+  productId,
+  ...updates
+}) {
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const beforeProduct = await getProduct(resolvedProfileId, productId);
+    const payload = buildProductUpdatePayload(beforeProduct, updates);
+    const afterProduct = await updateProduct(resolvedProfileId, productId, payload);
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "update_product_basic_fields",
+      resourceId: productId,
+      riskLevel: "low",
+      message: "Product fields updated successfully.",
+      before: beforeProduct,
+      after: afterProduct,
+      details: {
+        product_id: productId
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, `Failed to update product ${productId}`);
+  }
+}
+export {
+  updateProductBasicFieldsHandler,
+  updateProductBasicFieldsSchema
+};
+//# sourceMappingURL=update-product-basic-fields.js.map

package/dist/src/tools/vtex/update-product-basic-fields.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/update-product-basic-fields.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  buildProductUpdatePayload,\n  getProduct,\n  updateProduct,\n} from \"../../services/vtex/vtex-catalog-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nexport const updateProductBasicFieldsSchema = z\n  .object({\n    profileId: vtexProfileIdSchemaField,\n    productId: z.string().min(1).describe(\"VTEX product identifier.\"),\n    name: z.string().min(1).optional().describe(\"New product name.\"),\n    categoryId: z.number().int().positive().optional().describe(\"New category identifier.\"),\n    brandId: z.number().int().positive().optional().describe(\"New brand identifier.\"),\n    description: z.string().optional().describe(\"New product description.\"),\n    descriptionShort: z.string().optional().describe(\"New short description.\"),\n    title: z.string().optional().describe(\"New SEO title.\"),\n    linkId: z.string().optional().describe(\"New product slug.\"),\n    refId: z.string().optional().describe(\"New internal reference code.\"),\n    isVisible: z.boolean().optional().describe(\"Whether the product should remain visible in listings.\"),\n    isActive: z.boolean().optional().describe(\"Whether the product should remain active.\"),\n    keyWords: z.string().optional().describe(\"New keywords string.\"),\n    releaseDate: z.string().optional().describe(\"New release date in ISO format.\"),\n    metaTagDescription: z.string().optional().describe(\"New meta description.\"),\n    showWithoutStock: z\n      .boolean()\n      .optional()\n      .describe(\"Whether the product can stay visible without stock.\"),\n  })\n  .refine(\n    (value) =>\n      value.name !== undefined ||\n      value.categoryId !== undefined ||\n      value.brandId !== undefined ||\n      value.description !== undefined ||\n      value.descriptionShort !== undefined ||\n      value.title !== undefined ||\n      value.linkId !== undefined ||\n      value.refId !== undefined ||\n      value.isVisible !== undefined ||\n      value.isActive !== undefined ||\n      value.keyWords !== undefined ||\n      value.releaseDate !== undefined ||\n      value.metaTagDescription !== undefined ||\n      value.showWithoutStock !== undefined,\n    {\n      message: \"At least one product field must be provided.\",\n      path: [\"name\"],\n    }\n  );\n\nexport async function updateProductBasicFieldsHandler({\n  profileId,\n  productId,\n  ...updates\n}: z.infer<typeof updateProductBasicFieldsSchema>) {\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 beforeProduct = await getProduct(resolvedProfileId, productId);\n    const payload = buildProductUpdatePayload(beforeProduct, updates);\n    const afterProduct = await updateProduct(resolvedProfileId, productId, payload);\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"update_product_basic_fields\",\n      resourceId: productId,\n      riskLevel: \"low\",\n      message: \"Product fields updated successfully.\",\n      before: beforeProduct,\n      after: afterProduct,\n      details: {\n        product_id: productId,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, `Failed to update product ${productId}`);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,iCAAiC,EAC3C,OAAO;AAAA,EACN,WAAW;AAAA,EACX,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,0BAA0B;AAAA,EAChE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,mBAAmB;AAAA,EAC/D,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,0BAA0B;AAAA,EACtF,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,uBAAuB;AAAA,EAChF,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,0BAA0B;AAAA,EACtE,kBAAkB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,wBAAwB;AAAA,EACzE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,gBAAgB;AAAA,EACtD,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,mBAAmB;AAAA,EAC1D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,8BAA8B;AAAA,EACpE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,wDAAwD;AAAA,EACnG,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,2CAA2C;AAAA,EACrF,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,sBAAsB;AAAA,EAC/D,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,iCAAiC;AAAA,EAC7E,oBAAoB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,uBAAuB;AAAA,EAC1E,kBAAkB,EACf,QAAQ,EACR,SAAS,EACT,SAAS,qDAAqD;AACnE,CAAC,EACA;AAAA,EACC,CAAC,UACC,MAAM,SAAS,UACf,MAAM,eAAe,UACrB,MAAM,YAAY,UAClB,MAAM,gBAAgB,UACtB,MAAM,qBAAqB,UAC3B,MAAM,UAAU,UAChB,MAAM,WAAW,UACjB,MAAM,UAAU,UAChB,MAAM,cAAc,UACpB,MAAM,aAAa,UACnB,MAAM,aAAa,UACnB,MAAM,gBAAgB,UACtB,MAAM,uBAAuB,UAC7B,MAAM,qBAAqB;AAAA,EAC7B;AAAA,IACE,SAAS;AAAA,IACT,MAAM,CAAC,MAAM;AAAA,EACf;AACF;AAEF,eAAsB,gCAAgC;AAAA,EACpD;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAmD;AACjD,MAAI;AACF,UAAM,oBAAoB,MAAM,wBAAwB,SAAS;AACjE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,gBAAgB,MAAM,WAAW,mBAAmB,SAAS;AACnE,UAAM,UAAU,0BAA0B,eAAe,OAAO;AAChE,UAAM,eAAe,MAAM,cAAc,mBAAmB,WAAW,OAAO;AAE9E,WAAO,0BAA0B;AAAA,MAC/B,WAAW;AAAA,MACX,WAAW;AAAA,MACX,YAAY;AAAA,MACZ,WAAW;AAAA,MACX,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,OAAO;AAAA,MACP,SAAS;AAAA,QACP,YAAY;AAAA,MACd;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,qBAAqB,KAAK,4BAA4B,SAAS,EAAE;AAAA,EAC1E;AACF;",
+  "names": []
+}

package/dist/src/tools/vtex/update-sku-basic-fields.js

@@ -0,0 +1,92 @@
+import { z } from "zod";
+import {
+  buildSkuUpdatePayload,
+  createSkuEan,
+  deleteAllSkuEans,
+  getSku,
+  getSkuEans,
+  updateSku
+} from "../../services/vtex/vtex-catalog-write.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const updateSkuBasicFieldsSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  skuId: z.string().min(1).describe("VTEX SKU identifier."),
+  name: z.string().min(1).optional().describe("New SKU name."),
+  refId: z.string().optional().describe("New SKU reference code."),
+  ean: z.string().optional().describe("New EAN. When informed, existing EAN values are replaced with this one."),
+  packagedHeight: z.number().nonnegative().optional().describe("Packaged height."),
+  packagedLength: z.number().nonnegative().optional().describe("Packaged length."),
+  packagedWidth: z.number().nonnegative().optional().describe("Packaged width."),
+  packagedWeightKg: z.number().nonnegative().optional().describe("Packaged weight in kg."),
+  height: z.number().nonnegative().optional().describe("Physical height."),
+  length: z.number().nonnegative().optional().describe("Physical length."),
+  width: z.number().nonnegative().optional().describe("Physical width."),
+  weightKg: z.number().nonnegative().optional().describe("Physical weight in kg."),
+  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."),
+  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(
+  (value) => value.name !== void 0 || value.refId !== void 0 || value.ean !== void 0 || value.packagedHeight !== void 0 || value.packagedLength !== void 0 || value.packagedWidth !== void 0 || value.packagedWeightKg !== void 0 || value.height !== void 0 || value.length !== void 0 || value.width !== void 0 || value.weightKg !== void 0 || value.measurementUnit !== void 0 || value.unitMultiplier !== void 0 || value.manufacturerCode !== void 0 || value.commercialConditionId !== void 0 || value.isActive !== void 0 || value.activateIfPossible !== void 0,
+  {
+    message: "At least one SKU field must be provided.",
+    path: ["name"]
+  }
+);
+async function updateSkuBasicFieldsHandler({
+  profileId,
+  skuId,
+  ean,
+  ...updates
+}) {
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const beforeSku = await getSku(resolvedProfileId, skuId);
+    const beforeEans = await getSkuEans(resolvedProfileId, skuId);
+    const payload = buildSkuUpdatePayload(beforeSku, updates);
+    const afterSku = await updateSku(resolvedProfileId, skuId, payload);
+    if (ean !== void 0) {
+      await deleteAllSkuEans(resolvedProfileId, skuId);
+      if (ean.trim()) {
+        await createSkuEan(resolvedProfileId, skuId, ean.trim());
+      }
+    }
+    const afterEans = await getSkuEans(resolvedProfileId, skuId);
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "update_sku_basic_fields",
+      resourceId: skuId,
+      riskLevel: "low",
+      message: "SKU fields updated successfully.",
+      before: {
+        ...beforeSku,
+        Eans: beforeEans
+      },
+      after: {
+        ...afterSku,
+        Eans: afterEans
+      },
+      details: {
+        sku_id: skuId
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, `Failed to update SKU ${skuId}`);
+  }
+}
+export {
+  updateSkuBasicFieldsHandler,
+  updateSkuBasicFieldsSchema
+};
+//# sourceMappingURL=update-sku-basic-fields.js.map

package/dist/src/tools/vtex/update-sku-basic-fields.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/update-sku-basic-fields.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  buildSkuUpdatePayload,\n  createSkuEan,\n  deleteAllSkuEans,\n  getSku,\n  getSkuEans,\n  updateSku,\n} from \"../../services/vtex/vtex-catalog-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nexport const updateSkuBasicFieldsSchema = z\n  .object({\n    profileId: vtexProfileIdSchemaField,\n    skuId: z.string().min(1).describe(\"VTEX SKU identifier.\"),\n    name: z.string().min(1).optional().describe(\"New SKU name.\"),\n    refId: z.string().optional().describe(\"New SKU reference code.\"),\n    ean: z\n      .string()\n      .optional()\n      .describe(\"New EAN. When informed, existing EAN values are replaced with this one.\"),\n    packagedHeight: z.number().nonnegative().optional().describe(\"Packaged height.\"),\n    packagedLength: z.number().nonnegative().optional().describe(\"Packaged length.\"),\n    packagedWidth: z.number().nonnegative().optional().describe(\"Packaged width.\"),\n    packagedWeightKg: z.number().nonnegative().optional().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    measurementUnit: z.string().optional().describe(\"Measurement unit.\"),\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    isActive: z.boolean().optional().describe(\"Whether the SKU should remain active.\"),\n    activateIfPossible: z\n      .boolean()\n      .optional()\n      .describe(\"Whether VTEX should auto-activate the SKU when possible.\"),\n  })\n  .refine(\n    (value) =>\n      value.name !== undefined ||\n      value.refId !== undefined ||\n      value.ean !== undefined ||\n      value.packagedHeight !== undefined ||\n      value.packagedLength !== undefined ||\n      value.packagedWidth !== undefined ||\n      value.packagedWeightKg !== undefined ||\n      value.height !== undefined ||\n      value.length !== undefined ||\n      value.width !== undefined ||\n      value.weightKg !== undefined ||\n      value.measurementUnit !== undefined ||\n      value.unitMultiplier !== undefined ||\n      value.manufacturerCode !== undefined ||\n      value.commercialConditionId !== undefined ||\n      value.isActive !== undefined ||\n      value.activateIfPossible !== undefined,\n    {\n      message: \"At least one SKU field must be provided.\",\n      path: [\"name\"],\n    }\n  );\n\nexport async function updateSkuBasicFieldsHandler({\n  profileId,\n  skuId,\n  ean,\n  ...updates\n}: z.infer<typeof updateSkuBasicFieldsSchema>) {\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 beforeSku = await getSku(resolvedProfileId, skuId);\n    const beforeEans = await getSkuEans(resolvedProfileId, skuId);\n    const payload = buildSkuUpdatePayload(beforeSku, updates);\n    const afterSku = await updateSku(resolvedProfileId, skuId, payload);\n\n    if (ean !== undefined) {\n      await deleteAllSkuEans(resolvedProfileId, skuId);\n      if (ean.trim()) {\n        await createSkuEan(resolvedProfileId, skuId, ean.trim());\n      }\n    }\n\n    const afterEans = await getSkuEans(resolvedProfileId, skuId);\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"update_sku_basic_fields\",\n      resourceId: skuId,\n      riskLevel: \"low\",\n      message: \"SKU fields updated successfully.\",\n      before: {\n        ...beforeSku,\n        Eans: beforeEans,\n      },\n      after: {\n        ...afterSku,\n        Eans: afterEans,\n      },\n      details: {\n        sku_id: skuId,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, `Failed to update SKU ${skuId}`);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,6BAA6B,EACvC,OAAO;AAAA,EACN,WAAW;AAAA,EACX,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,sBAAsB;AAAA,EACxD,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,eAAe;AAAA,EAC3D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,yBAAyB;AAAA,EAC/D,KAAK,EACF,OAAO,EACP,SAAS,EACT,SAAS,yEAAyE;AAAA,EACrF,gBAAgB,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,kBAAkB;AAAA,EAC/E,gBAAgB,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,kBAAkB;AAAA,EAC/E,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,iBAAiB;AAAA,EAC7E,kBAAkB,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,wBAAwB;AAAA,EACvF,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,iBAAiB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,mBAAmB;AAAA,EACnE,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;AAAA,EACjG,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,uCAAuC;AAAA,EACjF,oBAAoB,EACjB,QAAQ,EACR,SAAS,EACT,SAAS,0DAA0D;AACxE,CAAC,EACA;AAAA,EACC,CAAC,UACC,MAAM,SAAS,UACf,MAAM,UAAU,UAChB,MAAM,QAAQ,UACd,MAAM,mBAAmB,UACzB,MAAM,mBAAmB,UACzB,MAAM,kBAAkB,UACxB,MAAM,qBAAqB,UAC3B,MAAM,WAAW,UACjB,MAAM,WAAW,UACjB,MAAM,UAAU,UAChB,MAAM,aAAa,UACnB,MAAM,oBAAoB,UAC1B,MAAM,mBAAmB,UACzB,MAAM,qBAAqB,UAC3B,MAAM,0BAA0B,UAChC,MAAM,aAAa,UACnB,MAAM,uBAAuB;AAAA,EAC/B;AAAA,IACE,SAAS;AAAA,IACT,MAAM,CAAC,MAAM;AAAA,EACf;AACF;AAEF,eAAsB,4BAA4B;AAAA,EAChD;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAA+C;AAC7C,MAAI;AACF,UAAM,oBAAoB,MAAM,wBAAwB,SAAS;AACjE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,YAAY,MAAM,OAAO,mBAAmB,KAAK;AACvD,UAAM,aAAa,MAAM,WAAW,mBAAmB,KAAK;AAC5D,UAAM,UAAU,sBAAsB,WAAW,OAAO;AACxD,UAAM,WAAW,MAAM,UAAU,mBAAmB,OAAO,OAAO;AAElE,QAAI,QAAQ,QAAW;AACrB,YAAM,iBAAiB,mBAAmB,KAAK;AAC/C,UAAI,IAAI,KAAK,GAAG;AACd,cAAM,aAAa,mBAAmB,OAAO,IAAI,KAAK,CAAC;AAAA,MACzD;AAAA,IACF;AAEA,UAAM,YAAY,MAAM,WAAW,mBAAmB,KAAK;AAE3D,WAAO,0BAA0B;AAAA,MAC/B,WAAW;AAAA,MACX,WAAW;AAAA,MACX,YAAY;AAAA,MACZ,WAAW;AAAA,MACX,SAAS;AAAA,MACT,QAAQ;AAAA,QACN,GAAG;AAAA,QACH,MAAM;AAAA,MACR;AAAA,MACA,OAAO;AAAA,QACL,GAAG;AAAA,QACH,MAAM;AAAA,MACR;AAAA,MACA,SAAS;AAAA,QACP,QAAQ;AAAA,MACV;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,qBAAqB,KAAK,wBAAwB,KAAK,EAAE;AAAA,EAClE;AACF;",
+  "names": []
+}