@dreamhorizonorg/pulse-react-native 0.0.1 → 0.0.3

package/lib/typescript/src/network-interceptor/url-helper.d.ts

@@ -7,6 +7,14 @@
  *
  * Based on: https://github.com/facebook/react-native/blob/v0.80.0/packages/react-native/Libraries/Blob/URL.js
  */
+export declare class SearchParams {
+    private params;
+    constructor(search: string);
+    get(name: string): string | null;
+    has(name: string): boolean;
+    keys(): string[];
+    values(): string[];
+}
 export interface ParsedUrl {
     protocol: string;
     hostname: string;
@@ -16,6 +24,7 @@ export interface ParsedUrl {
     search: string;
     hash: string;
     href: string;
+    searchParams: SearchParams;
 }
 /**
  * Parse a URL string into its components

package/lib/typescript/src/network-interceptor/url-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url-helper.d.ts","sourceRoot":"","sources":["../../../../src/network-interceptor/url-helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAmBD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAqDtD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CA6CA"}
+{"version":3,"file":"url-helper.d.ts","sourceRoot":"","sources":["../../../../src/network-interceptor/url-helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAkC;gBAEpC,MAAM,EAAE,MAAM;IAyC1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIhC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,IAAI,MAAM,EAAE;IAIhB,MAAM,IAAI,MAAM,EAAE;CAGnB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;CAC5B;AAmBD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAyDtD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CA6CA"}

package/lib/typescript/src/pulse.constants.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Constants for Pulse React Native OpenTelemetry integration
+ */
+export declare enum SPAN_NAMES {
+    SCREEN_SESSION = "ScreenSession",
+    NAVIGATED = "Navigated",
+    SCREEN_INTERACTIVE = "ScreenInteractive"
+}
+export declare enum ATTRIBUTE_KEYS {
+    PULSE_TYPE = "pulse.type",
+    SCREEN_NAME = "screen.name",
+    ROUTE_KEY = "routeKey",
+    LAST_SCREEN_NAME = "last.screen.name",
+    ROUTE_HAS_BEEN_SEEN = "routeHasBeenSeen",
+    PLATFORM = "platform",
+    GRAPHQL_OPERATION_NAME = "graphql.operation.name",
+    GRAPHQL_OPERATION_TYPE = "graphql.operation.type",
+    HTTP_METHOD = "http.method",
+    HTTP_URL = "http.url",
+    HTTP_STATUS_CODE = "http.status_code",
+    HTTP_REQUEST_TYPE = "http.request.type",
+    HTTP_REQUEST_HEADER = "http.request.header",
+    HTTP_RESPONSE_HEADER = "http.response.header",
+    ERROR_MESSAGE = "error.message",
+    ERROR_STACK = "error.stack"
+}
+export declare enum PULSE_TYPES {
+    SCREEN_SESSION = "screen_session",
+    SCREEN_LOAD = "screen_load",
+    SCREEN_INTERACTIVE = "screen_interactive",
+    NETWORK = "network"
+}
+export declare const PULSE_FEATURE_NAMES: {
+    readonly RN_SCREEN_LOAD: "rn_screen_load";
+    readonly SCREEN_SESSION: "screen_session";
+    readonly RN_SCREEN_INTERACTIVE: "rn_screen_interactive";
+    readonly NETWORK_INSTRUMENTATION: "network_instrumentation";
+    readonly CUSTOM_EVENTS: "custom_events";
+    readonly JS_CRASH: "js_crash";
+};
+export type PulseFeatureName = (typeof PULSE_FEATURE_NAMES)[keyof typeof PULSE_FEATURE_NAMES];
+export type NavigationFeatureName = typeof PULSE_FEATURE_NAMES.SCREEN_SESSION | typeof PULSE_FEATURE_NAMES.RN_SCREEN_LOAD | typeof PULSE_FEATURE_NAMES.RN_SCREEN_INTERACTIVE;
+//# sourceMappingURL=pulse.constants.d.ts.map

package/lib/typescript/src/pulse.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse.constants.d.ts","sourceRoot":"","sources":["../../../src/pulse.constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,UAAU;IACpB,cAAc,kBAAkB;IAChC,SAAS,cAAc;IACvB,kBAAkB,sBAAsB;CACzC;AAED,oBAAY,cAAc;IACxB,UAAU,eAAe;IACzB,WAAW,gBAAgB;IAC3B,SAAS,aAAa;IACtB,gBAAgB,qBAAqB;IACrC,mBAAmB,qBAAqB;IACxC,QAAQ,aAAa;IACrB,sBAAsB,2BAA2B;IACjD,sBAAsB,2BAA2B;IACjD,WAAW,gBAAgB;IAC3B,QAAQ,aAAa;IACrB,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;IAC3C,oBAAoB,yBAAyB;IAC7C,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;CAC5B;AAED,oBAAY,WAAW;IACrB,cAAc,mBAAmB;IACjC,WAAW,gBAAgB;IAC3B,kBAAkB,uBAAuB;IACzC,OAAO,YAAY;CACpB;AAED,eAAO,MAAM,mBAAmB;;;;;;;CAOtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjE,MAAM,MAAM,qBAAqB,GAC7B,OAAO,mBAAmB,CAAC,cAAc,GACzC,OAAO,mBAAmB,CAAC,cAAc,GACzC,OAAO,mBAAmB,CAAC,qBAAqB,CAAC"}

package/lib/typescript/src/pulse.interface.d.ts

@@ -4,5 +4,6 @@
  * @see https://github.com/open-telemetry/opentelemetry-js/blob/main/api/src/common/Attributes.ts
  */
 export type PulseAttributeValue = string | number | boolean | string[] | number[] | boolean[];
-export type PulseAttributes = Record<string, PulseAttributeValue | undefined>;
+export type PulseAttributes = Record<string, PulseAttributeValue | undefined | null>;
+export type PulseFeatureConfig = Record<string, boolean> | null | undefined;
 //# sourceMappingURL=pulse.interface.d.ts.map

package/lib/typescript/src/pulse.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pulse.interface.d.ts","sourceRoot":"","sources":["../../../src/pulse.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,EAAE,GACR,MAAM,EAAE,GACR,OAAO,EAAE,CAAC;AAEd,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAAC,CAAC"}
+{"version":3,"file":"pulse.interface.d.ts","sourceRoot":"","sources":["../../../src/pulse.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,EAAE,GACR,MAAM,EAAE,GACR,OAAO,EAAE,CAAC;AAEd,MAAM,MAAM,eAAe,GAAG,MAAM,CAClC,MAAM,EACN,mBAAmB,GAAG,SAAS,GAAG,IAAI,CACvC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC"}

package/lib/typescript/src/trace.d.ts

@@ -1,6 +1,12 @@
 import type { PulseAttributes } from './pulse.interface';
+/**
+ * Options for starting a span.
+ * @param attributes - Attributes to set on the span.
+ * @param inheritContext - Controls whether or not the new span will be parented in the existing (current) context. If false, a new context is created.
+ */
 export type SpanOptions = {
     attributes?: PulseAttributes;
+    inheritContext?: boolean;
 };
 export declare enum SpanStatusCode {
     OK = "OK",
@@ -16,4 +22,5 @@ export type Span = {
 };
 export declare function startSpan(name: string, options?: SpanOptions): Span;
 export declare function trackSpan<T>(name: string, options: SpanOptions, fn: () => T | Promise<T>): T | Promise<T>;
+export declare function discardSpan(spanId: string): void;
 //# sourceMappingURL=trace.d.ts.map

package/lib/typescript/src/trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/trace.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B,CAAC;AAEF,oBAAY,cAAc;IACxB,EAAE,OAAO;IACT,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED,MAAM,MAAM,IAAI,GAAG;IACjB,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IAC3C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;IAC/D,aAAa,EAAE,CAAC,UAAU,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;IACtD,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;IAEtE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CA4BnE;AAED,wBAAgB,SAAS,CAAC,CAAC,EACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAkBhB"}
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/trace.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,oBAAY,cAAc;IACxB,EAAE,OAAO;IACT,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED,MAAM,MAAM,IAAI,GAAG;IACjB,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IAC3C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;IAC/D,aAAa,EAAE,CAAC,UAAU,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;IACtD,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;IAEtE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAiCnE;AAED,wBAAgB,SAAS,CAAC,CAAC,EACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAuBhB;AAMD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAKhD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreamhorizonorg/pulse-react-native",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Production-grade observability SDK for React Native applications with OpenTelemetry support. Real-time monitoring, error tracking, performance insights, and distributed tracing.",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -10,15 +10,22 @@
       "types": "./lib/typescript/src/index.d.ts",
       "default": "./lib/module/index.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./app.plugin.js": "./app.plugin.js"
+  },
+  "bin": {
+    "pulse-cli": "./scripts/pulse-cli.js"
   },
   "files": [
     "src",
     "lib",
+    "scripts",
     "android",
     "ios",
     "cpp",
     "*.podspec",
+    "*.plugin.js",
+    "plugin/build",
     "react-native.config.js",
     "!ios/build",
     "!android/build",
@@ -36,9 +43,11 @@
     "test": "jest",
     "typecheck": "tsc",
     "lint": "eslint \"**/*.{js,ts,tsx}\"",
-    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
-    "prepare": "bob build",
-    "release": "release-it --only-version"
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib plugin/build",
+    "build:plugin": "tsc -p plugin/tsconfig.json",
+    "prepare": "npm run build:plugin && bob build",
+    "release": "release-it --only-version",
+    "pulse-cli": "node scripts/pulse-cli.js"
   },
   "keywords": [
     "react-native",
@@ -72,6 +81,7 @@
     "@eslint/eslintrc": "^3.3.1",
     "@eslint/js": "^9.35.0",
     "@evilmartians/lefthook": "^1.12.3",
+    "@expo/config-plugins": "^54.0.0",
     "@react-native-community/cli": "20.0.1",
     "@react-native/babel-preset": "0.81.1",
     "@react-native/eslint-config": "^0.81.1",
@@ -82,7 +92,9 @@
     "del-cli": "^6.0.0",
     "eslint": "^9.35.0",
     "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-jest": "^29.11.0",
     "eslint-plugin-prettier": "^5.5.4",
+    "expo-module-scripts": "^5.0.8",
     "jest": "^29.7.0",
     "prettier": "^3.6.2",
     "react": "19.1.0",
@@ -92,10 +104,6 @@
     "turbo": "^2.5.6",
     "typescript": "^5.9.2"
   },
-  "peerDependencies": {
-    "react": "*",
-    "react-native": "*"
-  },
   "workspaces": [
     "example"
   ],
@@ -161,5 +169,17 @@
     "languages": "kotlin-objc",
     "type": "turbo-module",
     "version": "0.54.8"
+  },
+  "dependencies": {
+    "commander": "^14.0.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "app.plugin.js": "./app.plugin.js",
+  "peerDependencies": {
+    "@expo/config-plugins": "*",
+    "react": "*",
+    "react-native": "*"
   }
 }

package/plugin/build/index.d.ts

@@ -0,0 +1,4 @@
+import { type ConfigPlugin } from '@expo/config-plugins';
+import type { PulsePluginProps } from './types';
+declare const _default: ConfigPlugin<PulsePluginProps>;
+export default _default;

package/plugin/build/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_plugins_1 = require("@expo/config-plugins");
+const withAndroidPulse_1 = require("./withAndroidPulse");
+const pkg = require('../../package.json');
+const withPulsePlugin = (config, props) => {
+    config = (0, withAndroidPulse_1.withAndroidPulse)(config, props);
+    return config;
+};
+exports.default = (0, config_plugins_1.createRunOncePlugin)(withPulsePlugin, pkg.name, pkg.version);

package/plugin/build/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * OpenTelemetry attribute value types.
+ * Based on OpenTelemetry JavaScript SDK attribute types.
+ * @see https://github.com/open-telemetry/opentelemetry-js/blob/main/api/src/common/Attributes.ts
+ */
+export type PulseAttributeValue = string | number | boolean | string[] | number[] | boolean[];
+export type PulseAttributes = Record<string, PulseAttributeValue | undefined | null>;
+interface IInteractionConfig {
+    enabled: boolean;
+    url?: string;
+}
+export interface PulsePluginProps {
+    endpointBaseUrl: string;
+    endpointHeaders?: Record<string, string>;
+    globalAttributes?: PulseAttributes;
+    instrumentation?: {
+        interaction?: IInteractionConfig;
+        activity?: boolean;
+        network?: boolean;
+        anr?: boolean;
+        crash?: boolean;
+        slowRendering?: boolean;
+        fragment?: boolean;
+    };
+}
+export {};

package/plugin/build/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/plugin/build/utils.d.ts

@@ -0,0 +1,9 @@
+export declare const PULSE_IMPORT = "import com.pulsereactnativeotel.Pulse\n";
+export declare const ATTRIBUTES_IMPORT = "import io.opentelemetry.api.common.Attributes\nimport io.opentelemetry.api.common.AttributeKey\n";
+import type { PulsePluginProps } from './types';
+export declare function buildPulseInitializationCode(options: {
+    endpointBaseUrl: string;
+    endpointHeaders?: Record<string, string>;
+    globalAttributes?: PulsePluginProps['globalAttributes'];
+    instrumentation?: PulsePluginProps['instrumentation'];
+}): string;

package/plugin/build/utils.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ATTRIBUTES_IMPORT = exports.PULSE_IMPORT = void 0;
+exports.buildPulseInitializationCode = buildPulseInitializationCode;
+exports.PULSE_IMPORT = 'import com.pulsereactnativeotel.Pulse\n';
+exports.ATTRIBUTES_IMPORT = 'import io.opentelemetry.api.common.Attributes\nimport io.opentelemetry.api.common.AttributeKey\n';
+function buildEndpointHeadersMap(headers) {
+    const entries = Object.entries(headers).map(([k, v]) => {
+        return '"' + k + '" to "' + v + '"';
+    });
+    return `mapOf(${entries.join(', ')})`;
+}
+function buildGlobalAttributesLambda(attributes) {
+    const puts = [];
+    Object.entries(attributes)
+        .filter(([, value]) => {
+        if (value === null || value === undefined)
+            return false;
+        if (typeof value === 'string' && value === '')
+            return false;
+        if (Array.isArray(value) && value.length === 0)
+            return false;
+        return true;
+    })
+        .forEach(([k, v]) => {
+        if (typeof v === 'string') {
+            puts.push(`put(AttributeKey.stringKey("${k}"), "${v}")`);
+        }
+        else if (typeof v === 'number') {
+            puts.push(`put(AttributeKey.${Number.isInteger(v) ? 'long' : 'double'}Key("${k}"), ${v}${Number.isInteger(v) ? 'L' : ''})`);
+        }
+        else if (typeof v === 'boolean') {
+            puts.push(`put(AttributeKey.booleanKey("${k}"), ${v})`);
+        }
+        else if (Array.isArray(v)) {
+            const first = v[0];
+            if (typeof first === 'string') {
+                puts.push(`put(AttributeKey.stringArrayKey("${k}"), listOf(${v.map((x) => `"${x}"`).join(', ')}))`);
+            }
+            else if (typeof first === 'number') {
+                const allInts = v.every((x) => Number.isInteger(x));
+                const values = allInts
+                    ? v.map((x) => `${x}L`).join(', ')
+                    : v
+                        .map((x) => (Number.isInteger(x) ? `${x}.0` : `${x}`))
+                        .join(', ');
+                puts.push(`put(AttributeKey.${allInts ? 'long' : 'double'}ArrayKey("${k}"), listOf(${values}))`);
+            }
+            else if (typeof first === 'boolean') {
+                puts.push(`put(AttributeKey.booleanArrayKey("${k}"), listOf(${v.join(', ')}))`);
+            }
+        }
+    });
+    if (puts.length === 0)
+        return 'null';
+    const formatted = puts
+        .map((put) => `                        ${put}`)
+        .join('\n');
+    return `{\n                    Attributes.builder().apply {\n${formatted}\n                    }.build()\n                }`;
+}
+function buildPulseInitializationCode(options) {
+    const { endpointBaseUrl, endpointHeaders, globalAttributes, instrumentation, } = options;
+    const params = [];
+    if (endpointHeaders && Object.keys(endpointHeaders).length > 0) {
+        params.push(`endpointHeaders = ${buildEndpointHeadersMap(endpointHeaders)}`);
+    }
+    const attributesLambda = globalAttributes
+        ? buildGlobalAttributesLambda(globalAttributes)
+        : null;
+    if (attributesLambda && attributesLambda !== 'null') {
+        params.push(`globalAttributes = ${attributesLambda}`);
+    }
+    let code = `\n    Pulse.initialize(\n      this,\n      "${endpointBaseUrl}"${params.length > 0 ? `,\n      ${params.join(',\n      ')}` : ''}\n    ) {\n`;
+    if (instrumentation?.interaction !== undefined) {
+        if (instrumentation.interaction.url) {
+            code += `      interaction { enabled(${instrumentation.interaction.enabled}); setConfigUrl { "${instrumentation.interaction.url}" } }\n`;
+        }
+        else {
+            code += `      interaction { enabled(${instrumentation.interaction.enabled}) }\n`;
+        }
+    }
+    if (instrumentation?.activity !== undefined) {
+        code += `      activity { enabled(${instrumentation.activity}) }\n`;
+    }
+    if (instrumentation?.network !== undefined) {
+        code += `      networkMonitoring { enabled(${instrumentation.network}) }\n`;
+    }
+    if (instrumentation?.anr !== undefined) {
+        code += `      anrReporter { enabled(${instrumentation.anr}) }\n`;
+    }
+    if (instrumentation?.slowRendering !== undefined) {
+        code += `      slowRenderingReporter { enabled(${instrumentation.slowRendering}) }\n`;
+    }
+    if (instrumentation?.fragment !== undefined) {
+        code += `      fragment { enabled(${instrumentation.fragment}) }\n`;
+    }
+    if (instrumentation?.crash !== undefined) {
+        code += `      crashReporter { enabled(${instrumentation.crash}) }\n`;
+    }
+    code += '    }\n';
+    return code;
+}

package/plugin/build/withAndroidPulse.d.ts

@@ -0,0 +1,3 @@
+import type { ConfigPlugin } from '@expo/config-plugins';
+import type { PulsePluginProps } from './types';
+export declare const withAndroidPulse: ConfigPlugin<PulsePluginProps>;

package/plugin/build/withAndroidPulse.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withAndroidPulse = void 0;
+const config_plugins_1 = require("@expo/config-plugins");
+const generateCode_1 = require("@expo/config-plugins/build/utils/generateCode");
+const utils_1 = require("./utils");
+const withAndroidPulse = (config, props) => {
+    return (0, config_plugins_1.withMainApplication)(config, (modConfig) => {
+        try {
+            const { endpointBaseUrl, endpointHeaders, globalAttributes, instrumentation, } = props;
+            // 1. Add import statements
+            modConfig.modResults.contents = (0, generateCode_1.mergeContents)({
+                src: modConfig.modResults.contents,
+                newSrc: utils_1.PULSE_IMPORT,
+                tag: 'pulse-sdk-import',
+                comment: '//',
+                anchor: /import\s+com\.facebook\.react\.ReactApplication/,
+                offset: 1,
+            }).contents;
+            if (globalAttributes && Object.keys(globalAttributes).length > 0) {
+                modConfig.modResults.contents = (0, generateCode_1.mergeContents)({
+                    src: modConfig.modResults.contents,
+                    newSrc: utils_1.ATTRIBUTES_IMPORT,
+                    tag: 'pulse-attributes-import',
+                    comment: '//',
+                    anchor: /import\s+com\.pulsereactnativeotel\.Pulse/,
+                    offset: 1,
+                }).contents;
+            }
+            const initCode = (0, utils_1.buildPulseInitializationCode)({
+                endpointBaseUrl,
+                endpointHeaders,
+                globalAttributes,
+                instrumentation,
+            });
+            // 2. Add initialization code after super.onCreate()
+            modConfig.modResults.contents = (0, generateCode_1.mergeContents)({
+                src: modConfig.modResults.contents,
+                newSrc: initCode,
+                tag: 'pulse-sdk-initialization',
+                comment: '//',
+                anchor: /super\.onCreate\(\)/,
+                offset: 1,
+            }).contents;
+            return modConfig;
+        }
+        catch (error) {
+            console.error('Error modifying MainApplication:', error);
+            return modConfig;
+        }
+    });
+};
+exports.withAndroidPulse = withAndroidPulse;

package/scripts/pulse-cli.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+
+const { checkAndAssertNodeVersion } = require('./utils');
+checkAndAssertNodeVersion();
+
+const { Command } = require('commander');
+const { upload } = require('./uploadService');
+const TAG_OPTIONAL = '(OPTIONAL)';
+
+const program = new Command();
+
+program
+  .name('pulse-cli')
+  .description('Pulse CLI - Command-line tool for Pulse SDK')
+  .usage('[command] [subcommand] [options]')
+  .version(require('../package.json').version);
+
+const uploadCommand = new Command('upload')
+  .description(
+    'Upload multiple symbol files to deobfuscate stack traces and improve error debugging.'
+  )
+  .usage('[subcommand] [options]');
+
+uploadCommand
+  .command('react-native-android')
+  .description('Upload React Native Android files')
+  .requiredOption(
+    '-u, --api-url <url>',
+    'URL for uploading source maps and related build artifacts.'
+  )
+  .requiredOption(
+    '-v, --app-version <version>',
+    'App version of the application (e.g., 1.0.0)'
+  )
+  .requiredOption('-c, --version-code <code>', 'Version code (e.g., 1)')
+  .requiredOption(
+    '-j, --js-sourcemap <path>',
+    'JavaScript source map file path'
+  )
+  .option(
+    '-b, --bundle-id <id>',
+    `${TAG_OPTIONAL} CodePush bundle label for identifying the specific bundle version (e.g., v1)`
+  )
+  .option(
+    '-m, --mapping <path>',
+    `${TAG_OPTIONAL} ProGuard/R8 mapping file path`
+  )
+  .option('-d, --debug', `${TAG_OPTIONAL} Show debug information`)
+  .action(async (options) => {
+    await upload('react-native-android', options);
+  });
+
+uploadCommand
+  .command('react-native-ios')
+  .description('Upload React Native iOS source maps')
+  .requiredOption(
+    '-u, --api-url <url>',
+    'URL for uploading source maps and related build artifacts.'
+  )
+  .requiredOption(
+    '-v, --bundle-version <version>',
+    'Bundle version from Info.plist CFBundleShortVersionString (e.g., 1.0.0)'
+  )
+  .requiredOption('-c, --version-code <code>', 'Version code (e.g., 1)')
+  .requiredOption(
+    '-j, --js-sourcemap <path>',
+    'JavaScript source map file path'
+  )
+  .option(
+    '-b, --bundle-id <id>',
+    `${TAG_OPTIONAL} CodePush bundle label for identifying the specific bundle version (e.g., v1)`
+  )
+  .option('-d, --debug', `${TAG_OPTIONAL} Show debug information`)
+  .action(async (options) => {
+    await upload('react-native-ios', options);
+  });
+
+program.addCommand(uploadCommand);
+
+program.showHelpAfterError();
+
+program.parse();

package/scripts/uploadService.js

@@ -0,0 +1,122 @@
+/* global Buffer */
+const fs = require('fs');
+const {
+  getPlatform,
+  validateFiles,
+  validateVersionVersionCodeBundleId,
+} = require('./utils');
+
+function buildMetadata(files, appVersion, versionCode, platform, bundleId) {
+  const metadata = files.map((file) => ({
+    type: file.metadataType,
+    appVersion: appVersion,
+    versionCode: versionCode,
+    platform: platform,
+    fileName: file.fileName,
+    bundleId: bundleId || null,
+  }));
+  return metadata;
+}
+
+async function uploadFiles(commandName, options) {
+  const platform = getPlatform(commandName);
+  const files = validateFiles(options);
+  const version =
+    platform === 'ios' ? options.bundleVersion : options.appVersion;
+
+  const metadata = buildMetadata(
+    files,
+    version,
+    options.versionCode,
+    platform,
+    options.bundleId
+  );
+
+  const formData = new FormData();
+  const metadataContent = JSON.stringify(metadata, null, 2);
+
+  if (options.debug) {
+    console.log('\n📋 Metadata content (metadata.txt):');
+    console.log('─'.repeat(60));
+    console.log(metadataContent);
+    console.log('─'.repeat(60));
+    console.log(
+      `Metadata size: ${Buffer.byteLength(metadataContent, 'utf-8')} bytes\n`
+    );
+  }
+
+  const metadataBlob = new Blob([metadataContent], {
+    type: 'application/json',
+  });
+  formData.append('metadata', metadataBlob, 'metadata.txt');
+
+  for (const file of files) {
+    const fileBuffer = fs.readFileSync(file.path);
+    const fileBlob = new Blob([fileBuffer]);
+    formData.append('fileContent', fileBlob, file.fileName);
+  }
+
+  console.log(`\n📤 Uploading ${files.length} file(s) to ${options.apiUrl}...`);
+  console.log(`   Command: ${commandName}`);
+  console.log(`   Platform: ${platform}`);
+  files.forEach((file) => {
+    console.log(`   - ${file.fileName} (${file.metadataType})`);
+  });
+
+  if (options.debug) {
+    console.log('\n🔍 Debug Info:');
+    console.log(`   API URL: ${options.apiUrl}`);
+    console.log(`   App Version: ${version}`);
+    console.log(`   Version Code: ${options.versionCode}`);
+    if (options.bundleId) {
+      console.log(`   Bundle ID: ${options.bundleId}`);
+    }
+    files.forEach((file) => {
+      const stats = fs.statSync(file.path);
+      console.log(
+        `   File: ${file.fileName} (${(stats.size / 1024).toFixed(2)} KB)`
+      );
+      console.log(`   File Path: ${file.path}`);
+    });
+  }
+
+  const response = await fetch(options.apiUrl, {
+    method: 'POST',
+    body: formData,
+  });
+
+  const responseData = await response.json().catch(async () => {
+    const text = await response.text();
+    return text ? { message: text } : {};
+  });
+
+  if (options.debug && responseData && Object.keys(responseData).length > 0) {
+    console.log('\n📥 Backend Response:');
+    console.log(`   Status: ${response.status} ${response.statusText}`);
+    console.log(`   Response: ${JSON.stringify(responseData, null, 2)}`);
+  }
+
+  if (!response.ok) {
+    const errorText =
+      responseData.error || responseData.message || 'Unknown error';
+    throw new Error(
+      `Upload failed: HTTP ${response.status} ${response.statusText}. ${errorText}`
+    );
+  }
+
+  console.log('\n✓ Files uploaded successfully');
+}
+
+async function upload(commandName, options) {
+  try {
+    validateVersionVersionCodeBundleId(options, commandName);
+    await uploadFiles(commandName, options);
+  } catch (error) {
+    console.error(`\n✗ Error: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  upload,
+};