@shortkitsdk/react-native 0.2.5 → 0.2.11

package/ios/ShortKitBridge.swift

@@ -18,27 +18,78 @@ import ShortKitSDK
     private var cancellables = Set<AnyCancellable>()
     private weak var delegate: ShortKitBridgeDelegateProtocol?
 
+    /// Surface presenter for creating RCTFabricSurface instances in overlay hosts.
+    /// Set from ShortKitModule.mm via setSurfacePresenter: (called by RCTInstance).
+    public var surfacePresenter: AnyObject?
+
+    /// Called from ShortKitModule when RCTInstance provides the surface presenter.
+    @objc public func updateSurfacePresenter(_ presenter: AnyObject?) {
+        self.surfacePresenter = presenter
+    }
+
+    /// Preload handles keyed by UUID, consumed by feed views via preloadId prop.
+    public var preloadHandles: [String: FeedPreload] = [:]
+
+    // MARK: - Feed Instance Registry
+
+    private struct WeakFeedRef {
+        weak var vc: ShortKitFeedViewController?
+    }
+
+    private var feedRegistry: [String: WeakFeedRef] = [:]
+    private var pendingOps: [String: [(ShortKitFeedViewController) -> Void]] = [:]
+
+    public func registerFeed(id: String, viewController vc: ShortKitFeedViewController) {
+        feedRegistry[id] = WeakFeedRef(vc: vc)
+
+        // Wire per-feed remaining content count callback
+        vc.onRemainingContentCountChange = { [weak self] count in
+            self?.emit("onRemainingContentCountChanged", body: [
+                "feedId": id,
+                "count": count
+            ])
+        }
+
+        // Replay buffered operations on the next run-loop tick so the VC's
+        // view hierarchy is fully set up after didMoveToWindow returns.
+        if let ops = pendingOps.removeValue(forKey: id) {
+            DispatchQueue.main.async { [weak vc] in
+                guard let vc = vc else { return }
+                for op in ops {
+                    op(vc)
+                }
+            }
+        }
+    }
+
+    public func unregisterFeed(id: String) {
+        feedRegistry.removeValue(forKey: id)
+        // Note: pendingOps are preserved for this ID to survive detach/reattach cycles
+    }
+
+    private func feedViewController(for id: String) -> ShortKitFeedViewController? {
+        return feedRegistry[id]?.vc
+    }
+
     // MARK: - Init
 
     @objc public init(
         apiKey: String,
-        config configJSON: String,
-        embedId: String?,
+        hasLoadingView: Bool,
         clientAppName: String?,
         clientAppVersion: String?,
         customDimensions customDimensionsJSON: String?,
-        delegate: ShortKitBridgeDelegateProtocol
+        delegate: ShortKitBridgeDelegateProtocol,
+        surfacePresenter: AnyObject?
     ) {
         self.delegate = delegate
+        self.surfacePresenter = surfacePresenter
         super.init()
 
-        let feedConfig = Self.parseFeedConfig(configJSON)
         let dimensions = Self.parseCustomDimensions(customDimensionsJSON)
 
         let sdk = ShortKit(
             apiKey: apiKey,
-            config: feedConfig,
-            embedId: embedId,
             clientAppName: clientAppName,
             clientAppVersion: clientAppVersion,
             customDimensions: dimensions
@@ -47,6 +98,14 @@ import ShortKitSDK
 
         ShortKitBridge.shared = self
 
+        if hasLoadingView {
+            sdk.loadingViewProvider = { [weak self] in
+                let host = ReactLoadingHost()
+                host.surfacePresenter = self?.surfacePresenter
+                return host
+            }
+        }
+
         subscribeToPublishers(sdk.player)
         sdk.delegate = self
     }
@@ -55,6 +114,9 @@ import ShortKitSDK
 
     @objc public func teardown() {
         cancellables.removeAll()
+        preloadHandles.removeAll()
+        feedRegistry.removeAll()
+        pendingOps.removeAll()
         shortKit = nil
         if ShortKitBridge.shared === self {
             ShortKitBridge.shared = nil
@@ -145,24 +207,105 @@ import ShortKitSDK
 
     // MARK: - Custom Feed
 
-    @objc public func setFeedItems(_ json: String) {
-        guard let items = Self.parseCustomFeedItems(json) else { return }
-        Task { @MainActor in
-            self.shortKit?.setFeedItems(items)
+    @objc public func setFeedItems(_ feedId: String, items json: String) {
+        guard let items = Self.parseFeedInputs(json) else { return }
+        DispatchQueue.main.async { [weak self] in
+            guard let self else { return }
+            if let vc = self.feedViewController(for: feedId) {
+                vc.setFeedItems(items)
+            } else {
+                self.pendingOps[feedId, default: []].append { vc in
+                    vc.setFeedItems(items)
+                }
+            }
+        }
+    }
+
+    @objc public func appendFeedItems(_ feedId: String, items json: String) {
+        guard let items = Self.parseFeedInputs(json) else { return }
+        DispatchQueue.main.async { [weak self] in
+            guard let self else { return }
+            if let vc = self.feedViewController(for: feedId) {
+                vc.appendFeedItems(items)
+            } else {
+                self.pendingOps[feedId, default: []].append { vc in
+                    vc.appendFeedItems(items)
+                }
+            }
         }
     }
 
-    @objc public func appendFeedItems(_ json: String) {
-        guard let items = Self.parseCustomFeedItems(json) else { return }
-        Task { @MainActor in
-            self.shortKit?.appendFeedItems(items)
+    // MARK: - Storyboard / Seek Thumbnails
+
+    @objc public func prefetchStoryboard(_ playbackId: String) {
+        Task {
+            _ = await StoryboardProvider.shared.fetch(playbackId: playbackId)
+        }
+    }
+
+    @objc public func getStoryboardData(_ playbackId: String, completion: @escaping (String?) -> Void) {
+        Task {
+            // Try cache first, otherwise fetch
+            let storyboard: CachedStoryboard?
+            if let cached = StoryboardProvider.shared.cached(for: playbackId) {
+                storyboard = cached
+            } else {
+                storyboard = await StoryboardProvider.shared.fetch(playbackId: playbackId)
+            }
+            guard let meta = storyboard?.metadata else {
+                completion(nil)
+                return
+            }
+            // Compute sprite sheet dimensions from tile positions
+            var maxX = 0, maxY = 0
+            for tile in meta.tiles {
+                if tile.x > maxX { maxX = tile.x }
+                if tile.y > maxY { maxY = tile.y }
+            }
+            let imageWidth = maxX + meta.tileWidth
+            let imageHeight = maxY + meta.tileHeight
+            // Build JSON matching the shape the JS side expects
+            var tilesArr: [[String: Any]] = []
+            for tile in meta.tiles {
+                tilesArr.append(["start": tile.start, "x": tile.x, "y": tile.y])
+            }
+            let result: [String: Any] = [
+                "url": meta.url,
+                "tileWidth": meta.tileWidth,
+                "tileHeight": meta.tileHeight,
+                "duration": meta.duration,
+                "imageWidth": imageWidth,
+                "imageHeight": imageHeight,
+                "tiles": tilesArr,
+            ]
+            if let data = try? JSONSerialization.data(withJSONObject: result),
+               let json = String(data: data, encoding: .utf8) {
+                completion(json)
+            } else {
+                completion(nil)
+            }
+        }
+    }
+
+    @objc public func applyFilter(_ feedId: String, filterJSON: String?) {
+        let filter = filterJSON.flatMap { Self.parseFeedFilter($0) }
+        DispatchQueue.main.async { [weak self] in
+            guard let self else { return }
+            if let vc = self.feedViewController(for: feedId) {
+                vc.applyFilter(filter)
+            } else {
+                self.pendingOps[feedId, default: []].append { vc in
+                    vc.applyFilter(filter)
+                }
+            }
         }
     }
 
-    @objc public func fetchContent(_ limit: Int, completion: @escaping (String) -> Void) {
+    @objc public func fetchContent(_ limit: Int, filterJSON: String?, completion: @escaping (String) -> Void) {
+        let filter = filterJSON.flatMap { Self.parseFeedFilter($0) }
         Task {
             do {
-                let items = try await self.shortKit?.fetchContent(limit: limit) ?? []
+                let items = try await self.shortKit?.fetchContent(limit: limit, filter: filter) ?? []
                 let data = try JSONEncoder().encode(items)
                 let json = String(data: data, encoding: .utf8) ?? "[]"
                 completion(json)
@@ -172,6 +315,22 @@ import ShortKitSDK
         }
     }
 
+    @objc public func preloadFeed(_ configJSON: String, completion: @escaping (String) -> Void) {
+        let config = Self.parseFeedConfig(configJSON)
+        guard let preload = shortKit?.preloadFeed(filter: config.filter) else {
+            completion("")
+            return
+        }
+        let uuid = UUID().uuidString
+        preloadHandles[uuid] = preload
+        completion(uuid)
+    }
+
+    /// Consume a preload handle by ID. Returns and removes the handle.
+    public func consumePreload(id: String) -> FeedPreload? {
+        return preloadHandles.removeValue(forKey: id)
+    }
+
     // MARK: - Combine Subscriptions
 
     private func subscribeToPublishers(_ player: ShortKitPlayer) {
@@ -288,6 +447,24 @@ import ShortKitSDK
             }
             .store(in: &cancellables)
 
+        // Feed scroll phase
+        player.feedScrollPhase
+            .receive(on: DispatchQueue.main)
+            .sink { [weak self] phase in
+                switch phase {
+                case .dragging(let fromId):
+                    self?.emit("onFeedScrollPhase", body: [
+                        "phase": "dragging",
+                        "fromId": fromId
+                    ])
+                case .settled:
+                    self?.emit("onFeedScrollPhase", body: [
+                        "phase": "settled"
+                    ])
+                }
+            }
+            .store(in: &cancellables)
+
         // Format change
         player.formatChange
             .receive(on: DispatchQueue.main)
@@ -310,22 +487,16 @@ import ShortKitSDK
             }
             .store(in: &cancellables)
 
-        // Remaining content count
-        player.remainingContentCount
-            .receive(on: DispatchQueue.main)
-            .sink { [weak self] count in
-                self?.emit("onRemainingContentCountChanged", body: ["count": count])
-            }
-            .store(in: &cancellables)
+        // Remaining content count — now handled per-feed via onRemainingContentCountChange callback
     }
 
     // MARK: - Event Emission Helpers
 
-    private func emit(_ name: String, body: [String: Any]) {
+    func emit(_ name: String, body: [String: Any]) {
         delegate?.emitEvent(name, body: body)
     }
 
-    private func emitOnMain(_ name: String, body: [String: Any]) {
+    func emitOnMain(_ name: String, body: [String: Any]) {
         if Thread.isMainThread {
             emit(name, body: body)
         } else {
@@ -335,32 +506,6 @@ import ShortKitSDK
         }
     }
 
-    // MARK: - Overlay Lifecycle Events (called by Fabric view in Task 13)
-
-    /// Emit overlay lifecycle events from the Fabric view's overlay container.
-    public func emitOverlayEvent(_ name: String, item: ContentItem) {
-        emitOnMain(name, body: ["item": serializeContentItemToJSON(item)])
-    }
-
-    /// Emit a raw overlay event with an arbitrary body.
-    public func emitOverlayEvent(_ name: String, body: [String: Any]) {
-        emitOnMain(name, body: body)
-    }
-
-    // MARK: - Carousel Overlay Lifecycle Events
-
-    /// Emit carousel overlay lifecycle events with an ImageCarouselItem.
-    public func emitCarouselOverlayEvent(_ name: String, item: ImageCarouselItem) {
-        guard let data = try? JSONEncoder().encode(item),
-              let json = String(data: data, encoding: .utf8) else { return }
-        emitOnMain(name, body: ["item": json])
-    }
-
-    /// Emit a raw carousel overlay event with an arbitrary body.
-    public func emitCarouselOverlayEvent(_ name: String, body: [String: Any]) {
-        emitOnMain(name, body: body)
-    }
-
     // MARK: - Content Item Serialization
 
     /// Serialize a ContentItem to a JSON string for bridge transport.
@@ -415,6 +560,9 @@ import ShortKitSDK
         if let commentCount = item.commentCount {
             dict["commentCount"] = commentCount
         }
+        if let fallbackUrl = item.fallbackUrl {
+            dict["fallbackUrl"] = fallbackUrl
+        }
 
         return dict
     }
@@ -458,7 +606,7 @@ import ShortKitSDK
     /// {"feedHeight":"{\"type\":\"fullscreen\"}","overlay":"\"none\"",
     ///  "carouselMode":"\"none\"","surveyMode":"\"none\"","muteOnStart":true}
     /// ```
-    private static func parseFeedConfig(_ json: String) -> FeedConfig {
+    public static func parseFeedConfig(_ json: String) -> FeedConfig {
         guard let data = json.data(using: .utf8),
               let obj = try? JSONSerialization.jsonObject(with: data) as? [String: Any] else {
             return FeedConfig()
@@ -466,6 +614,7 @@ import ShortKitSDK
 
         let feedHeight = parseFeedHeight(obj["feedHeight"] as? String)
         let muteOnStart = obj["muteOnStart"] as? Bool ?? true
+        let autoplay = obj["autoplay"] as? Bool ?? true
         let videoOverlay = parseVideoOverlay(obj["overlay"] as? String)
 
         let feedSourceStr = obj["feedSource"] as? String ?? "algorithmic"
@@ -473,6 +622,8 @@ import ShortKitSDK
 
         let carouselOverlay = parseCarouselOverlay(obj["carouselOverlay"] as? String)
 
+        let filter = parseFeedFilter(obj["filter"] as? String)
+
         return FeedConfig(
             feedHeight: feedHeight,
             videoOverlay: videoOverlay,
@@ -480,7 +631,9 @@ import ShortKitSDK
             surveyOverlay: .none,
             adOverlay: .none,
             muteOnStart: muteOnStart,
-            feedSource: feedSource
+            autoplay: autoplay,
+            feedSource: feedSource,
+            filter: filter
         )
     }
 
@@ -488,7 +641,7 @@ import ShortKitSDK
     ///
     /// Examples:
     /// - `"\"none\""` → `.none`
-    /// - `"{\"type\":\"custom\"}"` → `.custom { ShortKitOverlayBridge() }`
+    /// - `"{\"type\":\"custom\"}"` → `.custom { ReactOverlayHost() }`
     private static func parseVideoOverlay(_ json: String?) -> VideoOverlayMode {
         guard let json,
               let data = json.data(using: .utf8),
@@ -505,10 +658,13 @@ import ShortKitSDK
         if let obj = parsed as? [String: Any],
            let type = obj["type"] as? String,
            type == "custom" {
+            let name = obj["name"] as? String ?? "Default"
             return .custom { @Sendable in
-                let overlay = ShortKitOverlayBridge()
-                overlay.bridge = ShortKitBridge.shared
-                return overlay
+                let host = ReactOverlayHost()
+                host.surfacePresenter = ShortKitBridge.shared?.surfacePresenter
+                host.overlayModuleName = "ShortKitOverlay_\(name)"
+                host.bridge = ShortKitBridge.shared
+                return host
             }
         }
 
@@ -519,7 +675,7 @@ import ShortKitSDK
     ///
     /// Examples:
     /// - `"\"none\""` → `.none`
-    /// - `"{\"type\":\"custom\"}"` → `.custom { ShortKitCarouselOverlayBridge() }`
+    /// - `"{\"type\":\"custom\",\"name\":\"news\"}"` → `.custom { ReactCarouselOverlayHost() }`
     private static func parseCarouselOverlay(_ json: String?) -> CarouselOverlayMode {
         guard let json,
               let data = json.data(using: .utf8),
@@ -534,10 +690,16 @@ import ShortKitSDK
         if let obj = parsed as? [String: Any],
            let type = obj["type"] as? String,
            type == "custom" {
+            let name = obj["name"] as? String ?? "Default"
             return .custom { @Sendable in
-                let overlay = ShortKitCarouselOverlayBridge()
-                overlay.bridge = ShortKitBridge.shared
-                return overlay
+                let host = ReactCarouselOverlayHost()
+                host.surfacePresenter = ShortKitBridge.shared?.surfacePresenter
+                host.bridge = ShortKitBridge.shared
+                host.carouselOverlayModuleName = "ShortKitCarouselOverlay_\(name)"
+                // Eagerly create the RN surface so it's mounted and ready before
+                // the cell scrolls into view, matching video overlay behaviour.
+                host.prepareSurface()
+                return host
             }
         }
 
@@ -565,20 +727,38 @@ import ShortKitSDK
         }
     }
 
-    /// Parse a JSON string of CustomFeedItem[] from the JS bridge.
-    private static func parseCustomFeedItems(_ json: String) -> [CustomFeedItem]? {
+    /// Parse a JSON string of FeedFilter from the JS bridge.
+    private 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 {
+            return nil
+        }
+
+        return FeedFilter(
+            tags: obj["tags"] as? [String],
+            section: obj["section"] as? String,
+            author: obj["author"] as? String,
+            contentType: obj["contentType"] as? String,
+            metadata: obj["metadata"] as? [String: String]
+        )
+    }
+
+    /// Parse a JSON string of FeedInput[] from the JS bridge.
+    private static func parseFeedInputs(_ json: String) -> [FeedInput]? {
         guard let data = json.data(using: .utf8),
               let arr = try? JSONSerialization.jsonObject(with: data) as? [[String: Any]] else {
             return nil
         }
 
-        var result: [CustomFeedItem] = []
+        var result: [FeedInput] = []
         for obj in arr {
             guard let type = obj["type"] as? String else { continue }
             switch type {
             case "video":
                 guard let playbackId = obj["playbackId"] as? String else { continue }
-                result.append(.video(playbackId: playbackId))
+                let fallbackUrl = obj["fallbackUrl"] as? String
+                result.append(.video(playbackId: playbackId, fallbackUrl: fallbackUrl))
             case "imageCarousel":
                 guard let itemData = obj["item"],
                       let itemJSON = try? JSONSerialization.data(withJSONObject: itemData),
@@ -613,4 +793,25 @@ extension ShortKitBridge: ShortKitDelegate {
             "index": index
         ])
     }
+
+    public func shortKitDidRequestRefresh(_ shortKit: ShortKit) {
+        emitOnMain("onRefreshRequested", body: [:])
+    }
+
+    public func shortKit(_ shortKit: ShortKit, didFetchContentItems items: [ContentItem]) {
+        Task {
+            let data = try? JSONEncoder().encode(items)
+            let json = data.flatMap { String(data: $0, encoding: .utf8) } ?? "[]"
+            self.emitOnMain("onDidFetchContentItems", body: ["items": json])
+        }
+    }
 }
+
+// MARK: - Dismiss Emission
+
+extension ShortKitBridge {
+    @objc public func emitDismiss() {
+        emitOnMain("onDismiss", body: [:])
+    }
+}
+