@yoryoboy/bi-mcp 1.1.0 → 1.3.0

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

@@ -0,0 +1,38 @@
+class VtexOperationError extends Error {
+  constructor(message, code, details) {
+    super(message);
+    this.code = code;
+    this.details = details;
+    this.name = "VtexOperationError";
+  }
+}
+function buildConfirmationRequiredResult(operation, details) {
+  return {
+    success: false,
+    error_code: "EXPLICIT_CONFIRMATION_REQUIRED",
+    message: "This VTEX operation is high-risk and requires explicit user confirmation before execution.",
+    operation,
+    risk_level: "high",
+    details
+  };
+}
+function buildWriteSuccessResult(params) {
+  return {
+    success: true,
+    profile_id: params.profileId,
+    operation: params.operation,
+    resource_id: params.resourceId,
+    risk_level: params.riskLevel,
+    confirmed: params.confirmed,
+    message: params.message,
+    summary: params.summary,
+    confirmation_note: params.confirmationNote,
+    details: params.details
+  };
+}
+export {
+  VtexOperationError,
+  buildConfirmationRequiredResult,
+  buildWriteSuccessResult
+};
+//# sourceMappingURL=vtex-write.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/services/vtex/vtex-write.ts"],
+  "sourcesContent": ["export type VtexWriteRiskLevel = \"low\" | \"high\";\n\nexport type VtexWriteErrorCode =\n  | \"EXPLICIT_CONFIRMATION_REQUIRED\"\n  | \"INVALID_ORDER_STATE\"\n  | \"RESOURCE_NOT_FOUND\"\n  | \"INVALID_OPERATION\";\n\nexport interface VtexWriteSummary extends Record<string, unknown> {\n  before?: Record<string, unknown> | null;\n  after?: Record<string, unknown> | null;\n}\n\nexport interface VtexWriteResult extends Record<string, unknown> {\n  success: boolean;\n  profile_id?: string;\n  operation: string;\n  resource_id?: string;\n  risk_level: VtexWriteRiskLevel;\n  confirmed?: boolean;\n  message: string;\n  summary?: VtexWriteSummary;\n  confirmation_note?: string;\n  details?: Record<string, unknown>;\n}\n\nexport interface VtexWriteErrorResult extends Record<string, unknown> {\n  success: false;\n  error_code: VtexWriteErrorCode;\n  message: string;\n  operation: string;\n  risk_level: VtexWriteRiskLevel;\n  details?: Record<string, unknown>;\n}\n\nexport class VtexOperationError extends Error {\n  constructor(\n    message: string,\n    public readonly code: VtexWriteErrorCode,\n    public readonly details?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = \"VtexOperationError\";\n  }\n}\n\nexport function buildConfirmationRequiredResult(\n  operation: string,\n  details?: Record<string, unknown>\n): VtexWriteErrorResult {\n  return {\n    success: false,\n    error_code: \"EXPLICIT_CONFIRMATION_REQUIRED\",\n    message: \"This VTEX operation is high-risk and requires explicit user confirmation before execution.\",\n    operation,\n    risk_level: \"high\",\n    details,\n  };\n}\n\nexport function buildWriteSuccessResult(params: {\n  profileId: string;\n  operation: string;\n  resourceId?: string;\n  riskLevel: VtexWriteRiskLevel;\n  confirmed?: boolean;\n  message: string;\n  summary?: VtexWriteSummary;\n  confirmationNote?: string;\n  details?: Record<string, unknown>;\n}): VtexWriteResult {\n  return {\n    success: true,\n    profile_id: params.profileId,\n    operation: params.operation,\n    resource_id: params.resourceId,\n    risk_level: params.riskLevel,\n    confirmed: params.confirmed,\n    message: params.message,\n    summary: params.summary,\n    confirmation_note: params.confirmationNote,\n    details: params.details,\n  };\n}\n"],
+  "mappings": "AAmCO,MAAM,2BAA2B,MAAM;AAAA,EAC5C,YACE,SACgB,MACA,SAChB;AACA,UAAM,OAAO;AAHG;AACA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;AAEO,SAAS,gCACd,WACA,SACsB;AACtB,SAAO;AAAA,IACL,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,SAAS;AAAA,IACT;AAAA,IACA,YAAY;AAAA,IACZ;AAAA,EACF;AACF;AAEO,SAAS,wBAAwB,QAUpB;AAClB,SAAO;AAAA,IACL,SAAS;AAAA,IACT,YAAY,OAAO;AAAA,IACnB,WAAW,OAAO;AAAA,IAClB,aAAa,OAAO;AAAA,IACpB,YAAY,OAAO;AAAA,IACnB,WAAW,OAAO;AAAA,IAClB,SAAS,OAAO;AAAA,IAChB,SAAS,OAAO;AAAA,IAChB,mBAAmB,OAAO;AAAA,IAC1B,SAAS,OAAO;AAAA,EAClB;AACF;",
+  "names": []
+}

