@shortkitsdk/react-native 0.2.28 → 0.2.29

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

@@ -442,6 +442,15 @@ public enum ShortKitDownloadError : Swift.Error {
   public typealias Body = Swift.Never
   public typealias UIViewControllerType = ShortKitSDK.ShortKitFeedViewController
 }
+public enum ShortKitFeedLifecycle {
+  case automatic
+  case manual
+  public static func == (a: ShortKitSDK.ShortKitFeedLifecycle, b: ShortKitSDK.ShortKitFeedLifecycle) -> Swift.Bool
+  public func hash(into hasher: inout Swift.Hasher)
+  public var hashValue: Swift.Int {
+    get
+  }
+}
 @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)?
@@ -454,8 +463,12 @@ public enum ShortKitDownloadError : Swift.Error {
   }
   @_Concurrency.MainActor @preconcurrency public var onVideoCarouselCellTap: ((ShortKitSDK.ShortKitFeedViewController.VideoCarouselCellTapPayload) -> Swift.Void)?
   @_Concurrency.MainActor @preconcurrency public var onRefreshStateChanged: ((ShortKitSDK.ShortKitRefreshState) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency public var onFeedTransition: ((ShortKitSDK.FeedTransitionEvent) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency public var isActiveSurface: Swift.Bool {
+    get
+  }
   @_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 @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.FeedConfig, startAtItemId: Swift.String? = nil, lifecycle: ShortKitSDK.ShortKitFeedLifecycle = .automatic)
   @_Concurrency.MainActor public func setFeedItems(_ items: [ShortKitSDK.FeedInput], startAtId: Swift.String? = nil)
   @_Concurrency.MainActor public func scrollToItem(id: Swift.String, animated: Swift.Bool)
   @_Concurrency.MainActor public func appendFeedItems(_ items: [ShortKitSDK.FeedInput])
@@ -465,6 +478,7 @@ public enum ShortKitDownloadError : Swift.Error {
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewWillAppear(_ animated: Swift.Bool)
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewDidAppear(_ animated: Swift.Bool)
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewWillDisappear(_ animated: Swift.Bool)
+  @available(*, deprecated, message: "Pass lifecycle: .manual to ShortKitFeedViewController's initializer instead.")
   @_Concurrency.MainActor @preconcurrency public func setBridgeManaged()
   @_Concurrency.MainActor @preconcurrency public func activate()
   @_Concurrency.MainActor @preconcurrency public func deactivate()
@@ -940,6 +954,9 @@ public struct FeedTransitionEvent : Swift.Equatable, Swift.Sendable {
   public let from: ShortKitSDK.ContentItem?
   public let to: ShortKitSDK.ContentItem?
   public let direction: ShortKitSDK.FeedTransitionEvent.Direction
+  public let fromFeedItem: ShortKitSDK.FeedItem?
+  public let toFeedItem: ShortKitSDK.FeedItem?
+  public init(phase: ShortKitSDK.FeedTransitionEvent.Phase, from: ShortKitSDK.ContentItem?, to: ShortKitSDK.ContentItem?, direction: ShortKitSDK.FeedTransitionEvent.Direction, fromFeedItem: ShortKitSDK.FeedItem? = nil, toFeedItem: ShortKitSDK.FeedItem? = nil)
   public static func == (a: ShortKitSDK.FeedTransitionEvent, b: ShortKitSDK.FeedTransitionEvent) -> Swift.Bool
 }
 public struct FormatChangeEvent : Swift.Equatable, Swift.Sendable {
@@ -1191,6 +1208,8 @@ extension ShortKitSDK.SwipeCurve : Swift.RawRepresentable {}
 extension ShortKitSDK.DownloadMode : Swift.Equatable {}
 extension ShortKitSDK.DownloadMode : Swift.Hashable {}
 extension ShortKitSDK.ShortKitFeedView : Swift.Sendable {}
+extension ShortKitSDK.ShortKitFeedLifecycle : Swift.Equatable {}
+extension ShortKitSDK.ShortKitFeedLifecycle : Swift.Hashable {}
 extension ShortKitSDK.CaptionSource : Swift.Equatable {}
 extension ShortKitSDK.CaptionSource : Swift.Hashable {}
 extension ShortKitSDK.CaptionSource : Swift.RawRepresentable {}

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

@@ -442,6 +442,15 @@ public enum ShortKitDownloadError : Swift.Error {
   public typealias Body = Swift.Never
   public typealias UIViewControllerType = ShortKitSDK.ShortKitFeedViewController
 }
+public enum ShortKitFeedLifecycle {
+  case automatic
+  case manual
+  public static func == (a: ShortKitSDK.ShortKitFeedLifecycle, b: ShortKitSDK.ShortKitFeedLifecycle) -> Swift.Bool
+  public func hash(into hasher: inout Swift.Hasher)
+  public var hashValue: Swift.Int {
+    get
+  }
+}
 @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)?
@@ -454,8 +463,12 @@ public enum ShortKitDownloadError : Swift.Error {
   }
   @_Concurrency.MainActor @preconcurrency public var onVideoCarouselCellTap: ((ShortKitSDK.ShortKitFeedViewController.VideoCarouselCellTapPayload) -> Swift.Void)?
   @_Concurrency.MainActor @preconcurrency public var onRefreshStateChanged: ((ShortKitSDK.ShortKitRefreshState) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency public var onFeedTransition: ((ShortKitSDK.FeedTransitionEvent) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency public var isActiveSurface: Swift.Bool {
+    get
+  }
   @_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 @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.FeedConfig, startAtItemId: Swift.String? = nil, lifecycle: ShortKitSDK.ShortKitFeedLifecycle = .automatic)
   @_Concurrency.MainActor public func setFeedItems(_ items: [ShortKitSDK.FeedInput], startAtId: Swift.String? = nil)
   @_Concurrency.MainActor public func scrollToItem(id: Swift.String, animated: Swift.Bool)
   @_Concurrency.MainActor public func appendFeedItems(_ items: [ShortKitSDK.FeedInput])
@@ -465,6 +478,7 @@ public enum ShortKitDownloadError : Swift.Error {
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewWillAppear(_ animated: Swift.Bool)
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewDidAppear(_ animated: Swift.Bool)
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func viewWillDisappear(_ animated: Swift.Bool)
+  @available(*, deprecated, message: "Pass lifecycle: .manual to ShortKitFeedViewController's initializer instead.")
   @_Concurrency.MainActor @preconcurrency public func setBridgeManaged()
   @_Concurrency.MainActor @preconcurrency public func activate()
   @_Concurrency.MainActor @preconcurrency public func deactivate()
@@ -940,6 +954,9 @@ public struct FeedTransitionEvent : Swift.Equatable, Swift.Sendable {
   public let from: ShortKitSDK.ContentItem?
   public let to: ShortKitSDK.ContentItem?
   public let direction: ShortKitSDK.FeedTransitionEvent.Direction
+  public let fromFeedItem: ShortKitSDK.FeedItem?
+  public let toFeedItem: ShortKitSDK.FeedItem?
+  public init(phase: ShortKitSDK.FeedTransitionEvent.Phase, from: ShortKitSDK.ContentItem?, to: ShortKitSDK.ContentItem?, direction: ShortKitSDK.FeedTransitionEvent.Direction, fromFeedItem: ShortKitSDK.FeedItem? = nil, toFeedItem: ShortKitSDK.FeedItem? = nil)
   public static func == (a: ShortKitSDK.FeedTransitionEvent, b: ShortKitSDK.FeedTransitionEvent) -> Swift.Bool
 }
 public struct FormatChangeEvent : Swift.Equatable, Swift.Sendable {
@@ -1191,6 +1208,8 @@ extension ShortKitSDK.SwipeCurve : Swift.RawRepresentable {}
 extension ShortKitSDK.DownloadMode : Swift.Equatable {}
 extension ShortKitSDK.DownloadMode : Swift.Hashable {}
 extension ShortKitSDK.ShortKitFeedView : Swift.Sendable {}
+extension ShortKitSDK.ShortKitFeedLifecycle : Swift.Equatable {}
+extension ShortKitSDK.ShortKitFeedLifecycle : Swift.Hashable {}
 extension ShortKitSDK.CaptionSource : Swift.Equatable {}
 extension ShortKitSDK.CaptionSource : Swift.Hashable {}
 extension ShortKitSDK.CaptionSource : Swift.RawRepresentable {}

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

@@ -10,39 +10,39 @@
 		</data>
 		<key>Info.plist</key>
 		<data>
-		ojzrG3Ap08GJYamHkQPBUeXk/l0=
+		SGnC4k70E9DgpOqahVfG8CzDvZA=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		21myiENnbm60Ispq3tQ5ew19FSk=
+		BO1VUECw+jNellCun0jhxv3t30k=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		zPo7oMw2NLtjLxfYCxXyViI9stM=
+		CBxkj0soc11JQFMNAKh03fEskOQ=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		40YCNN9uv8BRz93OzhGUKoz3RAA=
+		Egfd+TPgbG9XhezyyhpOkJ9bZWs=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		zPo7oMw2NLtjLxfYCxXyViI9stM=
+		CBxkj0soc11JQFMNAKh03fEskOQ=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		21myiENnbm60Ispq3tQ5ew19FSk=
+		BO1VUECw+jNellCun0jhxv3t30k=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		vcLubVZzFhhcaxIe+CkCl0boQWs=
+		KDzWlPhZbTYIibjJVtICWSKv9cs=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		/2fiMms53INV4XQrQbZvM6gqOEg=
+		CbLKbJe6jCpRFjhJ5MJ7F7Um93M=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		vcLubVZzFhhcaxIe+CkCl0boQWs=
+		KDzWlPhZbTYIibjJVtICWSKv9cs=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -66,56 +66,56 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			Dsiu+M+BzZQooc8siWOeQ+tS8azZJ7BfE+71duXglXs=
+			fHbFQio59u+N64dapbLRpLdCd4VatCDVkbn5qTzHCxc=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			FMAJh9SjpqLB6134JfHMNDpUINiMPb9TP4YXvhZEUug=
+			Ct1MN9BrXD/Rkc+lJb6iANMaf9f+RwWB4+pYW/i+3Ek=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			Cw1QZDVkmMiaSLxpl7OxGadGNlHAFn08jn1ClL2XN6s=
+			aLVo05BXMvhibMAdWTtKpK4Ezm91V9IJz/GAm9WDhLw=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			FMAJh9SjpqLB6134JfHMNDpUINiMPb9TP4YXvhZEUug=
+			Ct1MN9BrXD/Rkc+lJb6iANMaf9f+RwWB4+pYW/i+3Ek=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			Dsiu+M+BzZQooc8siWOeQ+tS8azZJ7BfE+71duXglXs=
+			fHbFQio59u+N64dapbLRpLdCd4VatCDVkbn5qTzHCxc=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			2I1oGbLXn9JJAJEdBxgRR/gyfKA2c1l0bFbNOsCRUNY=
+			4rQvWmFNy7cluozJQCGW3y7OdbgvVQco8KNNJ5gFrhc=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			E73Dx8SYkIk9zbpx6V2HLAdRZAIFitk3aKJVzM2p95g=
+			mVc5JWN6Fy34JoJsotmdTST52bcYpwdaOl1WZGL42xs=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			2I1oGbLXn9JJAJEdBxgRR/gyfKA2c1l0bFbNOsCRUNY=
+			4rQvWmFNy7cluozJQCGW3y7OdbgvVQco8KNNJ5gFrhc=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/package.json

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

package/src/ShortKitFeed.tsx

@@ -163,6 +163,11 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     if (onLoop) {
       subscriptions.push(
         NativeShortKitModule.onDidLoop((event) => {
+          // Filter to this feed instance — onDidLoop is fired from the
+          // shared player's global Combine publisher. The native bridge
+          // tags the emit with the active surface's feedId; reject events
+          // that don't match. Accept empty feedId for forward-compat.
+          if (event.feedId !== feedId && event.feedId !== '') return;
           onLoop({ contentId: event.contentId, loopCount: event.loopCount });
         }),
       );
@@ -171,6 +176,16 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     if (onFeedTransition) {
       subscriptions.push(
         NativeShortKitModule.onFeedTransition((event) => {
+          // Filter to this feed instance — `player.feedTransition` is a
+          // singleton publisher on the shared player; the native bridge now
+          // tags the emit with the active surface's feedId. Without this
+          // filter, every <ShortKitFeed> consumer receives every transition,
+          // which caused cross-tab state pollution (e.g., sibling tabs'
+          // onCurrentItemIdChange handlers firing on the active tab's
+          // scroll, leaking that item ID into their own startAtItemId).
+          // Accept empty feedId as a fallback for older native builds that
+          // don't tag the emit yet — same pattern as other callbacks here.
+          if (event.feedId !== feedId && event.feedId !== '') return;
           onFeedTransition({
             phase: event.phase as 'began' | 'ended',
             from: deserializeContentItem(event.fromItem ?? null),
@@ -184,6 +199,10 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     if (onFormatChange) {
       subscriptions.push(
         NativeShortKitModule.onFormatChange((event) => {
+          // Filter to this feed instance — onFormatChange fires from the
+          // shared player's global publisher; bridge tags with active
+          // surface's feedId. Reject events addressed to other feeds.
+          if (event.feedId !== feedId && event.feedId !== '') return;
           onFormatChange({
             contentId: event.contentId,
             fromBitrate: event.fromBitrate,
@@ -198,6 +217,9 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     if (onContentTapped) {
       subscriptions.push(
         NativeShortKitModule.onContentTapped((event) => {
+          // Filter to this feed instance — ShortKitDelegate is a singleton
+          // (bridge); native side tags with active surface's feedId.
+          if (event.feedId !== feedId && event.feedId !== '') return;
           onContentTapped(event.contentId, event.index);
         }),
       );
@@ -229,6 +251,10 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     if (onDidFetchContentItems) {
       subscriptions.push(
         NativeShortKitModule.onDidFetchContentItems((event) => {
+          // Filter to this feed instance — ShortKitDelegate is a singleton
+          // (bridge); native side tags with active surface's feedId (at
+          // delegate call time, before any Task/await suspension).
+          if (event.feedId !== feedId && event.feedId !== '') return;
           try {
             const items = JSON.parse(event.items);
             onDidFetchContentItems(items);
@@ -242,6 +268,11 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     if (onCarouselActiveVideoCompleted) {
       subscriptions.push(
         NativeShortKitModule.onCarouselActiveVideoCompleted((event) => {
+          // Filter to this feed instance — overlay events were previously
+          // unscoped per-feed; native side now tags with active surface's
+          // feedId. surfaceId continues to identify the React overlay host
+          // (separate concern from feedId).
+          if (event.feedId !== feedId && event.feedId !== '') return;
           try {
             onCarouselActiveVideoCompleted({
               surfaceId: event.surfaceId,

package/src/specs/NativeShortKitModule.ts

@@ -56,11 +56,13 @@ type CueEvent = Readonly<{
 }>;
 
 type LoopEvent = Readonly<{
+  feedId: string;
   contentId: string;
   loopCount: Int32;
 }>;
 
 type FeedTransitionEvent = Readonly<{
+  feedId: string;
   phase: string;
   fromItem?: string; // JSON-serialized ContentItem
   toItem?: string; // JSON-serialized ContentItem
@@ -73,6 +75,7 @@ type FeedScrollPhaseEvent = Readonly<{
 }>;
 
 type FormatChangeEvent = Readonly<{
+  feedId: string;
   contentId: string;
   fromBitrate: Double;
   toBitrate: Double;
@@ -103,10 +106,12 @@ type RefreshStateChangedPerFeedEvent = Readonly<{
 }>;
 
 type DidFetchContentItemsEvent = Readonly<{
+  feedId: string;
   items: string; // JSON-serialized ContentItem[]
 }>;
 
 type ContentTappedEvent = Readonly<{
+  feedId: string;
   contentId: string;
   index: Int32;
 }>;
@@ -214,6 +219,7 @@ type VideoCarouselItemChangedEvent = Readonly<{
 }>;
 
 type CarouselActiveVideoCompletedEvent = Readonly<{
+  feedId: string;
   surfaceId: string;
   contentItem: string;          // JSON-serialized ContentItem
   indexInCarousel: Int32;