@01.software/sdk 0.30.1 → 0.31.0

package/dist/{payload-types-DPjO_IbQ.d.ts → payload-types-Wa4-eC6x.d.ts}

@@ -23,10 +23,6 @@ interface Config {
         'webhook-deliveries': WebhookDelivery;
         tenants: Tenant;
         'tenant-metadata': TenantMetadatum;
-        'tenant-web-analytics-config': TenantWebAnalyticsConfig;
-        'api-usage': ApiUsage;
-        'tenant-analytics-daily': TenantAnalyticsDaily;
-        'analytics-event-schemas': AnalyticsEventSchema;
         'tenant-entitlements': TenantEntitlement;
         'tenant-purge-jobs': TenantPurgeJob;
         subscriptions: Subscription;
@@ -34,6 +30,10 @@ interface Config {
         plans: Plan;
         webhooks: Webhook;
         'tenant-logos': TenantLogo;
+        'tenant-web-analytics-config': TenantWebAnalyticsConfig;
+        'tenant-analytics-daily': TenantAnalyticsDaily;
+        'analytics-event-schemas': AnalyticsEventSchema;
+        'api-usage': ApiUsage;
         products: Product;
         'product-variants': ProductVariant;
         'product-options': ProductOption;
@@ -41,6 +41,7 @@ interface Config {
         'product-categories': ProductCategory;
         'product-tags': ProductTag;
         'product-collections': ProductCollection;
+        'product-collection-items': ProductCollectionItem;
         brands: Brand;
         'brand-logos': BrandLogo;
         orders: Order;
@@ -124,11 +125,14 @@ interface Config {
         products: {
             variants: 'product-variants';
             options: 'product-options';
-            collections: 'product-collections';
+            collectionItems: 'product-collection-items';
         };
         'product-options': {
             values: 'product-option-values';
         };
+        'product-collections': {
+            items: 'product-collection-items';
+        };
         orders: {
             items: 'order-items';
             transactions: 'transactions';
@@ -186,10 +190,6 @@ interface Config {
         'webhook-deliveries': WebhookDeliveriesSelect<false> | WebhookDeliveriesSelect<true>;
         tenants: TenantsSelect<false> | TenantsSelect<true>;
         'tenant-metadata': TenantMetadataSelect<false> | TenantMetadataSelect<true>;
-        'tenant-web-analytics-config': TenantWebAnalyticsConfigSelect<false> | TenantWebAnalyticsConfigSelect<true>;
-        'api-usage': ApiUsageSelect<false> | ApiUsageSelect<true>;
-        'tenant-analytics-daily': TenantAnalyticsDailySelect<false> | TenantAnalyticsDailySelect<true>;
-        'analytics-event-schemas': AnalyticsEventSchemasSelect<false> | AnalyticsEventSchemasSelect<true>;
         'tenant-entitlements': TenantEntitlementsSelect<false> | TenantEntitlementsSelect<true>;
         'tenant-purge-jobs': TenantPurgeJobsSelect<false> | TenantPurgeJobsSelect<true>;
         subscriptions: SubscriptionsSelect<false> | SubscriptionsSelect<true>;
@@ -197,6 +197,10 @@ interface Config {
         plans: PlansSelect<false> | PlansSelect<true>;
         webhooks: WebhooksSelect<false> | WebhooksSelect<true>;
         'tenant-logos': TenantLogosSelect<false> | TenantLogosSelect<true>;
+        'tenant-web-analytics-config': TenantWebAnalyticsConfigSelect<false> | TenantWebAnalyticsConfigSelect<true>;
+        'tenant-analytics-daily': TenantAnalyticsDailySelect<false> | TenantAnalyticsDailySelect<true>;
+        'analytics-event-schemas': AnalyticsEventSchemasSelect<false> | AnalyticsEventSchemasSelect<true>;
+        'api-usage': ApiUsageSelect<false> | ApiUsageSelect<true>;
         products: ProductsSelect<false> | ProductsSelect<true>;
         'product-variants': ProductVariantsSelect<false> | ProductVariantsSelect<true>;
         'product-options': ProductOptionsSelect<false> | ProductOptionsSelect<true>;
@@ -204,6 +208,7 @@ interface Config {
         'product-categories': ProductCategoriesSelect<false> | ProductCategoriesSelect<true>;
         'product-tags': ProductTagsSelect<false> | ProductTagsSelect<true>;
         'product-collections': ProductCollectionsSelect<false> | ProductCollectionsSelect<true>;
+        'product-collection-items': ProductCollectionItemsSelect<false> | ProductCollectionItemsSelect<true>;
         brands: BrandsSelect<false> | BrandsSelect<true>;
         'brand-logos': BrandLogosSelect<false> | BrandLogosSelect<true>;
         orders: OrdersSelect<false> | OrdersSelect<true>;
@@ -402,7 +407,7 @@ interface Image {
     id: string;
     tenant?: (string | null) | Tenant;
     /**
-     * Alternative text for users who cannot see the image and for search/share context.
+     * Describe the image. Used for users who cannot see it, screen readers, and search/share previews.
      */
     alt?: string | null;
     /**
@@ -488,6 +493,21 @@ interface Tenant {
      * URL-safe identifier (auto-generated)
      */
     slug?: string | null;
+    /**
+     * Tenant-owned frontend origins that can open saved-record preview. Storefronts, docs sites, community sites, and other tenant frontends register here. Managed separately from API CORS origins.
+     */
+    previewDestinations?: {
+        origin: string;
+        /**
+         * Default destination used by the preview button. Select only one primary destination.
+         */
+        isPrimary?: boolean | null;
+        /**
+         * Draft Mode route path on the destination frontend. Enter a path, not an origin.
+         */
+        draftPath?: string | null;
+        id?: string | null;
+    }[] | null;
     /**
      * Tenant owner. Only the owner can delete the tenant or transfer ownership.
      */
@@ -513,7 +533,7 @@ interface Tenant {
      */
     publishableKey: string;
     /**
-     * Domains allowed to call this tenant’s API from a browser. Leave empty to block browser calls.
+     * Origins allowed to call this tenant API with a Publishable Key from a browser. Separate from saved-record preview destinations. Leave empty to block browser API calls.
      */
     cors?: {
         origin: string;
@@ -1155,7 +1175,7 @@ interface TenantLogo {
     id: string;
     tenant?: (string | null) | Tenant;
     /**
-     * Alternative text for users who cannot see the image and for search/share context.
+     * Describe the image. Used for users who cannot see it, screen readers, and search/share previews.
      */
     alt?: string | null;
     /**
@@ -1244,82 +1264,213 @@ interface TenantLogo {
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "tenant-web-analytics-config".
+ * via the `definition` "tenant-entitlements".
  */
-interface TenantWebAnalyticsConfig {
+interface TenantEntitlement {
     id: string;
-    tenant?: (string | null) | Tenant;
-    enabled?: boolean | null;
+    tenant: string | Tenant;
+    plan: 'free' | 'starter' | 'basic' | 'pro' | 'enterprise';
     /**
-     * Domains allowed to send analytics events. If empty, browser analytics is blocked.
+     * Lifecycle status for the entitlement. Only active rows participate in current plan resolution.
      */
-    allowedOrigins?: {
-        origin: string;
-        id?: string | null;
-    }[] | null;
+    status: 'active' | 'scheduled' | 'expired' | 'revoked';
+    sourceType: 'subscription' | 'manual' | 'support' | 'promo' | 'trial' | 'enterprise_contract';
+    sourceSubscription?: (string | null) | Subscription;
     /**
-     * Timezone used to group daily analytics. Once data starts coming in, this is locked and cannot be changed.
+     * Tie-breaker for overlapping entitlements. Higher values win within the same source precedence.
      */
-    timezone: string;
+    priority: number;
+    startsAt: string;
     /**
-     * Automatically locked once the first analytics record is saved. Contact support to unlock.
+     * Entitlement end date. Required by hook validation for promo / trial sources and excluded from current plan resolution after expiry.
      */
-    tzLocked?: boolean | null;
+    endsAt?: string | null;
+    reason?: string | null;
+    grantedBy?: (string | null) | User;
+    revokedAt?: string | null;
+    revokedBy?: (string | null) | User;
     updatedAt: string;
     createdAt: string;
     deletedAt?: string | null;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "api-usage".
+ * via the `definition` "subscriptions".
  */
-interface ApiUsage {
+interface Subscription {
     id: string;
-    tenant?: (string | null) | Tenant;
+    tenant: string | Tenant;
+    plan: 'starter' | 'basic' | 'pro';
+    billingCycle: 'monthly' | 'yearly';
     /**
-     * YYYY-MM format
+     * Payment amount (KRW)
      */
-    month: string;
-    apiCallCount: number;
-    plan: 'free' | 'starter' | 'basic' | 'pro' | 'enterprise';
+    amount: number;
+    status: 'active' | 'past_due' | 'canceled' | 'expired' | 'suspended';
+    currency: 'KRW' | 'USD';
+    provider: 'toss';
+    currentPeriodStart?: string | null;
+    currentPeriodEnd?: string | null;
+    trialStartAt?: string | null;
+    trialEndAt?: string | null;
+    endedAt?: string | null;
+    pastDueAt?: string | null;
     /**
-     * -1 means unlimited
+     * Toss billing key (AES-256-GCM encrypted)
      */
-    apiCallLimit: number;
+    billingKey?: string | null;
     /**
-     * Storage usage in bytes
+     * Toss customer key (UUID)
      */
-    storageUsedBytes?: number | null;
+    customerKey?: string | null;
     /**
-     * Storage limit in bytes (-1 means unlimited)
+     * Registered card info
      */
-    storageLimitBytes?: number | null;
+    cardInfo?: {
+        issuerCode?: string | null;
+        /**
+         * Masked card number
+         */
+        number?: string | null;
+        cardType?: string | null;
+    };
     /**
-     * Total document count across all tenant-scoped collections
+     * Provider-owned diagnostic and audit metadata returned by the billing provider. Not a general manual-edit field.
      */
-    documentCount?: number | null;
+    providerMetadata?: {
+        [k: string]: unknown;
+    } | unknown[] | string | number | boolean | null;
+    cancelAtPeriodEnd?: boolean | null;
+    canceledAt?: string | null;
+    cancelReason?: string | null;
+    retryCount?: number | null;
+    graceDeadline?: string | null;
+    lastPaymentError?: string | null;
+    pendingPlanChange?: {
+        targetPlan?: ('starter' | 'basic' | 'pro') | null;
+        targetAmount?: number | null;
+        effectiveAt?: string | null;
+    };
+    updatedAt: string;
+    createdAt: string;
+    deletedAt?: string | null;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "tenant-purge-jobs".
+ */
+interface TenantPurgeJob {
+    id: string;
+    tenantId: string;
+    status: 'pending' | 'running' | 'failed' | 'ready-to-delete';
+    currentCollection?: string | null;
+    deletedCount?: number | null;
+    failure?: string | null;
+    completedAt?: string | null;
+    updatedAt: string;
+    createdAt: string;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "billing-history".
+ */
+interface BillingHistory {
+    id: string;
+    tenant: string | Tenant;
+    subscription?: (string | null) | Subscription;
+    type: 'payment' | 'refund' | 'plan_change';
+    status: 'success' | 'failed' | 'refunded' | 'partial_refund';
     /**
-     * Number of video documents
+     * Amount (KRW)
      */
-    videoCount?: number | null;
+    amount: number;
     /**
-     * Weighted video minutes used (duration × quality multiplier)
+     * Plan at time of payment
      */
-    videoMinutesUsed?: number | null;
+    plan: 'starter' | 'basic' | 'pro';
+    provider: 'toss';
+    currency: 'KRW' | 'USD';
+    billingCycle?: ('monthly' | 'yearly') | null;
+    periodStart?: string | null;
+    periodEnd?: string | null;
     /**
-     * Monthly viewer watch time from Mux Data
+     * Unique order number
      */
-    deliveryMinutesUsed?: number | null;
+    invoiceNumber: string;
+    orderName?: string | null;
     /**
-     * AI generation count
+     * Toss payment key
      */
-    aiGenerationCount?: number | null;
+    paymentKey?: string | null;
     /**
-     * Timestamp when the usage snapshot cron calculated this monthly aggregate.
+     * Full Toss API response
      */
-    snapshottedAt?: string | null;
+    tossResponse?: {
+        [k: string]: unknown;
+    } | unknown[] | string | number | boolean | null;
+    errorMessage?: string | null;
+    /**
+     * Original billing record for retry
+     */
+    retryOf?: (string | null) | BillingHistory;
     updatedAt: string;
     createdAt: string;
+    deletedAt?: string | null;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "plans".
+ */
+interface Plan {
+    id: string;
+    /**
+     * Plan identifier (free, starter, basic, pro, enterprise)
+     */
+    key: string;
+    /**
+     * Plan display name
+     */
+    name: string;
+    /**
+     * Reference-only feature list; enforced elsewhere.
+     */
+    featuresAllowed?: ('ecommerce' | 'customers' | 'playlists' | 'galleries' | 'links' | 'forms' | 'articles' | 'documents' | 'canvas' | 'videos' | 'live-streaming' | 'community' | 'events')[] | null;
+    /**
+     * Reference-only quotas such as storageBytes; enforced by entitlement and usage policy elsewhere.
+     */
+    quotas?: {
+        [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` "tenant-web-analytics-config".
+ */
+interface TenantWebAnalyticsConfig {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    enabled?: boolean | null;
+    /**
+     * Domains allowed to send analytics events. If empty, browser analytics is blocked.
+     */
+    allowedOrigins?: {
+        origin: string;
+        id?: string | null;
+    }[] | null;
+    /**
+     * Timezone used to group daily analytics. Once data starts coming in, this is locked and cannot be changed.
+     */
+    timezone: string;
+    /**
+     * Automatically locked once the first analytics record is saved. Contact support to unlock.
+     */
+    tzLocked?: boolean | null;
+    updatedAt: string;
+    createdAt: string;
+    deletedAt?: string | null;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
@@ -1426,226 +1577,95 @@ interface TenantAnalyticsDaily {
             p50?: number | null;
             p99?: number | null;
             buckets?: {
-                bucket: string;
-                label: string;
-                count: number;
-                id?: string | null;
-            }[] | null;
-        };
-    };
-    updatedAt: string;
-    createdAt: string;
-}
-/**
- * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "analytics-event-schemas".
- */
-interface AnalyticsEventSchema {
-    id: string;
-    tenant?: (string | null) | Tenant;
-    /**
-     * Valid event name pattern.
-     */
-    eventName: string;
-    enabled: boolean;
-    dimensions?: {
-        key: string;
-        type: 'enum' | 'boolean';
-        /**
-         * Comma-separated values. Required when type=enum, optional otherwise. Boolean auto-derives {true,false}. Max 20 per key.
-         */
-        allowedValues?: string | null;
-        description?: string | null;
-        id?: string | null;
-    }[] | null;
-    createdBy?: (string | null) | User;
-    updatedBy?: (string | null) | User;
-    updatedAt: string;
-    createdAt: string;
-    deletedAt?: string | null;
-}
-/**
- * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "tenant-entitlements".
- */
-interface TenantEntitlement {
-    id: string;
-    tenant: string | Tenant;
-    plan: 'free' | 'starter' | 'basic' | 'pro' | 'enterprise';
-    /**
-     * Lifecycle status for the entitlement. Only active rows participate in current plan resolution.
-     */
-    status: 'active' | 'scheduled' | 'expired' | 'revoked';
-    sourceType: 'subscription' | 'manual' | 'support' | 'promo' | 'trial' | 'enterprise_contract';
-    sourceSubscription?: (string | null) | Subscription;
-    /**
-     * Tie-breaker for overlapping entitlements. Higher values win within the same source precedence.
-     */
-    priority: number;
-    startsAt: string;
-    /**
-     * Entitlement end date. Required by hook validation for promo / trial sources and excluded from current plan resolution after expiry.
-     */
-    endsAt?: string | null;
-    reason?: string | null;
-    grantedBy?: (string | null) | User;
-    revokedAt?: string | null;
-    revokedBy?: (string | null) | User;
-    updatedAt: string;
-    createdAt: string;
-    deletedAt?: string | null;
-}
-/**
- * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "subscriptions".
- */
-interface Subscription {
-    id: string;
-    tenant: string | Tenant;
-    plan: 'starter' | 'basic' | 'pro';
-    billingCycle: 'monthly' | 'yearly';
-    /**
-     * Payment amount (KRW)
-     */
-    amount: number;
-    status: 'active' | 'past_due' | 'canceled' | 'expired' | 'suspended';
-    currency: 'KRW' | 'USD';
-    provider: 'toss';
-    currentPeriodStart?: string | null;
-    currentPeriodEnd?: string | null;
-    trialStartAt?: string | null;
-    trialEndAt?: string | null;
-    endedAt?: string | null;
-    pastDueAt?: string | null;
-    /**
-     * Toss billing key (AES-256-GCM encrypted)
-     */
-    billingKey?: string | null;
-    /**
-     * Toss customer key (UUID)
-     */
-    customerKey?: string | null;
-    /**
-     * Registered card info
-     */
-    cardInfo?: {
-        issuerCode?: string | null;
-        /**
-         * Masked card number
-         */
-        number?: string | null;
-        cardType?: string | null;
-    };
-    /**
-     * Provider-owned diagnostic and audit metadata returned by the billing provider. Not a general manual-edit field.
-     */
-    providerMetadata?: {
-        [k: string]: unknown;
-    } | unknown[] | string | number | boolean | null;
-    cancelAtPeriodEnd?: boolean | null;
-    canceledAt?: string | null;
-    cancelReason?: string | null;
-    retryCount?: number | null;
-    graceDeadline?: string | null;
-    lastPaymentError?: string | null;
-    pendingPlanChange?: {
-        targetPlan?: ('starter' | 'basic' | 'pro') | null;
-        targetAmount?: number | null;
-        effectiveAt?: string | null;
+                bucket: string;
+                label: string;
+                count: number;
+                id?: string | null;
+            }[] | null;
+        };
     };
     updatedAt: string;
     createdAt: string;
-    deletedAt?: string | null;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "tenant-purge-jobs".
+ * via the `definition` "analytics-event-schemas".
  */
-interface TenantPurgeJob {
+interface AnalyticsEventSchema {
     id: string;
-    tenantId: string;
-    status: 'pending' | 'running' | 'failed' | 'ready-to-delete';
-    currentCollection?: string | null;
-    deletedCount?: number | null;
-    failure?: string | null;
-    completedAt?: string | null;
+    tenant?: (string | null) | Tenant;
+    /**
+     * Valid event name pattern.
+     */
+    eventName: string;
+    enabled: boolean;
+    dimensions?: {
+        key: string;
+        type: 'enum' | 'boolean';
+        /**
+         * Comma-separated values. Required when type=enum, optional otherwise. Boolean auto-derives {true,false}. Max 20 per key.
+         */
+        allowedValues?: string | null;
+        description?: string | null;
+        id?: string | null;
+    }[] | null;
+    createdBy?: (string | null) | User;
+    updatedBy?: (string | null) | User;
     updatedAt: string;
     createdAt: string;
+    deletedAt?: string | null;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "billing-history".
+ * via the `definition` "api-usage".
  */
-interface BillingHistory {
+interface ApiUsage {
     id: string;
-    tenant: string | Tenant;
-    subscription?: (string | null) | Subscription;
-    type: 'payment' | 'refund' | 'plan_change';
-    status: 'success' | 'failed' | 'refunded' | 'partial_refund';
+    tenant?: (string | null) | Tenant;
     /**
-     * Amount (KRW)
+     * YYYY-MM format
      */
-    amount: number;
+    month: string;
+    apiCallCount: number;
+    plan: 'free' | 'starter' | 'basic' | 'pro' | 'enterprise';
     /**
-     * Plan at time of payment
+     * -1 means unlimited
      */
-    plan: 'starter' | 'basic' | 'pro';
-    provider: 'toss';
-    currency: 'KRW' | 'USD';
-    billingCycle?: ('monthly' | 'yearly') | null;
-    periodStart?: string | null;
-    periodEnd?: string | null;
+    apiCallLimit: number;
     /**
-     * Unique order number
+     * Storage usage in bytes
      */
-    invoiceNumber: string;
-    orderName?: string | null;
+    storageUsedBytes?: number | null;
     /**
-     * Toss payment key
+     * Storage limit in bytes (-1 means unlimited)
      */
-    paymentKey?: string | null;
+    storageLimitBytes?: number | null;
     /**
-     * Full Toss API response
+     * Total document count across all tenant-scoped collections
      */
-    tossResponse?: {
-        [k: string]: unknown;
-    } | unknown[] | string | number | boolean | null;
-    errorMessage?: string | null;
+    documentCount?: number | null;
     /**
-     * Original billing record for retry
+     * Number of video documents
      */
-    retryOf?: (string | null) | BillingHistory;
-    updatedAt: string;
-    createdAt: string;
-    deletedAt?: string | null;
-}
-/**
- * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "plans".
- */
-interface Plan {
-    id: string;
+    videoCount?: number | null;
     /**
-     * Plan identifier (free, starter, basic, pro, enterprise)
+     * Weighted video minutes used (duration × quality multiplier)
      */
-    key: string;
+    videoMinutesUsed?: number | null;
     /**
-     * Plan display name
+     * Monthly viewer watch time from Mux Data
      */
-    name: string;
+    deliveryMinutesUsed?: number | null;
     /**
-     * Reference-only feature list; enforced elsewhere.
+     * AI generation count
      */
-    featuresAllowed?: ('ecommerce' | 'customers' | 'playlists' | 'galleries' | 'links' | 'forms' | 'articles' | 'documents' | 'canvas' | 'videos' | 'live-streaming' | 'community' | 'events')[] | null;
+    aiGenerationCount?: number | null;
     /**
-     * Reference-only quotas such as storageBytes; enforced by entitlement and usage policy elsewhere.
+     * Timestamp when the usage snapshot cron calculated this monthly aggregate.
      */
-    quotas?: {
-        [k: string]: unknown;
-    } | unknown[] | string | number | boolean | null;
+    snapshottedAt?: string | null;
     updatedAt: string;
     createdAt: string;
-    deletedAt?: string | null;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
@@ -1655,17 +1675,26 @@ interface Product {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title?: string | null;
+    title: string;
     /**
-     * Secondary display line shown in cards, listings, and detail headers.
+     * Short supporting line shown on product cards and detail headers.
      */
     subtitle?: string | null;
     /**
-     * Short summary for listing/cards
+     * Summary description used for product detail and search previews.
      */
     description?: string | null;
+    /**
+     * Product detail gallery images. When thumbnail and listing.primaryImage are empty, the first gallery image can appear as the product list thumbnail. Add alt text when uploading new images and order images in storefront display order.
+     */
     images?: (string | Image)[] | null;
+    /**
+     * Links this content to videos from the Mux-backed videos collection.
+     */
     videos?: (string | Video)[] | null;
+    /**
+     * Product detail body content. Supports image uploads and Iframe/Player/Carousel embed blocks. The article editor Code block and AI assist are not shown in this product profile.
+     */
     content?: {
         root: {
             type: string;
@@ -1693,17 +1722,23 @@ interface Product {
     };
     categories?: (string | ProductCategory)[] | null;
     tags?: (string | ProductTag)[] | null;
+    /**
+     * Canonical storefront brand used for brand filtering and brand pages. Preserve external supplier names in the sidebar Vendor field.
+     */
     brand?: (string | null) | Brand;
+    /**
+     * Shipping fee, free-shipping threshold, and estimated delivery policy for this product. When empty on a new product, the tenant default shipping policy is applied automatically.
+     */
     shippingPolicy?: (string | null) | ShippingPolicy;
     /**
-     * Product weight (g)
+     * Integer weight in grams. For example, enter 2500 for 2.5 kg.
      */
     weight?: number | null;
     /**
-     * Product collections that include this product. Managed from the collection edit view.
+     * Collection memberships for this product. Managed from the collection edit view.
      */
-    collections?: {
-        docs?: (string | ProductCollection)[];
+    collectionItems?: {
+        docs?: (string | ProductCollectionItem)[];
         hasNextPage?: boolean;
         totalDocs?: number;
     };
@@ -1716,49 +1751,46 @@ interface Product {
      */
     maxOrderQuantity?: number | null;
     /**
-     * Primary option used to expand this product into option-value listing cards (for example, Color)
+     * Operator-selected primary option. Save the product, then add options to make this selectable. When selected, product cards/search expand this product by option value (for example, Color).
      */
     listingPrimaryOption?: (string | null) | ProductOption;
     /**
-     * Derived listing projection for product cards and search
+     * Automatically derived listing projection for product cards and search. Operators do not edit these fields directly.
      */
     listing?: {
         /**
-         * Variant prioritized for product cards. Automatically derived from sellable variants, active variants, and sort order.
+         * Variant prioritized for product cards. Automatically derived from sellable variants, active variants, and sort order. Storefront product cards use this as the option hint.
          */
         selectionHintVariant?: (string | null) | ProductVariant;
         /**
-         * Primary image for product cards/search. Product media is preferred, then variant media is used as fallback.
+         * Primary image rendered by storefront product cards and search results. Product thumbnail/gallery media is preferred, then variant media is used as fallback.
          */
         primaryImage?: (string | null) | Image;
         /**
-         * Lowest active variant price. Automatically recalculated when variants change.
+         * Lowest active variant price. Automatically recalculated when variants change. Storefront cards and filters use this price.
          */
         minPrice?: number | null;
         /**
-         * Highest active variant price. Automatically recalculated when variants change.
+         * Highest active variant price. Automatically recalculated when variants change. Storefront cards and filters use this price.
          */
         maxPrice?: number | null;
         /**
-         * Lowest compare-at price across active variants. Automatically recalculated when variants change.
+         * Lowest compare-at price across active variants. Automatically recalculated when variants change. Storefront discount displays use this value.
          */
         minCompareAtPrice?: number | null;
         /**
-         * Highest compare-at price across active variants. Automatically recalculated when variants change.
+         * Highest compare-at price across active variants. Automatically recalculated when variants change. Storefront discount displays use this value.
          */
         maxCompareAtPrice?: number | null;
         /**
-         * Automatically enabled when the minimum and maximum active variant prices differ.
+         * Automatically enabled when the minimum and maximum active variant prices differ. Storefront cards use this to decide whether to show a price range.
          */
         isPriceRange?: boolean | null;
         /**
-         * Automatically enabled when at least one active variant is sellable.
+         * Automatically enabled when at least one active variant is sellable. Storefront grids and filters use this to render and filter in-stock products.
          */
         availableForSale?: boolean | null;
     };
-    metadata?: {
-        [k: string]: unknown;
-    } | unknown[] | string | number | boolean | null;
     seo?: {
         /**
          * Search result title (falls back to document title)
@@ -1786,27 +1818,47 @@ interface Product {
              */
             description?: string | null;
             /**
-             * OG / Twitter Card image (1200×630 recommended)
+             * OG / Twitter Card image (1200×630 recommended). Leaving this empty does not set it automatically from collection media.
              */
             image?: (string | null) | Image;
         };
     };
+    /**
+     * Preferred product list thumbnail. When empty, the list falls back to listing primary image, then the first gallery image. Add alt text when uploading new images.
+     */
     thumbnail?: (string | null) | Image;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
     generateSlug?: boolean | null;
+    /**
+     * Canonical product URL slug. Generated from the title or editable directly.
+     */
     slug?: string | null;
+    /**
+     * Draft products are hidden from the storefront. Only Published products are exposed through public APIs. Archived hides without deleting. Deleting a product also deletes variants and options. The last 50 saved versions can be restored from the Versions tab.
+     */
     status?: ('draft' | 'published' | 'archived') | null;
+    /**
+     * Automatically enabled when no active variant is sellable. A variant is sellable when it is active and either unlimited or has stock minus reserved stock greater than 0.
+     */
     isSoldOut?: boolean | null;
     isFeatured?: boolean | null;
+    /**
+     * Automatically stamped the first time a draft is published when empty. This is not used as a scheduled publish time.
+     */
     publishedAt?: string | null;
+    metadata?: {
+        [k: string]: unknown;
+    } | unknown[] | string | number | boolean | null;
+    /**
+     * Supplier name imported from external systems, separate from the brand relationship.
+     */
     vendor?: string | null;
-    productType?: string | null;
     /**
-     * URL handle (alternative to slug)
+     * External catalog product type, separate from categories.
      */
-    handle?: string | null;
+    productType?: string | null;
     updatedAt: string;
     createdAt: string;
     deletedAt?: string | null;
@@ -1885,7 +1937,7 @@ interface Video {
              */
             description?: string | null;
             /**
-             * OG / Twitter Card image (1200×630 recommended)
+             * OG / Twitter Card image (1200×630 recommended). Leaving this empty does not set it automatically from collection media.
              */
             image?: (string | null) | Image;
         };
@@ -1981,7 +2033,7 @@ interface LiveStream {
              */
             description?: string | null;
             /**
-             * OG / Twitter Card image (1200×630 recommended)
+             * OG / Twitter Card image (1200×630 recommended). Leaving this empty does not set it automatically from collection media.
              */
             image?: (string | null) | Image;
         };
@@ -2028,8 +2080,17 @@ interface VideoCategory {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
+    /**
+     * Optional parent category used for hierarchy and breadcrumbs.
+     */
     parent?: (string | null) | VideoCategory;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -2053,8 +2114,13 @@ interface VideoTag {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
-    parent?: (string | null) | VideoTag;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -2074,7 +2140,7 @@ interface ProductVariant {
      */
     product: string | Product;
     /**
-     * Optional variant display label. The option value combination remains the canonical variant identity.
+     * Leave blank to auto-generate from option values. Manual display labels are preserved.
      */
     title?: string | null;
     thumbnail?: (string | null) | Image;
@@ -2108,7 +2174,7 @@ interface ProductVariant {
      */
     barcode?: string | null;
     /**
-     * Variant-specific weight (g)
+     * Variant-specific integer weight in grams. For example, enter 2500 for 2.5 kg.
      */
     weight?: number | null;
     /**
@@ -2123,6 +2189,9 @@ interface ProductVariant {
      * Option value combination for this variant (e.g. Black + S)
      */
     optionValues?: (string | ProductOptionValue)[] | null;
+    /**
+     * Internal unique key for the variant option combination. Products without options use __default__; temporary invalid states use the __invalid__: prefix.
+     */
     optionKey?: string | null;
     isActive?: boolean | null;
     metadata?: {
@@ -2145,12 +2214,13 @@ interface ProductOptionValue {
      * Parent option for this value. It cannot be moved to another option after creation.
      */
     option: string | ProductOption;
+    displayLabel?: string | null;
     /**
      * Editable option-value display label for Admin and storefront copy. Changing it after creation does not change the public slug. (e.g. Black, S)
      */
     value: string;
     /**
-     * Color swatch for this option value (for example #111111)
+     * Hex color swatch for this option value (for example #111111)
      */
     swatchColor?: string | null;
     /**
@@ -2161,7 +2231,13 @@ interface ProductOptionValue {
      * Compatibility URL token generated from the option-value label on create. It is fixed after creation.
      */
     slug: string;
+    /**
+     * Representative image for this option value. Listing group media uses variant media first, then option-value media, and finally product media.
+     */
     thumbnail?: (string | null) | Image;
+    /**
+     * Reusable supporting images for this option value; used after variant media is missing, then followed by product media.
+     */
     images?: (string | Image)[] | null;
     metadata?: {
         [k: string]: unknown;
@@ -2205,6 +2281,8 @@ interface ProductOption {
     deletedAt?: string | null;
 }
 /**
+ * Product categories are a hierarchical taxonomy for navigation and grouping.
+ *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "product-categories".
  */
@@ -2222,14 +2300,25 @@ interface ProductCategory {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
+    /**
+     * Optional parent category used for hierarchy and breadcrumbs.
+     */
     parent?: (string | null) | ProductCategory;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
     deletedAt?: string | null;
 }
 /**
+ * Product tags are flat labels for search and loose grouping.
+ *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "product-tags".
  */
@@ -2247,9 +2336,10 @@ interface ProductTag {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
-    parent?: (string | null) | ProductTag;
-    color?: string | null;
     updatedAt: string;
     createdAt: string;
     deletedAt?: string | null;
@@ -2325,7 +2415,7 @@ interface Brand {
              */
             description?: string | null;
             /**
-             * OG / Twitter Card image (1200×630 recommended)
+             * OG / Twitter Card image (1200×630 recommended). Leaving this empty does not set it automatically from collection media.
              */
             image?: (string | null) | BrandLogo;
         };
@@ -2353,7 +2443,7 @@ interface BrandLogo {
     id: string;
     tenant?: (string | null) | Tenant;
     /**
-     * Alternative text for users who cannot see the image and for search/share context.
+     * Describe the image. Used for users who cannot see it, screen readers, and search/share previews.
      */
     alt?: string | null;
     /**
@@ -2448,6 +2538,7 @@ interface ShippingPolicy {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
+    displayLabel?: string | null;
     /**
      * e.g. Standard shipping, Large items
      */
@@ -2491,6 +2582,28 @@ interface ShippingPolicy {
     deletedAt?: string | null;
 }
 /**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "product-collection-items".
+ */
+interface ProductCollectionItem {
+    id: string;
+    '_product-collection-items_items_order'?: string | null;
+    _order?: string | null;
+    tenant?: (string | null) | Tenant;
+    /**
+     * Product collection for this membership. It cannot be moved to another collection after creation.
+     */
+    collection: string | ProductCollection;
+    /**
+     * Product shown in this collection. Its display order inside the collection is managed by dragging this membership row.
+     */
+    product: string | Product;
+    updatedAt: string;
+    createdAt: string;
+}
+/**
+ * Curated product grouping for campaigns, recommendations, and merchandising.
+ *
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "product-collections".
  */
@@ -2523,7 +2636,14 @@ interface ProductCollection {
         [k: string]: unknown;
     } | null;
     images?: (string | Image)[] | null;
-    products?: (string | Product)[] | null;
+    /**
+     * Collection item memberships. Public collections include only published products, and display order follows the dragged membership row order.
+     */
+    items?: {
+        docs?: (string | ProductCollectionItem)[];
+        hasNextPage?: boolean;
+        totalDocs?: number;
+    };
     seo?: {
         /**
          * Search result title (falls back to document title)
@@ -2551,7 +2671,7 @@ interface ProductCollection {
              */
             description?: string | null;
             /**
-             * OG / Twitter Card image (1200×630 recommended)
+             * OG / Twitter Card image (1200×630 recommended). Leaving this empty does not set it automatically from collection media.
              */
             image?: (string | null) | Image;
         };
@@ -2563,7 +2683,6 @@ interface ProductCollection {
     generateSlug?: boolean | null;
     slug?: string | null;
     status?: ('draft' | 'published' | 'archived') | null;
-    sortOrder?: ('manual' | 'alphabetical' | 'price-asc' | 'price-desc' | 'newest') | null;
     isFeatured?: boolean | null;
     publishedAt?: string | null;
     metadata?: {
@@ -2832,6 +2951,9 @@ interface CustomerGroup {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Optional #RRGGBB display color for Admin surfaces.
+     */
     color?: string | null;
     image?: (string | null) | Image;
     isActive?: boolean | null;
@@ -3545,6 +3667,9 @@ interface Article {
     authors?: (string | ArticleAuthor)[] | null;
     categories?: (string | ArticleCategory)[] | null;
     tags?: (string | ArticleTag)[] | null;
+    /**
+     * Links this content to videos from the Mux-backed videos collection.
+     */
     videos?: (string | Video)[] | null;
     seo?: {
         /**
@@ -3573,7 +3698,7 @@ interface Article {
              */
             description?: string | null;
             /**
-             * OG / Twitter Card image (1200×630 recommended)
+             * OG / Twitter Card image (1200×630 recommended). Leaving this empty does not set it automatically from collection media.
              */
             image?: (string | null) | Image;
         };
@@ -3588,9 +3713,6 @@ interface Article {
     images?: (string | Image)[] | null;
     publishedAt?: string | null;
     isFeatured?: boolean | null;
-    /**
-     * Reading time (minutes)
-     */
     readingMinutes?: number | null;
     /**
      * OG/Twitter excerpt (280 chars)
@@ -3608,9 +3730,6 @@ interface Article {
      * Date when featured placement should end.
      */
     featuredUntil?: string | null;
-    /**
-     * Related articles
-     */
     relatedArticles?: (string | Article)[] | null;
     metadata?: {
         [k: string]: unknown;
@@ -3670,8 +3789,17 @@ interface ArticleCategory {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
+    /**
+     * Optional parent category used for hierarchy and breadcrumbs.
+     */
     parent?: (string | null) | ArticleCategory;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -3695,8 +3823,13 @@ interface ArticleTag {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
-    parent?: (string | null) | ArticleTag;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -3734,6 +3867,9 @@ interface Document {
         };
         [k: string]: unknown;
     } | null;
+    /**
+     * Links this content to videos from the Mux-backed videos collection.
+     */
     videos?: (string | Video)[] | null;
     /**
      * Document version (e.g. 1.0, 1.1, 2.0)
@@ -3790,7 +3926,7 @@ interface Document {
              */
             description?: string | null;
             /**
-             * OG / Twitter Card image (1200×630 recommended)
+             * OG / Twitter Card image (1200×630 recommended). Leaving this empty does not set it automatically from collection media.
              */
             image?: (string | null) | Image;
         };
@@ -3840,8 +3976,17 @@ interface DocumentCategory {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
+    /**
+     * Optional parent category used for hierarchy and breadcrumbs.
+     */
     parent?: (string | null) | DocumentCategory;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -3865,7 +4010,13 @@ interface DocumentType {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -3921,7 +4072,7 @@ interface Playlist {
              */
             description?: string | null;
             /**
-             * OG / Twitter Card image (1200×630 recommended)
+             * OG / Twitter Card image (1200×630 recommended). Leaving this empty does not set it automatically from collection media.
              */
             image?: (string | null) | Image;
         };
@@ -3960,8 +4111,17 @@ interface PlaylistCategory {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
+    /**
+     * Optional parent category used for hierarchy and breadcrumbs.
+     */
     parent?: (string | null) | PlaylistCategory;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -3985,8 +4145,13 @@ interface PlaylistTag {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
-    parent?: (string | null) | PlaylistTag;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -4059,8 +4224,17 @@ interface TrackCategory {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
+    /**
+     * Optional parent category used for hierarchy and breadcrumbs.
+     */
     parent?: (string | null) | TrackCategory;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -4084,8 +4258,13 @@ interface TrackTag {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
-    parent?: (string | null) | TrackTag;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -4133,12 +4312,12 @@ interface Gallery {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Links this content to videos from the Mux-backed videos collection.
+     */
     videos?: (string | Video)[] | null;
     categories?: (string | GalleryCategory)[] | null;
     tags?: (string | GalleryTag)[] | null;
-    /**
-     * Image items shown in this gallery. Their order controls gallery display order.
-     */
     items?: {
         docs?: (string | GalleryItem)[];
         hasNextPage?: boolean;
@@ -4171,7 +4350,7 @@ interface Gallery {
              */
             description?: string | null;
             /**
-             * OG / Twitter Card image (1200×630 recommended)
+             * OG / Twitter Card image (1200×630 recommended). Leaving this empty does not set it automatically from collection media.
              */
             image?: (string | null) | Image;
         };
@@ -4211,8 +4390,17 @@ interface GalleryCategory {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
+    /**
+     * Optional parent category used for hierarchy and breadcrumbs.
+     */
     parent?: (string | null) | GalleryCategory;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -4236,8 +4424,13 @@ interface GalleryTag {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
-    parent?: (string | null) | GalleryTag;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -4295,9 +4488,6 @@ interface Link {
      * Secondary display line shown in cards, listings, and detail headers.
      */
     subtitle?: string | null;
-    /**
-     * Link URL (internal or external)
-     */
     url: string;
     /**
      * Short summary for listing/cards
@@ -4314,13 +4504,7 @@ interface Link {
     thumbnail?: (string | null) | Image;
     icon?: (string | null) | Image;
     publishedAt?: string | null;
-    /**
-     * Platform name for social or external links, such as Instagram or YouTube.
-     */
     platform?: string | null;
-    /**
-     * Whether clicks should open this link in a new tab.
-     */
     opensInNewTab?: boolean | null;
     /**
      * Controls whether rel=nofollow should be emitted for search engines.
@@ -4362,8 +4546,17 @@ interface LinkCategory {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
+    /**
+     * Optional parent category used for hierarchy and breadcrumbs.
+     */
     parent?: (string | null) | LinkCategory;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -4387,8 +4580,13 @@ interface LinkTag {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
-    parent?: (string | null) | LinkTag;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -4410,6 +4608,9 @@ interface Canvase {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Links this content to videos from the Mux-backed videos collection.
+     */
     videos?: (string | Video)[] | null;
     canvas?: {
         [k: string]: unknown;
@@ -4443,7 +4644,7 @@ interface Canvase {
              */
             description?: string | null;
             /**
-             * OG / Twitter Card image (1200×630 recommended)
+             * OG / Twitter Card image (1200×630 recommended). Leaving this empty does not set it automatically from collection media.
              */
             image?: (string | null) | Image;
         };
@@ -4482,8 +4683,17 @@ interface CanvasCategory {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
+    /**
+     * Optional parent category used for hierarchy and breadcrumbs.
+     */
     parent?: (string | null) | CanvasCategory;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -4507,8 +4717,13 @@ interface CanvasTag {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
-    parent?: (string | null) | CanvasTag;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -4532,6 +4747,9 @@ interface CanvasNodeType {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Optional #RRGGBB display color for Admin surfaces.
+     */
     color?: string | null;
     defaultSize?: {
         width?: number | null;
@@ -4597,6 +4815,9 @@ interface CanvasEdgeType {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Optional #RRGGBB display color for Admin surfaces.
+     */
     color?: string | null;
     strokeWidth?: number | null;
     isAnimated?: boolean | null;
@@ -4794,8 +5015,17 @@ interface PostCategory {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
+    /**
+     * Optional parent category used for hierarchy and breadcrumbs.
+     */
     parent?: (string | null) | PostCategory;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -5033,7 +5263,7 @@ interface EventCalendar {
              */
             description?: string | null;
             /**
-             * OG / Twitter Card image (1200×630 recommended)
+             * OG / Twitter Card image (1200×630 recommended). Leaving this empty does not set it automatically from collection media.
              */
             image?: (string | null) | Image;
         };
@@ -5048,6 +5278,9 @@ interface EventCalendar {
      * Default IANA time zone for this calendar.
      */
     timezone?: string | null;
+    /**
+     * Optional #RRGGBB display color for Admin surfaces.
+     */
     color?: string | null;
     /**
      * Visibility for the tenant-global calendar.
@@ -5207,7 +5440,7 @@ interface Event {
              */
             description?: string | null;
             /**
-             * OG / Twitter Card image (1200×630 recommended)
+             * OG / Twitter Card image (1200×630 recommended). Leaving this empty does not set it automatically from collection media.
              */
             image?: (string | null) | Image;
         };
@@ -5261,8 +5494,17 @@ interface EventCategory {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
+    /**
+     * Optional parent category used for hierarchy and breadcrumbs.
+     */
     parent?: (string | null) | EventCategory;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -5286,8 +5528,13 @@ interface EventTag {
      * Short summary for listing/cards
      */
     description?: string | null;
+    /**
+     * Single representative taxonomy image. Add domain-specific fields for multiple images such as thumbnail and hero variants.
+     */
     image?: (string | null) | Image;
-    parent?: (string | null) | EventTag;
+    /**
+     * Optional #RRGGBB hex color for taxonomy badges or filter UI. This does not replace the representative image.
+     */
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -6026,235 +6273,89 @@ interface WebhookDeliveriesSelect<T extends boolean = true> {
 interface TenantsSelect<T extends boolean = true> {
     name?: T;
     slug?: T;
-    owner?: T;
-    enabledFeatures?: T;
-    enabledRelationshipRecipes?: T;
-    featureVersion?: T;
-    provisioning?: T;
-    status?: T;
-    publishableKey?: T;
-    cors?: T | {
-        origin?: T;
-        id?: T;
-    };
-    members?: T;
-    updatedAt?: T;
-    createdAt?: T;
-    deletedAt?: T;
-}
-/**
- * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "tenant-metadata_select".
- */
-interface TenantMetadataSelect<T extends boolean = true> {
-    tenant?: T;
-    siteInfo?: T | {
-        title?: T;
-        description?: T;
-        keywords?: T;
-        author?: T;
-        url?: T;
-    };
-    businessInfo?: T | {
-        businessRegistrationNumber?: T;
-        businessName?: T;
-        ceoName?: T;
-        businessAddress?: T;
-        businessEmail?: T;
-        onlineSalesRegistrationNumber?: T;
-    };
-    branding?: T | {
-        logo?: T;
-        logoDark?: T;
-        logomark?: T;
-        favicon?: T;
-        themeColor?: T;
-    };
-    seo?: T | {
-        robots?: T;
-        googleSiteVerification?: T;
-        bingSiteVerification?: T;
-        naverSiteVerification?: T;
-        canonicalUrl?: T;
-    };
-    analytics?: T | {
-        googleAnalyticsId?: T;
-        googleTagManagerId?: T;
-        facebookPixelId?: T;
-        linkedInPartnerId?: T;
-    };
-    openGraph?: T | {
-        ogTitle?: T;
-        ogDescription?: T;
-        ogImage?: T;
-        ogType?: T;
-        ogLocale?: T;
-    };
-    twitter?: T | {
-        twitterCard?: T;
-        twitterSite?: T;
-        twitterCreator?: T;
-        twitterTitle?: T;
-        twitterDescription?: T;
-        twitterImage?: T;
-    };
-    pwa?: T | {
-        shortName?: T;
-        backgroundColor?: T;
-        display?: T;
-    };
-    updatedAt?: T;
-    createdAt?: T;
-    deletedAt?: T;
-}
-/**
- * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "tenant-web-analytics-config_select".
- */
-interface TenantWebAnalyticsConfigSelect<T extends boolean = true> {
-    tenant?: T;
-    enabled?: T;
-    allowedOrigins?: T | {
-        origin?: T;
-        id?: T;
-    };
-    timezone?: T;
-    tzLocked?: T;
-    updatedAt?: T;
-    createdAt?: T;
-    deletedAt?: T;
-}
-/**
- * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "api-usage_select".
- */
-interface ApiUsageSelect<T extends boolean = true> {
-    tenant?: T;
-    month?: T;
-    apiCallCount?: T;
-    plan?: T;
-    apiCallLimit?: T;
-    storageUsedBytes?: T;
-    storageLimitBytes?: T;
-    documentCount?: T;
-    videoCount?: T;
-    videoMinutesUsed?: T;
-    deliveryMinutesUsed?: T;
-    aiGenerationCount?: T;
-    snapshottedAt?: T;
-    updatedAt?: T;
-    createdAt?: T;
-}
-/**
- * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "tenant-analytics-daily_select".
- */
-interface TenantAnalyticsDailySelect<T extends boolean = true> {
-    tenant?: T;
-    date?: T;
-    pageviews?: T;
-    visitors?: T;
-    topPages?: T | {
-        pathname?: T;
-        views?: T;
-        id?: T;
-    };
-    topReferrers?: T | {
-        source?: T;
-        views?: T;
-        id?: T;
-    };
-    topEvents?: T | {
-        name?: T;
-        count?: T;
-        id?: T;
-    };
-    eventsDropped?: T | {
-        cardinality?: T;
-        schema?: T;
-        late?: T;
+    previewDestinations?: T | {
         origin?: T;
-        key?: T;
-        rate?: T;
-        disabled?: T;
-    };
-    snapshottedAt?: T;
-    bucketTz?: T;
-    schemaShape?: T;
-    eventDetails?: T | {
-        eventName?: T;
-        count?: T;
-        schemaShape?: T;
-        dimensions?: T | {
-            dimension?: T;
-            values?: T | {
-                value?: T;
-                count?: T;
-                id?: T;
-            };
-            id?: T;
-        };
-        pages?: T | {
-            pathname?: T;
-            count?: T;
-            id?: T;
-        };
-        referrers?: T | {
-            source?: T;
-            count?: T;
-            id?: T;
-        };
+        isPrimary?: T;
+        draftPath?: T;
         id?: T;
     };
-    mcpUsage?: T | {
-        toolCalls?: T;
-        sessions?: T;
-        convertedSessions?: T;
-        conversionRate?: T;
-        successfulWrites?: T;
-        isPartial?: T;
-        topTools?: T | {
-            name?: T;
-            count?: T;
-            readOnly?: T;
-            id?: T;
-        };
-        transports?: T | {
-            name?: T;
-            count?: T;
-            id?: T;
-        };
-        httpDurationMs?: T | {
-            p50?: T;
-            p99?: T;
-            buckets?: T | {
-                bucket?: T;
-                label?: T;
-                count?: T;
-                id?: T;
-            };
-        };
+    owner?: T;
+    enabledFeatures?: T;
+    enabledRelationshipRecipes?: T;
+    featureVersion?: T;
+    provisioning?: T;
+    status?: T;
+    publishableKey?: T;
+    cors?: T | {
+        origin?: T;
+        id?: T;
     };
+    members?: T;
     updatedAt?: T;
     createdAt?: T;
+    deletedAt?: T;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "analytics-event-schemas_select".
+ * via the `definition` "tenant-metadata_select".
  */
-interface AnalyticsEventSchemasSelect<T extends boolean = true> {
+interface TenantMetadataSelect<T extends boolean = true> {
     tenant?: T;
-    eventName?: T;
-    enabled?: T;
-    dimensions?: T | {
-        key?: T;
-        type?: T;
-        allowedValues?: T;
+    siteInfo?: T | {
+        title?: T;
         description?: T;
-        id?: T;
+        keywords?: T;
+        author?: T;
+        url?: T;
+    };
+    businessInfo?: T | {
+        businessRegistrationNumber?: T;
+        businessName?: T;
+        ceoName?: T;
+        businessAddress?: T;
+        businessEmail?: T;
+        onlineSalesRegistrationNumber?: T;
+    };
+    branding?: T | {
+        logo?: T;
+        logoDark?: T;
+        logomark?: T;
+        favicon?: T;
+        themeColor?: T;
+    };
+    seo?: T | {
+        robots?: T;
+        googleSiteVerification?: T;
+        bingSiteVerification?: T;
+        naverSiteVerification?: T;
+        canonicalUrl?: T;
+    };
+    analytics?: T | {
+        googleAnalyticsId?: T;
+        googleTagManagerId?: T;
+        facebookPixelId?: T;
+        linkedInPartnerId?: T;
+    };
+    openGraph?: T | {
+        ogTitle?: T;
+        ogDescription?: T;
+        ogImage?: T;
+        ogType?: T;
+        ogLocale?: T;
+    };
+    twitter?: T | {
+        twitterCard?: T;
+        twitterSite?: T;
+        twitterCreator?: T;
+        twitterTitle?: T;
+        twitterDescription?: T;
+        twitterImage?: T;
+    };
+    pwa?: T | {
+        shortName?: T;
+        backgroundColor?: T;
+        display?: T;
     };
-    createdBy?: T;
-    updatedBy?: T;
     updatedAt?: T;
     createdAt?: T;
     deletedAt?: T;
@@ -6481,6 +6582,158 @@ interface TenantLogosSelect<T extends boolean = true> {
         };
     };
 }
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "tenant-web-analytics-config_select".
+ */
+interface TenantWebAnalyticsConfigSelect<T extends boolean = true> {
+    tenant?: T;
+    enabled?: T;
+    allowedOrigins?: T | {
+        origin?: T;
+        id?: T;
+    };
+    timezone?: T;
+    tzLocked?: T;
+    updatedAt?: T;
+    createdAt?: T;
+    deletedAt?: T;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "tenant-analytics-daily_select".
+ */
+interface TenantAnalyticsDailySelect<T extends boolean = true> {
+    tenant?: T;
+    date?: T;
+    pageviews?: T;
+    visitors?: T;
+    topPages?: T | {
+        pathname?: T;
+        views?: T;
+        id?: T;
+    };
+    topReferrers?: T | {
+        source?: T;
+        views?: T;
+        id?: T;
+    };
+    topEvents?: T | {
+        name?: T;
+        count?: T;
+        id?: T;
+    };
+    eventsDropped?: T | {
+        cardinality?: T;
+        schema?: T;
+        late?: T;
+        origin?: T;
+        key?: T;
+        rate?: T;
+        disabled?: T;
+    };
+    snapshottedAt?: T;
+    bucketTz?: T;
+    schemaShape?: T;
+    eventDetails?: T | {
+        eventName?: T;
+        count?: T;
+        schemaShape?: T;
+        dimensions?: T | {
+            dimension?: T;
+            values?: T | {
+                value?: T;
+                count?: T;
+                id?: T;
+            };
+            id?: T;
+        };
+        pages?: T | {
+            pathname?: T;
+            count?: T;
+            id?: T;
+        };
+        referrers?: T | {
+            source?: T;
+            count?: T;
+            id?: T;
+        };
+        id?: T;
+    };
+    mcpUsage?: T | {
+        toolCalls?: T;
+        sessions?: T;
+        convertedSessions?: T;
+        conversionRate?: T;
+        successfulWrites?: T;
+        isPartial?: T;
+        topTools?: T | {
+            name?: T;
+            count?: T;
+            readOnly?: T;
+            id?: T;
+        };
+        transports?: T | {
+            name?: T;
+            count?: T;
+            id?: T;
+        };
+        httpDurationMs?: T | {
+            p50?: T;
+            p99?: T;
+            buckets?: T | {
+                bucket?: T;
+                label?: T;
+                count?: T;
+                id?: T;
+            };
+        };
+    };
+    updatedAt?: T;
+    createdAt?: T;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "analytics-event-schemas_select".
+ */
+interface AnalyticsEventSchemasSelect<T extends boolean = true> {
+    tenant?: T;
+    eventName?: T;
+    enabled?: T;
+    dimensions?: T | {
+        key?: T;
+        type?: T;
+        allowedValues?: T;
+        description?: T;
+        id?: T;
+    };
+    createdBy?: T;
+    updatedBy?: T;
+    updatedAt?: T;
+    createdAt?: T;
+    deletedAt?: T;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "api-usage_select".
+ */
+interface ApiUsageSelect<T extends boolean = true> {
+    tenant?: T;
+    month?: T;
+    apiCallCount?: T;
+    plan?: T;
+    apiCallLimit?: T;
+    storageUsedBytes?: T;
+    storageLimitBytes?: T;
+    documentCount?: T;
+    videoCount?: T;
+    videoMinutesUsed?: T;
+    deliveryMinutesUsed?: T;
+    aiGenerationCount?: T;
+    snapshottedAt?: T;
+    updatedAt?: T;
+    createdAt?: T;
+}
 /**
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "products_select".
@@ -6501,7 +6754,7 @@ interface ProductsSelect<T extends boolean = true> {
     brand?: T;
     shippingPolicy?: T;
     weight?: T;
-    collections?: T;
+    collectionItems?: T;
     minOrderQuantity?: T;
     maxOrderQuantity?: T;
     listingPrimaryOption?: T;
@@ -6515,7 +6768,6 @@ interface ProductsSelect<T extends boolean = true> {
         isPriceRange?: T;
         availableForSale?: T;
     };
-    metadata?: T;
     seo?: T | {
         title?: T;
         description?: T;
@@ -6534,9 +6786,9 @@ interface ProductsSelect<T extends boolean = true> {
     isSoldOut?: T;
     isFeatured?: T;
     publishedAt?: T;
+    metadata?: T;
     vendor?: T;
     productType?: T;
-    handle?: T;
     updatedAt?: T;
     createdAt?: T;
     deletedAt?: T;
@@ -6597,6 +6849,7 @@ interface ProductOptionValuesSelect<T extends boolean = true> {
     _order?: T;
     tenant?: T;
     option?: T;
+    displayLabel?: T;
     value?: T;
     swatchColor?: T;
     generateSlug?: T;
@@ -6638,8 +6891,6 @@ interface ProductTagsSelect<T extends boolean = true> {
     slug?: T;
     description?: T;
     image?: T;
-    parent?: T;
-    color?: T;
     updatedAt?: T;
     createdAt?: T;
     deletedAt?: T;
@@ -6656,7 +6907,7 @@ interface ProductCollectionsSelect<T extends boolean = true> {
     description?: T;
     content?: T;
     images?: T;
-    products?: T;
+    items?: T;
     seo?: T | {
         title?: T;
         description?: T;
@@ -6672,7 +6923,6 @@ interface ProductCollectionsSelect<T extends boolean = true> {
     generateSlug?: T;
     slug?: T;
     status?: T;
-    sortOrder?: T;
     isFeatured?: T;
     publishedAt?: T;
     metadata?: T;
@@ -6680,6 +6930,19 @@ interface ProductCollectionsSelect<T extends boolean = true> {
     createdAt?: T;
     deletedAt?: T;
 }
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "product-collection-items_select".
+ */
+interface ProductCollectionItemsSelect<T extends boolean = true> {
+    '_product-collection-items_items_order'?: T;
+    _order?: T;
+    tenant?: T;
+    collection?: T;
+    product?: T;
+    updatedAt?: T;
+    createdAt?: T;
+}
 /**
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "brands_select".
@@ -7051,6 +7314,7 @@ interface ReturnItemsSelect<T extends boolean = true> {
 interface ShippingPoliciesSelect<T extends boolean = true> {
     _order?: T;
     tenant?: T;
+    displayLabel?: T;
     title?: T;
     baseAmount?: T;
     freeShippingMinAmount?: T;
@@ -7459,7 +7723,6 @@ interface ArticleTagsSelect<T extends boolean = true> {
     slug?: T;
     description?: T;
     image?: T;
-    parent?: T;
     color?: T;
     updatedAt?: T;
     createdAt?: T;
@@ -7614,7 +7877,6 @@ interface PlaylistTagsSelect<T extends boolean = true> {
     slug?: T;
     description?: T;
     image?: T;
-    parent?: T;
     color?: T;
     updatedAt?: T;
     createdAt?: T;
@@ -7703,7 +7965,6 @@ interface TrackTagsSelect<T extends boolean = true> {
     slug?: T;
     description?: T;
     image?: T;
-    parent?: T;
     color?: T;
     updatedAt?: T;
     createdAt?: T;
@@ -7776,7 +8037,6 @@ interface GalleryTagsSelect<T extends boolean = true> {
     slug?: T;
     description?: T;
     image?: T;
-    parent?: T;
     color?: T;
     updatedAt?: T;
     createdAt?: T;
@@ -7863,7 +8123,6 @@ interface LinkTagsSelect<T extends boolean = true> {
     slug?: T;
     description?: T;
     image?: T;
-    parent?: T;
     color?: T;
     updatedAt?: T;
     createdAt?: T;
@@ -8005,7 +8264,6 @@ interface CanvasTagsSelect<T extends boolean = true> {
     slug?: T;
     description?: T;
     image?: T;
-    parent?: T;
     color?: T;
     updatedAt?: T;
     createdAt?: T;
@@ -8121,7 +8379,6 @@ interface VideoTagsSelect<T extends boolean = true> {
     slug?: T;
     description?: T;
     image?: T;
-    parent?: T;
     color?: T;
     updatedAt?: T;
     createdAt?: T;
@@ -8479,7 +8736,6 @@ interface EventTagsSelect<T extends boolean = true> {
     slug?: T;
     description?: T;
     image?: T;
-    parent?: T;
     color?: T;
     updatedAt?: T;
     createdAt?: T;
@@ -8793,4 +9049,4 @@ declare module 'payload' {
     }
 }
 
-export type { Article as A, CustomerProfile as C, Document as D, Form as F, Image as I, Order as O, Post as P, Reaction as R, Tenant as T, Video as V, CustomerProfileList as a, Comment as b, Config as c, Product as d, ArticleAuthor as e, ArticleCategory as f, ArticleTag as g, Cart as h, CartItem as i, PostCategory as j, ProductVariant as k, OrderItem as l, Transaction as m, Fulfillment as n, Return as o };
+export type { Article as A, CustomerProfile as C, Document as D, Form as F, Image as I, Order as O, Product as P, Reaction as R, Tenant as T, Video as V, CustomerProfileList as a, ProductCollection as b, Post as c, Comment as d, Config as e, ArticleAuthor as f, ArticleCategory as g, ArticleTag as h, Cart as i, CartItem as j, PostCategory as k, ProductVariant as l, OrderItem as m, Transaction as n, Fulfillment as o, Return as p };