@epcc-sdk/sdks-cart-checkout-order 0.3.0 → 0.4.0

package/dist/client/zod.gen.mjs

@@ -1,53 +1,102 @@
-import { z } from "zod";
+import * as z from "zod";
 const zCartContact = z.object({
-  email: z.string().email().optional()
+  email: z.email().register(z.globalRegistry, {
+    description: "The email address attached to a cart."
+  }).optional()
 });
 const zDiscountSettings = z.object({
-  custom_discounts_enabled: z.boolean().optional(),
-  use_rule_promotions: z.boolean().optional()
+  custom_discounts_enabled: z.boolean().register(z.globalRegistry, {
+    description: "This parameter enables custom discounts for a cart. When set to true and `use_rule_promotions` is not enabled, Elastic Path promotions will not be applied to the new carts. Default is set from cart discount settings for the store. See [Cart Settings](/docs/api/carts/put-v-2-settings-cart)."
+  }).optional(),
+  use_rule_promotions: z.boolean().register(z.globalRegistry, {
+    description: "When set to true, this parameter allows the cart to use rule promotions. You can enable this setting together with `custom_discounts_enabled`, for example, while transitioning between promotion systems. However, an individual cart can only contain one type of discount at a time."
+  }).optional()
 });
 const zInventorySettings = z.object({
-  defer_inventory_check: z.boolean().optional()
+  defer_inventory_check: z.boolean().register(z.globalRegistry, {
+    description: "This parameter enables deferring inventory checks on the cart. This allows items to be added to or updating in the cart without checking stock levels. Inventory checks are still performed as normal on checkout"
+  }).optional()
 });
 const zItemSettings = z.object({
-  separate_items_by_location: z.boolean().optional()
+  separate_items_by_location: z.boolean().register(z.globalRegistry, {
+    description: "When set to true, cart items with the same SKU but different locations are kept as separate line items instead of being merged. When false (default), items with the same SKU are merged and the location is updated to the most recent value."
+  }).optional()
 });
 const zCustomAttributes = z.record(
+  z.string(),
   z.object({
-    type: z.enum(["string", "integer", "boolean", "float"]),
+    type: z.enum(["string", "integer", "boolean", "float"]).register(z.globalRegistry, {
+      description: "The type of the custom attribute value."
+    }),
     value: z.union([z.string(), z.boolean(), z.number()])
   })
-);
+).register(z.globalRegistry, {
+  description: 'Specifies custom attributes for cart or order objects. Each attribute includes a top-level key, as well as corresponding type and value entries. Attribute values must correspond to the assigned types.\n\nExample:\n```\n"custom_attributes": {\n  "is_member": {\n    "type": "boolean",\n    "value": true\n  },\n  "membership_level": {\n    "type": "string",\n    "value": "premium"\n  }\n}\n```\n'
+});
 const zFormattedPriceData = z.object({
-  amount: z.number().optional(),
-  currency: z.string().optional(),
-  formatted: z.string().optional()
+  amount: z.number().register(z.globalRegistry, {
+    description: "The raw total."
+  }).optional(),
+  currency: z.string().register(z.globalRegistry, {
+    description: "The currency set for this amount."
+  }).optional(),
+  formatted: z.string().register(z.globalRegistry, {
+    description: "The formatted total based on the amount and currency."
+  }).optional()
 });
 const zCartTimestamps = z.object({
-  created_at: z.string().optional(),
-  updated_at: z.string().optional(),
-  expires_at: z.string().optional()
+  created_at: z.string().register(z.globalRegistry, {
+    description: "The date this was created."
+  }).optional(),
+  updated_at: z.string().register(z.globalRegistry, {
+    description: "The date this was last updated."
+  }).optional(),
+  expires_at: z.string().register(z.globalRegistry, {
+    description: "The date this expires."
+  }).optional()
 });
 const zRelationshipItem = z.object({
-  type: z.string(),
-  id: z.string().uuid()
+  type: z.string().register(z.globalRegistry, {
+    description: "The type of related resource."
+  }),
+  id: z.uuid().register(z.globalRegistry, {
+    description: "The ID of the related resource."
+  })
+}).register(z.globalRegistry, {
+  description: "Relationship data entry"
 });
 const zRelationshipArray = z.object({
-  data: z.array(zRelationshipItem).optional()
+  data: z.array(zRelationshipItem).register(z.globalRegistry, {
+    description: "Individual relationships"
+  }).optional()
+}).register(z.globalRegistry, {
+  description: "Array of relationships"
 });
 const zBaseCartResponse = z.object({
-  id: z.string().optional(),
-  name: z.string().optional(),
-  description: z.string().optional(),
+  id: z.string().register(z.globalRegistry, {
+    description: "The unique identifier for the cart. Use SDK or create it yourself."
+  }).optional(),
+  name: z.string().register(z.globalRegistry, {
+    description: "The name of this cart."
+  }).optional(),
+  description: z.string().register(z.globalRegistry, {
+    description: "A description of the cart."
+  }).optional(),
   contact: zCartContact.optional(),
   discount_settings: zDiscountSettings.optional(),
   inventory_settings: zInventorySettings.optional(),
   item_settings: zItemSettings.optional(),
-  payment_intent_id: z.string().optional(),
+  payment_intent_id: z.string().register(z.globalRegistry, {
+    description: "Stripe-assigned unique identifier for the linked Payment Intent"
+  }).optional(),
   custom_attributes: zCustomAttributes.optional(),
-  snapshot_date: z.string().datetime().optional(),
+  snapshot_date: z.iso.datetime().register(z.globalRegistry, {
+    description: "The snapshot date for the cart."
+  }).optional(),
   links: z.object({
-    self: z.string().optional()
+    self: z.string().register(z.globalRegistry, {
+      description: "A link to that specific resource."
+    }).optional()
   }).optional(),
   meta: z.object({
     display_price: z.object({
@@ -64,21 +113,33 @@ const zBaseCartResponse = z.object({
       z.object({
         bundle: z.array(
           z.object({
-            auto_add_free_gift: z.boolean().optional(),
-            cart_item_id: z.string().optional(),
-            quantity: z.number().int().optional(),
-            targets: z.array(z.string()).optional()
+            auto_add_free_gift: z.boolean().register(z.globalRegistry, {
+              description: "Whether to automatically add free gift"
+            }).optional(),
+            cart_item_id: z.string().register(z.globalRegistry, {
+              description: "Cart item ID for the target"
+            }).optional(),
+            quantity: z.int().register(z.globalRegistry, {
+              description: "Quantity for the promotion"
+            }).optional(),
+            targets: z.array(z.string()).register(z.globalRegistry, {
+              description: "Array of target SKUs"
+            }).optional()
           })
-        ).optional(),
+        ).register(z.globalRegistry, {
+          description: "Bundle configuration with promotion targets"
+        }).optional(),
         code: z.string().optional(),
         info: z.string().optional(),
         message: z.string().optional(),
         promotion_id: z.string().optional()
       })
-    ).optional()
+    ).register(z.globalRegistry, {
+      description: "Array of promotion suggestions"
+    }).optional()
   }).optional(),
   relationships: z.object({
-    customers: z.union([zRelationshipArray, z.record(z.unknown())]).optional(),
+    customers: z.union([zRelationshipArray, z.record(z.string(), z.unknown())]).optional(),
     items: z.union([
       zRelationshipArray,
       z.object({
@@ -90,31 +151,53 @@ const zBaseCartResponse = z.object({
         ).nullable()
       })
     ]).optional(),
-    accounts: z.union([zRelationshipArray, z.record(z.unknown())]).optional(),
+    accounts: z.union([zRelationshipArray, z.record(z.string(), z.unknown())]).optional(),
     custom_discounts: zRelationshipArray.optional(),
     promotions: zRelationshipArray.optional()
   }).optional()
 });
 const zCartResponse = zBaseCartResponse.and(
   z.object({
-    type: z.literal("cart").optional()
+    type: z.literal("cart").register(z.globalRegistry, {
+      description: "The type of object being returned."
+    }).optional()
   })
 );
 const zResponsePageLinks = z.object({
-  current: z.string().optional(),
-  first: z.string().optional(),
-  last: z.string().optional(),
-  next: z.string().optional(),
-  prev: z.string().optional()
+  current: z.string().register(z.globalRegistry, {
+    description: "Always the current page."
+  }).optional(),
+  first: z.string().register(z.globalRegistry, {
+    description: "Always the first page."
+  }).optional(),
+  last: z.string().register(z.globalRegistry, {
+    description: "If there is only one page, it is `null`."
+  }).optional(),
+  next: z.string().register(z.globalRegistry, {
+    description: "If there is only one page, it is `null`."
+  }).optional(),
+  prev: z.string().register(z.globalRegistry, {
+    description: "if the user is on the first page, it is `null`."
+  }).optional()
 });
 const zResponsePaginationPage = z.object({
-  current: z.number().int().optional(),
-  limit: z.number().int().optional(),
-  offset: z.number().int().optional(),
-  total: z.number().int().optional()
+  current: z.int().register(z.globalRegistry, {
+    description: "The current page."
+  }).optional(),
+  limit: z.int().register(z.globalRegistry, {
+    description: "The maximum number of records per page for this response. You can set this value up to 100."
+  }).optional(),
+  offset: z.int().register(z.globalRegistry, {
+    description: "The current offset by number of records, not pages. Offset is zero-based."
+  }).optional(),
+  total: z.int().register(z.globalRegistry, {
+    description: "The total page count."
+  }).optional()
 });
 const zResponsePaginationResults = z.object({
-  total: z.number().int().optional()
+  total: z.int().register(z.globalRegistry, {
+    description: "The total page count."
+  }).optional()
 });
 const zResponseMetaCarts = z.object({
   page: zResponsePaginationPage.optional(),
@@ -126,30 +209,68 @@ const zCartCollectionResponse = z.object({
   meta: zResponseMetaCarts.optional()
 });
 const zResponseErrorItem = z.object({
-  title: z.string(),
-  status: z.union([z.string(), z.number().int()]),
-  detail: z.string().optional(),
-  source: z.string().optional(),
+  title: z.string().register(z.globalRegistry, {
+    description: "A brief summary of the error."
+  }),
+  status: z.union([z.string(), z.int()]),
+  detail: z.string().register(z.globalRegistry, {
+    description: "Optional additional detail about the error."
+  }).optional(),
+  source: z.string().register(z.globalRegistry, {
+    description: "The field or location that caused the validation error. For JSON schema validation errors, this contains the JSON path to the invalid field (e.g., 'data.name', 'request', 'data.items[0].quantity')."
+  }).optional(),
   meta: z.object({
-    id: z.string().optional(),
-    ids: z.array(z.string()).optional(),
-    item_ids: z.array(z.string()).optional(),
-    shipping_group_id: z.string().optional(),
-    shipping_group_ids: z.array(z.string()).optional(),
-    cart_id: z.string().optional(),
-    code: z.string().optional(),
-    order_id: z.string().optional(),
-    sku: z.string().optional(),
-    email: z.string().email().optional(),
-    component_product_id: z.string().uuid().optional(),
-    "error-meta-key": z.string().optional(),
+    id: z.string().register(z.globalRegistry, {
+      description: "The resource id associated with the error"
+    }).optional(),
+    ids: z.array(
+      z.string().register(z.globalRegistry, {
+        description: "The resource ids associated with the error"
+      })
+    ).optional(),
+    item_ids: z.array(
+      z.string().register(z.globalRegistry, {
+        description: "The cart_item ids associated with the error"
+      })
+    ).optional(),
+    shipping_group_id: z.string().register(z.globalRegistry, {
+      description: "The shipping group id associated with the error"
+    }).optional(),
+    shipping_group_ids: z.array(
+      z.string().register(z.globalRegistry, {
+        description: "The shipping group ids associated with the error"
+      })
+    ).optional(),
+    cart_id: z.string().register(z.globalRegistry, {
+      description: "The cart id associated with the error"
+    }).optional(),
+    code: z.string().register(z.globalRegistry, {
+      description: "The code associated with the error."
+    }).optional(),
+    order_id: z.string().register(z.globalRegistry, {
+      description: "The order id associated with the error."
+    }).optional(),
+    sku: z.string().register(z.globalRegistry, {
+      description: "The SKU associated with the error."
+    }).optional(),
+    email: z.email().register(z.globalRegistry, {
+      description: "The email address associated with the error."
+    }).optional(),
+    component_product_id: z.uuid().register(z.globalRegistry, {
+      description: "The component product ID associated with the error."
+    }).optional(),
+    "error-meta-key": z.string().register(z.globalRegistry, {
+      description: "Custom error metadata key used for additional error context (e.g., in payment rejections)."
+    }).optional(),
     value: z.union([
       z.string(),
-      z.number().int(),
+      z.int(),
       z.boolean(),
-      z.record(z.unknown()),
+      z.record(z.string(), z.unknown()),
       z.array(z.unknown())
     ]).optional()
+  }).register(z.globalRegistry, {
+    description: "Additional metadata associated with the error. May include arbitrary keys."
   }).optional()
 });
 const zResponseErrorResponse = z.object({
@@ -157,109 +278,226 @@ const zResponseErrorResponse = z.object({
 });
 const zCartsRequest = z.object({
   data: z.object({
-    description: z.string().optional(),
+    description: z.string().register(z.globalRegistry, {
+      description: "The cart description."
+    }).optional(),
     discount_settings: zDiscountSettings.optional(),
     inventory_settings: zInventorySettings.optional(),
     item_settings: zItemSettings.optional(),
-    name: z.string().optional(),
+    name: z.string().register(z.globalRegistry, {
+      description: "The cart name provided by the shopper. A cart name must contain 1 to 255 characters. You cannot use whitespace characters, but special characters are permitted. For more information, see the [Safe Characters](/guides/Getting-Started/safe-characters) section."
+    }).optional(),
     contact: zCartContact.optional(),
-    snapshot_date: z.string().optional(),
+    snapshot_date: z.string().register(z.globalRegistry, {
+      description: "This optional parameter sets a reference date for the cart. If this parameter is set, it allows the cart to act as one that might occur on that specified date. For example, such future carts might acquire future-enabled discounts, allowing users to test and validate future interactions with carts. The snapshot_date must be in the format 2026-02-21T15:07:25Z. By default, this parameter is left empty."
+    }).optional(),
     custom_attributes: zCustomAttributes.optional(),
-    payment_intent_id: z.string().optional()
+    payment_intent_id: z.string().register(z.globalRegistry, {
+      description: "To remove the Stripe payment intent from a cart, pass the empty value in the `payment_intent_id` field.  You must use an empty value for this field. You cannot use this endpoint to directly update the cart to use an existing Payment Intent."
+    }).optional()
   }).optional()
 });
 const zCustomDiscountResponse = z.object({
-  type: z.literal("custom_discount").optional(),
-  id: z.string().uuid().optional(),
-  external_id: z.string().optional(),
-  discount_engine: z.string().optional(),
+  type: z.literal("custom_discount").register(z.globalRegistry, {
+    description: "Specifies the type of the resource. Always `custom_discount`."
+  }).optional(),
+  id: z.uuid().register(z.globalRegistry, {
+    description: "Specifies the UUID of the custom discount."
+  }).optional(),
+  external_id: z.string().register(z.globalRegistry, {
+    description: "Specifies an external id for the custom discount."
+  }).optional(),
+  discount_engine: z.string().register(z.globalRegistry, {
+    description: "Specifies from where the custom discount is applied.\n"
+  }).optional(),
   amount: zFormattedPriceData.optional(),
-  description: z.string().optional(),
-  discount_code: z.string().optional(),
+  description: z.string().register(z.globalRegistry, {
+    description: "Specifies a description for the custom discount."
+  }).optional(),
+  discount_code: z.string().register(z.globalRegistry, {
+    description: "Specifies the discount code used for the custom discount."
+  }).optional(),
   relationships: z.object({
     item: z.object({
       data: z.object({
-        id: z.string().uuid().optional(),
+        id: z.uuid().register(z.globalRegistry, {
+          description: "The cart item ID this discount is related to"
+        }).optional(),
         type: z.enum(["cart_item", "custom_item"]).optional()
       }).optional()
     }).optional()
+  }).register(z.globalRegistry, {
+    description: "Relationships to other resources like cart items"
   }).optional()
 });
 const zCondensedPromotionResponse = z.object({
-  type: z.literal("promotion").optional(),
-  id: z.string().uuid().readonly().optional(),
-  name: z.string().optional(),
-  description: z.string().optional(),
-  automatic: z.boolean().optional(),
-  promotion_type: z.string().optional(),
-  promotion_source: z.string().optional(),
-  start: z.string().datetime().optional(),
-  end: z.string().datetime().optional()
+  type: z.literal("promotion").register(z.globalRegistry, {
+    description: "Specifies the type of the resource. Always `promotion`."
+  }).optional(),
+  id: z.uuid().register(z.globalRegistry, {
+    description: "Specifies the UUID of the promotion."
+  }).readonly().optional(),
+  name: z.string().register(z.globalRegistry, {
+    description: "The name of the promotion."
+  }).optional(),
+  description: z.string().register(z.globalRegistry, {
+    description: "The description of the promotion."
+  }).optional(),
+  automatic: z.boolean().register(z.globalRegistry, {
+    description: "Whether the promotion is applied automatically."
+  }).optional(),
+  promotion_type: z.string().register(z.globalRegistry, {
+    description: "The type of promotion (for v1 promotions)."
+  }).optional(),
+  promotion_source: z.string().register(z.globalRegistry, {
+    description: "The source of the promotion (for rule promotions)."
+  }).optional(),
+  start: z.iso.datetime().register(z.globalRegistry, {
+    description: "The start date and time of the promotion."
+  }).optional(),
+  end: z.iso.datetime().register(z.globalRegistry, {
+    description: "The end date and time of the promotion."
+  }).optional()
 });
 const zCartEntityResponse = z.object({
   data: zCartResponse.optional(),
   included: z.object({
     custom_discounts: z.array(zCustomDiscountResponse).optional(),
     promotions: z.array(zCondensedPromotionResponse).optional()
+  }).register(z.globalRegistry, {
+    description: "Related objects that are included in the response."
   }).optional(),
   meta: z.object({
-    payment_intent: z.record(z.unknown()).optional()
+    payment_intent: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+      description: "Payment intent details with nested structure including status and other Stripe payment intent fields"
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Additional metadata for the cart response."
   }).optional(),
-  errors: z.array(zResponseErrorItem).optional()
+  errors: z.array(zResponseErrorItem).register(z.globalRegistry, {
+    description: "Array of error objects, if any errors occurred."
+  }).optional()
 });
 const zItemPriceData = z.object({
-  amount: z.number().readonly().optional(),
-  currency: z.string().readonly().optional(),
-  includes_tax: z.boolean().readonly().optional()
+  amount: z.number().register(z.globalRegistry, {
+    description: "The amount for this item as an integer."
+  }).readonly().optional(),
+  currency: z.string().register(z.globalRegistry, {
+    description: "The currency this item was added to the cart as."
+  }).readonly().optional(),
+  includes_tax: z.boolean().register(z.globalRegistry, {
+    description: "Whether or not this price is tax inclusive."
+  }).readonly().optional()
 });
 const zMoney = z.object({
-  amount: z.number().int(),
-  currency: z.string(),
-  includes_tax: z.boolean()
+  amount: z.int().register(z.globalRegistry, {
+    description: "Amount in minor currency units (e.g., cents)."
+  }),
+  currency: z.string().register(z.globalRegistry, {
+    description: 'ISO 4217 currency code (e.g., "USD").'
+  }),
+  includes_tax: z.boolean().register(z.globalRegistry, {
+    description: "Whether the amount includes tax."
+  })
 });
 const zDiscount = z.object({
   amount: zMoney,
-  code: z.string().optional(),
-  id: z.string(),
-  promotion_source: z.string().optional(),
-  is_cart_discount: z.boolean().optional(),
-  ordinal: z.number().int().optional(),
-  promotion_action_id: z.string().optional()
+  code: z.string().register(z.globalRegistry, {
+    description: "The discount code used, if applicable."
+  }).optional(),
+  id: z.string().register(z.globalRegistry, {
+    description: "Unique identifier for the discount."
+  }),
+  promotion_source: z.string().register(z.globalRegistry, {
+    description: "The source or origin of the promotion, if applicable."
+  }).optional(),
+  is_cart_discount: z.boolean().register(z.globalRegistry, {
+    description: "Indicates whether the discount applies to the entire cart."
+  }).optional(),
+  ordinal: z.int().register(z.globalRegistry, {
+    description: "Order in which the discount was applied."
+  }).optional(),
+  promotion_action_id: z.string().register(z.globalRegistry, {
+    description: "Identifies the specific action within a multi-action rule promotion that produced this discount."
+  }).optional()
 });
 const zCartItemFormattedPriceData = z.object({
   unit: zFormattedPriceData.optional(),
   value: zFormattedPriceData.optional()
 });
 const zTimestamps = z.object({
-  created_at: z.string().optional(),
-  updated_at: z.string().optional()
+  created_at: z.string().register(z.globalRegistry, {
+    description: "The date this was created."
+  }).optional(),
+  updated_at: z.string().register(z.globalRegistry, {
+    description: "The date this was last updated."
+  }).optional()
 });
 const zCartItemResponse = z.object({
-  id: z.string().uuid().readonly().optional(),
-  type: z.enum(["cart_item", "custom_item", "subscription_item", "promotion_item"]).readonly().optional(),
-  product_id: z.string().uuid().readonly().optional(),
-  promotion_id: z.string().uuid().readonly().optional(),
-  subscription_offering_id: z.string().uuid().readonly().optional(),
-  name: z.string().readonly().optional(),
-  description: z.string().readonly().optional(),
-  sku: z.string().readonly().optional(),
-  slug: z.string().readonly().optional(),
-  catalog_id: z.string().uuid().readonly().optional(),
-  catalog_source: z.string().readonly().optional(),
+  id: z.uuid().register(z.globalRegistry, {
+    description: "The unique identifier for the cart item."
+  }).readonly().optional(),
+  type: z.enum(["cart_item", "custom_item", "subscription_item", "promotion_item"]).register(z.globalRegistry, {
+    description: "The type of cart item."
+  }).readonly().optional(),
+  product_id: z.uuid().register(z.globalRegistry, {
+    description: "The unique ID of the product (for cart_item type)."
+  }).readonly().optional(),
+  promotion_id: z.uuid().register(z.globalRegistry, {
+    description: "The unique ID of the promotion (for promotion_item type)."
+  }).readonly().optional(),
+  subscription_offering_id: z.uuid().register(z.globalRegistry, {
+    description: "The unique ID of the subscription offering for subscription items."
+  }).readonly().optional(),
+  name: z.string().register(z.globalRegistry, {
+    description: "The name of this item"
+  }).readonly().optional(),
+  description: z.string().register(z.globalRegistry, {
+    description: "A description of the cart item."
+  }).readonly().optional(),
+  sku: z.string().register(z.globalRegistry, {
+    description: "The SKU of the cart item."
+  }).readonly().optional(),
+  slug: z.string().register(z.globalRegistry, {
+    description: "The slug of the cart item."
+  }).readonly().optional(),
+  catalog_id: z.uuid().register(z.globalRegistry, {
+    description: "The unique identifier of the catalog associated with the product is shown if catalog_source=pim is set."
+  }).readonly().optional(),
+  catalog_source: z.string().register(z.globalRegistry, {
+    description: "The catalog source. Always `pim` or `legacy`."
+  }).readonly().optional(),
   bundle_configuration: z.object({
-    selected_options: z.record(z.record(z.number())).optional(),
+    selected_options: z.record(z.string(), z.record(z.string(), z.number())).optional(),
     component_products: z.array(
       z.object({
-        id: z.string().optional(),
-        type: z.string().optional(),
-        attributes: z.record(z.unknown()).optional(),
-        meta: z.record(z.unknown()).optional(),
-        price: z.record(z.unknown()).optional(),
-        relationships: z.record(z.unknown()).optional()
+        id: z.string().register(z.globalRegistry, {
+          description: "Product ID"
+        }).optional(),
+        type: z.string().register(z.globalRegistry, {
+          description: "Product type"
+        }).optional(),
+        attributes: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+          description: "Product attributes as a generic object"
+        }).optional(),
+        meta: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+          description: "Product meta information as a generic object"
+        }).optional(),
+        price: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+          description: "Product price"
+        }).optional(),
+        relationships: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+          description: "Product relationships as a generic object"
+        }).optional()
       })
-    ).optional()
+    ).register(z.globalRegistry, {
+      description: "Array of component products for bundle configuration"
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Configuration for bundle products."
   }).readonly().optional(),
   components: z.record(
+    z.string(),
     z.object({
       name: z.string().optional(),
       options: z.array(
@@ -270,26 +508,54 @@ const zCartItemResponse = z.object({
         })
       ).optional()
     })
-  ).readonly().optional(),
+  ).register(z.globalRegistry, {
+    description: "Components of the cart item for bundle products."
+  }).readonly().optional(),
   image: z.object({
-    mime_type: z.string().readonly().optional(),
-    file_name: z.string().readonly().optional(),
-    href: z.string().readonly().optional()
+    mime_type: z.string().register(z.globalRegistry, {
+      description: "The MIME type for the uploaded file."
+    }).readonly().optional(),
+    file_name: z.string().register(z.globalRegistry, {
+      description: "The name of the image file that was uploaded."
+    }).readonly().optional(),
+    href: z.string().register(z.globalRegistry, {
+      description: "The link to the image."
+    }).readonly().optional()
+  }).readonly().optional(),
+  quantity: z.int().register(z.globalRegistry, {
+    description: "The quantity of the cart item."
+  }).readonly().optional(),
+  auto_add_quantity: z.int().register(z.globalRegistry, {
+    description: "The quantity automatically added (for gift items)."
+  }).readonly().optional(),
+  manage_stock: z.boolean().register(z.globalRegistry, {
+    description: "Whether or not the quantity of the item will be checked against inventory."
   }).readonly().optional(),
