@01.software/sdk 0.71.0 → 0.72.1

package/dist/{payload-types-BgOEk6Y9.d.ts → payload-types-BRg8Yary.d.ts}

@@ -542,7 +542,7 @@ interface CarouselBlock {
     blockType: 'Carousel';
 }
 /**
- * Manage image assets used by content and products.
+ * Manage visual assets used by content and products.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "images".
@@ -555,7 +555,7 @@ interface Image {
      */
     alt?: string | null;
     /**
-     * Low quality image placeholder
+     * A low-resolution preview of the image.
      */
     lqip?: string | null;
     palette?: {
@@ -652,7 +652,7 @@ interface Tenant {
     } | unknown[] | string | number | boolean | null;
     name: string;
     /**
-     * IANA time zone for workspace daily aggregation and AI usage date boundaries.
+     * Time zone for workspace daily aggregation and AI usage date boundaries.
      */
     timezone?: string | null;
     /**
@@ -773,7 +773,7 @@ interface Tenant {
      */
     senderIdentity?: {
         /**
-         * Brand name shown in the recipient's inbox. If blank, commerce and event notifications use the workspace name; customer authentication emails (password reset, sign-in codes) use the platform default sender. (The send-from address stays on the platform domain.)
+         * Brand name shown in the recipient's inbox. If blank, commerce and event notifications use the workspace name; customer authentication emails (password reset, sign-in codes) use the platform default sender. A verified sending domain uses an address on that domain. If the domain is unverified or the sender address settings disagree, the platform address is used.
          */
         displayName?: string | null;
         /**
@@ -1111,7 +1111,7 @@ interface Audience {
 interface EmailLog {
     id: string;
     /**
-     * Originating workspace. NULL for system-level emails (super-admin only).
+     * The workspace that sent the email. System emails have no workspace assigned and can only be viewed by a Super Admin.
      */
     tenant?: (string | null) | Tenant;
     to: string;
@@ -1139,7 +1139,7 @@ interface EmailLog {
      */
     recipientConsent?: ('marketing' | 'transactional' | 'service_notice') | null;
     /**
-     * Commerce notification send audit metadata. Consent classification remains owned by recipientConsent.
+     * Commerce notification send history. See the Consent category field for the notification’s consent classification.
      */
     commerceNotification?: {
         event?: ('orderPaid' | 'orderCanceled' | 'fulfillmentShipped' | 'orderDelivered' | 'returnRequested' | 'returnApproved' | 'returnRejected' | 'returnCanceled' | 'returnCompleted' | 'eventRegistrationConfirmed' | 'eventOccurrenceCanceled') | null;
@@ -1171,15 +1171,15 @@ interface CommerceNotificationIntent {
      */
     recipientEmail?: string | null;
     /**
-     * Consent classification used by the send-time eligibility gate.
+     * Notification category used to check recipient consent before sending.
      */
     recipientConsent: 'marketing' | 'transactional' | 'service_notice';
     /**
-     * Locale hint for template rendering.
+     * Language to refer to when composing the notification.
      */
     locale?: string | null;
     /**
-     * Secret-free event snapshot for processor template rendering.
+     * Record of the event at the time it occurred, used to compose the notification. Contains no secrets.
      */
     payload?: {
         [k: string]: unknown;
@@ -1275,7 +1275,7 @@ interface Order {
      */
     shippingAmount?: number | null;
     /**
-     * Shipping charge line snapshots at time of order
+     * Shipping charges saved at the time of the order.
      */
     shippingLines?: {
         label: string;
@@ -1320,7 +1320,7 @@ interface Order {
      */
     appliedDiscount?: (string | null) | Discount;
     /**
-     * Discount application snapshots captured at order creation.
+     * Discount applications saved when the order was created.
      */
     appliedDiscounts?: {
         code?: string | null;
@@ -1352,7 +1352,7 @@ interface Order {
     currentTotalAmount?: number | null;
     taxAmount?: number | null;
     /**
-     * Initial shipping refund policy snapshot at order time
+     * Initial shipping refund policy saved at the time of the order.
      */
     returnShippingRefundPolicySnapshot?: {
         [k: string]: unknown;
@@ -1396,7 +1396,7 @@ interface Order {
     integrationMetadata?: {
         [k: string]: unknown;
     } | unknown[] | string | number | boolean | null;
-    source?: ('web' | 'app' | 'manual' | 'api' | 'import') | null;
+    source?: ('web' | 'app' | 'manual' | 'api' | 'import' | 'in_person') | null;
     deliveryMethod?: ('shipping' | 'pickup') | null;
     tags?: (string | OrderTag)[] | null;
     tagSlugs?: {
@@ -1408,7 +1408,7 @@ interface Order {
      */
     test?: boolean | null;
     /**
-     * Market snapshot used for order pricing.
+     * Pricing market saved when the order was created.
      */
     market?: (string | null) | Market;
     currency?: string | null;
@@ -1423,7 +1423,7 @@ interface Order {
     deletedAt?: string | null;
 }
 /**
- * Manage customer information and account status.
+ * Manage contact information and account status.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "customers".
@@ -1449,12 +1449,12 @@ interface Customer {
      */
     authProvider?: ('local' | 'google' | 'apple' | 'kakao' | 'naver') | null;
     /**
-     * External provider user ID. Paired with authProvider to identify the linked account and not edited after creation.
+     * External provider user ID. Identifies the linked account together with its sign-in provider and cannot be edited after creation.
      */
     providerUserId?: string | null;
     lastLoginAt?: string | null;
     /**
-     * Last password change timestamp (used for JWT revocation)
+     * Last password change time, used to check whether earlier sign-in sessions are still valid.
      */
     passwordChangedAt?: string | null;
     orders?: {
@@ -1473,6 +1473,9 @@ interface Customer {
      * Read-only, automatically counted orders, including pending orders, excluding canceled, refunded, returned, test and trashed orders.
      */
     totalOrderCount?: number | null;
+    /**
+     * Order total in one verified currency. No value is provided when currencies are multiple or unverified.
+     */
     lifetimeValue?: number | null;
     firstOrderAt?: string | null;
     lastOrderAt?: string | null;
@@ -1535,7 +1538,7 @@ interface Customer {
         };
     };
     /**
-     * Workspace self-reported value. It is not a hosted server consent receipt.
+     * Workspace self-reported value. It does not replace server-recorded hosted consent history.
      */
     acceptsTos?: boolean | null;
     /**
@@ -1574,7 +1577,7 @@ interface Customer {
     collection: 'customers';
 }
 /**
- * Manage customer groups for coupons, targeting, and badges.
+ * Manage audience groupings for coupons, targeting, and badges.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "customer-groups".
@@ -1590,7 +1593,7 @@ interface CustomerGroup {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -1884,7 +1887,7 @@ interface Product {
         totalDocs?: number;
     };
     /**
-     * Markets where this product is available. Leave empty to exclude it from market-aware catalogs.
+     * New products with no markets are assigned the active default market, if one exists. Removing all markets from an existing product excludes it from market catalogs.
      */
     markets?: (string | Market)[] | null;
     /**
@@ -2002,7 +2005,7 @@ interface Product {
     deletedAt?: string | null;
 }
 /**
- * Manage video content, processing, and publishing status.
+ * Manage audiovisual content, processing, and publishing status.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "videos".
@@ -2017,7 +2020,7 @@ interface Video {
     subtitle?: string | null;
     filename?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     content?: {
@@ -2110,7 +2113,7 @@ interface Video {
     deletedAt?: string | null;
 }
 /**
- * Manage live stream schedules and stream status.
+ * Manage broadcast schedules and transmission status.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "live-streams".
@@ -2124,7 +2127,7 @@ interface LiveStream {
      */
     subtitle?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -2218,7 +2221,7 @@ interface VideoCategory {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -2252,7 +2255,7 @@ interface VideoTag {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -2443,11 +2446,11 @@ interface InventoryAdjustment {
     variant?: (string | null) | ProductVariant;
     product?: (string | null) | Product;
     /**
-     * SKU snapshot at adjustment time.
+     * SKU saved at the time of the inventory adjustment.
      */
     sku?: string | null;
     /**
-     * Variant title snapshot at adjustment time.
+     * Variant name saved at the time of the inventory adjustment.
      */
     variantTitle?: string | null;
     /**
@@ -2503,7 +2506,7 @@ interface Return {
      */
     rejectionReasonCode?: ('window_expired' | 'used_or_damaged' | 'non_returnable' | 'other') | null;
     /**
-     * Detailed return reason
+     * Describe any circumstances not covered by the selected reason.
      */
     reasonDetail?: string | null;
     /**
@@ -2519,7 +2522,7 @@ interface Return {
      */
     canceledAt?: string | null;
     /**
-     * Validated actor that committed the return cancellation.
+     * Operator or server account that confirmed the return cancellation.
      */
     canceledBy?: string | null;
     items?: {
@@ -2533,7 +2536,7 @@ interface Return {
     adminNotes?: string | null;
     completedAt?: string | null;
     /**
-     * Refund receipt URL
+     * Enter a receipt link where the refund can be reviewed.
      */
     refundReceiptUrl?: string | null;
     refundAmount: number;
@@ -2542,7 +2545,7 @@ interface Return {
      */
     returnShippingFee?: number | null;
     /**
-     * Initial order shipping amount refunded
+     * The portion of the original order shipping charge refunded with this return.
      */
     initialShippingRefundAmount?: number | null;
     initialShippingRefundSuggestedAmount?: number | null;
@@ -2655,7 +2658,7 @@ interface ProductOption {
      */
     product: string | Product;
     /**
-     * Option display name in Admin and storefront. (e.g. Color, Size)
+     * Option name. (e.g. Color, Size)
      */
     title: string;
     /**
@@ -2676,7 +2679,7 @@ interface ProductOption {
     deletedAt?: string | null;
 }
 /**
- * Product categories are a hierarchical taxonomy for navigation and grouping.
+ * Organize products hierarchically for navigation and grouping.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "product-categories".
@@ -2692,7 +2695,7 @@ interface ProductCategory {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -2712,7 +2715,7 @@ interface ProductCategory {
     deletedAt?: string | null;
 }
 /**
- * Product tags are flat labels for search and loose grouping.
+ * Flat labels for product search and loose grouping.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "product-tags".
@@ -2728,7 +2731,7 @@ interface ProductTag {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -2744,7 +2747,7 @@ interface ProductTag {
     deletedAt?: string | null;
 }
 /**
- * Manage brand details and logos linked to products.
+ * Manage details and logos linked to products.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "brands".
@@ -2755,7 +2758,7 @@ interface Brand {
     tenant?: (string | null) | Tenant;
     name: string;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     content?: {
@@ -2848,7 +2851,7 @@ interface BrandLogo {
      */
     alt?: string | null;
     /**
-     * Low quality image placeholder
+     * A low-resolution preview of the image.
      */
     lqip?: string | null;
     palette?: {
@@ -2968,7 +2971,7 @@ interface ProductCollection {
      */
     subtitle?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     content?: {
@@ -3044,7 +3047,7 @@ interface ProductCollection {
     deletedAt?: string | null;
 }
 /**
- * Manage shipping fee rules and default shipping policies.
+ * Manage shipping fee rules and default delivery terms.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "shipping-policies".
@@ -3093,7 +3096,7 @@ interface ShippingPolicy {
         id?: string | null;
     }[] | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -3213,7 +3216,7 @@ interface CheckoutItem {
     createdAt: string;
 }
 /**
- * In-progress checkout snapshots. Promoted to an order on payment.
+ * Track in-progress payment snapshots. Promoted to an order on payment.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "checkouts".
@@ -3247,7 +3250,7 @@ interface Checkout {
      */
     cartRevision: number;
     /**
-     * Market snapshot used for checkout pricing.
+     * Pricing market saved when the checkout was created.
      */
     market?: (string | null) | Market;
     customer?: (string | null) | Customer;
@@ -3289,6 +3292,7 @@ interface Checkout {
         deliveryMessage?: string | null;
     };
     deliveryMethod?: ('shipping' | 'pickup') | null;
+    source?: ('web' | 'in_person') | null;
     items?: {
         docs?: (string | CheckoutItem)[];
         hasNextPage?: boolean;
@@ -3324,7 +3328,7 @@ interface Checkout {
      */
     appliedDiscount?: (string | null) | Discount;
     /**
-     * Discount application snapshots captured at checkout.
+     * Discount applications saved at checkout.
      */
     appliedDiscounts?: {
         code?: string | null;
@@ -3459,7 +3463,7 @@ interface Cart {
     openCheckout?: (string | null) | Checkout;
     currency?: string | null;
     /**
-     * Market used for cart pricing. Locked by the first market-aware add-item or create call.
+     * Market used for cart pricing. Once a market is first determined when creating the cart or adding an item, it cannot change.
      */
     market?: (string | null) | Market;
     subtotalAmount?: number | null;
@@ -3493,7 +3497,7 @@ interface Cart {
     createdAt: string;
 }
 /**
- * Manage discount codes, eligibility rules, and usage limits.
+ * Manage coupon codes and automatic discounts applied at checkout, with eligibility rules and usage limits.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "discounts".
@@ -3580,7 +3584,7 @@ interface Discount {
      */
     maxUses?: number | null;
     /**
-     * Read-only usage count accumulated when this discount is applied successfully.
+     * Read-only code discount usage count, including pending checkout reservations. Automatic discounts are not counted.
      */
     usesCount?: number | null;
     /**
@@ -3596,7 +3600,7 @@ interface Discount {
      */
     isCombinable?: boolean | null;
     /**
-     * Only across-order allocation is supported. Each-line-item is always rejected at checkout and cannot be saved.
+     * Allocations other than “Across order”, including “Each line item”, are always rejected at checkout. Change to “Across order” and save.
      */
     allocationMethod?: ('across' | 'each') | null;
     /**
@@ -3654,6 +3658,7 @@ interface CartItem {
 interface PaymentSession {
     id: string;
     tenant?: (string | null) | Tenant;
+    standardLongTailAlertedAt?: string | null;
     finalizationAlertedAt?: string | null;
     status: 'pending' | 'captured' | 'failed' | 'canceled';
     /**
@@ -3834,7 +3839,7 @@ interface CommercePaymentAccount {
     deletedAt?: string | null;
 }
 /**
- * Manage events with schedules, locations, and recurrence rules.
+ * Manage schedules, locations, and recurrence rules.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "events".
@@ -3849,7 +3854,7 @@ interface Event {
      */
     subtitle?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     content?: {
@@ -3890,7 +3895,7 @@ interface Event {
      */
     endsAt: string;
     /**
-     * IANA time zone used to expand recurring occurrences.
+     * Time zone used to expand recurring occurrences. After saving, changes require schedule conversion.
      */
     timezone?: string | null;
     isAllDay?: boolean | null;
@@ -3978,7 +3983,7 @@ interface Event {
         totalDocs?: number;
     };
     /**
-     * Registrations for this event. Creation and lifecycle status changes are handled by the registration collection and lifecycle actions.
+     * Registrations for this event. Use the actions on the registration screen to change registration status and check in attendees.
      */
     registrations?: {
         docs?: (string | EventRegistration)[];
@@ -4028,7 +4033,7 @@ interface Event {
     status?: ('draft' | 'published' | 'archived' | 'canceled') | null;
     coverImage?: (string | null) | Image;
     /**
-     * Public API visibility. Unlisted events remain available to public API reads, but are not intended for promoted listings.
+     * Public API visibility. Unlisted events are also included in public API reads.
      */
     visibility?: ('public' | 'unlisted' | 'private') | null;
     /**
@@ -4036,7 +4041,7 @@ interface Event {
      */
     sourceType?: ('native' | 'external') | null;
     /**
-     * External event identity. Public API reads expose only provider and URL.
+     * External event identity. Provider, source ID, and URL can all be included in public read responses.
      */
     externalSource?: {
         provider?: string | null;
@@ -4066,7 +4071,7 @@ interface EventCategory {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -4100,7 +4105,7 @@ interface EventTag {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -4130,7 +4135,7 @@ interface EventOccurrence {
     displayTitle?: string | null;
     event: string | Event;
     /**
-     * RECURRENCE-ID based on original DTSTART
+     * Identifies this occurrence by its originally scheduled start time and time zone. Kept when you change this occurrence’s time.
      */
     instanceKey?: string | null;
     /**
@@ -4142,7 +4147,7 @@ interface EventOccurrence {
      */
     endsAt: string;
     /**
-     * IANA time zone used for occurrence identity. Existing occurrences cannot change it.
+     * Time zone used to distinguish this occurrence. It cannot be changed on an existing occurrence.
      */
     timezone?: string | null;
     isAllDay?: boolean | null;
@@ -4171,7 +4176,7 @@ interface EventOccurrence {
     registrationCount?: number | null;
     waitlistCount?: number | null;
     /**
-     * Registrations linked to this occurrence. Registration status and check-in are managed through the registration collection and lifecycle actions.
+     * Registrations linked to this occurrence. Use the actions on the registration screen to change registration status and check in attendees.
      */
     registrations?: {
         docs?: (string | EventRegistration)[];
@@ -4198,18 +4203,6 @@ interface EventOccurrence {
 interface EventRegistration {
     id: string;
     tenant?: (string | null) | Tenant;
-    /**
-     * Event this registration belongs to.
-     */
-    event: string | Event;
-    /**
-     * Occurrence this registration belongs to. Must belong to the same workspace as the event.
-     */
-    occurrence: string | EventOccurrence;
-    /**
-     * Linked customer for authenticated registrations. Guest registrations may leave this empty.
-     */
-    customer?: (string | null) | Customer;
     /**
      * Registration lifecycle status used for capacity accounting. Managed separately from attendance status.
      */
@@ -4222,6 +4215,18 @@ interface EventRegistration {
      * Number of attendees for this registration. Used for attendee and capacity calculations.
      */
     quantity?: number | null;
+    /**
+     * Event this registration belongs to.
+     */
+    event: string | Event;
+    /**
+     * Occurrence this registration belongs to. Must belong to the same workspace as the event.
+     */
+    occurrence: string | EventOccurrence;
+    /**
+     * Linked customer for authenticated registrations. Guest registrations may leave this empty.
+     */
+    customer?: (string | null) | Customer;
     /**
      * PII snapshot captured at registration time. Hidden from publishable-key reads and subject to retention cleanup.
      */
@@ -4231,7 +4236,7 @@ interface EventRegistration {
         phone?: string | null;
     };
     /**
-     * Internal attendee email PII. Duplicates the registration-time snapshot email for search/listing and is hidden from publishable-key reads.
+     * Attendee email captured at registration time; this is personal information (PII). Stored separately from attendee information for search and listing, and hidden from publishable-key reads.
      */
     attendeeEmail?: string | null;
     /**
@@ -4289,7 +4294,7 @@ interface EventRegistration {
      */
     guestTokenExpiresAt?: string | null;
     /**
-     * Retention deadline for attendee PII. Owned by retention cleanup, which may redact PII after this timestamp.
+     * Retention deadline for attendee personal information. Automated cleanup may delete personal information after this timestamp.
      */
     piiRetentionUntil?: string | null;
     /**
@@ -4304,7 +4309,7 @@ interface EventRegistration {
     deletedAt?: string | null;
 }
 /**
- * Manage admission types and pricing references per occurrence.
+ * Manage entry options and pricing references per occurrence.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "event-admission-types".
@@ -4315,7 +4320,7 @@ interface EventAdmissionType {
     tenant?: (string | null) | Tenant;
     label: string;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     event: string | Event;
@@ -4324,7 +4329,7 @@ interface EventAdmissionType {
      */
     occurrence?: (string | null) | EventOccurrence;
     /**
-     * Optional to save, but customer admission availability omits this type when the reference is missing, deleted, inactive, missing a product, or unpriced. Ecommerce owns the amount; only the reference is stored here.
+     * Optional to save. To sell, select an active product variant with a product and price. Manage the amount on the linked product variant.
      */
     priceReference?: (string | null) | ProductVariant;
     /**
@@ -4333,10 +4338,16 @@ interface EventAdmissionType {
     allowedCustomerGroups?: (string | CustomerGroup)[] | null;
     firstRestrictedAt?: string | null;
     /**
-     * Optional per-type ceiling per occurrence. Enforced at hold creation against this type's capacity-consuming hold quantity (held, bound, and confirmed).
+     * Optional maximum quantity for this admission type per occurrence. When reserving more quantity, the limit includes this type's held, checkout-linked, and confirmed quantities.
      */
     maxQuantityPerOccurrence?: number | null;
+    /**
+     * The sale window includes this time.
+     */
     validFrom?: string | null;
+    /**
+     * The sale window includes this end time.
+     */
     validUntil?: string | null;
     isActive?: boolean | null;
     updatedAt: string;
@@ -4479,6 +4490,7 @@ interface FulfillmentOrder {
     metadata?: {
         [k: string]: unknown;
     } | unknown[] | string | number | boolean | null;
+    method?: ('shipping' | 'pickup') | null;
     updatedAt: string;
     createdAt: string;
     deletedAt?: string | null;
@@ -4537,6 +4549,7 @@ interface Fulfillment {
     metadata?: {
         [k: string]: unknown;
     } | unknown[] | string | number | boolean | null;
+    method?: ('shipping' | 'pickup') | null;
     updatedAt: string;
     createdAt: string;
     deletedAt?: string | null;
@@ -4576,7 +4589,7 @@ interface Transaction {
     order?: (string | null) | Order;
     amount?: number | null;
     /**
-     * Payment method snapshot returned by the provider.
+     * Payment method at the time of payment, as reported by the payment provider.
      */
     paymentMethod?: string | null;
     /**
@@ -4640,7 +4653,7 @@ interface Transaction {
     deletedAt?: string | null;
 }
 /**
- * Order tags are flat labels for operational segmentation and filtering.
+ * Flat labels for order segmentation and filtering.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "order-tags".
@@ -4656,7 +4669,7 @@ interface OrderTag {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -4797,15 +4810,15 @@ interface WebhookEvent {
     id: string;
     tenant?: (string | null) | Tenant;
     /**
-     * New runtime rows require workspace or global. Null marks legacy/old-runtime evidence during expand and is treated as unresolved like unknown.
+     * New records must identify whether they belong to a workspace or the whole platform. Older records without an ownership value require review, like records marked Quarantined.
      */
     ownershipScope?: ('tenant' | 'global' | 'unknown') | null;
     /**
-     * Provider
+     * The service that sent the event (for example, toss or mux).
      */
     provider: string;
     /**
-     * Provider-supplied event ID. Used with provider as the idempotency key for duplicate prevention.
+     * The event ID supplied by the provider. The provider and event ID together prevent duplicate receipt (idempotency key).
      */
     eventId: string;
     receivedAt?: string | null;
@@ -5169,7 +5182,7 @@ interface TenantLogo {
      */
     alt?: string | null;
     /**
-     * Low quality image placeholder
+     * A low-resolution preview of the image.
      */
     lqip?: string | null;
     palette?: {
@@ -5263,7 +5276,7 @@ interface TenantEntitlement {
     tenant: string | Tenant;
     plan: 'free' | 'starter' | 'basic' | 'pro' | 'enterprise';
     /**
-     * Lifecycle status for the entitlement. Only active rows participate in current plan resolution.
+     * The entitlement’s current lifecycle status. Only active entitlements count toward the current plan.
      */
     status: 'active' | 'scheduled' | 'expired' | 'revoked';
     sourceType: 'project_free' | 'subscription' | 'manual' | 'support' | 'promo' | 'trial' | 'enterprise_contract';
@@ -5274,7 +5287,7 @@ interface TenantEntitlement {
     priority: number;
     startsAt: string;
     /**
-     * Entitlement end date. Hook validation requires it for promo / trial sources.
+     * The date the entitlement expires. Required for promotion and trial entitlements, enforced by hook validation.
      */
     endsAt?: string | null;
     reason?: string | null;
@@ -5294,7 +5307,7 @@ interface TenantEntitlement {
 interface Subscription {
     id: string;
     /**
-     * Project billing scope. The existing Live workspace relation remains the compatibility and evidence anchor.
+     * Billing is scoped to the project. The existing Live workspace link is retained for billing compatibility and historical evidence.
      */
     project?: (string | null) | Project;
     tenant: string | Tenant;
@@ -5389,7 +5402,13 @@ interface UsageRateCard {
     notes?: string | null;
     status: 'draft' | 'active' | 'archived';
     currency: 'KRW';
+    /**
+     * Start of the new-registration window (inclusive).
+     */
     effectiveFrom: string;
+    /**
+     * New registration is unavailable from this time.
+     */
     effectiveTo?: string | null;
     /**
      * Base usage fee (KRW)
@@ -5624,7 +5643,7 @@ interface ApiUsage {
         [k: string]: unknown;
     } | unknown[] | string | number | boolean | null;
     /**
-     * Timestamp when the usage snapshot cron calculated this monthly aggregate.
+     * When the scheduled usage aggregation (cron) calculated usage for this month.
      */
     snapshottedAt?: string | null;
     updatedAt: string;
@@ -5771,28 +5790,28 @@ interface Refund {
     status: 'succeeded' | 'failed';
     source: 'return' | 'cancel' | 'operator' | 'adjustment';
     /**
-     * Amount in KRW (won)
+     * Minor-unit amount in the refund ledger currency
      */
     totalAmount: number;
     fundingCheckout?: (string | null) | Checkout;
     /**
-     * Amount in KRW (won)
+     * Minor-unit amount in the refund ledger currency
      */
     creditAmount?: number | null;
     /**
-     * Amount in KRW (won)
+     * Minor-unit amount in the refund ledger currency
      */
     providerAmount?: number | null;
     /**
-     * Amount in KRW (won)
+     * Minor-unit amount in the refund ledger currency
      */
     lineAmount?: number | null;
     /**
-     * Amount in KRW (won)
+     * Minor-unit amount in the refund ledger currency
      */
     shippingAmount?: number | null;
     /**
-     * Amount in KRW (won)
+     * Minor-unit amount in the refund ledger currency
      */
     adjustmentAmount?: number | null;
     currency?: string | null;
@@ -5819,12 +5838,12 @@ interface RefundLineItem {
     lineType: 'item' | 'shipping' | 'adjustment';
     quantity?: number | null;
     /**
-     * Amount in KRW (won)
+     * Minor-unit amount in the parent refund currency
      */
     amount: number;
     restockAction?: ('return_to_stock' | 'discard' | 'no_restock') | null;
     /**
-     * Amount in KRW (won)
+     * Minor-unit amount in the parent refund currency
      */
     restockingFee?: number | null;
     metadata?: {
@@ -6357,11 +6376,11 @@ interface InventoryReservation {
     order?: (string | null) | Order;
     orderItem?: (string | null) | OrderItem;
     /**
-     * Checkout that owns this pre-payment hold. Re-linked to an order at placement.
+     * Checkout for this pre-payment inventory reservation. When the order is placed, the reservation is linked to that order.
      */
     checkout?: (string | null) | Checkout;
     /**
-     * Checkout line item for this pre-payment hold. Re-linked to an order item at placement.
+     * Checkout item for this pre-payment inventory reservation. When the order is placed, the reservation is linked to that order item.
      */
     checkoutItem?: (string | null) | CheckoutItem;
     variant: string | ProductVariant;
@@ -6375,7 +6394,7 @@ interface InventoryReservation {
      */
     statusChangedAt?: string | null;
     /**
-     * When a pending pre-payment hold expires and is auto-released. Empty for held/released/consumed rows.
+     * When a reservation in the Pending state expires and is automatically released. Not recorded for other states.
      */
     expiresAt?: string | null;
     updatedAt: string;
@@ -6432,7 +6451,7 @@ interface OrderExportProfile {
         [k: string]: unknown;
     } | unknown[] | string | number | boolean | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -6528,7 +6547,7 @@ interface TenantCommerceConfig {
     deletedAt?: string | null;
 }
 /**
- * Review customer consent records for terms and privacy policy.
+ * Server-recorded terms and privacy policy consent history from hosted signup and reconsent. Consent collected during direct signup is not included.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "customer-consent-receipts".
@@ -6629,7 +6648,7 @@ interface CustomerProfileList {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     isActive?: boolean | null;
@@ -6724,7 +6743,7 @@ interface DraftOrder {
      */
     market?: (string | null) | Market;
     /**
-     * Snapshot of the last calculate() result.
+     * Amounts saved from the last calculation.
      */
     computedTotals?: {
         subtotal?: number | null;
@@ -6797,7 +6816,7 @@ interface DraftOrderItem {
     createdAt: string;
 }
 /**
- * Manage single-use benefit voucher definitions and validity periods for customers.
+ * Define single-use redemption coupons and validity periods. Issue them to customers through a server integration; staff redeem them without an order in Customer detail.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "benefit-voucher-definitions".
@@ -6813,7 +6832,7 @@ interface BenefitVoucherDefinition {
     createdAt: string;
 }
 /**
- * Manage publishable articles, authors, and classification.
+ * Manage publishable writing, authors, and classification.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "articles".
@@ -6828,7 +6847,7 @@ interface Article {
      */
     subtitle?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     content?: {
@@ -6924,7 +6943,7 @@ interface Article {
     deletedAt?: string | null;
 }
 /**
- * Manage article author profiles and display details.
+ * Manage contributor profiles and display details.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "article-authors".
@@ -6973,7 +6992,7 @@ interface ArticleCategory {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -7007,7 +7026,7 @@ interface ArticleTag {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -7023,7 +7042,7 @@ interface ArticleTag {
     deletedAt?: string | null;
 }
 /**
- * Manage document-based content and publishing status.
+ * Manage structured content and publishing status.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "documents".
@@ -7038,7 +7057,7 @@ interface Document {
      */
     subtitle?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     content?: {
@@ -7162,7 +7181,7 @@ interface DocumentCategory {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -7182,7 +7201,7 @@ interface DocumentCategory {
     deletedAt?: string | null;
 }
 /**
- * Manage document types used for classification.
+ * Manage content formats used for classification.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "document-types".
@@ -7198,7 +7217,7 @@ interface DocumentType {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -7229,7 +7248,7 @@ interface Playlist {
      */
     subtitle?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     categories?: (string | PlaylistCategory)[] | null;
@@ -7301,7 +7320,7 @@ interface PlaylistCategory {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -7335,7 +7354,7 @@ interface PlaylistTag {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -7351,7 +7370,7 @@ interface PlaylistTag {
     deletedAt?: string | null;
 }
 /**
- * Manage audio tracks and metadata used in playlists.
+ * Manage audio recordings and metadata used in playlists.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "tracks".
@@ -7362,7 +7381,7 @@ interface Track {
     tenant?: (string | null) | Tenant;
     title?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     artist?: string | null;
@@ -7416,7 +7435,7 @@ interface TrackCategory {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -7450,7 +7469,7 @@ interface TrackTag {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -7492,7 +7511,7 @@ interface TrackAsset {
     focalY?: number | null;
 }
 /**
- * Manage image galleries and display order.
+ * Manage image groupings and display order.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "galleries".
@@ -7507,7 +7526,7 @@ interface Gallery {
      */
     subtitle?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -7585,7 +7604,7 @@ interface GalleryCategory {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -7619,7 +7638,7 @@ interface GalleryTag {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -7646,7 +7665,7 @@ interface GalleryItem {
     gallery: string | Gallery;
     title?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     status?: ('draft' | 'published' | 'archived') | null;
@@ -7676,7 +7695,7 @@ interface GalleryItem {
     deletedAt?: string | null;
 }
 /**
- * Manage external links and related metadata.
+ * Manage external addresses and related metadata.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "links".
@@ -7692,7 +7711,7 @@ interface Link {
     subtitle?: string | null;
     url: string;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     categories?: (string | LinkCategory)[] | null;
@@ -7745,7 +7764,7 @@ interface LinkCategory {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -7779,7 +7798,7 @@ interface LinkTag {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -7795,7 +7814,7 @@ interface LinkTag {
     deletedAt?: string | null;
 }
 /**
- * Manage visual canvases and publishing status.
+ * Manage visual work surfaces and publishing status.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "canvases".
@@ -7809,7 +7828,7 @@ interface Canvase {
      */
     subtitle?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -7885,7 +7904,7 @@ interface CanvasCategory {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -7919,7 +7938,7 @@ interface CanvasTag {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -7951,7 +7970,7 @@ interface CanvasNodeType {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -8022,7 +8041,7 @@ interface CanvasEdgeType {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -8117,7 +8136,7 @@ interface CanvasEdge {
     deletedAt?: string | null;
 }
 /**
- * Manage community posts, visibility, and review status.
+ * Manage community contributions, visibility, and review status.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "posts".
@@ -8189,12 +8208,12 @@ interface Post {
      */
     isPinned?: boolean | null;
     /**
-     * Author/operator discussion toggle. When false, new comments are blocked.
+     * Author/operator discussion toggle. When disabled, new comments are blocked.
      */
     allowsComments?: boolean | null;
     visibility?: ('visible' | 'hidden') | null;
     /**
-     * Moderator lock. When true, new comments are blocked regardless of allowsComments.
+     * Moderator lock. When enabled, new comments are blocked regardless of the Allow comments setting.
      */
     isLocked?: boolean | null;
     editedAt?: string | null;
@@ -8228,7 +8247,7 @@ interface PostCategory {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -8248,7 +8267,7 @@ interface PostCategory {
     deletedAt?: string | null;
 }
 /**
- * Post tags are flat labels for search and loose topic grouping.
+ * Flat labels for post search and loose topic grouping.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "post-tags".
@@ -8264,7 +8283,7 @@ interface PostTag {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     /**
@@ -8346,7 +8365,7 @@ interface Reaction {
     createdAt: string;
 }
 /**
- * Configure reaction types available in community interactions.
+ * Configure available ways to respond in community interactions.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "reaction-types".
@@ -8442,7 +8461,7 @@ interface CommunityBan {
     createdAt: string;
 }
 /**
- * Manage event calendar display settings and defaults.
+ * Manage display settings and operational defaults.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "event-calendars".
@@ -8456,7 +8475,7 @@ interface EventCalendar {
      */
     subtitle?: string | null;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     content?: {
@@ -8475,7 +8494,7 @@ interface EventCalendar {
         [k: string]: unknown;
     } | null;
     /**
-     * Default listing behavior for the public event calendar.
+     * Default behavior for public listings.
      */
     publicListing?: {
         /**
@@ -8526,7 +8545,7 @@ interface EventCalendar {
     slug?: string | null;
     status?: ('draft' | 'published' | 'archived') | null;
     /**
-     * Default IANA time zone for this calendar.
+     * Default time zone for new events. Existing events keep their saved time zone.
      */
     timezone?: string | null;
     /**
@@ -8534,7 +8553,7 @@ interface EventCalendar {
      */
     color?: string | null;
     /**
-     * Visibility for the workspace-global calendar.
+     * Visibility applied across the workspace.
      */
     visibility?: ('public' | 'unlisted' | 'private') | null;
     publishedAt?: string | null;
@@ -8561,7 +8580,7 @@ interface EventTicketPurchasePrice {
     deletedAt?: string | null;
 }
 /**
- * Manage paid membership plans and benefit groups.
+ * Manage paid enrollment offerings and benefit groups.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "membership-plans".
@@ -8580,7 +8599,7 @@ interface MembershipPlan {
     generateSlug?: boolean | null;
     slug?: string | null;
     /**
-     * Internal note for operators; not shown to customers.
+     * Included in public query responses for active plans. Do not enter internal notes that must not be shared with customers.
      */
     description?: string | null;
     /**
@@ -8600,7 +8619,7 @@ interface MembershipPlan {
      */
     memberGroup: string | CustomerGroup;
     /**
-     * Billing-cycle and amount options for this plan. Add and edit prices directly here and drag to reorder them. A plan with no active price is not shown at signup.
+     * Billing-cycle and amount options for this plan. Add and edit prices directly here and drag to reorder them. New subscriptions to this plan require an active price.
      */
     prices?: {
         docs?: (string | MembershipPlanPrice)[];
@@ -8639,7 +8658,7 @@ interface MembershipPlanPrice {
     currency: 'KRW' | 'USD' | 'EUR' | 'JPY';
     billingInterval: 'month' | 'year';
     /**
-     * e.g. quarterly = month × 3
+     * For example, a monthly billing interval with a count of 3 bills every 3 months.
      */
     intervalCount: number;
     isActive?: boolean | null;
@@ -8677,7 +8696,7 @@ interface CustomerPaymentMethod {
     deletedAt?: string | null;
 }
 /**
- * Review customer membership status and renewal schedules.
+ * Review enrollment status and renewal schedules.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "customer-memberships".
@@ -8703,19 +8722,19 @@ interface CustomerMembership {
     billingInterval: 'month' | 'year';
     intervalCount: number;
     /**
-     * Trial-day snapshot captured when the subscribe intent is created
+     * Free trial days saved when the subscription request was created.
      */
     trialDaysSnapshot?: number | null;
     /**
-     * Immutable original period start for the subscribe intent
+     * Start time of the period set by the original subscription request; it cannot be changed.
      */
     subscribePeriodStart?: string | null;
     /**
-     * Immutable original period end for the subscribe intent
+     * End time of the period set by the original subscription request; it cannot be changed.
      */
     subscribePeriodEnd?: string | null;
     /**
-     * Immutable SHA-256 digest of historical paid-admission recovery basis
+     * Fingerprint of the historical paid-subscription recovery basis; it cannot be changed.
      */
     historicalPaidRecoveryEvidence?: string | null;
     currentPeriodStart?: string | null;
@@ -8748,7 +8767,7 @@ interface CustomerMembership {
     deletedAt?: string | null;
 }
 /**
- * Review evidence for paid results that were not applied to a membership.
+ * Records of successful payment results that were not applied to membership activation or renewal at the time.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "membership-unapplied-paid-evidence".
@@ -8798,6 +8817,8 @@ interface MembershipCharge {
     createdAt: string;
 }
 /**
+ * Manage the membership delegated billing connection and charge URL.
+ *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "tenant-payment-credentials".
  */
@@ -8858,7 +8879,7 @@ interface DirectUploadSession {
     createdAt: string;
 }
 /**
- * Manage form structure and publishing status.
+ * Manage input structure and publishing status.
  *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "forms".
@@ -8869,7 +8890,7 @@ interface Form {
     tenant?: (string | null) | Tenant;
     title: string;
     /**
-     * Short summary for listing/cards
+     * Short summary
      */
     description?: string | null;
     isActive?: boolean | null;
@@ -10792,6 +10813,7 @@ interface OrderStagedChangesSelect<T extends boolean = true> {
  */
 interface PaymentSessionsSelect<T extends boolean = true> {
     tenant?: T;
+    standardLongTailAlertedAt?: T;
     finalizationAlertedAt?: T;
     status?: T;
     providerStatus?: T;
@@ -11284,6 +11306,7 @@ interface FulfillmentOrdersSelect<T extends boolean = true> {
     items?: T;
     adminNotes?: T;
     metadata?: T;
+    method?: T;
     updatedAt?: T;
     createdAt?: T;
     deletedAt?: T;
@@ -11320,6 +11343,7 @@ interface FulfillmentsSelect<T extends boolean = true> {
     items?: T;
     adminNotes?: T;
     metadata?: T;
+    method?: T;
     updatedAt?: T;
     createdAt?: T;
     deletedAt?: T;
@@ -11962,6 +11986,7 @@ interface CheckoutsSelect<T extends boolean = true> {
         deliveryMessage?: T;
     };
     deliveryMethod?: T;
+    source?: T;
     items?: T;
     activePaymentSession?: T;
     currency?: T;
@@ -13450,12 +13475,12 @@ interface EventOccurrencesSelect<T extends boolean = true> {
  */
 interface EventRegistrationsSelect<T extends boolean = true> {
     tenant?: T;
-    event?: T;
-    occurrence?: T;
-    customer?: T;
     registrationStatus?: T;
     attendanceStatus?: T;
     quantity?: T;
+    event?: T;
+    occurrence?: T;
+    customer?: T;
     attendeeSnapshot?: T | {
         name?: T;
         email?: T;