@xhub-short/adapters 0.1.0-beta.11 → 0.1.0-beta.13

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, ReportReason, 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
  */
@@ -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
      */
@@ -1132,6 +1161,16 @@ 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
@@ -1479,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;
 }
@@ -1946,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) */
@@ -2143,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;
 
@@ -2675,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, 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 };
+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,
@@ -2610,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 ?? ""),
@@ -2900,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;
@@ -3370,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;
@@ -3477,6 +3718,7 @@ function defaultVideoItemTransform(apiResponse, fieldMap, logger) {
   const author = defaultAuthorTransform(obj);
   const stats = defaultStatsTransform(obj);
   const videoItem = {
+    type: "video",
     id,
     source,
     poster: toSafeString(
@@ -3558,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)
   };
 }
 
@@ -3637,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
   };
 }
 
@@ -4276,8 +4535,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, RESTViewTrackingAdapter, 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 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xhub-short/adapters",
   "sideEffects": false,
-  "version": "0.1.0-beta.11",
+  "version": "0.1.0-beta.13",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -20,7 +20,7 @@
     "dist"
   ],
   "dependencies": {
-    "@xhub-short/contracts": "0.1.0-beta.11"
+    "@xhub-short/contracts": "0.1.0-beta.13"
   },
   "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.1.0-beta.10"
+    "@xhub-short/tsconfig": "0.0.1-beta.1",
+    "@xhub-short/vitest-config": "0.1.0-beta.12"
   },
   "scripts": {
     "build": "tsup",