@shortkitsdk/react-native 0.2.16 → 0.2.23

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

@@ -1,7 +1,7 @@
 // swift-interface-format-version: 1.0
-// swift-compiler-version: Apple Swift version 6.1 effective-5.10 (swiftlang-6.1.0.110.21 clang-1700.0.13.3)
+// swift-compiler-version: Apple Swift version 6.3 effective-5.10 (swiftlang-6.3.0.123.5 clang-2100.0.123.102)
 // swift-module-flags: -target x86_64-apple-ios15.0-simulator -enable-objc-interop -enable-library-evolution -swift-version 5 -O -module-name ShortKitSDK -package-name swift_sdk
-// swift-module-flags-ignorable:  -interface-compiler-version 6.1
+// swift-module-flags-ignorable:  -formal-cxx-interoperability-mode=off -interface-compiler-version 6.3
 import AVFoundation
 import Combine
 import CoreGraphics
@@ -217,6 +217,13 @@ public struct FeedConfig : Swift.Codable {
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
 }
+public enum FeedMaskMode {
+  case none
+  case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.FeedMask)
+}
+extension ShortKitSDK.FeedMaskMode : Swift.Equatable {
+  public static func == (lhs: ShortKitSDK.FeedMaskMode, rhs: ShortKitSDK.FeedMaskMode) -> Swift.Bool
+}
 public enum VideoOverlayMode {
   case none
   case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.FeedOverlay)
@@ -275,6 +282,51 @@ extension ShortKitSDK.AdOverlayMode : 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
+  public var playerState: ShortKitSDK.PlayerState
+  public var intentToFrameMs: Swift.Int?
+  public var transitionToFrameMs: Swift.Int?
+  public var networkMs: Swift.Int?
+  public var decodeMs: Swift.Int?
+  public var prerollCompleted: Swift.Bool
+  public var observedBitrateBps: Swift.Double
+  public var indicatedBitrateBps: Swift.Double
+  public var bufferAhead: Swift.Double
+  public var rebufferCount: Swift.Int
+  public var lastRebufferDurationMs: Swift.Int?
+  public var currentTime: Swift.Double
+  public var duration: Swift.Double
+  public var loopCount: Swift.Int
+  public var videoWidth: Swift.Int
+  public var videoHeight: Swift.Int
+  public var codec: Swift.String?
+  public var thumbnailVisible: Swift.Bool
+  public var thumbsCachedAhead: Swift.Int
+  public var metadataAhead: Swift.Int
+  public init(contentId: Swift.String? = nil)
+}
+public enum SwipeCurve : Swift.Int, Swift.CaseIterable {
+  case quarticOut
+  case quinticOut
+  case expoOut
+  case microBounce
+  public var label: Swift.String {
+    get
+  }
+  public func apply(_ t: CoreFoundation.CGFloat) -> CoreFoundation.CGFloat
+  public static var selected: ShortKitSDK.SwipeCurve
+  public init?(rawValue: Swift.Int)
+  public typealias AllCases = [ShortKitSDK.SwipeCurve]
+  public typealias RawValue = Swift.Int
+  nonisolated public static var allCases: [ShortKitSDK.SwipeCurve] {
+    get
+  }
+  public var rawValue: Swift.Int {
+    get
+  }
+}
 public protocol ShortKitDelegate : AnyObject {
   func shortKit(_ shortKit: ShortKitSDK.ShortKit, didChangeRefreshState state: ShortKitSDK.ShortKitRefreshState)
   func shortKit(_ shortKit: ShortKitSDK.ShortKit, didTapContent contentId: Swift.String, at index: Swift.Int)
@@ -285,6 +337,34 @@ extension ShortKitSDK.ShortKitDelegate {
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didTapContent contentId: Swift.String, at index: Swift.Int)
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didFetchContentItems items: [ShortKitSDK.ContentItem])
 }
