@scalebun/react-native 1.0.1 → 1.0.2

package/src/core/constants/timings.ts

@@ -1,23 +1,23 @@
-/**
- * ScaleBun SDK — Timing & Transport Constants
- *
- * Named exports for every magic number in the SDK debug transport layer.
- * Import from here instead of using inline literals.
- */
-
-export { DEFAULT_HEARTBEAT_INTERVAL_MS } from '../../vendor/protocol';
-
-/** Default WebSocket port when no port is specified in DebugConfig */
-export const DEFAULT_WS_PORT = 9333;
-/** Maximum messages to buffer in transport while disconnected */
-export const TRANSPORT_MAX_BUFFER_SIZE = 500;
-/** Give up reconnecting after this many failed attempts */
-export const TRANSPORT_MAX_RECONNECT_ATTEMPTS = 20;
-/** Base delay (ms) for exponential reconnect backoff */
-export const TRANSPORT_RECONNECT_BASE_MS = 250;
-/** Maximum delay (ms) cap for exponential reconnect backoff */
-export const TRANSPORT_RECONNECT_MAX_MS = 5000;
-/** Pong round-trip threshold (ms) above which a high-latency warning is logged */
-export const TRANSPORT_HIGH_LATENCY_WARN_MS = 1000;
-/** Delay (ms) before emitting debug_ready after connection is established */
-export const DEBUG_READY_EMIT_DELAY_MS = 500;
+/**
+ * ScaleBun SDK — Timing & Transport Constants
+ *
+ * Named exports for every magic number in the SDK debug transport layer.
+ * Import from here instead of using inline literals.
+ */
+
+export { DEFAULT_HEARTBEAT_INTERVAL_MS } from '../../vendor/protocol';
+
+/** Default WebSocket port when no port is specified in DebugConfig */
+export const DEFAULT_WS_PORT = 9333;
+/** Maximum messages to buffer in transport while disconnected */
+export const TRANSPORT_MAX_BUFFER_SIZE = 500;
+/** Give up reconnecting after this many failed attempts */
+export const TRANSPORT_MAX_RECONNECT_ATTEMPTS = 20;
+/** Base delay (ms) for exponential reconnect backoff */
+export const TRANSPORT_RECONNECT_BASE_MS = 250;
+/** Maximum delay (ms) cap for exponential reconnect backoff */
+export const TRANSPORT_RECONNECT_MAX_MS = 5000;
+/** Pong round-trip threshold (ms) above which a high-latency warning is logged */
+export const TRANSPORT_HIGH_LATENCY_WARN_MS = 1000;
+/** Delay (ms) before emitting debug_ready after connection is established */
+export const DEBUG_READY_EMIT_DELAY_MS = 500;

package/src/core/constants/version.ts

@@ -1,6 +1,6 @@
-/**
- * ScaleBun SDK version. Sent with the session-start envelope so the dashboard
- * can attribute telemetry to the SDK build that produced it.
- * Keep in sync with package.json "version".
- */
-export const SDK_VERSION = '0.1.0-beta.1';
+/**
+ * ScaleBun SDK version. Sent with the session-start envelope so the dashboard
+ * can attribute telemetry to the SDK build that produced it.
+ * Keep in sync with package.json "version".
+ */
+export const SDK_VERSION = '0.1.0-beta.1';

package/src/core/context/user.ts

@@ -1,26 +1,26 @@
-export interface UserContext {
-    id?: string;
-    email?: string;
-    name?: string;
-    [key: string]: any;
-}
-
-export interface AppContext {
-    name?: string;
-    version?: string;
-    build?: string;
-    bundleId?: string;
-}
-
-export interface DeviceContext {
-    id: string;
-    model?: string;
-    os?: string;
-    osVersion?: string;
-    locale?: string;
-}
-
-export interface SessionContext {
-    id: string;
-    startTime: number;
-}
+export interface UserContext {
+    id?: string;
+    email?: string;
+    name?: string;
+    [key: string]: any;
+}
+
+export interface AppContext {
+    name?: string;
+    version?: string;
+    build?: string;
+    bundleId?: string;
+}
+
+export interface DeviceContext {
+    id: string;
+    model?: string;
+    os?: string;
+    osVersion?: string;
+    locale?: string;
+}
+
+export interface SessionContext {
+    id: string;
+    startTime: number;
+}

