recker 1.0.2-0 → 1.0.4

package/dist/utils/link-header.d.ts

@@ -0,0 +1,70 @@
+export interface Link {
+    uri: string;
+    rel?: string;
+    anchor?: string;
+    type?: string;
+    media?: string;
+    title?: string;
+    hreflang?: string;
+    [key: string]: string | undefined;
+}
+export interface LinkCollection {
+    all: Link[];
+    [rel: string]: Link | Link[] | undefined;
+}
+export declare function parseLink(headerValue: string): LinkCollection;
+export declare const LinkRel: {
+    readonly NEXT: "next";
+    readonly PREV: "prev";
+    readonly PREVIOUS: "previous";
+    readonly FIRST: "first";
+    readonly LAST: "last";
+    readonly ALTERNATE: "alternate";
+    readonly CANONICAL: "canonical";
+    readonly AUTHOR: "author";
+    readonly LICENSE: "license";
+    readonly STYLESHEET: "stylesheet";
+    readonly ICON: "icon";
+    readonly PRELOAD: "preload";
+    readonly PREFETCH: "prefetch";
+    readonly PRECONNECT: "preconnect";
+    readonly DNS_PREFETCH: "dns-prefetch";
+    readonly PRERENDER: "prerender";
+    readonly SELF: "self";
+    readonly EDIT: "edit";
+    readonly COLLECTION: "collection";
+    readonly ITEM: "item";
+    readonly HELP: "help";
+    readonly DESCRIBEDBY: "describedby";
+    readonly UP: "up";
+    readonly RELATED: "related";
+    readonly REPLIES: "replies";
+    readonly VIA: "via";
+};
+export declare class LinkHeaderParser {
+    private links;
+    constructor(headerValue: string);
+    getAll(): Link[];
+    getRel(rel: string): Link | Link[] | undefined;
+    getFirst(rel: string): Link | undefined;
+    has(rel: string): boolean;
+    getPagination(): {
+        next?: string;
+        prev?: string;
+        first?: string;
+        last?: string;
+    };
+    hasNext(): boolean;
+    hasPrev(): boolean;
+    getCanonical(): string | undefined;
+    getAlternates(): Link[];
+    getResourceHints(): {
+        preload: Link[];
+        prefetch: Link[];
+        preconnect: Link[];
+        dnsPrefetch: Link[];
+    };
+    toJSON(): LinkCollection;
+}
+export declare function parseLinkHeader(headers: Headers): LinkHeaderParser | null;
+//# sourceMappingURL=link-header.d.ts.map

package/dist/utils/link-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-header.d.ts","sourceRoot":"","sources":["../../src/utils/link-header.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,IAAI;IAEnB,GAAG,EAAE,MAAM,CAAC;IAEZ,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAKD,MAAM,WAAW,cAAc;IAE7B,GAAG,EAAE,IAAI,EAAE,CAAC;IAEZ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC;CAC1C;AAcD,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAqC7D;AAiGD,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCV,CAAC;AAKX,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAiB;gBAElB,WAAW,EAAE,MAAM;IAO/B,MAAM,IAAI,IAAI,EAAE;IAOhB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,EAAE,GAAG,SAAS;IAO9C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IASvC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAOzB,aAAa,IAAI;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;IAYD,OAAO,IAAI,OAAO;IAOlB,OAAO,IAAI,OAAO;IAOlB,YAAY,IAAI,MAAM,GAAG,SAAS;IAOlC,aAAa,IAAI,IAAI,EAAE;IASvB,gBAAgB,IAAI;QAClB,OAAO,EAAE,IAAI,EAAE,CAAC;QAChB,QAAQ,EAAE,IAAI,EAAE,CAAC;QACjB,UAAU,EAAE,IAAI,EAAE,CAAC;QACnB,WAAW,EAAE,IAAI,EAAE,CAAC;KACrB;IAkBD,MAAM,IAAI,cAAc;CAGzB;AAKD,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAIzE"}

package/dist/utils/link-header.js

