@stryke/http 0.8.4 → 0.9.0

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.4",
+  "version": "0.9.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.5" },
+  "dependencies": { "@stryke/type-checks": "^0.3.9" },
   "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,34 @@
       },
       "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"
+      }
+    },
     "./format-data-uri": {
       "import": {
         "types": "./dist/format-data-uri.d.ts",
@@ -85,19 +133,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" },
@@ -111,5 +161,6 @@
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts"
+  "types": "./dist/index.d.ts",
+  "gitHead": "e16a03d7f9db49ef07f8b9368c56182fa84e2bf6"
 }

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";

package/dist/types.d.ts

@@ -1,184 +0,0 @@
-/**
- * Cookie serialization options
- */
-export interface CookieSerializeOptions {
-    /**
-     * Specifies the value for the {@link https://tools.ietf.org/html/rfc6265#section-5.2.3 | Domain Set-Cookie attribute}. By default, no
-     * domain is set, and most clients will consider the cookie to apply to only
-     * the current domain.
-     */
-    domain?: string | undefined;
-    /**
-     * Specifies a function that will be used to encode a cookie's value. Since
-     * value of a cookie has a limited character set (and must be a simple
-     * string), this function can be used to encode a value into a string suited
-     * for a cookie's value.
-     *
-     * The default function is the global `encodeURIComponent`, which will
-     * encode a JavaScript string into UTF-8 byte sequences and then URL-encode
-     * any that fall outside of the cookie range.
-     */
-    encode?: (value: string) => string;
-    /**
-     * Specifies the `Date` object to be the value for the {@link https://tools.ietf.org/html/rfc6265#section-5.2.1 | `Expires` `Set-Cookie` attribute}. By default,
-     * no expiration is set, and most clients will consider this a "non-persistent cookie" and will delete
-     * it on a condition like exiting a web browser application.
-     *
-     * Note* the {@link https://tools.ietf.org/html/rfc6265#section-5.3 | cookie storage model specification}
-     * states that if both `expires` and `maxAge` are set, then `maxAge` takes precedence, but it is
-     * possible not all clients by obey this, so if both are set, they should
-     * point to the same date and time.
-     */
-    expires?: Date | undefined;
-    /**
-     * Specifies the boolean value for the {@link https://tools.ietf.org/html/rfc6265#section-5.2.6 | `HttpOnly` `Set-Cookie` attribute}.
-     * When truthy, the `HttpOnly` attribute is set, otherwise it is not. By
-     * default, the `HttpOnly` attribute is not set.
-     *
-     * Note* be careful when setting this to true, as compliant clients will
-     * not allow client-side JavaScript to see the cookie in `document.cookie`.
-     */
-    httpOnly?: boolean | undefined;
-    /**
-     * Specifies the number (in seconds) to be the value for the `Max-Age`
-     * `Set-Cookie` attribute. The given number will be converted to an integer
-     * by rounding down. By default, no maximum age is set.
-     *
-     * Note* the {@link https://tools.ietf.org/html/rfc6265#section-5.3 | cookie storage model specification}
-     * states that if both `expires` and `maxAge` are set, then `maxAge` takes precedence, but it is
-     * possible not all clients by obey this, so if both are set, they should
-     * point to the same date and time.
-     */
-    maxAge?: number | undefined;
-    /**
-     * Specifies the value for the {@link https://tools.ietf.org/html/rfc6265#section-5.2.4|`Path` `Set-Cookie` attribute}.
-     * By default, the path is considered the "default path".
-     */
-    path?: string | undefined;
-    /**
-     * Specifies the `string` to be the value for the [`Priority` `Set-Cookie` attribute][rfc-west-cookie-priority-00-4.1].
-     *
-     * - `'low'` will set the `Priority` attribute to `Low`.
-     * - `'medium'` will set the `Priority` attribute to `Medium`, the default priority when not set.
-     * - `'high'` will set the `Priority` attribute to `High`.
-     *
-     * More information about the different priority levels can be found in
-     * [the specification][rfc-west-cookie-priority-00-4.1].
-     *
-     * **note** This is an attribute that has not yet been fully standardized, and may change in the future.
-     * This also means many clients may ignore this attribute until they understand it.
-     */
-    priority?: "low" | "medium" | "high" | undefined;
-    /**
-     * Specifies the boolean or string to be the value for the {@link https://tools.ietf.org/html/draft-ietf-httpbis-rfc6265bis-03#section-4.1.2.7|`SameSite` `Set-Cookie` attribute}.
-     *
-     * - `true` will set the `SameSite` attribute to `Strict` for strict same
-     * site enforcement.
-     * - `false` will not set the `SameSite` attribute.
-     * - `'lax'` will set the `SameSite` attribute to Lax for lax same site
-     * enforcement.
-     * - `'strict'` will set the `SameSite` attribute to Strict for strict same
-     * site enforcement.
-     *  - `'none'` will set the SameSite attribute to None for an explicit
-     *  cross-site cookie.
-     *
-     * More information about the different enforcement levels can be found in {@link https://tools.ietf.org/html/draft-ietf-httpbis-rfc6265bis-03#section-4.1.2.7|the specification}.
-     *
-     * note* This is an attribute that has not yet been fully standardized, and may change in the future. This also means many clients may ignore this attribute until they understand it.
-     */
-    sameSite?: true | false | "lax" | "strict" | "none" | undefined;
-    /**
-     * Specifies the boolean value for the {@link https://tools.ietf.org/html/rfc6265#section-5.2.5 | `Secure` `Set-Cookie` attribute}. When truthy, the
-     * `Secure` attribute is set, otherwise it is not. By default, the `Secure` attribute is not set.
-     *
-     * Note* be careful when setting this to `true`, as compliant clients will
-     * not send the cookie back to the server in the future if the browser does
-     * not have an HTTPS connection.
-     */
-    secure?: boolean | undefined;
-    /**
-     * Specifies the `boolean` value for the [`Partitioned` `Set-Cookie`](https://datatracker.ietf.org/doc/html/draft-cutler-httpbis-partitioned-cookies#section-2.1)
-     * attribute. When truthy, the `Partitioned` attribute is set, otherwise it is not. By default, the
-     * `Partitioned` attribute is not set.
-     *
-     * **note** This is an attribute that has not yet been fully standardized, and may change in the future.
-     * This also means many clients may ignore this attribute until they understand it.
-     *
-     * More information can be found in the [proposal](https://github.com/privacycg/CHIPS).
-     */
-    partitioned?: boolean;
-}
-/**
- * Additional parsing options
- */
-export interface CookieParseOptions {
-    /**
-     * Specifies a function that will be used to decode a cookie's value. Since
-     * the value of a cookie has a limited character set (and must be a simple
-     * string), this function can be used to decode a previously-encoded cookie
-     * value into a JavaScript string or other object.
-     *
-     * The default function is the global `decodeURIComponent`, which will decode
-     * any URL-encoded sequences into their byte representations.
-     *
-     * Note* if an error is thrown from this function, the original, non-decoded
-     * cookie value will be returned as the cookie's value.
-     */
-    decode?: (value: string) => string;
-    /**
-     * Custom function to filter parsing specific keys.
-     */
-    filter?: (key: string) => boolean;
-}
-export interface SetCookieParseOptions {
-    /**
-     * Custom decode function to use on cookie values.
-     *
-     * By default, `decodeURIComponent` is used.
-     *
-     * **Note:** If decoding fails, the original (undecoded) value will be used
-     */
-    decode?: false | ((value: string) => string);
-}
-export interface SetCookie {
-    /**
-     * Cookie name
-     */
-    name: string;
-    /**
-     * Cookie value
-     */
-    value: string;
-    /**
-     * Cookie path
-     */
-    path?: string | undefined;
-    /**
-     * Absolute expiration date for the cookie
-     */
-    expires?: Date | undefined;
-    /**
-     * Relative max age of the cookie in seconds from when the client receives it (integer or undefined)
-     *
-     * Note: when using with express's res.cookie() method, multiply maxAge by 1000 to convert to milliseconds
-     */
-    maxAge?: number | undefined;
-    /**
-     * Domain for the cookie,
-     * May begin with "." to indicate the named domain or any subdomain of it
-     */
-    domain?: string | undefined;
-    /**
-     * Indicates that this cookie should only be sent over HTTPs
-     */
-    secure?: boolean | undefined;
-    /**
-     * Indicates that this cookie should not be accessible to client-side JavaScript
-     */
-    httpOnly?: boolean | undefined;
-    /**
-     * Indicates a cookie ought not to be sent along with cross-site requests
-     */
-    sameSite?: true | false | "lax" | "strict" | "none" | undefined;
-    [key: string]: unknown;
-}