package/src/core/contracts/IFeature.ts

@@ -1,53 +1,53 @@
-/**
- * ScaleBun SDK — Feature Contract
- *
- * Interface for pluggable SDK features (replay, network, crash, etc.).
- * Each feature follows the same lifecycle: register → initialize → teardown.
- *
- * SOLID: Interface Segregation — features only implement what they need.
- * SOLID: Open/Closed — new features are added by implementing this interface.
- *
- * Canonical source: @scalebun/sdk-contracts/features
- */
-
-/** Context provided to features during initialization */
-export interface FeatureContext {
-    /** Track an event through the SDK pipeline */
-    trackEvent: (name: string, payload?: Record<string, unknown>) => void;
-    /** Get the debug stream (if debug is enabled) */
-    getDebugStream: () => unknown | null;
-    /** App lifecycle state */
-    getAppState: () => 'active' | 'background' | 'inactive';
-}
-
-/**
- * Contract for SDK features.
- *
- * Each feature module (network monitoring, crash reporting, replay, etc.)
- * implements this interface and registers itself with the FeatureRegistry.
- */
-export interface IFeature {
-    /** Unique feature name (e.g. 'network', 'crash', 'replay') */
-    readonly name: string;
-
-    /**
-     * Initialize the feature with the provided context.
-     * May be async for features that need native module setup.
-     */
-    initialize(context: FeatureContext): void | Promise<void>;
-
-    /**
-     * Tear down the feature and release all resources.
-     * Must be synchronous and safe to call multiple times.
-     */
-    teardown(): void;
-
-    /** Whether the feature is currently active */
-    readonly isActive: boolean;
-}
-
-// Re-export from contracts — consumers can migrate to new import path
-export type {
-    IFeature as ContractIFeature,
-    FeatureContext as ContractFeatureContext,
-} from '../../vendor/sdk-contracts';
+/**
+ * ScaleBun SDK — Feature Contract
+ *
+ * Interface for pluggable SDK features (replay, network, crash, etc.).
+ * Each feature follows the same lifecycle: register → initialize → teardown.
+ *
+ * SOLID: Interface Segregation — features only implement what they need.
+ * SOLID: Open/Closed — new features are added by implementing this interface.
+ *
+ * Canonical source: @scalebun/sdk-contracts/features
+ */
+
+/** Context provided to features during initialization */
+export interface FeatureContext {
+    /** Track an event through the SDK pipeline */
+    trackEvent: (name: string, payload?: Record<string, unknown>) => void;
+    /** Get the debug stream (if debug is enabled) */
+    getDebugStream: () => unknown | null;
+    /** App lifecycle state */
+    getAppState: () => 'active' | 'background' | 'inactive';
+}
+
+/**
+ * Contract for SDK features.
+ *
+ * Each feature module (network monitoring, crash reporting, replay, etc.)
+ * implements this interface and registers itself with the FeatureRegistry.
+ */
+export interface IFeature {
+    /** Unique feature name (e.g. 'network', 'crash', 'replay') */
+    readonly name: string;
+
+    /**
+     * Initialize the feature with the provided context.
+     * May be async for features that need native module setup.
+     */
+    initialize(context: FeatureContext): void | Promise<void>;
+
+    /**
+     * Tear down the feature and release all resources.
+     * Must be synchronous and safe to call multiple times.
+     */
+    teardown(): void;
+
+    /** Whether the feature is currently active */
+    readonly isActive: boolean;
+}
+
+// Re-export from contracts — consumers can migrate to new import path
+export type {
+    IFeature as ContractIFeature,
+    FeatureContext as ContractFeatureContext,
+} from '../../vendor/sdk-contracts';

package/src/core/di/container.ts

