@deeptracer/browser 0.3.0 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +96 -0
- package/package.json +2 -2
package/README.md
ADDED
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
# @deeptracer/browser
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/@deeptracer/browser)
|
|
4
|
+
|
|
5
|
+
DeepTracer SDK for browsers — window error handlers and console capture. Re-exports everything from `@deeptracer/core`.
|
|
6
|
+
|
|
7
|
+
> **Most users should install [`@deeptracer/react`](https://github.com/getdeeptracer/deeptracer-js/tree/main/packages/react) or [`@deeptracer/nextjs`](https://github.com/getdeeptracer/deeptracer-js/tree/main/packages/nextjs) instead.** This package is the low-level browser runtime used internally by those packages.
|
|
8
|
+
|
|
9
|
+
## Installation
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npm install @deeptracer/browser
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## Quick Start
|
|
16
|
+
|
|
17
|
+
```ts
|
|
18
|
+
import { createLogger, captureGlobalErrors } from "@deeptracer/browser"
|
|
19
|
+
|
|
20
|
+
const logger = createLogger({
|
|
21
|
+
product: "my-app",
|
|
22
|
+
service: "web",
|
|
23
|
+
environment: "production",
|
|
24
|
+
endpoint: "https://deeptracer.example.com",
|
|
25
|
+
apiKey: "dt_live_xxx",
|
|
26
|
+
})
|
|
27
|
+
|
|
28
|
+
// Capture all unhandled errors and promise rejections
|
|
29
|
+
captureGlobalErrors(logger)
|
|
30
|
+
|
|
31
|
+
// Log events
|
|
32
|
+
logger.info("Page loaded", { route: "/dashboard" })
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
## API Reference
|
|
36
|
+
|
|
37
|
+
### `captureGlobalErrors(logger)`
|
|
38
|
+
|
|
39
|
+
Automatically capture unhandled errors and promise rejections via `window.addEventListener("error")` and `window.addEventListener("unhandledrejection")`.
|
|
40
|
+
|
|
41
|
+
- Uncaught exceptions: reported with severity `"critical"`
|
|
42
|
+
- Unhandled rejections: reported with severity `"high"`
|
|
43
|
+
|
|
44
|
+
```ts
|
|
45
|
+
import { createLogger, captureGlobalErrors } from "@deeptracer/browser"
|
|
46
|
+
|
|
47
|
+
const logger = createLogger({ ... })
|
|
48
|
+
captureGlobalErrors(logger)
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### `captureConsole(logger)`
|
|
52
|
+
|
|
53
|
+
Intercept all `console.log/info/warn/error/debug` calls and forward them to DeepTracer as log entries. Original console output is preserved.
|
|
54
|
+
|
|
55
|
+
```ts
|
|
56
|
+
import { createLogger, captureConsole } from "@deeptracer/browser"
|
|
57
|
+
|
|
58
|
+
const logger = createLogger({ ... })
|
|
59
|
+
captureConsole(logger)
|
|
60
|
+
|
|
61
|
+
// console.log("hello") → goes to BOTH console AND DeepTracer
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### Re-exported from @deeptracer/core
|
|
65
|
+
|
|
66
|
+
All public exports from `@deeptracer/core` are available directly:
|
|
67
|
+
|
|
68
|
+
- `createLogger(config)` — create a Logger instance
|
|
69
|
+
- `Logger` class — debug, info, warn, error, captureError, startSpan, setUser, setTags, setContext, addBreadcrumb, flush, destroy
|
|
70
|
+
- Types: `LoggerConfig`, `LogLevel`, `LogEntry`, `ErrorReport`, `LLMUsageReport`, `Span`, `InactiveSpan`, `SpanData`, `MiddlewareOptions`, `User`, `Breadcrumb`, `BeforeSendEvent`
|
|
71
|
+
- Constants: `SDK_VERSION`, `SDK_NAME`
|
|
72
|
+
|
|
73
|
+
See the [`@deeptracer/core` README](https://github.com/getdeeptracer/deeptracer-js/tree/main/packages/core) for full documentation.
|
|
74
|
+
|
|
75
|
+
## Monorepo
|
|
76
|
+
|
|
77
|
+
This package is part of the [DeepTracer JavaScript SDK](https://github.com/getdeeptracer/deeptracer-js) monorepo:
|
|
78
|
+
|
|
79
|
+
| Package | Description |
|
|
80
|
+
|---------|-------------|
|
|
81
|
+
| [`@deeptracer/core`](https://github.com/getdeeptracer/deeptracer-js/tree/main/packages/core) | Zero-dependency shared core |
|
|
82
|
+
| [`@deeptracer/node`](https://github.com/getdeeptracer/deeptracer-js/tree/main/packages/node) | Node.js/Bun SDK |
|
|
83
|
+
| [`@deeptracer/ai`](https://github.com/getdeeptracer/deeptracer-js/tree/main/packages/ai) | AI SDK wrappers |
|
|
84
|
+
| **`@deeptracer/browser`** | Browser SDK (this package) |
|
|
85
|
+
| [`@deeptracer/react`](https://github.com/getdeeptracer/deeptracer-js/tree/main/packages/react) | React integration |
|
|
86
|
+
| [`@deeptracer/nextjs`](https://github.com/getdeeptracer/deeptracer-js/tree/main/packages/nextjs) | Next.js integration |
|
|
87
|
+
|
|
88
|
+
## Links
|
|
89
|
+
|
|
90
|
+
- [deeptracer.dev](https://deeptracer.dev) — Homepage
|
|
91
|
+
- [Docs](https://deeptracer.dev/docs) — Documentation
|
|
92
|
+
- [GitHub](https://github.com/getdeeptracer/deeptracer-js) — Source code
|
|
93
|
+
|
|
94
|
+
## License
|
|
95
|
+
|
|
96
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@deeptracer/browser",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.1",
|
|
4
4
|
"description": "DeepTracer SDK for browsers — window error handlers, fetch interceptor",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.cjs",
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
},
|
|
24
24
|
"license": "MIT",
|
|
25
25
|
"dependencies": {
|
|
26
|
-
"@deeptracer/core": "0.3.
|
|
26
|
+
"@deeptracer/core": "0.3.1"
|
|
27
27
|
},
|
|
28
28
|
"scripts": {
|
|
29
29
|
"build": "tsup",
|