@inappstory/react-sdk 1.16.4 → 1.16.6

package/dist/types/index.d.ts

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

package/dist/types/logger.d.ts

@@ -0,0 +1,135 @@
+/** Log level */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+
+/** Log domain */
+export declare enum LogDomain {
+    /** Stories domain */
+    Stories = "stories",
+    /** Core domain */
+    Core = "core",
+    /** Games domain */
+    Games = "games",
+    /** In-app messaging domain */
+    InAppMessaging = "in-app-messaging",
+    /** Banners domain */
+    Banners = "banners"
+}
+
+/** Log module */
+export declare enum LogModule {
+    /** Story reader module */
+    StoryReader = "story-reader",
+    /** API module */
+    Api = "api",
+    /** Game reader module */
+    GameReader = "game-reader",
+    /** IAM reader module */
+    IamReader = "iam-reader",
+    /** Banners module */
+    Banners = "banners"
+}
+
+/** Log component */
+export declare enum LogComponent {
+    /** Story component */
+    Story = "story",
+    /** Story slide component */
+    StorySlide = "story-slide",
+    /** Session component */
+    Session = "session",
+    /** Session store component */
+    SessionStore = "session-store",
+    /** HTTP client component */
+    HttpClient = "http-client",
+    /** Game component */
+    Game = "game",
+    /** Game session component */
+    GameSession = "game-session",
+    /** IAM component */
+    Iam = "iam",
+    /** IAM visibility observer component */
+    IamVisibilityObserver = "iam-visibility-observer",
+    /** IAM display service component */
+    IamDisplayService = "iam-display-service",
+    /** Banner place component */
+    BannerPlace = "banner-place",
+    /** Banner component */
+    Banner = "banner"
+}
+
+/** Log execution context scope */
+export type LogContextScope = {
+    domain?: LogDomain;
+    module?: LogModule;
+    component?: LogComponent;
+};
+
+/** Log execution context with optional dynamic business fields */
+export type LogContext = LogContextScope & {
+    /** User ID */
+    userId?: string;
+    /** User ID signature for validation of the user ID */
+    userIdSign?: string;
+    /** Session ID for the current session */
+    sessionId?: string;
+    /** Device ID for the current device */
+    deviceId?: string;
+    /** Platform (e.g. "web", "android", "ios") */
+    platform?: string;
+    /** Whether the user is anonymous */
+    anonymous?: boolean;
+    /** Environment (e.g. "development", "staging", "production") */
+    environment?: string;
+    [key: string]: any;
+};
+
+/** Log event type */
+export type LogEventType = "log" | LogLevel;
+
+/** Log entry */
+export interface LogEntry {
+    /** Log level */
+    level: LogLevel;
+    /** Log message */
+    message: string;
+    /** Log timestamp */
+    timestamp: Date;
+    /** Log context */
+    context?: LogContext;
+    /** Log error */
+    error?: Error;
+    /** Additional custom fields for integrations (Sentry, Datadog, etc.) */
+    [key: string]: any;
+}
+
+export type LogListener = (entry: LogEntry) => void;
+
+export interface LoggerConfig {
+    /** Threshold logging level (levels below are excluded) */
+    level?: LogLevel;
+    /** Disable all logging */
+    silent?: boolean;
+    /** Include timestamps in console output */
+    timestamps?: boolean;
+    /** Runtime environment label */
+    environment?: string;
+}
+
+/**
+ * SDK logger with level filtering, component-scoped logging, and event subscriptions.
+ *
+ * @example
+ * // Subscribe to all logs
+ * storyManager.logger.on("log", entry => console.log(entry));
+ */
+export interface IasLogger {
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext, error?: Error): void;
+    error(message: string, context?: LogContext, error?: Error): void;
+    on(event: LogEventType | string, listener: LogListener): this;
+    off(event: LogEventType | string, listener: LogListener): this;
+    once(event: LogEventType | string, listener: LogListener): this;
+}
+
+export interface StoryManagerLoggerConfig extends LoggerConfig {}

package/dist/types/storyManager.d.ts

@@ -1,6 +1,7 @@
 import type { StoryManagerEvents } from "./events";
 import type { InAppMessaging } from "./in-app-messaging/inAppMessaging";
 import type { Products } from "./products";
+import type { IasLogger, StoryManagerLoggerConfig } from "./logger";
 
 /**
  * Behaviour of the close button in the game reader.
@@ -144,6 +145,18 @@ export type StoryManagerConfig = {
     };
 
     /**
+     * SDK logging configuration.
+     * @example
+     * logger: {
+     *   level: "debug",
+     *   silent: false,
+     *   timestamps: true,
+     *   environment: "production"
+     * }
+     */
+
+    /*
+    logger?: StoryManagerLoggerConfig;
      * Behaviour of the close button in the game reader.
      * @default GameCloseButtonBehavior.CloseGame
      */
@@ -221,6 +234,14 @@ export declare class StoryManager {
     /** Products widget API */
     products: Products;
 
+    /**
+     * SDK logger for debugging and monitoring integrations.
+     * @example
+     * storyManager.logger.on("log", console.log);
+     * storyManager.logger.on("gameReader", console.log);
+     */
+    logger: IasLogger;
+
     /** Handler for story link clicks
      *
      * @example

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inappstory/react-sdk",
-  "version": "1.16.4",
+  "version": "1.16.6",
   "description": "React SDK",
   "keywords": [
     "stories",