@rasputin-ai/browser 0.6.0

package/README.md

@@ -0,0 +1,111 @@
+# Official Rasputin AI SDK for browsers
+
+Report application errors to Rasputin from frontend apps.
+
+## Setup
+
+Initialize once when the application starts:
+
+```ts
+import { RasputinInit } from '@rasputin-ai/browser';
+
+export const rasputin = RasputinInit({
+  dsn: import.meta.env.VITE_RASPUTIN_DSN,
+  environment: 'production',
+  release: import.meta.env.VITE_RASPUTIN_RELEASE,
+});
+```
+
+The DSN is public and ingest-only. Do not put a project API key in frontend code.
+
+`release` and `environment` are required on `RasputinInit` and on the Vite plugin. Blank or whitespace values leave the SDK fully inert. The plugin injects the values you pass into `RasputinInit`. It does not invent a release.
+
+## Vite plugin
+
+Use the plugin to instrument the app and inject the DSN at build time:
+
+```ts
+import { rasputin } from '@rasputin-ai/browser/vite';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  plugins: [
+    rasputin({
+      dsn: process.env.VITE_RASPUTIN_DSN,
+      environment: 'production',
+      release: process.env.RASPUTIN_RELEASE!,
+      projectApiKey: process.env.RASPUTIN_PROJECT_API_KEY,
+    }),
+  ],
+});
+```
+
+`projectApiKey` is used by the plugin to upload the BrowserArtifact after `vite build`. It is never written into the browser bundle and is not used during `vite dev`.
+
+## Release and build identity
+
+These are different values. You normally do not configure `buildId`.
+
+**Release** is required. It is the source/deployment revision, usually a Git SHA. Pass it to the Vite plugin (and to `RasputinInit` if you boot the SDK yourself). It is used for deployment grouping and repository source lookup.
+
+**Build ID** is generated automatically for each browser compilation (`b_<uuid>`). It namespaces compact runtime ids (`moduleIndex.planIndex`) and the uploaded BrowserArtifact. Two production builds of the same commit get two build IDs. Open tabs from an older build keep resolving against their own artifact.
+
+`vite dev` instruments modules in memory for local debugging and HMR. It does not write `.rasputin/`, register a production build, or POST `/browserArtifacts`. A new `buildId` is minted for that dev-server process and stays stable across route navigation and HMR. Production artifact upload happens only on `vite build`.
+
+`verifyConfiguration()` and the success log report both:
+
+```text
+Release:
+a39498e31207580763ebac2c752a82fdb30b133b
+
+Browser build:
+b_f37c9a1e-...
+```
+
+Leave `buildId` unset. An explicit `buildId` is only for tests or advanced tooling; the caller then owns uniqueness. Do not pass a Git SHA as `buildId`.
+
+## Diagnostics
+
+`verifyConfiguration()` reports whether the SDK is active and why. `getStats()` returns recorder, transport, and compile counters for support and local debugging. Neither is required to send errors.
+
+## Configuration
+
+| Field | Required | Description |
+| --- | --- | --- |
+| `dsn` | yes | Public project DSN from Rasputin project settings |
+| `environment` | yes | Environment such as `production` or `staging`. Required on the Vite plugin; injected into `RasputinInit`. |
+| `release` | yes | Source/deployment revision. Required on the Vite plugin; injected into `RasputinInit`. |
+| `enabled` | no | Enables or disables the SDK; defaults to `true` |
+| `logSuccess` | no | Prints a configuration summary when setup succeeds; defaults to `true` |
+| `apiUrl` | no | Override the API origin from the DSN. Leave unset unless you self-host. |
+| `installGlobalHandlers` | no | Observe `window` `error` and `unhandledrejection`. Defaults to `true`. |
+
+A missing, blank, or invalid DSN, release, or environment leaves the SDK fully inert.
+
+## Privacy
+
+Browser capture is name-based and bounded. It is not a generic secret scanner.
+
+Automatically omitted or redacted:
+
+- Function parameters whose names match known sensitive keys, including `password`, `token`, `authorization`, `cookie`, `apiKey`, `secret`, and `databaseUrl`. Redaction happens at compile time. The recorder never reads that binding.
+- Static property paths with those same names, such as `user.password` or `headers.authorization`.
+- DOM and form surfaces: `input.value`, `textarea.value`, `textContent`, `innerText`, `innerHTML`. Any terminal `.value` read is left unobserved, including non-DOM objects such as `error.value`. Nested reads like `error.value.message` are still observed.
+- Query-bearing URL surfaces: `location.href`, `location.search`, `document.URL`.
+
+Still captured under normal rules:
+
+- Ordinary primitives and safe parameter names, including a parameter named `value`.
+- Safe property reads such as `user.email`.
+- Ordinary strings. `const note = "my password is hunter2"` is stored as that string.
+- Current own data properties of verified JSON and compiler-known ordinary objects. Accessors are not invoked. Names, emails, addresses, wallet addresses, and similar strings may appear unless the property name matches the sensitive-name policy.
+
+Not scanned or intercepted:
+
+- Unknown, Proxy, and reactive objects. Those stay opaque.
+- String contents for embedded secrets.
+- Network request or response bodies.
+- The DOM tree or keystrokes.
+- Extra getter, Proxy, or coercion reads beyond the application's own expression.
+
+Custom browser `redactKeys` are not supported. Use a non-sensitive parameter name if a value must stay out of recordings, or keep it off a captured primitive argument. A full URL passed as a string argument named `url` is still captured.

