bun-types 1.2.5-canary.20250302T140537 → 1.2.5-canary.20250304T140606

package/fetch.d.ts

@@ -1,14 +1,59 @@
-type _Response = typeof globalThis extends { onmessage: any }
-	? {}
-	: import("undici-types").Response;
+interface Headers {
+	/**
+	 * Convert {@link Headers} to a plain JavaScript object.
+	 *
+	 * About 10x faster than `Object.fromEntries(headers.entries())`
+	 *
+	 * Called when you run `JSON.stringify(headers)`
+	 *
+	 * Does not preserve insertion order. Well-known header names are lowercased. Other header names are left as-is.
+	 */
+	toJSON(): Record<string, string>;
+	/**
+	 * Get the total number of headers
+	 */
+	readonly count: number;
+	/**
+	 * Get all headers matching the name
+	 *
+	 * Only supports `"Set-Cookie"`. All other headers are empty arrays.
+	 *
+	 * @param name - The header name to get
+	 *
+	 * @returns An array of header values
+	 *
+	 * @example
+	 * ```ts
+	 * const headers = new Headers();
+	 * headers.append("Set-Cookie", "foo=bar");
+	 * headers.append("Set-Cookie", "baz=qux");
+	 * headers.getAll("Set-Cookie"); // ["foo=bar", "baz=qux"]
+	 * ```
+	 */
+	getAll(name: "set-cookie" | "Set-Cookie"): string[];
+}
+
+var Headers: {
+	prototype: Headers;
+	new (init?: Bun.HeadersInit): Headers;
+};
 
-export interface Response extends _Response {}
-export declare class Response {
-	constructor(
+interface Request {
+	headers: Headers;
+}
+
+var Request: {
+	prototype: Request;
+	new (requestInfo: string, requestInit?: RequestInit): Request;
+	new (requestInfo: RequestInit & { url: string }): Request;
+	new (requestInfo: Request, requestInit?: RequestInit): Request;
+};
+
+var Response: {
+	new (
 		body?: Bun.BodyInit | null | undefined,
 		init?: Bun.ResponseInit | undefined,
-	);
-
+	): Response;
 	/**
 	 * Create a new {@link Response} with a JSON body
 	 *
@@ -32,7 +77,8 @@ export declare class Response {
 	 * ```
 	 * @link https://github.com/whatwg/fetch/issues/1389
 	 */
-	static json(body?: any, options?: Bun.ResponseInit | number): Response;
+	json(body?: any, options?: Bun.ResponseInit | number): Response;
+
 	/**
 	 * Create a new {@link Response} that redirects to url
 	 *
@@ -40,7 +86,7 @@ export declare class Response {
 	 * @param status - the HTTP status code to use for the redirect
 	 */
 	// tslint:disable-next-line:unified-signatures
-	static redirect(url: string, status?: number): Response;
+	redirect(url: string, status?: number): Response;
 
 	/**
 	 * Create a new {@link Response} that redirects to url
@@ -49,10 +95,75 @@ export declare class Response {
 	 * @param options - options to pass to the response
 	 */
 	// tslint:disable-next-line:unified-signatures
-	static redirect(url: string, options?: Bun.ResponseInit): Response;
+	redirect(url: string, options?: Bun.ResponseInit): Response;
 
 	/**
 	 * Create a new {@link Response} that has a network error
 	 */
-	static error(): Response;
+	error(): Response;
+};
+
+type _BunTLSOptions = import("bun").TLSOptions;
+interface BunFetchRequestInitTLS extends _BunTLSOptions {
+	/**
+	 * Custom function to check the server identity
+	 * @param hostname - The hostname of the server
+	 * @param cert - The certificate of the server
+	 * @returns An error if the server is unauthorized, otherwise undefined
+	 */
+	checkServerIdentity?: NonNullable<
+		import("node:tls").ConnectionOptions["checkServerIdentity"]
+	>;
+}
+
+/**
+ * BunFetchRequestInit represents additional options that Bun supports in `fetch()` only.
+ *
+ * Bun extends the `fetch` API with some additional options, except
+ * this interface is not quite a `RequestInit`, because they won't work
+ * if passed to `new Request()`. This is why it's a separate type.
+ */
+interface BunFetchRequestInit extends RequestInit {
+	/**
+	 * Override the default TLS options
+	 */
+	tls?: BunFetchRequestInitTLS;
 }
+
+var fetch: {
+	/**
+	 * Send a HTTP(s) request
+	 *
+	 * @param request Request object
+	 * @param init A structured value that contains settings for the fetch() request.
+	 *
+	 * @returns A promise that resolves to {@link Response} object.
+	 */
+	(request: Request, init?: BunFetchRequestInit): Promise<Response>;
+
+	/**
+	 * Send a HTTP(s) request
+	 *
+	 * @param url URL string
+	 * @param init A structured value that contains settings for the fetch() request.
+	 *
+	 * @returns A promise that resolves to {@link Response} object.
+	 */
+	(url: string | URL | Request, init?: BunFetchRequestInit): Promise<Response>;
+
+	(
+		input: string | URL | globalThis.Request,
+		init?: BunFetchRequestInit,
+	): Promise<Response>;
+
+	/**
+	 * Start the DNS resolution, TCP connection, and TLS handshake for a request
+	 * before the request is actually sent.
+	 *
+	 * This can reduce the latency of a request when you know there's some
+	 * long-running task that will delay the request starting.
+	 *
+	 * This is a bun-specific API and is not part of the Fetch API specification.
+	 */
+	preconnect(url: string | URL): void;
+};