@mayurpise/wirespeed 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mayurpise
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,81 @@
+# wirespeed
+
+Fast, zero-dependency internet speed test for the terminal. Measures download, upload, and latency using Cloudflare's global edge network.
+
+```
+$ npx wirespeed
+
+  wirespeed v1.0.0
+
+  Server    Cloudflare — Mumbai (BOM)
+  IP        203.0.113.42
+
+  Latency   12.34 ms (jitter: 1.23 ms)
+  Download  245.67 Mbps
+  Upload    98.12 Mbps
+```
+
+## Install
+
+```bash
+npm install -g @mayurpise/wirespeed
+```
+
+Or run directly:
+
+```bash
+npx @mayurpise/wirespeed
+```
+
+## Usage
+
+```bash
+wirespeed                 # Run full speed test
+wirespeed --json          # Output results as JSON
+wirespeed --no-upload     # Skip upload test
+wirespeed --no-download   # Skip download test
+```
+
+### Options
+
+| Flag             | Description          |
+| ---------------- | -------------------- |
+| `--json`         | Output results as JSON |
+| `--no-download`  | Skip download test   |
+| `--no-upload`    | Skip upload test     |
+| `-h`, `--help`   | Show help            |
+| `-v`, `--version`| Show version         |
+
+### JSON output
+
+```bash
+wirespeed --json | jq .
+```
+
+```json
+{
+  "server": { "colo": "BOM", "city": "Mumbai", "ip": "203.0.113.42" },
+  "latency": { "median": 12.34, "jitter": 1.23, "unit": "ms" },
+  "download": { "speed": 245.67, "unit": "Mbps" },
+  "upload": { "speed": 98.12, "unit": "Mbps" }
+}
+```
+
+## How it works
+
+wirespeed uses Cloudflare's speed test infrastructure (`speed.cloudflare.com`):
+
+1. **Server detection** — Identifies the nearest Cloudflare edge via `/cdn-cgi/trace`
+2. **Latency** — 20 zero-byte round trips, reports median and jitter
+3. **Download** — Multi-phase parallel requests with increasing payload sizes (100KB to 100MB)
+4. **Upload** — Multi-phase parallel uploads (100KB to 10MB)
+
+Bandwidth is calculated at the 90th percentile across all measurements for accuracy. Real-time speed is smoothed with an exponential moving average.
+
+## Requirements
+
+- Node.js >= 18.0.0
+
+## License
+
+MIT

package/bin/wirespeed.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/src/index.js';

package/dist/src/config.d.ts

@@ -0,0 +1,19 @@
+export declare const CF_DOWN_URL = "https://speed.cloudflare.com/__down";
+export declare const CF_UP_URL = "https://speed.cloudflare.com/__up";
+export declare const CF_TRACE_URL = "https://speed.cloudflare.com/cdn-cgi/trace";
+export declare const CF_LOCATIONS_URL = "https://speed.cloudflare.com/locations";
+export declare const LATENCY_REQUESTS = 20;
+export declare const BANDWIDTH_PERCENTILE = 0.9;
+export declare const LATENCY_PERCENTILE = 0.5;
+export declare const MIN_REQUEST_DURATION_MS = 10;
+export declare const FINISH_REQUEST_DURATION_MS = 1000;
+export declare const ESTIMATED_SERVER_TIME_MS = 10;
+export declare const RENDER_INTERVAL_MS = 80;
+export declare const EMA_ALPHA = 0.3;
+export interface PhaseConfig {
+    bytes: number;
+    count: number;
+    parallel: number;
+}
+export declare const DOWNLOAD_PHASES: PhaseConfig[];
+export declare const UPLOAD_PHASES: PhaseConfig[];

package/dist/src/config.js

@@ -0,0 +1,25 @@
+export const CF_DOWN_URL = 'https://speed.cloudflare.com/__down';
+export const CF_UP_URL = 'https://speed.cloudflare.com/__up';
+export const CF_TRACE_URL = 'https://speed.cloudflare.com/cdn-cgi/trace';
+export const CF_LOCATIONS_URL = 'https://speed.cloudflare.com/locations';
+export const LATENCY_REQUESTS = 20;
+export const BANDWIDTH_PERCENTILE = 0.9;
+export const LATENCY_PERCENTILE = 0.5;
+export const MIN_REQUEST_DURATION_MS = 10;
+export const FINISH_REQUEST_DURATION_MS = 1000;
+export const ESTIMATED_SERVER_TIME_MS = 10;
+export const RENDER_INTERVAL_MS = 80;
+export const EMA_ALPHA = 0.3;
+export const DOWNLOAD_PHASES = [
+    { bytes: 100_000, count: 2, parallel: 1 },
+    { bytes: 1_000_000, count: 4, parallel: 4 },
+    { bytes: 10_000_000, count: 3, parallel: 6 },
+    { bytes: 25_000_000, count: 2, parallel: 6 },
+    { bytes: 100_000_000, count: 1, parallel: 4 },
+];
+export const UPLOAD_PHASES = [
+    { bytes: 100_000, count: 2, parallel: 1 },
+    { bytes: 1_000_000, count: 4, parallel: 3 },
+    { bytes: 10_000_000, count: 2, parallel: 3 },
+];
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,qCAAqC,CAAC;AACjE,MAAM,CAAC,MAAM,SAAS,GAAG,mCAAmC,CAAC;AAC7D,MAAM,CAAC,MAAM,YAAY,GAAG,4CAA4C,CAAC;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,wCAAwC,CAAC;AAEzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACxC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AACtC,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAC/C,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAQ7B,MAAM,CAAC,MAAM,eAAe,GAAkB;IAC5C,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IACzC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC3C,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC5C,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC5C,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;CAC9C,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IACzC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC3C,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;CAC7C,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/index.js

