@sessionlens/sdk 0.1.0

package/README.md

@@ -0,0 +1,266 @@
+# SessionLens SDK
+
+A lightweight TypeScript SDK for analytics and user tracking.
+
+## Installation
+
+```bash
+npm install @sessionlens/sdk
+```
+
+## Quick Start
+
+### Basic Usage
+
+```javascript
+import sessionLens from '@sessionlens/sdk';
+
+// Initialize the SDK with your credentials
+await sessionLens.sessionLensInit({
+  sdk_key: 'your-sdk-key-here',
+  user_id: 'user123',
+  org_id: 'org456',
+  debug: true // Optional: enable debug logging
+});
+
+// Track events
+sessionLens.sessionLensTrack({
+  event_name: 'button_click',
+  properties: {
+    button_id: 'signup',
+    page: 'landing'
+  }
+});
+
+// Identify users
+sessionLens.sessionLensIdentify({
+  user_id: 'user123',
+  properties: {
+    email: 'user@example.com',
+    plan: 'premium'
+  }
+});
+
+// Reset tracking (e.g., on logout)
+sessionLens.sessionLensReset();
+```
+
+### React Integration
+
+```jsx
+import React from 'react';
+import { useSessionLens, useSessionLensTrack, useSessionLensIdentify } from '@sessionlens/sdk';
+
+function App() {
+  // Initialize SDK
+  useSessionLens({
+    sdk_key: 'your-sdk-key-here',
+    user_id: 'user123',
+    org_id: 'org456',
+    debug: true
+  });
+
+  const track = useSessionLensTrack();
+  const identify = useSessionLensIdentify();
+
+  const handleClick = () => {
+    track({
+      event_name: 'button_click',
+      properties: { button: 'header_cta' }
+    });
+  };
+
+  const handleLogin = () => {
+    identify({
+      user_id: 'user123',
+      properties: { email: 'user@example.com' }
+    });
+  };
+
+  return (
+    <div>
+      <button onClick={handleClick}>Track Event</button>
+      <button onClick={handleLogin}>Identify User</button>
+    </div>
+  );
+}
+```
+
+## Configuration
+
+### Environment Variables
+
+The SDK supports configuration through environment variables:
+
+#### API Base URL
+
+Configure the API base URL for different environments:
+
+```bash
+# For Node.js applications
+SESSIONLENS_API_BASE_URL=https://api.sessionlens.com/v1
+
+# For React applications (Create React App)
+REACT_APP_SESSIONLENS_API_BASE_URL=https://api.sessionlens.com/v1
+
+# For development/staging environments
+SESSIONLENS_API_BASE_URL=https://staging-api.sessionlens.com/v1
+REACT_APP_SESSIONLENS_API_BASE_URL=https://staging-api.sessionlens.com/v1
+```
+
+**Default:** `https://api.sessionlens.com/v1`
+
+### Environment Setup Examples
+
+#### Development (.env.development)
+```bash
+REACT_APP_SESSIONLENS_API_BASE_URL=https://dev-api.sessionlens.com/v1
+REACT_APP_SESSIONLENS_SDK_KEY=sk_dev_your_development_key
+```
+
+#### Staging (.env.staging)
+```bash
+REACT_APP_SESSIONLENS_API_BASE_URL=https://staging-api.sessionlens.com/v1
+REACT_APP_SESSIONLENS_SDK_KEY=sk_staging_your_staging_key
+```
+
+#### Production (.env.production)
+```bash
+REACT_APP_SESSIONLENS_API_BASE_URL=https://api.sessionlens.com/v1
+REACT_APP_SESSIONLENS_SDK_KEY=sk_live_your_production_key
+```
+
+## API Reference
+
+### Configuration
+
+The SDK requires initialization with your credentials:
+
+```typescript
+interface SessionLensConfig {
+  sdk_key: string;      // Your SessionLens SDK key
+  user_id: string;      // Unique identifier for the user
+  org_id: string;       // Your organization ID
+  debug?: boolean;      // Optional: enable debug logging
+}
+```
+
+### Methods
+
+#### `sessionLensInit(config: SessionLensConfig): Promise<void>`
+
+Initialize the SDK with your configuration. This method validates your credentials with the SessionLens backend using a RESTful GET request.
+
+**API Call:** `GET /validate?org_id={org_id}&user_id={user_id}` with `Authorization: Bearer {sdk_key}` header
+
+**Error Handling:**
+- `401`: Invalid SDK key
+- `403`: Access denied - check organization permissions
+- `404`: Organization not found
+- `429`: Rate limit exceeded
+- Network errors: SDK runs in offline mode
+
+#### `sessionLensTrack(event: SessionLensEvent): void`
+
+Track custom events.
+
+```typescript
+interface SessionLensEvent {
+  event_name: string;
+  properties?: Record<string, any>;
+  timestamp?: number; // Optional: will be auto-generated if not provided
+}
+```
+
+#### `sessionLensIdentify(user: SessionLensUser): void`
+
+Identify and update user properties.
+
+```typescript
+interface SessionLensUser {
+  user_id: string;
+  properties?: Record<string, any>;
+}
+```
+
+#### `sessionLensReset(): void`
+
+Reset tracking state. Useful when users log out.
+
+## API Design
+
+The SDK follows RESTful principles:
+
+- **GET /validate**: Validates SDK key and organization/user access (idempotent)
+- **POST /events**: Creates new tracking events
+- **POST /identify**: Creates/updates user identification
+- **POST /reset**: Resets user tracking state
+
+This design ensures:
+- Proper HTTP semantics (GET for reads, POST for writes)
+- Better caching behavior for validation requests
+- Cleaner server logs (sensitive data in headers, not URLs)
+
+## Security
+
+The SDK key is used for:
+- Backend validation during initialization
+- Authentication for all API requests
+- Secure event transmission
+
+**Best Practices:**
+- Store SDK keys securely (environment variables, secure storage)
+- Use different SDK keys for different environments
+- Rotate SDK keys regularly
+- Never expose SDK keys in client-side code for production
+- Use environment-specific API base URLs for development/staging
+
+## Error Handling
+
+The SDK includes comprehensive error handling:
+
+```javascript
+try {
+  await sessionLens.sessionLensInit({
+    sdk_key: 'your-sdk-key',
+    user_id: 'user123',
+    org_id: 'org456'
+  });
+  console.log('SDK initialized successfully');
+} catch (error) {
+  console.error('Initialization failed:', error.message);
+  // Handle specific errors:
+  // - Invalid SDK key
+  // - Network issues
+  // - Organization access issues
+}
+```
+
+## Examples
+
+Check the `/examples` directory for complete implementation examples:
+- Basic JavaScript usage
+- React integration
+- Error handling patterns
+- Offline mode handling
+- Environment configuration
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Run tests
+npm test
+
+# Run linting
+npm run lint
+```
+
+## License
+
+MIT 

package/dist/core/config.d.ts

@@ -0,0 +1,21 @@
+export interface SessionLensConfig {
+    sdk_key: string;
+    user_id: string;
+    org_id: string;
+    project_id?: string;
+    debug?: boolean;
+}
+interface SessionInfo {
+    session_id: string;
+    client_id: string;
+    org_id: string;
+    project_id: string;
+    user_id: string;
+    started_at: number;
+    last_activity: number;
+}
+export declare function sessionLensInit(config: SessionLensConfig): Promise<void>;
+export declare function sessionLensGetConfig(): SessionLensConfig;
+export declare function getSessionInfo(): SessionInfo;
+export declare function getSessionLensApiBaseUrl(): string;
+export {};

package/dist/core/tracker.d.ts

@@ -0,0 +1,4 @@
+import { SessionLensEvent, SessionLensUser } from '../types';
+export declare function sessionLensTrack(event: SessionLensEvent): void;
+export declare function sessionLensIdentify(user: SessionLensUser): void;
+export declare function sessionLensReset(): void;

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import { SessionLensConfig } from './core/config';
+import { SessionLensEvent, SessionLensUser, SessionLensInstance } from './types';
+export * from './types';
+export { SessionLensConfig } from './core/config';
+export * from './integrations/react';
+declare class SessionLens implements SessionLensInstance {
+    sessionLensInit(config: SessionLensConfig): Promise<void>;
+    sessionLensTrack(event: SessionLensEvent): void;
+    sessionLensIdentify(user: SessionLensUser): void;
+    sessionLensReset(): void;
+}
+declare const sessionLens: SessionLens;
+export default sessionLens;

package/dist/index.esm.js

@@ -0,0 +1,384 @@
+import { useEffect } from 'react';
+
+// Session timeout (30 minutes of inactivity)
+const SESSION_TIMEOUT = 30 * 60 * 1000;
+// Store the config and session info
+let currentConfig = null;
+let currentSession = null;
+// Extract project ID from SDK key pattern: sdk_prod_0000_684f15_5e0e72ac_35d2
+const extractProjectFromSDKKey = (sdk_key) => {
+    const parts = sdk_key.split('_');
+    return parts.length >= 4 ? `proj_${parts[3]}` : 'default';
+};
+// Generate crypto-grade unique IDs with hierarchical structure
+const generateUniqueId = (config, prefix) => {
+    const timestamp = Date.now();
+    const project_id = config.project_id || extractProjectFromSDKKey(config.sdk_key);
+    // Use crypto.randomUUID() for true uniqueness, fallback to secure random
+    const uuid = (() => {
+        if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+            return crypto.randomUUID().replace(/-/g, '').substring(0, 12);
+        }
+        // Fallback: combine multiple random values for better entropy
+        const random1 = Math.random().toString(36).substring(2, 15);
+        const random2 = Math.random().toString(36).substring(2, 15);
+        return (random1 + random2).substring(0, 12);
+    })();
+    // Format: {org_id}_{project_id}_{prefix}_{timestamp}_{uuid}
+    return `${config.org_id}_${project_id}_${prefix}_${timestamp}_${uuid}`;
+};
+// Get or create persistent client ID (per project)
+const getOrCreateClientId = (config) => {
+    const project_id = config.project_id || extractProjectFromSDKKey(config.sdk_key);
+    const storageKey = `sessionlens_client_${config.org_id}_${project_id}`;
+    if (typeof window !== 'undefined' && window.localStorage) {
+        try {
+            let clientId = localStorage.getItem(storageKey);
+            if (!clientId) {
+                clientId = generateUniqueId(config, 'client');
+                localStorage.setItem(storageKey, clientId);
+            }
+            return clientId;
+        }
+        catch (error) {
+            // localStorage might be disabled, fallback to session-only ID
+            return generateUniqueId(config, 'client');
+        }
+    }
+    // Fallback for non-browser environments
+    return generateUniqueId(config, 'client');
+};
+// Start new session with collision-proof IDs
+const startNewSession = (config) => {
+    const now = Date.now();
+    const project_id = config.project_id || extractProjectFromSDKKey(config.sdk_key);
+    currentSession = {
+        session_id: generateUniqueId(config, 'sess'),
+        client_id: getOrCreateClientId(config),
+        org_id: config.org_id,
+        project_id: project_id,
+        user_id: config.user_id,
+        started_at: now,
+        last_activity: now
+    };
+    if (config.debug) {
+        console.log('SessionLens: New session started', {
+            session_id: currentSession.session_id,
+            client_id: currentSession.client_id,
+            project_id: currentSession.project_id
+        });
+    }
+};
+// Check if session is expired
+const isSessionExpired = () => {
+    if (!currentSession)
+        return true;
+    return Date.now() - currentSession.last_activity > SESSION_TIMEOUT;
+};
+// Update session activity timestamp
+const updateSessionActivity = () => {
+    if (currentSession) {
+        currentSession.last_activity = Date.now();
+    }
+};
+// Get API base URL from environment variable or use default
+const getApiBaseUrl = () => {
+    // Check for environment variable (works in Node.js and bundlers like Webpack/Vite)
+    if (typeof process !== 'undefined' && process.env) {
+        return process.env.SESSIONLENS_API_BASE_URL || process.env.REACT_APP_SESSIONLENS_API_BASE_URL || 'https://api.sessionlens.com/v1';
+    }
+    // Fallback for browser environments without build-time env vars
+    return 'https://api.sessionlens.com/v1';
+};
+// `sessionLensInit()` sets the config and validates with backend
+async function sessionLensInit(config) {
+    // Validate required fields
+    if (!config.sdk_key) {
+        throw new Error('[SessionLens] sdk_key is required');
+    }
+    if (!config.user_id) {
+        throw new Error('[SessionLens] user_id is required');
+    }
+    if (!config.org_id) {
+        throw new Error('[SessionLens] org_id is required');
+    }
+    // Store the configuration
+    currentConfig = config;
+    // Start new session with scalable ID generation
+    startNewSession(config);
+    // Validate configuration with backend using GET (more RESTful)
+    const apiBaseUrl = getApiBaseUrl();
+    try {
+        // Use GET with query parameters for org_id and user_id validation
+        const validationUrl = new URL(`${apiBaseUrl}/org/validate`);
+        validationUrl.searchParams.set('org_id', config.org_id);
+        validationUrl.searchParams.set('user_id', config.user_id);
+        const response = await fetch(validationUrl.toString(), {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${config.sdk_key}`
+            }
+        });
+        if (!response.ok) {
+            switch (response.status) {
+                case 401:
+                    throw new Error('Invalid SDK key. Please check your credentials.');
+                case 403:
+                    throw new Error('Access denied. Please verify your organization permissions.');
+                case 404:
+                    throw new Error('Organization not found. Please check your org_id.');
+                case 429:
+                    throw new Error('Rate limit exceeded. Please try again later.');
+                default:
+                    throw new Error(`Validation failed with status ${response.status}`);
+            }
+        }
+        const result = await response.json();
+        if (config.debug) {
+            console.log('SessionLens SDK initialized successfully:', result);
+            console.log('Using API base URL:', apiBaseUrl);
+            console.log('Validation endpoint:', validationUrl.toString());
+            console.log('Session Info:', currentSession);
+        }
+    }
+    catch (error) {
+        if (error instanceof TypeError && error.message.includes('fetch')) {
+            // Network error - allow offline mode
+            if (config.debug) {
+                console.warn('SessionLens SDK: Running in offline mode due to network error');
+            }
+            return;
+        }
+        // Re-throw validation errors
+        throw error;
+    }
+}
+// `sessionLensGetConfig()` returns it later (for use in tracker, etc)
+function sessionLensGetConfig() {
+    if (!currentConfig) {
+        throw new Error('[SessionLens] SDK not initialized. Call `sessionLensInit()` first.');
+    }
+    return currentConfig;
+}
+// Get current session info with auto-renewal and activity tracking
+function getSessionInfo() {
+    if (!currentConfig) {
+        throw new Error('[SessionLens] SDK not initialized. Call `sessionLensInit()` first.');
+    }
+    // Check if session expired or doesn't exist
+    if (!currentSession || isSessionExpired()) {
+        startNewSession(currentConfig);
+    }
+    else {
+        // Update activity timestamp
+        updateSessionActivity();
+    }
+    return currentSession;
+}
+// Export function to get API base URL for use in other modules
+function getSessionLensApiBaseUrl() {
+    return getApiBaseUrl();
+}
+
+function sessionLensTrack(event) {
+    const config = sessionLensGetConfig();
+    const sessionInfo = getSessionInfo(); // Get current session with activity update
+    // Add timestamp if not provided
+    const eventWithTimestamp = {
+        ...event,
+        timestamp: event.timestamp || Date.now()
+    };
+    if (config.debug) {
+        console.log('SessionLens Track:', eventWithTimestamp);
+        console.log('Session Context:', {
+            session_id: sessionInfo.session_id,
+            client_id: sessionInfo.client_id,
+            project_id: sessionInfo.project_id
+        });
+    }
+    // Send event to backend with session context
+    sendEventToBackend(eventWithTimestamp, config, sessionInfo);
+}
+function sessionLensIdentify(user) {
+    const config = sessionLensGetConfig();
+    const sessionInfo = getSessionInfo(); // Get current session with activity update
+    if (config.debug) {
+        console.log('SessionLens Identify:', user);
+        console.log('Session Context:', {
+            session_id: sessionInfo.session_id,
+            client_id: sessionInfo.client_id,
+            project_id: sessionInfo.project_id
+        });
+    }
+    // Send identify event to backend with session context
+    sendIdentifyToBackend(user, config, sessionInfo);
+}
+function sessionLensReset() {
+    const config = sessionLensGetConfig();
+    const sessionInfo = getSessionInfo(); // Get current session with activity update
+    if (config.debug) {
+        console.log('SessionLens Reset');
+        console.log('Session Context:', {
+            session_id: sessionInfo.session_id,
+            client_id: sessionInfo.client_id,
+            project_id: sessionInfo.project_id
+        });
+    }
+    // Clear any stored user data and send reset event to backend
+    sendResetToBackend(config, sessionInfo);
+}
+// Helper functions for backend communication with session context
+async function sendEventToBackend(event, config, sessionInfo) {
+    const apiBaseUrl = getSessionLensApiBaseUrl();
+    try {
+        const response = await fetch(`${apiBaseUrl}/events/ingest`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${config.sdk_key}`
+            },
+            body: JSON.stringify({
+                org_id: config.org_id,
+                project_id: sessionInfo.project_id,
+                user_id: config.user_id,
+                session_id: sessionInfo.session_id,
+                client_id: sessionInfo.client_id,
+                session_started_at: sessionInfo.started_at,
+                event: event
+            })
+        });
+        if (!response.ok && config.debug) {
+            console.warn('SessionLens: Failed to send event:', response.status);
+        }
+        else if (config.debug) {
+            console.log('SessionLens: Event sent successfully with session context');
+        }
+    }
+    catch (error) {
+        if (config.debug) {
+            console.warn('SessionLens: Network error sending event:', error);
+        }
+    }
+}
+async function sendIdentifyToBackend(user, config, sessionInfo) {
+    const apiBaseUrl = getSessionLensApiBaseUrl();
+    try {
+        const response = await fetch(`${apiBaseUrl}/identify`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${config.sdk_key}`
+            },
+            body: JSON.stringify({
+                org_id: config.org_id,
+                project_id: sessionInfo.project_id,
+                user_id: user.user_id,
+                session_id: sessionInfo.session_id,
+                client_id: sessionInfo.client_id,
+                session_started_at: sessionInfo.started_at,
+                properties: user.properties
+            })
+        });
+        if (!response.ok && config.debug) {
+            console.warn('SessionLens: Failed to send identify:', response.status);
+        }
+        else if (config.debug) {
+            console.log('SessionLens: Identify sent successfully with session context');
+        }
+    }
+    catch (error) {
+        if (config.debug) {
+            console.warn('SessionLens: Network error sending identify:', error);
+        }
+    }
+}
+async function sendResetToBackend(config, sessionInfo) {
+    const apiBaseUrl = getSessionLensApiBaseUrl();
+    try {
+        const response = await fetch(`${apiBaseUrl}/reset`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${config.sdk_key}`
+            },
+            body: JSON.stringify({
+                org_id: config.org_id,
+                project_id: sessionInfo.project_id,
+                user_id: config.user_id,
+                session_id: sessionInfo.session_id,
+                client_id: sessionInfo.client_id,
+                session_started_at: sessionInfo.started_at
+            })
+        });
+        if (!response.ok && config.debug) {
+            console.warn('SessionLens: Failed to send reset:', response.status);
+        }
+        else if (config.debug) {
+            console.log('SessionLens: Reset sent successfully with session context');
+        }
+    }
+    catch (error) {
+        if (config.debug) {
+            console.warn('SessionLens: Network error sending reset:', error);
+        }
+    }
+}
+
+const useSessionLens = (config) => {
+    useEffect(() => {
+        // Initialize SDK asynchronously
+        const initializeSDK = async () => {
+            try {
+                await sessionLensInit(config);
+            }
+            catch (error) {
+                console.error('[SessionLens] Initialization failed:', error);
+            }
+        };
+        initializeSDK();
+        // Cleanup on unmount
+        return () => {
+            sessionLensReset();
+        };
+    }, [config]);
+};
+const useSessionLensTrack = () => {
+    return (event) => {
+        try {
+            sessionLensTrack(event);
+        }
+        catch (error) {
+            console.error('[SessionLens] Track failed:', error);
+        }
+    };
+};
+const useSessionLensIdentify = () => {
+    return (user) => {
+        try {
+            sessionLensIdentify(user);
+        }
+        catch (error) {
+            console.error('[SessionLens] Identify failed:', error);
+        }
+    };
+};
+
+class SessionLens {
+    async sessionLensInit(config) {
+        await sessionLensInit(config);
+    }
+    sessionLensTrack(event) {
+        sessionLensTrack(event);
+    }
+    sessionLensIdentify(user) {
+        sessionLensIdentify(user);
+    }
+    sessionLensReset() {
+        sessionLensReset();
+    }
+}
+// Create and export singleton instance
+const sessionLens = new SessionLens();
+
+export { sessionLens as default, useSessionLens, useSessionLensIdentify, useSessionLensTrack };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/core/config.ts","../src/core/tracker.ts","../src/integrations/react.ts","../src/index.ts"],"sourcesContent":["export interface SessionLensConfig {\n  sdk_key: string;\n  user_id: string;\n  org_id: string;\n  project_id?: string; // Optional: extracted from SDK key if not provided\n  debug?: boolean;\n}\n\n// Production-ready session management interface\ninterface SessionInfo {\n  session_id: string;\n  client_id: string;\n  org_id: string;\n  project_id: string;\n  user_id: string;\n  started_at: number;\n  last_activity: number;\n}\n\n// Session timeout (30 minutes of inactivity)\nconst SESSION_TIMEOUT = 30 * 60 * 1000;\n\n// Store the config and session info\nlet currentConfig: SessionLensConfig | null = null;\nlet currentSession: SessionInfo | null = null;\n\n// Extract project ID from SDK key pattern: sdk_prod_0000_684f15_5e0e72ac_35d2\nconst extractProjectFromSDKKey = (sdk_key: string): string => {\n  const parts = sdk_key.split('_');\n  return parts.length >= 4 ? `proj_${parts[3]}` : 'default';\n};\n\n// Generate crypto-grade unique IDs with hierarchical structure\nconst generateUniqueId = (config: SessionLensConfig, prefix: string): string => {\n  const timestamp = Date.now();\n  const project_id = config.project_id || extractProjectFromSDKKey(config.sdk_key);\n  \n  // Use crypto.randomUUID() for true uniqueness, fallback to secure random\n  const uuid = (() => {\n    if (typeof crypto !== 'undefined' && crypto.randomUUID) {\n      return crypto.randomUUID().replace(/-/g, '').substring(0, 12);\n    }\n    // Fallback: combine multiple random values for better entropy\n    const random1 = Math.random().toString(36).substring(2, 15);\n    const random2 = Math.random().toString(36).substring(2, 15);\n    return (random1 + random2).substring(0, 12);\n  })();\n  \n  // Format: {org_id}_{project_id}_{prefix}_{timestamp}_{uuid}\n  return `${config.org_id}_${project_id}_${prefix}_${timestamp}_${uuid}`;\n};\n\n// Get or create persistent client ID (per project)\nconst getOrCreateClientId = (config: SessionLensConfig): string => {\n  const project_id = config.project_id || extractProjectFromSDKKey(config.sdk_key);\n  const storageKey = `sessionlens_client_${config.org_id}_${project_id}`;\n  \n  if (typeof window !== 'undefined' && window.localStorage) {\n    try {\n      let clientId = localStorage.getItem(storageKey);\n      if (!clientId) {\n        clientId = generateUniqueId(config, 'client');\n        localStorage.setItem(storageKey, clientId);\n      }\n      return clientId;\n    } catch (error) {\n      // localStorage might be disabled, fallback to session-only ID\n      return generateUniqueId(config, 'client');\n    }\n  }\n  \n  // Fallback for non-browser environments\n  return generateUniqueId(config, 'client');\n};\n\n// Start new session with collision-proof IDs\nconst startNewSession = (config: SessionLensConfig): void => {\n  const now = Date.now();\n  const project_id = config.project_id || extractProjectFromSDKKey(config.sdk_key);\n  \n  currentSession = {\n    session_id: generateUniqueId(config, 'sess'),\n    client_id: getOrCreateClientId(config),\n    org_id: config.org_id,\n    project_id: project_id,\n    user_id: config.user_id,\n    started_at: now,\n    last_activity: now\n  };\n  \n  if (config.debug) {\n    console.log('SessionLens: New session started', {\n      session_id: currentSession.session_id,\n      client_id: currentSession.client_id,\n      project_id: currentSession.project_id\n    });\n  }\n};\n\n// Check if session is expired\nconst isSessionExpired = (): boolean => {\n  if (!currentSession) return true;\n  return Date.now() - currentSession.last_activity > SESSION_TIMEOUT;\n};\n\n// Update session activity timestamp\nconst updateSessionActivity = (): void => {\n  if (currentSession) {\n    currentSession.last_activity = Date.now();\n  }\n};\n\n// Get API base URL from environment variable or use default\nconst getApiBaseUrl = (): string => {\n  // Check for environment variable (works in Node.js and bundlers like Webpack/Vite)\n  if (typeof process !== 'undefined' && process.env) {\n    return process.env.SESSIONLENS_API_BASE_URL || process.env.REACT_APP_SESSIONLENS_API_BASE_URL || 'https://api.sessionlens.com/v1';\n  }\n  \n  // Fallback for browser environments without build-time env vars\n  return 'https://api.sessionlens.com/v1';\n};\n\n// `sessionLensInit()` sets the config and validates with backend\nexport async function sessionLensInit(config: SessionLensConfig): Promise<void> {\n  // Validate required fields\n  if (!config.sdk_key) {\n    throw new Error('[SessionLens] sdk_key is required');\n  }\n  if (!config.user_id) {\n    throw new Error('[SessionLens] user_id is required');\n  }\n  if (!config.org_id) {\n    throw new Error('[SessionLens] org_id is required');\n  }\n\n  // Store the configuration\n  currentConfig = config;\n\n  // Start new session with scalable ID generation\n  startNewSession(config);\n\n  // Validate configuration with backend using GET (more RESTful)\n  const apiBaseUrl = getApiBaseUrl();\n  \n  try {\n    // Use GET with query parameters for org_id and user_id validation\n    const validationUrl = new URL(`${apiBaseUrl}/org/validate`);\n    validationUrl.searchParams.set('org_id', config.org_id);\n    validationUrl.searchParams.set('user_id', config.user_id);\n    \n    const response = await fetch(validationUrl.toString(), {\n      method: 'GET',\n      headers: {\n        'Authorization': `Bearer ${config.sdk_key}`\n      }\n    });\n\n    if (!response.ok) {\n      switch (response.status) {\n        case 401:\n          throw new Error('Invalid SDK key. Please check your credentials.');\n        case 403:\n          throw new Error('Access denied. Please verify your organization permissions.');\n        case 404:\n          throw new Error('Organization not found. Please check your org_id.');\n        case 429:\n          throw new Error('Rate limit exceeded. Please try again later.');\n        default:\n          throw new Error(`Validation failed with status ${response.status}`);\n      }\n    }\n\n    const result = await response.json();\n    if (config.debug) {\n      console.log('SessionLens SDK initialized successfully:', result);\n      console.log('Using API base URL:', apiBaseUrl);\n      console.log('Validation endpoint:', validationUrl.toString());\n      console.log('Session Info:', currentSession);\n    }\n  } catch (error) {\n    if (error instanceof TypeError && error.message.includes('fetch')) {\n      // Network error - allow offline mode\n      if (config.debug) {\n        console.warn('SessionLens SDK: Running in offline mode due to network error');\n      }\n      return;\n    }\n    // Re-throw validation errors\n    throw error;\n  }\n}\n\n// `sessionLensGetConfig()` returns it later (for use in tracker, etc)\nexport function sessionLensGetConfig(): SessionLensConfig {\n  if (!currentConfig) {\n    throw new Error('[SessionLens] SDK not initialized. Call `sessionLensInit()` first.');\n  }\n  return currentConfig;\n}\n\n// Get current session info with auto-renewal and activity tracking\nexport function getSessionInfo(): SessionInfo {\n  if (!currentConfig) {\n    throw new Error('[SessionLens] SDK not initialized. Call `sessionLensInit()` first.');\n  }\n\n  // Check if session expired or doesn't exist\n  if (!currentSession || isSessionExpired()) {\n    startNewSession(currentConfig);\n  } else {\n    // Update activity timestamp\n    updateSessionActivity();\n  }\n\n  return currentSession!;\n}\n\n// Export function to get API base URL for use in other modules\nexport function getSessionLensApiBaseUrl(): string {\n  return getApiBaseUrl();\n} ","import { sessionLensGetConfig, getSessionLensApiBaseUrl, getSessionInfo } from './config';\nimport { SessionLensEvent, SessionLensUser } from '../types';\n\nexport function sessionLensTrack(event: SessionLensEvent): void {\n  const config = sessionLensGetConfig();\n  const sessionInfo = getSessionInfo(); // Get current session with activity update\n  \n  // Add timestamp if not provided\n  const eventWithTimestamp: SessionLensEvent = {\n    ...event,\n    timestamp: event.timestamp || Date.now()\n  };\n\n  if (config.debug) {\n    console.log('SessionLens Track:', eventWithTimestamp);\n    console.log('Session Context:', {\n      session_id: sessionInfo.session_id,\n      client_id: sessionInfo.client_id,\n      project_id: sessionInfo.project_id\n    });\n  }\n\n  // Send event to backend with session context\n  sendEventToBackend(eventWithTimestamp, config, sessionInfo);\n}\n\nexport function sessionLensIdentify(user: SessionLensUser): void {\n  const config = sessionLensGetConfig();\n  const sessionInfo = getSessionInfo(); // Get current session with activity update\n  \n  if (config.debug) {\n    console.log('SessionLens Identify:', user);\n    console.log('Session Context:', {\n      session_id: sessionInfo.session_id,\n      client_id: sessionInfo.client_id,\n      project_id: sessionInfo.project_id\n    });\n  }\n\n  // Send identify event to backend with session context\n  sendIdentifyToBackend(user, config, sessionInfo);\n}\n\nexport function sessionLensReset(): void {\n  const config = sessionLensGetConfig();\n  const sessionInfo = getSessionInfo(); // Get current session with activity update\n  \n  if (config.debug) {\n    console.log('SessionLens Reset');\n    console.log('Session Context:', {\n      session_id: sessionInfo.session_id,\n      client_id: sessionInfo.client_id,\n      project_id: sessionInfo.project_id\n    });\n  }\n\n  // Clear any stored user data and send reset event to backend\n  sendResetToBackend(config, sessionInfo);\n}\n\n// Helper functions for backend communication with session context\nasync function sendEventToBackend(event: SessionLensEvent, config: any, sessionInfo: any): Promise<void> {\n  const apiBaseUrl = getSessionLensApiBaseUrl();\n  \n  try {\n    const response = await fetch(`${apiBaseUrl}/events/ingest`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'Authorization': `Bearer ${config.sdk_key}`\n      },\n      body: JSON.stringify({\n        org_id: config.org_id,\n        project_id: sessionInfo.project_id,\n        user_id: config.user_id,\n        session_id: sessionInfo.session_id,\n        client_id: sessionInfo.client_id,\n        session_started_at: sessionInfo.started_at,\n        event: event\n      })\n    });\n\n    if (!response.ok && config.debug) {\n      console.warn('SessionLens: Failed to send event:', response.status);\n    } else if (config.debug) {\n      console.log('SessionLens: Event sent successfully with session context');\n    }\n  } catch (error) {\n    if (config.debug) {\n      console.warn('SessionLens: Network error sending event:', error);\n    }\n  }\n}\n\nasync function sendIdentifyToBackend(user: SessionLensUser, config: any, sessionInfo: any): Promise<void> {\n  const apiBaseUrl = getSessionLensApiBaseUrl();\n  \n  try {\n    const response = await fetch(`${apiBaseUrl}/identify`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'Authorization': `Bearer ${config.sdk_key}`\n      },\n      body: JSON.stringify({\n        org_id: config.org_id,\n        project_id: sessionInfo.project_id,\n        user_id: user.user_id,\n        session_id: sessionInfo.session_id,\n        client_id: sessionInfo.client_id,\n        session_started_at: sessionInfo.started_at,\n        properties: user.properties\n      })\n    });\n\n    if (!response.ok && config.debug) {\n      console.warn('SessionLens: Failed to send identify:', response.status);\n    } else if (config.debug) {\n      console.log('SessionLens: Identify sent successfully with session context');\n    }\n  } catch (error) {\n    if (config.debug) {\n      console.warn('SessionLens: Network error sending identify:', error);\n    }\n  }\n}\n\nasync function sendResetToBackend(config: any, sessionInfo: any): Promise<void> {\n  const apiBaseUrl = getSessionLensApiBaseUrl();\n  \n  try {\n    const response = await fetch(`${apiBaseUrl}/reset`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'Authorization': `Bearer ${config.sdk_key}`\n      },\n      body: JSON.stringify({\n        org_id: config.org_id,\n        project_id: sessionInfo.project_id,\n        user_id: config.user_id,\n        session_id: sessionInfo.session_id,\n        client_id: sessionInfo.client_id,\n        session_started_at: sessionInfo.started_at\n      })\n    });\n\n    if (!response.ok && config.debug) {\n      console.warn('SessionLens: Failed to send reset:', response.status);\n    } else if (config.debug) {\n      console.log('SessionLens: Reset sent successfully with session context');\n    }\n  } catch (error) {\n    if (config.debug) {\n      console.warn('SessionLens: Network error sending reset:', error);\n    }\n  }\n} ","import { useEffect } from 'react';\nimport { SessionLensEvent, SessionLensUser } from '../types';\nimport { sessionLensInit, SessionLensConfig } from '../core/config';\nimport { sessionLensTrack, sessionLensIdentify, sessionLensReset } from '../core/tracker';\n\nexport const useSessionLens = (config: SessionLensConfig) => {\n  useEffect(() => {\n    // Initialize SDK asynchronously\n    const initializeSDK = async () => {\n      try {\n        await sessionLensInit(config);\n      } catch (error) {\n        console.error('[SessionLens] Initialization failed:', error);\n      }\n    };\n\n    initializeSDK();\n\n    // Cleanup on unmount\n    return () => {\n      sessionLensReset();\n    };\n  }, [config]);\n};\n\nexport const useSessionLensTrack = () => {\n  return (event: SessionLensEvent) => {\n    try {\n      sessionLensTrack(event);\n    } catch (error) {\n      console.error('[SessionLens] Track failed:', error);\n    }\n  };\n};\n\nexport const useSessionLensIdentify = () => {\n  return (user: SessionLensUser) => {\n    try {\n      sessionLensIdentify(user);\n    } catch (error) {\n      console.error('[SessionLens] Identify failed:', error);\n    }\n  };\n}; ","import { sessionLensInit, SessionLensConfig } from './core/config';\nimport { sessionLensTrack, sessionLensIdentify, sessionLensReset } from './core/tracker';\nimport { SessionLensEvent, SessionLensUser, SessionLensInstance } from './types';\n\n// Export types\nexport * from './types';\nexport { SessionLensConfig } from './core/config';\n\n// Export React hooks\nexport * from './integrations/react';\n\nclass SessionLens implements SessionLensInstance {\n  public async sessionLensInit(config: SessionLensConfig): Promise<void> {\n    await sessionLensInit(config);\n  }\n\n  public sessionLensTrack(event: SessionLensEvent): void {\n    sessionLensTrack(event);\n  }\n\n  public sessionLensIdentify(user: SessionLensUser): void {\n    sessionLensIdentify(user);\n  }\n\n  public sessionLensReset(): void {\n    sessionLensReset();\n  }\n}\n\n// Create and export singleton instance\nconst sessionLens = new SessionLens();\nexport default sessionLens; "],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,391 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var react = require('react');
+
+// Session timeout (30 minutes of inactivity)
+const SESSION_TIMEOUT = 30 * 60 * 1000;
+// Store the config and session info
+let currentConfig = null;
+let currentSession = null;
+// Extract project ID from SDK key pattern: sdk_prod_0000_684f15_5e0e72ac_35d2
+const extractProjectFromSDKKey = (sdk_key) => {
+    const parts = sdk_key.split('_');
+    return parts.length >= 4 ? `proj_${parts[3]}` : 'default';
+};
+// Generate crypto-grade unique IDs with hierarchical structure
+const generateUniqueId = (config, prefix) => {
+    const timestamp = Date.now();
+    const project_id = config.project_id || extractProjectFromSDKKey(config.sdk_key);
+    // Use crypto.randomUUID() for true uniqueness, fallback to secure random
+    const uuid = (() => {
+        if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+            return crypto.randomUUID().replace(/-/g, '').substring(0, 12);
+        }
+        // Fallback: combine multiple random values for better entropy
+        const random1 = Math.random().toString(36).substring(2, 15);
+        const random2 = Math.random().toString(36).substring(2, 15);
+        return (random1 + random2).substring(0, 12);
+    })();
+    // Format: {org_id}_{project_id}_{prefix}_{timestamp}_{uuid}
+    return `${config.org_id}_${project_id}_${prefix}_${timestamp}_${uuid}`;
+};
+// Get or create persistent client ID (per project)
+const getOrCreateClientId = (config) => {
+    const project_id = config.project_id || extractProjectFromSDKKey(config.sdk_key);
+    const storageKey = `sessionlens_client_${config.org_id}_${project_id}`;
+    if (typeof window !== 'undefined' && window.localStorage) {
+        try {
+            let clientId = localStorage.getItem(storageKey);
+            if (!clientId) {
+                clientId = generateUniqueId(config, 'client');
+                localStorage.setItem(storageKey, clientId);
+            }
+            return clientId;
+        }
+        catch (error) {
+            // localStorage might be disabled, fallback to session-only ID
+            return generateUniqueId(config, 'client');
+        }
+    }
+    // Fallback for non-browser environments
+    return generateUniqueId(config, 'client');
+};
+// Start new session with collision-proof IDs
+const startNewSession = (config) => {
+    const now = Date.now();
+    const project_id = config.project_id || extractProjectFromSDKKey(config.sdk_key);
+    currentSession = {
+        session_id: generateUniqueId(config, 'sess'),
+        client_id: getOrCreateClientId(config),
+        org_id: config.org_id,
+        project_id: project_id,
+        user_id: config.user_id,
+        started_at: now,
+        last_activity: now
+    };
+    if (config.debug) {
+        console.log('SessionLens: New session started', {
+            session_id: currentSession.session_id,
+            client_id: currentSession.client_id,
+            project_id: currentSession.project_id
+        });
+    }
+};
+// Check if session is expired
+const isSessionExpired = () => {
+    if (!currentSession)
+        return true;
+    return Date.now() - currentSession.last_activity > SESSION_TIMEOUT;
+};
+// Update session activity timestamp
+const updateSessionActivity = () => {
+    if (currentSession) {
+        currentSession.last_activity = Date.now();
+    }
+};
+// Get API base URL from environment variable or use default
+const getApiBaseUrl = () => {
+    // Check for environment variable (works in Node.js and bundlers like Webpack/Vite)
+    if (typeof process !== 'undefined' && process.env) {
+        return process.env.SESSIONLENS_API_BASE_URL || process.env.REACT_APP_SESSIONLENS_API_BASE_URL || 'https://api.sessionlens.com/v1';
+    }
+    // Fallback for browser environments without build-time env vars
+    return 'https://api.sessionlens.com/v1';
+};
+// `sessionLensInit()` sets the config and validates with backend
+async function sessionLensInit(config) {
+    // Validate required fields
+    if (!config.sdk_key) {
+        throw new Error('[SessionLens] sdk_key is required');
+    }
+    if (!config.user_id) {
+        throw new Error('[SessionLens] user_id is required');
+    }
+    if (!config.org_id) {
+        throw new Error('[SessionLens] org_id is required');
+    }
+    // Store the configuration
+    currentConfig = config;
+    // Start new session with scalable ID generation
+    startNewSession(config);
+    // Validate configuration with backend using GET (more RESTful)
+    const apiBaseUrl = getApiBaseUrl();
+    try {
+        // Use GET with query parameters for org_id and user_id validation
+        const validationUrl = new URL(`${apiBaseUrl}/org/validate`);
+        validationUrl.searchParams.set('org_id', config.org_id);
+        validationUrl.searchParams.set('user_id', config.user_id);
+        const response = await fetch(validationUrl.toString(), {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${config.sdk_key}`
+            }
+        });
+        if (!response.ok) {
+            switch (response.status) {
+                case 401:
+                    throw new Error('Invalid SDK key. Please check your credentials.');
+                case 403:
+                    throw new Error('Access denied. Please verify your organization permissions.');
+                case 404:
+                    throw new Error('Organization not found. Please check your org_id.');
+                case 429:
+                    throw new Error('Rate limit exceeded. Please try again later.');
+                default:
+                    throw new Error(`Validation failed with status ${response.status}`);
+            }
+        }
+        const result = await response.json();
+        if (config.debug) {
+            console.log('SessionLens SDK initialized successfully:', result);
+            console.log('Using API base URL:', apiBaseUrl);
+            console.log('Validation endpoint:', validationUrl.toString());
+            console.log('Session Info:', currentSession);
+        }
+    }
+    catch (error) {
+        if (error instanceof TypeError && error.message.includes('fetch')) {
+            // Network error - allow offline mode
+            if (config.debug) {
+                console.warn('SessionLens SDK: Running in offline mode due to network error');
+            }
+            return;
+        }
+        // Re-throw validation errors
+        throw error;
+    }
+}
+// `sessionLensGetConfig()` returns it later (for use in tracker, etc)
+function sessionLensGetConfig() {
+    if (!currentConfig) {
+        throw new Error('[SessionLens] SDK not initialized. Call `sessionLensInit()` first.');
+    }
+    return currentConfig;
+}
+// Get current session info with auto-renewal and activity tracking
+function getSessionInfo() {
+    if (!currentConfig) {
+        throw new Error('[SessionLens] SDK not initialized. Call `sessionLensInit()` first.');
+    }
+    // Check if session expired or doesn't exist
+    if (!currentSession || isSessionExpired()) {
+        startNewSession(currentConfig);
+    }
+    else {
+        // Update activity timestamp
+        updateSessionActivity();
+    }
+    return currentSession;
+}
+// Export function to get API base URL for use in other modules
+function getSessionLensApiBaseUrl() {
+    return getApiBaseUrl();
+}
+
+function sessionLensTrack(event) {
+    const config = sessionLensGetConfig();
+    const sessionInfo = getSessionInfo(); // Get current session with activity update
+    // Add timestamp if not provided
+    const eventWithTimestamp = {
+        ...event,
+        timestamp: event.timestamp || Date.now()
+    };
+    if (config.debug) {
+        console.log('SessionLens Track:', eventWithTimestamp);
+        console.log('Session Context:', {
+            session_id: sessionInfo.session_id,
+            client_id: sessionInfo.client_id,
+            project_id: sessionInfo.project_id
+        });
+    }
+    // Send event to backend with session context
+    sendEventToBackend(eventWithTimestamp, config, sessionInfo);
+}
+function sessionLensIdentify(user) {
+    const config = sessionLensGetConfig();
+    const sessionInfo = getSessionInfo(); // Get current session with activity update
+    if (config.debug) {
+        console.log('SessionLens Identify:', user);
+        console.log('Session Context:', {
+            session_id: sessionInfo.session_id,
+            client_id: sessionInfo.client_id,
+            project_id: sessionInfo.project_id
+        });
+    }
+    // Send identify event to backend with session context
+    sendIdentifyToBackend(user, config, sessionInfo);
+}
+function sessionLensReset() {
+    const config = sessionLensGetConfig();
+    const sessionInfo = getSessionInfo(); // Get current session with activity update
+    if (config.debug) {
+        console.log('SessionLens Reset');
+        console.log('Session Context:', {
+            session_id: sessionInfo.session_id,
+            client_id: sessionInfo.client_id,
+            project_id: sessionInfo.project_id
+        });
+    }
+    // Clear any stored user data and send reset event to backend
+    sendResetToBackend(config, sessionInfo);
+}
+// Helper functions for backend communication with session context
+async function sendEventToBackend(event, config, sessionInfo) {
+    const apiBaseUrl = getSessionLensApiBaseUrl();
+    try {
+        const response = await fetch(`${apiBaseUrl}/events/ingest`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${config.sdk_key}`
+            },
+            body: JSON.stringify({
+                org_id: config.org_id,
+                project_id: sessionInfo.project_id,
+                user_id: config.user_id,
+                session_id: sessionInfo.session_id,
+                client_id: sessionInfo.client_id,
+                session_started_at: sessionInfo.started_at,
+                event: event
+            })
+        });
+        if (!response.ok && config.debug) {
+            console.warn('SessionLens: Failed to send event:', response.status);
+        }
+        else if (config.debug) {
+            console.log('SessionLens: Event sent successfully with session context');
+        }
+    }
+    catch (error) {
+        if (config.debug) {
+            console.warn('SessionLens: Network error sending event:', error);
+        }
+    }
+}
+async function sendIdentifyToBackend(user, config, sessionInfo) {
+    const apiBaseUrl = getSessionLensApiBaseUrl();
+    try {
+        const response = await fetch(`${apiBaseUrl}/identify`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${config.sdk_key}`
+            },
+            body: JSON.stringify({
+                org_id: config.org_id,
+                project_id: sessionInfo.project_id,
+                user_id: user.user_id,
+                session_id: sessionInfo.session_id,
+                client_id: sessionInfo.client_id,
+                session_started_at: sessionInfo.started_at,
+                properties: user.properties
+            })
+        });
+        if (!response.ok && config.debug) {
+            console.warn('SessionLens: Failed to send identify:', response.status);
+        }
+        else if (config.debug) {
+            console.log('SessionLens: Identify sent successfully with session context');
+        }
+    }
+    catch (error) {
+        if (config.debug) {
+            console.warn('SessionLens: Network error sending identify:', error);
+        }
+    }
+}
+async function sendResetToBackend(config, sessionInfo) {
+    const apiBaseUrl = getSessionLensApiBaseUrl();
+    try {
+        const response = await fetch(`${apiBaseUrl}/reset`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${config.sdk_key}`
+            },
+            body: JSON.stringify({
+                org_id: config.org_id,
+                project_id: sessionInfo.project_id,
+                user_id: config.user_id,
+                session_id: sessionInfo.session_id,
+                client_id: sessionInfo.client_id,
+                session_started_at: sessionInfo.started_at
+            })
+        });
+        if (!response.ok && config.debug) {
+            console.warn('SessionLens: Failed to send reset:', response.status);
+        }
+        else if (config.debug) {
+            console.log('SessionLens: Reset sent successfully with session context');
+        }
+    }
+    catch (error) {
+        if (config.debug) {
+            console.warn('SessionLens: Network error sending reset:', error);
+        }
+    }
+}
+
+const useSessionLens = (config) => {
+    react.useEffect(() => {
+        // Initialize SDK asynchronously
+        const initializeSDK = async () => {
+            try {
+                await sessionLensInit(config);
+            }
+            catch (error) {
+                console.error('[SessionLens] Initialization failed:', error);
+            }
+        };
+        initializeSDK();
+        // Cleanup on unmount
+        return () => {
+            sessionLensReset();
+        };
+    }, [config]);
+};
+const useSessionLensTrack = () => {
+    return (event) => {
+        try {
+            sessionLensTrack(event);
+        }
+        catch (error) {
+            console.error('[SessionLens] Track failed:', error);
+        }
+    };
+};
+const useSessionLensIdentify = () => {
+    return (user) => {
+        try {
+            sessionLensIdentify(user);
+        }
+        catch (error) {
+            console.error('[SessionLens] Identify failed:', error);
+        }
+    };
+};
+
+class SessionLens {
+    async sessionLensInit(config) {
+        await sessionLensInit(config);
+    }
+    sessionLensTrack(event) {
+        sessionLensTrack(event);
+    }
+    sessionLensIdentify(user) {
+        sessionLensIdentify(user);
+    }
+    sessionLensReset() {
+        sessionLensReset();
+    }
+}
+// Create and export singleton instance
+const sessionLens = new SessionLens();
+
+exports["default"] = sessionLens;
+exports.useSessionLens = useSessionLens;
+exports.useSessionLensIdentify = useSessionLensIdentify;
+exports.useSessionLensTrack = useSessionLensTrack;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/core/config.ts","../src/core/tracker.ts","../src/integrations/react.ts","../src/index.ts"],"sourcesContent":["export interface SessionLensConfig {\n  sdk_key: string;\n  user_id: string;\n  org_id: string;\n  project_id?: string; // Optional: extracted from SDK key if not provided\n  debug?: boolean;\n}\n\n// Production-ready session management interface\ninterface SessionInfo {\n  session_id: string;\n  client_id: string;\n  org_id: string;\n  project_id: string;\n  user_id: string;\n  started_at: number;\n  last_activity: number;\n}\n\n// Session timeout (30 minutes of inactivity)\nconst SESSION_TIMEOUT = 30 * 60 * 1000;\n\n// Store the config and session info\nlet currentConfig: SessionLensConfig | null = null;\nlet currentSession: SessionInfo | null = null;\n\n// Extract project ID from SDK key pattern: sdk_prod_0000_684f15_5e0e72ac_35d2\nconst extractProjectFromSDKKey = (sdk_key: string): string => {\n  const parts = sdk_key.split('_');\n  return parts.length >= 4 ? `proj_${parts[3]}` : 'default';\n};\n\n// Generate crypto-grade unique IDs with hierarchical structure\nconst generateUniqueId = (config: SessionLensConfig, prefix: string): string => {\n  const timestamp = Date.now();\n  const project_id = config.project_id || extractProjectFromSDKKey(config.sdk_key);\n  \n  // Use crypto.randomUUID() for true uniqueness, fallback to secure random\n  const uuid = (() => {\n    if (typeof crypto !== 'undefined' && crypto.randomUUID) {\n      return crypto.randomUUID().replace(/-/g, '').substring(0, 12);\n    }\n    // Fallback: combine multiple random values for better entropy\n    const random1 = Math.random().toString(36).substring(2, 15);\n    const random2 = Math.random().toString(36).substring(2, 15);\n    return (random1 + random2).substring(0, 12);\n  })();\n  \n  // Format: {org_id}_{project_id}_{prefix}_{timestamp}_{uuid}\n  return `${config.org_id}_${project_id}_${prefix}_${timestamp}_${uuid}`;\n};\n\n// Get or create persistent client ID (per project)\nconst getOrCreateClientId = (config: SessionLensConfig): string => {\n  const project_id = config.project_id || extractProjectFromSDKKey(config.sdk_key);\n  const storageKey = `sessionlens_client_${config.org_id}_${project_id}`;\n  \n  if (typeof window !== 'undefined' && window.localStorage) {\n    try {\n      let clientId = localStorage.getItem(storageKey);\n      if (!clientId) {\n        clientId = generateUniqueId(config, 'client');\n        localStorage.setItem(storageKey, clientId);\n      }\n      return clientId;\n    } catch (error) {\n      // localStorage might be disabled, fallback to session-only ID\n      return generateUniqueId(config, 'client');\n    }\n  }\n  \n  // Fallback for non-browser environments\n  return generateUniqueId(config, 'client');\n};\n\n// Start new session with collision-proof IDs\nconst startNewSession = (config: SessionLensConfig): void => {\n  const now = Date.now();\n  const project_id = config.project_id || extractProjectFromSDKKey(config.sdk_key);\n  \n  currentSession = {\n    session_id: generateUniqueId(config, 'sess'),\n    client_id: getOrCreateClientId(config),\n    org_id: config.org_id,\n    project_id: project_id,\n    user_id: config.user_id,\n    started_at: now,\n    last_activity: now\n  };\n  \n  if (config.debug) {\n    console.log('SessionLens: New session started', {\n      session_id: currentSession.session_id,\n      client_id: currentSession.client_id,\n      project_id: currentSession.project_id\n    });\n  }\n};\n\n// Check if session is expired\nconst isSessionExpired = (): boolean => {\n  if (!currentSession) return true;\n  return Date.now() - currentSession.last_activity > SESSION_TIMEOUT;\n};\n\n// Update session activity timestamp\nconst updateSessionActivity = (): void => {\n  if (currentSession) {\n    currentSession.last_activity = Date.now();\n  }\n};\n\n// Get API base URL from environment variable or use default\nconst getApiBaseUrl = (): string => {\n  // Check for environment variable (works in Node.js and bundlers like Webpack/Vite)\n  if (typeof process !== 'undefined' && process.env) {\n    return process.env.SESSIONLENS_API_BASE_URL || process.env.REACT_APP_SESSIONLENS_API_BASE_URL || 'https://api.sessionlens.com/v1';\n  }\n  \n  // Fallback for browser environments without build-time env vars\n  return 'https://api.sessionlens.com/v1';\n};\n\n// `sessionLensInit()` sets the config and validates with backend\nexport async function sessionLensInit(config: SessionLensConfig): Promise<void> {\n  // Validate required fields\n  if (!config.sdk_key) {\n    throw new Error('[SessionLens] sdk_key is required');\n  }\n  if (!config.user_id) {\n    throw new Error('[SessionLens] user_id is required');\n  }\n  if (!config.org_id) {\n    throw new Error('[SessionLens] org_id is required');\n  }\n\n  // Store the configuration\n  currentConfig = config;\n\n  // Start new session with scalable ID generation\n  startNewSession(config);\n\n  // Validate configuration with backend using GET (more RESTful)\n  const apiBaseUrl = getApiBaseUrl();\n  \n  try {\n    // Use GET with query parameters for org_id and user_id validation\n    const validationUrl = new URL(`${apiBaseUrl}/org/validate`);\n    validationUrl.searchParams.set('org_id', config.org_id);\n    validationUrl.searchParams.set('user_id', config.user_id);\n    \n    const response = await fetch(validationUrl.toString(), {\n      method: 'GET',\n      headers: {\n        'Authorization': `Bearer ${config.sdk_key}`\n      }\n    });\n\n    if (!response.ok) {\n      switch (response.status) {\n        case 401:\n          throw new Error('Invalid SDK key. Please check your credentials.');\n        case 403:\n          throw new Error('Access denied. Please verify your organization permissions.');\n        case 404:\n          throw new Error('Organization not found. Please check your org_id.');\n        case 429:\n          throw new Error('Rate limit exceeded. Please try again later.');\n        default:\n          throw new Error(`Validation failed with status ${response.status}`);\n      }\n    }\n\n    const result = await response.json();\n    if (config.debug) {\n      console.log('SessionLens SDK initialized successfully:', result);\n      console.log('Using API base URL:', apiBaseUrl);\n      console.log('Validation endpoint:', validationUrl.toString());\n      console.log('Session Info:', currentSession);\n    }\n  } catch (error) {\n    if (error instanceof TypeError && error.message.includes('fetch')) {\n      // Network error - allow offline mode\n      if (config.debug) {\n        console.warn('SessionLens SDK: Running in offline mode due to network error');\n      }\n      return;\n    }\n    // Re-throw validation errors\n    throw error;\n  }\n}\n\n// `sessionLensGetConfig()` returns it later (for use in tracker, etc)\nexport function sessionLensGetConfig(): SessionLensConfig {\n  if (!currentConfig) {\n    throw new Error('[SessionLens] SDK not initialized. Call `sessionLensInit()` first.');\n  }\n  return currentConfig;\n}\n\n// Get current session info with auto-renewal and activity tracking\nexport function getSessionInfo(): SessionInfo {\n  if (!currentConfig) {\n    throw new Error('[SessionLens] SDK not initialized. Call `sessionLensInit()` first.');\n  }\n\n  // Check if session expired or doesn't exist\n  if (!currentSession || isSessionExpired()) {\n    startNewSession(currentConfig);\n  } else {\n    // Update activity timestamp\n    updateSessionActivity();\n  }\n\n  return currentSession!;\n}\n\n// Export function to get API base URL for use in other modules\nexport function getSessionLensApiBaseUrl(): string {\n  return getApiBaseUrl();\n} ","import { sessionLensGetConfig, getSessionLensApiBaseUrl, getSessionInfo } from './config';\nimport { SessionLensEvent, SessionLensUser } from '../types';\n\nexport function sessionLensTrack(event: SessionLensEvent): void {\n  const config = sessionLensGetConfig();\n  const sessionInfo = getSessionInfo(); // Get current session with activity update\n  \n  // Add timestamp if not provided\n  const eventWithTimestamp: SessionLensEvent = {\n    ...event,\n    timestamp: event.timestamp || Date.now()\n  };\n\n  if (config.debug) {\n    console.log('SessionLens Track:', eventWithTimestamp);\n    console.log('Session Context:', {\n      session_id: sessionInfo.session_id,\n      client_id: sessionInfo.client_id,\n      project_id: sessionInfo.project_id\n    });\n  }\n\n  // Send event to backend with session context\n  sendEventToBackend(eventWithTimestamp, config, sessionInfo);\n}\n\nexport function sessionLensIdentify(user: SessionLensUser): void {\n  const config = sessionLensGetConfig();\n  const sessionInfo = getSessionInfo(); // Get current session with activity update\n  \n  if (config.debug) {\n    console.log('SessionLens Identify:', user);\n    console.log('Session Context:', {\n      session_id: sessionInfo.session_id,\n      client_id: sessionInfo.client_id,\n      project_id: sessionInfo.project_id\n    });\n  }\n\n  // Send identify event to backend with session context\n  sendIdentifyToBackend(user, config, sessionInfo);\n}\n\nexport function sessionLensReset(): void {\n  const config = sessionLensGetConfig();\n  const sessionInfo = getSessionInfo(); // Get current session with activity update\n  \n  if (config.debug) {\n    console.log('SessionLens Reset');\n    console.log('Session Context:', {\n      session_id: sessionInfo.session_id,\n      client_id: sessionInfo.client_id,\n      project_id: sessionInfo.project_id\n    });\n  }\n\n  // Clear any stored user data and send reset event to backend\n  sendResetToBackend(config, sessionInfo);\n}\n\n// Helper functions for backend communication with session context\nasync function sendEventToBackend(event: SessionLensEvent, config: any, sessionInfo: any): Promise<void> {\n  const apiBaseUrl = getSessionLensApiBaseUrl();\n  \n  try {\n    const response = await fetch(`${apiBaseUrl}/events/ingest`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'Authorization': `Bearer ${config.sdk_key}`\n      },\n      body: JSON.stringify({\n        org_id: config.org_id,\n        project_id: sessionInfo.project_id,\n        user_id: config.user_id,\n        session_id: sessionInfo.session_id,\n        client_id: sessionInfo.client_id,\n        session_started_at: sessionInfo.started_at,\n        event: event\n      })\n    });\n\n    if (!response.ok && config.debug) {\n      console.warn('SessionLens: Failed to send event:', response.status);\n    } else if (config.debug) {\n      console.log('SessionLens: Event sent successfully with session context');\n    }\n  } catch (error) {\n    if (config.debug) {\n      console.warn('SessionLens: Network error sending event:', error);\n    }\n  }\n}\n\nasync function sendIdentifyToBackend(user: SessionLensUser, config: any, sessionInfo: any): Promise<void> {\n  const apiBaseUrl = getSessionLensApiBaseUrl();\n  \n  try {\n    const response = await fetch(`${apiBaseUrl}/identify`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'Authorization': `Bearer ${config.sdk_key}`\n      },\n      body: JSON.stringify({\n        org_id: config.org_id,\n        project_id: sessionInfo.project_id,\n        user_id: user.user_id,\n        session_id: sessionInfo.session_id,\n        client_id: sessionInfo.client_id,\n        session_started_at: sessionInfo.started_at,\n        properties: user.properties\n      })\n    });\n\n    if (!response.ok && config.debug) {\n      console.warn('SessionLens: Failed to send identify:', response.status);\n    } else if (config.debug) {\n      console.log('SessionLens: Identify sent successfully with session context');\n    }\n  } catch (error) {\n    if (config.debug) {\n      console.warn('SessionLens: Network error sending identify:', error);\n    }\n  }\n}\n\nasync function sendResetToBackend(config: any, sessionInfo: any): Promise<void> {\n  const apiBaseUrl = getSessionLensApiBaseUrl();\n  \n  try {\n    const response = await fetch(`${apiBaseUrl}/reset`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'Authorization': `Bearer ${config.sdk_key}`\n      },\n      body: JSON.stringify({\n        org_id: config.org_id,\n        project_id: sessionInfo.project_id,\n        user_id: config.user_id,\n        session_id: sessionInfo.session_id,\n        client_id: sessionInfo.client_id,\n        session_started_at: sessionInfo.started_at\n      })\n    });\n\n    if (!response.ok && config.debug) {\n      console.warn('SessionLens: Failed to send reset:', response.status);\n    } else if (config.debug) {\n      console.log('SessionLens: Reset sent successfully with session context');\n    }\n  } catch (error) {\n    if (config.debug) {\n      console.warn('SessionLens: Network error sending reset:', error);\n    }\n  }\n} ","import { useEffect } from 'react';\nimport { SessionLensEvent, SessionLensUser } from '../types';\nimport { sessionLensInit, SessionLensConfig } from '../core/config';\nimport { sessionLensTrack, sessionLensIdentify, sessionLensReset } from '../core/tracker';\n\nexport const useSessionLens = (config: SessionLensConfig) => {\n  useEffect(() => {\n    // Initialize SDK asynchronously\n    const initializeSDK = async () => {\n      try {\n        await sessionLensInit(config);\n      } catch (error) {\n        console.error('[SessionLens] Initialization failed:', error);\n      }\n    };\n\n    initializeSDK();\n\n    // Cleanup on unmount\n    return () => {\n      sessionLensReset();\n    };\n  }, [config]);\n};\n\nexport const useSessionLensTrack = () => {\n  return (event: SessionLensEvent) => {\n    try {\n      sessionLensTrack(event);\n    } catch (error) {\n      console.error('[SessionLens] Track failed:', error);\n    }\n  };\n};\n\nexport const useSessionLensIdentify = () => {\n  return (user: SessionLensUser) => {\n    try {\n      sessionLensIdentify(user);\n    } catch (error) {\n      console.error('[SessionLens] Identify failed:', error);\n    }\n  };\n}; ","import { sessionLensInit, SessionLensConfig } from './core/config';\nimport { sessionLensTrack, sessionLensIdentify, sessionLensReset } from './core/tracker';\nimport { SessionLensEvent, SessionLensUser, SessionLensInstance } from './types';\n\n// Export types\nexport * from './types';\nexport { SessionLensConfig } from './core/config';\n\n// Export React hooks\nexport * from './integrations/react';\n\nclass SessionLens implements SessionLensInstance {\n  public async sessionLensInit(config: SessionLensConfig): Promise<void> {\n    await sessionLensInit(config);\n  }\n\n  public sessionLensTrack(event: SessionLensEvent): void {\n    sessionLensTrack(event);\n  }\n\n  public sessionLensIdentify(user: SessionLensUser): void {\n    sessionLensIdentify(user);\n  }\n\n  public sessionLensReset(): void {\n    sessionLensReset();\n  }\n}\n\n// Create and export singleton instance\nconst sessionLens = new SessionLens();\nexport default sessionLens; "],"names":["useEffect"],"mappings":"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"}

package/dist/integrations/react.d.ts

@@ -0,0 +1,5 @@
+import { SessionLensEvent, SessionLensUser } from '../types';
+import { SessionLensConfig } from '../core/config';
+export declare const useSessionLens: (config: SessionLensConfig) => void;
+export declare const useSessionLensTrack: () => (event: SessionLensEvent) => void;
+export declare const useSessionLensIdentify: () => (user: SessionLensUser) => void;

package/dist/types.d.ts

@@ -0,0 +1,15 @@
+export interface SessionLensEvent {
+    event_name: string;
+    properties?: Record<string, any>;
+    timestamp?: number;
+}
+export interface SessionLensUser {
+    user_id: string;
+    properties?: Record<string, any>;
+}
+export interface SessionLensInstance {
+    sessionLensInit: (config: import('./core/config').SessionLensConfig) => Promise<void>;
+    sessionLensTrack: (event: SessionLensEvent) => void;
+    sessionLensIdentify: (user: SessionLensUser) => void;
+    sessionLensReset: () => void;
+}

package/dist/utils/logger.d.ts

@@ -0,0 +1,9 @@
+export declare class Logger {
+    private static instance;
+    private constructor();
+    static getInstance(): Logger;
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@sessionlens/sdk",
+  "version": "0.1.0",
+  "description": "SessionLens SDK for analytics and event tracking",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "test": "jest",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "analytics",
+    "tracking",
+    "events"
+  ],
+  "author": "SessionLens",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/react": "^18.3.14",
+    "@typescript-eslint/eslint-plugin": "^5.59.0",
+    "@typescript-eslint/parser": "^5.59.0",
+    "eslint": "^8.38.0",
+    "jest": "^29.5.0",
+    "prettier": "^2.8.7",
+    "react": "^19.1.0",
+    "rollup": "^2.79.1",
+    "rollup-plugin-typescript2": "^0.31.2",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.0.4"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  }
+}