@multiplayer-app/session-recorder-react-native 0.0.1-alpha.1 → 0.0.1-alpha.10

package/dist/types/session-recorder.d.ts

@@ -0,0 +1,366 @@
+import { SessionType } from '@multiplayer-app/session-recorder-common';
+import { PropagateTraceHeaderCorsUrls } from '@opentelemetry/sdk-trace-web';
+import { Span } from '@opentelemetry/api';
+import type { ISession } from './session';
+export declare enum WidgetButtonPlacement {
+    topLeft = "top-left",
+    topRight = "top-right",
+    bottomLeft = "bottom-left",
+    bottomRight = "bottom-right"
+}
+export interface SessionRecorderOptions {
+    /**
+     * The API key used to authenticate with the session debugger service.
+     */
+    apiKey: string;
+    /**
+     * The version of the application using the session debugger.
+     */
+    version: string;
+    /**
+     * The name of the application being debugged.
+     */
+    application: string;
+    /**
+     * The environment where the application is running (e.g., 'production', 'staging').
+     */
+    environment: string;
+    /**
+     * (Optional) OTLP collector endpoint.
+     */
+    exporterEndpoint?: string;
+    /**
+     * (Optional) Base URL for the API calls.
+     * This allows customization of the API endpoint for sending session data.
+     */
+    apiBaseUrl?: string;
+    /**
+     * (Optional) An array of URLs or regular expressions that should be ignored by the session debugger.
+     * Any URL that partially matches any regex in this array will not be traced.
+     * Additionally, URLs that exactly match any string in the array will also be ignored.
+     */
+    ignoreUrls?: Array<string | RegExp>;
+    /**
+     * (Optional) Determines where the record button should be placed on the screen.
+     * Possible values:
+     *  - 'top-left'
+     *  - 'top-right'
+     *  - 'bottom-left'
+     *  - 'bottom-right'
+     */
+    widgetButtonPlacement?: WidgetButtonPlacement;
+    /**
+     * (Optional) Enables the continuous recording feature and UI.
+     * If false, the UI toggle is hidden and attempts to start a continuous
+     * session are ignored.
+     * @default true
+     */
+    showContinuousRecording?: boolean;
+    /**
+     * (Optional) If false, the session recording widget will be hidden from the UI.
+     * Use this option if you want to enable session recording without a visible UI element.
+     * @default showWidget = true
+     */
+    showWidget?: boolean;
+    /**
+     * (Optional) Trace ID Ratio for sampling
+     * @default 0.15
+     */
+    sampleTraceRatio?: number;
+    /**
+     * (Optional) URLs or regex patterns for CORS trace header propagation
+     */
+    propagateTraceHeaderCorsUrls?: PropagateTraceHeaderCorsUrls;
+    /**
+     * (Optional) If true, schematizes document span payload
+     * @default true
+     */
+    schemifyDocSpanPayload?: boolean;
+    /**
+     * (Optional) Maximum size for capturing HTTP payload
+     * @default 100000
+     */
+    maxCapturingHttpPayloadSize?: number;
+    /**
+     * (Optional) If true, uses post message fallback
+     * @default false
+     */
+    usePostMessageFallback?: boolean;
+    /** If true, captures body in traces
+     *  @default true
+    */
+    captureBody?: boolean;
+    /** If true, captures headers in traces
+     *  @default true
+    */
+    captureHeaders?: boolean;
+    /**
+     * (Optional) Configuration for masking sensitive data in session recordings
+     * @default { maskAllInputs: true, isContentMaskingEnabled: true }
+     */
+    masking?: MaskingConfig;
+    /**
+     * (Optional) Configuration for customizable UI text and labels
+     * @default See PopoverTextConfig defaults
+     */
+    widgetTextOverrides?: WidgetTextOverridesConfig;
+    /** Whether to record gestures */
+    recordGestures?: boolean;
+    /** Whether to record navigation */
+    recordNavigation?: boolean;
+    /** Whether to record screen */
+    recordScreen?: boolean;
+}
+/**
+ * Interface for masking configuration
+ */
+export interface MaskingConfig {
+    /** If true, enables masking for debug span payload in traces
+     *  @default true
+    */
+    isContentMaskingEnabled?: boolean;
+    /** Custom function for masking body in traces */
+    maskBody?: (payload: any, span: Span) => any;
+    /** Custom function for masking headers in traces */
+    maskHeaders?: (headers: any, span: any) => any;
+    /** List of body fields to mask in traces */
+    maskBodyFieldsList?: string[];
+    /** List of headers to mask in traces */
+    maskHeadersList?: string[];
+    /** List of headers to include in traces (if specified, only these headers will be captured) */
+    headersToInclude?: string[];
+    /** List of headers to exclude from traces */
+    headersToExclude?: string[];
+}
+/**
+ * Base configuration interface with common properties
+ */
+export interface BaseConfig {
+    /** API key for authentication */
+    apiKey: string;
+    /** Base URL for the API calls */
+    apiBaseUrl: string;
+    /** Base URL for the API calls */
+    exporterEndpoint: string;
+    /** Whether to use post message fallback */
+    usePostMessageFallback?: boolean;
+}
+/**
+ * Configuration interface for the Tracer class
+ */
+export type TracerReactNativeMasking = Pick<MaskingConfig, 'isContentMaskingEnabled' | 'maskBody' | 'maskHeaders' | 'maskBodyFieldsList' | 'maskHeadersList' | 'headersToInclude' | 'headersToExclude'>;
+export interface TracerReactNativeConfig extends BaseConfig {
+    /** Application name */
+    application: string;
+    /** Application version */
+    version: string;
+    /** Environment (e.g., 'production', 'staging') */
+    environment: string;
+    /** URLs to ignore during tracing */
+    ignoreUrls: Array<string | RegExp>;
+    /** Trace ID ratio for sampling */
+    sampleTraceRatio: number;
+    /** URLs for CORS trace header propagation */
+    propagateTraceHeaderCorsUrls: PropagateTraceHeaderCorsUrls;
+    /** Whether to schematize document span payload */
+    schemifyDocSpanPayload: boolean;
+    /** Maximum size for capturing HTTP payload */
+    maxCapturingHttpPayloadSize: number;
+    /** If true, captures body in traces
+     *  @default true
+    */
+    captureBody: boolean;
+    /** If true, captures headers in traces
+     *  @default true
+    */
+    captureHeaders: boolean;
+    /** Configuration for masking sensitive data in session recordings */
+    masking: TracerReactNativeMasking;
+}
+/**
+ * Configuration interface for the Recorder class
+ */
+export interface RecorderConfig extends BaseConfig {
+    /** Whether to record gestures */
+    recordGestures?: boolean;
+    /** Whether to record navigation */
+    recordNavigation?: boolean;
+    /** Whether to record screen */
+    recordScreen?: boolean;
+}
+/**
+ * Configuration interface for the SessionWidget class
+ */
+export interface SessionWidgetConfig {
+    /** Whether to show the widget */
+    showWidget: boolean;
+    /** Placement of the widget button */
+    widgetButtonPlacement: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+    /** Whether continuous recording feature is enabled */
+    showContinuousRecording: boolean;
+    /** Configuration for customizable UI text and labels */
+    widgetTextOverrides: WidgetTextOverridesConfig;
+}
+/**
+ * Interface for customizable widget text configuration
+ */
+export interface WidgetTextOverridesConfig {
+    /** Title for the initial popover when continuous recording is enabled */
+    initialTitleWithContinuous?: string;
+    /** Title for the initial popover when continuous recording is disabled */
+    initialTitleWithoutContinuous?: string;
+    /** Description for the initial popover when continuous recording is enabled */
+    initialDescriptionWithContinuous?: string;
+    /** Description for the initial popover when continuous recording is disabled */
+    initialDescriptionWithoutContinuous?: string;
+    /** Label for the continuous recording toggle */
+    continuousRecordingLabel?: string;
+    /** Text for the start recording button */
+    startRecordingButtonText?: string;
+    /** Title for the final popover */
+    finalTitle?: string;
+    /** Description for the final popover */
+    finalDescription?: string;
+    /** Placeholder text for the comment textarea */
+    commentPlaceholder?: string;
+    /** Text for the save button in final popover */
+    saveButtonText?: string;
+    /** Text for the cancel button in final popover */
+    cancelButtonText?: string;
+    /** Title for the continuous recording overlay */
+    continuousOverlayTitle?: string;
+    /** Description for the continuous recording overlay */
+    continuousOverlayDescription?: string;
+    /** Text for the save last snapshot button */
+    saveLastSnapshotButtonText?: string;
+    /** Title for the submit session dialog */
+    submitDialogTitle?: string;
+    /** Subtitle for the submit session dialog */
+    submitDialogSubtitle?: string;
+    /** Label for the comment field in submit dialog */
+    submitDialogCommentLabel?: string;
+    /** Placeholder for the comment field in submit dialog */
+    submitDialogCommentPlaceholder?: string;
+    /** Text for the submit button in dialog */
+    submitDialogSubmitText?: string;
+    /** Text for the cancel button in dialog */
+    submitDialogCancelText?: string;
+}
+/**
+ * Configuration interface for the ApiService class
+ */
+export interface ApiServiceConfig extends BaseConfig {
+}
+export interface SessionRecorderConfigs extends Required<SessionRecorderOptions> {
+}
+export declare enum SessionState {
+    started = "2",
+    paused = "1",
+    stopped = "0"
+}
+export interface ISessionRecorder {
+    /**
+     * The current session ID
+     */
+    readonly sessionId: string | null;
+    /**
+     * Whether continuous recording is enabled
+     */
+    readonly continuousRecording: boolean;
+    /**
+     * The current debug session object
+     */
+    readonly session: ISession | null;
+    /**
+     * The type of session (plain or continuous)
+     */
+    readonly sessionType: SessionType;
+    /**
+     * The current state of the session
+     */
+    readonly sessionState: SessionState | null;
+    /**
+     * Session attributes for additional context
+     */
+    readonly sessionAttributes: Record<string, any>;
+    /**
+     * Current error message
+     */
+    error: string;
+    /**
+     * The HTML button element for the session widget's recorder button
+     */
+    readonly sessionWidgetButtonElement: HTMLButtonElement;
+    /**
+     * Initialize the session debugger with custom configurations
+     * @param configs - custom configurations for session debugger
+     */
+    init(configs: SessionRecorderOptions): void;
+    /**
+     * Save the continuous recording session
+     * @returns Promise that resolves to the save response
+     */
+    save(): Promise<any>;
+    /**
+     * Start a new session
+     * @param type - the type of session to start
+     * @param session - optional existing session to start
+     */
+    start(type?: SessionType, session?: ISession): void;
+    /**
+     * Stop the current session with an optional comment
+     * @param comment - user-provided comment to include in session feedback metadata
+     */
+    stop(comment?: string): Promise<void>;
+    /**
+     * Cancel the current session
+     */
+    cancel(): Promise<void>;
+    /**
+     * Pause the current session
+     */
+    pause(): Promise<void>;
+    /**
+     * Resume the current session
+     */
+    resume(): Promise<void>;
+    /**
+     * Set the session metadata
+     * @param attributes - the attributes to set
+     */
+    setSessionAttributes(attributes: Record<string, any>): void;
+    /**
+     * Set a custom click handler for the recording button
+     * @param handler - function that will be invoked when the button is clicked
+     */
+    set recordingButtonClickHandler(handler: () => boolean | void);
+}
+export type Breaker = {};
+export interface ScreenEvent {
+    screenName: string;
+    timestamp: number;
+    params?: Record<string, any>;
+    type?: string;
+    metadata?: Record<string, any>;
+    dataUrl?: string;
+}
+export interface GestureEvent {
+    type: string;
+    timestamp: number;
+    x?: number;
+    y?: number;
+    direction?: string;
+    target?: string;
+    coordinates?: {
+        x: number;
+        y: number;
+    };
+    metadata?: Record<string, any>;
+}
+export interface NavigationEvent {
+    type: string;
+    timestamp: number;
+    routeName?: string;
+    params?: Record<string, any>;
+    metadata?: Record<string, any>;
+}

