@j0hanz/superfetch 2.5.3 → 2.6.0

package/dist/errors.d.ts

@@ -3,8 +3,8 @@ export declare class FetchError extends Error {
     readonly statusCode: number;
     readonly code: string;
     readonly details: Readonly<Record<string, unknown>>;
-    constructor(message: string, url: string, httpStatus?: number, details?: Record<string, unknown>);
+    constructor(message: string, url: string, httpStatus?: number, details?: Record<string, unknown>, options?: ErrorOptions);
 }
 export declare function getErrorMessage(error: unknown): string;
-export declare function createErrorWithCode(message: string, code: string): NodeJS.ErrnoException;
+export declare function createErrorWithCode(message: string, code: string, options?: ErrorOptions): NodeJS.ErrnoException;
 export declare function isSystemError(error: unknown): error is NodeJS.ErrnoException;

package/dist/errors.js

@@ -1,12 +1,13 @@
-import { isObject } from './type-guards.js';
+import { inspect } from 'node:util';
+import { isError, isObject } from './type-guards.js';
 const DEFAULT_HTTP_STATUS = 502;
 export class FetchError extends Error {
     url;
     statusCode;
     code;
     details;
-    constructor(message, url, httpStatus, details = {}) {
-        super(message);
+    constructor(message, url, httpStatus, details = {}, options) {
+        super(message, options);
         this.url = url;
         this.name = 'FetchError';
         this.statusCode = httpStatus ?? DEFAULT_HTTP_STATUS;
@@ -16,13 +17,13 @@ export class FetchError extends Error {
     }
 }
 export function getErrorMessage(error) {
-    if (error instanceof Error)
+    if (isError(error))
         return error.message;
     if (typeof error === 'string' && error.length > 0)
         return error;
     if (isErrorWithMessage(error))
         return error.message;
-    return 'Unknown error';
+    return formatUnknownError(error);
 }
 function isErrorWithMessage(error) {
     if (!isObject(error))
@@ -30,12 +31,28 @@ function isErrorWithMessage(error) {
     const { message } = error;
     return typeof message === 'string' && message.length > 0;
 }
-export function createErrorWithCode(message, code) {
-    const error = new Error(message);
+function formatUnknownError(error) {
+    if (error === null || error === undefined)
+        return 'Unknown error';
+    try {
+        return inspect(error, {
+            depth: 2,
+            maxStringLength: 200,
+            breakLength: Infinity,
+            compact: true,
+            colors: false,
+        });
+    }
+    catch {
+        return 'Unknown error';
+    }
+}
+export function createErrorWithCode(message, code, options) {
+    const error = new Error(message, options);
     return Object.assign(error, { code });
 }
 export function isSystemError(error) {
-    if (!(error instanceof Error))
+    if (!isError(error))
         return false;
     if (!('code' in error))
         return false;

package/dist/fetch.d.ts

@@ -6,17 +6,6 @@ export interface TransformResult {
     readonly transformed: boolean;
     readonly platform?: string;
 }
-/** Backwards-compatible export */
-export declare function isBlockedIp(ip: string): boolean;
-/** Backwards-compatible exports */
-export declare function normalizeUrl(urlString: string): {
-    normalizedUrl: string;
-    hostname: string;
-};
-export declare function validateAndNormalizeUrl(urlString: string): string;
-/** Backwards-compatible exports */
-export declare function transformToRawUrl(url: string): TransformResult;
-export declare function isRawTextContentUrl(url: string): boolean;
 export interface FetchTelemetryContext {
     requestId: string;
     startTime: number;
@@ -25,19 +14,32 @@ export interface FetchTelemetryContext {
     contextRequestId?: string;
     operationId?: string;
 }
-/** Backwards-compatible exports */
+export declare function isBlockedIp(ip: string): boolean;
+export declare function normalizeUrl(urlString: string): {
+    normalizedUrl: string;
+    hostname: string;
+};
+export declare function validateAndNormalizeUrl(urlString: string): string;
+export declare function transformToRawUrl(url: string): TransformResult;
+export declare function isRawTextContentUrl(url: string): boolean;
 export declare function startFetchTelemetry(url: string, method: string): FetchTelemetryContext;
 export declare function recordFetchResponse(context: FetchTelemetryContext, response: Response, contentSize?: number): void;
 export declare function recordFetchError(context: FetchTelemetryContext, error: unknown, status?: number): void;
-/** Backwards-compatible export */
 export declare function fetchWithRedirects(url: string, init: RequestInit, maxRedirects: number): Promise<{
     response: Response;
     url: string;
 }>;
-/** Backwards-compatible export */
-export declare function readResponseText(response: Response, url: string, maxBytes: number, signal?: AbortSignal): Promise<{
+export declare function readResponseText(response: Response, url: string, maxBytes: number, signal?: AbortSignal, encoding?: string): Promise<{
     text: string;
     size: number;
 }>;
-/** Backwards-compatible export */
+export declare function readResponseBuffer(response: Response, url: string, maxBytes: number, signal?: AbortSignal, encoding?: string): Promise<{
+    buffer: Uint8Array;
+    encoding: string;
+    size: number;
+}>;
 export declare function fetchNormalizedUrl(normalizedUrl: string, options?: FetchOptions): Promise<string>;
+export declare function fetchNormalizedUrlBuffer(normalizedUrl: string, options?: FetchOptions): Promise<{
+    buffer: Uint8Array;
+    encoding: string;
+}>;