@private.me/xbind 1.3.5 → 3.0.0

package/dist-standalone/http-compat.js

@@ -1,267 +1 @@
-/**
- * @module http-compat
- * HTTP client compatibility adapters for xBind auto-upgrade
- *
- * Provides drop-in replacements for popular HTTP clients (fetch, axios, got)
- * that transparently upgrade to xBind when both parties support it.
- */
-import { xfetch } from './xfetch.js';
-/**
- * Create axios-compatible HTTP client with xBind auto-upgrade
- *
- * Drop-in replacement for axios that transparently upgrades to xBind.
- *
- * @returns Axios-compatible client
- *
- * @example
- * ```typescript
- * import { createAxiosCompat } from '@private.me/xbind/http-compat';
- *
- * const axios = createAxiosCompat();
- *
- * // Auto-upgrades to xBind if supported
- * const response = await axios.get('https://api.example.com/data');
- * console.log('Used xBind?', response.xbind?.used);
- * console.log('Data:', response.data);
- * ```
- */
-export function createAxiosCompat() {
-    async function request(config) {
-        // Normalize config
-        const cfg = typeof config === 'string' ? { url: config } : config;
-        const method = cfg.method?.toUpperCase() ?? 'GET';
-        const url = cfg.baseURL
-            ? new URL(cfg.url ?? '', cfg.baseURL).toString()
-            : cfg.url ?? '';
-        // Build headers
-        const headers = { ...cfg.headers };
-        // Build URL with query params
-        let finalUrl = url;
-        if (cfg.params) {
-            const params = new URLSearchParams();
-            for (const [key, value] of Object.entries(cfg.params)) {
-                params.append(key, String(value));
-            }
-            finalUrl = `${url}?${params.toString()}`;
-        }
-        // Build request body
-        let body;
-        if (cfg.data) {
-            if (typeof cfg.data === 'string') {
-                body = cfg.data;
-            }
-            else {
-                body = JSON.stringify(cfg.data);
-                headers['Content-Type'] = 'application/json';
-            }
-        }
-        // Convert to xfetch options
-        const xfetchOpts = {
-            method,
-            headers,
-            body,
-            timeout: cfg.timeout,
-            forceXBind: cfg.forceXBind,
-            disableXBind: cfg.disableXBind,
-        };
-        // Make request via xfetch
-        const response = await xfetch(finalUrl, xfetchOpts);
-        // Parse response body based on responseType
-        let data;
-        const responseType = cfg.responseType ?? 'json';
-        switch (responseType) {
-            case 'json':
-                data = (await response.json());
-                break;
-            case 'text':
-                data = (await response.text());
-                break;
-            case 'blob':
-                data = (await response.blob());
-                break;
-            case 'arraybuffer':
-                data = (await response.arrayBuffer());
-                break;
-            default:
-                data = (await response.json());
-        }
-        // Validate status if custom validator provided
-        if (cfg.validateStatus && !cfg.validateStatus(response.status)) {
-            throw new Error(`Request failed with status ${response.status}`);
-        }
-        // Convert headers to object
-        const responseHeaders = {};
-        response.headers.forEach((value, key) => {
-            responseHeaders[key] = value;
-        });
-        return {
-            data,
-            status: response.status,
-            statusText: response.statusText,
-            headers: responseHeaders,
-            config: cfg,
-            xbind: {
-                used: response.usedXBind,
-                protocol: response.transport.protocol,
-                latency: response.transport.latency,
-                peerDID: response.transport.peerDID,
-            },
-        };
-    }
-    // Convenience methods
-    async function get(url, config) {
-        return request({ ...config, url, method: 'GET' });
-    }
-    async function post(url, data, config) {
-        return request({ ...config, url, method: 'POST', data });
-    }
-    async function put(url, data, config) {
-        return request({ ...config, url, method: 'PUT', data });
-    }
-    async function patch(url, data, config) {
-        return request({ ...config, url, method: 'PATCH', data });
-    }
-    async function del(url, config) {
-        return request({ ...config, url, method: 'DELETE' });
-    }
-    return {
-        request,
-        get,
-        post,
-        put,
-        patch,
-        delete: del,
-    };
-}
-/**
- * Create got-compatible HTTP client with xBind auto-upgrade
- *
- * Drop-in replacement for got that transparently upgrades to xBind.
- *
- * @returns Got-compatible client
- *
- * @example
- * ```typescript
- * import { createGotCompat } from '@private.me/xbind/http-compat';
- *
- * const got = createGotCompat();
- *
- * // Auto-upgrades to xBind if supported
- * const response = await got('https://api.example.com/data', {
- *   responseType: 'json',
- * });
- * console.log('Used xBind?', response.xbind?.used);
- * console.log('Body:', response.body);
- * ```
- */
-export function createGotCompat() {
-    async function got(url, options) {
-        // Normalize options
-        const opts = typeof url === 'string' ? { ...options, url } : url;
-        const method = opts.method?.toUpperCase() ?? 'GET';
-        const finalUrl = opts.url ?? '';
-        // Build headers
-        const headers = { ...opts.headers };
-        // Build URL with search params
-        let urlWithParams = finalUrl;
-        if (opts.searchParams) {
-            const params = new URLSearchParams();
-            for (const [key, value] of Object.entries(opts.searchParams)) {
-                params.append(key, String(value));
-            }
-            urlWithParams = `${finalUrl}?${params.toString()}`;
-        }
-        // Build request body
-        let body;
-        if (opts.json) {
-            body = JSON.stringify(opts.json);
-            headers['Content-Type'] = 'application/json';
-        }
-        else if (opts.body) {
-            // Convert Buffer to string for compatibility with xfetch
-            // SAFETY: After instanceof check, both branches produce string type
-            body = (opts.body instanceof Buffer ? opts.body.toString() : opts.body);
-        }
-        // Extract timeout
-        const timeout = typeof opts.timeout === 'number'
-            ? opts.timeout
-            : opts.timeout?.request;
-        // Convert to xfetch options
-        const xfetchOpts = {
-            method,
-            headers,
-            body,
-            timeout,
-            forceXBind: opts.forceXBind,
-            disableXBind: opts.disableXBind,
-        };
-        // Make request via xfetch
-        const response = await xfetch(urlWithParams, xfetchOpts);
-        // Parse response body based on responseType
-        let responseBody;
-        const responseType = opts.responseType ?? 'text';
-        switch (responseType) {
-            case 'json':
-                responseBody = (await response.json());
-                break;
-            case 'text':
-                responseBody = (await response.text());
-                break;
-            case 'buffer':
-                const arrayBuffer = await response.arrayBuffer();
-                responseBody = Buffer.from(arrayBuffer);
-                break;
-            default:
-                responseBody = (await response.text());
-        }
-        // Convert headers to object
-        const responseHeaders = {};
-        response.headers.forEach((value, key) => {
-            responseHeaders[key] = value;
-        });
-        return {
-            body: responseBody,
-            statusCode: response.status,
-            headers: responseHeaders,
-            url: response.url,
-            requestUrl: urlWithParams,
-            xbind: {
-                used: response.usedXBind,
-                protocol: response.transport.protocol,
-                latency: response.transport.latency,
-                peerDID: response.transport.peerDID,
-            },
-        };
-    }
-    // Convenience methods
-    got.get = (url, options) => got(url, { ...options, method: 'GET' });
-    got.post = (url, options) => got(url, { ...options, method: 'POST' });
-    got.put = (url, options) => got(url, { ...options, method: 'PUT' });
-    got.patch = (url, options) => got(url, { ...options, method: 'PATCH' });
-    got.delete = (url, options) => got(url, { ...options, method: 'DELETE' });
-    return got;
-}
-/**
- * Wrap existing fetch implementation with xBind auto-upgrade
- *
- * Use this to upgrade an existing fetch instance (like node-fetch, cross-fetch, etc.)
- *
- * @param fetchImpl - Fetch implementation to wrap
- * @returns Wrapped fetch with xBind support
- *
- * @example
- * ```typescript
- * import { wrapFetch } from '@private.me/xbind/http-compat';
- * import nodeFetch from 'node-fetch';
- *
- * const fetch = wrapFetch(nodeFetch);
- *
- * // Uses xBind if supported, falls back to node-fetch
- * const response = await fetch('https://api.example.com/data');
- * ```
- */
-export function wrapFetch(fetchImpl) {
-    // Return xfetch (which already handles auto-upgrade and fallback)
-    // The original fetchImpl is not used because xfetch uses global fetch
-    return xfetch;
-}
+import{xfetch}from"./xfetch.js";export function createAxiosCompat(){async function t(t){const e="string"==typeof t?{url:t}:t,a=e.method?.toUpperCase()??"GET",r=e.baseURL?new URL(e.url??"",e.baseURL).toString():e.url??"",o={...e.headers};let n,s=r;if(e.params){const t=new URLSearchParams;for(const[a,r]of Object.entries(e.params))t.append(a,String(r));s=`${r}?${t.toString()}`}e.data&&("string"==typeof e.data?n=e.data:(n=JSON.stringify(e.data),o["Content-Type"]="application/json"));const i={method:a,headers:o,body:n,timeout:e.timeout,forceXBind:e.forceXBind,disableXBind:e.disableXBind},c=await xfetch(s,i);let u;switch(e.responseType??"json"){case"json":default:u=await c.json();break;case"text":u=await c.text();break;case"blob":u=await c.blob();break;case"arraybuffer":u=await c.arrayBuffer()}if(e.validateStatus&&!e.validateStatus(c.status))throw new Error(`Request failed with status ${c.status}`);const d={};return c.headers.forEach((t,e)=>{d[e]=t}),{data:u,status:c.status,statusText:c.statusText,headers:d,config:e,xbind:{used:c.usedXBind,protocol:c.transport.protocol,latency:c.transport.latency,peerDID:c.transport.peerDID}}}return{request:t,get:async function(e,a){return t({...a,url:e,method:"GET"})},post:async function(e,a,r){return t({...r,url:e,method:"POST",data:a})},put:async function(e,a,r){return t({...r,url:e,method:"PUT",data:a})},patch:async function(e,a,r){return t({...r,url:e,method:"PATCH",data:a})},delete:async function(e,a){return t({...a,url:e,method:"DELETE"})}}}export function createGotCompat(){async function t(t,e){const a="string"==typeof t?{...e,url:t}:t,r=a.method?.toUpperCase()??"GET",o=a.url??"",n={...a.headers};let s,i=o;if(a.searchParams){const t=new URLSearchParams;for(const[e,r]of Object.entries(a.searchParams))t.append(e,String(r));i=`${o}?${t.toString()}`}a.json?(s=JSON.stringify(a.json),n["Content-Type"]="application/json"):a.body&&(s=a.body instanceof Buffer?a.body.toString():a.body);const c={method:r,headers:n,body:s,timeout:"number"==typeof a.timeout?a.timeout:a.timeout?.request,forceXBind:a.forceXBind,disableXBind:a.disableXBind},u=await xfetch(i,c);let d;switch(a.responseType??"text"){case"json":d=await u.json();break;case"text":default:d=await u.text();break;case"buffer":const t=await u.arrayBuffer();d=Buffer.from(t)}const f={};return u.headers.forEach((t,e)=>{f[e]=t}),{body:d,statusCode:u.status,headers:f,url:u.url,requestUrl:i,xbind:{used:u.usedXBind,protocol:u.transport.protocol,latency:u.transport.latency,peerDID:u.transport.peerDID}}}return t.get=(e,a)=>t(e,{...a,method:"GET"}),t.post=(e,a)=>t(e,{...a,method:"POST"}),t.put=(e,a)=>t(e,{...a,method:"PUT"}),t.patch=(e,a)=>t(e,{...a,method:"PATCH"}),t.delete=(e,a)=>t(e,{...a,method:"DELETE"}),t}export function wrapFetch(){return xfetch}