@arvoretech/bug-jar 0.6.0 → 0.7.0

package/README.md

@@ -34,7 +34,7 @@ opens it in the real app, and the encrypted package is uploaded to S3. See
 <script src="https://unpkg.com/@arvoretech/bug-jar"></script>
 <script>
   BugJar.init({
-    debugSessionEndpoint: 'https://api.arvore.com.br/debug-sessions',
+    debugSessionEndpoint: 'https://livros.arvore.com.br/debug-sessions',
   })
 </script>
 ```
@@ -67,7 +67,7 @@ init({
   onCapture: (report) => console.log(report),
 
   // Debug session
-  debugSessionEndpoint: 'https://api.arvore.com.br/debug-sessions',
+  debugSessionEndpoint: 'https://livros.arvore.com.br/debug-sessions',
   // debugToken is read automatically from the ?debug=<token> query param
 })
 ```
@@ -101,7 +101,7 @@ private S3 bucket via a presigned URL. No AWS credentials ever reach the browser
 <script src="https://unpkg.com/@arvoretech/bug-jar"></script>
 <script>
   BugJar.init({
-    debugSessionEndpoint: 'https://api.arvore.com.br/debug-sessions',
+    debugSessionEndpoint: 'https://livros.arvore.com.br/debug-sessions',
     // debugToken is read automatically from the ?debug=<token> query param
   })
 </script>
@@ -124,7 +124,7 @@ Flow:
    to `debug/<token>/<pageId>/meta.json` (`POST /debug-sessions/:token/meta`).
 4. Staff reconstructs the session offline:
    ```bash
-   BUG_JAR_API=https://api.arvore.com.br/debug-sessions \
+   BUG_JAR_API=https://livros.arvore.com.br/debug-sessions \
    BUG_JAR_API_TOKEN=<admin-jwt> \
    node scripts/decrypt-session.cjs <token> ./out
    ```
@@ -133,6 +133,21 @@ Flow:
    per-page stream, and writes `<pageId>/data.jsonl`, `<pageId>/video.webm`,
    `<pageId>/meta.json`.
 
+## Speed test
+
+At the start of each page, Bug Jar runs a fast.com-style network speed test
+against the Árvore backend and stores the result in that page's `meta.json`:
+
+- **latency** — minimum and jitter from repeated `GET /speedtest/ping`
+- **download (Mbps)** — 8 MB pulled across 4 parallel streams
+  (`GET /speedtest/download?bytes=N`)
+- **upload (Mbps)** — 4 MB sent to `POST /speedtest/upload` (server discards it)
+
+It measures the real end-to-end throughput between the user and our
+infrastructure (which is exactly what we want when debugging "the app is slow").
+The test runs once per page and is best-effort — failures leave the fields null
+without blocking the session.
+
 ## Encryption
 
 Each stream (data and video, per page) is encrypted with libsodium

package/dist/index.d.mts

@@ -17,6 +17,7 @@ interface BugJarConfig {
     onCapture?: (report: BugReport) => void;
     debugToken?: string;
     debugSessionEndpoint?: string;
+    ignoreUrls?: string[];
 }
 interface NetworkEntry {
     id: string;
@@ -157,6 +158,7 @@ declare class BugJar {
     private videoUploader;
     private pageId;
     private dataInterval;
+    private lastFlushTs;
     private finalized;
     private started;
     constructor(config?: Partial<BugJarConfig>);
@@ -171,6 +173,7 @@ declare class BugJar {
     private startDataStreaming;
     private registerFlushHandlers;
     private finalizePage;
+    private runSpeedtest;
     endDebugSession(): void;
 }
 declare function init(config?: Partial<BugJarConfig>): BugJar;

package/dist/index.d.ts

@@ -17,6 +17,7 @@ interface BugJarConfig {
     onCapture?: (report: BugReport) => void;
     debugToken?: string;
     debugSessionEndpoint?: string;
+    ignoreUrls?: string[];
 }
 interface NetworkEntry {
     id: string;
@@ -157,6 +158,7 @@ declare class BugJar {
     private videoUploader;
     private pageId;
     private dataInterval;
+    private lastFlushTs;
     private finalized;
     private started;
     constructor(config?: Partial<BugJarConfig>);
@@ -171,6 +173,7 @@ declare class BugJar {
     private startDataStreaming;
     private registerFlushHandlers;
     private finalizePage;
+    private runSpeedtest;
     endDebugSession(): void;
 }
 declare function init(config?: Partial<BugJarConfig>): BugJar;