-  quantity: z.number().int().readonly().optional(),
-  auto_add_quantity: z.number().int().readonly().optional(),
-  manage_stock: z.boolean().readonly().optional(),
   unit_price: zItemPriceData.readonly().optional(),
   value: zItemPriceData.readonly().optional(),
-  discounts: z.array(zDiscount).readonly().optional(),
-  custom_inputs: z.record(z.unknown()).readonly().optional(),
+  discounts: z.array(zDiscount).register(z.globalRegistry, {
+    description: "Array of discounts applied to the cart item."
+  }).readonly().optional(),
+  custom_inputs: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+    description: "Custom inputs for personalized products."
+  }).readonly().optional(),
   subscription_configuration: z.object({
-    plan: z.string().optional(),
-    pricing_option: z.string().optional()
+    plan: z.string().register(z.globalRegistry, {
+      description: "The subscription plan ID."
+    }).optional(),
+    pricing_option: z.string().register(z.globalRegistry, {
+      description: "The subscription pricing option ID."
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Configuration for subscription items."
   }).readonly().optional(),
   links: z.object({
-    product: z.string().optional(),
-    subscription_offering: z.string().optional()
+    product: z.string().register(z.globalRegistry, {
+      description: "A URL related to the resource."
+    }).optional(),
+    subscription_offering: z.string().register(z.globalRegistry, {
+      description: "A URL related to the subscription offering resource."
+    }).optional()
   }).readonly().optional(),
   meta: z.object({
     display_price: z.object({
@@ -300,41 +566,82 @@ const zCartItemResponse = z.object({
       without_discount: zCartItemFormattedPriceData.optional(),
       original_price: zCartItemFormattedPriceData.optional(),
       discounts: z.record(
+        z.string(),
         z.object({
-          amount: z.number().int(),
-          currency: z.string(),
-          formatted: z.string(),
-          constituents: z.record(zFormattedPriceData).optional()
+          amount: z.int().register(z.globalRegistry, {
+            description: "The discount amount."
+          }),
+          currency: z.string().register(z.globalRegistry, {
+            description: "The currency code."
+          }),
+          formatted: z.string().register(z.globalRegistry, {
+            description: "The formatted discount amount."
+          }),
+          constituents: z.record(z.string(), zFormattedPriceData).register(z.globalRegistry, {
+            description: "The discount constituents."
+          }).optional()
         })
-      ).optional()
+      ).register(z.globalRegistry, {
+        description: "Detailed discount information."
+      }).optional()
     }).optional(),
     timestamps: zTimestamps.optional()
   }).readonly().optional(),
   relationships: z.object({
     taxes: z.object({
       data: z.array(zRelationshipItem).nullish()
+    }).register(z.globalRegistry, {
+      description: "Related tax items."
     }).optional(),
     custom_discounts: z.object({
       data: z.array(zRelationshipItem).nullish()
+    }).register(z.globalRegistry, {
+      description: "Related custom discounts."
     }).optional(),
     promotions: z.object({
       data: z.array(zRelationshipItem).nullish()
+    }).register(z.globalRegistry, {
+      description: "Related promotions."
     }).optional()
+  }).register(z.globalRegistry, {
+    description: "Relationships to other resources."
+  }).readonly().optional(),
+  shipping_group_id: z.string().register(z.globalRegistry, {
+    description: "The shipping group ID for this item."
+  }).readonly().optional(),
+  promotion_source: z.enum(["rule-promotion"]).register(z.globalRegistry, {
+    description: "The source of the promotion (for promotion items)."
+  }).readonly().optional(),
+  promotion_action_id: z.string().register(z.globalRegistry, {
+    description: "The action ID within the rule promotion that produced this promotion item."
+  }).readonly().optional(),
+  location: z.string().register(z.globalRegistry, {
+    description: "The stock location for this item."
   }).readonly().optional(),
-  shipping_group_id: z.string().readonly().optional(),
-  promotion_source: z.enum(["rule-promotion"]).readonly().optional(),
-  promotion_action_id: z.string().readonly().optional(),
-  location: z.string().readonly().optional(),
   custom_attributes: zCustomAttributes.readonly().optional()
 });
 const zTaxItemResponse = z.object({
-  type: z.literal("tax_item").optional(),
-  id: z.string().uuid().readonly().optional(),
-  jurisdiction: z.string().optional(),
-  code: z.string().optional(),
-  name: z.string().optional(),
-  rate: z.number().optional(),
-  amount: z.number().int().optional()
+  type: z.literal("tax_item").register(z.globalRegistry, {
+    description: "Specifies the type of the resource. Always `tax_item`."
+  }).optional(),
+  id: z.uuid().register(z.globalRegistry, {
+    description: "Specifies the UUID of the tax item."
+  }).readonly().optional(),
+  jurisdiction: z.string().register(z.globalRegistry, {
+    description: "The jurisdiction for the tax item."
+  }).optional(),
+  code: z.string().register(z.globalRegistry, {
+    description: "The tax code for the tax item."
+  }).optional(),
+  name: z.string().register(z.globalRegistry, {
+    description: "The name of the tax item."
+  }).optional(),
+  rate: z.number().register(z.globalRegistry, {
+    description: "The tax rate as a decimal (e.g., 0.085 for 8.5%)."
+  }).optional(),
+  amount: z.int().register(z.globalRegistry, {
+    description: "The tax amount in the smallest currency unit."
+  }).optional()
 });
 const zCartItemCollectionResponse = z.object({
   data: z.array(zCartItemResponse),
@@ -344,16 +651,22 @@ const zCartItemCollectionResponse = z.object({
       z.object({
         automatic: z.boolean().optional(),
         description: z.string().optional(),
-        end: z.string().datetime().optional(),
-        id: z.string().uuid().optional(),
+        end: z.iso.datetime().optional(),
+        id: z.uuid().optional(),
         name: z.string().optional(),
         promotion_type: z.string().optional(),
-        promotion_source: z.string().optional(),
-        start: z.string().datetime().optional(),
+        promotion_source: z.string().register(z.globalRegistry, {
+          description: "The source of the promotion"
+        }).optional(),
+        start: z.iso.datetime().optional(),
         type: z.literal("promotion").optional()
       })
     ).optional(),
-    tax_items: z.array(zTaxItemResponse).optional()
+    tax_items: z.array(zTaxItemResponse).register(z.globalRegistry, {
+      description: "Array of tax items included in the response."
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Related objects that are included in the response."
   }).optional(),
   meta: z.object({
     display_price: z.object({
@@ -372,48 +685,98 @@ const zCartItemCollectionResponse = z.object({
     messages: z.array(
       z.object({
         source: z.object({
-          type: z.string(),
-          id: z.string(),
-          code: z.string().optional()
+          type: z.string().register(z.globalRegistry, {
+            description: "The type of the source item"
+          }),
+          id: z.string().register(z.globalRegistry, {
+            description: "The unique identifier of the source item"
+          }),
+          code: z.string().register(z.globalRegistry, {
+            description: "The promotion code (present when source type is promotion)"
+          }).optional()
+        }).register(z.globalRegistry, {
+          description: "Identifies the cart item that triggered this message"
         }).optional(),
-        title: z.string(),
-        description: z.string()
+        title: z.string().register(z.globalRegistry, {
+          description: "A short descriptive title for the message"
+        }),
+        description: z.string().register(z.globalRegistry, {
+          description: "A detailed description of the message"
+        })
       })
-    ).optional(),
+    ).register(z.globalRegistry, {
+      description: "Optional array of informational messages that provide feedback about operations performed on the cart items, such as promotions added or discounts applied. This field is only present when there are relevant messages to display.\n"
+    }).optional(),
     promotion_suggestions: z.array(
       z.object({
         bundle: z.array(
           z.object({
-            auto_add_free_gift: z.boolean().optional(),
-            cart_item_id: z.string().optional(),
-            quantity: z.number().int().optional(),
-            targets: z.array(z.string()).optional()
+            auto_add_free_gift: z.boolean().register(z.globalRegistry, {
+              description: "Whether to automatically add free gift"
+            }).optional(),
+            cart_item_id: z.string().register(z.globalRegistry, {
+              description: "Cart item ID for the target"
+            }).optional(),
+            quantity: z.int().register(z.globalRegistry, {
+              description: "Quantity for the promotion"
+            }).optional(),
+            targets: z.array(z.string()).register(z.globalRegistry, {
+              description: "Array of target SKUs"
+            }).optional()
           })
-        ).optional(),
+        ).register(z.globalRegistry, {
+          description: "Bundle configuration with promotion targets"
+        }).optional(),
         code: z.string().optional(),
         info: z.string().optional(),
         message: z.string().optional(),
         promotion_id: z.string().optional(),
-        auto_add: z.boolean().optional(),
+        auto_add: z.boolean().register(z.globalRegistry, {
+          description: "Whether this promotion should be automatically added"
+        }).optional(),
         targets: z.array(
           z.object({
-            cart_item_id: z.string().optional(),
-            quantity: z.number().int().optional(),
-            skus: z.array(z.string()).optional()
+            cart_item_id: z.string().register(z.globalRegistry, {
+              description: "The cart item ID for this target"
+            }).optional(),
+            quantity: z.int().register(z.globalRegistry, {
+              description: "The quantity for this target"
+            }).optional(),
+            skus: z.array(z.string()).register(z.globalRegistry, {
+              description: "Array of SKU codes for this target"
+            }).optional()
           })
-        ).optional()
+        ).register(z.globalRegistry, {
+          description: "Array of promotion targets (alternative structure)"
+        }).optional()
       })
-    ).optional()
+    ).register(z.globalRegistry, {
+      description: "Array of promotion suggestions"
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Additional meta information about the cart items collection."
   }).optional(),
-  errors: z.array(zResponseErrorItem).optional()
+  errors: z.array(zResponseErrorItem).register(z.globalRegistry, {
+    description: "Array of error objects, if any errors occurred."
+  }).optional()
 });
 const zBulkUpdateCartsItemsCommon = z.object({
-  id: z.string().uuid().optional(),
-  quantity: z.number().int().gte(0).optional(),
-  type: z.enum(["cart_item", "custom_item"]).optional(),
-  custom_inputs: z.record(z.unknown()).optional(),
+  id: z.uuid().register(z.globalRegistry, {
+    description: "Specifies the ID of the cart item that you want to update in cart."
+  }).optional(),
+  quantity: z.int().gte(0).register(z.globalRegistry, {
+    description: "Specifies the amount of items to update in the cart."
+  }).optional(),
+  type: z.enum(["cart_item", "custom_item"]).register(z.globalRegistry, {
+    description: "The type of cart item being updated."
+  }).optional(),
+  custom_inputs: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+    description: "Specifies the custom text to be added to a product. See [custom inputs](https://elasticpath.dev/docs/pxm/products/ep-pxm-products-api/update-a-product#using-custom-inputs-attribute)."
+  }).optional(),
   custom_attributes: zCustomAttributes.optional(),
-  shipping_group_id: z.string().uuid().optional()
+  shipping_group_id: z.uuid().register(z.globalRegistry, {
+    description: "Specifies the shipping group ID for the cart item."
+  }).optional()
 });
 const zBulkUpdateCartsItemsWithQuantity = zBulkUpdateCartsItemsCommon.and(
   z.object({
@@ -434,7 +797,9 @@ const zBulkUpdateCartsItemsWithCustomInputs = zBulkUpdateCartsItemsCommon.and(
   })
 );
 const zUpdateAllOrNothingOptionsObject = z.object({
-  update_all_or_nothing: z.boolean().optional()
+  update_all_or_nothing: z.boolean().register(z.globalRegistry, {
+    description: "When set to`true`, if an error occurs for any item, no items are updated in the cart. When set to `false`, valid items are updated in the cart and the items with errors are reported in the response. Default is `true`."
+  }).optional()
 });
 const zBulkUpdateCartsItems = z.object({
   data: z.array(
@@ -447,76 +812,142 @@ const zBulkUpdateCartsItems = z.object({
   options: zUpdateAllOrNothingOptionsObject.optional()
 });
 const zBaseItemObjectData = z.object({
-  quantity: z.number(),
-  id: z.string().uuid().optional(),
-  sku: z.string().optional(),
-  name: z.string().optional(),
-  custom_inputs: z.record(z.unknown()).optional(),
+  quantity: z.number().register(z.globalRegistry, {
+    description: "The number of items to add."
+  }),
+  id: z.uuid().register(z.globalRegistry, {
+    description: "Specifies the ID of the product you want to add. (use this OR sku)"
+  }).optional(),
+  sku: z.string().register(z.globalRegistry, {
+    description: "Specifies the item SKU that you want to add. (use this OR id)"
+  }).optional(),
+  name: z.string().register(z.globalRegistry, {
+    description: "Optional name for the product item. If not provided, the product name from catalog will be used."
+  }).optional(),
+  custom_inputs: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+    description: "The custom text to be added to a product."
+  }).optional(),
   bundle_configuration: z.object({
-    selected_options: z.record(z.unknown()).optional(),
-    component_products: z.array(z.unknown()).optional()
+    selected_options: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+      description: "Specifies selected options."
+    }).optional(),
+    component_products: z.array(z.unknown()).register(z.globalRegistry, {
+      description: "Array of component products for the selected options."
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Object used to describe the bundle options selected."
+  }).optional(),
+  shipping_group_id: z.string().register(z.globalRegistry, {
+    description: "Identifier for a Shipping Group"
+  }).optional(),
+  location: z.string().register(z.globalRegistry, {
+    description: "The slug of a stock location."
   }).optional(),
-  shipping_group_id: z.string().optional(),
-  location: z.string().optional(),
   custom_attributes: zCustomAttributes.optional()
 });
 const zCartItemObjectData = z.object({
-  type: z.literal("cart_item")
+  type: z.literal("cart_item").register(z.globalRegistry, {
+    description: "The type of object being returned. Must be `cart_item` for cart items."
+  })
 }).and(zBaseItemObjectData);
 const zCartItemObjectRequest = z.object({
   data: zCartItemObjectData.optional()
 });
 const zSubscriptionItemObjectData = z.object({
-  type: z.literal("subscription_item"),
-  quantity: z.number(),
-  id: z.string().uuid(),
+  type: z.literal("subscription_item").register(z.globalRegistry, {
+    description: "The type of object being returned."
+  }),
+  quantity: z.number().register(z.globalRegistry, {
+    description: "The number of items added to the cart."
+  }),
+  id: z.uuid().register(z.globalRegistry, {
+    description: "Specifies the ID of the subscription offering you want to add to cart."
+  }),
   subscription_configuration: z.object({
-    pricing_option: z.string().uuid(),
-    plan: z.string().uuid()
+    pricing_option: z.uuid().register(z.globalRegistry, {
+      description: "The ID of the pricing option within the offering to use for the subscription."
+    }),
+    plan: z.uuid().register(z.globalRegistry, {
+      description: "The ID of the plan within the offering to use for the subscription."
+    })
+  }).register(z.globalRegistry, {
+    description: "Specifies how the subscription offering should be configured."
   })
 });
 const zSubscriptionItemObject = z.object({
   data: zSubscriptionItemObjectData.and(zCartItemResponse).optional()
 });
 const zCartMergeObject = z.object({
-  type: z.literal("cart_items"),
-  cart_id: z.string().uuid()
+  type: z.literal("cart_items").register(z.globalRegistry, {
+    description: "The type of object being returned. Must be `cart_items`."
+  }),
+  cart_id: z.uuid().register(z.globalRegistry, {
+    description: "The original cart to be merged from."
+  })
 });
 const zAddAllOrNothingOptionsObject = z.object({
-  add_all_or_nothing: z.boolean().optional()
+  add_all_or_nothing: z.boolean().register(z.globalRegistry, {
+    description: "When `true`, if an error occurs for any item, no items are added to the cart. When `false`, valid items are added to the cart and the items with errors are reported in the response. Default is `false`."
+  }).optional()
 });
 const zCartMergeObjectRequest = z.object({
   data: zCartMergeObject.optional(),
   options: zAddAllOrNothingOptionsObject.optional()
 });
 const zCustomItemObjectData = z.object({
-  type: z.literal("custom_item"),
-  quantity: z.number(),
+  type: z.literal("custom_item").register(z.globalRegistry, {
+    description: "The type of object being returned. Must be `custom_item`."
+  }),
+  quantity: z.number().register(z.globalRegistry, {
+    description: "The number of custom items to add to cart."
+  }),
   price: z.object({
-    amount: z.number(),
-    includes_tax: z.boolean().optional()
-  }),
-  description: z.string().optional(),
-  sku: z.string().optional(),
-  name: z.string(),
-  custom_inputs: z.record(z.unknown()).optional(),
-  shipping_group_id: z.string().optional(),
+    amount: z.number().register(z.globalRegistry, {
+      description: "The unit price of the custom item."
+    }),
+    includes_tax: z.boolean().register(z.globalRegistry, {
+      description: "Set to`true` if relevant taxes have been included in the price, `false` if not. Defaults to `true`."
+    }).optional()
+  }),
+  description: z.string().register(z.globalRegistry, {
+    description: "A description of the custom item."
+  }).optional(),
+  sku: z.string().register(z.globalRegistry, {
+    description: "The `SKU` code to use for the custom item. See [best practices](https://elasticpath.dev/docs/commerce-cloud/carts/cart-items/add-custom-item-to-cart#best-practices) to use the `SKU` code."
+  }).optional(),
+  name: z.string().register(z.globalRegistry, {
+    description: "The name of the custom item."
+  }),
+  custom_inputs: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+    description: "The custom text to be added to a product."
+  }).optional(),
+  shipping_group_id: z.string().register(z.globalRegistry, {
+    description: "Identifier for a created Cart Shipping Group"
+  }).optional(),
   custom_attributes: zCustomAttributes.optional()
 });
 const zCustomItemObject = z.object({
   data: zCustomItemObjectData.optional()
 });
 const zReOrderObject = z.object({
-  type: z.literal("order_items"),
-  order_id: z.string().uuid()
+  type: z.literal("order_items").register(z.globalRegistry, {
+    description: "The type of resource being returned. Use `order_items`."
+  }),
+  order_id: z.uuid().register(z.globalRegistry, {
+    description: "The unique identifier of the order."
+  })
 });
 const zReOrderObjectRequest = z.object({
   data: zReOrderObject.optional(),
   options: zAddAllOrNothingOptionsObject.optional()
 });
 const zPromotionItemObjectData = z.object({
-  type: z.literal("promotion_item"),
-  code: z.string()
+  type: z.literal("promotion_item").register(z.globalRegistry, {
+    description: "Specifies the type of resource, which is `promotion_item`."
+  }),
+  code: z.string().register(z.globalRegistry, {
+    description: "Specifies the promotion code. For more information about codes[].user[], see the [Create Promotion codes](/docs/api/promotions/create-promotion-codes) section."
+  })
 });
 const zPromotionItemObject = z.object({
   data: zPromotionItemObjectData.optional()
@@ -535,49 +966,89 @@ const zBulkAddItemsRequest = z.object({
 });
 const zUpdateCartsItems = z.object({
   data: z.object({
-    type: z.literal("cart_item").optional(),
-    id: z.string().uuid().optional(),
-    quantity: z.number().optional(),
-    custom_inputs: z.record(z.unknown()).optional(),
+    type: z.literal("cart_item").register(z.globalRegistry, {
+      description: "The type of the cart item."
+    }).optional(),
+    id: z.uuid().register(z.globalRegistry, {
+      description: "The unique identifier of the cart item."
+    }).optional(),
+    quantity: z.number().register(z.globalRegistry, {
+      description: "The amount of products to add to cart."
+    }).optional(),
+    custom_inputs: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+      description: "The custom text to be added to a product."
+    }).optional(),
     custom_attributes: zCustomAttributes.optional(),
-    shipping_group_id: z.string().uuid().optional()
+    shipping_group_id: z.uuid().register(z.globalRegistry, {
+      description: "The unique identifier of the shipping group to be added to the cart."
+    }).optional()
   }).optional()
 });
 const zCartsRelationshipsAccountsData = z.object({
   data: z.array(
     z.object({
-      id: z.string().optional(),
-      type: z.string().optional()
+      id: z.string().register(z.globalRegistry, {
+        description: "The ID of the account."
+      }).optional(),
+      type: z.string().register(z.globalRegistry, {
+        description: "The type of related object. Ensure that it is account."
+      }).optional()
     })
   ).optional()
 });
 const zCartsRelationshipsCustomersData = z.object({
   data: z.array(
     z.object({
-      id: z.string().optional(),
-      type: z.string().optional()
+      id: z.string().register(z.globalRegistry, {
+        description: "The ID of the customer."
+      }).optional(),
+      type: z.string().register(z.globalRegistry, {
+        description: "The type of related object. Ensure that it is customer."
+      }).optional()
     })
   ).optional()
 });
 const zCartsItemsTaxesCommon = z.object({
-  code: z.string().optional(),
-  jurisdiction: z.string().optional(),
-  name: z.string().optional(),
-  rate: z.number().optional(),
-  amount: z.number().optional(),
-  type: z.literal("tax_item"),
-  id: z.string().uuid().readonly().optional()
+  code: z.string().register(z.globalRegistry, {
+    description: "A unique tax code in this jurisdiction."
+  }).optional(),
+  jurisdiction: z.string().register(z.globalRegistry, {
+    description: "The relevant tax jurisdiction."
+  }).optional(),
+  name: z.string().register(z.globalRegistry, {
+    description: "The name of the tax item."
+  }).optional(),
+  rate: z.number().register(z.globalRegistry, {
+    description: "The tax rate as a decimal (12.5% -> 0.125). You must specify either `rate` or `amount`, but not both.\n"
+  }).optional(),
+  amount: z.number().register(z.globalRegistry, {
+    description: "The tax as an absolute amount in the smallest currency unit (e.g., $10 -> 1000). You must specify either `rate` or `amount`, but not both.\n"
+  }).optional(),
+  type: z.literal("tax_item").register(z.globalRegistry, {
+    description: "The type of object being returned. Use `tax_item`."
+  }),
+  id: z.uuid().register(z.globalRegistry, {
+    description: "The unique identifier for this tax item."
+  }).readonly().optional()
 });
 const zCartsItemsTaxesWithRate = zCartsItemsTaxesCommon.and(
   z.object({
-    rate: z.number(),
-    amount: z.number().optional()
+    rate: z.number().register(z.globalRegistry, {
+      description: "The tax rate as a decimal (12.5% -> 0.125). Required when using rate-based taxation.\n"
+    }),
+    amount: z.number().register(z.globalRegistry, {
+      description: "The tax as an absolute amount. Not allowed when rate is specified.\n"
+    }).optional()
   })
 );
 const zCartsItemsTaxesWithAmount = zCartsItemsTaxesCommon.and(
   z.object({
-    amount: z.number(),
-    rate: z.number().optional()
+    amount: z.number().register(z.globalRegistry, {
+      description: "The tax as an absolute amount in the smallest currency unit (e.g., $10 -> 1000). Required when using amount-based taxation.\n"
+    }),
+    rate: z.number().register(z.globalRegistry, {
+      description: "The tax rate as a decimal. Not allowed when amount is specified.\n"
+    }).optional()
   })
 );
 const zCartsItemsTaxesObject = z.union([
@@ -591,8 +1062,12 @@ const zCartItemRelationship = z.object({
   relationships: z.object({
     item: z.object({
       data: z.object({
-        type: z.string(),
-        id: z.string().uuid()
+        type: z.string().register(z.globalRegistry, {
+          description: "Specifies the type of item. For example, `custom_item` or `cart_item`."
+        }),
+        id: z.uuid().register(z.globalRegistry, {
+          description: "Specifies the unique identifier of the `cart_item` or `custom_item` in the cart."
+        })
       })
     })
   }).optional()
@@ -602,7 +1077,11 @@ const zCartsBulkTaxes = z.object({
     zCartsItemsTaxesObject.and(zCartItemRelationship).and(
       z.object({
         meta: z.object({
-          component_product_id: z.string().uuid().min(1).optional()
+          component_product_id: z.uuid().min(1).register(z.globalRegistry, {
+            description: "The product ID of the bundle component the tax item applies to."
+          }).optional()
+        }).register(z.globalRegistry, {
+          description: "Targets the tax item at a component product of the bundle the cart item holds, instead of at the cart item itself."
         }).optional()
       })
     )
@@ -619,27 +1098,47 @@ const zCartsCustomDiscountsObject = z.object({
       formatted: z.string().optional()
     })
   ]),
-  description: z.string(),
-  discount_code: z.string(),
-  discount_engine: z.string(),
-  external_id: z.string(),
-  type: z.literal("custom_discount"),
-  id: z.string().uuid().optional(),
+  description: z.string().register(z.globalRegistry, {
+    description: "Specifies a description for the custom discount."
+  }),
+  discount_code: z.string().register(z.globalRegistry, {
+    description: "Specifies the discount code used for the custom discount."
+  }),
+  discount_engine: z.string().register(z.globalRegistry, {
+    description: "Specifies from where the custom discount is applied. For example, Talon.one."
+  }),
+  external_id: z.string().register(z.globalRegistry, {
+    description: "Specifies an external id for the custom discount."
+  }),
+  type: z.literal("custom_discount").register(z.globalRegistry, {
+    description: "Specifies the type of the resource. Always `custom_discount`."
+  }),
+  id: z.uuid().register(z.globalRegistry, {
+    description: "Specifies the UUID of the custom discount."
+  }).optional(),
   relationships: z.object({
     item: z.object({
       data: z.object({
-        id: z.string().uuid().optional(),
+        id: z.uuid().register(z.globalRegistry, {
+          description: "The item ID this discount is related to"
+        }).optional(),
         type: z.enum(["cart_item", "custom_item"]).optional()
       }).optional()
     }).optional()
+  }).register(z.globalRegistry, {
+    description: "Relationships to other resources like cart items"
   }).optional()
 });
 const zCustomDiscountRelationshipsCartItemRequest = z.object({
   relationships: z.object({
     item: z.object({
       data: z.object({
-        type: z.string(),
-        id: z.string().uuid()
+        type: z.string().register(z.globalRegistry, {
+          description: "Specifies the type of item. For example, `custom_item` or `cart_item`."
+        }),
+        id: z.uuid().register(z.globalRegistry, {
+          description: "Specifies the unique identifier of the `cart_item` or `custom_item` in the cart."
+        })
       }).optional()
     }).optional()
   }).optional()
@@ -651,31 +1150,57 @@ const zCartsBulkCustomDiscounts = z.object({
 });
 const zCartsBulkCustomDiscountsResponse = z.object({
   data: zCartsCustomDiscountsObject.optional(),
-  errors: z.array(zResponseErrorItem).optional()
+  errors: z.array(zResponseErrorItem).register(z.globalRegistry, {
+    description: "Array of validation or processing errors"
+  }).optional()
 });
 const zCartsBulkCustomDiscountsCollectionResponse = z.object({
   data: z.array(zCartsCustomDiscountsObject).optional(),
-  errors: z.array(zResponseErrorItem).optional()
+  errors: z.array(zResponseErrorItem).register(z.globalRegistry, {
+    description: "Array of validation or processing errors"
+  }).optional()
 });
 const zCartsCustomDiscountsResponseObject = z.object({
   amount: z.object({
-    amount: z.number().optional(),
-    currency: z.string().optional(),
-    formatted: z.string().optional()
-  }).optional(),
-  description: z.string().optional(),
-  discount_code: z.string().optional(),
-  discount_engine: z.string().optional(),
-  external_id: z.string().optional(),
-  type: z.literal("custom_discount").optional(),
-  id: z.string().uuid().readonly().optional(),
+    amount: z.number().register(z.globalRegistry, {
+      description: "Specifies an amount to be applied for the custom discount. It must be less than zero."
+    }).optional(),
+    currency: z.string().register(z.globalRegistry, {
+      description: "The currency set for the custom discount."
+    }).optional(),
+    formatted: z.string().register(z.globalRegistry, {
+      description: "The formatted value for the custom discount."
+    }).optional()
+  }).optional(),
+  description: z.string().register(z.globalRegistry, {
+    description: "Specifies a description for the custom discount."
+  }).optional(),
+  discount_code: z.string().register(z.globalRegistry, {
+    description: "Specifies the discount code used for the custom discount."
+  }).optional(),
+  discount_engine: z.string().register(z.globalRegistry, {
+    description: "Specifies from where the custom discount is applied. For example, Talon.one."
+  }).optional(),
+  external_id: z.string().register(z.globalRegistry, {
+    description: "Specifies an external id for the custom discount."
+  }).optional(),
+  type: z.literal("custom_discount").register(z.globalRegistry, {
+    description: "Specifies the type of the resource. Always `custom_discount`."
+  }).optional(),
+  id: z.uuid().register(z.globalRegistry, {
+    description: "Specifies the UUID of the custom discount."
+  }).readonly().optional(),
   relationships: z.object({
     item: z.object({
       data: z.object({
-        id: z.string().uuid().optional(),
+        id: z.uuid().register(z.globalRegistry, {
+          description: "The item ID this discount is related to"
+        }).optional(),
         type: z.enum(["cart_item", "custom_item"]).optional()
       }).optional()
     }).optional()
+  }).register(z.globalRegistry, {
+    description: "Relationships to other resources like cart items"
   }).optional()
 });
 const zCartsCustomDiscountsEntityResponse = z.object({
@@ -685,41 +1210,73 @@ const zCartsCustomDiscountsCollectionResponse = z.object({
   data: z.array(zCartsCustomDiscountsObject).optional()
 });
 const zAddressCommon = z.object({
-  first_name: z.string(),
-  last_name: z.string(),
-  company_name: z.string().optional(),
-  line_1: z.string(),
-  line_2: z.string().optional(),
-  line_3: z.string().max(255).optional(),
-  city: z.string().optional(),
-  postcode: z.string(),
-  county: z.string().optional(),
-  country: z.string(),
-  region: z.string().optional()
+  first_name: z.string().register(z.globalRegistry, {
+    description: "First name of the recipient."
+  }),
+  last_name: z.string().register(z.globalRegistry, {
+    description: "Last name of the recipient."
+  }),
+  company_name: z.string().register(z.globalRegistry, {
+    description: "Company of the recipient."
+  }).optional(),
+  line_1: z.string().register(z.globalRegistry, {
+    description: "First line of the address."
+  }),
+  line_2: z.string().register(z.globalRegistry, {
+    description: "Second line of the address."
+  }).optional(),
+  line_3: z.string().max(255).register(z.globalRegistry, {
+    description: "Third line of the address."
+  }).optional(),
+  city: z.string().register(z.globalRegistry, {
+    description: "City of the address."
+  }).optional(),
+  postcode: z.string().register(z.globalRegistry, {
+    description: "Post code of the address."
+  }),
+  county: z.string().register(z.globalRegistry, {
+    description: "County of the address."
+  }).optional(),
+  country: z.string().register(z.globalRegistry, {
+    description: "Country of the address."
+  }),
+  region: z.string().register(z.globalRegistry, {
+    description: "State, province, or region of the address."
+  }).optional()
 });
 const zAddressWithRegion = zAddressCommon.and(
   z.object({
-    region: z.string()
+    region: z.string().register(z.globalRegistry, {
+      description: "State, province, or region of the address."
+    })
   })
 );
 const zAddressWithCounty = zAddressCommon.and(
   z.object({
-    county: z.string()
+    county: z.string().register(z.globalRegistry, {
+      description: "County of the address."
+    })
   })
 );
 const zShippingAddress = z.intersection(
   z.union([zAddressWithRegion, zAddressWithCounty]),
   z.object({
-    phone_number: z.string().optional(),
-    instructions: z.string().optional()
+    phone_number: z.string().register(z.globalRegistry, {
+      description: "Phone number of the shipping recipient."
+    }).optional(),
+    instructions: z.string().register(z.globalRegistry, {
+      description: "Delivery instructions."
+    }).optional()
   })
 );
 const zDeliveryEstimate = z.object({
-  start: z.string().datetime().optional(),
-  end: z.string().datetime().optional()
+  start: z.iso.datetime().optional(),
+  end: z.iso.datetime().optional()
 });
 const zSingleRelationship = z.object({
   data: zRelationshipItem.optional()
+}).register(z.globalRegistry, {
+  description: "Single relationship"
 });
 const zDiscounts = z.array(zDiscount);
 const zShippingPriceResponse = z.object({
@@ -730,14 +1287,26 @@ const zShippingPriceResponse = z.object({
   discount: zFormattedPriceData.optional()
 });
 const zNonNegativeFormattedPriceData = z.object({
-  amount: z.number().gte(0).optional(),
-  currency: z.string().optional(),
-  formatted: z.string().optional()
+  amount: z.number().gte(0).register(z.globalRegistry, {
+    description: "The raw total. Must be non-negative."
+  }).optional(),
+  currency: z.string().register(z.globalRegistry, {
+    description: "The currency set for this amount."
+  }).optional(),
+  formatted: z.string().register(z.globalRegistry, {
+    description: "The formatted total based on the amount and currency."
+  }).optional()
 });
 const zDiscountFormattedPriceData = z.object({
-  amount: z.number().lte(0).optional(),
-  currency: z.string().optional(),
-  formatted: z.string().optional()
+  amount: z.number().lte(0).register(z.globalRegistry, {
+    description: "The discount amount. Must be non-positive (zero or negative)."
+  }).optional(),
+  currency: z.string().register(z.globalRegistry, {
+    description: "The currency set for this amount."
+  }).optional(),
+  formatted: z.string().register(z.globalRegistry, {
+    description: "The formatted total based on the amount and currency."
+  }).optional()
 });
 const zOrderPriceWrapperMeta = z.object({
   with_tax: zNonNegativeFormattedPriceData,
@@ -750,6 +1319,8 @@ const zOrderPriceWrapperMeta = z.object({
   without_discount: zNonNegativeFormattedPriceData,
   shipping: zNonNegativeFormattedPriceData,
   shipping_discount: zDiscountFormattedPriceData
+}).register(z.globalRegistry, {
+  description: "Order pricing information."
 });
 const zShippingGroupMeta = z.object({
   shipping_display_price: zShippingPriceResponse.optional(),
@@ -763,11 +1334,13 @@ const zShippingGroupResponse = z.object({
   order_id: z.string().optional(),
   shipping_type: z.string().optional(),
   tracking_reference: z.string().optional(),
-  external_ref: z.string().max(64).optional(),
+  external_ref: z.string().max(64).register(z.globalRegistry, {
+    description: "An optional external ID reference for a shipping group. It can contain alphanumeric characters, special characters, and spaces, and is not required to be unique. The maximum allowed length is 64 characters. It can be used to include an external reference from a separate company system."
+  }).optional(),
   address: zShippingAddress.optional(),
   delivery_estimate: zDeliveryEstimate.optional(),
-  created_at: z.string().datetime().optional(),
-  updated_at: z.string().datetime().optional(),
+  created_at: z.iso.datetime().optional(),
+  updated_at: z.iso.datetime().optional(),
   relationships: z.object({
     cart: zSingleRelationship.optional(),
     order: zSingleRelationship.optional(),
@@ -788,7 +1361,9 @@ const zCreateShippingGroupRequest = z.object({
     type: z.literal("shipping_group").optional(),
     shipping_type: z.string().optional(),
     tracking_reference: z.string().optional(),
-    external_ref: z.string().max(64).optional(),
+    external_ref: z.string().max(64).register(z.globalRegistry, {
+      description: "An optional external ID reference for a shipping group. It can contain alphanumeric characters, special characters, and spaces, and is not required to be unique. The maximum allowed length is 64 characters."
+    }).optional(),
     shipping_price: zShippingPriceRequest.optional(),
     address: zShippingAddress.optional(),
     includes_tax: z.boolean().optional(),
@@ -796,36 +1371,66 @@ const zCreateShippingGroupRequest = z.object({
   }).optional()
 });
 const zOrderPriceData = z.object({
-  amount: z.number().optional(),
-  currency: z.string().optional(),
-  includes_tax: z.boolean().optional()
+  amount: z.number().register(z.globalRegistry, {
+    description: "The amount for this item."
+  }).optional(),
+  currency: z.string().register(z.globalRegistry, {
+    description: "The currency this item."
+  }).optional(),
+  includes_tax: z.boolean().register(z.globalRegistry, {
+    description: "Whether this price is tax inclusive."
+  }).optional()
 });
 const zDiscountData = z.object({
   amount: zOrderPriceData.optional(),
   code: z.string().optional(),
-  id: z.string().uuid().readonly().optional(),
-  promotion_source: z.string().optional(),
-  is_cart_discount: z.boolean().optional(),
-  ordinal: z.number().int().optional(),
-  promotion_action_id: z.string().optional()
+  id: z.uuid().readonly().optional(),
+  promotion_source: z.string().register(z.globalRegistry, {
+    description: "The source or origin of the promotion, if applicable."
+  }).optional(),
+  is_cart_discount: z.boolean().register(z.globalRegistry, {
+    description: "Indicates whether the discount applies to the entire cart."
+  }).optional(),
+  ordinal: z.int().register(z.globalRegistry, {
+    description: "Order in which the discount was applied."
+  }).optional(),
+  promotion_action_id: z.string().register(z.globalRegistry, {
+    description: "Identifies the specific action within a multi-action rule promotion that produced this discount."
+  }).optional()
 });
 const zOrderItemFormattedUnitPriceData = z.object({
   unit: zFormattedPriceData.optional(),
   value: zFormattedPriceData.optional()
 });
 const zOrderItemResponse = z.object({
-  type: z.string().optional(),
-  id: z.string().uuid().readonly().optional(),
-  quantity: z.number().optional(),
-  product_id: z.string().readonly().optional(),
-  subscription_offering_id: z.string().uuid().readonly().optional(),
-  name: z.string().optional(),
-  sku: z.string().optional(),
-  location: z.string().readonly().optional(),
+  type: z.string().register(z.globalRegistry, {
+    description: "The type represents the object being returned."
+  }).optional(),
+  id: z.uuid().register(z.globalRegistry, {
+    description: "The unique identifier for this order item."
+  }).readonly().optional(),
+  quantity: z.number().register(z.globalRegistry, {
+    description: "The quantity of this item were ordered."
+  }).optional(),
+  product_id: z.string().register(z.globalRegistry, {
+    description: "The unique identifier for this order item."
+  }).readonly().optional(),
+  subscription_offering_id: z.uuid().register(z.globalRegistry, {
+    description: "The unique identifier for the subscription offering for this order item."
+  }).readonly().optional(),
+  name: z.string().register(z.globalRegistry, {
+    description: "The name of this order item."
+  }).optional(),
+  sku: z.string().register(z.globalRegistry, {
+    description: "The SKU code for the order item."
+  }).optional(),
+  location: z.string().register(z.globalRegistry, {
+    description: "The stock location for this order item."
+  }).readonly().optional(),
   unit_price: zOrderPriceData.optional(),
   value: zOrderPriceData.optional(),
   discounts: z.array(zDiscountData).optional(),
-  links: z.record(z.unknown()).optional(),
+  links: z.record(z.string(), z.unknown()).optional(),
   meta: z.object({
     display_price: z.object({
       with_tax: zOrderItemFormattedUnitPriceData.optional(),
@@ -834,17 +1439,27 @@ const zOrderItemResponse = z.object({
       discount: zOrderItemFormattedUnitPriceData.optional(),
       without_discount: zOrderItemFormattedUnitPriceData.optional(),
       discounts: z.record(
+        z.string(),
         z.object({
           amount: z.number().optional(),
           currency: z.string().optional(),
           formatted: z.string().optional(),
           constituents: z.record(
+            z.string(),
             z.object({
-              amount: z.number().optional(),
-              currency: z.string().optional(),
-              formatted: z.string().optional()
+              amount: z.number().register(z.globalRegistry, {
+                description: "The discount amount"
+              }).optional(),
+              currency: z.string().register(z.globalRegistry, {
+                description: "The currency code"
+              }).optional(),
+              formatted: z.string().register(z.globalRegistry, {
+                description: "The formatted discount amount"
+              }).optional()
             })
-          ).optional()
+          ).register(z.globalRegistry, {
+            description: "Detailed breakdown of discount constituents by ID"
+          }).optional()
         })
       ).optional(),
       original_price: zOrderItemFormattedUnitPriceData.optional()
@@ -854,33 +1469,62 @@ const zOrderItemResponse = z.object({
   relationships: z.object({
     cart_item: z.object({
       data: z.object({
-        type: z.string().optional(),
-        id: z.string().uuid().readonly().optional()
+        type: z.string().register(z.globalRegistry, {
+          description: "The type represents the object being returned."
+        }).optional(),
+        id: z.uuid().register(z.globalRegistry, {
+          description: "The unique identifier for this item."
+        }).readonly().optional()
       }).optional()
     }).optional(),
     taxes: z.object({
       data: z.array(zRelationshipItem).nullish()
+    }).register(z.globalRegistry, {
+      description: "Related tax items."
     }).optional(),
     promotions: z.object({
       data: z.array(zRelationshipItem).nullish()
+    }).register(z.globalRegistry, {
+      description: "Related promotions."
     }).optional()
   }).optional(),
-  catalog_id: z.string().optional(),
-  catalog_source: z.string().optional(),
+  catalog_id: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the catalog associated with the product is shown if `catalog_source=pim` is set."
+  }).optional(),
+  catalog_source: z.string().register(z.globalRegistry, {
+    description: "The catalog source. Always `pim` or `legacy`."
+  }).optional(),
   bundle_configuration: z.object({
-    selected_options: z.record(z.record(z.number())).optional(),
+    selected_options: z.record(z.string(), z.record(z.string(), z.number())).optional(),
     component_products: z.array(
       z.object({
-        id: z.string().optional(),
-        type: z.string().optional(),
-        attributes: z.record(z.unknown()).optional(),
-        meta: z.record(z.unknown()).optional(),
-        price: z.record(z.unknown()).optional(),
-        relationships: z.record(z.unknown()).optional()
+        id: z.string().register(z.globalRegistry, {
+          description: "Component product ID"
+        }).optional(),
+        type: z.string().register(z.globalRegistry, {
+          description: "Component product type"
+        }).optional(),
+        attributes: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+          description: "Product attributes as a generic object"
+        }).optional(),
+        meta: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+          description: "Product metadata as a generic object"
+        }).optional(),
+        price: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+          description: "Product price information as a generic object"
+        }).optional(),
+        relationships: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+          description: "Product relationships as a generic object"
+        }).optional()
       })
-    ).optional()
+    ).register(z.globalRegistry, {
+      description: "Array of component products for bundle configuration"
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Configuration for bundle products."
   }).optional(),
   components: z.record(
+    z.string(),
     z.object({
       name: z.string().optional(),
       options: z.array(
@@ -891,30 +1535,54 @@ const zOrderItemResponse = z.object({
         })
       ).optional()
     })
-  ).optional(),
-  custom_inputs: z.record(z.unknown()).optional(),
+  ).register(z.globalRegistry, {
+    description: "Components of the bundle product."
+  }).optional(),
+  custom_inputs: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+    description: "Custom inputs for the order item as a generic object"
+  }).optional(),
   custom_attributes: zCustomAttributes.readonly().optional(),
-  shipping_group_id: z.string().optional(),
-  promotion_source: z.string().optional(),
-  promotion_action_id: z.string().readonly().optional(),
+  shipping_group_id: z.string().register(z.globalRegistry, {
+    description: "The shipping group ID for the order item"
+  }).optional(),
+  promotion_source: z.string().register(z.globalRegistry, {
+    description: "The promotion source for the order item"
+  }).optional(),
+  promotion_action_id: z.string().register(z.globalRegistry, {
+    description: "The action ID within the rule promotion that produced this promotion item."
+  }).readonly().optional(),
   subscription_configuration: z.object({
-    plan: z.string().optional(),
-    pricing_option: z.string().optional()
+    plan: z.string().register(z.globalRegistry, {
+      description: "Subscription plan details"
+    }).optional(),
+    pricing_option: z.string().register(z.globalRegistry, {
+      description: "Pricing option for the subscription"
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Subscription configuration for the order item"
   }).optional()
 });
 const zShippingGroupEntityResponse = z.object({
   data: zShippingGroupResponse.optional(),
   included: z.object({
-    items: z.array(zOrderItemResponse).optional()
+    items: z.array(zOrderItemResponse).register(z.globalRegistry, {
+      description: "Array of order items associated with this shipping group."
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Related objects that are included in the response when using the include query parameter."
   }).optional(),
-  errors: z.array(zResponseErrorItem).optional()
+  errors: z.array(zResponseErrorItem).register(z.globalRegistry, {
+    description: "Array of validation or processing errors"
+  }).optional()
 });
 const zUpdateCartShippingGroupRequest = z.object({
   data: z.object({
     type: z.literal("shipping_group").optional(),
     shipping_type: z.string().optional(),
     tracking_reference: z.string().optional(),
-    external_ref: z.string().max(64).optional(),
+    external_ref: z.string().max(64).register(z.globalRegistry, {
+      description: "An optional external ID reference for a shipping group. It can contain alphanumeric characters, special characters, and spaces, and is not required to be unique. The maximum allowed length is 64 characters."
+    }).optional(),
     shipping_price: zShippingPriceRequest.optional(),
     address: zShippingAddress.optional(),
     includes_tax: z.boolean().optional(),
@@ -934,26 +1602,37 @@ const zDataBasePayments = z.object({
     "stripe",
     "stripe_payment_intents"
   ]),
-  method: z.enum([
-    "authorize",
-    "purchase",
-    "purchase_setup",
-    "authorize_setup"
-  ]),
-  amount: z.number().optional()
+  method: z.enum(["authorize", "purchase", "purchase_setup", "authorize_setup"]).register(z.globalRegistry, {
+    description: "Specifies the transaction method, such as `purchase` or `authorize`."
+  }),
+  amount: z.number().register(z.globalRegistry, {
+    description: "The amount to be paid for the transaction."
+  }).optional()
 });
 const zElasticPathPaymentsPoweredByStripePayment = z.object({
   data: zDataBasePayments.and(
     z.object({
-      gateway: z.literal("elastic_path_payments_stripe").optional(),
+      gateway: z.literal("elastic_path_payments_stripe").register(z.globalRegistry, {
+        description: "Specifies the gateway. You must use `elastic_path_payments_stripe`."
+      }).optional(),
       options: z.object({
-        receipt_email: z.string().optional(),
+        receipt_email: z.string().register(z.globalRegistry, {
+          description: "Provides the email address to which you want to send the Stripe receipts for the transactions within the store. This feature is available only in the live mode."
+        }).optional(),
         automatic_payment_methods: z.object({
-          enabled: z.boolean().optional()
+          enabled: z.boolean().register(z.globalRegistry, {
+            description: "When set to true, it displays all enabled payment methods from the Stripe dashboard. When set to false, the Stripe default, which is card, is used."
+          }).optional()
+        }).register(z.globalRegistry, {
+          description: "Parent object determining whether to use Stripe's `automatic_payment_methods` setting."
         }).optional()
       }).optional(),
-      payment_method_types: z.array(z.string()).optional(),
-      payment: z.string().optional()
+      payment_method_types: z.array(z.string()).register(z.globalRegistry, {
+        description: "Specifies the Stripe payment method types configured for the store. See [Stripe Documentation](https://docs.stripe.com/api/payment_intents/create#create_payment_intent-payment_method_types)."
+      }).optional(),
+      payment: z.string().register(z.globalRegistry, {
+        description: "Specifies the Stripe token or source."
+      }).optional()
     })
   ).optional()
 });
@@ -962,19 +1641,29 @@ const zCartPaymentUpdate = z.object({
     gateway: z.string(),
     method: z.string(),
     payment_method_types: z.array(z.string()),
-    amount: z.number().int(),
-    options: z.record(z.unknown()).optional()
+    amount: z.int(),
+    options: z.record(z.string(), z.unknown()).optional()
   })
 });
 const zBillingAddress = z.union([zAddressWithRegion, zAddressWithCounty]);
 const zCustomerCheckout = z.object({
   data: z.object({
-    order_number: z.string().optional(),
-    external_ref: z.string().optional(),
+    order_number: z.string().register(z.globalRegistry, {
+      description: "A user-managed, optional field used as an alternative to the existing `order_id`. If provided, the order-number will be sent to Authorize.net instead of the `order_id`, and will appear as the invoice number in Authorize.net transactions."
+    }).optional(),
+    external_ref: z.string().register(z.globalRegistry, {
+      description: "An optional external ID reference for an order. It can contain alphanumeric characters, special characters, and spaces, and is not required to be unique. The maximum allowed length is 64 characters. It can be used to include an external reference from a separate company system."
+    }).optional(),
     customer: z.object({
-      id: z.string().optional(),
-      email: z.string().optional(),
-      name: z.string().optional()
+      id: z.string().register(z.globalRegistry, {
+        description: "The ID of the customer."
+      }).optional(),
+      email: z.string().register(z.globalRegistry, {
+        description: "The email of the customer."
+      }).optional(),
+      name: z.string().register(z.globalRegistry, {
+        description: "The name of the customer."
+      }).optional()
     }),
     billing_address: zBillingAddress.optional(),
     shipping_address: zShippingAddress.optional()
@@ -982,24 +1671,42 @@ const zCustomerCheckout = z.object({
 });
 const zAccountCheckout = z.object({
   data: z.object({
-    order_number: z.string().optional(),
-    external_ref: z.string().optional(),
+    order_number: z.string().register(z.globalRegistry, {
+      description: "A user-managed, optional field used as an alternative to the existing `order_id`. If provided, the order-number will be sent to Authorize.net instead of the `order_id`, and will appear as the invoice number in Authorize.net transactions."
+    }).optional(),
+    external_ref: z.string().register(z.globalRegistry, {
+      description: "An optional external ID reference for an order. It can contain alphanumeric characters, special characters, and spaces, and is not required to be unique. The maximum allowed length is 64 characters. It can be used to include an external reference from a separate company system."
+    }).optional(),
     account: z.object({
-      id: z.string().optional(),
-      member_id: z.string().optional()
+      id: z.string().register(z.globalRegistry, {
+        description: "The account ID."
+      }).optional(),
+      member_id: z.string().register(z.globalRegistry, {
+        description: "The account member ID."
+      }).optional()
     }).optional(),
     contact: z.object({
-      name: z.string().optional(),
-      email: z.string().email().optional()
+      name: z.string().register(z.globalRegistry, {
+        description: "The name of the account member."
+      }).optional(),
+      email: z.email().register(z.globalRegistry, {
+        description: "The email address of the account member."
+      }).optional()
     }),
     billing_address: zBillingAddress.optional(),
     shipping_address: zShippingAddress.optional()
   }).optional()
 });
 const zOrderTimestamps = z.object({
-  created_at: z.string().optional(),
-  updated_at: z.string().optional(),
-  fully_paid_at: z.string().optional()
+  created_at: z.string().register(z.globalRegistry, {
+    description: "The date this order was created."
+  }).optional(),
+  updated_at: z.string().register(z.globalRegistry, {
+    description: "The date this order was last updated."
+  }).optional(),
+  fully_paid_at: z.string().register(z.globalRegistry, {
+    description: "The date this order was fully paid. Only present for orders with payment status 'paid'."
+  }).optional()
 });
 const zOrderMeta = z.object({
   timestamps: zOrderTimestamps.optional(),
@@ -1014,24 +1721,48 @@ const zOrderMeta = z.object({
     without_discount: zNonNegativeFormattedPriceData.optional(),
     shipping: zNonNegativeFormattedPriceData.optional(),
     shipping_discount: zDiscountFormattedPriceData.optional()
+  }).register(z.globalRegistry, {
+    description: "Order pricing information including amounts, tax, discounts, and payment details."
   }).optional(),
-  is_manual: z.boolean().optional()
+  is_manual: z.boolean().register(z.globalRegistry, {
+    description: "Specifies if the order was created manually."
+  }).optional()
 });
 const zContact = z.object({
-  email: z.string().optional(),
-  name: z.string().optional()
+  email: z.string().register(z.globalRegistry, {
+    description: "The email address of the contact."
+  }).optional(),
+  name: z.string().register(z.globalRegistry, {
+    description: "The name of the contact."
+  }).optional()
 });
 const zCustomer = z.object({
-  name: z.string().optional(),
-  email: z.string().email().optional(),
-  id: z.string().uuid().optional()
+  name: z.string().register(z.globalRegistry, {
+    description: "The name of the customer."
+  }).optional(),
+  email: z.email().register(z.globalRegistry, {
+    description: "The email address of the customer."
+  }).optional(),
+  id: z.uuid().register(z.globalRegistry, {
+    description: "The unique identifier of the customer."
+  }).optional()
 });
 const zOrderResponse = z.object({
-  type: z.literal("order").optional(),
-  order_number: z.string().optional(),
-  external_ref: z.string().optional(),
-  id: z.string().uuid().readonly().optional(),
-  status: z.enum(["complete", "incomplete", "cancelled", "processing"]).optional(),
+  type: z.literal("order").register(z.globalRegistry, {
+    description: "Specifies the type of object being returned. You must use `order`."
+  }).optional(),
+  order_number: z.string().register(z.globalRegistry, {
+    description: "Specifies a user-managed, optional field used as an alternative to the existing `order_id`. If provided, the order-number will be sent to Authorize.net instead of the `order_id`, and will appear as the invoice number in Authorize.net transactions."
+  }).optional(),
+  external_ref: z.string().register(z.globalRegistry, {
+    description: "An optional external ID reference for an order. It can contain alphanumeric characters, special characters, and spaces, and is not required to be unique. The maximum allowed length is 64 characters. It can be used to include an external reference from a separate company system."
+  }).optional(),
+  id: z.uuid().register(z.globalRegistry, {
+    description: "Specifies the unique identifier of the order."
+  }).readonly().optional(),
+  status: z.enum(["complete", "incomplete", "cancelled", "processing"]).register(z.globalRegistry, {
+    description: "Specifies the status of the order, such as `incomplete`, `complete`, `processing`, or `cancelled`."
+  }).optional(),
   payment: z.enum([
     "authorized",
     "paid",
@@ -1039,12 +1770,20 @@ const zOrderResponse = z.object({
     "refunded",
     "partially_paid",
     "partially_authorized"
-  ]).optional(),
-  shipping: z.enum(["unfulfilled", "fulfilled"]).optional(),
-  anonymized: z.boolean().optional(),
-  payment_intent_id: z.string().optional(),
+  ]).register(z.globalRegistry, {
+    description: "Specifies the status of the payment, such as `unpaid`, `authorized`, `paid`, or `refunded`."
+  }).optional(),
+  shipping: z.enum(["unfulfilled", "fulfilled"]).register(z.globalRegistry, {
+    description: "Specifies the status of the shipment, such as `fulfilled` or `unfulfilled`."
+  }).optional(),
+  anonymized: z.boolean().register(z.globalRegistry, {
+    description: "Specifies if the order is anonymized."
+  }).optional(),
+  payment_intent_id: z.string().register(z.globalRegistry, {
+    description: "Stripe Payment Intent ID.  Please see Stripe's Payment Intent [documentation](https://docs.stripe.com/api/payment_intents) for more information on Payment Intents."
+  }).optional(),
   custom_attributes: zCustomAttributes.optional(),
-  links: z.record(z.unknown()).optional(),
+  links: z.record(z.string(), z.unknown()).optional(),
   meta: zOrderMeta.optional(),
   billing_address: zBillingAddress.optional(),
   contact: zContact.optional(),
@@ -1063,12 +1802,24 @@ const zOrderResponse = z.object({
 const zOrderEntityResponse = z.object({
   data: zOrderResponse.optional(),
   included: z.object({
-    items: z.array(zOrderItemResponse).optional(),
-    tax_items: z.array(zTaxItemResponse).optional(),
-    custom_discounts: z.array(zCustomDiscountResponse).optional(),
-    promotions: z.array(zCondensedPromotionResponse).optional()
+    items: z.array(zOrderItemResponse).register(z.globalRegistry, {
+      description: "Array of order items included in the response."
+    }).optional(),
+    tax_items: z.array(zTaxItemResponse).register(z.globalRegistry, {
+      description: "Array of tax items included in the response."
+    }).optional(),
+    custom_discounts: z.array(zCustomDiscountResponse).register(z.globalRegistry, {
+      description: "Array of custom discounts included in the response."
+    }).optional(),
+    promotions: z.array(zCondensedPromotionResponse).register(z.globalRegistry, {
+      description: "Array of promotions included in the response."
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Optional included data such as order items, tax items, custom discounts, and promotions.\n"
   }).optional(),
-  errors: z.array(zResponseErrorItem).optional()
+  errors: z.array(zResponseErrorItem).register(z.globalRegistry, {
+    description: "Array of error objects, if any errors occurred."
+  }).optional()
 });
 const zResponseMetaOrders = z.object({
   page: zResponsePaginationPage.optional(),
@@ -1080,34 +1831,78 @@ const zOrderCollectionResponse = z.object({
   meta: zResponseMetaOrders.optional()
 });
 const zOrdersAddressData = z.object({
-  type: z.string(),
-  order_number: z.string().optional(),
-  external_ref: z.string().optional(),
+  type: z.string().register(z.globalRegistry, {
+    description: 'The type of the resource. You must use "order".'
+  }),
+  order_number: z.string().register(z.globalRegistry, {
+    description: "Specifies a user-managed, optional field used as an alternative to the existing order_id. If provided, the order-number will be sent to Authorize.net instead of the order_id, and will appear as the invoice number in Authorize.net transactions."
+  }).optional(),
+  external_ref: z.string().register(z.globalRegistry, {
+    description: "Represents an optional external ID reference for an order. It can contain alphanumeric characters, special characters, and spaces, and is not required to be unique. The maximum allowed length is 64 characters. It can be used to include an external reference from a separate company system."
+  }).optional(),
   shipping_address: z.object({
-    first_name: z.string().optional(),
-    last_name: z.string().optional(),
-    phone_number: z.string().optional(),
-    company_name: z.string().optional(),
-    line_1: z.string().optional(),
-    line_2: z.string().optional(),
-    line_3: z.string().max(255).optional(),
-    city: z.string().optional(),
-    county: z.string().optional(),
-    region: z.string().optional(),
-    postcode: z.string().optional(),
-    country: z.string().optional(),
-    instructions: z.string().optional()
+    first_name: z.string().register(z.globalRegistry, {
+      description: "Specifies the first name of the address holder."
+    }).optional(),
+    last_name: z.string().register(z.globalRegistry, {
+      description: "Specifies the last name of the address holder."
+    }).optional(),
+    phone_number: z.string().register(z.globalRegistry, {
+      description: "Specifies the phone number of the address holder."
+    }).optional(),
+    company_name: z.string().register(z.globalRegistry, {
+      description: "Specifies the company name."
+    }).optional(),
+    line_1: z.string().register(z.globalRegistry, {
+      description: "Specifies the first line of the address."
+    }).optional(),
+    line_2: z.string().register(z.globalRegistry, {
+      description: "Specifies the second line of the address."
+    }).optional(),
+    line_3: z.string().max(255).register(z.globalRegistry, {
+      description: "Specifies the third line of the address."
+    }).optional(),
+    city: z.string().register(z.globalRegistry, {
+      description: "Specifies the name of the city in the shipping address."
+    }).optional(),
+    county: z.string().register(z.globalRegistry, {
+      description: "Specifies the county of the shipping address."
+    }).optional(),
+    region: z.string().register(z.globalRegistry, {
+      description: "Specifies the state, province, or region of the shipping address."
+    }).optional(),
+    postcode: z.string().register(z.globalRegistry, {
+      description: "Specifies the postcode or ZIP code of the address."
+    }).optional(),
+    country: z.string().register(z.globalRegistry, {
+      description: "Specifies the country in the shipping address."
+    }).optional(),
+    instructions: z.string().register(z.globalRegistry, {
+      description: "Specifies any instructions provided with the shipping address."
+    }).optional()
   })
 });
 const zOrdersCancelData = z.object({
-  status: z.string(),
-  type: z.string(),
-  external_ref: z.string().optional()
+  status: z.string().register(z.globalRegistry, {
+    description: "The status of the order. You can only update the status to `cancelled`."
+  }),
+  type: z.string().register(z.globalRegistry, {
+    description: "The type of the resource. You must use order."
+  }),
+  external_ref: z.string().register(z.globalRegistry, {
+    description: "Represents an optional external ID reference for an order. It can contain alphanumeric characters, special characters, and spaces, and is not required to be unique. The maximum allowed length is 64 characters. It can be used to include an external reference from a separate company system."
+  }).optional()
 });
 const zOrdersFulfilledData = z.object({
-  shipping: z.string(),
-  type: z.string(),
-  external_ref: z.string().optional()
+  shipping: z.string().register(z.globalRegistry, {
+    description: "The shipping status of the order. You can only update the shipping status to `fulfilled`."
+  }),
+  type: z.string().register(z.globalRegistry, {
+    description: "The type of the resource. You must use order."
+  }),
+  external_ref: z.string().register(z.globalRegistry, {
+    description: "Represents an optional external ID reference for an order. It can contain alphanumeric characters, special characters, and spaces, and is not required to be unique. The maximum allowed length is 64 characters. It can be used to include an external reference from a separate company system."
+  }).optional()
 });
 const zOrdersUpdateRequest = z.object({
   data: z.union([zOrdersAddressData, zOrdersCancelData, zOrdersFulfilledData]).optional()
@@ -1115,13 +1910,23 @@ const zOrdersUpdateRequest = z.object({
 const zOrderItemCollectionResponse = z.object({
   data: z.array(zOrderItemResponse).optional(),
   included: z.object({
-    tax_items: z.array(zTaxItemResponse).optional(),
-    custom_discounts: z.array(zCustomDiscountResponse).optional(),
-    promotions: z.array(zCondensedPromotionResponse).optional()
+    tax_items: z.array(zTaxItemResponse).register(z.globalRegistry, {
+      description: "Array of tax items included in the response."
+    }).optional(),
+    custom_discounts: z.array(zCustomDiscountResponse).register(z.globalRegistry, {
+      description: "Array of custom discounts included in the response."
+    }).optional(),
+    promotions: z.array(zCondensedPromotionResponse).register(z.globalRegistry, {
+      description: "Array of promotions included in the response."
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Optional included data such as tax items, custom discounts, and promotions.\n"
   }).optional()
 });
 const zOrdersAnonymizeData = z.object({
-  order_ids: z.array(z.string()).optional()
+  order_ids: z.array(z.string()).register(z.globalRegistry, {
+    description: "The unique identifiers of the orders to be anonymized. You can anonymize multiple orders at the same time."
+  }).optional()
 });
 const zOrdersAnonymizeRequest = z.object({
   data: zOrdersAnonymizeData.optional()
@@ -1130,14 +1935,28 @@ const zOrdersListResponse = z.object({
   data: z.array(zOrderResponse)
 });
 const zFailureDetails = z.object({
-  code: z.string().optional(),
-  reason: z.string().optional()
+  code: z.string().register(z.globalRegistry, {
+    description: "Machine-readable failure or error code from the payment gateway."
+  }).optional(),
+  reason: z.string().register(z.globalRegistry, {
+    description: "Human-readable failure reason or error message from the payment gateway."
+  }).optional()
+}).register(z.globalRegistry, {
+  description: "Non-PII payment failure information from the payment gateway. Only present on failed transactions where the gateway provided structured failure details."
 });
 const zTransactionResponse = z.object({
-  id: z.string().uuid().readonly().optional(),
-  reference: z.string().optional(),
-  name: z.string().optional(),
-  custom_reference: z.string().optional(),
+  id: z.uuid().register(z.globalRegistry, {
+    description: "The ID of the transaction."
+  }).readonly().optional(),
+  reference: z.string().register(z.globalRegistry, {
+    description: "The payment gateway reference."
+  }).optional(),
+  name: z.string().register(z.globalRegistry, {
+    description: "A custom name associated with the payment method."
+  }).optional(),
+  custom_reference: z.string().register(z.globalRegistry, {
+    description: "A reference associated with the payment method. This might include loyalty points or gift card identifiers. We recommend you not to include personal information in this field."
+  }).optional(),
   gateway: z.enum([
     "adyen",
     "authorize_net",
@@ -1150,31 +1969,69 @@ const zTransactionResponse = z.object({
     "stripe",
     "stripe_payment_intents",
     "stripe_platform_account"
-  ]).optional(),
-  amount: z.number().optional(),
-  refunded_amount: z.number().optional(),
-  currency: z.string().optional(),
-  transaction_type: z.enum(["purchase", "authorize", "capture", "refund"]).optional(),
-  type: z.string().optional(),
-  status: z.string().optional(),
+  ]).register(z.globalRegistry, {
+    description: "The name of the payment gateway used."
+  }).optional(),
+  amount: z.number().register(z.globalRegistry, {
+    description: "The amount for this transaction."
+  }).optional(),
+  refunded_amount: z.number().register(z.globalRegistry, {
+    description: "The refunded amount."
+  }).optional(),
+  currency: z.string().register(z.globalRegistry, {
+    description: "The transaction currency."
+  }).optional(),
+  transaction_type: z.enum(["purchase", "authorize", "capture", "refund"]).register(z.globalRegistry, {
+    description: "The type of transaction, such as `purchase`, `capture`, `authorize` or `refund`."
+  }).optional(),
+  type: z.string().register(z.globalRegistry, {
+    description: "The type of object being returned."
+  }).optional(),
+  status: z.string().register(z.globalRegistry, {
+    description: "The status provided by the gateway for this transaction, such as `complete` or `failed`."
+  }).optional(),
   payment_details: z.object({
-    detailed_status: z.string().optional()
+    detailed_status: z.string().register(z.globalRegistry, {
+      description: "Detailed status from the payment gateway."
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Payment gateway specific details."
   }).optional(),
   failure_details: zFailureDetails.optional(),
-  payment_intent: z.record(z.unknown()).optional(),
-  capture_mechanism: z.enum(["automatic", "manual"]).optional(),
-  refund_mechanism: z.enum(["automatic", "manual"]).optional(),
+  payment_intent: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+    description: "Payment intent details."
+  }).optional(),
+  capture_mechanism: z.enum(["automatic", "manual"]).register(z.globalRegistry, {
+    description: "The mechanism used for capturing the transaction."
+  }).optional(),
+  refund_mechanism: z.enum(["automatic", "manual"]).register(z.globalRegistry, {
+    description: "The mechanism used for refunding the transaction."
+  }).optional(),
   client_parameters: z.object({
-    redirect_url: z.string().optional(),
-    secret: z.string().optional(),
-    token: z.string().optional()
+    redirect_url: z.string().register(z.globalRegistry, {
+      description: "URL to redirect the client after payment."
+    }).optional(),
+    secret: z.string().register(z.globalRegistry, {
+      description: "Client secret for payment processing."
+    }).optional(),
+    token: z.string().register(z.globalRegistry, {
+      description: "Client token for payment processing."
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Client-specific parameters for payment processing."
+  }).optional(),
+  next_actions: z.array(z.string()).register(z.globalRegistry, {
+    description: "Array of next actions for the transaction."
   }).optional(),
-  next_actions: z.array(z.string()).optional(),
   relationships: z.object({
     order: z.object({
       data: z.object({
-        type: z.string().optional(),
-        id: z.string().uuid().optional()
+        type: z.string().register(z.globalRegistry, {
+          description: "Represents the type of the object being returned. It is always `order`."
+        }).optional(),
+        id: z.uuid().register(z.globalRegistry, {
+          description: "The ID of the order."
+        }).optional()
       }).optional()
     }).optional()
   }).optional(),
@@ -1191,84 +2048,148 @@ const zTransactionEntityResponse = z.object({
 });
 const zDataAdyenPayment = zDataBasePayments.and(
   z.object({
-    gateway: z.literal("adyen"),
+    gateway: z.literal("adyen").register(z.globalRegistry, {
+      description: "Specifies the gateway. You must use `adyen`."
+    }),
     options: z.object({
-      shopper_reference: z.string().optional(),
-      recurring_processing_model: z.string().optional()
+      shopper_reference: z.string().register(z.globalRegistry, {
+        description: "The shopper reference token associated with the saved payment method."
+      }).optional(),
+      recurring_processing_model: z.string().register(z.globalRegistry, {
+        description: "Enter CardOnFile for a one-time purchase."
+      }).optional()
     }).optional(),
-    payment: z.string()
+    payment: z.string().register(z.globalRegistry, {
+      description: "The Adyen recurringDetailReference payment method identifier."
+    })
   })
 );
 const zDataAuthorizeNetPayment = zDataBasePayments.and(
   z.object({
-    gateway: z.literal("authorize_net"),
+    gateway: z.literal("authorize_net").register(z.globalRegistry, {
+      description: "Specifies the gateway. You must use `authorize_net`."
+    }),
     options: z.object({
-      customer_payment_profile_id: z.string().optional()
+      customer_payment_profile_id: z.string().register(z.globalRegistry, {
+        description: "The Authorize.net customer payment profile ID."
+      }).optional()
     }).optional(),
-    payment: z.string()
+    payment: z.string().register(z.globalRegistry, {
+      description: "The Authorize.net customer profile ID."
+    })
   })
 );
 const zDataBraintreePayment = zDataBasePayments.and(
   z.object({
-    gateway: z.literal("braintree"),
-    payment: z.string()
+    gateway: z.literal("braintree").register(z.globalRegistry, {
+      description: "Specifies the gateway. You must use `braintree`."
+    }),
+    payment: z.string().register(z.globalRegistry, {
+      description: "The Braintree Customer ID that you want to bill."
+    })
   })
 );
 const zDataCardConnectPayment = zDataBasePayments.and(
   z.object({
-    gateway: z.literal("card_connect"),
-    payment: z.string()
+    gateway: z.literal("card_connect").register(z.globalRegistry, {
+      description: "Specifies the gateway. You must use `card_connect`."
+    }),
+    payment: z.string().register(z.globalRegistry, {
+      description: "Enter account_id, profile_id from CardPointe API. For example, 1|16178397535388255208."
+    })
   })
 );
 const zDataCyberSourcePayment = zDataBasePayments.and(
   z.object({
-    gateway: z.literal("cyber_source"),
-    payment: z.string()
+    gateway: z.literal("cyber_source").register(z.globalRegistry, {
+      description: "Specifies the gateway. You must use `cyber_source`."
+    }),
+    payment: z.string().register(z.globalRegistry, {
+      description: "The CyberSource token."
+    })
   })
 );
 const zDataManualPayment = zDataBasePayments.and(
   z.object({
-    gateway: z.literal("manual"),
+    gateway: z.literal("manual").register(z.globalRegistry, {
+      description: "Specifies the type of payment gateway. You must use `manual`."
+    }),
     paymentmethod_meta: z.object({
-      custom_reference: z.string().optional(),
-      name: z.string().optional()
+      custom_reference: z.string().register(z.globalRegistry, {
+        description: "A reference associated with the payment method. This might include loyalty points or gift card identifiers. We recommend not to include personal information in this field."
+      }).optional(),
+      name: z.string().register(z.globalRegistry, {
+        description: "A custom name associated with the payment method."
+      }).optional()
     }).optional()
   })
 );
 const zDataPayPalExpressCheckoutPayment = zDataBasePayments.and(
   z.object({
-    gateway: z.literal("paypal_express_checkout"),
+    gateway: z.literal("paypal_express_checkout").register(z.globalRegistry, {
+      description: "Specifies the type of payment gateway. You must use `paypal_express_checkout`."
+    }),
     options: z.object({
-      description: z.string().optional(),
-      soft_descriptor: z.string().optional(),
+      description: z.string().register(z.globalRegistry, {
+        description: "The description for the payment."
+      }).optional(),
+      soft_descriptor: z.string().register(z.globalRegistry, {
+        description: "The descriptor appended to PayPal generated descriptor that is visible on the card statement of the payer."
+      }).optional(),
       application_context: z.object({
-        brand_name: z.string().optional(),
-        locale: z.string().optional(),
-        landing_page: z.string().optional(),
-        shipping_preference: z.string().optional(),
-        user_action: z.string().optional(),
-        return_url: z.string().optional(),
-        cancel_url: z.string().optional()
+        brand_name: z.string().register(z.globalRegistry, {
+          description: "The label that overrides the business name in the PayPal account on the PayPal site."
+        }).optional(),
+        locale: z.string().register(z.globalRegistry, {
+          description: "The locale pages that appear based on language and country code. PayPal supports a five-character code. For example, ja-JP."
+        }).optional(),
+        landing_page: z.string().register(z.globalRegistry, {
+          description: "The type of landing page to show on the PayPal site for customer checkout. Use values LOGIN, BILLING, or NO_PREFERENCE."
+        }).optional(),
+        shipping_preference: z.string().register(z.globalRegistry, {
+          description: "The shipping preference. Use SET_PROVIDED_ADDRESS value. This parameter does allow the user to change their address on PayPal site."
+        }).optional(),
+        user_action: z.string().register(z.globalRegistry, {
+          description: "If you set `useraction=commit` in the query string, the flow redirects the buyer to the PayPal payment page and displays a Pay Now button. When the shopper clicks **Pay Now**, call `DoExpressCheckoutPayment` to complete the payment without additional interaction from the shopper. Choose this flow when you know the final payment amount when you initiate the checkout flow."
+        }).optional(),
+        return_url: z.string().register(z.globalRegistry, {
+          description: "The callback URL for PayPal to redirect the user in the case of approved payment."
+        }).optional(),
+        cancel_url: z.string().register(z.globalRegistry, {
+          description: "The callback URL for PayPal to redirect user in the case a cancelled payment."
+        }).optional()
       }).optional()
     }).optional()
   })
 );
 const zDataStripePayment = zDataBasePayments.and(
   z.object({
-    gateway: z.literal("stripe"),
+    gateway: z.literal("stripe").register(z.globalRegistry, {
+      description: "Specifies the type of payment gateway. You must use `stripe`."
+    }),
     options: z.object({
-      receipt_email: z.string().optional()
+      receipt_email: z.string().register(z.globalRegistry, {
+        description: "The option to provide an email for Stripe receipts. Specify live mode to access this feature."
+      }).optional()
     }).optional(),
-    payment: z.string().optional()
+    payment: z.string().register(z.globalRegistry, {
+      description: "The Stripe token or source."
+    }).optional()
   })
 );
 const zDataStripePaymentIntentsPayment = zDataBasePayments.and(
   z.object({
-    gateway: z.literal("stripe_payment_intents"),
+    gateway: z.literal("stripe_payment_intents").register(z.globalRegistry, {
+      description: "Specifies the type of payment gateway. You must use `stripe_payment_intents`."
+    }),
     options: z.object({
-      receipt_email: z.string().optional()
+      receipt_email: z.string().register(z.globalRegistry, {
+        description: "Provides the email address to which you want to send the Stripe receipts for the transactions within the store. This feature is available only in the live mode."
+      }).optional()
     }).optional(),
-    payment: z.string().optional()
+    payment: z.string().register(z.globalRegistry, {
+      description: "Specifies the Stripe token or source."
+    }).optional()
   })
 );
 const zDataPaymentObject = z.union([
@@ -1287,7 +2208,7 @@ const zPaymentsRequest = z.object({
   data: zDataPaymentObject.optional()
 });
 const zOrdersTransactionsConfirmRequest = z.object({
-  data: z.record(z.unknown()).optional()
+  data: z.record(z.string(), z.unknown()).optional()
 });
 const zOrdersTransactionsCaptureRequest = z.object({
   data: z.object({
@@ -1299,9 +2220,13 @@ const zOrdersTransactionsCaptureRequest = z.object({
 });
 const zOrdersTransactionsRefundRequest = z.object({
   data: z.object({
-    amount: z.number().optional(),
+    amount: z.number().register(z.globalRegistry, {
+      description: "The amount value to be refunded. If this field is not provided, it will be considered as manual refund (Mark as Refunded) and the refund process must be manually handled via payment provider. If the amount value is same as payment value, then it will be treated as a full refund and sent to the payment provider to process refund automatically."
+    }).optional(),
     options: z.object({
-      note: z.string().optional()
+      note: z.string().register(z.globalRegistry, {
+        description: "Provides comments about the refund. It is used by PayPal Express."
+      }).optional()
     }).optional()
   }).optional()
 });
@@ -1313,8 +2238,10 @@ const zResponseData = z.object({
 });
 const zOrdersTransactionsCancelRequest = z.object({
   data: z.object({
-    options: z.record(z.unknown()).optional(),
-    reason: z.string().optional()
+    options: z.record(z.string(), z.unknown()).optional(),
+    reason: z.string().register(z.globalRegistry, {
+      description: "Specifies the reason for canceling the transaction. The reason may include `duplicate`, `fraudulent`, `requested_by_customer`, or `abandoned`."
+    }).optional()
   }).optional()
 });
 const zUpdateOrderShippingGroupRequest = z.object({
@@ -1322,46 +2249,64 @@ const zUpdateOrderShippingGroupRequest = z.object({
     type: z.literal("shipping_group").optional(),
     shipping_type: z.string().optional(),
     tracking_reference: z.string().optional(),
-    external_ref: z.string().max(64).optional(),
+    external_ref: z.string().max(64).register(z.globalRegistry, {
+      description: "An optional external ID reference for a shipping group. It can contain alphanumeric characters, special characters, and spaces, and is not required to be unique. The maximum allowed length is 64 characters."
+    }).optional(),
     address: zShippingAddress.optional(),
     delivery_estimate: zDeliveryEstimate.optional()
   }).optional()
 });
 const zSettingsCart = z.object({
   data: z.object({
-    type: z.string(),
-    id: z.string().readonly().optional(),
-    cart_expiry_days: z.number().int().optional(),
+    type: z.string().register(z.globalRegistry, {
+      description: "Describes the type of request payload you're sending. Set this value to `settings`."
+    }),
+    id: z.string().register(z.globalRegistry, {
+      description: "The unique identifier for the cart settings."
+    }).readonly().optional(),
+    cart_expiry_days: z.int().register(z.globalRegistry, {
+      description: "Indicates the number of days before a cart expires."
+    }).optional(),
     discounts: z.object({
-      custom_discounts_enabled: z.boolean().optional(),
-      use_rule_promotions: z.boolean().optional()
+      custom_discounts_enabled: z.boolean().register(z.globalRegistry, {
+        description: "When `true`, custom discounts are enabled. Default is false. This setting only affects the new empty carts while the existing active carts will not be affected."
+      }).optional(),
+      use_rule_promotions: z.boolean().register(z.globalRegistry, {
+        description: "When set to `true`, this parameter allows the cart to use rule promotions."
+      }).optional()
     }).optional(),
     inventories: z.object({
-      defer_inventory_check: z.boolean().optional()
+      defer_inventory_check: z.boolean().register(z.globalRegistry, {
+        description: "When `true`, inventory checks are not performed when adding products to a cart but still occur on checkout as normal. Default is false. This setting only affects the new empty carts while the existing active carts will not be affected."
+      }).optional()
     }).optional(),
     items: z.object({
-      separate_items_by_location: z.boolean().optional()
+      separate_items_by_location: z.boolean().register(z.globalRegistry, {
+        description: "When `true`, cart items with the same SKU but different locations are kept as separate line items instead of being merged. When `false` (default), items with the same SKU are merged and the location is updated to the most recent value."
+      }).optional()
     }).optional(),
-    show_all_carts: z.boolean().optional()
+    show_all_carts: z.boolean().register(z.globalRegistry, {
+      description: "When `true`, admins (users with admin scope) can retrieve all carts in the store via `GET /v2/carts`, regardless of customer or account associations. When `false`, admins can only see carts that are registered (associated with customers or accounts).\n\nFor new stores, this defaults to `true`. For existing stores created before this feature was introduced, this defaults to `false` to maintain backward compatibility.\n"
+    }).optional()
   }).optional()
 });
 const zCartItemObject = zCartItemObjectData.and(zCartItemResponse);
 const zCustomItemCartObject = zCartItemResponse.and(
   z.object({
     type: z.literal("custom_item"),
-    quantity: z.number().int()
+    quantity: z.int()
   })
 );
 const zSubscriptionItemCartObject = zCartItemResponse.and(
   z.object({
     type: z.literal("subscription_item"),
-    quantity: z.number().int()
+    quantity: z.int()
   })
 );
 const zPromotionItemCartObject = zCartItemResponse.and(
   z.object({
     type: z.literal("promotion_item"),
-    quantity: z.number().int()
+    quantity: z.int()
   })
 );
 const zCartsResponse = z.object({
@@ -1383,6 +2328,7 @@ const zCartsResponse = z.object({
       shipping: zFormattedPriceData.optional(),
       shipping_discount: zFormattedPriceData.optional(),
       discounts: z.record(
+        z.string(),
         z.object({
           amount: z.number().optional(),
           currency: z.string().optional(),
@@ -1405,20 +2351,38 @@ const zCartItemsResponse = z.object({
 });
 const zDataStripeConnectPayment = zDataBasePayments.and(
   z.object({
-    gateway: z.enum(["stripe_connect"]),
+    gateway: z.enum(["stripe_connect"]).register(z.globalRegistry, {
+      description: "Specifies the type of payment gateway. You must use `stripe_connect`."
+    }),
     options: z.object({
-      receipt_email: z.string().optional()
+      receipt_email: z.string().register(z.globalRegistry, {
+        description: "Provides the email address to which you want to send the Stripe receipts for the transactions within the store. This feature is available only in the live mode."
+      }).optional()
     }).optional(),
-    payment: z.string().optional()
+    payment: z.string().register(z.globalRegistry, {
+      description: "Specifies the Stripe token or source."
+    }).optional()
   })
 );
 const zCartsCustomDiscountsUpdateObject = z.object({
-  amount: z.number().int().lt(0).optional(),
-  description: z.string().optional(),
-  discount_code: z.string().optional(),
-  discount_engine: z.string().optional(),
-  external_id: z.string().optional(),
-  type: z.literal("custom_discount")
+  amount: z.int().lt(0).register(z.globalRegistry, {
+    description: "Specifies an amount to be applied for the custom discount, in the currency's smallest unit. It must be less than zero."
+  }).optional(),
+  description: z.string().register(z.globalRegistry, {
+    description: "Specifies a description for the custom discount."
+  }).optional(),
+  discount_code: z.string().register(z.globalRegistry, {
+    description: "Specifies the discount code used for the custom discount."
+  }).optional(),
+  discount_engine: z.string().register(z.globalRegistry, {
+    description: "Specifies from where the custom discount is applied. For example, Talon.one."
+  }).optional(),
+  external_id: z.string().register(z.globalRegistry, {
+    description: "Specifies an external id for the custom discount."
+  }).optional(),
+  type: z.literal("custom_discount").register(z.globalRegistry, {
+    description: "Specifies the type of the resource. Always `custom_discount`."
+  })
 });
 const zCartsCustomDiscountsEntityRequest = z.object({
   data: zCartsCustomDiscountsUpdateObject.optional()
@@ -1427,34 +2391,70 @@ const zCartsCustomDiscountsCreateRequest = z.object({
   data: zCartsCustomDiscountsObject
 });
 const zCondensedPromotionResponseWritable = z.object({
-  type: z.literal("promotion").optional(),
-  name: z.string().optional(),
-  description: z.string().optional(),
-  automatic: z.boolean().optional(),
-  promotion_type: z.string().optional(),
-  promotion_source: z.string().optional(),
-  start: z.string().datetime().optional(),
-  end: z.string().datetime().optional()
+  type: z.literal("promotion").register(z.globalRegistry, {
+    description: "Specifies the type of the resource. Always `promotion`."
+  }).optional(),
+  name: z.string().register(z.globalRegistry, {
+    description: "The name of the promotion."
+  }).optional(),
+  description: z.string().register(z.globalRegistry, {
+    description: "The description of the promotion."
+  }).optional(),
+  automatic: z.boolean().register(z.globalRegistry, {
+    description: "Whether the promotion is applied automatically."
+  }).optional(),
+  promotion_type: z.string().register(z.globalRegistry, {
+    description: "The type of promotion (for v1 promotions)."
+  }).optional(),
+  promotion_source: z.string().register(z.globalRegistry, {
+    description: "The source of the promotion (for rule promotions)."
+  }).optional(),
+  start: z.iso.datetime().register(z.globalRegistry, {
+    description: "The start date and time of the promotion."
+  }).optional(),
+  end: z.iso.datetime().register(z.globalRegistry, {
+    description: "The end date and time of the promotion."
+  }).optional()
 });
 const zCartEntityResponseWritable = z.object({
   data: zCartResponse.optional(),
   included: z.object({
     custom_discounts: z.array(zCustomDiscountResponse).optional(),
     promotions: z.array(zCondensedPromotionResponseWritable).optional()
+  }).register(z.globalRegistry, {
+    description: "Related objects that are included in the response."
   }).optional(),
   meta: z.object({
-    payment_intent: z.record(z.unknown()).optional()
+    payment_intent: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+      description: "Payment intent details with nested structure including status and other Stripe payment intent fields"
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Additional metadata for the cart response."
   }).optional(),
-  errors: z.array(zResponseErrorItem).optional()
+  errors: z.array(zResponseErrorItem).register(z.globalRegistry, {
+    description: "Array of error objects, if any errors occurred."
+  }).optional()
 });
-const zCartItemResponseWritable = z.record(z.unknown());
+const zCartItemResponseWritable = z.record(z.string(), z.unknown());
 const zTaxItemResponseWritable = z.object({
-  type: z.literal("tax_item").optional(),
-  jurisdiction: z.string().optional(),
-  code: z.string().optional(),
-  name: z.string().optional(),
-  rate: z.number().optional(),
-  amount: z.number().int().optional()
+  type: z.literal("tax_item").register(z.globalRegistry, {
+    description: "Specifies the type of the resource. Always `tax_item`."
+  }).optional(),
+  jurisdiction: z.string().register(z.globalRegistry, {
+    description: "The jurisdiction for the tax item."
+  }).optional(),
+  code: z.string().register(z.globalRegistry, {
+    description: "The tax code for the tax item."
+  }).optional(),
+  name: z.string().register(z.globalRegistry, {
+    description: "The name of the tax item."
+  }).optional(),
+  rate: z.number().register(z.globalRegistry, {
+    description: "The tax rate as a decimal (e.g., 0.085 for 8.5%)."
+  }).optional(),
+  amount: z.int().register(z.globalRegistry, {
+    description: "The tax amount in the smallest currency unit."
+  }).optional()
 });
 const zCartItemCollectionResponseWritable = z.object({
   data: z.array(zCartItemResponseWritable),
@@ -1464,16 +2464,22 @@ const zCartItemCollectionResponseWritable = z.object({
       z.object({
         automatic: z.boolean().optional(),
         description: z.string().optional(),
-        end: z.string().datetime().optional(),
-        id: z.string().uuid().optional(),
+        end: z.iso.datetime().optional(),
+        id: z.uuid().optional(),
         name: z.string().optional(),
         promotion_type: z.string().optional(),
-        promotion_source: z.string().optional(),
-        start: z.string().datetime().optional(),
+        promotion_source: z.string().register(z.globalRegistry, {
+          description: "The source of the promotion"
+        }).optional(),
+        start: z.iso.datetime().optional(),
         type: z.literal("promotion").optional()
       })
     ).optional(),
-    tax_items: z.array(zTaxItemResponseWritable).optional()
+    tax_items: z.array(zTaxItemResponseWritable).register(z.globalRegistry, {
+      description: "Array of tax items included in the response."
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Related objects that are included in the response."
   }).optional(),
   meta: z.object({
     display_price: z.object({
@@ -1492,62 +2498,122 @@ const zCartItemCollectionResponseWritable = z.object({
     messages: z.array(
       z.object({
         source: z.object({
-          type: z.string(),
-          id: z.string(),
-          code: z.string().optional()
+          type: z.string().register(z.globalRegistry, {
+            description: "The type of the source item"
+          }),
+          id: z.string().register(z.globalRegistry, {
+            description: "The unique identifier of the source item"
+          }),
+          code: z.string().register(z.globalRegistry, {
+            description: "The promotion code (present when source type is promotion)"
+          }).optional()
+        }).register(z.globalRegistry, {
+          description: "Identifies the cart item that triggered this message"
         }).optional(),
-        title: z.string(),
-        description: z.string()
+        title: z.string().register(z.globalRegistry, {
+          description: "A short descriptive title for the message"
+        }),
+        description: z.string().register(z.globalRegistry, {
+          description: "A detailed description of the message"
+        })
       })
-    ).optional(),
+    ).register(z.globalRegistry, {
+      description: "Optional array of informational messages that provide feedback about operations performed on the cart items, such as promotions added or discounts applied. This field is only present when there are relevant messages to display.\n"
+    }).optional(),
     promotion_suggestions: z.array(
       z.object({
         bundle: z.array(
           z.object({
-            auto_add_free_gift: z.boolean().optional(),
-            cart_item_id: z.string().optional(),
-            quantity: z.number().int().optional(),
-            targets: z.array(z.string()).optional()
+            auto_add_free_gift: z.boolean().register(z.globalRegistry, {
+              description: "Whether to automatically add free gift"
+            }).optional(),
+            cart_item_id: z.string().register(z.globalRegistry, {
+              description: "Cart item ID for the target"
+            }).optional(),
+            quantity: z.int().register(z.globalRegistry, {
+              description: "Quantity for the promotion"
+            }).optional(),
+            targets: z.array(z.string()).register(z.globalRegistry, {
+              description: "Array of target SKUs"
+            }).optional()
           })
-        ).optional(),
+        ).register(z.globalRegistry, {
+          description: "Bundle configuration with promotion targets"
+        }).optional(),
         code: z.string().optional(),
         info: z.string().optional(),
         message: z.string().optional(),
         promotion_id: z.string().optional(),
-        auto_add: z.boolean().optional(),
+        auto_add: z.boolean().register(z.globalRegistry, {
+          description: "Whether this promotion should be automatically added"
+        }).optional(),
         targets: z.array(
           z.object({
-            cart_item_id: z.string().optional(),
-            quantity: z.number().int().optional(),
-            skus: z.array(z.string()).optional()
+            cart_item_id: z.string().register(z.globalRegistry, {
+              description: "The cart item ID for this target"
+            }).optional(),
+            quantity: z.int().register(z.globalRegistry, {
+              description: "The quantity for this target"
+            }).optional(),
+            skus: z.array(z.string()).register(z.globalRegistry, {
+              description: "Array of SKU codes for this target"
+            }).optional()
           })
-        ).optional()
+        ).register(z.globalRegistry, {
+          description: "Array of promotion targets (alternative structure)"
+        }).optional()
       })
-    ).optional()
+    ).register(z.globalRegistry, {
+      description: "Array of promotion suggestions"
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Additional meta information about the cart items collection."
   }).optional(),
-  errors: z.array(zResponseErrorItem).optional()
+  errors: z.array(zResponseErrorItem).register(z.globalRegistry, {
+    description: "Array of error objects, if any errors occurred."
+  }).optional()
 });
 const zSubscriptionItemObjectWritable = z.object({
   data: zSubscriptionItemObjectData.and(zCartItemResponseWritable).optional()
 });
 const zCartsItemsTaxesCommonWritable = z.object({
-  code: z.string().optional(),
-  jurisdiction: z.string().optional(),
-  name: z.string().optional(),
-  rate: z.number().optional(),
-  amount: z.number().optional(),
-  type: z.literal("tax_item")
+  code: z.string().register(z.globalRegistry, {
+    description: "A unique tax code in this jurisdiction."
+  }).optional(),
+  jurisdiction: z.string().register(z.globalRegistry, {
+    description: "The relevant tax jurisdiction."
+  }).optional(),
+  name: z.string().register(z.globalRegistry, {
+    description: "The name of the tax item."
+  }).optional(),
+  rate: z.number().register(z.globalRegistry, {
+    description: "The tax rate as a decimal (12.5% -> 0.125). You must specify either `rate` or `amount`, but not both.\n"
+  }).optional(),
+  amount: z.number().register(z.globalRegistry, {
+    description: "The tax as an absolute amount in the smallest currency unit (e.g., $10 -> 1000). You must specify either `rate` or `amount`, but not both.\n"
+  }).optional(),
+  type: z.literal("tax_item").register(z.globalRegistry, {
+    description: "The type of object being returned. Use `tax_item`."
+  })
 });
 const zCartsItemsTaxesWithRateWritable = zCartsItemsTaxesCommonWritable.and(
   z.object({
-    rate: z.number(),
-    amount: z.number().optional()
+    rate: z.number().register(z.globalRegistry, {
+      description: "The tax rate as a decimal (12.5% -> 0.125). Required when using rate-based taxation.\n"
+    }),
+    amount: z.number().register(z.globalRegistry, {
+      description: "The tax as an absolute amount. Not allowed when rate is specified.\n"
+    }).optional()
   })
 );
 const zCartsItemsTaxesWithAmountWritable = zCartsItemsTaxesCommonWritable.and(
   z.object({
-    amount: z.number(),
-    rate: z.number().optional()
+    amount: z.number().register(z.globalRegistry, {
+      description: "The tax as an absolute amount in the smallest currency unit (e.g., $10 -> 1000). Required when using amount-based taxation.\n"
+    }),
+    rate: z.number().register(z.globalRegistry, {
+      description: "The tax rate as a decimal. Not allowed when amount is specified.\n"
+    }).optional()
   })
 );
 const zCartsItemsTaxesObjectWritable = z.union([
@@ -1562,7 +2628,11 @@ const zCartsBulkTaxesWritable = z.object({
     zCartsItemsTaxesObjectWritable.and(zCartItemRelationship).and(
       z.object({
         meta: z.object({
-          component_product_id: z.string().uuid().min(1).optional()
+          component_product_id: z.uuid().min(1).register(z.globalRegistry, {
+            description: "The product ID of the bundle component the tax item applies to."
+          }).optional()
+        }).register(z.globalRegistry, {
+          description: "Targets the tax item at a component product of the bundle the cart item holds, instead of at the cart item itself."
         }).optional()
       })
     )
@@ -1572,41 +2642,77 @@ const zCartsBulkTaxesWritable = z.object({
 });
 const zCartsCustomDiscountsResponseObjectWritable = z.object({
   amount: z.object({
-    amount: z.number().optional(),
-    currency: z.string().optional(),
-    formatted: z.string().optional()
-  }).optional(),
-  description: z.string().optional(),
-  discount_code: z.string().optional(),
-  discount_engine: z.string().optional(),
-  external_id: z.string().optional(),
-  type: z.literal("custom_discount").optional(),
+    amount: z.number().register(z.globalRegistry, {
+      description: "Specifies an amount to be applied for the custom discount. It must be less than zero."
+    }).optional(),
+    currency: z.string().register(z.globalRegistry, {
+      description: "The currency set for the custom discount."
+    }).optional(),
+    formatted: z.string().register(z.globalRegistry, {
+      description: "The formatted value for the custom discount."
+    }).optional()
+  }).optional(),
+  description: z.string().register(z.globalRegistry, {
+    description: "Specifies a description for the custom discount."
+  }).optional(),
+  discount_code: z.string().register(z.globalRegistry, {
+    description: "Specifies the discount code used for the custom discount."
+  }).optional(),
+  discount_engine: z.string().register(z.globalRegistry, {
+    description: "Specifies from where the custom discount is applied. For example, Talon.one."
+  }).optional(),
+  external_id: z.string().register(z.globalRegistry, {
+    description: "Specifies an external id for the custom discount."
+  }).optional(),
+  type: z.literal("custom_discount").register(z.globalRegistry, {
+    description: "Specifies the type of the resource. Always `custom_discount`."
+  }).optional(),
   relationships: z.object({
     item: z.object({
       data: z.object({
-        id: z.string().uuid().optional(),
+        id: z.uuid().register(z.globalRegistry, {
+          description: "The item ID this discount is related to"
+        }).optional(),
         type: z.enum(["cart_item", "custom_item"]).optional()
       }).optional()
     }).optional()
+  }).register(z.globalRegistry, {
+    description: "Relationships to other resources like cart items"
   }).optional()
 });
 const zDiscountDataWritable = z.object({
   amount: zOrderPriceData.optional(),
   code: z.string().optional(),
-  promotion_source: z.string().optional(),
-  is_cart_discount: z.boolean().optional(),
-  ordinal: z.number().int().optional(),
-  promotion_action_id: z.string().optional()
+  promotion_source: z.string().register(z.globalRegistry, {
+    description: "The source or origin of the promotion, if applicable."
+  }).optional(),
+  is_cart_discount: z.boolean().register(z.globalRegistry, {
+    description: "Indicates whether the discount applies to the entire cart."
+  }).optional(),
+  ordinal: z.int().register(z.globalRegistry, {
+    description: "Order in which the discount was applied."
+  }).optional(),
+  promotion_action_id: z.string().register(z.globalRegistry, {
+    description: "Identifies the specific action within a multi-action rule promotion that produced this discount."
+  }).optional()
 });
 const zOrderItemResponseWritable = z.object({
-  type: z.string().optional(),
-  quantity: z.number().optional(),
-  name: z.string().optional(),
-  sku: z.string().optional(),
+  type: z.string().register(z.globalRegistry, {
+    description: "The type represents the object being returned."
+  }).optional(),
+  quantity: z.number().register(z.globalRegistry, {
+    description: "The quantity of this item were ordered."
+  }).optional(),
+  name: z.string().register(z.globalRegistry, {
+    description: "The name of this order item."
+  }).optional(),
+  sku: z.string().register(z.globalRegistry, {
+    description: "The SKU code for the order item."
+  }).optional(),
   unit_price: zOrderPriceData.optional(),
   value: zOrderPriceData.optional(),
   discounts: z.array(zDiscountDataWritable).optional(),
-  links: z.record(z.unknown()).optional(),
+  links: z.record(z.string(), z.unknown()).optional(),
   meta: z.object({
     display_price: z.object({
       with_tax: zOrderItemFormattedUnitPriceData.optional(),
@@ -1615,17 +2721,27 @@ const zOrderItemResponseWritable = z.object({
       discount: zOrderItemFormattedUnitPriceData.optional(),
       without_discount: zOrderItemFormattedUnitPriceData.optional(),
       discounts: z.record(
+        z.string(),
         z.object({
           amount: z.number().optional(),
           currency: z.string().optional(),
           formatted: z.string().optional(),
           constituents: z.record(
+            z.string(),
             z.object({
-              amount: z.number().optional(),
-              currency: z.string().optional(),
-              formatted: z.string().optional()
+              amount: z.number().register(z.globalRegistry, {
+                description: "The discount amount"
+              }).optional(),
+              currency: z.string().register(z.globalRegistry, {
+                description: "The currency code"
+              }).optional(),
+              formatted: z.string().register(z.globalRegistry, {
+                description: "The formatted discount amount"
+              }).optional()
             })
-          ).optional()
+          ).register(z.globalRegistry, {
+            description: "Detailed breakdown of discount constituents by ID"
+          }).optional()
         })
       ).optional(),
       original_price: zOrderItemFormattedUnitPriceData.optional()
@@ -1635,32 +2751,59 @@ const zOrderItemResponseWritable = z.object({
   relationships: z.object({
     cart_item: z.object({
       data: z.object({
-        type: z.string().optional()
+        type: z.string().register(z.globalRegistry, {
+          description: "The type represents the object being returned."
+        }).optional()
       }).optional()
     }).optional(),
     taxes: z.object({
       data: z.array(zRelationshipItem).nullish()
+    }).register(z.globalRegistry, {
+      description: "Related tax items."
     }).optional(),
     promotions: z.object({
       data: z.array(zRelationshipItem).nullish()
+    }).register(z.globalRegistry, {
+      description: "Related promotions."
     }).optional()
   }).optional(),
-  catalog_id: z.string().optional(),
-  catalog_source: z.string().optional(),
+  catalog_id: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the catalog associated with the product is shown if `catalog_source=pim` is set."
+  }).optional(),
+  catalog_source: z.string().register(z.globalRegistry, {
+    description: "The catalog source. Always `pim` or `legacy`."
+  }).optional(),
   bundle_configuration: z.object({
-    selected_options: z.record(z.record(z.number())).optional(),
+    selected_options: z.record(z.string(), z.record(z.string(), z.number())).optional(),
     component_products: z.array(
       z.object({
-        id: z.string().optional(),
-        type: z.string().optional(),
-        attributes: z.record(z.unknown()).optional(),
-        meta: z.record(z.unknown()).optional(),
-        price: z.record(z.unknown()).optional(),
-        relationships: z.record(z.unknown()).optional()
+        id: z.string().register(z.globalRegistry, {
+          description: "Component product ID"
+        }).optional(),
+        type: z.string().register(z.globalRegistry, {
+          description: "Component product type"
+        }).optional(),
+        attributes: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+          description: "Product attributes as a generic object"
+        }).optional(),
+        meta: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+          description: "Product metadata as a generic object"
+        }).optional(),
+        price: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+          description: "Product price information as a generic object"
+        }).optional(),
+        relationships: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+          description: "Product relationships as a generic object"
+        }).optional()
       })
-    ).optional()
+    ).register(z.globalRegistry, {
+      description: "Array of component products for bundle configuration"
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Configuration for bundle products."
   }).optional(),
   components: z.record(
+    z.string(),
     z.object({
       name: z.string().optional(),
       options: z.array(
@@ -1671,27 +2814,55 @@ const zOrderItemResponseWritable = z.object({
         })
       ).optional()
     })
-  ).optional(),
-  custom_inputs: z.record(z.unknown()).optional(),
-  shipping_group_id: z.string().optional(),
-  promotion_source: z.string().optional(),
+  ).register(z.globalRegistry, {
+    description: "Components of the bundle product."
+  }).optional(),
+  custom_inputs: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+    description: "Custom inputs for the order item as a generic object"
+  }).optional(),
+  shipping_group_id: z.string().register(z.globalRegistry, {
+    description: "The shipping group ID for the order item"
+  }).optional(),
+  promotion_source: z.string().register(z.globalRegistry, {
+    description: "The promotion source for the order item"
+  }).optional(),
   subscription_configuration: z.object({
-    plan: z.string().optional(),
-    pricing_option: z.string().optional()
+    plan: z.string().register(z.globalRegistry, {
+      description: "Subscription plan details"
+    }).optional(),
+    pricing_option: z.string().register(z.globalRegistry, {
+      description: "Pricing option for the subscription"
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Subscription configuration for the order item"
   }).optional()
 });
 const zShippingGroupEntityResponseWritable = z.object({
   data: zShippingGroupResponse.optional(),
   included: z.object({
-    items: z.array(zOrderItemResponseWritable).optional()
+    items: z.array(zOrderItemResponseWritable).register(z.globalRegistry, {
+      description: "Array of order items associated with this shipping group."
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Related objects that are included in the response when using the include query parameter."
   }).optional(),
-  errors: z.array(zResponseErrorItem).optional()
+  errors: z.array(zResponseErrorItem).register(z.globalRegistry, {
+    description: "Array of validation or processing errors"
+  }).optional()
 });
 const zOrderResponseWritable = z.object({
-  type: z.literal("order").optional(),
-  order_number: z.string().optional(),
-  external_ref: z.string().optional(),
-  status: z.enum(["complete", "incomplete", "cancelled", "processing"]).optional(),
+  type: z.literal("order").register(z.globalRegistry, {
+    description: "Specifies the type of object being returned. You must use `order`."
+  }).optional(),
+  order_number: z.string().register(z.globalRegistry, {
+    description: "Specifies a user-managed, optional field used as an alternative to the existing `order_id`. If provided, the order-number will be sent to Authorize.net instead of the `order_id`, and will appear as the invoice number in Authorize.net transactions."
+  }).optional(),
+  external_ref: z.string().register(z.globalRegistry, {
+    description: "An optional external ID reference for an order. It can contain alphanumeric characters, special characters, and spaces, and is not required to be unique. The maximum allowed length is 64 characters. It can be used to include an external reference from a separate company system."
+  }).optional(),
+  status: z.enum(["complete", "incomplete", "cancelled", "processing"]).register(z.globalRegistry, {
+    description: "Specifies the status of the order, such as `incomplete`, `complete`, `processing`, or `cancelled`."
+  }).optional(),
   payment: z.enum([
     "authorized",
     "paid",
@@ -1699,12 +2870,20 @@ const zOrderResponseWritable = z.object({
     "refunded",
     "partially_paid",
     "partially_authorized"
-  ]).optional(),
-  shipping: z.enum(["unfulfilled", "fulfilled"]).optional(),
-  anonymized: z.boolean().optional(),
-  payment_intent_id: z.string().optional(),
+  ]).register(z.globalRegistry, {
+    description: "Specifies the status of the payment, such as `unpaid`, `authorized`, `paid`, or `refunded`."
+  }).optional(),
+  shipping: z.enum(["unfulfilled", "fulfilled"]).register(z.globalRegistry, {
+    description: "Specifies the status of the shipment, such as `fulfilled` or `unfulfilled`."
+  }).optional(),
+  anonymized: z.boolean().register(z.globalRegistry, {
+    description: "Specifies if the order is anonymized."
+  }).optional(),
+  payment_intent_id: z.string().register(z.globalRegistry, {
+    description: "Stripe Payment Intent ID.  Please see Stripe's Payment Intent [documentation](https://docs.stripe.com/api/payment_intents) for more information on Payment Intents."
+  }).optional(),
   custom_attributes: zCustomAttributes.optional(),
-  links: z.record(z.unknown()).optional(),
+  links: z.record(z.string(), z.unknown()).optional(),
   meta: zOrderMeta.optional(),
   billing_address: zBillingAddress.optional(),
   contact: zContact.optional(),
@@ -1723,12 +2902,24 @@ const zOrderResponseWritable = z.object({
 const zOrderEntityResponseWritable = z.object({
   data: zOrderResponseWritable.optional(),
   included: z.object({
-    items: z.array(zOrderItemResponseWritable).optional(),
-    tax_items: z.array(zTaxItemResponseWritable).optional(),
-    custom_discounts: z.array(zCustomDiscountResponse).optional(),
-    promotions: z.array(zCondensedPromotionResponseWritable).optional()
+    items: z.array(zOrderItemResponseWritable).register(z.globalRegistry, {
+      description: "Array of order items included in the response."
+    }).optional(),
+    tax_items: z.array(zTaxItemResponseWritable).register(z.globalRegistry, {
+      description: "Array of tax items included in the response."
+    }).optional(),
+    custom_discounts: z.array(zCustomDiscountResponse).register(z.globalRegistry, {
+      description: "Array of custom discounts included in the response."
+    }).optional(),
+    promotions: z.array(zCondensedPromotionResponseWritable).register(z.globalRegistry, {
+      description: "Array of promotions included in the response."
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Optional included data such as order items, tax items, custom discounts, and promotions.\n"
   }).optional(),
-  errors: z.array(zResponseErrorItem).optional()
+  errors: z.array(zResponseErrorItem).register(z.globalRegistry, {
+    description: "Array of error objects, if any errors occurred."
+  }).optional()
 });
 const zOrderCollectionResponseWritable = z.object({
   data: z.array(zOrderResponseWritable).optional(),
@@ -1738,18 +2929,32 @@ const zOrderCollectionResponseWritable = z.object({
 const zOrderItemCollectionResponseWritable = z.object({
   data: z.array(zOrderItemResponseWritable).optional(),
   included: z.object({
-    tax_items: z.array(zTaxItemResponseWritable).optional(),
-    custom_discounts: z.array(zCustomDiscountResponse).optional(),
-    promotions: z.array(zCondensedPromotionResponseWritable).optional()
+    tax_items: z.array(zTaxItemResponseWritable).register(z.globalRegistry, {
+      description: "Array of tax items included in the response."
+    }).optional(),
+    custom_discounts: z.array(zCustomDiscountResponse).register(z.globalRegistry, {
+      description: "Array of custom discounts included in the response."
+    }).optional(),
+    promotions: z.array(zCondensedPromotionResponseWritable).register(z.globalRegistry, {
+      description: "Array of promotions included in the response."
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Optional included data such as tax items, custom discounts, and promotions.\n"
   }).optional()
 });
 const zOrdersListResponseWritable = z.object({
   data: z.array(zOrderResponseWritable)
 });
 const zTransactionResponseWritable = z.object({
-  reference: z.string().optional(),
-  name: z.string().optional(),
-  custom_reference: z.string().optional(),
+  reference: z.string().register(z.globalRegistry, {
+    description: "The payment gateway reference."
+  }).optional(),
+  name: z.string().register(z.globalRegistry, {
+    description: "A custom name associated with the payment method."
+  }).optional(),
+  custom_reference: z.string().register(z.globalRegistry, {
+    description: "A reference associated with the payment method. This might include loyalty points or gift card identifiers. We recommend you not to include personal information in this field."
+  }).optional(),
   gateway: z.enum([
     "adyen",
     "authorize_net",
@@ -1762,31 +2967,69 @@ const zTransactionResponseWritable = z.object({
     "stripe",
     "stripe_payment_intents",
     "stripe_platform_account"
-  ]).optional(),
-  amount: z.number().optional(),
-  refunded_amount: z.number().optional(),
-  currency: z.string().optional(),
-  transaction_type: z.enum(["purchase", "authorize", "capture", "refund"]).optional(),
-  type: z.string().optional(),
-  status: z.string().optional(),
+  ]).register(z.globalRegistry, {
+    description: "The name of the payment gateway used."
+  }).optional(),
+  amount: z.number().register(z.globalRegistry, {
+    description: "The amount for this transaction."
+  }).optional(),
+  refunded_amount: z.number().register(z.globalRegistry, {
+    description: "The refunded amount."
+  }).optional(),
+  currency: z.string().register(z.globalRegistry, {
+    description: "The transaction currency."
+  }).optional(),
+  transaction_type: z.enum(["purchase", "authorize", "capture", "refund"]).register(z.globalRegistry, {
+    description: "The type of transaction, such as `purchase`, `capture`, `authorize` or `refund`."
+  }).optional(),
+  type: z.string().register(z.globalRegistry, {
+    description: "The type of object being returned."
+  }).optional(),
+  status: z.string().register(z.globalRegistry, {
+    description: "The status provided by the gateway for this transaction, such as `complete` or `failed`."
+  }).optional(),
   payment_details: z.object({
-    detailed_status: z.string().optional()
+    detailed_status: z.string().register(z.globalRegistry, {
+      description: "Detailed status from the payment gateway."
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Payment gateway specific details."
   }).optional(),
   failure_details: zFailureDetails.optional(),
-  payment_intent: z.record(z.unknown()).optional(),
-  capture_mechanism: z.enum(["automatic", "manual"]).optional(),
-  refund_mechanism: z.enum(["automatic", "manual"]).optional(),
+  payment_intent: z.record(z.string(), z.unknown()).register(z.globalRegistry, {
+    description: "Payment intent details."
+  }).optional(),
+  capture_mechanism: z.enum(["automatic", "manual"]).register(z.globalRegistry, {
+    description: "The mechanism used for capturing the transaction."
+  }).optional(),
+  refund_mechanism: z.enum(["automatic", "manual"]).register(z.globalRegistry, {
+    description: "The mechanism used for refunding the transaction."
+  }).optional(),
   client_parameters: z.object({
-    redirect_url: z.string().optional(),
-    secret: z.string().optional(),
-    token: z.string().optional()
+    redirect_url: z.string().register(z.globalRegistry, {
+      description: "URL to redirect the client after payment."
+    }).optional(),
+    secret: z.string().register(z.globalRegistry, {
+      description: "Client secret for payment processing."
+    }).optional(),
+    token: z.string().register(z.globalRegistry, {
+      description: "Client token for payment processing."
+    }).optional()
+  }).register(z.globalRegistry, {
+    description: "Client-specific parameters for payment processing."
+  }).optional(),
+  next_actions: z.array(z.string()).register(z.globalRegistry, {
+    description: "Array of next actions for the transaction."
   }).optional(),
-  next_actions: z.array(z.string()).optional(),
   relationships: z.object({
     order: z.object({
       data: z.object({
-        type: z.string().optional(),
-        id: z.string().uuid().optional()
+        type: z.string().register(z.globalRegistry, {
+          description: "Represents the type of the object being returned. It is always `order`."
+        }).optional(),
+        id: z.uuid().register(z.globalRegistry, {
+          description: "The ID of the order."
+        }).optional()
       }).optional()
     }).optional()
   }).optional(),
@@ -1806,19 +3049,33 @@ const zTransactionListResponseWritable = z.object({
 });
 const zSettingsCartWritable = z.object({
   data: z.object({
-    type: z.string(),
-    cart_expiry_days: z.number().int().optional(),
+    type: z.string().register(z.globalRegistry, {
+      description: "Describes the type of request payload you're sending. Set this value to `settings`."
+    }),
+    cart_expiry_days: z.int().register(z.globalRegistry, {
+      description: "Indicates the number of days before a cart expires."
+    }).optional(),
     discounts: z.object({
-      custom_discounts_enabled: z.boolean().optional(),
-      use_rule_promotions: z.boolean().optional()
+      custom_discounts_enabled: z.boolean().register(z.globalRegistry, {
+        description: "When `true`, custom discounts are enabled. Default is false. This setting only affects the new empty carts while the existing active carts will not be affected."
+      }).optional(),
+      use_rule_promotions: z.boolean().register(z.globalRegistry, {
+        description: "When set to `true`, this parameter allows the cart to use rule promotions."
+      }).optional()
     }).optional(),
     inventories: z.object({
-      defer_inventory_check: z.boolean().optional()
+      defer_inventory_check: z.boolean().register(z.globalRegistry, {
+        description: "When `true`, inventory checks are not performed when adding products to a cart but still occur on checkout as normal. Default is false. This setting only affects the new empty carts while the existing active carts will not be affected."
+      }).optional()
     }).optional(),
     items: z.object({
-      separate_items_by_location: z.boolean().optional()
+      separate_items_by_location: z.boolean().register(z.globalRegistry, {
+        description: "When `true`, cart items with the same SKU but different locations are kept as separate line items instead of being merged. When `false` (default), items with the same SKU are merged and the location is updated to the most recent value."
+      }).optional()
     }).optional(),
-    show_all_carts: z.boolean().optional()
+    show_all_carts: z.boolean().register(z.globalRegistry, {
+      description: "When `true`, admins (users with admin scope) can retrieve all carts in the store via `GET /v2/carts`, regardless of customer or account associations. When `false`, admins can only see carts that are registered (associated with customers or accounts).\n\nFor new stores, this defaults to `true`. For existing stores created before this feature was introduced, this defaults to `false` to maintain backward compatibility.\n"
+    }).optional()
   }).optional()
 });
 const zCartItemObjectWritable = zCartItemObjectData.and(
@@ -1827,19 +3084,19 @@ const zCartItemObjectWritable = zCartItemObjectData.and(
 const zCustomItemCartObjectWritable = zCartItemResponseWritable.and(
   z.object({
     type: z.literal("custom_item"),
-    quantity: z.number().int()
+    quantity: z.int()
   })
 );
 const zSubscriptionItemCartObjectWritable = zCartItemResponseWritable.and(
   z.object({
     type: z.literal("subscription_item"),
-    quantity: z.number().int()
+    quantity: z.int()
   })
 );
 const zPromotionItemCartObjectWritable = zCartItemResponseWritable.and(
   z.object({
     type: z.literal("promotion_item"),
-    quantity: z.number().int()
+    quantity: z.int()
   })
 );
 const zCartsResponseWritable = z.object({
@@ -1861,6 +3118,7 @@ const zCartsResponseWritable = z.object({
       shipping: zFormattedPriceData.optional(),
       shipping_discount: zFormattedPriceData.optional(),
       discounts: z.record(
+        z.string(),
         z.object({
           amount: z.number().optional(),
           currency: z.string().optional(),
@@ -1882,47 +3140,81 @@ const zCartItemsResponseWritable = z.object({
   ).optional()
 });
 const zGetCartsHeaders = z.object({
-  "EP-Account-Management-Authentication-Token": z.string().optional(),
-  "X-Moltin-Customer-Token": z.string().optional()
+  "EP-Account-Management-Authentication-Token": z.string().register(z.globalRegistry, {
+    description: "An Account Management Authentication token to access a specific account's carts."
+  }).optional(),
+  "X-Moltin-Customer-Token": z.string().register(z.globalRegistry, {
+    description: "A customer token to access a specific customer's carts."
+  }).optional()
 });
 const zGetCartsQuery = z.object({
-  include: z.array(z.literal("custom_discounts")).optional(),
-  "page[limit]": z.number().int().gte(1).lte(100).optional().default(20),
-  "page[offset]": z.number().int().gte(0).lte(1e4).optional().default(0),
-  filter: z.string().optional()
+  include: z.array(z.literal("custom_discounts")).register(z.globalRegistry, {
+    description: "A comma-separated list of resources to include. See [Characteristics of Include Parameter](/guides/Getting-Started/includes#characteristics-of-include-parameter)."
+  }).optional(),
+  "page[limit]": z.int().gte(1).lte(100).register(z.globalRegistry, {
+    description: "The maximum number of records per page."
+  }).optional().default(20),
+  "page[offset]": z.int().gte(0).lte(1e4).register(z.globalRegistry, {
+    description: "The number of records to offset the results by."
+  }).optional().default(0),
+  filter: z.string().register(z.globalRegistry, {
+    description: 'Filter expression for searching carts. For more information about filtering, see [Filtering](/guides/Getting-Started/filtering).\n\n:::note\nFiltering is only supported when using **client credentials** (admin) authentication. When using a **customer token** (`X-Moltin-Customer-Token`) or **account token** (`EP-Account-Management-Authentication-Token`), the `filter` parameter is ignored and all carts associated with the customer or account are returned.\n:::\n\n**Supported Fields:**\n- `account_ids`: Filter carts by associated account ID (UUID format)\n- `name`: Filter carts by cart name (case-insensitive)\n\n**Supported Operators:**\n- `contains(field,value)`: Contains value in array field\n- `ilike(field,value)`: Case-insensitive string matching\n\n**Examples:**\n- `contains(account_ids,"c24e5698-3b54-491b-9225-559c7a9cf2b2")` - Find carts associated with a specific account\n- `ilike(name,"Shopping Cart")` - Find carts with name matching "Shopping Cart" (case-insensitive)\n- `ilike(name,"*cart*")` - Find carts with names containing "cart" (wildcard search)\n\n**Combining Filters:**\nYou can combine multiple filters using the `:`, and `|` operator for and and or respectively:\n- `contains(account_ids,"abc123"):ilike(name,"Holiday Cart")` - Find carts matching both conditions\n- `contains(account_ids,"abc123")|ilike(name,"Holiday Cart")` - Find carts matching either condition.\n'
+  }).optional()
 });
 const zGetCartsResponse = zCartCollectionResponse;
 const zCreateACartBody = zCartsRequest;
 const zCreateACartHeaders = z.object({
-  "EP-Account-Management-Authentication-Token": z.string().optional(),
-  "X-Moltin-Customer-Token": z.string().optional()
+  "EP-Account-Management-Authentication-Token": z.string().register(z.globalRegistry, {
+    description: "An Account Management Authentication token for the account to be associated with the cart."
+  }).optional(),
+  "X-Moltin-Customer-Token": z.string().register(z.globalRegistry, {
+    description: "A customer token for the customer to be associated with the cart."
+  }).optional()
 });
 const zCreateACartResponse = zCartEntityResponse;
 const zDeleteACartPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart that you want to delete."
+  })
+});
+const zDeleteACartResponse = z.void().register(z.globalRegistry, {
+  description: "No Content"
 });
-const zDeleteACartResponse = z.void();
 const zGetACartPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier for this cart that you created."
+  })
 });
 const zGetACartQuery = z.object({
-  include: z.array(z.enum(["custom_discounts", "promotions"])).optional()
+  include: z.array(z.enum(["custom_discounts", "promotions"])).register(z.globalRegistry, {
+    description: "A comma-separated list of resources to include. See [Characteristics of Include Parameter](/guides/Getting-Started/includes#characteristics-of-include-parameter)."
+  }).optional()
 });
 const zGetACartResponse = zCartEntityResponse;
 const zUpdateACartBody = zCartsRequest;
 const zUpdateACartPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of a cart created by you."
+  })
 });
 const zUpdateACartResponse = zCartEntityResponse;
 const zDeleteAllCartItemsPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart created by you."
+  })
+});
+const zDeleteAllCartItemsResponse = z.void().register(z.globalRegistry, {
+  description: "No Content"
 });
-const zDeleteAllCartItemsResponse = z.void();
 const zGetCartItemsPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart that you created."
+  })
 });
 const zGetCartItemsQuery = z.object({
-  include: z.array(z.enum(["tax_items", "custom_discounts", "promotions"])).optional()
+  include: z.array(z.enum(["tax_items", "custom_discounts", "promotions"])).register(z.globalRegistry, {
+    description: "A comma-separated list of related resources to include in the response."
+  }).optional()
 });
 const zGetCartItemsResponse = zCartItemsResponse;
 const zManageCartsBody = z.union([
@@ -1935,276 +3227,474 @@ const zManageCartsBody = z.union([
   zBulkAddItemsRequest
 ]);
 const zManageCartsPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart that you created."
+  })
 });
 const zManageCartsResponse = zCartsResponse;
 const zBulkUpdateItemsInCartBody = zBulkUpdateCartsItems;
 const zBulkUpdateItemsInCartPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart that you created."
+  })
 });
 const zBulkUpdateItemsInCartResponse = zCartItemCollectionResponse;
 const zDeleteACartItemPath = z.object({
-  cartID: z.string(),
-  cartitemID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart created by you."
+  }),
+  cartitemID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart that you want to delete."
+  })
 });
 const zDeleteACartItemResponse = zCartsResponse;
 const zUpdateACartItemBody = zUpdateCartsItems;
 const zUpdateACartItemPath = z.object({
-  cartID: z.string(),
-  cartitemID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "A unique identifier of the cart that you created."
+  }),
+  cartitemID: z.string().register(z.globalRegistry, {
+    description: "A unique identifier of the cart item."
+  })
 });
 const zUpdateACartItemResponse = zCartsResponse;
 const zDeleteAccountCartAssociationBody = zCartsRelationshipsAccountsData;
 const zDeleteAccountCartAssociationHeaders = z.object({
-  "EP-Account-Management-Authentication-Token": z.string().optional()
+  "EP-Account-Management-Authentication-Token": z.string().register(z.globalRegistry, {
+    description: "An Account Management Authentication token to access a specific account's carts."
+  }).optional()
 });
 const zDeleteAccountCartAssociationPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The ID for the cart created by the account."
+  })
+});
+const zDeleteAccountCartAssociationResponse = z.void().register(z.globalRegistry, {
+  description: "No Content"
 });
-const zDeleteAccountCartAssociationResponse = z.void();
 const zCreateAccountCartAssociationBody = zCartsRelationshipsAccountsData;
 const zCreateAccountCartAssociationHeaders = z.object({
-  "EP-Account-Management-Authentication-Token": z.string().optional()
+  "EP-Account-Management-Authentication-Token": z.string().register(z.globalRegistry, {
+    description: "An Account Management Authentication token to access a specific account's carts."
+  }).optional()
 });
 const zCreateAccountCartAssociationPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The ID for the cart created by the account. Ensure that you follow the guidelines for [Safe Characters](/guides/Getting-Started/safe-characters)."
+  })
 });
 const zCreateAccountCartAssociationResponse = z.union([
   zCartsRelationshipsAccountsData,
-  z.void()
+  z.void().register(z.globalRegistry, {
+    description: "No Content is sent back in case the account has already been associated to the cart."
+  })
 ]);
 const zDeleteCustomerCartAssociationBody = zCartsRelationshipsCustomersData;
 const zDeleteCustomerCartAssociationHeaders = z.object({
-  "X-Moltin-Customer-Token": z.string().optional()
+  "X-Moltin-Customer-Token": z.string().register(z.globalRegistry, {
+    description: "A customer token to access a specific customer's carts."
+  }).optional()
 });
 const zDeleteCustomerCartAssociationPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The ID for the cart created by the customer."
+  })
+});
+const zDeleteCustomerCartAssociationResponse = z.void().register(z.globalRegistry, {
+  description: "No Content"
 });
-const zDeleteCustomerCartAssociationResponse = z.void();
 const zCreateCustomerCartAssociationBody = zCartsRelationshipsCustomersData;
 const zCreateCustomerCartAssociationHeaders = z.object({
-  "X-Moltin-Customer-Token": z.string().optional()
+  "X-Moltin-Customer-Token": z.string().register(z.globalRegistry, {
+    description: "A customer token to access a specific customer's carts."
+  }).optional()
 });
 const zCreateCustomerCartAssociationPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The ID for the cart created by the customer. Ensure that you follow the guidelines for [Safe Characters](/guides/Getting-Started/safe-characters)."
+  })
 });
 const zCreateCustomerCartAssociationResponse = z.union([
   zCartsRelationshipsCustomersData,
-  z.void()
+  z.void().register(z.globalRegistry, {
+    description: "No Content"
+  })
 ]);
 const zDeleteAPromotionViaPromotionCodePath = z.object({
-  cartID: z.string(),
-  promoCode: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "Specifies the unique identifier of a cart created by you."
+  }),
+  promoCode: z.string().register(z.globalRegistry, {
+    description: "Specifies the promotion code to be deleted."
+  })
+});
+const zDeleteAPromotionViaPromotionCodeResponse = z.void().register(z.globalRegistry, {
+  description: "No Content"
 });
-const zDeleteAPromotionViaPromotionCodeResponse = z.void();
 const zAddTaxItemToCartBody = zCartItemTaxesEntityResponseWritable;
 const zAddTaxItemToCartPath = z.object({
-  cartID: z.string(),
-  cartitemID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart."
+  }),
+  cartitemID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart item."
+  })
 });
 const zAddTaxItemToCartResponse = zCartItemTaxesEntityResponse;
 const zAddTaxItemToCartItemComponentBody = zCartItemTaxesEntityResponseWritable;
 const zAddTaxItemToCartItemComponentPath = z.object({
-  cartID: z.string(),
-  cartitemID: z.string(),
-  productID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart."
+  }),
+  cartitemID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart item."
+  }),
+  productID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the component product within the bundle."
+  })
 });
 const zAddTaxItemToCartItemComponentResponse = zCartItemTaxesEntityResponse;
 const zDeleteTaxItemFromCartItemComponentPath = z.object({
-  cartID: z.string(),
-  cartitemID: z.string(),
-  productID: z.string(),
-  taxitemID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart."
+  }),
+  cartitemID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart item."
+  }),
+  productID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the component product within the bundle."
+  }),
+  taxitemID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the tax item on the component product."
+  })
+});
+const zDeleteTaxItemFromCartItemComponentResponse = z.void().register(z.globalRegistry, {
+  description: "No Content"
 });
-const zDeleteTaxItemFromCartItemComponentResponse = z.void();
 const zUpdateTaxItemFromCartItemComponentBody = zCartItemTaxesEntityResponseWritable;
 const zUpdateTaxItemFromCartItemComponentPath = z.object({
-  cartID: z.string(),
-  cartitemID: z.string(),
-  productID: z.string(),
-  taxitemID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart."
+  }),
+  cartitemID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart item."
+  }),
+  productID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the component product within the bundle."
+  }),
+  taxitemID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the tax item on the component product."
+  })
 });
 const zUpdateTaxItemFromCartItemComponentResponse = zCartItemTaxesEntityResponse;
 const zBulkDeleteTaxItemsFromCartPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart."
+  })
+});
+const zBulkDeleteTaxItemsFromCartResponse = z.void().register(z.globalRegistry, {
+  description: "No Content"
 });
