@yoryoboy/bi-mcp 1.2.0 → 1.3.0

package/dist/src/tools/vtex/add-order-tracking.js

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import {
+  getOrderStateSnapshot,
+  updateOrderTrackingStatus,
+  updatePartialInvoiceTracking,
+  validateOrderForTracking
+} from "../../services/vtex/vtex-orders-write.js";
+import {
+  buildWriteSuccessResponse,
+  confirmationNoteSchemaField,
+  confirmationSchemaField,
+  handleVtexWriteError,
+  requireExplicitConfirmation,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const trackingEventSchema = z.object({
+  city: z.string().min(1).describe("Tracking event city."),
+  state: z.string().min(1).describe("Tracking event state."),
+  description: z.string().min(1).describe("Tracking event description."),
+  date: z.string().min(1).describe("Tracking event date string.")
+});
+const addOrderTrackingSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  orderId: z.string().min(1).describe("VTEX order identifier."),
+  invoiceNumber: z.string().min(1).describe("Invoice number that will receive tracking data."),
+  confirmed: confirmationSchemaField,
+  confirmationNote: confirmationNoteSchemaField,
+  trackingNumber: z.string().min(1).describe("Tracking number."),
+  trackingUrl: z.string().url().optional().describe("Tracking URL."),
+  courier: z.string().optional().describe("Carrier name."),
+  dispatchedDate: z.string().min(1).describe("Dispatch timestamp."),
+  isDelivered: z.boolean().optional().describe("Optional delivery status to send to VTEX tracking timeline."),
+  deliveredDate: z.string().optional().describe("Optional delivered date in `yyyy-mm-dd hh:mm` format."),
+  events: z.array(trackingEventSchema).optional().describe("Optional tracking events timeline.")
+});
+async function addOrderTrackingHandler({
+  profileId,
+  orderId,
+  invoiceNumber,
+  confirmed,
+  confirmationNote,
+  trackingNumber,
+  trackingUrl,
+  courier,
+  dispatchedDate,
+  isDelivered,
+  deliveredDate,
+  events
+}) {
+  const confirmationResponse = requireExplicitConfirmation(confirmed, "add_order_tracking", {
+    order_id: orderId,
+    invoice_number: invoiceNumber
+  });
+  if (confirmationResponse) {
+    return confirmationResponse;
+  }
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const beforeOrder = await validateOrderForTracking(resolvedProfileId, orderId, invoiceNumber);
+    await updatePartialInvoiceTracking(resolvedProfileId, orderId, invoiceNumber, {
+      trackingNumber,
+      trackingUrl,
+      courier,
+      dispatchedDate
+    });
+    if (events?.length || isDelivered !== void 0) {
+      await updateOrderTrackingStatus(resolvedProfileId, orderId, invoiceNumber, {
+        isDelivered: isDelivered ?? false,
+        deliveredDate: deliveredDate ?? null,
+        events: events ?? []
+      });
+    }
+    const afterOrder = await getOrderStateSnapshot(resolvedProfileId, orderId);
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "add_order_tracking",
+      resourceId: orderId,
+      riskLevel: "high",
+      confirmed: true,
+      confirmationNote,
+      message: "Order tracking updated successfully.",
+      before: beforeOrder,
+      after: afterOrder,
+      details: {
+        order_id: orderId,
+        invoice_number: invoiceNumber,
+        tracking_number: trackingNumber
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, `Failed to update tracking for order ${orderId}`);
+  }
+}
+export {
+  addOrderTrackingHandler,
+  addOrderTrackingSchema
+};
+//# sourceMappingURL=add-order-tracking.js.map

