@shortkitsdk/react-native 0.2.24 → 0.2.25

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

@@ -162,6 +162,43 @@ final public class SegmentPrefetcher : ShortKitSDK.SegmentPrefetcherProtocol {
   final public func resume()
   @objc deinit
 }
+public struct CarouselCompletionEvent : Swift.Equatable, Swift.Sendable {
+  public let contentItem: ShortKitSDK.ContentItem
+  public let indexInCarousel: Swift.Int
+  public let carouselItem: ShortKitSDK.VideoCarouselItem
+  public let wasLast: Swift.Bool
+  public let willAutoAdvance: Swift.Bool
+  public init(contentItem: ShortKitSDK.ContentItem, indexInCarousel: Swift.Int, carouselItem: ShortKitSDK.VideoCarouselItem, wasLast: Swift.Bool, willAutoAdvance: Swift.Bool)
+  public static func == (a: ShortKitSDK.CarouselCompletionEvent, b: ShortKitSDK.CarouselCompletionEvent) -> Swift.Bool
+}
+final public class ShortKitCarousel {
+  public init()
+  @discardableResult
+  final public func next() -> Swift.Bool
+  @discardableResult
+  final public func previous() -> Swift.Bool
+  @discardableResult
+  final public func setActiveIndex(_ index: Swift.Int) -> Swift.Bool
+  final public var activeIndexValue: Swift.Int? {
+    get
+  }
+  final public var videoCountValue: Swift.Int? {
+    get
+  }
+  final public var activeCarouselItemValue: ShortKitSDK.VideoCarouselItem? {
+    get
+  }
+  final public var activeIndex: Combine.AnyPublisher<Swift.Int?, Swift.Never> {
+    get
+  }
+  final public var activeCarouselChanged: Combine.AnyPublisher<ShortKitSDK.VideoCarouselItem?, Swift.Never> {
+    get
+  }
+  final public var activeVideoCompleted: Combine.AnyPublisher<ShortKitSDK.CarouselCompletionEvent, Swift.Never> {
+    get
+  }
+  @objc deinit
+}
 public enum FeedHeight : Swift.Codable, Swift.Equatable, Swift.Sendable {
   case fullscreen
   case percentage(CoreFoundation.CGFloat)
@@ -206,6 +243,7 @@ public struct FeedConfig : Swift.Codable {
   public var videoCarouselOverlay: ShortKitSDK.VideoCarouselOverlayMode
   public var surveyOverlay: ShortKitSDK.SurveyOverlayMode
   public var adOverlay: ShortKitSDK.AdOverlayMode
+  public var liveOverlay: ShortKitSDK.LiveOverlayMode
   public var muteOnStart: Swift.Bool
   public var autoplay: Swift.Bool
   public var feedSource: ShortKitSDK.FeedSource
@@ -213,7 +251,7 @@ 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, 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(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(from decoder: any Swift.Decoder) throws
 }
@@ -282,6 +320,21 @@ extension ShortKitSDK.AdOverlayMode : Swift.Codable {
   public init(from decoder: any Swift.Decoder) throws
   public func encode(to encoder: any Swift.Encoder) throws
 }
+public enum LiveOverlayMode {
+  case none
+  case `default`
+  case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.LiveOverlay)
+}
+extension ShortKitSDK.LiveOverlayMode {
+  public static func swiftUI<Content>(@SwiftUICore.ViewBuilder content: @escaping @Sendable (ShortKitSDK.ShortKitPlayer) -> Content) -> ShortKitSDK.LiveOverlayMode where Content : SwiftUICore.View
+}
+extension ShortKitSDK.LiveOverlayMode : Swift.Equatable {
+  public static func == (lhs: ShortKitSDK.LiveOverlayMode, rhs: ShortKitSDK.LiveOverlayMode) -> Swift.Bool
+}
+extension ShortKitSDK.LiveOverlayMode : Swift.Codable {
+  public init(from decoder: any Swift.Decoder) throws
+  public func encode(to encoder: any Swift.Encoder) throws
+}
 public struct DebugMetrics {
   public var contentId: Swift.String?
   public var feedIndex: Swift.Int
@@ -385,6 +438,7 @@ 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)?
+  @_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 appendFeedItems(_ items: [ShortKitSDK.FeedInput])
@@ -427,6 +481,9 @@ extension ShortKitSDK.ShortKitFeedViewController : ShortKitSDK.ShortKitAdDelegat
   @_Concurrency.MainActor @preconcurrency public func adDidFail(_ ad: ShortKitSDK.PreparedAd, error: ShortKitSDK.AdError)
   @_Concurrency.MainActor @preconcurrency public func adDidReceiveClick(_ ad: ShortKitSDK.PreparedAd)
 }
