@newtalaria/browser 0.1.17 → 0.1.19

package/dist/transport/events.d.ts

@@ -1,5 +1,5 @@
 import type { ServerpodTransport } from './serverpod.js';
-import type { SeverityLevel } from '../types.js';
+import type { DebugMeta, ExceptionData, SeverityLevel } from '../types.js';
 export interface IngestEventParams {
     message: string;
     environment: string;
@@ -7,6 +7,9 @@ export interface IngestEventParams {
     eventType?: 'error' | 'warning' | 'info' | 'debug';
     title?: string;
     stackTrace?: string;
+    exception?: ExceptionData;
+    debugMeta?: DebugMeta;
+    platform?: string;
     release?: string;
     userId?: string;
     sessionId?: string;

package/dist/transport/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/transport/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,WAAW,CAC/B,SAAS,EAAE,kBAAkB,EAC7B,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,OAAO,CAAC,CA2BlB"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/transport/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EAGb,aAAa,EAGd,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,WAAW,CAC/B,SAAS,EAAE,kBAAkB,EAC7B,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,OAAO,CAAC,CA8BlB"}

package/dist/types.d.ts

@@ -44,18 +44,30 @@ export interface TalariaInitOptions {
     userId?: string;
     /** Tags merged into every captured event (per-call tags win on key conflict). */
     tags?: Record<string, string>;
+    /**
+     * Preferred low-cardinality dimensions (optional conventions):
+     * `service`, `platform`, `feature`, `operation`, `component`, `runtime`,
+     * `runtime_version`. Do not put environment/release or high-cardinality IDs here.
+     */
     /** Disable automatic `window` / `unhandledrejection` handlers. */
     disableDefaultIntegrations?: boolean;
     /**
-     * Promote matching HTTP fetch/XHR failures to Talaria events (not just replay breadcrumbs).
-     * Default `true`.
+     * Promote matching HTTP fetch/XHR failures to Talaria events for first-party /
+     * allowlisted origins (not just replay breadcrumbs). Default `true`.
      */
     captureFailedRequests?: boolean;
     /**
-     * Promote fetch/XHR transport failures (CORS, offline, DNS — no HTTP status) as events.
-     * Default `true`. AbortError is never promoted.
+     * Promote fetch/XHR transport failures (no HTTP status) as events for
+     * first-party / allowlisted origins. Default `true`. AbortError is never promoted.
+     * Third-party failures stay as replay breadcrumbs unless their origin is allowlisted.
      */
     captureNetworkErrors?: boolean;
+    /**
+     * Extra origins whose failed requests may be promoted (exact origin strings).
+     * Same-origin is always eligible. Use `['*']` to promote all origins (not recommended).
+     * Example: `['https://api.stripe.com']`.
+     */
+    networkErrorOrigins?: string[];
     /**
      * Keep query strings on network telemetry URLs (after sensitive-key redaction).
      * Default `false` — strips `?…` / `#…` so GA/ads identifiers are not stored.
@@ -69,16 +81,108 @@ export interface TalariaInitOptions {
     /**
      * Status codes / ranges to promote. Default `[[500, 599]]`.
      * Use `[[400, 599]]` for CMS admin (GridField/PJAX 404s).
+     * Only applies to first-party / allowlisted origins.
      */
     failedRequestStatusCodes?: FailedRequestStatusCode[];
     /** Extra URL substrings that must never be promoted (Talaria ingest URLs are always ignored). */
     failedRequestIgnoreUrls?: string[];
+    /**
+     * Path substrings or RegExps that force stack frames `inApp: true`
+     * (checked after built-in denies / denyUrls).
+     */
+    inAppAllowUrls?: Array<string | RegExp>;
+    /**
+     * Path substrings or RegExps that force stack frames `inApp: false`.
+     */
+    inAppDenyUrls?: Array<string | RegExp>;
+    /**
+     * Extra origins treated as app code for `inApp` (exact origin strings).
+     * Same-origin (`window.location.origin`) is always included.
+     * Example: `['https://cdn.example.com']` for CDN-hosted app bundles.
+     */
+    inAppOrigins?: string[];
+}
+/** How an exception was captured / produced (mirrors ExceptionMechanismDto). */
+export interface ExceptionMechanism {
+    type: string;
+    handled?: boolean;
+    synthetic?: boolean;
+}
+/**
+ * Single stack frame on the wire (mirrors StackFrameDto).
+ * Uses `functionName` — not `function` (reserved in Dart / Serverpod).
+ */
+export interface StackFrame {
+    filename?: string;
+    absPath?: string;
+    functionName?: string;
+    rawFunction?: string;
+    module?: string;
+    package?: string;
+    platform?: string;
+    lineno?: number;
+    colno?: number;
+    inApp?: boolean;
+    instructionAddr?: string;
+    symbolAddr?: string;
+    imageAddr?: string;
+    addrMode?: string;
+    contextLine?: string;
+    preContext?: string[];
+    postContext?: string[];
+    vars?: Record<string, string>;
+    stackStart?: boolean;
+}
+/** Structured stacktrace (mirrors StackTraceDto). Frames are oldest → newest. */
+export interface StackTrace {
+    frames: StackFrame[];
+    registers?: Record<string, string>;
+}
+/** One exception in a chain (mirrors ExceptionValueDto). */
+export interface ExceptionValue {
+    type?: string;
+    value?: string;
+    module?: string;
+    threadId?: string;
+    code?: string;
+    mechanism?: ExceptionMechanism;
+    stacktrace?: StackTrace;
+}
+/** First-class exception payload (mirrors ExceptionDataDto). */
+export interface ExceptionData {
+    values: ExceptionValue[];
+}
+/** Optional debug image metadata (mirrors DebugImageDto). */
+export interface DebugImage {
+    type?: string;
+    imageAddr?: string;
+    imageSize?: number;
+    debugId?: string;
+    debugFile?: string;
+    codeId?: string;
+    codeFile?: string;
+    arch?: string;
+}
+/** Optional debug meta (mirrors DebugMetaDto). */
+export interface DebugMeta {
+    images?: DebugImage[];
 }
 export interface CaptureContext {
     tags?: Record<string, string>;
     extra?: Record<string, unknown>;
     userId?: string;
     title?: string;
+    /** How the exception was captured (`onerror`, `unhandledrejection`, `http`, …). */
+    mechanism?: ExceptionMechanism;
+    /**
+     * Enrich the top (newest) stack frame — e.g. `window.onerror` location.
+     * Not sent in `extra`.
+     */
+    source?: {
+        filename?: string;
+        lineno?: number;
+        colno?: number;
+    };
 }
 export interface ResolvedOptions {
     baseUrl: string;
@@ -97,8 +201,12 @@ export interface ResolvedOptions {
     disableDefaultIntegrations: boolean;
     captureFailedRequests: boolean;
     captureNetworkErrors: boolean;
+    networkErrorOrigins: string[];
     includeNetworkUrlQuery: boolean;
     failedRequestStatusCodes: FailedRequestStatusCode[];
     failedRequestIgnoreUrls: string[];
+    inAppAllowUrls: Array<string | RegExp>;
+    inAppDenyUrls: Array<string | RegExp>;
+    inAppOrigins: string[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE7E,mDAAmD;AACnD,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,aAAa,CAAC;AAEnE,mDAAmD;AACnD,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhE,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,WAAW,GAAG,MAAM,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,kEAAkE;IAClE,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;OAEG;IACH,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACrD,iGAAiG;IACjG,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB,EAAE,MAAM,CAAC;IACjC,wBAAwB,EAAE,MAAM,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,0BAA0B,EAAE,OAAO,CAAC;IACpC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,sBAAsB,EAAE,OAAO,CAAC;IAChC,wBAAwB,EAAE,uBAAuB,EAAE,CAAC;IACpD,uBAAuB,EAAE,MAAM,EAAE,CAAC;CACnC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/utils/browser_context.d.ts

@@ -14,15 +14,16 @@ export interface BrowserContext {
     /** Friendly crawler name when recognized (e.g. Baiduspider). */
     botName?: string;
 }
-export interface BrowserContextTags {
+/** Known browser triage tags; typed as TagMap for mergeTags compatibility. */
+export type BrowserContextTags = {
     'browser.name': string;
     'browser.version': string;
     'os.name': string;
     'os.version': string;
-    'device': string;
+    device: string;
     bot?: string;
     'bot.name'?: string;
-}
+} & Record<string, string>;
 export declare function detectBot(ua: string): {
     bot: boolean;
     botName?: string;

package/dist/utils/browser_context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser_context.d.ts","sourceRoot":"","sources":["../../src/utils/browser_context.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,GAAG,EAAE,OAAO,CAAC;IACb,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA4BD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAWxE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,SAA8D,EAChE,QAAQ,SAA6D,GACpE,cAAc,CAuFhB;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,kBAAkB,CAc1E;AAED,qDAAqD;AACrD,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,cAAc,CAAC,CAoErE"}
+{"version":3,"file":"browser_context.d.ts","sourceRoot":"","sources":["../../src/utils/browser_context.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,GAAG,EAAE,OAAO,CAAC;IACb,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AA4B3B,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAWxE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,SAA8D,EAChE,QAAQ,SAA6D,GACpE,cAAc,CAuFhB;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,kBAAkB,CAc1E;AAED,qDAAqD;AACrD,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,cAAc,CAAC,CAoErE"}

package/dist/utils/network_error.d.ts

@@ -1,10 +1,15 @@
 /** AbortError from fetch/XHR — usually intentional, not an app bug. */
 export declare function isAbortError(error: unknown): boolean;
+/** Explicit fetch/XHR timeout (AbortSignal.timeout / XHR timeout). */
+export declare function isTimeoutError(error: unknown): boolean;
 /**
  * Browser fetch transport failures (CORS, offline, DNS, blocked).
  * These reject with TypeError / NetworkError — not HTTP status codes.
+ * TimeoutError is handled separately via {@link isTimeoutError}.
  */
 export declare function isLikelyNetworkFetchError(error: unknown): boolean;
+/** True when a bare rejection may correlate with instrumented network/timeout meta. */
+export declare function isCorrelatableTransportError(error: unknown): boolean;
 export declare function describeUnknownError(error: unknown): {
     errorName: string;
     errorMessage: string;

package/dist/utils/network_error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network_error.d.ts","sourceRoot":"","sources":["../../src/utils/network_error.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEpD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAajE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAeA;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAIlC"}
+{"version":3,"file":"network_error.d.ts","sourceRoot":"","sources":["../../src/utils/network_error.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEpD;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAajE;AAED,uFAAuF;AACvF,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEpE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAeA;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAIlC"}

package/dist/utils/stacktrace.d.ts

@@ -0,0 +1,35 @@
+import type { StackFrame, StackTrace } from '../types.js';
+/** Options for classifying stack frames as in-app. */
+export interface InAppFrameOptions {
+    /** Page origin (e.g. `https://www.example.com`). Same-origin frames are in-app. */
+    pageOrigin?: string;
+    /** Extra origins treated as app code (exact origin strings, e.g. asset CDN). */
+    inAppOrigins?: string[];
+    /** Path substrings or RegExps that force `inApp: true`. */
+    allowUrls?: Array<string | RegExp>;
+    /** Path substrings or RegExps that force `inApp: false`. */
+    denyUrls?: Array<string | RegExp>;
+}
+/**
+ * Parse a V8 / Chrome `Error.stack` string into structured frames.
+ * Returns frames in **oldest → newest** order (crash site last).
+ */
+export declare function parseStackTrace(stack?: string | null, inAppOptions?: InAppFrameOptions): StackTrace | undefined;
+/** Parse a single V8 stack line into a frame, or null if not a frame. */
+export declare function parseStackLine(line: string, inAppOptions?: InAppFrameOptions): StackFrame | null;
+/**
+ * Apply `window.onerror` (or similar) location onto the newest frame,
+ * or synthesize a single frame when the stack had none.
+ */
+export declare function applySourceLocation(stacktrace: StackTrace | undefined, source?: {
+    filename?: string;
+    lineno?: number;
+    colno?: number;
+}, inAppOptions?: InAppFrameOptions): StackTrace | undefined;
+/**
+ * inApp heuristics: same-origin (or allowlisted) app code, not vendors/CDN/SDK.
+ */
+export declare function isInAppFrame(path: string, options?: InAppFrameOptions): boolean;
+/** Page origin from `window.location.origin` or a full page URL. */
+export declare function resolvePageOrigin(originOrUrl?: string): string | undefined;
+//# sourceMappingURL=stacktrace.d.ts.map

package/dist/utils/stacktrace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stacktrace.d.ts","sourceRoot":"","sources":["../../src/utils/stacktrace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAY1D,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,YAAY,CAAC,EAAE,iBAAiB,GAC/B,UAAU,GAAG,SAAS,CAcxB;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,iBAAiB,GAC/B,UAAU,GAAG,IAAI,CAgCnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/D,YAAY,CAAC,EAAE,iBAAiB,GAC/B,UAAU,GAAG,SAAS,CAyCxB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CA2BT;AAyCD,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1E"}

package/dist/utils/tags.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tag normalization and high-cardinality heuristics for the browser SDK.
+ *
+ * Precedence when merging (later wins): auto → init → scope/withTags → per-call.
+ */
+export declare const MAX_TAGS_PER_EVENT = 20;
+export declare const MAX_TAG_KEY_LENGTH = 64;
+export declare const MAX_TAG_VALUE_LENGTH = 128;
+export declare const MAX_TAG_TOTAL_UTF8_BYTES = 2048;
+/** Keys that usually belong in extra / top-level context, not tags. */
+export declare const HIGH_CARDINALITY_TAG_KEYS: Set<string>;
+export type TagMap = Record<string, string>;
+/**
+ * Sanitize a tag map: lowercase keys, charset, limits, size budget.
+ * Invalid entries are dropped (never throws).
+ */
+export declare function normalizeTags(tags: Record<string, unknown> | null | undefined): TagMap;
+/** Merge tag maps left-to-right; later keys win. Result is normalized. */
+export declare function mergeTags(...parts: Array<TagMap | undefined | null>): TagMap;
+export declare function looksHighCardinalityValue(value: string): boolean;
+/**
+ * Warn in non-production when tags look high-cardinality.
+ * No-op when `environment` is production or warnings are disabled.
+ */
+export declare function warnSuspiciousTags(tags: TagMap, environment: string | undefined): void;
+/** Reserved / preferred facet keys (conventions, not a closed enum). */
+export declare const RESERVED_TAG_KEYS: readonly ["service", "platform", "feature", "operation", "component", "runtime", "runtime_version"];
+//# sourceMappingURL=tags.d.ts.map

package/dist/utils/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/utils/tags.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAI7C,uEAAuE;AACvE,eAAO,MAAM,yBAAyB,aAapC,CAAC;AAOH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAyB5C;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAC/C,MAAM,CAuBR;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,MAAM,CAO5E;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,IAAI,CAqBN;AAED,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,qGAQpB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newtalaria/browser",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "Talaria browser SDK — error capture and session replay (rrweb)",
   "type": "module",
   "main": "./dist/index.js",