@scalebun/react-native 1.0.2 → 1.0.4

package/src/vendor/sdk-contracts/config.ts

@@ -1,192 +1,192 @@
-/**
- * @scalebun/sdk-contracts — Config Types
- *
- * Pure type definitions for SDK configuration.
- * No runtime values, no Zod schemas, no validators.
- *
- * Runtime validation (Zod) stays in scalebun-sdk/src/core/config/schema.ts.
- */
-
-// ─── Core Config ────────────────────────────────────────────────────────────
-
-/** Core SDK configuration (mirrors Zod-inferred type from schema.ts) */
-export interface ScaleBunConfig {
-    projectId: string;
-    publishableKey: string;
-    apiBaseUrl: string;
-    debug: boolean;
-    flushIntervalMs: number;
-    maxQueueSize: number;
-    enableNetworkMonitoring: boolean;
-}
-
-// ─── Feature Flags ──────────────────────────────────────────────────────────
-
-/** Feature opt-out flags. All default to `true` (enabled). */
-export interface ScaleBunFeatures {
-    /** Enable session replay capture. Default: true */
-    replay?: boolean;
-    /** Enable network request monitoring. Default: true */
-    network?: boolean;
-    /** Enable crash reporting. Default: true */
-    crashes?: boolean;
-    /** Enable unified session tracking. Default: true */
-    session?: boolean;
-    /** Enable user journey tracking. Default: true */
-    journey?: boolean;
-    /** Enable native performance monitoring. Default: true */
-    performance?: boolean;
-
-    /**
-     * Capture HTTP request/response headers and bodies.
-     *
-     * ⚠️  PRIVACY WARNING: Enabling this flag may capture sensitive user data
-     * (auth tokens, personal information, passwords) in network payloads.
-     * The integrator is responsible for ensuring compliance with applicable
-     * privacy regulations (GDPR, CCPA, etc.) and their own privacy policy.
-     *
-     * Redaction patterns in `redaction.ts` are applied when `debug.redactNetwork`
-     * is enabled, but they are heuristic and cannot guarantee full PII removal.
-     *
-     * Default: false (capture is opt-in)
-     *
-     * NOTE: This is JS-host capture only (fetch / XHR).
-     * Native-layer capture (OkHttp / URLSession) is future work.
-     */
-    captureNetworkBodies?: boolean;
-
-    /**
-     * Maximum bytes to capture from a response body before truncating.
-     * Applied independently to request and response bodies.
-     * Default: 65536 (64 KiB)
-     */
-    networkBodyMaxBytes?: number;
-}
-
-// ─── Init Config ────────────────────────────────────────────────────────────
-
-/** SDK initialization config (legacy format) */
-export interface ScaleBunInitConfig {
-    /** Legacy: required when not using clientKey */
-    projectId?: string;
-    /** Legacy: required when not using clientKey */
-    publishableKey?: string;
-    /** SaaS mode: clientKey replaces projectId + publishableKey */
-    clientKey?: string;
-    apiBaseUrl: string;
-    debug?: boolean;
-    /**
-     * SDK internal log verbosity. Controls only the SDK's own diagnostic logs.
-     * Recoverable transport failures (abort/timeout/offline) are logged at
-     * `warn` and never via console.error, so they cannot trigger a RedBox.
-     *
-     * - 'silent' — no SDK logs
-     * - 'error'  — fatal SDK errors only
-     * - 'warn'   — warnings + errors (default)
-     * - 'info'   — lifecycle info + above
-     * - 'debug'  — verbose diagnostics
-     *
-     * Default: 'warn'. `debug: true` implies 'debug' unless logLevel is set.
-     */
-    logLevel?: 'silent' | 'error' | 'warn' | 'info' | 'debug';
-    flushIntervalMs?: number;
-    maxQueueSize?: number;
-    enableNetworkMonitoring?: boolean;
-    /**
-     * Native file-based replay outbox (durable; survives app restart). Default false.
-     * When off, the existing in-memory JS upload path is used unchanged. SaaS only.
-     */
-    enableNativeFileOutbox?: boolean;
-    /** Allow the native outbox to upload on its own. Default false. Requires enableNativeFileOutbox. */
-    nativeOutboxUploadEnabled?: boolean;
-    /** Upload outbox frame bytes to object storage (presigned PUT, key-only commit). Default false. */
-    useObjectStorageForFrames?: boolean;
-    features?: ScaleBunFeatures;
-}
-
-// ─── Debug Connection Config ────────────────────────────────────────────────
-
-export type DebugConnectionConfig = boolean | {
-    autoConnect?: boolean;
-    host?: string;
-    port?: number;
-    appName?: string;
-    bundleId?: string;
-};
-
-// ─── Privacy Config ─────────────────────────────────────────────────────────
-
-export interface PrivacyConfig {
-    redactAuth?: boolean;
-    redactCookies?: boolean;
-    redactBodies?: boolean;
-    maskTextInputs?: boolean;
-    maskImages?: boolean;
-}
-
-// ─── Branding Config ────────────────────────────────────────────────────────
-
-export interface BrandingConfig {
-    company?: string;
-    confidential?: boolean;
-    footer?: string;
-}
-
-// ─── User Identity ──────────────────────────────────────────────────────────
-
-export interface ScaleBunUser {
-    id: string;
-    name?: string;
-    email?: string;
-    attributes?: Record<string, string | number | boolean>;
-}
-
-// ─── Export Types ───────────────────────────────────────────────────────────
-
-export type ExportPresetName =
-    | 'executive'
-    | 'engineering'
-    | 'qa'
-    | 'forensic'
-    | 'journey'
-    | 'compact';
-
-export interface SimplifiedExportOptions {
-    format?: 'pdf' | 'docx';
-    detail?: 'minimal' | 'standard' | 'detailed' | 'forensic';
-    preset?: ExportPresetName;
-    includeScreenshots?: boolean;
-}
-
-export interface ExportResult {
-    success: boolean;
-    filePath?: string;
-    error?: string;
-    cancelled?: boolean;
-}
-
-// ─── Simplified Init Config ─────────────────────────────────────────────────
-
-export interface SimplifiedInitConfig {
-    /** Legacy: required when not using clientKey */
-    projectId?: string;
-    /** Legacy: required when not using clientKey */
-    publishableKey?: string;
-    /** SaaS mode: clientKey replaces projectId + publishableKey */
-    clientKey?: string;
-    apiBaseUrl: string;
-    debug?: DebugConnectionConfig;
-    privacy?: PrivacyConfig;
-    features?: ScaleBunFeatures;
-    verbose?: boolean;
-    /** SDK internal log verbosity. See ScaleBunInitConfig.logLevel. Default: 'warn'. */
-    logLevel?: 'silent' | 'error' | 'warn' | 'info' | 'debug';
-    flushIntervalMs?: number;
-    maxQueueSize?: number;
-    /** Native file-based replay outbox (durable). Default false. See ScaleBunInitConfig. */
-    enableNativeFileOutbox?: boolean;
-    /** Allow native outbox to upload on its own. Default false. */
-    nativeOutboxUploadEnabled?: boolean;
-    /** Upload outbox frame bytes to object storage. Default false. */
-    useObjectStorageForFrames?: boolean;
-}
+/**
+ * @scalebun/sdk-contracts — Config Types
+ *
+ * Pure type definitions for SDK configuration.
+ * No runtime values, no Zod schemas, no validators.
+ *
+ * Runtime validation (Zod) stays in scalebun-sdk/src/core/config/schema.ts.
+ */
+
+// ─── Core Config ────────────────────────────────────────────────────────────
+
+/** Core SDK configuration (mirrors Zod-inferred type from schema.ts) */
+export interface ScaleBunConfig {
+    projectId: string;
+    publishableKey: string;
+    apiBaseUrl: string;
+    debug: boolean;
+    flushIntervalMs: number;
+    maxQueueSize: number;
+    enableNetworkMonitoring: boolean;
+}
+
+// ─── Feature Flags ──────────────────────────────────────────────────────────
+
+/** Feature opt-out flags. All default to `true` (enabled). */
+export interface ScaleBunFeatures {
+    /** Enable session replay capture. Default: true */
+    replay?: boolean;
+    /** Enable network request monitoring. Default: true */
+    network?: boolean;
+    /** Enable crash reporting. Default: true */
+    crashes?: boolean;
+    /** Enable unified session tracking. Default: true */
+    session?: boolean;
+    /** Enable user journey tracking. Default: true */
+    journey?: boolean;
+    /** Enable native performance monitoring. Default: true */
+    performance?: boolean;
+
+    /**
+     * Capture HTTP request/response headers and bodies.
+     *
+     * ⚠️  PRIVACY WARNING: Enabling this flag may capture sensitive user data
+     * (auth tokens, personal information, passwords) in network payloads.
+     * The integrator is responsible for ensuring compliance with applicable
+     * privacy regulations (GDPR, CCPA, etc.) and their own privacy policy.
+     *
+     * Redaction patterns in `redaction.ts` are applied when `debug.redactNetwork`
+     * is enabled, but they are heuristic and cannot guarantee full PII removal.
+     *
+     * Default: false (capture is opt-in)
+     *
+     * NOTE: This is JS-host capture only (fetch / XHR).
+     * Native-layer capture (OkHttp / URLSession) is future work.
+     */
+    captureNetworkBodies?: boolean;
+
+    /**
+     * Maximum bytes to capture from a response body before truncating.
+     * Applied independently to request and response bodies.
+     * Default: 65536 (64 KiB)
+     */
+    networkBodyMaxBytes?: number;
+}
+
+// ─── Init Config ────────────────────────────────────────────────────────────
+
+/** SDK initialization config (legacy format) */
+export interface ScaleBunInitConfig {
+    /** Legacy: required when not using clientKey */
+    projectId?: string;
+    /** Legacy: required when not using clientKey */
+    publishableKey?: string;
+    /** SaaS mode: clientKey replaces projectId + publishableKey */
+    clientKey?: string;
+    apiBaseUrl: string;
+    debug?: boolean;
+    /**
+     * SDK internal log verbosity. Controls only the SDK's own diagnostic logs.
+     * Recoverable transport failures (abort/timeout/offline) are logged at
+     * `warn` and never via console.error, so they cannot trigger a RedBox.
+     *
+     * - 'silent' — no SDK logs
+     * - 'error'  — fatal SDK errors only
+     * - 'warn'   — warnings + errors (default)
+     * - 'info'   — lifecycle info + above
+     * - 'debug'  — verbose diagnostics
+     *
+     * Default: 'warn'. `debug: true` implies 'debug' unless logLevel is set.
+     */
+    logLevel?: 'silent' | 'error' | 'warn' | 'info' | 'debug';
+    flushIntervalMs?: number;
+    maxQueueSize?: number;
+    enableNetworkMonitoring?: boolean;
+    /**
+     * Native file-based replay outbox (durable; survives app restart). Default false.
+     * When off, the existing in-memory JS upload path is used unchanged. SaaS only.
+     */
+    enableNativeFileOutbox?: boolean;
+    /** Allow the native outbox to upload on its own. Default false. Requires enableNativeFileOutbox. */
+    nativeOutboxUploadEnabled?: boolean;
+    /** Upload outbox frame bytes to object storage (presigned PUT, key-only commit). Default false. */
+    useObjectStorageForFrames?: boolean;
+    features?: ScaleBunFeatures;
+}
+
+// ─── Debug Connection Config ────────────────────────────────────────────────
+
+export type DebugConnectionConfig = boolean | {
+    autoConnect?: boolean;
+    host?: string;
+    port?: number;
+    appName?: string;
+    bundleId?: string;
+};
+
+// ─── Privacy Config ─────────────────────────────────────────────────────────
+
+export interface PrivacyConfig {
+    redactAuth?: boolean;
+    redactCookies?: boolean;
+    redactBodies?: boolean;
+    maskTextInputs?: boolean;
+    maskImages?: boolean;
+}
+
+// ─── Branding Config ────────────────────────────────────────────────────────
+
+export interface BrandingConfig {
+    company?: string;
+    confidential?: boolean;
+    footer?: string;
+}
+
+// ─── User Identity ──────────────────────────────────────────────────────────
+
+export interface ScaleBunUser {
+    id: string;
+    name?: string;
+    email?: string;
+    attributes?: Record<string, string | number | boolean>;
+}
+
+// ─── Export Types ───────────────────────────────────────────────────────────
+
+export type ExportPresetName =
+    | 'executive'
+    | 'engineering'
+    | 'qa'
+    | 'forensic'
+    | 'journey'
+    | 'compact';
+
+export interface SimplifiedExportOptions {
+    format?: 'pdf' | 'docx';
+    detail?: 'minimal' | 'standard' | 'detailed' | 'forensic';
+    preset?: ExportPresetName;
+    includeScreenshots?: boolean;
+}
+
+export interface ExportResult {
+    success: boolean;
+    filePath?: string;
+    error?: string;
+    cancelled?: boolean;
+}
+
+// ─── Simplified Init Config ─────────────────────────────────────────────────
+
+export interface SimplifiedInitConfig {
+    /** Legacy: required when not using clientKey */
+    projectId?: string;
+    /** Legacy: required when not using clientKey */
+    publishableKey?: string;
+    /** SaaS mode: clientKey replaces projectId + publishableKey */
+    clientKey?: string;
+    apiBaseUrl: string;
+    debug?: DebugConnectionConfig;
+    privacy?: PrivacyConfig;
+    features?: ScaleBunFeatures;
+    verbose?: boolean;
+    /** SDK internal log verbosity. See ScaleBunInitConfig.logLevel. Default: 'warn'. */
+    logLevel?: 'silent' | 'error' | 'warn' | 'info' | 'debug';
+    flushIntervalMs?: number;
+    maxQueueSize?: number;
+    /** Native file-based replay outbox (durable). Default false. See ScaleBunInitConfig. */
+    enableNativeFileOutbox?: boolean;
+    /** Allow native outbox to upload on its own. Default false. */
+    nativeOutboxUploadEnabled?: boolean;
+    /** Upload outbox frame bytes to object storage. Default false. */
+    useObjectStorageForFrames?: boolean;
+}