package/dist/browser-frames.d.ts

@@ -0,0 +1,11 @@
+export type BrowserFrame = {
+    generated: {
+        file: string;
+        line?: number;
+        column?: number;
+    };
+    function?: string;
+    in_app: boolean;
+};
+export declare const framesFromError: (error: unknown) => BrowserFrame[];
+//# sourceMappingURL=browser-frames.d.ts.map

package/dist/browser-frames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-frames.d.ts","sourceRoot":"","sources":["../src/browser-frames.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG;IAC1B,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CAChB,CAAC;AAeF,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,YAAY,EAO5D,CAAC"}

package/dist/browser-ingest-event.d.ts

@@ -0,0 +1,10 @@
+import type { BrowserFrame } from './browser-frames';
+import type { BrowserIngestEvent, BrowserIngestRuntimeState } from './ingest-types';
+export declare const createBrowserIngestEvent: (input: {
+    error: unknown;
+    frames: BrowserFrame[];
+    environment: string;
+    release: string;
+    runtimeState?: BrowserIngestRuntimeState;
+}) => BrowserIngestEvent;
+//# sourceMappingURL=browser-ingest-event.d.ts.map

package/dist/browser-ingest-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-ingest-event.d.ts","sourceRoot":"","sources":["../src/browser-ingest-event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AA6BpF,eAAO,MAAM,wBAAwB,GAAI,OAAO;IAC/C,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,yBAAyB,CAAC;CACzC,KAAG,kBA2BH,CAAC"}

package/dist/browser-recorder.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Browser execution recorder.
+ *
+ * Owns the frame carrier, settling, observe, reactive-sparse, history, and
+ * opaque capture. It does not use AsyncLocalStorage or the Node freezer.
+ */
+import type { EncodedFunctionPlan } from '@rasputin-ai/recorder/runtime';
+import type { BrowserInitOptions, BrowserRuntimeState, CallHandle, CaptureClass, ExecutionSnapshot, HistoryRecord } from './browser-runtime-types';
+export declare const createBrowserRecorder: (options?: BrowserInitOptions) => {
+    enter: (moduleIndex: number, planIndex: number, args?: ArrayLike<unknown>, omitValues?: boolean, plan?: EncodedFunctionPlan, callee?: object) => CallHandle;
+    registerIdentities: (items: Array<{
+        compactId: string;
+        functionId: string;
+        name: string;
+        captureClass: CaptureClass;
+        packageRelativePath?: string | null;
+        line: number | null;
+        column: number | null;
+        siteId?: number;
+        moduleIndex?: number;
+        planIndex?: number;
+    }>) => void;
+    observe: (siteId: string | number, value: unknown) => unknown;
+    reactiveRegister: (entries: unknown) => void;
+    reactiveHit: (id: number) => boolean;
+    reactiveLeave: (id: number, value?: unknown) => unknown;
+    reactiveThrow: (id: number, error: unknown) => void;
+    reactiveDone: () => void;
+    noteStateWrite: (key: string, value: unknown) => void;
+    noteStateRead: (key: string, value: unknown) => void;
+    getHistory: () => HistoryRecord[];
+    getErrorState(error: unknown): ExecutionSnapshot | undefined;
+    getState(): BrowserRuntimeState;
+    reset(): void;
+};
+//# sourceMappingURL=browser-recorder.d.ts.map

