@stryke/http 0.8.5 → 0.10.0

package/dist/index.d.ts

@@ -1,3 +1,8 @@
-export * from "./cookie";
+export * from "./agent";
+export * from "./fetch";
 export * from "./format-data-uri";
-export * from "./types";
+export * from "./get-free-port";
+export * from "./http-proxy";
+export * from "./https-proxy";
+export * from "./parse-response";
+export * from "./proxy-agent";

package/dist/index.mjs

@@ -1 +1 @@
-export*from"./cookie";export*from"./format-data-uri";export*from"./types";
+export*from"./agent";export*from"./fetch";export*from"./format-data-uri";export*from"./get-free-port";export*from"./http-proxy";export*from"./https-proxy";export*from"./parse-response";export*from"./proxy-agent";

package/dist/parse-response.cjs

@@ -0,0 +1,63 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.parseProxyResponse = parseProxyResponse;
+var _nodeBuffer = require("node:buffer");
+async function parseProxyResponse(e) {
+  return new Promise((g, o) => {
+    let p = 0;
+    const m = [];
+    function t() {
+      const r = e.read();
+      r ? v(r) : e.once("readable", t);
+    }
+    function f() {
+      e.removeListener("end", l), e.removeListener("error", y), e.removeListener("readable", t);
+    }
+    function l() {
+      f(), o(new Error("Proxy connection ended before receiving CONNECT response"));
+    }
+    function y(r) {
+      f(), o(r);
+    }
+    function v(r) {
+      m.push(r), p += r.length;
+      const a = _nodeBuffer.Buffer.concat(m, p),
+        h = a.indexOf(`\r
+\r
+`);
+      if (h === -1) {
+        t();
+        return;
+      }
+      const C = a.subarray(0, h).toString("ascii").split(`\r
+`),
+        b = C.shift();
+      if (!b) return e.destroy(), o(new Error("No header received from proxy CONNECT response"));
+      const x = b.split(" "),
+        E = +x[1],
+        H = x.slice(2).join(" "),
+        s = {};
+      for (const n of C) {
+        if (!n) continue;
+        const c = n.indexOf(":");
+        if (c === -1) return e.destroy(), o(new Error(`Invalid header from proxy CONNECT response: "${n}"`));
+        const d = n.slice(0, c).toLowerCase(),
+          u = n.slice(c + 1).trimStart(),
+          i = s[d];
+        typeof i == "string" ? s[d] = [i, u] : Array.isArray(i) ? i.push(u) : s[d] = u;
+      }
+      f(), g({
+        connect: {
+          statusCode: E,
+          statusText: H,
+          headers: s
+        },
+        buffered: a
+      });
+    }
+    e.on("error", y), e.on("end", l), t();
+  });
+}

package/dist/parse-response.d.ts

@@ -0,0 +1,12 @@
+import { Buffer } from "node:buffer";
+import type { IncomingHttpHeaders } from "node:http";
+import type { Readable } from "node:stream";
+export interface ConnectResponse {
+    statusCode: number;
+    statusText: string;
+    headers: IncomingHttpHeaders;
+}
+export declare function parseProxyResponse(socket: Readable): Promise<{
+    connect: ConnectResponse;
+    buffered: Buffer;
+}>;

package/dist/parse-response.mjs