+public protocol ShortKitDownloadDelegate : AnyObject {
+  func shortKit(_ shortKit: ShortKitSDK.ShortKit, didStartDownload item: ShortKitSDK.ContentItem)
+  func shortKit(_ shortKit: ShortKitSDK.ShortKit, didUpdateDownloadProgress item: ShortKitSDK.ContentItem, progress: Swift.Double)
+  func shortKit(_ shortKit: ShortKitSDK.ShortKit, didCompleteDownload item: ShortKitSDK.ContentItem, fileURL: Foundation.URL)
+  func shortKit(_ shortKit: ShortKitSDK.ShortKit, didFailDownload item: ShortKitSDK.ContentItem, error: ShortKitSDK.ShortKitDownloadError)
+}
+extension ShortKitSDK.ShortKitDownloadDelegate {
+  public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didStartDownload item: ShortKitSDK.ContentItem)
+  public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didUpdateDownloadProgress item: ShortKitSDK.ContentItem, progress: Swift.Double)
+  public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didCompleteDownload item: ShortKitSDK.ContentItem, fileURL: Foundation.URL)
+  public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didFailDownload item: ShortKitSDK.ContentItem, error: ShortKitSDK.ShortKitDownloadError)
+}
+public enum DownloadMode {
+  case nonInterruptive
+  case interruptive
+  public static func == (a: ShortKitSDK.DownloadMode, b: ShortKitSDK.DownloadMode) -> Swift.Bool
+  public func hash(into hasher: inout Swift.Hasher)
+  public var hashValue: Swift.Int {
+    get
+  }
+}
+public enum ShortKitDownloadError : Swift.Error {
+  case downloadNotAvailable
+  case downloadInProgress
+  case networkError(any Swift.Error)
+  case httpError(statusCode: Swift.Int)
+  case cancelled
+}
 @_hasMissingDesignatedInitializers final public class FeedPreload : @unchecked Swift.Sendable {
   @objc deinit
 }
@@ -301,6 +381,7 @@ extension ShortKitSDK.ShortKitDelegate {
   public typealias UIViewControllerType = ShortKitSDK.ShortKitFeedViewController
 }
 @objc @_hasMissingDesignatedInitializers @_Concurrency.MainActor @preconcurrency public class ShortKitFeedViewController : UIKit.UIViewController {
+  @_Concurrency.MainActor @preconcurrency public var debugPanelFactory: ((_ active: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>, _ prev: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>, _ next: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>) -> UIKit.UIView)?
   @_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)?
@@ -321,6 +402,10 @@ extension ShortKitSDK.ShortKitDelegate {
     @objc get
   }
   @objc deinit
