@inappstory/react-sdk 1.8.0-rc.1 → 1.8.0-rc.10

package/dist/types/events.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Base StoryReader event.
+ * Used as a foundation for most story-related events.
+ */
+export interface StoryReaderEvent {
+    /** Unique story identifier */
+    id: number;
+    /** Story title (optional) */
+    title?: string;
+    /** Number of slides in the story */
+    slidesCount?: number;
+    /** Feed name where the story was loaded from */
+    feed?: string;
+    /** Source of story launch (e.g., deeplink, banner) */
+    source?: string;
+    /** Filters applied to the story list */
+    filter: Record<string, unknown>;
+    /** User-generated payload (e.g., UGC data) */
+    ugcPayload: Record<string, unknown>;
+    /** Number of items in the default list */
+    defaultListLength: number;
+    /** Number of items in the favorites list */
+    favoriteListLength: number;
+}
+
+/**
+ * Possible reasons for closing StoryReader.
+ */
+export enum CloseAction {
+    /** Closed via the close (X) button in UI */
+    closeReaderByCloseBtn = "closeReaderByCloseBtn",
+    /** Closed via ESC key (desktop only) */
+    closeReaderByEscBtn = "closeReaderByEscBtn",
+    /** Closed by swipe down (mobile only) */
+    swipeDown = "swipeDown",
+    /** Closed by swipe to next story (mobile only) */
+    swipe = "swipe",
+    /** Closed by clicking the first (backward) or last (forward) slide */
+    lastSlideClick = "lastSlideClick",
+    /** Closed automatically by timer transition to next story */
+    auto = "auto",
+    /** Closed using public API: StoryManager.closeStoryReader */
+    externalCloseReader = "externalCloseReader"
+}
+
+/** Event: story was shown */
+export interface ShowStoryEvent extends StoryReaderEvent {}
+
+/** Event: story was closed */
+export interface CloseStoryEvent extends StoryReaderEvent {
+    /** Close reason */
+    action: CloseAction;
+}
+
+/** Event: user clicked on a story */
+export interface ClickOnStoryEvent extends StoryReaderEvent {
+    /** Story index inside feed */
+    index: number;
+    /** Whether the click was triggered by deeplink */
+    isDeeplink: boolean;
+    /** URL if click leads externally */
+    url?: string;
+}
+
+/** Event: specific slide was shown */
+export interface ShowSlideEvent extends StoryReaderEvent {
+    /** Index of the current slide */
+    index: number;
+    /** Slide payload (e.g., JSON data) */
+    payload: string;
+}
+
+/** Event: story was liked */
+export interface LikeStoryEvent extends StoryReaderEvent {
+    /** true — liked, false — unliked */
+    value: boolean;
+}
+
+/** Event: story was disliked */
+export interface DislikeStoryEvent extends StoryReaderEvent {
+    /** true — disliked, false — undisliked */
+    value: boolean;
+}
+
+/** Event: story was added/removed from favorites */
+export interface FavoriteStoryEvent extends StoryReaderEvent {
+    /** true — added, false — removed */
+    value: boolean;
+}
+
+/** Event: story was shared */
+export interface ShareStoryEvent extends StoryReaderEvent {}
+
+/** Event: story was shared with a given URL */
+export interface ShareStoryWithPathEvent extends StoryReaderEvent {
+    /** URL used for sharing */
+    url: string;
+}
+
+/** Event: user clicked on the "favorites" cell */
+export interface ClickOnFavoriteCellEvent {
+    /** Feed name where the click happened */
+    feed: string;
+}
+
+/** Event: feed was loaded */
+export interface FeedLoadEvent {
+    /** Feed name */
+    feed: string;
+    /** List of stories in the feed */
+    stories: Array<{ id: number; title: string; slidesCount: number }>;
+}
+
+/** Event: feed impression (visible stories) */
+export interface FeedImpressionEvent {
+    /** Feed name */
+    feed: string;
+    /** Stories that entered visible area */
+    stories: Array<{ id: number; title: string; slidesCount: number }>;
+}
+
+/** Event: visible area with stories was updated */
+export interface VisibleAreaUpdatedEvent {
+    /** Feed name */
+    feed: string;
+    /** Stories that became visible */
+    stories: Array<{ id: number; title: string; slidesCount: number }>;
+}
+
+/** Generic widget event */
+export interface WidgetEvent {
+    /** Event name */
+    name: string;
+    /** Event data */
+    data: any;
+}
+
+/** Event: mini-game started */
+export interface StartGameEvent {
+    /** Game ID */
+    id: string;
+}
+
+/** Event: mini-game closed */
+export interface CloseGameEvent {
+    /** Game ID */
+    id: string;
+}
+
+/** Event: mini-game finished */
+export interface FinishGameEvent {
+    /** Game ID */
+    id: string;
+    /** Game result */
+    result: Record<string, any>;
+}
+
+/** Generic game event */
+export interface EventGameEvent {
+    /** Event name */
+    name: string;
+    /** Event payload */
+    payload: Record<string, any>;
+}
+/**
+ * All StoryManager events that can be emitted externally.
+ */
+export interface StoryManagerEvents {
+    /** Story preview card is clicked */
+    clickOnStory: ClickOnStoryEvent;
+    /** Story is shown */
+    showStory: ShowSlideEvent;
+    /** Story is closed */
+    closeStory: CloseStoryEvent;
+    /** Slide is shown */
+    showSlide: ShowSlideEvent;
+    /** Story was liked */
+    likeStory: LikeStoryEvent;
+    /** Story was disliked */
+    dislikeStory: DislikeStoryEvent;
+    /** Story added/removed from favorites */
+    favoriteStory: FavoriteStoryEvent;
+    /** Story was shared */
+    shareStory: ShareStoryEvent;
+    /** Story shared with a given URL */
+    shareStoryWithPath: ShareStoryWithPathEvent;
+    /** Feed impression */
+    feedImpression: FeedImpressionEvent;
+    /** Visible area with stories was updated */
+    visibleAreaUpdated: VisibleAreaUpdatedEvent;
+    /** Widget event */
+    widgetEvent: WidgetEvent;
+    /** Game started */
+    startGame: StartGameEvent;
+    /** Game closed */
+    closeGame: CloseGameEvent;
+    /** Game finished */
+    finishGame: FinishGameEvent;
+    /** Custom game event */
+    eventGame: EventGameEvent;
+    /**
+     * @deprecated
+     * See https://docs.inappstory.com/sdk-guides/react-sdk/link-handling.html
+     */
+    clickOnButton: any;
+}
+
+/**
+ * @deprecated
+ *  Use StoryManagerEvents instead
+ */
+export type PublicEvents = StoryManagerEvents;