@@ -1,26 +1,26 @@
-export class Container {
-    private services = new Map<string, any>();
-
-    register<T>(key: string, instance: T): T {
-        this.services.set(key, instance);
-        return instance;
-    }
-
-    get<T>(key: string): T {
-        const service = this.services.get(key);
-        if (!service) {
-            throw new Error(`Service ${key} not found in container`);
-        }
-        return service;
-    }
-
-    has(key: string): boolean {
-        return this.services.has(key);
-    }
-
-    clear() {
-        this.services.clear();
-    }
-}
-
-export const coreContainer = new Container();
+export class Container {
+    private services = new Map<string, any>();
+
+    register<T>(key: string, instance: T): T {
+        this.services.set(key, instance);
+        return instance;
+    }
+
+    get<T>(key: string): T {
+        const service = this.services.get(key);
+        if (!service) {
+            throw new Error(`Service ${key} not found in container`);
+        }
+        return service;
+    }
+
+    has(key: string): boolean {
+        return this.services.has(key);
+    }
+
+    clear() {
+        this.services.clear();
+    }
+}
+
+export const coreContainer = new Container();

package/src/core/encoding/base64.ts

@@ -1,46 +1,46 @@
-/**
- * ScaleBun SDK — base64 → binary decode (RN-safe).
- *
- * Used by the object-storage upload paths (replay frames + engage attachments) to
- * turn a base64 payload into real binary bytes for a presigned PUT. We deliberately
- * do NOT use the `fetch('data:…').blob()` round-trip: under the new architecture
- * that rejects with "Network request failed". RN's XHR accepts a `Uint8Array` body
- * and transfers `.buffer` to native as binary, so a decoded byte array uploads
- * faithfully.
- */
-
-const B64_ALPHABET =
-    'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
-
-/** Decode a base64 string (no data-URI prefix) into a Uint8Array of raw bytes. */
-export function base64ToBytes(base64: string): Uint8Array {
-    // Prefer the runtime decoder when present (Hermes ≥ RN 0.71 ships atob).
-    const g: any = globalThis as any;
-    if (typeof g.atob === 'function') {
-        const bin: string = g.atob(base64);
-        const out = new Uint8Array(bin.length);
-        for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i) & 0xff;
-        return out;
-    }
-    return decodeManual(base64);
-}
-
-function decodeManual(base64: string): Uint8Array {
-    const clean = base64.replace(/[^A-Za-z0-9+/=]/g, '');
-    const pad = clean.endsWith('==') ? 2 : clean.endsWith('=') ? 1 : 0;
-    const outLen = Math.floor((clean.length * 3) / 4) - pad;
-    const out = new Uint8Array(outLen);
-    let p = 0;
-    for (let i = 0; i < clean.length; i += 4) {
-        const c0 = B64_ALPHABET.indexOf(clean[i]);
-        const c1 = B64_ALPHABET.indexOf(clean[i + 1]);
-        const c2 = B64_ALPHABET.indexOf(clean[i + 2]);
-        const c3 = B64_ALPHABET.indexOf(clean[i + 3]);
-        const n =
-            (c0 << 18) | (c1 << 12) | ((c2 & 63) << 6) | (c3 & 63);
-        if (p < outLen) out[p++] = (n >> 16) & 0xff;
-        if (p < outLen) out[p++] = (n >> 8) & 0xff;
-        if (p < outLen) out[p++] = n & 0xff;
-    }
-    return out;
-}
+/**
+ * ScaleBun SDK — base64 → binary decode (RN-safe).
+ *
+ * Used by the object-storage upload paths (replay frames + engage attachments) to
+ * turn a base64 payload into real binary bytes for a presigned PUT. We deliberately
+ * do NOT use the `fetch('data:…').blob()` round-trip: under the new architecture
+ * that rejects with "Network request failed". RN's XHR accepts a `Uint8Array` body
+ * and transfers `.buffer` to native as binary, so a decoded byte array uploads
+ * faithfully.
+ */
+
+const B64_ALPHABET =
+    'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+
+/** Decode a base64 string (no data-URI prefix) into a Uint8Array of raw bytes. */
+export function base64ToBytes(base64: string): Uint8Array {
+    // Prefer the runtime decoder when present (Hermes ≥ RN 0.71 ships atob).
+    const g: any = globalThis as any;
+    if (typeof g.atob === 'function') {
+        const bin: string = g.atob(base64);
+        const out = new Uint8Array(bin.length);
+        for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i) & 0xff;
+        return out;
+    }
+    return decodeManual(base64);
+}
+
+function decodeManual(base64: string): Uint8Array {
+    const clean = base64.replace(/[^A-Za-z0-9+/=]/g, '');
+    const pad = clean.endsWith('==') ? 2 : clean.endsWith('=') ? 1 : 0;
+    const outLen = Math.floor((clean.length * 3) / 4) - pad;
+    const out = new Uint8Array(outLen);
+    let p = 0;
+    for (let i = 0; i < clean.length; i += 4) {
+        const c0 = B64_ALPHABET.indexOf(clean[i]);
+        const c1 = B64_ALPHABET.indexOf(clean[i + 1]);
+        const c2 = B64_ALPHABET.indexOf(clean[i + 2]);
+        const c3 = B64_ALPHABET.indexOf(clean[i + 3]);
+        const n =
+            (c0 << 18) | (c1 << 12) | ((c2 & 63) << 6) | (c3 & 63);
+        if (p < outLen) out[p++] = (n >> 16) & 0xff;
+        if (p < outLen) out[p++] = (n >> 8) & 0xff;
+        if (p < outLen) out[p++] = n & 0xff;
+    }
+    return out;
+}

