@xhub-short/adapters 0.1.0-beta.14 → 0.1.0-beta.16

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-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';
+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, IPosterLoader, IVideoLoader, VideoSource, PreloadConfig, PreloadResult, PreloadStatus, ReportReason, CommentTransformers } from '@xhub-short/contracts';
 
 /**
  * MockDataAdapter - Development/Testing Data Source
@@ -1789,6 +1789,13 @@ declare class LocalStorageAdapter implements IStorage {
      * Clear all SDK-namespaced keys
      */
     clear(): Promise<void>;
+    /**
+     * 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<T>(key: string): T | null;
     /**
      * Get all SDK-namespaced keys
      */

package/dist/index.js

@@ -4271,6 +4271,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
    */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xhub-short/adapters",
   "sideEffects": false,
-  "version": "0.1.0-beta.14",
+  "version": "0.1.0-beta.16",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -20,7 +20,7 @@
     "dist"
   ],
   "dependencies": {
-    "@xhub-short/contracts": "0.1.0-beta.14"
+    "@xhub-short/contracts": "0.1.0-beta.16"
   },
   "optionalDependencies": {
     "hls.js": "^1.5.0"