@starko-one/sdk 0.0.0-stage → 0.1.0-beta.0
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/CHANGELOG.md +124 -0
- package/LICENSE +17 -0
- package/NOTICE +58 -0
- package/README.md +81 -2
- package/dist/api-B5IHeINe.d.ts +558 -0
- package/dist/api-DR4HazCu.d.cts +558 -0
- package/dist/browser/index.cjs +168 -0
- package/dist/browser/index.d.cts +131 -0
- package/dist/browser/index.d.ts +131 -0
- package/dist/browser/index.js +7 -0
- package/dist/build/rollup.cjs +22 -0
- package/dist/build/rollup.d.cts +34 -0
- package/dist/build/rollup.d.ts +34 -0
- package/dist/build/rollup.js +3 -0
- package/dist/build/vite.cjs +51 -0
- package/dist/build/vite.d.cts +23 -0
- package/dist/build/vite.d.ts +23 -0
- package/dist/build/vite.js +46 -0
- package/dist/build/webpack.cjs +18 -0
- package/dist/build/webpack.d.cts +39 -0
- package/dist/build/webpack.d.ts +39 -0
- package/dist/build/webpack.js +3 -0
- package/dist/chunk-7HYGODU6.cjs +583 -0
- package/dist/chunk-A5M4NOVT.js +413 -0
- package/dist/chunk-A7MYYWMP.cjs +15 -0
- package/dist/chunk-BAQA47FM.js +1113 -0
- package/dist/chunk-CM7HM6CC.js +563 -0
- package/dist/chunk-DFYNIWUN.js +608 -0
- package/dist/chunk-DMVVCGKO.cjs +96 -0
- package/dist/chunk-FARGXYJ4.cjs +56 -0
- package/dist/chunk-G3MYIAX2.js +1226 -0
- package/dist/chunk-G4NAVZQ4.js +249 -0
- package/dist/chunk-GH7RYPKS.js +96 -0
- package/dist/chunk-HADYYQNL.cjs +134 -0
- package/dist/chunk-HOQPAB4X.js +178 -0
- package/dist/chunk-J5RU73SW.js +214 -0
- package/dist/chunk-JNAJ3YZB.cjs +223 -0
- package/dist/chunk-KN7H22EQ.cjs +659 -0
- package/dist/chunk-LDQ4I7FZ.cjs +1151 -0
- package/dist/chunk-NPGESRVQ.js +1212 -0
- package/dist/chunk-OPWM5V7A.cjs +258 -0
- package/dist/chunk-PYYWPIFL.cjs +1230 -0
- package/dist/chunk-R7JLZ4WO.cjs +115 -0
- package/dist/chunk-SC6VQSES.js +213 -0
- package/dist/chunk-TPSJGLR3.cjs +220 -0
- package/dist/chunk-UKBY6HPC.js +131 -0
- package/dist/chunk-VRSEHRBX.cjs +185 -0
- package/dist/chunk-X74AONZA.js +90 -0
- package/dist/chunk-XW3I5CJN.js +12 -0
- package/dist/chunk-XW56FKKJ.js +53 -0
- package/dist/chunk-Z3G5SW7R.cjs +1251 -0
- package/dist/chunk-ZVMAN7OO.cjs +431 -0
- package/dist/cli/index.cjs +1487 -0
- package/dist/common-ARWXbeS3.d.ts +36 -0
- package/dist/common-CwIFh2hK.d.cts +36 -0
- package/dist/dedupe-eHBIfUUD.d.cts +13 -0
- package/dist/dedupe-fw8aNtt4.d.ts +13 -0
- package/dist/handler-DTZ4Rzcf.d.ts +82 -0
- package/dist/handler-_00lctTI.d.cts +82 -0
- package/dist/index.cjs +277 -0
- package/dist/index.d.cts +187 -0
- package/dist/index.d.ts +187 -0
- package/dist/index.js +4 -0
- package/dist/next/client.cjs +113 -0
- package/dist/next/client.d.cts +26 -0
- package/dist/next/client.d.ts +26 -0
- package/dist/next/client.js +41 -0
- package/dist/next/config.cjs +275 -0
- package/dist/next/config.d.cts +193 -0
- package/dist/next/config.d.ts +193 -0
- package/dist/next/config.js +261 -0
- package/dist/next/index.cjs +148 -0
- package/dist/next/index.d.cts +32 -0
- package/dist/next/index.d.ts +32 -0
- package/dist/next/index.js +59 -0
- package/dist/node/index.cjs +257 -0
- package/dist/node/index.d.cts +145 -0
- package/dist/node/index.d.ts +145 -0
- package/dist/node/index.js +83 -0
- package/dist/options-0BhybO54.d.cts +47 -0
- package/dist/options-0BhybO54.d.ts +47 -0
- package/dist/react/index.cjs +107 -0
- package/dist/react/index.d.cts +84 -0
- package/dist/react/index.d.ts +84 -0
- package/dist/react/index.js +103 -0
- package/dist/scope-Bvh45bOf.d.cts +404 -0
- package/dist/scope-Bvh45bOf.d.ts +404 -0
- package/dist/server-edge-BPOGA3GH.cjs +51 -0
- package/dist/server-edge-GYKAJREU.js +48 -0
- package/dist/server-node-HYK2OB2J.js +24 -0
- package/dist/server-node-J2DBAHDV.cjs +27 -0
- package/dist/session-C_WzbEN2.d.cts +4 -0
- package/dist/session-C_WzbEN2.d.ts +4 -0
- package/dist/session-propagation-B7REA7uy.d.cts +30 -0
- package/dist/session-propagation-BnJjKJbR.d.ts +30 -0
- package/dist/starko.min.js +6 -0
- package/docs/browser.md +381 -0
- package/docs/configuration.md +269 -0
- package/docs/nextjs.md +312 -0
- package/docs/node.md +376 -0
- package/docs/other-backends.md +232 -0
- package/docs/privacy.md +112 -0
- package/docs/react.md +187 -0
- package/docs/source-maps.md +332 -0
- package/docs/troubleshooting.md +171 -0
- package/docs/widget.md +84 -0
- package/docs/wire-format.md +367 -0
- package/package.json +98 -4
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to `@starko-one/sdk`. Versions follow
|
|
4
|
+
[semantic versioning](https://semver.org); while the version is below 1.0, a
|
|
5
|
+
minor version may contain breaking changes, and they are listed here.
|
|
6
|
+
|
|
7
|
+
## 0.1.0-beta.0
|
|
8
|
+
|
|
9
|
+
First public beta.
|
|
10
|
+
|
|
11
|
+
### `@starko-one/sdk/browser` (and the script-tag bundle `dist/starko.min.js`)
|
|
12
|
+
|
|
13
|
+
- `init` with uncaught errors and unhandled promise rejections captured,
|
|
14
|
+
stack traces parsed for Chrome, Firefox and Safari, and `cause` chains and
|
|
15
|
+
`AggregateError`s reported as one event.
|
|
16
|
+
- Breadcrumbs: clicks (as a selector, never text or input values),
|
|
17
|
+
navigation, `fetch` and XHR (method, URL, status), console warnings and
|
|
18
|
+
errors.
|
|
19
|
+
- `setUser`, `identify(user, userHash)` for verified customers, tags, extra,
|
|
20
|
+
contexts, `withScope`, `captureException`, `captureMessage`.
|
|
21
|
+
- Noise filters (extensions, `Script error.`, `ResizeObserver`, aborted and
|
|
22
|
+
failed requests), `ignoreErrors`, `allowUrls`, `denyUrls`, `sampleRate`,
|
|
23
|
+
`beforeSend`, `beforeBreadcrumb`, and a duplicate filter that compares
|
|
24
|
+
the error, its fingerprint, the user and the session.
|
|
25
|
+
- Rate limits: per error (its type and message, with numbers and ids
|
|
26
|
+
masked) 10 at once then 1 every 10 seconds, and 100 events per page load.
|
|
27
|
+
Drops are reported in the console at most once a minute per limit, with
|
|
28
|
+
a count.
|
|
29
|
+
- Batching, retries with back-off that honour `Retry-After`, a pause after
|
|
30
|
+
repeated failures, and a `keepalive` send when the page is hidden.
|
|
31
|
+
Redirects are never followed.
|
|
32
|
+
- The workspace's remote config (on/off, sample rate, suppression rules).
|
|
33
|
+
- URL redaction (fragments, credentials, sensitive query values) on every
|
|
34
|
+
URL sent.
|
|
35
|
+
- Works with the Starko widget: one capture, the recorder's session id and
|
|
36
|
+
the widget's verified customer token on every error.
|
|
37
|
+
- Same-origin requests carry the session id, so server errors link to the
|
|
38
|
+
browser session.
|
|
39
|
+
- Script tag: starts itself from `data-workspace-key`, `data-release`,
|
|
40
|
+
`data-environment`, `data-host`, `data-debug`; works as a classic,
|
|
41
|
+
`defer`, `async` or `type="module"` script. 19.04 kB gzipped.
|
|
42
|
+
- `sdk.version` on every event is the package version.
|
|
43
|
+
|
|
44
|
+
### `@starko-one/sdk/node`
|
|
45
|
+
|
|
46
|
+
- `init` for Node.js 18 and later, on Node built-ins only.
|
|
47
|
+
- Every request of an HTTP, HTTPS or HTTP/2 server runs in its own scope
|
|
48
|
+
without middleware: `request`, `checkContinue`, `checkExpectation`,
|
|
49
|
+
`upgrade` and `connect` events, and HTTP/2's compatibility API and raw
|
|
50
|
+
`stream` event, for servers created before or after `init` (tested on
|
|
51
|
+
Node 20, 22, 24 and 26).
|
|
52
|
+
- Request scopes start from a base fixed when the process begins serving:
|
|
53
|
+
`init({ user })` and the tags, extra and contexts set before. Code
|
|
54
|
+
outside any request after that (jobs, timers, pool callbacks) gets a
|
|
55
|
+
scope confined to its own async context, so nothing it sets reaches a
|
|
56
|
+
request or another job. `markServing()` begins serving explicitly.
|
|
57
|
+
- Uncaught exceptions and unhandled rejections captured without changing
|
|
58
|
+
how Node exits; the crash event is sent before the process exits. In a
|
|
59
|
+
worker thread the error is captured, sent, and handed back to Node, so
|
|
60
|
+
the parent's `Worker` still gets `'error'`.
|
|
61
|
+
- Queued events sent when the event loop empties and on `SIGTERM` /
|
|
62
|
+
`SIGINT` (when the app has no handler), without waiting for the remote
|
|
63
|
+
config; the SDK never keeps the process alive otherwise.
|
|
64
|
+
- Source lines around in-app frames, read only from source files inside the
|
|
65
|
+
application root (never a filesystem root).
|
|
66
|
+
- Console breadcrumbs, request data, host and runtime context; duplicates
|
|
67
|
+
are compared per request, user and session.
|
|
68
|
+
- `expressRequestHandler` and `expressErrorHandler` for Express 4 and 5;
|
|
69
|
+
`wrapHandler` for other frameworks and serverless functions;
|
|
70
|
+
`runWithRequestScope`.
|
|
71
|
+
- Optional secret key (`apiKey`) so the server's user ids are trusted. A
|
|
72
|
+
key the ingest API refuses drops the batch without retrying and is
|
|
73
|
+
reported once.
|
|
74
|
+
- Proxies through `NODE_USE_ENV_PROXY` (Node 24.5+) or a `fetch` of your own.
|
|
75
|
+
- Limits for long-running servers: 300 events a minute, no lifetime cap.
|
|
76
|
+
- The release a build plugin wrote into a bundle is read for each event,
|
|
77
|
+
so `init` may run before the bundle loads.
|
|
78
|
+
|
|
79
|
+
### `@starko-one/sdk/next`, `/next/client`, `/next/config`
|
|
80
|
+
|
|
81
|
+
- `register` and `onRequestError` for `instrumentation.ts` on the Node.js
|
|
82
|
+
and Edge runtimes, with route, router kind, route type and render source.
|
|
83
|
+
`register()` begins serving, so a request that arrives while it runs
|
|
84
|
+
keeps what it sets to itself.
|
|
85
|
+
- `init` and `captureGlobalError` for `instrumentation-client.ts` and
|
|
86
|
+
`global-error.tsx`.
|
|
87
|
+
- Next's control flow (`redirect()`, `notFound()`, …) never reported.
|
|
88
|
+
- Flushes that never delay the error response: the platform's `waitUntil`
|
|
89
|
+
on Vercel and Cloudflare, the queue on long-lived servers.
|
|
90
|
+
- `withStarko(nextConfig)`: debug ids and source-map upload for webpack and
|
|
91
|
+
Turbopack builds, maps it switched on deleted from `.next` afterwards.
|
|
92
|
+
On Next 16 it uses Turbopack's native debug ids. It never rewrites a
|
|
93
|
+
client chunk that registers its own debug id, and with
|
|
94
|
+
`experimental.sri` no client chunk at all, so integrity hashes stay valid.
|
|
95
|
+
- The build's release is compiled into the app (`env.STARKO_BUILD_RELEASE`,
|
|
96
|
+
set by `withStarko`), so browser, server and Edge events carry the same
|
|
97
|
+
release as their source maps without a `release` in `init` or `register`.
|
|
98
|
+
- `output: "standalone"` on webpack builds keeps the server source maps that
|
|
99
|
+
Next copies afterwards.
|
|
100
|
+
|
|
101
|
+
### `@starko-one/sdk/react`
|
|
102
|
+
|
|
103
|
+
- `StarkoErrorBoundary`, `withErrorBoundary`, and `reactErrorHandler` for
|
|
104
|
+
React 19's root error options.
|
|
105
|
+
- A client module (`"use client"`): a Server Component can render
|
|
106
|
+
`StarkoErrorBoundary` with a React-node fallback.
|
|
107
|
+
|
|
108
|
+
### `@starko-one/sdk/vite`, `/rollup`, `/webpack` and the `starko` command
|
|
109
|
+
|
|
110
|
+
- Debug ids injected into every bundle, source maps uploaded, maps the
|
|
111
|
+
plugin switched on removed from the output whatever the upload's outcome.
|
|
112
|
+
Rollup decides per output; webpack treats a `SourceMapDevToolPlugin` in
|
|
113
|
+
your config as yours and removes only the maps it added.
|
|
114
|
+
- Bundles that already carry a debug id (Turbopack, Rolldown, Sentry's
|
|
115
|
+
plugins) keep it. Index source maps (`sections`) are supported.
|
|
116
|
+
- Uploads never follow a redirect.
|
|
117
|
+
- `starko sourcemaps inject <dir>` and `starko sourcemaps upload <dir>` for
|
|
118
|
+
other build tools and CI.
|
|
119
|
+
|
|
120
|
+
### Package
|
|
121
|
+
|
|
122
|
+
- ESM and CommonJS builds of every entry, each with its own type
|
|
123
|
+
declarations (`.d.ts` and `.d.cts`), so TypeScript resolves types under
|
|
124
|
+
`node16` / `nodenext` for both `import` and `require`.
|
package/LICENSE
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
Copyright (c) 2026 Starko. All rights reserved.
|
|
2
|
+
|
|
3
|
+
This software is proprietary to Starko. It is not open source.
|
|
4
|
+
|
|
5
|
+
It may be installed and used only by Starko customers, in their own
|
|
6
|
+
applications, to send data to the Starko service, and only under an
|
|
7
|
+
agreement with Starko that covers such use. No other use, copying,
|
|
8
|
+
modification, redistribution or sublicensing is permitted without Starko's
|
|
9
|
+
prior written permission. Making this package available does not by itself
|
|
10
|
+
grant any licence.
|
|
11
|
+
|
|
12
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
13
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
14
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
|
15
|
+
|
|
16
|
+
Some files adapt code from third-party open-source projects. Those portions
|
|
17
|
+
remain under their original licences; see NOTICE.
|
package/NOTICE
ADDED
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
@starko-one/sdk
|
|
2
|
+
Copyright (c) 2026 Starko
|
|
3
|
+
|
|
4
|
+
This package is proprietary (see LICENSE). It is original work, structured
|
|
5
|
+
after two open-source SDKs. Where a source file adapts code from one of
|
|
6
|
+
them, that file carries the original copyright notice in its header and is
|
|
7
|
+
listed below; those portions are used under the MIT License, whose text is
|
|
8
|
+
at the end of this file and must stay in every copy of the package. Keep
|
|
9
|
+
the list current: add a line whenever a file is adapted, remove it when the
|
|
10
|
+
adaptation is gone.
|
|
11
|
+
|
|
12
|
+
Upstream projects and licences
|
|
13
|
+
|
|
14
|
+
sentry-javascript MIT Copyright (c) 2012 Functional Software, Inc. dba Sentry
|
|
15
|
+
sentry-javascript-bundler-plugins MIT Copyright (c) 2022 Functional Software, Inc. dba Sentry
|
|
16
|
+
posthog-js (packages/core, packages/node) MIT Copyright (c) 2020 PostHog Inc.
|
|
17
|
+
posthog-js (packages/plugin-utils, rollup-plugin, webpack-plugin) MIT Copyright (c) 2020-2025 PostHog, Inc.
|
|
18
|
+
posthog (cli/, rust/cymbal) MIT Copyright (c) 2020-2026 PostHog Inc.
|
|
19
|
+
|
|
20
|
+
Nothing is taken from posthog-js packages/browser (Apache-2.0) or from the
|
|
21
|
+
posthog repository's ee/ directory.
|
|
22
|
+
|
|
23
|
+
Adapted files
|
|
24
|
+
|
|
25
|
+
src/build/shared/snippet.ts posthog-js packages/plugin-utils/src/chunk-ids.ts (runtime snippet)
|
|
26
|
+
src/build/shared/debug-id.ts posthog-js packages/plugin-utils/src/chunk-ids.ts (UUIDv5 id, comment detection)
|
|
27
|
+
src/build/shared/prologue.ts posthog-js packages/rollup-plugin/src/index.ts, packages/webpack-plugin/src/index.ts (directive prologue)
|
|
28
|
+
src/core/exceptions.ts sentry-javascript (ErrorEvent message pattern, wording for non-Error values); posthog-js packages/core (coercer order)
|
|
29
|
+
src/core/stack-parsers.ts sentry-javascript packages/browser/src/stack-parsers.ts (Firefox eval/Function frame pattern)
|
|
30
|
+
src/core/normalize.ts sentry-javascript packages/core/src/utils/normalize.ts (normalize / normalizeToSize: depth-limited walk, markers, byte budget)
|
|
31
|
+
src/core/debug-ids.ts posthog-js packages/core/src/error-tracking/chunk-ids.ts, itself from sentry-javascript (debug-id map algorithm)
|
|
32
|
+
src/node/integrations/process.ts posthog-js packages/node/src/extensions/error-tracking/autocapture.ts (--unhandled-rejections mode lookup);
|
|
33
|
+
sentry-javascript packages/node/src/integrations/onuncaughtexception.ts, packages/node/src/utils/errorhandling.ts (fatal path: counting the app's listeners, print, bounded flush, exit 1, a second error while exiting)
|
|
34
|
+
src/node/integrations/uncaught-exception.ts sentry-javascript packages/node/src/integrations/onuncaughtexception.ts (exit only without app listeners, an error while shutting down)
|
|
35
|
+
src/node/express.ts sentry-javascript @sentry/node Express error handler (status fields read, 5xx-only default, shouldHandleError, next(err))
|
|
36
|
+
src/react/index.ts sentry-javascript packages/react/src/errorboundary.tsx, packages/react/src/error.ts (error boundary API, reactErrorHandler)
|
|
37
|
+
src/node/integrations/unhandled-rejection.ts posthog-js packages/node/src/extensions/error-tracking/autocapture.ts (listening only next to the app's listeners in throw mode)
|
|
38
|
+
|
|
39
|
+
The MIT License (applies to the adapted portions above, under the upstream
|
|
40
|
+
copyright notices listed in "Upstream projects and licences")
|
|
41
|
+
|
|
42
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
43
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
44
|
+
in the Software without restriction, including without limitation the rights
|
|
45
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
46
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
47
|
+
furnished to do so, subject to the following conditions:
|
|
48
|
+
|
|
49
|
+
The above copyright notice and this permission notice shall be included in all
|
|
50
|
+
copies or substantial portions of the Software.
|
|
51
|
+
|
|
52
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
53
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
54
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
55
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
56
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
57
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
58
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,82 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @starko-one/sdk
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Error tracking for browsers, Node.js, Next.js and React that reports to
|
|
4
|
+
[Starko](https://v2.starko.one). Each error arrives linked to the session it
|
|
5
|
+
happened in (and its recording, when the Starko widget records), to the
|
|
6
|
+
customer who hit it once you identify them, and, when you choose, to a bug
|
|
7
|
+
ticket.
|
|
8
|
+
|
|
9
|
+
Status: **beta** (`0.1.0-beta.0`). The public API may still change before 1.0;
|
|
10
|
+
breaking changes are listed in [CHANGELOG.md](./CHANGELOG.md).
|
|
11
|
+
|
|
12
|
+
## Quick start (browser app with a bundler)
|
|
13
|
+
|
|
14
|
+
```sh
|
|
15
|
+
npm install @starko-one/sdk
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
Call `init` once, as early as possible in your app's entry file:
|
|
19
|
+
|
|
20
|
+
```ts
|
|
21
|
+
import * as Starko from "@starko-one/sdk/browser";
|
|
22
|
+
|
|
23
|
+
Starko.init({
|
|
24
|
+
workspaceKey: "<STARKO_WORKSPACE_KEY>",
|
|
25
|
+
release: "shop@4.12.0",
|
|
26
|
+
environment: "production",
|
|
27
|
+
});
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
The workspace key is public: it lets a page send errors and nothing else.
|
|
31
|
+
Uncaught errors and unhandled promise rejections are now reported. To see what
|
|
32
|
+
the SDK is doing, add `debug: true` and open the browser console.
|
|
33
|
+
|
|
34
|
+
Minified stack traces need source maps uploaded at build time: see
|
|
35
|
+
[source maps](./docs/source-maps.md). Nothing arrives? See
|
|
36
|
+
[troubleshooting](./docs/troubleshooting.md).
|
|
37
|
+
|
|
38
|
+
## Entry points
|
|
39
|
+
|
|
40
|
+
| Import | For |
|
|
41
|
+
| --- | --- |
|
|
42
|
+
| `@starko-one/sdk/browser` | Browsers (any framework, or none). Also shipped as a script-tag bundle, `dist/starko.min.js` (19.04 kB gzipped). |
|
|
43
|
+
| `@starko-one/sdk/react` | `StarkoErrorBoundary`, `withErrorBoundary`, `reactErrorHandler` (React 18 and 19). A client module, so a Next.js Server Component can render the boundary. Use with `/browser` or `/next/client`. |
|
|
44
|
+
| `@starko-one/sdk/next` | Next.js server side: `register` and `onRequestError` for `instrumentation.ts`. |
|
|
45
|
+
| `@starko-one/sdk/next/client` | Next.js browser side, for `instrumentation-client.ts` and `global-error.tsx`. |
|
|
46
|
+
| `@starko-one/sdk/next/config` | `withStarko(nextConfig)`: source maps for Next.js builds. |
|
|
47
|
+
| `@starko-one/sdk/node` | Node.js 18 and later: servers, workers, scripts, serverless functions. |
|
|
48
|
+
| `@starko-one/sdk/vite`, `/rollup`, `/webpack` | Build plugins that upload source maps. |
|
|
49
|
+
| `@starko-one/sdk` | The environment-free core, for building your own integration or transport. Apps import a platform entry instead. |
|
|
50
|
+
| `starko` (command) | `starko sourcemaps inject` and `starko sourcemaps upload` for other build tools and CI. |
|
|
51
|
+
|
|
52
|
+
## Guides
|
|
53
|
+
|
|
54
|
+
- [Browser](./docs/browser.md): npm or script tag, identifying users, manual capture, filtering, offline behaviour.
|
|
55
|
+
- [React](./docs/react.md): the error boundary and React 19 root error hooks.
|
|
56
|
+
- [Next.js](./docs/nextjs.md): the three files a Next app needs, releases, Vercel and long-lived servers.
|
|
57
|
+
- [Node.js](./docs/node.md): per-request isolation, Express, serverless, crashes and shutdown.
|
|
58
|
+
- [Source maps](./docs/source-maps.md): Vite, Rollup, webpack, Next.js and the CLI.
|
|
59
|
+
- [Configuration reference](./docs/configuration.md): every option with its default, every integration.
|
|
60
|
+
- [Privacy](./docs/privacy.md): what is collected, what is not, and how to collect less.
|
|
61
|
+
- [Using it with the Starko widget](./docs/widget.md).
|
|
62
|
+
- [Other backends](./docs/other-backends.md): the HTTP API, and PostHog server SDKs pointed at Starko.
|
|
63
|
+
- [Troubleshooting](./docs/troubleshooting.md).
|
|
64
|
+
|
|
65
|
+
## What is collected by default
|
|
66
|
+
|
|
67
|
+
- The error: type, message, stack frames, and the chain of `cause`s.
|
|
68
|
+
- The page URL and referrer (browser) or the request's method, URL and route (server), with `#fragments`, `user:pass@` and the values of sensitive query parameters (`token`, `code`, `email`, `password`, …) removed.
|
|
69
|
+
- Breadcrumbs: clicks (as a short CSS selector, never text or input values), navigation, `fetch`/XHR method, URL and status, and `console.warn`/`console.error` text cut to 200 characters (servers: console only).
|
|
70
|
+
- The user only if you set one, and the Starko session id. Never request or response bodies, cookies or headers.
|
|
71
|
+
- On servers: host name, Node and OS versions, and source lines from your own source files.
|
|
72
|
+
|
|
73
|
+
Details and every switch to collect less: [privacy](./docs/privacy.md).
|
|
74
|
+
|
|
75
|
+
## Licence and attribution
|
|
76
|
+
|
|
77
|
+
Proprietary, not open source: see [LICENSE](./LICENSE). Starko customers may
|
|
78
|
+
use it in their own applications under their agreement with Starko. The SDK
|
|
79
|
+
is original work structured after two MIT-licensed open-source SDKs, Sentry's
|
|
80
|
+
JavaScript SDK and PostHog's JavaScript SDK; the files that adapt code from
|
|
81
|
+
them keep the upstream copyright notice, are listed in [NOTICE](./NOTICE)
|
|
82
|
+
and stay under the MIT License, whose text is in that file.
|