package/dist/types/session-recorder.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.WidgetButtonPlacement=exports.SessionState=void 0;var WidgetButtonPlacement;(function(WidgetButtonPlacement){WidgetButtonPlacement["topLeft"]="top-left";WidgetButtonPlacement["topRight"]="top-right";WidgetButtonPlacement["bottomLeft"]="bottom-left";WidgetButtonPlacement["bottomRight"]="bottom-right";})(WidgetButtonPlacement||(exports.WidgetButtonPlacement=WidgetButtonPlacement={}));var SessionState;(function(SessionState){SessionState["started"]="2";SessionState["paused"]="1";SessionState["stopped"]="0";})(SessionState||(exports.SessionState=SessionState={}));

package/dist/types/session-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-recorder.js","sourceRoot":"","sources":["../../src/types/session-recorder.ts"],"names":[],"mappings":"AAMA,MAAM,CAAN,IAAY,qBAKX;AALD,WAAY,qBAAqB;IAC/B,6CAAoB,CAAA;IACpB,+CAAsB,CAAA;IACtB,mDAA0B,CAAA;IAC1B,qDAA4B,CAAA;AAC9B,CAAC,EALW,qBAAqB,KAArB,qBAAqB,QAKhC;AA0RD,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,4BAAY,CAAA;IACZ,6BAAa,CAAA;AACf,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB"}