package/src/core/id/deviceId.ts

@@ -1,51 +1,51 @@
-import { noThrow } from '../lifecycle/crashSafe';
-import { createStorageBackend } from '../../storage/StorageBackend';
-
-const STORAGE_KEY = 'scalebun_device_id';
-const storage = createStorageBackend();
-let cachedDeviceId: string | null = null;
-
-/**
- * Generates or retrieves a unique device ID.
- */
-export function getDeviceId(): string {
-    if (cachedDeviceId) {
-        return cachedDeviceId;
-    }
-
-    try {
-        const stored = storage.get(STORAGE_KEY);
-        if (stored) {
-            cachedDeviceId = stored;
-            return stored;
-        }
-    } catch {
-        // Fallback if storage fails
-    }
-
-    const newId = noThrow(() => {
-        return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
-            const r = (Math.random() * 16) | 0;
-            const v = c === 'x' ? r : (r & 0x3) | 0x8;
-            return v.toString(16);
-        });
-    }, 'unknown-device-id') || 'unknown-device-id';
-
-    cachedDeviceId = newId;
-
-    try {
-        storage.set(STORAGE_KEY, newId);
-    } catch {
-        // Fallback if storage fails
-    }
-
-    return newId;
-}
-
-/**
- * Generates a unique session ID.
- */
-export function generateSessionId(): string {
-    return 'ses-' + getDeviceId() + '-' + Date.now().toString(36);
-}
-
+import { noThrow } from '../lifecycle/crashSafe';
+import { createStorageBackend } from '../../storage/StorageBackend';
+
+const STORAGE_KEY = 'scalebun_device_id';
+const storage = createStorageBackend();
+let cachedDeviceId: string | null = null;
+
+/**
+ * Generates or retrieves a unique device ID.
+ */
+export function getDeviceId(): string {
+    if (cachedDeviceId) {
+        return cachedDeviceId;
+    }
+
+    try {
+        const stored = storage.get(STORAGE_KEY);
+        if (stored) {
+            cachedDeviceId = stored;
+            return stored;
+        }
+    } catch {
+        // Fallback if storage fails
+    }
+
+    const newId = noThrow(() => {
+        return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+            const r = (Math.random() * 16) | 0;
+            const v = c === 'x' ? r : (r & 0x3) | 0x8;
+            return v.toString(16);
+        });
+    }, 'unknown-device-id') || 'unknown-device-id';
+
+    cachedDeviceId = newId;
+
+    try {
+        storage.set(STORAGE_KEY, newId);
+    } catch {
+        // Fallback if storage fails
+    }
+
+    return newId;
+}
+
+/**
+ * Generates a unique session ID.
+ */
+export function generateSessionId(): string {
+    return 'ses-' + getDeviceId() + '-' + Date.now().toString(36);
+}
+

