@flareapp/js 2.6.0 → 2.8.0

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_catchWindowErrors = require('./catchWindowErrors-_IlVo06V.cjs');
+const require_componentProfiler = require('./componentProfiler-C6qY96Bt.cjs');
 const require_browser = require('./browser.cjs');
 let _flareapp_core = require("@flareapp/core");
 
@@ -7,7 +7,7 @@ let _flareapp_core = require("@flareapp/core");
 const flare = new require_browser.Flare();
 if (typeof window !== "undefined" && window) {
 	window.flare = flare;
-	require_catchWindowErrors.catchWindowErrors();
+	require_componentProfiler.catchWindowErrors();
 }
 
 //#endregion
@@ -18,6 +18,12 @@ Object.defineProperty(exports, 'DEFAULT_URL_DENYLIST', {
   }
 });
 exports.Flare = require_browser.Flare;
+Object.defineProperty(exports, 'FrameworkName', {
+  enumerable: true,
+  get: function () {
+    return _flareapp_core.FrameworkName;
+  }
+});
 Object.defineProperty(exports, 'GlobalScopeProvider', {
   enumerable: true,
   get: function () {
@@ -48,6 +54,7 @@ Object.defineProperty(exports, 'convertToError', {
     return _flareapp_core.convertToError;
   }
 });
+exports.createFlareResolver = require_componentProfiler.createFlareResolver;
 exports.flare = flare;
 Object.defineProperty(exports, 'redactFullPath', {
   enumerable: true,
@@ -55,6 +62,12 @@ Object.defineProperty(exports, 'redactFullPath', {
     return _flareapp_core.redactUrlQuery;
   }
 });
+Object.defineProperty(exports, 'redactObjectValues', {
+  enumerable: true,
+  get: function () {
+    return _flareapp_core.redactObjectValues;
+  }
+});
 Object.defineProperty(exports, 'redactUrlQuery', {
   enumerable: true,
   get: function () {
@@ -66,4 +79,10 @@ Object.defineProperty(exports, 'resolveDenylist', {
   get: function () {
     return _flareapp_core.resolveDenylist;
   }
+});
+Object.defineProperty(exports, 'toCustomContext', {
+  enumerable: true,
+  get: function () {
+    return _flareapp_core.toCustomContext;
+  }
 });

package/dist/index.d.cts

@@ -1,7 +1,8 @@
+import { T as createFlareResolver } from "./spanTypes-iA1RdfLw.cjs";
 import { Flare } from "./browser.cjs";
-import { AttributeValue, Attributes, Config, ContextCollector, DEFAULT_URL_DENYLIST, EntryPointHandler, FileReader, FlushFn, FlushScheduler, Framework, GlobalScopeProvider, Glow, Logger, MessageLevel, NullFileReader, OverriddenGrouping, Report, Scope, ScopeProvider, SdkInfo, SpanEvent, StackFrame, User, convertToError, redactUrlQuery, redactUrlQuery as redactFullPath, resolveDenylist } from "@flareapp/core";
+import { AttributeValue, Attributes, Config, ContextCollector, DEFAULT_URL_DENYLIST, EntryPointHandler, FileReader, FlushFn, FlushScheduler, Framework, FrameworkName, GlobalScopeProvider, Glow, Logger, MessageLevel, NullFileReader, OverriddenGrouping, Report, Scope, ScopeProvider, SdkInfo, SpanEvent, StackFrame, User, convertToError, redactObjectValues, redactUrlQuery, redactUrlQuery as redactFullPath, resolveDenylist, toCustomContext } from "@flareapp/core";
 
 //#region src/index.d.ts
 declare const flare: Flare;
 //#endregion
-export { type AttributeValue, type Attributes, type Config, type ContextCollector, DEFAULT_URL_DENYLIST, type EntryPointHandler, type FileReader, Flare, type FlushFn, type FlushScheduler, type Framework, GlobalScopeProvider, type Glow, Logger, type MessageLevel, NullFileReader, type OverriddenGrouping, type Report, Scope, type ScopeProvider, type SdkInfo, type SpanEvent, type StackFrame, type User, convertToError, flare, redactFullPath, redactUrlQuery, resolveDenylist };
+export { type AttributeValue, type Attributes, type Config, type ContextCollector, DEFAULT_URL_DENYLIST, type EntryPointHandler, type FileReader, Flare, type FlushFn, type FlushScheduler, type Framework, FrameworkName, GlobalScopeProvider, type Glow, Logger, type MessageLevel, NullFileReader, type OverriddenGrouping, type Report, Scope, type ScopeProvider, type SdkInfo, type SpanEvent, type StackFrame, type User, convertToError, createFlareResolver, flare, redactFullPath, redactObjectValues, redactUrlQuery, resolveDenylist, toCustomContext };

package/dist/index.d.mts

@@ -1,7 +1,8 @@
+import { T as createFlareResolver } from "./spanTypes-CjF1_Uqi.mjs";
 import { Flare } from "./browser.mjs";
-import { AttributeValue, Attributes, Config, ContextCollector, DEFAULT_URL_DENYLIST, EntryPointHandler, FileReader, FlushFn, FlushScheduler, Framework, GlobalScopeProvider, Glow, Logger, MessageLevel, NullFileReader, OverriddenGrouping, Report, Scope, ScopeProvider, SdkInfo, SpanEvent, StackFrame, User, convertToError, redactUrlQuery, redactUrlQuery as redactFullPath, resolveDenylist } from "@flareapp/core";
+import { AttributeValue, Attributes, Config, ContextCollector, DEFAULT_URL_DENYLIST, EntryPointHandler, FileReader, FlushFn, FlushScheduler, Framework, FrameworkName, GlobalScopeProvider, Glow, Logger, MessageLevel, NullFileReader, OverriddenGrouping, Report, Scope, ScopeProvider, SdkInfo, SpanEvent, StackFrame, User, convertToError, redactObjectValues, redactUrlQuery, redactUrlQuery as redactFullPath, resolveDenylist, toCustomContext } from "@flareapp/core";
 
 //#region src/index.d.ts
 declare const flare: Flare;
 //#endregion
-export { type AttributeValue, type Attributes, type Config, type ContextCollector, DEFAULT_URL_DENYLIST, type EntryPointHandler, type FileReader, Flare, type FlushFn, type FlushScheduler, type Framework, GlobalScopeProvider, type Glow, Logger, type MessageLevel, NullFileReader, type OverriddenGrouping, type Report, Scope, type ScopeProvider, type SdkInfo, type SpanEvent, type StackFrame, type User, convertToError, flare, redactFullPath, redactUrlQuery, resolveDenylist };
+export { type AttributeValue, type Attributes, type Config, type ContextCollector, DEFAULT_URL_DENYLIST, type EntryPointHandler, type FileReader, Flare, type FlushFn, type FlushScheduler, type Framework, FrameworkName, GlobalScopeProvider, type Glow, Logger, type MessageLevel, NullFileReader, type OverriddenGrouping, type Report, Scope, type ScopeProvider, type SdkInfo, type SpanEvent, type StackFrame, type User, convertToError, createFlareResolver, flare, redactFullPath, redactObjectValues, redactUrlQuery, resolveDenylist, toCustomContext };

package/dist/index.mjs

@@ -1,6 +1,6 @@
-import { t as catchWindowErrors } from "./catchWindowErrors-DaCqd2yC.mjs";
+import { o as catchWindowErrors, s as createFlareResolver } from "./componentProfiler-CoH2m13n.mjs";
 import { Flare } from "./browser.mjs";
-import { DEFAULT_URL_DENYLIST, GlobalScopeProvider, Logger, NullFileReader, Scope, convertToError, redactUrlQuery, redactUrlQuery as redactFullPath, resolveDenylist } from "@flareapp/core";
+import { DEFAULT_URL_DENYLIST, FrameworkName, GlobalScopeProvider, Logger, NullFileReader, Scope, convertToError, redactObjectValues, redactUrlQuery, redactUrlQuery as redactFullPath, resolveDenylist, toCustomContext } from "@flareapp/core";
 
 //#region src/index.ts
 const flare = new Flare();
@@ -10,4 +10,4 @@ if (typeof window !== "undefined" && window) {
 }
 
 //#endregion
-export { DEFAULT_URL_DENYLIST, Flare, GlobalScopeProvider, Logger, NullFileReader, Scope, convertToError, flare, redactFullPath, redactUrlQuery, resolveDenylist };
+export { DEFAULT_URL_DENYLIST, Flare, FrameworkName, GlobalScopeProvider, Logger, NullFileReader, Scope, convertToError, createFlareResolver, flare, redactFullPath, redactObjectValues, redactUrlQuery, resolveDenylist, toCustomContext };

package/dist/spanTypes-CjF1_Uqi.d.mts

@@ -0,0 +1,161 @@
+import { Flare as Flare$1 } from "./browser.mjs";
+import { Attributes, BrowserSpanType, Config, ContextCollector, FileReader, FlushFn, FlushScheduler, defaultNowNano } from "@flareapp/core";
+
+//#region src/createFlareResolver.d.ts
+/**
+ * Builds a per-package Flare resolver: `registerDefaultFlare` (wired once by the web entry) and
+ * `resolveFlare` (called at wiring time). Each call holds its own default-provider state. The check
+ * that warns about the Electron `__flare` bridge uses `packageName` in its message;
+ * `injectInstruction` replaces the closing hint for packages whose advice differs (for example
+ * svelte, which points at the preprocessor's importSource).
+ */
+declare function createFlareResolver(config: {
+  packageName: string;
+  injectInstruction?: string;
+}): {
+  registerDefaultFlare(provider: () => Flare$1): void;
+  resolveFlare(explicit?: Flare$1): Flare$1;
+};
+//#endregion
+//#region src/browser/catchWindowErrors.d.ts
+/**
+ * Wire up global `error` and `unhandledrejection` listeners, routing reports through `window.flare`
+ * (assigned by Flare.light()/configure()). Events are dropped, not queued, when the global is absent.
+ */
+declare function catchWindowErrors(): void;
+//#endregion
+//#region src/browser/context/collectBrowser.d.ts
+declare const collectBrowser: ContextCollector;
+//#endregion
+//#region src/browser/FetchFileReader.d.ts
+/**
+ * Fetches source files so the stack-trace builder can render a snippet around the offending line.
+ * Only http(s) is fetched: other schemes (chrome-extension://, file://, blob:, data:) would cross a
+ * privilege boundary or hit a CORS/CSP wall for nothing. Returns null on any failure, never throws.
+ */
+declare class FetchFileReader implements FileReader {
+  read(url: string): Promise<string | null>;
+}
+//#endregion
+//#region src/browser/BrowserFlushScheduler.d.ts
+declare class BrowserFlushScheduler implements FlushScheduler {
+  register(flush: FlushFn): void;
+}
+//#endregion
+//#region src/tracing/navigation.d.ts
+type RouteName = {
+  name: string;
+  source: 'route' | 'url';
+  /**
+   * Where the navigation is going. Re-stamps the root's `url.full` alongside the name, so a redirected
+   * or superseded navigation reports where it ended rather than where it opened. Omit to keep the url
+   * the root started with.
+   */
+  url?: string;
+};
+type NavigationSource = {
+  startNavigation(opts?: {
+    path?: string;
+    url?: string;
+    hold?: boolean;
+  }): void;
+  setActiveRouteName(route: RouteName): void;
+  settleNavigation(route: RouteName): void;
+  unregister(): void;
+};
+/** The path the address bar is on, or '' outside a browser. */
+declare function currentPath(): string;
+/**
+ * Prefers the router's parameterized template over the raw path, so names aggregate per route rather
+ * than per url. `derive` runs inside a try: a router that throws on an unresolved match chain falls back
+ * to the url name instead of taking the host down.
+ */
+declare function routeName(derive: () => string | undefined, fallbackPath: string, url?: string): RouteName;
+/**
+ * `build` is the router's own href builder (vue-router's `resolve`, React Router's `createHref`), which
+ * is what puts the app's base path and hash prefix back on. Without it an app served from `/app/` reports
+ * `/product/p01` for the real `/app/product/p01`. A router that throws still gets a url from `fallback`.
+ */
+declare function resolveHref(build: () => string | null | undefined, fallback: string): string | undefined;
+//#endregion
+//#region src/tracing/browserTracing.d.ts
+/**
+ * While registered, the built-in History detection opens no roots and the caller drives navigation
+ * through the returned handle. Last-wins, and a stale handle no-ops, so an HMR-replaced bootstrap
+ * cannot tear down a newer registration.
+ */
+declare function registerNavigationSource(): NavigationSource;
+//#endregion
+//#region src/tracing/instrumentationGuard.d.ts
+/** For a callback the host invokes: a router guard, a store subscriber, ... */
+declare function insulate<A extends unknown[]>(fn: (...a: A) => void): (...a: A) => void;
+/** Invoke a teardown fn now (if present), swallowing any throw. For cleanup chains. */
+declare function safeInvoke(fn: (() => void) | null | undefined): void;
+/** Hands one teardown to `instrumentOnce`. Accepts nothing, for a listener an install chose to skip. */
+type TrackTeardown = (teardown: (() => void) | null | undefined) => void;
+/**
+ * Instrument `target` at most once at a time, tearing down any prior instrumentation of the same object
+ * first. Vite HMR re-runs boot code against a router that survives the reload, so without this every
+ * cycle appends another listener set that is never removed. Keyed on the object, so a genuinely new
+ * router is unaffected.
+ *
+ * `install` hands each teardown to `track` as it produces it. A router's own `subscribe` / `on` / guard
+ * registration can throw, and `install` runs during the host's bootstrap, so a throw part-way through
+ * unwinds what already succeeded (newest first) and stops here rather than reaching the host.
+ *
+ * @returns the cleanup, or a no-op when the install failed and already unwound itself.
+ */
+declare function instrumentOnce<T extends object>(target: T, install: (track: TrackTeardown) => void): () => void;
+//#endregion
+//#region src/tracing/absoluteHref.d.ts
+/**
+ * Resolve a router-reported href against the page we are on. Returns the `URL`, so a caller that
+ * wants the pathname as well as the href does not parse it a second time.
+ *
+ * Undefined outside a browser or for an unparseable href, so the caller can leave its attribute alone.
+ */
+declare function absoluteUrl(href: string | null | undefined): URL | undefined;
+/**
+ * The href form of `absoluteUrl`. Pass one built by the router's own `createHref`/`resolve` (see
+ * `resolveHref`), not a bare path: routers strip the app's base path, so `origin + path` yields an
+ * address the server does not have.
+ */
+declare function absoluteHref(href: string | null | undefined): string | undefined;
+//#endregion
+//#region src/tracing/componentProfiler.d.ts
+type ComponentTraceContext = {
+  traceId: string;
+  parentSpanId: string;
+};
+/** Unix nanos on the same clock the tracer uses for span timestamps. */
+declare const nowNano: typeof defaultNowNano;
+/**
+ * Reserved up front so descendants can point at a span before it is recorded. Null when the trace is at
+ * its span cap: descendants record before this span does, so an id the cap will refuse orphans them.
+ */
+declare function reserveSpanId(traceId?: string): string | null;
+/** The root a top-level component nests under. Null when tracing is off or no root is recording. */
+declare function activeComponentRoot(): ComponentTraceContext | null;
+/**
+ * An ancestor's context is only usable while it still belongs to the live trace. A profiled component
+ * that survives a navigation (a layout around a swapped page body) froze its context under the pageload
+ * trace, and `recordComponentSpan` would drop anything pointing at that closed root.
+ */
+declare function resolveComponentParent(inherited: ComponentTraceContext | null | undefined, live: ComponentTraceContext | null): ComponentTraceContext | null;
+/** What a profiler hands back for one component mount. */
+type ComponentSpanRecord = {
+  name: string;
+  spanId: string;
+  parent: ComponentTraceContext;
+  startTimeUnixNano: number;
+  endTimeUnixNano: number;
+  attributes?: Attributes;
+};
+/**
+ * Records only while the reserved root is still the live recording root, and drops the span otherwise.
+ * Dropping avoids starting a fresh TraceState for a dead trace, which would re-run the sampler, and
+ * avoids adding a child to a root that already shipped.
+ */
+declare function recordComponentSpan(record: ComponentSpanRecord): void;
+//#endregion
+export { collectBrowser as C, FetchFileReader as S, createFlareResolver as T, RouteName as _, nowNano as a, routeName as b, resolveComponentParent as c, TrackTeardown as d, instrumentOnce as f, NavigationSource as g, registerNavigationSource as h, activeComponentRoot as i, absoluteHref as l, safeInvoke as m, ComponentSpanRecord as n, recordComponentSpan as o, insulate as p, ComponentTraceContext as r, reserveSpanId as s, BrowserSpanType as t, absoluteUrl as u, currentPath as v, catchWindowErrors as w, BrowserFlushScheduler as x, resolveHref as y };

package/dist/spanTypes-iA1RdfLw.d.cts

@@ -0,0 +1,161 @@
+import { Flare as Flare$1 } from "./browser.cjs";
+import { Attributes, BrowserSpanType, Config, ContextCollector, FileReader, FlushFn, FlushScheduler, defaultNowNano } from "@flareapp/core";
+
+//#region src/createFlareResolver.d.ts
+/**
+ * Builds a per-package Flare resolver: `registerDefaultFlare` (wired once by the web entry) and
+ * `resolveFlare` (called at wiring time). Each call holds its own default-provider state. The check
+ * that warns about the Electron `__flare` bridge uses `packageName` in its message;
+ * `injectInstruction` replaces the closing hint for packages whose advice differs (for example
+ * svelte, which points at the preprocessor's importSource).
+ */
+declare function createFlareResolver(config: {
+  packageName: string;
+  injectInstruction?: string;
+}): {
+  registerDefaultFlare(provider: () => Flare$1): void;
+  resolveFlare(explicit?: Flare$1): Flare$1;
+};
+//#endregion
+//#region src/browser/catchWindowErrors.d.ts
+/**
+ * Wire up global `error` and `unhandledrejection` listeners, routing reports through `window.flare`
+ * (assigned by Flare.light()/configure()). Events are dropped, not queued, when the global is absent.
+ */
+declare function catchWindowErrors(): void;
+//#endregion
+//#region src/browser/context/collectBrowser.d.ts
+declare const collectBrowser: ContextCollector;
+//#endregion
+//#region src/browser/FetchFileReader.d.ts
+/**
+ * Fetches source files so the stack-trace builder can render a snippet around the offending line.
+ * Only http(s) is fetched: other schemes (chrome-extension://, file://, blob:, data:) would cross a
+ * privilege boundary or hit a CORS/CSP wall for nothing. Returns null on any failure, never throws.
+ */
+declare class FetchFileReader implements FileReader {
+  read(url: string): Promise<string | null>;
+}
+//#endregion
+//#region src/browser/BrowserFlushScheduler.d.ts
+declare class BrowserFlushScheduler implements FlushScheduler {
+  register(flush: FlushFn): void;
+}
+//#endregion
+//#region src/tracing/navigation.d.ts
+type RouteName = {
+  name: string;
+  source: 'route' | 'url';
+  /**
+   * Where the navigation is going. Re-stamps the root's `url.full` alongside the name, so a redirected
+   * or superseded navigation reports where it ended rather than where it opened. Omit to keep the url
+   * the root started with.
+   */
+  url?: string;
+};
+type NavigationSource = {
+  startNavigation(opts?: {
+    path?: string;
+    url?: string;
+    hold?: boolean;
+  }): void;
+  setActiveRouteName(route: RouteName): void;
+  settleNavigation(route: RouteName): void;
+  unregister(): void;
+};
+/** The path the address bar is on, or '' outside a browser. */
+declare function currentPath(): string;
+/**
+ * Prefers the router's parameterized template over the raw path, so names aggregate per route rather
+ * than per url. `derive` runs inside a try: a router that throws on an unresolved match chain falls back
+ * to the url name instead of taking the host down.
+ */
+declare function routeName(derive: () => string | undefined, fallbackPath: string, url?: string): RouteName;
+/**
+ * `build` is the router's own href builder (vue-router's `resolve`, React Router's `createHref`), which
+ * is what puts the app's base path and hash prefix back on. Without it an app served from `/app/` reports
+ * `/product/p01` for the real `/app/product/p01`. A router that throws still gets a url from `fallback`.
+ */
+declare function resolveHref(build: () => string | null | undefined, fallback: string): string | undefined;
+//#endregion
+//#region src/tracing/browserTracing.d.ts
+/**
+ * While registered, the built-in History detection opens no roots and the caller drives navigation
+ * through the returned handle. Last-wins, and a stale handle no-ops, so an HMR-replaced bootstrap
+ * cannot tear down a newer registration.
+ */
+declare function registerNavigationSource(): NavigationSource;
+//#endregion
+//#region src/tracing/instrumentationGuard.d.ts
+/** For a callback the host invokes: a router guard, a store subscriber, ... */
+declare function insulate<A extends unknown[]>(fn: (...a: A) => void): (...a: A) => void;
+/** Invoke a teardown fn now (if present), swallowing any throw. For cleanup chains. */
+declare function safeInvoke(fn: (() => void) | null | undefined): void;
+/** Hands one teardown to `instrumentOnce`. Accepts nothing, for a listener an install chose to skip. */
+type TrackTeardown = (teardown: (() => void) | null | undefined) => void;
+/**
+ * Instrument `target` at most once at a time, tearing down any prior instrumentation of the same object
+ * first. Vite HMR re-runs boot code against a router that survives the reload, so without this every
+ * cycle appends another listener set that is never removed. Keyed on the object, so a genuinely new
+ * router is unaffected.
+ *
+ * `install` hands each teardown to `track` as it produces it. A router's own `subscribe` / `on` / guard
+ * registration can throw, and `install` runs during the host's bootstrap, so a throw part-way through
+ * unwinds what already succeeded (newest first) and stops here rather than reaching the host.
+ *
+ * @returns the cleanup, or a no-op when the install failed and already unwound itself.
+ */
+declare function instrumentOnce<T extends object>(target: T, install: (track: TrackTeardown) => void): () => void;
+//#endregion
+//#region src/tracing/absoluteHref.d.ts
+/**
+ * Resolve a router-reported href against the page we are on. Returns the `URL`, so a caller that
+ * wants the pathname as well as the href does not parse it a second time.
+ *
+ * Undefined outside a browser or for an unparseable href, so the caller can leave its attribute alone.
+ */
+declare function absoluteUrl(href: string | null | undefined): URL | undefined;
+/**
+ * The href form of `absoluteUrl`. Pass one built by the router's own `createHref`/`resolve` (see
+ * `resolveHref`), not a bare path: routers strip the app's base path, so `origin + path` yields an
+ * address the server does not have.
+ */
+declare function absoluteHref(href: string | null | undefined): string | undefined;
+//#endregion
+//#region src/tracing/componentProfiler.d.ts
+type ComponentTraceContext = {
+  traceId: string;
+  parentSpanId: string;
+};
+/** Unix nanos on the same clock the tracer uses for span timestamps. */
+declare const nowNano: typeof defaultNowNano;
+/**
+ * Reserved up front so descendants can point at a span before it is recorded. Null when the trace is at
+ * its span cap: descendants record before this span does, so an id the cap will refuse orphans them.
+ */
+declare function reserveSpanId(traceId?: string): string | null;
+/** The root a top-level component nests under. Null when tracing is off or no root is recording. */
+declare function activeComponentRoot(): ComponentTraceContext | null;
+/**
+ * An ancestor's context is only usable while it still belongs to the live trace. A profiled component
+ * that survives a navigation (a layout around a swapped page body) froze its context under the pageload
+ * trace, and `recordComponentSpan` would drop anything pointing at that closed root.
+ */
+declare function resolveComponentParent(inherited: ComponentTraceContext | null | undefined, live: ComponentTraceContext | null): ComponentTraceContext | null;
+/** What a profiler hands back for one component mount. */
+type ComponentSpanRecord = {
+  name: string;
+  spanId: string;
+  parent: ComponentTraceContext;
+  startTimeUnixNano: number;
+  endTimeUnixNano: number;
+  attributes?: Attributes;
+};
+/**
+ * Records only while the reserved root is still the live recording root, and drops the span otherwise.
+ * Dropping avoids starting a fresh TraceState for a dead trace, which would re-run the sampler, and
+ * avoids adding a child to a root that already shipped.
+ */
+declare function recordComponentSpan(record: ComponentSpanRecord): void;
+//#endregion
+export { collectBrowser as C, FetchFileReader as S, createFlareResolver as T, RouteName as _, nowNano as a, routeName as b, resolveComponentParent as c, TrackTeardown as d, instrumentOnce as f, NavigationSource as g, registerNavigationSource as h, activeComponentRoot as i, absoluteHref as l, safeInvoke as m, ComponentSpanRecord as n, recordComponentSpan as o, insulate as p, ComponentTraceContext as r, reserveSpanId as s, BrowserSpanType as t, absoluteUrl as u, currentPath as v, catchWindowErrors as w, BrowserFlushScheduler as x, resolveHref as y };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@flareapp/js",
-    "version": "2.6.0",
+    "version": "2.8.0",
     "description": "JavaScript client for flareapp.io",
     "homepage": "https://flareapp.io",
     "bugs": {
@@ -59,9 +59,10 @@
         "release": "release-it"
     },
     "dependencies": {
-        "@flareapp/core": "2.6.0"
+        "@flareapp/core": "2.8.0"
     },
     "devDependencies": {
+        "@flareapp/test-helpers": "*",
         "error-stack-parser": "^2.0.2",
         "tsdown": "^0.20.3",
         "typescript": "^5.7.0",

package/dist/BrowserFlushScheduler-CR7L8-z6.d.cts

@@ -1,43 +0,0 @@
-import { ContextCollector, FileReader, FlushFn, FlushScheduler } from "@flareapp/core";
-
-//#region src/browser/catchWindowErrors.d.ts
-declare function catchWindowErrors(): void;
-//#endregion
-//#region src/browser/context/collectBrowser.d.ts
-declare const collectBrowser: ContextCollector;
-//#endregion
-//#region src/browser/FetchFileReader.d.ts
-/**
- * Browser `FileReader` implementation that fetches source files over HTTP(S).
- *
- * Wired into `@flareapp/js`'s singleton so the stack-trace builder can pull
- * the original source for each frame and render a code snippet around the
- * offending line. The source URL comes from the frame (usually the URL of
- * the JS bundle that produced the error, post-sourcemap resolution).
- *
- * Three safety gates:
- *
- * 1. **Scheme allowlist.** Only `http:` and `https:` URLs are fetched. Other
- *    schemes (`chrome-extension://`, `file://`, `blob:`, `data:`) return
- *    `null` immediately. This avoids surprise privilege boundaries (e.g.,
- *    pages should not read extension-internal files) and dodges CORS/CSP
- *    walls that would error noisily.
- * 2. **Status check.** Only `200 OK` responses are used. 3xx redirects are
- *    handled transparently by `fetch`; 4xx/5xx fall back to `null` so the
- *    snippet is simply omitted from the report.
- * 3. **Catch-all.** Network failures, CORS errors, and aborted requests
- *    return `null`. We never let a source-fetch failure leak as an error
- *    that the consumer page would see.
- *
- * The `read()` contract returns `null` on any failure path, never throws.
- */
-declare class FetchFileReader implements FileReader {
-  read(url: string): Promise<string | null>;
-}
-//#endregion
-//#region src/browser/BrowserFlushScheduler.d.ts
-declare class BrowserFlushScheduler implements FlushScheduler {
-  register(flush: FlushFn): void;
-}
-//#endregion
-export { catchWindowErrors as i, FetchFileReader as n, collectBrowser as r, BrowserFlushScheduler as t };

package/dist/BrowserFlushScheduler-CZiDvxtf.d.mts

@@ -1,43 +0,0 @@
-import { ContextCollector, FileReader, FlushFn, FlushScheduler } from "@flareapp/core";
-
-//#region src/browser/catchWindowErrors.d.ts
-declare function catchWindowErrors(): void;
-//#endregion
-//#region src/browser/context/collectBrowser.d.ts
-declare const collectBrowser: ContextCollector;
-//#endregion
-//#region src/browser/FetchFileReader.d.ts
-/**
- * Browser `FileReader` implementation that fetches source files over HTTP(S).
- *
- * Wired into `@flareapp/js`'s singleton so the stack-trace builder can pull
- * the original source for each frame and render a code snippet around the
- * offending line. The source URL comes from the frame (usually the URL of
- * the JS bundle that produced the error, post-sourcemap resolution).
- *
- * Three safety gates:
- *
- * 1. **Scheme allowlist.** Only `http:` and `https:` URLs are fetched. Other
- *    schemes (`chrome-extension://`, `file://`, `blob:`, `data:`) return
- *    `null` immediately. This avoids surprise privilege boundaries (e.g.,
- *    pages should not read extension-internal files) and dodges CORS/CSP
- *    walls that would error noisily.
- * 2. **Status check.** Only `200 OK` responses are used. 3xx redirects are
- *    handled transparently by `fetch`; 4xx/5xx fall back to `null` so the
- *    snippet is simply omitted from the report.
- * 3. **Catch-all.** Network failures, CORS errors, and aborted requests
- *    return `null`. We never let a source-fetch failure leak as an error
- *    that the consumer page would see.
- *
- * The `read()` contract returns `null` on any failure path, never throws.
- */
-declare class FetchFileReader implements FileReader {
-  read(url: string): Promise<string | null>;
-}
-//#endregion
-//#region src/browser/BrowserFlushScheduler.d.ts
-declare class BrowserFlushScheduler implements FlushScheduler {
-  register(flush: FlushFn): void;
-}
-//#endregion
-export { catchWindowErrors as i, FetchFileReader as n, collectBrowser as r, BrowserFlushScheduler as t };

package/dist/catchWindowErrors-DaCqd2yC.mjs

@@ -1,124 +0,0 @@
-import { redactUrlQuery, routeRejection } from "@flareapp/core";
-
-//#region src/browser/BrowserFlushScheduler.ts
-var BrowserFlushScheduler = class {
-	register(flush) {
-		if (typeof document === "undefined" || !document) return;
-		document.addEventListener("visibilitychange", () => {
-			if (document.visibilityState === "hidden") flush({ keepalive: true });
-		});
-	}
-};
-
-//#endregion
-//#region src/browser/context/cookie.ts
-function cookie() {
-	if (!window.document.cookie) return {};
-	const cookies = {};
-	window.document.cookie.split("; ").forEach((rawCookie) => {
-		const idx = rawCookie.indexOf("=");
-		if (idx === -1) {
-			cookies[rawCookie] = "";
-			return;
-		}
-		const name = rawCookie.slice(0, idx);
-		cookies[name] = rawCookie.slice(idx + 1);
-	});
-	return { "http.request.cookies": cookies };
-}
-
-//#endregion
-//#region src/browser/context/request.ts
-function request(urlDenylist) {
-	return {
-		"url.full": redactUrlQuery(window.location.href, urlDenylist),
-		"user_agent.original": window.navigator.userAgent,
-		"http.request.referrer": redactUrlQuery(window.document.referrer, urlDenylist),
-		"document.ready_state": window.document.readyState
-	};
-}
-
-//#endregion
-//#region src/browser/context/requestData.ts
-function requestData(urlDenylist) {
-	if (!window.location.search) return {};
-	return { "url.query": redactUrlQuery(window.location.search, urlDenylist).replace(/^\?/, "") };
-}
-
-//#endregion
-//#region src/browser/context/collectBrowser.ts
-const collectBrowser = (config) => {
-	if (typeof window === "undefined") return { "flare.entry_point.type": "server" };
-	const attrs = { "flare.entry_point.type": "web" };
-	if (window?.location?.href) {
-		attrs["flare.entry_point.value"] = redactUrlQuery(window.location.href, config.urlDenylist);
-		if (window.location.pathname) {
-			attrs["flare.entry_point.handler.identifier"] = window.location.pathname;
-			attrs["flare.entry_point.handler.type"] = "browser";
-		}
-	}
-	if (window?.location?.hostname) attrs["host.name"] = window.location.hostname;
-	Object.assign(attrs, request(config.urlDenylist));
-	Object.assign(attrs, requestData(config.urlDenylist));
-	Object.assign(attrs, cookie());
-	return attrs;
-};
-
-//#endregion
-//#region src/browser/FetchFileReader.ts
-/**
-* Browser `FileReader` implementation that fetches source files over HTTP(S).
-*
-* Wired into `@flareapp/js`'s singleton so the stack-trace builder can pull
-* the original source for each frame and render a code snippet around the
-* offending line. The source URL comes from the frame (usually the URL of
-* the JS bundle that produced the error, post-sourcemap resolution).
-*
-* Three safety gates:
-*
-* 1. **Scheme allowlist.** Only `http:` and `https:` URLs are fetched. Other
-*    schemes (`chrome-extension://`, `file://`, `blob:`, `data:`) return
-*    `null` immediately. This avoids surprise privilege boundaries (e.g.,
-*    pages should not read extension-internal files) and dodges CORS/CSP
-*    walls that would error noisily.
-* 2. **Status check.** Only `200 OK` responses are used. 3xx redirects are
-*    handled transparently by `fetch`; 4xx/5xx fall back to `null` so the
-*    snippet is simply omitted from the report.
-* 3. **Catch-all.** Network failures, CORS errors, and aborted requests
-*    return `null`. We never let a source-fetch failure leak as an error
-*    that the consumer page would see.
-*
-* The `read()` contract returns `null` on any failure path, never throws.
-*/
-var FetchFileReader = class {
-	read(url) {
-		if (!/^https?:\/\//i.test(url)) return Promise.resolve(null);
-		return fetch(url).then((response) => {
-			if (response.status !== 200) return null;
-			return response.text();
-		}).catch(() => null);
-	}
-};
-
-//#endregion
-//#region src/env/index.ts
-const CLIENT_VERSION = typeof process !== "undefined" && true ? "2.6.0" : "?";
-
-//#endregion
-//#region src/browser/catchWindowErrors.ts
-function catchWindowErrors() {
-	if (typeof window === "undefined") return;
-	window.addEventListener("error", (event) => {
-		const flare = window.flare;
-		if (!flare) return;
-		if (event.error instanceof Error) flare.reportSilently(event.error);
-	});
-	window.addEventListener("unhandledrejection", (event) => {
-		const flare = window.flare;
-		if (!flare) return;
-		routeRejection(flare, event.reason);
-	});
-}
-
-//#endregion
-export { BrowserFlushScheduler as a, collectBrowser as i, CLIENT_VERSION as n, FetchFileReader as r, catchWindowErrors as t };