package/dist/src/tools/config/check-database-connection.js

@@ -0,0 +1,59 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { checkTableExists, getDatabaseUrl, testDatabaseConnection } from "../../db/client.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const checkDatabaseConnectionSchema = z.object({});
+function getConnectionHints() {
+  const databaseUrl = getDatabaseUrl();
+  if (!databaseUrl) {
+    return {
+      database_url_present: false,
+      host_hint: void 0,
+      port_hint: void 0
+    };
+  }
+  try {
+    const parsedUrl = new URL(databaseUrl);
+    return {
+      database_url_present: true,
+      host_hint: parsedUrl.hostname || void 0,
+      port_hint: parsedUrl.port || void 0
+    };
+  } catch {
+    return {
+      database_url_present: true,
+      host_hint: void 0,
+      port_hint: void 0
+    };
+  }
+}
+async function checkDatabaseConnectionHandler() {
+  try {
+    const result = await testDatabaseConnection();
+    const schemaMigrationsTablePresent = await checkTableExists("schema_migrations");
+    const profilesTablePresent = await checkTableExists("profiles");
+    const profileVtexConnectionsTablePresent = await checkTableExists("profile_vtex_connections");
+    const hints = getConnectionHints();
+    return object(
+      stripNulls({
+        status: "ok",
+        database: result.current_database,
+        user: result.current_user,
+        server_time: result.now.toISOString(),
+        database_url_present: hints.database_url_present,
+        host_hint: hints.host_hint,
+        port_hint: hints.port_hint,
+        schema_migrations_table_present: schemaMigrationsTablePresent,
+        profiles_table_present: profilesTablePresent,
+        profile_vtex_connections_table_present: profileVtexConnectionsTablePresent
+      })
+    );
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "Database connection check failed");
+  }
+}
+export {
+  checkDatabaseConnectionHandler,
+  checkDatabaseConnectionSchema
+};
+//# sourceMappingURL=check-database-connection.js.map