package/src/vendor/sdk-contracts/events.ts

@@ -1,50 +1,50 @@
-/**
- * @scalebun/sdk-contracts — Event Types
- *
- * Pure type definitions for the event pipeline.
- * Runtime functions (createEnvelope) stay in scalebun-sdk.
- */
-
-// ─── Context Types ──────────────────────────────────────────────────────────
-
-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;
-}
-
-// ─── Envelope ───────────────────────────────────────────────────────────────
-
-export interface Envelope {
-    id: string;
-    type: 'event' | 'session' | 'crash' | 'log';
-    timestamp: number;
-    payload: any;
-    common?: {
-        user?: UserContext;
-        app?: AppContext;
-        device?: DeviceContext;
-        sessionId?: string;
-    };
-}
+/**
+ * @scalebun/sdk-contracts — Event Types
+ *
+ * Pure type definitions for the event pipeline.
+ * Runtime functions (createEnvelope) stay in scalebun-sdk.
+ */
+
+// ─── Context Types ──────────────────────────────────────────────────────────
+
+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;
+}
+
+// ─── Envelope ───────────────────────────────────────────────────────────────
+
+export interface Envelope {
+    id: string;
+    type: 'event' | 'session' | 'crash' | 'log';
+    timestamp: number;
+    payload: any;
+    common?: {
+        user?: UserContext;
+        app?: AppContext;
+        device?: DeviceContext;
+        sessionId?: string;
+    };
+}

package/src/vendor/sdk-contracts/features.ts

@@ -1,42 +1,42 @@
-/**
- * @scalebun/sdk-contracts — Feature Contract
- *
- * Pure interface definitions for pluggable SDK features.
- * No runtime implementation, no helpers.
- */
-
-/** 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;
-}
+/**
+ * @scalebun/sdk-contracts — Feature Contract
+ *
+ * Pure interface definitions for pluggable SDK features.
+ * No runtime implementation, no helpers.
+ */
+
+/** 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;
+}