feat: export cookie utilities from undici (#742)

Re-export undici's [Cookie
API](https://github.com/nodejs/undici/blob/main/docs/docs/api/Cookies.md)
from urllib.

- Export `getCookies`, `setCookie`, `getSetCookies`, `deleteCookie`,
`parseCookie` functions and `Cookie` type from `src/index.ts`
- Add tests for all five cookie utilities

```ts
import { getCookies, setCookie, getSetCookies, deleteCookie, parseCookie, Headers } from 'urllib';
import type { Cookie } from 'urllib';

const headers = new Headers();
setCookie(headers, { name: 'foo', value: 'bar' });
const cookies = getSetCookies(headers); // [{ name: 'foo', value: 'bar' }]
```

> [!WARNING]
>
> <details>
> <summary>Firewall rules blocked me from connecting to one or more
addresses (expand for details)</summary>
>
> #### I tried to connect to the following addresses, but was blocked by
firewall rules:
>
> - `http://registry.npmjs.org:80/urllib/latest`
> - Triggering command: `/opt/hostedtoolcache/node/24.14.1/x64/bin/node
/opt/hostedtoolcache/node/24.14.1/x64/bin/node
--experimental-import-meta-resolve --require
/home/REDACTED/work/urllib/urllib/node_modules/.pnpm/@voidzero-dev&#43;[email protected]_@arethetypeswrong&#43;[email protected]_@types&#43;[email protected]__7c6ae394869a5d43fd0cf7dc1d33dc1c/node_modules/@voidzero-dev/vite-plus-test/suppress-warnings.cjs
--conditions node --conditions development
/home/REDACTED/work/urllib/urllib/node_modules/.pnpm/@voidzero-dev&#43;[email protected]_@arethetypeswrong&#43;[email protected]_@types&#43;[email protected]__7c6ae394869a5d43fd0cf7dc1d33dc1c/node_modules/@voidzero-dev/vite-plus-test/dist/workers/forks.js`
(http block)
>
> If you need me to access, download, or install something from one of
these locations, you can either:
>
> - Configure [Actions setup
steps](https://gh.io/copilot/actions-setup-steps) to set up my
environment, which run before the firewall is enabled
> - Add the appropriate URLs or hosts to the custom allowlist in this
repository's [Copilot coding agent
settings](https://github.com/node-modules/urllib/settings/copilot/coding_agent)
(admins only)
>
> </details>

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: fengmk2 <[email protected]>

Author: Copilot

src/index.ts

@@ -98,8 +98,13 @@ export {
   Response,
   Headers,
   FormData,
+  getCookies,
+  setCookie,
+  getSetCookies,
+  deleteCookie,
+  parseCookie,
 } from 'undici';
-export type { RequestInfo, RequestInit, BodyInit, ResponseInit } from 'undici';
+export type { RequestInfo, RequestInit, BodyInit, ResponseInit, Cookie } from 'undici';
 // HttpClient2 is keep compatible with urllib@2 HttpClient2
 export { HttpClient, HttpClient as HttpClient2, HEADER_USER_AGENT as USER_AGENT } from './HttpClient.js';
 export type { RequestDiagnosticsMessage, ResponseDiagnosticsMessage, ClientOptions } from './HttpClient.js';

test/index.test.ts

@@ -10,7 +10,14 @@ import urllib, {
   MockAgent,
   setGlobalDispatcher,
   getGlobalDispatcher,
+  getCookies,
+  setCookie,
+  getSetCookies,
+  deleteCookie,
+  parseCookie,
+  Headers,
 } from '../src/index.js';
+import type { Cookie } from '../src/index.js';
 import { startServer } from './fixtures/server.js';
 import { readableToBytes } from './utils.js';
 
@@ -423,4 +430,55 @@ describe('index.test.ts', () => {
       assert.equal(response.status, 200);
     });
   });
+
+  describe('Cookie utilities', () => {
+    it('should export getCookies from undici', () => {
+      assert.equal(typeof getCookies, 'function');
+      const headers = new Headers();
+      headers.set('cookie', 'foo=bar; hello=world');
+      const cookies = getCookies(headers);
+      assert.equal(cookies.foo, 'bar');
+      assert.equal(cookies.hello, 'world');
+    });
+
+    it('should export setCookie from undici', () => {
+      assert.equal(typeof setCookie, 'function');
+      const headers = new Headers();
+      const cookie: Cookie = { name: 'foo', value: 'bar' };
+      setCookie(headers, cookie);
+      const setCookieHeader = headers.get('set-cookie');
+      assert(setCookieHeader);
+      assert.match(setCookieHeader, /foo=bar/);
+    });
+
+    it('should export getSetCookies from undici', () => {
+      assert.equal(typeof getSetCookies, 'function');
+      const headers = new Headers();
+      headers.append('set-cookie', 'foo=bar');
+      headers.append('set-cookie', 'hello=world');
+      const cookies = getSetCookies(headers);
+      assert.equal(cookies.length, 2);
+      assert.equal(cookies[0].name, 'foo');
+      assert.equal(cookies[0].value, 'bar');
+      assert.equal(cookies[1].name, 'hello');
+      assert.equal(cookies[1].value, 'world');
+    });
+
+    it('should export deleteCookie from undici', () => {
+      assert.equal(typeof deleteCookie, 'function');
+      const headers = new Headers();
+      deleteCookie(headers, 'foo');
+      const setCookieHeader = headers.get('set-cookie');
+      assert(setCookieHeader);
+      assert.match(setCookieHeader, /foo=/);
+    });
+
+    it('should export parseCookie from undici', () => {
+      assert.equal(typeof parseCookie, 'function');
+      const cookie = parseCookie('foo=bar');
+      assert(cookie);
+      assert.equal(cookie.name, 'foo');
+      assert.equal(cookie.value, 'bar');
+    });
+  });
 });