@xhub-short/contracts 0.1.0-beta.1 → 0.1.0-beta.2

package/dist/index.d.ts

@@ -190,6 +190,13 @@ interface SessionSnapshot {
      * Backup for focusedIndex in case feed order changed
      */
     currentVideoId?: string;
+    /**
+     * Captured video frame at playback position (base64 JPEG)
+     * Used to show instant preview while video loads on restore
+     * Only saved when restorePlaybackPosition config is enabled
+     * Max size: ~100KB (compressed JPEG, quality 60%)
+     */
+    restoreFrame?: string;
     /** Snapshot creation time */
     savedAt: number;
     /** SDK version for compatibility checking */
@@ -287,6 +294,236 @@ interface LogEntry {
     stack?: string;
 }
 
+/**
+ * Comment Feature Types
+ * Supports nested replies (1 level), pagination, and optimistic updates
+ */
+/**
+ * Full comment item with replies support
+ */
+interface CommentItem {
+    /** Unique comment ID */
+    id: string;
+    /** Video ID this comment belongs to */
+    videoId: string;
+    /** Comment text content */
+    content: string;
+    /** Comment author */
+    author: CommentAuthor;
+    /** Like count */
+    likeCount: number;
+    /** Whether current user liked this comment */
+    isLiked: boolean;
+    /** Total reply count */
+    replyCount: number;
+    /** Loaded replies (may be partial) */
+    replies?: ReplyItem[];
+    /** Cursor for loading more replies */
+    repliesCursor?: string | null;
+    /** Whether all replies are loaded */
+    repliesLoaded?: boolean;
+    /** Creation timestamp (ISO 8601) */
+    createdAt: string;
+    /** Last updated timestamp (ISO 8601) */
+    updatedAt?: string;
+    /** Whether this is user's own comment (for edit/delete) */
+    isOwner?: boolean;
+    /** Whether this comment is pending (optimistic) */
+    isPending?: boolean;
+    /** Optional: Parent comment ID (for flat list with parent reference) */
+    parentId?: string | null;
+    /** Whether this comment is pinned by video author */
+    isPinned?: boolean;
+}
+/**
+ * Reply item (Level 1 nested comment)
+ */
+interface ReplyItem {
+    /** Unique reply ID */
+    id: string;
+    /** Parent comment ID */
+    parentId: string;
+    /** Reply text content */
+    content: string;
+    /** Reply author */
+    author: CommentAuthor;
+    /** Like count */
+    likeCount: number;
+    /** Whether current user liked this reply */
+    isLiked: boolean;
+    /** User being replied to (for @mention) */
+    replyTo?: CommentAuthor;
+    /** Creation timestamp (ISO 8601) */
+    createdAt: string;
+    /** Whether this is user's own reply */
+    isOwner?: boolean;
+    /** Whether this reply is pending (optimistic) */
+    isPending?: boolean;
+}
+/**
+ * Comment author (may differ from video Author)
+ */
+interface CommentAuthor {
+    /** Unique author ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Avatar URL */
+    avatar?: string;
+    /** Verified status */
+    isVerified?: boolean;
+    /** Additional badge (e.g., "Creator", "Top Fan") */
+    badge?: string;
+}
+/**
+ * Response for listing comments
+ */
+interface CommentListResponse {
+    /** List of comments */
+    items: CommentItem[];
+    /** Total comment count for this video */
+    totalCount: number;
+    /** Cursor for next page (null if no more) */
+    nextCursor: string | null;
+    /** Whether there are more comments */
+    hasMore: boolean;
+}
+/**
+ * Response for listing replies
+ */
+interface ReplyListResponse {
+    /** List of replies */
+    items: ReplyItem[];
+    /** Parent comment ID */
+    parentId: string;
+    /** Cursor for next page */
+    nextCursor: string | null;
+    /** Whether there are more replies */
+    hasMore: boolean;
+}
+/**
+ * Payload for posting a new comment
+ */
+interface PostCommentPayload {
+    /** Video ID */
+    videoId: string;
+    /** Comment content */
+    content: string;
+}
+/**
+ * Payload for posting a reply
+ */
+interface PostReplyPayload {
+    /** Video ID */
+    videoId: string;
+    /** Parent comment ID */
+    parentId: string;
+    /** Reply content */
+    content: string;
+    /** Optional: User being replied to */
+    replyToUserId?: string;
+}
+/**
+ * Payload for editing a comment/reply
+ */
+interface EditCommentPayload {
+    /** Comment/Reply ID */
+    id: string;
+    /** New content */
+    content: string;
+}
+/**
+ * Payload for deleting a comment/reply
+ */
+interface DeleteCommentPayload {
+    /** Comment/Reply ID */
+    id: string;
+    /** Whether this is a reply (affects API endpoint) */
+    isReply?: boolean;
+    /** Parent comment ID (required if isReply) */
+    parentId?: string;
+}
+/**
+ * Payload for reporting a comment
+ */
+interface ReportCommentPayload {
+    /** Comment/Reply ID */
+    id: string;
+    /** Report reason */
+    reason: CommentReportReason;
+    /** Additional description */
+    description?: string;
+}
+/**
+ * Comment report reasons
+ */
+type CommentReportReason = 'spam' | 'harassment' | 'hate_speech' | 'misinformation' | 'inappropriate' | 'other';
+/**
+ * Comment state for a single video
+ */
+interface CommentState {
+    /** Video ID */
+    videoId: string;
+    /** Comments map by ID */
+    commentsMap: Map<string, CommentItem>;
+    /** Ordered comment IDs */
+    orderedIds: string[];
+    /** Total count from API */
+    totalCount: number;
+    /** Pagination cursor */
+    cursor: string | null;
+    /** Whether more comments can be loaded */
+    hasMore: boolean;
+    /** Loading state */
+    isLoading: boolean;
+    /** Loading more state */
+    isLoadingMore: boolean;
+    /** Error state */
+    error: Error | null;
+    /** Cache timestamp for TTL */
+    cachedAt: number;
+}
+/**
+ * Global comment manager state
+ */
+interface CommentManagerState {
+    /** Comments by video ID */
+    commentsByVideo: Map<string, CommentState>;
+    /** Currently active video ID (for comment sheet) */
+    activeVideoId: string | null;
+    /** Posting state */
+    isPosting: boolean;
+    /** Posting error */
+    postError: Error | null;
+}
+/**
+ * Comment feature configuration
+ */
+interface CommentConfig {
+    /** Comments per page (default: 20) */
+    pageSize: number;
+    /** Replies per page (default: 10) */
+    replyPageSize: number;
+    /** Cache TTL in ms (default: 5 minutes) */
+    cacheTTL: number;
+    /** Auto-expand threshold for replies (default: 1) */
+    repliesAutoExpandThreshold: number;
+    /** Replies collapse limit (default: 3) */
+    repliesCollapseLimit: number;
+    /** Comment text max lines before collapse (default: 3) */
+    textMaxLines: number;
+    /** Input max length (default: 500) */
+    inputMaxLength: number;
+    /** Enable optimistic UI (default: true) */
+    enableOptimisticUI: boolean;
+    /** Require delete confirmation (default: true) */
+    requireDeleteConfirm: boolean;
+}
+/**
+ * Default comment configuration
+ */
+declare const DEFAULT_COMMENT_CONFIG: CommentConfig;
+
 /**
  * IDataSource - Data Port Interface
  *
@@ -472,6 +709,39 @@ interface IInteraction {
     report?(videoId: string, reason: string, description?: string): Promise<void>;
 }
 
+/**
+ * Data structure for prefetch cache
+ *
+ * Stored in localStorage for instant feed loading on fresh app open.
+ * Contains video metadata (NOT video data) for immediate display.
+ *
+ * @example
+ * ```typescript
+ * const cacheData: PrefetchCacheData = {
+ *   items: [video1, video2, ...], // Last N videos from feed
+ *   savedAt: Date.now(),
+ *   cursor: 'abc123',
+ * };
+ * await storage.set('sv-prefetch-cache', cacheData);
+ * ```
+ */
+interface PrefetchCacheData {
+    /**
+     * Cached video items (tail of feed - videos user hasn't seen)
+     * These are shown instantly on fresh load
+     */
+    items: VideoItem[];
+    /**
+     * Timestamp when cache was saved
+     * Used for debugging and potential TTL features
+     */
+    savedAt: number;
+    /**
+     * Pagination cursor for continuing from cached position
+     * Allows loadMore() to work correctly after hydrating from cache
+     */
+    cursor: string | null;
+}
 /**
  * IStorage - Storage Port Interface
  *
@@ -1043,6 +1313,258 @@ interface IPosterLoader {
     clearCache(): void;
 }
 
+/**
+ * Comment Adapter Interface (Port)
+ * Defines the contract for comment data operations
+ * Host app can implement this interface or use preset REST adapter
+ */
+
+/**
+ * Comment adapter interface (Port in Hexagonal Architecture)
+ * All comment operations go through this interface
+ */
+interface ICommentAdapter {
+    /**
+     * Get comments for a video
+     * @param videoId - Video ID
+     * @param cursor - Pagination cursor (null for first page)
+     * @param limit - Number of comments per page
+     * @returns Paginated comment list
+     */
+    getComments(videoId: string, cursor?: string | null, limit?: number): Promise<CommentListResponse>;
+    /**
+     * Get replies for a comment
+     * @param commentId - Parent comment ID
+     * @param cursor - Pagination cursor
+     * @param limit - Number of replies per page
+     * @returns Paginated reply list
+     */
+    getReplies(commentId: string, cursor?: string | null, limit?: number): Promise<ReplyListResponse>;
+    /**
+     * Post a new comment
+     * @param payload - Comment data
+     * @returns Created comment
+     */
+    postComment(payload: PostCommentPayload): Promise<CommentItem>;
+    /**
+     * Post a reply to a comment
+     * @param payload - Reply data
+     * @returns Created reply
+     */
+    postReply(payload: PostReplyPayload): Promise<ReplyItem>;
+    /**
+     * Edit an existing comment/reply
+     * @param payload - Edit data
+     * @returns Updated comment/reply
+     */
+    editComment(payload: EditCommentPayload): Promise<CommentItem | ReplyItem>;
+    /**
+     * Delete a comment/reply
+     * @param payload - Delete data
+     */
+    deleteComment(payload: DeleteCommentPayload): Promise<void>;
+    /**
+     * Like a comment/reply
+     * @param id - Comment/Reply ID
+     */
+    likeComment(id: string): Promise<void>;
+    /**
+     * Unlike a comment/reply
+     * @param id - Comment/Reply ID
+     */
+    unlikeComment(id: string): Promise<void>;
+    /**
+     * Report a comment/reply
+     * @param payload - Report data
+     */
+    reportComment(payload: ReportCommentPayload): Promise<void>;
+}
+/**
+ * Configuration for REST Comment Adapter
+ */
+interface CommentAdapterConfig {
+    /** Base URL for API */
+    baseUrl: string;
+    /** API endpoints */
+    endpoints: CommentEndpoints;
+    /** Custom headers getter */
+    getHeaders?: () => Promise<Record<string, string>> | Record<string, string>;
+    /** Custom params to include in all requests */
+    customParams?: Record<string, string>;
+    /** Response transformers */
+    transformers?: CommentTransformers;
+}
+/**
+ * Comment API endpoints configuration
+ */
+interface CommentEndpoints {
+    /** Get comments: GET /videos/:videoId/comments */
+    list: string;
+    /** Get replies: GET /comments/:commentId/replies */
+    replies: string;
+    /** Post comment: POST /videos/:videoId/comments */
+    post: string;
+    /** Post reply: POST /comments/:commentId/replies */
+    postReply: string;
+    /** Edit comment: PATCH /comments/:id */
+    edit: string;
+    /** Delete comment: DELETE /comments/:id */
+    delete: string;
+    /** Like comment: POST /comments/:id/like */
+    like: string;
+    /** Unlike comment: DELETE /comments/:id/like */
+    unlike: string;
+    /** Report comment: POST /comments/:id/report */
+    report: string;
+}
+/**
+ * Default endpoints (RESTful convention)
+ */
+declare const DEFAULT_COMMENT_ENDPOINTS: CommentEndpoints;
+/**
+ * Response transformers for custom API formats
+ */
+interface CommentTransformers {
+    /** Transform API response to CommentListResponse */
+    commentList?: (raw: unknown) => CommentListResponse;
+    /** Transform API response to ReplyListResponse */
+    replyList?: (raw: unknown) => ReplyListResponse;
+    /** Transform API response to CommentItem */
+    comment?: (raw: unknown) => CommentItem;
+    /** Transform API response to ReplyItem */
+    reply?: (raw: unknown) => ReplyItem;
+}
+/**
+ * Configuration for Mock Comment Adapter (testing/demo)
+ */
+interface MockCommentAdapterConfig {
+    /** Simulated delay in ms (default: 500) */
+    delay?: number;
+    /** Initial comments per video */
+    initialComments?: CommentItem[];
+    /** Simulate errors */
+    simulateErrors?: boolean;
+    /** Error rate (0-1, default: 0.1) */
+    errorRate?: number;
+}
+
+/**
+ * @xhub-short/contracts - Localization Types
+ *
+ * Lightweight i18n support with ICU-like message format.
+ * Custom implementation - NO external dependencies.
+ *
+ * Supported ICU features:
+ * - Simple interpolation: {name}
+ * - Plural: {count, plural, =0 {none} one {# item} other {# items}}
+ * - Select: {key, select, value1 {text1} other {text2}}
+ */
+/**
+ * Values that can be interpolated into messages
+ */
+type MessageValue = string | number | boolean;
+/**
+ * Record of values for message interpolation
+ */
+type MessageValues = Record<string, MessageValue>;
+/**
+ * All supported message keys
+ *
+ * Using dot notation for namespacing:
+ * - feed.* : Video feed related
+ * - player.* : Video player related
+ * - comment.* : Comment section related
+ * - action.* : User actions (like, share, follow)
+ * - time.* : Relative time formatting
+ * - number.* : Number formatting suffixes
+ * - error.* : Generic errors
+ */
+type MessageKey = 'feed.loading' | 'feed.empty' | 'feed.endReached' | 'feed.error' | 'feed.retry' | 'player.loading' | 'player.error' | 'player.error.network' | 'player.error.decode' | 'player.error.notSupported' | 'player.error.aborted' | 'player.tapToRetry' | 'comment.title' | 'comment.placeholder' | 'comment.empty' | 'comment.loading' | 'comment.error' | 'comment.retry' | 'comment.post' | 'comment.reply' | 'comment.replyTo' | 'comment.viewReplies' | 'comment.hideReplies' | 'comment.loadReplies' | 'comment.viewMoreReplies' | 'comment.delete' | 'comment.report' | 'comment.count' | 'comment.replyCount' | 'comment.expand' | 'comment.collapse' | 'action.like' | 'action.liked' | 'action.comment' | 'action.share' | 'action.bookmark' | 'action.bookmarked' | 'action.follow' | 'action.following' | 'time.now' | 'time.seconds' | 'time.minutes' | 'time.hours' | 'time.days' | 'time.weeks' | 'time.months' | 'time.years' | 'number.thousand' | 'number.million' | 'number.billion' | 'error.generic' | 'error.network' | 'error.timeout' | 'cancel' | 'close' | 'ok' | 'done' | 'aria.loading' | 'aria.videoPlayer' | 'aria.retry' | 'aria.sortComments' | 'aria.closeComments' | 'aria.addMedia' | 'aria.submitComment' | 'aria.openEmoji' | 'aria.cancelReply';
+/**
+ * Complete message catalog type
+ * All keys must be present
+ */
+type MessageCatalog = Record<MessageKey, string>;
+/**
+ * Partial catalog for overrides
+ */
+type PartialMessageCatalog = Partial<MessageCatalog>;
+/**
+ * Localization Port - Core interface for i18n
+ *
+ * Adapters must implement this interface.
+ * SDK provides default implementation with built-in ICU-like parser.
+ */
+interface ILocalization {
+    /**
+     * Current locale (BCP 47 tag, e.g., 'en', 'vi', 'zh-CN')
+     */
+    readonly locale: string;
+    /**
+     * Translate a message key
+     *
+     * @param key - Message key from catalog
+     * @param values - Optional interpolation values
+     * @returns Translated string
+     *
+     * @example
+     * // Simple
+     * t('feed.loading') // "Loading..."
+     *
+     * // Interpolation
+     * t('comment.replyTo', { name: 'John' }) // "Replying to John"
+     *
+     * // Plural
+     * t('comment.count', { count: 5 }) // "5 comments"
+     */
+    t(key: MessageKey, values?: MessageValues): string;
+    /**
+     * Format a number with locale-aware separators
+     *
+     * @param value - Number to format
+     * @returns Formatted string (e.g., "1,234" or "1.234")
+     */
+    formatNumber(value: number): string;
+    /**
+     * Format a number in compact form (1K, 1M, 1B)
+     *
+     * @param value - Number to format
+     * @returns Compact string (e.g., "15K", "1.2M")
+     */
+    formatCompact(value: number): string;
+    /**
+     * Format relative time (e.g., "2 hours ago")
+     *
+     * @param date - Date or timestamp
+     * @returns Relative time string
+     */
+    formatRelativeTime(date: Date | number): string;
+}
+/**
+ * Localization configuration for SDK
+ */
+interface LocalizationConfig {
+    /**
+     * Locale code (BCP 47)
+     * @default 'en'
+     */
+    locale?: string;
+    /**
+     * Custom messages to override defaults
+     */
+    messages?: PartialMessageCatalog;
+    /**
+     * Fallback locale when translation not found
+     * @default 'en'
+     */
+    fallbackLocale?: string;
+    /**
+     * Custom localization adapter (for integration with existing i18n systems)
+     * If provided, SDK will use this instead of built-in implementation
+     */
+    adapter?: ILocalization;
+}
+
 /**
  * UI Component Types for XHub-short SDK
  *
@@ -1287,6 +1809,12 @@ interface VideoSlotHeadlessProps {
     onVisible?: () => void;
     /** Called when video becomes hidden */
     onHidden?: () => void;
+    /**
+     * Restore frame for session restoration.
+     * Base64 JPEG data URL of the video frame at restore position.
+     * Displayed as instant preview while video loads.
+     */
+    restoreFrame?: string;
 }
 /**
  * VideoPlayer headless component props
@@ -1538,6 +2066,189 @@ interface VideoInfoProps extends Omit<VideoInfoHeadlessProps, 'videoInfoState' |
     /** Called when location is clicked */
     onLocationClick?: () => void;
 }
