@shortkitsdk/react-native 0.2.34 → 0.2.36

package/src/types.ts

@@ -32,6 +32,11 @@ export interface FeedConfig {
   autoplay?: boolean;
   filter?: FeedFilter;
   pullToRefreshEnabled?: boolean;
+  /** Called when the modal feed presented from `<ShortKitWidget>` /
+   *  `<ShortKitPlayer>` fetches content items. Use to pre-fetch your own
+   *  metadata for the items shown in the modal. Mirrors the same callback
+   *  on `<ShortKitFeed>` props. */
+  onDidFetchContentItems?: (items: ContentItem[]) => void;
 }
 
 export type FeedHeight =
@@ -139,6 +144,12 @@ export interface ImageCarouselItem {
 export interface VideoCarouselItem {
   id: string;
   videos: ContentItem[];
+  /**
+   * Zero-based index of the page the carousel landed on. Mirrors
+   * `VideoCarouselInput.initialPageIndex` from the host's input. Available
+   * to overlay components for reading the active page on first paint.
+   */
+  initialPageIndex?: number;
   title?: string;
   description?: string;
   author?: string;
@@ -170,6 +181,18 @@ export interface VideoCarouselVideoInput {
 export interface VideoCarouselInput {
   id: string;
   videos: VideoCarouselVideoInput[];
+  /**
+   * Zero-based index of the page the carousel should land on the first time
+   * it becomes visible (vertical-arrival or initial mount). Defaults to 0.
+   * Out-of-range values are clamped to a valid index.
+   *
+   * **Has no effect after the carousel is first configured.** To move the
+   * user imperatively after landing, use
+   * `useShortKitCarousel().setActiveIndex(n)`. Re-rendering with a new
+   * `initialPageIndex` on the same `id` is ignored — change the `id` to force
+   * a re-bind if you genuinely want to land on a different page.
+   */
+  initialPageIndex?: number;
   title?: string;
   description?: string;
   author?: string;
@@ -421,6 +444,23 @@ export interface ShortKitFeedProps {
     index: number;
     pageIndex: number;
   }) => void;
+  /**
+   * Fires for the lifecycle of a video-carousel cell long-press: `began`
+   * after a short native press delay, `ended` on touch release, and
+   * `cancelled` on user finger movement past ~10pt or when the cell is
+   * recycled (e.g. by `setFeedItems`).
+   *
+   * The recognizer runs simultaneously with the carousel's horizontal pan
+   * and the feed's vertical pan — it does not block scrolling. The intended
+   * use case is Instagram-style hold-to-pause: pause playback and hide
+   * overlay chrome on `began`, restore them on `ended` / `cancelled`.
+   */
+  onVideoCarouselCellLongPress?: (event: {
+    id: string;
+    index: number;
+    pageIndex: number;
+    state: 'began' | 'ended' | 'cancelled';
+  }) => void;
 }
 
 /**

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

@@ -1,149 +0,0 @@
-package com.shortkit.reactnative
-
-import android.content.Context
-import android.view.MotionEvent
-import android.widget.FrameLayout
-import com.shortkit.sdk.config.PlayerClickAction
-import com.shortkit.sdk.config.FeedConfig
-import com.shortkit.sdk.config.PlayerConfig
-import com.shortkit.sdk.config.VideoOverlayMode
-import com.shortkit.sdk.model.ContentItem
-import com.shortkit.sdk.player.ShortKitPlayerView
-import org.json.JSONObject
-
-/**
- * Fabric native view wrapping [ShortKitPlayerView] for use as a
- * single-video player in React Native.
- */
-class ShortKitPlayerNativeView(context: Context) : FrameLayout(context) {
-
-    private var playerView: ShortKitPlayerView? = null
-    private var configJson: String? = null
-    private var contentItemJson: String? = null
-
-    var config: String?
-        get() = configJson
-        set(value) {
-            if (value == configJson) return
-            configJson = value
-            rebuildIfNeeded()
-        }
-
-    var contentItem: String?
-        get() = contentItemJson
-        set(value) {
-            if (value == contentItemJson) return
-            contentItemJson = value
-            applyContentItem()
-        }
-
-    var active: Boolean = true
-        set(value) {
-            if (field == value) return
-            field = value
-            applyActive()
-        }
-
-    override fun onInterceptTouchEvent(ev: MotionEvent): Boolean {
-        return super.onInterceptTouchEvent(ev)
-    }
-
-    override fun dispatchTouchEvent(ev: MotionEvent): Boolean {
-        return super.dispatchTouchEvent(ev)
-    }
-
-    override fun onAttachedToWindow() {
-        super.onAttachedToWindow()
-        rebuildIfNeeded()
-    }
-
-    override fun onDetachedFromWindow() {
-        playerView?.deactivate()
-        super.onDetachedFromWindow()
-    }
-
-    private fun rebuildIfNeeded() {
-        if (playerView != null) return
-
-        val sdk = ShortKitBridge.shared?.sdk ?: return
-        val playerConfig = parsePlayerConfig(configJson)
-
-        val view = ShortKitPlayerView(context).apply {
-            layoutParams = LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT)
-        }
-        view.initialize(sdk, playerConfig)
-        addView(view)
-        playerView = view
-
-        applyContentItem()
-        if (active) view.activate()
-    }
-
-    private fun applyContentItem() {
-        val json = contentItemJson ?: return
-        val view = playerView ?: return
-        val item = parseContentItem(json) ?: return
-        view.configure(item)
-    }
-
-    private fun applyActive() {
-        val view = playerView ?: return
-        if (active) view.activate() else view.deactivate()
-    }
-
-    private fun parsePlayerConfig(json: String?): PlayerConfig {
-        if (json.isNullOrEmpty()) return PlayerConfig()
-        return try {
-            val obj = JSONObject(json)
-            PlayerConfig(
-                cornerRadius = obj.optDouble("cornerRadius", 12.0).toFloat(),
-                clickAction = when (obj.optString("clickAction", "feed")) {
-                    "feed" -> PlayerClickAction.FEED
-                    "mute" -> PlayerClickAction.MUTE
-                    "none" -> PlayerClickAction.NONE
-                    else -> PlayerClickAction.FEED
-                },
-                autoplay = obj.optBoolean("autoplay", true),
-                loop = obj.optBoolean("loop", true),
-                muteOnStart = obj.optBoolean("muteOnStart", true),
-                videoOverlay = parseOverlay(obj),
-                feedConfig = obj.optString("feedConfig", "").let { fcStr ->
-                    if (fcStr.isNotEmpty()) ShortKitBridge.parseFeedConfig(fcStr, context) else FeedConfig()
-                },
-            )
-        } catch (_: Exception) {
-            PlayerConfig()
-        }
-    }
-
-    private fun parseOverlay(obj: JSONObject): VideoOverlayMode {
-        val overlay = obj.opt("overlay") ?: return VideoOverlayMode.None
-        if (overlay is JSONObject && overlay.optString("type") == "custom") {
-            return VideoOverlayMode.Custom {
-                ReactOverlayHost(context)
-            }
-        }
-        return VideoOverlayMode.None
-    }
-
-    private fun parseContentItem(json: String): ContentItem? {
-        return try {
-            val obj = JSONObject(json)
-            ContentItem(
-                id = obj.getString("id"),
-                title = obj.getString("title"),
-                description = obj.optString("description", null),
-                duration = obj.getDouble("duration"),
-                streamingUrl = obj.getString("streamingUrl"),
-                thumbnailUrl = obj.getString("thumbnailUrl"),
-                captionTracks = emptyList(),
-                customMetadata = null,
-                author = obj.optString("author", null),
-                articleUrl = obj.optString("articleUrl", null),
-                commentCount = if (obj.has("commentCount")) obj.getInt("commentCount") else null,
-            )
-        } catch (_: Exception) {
-            null
-        }
-    }
-}

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

@@ -1,35 +0,0 @@
-package com.shortkit.reactnative
-
-import com.facebook.react.module.annotations.ReactModule
-import com.facebook.react.uimanager.SimpleViewManager
-import com.facebook.react.uimanager.ThemedReactContext
-import com.facebook.react.uimanager.annotations.ReactProp
-
-@ReactModule(name = ShortKitPlayerViewManager.REACT_CLASS)
-class ShortKitPlayerViewManager : SimpleViewManager<ShortKitPlayerNativeView>() {
-
-    override fun getName(): String = REACT_CLASS
-
-    override fun createViewInstance(context: ThemedReactContext): ShortKitPlayerNativeView {
-        return ShortKitPlayerNativeView(context)
-    }
-
-    @ReactProp(name = "config")
-    fun setConfig(view: ShortKitPlayerNativeView, config: String?) {
-        view.config = config
-    }
-
-    @ReactProp(name = "contentItem")
-    fun setContentItem(view: ShortKitPlayerNativeView, contentItem: String?) {
-        view.contentItem = contentItem
-    }
-
-    @ReactProp(name = "active", defaultBoolean = true)
-    fun setActive(view: ShortKitPlayerNativeView, active: Boolean) {
-        view.active = active
-    }
-
-    companion object {
-        const val REACT_CLASS = "ShortKitPlayerView"
-    }
-}

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

@@ -1,149 +0,0 @@
-package com.shortkit.reactnative
-
-import android.content.Context
-import android.widget.FrameLayout
-import com.shortkit.sdk.config.PlayerClickAction
-import com.shortkit.sdk.config.VideoOverlayMode
-import com.shortkit.sdk.config.WidgetConfig
-import com.shortkit.sdk.widget.ShortKitWidgetView
-import com.shortkit.sdk.config.FeedConfig
-import com.shortkit.sdk.model.FeedFilter
-import com.shortkit.sdk.model.WidgetInput
-import org.json.JSONArray
-import org.json.JSONObject
-
-/**
- * Fabric native view wrapping [ShortKitWidgetView] for use as a
- * horizontal video carousel in React Native.
- *
- * Props:
- *  - `config`: JSON string with WidgetConfig values
- *  - `items`: JSON string with WidgetInput array (compact playback-ID form)
- */
-class ShortKitWidgetNativeView(context: Context) : FrameLayout(context) {
-
-    private var widgetView: ShortKitWidgetView? = null
-    private var configJson: String? = null
-    private var itemsJson: String? = null
-    private var parsedConfig: WidgetConfig = WidgetConfig()
-    private var parsedItems: List<WidgetInput> = emptyList()
-
-    var config: String?
-        get() = configJson
-        set(value) {
-            if (value == configJson) return
-            configJson = value
-            parsedConfig = parseWidgetConfig(value)
-            // If widget is already built, rebuild to pick up new config.
-            if (widgetView != null) {
-                removeWidget()
-                embedWidgetIfNeeded()
-            }
-        }
-
-    var items: String?
-        get() = itemsJson
-        set(value) {
-            if (value == itemsJson) return
-            itemsJson = value
-            parsedItems = parseWidgetInputs(value) ?: emptyList()
-            // Post-mount update on an existing widget.
-            widgetView?.configure(parsedItems)
-        }
-
-    override fun onAttachedToWindow() {
-        super.onAttachedToWindow()
-        embedWidgetIfNeeded()
-    }
-
-    override fun onDetachedFromWindow() {
-        super.onDetachedFromWindow()
-        removeWidget()
-    }
-
-    private fun embedWidgetIfNeeded() {
-        if (widgetView != null) return
-        val sdk = ShortKitBridge.shared?.sdk ?: return
-
-        // Pass items at initialize time so the widget never races the server
-        // fetch — analogous to the feed's `feedItems` prop wiring.
-        val view = ShortKitWidgetView(context).apply {
-            layoutParams = LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT)
-        }
-        view.initialize(sdk, parsedConfig, parsedItems)
-        addView(view)
-        widgetView = view
-    }
-
-    private fun removeWidget() {
-        widgetView?.let { removeView(it) }
-        widgetView = null
-    }
-
-    private fun parseWidgetConfig(json: String?): WidgetConfig {
-        if (json.isNullOrEmpty()) return WidgetConfig()
-        return try {
-            val obj = JSONObject(json)
-            WidgetConfig(
-                cardCount = obj.optInt("cardCount", 3),
-                cardSpacing = obj.optDouble("cardSpacing", 8.0).toFloat(),
-                cornerRadius = obj.optDouble("cornerRadius", 12.0).toFloat(),
-                autoplay = obj.optBoolean("autoplay", true),
-                muteOnStart = obj.optBoolean("muteOnStart", true),
-                loop = obj.optBoolean("loop", true),
-                rotationInterval = obj.optLong("rotationInterval", 10_000L),
-                clickAction = when (obj.optString("clickAction", "feed")) {
-                    "feed" -> PlayerClickAction.FEED
-                    "mute" -> PlayerClickAction.MUTE
-                    "none" -> PlayerClickAction.NONE
-                    else -> PlayerClickAction.FEED
-                },
-                cardOverlay = parseOverlay(obj),
-                filter = obj.optString("filter", "").let { filterStr ->
-                    if (filterStr.isNotEmpty()) ShortKitBridge.parseFeedFilterToModel(filterStr) else null
-                },
-                feedConfig = obj.optString("feedConfig", "").let { fcStr ->
-                    if (fcStr.isNotEmpty()) ShortKitBridge.parseFeedConfig(fcStr, context) else FeedConfig()
-                },
-            )
-        } catch (_: Exception) {
-            WidgetConfig()
-        }
-    }
-
-    private fun parseOverlay(obj: JSONObject): VideoOverlayMode {
-        val overlay = obj.opt("overlay") ?: return VideoOverlayMode.None
-        if (overlay is JSONObject && overlay.optString("type") == "custom") {
-            return VideoOverlayMode.Custom {
-                ReactOverlayHost(context)
-            }
-        }
-        return VideoOverlayMode.None
-    }
-
-    /**
-     * Parse a JSON array of `WidgetInput` values (compact playback-ID form).
-     * Mirrors the JS `WidgetInput` type:
-     *   `{ type: 'video'; playbackId: string; fallbackUrl?: string }`.
-     */
-    private fun parseWidgetInputs(json: String?): List<WidgetInput>? {
-        if (json.isNullOrEmpty()) return null
-        return try {
-            val arr = JSONArray(json)
-            val out = mutableListOf<WidgetInput>()
-            for (i in 0 until arr.length()) {
-                val obj = arr.getJSONObject(i)
-                if (obj.optString("type") != "video") continue
-                val playbackId = obj.optString("playbackId", "")
-                if (playbackId.isEmpty()) continue
-                val fallbackUrl = if (obj.has("fallbackUrl") && !obj.isNull("fallbackUrl")) {
-                    obj.getString("fallbackUrl")
-                } else null
-                out.add(WidgetInput.Video(playbackId = playbackId, fallbackUrl = fallbackUrl))
-            }
-            out
-        } catch (_: Exception) {
-            null
-        }
-    }
-}

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

@@ -1,30 +0,0 @@
-package com.shortkit.reactnative
-
-import com.facebook.react.module.annotations.ReactModule
-import com.facebook.react.uimanager.SimpleViewManager
-import com.facebook.react.uimanager.ThemedReactContext
-import com.facebook.react.uimanager.annotations.ReactProp
-
-@ReactModule(name = ShortKitWidgetViewManager.REACT_CLASS)
-class ShortKitWidgetViewManager : SimpleViewManager<ShortKitWidgetNativeView>() {
-
-    override fun getName(): String = REACT_CLASS
-
-    override fun createViewInstance(context: ThemedReactContext): ShortKitWidgetNativeView {
-        return ShortKitWidgetNativeView(context)
-    }
-
-    @ReactProp(name = "config")
-    fun setConfig(view: ShortKitWidgetNativeView, config: String?) {
-        view.config = config
-    }
-
-    @ReactProp(name = "items")
-    fun setItems(view: ShortKitWidgetNativeView, items: String?) {
-        view.items = items
-    }
-
-    companion object {
-        const val REACT_CLASS = "ShortKitWidgetView"
-    }
-}