@yoryoboy/bi-mcp 1.13.0 → 1.14.2

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

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

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

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

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

@@ -0,0 +1,34 @@
+import { readFile } from "node:fs/promises";
+import { describe, expect, it } from "vitest";
+describe("VTEX commercial conditions documentation", () => {
+  it("documents the corrected VTEX commercial conditions capability across project docs", async () => {
+    const projectStatus = await readFile(new URL("../../docs/PROJECT_STATUS.md", import.meta.url), "utf8");
+    const keyEndpoints = await readFile(
+      new URL("../../src/services/vtex/docs/vtex-key-endpoints.md", import.meta.url),
+      "utf8"
+    );
+    const dashboardCapabilities = await readFile(
+      new URL("../../../bi-mcp-dashboard/docs/content/CAPACIDADES_MCP.md", import.meta.url),
+      "utf8"
+    );
+    expect(projectStatus).toContain("`35` tools VTEX.");
+    expect(projectStatus).toContain("condiciones comerciales solo lectura oficial");
+    expect(keyEndpoints).toContain("Commercial conditions Catalog reads and legacy payment rules writes");
+    expect(keyEndpoints).toContain("/api/catalog_system/pvt/commercialcondition/list");
+    expect(keyEndpoints).toContain("manually in VTEX Admin");
+    expect(keyEndpoints).toContain("`vtex_payment_rules`");
+    expect(dashboardCapabilities).toContain(
+      "Gesti\xF3n de Condiciones Comerciales y Reglas de Pago"
+    );
+    expect(dashboardCapabilities).toContain("`vtex_commercial_conditions`");
+    expect(dashboardCapabilities).toContain("`vtex_payment_rules`");
+    expect(dashboardCapabilities).toContain("solo permite listar y consultar condiciones comerciales");
+    expect(dashboardCapabilities).toContain(
+      "crear manualmente la condici\xF3n faltante en VTEX Admin"
+    );
+    expect(dashboardCapabilities).not.toContain(
+      "primero conviene administrar esa condici\xF3n y sus reglas desde `vtex_commercial_conditions`"
+    );
+  });
+});
+//# sourceMappingURL=vtex-commercial-conditions-docs.test.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../tests/vtex/vtex-commercial-conditions-docs.test.ts"],
+  "sourcesContent": ["import { readFile } from \"node:fs/promises\";\nimport { describe, expect, it } from \"vitest\";\n\ndescribe(\"VTEX commercial conditions documentation\", () => {\n  it(\"documents the corrected VTEX commercial conditions capability across project docs\", async () => {\n    const projectStatus = await readFile(new URL(\"../../docs/PROJECT_STATUS.md\", import.meta.url), \"utf8\");\n    const keyEndpoints = await readFile(\n      new URL(\"../../src/services/vtex/docs/vtex-key-endpoints.md\", import.meta.url),\n      \"utf8\"\n    );\n    const dashboardCapabilities = await readFile(\n      new URL(\"../../../bi-mcp-dashboard/docs/content/CAPACIDADES_MCP.md\", import.meta.url),\n      \"utf8\"\n    );\n\n    expect(projectStatus).toContain(\"`35` tools VTEX.\");\n    expect(projectStatus).toContain(\"condiciones comerciales solo lectura oficial\");\n\n    expect(keyEndpoints).toContain(\"Commercial conditions Catalog reads and legacy payment rules writes\");\n    expect(keyEndpoints).toContain(\"/api/catalog_system/pvt/commercialcondition/list\");\n    expect(keyEndpoints).toContain(\"manually in VTEX Admin\");\n    expect(keyEndpoints).toContain(\"`vtex_payment_rules`\");\n\n    expect(dashboardCapabilities).toContain(\n      \"Gesti\u00F3n de Condiciones Comerciales y Reglas de Pago\"\n    );\n    expect(dashboardCapabilities).toContain(\"`vtex_commercial_conditions`\");\n    expect(dashboardCapabilities).toContain(\"`vtex_payment_rules`\");\n    expect(dashboardCapabilities).toContain(\"solo permite listar y consultar condiciones comerciales\");\n    expect(dashboardCapabilities).toContain(\n      \"crear manualmente la condici\u00F3n faltante en VTEX Admin\"\n    );\n    expect(dashboardCapabilities).not.toContain(\n      \"primero conviene administrar esa condici\u00F3n y sus reglas desde `vtex_commercial_conditions`\"\n    );\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,gBAAgB;AACzB,SAAS,UAAU,QAAQ,UAAU;AAErC,SAAS,4CAA4C,MAAM;AACzD,KAAG,qFAAqF,YAAY;AAClG,UAAM,gBAAgB,MAAM,SAAS,IAAI,IAAI,gCAAgC,YAAY,GAAG,GAAG,MAAM;AACrG,UAAM,eAAe,MAAM;AAAA,MACzB,IAAI,IAAI,sDAAsD,YAAY,GAAG;AAAA,MAC7E;AAAA,IACF;AACA,UAAM,wBAAwB,MAAM;AAAA,MAClC,IAAI,IAAI,6DAA6D,YAAY,GAAG;AAAA,MACpF;AAAA,IACF;AAEA,WAAO,aAAa,EAAE,UAAU,kBAAkB;AAClD,WAAO,aAAa,EAAE,UAAU,8CAA8C;AAE9E,WAAO,YAAY,EAAE,UAAU,qEAAqE;AACpG,WAAO,YAAY,EAAE,UAAU,kDAAkD;AACjF,WAAO,YAAY,EAAE,UAAU,wBAAwB;AACvD,WAAO,YAAY,EAAE,UAAU,sBAAsB;AAErD,WAAO,qBAAqB,EAAE;AAAA,MAC5B;AAAA,IACF;AACA,WAAO,qBAAqB,EAAE,UAAU,8BAA8B;AACtE,WAAO,qBAAqB,EAAE,UAAU,sBAAsB;AAC9D,WAAO,qBAAqB,EAAE,UAAU,yDAAyD;AACjG,WAAO,qBAAqB,EAAE;AAAA,MAC5B;AAAA,IACF;AACA,WAAO,qBAAqB,EAAE,IAAI;AAAA,MAChC;AAAA,IACF;AAAA,EACF,CAAC;AACH,CAAC;",
+  "names": []
+}

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

