@socketsecurity/lib 5.5.3 → 5.7.0

package/dist/http-request.d.ts

@@ -435,46 +435,6 @@ export interface HttpDownloadResult {
      */
     size: number;
 }
-/**
- * Make an HTTP/HTTPS request with retry logic and redirect support.
- * Provides a fetch-like API using Node.js native http/https modules.
- *
- * This is the main entry point for making HTTP requests. It handles retries,
- * redirects, timeouts, and provides a fetch-compatible response interface.
- *
- * @param url - The URL to request (must start with http:// or https://)
- * @param options - Request configuration options
- * @returns Promise resolving to response object with `.json()`, `.text()`, etc.
- * @throws {Error} When all retries are exhausted, timeout occurs, or non-retryable error happens
- *
- * @example
- * ```ts
- * // Simple GET request
- * const response = await httpRequest('https://api.example.com/data')
- * const data = response.json()
- *
- * // POST with JSON body
- * const response = await httpRequest('https://api.example.com/users', {
- *   method: 'POST',
- *   headers: { 'Content-Type': 'application/json' },
- *   body: JSON.stringify({ name: 'Alice', email: 'alice@example.com' })
- * })
- *
- * // With retries and timeout
- * const response = await httpRequest('https://api.example.com/data', {
- *   retries: 3,
- *   retryDelay: 1000,
- *   timeout: 60000
- * })
- *
- * // Don't follow redirects
- * const response = await httpRequest('https://example.com/redirect', {
- *   followRedirects: false
- * })
- * console.log(response.status) // 301, 302, etc.
- * ```
- */
-export declare function httpRequest(url: string, options?: HttpRequestOptions | undefined): Promise<HttpResponse>;
 /**
  * Download a file from a URL to a local path with redirect support, retry logic, and progress callbacks.
  * Uses streaming to avoid loading entire file in memory.
@@ -533,8 +493,12 @@ export declare function httpRequest(url: string, options?: HttpRequestOptions |
  */
 export declare function httpDownload(url: string, destPath: string, options?: HttpDownloadOptions | undefined): Promise<HttpDownloadResult>;
 /**
- * Perform a GET request and parse JSON response.
- * Convenience wrapper around `httpRequest` for common JSON API calls.
+ * Perform an HTTP request and parse JSON response.
+ * Convenience wrapper around `httpRequest` for JSON API calls.
+ * Automatically sets appropriate headers for JSON requests:
+ * - `Accept: application/json` (always)
+ * - `Content-Type: application/json` (when body is present)
+ * User-provided headers override these defaults.
  *
  * @template T - Expected JSON response type (defaults to `unknown`)
  * @param url - The URL to request (must start with http:// or https://)
@@ -544,34 +508,79 @@ export declare function httpDownload(url: string, destPath: string, options?: Ht
  *
  * @example
  * ```ts
- * // Simple JSON GET
- * const data = await httpGetJson('https://api.example.com/data')
+ * // Simple JSON GET (automatically sets Accept: application/json)
+ * const data = await httpJson('https://api.example.com/data')
  * console.log(data)
  *
  * // With type safety
  * interface User { id: number; name: string; email: string }
- * const user = await httpGetJson<User>('https://api.example.com/user/123')
+ * const user = await httpJson<User>('https://api.example.com/user/123')
  * console.log(user.name, user.email)
  *
- * // With custom headers
- * const data = await httpGetJson('https://api.example.com/data', {
- *   headers: {
- *     'Authorization': 'Bearer token123',
- *     'Accept': 'application/json'
- *   }
+ * // POST with JSON body (automatically sets Content-Type: application/json)
+ * const result = await httpJson('https://api.example.com/users', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ name: 'Alice', email: 'alice@example.com' })
  * })
  *
- * // With retries
- * const data = await httpGetJson('https://api.example.com/data', {
+ * // With custom headers and retries
+ * const data = await httpJson('https://api.example.com/data', {
+ *   headers: {
+ *     'Authorization': 'Bearer token123'
+ *   },
  *   retries: 3,
  *   retryDelay: 1000
  * })
  * ```
  */
