@xhub-short/adapters 0.1.0-beta.8 → 1.0.0-beta.21

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",
@@ -529,20 +549,20 @@ var MOCK_VIDEOS = [
 ];
 var MockDataAdapter = class {
   constructor(options = {}) {
-    this.videos = options.videos ?? MOCK_VIDEOS;
+    this.items = options.items ?? options.videos ?? MOCK_VIDEOS;
     this.pageSize = options.pageSize ?? 3;
     this.delay = options.delay ?? 300;
   }
   /**
-   * Fetch a page of mock videos
+   * Fetch a page of mock items
    */
   async fetchFeed(cursor) {
     await this.simulateDelay();
     const offset = cursor ? Number.parseInt(cursor, 10) : 0;
     const start = offset;
     const end = start + this.pageSize;
-    const items = this.videos.slice(start, end);
-    const hasMore = end < this.videos.length;
+    const items = this.items.slice(start, end);
+    const hasMore = end < this.items.length;
     const nextCursor = hasMore ? String(end) : null;
     return {
       items,
@@ -551,15 +571,21 @@ var MockDataAdapter = class {
     };
   }
   /**
-   * Get a single video by ID
+   * Get a single content item by ID
    */
-  async getVideoDetail(id) {
+  async getContentDetail(id) {
     await this.simulateDelay();
-    const video = this.videos.find((v) => v.id === id);
-    if (!video) {
-      throw new Error(`Video not found: ${id}`);
+    const item = this.items.find((v) => v.id === id);
+    if (!item) {
+      throw new Error(`Content not found: ${id}`);
     }
-    return video;
+    return item;
+  }
+  /**
+   * @deprecated Use getContentDetail instead
+   */
+  async getVideoDetail(id) {
+    return this.getContentDetail(id);
   }
   /**
    * Prefetch videos (no-op for mock)
@@ -575,6 +601,87 @@ var MockDataAdapter = class {
     }
   }
 };
+var MOCK_ITEMS = MOCK_VIDEOS;
+
+// 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_ITEMS.slice(0, 4);
+    else if (id === "p2") items = MOCK_ITEMS.slice(4, 8);
+    else if (id === "p3") items = MOCK_ITEMS.slice(8, 12);
+    else if (id === "p4") items = MOCK_ITEMS.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 = {
@@ -1107,9 +1214,9 @@ 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) {
     await this.simulateDelay();
@@ -1435,27 +1542,23 @@ var MockCommentAdapter = class {
     await this.simulateNetworkDelay();
     if (payload.isReply && payload.parentId) {
       const replies = this.replies.get(payload.parentId) ?? [];
-      const filtered = replies.filter((r) => r.id !== payload.id);
+      const filtered = replies.filter((r) => r.id !== payload.commentId);
       this.replies.set(payload.parentId, filtered);
-      for (const [videoId, comments] of this.comments) {
-        const idx = comments.findIndex((c) => c.id === payload.parentId);
-        if (idx !== -1 && comments[idx]) {
-          comments[idx] = {
-            ...comments[idx],
-            replyCount: Math.max(0, comments[idx].replyCount - 1)
-          };
-          this.comments.set(videoId, comments);
-          break;
-        }
+      const comments = this.comments.get(payload.videoId) ?? [];
+      const idx = comments.findIndex((c) => c.id === payload.parentId);
+      if (idx !== -1 && comments[idx]) {
+        comments[idx] = {
+          ...comments[idx],
+          replyCount: Math.max(0, comments[idx].replyCount - 1)
+        };
+        this.comments.set(payload.videoId, comments);
       }
     } else {
-      for (const [videoId, comments] of this.comments) {
-        const filtered = comments.filter((c) => c.id !== payload.id);
-        if (filtered.length !== comments.length) {
-          this.comments.set(videoId, filtered);
-          this.replies.delete(payload.id);
-          break;
-        }
+      const comments = this.comments.get(payload.videoId) ?? [];
+      const filtered = comments.filter((c) => c.id !== payload.commentId);
+      if (filtered.length !== comments.length) {
+        this.comments.set(payload.videoId, filtered);
+        this.replies.delete(payload.commentId);
       }
     }
   }
@@ -1986,6 +2089,28 @@ var MockPosterLoader = class {
 // src/preset/adapters/RESTAnalyticsAdapter.ts
 var DEFAULT_BATCH_SIZE = 10;
 var DEFAULT_FLUSH_INTERVAL = 3e4;
+var DEFAULT_EVENT_TYPE_MAP = {
+  video_view: "view_start",
+  video_complete: "view_end",
+  scroll: "scroll_pass",
+  like: "like",
+  unlike: "like",
+  // Same API type, different action
+  comment: "comment",
+  share: "share",
+  follow: "follow_creator",
+  unfollow: "follow_creator",
+  // Same API type, different action
+  impression: "view_start"
+};
+var DEFAULT_CONTEXT = {
+  getSessionId: () => null,
+  getDeviceType: () => "web",
+  getNetworkType: () => "other",
+  getGeoLocation: () => null,
+  getPositionIndex: () => 0,
+  getScrollSpeed: () => null
+};
 var RESTAnalyticsAdapter = class {
   constructor(config) {
     // Event queue
@@ -1995,12 +2120,19 @@ var RESTAnalyticsAdapter = class {
     // User context
     this.userId = null;
     this.userProperties = {};
+    // Dedupe: track which videos have been viewed (to avoid duplicate view_start)
+    this.viewedVideos = /* @__PURE__ */ new Set();
     this.httpClient = config.httpClient;
     this.endpoint = config.endpoints.batch;
-    this.batchSize = config.batchSize ?? DEFAULT_BATCH_SIZE;
     this.logger = config.logger;
-    const interval = config.flushInterval ?? DEFAULT_FLUSH_INTERVAL;
-    this.flushTimer = setInterval(() => this.flush(), interval);
+    const batchConfig = config.config;
+    this.batchSize = batchConfig?.batchSize ?? config.batchSize ?? DEFAULT_BATCH_SIZE;
+    const flushInterval = batchConfig?.flushInterval ?? config.flushInterval ?? DEFAULT_FLUSH_INTERVAL;
+    this.transform = batchConfig?.transform;
+    this.context = batchConfig?.context ?? DEFAULT_CONTEXT;
+    this.eventTypeMap = batchConfig?.eventTypeMap ?? DEFAULT_EVENT_TYPE_MAP;
+    this.useSendBeacon = batchConfig?.useSendBeacon ?? true;
+    this.flushTimer = setInterval(() => this.flush(), flushInterval);
   }
   /**
    * Track an analytics event
@@ -2032,19 +2164,14 @@ var RESTAnalyticsAdapter = class {
     const events = [...this.queue];
     this.queue = [];
     try {
-      if (this.trySendBeacon(events)) {
-        this.logger?.debug("[RESTAnalyticsAdapter] Events sent via sendBeacon", {
-          count: events.length
-        });
+      const requestBody = await this.buildRequestBody(events);
+      if (this.trySendBeacon(requestBody)) {
         return;
       }
       await this.httpClient.request({
         method: "POST",
         path: this.endpoint,
-        body: { events }
-      });
-      this.logger?.debug("[RESTAnalyticsAdapter] Events sent via HTTP", {
-        count: events.length
+        body: requestBody
       });
     } catch (error) {
       if (this.queue.length < this.batchSize * 3) {
@@ -2054,9 +2181,48 @@ var RESTAnalyticsAdapter = class {
     }
   }
   /**
-   * Track video view duration (heartbeat)
+   * Build request body from events
+   * Uses custom transform if provided, otherwise SDK default format
+   */
+  async buildRequestBody(events) {
+    if (!this.transform) {
+      return { events };
+    }
+    const transformedEvents = [];
+    for (const event of events) {
+      try {
+        const eventData = {
+          sdkEventType: event.type,
+          videoId: event.videoId,
+          timestamp: event.timestamp,
+          userId: this.userId,
+          userProperties: this.userProperties,
+          data: event.data
+        };
+        const transformed = await this.transform(eventData, this.context);
+        transformedEvents.push(transformed);
+      } catch (error) {
+        this.logger?.warn("[RESTAnalyticsAdapter] Transform failed for event", {
+          event,
+          error
+        });
+      }
+    }
+    return { events: transformedEvents };
+  }
+  /**
+   * Track video view duration
+   *
+   * Note: PlayerEngine calls this every second (heartbeat), but for batch analytics
+   * we only need ONE view_start per video. This method deduplicates by videoId.
+   *
+   * If you need heartbeat tracking, use RESTViewTrackingAdapter instead.
    */
   trackViewDuration(videoId, duration, totalDuration) {
+    if (this.viewedVideos.has(videoId)) {
+      return;
+    }
+    this.viewedVideos.add(videoId);
     this.track({
       type: "video_view",
       videoId,
@@ -2068,6 +2234,12 @@ var RESTAnalyticsAdapter = class {
       }
     });
   }
+  /**
+   * Clear viewed videos cache (useful for testing or session reset)
+   */
+  clearViewedVideos() {
+    this.viewedVideos.clear();
+  }
   /**
    * Track video completion
    */
@@ -2103,19 +2275,26 @@ var RESTAnalyticsAdapter = class {
       clearInterval(this.flushTimer);
       this.flushTimer = null;
     }
+    this.viewedVideos.clear();
     this.flush().catch(() => {
     });
   }
   /**
    * Try to send via sendBeacon (for reliability on page unload)
+   * Note: sendBeacon shows as "ping" type in Network tab, not "POST"
+   *
+   * Set useSendBeacon: false in config to always use HTTP POST
    */
-  trySendBeacon(events) {
+  trySendBeacon(requestBody) {
+    if (this.useSendBeacon === false) {
+      return false;
+    }
     if (typeof navigator === "undefined" || !navigator.sendBeacon) {
       return false;
     }
     try {
       const url = this.buildFullUrl();
-      const data = JSON.stringify({ events });
+      const data = JSON.stringify(requestBody);
       const blob = new Blob([data], { type: "application/json" });
       return navigator.sendBeacon(url, blob);
     } catch {
@@ -2126,7 +2305,23 @@ var RESTAnalyticsAdapter = class {
    * Build full URL for sendBeacon
    */
   buildFullUrl() {
-    return this.endpoint.startsWith("http") ? this.endpoint : `${window.location.origin}${this.endpoint}`;
+    if (this.endpoint.startsWith("http")) {
+      return this.endpoint;
+    }
+    const baseUrl = this.httpClient.getBaseUrl();
+    return `${baseUrl}${this.endpoint}`;
+  }
+  /**
+   * Get mapped API event type from SDK event type
+   */
+  getApiEventType(sdkEventType) {
+    return this.eventTypeMap[sdkEventType] ?? sdkEventType;
+  }
+  /**
+   * Get current context (for debugging/testing)
+   */
+  getContext() {
+    return this.context;
   }
 };
 function createNoOpAnalyticsAdapter() {
@@ -2260,13 +2455,17 @@ var RESTCommentAdapter = class {
   }
   /**
    * Delete a comment or reply
+   * DELETE /reels/:id/comments/:commentId
    */
   async deleteComment(payload) {
     try {
       await this.httpClient.request({
         method: "DELETE",
         path: this.endpoints.delete,
-        pathParams: { id: payload.id }
+        pathParams: {
+          id: payload.videoId,
+          commentId: payload.commentId
+        }
       });
     } catch (error) {
       this.logger?.error("[RESTCommentAdapter] deleteComment failed", error);
@@ -2457,10 +2656,10 @@ var RESTDataAdapter = class {
       const feedData = this.transforms.feedResponse(response);
       const items = feedData.items.map((item) => {
         try {
-          return this.transforms.videoItem(item);
+          return this.transforms.contentItem(item);
         } catch (error) {
-          this.logger?.error("[RESTDataAdapter] Failed to transform video item", error);
-          return this.createFallbackVideoItem(item);
+          this.logger?.error("[RESTDataAdapter] Failed to transform content item", error);
+          return this.createFallbackItem(item);
         }
       });
       return {
@@ -2474,24 +2673,30 @@ var RESTDataAdapter = class {
     }
   }
   /**
-   * Get video detail by ID
+   * Get content detail by ID
    */
-  async getVideoDetail(id) {
+  async getContentDetail(id) {
     try {
       const response = await this.httpClient.request({
         method: "GET",
         path: this.endpoints.detail,
         pathParams: { id }
       });
-      const videoData = this.unwrapResponse(response);
-      return this.transforms.videoItem(videoData);
+      const itemData = this.unwrapResponse(response);
+      return this.transforms.contentItem(itemData);
     } catch (error) {
-      this.logger?.error("[RESTDataAdapter] getVideoDetail failed", error);
+      this.logger?.error("[RESTDataAdapter] getContentDetail failed", error);
       throw error;
     }
   }
   /**
-   * Optional: Prefetch videos
+   * @deprecated Use getContentDetail instead
+   */
+  async getVideoDetail(id) {
+    return this.getContentDetail(id);
+  }
+  /**
+   * Optional: Prefetch content
    * This is a no-op by default, can be overridden if API supports batch fetch
    */
   async prefetch(ids) {
@@ -2512,12 +2717,27 @@ var RESTDataAdapter = class {
     return response;
   }
   /**
-   * Create fallback video item when transform fails
+   * Create fallback content item when transform fails
    */
-  createFallbackVideoItem(data) {
+  createFallbackItem(data) {
     const obj = data ?? {};
+    const id = String(obj.id ?? obj.video_id ?? obj.article_id ?? `fallback-${Date.now()}`);
+    if (obj.type === "article" || obj.images || obj.photos) {
+      return {
+        type: "article",
+        id,
+        images: [],
+        caption: "",
+        author: { id: "unknown", name: "Unknown" },
+        stats: { likes: 0, comments: 0, shares: 0, views: 0 },
+        isLiked: false,
+        isFollowing: false,
+        createdAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+    }
     return {
-      id: String(obj.id ?? obj.video_id ?? `fallback-${Date.now()}`),
+      type: "video",
+      id,
       source: {
         url: String(obj.video_url ?? obj.url ?? ""),
         type: "mp4"
@@ -2531,7 +2751,8 @@ var RESTDataAdapter = class {
         views: 0,
         likes: 0,
         comments: 0,
-        shares: 0
+        shares: 0,
+        bookmarks: 0
       },
       isLiked: false,
       isFollowing: false,
@@ -2546,6 +2767,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
@@ -2670,6 +2893,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
    */
@@ -2704,6 +3028,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;
@@ -2958,6 +3345,12 @@ var HttpClient = class {
     };
     this.retryConfig = mergedRetry;
   }
+  /**
+   * Get base URL (for sendBeacon which needs full URL)
+   */
+  getBaseUrl() {
+    return this.config.baseUrl;
+  }
   /**
    * Make HTTP request with auth and retry
    */
@@ -3168,6 +3561,83 @@ var HttpClient = class {
   }
 };
 
+// src/preset/transforms/playlist.ts
+function defaultPlaylistTransform(apiResponse, contentItemTransform, 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 contentItemTransform(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;
@@ -3230,9 +3700,11 @@ function defaultAuthorTransform(data) {
   return {
     id: toSafeString(tryFields(author, "id", "user_id", "author_id"), ""),
     name: toSafeString(
-      tryFields(author, "display_name", "name", "username", "nickname"),
+      tryFields(author, "display_name", "name", "username", "nickname", "first_name"),
       "Unknown"
     ),
+    // Combine first/last name if present and name is default
+    // Note: This is a simple fallback, specialized logic should be in a custom transform if needed
     avatar: toSafeString(
       tryFields(author, "avatar", "avatar_url", "profile_picture", "photo"),
       void 0
@@ -3248,7 +3720,8 @@ function defaultStatsTransform(data) {
     views: toNumber(tryFields(stats, "view_count", "views", "play_count"), 0),
     likes: toNumber(tryFields(stats, "like_count", "likes", "digg_count"), 0),
     comments: toNumber(tryFields(stats, "comment_count", "comments"), 0),
-    shares: toNumber(tryFields(stats, "share_count", "shares"), 0)
+    shares: toNumber(tryFields(stats, "share_count", "shares"), 0),
+    bookmarks: toNumber(tryFields(stats, "bookmark_count", "bookmarks", "saves"), 0)
   };
 }
 function defaultVideoItemTransform(apiResponse, fieldMap, logger) {
@@ -3275,6 +3748,7 @@ function defaultVideoItemTransform(apiResponse, fieldMap, logger) {
   const author = defaultAuthorTransform(obj);
   const stats = defaultStatsTransform(obj);
   const videoItem = {
+    type: "video",
     id,
     source,
     poster: toSafeString(
@@ -3301,6 +3775,110 @@ function defaultVideoItemTransform(apiResponse, fieldMap, logger) {
   };
   return videoItem;
 }
+function defaultArticleItemTransform(apiResponse, fieldMap, logger) {
+  const obj = apiResponse;
+  const getMapped = (sdkField, ...fallbacks) => {
+    if (fieldMap?.[sdkField]) {
+      const mapped = getNestedValue(obj, fieldMap[sdkField]);
+      if (mapped !== void 0) return mapped;
+    }
+    return tryFields(obj, ...fallbacks);
+  };
+  const id = toSafeString(getMapped("id", "id", "article_id", "post_id", "_id"), "");
+  if (!id) {
+    logger?.warn("[Transform article] Missing required field: id", { data: obj });
+  }
+  let images = getMapped("images", "images", "media", "photos", "gallery") ?? [];
+  if (!Array.isArray(images) || images.length === 0) {
+    const singleImage = toSafeString(
+      getMapped("image", "image_url", "url", "thumbnail", "cover"),
+      void 0
+    );
+    images = singleImage ? [singleImage] : [];
+  }
+  return {
+    type: "article",
+    id,
+    images,
+    caption: toSafeString(
+      getMapped("caption", "caption", "description", "text", "content", "title", "subject"),
+      ""
+    ),
+    author: defaultAuthorTransform(obj),
+    stats: defaultStatsTransform(obj),
+    isLiked: toBoolean(getMapped("isLiked", "is_liked", "liked", "user_liked"), false),
+    isFollowing: toBoolean(getMapped("isFollowing", "is_following", "following"), false),
+    createdAt: toSafeString(
+      getMapped("createdAt", "created_at", "create_time", "timestamp"),
+      (/* @__PURE__ */ new Date()).toISOString()
+    ),
+    hashtags: getMapped("hashtags", "hashtags", "tags", "hash_tags") ?? []
+  };
+}
+function extractMediaInfo(obj) {
+  const mediaList = tryFields(obj, "media", "medias") ?? [];
+  let videoMedia;
+  let imageMedias = [];
+  if (Array.isArray(mediaList) && mediaList.length > 0) {
+    videoMedia = mediaList.find((m) => m.type === "video");
+    imageMedias = mediaList.filter((m) => m.type === "image");
+  }
+  return { videoMedia, imageMedias };
+}
+function extractMusicInfo(obj) {
+  const soundObj = tryFields(obj, "sound", "music", "audio");
+  if (soundObj && (soundObj.id || soundObj.url || soundObj.name || soundObj.title)) {
+    return {
+      id: toSafeString(tryFields(soundObj, "id", "uuid"), "unknown"),
+      title: toSafeString(tryFields(soundObj, "title", "name", "song"), "Unknown Sound"),
+      artist: toSafeString(tryFields(soundObj, "artist", "author", "singer"), "Unknown Artist"),
+      cover: toSafeString(tryFields(soundObj, "cover", "poster", "thumbnail", "image"), void 0),
+      audioUrl: toSafeString(tryFields(soundObj, "url", "audio_url", "download_url"), void 0)
+    };
+  }
+  return void 0;
+}
+function defaultContentItemTransform(apiResponse, fieldMap, logger) {
+  const obj = apiResponse;
+  const { videoMedia, imageMedias } = extractMediaInfo(obj);
+  const musicInfo = extractMusicInfo(obj);
+  const typeField = toSafeString(tryFields(obj, "type", "content_type", "item_type")).toLowerCase();
+  let isVideo = false;
+  if (["article", "image", "post", "photo"].includes(typeField)) {
+    isVideo = false;
+  } else if (["video", "reel", "short"].includes(typeField)) {
+    isVideo = true;
+  } else {
+    if (videoMedia || tryFields(obj, "video_url", "playback_url", "source")) {
+      isVideo = true;
+    } else if (imageMedias.length > 0 || tryFields(obj, "images", "photos", "gallery")) {
+      isVideo = false;
+    } else {
+      isVideo = true;
+    }
+  }
+  if (isVideo) {
+    if (videoMedia) {
+      Object.assign(obj, {
+        video_url: videoMedia.url || videoMedia.download_url,
+        poster: videoMedia.poster || videoMedia.thumbnail,
+        duration: videoMedia.duration
+      });
+    }
+    const item2 = defaultVideoItemTransform(apiResponse, fieldMap?.video, logger);
+    if (musicInfo) item2.music = musicInfo;
+    return item2;
+  }
+  if (imageMedias.length > 0) {
+    const imageUrls = imageMedias.map((m) => toSafeString(m.url || m.download_url)).filter(Boolean);
+    if (imageUrls.length > 0) {
+      obj.images = imageUrls;
+    }
+  }
+  const item = defaultArticleItemTransform(apiResponse, fieldMap?.article, logger);
+  if (musicInfo) item.music = musicInfo;
+  return item;
+}
 function defaultFeedResponseTransform(apiResponse, fieldMap, logger) {
   const obj = apiResponse;
   const itemsPath = fieldMap?.items;
@@ -3354,9 +3932,22 @@ function defaultFeedResponseTransform(apiResponse, fieldMap, logger) {
   return { items, nextCursor, hasMore };
 }
 function createTransforms(config, logger) {
+  const contentItem = (data) => {
+    if (config?.contentItem) return config.contentItem(data);
+    if (config?.videoItem) return config.videoItem(data);
+    return defaultContentItemTransform(data, config?.fieldMap, 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)
+    contentItem,
+    videoItem: (data) => contentItem(data),
+    feedResponse: config?.feedResponse ? config.feedResponse : (data) => defaultFeedResponseTransform(data, config?.fieldMap?.feed, logger),
+    playlist: config?.playlist ? config.playlist : (data) => defaultPlaylistTransform(
+      data,
+      (item) => contentItem(item),
+      // Pass the generic contentItem transform
+      logger
+    ),
+    playlistCollection: config?.playlistCollection ? config.playlistCollection : (data) => defaultPlaylistCollectionTransform(data, logger)
   };
 }
 
@@ -3408,7 +3999,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) {
@@ -3422,6 +4015,7 @@ function createRESTAdapters(config) {
     analytics = new RESTAnalyticsAdapter({
       httpClient,
       endpoints: endpoints.analytics,
+      config: config.batchAnalytics,
       logger
     });
   } else {
@@ -3432,11 +4026,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
   };
 }
 
@@ -3807,6 +4412,25 @@ var LocalStorageAdapter = class {
       count: keysToRemove.length
     });
   }
+  /**
+   * Get a value from localStorage synchronously
+   *
+   * Used for zero-flash cache hydration during React render phase.
+   * localStorage is inherently synchronous, so this bypasses the async wrapper.
+   */
+  getSync(key) {
+    try {
+      const fullKey = this.buildKey(key);
+      const value = localStorage.getItem(fullKey);
+      if (value === null) {
+        return null;
+      }
+      return JSON.parse(value);
+    } catch (error) {
+      this.logger?.warn("[LocalStorageAdapter] Failed to getSync/parse value", { key, error });
+      return null;
+    }
+  }
   /**
    * Get all SDK-namespaced keys
    */
@@ -4071,8 +4695,9 @@ function createBrowserAdapters(config) {
     videoLoader,
     posterLoader,
     comment,
+    playlist: restAdapters.playlist,
     logger: config.logger
   };
 }
 
-export { BrowserPosterLoader, BrowserVideoLoader, DEFAULT_REQUEST_CONFIG, DEFAULT_RETRY_CONFIG, HttpClient, HttpError, LocalSessionStorageAdapter, LocalStorageAdapter, MockAnalyticsAdapter, MockCommentAdapter, MockDataAdapter, MockInteractionAdapter, MockLoggerAdapter, MockNetworkAdapter, MockPosterLoader, MockSessionStorageAdapter, MockStorageAdapter, MockVideoLoader, RESTAnalyticsAdapter, RESTCommentAdapter, RESTDataAdapter, RESTInteractionAdapter, WebNetworkAdapter, createBrowserAdapters, createBrowserPosterLoader, createBrowserVideoLoader, createLocalStorageAdapter, createNoOpAnalyticsAdapter, createRESTAdapters, createSessionStorageAdapter, createTransforms, createWebNetworkAdapter, defaultFeedResponseTransform, defaultVideoItemTransform };
+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 };