@@ -0,0 +1,151 @@
+import { readFile } from "node:fs/promises";
+import { describe, expect, it } from "vitest";
+describe("VTEX commercial conditions server surface", () => {
+  it("registers and lists both tools through the MCP layer without schema compatibility failures", async () => {
+    const previousNodeEnv = process.env.NODE_ENV;
+    const previousTelemetry = process.env.MCP_USE_ANONYMIZED_TELEMETRY;
+    process.env.NODE_ENV = "production";
+    process.env.MCP_USE_ANONYMIZED_TELEMETRY = "false";
+    try {
+      const [
+        { MCPServer, object },
+        { MCPClient },
+        commercialConditionsModule,
+        paymentRulesModule
+      ] = await Promise.all([
+        import("mcp-use/server"),
+        import("mcp-use"),
+        import("../../src/tools/vtex/commercial-conditions.js"),
+        import("../../src/tools/vtex/payment-rules.js")
+      ]);
+      const server = new MCPServer({
+        name: "test-vtex-payments-server",
+        version: "1.0.0",
+        baseUrl: "http://localhost:3000"
+      });
+      server.tool(
+        {
+          name: "vtex_commercial_conditions",
+          description: "Read VTEX commercial conditions.",
+          schema: commercialConditionsModule.commercialConditionsSchema,
+          annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true
+          }
+        },
+        async (params) => commercialConditionsModule.commercialConditionsHandler(params)
+      );
+      server.tool(
+        {
+          name: "vtex_payment_rules",
+          description: "Manage VTEX payment rules.",
+          schema: paymentRulesModule.paymentRulesSchema,
+          annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: true
+          }
+        },
+        async (params) => paymentRulesModule.paymentRulesHandler(params)
+      );
+      const handler = await server.getHandler();
+      const client = new MCPClient({
+        mcpServers: {
+          local: {
+            url: "http://localhost:3000/mcp",
+            transport: "http",
+            fetch: (input, init) => {
+              if (input instanceof Request) {
+                return handler(init === void 0 ? input : new Request(input, init));
+              }
+              return handler(new Request(input, init));
+            }
+          }
+        }
+      });
+      try {
+        const session = await client.createSession("local");
+        const tools = await session.listTools();
+        expect(tools).toEqual(
+          expect.arrayContaining([
+            expect.objectContaining({
+              name: "vtex_commercial_conditions",
+              inputSchema: expect.objectContaining({
+                properties: expect.objectContaining({
+                  action: expect.any(Object),
+                  profileId: expect.any(Object)
+                })
+              })
+            }),
+            expect.objectContaining({
+              name: "vtex_payment_rules",
+              inputSchema: expect.objectContaining({
+                properties: expect.objectContaining({
+                  action: expect.any(Object),
+                  profileId: expect.any(Object)
+                })
+              })
+            })
+          ])
+        );
+      } finally {
+        await client.closeAllSessions();
+        await server.close();
+      }
+    } finally {
+      if (previousNodeEnv === void 0) {
+        delete process.env.NODE_ENV;
+      } else {
+        process.env.NODE_ENV = previousNodeEnv;
+      }
+      if (previousTelemetry === void 0) {
+        delete process.env.MCP_USE_ANONYMIZED_TELEMETRY;
+      } else {
+        process.env.MCP_USE_ANONYMIZED_TELEMETRY = previousTelemetry;
+      }
+    }
+  });
+  it("exports and registers both action-based payments tools", async () => {
+    const serverSource = await readFile(new URL("../../index.ts", import.meta.url), "utf8");
+    const exportsSource = await readFile(new URL("../../src/tools/vtex/index.ts", import.meta.url), "utf8");
+    expect(exportsSource).toContain('export * from "./commercial-conditions.js"');
+    expect(exportsSource).toContain('export * from "./payment-rules.js"');
+    const commercialConditionsStart = serverSource.indexOf('name: "vtex_commercial_conditions"');
+    const paymentRulesStart = serverSource.indexOf('name: "vtex_payment_rules"');
+    expect(commercialConditionsStart, "vtex_commercial_conditions registration exists").toBeGreaterThan(-1);
+    expect(paymentRulesStart, "vtex_payment_rules registration exists").toBeGreaterThan(-1);
+    const commercialConditionsBlock = serverSource.slice(commercialConditionsStart, commercialConditionsStart + 900);
+    const paymentRulesBlock = serverSource.slice(paymentRulesStart, paymentRulesStart + 900);
+    expect(commercialConditionsBlock).toContain("readOnlyHint: true");
+    expect(commercialConditionsBlock).toContain("destructiveHint: false");
+    expect(commercialConditionsBlock).toContain("openWorldHint: true");
+    expect(paymentRulesBlock).toContain("readOnlyHint: false");
+    expect(paymentRulesBlock).toContain("destructiveHint: true");
+    expect(paymentRulesBlock).toContain("openWorldHint: true");
+  });
+  it("keeps both tool descriptions business-safe and action-focused", async () => {
+    const serverSource = await readFile(new URL("../../index.ts", import.meta.url), "utf8");
+    const commercialConditionsStart = serverSource.indexOf('name: "vtex_commercial_conditions"');
+    const paymentRulesStart = serverSource.indexOf('name: "vtex_payment_rules"');
+    expect(commercialConditionsStart).toBeGreaterThan(-1);
+    expect(paymentRulesStart).toBeGreaterThan(-1);
+    const commercialConditionsBlock = serverSource.slice(commercialConditionsStart, commercialConditionsStart + 900);
+    const paymentRulesBlock = serverSource.slice(paymentRulesStart, paymentRulesStart + 900);
+    expect(commercialConditionsBlock).toContain(
+      "list available condition records or get a specific condition"
+    );
+    expect(commercialConditionsBlock).toContain("cannot be created or modified through this API");
+    expect(commercialConditionsBlock).toContain("created manually in the VTEX admin panel");
+    expect(commercialConditionsBlock).not.toContain("sandbox");
+    expect(commercialConditionsBlock).not.toContain("Delete operations require confirmed=true");
+    expect(paymentRulesBlock).toContain(
+      "rules that map installments, payment systems, and optional commercial-condition restrictions"
+    );
+    expect(paymentRulesBlock).toContain("Delete operations require confirmed=true");
+    expect(paymentRulesBlock).not.toContain("sandbox");
+    expect(paymentRulesBlock).not.toContain("production writes");
+    expect(paymentRulesBlock).not.toContain("legacy VTEX Payments endpoint");
+  });
+});
+//# sourceMappingURL=vtex-commercial-conditions-surface.test.js.map