package/dist/browser-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-recorder.d.ts","sourceRoot":"","sources":["../src/browser-recorder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EACX,kBAAkB,EAElB,mBAAmB,EACnB,UAAU,EACV,YAAY,EAIZ,iBAAiB,EAIjB,aAAa,EAKb,MAAM,yBAAyB,CAAC;AAsNjC,eAAO,MAAM,qBAAqB,GAAI,UAAS,kBAAuB;yBA+jCvD,MAAM,aACR,MAAM,SACV,SAAS,CAAC,OAAO,CAAC,eACZ,OAAO,SACb,mBAAmB,WACjB,MAAM,KACb,UAAU;gCA/9BL,KAAK,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,YAAY,CAAC;QAC3B,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACpC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;sBA49BsB,MAAM,GAAG,MAAM,SAAS,OAAO;gCA4DrB,OAAO;sBAkCjB,MAAM,KAAG,OAAO;wBAgDd,MAAM,UAAU,OAAO;wBAcvB,MAAM,SAAS,OAAO;;0BAnrBpB,MAAM,SAAS,OAAO;yBAgBvB,MAAM,SAAS,OAAO;;yBA+uB5B,OAAO,GAAG,iBAAiB,GAAG,SAAS;gBAQhD,mBAAmB;;CAgChC,CAAC"}

