@shortkitsdk/react-native 0.2.27 → 0.2.29

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;
@@ -284,6 +290,7 @@ export interface Spec extends TurboModule {
   appendFeedItems(feedId: string, items: string): void;
   fetchContent(limit: Int32, filterJSON: string | null): Promise<string>;
   applyFilter(feedId: string, filterJSON: string | null): void;
+  refresh(feedId: string): void;
   preloadFeed(configJSON: string, itemsJSON: string | null): Promise<string>;
 
   // --- Storyboard / seek thumbnails ---

package/src/types.ts

@@ -408,6 +408,8 @@ export interface ShortKitFeedHandle {
   appendFeedItems: (items: FeedInput[]) => void;
   /** Apply a content filter to this feed instance. Pass null to clear. */
   applyFilter: (filter: FeedFilter | null) => void;
+  /** Programmatically trigger a feed refresh. No-op if already refreshing. */
+  refresh: () => void;
 }
 
 // --- Single Player Config ---
@@ -421,6 +423,7 @@ export interface PlayerConfig {
   loop?: boolean;
   muteOnStart?: boolean;
   overlay?: OverlayConfig;
+  feedConfig?: FeedConfig;
 }
 
 // --- Widget Config ---
@@ -436,8 +439,17 @@ export interface WidgetConfig {
   clickAction?: PlayerClickAction;
   overlay?: OverlayConfig;
   filter?: FeedFilter;
+  feedConfig?: FeedConfig;
 }
 
+/**
+ * Compact input for widget items. Mirrors the video variant of `FeedInput` —
+ * host apps pass a playback ID and the SDK hydrates it into a full
+ * `ContentItem` internally (same resolver the feed uses).
+ */
+export type WidgetInput =
+  | { type: 'video'; playbackId: string; origin?: ContentOrigin; fallbackUrl?: string };
+
 // --- Single Player Props ---
 
 export interface ShortKitPlayerProps {
@@ -455,7 +467,13 @@ export interface ShortKitPlayerProps {
 
 export interface ShortKitWidgetProps {
   config?: WidgetConfig;
-  items?: ContentItem[];
+  /**
+   * Optional list of widget items to render. When provided, the widget
+   * skips its internal server fetch and renders these videos in order.
+   * Compact playback-ID form — the SDK hydrates URLs internally, matching
+   * how `<ShortKitFeed feedItems={...} />` works.
+   */
+  items?: WidgetInput[];
   style?: ViewStyle;
 }