@flareapp/core 2.5.1 → 2.6.0

package/dist/index.cjs

@@ -30,7 +30,7 @@ let error_stack_parser = require("error-stack-parser");
 error_stack_parser = __toESM(error_stack_parser);
 
 //#region src/env/index.ts
-const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.5.1" : "?";
+const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.6.0" : "?";
 const KEY = typeof FLARE_JS_KEY === "undefined" ? "" : FLARE_JS_KEY;
 const SOURCEMAP_VERSION = typeof FLARE_SOURCEMAP_VERSION === "undefined" ? "" : FLARE_SOURCEMAP_VERSION;
 
@@ -171,6 +171,49 @@ function safeDecode(value) {
 	}
 }
 
+//#endregion
+//#region src/util/rejection.ts
+/** Best-effort human-readable description of an arbitrary rejection reason. */
+function describeRejectionReason(reason) {
+	if (typeof reason === "string") return reason;
+	if (reason && typeof reason === "object") {
+		const message = reason.message;
+		if (typeof message === "string" && message) return message;
+		try {
+			return JSON.stringify(reason);
+		} catch {
+			return "Unhandled promise rejection (non-serializable reason)";
+		}
+	}
+	return String(reason);
+}
+function hasStack$1(reason) {
+	return !!reason && typeof reason === "object" && typeof reason.stack === "string";
+}
+/**
+* Route a rejection reason to the reporter: an Error (or any stack-bearing
+* object) goes to `reportSilently` so the STACK survives; only a stackless
+* reason falls back to `reportUnhandledRejection` (string message, empty-stack
+* `UnhandledRejection` class). Any rejection from `reportUnhandledRejection`'s
+* returned promise is swallowed so a transport failure cannot itself surface as
+* an unhandled rejection. `reportSilently` is assumed not to throw synchronously
+* (core's does its work asynchronously); it is intentionally not wrapped, so a
+* synchronous throw there would propagate.
+*/
+function routeRejection(reporter, reason) {
+	if (reason instanceof Error) {
+		reporter.reportSilently(reason);
+		return;
+	}
+	if (hasStack$1(reason)) {
+		const error = new Error(describeRejectionReason(reason));
+		error.stack = reason.stack;
+		reporter.reportSilently(error);
+		return;
+	}
+	Promise.resolve(reporter.reportUnhandledRejection(describeRejectionReason(reason))).catch(() => {});
+}
+
 //#endregion
 //#region src/api/Api.ts
 var Api = class {
@@ -674,18 +717,24 @@ function createStackTrace(error, debug, fileReader) {
 			return resolve([fallbackFrame("stacktrace could not be parsed")]);
 		}
 		Promise.all(parsedFrames.map((frame) => {
-			return getCodeSnippet(fileReader, frame.fileName, frame.lineNumber, frame.columnNumber).then((snippet) => ({
+			const fileName = normalizeFileName(frame.fileName);
+			return getCodeSnippet(fileReader, fileName, frame.lineNumber, frame.columnNumber).then((snippet) => ({
 				lineNumber: frame.lineNumber || 1,
 				columnNumber: frame.columnNumber || 1,
 				method: frame.functionName || "Anonymous or unknown function",
-				file: frame.fileName || "Unknown file",
+				file: fileName || "Unknown file",
 				codeSnippet: snippet.codeSnippet,
 				class: "",
-				isApplicationFrame: isApplicationFrame(frame.fileName)
+				isApplicationFrame: isApplicationFrame(fileName)
 			}));
 		})).then(resolve);
 	});
 }
+const HERMES_ADDRESS_PREFIX = "address at ";
+function normalizeFileName(fileName) {
+	if (fileName?.startsWith(HERMES_ADDRESS_PREFIX)) return fileName.slice(11);
+	return fileName;
+}
 function fallbackFrame(reason) {
 	return {
 		lineNumber: 0,
@@ -1196,6 +1245,7 @@ exports.assert = assert;
 exports.assertKey = assertKey;
 exports.convertToError = convertToError;
 exports.createStackTrace = createStackTrace;
+exports.describeRejectionReason = describeRejectionReason;
 exports.extractCode = extractCode;
 exports.flatJsonStringify = flatJsonStringify;
 exports.getCodeSnippet = getCodeSnippet;
@@ -1204,4 +1254,5 @@ exports.now = now;
 exports.readLinesFromFile = readLinesFromFile;
 exports.redactUrlQuery = redactUrlQuery;
 exports.resolveDenylist = resolveDenylist;
+exports.routeRejection = routeRejection;
 exports.userIdentityAttributes = userIdentityAttributes;

package/dist/index.d.cts

@@ -185,6 +185,34 @@ declare const DEFAULT_URL_DENYLIST: RegExp;
 declare function resolveDenylist(custom?: RegExp, replaceDefault?: boolean, defaultDenylist?: RegExp): RegExp;
 declare function redactUrlQuery(fullPath: string, denylist?: RegExp): string;
 //#endregion
+//#region src/util/rejection.d.ts
+/**
+ * Shared unhandled-rejection routing. A rejection "reason" can be anything a
+ * promise was rejected with: an Error, an Error-like object carrying a `.stack`,
+ * a string, or a plain object. The browser `unhandledrejection` listener
+ * (`@flareapp/js`) and the React Native engine rejection tracker
+ * (`@flareapp/react-native`) need the SAME routing so a report looks identical
+ * across SDKs, so it lives here instead of being copy-pasted (and drifting) per
+ * client.
+ */
+type RejectionReporter = {
+  reportSilently: (error: Error) => void;
+  reportUnhandledRejection: (message: string) => unknown;
+};
+/** Best-effort human-readable description of an arbitrary rejection reason. */
+declare function describeRejectionReason(reason: unknown): string;
+/**
+ * Route a rejection reason to the reporter: an Error (or any stack-bearing
+ * object) goes to `reportSilently` so the STACK survives; only a stackless
+ * reason falls back to `reportUnhandledRejection` (string message, empty-stack
+ * `UnhandledRejection` class). Any rejection from `reportUnhandledRejection`'s
+ * returned promise is swallowed so a transport failure cannot itself surface as
+ * an unhandled rejection. `reportSilently` is assumed not to throw synchronously
+ * (core's does its work asynchronously); it is intentionally not wrapped, so a
+ * synchronous throw there would propagate.
+ */
+declare function routeRejection(reporter: RejectionReporter, reason: unknown): void;
+//#endregion
 //#region src/api/Api.d.ts
 declare class Api {
   report(report: Report, url: string, key: string | null, reportBrowserExtensionErrors: boolean, debug?: boolean): Promise<void>;
@@ -580,4 +608,4 @@ declare class NullFileReader implements FileReader {
 //#region src/stacktrace/createStackTrace.d.ts
 declare function createStackTrace(error: Error, debug: boolean, fileReader: FileReader): Promise<Array<StackFrame>>;
 //#endregion
-export { type AnyValue, Api, type AttributeValue, type Attributes, type BufferedLog, type Config, type ContextCollector, DEFAULT_URL_DENYLIST, type EntryPointHandler, type FileReader, Flare, type FlushFn, type FlushScheduler, type Framework, GlobalScopeProvider, type Glow, type KeyValue, Logger, type LoggerDeps, type LogsEnvelope, type MessageLevel, NoopFlushScheduler, NullFileReader, type OtelLogRecord, type OverriddenGrouping, type Report, Scope, type ScopeProvider, type SdkInfo, type SpanEvent, type StackFrame, USER_IDENTITY_KEYS, type User, assert, assertKey, convertToError, createStackTrace, extractCode, flatJsonStringify, getCodeSnippet, glowsToEvents, now, readLinesFromFile, redactUrlQuery, resolveDenylist, userIdentityAttributes };
+export { type AnyValue, Api, type AttributeValue, type Attributes, type BufferedLog, type Config, type ContextCollector, DEFAULT_URL_DENYLIST, type EntryPointHandler, type FileReader, Flare, type FlushFn, type FlushScheduler, type Framework, GlobalScopeProvider, type Glow, type KeyValue, Logger, type LoggerDeps, type LogsEnvelope, type MessageLevel, NoopFlushScheduler, NullFileReader, type OtelLogRecord, type OverriddenGrouping, type RejectionReporter, type Report, Scope, type ScopeProvider, type SdkInfo, type SpanEvent, type StackFrame, USER_IDENTITY_KEYS, type User, assert, assertKey, convertToError, createStackTrace, describeRejectionReason, extractCode, flatJsonStringify, getCodeSnippet, glowsToEvents, now, readLinesFromFile, redactUrlQuery, resolveDenylist, routeRejection, userIdentityAttributes };

package/dist/index.d.mts

@@ -185,6 +185,34 @@ declare const DEFAULT_URL_DENYLIST: RegExp;
 declare function resolveDenylist(custom?: RegExp, replaceDefault?: boolean, defaultDenylist?: RegExp): RegExp;
 declare function redactUrlQuery(fullPath: string, denylist?: RegExp): string;
 //#endregion
+//#region src/util/rejection.d.ts
+/**
+ * Shared unhandled-rejection routing. A rejection "reason" can be anything a
+ * promise was rejected with: an Error, an Error-like object carrying a `.stack`,
+ * a string, or a plain object. The browser `unhandledrejection` listener
+ * (`@flareapp/js`) and the React Native engine rejection tracker
+ * (`@flareapp/react-native`) need the SAME routing so a report looks identical
+ * across SDKs, so it lives here instead of being copy-pasted (and drifting) per
+ * client.
+ */
+type RejectionReporter = {
+  reportSilently: (error: Error) => void;
+  reportUnhandledRejection: (message: string) => unknown;
+};
+/** Best-effort human-readable description of an arbitrary rejection reason. */
+declare function describeRejectionReason(reason: unknown): string;
+/**
+ * Route a rejection reason to the reporter: an Error (or any stack-bearing
+ * object) goes to `reportSilently` so the STACK survives; only a stackless
+ * reason falls back to `reportUnhandledRejection` (string message, empty-stack
+ * `UnhandledRejection` class). Any rejection from `reportUnhandledRejection`'s
+ * returned promise is swallowed so a transport failure cannot itself surface as
+ * an unhandled rejection. `reportSilently` is assumed not to throw synchronously
+ * (core's does its work asynchronously); it is intentionally not wrapped, so a
+ * synchronous throw there would propagate.
+ */
+declare function routeRejection(reporter: RejectionReporter, reason: unknown): void;
+//#endregion
 //#region src/api/Api.d.ts
 declare class Api {
   report(report: Report, url: string, key: string | null, reportBrowserExtensionErrors: boolean, debug?: boolean): Promise<void>;
@@ -580,4 +608,4 @@ declare class NullFileReader implements FileReader {
 //#region src/stacktrace/createStackTrace.d.ts
 declare function createStackTrace(error: Error, debug: boolean, fileReader: FileReader): Promise<Array<StackFrame>>;
 //#endregion
-export { type AnyValue, Api, type AttributeValue, type Attributes, type BufferedLog, type Config, type ContextCollector, DEFAULT_URL_DENYLIST, type EntryPointHandler, type FileReader, Flare, type FlushFn, type FlushScheduler, type Framework, GlobalScopeProvider, type Glow, type KeyValue, Logger, type LoggerDeps, type LogsEnvelope, type MessageLevel, NoopFlushScheduler, NullFileReader, type OtelLogRecord, type OverriddenGrouping, type Report, Scope, type ScopeProvider, type SdkInfo, type SpanEvent, type StackFrame, USER_IDENTITY_KEYS, type User, assert, assertKey, convertToError, createStackTrace, extractCode, flatJsonStringify, getCodeSnippet, glowsToEvents, now, readLinesFromFile, redactUrlQuery, resolveDenylist, userIdentityAttributes };
+export { type AnyValue, Api, type AttributeValue, type Attributes, type BufferedLog, type Config, type ContextCollector, DEFAULT_URL_DENYLIST, type EntryPointHandler, type FileReader, Flare, type FlushFn, type FlushScheduler, type Framework, GlobalScopeProvider, type Glow, type KeyValue, Logger, type LoggerDeps, type LogsEnvelope, type MessageLevel, NoopFlushScheduler, NullFileReader, type OtelLogRecord, type OverriddenGrouping, type RejectionReporter, type Report, Scope, type ScopeProvider, type SdkInfo, type SpanEvent, type StackFrame, USER_IDENTITY_KEYS, type User, assert, assertKey, convertToError, createStackTrace, describeRejectionReason, extractCode, flatJsonStringify, getCodeSnippet, glowsToEvents, now, readLinesFromFile, redactUrlQuery, resolveDenylist, routeRejection, userIdentityAttributes };

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import ErrorStackParser from "error-stack-parser";
 
 //#region src/env/index.ts
-const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.5.1" : "?";
+const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.6.0" : "?";
 const KEY = typeof FLARE_JS_KEY === "undefined" ? "" : FLARE_JS_KEY;
 const SOURCEMAP_VERSION = typeof FLARE_SOURCEMAP_VERSION === "undefined" ? "" : FLARE_SOURCEMAP_VERSION;
 
@@ -142,6 +142,49 @@ function safeDecode(value) {
 	}
 }
 
+//#endregion
+//#region src/util/rejection.ts
+/** Best-effort human-readable description of an arbitrary rejection reason. */
+function describeRejectionReason(reason) {
+	if (typeof reason === "string") return reason;
+	if (reason && typeof reason === "object") {
+		const message = reason.message;
+		if (typeof message === "string" && message) return message;
+		try {
+			return JSON.stringify(reason);
+		} catch {
+			return "Unhandled promise rejection (non-serializable reason)";
+		}
+	}
+	return String(reason);
+}
+function hasStack$1(reason) {
+	return !!reason && typeof reason === "object" && typeof reason.stack === "string";
+}
+/**
+* Route a rejection reason to the reporter: an Error (or any stack-bearing
+* object) goes to `reportSilently` so the STACK survives; only a stackless
+* reason falls back to `reportUnhandledRejection` (string message, empty-stack
+* `UnhandledRejection` class). Any rejection from `reportUnhandledRejection`'s
+* returned promise is swallowed so a transport failure cannot itself surface as
+* an unhandled rejection. `reportSilently` is assumed not to throw synchronously
+* (core's does its work asynchronously); it is intentionally not wrapped, so a
+* synchronous throw there would propagate.
+*/
+function routeRejection(reporter, reason) {
+	if (reason instanceof Error) {
+		reporter.reportSilently(reason);
+		return;
+	}
+	if (hasStack$1(reason)) {
+		const error = new Error(describeRejectionReason(reason));
+		error.stack = reason.stack;
+		reporter.reportSilently(error);
+		return;
+	}
+	Promise.resolve(reporter.reportUnhandledRejection(describeRejectionReason(reason))).catch(() => {});
+}
+
 //#endregion
 //#region src/api/Api.ts
 var Api = class {
@@ -645,18 +688,24 @@ function createStackTrace(error, debug, fileReader) {
 			return resolve([fallbackFrame("stacktrace could not be parsed")]);
 		}
 		Promise.all(parsedFrames.map((frame) => {
-			return getCodeSnippet(fileReader, frame.fileName, frame.lineNumber, frame.columnNumber).then((snippet) => ({
+			const fileName = normalizeFileName(frame.fileName);
+			return getCodeSnippet(fileReader, fileName, frame.lineNumber, frame.columnNumber).then((snippet) => ({
 				lineNumber: frame.lineNumber || 1,
 				columnNumber: frame.columnNumber || 1,
 				method: frame.functionName || "Anonymous or unknown function",
-				file: frame.fileName || "Unknown file",
+				file: fileName || "Unknown file",
 				codeSnippet: snippet.codeSnippet,
 				class: "",
-				isApplicationFrame: isApplicationFrame(frame.fileName)
+				isApplicationFrame: isApplicationFrame(fileName)
 			}));
 		})).then(resolve);
 	});
 }
+const HERMES_ADDRESS_PREFIX = "address at ";
+function normalizeFileName(fileName) {
+	if (fileName?.startsWith(HERMES_ADDRESS_PREFIX)) return fileName.slice(11);
+	return fileName;
+}
 function fallbackFrame(reason) {
 	return {
 		lineNumber: 0,
@@ -1154,4 +1203,4 @@ var Flare = class {
 };
 
 //#endregion
-export { Api, DEFAULT_URL_DENYLIST, Flare, GlobalScopeProvider, Logger, NoopFlushScheduler, NullFileReader, Scope, USER_IDENTITY_KEYS, assert, assertKey, convertToError, createStackTrace, extractCode, flatJsonStringify, getCodeSnippet, glowsToEvents, now, readLinesFromFile, redactUrlQuery, resolveDenylist, userIdentityAttributes };
+export { Api, DEFAULT_URL_DENYLIST, Flare, GlobalScopeProvider, Logger, NoopFlushScheduler, NullFileReader, Scope, USER_IDENTITY_KEYS, assert, assertKey, convertToError, createStackTrace, describeRejectionReason, extractCode, flatJsonStringify, getCodeSnippet, glowsToEvents, now, readLinesFromFile, redactUrlQuery, resolveDenylist, routeRejection, userIdentityAttributes };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@flareapp/core",
-    "version": "2.5.1",
+    "version": "2.6.0",
     "description": "Environment-agnostic core for the Flare JS SDK",
     "homepage": "https://flareapp.io",
     "bugs": {