package/dist/browser-runtime-types.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Browser recorder wire and snapshot vocabulary.
+ *
+ * Interaction, detached, provenance, expression_observed, and reactive
+ * stats stay here. Node does not import this file.
+ */
+import type { CapturedValue } from './captured-value';
+export type CaptureMode = 'structure' | 'values';
+export type CaptureProfile = 'normal' | 'values-off' | 'helpers-sparse';
+export type RecorderCostProfile = {
+    enterMs: number;
+    leaveEndMs: number;
+    journalMs: number;
+    resolveMs: number;
+    handleAllocMs: number;
+    structureMs: number;
+    suppressMs: number;
+    observeMs: number;
+    captureMs: number;
+    historyMs: number;
+    statsMs: number;
+    entersFull: number;
+    entersStructure: number;
+    entersSkip: number;
+    entersSparse: number;
+    observeCalls: number;
+    reactiveHitMs: number;
+    reactiveRepeats: number;
+};
+export type CaptureClass = 'full' | 'structure' | 'skip' | 'reactive-sparse';
+export type Provenance = 'observed' | 'inferred' | 'inferred-ambiguous' | 'unlinked';
+export type ExecutionKind = 'interaction' | 'detached';
+export type FunctionIdentity = {
+    functionId: string;
+    name: string;
+    packageName: string | null;
+    packageRelativePath: string | null;
+    line: number | null;
+    column: number | null;
+    captureClass: CaptureClass;
+    moduleIndex?: number;
+    planIndex?: number;
+};
+export type BrowserIdentityRecord = {
+    compactId: string;
+    functionId: string;
+    name: string;
+    captureClass: CaptureClass;
+    packageRelativePath?: string | null;
+    line: number | null;
+    column: number | null;
+    siteId?: number;
+    moduleIndex?: number;
+    planIndex?: number;
+};
+export type BrowserInitOptions = {
+    settlingMs?: number;
+    holdMs?: number;
+    captureMode?: CaptureMode;
+    identities?: BrowserIdentityRecord[];
+    maxStructuralEvents?: number;
+    maxValueEvents?: number;
+    maxCapturedCallsPerFunction?: number;
+    maxRecentExecutions?: number;
+    maxRetainedSnapshots?: number;
+    maxHistory?: number;
+    maxOpenExecutions?: number;
+    profileCosts?: boolean;
+};
+export type FunctionEnterEvent = {
+    type: 'function_enter';
+    callId: number;
+    functionId: string;
+    parentCallId?: number;
+    timestampMs: number;
+    provenance: Provenance;
+    args?: CapturedValue[];
+    argsOmitted?: true;
+    materialized?: 'throw-time';
+};
+export type FunctionExitEvent = {
+    type: 'function_exit';
+    callId: number;
+    timestampMs: number;
+    returnValue?: CapturedValue;
+};
+export type FunctionThrowEvent = {
+    type: 'function_throw';
+    callId: number;
+    timestampMs: number;
+    errorName?: string;
+    errorMessage?: string;
+    priorSuccessfulRuns?: number;
+    error?: {
+        __rasputin_type: 'ErrorReference';
+        callId: number;
+    };
+};
+export type AwaitedEvent = {
+    type: 'awaited';
+    callId: number;
+    timestampMs: number;
+    value?: CapturedValue;
+    omitted?: true;
+};
+export type CallsSuppressedEvent = {
+    type: 'function_calls_suppressed';
+    functionId: string;
+    parentCallId?: number;
+    timestampMs: number;
+    suppressedCallCount: number;
+};
+export type ExpressionObservedEvent = {
+    type: 'expression_observed';
+    siteId: string | number;
+    callId?: number;
+    timestampMs: number;
+    value: CapturedValue;
+};
+export type StateFact = {
+    key: string;
+    value: CapturedValue;
+    timestampMs: number;
+    functionName?: string;
+};
+export type HistoryRelationship = 'observed-write' | 'last-observed-write' | 'inferred';
+export type HistoryLink = {
+    executionId: string;
+    relationship: HistoryRelationship;
+    key?: string;
+};
+export type HistoryRecord = {
+    executionId: string;
+    kind: ExecutionKind;
+    eventType?: string;
+    startedAt: number;
+    durationMs: number;
+    functionNames: string[];
+    writes: StateFact[];
+};
+export type RecorderEvent = FunctionEnterEvent | FunctionExitEvent | FunctionThrowEvent | AwaitedEvent | CallsSuppressedEvent | ExpressionObservedEvent;
+export type ExecutionSnapshot = {
+    executionId: string;
+    kind: ExecutionKind;
+    eventType?: string;
+    startedAt: number;
+    /** Wall-clock start, only when the recorder stored Date.now() at create. */
+    startedAtIso?: string;
+    durationMs: number;
+    provenanceNotes: string[];
+    functions: FunctionIdentity[];
+    events: RecorderEvent[];
+    captureMode: CaptureMode;
+    writes: StateFact[];
+    reads: StateFact[];
+    historyLinks: HistoryLink[];
+    partial?: boolean;
+    captureProfile?: CaptureProfile;
+};
+export type ExecutionSummary = {
+    executionId: string;
+    kind: ExecutionKind;
+    eventType?: string;
+    functionNames: string[];
+    durationMs: number;
+    hadError: boolean;
+};
+export type BrowserRecorderStats = {
+    functionCallsObserved: number;
+    functionCallsCaptured: number;
+    successfulExecutionsDiscarded: number;
+    errorSnapshots: number;
+    activeExecutions: number;
+    peakActiveExecutions: number;
+    activeEstimatedBytes: number;
+    peakActiveEstimatedBytes: number;
+    attributionInferred: number;
+    attributionInferredAmbiguous: number;
+    attributionUnlinked: number;
+    truncatedEvents: number;
+    truncatedStructural: number;
+    omittedValueObservations: number;
+    expressionObservations: number;
+    repeatedCallsSuppressed: number;
+    executionsDroppedUnderPressure: number;
+    reactiveCallbackInvocations: number;
+    reactiveRecordedEntries: number;
+    reactiveSparseCounted: number;
+    reactiveThrows: number;
+    costs?: RecorderCostProfile;
+};
+export type BrowserRuntimeState = {
+    open: ExecutionSummary[];
+    recent: ExecutionSummary[];
+    snapshots: ExecutionSnapshot[];
+    history: HistoryRecord[];
+    stats: BrowserRecorderStats;
+};
+export type CallHandle = {
+    leave: (value?: unknown) => unknown;
+    fail: (error: unknown, liveArgs?: ArrayLike<unknown>) => void;
+    end: () => void;
+    run: <T>(callback: () => T) => T;
+    suspend: (value?: unknown) => unknown;
+    resume: (...restored: unknown[]) => unknown;
+};
+//# sourceMappingURL=browser-runtime-types.d.ts.map