-const zBulkDeleteTaxItemsFromCartResponse = z.void();
 const zBulkAddTaxItemsToCartBody = zCartsBulkTaxesWritable;
 const zBulkAddTaxItemsToCartPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart."
+  })
 });
 const zBulkAddTaxItemsToCartResponse = zCartsBulkTaxes;
 const zDeleteATaxItemPath = z.object({
-  cartID: z.string(),
-  cartitemID: z.string(),
-  taxitemID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart."
+  }),
+  cartitemID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart item."
+  }),
+  taxitemID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the tax item."
+  })
+});
+const zDeleteATaxItemResponse = z.void().register(z.globalRegistry, {
+  description: "No Content"
 });
-const zDeleteATaxItemResponse = z.void();
 const zUpdateATaxItemBody = zCartItemTaxesEntityResponseWritable;
 const zUpdateATaxItemPath = z.object({
-  cartID: z.string(),
-  cartitemID: z.string(),
-  taxitemID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart."
+  }),
+  cartitemID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart item."
+  }),
+  taxitemID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the tax item."
+  })
 });
 const zUpdateATaxItemResponse = zCartItemTaxesEntityResponse;
 const zBulkDeleteCustomDiscountsFromCartPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "Specifies the unique ID for the cart."
+  })
+});
+const zBulkDeleteCustomDiscountsFromCartResponse = z.void().register(z.globalRegistry, {
+  description: "No Content"
 });