package/dist/types/session.d.ts

@@ -0,0 +1,59 @@
+import { SessionType } from '@multiplayer-app/session-recorder-common';
+export interface IResourceAttributes {
+    browserInfo?: string;
+    cookiesEnabled?: string;
+    deviceInfo?: string;
+    hardwareConcurrency?: number;
+    osInfo?: string;
+    pixelRatio?: number;
+    screenSize?: string;
+    packageVersion?: string;
+    [key: string]: any;
+}
+export interface ISessionAttributes {
+    userEmail?: string;
+    userId?: string;
+    userName?: string;
+    accountId?: string;
+    accountName?: string;
+    [key: string]: any;
+}
+export interface ISessionView {
+    _id: string;
+    name: string;
+    components?: string[];
+}
+export interface ISession {
+    _id: string;
+    shortId: string;
+    workspace: string;
+    project: string;
+    continuousDebugSession?: string;
+    creationType: SessionType;
+    name: string;
+    startedAt: string | Date;
+    stoppedAt: string | Date;
+    durationInSeconds?: number;
+    createdAt: string | Date;
+    updatedAt: string | Date;
+    tags: any[];
+    resourceAttributes?: IResourceAttributes;
+    sessionAttributes?: ISessionAttributes;
+    views: ISessionView[];
+    starred: boolean;
+    starredItems: string[];
+    s3Files: {
+        _id?: string;
+        bucket: string;
+        key: string;
+        dataType: DebugSessionDataType;
+        url?: string;
+    }[];
+    finishedS3Transfer?: boolean;
+    tempApiKey?: string;
+}
+export declare enum DebugSessionDataType {
+    OTLP_TRACES = "OTLP_TRACES",
+    OTLP_LOGS = "OTLP_LOGS",
+    RRWEB_EVENTS = "RRWEB_EVENTS"
+}

