@logspace/sdk 1.0.3 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@logspace/sdk",
-	"version": "1.0.3",
+	"version": "1.1.0",
 	"description": "LogSpace JavaScript SDK for session recording and logging",
 	"type": "module",
 	"main": "./logspace.umd.js",

package/sdk/capture/base.d.ts

@@ -1,7 +1,7 @@
 import { LogEntry, LogType } from '../../shared/types';
 import { CaptureHandler, PrivacyConfig } from '../types';
-import { generateId, safeStringify, maskSensitiveData, maskHeaders } from '../../shared/utils';
-export { generateId, safeStringify, maskSensitiveData, maskHeaders };
+import { generateId, safeStringify, maskSensitiveData, maskHeaders, maskConsoleArgs } from '../../shared/utils';
+export { generateId, safeStringify, maskSensitiveData, maskHeaders, maskConsoleArgs };
 /**
  * Check if running in browser environment (SSR safety)
  */
@@ -39,7 +39,9 @@ export declare function applyPrivacy(log: LogEntry, privacy: PrivacyConfig): Log
  */
 export interface CaptureModule {
     name: string;
-    install(handler: CaptureHandler, privacy: PrivacyConfig): void;
+    install(handler: CaptureHandler, privacy: PrivacyConfig, onActivity?: () => void, limits?: {
+        maxNetworkBodySize?: number;
+    }): void;
     uninstall(): void;
     reset?(): void;
 }

package/sdk/capture/sse.d.ts

@@ -1,5 +1,2 @@
 import { CaptureModule } from './base';
-/**
- * SSE capture module
- */
 export declare const sseCapture: CaptureModule;

package/sdk/capture/websocket.d.ts

@@ -1,5 +1,2 @@
 import { CaptureModule } from './base';
-/**
- * WebSocket capture module
- */
 export declare const websocketCapture: CaptureModule;

package/sdk/index.d.ts

@@ -1,9 +1,10 @@
 import { LogEntry } from '../shared/types';