@@ -0,0 +1,4 @@
+import{Buffer as L}from"node:buffer";export async function parseProxyResponse(e){return new Promise((g,o)=>{let p=0;const m=[];function t(){const r=e.read();r?v(r):e.once("readable",t)}function f(){e.removeListener("end",l),e.removeListener("error",y),e.removeListener("readable",t)}function l(){f(),o(new Error("Proxy connection ended before receiving CONNECT response"))}function y(r){f(),o(r)}function v(r){m.push(r),p+=r.length;const a=L.concat(m,p),h=a.indexOf(`\r
+\r
+`);if(h===-1){t();return}const C=a.subarray(0,h).toString("ascii").split(`\r
+`),b=C.shift();if(!b)return e.destroy(),o(new Error("No header received from proxy CONNECT response"));const x=b.split(" "),E=+x[1],H=x.slice(2).join(" "),s={};for(const n of C){if(!n)continue;const c=n.indexOf(":");if(c===-1)return e.destroy(),o(new Error(`Invalid header from proxy CONNECT response: "${n}"`));const d=n.slice(0,c).toLowerCase(),u=n.slice(c+1).trimStart(),i=s[d];typeof i=="string"?s[d]=[i,u]:Array.isArray(i)?i.push(u):s[d]=u}f(),g({connect:{statusCode:E,statusText:H,headers:s},buffered:a})}e.on("error",y),e.on("end",l),t()})}

package/dist/proxy-agent.cjs

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getProxyAgent = getProxyAgent;
+var _httpProxy = require("./http-proxy.cjs");
+var _httpsProxy = require("./https-proxy.cjs");
+function getProxyAgent() {
+  const t = process.env.https_proxy || process.env.HTTPS_PROXY;
+  if (t) return new _httpsProxy.HttpsProxyAgent(t);
+  const e = process.env.http_proxy || process.env.HTTP_PROXY;
+  if (e) return new _httpProxy.HttpProxyAgent(e);
+}

package/dist/proxy-agent.d.ts

@@ -0,0 +1,5 @@
+import type { Agent } from "node:https";
+/**
+ * If the http(s)_proxy environment variables is set, return a proxy agent.
+ */
+export declare function getProxyAgent(): Agent | undefined;

package/dist/proxy-agent.mjs