package/dist/types/session.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.DebugSessionDataType=void 0;var DebugSessionDataType;(function(DebugSessionDataType){DebugSessionDataType["OTLP_TRACES"]="OTLP_TRACES";DebugSessionDataType["OTLP_LOGS"]="OTLP_LOGS";DebugSessionDataType["RRWEB_EVENTS"]="RRWEB_EVENTS";})(DebugSessionDataType||(exports.DebugSessionDataType=DebugSessionDataType={}));

package/dist/types/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AA4DA,MAAM,CAAN,IAAY,oBAIX;AAJD,WAAY,oBAAoB;IAC9B,mDAA2B,CAAA;IAC3B,+CAAuB,CAAA;IACvB,qDAA6B,CAAA;AAC/B,CAAC,EAJW,oBAAoB,KAApB,oBAAoB,QAI/B"}

package/dist/utils/app-metadata.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Auto-generated app metadata
+ * This file is generated at build time to provide app metadata without developer intervention
+ */
+export interface AppMetadata {
+    name?: string;
+    version?: string;
+    bundleId?: string;
+    buildNumber?: string;
+    displayName?: string;
+}
+export declare const APP_METADATA: AppMetadata;
+/**
+ * Get auto-detected app metadata
+ */
+export declare function getAutoDetectedAppMetadata(): AppMetadata;