package/dist/types/ias-container/index.d.ts

@@ -1,2 +1 @@
-export { IASContainer } from './IasContainer';
-export * from "./publicEvents"
+export { IASContainer } from './IasContainer';

package/dist/types/ias-container/storyManagerEventsProps.d.ts

@@ -1,5 +1,4 @@
 import {
-    ClickOnButtonEvent,
     ClickOnStoryEvent,
     CloseStoryEvent,
     DislikeStoryEvent,
@@ -11,8 +10,12 @@ import {
     ShowSlideEvent,
     ShowStoryEvent,
     VisibleAreaUpdatedEvent,
-    WidgetEvent
-} from "./publicEvents";
+    WidgetEvent,
+    StartGameEvent,
+    FinishGameEvent,
+    CloseGameEvent,
+    EventGameEvent
+} from "../events";
 
 /**
  * Interface for `StoryManager` event handlers.
@@ -53,12 +56,6 @@ export interface StoryManagerEventsProps {
      */
     onShowSlide?: (event: ShowSlideEvent) => void;
 
-    /**
-     * Called when a user clicks on an interactive button in the story
-     * @param event - Contains URL
-     */
-    onClickOnButton?: (event: ClickOnButtonEvent) => void;
-
     /**
      * Called when a user likes a story
      * @param event - Contains story ID and like status
@@ -106,4 +103,35 @@ export interface StoryManagerEventsProps {
      * @param event - Contains widget type and event-specific data
      */
     onWidgetEvent?: (event: WidgetEvent) => void;