@@ -0,0 +1,190 @@
+export function parseLink(headerValue) {
+    if (!headerValue || typeof headerValue !== 'string') {
+        return { all: [] };
+    }
+    const links = [];
+    const collection = { all: links };
+    const linkStrings = splitLinkHeader(headerValue);
+    for (const linkString of linkStrings) {
+        const link = parseSingleLink(linkString.trim());
+        if (link) {
+            links.push(link);
+            if (link.rel) {
+                const relTypes = link.rel.split(/\s+/);
+                for (const rel of relTypes) {
+                    const existing = collection[rel];
+                    if (existing) {
+                        if (Array.isArray(existing)) {
+                            existing.push(link);
+                        }
+                        else {
+                            collection[rel] = [existing, link];
+                        }
+                    }
+                    else {
+                        collection[rel] = link;
+                    }
+                }
+            }
+        }
+    }
+    return collection;
+}
+function splitLinkHeader(header) {
+    const result = [];
+    let current = '';
+    let inBrackets = false;
+    let inQuotes = false;
+    for (let i = 0; i < header.length; i++) {
+        const char = header[i];
+        const prevChar = i > 0 ? header[i - 1] : '';
+        if (char === '<' && !inQuotes) {
+            inBrackets = true;
+        }
+        else if (char === '>' && !inQuotes) {
+            inBrackets = false;
+        }
+        else if (char === '"' && prevChar !== '\\') {
+            inQuotes = !inQuotes;
+        }
+        else if (char === ',' && !inBrackets && !inQuotes) {
+            result.push(current.trim());
+            current = '';
+            continue;
+        }
+        current += char;
+    }
+    if (current.trim()) {
+        result.push(current.trim());
+    }
+    return result;
+}
+function parseSingleLink(linkString) {
+    const uriMatch = linkString.match(/^<([^>]+)>/);
+    if (!uriMatch) {
+        return null;
+    }
+    const uri = uriMatch[1];
+    const link = { uri };
+    const paramsString = linkString.slice(uriMatch[0].length);
+    const params = parseParameters(paramsString);
+    for (const [key, value] of Object.entries(params)) {
+        link[key] = value;
+    }
+    return link;
+}
+function parseParameters(paramsString) {
+    const params = {};
+    const paramStrings = paramsString.split(/;/).filter(s => s.trim());
+    for (const paramString of paramStrings) {
+        const equalIndex = paramString.indexOf('=');
+        if (equalIndex === -1)
+            continue;
+        const key = paramString.slice(0, equalIndex).trim();
+        let value = paramString.slice(equalIndex + 1).trim();
+        if (value.startsWith('"') && value.endsWith('"')) {
+            value = value.slice(1, -1);
+        }
+        else if (value.startsWith("'") && value.endsWith("'")) {
+            value = value.slice(1, -1);
+        }
+        value = value.replace(/\\(.)/g, '$1');
+        params[key] = value;
+    }
+    return params;
+}
+export const LinkRel = {
+    NEXT: 'next',
+    PREV: 'prev',
+    PREVIOUS: 'previous',
+    FIRST: 'first',
+    LAST: 'last',
+    ALTERNATE: 'alternate',
+    CANONICAL: 'canonical',
+    AUTHOR: 'author',
+    LICENSE: 'license',
+    STYLESHEET: 'stylesheet',
+    ICON: 'icon',
+    PRELOAD: 'preload',
+    PREFETCH: 'prefetch',
+    PRECONNECT: 'preconnect',
+    DNS_PREFETCH: 'dns-prefetch',
+    PRERENDER: 'prerender',
+    SELF: 'self',
+    EDIT: 'edit',
+    COLLECTION: 'collection',
+    ITEM: 'item',
+    HELP: 'help',
+    DESCRIBEDBY: 'describedby',
+    UP: 'up',
+    RELATED: 'related',
+    REPLIES: 'replies',
+    VIA: 'via',
+};
+export class LinkHeaderParser {
+    links;
+    constructor(headerValue) {
+        this.links = parseLink(headerValue);
+    }
+    getAll() {
+        return this.links.all;
+    }
+    getRel(rel) {
+        return this.links[rel];
+    }
+    getFirst(rel) {
+        const links = this.links[rel];
+        if (!links)
+            return undefined;
+        return Array.isArray(links) ? links[0] : links;
+    }
+    has(rel) {
+        return rel in this.links;
+    }
+    getPagination() {
+        return {
+            next: this.getFirst(LinkRel.NEXT)?.uri,
+            prev: this.getFirst(LinkRel.PREV)?.uri || this.getFirst(LinkRel.PREVIOUS)?.uri,
+            first: this.getFirst(LinkRel.FIRST)?.uri,
+            last: this.getFirst(LinkRel.LAST)?.uri,
+        };
+    }
+    hasNext() {
+        return this.has(LinkRel.NEXT);
+    }
+    hasPrev() {
+        return this.has(LinkRel.PREV) || this.has(LinkRel.PREVIOUS);
+    }
+    getCanonical() {
+        return this.getFirst(LinkRel.CANONICAL)?.uri;
+    }
+    getAlternates() {
+        const alts = this.getRel(LinkRel.ALTERNATE);
+        if (!alts)
+            return [];
+        return Array.isArray(alts) ? alts : [alts];
+    }
+    getResourceHints() {
+        const getLinks = (rel) => {
+            const links = this.getRel(rel);
+            if (!links)
+                return [];
+            return Array.isArray(links) ? links : [links];
+        };
+        return {
+            preload: getLinks(LinkRel.PRELOAD),
+            prefetch: getLinks(LinkRel.PREFETCH),
+            preconnect: getLinks(LinkRel.PRECONNECT),
+            dnsPrefetch: getLinks(LinkRel.DNS_PREFETCH),
+        };
+    }
+    toJSON() {
+        return this.links;
+    }
+}
+export function parseLinkHeader(headers) {
+    const linkHeader = headers.get('Link');
+    if (!linkHeader)
+        return null;
+    return new LinkHeaderParser(linkHeader);
+}

