@sazabi/react-native 0.0.0-stage → 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,108 @@
+import type { ConsoleCaptureConfig, NetworkCaptureConfig as CoreNetworkCaptureConfig, PointerCaptureConfig } from "./client-sdk-core/index.js";
+export type { AttributeValue, ClientEvent, ClientEventType, ConsoleCaptureConfig, ConsoleCaptureLevel, EventAttributes, EventSeverity, PointerCaptureConfig, } from "./client-sdk-core/index.js";
+/**
+ * Persistent key-value storage the SDK writes sessions, identity, and the
+ * crash outbox to. `@react-native-async-storage/async-storage`, MMKV
+ * wrappers, and `expo-sqlite/kv-store` all satisfy it; a synchronous store
+ * makes the crash outbox reliable on a fatal error.
+ */
+export interface StorageAdapter {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+    removeItem(key: string): void | Promise<void>;
+    /**
+     * Every key the store holds (AsyncStorage's `getAllKeys`, MMKV's
+     * `getAllKeys`). Optional: with it, a launch recovers a crash report whose
+     * own key was written but whose index entry never landed because the
+     * process died between the two writes. Without it such a report is lost.
+     */
+    getAllKeys?(): readonly string[] | Promise<readonly string[]>;
+}
+export interface NetworkCaptureConfig extends CoreNetworkCaptureConfig {
+    /**
+     * Requests eligible for `traceparent` injection. A string is a host
+     * (`api.example.com`), a domain with every subdomain (`.example.com`), or
+     * an origin with an optional path prefix (`https://api.example.com`); a
+     * RegExp is tested against the full URL. Default: every request except
+     * the intake endpoint. A native app has no origin and no CORS preflight,
+     * so injection is on everywhere unless narrowed here.
+     */
+    allowlist?: (string | RegExp)[];
+}
+/**
+ * What `HermesInternal.enablePromiseRejectionTracker` takes: the shape every
+ * React Native crash reporter installs.
+ */
+export interface RejectionTracker {
+    allRejections: boolean;
+    onUnhandled(id: number, rejection: unknown): void;
+    onHandled?(id: number): void;
+}
+export interface ErrorCaptureConfig {
+    /**
+     * Track unhandled promise rejections through Hermes's rejection tracker.
+     * Hermes has one tracker slot, so turn this off when another SDK owns it.
+     * Default true.
+     */
+    unhandledRejections?: boolean;
+    /**
+     * The tracker another library installed before `init()`, to run after the
+     * SDK's own on every rejection. Hermes gives no way to read the slot's
+     * occupant (`HermesInternal` is frozen and its global pinned), so `init()`
+     * replaces whatever holds it; hand that tracker over here to keep it
+     * running. A tracker installed after `init()` replaces the SDK's instead.
+     */
+    previousRejectionTracker?: RejectionTracker;
+}
+/** The subset of a React Navigation container ref the SDK subscribes to. */
+export interface NavigationContainerRefLike {
+    addListener(type: "state", listener: () => void): () => void;
+    getCurrentRoute(): {
+        key?: string | undefined;
+        name: string;
+        params?: object | undefined;
+        path?: string | undefined;
+    } | undefined;
+}
+export interface ReactNativeSdkConfig {
+    /**
+     * The project's intake URL, exactly as the log source issues it, e.g.
+     * `https://<key>.us-west-2.intake.sazabi.com`. The credential is embedded in
+     * the hostname, so this is normally the only endpoint config needed; `/v1/logs`
+     * may be included or omitted.
+     */
+    intakeUrl?: string;
+    /**
+     * Public ingest key (`sazabi_public_...`). Optional: derived from `intakeUrl`
+     * when that URL is a keyed intake host. Set it only for a proxy or custom
+     * endpoint whose hostname carries no key.
+     */
+    publicKey?: string;
+    /** Logical service name for the app. */
+    serviceName: string;
+    /** App version (e.g. the marketing version or a git SHA). */
+    serviceVersion?: string;
+    /** Deployment environment (e.g. "production"). */
+    environment?: string;
+    /** Session persistence and the crash outbox. Without it, sessions last one launch. */
+    storage?: StorageAdapter;
+    network?: NetworkCaptureConfig;
+    console?: ConsoleCaptureConfig;
+    pointer?: PointerCaptureConfig;
+    errors?: ErrorCaptureConfig;
+    /**
+     * Consent gate: capture holds until this resolves true. When it resolves
+     * false the SDK stays dormant.
+     */
+    consent?: () => boolean | Promise<boolean>;
+    /** Batch flush cadence in ms. Default 5000. */
+    flushIntervalMs?: number;
+    /** Soft cap per OTLP request body in bytes. Default 57344. */
+    maxBatchBytes?: number;
+    /**
+     * Max buffered events (and at most 1 MiB) while the intake is unreachable;
+     * the oldest are dropped first and counted in `app.sdk.dropped_events`.
+     * Default 500.
+     */
+    maxQueuedEvents?: number;
+}

package/dist/version.d.ts

@@ -0,0 +1,4 @@
+export declare const SDK_NAME = "@sazabi/react-native";
+export declare const SDK_VERSION = "0.1.0";
+/** SDK-emitted console lines carry this prefix and are never re-captured. */
+export declare const SDK_CONSOLE_PREFIX = "[@sazabi/react-native]";

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@sazabi/react-native",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "description": "Sazabi React Native observability SDK — semantic event stream capture with W3C trace context propagation",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./register": {
+      "types": "./dist/register.d.ts",
+      "default": "./dist/register.js"
+    },
+    "./dist/register.js": {
+      "types": "./dist/register.d.ts",
+      "default": "./dist/register.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "react-native": {
+    "./register": "./dist/register.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "react-native": ">=0.76"
+  },
+  "peerDependenciesMeta": {
+    "react-native": {
+      "optional": true
+    }
+  },
+  "sideEffects": [
+    "./dist/register.js"
+  ],
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/sazabi/react-native",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sazabi/react-native.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.