-const zBulkDeleteCustomDiscountsFromCartResponse = z.void();
 const zBulkAddCustomDiscountsToCartBody = zCartsBulkCustomDiscounts;
 const zBulkAddCustomDiscountsToCartPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "Specifies the system generated ID for the cart that the shopper created."
+  })
 });
 const zBulkAddCustomDiscountsToCartResponse = z.union([
   zCartsBulkCustomDiscountsResponse,
   zCartsBulkCustomDiscountsCollectionResponse
 ]);
 const zDeleteCustomDiscountFromCartPath = z.object({
-  cartID: z.string(),
-  customdiscountID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "Specifies the unique ID for the cart."
+  }),
+  customdiscountID: z.string().register(z.globalRegistry, {
+    description: "Specifies the ID for the custom discount to be deleted."
+  })
+});
+const zDeleteCustomDiscountFromCartResponse = z.void().register(z.globalRegistry, {
+  description: "No Content"
 });
-const zDeleteCustomDiscountFromCartResponse = z.void();
 const zUpdateCustomDiscountForCartBody = zCartsCustomDiscountsEntityRequest;
 const zUpdateCustomDiscountForCartPath = z.object({
-  cartID: z.string(),
-  customdiscountID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "Specifies the unique ID for the cart."
+  }),
+  customdiscountID: z.string().register(z.globalRegistry, {
+    description: "Specifies the ID for the custom discount to be updated."
+  })
 });
 const zUpdateCustomDiscountForCartResponse = zCartsCustomDiscountsEntityResponse;
 const zAddCustomDiscountToCartItemBody = zCartsCustomDiscountsCreateRequest;
 const zAddCustomDiscountToCartItemPath = z.object({
-  cartID: z.string(),
-  cartitemID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "Specifies the ID for the cart."
+  }),
+  cartitemID: z.string().register(z.globalRegistry, {
+    description: "Specifies the unique identifier for the cart item."
+  })
 });
 const zAddCustomDiscountToCartItemResponse = z.union([
   zCartsCustomDiscountsCollectionResponse,
   zCartsCustomDiscountsEntityResponse
 ]);
 const zDeleteCustomDiscountFromCartItemPath = z.object({
-  cartID: z.string(),
-  cartitemID: z.string(),
-  customdiscountID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "Specifies the ID for the cart."
+  }),
+  cartitemID: z.string().register(z.globalRegistry, {
+    description: "Specifies the ID for the cart item."
+  }),
+  customdiscountID: z.string().register(z.globalRegistry, {
+    description: "Specifies the ID for the custom discount to be deleted."
+  })
+});
+const zDeleteCustomDiscountFromCartItemResponse = z.void().register(z.globalRegistry, {
+  description: "No Content"
 });
