@scalebun-release/react-native 2.5.0

package/lib/typescript/vendor/sdk-contracts/session.d.ts

@@ -0,0 +1,157 @@
+/**
+ * @scalebun/sdk-contracts — Session Domain Types
+ *
+ * Pure type definitions for the unified session system.
+ * Runtime constants (QUALITY_PRESETS, DEFAULT_SESSION_REPLAY_CONFIG),
+ * enums (FrameRetentionPriority, EventRetentionPriority),
+ * and helper functions stay in scalebun-sdk/src/features/session/sessionTypes.ts.
+ */
+export type SessionStatus = 'active' | 'ended' | 'timeout';
+export interface SessionMetadata {
+    appName?: string;
+    appVersion?: string;
+    bundleId?: string;
+    platform?: 'android' | 'ios' | 'web';
+    osVersion?: string;
+    deviceModel?: string;
+    deviceName?: string;
+    screenWidth?: number;
+    screenHeight?: number;
+    buildType?: 'debug' | 'release';
+}
+export interface Session {
+    sessionId: string;
+    deviceId: string;
+    startedAt: number;
+    endedAt?: number;
+    status: SessionStatus;
+    metadata: SessionMetadata;
+    transportState: TransportState;
+    syncState: SyncState;
+    artifactIndex: SessionArtifactIndex;
+}
+export type JourneyEventType = 'SESSION_STARTED' | 'SESSION_ENDED' | 'APP_FOREGROUND' | 'APP_BACKGROUND' | 'SCREEN_VIEW' | 'USER_ACTION' | 'NETWORK_REQUEST_STARTED' | 'NETWORK_REQUEST_COMPLETED' | 'NETWORK_REQUEST_FAILED' | 'LOG_EMITTED' | 'ERROR_CAPTURED' | 'CRASH_CAPTURED' | 'REPLAY_FRAME_CAPTURED' | 'LOADING_STARTED' | 'LOADING_COMPLETED';
+export type JourneyEventSeverity = 'info' | 'warning' | 'error' | 'fatal';
+export type JourneyEventSource = 'sdk' | 'native' | 'user' | 'system';
+export interface JourneyEvent {
+    eventId: string;
+    sessionId: string;
+    journeyId?: string;
+    ts: number;
+    type: JourneyEventType;
+    subtype?: string;
+    severity?: JourneyEventSeverity;
+    screen?: string;
+    payload?: Record<string, unknown>;
+    correlationId?: string;
+    traceId?: string;
+    source?: JourneyEventSource;
+}
+export type CaptureReason = 'navigation' | 'interaction' | 'frequency' | 'manual' | 'error-context' | 'scroll' | 'screen_loaded';
+export type CaptureMode = 'navigation' | 'interactions' | 'frequency';
+export type ReplayQuality = 'high' | 'normal' | 'low';
+export interface ReplayFrame {
+    frameId: string;
+    sessionId: string;
+    ts: number;
+    imageRef: string;
+    width: number;
+    height: number;
+    quality: ReplayQuality;
+    captureReason: CaptureReason;
+    sourcePlatform: 'android' | 'ios';
+    redactionState?: 'none' | 'text-masked' | 'full';
+    screen?: string;
+    interactionPoint?: {
+        x: number;
+        y: number;
+        screenWidth: number;
+        screenHeight: number;
+        gestureType: string;
+    };
+}
+export interface CrashAnchor {
+    crashEventId: string;
+    nearbyEventIds: string[];
+    nearbyFrameIds: string[];
+    timestamp: number;
+}
+export interface SessionArtifactIndex {
+    frameRefs: string[];
+    eventRefs: string[];
+    networkRefs: string[];
+    logRefs: string[];
+    crashAnchors: CrashAnchor[];
+    uploadRefs?: string[];
+}
+export interface PrivacyPolicy {
+    redactTextInputs: boolean;
+    redactImages: boolean;
+    blockTestIds: string[];
+    captureExclusions: string[];
+}
+export interface SessionReplayConfig {
+    captureMode: CaptureMode;
+    quality: ReplayQuality;
+    intervalMs: number;
+    includeNetworkLogs: boolean;
+    includeSdkLogs: boolean;
+    includeUserSteps: boolean;
+    maxFrames: number;
+    maxEventCount: number;
+    maxDurationMs: number;
+    privacyPolicy: PrivacyPolicy;
+}
+export type TransportState = 'local' | 'pending-sync' | 'syncing' | 'synced' | 'failed';
+export interface SessionTransport {
+    sendSessionStart(session: Session): void;
+    sendSessionEnd(session: Session): void;
+    sendEvent(event: JourneyEvent): void;
+    sendFrame(frame: ReplayFrame, imageData: string): void;
+}
+export type SyncState = 'eligible' | 'ineligible' | 'pending-evaluation' | 'opted-out';
+export interface NativeSyncMetadata {
+    deviceModel: string;
+    osVersion: string;
+    batteryLevel?: number;
+    batteryCharging?: boolean;
+    networkType?: 'wifi' | 'cellular' | 'ethernet' | 'none' | 'unknown';
+    isMeteredNetwork?: boolean;
+    availableMemoryMb?: number;
+    thermalState?: 'nominal' | 'fair' | 'serious' | 'critical';
+}
+export interface SyncCandidate {
+    sessionId: string;
+    metadata: SessionMetadata;
+    nativeMetadata?: NativeSyncMetadata;
+    eventCount: number;
+    frameCount: number;
+    durationMs: number;
+    hasCrash: boolean;
+    hasError: boolean;
+}
+export interface SyncDecision {
+    shouldSync: boolean;
+    reason: string;
+    priority: 'high' | 'normal' | 'low';
+}
+export type SyncDecisionCallback = (candidate: SyncCandidate) => SyncDecision;
+export interface NativeFrameResult {
+    base64: string;
+    width: number;
+    height: number;
+    byteSize: number;
+    platform: 'android' | 'ios';
+}
+export interface NativeDeviceMetadata {
+    deviceModel: string;
+    osVersion: string;
+    screenWidth: number;
+    screenHeight: number;
+    platform: 'android' | 'ios';
+    appName?: string;
+    appVersion?: string;
+    bundleId?: string;
+    buildType?: 'debug' | 'release';
+}
+//# sourceMappingURL=session.d.ts.map

