@ci-kit/http 0.0.0-stage → 0.0.0

package/dist/index.d.mts

@@ -0,0 +1,18 @@
+interface RequestOptions {
+    timeoutMs?: number;
+    retries?: number;
+    retryDelayMs?: number;
+}
+declare class HttpError extends Error {
+    readonly url: string;
+    readonly status: number;
+    readonly body: string;
+    constructor(url: string, status: number, body: string);
+}
+declare function isRetryable(error: unknown): boolean;
+declare function request(url: string, init?: RequestInit, options?: RequestOptions): Promise<Response>;
+declare function requestJson<T>(url: string, init?: RequestInit, options?: RequestOptions): Promise<T>;
+declare function requestBuffer(url: string, init?: RequestInit, options?: RequestOptions): Promise<Uint8Array>;
+
+export { HttpError, isRetryable, request, requestBuffer, requestJson };
+export type { RequestOptions };

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+interface RequestOptions {
+    timeoutMs?: number;
+    retries?: number;
+    retryDelayMs?: number;
+}
+declare class HttpError extends Error {
+    readonly url: string;
+    readonly status: number;
+    readonly body: string;
+    constructor(url: string, status: number, body: string);
+}
+declare function isRetryable(error: unknown): boolean;
+declare function request(url: string, init?: RequestInit, options?: RequestOptions): Promise<Response>;
+declare function requestJson<T>(url: string, init?: RequestInit, options?: RequestOptions): Promise<T>;
+declare function requestBuffer(url: string, init?: RequestInit, options?: RequestOptions): Promise<Uint8Array>;
+
+export { HttpError, isRetryable, request, requestBuffer, requestJson };
+export type { RequestOptions };

package/dist/index.mjs

@@ -0,0 +1,62 @@
+class HttpError extends Error {
+  constructor(url, status, body) {
+    super(`HTTP ${status} ${url}`);
+    this.url = url;
+    this.status = status;
+    this.body = body;
+    this.name = "HttpError";
+  }
+}
+const DEFAULT_TIMEOUT_MS = 6e4;
+const DEFAULT_RETRIES = 2;
+const DEFAULT_RETRY_DELAY_MS = 800;
+function isRetryable(error) {
+  if (error instanceof HttpError) {
+    return error.status === 408 || error.status === 429 || error.status >= 500;
+  }
+  if (error instanceof Error) {
+    if (error.name === "TimeoutError" || error.name === "AbortError") {
+      return true;
+    }
+    return /fetch failed|ECONNRESET|ECONNREFUSED|ETIMEDOUT|EAI_AGAIN/i.test(error.message);
+  }
+  return false;
+}
+async function request(url, init = {}, options = {}) {
+  const {
+    timeoutMs = DEFAULT_TIMEOUT_MS,
+    retries = DEFAULT_RETRIES,
+    retryDelayMs = DEFAULT_RETRY_DELAY_MS
+  } = options;
+  let lastError;
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    try {
+      const response = await fetch(url, {
+        ...init,
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        throw new HttpError(url, response.status, body.slice(0, 500));
+      }
+      return response;
+    } catch (error) {
+      lastError = error;
+      if (attempt === retries || !isRetryable(error)) {
+        throw error;
+      }
+      await new Promise((resolve) => setTimeout(resolve, retryDelayMs * 2 ** attempt));
+    }
+  }
+  throw lastError;
+}
+async function requestJson(url, init = {}, options = {}) {
+  const response = await request(url, init, options);
+  return await response.json();
+}
+async function requestBuffer(url, init = {}, options = {}) {
+  const response = await request(url, init, options);
+  return new Uint8Array(await response.arrayBuffer());
+}
+
+export { HttpError, isRetryable, request, requestBuffer, requestJson };

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@ci-kit/http",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "type": "module",
+  "version": "0.0.0",
+  "description": "Tiny fetch wrapper with timeout, retry and typed errors",
+  "author": "imba97",
+  "license": "MIT",
+  "homepage": "https://github.com/cikit-js/ci-kit#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cikit-js/ci-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cikit-js/ci-kit/issues"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "unbuild",
+    "typecheck": "tsc --noEmit",
+    "stub": "unbuild --stub"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.