package/dist/utils/app-metadata.js

@@ -0,0 +1 @@
+"use strict";var _interopRequireDefault=require("@babel/runtime/helpers/interopRequireDefault");Object.defineProperty(exports,"__esModule",{value:true});exports.APP_METADATA=void 0;exports.getAutoDetectedAppMetadata=getAutoDetectedAppMetadata;var _defineProperty2=_interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));function ownKeys(e,r){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);r&&(o=o.filter(function(r){return Object.getOwnPropertyDescriptor(e,r).enumerable;})),t.push.apply(t,o);}return t;}function _objectSpread(e){for(var r=1;r<arguments.length;r++){var t=null!=arguments[r]?arguments[r]:{};r%2?ownKeys(Object(t),!0).forEach(function(r){(0,_defineProperty2["default"])(e,r,t[r]);}):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):ownKeys(Object(t)).forEach(function(r){Object.defineProperty(e,r,Object.getOwnPropertyDescriptor(t,r));});}return e;}var APP_METADATA=exports.APP_METADATA={name:"@multiplayer-app/session-recorder-react-native",version:"0.0.1-alpha.10",bundleId:undefined,buildNumber:undefined,displayName:undefined};function getAutoDetectedAppMetadata(){return _objectSpread({},APP_METADATA);}

package/dist/utils/app-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-metadata.js","sourceRoot":"","sources":["../../src/utils/app-metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,wDAAwD;AACxD,MAAM,CAAC,MAAM,YAAY,GAAgB;IACvC,IAAI,EAAE,gDAAgD;IACtD,OAAO,EAAE,gBAAgB;IACzB,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,SAAS;IACtB,WAAW,EAAE,SAAS;CACvB,CAAA;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO,EAAE,GAAG,YAAY,EAAE,CAAA;AAC5B,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+export * from './platform';
+export * from './session';
+export * from './time';
+export * from './type-utils';
+export * from './request-utils';
+export * from './rrweb-events';
+export * from './logger';