+
+    /**
+     * Called when a game is started inside the story
+     * @param event - Contains game identifier
+     */
+    onStartGame?: (event: StartGameEvent) => void;
+
+    /**
+     * Called when a game is closed by user or system
+     * @param event - Contains game identifier
+     */
+    onCloseGame?: (event: CloseGameEvent) => void;
+
+    /**
+     * Called when a game finishes
+     * @param event - Contains game identifier and result payload
+     */
+    onFinishGame?: (event: FinishGameEvent) => void;
+
+    /**
+     * Called on custom in-game events
+     * @param event - Contains event name and custom payload
+     */
+    onEventGame?: (event: EventGameEvent) => void;
+
+    /**
+     *
+     * @deprecated
+     * See https://docs.inappstory.com/sdk-guides/react-sdk/link-handling.html
+     */
+    onClickOnButton?: (event: any) => void;
 }

package/dist/types/index.d.ts

@@ -2,4 +2,5 @@ export * from "./appearance-manager";
 export * from "./story-list";
 export * from "./storyManager";
 export * from "./ias-container";
-export * from "./in-app-messaging"
+export * from "./in-app-messaging"
+export * from "./events"

package/dist/types/storyManager.d.ts

@@ -1,3 +1,4 @@
+import { StoryManagerEvents } from "./events";
 import { PublicEventHandler, PublicEvents } from "./ias-container";
 import { InAppMessaging } from "./in-app-messaging/inAppMessaging";
 
