@01.software/sdk 0.31.0 → 0.33.0

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

@@ -16,6 +16,7 @@ interface Config {
         'system-media': SystemMedia;
         audiences: Audience;
         'email-logs': EmailLog;
+        'commerce-notification-intents': CommerceNotificationIntent;
         'api-keys': ApiKey;
         'personal-access-tokens': PersonalAccessToken;
         'audit-logs': AuditLog;
@@ -183,6 +184,7 @@ interface Config {
         'system-media': SystemMediaSelect<false> | SystemMediaSelect<true>;
         audiences: AudiencesSelect<false> | AudiencesSelect<true>;
         'email-logs': EmailLogsSelect<false> | EmailLogsSelect<true>;
+        'commerce-notification-intents': CommerceNotificationIntentsSelect<false> | CommerceNotificationIntentsSelect<true>;
         'api-keys': ApiKeysSelect<false> | ApiKeysSelect<true>;
         'personal-access-tokens': PersonalAccessTokensSelect<false> | PersonalAccessTokensSelect<true>;
         'audit-logs': AuditLogsSelect<false> | AuditLogsSelect<true>;
@@ -539,6 +541,31 @@ interface Tenant {
         origin: string;
         id?: string | null;
     }[] | null;
+    /**
+     * Commerce customer email notification settings. All v1 events are disabled by default.
+     */
+    commerceNotifications?: {
+        /**
+         * Allow customer email sends for this event.
+         */
+        orderPaid?: boolean | null;
+        /**
+         * Allow customer email sends for this event.
+         */
+        fulfillmentShipped?: boolean | null;
+        /**
+         * Allow customer email sends for this event.
+         */
+        orderDelivered?: boolean | null;
+        /**
+         * Allow customer email sends for this event.
+         */
+        returnRequested?: boolean | null;
+        /**
+         * Allow customer email sends for this event.
+         */
+        returnCompleted?: boolean | null;
+    };
     /**
      * Users connected to this tenant
      */
@@ -733,7 +760,7 @@ interface EmailLog {
     /**
      * Email purpose and consent category. Used for verification, password reset, marketing, and audit review.
      */
-    type: 'usage-alert' | 'verification' | 'password-reset' | 'newsletter' | 'other' | 'oauth-login' | 'account-link';
+    type: 'usage-alert' | 'verification' | 'password-reset' | 'newsletter' | 'other' | 'oauth-login' | 'account-link' | 'commerce';
     status: 'sent' | 'failed';
     sentAt: string;
     error?: string | null;
@@ -748,924 +775,511 @@ interface EmailLog {
      * Consent category for compliance audit
      */
     recipientConsent?: ('marketing' | 'transactional' | 'service_notice') | null;
-    updatedAt: string;
-    createdAt: string;
-}
-/**
- * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "api-keys".
- */
-interface ApiKey {
-    id: string;
-    tenant: string | Tenant;
-    name: string;
-    secretHash: string;
-    /**
-     * Key prefix (e.g. sk01_ab12cd3)
-     */
-    displayPrefix: string;
-    /**
-     * Trailing characters used to identify the key. The raw secret key is not stored or displayed.
-     */
-    displaySuffix: string;
-    /**
-     * Capability scopes. Default is read+write; webhook dispatch requires webhook, analytics writes require analytics.
-     */
-    scopes?: ('read' | 'write' | 'webhook' | 'analytics' | 'super-admin')[] | null;
-    /**
-     * User who issued the key. Read-only provenance for issuance audit.
-     */
-    createdBy?: (string | null) | User;
-    /**
-     * IP address of the key creation request. Privacy-bearing security audit metadata.
-     */
-    createdByIp?: string | null;
-    lastUsedAt?: string | null;
-    /**
-     * Last IP address that used the key. Privacy-bearing audit value for abuse investigation.
-     */
-    lastUsedIp?: string | null;
-    revokedAt?: string | null;
-    /**
-     * User who revoked the key. Read-only provenance for revocation audit.
-     */
-    revokedBy?: (string | null) | User;
     /**
-     * Optional expiration. Empty = never expires.
+     * Commerce notification send audit metadata. Consent classification remains owned by recipientConsent.
      */
-    expiresAt?: string | null;
+    commerceNotification?: {
+        event?: ('orderPaid' | 'fulfillmentShipped' | 'orderDelivered' | 'returnRequested' | 'returnCompleted') | null;
+        intent?: (string | null) | CommerceNotificationIntent;
+        dedupeKey?: string | null;
+        order?: (string | null) | Order;
+        fulfillment?: (string | null) | Fulfillment;
+        return?: (string | null) | Return;
+        customer?: (string | null) | Customer;
+    };
     updatedAt: string;
     createdAt: string;
-    deletedAt?: string | null;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "personal-access-tokens".
+ * via the `definition` "commerce-notification-intents".
  */
-interface PersonalAccessToken {
+interface CommerceNotificationIntent {
     id: string;
-    user: string | User;
-    /**
-     * e.g. "CLI: MacBook Pro (darwin)", "GitHub Actions"
-     */
-    name: string;
-    secretHash: string;
-    /**
-     * PAT prefix. Display-only token type marker, not the raw token.
-     */
-    displayPrefix: string;
-    /**
-     * Trailing characters used to identify the PAT. The raw token is not shown again.
-     */
-    displaySuffix: string;
+    tenant?: (string | null) | Tenant;
     /**
-     * Default tenant ID for CLI operations. Set via `01 tenant use <name>`.
+     * Stable key that prevents duplicate notification intents within a tenant.
      */
-    defaultTenant?: string | null;
+    dedupeKey: string;
+    event: 'orderPaid' | 'fulfillmentShipped' | 'orderDelivered' | 'returnRequested' | 'returnCompleted';
+    status: 'queued' | 'processing' | 'sent' | 'failed' | 'canceled';
     /**
-     * IP address of the PAT creation request. Privacy-bearing security audit metadata.
+     * Customer email address targeted by this notification.
      */
-    createdByIp?: string | null;
-    lastUsedAt?: string | null;
+    recipientEmail: string;
     /**
-     * Last IP address that used the PAT. Privacy-bearing audit value for abuse investigation.
+     * Locale hint for template rendering.
      */
-    lastUsedIp?: string | null;
-    revokedAt?: string | null;
+    locale?: string | null;
     /**
-     * User who revoked the PAT. Read-only provenance for revocation audit.
+     * Secret-free event snapshot for processor template rendering.
      */
-    revokedBy?: (string | null) | User;
+    payload?: {
+        [k: string]: unknown;
+    } | unknown[] | string | number | boolean | null;
+    order?: (string | null) | Order;
+    fulfillment?: (string | null) | Fulfillment;
+    return?: (string | null) | Return;
+    customer?: (string | null) | Customer;
     /**
-     * PATs expire after 90 days by default.
+     * Email audit log produced from this intent.
      */
-    expiresAt?: string | null;
+    emailLog?: (string | null) | EmailLog;
+    attempts: number;
+    nextAttemptAt?: string | null;
+    lockedAt?: string | null;
+    processedAt?: string | null;
+    lastError?: string | null;
     updatedAt: string;
     createdAt: string;
-    deletedAt?: string | null;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "audit-logs".
+ * via the `definition` "orders".
  */
-interface AuditLog {
+interface Order {
     id: string;
     tenant?: (string | null) | Tenant;
+    orderNumber: string;
+    cartToken?: string | null;
+    status: 'pending' | 'paid' | 'failed' | 'canceled' | 'refunded' | 'preparing' | 'shipped' | 'delivered' | 'confirmed' | 'return_requested' | 'return_processing' | 'returned';
+    totalAmount?: number | null;
+    discountCode?: string | null;
+    discountAmount?: number | null;
     /**
-     * Event type
+     * Cumulative refunded amount
      */
-    eventType: string;
+    refundedAmount?: number | null;
     /**
-     * Actor ID. May refer to a user or service, and can be empty for system actions.
+     * Shipping amount at time of order
      */
-    actorId?: string | null;
+    shippingAmount?: number | null;
     /**
-     * Detailed audit event payload. May contain sensitive security, billing, or provider context.
+     * Item subtotal (excl. shipping & discount)
      */
-    payload?: {
-        [k: string]: unknown;
-    } | unknown[] | string | number | boolean | null;
-    updatedAt: string;
-    createdAt: string;
-}
-/**
- * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "webhook-events".
- */
-interface WebhookEvent {
-    id: string;
-    tenant?: (string | null) | Tenant;
+    subtotalAmount?: number | null;
+    taxAmount?: number | null;
+    source?: ('web' | 'app' | 'manual') | null;
+    currency?: string | null;
     /**
-     * Provider
+     * Internal admin notes (not visible to customers)
      */
-    provider: string;
+    adminNotes?: string | null;
+    cancelReason?: string | null;
+    canceledAt?: string | null;
+    completedAt?: string | null;
     /**
-     * Provider-supplied event ID. Used with provider as the idempotency key for duplicate prevention.
+     * Note left by customer at checkout
      */
-    eventId: string;
-    receivedAt?: string | null;
+    customerNote?: string | null;
+    customer?: (string | null) | Customer;
     /**
-     * Raw provider event body. May contain sensitive security or payment context.
+     * Customer info at the time of order
      */
-    payload?: {
+    customerSnapshot?: {
+        name?: string | null;
+        email?: string | null;
+        phone?: string | null;
+    };
+    shippingAddress?: {
+        recipientName?: string | null;
+        phone?: string | null;
+        postalCode?: string | null;
+        address?: string | null;
+        detailAddress?: string | null;
+        deliveryMessage?: string | null;
+    };
+    billingAddress?: {
+        recipientName?: string | null;
+        businessRegistrationNumber?: string | null;
+        email?: string | null;
+        phone?: string | null;
+        address?: string | null;
+    };
+    items?: {
+        docs?: (string | OrderItem)[];
+        hasNextPage?: boolean;
+        totalDocs?: number;
+    };
+    transactions?: {
+        docs?: (string | Transaction)[];
+        hasNextPage?: boolean;
+        totalDocs?: number;
+    };
+    fulfillments?: {
+        docs?: (string | Fulfillment)[];
+        hasNextPage?: boolean;
+        totalDocs?: number;
+    };
+    returns?: {
+        docs?: (string | Return)[];
+        hasNextPage?: boolean;
+        totalDocs?: number;
+    };
+    metadata?: {
         [k: string]: unknown;
     } | unknown[] | string | number | boolean | null;
+    nextRefundSeq?: number | null;
+    nextCaptureSeq?: number | null;
+    nextVoidSeq?: number | null;
     updatedAt: string;
     createdAt: string;
+    deletedAt?: string | null;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "webhook-deliveries".
+ * via the `definition` "customers".
  */
-interface WebhookDelivery {
+interface Customer {
     id: string;
+    _customers_customers_order?: string | null;
+    _order?: string | null;
     tenant?: (string | null) | Tenant;
+    name: string;
+    email?: string | null;
+    phone?: string | null;
+    groups?: (string | CustomerGroup)[] | null;
     /**
-     * Active webhook endpoint used for this delivery attempt.
+     * Internal notes (not visible to customers)
      */
-    webhookId?: (string | null) | Webhook;
+    note?: string | null;
+    birthDate?: string | null;
+    gender?: ('male' | 'female' | 'other' | 'prefer_not_to_say') | null;
+    isGuest?: boolean | null;
     /**
-     * Value sent to receivers as x-webhook-delivery-id.
+     * Authentication provider used at signup. Immutable account provenance after creation.
      */
-    deliveryId?: string | null;
-    attempt: number;
+    authProvider?: ('local' | 'google' | 'apple' | 'kakao' | 'naver') | null;
     /**
-     * Webhook delivery state. Updated by dispatcher and retry handling paths.
+     * External provider user ID. Paired with authProvider to identify the linked account and not edited after creation.
      */
-    status: 'queued' | 'success' | 'failed' | 'dead';
+    providerUserId?: string | null;
+    lastLoginAt?: string | null;
     /**
-     * Destination host with query string removed. Full URLs are not stored.
+     * Last password change timestamp (used for JWT revocation)
      */
-    endpointHost?: string | null;
+    passwordChangedAt?: string | null;
+    orders?: {
+        docs?: (string | Order)[];
+        hasNextPage?: boolean;
+        totalDocs?: number;
+    };
+    addresses?: {
+        docs?: (string | CustomerAddress)[];
+        hasNextPage?: boolean;
+        totalDocs?: number;
+    };
+    defaultShippingAddress?: (string | null) | CustomerAddress;
+    defaultBillingAddress?: (string | null) | CustomerAddress;
     /**
-     * HMAC hash of the endpoint URL with query string removed.
+     * Read-only counter maintained by order hooks for this customer's completed orders.
      */
-    endpointUrlHash?: string | null;
+    totalOrderCount?: number | null;
+    lifetimeValue?: number | null;
+    firstOrderAt?: string | null;
+    lastOrderAt?: string | null;
+    profile?: {
+        docs?: (string | CustomerProfile)[];
+        hasNextPage?: boolean;
+        totalDocs?: number;
+    };
     /**
-     * Collection that produced this delivery attempt.
+     * Read-only counter maintained by hooks for community posts authored by this customer.
      */
-    collection?: string | null;
+    postCount?: number | null;
     /**
-     * Operation that produced this delivery attempt.
+     * Read-only counter maintained by hooks for community comments authored by this customer.
      */
-    operation?: string | null;
+    commentCount?: number | null;
     /**
-     * Path that produced the delivery attempt.
+     * Read-only counter maintained by hooks for community reactions made by this customer.
      */
-    source?: ('registry' | 'retry_queue' | 'dlq_retry' | 'password_reset') | null;
+    reactionCount?: number | null;
     /**
-     * HTTP status returned by the receiver.
+     * Marks a minor customer. When enabled, guardian consent fields are managed as compliance evidence.
      */
-    statusCode?: number | null;
+    isMinor?: boolean | null;
+    marketingConsent?: {
+        email?: {
+            isConsented?: boolean | null;
+            consentedAt?: string | null;
+            expiresAt?: string | null;
+            unsubscribedAt?: string | null;
+        };
+        sms?: {
+            isConsented?: boolean | null;
+            consentedAt?: string | null;
+            expiresAt?: string | null;
+            unsubscribedAt?: string | null;
+        };
+        push?: {
+            isConsented?: boolean | null;
+            consentedAt?: string | null;
+            expiresAt?: string | null;
+            unsubscribedAt?: string | null;
+        };
+        /**
+         * Channel through which consent was obtained (e.g. signup, checkout, import)
+         */
+        consentSource?: string | null;
+    };
     /**
-     * Delivery failure kind. Sensitive request body or headers are not stored.
+     * Guardian consent evidence for a minor customer. May contain guardian PII.
      */
-    errorKind?: string | null;
+    guardianConsent?: {
+        /**
+         * Whether guardian consent has been collected. Internal compliance marker for minor-customer handling.
+         */
+        hasGuardianConsent?: boolean | null;
+        /**
+         * Guardian name. Treat as guardian PII.
+         */
+        guardianName?: string | null;
+        /**
+         * Guardian phone number. Treat as guardian PII.
+         */
+        guardianPhone?: string | null;
+        /**
+         * Timestamp when guardian consent was recorded. Read-only audit evidence.
+         */
+        guardianConsentedAt?: string | null;
+    };
+    acceptsTos?: boolean | null;
+    tosVersion?: string | null;
     /**
-     * Truncated error message. Sensitive request body or headers are not stored.
+     * Withdrawal reason (internal)
      */
-    errorMessage?: string | null;
+    withdrawReason?: string | null;
+    withdrawnAt?: string | null;
     /**
-     * Delivery attempt duration in milliseconds.
+     * Legal retention deadline. Retention cleanup or manual hard-delete paths may purge after this date.
      */
-    durationMs?: number | null;
+    retainUntil?: string | null;
+    anonymizedAt?: string | null;
+    hashedPassword?: string | null;
+    salt?: string | null;
+    resetPasswordToken?: string | null;
+    resetPasswordExpiresAt?: string | null;
+    loginAttemptCount?: number | null;
+    lockedUntil?: string | null;
     /**
-     * Next scheduled retry time for a failed delivery.
+     * Account suspension flag. Used with password/JWT revocation paths to block sessions.
      */
-    nextRetryAt?: string | null;
+    isSuspended?: boolean | null;
+    metadata?: {
+        [k: string]: unknown;
+    } | unknown[] | string | number | boolean | null;
+    updatedAt: string;
+    createdAt: string;
+    deletedAt?: string | null;
+    collection: 'customers';
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "customer-groups".
+ */
+interface CustomerGroup {
+    id: string;
+    _order?: string | null;
+    tenant?: (string | null) | Tenant;
+    title?: string | null;
     /**
-     * Marks attempts produced by Redis retry or DLQ replay paths.
+     * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
-    redelivery?: boolean | null;
+    generateSlug?: boolean | null;
+    slug?: string | null;
     /**
-     * Timestamp when the webhook request was dispatched to the endpoint.
+     * Short summary for listing/cards
      */
-    dispatchedAt?: string | null;
+    description?: string | null;
+    /**
+     * Optional #RRGGBB display color for Admin surfaces.
+     */
+    color?: string | null;
+    image?: (string | null) | Image;
+    isActive?: boolean | null;
+    /**
+     * Show this group as a customer-facing membership badge. The group collection itself remains private.
+     */
+    customerVisible?: boolean | null;
+    /**
+     * Customer-facing label. Falls back to title when empty.
+     */
+    publicTitle?: string | null;
+    publicDescription?: string | null;
+    publicBenefits?: {
+        title?: string | null;
+        description?: string | null;
+        id?: string | null;
+    }[] | null;
+    /**
+     * Customer-facing badge color. Example: #2563eb
+     */
+    badgeColor?: string | null;
+    badgeImage?: (string | null) | Image;
+    /**
+     * Customer membership display order. Lower values appear first.
+     */
+    displayOrder?: number | null;
+    metadata?: {
+        [k: string]: unknown;
+    } | unknown[] | string | number | boolean | null;
+    customers?: {
+        docs?: (string | Customer)[];
+        hasNextPage?: boolean;
+        totalDocs?: number;
+    };
     updatedAt: string;
     createdAt: string;
+    deletedAt?: string | null;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "webhooks".
+ * via the `definition` "customer-addresses".
  */
-interface Webhook {
+interface CustomerAddress {
     id: string;
     tenant?: (string | null) | Tenant;
+    customer: string | Customer;
+    label?: string | null;
+    recipientName?: string | null;
+    phone?: string | null;
+    postalCode?: string | null;
     /**
-     * Webhook name
+     * Road-name address (returned by Daum/Naver postal code pickers)
      */
-    name: string;
+    address1?: string | null;
     /**
-     * Webhook endpoint HTTPS URL. Treat this endpoint as a recipient of sensitive workspace events.
+     * Detail address (unit / floor / building name)
      */
-    url: string;
+    address2?: string | null;
     /**
-     * HMAC signing secret (immutable once set)
+     * Jibun lot-based address. Stored alongside the road-name `address1` so we can fall back when 도로명 is missing or for delivery providers that require 지번.
      */
-    secret: string;
+    jibunAddress?: string | null;
     /**
-     * Collections to subscribe to. Leave empty to receive every supported collection event.
+     * City (KR: 시/군 — e.g. "Seoul", "Busan"; non-KR: city/town).
      */
-    subscriptions?: {
-        /**
-         * 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' | '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;
-    lastDispatchedAt?: string | null;
+    city?: string | null;
+    /**
+     * Administrative area (KR: 시/도 — usually folded into `city`; non-KR: state / province / region).
+     */
+    administrativeArea?: string | null;
+    /**
+     * Which address form to print on the shipping label (default: road).
+     */
+    addressType?: ('road' | 'jibun') | null;
+    /**
+     * ISO 3166-1 alpha-2 country code
+     */
+    country?: string | null;
+    isDefault?: boolean | null;
+    /**
+     * Delivery request preset. Pick "Other" to switch to a free-form deliveryNote.
+     */
+    deliveryRequest?: ('security_office' | 'handoff_in_person' | 'call_before' | 'leave_at_door' | 'other') | null;
+    /**
+     * Free-form delivery note. Prefer the deliveryRequest preset when one of the choices fits; reserve this for actually-custom instructions.
+     */
+    deliveryNote?: string | null;
     updatedAt: string;
     createdAt: string;
     deletedAt?: string | null;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "tenant-metadata".
+ * via the `definition` "customer-profiles".
  */
-interface TenantMetadatum {
+interface CustomerProfile {
     id: string;
     tenant?: (string | null) | Tenant;
-    siteInfo?: {
-        /**
-         * Site title (used in browser tab and SEO)
-         */
-        title?: string | null;
-        /**
-         * Site description (used for SEO and social media)
-         */
-        description?: string | null;
-        /**
-         * Comma-separated keywords for SEO
-         */
-        keywords?: string | null;
-        /**
-         * Site author or company name
-         */
-        author?: string | null;
-        /**
-         * Full site URL (e.g., https://example.com)
-         */
-        url?: string | null;
-    };
+    customer: string | Customer;
     /**
-     * Required by Korean e-commerce law
+     * Public username shown like @01works. Store 3-30 characters without @, using lowercase ASCII letters, numbers, hyphens, or underscores, and keep it unique within the tenant.
      */
-    businessInfo?: {
-        businessRegistrationNumber?: string | null;
-        businessName?: string | null;
-        ceoName?: string | null;
-        businessAddress?: string | null;
-        businessEmail?: string | null;
-        onlineSalesRegistrationNumber?: string | null;
-    };
-    branding?: {
-        /**
-         * Primary logo
-         */
-        logo?: (string | null) | TenantLogo;
-        /**
-         * Logo for dark mode (optional)
-         */
-        logoDark?: (string | null) | TenantLogo;
-        /**
-         * Logo mark / Icon (optional)
-         */
-        logomark?: (string | null) | TenantLogo;
-        /**
-         * Favicon (will be resized automatically)
-         */
-        favicon?: (string | null) | TenantLogo;
-        /**
-         * Theme color for mobile browsers (hex color)
-         */
-        themeColor?: string | null;
-    };
-    seo?: {
-        /**
-         * Robots meta tag (e.g., "index, follow" or "noindex, nofollow")
-         */
-        robots?: string | null;
-        /**
-         * Google Site Verification code
-         */
-        googleSiteVerification?: string | null;
-        /**
-         * Bing Site Verification code
-         */
-        bingSiteVerification?: string | null;
-        /**
-         * Naver Site Verification code
-         */
-        naverSiteVerification?: string | null;
-        /**
-         * Canonical URL (if different from site URL)
-         */
-        canonicalUrl?: string | null;
-    };
-    analytics?: {
-        /**
-         * Google Analytics ID (e.g., G-XXXXXXXXXX)
-         */
-        googleAnalyticsId?: string | null;
-        /**
-         * Google Tag Manager ID (e.g., GTM-XXXXXXX)
-         */
-        googleTagManagerId?: string | null;
-        /**
-         * Facebook Pixel ID
-         */
-        facebookPixelId?: string | null;
-        /**
-         * LinkedIn Partner ID
-         */
-        linkedInPartnerId?: string | null;
-    };
-    openGraph?: {
-        /**
-         * Open Graph title (falls back to site title)
-         */
-        ogTitle?: string | null;
-        /**
-         * Open Graph description (falls back to site description)
-         */
-        ogDescription?: string | null;
-        /**
-         * Open Graph image (1200x630 recommended)
-         */
-        ogImage?: (string | null) | Image;
-        /**
-         * Open Graph type
-         */
-        ogType?: ('website' | 'article' | 'product' | 'profile') | null;
-        /**
-         * Open Graph locale (e.g., ko_KR, en_US)
-         */
-        ogLocale?: string | null;
-    };
-    twitter?: {
-        /**
-         * Twitter card type
-         */
-        twitterCard?: ('summary' | 'summary_large_image' | 'app' | 'player') | null;
-        /**
-         * Twitter username for the site (e.g., @yoursite)
-         */
-        twitterSite?: string | null;
-        /**
-         * Twitter username for the content creator (e.g., @author)
-         */
-        twitterCreator?: string | null;
-        /**
-         * Twitter title (falls back to OG title or site title)
-         */
-        twitterTitle?: string | null;
-        /**
-         * Twitter description (falls back to OG or site description)
-         */
-        twitterDescription?: string | null;
-        /**
-         * Twitter card image (falls back to OG image)
-         */
-        twitterImage?: (string | null) | Image;
-    };
-    pwa?: {
-        /**
-         * Short name for PWA (12 characters max)
-         */
-        shortName?: string | null;
-        /**
-         * Background color for PWA splash screen
-         */
-        backgroundColor?: string | null;
-        /**
-         * PWA display mode
-         */
-        display?: ('fullscreen' | 'standalone' | 'minimal-ui' | 'browser') | null;
-    };
-    updatedAt: string;
-    createdAt: string;
-    deletedAt?: string | null;
-}
-/**
- * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "tenant-logos".
- */
-interface TenantLogo {
-    id: string;
-    tenant?: (string | null) | Tenant;
-    /**
-     * Describe the image. Used for users who cannot see it, screen readers, and search/share previews.
-     */
-    alt?: string | null;
-    /**
-     * Low quality image placeholder
-     */
-    lqip?: string | null;
-    palette?: {
-        vibrant?: string | null;
-        muted?: string | null;
-        darkVibrant?: string | null;
-        darkMuted?: string | null;
-        lightVibrant?: string | null;
-        lightMuted?: string | null;
-    };
-    prefix?: string | null;
-    updatedAt: string;
-    createdAt: string;
-    deletedAt?: string | null;
-    url?: string | null;
-    thumbnailURL?: string | null;
-    filename?: string | null;
-    mimeType?: string | null;
-    filesize?: number | null;
-    width?: number | null;
-    height?: number | null;
-    focalX?: number | null;
-    focalY?: number | null;
-    sizes?: {
-        '16'?: {
-            url?: string | null;
-            width?: number | null;
-            height?: number | null;
-            mimeType?: string | null;
-            filesize?: number | null;
-            filename?: string | null;
-        };
-        '32'?: {
-            url?: string | null;
-            width?: number | null;
-            height?: number | null;
-            mimeType?: string | null;
-            filesize?: number | null;
-            filename?: string | null;
-        };
-        '64'?: {
-            url?: string | null;
-            width?: number | null;
-            height?: number | null;
-            mimeType?: string | null;
-            filesize?: number | null;
-            filename?: string | null;
-        };
-        '128'?: {
-            url?: string | null;
-            width?: number | null;
-            height?: number | null;
-            mimeType?: string | null;
-            filesize?: number | null;
-            filename?: string | null;
-        };
-        '180'?: {
-            url?: string | null;
-            width?: number | null;
-            height?: number | null;
-            mimeType?: string | null;
-            filesize?: number | null;
-            filename?: string | null;
-        };
-        '192'?: {
-            url?: string | null;
-            width?: number | null;
-            height?: number | null;
-            mimeType?: string | null;
-            filesize?: number | null;
-            filename?: string | null;
-        };
-        '512'?: {
-            url?: string | null;
-            width?: number | null;
-            height?: number | null;
-            mimeType?: string | null;
-            filesize?: number | null;
-            filename?: 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;
-    };
-    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';
-    /**
-     * Amount (KRW)
-     */
-    amount: number;
-    /**
-     * Plan at time of payment
-     */
-    plan: 'starter' | 'basic' | 'pro';
-    provider: 'toss';
-    currency: 'KRW' | 'USD';
-    billingCycle?: ('monthly' | 'yearly') | null;
-    periodStart?: string | null;
-    periodEnd?: string | null;
-    /**
-     * Unique order number
-     */
-    invoiceNumber: string;
-    orderName?: string | null;
-    /**
-     * Toss payment key
-     */
-    paymentKey?: string | null;
-    /**
-     * Full Toss API response
-     */
-    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?: {
+    handle?: string | null;
+    displayName?: string | null;
+    avatar?: (string | null) | Image;
+    bio?: string | null;
+    bioRichText?: {
+        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;
+    joinedAt?: string | null;
+    isPublic?: boolean | null;
+    anonymizedAt?: string | 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` "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
- * via the `definition` "tenant-analytics-daily".
- */
-interface TenantAnalyticsDaily {
-    id: string;
-    tenant?: (string | null) | Tenant;
-    /**
-     * YYYY-MM-DD (UTC)
-     */
-    date: string;
-    pageviews: number;
-    /**
-     * Estimated via HyperLogLog (±0.81%)
-     */
-    visitors: number;
-    topPages?: {
-        pathname: string;
-        views: number;
-        id?: string | null;
-    }[] | null;
-    topReferrers?: {
-        source: string;
-        views: number;
-        id?: string | null;
-    }[] | null;
-    topEvents?: {
-        name: string;
-        count: number;
-        id?: string | null;
-    }[] | null;
-    eventsDropped?: {
-        cardinality?: number | null;
-        schema?: number | null;
-        late?: number | null;
-        origin?: number | null;
-        key?: number | null;
-        rate?: number | null;
-        disabled?: number | null;
-    };
-    snapshottedAt?: string | null;
-    /**
-     * Tenant timezone used to bucket this snapshot's date.
-     */
-    bucketTz: string;
-    /**
-     * Deterministic aggregate schema shape hash for mismatch detection.
-     */
-    schemaShape: string;
-    /**
-     * Per-event dimension/page/referrer aggregates. Populated by snapshot cron when registered events have Redis data.
-     */
-    eventDetails?: {
-        eventName: string;
-        count?: number | null;
-        /**
-         * Deterministic schema shape hash for this event detail row.
-         */
-        schemaShape?: string | null;
-        dimensions?: {
-            dimension: string;
-            values?: {
-                value: string;
-                count: number;
-                id?: string | null;
-            }[] | null;
-            id?: string | null;
-        }[] | null;
-        pages?: {
-            pathname: string;
-            count: number;
-            id?: string | null;
-        }[] | null;
-        referrers?: {
-            source: string;
-            count: number;
-            id?: string | null;
-        }[] | null;
-        id?: string | null;
-    }[] | null;
-    /**
-     * MCP tool usage aggregate. Populated by snapshot cron from daily Redis keys.
-     */
-    mcpUsage?: {
-        toolCalls?: number | null;
-        sessions?: number | null;
-        convertedSessions?: number | null;
-        conversionRate?: number | null;
-        successfulWrites?: number | null;
-        isPartial?: boolean | null;
-        topTools?: {
-            name: string;
-            count: number;
-            readOnly?: boolean | null;
-            id?: string | null;
-        }[] | null;
-        transports?: {
-            name: string;
-            count: number;
-            id?: string | null;
-        }[] | null;
-        httpDurationMs?: {
-            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` "api-usage".
+ * via the `definition` "order-items".
  */
-interface ApiUsage {
+interface OrderItem {
     id: string;
     tenant?: (string | null) | Tenant;
+    order: string | Order;
     /**
-     * YYYY-MM format
-     */
-    month: string;
-    apiCallCount: number;
-    plan: 'free' | 'starter' | 'basic' | 'pro' | 'enterprise';
-    /**
-     * -1 means unlimited
+     * Quantity snapshot at order time. Used for payment and inventory calculations and not edited directly.
      */
-    apiCallLimit: number;
+    product: string | Product;
+    variant?: (string | null) | ProductVariant;
+    quantity: number;
     /**
-     * Storage usage in bytes
+     * Unit-price snapshot at order time. Later product price changes do not rewrite it.
      */
-    storageUsedBytes?: number | null;
+    unitPrice: number;
+    variantTitle?: string | null;
+    sku?: string | null;
+    compareAtPrice?: number | null;
+    weight?: number | null;
+    requiresShipping?: boolean | null;
     /**
-     * Storage limit in bytes (-1 means unlimited)
+     * Total-price snapshot at order time, preserved from unitPrice × quantity.
      */
-    storageLimitBytes?: number | null;
+    totalPrice: number;
+    productTitle?: string | null;
     /**
-     * Total document count across all tenant-scoped collections
+     * Option combination snapshot at order time. Later variant/option changes do not rewrite it.
      */
-    documentCount?: number | null;
+    optionSelection?: {
+        [k: string]: unknown;
+    } | unknown[] | string | number | boolean | null;
     /**
-     * Number of video documents
+     * Tax rate at time of order (%)
      */
-    videoCount?: number | null;
+    taxRate?: number | null;
     /**
-     * Weighted video minutes used (duration × quality multiplier)
+     * Currency at time of order (ISO-4217)
      */
-    videoMinutesUsed?: number | null;
+    currency?: string | null;
     /**
-     * Monthly viewer watch time from Mux Data
+     * Snapshot of the discount amount allocated to this line at order time (minor units).
      */
-    deliveryMinutesUsed?: number | null;
+    discountAllocation?: number | null;
     /**
-     * AI generation count
+     * Per-unit price snapshot after discount allocation. round(discountedTotalPrice / quantity).
      */
-    aiGenerationCount?: number | null;
+    discountedUnitPrice?: number | null;
     /**
-     * Timestamp when the usage snapshot cron calculated this monthly aggregate.
+     * Line total snapshot after discount allocation at order time (totalPrice - discountAllocation).
      */
-    snapshottedAt?: string | null;
+    discountedTotalPrice?: number | null;
     updatedAt: string;
     createdAt: string;
+    deletedAt?: string | null;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
@@ -1685,7 +1299,7 @@ interface Product {
      */
     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.
+     * Product detail gallery images. Order them in storefront display order.
      */
     images?: (string | Image)[] | null;
     /**
@@ -1693,7 +1307,7 @@ interface Product {
      */
     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.
+     * Product detail body content. Supports images and Iframe/Player/Carousel embed blocks.
      */
     content?: {
         root: {
@@ -1727,7 +1341,7 @@ interface Product {
      */
     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.
+     * Shipping policy for this product. When empty on create, the default policy is applied.
      */
     shippingPolicy?: (string | null) | ShippingPolicy;
     /**
@@ -1824,7 +1438,7 @@ interface Product {
         };
     };
     /**
-     * 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.
+     * Preferred thumbnail for product lists. When empty, list media or the first gallery image is used.
      */
     thumbnail?: (string | null) | Image;
     /**
@@ -1836,7 +1450,7 @@ interface Product {
      */
     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.
+     * Draft is hidden, Published is public, and Archived hides without deleting.
      */
     status?: ('draft' | 'published' | 'archived') | null;
     /**
@@ -2166,7 +1780,7 @@ interface ProductVariant {
      */
     stock?: number | null;
     /**
-     * Paid orders in transit (available quantity is stock - reservedStock)
+     * Server-owned reserved stock derived from held inventory-reservations. Only payment, cancellation, delivery, and inventory reservation reconcile paths update it.
      */
     reservedStock?: number | null;
     /**
@@ -2385,9 +1999,265 @@ interface Brand {
      */
     logomark?: (string | null) | BrandLogo;
     /**
-     * Brand official website URL
+     * Brand official website URL
+     */
+    website?: string | null;
+    seo?: {
+        /**
+         * Search result title (falls back to document title)
+         */
+        title?: string | null;
+        /**
+         * Search result description
+         */
+        description?: string | null;
+        /**
+         * Block search engine indexing
+         */
+        noIndex?: boolean | null;
+        /**
+         * Canonical URL (prevents duplicate content)
+         */
+        canonical?: string | null;
+        openGraph?: {
+            /**
+             * OG title (falls back to seo.title)
+             */
+            title?: string | null;
+            /**
+             * OG description (falls back to seo.description)
+             */
+            description?: string | null;
+            /**
+             * OG / Twitter Card image (1200×630 recommended). Leaving this empty does not set it automatically from collection media.
+             */
+            image?: (string | null) | BrandLogo;
+        };
+    };
+    /**
+     * When enabled, the slug will auto-generate from the title field on save and autosave.
+     */
+    generateSlug?: boolean | null;
+    slug?: string | null;
+    status?: ('draft' | 'published' | 'archived') | null;
+    isFeatured?: boolean | null;
+    publishedAt?: string | 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` "brand-logos".
+ */
+interface BrandLogo {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    /**
+     * Describe the image. Used for users who cannot see it, screen readers, and search/share previews.
+     */
+    alt?: string | null;
+    /**
+     * Low quality image placeholder
+     */
+    lqip?: string | null;
+    palette?: {
+        vibrant?: string | null;
+        muted?: string | null;
+        darkVibrant?: string | null;
+        darkMuted?: string | null;
+        lightVibrant?: string | null;
+        lightMuted?: string | null;
+    };
+    prefix?: string | null;
+    updatedAt: string;
+    createdAt: string;
+    deletedAt?: string | null;
+    url?: string | null;
+    thumbnailURL?: string | null;
+    filename?: string | null;
+    mimeType?: string | null;
+    filesize?: number | null;
+    width?: number | null;
+    height?: number | null;
+    focalX?: number | null;
+    focalY?: number | null;
+    sizes?: {
+        '16'?: {
+            url?: string | null;
+            width?: number | null;
+            height?: number | null;
+            mimeType?: string | null;
+            filesize?: number | null;
+            filename?: string | null;
+        };
+        '32'?: {
+            url?: string | null;
+            width?: number | null;
+            height?: number | null;
+            mimeType?: string | null;
+            filesize?: number | null;
+            filename?: string | null;
+        };
+        '64'?: {
+            url?: string | null;
+            width?: number | null;
+            height?: number | null;
+            mimeType?: string | null;
+            filesize?: number | null;
+            filename?: string | null;
+        };
+        '128'?: {
+            url?: string | null;
+            width?: number | null;
+            height?: number | null;
+            mimeType?: string | null;
+            filesize?: number | null;
+            filename?: string | null;
+        };
+        '180'?: {
+            url?: string | null;
+            width?: number | null;
+            height?: number | null;
+            mimeType?: string | null;
+            filesize?: number | null;
+            filename?: string | null;
+        };
+        '192'?: {
+            url?: string | null;
+            width?: number | null;
+            height?: number | null;
+            mimeType?: string | null;
+            filesize?: number | null;
+            filename?: string | null;
+        };
+        '512'?: {
+            url?: string | null;
+            width?: number | null;
+            height?: number | null;
+            mimeType?: string | null;
+            filesize?: number | null;
+            filename?: string | null;
+        };
+    };
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "shipping-policies".
+ */
+interface ShippingPolicy {
+    id: string;
+    _order?: string | null;
+    tenant?: (string | null) | Tenant;
+    displayLabel?: string | null;
+    /**
+     * e.g. Standard shipping, Large items
+     */
+    title?: string | null;
+    /**
+     * Amount in KRW (won)
+     */
+    baseAmount?: number | null;
+    /**
+     * Amount in KRW (won)
+     */
+    freeShippingMinAmount?: number | null;
+    /**
+     * Amount in KRW (won)
+     */
+    jejuExtraAmount?: number | null;
+    /**
+     * Amount in KRW (won)
+     */
+    remoteAreaExtraAmount?: number | null;
+    /**
+     * Short summary for listing/cards
+     */
+    description?: string | null;
+    /**
+     * When enabled, the slug will auto-generate from the title field on save and autosave.
+     */
+    generateSlug?: boolean | null;
+    slug?: string | null;
+    /**
+     * Estimated delivery days
+     */
+    estimatedDays?: number | null;
+    isActive?: boolean | null;
+    isDefault?: 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` "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".
+ */
+interface ProductCollection {
+    id: string;
+    _order?: string | null;
+    tenant?: (string | null) | Tenant;
+    title?: string | null;
+    /**
+     * Secondary display line shown in cards, listings, and detail headers.
+     */
+    subtitle?: 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;
+    images?: (string | Image)[] | null;
+    /**
+     * Collection item memberships. Public collections include only published products, and display order follows the dragged membership row order.
      */
-    website?: string | null;
+    items?: {
+        docs?: (string | ProductCollectionItem)[];
+        hasNextPage?: boolean;
+        totalDocs?: number;
+    };
     seo?: {
         /**
          * Search result title (falls back to document title)
@@ -2417,9 +2287,10 @@ interface Brand {
             /**
              * OG / Twitter Card image (1200×630 recommended). Leaving this empty does not set it automatically from collection media.
              */
-            image?: (string | null) | BrandLogo;
+            image?: (string | null) | Image;
         };
     };
+    thumbnail?: (string | null) | Image;
     /**
      * When enabled, the slug will auto-generate from the title field on save and autosave.
      */
@@ -2437,904 +2308,1118 @@ interface Brand {
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "brand-logos".
+ * via the `definition` "transactions".
  */
-interface BrandLogo {
+interface Transaction {
     id: string;
     tenant?: (string | null) | Tenant;
+    _title?: string | null;
+    type: 'payment' | 'refund';
+    status: 'pending' | 'paid' | 'failed' | 'canceled' | 'refunded';
+    order: string | Order;
+    amount?: number | null;
     /**
-     * Describe the image. Used for users who cannot see it, screen readers, and search/share previews.
+     * Payment method snapshot returned by the provider. Not edited directly.
      */
-    alt?: string | null;
+    paymentMethod?: string | null;
     /**
-     * Low quality image placeholder
+     * Installment months (0 = lump sum)
      */
-    lqip?: string | null;
-    palette?: {
-        vibrant?: string | null;
-        muted?: string | null;
-        darkVibrant?: string | null;
-        darkMuted?: string | null;
-        lightVibrant?: string | null;
-        lightMuted?: string | null;
+    installmentMonths?: number | null;
+    approvedAt?: string | null;
+    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;
+        /**
+         * Personal: phone or cash receipt card number / Business: business registration number
+         */
+        registrationNumber?: string | null;
+        issueNumber?: string | null;
+        issuedAt?: string | null;
     };
-    prefix?: string | null;
+    cardInfo?: {
+        brand?: string | null;
+        last4?: string | null;
+        expMonth?: number | null;
+        expYear?: number | null;
+        issuerCode?: string | null;
+        type?: ('credit' | 'debit' | 'gift') | null;
+        owner?: string | null;
+    };
+    failureCode?: string | null;
+    failureMessage?: string | null;
+    /**
+     * Payment gateway (e.g. toss, stripe)
+     */
+    pgProvider?: string | null;
+    /**
+     * Legal retention deadline (5 years, Electronic Financial Transactions Act)
+     */
+    retainUntil?: string | null;
+    metadata?: {
+        [k: string]: unknown;
+    } | unknown[] | string | number | boolean | null;
     updatedAt: string;
     createdAt: string;
     deletedAt?: string | null;
-    url?: string | null;
-    thumbnailURL?: string | null;
-    filename?: string | null;
-    mimeType?: string | null;
-    filesize?: number | null;
-    width?: number | null;
-    height?: number | null;
-    focalX?: number | null;
-    focalY?: number | null;
-    sizes?: {
-        '16'?: {
-            url?: string | null;
-            width?: number | null;
-            height?: number | null;
-            mimeType?: string | null;
-            filesize?: number | null;
-            filename?: string | null;
-        };
-        '32'?: {
-            url?: string | null;
-            width?: number | null;
-            height?: number | null;
-            mimeType?: string | null;
-            filesize?: number | null;
-            filename?: string | null;
-        };
-        '64'?: {
-            url?: string | null;
-            width?: number | null;
-            height?: number | null;
-            mimeType?: string | null;
-            filesize?: number | null;
-            filename?: string | null;
-        };
-        '128'?: {
-            url?: string | null;
-            width?: number | null;
-            height?: number | null;
-            mimeType?: string | null;
-            filesize?: number | null;
-            filename?: string | null;
-        };
-        '180'?: {
-            url?: string | null;
-            width?: number | null;
-            height?: number | null;
-            mimeType?: string | null;
-            filesize?: number | null;
-            filename?: string | null;
-        };
-        '192'?: {
-            url?: string | null;
-            width?: number | null;
-            height?: number | null;
-            mimeType?: string | null;
-            filesize?: number | null;
-            filename?: string | null;
-        };
-        '512'?: {
-            url?: string | null;
-            width?: number | null;
-            height?: number | null;
-            mimeType?: string | null;
-            filesize?: number | null;
-            filename?: string | null;
-        };
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "fulfillments".
+ */
+interface Fulfillment {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    order: string | Order;
+    status: 'pending' | 'packed' | 'shipped' | 'delivered' | 'failed';
+    /**
+     * Carrier name (e.g. CJ Logistics, FedEx)
+     */
+    carrier?: string | null;
+    /**
+     * Carrier tracking number. Used as input for the derived trackingUrl.
+     */
+    trackingNumber?: string | null;
+    /**
+     * Tracking URL (auto-derived from carrier + trackingNumber)
+     */
+    trackingUrl?: string | null;
+    packedAt?: string | null;
+    shippedAt?: string | null;
+    deliveredAt?: string | null;
+    items?: {
+        docs?: (string | FulfillmentItem)[];
+        hasNextPage?: boolean;
+        totalDocs?: number;
+    };
+    /**
+     * Internal fulfillment note. Not shown directly to customers.
+     */
+    adminNotes?: string | 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` "fulfillment-items".
+ */
+interface FulfillmentItem {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    fulfillment: string | Fulfillment;
+    orderItem: string | OrderItem;
+    quantity: number;
+    updatedAt: string;
+    createdAt: string;
+    deletedAt?: string | null;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "returns".
+ */
+interface Return {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    returnNumber?: string | null;
+    order: string | Order;
+    type: 'refund' | 'exchange';
+    /**
+     * New order created for exchange
+     */
+    exchangeOrder?: (string | null) | Order;
+    status: 'requested' | 'processing' | 'approved' | 'rejected' | 'completed';
+    /**
+     * Reason category for the return or refund request. Used for reporting and operations.
+     */
+    reason?: ('change_of_mind' | 'defective' | 'wrong_delivery' | 'damaged' | 'other') | null;
+    /**
+     * Detailed return reason
+     */
+    reasonDetail?: string | null;
+    items?: {
+        docs?: (string | ReturnItem)[];
+        hasNextPage?: boolean;
+        totalDocs?: number;
     };
+    /**
+     * Internal return-processing note. Not shown directly to customers.
+     */
+    adminNotes?: string | null;
+    completedAt?: string | null;
+    /**
+     * Refund receipt URL
+     */
+    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;
+    updatedAt: string;
+    createdAt: string;
+    deletedAt?: string | null;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "return-items".
+ */
+interface ReturnItem {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    return: string | Return;
+    order: string | Order;
+    status: 'requested' | 'processing' | 'approved' | 'rejected' | 'completed';
+    orderItem: string | OrderItem;
+    product: string | Product;
+    variant?: (string | null) | ProductVariant;
+    /**
+     * Quantity fixed when the return item is created. It cannot be edited after create to protect refund/restock calculations.
+     */
+    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;
+    deletedAt?: string | null;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "shipping-policies".
+ * via the `definition` "api-keys".
  */
-interface ShippingPolicy {
+interface ApiKey {
     id: string;
-    _order?: string | null;
-    tenant?: (string | null) | Tenant;
-    displayLabel?: string | null;
+    tenant: string | Tenant;
+    name: string;
+    secretHash: string;
     /**
-     * e.g. Standard shipping, Large items
+     * Key prefix (e.g. sk01_ab12cd3)
      */
-    title?: string | null;
+    displayPrefix: string;
     /**
-     * Amount in KRW (won)
+     * Trailing characters used to identify the key. The raw secret key is not stored or displayed.
      */
-    baseAmount?: number | null;
+    displaySuffix: string;
     /**
-     * Amount in KRW (won)
+     * Capability scopes. Default is read+write; webhook dispatch requires webhook, analytics writes require analytics.
      */
-    freeShippingMinAmount?: number | null;
+    scopes?: ('read' | 'write' | 'webhook' | 'analytics' | 'super-admin')[] | null;
     /**
-     * Amount in KRW (won)
+     * User who issued the key. Read-only provenance for issuance audit.
      */
-    jejuExtraAmount?: number | null;
+    createdBy?: (string | null) | User;
     /**
-     * Amount in KRW (won)
+     * IP address of the key creation request. Privacy-bearing security audit metadata.
      */
-    remoteAreaExtraAmount?: number | null;
+    createdByIp?: string | null;
+    lastUsedAt?: string | null;
     /**
-     * Short summary for listing/cards
+     * Last IP address that used the key. Privacy-bearing audit value for abuse investigation.
      */
-    description?: string | null;
+    lastUsedIp?: string | null;
+    revokedAt?: string | null;
     /**
-     * When enabled, the slug will auto-generate from the title field on save and autosave.
+     * User who revoked the key. Read-only provenance for revocation audit.
      */
-    generateSlug?: boolean | null;
-    slug?: string | null;
+    revokedBy?: (string | null) | User;
     /**
-     * Estimated delivery days
+     * Optional expiration. Empty = never expires.
      */
-    estimatedDays?: number | null;
-    isActive?: boolean | null;
-    isDefault?: boolean | null;
-    metadata?: {
-        [k: string]: unknown;
-    } | unknown[] | string | number | boolean | null;
+    expiresAt?: string | null;
     updatedAt: string;
     createdAt: string;
     deletedAt?: string | null;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "product-collection-items".
+ * via the `definition` "personal-access-tokens".
  */
-interface ProductCollectionItem {
+interface PersonalAccessToken {
     id: string;
-    '_product-collection-items_items_order'?: string | null;
-    _order?: string | null;
-    tenant?: (string | null) | Tenant;
+    user: string | User;
     /**
-     * Product collection for this membership. It cannot be moved to another collection after creation.
+     * e.g. "CLI: MacBook Pro (darwin)", "GitHub Actions"
      */
-    collection: string | ProductCollection;
+    name: string;
+    secretHash: string;
     /**
-     * Product shown in this collection. Its display order inside the collection is managed by dragging this membership row.
+     * PAT prefix. Display-only token type marker, not the raw token.
      */
-    product: string | Product;
+    displayPrefix: string;
+    /**
+     * Trailing characters used to identify the PAT. The raw token is not shown again.
+     */
+    displaySuffix: string;
+    /**
+     * Default tenant ID for CLI operations. Set via `01 tenant use <name>`.
+     */
+    defaultTenant?: string | null;
+    /**
+     * IP address of the PAT creation request. Privacy-bearing security audit metadata.
+     */
+    createdByIp?: string | null;
+    lastUsedAt?: string | null;
+    /**
+     * Last IP address that used the PAT. Privacy-bearing audit value for abuse investigation.
+     */
+    lastUsedIp?: string | null;
+    revokedAt?: string | null;
+    /**
+     * User who revoked the PAT. Read-only provenance for revocation audit.
+     */
+    revokedBy?: (string | null) | User;
+    /**
+     * PATs expire after 90 days by default.
+     */
+    expiresAt?: string | null;
     updatedAt: string;
     createdAt: string;
+    deletedAt?: string | null;
 }
 /**
- * Curated product grouping for campaigns, recommendations, and merchandising.
- *
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "product-collections".
+ * via the `definition` "audit-logs".
  */
-interface ProductCollection {
+interface AuditLog {
     id: string;
-    _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title?: string | null;
     /**
-     * Secondary display line shown in cards, listings, and detail headers.
+     * Event type
      */
-    subtitle?: string | null;
+    eventType: string;
     /**
-     * Short summary for listing/cards
+     * Actor ID. May refer to a user or service, and can be empty for system actions.
      */
-    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;
-        };
+    actorId?: string | null;
+    /**
+     * Detailed audit event payload. May contain sensitive security, billing, or provider context.
+     */
+    payload?: {
         [k: string]: unknown;
-    } | null;
-    images?: (string | Image)[] | null;
+    } | unknown[] | string | number | boolean | null;
+    updatedAt: string;
+    createdAt: string;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "webhook-events".
+ */
+interface WebhookEvent {
+    id: string;
+    tenant?: (string | null) | Tenant;
     /**
-     * Collection item memberships. Public collections include only published products, and display order follows the dragged membership row order.
+     * Provider
      */
-    items?: {
-        docs?: (string | ProductCollectionItem)[];
-        hasNextPage?: boolean;
-        totalDocs?: number;
-    };
-    seo?: {
-        /**
-         * Search result title (falls back to document title)
-         */
-        title?: string | null;
-        /**
-         * Search result description
-         */
-        description?: string | null;
-        /**
-         * Block search engine indexing
-         */
-        noIndex?: boolean | null;
-        /**
-         * Canonical URL (prevents duplicate content)
-         */
-        canonical?: string | null;
-        openGraph?: {
-            /**
-             * OG title (falls back to seo.title)
-             */
-            title?: string | null;
-            /**
-             * OG description (falls back to seo.description)
-             */
-            description?: string | null;
-            /**
-             * OG / Twitter Card image (1200×630 recommended). Leaving this empty does not set it automatically from collection media.
-             */
-            image?: (string | null) | Image;
-        };
-    };
-    thumbnail?: (string | null) | Image;
+    provider: string;
     /**
-     * When enabled, the slug will auto-generate from the title field on save and autosave.
+     * Provider-supplied event ID. Used with provider as the idempotency key for duplicate prevention.
      */
-    generateSlug?: boolean | null;
-    slug?: string | null;
-    status?: ('draft' | 'published' | 'archived') | null;
-    isFeatured?: boolean | null;
-    publishedAt?: string | null;
-    metadata?: {
+    eventId: string;
+    receivedAt?: string | null;
+    /**
+     * Raw provider event body. May contain sensitive security or payment context.
+     */
+    payload?: {
         [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` "orders".
+ * via the `definition` "webhook-deliveries".
  */
-interface Order {
+interface WebhookDelivery {
     id: string;
     tenant?: (string | null) | Tenant;
-    orderNumber: string;
-    cartToken?: string | null;
-    status: 'pending' | 'paid' | 'failed' | 'canceled' | 'refunded' | 'preparing' | 'shipped' | 'delivered' | 'confirmed' | 'return_requested' | 'return_processing' | 'returned';
-    totalAmount?: number | null;
-    discountCode?: string | null;
-    discountAmount?: number | null;
     /**
-     * Cumulative refunded amount
+     * Active webhook endpoint used for this delivery attempt.
+     */
+    webhookId?: (string | null) | Webhook;
+    /**
+     * Value sent to receivers as x-webhook-delivery-id.
+     */
+    deliveryId?: string | null;
+    attempt: number;
+    /**
+     * Webhook delivery state. Updated by dispatcher and retry handling paths.
+     */
+    status: 'queued' | 'success' | 'failed' | 'dead';
+    /**
+     * Destination host with query string removed. Full URLs are not stored.
+     */
+    endpointHost?: string | null;
+    /**
+     * HMAC hash of the endpoint URL with query string removed.
+     */
+    endpointUrlHash?: string | null;
+    /**
+     * Collection that produced this delivery attempt.
+     */
+    collection?: string | null;
+    /**
+     * Operation that produced this delivery attempt.
+     */
+    operation?: string | null;
+    /**
+     * Path that produced the delivery attempt.
+     */
+    source?: ('registry' | 'retry_queue' | 'dlq_retry' | 'password_reset') | null;
+    /**
+     * HTTP status returned by the receiver.
      */
-    refundedAmount?: number | null;
+    statusCode?: number | null;
     /**
-     * Shipping amount at time of order
+     * Delivery failure kind. Sensitive request body or headers are not stored.
      */
-    shippingAmount?: number | null;
+    errorKind?: string | null;
     /**
-     * Item subtotal (excl. shipping & discount)
+     * Truncated error message. Sensitive request body or headers are not stored.
      */
-    subtotalAmount?: number | null;
-    taxAmount?: number | null;
-    source?: ('web' | 'app' | 'manual') | null;
-    currency?: string | null;
+    errorMessage?: string | null;
     /**
-     * Internal admin notes (not visible to customers)
+     * Delivery attempt duration in milliseconds.
      */
-    adminNotes?: string | null;
-    cancelReason?: string | null;
-    canceledAt?: string | null;
-    completedAt?: string | null;
+    durationMs?: number | null;
     /**
-     * Note left by customer at checkout
+     * Next scheduled retry time for a failed delivery.
      */
-    customerNote?: string | null;
-    customer?: (string | null) | Customer;
+    nextRetryAt?: string | null;
     /**
-     * Customer info at the time of order
+     * Marks attempts produced by Redis retry or DLQ replay paths.
      */
-    customerSnapshot?: {
-        name?: string | null;
-        email?: string | null;
-        phone?: string | null;
-    };
-    shippingAddress?: {
-        recipientName?: string | null;
-        phone?: string | null;
-        postalCode?: string | null;
-        address?: string | null;
-        detailAddress?: string | null;
-        deliveryMessage?: string | null;
-    };
-    billingAddress?: {
-        recipientName?: string | null;
-        businessRegistrationNumber?: string | null;
-        email?: string | null;
-        phone?: string | null;
-        address?: string | null;
-    };
-    items?: {
-        docs?: (string | OrderItem)[];
-        hasNextPage?: boolean;
-        totalDocs?: number;
-    };
-    transactions?: {
-        docs?: (string | Transaction)[];
-        hasNextPage?: boolean;
-        totalDocs?: number;
-    };
-    fulfillments?: {
-        docs?: (string | Fulfillment)[];
-        hasNextPage?: boolean;
-        totalDocs?: number;
-    };
-    returns?: {
-        docs?: (string | Return)[];
-        hasNextPage?: boolean;
-        totalDocs?: number;
-    };
-    metadata?: {
-        [k: string]: unknown;
-    } | unknown[] | string | number | boolean | null;
-    nextRefundSeq?: number | null;
-    nextCaptureSeq?: number | null;
-    nextVoidSeq?: number | null;
+    redelivery?: boolean | null;
+    /**
+     * Timestamp when the webhook request was dispatched to the endpoint.
+     */
+    dispatchedAt?: string | null;
     updatedAt: string;
     createdAt: string;
-    deletedAt?: string | null;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "customers".
+ * via the `definition` "webhooks".
  */
-interface Customer {
+interface Webhook {
     id: string;
-    _customers_customers_order?: string | null;
-    _order?: string | null;
     tenant?: (string | null) | Tenant;
-    name: string;
-    email?: string | null;
-    phone?: string | null;
-    groups?: (string | CustomerGroup)[] | null;
     /**
-     * Internal notes (not visible to customers)
+     * Webhook name
      */
-    note?: string | null;
-    birthDate?: string | null;
-    gender?: ('male' | 'female' | 'other' | 'prefer_not_to_say') | null;
-    isGuest?: boolean | null;
+    name: string;
     /**
-     * Authentication provider used at signup. Immutable account provenance after creation.
+     * Webhook endpoint HTTPS URL. Treat this endpoint as a recipient of sensitive workspace events.
      */
-    authProvider?: ('local' | 'google' | 'apple' | 'kakao' | 'naver') | null;
+    url: string;
     /**
-     * External provider user ID. Paired with authProvider to identify the linked account and not edited after creation.
+     * HMAC signing secret (immutable once set)
      */
-    providerUserId?: string | null;
-    lastLoginAt?: string | null;
+    secret: string;
     /**
-     * Last password change timestamp (used for JWT revocation)
+     * Collections to subscribe to. Leave empty to receive every supported collection event.
      */
-    passwordChangedAt?: string | null;
-    orders?: {
-        docs?: (string | Order)[];
-        hasNextPage?: boolean;
-        totalDocs?: number;
-    };
-    addresses?: {
-        docs?: (string | CustomerAddress)[];
-        hasNextPage?: boolean;
-        totalDocs?: number;
+    subscriptions?: {
+        /**
+         * 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' | '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;
+    lastDispatchedAt?: string | null;
+    updatedAt: string;
+    createdAt: string;
+    deletedAt?: string | null;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "tenant-metadata".
+ */
+interface TenantMetadatum {
+    id: string;
+    tenant?: (string | null) | Tenant;
+    siteInfo?: {
+        /**
+         * Site title (used in browser tab and SEO)
+         */
+        title?: string | null;
+        /**
+         * Site description (used for SEO and social media)
+         */
+        description?: string | null;
+        /**
+         * Comma-separated keywords for SEO
+         */
+        keywords?: string | null;
+        /**
+         * Site author or company name
+         */
+        author?: string | null;
+        /**
+         * Full site URL (e.g., https://example.com)
+         */
+        url?: string | null;
     };
-    defaultShippingAddress?: (string | null) | CustomerAddress;
-    defaultBillingAddress?: (string | null) | CustomerAddress;
     /**
-     * Read-only counter maintained by order hooks for this customer's completed orders.
+     * Required by Korean e-commerce law
      */
-    totalOrderCount?: number | null;
-    lifetimeValue?: number | null;
-    firstOrderAt?: string | null;
-    lastOrderAt?: string | null;
-    profile?: {
-        docs?: (string | CustomerProfile)[];
-        hasNextPage?: boolean;
-        totalDocs?: number;
+    businessInfo?: {
+        businessRegistrationNumber?: string | null;
+        businessName?: string | null;
+        ceoName?: string | null;
+        businessAddress?: string | null;
+        businessEmail?: string | null;
+        onlineSalesRegistrationNumber?: string | null;
     };
-    /**
-     * Read-only counter maintained by hooks for community posts authored by this customer.
-     */
-    postCount?: number | null;
-    /**
-     * Read-only counter maintained by hooks for community comments authored by this customer.
-     */
-    commentCount?: number | null;
-    /**
-     * Read-only counter maintained by hooks for community reactions made by this customer.
-     */
-    reactionCount?: number | null;
-    /**
-     * Marks a minor customer. When enabled, guardian consent fields are managed as compliance evidence.
-     */
-    isMinor?: boolean | null;
-    marketingConsent?: {
-        email?: {
-            isConsented?: boolean | null;
-            consentedAt?: string | null;
-            expiresAt?: string | null;
-            unsubscribedAt?: string | null;
-        };
-        sms?: {
-            isConsented?: boolean | null;
-            consentedAt?: string | null;
-            expiresAt?: string | null;
-            unsubscribedAt?: string | null;
-        };
-        push?: {
-            isConsented?: boolean | null;
-            consentedAt?: string | null;
-            expiresAt?: string | null;
-            unsubscribedAt?: string | null;
-        };
+    branding?: {
+        /**
+         * Primary logo
+         */
+        logo?: (string | null) | TenantLogo;
+        /**
+         * Logo for dark mode (optional)
+         */
+        logoDark?: (string | null) | TenantLogo;
+        /**
+         * Logo mark / Icon (optional)
+         */
+        logomark?: (string | null) | TenantLogo;
+        /**
+         * Favicon (will be resized automatically)
+         */
+        favicon?: (string | null) | TenantLogo;
+        /**
+         * Theme color for mobile browsers (hex color)
+         */
+        themeColor?: string | null;
+    };
+    seo?: {
+        /**
+         * Robots meta tag (e.g., "index, follow" or "noindex, nofollow")
+         */
+        robots?: string | null;
+        /**
+         * Google Site Verification code
+         */
+        googleSiteVerification?: string | null;
+        /**
+         * Bing Site Verification code
+         */
+        bingSiteVerification?: string | null;
+        /**
+         * Naver Site Verification code
+         */
+        naverSiteVerification?: string | null;
+        /**
+         * Canonical URL (if different from site URL)
+         */
+        canonicalUrl?: string | null;
+    };
+    analytics?: {
         /**
-         * Channel through which consent was obtained (e.g. signup, checkout, import)
+         * Google Analytics ID (e.g., G-XXXXXXXXXX)
          */
-        consentSource?: string | null;
+        googleAnalyticsId?: string | null;
+        /**
+         * Google Tag Manager ID (e.g., GTM-XXXXXXX)
+         */
+        googleTagManagerId?: string | null;
+        /**
+         * Facebook Pixel ID
+         */
+        facebookPixelId?: string | null;
+        /**
+         * LinkedIn Partner ID
+         */
+        linkedInPartnerId?: string | null;
     };
-    /**
-     * Guardian consent evidence for a minor customer. May contain guardian PII.
-     */
-    guardianConsent?: {
+    openGraph?: {
         /**
-         * Whether guardian consent has been collected. Internal compliance marker for minor-customer handling.
+         * Open Graph title (falls back to site title)
          */
-        hasGuardianConsent?: boolean | null;
+        ogTitle?: string | null;
         /**
-         * Guardian name. Treat as guardian PII.
+         * Open Graph description (falls back to site description)
          */
-        guardianName?: string | null;
+        ogDescription?: string | null;
         /**
-         * Guardian phone number. Treat as guardian PII.
+         * Open Graph image (1200x630 recommended)
          */
-        guardianPhone?: string | null;
+        ogImage?: (string | null) | Image;
         /**
-         * Timestamp when guardian consent was recorded. Read-only audit evidence.
+         * Open Graph type
          */
-        guardianConsentedAt?: string | null;
+        ogType?: ('website' | 'article' | 'product' | 'profile') | null;
+        /**
+         * Open Graph locale (e.g., ko_KR, en_US)
+         */
+        ogLocale?: string | null;
+    };
+    twitter?: {
+        /**
+         * Twitter card type
+         */
+        twitterCard?: ('summary' | 'summary_large_image' | 'app' | 'player') | null;
+        /**
+         * Twitter username for the site (e.g., @yoursite)
+         */
+        twitterSite?: string | null;
+        /**
+         * Twitter username for the content creator (e.g., @author)
+         */
+        twitterCreator?: string | null;
+        /**
+         * Twitter title (falls back to OG title or site title)
+         */
+        twitterTitle?: string | null;
+        /**
+         * Twitter description (falls back to OG or site description)
+         */
+        twitterDescription?: string | null;
+        /**
+         * Twitter card image (falls back to OG image)
+         */
+        twitterImage?: (string | null) | Image;
+    };
+    pwa?: {
+        /**
+         * Short name for PWA (12 characters max)
+         */
+        shortName?: string | null;
+        /**
+         * Background color for PWA splash screen
+         */
+        backgroundColor?: string | null;
+        /**
+         * PWA display mode
+         */
+        display?: ('fullscreen' | 'standalone' | 'minimal-ui' | 'browser') | null;
     };
-    acceptsTos?: boolean | null;
-    tosVersion?: string | null;
-    /**
-     * Withdrawal reason (internal)
-     */
-    withdrawReason?: string | null;
-    withdrawnAt?: string | null;
-    /**
-     * Legal retention deadline. Retention cleanup or manual hard-delete paths may purge after this date.
-     */
-    retainUntil?: string | null;
-    anonymizedAt?: string | null;
-    hashedPassword?: string | null;
-    salt?: string | null;
-    resetPasswordToken?: string | null;
-    resetPasswordExpiresAt?: string | null;
-    loginAttemptCount?: number | null;
-    lockedUntil?: string | null;
-    /**
-     * Account suspension flag. Used with password/JWT revocation paths to block sessions.
-     */
-    isSuspended?: boolean | null;
-    metadata?: {
-        [k: string]: unknown;
-    } | unknown[] | string | number | boolean | null;
     updatedAt: string;
     createdAt: string;
     deletedAt?: string | null;
-    collection: 'customers';
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "customer-groups".
+ * via the `definition` "tenant-logos".
  */
-interface CustomerGroup {
+interface TenantLogo {
     id: string;
-    _order?: string | null;
     tenant?: (string | null) | Tenant;
-    title?: string | null;
-    /**
-     * When enabled, the slug will auto-generate from the title field on save and autosave.
-     */
-    generateSlug?: boolean | null;
-    slug?: string | null;
-    /**
-     * Short summary for listing/cards
-     */
-    description?: string | null;
     /**
-     * Optional #RRGGBB display color for Admin surfaces.
+     * Describe the image. Used for users who cannot see it, screen readers, and search/share previews.
      */
-    color?: string | null;
-    image?: (string | null) | Image;
-    isActive?: boolean | null;
+    alt?: string | null;
     /**
-     * Show this group as a customer-facing membership badge. The group collection itself remains private.
+     * Low quality image placeholder
      */
-    customerVisible?: boolean | null;
+    lqip?: string | null;
+    palette?: {
+        vibrant?: string | null;
+        muted?: string | null;
+        darkVibrant?: string | null;
+        darkMuted?: string | null;
+        lightVibrant?: string | null;
+        lightMuted?: string | null;
+    };
+    prefix?: string | null;
+    updatedAt: string;
+    createdAt: string;
+    deletedAt?: string | null;
+    url?: string | null;
+    thumbnailURL?: string | null;
+    filename?: string | null;
+    mimeType?: string | null;
+    filesize?: number | null;
+    width?: number | null;
+    height?: number | null;
+    focalX?: number | null;
+    focalY?: number | null;
+    sizes?: {
+        '16'?: {
+            url?: string | null;
+            width?: number | null;
+            height?: number | null;
+            mimeType?: string | null;
+            filesize?: number | null;
+            filename?: string | null;
+        };
+        '32'?: {
+            url?: string | null;
+            width?: number | null;
+            height?: number | null;
+            mimeType?: string | null;
+            filesize?: number | null;
+            filename?: string | null;
+        };
+        '64'?: {
+            url?: string | null;
+            width?: number | null;
+            height?: number | null;
+            mimeType?: string | null;
+            filesize?: number | null;
+            filename?: string | null;
+        };
+        '128'?: {
+            url?: string | null;
+            width?: number | null;
+            height?: number | null;
+            mimeType?: string | null;
+            filesize?: number | null;
+            filename?: string | null;
+        };
+        '180'?: {
+            url?: string | null;
+            width?: number | null;
+            height?: number | null;
+            mimeType?: string | null;
+            filesize?: number | null;
+            filename?: string | null;
+        };
+        '192'?: {
+            url?: string | null;
+            width?: number | null;
+            height?: number | null;
+            mimeType?: string | null;
+            filesize?: number | null;
+            filename?: string | null;
+        };
+        '512'?: {
+            url?: string | null;
+            width?: number | null;
+            height?: number | null;
+            mimeType?: string | null;
+            filesize?: number | null;
+            filename?: 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';
     /**
-     * Customer-facing label. Falls back to title when empty.
+     * Lifecycle status for the entitlement. Only active rows participate in current plan resolution.
      */
-    publicTitle?: string | null;
-    publicDescription?: string | null;
-    publicBenefits?: {
-        title?: string | null;
-        description?: string | null;
-        id?: string | null;
-    }[] | null;
+    status: 'active' | 'scheduled' | 'expired' | 'revoked';
+    sourceType: 'subscription' | 'manual' | 'support' | 'promo' | 'trial' | 'enterprise_contract';
+    sourceSubscription?: (string | null) | Subscription;
     /**
-     * Customer-facing badge color. Example: #2563eb
+     * Tie-breaker for overlapping entitlements. Higher values win within the same source precedence.
      */
-    badgeColor?: string | null;
-    badgeImage?: (string | null) | Image;
+    priority: number;
+    startsAt: string;
     /**
-     * Customer membership display order. Lower values appear first.
+     * Entitlement end date. Required by hook validation for promo / trial sources and excluded from current plan resolution after expiry.
      */
-    displayOrder?: number | null;
-    metadata?: {
-        [k: string]: unknown;
-    } | unknown[] | string | number | boolean | null;
-    customers?: {
-        docs?: (string | Customer)[];
-        hasNextPage?: boolean;
-        totalDocs?: number;
-    };
+    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` "customer-addresses".
+ * via the `definition` "subscriptions".
  */
-interface CustomerAddress {
+interface Subscription {
     id: string;
-    tenant?: (string | null) | Tenant;
-    customer: string | Customer;
-    label?: string | null;
-    recipientName?: string | null;
-    phone?: string | null;
-    postalCode?: string | null;
-    /**
-     * Road-name address (returned by Daum/Naver postal code pickers)
-     */
-    address1?: string | null;
-    /**
-     * Detail address (unit / floor / building name)
-     */
-    address2?: string | null;
-    /**
-     * Jibun lot-based address. Stored alongside the road-name `address1` so we can fall back when 도로명 is missing or for delivery providers that require 지번.
-     */
-    jibunAddress?: string | null;
-    /**
-     * City (KR: 시/군 — e.g. "Seoul", "Busan"; non-KR: city/town).
-     */
-    city?: string | null;
+    tenant: string | Tenant;
+    plan: 'starter' | 'basic' | 'pro';
+    billingCycle: 'monthly' | 'yearly';
     /**
-     * Administrative area (KR: 시/도 — usually folded into `city`; non-KR: state / province / region).
+     * Payment amount (KRW)
      */
-    administrativeArea?: string | null;
+    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;
     /**
-     * Which address form to print on the shipping label (default: road).
+     * Toss billing key (AES-256-GCM encrypted)
      */
-    addressType?: ('road' | 'jibun') | null;
+    billingKey?: string | null;
     /**
-     * ISO 3166-1 alpha-2 country code
+     * Toss customer key (UUID)
      */
-    country?: string | null;
-    isDefault?: boolean | null;
+    customerKey?: string | null;
     /**
-     * Delivery request preset. Pick "Other" to switch to a free-form deliveryNote.
+     * Registered card info
      */
-    deliveryRequest?: ('security_office' | 'handoff_in_person' | 'call_before' | 'leave_at_door' | 'other') | null;
+    cardInfo?: {
+        issuerCode?: string | null;
+        /**
+         * Masked card number
+         */
+        number?: string | null;
+        cardType?: string | null;
+    };
     /**
-     * Free-form delivery note. Prefer the deliveryRequest preset when one of the choices fits; reserve this for actually-custom instructions.
+     * Provider-owned diagnostic and audit metadata returned by the billing provider. Not a general manual-edit field.
      */
-    deliveryNote?: string | 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` "customer-profiles".
+ * via the `definition` "tenant-purge-jobs".
  */
-interface CustomerProfile {
+interface TenantPurgeJob {
     id: string;
-    tenant?: (string | null) | Tenant;
-    customer: string | Customer;
-    /**
-     * Public username shown like @01works. Store 3-30 characters without @, using lowercase ASCII letters, numbers, hyphens, or underscores, and keep it unique within the tenant.
-     */
-    handle?: string | null;
-    displayName?: string | null;
-    avatar?: (string | null) | Image;
-    bio?: string | null;
-    bioRichText?: {
-        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;
-    joinedAt?: string | null;
-    isPublic?: boolean | null;
-    anonymizedAt?: string | null;
-    metadata?: {
-        [k: string]: unknown;
-    } | unknown[] | string | number | boolean | null;
+    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` "order-items".
+ * via the `definition` "billing-history".
  */
-interface OrderItem {
+interface BillingHistory {
     id: string;
-    tenant?: (string | null) | Tenant;
-    order: string | Order;
+    tenant: string | Tenant;
+    subscription?: (string | null) | Subscription;
+    type: 'payment' | 'refund' | 'plan_change';
+    status: 'success' | 'failed' | 'refunded' | 'partial_refund';
     /**
-     * Quantity snapshot at order time. Used for payment and inventory calculations and not edited directly.
+     * Amount (KRW)
      */
-    product: string | Product;
-    variant?: (string | null) | ProductVariant;
-    quantity: number;
+    amount: number;
     /**
-     * Unit-price snapshot at order time. Later product price changes do not rewrite it.
+     * Plan at time of payment
      */
-    unitPrice: number;
-    variantTitle?: string | null;
-    sku?: string | null;
-    compareAtPrice?: number | null;
-    weight?: number | null;
-    requiresShipping?: boolean | null;
+    plan: 'starter' | 'basic' | 'pro';
+    provider: 'toss';
+    currency: 'KRW' | 'USD';
+    billingCycle?: ('monthly' | 'yearly') | null;
+    periodStart?: string | null;
+    periodEnd?: string | null;
     /**
-     * Total-price snapshot at order time, preserved from unitPrice × quantity.
+     * Unique order number
      */
-    totalPrice: number;
-    productTitle?: string | null;
+    invoiceNumber: string;
+    orderName?: string | null;
     /**
-     * Option combination snapshot at order time. Later variant/option changes do not rewrite it.
+     * Toss payment key
      */
-    optionSelection?: {
+    paymentKey?: string | null;
+    /**
+     * Full Toss API response
+     */
+    tossResponse?: {
         [k: string]: unknown;
     } | unknown[] | string | number | boolean | null;
+    errorMessage?: string | null;
     /**
-     * Tax rate at time of order (%)
+     * Original billing record for retry
      */
-    taxRate?: number | null;
+    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;
     /**
-     * Currency at time of order (ISO-4217)
+     * Plan identifier (free, starter, basic, pro, enterprise)
      */
-    currency?: string | null;
+    key: string;
     /**
-     * Snapshot of the discount amount allocated to this line at order time (minor units).
+     * Plan display name
      */
-    discountAllocation?: number | null;
+    name: string;
     /**
-     * Per-unit price snapshot after discount allocation. round(discountedTotalPrice / quantity).
+     * Reference-only feature list; enforced elsewhere.
      */
-    discountedUnitPrice?: number | null;
+    featuresAllowed?: ('ecommerce' | 'customers' | 'playlists' | 'galleries' | 'links' | 'forms' | 'articles' | 'documents' | 'canvas' | 'videos' | 'live-streaming' | 'community' | 'events')[] | null;
     /**
-     * Line total snapshot after discount allocation at order time (totalPrice - discountAllocation).
+     * Reference-only quotas such as storageBytes; enforced by entitlement and usage policy elsewhere.
      */
-    discountedTotalPrice?: number | null;
+    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` "transactions".
+ * via the `definition` "tenant-web-analytics-config".
  */
-interface Transaction {
+interface TenantWebAnalyticsConfig {
     id: string;
     tenant?: (string | null) | Tenant;
-    _title?: string | null;
-    type: 'payment' | 'refund';
-    status: 'pending' | 'paid' | 'failed' | 'canceled' | 'refunded';
-    order: string | Order;
-    amount?: number | null;
-    /**
-     * Payment method snapshot returned by the provider. Not edited directly.
-     */
-    paymentMethod?: string | null;
+    enabled?: boolean | null;
     /**
-     * Installment months (0 = lump sum)
+     * Domains allowed to send analytics events. If empty, browser analytics is blocked.
      */
-    installmentMonths?: number | null;
-    approvedAt?: string | null;
-    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;
-        /**
-         * Personal: phone or cash receipt card number / Business: business registration number
-         */
-        registrationNumber?: string | null;
-        issueNumber?: string | null;
-        issuedAt?: string | null;
-    };
-    cardInfo?: {
-        brand?: string | null;
-        last4?: string | null;
-        expMonth?: number | null;
-        expYear?: number | null;
-        issuerCode?: string | null;
-        type?: ('credit' | 'debit' | 'gift') | null;
-        owner?: string | null;
-    };
-    failureCode?: string | null;
-    failureMessage?: string | null;
+    allowedOrigins?: {
+        origin: string;
+        id?: string | null;
+    }[] | null;
     /**
-     * Payment gateway (e.g. toss, stripe)
+     * Timezone used to group daily analytics. Once data starts coming in, this is locked and cannot be changed.
      */
-    pgProvider?: string | null;
+    timezone: string;
     /**
-     * Legal retention deadline (5 years, Electronic Financial Transactions Act)
+     * Automatically locked once the first analytics record is saved. Contact support to unlock.
      */
-    retainUntil?: string | null;
-    metadata?: {
-        [k: string]: unknown;
-    } | unknown[] | string | number | boolean | null;
+    tzLocked?: boolean | null;
     updatedAt: string;
     createdAt: string;
     deletedAt?: string | null;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "fulfillments".
+ * via the `definition` "tenant-analytics-daily".
  */
-interface Fulfillment {
+interface TenantAnalyticsDaily {
     id: string;
     tenant?: (string | null) | Tenant;
-    order: string | Order;
-    status: 'pending' | 'packed' | 'shipped' | 'delivered' | 'failed';
     /**
-     * Carrier name (e.g. CJ Logistics, FedEx)
+     * YYYY-MM-DD (UTC)
      */
-    carrier?: string | null;
+    date: string;
+    pageviews: number;
     /**
-     * Carrier tracking number. Used as input for the derived trackingUrl.
+     * Estimated via HyperLogLog (±0.81%)
      */
-    trackingNumber?: string | null;
+    visitors: number;
+    topPages?: {
+        pathname: string;
+        views: number;
+        id?: string | null;
+    }[] | null;
+    topReferrers?: {
+        source: string;
+        views: number;
+        id?: string | null;
+    }[] | null;
+    topEvents?: {
+        name: string;
+        count: number;
+        id?: string | null;
+    }[] | null;
+    eventsDropped?: {
+        cardinality?: number | null;
+        schema?: number | null;
+        late?: number | null;
+        origin?: number | null;
+        key?: number | null;
+        rate?: number | null;
+        disabled?: number | null;
+    };
+    snapshottedAt?: string | null;
     /**
-     * Tracking URL (auto-derived from carrier + trackingNumber)
+     * Tenant timezone used to bucket this snapshot's date.
      */
-    trackingUrl?: string | null;
-    packedAt?: string | null;
-    shippedAt?: string | null;
-    deliveredAt?: string | null;
-    items?: {
-        docs?: (string | FulfillmentItem)[];
-        hasNextPage?: boolean;
-        totalDocs?: number;
-    };
+    bucketTz: string;
     /**
-     * Internal fulfillment note. Not shown directly to customers.
+     * Deterministic aggregate schema shape hash for mismatch detection.
      */
-    adminNotes?: string | null;
-    metadata?: {
-        [k: string]: unknown;
-    } | unknown[] | string | number | boolean | null;
+    schemaShape: string;
+    /**
+     * Per-event dimension/page/referrer aggregates. Populated by snapshot cron when registered events have Redis data.
+     */
+    eventDetails?: {
+        eventName: string;
+        count?: number | null;
+        /**
+         * Deterministic schema shape hash for this event detail row.
+         */
+        schemaShape?: string | null;
+        dimensions?: {
+            dimension: string;
+            values?: {
+                value: string;
+                count: number;
+                id?: string | null;
+            }[] | null;
+            id?: string | null;
+        }[] | null;
+        pages?: {
+            pathname: string;
+            count: number;
+            id?: string | null;
+        }[] | null;
+        referrers?: {
+            source: string;
+            count: number;
+            id?: string | null;
+        }[] | null;
+        id?: string | null;
+    }[] | null;
+    /**
+     * MCP tool usage aggregate. Populated by snapshot cron from daily Redis keys.
+     */
+    mcpUsage?: {
+        toolCalls?: number | null;
+        sessions?: number | null;
+        convertedSessions?: number | null;
+        conversionRate?: number | null;
+        successfulWrites?: number | null;
+        isPartial?: boolean | null;
+        topTools?: {
+            name: string;
+            count: number;
+            readOnly?: boolean | null;
+            id?: string | null;
+        }[] | null;
+        transports?: {
+            name: string;
+            count: number;
+            id?: string | null;
+        }[] | null;
+        httpDurationMs?: {
+            p50?: number | null;
+            p99?: number | null;
+            buckets?: {
+                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` "fulfillment-items".
+ * via the `definition` "analytics-event-schemas".
  */
-interface FulfillmentItem {
+interface AnalyticsEventSchema {
     id: string;
     tenant?: (string | null) | Tenant;
-    fulfillment: string | Fulfillment;
-    orderItem: string | OrderItem;
-    quantity: number;
+    /**
+     * 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` "returns".
+ * via the `definition` "api-usage".
  */
-interface Return {
+interface ApiUsage {
     id: string;
     tenant?: (string | null) | Tenant;
-    returnNumber?: string | null;
-    order: string | Order;
-    type: 'refund' | 'exchange';
     /**
-     * New order created for exchange
+     * YYYY-MM format
      */
-    exchangeOrder?: (string | null) | Order;
-    status: 'requested' | 'processing' | 'approved' | 'rejected' | 'completed';
+    month: string;
+    apiCallCount: number;
+    plan: 'free' | 'starter' | 'basic' | 'pro' | 'enterprise';
     /**
-     * Reason category for the return or refund request. Used for reporting and operations.
+     * -1 means unlimited
      */
-    reason?: ('change_of_mind' | 'defective' | 'wrong_delivery' | 'damaged' | 'other') | null;
+    apiCallLimit: number;
     /**
-     * Detailed return reason
+     * Storage usage in bytes
      */
-    reasonDetail?: string | null;
-    items?: {
-        docs?: (string | ReturnItem)[];
-        hasNextPage?: boolean;
-        totalDocs?: number;
-    };
+    storageUsedBytes?: number | null;
     /**
-     * Internal return-processing note. Not shown directly to customers.
+     * Storage limit in bytes (-1 means unlimited)
      */
-    adminNotes?: string | null;
-    completedAt?: string | null;
+    storageLimitBytes?: number | null;
     /**
-     * Refund receipt URL
+     * Total document count across all tenant-scoped collections
      */
-    refundReceiptUrl?: string | null;
-    refundAmount: number;
+    documentCount?: number | null;
     /**
-     * Return shipping fee deducted from refundAmount
+     * Number of video documents
      */
-    returnShippingFee?: number | null;
+    videoCount?: number | null;
     /**
-     * Exchange balance (positive: extra charge, negative: extra refund)
+     * Weighted video minutes used (duration × quality multiplier)
      */
-    exchangeDifference?: number | 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` "return-items".
- */
-interface ReturnItem {
-    id: string;
-    tenant?: (string | null) | Tenant;
-    return: string | Return;
-    order: string | Order;
-    status: 'requested' | 'processing' | 'approved' | 'rejected' | 'completed';
-    orderItem: string | OrderItem;
-    product: string | Product;
-    variant?: (string | null) | ProductVariant;
-    quantity: number;
-    restockAction: 'return_to_stock' | 'discard';
+    videoMinutesUsed?: number | null;
     /**
-     * Restocking fee for this line (deducted from line refund)
+     * Monthly viewer watch time from Mux Data
      */
-    restockingFee?: number | null;
-    productTitle?: string | null;
+    deliveryMinutesUsed?: number | null;
+    /**
+     * AI generation count
+     */
+    aiGenerationCount?: number | null;
+    /**
+     * Timestamp when the usage snapshot cron calculated this monthly aggregate.
+     */
+    snapshottedAt?: string | null;
     updatedAt: string;
     createdAt: string;
-    deletedAt?: string | null;
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
@@ -3368,7 +3453,13 @@ interface InventoryReservation {
     orderItem: string | OrderItem;
     variant: string | ProductVariant;
     quantity: number;
+    /**
+     * Reservation lifecycle status. Payment, cancellation, and delivery server paths transition it through held, released, and consumed.
+     */
     status: 'held' | 'released' | 'consumed';
+    /**
+     * Timestamp of the latest reservation status change made by a server path.
+     */
     statusChangedAt?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -6170,6 +6261,40 @@ interface EmailLogsSelect<T extends boolean = true> {
     clickedAt?: T;
     bouncedAt?: T;
     recipientConsent?: T;
+    commerceNotification?: T | {
+        event?: T;
+        intent?: T;
+        dedupeKey?: T;
+        order?: T;
+        fulfillment?: T;
+        return?: T;
+        customer?: T;
+    };
+    updatedAt?: T;
+    createdAt?: T;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "commerce-notification-intents_select".
+ */
+interface CommerceNotificationIntentsSelect<T extends boolean = true> {
+    tenant?: T;
+    dedupeKey?: T;
+    event?: T;
+    status?: T;
+    recipientEmail?: T;
+    locale?: T;
+    payload?: T;
+    order?: T;
+    fulfillment?: T;
+    return?: T;
+    customer?: T;
+    emailLog?: T;
+    attempts?: T;
+    nextAttemptAt?: T;
+    lockedAt?: T;
+    processedAt?: T;
+    lastError?: T;
     updatedAt?: T;
     createdAt?: T;
 }
@@ -6290,6 +6415,13 @@ interface TenantsSelect<T extends boolean = true> {
         origin?: T;
         id?: T;
     };
+    commerceNotifications?: T | {
+        orderPaid?: T;
+        fulfillmentShipped?: T;
+        orderDelivered?: T;
+        returnRequested?: T;
+        returnCompleted?: T;
+    };
     members?: T;
     updatedAt?: T;
     createdAt?: T;
@@ -9049,4 +9181,4 @@ declare module 'payload' {
     }
 }
 
-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 };
+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, Transaction as m, Fulfillment as n, Return as o };