@xhub-short/adapters 0.1.0-beta.10 → 0.1.0-beta.12

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { IDataSource, VideoItem, FeedResponse, ILogger, LogLevel, LogEntry, IStorage, ISessionStorage, SessionSnapshot, IInteraction, Comment, ICommentAdapter, MockCommentAdapterConfig, CommentListResponse, ReplyListResponse, PostCommentPayload, CommentItem, PostReplyPayload, ReplyItem, EditCommentPayload, DeleteCommentPayload, ReportCommentPayload, IAnalytics, AnalyticsEvent, INetworkAdapter, NetworkType, NetworkQuality, IVideoLoader, VideoSource, PreloadConfig, PreloadResult, PreloadStatus, IPosterLoader, CommentTransformers } from '@xhub-short/contracts';
+import { IDataSource, VideoItem, FeedResponse, IPlaylistDataSource, PlaylistData, PlaylistCollectionResponse, ILogger, LogLevel, LogEntry, IStorage, ISessionStorage, SessionSnapshot, IInteraction, Comment, ICommentAdapter, MockCommentAdapterConfig, CommentListResponse, ReplyListResponse, PostCommentPayload, CommentItem, PostReplyPayload, ReplyItem, EditCommentPayload, DeleteCommentPayload, ReportCommentPayload, IAnalytics, AnalyticsEvent, INetworkAdapter, NetworkType, NetworkQuality, IVideoLoader, VideoSource, PreloadConfig, PreloadResult, PreloadStatus, IPosterLoader, ReportReason, CommentTransformers } from '@xhub-short/contracts';
 
 /**
  * MockDataAdapter - Development/Testing Data Source
@@ -46,6 +46,19 @@ interface MockDataAdapterOptions {
     delay?: number;
 }
 
+/**
+ * MockPlaylistAdapter - Development/Testing Playlist Data Source
+ */
+declare class MockPlaylistAdapter implements IPlaylistDataSource {
+    private readonly delay;
+    constructor(options?: {
+        delay?: number;
+    });
+    fetchPlaylist(id: string): Promise<PlaylistData>;
+    fetchPlaylistCollection(cursor?: string): Promise<PlaylistCollectionResponse>;
+    private simulateDelay;
+}
+
 /**
  * Configuration options for MockLoggerAdapter
  */
@@ -446,11 +459,11 @@ declare class MockInteractionAdapter implements IInteraction {
     /**
      * Report a video
      *
-     * @param _videoId - ID of the video to report
-     * @param _reason - Report reason code
-     * @param _description - Optional additional description
+     * @param videoId - ID of the video to report
+     * @param reason - Report reason code
+     * @param description - Optional additional description
      */
-    report(_videoId: string, _reason: string, _description?: string): Promise<void>;
+    report(videoId: string, reason: string, description?: string): Promise<void>;
     /**
      * Check if video is liked (for testing)
      *
@@ -972,6 +985,22 @@ interface RESTEndpointMap {
          */
         detail: string;
     };
+    /**
+     * Playlist-related endpoints
+     */
+    playlist?: {
+        /**
+         * GET endpoint for playlist collection (listing)
+         * Example: '/playlists'
+         */
+        list: string;
+        /**
+         * GET endpoint for playlist detail
+         * :id will be replaced with playlist ID
+         * Example: '/playlists/:id'
+         */
+        detail: string;
+    };
     /**
      * Interaction endpoints
      */
@@ -990,6 +1019,12 @@ interface RESTEndpointMap {
         deleteComment: string;
         /** POST /videos/:id/share (optional) */
         share?: string;
+        /** POST /content/:id/report (optional) */
+        report?: string;
+        /** GET /report-reasons (optional) */
+        reportReasons?: string;
+        /** POST /content/:id/not-interested (optional) */
+        notInterested?: string;
     };
     /**
      * Analytics endpoints (optional) - BATCH mode
@@ -1100,6 +1135,14 @@ interface RetryConfig {
      */
     exponentialBackoff?: boolean;
 }
+/**
+ * Report reason from API
+ */
+interface ReportReasonItem {
+    id: string;
+    label: string;
+    description?: string;
+}
 /**
  * Response transform configuration
  */
@@ -1118,6 +1161,51 @@ interface TransformConfig {
         nextCursor: string | null;
         hasMore: boolean;
     };
+    /**
+     * Transform playlist response from API
+     * If not provided, uses default transform
+     */
+    playlist?: (apiResponse: unknown) => PlaylistData;
+    /**
+     * Transform playlist collection response from API
+     * If not provided, uses default transform
+     */
+    playlistCollection?: (apiResponse: unknown) => PlaylistCollectionResponse;
+    /**
+     * Transform report reasons response from API
+     * If not provided, uses default transform
+     *
+     * @example
+     * ```ts
+     * reportReasons: (response) => {
+     *   const data = response.data?.reasons || [];
+     *   return data.map(item => ({
+     *     id: item.id,
+     *     label: item.title,
+     *     description: item.description,
+     *   }));
+     * }
+     * ```
+     */
+    reportReasons?: (apiResponse: unknown) => ReportReasonItem[];
+    /**
+     * Transform report request body before sending to API
+     * If not provided, uses default format: { reason, description }
+     *
+     * @example
+     * ```ts
+     * reportBody: ({ contentId, reasonId, description }) => ({
+     *   video_id: contentId,
+     *   reason_id: reasonId,
+     *   description: description || '',
+     * })
+     * ```
+     */
+    reportBody?: (input: {
+        contentId: string;
+        reasonId: string;
+        description?: string;
+    }) => Record<string, unknown>;
     /**
      * Field mapping for default transforms
      * Used when API field names differ from defaults
@@ -1430,6 +1518,8 @@ interface PresetAdapters {
     dataSource: IDataSource;
     interaction: IInteraction;
     analytics: IAnalytics;
+    /** Playlist adapter (optional) */
+    playlist?: IPlaylistDataSource;
     /** Comment adapter (only if comment endpoints are configured) */
     comment?: ICommentAdapter;
 }