-const zDeleteCustomDiscountFromCartItemResponse = z.void();
 const zUpdateCustomDiscountForCartItemBody = zCartsCustomDiscountsEntityRequest;
 const zUpdateCustomDiscountForCartItemPath = z.object({
-  cartID: z.string(),
-  cartitemID: z.string(),
-  customdiscountID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "Specifies the ID for the cart."
+  }),
+  cartitemID: z.string().register(z.globalRegistry, {
+    description: "Specifies the ID for the cart item."
+  }),
+  customdiscountID: z.string().register(z.globalRegistry, {
+    description: "Specifies the ID for the custom discount to be updated."
+  })
 });
 const zUpdateCustomDiscountForCartItemResponse = zCartsCustomDiscountsEntityResponse;
 const zGetShippingGroupsPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The ID of the cart"
+  })
 });
 const zGetShippingGroupsResponse = z.object({
   data: z.array(zShippingGroupResponse).optional()
+}).register(z.globalRegistry, {
+  description: "A list of shipping groups"
 });
 const zCreateShippingGroupBody = zCreateShippingGroupRequest;
 const zCreateShippingGroupPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The ID of the cart"
+  })
 });
 const zCreateShippingGroupResponse = zShippingGroupEntityResponse;
 const zDeleteCartShippingGroupPath = z.object({
-  cartId: z.string(),
-  shippingGroupId: z.string()
+  cartId: z.string().register(z.globalRegistry, {
+    description: "The ID of the cart"
+  }),
+  shippingGroupId: z.string().register(z.globalRegistry, {
+    description: "The ID of the shipping group to delete"
+  })
+});
+const zDeleteCartShippingGroupResponse = z.void().register(z.globalRegistry, {
+  description: "Successfully deleted the shipping group"
 });