-export declare function httpGetJson<T = unknown>(url: string, options?: HttpRequestOptions | undefined): Promise<T>;
+export declare function httpJson<T = unknown>(url: string, options?: HttpRequestOptions | undefined): Promise<T>;
+/**
+ * Make an HTTP/HTTPS request with retry logic and redirect support.
+ * Provides a fetch-like API using Node.js native http/https modules.
+ *
+ * This is the main entry point for making HTTP requests. It handles retries,
+ * redirects, timeouts, and provides a fetch-compatible response interface.
+ *
+ * @param url - The URL to request (must start with http:// or https://)
+ * @param options - Request configuration options
+ * @returns Promise resolving to response object with `.json()`, `.text()`, etc.
+ * @throws {Error} When all retries are exhausted, timeout occurs, or non-retryable error happens
+ *
+ * @example
+ * ```ts
+ * // Simple GET request
+ * const response = await httpRequest('https://api.example.com/data')
+ * const data = response.json()
+ *
+ * // POST with JSON body
+ * const response = await httpRequest('https://api.example.com/users', {
+ *   method: 'POST',
+ *   headers: { 'Content-Type': 'application/json' },
+ *   body: JSON.stringify({ name: 'Alice', email: 'alice@example.com' })
+ * })
+ *
+ * // With retries and timeout
+ * const response = await httpRequest('https://api.example.com/data', {
+ *   retries: 3,
+ *   retryDelay: 1000,
+ *   timeout: 60000
+ * })
+ *
+ * // Don't follow redirects
+ * const response = await httpRequest('https://example.com/redirect', {
+ *   followRedirects: false
+ * })
+ * console.log(response.status) // 301, 302, etc.
+ * ```
+ */
+export declare function httpRequest(url: string, options?: HttpRequestOptions | undefined): Promise<HttpResponse>;
 /**
- * Perform a GET request and return text response.
+ * Perform an HTTP request and return text response.
  * Convenience wrapper around `httpRequest` for fetching text content.
+ * Automatically sets appropriate headers for text requests:
+ * - `Accept: text/plain` (always)
+ * - `Content-Type: text/plain` (when body is present)
+ * User-provided headers override these defaults.
  *
  * @param url - The URL to request (must start with http:// or https://)
  * @param options - Request configuration options
@@ -580,25 +589,32 @@ export declare function httpGetJson<T = unknown>(url: string, options?: HttpRequ
  *
  * @example
  * ```ts
- * // Fetch HTML
- * const html = await httpGetText('https://example.com')
+ * // Fetch HTML (automatically sets Accept: text/plain)
+ * const html = await httpText('https://example.com')
  * console.log(html.includes('<!DOCTYPE html>'))
  *
  * // Fetch plain text
- * const text = await httpGetText('https://example.com/file.txt')
+ * const text = await httpText('https://example.com/file.txt')
  * console.log(text)
  *
- * // With custom headers
- * const text = await httpGetText('https://example.com/data.txt', {
+ * // POST with text body (automatically sets Content-Type: text/plain)
+ * const result = await httpText('https://example.com/api', {
+ *   method: 'POST',
+ *   body: 'raw text data'
+ * })
+ *
+ * // With custom headers (override defaults)
+ * const text = await httpText('https://example.com/data.txt', {
  *   headers: {
- *     'Authorization': 'Bearer token123'
+ *     'Authorization': 'Bearer token123',
+ *     'Accept': 'text/html'  // Override default Accept header
  *   }
  * })
  *
  * // With timeout
- * const text = await httpGetText('https://example.com/large-file.txt', {
+ * const text = await httpText('https://example.com/large-file.txt', {
  *   timeout: 60000 // 1 minute
  * })
  * ```
  */
-export declare function httpGetText(url: string, options?: HttpRequestOptions | undefined): Promise<string>;
+export declare function httpText(url: string, options?: HttpRequestOptions | undefined): Promise<string>;

package/dist/http-request.js

@@ -20,9 +20,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var http_request_exports = {};
 __export(http_request_exports, {
   httpDownload: () => httpDownload,
-  httpGetJson: () => httpGetJson,
-  httpGetText: () => httpGetText,
-  httpRequest: () => httpRequest
+  httpJson: () => httpJson,
+  httpRequest: () => httpRequest,
+  httpText: () => httpText
 });
 module.exports = __toCommonJS(http_request_exports);
 let _fs;
@@ -49,38 +49,131 @@ function getHttps() {
   }
   return _https;
 }