package/dist/utils/progress.d.ts

@@ -1,4 +1,9 @@
 import { ProgressEvent, ProgressCallback } from '../types/index.js';
-export declare function createProgressStream(stream: ReadableStream<Uint8Array>, onProgress: ProgressCallback, total?: number): ReadableStream<Uint8Array>;
-export declare function calculateProgress(loaded: number, total?: number): ProgressEvent;
+export interface ProgressStreamOptions {
+    total?: number;
+    direction?: 'upload' | 'download';
+    throttleMs?: number;
+}
+export declare function createProgressStream(stream: ReadableStream<Uint8Array>, onProgress: ProgressCallback, optionsOrTotal?: number | ProgressStreamOptions): ReadableStream<Uint8Array>;
+export declare function calculateProgress(loaded: number, total?: number, direction?: 'upload' | 'download'): ProgressEvent;
 //# sourceMappingURL=progress.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/utils/progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAKpE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,UAAU,EAAE,gBAAgB,EAC5B,KAAK,CAAC,EAAE,MAAM,GACb,cAAc,CAAC,UAAU,CAAC,CA6C5B;AAKD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,CAW/E"}
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/utils/progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEpE,MAAM,WAAW,qBAAqB;IAEpC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,SAAS,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAElC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAeD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,UAAU,EAAE,gBAAgB,EAC5B,cAAc,CAAC,EAAE,MAAM,GAAG,qBAAqB,GAC9C,cAAc,CAAC,UAAU,CAAC,CAgG5B;AAKD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,QAAQ,GAAG,UAAU,GAChC,aAAa,CAaf"}

package/dist/utils/progress.js

