@yoryoboy/bi-mcp 1.2.0 → 1.3.1

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

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/create-product-with-sku.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport { createProduct, createSku, createSkuEan } from \"../../services/vtex/vtex-catalog-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nconst productInputSchema = z\n  .object({\n    name: z.string().min(1).describe(\"Product name.\"),\n    categoryId: z.number().int().positive().optional().describe(\"Existing category ID.\"),\n    categoryPath: z.string().min(1).optional().describe(\"Category path to create or reuse.\"),\n    brandId: z.number().int().positive().optional().describe(\"Existing brand ID.\"),\n    brandName: z.string().min(1).optional().describe(\"Brand name to create or reuse.\"),\n    departmentId: z.number().int().positive().optional().describe(\"Department ID.\"),\n    refId: z.string().optional().describe(\"Product reference code.\"),\n    title: z.string().optional().describe(\"SEO title.\"),\n    description: z.string().optional().describe(\"Product description.\"),\n    descriptionShort: z.string().optional().describe(\"Short description.\"),\n    linkId: z.string().optional().describe(\"Product slug.\"),\n  })\n  .refine((value) => value.categoryId !== undefined || value.categoryPath !== undefined, {\n    message: \"Provide either categoryId or categoryPath for the product.\",\n    path: [\"categoryId\"],\n  })\n  .refine((value) => value.brandId !== undefined || value.brandName !== undefined, {\n    message: \"Provide either brandId or brandName for the product.\",\n    path: [\"brandId\"],\n  });\n\nconst skuInputSchema = z.object({\n  name: z.string().min(1).describe(\"SKU name.\"),\n  refId: z.string().min(1).describe(\"Internal SKU reference code.\"),\n  ean: z.string().optional().describe(\"Optional EAN to attach after creation.\"),\n  packagedHeight: z.number().nonnegative().describe(\"Packaged height.\"),\n  packagedLength: z.number().nonnegative().describe(\"Packaged length.\"),\n  packagedWidth: z.number().nonnegative().describe(\"Packaged width.\"),\n  packagedWeightKg: z.number().nonnegative().describe(\"Packaged weight in kg.\"),\n  height: z.number().nonnegative().optional().describe(\"Physical height.\"),\n  length: z.number().nonnegative().optional().describe(\"Physical length.\"),\n  width: z.number().nonnegative().optional().describe(\"Physical width.\"),\n  weightKg: z.number().nonnegative().optional().describe(\"Physical weight in kg.\"),\n  activateIfPossible: z.boolean().optional().describe(\"Whether VTEX should auto-activate the SKU.\"),\n  measurementUnit: z.string().optional().describe(\"Measurement unit.\"),\n  unitMultiplier: z.number().positive().optional().describe(\"Unit multiplier.\"),\n});\n\nexport const createProductWithSkuSchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  product: productInputSchema.describe(\"Product payload.\"),\n  sku: skuInputSchema.describe(\"SKU payload.\"),\n});\n\nexport async function createProductWithSkuHandler({\n  profileId,\n  product,\n  sku,\n}: z.infer<typeof createProductWithSkuSchema>) {\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 createdProduct = await createProduct(resolvedProfileId, {\n      Name: product.name,\n      CategoryId: product.categoryId,\n      CategoryPath: product.categoryPath,\n      BrandId: product.brandId,\n      BrandName: product.brandName,\n      DepartmentId: product.departmentId,\n      RefId: product.refId,\n      Title: product.title,\n      Description: product.description,\n      DescriptionShort: product.descriptionShort,\n      LinkId: product.linkId,\n    });\n\n    const productId = Number(createdProduct.Id);\n    const createdSku = await createSku(resolvedProfileId, {\n      ProductId: productId,\n      Name: sku.name,\n      RefId: sku.refId,\n      PackagedHeight: sku.packagedHeight,\n      PackagedLength: sku.packagedLength,\n      PackagedWidth: sku.packagedWidth,\n      PackagedWeightKg: sku.packagedWeightKg,\n      Height: sku.height,\n      Length: sku.length,\n      Width: sku.width,\n      WeightKg: sku.weightKg,\n      ActivateIfPossible: sku.activateIfPossible ?? true,\n      IsActive: false,\n      MeasurementUnit: sku.measurementUnit,\n      UnitMultiplier: sku.unitMultiplier,\n    });\n\n    const skuId = createdSku.Id == null ? undefined : String(createdSku.Id);\n    if (skuId && sku.ean?.trim()) {\n      await createSkuEan(resolvedProfileId, skuId, sku.ean.trim());\n      createdSku.Eans = [sku.ean.trim()];\n    }\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"create_product_with_sku\",\n      resourceId: String(createdProduct.Id),\n      riskLevel: \"low\",\n      message: \"Product and SKU created successfully.\",\n      before: null,\n      after: {\n        product: createdProduct,\n        sku: createdSku,\n      },\n      details: {\n        product_id: createdProduct.Id,\n        sku_id: createdSku.Id,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, \"Failed to create product with SKU in VTEX\");\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB,SAAS,eAAe,WAAW,oBAAoB;AACvD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,MAAM,qBAAqB,EACxB,OAAO;AAAA,EACN,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,eAAe;AAAA,EAChD,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,uBAAuB;AAAA,EACnF,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,mCAAmC;AAAA,EACvF,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,oBAAoB;AAAA,EAC7E,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,gCAAgC;AAAA,EACjF,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,gBAAgB;AAAA,EAC9E,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,yBAAyB;AAAA,EAC/D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,YAAY;AAAA,EAClD,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,sBAAsB;AAAA,EAClE,kBAAkB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,oBAAoB;AAAA,EACrE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,eAAe;AACxD,CAAC,EACA,OAAO,CAAC,UAAU,MAAM,eAAe,UAAa,MAAM,iBAAiB,QAAW;AAAA,EACrF,SAAS;AAAA,EACT,MAAM,CAAC,YAAY;AACrB,CAAC,EACA,OAAO,CAAC,UAAU,MAAM,YAAY,UAAa,MAAM,cAAc,QAAW;AAAA,EAC/E,SAAS;AAAA,EACT,MAAM,CAAC,SAAS;AAClB,CAAC;AAEH,MAAM,iBAAiB,EAAE,OAAO;AAAA,EAC9B,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,WAAW;AAAA,EAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,8BAA8B;AAAA,EAChE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,wCAAwC;AAAA,EAC5E,gBAAgB,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,kBAAkB;AAAA,EACpE,gBAAgB,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,kBAAkB;AAAA,EACpE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,iBAAiB;AAAA,EAClE,kBAAkB,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,wBAAwB;AAAA,EAC5E,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,kBAAkB;AAAA,EACvE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,kBAAkB;AAAA,EACvE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,iBAAiB;AAAA,EACrE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,wBAAwB;AAAA,EAC/E,oBAAoB,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,4CAA4C;AAAA,EAChG,iBAAiB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,mBAAmB;AAAA,EACnE,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,kBAAkB;AAC9E,CAAC;AAEM,MAAM,6BAA6B,EAAE,OAAO;AAAA,EACjD,WAAW;AAAA,EACX,SAAS,mBAAmB,SAAS,kBAAkB;AAAA,EACvD,KAAK,eAAe,SAAS,cAAc;AAC7C,CAAC;AAED,eAAsB,4BAA4B;AAAA,EAChD;AAAA,EACA;AAAA,EACA;AACF,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,iBAAiB,MAAM,cAAc,mBAAmB;AAAA,MAC5D,MAAM,QAAQ;AAAA,MACd,YAAY,QAAQ;AAAA,MACpB,cAAc,QAAQ;AAAA,MACtB,SAAS,QAAQ;AAAA,MACjB,WAAW,QAAQ;AAAA,MACnB,cAAc,QAAQ;AAAA,MACtB,OAAO,QAAQ;AAAA,MACf,OAAO,QAAQ;AAAA,MACf,aAAa,QAAQ;AAAA,MACrB,kBAAkB,QAAQ;AAAA,MAC1B,QAAQ,QAAQ;AAAA,IAClB,CAAC;AAED,UAAM,YAAY,OAAO,eAAe,EAAE;AAC1C,UAAM,aAAa,MAAM,UAAU,mBAAmB;AAAA,MACpD,WAAW;AAAA,MACX,MAAM,IAAI;AAAA,MACV,OAAO,IAAI;AAAA,MACX,gBAAgB,IAAI;AAAA,MACpB,gBAAgB,IAAI;AAAA,MACpB,eAAe,IAAI;AAAA,MACnB,kBAAkB,IAAI;AAAA,MACtB,QAAQ,IAAI;AAAA,MACZ,QAAQ,IAAI;AAAA,MACZ,OAAO,IAAI;AAAA,MACX,UAAU,IAAI;AAAA,MACd,oBAAoB,IAAI,sBAAsB;AAAA,MAC9C,UAAU;AAAA,MACV,iBAAiB,IAAI;AAAA,MACrB,gBAAgB,IAAI;AAAA,IACtB,CAAC;AAED,UAAM,QAAQ,WAAW,MAAM,OAAO,SAAY,OAAO,WAAW,EAAE;AACtE,QAAI,SAAS,IAAI,KAAK,KAAK,GAAG;AAC5B,YAAM,aAAa,mBAAmB,OAAO,IAAI,IAAI,KAAK,CAAC;AAC3D,iBAAW,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC;AAAA,IACnC;AAEA,WAAO,0BAA0B;AAAA,MAC/B,WAAW;AAAA,MACX,WAAW;AAAA,MACX,YAAY,OAAO,eAAe,EAAE;AAAA,MACpC,WAAW;AAAA,MACX,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,OAAO;AAAA,QACL,SAAS;AAAA,QACT,KAAK;AAAA,MACP;AAAA,MACA,SAAS;AAAA,QACP,YAAY,eAAe;AAAA,QAC3B,QAAQ,WAAW;AAAA,MACrB;AAAA,IACF,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,qBAAqB,KAAK,2CAA2C;AAAA,EAC9E;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,111 @@
+import { z } from "zod";
+import { createProduct } from "../../services/vtex/vtex-catalog-write.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const createProductSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  name: z.string().min(1).describe("Product name."),
+  categoryId: z.number().int().positive().optional().describe("Existing VTEX category ID."),
+  categoryPath: z.string().min(1).optional().describe("Category path to create or reuse, for example `Mens/Clothing/T-Shirts`."),
+  brandId: z.number().int().positive().optional().describe("Existing VTEX brand ID."),
+  brandName: z.string().min(1).optional().describe("Brand name to create or reuse when `brandId` is not provided."),
+  departmentId: z.number().int().positive().optional().describe("Department ID for the category."),
+  refId: z.string().optional().describe("Internal product reference code."),
+  title: z.string().optional().describe("SEO title."),
+  description: z.string().optional().describe("Product description."),
+  descriptionShort: z.string().optional().describe("Short product description."),
+  linkId: z.string().optional().describe("Product slug."),
+  releaseDate: z.string().optional().describe("Product release date in ISO format."),
+  keyWords: z.string().optional().describe("Keywords string."),
+  isVisible: z.boolean().optional().describe("Whether the product should be visible in listings."),
+  isActive: z.boolean().optional().describe("Whether the product should be active."),
+  taxCode: z.string().optional().describe("Tax code."),
+  metaTagDescription: z.string().optional().describe("Meta description."),
+  supplierId: z.number().int().positive().optional().describe("Supplier identifier."),
+  showWithoutStock: z.boolean().optional().describe("Whether the product stays visible without stock."),
+  score: z.number().int().optional().describe("Search score.")
+}).refine((value) => value.categoryId !== void 0 || value.categoryPath !== void 0, {
+  message: "Provide either categoryId or categoryPath.",
+  path: ["categoryId"]
+}).refine((value) => value.brandId !== void 0 || value.brandName !== void 0, {
+  message: "Provide either brandId or brandName.",
+  path: ["brandId"]
+});
+async function createProductHandler({
+  profileId,
+  name,
+  categoryId,
+  categoryPath,
+  brandId,
+  brandName,
+  departmentId,
+  refId,
+  title,
+  description,
+  descriptionShort,
+  linkId,
+  releaseDate,
+  keyWords,
+  isVisible,
+  isActive,
+  taxCode,
+  metaTagDescription,
+  supplierId,
+  showWithoutStock,
+  score
+}) {
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const payload = {
+      Name: name
+    };
+    if (categoryId !== void 0) payload.CategoryId = categoryId;
+    if (categoryPath !== void 0) payload.CategoryPath = categoryPath;
+    if (brandId !== void 0) payload.BrandId = brandId;
+    if (brandName !== void 0) payload.BrandName = brandName;
+    if (departmentId !== void 0) payload.DepartmentId = departmentId;
+    if (refId !== void 0) payload.RefId = refId;
+    if (title !== void 0) payload.Title = title;
+    if (description !== void 0) payload.Description = description;
+    if (descriptionShort !== void 0) payload.DescriptionShort = descriptionShort;
+    if (linkId !== void 0) payload.LinkId = linkId;
+    if (releaseDate !== void 0) payload.ReleaseDate = releaseDate;
+    if (keyWords !== void 0) payload.KeyWords = keyWords;
+    if (isVisible !== void 0) payload.IsVisible = isVisible;
+    if (isActive !== void 0) payload.IsActive = isActive;
+    if (taxCode !== void 0) payload.TaxCode = taxCode;
+    if (metaTagDescription !== void 0) payload.MetaTagDescription = metaTagDescription;
+    if (supplierId !== void 0) payload.SupplierId = supplierId;
+    if (showWithoutStock !== void 0) payload.ShowWithoutStock = showWithoutStock;
+    if (score !== void 0) payload.Score = score;
+    const createdProduct = await createProduct(resolvedProfileId, payload);
+    const resourceId = createdProduct.Id == null ? void 0 : String(createdProduct.Id);
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "create_product",
+      resourceId,
+      riskLevel: "low",
+      message: "Product created successfully.",
+      before: null,
+      after: createdProduct,
+      details: {
+        product_id: resourceId
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, "Failed to create product in VTEX");
+  }
+}
+export {
+  createProductHandler,
+  createProductSchema
+};
+//# sourceMappingURL=create-product.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/create-product.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport { createProduct } from \"../../services/vtex/vtex-catalog-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nexport const createProductSchema = z\n  .object({\n    profileId: vtexProfileIdSchemaField,\n    name: z.string().min(1).describe(\"Product name.\"),\n    categoryId: z.number().int().positive().optional().describe(\"Existing VTEX category ID.\"),\n    categoryPath: z\n      .string()\n      .min(1)\n      .optional()\n      .describe(\"Category path to create or reuse, for example `Mens/Clothing/T-Shirts`.\"),\n    brandId: z.number().int().positive().optional().describe(\"Existing VTEX brand ID.\"),\n    brandName: z\n      .string()\n      .min(1)\n      .optional()\n      .describe(\"Brand name to create or reuse when `brandId` is not provided.\"),\n    departmentId: z.number().int().positive().optional().describe(\"Department ID for the category.\"),\n    refId: z.string().optional().describe(\"Internal product reference code.\"),\n    title: z.string().optional().describe(\"SEO title.\"),\n    description: z.string().optional().describe(\"Product description.\"),\n    descriptionShort: z.string().optional().describe(\"Short product description.\"),\n    linkId: z.string().optional().describe(\"Product slug.\"),\n    releaseDate: z.string().optional().describe(\"Product release date in ISO format.\"),\n    keyWords: z.string().optional().describe(\"Keywords string.\"),\n    isVisible: z.boolean().optional().describe(\"Whether the product should be visible in listings.\"),\n    isActive: z.boolean().optional().describe(\"Whether the product should be active.\"),\n    taxCode: z.string().optional().describe(\"Tax code.\"),\n    metaTagDescription: z.string().optional().describe(\"Meta description.\"),\n    supplierId: z.number().int().positive().optional().describe(\"Supplier identifier.\"),\n    showWithoutStock: z.boolean().optional().describe(\"Whether the product stays visible without stock.\"),\n    score: z.number().int().optional().describe(\"Search score.\"),\n  })\n  .refine((value) => value.categoryId !== undefined || value.categoryPath !== undefined, {\n    message: \"Provide either categoryId or categoryPath.\",\n    path: [\"categoryId\"],\n  })\n  .refine((value) => value.brandId !== undefined || value.brandName !== undefined, {\n    message: \"Provide either brandId or brandName.\",\n    path: [\"brandId\"],\n  });\n\nexport async function createProductHandler({\n  profileId,\n  name,\n  categoryId,\n  categoryPath,\n  brandId,\n  brandName,\n  departmentId,\n  refId,\n  title,\n  description,\n  descriptionShort,\n  linkId,\n  releaseDate,\n  keyWords,\n  isVisible,\n  isActive,\n  taxCode,\n  metaTagDescription,\n  supplierId,\n  showWithoutStock,\n  score,\n}: z.infer<typeof createProductSchema>) {\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      Name: name,\n    };\n\n    if (categoryId !== undefined) payload.CategoryId = categoryId;\n    if (categoryPath !== undefined) payload.CategoryPath = categoryPath;\n    if (brandId !== undefined) payload.BrandId = brandId;\n    if (brandName !== undefined) payload.BrandName = brandName;\n    if (departmentId !== undefined) payload.DepartmentId = departmentId;\n    if (refId !== undefined) payload.RefId = refId;\n    if (title !== undefined) payload.Title = title;\n    if (description !== undefined) payload.Description = description;\n    if (descriptionShort !== undefined) payload.DescriptionShort = descriptionShort;\n    if (linkId !== undefined) payload.LinkId = linkId;\n    if (releaseDate !== undefined) payload.ReleaseDate = releaseDate;\n    if (keyWords !== undefined) payload.KeyWords = keyWords;\n    if (isVisible !== undefined) payload.IsVisible = isVisible;\n    if (isActive !== undefined) payload.IsActive = isActive;\n    if (taxCode !== undefined) payload.TaxCode = taxCode;\n    if (metaTagDescription !== undefined) payload.MetaTagDescription = metaTagDescription;\n    if (supplierId !== undefined) payload.SupplierId = supplierId;\n    if (showWithoutStock !== undefined) payload.ShowWithoutStock = showWithoutStock;\n    if (score !== undefined) payload.Score = score;\n\n    const createdProduct = await createProduct(resolvedProfileId, payload);\n    const resourceId = createdProduct.Id == null ? undefined : String(createdProduct.Id);\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"create_product\",\n      resourceId,\n      riskLevel: \"low\",\n      message: \"Product created successfully.\",\n      before: null,\n      after: createdProduct,\n      details: {\n        product_id: resourceId,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, \"Failed to create product in VTEX\");\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,103 @@
+import { z } from "zod";
+import { createSku, createSkuEan } from "../../services/vtex/vtex-catalog-write.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const createSkuSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  productId: z.number().int().positive().describe("Parent product ID."),
+  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 SKU 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."),
+  isActive: z.boolean().optional().describe("Whether the SKU should be created as active. VTEX recommends false during creation."),
+  activateIfPossible: z.boolean().optional().describe("Whether VTEX should auto-activate the SKU when an image or active component exists."),
+  measurementUnit: z.string().optional().describe("Measurement unit, for example `un`."),
+  unitMultiplier: z.number().positive().optional().describe("Unit multiplier."),
+  manufacturerCode: z.string().optional().describe("Manufacturer code."),
+  commercialConditionId: z.number().int().positive().optional().describe("Commercial condition ID.")
+});
+async function createSkuHandler({
+  profileId,
+  productId,
+  name,
+  refId,
+  ean,
+  packagedHeight,
+  packagedLength,
+  packagedWidth,
+  packagedWeightKg,
+  height,
+  length,
+  width,
+  weightKg,
+  isActive,
+  activateIfPossible,
+  measurementUnit,
+  unitMultiplier,
+  manufacturerCode,
+  commercialConditionId
+}) {
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const payload = {
+      ProductId: productId,
+      Name: name,
+      RefId: refId,
+      PackagedHeight: packagedHeight,
+      PackagedLength: packagedLength,
+      PackagedWidth: packagedWidth,
+      PackagedWeightKg: packagedWeightKg,
+      ActivateIfPossible: activateIfPossible ?? true,
+      IsActive: isActive ?? false
+    };
+    if (height !== void 0) payload.Height = height;
+    if (length !== void 0) payload.Length = length;
+    if (width !== void 0) payload.Width = width;
+    if (weightKg !== void 0) payload.WeightKg = weightKg;
+    if (measurementUnit !== void 0) payload.MeasurementUnit = measurementUnit;
+    if (unitMultiplier !== void 0) payload.UnitMultiplier = unitMultiplier;
+    if (manufacturerCode !== void 0) payload.ManufacturerCode = manufacturerCode;
+    if (commercialConditionId !== void 0) payload.CommercialConditionId = commercialConditionId;
+    const createdSku = await createSku(resolvedProfileId, payload);
+    const resourceId = createdSku.Id == null ? void 0 : String(createdSku.Id);
+    if (resourceId && ean?.trim()) {
+      await createSkuEan(resolvedProfileId, resourceId, ean.trim());
+      createdSku.Eans = [ean.trim()];
+    }
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "create_sku",
+      resourceId,
+      riskLevel: "low",
+      message: "SKU created successfully.",
+      before: null,
+      after: createdSku,
+      details: {
+        product_id: productId,
+        sku_id: resourceId
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, "Failed to create SKU in VTEX");
+  }
+}
+export {
+  createSkuHandler,
+  createSkuSchema
+};
+//# sourceMappingURL=create-sku.js.map