-async function httpRequest(url, options) {
+async function httpDownloadAttempt(url, destPath, options) {
   const {
-    body,
     followRedirects = true,
     headers = {},
     maxRedirects = 5,
-    method = "GET",
-    retries = 0,
-    retryDelay = 1e3,
-    timeout = 3e4
+    onProgress,
+    timeout = 12e4
   } = { __proto__: null, ...options };
-  let lastError;
-  for (let attempt = 0; attempt <= retries; attempt++) {
-    try {
-      return await httpRequestAttempt(url, {
-        body,
-        followRedirects,
-        headers,
-        maxRedirects,
-        method,
-        timeout
-      });
-    } catch (e) {
-      lastError = e;
-      if (attempt === retries) {
-        break;
+  return await new Promise((resolve, reject) => {
+    const parsedUrl = new URL(url);
+    const isHttps = parsedUrl.protocol === "https:";
+    const httpModule = isHttps ? /* @__PURE__ */ getHttps() : /* @__PURE__ */ getHttp();
+    const requestOptions = {
+      headers: {
+        "User-Agent": "socket-registry/1.0",
+        ...headers
+      },
+      hostname: parsedUrl.hostname,
+      method: "GET",
+      path: parsedUrl.pathname + parsedUrl.search,
+      port: parsedUrl.port,
+      timeout
+    };
+    const { createWriteStream } = /* @__PURE__ */ getFs();
+    let fileStream;
+    let streamClosed = false;
+    const closeStream = () => {
+      if (!streamClosed && fileStream) {
+        streamClosed = true;
+        fileStream.close();
       }
-      const delayMs = retryDelay * 2 ** attempt;
-      await new Promise((resolve) => setTimeout(resolve, delayMs));
-    }
-  }
-  throw lastError || new Error("Request failed after retries");
+    };
+    const request = httpModule.request(
+      requestOptions,
+      (res) => {
+        if (followRedirects && res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          if (maxRedirects <= 0) {
+            reject(
+              new Error(
+                `Too many redirects (exceeded maximum: ${maxRedirects})`
+              )
+            );
+            return;
+          }
+          const redirectUrl = res.headers.location.startsWith("http") ? res.headers.location : new URL(res.headers.location, url).toString();
+          resolve(
+            httpDownloadAttempt(redirectUrl, destPath, {
+              followRedirects,
+              headers,
+              maxRedirects: maxRedirects - 1,
+              onProgress,
+              timeout
+            })
+          );
+          return;
+        }
+        if (!res.statusCode || res.statusCode < 200 || res.statusCode >= 300) {
+          closeStream();
+          reject(
+            new Error(
+              `Download failed: HTTP ${res.statusCode} ${res.statusMessage}`
+            )
+          );
+          return;
+        }
+        const totalSize = Number.parseInt(
+          res.headers["content-length"] || "0",
+          10
+        );
+        let downloadedSize = 0;
+        fileStream = createWriteStream(destPath);
+        fileStream.on("error", (error) => {
+          closeStream();
+          const err = new Error(`Failed to write file: ${error.message}`, {
+            cause: error
+          });
+          reject(err);
+        });
+        res.on("data", (chunk) => {
+          downloadedSize += chunk.length;
+          if (onProgress && totalSize > 0) {
+            onProgress(downloadedSize, totalSize);
+          }
+        });
+        res.on("end", () => {
+          fileStream?.close(() => {
+            streamClosed = true;
+            resolve({
+              path: destPath,
+              size: downloadedSize
+            });
+          });
+        });
+        res.on("error", (error) => {
+          closeStream();
+          reject(error);
+        });
+        res.pipe(fileStream);
+      }
+    );
+    request.on("error", (error) => {
+      closeStream();
+      const code = error.code;
+      let message = `HTTP download failed for ${url}: ${error.message}
+`;
+      if (code === "ENOTFOUND") {
+        message += "DNS lookup failed. Check the hostname and your network connection.";
+      } else if (code === "ECONNREFUSED") {
+        message += "Connection refused. Verify the server is running and accessible.";
+      } else if (code === "ETIMEDOUT") {
+        message += "Request timed out. Check your network or increase the timeout value.";
+      } else if (code === "ECONNRESET") {
+        message += "Connection reset. The server may have closed the connection unexpectedly.";
+      } else {
+        message += "Check your network connection and verify the URL is correct.";
+      }
+      reject(new Error(message, { cause: error }));
+    });
+    request.on("timeout", () => {
+      request.destroy();
+      closeStream();
+      reject(new Error(`Download timed out after ${timeout}ms`));
+    });
+    request.end();
+  });
 }
 async function httpRequestAttempt(url, options) {
   const {
@@ -236,134 +329,30 @@ async function httpDownload(url, destPath, options) {
   }
   throw lastError || new Error("Download failed after retries");
 }
-async function httpDownloadAttempt(url, destPath, options) {
+async function httpJson(url, options) {
   const {
-    followRedirects = true,
+    body,
     headers = {},
-    maxRedirects = 5,
-    onProgress,
-    timeout = 12e4
-  } = { __proto__: null, ...options };
-  return await new Promise((resolve, reject) => {
-    const parsedUrl = new URL(url);
-    const isHttps = parsedUrl.protocol === "https:";
-    const httpModule = isHttps ? /* @__PURE__ */ getHttps() : /* @__PURE__ */ getHttp();
-    const requestOptions = {
-      headers: {
-        "User-Agent": "socket-registry/1.0",
-        ...headers
-      },
-      hostname: parsedUrl.hostname,
-      method: "GET",
-      path: parsedUrl.pathname + parsedUrl.search,
-      port: parsedUrl.port,
-      timeout
-    };
-    const { createWriteStream } = /* @__PURE__ */ getFs();
-    let fileStream;
-    let streamClosed = false;
-    const closeStream = () => {
-      if (!streamClosed && fileStream) {
-        streamClosed = true;
-        fileStream.close();
-      }
-    };
-    const request = httpModule.request(
-      requestOptions,
-      (res) => {
-        if (followRedirects && res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-          if (maxRedirects <= 0) {
-            reject(
-              new Error(
-                `Too many redirects (exceeded maximum: ${maxRedirects})`
-              )
-            );
-            return;
-          }
-          const redirectUrl = res.headers.location.startsWith("http") ? res.headers.location : new URL(res.headers.location, url).toString();
-          resolve(
-            httpDownloadAttempt(redirectUrl, destPath, {
-              followRedirects,
-              headers,
-              maxRedirects: maxRedirects - 1,
-              onProgress,
-              timeout
-            })
-          );
-          return;
-        }
-        if (!res.statusCode || res.statusCode < 200 || res.statusCode >= 300) {
-          closeStream();
-          reject(
-            new Error(
-              `Download failed: HTTP ${res.statusCode} ${res.statusMessage}`
-            )
-          );
-          return;
-        }
-        const totalSize = Number.parseInt(
-          res.headers["content-length"] || "0",
-          10
-        );
-        let downloadedSize = 0;
-        fileStream = createWriteStream(destPath);
-        fileStream.on("error", (error) => {
-          closeStream();
-          const err = new Error(`Failed to write file: ${error.message}`, {
-            cause: error
-          });
-          reject(err);
-        });
-        res.on("data", (chunk) => {
-          downloadedSize += chunk.length;
-          if (onProgress && totalSize > 0) {
-            onProgress(downloadedSize, totalSize);
-          }
-        });
-        res.on("end", () => {
-          fileStream?.close(() => {
-            streamClosed = true;
-            resolve({
-              path: destPath,
-              size: downloadedSize
-            });
-          });
-        });
-        res.on("error", (error) => {
-          closeStream();
-          reject(error);
-        });
-        res.pipe(fileStream);
-      }
-    );
-    request.on("error", (error) => {
-      closeStream();
-      const code = error.code;
-      let message = `HTTP download failed for ${url}: ${error.message}
-`;
-      if (code === "ENOTFOUND") {
-        message += "DNS lookup failed. Check the hostname and your network connection.";
-      } else if (code === "ECONNREFUSED") {
-        message += "Connection refused. Verify the server is running and accessible.";
-      } else if (code === "ETIMEDOUT") {
-        message += "Request timed out. Check your network or increase the timeout value.";
-      } else if (code === "ECONNRESET") {
-        message += "Connection reset. The server may have closed the connection unexpectedly.";
-      } else {
-        message += "Check your network connection and verify the URL is correct.";
-      }
-      reject(new Error(message, { cause: error }));
-    });
-    request.on("timeout", () => {
-      request.destroy();
-      closeStream();
-      reject(new Error(`Download timed out after ${timeout}ms`));
-    });
-    request.end();
+    ...restOptions
+  } = {
+    __proto__: null,
+    ...options
+  };
+  const defaultHeaders = {
+    Accept: "application/json"
+  };
+  if (body) {
+    defaultHeaders["Content-Type"] = "application/json";
+  }
+  const mergedHeaders = {
+    ...defaultHeaders,
+    ...headers
+  };
+  const response = await httpRequest(url, {
+    body,
+    headers: mergedHeaders,
+    ...restOptions
   });
-}
-async function httpGetJson(url, options) {
-  const response = await httpRequest(url, { ...options, method: "GET" });
   if (!response.ok) {
     throw new Error(`HTTP ${response.status}: ${response.statusText}`);
   }
@@ -373,8 +362,63 @@ async function httpGetJson(url, options) {
     throw new Error("Failed to parse JSON response", { cause: e });
   }
 }
-async function httpGetText(url, options) {
-  const response = await httpRequest(url, { ...options, method: "GET" });
+async function httpRequest(url, options) {
+  const {
+    body,
+    followRedirects = true,
+    headers = {},
+    maxRedirects = 5,
+    method = "GET",
+    retries = 0,
+    retryDelay = 1e3,
+    timeout = 3e4
+  } = { __proto__: null, ...options };
+  let lastError;
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    try {
+      return await httpRequestAttempt(url, {
+        body,
+        followRedirects,
+        headers,
+        maxRedirects,
+        method,
+        timeout
+      });
+    } catch (e) {
+      lastError = e;
+      if (attempt === retries) {
+        break;
+      }
+      const delayMs = retryDelay * 2 ** attempt;
+      await new Promise((resolve) => setTimeout(resolve, delayMs));
+    }
+  }
+  throw lastError || new Error("Request failed after retries");
+}
+async function httpText(url, options) {
+  const {
+    body,
+    headers = {},
+    ...restOptions
+  } = {
+    __proto__: null,
+    ...options
+  };
+  const defaultHeaders = {
+    Accept: "text/plain"
+  };
+  if (body) {
+    defaultHeaders["Content-Type"] = "text/plain";
+  }
+  const mergedHeaders = {
+    ...defaultHeaders,
+    ...headers
+  };
+  const response = await httpRequest(url, {
+    body,
+    headers: mergedHeaders,
+    ...restOptions
+  });
   if (!response.ok) {
     throw new Error(`HTTP ${response.status}: ${response.statusText}`);
   }
@@ -383,7 +427,7 @@ async function httpGetText(url, options) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   httpDownload,
-  httpGetJson,
-  httpGetText,
-  httpRequest
+  httpJson,
+  httpRequest,
+  httpText
 });

package/dist/packages/specs.js

@@ -43,7 +43,7 @@ var import_strings = require("../strings");
 function getRepoUrlDetails(repoUrl = "") {
   const userAndRepo = repoUrl.replace(/^.+github.com\//, "").split("/");
   const user = userAndRepo[0] || "";
-  const project = userAndRepo.length > 1 ? userAndRepo[1]?.slice(0, -".git".length) || "" : "";
+  const project = userAndRepo.length > 1 ? (userAndRepo[1]?.endsWith(".git") ? userAndRepo[1].slice(0, -4) : userAndRepo[1]) || "" : "";
   return { user, project };
 }
 // @__NO_SIDE_EFFECTS__

package/dist/releases/github.d.ts

@@ -68,6 +68,24 @@ export declare const SOCKET_BTM_REPO: {
     readonly owner: "SocketDev";
     readonly repo: "socket-btm";
 };
+/**
+ * Create a matcher function for a pattern using picomatch for glob patterns
+ * or simple prefix/suffix matching for object patterns.
+ *
+ * @param pattern - Pattern to match (string glob, prefix/suffix object, or RegExp)
+ * @returns Function that tests if a string matches the pattern
+ */
+export declare function createAssetMatcher(pattern: string | {
+    prefix: string;
+    suffix: string;
+} | RegExp): (input: string) => boolean;
+/**
+ * Download a binary from any GitHub repository with version caching.
+ *
+ * @param config - Download configuration
+ * @returns Path to the downloaded binary
+ */
+export declare function downloadGitHubRelease(config: DownloadGitHubReleaseConfig): Promise<string>;
 /**
  * Download a specific release asset.
  * Supports pattern matching for dynamic asset discovery.
@@ -115,10 +133,3 @@ export declare function getLatestRelease(toolPrefix: string, repoConfig: RepoCon
 export declare function getReleaseAssetUrl(tag: string, assetPattern: string | AssetPattern, repoConfig: RepoConfig, options?: {
     quiet?: boolean;
 }): Promise<string | null>;
-/**
- * Download a binary from any GitHub repository with version caching.
- *
- * @param config - Download configuration
- * @returns Path to the downloaded binary
- */
-export declare function downloadGitHubRelease(config: DownloadGitHubReleaseConfig): Promise<string>;