@@ -1,31 +1,62 @@
-export function createProgressStream(stream, onProgress, total) {
+export function createProgressStream(stream, onProgress, optionsOrTotal) {
+    const options = typeof optionsOrTotal === 'number'
+        ? { total: optionsOrTotal }
+        : optionsOrTotal || {};
+    const { total, direction, throttleMs = 100 } = options;
     let loaded = 0;
     let startTime = Date.now();
-    let lastUpdate = startTime;
+    let lastUpdate = 0;
+    let lastLoaded = 0;
+    let lastRateUpdate = startTime;
+    let smoothedRate = 0;
+    const rateSmoothingFactor = 0.3;
+    const emitProgress = (now, isFinal) => {
+        const elapsed = (now - startTime) / 1000;
+        const intervalMs = now - lastRateUpdate;
+        const bytesInInterval = loaded - lastLoaded;
+        if (intervalMs > 0) {
+            const instantRate = (bytesInInterval / intervalMs) * 1000;
+            smoothedRate = smoothedRate === 0
+                ? instantRate
+                : smoothedRate * (1 - rateSmoothingFactor) + instantRate * rateSmoothingFactor;
+        }
+        lastLoaded = loaded;
+        lastRateUpdate = now;
+        const rate = smoothedRate;
+        let percent;
+        if (total) {
+            percent = isFinal ? 100 : Math.min((loaded / total) * 100, 99.9);
+        }
+        const progress = {
+            loaded,
+            transferred: loaded,
+            total,
+            percent,
+            rate,
+            estimated: total && rate > 0 ? ((total - loaded) / rate) * 1000 : undefined,
+            direction,
+        };
+        onProgress(progress);
+        lastUpdate = now;
+    };
     return new ReadableStream({
         async start(controller) {
             const reader = stream.getReader();
             try {
+                emitProgress(Date.now(), false);
                 while (true) {
                     const { done, value } = await reader.read();
                     if (done) {
+                        emitProgress(Date.now(), true);
                         controller.close();
                         break;
                     }
                     loaded += value.byteLength;
                     const now = Date.now();
-                    const elapsed = (now - startTime) / 1000;
-                    const rate = elapsed > 0 ? loaded / elapsed : 0;
-                    if (now - lastUpdate > 100 || loaded === total) {
-                        const progress = {
-                            loaded,
-                            total,
-                            percent: total ? (loaded / total) * 100 : undefined,
-                            rate,
-                            estimated: total && rate > 0 ? ((total - loaded) / rate) * 1000 : undefined,
-                        };
-                        onProgress(progress);
-                        lastUpdate = now;
+                    const shouldUpdate = now - lastUpdate >= throttleMs ||
+                        (total && loaded === total);
+                    if (shouldUpdate) {
+                        emitProgress(now, false);
                     }
                     controller.enqueue(value);
                 }
@@ -37,10 +68,12 @@ export function createProgressStream(stream, onProgress, total) {
         },
     });
 }
-export function calculateProgress(loaded, total) {
+export function calculateProgress(loaded, total, direction) {
     const progress = {
         loaded,
+        transferred: loaded,
         total,
+        direction,
     };
     if (total && total > 0) {
         progress.percent = (loaded / total) * 100;

package/dist/utils/rdap.d.ts

@@ -0,0 +1,17 @@
+import { Client } from '../core/client.js';
+export interface RDAPResult {
+    handle?: string;
+    status?: string[];
+    events?: Array<{
+        eventAction: string;
+        eventDate: string;
+    }>;
+    entities?: Array<{
+        handle?: string;
+        roles?: string[];
+        vcardArray?: any[];
+    }>;
+    [key: string]: any;
+}
+export declare function rdap(client: Client, query: string): Promise<RDAPResult>;
+//# sourceMappingURL=rdap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rdap.d.ts","sourceRoot":"","sources":["../../src/utils/rdap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAa3C,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC,CAAC;IAC5E,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAiC7E"}

package/dist/utils/rdap.js

@@ -0,0 +1,32 @@
+const RDAP_SERVERS = {
+    'com': 'https://rdap.verisign.com/com/v1/',
+    'net': 'https://rdap.verisign.com/net/v1/',
+    'org': 'https://rdap.publicinterestregistry.net/rdap/org/',
+    'io': 'https://rdap.nic.io/domain/',
+    'br': 'https://rdap.registro.br/',
+    'default': 'https://rdap.org/domain/'
+};
+export async function rdap(client, query) {
+    const isIp = /^\d+\.\d+\.\d+\.\d+$/.test(query);
+    let url;
+    if (isIp) {
+        url = `https://rdap.arin.net/registry/ip/${query}`;
+    }
+    else {
+        const tld = query.split('.').pop()?.toLowerCase() || '';
+        const base = RDAP_SERVERS[tld] || RDAP_SERVERS['default'];
+        url = base.endsWith('/') ? `${base}domain/${query}` : `${base}/${query}`;
+        if (base.includes('/domain/')) {
+            url = `${base}${query}`;
+        }
+    }
+    try {
+        return await client.get(url, { followRedirects: true }).json();
+    }
+    catch (error) {
+        if (error.status === 404) {
+            throw new Error(`RDAP entry not found for ${query}`);
+        }
+        throw error;
+    }
+}

package/dist/utils/request-pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-pool.d.ts","sourceRoot":"","sources":["../../src/utils/request-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA+C,MAAM,mBAAmB,CAAC;AAEjG,MAAM,WAAW,kBAAkB;IAKjC,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAI7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAiBD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAiB;gBAE1B,OAAO,GAAE,kBAAuB;IAM5C,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAuB9D,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,SAAS;IAqBjB,OAAO,CAAC,SAAS;IA4DjB,YAAY,IAAI,UAAU;CAM3B"}
+{"version":3,"file":"request-pool.d.ts","sourceRoot":"","sources":["../../src/utils/request-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA+C,MAAM,mBAAmB,CAAC;AAGjG,MAAM,WAAW,kBAAkB;IAKjC,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAI7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAiBD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAiB;gBAE1B,OAAO,GAAE,kBAAuB;IAM5C,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAiC9D,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,SAAS;IAqBjB,OAAO,CAAC,SAAS;IAiEjB,YAAY,IAAI,UAAU;CAM3B"}

package/dist/utils/request-pool.js

@@ -1,3 +1,4 @@
+import { ReckerError } from '../core/errors.js';
 export class RequestPool {
     concurrency;
     requestsPerInterval;
@@ -14,14 +15,14 @@ export class RequestPool {
     }
     run(fn, signal) {
         if (signal?.aborted) {
-            return Promise.reject(signal.reason ?? new Error('Request aborted before enqueue'));
+            return Promise.reject(signal.reason ?? new ReckerError('Request aborted before enqueue', undefined, undefined, ['Ensure the AbortSignal is not already aborted when calling the request.', 'Remove or reset the signal before enqueueing.']));
         }
         return new Promise((resolve, reject) => {
             const request = { fn, resolve, reject, signal };
             if (signal) {
                 const onAbort = () => {
                     this._removeFromQueue(request);
-                    reject(signal.reason ?? new Error('Request aborted while queued'));
+                    reject(signal.reason ?? new ReckerError('Request aborted while queued', undefined, undefined, ['Avoid aborting immediately after queuing.', 'Increase timeouts or adjust rate limits if cancellations are unintended.']));
                     this._schedule();
                 };
                 signal.addEventListener('abort', onAbort, { once: true });
@@ -62,7 +63,7 @@ export class RequestPool {
             const request = this.queue.shift();
             if (request.signal?.aborted) {
                 request.abortCleanup?.();
-                request.reject(request.signal.reason ?? new Error('Request aborted while queued'));
+                request.reject(request.signal.reason ?? new ReckerError('Request aborted while queued', undefined, undefined, ['Avoid aborting immediately after queuing.', 'Increase timeouts or adjust rate limits if cancellations are unintended.']));
                 continue;
             }
             this.active++;

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;AAED,wBAAuB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CA4E5E"}
+{"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"}

package/dist/utils/sse.js

@@ -1,6 +1,12 @@
+import { ReckerError } from '../core/errors.js';
 export async function* parseSSE(response) {
-    if (!response.body)
-        throw new Error('Response body is null');
+    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.'
+        ]);
+    }
     const reader = response.body.getReader();
     const decoder = new TextDecoder();
     let buffer = '';

package/dist/utils/status-codes.d.ts

@@ -0,0 +1,84 @@
+export declare enum StatusCode {
+    CONTINUE = 100,
+    SWITCHING_PROTOCOLS = 101,
+    PROCESSING = 102,
+    EARLY_HINTS = 103,
+    OK = 200,
+    CREATED = 201,
+    ACCEPTED = 202,
+    NON_AUTHORITATIVE_INFORMATION = 203,
+    NO_CONTENT = 204,
+    RESET_CONTENT = 205,
+    PARTIAL_CONTENT = 206,
+    MULTI_STATUS = 207,
+    ALREADY_REPORTED = 208,
+    IM_USED = 226,
+    MULTIPLE_CHOICES = 300,
+    MOVED_PERMANENTLY = 301,
+    FOUND = 302,
+    SEE_OTHER = 303,
+    NOT_MODIFIED = 304,
+    USE_PROXY = 305,
+    TEMPORARY_REDIRECT = 307,
+    PERMANENT_REDIRECT = 308,
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    PAYMENT_REQUIRED = 402,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    METHOD_NOT_ALLOWED = 405,
+    NOT_ACCEPTABLE = 406,
+    PROXY_AUTHENTICATION_REQUIRED = 407,
+    REQUEST_TIMEOUT = 408,
+    CONFLICT = 409,
+    GONE = 410,
+    LENGTH_REQUIRED = 411,
+    PRECONDITION_FAILED = 412,
+    PAYLOAD_TOO_LARGE = 413,
+    URI_TOO_LONG = 414,
+    UNSUPPORTED_MEDIA_TYPE = 415,
+    RANGE_NOT_SATISFIABLE = 416,
+    EXPECTATION_FAILED = 417,
+    IM_A_TEAPOT = 418,
+    MISDIRECTED_REQUEST = 421,
+    UNPROCESSABLE_ENTITY = 422,
+    LOCKED = 423,
+    FAILED_DEPENDENCY = 424,
+    TOO_EARLY = 425,
+    UPGRADE_REQUIRED = 426,
+    PRECONDITION_REQUIRED = 428,
+    TOO_MANY_REQUESTS = 429,
+    REQUEST_HEADER_FIELDS_TOO_LARGE = 431,
+    UNAVAILABLE_FOR_LEGAL_REASONS = 451,
+    INTERNAL_SERVER_ERROR = 500,
+    NOT_IMPLEMENTED = 501,
+    BAD_GATEWAY = 502,
+    SERVICE_UNAVAILABLE = 503,
+    GATEWAY_TIMEOUT = 504,
+    HTTP_VERSION_NOT_SUPPORTED = 505,
+    VARIANT_ALSO_NEGOTIATES = 506,
+    INSUFFICIENT_STORAGE = 507,
+    LOOP_DETECTED = 508,
+    NOT_EXTENDED = 510,
+    NETWORK_AUTHENTICATION_REQUIRED = 511
+}
+export declare const STATUS_TEXT: Record<number, string>;
+export declare const status: {
+    isInformational(code: number): boolean;
+    isSuccess(code: number): boolean;
+    isRedirect(code: number): boolean;
+    isClientError(code: number): boolean;
+    isServerError(code: number): boolean;
+    isError(code: number): boolean;
+    isOk(code: number): boolean;
+    getText(code: number): string | undefined;
+    getCategory(code: number): string;
+};
+export declare const statusGroups: {
+    success: readonly [StatusCode.OK, StatusCode.CREATED, StatusCode.ACCEPTED, StatusCode.NO_CONTENT];
+    redirect: readonly [StatusCode.MOVED_PERMANENTLY, StatusCode.FOUND, StatusCode.SEE_OTHER, StatusCode.TEMPORARY_REDIRECT, StatusCode.PERMANENT_REDIRECT];
+    clientError: readonly [StatusCode.BAD_REQUEST, StatusCode.UNAUTHORIZED, StatusCode.FORBIDDEN, StatusCode.NOT_FOUND, StatusCode.METHOD_NOT_ALLOWED, StatusCode.CONFLICT, StatusCode.TOO_MANY_REQUESTS];
+    serverError: readonly [StatusCode.INTERNAL_SERVER_ERROR, StatusCode.BAD_GATEWAY, StatusCode.SERVICE_UNAVAILABLE, StatusCode.GATEWAY_TIMEOUT];
+    retryable: readonly [StatusCode.TOO_MANY_REQUESTS, StatusCode.BAD_GATEWAY, StatusCode.SERVICE_UNAVAILABLE, StatusCode.GATEWAY_TIMEOUT];
+};
+//# sourceMappingURL=status-codes.d.ts.map

package/dist/utils/status-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-codes.d.ts","sourceRoot":"","sources":["../../src/utils/status-codes.ts"],"names":[],"mappings":"AAUA,oBAAY,UAAU;IAEpB,QAAQ,MAAM;IACd,mBAAmB,MAAM;IACzB,UAAU,MAAM;IAChB,WAAW,MAAM;IAGjB,EAAE,MAAM;IACR,OAAO,MAAM;IACb,QAAQ,MAAM;IACd,6BAA6B,MAAM;IACnC,UAAU,MAAM;IAChB,aAAa,MAAM;IACnB,eAAe,MAAM;IACrB,YAAY,MAAM;IAClB,gBAAgB,MAAM;IACtB,OAAO,MAAM;IAGb,gBAAgB,MAAM;IACtB,iBAAiB,MAAM;IACvB,KAAK,MAAM;IACX,SAAS,MAAM;IACf,YAAY,MAAM;IAClB,SAAS,MAAM;IACf,kBAAkB,MAAM;IACxB,kBAAkB,MAAM;IAGxB,WAAW,MAAM;IACjB,YAAY,MAAM;IAClB,gBAAgB,MAAM;IACtB,SAAS,MAAM;IACf,SAAS,MAAM;IACf,kBAAkB,MAAM;IACxB,cAAc,MAAM;IACpB,6BAA6B,MAAM;IACnC,eAAe,MAAM;IACrB,QAAQ,MAAM;IACd,IAAI,MAAM;IACV,eAAe,MAAM;IACrB,mBAAmB,MAAM;IACzB,iBAAiB,MAAM;IACvB,YAAY,MAAM;IAClB,sBAAsB,MAAM;IAC5B,qBAAqB,MAAM;IAC3B,kBAAkB,MAAM;IACxB,WAAW,MAAM;IACjB,mBAAmB,MAAM;IACzB,oBAAoB,MAAM;IAC1B,MAAM,MAAM;IACZ,iBAAiB,MAAM;IACvB,SAAS,MAAM;IACf,gBAAgB,MAAM;IACtB,qBAAqB,MAAM;IAC3B,iBAAiB,MAAM;IACvB,+BAA+B,MAAM;IACrC,6BAA6B,MAAM;IAGnC,qBAAqB,MAAM;IAC3B,eAAe,MAAM;IACrB,WAAW,MAAM;IACjB,mBAAmB,MAAM;IACzB,eAAe,MAAM;IACrB,0BAA0B,MAAM;IAChC,uBAAuB,MAAM;IAC7B,oBAAoB,MAAM;IAC1B,aAAa,MAAM;IACnB,YAAY,MAAM;IAClB,+BAA+B,MAAM;CACtC;AAKD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwE9C,CAAC;AAKF,eAAO,MAAM,MAAM;0BAIK,MAAM,GAAG,OAAO;oBAOtB,MAAM,GAAG,OAAO;qBAOf,MAAM,GAAG,OAAO;wBAOb,MAAM,GAAG,OAAO;wBAOhB,MAAM,GAAG,OAAO;kBAOtB,MAAM,GAAG,OAAO;eAQnB,MAAM,GAAG,OAAO;kBAOb,MAAM,GAAG,MAAM,GAAG,SAAS;sBAOvB,MAAM,GAAG,MAAM;CAQlC,CAAC;AAKF,eAAO,MAAM,YAAY;;;;;;CAsDxB,CAAC"}