@@ -0,0 +1 @@
+import{HttpProxyAgent as r}from"./http-proxy";import{HttpsProxyAgent as n}from"./https-proxy";export function getProxyAgent(){const t=process.env.https_proxy||process.env.HTTPS_PROXY;if(t)return new n(t);const e=process.env.http_proxy||process.env.HTTP_PROXY;if(e)return new r(e)}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stryke/http",
-  "version": "0.8.5",
+  "version": "0.10.0",
   "type": "module",
   "description": "A package containing HTTP communication utilities used by Storm Software.",
   "repository": {
@@ -11,7 +11,7 @@
   "private": false,
   "devDependencies": { "@types/node": "^22.14.0" },
   "publishConfig": { "access": "public" },
-  "dependencies": { "@stryke/type-checks": "^0.3.6" },
+  "dependencies": { "@stryke/type-checks": "^0.3.10" },
   "sideEffects": false,
   "files": ["dist/**/*"],
   "homepage": "https://stormsoftware.com",
@@ -55,13 +55,33 @@
     }
   ],
   "exports": {
-    "./types": {
-      "import": { "types": "./dist/types.d.ts", "default": "./dist/types.mjs" },
+    "./proxy-agent": {
+      "import": {
+        "types": "./dist/proxy-agent.d.ts",
+        "default": "./dist/proxy-agent.mjs"
+      },
       "require": {
-        "types": "./dist/types.d.ts",
-        "default": "./dist/types.cjs"
+        "types": "./dist/proxy-agent.d.ts",
+        "default": "./dist/proxy-agent.cjs"
       },
-      "default": { "types": "./dist/types.d.ts", "default": "./dist/types.mjs" }
+      "default": {
+        "types": "./dist/proxy-agent.d.ts",
+        "default": "./dist/proxy-agent.mjs"
+      }
+    },
+    "./parse-response": {
+      "import": {
+        "types": "./dist/parse-response.d.ts",
+        "default": "./dist/parse-response.mjs"
+      },
+      "require": {
+        "types": "./dist/parse-response.d.ts",
+        "default": "./dist/parse-response.cjs"
+      },
+      "default": {
+        "types": "./dist/parse-response.d.ts",
+        "default": "./dist/parse-response.mjs"
+      }
     },
     "./index": {
       "import": { "types": "./dist/index.d.ts", "default": "./dist/index.mjs" },
@@ -71,6 +91,48 @@
       },
       "default": { "types": "./dist/index.d.ts", "default": "./dist/index.mjs" }
     },
+    "./https-proxy": {
+      "import": {
+        "types": "./dist/https-proxy.d.ts",
+        "default": "./dist/https-proxy.mjs"
+      },
+      "require": {
+        "types": "./dist/https-proxy.d.ts",
+        "default": "./dist/https-proxy.cjs"
+      },
+      "default": {
+        "types": "./dist/https-proxy.d.ts",
+        "default": "./dist/https-proxy.mjs"
+      }
+    },
+    "./http-proxy": {
+      "import": {
+        "types": "./dist/http-proxy.d.ts",
+        "default": "./dist/http-proxy.mjs"
+      },
+      "require": {
+        "types": "./dist/http-proxy.d.ts",
+        "default": "./dist/http-proxy.cjs"
+      },
+      "default": {
+        "types": "./dist/http-proxy.d.ts",
+        "default": "./dist/http-proxy.mjs"
+      }
+    },
+    "./get-free-port": {
+      "import": {
+        "types": "./dist/get-free-port.d.ts",
+        "default": "./dist/get-free-port.mjs"
+      },
+      "require": {
+        "types": "./dist/get-free-port.d.ts",
+        "default": "./dist/get-free-port.cjs"
+      },
+      "default": {
+        "types": "./dist/get-free-port.d.ts",
+        "default": "./dist/get-free-port.mjs"
+      }
+    },
     "./format-data-uri": {
       "import": {
         "types": "./dist/format-data-uri.d.ts",
@@ -85,19 +147,21 @@
         "default": "./dist/format-data-uri.mjs"
       }
     },
-    "./cookie": {
-      "import": {
-        "types": "./dist/cookie.d.ts",
-        "default": "./dist/cookie.mjs"
+    "./fetch": {
+      "import": { "types": "./dist/fetch.d.ts", "default": "./dist/fetch.mjs" },
+      "require": {
+        "types": "./dist/fetch.d.ts",
+        "default": "./dist/fetch.cjs"
       },
+      "default": { "types": "./dist/fetch.d.ts", "default": "./dist/fetch.mjs" }
+    },
+    "./agent": {
+      "import": { "types": "./dist/agent.d.ts", "default": "./dist/agent.mjs" },
       "require": {
-        "types": "./dist/cookie.d.ts",
-        "default": "./dist/cookie.cjs"
+        "types": "./dist/agent.d.ts",
+        "default": "./dist/agent.cjs"
       },
-      "default": {
-        "types": "./dist/cookie.d.ts",
-        "default": "./dist/cookie.mjs"
-      }
+      "default": { "types": "./dist/agent.d.ts", "default": "./dist/agent.mjs" }
     },
     ".": {
       "import": { "types": "./dist/index.d.ts", "default": "./dist/index.mjs" },
@@ -112,5 +176,5 @@
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
-  "gitHead": "57da58e3434302b35f798674d9f18f92ca7f7ac9"
+  "gitHead": "4074c4a56f6e2c42ca4c39c30df5309c19024c7b"
 }

package/dist/cookie.cjs

@@ -1,187 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.parseCookie = parseCookie;
-exports.parseSetCookie = parseSetCookie;
-exports.serializeCookie = serializeCookie;
-exports.splitSetCookieString = splitSetCookieString;
-var _typeChecks = require("@stryke/type-checks");
-function parseCookie(r, c) {
-  if (!(0, _typeChecks.isString)(r)) throw new Error("argument str must be a string");
-  const i = {},
-    e = c ?? {},
-    o = e.decode ?? (t => t.includes("%") ? decodeURIComponent(t) : t);
-  let a = 0;
-  for (; a < r.length;) {
-    const t = r.indexOf("=", a);
-    if (t === -1) break;
-    let n = r.indexOf(";", a);
-    if (n === -1) n = r.length;else if (n < t) {
-      a = r.lastIndexOf(";", t - 1) + 1;
-      continue;
-    }
-    const s = r.slice(a, t).trim();
-    if (e?.filter && !e?.filter(s)) {
-      a = n + 1;
-      continue;
-    }
-    if (i[s] === void 0) {
-      let l = r.slice(t + 1, n).trim();
-      l.codePointAt(0) === 34 && (l = l.slice(1, -1));
-      try {
-        i[s] = o(l);
-      } catch {
-        i[s] = l;
-      }
-    }
-    a = n + 1;
-  }
-  return i;
-}
-function parseSetCookie(r, c) {
-  const i = (r || "").split(";").filter(s => (0, _typeChecks.isString)(s) && !!s.trim()),
-    e = i.shift() || "";
-  let o = "",
-    a = "";
-  const t = e.split("=");
-  t.length > 1 ? (o = t.shift(), a = t.join("=")) : a = e;
-  try {
-    a = c?.decode === !1 ? a : (c?.decode ?? decodeURIComponent)(a);
-  } catch {}
-  const n = {
-    name: o,
-    value: a
-  };
-  for (const s of i) {
-    const l = s.split("="),
-      f = (l.shift() || "").trimStart().toLowerCase(),
-      m = l.join("=");
-    switch (f) {
-      case "expires":
-        {
-          n.expires = new Date(m);
-          break;
-        }
-      case "max-age":
-        {
-          n.maxAge = Number.parseInt(m, 10);
-          break;
-        }
-      case "secure":
-        {
-          n.secure = !0;
-          break;
-        }
-      case "httponly":
-        {
-          n.httpOnly = !0;
-          break;
-        }
-      case "samesite":
-        {
-          n.sameSite = m;
-          break;
-        }
-      default:
-        n[f] = m;
-    }
-  }
-  return n;
-}
-const u = /^[\t\u0020-\u007E\u0080-\u00FF]+$/;
-function serializeCookie(r, c, i) {
-  const e = i ?? {},
-    o = e.encode ?? encodeURIComponent;
-  if (!(0, _typeChecks.isFunction)(o)) throw new Error("option encode is invalid");
-  if (!u.test(r)) throw new Error("argument name is invalid");
-  const a = o(c);
-  if (a && !u.test(a)) throw new Error("argument val is invalid");
-  let t = `${r}=${a}`;
-  if (!(0, _typeChecks.isSet)(e.maxAge)) {
-    const n = Number(e.maxAge);
-    if (Number.isNaN(n) || !Number.isFinite(n)) throw new TypeError("option maxAge is invalid");
-    t += `; Max-Age=${Math.floor(n)}`;
-  }
-  if (e.domain) {
-    if (!u.test(e.domain)) throw new Error("option domain is invalid");
-    t += `; Domain=${e.domain}`;
-  }
-  if (e.path) {
-    if (!u.test(e.path)) throw new Error("option path is invalid");
-    t += `; Path=${e.path}`;
-  }
-  if (e.expires) {
-    if (!(0, _typeChecks.isDate)(e.expires) || Number.isNaN(e.expires.valueOf())) throw new Error("option expires is invalid");
-    t += `; Expires=${e.expires.toUTCString()}`;
-  }
-  if (e.httpOnly && (t += "; HttpOnly"), e.secure && (t += "; Secure"), e.priority) switch ((0, _typeChecks.isString)(e.priority) ? e.priority.toLowerCase() : e.priority) {
-    case "low":
-      {
-        t += "; Priority=Low";
-        break;
-      }
-    case "medium":
-      {
-        t += "; Priority=Medium";
-        break;
-      }
-    case "high":
-      {
-        t += "; Priority=High";
-        break;
-      }
-    default:
-      throw new Error("option priority is invalid");
-  }
-  if (e.sameSite) switch ((0, _typeChecks.isString)(e.sameSite) ? e.sameSite.toLowerCase() : e.sameSite) {
-    case !0:
-      {
-        t += "; SameSite=Strict";
-        break;
-      }
-    case "lax":
-      {
-        t += "; SameSite=Lax";
-        break;
-      }
-    case "strict":
-      {
-        t += "; SameSite=Strict";
-        break;
-      }
-    case "none":
-      {
-        t += "; SameSite=None";
-        break;
-      }
-    default:
-      throw new Error("option sameSite is invalid");
-  }
-  return e.partitioned && (t += "; Partitioned"), t;
-}
-function splitSetCookieString(r) {
-  if (Array.isArray(r)) return r.flatMap(f => splitSetCookieString(f));
-  if (!(0, _typeChecks.isString)(r)) return [];
-  const c = [];
-  let i = 0,
-    e,
-    o,
-    a,
-    t,
-    n;
-  const s = () => {
-      for (; i < r.length && /\s/.test(r.charAt(i));) i += 1;
-      return i < r.length;
-    },
-    l = () => (o = r.charAt(i), o !== "=" && o !== ";" && o !== ",");
-  for (; i < r.length;) {
-    for (e = i, n = !1; s();) if (o = r.charAt(i), o === ",") {
-      for (a = i, i += 1, s(), t = i; i < r.length && l();) i += 1;
-      i < r.length && r.charAt(i) === "=" ? (n = !0, i = t, c.push(r.slice(e, a)), e = i) : i = a + 1;
-    } else i += 1;
-    (!n || i >= r.length) && c.push(r.slice(e));
-  }
-  return c;
-}

package/dist/cookie.d.ts

@@ -1,37 +0,0 @@
-import type { CookieParseOptions, CookieSerializeOptions, SetCookie, SetCookieParseOptions } from "./types";
-/**
- * Parse an HTTP Cookie header string and returning an object of all cookie
- * name-value pairs.
- *
- * @param strCookie - the string representing a `Cookie` header value
- * @param options - object containing parsing options
- * @returns an object with the parsed cookies
- */
-export declare function parseCookie(strCookie: string, options?: CookieParseOptions): Record<string, string>;
-/**
- * Parse a [Set-Cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie) header string into an object.
- *
- * @param setCookieValue - the string representing a `Set-Cookie` header value
- * @param options - object containing parsing options
- * @returns an object with the parsed cookie
- */
-export declare function parseSetCookie(setCookieValue: string, options?: SetCookieParseOptions): SetCookie;
-/**
- * Serialize a cookie name-value pair into a `Set-Cookie` header string.
- *
- * @param name - the name for the cookie
- * @param value - value to set the cookie to
- * @param options - object containing serialization options
- * @returns a `Set-Cookie` header string
- */
-export declare function serializeCookie(name: string, value: string, options?: CookieSerializeOptions): string;
-/**
- * Set-Cookie header field-values are sometimes comma joined in one string. This splits them without choking on commas
- * that are within a single set-cookie field-value, such as in the Expires portion.
- *
- * See https://tools.ietf.org/html/rfc2616#section-4.2
- *
- * @param strCookie - The string representing a `Set-Cookie` header value
- * @returns An array of strings representing individual `Set-Cookie` header values
- */
-export declare function splitSetCookieString(strCookie: string | string[]): string[];

package/dist/cookie.mjs

@@ -1 +0,0 @@
-import{isDate as h,isFunction as d,isSet as g,isString as p}from"@stryke/type-checks";export function parseCookie(r,c){if(!p(r))throw new Error("argument str must be a string");const i={},e=c??{},o=e.decode??(t=>t.includes("%")?decodeURIComponent(t):t);let a=0;for(;a<r.length;){const t=r.indexOf("=",a);if(t===-1)break;let n=r.indexOf(";",a);if(n===-1)n=r.length;else if(n<t){a=r.lastIndexOf(";",t-1)+1;continue}const s=r.slice(a,t).trim();if(e?.filter&&!e?.filter(s)){a=n+1;continue}if(i[s]===void 0){let l=r.slice(t+1,n).trim();l.codePointAt(0)===34&&(l=l.slice(1,-1));try{i[s]=o(l)}catch{i[s]=l}}a=n+1}return i}export function parseSetCookie(r,c){const i=(r||"").split(";").filter(s=>p(s)&&!!s.trim()),e=i.shift()||"";let o="",a="";const t=e.split("=");t.length>1?(o=t.shift(),a=t.join("=")):a=e;try{a=c?.decode===!1?a:(c?.decode??decodeURIComponent)(a)}catch{}const n={name:o,value:a};for(const s of i){const l=s.split("="),f=(l.shift()||"").trimStart().toLowerCase(),m=l.join("=");switch(f){case"expires":{n.expires=new Date(m);break}case"max-age":{n.maxAge=Number.parseInt(m,10);break}case"secure":{n.secure=!0;break}case"httponly":{n.httpOnly=!0;break}case"samesite":{n.sameSite=m;break}default:n[f]=m}}return n}const u=/^[\t\u0020-\u007E\u0080-\u00FF]+$/;export function serializeCookie(r,c,i){const e=i??{},o=e.encode??encodeURIComponent;if(!d(o))throw new Error("option encode is invalid");if(!u.test(r))throw new Error("argument name is invalid");const a=o(c);if(a&&!u.test(a))throw new Error("argument val is invalid");let t=`${r}=${a}`;if(!g(e.maxAge)){const n=Number(e.maxAge);if(Number.isNaN(n)||!Number.isFinite(n))throw new TypeError("option maxAge is invalid");t+=`; Max-Age=${Math.floor(n)}`}if(e.domain){if(!u.test(e.domain))throw new Error("option domain is invalid");t+=`; Domain=${e.domain}`}if(e.path){if(!u.test(e.path))throw new Error("option path is invalid");t+=`; Path=${e.path}`}if(e.expires){if(!h(e.expires)||Number.isNaN(e.expires.valueOf()))throw new Error("option expires is invalid");t+=`; Expires=${e.expires.toUTCString()}`}if(e.httpOnly&&(t+="; HttpOnly"),e.secure&&(t+="; Secure"),e.priority)switch(p(e.priority)?e.priority.toLowerCase():e.priority){case"low":{t+="; Priority=Low";break}case"medium":{t+="; Priority=Medium";break}case"high":{t+="; Priority=High";break}default:throw new Error("option priority is invalid")}if(e.sameSite)switch(p(e.sameSite)?e.sameSite.toLowerCase():e.sameSite){case!0:{t+="; SameSite=Strict";break}case"lax":{t+="; SameSite=Lax";break}case"strict":{t+="; SameSite=Strict";break}case"none":{t+="; SameSite=None";break}default:throw new Error("option sameSite is invalid")}return e.partitioned&&(t+="; Partitioned"),t}export function splitSetCookieString(r){if(Array.isArray(r))return r.flatMap(f=>splitSetCookieString(f));if(!p(r))return[];const c=[];let i=0,e,o,a,t,n;const s=()=>{for(;i<r.length&&/\s/.test(r.charAt(i));)i+=1;return i<r.length},l=()=>(o=r.charAt(i),o!=="="&&o!==";"&&o!==",");for(;i<r.length;){for(e=i,n=!1;s();)if(o=r.charAt(i),o===","){for(a=i,i+=1,s(),t=i;i<r.length&&l();)i+=1;i<r.length&&r.charAt(i)==="="?(n=!0,i=t,c.push(r.slice(e,a)),e=i):i=a+1}else i+=1;(!n||i>=r.length)&&c.push(r.slice(e))}return c}

package/dist/types.cjs

@@ -1 +0,0 @@
-"use strict";