@01.software/sdk 0.26.0 → 0.28.0

package/dist/{payload-types-BF8VVFt6.d.cts → payload-types-BrSYb-sh.d.cts}

@@ -47,11 +47,13 @@ interface Config {
         'order-items': OrderItem;
         transactions: Transaction;
         'order-status-logs': OrderStatusLog;
+        'inventory-reservations': InventoryReservation;
         fulfillments: Fulfillment;
         'fulfillment-items': FulfillmentItem;
         returns: Return;
         'return-items': ReturnItem;
         'shipping-policies': ShippingPolicy;
+        'shipping-zones': ShippingZone;
         customers: Customer;
         'customer-profiles': CustomerProfile;
         'customer-profile-lists': CustomerProfileList;
@@ -60,7 +62,6 @@ interface Config {
         carts: Cart;
         'cart-items': CartItem;
         discounts: Discount;
-        promotions: Promotion;
         articles: Article;
         'article-authors': ArticleAuthor;
         'article-categories': ArticleCategory;
@@ -160,6 +161,13 @@ interface Config {
         posts: {
             comments: 'comments';
         };
+        events: {
+            occurrences: 'event-occurrences';
+            registrations: 'event-registrations';
+        };
+        'event-occurrences': {
+            registrations: 'event-registrations';
+        };
         'payload-folders': {
             documentsAndFolders: 'payload-folders' | 'images' | 'system-media';
         };
@@ -202,11 +210,13 @@ interface Config {
         'order-items': OrderItemsSelect<false> | OrderItemsSelect<true>;
         transactions: TransactionsSelect<false> | TransactionsSelect<true>;
         'order-status-logs': OrderStatusLogsSelect<false> | OrderStatusLogsSelect<true>;
+        'inventory-reservations': InventoryReservationsSelect<false> | InventoryReservationsSelect<true>;
         fulfillments: FulfillmentsSelect<false> | FulfillmentsSelect<true>;
         'fulfillment-items': FulfillmentItemsSelect<false> | FulfillmentItemsSelect<true>;
         returns: ReturnsSelect<false> | ReturnsSelect<true>;
         'return-items': ReturnItemsSelect<false> | ReturnItemsSelect<true>;
         'shipping-policies': ShippingPoliciesSelect<false> | ShippingPoliciesSelect<true>;
+        'shipping-zones': ShippingZonesSelect<false> | ShippingZonesSelect<true>;
         customers: CustomersSelect<false> | CustomersSelect<true>;
         'customer-profiles': CustomerProfilesSelect<false> | CustomerProfilesSelect<true>;
         'customer-profile-lists': CustomerProfileListsSelect<false> | CustomerProfileListsSelect<true>;
@@ -215,7 +225,6 @@ interface Config {
         carts: CartsSelect<false> | CartsSelect<true>;
         'cart-items': CartItemsSelect<false> | CartItemsSelect<true>;
         discounts: DiscountsSelect<false> | DiscountsSelect<true>;
-        promotions: PromotionsSelect<false> | PromotionsSelect<true>;
         articles: ArticlesSelect<false> | ArticlesSelect<true>;
         'article-authors': ArticleAuthorsSelect<false> | ArticleAuthorsSelect<true>;
         'article-categories': ArticleCategoriesSelect<false> | ArticleCategoriesSelect<true>;
@@ -961,7 +970,7 @@ interface Webhook {
         /**
          * Receives create/update events for this collection.
          */
-        collection: 'tenant-metadata' | 'tenant-logos' | 'images' | 'products' | 'product-variants' | 'product-options' | 'product-option-values' | 'product-categories' | 'product-tags' | 'product-collections' | 'brands' | 'brand-logos' | 'orders' | 'order-items' | 'transactions' | 'fulfillments' | 'fulfillment-items' | 'returns' | 'return-items' | 'carts' | 'cart-items' | 'discounts' | 'promotions' | 'shipping-policies' | 'customers' | 'customer-profiles' | 'customer-addresses' | 'playlists' | 'playlist-categories' | 'playlist-tags' | 'tracks' | 'track-categories' | 'track-tags' | 'galleries' | 'gallery-items' | 'gallery-categories' | 'gallery-tags' | 'links' | 'link-categories' | 'link-tags' | 'forms' | 'form-submissions' | 'articles' | 'article-authors' | 'article-categories' | 'article-tags' | 'documents' | 'document-categories' | 'document-types' | 'canvases' | 'canvas-node-types' | 'canvas-edge-types' | 'canvas-categories' | 'canvas-tags' | 'canvas-nodes' | 'canvas-edges' | 'videos' | 'video-categories' | 'video-tags' | 'live-streams' | 'posts' | 'comments' | 'reactions' | 'reaction-types' | 'bookmarks' | 'post-categories' | 'customer-profile-lists' | 'reports' | 'community-bans' | 'event-calendars' | 'events' | 'event-categories' | 'event-occurrences' | 'event-tags';
+        collection: 'tenant-metadata' | 'tenant-logos' | 'images' | 'products' | 'product-variants' | 'product-options' | 'product-option-values' | 'product-categories' | 'product-tags' | 'product-collections' | 'brands' | 'brand-logos' | 'orders' | 'order-items' | 'transactions' | 'fulfillments' | 'fulfillment-items' | 'returns' | 'return-items' | 'carts' | 'cart-items' | 'discounts' | 'shipping-policies' | 'shipping-zones' | 'customers' | 'customer-profiles' | 'customer-addresses' | 'playlists' | 'playlist-categories' | 'playlist-tags' | 'tracks' | 'track-categories' | 'track-tags' | 'galleries' | 'gallery-items' | 'gallery-categories' | 'gallery-tags' | 'links' | 'link-categories' | 'link-tags' | 'forms' | 'form-submissions' | 'articles' | 'article-authors' | 'article-categories' | 'article-tags' | 'documents' | 'document-categories' | 'document-types' | 'canvases' | 'canvas-node-types' | 'canvas-edge-types' | 'canvas-categories' | 'canvas-tags' | 'canvas-nodes' | 'canvas-edges' | 'videos' | 'video-categories' | 'video-tags' | 'live-streams' | 'posts' | 'comments' | 'reactions' | 'reaction-types' | 'bookmarks' | 'post-categories' | 'customer-profile-lists' | 'event-calendars' | 'events' | 'event-categories' | 'event-occurrences' | 'event-tags';
         id?: string | null;
     }[] | null;
     isActive?: boolean | null;
@@ -1646,7 +1655,7 @@ interface Product {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * Secondary display line shown in cards, listings, and detail headers.
      */
@@ -1714,13 +1723,37 @@ interface Product {
      * Derived listing projection for product cards and search
      */
     listing?: {
+        /**
+         * Variant prioritized for product cards. Automatically derived from sellable variants, active variants, and sort order.
+         */
         selectionHintVariant?: (string | null) | ProductVariant;
+        /**
+         * Primary image for product cards/search. Product media is preferred, then variant media is used as fallback.
+         */
         primaryImage?: (string | null) | Image;
+        /**
+         * Lowest active variant price. Automatically recalculated when variants change.
+         */
         minPrice?: number | null;
+        /**
+         * Highest active variant price. Automatically recalculated when variants change.
+         */
         maxPrice?: number | null;
+        /**
+         * Lowest compare-at price across active variants. Automatically recalculated when variants change.
+         */
         minCompareAtPrice?: number | null;
+        /**
+         * Highest compare-at price across active variants. Automatically recalculated when variants change.
+         */
         maxCompareAtPrice?: number | null;
+        /**
+         * Automatically enabled when the minimum and maximum active variant prices differ.
+         */
         isPriceRange?: boolean | null;
+        /**
+         * Automatically enabled when at least one active variant is sellable.
+         */
         availableForSale?: boolean | null;
     };
     metadata?: {
@@ -1785,7 +1818,7 @@ interface Product {
 interface Video {
     id: string;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * Secondary display line shown in cards, listings, and detail headers.
      */
@@ -1892,7 +1925,7 @@ interface Video {
 interface LiveStream {
     id: string;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * Secondary display line shown in cards, listings, and detail headers.
      */
@@ -1985,7 +2018,7 @@ interface VideoCategory {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -2010,7 +2043,7 @@ interface VideoTag {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -2036,7 +2069,13 @@ interface ProductVariant {
     '_product-variants_variants_order'?: string | null;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
+    /**
+     * Parent product for this variant. It cannot be moved to another product after creation.
+     */
     product: string | Product;
+    /**
+     * Optional variant display label. The option value combination remains the canonical variant identity.
+     */
     title?: string | null;
     thumbnail?: (string | null) | Image;
     images?: (string | Image)[] | null;
@@ -2056,6 +2095,9 @@ interface ProductVariant {
      * Sell without tracking inventory
      */
     isUnlimited?: boolean | null;
+    /**
+     * Tracked inventory. Available quantity is stock - reservedStock; isUnlimited bypasses stock tracking.
+     */
     stock?: number | null;
     /**
      * Paid orders in transit (available quantity is stock - reservedStock)
@@ -2069,6 +2111,9 @@ interface ProductVariant {
      * Variant-specific weight (g)
      */
     weight?: number | null;
+    /**
+     * Enable for physical variants that require shipping.
+     */
     requiresShipping?: boolean | null;
     /**
      * External system ID
@@ -2096,6 +2141,9 @@ interface ProductOptionValue {
     '_product-option-values_values_order'?: string | null;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
+    /**
+     * Parent option for this value. It cannot be moved to another option after creation.
+     */
     option: string | ProductOption;
     /**
      * Display label (e.g. Black, S)
@@ -2128,6 +2176,9 @@ interface ProductOption {
     '_product-options_options_order'?: string | null;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
+    /**
+     * Parent product for this option. It cannot be moved to another product after creation.
+     */
     product: string | Product;
     /**
      * Option name (e.g. Color, Size)
@@ -2150,7 +2201,7 @@ interface ProductCategory {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -2175,7 +2226,7 @@ interface ProductTag {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -2389,7 +2440,7 @@ interface ShippingPolicy {
     /**
      * e.g. Standard shipping, Large items
      */
-    title: string;
+    title?: string | null;
     /**
      * Amount in KRW (won)
      */
@@ -2436,7 +2487,7 @@ interface ProductCollection {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * Secondary display line shown in cards, listings, and detail headers.
      */
@@ -2760,7 +2811,7 @@ interface CustomerGroup {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -2926,6 +2977,12 @@ interface OrderItem {
      */
     totalPrice: number;
     productTitle?: string | null;
+    /**
+     * Option combination snapshot at order time. Later variant/option changes do not rewrite it.
+     */
+    optionSelection?: {
+        [k: string]: unknown;
+    } | unknown[] | string | number | boolean | null;
     /**
      * Tax rate at time of order (%)
      */
@@ -2934,6 +2991,18 @@ interface OrderItem {
      * Currency at time of order (ISO-4217)
      */
     currency?: string | null;
+    /**
+     * Snapshot of the discount amount allocated to this line at order time (minor units).
+     */
+    discountAllocation?: number | null;
+    /**
+     * Per-unit price snapshot after discount allocation. round(discountedTotalPrice / quantity).
+     */
+    discountedUnitPrice?: number | null;
+    /**
+     * Line total snapshot after discount allocation at order time (totalPrice - discountAllocation).
+     */
+    discountedTotalPrice?: number | null;
     updatedAt: string;
     createdAt: string;
     deletedAt?: string | null;
@@ -2962,6 +3031,12 @@ interface Transaction {
     receiptUrl?: string | null;
     pgPaymentId?: string | null;
     pgOrderId?: string | null;
+    providerEventId?: string | null;
+    providerStatus?: string | null;
+    confirmedAmount?: number | null;
+    confirmedCurrency?: string | null;
+    confirmedAt?: string | null;
+    confirmationSource?: ('provider_webhook' | 'provider_lookup' | 'provider_api_confirm' | 'manual_server') | null;
     cashReceipt?: {
         issuanceType?: ('none' | 'personal' | 'business') | null;
         /**
@@ -3089,6 +3164,14 @@ interface Return {
      */
     refundReceiptUrl?: string | null;
     refundAmount: number;
+    /**
+     * Return shipping fee deducted from refundAmount
+     */
+    returnShippingFee?: number | null;
+    /**
+     * Exchange balance (positive: extra charge, negative: extra refund)
+     */
+    exchangeDifference?: number | null;
     metadata?: {
         [k: string]: unknown;
     } | unknown[] | string | number | boolean | null;
@@ -3111,6 +3194,10 @@ interface ReturnItem {
     variant?: (string | null) | ProductVariant;
     quantity: number;
     restockAction: 'return_to_stock' | 'discard';
+    /**
+     * Restocking fee for this line (deducted from line refund)
+     */
+    restockingFee?: number | null;
     productTitle?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -3137,6 +3224,58 @@ interface OrderStatusLog {
     updatedAt: string;
     createdAt: string;
 }
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "inventory-reservations".
+ */
+interface InventoryReservation {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    order: string | Order;
+    orderItem: string | OrderItem;
+    variant: string | ProductVariant;
+    quantity: number;
+    status: 'held' | 'released' | 'consumed';
+    statusChangedAt?: string | null;
+    updatedAt: string;
+    createdAt: string;
+    deletedAt?: string | null;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "shipping-zones".
+ */
+interface ShippingZone {
+    id: string;
+    _order?: string | null;
+    tenant?: (string | null) | Tenant;
+    /**
+     * Display name (e.g. Jeju, Remote Islands) for operator reference
+     */
+    title?: string | null;
+    /**
+     * kind=jeju|remote-islands routes surcharge through shipping-policies fields; kind=custom uses this zone's extraAmount.
+     */
+    kind: 'jeju' | 'remote-islands' | 'custom';
+    postalCodePatterns: {
+        /**
+         * Postal code prefix (e.g. 230, 525) or numeric range (e.g. 63000-63644)
+         */
+        pattern: string;
+        id?: string | null;
+    }[];
+    /**
+     * Surcharge applied when kind=custom. Ignored for jeju and remote-islands (those route through shipping-policies).
+     */
+    extraAmount?: number | null;
+    isActive?: boolean | null;
+    metadata?: {
+        [k: string]: unknown;
+    } | unknown[] | string | number | boolean | null;
+    updatedAt: string;
+    createdAt: string;
+    deletedAt?: string | null;
+}
 /**
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "customer-profile-lists".
@@ -3145,7 +3284,7 @@ interface CustomerProfileList {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -3248,6 +3387,18 @@ interface CartItem {
      * Price at the time of adding to cart
      */
     unitPrice: number;
+    /**
+     * Minor-unit discount allocated to this line from the header discount. Populated by recalculateCartTotals.
+     */
+    discountAllocation?: number | null;
+    /**
+     * Per-unit price after discount allocation (display). round(discountedTotalPrice / quantity).
+     */
+    discountedUnitPrice?: number | null;
+    /**
+     * Line total after discount allocation (totalPrice - discountAllocation). Populated by recalculateCartTotals.
+     */
+    discountedTotalPrice?: number | null;
     metadata?: {
         [k: string]: unknown;
     } | unknown[] | string | number | boolean | null;
@@ -3348,29 +3499,6 @@ interface Discount {
     createdAt: string;
     deletedAt?: string | null;
 }
-/**
- * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "promotions".
- */
-interface Promotion {
-    id: string;
-    tenant?: (string | null) | Tenant;
-    /**
-     * Promotion code
-     */
-    code: string;
-    discountType: 'percent' | 'fixed' | 'free-shipping';
-    /**
-     * Discount value (percent: 0-100, fixed: minor unit)
-     */
-    discountValue?: number | null;
-    validFrom?: string | null;
-    validUntil?: string | null;
-    status: 'draft' | 'active' | 'paused' | 'expired';
-    updatedAt: string;
-    createdAt: string;
-    deletedAt?: string | null;
-}
 /**
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "articles".
@@ -3379,7 +3507,7 @@ interface Article {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * Secondary display line shown in cards, listings, and detail headers.
      */
@@ -3522,7 +3650,7 @@ interface ArticleCategory {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -3547,7 +3675,7 @@ interface ArticleTag {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -3572,7 +3700,7 @@ interface Document {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * Secondary display line shown in cards, listings, and detail headers.
      */
@@ -3692,7 +3820,7 @@ interface DocumentCategory {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -3717,7 +3845,7 @@ interface DocumentType {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -3741,7 +3869,7 @@ interface Playlist {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * Secondary display line shown in cards, listings, and detail headers.
      */
@@ -3750,7 +3878,6 @@ interface Playlist {
      * Short summary for listing/cards
      */
     description?: string | null;
-    videos?: (string | Video)[] | null;
     categories?: (string | PlaylistCategory)[] | null;
     tags?: (string | PlaylistTag)[] | null;
     /**
@@ -3790,8 +3917,6 @@ interface Playlist {
         };
     };
     thumbnail?: (string | null) | Image;
-    coverArt?: (string | null) | Image;
-    isCollaborative?: boolean | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -3815,7 +3940,7 @@ interface PlaylistCategory {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -3840,7 +3965,7 @@ interface PlaylistTag {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -3865,26 +3990,11 @@ interface Track {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * Short summary for listing/cards
      */
     description?: string | null;
-    content?: {
-        root: {
-            type: string;
-            children: {
-                type: any;
-                version: number;
-                [k: string]: unknown;
-            }[];
-            direction: ('ltr' | 'rtl') | null;
-            format: 'left' | 'start' | 'center' | 'right' | 'end' | 'justify' | '';
-            indent: number;
-            version: number;
-        };
-        [k: string]: unknown;
-    } | null;
     artist?: string | null;
     album?: string | null;
     releaseDate?: string | null;
@@ -3898,13 +4008,10 @@ interface Track {
     slug?: string | null;
     thumbnail?: (string | null) | Image;
     status?: ('draft' | 'published' | 'archived') | null;
-    isFeatured?: boolean | null;
-    publishedAt?: string | null;
     /**
      * Duration in seconds
      */
     durationSeconds?: number | null;
-    isEmbeddable?: boolean | null;
     metadata?: {
         [k: string]: unknown;
     } | unknown[] | string | number | boolean | null;
@@ -3932,7 +4039,7 @@ interface TrackCategory {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -3957,7 +4064,7 @@ interface TrackTag {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -4007,7 +4114,7 @@ interface Gallery {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * Secondary display line shown in cards, listings, and detail headers.
      */
@@ -4084,7 +4191,7 @@ interface GalleryCategory {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -4109,7 +4216,7 @@ interface GalleryTag {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -4173,7 +4280,7 @@ interface Link {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * Secondary display line shown in cards, listings, and detail headers.
      */
@@ -4235,7 +4342,7 @@ interface LinkCategory {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -4260,7 +4367,7 @@ interface LinkTag {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -4284,7 +4391,7 @@ interface LinkTag {
 interface Canvase {
     id: string;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * Secondary display line shown in cards, listings, and detail headers.
      */
@@ -4355,7 +4462,7 @@ interface CanvasCategory {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -4380,7 +4487,7 @@ interface CanvasTag {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -4405,7 +4512,7 @@ interface CanvasNodeType {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -4470,7 +4577,7 @@ interface CanvasEdgeType {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -4667,7 +4774,7 @@ interface PostCategory {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -4758,7 +4865,7 @@ interface ReactionType {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -4852,7 +4959,7 @@ interface EventCalendar {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * Secondary display line shown in cards, listings, and detail headers.
      */
@@ -4876,8 +4983,17 @@ interface EventCalendar {
         };
         [k: string]: unknown;
     } | null;
+    /**
+     * Default listing behavior for the public event calendar.
+     */
     publicListing?: {
+        /**
+         * Controls whether public listings include past occurrences.
+         */
         showPastOccurrences?: boolean | null;
+        /**
+         * Default number of future months shown in public listings.
+         */
         defaultRangeMonths?: number | null;
     };
     seo?: {
@@ -4918,9 +5034,15 @@ interface EventCalendar {
     generateSlug?: boolean | null;
     slug?: string | null;
     status?: ('draft' | 'published' | 'archived') | null;
-    timezone: string;
+    /**
+     * Default IANA time zone for this calendar.
+     */
+    timezone?: string | null;
     color?: string | null;
-    visibility: 'public' | 'unlisted' | 'members' | 'private';
+    /**
+     * Visibility for the tenant-global calendar.
+     */
+    visibility?: ('public' | 'unlisted' | 'private') | null;
     publishedAt?: string | null;
     metadata?: {
         [k: string]: unknown;
@@ -4937,7 +5059,7 @@ interface Event {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * Secondary display line shown in cards, listings, and detail headers.
      */
@@ -4967,15 +5089,30 @@ interface Event {
      * Products shown with this event. Available only when the Event commerce recipe is active for the tenant.
      */
     products?: (string | Product)[] | null;
+    /**
+     * Organizer display details. Linked users must belong to the same workspace.
+     */
     organizer?: {
         name?: string | null;
         url?: string | null;
         user?: (string | null) | User;
     };
+    /**
+     * Primary start time. For recurring events, this is the first occurrence anchor.
+     */
     startsAt: string;
+    /**
+     * Primary end time. Must be after the start time.
+     */
     endsAt: string;
-    timezone: string;
+    /**
+     * IANA time zone used to expand recurring occurrences.
+     */
+    timezone?: string | null;
     isAllDay?: boolean | null;
+    /**
+     * Optional. Leave empty for a one-time event.
+     */
     recurrence?: {
         /**
          * RFC 5545 RRULE string
@@ -4989,8 +5126,14 @@ interface Event {
             date?: string | null;
             id?: string | null;
         }[] | null;
+        /**
+         * Number of future months to materialize. Allowed range is 1-12.
+         */
         materializationMonths?: number | null;
     };
+    /**
+     * Location details shown to attendees. Private notes are hidden from public API reads.
+     */
     location?: {
         type?: ('physical' | 'online' | 'hybrid' | 'hidden') | null;
         name?: string | null;
@@ -4999,9 +5142,34 @@ interface Event {
         onlineNote?: string | null;
         privateNote?: string | null;
     };
+    /**
+     * Registration mode. RSVP goes straight to Going; Approval stays pending until an operator approves it.
+     */
     registrationPolicy?: ('none' | 'rsvp' | 'approval' | 'external') | null;
+    /**
+     * Controls whether full RSVP events accept waitlisted registrations.
+     */
     waitlistPolicy?: ('disabled' | 'auto_waitlist') | null;
+    /**
+     * URL used when registration is handled outside this workspace.
+     */
     externalRegistrationUrl?: string | null;
+    /**
+     * Occurrences generated for this event. Review schedule, capacity, and registration counts here, then open an occurrence to adjust operational values.
+     */
+    occurrences?: {
+        docs?: (string | EventOccurrence)[];
+        hasNextPage?: boolean;
+        totalDocs?: number;
+    };
+    /**
+     * Registrations for this event. Creation and lifecycle status changes are handled by the registration collection and lifecycle actions.
+     */
+    registrations?: {
+        docs?: (string | EventRegistration)[];
+        hasNextPage?: boolean;
+        totalDocs?: number;
+    };
     seo?: {
         /**
          * Search result title (falls back to document title)
@@ -5039,10 +5207,19 @@ interface Event {
      */
     generateSlug?: boolean | null;
     slug?: string | null;
-    status: 'draft' | 'published' | 'archived' | 'canceled';
+    status?: ('draft' | 'published' | 'archived' | 'canceled') | null;
     coverImage?: (string | null) | Image;
-    visibility: 'inherit' | 'public' | 'unlisted' | 'members' | 'private';
+    /**
+     * Public API visibility. Unlisted events are hidden from listings but remain available by direct lookup.
+     */
+    visibility?: ('public' | 'unlisted' | 'private') | null;
+    /**
+     * Marks whether this event is authored here or imported from an external source.
+     */
     sourceType?: ('native' | 'external') | null;
+    /**
+     * External event identity. Public API reads expose only provider and URL.
+     */
     externalSource?: {
         provider?: string | null;
         sourceId?: string | null;
@@ -5064,7 +5241,7 @@ interface EventCategory {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -5089,7 +5266,7 @@ interface EventTag {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title: string;
+    title?: string | null;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -5113,16 +5290,20 @@ interface EventTag {
 interface EventOccurrence {
     id: string;
     tenant?: (string | null) | Tenant;
+    /**
+     * Human-readable occurrence title shown in relationship fields and lists. Generated from the event title and start time.
+     */
+    displayTitle?: string | null;
     event: string | Event;
     /**
      * RECURRENCE-ID based on original DTSTART
      */
-    instanceKey: string;
+    instanceKey?: string | null;
     startsAt: string;
     endsAt: string;
-    timezone: string;
+    timezone?: string | null;
     isAllDay?: boolean | null;
-    status: 'scheduled' | 'canceled' | 'completed';
+    status?: ('scheduled' | 'canceled' | 'completed') | null;
     /**
      * Location override for this occurrence only. Leave empty to use the event default location.
      */
@@ -5134,7 +5315,7 @@ interface EventOccurrence {
         privateNote?: string | null;
     };
     /**
-     * Capacity for this occurrence. Leave empty to inherit the event default registration settings.
+     * Capacity for this occurrence. Leave empty for unlimited registrations.
      */
     capacity?: number | null;
     registrationCount?: number | null;
@@ -5143,6 +5324,14 @@ interface EventOccurrence {
         opensAt?: string | null;
         closesAt?: string | null;
     };
+    /**
+     * Registrations linked to this occurrence. Registration status and check-in are managed through the registration collection and lifecycle actions.
+     */
+    registrations?: {
+        docs?: (string | EventRegistration)[];
+        hasNextPage?: boolean;
+        totalDocs?: number;
+    };
     cancellation?: {
         canceledAt?: string | null;
         reason?: string | null;
@@ -5161,15 +5350,30 @@ 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;
-    registrationStatus: 'pending' | 'going' | 'waitlisted' | 'declined' | 'canceled';
-    attendanceStatus: 'not_checked_in' | 'checked_in' | 'no_show';
+    /**
+     * Registration lifecycle status used for capacity accounting. Managed separately from attendance status.
+     */
+    registrationStatus?: ('pending' | 'going' | 'waitlisted' | 'declined' | 'canceled') | null;
+    /**
+     * On-site attendance state. It changes to checked-in or no-show only for going registrations.
+     */
+    attendanceStatus?: ('not_checked_in' | 'checked_in' | 'no_show') | null;
     /**
      * Number of attendees for this registration. Used for ticketing and capacity calculations.
      */
-    quantity: number;
+    quantity?: number | null;
     /**
      * PII snapshot captured at registration time. Hidden from publishable-key reads and subject to retention cleanup.
      */
@@ -5198,10 +5402,16 @@ interface EventRegistration {
         approvedBy?: (string | null) | User;
         note?: string | null;
     };
+    /**
+     * Cancellation timestamp and internal reason. Hidden from public API reads.
+     */
     cancellation?: {
         canceledAt?: string | null;
         reason?: string | null;
     };
+    /**
+     * Check-in audit data written by operator actions.
+     */
     checkIn?: {
         checkedInAt?: string | null;
         checkedInBy?: (string | null) | User;
@@ -6655,8 +6865,12 @@ interface OrderItemsSelect<T extends boolean = true> {
     requiresShipping?: T;
     totalPrice?: T;
     productTitle?: T;
+    optionSelection?: T;
     taxRate?: T;
     currency?: T;
+    discountAllocation?: T;
+    discountedUnitPrice?: T;
+    discountedTotalPrice?: T;
     updatedAt?: T;
     createdAt?: T;
     deletedAt?: T;
@@ -6678,6 +6892,12 @@ interface TransactionsSelect<T extends boolean = true> {
     receiptUrl?: T;
     pgPaymentId?: T;
     pgOrderId?: T;
+    providerEventId?: T;
+    providerStatus?: T;
+    confirmedAmount?: T;
+    confirmedCurrency?: T;
+    confirmedAt?: T;
+    confirmationSource?: T;
     cashReceipt?: T | {
         issuanceType?: T;
         registrationNumber?: T;
@@ -6717,6 +6937,22 @@ interface OrderStatusLogsSelect<T extends boolean = true> {
     updatedAt?: T;
     createdAt?: T;
 }
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "inventory-reservations_select".
+ */
+interface InventoryReservationsSelect<T extends boolean = true> {
+    tenant?: T;
+    order?: T;
+    orderItem?: T;
+    variant?: T;
+    quantity?: T;
+    status?: T;
+    statusChangedAt?: T;
+    updatedAt?: T;
+    createdAt?: T;
+    deletedAt?: T;
+}
 /**
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "fulfillments_select".
@@ -6769,6 +7005,8 @@ interface ReturnsSelect<T extends boolean = true> {
     completedAt?: T;
     refundReceiptUrl?: T;
     refundAmount?: T;
+    returnShippingFee?: T;
+    exchangeDifference?: T;
     metadata?: T;
     updatedAt?: T;
     createdAt?: T;
@@ -6788,6 +7026,7 @@ interface ReturnItemsSelect<T extends boolean = true> {
     variant?: T;
     quantity?: T;
     restockAction?: T;
+    restockingFee?: T;
     productTitle?: T;
     updatedAt?: T;
     createdAt?: T;
@@ -6816,6 +7055,26 @@ interface ShippingPoliciesSelect<T extends boolean = true> {
     createdAt?: T;
     deletedAt?: T;
 }
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "shipping-zones_select".
+ */
+interface ShippingZonesSelect<T extends boolean = true> {
+    _order?: T;
+    tenant?: T;
+    title?: T;
+    kind?: T;
+    postalCodePatterns?: T | {
+        pattern?: T;
+        id?: T;
+    };
+    extraAmount?: T;
+    isActive?: T;
+    metadata?: T;
+    updatedAt?: T;
+    createdAt?: T;
+    deletedAt?: T;
+}
 /**
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "customers_select".
@@ -7041,6 +7300,9 @@ interface CartItemsSelect<T extends boolean = true> {
     variant?: T;
     quantity?: T;
     unitPrice?: T;
+    discountAllocation?: T;
+    discountedUnitPrice?: T;
+    discountedTotalPrice?: T;
     metadata?: T;
     updatedAt?: T;
     createdAt?: T;
@@ -7091,22 +7353,6 @@ interface DiscountsSelect<T extends boolean = true> {
     createdAt?: T;
     deletedAt?: T;
 }
-/**
- * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "promotions_select".
- */
-interface PromotionsSelect<T extends boolean = true> {
-    tenant?: T;
-    code?: T;
-    discountType?: T;
-    discountValue?: T;
-    validFrom?: T;
-    validUntil?: T;
-    status?: T;
-    updatedAt?: T;
-    createdAt?: T;
-    deletedAt?: T;
-}
 /**
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "articles_select".
@@ -7302,7 +7548,6 @@ interface PlaylistsSelect<T extends boolean = true> {
     title?: T;
     subtitle?: T;
     description?: T;
-    videos?: T;
     categories?: T;
     tags?: T;
     tracks?: T;
@@ -7318,8 +7563,6 @@ interface PlaylistsSelect<T extends boolean = true> {
         };
     };
     thumbnail?: T;
-    coverArt?: T;
-    isCollaborative?: T;
     generateSlug?: T;
     slug?: T;
     status?: T;
@@ -7375,7 +7618,6 @@ interface TracksSelect<T extends boolean = true> {
     tenant?: T;
     title?: T;
     description?: T;
-    content?: T;
     artist?: T;
     album?: T;
     releaseDate?: T;
@@ -7386,10 +7628,7 @@ interface TracksSelect<T extends boolean = true> {
     slug?: T;
     thumbnail?: T;
     status?: T;
-    isFeatured?: T;
-    publishedAt?: T;
     durationSeconds?: T;
-    isEmbeddable?: T;
     metadata?: T;
     sourceUrl?: T;
     sourceProvider?: T;
@@ -8169,6 +8408,8 @@ interface EventsSelect<T extends boolean = true> {
     registrationPolicy?: T;
     waitlistPolicy?: T;
     externalRegistrationUrl?: T;
+    occurrences?: T;
+    registrations?: T;
     seo?: T | {
         title?: T;
         description?: T;
@@ -8239,6 +8480,7 @@ interface EventTagsSelect<T extends boolean = true> {
  */
 interface EventOccurrencesSelect<T extends boolean = true> {
     tenant?: T;
+    displayTitle?: T;
     event?: T;
     instanceKey?: T;
     startsAt?: T;
@@ -8260,6 +8502,7 @@ interface EventOccurrencesSelect<T extends boolean = true> {
         opensAt?: T;
         closesAt?: T;
     };
+    registrations?: T;
     cancellation?: T | {
         canceledAt?: T;
         reason?: T;