package/dist/utils/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});var _platform=require("./platform");Object.keys(_platform).forEach(function(key){if(key==="default"||key==="__esModule")return;if(key in exports&&exports[key]===_platform[key])return;Object.defineProperty(exports,key,{enumerable:true,get:function get(){return _platform[key];}});});var _session=require("./session");Object.keys(_session).forEach(function(key){if(key==="default"||key==="__esModule")return;if(key in exports&&exports[key]===_session[key])return;Object.defineProperty(exports,key,{enumerable:true,get:function get(){return _session[key];}});});var _time=require("./time");Object.keys(_time).forEach(function(key){if(key==="default"||key==="__esModule")return;if(key in exports&&exports[key]===_time[key])return;Object.defineProperty(exports,key,{enumerable:true,get:function get(){return _time[key];}});});var _typeUtils=require("./type-utils");Object.keys(_typeUtils).forEach(function(key){if(key==="default"||key==="__esModule")return;if(key in exports&&exports[key]===_typeUtils[key])return;Object.defineProperty(exports,key,{enumerable:true,get:function get(){return _typeUtils[key];}});});var _requestUtils=require("./request-utils");Object.keys(_requestUtils).forEach(function(key){if(key==="default"||key==="__esModule")return;if(key in exports&&exports[key]===_requestUtils[key])return;Object.defineProperty(exports,key,{enumerable:true,get:function get(){return _requestUtils[key];}});});var _rrwebEvents=require("./rrweb-events");Object.keys(_rrwebEvents).forEach(function(key){if(key==="default"||key==="__esModule")return;if(key in exports&&exports[key]===_rrwebEvents[key])return;Object.defineProperty(exports,key,{enumerable:true,get:function get(){return _rrwebEvents[key];}});});var _logger=require("./logger");Object.keys(_logger).forEach(function(key){if(key==="default"||key==="__esModule")return;if(key in exports&&exports[key]===_logger[key])return;Object.defineProperty(exports,key,{enumerable:true,get:function get(){return _logger[key];}});});

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,QAAQ,CAAA;AACtB,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Centralized logger utility for the session recorder
+ * Provides consistent logging across all components
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3
+}
+export interface LoggerConfig {
+    level: LogLevel;
+    enableConsole: boolean;
+    enablePrefix: boolean;
+    prefix: string;
+}
+declare class Logger {
+    private config;
+    private componentPrefixes;
+    /**
+     * Configure the logger
+     * @param config - Logger configuration
+     */
+    configure(config: Partial<LoggerConfig>): void;
+    /**
+     * Set the log level
+     * @param level - Log level to set
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Enable or disable console output
+     * @param enabled - Whether to enable console output
+     */
+    setConsoleEnabled(enabled: boolean): void;
+    /**
+     * Add or update a component prefix
+     * @param component - Component name
+     * @param emoji - Emoji prefix for the component
+     */
+    setComponentPrefix(component: string, emoji: string): void;
+    /**
+     * Get the formatted prefix for a component
+     * @param component - Component name
+     * @returns Formatted prefix string
+     */
+    private getPrefix;
+    /**
+     * Check if a log level should be output
+     * @param level - Log level to check
+     * @returns True if should output
+     */
+    private shouldLog;
+    /**
+     * Format the log message
+     * @param component - Component name
+     * @param level - Log level
+     * @param message - Log message
+     * @param data - Additional data to log
+     * @returns Formatted log message
+     */
+    private formatMessage;
+    /**
+     * Log a debug message
+     * @param component - Component name
+     * @param message - Log message
+     * @param data - Additional data to log
+     */
+    debug(component: string, message: string, data?: any): void;
+    /**
+     * Log an info message
+     * @param component - Component name
+     * @param message - Log message
+     * @param data - Additional data to log
+     */
+    info(component: string, message: string, data?: any): void;
+    /**
+     * Log a warning message
+     * @param component - Component name
+     * @param message - Log message
+     * @param data - Additional data to log
+     */
+    warn(component: string, message: string, data?: any): void;
+    /**
+     * Log an error message
+     * @param component - Component name
+     * @param message - Log message
+     * @param data - Additional data to log
+     */
+    error(component: string, message: string, data?: any): void;
+    /**
+     * Log a success message (info level with success emoji)
+     * @param component - Component name
+     * @param message - Log message
+     * @param data - Additional data to log
+     */
+    success(component: string, message: string, data?: any): void;
+    /**
+     * Log a failure message (error level with failure emoji)
+     * @param component - Component name
+     * @param message - Log message
+     * @param data - Additional data to log
+     */
+    failure(component: string, message: string, data?: any): void;
+}
+export declare const logger: Logger;
+export declare const logDebug: (component: string, message: string, data?: any) => void;
+export declare const logInfo: (component: string, message: string, data?: any) => void;
+export declare const logWarn: (component: string, message: string, data?: any) => void;
+export declare const logError: (component: string, message: string, data?: any) => void;
+export declare const logSuccess: (component: string, message: string, data?: any) => void;
+export declare const logFailure: (component: string, message: string, data?: any) => void;
+export {};