+
+/**
+ * Comment state from useComment() hook
+ */
+interface UICommentState {
+    /** Comments for current video */
+    comments: CommentItem[];
+    /** Total comment count */
+    totalCount: number;
+    /** Whether comments are loading */
+    isLoading: boolean;
+    /** Whether more comments are loading */
+    isLoadingMore: boolean;
+    /** Whether there are more comments */
+    hasMore: boolean;
+    /** Error if any */
+    error: Error | null;
+    /** Whether currently posting a comment */
+    isPosting: boolean;
+    /** Config */
+    config: CommentConfig;
+}
+/**
+ * Comment actions from useComment() hook
+ */
+interface UICommentActions {
+    /** Load comments for a video */
+    loadComments: (videoId: string) => Promise<void>;
+    /** Load more comments */
+    loadMore: () => Promise<void>;
+    /** Post a new comment */
+    postComment: (content: string) => Promise<void>;
+    /** Post a reply */
+    postReply: (parentId: string, content: string, replyTo?: CommentAuthor) => Promise<void>;
+    /** Edit a comment/reply */
+    editComment: (id: string, content: string) => Promise<void>;
+    /** Delete a comment/reply */
+    deleteComment: (id: string, isReply?: boolean, parentId?: string) => Promise<void>;
+    /** Like a comment/reply */
+    likeComment: (id: string) => Promise<void>;
+    /** Unlike a comment/reply */
+    unlikeComment: (id: string) => Promise<void>;
+    /** Load replies for a comment */
+    loadReplies: (commentId: string) => Promise<void>;
+    /** Report a comment */
+    reportComment: (id: string, reason: string) => Promise<void>;
+    /** Refresh comments */
+    refresh: () => Promise<void>;
+}
+/**
+ * Comment sheet headless component props
+ */
+interface CommentSheetHeadlessProps {
+    /** Comment state */
+    commentState: UICommentState;
+    /** Comment actions */
+    commentActions: UICommentActions;
+    /** Video ID for comments */
+    videoId: string;
+    /** Whether sheet is open */
+    isOpen: boolean;
+    /** Close handler */
+    onClose: () => void;
+    /** Current user for posting (optional - show input only if provided) */
+    currentUser?: CommentAuthor;
+    /** Sheet height as percentage (0-1, default: 0.65) */
+    sheetHeight?: number;
+    /** Animation duration in ms (default: 300) */
+    animationDuration?: number;
+    /** Emoji bar config (optional) */
+    emojiBar?: {
+        enabled?: boolean;
+        emojis?: string[];
+    };
+    /** Custom header content */
+    headerContent?: UINode;
+    /** Custom empty state */
+    emptyContent?: UINode;
+    /** Custom loading state */
+    loadingContent?: UINode;
+    /** Custom error state */
+    errorContent?: UINode;
+    /** Additional class name */
+    className?: string;
+    /** Children (compound components) */
+    children?: UINode;
+    /** Test ID */
+    testId?: string;
+}
+/**
+ * Comment sheet wired component props
+ */
+interface CommentSheetProps extends Omit<CommentSheetHeadlessProps, 'commentState' | 'commentActions'> {
+    /** Override comment state (optional) */
+    commentState?: UICommentState;
+    /** Override comment actions (optional) */
+    commentActions?: UICommentActions;
+    /** Video playback behavior when sheet opens */
+    onOpenBehavior?: 'pause' | 'mute' | 'continue';
+    /** Video animation config */
+    videoAnimation?: {
+        /** Enable video shrink animation (default: true) */
+        enabled?: boolean;
+        /** Animation duration in ms (default: 300) */
+        duration?: number;
+        /** Video behavior: 'shrink' | 'dim' | 'none' (default: 'shrink') */
+        behavior?: 'shrink' | 'dim' | 'none';
+    };
+    /** Callback when input is focused (for Flutter bridge) */
+    onInputFocus?: () => void;
+    /** Callback when input is blurred */
+    onInputBlur?: () => void;
+}
+/**
+ * Comment item headless component props
+ */
+interface CommentItemHeadlessProps {
+    /** Comment data */
+    comment: CommentItem;
+    /** Comment actions */
+    actions: UICommentActions;
+    /** Config */
+    config: CommentConfig;
+    /** Whether to show replies section */
+    showReplies?: boolean;
+    /** Whether replies are expanded */
+    repliesExpanded?: boolean;
+    /** Toggle replies expansion */
+    onToggleReplies?: () => void;
+    /** Current user (for reply input) */
+    currentUser?: CommentAuthor;
+    /** Additional class name */
+    className?: string;
+    /** Test ID */
+    testId?: string;
+}
+/**
+ * Reply item headless component props
+ */
+interface ReplyItemHeadlessProps {
+    /** Reply data */
+    reply: ReplyItem;
+    /** Parent comment */
+    parentComment: CommentItem;
+    /** Comment actions */
+    actions: UICommentActions;
+    /** Config */
+    config: CommentConfig;
+    /** Additional class name */
+    className?: string;
+    /** Test ID */
+    testId?: string;
+}
+/**
+ * Comment input headless component props
+ */
+interface CommentInputHeadlessProps {
+    /** Current user */
+    currentUser: CommentAuthor;
+    /** Submit handler */
+    onSubmit: (content: string) => Promise<void>;
+    /** Whether submitting */
+    isSubmitting?: boolean;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Reply to user (shows @mention) */
+    replyTo?: CommentAuthor;
+    /** Clear reply target */
+    onClearReply?: () => void;
+    /** Emoji bar config */
+    emojiBar?: {
+        enabled?: boolean;
+        emojis?: string[];
+    };
+    /** Input focus handler */
+    onFocus?: () => void;
+    /** Input blur handler */
+    onBlur?: () => void;
+    /** Additional class name */
+    className?: string;
+    /** Test ID */
+    testId?: string;
+}
 /**
  * Hook configuration for HOC factory
  */