package/dist/src/tools/vtex/add-order-tracking.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/add-order-tracking.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  getOrderStateSnapshot,\n  updateOrderTrackingStatus,\n  updatePartialInvoiceTracking,\n  validateOrderForTracking,\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 trackingEventSchema = z.object({\n  city: z.string().min(1).describe(\"Tracking event city.\"),\n  state: z.string().min(1).describe(\"Tracking event state.\"),\n  description: z.string().min(1).describe(\"Tracking event description.\"),\n  date: z.string().min(1).describe(\"Tracking event date string.\"),\n});\n\nexport const addOrderTrackingSchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  orderId: z.string().min(1).describe(\"VTEX order identifier.\"),\n  invoiceNumber: z.string().min(1).describe(\"Invoice number that will receive tracking data.\"),\n  confirmed: confirmationSchemaField,\n  confirmationNote: confirmationNoteSchemaField,\n  trackingNumber: z.string().min(1).describe(\"Tracking number.\"),\n  trackingUrl: z.string().url().optional().describe(\"Tracking URL.\"),\n  courier: z.string().optional().describe(\"Carrier name.\"),\n  dispatchedDate: z.string().min(1).describe(\"Dispatch timestamp.\"),\n  isDelivered: z\n    .boolean()\n    .optional()\n    .describe(\"Optional delivery status to send to VTEX tracking timeline.\"),\n  deliveredDate: z\n    .string()\n    .optional()\n    .describe(\"Optional delivered date in `yyyy-mm-dd hh:mm` format.\"),\n  events: z.array(trackingEventSchema).optional().describe(\"Optional tracking events timeline.\"),\n});\n\nexport async function addOrderTrackingHandler({\n  profileId,\n  orderId,\n  invoiceNumber,\n  confirmed,\n  confirmationNote,\n  trackingNumber,\n  trackingUrl,\n  courier,\n  dispatchedDate,\n  isDelivered,\n  deliveredDate,\n  events,\n}: z.infer<typeof addOrderTrackingSchema>) {\n  const confirmationResponse = requireExplicitConfirmation(confirmed, \"add_order_tracking\", {\n    order_id: orderId,\n    invoice_number: invoiceNumber,\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 validateOrderForTracking(resolvedProfileId, orderId, invoiceNumber);\n\n    await updatePartialInvoiceTracking(resolvedProfileId, orderId, invoiceNumber, {\n      trackingNumber,\n      trackingUrl,\n      courier,\n      dispatchedDate,\n    });\n\n    if (events?.length || isDelivered !== undefined) {\n      await updateOrderTrackingStatus(resolvedProfileId, orderId, invoiceNumber, {\n        isDelivered: isDelivered ?? false,\n        deliveredDate: deliveredDate ?? null,\n        events: events ?? [],\n      });\n    }\n\n    const afterOrder = await getOrderStateSnapshot(resolvedProfileId, orderId);\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"add_order_tracking\",\n      resourceId: orderId,\n      riskLevel: \"high\",\n      confirmed: true,\n      confirmationNote,\n      message: \"Order tracking updated 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: invoiceNumber,\n        tracking_number: trackingNumber,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, `Failed to update tracking for order ${orderId}`);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/vtex/associate-specification.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+import {
+  associateProductSpecification,
+  associateSkuSpecification
+} from "../../services/vtex/vtex-catalog-write.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const associateSpecificationSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  entityType: z.enum(["product", "sku"]).describe("Whether the specification should be associated to a product or an SKU."),
+  resourceId: z.string().min(1).describe("Product ID or SKU ID depending on entityType."),
+  fieldId: z.number().int().positive().describe("Specification field ID."),
+  fieldValueId: z.number().int().positive().optional().describe("Specification value ID. Required for combo, radio, and checkbox fields."),
+  text: z.string().optional().describe("Raw text value. Use for free text specifications instead of fieldValueId.")
+});
+async function associateSpecificationHandler({
+  profileId,
+  entityType,
+  resourceId,
+  fieldId,
+  fieldValueId,
+  text
+}) {
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const payload = {
+      FieldId: fieldId
+    };
+    if (fieldValueId !== void 0) payload.FieldValueId = fieldValueId;
+    if (text !== void 0) payload.Text = text;
+    const association = entityType === "product" ? await associateProductSpecification(resolvedProfileId, resourceId, payload) : await associateSkuSpecification(resolvedProfileId, resourceId, payload);
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "associate_specification",
+      resourceId,
+      riskLevel: "low",
+      message: "Specification associated successfully.",
+      before: null,
+      after: association,
+      details: {
+        entity_type: entityType
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, `Failed to associate specification to ${entityType} ${resourceId}`);
+  }
+}
+export {
+  associateSpecificationHandler,
+  associateSpecificationSchema
+};
+//# sourceMappingURL=associate-specification.js.map