package/dist/utils/logger.js

@@ -0,0 +1 @@
+"use strict";var _interopRequireDefault=require("@babel/runtime/helpers/interopRequireDefault");Object.defineProperty(exports,"__esModule",{value:true});exports.logger=exports.logWarn=exports.logSuccess=exports.logInfo=exports.logFailure=exports.logError=exports.logDebug=exports.LogLevel=void 0;var _defineProperty2=_interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));var _classCallCheck2=_interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));var _createClass2=_interopRequireDefault(require("@babel/runtime/helpers/createClass"));function ownKeys(e,r){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);r&&(o=o.filter(function(r){return Object.getOwnPropertyDescriptor(e,r).enumerable;})),t.push.apply(t,o);}return t;}function _objectSpread(e){for(var r=1;r<arguments.length;r++){var t=null!=arguments[r]?arguments[r]:{};r%2?ownKeys(Object(t),!0).forEach(function(r){(0,_defineProperty2["default"])(e,r,t[r]);}):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):ownKeys(Object(t)).forEach(function(r){Object.defineProperty(e,r,Object.getOwnPropertyDescriptor(t,r));});}return e;}var LogLevel;(function(LogLevel){LogLevel[LogLevel["DEBUG"]=0]="DEBUG";LogLevel[LogLevel["INFO"]=1]="INFO";LogLevel[LogLevel["WARN"]=2]="WARN";LogLevel[LogLevel["ERROR"]=3]="ERROR";})(LogLevel||(exports.LogLevel=LogLevel={}));var Logger=function(){function Logger(){(0,_classCallCheck2["default"])(this,Logger);this.config={level:LogLevel.INFO,enableConsole:true,enablePrefix:true,prefix:'[SessionRecorder]'};this.componentPrefixes=new Map([['ScreenRecorder','📸'],['GestureRecorder','👆'],['GestureCaptureWrapper','📸'],['SessionRecorderContext','🎯'],['EventExporter','📤'],['NavigationTracker','📸'],['RecorderReactNativeSDK','📤'],['DEBUGGER_LIB','🔍']]);}return(0,_createClass2["default"])(Logger,[{key:"configure",value:function configure(config){this.config=_objectSpread(_objectSpread({},this.config),config);}},{key:"setLevel",value:function setLevel(level){this.config.level=level;}},{key:"setConsoleEnabled",value:function setConsoleEnabled(enabled){this.config.enableConsole=enabled;}},{key:"setComponentPrefix",value:function setComponentPrefix(component,emoji){this.componentPrefixes.set(component,emoji);}},{key:"getPrefix",value:function getPrefix(component){if(!this.config.enablePrefix)return'';var emoji=this.componentPrefixes.get(component)||'📝';return"".concat(this.config.prefix," ").concat(emoji," [").concat(component,"]");}},{key:"shouldLog",value:function shouldLog(level){return level>=this.config.level&&this.config.enableConsole;}},{key:"formatMessage",value:function formatMessage(component,level,message,data){var prefix=this.getPrefix(component);var timestamp=new Date().toISOString();var levelName=LogLevel[level];var formattedMessage="".concat(prefix," ").concat(levelName," ").concat(message);if(data!==undefined){formattedMessage+=" ".concat(JSON.stringify(data));}return formattedMessage;}},{key:"debug",value:function debug(component,message,data){if(!this.shouldLog(LogLevel.DEBUG))return;var formattedMessage=this.formatMessage(component,LogLevel.DEBUG,message,data);console.log(formattedMessage);}},{key:"info",value:function info(component,message,data){if(!this.shouldLog(LogLevel.INFO))return;var formattedMessage=this.formatMessage(component,LogLevel.INFO,message,data);console.log(formattedMessage);}},{key:"warn",value:function warn(component,message,data){if(!this.shouldLog(LogLevel.WARN))return;var formattedMessage=this.formatMessage(component,LogLevel.WARN,message,data);console.warn(formattedMessage);}},{key:"error",value:function error(component,message,data){if(!this.shouldLog(LogLevel.ERROR))return;var formattedMessage=this.formatMessage(component,LogLevel.ERROR,message,data);console.error(formattedMessage);}},{key:"success",value:function success(component,message,data){if(!this.shouldLog(LogLevel.INFO))return;var prefix=this.getPrefix(component);var timestamp=new Date().toISOString();var formattedMessage="".concat(prefix," \u2705 ").concat(message);var fullMessage=formattedMessage;if(data!==undefined){fullMessage+=" ".concat(JSON.stringify(data));}console.log(fullMessage);}},{key:"failure",value:function failure(component,message,data){if(!this.shouldLog(LogLevel.ERROR))return;var prefix=this.getPrefix(component);var timestamp=new Date().toISOString();var formattedMessage="".concat(prefix," \u274C ").concat(message);var fullMessage=formattedMessage;if(data!==undefined){fullMessage+=" ".concat(JSON.stringify(data));}console.error(fullMessage);}}]);}();var logger=exports.logger=new Logger();var logDebug=exports.logDebug=function logDebug(component,message,data){return logger.debug(component,message,data);};var logInfo=exports.logInfo=function logInfo(component,message,data){return logger.info(component,message,data);};var logWarn=exports.logWarn=function logWarn(component,message,data){return logger.warn(component,message,data);};var logError=exports.logError=function logError(component,message,data){return logger.error(component,message,data);};var logSuccess=exports.logSuccess=function logSuccess(component,message,data){return logger.success(component,message,data);};var logFailure=exports.logFailure=function logFailure(component,message,data){return logger.failure(component,message,data);};

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}