package/dist/browser-runtime-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-runtime-types.d.ts","sourceRoot":"","sources":["../src/browser-runtime-types.ts"],"names":[],"mappings":"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"}

package/dist/browser-runtime.d.ts

@@ -0,0 +1,14 @@
+import type { BrowserInitOptions, BrowserRuntimeState, ExecutionSnapshot, HistoryRecord } from './browser-runtime-types';
+export declare const RasputinBrowserInit: (options?: BrowserInitOptions) => {
+    getState: () => BrowserRuntimeState;
+    getErrorState: (error: unknown) => ExecutionSnapshot | undefined;
+    getHistory: () => HistoryRecord[];
+};
+export declare const getBrowserRuntimeState: () => BrowserRuntimeState;
+export declare const getBrowserErrorState: (error: unknown) => ExecutionSnapshot | undefined;
+export declare const resetBrowserRuntime: () => void;
+export declare const registerBrowserIdentities: (items: NonNullable<BrowserInitOptions["identities"]>) => void;
+export declare const getBrowserHistory: () => HistoryRecord[];
+export declare const uninstallBrowserRuntime: () => void;
+export declare const browserRuntimeIsInstalled: () => boolean;
+//# sourceMappingURL=browser-runtime.d.ts.map

package/dist/browser-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-runtime.d.ts","sourceRoot":"","sources":["../src/browser-runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,MAAM,yBAAyB,CAAC;AAkIjC,eAAO,MAAM,mBAAmB,GAAI,UAAS,kBAAuB;;;;CAwDnE,CAAC;AAEF,eAAO,MAAM,sBAAsB,QAAO,mBA6BxC,CAAC;AAEH,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,iBAAiB,GAAG,SAC1C,CAAC;AAEjC,eAAO,MAAM,mBAAmB,YAE/B,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,OAAO,WAAW,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,SAG7F,CAAC;AAIF,eAAO,MAAM,iBAAiB,QAAO,aAAa,EAAmC,CAAC;AAEtF,eAAO,MAAM,uBAAuB,YAQnC,CAAC;AAEF,eAAO,MAAM,yBAAyB,QAAO,OAAkC,CAAC"}

package/dist/browser-transport.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Browser ingest transport.
+ *
+ * Bounded queue and page-lifecycle flush. Large snapshots must not block
+ * navigation; losing telemetry is preferred over delaying unload.
+ */
+import type { IngestSummary } from '@rasputin-ai/core';
+import type { BrowserIngestEvent } from './ingest-types';
+import type { RasputinBrowserTransportStats } from './public-types';
+type BrowserTransportFetch = (input: string, init?: RequestInit) => Promise<{
+    status: number;
+    ok: boolean;
+}>;
+type CreateBrowserTransportOptions = {
+    ingestUrl: string;
+    publicKey: string;
+    sdkName: string;
+    sdkVersion: string;
+    enabled: boolean;
+    fetch?: BrowserTransportFetch;
+    beforeFlush?: () => void;
+    maxQueueSize?: number;
+    maxQueueBytes?: number;
+    batchSize?: number;
+    flushIntervalMs?: number;
+    maxRetries?: number;
+};
+export declare const createBrowserTransport: (options: CreateBrowserTransportOptions) => {
+    enqueue: (event: BrowserIngestEvent) => void;
+    enqueueSummary: (summary: IngestSummary) => void;
+    flush: (_timeoutMs?: number) => Promise<void>;
+    close: () => Promise<void>;
+    getStats: () => RasputinBrowserTransportStats;
+};
+export {};
+//# sourceMappingURL=browser-transport.d.ts.map