package/dist/src/tools/vtex/associate-specification.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/associate-specification.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  associateProductSpecification,\n  associateSkuSpecification,\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 associateSpecificationSchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  entityType: z.enum([\"product\", \"sku\"]).describe(\"Whether the specification should be associated to a product or an SKU.\"),\n  resourceId: z.string().min(1).describe(\"Product ID or SKU ID depending on entityType.\"),\n  fieldId: z.number().int().positive().describe(\"Specification field ID.\"),\n  fieldValueId: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe(\"Specification value ID. Required for combo, radio, and checkbox fields.\"),\n  text: z\n    .string()\n    .optional()\n    .describe(\"Raw text value. Use for free text specifications instead of fieldValueId.\"),\n});\n\nexport async function associateSpecificationHandler({\n  profileId,\n  entityType,\n  resourceId,\n  fieldId,\n  fieldValueId,\n  text,\n}: z.infer<typeof associateSpecificationSchema>) {\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      FieldId: fieldId,\n    };\n    if (fieldValueId !== undefined) payload.FieldValueId = fieldValueId;\n    if (text !== undefined) payload.Text = text;\n\n    const association =\n      entityType === \"product\"\n        ? await associateProductSpecification(resolvedProfileId, resourceId, payload)\n        : await associateSkuSpecification(resolvedProfileId, resourceId, payload);\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"associate_specification\",\n      resourceId,\n      riskLevel: \"low\",\n      message: \"Specification associated successfully.\",\n      before: null,\n      after: association,\n      details: {\n        entity_type: entityType,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, `Failed to associate specification to ${entityType} ${resourceId}`);\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,+BAA+B,EAAE,OAAO;AAAA,EACnD,WAAW;AAAA,EACX,YAAY,EAAE,KAAK,CAAC,WAAW,KAAK,CAAC,EAAE,SAAS,wEAAwE;AAAA,EACxH,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,+CAA+C;AAAA,EACtF,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,yBAAyB;AAAA,EACvE,cAAc,EACX,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,EACT,SAAS,yEAAyE;AAAA,EACrF,MAAM,EACH,OAAO,EACP,SAAS,EACT,SAAS,2EAA2E;AACzF,CAAC;AAED,eAAsB,8BAA8B;AAAA,EAClD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAiD;AAC/C,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,SAAS;AAAA,IACX;AACA,QAAI,iBAAiB,OAAW,SAAQ,eAAe;AACvD,QAAI,SAAS,OAAW,SAAQ,OAAO;AAEvC,UAAM,cACJ,eAAe,YACX,MAAM,8BAA8B,mBAAmB,YAAY,OAAO,IAC1E,MAAM,0BAA0B,mBAAmB,YAAY,OAAO;AAE5E,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,aAAa;AAAA,MACf;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,qBAAqB,KAAK,wCAAwC,UAAU,IAAI,UAAU,EAAE;AAAA,EACrG;AACF;",
+  "names": []
+}

package/dist/src/tools/vtex/attach-catalog-image.js

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { createSkuFile } from "../../services/vtex/vtex-catalog-write.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const attachCatalogImageSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  skuId: z.string().min(1).describe("SKU identifier that will receive the image."),
+  name: z.string().min(1).describe("Image name."),
+  url: z.string().url().describe("Public image URL. VTEX expects http(s) and a valid image extension."),
+  isMain: z.boolean().optional().describe("Whether this image should be the main image."),
+  label: z.string().optional().describe("Optional image label."),
+  text: z.string().optional().describe("Optional image text."),
+  position: z.number().int().nonnegative().optional().describe("Image position in storefront.")
+});
+async function attachCatalogImageHandler({
+  profileId,
+  skuId,
+  name,
+  url,
+  isMain,
+  label,
+  text,
+  position
+}) {
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const createdImage = await createSkuFile(resolvedProfileId, skuId, {
+      Name: name,
+      Url: url,
+      IsMain: isMain,
+      Label: label,
+      Text: text,
+      Position: position
+    });
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "attach_catalog_image",
+      resourceId: skuId,
+      riskLevel: "low",
+      message: "Catalog image attached successfully.",
+      before: null,
+      after: createdImage,
+      details: {
+        sku_id: skuId
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, `Failed to attach image to SKU ${skuId}`);
+  }
+}
+export {
+  attachCatalogImageHandler,
+  attachCatalogImageSchema
+};
+//# sourceMappingURL=attach-catalog-image.js.map

