@shortkitsdk/react-native 0.2.25 → 0.2.26

package/ios/ShortKitSDK.xcframework/ios-arm64_x86_64-simulator/ShortKitSDK.framework/Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface

@@ -244,6 +244,7 @@ public struct FeedConfig : Swift.Codable {
   public var surveyOverlay: ShortKitSDK.SurveyOverlayMode
   public var adOverlay: ShortKitSDK.AdOverlayMode
   public var liveOverlay: ShortKitSDK.LiveOverlayMode
+  public var liveRoomMask: ShortKitSDK.LiveRoomMaskMode
   public var muteOnStart: Swift.Bool
   public var autoplay: Swift.Bool
   public var feedSource: ShortKitSDK.FeedSource
@@ -251,9 +252,9 @@ public struct FeedConfig : Swift.Codable {
   public var pullToRefreshEnabled: Swift.Bool
   public var filter: ShortKitSDK.FeedFilter?
   public var preload: ShortKitSDK.FeedPreload?
-  public init(feedHeight: ShortKitSDK.FeedHeight = .fullscreen, scrollAxis: ShortKitSDK.ScrollAxis = .vertical, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, carouselOverlay: ShortKitSDK.CarouselOverlayMode = .none, videoCarouselOverlay: ShortKitSDK.VideoCarouselOverlayMode = .none, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, liveOverlay: ShortKitSDK.LiveOverlayMode = .default, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, pullToRefreshEnabled: Swift.Bool = true, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil)
-  public func encode(to encoder: any Swift.Encoder) throws
+  public init(feedHeight: ShortKitSDK.FeedHeight = .fullscreen, scrollAxis: ShortKitSDK.ScrollAxis = .vertical, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, carouselOverlay: ShortKitSDK.CarouselOverlayMode = .none, videoCarouselOverlay: ShortKitSDK.VideoCarouselOverlayMode = .none, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, liveOverlay: ShortKitSDK.LiveOverlayMode = .default, liveRoomMask: ShortKitSDK.LiveRoomMaskMode = .none, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, pullToRefreshEnabled: Swift.Bool = true, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil)
   public init(from decoder: any Swift.Decoder) throws
+  public func encode(to encoder: any Swift.Encoder) throws
 }
 public enum FeedMaskMode {
   case none
@@ -262,6 +263,13 @@ public enum FeedMaskMode {
 extension ShortKitSDK.FeedMaskMode : Swift.Equatable {
   public static func == (lhs: ShortKitSDK.FeedMaskMode, rhs: ShortKitSDK.FeedMaskMode) -> Swift.Bool
 }
+public enum LiveRoomMaskMode {
+  case none
+  case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.LiveRoomMask)
+}
+extension ShortKitSDK.LiveRoomMaskMode : Swift.Equatable {
+  public static func == (lhs: ShortKitSDK.LiveRoomMaskMode, rhs: ShortKitSDK.LiveRoomMaskMode) -> Swift.Bool
+}
 public enum VideoOverlayMode {
   case none
   case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.FeedOverlay)
@@ -419,6 +427,7 @@ public enum ShortKitDownloadError : Swift.Error {
   case cancelled
 }
 @_hasMissingDesignatedInitializers final public class FeedPreload : @unchecked Swift.Sendable {
+  public init(immediateItems items: [ShortKitSDK.FeedInput])
   @objc deinit
 }
 @_Concurrency.MainActor @preconcurrency public struct ShortKitFeedView : SwiftUI.UIViewControllerRepresentable {
@@ -438,9 +447,17 @@ public enum ShortKitDownloadError : Swift.Error {
   @_Concurrency.MainActor @preconcurrency public var onDismiss: (() -> Swift.Void)?
   @_Concurrency.MainActor @preconcurrency public var onRemainingContentCountChange: ((Swift.Int) -> Swift.Void)?
   @_Concurrency.MainActor @preconcurrency public var onFeedReady: (() -> Swift.Void)?
+  public struct VideoCarouselCellTapPayload {
+    public let id: Swift.String
+    public let index: Swift.Int
+    public let pageIndex: Swift.Int
+  }
+  @_Concurrency.MainActor @preconcurrency public var onVideoCarouselCellTap: ((ShortKitSDK.ShortKitFeedViewController.VideoCarouselCellTapPayload) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency public var onRefreshStateChanged: ((ShortKitSDK.ShortKitRefreshState) -> Swift.Void)?
   @_Concurrency.MainActor @preconcurrency public var seedThumbnail: UIKit.UIImage?
   @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.FeedConfig, startAtItemId: Swift.String? = nil)
-  @_Concurrency.MainActor public func setFeedItems(_ items: [ShortKitSDK.FeedInput])
+  @_Concurrency.MainActor public func setFeedItems(_ items: [ShortKitSDK.FeedInput], startAtId: Swift.String? = nil)
+  @_Concurrency.MainActor public func scrollToItem(id: Swift.String, animated: Swift.Bool)
   @_Concurrency.MainActor public func appendFeedItems(_ items: [ShortKitSDK.FeedInput])
   @_Concurrency.MainActor public func applyFilter(_ filter: ShortKitSDK.FeedFilter?)
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewDidLoad()
@@ -579,7 +596,8 @@ public struct ContentItem : Swift.Codable, Swift.Equatable, @unchecked Swift.Sen
   public var liveStreamId: Swift.String?
   public var liveStreamStatus: ShortKitSDK.LiveStreamStatus?
   public var startedAt: Swift.String?
-  public init(id: Swift.String, playbackId: Swift.String? = nil, title: Swift.String, description: Swift.String? = nil, duration: Swift.Double, streamingUrl: Swift.String, thumbnailUrl: Swift.String, captionTracks: [ShortKitSDK.CaptionTrack] = [], customMetadata: [Swift.String : ShortKitSDK.JSONValue]? = nil, author: Swift.String? = nil, articleUrl: Swift.String? = nil, commentCount: Swift.Int? = nil, fallbackUrl: Swift.String? = nil, downloadUrl: Swift.String? = nil, isLive: Swift.Bool = false, liveStreamId: Swift.String? = nil, liveStreamStatus: ShortKitSDK.LiveStreamStatus? = nil, startedAt: Swift.String? = nil)
+  public var currentViewers: Swift.Int
+  public init(id: Swift.String, playbackId: Swift.String? = nil, title: Swift.String, description: Swift.String? = nil, duration: Swift.Double, streamingUrl: Swift.String, thumbnailUrl: Swift.String, captionTracks: [ShortKitSDK.CaptionTrack] = [], customMetadata: [Swift.String : ShortKitSDK.JSONValue]? = nil, author: Swift.String? = nil, articleUrl: Swift.String? = nil, commentCount: Swift.Int? = nil, fallbackUrl: Swift.String? = nil, downloadUrl: Swift.String? = nil, isLive: Swift.Bool = false, liveStreamId: Swift.String? = nil, liveStreamStatus: ShortKitSDK.LiveStreamStatus? = nil, startedAt: Swift.String? = nil, currentViewers: Swift.Int = 0)
   public init(from decoder: any Swift.Decoder) throws
   public static func == (a: ShortKitSDK.ContentItem, b: ShortKitSDK.ContentItem) -> Swift.Bool
   public func encode(to encoder: any Swift.Encoder) throws
@@ -840,10 +858,23 @@ public protocol LiveOverlay : AnyObject {
   func configure(with item: ShortKitSDK.ContentItem)
   func activate()
   func deactivate()
-  func showEnded()
+  func liveStreamStatusDidChange(to status: ShortKitSDK.LiveStreamStatus)
+  func expand()
+  func collapse()
 }
 extension ShortKitSDK.LiveOverlay {
-  public func showEnded()
+  public func liveStreamStatusDidChange(to status: ShortKitSDK.LiveStreamStatus)
+  public func expand()
+  public func collapse()
+}
+public protocol LiveRoomMask : AnyObject {
+  var liveRegion: UIKit.UIView { get }
+  func attach(player: ShortKitSDK.ShortKitPlayer)
+  func configure(with item: ShortKitSDK.ContentItem)
+  func willDismiss()
+}
+extension ShortKitSDK.LiveRoomMask {
+  public func willDismiss()
 }
 public protocol SurveyOverlay : AnyObject {
   var onSurveyResponse: ((Swift.String, ShortKitSDK.SurveyOption) -> Swift.Void)? { get set }
@@ -975,6 +1006,19 @@ public enum ContentSignal : Swift.Equatable, Swift.Sendable {
   final public var remainingContentCount: Combine.AnyPublisher<Swift.Int, Swift.Never> {
     get
   }
+  final public var isLiveRoomExpanded: Combine.AnyPublisher<Swift.Bool, Swift.Never> {
+    get
+  }
+  final public var isLiveRoomExpandedValue: Swift.Bool {
+    get
+  }
+  final public var liveStreamStatus: Combine.AnyPublisher<ShortKitSDK.LiveStreamStatus?, Swift.Never> {
+    get
+  }
+  final public var liveStreamStatusValue: ShortKitSDK.LiveStreamStatus? {
+    get
+  }
+  final public func currentProgramDate() -> Foundation.Date?
   final public var currentItemValue: ShortKitSDK.ContentItem? {
     get
   }
@@ -993,6 +1037,7 @@ public enum ContentSignal : Swift.Equatable, Swift.Sendable {
   final public func setMaxBitrate(_ bps: Swift.Int)
   final public func setCaptionsEnabled(_ enabled: Swift.Bool)
   final public func selectCaptionTrack(language: Swift.String)
+  final public func dismissLiveRoom()
   final public func seekThumbnail(at time: Swift.Double) -> UIKit.UIImage?
   @objc deinit
 }

package/ios/ShortKitSDK.xcframework/ios-arm64_x86_64-simulator/ShortKitSDK.framework/Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface

@@ -244,6 +244,7 @@ public struct FeedConfig : Swift.Codable {
   public var surveyOverlay: ShortKitSDK.SurveyOverlayMode
   public var adOverlay: ShortKitSDK.AdOverlayMode
   public var liveOverlay: ShortKitSDK.LiveOverlayMode
+  public var liveRoomMask: ShortKitSDK.LiveRoomMaskMode
   public var muteOnStart: Swift.Bool
   public var autoplay: Swift.Bool
   public var feedSource: ShortKitSDK.FeedSource
@@ -251,9 +252,9 @@ public struct FeedConfig : Swift.Codable {
   public var pullToRefreshEnabled: Swift.Bool
   public var filter: ShortKitSDK.FeedFilter?
   public var preload: ShortKitSDK.FeedPreload?
-  public init(feedHeight: ShortKitSDK.FeedHeight = .fullscreen, scrollAxis: ShortKitSDK.ScrollAxis = .vertical, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, carouselOverlay: ShortKitSDK.CarouselOverlayMode = .none, videoCarouselOverlay: ShortKitSDK.VideoCarouselOverlayMode = .none, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, liveOverlay: ShortKitSDK.LiveOverlayMode = .default, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, pullToRefreshEnabled: Swift.Bool = true, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil)
-  public func encode(to encoder: any Swift.Encoder) throws
+  public init(feedHeight: ShortKitSDK.FeedHeight = .fullscreen, scrollAxis: ShortKitSDK.ScrollAxis = .vertical, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, carouselOverlay: ShortKitSDK.CarouselOverlayMode = .none, videoCarouselOverlay: ShortKitSDK.VideoCarouselOverlayMode = .none, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, liveOverlay: ShortKitSDK.LiveOverlayMode = .default, liveRoomMask: ShortKitSDK.LiveRoomMaskMode = .none, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, pullToRefreshEnabled: Swift.Bool = true, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil)
   public init(from decoder: any Swift.Decoder) throws
+  public func encode(to encoder: any Swift.Encoder) throws
 }
 public enum FeedMaskMode {
   case none
@@ -262,6 +263,13 @@ public enum FeedMaskMode {
 extension ShortKitSDK.FeedMaskMode : Swift.Equatable {
   public static func == (lhs: ShortKitSDK.FeedMaskMode, rhs: ShortKitSDK.FeedMaskMode) -> Swift.Bool
 }
+public enum LiveRoomMaskMode {
+  case none
+  case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.LiveRoomMask)
+}
+extension ShortKitSDK.LiveRoomMaskMode : Swift.Equatable {
+  public static func == (lhs: ShortKitSDK.LiveRoomMaskMode, rhs: ShortKitSDK.LiveRoomMaskMode) -> Swift.Bool
+}
 public enum VideoOverlayMode {
   case none
   case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.FeedOverlay)
@@ -419,6 +427,7 @@ public enum ShortKitDownloadError : Swift.Error {
   case cancelled
 }
 @_hasMissingDesignatedInitializers final public class FeedPreload : @unchecked Swift.Sendable {
+  public init(immediateItems items: [ShortKitSDK.FeedInput])
   @objc deinit
 }
 @_Concurrency.MainActor @preconcurrency public struct ShortKitFeedView : SwiftUI.UIViewControllerRepresentable {
@@ -438,9 +447,17 @@ public enum ShortKitDownloadError : Swift.Error {
   @_Concurrency.MainActor @preconcurrency public var onDismiss: (() -> Swift.Void)?
   @_Concurrency.MainActor @preconcurrency public var onRemainingContentCountChange: ((Swift.Int) -> Swift.Void)?
   @_Concurrency.MainActor @preconcurrency public var onFeedReady: (() -> Swift.Void)?
+  public struct VideoCarouselCellTapPayload {
+    public let id: Swift.String
+    public let index: Swift.Int
+    public let pageIndex: Swift.Int
+  }
+  @_Concurrency.MainActor @preconcurrency public var onVideoCarouselCellTap: ((ShortKitSDK.ShortKitFeedViewController.VideoCarouselCellTapPayload) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency public var onRefreshStateChanged: ((ShortKitSDK.ShortKitRefreshState) -> Swift.Void)?
   @_Concurrency.MainActor @preconcurrency public var seedThumbnail: UIKit.UIImage?
   @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.FeedConfig, startAtItemId: Swift.String? = nil)
-  @_Concurrency.MainActor public func setFeedItems(_ items: [ShortKitSDK.FeedInput])
+  @_Concurrency.MainActor public func setFeedItems(_ items: [ShortKitSDK.FeedInput], startAtId: Swift.String? = nil)
+  @_Concurrency.MainActor public func scrollToItem(id: Swift.String, animated: Swift.Bool)
   @_Concurrency.MainActor public func appendFeedItems(_ items: [ShortKitSDK.FeedInput])
   @_Concurrency.MainActor public func applyFilter(_ filter: ShortKitSDK.FeedFilter?)
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewDidLoad()
@@ -579,7 +596,8 @@ public struct ContentItem : Swift.Codable, Swift.Equatable, @unchecked Swift.Sen
   public var liveStreamId: Swift.String?
   public var liveStreamStatus: ShortKitSDK.LiveStreamStatus?
   public var startedAt: Swift.String?
-  public init(id: Swift.String, playbackId: Swift.String? = nil, title: Swift.String, description: Swift.String? = nil, duration: Swift.Double, streamingUrl: Swift.String, thumbnailUrl: Swift.String, captionTracks: [ShortKitSDK.CaptionTrack] = [], customMetadata: [Swift.String : ShortKitSDK.JSONValue]? = nil, author: Swift.String? = nil, articleUrl: Swift.String? = nil, commentCount: Swift.Int? = nil, fallbackUrl: Swift.String? = nil, downloadUrl: Swift.String? = nil, isLive: Swift.Bool = false, liveStreamId: Swift.String? = nil, liveStreamStatus: ShortKitSDK.LiveStreamStatus? = nil, startedAt: Swift.String? = nil)
+  public var currentViewers: Swift.Int
+  public init(id: Swift.String, playbackId: Swift.String? = nil, title: Swift.String, description: Swift.String? = nil, duration: Swift.Double, streamingUrl: Swift.String, thumbnailUrl: Swift.String, captionTracks: [ShortKitSDK.CaptionTrack] = [], customMetadata: [Swift.String : ShortKitSDK.JSONValue]? = nil, author: Swift.String? = nil, articleUrl: Swift.String? = nil, commentCount: Swift.Int? = nil, fallbackUrl: Swift.String? = nil, downloadUrl: Swift.String? = nil, isLive: Swift.Bool = false, liveStreamId: Swift.String? = nil, liveStreamStatus: ShortKitSDK.LiveStreamStatus? = nil, startedAt: Swift.String? = nil, currentViewers: Swift.Int = 0)
   public init(from decoder: any Swift.Decoder) throws
   public static func == (a: ShortKitSDK.ContentItem, b: ShortKitSDK.ContentItem) -> Swift.Bool
   public func encode(to encoder: any Swift.Encoder) throws
@@ -840,10 +858,23 @@ public protocol LiveOverlay : AnyObject {
   func configure(with item: ShortKitSDK.ContentItem)
   func activate()
   func deactivate()
-  func showEnded()
+  func liveStreamStatusDidChange(to status: ShortKitSDK.LiveStreamStatus)
+  func expand()
+  func collapse()
 }
 extension ShortKitSDK.LiveOverlay {
-  public func showEnded()
+  public func liveStreamStatusDidChange(to status: ShortKitSDK.LiveStreamStatus)
+  public func expand()
+  public func collapse()
+}
+public protocol LiveRoomMask : AnyObject {
+  var liveRegion: UIKit.UIView { get }
+  func attach(player: ShortKitSDK.ShortKitPlayer)
+  func configure(with item: ShortKitSDK.ContentItem)
+  func willDismiss()
+}
+extension ShortKitSDK.LiveRoomMask {
+  public func willDismiss()
 }
 public protocol SurveyOverlay : AnyObject {
   var onSurveyResponse: ((Swift.String, ShortKitSDK.SurveyOption) -> Swift.Void)? { get set }
@@ -975,6 +1006,19 @@ public enum ContentSignal : Swift.Equatable, Swift.Sendable {
   final public var remainingContentCount: Combine.AnyPublisher<Swift.Int, Swift.Never> {
     get
   }
+  final public var isLiveRoomExpanded: Combine.AnyPublisher<Swift.Bool, Swift.Never> {
+    get
+  }
+  final public var isLiveRoomExpandedValue: Swift.Bool {
+    get
+  }
+  final public var liveStreamStatus: Combine.AnyPublisher<ShortKitSDK.LiveStreamStatus?, Swift.Never> {
+    get
+  }
+  final public var liveStreamStatusValue: ShortKitSDK.LiveStreamStatus? {
+    get
+  }
+  final public func currentProgramDate() -> Foundation.Date?
   final public var currentItemValue: ShortKitSDK.ContentItem? {
     get
   }
@@ -993,6 +1037,7 @@ public enum ContentSignal : Swift.Equatable, Swift.Sendable {
   final public func setMaxBitrate(_ bps: Swift.Int)
   final public func setCaptionsEnabled(_ enabled: Swift.Bool)
   final public func selectCaptionTrack(language: Swift.String)
+  final public func dismissLiveRoom()
   final public func seekThumbnail(at time: Swift.Double) -> UIKit.UIImage?
   @objc deinit
 }

package/ios/ShortKitSDK.xcframework/ios-arm64_x86_64-simulator/ShortKitSDK.framework/_CodeSignature/CodeResources

@@ -10,39 +10,39 @@
 		</data>
 		<key>Info.plist</key>
 		<data>
-		NAKyhlTTEY4YXUZuGyytsdRxGSg=
+		Iq8WNAyualDO11/gg6nPxoT/uLo=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		ifUM9z61Iw1RiA5J7659FTtDCKc=
+		Gzr/etd10eddI2LBjZqt4DbbwAo=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		f61RkcZQhQVbB9c3YG2/uXyr9Vk=
+		SY4J8Ap5bvNmlGr2eHB/mIEc9/4=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		hQZUD603NNnHmxk/pR3vIvMPh+8=
+		Jifa8RGekCm+oLvj1vexV+qHBxg=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		f61RkcZQhQVbB9c3YG2/uXyr9Vk=
+		SY4J8Ap5bvNmlGr2eHB/mIEc9/4=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		ifUM9z61Iw1RiA5J7659FTtDCKc=
+		Gzr/etd10eddI2LBjZqt4DbbwAo=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		NSQpAqQDH38RmWvww0H2ROSdwnk=
+		RSB+lYIOsHV+EHcf6nw6updgwoE=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		4Pig6UkNdzTPX/Sb3gfWgpH50J0=
+		4SaiyfqnnCuP3NHBedJ86U5WUvk=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		NSQpAqQDH38RmWvww0H2ROSdwnk=
+		RSB+lYIOsHV+EHcf6nw6updgwoE=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -66,56 +66,56 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			a4iFwmhnmmqc60/FRwAHMEku0KIVZPJKipRO7Uz9HM0=
+			isVaXgRh+uHcpvhnLI/Xw6vyUa6t68QJDw+sElYsnNw=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			FPJv0aIEtCT5vyHTtMLImsc7s/GZErqSjenZjaZU/3A=
+			1/jxH+/lRA97UGj3ZA78cxyVLWeDthh0KFAHyutYAGs=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			/exQewvICJ/AVntoKI+3mu/vYGd4AKEuKZgifZTenwU=
+			1ZNQBox7b3AwcLy9/eOdX9J9kLPO6aiDoKklf4b+uDw=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			FPJv0aIEtCT5vyHTtMLImsc7s/GZErqSjenZjaZU/3A=
+			1/jxH+/lRA97UGj3ZA78cxyVLWeDthh0KFAHyutYAGs=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			a4iFwmhnmmqc60/FRwAHMEku0KIVZPJKipRO7Uz9HM0=
+			isVaXgRh+uHcpvhnLI/Xw6vyUa6t68QJDw+sElYsnNw=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			TT38Nw2hcxmwTv7fTT4NPL8L7gHyMPUOAUlPNzRyDEI=
+			LcZQmnn2zALd1t49D1Ky9DkTE/qLtiA/Y8X7G8X0tpA=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			QJLSlAAkSGUtORv0i2vGIPi1GlnZYYb8cjgOkj3DLw4=
+			rFL1rnzbA6I/ynZT99TT87vcqERbX/oj+lvvjIITisM=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			TT38Nw2hcxmwTv7fTT4NPL8L7gHyMPUOAUlPNzRyDEI=
+			LcZQmnn2zALd1t49D1Ky9DkTE/qLtiA/Y8X7G8X0tpA=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shortkitsdk/react-native",
-  "version": "0.2.25",
+  "version": "0.2.26",
   "description": "ShortKit React Native SDK — short-form video feed",
   "react-native": "src/index",
   "source": "src/index",

package/src/ShortKitFeed.tsx

@@ -31,6 +31,8 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
   const {
     config,
     preloadId,
+    feedItems,
+    active,
     style,
     startAtItemId,
     seedThumbnailUrl,
@@ -44,6 +46,7 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     onRemainingContentCountChange,
     onFeedReady,
     onCarouselActiveVideoCompleted,
+    onVideoCarouselCellTap,
   } = props;
 
   const isInitialized = useContext(ShortKitInitContext);
@@ -57,8 +60,15 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
 
   // Expose per-feed imperative methods on the ref
   useImperativeHandle(ref, () => ({
-    setFeedItems: (items: FeedInput[]) => {
-      NativeShortKitModule?.setFeedItems(feedId, serializeFeedInputs(items));
+    setFeedItems: (items: FeedInput[], options?: { startAt?: string }) => {
+      NativeShortKitModule?.setFeedItems(
+        feedId,
+        serializeFeedInputs(items),
+        options?.startAt ?? null,
+      );
+    },
+    scrollToItem: (id: string, options?: { animated?: boolean }) => {
+      NativeShortKitModule?.scrollFeedToItem(feedId, id, options?.animated ?? false);
     },
     appendFeedItems: (items: FeedInput[]) => {
       NativeShortKitModule?.appendFeedItems(feedId, serializeFeedInputs(items));
@@ -95,6 +105,23 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     return () => subscription.remove();
   }, [feedId, onFeedReady]);
 
+  // Subscribe to per-feed video-carousel cell-tap events
+  useEffect(() => {
+    if (!NativeShortKitModule || !onVideoCarouselCellTap) return;
+
+    const subscription = NativeShortKitModule.onVideoCarouselCellTap((event) => {
+      if (event.feedId === feedId) {
+        onVideoCarouselCellTap({
+          id: event.id,
+          index: event.index,
+          pageIndex: event.pageIndex,
+        });
+      }
+    });
+
+    return () => subscription.remove();
+  }, [feedId, onVideoCarouselCellTap]);
+
   // Register overlay components before native view mounts.
   // useLayoutEffect fires after commit but before paint — before
   // didMoveToWindow/onAttachedToWindow on the native view.
@@ -115,6 +142,13 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     [config],
   );
 
+  // Serialize feedItems once — only the initial value matters (mount-time
+  // prop). Post-mount item updates use the imperative ref methods.
+  const feedItemsJSON = useMemo(
+    () => (feedItems && feedItems.length > 0 ? serializeFeedInputs(feedItems) : undefined),
+    [feedItems],
+  );
+
   // ---------------------------------------------------------------------------
   // Subscribe to feed-level events and forward to callback props
   // ---------------------------------------------------------------------------
@@ -176,7 +210,10 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
 
     if (onRefreshStateChanged) {
       subscriptions.push(
-        NativeShortKitModule.onRefreshStateChanged((event) => {
+        NativeShortKitModule.onRefreshStateChangedPerFeed((event) => {
+          // Filter to this feed instance — prevents other feeds' refresh
+          // events from triggering this consumer's refresh handler.
+          if (event.feedId !== feedId && event.feedId !== '') return;
           const state: ShortKitRefreshState =
             event.status === 'pulling'
               ? { status: 'pulling', progress: event.progress }
@@ -246,6 +283,8 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
         startAtItemId={startAtItemId}
         preloadId={preloadId}
         seedThumbnailUrl={seedThumbnailUrl}
+        feedItemsJSON={feedItemsJSON}
+        active={active}
       />
     </View>
   );

package/src/ShortKitProvider.tsx

@@ -19,6 +19,7 @@ import type {
 } from './types';
 import {
   serializeFeedConfig,
+  serializeFeedInputs,
   deserializePlayerState,
   deserializeContentItem,
   deserializePlayerTime,
@@ -466,7 +467,7 @@ export function ShortKitProvider({
   const preloadFeedCmd = useCallback(async (config?: Partial<FeedConfig>, items?: FeedInput[]): Promise<string> => {
     if (!NativeShortKitModule) return '';
     const configJSON = config ? serializeFeedConfig(config as FeedConfig) : '{}';
-    const itemsJSON = items ? JSON.stringify(items) : null;
+    const itemsJSON = items ? serializeFeedInputs(items) : null;
     return NativeShortKitModule.preloadFeed(configJSON, itemsJSON);
   }, []);
 

package/src/specs/NativeShortKitModule.ts

@@ -96,6 +96,12 @@ type RefreshStateChangedEvent = Readonly<{
   progress: Double;
 }>;
 
+type RefreshStateChangedPerFeedEvent = Readonly<{
+  feedId: string;
+  status: string;
+  progress: Double;
+}>;
+
 type DidFetchContentItemsEvent = Readonly<{
   items: string; // JSON-serialized ContentItem[]
 }>;
@@ -109,6 +115,13 @@ type FeedReadyEvent = Readonly<{
   feedId: string;
 }>;
 
+type VideoCarouselCellTapEvent = Readonly<{
+  feedId: string;
+  id: string;
+  index: Int32;
+  pageIndex: Int32;
+}>;
+
 type DownloadStartedEvent = Readonly<{
   itemId: string;
 }>;
@@ -266,7 +279,8 @@ export interface Spec extends TurboModule {
   setMaxBitrate(bitrate: Double): void;
 
   // --- Custom feed ---
-  setFeedItems(feedId: string, items: string): void;
+  setFeedItems(feedId: string, items: string, startAtId: string | null): void;
+  scrollFeedToItem(feedId: string, id: string, animated: boolean): void;
   appendFeedItems(feedId: string, items: string): void;
   fetchContent(limit: Int32, filterJSON: string | null): Promise<string>;
   applyFilter(feedId: string, filterJSON: string | null): void;
@@ -302,8 +316,10 @@ export interface Spec extends TurboModule {
   readonly onContentTapped: EventEmitter<ContentTappedEvent>;
   readonly onDismiss: EventEmitter<DismissEvent>;
   readonly onRefreshStateChanged: EventEmitter<RefreshStateChangedEvent>;
+  readonly onRefreshStateChangedPerFeed: EventEmitter<RefreshStateChangedPerFeedEvent>;
   readonly onDidFetchContentItems: EventEmitter<DidFetchContentItemsEvent>;
   readonly onFeedReady: EventEmitter<FeedReadyEvent>;
+  readonly onVideoCarouselCellTap: EventEmitter<VideoCarouselCellTapEvent>;
 
   // --- Overlay per-surface events ---
   readonly onOverlayActiveChanged: EventEmitter<OverlayActiveEvent>;

package/src/specs/ShortKitFeedViewNativeComponent.ts

@@ -14,6 +14,9 @@ export interface NativeProps extends ViewProps {
    * latency. Falls back to network fetch for non-SDWebImage clients.
    */
   seedThumbnailUrl?: string;
+  /** JSON-serialized FeedInput[] for initial custom-feed items at mount time. */
+  feedItemsJSON?: string;
+  active?: boolean;
 }
 
 export default codegenNativeComponent<NativeProps>(

package/src/types.ts

@@ -314,6 +314,34 @@ export interface ShortKitFeedProps {
    * apps on React Native's core <Image> or other image libraries.
    */
   seedThumbnailUrl?: string;
+  /**
+   * Initial feed items for custom feed mode (`feedSource: 'custom'`).
+   *
+   * Items are delivered to the native view as construction-time props so the
+   * SDK renders the first cell on the very first run-loop tick — no
+   * ref-attach race, no async bridge hop, no loading-state flash.
+   *
+   * Use for supplying known items at mount (e.g. a cached last-watched
+   * video). For post-mount updates (pagination, refresh), use the imperative
+   * `setFeedItems()` / `appendFeedItems()` methods on the ref.
+   *
+   * When both `feedItems` and `preloadId` are set, `preloadId` takes
+   * precedence (it carries prefetched HLS manifests / segment 0).
+   */
+  feedItems?: FeedInput[];
+  /**
+   * Whether the feed is the active/focused surface. When `false`, the SDK
+   * suspends playback and yields players so an adjacent feed (e.g. another
+   * tab) can use them without cross-surface contamination.
+   *
+   * Pass `useIsFocused()` from React Navigation. When omitted, the SDK
+   * infers suspension from UIKit's `willMove(toWindow:)` lifecycle —
+   * which works for push/pop navigation but NOT for tab/pager navigation
+   * where the view stays in the window hierarchy.
+   *
+   * @default true
+   */
+  active?: boolean;
   onLoop?: (event: LoopEvent) => void;
   onFeedTransition?: (event: FeedTransitionEvent) => void;
   onFormatChange?: (event: FormatChangeEvent) => void;
@@ -339,6 +367,17 @@ export interface ShortKitFeedProps {
     wasLast: boolean;
     willAutoAdvance: boolean;
   }) => void;
+  /**
+   * Fires when the user taps a video-carousel cell without triggering the
+   * cell's horizontal pan. Use with `useShortKit().setMuted(...)` to
+   * implement tap-to-mute on video-carousel overlays. Single-video and
+   * image-carousel cells don't need this — JS `<Pressable>` works for them.
+   */
+  onVideoCarouselCellTap?: (event: {
+    id: string;
+    index: number;
+    pageIndex: number;
+  }) => void;
 }
 
 /**
@@ -346,8 +385,25 @@ export interface ShortKitFeedProps {
  * Obtained via `ref` on `<ShortKitFeed>`.
  */
 export interface ShortKitFeedHandle {
-  /** Replace all items in this feed instance. */
-  setFeedItems: (items: FeedInput[]) => void;
+  /**
+   * Replace the feed's items atomically.
+   *
+   * @param items   The new feed contents.
+   * @param options Optional. `startAt` specifies the item id to focus after
+   *                the items apply. Overrides the `startAtItemId` prop for
+   *                this call only — the prop's value is preserved for
+   *                subsequent calls that omit this option.
+   */
+  setFeedItems: (items: FeedInput[], options?: { startAt?: string }) => void;
+
+  /**
+   * Imperatively scroll the feed to the item with the given id. Silently
+   * no-ops if the id is not in the current items. Call after `onFeedReady`
+   * for the initial mount; for an atomic set-and-scroll, use
+   * `setFeedItems(items, { startAt })` instead.
+   */
+  scrollToItem: (id: string, options?: { animated?: boolean }) => void;
+
   /** Append items to this feed instance. */
   appendFeedItems: (items: FeedInput[]) => void;
   /** Apply a content filter to this feed instance. Pass null to clear. */