@shortkitsdk/react-native 0.2.29 → 0.2.31

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;
@@ -474,6 +484,17 @@ export interface ShortKitWidgetProps {
    * how `<ShortKitFeed feedItems={...} />` works.
    */
   items?: WidgetInput[];
+  /**
+   * Per-card tap callback. When set, the SDK skips the built-in
+   * `clickAction: 'feed'` modal-presentation path and hands the tap to the
+   * host — typically used to push a feed screen via the host's navigator
+   * instead of letting the SDK present a UIKit modal that escapes the host's
+   * navigation hierarchy.
+   *
+   * Mirrors `ShortKitPlayer.onTap`. `clickAction: 'mute'` continues to work
+   * regardless (per-cell mute toggle runs alongside `onCardTap`).
+   */
+  onCardTap?: (playbackId: string, index: number) => void;
   style?: ViewStyle;
 }
 

package/ios/DebugPanelView.swift

@@ -1,302 +0,0 @@
-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)"
-    }
-}