@@ -38,7 +39,7 @@ export type StoryManagerConfig = {
     placeholders?: Record<string, string>;
     /** Image placeholders to be replaced in stories (optional)
      * @see https://docs.inappstory.com/sdk-guides/js-sdk/placeholders.html
-     * @example 
+     * @example
      * imagePlaceholders: {
      *   "your-image-placeholder-key": "value"
      * }
@@ -52,6 +53,55 @@ export type StoryManagerConfig = {
      * @see https://docs.inappstory.com/sdk-guides/react-sdk/user-settings.html#overview
      */
     disableDeviceId?: boolean;
+    /**
+     * Use anonymous session. Warning: not all functionality will be available.
+     */
+    anonymous?: boolean;
+
+    /**
+     * The field is responsible for passing user variables and widget variables (for example, the "products" widget)
+     */
+    options?: {
+        /**
+         * Point of sale
+         */
+        pos?: string;
+    } & Record<string, any>;
+
+    /**
+     * A local BLOB-based cache used to prefetch data or as a fallback when the standard HTTP cache is unavailable (e.g., in environments with limited WebView).
+     * */
+    cache?: {
+        /** Cache type: 'memory' — fast but temporary; 'indexeddb' — persistent
+         * @default "indexeddb"
+         */
+        type: "memory" | "indexeddb";
+
+        /** Maximum cache size (e.g., in bytes or number of elements)
+         * @default 20
+         */
+        maxSize?: number;
+
+        /** Resource lifetime in the cache (in seconds).
+         * @default 0 (infinite)
+         */
+        ttl?: number;
+
+        /** Cache operation logging (for debugging)
+         * @default false
+         */
+        debug?: boolean;
+
+        /** Maximum number of parallel requests
+         * @default 5
+         */
+        concurrency?: number;
+
+        /** Prefetch resources
+         * @default false
+         */
+        prefetch?: boolean;
+    };
 };
 
 /**
@@ -78,7 +128,6 @@ export type UgcEditorConfig = {
 
 /**
  * Handler for story link click events.
- * @deprecated Use `clickOnButton` event instead
  */
 export type StoryLinkClickHandler = (payload: {
     data: { id: number; index: number; isDeeplink: boolean; url: string };
@@ -118,8 +167,6 @@ export declare class StoryManager {
      * storyManager.storyLinkClickHandler = ({ data, src }) => {
      *   console.log("Link clicked:", data.url, "from", src);
      * };
-     * @deprecated Use `clickOnButton` event instead
-     * @see https://docs.inappstory.com/sdk-guides/reack-sdk/link-handling.html
      */
     set storyLinkClickHandler(value: StoryLinkClickHandler);
 
@@ -149,10 +196,10 @@ export declare class StoryManager {
         };
 
      */
-    showOnboardingStories(options?: { feed?: string; customTags?: Array<string>; limit?: number }): Promise<{
+    showOnboardingStories(options?: { feed?: string; customTags?: string[]; limit?: number }): Promise<{
         stories: {
             title: Option<string>;
-            tags: Array<string>;
+            tags: string[];
             slidesCount: Option<number>;
             ugcPayload?: Record<string, unknown>;
             id: number;
@@ -185,12 +232,11 @@ export declare class StoryManager {
     /**
      * Opens a game by its instance ID.
      * @param gameInstanceId Game instance identifier
-     * @param gameOptions Optional game parameters
      * @see https://docs.inappstory.com/sdk-guides/react-sdk/games.html
      * @example
      * storyManager.openGame("your-game-id")
      */
-    openGame(gameInstanceId: string | number, gameOptions?: { demoMode?: boolean }): Promise<void>;
+    openGame(gameInstanceId: string | number): Promise<void>;
 
     /**
      * Closes the currently active game, if any.
@@ -221,7 +267,10 @@ export declare class StoryManager {
      * @param listener The event handler
      * @see https://docs.inappstory.com/sdk-guides/react-sdk/events.html
      */
-    on<Event extends keyof PublicEvents>(eventName: Event, listener: PublicEventHandler<Event>): this;
+    on<EventName extends keyof StoryManagerEvents>(
+        eventName: EventName,
+        listener: (event: StoryManagerEvents[EventName]) => void
+    ): this;
 
     /**
      * Subscribes to a one-time SDK event.
@@ -229,7 +278,10 @@ export declare class StoryManager {
      * @param listener The event handler
      * @see https://docs.inappstory.com/sdk-guides/react-sdk/events.html
      */
-    once<Event extends keyof PublicEvents>(eventName: Event, listener: PublicEventHandler<Event>): this;
+    once<EventName extends keyof StoryManagerEvents>(
+        eventName: EventName,
+        listener: (event: StoryManagerEvents[EventName]) => void
+    ): this;
 
     /**
      * Unsubscribes from an SDK event.
@@ -237,7 +289,10 @@ export declare class StoryManager {
      * @param listener The event handler
      * @see https://docs.inappstory.com/sdk-guides/react-sdk/events.html
      */
-    off<Event extends keyof PublicEvents>(eventName: Event, listener: PublicEventHandler<Event>): this;
+    off<EventName extends keyof StoryManagerEvents>(
+        eventName: EventName,
+        listener: (event: StoryManagerEvents[EventName]) => void
+    ): this;
 
     /**
      * Installs a plugin at the class level.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inappstory/react-sdk",
-  "version": "1.8.0-rc.1",
+  "version": "1.8.0-rc.10",
   "description": "React SDK",
   "keywords": [
     "stories",
@@ -58,7 +58,7 @@
     "Samsung >= 5"
   ],
   "dependencies": {
-    "@inappstory/slide-api": "^0.1.21",
+    "@inappstory/slide-api": "^0.1.24",
     "async-mutex": "^0.5.0",
     "bowser": "^2.11.0",
     "classnames": "^2.5.1",