package/src/core/lifecycle/appLifecycle.ts

@@ -1,33 +1,33 @@
-import { AppState, AppStateStatus } from 'react-native';
-import { logger } from '../logger/internalLogger';
-
-export type LifecycleListener = (state: AppStateStatus) => void;
-
-class AppLifecycle {
-    private listeners: LifecycleListener[] = [];
-    private currentState: AppStateStatus = AppState.currentState;
-
-    constructor() {
-        AppState.addEventListener('change', this.handleStateChange);
-    }
-
-    private handleStateChange = (nextState: AppStateStatus) => {
-        logger.debug(`App state changed: ${this.currentState} -> ${nextState}`);
-        this.currentState = nextState;
-        this.listeners.forEach((l) => l(nextState));
-    };
-
-    addListener(listener: LifecycleListener) {
-        this.listeners.push(listener);
-    }
-
-    removeListener(listener: LifecycleListener) {
-        this.listeners = this.listeners.filter((l) => l !== listener);
-    }
-
-    getCurrentState() {
-        return this.currentState;
-    }
-}
-
-export const appLifecycle = new AppLifecycle();
+import { AppState, AppStateStatus } from 'react-native';
+import { logger } from '../logger/internalLogger';
+
+export type LifecycleListener = (state: AppStateStatus) => void;
+
+class AppLifecycle {
+    private listeners: LifecycleListener[] = [];
+    private currentState: AppStateStatus = AppState.currentState;
+
+    constructor() {
+        AppState.addEventListener('change', this.handleStateChange);
+    }
+
+    private handleStateChange = (nextState: AppStateStatus) => {
+        logger.debug(`App state changed: ${this.currentState} -> ${nextState}`);
+        this.currentState = nextState;
+        this.listeners.forEach((l) => l(nextState));
+    };
+
+    addListener(listener: LifecycleListener) {
+        this.listeners.push(listener);
+    }
+
+    removeListener(listener: LifecycleListener) {
+        this.listeners = this.listeners.filter((l) => l !== listener);
+    }
+
+    getCurrentState() {
+        return this.currentState;
+    }
+}
+
+export const appLifecycle = new AppLifecycle();

package/src/core/lifecycle/crashSafe.ts

@@ -1,29 +1,29 @@
-/**
- * Crash safety utilities for the SDK.
- * Ensures that internal SDK failures do not crash the host application.
- */
-
-export function noThrow<T>(fn: () => T, fallback?: T): T | undefined {
-    try {
-        return fn();
-    } catch (error) {
-        if (__DEV__) {
-            console.warn('[ScaleBun] Internal non-fatal error:', error);
-        }
-        return fallback;
-    }
-}
-
-export async function safeAsync<T>(
-    fn: () => Promise<T>,
-    fallback?: T
-): Promise<T | undefined> {
-    try {
-        return await fn();
-    } catch (error) {
-        if (__DEV__) {
-            console.warn('[ScaleBun] Internal async error:', error);
-        }
-        return fallback;
-    }
-}
+/**
+ * Crash safety utilities for the SDK.
+ * Ensures that internal SDK failures do not crash the host application.
+ */
+
+export function noThrow<T>(fn: () => T, fallback?: T): T | undefined {
+    try {
+        return fn();
+    } catch (error) {
+        if (__DEV__) {
+            console.warn('[ScaleBun] Internal non-fatal error:', error);
+        }
+        return fallback;
+    }
+}
+
+export async function safeAsync<T>(
+    fn: () => Promise<T>,
+    fallback?: T
+): Promise<T | undefined> {
+    try {
+        return await fn();
+    } catch (error) {
+        if (__DEV__) {
+            console.warn('[ScaleBun] Internal async error:', error);
+        }
+        return fallback;
+    }
+}