@inappstory/js-sdk 3.6.2 → 3.7.0-rc.0

package/dist/types/inAppStoryManager.d.ts

@@ -4,88 +4,268 @@ import { StoriesList, UGCStoriesList } from "./story-list";
 import { PublicEventHandler, PublicEvents } from "./publicEvents";
 import { InAppMessaging } from "./in-app-messaging";
 
+/**
+ * Source of a link click within stories.
+ */
 export declare enum StoryLinkSource {
     StoryList = "storyList",
     StoryReader = "storyReader",
     GameReader = "gameReader"
 }
 
+/**
+ * Configuration options for initializing the InAppStoryManager.
+ */
 export type InAppStoryManagerConfig = {
+    /** API key for initializing the SDK */
     apiKey: string;
+    /** Unique user identifier (optional)
+     * @see https://docs.inappstory.com/sdk-guides/react-sdk/user-settings.html
+     */
     userId?: string | number;
+    /** Signature for the userId for validation (optional)
+     * @see https://docs.inappstory.com/sdk-guides/react-sdk/user-settings.html
+     */
     userIdSign?: string;
+    /** Tags for filtering stories (optional)
+     * @see https://docs.inappstory.com/sdk-guides/react-sdk/tags.html
+     */
     tags?: Array<string>;
+    /** Text placeholders to replace in stories (optional)
+     * @example
+     * placeholders: {
+     *   "userName": "John"
+     * }
+     * @see https://docs.inappstory.com/sdk-guides/js-sdk/placeholders.html
+     */
     placeholders?: Record<string, string>;
+    /** Image placeholders to replace in stories (optional)
+     * @example
+     * imagePlaceholders: {
+     *   "avatar": "https://example.com/avatar.png"
+     * }
+     * @see https://docs.inappstory.com/sdk-guides/js-sdk/placeholders.html
+     */
     imagePlaceholders?: Record<string, string>;
+    /** Language code for content display (e.g., "en-US") */
     lang?: string;
-    dir?: "ltr" | "rtl"
+    /** Text direction: 'ltr' or 'rtl' */
+    dir?: "ltr" | "rtl";
+    /** Disables automatic deviceId generation
+     * @see https://docs.inappstory.com/sdk-guides/react-sdk/user-settings.html#overview
+     */
     disableDeviceId?: boolean;
 };
 
+/**
+ * Configuration for the User Generated Content (UGC) editor.
+ */
 export type UgcEditorConfig = {
+    /** Unique session identifier */
     sessionId: string;
+    /** SDK API key */
     apiKey: string;
+    /** Editor configuration */
     editor: Record<any, any>;
+    /** SDK version */
     sdkVersion: string;
+    /** Application package identifier (optional) */
     appPackageId?: string;
+    /** Unique device identifier */
     deviceId: string;
+    /** User identifier (optional) */
     userId?: string;
+    /** Editor language code */
     lang: string;
 };
 
+/**
+ * Handler for story link click events.
+ * @deprecated Use `clickOnButton` event instead.
+ */
 export type StoryLinkClickHandler = (payload: {
     data: { id: number; index: number; isDeeplink: boolean; url: string };
     src: StoryLinkSource;
 }) => void;
 
+/**
+ * Interface for external plugin integration.
+ */
 export interface Plugin {
+    /** Unique plugin name */
     name: string;
+    /** Called when the plugin is installed */
     install(inAppStoryManager: InAppStoryManager, options?: any): void;
+    /** Called when the plugin is uninstalled */
     uninstall(inAppStoryManager: InAppStoryManager, options?: any): void;
 }
 