@@ -1897,6 +1987,8 @@ interface FullPresetAdapters {
     videoLoader: IVideoLoader;
     /** Poster preloader (Image) */
     posterLoader: IPosterLoader;
+    /** Playlist adapter (REST API, optional) */
+    playlist?: IPlaylistDataSource;
     /** Comment adapter (REST API, only if comment endpoints configured) */
     comment?: ICommentAdapter;
     /** Logger (passed through) */
@@ -2060,127 +2152,6 @@ declare class HttpClient {
     private sleep;
 }
 
-/**
- * CircuitBreaker - Prevents cascade failures
- *
- * State transitions:
- * CLOSED → (failures >= threshold) → OPEN
- * OPEN → (cooldown passes) → HALF_OPEN
- * HALF_OPEN → (success) → CLOSED
- * HALF_OPEN → (failure) → OPEN
- *
- * @packageDocumentation
- */
-/**
- * Circuit breaker states
- */
-type CircuitState = 'closed' | 'open' | 'half-open';
-/**
- * Circuit breaker configuration
- */
-interface CircuitBreakerConfig {
-    /** Number of failures before opening (default: 5) */
-    failureThreshold?: number;
-    /** Time window for failure counting in ms (default: 30000) */
-    failureWindow?: number;
-    /** Cool-down period before half-open in ms (default: 30000) */
-    cooldownPeriod?: number;
-    /** Number of successes in half-open to close (default: 1) */
-    successThreshold?: number;
-    /** Name for logging */
-    name?: string;
-}
-/**
- * Circuit breaker events
- */
-interface CircuitBreakerEvents {
-    stateChange: (state: CircuitState, previousState: CircuitState) => void;
-    failure: (error: Error, failureCount: number) => void;
-    success: () => void;
-    rejected: () => void;
-}
-/**
- * Error thrown when circuit is open
- */
-declare class CircuitOpenError extends Error {
-    constructor(message?: string);
-}
-/**
- * CircuitBreaker - Prevents cascade failures
- *
- * @example
- * ```typescript
- * const breaker = new CircuitBreaker({ failureThreshold: 5 });
- *
- * async function fetchData() {
- *   return breaker.execute(async () => {
- *     const response = await fetch('/api/data');
- *     return response.json();
- *   });
- * }
- * ```
- */
-declare class CircuitBreaker {
-    private state;
-    private failures;
-    private lastFailureTime;
-    private halfOpenSuccesses;
-    private config;
-    private listeners;
-    constructor(config?: CircuitBreakerConfig);
-    /**
-     * Get current circuit state
-     */
-    getState(): CircuitState;
-    /**
-     * Check if circuit allows requests
-     */
-    isAllowed(): boolean;
-    /**
-     * Execute a function through the circuit breaker
-     */
-    execute<T>(fn: () => Promise<T>): Promise<T>;
-    /**
-     * Record a successful call
-     */
-    recordSuccess(): void;
-    /**
-     * Record a failed call
-     */
-    recordFailure(error: Error): void;
-    /**
-     * Manually reset the circuit breaker
-     */
-    reset(): void;
-    /**
-     * Subscribe to events
-     */
-    on<K extends keyof CircuitBreakerEvents>(event: K, listener: CircuitBreakerEvents[K]): () => void;
-    /**
-     * Get failure count
-     */
-    getFailureCount(): number;
-    /**
-     * Get config
-     */
-    getConfig(): Required<CircuitBreakerConfig>;
-    private updateState;
-    private transitionTo;
-    private emit;
-}
-/**
- * Get or create a circuit breaker by name
- */
-declare function getCircuitBreaker(name?: string, config?: CircuitBreakerConfig): CircuitBreaker;
-/**
- * Reset all circuit breakers
- */
-declare function resetAllCircuitBreakers(): void;
-/**
- * Get global circuit breaker (default)
- */
-declare function getGlobalCircuitBreaker(): CircuitBreaker;
-
 /**
  * Default Transforms - Auto-transform API responses to SDK format
  *
@@ -2215,6 +2186,8 @@ interface ResolvedTransforms {
         nextCursor: string | null;
         hasMore: boolean;
     };
+    playlist: (data: unknown) => PlaylistData;
+    playlistCollection: (data: unknown) => PlaylistCollectionResponse;
 }
 declare function createTransforms(config?: TransformConfig, logger?: ILogger): ResolvedTransforms;
 
@@ -2280,6 +2253,14 @@ declare class RESTDataAdapter implements IDataSource {
  * - share (optional)
  */
 
+/**
+ * Report body input from SDK
+ */
+interface ReportBodyInput {
+    contentId: string;
+    reasonId: string;
+    description?: string;
+}
 /**
  * REST Interaction Adapter configuration
  */
@@ -2287,6 +2268,10 @@ interface RESTInteractionAdapterConfig {
     httpClient: HttpClient;
     endpoints: RESTEndpointMap['interaction'];
     logger?: ILogger;
+    /** Custom transform for report reasons response */
+    transformReportReasons?: (apiResponse: unknown) => ReportReasonItem[];
+    /** Custom transform for report request body */
+    transformReportBody?: (input: ReportBodyInput) => Record<string, unknown>;
 }
 /**
  * REST Interaction Adapter
@@ -2295,6 +2280,8 @@ declare class RESTInteractionAdapter implements IInteraction {
     private readonly httpClient;
     private readonly endpoints;
     private readonly logger?;
+    private readonly customTransformReportReasons?;
+    private readonly customTransformReportBody?;
     constructor(config: RESTInteractionAdapterConfig);
     /**
      * Like a video
@@ -2332,6 +2319,38 @@ declare class RESTInteractionAdapter implements IInteraction {
      * Share a video (optional tracking)
      */
     share(videoId: string, platform?: string): Promise<void>;
+    /**
+     * Report content (video or image post)
+     *
+     * @param contentId - ID of the content to report
+     * @param reason - Report reason code/ID
+     * @param description - Optional additional description
+     */
+    report(contentId: string, reason: string, description?: string): Promise<void>;
+    /**
+     * Get available report reasons
+     *
+     * @returns Array of report reasons, or empty array if not configured
+     */
+    getReportReasons(): Promise<ReportReason[]>;
+    /**
+     * Mark content as "not interested"
+     *
+     * Used for recommendation algorithm feedback.
+     * Content should be hidden from feed after this action.
+     *
+     * @param contentId - ID of the content (video or image post)
+     */
+    notInterested(contentId: string): Promise<void>;
+    /**
+     * Default transform for API report reasons response to ReportReason[]
+     *
+     * Expected format: [{ id, label, description }]
+     * Or wrapped: { data: [{ id, label, description }] }
+     *
+     * For custom API formats, use `transforms.reportReasons` in preset config.
+     */
+    private transformReportReasons;
     /**
      * Transform API comment response to Comment type
      */
@@ -2701,4 +2720,4 @@ declare class RESTCommentAdapter implements ICommentAdapter {
     private unwrapResponse;
 }
 
-export { type AuthConfig, type AuthError, type BatchAnalyticsConfig, type BatchAnalyticsContext, type BatchAnalyticsDeviceType, type BatchAnalyticsEventData, type BatchAnalyticsEventTransformer, type BatchAnalyticsEventType, type BatchAnalyticsNetworkType, type BatchAnalyticsRequestBody, type BatchAnalyticsRequestEvent, type BrowserAdaptersConfig, BrowserPosterLoader, BrowserVideoLoader, type BrowserVideoLoaderConfig, CircuitBreaker, type CircuitBreakerConfig, type CircuitBreakerEvents, CircuitOpenError, type CircuitState, DEFAULT_REQUEST_CONFIG, DEFAULT_RETRY_CONFIG, type FieldMapConfig, type FullPresetAdapters, HttpClient, HttpError, LocalSessionStorageAdapter, LocalStorageAdapter, type LocalStorageConfig, MockAnalyticsAdapter, type MockAnalyticsAdapterOptions, MockCommentAdapter, MockDataAdapter, type MockDataAdapterOptions, MockInteractionAdapter, type MockInteractionAdapterOptions, MockLoggerAdapter, type MockLoggerAdapterOptions, MockNetworkAdapter, type MockNetworkAdapterOptions, MockPosterLoader, MockSessionStorageAdapter, type MockSessionStorageAdapterOptions, MockStorageAdapter, type MockStorageAdapterOptions, MockVideoLoader, type MockVideoLoaderOptions, type PresetAdapters, RESTAnalyticsAdapter, type RESTAnalyticsAdapterConfig, RESTCommentAdapter, type RESTCommentAdapterConfig, RESTDataAdapter, type RESTEndpointMap, RESTInteractionAdapter, type RESTPresetConfig, type RESTRequestConfig, RESTViewTrackingAdapter, type RESTViewTrackingAdapterConfig, type ResolvedTransforms, type RetryConfig, type TransformConfig, type ViewEventData, type ViewEventRequestBody, type ViewEventTransformer, type ViewTrackingConfig, WebNetworkAdapter, type WebNetworkConfig, createBrowserAdapters, createBrowserPosterLoader, createBrowserVideoLoader, createLocalStorageAdapter, createNoOpAnalyticsAdapter, createRESTAdapters, createSessionStorageAdapter, createTransforms, createWebNetworkAdapter, defaultFeedResponseTransform, defaultVideoItemTransform, getCircuitBreaker, getGlobalCircuitBreaker, resetAllCircuitBreakers };
+export { type AuthConfig, type AuthError, type BatchAnalyticsConfig, type BatchAnalyticsContext, type BatchAnalyticsDeviceType, type BatchAnalyticsEventData, type BatchAnalyticsEventTransformer, type BatchAnalyticsEventType, type BatchAnalyticsNetworkType, type BatchAnalyticsRequestBody, type BatchAnalyticsRequestEvent, type BrowserAdaptersConfig, BrowserPosterLoader, BrowserVideoLoader, type BrowserVideoLoaderConfig, DEFAULT_REQUEST_CONFIG, DEFAULT_RETRY_CONFIG, type FieldMapConfig, type FullPresetAdapters, HttpClient, HttpError, LocalSessionStorageAdapter, LocalStorageAdapter, type LocalStorageConfig, MockAnalyticsAdapter, type MockAnalyticsAdapterOptions, MockCommentAdapter, MockDataAdapter, type MockDataAdapterOptions, MockInteractionAdapter, type MockInteractionAdapterOptions, MockLoggerAdapter, type MockLoggerAdapterOptions, MockNetworkAdapter, type MockNetworkAdapterOptions, MockPlaylistAdapter, MockPosterLoader, MockSessionStorageAdapter, type MockSessionStorageAdapterOptions, MockStorageAdapter, type MockStorageAdapterOptions, MockVideoLoader, type MockVideoLoaderOptions, type PresetAdapters, RESTAnalyticsAdapter, type RESTAnalyticsAdapterConfig, RESTCommentAdapter, type RESTCommentAdapterConfig, RESTDataAdapter, type RESTEndpointMap, RESTInteractionAdapter, type RESTPresetConfig, type RESTRequestConfig, RESTViewTrackingAdapter, type RESTViewTrackingAdapterConfig, type ResolvedTransforms, type RetryConfig, type TransformConfig, type ViewEventData, type ViewEventRequestBody, type ViewEventTransformer, type ViewTrackingConfig, WebNetworkAdapter, type WebNetworkConfig, createBrowserAdapters, createBrowserPosterLoader, createBrowserVideoLoader, createLocalStorageAdapter, createNoOpAnalyticsAdapter, createRESTAdapters, createSessionStorageAdapter, createTransforms, createWebNetworkAdapter, defaultFeedResponseTransform, defaultVideoItemTransform };

package/dist/index.js

@@ -4,6 +4,7 @@ var MOCK_VIDEOS = [
   // HLS Videos (for testing hls.js integration)
   // ═══════════════════════════════════════════════════════════════════════════
   {
+    type: "video",
     id: "video-1",
     source: {
       url: "https://peertube.teknix.services/static/streaming-playlists/hls/dd8de71d-0b75-4677-a1a2-6f60e673bee4/465faffa-6d08-4f34-ae40-691cc904ce7b-master.m3u8",
@@ -30,6 +31,7 @@ var MOCK_VIDEOS = [
     hashtags: ["hls", "streaming", "test"]
   },
   {
+    type: "video",
     id: "video-2",
     source: {
       url: "https://devstreaming-cdn.apple.com/videos/streaming/examples/img_bipbop_adv_example_fmp4/master.m3u8",
@@ -59,6 +61,7 @@ var MOCK_VIDEOS = [
   // MP4 Videos
   // ═══════════════════════════════════════════════════════════════════════════
   {
+    type: "video",
     id: "video-3",
     source: {
       url: "https://peertube.teknix.services/static/streaming-playlists/hls/ea58b245-b3bf-4958-b2f0-b31f8113d142/83f1bb91-e76a-4dcd-8034-2ec37cb70ead-master.m3u8",
@@ -85,6 +88,7 @@ var MOCK_VIDEOS = [
     hashtags: ["chrome", "blazes"]
   },
   {
+    type: "video",
     id: "video-4",
     source: {
       url: "https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerEscapes.mp4",
@@ -111,6 +115,7 @@ var MOCK_VIDEOS = [
     hashtags: ["chrome", "escapes"]
   },
   {
+    type: "video",
     id: "video-5",
     source: {
       url: "https://peertube.teknix.services/static/streaming-playlists/hls/003a41a3-25c1-419b-9548-7a1597adc85f/9cc93564-c9c9-4107-ae12-cd22d0db8046-master.m3u8",
@@ -137,6 +142,7 @@ var MOCK_VIDEOS = [
     hashtags: ["chrome", "fun"]
   },
   {
+    type: "video",
     id: "video-6",
     source: {
       url: "https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerJoyrides.mp4",
@@ -163,6 +169,7 @@ var MOCK_VIDEOS = [
     hashtags: ["adventure", "joyride", "travel"]
   },
   {
+    type: "video",
     id: "video-7",
     source: {
       url: "https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerMeltdowns.mp4",
@@ -189,6 +196,7 @@ var MOCK_VIDEOS = [
     hashtags: ["satisfying", "icecream", "asmr"]
   },
   {
+    type: "video",
     id: "video-8",
     source: {
       url: "https://storage.googleapis.com/gtv-videos-bucket/sample/Sintel.mp4",
@@ -215,6 +223,7 @@ var MOCK_VIDEOS = [
     hashtags: ["fantasy", "animation", "sintel", "blender"]
   },
   {
+    type: "video",
     id: "video-9",
     source: {
       url: "https://storage.googleapis.com/gtv-videos-bucket/sample/SubaruOutbackOnStreetAndDirt.mp4",
@@ -241,6 +250,7 @@ var MOCK_VIDEOS = [
     hashtags: ["cars", "subaru", "offroad", "review"]
   },
   {
+    type: "video",
     id: "video-10",
     source: {
       url: "https://storage.googleapis.com/gtv-videos-bucket/sample/TearsOfSteel.mp4",
@@ -267,6 +277,7 @@ var MOCK_VIDEOS = [
     hashtags: ["scifi", "drama", "blender", "vfx"]
   },
   {
+    type: "video",
     id: "video-11",
     source: {
       url: "https://storage.googleapis.com/gtv-videos-bucket/sample/VolkswagenGTIReview.mp4",
@@ -293,6 +304,7 @@ var MOCK_VIDEOS = [
     hashtags: ["cars", "vw", "gti", "hothatch"]
   },
   {
+    type: "video",
     id: "video-12",
     source: {
       url: "https://storage.googleapis.com/gtv-videos-bucket/sample/WeAreGoingOnBullrun.mp4",
@@ -319,6 +331,7 @@ var MOCK_VIDEOS = [
     hashtags: ["rally", "racing", "bullrun", "supercars"]
   },
   {
+    type: "video",
     id: "video-13",
     source: {
       url: "https://storage.googleapis.com/gtv-videos-bucket/sample/WhatCarCanYouGetForAGrand.mp4",
@@ -345,6 +358,7 @@ var MOCK_VIDEOS = [
     hashtags: ["budget", "usedcars", "tips", "bargain"]
   },
   {
+    type: "video",
     id: "video-14",
     source: {
       url: "https://storage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
@@ -371,6 +385,7 @@ var MOCK_VIDEOS = [
     hashtags: ["bts", "animation", "3d", "making"]
   },
   {
+    type: "video",
     id: "video-15",
     source: {
       url: "https://storage.googleapis.com/gtv-videos-bucket/sample/ElephantsDream.mp4",
@@ -397,6 +412,7 @@ var MOCK_VIDEOS = [
     hashtags: ["tutorial", "animation", "blender", "makingof"]
   },
   {
+    type: "video",
     id: "video-16",
     source: {
       url: "https://storage.googleapis.com/gtv-videos-bucket/sample/Sintel.mp4",
@@ -423,6 +439,7 @@ var MOCK_VIDEOS = [
     hashtags: ["characterdesign", "sintel", "tutorial", "art"]
   },
   {
+    type: "video",
     id: "video-17",
     source: {
       url: "https://storage.googleapis.com/gtv-videos-bucket/sample/TearsOfSteel.mp4",
@@ -449,6 +466,7 @@ var MOCK_VIDEOS = [
     hashtags: ["vfx", "breakdown", "compositing", "cgi"]
   },
   {
+    type: "video",
     id: "video-18",
     source: {
       url: "https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerJoyrides.mp4",
@@ -475,6 +493,7 @@ var MOCK_VIDEOS = [
     hashtags: ["pov", "roadtrip", "travel", "wanderlust"]
   },
   {
+    type: "video",
     id: "video-19",
     source: {
       url: "https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4",
@@ -501,6 +520,7 @@ var MOCK_VIDEOS = [
     hashtags: ["satisfying", "fire", "asmr", "relaxing"]
   },
   {
+    type: "video",
     id: "video-20",
     source: {
       url: "https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerMeltdowns.mp4",
@@ -576,6 +596,86 @@ var MockDataAdapter = class {
   }
 };
 
+// src/playlist/MockPlaylistAdapter.ts
+var MOCK_PLAYLISTS = [
+  {
+    id: "p1",
+    title: "Workout Jams",
+    description: "High energy tracks for your workout",
+    cover: "https://images.unsplash.com/photo-1534438327276-14e5300c3a48?w=400&h=600&fit=crop",
+    totalItems: 4,
+    items: []
+    // Populated on fetchPlaylist
+  },
+  {
+    id: "p2",
+    title: "Chill Vibes",
+    description: "Relax and unwind with these lo-fi beats",
+    cover: "https://images.unsplash.com/photo-1516280440614-37939bbacd81?w=400&h=600&fit=crop",
+    totalItems: 4,
+    items: []
+  },
+  {
+    id: "p3",
+    title: "Travel Diaries",
+    description: "Explore the world through music and video",
+    cover: "https://images.unsplash.com/photo-1476514525535-07fb3b4ae5f1?w=400&h=600&fit=crop",
+    totalItems: 4,
+    items: []
+  },
+  {
+    id: "p4",
+    title: "Cooking with Chef loct",
+    description: "Delicious recipes and kitchen tips",
+    cover: "https://images.unsplash.com/photo-1556910103-1c02745aae4d?w=400&h=600&fit=crop",
+    totalItems: 4,
+    items: []
+  }
+];
+var MockPlaylistAdapter = class {
+  constructor(options = {}) {
+    this.delay = options.delay ?? 300;
+  }
+  async fetchPlaylist(id) {
+    await this.simulateDelay();
+    const playlist = MOCK_PLAYLISTS.find((p) => p.id === id);
+    if (!playlist) throw new Error(`Playlist ${id} not found`);
+    let items = [];
+    if (id === "p1") items = MOCK_VIDEOS.slice(0, 4);
+    else if (id === "p2") items = MOCK_VIDEOS.slice(4, 8);
+    else if (id === "p3") items = MOCK_VIDEOS.slice(8, 12);
+    else if (id === "p4") items = MOCK_VIDEOS.slice(12, 16);
+    return { ...playlist, items };
+  }
+  async fetchPlaylistCollection(cursor) {
+    await this.simulateDelay();
+    const offset = cursor ? Number.parseInt(cursor, 10) : 0;
+    const limit = 4;
+    const items = MOCK_PLAYLISTS.slice(offset, offset + limit);
+    const nextOffset = offset + limit;
+    const hasMore = nextOffset < MOCK_PLAYLISTS.length;
+    const playlists = items.map((p) => ({
+      id: p.id,
+      title: p.title,
+      description: p.description,
+      cover: p.cover,
+      totalItems: p.totalItems,
+      author: { id: "a1", name: "System" },
+      updatedAt: "2 days ago"
+    }));
+    return {
+      playlists,
+      nextCursor: hasMore ? String(nextOffset) : null,
+      hasMore
+    };
+  }
+  async simulateDelay() {
+    if (this.delay > 0) {
+      await new Promise((resolve) => setTimeout(resolve, this.delay));
+    }
+  }
+};
+
 // src/logger/mock.ts
 var LOG_LEVEL_PRIORITY = {
   debug: 0,
@@ -1107,13 +1207,14 @@ var MockInteractionAdapter = class {
   /**
    * Report a video
    *
-   * @param _videoId - ID of the video to report
-   * @param _reason - Report reason code
-   * @param _description - Optional additional description
+   * @param videoId - ID of the video to report
+   * @param reason - Report reason code
+   * @param description - Optional additional description
    */
-  async report(_videoId, _reason, _description) {
+  async report(videoId, reason, description) {
     await this.simulateDelay();
     this.maybeThrowError();
+    console.log("[MockInteractionAdapter] Report called (mock)", { videoId, reason, description });
   }
   // ═══════════════════════════════════════════════════════════════
   // TESTING HELPERS (not part of IInteraction interface)
@@ -2609,6 +2710,7 @@ var RESTDataAdapter = class {
   createFallbackVideoItem(data) {
     const obj = data ?? {};
     return {
+      type: "video",
       id: String(obj.id ?? obj.video_id ?? `fallback-${Date.now()}`),
       source: {
         url: String(obj.video_url ?? obj.url ?? ""),
@@ -2638,6 +2740,8 @@ var RESTInteractionAdapter = class {
     this.httpClient = config.httpClient;
     this.endpoints = config.endpoints;
     this.logger = config.logger;
+    this.customTransformReportReasons = config.transformReportReasons;
+    this.customTransformReportBody = config.transformReportBody;
   }
   /**
    * Like a video
@@ -2762,6 +2866,107 @@ var RESTInteractionAdapter = class {
       this.logger?.warn("[RESTInteractionAdapter] share tracking failed", { error });
     }
   }
+  /**
+   * Report content (video or image post)
+   *
+   * @param contentId - ID of the content to report
+   * @param reason - Report reason code/ID
+   * @param description - Optional additional description
+   */
+  async report(contentId, reason, description) {
+    if (!this.endpoints.report) {
+      this.logger?.warn("[RESTInteractionAdapter] report endpoint not configured");
+      return;
+    }
+    try {
+      const body = this.customTransformReportBody ? this.customTransformReportBody({ contentId, reasonId: reason, description }) : { reason, description };
+      this.logger?.debug("[RESTInteractionAdapter] Sending report", {
+        path: this.endpoints.report,
+        contentId,
+        body
+      });
+      await this.httpClient.request({
+        method: "POST",
+        path: this.endpoints.report,
+        pathParams: { id: contentId },
+        body
+      });
+      this.logger?.debug("[RESTInteractionAdapter] Report sent successfully");
+    } catch (error) {
+      this.logger?.error("[RESTInteractionAdapter] report failed", error);
+      throw error;
+    }
+  }
+  /**
+   * Get available report reasons
+   *
+   * @returns Array of report reasons, or empty array if not configured
+   */
+  async getReportReasons() {
+    if (!this.endpoints.reportReasons) {
+      this.logger?.debug("[RESTInteractionAdapter] reportReasons endpoint not configured");
+      return [];
+    }
+    try {
+      const response = await this.httpClient.request({
+        method: "GET",
+        path: this.endpoints.reportReasons
+      });
+      if (this.customTransformReportReasons) {
+        return this.customTransformReportReasons(response);
+      }
+      return this.transformReportReasons(response);
+    } catch (error) {
+      this.logger?.error("[RESTInteractionAdapter] getReportReasons failed", error);
+      return [];
+    }
+  }
+  /**
+   * Mark content as "not interested"
+   *
+   * Used for recommendation algorithm feedback.
+   * Content should be hidden from feed after this action.
+   *
+   * @param contentId - ID of the content (video or image post)
+   */
+  async notInterested(contentId) {
+    if (!this.endpoints.notInterested) {
+      this.logger?.warn("[RESTInteractionAdapter] notInterested endpoint not configured");
+      return;
+    }
+    try {
+      await this.httpClient.request({
+        method: "POST",
+        path: this.endpoints.notInterested,
+        pathParams: { id: contentId }
+      });
+    } catch (error) {
+      this.logger?.error("[RESTInteractionAdapter] notInterested failed", error);
+      throw error;
+    }
+  }
+  /**
+   * Default transform for API report reasons response to ReportReason[]
+   *
+   * Expected format: [{ id, label, description }]
+   * Or wrapped: { data: [{ id, label, description }] }
+   *
+   * For custom API formats, use `transforms.reportReasons` in preset config.
+   */
+  transformReportReasons(response) {
+    const data = this.unwrapResponse(response);
+    if (!Array.isArray(data)) {
+      return [];
+    }
+    return data.map((item) => {
+      const obj = item;
+      return {
+        id: String(obj.id ?? obj.reason_id ?? ""),
+        label: String(obj.label ?? obj.name ?? obj.title ?? ""),
+        description: obj.description
+      };
+    });
+  }
   /**
    * Transform API comment response to Comment type
    */
@@ -2796,6 +3001,69 @@ var RESTInteractionAdapter = class {
   }
 };
 
+// src/preset/adapters/RESTPlaylistAdapter.ts
+var RESTPlaylistAdapter = class {
+  constructor(config) {
+    this.httpClient = config.httpClient;
+    this.endpoint = config.endpoint;
+    this.collectionEndpoint = config.collectionEndpoint;
+    this.transforms = config.transforms;
+    this.logger = config.logger;
+  }
+  /**
+   * Fetch a complete playlist by ID
+   *
+   * @param id - The playlist ID
+   * @returns Promise resolving to PlaylistData
+   */
+  async fetchPlaylist(id) {
+    try {
+      this.logger?.info(`[RESTPlaylistAdapter] Fetching playlist: ${id}`);
+      const path = this.endpoint.replace(":id", id);
+      const response = await this.httpClient.request({
+        method: "GET",
+        path
+      });
+      const playlist = this.transforms.playlist(response);
+      if (playlist.items.length === 0) {
+        this.logger?.warn(`[RESTPlaylistAdapter] Playlist ${id} is empty`);
+      }
+      return playlist;
+    } catch (error) {
+      this.logger?.error(`[RESTPlaylistAdapter] Failed to fetch playlist: ${id}`, error);
+      throw error;
+    }
+  }
+  /**
+   * Fetch a collection of playlists
+   *
+   * @param cursor - Pagination cursor
+   * @returns Promise resolving to PlaylistCollectionResponse
+   */
+  async fetchPlaylistCollection(cursor) {
+    try {
+      if (!this.collectionEndpoint || !this.transforms.collection) {
+        throw new Error(
+          "[RESTPlaylistAdapter] collectionEndpoint or collection transform not configured"
+        );
+      }
+      this.logger?.info(`[RESTPlaylistAdapter] Fetching playlist collection (cursor: ${cursor})`);
+      const path = cursor ? `${this.collectionEndpoint}?cursor=${cursor}` : this.collectionEndpoint;
+      const response = await this.httpClient.request({
+        method: "GET",
+        path
+      });
+      return this.transforms.collection(response);
+    } catch (error) {
+      this.logger?.error(
+        "[RESTPlaylistAdapter] Failed to fetch playlist collection",
+        error
+      );
+      throw error;
+    }
+  }
+};
+
 // src/preset/adapters/RESTViewTrackingAdapter.ts
 var DEFAULT_VIEW_EVENT_VALUE = "seek";
 var DEFAULT_HEARTBEAT_INTERVAL = 1e4;
@@ -3266,6 +3534,83 @@ var HttpClient = class {
   }
 };
 
+// src/preset/transforms/playlist.ts
+function defaultPlaylistTransform(apiResponse, videoItemTransform, logger) {
+  if (!apiResponse || typeof apiResponse !== "object") {
+    logger?.error("[PlaylistTransform] Invalid API response", void 0, {
+      apiResponse: String(apiResponse)
+    });
+    return createEmptyPlaylist();
+  }
+  const obj = apiResponse;
+  const data = obj.data ?? obj.result ?? obj.playlist ?? obj;
+  const rawItems = data.items ?? data.reels ?? data.videos ?? data.list ?? [];
+  if (!Array.isArray(rawItems)) {
+    logger?.warn("[PlaylistTransform] Items is not an array", { data });
+    return createEmptyPlaylist(data);
+  }
+  const items = rawItems.map((item) => {
+    try {
+      return videoItemTransform(item);
+    } catch (error) {
+      logger?.error("[PlaylistTransform] Failed to transform item", error);
+      return null;
+    }
+  }).filter((item) => item !== null);
+  return {
+    id: String(data.id ?? data.playlist_id ?? ""),
+    title: String(data.title ?? data.name ?? "Untitled Playlist"),
+    description: String(data.description ?? ""),
+    cover: String(data.cover ?? data.cover_url ?? data.thumbnail ?? ""),
+    items,
+    totalItems: Number(data.total_items ?? data.total ?? items.length)
+  };
+}
+function defaultPlaylistSummaryTransform(data) {
+  const obj = data;
+  const authorObj = obj.author ?? obj.user ?? obj.creator ?? {};
+  return {
+    id: String(obj.id ?? obj.playlist_id ?? ""),
+    title: String(obj.title ?? obj.name ?? "Untitled Playlist"),
+    description: String(obj.description ?? ""),
+    cover: String(obj.cover ?? obj.cover_url ?? obj.thumbnail ?? ""),
+    totalItems: Number(obj.total_items ?? obj.items_count ?? 0),
+    author: {
+      id: String(authorObj.id ?? authorObj.user_id ?? ""),
+      name: String(authorObj.name ?? authorObj.display_name ?? authorObj.username ?? "Unknown")
+    },
+    updatedAt: String(obj.updated_at ?? obj.updatedAt ?? (/* @__PURE__ */ new Date()).toISOString())
+  };
+}
+function defaultPlaylistCollectionTransform(apiResponse, logger) {
+  if (!apiResponse || typeof apiResponse !== "object") {
+    return { playlists: [], nextCursor: null, hasMore: false };
+  }
+  const obj = apiResponse;
+  const data = obj.data ?? obj.result ?? obj;
+  const rawPlaylists = data.playlists ?? data.items ?? data.list ?? [];
+  if (!Array.isArray(rawPlaylists)) {
+    logger?.warn("[PlaylistTransform] Playlists is not an array", { data });
+    return { playlists: [], nextCursor: null, hasMore: false };
+  }
+  const playlists = rawPlaylists.map(defaultPlaylistSummaryTransform);
+  const nextCursor = String(data.next_cursor ?? data.cursor ?? data.nextCursor ?? null);
+  const hasMore = Boolean(data.has_more ?? data.hasMore ?? (nextCursor && nextCursor !== "null"));
+  return {
+    playlists,
+    nextCursor: nextCursor === "null" ? null : nextCursor,
+    hasMore
+  };
+}
+function createEmptyPlaylist(data) {
+  return {
+    id: String(data?.id ?? ""),
+    title: String(data?.title ?? "Empty Playlist"),
+    items: [],
+    totalItems: 0
+  };
+}
+
 // src/preset/transforms/defaults.ts
 function getNestedValue(obj, path) {
   if (!obj || typeof obj !== "object") return void 0;
@@ -3373,6 +3718,7 @@ function defaultVideoItemTransform(apiResponse, fieldMap, logger) {
   const author = defaultAuthorTransform(obj);
   const stats = defaultStatsTransform(obj);
   const videoItem = {
+    type: "video",
     id,
     source,
     poster: toSafeString(
@@ -3454,7 +3800,13 @@ function defaultFeedResponseTransform(apiResponse, fieldMap, logger) {
 function createTransforms(config, logger) {
   return {
     videoItem: config?.videoItem ? config.videoItem : (data) => defaultVideoItemTransform(data, config?.fieldMap?.video, logger),
-    feedResponse: config?.feedResponse ? config.feedResponse : (data) => defaultFeedResponseTransform(data, config?.fieldMap?.feed, logger)
+    feedResponse: config?.feedResponse ? config.feedResponse : (data) => defaultFeedResponseTransform(data, config?.fieldMap?.feed, logger),
+    playlist: config?.playlist ? config.playlist : (data) => defaultPlaylistTransform(
+      data,
+      (item) => config?.videoItem ? config.videoItem(item) : defaultVideoItemTransform(item, config?.fieldMap?.video, logger),
+      logger
+    ),
+    playlistCollection: config?.playlistCollection ? config.playlistCollection : (data) => defaultPlaylistCollectionTransform(data, logger)
   };
 }
 
@@ -3506,7 +3858,9 @@ function createRESTAdapters(config) {
   const interaction = new RESTInteractionAdapter({
     httpClient,
     endpoints: endpoints.interaction,
-    logger
+    logger,
+    transformReportReasons: transforms?.reportReasons,
+    transformReportBody: transforms?.reportBody
   });
   let analytics;
   if (endpoints.viewTracking) {
@@ -3531,11 +3885,22 @@ function createRESTAdapters(config) {
     endpoints: endpoints.comment,
     logger
   }) : void 0;
+  const playlist = endpoints.playlist ? new RESTPlaylistAdapter({
+    httpClient,
+    endpoint: endpoints.playlist.detail,
+    collectionEndpoint: endpoints.playlist.list,
+    transforms: {
+      playlist: resolvedTransforms.playlist,
+      collection: (data) => resolvedTransforms.playlistCollection(data)
+    },
+    logger
+  }) : void 0;
   return {
     dataSource,
     interaction,
     analytics,
-    comment
+    comment,
+    playlist
   };
 }
 
@@ -4170,174 +4535,9 @@ function createBrowserAdapters(config) {
     videoLoader,
     posterLoader,
     comment,
+    playlist: restAdapters.playlist,
     logger: config.logger
   };
 }
 
-// src/preset/http/CircuitBreaker.ts
-var DEFAULT_CONFIG3 = {
-  failureThreshold: 5,
-  failureWindow: 3e4,
-  cooldownPeriod: 3e4,
-  successThreshold: 1,
-  name: "default"
-};
-var CircuitOpenError = class extends Error {
-  constructor(message = "Circuit breaker is open") {
-    super(message);
-    this.name = "CircuitOpenError";
-  }
-};
-var CircuitBreaker = class {
-  constructor(config = {}) {
-    this.state = "closed";
-    this.failures = [];
-    this.lastFailureTime = 0;
-    this.halfOpenSuccesses = 0;
-    this.listeners = /* @__PURE__ */ new Map();
-    this.config = { ...DEFAULT_CONFIG3, ...config };
-  }
-  /**
-   * Get current circuit state
-   */
-  getState() {
-    this.updateState();
-    return this.state;
-  }
-  /**
-   * Check if circuit allows requests
-   */
-  isAllowed() {
-    this.updateState();
-    return this.state !== "open";
-  }
-  /**
-   * Execute a function through the circuit breaker
-   */
-  async execute(fn) {
-    this.updateState();
-    if (this.state === "open") {
-      this.emit("rejected");
-      throw new CircuitOpenError(`Circuit breaker [${this.config.name}] is open`);
-    }
-    try {
-      const result = await fn();
-      this.recordSuccess();
-      return result;
-    } catch (error) {
-      this.recordFailure(error);
-      throw error;
-    }
-  }
-  /**
-   * Record a successful call
-   */
-  recordSuccess() {
-    if (this.state === "half-open") {
-      this.halfOpenSuccesses++;
-      if (this.halfOpenSuccesses >= this.config.successThreshold) {
-        this.transitionTo("closed");
-        this.failures = [];
-        this.halfOpenSuccesses = 0;
-      }
-    }
-    this.emit("success");
-  }
-  /**
-   * Record a failed call
-   */
-  recordFailure(error) {
-    const now = Date.now();
-    this.failures.push(now);
-    this.lastFailureTime = now;
-    const cutoff = now - this.config.failureWindow;
-    this.failures = this.failures.filter((t) => t > cutoff);
-    this.emit("failure", error, this.failures.length);
-    if (this.state === "half-open") {
-      this.transitionTo("open");
-      this.halfOpenSuccesses = 0;
-    } else if (this.state === "closed" && this.failures.length >= this.config.failureThreshold) {
-      this.transitionTo("open");
-    }
-  }
-  /**
-   * Manually reset the circuit breaker
-   */
-  reset() {
-    this.failures = [];
-    this.halfOpenSuccesses = 0;
-    this.transitionTo("closed");
-  }
-  /**
-   * Subscribe to events
-   */
-  on(event, listener) {
-    if (!this.listeners.has(event)) {
-      this.listeners.set(event, /* @__PURE__ */ new Set());
-    }
-    const listeners = this.listeners.get(event);
-    if (listeners) {
-      listeners.add(listener);
-    }
-    return () => {
-      const listeners2 = this.listeners.get(event);
-      if (listeners2) {
-        listeners2.delete(listener);
-      }
-    };
-  }
-  /**
-   * Get failure count
-   */
-  getFailureCount() {
-    return this.failures.length;
-  }
-  /**
-   * Get config
-   */
-  getConfig() {
-    return { ...this.config };
-  }
-  updateState() {
-    if (this.state === "open") {
-      const timeSinceLastFailure = Date.now() - this.lastFailureTime;
-      if (timeSinceLastFailure >= this.config.cooldownPeriod) {
-        this.transitionTo("half-open");
-        this.halfOpenSuccesses = 0;
-      }
-    }
-  }
-  transitionTo(newState) {
-    if (this.state === newState) return;
-    const previousState = this.state;
-    this.state = newState;
-    this.emit("stateChange", newState, previousState);
-  }
-  emit(event, ...args) {
-    const listeners = this.listeners.get(event);
-    if (listeners) {
-      for (const listener of listeners) {
-        listener(...args);
-      }
-    }
-  }
-};
-var circuitBreakers = /* @__PURE__ */ new Map();
-function getCircuitBreaker(name = "default", config) {
-  let breaker = circuitBreakers.get(name);
-  if (!breaker) {
-    breaker = new CircuitBreaker({ ...config, name });
-    circuitBreakers.set(name, breaker);
-  }
-  return breaker;
-}
-function resetAllCircuitBreakers() {
-  for (const breaker of circuitBreakers.values()) {
-    breaker.reset();
-  }
-}
-function getGlobalCircuitBreaker() {
-  return getCircuitBreaker("global");
-}
-
-export { BrowserPosterLoader, BrowserVideoLoader, CircuitBreaker, CircuitOpenError, DEFAULT_REQUEST_CONFIG, DEFAULT_RETRY_CONFIG, HttpClient, HttpError, LocalSessionStorageAdapter, LocalStorageAdapter, MockAnalyticsAdapter, MockCommentAdapter, MockDataAdapter, MockInteractionAdapter, MockLoggerAdapter, MockNetworkAdapter, MockPosterLoader, MockSessionStorageAdapter, MockStorageAdapter, MockVideoLoader, RESTAnalyticsAdapter, RESTCommentAdapter, RESTDataAdapter, RESTInteractionAdapter, RESTViewTrackingAdapter, WebNetworkAdapter, createBrowserAdapters, createBrowserPosterLoader, createBrowserVideoLoader, createLocalStorageAdapter, createNoOpAnalyticsAdapter, createRESTAdapters, createSessionStorageAdapter, createTransforms, createWebNetworkAdapter, defaultFeedResponseTransform, defaultVideoItemTransform, getCircuitBreaker, getGlobalCircuitBreaker, resetAllCircuitBreakers };
+export { BrowserPosterLoader, BrowserVideoLoader, DEFAULT_REQUEST_CONFIG, DEFAULT_RETRY_CONFIG, HttpClient, HttpError, LocalSessionStorageAdapter, LocalStorageAdapter, MockAnalyticsAdapter, MockCommentAdapter, MockDataAdapter, MockInteractionAdapter, MockLoggerAdapter, MockNetworkAdapter, MockPlaylistAdapter, MockPosterLoader, MockSessionStorageAdapter, MockStorageAdapter, MockVideoLoader, RESTAnalyticsAdapter, RESTCommentAdapter, RESTDataAdapter, RESTInteractionAdapter, RESTViewTrackingAdapter, WebNetworkAdapter, createBrowserAdapters, createBrowserPosterLoader, createBrowserVideoLoader, createLocalStorageAdapter, createNoOpAnalyticsAdapter, createRESTAdapters, createSessionStorageAdapter, createTransforms, createWebNetworkAdapter, defaultFeedResponseTransform, defaultVideoItemTransform };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xhub-short/adapters",
   "sideEffects": false,
-  "version": "0.1.0-beta.10",
+  "version": "0.1.0-beta.12",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -20,7 +20,7 @@
     "dist"
   ],
   "dependencies": {
-    "@xhub-short/contracts": "0.1.0-beta.10"
+    "@xhub-short/contracts": "0.1.0-beta.12"
   },
   "optionalDependencies": {
     "hls.js": "^1.5.0"
@@ -29,8 +29,8 @@
     "tsup": "^8.3.0",
     "typescript": "^5.7.0",
     "vitest": "^2.1.0",
-    "@xhub-short/tsconfig": "0.0.0",
-    "@xhub-short/vitest-config": "0.0.1-beta.9"
+    "@xhub-short/vitest-config": "0.1.0-beta.11",
+    "@xhub-short/tsconfig": "0.0.1-beta.0"
   },
   "scripts": {
     "build": "tsup",