package/package.json

@@ -0,0 +1,153 @@
+{
+  "name": "@scalebun-release/react-native",
+  "version": "2.5.0",
+  "description": "React Native SDK for ScaleBun",
+  "main": "lib/commonjs/index",
+  "module": "lib/module/index",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "dist/scalebun.slim.js",
+  "source": "src/index",
+  "bin": {
+    "scalebun": "bin/scalebun.js"
+  },
+  "files": [
+    "src",
+    "lib",
+    "dist",
+    "bin",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!lib/typescript/example",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!android/build",
+    "!android/.cxx",
+    "!android/.gradle",
+    "!**/*.map",
+    "!**/.*"
+  ],
+  "exports": {
+    ".": {
+      "types": "./lib/typescript/index.d.ts",
+      "react-native": "./dist/scalebun.slim.js",
+      "import": "./dist/scalebun.slim.js",
+      "require": "./lib/commonjs/index.js"
+    },
+    "./metro": {
+      "types": "./lib/typescript/metro/index.d.ts",
+      "require": "./lib/commonjs/metro/index.js",
+      "import": "./lib/commonjs/metro/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "test": "jest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "clean": "del-cli lib dist",
+    "prepare": "bob build && node scripts/build-dist.mjs",
+    "prepack": "pnpm run clean && pnpm run build",
+    "build": "bob build && node scripts/build-dist.mjs",
+    "watch": "bob build --watch",
+    "test:screens": "node --experimental-transform-types --import ./scripts/rn-globals.mjs --import ./scripts/register-ts-ext.mjs --test scripts/screen-detection.test.ts",
+    "test:uistate": "node --experimental-transform-types --import ./scripts/rn-globals.mjs --import ./scripts/register-ts-ext.mjs --test scripts/ui-state.test.ts",
+    "typecheck:scripts": "tsc --noEmit -p tsconfig.scripts.json",
+    "test:protocol": "node --experimental-transform-types --import ./scripts/rn-globals.mjs --import ./scripts/register-ts-ext.mjs --test scripts/interaction-protocol.test.ts",
+    "test:nativeparity": "node --experimental-transform-types --import ./scripts/register-ts-ext.mjs --test scripts/native-parity.test.ts"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "scalebun",
+    "sdk",
+    "error-reporting",
+    "analytics"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/scalebun/scalebun-react-native-sdk.git",
+    "directory": "packages/react-native"
+  },
+  "author": "ScaleBun Team",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/scalebun/scalebun-react-native-sdk/issues"
+  },
+  "homepage": "https://github.com/scalebun/scalebun-react-native-sdk#readme",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@babel/preset-env": "^8.0.2",
+    "@react-native-community/eslint-config": "^3.2.0",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^25.3.3",
+    "@types/react": "^18.2.0",
+    "@types/react-native": "^0.73.0",
+    "babel-jest": "^30.4.1",
+    "del-cli": "^5.1.0",
+    "esbuild": "0.25.0",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.1.3",
+    "jest": "^29.7.0",
+    "prettier": "^3.2.5",
+    "react": "18.2.0",
+    "react-native": "0.74.1",
+    "react-native-builder-bob": "^0.25.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.4.5"
+  },
+  "peerDependencies": {
+    "@notifee/react-native": ">=5.0.0",
+    "expo-router": ">=1.0.0",
+    "react": ">=18.0.0",
+    "react-native": ">=0.74.0",
+    "react-native-view-shot": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react-native-view-shot": {
+      "optional": true
+    },
+    "@notifee/react-native": {
+      "optional": true
+    },
+    "expo-router": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@babel/runtime": "^7.25.0",
+    "@jridgewell/sourcemap-codec": "1.5.5",
+    "@jridgewell/trace-mapping": "0.3.31",
+    "@scalebun/cli": "npm:@scalebun-release/cli@2.5.0"
+  },
+  "codegenConfig": {
+    "name": "ScaleBunSpec",
+    "type": "modules",
+    "jsSrcsDir": "src/specs",
+    "android": {
+      "javaPackageName": "com.scalebun.spec"
+    }
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.json"
+        }
+      ]
+    ]
+  }
+}

