@xhub-short/core 1.0.0-beta.24 → 1.0.0-beta.26

package/dist/index.d.ts

@@ -2023,6 +2023,7 @@ interface PlaylistCollectionState {
 declare class PlaylistManager {
     private readonly dataSource?;
     private readonly governor?;
+    private readonly storage?;
     /** Zustand vanilla store */
     readonly store: StoreApi<PlaylistState>;
     /** Resolved configuration */
@@ -2034,10 +2035,17 @@ declare class PlaylistManager {
     private fullMetadataItems;
     /** Unsubscribe from governor events */
     private governorUnsubscribe?;
-    constructor(dataSource?: IPlaylistDataSource | undefined, config?: PlaylistConfig, governor?: ResourceGovernor | undefined);
+    constructor(dataSource?: IPlaylistDataSource | undefined, config?: PlaylistConfig, governor?: ResourceGovernor | undefined, storage?: ISessionStorage | undefined);
     /**
      * Load a playlist by ID
      */
+    /**
+     * Generates a cache key for a specific playlist
+     */
+    private getCacheKey;
+    /**
+     * Load playlist data, using cache for an immediate render before network finishes.
+     */
     loadPlaylist(id: string): Promise<void>;
     /**
      * Set playlist data directly
@@ -2059,6 +2067,14 @@ declare class PlaylistManager {
      * Reset state
      */
     reset(): void;
+    /**
+     * Get the full (un-minified) list of items in the current playlist.
+     *
+     * Unlike `store.items` (which applies the sliding window and may contain
+     * minified items), this always returns the complete metadata for every item.
+     * Used by PlaylistFeedAdapter to ensure FeedManager receives playable data.
+     */
+    getFullItems(): ContentItem[];
     /**
      * Destroy the manager
      */
@@ -2085,9 +2101,20 @@ declare class PlaylistManager {
  */
 declare class PlaylistCollectionManager {
     private readonly dataSource?;
+    private readonly storage?;
     /** Zustand vanilla store */
     readonly store: StoreApi<PlaylistCollectionState>;
-    constructor(dataSource?: IPlaylistDataSource | undefined);
+    /** Cache key for playlist collection */
+    private static readonly CACHE_KEY;
+    constructor(dataSource?: IPlaylistDataSource | undefined, storage?: ISessionStorage | undefined);
+    /**
+     * Hydrate collection from cache
+     */
+    hydrateFromCache(): Promise<void>;
+    /**
+     * Update cache with current state
+     */
+    private updateCache;
     /**
      * Load more playlists (pagination)
      */

package/dist/index.js

@@ -2042,11 +2042,21 @@ function calculateWindowIndices(focusedIndex, totalItems, maxAllocations = 3) {
   const indices = [];
   const clampedFocus = Math.max(0, Math.min(focusedIndex, totalItems - 1));
   indices.push(clampedFocus);
-  if (clampedFocus > 0 && indices.length < maxAllocations) {
-    indices.push(clampedFocus - 1);
-  }
-  if (clampedFocus < totalItems - 1 && indices.length < maxAllocations) {
-    indices.push(clampedFocus + 1);
+  let offset = 1;
+  while (indices.length < maxAllocations) {
+    let added = false;
+    if (clampedFocus - offset >= 0 && indices.length < maxAllocations) {
+      indices.push(clampedFocus - offset);
+      added = true;
+    }
+    if (clampedFocus + offset < totalItems && indices.length < maxAllocations) {
+      indices.push(clampedFocus + offset);
+      added = true;
+    }
+    if (!added) {
+      break;
+    }
+    offset++;
   }
   return indices.sort((a, b) => a - b);
 }
@@ -2101,18 +2111,18 @@ function mapNetworkType(type) {
 }
 var DEFAULT_SCROLL_THRASHING_CONFIG = {
   windowMs: 1e3,
-  maxChangesInWindow: 6,
-  cooldownMs: 300
+  maxChangesInWindow: 3,
+  cooldownMs: 500
 };
 var DEFAULT_PREFETCH_CONFIG = {
   wifi: {
-    posterCount: 15,
-    videoSegmentCount: 10,
+    posterCount: 5,
+    videoSegmentCount: 2,
     prefetchVideo: true
   },
   cellular: {
-    posterCount: 10,
-    videoSegmentCount: 5,
+    posterCount: 3,
+    videoSegmentCount: 1,
     prefetchVideo: true
   },
   offline: {
@@ -2567,7 +2577,7 @@ var ResourceGovernor = class {
       newPreloadingIndices.add(index);
     }
     this.store.setState({ preloadingIndices: newPreloadingIndices });
-    const maxParallel = 3;
+    const maxParallel = 2;
     const executeInBatches = async () => {
       for (let i = 0; i < indicesToPreload.length; i += maxParallel) {
         const batch = indicesToPreload.slice(i, i + maxParallel);
@@ -3678,9 +3688,10 @@ var createInitialState6 = () => ({
   error: null
 });
 var PlaylistManager = class {
-  constructor(dataSource, config = {}, governor) {
+  constructor(dataSource, config = {}, governor, storage) {
     this.dataSource = dataSource;
     this.governor = governor;
+    this.storage = storage;
     /**
      * Internal cache of full metadata items.
      * Items in store.items may be minified to save memory.
@@ -3704,20 +3715,49 @@ var PlaylistManager = class {
   /**
    * Load a playlist by ID
    */
+  /**
+   * Generates a cache key for a specific playlist
+   */
+  getCacheKey(id) {
+    return `sv-playlist-data-${id}`;
+  }
+  /**
+   * Load playlist data, using cache for an immediate render before network finishes.
+   */
   async loadPlaylist(id) {
     if (!this.dataSource) {
       this.store.setState({ error: new Error("No playlist data source provided") });
       return;
     }
+    const cacheKey = this.getCacheKey(id);
+    try {
+      if (this.storage) {
+        const cachedPlaylist = await this.storage.get(cacheKey);
+        if (cachedPlaylist) {
+          this.setPlaylist(cachedPlaylist);
+        }
+      }
+    } catch {
+    }
     this.store.setState({ loading: true, error: null });
     try {
       const playlist = await this.dataSource.fetchPlaylist(id);
       this.setPlaylist(playlist);
+      if (this.storage) {
+        const itemsToCache = playlist.items.slice(0, Math.max(this.config.metadataWindowSize, 5));
+        const cachePayload = { ...playlist, items: itemsToCache };
+        this.storage.set(cacheKey, cachePayload).catch(() => {
+        });
+      }
     } catch (error) {
-      this.store.setState({
-        loading: false,
-        error: error instanceof Error ? error : new Error("Failed to load playlist")
-      });
+      if (!this.store.getState().playlist) {
+        this.store.setState({
+          loading: false,
+          error: error instanceof Error ? error : new Error("Failed to load playlist")
+        });
+      } else {
+        this.store.setState({ loading: false });
+      }
     }
   }
   /**
@@ -3725,10 +3765,15 @@ var PlaylistManager = class {
    */
   setPlaylist(playlist) {
     this.fullMetadataItems = [...playlist.items];
-    this.updateMetadataWindow(0);
+    const { metadataWindowSize } = this.config;
+    const end = Math.min(this.fullMetadataItems.length, metadataWindowSize);
+    const windowedItems = this.fullMetadataItems.map(
+      (item, index) => index < end ? item : this.minifyItem(item)
+    );
     this.store.setState({
       playlist,
       currentIndex: 0,
+      items: windowedItems,
       loading: false,
       error: null
     });
@@ -3767,6 +3812,16 @@ var PlaylistManager = class {
     this.fullMetadataItems = [];
     this.store.setState(createInitialState6());
   }
+  /**
+   * Get the full (un-minified) list of items in the current playlist.
+   *
+   * Unlike `store.items` (which applies the sliding window and may contain
+   * minified items), this always returns the complete metadata for every item.
+   * Used by PlaylistFeedAdapter to ensure FeedManager receives playable data.
+   */
+  getFullItems() {
+    return [...this.fullMetadataItems];
+  }
   /**
    * Destroy the manager
    */
@@ -3829,11 +3884,38 @@ var createInitialState7 = () => ({
   hasMore: true,
   error: null
 });
-var PlaylistCollectionManager = class {
-  constructor(dataSource) {
+var _PlaylistCollectionManager = class _PlaylistCollectionManager {
+  constructor(dataSource, storage) {
     this.dataSource = dataSource;
+    this.storage = storage;
     this.store = createStore(createInitialState7);
   }
+  /**
+   * Hydrate collection from cache
+   */
+  async hydrateFromCache() {
+    if (!this.storage) return;
+    try {
+      const cached = await this.storage.get(_PlaylistCollectionManager.CACHE_KEY);
+      if (Array.isArray(cached?.playlists)) {
+        this.store.setState({
+          playlists: cached.playlists,
+          cursor: cached.cursor,
+          hasMore: cached.hasMore
+        });
+      }
+    } catch {
+    }
+  }
+  /**
+   * Update cache with current state
+   */
+  updateCache() {
+    if (!this.storage) return;
+    const { playlists, cursor, hasMore } = this.store.getState();
+    this.storage.set(_PlaylistCollectionManager.CACHE_KEY, { playlists, cursor, hasMore }).catch(() => {
+    });
+  }
   /**
    * Load more playlists (pagination)
    */
@@ -3849,6 +3931,7 @@ var PlaylistCollectionManager = class {
         hasMore: response.hasMore,
         loading: false
       }));
+      this.updateCache();
     } catch (error) {
       this.store.setState({
         loading: false,
@@ -3871,6 +3954,7 @@ var PlaylistCollectionManager = class {
         loading: false,
         error: null
       });
+      this.updateCache();
     } catch (error) {
       this.store.setState({
         loading: false,
@@ -3885,5 +3969,8 @@ var PlaylistCollectionManager = class {
     this.store.setState(createInitialState7());
   }
 };
+/** Cache key for playlist collection */
+_PlaylistCollectionManager.CACHE_KEY = "sv-playlist-collection";
+var PlaylistCollectionManager = _PlaylistCollectionManager;
 
 export { CommentManager, DEFAULT_COMMENT_MANAGER_CONFIG, DEFAULT_FEED_CONFIG, DEFAULT_LIFECYCLE_CONFIG, DEFAULT_OPTIMISTIC_CONFIG, DEFAULT_PLAYER_CONFIG, DEFAULT_PREFETCH_CACHE_CONFIG, DEFAULT_PREFETCH_CONFIG, DEFAULT_RESOURCE_CONFIG, FeedManager, LifecycleManager, OptimisticManager, PlayerEngine, PlayerStatus, PlaylistCollectionManager, PlaylistManager, ResourceGovernor, calculatePrefetchIndices, calculateWindowIndices, canPause, canPlay, canSeek, computeAllocationChanges, createInitialCommentState, createInitialVideoCommentState, isActiveState, isValidTransition, mapNetworkType };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xhub-short/core",
   "sideEffects": false,
-  "version": "1.0.0-beta.24",
+  "version": "1.0.0-beta.26",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -21,14 +21,14 @@
   ],
   "dependencies": {
     "zustand": "^5.0.0",
-    "@xhub-short/contracts": "1.0.0-beta.24"
+    "@xhub-short/contracts": "1.0.0-beta.26"
   },
   "devDependencies": {
     "tsup": "^8.3.0",
     "typescript": "^5.7.0",
     "vitest": "^2.1.0",
-    "@xhub-short/tsconfig": "0.1.0-beta.3",
-    "@xhub-short/vitest-config": "0.1.0-beta.14"
+    "@xhub-short/tsconfig": "0.0.1-beta.2",
+    "@xhub-short/vitest-config": "0.1.0-beta.13"
   },
   "scripts": {
     "build": "tsup",