package/dist/src/tools/config/check-database-connection.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/config/check-database-connection.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { checkTableExists, getDatabaseUrl, testDatabaseConnection } from \"../../db/client.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const checkDatabaseConnectionSchema = z.object({});\n\nfunction getConnectionHints() {\n  const databaseUrl = getDatabaseUrl();\n  if (!databaseUrl) {\n    return {\n      database_url_present: false,\n      host_hint: undefined,\n      port_hint: undefined,\n    };\n  }\n\n  try {\n    const parsedUrl = new URL(databaseUrl);\n\n    return {\n      database_url_present: true,\n      host_hint: parsedUrl.hostname || undefined,\n      port_hint: parsedUrl.port || undefined,\n    };\n  } catch {\n    return {\n      database_url_present: true,\n      host_hint: undefined,\n      port_hint: undefined,\n    };\n  }\n}\n\nexport async function checkDatabaseConnectionHandler() {\n  try {\n    const result = await testDatabaseConnection();\n    const schemaMigrationsTablePresent = await checkTableExists(\"schema_migrations\");\n    const profilesTablePresent = await checkTableExists(\"profiles\");\n    const profileVtexConnectionsTablePresent = await checkTableExists(\"profile_vtex_connections\");\n    const hints = getConnectionHints();\n\n    return object(\n      stripNulls({\n        status: \"ok\",\n        database: result.current_database,\n        user: result.current_user,\n        server_time: result.now.toISOString(),\n        database_url_present: hints.database_url_present,\n        host_hint: hints.host_hint,\n        port_hint: hints.port_hint,\n        schema_migrations_table_present: schemaMigrationsTablePresent,\n        profiles_table_present: profilesTablePresent,\n        profile_vtex_connections_table_present: profileVtexConnectionsTablePresent,\n      })\n    );\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Database connection check failed\");\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,kBAAkB,gBAAgB,8BAA8B;AACzE,SAAS,kBAAkB;AAEpB,MAAM,gCAAgC,EAAE,OAAO,CAAC,CAAC;AAExD,SAAS,qBAAqB;AAC5B,QAAM,cAAc,eAAe;AACnC,MAAI,CAAC,aAAa;AAChB,WAAO;AAAA,MACL,sBAAsB;AAAA,MACtB,WAAW;AAAA,MACX,WAAW;AAAA,IACb;AAAA,EACF;AAEA,MAAI;AACF,UAAM,YAAY,IAAI,IAAI,WAAW;AAErC,WAAO;AAAA,MACL,sBAAsB;AAAA,MACtB,WAAW,UAAU,YAAY;AAAA,MACjC,WAAW,UAAU,QAAQ;AAAA,IAC/B;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,MACL,sBAAsB;AAAA,MACtB,WAAW;AAAA,MACX,WAAW;AAAA,IACb;AAAA,EACF;AACF;AAEA,eAAsB,iCAAiC;AACrD,MAAI;AACF,UAAM,SAAS,MAAM,uBAAuB;AAC5C,UAAM,+BAA+B,MAAM,iBAAiB,mBAAmB;AAC/E,UAAM,uBAAuB,MAAM,iBAAiB,UAAU;AAC9D,UAAM,qCAAqC,MAAM,iBAAiB,0BAA0B;AAC5F,UAAM,QAAQ,mBAAmB;AAEjC,WAAO;AAAA,MACL,WAAW;AAAA,QACT,QAAQ;AAAA,QACR,UAAU,OAAO;AAAA,QACjB,MAAM,OAAO;AAAA,QACb,aAAa,OAAO,IAAI,YAAY;AAAA,QACpC,sBAAsB,MAAM;AAAA,QAC5B,WAAW,MAAM;AAAA,QACjB,WAAW,MAAM;AAAA,QACjB,iCAAiC;AAAA,QACjC,wBAAwB;AAAA,QACxB,wCAAwC;AAAA,MAC1C,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,kCAAkC;AAAA,EACtF;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,3 @@
+export * from "./check-database-connection.js";
+export * from "./list-profiles.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/config/index.ts"],
+  "sourcesContent": ["export * from \"./check-database-connection.js\";\nexport * from \"./list-profiles.js\";\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/src/tools/config/list-profiles.js

@@ -0,0 +1,26 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { listProfiles } from "../../config/profile-store.js";
+const listProfilesSchema = z.object({});
+async function listProfilesHandler() {
+  try {
+    const profiles = await listProfiles();
+    return object({
+      total_profiles: profiles.length,
+      profiles: profiles.map((profile) => ({
+        profile_id: profile.id,
+        name: profile.name,
+        is_active: profile.isActive,
+        created_at: profile.createdAt.toISOString(),
+        updated_at: profile.updatedAt.toISOString()
+      }))
+    });
+  } catch (err) {
+    return error(err instanceof Error ? err.message : "Failed to list profiles");
+  }
+}
+export {
+  listProfilesHandler,
+  listProfilesSchema
+};
+//# sourceMappingURL=list-profiles.js.map

package/dist/src/tools/config/list-profiles.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/config/list-profiles.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { listProfiles } from \"../../config/profile-store.js\";\n\nexport const listProfilesSchema = z.object({});\n\nexport async function listProfilesHandler() {\n  try {\n    const profiles = await listProfiles();\n\n    return object({\n      total_profiles: profiles.length,\n      profiles: profiles.map((profile) => ({\n        profile_id: profile.id,\n        name: profile.name,\n        is_active: profile.isActive,\n        created_at: profile.createdAt.toISOString(),\n        updated_at: profile.updatedAt.toISOString(),\n      })),\n    });\n  } catch (err) {\n    return error(err instanceof Error ? err.message : \"Failed to list profiles\");\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,oBAAoB;AAEtB,MAAM,qBAAqB,EAAE,OAAO,CAAC,CAAC;AAE7C,eAAsB,sBAAsB;AAC1C,MAAI;AACF,UAAM,WAAW,MAAM,aAAa;AAEpC,WAAO,OAAO;AAAA,MACZ,gBAAgB,SAAS;AAAA,MACzB,UAAU,SAAS,IAAI,CAAC,aAAa;AAAA,QACnC,YAAY,QAAQ;AAAA,QACpB,MAAM,QAAQ;AAAA,QACd,WAAW,QAAQ;AAAA,QACnB,YAAY,QAAQ,UAAU,YAAY;AAAA,QAC1C,YAAY,QAAQ,UAAU,YAAY;AAAA,MAC5C,EAAE;AAAA,IACJ,CAAC;AAAA,EACH,SAAS,KAAK;AACZ,WAAO,MAAM,eAAe,QAAQ,IAAI,UAAU,yBAAyB;AAAA,EAC7E;AACF;",
+  "names": []
+}

package/dist/src/tools/index.js