+  @_Concurrency.MainActor @preconcurrency @objc override dynamic public var canBecomeFirstResponder: Swift.Bool {
+    @objc get
+  }
+  @_Concurrency.MainActor @preconcurrency @objc override dynamic public func motionEnded(_ motion: UIKit.UIEvent.EventSubtype, with event: UIKit.UIEvent?)
 }
 extension ShortKitSDK.ShortKitFeedViewController : UIKit.UICollectionViewDelegate {
   @_Concurrency.MainActor @preconcurrency @objc dynamic public func collectionView(_ collectionView: UIKit.UICollectionView, willDisplay cell: UIKit.UICollectionViewCell, forItemAt indexPath: Foundation.IndexPath)
@@ -422,10 +507,17 @@ public struct ContentItem : Swift.Codable, Swift.Equatable, @unchecked Swift.Sen
   public let articleUrl: Swift.String?
   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 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 FeedInput : Swift.Sendable {
   case video(playbackId: Swift.String, fallbackUrl: Swift.String? = nil)
   case imageCarousel(ShortKitSDK.ImageCarouselItem)
@@ -610,7 +702,7 @@ extension ShortKitSDK.CarouselOverlay {
   public func updateActiveImage(index: Swift.Int)
 }
 final public class CellContent : Combine.ObservableObject {
-  @Combine.Published @_projectedValueProperty($item) final public var item: ShortKitSDK.ContentItem? {
+  @Combine.Published<ShortKitSDK.ContentItem?> @_projectedValueProperty($item) final public var item: ShortKitSDK.ContentItem? {
     get
     @available(iOS 13.0, tvOS 13.0, watchOS 6.0, macOS 10.15, *)
     set
@@ -626,6 +718,12 @@ final public class CellContent : Combine.ObservableObject {
   public typealias ObjectWillChangePublisher = Combine.ObservableObjectPublisher
   @objc deinit
 }
+public protocol FeedMask : AnyObject {
+  var feedRegion: UIKit.UIView { get }
+  func attach(player: ShortKitSDK.ShortKitPlayer)
+  func configure(with item: ShortKitSDK.ContentItem)
+  func activatePlayback()
+}
 public protocol FeedOverlay : AnyObject {
   func attach(player: ShortKitSDK.ShortKitPlayer)
   func configure(with item: ShortKitSDK.ContentItem)
@@ -819,9 +917,11 @@ public enum ShortKitVersion {
 }
 final public class ShortKit {
   final public let player: ShortKitSDK.ShortKitPlayer
+  final public let debugPanelEnabled: Swift.Bool
   weak final public var delegate: (any ShortKitSDK.ShortKitDelegate)?
+  weak final public var downloadDelegate: (any ShortKitSDK.ShortKitDownloadDelegate)?
   final public var loadingViewProvider: (() -> UIKit.UIView)?
-  public init(apiKey: Swift.String, userId: Swift.String? = nil, adProvider: (any ShortKitSDK.ShortKitAdProvider)? = nil, clientAppName: Swift.String? = nil, clientAppVersion: Swift.String? = nil, customDimensions: [Swift.String : Swift.String]? = nil, loadingViewProvider: (() -> UIKit.UIView)? = nil)
+  public init(apiKey: Swift.String, userId: Swift.String? = nil, adProvider: (any ShortKitSDK.ShortKitAdProvider)? = nil, clientAppName: Swift.String? = nil, clientAppVersion: Swift.String? = nil, customDimensions: [Swift.String : Swift.String]? = nil, loadingViewProvider: (() -> UIKit.UIView)? = nil, debugPanelEnabled: Swift.Bool = false)
   final public func preloadFeed(filter: ShortKitSDK.FeedFilter? = nil, limit: Swift.Int = 10) -> ShortKitSDK.FeedPreload
   final public func preloadFeed(items: [ShortKitSDK.FeedInput]) -> ShortKitSDK.FeedPreload
   final public func fetchContent(limit: Swift.Int = 10, filter: ShortKitSDK.FeedFilter? = nil) async throws -> [ShortKitSDK.ContentItem]
@@ -829,6 +929,8 @@ final public class ShortKit {
   final public func clearUserId()
   @_Concurrency.MainActor final public func setColdStartQueue(_ items: [ShortKitSDK.FeedInput])
   final public func clearColdStartCache()
+  final public func downloadVideo(_ item: ShortKitSDK.ContentItem, mode: ShortKitSDK.DownloadMode = .nonInterruptive) async throws -> Foundation.URL
+  final public func cancelDownload()
   @objc deinit
 }
 public enum PlayerClickAction : Swift.Sendable {
@@ -860,6 +962,7 @@ public struct PlayerConfig {
   public typealias UIViewControllerType = ShortKitSDK.ShortKitPlayerViewController
 }
 @objc @_hasMissingDesignatedInitializers @_Concurrency.MainActor @preconcurrency final public class ShortKitPlayerViewController : UIKit.UIViewController {
+  @_Concurrency.MainActor @preconcurrency final public var feedMask: ShortKitSDK.FeedMaskMode
   @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.PlayerConfig)
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidLoad()
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewWillDisappear(_ animated: Swift.Bool)
@@ -872,8 +975,10 @@ public struct PlayerConfig {
 extension ShortKitSDK.ShortKitPlayerViewController : UIKit.UIViewControllerTransitioningDelegate {
   @_Concurrency.MainActor @preconcurrency @objc final public func animationController(forPresented presented: UIKit.UIViewController, presenting: UIKit.UIViewController, source: UIKit.UIViewController) -> (any UIKit.UIViewControllerAnimatedTransitioning)?
   @_Concurrency.MainActor @preconcurrency @objc final public func animationController(forDismissed dismissed: UIKit.UIViewController) -> (any UIKit.UIViewControllerAnimatedTransitioning)?
+  @_Concurrency.MainActor @preconcurrency @objc final public func interactionControllerForDismissal(using animator: any UIKit.UIViewControllerAnimatedTransitioning) -> (any UIKit.UIViewControllerInteractiveTransitioning)?
 }
 @objc @_hasMissingDesignatedInitializers @_Concurrency.MainActor @preconcurrency final public class ShortKitWidgetViewController : UIKit.UIViewController {
+  @_Concurrency.MainActor @preconcurrency final public var feedMask: ShortKitSDK.FeedMaskMode
   @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.WidgetConfig)
   @_Concurrency.MainActor @preconcurrency final public func configure(with items: [ShortKitSDK.ContentItem])
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidLoad()
@@ -891,6 +996,7 @@ extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UICollectionViewDeleg
 extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UIViewControllerTransitioningDelegate {
   @_Concurrency.MainActor @preconcurrency @objc final public func animationController(forPresented presented: UIKit.UIViewController, presenting: UIKit.UIViewController, source: UIKit.UIViewController) -> (any UIKit.UIViewControllerAnimatedTransitioning)?
   @_Concurrency.MainActor @preconcurrency @objc final public func animationController(forDismissed dismissed: UIKit.UIViewController) -> (any UIKit.UIViewControllerAnimatedTransitioning)?
+  @_Concurrency.MainActor @preconcurrency @objc final public func interactionControllerForDismissal(using animator: any UIKit.UIViewControllerAnimatedTransitioning) -> (any UIKit.UIViewControllerInteractiveTransitioning)?
 }
 public struct WidgetConfig {
   public var cardCount: Swift.Int
@@ -903,7 +1009,9 @@ public struct WidgetConfig {
   public var clickAction: ShortKitSDK.PlayerClickAction
   public var cardOverlay: ShortKitSDK.VideoOverlayMode
   public var feedConfig: ShortKitSDK.FeedConfig
-  public init(cardCount: Swift.Int = 3, cardSpacing: CoreFoundation.CGFloat = 8, cornerRadius: CoreFoundation.CGFloat = 12, autoplay: Swift.Bool = true, muteOnStart: Swift.Bool = true, loop: Swift.Bool = true, rotationInterval: Foundation.TimeInterval = 10, clickAction: ShortKitSDK.PlayerClickAction = .feed, cardOverlay: ShortKitSDK.VideoOverlayMode = .none, feedConfig: ShortKitSDK.FeedConfig = FeedConfig())
+  public var filter: ShortKitSDK.FeedFilter?
+  public init(cardCount: Swift.Int = 3, cardSpacing: CoreFoundation.CGFloat = 8, cornerRadius: CoreFoundation.CGFloat = 12, autoplay: Swift.Bool = true, muteOnStart: Swift.Bool = true, loop: Swift.Bool = true, rotationInterval: Foundation.TimeInterval = 10, clickAction: ShortKitSDK.PlayerClickAction = .feed, cardOverlay: ShortKitSDK.VideoOverlayMode = .none, feedConfig: ShortKitSDK.FeedConfig = FeedConfig(), filter: ShortKitSDK.FeedFilter? = nil)
+  public func resolvedFeedConfig() -> ShortKitSDK.FeedConfig
 }
 extension ShortKitSDK.AdQuartile : Swift.Equatable {}
 extension ShortKitSDK.AdQuartile : Swift.Hashable {}
@@ -911,6 +1019,11 @@ extension ShortKitSDK.ScrollAxis : Swift.Hashable {}
 extension ShortKitSDK.ScrollAxis : Swift.RawRepresentable {}
 extension ShortKitSDK.FeedSource : Swift.Hashable {}
 extension ShortKitSDK.FeedSource : Swift.RawRepresentable {}
+extension ShortKitSDK.SwipeCurve : Swift.Equatable {}
+extension ShortKitSDK.SwipeCurve : Swift.Hashable {}
+extension ShortKitSDK.SwipeCurve : Swift.RawRepresentable {}
+extension ShortKitSDK.DownloadMode : Swift.Equatable {}
+extension ShortKitSDK.DownloadMode : Swift.Hashable {}
 extension ShortKitSDK.ShortKitFeedView : Swift.Sendable {}
 extension ShortKitSDK.CaptionSource : Swift.Equatable {}
 extension ShortKitSDK.CaptionSource : Swift.Hashable {}

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

@@ -1,7 +1,7 @@
 // swift-interface-format-version: 1.0
-// swift-compiler-version: Apple Swift version 6.1 effective-5.10 (swiftlang-6.1.0.110.21 clang-1700.0.13.3)
+// swift-compiler-version: Apple Swift version 6.3 effective-5.10 (swiftlang-6.3.0.123.5 clang-2100.0.123.102)
 // swift-module-flags: -target x86_64-apple-ios15.0-simulator -enable-objc-interop -enable-library-evolution -swift-version 5 -O -module-name ShortKitSDK -package-name swift_sdk
-// swift-module-flags-ignorable:  -interface-compiler-version 6.1
+// swift-module-flags-ignorable:  -formal-cxx-interoperability-mode=off -interface-compiler-version 6.3
 import AVFoundation
 import Combine
 import CoreGraphics
@@ -217,6 +217,13 @@ public struct FeedConfig : Swift.Codable {
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
 }
+public enum FeedMaskMode {
+  case none
+  case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.FeedMask)
+}
+extension ShortKitSDK.FeedMaskMode : Swift.Equatable {
+  public static func == (lhs: ShortKitSDK.FeedMaskMode, rhs: ShortKitSDK.FeedMaskMode) -> Swift.Bool
+}
 public enum VideoOverlayMode {
   case none
   case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.FeedOverlay)
@@ -275,6 +282,51 @@ extension ShortKitSDK.AdOverlayMode : 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
+  public var playerState: ShortKitSDK.PlayerState
+  public var intentToFrameMs: Swift.Int?
+  public var transitionToFrameMs: Swift.Int?
+  public var networkMs: Swift.Int?
+  public var decodeMs: Swift.Int?
+  public var prerollCompleted: Swift.Bool
+  public var observedBitrateBps: Swift.Double
+  public var indicatedBitrateBps: Swift.Double
+  public var bufferAhead: Swift.Double
+  public var rebufferCount: Swift.Int
+  public var lastRebufferDurationMs: Swift.Int?
+  public var currentTime: Swift.Double
+  public var duration: Swift.Double
+  public var loopCount: Swift.Int
+  public var videoWidth: Swift.Int
+  public var videoHeight: Swift.Int
+  public var codec: Swift.String?
+  public var thumbnailVisible: Swift.Bool
+  public var thumbsCachedAhead: Swift.Int
+  public var metadataAhead: Swift.Int
+  public init(contentId: Swift.String? = nil)
+}
+public enum SwipeCurve : Swift.Int, Swift.CaseIterable {
+  case quarticOut
+  case quinticOut
+  case expoOut
+  case microBounce
+  public var label: Swift.String {
+    get
+  }
+  public func apply(_ t: CoreFoundation.CGFloat) -> CoreFoundation.CGFloat
+  public static var selected: ShortKitSDK.SwipeCurve
+  public init?(rawValue: Swift.Int)
+  public typealias AllCases = [ShortKitSDK.SwipeCurve]
+  public typealias RawValue = Swift.Int
+  nonisolated public static var allCases: [ShortKitSDK.SwipeCurve] {
+    get
+  }
+  public var rawValue: Swift.Int {
+    get
+  }
+}
 public protocol ShortKitDelegate : AnyObject {
   func shortKit(_ shortKit: ShortKitSDK.ShortKit, didChangeRefreshState state: ShortKitSDK.ShortKitRefreshState)
   func shortKit(_ shortKit: ShortKitSDK.ShortKit, didTapContent contentId: Swift.String, at index: Swift.Int)
@@ -285,6 +337,34 @@ extension ShortKitSDK.ShortKitDelegate {
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didTapContent contentId: Swift.String, at index: Swift.Int)
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didFetchContentItems items: [ShortKitSDK.ContentItem])
 }
+public protocol ShortKitDownloadDelegate : AnyObject {
+  func shortKit(_ shortKit: ShortKitSDK.ShortKit, didStartDownload item: ShortKitSDK.ContentItem)
+  func shortKit(_ shortKit: ShortKitSDK.ShortKit, didUpdateDownloadProgress item: ShortKitSDK.ContentItem, progress: Swift.Double)
+  func shortKit(_ shortKit: ShortKitSDK.ShortKit, didCompleteDownload item: ShortKitSDK.ContentItem, fileURL: Foundation.URL)
+  func shortKit(_ shortKit: ShortKitSDK.ShortKit, didFailDownload item: ShortKitSDK.ContentItem, error: ShortKitSDK.ShortKitDownloadError)
+}
+extension ShortKitSDK.ShortKitDownloadDelegate {
+  public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didStartDownload item: ShortKitSDK.ContentItem)
+  public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didUpdateDownloadProgress item: ShortKitSDK.ContentItem, progress: Swift.Double)
+  public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didCompleteDownload item: ShortKitSDK.ContentItem, fileURL: Foundation.URL)
+  public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didFailDownload item: ShortKitSDK.ContentItem, error: ShortKitSDK.ShortKitDownloadError)
+}
+public enum DownloadMode {
+  case nonInterruptive
+  case interruptive
+  public static func == (a: ShortKitSDK.DownloadMode, b: ShortKitSDK.DownloadMode) -> Swift.Bool
+  public func hash(into hasher: inout Swift.Hasher)
+  public var hashValue: Swift.Int {
+    get
+  }
+}
+public enum ShortKitDownloadError : Swift.Error {
+  case downloadNotAvailable
+  case downloadInProgress
+  case networkError(any Swift.Error)
+  case httpError(statusCode: Swift.Int)
+  case cancelled
+}
 @_hasMissingDesignatedInitializers final public class FeedPreload : @unchecked Swift.Sendable {
   @objc deinit
 }
@@ -301,6 +381,7 @@ extension ShortKitSDK.ShortKitDelegate {
   public typealias UIViewControllerType = ShortKitSDK.ShortKitFeedViewController
 }
 @objc @_hasMissingDesignatedInitializers @_Concurrency.MainActor @preconcurrency public class ShortKitFeedViewController : UIKit.UIViewController {
+  @_Concurrency.MainActor @preconcurrency public var debugPanelFactory: ((_ active: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>, _ prev: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>, _ next: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>) -> UIKit.UIView)?
   @_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)?
@@ -321,6 +402,10 @@ extension ShortKitSDK.ShortKitDelegate {
     @objc get
   }
   @objc deinit
+  @_Concurrency.MainActor @preconcurrency @objc override dynamic public var canBecomeFirstResponder: Swift.Bool {
+    @objc get
+  }
+  @_Concurrency.MainActor @preconcurrency @objc override dynamic public func motionEnded(_ motion: UIKit.UIEvent.EventSubtype, with event: UIKit.UIEvent?)
 }
 extension ShortKitSDK.ShortKitFeedViewController : UIKit.UICollectionViewDelegate {
   @_Concurrency.MainActor @preconcurrency @objc dynamic public func collectionView(_ collectionView: UIKit.UICollectionView, willDisplay cell: UIKit.UICollectionViewCell, forItemAt indexPath: Foundation.IndexPath)
@@ -422,10 +507,17 @@ public struct ContentItem : Swift.Codable, Swift.Equatable, @unchecked Swift.Sen
   public let articleUrl: Swift.String?
   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 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 FeedInput : Swift.Sendable {
   case video(playbackId: Swift.String, fallbackUrl: Swift.String? = nil)
   case imageCarousel(ShortKitSDK.ImageCarouselItem)
@@ -610,7 +702,7 @@ extension ShortKitSDK.CarouselOverlay {
   public func updateActiveImage(index: Swift.Int)
 }
 final public class CellContent : Combine.ObservableObject {
-  @Combine.Published @_projectedValueProperty($item) final public var item: ShortKitSDK.ContentItem? {
+  @Combine.Published<ShortKitSDK.ContentItem?> @_projectedValueProperty($item) final public var item: ShortKitSDK.ContentItem? {
     get
     @available(iOS 13.0, tvOS 13.0, watchOS 6.0, macOS 10.15, *)
     set
@@ -626,6 +718,12 @@ final public class CellContent : Combine.ObservableObject {
   public typealias ObjectWillChangePublisher = Combine.ObservableObjectPublisher
   @objc deinit
 }
+public protocol FeedMask : AnyObject {
+  var feedRegion: UIKit.UIView { get }
+  func attach(player: ShortKitSDK.ShortKitPlayer)
+  func configure(with item: ShortKitSDK.ContentItem)
+  func activatePlayback()
+}
 public protocol FeedOverlay : AnyObject {
   func attach(player: ShortKitSDK.ShortKitPlayer)
   func configure(with item: ShortKitSDK.ContentItem)
@@ -819,9 +917,11 @@ public enum ShortKitVersion {
 }
 final public class ShortKit {
   final public let player: ShortKitSDK.ShortKitPlayer
+  final public let debugPanelEnabled: Swift.Bool
   weak final public var delegate: (any ShortKitSDK.ShortKitDelegate)?
+  weak final public var downloadDelegate: (any ShortKitSDK.ShortKitDownloadDelegate)?
   final public var loadingViewProvider: (() -> UIKit.UIView)?
-  public init(apiKey: Swift.String, userId: Swift.String? = nil, adProvider: (any ShortKitSDK.ShortKitAdProvider)? = nil, clientAppName: Swift.String? = nil, clientAppVersion: Swift.String? = nil, customDimensions: [Swift.String : Swift.String]? = nil, loadingViewProvider: (() -> UIKit.UIView)? = nil)
+  public init(apiKey: Swift.String, userId: Swift.String? = nil, adProvider: (any ShortKitSDK.ShortKitAdProvider)? = nil, clientAppName: Swift.String? = nil, clientAppVersion: Swift.String? = nil, customDimensions: [Swift.String : Swift.String]? = nil, loadingViewProvider: (() -> UIKit.UIView)? = nil, debugPanelEnabled: Swift.Bool = false)
   final public func preloadFeed(filter: ShortKitSDK.FeedFilter? = nil, limit: Swift.Int = 10) -> ShortKitSDK.FeedPreload
   final public func preloadFeed(items: [ShortKitSDK.FeedInput]) -> ShortKitSDK.FeedPreload
   final public func fetchContent(limit: Swift.Int = 10, filter: ShortKitSDK.FeedFilter? = nil) async throws -> [ShortKitSDK.ContentItem]
@@ -829,6 +929,8 @@ final public class ShortKit {
   final public func clearUserId()
   @_Concurrency.MainActor final public func setColdStartQueue(_ items: [ShortKitSDK.FeedInput])
   final public func clearColdStartCache()
+  final public func downloadVideo(_ item: ShortKitSDK.ContentItem, mode: ShortKitSDK.DownloadMode = .nonInterruptive) async throws -> Foundation.URL
+  final public func cancelDownload()
   @objc deinit
 }
 public enum PlayerClickAction : Swift.Sendable {
@@ -860,6 +962,7 @@ public struct PlayerConfig {
   public typealias UIViewControllerType = ShortKitSDK.ShortKitPlayerViewController
 }
 @objc @_hasMissingDesignatedInitializers @_Concurrency.MainActor @preconcurrency final public class ShortKitPlayerViewController : UIKit.UIViewController {
+  @_Concurrency.MainActor @preconcurrency final public var feedMask: ShortKitSDK.FeedMaskMode
   @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.PlayerConfig)
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidLoad()
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewWillDisappear(_ animated: Swift.Bool)
@@ -872,8 +975,10 @@ public struct PlayerConfig {
 extension ShortKitSDK.ShortKitPlayerViewController : UIKit.UIViewControllerTransitioningDelegate {
   @_Concurrency.MainActor @preconcurrency @objc final public func animationController(forPresented presented: UIKit.UIViewController, presenting: UIKit.UIViewController, source: UIKit.UIViewController) -> (any UIKit.UIViewControllerAnimatedTransitioning)?
   @_Concurrency.MainActor @preconcurrency @objc final public func animationController(forDismissed dismissed: UIKit.UIViewController) -> (any UIKit.UIViewControllerAnimatedTransitioning)?
+  @_Concurrency.MainActor @preconcurrency @objc final public func interactionControllerForDismissal(using animator: any UIKit.UIViewControllerAnimatedTransitioning) -> (any UIKit.UIViewControllerInteractiveTransitioning)?
 }
 @objc @_hasMissingDesignatedInitializers @_Concurrency.MainActor @preconcurrency final public class ShortKitWidgetViewController : UIKit.UIViewController {
+  @_Concurrency.MainActor @preconcurrency final public var feedMask: ShortKitSDK.FeedMaskMode
   @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.WidgetConfig)
   @_Concurrency.MainActor @preconcurrency final public func configure(with items: [ShortKitSDK.ContentItem])
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidLoad()
@@ -891,6 +996,7 @@ extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UICollectionViewDeleg
 extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UIViewControllerTransitioningDelegate {
   @_Concurrency.MainActor @preconcurrency @objc final public func animationController(forPresented presented: UIKit.UIViewController, presenting: UIKit.UIViewController, source: UIKit.UIViewController) -> (any UIKit.UIViewControllerAnimatedTransitioning)?
   @_Concurrency.MainActor @preconcurrency @objc final public func animationController(forDismissed dismissed: UIKit.UIViewController) -> (any UIKit.UIViewControllerAnimatedTransitioning)?
+  @_Concurrency.MainActor @preconcurrency @objc final public func interactionControllerForDismissal(using animator: any UIKit.UIViewControllerAnimatedTransitioning) -> (any UIKit.UIViewControllerInteractiveTransitioning)?
 }
 public struct WidgetConfig {
   public var cardCount: Swift.Int
@@ -903,7 +1009,9 @@ public struct WidgetConfig {
   public var clickAction: ShortKitSDK.PlayerClickAction
   public var cardOverlay: ShortKitSDK.VideoOverlayMode
   public var feedConfig: ShortKitSDK.FeedConfig
-  public init(cardCount: Swift.Int = 3, cardSpacing: CoreFoundation.CGFloat = 8, cornerRadius: CoreFoundation.CGFloat = 12, autoplay: Swift.Bool = true, muteOnStart: Swift.Bool = true, loop: Swift.Bool = true, rotationInterval: Foundation.TimeInterval = 10, clickAction: ShortKitSDK.PlayerClickAction = .feed, cardOverlay: ShortKitSDK.VideoOverlayMode = .none, feedConfig: ShortKitSDK.FeedConfig = FeedConfig())
+  public var filter: ShortKitSDK.FeedFilter?
+  public init(cardCount: Swift.Int = 3, cardSpacing: CoreFoundation.CGFloat = 8, cornerRadius: CoreFoundation.CGFloat = 12, autoplay: Swift.Bool = true, muteOnStart: Swift.Bool = true, loop: Swift.Bool = true, rotationInterval: Foundation.TimeInterval = 10, clickAction: ShortKitSDK.PlayerClickAction = .feed, cardOverlay: ShortKitSDK.VideoOverlayMode = .none, feedConfig: ShortKitSDK.FeedConfig = FeedConfig(), filter: ShortKitSDK.FeedFilter? = nil)
+  public func resolvedFeedConfig() -> ShortKitSDK.FeedConfig
 }
 extension ShortKitSDK.AdQuartile : Swift.Equatable {}
 extension ShortKitSDK.AdQuartile : Swift.Hashable {}
@@ -911,6 +1019,11 @@ extension ShortKitSDK.ScrollAxis : Swift.Hashable {}
 extension ShortKitSDK.ScrollAxis : Swift.RawRepresentable {}
 extension ShortKitSDK.FeedSource : Swift.Hashable {}
 extension ShortKitSDK.FeedSource : Swift.RawRepresentable {}
+extension ShortKitSDK.SwipeCurve : Swift.Equatable {}
+extension ShortKitSDK.SwipeCurve : Swift.Hashable {}
+extension ShortKitSDK.SwipeCurve : Swift.RawRepresentable {}
+extension ShortKitSDK.DownloadMode : Swift.Equatable {}
+extension ShortKitSDK.DownloadMode : Swift.Hashable {}
 extension ShortKitSDK.ShortKitFeedView : Swift.Sendable {}
 extension ShortKitSDK.CaptionSource : Swift.Equatable {}
 extension ShortKitSDK.CaptionSource : Swift.Hashable {}

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

@@ -10,39 +10,39 @@
 		</data>
 		<key>Info.plist</key>
 		<data>
-		DRi6bbSOUeSAAIm7s4wI84F/hZs=
+		slY81X2CJlE1Pc6TjenuCp90CSs=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		+swBplqwoFlD6xRhlqWuOL5gPSw=
+		0TmEtkdyeDtGF9z1GonyKRX1OIk=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		iUMHq+Qj8DscP274R5GeG2xvNH8=
+		EyeJYhkTLApLeAoODyn7P3qdVZY=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		8U2c7SMQrXEeUhX90nKanEcgEAk=
+		HE+XPfFpv4kMMRInspsxHhhXkw4=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		iUMHq+Qj8DscP274R5GeG2xvNH8=
+		EyeJYhkTLApLeAoODyn7P3qdVZY=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		+swBplqwoFlD6xRhlqWuOL5gPSw=
+		0TmEtkdyeDtGF9z1GonyKRX1OIk=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		ImhimtbXumFH4th+RbbYdJ0YCzE=
+		9KZgxBHMYkTCwRzoy4Ka8H+EAgY=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		R6oc6kLOJb/xoMsgp/km0Poi1kc=
+		pGKYJUkUKWstUmgNirkMz9UZfXw=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		ImhimtbXumFH4th+RbbYdJ0YCzE=
+		9KZgxBHMYkTCwRzoy4Ka8H+EAgY=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -66,56 +66,56 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			+PEgfWnyLqxgBoYje9djS72+fVRMGusRGFd9dEe2i6c=
+			8YuVfF0QAXEqQa3D9XBHjhehjxHFdKOWvdGWcWcpL1I=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			e5/qH1qQ6qcVmKFpkHEq0L1tGdkrRgtSQYcRUCBMKXA=
+			YocaRcQ6ILnEzQPEMCG/TpddeUKnFr5CCG6d7lwMs6c=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			oq/inZsW9xL64oneb9MG748gHqK4Qk+piGV6te+g6Mo=
+			8D3JzqWKNEUX1+kjgT8Fm/WQRi9dkyAGOowk2wYL2eM=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			e5/qH1qQ6qcVmKFpkHEq0L1tGdkrRgtSQYcRUCBMKXA=
+			YocaRcQ6ILnEzQPEMCG/TpddeUKnFr5CCG6d7lwMs6c=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			+PEgfWnyLqxgBoYje9djS72+fVRMGusRGFd9dEe2i6c=
+			8YuVfF0QAXEqQa3D9XBHjhehjxHFdKOWvdGWcWcpL1I=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			38MzrDhqENlgkAVYwZB5Rr2mqB4LLk1HAbSfndog68U=
+			une5ImatYPq9T1HlZHjrO8WrjG1AM7s7ft783RqMgSU=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			43HpadfJMiwUvAAbMFaPVgch8fbhU7hO4fqYtDOdF+E=
+			Jv93EDTJvoM0SmW3gXGty+JtS4YoRc2PxBLpd8aPvYw=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			38MzrDhqENlgkAVYwZB5Rr2mqB4LLk1HAbSfndog68U=
+			une5ImatYPq9T1HlZHjrO8WrjG1AM7s7ft783RqMgSU=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/ios/ShortKitWidgetNativeView.swift

@@ -135,6 +135,11 @@ import ShortKitSDK
             overlayMode = .none
         }
 
+        let filter: FeedFilter? = {
+            guard let filterStr = obj["filter"] as? String else { return nil }
+            return ShortKitBridge.parseFeedFilter(filterStr)
+        }()
+
         return WidgetConfig(
             cardCount: cardCount,
             cardSpacing: cardSpacing,
@@ -144,7 +149,8 @@ import ShortKitSDK
             loop: loop,
             rotationInterval: rotationInterval / 1000.0, // JS sends ms, iOS expects seconds
             clickAction: clickAction,
-            cardOverlay: overlayMode
+            cardOverlay: overlayMode,
+            filter: filter
         )
     }
 

package/package.json

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

package/src/ShortKitFeed.tsx

@@ -33,7 +33,6 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     preloadId,
     style,
     startAtItemId,
-    onSurveyResponse,
     onLoop,
     onFeedTransition,
     onFormatChange,
@@ -129,17 +128,6 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
 
     const subscriptions: Array<{ remove: () => void }> = [];
 
-    if (onSurveyResponse) {
-      subscriptions.push(
-        NativeShortKitModule.onSurveyResponse((event) => {
-          onSurveyResponse(event.surveyId, {
-            id: event.optionId,
-            text: event.optionText,
-          });
-        }),
-      );
-    }
-
     if (onLoop) {
       subscriptions.push(
         NativeShortKitModule.onDidLoop((event) => {
@@ -222,7 +210,6 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
       }
     };
   }, [
-    onSurveyResponse,
     onLoop,
     onFeedTransition,
     onFormatChange,