+/**
+ * Main class for managing stories, games, and content.
+ */
 export declare class InAppStoryManager {
+    /** SDK version name (e.g., '1.7.0') */
     get sdkVersionName(): string;
+
+    /** Numeric SDK version code (e.g., 10700) */
     get sdkVersionCode(): number;
+
+    /** Module for displaying in-app messages */
     inAppMessaging: InAppMessaging;
+
+    /** Sets the handler for story link clicks
+     * @example
+     * manager.storyLinkClickHandler = ({ data, src }) => {
+     *   console.log(`Link clicked: ${data.url} from ${src}`);
+     * };
+     * @deprecated Use `clickOnButton` event instead.
+     */
     set storyLinkClickHandler(value: StoryLinkClickHandler);
 
+    /**
+     * Creates an instance of InAppStoryManager.
+     * @param config SDK configuration
+     */
     constructor(config: InAppStoryManagerConfig);
+
+    /**
+     * Gets the current instance of the manager.
+     */
     static getInstance(): InAppStoryManager;
+
+    /**
+     * Installs a plugin at the class level.
+     * @param plugin The plugin instance
+     * @param options Optional plugin options
+     */
     static use(plugin: Plugin, options?: any): void;
 
+    /**
+     * Destroys the manager instance.
+     */
     destroy(): void;
+
+    /**
+     * Displays onboarding stories.
+     * @param appearanceManager Appearance manager instance
+     * @param options Optional filtering options
+     */
     showOnboardingStories(
         appearanceManager: AppearanceManager,
         options?: { feed?: string; customTags?: Array<string>; limit?: number }
     ): Promise<void>;
+
+    /**
+     * Displays the share page for a specific story.
+     * @param storyId The story ID
+     */
     showSharePage(storyId: number | string, appearanceManager: AppearanceManager): Promise<void>;
+
+    /**
+     * Opens a specific story.
+     * @param id The story ID
+     */
     showStory(id: number | string, appearanceManager: AppearanceManager): Promise<void>;
+
+    /**
+     * Opens a specific story only once.
+     * @param id The story ID
+     */
     showStoryOnce(id: number | string, appearanceManager: AppearanceManager): Promise<void>;
+
+    /**
+     * Opens a game by its instance ID.
+     * @param gameInstanceId Game instance identifier
+     * @param appearanceManager Appearance manager instance
+     * @param gameOptions Optional game parameters
+     */
     openGame(
-        gameInstanceId: string,
+        gameInstanceId: string | number,
         appearanceManager: AppearanceManager,
         gameOptions?: { demoMode?: boolean }
     ): Promise<void>;
+
+    /**
+     * Closes the currently active game, if any.
+     * @returns Whether the game was closed
+     */
     closeGame(): Promise<boolean>;
+
+    /**
+     * Closes the story reader, if it is open.
+     */
     closeStoryReader(): Promise<boolean | undefined>;
+
+    /**
+     * Closes the goods widget, if it is open.
+     */
     closeGoodsWidget(): void;
+
+    /**
+     * Retrieves the UGC editor configuration.
+     */
     getUgcEditorConfig(): Promise<UgcEditorConfig>;
+
+    /**
+     * Retrieves the nonce, if set.
+     */
     getNonce(): string | undefined;
+
+    /**
+     * Sets the user ID.
+     * @param userId User identifier
+     * @param sign Optional signature
+     */
     setUserId(userId: string | number, sign?: string): Promise<void>;
+
+    /**
+     * Logs out the current user.
+     */
     userLogout(): Promise<void>;
+
+    /**
+     * Sets the content language.
+     */
     setLang(lang: string): void;
+
+    /**
+     * Sets tags for filtering stories.
+     */
     setTags(tags: string[]): void;
+
+    /**
+     * Sets text placeholders.
+     */
     setPlaceholders(placeholders: Dict<string, string>): void;
+
+    /**
+     * Sets image placeholders.
+     */
     setImagePlaceholders(imagePlaceholders: Dict<string, string>): void;
+
+    /**
+     * Subscribes to an SDK event.
+     */
     on<Event extends keyof PublicEvents>(eventName: Event, listener: PublicEventHandler<Event>): this;
+
+    /**
+     * Subscribes to a one-time SDK event.
+     */
     once<Event extends keyof PublicEvents>(eventName: Event, listener: PublicEventHandler<Event>): this;
+
+    /**
+     * Unsubscribes from an SDK event.
+     */
     off<Event extends keyof PublicEvents>(eventName: Event, listener: PublicEventHandler<Event>): this;
 
     /** @deprecated Use `showSharePage()` instead */
     SharePage: {
         new (storyId: number | string, appearanceManager: AppearanceManager, options?: SharePageOptions): SharePage;
     };
+
+    /**
+     * Component for displaying a list of stories.
+     */
     StoriesList: {
         new (
             mountSelector: string,
@@ -93,6 +273,10 @@ export declare class InAppStoryManager {
             options: { feed?: string; testKey?: string; useUgcCard?: boolean }
         ): StoriesList;
     };
+
+    /**
+     * Component for displaying a list of UGC stories.
+     */
     UGCStoriesList: {
         new (
             mountSelector: string,
@@ -100,4 +284,4 @@ export declare class InAppStoryManager {
             options: { filter?: Record<string, any>; testKey?: string; useUgcCard?: boolean }
         ): UGCStoriesList;
     };
-}
+}

package/dist/types/share-page/sharePage.d.ts

@@ -7,6 +7,10 @@ export type SharePageOptions = {
     handleStoryReaderClose?: () => void;
 };
 
+/**
+ *  @deprecated Use showSharePage() instead
+ *  @see https://docs.inappstory.com/sdk-guides/sharing/sharing.html
+ */
 export declare class SharePage extends EventEmitter {
     constructor(storyId: number | string, appearanceManager: AppearanceManager, options?: SharePageOptions);
 

package/dist/types/story-list/StoryList.d.ts

@@ -2,18 +2,48 @@ import { EventEmitter } from "events";
 import { AppearanceManager } from "../appearance-manager";
 import { StoriesListType } from "./storiesListType";
 
+/**
+ * Component for rendering and managing a list of stories.
+ *
+ * Emits events related to story list loading and interactions.
+ */
 export declare class StoriesList extends EventEmitter {
+    /** Type of the stories list (e.g., regular, UGC, etc.) */
     get type(): StoriesListType;
+
+    /** Feed slug used for loading stories */
     get feedSlug(): string;
+
+    /** Test key for loading stories in test mode */
     get testKey(): string;
+
+    /** Whether the list includes a UGC card */
     get useUgcCard(): boolean;
 
+    /**
+     * Creates a new StoriesList instance and mounts it to the given selector.
+     * @param mountSelector CSS selector or DOM element where the list will be mounted
+     * @param appearanceManager Instance controlling the list’s appearance
+     * @param options Additional configuration:
+     *  - `feed`: Feed slug to load stories from
+     *  - `testKey`: Key for loading test stories
+     *  - `useUgcCard`: Whether to display a UGC card in the list
+     */
     constructor(
         mountSelector: string,
         appearanceManager: AppearanceManager,
         options: { feed?: string; testKey?: string; useUgcCard?: boolean }
     );
 
+    /**
+     * Reloads the list of stories.
+     * @param options Options for reloading:
+     *  - `needLoader`: Whether to show a loading indicator
+     */
     reload(options?: { needLoader: boolean }): Promise<void>;
+
+    /**
+     * Destroys the list instance and removes it from the DOM.
+     */
     destroy(): void;
 }

package/dist/types/story-list/UGCStoryList.d.ts

@@ -2,18 +2,48 @@ import { EventEmitter } from "events";
 import { AppearanceManager } from "../appearance-manager";
 import { StoriesListType } from "./storiesListType";
 
+/**
+ * Component for rendering and managing a list of user-generated content (UGC) stories.
+ *
+ * Emits events related to list loading, filtering, and user interactions.
+ */
 export declare class UGCStoriesList extends EventEmitter {
+    /** Type of the stories list (e.g., regular, UGC, etc.) */
     get type(): StoriesListType;
+
+    /** Feed slug used for loading stories (if applicable) */
     get feedSlug(): string;
+
+    /** Test key for loading stories in test mode */
     get testKey(): string;
+
+    /** Whether the list includes a UGC card */
     get useUgcCard(): boolean;
 
+    /**
+     * Creates a new UGCStoriesList instance and mounts it to the given selector.
+     * @param mountSelector CSS selector or DOM element where the list will be mounted
+     * @param appearanceManager Instance controlling the list’s appearance
+     * @param options Additional configuration:
+     *  - `filter`: Filter parameters for loading specific stories
+     *  - `testKey`: Key for loading test stories
+     *  - `useUgcCard`: Whether to display a UGC card in the list
+     */
     constructor(
         mountSelector: string,
         appearanceManager: AppearanceManager,
         options: { filter?: Record<string, any>; testKey?: string; useUgcCard?: boolean }
     );
 
+    /**
+     * Reloads the list of UGC stories.
+     * @param options Options for reloading:
+     *  - `needLoader`: Whether to show a loading indicator
+     */
     reload(options?: { needLoader: boolean }): Promise<void>;
+
+    /**
+     * Destroys the list instance and removes it from the DOM.
+     */
     destroy(): void;
 }

package/dist/types/story-list/storyListLoadStatus.ts

@@ -1,12 +1,49 @@
+/**
+ * Represents the loading status and metadata for a story list
+ */
 export interface StoryListLoadStatus {
-    feed: string | number,
-    filter: Record<string, any> | null,
-    defaultListLength: number,
-    favoriteListLength: number,
-    success: boolean,
+    /**
+     * The feed identifier that was loaded
+     */
+    feed: string;
+
+    /**
+     * Applied filters for the story list, or null if no filters were applied
+     */
+    filter: Record<string, any> | null;
+
+    /**
+     * Number of items in the default (non-favorite) story list
+     */
+    defaultListLength: number;
+
+    /**
+     * Number of items in the favorites list
+     */
+    favoriteListLength: number;
+
+    /**
+     * Indicates whether the loading operation was successful
+     */
+    success: boolean;
+
+    /**
+     * Error details if the loading failed, or null if successful
+     */
     error: {
-        name: string,
-        networkStatus: number,
-        networkMessage: string
-    } | null
+        /**
+         * Name/type of the error that occurred
+         */
+        name: string;
+
+        /**
+         * HTTP status code or network error code
+         */
+        networkStatus: number;
+
+        /**
+         * Human-readable error message from the network request
+         */
+        networkMessage: string;
+    } | null;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inappstory/js-sdk",
-  "version": "3.6.2",
+  "version": "3.7.0-rc.0",
   "description": "JS SDK",
   "keywords": [
     "stories",
@@ -35,6 +35,10 @@
     "./plugins/videoOnDemand": {
       "types": "./plugins/videoOnDemand/iasVideoOnDemandPlugin.d.ts",
       "default": "./plugins/videoOnDemand/iasVideoOnDemandPlugin.umd.js"
+    },
+    "./plugins/banners": {
+      "types": "./plugins/banners/types/index.d.ts",
+      "default": "./plugins/banners/index.esm.mjs"
     }
   },
   "main": "dist/index.umd.js",
@@ -54,7 +58,7 @@
     "Samsung >= 5"
   ],
   "dependencies": {
-    "@inappstory/react-sdk": "^1.7.2",
+    "@inappstory/react-sdk": "^1.8.0-rc.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },