@shortkitsdk/react-native 0.2.22 → 0.2.24

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

@@ -337,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
 }
@@ -479,14 +507,21 @@ 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)
-  case videoCarousel(ShortKitSDK.VideoCarouselItem)
+  case videoCarousel(ShortKitSDK.VideoCarouselInput)
 }
 public enum FeedItem : Swift.Sendable {
   case content(ShortKitSDK.ContentItem)
@@ -630,6 +665,19 @@ public struct VTTCue : Swift.Equatable, Swift.Sendable {
   public init(startTime: Swift.Double, endTime: Swift.Double, text: Swift.String)
   public static func == (a: ShortKitSDK.VTTCue, b: ShortKitSDK.VTTCue) -> Swift.Bool
 }
+public struct VideoCarouselInput : Swift.Codable, Swift.Equatable, Swift.Sendable {
+  public let id: Swift.String
+  public let videos: [ShortKitSDK.VideoCarouselVideoInput]
+  public let title: Swift.String?
+  public let description: Swift.String?
+  public let author: Swift.String?
+  public let section: Swift.String?
+  public let articleUrl: Swift.String?
+  public init(id: Swift.String, videos: [ShortKitSDK.VideoCarouselVideoInput], title: Swift.String? = nil, description: Swift.String? = nil, author: Swift.String? = nil, section: Swift.String? = nil, articleUrl: Swift.String? = nil)
+  public static func == (a: ShortKitSDK.VideoCarouselInput, b: ShortKitSDK.VideoCarouselInput) -> Swift.Bool
+  public func encode(to encoder: any Swift.Encoder) throws
+  public init(from decoder: any Swift.Decoder) throws
+}
 public struct VideoCarouselItem : Swift.Codable, Swift.Equatable, Swift.Sendable {
   public let id: Swift.String
   public let videos: [ShortKitSDK.ContentItem]
@@ -643,6 +691,14 @@ public struct VideoCarouselItem : Swift.Codable, Swift.Equatable, Swift.Sendable
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
 }
+public struct VideoCarouselVideoInput : Swift.Codable, Swift.Equatable, Swift.Sendable {
+  public let playbackId: Swift.String
+  public let fallbackUrl: Swift.String?
+  public init(playbackId: Swift.String, 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
+}
 public protocol AdOverlay : AnyObject {
   func configure(with content: ShortKitSDK.NativeAdContent)
   func resetState()
@@ -654,6 +710,7 @@ public protocol CarouselOverlay : AnyObject {
   var wantsNativeImagePrefetch: Swift.Bool { get }
   func activatePlayback()
   func updateActiveImage(index: Swift.Int)
+  func resetToFirstImage()
 }
 extension ShortKitSDK.CarouselOverlay {
   public var cachedImage: ((Swift.String) -> UIKit.UIImage?)? {
@@ -665,6 +722,7 @@ extension ShortKitSDK.CarouselOverlay {
   }
   public func activatePlayback()
   public func updateActiveImage(index: Swift.Int)
+  public func resetToFirstImage()
 }
 final public class CellContent : Combine.ObservableObject {
   @Combine.Published<ShortKitSDK.ContentItem?> @_projectedValueProperty($item) final public var item: ShortKitSDK.ContentItem? {
@@ -884,6 +942,7 @@ 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, debugPanelEnabled: Swift.Bool = false)
   final public func preloadFeed(filter: ShortKitSDK.FeedFilter? = nil, limit: Swift.Int = 10) -> ShortKitSDK.FeedPreload
@@ -893,6 +952,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 {
@@ -984,6 +1045,8 @@ 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

@@ -337,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
 }
@@ -479,14 +507,21 @@ 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)
-  case videoCarousel(ShortKitSDK.VideoCarouselItem)
+  case videoCarousel(ShortKitSDK.VideoCarouselInput)
 }
 public enum FeedItem : Swift.Sendable {
   case content(ShortKitSDK.ContentItem)
@@ -630,6 +665,19 @@ public struct VTTCue : Swift.Equatable, Swift.Sendable {
   public init(startTime: Swift.Double, endTime: Swift.Double, text: Swift.String)
   public static func == (a: ShortKitSDK.VTTCue, b: ShortKitSDK.VTTCue) -> Swift.Bool
 }
+public struct VideoCarouselInput : Swift.Codable, Swift.Equatable, Swift.Sendable {
+  public let id: Swift.String
+  public let videos: [ShortKitSDK.VideoCarouselVideoInput]
+  public let title: Swift.String?
+  public let description: Swift.String?
+  public let author: Swift.String?
+  public let section: Swift.String?
+  public let articleUrl: Swift.String?
+  public init(id: Swift.String, videos: [ShortKitSDK.VideoCarouselVideoInput], title: Swift.String? = nil, description: Swift.String? = nil, author: Swift.String? = nil, section: Swift.String? = nil, articleUrl: Swift.String? = nil)
+  public static func == (a: ShortKitSDK.VideoCarouselInput, b: ShortKitSDK.VideoCarouselInput) -> Swift.Bool
+  public func encode(to encoder: any Swift.Encoder) throws
+  public init(from decoder: any Swift.Decoder) throws
+}
 public struct VideoCarouselItem : Swift.Codable, Swift.Equatable, Swift.Sendable {
   public let id: Swift.String
   public let videos: [ShortKitSDK.ContentItem]
@@ -643,6 +691,14 @@ public struct VideoCarouselItem : Swift.Codable, Swift.Equatable, Swift.Sendable
   public func encode(to encoder: any Swift.Encoder) throws
   public init(from decoder: any Swift.Decoder) throws
 }
+public struct VideoCarouselVideoInput : Swift.Codable, Swift.Equatable, Swift.Sendable {
+  public let playbackId: Swift.String
+  public let fallbackUrl: Swift.String?
+  public init(playbackId: Swift.String, 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
+}
 public protocol AdOverlay : AnyObject {
   func configure(with content: ShortKitSDK.NativeAdContent)
   func resetState()
@@ -654,6 +710,7 @@ public protocol CarouselOverlay : AnyObject {
   var wantsNativeImagePrefetch: Swift.Bool { get }
   func activatePlayback()
   func updateActiveImage(index: Swift.Int)
+  func resetToFirstImage()
 }
 extension ShortKitSDK.CarouselOverlay {
   public var cachedImage: ((Swift.String) -> UIKit.UIImage?)? {
@@ -665,6 +722,7 @@ extension ShortKitSDK.CarouselOverlay {
   }
   public func activatePlayback()
   public func updateActiveImage(index: Swift.Int)
+  public func resetToFirstImage()
 }
 final public class CellContent : Combine.ObservableObject {
   @Combine.Published<ShortKitSDK.ContentItem?> @_projectedValueProperty($item) final public var item: ShortKitSDK.ContentItem? {
@@ -884,6 +942,7 @@ 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, debugPanelEnabled: Swift.Bool = false)
   final public func preloadFeed(filter: ShortKitSDK.FeedFilter? = nil, limit: Swift.Int = 10) -> ShortKitSDK.FeedPreload
@@ -893,6 +952,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 {
@@ -984,6 +1045,8 @@ 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>
-		N6BIyiZTG7NybeUMWtT8+6ppr/A=
+		aVOP/OHkEUzNyBoUHTT2iiGJbu4=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		XzFCNXT0oFqi22OvTJxQ8agFCQ0=
+		mxcDambiFIzUbFTPfCTaKwjGz/8=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		j1YuWonnCZA/HaM1cP3EOX85eY4=
+		wayE2tftrhjvaEAekKB20ZGO36g=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		lRwA+tdWhsfEF7MzPS63sMMFHVQ=
+		OXtQVstuyP3hqDsSczrvdpR/BZY=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		j1YuWonnCZA/HaM1cP3EOX85eY4=
+		wayE2tftrhjvaEAekKB20ZGO36g=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		XzFCNXT0oFqi22OvTJxQ8agFCQ0=
+		mxcDambiFIzUbFTPfCTaKwjGz/8=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		rs16WOdN1D8vIEvmH5Wtylpuqzs=
+		c5HZCcsGjJPhu5ppN3Wq4SsCx2A=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		9PRodo2h/+R4oGQMpMvB5dhaEVU=
+		IjquwfiAxSFG2n0IR/+e9HvnZCM=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		rs16WOdN1D8vIEvmH5Wtylpuqzs=
+		c5HZCcsGjJPhu5ppN3Wq4SsCx2A=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -66,56 +66,56 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			P/PhTd4eHyjgqdxeeC7V0MMZR0OL6Ob1vGdNyE+7SgU=
+			s3LSfH8aLgl3mic08rsi958gHLv6ImNC8MsZtFoy8u0=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			Ci2BwA0M1RNvymgreB44XItKdH3uLeswCR5suw6bTbA=
+			cYm595F0j0GSGb/GBTR7QHYSuFeUw9ZTPc8F87PKzvA=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			is5BMNiEvgHulXtIgjVIzD+UJnS2nkvI2LrkZvDOXIo=
+			9FsW2XMD0E0AiZ7mHDBgLg/OeCcSwB2BmWG3PuPqPwM=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			Ci2BwA0M1RNvymgreB44XItKdH3uLeswCR5suw6bTbA=
+			cYm595F0j0GSGb/GBTR7QHYSuFeUw9ZTPc8F87PKzvA=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			P/PhTd4eHyjgqdxeeC7V0MMZR0OL6Ob1vGdNyE+7SgU=
+			s3LSfH8aLgl3mic08rsi958gHLv6ImNC8MsZtFoy8u0=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			n9cGqlcajvgi24HhUuEaWnzqdS25+zyyqGCkngfkpaw=
+			QRoqxRRNskUOSMbf+RlD6fMBj0mmhgmOres7jwvebiQ=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			PgFD4kP2WDXeolbcHxmC5r+pkgJLjtYxhZDRUWhAIcA=
+			R1p/WNYI3bnLOrWsIezOXSJRZEwJ/t8FuoDZCBZQhHg=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			n9cGqlcajvgi24HhUuEaWnzqdS25+zyyqGCkngfkpaw=
+			QRoqxRRNskUOSMbf+RlD6fMBj0mmhgmOres7jwvebiQ=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/package.json

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

package/src/ShortKitCommands.ts

@@ -28,4 +28,7 @@ export const ShortKitCommands = {
     NativeShortKitModule?.prefetchStoryboard(playbackId),
   getStoryboardData: (playbackId: string): Promise<string | null> =>
     NativeShortKitModule?.getStoryboardData(playbackId) ?? Promise.resolve(null),
+  downloadVideo: (itemId: string, mode: 'nonInterruptive' | 'interruptive' = 'nonInterruptive'): Promise<string> =>
+    NativeShortKitModule?.downloadVideo(itemId, mode) ?? Promise.reject(new Error('ShortKit not initialized')),
+  cancelDownload: () => NativeShortKitModule?.cancelDownload(),
 } as const;

package/src/ShortKitContext.ts

@@ -1,6 +1,7 @@
 import { createContext } from 'react';
 import type {
   ContentItem,
+  DownloadState,
   FeedConfig,
   FeedFilter,
   FeedInput,
@@ -51,6 +52,11 @@ export interface ShortKitContextValue {
   // Storyboard / seek thumbnails
   prefetchStoryboard: (playbackId: string) => void;
   getStoryboardData: (playbackId: string) => Promise<StoryboardData | null>;
+
+  // Download
+  downloadState: DownloadState;
+  downloadVideo: (itemId: string, mode?: 'nonInterruptive' | 'interruptive') => Promise<string>;
+  cancelDownload: () => void;
 }
 
 export const ShortKitContext = createContext<ShortKitContextValue | null>(null);

package/src/ShortKitProvider.tsx

@@ -6,6 +6,7 @@ import type { ShortKitContextValue } from './ShortKitContext';
 import type {
   ShortKitProviderProps,
   ContentItem,
+  DownloadState,
   FeedConfig,
   FeedFilter,
   FeedInput,
@@ -23,6 +24,7 @@ import {
   deserializePlayerTime,
 } from './serialization';
 import NativeShortKitModule from './specs/NativeShortKitModule';
+import { ShortKitCommands } from './ShortKitCommands';
 import { registerLoadingComponent } from './ShortKitLoadingSurface';
 
 // ---------------------------------------------------------------------------
@@ -41,6 +43,7 @@ interface State {
   prefetchedAheadCount: number;
   isActive: boolean;
   feedScrollPhase: FeedScrollPhase | null;
+  downloadState: DownloadState;
 }
 
 const initialState: State = {
@@ -55,6 +58,7 @@ const initialState: State = {
   prefetchedAheadCount: 0,
   isActive: false,
   feedScrollPhase: null,
+  downloadState: { status: 'idle', progress: 0 },
 };
 
 type Action =
@@ -67,7 +71,11 @@ type Action =
   | { type: 'CAPTION_TRACK'; payload: CaptionTrack | null }
   | { type: 'CUE'; payload: { text: string; startTime: number; endTime: number } | null }
   | { type: 'PREFETCH_COUNT'; payload: number }
-  | { type: 'FEED_SCROLL_PHASE'; payload: FeedScrollPhase };
+  | { type: 'FEED_SCROLL_PHASE'; payload: FeedScrollPhase }
+  | { type: 'DOWNLOAD_STARTED'; itemId: string }
+  | { type: 'DOWNLOAD_PROGRESS'; itemId: string; progress: number }
+  | { type: 'DOWNLOAD_COMPLETED'; itemId: string; fileUrl: string }
+  | { type: 'DOWNLOAD_FAILED'; itemId: string; error: string };
 
 function reducer(state: State, action: Action): State {
   switch (action.type) {
@@ -101,6 +109,14 @@ function reducer(state: State, action: Action): State {
       return { ...state, prefetchedAheadCount: action.payload };
     case 'FEED_SCROLL_PHASE':
       return { ...state, feedScrollPhase: action.payload };
+    case 'DOWNLOAD_STARTED':
+      return { ...state, downloadState: { status: 'downloading', itemId: action.itemId, progress: 0 } };
+    case 'DOWNLOAD_PROGRESS':
+      return { ...state, downloadState: { ...state.downloadState, progress: action.progress } };
+    case 'DOWNLOAD_COMPLETED':
+      return { ...state, downloadState: { status: 'completed', itemId: action.itemId, progress: 1, fileUrl: action.fileUrl } };
+    case 'DOWNLOAD_FAILED':
+      return { ...state, downloadState: { status: 'failed', itemId: action.itemId, progress: 0, error: action.error } };
     default:
       return state;
   }
@@ -327,6 +343,26 @@ export function ShortKitProvider({
       }),
     );
 
+    // Download started
+    const downloadStartedSub = NativeShortKitModule.onDownloadStarted((event) => {
+      dispatch({ type: 'DOWNLOAD_STARTED', itemId: event.itemId });
+    });
+
+    // Download progress
+    const downloadProgressSub = NativeShortKitModule.onDownloadProgress((event) => {
+      dispatch({ type: 'DOWNLOAD_PROGRESS', itemId: event.itemId, progress: event.progress });
+    });
+
+    // Download completed
+    const downloadCompletedSub = NativeShortKitModule.onDownloadCompleted((event) => {
+      dispatch({ type: 'DOWNLOAD_COMPLETED', itemId: event.itemId, fileUrl: event.fileUrl });
+    });
+
+    // Download failed
+    const downloadFailedSub = NativeShortKitModule.onDownloadFailed((event) => {
+      dispatch({ type: 'DOWNLOAD_FAILED', itemId: event.itemId, error: event.error });
+    });
+
     // Note: Feed-level callback events (onDidLoop, onFeedTransition,
     // onDismiss, etc.) are subscribed by the ShortKitFeed component
     // not here. The provider only manages state-driving events.
@@ -335,6 +371,10 @@ export function ShortKitProvider({
       for (const sub of subscriptions) {
         sub.remove();
       }
+      downloadStartedSub.remove();
+      downloadProgressSub.remove();
+      downloadCompletedSub.remove();
+      downloadFailedSub.remove();
     };
   }, []);
 
@@ -447,6 +487,7 @@ export function ShortKitProvider({
       prefetchedAheadCount: state.prefetchedAheadCount,
       isActive: state.isActive,
       feedScrollPhase: state.feedScrollPhase,
+      downloadState: state.downloadState,
 
       // Commands
       play,
@@ -467,6 +508,8 @@ export function ShortKitProvider({
       preloadFeed: preloadFeedCmd,
       prefetchStoryboard: prefetchStoryboardCmd,
       getStoryboardData: getStoryboardDataCmd,
+      downloadVideo: ShortKitCommands.downloadVideo,
+      cancelDownload: ShortKitCommands.cancelDownload,
     }),
     [
       state.playerState,
@@ -480,6 +523,7 @@ export function ShortKitProvider({
       state.prefetchedAheadCount,
       state.isActive,
       state.feedScrollPhase,
+      state.downloadState,
       play,
       pause,
       seek,

package/src/index.ts

@@ -20,6 +20,8 @@ export type {
   CarouselImage,
   ImageCarouselItem,
   VideoCarouselItem,
+  VideoCarouselVideoInput,
+  VideoCarouselInput,
   FeedInput,
   JSONValue,
   CaptionTrack,

package/src/specs/NativeShortKitModule.ts

@@ -109,6 +109,25 @@ type FeedReadyEvent = Readonly<{
   feedId: string;
 }>;
 
+type DownloadStartedEvent = Readonly<{
+  itemId: string;
+}>;
+
+type DownloadProgressEvent = Readonly<{
+  itemId: string;
+  progress: number;
+}>;
+
+type DownloadCompletedEvent = Readonly<{
+  itemId: string;
+  fileUrl: string;
+}>;
+
+type DownloadFailedEvent = Readonly<{
+  itemId: string;
+  error: string;
+}>;
+
 // --- Overlay per-surface event payload types ---
 
 type OverlayActiveEvent = Readonly<{
@@ -216,6 +235,10 @@ export interface Spec extends TurboModule {
   prefetchStoryboard(playbackId: string): void;
   getStoryboardData(playbackId: string): Promise<string>;
 
+  // --- Download ---
+  downloadVideo(itemId: string, mode: string): Promise<string>;
+  cancelDownload(): void;
+
   // --- Event emitters ---
   readonly onPlayerStateChanged: EventEmitter<PlayerStateEvent>;
   readonly onCurrentItemChanged: EventEmitter<CurrentItemEvent>;
@@ -249,6 +272,12 @@ export interface Spec extends TurboModule {
   readonly onOverlayFullState: EventEmitter<OverlayFullStateEvent>;
   readonly onCarouselActiveImageChanged: EventEmitter<CarouselActiveImageEvent>;
   readonly onVideoCarouselActiveVideoChanged: EventEmitter<VideoCarouselActiveVideoEvent>;
+
+  // --- Download events ---
+  readonly onDownloadStarted: EventEmitter<DownloadStartedEvent>;
+  readonly onDownloadProgress: EventEmitter<DownloadProgressEvent>;
+  readonly onDownloadCompleted: EventEmitter<DownloadCompletedEvent>;
+  readonly onDownloadFailed: EventEmitter<DownloadFailedEvent>;
 }
 
 export default TurboModuleRegistry.getEnforcing<Spec>('ShortKitModule');

package/src/types.ts

@@ -68,6 +68,21 @@ export interface ContentItem {
   articleUrl?: string;
   commentCount?: number;
   fallbackUrl?: string;
+  downloadUrl?: string;
+}
+
+export type DownloadStatus = 'idle' | 'downloading' | 'completed' | 'failed';
+
+export interface DownloadState {
+  status: DownloadStatus;
+  /** ID of the content item being downloaded, if any. */
+  itemId?: string;
+  /** 0.0 to 1.0 progress fraction. */
+  progress: number;
+  /** Local file URL after successful download. */
+  fileUrl?: string;
+  /** Error message if download failed. */
+  error?: string;
 }
 
 // --- Custom Feed Types ---
@@ -98,10 +113,38 @@ export interface VideoCarouselItem {
   articleUrl?: string;
 }
 
+/**
+ * Per-slide input for a VideoCarouselInput. Mirrors the `{ type: 'video' }`
+ * FeedInput variant — host apps pass a playback ID and the SDK constructs
+ * the streaming and thumbnail URLs internally.
+ */
+export interface VideoCarouselVideoInput {
+  playbackId: string;
+  fallbackUrl?: string;
+}
+
+/**
+ * Compact input type for video carousels passed to
+ * `{ type: 'videoCarousel', item: VideoCarouselInput }`.
+ *
+ * The SDK hydrates each playback ID into a full ContentItem internally
+ * before rendering. Overlays continue to receive the fully-hydrated
+ * VideoCarouselItem shape via VideoCarouselOverlayProps.carouselItem.
+ */
+export interface VideoCarouselInput {
+  id: string;
+  videos: VideoCarouselVideoInput[];
+  title?: string;
+  description?: string;
+  author?: string;
+  section?: string;
+  articleUrl?: string;
+}
+
 export type FeedInput =
   | { type: 'video'; playbackId: string; fallbackUrl?: string }
   | { type: 'imageCarousel'; item: ImageCarouselItem }
-  | { type: 'videoCarousel'; item: VideoCarouselItem };
+  | { type: 'videoCarousel'; item: VideoCarouselInput };
 
 export type JSONValue =
   | string