@@ -1,3 +1,4 @@
+export * from "./config/index.js";
 export * from "./vtex/index.js";
 export * from "./analytics/index.js";
 export * from "./google-ads/index.js";

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/tools/index.ts"],
-  "sourcesContent": ["export * from \"./vtex/index.js\";\nexport * from \"./analytics/index.js\";\nexport * from \"./google-ads/index.js\";\nexport * from \"./meta/index.js\";\nexport * from \"./search-console/index.js\";\n"],
-  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "sourcesContent": ["export * from \"./config/index.js\";\nexport * from \"./vtex/index.js\";\nexport * from \"./analytics/index.js\";\nexport * from \"./google-ads/index.js\";\nexport * from \"./meta/index.js\";\nexport * from \"./search-console/index.js\";\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

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

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import {
+  buildSkuUpdatePayload,
+  getSku,
+  updateSku
+} from "../../services/vtex/vtex-catalog-write.js";
+import {
+  buildWriteSuccessResponse,
+  handleVtexWriteError,
+  resolveVtexWriteProfile,
+  vtexProfileIdSchemaField
+} from "./write-helpers.js";
+const activateSkuSchema = z.object({
+  profileId: vtexProfileIdSchemaField,
+  skuId: z.string().min(1).describe("VTEX SKU identifier to activate.")
+});
+async function activateSkuHandler({
+  profileId,
+  skuId
+}) {
+  try {
+    const profileResolution = await resolveVtexWriteProfile(profileId);
+    if (!profileResolution.ok) {
+      return profileResolution.response;
+    }
+    const resolvedProfileId = profileResolution.value.profileId;
+    const beforeSku = await getSku(resolvedProfileId, skuId);
+    const afterSku = await updateSku(
+      resolvedProfileId,
+      skuId,
+      buildSkuUpdatePayload(beforeSku, { isActive: true })
+    );
+    return buildWriteSuccessResponse({
+      profileId: resolvedProfileId,
+      operation: "activate_sku",
+      resourceId: skuId,
+      riskLevel: "low",
+      message: "SKU activated successfully.",
+      before: beforeSku,
+      after: afterSku,
+      details: {
+        sku_id: skuId
+      }
+    });
+  } catch (err) {
+    return handleVtexWriteError(err, `Failed to activate SKU ${skuId}`);
+  }
+}
+export {
+  activateSkuHandler,
+  activateSkuSchema
+};
+//# sourceMappingURL=activate-sku.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/vtex/activate-sku.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nimport {\n  buildSkuUpdatePayload,\n  getSku,\n  updateSku,\n} from \"../../services/vtex/vtex-catalog-write.js\";\nimport {\n  buildWriteSuccessResponse,\n  handleVtexWriteError,\n  resolveVtexWriteProfile,\n  vtexProfileIdSchemaField,\n} from \"./write-helpers.js\";\n\nexport const activateSkuSchema = z.object({\n  profileId: vtexProfileIdSchemaField,\n  skuId: z.string().min(1).describe(\"VTEX SKU identifier to activate.\"),\n});\n\nexport async function activateSkuHandler({\n  profileId,\n  skuId,\n}: z.infer<typeof activateSkuSchema>) {\n  try {\n    const profileResolution = await resolveVtexWriteProfile(profileId);\n    if (!profileResolution.ok) {\n      return profileResolution.response;\n    }\n\n    const resolvedProfileId = profileResolution.value.profileId;\n    const beforeSku = await getSku(resolvedProfileId, skuId);\n    const afterSku = await updateSku(\n      resolvedProfileId,\n      skuId,\n      buildSkuUpdatePayload(beforeSku, { isActive: true })\n    );\n\n    return buildWriteSuccessResponse({\n      profileId: resolvedProfileId,\n      operation: \"activate_sku\",\n      resourceId: skuId,\n      riskLevel: \"low\",\n      message: \"SKU activated successfully.\",\n      before: beforeSku,\n      after: afterSku,\n      details: {\n        sku_id: skuId,\n      },\n    });\n  } catch (err) {\n    return handleVtexWriteError(err, `Failed to activate SKU ${skuId}`);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,MAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,WAAW;AAAA,EACX,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,kCAAkC;AACtE,CAAC;AAED,eAAsB,mBAAmB;AAAA,EACvC;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,YAAY,MAAM,OAAO,mBAAmB,KAAK;AACvD,UAAM,WAAW,MAAM;AAAA,MACrB;AAAA,MACA;AAAA,MACA,sBAAsB,WAAW,EAAE,UAAU,KAAK,CAAC;AAAA,IACrD;AAEA,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,0BAA0B,KAAK,EAAE;AAAA,EACpE;AACF;",
+  "names": []
+}

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": []
+}