@flareapp/js 2.8.0 → 2.9.0

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_componentProfiler = require('./componentProfiler-C6qY96Bt.cjs');
+const require_catchWindowErrors = require('./catchWindowErrors-cR2D7kju.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_componentProfiler.catchWindowErrors();
+	require_catchWindowErrors.catchWindowErrors();
 }
 
 //#endregion
@@ -54,7 +54,7 @@ Object.defineProperty(exports, 'convertToError', {
     return _flareapp_core.convertToError;
   }
 });
-exports.createFlareResolver = require_componentProfiler.createFlareResolver;
+exports.createFlareResolver = require_catchWindowErrors.createFlareResolver;
 exports.flare = flare;
 Object.defineProperty(exports, 'redactFullPath', {
   enumerable: true,

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { T as createFlareResolver } from "./spanTypes-iA1RdfLw.cjs";
+import { E as createFlareResolver } from "./spanTypes-TMgJEZ7G.cjs";
 import { Flare } from "./browser.cjs";
 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";
 

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { T as createFlareResolver } from "./spanTypes-CjF1_Uqi.mjs";
+import { E as createFlareResolver } from "./spanTypes-7-nEycOc.mjs";
 import { Flare } from "./browser.mjs";
 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";
 

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { o as catchWindowErrors, s as createFlareResolver } from "./componentProfiler-CoH2m13n.mjs";
+import { n as createFlareResolver, t as catchWindowErrors } from "./catchWindowErrors-C0gSVGiF.mjs";
 import { Flare } from "./browser.mjs";
 import { DEFAULT_URL_DENYLIST, FrameworkName, GlobalScopeProvider, Logger, NullFileReader, Scope, convertToError, redactObjectValues, redactUrlQuery, redactUrlQuery as redactFullPath, resolveDenylist, toCustomContext } from "@flareapp/core";
 

package/dist/{spanTypes-CjF1_Uqi.d.mts → spanTypes-7-nEycOc.d.mts}

@@ -1,5 +1,5 @@
 import { Flare as Flare$1 } from "./browser.mjs";
-import { Attributes, BrowserSpanType, Config, ContextCollector, FileReader, FlushFn, FlushScheduler, defaultNowNano } from "@flareapp/core";
+import { Attributes, BrowserSpanType as BrowserSpanType$1, Config, ContextCollector, FileReader, FlushFn, FlushScheduler, defaultNowNano } from "@flareapp/core";
 
 //#region src/createFlareResolver.d.ts
 /**
@@ -42,15 +42,12 @@ declare class BrowserFlushScheduler implements FlushScheduler {
   register(flush: FlushFn): void;
 }
 //#endregion
-//#region src/tracing/navigation.d.ts
+//#region src/instrumentation/navigation/types.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.
-   */
+  /** Where the navigation ends. Set on a redirect so the final url is reported; leave out to keep
+   *  the url the root opened with. */
   url?: string;
 };
 type NavigationSource = {
@@ -63,30 +60,42 @@ type NavigationSource = {
   settleNavigation(route: RouteName): void;
   unregister(): void;
 };
-/** The path the address bar is on, or '' outside a browser. */
+//#endregion
+//#region src/instrumentation/navigation/utils.d.ts
 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 currentHref(): string;
 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`.
+ * `build` is the router's own href builder (vue-router `resolve`, React Router `createHref`). It puts
+ * the app's base path and hash prefix back. Without it, an app served from `/app/` reports
+ * `/product/p01` instead of `/app/product/p01`. If `build` throws, we use `fallback`.
  */
-declare function resolveHref(build: () => string | null | undefined, fallback: string): string | undefined;
+declare function resolveHref(build: () => string | null | undefined, fallbackHref: string): string | undefined;
 //#endregion
-//#region src/tracing/browserTracing.d.ts
+//#region src/instrumentation/navigation/navigationBus.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.
+ * Hands navigation to a framework router: while registered, the built-in History detection stays
+ * quiet and the router drives every step through the returned handle. The newest registration wins
+ * and a stale handle no-ops, because HMR can replace a router that still holds one.
  */
 declare function registerNavigationSource(): NavigationSource;
 //#endregion
-//#region src/tracing/instrumentationGuard.d.ts
+//#region src/tracing/utils/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/utils/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. */
@@ -107,22 +116,7 @@ type TrackTeardown = (teardown: (() => void) | null | undefined) => void;
  */
 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
+//#region src/tracing/roots/componentProfiler.d.ts
 type ComponentTraceContext = {
   traceId: string;
   parentSpanId: string;
@@ -158,4 +152,4 @@ type ComponentSpanRecord = {
  */
 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 };
+export { FetchFileReader as C, createFlareResolver as E, BrowserFlushScheduler as S, catchWindowErrors as T, currentPath as _, nowNano as a, NavigationSource as b, resolveComponentParent as c, insulate as d, safeInvoke as f, currentHref as g, registerNavigationSource as h, activeComponentRoot as i, TrackTeardown as l, absoluteUrl as m, ComponentSpanRecord as n, recordComponentSpan as o, absoluteHref as p, ComponentTraceContext as r, reserveSpanId as s, BrowserSpanType$1 as t, instrumentOnce as u, resolveHref as v, collectBrowser as w, RouteName as x, routeName as y };

package/dist/{spanTypes-iA1RdfLw.d.cts → spanTypes-TMgJEZ7G.d.cts}

@@ -42,15 +42,12 @@ declare class BrowserFlushScheduler implements FlushScheduler {
   register(flush: FlushFn): void;
 }
 //#endregion
-//#region src/tracing/navigation.d.ts
+//#region src/instrumentation/navigation/types.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.
-   */
+  /** Where the navigation ends. Set on a redirect so the final url is reported; leave out to keep
+   *  the url the root opened with. */
   url?: string;
 };
 type NavigationSource = {
@@ -63,30 +60,42 @@ type NavigationSource = {
   settleNavigation(route: RouteName): void;
   unregister(): void;
 };
-/** The path the address bar is on, or '' outside a browser. */
+//#endregion
+//#region src/instrumentation/navigation/utils.d.ts
 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 currentHref(): string;
 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`.
+ * `build` is the router's own href builder (vue-router `resolve`, React Router `createHref`). It puts
+ * the app's base path and hash prefix back. Without it, an app served from `/app/` reports
+ * `/product/p01` instead of `/app/product/p01`. If `build` throws, we use `fallback`.
  */
-declare function resolveHref(build: () => string | null | undefined, fallback: string): string | undefined;
+declare function resolveHref(build: () => string | null | undefined, fallbackHref: string): string | undefined;
 //#endregion
-//#region src/tracing/browserTracing.d.ts
+//#region src/instrumentation/navigation/navigationBus.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.
+ * Hands navigation to a framework router: while registered, the built-in History detection stays
+ * quiet and the router drives every step through the returned handle. The newest registration wins
+ * and a stale handle no-ops, because HMR can replace a router that still holds one.
  */
 declare function registerNavigationSource(): NavigationSource;
 //#endregion
-//#region src/tracing/instrumentationGuard.d.ts
+//#region src/tracing/utils/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/utils/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. */
@@ -107,22 +116,7 @@ type TrackTeardown = (teardown: (() => void) | null | undefined) => void;
  */
 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
+//#region src/tracing/roots/componentProfiler.d.ts
 type ComponentTraceContext = {
   traceId: string;
   parentSpanId: string;
@@ -158,4 +152,4 @@ type ComponentSpanRecord = {
  */
 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 };
+export { FetchFileReader as C, createFlareResolver as E, BrowserFlushScheduler as S, catchWindowErrors as T, currentPath as _, nowNano as a, NavigationSource as b, resolveComponentParent as c, insulate as d, safeInvoke as f, currentHref as g, registerNavigationSource as h, activeComponentRoot as i, TrackTeardown as l, absoluteUrl as m, ComponentSpanRecord as n, recordComponentSpan as o, absoluteHref as p, ComponentTraceContext as r, reserveSpanId as s, BrowserSpanType as t, instrumentOnce as u, resolveHref as v, collectBrowser as w, RouteName as x, routeName as y };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@flareapp/js",
-    "version": "2.8.0",
+    "version": "2.9.0",
     "description": "JavaScript client for flareapp.io",
     "homepage": "https://flareapp.io",
     "bugs": {
@@ -59,7 +59,7 @@
         "release": "release-it"
     },
     "dependencies": {
-        "@flareapp/core": "2.8.0"
+        "@flareapp/core": "2.9.0"
     },
     "devDependencies": {
         "@flareapp/test-helpers": "*",