-import { LogSpaceConfig, SDKSession, SessionPayload } from './types';
+import { LogSpaceConfig, NormalizedConfig, SDKSession, SessionPayload } from './types';
 import { eventWithTime } from './capture/rrweb';
 export declare const LogSpace: {
     /**
      * Initialize the SDK
+     * @throws Error if SDK is already initialized
      */
     init(userConfig: LogSpaceConfig): void;
     /**
@@ -16,6 +17,7 @@ export declare const LogSpace: {
     stopSession(): Promise<void>;
     /**
      * Identify user
+     * If called before session starts, the identity will be queued and applied when session starts
      */
     identify(userId: string, traits?: Record<string, any>): void;
     /**
@@ -55,6 +57,28 @@ export declare const LogSpace: {
      * Get rrweb events for current session
      */
     getRRWebEvents(): eventWithTime[];
+    /**
+     * Get current configuration (read-only)
+     * Returns the full NormalizedConfig plus convenience top-level fields
+     * that match the setConfig() interface for easy verification
+     */
+    getConfig(): (NormalizedConfig & {
+        rateLimit: number;
+        maxLogs: number;
+        maxSize: number;
+        idleTimeout: number;
+    }) | null;
+    /**
+     * Update configuration at runtime
+     * Only certain settings can be changed after initialization
+     */
+    setConfig(updates: {
+        rateLimit?: number;
+        maxLogs?: number;
+        maxSize?: number;
+        idleTimeout?: number;
+        debug?: boolean;
+    }): void;
     /**
      * Destroy SDK
      */

package/sdk/storage/indexed-db.d.ts

@@ -45,6 +45,10 @@ export declare function getCurrentSessionBackup(): Promise<CurrentSessionBackup
  * Clear current session backup (called after successful send)
  */
 export declare function clearCurrentSessionBackup(): Promise<void>;
+/**
+ * Clear current session backup only if it matches the provided session ID
+ */
+export declare function clearCurrentSessionBackupFor(sessionId: string): Promise<void>;
 /**
  * Add a session to pending queue (for retry later)
  */

package/sdk/types.d.ts

@@ -12,6 +12,7 @@ export type RecordingType = 'video' | 'rrweb';
  */
 export interface SDKSession {
     id: string;
+    tabId: string;
     startTime: number;
     endTime?: number;
     status: 'idle' | 'recording' | 'paused' | 'stopped';
@@ -96,7 +97,7 @@ export interface RRWebConfig {
      */
     recordCanvas?: boolean;
     /** Take a full DOM snapshot every N events
-     * @default 200
+     * @default 150
      */
     checkoutEveryNth?: number;
 }
@@ -146,7 +147,7 @@ export interface SessionLimits {
      */
     maxDuration?: number;
     /** Idle timeout in seconds - auto-end if no activity
-     * @default 30
+     * @default 120
      */
     idleTimeout?: number;
     /** Navigate away timeout in seconds - grace period when tab becomes hidden
@@ -162,6 +163,10 @@ export interface SessionLimits {
      * @default true
      */
     deduplicate?: boolean;
+    /** Maximum size for network request/response bodies in bytes
+     * @default 10240 (10KB)
+     */
+    maxNetworkBodySize?: number;
 }
 /**
  * Session end triggers
@@ -193,11 +198,11 @@ export interface SamplingConfig {
      */
     enabled?: boolean;
     /** Seconds of logs to keep before the trigger event
-     * @default 15
+     * @default 30
      */
     bufferBefore?: number;
     /** Seconds to continue recording after the trigger event
-     * @default 15
+     * @default 30
      */
     recordAfter?: number;
     /** What triggers a session to be saved */
@@ -244,6 +249,10 @@ export interface HooksConfig {
      * @default undefined
      */
     onSamplingTrigger?: (trigger: 'error' | 'consoleError' | 'networkError' | 'manual', log?: LogEntry) => void;
+    /** Called when a sampling session is discarded (no trigger occurred)
+     * @default undefined
+     */
+    onSessionDiscarded?: (session: SDKSession, reason: 'noTrigger' | 'idle' | 'maxDuration' | 'manual') => void;
     /** Called on transport/network errors
      * @default undefined
      */
@@ -266,7 +275,7 @@ export interface LogSpaceConfig {
      */
     capture?: CaptureConfig;
     /** rrweb DOM recording settings
-     * @default { maskAllInputs: false, recordCanvas: false, checkoutEveryNth: 200 }
+     * @default { maskAllInputs: false, recordCanvas: false, checkoutEveryNth: 150 }
      */
     rrweb?: RRWebConfig;
     /** Privacy settings for masking sensitive data
@@ -274,7 +283,7 @@ export interface LogSpaceConfig {
      */
     privacy?: PrivacyConfig;
     /** Session limits for protection against memory issues
-     * @default { maxLogs: 10000, maxSize: 10485760, maxDuration: 300, idleTimeout: 30, rateLimit: 100, deduplicate: true }
+     * @default { maxLogs: 10000, maxSize: 10485760, maxDuration: 1800, idleTimeout: 120, rateLimit: 100, deduplicate: true }
      */
     limits?: SessionLimits;
     /** Configure when to auto-end sessions

package/shared/types.d.ts

@@ -11,6 +11,7 @@ export interface RecordingSession {
     cspBlocked?: boolean;
     title?: string;
     comment?: string;
+    videoStartTime?: number;
 }
 export interface TabRecording {
     tabId: number;
@@ -233,6 +234,7 @@ export interface RecordingSettings {
     excludeDomains: string[];
     maskSensitiveData: boolean;
     logLevels: LogSeverity[];
+    maxNetworkBodySize: number;
 }
 export declare const DEFAULT_SETTINGS: RecordingSettings;
 export declare const API_TO_SETTINGS_KEY_MAP: Record<string, keyof RecordingSettings>;
@@ -344,10 +346,13 @@ export declare enum MessageType {
  */
 export declare enum InternalMessageType {
     PING = "ping",
+    GET_TAB_ID = "GET_TAB_ID",
+    CANCEL_AREA_SELECTION = "CANCEL_AREA_SELECTION",
     SHOW_COUNTDOWN = "SHOW_COUNTDOWN",
     COUNTDOWN_COMPLETE = "COUNTDOWN_COMPLETE",
     SELECT_AREA = "SELECT_AREA",
     AREA_SELECTED = "AREA_SELECTED",
+    AREA_SELECTION_CANCELLED = "AREA_SELECTION_CANCELLED",
     NETWORK_HEADERS_REQUEST = "NETWORK_HEADERS_REQUEST",
     NETWORK_HEADERS_RESPONSE = "NETWORK_HEADERS_RESPONSE",
     SHOW_WEBCAM_OVERLAY = "show-webcam-overlay",
@@ -369,6 +374,9 @@ export declare enum InternalMessageType {
     OFFSCREEN_LOG = "offscreen-log",
     DISPLAY_MEDIA_SELECTED = "display-media-selected",
     MICROPHONE_AUDIO_LEVEL = "microphone-audio-level",
+    BEGIN_MEDIA_RECORDING = "begin-media-recording",
+    VIDEO_RECORDING_STARTED = "video-recording-started",
+    SCREEN_SHARE_ENDED = "screen-share-ended",// User clicked browser's "Stop sharing" button
     CLOSE_POPUP = "CLOSE_POPUP",
     RECORDING_STARTED = "RECORDING_STARTED",
     RECORDING_ERROR = "RECORDING_ERROR",
@@ -420,6 +428,7 @@ export interface StatusResponse {
     session: RecordingSession | null;
     error?: string;
     auth?: AuthState;
+    recordedTabIds?: number[];
 }
 export interface CspDetectedMessage extends Message {
     type: MessageType.CSP_DETECTED;

package/shared/utils.d.ts

@@ -27,10 +27,17 @@ export declare function safeStringify(value: any): string;
  * Mask sensitive data in strings for privacy protection
  */
 export declare function maskSensitiveData(text: string): string;
+/**
+ * Mask console arguments, handling the case where label and value are separate args
+ * e.g., console.log("Password:", "secret") produces ["Password:", "secret"]
+ */
+export declare function maskConsoleArgs(args: string[]): string[];
 /**
  * Mask sensitive data in HTTP headers for privacy protection
+ * @param headers - The headers object to mask
+ * @param additionalHeaders - Additional header names to redact (from config.privacy.redactHeaders)
  */
-export declare function maskHeaders(headers: Record<string, string>): Record<string, string>;
+export declare function maskHeaders(headers: Record<string, string>, additionalHeaders?: string[]): Record<string, string>;
 /**
  * Check if a URL matches any of the excluded domain patterns
  * Supports regex patterns for flexible matching