@shortkitsdk/react-native 0.2.28 → 0.2.30

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 {
@@ -1084,7 +1101,7 @@ final public class ShortKit {
   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)
+  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, serverTracingEnabled: Swift.Bool = false, consoleTracingEnabled: 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]
@@ -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 {
@@ -1084,7 +1101,7 @@ final public class ShortKit {
   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)
+  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, serverTracingEnabled: Swift.Bool = false, consoleTracingEnabled: 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]
@@ -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=
+		TqCi7bLe/rBk0vusKYg3QCnChjw=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		21myiENnbm60Ispq3tQ5ew19FSk=
+		T24MZRAcHfhIQj9rhCKZ74+fGDk=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		zPo7oMw2NLtjLxfYCxXyViI9stM=
+		/tzpn54Ir12p9mlqhhATlo1kMxk=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		40YCNN9uv8BRz93OzhGUKoz3RAA=
+		jfLbEEzmKUw8NgxsDqMv/TI2UHA=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		zPo7oMw2NLtjLxfYCxXyViI9stM=
+		/tzpn54Ir12p9mlqhhATlo1kMxk=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		21myiENnbm60Ispq3tQ5ew19FSk=
+		T24MZRAcHfhIQj9rhCKZ74+fGDk=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		vcLubVZzFhhcaxIe+CkCl0boQWs=
+		gMhrjSn1Z4igYb3yHfulqLRscLs=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		/2fiMms53INV4XQrQbZvM6gqOEg=
+		feB3WtzjYFsaMexcqDUc4JGDFrg=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		vcLubVZzFhhcaxIe+CkCl0boQWs=
+		gMhrjSn1Z4igYb3yHfulqLRscLs=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -66,56 +66,56 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			Dsiu+M+BzZQooc8siWOeQ+tS8azZJ7BfE+71duXglXs=
+			uLq+hg2h3SAN1deJqLUnULXrfFwB26PttLnWxmx/cGo=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			FMAJh9SjpqLB6134JfHMNDpUINiMPb9TP4YXvhZEUug=
+			qlEsU4N2hUtQ04us8hP20iPW8Tx3msprPs+sZvdIxQ8=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			Cw1QZDVkmMiaSLxpl7OxGadGNlHAFn08jn1ClL2XN6s=
+			joqbkrgKjhuksU/+u2V6/QkIEKWcA9LxrnASAJZTWsg=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			FMAJh9SjpqLB6134JfHMNDpUINiMPb9TP4YXvhZEUug=
+			qlEsU4N2hUtQ04us8hP20iPW8Tx3msprPs+sZvdIxQ8=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			Dsiu+M+BzZQooc8siWOeQ+tS8azZJ7BfE+71duXglXs=
+			uLq+hg2h3SAN1deJqLUnULXrfFwB26PttLnWxmx/cGo=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			2I1oGbLXn9JJAJEdBxgRR/gyfKA2c1l0bFbNOsCRUNY=
+			zJA0JThfoDRwFu0/9WzU1O+cmdnkZ3kcOlW0aju3B+k=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			E73Dx8SYkIk9zbpx6V2HLAdRZAIFitk3aKJVzM2p95g=
+			ct73W591fp7iumAnIzZPaew7KMArg2zicdfZ4PMWPr8=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			2I1oGbLXn9JJAJEdBxgRR/gyfKA2c1l0bFbNOsCRUNY=
+			zJA0JThfoDRwFu0/9WzU1O+cmdnkZ3kcOlW0aju3B+k=
 			</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.30",
   "description": "ShortKit React Native SDK — short-form video feed",
   "react-native": "src/index",
   "source": "src/index",

package/src/ShortKitFeed.tsx

@@ -47,6 +47,7 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
     onFeedReady,
     onCarouselActiveVideoCompleted,
     onVideoCarouselCellTap,
+    debugPanel,
   } = props;
 
   const isInitialized = useContext(ShortKitInitContext);
@@ -163,6 +164,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 +177,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 +200,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 +218,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 +252,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 +269,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,
@@ -288,6 +320,7 @@ export const ShortKitFeed = forwardRef<ShortKitFeedHandle, ShortKitFeedProps>(
         seedThumbnailUrl={seedThumbnailUrl}
         feedItemsJSON={feedItemsJSON}
         active={active}
+        debugPanel={debugPanel}
       />
     </View>
   );

package/src/ShortKitProvider.tsx

@@ -135,6 +135,8 @@ export function ShortKitProvider({
   customDimensions,
   loadingViewComponent,
   debugPanel,
+  serverTracingEnabled,
+  consoleTracingEnabled,
   children,
 }: ShortKitProviderProps): React.JSX.Element {
   const [state, dispatch] = useReducer(reducer, initialState);
@@ -161,6 +163,8 @@ export function ShortKitProvider({
       clientAppVersion,
       serializedDimensions,
       debugPanel ?? false,
+      serverTracingEnabled ?? false,
+      consoleTracingEnabled ?? false,
     );
 
     return () => {

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;
@@ -254,6 +260,8 @@ export interface Spec extends TurboModule {
     clientAppVersion?: string,
     customDimensions?: string, // JSON-serialized Record<string, string>
     debugPanel?: boolean,
+    serverTracingEnabled?: boolean,
+    consoleTracingEnabled?: boolean,
   ): void;
   setUserId(userId: string): void;
   clearUserId(): void;

package/src/specs/ShortKitFeedViewNativeComponent.ts

@@ -17,6 +17,11 @@ export interface NativeProps extends ViewProps {
   /** JSON-serialized FeedInput[] for initial custom-feed items at mount time. */
   feedItemsJSON?: string;
   active?: boolean;
+  /**
+   * Per-surface debug panel override. When unset, the provider-level
+   * `debugPanel` flag governs. When set, overrides for this feed instance.
+   */
+  debugPanel?: boolean;
 }
 
 export default codegenNativeComponent<NativeProps>(

package/src/types.ts

@@ -293,6 +293,10 @@ export interface ShortKitProviderProps {
   loadingViewComponent?: React.ComponentType<{}>;
   /** Enable the debug panel overlay (shake device to toggle). Defaults to false. */
   debugPanel?: boolean;
+  /** Enable production trace logging to the ShortKit backend. Defaults to false. */
+  serverTracingEnabled?: boolean;
+  /** Enable [SKTrace] console output. For development only — defaults to false. */
+  consoleTracingEnabled?: boolean;
 }
 
 // --- Feed Component Props ---
@@ -342,6 +346,12 @@ export interface ShortKitFeedProps {
    * @default true
    */
   active?: boolean;
+  /**
+   * Enable the debug panel overlay on this specific feed surface (shake
+   * device to toggle). When omitted, falls back to the provider-level
+   * `debugPanel` flag on `<ShortKitProvider>`.
+   */
+  debugPanel?: boolean;
   onLoop?: (event: LoopEvent) => void;
   onFeedTransition?: (event: FeedTransitionEvent) => void;
   onFormatChange?: (event: FormatChangeEvent) => void;