package/dist/browser-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-transport.d.ts","sourceRoot":"","sources":["../src/browser-transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAEpE,KAAK,qBAAqB,GAAG,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,WAAW,KACd,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAQ9C,KAAK,6BAA6B,GAAG;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAkDF,eAAO,MAAM,sBAAsB,GAAI,SAAS,6BAA6B;qBAwDpD,kBAAkB;8BAIT,aAAa;yBA+OlB,MAAM;;oBAoBnB,6BAA6B;CAoB5C,CAAC"}

package/dist/captured-value.d.ts

@@ -0,0 +1,48 @@
+export type CapturedValue = {
+    kind: 'primitive';
+    value: string | number | boolean;
+    originalLength?: number;
+    truncated?: true;
+    reason?: 'max_string_length';
+} | {
+    kind: 'null';
+} | {
+    kind: 'undefined';
+} | {
+    kind: 'hole';
+} | {
+    kind: 'bigint';
+    value: string;
+} | {
+    kind: 'opaque';
+    jsType: string;
+    array?: boolean;
+} | {
+    kind: 'accessor';
+} | {
+    kind: 'circular';
+} | {
+    kind: 'shared';
+} | {
+    kind: 'struct';
+    array?: boolean;
+    entries: {
+        key: string;
+        value: CapturedValue;
+    }[];
+    truncated?: true;
+    reason?: 'max_keys' | 'max_depth' | 'max_nodes' | 'max_bytes' | 'wide_object' | 'omitted_symbols' | 'omitted_extra_keys';
+} | {
+    kind: 'redacted';
+};
+export declare const MAX_BROWSER_STRING_LENGTH = 500;
+export declare const MAX_ORDINARY_ARRAY_ELEMENTS = 20;
+export declare const MAX_OWN_KEYS_ENUMERATION = 256;
+export declare const tagVerifiedOrdinary: (object: unknown) => unknown;
+export declare const isVerifiedOrdinary: (object: unknown) => boolean;
+export declare const rememberKnownLiteral: (object: unknown, _keys?: unknown, _values?: unknown) => unknown;
+export declare const passthroughKnownLiteral: (object: unknown) => unknown;
+export declare const tagJsonParseResult: (value: unknown) => unknown;
+export declare const captureValue: (value: unknown) => CapturedValue;
+export declare const estimateCapturedBytes: (value: CapturedValue) => number;
+//# sourceMappingURL=captured-value.d.ts.map

package/dist/captured-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captured-value.d.ts","sourceRoot":"","sources":["../src/captured-value.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,aAAa,GACtB;IACA,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC5B,GACD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,aAAa,CAAA;KAAE,EAAE,CAAC;IACjD,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,MAAM,CAAC,EACJ,UAAU,GACV,WAAW,GACX,WAAW,GACX,WAAW,GACX,aAAa,GACb,iBAAiB,GACjB,oBAAoB,CAAC;CACvB,GACD;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAExB,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAG7C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAG9C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AA0B5C,eAAO,MAAM,mBAAmB,GAAI,QAAQ,OAAO,KAAG,OAQrD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,QAAQ,OAAO,KAAG,OAOpD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAChC,QAAQ,OAAO,EACf,QAAQ,OAAO,EACf,UAAU,OAAO,KACf,OAAsC,CAAC;AAE1C,eAAO,MAAM,uBAAuB,GAAI,QAAQ,OAAO,KAAG,OAAiB,CAAC;AA0D5E,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,OAGnD,CAAC;AAyOF,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,aACiD,CAAC;AAEhG,eAAO,MAAM,qBAAqB,GAAI,OAAO,aAAa,KAAG,MAe5D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { RasputinBrowserClient, RasputinBrowserClientStats, RasputinBrowserConfiguration, RasputinBrowserInstrumentationStats, RasputinBrowserOptions, RasputinBrowserRecorderStats, RasputinBrowserTransportStats, } from './public-types';
+export { RasputinInit } from './rasputin-init';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,EAC5B,mCAAmC,EACnC,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,GAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}