@@ -0,0 +1,71 @@
+import { parseArgs } from 'node:util';
+import { Renderer } from './ui/renderer.js';
+import { composePlainResult, composeJson } from './ui/layout.js';
+import { runSpeedTest } from './orchestrator.js';
+const { values } = parseArgs({
+    options: {
+        json: { type: 'boolean', default: false },
+        'no-upload': { type: 'boolean', default: false },
+        'no-download': { type: 'boolean', default: false },
+        help: { type: 'boolean', short: 'h', default: false },
+        version: { type: 'boolean', short: 'v', default: false },
+    },
+    strict: true,
+});
+if (values.help) {
+    console.log(`
+  wirespeed - Terminal internet speed test
+
+  Usage: wirespeed [options]
+
+  Options:
+    --json           Output results as JSON
+    --no-download    Skip download test
+    --no-upload      Skip upload test
+    -h, --help       Show this help
+    -v, --version    Show version
+  `);
+    process.exit(0);
+}
+if (values.version) {
+    console.log('wirespeed v1.0.0');
+    process.exit(0);
+}
+const isInteractive = process.stdout.isTTY && !values.json;
+const renderer = new Renderer();
+if (isInteractive) {
+    renderer.start();
+}
+try {
+    const results = await runSpeedTest(renderer, {
+        noDownload: values['no-download'] ?? false,
+        noUpload: values['no-upload'] ?? false,
+    });
+    if (isInteractive) {
+        renderer.stop();
+    }
+    else {
+        const finalState = {
+            phase: 'done',
+            progress: 1,
+            currentSpeed: 0,
+            server: results.server,
+            latency: results.latency,
+            download: results.download ?? undefined,
+            upload: results.upload ?? undefined,
+        };
+        if (values.json) {
+            console.log(composeJson(finalState));
+        }
+        else {
+            console.log(composePlainResult(finalState));
+        }
+    }
+}
+catch (err) {
+    if (isInteractive)
+        renderer.stop();
+    console.error('Speed test failed:', err instanceof Error ? err.message : err);
+    process.exit(1);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE;QACP,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;QACzC,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;QAChD,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;QAClD,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;QACrD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;KACzD;IACD,MAAM,EAAE,IAAI;CACb,CAAC,CAAC;AAEH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;GAWX,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;IACnB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;AAE3D,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;AAEhC,IAAI,aAAa,EAAE,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,IAAI,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE;QAC3C,UAAU,EAAE,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK;QAC1C,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,KAAK;KACvC,CAAC,CAAC;IAEH,IAAI,aAAa,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,EAAE,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,GAAe;YAC7B,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,CAAC;YACX,YAAY,EAAE,CAAC;YACf,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,SAAS;YACvC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,SAAS;SACpC,CAAC;QAEF,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;AACH,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,IAAI,aAAa;QAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/src/meta.d.ts

@@ -0,0 +1,2 @@
+import type { ServerMeta } from './tester/types.js';
+export declare function fetchServerMeta(): Promise<ServerMeta>;

package/dist/src/meta.js

@@ -0,0 +1,69 @@
+import { CF_TRACE_URL, CF_LOCATIONS_URL } from './config.js';
+// Fallback map for common Cloudflare datacenters when the locations API is unavailable
+const COLO_CITIES = {
+    ATL: 'Atlanta', IAD: 'Ashburn', BOS: 'Boston', ORD: 'Chicago', DFW: 'Dallas',
+    DEN: 'Denver', DTW: 'Detroit', HNL: 'Honolulu', IAH: 'Houston', JAX: 'Jacksonville',
+    MCI: 'Kansas City', LAS: 'Las Vegas', LAX: 'Los Angeles', MIA: 'Miami',
+    MSP: 'Minneapolis', BNA: 'Nashville', EWR: 'Newark', JFK: 'New York',
+    PHL: 'Philadelphia', PHX: 'Phoenix', PDX: 'Portland', RIC: 'Richmond',
+    SMF: 'Sacramento', SLC: 'Salt Lake City', SAN: 'San Diego', SFO: 'San Francisco',
+    SJC: 'San Jose', SEA: 'Seattle', STL: 'St. Louis', TPA: 'Tampa',
+    AMS: 'Amsterdam', ARN: 'Stockholm', BCN: 'Barcelona', BER: 'Berlin',
+    BRU: 'Brussels', BUD: 'Budapest', CDG: 'Paris', CPH: 'Copenhagen',
+    DUB: 'Dublin', DUS: 'Düsseldorf', FRA: 'Frankfurt', HAM: 'Hamburg',
+    HEL: 'Helsinki', LHR: 'London', LIS: 'Lisbon', MAD: 'Madrid',
+    MAN: 'Manchester', MRS: 'Marseille', MXP: 'Milan', MUC: 'Munich',
+    OSL: 'Oslo', PRG: 'Prague', VIE: 'Vienna', WAW: 'Warsaw', ZRH: 'Zurich',
+    NRT: 'Tokyo', HND: 'Tokyo', KIX: 'Osaka', ICN: 'Seoul', HKG: 'Hong Kong',
+    SIN: 'Singapore', BOM: 'Mumbai', DEL: 'Delhi', MAA: 'Chennai', BLR: 'Bangalore',
+    HYD: 'Hyderabad', SYD: 'Sydney', MEL: 'Melbourne', AKL: 'Auckland',
+    GRU: 'São Paulo', GIG: 'Rio de Janeiro', SCL: 'Santiago', BOG: 'Bogotá',
+    MEX: 'Mexico City', YYZ: 'Toronto', YVR: 'Vancouver', YUL: 'Montreal',
+    JNB: 'Johannesburg', CPT: 'Cape Town', CAI: 'Cairo', DXB: 'Dubai',
+    DOH: 'Doha', RUH: 'Riyadh', TPE: 'Taipei', KUL: 'Kuala Lumpur',
+    BKK: 'Bangkok', CGK: 'Jakarta', MNL: 'Manila', PEK: 'Beijing', PVG: 'Shanghai',
+    CAN: 'Guangzhou',
+};
+export async function fetchServerMeta() {
+    const defaults = { colo: '???', city: 'Unknown', ip: '', loc: '' };
+    try {
+        const traceRes = await fetch(CF_TRACE_URL, { headers: { 'User-Agent': 'wirespeed/1.0.0' } });
+        if (!traceRes.ok)
+            return defaults;
+        const traceText = await traceRes.text();
+        const traceMap = new Map();
+        for (const line of traceText.split('\n')) {
+            const eq = line.indexOf('=');
+            if (eq > 0) {
+                traceMap.set(line.slice(0, eq), line.slice(eq + 1));
+            }
+        }
+        const colo = traceMap.get('colo') ?? defaults.colo;
+        const ip = traceMap.get('ip') ?? defaults.ip;
+        const loc = traceMap.get('loc') ?? defaults.loc;
+        // Try locations API first, fall back to built-in map
+        let city = COLO_CITIES[colo] ?? colo;
+        try {
+            const locationsRes = await fetch(CF_LOCATIONS_URL, {
+                headers: { 'User-Agent': 'wirespeed/1.0.0' },
+                signal: AbortSignal.timeout(3000),
+            });
+            if (locationsRes.ok) {
+                const data = await locationsRes.json();
+                if (Array.isArray(data)) {
+                    const match = data.find(l => l.iata === colo);
+                    if (match)
+                        city = match.city;
+                }
+            }
+        }
+        catch {
+            // Use fallback map
+        }
+        return { colo, city, ip, loc };
+    }
+    catch {
+        return defaults;
+    }
+}
+//# sourceMappingURL=meta.js.map

package/dist/src/meta.js.map

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

package/dist/src/orchestrator.d.ts

@@ -0,0 +1,7 @@
+import { Renderer } from './ui/renderer.js';
+import type { TestResults } from './tester/types.js';
+export interface RunOptions {
+    noDownload: boolean;
+    noUpload: boolean;
+}
+export declare function runSpeedTest(renderer: Renderer, options: RunOptions): Promise<TestResults>;

package/dist/src/orchestrator.js

@@ -0,0 +1,38 @@
+import { fetchServerMeta } from './meta.js';
+import { measureLatency } from './tester/latency.js';
+import { measureDownload } from './tester/download.js';
+import { measureUpload } from './tester/upload.js';
+export async function runSpeedTest(renderer, options) {
+    // Phase: init
+    renderer.update({ phase: 'init', progress: 0, currentSpeed: 0 });
+    const server = await fetchServerMeta();
+    renderer.update({ server });
+    // Phase: latency
+    renderer.update({ phase: 'latency', progress: 0, currentSpeed: 0 });
+    const latency = await measureLatency((_i, _ms) => {
+        // Could update live latency display here if desired
+    });
+    renderer.update({ latency });
+    // Phase: download
+    let download = null;
+    if (!options.noDownload) {
+        renderer.update({ phase: 'download', progress: 0, currentSpeed: 0 });
+        download = await measureDownload((progress, currentSpeed) => {
+            renderer.update({ progress, currentSpeed });
+        });
+        renderer.update({ download, progress: 1 });
+    }
+    // Phase: upload
+    let upload = null;
+    if (!options.noUpload) {
+        renderer.update({ phase: 'upload', progress: 0, currentSpeed: 0 });
+        upload = await measureUpload((progress, currentSpeed) => {
+            renderer.update({ progress, currentSpeed });
+        });
+        renderer.update({ upload, progress: 1 });
+    }
+    // Done
+    renderer.update({ phase: 'done' });
+    return { server, latency, download, upload };
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/src/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AASnD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAkB,EAClB,OAAmB;IAEnB,cAAc;IACd,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;IAEjE,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAE5B,iBAAiB;IACjB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE;QAC/C,oDAAoD;IACtD,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAE7B,kBAAkB;IAClB,IAAI,QAAQ,GAA4B,IAAI,CAAC;IAC7C,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;QACrE,QAAQ,GAAG,MAAM,eAAe,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE;YAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,gBAAgB;IAChB,IAAI,MAAM,GAA0B,IAAI,CAAC;IACzC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;QACnE,MAAM,GAAG,MAAM,aAAa,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE;YACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO;IACP,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAEnC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC/C,CAAC"}

package/dist/src/stats/calculator.d.ts

@@ -0,0 +1,6 @@
+import type { Measurement } from '../tester/types.js';
+export declare function percentile(sorted: number[], p: number): number;
+export declare function computeBandwidth(measurements: Measurement[]): number;
+export declare function computeMedianLatency(latencies: number[]): number;
+export declare function computeJitter(latencies: number[]): number;
+export declare function ema(current: number, previous: number): number;

package/dist/src/stats/calculator.js

@@ -0,0 +1,41 @@
+import { MIN_REQUEST_DURATION_MS, BANDWIDTH_PERCENTILE, LATENCY_PERCENTILE, EMA_ALPHA } from '../config.js';
+export function percentile(sorted, p) {
+    if (sorted.length === 0)
+        return 0;
+    if (sorted.length === 1)
+        return sorted[0];
+    const pos = (sorted.length - 1) * p;
+    const base = Math.floor(pos);
+    const rest = pos - base;
+    const next = sorted[base + 1];
+    if (next !== undefined) {
+        return sorted[base] + rest * (next - sorted[base]);
+    }
+    return sorted[base];
+}
+export function computeBandwidth(measurements) {
+    const valid = measurements
+        .filter(m => m.durationMs >= MIN_REQUEST_DURATION_MS)
+        .map(m => m.speedBps)
+        .sort((a, b) => a - b);
+    if (valid.length === 0)
+        return 0;
+    return percentile(valid, BANDWIDTH_PERCENTILE);
+}
+export function computeMedianLatency(latencies) {
+    const sorted = [...latencies].sort((a, b) => a - b);
+    return percentile(sorted, LATENCY_PERCENTILE);
+}
+export function computeJitter(latencies) {
+    if (latencies.length < 2)
+        return 0;
+    let sum = 0;
+    for (let i = 1; i < latencies.length; i++) {
+        sum += Math.abs(latencies[i] - latencies[i - 1]);
+    }
+    return sum / (latencies.length - 1);
+}
+export function ema(current, previous) {
+    return EMA_ALPHA * current + (1 - EMA_ALPHA) * previous;
+}
+//# sourceMappingURL=calculator.js.map

package/dist/src/stats/calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculator.js","sourceRoot":"","sources":["../../../src/stats/calculator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE5G,MAAM,UAAU,UAAU,CAAC,MAAgB,EAAE,CAAS;IACpD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAE,CAAC;IAE3C,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;IAExB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,IAAI,CAAE,GAAG,IAAI,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAE,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,YAA2B;IAC1D,MAAM,KAAK,GAAG,YAAY;SACvB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,uBAAuB,CAAC;SACpD,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;SACpB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAEzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACjC,OAAO,UAAU,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAmB;IACtD,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,OAAO,UAAU,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAmB;IAC/C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACnC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAE,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,QAAgB;IACnD,OAAO,SAAS,GAAG,OAAO,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,QAAQ,CAAC;AAC1D,CAAC"}

package/dist/src/stats/units.d.ts

@@ -0,0 +1,4 @@
+export declare function formatSpeed(bps: number): string;
+export declare function formatLatency(ms: number): string;
+export declare function formatBytes(bytes: number): string;
+export declare function bpsToMbps(bps: number): number;

package/dist/src/stats/units.js

@@ -0,0 +1,25 @@
+export function formatSpeed(bps) {
+    const mbps = bps / 1_000_000;
+    if (mbps >= 1000) {
+        return `${(mbps / 1000).toFixed(2)} Gbps`;
+    }
+    return `${mbps.toFixed(2)} Mbps`;
+}
+export function formatLatency(ms) {
+    if (ms < 1)
+        return `${(ms * 1000).toFixed(0)} µs`;
+    return `${ms.toFixed(1)} ms`;
+}
+export function formatBytes(bytes) {
+    if (bytes >= 1_000_000_000)
+        return `${(bytes / 1_000_000_000).toFixed(1)} GB`;
+    if (bytes >= 1_000_000)
+        return `${(bytes / 1_000_000).toFixed(1)} MB`;
+    if (bytes >= 1_000)
+        return `${(bytes / 1_000).toFixed(1)} KB`;
+    return `${bytes} B`;
+}
+export function bpsToMbps(bps) {
+    return bps / 1_000_000;
+}
+//# sourceMappingURL=units.js.map

package/dist/src/stats/units.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.js","sourceRoot":"","sources":["../../../src/stats/units.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,IAAI,GAAG,GAAG,GAAG,SAAS,CAAC;IAC7B,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACjB,OAAO,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,IAAI,EAAE,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAClD,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,KAAK,IAAI,aAAa;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9E,IAAI,KAAK,IAAI,SAAS;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IACtE,IAAI,KAAK,IAAI,KAAK;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9D,OAAO,GAAG,KAAK,IAAI,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,GAAG,GAAG,SAAS,CAAC;AACzB,CAAC"}

package/dist/src/tester/download.d.ts

@@ -0,0 +1,2 @@
+import type { BandwidthResult } from './types.js';
+export declare function measureDownload(onProgress?: (progress: number, currentSpeedBps: number) => void): Promise<BandwidthResult>;

package/dist/src/tester/download.js

@@ -0,0 +1,59 @@
+import { CF_DOWN_URL, DOWNLOAD_PHASES, FINISH_REQUEST_DURATION_MS } from '../config.js';
+import { timedDownload } from './http-client.js';
+import { computeBandwidth, ema } from '../stats/calculator.js';
+import { bpsToMbps } from '../stats/units.js';
+export async function measureDownload(onProgress) {
+    const allMeasurements = [];
+    let liveSpeed = 0;
+    let totalRequests = 0;
+    let completedRequests = 0;
+    // Count total requests for progress
+    for (const phase of DOWNLOAD_PHASES) {
+        totalRequests += phase.count;
+    }
+    for (const phase of DOWNLOAD_PHASES) {
+        const url = `${CF_DOWN_URL}?bytes=${phase.bytes}`;
+        let remaining = phase.count;
+        let phaseHitThreshold = false;
+        while (remaining > 0) {
+            const batch = Math.min(remaining, phase.parallel);
+            const promises = Array.from({ length: batch }, () => timedDownload(url).then(timing => {
+                const durationMs = timing.endTime - timing.ttfb;
+                const speedBps = durationMs > 0
+                    ? (timing.bytesTransferred * 8 * 1000) / durationMs
+                    : 0;
+                const m = {
+                    bytes: timing.bytesTransferred,
+                    durationMs,
+                    speedBps,
+                };
+                allMeasurements.push(m);
+                if (speedBps > 0) {
+                    liveSpeed = liveSpeed === 0 ? speedBps : ema(speedBps, liveSpeed);
+                }
+                if (durationMs > FINISH_REQUEST_DURATION_MS) {
+                    phaseHitThreshold = true;
+                }
+                completedRequests++;
+                onProgress?.(completedRequests / totalRequests, liveSpeed);
+                return m;
+            }).catch(() => {
+                completedRequests++;
+                onProgress?.(completedRequests / totalRequests, liveSpeed);
+                return null;
+            }));
+            await Promise.all(promises);
+            remaining -= batch;
+        }
+        // Early termination: if requests in this phase took long enough, skip larger phases
+        if (phaseHitThreshold)
+            break;
+    }
+    const speedBps = computeBandwidth(allMeasurements);
+    return {
+        measurements: allMeasurements,
+        speedBps,
+        speedMbps: bpsToMbps(speedBps),
+    };
+}
+//# sourceMappingURL=download.js.map

package/dist/src/tester/download.js.map

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

package/dist/src/tester/http-client.d.ts

@@ -0,0 +1,3 @@
+import type { TimingResult } from './types.js';
+export declare function timedDownload(url: string): Promise<TimingResult>;
+export declare function timedUpload(url: string, payload: Uint8Array): Promise<TimingResult>;

package/dist/src/tester/http-client.js

@@ -0,0 +1,72 @@
+import { performance } from 'node:perf_hooks';
+import { ESTIMATED_SERVER_TIME_MS } from '../config.js';
+function parseServerTiming(headers) {
+    const st = headers.get('server-timing');
+    if (st) {
+        const match = /dur=([\d.]+)/.exec(st);
+        if (match?.[1])
+            return parseFloat(match[1]);
+    }
+    return ESTIMATED_SERVER_TIME_MS;
+}
+export async function timedDownload(url) {
+    const startTime = performance.now();
+    const response = await fetch(url, {
+        cache: 'no-store',
+        headers: { 'User-Agent': 'wirespeed/1.0.0' },
+    });
+    if (!response.ok)
+        throw new Error(`HTTP ${response.status}`);
+    if (!response.body)
+        throw new Error('No response body');
+    let ttfb = 0;
+    let bytesTransferred = 0;
+    let firstChunk = true;
+    const reader = response.body.getReader();
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (firstChunk) {
+            ttfb = performance.now();
+            firstChunk = false;
+        }
+        if (done)
+            break;
+        bytesTransferred += value.byteLength;
+    }
+    // If no body bytes (zero-byte latency test), ttfb is the end time
+    if (firstChunk)
+        ttfb = performance.now();
+    const endTime = performance.now();
+    const serverTime = parseServerTiming(response.headers);
+    return { startTime, ttfb, endTime, bytesTransferred, serverTime };
+}
+export async function timedUpload(url, payload) {
+    const startTime = performance.now();
+    const response = await fetch(url, {
+        method: 'POST',
+        body: Buffer.from(payload),
+        cache: 'no-store',
+        headers: {
+            'User-Agent': 'wirespeed/1.0.0',
+            'Content-Type': 'application/octet-stream',
+        },
+    });
+    if (!response.ok)
+        throw new Error(`HTTP ${response.status}`);
+    // Consume response body
+    if (response.body) {
+        const reader = response.body.getReader();
+        while (!(await reader.read()).done) { }
+    }
+    const endTime = performance.now();
+    const ttfb = endTime; // not meaningful for upload
+    const serverTime = parseServerTiming(response.headers);
+    return {
+        startTime,
+        ttfb,
+        endTime,
+        bytesTransferred: payload.byteLength,
+        serverTime,
+    };
+}
+//# sourceMappingURL=http-client.js.map

package/dist/src/tester/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../../src/tester/http-client.ts"],"names":[],"mappings":"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"}

package/dist/src/tester/latency.d.ts

@@ -0,0 +1,2 @@
+import type { LatencyResult } from './types.js';
+export declare function measureLatency(onMeasurement?: (index: number, latencyMs: number) => void): Promise<LatencyResult>;

package/dist/src/tester/latency.js

@@ -0,0 +1,25 @@
+import { CF_DOWN_URL, LATENCY_REQUESTS } from '../config.js';
+import { timedDownload } from './http-client.js';
+import { computeMedianLatency, computeJitter } from '../stats/calculator.js';
+export async function measureLatency(onMeasurement) {
+    const url = `${CF_DOWN_URL}?bytes=0`;
+    const measurements = [];
+    for (let i = 0; i < LATENCY_REQUESTS; i++) {
+        try {
+            const timing = await timedDownload(url);
+            const latencyMs = (timing.ttfb - timing.startTime) - timing.serverTime;
+            const clamped = Math.max(0, latencyMs);
+            measurements.push(clamped);
+            onMeasurement?.(i, clamped);
+        }
+        catch {
+            // Skip failed measurements
+        }
+    }
+    return {
+        measurements,
+        median: computeMedianLatency(measurements),
+        jitter: computeJitter(measurements),
+    };
+}
+//# sourceMappingURL=latency.js.map

package/dist/src/tester/latency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency.js","sourceRoot":"","sources":["../../../src/tester/latency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG7E,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,aAA0D;IAE1D,MAAM,GAAG,GAAG,GAAG,WAAW,UAAU,CAAC;IACrC,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;YACvE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YACvC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC3B,aAAa,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;IACH,CAAC;IAED,OAAO;QACL,YAAY;QACZ,MAAM,EAAE,oBAAoB,CAAC,YAAY,CAAC;QAC1C,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC;KACpC,CAAC;AACJ,CAAC"}

package/dist/src/tester/types.d.ts

@@ -0,0 +1,44 @@
+export interface TimingResult {
+    startTime: number;
+    ttfb: number;
+    endTime: number;
+    bytesTransferred: number;
+    serverTime: number;
+}
+export interface Measurement {
+    bytes: number;
+    durationMs: number;
+    speedBps: number;
+}
+export interface LatencyResult {
+    measurements: number[];
+    median: number;
+    jitter: number;
+}
+export interface BandwidthResult {
+    measurements: Measurement[];
+    speedBps: number;
+    speedMbps: number;
+}
+export interface ServerMeta {
+    colo: string;
+    city: string;
+    ip: string;
+    loc: string;
+}
+export interface TestResults {
+    server: ServerMeta;
+    latency: LatencyResult;
+    download: BandwidthResult | null;
+    upload: BandwidthResult | null;
+}
+export type TestPhase = 'init' | 'latency' | 'download' | 'upload' | 'done';
+export interface LiveUpdate {
+    phase: TestPhase;
+    progress: number;
+    currentSpeed: number;
+    latency?: LatencyResult;
+    download?: BandwidthResult;
+    upload?: BandwidthResult;
+    server?: ServerMeta;
+}

package/dist/src/tester/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/tester/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tester/types.ts"],"names":[],"mappings":""}

package/dist/src/tester/upload.d.ts

@@ -0,0 +1,2 @@
+import type { BandwidthResult } from './types.js';
+export declare function measureUpload(onProgress?: (progress: number, currentSpeedBps: number) => void): Promise<BandwidthResult>;

package/dist/src/tester/upload.js

@@ -0,0 +1,61 @@
+import { CF_UP_URL, UPLOAD_PHASES, FINISH_REQUEST_DURATION_MS } from '../config.js';
+import { timedUpload } from './http-client.js';
+import { computeBandwidth, ema } from '../stats/calculator.js';
+import { bpsToMbps } from '../stats/units.js';
+function generatePayload(bytes) {
+    // Fill with zeros — Cloudflare discards the body anyway
+    return new Uint8Array(bytes);
+}
+export async function measureUpload(onProgress) {
+    const allMeasurements = [];
+    let liveSpeed = 0;
+    let totalRequests = 0;
+    let completedRequests = 0;
+    for (const phase of UPLOAD_PHASES) {
+        totalRequests += phase.count;
+    }
+    for (const phase of UPLOAD_PHASES) {
+        const payload = generatePayload(phase.bytes);
+        let remaining = phase.count;
+        let phaseHitThreshold = false;
+        while (remaining > 0) {
+            const batch = Math.min(remaining, phase.parallel);
+            const promises = Array.from({ length: batch }, () => timedUpload(CF_UP_URL, payload).then(timing => {
+                const durationMs = (timing.endTime - timing.startTime) - timing.serverTime;
+                const speedBps = durationMs > 0
+                    ? (timing.bytesTransferred * 8 * 1000) / durationMs
+                    : 0;
+                const m = {
+                    bytes: timing.bytesTransferred,
+                    durationMs,
+                    speedBps,
+                };
+                allMeasurements.push(m);
+                if (speedBps > 0) {
+                    liveSpeed = liveSpeed === 0 ? speedBps : ema(speedBps, liveSpeed);
+                }
+                if (durationMs > FINISH_REQUEST_DURATION_MS) {
+                    phaseHitThreshold = true;
+                }
+                completedRequests++;
+                onProgress?.(completedRequests / totalRequests, liveSpeed);
+                return m;
+            }).catch(() => {
+                completedRequests++;
+                onProgress?.(completedRequests / totalRequests, liveSpeed);
+                return null;
+            }));
+            await Promise.all(promises);
+            remaining -= batch;
+        }
+        if (phaseHitThreshold)
+            break;
+    }
+    const speedBps = computeBandwidth(allMeasurements);
+    return {
+        measurements: allMeasurements,
+        speedBps,
+        speedMbps: bpsToMbps(speedBps),
+    };
+}
+//# sourceMappingURL=upload.js.map

package/dist/src/tester/upload.js.map

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

package/dist/src/ui/components.d.ts

@@ -0,0 +1,4 @@
+export declare function getSpinnerFrame(): string;
+export declare function resetSpinner(): void;
+export declare function progressBar(progress: number, width?: number): string;
+export declare function box(lines: string[], width?: number): string;

package/dist/src/ui/components.js

@@ -0,0 +1,39 @@
+import chalk from 'chalk';
+import cliSpinners from 'cli-spinners';
+import { symbols, colors } from './theme.js';
+const spinner = cliSpinners.dots;
+let spinnerFrame = 0;
+export function getSpinnerFrame() {
+    const frame = spinner.frames[spinnerFrame % spinner.frames.length];
+    spinnerFrame++;
+    return chalk.yellow(frame);
+}
+export function resetSpinner() {
+    spinnerFrame = 0;
+}
+export function progressBar(progress, width = 30) {
+    const clamped = Math.max(0, Math.min(1, progress));
+    const filled = Math.round(clamped * width);
+    const empty = width - filled;
+    return colors.accent(symbols.bar.repeat(filled)) + colors.dim(symbols.barEmpty.repeat(empty));
+}
+export function box(lines, width = 40) {
+    const inner = width - 2;
+    const top = colors.box(`   ${symbols.boxTopLeft}${symbols.boxHorizontal.repeat(inner)}${symbols.boxTopRight}`);
+    const bottom = colors.box(`   ${symbols.boxBottomLeft}${symbols.boxHorizontal.repeat(inner)}${symbols.boxBottomRight}`);
+    const rows = lines.map(line => {
+        const stripped = stripAnsi(line);
+        const pad = Math.max(0, inner - stripped.length);
+        const left = Math.floor(pad / 2);
+        const right = pad - left;
+        return colors.box(`   ${symbols.boxVertical}`) +
+            ' '.repeat(left) + line + ' '.repeat(right) +
+            colors.box(symbols.boxVertical);
+    });
+    return [top, ...rows, bottom].join('\n');
+}
+function stripAnsi(str) {
+    // eslint-disable-next-line no-control-regex
+    return str.replace(/\x1b\[[0-9;]*m/g, '');
+}
+//# sourceMappingURL=components.js.map

package/dist/src/ui/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../../../src/ui/components.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,WAAW,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC;AACjC,IAAI,YAAY,GAAG,CAAC,CAAC;AAErB,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAE,CAAC;IACpE,YAAY,EAAE,CAAC;IACf,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,YAAY,GAAG,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,KAAK,GAAG,EAAE;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC7B,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,KAAe,EAAE,KAAK,GAAG,EAAE;IAC7C,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;IACxB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CACpB,MAAM,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,CACvF,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CACvB,MAAM,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,cAAc,EAAE,CAC7F,CAAC;IAEF,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QAC5B,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC;QACzB,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;YAC5C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;YAC3C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,4CAA4C;IAC5C,OAAO,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/src/ui/layout.d.ts

@@ -0,0 +1,4 @@
+import type { LiveUpdate } from '../tester/types.js';
+export declare function composeFrame(state: LiveUpdate): string;
+export declare function composePlainResult(state: LiveUpdate): string;
+export declare function composeJson(state: LiveUpdate): string;

package/dist/src/ui/layout.js

@@ -0,0 +1,111 @@
+import { symbols, colors, latencyColor } from './theme.js';
+import { box, progressBar, getSpinnerFrame } from './components.js';
+import { formatSpeed, formatLatency } from '../stats/units.js';
+const VERSION = '1.0.0';
+function padRight(str, len) {
+    const stripped = str.replace(/\x1b\[[0-9;]*m/g, '');
+    const pad = Math.max(0, len - stripped.length);
+    return str + ' '.repeat(pad);
+}
+export function composeFrame(state) {
+    const lines = [];
+    // Header box
+    const headerLines = [
+        colors.header(`wirespeed`) + colors.dim(`  v${VERSION}`),
+    ];
+    if (state.server) {
+        headerLines.push(colors.dim(`Server: Cloudflare ${state.server.colo} (${state.server.city})`));
+    }
+    lines.push(box(headerLines));
+    lines.push('');
+    // Phase status
+    if (state.phase === 'init') {
+        lines.push(`   ${getSpinnerFrame()} ${colors.dim('Connecting to server...')}`);
+    }
+    else if (state.phase === 'latency') {
+        lines.push(`   ${getSpinnerFrame()} ${colors.dim('Measuring latency...')}`);
+    }
+    else if (state.phase === 'download') {
+        lines.push(`   ${getSpinnerFrame()} ${colors.dim('Testing download speed...')}`);
+    }
+    else if (state.phase === 'upload') {
+        lines.push(`   ${getSpinnerFrame()} ${colors.dim('Testing upload speed...')}`);
+    }
+    lines.push('');
+    // Latency
+    if (state.latency) {
+        const lc = latencyColor(state.latency.median);
+        lines.push(`   ${symbols.latency}  ${colors.label('Latency')}    ${padRight(lc(formatLatency(state.latency.median)), 16)}` +
+            colors.dim(`jitter: ${formatLatency(state.latency.jitter)}`));
+    }
+    else if (state.phase === 'latency') {
+        lines.push(`   ${symbols.latency}  ${colors.label('Latency')}    ${colors.dim('measuring...')}`);
+    }
+    // Download
+    if (state.download) {
+        lines.push(`   ${symbols.download}  ${colors.label('Download')}   ${colors.download(formatSpeed(state.download.speedBps))}  ${colors.success(symbols.check)}`);
+    }
+    else if (state.phase === 'download') {
+        const speedStr = state.currentSpeed > 0
+            ? colors.download(formatSpeed(state.currentSpeed))
+            : colors.dim('—');
+        lines.push(`   ${symbols.download}  ${colors.label('Download')}   ${speedStr}`);
+        lines.push(`      ${progressBar(state.progress)}  ${colors.dim(`${Math.round(state.progress * 100)}%`)}`);
+    }
+    else if (state.phase !== 'init' && state.phase !== 'latency') {
+        lines.push(`   ${symbols.download}  ${colors.label('Download')}   ${colors.dim('—')}`);
+    }
+    // Upload
+    if (state.upload) {
+        lines.push(`   ${symbols.upload}  ${colors.label('Upload')}     ${colors.upload(formatSpeed(state.upload.speedBps))}  ${colors.success(symbols.check)}`);
+    }
+    else if (state.phase === 'upload') {
+        const speedStr = state.currentSpeed > 0
+            ? colors.upload(formatSpeed(state.currentSpeed))
+            : colors.dim('—');
+        lines.push(`   ${symbols.upload}  ${colors.label('Upload')}     ${speedStr}`);
+        lines.push(`      ${progressBar(state.progress)}  ${colors.dim(`${Math.round(state.progress * 100)}%`)}`);
+    }
+    else if (state.phase === 'done') {
+        lines.push(`   ${symbols.upload}  ${colors.label('Upload')}     ${colors.dim('—')}`);
+    }
+    // Done
+    if (state.phase === 'done') {
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function composePlainResult(state) {
+    const lines = [];
+    if (state.server) {
+        lines.push(`Server: Cloudflare ${state.server.colo} (${state.server.city})`);
+    }
+    if (state.latency) {
+        lines.push(`Latency: ${formatLatency(state.latency.median)} (jitter: ${formatLatency(state.latency.jitter)})`);
+    }
+    if (state.download) {
+        lines.push(`Download: ${formatSpeed(state.download.speedBps)}`);
+    }
+    if (state.upload) {
+        lines.push(`Upload: ${formatSpeed(state.upload.speedBps)}`);
+    }
+    return lines.join('\n');
+}
+export function composeJson(state) {
+    return JSON.stringify({
+        server: state.server,
+        latency: state.latency ? {
+            median_ms: Math.round(state.latency.median * 100) / 100,
+            jitter_ms: Math.round(state.latency.jitter * 100) / 100,
+        } : null,
+        download: state.download ? {
+            speed_bps: Math.round(state.download.speedBps),
+            speed_mbps: Math.round(state.download.speedMbps * 100) / 100,
+        } : null,
+        upload: state.upload ? {
+            speed_bps: Math.round(state.upload.speedBps),
+            speed_mbps: Math.round(state.upload.speedMbps * 100) / 100,
+        } : null,
+    }, null, 2);
+}
+//# sourceMappingURL=layout.js.map

package/dist/src/ui/layout.js.map

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

package/dist/src/ui/renderer.d.ts

@@ -0,0 +1,9 @@
+import type { LiveUpdate } from '../tester/types.js';
+export declare class Renderer {
+    private intervalId;
+    private state;
+    start(): void;
+    update(patch: Partial<LiveUpdate>): void;
+    stop(): void;
+    getState(): LiveUpdate;
+}

package/dist/src/ui/renderer.js

@@ -0,0 +1,36 @@
+import logUpdate from 'log-update';
+import { RENDER_INTERVAL_MS } from '../config.js';
+import { composeFrame } from './layout.js';
+import { resetSpinner } from './components.js';
+export class Renderer {
+    intervalId = null;
+    state = {
+        phase: 'init',
+        progress: 0,
+        currentSpeed: 0,
+    };
+    start() {
+        resetSpinner();
+        this.intervalId = setInterval(() => {
+            logUpdate(composeFrame(this.state));
+        }, RENDER_INTERVAL_MS);
+        // Render immediately
+        logUpdate(composeFrame(this.state));
+    }
+    update(patch) {
+        Object.assign(this.state, patch);
+    }
+    stop() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        // Render final frame and persist it
+        logUpdate(composeFrame(this.state));
+        logUpdate.done();
+    }
+    getState() {
+        return { ...this.state };
+    }
+}
+//# sourceMappingURL=renderer.js.map

package/dist/src/ui/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../../src/ui/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,MAAM,OAAO,QAAQ;IACX,UAAU,GAA0C,IAAI,CAAC;IACzD,KAAK,GAAe;QAC1B,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,CAAC;QACX,YAAY,EAAE,CAAC;KAChB,CAAC;IAEF,KAAK;QACH,YAAY,EAAE,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,CAAC,EAAE,kBAAkB,CAAC,CAAC;QACvB,qBAAqB;QACrB,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,KAA0B;QAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;QACD,oCAAoC;QACpC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACpC,SAAS,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/src/ui/theme.d.ts

@@ -0,0 +1,33 @@
+export declare const symbols: {
+    download: string;
+    upload: string;
+    latency: string;
+    check: string;
+    cross: string;
+    bar: string;
+    barEmpty: string;
+    boxTopLeft: string;
+    boxTopRight: string;
+    boxBottomLeft: string;
+    boxBottomRight: string;
+    boxHorizontal: string;
+    boxVertical: string;
+    bullet: string;
+};
+export declare const colors: {
+    download: import("chalk").ChalkInstance;
+    upload: import("chalk").ChalkInstance;
+    latencyGood: import("chalk").ChalkInstance;
+    latencyMed: import("chalk").ChalkInstance;
+    latencyBad: import("chalk").ChalkInstance;
+    label: import("chalk").ChalkInstance;
+    dim: import("chalk").ChalkInstance;
+    accent: import("chalk").ChalkInstance;
+    success: import("chalk").ChalkInstance;
+    warning: import("chalk").ChalkInstance;
+    error: import("chalk").ChalkInstance;
+    speed: import("chalk").ChalkInstance;
+    header: import("chalk").ChalkInstance;
+    box: import("chalk").ChalkInstance;
+};
+export declare function latencyColor(ms: number): (text: string) => string;

package/dist/src/ui/theme.js

@@ -0,0 +1,43 @@
+import chalk from 'chalk';
+import isUnicodeSupported from 'is-unicode-supported';
+const unicode = isUnicodeSupported();
+export const symbols = {
+    download: unicode ? '↓' : 'D',
+    upload: unicode ? '↑' : 'U',
+    latency: unicode ? '⏱' : 'P',
+    check: unicode ? '✓' : 'ok',
+    cross: unicode ? '✗' : 'x',
+    bar: unicode ? '█' : '#',
+    barEmpty: unicode ? '░' : '-',
+    boxTopLeft: unicode ? '╭' : '+',
+    boxTopRight: unicode ? '╮' : '+',
+    boxBottomLeft: unicode ? '╰' : '+',
+    boxBottomRight: unicode ? '╯' : '+',
+    boxHorizontal: unicode ? '─' : '-',
+    boxVertical: unicode ? '│' : '|',
+    bullet: unicode ? '•' : '*',
+};
+export const colors = {
+    download: chalk.bold.cyan,
+    upload: chalk.bold.magenta,
+    latencyGood: chalk.bold.green,
+    latencyMed: chalk.bold.yellow,
+    latencyBad: chalk.bold.red,
+    label: chalk.bold.white,
+    dim: chalk.gray,
+    accent: chalk.cyan,
+    success: chalk.green,
+    warning: chalk.yellow,
+    error: chalk.red,
+    speed: chalk.bold.white,
+    header: chalk.bold.cyan,
+    box: chalk.gray,
+};
+export function latencyColor(ms) {
+    if (ms < 50)
+        return colors.latencyGood;
+    if (ms < 100)
+        return colors.latencyMed;
+    return colors.latencyBad;
+}
+//# sourceMappingURL=theme.js.map

package/dist/src/ui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../../src/ui/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAEtD,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;AAErC,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IAC7B,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IAC5B,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;IAC3B,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IAC1B,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IACxB,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IAC7B,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IAC/B,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IAChC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IAClC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IACnC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IAClC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;IAChC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI;IACzB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO;IAC1B,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK;IAC7B,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM;IAC7B,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG;IAC1B,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK;IACvB,GAAG,EAAE,KAAK,CAAC,IAAI;IACf,MAAM,EAAE,KAAK,CAAC,IAAI;IAClB,OAAO,EAAE,KAAK,CAAC,KAAK;IACpB,OAAO,EAAE,KAAK,CAAC,MAAM;IACrB,KAAK,EAAE,KAAK,CAAC,GAAG;IAChB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK;IACvB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI;IACvB,GAAG,EAAE,KAAK,CAAC,IAAI;CAChB,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,IAAI,EAAE,GAAG,EAAE;QAAE,OAAO,MAAM,CAAC,WAAW,CAAC;IACvC,IAAI,EAAE,GAAG,GAAG;QAAE,OAAO,MAAM,CAAC,UAAU,CAAC;IACvC,OAAO,MAAM,CAAC,UAAU,CAAC;AAC3B,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@mayurpise/wirespeed",
+  "version": "1.0.0",
+  "description": "Terminal internet speed test — download, upload, and latency",
+  "author": "mayurpise",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mayurpise/wirespeed"
+  },
+  "homepage": "https://github.com/mayurpise/wirespeed#readme",
+  "bugs": {
+    "url": "https://github.com/mayurpise/wirespeed/issues"
+  },
+  "type": "module",
+  "bin": {
+    "wirespeed": "./bin/wirespeed.js"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/src/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "speed-test",
+    "bandwidth",
+    "internet",
+    "download",
+    "upload",
+    "latency",
+    "ping",
+    "cli",
+    "terminal",
+    "cloudflare",
+    "wirespeed"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "cli-spinners": "^3.2.0",
+    "is-unicode-supported": "^2.1.0",
+    "log-update": "^6.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  }
+}