package/react-native.config.js

@@ -0,0 +1,24 @@
+/**
+ * React Native autolinking configuration for @scalebun/react-native.
+ *
+ * Android: RN autolinking registers exactly one ReactPackage per dependency, so
+ * we point it at the aggregator `com.scalebun.rn.ScaleBunPackage`, which composes
+ * every ScaleBun feature package (crash, profiler, replay, performance). Result:
+ * the SDK is wired purely by autolinking — consumers add NOTHING to
+ * MainApplication.kt.
+ *
+ * iOS: there is no package concept — each native module self-registers via
+ * RCT_EXTERN_MODULE and is discovered through the podspec's source_files glob, so
+ * no iOS-specific autolink config is needed.
+ */
+module.exports = {
+    dependency: {
+        platforms: {
+            android: {
+                packageImportPath: 'import com.scalebun.rn.ScaleBunPackage;',
+                packageInstance: 'new ScaleBunPackage()',
+            },
+            ios: {},
+        },
+    },
+};

package/scalebun-react-native.podspec

@@ -0,0 +1,44 @@
+Pod::Spec.new do |s|
+  s.name         = "scalebun-react-native"
+  s.version      = "0.1.0"
+  s.summary      = "ScaleBun SDK — iOS native modules for session replay and diagnostics"
+  s.homepage     = "https://scalebun.dev"
+  s.license      = { :type => "MIT" }
+  s.author       = "ScaleBun"
+  s.source       = { :git => "" }
+
+  s.platform     = :ios, "13.4"
+  s.swift_version = "5.0"
+
+  # Include .mm (ObjC++) for the New Architecture TurboModule providers added in
+  # Phase 2, alongside the existing .h/.m/.swift sources.
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+  # XCTest sources ship with the SDK source but must NOT compile into the pod
+  # (they import XCTest and belong in a test target). ios/OtaTests is excluded as a
+  # whole directory, not just by the *Tests.swift name, so a helper added next to
+  # the test cannot leak into a customer's build. Those tests are compiled and RUN
+  # by ci.yml's `ios-ota-verifier` job via Package.swift + `swift test`; see the
+  # header of ScaleBunOtaVerifierTests.swift for the host-app route (PROMPT §23).
+  s.exclude_files = ["ios/OtaTests/**/*", "ios/CrashTests/**/*", "ios/**/*Tests.swift"]
+
+  # Define a clang module so the generated Swift interop header
+  # (`scalebun_react_native-Swift.h`) is emitted and importable from a host
+  # AppDelegate as `<scalebun_react_native/scalebun_react_native-Swift.h>`. This
+  # is what lets `npx scalebun init ios` wire the @objc(ScaleBunEngage) APNs hooks from
+  # an ObjC/ObjC++ AppDelegate without `use_frameworks!`.
+  s.pod_target_xcconfig = {
+    "DEFINES_MODULE" => "YES"
+  }
+
+  # Apple Privacy Manifest — bundled as a pod resource so CocoaPods / `expo
+  # prebuild` aggregate it automatically (no Expo config plugin or EAS needed).
+  s.resource_bundles = {
+    "ScaleBunPrivacy" => ["ios/PrivacyInfo.xcprivacy"]
+  }
+
+  # Installs React-Core and, on the New Architecture, React-Codegen, the
+  # generated `ScaleBunSpec` pod and the TurboModule/Fabric dependencies —
+  # transparently for both architectures. Provided by React Native's
+  # react_native_pods.rb (loaded by the consuming app's Podfile).
+  install_modules_dependencies(s)
+end