+public enum SeedThumbnailResolver {
+  public static func resolveFromMemory(url: Swift.String) -> UIKit.UIImage?
+}
 public enum ShortKitRefreshState : Swift.Sendable {
   case idle
   case pulling(progress: CoreFoundation.CGFloat)
@@ -491,6 +548,16 @@ public struct CaptionTrack : Swift.Codable, Swift.Equatable, Swift.Sendable {
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
 }
+public enum LiveStreamStatus : Swift.String, Swift.Codable, Swift.Equatable, Swift.Sendable {
+  case idle
+  case active
+  case ended
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    get
+  }
+}
 public struct ContentItem : Swift.Codable, Swift.Equatable, @unchecked Swift.Sendable {
   public let id: Swift.String
   public var playbackId: Swift.String?
@@ -508,20 +575,35 @@ public struct ContentItem : Swift.Codable, Swift.Equatable, @unchecked Swift.Sen
   public let commentCount: Swift.Int?
   public var fallbackUrl: Swift.String?
   public var downloadUrl: 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)
+  public var isLive: Swift.Bool
+  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 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
-  public init(from decoder: any Swift.Decoder) throws
 }
 extension ShortKitSDK.ContentItem {
   public var isDownloadable: Swift.Bool {
     get
   }
 }
+public enum ContentOrigin : Swift.String, Swift.Codable, Swift.Sendable {
+  case iosUpload
+  case other
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    get
+  }
+}
 public enum FeedInput : Swift.Sendable {
-  case video(playbackId: Swift.String, fallbackUrl: Swift.String? = nil)
+  case video(playbackId: Swift.String, origin: ShortKitSDK.ContentOrigin = .other, fallbackUrl: Swift.String? = nil)
+  case liveStream(playbackId: Swift.String)
   case imageCarousel(ShortKitSDK.ImageCarouselItem)
   case videoCarousel(ShortKitSDK.VideoCarouselInput)
+  case videoCarouselItem(ShortKitSDK.VideoCarouselItem)
 }
 public enum FeedItem : Swift.Sendable {
   case content(ShortKitSDK.ContentItem)
@@ -693,8 +775,9 @@ public struct VideoCarouselItem : Swift.Codable, Swift.Equatable, Swift.Sendable
 }
 public struct VideoCarouselVideoInput : Swift.Codable, Swift.Equatable, Swift.Sendable {
   public let playbackId: Swift.String
+  public let origin: ShortKitSDK.ContentOrigin
   public let fallbackUrl: Swift.String?
-  public init(playbackId: Swift.String, fallbackUrl: Swift.String? = nil)
+  public init(playbackId: Swift.String, origin: ShortKitSDK.ContentOrigin = .other, fallbackUrl: Swift.String? = nil)
   public static func == (a: ShortKitSDK.VideoCarouselVideoInput, b: ShortKitSDK.VideoCarouselVideoInput) -> Swift.Bool
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
@@ -752,6 +835,16 @@ public protocol FeedOverlay : AnyObject {
   func configure(with item: ShortKitSDK.ContentItem)
   func activatePlayback()
 }
+public protocol LiveOverlay : AnyObject {
+  func attach(player: ShortKitSDK.ShortKitPlayer)
+  func configure(with item: ShortKitSDK.ContentItem)
+  func activate()
+  func deactivate()
+  func showEnded()
+}
+extension ShortKitSDK.LiveOverlay {
+  public func showEnded()
+}
 public protocol SurveyOverlay : AnyObject {
   var onSurveyResponse: ((Swift.String, ShortKitSDK.SurveyOption) -> Swift.Void)? { get set }
   var onAutoAdvance: (() -> Swift.Void)? { get set }
@@ -940,6 +1033,7 @@ public enum ShortKitVersion {
 }
 final public class ShortKit {
   final public let player: ShortKitSDK.ShortKitPlayer
+  final public let carousel: ShortKitSDK.ShortKitCarousel
   final public let debugPanelEnabled: Swift.Bool
   weak final public var delegate: (any ShortKitSDK.ShortKitDelegate)?
   weak final public var downloadDelegate: (any ShortKitSDK.ShortKitDownloadDelegate)?
@@ -1051,6 +1145,11 @@ extension ShortKitSDK.ShortKitFeedView : Swift.Sendable {}
 extension ShortKitSDK.CaptionSource : Swift.Equatable {}
 extension ShortKitSDK.CaptionSource : Swift.Hashable {}
 extension ShortKitSDK.CaptionSource : Swift.RawRepresentable {}
+extension ShortKitSDK.LiveStreamStatus : Swift.Hashable {}
+extension ShortKitSDK.LiveStreamStatus : Swift.RawRepresentable {}
+extension ShortKitSDK.ContentOrigin : Swift.Equatable {}
+extension ShortKitSDK.ContentOrigin : Swift.Hashable {}
+extension ShortKitSDK.ContentOrigin : Swift.RawRepresentable {}
 extension ShortKitSDK.FeedTransitionEvent.Phase : Swift.Equatable {}
 extension ShortKitSDK.FeedTransitionEvent.Phase : Swift.Hashable {}
 extension ShortKitSDK.FeedTransitionEvent.Direction : Swift.Equatable {}

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

@@ -162,6 +162,43 @@ final public class SegmentPrefetcher : ShortKitSDK.SegmentPrefetcherProtocol {
   final public func resume()
   @objc deinit
 }
+public struct CarouselCompletionEvent : Swift.Equatable, Swift.Sendable {
+  public let contentItem: ShortKitSDK.ContentItem
+  public let indexInCarousel: Swift.Int
+  public let carouselItem: ShortKitSDK.VideoCarouselItem
+  public let wasLast: Swift.Bool
+  public let willAutoAdvance: Swift.Bool
+  public init(contentItem: ShortKitSDK.ContentItem, indexInCarousel: Swift.Int, carouselItem: ShortKitSDK.VideoCarouselItem, wasLast: Swift.Bool, willAutoAdvance: Swift.Bool)
+  public static func == (a: ShortKitSDK.CarouselCompletionEvent, b: ShortKitSDK.CarouselCompletionEvent) -> Swift.Bool
+}
+final public class ShortKitCarousel {
+  public init()
+  @discardableResult
+  final public func next() -> Swift.Bool
+  @discardableResult
+  final public func previous() -> Swift.Bool
+  @discardableResult
+  final public func setActiveIndex(_ index: Swift.Int) -> Swift.Bool
+  final public var activeIndexValue: Swift.Int? {
+    get
+  }
+  final public var videoCountValue: Swift.Int? {
+    get
+  }
+  final public var activeCarouselItemValue: ShortKitSDK.VideoCarouselItem? {
+    get
+  }
+  final public var activeIndex: Combine.AnyPublisher<Swift.Int?, Swift.Never> {
+    get
+  }
+  final public var activeCarouselChanged: Combine.AnyPublisher<ShortKitSDK.VideoCarouselItem?, Swift.Never> {
+    get
+  }
+  final public var activeVideoCompleted: Combine.AnyPublisher<ShortKitSDK.CarouselCompletionEvent, Swift.Never> {
+    get
+  }
+  @objc deinit
+}
 public enum FeedHeight : Swift.Codable, Swift.Equatable, Swift.Sendable {
   case fullscreen
   case percentage(CoreFoundation.CGFloat)
@@ -206,6 +243,7 @@ public struct FeedConfig : Swift.Codable {
   public var videoCarouselOverlay: ShortKitSDK.VideoCarouselOverlayMode
   public var surveyOverlay: ShortKitSDK.SurveyOverlayMode
   public var adOverlay: ShortKitSDK.AdOverlayMode
+  public var liveOverlay: ShortKitSDK.LiveOverlayMode
   public var muteOnStart: Swift.Bool
   public var autoplay: Swift.Bool
   public var feedSource: ShortKitSDK.FeedSource
@@ -213,7 +251,7 @@ 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, 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(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(from decoder: any Swift.Decoder) throws
 }
@@ -282,6 +320,21 @@ extension ShortKitSDK.AdOverlayMode : Swift.Codable {
   public init(from decoder: any Swift.Decoder) throws
   public func encode(to encoder: any Swift.Encoder) throws
 }
+public enum LiveOverlayMode {
+  case none
+  case `default`
+  case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.LiveOverlay)
+}
+extension ShortKitSDK.LiveOverlayMode {
+  public static func swiftUI<Content>(@SwiftUICore.ViewBuilder content: @escaping @Sendable (ShortKitSDK.ShortKitPlayer) -> Content) -> ShortKitSDK.LiveOverlayMode where Content : SwiftUICore.View
+}
+extension ShortKitSDK.LiveOverlayMode : Swift.Equatable {
+  public static func == (lhs: ShortKitSDK.LiveOverlayMode, rhs: ShortKitSDK.LiveOverlayMode) -> Swift.Bool
+}
+extension ShortKitSDK.LiveOverlayMode : Swift.Codable {
+  public init(from decoder: any Swift.Decoder) throws
+  public func encode(to encoder: any Swift.Encoder) throws
+}
 public struct DebugMetrics {
   public var contentId: Swift.String?
   public var feedIndex: Swift.Int
@@ -385,6 +438,7 @@ 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)?
+  @_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 appendFeedItems(_ items: [ShortKitSDK.FeedInput])
@@ -427,6 +481,9 @@ extension ShortKitSDK.ShortKitFeedViewController : ShortKitSDK.ShortKitAdDelegat
   @_Concurrency.MainActor @preconcurrency public func adDidFail(_ ad: ShortKitSDK.PreparedAd, error: ShortKitSDK.AdError)
   @_Concurrency.MainActor @preconcurrency public func adDidReceiveClick(_ ad: ShortKitSDK.PreparedAd)
 }
+public enum SeedThumbnailResolver {
+  public static func resolveFromMemory(url: Swift.String) -> UIKit.UIImage?
+}
 public enum ShortKitRefreshState : Swift.Sendable {
   case idle
   case pulling(progress: CoreFoundation.CGFloat)
@@ -491,6 +548,16 @@ public struct CaptionTrack : Swift.Codable, Swift.Equatable, Swift.Sendable {
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
 }
+public enum LiveStreamStatus : Swift.String, Swift.Codable, Swift.Equatable, Swift.Sendable {
+  case idle
+  case active
+  case ended
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    get
+  }
+}
 public struct ContentItem : Swift.Codable, Swift.Equatable, @unchecked Swift.Sendable {
   public let id: Swift.String
   public var playbackId: Swift.String?
@@ -508,20 +575,35 @@ public struct ContentItem : Swift.Codable, Swift.Equatable, @unchecked Swift.Sen
   public let commentCount: Swift.Int?
   public var fallbackUrl: Swift.String?
   public var downloadUrl: 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)
+  public var isLive: Swift.Bool
+  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 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
-  public init(from decoder: any Swift.Decoder) throws
 }
 extension ShortKitSDK.ContentItem {
   public var isDownloadable: Swift.Bool {
     get
   }
 }
+public enum ContentOrigin : Swift.String, Swift.Codable, Swift.Sendable {
+  case iosUpload
+  case other
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    get
+  }
+}
 public enum FeedInput : Swift.Sendable {
-  case video(playbackId: Swift.String, fallbackUrl: Swift.String? = nil)
+  case video(playbackId: Swift.String, origin: ShortKitSDK.ContentOrigin = .other, fallbackUrl: Swift.String? = nil)
+  case liveStream(playbackId: Swift.String)
   case imageCarousel(ShortKitSDK.ImageCarouselItem)
   case videoCarousel(ShortKitSDK.VideoCarouselInput)
+  case videoCarouselItem(ShortKitSDK.VideoCarouselItem)
 }
 public enum FeedItem : Swift.Sendable {
   case content(ShortKitSDK.ContentItem)
@@ -693,8 +775,9 @@ public struct VideoCarouselItem : Swift.Codable, Swift.Equatable, Swift.Sendable
 }
 public struct VideoCarouselVideoInput : Swift.Codable, Swift.Equatable, Swift.Sendable {
   public let playbackId: Swift.String
+  public let origin: ShortKitSDK.ContentOrigin
   public let fallbackUrl: Swift.String?
-  public init(playbackId: Swift.String, fallbackUrl: Swift.String? = nil)
+  public init(playbackId: Swift.String, origin: ShortKitSDK.ContentOrigin = .other, fallbackUrl: Swift.String? = nil)
   public static func == (a: ShortKitSDK.VideoCarouselVideoInput, b: ShortKitSDK.VideoCarouselVideoInput) -> Swift.Bool
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
@@ -752,6 +835,16 @@ public protocol FeedOverlay : AnyObject {
   func configure(with item: ShortKitSDK.ContentItem)
   func activatePlayback()
 }
+public protocol LiveOverlay : AnyObject {
+  func attach(player: ShortKitSDK.ShortKitPlayer)
+  func configure(with item: ShortKitSDK.ContentItem)
+  func activate()
+  func deactivate()
+  func showEnded()
+}
+extension ShortKitSDK.LiveOverlay {
+  public func showEnded()
+}
 public protocol SurveyOverlay : AnyObject {
   var onSurveyResponse: ((Swift.String, ShortKitSDK.SurveyOption) -> Swift.Void)? { get set }
   var onAutoAdvance: (() -> Swift.Void)? { get set }
@@ -940,6 +1033,7 @@ public enum ShortKitVersion {
 }
 final public class ShortKit {
   final public let player: ShortKitSDK.ShortKitPlayer
+  final public let carousel: ShortKitSDK.ShortKitCarousel
   final public let debugPanelEnabled: Swift.Bool
   weak final public var delegate: (any ShortKitSDK.ShortKitDelegate)?
   weak final public var downloadDelegate: (any ShortKitSDK.ShortKitDownloadDelegate)?
@@ -1051,6 +1145,11 @@ extension ShortKitSDK.ShortKitFeedView : Swift.Sendable {}
 extension ShortKitSDK.CaptionSource : Swift.Equatable {}
 extension ShortKitSDK.CaptionSource : Swift.Hashable {}
 extension ShortKitSDK.CaptionSource : Swift.RawRepresentable {}
+extension ShortKitSDK.LiveStreamStatus : Swift.Hashable {}
+extension ShortKitSDK.LiveStreamStatus : Swift.RawRepresentable {}
+extension ShortKitSDK.ContentOrigin : Swift.Equatable {}
+extension ShortKitSDK.ContentOrigin : Swift.Hashable {}
+extension ShortKitSDK.ContentOrigin : Swift.RawRepresentable {}
 extension ShortKitSDK.FeedTransitionEvent.Phase : Swift.Equatable {}
 extension ShortKitSDK.FeedTransitionEvent.Phase : Swift.Hashable {}
 extension ShortKitSDK.FeedTransitionEvent.Direction : Swift.Equatable {}

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

@@ -10,39 +10,39 @@
 		</data>
 		<key>Info.plist</key>
 		<data>
-		aVOP/OHkEUzNyBoUHTT2iiGJbu4=
+		NAKyhlTTEY4YXUZuGyytsdRxGSg=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		mxcDambiFIzUbFTPfCTaKwjGz/8=
+		ifUM9z61Iw1RiA5J7659FTtDCKc=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		wayE2tftrhjvaEAekKB20ZGO36g=
+		f61RkcZQhQVbB9c3YG2/uXyr9Vk=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		OXtQVstuyP3hqDsSczrvdpR/BZY=
+		hQZUD603NNnHmxk/pR3vIvMPh+8=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		wayE2tftrhjvaEAekKB20ZGO36g=
+		f61RkcZQhQVbB9c3YG2/uXyr9Vk=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		mxcDambiFIzUbFTPfCTaKwjGz/8=
+		ifUM9z61Iw1RiA5J7659FTtDCKc=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		c5HZCcsGjJPhu5ppN3Wq4SsCx2A=
+		NSQpAqQDH38RmWvww0H2ROSdwnk=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		IjquwfiAxSFG2n0IR/+e9HvnZCM=
+		4Pig6UkNdzTPX/Sb3gfWgpH50J0=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		c5HZCcsGjJPhu5ppN3Wq4SsCx2A=
+		NSQpAqQDH38RmWvww0H2ROSdwnk=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -66,56 +66,56 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			s3LSfH8aLgl3mic08rsi958gHLv6ImNC8MsZtFoy8u0=
+			a4iFwmhnmmqc60/FRwAHMEku0KIVZPJKipRO7Uz9HM0=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			cYm595F0j0GSGb/GBTR7QHYSuFeUw9ZTPc8F87PKzvA=
+			FPJv0aIEtCT5vyHTtMLImsc7s/GZErqSjenZjaZU/3A=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			9FsW2XMD0E0AiZ7mHDBgLg/OeCcSwB2BmWG3PuPqPwM=
+			/exQewvICJ/AVntoKI+3mu/vYGd4AKEuKZgifZTenwU=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			cYm595F0j0GSGb/GBTR7QHYSuFeUw9ZTPc8F87PKzvA=
+			FPJv0aIEtCT5vyHTtMLImsc7s/GZErqSjenZjaZU/3A=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			s3LSfH8aLgl3mic08rsi958gHLv6ImNC8MsZtFoy8u0=
+			a4iFwmhnmmqc60/FRwAHMEku0KIVZPJKipRO7Uz9HM0=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			QRoqxRRNskUOSMbf+RlD6fMBj0mmhgmOres7jwvebiQ=
+			TT38Nw2hcxmwTv7fTT4NPL8L7gHyMPUOAUlPNzRyDEI=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			R1p/WNYI3bnLOrWsIezOXSJRZEwJ/t8FuoDZCBZQhHg=
+			QJLSlAAkSGUtORv0i2vGIPi1GlnZYYb8cjgOkj3DLw4=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			QRoqxRRNskUOSMbf+RlD6fMBj0mmhgmOres7jwvebiQ=
+			TT38Nw2hcxmwTv7fTT4NPL8L7gHyMPUOAUlPNzRyDEI=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/package.json

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

package/src/ShortKitCarouselOverlaySurface.tsx

@@ -1,4 +1,4 @@
-import React, { useState, useEffect, useMemo } from 'react';
+import React, { useRef, useState, useEffect, useMemo } from 'react';
 import { AppRegistry } from 'react-native';
 import type { CarouselOverlayProps, ImageCarouselItem } from './types';
 import NativeShortKitModule from './specs/NativeShortKitModule';
@@ -31,6 +31,12 @@ function useOverlayEvent<T extends { surfaceId: string }>(
   surfaceId: string | undefined,
   handler: (event: T) => void,
 ) {
+  // Ref-based handler capture so the subscription always calls the latest
+  // closure. Effect depends on [eventName, surfaceId] only — re-subscribing
+  // on every render would churn native subscriptions.
+  const handlerRef = useRef(handler);
+  handlerRef.current = handler;
+
   useEffect(() => {
     if (!surfaceId) return;
 
@@ -39,12 +45,12 @@ function useOverlayEvent<T extends { surfaceId: string }>(
     if (typeof emitter === 'function') {
       sub = (emitter as (cb: (e: T) => void) => { remove: () => void })((e: T) => {
         if (e.surfaceId !== surfaceId) return;
-        handler(e);
+        handlerRef.current(e);
       });
     }
 
     return () => sub?.remove();
-  }, [surfaceId]);
+  }, [eventName, surfaceId]);
 }
 
 interface RawCarouselSurfaceProps {
@@ -87,21 +93,43 @@ function CarouselSurfaceInner(props: InnerProps) {
     (e) => setActiveImageIndex(e.activeImageIndex),
   );
 
-  const item: ImageCarouselItem | null = useMemo(() => {
-    if (!props.item) {
-      return null;
-    }
+  // Initial item — from surface props (set once on first mount).
+  const initialItem: ImageCarouselItem | null = useMemo(() => {
+    if (!props.item) return null;
+    try { return JSON.parse(props.item); } catch { return null; }
+  }, [props.item]);
+
+  // Subsequent item changes arrive via event — React diff instead of a full
+  // Fabric remount on cell reuse. Payload also resets isActive/activeImageIndex.
+  const [eventItem, setEventItem] = useState<ImageCarouselItem | null>(null);
+  useOverlayEvent<{
+    surfaceId: string;
+    item: string;
+    isActive: boolean;
+    activeImageIndex: number;
+  }>('onCarouselItemChanged', sid, (e) => {
     try {
-      return JSON.parse(props.item);
+      setEventItem(JSON.parse(e.item));
     } catch {
-      return null;
+      setEventItem(null);
     }
-  }, [props.item]);
+    setIsActive(e.isActive);
+    setActiveImageIndex(e.activeImageIndex);
+  });
+
+  // Prefer event-sourced item (set after first item change) over the initial
+  // props-sourced value. Initial mount still uses props; all subsequent
+  // transitions are event-driven.
+  const item = eventItem ?? initialItem;
 
   if (!item) return null;
 
   return (
+    // key={item.id} preserves "fresh mount per item" for the user's component
+    // — their local state resets cleanly across items — while the SDK wrapper
+    // above stays mounted and keeps its bridge event subscriptions alive.
     <Component
+      key={item.id}
       item={item}
       isActive={isActive}
       activeImageIndex={activeImageIndex}

package/src/ShortKitCommands.ts

@@ -14,6 +14,10 @@ export const ShortKitCommands = {
   seekAndPlay: (seconds: number) => NativeShortKitModule?.seekAndPlay(seconds),
   skipToNext: () => NativeShortKitModule?.skipToNext(),
   skipToPrevious: () => NativeShortKitModule?.skipToPrevious(),
+  carouselNext: (): boolean => NativeShortKitModule?.carouselNext() ?? false,
+  carouselPrevious: (): boolean => NativeShortKitModule?.carouselPrevious() ?? false,
+  carouselSetActiveIndex: (index: number): boolean =>
+    NativeShortKitModule?.carouselSetActiveIndex(index) ?? false,
   setMuted: (muted: boolean) => NativeShortKitModule?.setMuted(muted),
   setPlaybackRate: (rate: number) => NativeShortKitModule?.setPlaybackRate(rate),
   setCaptionsEnabled: (enabled: boolean) =>