@nutin/cli 2.1.0 → 3.0.0

package/templates/base/src/core/services/http-client/helpers/http-manager.helper.ts.hbs

@@ -3,6 +3,10 @@ export type TimeoutType = ReturnType<typeof setTimeout> | null;
 export interface IAbortControllerSetup {
   controller: AbortController;
   timeoutId: TimeoutType;
+  // True once the timeout (not the caller's signal) aborted the request.
+  timedOut: () => boolean;
+  // Detaches the caller's signal and clears the timeout.
+  cleanup: () => void;
 }
 
 export class HttpError extends Error {
@@ -15,63 +19,85 @@ export class HttpError extends Error {
   }
 }
 
-export class HttpManager {
-  public static createAbortController(timeout?: number): IAbortControllerSetup {
-    const controller = new AbortController();
-    const timeoutId = timeout ? 
-      setTimeout(() => controller.abort(), timeout) : 
-      null;
-    
-    return { controller, timeoutId };
+export function createAbortController(timeout?: number, signal?: AbortSignal): IAbortControllerSetup {
+  if (timeout !== undefined && !(timeout > 0)) {
+    throw new Error(`timeout must be a positive number of milliseconds, got ${timeout}.`);
   }
 
-  public static async validateResponse(response: Response): Promise<void> {
-    if (!response.ok) {
-      await this.handleResponseError(response);
-    }
-  }
-  
-  public static async parseSuccessResponse<T>(response: Response): Promise<T> {
-    const contentType = response.headers.get('content-type');
-    
-    if (this.isJsonResponse(contentType)) {
-      return await response.json();
-    }
-    
-    return await response.text() as unknown as T;
-  }
+  const controller = new AbortController();
+  let timedOut = false;
+  const timeoutId = timeout
+    ? setTimeout(() => {
+        timedOut = true;
+        controller.abort();
+      }, timeout)
+    : null;
 
-  public static handleRequestError(error: unknown): never {
-    if (this.isTimeoutError(error)) {
-      throw new Error('Request timed out');
-    }
-    throw error;
-  }
+  const forwardAbort = () => controller.abort(signal?.reason);
+  if (signal?.aborted) forwardAbort();
+  else signal?.addEventListener('abort', forwardAbort, { once: true });
 
-  public static cleanupTimeout(timeoutId: TimeoutType | null): void {
-    if (timeoutId) {
-      clearTimeout(timeoutId);
-    }
-  }
+  return {
+    controller,
+    timeoutId,
+    timedOut: () => timedOut,
+    cleanup: () => {
+      cleanupTimeout(timeoutId);
+      signal?.removeEventListener('abort', forwardAbort);
+    },
+  };
+}
 
-  private static async handleResponseError(response: Response): Promise<never> {
-    const errorData = await this.safeParseErrorResponse(response);
-    throw new HttpError(response.status, response.statusText, errorData);
+export async function validateResponse(response: Response): Promise<void> {
+  if (!response.ok) {
+    await handleResponseError(response);
   }
+}
+
+// JSON (application/json or any +json type) is parsed; an empty body (204, 205, or no
+// content) resolves to undefined; anything else is returned as text.
+export async function parseSuccessResponse<T>(response: Response): Promise<T> {
+  if (response.status === 204 || response.status === 205) return undefined as T;
+
+  const text = await response.text();
+  if (text === '') return undefined as T;
+  if (isJsonResponse(response.headers.get('content-type'))) return JSON.parse(text);
+  return text as unknown as T;
+}
 
-  private static isJsonResponse(contentType: string | null): boolean {
-    return contentType?.includes('application/json') ?? false;
+// Only the client's own timeout is reported as "Request timed out": an abort from the
+// caller's signal is rethrown as it is.
+export function handleRequestError(error: unknown, timedOut = false): never {
+  if (timedOut && isAbortError(error)) {
+    throw new Error('Request timed out');
   }
+  throw error;
+}
 
-  private static async safeParseErrorResponse(response: Response): Promise<unknown> {
-    try {
-      return await response.json();
-    } catch {
-      return null;
-    }
+export function cleanupTimeout(timeoutId: TimeoutType | null): void {
+  if (timeoutId) {
+    clearTimeout(timeoutId);
   }
+}
+
+async function handleResponseError(response: Response): Promise<never> {
+  const errorData = await safeParseErrorResponse(response);
+  throw new HttpError(response.status, response.statusText, errorData);
+}
 
-  private static isTimeoutError(error: unknown): boolean {
-    return error instanceof DOMException && error.name === 'AbortError';
+function isJsonResponse(contentType: string | null): boolean {
+  const mediaType = ((contentType ?? '').split(';')[0] as string).trim().toLowerCase();
+  return mediaType === 'application/json' || mediaType.endsWith('+json');
+}
+
+async function safeParseErrorResponse(response: Response): Promise<unknown> {
+  try {
+    return await response.json();
+  } catch {
+    return null;
   }
 }
+
+function isAbortError(error: unknown): boolean {
+  return (error as { name?: unknown } | null)?.name === 'AbortError';
+}