@@ -1563,4 +2274,4 @@ type IconComponent = UIComponent<{
  */
 type FormatCountFn = (count: number) => string;
 
-export type { ActionBarHeadlessProps, ActionBarProps, ActionButtonHeadlessProps, AnalyticsConfig, AnalyticsEvent, AnalyticsEventType, Author, AuthorInfoHeadlessProps, AuthorInfoProps, Comment, ErrorBoundaryProps, FeedResponse, FeedState, FormatCountFn, IAnalytics, IDataSource, IInteraction, ILogger, INetworkAdapter, IPosterLoader, ISessionStorage, IStorage, IVideoLoader, IconComponent, InternalLogger, LogEntry, LogLevel, LoggerConfig, MusicInfo, NetworkQuality, NetworkType, OptimisticAction, PlaybackState, PlayerError, PlayerState, PreloadConfig, PreloadResult, PreloadStatus, ProgressBarHeadlessProps, SDKConfig, SessionSnapshot, SkeletonProps, UIAuthorActions, UIAuthorState, UIComponent, UIFeedState, UIInteractionActions, UIInteractionState, UINode, UIPlayerControls, UIPlayerState, UIRef, UIResourceState, UISwipeState, UIVideoInfoActions, UIVideoInfoState, VideoFeedHeadlessProps, VideoFeedProps, VideoInfoHeadlessProps, VideoInfoProps, VideoItem, VideoPlayerHeadlessProps, VideoPlayerWiredProps, VideoQuality, VideoSlotHeadlessProps, VideoSlotProps, VideoSource, VideoStats, WiredComponent, WiredComponentConfig };
+export { type ActionBarHeadlessProps, type ActionBarProps, type ActionButtonHeadlessProps, type AnalyticsConfig, type AnalyticsEvent, type AnalyticsEventType, type Author, type AuthorInfoHeadlessProps, type AuthorInfoProps, type Comment, type CommentAdapterConfig, type CommentAuthor, type CommentConfig, type CommentEndpoints, type CommentInputHeadlessProps, type CommentItem, type CommentItemHeadlessProps, type CommentListResponse, type CommentManagerState, type CommentReportReason, type CommentSheetHeadlessProps, type CommentSheetProps, type CommentState, type CommentTransformers, DEFAULT_COMMENT_CONFIG, DEFAULT_COMMENT_ENDPOINTS, type DeleteCommentPayload, type EditCommentPayload, type ErrorBoundaryProps, type FeedResponse, type FeedState, type FormatCountFn, type IAnalytics, type ICommentAdapter, type IDataSource, type IInteraction, type ILocalization, type ILogger, type INetworkAdapter, type IPosterLoader, type ISessionStorage, type IStorage, type IVideoLoader, type IconComponent, type InternalLogger, type LocalizationConfig, type LogEntry, type LogLevel, type LoggerConfig, type MessageCatalog, type MessageKey, type MessageValue, type MessageValues, type MockCommentAdapterConfig, type MusicInfo, type NetworkQuality, type NetworkType, type OptimisticAction, type PartialMessageCatalog, type PlaybackState, type PlayerError, type PlayerState, type PostCommentPayload, type PostReplyPayload, type PrefetchCacheData, type PreloadConfig, type PreloadResult, type PreloadStatus, type ProgressBarHeadlessProps, type ReplyItem, type ReplyItemHeadlessProps, type ReplyListResponse, type ReportCommentPayload, type SDKConfig, type SessionSnapshot, type SkeletonProps, type UIAuthorActions, type UIAuthorState, type UICommentActions, type UICommentState, type UIComponent, type UIFeedState, type UIInteractionActions, type UIInteractionState, type UINode, type UIPlayerControls, type UIPlayerState, type UIRef, type UIResourceState, type UISwipeState, type UIVideoInfoActions, type UIVideoInfoState, type VideoFeedHeadlessProps, type VideoFeedProps, type VideoInfoHeadlessProps, type VideoInfoProps, type VideoItem, type VideoPlayerHeadlessProps, type VideoPlayerWiredProps, type VideoQuality, type VideoSlotHeadlessProps, type VideoSlotProps, type VideoSource, type VideoStats, type WiredComponent, type WiredComponentConfig };

package/dist/index.js

@@ -1 +1,28 @@
+// src/comment-types.ts
+var DEFAULT_COMMENT_CONFIG = {
+  pageSize: 20,
+  replyPageSize: 10,
+  cacheTTL: 5 * 60 * 1e3,
+  // 5 minutes
+  repliesAutoExpandThreshold: 1,
+  repliesCollapseLimit: 3,
+  textMaxLines: 3,
+  inputMaxLength: 500,
+  enableOptimisticUI: true,
+  requireDeleteConfirm: true
+};
 
+// src/comment-adapter.ts
+var DEFAULT_COMMENT_ENDPOINTS = {
+  list: "/videos/:videoId/comments",
+  replies: "/comments/:commentId/replies",
+  post: "/videos/:videoId/comments",
+  postReply: "/comments/:commentId/replies",
+  edit: "/comments/:id",
+  delete: "/comments/:id",
+  like: "/comments/:id/like",
+  unlike: "/comments/:id/like",
+  report: "/comments/:id/report"
+};
+
+export { DEFAULT_COMMENT_CONFIG, DEFAULT_COMMENT_ENDPOINTS };

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@xhub-short/contracts",
-  "version": "0.1.0-beta.1",
+  "sideEffects": false,
+  "version": "0.1.0-beta.2",
   "type": "module",
   "publishConfig": {
     "access": "public"