recker 1.0.15 → 1.0.16

package/dist/utils/sparkline.js

@@ -0,0 +1,55 @@
+const SPARK_CHARS = ['▁', '▂', '▃', '▄', '▅', '▆', '▇', '█'];
+const EMPTY_CHAR = '·';
+export function sparkline(data, options = {}) {
+    const { width = 30, min: fixedMin, max: fixedMax } = options;
+    if (width === 0)
+        return '';
+    if (data.length === 0)
+        return EMPTY_CHAR.repeat(width);
+    const start = Math.max(0, data.length - width);
+    const slice = data.slice(start);
+    const min = fixedMin ?? Math.min(...slice, 0);
+    const max = fixedMax ?? Math.max(...slice, 0);
+    const range = Math.max(max - min, Number.EPSILON);
+    let result = '';
+    const padding = Math.max(0, width - slice.length);
+    if (padding > 0) {
+        result += EMPTY_CHAR.repeat(padding);
+    }
+    for (const value of slice) {
+        const normalized = Math.max(0, Math.min(1, (value - min) / range));
+        const idx = Math.round(normalized * (SPARK_CHARS.length - 1));
+        result += SPARK_CHARS[Math.min(idx, SPARK_CHARS.length - 1)];
+    }
+    return result;
+}
+export class SparklineBuffer {
+    data = [];
+    capacity;
+    constructor(capacity = 60) {
+        this.capacity = capacity;
+    }
+    push(value) {
+        if (this.data.length >= this.capacity) {
+            this.data.shift();
+        }
+        this.data.push(value);
+    }
+    getData() {
+        return this.data;
+    }
+    render(options = {}) {
+        return sparkline(this.data, { width: this.capacity, ...options });
+    }
+    clear() {
+        this.data = [];
+    }
+    latest() {
+        return this.data[this.data.length - 1];
+    }
+    average() {
+        if (this.data.length === 0)
+            return 0;
+        return this.data.reduce((a, b) => a + b, 0) / this.data.length;
+    }
+}

package/dist/utils/sse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/utils/sse.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,wBAAuB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAuF5E"}
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/utils/sse.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,wBAAuB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAoF5E"}

package/dist/utils/sse.js

@@ -1,11 +1,10 @@
-import { ReckerError } from '../core/errors.js';
+import { StreamError } from '../core/errors.js';
 export async function* parseSSE(response) {
     if (!response.body) {
-        throw new ReckerError('Response body is empty; cannot parse SSE stream.', undefined, undefined, [
-            'Ensure the server is sending an SSE stream with a response body.',
-            'Check that the request was not a HEAD/204 response.',
-            'Verify connection was not closed before the body was received.'
-        ]);
+        throw new StreamError('Response body is empty; cannot parse SSE stream.', {
+            streamType: 'sse',
+            retriable: true,
+        });
     }
     const reader = response.body.getReader();
     const decoder = new TextDecoder();

package/dist/utils/system-metrics.d.ts

@@ -0,0 +1,26 @@
+export interface SystemSnapshot {
+    cpu: number;
+    memory: number;
+    memoryUsed: number;
+    memoryTotal: number;
+    timestamp: number;
+}
+export declare class SystemMetrics {
+    private previousCpuTimes;
+    private intervalId;
+    private listeners;
+    getMemory(): {
+        used: number;
+        total: number;
+        percent: number;
+    };
+    private getCpuTimes;
+    getCpuUsage(): number;
+    getSnapshot(): SystemSnapshot;
+    startPolling(intervalMs?: number): void;
+    stopPolling(): void;
+    onSnapshot(callback: (snapshot: SystemSnapshot) => void): () => void;
+    static formatBytes(bytes: number): string;
+    static formatMemory(used: number, total: number): string;
+}
+//# sourceMappingURL=system-metrics.d.ts.map

package/dist/utils/system-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-metrics.d.ts","sourceRoot":"","sources":["../../src/utils/system-metrics.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;IAE7B,GAAG,EAAE,MAAM,CAAC;IAEZ,MAAM,EAAE,MAAM,CAAC;IAEf,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE,MAAM,CAAC;IAEpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,aAAa;IACxB,OAAO,CAAC,gBAAgB,CAAgD;IACxE,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,SAAS,CAAsD;IAKvE,SAAS,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAY7D,OAAO,CAAC,WAAW;IAgBnB,WAAW,IAAI,MAAM;IAsBrB,WAAW,IAAI,cAAc;IAgB7B,YAAY,CAAC,UAAU,GAAE,MAAa,GAAG,IAAI;IAiB7C,WAAW,IAAI,IAAI;IAUnB,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI;IAQpE,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAUzC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;CAGzD"}

package/dist/utils/system-metrics.js

@@ -0,0 +1,81 @@
+import os from 'node:os';
+export class SystemMetrics {
+    previousCpuTimes = null;
+    intervalId = null;
+    listeners = new Set();
+    getMemory() {
+        const total = os.totalmem();
+        const free = os.freemem();
+        const used = total - free;
+        const percent = (used / total) * 100;
+        return { used, total, percent };
+    }
+    getCpuTimes() {
+        const cpus = os.cpus();
+        let idle = 0;
+        let total = 0;
+        for (const cpu of cpus) {
+            idle += cpu.times.idle;
+            total += cpu.times.user + cpu.times.nice + cpu.times.sys + cpu.times.idle + cpu.times.irq;
+        }
+        return { idle, total };
+    }
+    getCpuUsage() {
+        const current = this.getCpuTimes();
+        if (!this.previousCpuTimes) {
+            this.previousCpuTimes = current;
+            return 0;
+        }
+        const idleDelta = current.idle - this.previousCpuTimes.idle;
+        const totalDelta = current.total - this.previousCpuTimes.total;
+        this.previousCpuTimes = current;
+        if (totalDelta === 0)
+            return 0;
+        const usage = 100 - (idleDelta / totalDelta) * 100;
+        return Math.max(0, Math.min(100, usage));
+    }
+    getSnapshot() {
+        const memory = this.getMemory();
+        const cpu = this.getCpuUsage();
+        return {
+            cpu,
+            memory: memory.percent,
+            memoryUsed: memory.used,
+            memoryTotal: memory.total,
+            timestamp: Date.now()
+        };
+    }
+    startPolling(intervalMs = 1000) {
+        if (this.intervalId)
+            return;
+        this.previousCpuTimes = this.getCpuTimes();
+        this.intervalId = setInterval(() => {
+            const snapshot = this.getSnapshot();
+            for (const listener of this.listeners) {
+                listener(snapshot);
+            }
+        }, intervalMs);
+    }
+    stopPolling() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+    }
+    onSnapshot(callback) {
+        this.listeners.add(callback);
+        return () => this.listeners.delete(callback);
+    }
+    static formatBytes(bytes) {
+        if (bytes < 1024)
+            return `${bytes}B`;
+        if (bytes < 1024 * 1024)
+            return `${(bytes / 1024).toFixed(1)}K`;
+        if (bytes < 1024 * 1024 * 1024)
+            return `${(bytes / 1024 / 1024).toFixed(1)}M`;
+        return `${(bytes / 1024 / 1024 / 1024).toFixed(1)}G`;
+    }
+    static formatMemory(used, total) {
+        return `${this.formatBytes(used)}/${this.formatBytes(total)}`;
+    }
+}

