@shortkitsdk/react-native 0.2.15 → 0.2.22

package/android/build.gradle.kts

@@ -34,7 +34,7 @@ dependencies {
     // When Reco's settings.gradle has the composite build, Gradle substitutes
     // this with the live source from android_sdk/shortkit automatically.
     // implementation("dev.shortkit:shortkit:0.2.11")
-    implementation(files("/Users/michaelseleman/shortkit/android_sdk/shortkit/build/outputs/aar/shortkit-release.aar"))
+    implementation(files("libs/shortkit-release.aar"))
     // Transitive deps needed when using local AAR (Maven artifact bundles these automatically)
     implementation("androidx.media3:media3-exoplayer:1.5.1")
     implementation("androidx.media3:media3-exoplayer-hls:1.5.1")

package/android/src/main/java/com/shortkit/reactnative/ShortKitBridge.kt

@@ -20,13 +20,13 @@ import com.shortkit.sdk.model.ImageCarouselItem
 import com.shortkit.sdk.model.VideoCarouselItem
 import com.shortkit.sdk.model.JsonValue
 import com.shortkit.sdk.model.PlayerState
+import com.shortkit.sdk.config.SurveyOverlayMode
 import com.shortkit.sdk.config.AdOverlayMode
 import com.shortkit.sdk.config.CarouselOverlayMode
 import com.shortkit.sdk.config.FeedConfig
 import com.shortkit.sdk.config.FeedHeight
 import com.shortkit.sdk.config.FeedSource
 import com.shortkit.sdk.config.ScrollAxis
-import com.shortkit.sdk.config.SurveyOverlayMode
 import com.shortkit.sdk.config.VideoCarouselOverlayMode
 import com.shortkit.sdk.feed.ShortKitRefreshState
 import com.shortkit.sdk.config.VideoOverlayMode
@@ -57,6 +57,7 @@ class ShortKitBridge(
     clientAppName: String?,
     clientAppVersion: String?,
     customDimensionsJSON: String?,
+    debugPanel: Boolean,
     private val emitEvent: (String, WritableMap) -> Unit
 ) {
 
@@ -511,7 +512,8 @@ class ShortKitBridge(
             adProvider = null,
             clientAppName = clientAppName,
             clientAppVersion = clientAppVersion,
-            customDimensions = dims
+            customDimensions = dims,
+            debugPanelEnabled = debugPanel
         )
         this.shortKit = sdk
         shared = this
@@ -883,13 +885,7 @@ class ShortKitBridge(
             callback(uuid)
             return
         }
-        val filterJSON = config.filter?.let { org.json.JSONObject().apply {
-            it.tags?.let { tags -> put("tags", org.json.JSONArray(tags)) }
-            it.section?.let { s -> put("section", s) }
-            it.author?.let { a -> put("author", a) }
-            it.contentType?.let { ct -> put("contentType", ct) }
-        }.toString() }
-        val preload = sdk.preloadFeed(filter = filterJSON)
+        val preload = sdk.preloadFeed(filter = config.filter)
         val uuid = java.util.UUID.randomUUID().toString()
         preloadHandles[uuid] = preload
         callback(uuid)

package/android/src/main/java/com/shortkit/reactnative/ShortKitFeedView.kt

@@ -191,6 +191,14 @@ class ShortKitFeedView(context: Context) : FrameLayout(context) {
 
         val fragment = ShortKitFeedFragment.newInstance(sdk, feedConfig, startAtItemId)
 
+        if (sdk.debugPanelEnabled) {
+            fragment.debugPanelFactory = { active, prev, next, lifecycleOwner ->
+                com.shortkit.sdk.debug.DebugPanelView(context).also { panel ->
+                    panel.subscribe(active, prev, next, lifecycleOwner)
+                }
+            }
+        }
+
         try {
             activity.supportFragmentManager
                 .beginTransaction()

package/android/src/main/java/com/shortkit/reactnative/ShortKitModule.kt

@@ -71,7 +71,8 @@ class ShortKitModule(reactContext: ReactApplicationContext) :
         hasLoadingView: Boolean,
         clientAppName: String?,
         clientAppVersion: String?,
-        customDimensions: String?
+        customDimensions: String?,
+        debugPanel: Boolean?
     ) {
         bridge?.teardown()
         bridge = null
@@ -86,6 +87,7 @@ class ShortKitModule(reactContext: ReactApplicationContext) :
                 clientAppName = clientAppName,
                 clientAppVersion = clientAppVersion,
                 customDimensionsJSON = customDimensions,
+                debugPanel = debugPanel ?: false,
                 emitEvent = { name, body -> sendEvent(name, body) }
             )
 
@@ -258,7 +260,6 @@ class ShortKitModule(reactContext: ReactApplicationContext) :
                 "onFormatChange" -> emitOnFormatChange(params)
                 "onPrefetchedAheadCountChanged" -> emitOnPrefetchedAheadCountChanged(params)
                 "onRemainingContentCountChanged" -> emitOnRemainingContentCountChanged(params)
-                "onSurveyResponse" -> emitOnSurveyResponse(params)
                 "onContentTapped" -> emitOnContentTapped(params)
                 "onDismiss" -> emitOnDismiss(params)
                 "onRefreshStateChanged" -> emitOnRefreshStateChanged(params)

package/android/src/main/java/com/shortkit/reactnative/ShortKitWidgetNativeView.kt

@@ -7,6 +7,7 @@ import com.shortkit.sdk.config.VideoOverlayMode
 import com.shortkit.sdk.config.WidgetConfig
 import com.shortkit.sdk.model.ContentItem
 import com.shortkit.sdk.widget.ShortKitWidgetView
+import com.shortkit.sdk.model.FeedFilter
 import org.json.JSONArray
 import org.json.JSONObject
 
@@ -87,6 +88,9 @@ class ShortKitWidgetNativeView(context: Context) : FrameLayout(context) {
                     else -> PlayerClickAction.FEED
                 },
                 cardOverlay = parseOverlay(obj),
+                filter = obj.optString("filter", "").let { filterStr ->
+                    if (filterStr.isNotEmpty()) ShortKitBridge.parseFeedFilterToModel(filterStr) else null
+                },
             )
         } catch (_: Exception) {
             WidgetConfig()

package/ios/DebugPanelView.swift

@@ -0,0 +1,302 @@
+import UIKit
+import Combine
+import ShortKitSDK
+
+private enum AdjacentSlot {
+    case previous, next
+}
+
+final class DebugPanelView: UIView {
+    static let panelWidth: CGFloat = 310
+    static let panelHeight: CGFloat = 296  // +20 for collapsed header row
+    static let expandedExtraHeight: CGFloat = 80  // 4 labels × ~20pt
+
+    /// Currently selected swipe curve — FeedViewController reads SwipeCurve.selected.
+    static var selectedSwipeCurve: SwipeCurve {
+        get { SwipeCurve.selected }
+        set { SwipeCurve.selected = newValue }
+    }
+
+    private let stackView = UIStackView()
+    private let headerLabel = UILabel()
+    private let curveSegment = UISegmentedControl()
+    private let positionLabel = UILabel()
+    private let intentTtffLabel = UILabel()
+    private let transitionTtffLabel = UILabel()
+    private let prerollBufferLabel = UILabel()
+    private let videoQualityLabel = UILabel()
+    private let thumbnailLabel = UILabel()
+    private let prefetchLabel = UILabel()
+    private let bitrateLabel = UILabel()
+    private let rebufferLabel = UILabel()
+    private let loopWatchLabel = UILabel()
+
+    // Adjacent players section
+    private let adjacentHeader = UILabel()
+    private let prevHeaderLabel = UILabel()
+    private let prevDetailLabel = UILabel()
+    private let nextHeaderLabel = UILabel()
+    private let nextDetailLabel = UILabel()
+    private let separatorView = UIView()
+    private var adjacentLabels: [UIView] = []
+    private var isAdjacentExpanded = false
+    private var prevCancellable: AnyCancellable?
+    private var nextCancellable: AnyCancellable?
+
+    private var cancellable: AnyCancellable?
+    private var dragOffset: CGPoint = .zero
+
+    override init(frame: CGRect) {
+        super.init(frame: frame)
+        setupViews()
+    }
+
+    required init?(coder: NSCoder) {
+        fatalError("init(coder:) has not been implemented")
+    }
+
+    private func setupViews() {
+        backgroundColor = UIColor.black.withAlphaComponent(0.75)
+        layer.cornerRadius = 10
+        clipsToBounds = true
+
+        let pan = UIPanGestureRecognizer(target: self, action: #selector(handlePan(_:)))
+        addGestureRecognizer(pan)
+
+        let labels = [headerLabel, positionLabel, intentTtffLabel, transitionTtffLabel, prerollBufferLabel, videoQualityLabel, thumbnailLabel, prefetchLabel, bitrateLabel, rebufferLabel, loopWatchLabel]
+        for label in labels {
+            label.font = UIFont.monospacedSystemFont(ofSize: 12, weight: .regular)
+            label.textColor = .white
+            label.numberOfLines = 1
+        }
+        headerLabel.font = UIFont.monospacedSystemFont(ofSize: 12, weight: .bold)
+
+        stackView.axis = .vertical
+        stackView.spacing = 4
+        stackView.alignment = .leading
+        stackView.translatesAutoresizingMaskIntoConstraints = false
+        addSubview(stackView)
+
+        for label in labels {
+            stackView.addArrangedSubview(label)
+        }
+
+        // Swipe curve picker
+        for (i, curve) in SwipeCurve.allCases.enumerated() {
+            curveSegment.insertSegment(withTitle: curve.label, at: i, animated: false)
+        }
+        curveSegment.selectedSegmentIndex = SwipeCurve.quarticOut.rawValue
+        curveSegment.setTitleTextAttributes([.foregroundColor: UIColor.white, .font: UIFont.monospacedSystemFont(ofSize: 10, weight: .medium)], for: .normal)
+        curveSegment.setTitleTextAttributes([.foregroundColor: UIColor.black], for: .selected)
+        curveSegment.backgroundColor = UIColor.white.withAlphaComponent(0.15)
+        curveSegment.selectedSegmentTintColor = UIColor.white.withAlphaComponent(0.9)
+        curveSegment.addTarget(self, action: #selector(curveChanged), for: .valueChanged)
+        stackView.addArrangedSubview(curveSegment)
+
+        // Separator
+        separatorView.backgroundColor = UIColor.white.withAlphaComponent(0.3)
+        separatorView.translatesAutoresizingMaskIntoConstraints = false
+        separatorView.heightAnchor.constraint(equalToConstant: 0.5).isActive = true
+        stackView.addArrangedSubview(separatorView)
+
+        // Adjacent header (tap target)
+        adjacentHeader.font = UIFont.monospacedSystemFont(ofSize: 12, weight: .bold)
+        adjacentHeader.textColor = .white
+        adjacentHeader.text = "▶ Adjacent Players"
+        adjacentHeader.isUserInteractionEnabled = true
+        adjacentHeader.addGestureRecognizer(UITapGestureRecognizer(target: self, action: #selector(toggleAdjacent)))
+        stackView.addArrangedSubview(adjacentHeader)
+
+        // Adjacent player labels (initially hidden)
+        let adjLabels = [prevHeaderLabel, prevDetailLabel, nextHeaderLabel, nextDetailLabel]
+        for label in adjLabels {
+            label.font = UIFont.monospacedSystemFont(ofSize: 11, weight: .regular)
+            label.textColor = UIColor.white.withAlphaComponent(0.85)
+            label.numberOfLines = 1
+            label.isHidden = true
+            stackView.addArrangedSubview(label)
+        }
+        adjacentLabels = adjLabels
+
+        prevHeaderLabel.text = "▲ Prev  — not assigned"
+        prevDetailLabel.text = ""
+        nextHeaderLabel.text = "▼ Next  — not assigned"
+        nextDetailLabel.text = ""
+
+        NSLayoutConstraint.activate([
+            stackView.topAnchor.constraint(equalTo: topAnchor, constant: 10),
+            stackView.leadingAnchor.constraint(equalTo: leadingAnchor, constant: 12),
+            stackView.trailingAnchor.constraint(equalTo: trailingAnchor, constant: -12),
+        ])
+
+        // Initial state
+        update(DebugMetrics())
+    }
+
+    @objc private func handlePan(_ gesture: UIPanGestureRecognizer) {
+        guard let parent = superview else { return }
+        switch gesture.state {
+        case .began:
+            dragOffset = gesture.location(in: self)
+        case .changed:
+            let location = gesture.location(in: parent)
+            var newCenter = CGPoint(
+                x: location.x - dragOffset.x + bounds.width / 2,
+                y: location.y - dragOffset.y + bounds.height / 2
+            )
+            // Keep panel within parent bounds
+            let hw = bounds.width / 2, hh = bounds.height / 2
+            newCenter.x = max(hw, min(parent.bounds.width - hw, newCenter.x))
+            newCenter.y = max(hh, min(parent.bounds.height - hh, newCenter.y))
+            center = newCenter
+        default:
+            break
+        }
+    }
+
+    @objc private func curveChanged(_ sender: UISegmentedControl) {
+        guard let curve = SwipeCurve(rawValue: sender.selectedSegmentIndex) else { return }
+        Self.selectedSwipeCurve = curve
+    }
+
+    @objc private func toggleAdjacent() {
+        isAdjacentExpanded.toggle()
+        adjacentHeader.text = isAdjacentExpanded ? "▼ Adjacent Players" : "▶ Adjacent Players"
+
+        UIView.animate(withDuration: 0.25) {
+            for label in self.adjacentLabels {
+                label.isHidden = !self.isAdjacentExpanded
+                label.alpha = self.isAdjacentExpanded ? 1 : 0
+            }
+            // Resize panel
+            var newFrame = self.frame
+            let baseHeight = Self.panelHeight
+            newFrame.size.height = self.isAdjacentExpanded
+                ? baseHeight + Self.expandedExtraHeight
+                : baseHeight
+            self.frame = newFrame
+            self.layoutIfNeeded()
+        }
+    }
+
+    func subscribe(to subject: CurrentValueSubject<DebugMetrics, Never>) {
+        cancellable = subject
+            .receive(on: DispatchQueue.main)
+            .sink { [weak self] metrics in
+                self?.update(metrics)
+            }
+    }
+
+    func subscribeAdjacent(
+        prev: CurrentValueSubject<DebugMetrics, Never>,
+        next: CurrentValueSubject<DebugMetrics, Never>
+    ) {
+        prevCancellable = prev
+            .receive(on: DispatchQueue.main)
+            .sink { [weak self] metrics in
+                self?.updateAdjacent(metrics, slot: .previous)
+            }
+        nextCancellable = next
+            .receive(on: DispatchQueue.main)
+            .sink { [weak self] metrics in
+                self?.updateAdjacent(metrics, slot: .next)
+            }
+    }
+
+    private func updateAdjacent(_ m: DebugMetrics, slot: AdjacentSlot) {
+        let headerLabel = slot == .previous ? prevHeaderLabel : nextHeaderLabel
+        let detailLabel = slot == .previous ? prevDetailLabel : nextDetailLabel
+        let arrow = slot == .previous ? "▲ Prev" : "▼ Next"
+
+        guard m.contentId != nil else {
+            headerLabel.text = "\(arrow)  — not assigned"
+            detailLabel.text = ""
+            return
+        }
+
+        let id = m.contentId.map { String($0.prefix(8)) } ?? "—"
+        let stateIcon: String
+        switch m.playerState {
+        case .playing: stateIcon = "▶"
+        case .paused: stateIcon = "⏸"
+        case .buffering: stateIcon = "⏳"
+        default: stateIcon = "○"
+        }
+        headerLabel.text = "\(arrow)  #\(m.feedIndex) \(id)  \(stateIcon) \(m.playerState)"
+
+        let buf = String(format: "%.1f", m.bufferAhead)
+        let preroll = m.prerollCompleted ? "✓" : "✗"
+        let mbps = m.observedBitrateBps / 1_000_000
+        var detail = "  buf: \(buf)s  preroll: \(preroll)"
+        if mbps > 0 {
+            detail += String(format: "  %.1f Mbps", mbps)
+        }
+        if m.videoWidth > 0 {
+            let codec = m.codec ?? ""
+            detail += "  \(m.videoWidth)×\(m.videoHeight) \(codec)"
+        }
+        detailLabel.text = detail
+    }
+
+    private func update(_ m: DebugMetrics) {
+        let id = m.contentId.map { String($0.prefix(8)) } ?? "—"
+        let stateIcon: String
+        switch m.playerState {
+        case .playing: stateIcon = "▶"
+        case .paused: stateIcon = "⏸"
+        case .buffering: stateIcon = "⏳"
+        case .seeking: stateIcon = "⏩"
+        case .error: stateIcon = "⚠️"
+        default: stateIcon = "○"
+        }
+        headerLabel.text = "#\(m.feedIndex)  \(id)  \(stateIcon) \(m.playerState)"
+
+        let cur = String(format: "%.1f", m.currentTime)
+        let dur = String(format: "%.1f", m.duration)
+        positionLabel.text = "Position: \(cur)s / \(dur)s"
+
+        if let intent = m.intentToFrameMs {
+            intentTtffLabel.text = "Intent:     \(intent)ms"
+        } else {
+            intentTtffLabel.text = "Intent:     N/A"
+        }
+
+        if let transition = m.transitionToFrameMs {
+            let net = m.networkMs.map { "\($0)" } ?? "?"
+            let dec = m.decodeMs.map { "\($0)" } ?? "?"
+            transitionTtffLabel.text = "Transition:  \(transition)ms  (net: \(net) + dec: \(dec))"
+        } else {
+            transitionTtffLabel.text = "Transition:  measuring..."
+        }
+
+        let preroll = m.prerollCompleted ? "✓" : "✗"
+        let buffer = String(format: "%.1f", m.bufferAhead)
+        prerollBufferLabel.text = "Preroll: \(preroll)    Buffer: \(buffer)s"
+
+        let codec = m.codec ?? "—"
+        if m.videoWidth > 0 {
+            videoQualityLabel.text = "Video: \(m.videoWidth)×\(m.videoHeight)  \(codec)"
+        } else {
+            videoQualityLabel.text = "Video: —"
+        }
+
+        thumbnailLabel.text = "Thumbnail: \(m.thumbnailVisible ? "visible" : "removed")"
+        prefetchLabel.text = "Prefetch: \(m.thumbsCachedAhead)/\(m.metadataAhead) thumbs  \(m.metadataAhead) meta"
+
+        let obsMbps = m.observedBitrateBps / 1_000_000
+        let indMbps = m.indicatedBitrateBps / 1_000_000
+        if obsMbps > 0 {
+            bitrateLabel.text = String(format: "Bitrate: %.1f Mbps (ind: %.1f)", obsMbps, indMbps)
+        } else {
+            bitrateLabel.text = "Bitrate: —"
+        }
+
+        if let lastMs = m.lastRebufferDurationMs {
+            rebufferLabel.text = "Rebuffers: \(m.rebufferCount)  (last: \(lastMs)ms)"
+        } else {
+            rebufferLabel.text = "Rebuffers: \(m.rebufferCount)"
+        }
+
+        loopWatchLabel.text = "Loops: \(m.loopCount)"
+    }
+}

package/ios/ShortKitBridge.swift

@@ -97,6 +97,7 @@ import ShortKitSDK
         clientAppName: String?,
         clientAppVersion: String?,
         customDimensions customDimensionsJSON: String?,
+        debugPanel: Bool,
         delegate: ShortKitBridgeDelegateProtocol,
         surfacePresenter: AnyObject?
     ) {
@@ -110,7 +111,8 @@ import ShortKitSDK
             apiKey: apiKey,
             clientAppName: clientAppName,
             clientAppVersion: clientAppVersion,
-            customDimensions: dimensions
+            customDimensions: dimensions,
+            debugPanelEnabled: debugPanel
         )
         self.shortKit = sdk
 
@@ -676,7 +678,7 @@ import ShortKitSDK
     /// Expected JSON structure:
     /// ```json
     /// {"feedHeight":"{\"type\":\"fullscreen\"}","overlay":"\"none\"",
-    ///  "carouselMode":"\"none\"","surveyMode":"\"none\"","muteOnStart":true}
+    ///  "carouselMode":"\"none\"","muteOnStart":true}
     /// ```
     public static func parseFeedConfig(_ json: String) -> FeedConfig {
         guard let data = json.data(using: .utf8),
@@ -842,7 +844,7 @@ import ShortKitSDK
     }
 
     /// Parse a JSON string of FeedFilter from the JS bridge.
-    private static func parseFeedFilter(_ json: String?) -> FeedFilter? {
+    static func parseFeedFilter(_ json: String?) -> FeedFilter? {
         guard let json,
               let data = json.data(using: .utf8),
               let obj = try? JSONSerialization.jsonObject(with: data) as? [String: Any] else {

package/ios/ShortKitFeedView.swift

@@ -104,6 +104,21 @@ import ShortKitSDK
         let feedVC = ShortKitFeedViewController(shortKit: sdk, config: feedConfig, startAtItemId: startAtItemId)
         feedVC.setBridgeManaged()
 
+        if sdk.debugPanelEnabled {
+            feedVC.debugPanelFactory = { active, prev, next in
+                let panel = DebugPanelView(frame: CGRect(
+                    x: 0, y: 0,
+                    width: DebugPanelView.panelWidth,
+                    height: DebugPanelView.panelHeight
+                ))
+                panel.center = CGPoint(x: UIScreen.main.bounds.width / 2,
+                                       y: UIScreen.main.bounds.height / 2)
+                panel.subscribe(to: active)
+                panel.subscribeAdjacent(prev: prev, next: next)
+                return panel
+            }
+        }
+
         NSLog("[ShortKit FeedView] VC created successfully (bridge-managed)")
 
         feedVC.onDismiss = {

package/ios/ShortKitModule.mm

@@ -68,7 +68,6 @@ RCT_EXPORT_MODULE(ShortKitModule)
     @"onFormatChange",
     @"onPrefetchedAheadCountChanged",
     @"onRemainingContentCountChanged",
-    @"onSurveyResponse",
     @"onContentTapped",
     @"onDismiss",
     @"onFeedReady",
@@ -124,7 +123,8 @@ RCT_EXPORT_METHOD(initialize:(NSString *)apiKey
                   hasLoadingView:(BOOL)hasLoadingView
                   clientAppName:(NSString *)clientAppName
                   clientAppVersion:(NSString *)clientAppVersion
-                  customDimensions:(NSString *)customDimensions) {
+                  customDimensions:(NSString *)customDimensions
+                  debugPanel:(BOOL)debugPanel) {
   // Tear down any existing instance to prevent leaks on re-initialize
   [_shortKitBridge teardown];
 
@@ -133,6 +133,7 @@ RCT_EXPORT_METHOD(initialize:(NSString *)apiKey
                                             clientAppName:clientAppName
                                          clientAppVersion:clientAppVersion
                                          customDimensions:customDimensions
+                                               debugPanel:debugPanel
                                                  delegate:self
                                          surfacePresenter:_surfacePresenter];
 

package/ios/ShortKitSDK.xcframework/ios-arm64/ShortKitSDK.framework/Info.plist

@@ -11,9 +11,9 @@
     <key>CFBundlePackageType</key>
     <string>FMWK</string>
     <key>CFBundleVersion</key>
-    <string>0.2.15</string>
+    <string>0.2.22</string>
     <key>CFBundleShortVersionString</key>
-    <string>0.2.15</string>
+    <string>0.2.22</string>
     <key>MinimumOSVersion</key>
     <string>16.0</string>
 </dict>