package/dist/src/tools/vtex/attach-catalog-image.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/attach-catalog-image.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport { createSkuFile } from \"../../services/vtex/vtex-catalog-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nexport const attachCatalogImageSchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  skuId: z.string().min(1).describe(\"SKU identifier that will receive the image.\"),\n  name: z.string().min(1).describe(\"Image name.\"),\n  url: z\n    .string()\n    .url()\n    .describe(\"Public image URL. VTEX expects http(s) and a valid image extension.\"),\n  isMain: z.boolean().optional().describe(\"Whether this image should be the main image.\"),\n  label: z.string().optional().describe(\"Optional image label.\"),\n  text: z.string().optional().describe(\"Optional image text.\"),\n  position: z.number().int().nonnegative().optional().describe(\"Image position in storefront.\"),\n});\n\nexport async function attachCatalogImageHandler({\n  profileId,\n  skuId,\n  name,\n  url,\n  isMain,\n  label,\n  text,\n  position,\n}: z.infer<typeof attachCatalogImageSchema>) {\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 createdImage = await createSkuFile(resolvedProfileId, skuId, {\n      Name: name,\n      Url: url,\n      IsMain: isMain,\n      Label: label,\n      Text: text,\n      Position: position,\n    });\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"attach_catalog_image\",\n      resourceId: skuId,\n      riskLevel: \"low\",\n      message: \"Catalog image attached successfully.\",\n      before: null,\n      after: createdImage,\n      details: {\n        sku_id: skuId,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, `Failed to attach image to SKU ${skuId}`);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,2BAA2B,EAAE,OAAO;AAAA,EAC/C,WAAW;AAAA,EACX,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,6CAA6C;AAAA,EAC/E,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,aAAa;AAAA,EAC9C,KAAK,EACF,OAAO,EACP,IAAI,EACJ,SAAS,qEAAqE;AAAA,EACjF,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,8CAA8C;AAAA,EACtF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,uBAAuB;AAAA,EAC7D,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,sBAAsB;AAAA,EAC3D,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,+BAA+B;AAC9F,CAAC;AAED,eAAsB,0BAA0B;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA6C;AAC3C,MAAI;AACF,UAAM,oBAAoB,MAAM,wBAAwB,SAAS;AACjE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,eAAe,MAAM,cAAc,mBAAmB,OAAO;AAAA,MACjE,MAAM;AAAA,MACN,KAAK;AAAA,MACL,QAAQ;AAAA,MACR,OAAO;AAAA,MACP,MAAM;AAAA,MACN,UAAU;AAAA,IACZ,CAAC;AAED,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,QAAQ;AAAA,MACV;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,qBAAqB,KAAK,iCAAiC,KAAK,EAAE;AAAA,EAC3E;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import {
+  cancelOrder,
+  getOrderStateSnapshot,
+  validateOrderForCancellation
+} from "../../services/vtex/vtex-orders-write.js";
+import {
+  buildWriteSuccessResponse,
+  confirmationNoteSchemaField,
+  confirmationSchemaField,
+  handleVtexWriteError,
+  requireExplicitConfirmation,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const cancelOrderSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  orderId: z.string().min(1).describe("VTEX order identifier to cancel."),
+  confirmed: confirmationSchemaField,
+  reason: z.string().trim().min(1).describe("Reason for canceling the order. VTEX persists this reason.").optional(),
+  confirmationNote: confirmationNoteSchemaField
+});
+async function cancelOrderHandler({
+  profileId,
+  orderId,
+  confirmed,
+  reason,
+  confirmationNote
+}) {
+  const confirmationResponse = requireExplicitConfirmation(confirmed, "cancel_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 validateOrderForCancellation(resolvedProfileId, orderId, reason);
+    await cancelOrder(resolvedProfileId, orderId, reason);
+    const afterOrder = await getOrderStateSnapshot(resolvedProfileId, orderId, reason);
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "cancel_order",
+      resourceId: orderId,
+      riskLevel: "high",
+      confirmed: true,
+      confirmationNote,
+      message: "Order canceled successfully.",
+      before: beforeOrder,
+      after: afterOrder,
+      details: {
+        order_id: orderId
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, `Failed to cancel order ${orderId}`);
+  }
+}
+export {
+  cancelOrderHandler,
+  cancelOrderSchema
+};
+//# sourceMappingURL=cancel-order.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/cancel-order.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  cancelOrder,\n  getOrderStateSnapshot,\n  validateOrderForCancellation,\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\nexport const cancelOrderSchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  orderId: z.string().min(1).describe(\"VTEX order identifier to cancel.\"),\n  confirmed: confirmationSchemaField,\n  reason: z\n    .string()\n    .trim()\n    .min(1)\n    .describe(\"Reason for canceling the order. VTEX persists this reason.\")\n    .optional(),\n  confirmationNote: confirmationNoteSchemaField,\n});\n\nexport async function cancelOrderHandler({\n  profileId,\n  orderId,\n  confirmed,\n  reason,\n  confirmationNote,\n}: z.infer<typeof cancelOrderSchema>) {\n  const confirmationResponse = requireExplicitConfirmation(confirmed, \"cancel_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 validateOrderForCancellation(resolvedProfileId, orderId, reason);\n    await cancelOrder(resolvedProfileId, orderId, reason);\n    const afterOrder = await getOrderStateSnapshot(resolvedProfileId, orderId, reason);\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"cancel_order\",\n      resourceId: orderId,\n      riskLevel: \"high\",\n      confirmed: true,\n      confirmationNote,\n      message: \"Order canceled 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      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, `Failed to cancel 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;AAEA,MAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,WAAW;AAAA,EACX,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,kCAAkC;AAAA,EACtE,WAAW;AAAA,EACX,QAAQ,EACL,OAAO,EACP,KAAK,EACL,IAAI,CAAC,EACL,SAAS,4DAA4D,EACrE,SAAS;AAAA,EACZ,kBAAkB;AACpB,CAAC;AAED,eAAsB,mBAAmB;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAsC;AACpC,QAAM,uBAAuB,4BAA4B,WAAW,gBAAgB;AAAA,IAClF,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,6BAA6B,mBAAmB,SAAS,MAAM;AACzF,UAAM,YAAY,mBAAmB,SAAS,MAAM;AACpD,UAAM,aAAa,MAAM,sBAAsB,mBAAmB,SAAS,MAAM;AAEjF,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,MACZ;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,qBAAqB,KAAK,0BAA0B,OAAO,EAAE;AAAA,EACtE;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,69 @@
+import { z } from "zod";
+import { createBrand } from "../../services/vtex/vtex-catalog-write.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const createBrandSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  id: z.number().int().positive().describe("Brand ID required by VTEX Catalog API."),
+  name: z.string().min(1).describe("Brand name."),
+  text: z.string().optional().describe("Meta description text."),
+  keywords: z.string().optional().describe("Alternative search terms."),
+  siteTitle: z.string().optional().describe("Brand page title."),
+  active: z.boolean().optional().describe("Whether the brand should be active."),
+  menuHome: z.boolean().optional().describe("Whether the brand should appear in the home menu."),
+  linkId: z.string().optional().describe("Brand slug."),
+  score: z.number().int().optional().describe("Search score.")
+});
+async function createBrandHandler({
+  profileId,
+  id,
+  name,
+  text,
+  keywords,
+  siteTitle,
+  active,
+  menuHome,
+  linkId,
+  score
+}) {
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const createdBrand = await createBrand(resolvedProfileId, {
+      Id: id,
+      Name: name,
+      Text: text ?? name,
+      Keywords: keywords ?? "",
+      SiteTitle: siteTitle ?? name,
+      Active: active ?? true,
+      MenuHome: menuHome ?? false,
+      LinkId: linkId,
+      Score: score ?? null,
+      AdWordsRemarketingCode: null,
+      LomadeeCampaignCode: null
+    });
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "create_brand",
+      resourceId: String(createdBrand.Id ?? id),
+      riskLevel: "low",
+      message: "Brand created successfully.",
+      before: null,
+      after: createdBrand
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, "Failed to create brand in VTEX");
+  }
+}
+export {
+  createBrandHandler,
+  createBrandSchema
+};
+//# sourceMappingURL=create-brand.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/create-brand.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport { createBrand } from \"../../services/vtex/vtex-catalog-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nexport const createBrandSchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  id: z.number().int().positive().describe(\"Brand ID required by VTEX Catalog API.\"),\n  name: z.string().min(1).describe(\"Brand name.\"),\n  text: z.string().optional().describe(\"Meta description text.\"),\n  keywords: z.string().optional().describe(\"Alternative search terms.\"),\n  siteTitle: z.string().optional().describe(\"Brand page title.\"),\n  active: z.boolean().optional().describe(\"Whether the brand should be active.\"),\n  menuHome: z.boolean().optional().describe(\"Whether the brand should appear in the home menu.\"),\n  linkId: z.string().optional().describe(\"Brand slug.\"),\n  score: z.number().int().optional().describe(\"Search score.\"),\n});\n\nexport async function createBrandHandler({\n  profileId,\n  id,\n  name,\n  text,\n  keywords,\n  siteTitle,\n  active,\n  menuHome,\n  linkId,\n  score,\n}: z.infer<typeof createBrandSchema>) {\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 createdBrand = await createBrand(resolvedProfileId, {\n      Id: id,\n      Name: name,\n      Text: text ?? name,\n      Keywords: keywords ?? \"\",\n      SiteTitle: siteTitle ?? name,\n      Active: active ?? true,\n      MenuHome: menuHome ?? false,\n      LinkId: linkId,\n      Score: score ?? null,\n      AdWordsRemarketingCode: null,\n      LomadeeCampaignCode: null,\n    });\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"create_brand\",\n      resourceId: String(createdBrand.Id ?? id),\n      riskLevel: \"low\",\n      message: \"Brand created successfully.\",\n      before: null,\n      after: createdBrand,\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, \"Failed to create brand in VTEX\");\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB,SAAS,mBAAmB;AAC5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,WAAW;AAAA,EACX,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,wCAAwC;AAAA,EACjF,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,aAAa;AAAA,EAC9C,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,wBAAwB;AAAA,EAC7D,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,2BAA2B;AAAA,EACpE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,mBAAmB;AAAA,EAC7D,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,qCAAqC;AAAA,EAC7E,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,mDAAmD;AAAA,EAC7F,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,aAAa;AAAA,EACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,eAAe;AAC7D,CAAC;AAED,eAAsB,mBAAmB;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAsC;AACpC,MAAI;AACF,UAAM,oBAAoB,MAAM,wBAAwB,SAAS;AACjE,QAAI,CAAC,kBAAkB,IAAI;AACzB,aAAO,kBAAkB;AAAA,IAC3B;AAEA,UAAM,oBAAoB,kBAAkB,MAAM;AAClD,UAAM,eAAe,MAAM,YAAY,mBAAmB;AAAA,MACxD,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,MAAM,QAAQ;AAAA,MACd,UAAU,YAAY;AAAA,MACtB,WAAW,aAAa;AAAA,MACxB,QAAQ,UAAU;AAAA,MAClB,UAAU,YAAY;AAAA,MACtB,QAAQ;AAAA,MACR,OAAO,SAAS;AAAA,MAChB,wBAAwB;AAAA,MACxB,qBAAqB;AAAA,IACvB,CAAC;AAED,WAAO,0BAA0B;AAAA,MAC/B,WAAW;AAAA,MACX,WAAW;AAAA,MACX,YAAY,OAAO,aAAa,MAAM,EAAE;AAAA,MACxC,WAAW;AAAA,MACX,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,OAAO;AAAA,IACT,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,qBAAqB,KAAK,gCAAgC;AAAA,EACnE;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,81 @@
+import { z } from "zod";
+import { createCategory } from "../../services/vtex/vtex-catalog-write.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const createCategorySchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  id: z.number().int().positive().optional().describe("Optional category ID. VTEX can generate it."),
+  name: z.string().min(1).describe("Category name."),
+  title: z.string().min(1).describe("Category page title."),
+  description: z.string().min(1).describe("Category meta description."),
+  fatherCategoryId: z.number().int().positive().nullable().optional().describe("Parent category ID. Use null for a top-level category."),
+  globalCategoryId: z.number().int().nonnegative().describe("Google global category ID."),
+  stockKeepingUnitSelectionMode: z.enum(["SPECIFICATION", "LIST"]).describe("How shoppers should choose SKUs in storefront."),
+  keywords: z.string().optional().describe("Alternative search terms."),
+  showInStoreFront: z.boolean().optional().describe("Whether the category should appear in menus."),
+  isActive: z.boolean().optional().describe("Whether the category should be active."),
+  activeStoreFrontLink: z.boolean().optional().describe("Whether the category link should be active in storefront."),
+  showBrandFilter: z.boolean().optional().describe("Whether the category page should show brand filters."),
+  score: z.number().int().nullable().optional().describe("Search score.")
+});
+async function createCategoryHandler({
+  profileId,
+  id,
+  name,
+  title,
+  description,
+  fatherCategoryId,
+  globalCategoryId,
+  stockKeepingUnitSelectionMode,
+  keywords,
+  showInStoreFront,
+  isActive,
+  activeStoreFrontLink,
+  showBrandFilter,
+  score
+}) {
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const createdCategory = await createCategory(resolvedProfileId, {
+      Id: id,
+      Name: name,
+      Keywords: keywords ?? "",
+      Title: title,
+      Description: description,
+      AdWordsRemarketingCode: null,
+      LomadeeCampaignCode: null,
+      FatherCategoryId: fatherCategoryId ?? null,
+      GlobalCategoryId: globalCategoryId,
+      ShowInStoreFront: showInStoreFront ?? true,
+      IsActive: isActive ?? true,
+      ActiveStoreFrontLink: activeStoreFrontLink ?? true,
+      ShowBrandFilter: showBrandFilter ?? true,
+      Score: score ?? null,
+      StockKeepingUnitSelectionMode: stockKeepingUnitSelectionMode
+    });
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "create_category",
+      resourceId: String(createdCategory.Id ?? id ?? ""),
+      riskLevel: "low",
+      message: "Category created successfully.",
+      before: null,
+      after: createdCategory
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, "Failed to create category in VTEX");
+  }
+}
+export {
+  createCategoryHandler,
+  createCategorySchema
+};
+//# sourceMappingURL=create-category.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/create-category.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport { createCategory } from \"../../services/vtex/vtex-catalog-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nexport const createCategorySchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  id: z.number().int().positive().optional().describe(\"Optional category ID. VTEX can generate it.\"),\n  name: z.string().min(1).describe(\"Category name.\"),\n  title: z.string().min(1).describe(\"Category page title.\"),\n  description: z.string().min(1).describe(\"Category meta description.\"),\n  fatherCategoryId: z\n    .number()\n    .int()\n    .positive()\n    .nullable()\n    .optional()\n    .describe(\"Parent category ID. Use null for a top-level category.\"),\n  globalCategoryId: z.number().int().nonnegative().describe(\"Google global category ID.\"),\n  stockKeepingUnitSelectionMode: z\n    .enum([\"SPECIFICATION\", \"LIST\"])\n    .describe(\"How shoppers should choose SKUs in storefront.\"),\n  keywords: z.string().optional().describe(\"Alternative search terms.\"),\n  showInStoreFront: z.boolean().optional().describe(\"Whether the category should appear in menus.\"),\n  isActive: z.boolean().optional().describe(\"Whether the category should be active.\"),\n  activeStoreFrontLink: z\n    .boolean()\n    .optional()\n    .describe(\"Whether the category link should be active in storefront.\"),\n  showBrandFilter: z.boolean().optional().describe(\"Whether the category page should show brand filters.\"),\n  score: z.number().int().nullable().optional().describe(\"Search score.\"),\n});\n\nexport async function createCategoryHandler({\n  profileId,\n  id,\n  name,\n  title,\n  description,\n  fatherCategoryId,\n  globalCategoryId,\n  stockKeepingUnitSelectionMode,\n  keywords,\n  showInStoreFront,\n  isActive,\n  activeStoreFrontLink,\n  showBrandFilter,\n  score,\n}: z.infer<typeof createCategorySchema>) {\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 createdCategory = await createCategory(resolvedProfileId, {\n      Id: id,\n      Name: name,\n      Keywords: keywords ?? \"\",\n      Title: title,\n      Description: description,\n      AdWordsRemarketingCode: null,\n      LomadeeCampaignCode: null,\n      FatherCategoryId: fatherCategoryId ?? null,\n      GlobalCategoryId: globalCategoryId,\n      ShowInStoreFront: showInStoreFront ?? true,\n      IsActive: isActive ?? true,\n      ActiveStoreFrontLink: activeStoreFrontLink ?? true,\n      ShowBrandFilter: showBrandFilter ?? true,\n      Score: score ?? null,\n      StockKeepingUnitSelectionMode: stockKeepingUnitSelectionMode,\n    });\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"create_category\",\n      resourceId: String(createdCategory.Id ?? id ?? \"\"),\n      riskLevel: \"low\",\n      message: \"Category created successfully.\",\n      before: null,\n      after: createdCategory,\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, \"Failed to create category in VTEX\");\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB,SAAS,sBAAsB;AAC/B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,WAAW;AAAA,EACX,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,6CAA6C;AAAA,EACjG,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,gBAAgB;AAAA,EACjD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,sBAAsB;AAAA,EACxD,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,4BAA4B;AAAA,EACpE,kBAAkB,EACf,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,wDAAwD;AAAA,EACpE,kBAAkB,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,4BAA4B;AAAA,EACtF,+BAA+B,EAC5B,KAAK,CAAC,iBAAiB,MAAM,CAAC,EAC9B,SAAS,gDAAgD;AAAA,EAC5D,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,2BAA2B;AAAA,EACpE,kBAAkB,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,8CAA8C;AAAA,EAChG,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,wCAAwC;AAAA,EAClF,sBAAsB,EACnB,QAAQ,EACR,SAAS,EACT,SAAS,2DAA2D;AAAA,EACvE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,sDAAsD;AAAA,EACvG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,eAAe;AACxE,CAAC;AAED,eAAsB,sBAAsB;AAAA,EAC1C;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,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,eAAe,mBAAmB;AAAA,MAC9D,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,UAAU,YAAY;AAAA,MACtB,OAAO;AAAA,MACP,aAAa;AAAA,MACb,wBAAwB;AAAA,MACxB,qBAAqB;AAAA,MACrB,kBAAkB,oBAAoB;AAAA,MACtC,kBAAkB;AAAA,MAClB,kBAAkB,oBAAoB;AAAA,MACtC,UAAU,YAAY;AAAA,MACtB,sBAAsB,wBAAwB;AAAA,MAC9C,iBAAiB,mBAAmB;AAAA,MACpC,OAAO,SAAS;AAAA,MAChB,+BAA+B;AAAA,IACjC,CAAC;AAED,WAAO,0BAA0B;AAAA,MAC/B,WAAW;AAAA,MACX,WAAW;AAAA,MACX,YAAY,OAAO,gBAAgB,MAAM,MAAM,EAAE;AAAA,MACjD,WAAW;AAAA,MACX,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,OAAO;AAAA,IACT,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,qBAAqB,KAAK,mCAAmC;AAAA,EACtE;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,120 @@
+import { z } from "zod";
+import { createProduct, createSku, createSkuEan } from "../../services/vtex/vtex-catalog-write.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const productInputSchema = z.object({
+  name: z.string().min(1).describe("Product name."),
+  categoryId: z.number().int().positive().optional().describe("Existing category ID."),
+  categoryPath: z.string().min(1).optional().describe("Category path to create or reuse."),
+  brandId: z.number().int().positive().optional().describe("Existing brand ID."),
+  brandName: z.string().min(1).optional().describe("Brand name to create or reuse."),
+  departmentId: z.number().int().positive().optional().describe("Department ID."),
+  refId: z.string().optional().describe("Product reference code."),
+  title: z.string().optional().describe("SEO title."),
+  description: z.string().optional().describe("Product description."),
+  descriptionShort: z.string().optional().describe("Short description."),
+  linkId: z.string().optional().describe("Product slug.")
+}).refine((value) => value.categoryId !== void 0 || value.categoryPath !== void 0, {
+  message: "Provide either categoryId or categoryPath for the product.",
+  path: ["categoryId"]
+}).refine((value) => value.brandId !== void 0 || value.brandName !== void 0, {
+  message: "Provide either brandId or brandName for the product.",
+  path: ["brandId"]
+});
+const skuInputSchema = z.object({
+  name: z.string().min(1).describe("SKU name."),
+  refId: z.string().min(1).describe("Internal SKU reference code."),
+  ean: z.string().optional().describe("Optional EAN to attach after creation."),
+  packagedHeight: z.number().nonnegative().describe("Packaged height."),
+  packagedLength: z.number().nonnegative().describe("Packaged length."),
+  packagedWidth: z.number().nonnegative().describe("Packaged width."),
+  packagedWeightKg: z.number().nonnegative().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."),
+  activateIfPossible: z.boolean().optional().describe("Whether VTEX should auto-activate the SKU."),
+  measurementUnit: z.string().optional().describe("Measurement unit."),
+  unitMultiplier: z.number().positive().optional().describe("Unit multiplier.")
+});
+const createProductWithSkuSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  product: productInputSchema.describe("Product payload."),
+  sku: skuInputSchema.describe("SKU payload.")
+});
+async function createProductWithSkuHandler({
+  profileId,
+  product,
+  sku
+}) {
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const createdProduct = await createProduct(resolvedProfileId, {
+      Name: product.name,
+      CategoryId: product.categoryId,
+      CategoryPath: product.categoryPath,
+      BrandId: product.brandId,
+      BrandName: product.brandName,
+      DepartmentId: product.departmentId,
+      RefId: product.refId,
+      Title: product.title,
+      Description: product.description,
+      DescriptionShort: product.descriptionShort,
+      LinkId: product.linkId
+    });
+    const productId = Number(createdProduct.Id);
+    const createdSku = await createSku(resolvedProfileId, {
+      ProductId: productId,
+      Name: sku.name,
+      RefId: sku.refId,
+      PackagedHeight: sku.packagedHeight,
+      PackagedLength: sku.packagedLength,
+      PackagedWidth: sku.packagedWidth,
+      PackagedWeightKg: sku.packagedWeightKg,
+      Height: sku.height,
+      Length: sku.length,
+      Width: sku.width,
+      WeightKg: sku.weightKg,
+      ActivateIfPossible: sku.activateIfPossible ?? true,
+      IsActive: false,
+      MeasurementUnit: sku.measurementUnit,
+      UnitMultiplier: sku.unitMultiplier
+    });
+    const skuId = createdSku.Id == null ? void 0 : String(createdSku.Id);
+    if (skuId && sku.ean?.trim()) {
+      await createSkuEan(resolvedProfileId, skuId, sku.ean.trim());
+      createdSku.Eans = [sku.ean.trim()];
+    }
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "create_product_with_sku",
+      resourceId: String(createdProduct.Id),
+      riskLevel: "low",
+      message: "Product and SKU created successfully.",
+      before: null,
+      after: {
+        product: createdProduct,
+        sku: createdSku
+      },
+      details: {
+        product_id: createdProduct.Id,
+        sku_id: createdSku.Id
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, "Failed to create product with SKU in VTEX");
+  }
+}
+export {
+  createProductWithSkuHandler,
+  createProductWithSkuSchema
+};
+//# sourceMappingURL=create-product-with-sku.js.map