-const zDeleteCartShippingGroupResponse = z.void();
 const zGetShippingGroupByIdPath = z.object({
-  cartId: z.string(),
-  shippingGroupId: z.string()
+  cartId: z.string().register(z.globalRegistry, {
+    description: "The ID of the cart"
+  }),
+  shippingGroupId: z.string().register(z.globalRegistry, {
+    description: "The ID of the shipping group"
+  })
 });
 const zGetShippingGroupByIdResponse = z.object({
   data: zShippingGroupResponse.optional()
+}).register(z.globalRegistry, {
+  description: "Shipping group details"
 });
 const zUpdateShippingGroupBody = zUpdateCartShippingGroupRequest;
 const zUpdateShippingGroupPath = z.object({
-  cartId: z.string(),
-  shippingGroupId: z.string()
+  cartId: z.string().register(z.globalRegistry, {
+    description: "The ID of the cart"
+  }),
+  shippingGroupId: z.string().register(z.globalRegistry, {
+    description: "The ID of the shipping group"
+  })
 });
 const zUpdateShippingGroupResponse = zShippingGroupEntityResponse;
 const zCreateCartPaymentIntentBody = zElasticPathPaymentsPoweredByStripePayment;
 const zCreateCartPaymentIntentPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The universally unique identifier of the cart for which you want to create a payment intent."
