state-trace.vercel.app

{
  "type": "object",
  "properties": {
    "field": {
      "type": "string",
      "enum": [
        "customerEmail",
        "shippingAddress",
        "shippingMethod",
        "couponCode",
        "paymentName",
        "internalNote"
      ],
      "description": "One supported checkout field to change."
    },
    "value": {
      "type": "string",
      "description": "New field value. Shipping method accepts standard, express, or pickup; coupon code may be empty."
    },
    "expectedRevision": {
      "type": "integer",
      "minimum": 1,
      "description": "Committed revision observed before staging this write."
    },
    "idempotencyKey": {
      "type": "string",
      "description": "Unique key that prevents this logical write from committing twice."
    },
    "reason": {
      "type": "string",
      "description": "Concise explanation shown in the human-visible trace."
    }
  },
  "required": [
    "field",
    "value",
    "expectedRevision",
    "idempotencyKey",
    "reason"
  ],
  "additionalProperties": false
}