@01.software/sdk 0.18.0 → 0.19.0

package/dist/{payload-types-Cwnj_qN4.d.cts → payload-types-DfQct8Dj.d.cts}

@@ -57,10 +57,10 @@ interface Config {
         'cart-items': CartItem;
         discounts: Discount;
         promotions: Promotion;
-        posts: Post;
-        'post-authors': PostAuthor;
-        'post-categories': PostCategory;
-        'post-tags': PostTag;
+        articles: Article;
+        'article-authors': ArticleAuthor;
+        'article-categories': ArticleCategory;
+        'article-tags': ArticleTag;
         documents: Document;
         'document-categories': DocumentCategory;
         'document-types': DocumentType;
@@ -89,12 +89,12 @@ interface Config {
         'video-categories': VideoCategory;
         'video-tags': VideoTag;
         'live-streams': LiveStream;
-        threads: Thread;
+        posts: Post;
         comments: Comment;
         reactions: Reaction;
         'reaction-types': ReactionType;
         bookmarks: Bookmark;
-        'thread-categories': ThreadCategory;
+        'post-categories': PostCategory;
         reports: Report;
         'community-bans': CommunityBan;
         'event-calendars': EventCalendar;
@@ -144,13 +144,13 @@ interface Config {
         carts: {
             items: 'cart-items';
         };
-        'post-authors': {
-            posts: 'posts';
+        'article-authors': {
+            articles: 'articles';
         };
         galleries: {
             items: 'gallery-items';
         };
-        threads: {
+        posts: {
             comments: 'comments';
         };
     };
@@ -203,10 +203,10 @@ interface Config {
         'cart-items': CartItemsSelect<false> | CartItemsSelect<true>;
         discounts: DiscountsSelect<false> | DiscountsSelect<true>;
         promotions: PromotionsSelect<false> | PromotionsSelect<true>;
-        posts: PostsSelect<false> | PostsSelect<true>;
-        'post-authors': PostAuthorsSelect<false> | PostAuthorsSelect<true>;
-        'post-categories': PostCategoriesSelect<false> | PostCategoriesSelect<true>;
-        'post-tags': PostTagsSelect<false> | PostTagsSelect<true>;
+        articles: ArticlesSelect<false> | ArticlesSelect<true>;
+        'article-authors': ArticleAuthorsSelect<false> | ArticleAuthorsSelect<true>;
+        'article-categories': ArticleCategoriesSelect<false> | ArticleCategoriesSelect<true>;
+        'article-tags': ArticleTagsSelect<false> | ArticleTagsSelect<true>;
         documents: DocumentsSelect<false> | DocumentsSelect<true>;
         'document-categories': DocumentCategoriesSelect<false> | DocumentCategoriesSelect<true>;
         'document-types': DocumentTypesSelect<false> | DocumentTypesSelect<true>;
@@ -235,12 +235,12 @@ interface Config {
         'video-categories': VideoCategoriesSelect<false> | VideoCategoriesSelect<true>;
         'video-tags': VideoTagsSelect<false> | VideoTagsSelect<true>;
         'live-streams': LiveStreamsSelect<false> | LiveStreamsSelect<true>;
-        threads: ThreadsSelect<false> | ThreadsSelect<true>;
+        posts: PostsSelect<false> | PostsSelect<true>;
         comments: CommentsSelect<false> | CommentsSelect<true>;
         reactions: ReactionsSelect<false> | ReactionsSelect<true>;
         'reaction-types': ReactionTypesSelect<false> | ReactionTypesSelect<true>;
         bookmarks: BookmarksSelect<false> | BookmarksSelect<true>;
-        'thread-categories': ThreadCategoriesSelect<false> | ThreadCategoriesSelect<true>;
+        'post-categories': PostCategoriesSelect<false> | PostCategoriesSelect<true>;
         reports: ReportsSelect<false> | ReportsSelect<true>;
         'community-bans': CommunityBansSelect<false> | CommunityBansSelect<true>;
         'event-calendars': EventCalendarsSelect<false> | EventCalendarsSelect<true>;
@@ -358,6 +358,9 @@ interface User {
     emailPreferences?: {
         acceptsUsageAlerts?: boolean | null;
     };
+    /**
+     * Admin contact phone number. Enter with or without country code according to operating policy.
+     */
     phone?: string | null;
     isPhoneVerified?: boolean | null;
     lastLoginAt?: string | null;
@@ -365,7 +368,13 @@ interface User {
     isSuspended?: boolean | null;
     suspendedAt?: string | null;
     suspendedReason?: string | null;
+    /**
+     * Timezone used for admin UI and notifications, such as Asia/Seoul.
+     */
     timezone?: string | null;
+    /**
+     * Admin UI language or locale code, such as ko or en.
+     */
     locale?: string | null;
     avatar?: (string | null) | Image;
     anonymizedAt?: string | null;
@@ -414,18 +423,21 @@ interface Tenant {
      * Features available to this tenant. Determined automatically by the plan.
      */
     features?: {
-        feature: 'ecommerce' | 'customers' | 'playlists' | 'galleries' | 'links' | 'forms' | 'posts' | 'documents' | 'canvas' | 'videos' | 'live-streaming' | 'community' | 'events';
+        feature: 'ecommerce' | 'customers' | 'playlists' | 'galleries' | 'links' | 'forms' | 'articles' | 'documents' | 'canvas' | 'videos' | 'live-streaming' | 'community' | 'events';
         provenance: string;
         id?: string | null;
     }[] | null;
     /**
      * Features this tenant has opted out of. Only effective for features granted by the plan.
      */
-    disabledFeatures?: ('ecommerce' | 'customers' | 'playlists' | 'galleries' | 'links' | 'forms' | 'posts' | 'documents' | 'canvas' | 'videos' | 'live-streaming' | 'community' | 'events')[] | null;
+    disabledFeatures?: ('ecommerce' | 'customers' | 'playlists' | 'galleries' | 'links' | 'forms' | 'articles' | 'documents' | 'canvas' | 'videos' | 'live-streaming' | 'community' | 'events')[] | null;
     /**
      * Dev mode shows configuration tools like the field settings panel. Turn off after setup for a clean production UI.
      */
     isDevMode?: boolean | null;
+    /**
+     * Tenant lifecycle status. Managed by billing webhooks, deletion scheduling, or super-admin maintenance paths, not normal edits.
+     */
     status?: ('active' | 'paused' | 'past_due' | 'canceled' | 'pending_deletion') | null;
     /**
      * A public key that is safe to include in browser code. (Starts with pk01_)
@@ -439,7 +451,7 @@ interface Tenant {
         id?: string | null;
     }[] | null;
     /**
-     * Webhook endpoints to notify on data changes.
+     * Trusted recipients for signed events. Sensitive payloads such as password-reset events may be delivered to these endpoints.
      */
     webhooks?: {
         /**
@@ -447,7 +459,7 @@ interface Tenant {
          */
         name?: string | null;
         /**
-         * The URL to send webhooks to. Must be HTTPS.
+         * HTTPS URL that receives signed webhooks. Treat this endpoint as a recipient of sensitive tenant events.
          */
         url: string;
         /**
@@ -494,6 +506,9 @@ interface Tenant {
 interface Image {
     id: string;
     tenant?: (string | null) | Tenant;
+    /**
+     * Alternative text for users who cannot see the image and for search/share context.
+     */
     alt?: string | null;
     /**
      * Low quality image placeholder
@@ -570,7 +585,7 @@ interface Image {
 interface FieldConfig {
     id: string;
     tenant?: (string | null) | Tenant;
-    collectionSlug: 'products' | 'product-variants' | 'product-options' | 'product-option-values' | 'product-collections' | 'product-categories' | 'product-tags' | 'brands' | 'discounts' | 'shipping-policies' | 'orders' | 'carts' | 'transactions' | 'fulfillments' | 'returns' | 'customers' | 'customer-groups' | 'customer-profiles' | 'post-authors' | 'posts' | 'post-categories' | 'post-tags' | 'documents' | 'document-categories' | 'document-types' | 'playlists' | 'playlist-categories' | 'playlist-tags' | 'tracks' | 'track-categories' | 'track-tags' | 'galleries' | 'gallery-categories' | 'gallery-tags' | 'gallery-items' | 'links' | 'link-categories' | 'link-tags' | 'canvases' | 'canvas-categories' | 'canvas-tags' | 'canvas-node-types' | 'canvas-edge-types' | 'videos' | 'video-categories' | 'video-tags' | 'live-streams' | 'forms' | 'threads' | 'comments' | 'reactions' | 'reaction-types' | 'bookmarks' | 'thread-categories' | 'event-calendars' | 'events' | 'event-tags' | 'event-occurrences' | 'event-registrations';
+    collectionSlug: 'products' | 'product-variants' | 'product-options' | 'product-option-values' | 'product-collections' | 'product-categories' | 'product-tags' | 'brands' | 'discounts' | 'shipping-policies' | 'orders' | 'carts' | 'transactions' | 'fulfillments' | 'returns' | 'customers' | 'customer-groups' | 'customer-profiles' | 'article-authors' | 'articles' | 'article-categories' | 'article-tags' | 'documents' | 'document-categories' | 'document-types' | 'playlists' | 'playlist-categories' | 'playlist-tags' | 'tracks' | 'track-categories' | 'track-tags' | 'galleries' | 'gallery-categories' | 'gallery-tags' | 'gallery-items' | 'links' | 'link-categories' | 'link-tags' | 'canvases' | 'canvas-categories' | 'canvas-tags' | 'canvas-node-types' | 'canvas-edge-types' | 'videos' | 'video-categories' | 'video-tags' | 'live-streams' | 'forms' | 'posts' | 'comments' | 'reactions' | 'reaction-types' | 'bookmarks' | 'post-categories' | 'event-calendars' | 'events' | 'event-tags' | 'event-occurrences' | 'event-registrations';
     isHidden?: boolean | null;
     hiddenFields?: {
         [k: string]: unknown;
@@ -585,7 +600,13 @@ interface FieldConfig {
  */
 interface SystemMedia {
     id: string;
+    /**
+     * Used for accessibility and image alternative text.
+     */
     alt?: string | null;
+    /**
+     * Caption displayed with the image.
+     */
     caption?: string | null;
     /**
      * Photographer or source attribution
@@ -638,8 +659,14 @@ interface EmailLog {
      */
     tenant?: (string | null) | Tenant;
     to: string;
+    /**
+     * Sender address passed to the email provider. Used for email audit traceability.
+     */
     from?: string | null;
     subject: string;
+    /**
+     * 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';
     status: 'sent' | 'failed';
     sentAt: string;
@@ -671,16 +698,31 @@ interface ApiKey {
      * 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.
@@ -702,16 +744,31 @@ interface PersonalAccessToken {
      */
     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;
     /**
      * 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.
@@ -733,11 +790,11 @@ interface AuditLog {
      */
     eventType: string;
     /**
-     * Actor ID
+     * Actor ID. May refer to a user or service, and can be empty for system actions.
      */
     actorId?: string | null;
     /**
-     * Event payload
+     * Detailed audit event payload. May contain sensitive security, billing, or provider context.
      */
     payload?: {
         [k: string]: unknown;
@@ -757,10 +814,13 @@ interface WebhookEvent {
      */
     provider: string;
     /**
-     * Event ID
+     * Provider-supplied event ID. Used with provider as the idempotency key for duplicate prevention.
      */
     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;
@@ -776,7 +836,13 @@ interface WebhookDelivery {
     tenant?: (string | null) | Tenant;
     webhookEventId?: (string | null) | WebhookEvent;
     attempt: number;
+    /**
+     * Webhook delivery state. Updated by dispatcher and retry handling paths.
+     */
     status: 'pending' | 'success' | 'failed' | 'dead';
+    /**
+     * Timestamp when the webhook request was dispatched to the endpoint.
+     */
     dispatchedAt?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -956,6 +1022,9 @@ interface TenantMetadatum {
 interface BrandLogo {
     id: string;
     tenant?: (string | null) | Tenant;
+    /**
+     * Alternative text for users who cannot see the image and for search/share context.
+     */
     alt?: string | null;
     /**
      * Low quality image placeholder
@@ -1086,6 +1155,9 @@ interface ApiUsage {
      * AI generation count
      */
     aiGenerationCount?: number | null;
+    /**
+     * Timestamp when the usage snapshot cron calculated this monthly aggregate.
+     */
     snapshottedAt?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -1176,7 +1248,7 @@ interface AnalyticsEventSchema {
     id: string;
     tenant?: (string | null) | Tenant;
     /**
-     * snake_case identifier. Must match /^[a-z][a-z0-9_]*$/
+     * Valid event name pattern.
      */
     eventName: string;
     enabled: boolean;
@@ -1204,13 +1276,19 @@ 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' | 'legacy_migration' | '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 for promo / trial / legacy_migration sources, optional otherwise.
+     * Entitlement end date. Required by hook validation for promo / trial / legacy_migration sources and excluded from current plan resolution after expiry.
      */
     endsAt?: string | null;
     reason?: string | null;
@@ -1263,7 +1341,7 @@ interface Subscription {
         cardType?: string | null;
     };
     /**
-     * Additional provider metadata
+     * Provider-owned diagnostic and audit metadata returned by the billing provider. Not a general manual-edit field.
      */
     providerMetadata?: {
         [k: string]: unknown;
@@ -1345,11 +1423,11 @@ interface Plan {
      */
     name: string;
     /**
-     * Features allowed for this plan
+     * Reference-only feature list; enforced elsewhere.
      */
-    featuresAllowed?: ('ecommerce' | 'customers' | 'playlists' | 'galleries' | 'links' | 'forms' | 'posts' | 'documents' | 'canvas' | 'videos' | 'live-streaming' | 'community' | 'events')[] | null;
+    featuresAllowed?: ('ecommerce' | 'customers' | 'playlists' | 'galleries' | 'links' | 'forms' | 'articles' | 'documents' | 'canvas' | 'videos' | 'live-streaming' | 'community' | 'events')[] | null;
     /**
-     * Quota limits (storageBytes, apiPerMonth, ...)
+     * Reference-only quotas such as storageBytes; enforced by entitlement and usage policy elsewhere.
      */
     quotas?: {
         [k: string]: unknown;
@@ -1397,6 +1475,9 @@ interface Webhook {
 interface TenantLogo {
     id: string;
     tenant?: (string | null) | Tenant;
+    /**
+     * Alternative text for users who cannot see the image and for search/share context.
+     */
     alt?: string | null;
     /**
      * Low quality image placeholder
@@ -1699,6 +1780,9 @@ interface Video {
     metadata?: {
         [k: string]: unknown;
     } | unknown[] | string | number | boolean | null;
+    /**
+     * Read-only counter accumulated from video view events.
+     */
     viewCount?: number | null;
     aspectRatio?: ('16_9' | '9_16' | '4_3' | '1_1') | null;
     /**
@@ -1786,7 +1870,13 @@ interface LiveStream {
     } | unknown[] | string | number | boolean | null;
     startedAt?: string | null;
     endedAt?: string | null;
+    /**
+     * Highest concurrent viewer count recorded during live sessions.
+     */
     peakViewerCount?: number | null;
+    /**
+     * Read-only counter accumulated from live stream view events.
+     */
     viewCount?: number | null;
     updatedAt: string;
     createdAt: string;
@@ -2334,9 +2424,12 @@ interface Customer {
     birthDate?: string | null;
     gender?: ('male' | 'female' | 'other' | 'prefer_not_to_say') | null;
     isGuest?: boolean | null;
+    /**
+     * Authentication provider used at signup. Immutable account provenance after creation.
+     */
     authProvider?: ('local' | 'google' | 'apple' | 'kakao' | 'naver') | null;
     /**
-     * External provider user ID
+     * External provider user ID. Paired with authProvider to identify the linked account and not edited after creation.
      */
     providerUserId?: string | null;
     lastLoginAt?: string | null;
@@ -2356,6 +2449,9 @@ interface Customer {
     };
     defaultShippingAddress?: (string | null) | CustomerAddress;
     defaultBillingAddress?: (string | null) | CustomerAddress;
+    /**
+     * Read-only counter maintained by order hooks for this customer's completed orders.
+     */
     totalOrderCount?: number | null;
     lifetimeValue?: number | null;
     firstOrderAt?: string | null;
@@ -2365,9 +2461,21 @@ interface Customer {
         hasNextPage?: boolean;
         totalDocs?: number;
     };
-    threadCount?: number | 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?: {
@@ -2393,10 +2501,25 @@ interface Customer {
          */
         consentSource?: string | null;
     };
+    /**
+     * Guardian consent evidence for a minor customer. May contain guardian PII.
+     */
     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;
@@ -2407,7 +2530,7 @@ interface Customer {
     withdrawReason?: string | null;
     withdrawnAt?: string | null;
     /**
-     * Legal retention deadline (hard-delete eligible after this date)
+     * Legal retention deadline. Retention cleanup or manual hard-delete paths may purge after this date.
      */
     retainUntil?: string | null;
     anonymizedAt?: string | null;
@@ -2418,7 +2541,7 @@ interface Customer {
     loginAttemptCount?: number | null;
     lockedUntil?: string | null;
     /**
-     * Account suspension
+     * Account suspension flag. Used with password/JWT revocation paths to block sessions.
      */
     isSuspended?: boolean | null;
     metadata?: {
@@ -2524,7 +2647,7 @@ interface CustomerProfile {
     tenant?: (string | null) | Tenant;
     customer: string | Customer;
     /**
-     * Public username shown like @01works.
+     * 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;
@@ -2560,11 +2683,14 @@ interface OrderItem {
     id: string;
     tenant?: (string | null) | Tenant;
     order: string | Order;
+    /**
+     * Quantity snapshot at order time. Used for payment and inventory calculations and not edited directly.
+     */
     product: string | Product;
     variant?: (string | null) | ProductVariant;
     quantity: number;
     /**
-     * Price per unit at time of order
+     * Unit-price snapshot at order time. Later product price changes do not rewrite it.
      */
     unitPrice: number;
     variantTitle?: string | null;
@@ -2573,7 +2699,7 @@ interface OrderItem {
     weight?: number | null;
     requiresShipping?: boolean | null;
     /**
-     * unitPrice × quantity
+     * Total-price snapshot at order time, preserved from unitPrice × quantity.
      */
     totalPrice: number;
     productTitle?: string | null;
@@ -2601,6 +2727,9 @@ interface Transaction {
     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;
     /**
      * Installment months (0 = lump sum)
@@ -2658,6 +2787,9 @@ interface Fulfillment {
      * 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)
@@ -2672,7 +2804,7 @@ interface Fulfillment {
         totalDocs?: number;
     };
     /**
-     * Internal admin notes
+     * Internal fulfillment note. Not shown directly to customers.
      */
     adminNotes?: string | null;
     metadata?: {
@@ -2711,6 +2843,9 @@ interface Return {
      */
     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
@@ -2722,7 +2857,7 @@ interface Return {
         totalDocs?: number;
     };
     /**
-     * Internal notes
+     * Internal return-processing note. Not shown directly to customers.
      */
     adminNotes?: string | null;
     completedAt?: string | null;
@@ -2921,6 +3056,9 @@ interface Discount {
      * Total usage limit (empty = unlimited)
      */
     maxUses?: number | null;
+    /**
+     * Read-only usage count accumulated when this discount is applied successfully.
+     */
     usesCount?: number | null;
     /**
      * Usage limit per customer (empty = unlimited)
@@ -2972,13 +3110,16 @@ interface Promotion {
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "posts".
+ * via the `definition` "articles".
  */
-interface Post {
+interface Article {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
     title: string;
+    /**
+     * Secondary title shown in article lists and at the top of the article page.
+     */
     subtitle?: string | null;
     /**
      * Short summary for listing/cards
@@ -2999,9 +3140,9 @@ interface Post {
         };
         [k: string]: unknown;
     } | null;
-    authors?: (string | PostAuthor)[] | null;
-    categories?: (string | PostCategory)[] | null;
-    tags?: (string | PostTag)[] | null;
+    authors?: (string | ArticleAuthor)[] | null;
+    categories?: (string | ArticleCategory)[] | null;
+    tags?: (string | ArticleTag)[] | null;
     videos?: (string | Video)[] | null;
     seo?: {
         /**
@@ -3052,14 +3193,23 @@ interface Post {
      * OG/Twitter excerpt (280 chars)
      */
     excerpt?: string | null;
+    /**
+     * Canonical URL for search engines. Leave empty to use this article URL.
+     */
     canonicalUrl?: string | null;
     visibility?: ('public' | 'members' | 'paid') | null;
+    /**
+     * Scheduled publish time. The scheduled publishing job uses this timestamp.
+     */
     scheduledAt?: string | null;
+    /**
+     * Date when featured placement should end.
+     */
     featuredUntil?: string | null;
     /**
-     * Related posts
+     * Related articles
      */
-    relatedPosts?: (string | Post)[] | null;
+    relatedArticles?: (string | Article)[] | null;
     metadata?: {
         [k: string]: unknown;
     } | unknown[] | string | number | boolean | null;
@@ -3070,9 +3220,9 @@ interface Post {
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "post-authors".
+ * via the `definition` "article-authors".
  */
-interface PostAuthor {
+interface ArticleAuthor {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
@@ -3085,8 +3235,8 @@ interface PostAuthor {
     avatar?: (string | null) | Image;
     bio?: string | null;
     email?: string | null;
-    posts?: {
-        docs?: (string | Post)[];
+    articles?: {
+        docs?: (string | Article)[];
         hasNextPage?: boolean;
         totalDocs?: number;
     };
@@ -3100,9 +3250,9 @@ interface PostAuthor {
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "post-categories".
+ * via the `definition` "article-categories".
  */
-interface PostCategory {
+interface ArticleCategory {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
@@ -3117,7 +3267,7 @@ interface PostCategory {
      */
     description?: string | null;
     image?: (string | null) | Image;
-    parent?: (string | null) | PostCategory;
+    parent?: (string | null) | ArticleCategory;
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -3125,9 +3275,9 @@ interface PostCategory {
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "post-tags".
+ * via the `definition` "article-tags".
  */
-interface PostTag {
+interface ArticleTag {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
@@ -3142,7 +3292,7 @@ interface PostTag {
      */
     description?: string | null;
     image?: (string | null) | Image;
-    parent?: (string | null) | PostTag;
+    parent?: (string | null) | ArticleTag;
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -3197,10 +3347,6 @@ interface Document {
      * Audience/timing for required agreement
      */
     agreementScope?: ('all_users' | 'new_users' | 'on_update') | null;
-    /**
-     * Legacy compatibility field; replaced by agreementScope
-     */
-    requiresAgreement?: boolean | null;
     /**
      * Keywords for search (e.g. GDPR, CCPA)
      */
@@ -3248,6 +3394,9 @@ interface Document {
     slug?: string | null;
     type?: (string | null) | DocumentType;
     jurisdiction?: string | null;
+    /**
+     * Document language code. Defaults to ko and is used for display and search categorization.
+     */
     language?: string | null;
     /**
      * Document that supersedes this one
@@ -3759,10 +3908,25 @@ interface Link {
     thumbnail?: (string | null) | Image;
     icon?: (string | null) | Image;
     publishedAt?: string | null;
+    /**
+     * Platform name for social or external links, such as Instagram or YouTube.
+     */
     platform?: string | null;
+    /**
+     * Whether clicks should open this link in a new tab.
+     */
     opensInNewTab?: boolean | null;
+    /**
+     * Controls whether rel=nofollow should be emitted for search engines.
+     */
     noFollow?: boolean | null;
+    /**
+     * Link exposure expiration time. Can be used to stop showing the link after this timestamp.
+     */
     expiresAt?: string | null;
+    /**
+     * Read-only counter accumulated from link click events.
+     */
     clickCount?: number | null;
     lastClickedAt?: string | null;
     status?: ('draft' | 'published' | 'archived') | null;
@@ -3995,11 +4159,11 @@ interface CanvasNodeType {
         id?: string | null;
     }[] | null;
     /**
-     * React component code. Props: { fields, label, color, nodeTypeSlug, width, height }
+     * Runtime JSX template. Props: { fields, label, color, nodeTypeSlug, width, height }. Save-time validation rejects blocked patterns.
      */
     template?: string | null;
     /**
-     * CSS for node. Selector: .flow-node--{slug}
+     * CSS for this node. Scope selectors to .flow-node--{slug}; url/import/script patterns are rejected on save.
      */
     customCSS?: string | null;
     updatedAt: string;
@@ -4113,9 +4277,9 @@ interface CanvasEdge {
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "threads".
+ * via the `definition` "posts".
  */
-interface Thread {
+interface Post {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
@@ -4135,7 +4299,7 @@ interface Thread {
         };
         [k: string]: unknown;
     } | null;
-    categories?: (string | ThreadCategory)[] | null;
+    categories?: (string | PostCategory)[] | null;
     comments?: {
         docs?: (string | Comment)[];
         hasNextPage?: boolean;
@@ -4156,17 +4320,38 @@ interface Thread {
         avatarUrl?: string | null;
     };
     moderationStatus?: ('pending' | 'approved' | 'rejected' | 'reported' | 'hidden') | null;
+    /**
+     * Read-only counter accumulated from post view events.
+     */
     viewCount?: number | null;
+    /**
+     * Read-only counter maintained by hooks for comments on this post.
+     */
     commentCount?: number | null;
+    /**
+     * Read-only counter maintained by hooks for reactions on this post.
+     */
     reactionCount?: number | null;
+    /**
+     * Accumulated report count for this post. Used only as a moderation signal.
+     */
     reportCount?: number | null;
+    /**
+     * Marks whether this post should be pinned at the top of community lists.
+     */
     isPinned?: boolean | null;
+    /**
+     * Controls whether new comments can be created for this post.
+     */
     allowsComments?: boolean | null;
     visibility?: ('visible' | 'hidden') | null;
     /**
      * Lock comments
      */
     isLocked?: boolean | null;
+    /**
+     * Last comment or activity timestamp. Updated server-side for sorting and activity indicators.
+     */
     lastActivityAt?: string | null;
     lastCommentByProfile?: (string | null) | CustomerProfile;
     isFeatured?: boolean | null;
@@ -4180,9 +4365,9 @@ interface Thread {
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "thread-categories".
+ * via the `definition` "post-categories".
  */
-interface ThreadCategory {
+interface PostCategory {
     id: string;
     _order?: string | null;
     tenant?: (string | null) | Tenant;
@@ -4197,7 +4382,7 @@ interface ThreadCategory {
      */
     description?: string | null;
     image?: (string | null) | Image;
-    parent?: (string | null) | ThreadCategory;
+    parent?: (string | null) | PostCategory;
     color?: string | null;
     updatedAt: string;
     createdAt: string;
@@ -4210,7 +4395,7 @@ interface ThreadCategory {
 interface Comment {
     id: string;
     tenant?: (string | null) | Tenant;
-    thread: string | Thread;
+    post: string | Post;
     authorProfile: string | CustomerProfile;
     authorSnapshot: {
         displayName: string;
@@ -4220,15 +4405,30 @@ interface Comment {
     };
     body?: string | null;
     parent?: (string | null) | Comment;
+    /**
+     * Comment nesting depth. Calculated server-side from parent/rootComment and not edited directly.
+     */
     depth?: number | null;
+    /**
+     * Root comment for the thread. Server-managed relationship for efficient reply-tree lookup.
+     */
     rootComment?: (string | null) | Comment;
     status?: ('published' | 'hidden' | 'removed') | null;
     moderationStatus?: ('pending' | 'approved' | 'rejected' | 'reported') | null;
     visibility?: ('visible' | 'hidden' | 'removed') | null;
     editedAt?: string | null;
     isEdited?: boolean | null;
+    /**
+     * Read-only counter maintained by hooks for reactions on this comment.
+     */
     reactionCount?: number | null;
+    /**
+     * Accumulated report count for this comment. Used only as a moderation signal.
+     */
     reportCount?: number | null;
+    /**
+     * Read-only counter for replies to this comment, maintained by hooks.
+     */
     replyCount?: number | null;
     metadata?: {
         [k: string]: unknown;
@@ -4243,7 +4443,7 @@ interface Comment {
 interface Reaction {
     id: string;
     tenant?: (string | null) | Tenant;
-    thread?: (string | null) | Thread;
+    post?: (string | null) | Post;
     comment?: (string | null) | Comment;
     actorProfile: string | CustomerProfile;
     type: string | ReactionType;
@@ -4289,7 +4489,7 @@ interface ReactionType {
 interface Bookmark {
     id: string;
     tenant?: (string | null) | Tenant;
-    thread: string | Thread;
+    post: string | Post;
     customer: string | Customer;
     metadata?: {
         [k: string]: unknown;
@@ -4304,7 +4504,7 @@ interface Bookmark {
 interface Report {
     id: string;
     tenant?: (string | null) | Tenant;
-    target?: (string | null) | Thread;
+    target?: (string | null) | Post;
     targetComment?: (string | null) | Comment;
     customer: string | Customer;
     reason: 'spam' | 'harassment' | 'inappropriate' | 'off-topic' | 'other';
@@ -4599,6 +4799,9 @@ interface EventOccurrence {
     timezone: string;
     isAllDay?: boolean | null;
     status: 'scheduled' | 'canceled' | 'completed';
+    /**
+     * Location override for this occurrence only. Leave empty to use the event default location.
+     */
     locationOverride?: {
         name?: string | null;
         address?: string | null;
@@ -4606,6 +4809,9 @@ interface EventOccurrence {
         note?: string | null;
         privateNote?: string | null;
     };
+    /**
+     * Capacity for this occurrence. Leave empty to inherit the event default registration settings.
+     */
     capacity?: number | null;
     registrationCount?: number | null;
     waitlistCount?: number | null;
@@ -4636,18 +4842,33 @@ interface EventRegistration {
     customer?: (string | null) | Customer;
     registrationStatus: 'pending' | 'going' | 'waitlisted' | 'declined' | 'canceled';
     attendanceStatus: 'not_checked_in' | 'checked_in' | 'no_show';
+    /**
+     * Number of attendees for this registration. Used for ticketing and capacity calculations.
+     */
     quantity: number;
+    /**
+     * PII snapshot captured at registration time. Hidden from publishable-key reads and subject to retention cleanup.
+     */
     attendeeSnapshot?: {
         name?: string | null;
         email?: string | null;
         phone?: string | null;
     };
+    /**
+     * Internal attendee email. This is PII and is hidden from publishable-key reads.
+     */
     attendeeEmail?: string | null;
+    /**
+     * Internal answers to registration questions. Hidden from publishable-key reads.
+     */
     answers?: {
         question?: string | null;
         answer?: string | null;
         id?: string | null;
     }[] | null;
+    /**
+     * Manual approval data, including approval time, approver, and internal note.
+     */
     approval?: {
         approvedAt?: string | null;
         approvedBy?: (string | null) | User;
@@ -4661,9 +4882,21 @@ interface EventRegistration {
         checkedInAt?: string | null;
         checkedInBy?: (string | null) | User;
     };
+    /**
+     * Hash of the guest access token. It is not the raw token and cannot be revealed or recovered by operators.
+     */
     guestTokenHash?: string | null;
+    /**
+     * Guest token expiration timestamp. Used internally to decide token validity.
+     */
     guestTokenExpiresAt?: string | null;
+    /**
+     * Retention deadline for attendee PII. Cleanup may redact PII after this timestamp.
+     */
     piiRetentionUntil?: string | null;
+    /**
+     * Timestamp when PII was actually redacted. Written by the retention cleanup path.
+     */
     piiRedactedAt?: string | null;
     metadata?: {
         [k: string]: unknown;
@@ -5023,17 +5256,17 @@ interface PayloadLockedDocument {
         relationTo: 'promotions';
         value: string | Promotion;
     } | null) | ({
-        relationTo: 'posts';
-        value: string | Post;
+        relationTo: 'articles';
+        value: string | Article;
     } | null) | ({
-        relationTo: 'post-authors';
-        value: string | PostAuthor;
+        relationTo: 'article-authors';
+        value: string | ArticleAuthor;
     } | null) | ({
-        relationTo: 'post-categories';
-        value: string | PostCategory;
+        relationTo: 'article-categories';
+        value: string | ArticleCategory;
     } | null) | ({
-        relationTo: 'post-tags';
-        value: string | PostTag;
+        relationTo: 'article-tags';
+        value: string | ArticleTag;
     } | null) | ({
         relationTo: 'documents';
         value: string | Document;
@@ -5119,8 +5352,8 @@ interface PayloadLockedDocument {
         relationTo: 'live-streams';
         value: string | LiveStream;
     } | null) | ({
-        relationTo: 'threads';
-        value: string | Thread;
+        relationTo: 'posts';
+        value: string | Post;
     } | null) | ({
         relationTo: 'comments';
         value: string | Comment;
@@ -5134,8 +5367,8 @@ interface PayloadLockedDocument {
         relationTo: 'bookmarks';
         value: string | Bookmark;
     } | null) | ({
-        relationTo: 'thread-categories';
-        value: string | ThreadCategory;
+        relationTo: 'post-categories';
+        value: string | PostCategory;
     } | null) | ({
         relationTo: 'reports';
         value: string | Report;
@@ -6480,7 +6713,7 @@ interface CustomersSelect<T extends boolean = true> {
     firstOrderAt?: T;
     lastOrderAt?: T;
     profile?: T;
-    threadCount?: T;
+    postCount?: T;
     commentCount?: T;
     reactionCount?: T;
     isMinor?: T;
@@ -6703,9 +6936,9 @@ interface PromotionsSelect<T extends boolean = true> {
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "posts_select".
+ * via the `definition` "articles_select".
  */
-interface PostsSelect<T extends boolean = true> {
+interface ArticlesSelect<T extends boolean = true> {
     _order?: T;
     tenant?: T;
     title?: T;
@@ -6739,7 +6972,7 @@ interface PostsSelect<T extends boolean = true> {
     visibility?: T;
     scheduledAt?: T;
     featuredUntil?: T;
-    relatedPosts?: T;
+    relatedArticles?: T;
     metadata?: T;
     updatedAt?: T;
     createdAt?: T;
@@ -6748,9 +6981,9 @@ interface PostsSelect<T extends boolean = true> {
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "post-authors_select".
+ * via the `definition` "article-authors_select".
  */
-interface PostAuthorsSelect<T extends boolean = true> {
+interface ArticleAuthorsSelect<T extends boolean = true> {
     _order?: T;
     tenant?: T;
     name?: T;
@@ -6759,7 +6992,7 @@ interface PostAuthorsSelect<T extends boolean = true> {
     avatar?: T;
     bio?: T;
     email?: T;
-    posts?: T;
+    articles?: T;
     isActive?: T;
     metadata?: T;
     updatedAt?: T;
@@ -6768,9 +7001,9 @@ interface PostAuthorsSelect<T extends boolean = true> {
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "post-categories_select".
+ * via the `definition` "article-categories_select".
  */
-interface PostCategoriesSelect<T extends boolean = true> {
+interface ArticleCategoriesSelect<T extends boolean = true> {
     _order?: T;
     tenant?: T;
     title?: T;
@@ -6786,9 +7019,9 @@ interface PostCategoriesSelect<T extends boolean = true> {
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "post-tags_select".
+ * via the `definition` "article-tags_select".
  */
-interface PostTagsSelect<T extends boolean = true> {
+interface ArticleTagsSelect<T extends boolean = true> {
     _order?: T;
     tenant?: T;
     title?: T;
@@ -6818,7 +7051,6 @@ interface DocumentsSelect<T extends boolean = true> {
     expiresAt?: T;
     changeLog?: T;
     agreementScope?: T;
-    requiresAgreement?: T;
     keywords?: T | {
         keyword?: T;
         id?: T;
@@ -7509,9 +7741,9 @@ interface LiveStreamsSelect<T extends boolean = true> {
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "threads_select".
+ * via the `definition` "posts_select".
  */
-interface ThreadsSelect<T extends boolean = true> {
+interface PostsSelect<T extends boolean = true> {
     _order?: T;
     tenant?: T;
     title?: T;
@@ -7553,7 +7785,7 @@ interface ThreadsSelect<T extends boolean = true> {
  */
 interface CommentsSelect<T extends boolean = true> {
     tenant?: T;
-    thread?: T;
+    post?: T;
     authorProfile?: T;
     authorSnapshot?: T | {
         displayName?: T;
@@ -7583,7 +7815,7 @@ interface CommentsSelect<T extends boolean = true> {
  */
 interface ReactionsSelect<T extends boolean = true> {
     tenant?: T;
-    thread?: T;
+    post?: T;
     comment?: T;
     actorProfile?: T;
     type?: T;
@@ -7614,7 +7846,7 @@ interface ReactionTypesSelect<T extends boolean = true> {
  */
 interface BookmarksSelect<T extends boolean = true> {
     tenant?: T;
-    thread?: T;
+    post?: T;
     customer?: T;
     metadata?: T;
     updatedAt?: T;
@@ -7622,9 +7854,9 @@ interface BookmarksSelect<T extends boolean = true> {
 }
 /**
  * This interface was referenced by `Config`'s JSON-Schema
- * via the `definition` "thread-categories_select".
+ * via the `definition` "post-categories_select".
  */
-interface ThreadCategoriesSelect<T extends boolean = true> {
+interface PostCategoriesSelect<T extends boolean = true> {
     _order?: T;
     tenant?: T;
     title?: T;
@@ -8075,4 +8307,4 @@ declare module 'payload' {
     }
 }
 
-export type { Config as C, Document as D, Form as F, Image as I, Order as O, Product as P, Return as R, Transaction as T, Video as V, Cart as a, CartItem as b, OrderItem as c, Fulfillment as d, Post as e, PostCategory as f, PostTag as g, ProductVariant as h, Tenant as i, CustomerProfile as j, Thread as k, Comment as l, Reaction as m };
+export type { Article as A, Config as C, Document as D, Form as F, Image as I, Order as O, Product as P, Return as R, Transaction as T, Video as V, Cart as a, CartItem as b, OrderItem as c, Fulfillment as d, ArticleAuthor as e, ArticleCategory as f, ArticleTag as g, Post as h, PostCategory as i, ProductVariant as j, Tenant as k, CustomerProfile as l, Comment as m, Reaction as n };