@usereelay/browser 0.1.0 → 0.1.1

package/README.md

@@ -28,8 +28,6 @@ import * as Reelay from '@usereelay/browser';
 Reelay.init({
   endpoint: 'https://api.usereelay.com', // your Reelay ingest base URL
   token: 'rlyt_live_…',                  // node API key for this frontend
-  release: 'web@' + import.meta.env.VITE_GIT_SHA,
-  environment: 'production',
   // Origins that receive trace headers so backend errors link to this session:
   tracePropagationTargets: ['https://api.acme.com'],
 });
@@ -65,9 +63,7 @@ also works without a bundler:
 Reelay.init({
   endpoint: 'https://api.usereelay.com', // required: ingest base URL
   token: 'rlyt_live_…',                  // required: node API key
-  release: 'web@abc123',                 // optional: ties events to a deploy
-  environment: 'production',             // optional
-  sampleRate: 1,                         // 0–1 probability an event is sent
+  sampleRate: 1,                         // optional: fraction of errors to send (default 1 = all)
   beforeSend: (event) => event,          // mutate or return null to drop
   scrubPatterns: [/order-\d{6}/g],       // extra PII regexes (additive)
   maxQueueSize: 30,                      // offline/retry buffer (drop-oldest)
@@ -110,29 +106,25 @@ bundled `reelay-sourcemaps` CLI.
 #    maps are emitted but not referenced from shipped JS).
 npm run build
 
-# 2. Inject debug ids into the built JS + maps (the robust, release-independent
-#    match key), then upload the maps to Reelay.
+# 2. Inject debug ids into the built JS + maps (the match key), then upload the
+#    maps to Reelay.
 npx reelay-sourcemaps inject-and-upload ./dist \
   --url https://api.reelay.app \
   --token "$REELAY_TOKEN" \
-  --release "web@$(git rev-parse --short HEAD)" \
   --delete   # remove .map files after upload so they never reach your CDN
 ```
 
-`--url`, `--token`, and `--release` also read from `REELAY_URL`, `REELAY_TOKEN`,
-and `REELAY_RELEASE`. Set the **same `release`** in `Reelay.init({ release })`
-so release-based matching works even for bundles without debug ids.
+`--url` and `--token` also read from `REELAY_URL` and `REELAY_TOKEN`.
 
 How it works:
 
-- **Debug ids (preferred).** `inject` stamps each chunk with a content-derived
-  id, recorded both in the JS (a tiny runtime snippet) and in the map. The SDK
-  reads that registry at capture time and tags each frame with its bundle's
-  debug id, so the backend resolves the exact map regardless of release naming
-  or CDN hashing. The injector offsets the map's `mappings` for the one line it
-  adds, so positions stay exact.
-- **Release + filename (fallback).** When a frame has no debug id, the backend
-  matches on the event's `release` and the minified file's basename.
+- **Debug ids (the only match key).** `inject` stamps each chunk with a
+  content-derived id, recorded both in the JS (a tiny runtime snippet) and in
+  the map. The SDK reads that registry at capture time and tags each frame with
+  its bundle's debug id, so the backend resolves the exact map regardless of
+  CDN hashing. The injector offsets the map's `mappings` for the one line it
+  adds, so positions stay exact. Always run `inject` before `upload` — maps
+  without a debug id cannot be matched and are skipped at upload.
 - Already using a Sentry bundler plugin? The SDK also reads `_sentryDebugIds`,
   so existing debug ids are picked up with no extra tooling.
 

package/bin/reelay-sourcemaps.mjs

@@ -7,16 +7,16 @@
  *   reelay-sourcemaps upload <dir> [opts]       Upload maps to Reelay
  *   reelay-sourcemaps inject-and-upload <dir>   Both, in order
  *
- * Options (or env: REELAY_URL, REELAY_TOKEN, REELAY_RELEASE):
+ * Options (or env: REELAY_URL, REELAY_TOKEN):
  *   --url <endpoint>     Reelay ingestion base URL          [REELAY_URL]
  *   --token <token>      Node API key (rlyt_live_…)          [REELAY_TOKEN]
- *   --release <release>  Release tag matching your SDK init  [REELAY_RELEASE]
  *   --delete             Delete .map files after a successful upload
  *
- * Debug ids are the primary, unambiguous match key: each bundle is stamped with
- * a content-derived id recorded both in the JS (a tiny runtime snippet the SDK
- * reads) and in the map. `upload` also sends release+filename as a fallback, so
- * symbolication works even for bundlers that emit no debug ids.
+ * Debug ids are the sole match key: each bundle is stamped with a
+ * content-derived id recorded both in the JS (a tiny runtime snippet the SDK
+ * reads) and in the map. Run `inject` (or `inject-and-upload`) so every map
+ * carries a debug id before upload — maps without one cannot be matched and are
+ * skipped.
  *
  * Source maps expose original source — keep them private. Prefer `hidden-source-map`
  * (no sourceMappingURL comment in shipped JS) and pass --delete so maps never
@@ -170,17 +170,16 @@ async function uploadMap(opts, mapFile) {
   }
   const debugId = map.debugId || map.debug_id || '';
   // Minified file the map belongs to: prefer the map's own `file`, else strip
-  // the .map suffix. Sent as the release+filename fallback key.
+  // the .map suffix. Retained for display/diagnostics on the artifact.
   const file = basename(map.file || mapFile.replace(/\.map$/, ''));
 
-  if (!debugId && !opts.release) {
-    warn(`skipping ${basename(mapFile)}: no debug id and no --release to key on`);
+  if (!debugId) {
+    warn(`skipping ${basename(mapFile)}: no debug id (run 'inject' first)`);
     return false;
   }
 
   const body = JSON.stringify({
-    release: opts.release || undefined,
-    debug_id: debugId || undefined,
+    debug_id: debugId,
     file,
     sourcemap: readFileSync(mapFile, 'utf8'),
   });
@@ -220,7 +219,6 @@ function parseArgs(argv) {
   const opts = {
     url: process.env.REELAY_URL || process.env.REELAY_ENDPOINT || '',
     token: process.env.REELAY_TOKEN || '',
-    release: process.env.REELAY_RELEASE || '',
     delete: false,
     _: [],
   };
@@ -229,7 +227,6 @@ function parseArgs(argv) {
     switch (a) {
       case '--url': opts.url = argv[++i]; break;
       case '--token': opts.token = argv[++i]; break;
-      case '--release': opts.release = argv[++i]; break;
       case '--delete': opts.delete = true; break;
       default: opts._.push(a);
     }
@@ -246,8 +243,8 @@ async function main() {
     process.stdout.write(
       'Usage:\n' +
         '  reelay-sourcemaps inject <dir>\n' +
-        '  reelay-sourcemaps upload <dir> --url <u> --token <t> [--release <r>] [--delete]\n' +
-        '  reelay-sourcemaps inject-and-upload <dir> --url <u> --token <t> [--release <r>] [--delete]\n',
+        '  reelay-sourcemaps upload <dir> --url <u> --token <t> [--delete]\n' +
+        '  reelay-sourcemaps inject-and-upload <dir> --url <u> --token <t> [--delete]\n',
     );
     return;
   }

package/dist/index.cjs

@@ -360,8 +360,6 @@ var BaseClient = class {
         kind: this.kind,
         platform: this.platform,
         timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-        release: this.options.release,
-        environment: this.options.environment,
         trace: ctx.trace,
         session_id: ctx.sessionId,
         exception: {

package/dist/index.d.cts

@@ -61,8 +61,6 @@ interface ErrorEventPayload {
     kind: 'backend' | 'frontend';
     platform: string;
     timestamp: string;
-    release?: string;
-    environment?: string;
     trace?: TraceContext;
     session_id?: string;
     exception: ExceptionPayload;
@@ -76,9 +74,11 @@ interface CoreOptions {
     endpoint: string;
     /** The node's API key (rlyt_live_…). Never a ReelayID. */
     token: string;
-    release?: string;
-    environment?: string;
-    /** 0–1 probability an error event is sent. Defaults to 1. */
+    /**
+     * Fraction of error events to send, 0–1. Defaults to 1 (every error is
+     * sent). A cost/volume lever for very high-throughput apps; leave at 1
+     * unless you have a volume problem.
+     */
     sampleRate?: number;
     /** Mutate or veto an event just before send. Return null to drop. */
     beforeSend?: (event: ErrorEventPayload) => ErrorEventPayload | null;

package/dist/index.d.ts

@@ -61,8 +61,6 @@ interface ErrorEventPayload {
     kind: 'backend' | 'frontend';
     platform: string;
     timestamp: string;
-    release?: string;
-    environment?: string;
     trace?: TraceContext;
     session_id?: string;
     exception: ExceptionPayload;
@@ -76,9 +74,11 @@ interface CoreOptions {
     endpoint: string;
     /** The node's API key (rlyt_live_…). Never a ReelayID. */
     token: string;
-    release?: string;
-    environment?: string;
-    /** 0–1 probability an error event is sent. Defaults to 1. */
+    /**
+     * Fraction of error events to send, 0–1. Defaults to 1 (every error is
+     * sent). A cost/volume lever for very high-throughput apps; leave at 1
+     * unless you have a volume problem.
+     */
     sampleRate?: number;
     /** Mutate or veto an event just before send. Return null to drop. */
     beforeSend?: (event: ErrorEventPayload) => ErrorEventPayload | null;

package/dist/index.js

@@ -358,8 +358,6 @@ var BaseClient = class {
         kind: this.kind,
         platform: this.platform,
         timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-        release: this.options.release,
-        environment: this.options.environment,
         trace: ctx.trace,
         session_id: ctx.sessionId,
         exception: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usereelay/browser",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Reelay SDK for browsers: error capture, breadcrumbs, fetch trace stitching, masked DOM session replay.",
   "license": "MIT",
   "publishConfig": {