package/dist/utils/tls-inspector.d.ts

@@ -16,6 +16,12 @@ export interface TLSInfo {
     } | null;
     authorized: boolean;
     authorizationError?: Error;
+    altNames?: string[];
+    pubkey: {
+        algo: string;
+        size: number;
+    } | null;
+    extKeyUsage?: string[];
 }
 export declare function inspectTLS(host: string, port?: number, options?: ConnectionOptions): Promise<TLSInfo>;
 //# sourceMappingURL=tls-inspector.d.ts.map

package/dist/utils/tls-inspector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tls-inspector.d.ts","sourceRoot":"","sources":["../../src/utils/tls-inspector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEjE,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI,CAAC;IACT,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,KAAK,CAAC;CAC5B;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAY,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CA4C9G"}
+{"version":3,"file":"tls-inspector.d.ts","sourceRoot":"","sources":["../../src/utils/tls-inspector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAGjE,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI,CAAC;IACT,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,KAAK,CAAC;IAE3B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAY,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAkF9G"}

package/dist/utils/tls-inspector.js

@@ -1,4 +1,5 @@
 import { connect } from 'node:tls';
+import * as crypto from 'node:crypto';
 export function inspectTLS(host, port = 443, options = {}) {
     return new Promise((resolve, reject) => {
         const socket = connect(port, host, { ...options, servername: host }, () => {
@@ -11,6 +12,36 @@ export function inspectTLS(host, port = 443, options = {}) {
             const validTo = new Date(cert.valid_to);
             const now = new Date();
             const daysRemaining = Math.floor((validTo.getTime() - now.getTime()) / (1000 * 60 * 60 * 24));
+            const altNames = cert.subjectaltname
+                ? cert.subjectaltname.split(', ').map(s => s.replace(/^DNS:|^IP Address:/, '')).filter(Boolean)
+                : [];
+            let pubkey = null;
+            if (cert.pubkey) {
+                try {
+                    const keyObject = crypto.createPublicKey(cert.pubkey);
+                    let keySize;
+                    const keyAlgo = keyObject.asymmetricKeyType || 'unknown';
+                    if (keyObject.asymmetricKeyDetails) {
+                        if (keyObject.asymmetricKeyDetails.modulusLength) {
+                            keySize = keyObject.asymmetricKeyDetails.modulusLength;
+                        }
+                        else if (keyObject.asymmetricKeyDetails.namedCurve) {
+                            const curve = keyObject.asymmetricKeyDetails.namedCurve;
+                            if (curve.includes('256') || curve.includes('p256'))
+                                keySize = 256;
+                            else if (curve.includes('384') || curve.includes('p384'))
+                                keySize = 384;
+                            else if (curve.includes('521') || curve.includes('p521'))
+                                keySize = 521;
+                        }
+                    }
+                    if (keySize) {
+                        pubkey = { algo: keyAlgo, size: keySize };
+                    }
+                }
+                catch {
+                }
+            }
             const info = {
                 valid: now >= validFrom && now <= validTo,
                 validFrom,
@@ -24,7 +55,10 @@ export function inspectTLS(host, port = 443, options = {}) {
                 protocol: socket.getProtocol(),
                 cipher: socket.getCipher(),
                 authorized: socket.authorized,
-                authorizationError: socket.authorizationError
+                authorizationError: socket.authorizationError,
+                altNames,
+                pubkey,
+                extKeyUsage: cert.ext_key_usage || []
             };
             socket.end();
             resolve(info);

package/dist/webrtc/index.d.ts.map

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

package/dist/webrtc/index.js

@@ -1,3 +1,4 @@
+import { StateError, TimeoutError, ConnectionError, UnsupportedError, } from '../core/errors.js';
 import { EventEmitter } from 'node:events';
 export class SignalingChannel extends EventEmitter {
     options;
@@ -79,7 +80,10 @@ export class WebRTCClient extends EventEmitter {
     }
     async connect(remotePeerId) {
         if (this.connections.has(remotePeerId)) {
-            throw new Error(`Already connected to peer: ${remotePeerId}`);
+            throw new StateError(`Already connected to peer: ${remotePeerId}`, {
+                expectedState: 'disconnected',
+                actualState: 'connected',
+            });
         }
         this.log(`Connecting to peer: ${remotePeerId}`);
         const pc = this.createPeerConnection(remotePeerId);
@@ -116,7 +120,10 @@ export class WebRTCClient extends EventEmitter {
         if (remotePeerId) {
             const dc = this.dataChannels.get(remotePeerId);
             if (!dc || dc.readyState !== 'open') {
-                throw new Error(`No open data channel to peer: ${remotePeerId}`);
+                throw new StateError(`No open data channel to peer: ${remotePeerId}`, {
+                    expectedState: 'open',
+                    actualState: dc?.readyState ?? 'no-channel',
+                });
             }
             dc.send(message);
         }
@@ -132,7 +139,10 @@ export class WebRTCClient extends EventEmitter {
         if (remotePeerId) {
             const dc = this.dataChannels.get(remotePeerId);
             if (!dc || dc.readyState !== 'open') {
-                throw new Error(`No open data channel to peer: ${remotePeerId}`);
+                throw new StateError(`No open data channel to peer: ${remotePeerId}`, {
+                    expectedState: 'open',
+                    actualState: dc?.readyState ?? 'no-channel',
+                });
             }
             dc.send(data);
         }
@@ -154,8 +164,7 @@ export class WebRTCClient extends EventEmitter {
     }
     createPeerConnection(remotePeerId) {
         if (typeof RTCPeerConnection === 'undefined') {
-            throw new Error('RTCPeerConnection is not available. ' +
-                'In Node.js, install the "wrtc" package and ensure it\'s loaded before using WebRTC.');
+            throw new UnsupportedError('RTCPeerConnection is not available. In Node.js, install the "wrtc" package and ensure it\'s loaded before using WebRTC.', { feature: 'RTCPeerConnection' });
         }
         const pc = new RTCPeerConnection({
             iceServers: this.iceServers,
@@ -264,7 +273,10 @@ export class WebRTCClient extends EventEmitter {
     waitForConnection(remotePeerId) {
         return new Promise((resolve, reject) => {
             const timeout = setTimeout(() => {
-                reject(new Error(`Connection timeout to peer: ${remotePeerId}`));
+                reject(new TimeoutError(undefined, {
+                    phase: 'webrtc-connect',
+                    timeout: this.connectionTimeout,
+                }));
             }, this.connectionTimeout);
             const checkConnection = () => {
                 const dc = this.dataChannels.get(remotePeerId);
@@ -282,7 +294,9 @@ export class WebRTCClient extends EventEmitter {
             this.on('disconnected', (peerId) => {
                 if (peerId === remotePeerId) {
                     clearTimeout(timeout);
-                    reject(new Error(`Connection failed to peer: ${remotePeerId}`));
+                    reject(new ConnectionError(`Connection failed to peer: ${remotePeerId}`, {
+                        host: remotePeerId,
+                    }));
                 }
             });
             checkConnection();

package/dist/websocket/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/websocket/client.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKvC,MAAM,WAAW,gBAAgB;IAI/B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAK9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAKjC,UAAU,CAAC,EAAE,UAAU,CAAC;IAKxB,KAAK,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAK9B,GAAG,CAAC,EAAE,UAAU,CAAC;IAMjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAM5B,SAAS,CAAC,EAAE,OAAO,CAAC;IAMpB,cAAc,CAAC,EAAE,MAAM,CAAC;IAMxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAO9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAM3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAYD,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,OAAO,CAAgP;IAC/P,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,YAAY,CAAS;gBAEjB,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;IA4BjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA+ExB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BtI,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7G,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAOzB,KAAK,CAAC,IAAI,SAAO,EAAE,MAAM,SAAK,GAAG,IAAI;IAgBrC,IAAI,IAAI,IAAI;IAwBZ,IAAI,UAAU,IAAI,MAAM,CAEvB;IAKD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAMD,UAAU,IAAI,QAAQ,GAAG,IAAI;IAavB,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrG,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBxD,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,gBAAgB,CAAC;IAoDjE,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,iBAAiB;YAKX,YAAY;CAgB3B;AAuBD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAMxF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/websocket/client.ts"],"names":[],"mappings":"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"}

package/dist/websocket/client.js

@@ -2,7 +2,7 @@ import { WebSocket } from 'undici';
 import { EventEmitter } from 'events';
 import { pipeline } from 'node:stream/promises';
 import { webToNodeStream } from '../utils/streaming.js';
-import { ReckerError } from '../core/errors.js';
+import { StateError, StreamError, ConnectionError } from '../core/errors.js';
 export class ReckerWebSocket extends EventEmitter {
     ws = null;
     url;
@@ -83,11 +83,10 @@ export class ReckerWebSocket extends EventEmitter {
                 this.ws.addEventListener('error', (event) => {
                     const err = event.error instanceof Error
                         ? event.error
-                        : new ReckerError('WebSocket connection error', undefined, undefined, [
-                            'Verify the WebSocket endpoint URL and protocol (ws/wss).',
-                            'Check proxy/TLS settings if connecting through a proxy.',
-                            'Inspect server logs for handshake failures.'
-                        ]);
+                        : new ConnectionError('WebSocket connection error', {
+                            host: this.url,
+                            retriable: true,
+                        });
                     this.emit('error', err);
                     reject(err);
                 });
@@ -99,11 +98,10 @@ export class ReckerWebSocket extends EventEmitter {
     }
     async send(data, options) {
         if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
-            throw new ReckerError('WebSocket is not connected', undefined, undefined, [
-                'Call connect() before sending messages.',
-                'Listen to the open event to ensure the socket is ready.',
-                'Check for prior connection errors or closed states.'
-            ]);
+            throw new StateError('WebSocket is not connected', {
+                expectedState: 'open',
+                actualState: this.ws ? 'closed' : 'not-created',
+            });
         }
         const awaitDrain = options?.awaitDrain ?? false;
         const highWaterMark = options?.highWaterMark ?? 16 * 1024;
@@ -169,11 +167,10 @@ export class ReckerWebSocket extends EventEmitter {
     async pipeTo(destination) {
         const readable = this.toReadable();
         if (!readable) {
-            throw new ReckerError('WebSocket has no readable stream', undefined, undefined, [
-                'Ensure the WebSocket is connected before piping.',
-                'Verify the runtime supports readable streams on WebSocket.',
-                'Fallback to event-based message handling if streaming is unavailable.'
-            ]);
+            throw new StreamError('WebSocket has no readable stream', {
+                streamType: 'websocket',
+                retriable: false,
+            });
         }
         await pipeline(readable, destination);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recker",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "description": "AI & DevX focused HTTP client for Node.js 18+",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -115,6 +115,7 @@
     "access": "public"
   },
   "dependencies": {
+    "@maxmind/geoip2-node": "^6.3.4",
     "cheerio": "^1.0.0",
     "commander": "^12.0.0",
     "fuse.js": "^7.1.0",
@@ -166,13 +167,13 @@
     "zod": "^3.24.0"
   },
   "scripts": {
-    "build": "tsc && mkdir -p dist/mcp/data && cp src/mcp/data/embeddings.json dist/mcp/data/",
+    "build": "tsc",
     "build:embeddings": "tsx scripts/build-embeddings.ts",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "bench": "tsx benchmark/index.ts",
     "bench:all": "tsx benchmark/run-all.ts",
-    "docs": "npx docsify-cli serve docs -p 3000 -o",
+    "docs": "pnpm serve docs -p 3000",
     "lint": "echo \"No linting configured for this project.\" && exit 0",
     "cli": "tsx src/cli/index.ts",
     "mcp:start": "tsx src/mcp/cli.ts",