package/dist/tests/vtex/vtex-commercial-conditions-surface.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../tests/vtex/vtex-commercial-conditions-surface.test.ts"],
+  "sourcesContent": ["import { readFile } from \"node:fs/promises\";\nimport { describe, expect, it } from \"vitest\";\n\ndescribe(\"VTEX commercial conditions server surface\", () => {\n  it(\"registers and lists both tools through the MCP layer without schema compatibility failures\", async () => {\n    const previousNodeEnv = process.env.NODE_ENV;\n    const previousTelemetry = process.env.MCP_USE_ANONYMIZED_TELEMETRY;\n\n    process.env.NODE_ENV = \"production\";\n    process.env.MCP_USE_ANONYMIZED_TELEMETRY = \"false\";\n\n    try {\n      const [\n        { MCPServer, object },\n        { MCPClient },\n        commercialConditionsModule,\n        paymentRulesModule,\n      ] = await Promise.all([\n        import(\"mcp-use/server\"),\n        import(\"mcp-use\"),\n        import(\"../../src/tools/vtex/commercial-conditions.js\"),\n        import(\"../../src/tools/vtex/payment-rules.js\"),\n      ]);\n\n      const server = new MCPServer({\n        name: \"test-vtex-payments-server\",\n        version: \"1.0.0\",\n        baseUrl: \"http://localhost:3000\",\n      });\n\n      server.tool(\n        {\n          name: \"vtex_commercial_conditions\",\n          description: \"Read VTEX commercial conditions.\",\n          schema: commercialConditionsModule.commercialConditionsSchema,\n          annotations: {\n            readOnlyHint: true,\n            destructiveHint: false,\n            openWorldHint: true,\n          },\n        },\n        async (params) => commercialConditionsModule.commercialConditionsHandler(params)\n      );\n\n      server.tool(\n        {\n          name: \"vtex_payment_rules\",\n          description: \"Manage VTEX payment rules.\",\n          schema: paymentRulesModule.paymentRulesSchema,\n          annotations: {\n            readOnlyHint: false,\n            destructiveHint: true,\n            openWorldHint: true,\n          },\n        },\n        async (params) => paymentRulesModule.paymentRulesHandler(params)\n      );\n\n      const handler = await server.getHandler();\n      const client = new MCPClient({\n        mcpServers: {\n          local: {\n            url: \"http://localhost:3000/mcp\",\n            transport: \"http\",\n            fetch: (input: Request | URL | string, init?: RequestInit) => {\n              if (input instanceof Request) {\n                return handler(init === undefined ? input : new Request(input, init));\n              }\n\n              return handler(new Request(input, init));\n            },\n          },\n        },\n      });\n\n      try {\n        const session = await client.createSession(\"local\");\n        const tools = await session.listTools();\n\n        expect(tools).toEqual(\n          expect.arrayContaining([\n            expect.objectContaining({\n              name: \"vtex_commercial_conditions\",\n              inputSchema: expect.objectContaining({\n                properties: expect.objectContaining({\n                  action: expect.any(Object),\n                  profileId: expect.any(Object),\n                }),\n              }),\n            }),\n            expect.objectContaining({\n              name: \"vtex_payment_rules\",\n              inputSchema: expect.objectContaining({\n                properties: expect.objectContaining({\n                  action: expect.any(Object),\n                  profileId: expect.any(Object),\n                }),\n              }),\n            }),\n          ])\n        );\n      } finally {\n        await client.closeAllSessions();\n        await server.close();\n      }\n    } finally {\n      if (previousNodeEnv === undefined) {\n        delete process.env.NODE_ENV;\n      } else {\n        process.env.NODE_ENV = previousNodeEnv;\n      }\n\n      if (previousTelemetry === undefined) {\n        delete process.env.MCP_USE_ANONYMIZED_TELEMETRY;\n      } else {\n        process.env.MCP_USE_ANONYMIZED_TELEMETRY = previousTelemetry;\n      }\n    }\n  });\n\n  it(\"exports and registers both action-based payments tools\", async () => {\n    const serverSource = await readFile(new URL(\"../../index.ts\", import.meta.url), \"utf8\");\n    const exportsSource = await readFile(new URL(\"../../src/tools/vtex/index.ts\", import.meta.url), \"utf8\");\n\n    expect(exportsSource).toContain('export * from \"./commercial-conditions.js\"');\n    expect(exportsSource).toContain('export * from \"./payment-rules.js\"');\n\n    const commercialConditionsStart = serverSource.indexOf('name: \"vtex_commercial_conditions\"');\n    const paymentRulesStart = serverSource.indexOf('name: \"vtex_payment_rules\"');\n\n    expect(commercialConditionsStart, \"vtex_commercial_conditions registration exists\").toBeGreaterThan(-1);\n    expect(paymentRulesStart, \"vtex_payment_rules registration exists\").toBeGreaterThan(-1);\n\n    const commercialConditionsBlock = serverSource.slice(commercialConditionsStart, commercialConditionsStart + 900);\n    const paymentRulesBlock = serverSource.slice(paymentRulesStart, paymentRulesStart + 900);\n\n    expect(commercialConditionsBlock).toContain(\"readOnlyHint: true\");\n    expect(commercialConditionsBlock).toContain(\"destructiveHint: false\");\n    expect(commercialConditionsBlock).toContain(\"openWorldHint: true\");\n\n    expect(paymentRulesBlock).toContain(\"readOnlyHint: false\");\n    expect(paymentRulesBlock).toContain(\"destructiveHint: true\");\n    expect(paymentRulesBlock).toContain(\"openWorldHint: true\");\n  });\n\n  it(\"keeps both tool descriptions business-safe and action-focused\", async () => {\n    const serverSource = await readFile(new URL(\"../../index.ts\", import.meta.url), \"utf8\");\n\n    const commercialConditionsStart = serverSource.indexOf('name: \"vtex_commercial_conditions\"');\n    const paymentRulesStart = serverSource.indexOf('name: \"vtex_payment_rules\"');\n\n    expect(commercialConditionsStart).toBeGreaterThan(-1);\n    expect(paymentRulesStart).toBeGreaterThan(-1);\n\n    const commercialConditionsBlock = serverSource.slice(commercialConditionsStart, commercialConditionsStart + 900);\n    const paymentRulesBlock = serverSource.slice(paymentRulesStart, paymentRulesStart + 900);\n\n    expect(commercialConditionsBlock).toContain(\n      \"list available condition records or get a specific condition\"\n    );\n    expect(commercialConditionsBlock).toContain(\"cannot be created or modified through this API\");\n    expect(commercialConditionsBlock).toContain(\"created manually in the VTEX admin panel\");\n    expect(commercialConditionsBlock).not.toContain(\"sandbox\");\n    expect(commercialConditionsBlock).not.toContain(\"Delete operations require confirmed=true\");\n\n    expect(paymentRulesBlock).toContain(\n      \"rules that map installments, payment systems, and optional commercial-condition restrictions\"\n    );\n    expect(paymentRulesBlock).toContain(\"Delete operations require confirmed=true\");\n    expect(paymentRulesBlock).not.toContain(\"sandbox\");\n    expect(paymentRulesBlock).not.toContain(\"production writes\");\n    expect(paymentRulesBlock).not.toContain(\"legacy VTEX Payments endpoint\");\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,gBAAgB;AACzB,SAAS,UAAU,QAAQ,UAAU;AAErC,SAAS,6CAA6C,MAAM;AAC1D,KAAG,8FAA8F,YAAY;AAC3G,UAAM,kBAAkB,QAAQ,IAAI;AACpC,UAAM,oBAAoB,QAAQ,IAAI;AAEtC,YAAQ,IAAI,WAAW;AACvB,YAAQ,IAAI,+BAA+B;AAE3C,QAAI;AACF,YAAM;AAAA,QACJ,EAAE,WAAW,OAAO;AAAA,QACpB,EAAE,UAAU;AAAA,QACZ;AAAA,QACA;AAAA,MACF,IAAI,MAAM,QAAQ,IAAI;AAAA,QACpB,OAAO,gBAAgB;AAAA,QACvB,OAAO,SAAS;AAAA,QAChB,OAAO,+CAA+C;AAAA,QACtD,OAAO,uCAAuC;AAAA,MAChD,CAAC;AAED,YAAM,SAAS,IAAI,UAAU;AAAA,QAC3B,MAAM;AAAA,QACN,SAAS;AAAA,QACT,SAAS;AAAA,MACX,CAAC;AAED,aAAO;AAAA,QACL;AAAA,UACE,MAAM;AAAA,UACN,aAAa;AAAA,UACb,QAAQ,2BAA2B;AAAA,UACnC,aAAa;AAAA,YACX,cAAc;AAAA,YACd,iBAAiB;AAAA,YACjB,eAAe;AAAA,UACjB;AAAA,QACF;AAAA,QACA,OAAO,WAAW,2BAA2B,4BAA4B,MAAM;AAAA,MACjF;AAEA,aAAO;AAAA,QACL;AAAA,UACE,MAAM;AAAA,UACN,aAAa;AAAA,UACb,QAAQ,mBAAmB;AAAA,UAC3B,aAAa;AAAA,YACX,cAAc;AAAA,YACd,iBAAiB;AAAA,YACjB,eAAe;AAAA,UACjB;AAAA,QACF;AAAA,QACA,OAAO,WAAW,mBAAmB,oBAAoB,MAAM;AAAA,MACjE;AAEA,YAAM,UAAU,MAAM,OAAO,WAAW;AACxC,YAAM,SAAS,IAAI,UAAU;AAAA,QAC3B,YAAY;AAAA,UACV,OAAO;AAAA,YACL,KAAK;AAAA,YACL,WAAW;AAAA,YACX,OAAO,CAAC,OAA+B,SAAuB;AAC5D,kBAAI,iBAAiB,SAAS;AAC5B,uBAAO,QAAQ,SAAS,SAAY,QAAQ,IAAI,QAAQ,OAAO,IAAI,CAAC;AAAA,cACtE;AAEA,qBAAO,QAAQ,IAAI,QAAQ,OAAO,IAAI,CAAC;AAAA,YACzC;AAAA,UACF;AAAA,QACF;AAAA,MACF,CAAC;AAED,UAAI;AACF,cAAM,UAAU,MAAM,OAAO,cAAc,OAAO;AAClD,cAAM,QAAQ,MAAM,QAAQ,UAAU;AAEtC,eAAO,KAAK,EAAE;AAAA,UACZ,OAAO,gBAAgB;AAAA,YACrB,OAAO,iBAAiB;AAAA,cACtB,MAAM;AAAA,cACN,aAAa,OAAO,iBAAiB;AAAA,gBACnC,YAAY,OAAO,iBAAiB;AAAA,kBAClC,QAAQ,OAAO,IAAI,MAAM;AAAA,kBACzB,WAAW,OAAO,IAAI,MAAM;AAAA,gBAC9B,CAAC;AAAA,cACH,CAAC;AAAA,YACH,CAAC;AAAA,YACD,OAAO,iBAAiB;AAAA,cACtB,MAAM;AAAA,cACN,aAAa,OAAO,iBAAiB;AAAA,gBACnC,YAAY,OAAO,iBAAiB;AAAA,kBAClC,QAAQ,OAAO,IAAI,MAAM;AAAA,kBACzB,WAAW,OAAO,IAAI,MAAM;AAAA,gBAC9B,CAAC;AAAA,cACH,CAAC;AAAA,YACH,CAAC;AAAA,UACH,CAAC;AAAA,QACH;AAAA,MACF,UAAE;AACA,cAAM,OAAO,iBAAiB;AAC9B,cAAM,OAAO,MAAM;AAAA,MACrB;AAAA,IACF,UAAE;AACA,UAAI,oBAAoB,QAAW;AACjC,eAAO,QAAQ,IAAI;AAAA,MACrB,OAAO;AACL,gBAAQ,IAAI,WAAW;AAAA,MACzB;AAEA,UAAI,sBAAsB,QAAW;AACnC,eAAO,QAAQ,IAAI;AAAA,MACrB,OAAO;AACL,gBAAQ,IAAI,+BAA+B;AAAA,MAC7C;AAAA,IACF;AAAA,EACF,CAAC;AAED,KAAG,0DAA0D,YAAY;AACvE,UAAM,eAAe,MAAM,SAAS,IAAI,IAAI,kBAAkB,YAAY,GAAG,GAAG,MAAM;AACtF,UAAM,gBAAgB,MAAM,SAAS,IAAI,IAAI,iCAAiC,YAAY,GAAG,GAAG,MAAM;AAEtG,WAAO,aAAa,EAAE,UAAU,4CAA4C;AAC5E,WAAO,aAAa,EAAE,UAAU,oCAAoC;AAEpE,UAAM,4BAA4B,aAAa,QAAQ,oCAAoC;AAC3F,UAAM,oBAAoB,aAAa,QAAQ,4BAA4B;AAE3E,WAAO,2BAA2B,gDAAgD,EAAE,gBAAgB,EAAE;AACtG,WAAO,mBAAmB,wCAAwC,EAAE,gBAAgB,EAAE;AAEtF,UAAM,4BAA4B,aAAa,MAAM,2BAA2B,4BAA4B,GAAG;AAC/G,UAAM,oBAAoB,aAAa,MAAM,mBAAmB,oBAAoB,GAAG;AAEvF,WAAO,yBAAyB,EAAE,UAAU,oBAAoB;AAChE,WAAO,yBAAyB,EAAE,UAAU,wBAAwB;AACpE,WAAO,yBAAyB,EAAE,UAAU,qBAAqB;AAEjE,WAAO,iBAAiB,EAAE,UAAU,qBAAqB;AACzD,WAAO,iBAAiB,EAAE,UAAU,uBAAuB;AAC3D,WAAO,iBAAiB,EAAE,UAAU,qBAAqB;AAAA,EAC3D,CAAC;AAED,KAAG,iEAAiE,YAAY;AAC9E,UAAM,eAAe,MAAM,SAAS,IAAI,IAAI,kBAAkB,YAAY,GAAG,GAAG,MAAM;AAEtF,UAAM,4BAA4B,aAAa,QAAQ,oCAAoC;AAC3F,UAAM,oBAAoB,aAAa,QAAQ,4BAA4B;AAE3E,WAAO,yBAAyB,EAAE,gBAAgB,EAAE;AACpD,WAAO,iBAAiB,EAAE,gBAAgB,EAAE;AAE5C,UAAM,4BAA4B,aAAa,MAAM,2BAA2B,4BAA4B,GAAG;AAC/G,UAAM,oBAAoB,aAAa,MAAM,mBAAmB,oBAAoB,GAAG;AAEvF,WAAO,yBAAyB,EAAE;AAAA,MAChC;AAAA,IACF;AACA,WAAO,yBAAyB,EAAE,UAAU,gDAAgD;AAC5F,WAAO,yBAAyB,EAAE,UAAU,0CAA0C;AACtF,WAAO,yBAAyB,EAAE,IAAI,UAAU,SAAS;AACzD,WAAO,yBAAyB,EAAE,IAAI,UAAU,0CAA0C;AAE1F,WAAO,iBAAiB,EAAE;AAAA,MACxB;AAAA,IACF;AACA,WAAO,iBAAiB,EAAE,UAAU,0CAA0C;AAC9E,WAAO,iBAAiB,EAAE,IAAI,UAAU,SAAS;AACjD,WAAO,iBAAiB,EAAE,IAAI,UAAU,mBAAmB;AAC3D,WAAO,iBAAiB,EAAE,IAAI,UAAU,+BAA+B;AAAA,EACzE,CAAC;AACH,CAAC;",
+  "names": []
+}