+  })
 });
 const zCreateCartPaymentIntentResponse = zCartEntityResponse;
 const zUpdateCartPaymentIntentBody = zCartPaymentUpdate;
 const zUpdateCartPaymentIntentPath = z.object({
-  cartID: z.string(),
-  paymentIntentID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the cart."
+  }),
+  paymentIntentID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the payment intent."
+  })
 });
 const zUpdateCartPaymentIntentResponse = zCartEntityResponse;
 const zCheckoutApiBody = z.union([zCustomerCheckout, zAccountCheckout]);
 const zCheckoutApiHeaders = z.object({
-  "EP-Account-Management-Authentication-Token": z.string().optional()
+  "EP-Account-Management-Authentication-Token": z.string().register(z.globalRegistry, {
+    description: "An account management authentication token that identifies the authenticated account member."
+  }).optional()
 });
 const zCheckoutApiPath = z.object({
-  cartID: z.string()
+  cartID: z.string().register(z.globalRegistry, {
+    description: "The ID of the cart that you want to checkout."
+  })
 });
 const zCheckoutApiResponse = zOrderEntityResponse;
 const zGetCustomerOrdersHeaders = z.object({
-  "x-moltin-customer-token": z.string().optional()
+  "x-moltin-customer-token": z.string().register(z.globalRegistry, {
+    description: "A customer token to access a specific customer's orders."
+  }).optional()
 });
 const zGetCustomerOrdersQuery = z.object({
-  include: z.string().optional(),
-  "page[limit]": z.number().int().gte(1).lte(100).optional().default(20),
-  "page[offset]": z.number().int().gte(0).lte(1e4).optional().default(0),
-  filter: z.string().optional()
+  include: z.string().register(z.globalRegistry, {
+    description: "Comma-delimited string of entities to include (items, tax_items, custom_discounts, promotions)."
+  }).optional(),
+  "page[limit]": z.int().gte(1).lte(100).register(z.globalRegistry, {
+    description: "The maximum number of records per page."
+  }).optional().default(20),
+  "page[offset]": z.int().gte(0).lte(1e4).register(z.globalRegistry, {
+    description: "The number of records to offset the results by."
+  }).optional().default(0),
+  filter: z.string().register(z.globalRegistry, {
+    description: "Filter expression for searching orders. See filtering documentation for available operators and attributes."
+  }).optional()
 });
 const zGetCustomerOrdersResponse = zOrderCollectionResponse;
 const zGetAnOrderPath = z.object({
-  orderID: z.string()
+  orderID: z.string().register(z.globalRegistry, {
+    description: "The ID of the order."
+  })
 });
 const zGetAnOrderQuery = z.object({
-  include: z.string().optional()
+  include: z.string().register(z.globalRegistry, {
+    description: "Comma-delimited string of entities to include (items, tax_items, custom_discounts, promotions)."
+  }).optional()
 });
 const zGetAnOrderResponse = zOrderEntityResponse;
 const zUpdateAnOrderBody = zOrdersUpdateRequest;
 const zUpdateAnOrderPath = z.object({
-  orderID: z.string()
+  orderID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the order."
+  })
 });
 const zUpdateAnOrderResponse = zOrderEntityResponse;
 const zGetOrderItemsPath = z.object({
-  orderID: z.string()
+  orderID: z.string().register(z.globalRegistry, {
+    description: "The ID of the order."
+  })
 });
 const zGetOrderItemsQuery = z.object({
-  include: z.string().optional()
+  include: z.string().register(z.globalRegistry, {
+    description: "Comma-delimited string of entities to include (tax_items, custom_discounts, promotions)."
+  }).optional()
 });
 const zGetOrderItemsResponse = zOrderItemCollectionResponse;
 const zAnonymizeOrdersBody = zOrdersAnonymizeRequest.and(z.unknown());
 const zAnonymizeOrdersResponse = zOrdersListResponse;
 const zConfirmOrderPath = z.object({
-  orderID: z.string()
+  orderID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the order to confirm."
+  })
 });
 const zConfirmOrderResponse = zTransactionEntityResponse;
 const zPaymentSetupBody = zPaymentsRequest;
 const zPaymentSetupPath = z.object({
-  orderID: z.string()
+  orderID: z.string().register(z.globalRegistry, {
+    description: "The Universally Unique Identifier (UUID) of the order you want to pay for."
+  })
 });
 const zPaymentSetupResponse = zTransactionEntityResponse;
 const zConfirmPaymentBody = zOrdersTransactionsConfirmRequest;
 const zConfirmPaymentPath = z.object({
-  orderID: z.string(),
-  transactionID: z.string()
+  orderID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the order."
+  }),
+  transactionID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the transaction."
+  })
 });
 const zConfirmPaymentResponse = zTransactionEntityResponse;
 const zCaptureATransactionBody = zOrdersTransactionsCaptureRequest;
 const zCaptureATransactionPath = z.object({
-  orderID: z.string(),
-  transactionID: z.string()
+  orderID: z.string().register(z.globalRegistry, {
+    description: "The UUID of the order."
+  }),
+  transactionID: z.string().register(z.globalRegistry, {
+    description: "The UUID of the transaction to capture."
+  })
 });
 const zCaptureATransactionResponse = zTransactionEntityResponse;
 const zRefundATransactionBody = zOrdersTransactionsRefundRequest;
 const zRefundATransactionPath = z.object({
-  orderID: z.string(),
-  transactionID: z.string()
+  orderID: z.string().register(z.globalRegistry, {
+    description: "The UUID of the order."
+  }),
+  transactionID: z.string().register(z.globalRegistry, {
+    description: "The UUID of the transaction you want to refund."
+  })
 });
 const zRefundATransactionResponse = zTransactionEntityResponse;
 const zGetOrderTransactionsPath = z.object({
-  orderID: z.string()
+  orderID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the order."
+  })
 });
 const zGetOrderTransactionsResponse = zTransactionListResponse;
 const zGetATransactionPath = z.object({
-  orderID: z.string(),
-  transactionID: z.string()
+  orderID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the order that you require transactions for."
+  }),
+  transactionID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the transaction."
+  })
 });
 const zGetATransactionResponse = zResponseData.and(
   z.object({
@@ -2213,21 +3703,33 @@ const zGetATransactionResponse = zResponseData.and(
 );
 const zCancelATransactionBody = zOrdersTransactionsCancelRequest;
 const zCancelATransactionPath = z.object({
-  orderID: z.string(),
-  transactionID: z.string()
+  orderID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the order."
+  }),
+  transactionID: z.string().register(z.globalRegistry, {
+    description: "The unique identifier of the transaction to be canceled or voided."
+  })
 });
 const zCancelATransactionResponse = zTransactionEntityResponse;
 const zGetOrderShippingGroupsPath = z.object({
-  orderID: z.string()
+  orderID: z.string().register(z.globalRegistry, {
+    description: "The ID of the order"
+  })
 });
 const zGetOrderShippingGroupsResponse = z.object({
   data: z.array(zShippingGroupResponse).optional()
+}).register(z.globalRegistry, {
+  description: "A list of shipping groups"
 });
 const zCreateOrderShippingGroupBody = z.object({
   data: z.object({
     type: z.literal("shipping_group"),
-    shipping_type: z.string().optional(),
-    tracking_reference: z.string().optional(),
+    shipping_type: z.string().register(z.globalRegistry, {
+      description: "The shipping type for this group"
+    }).optional(),
+    tracking_reference: z.string().register(z.globalRegistry, {
+      description: "Tracking reference for the shipment"
+    }).optional(),
     address: z.object({
       first_name: z.string().optional(),
       last_name: z.string().optional(),
@@ -2243,41 +3745,61 @@ const zCreateOrderShippingGroupBody = z.object({
       instructions: z.string().optional()
     }).optional(),
     delivery_estimate: z.object({
-      start: z.string().datetime().optional(),
-      end: z.string().datetime().optional()
+      start: z.iso.datetime().optional(),
+      end: z.iso.datetime().optional()
     }).optional()
   }).optional()
+}).register(z.globalRegistry, {
+  description: "Shipping group details"
 });
 const zCreateOrderShippingGroupPath = z.object({
-  orderID: z.string()
+  orderID: z.string().register(z.globalRegistry, {
+    description: "The ID of the order"
+  })
 });
 const zCreateOrderShippingGroupResponse = z.object({
   data: zShippingGroupResponse.optional()
+}).register(z.globalRegistry, {
+  description: "Shipping group created"
 });
 const zGetShippingGroupsByIdPath = z.object({
-  orderID: z.string(),
-  shippingGroupID: z.string()
+  orderID: z.string().register(z.globalRegistry, {
+    description: "The ID of the order"
+  }),
+  shippingGroupID: z.string().register(z.globalRegistry, {
+    description: "The ID of the shipping group"
+  })
 });
 const zGetShippingGroupsByIdQuery = z.object({
-  include: z.literal("items").optional()
+  include: z.literal("items").register(z.globalRegistry, {
+    description: "A comma-separated list of related resources to include in the response."
+  }).optional()
 });
 const zGetShippingGroupsByIdResponse = zShippingGroupEntityResponse;
 const zPutShippingGroupByIdBody = zUpdateOrderShippingGroupRequest;
 const zPutShippingGroupByIdPath = z.object({
-  orderID: z.string(),
-  shippingGroupID: z.string()
+  orderID: z.string().register(z.globalRegistry, {
+    description: "The ID of the order"
+  }),
+  shippingGroupID: z.string().register(z.globalRegistry, {
+    description: "The ID of the shipping group"
+  })
 });
 const zPutShippingGroupByIdResponse = zShippingGroupEntityResponse;
 const zGetV2SettingsCartResponse = zSettingsCart;
 const zPutV2SettingsCartBody = zSettingsCartWritable;
 const zPutV2SettingsCartResponse = zSettingsCart;
 const zGetV2SettingsCartStoreIdPath = z.object({
-  storeID: z.string()
+  storeID: z.string().register(z.globalRegistry, {
+    description: "The store ID."
+  })
 });
 const zGetV2SettingsCartStoreIdResponse = zSettingsCart;
 const zPutV2SettingsCartStoreIdBody = zSettingsCartWritable;
 const zPutV2SettingsCartStoreIdPath = z.object({
-  storeID: z.string()
+  storeID: z.string().register(z.globalRegistry, {
+    description: "The store ID."
+  })
 });
 const zPutV2SettingsCartStoreIdResponse = zSettingsCart;
 export {