package/dist/utils/platform.d.ts

@@ -1,3 +1,4 @@
+import { IResourceAttributes } from '../types';
 export interface PlatformInfo {
     isExpo: boolean;
     isReactNative: boolean;
@@ -7,3 +8,39 @@ export interface PlatformInfo {
     deviceType: string;
 }
 export declare function isReactNativeEnvironment(): boolean;
+/**
+ * Configure app metadata for non-Expo React Native apps
+ * Call this function in your app initialization to provide app information
+ *
+ * @example
+ * ```typescript
+ * import { configureAppMetadata } from '@multiplayer-app/session-recorder-react-native'
+ *
+ * // In your App.tsx or index.js
+ * configureAppMetadata({
+ *   name: 'My Awesome App',
+ *   version: '1.2.3',
+ *   bundleId: 'com.mycompany.myapp',
+ *   buildNumber: '123',
+ *   displayName: 'My App'
+ * })
+ * ```
+ */
+export declare function configureAppMetadata(metadata: {
+    name?: string;
+    version?: string;
+    bundleId?: string;
+    buildNumber?: string;
+    displayName?: string;
+}): void;
+/**
+ * Get configured app metadata
+ */
+export declare function getConfiguredAppMetadata(): {
+    name?: string;
+    version?: string;
+    bundleId?: string;
+    buildNumber?: string;
+    displayName?: string;
+};
+export declare const getNavigatorInfo: () => IResourceAttributes;