@socketsecurity/lib 5.26.0 → 5.27.0

package/dist/fs.js

@@ -67,12 +67,15 @@ var import_process = require("./constants/process");
 var import_errors = require("./errors");
 var import_globs = require("./globs");
 var import_parse = require("./json/parse");
+var import_fs = require("./node/fs");
+var import_path = require("./node/path");
 var import_objects = require("./objects");
 var import_normalize = require("./paths/normalize");
 var import_rewire = require("./paths/rewire");
 var import_socket = require("./paths/socket");
 var import_promises = require("./promises");
 var import_sorts = require("./sorts");
+var import_primordials = require("./primordials");
 const abortSignal = (0, import_process.getAbortSignal)();
 const NEWLINE_REGEX = /\n/g;
 const defaultRemoveOptions = (0, import_objects.objectFreeze)({
@@ -84,12 +87,9 @@ const defaultRemoveOptions = (0, import_objects.objectFreeze)({
 });
 let _del;
 let _cachedAllowedDirs;
-let _buffer;
-let _fs;
-let _path;
 function getAllowedDirectories() {
   if (_cachedAllowedDirs === void 0) {
-    const path = /* @__PURE__ */ getPath();
+    const path = (0, import_path.getNodePath)();
     _cachedAllowedDirs = [
       path.resolve((0, import_socket.getOsTmpDir)()),
       path.resolve((0, import_socket.getSocketCacacheDir)()),
@@ -99,13 +99,6 @@ function getAllowedDirectories() {
   return _cachedAllowedDirs;
 }
 // @__NO_SIDE_EFFECTS__
-function getBuffer() {
-  if (_buffer === void 0) {
-    _buffer = require("node:buffer");
-  }
-  return _buffer;
-}
-// @__NO_SIDE_EFFECTS__
 function getDel() {
   if (_del === void 0) {
     _del = require("./external/del");
@@ -113,27 +106,13 @@ function getDel() {
   return _del;
 }
 // @__NO_SIDE_EFFECTS__
-function getFs() {
-  if (_fs === void 0) {
-    _fs = require("node:fs");
-  }
-  return _fs;
-}
-// @__NO_SIDE_EFFECTS__
-function getPath() {
-  if (_path === void 0) {
-    _path = require("node:path");
-  }
-  return _path;
-}
-// @__NO_SIDE_EFFECTS__
 function innerReadDirNames(dirents, dirname, options) {
   const {
     ignore,
     includeEmpty = true,
     sort = true
   } = { __proto__: null, ...options };
-  const path = /* @__PURE__ */ getPath();
+  const path = (0, import_path.getNodePath)();
   const names = dirents.filter(
     (d) => d.isDirectory() && (includeEmpty || !/* @__PURE__ */ isDirEmptySync(path.join(dirname || d.parentPath, d.name), {
       ignore
@@ -144,8 +123,8 @@ function innerReadDirNames(dirents, dirname, options) {
 // @__NO_SIDE_EFFECTS__
 function stringify(json, EOL, finalEOL, replacer, spaces = 2) {
   const EOF = finalEOL ? EOL : "";
-  const str = JSON.stringify(json, replacer, spaces);
-  return `${str.replace(NEWLINE_REGEX, EOL)}${EOF}`;
+  const str = (0, import_primordials.JSONStringify)(json, replacer, spaces);
+  return `${(0, import_primordials.StringPrototypeReplace)(str, NEWLINE_REGEX, EOL)}${EOF}`;
 }
 // @__NO_SIDE_EFFECTS__
 async function findUp(name, options) {
@@ -163,8 +142,8 @@ async function findUp(name, options) {
   if (onlyFiles) {
     onlyDirectories = false;
   }
-  const fs = /* @__PURE__ */ getFs();
-  const path = /* @__PURE__ */ getPath();
+  const fs = (0, import_fs.getNodeFs)();
+  const path = (0, import_path.getNodePath)();
   let dir = path.resolve(cwd);
   const { root } = path.parse(dir);
   const names = (0, import_arrays.isArray)(name) ? name : [name];
@@ -208,8 +187,8 @@ function findUpSync(name, options) {
   if (onlyFiles) {
     onlyDirectories = false;
   }
-  const fs = /* @__PURE__ */ getFs();
-  const path = /* @__PURE__ */ getPath();
+  const fs = (0, import_fs.getNodeFs)();
+  const path = (0, import_path.getNodePath)();
   let dir = path.resolve(cwd);
   const { root } = path.parse(dir);
   const stopDir = stopAt ? path.resolve(stopAt) : void 0;
@@ -264,7 +243,7 @@ function isDirEmptySync(dirname, options) {
     __proto__: null,
     ...options
   };
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   try {
     const files = fs.readdirSync(dirname);
     const { length } = files;
@@ -295,7 +274,7 @@ function isDirSync(filepath) {
 }
 // @__NO_SIDE_EFFECTS__
 function isSymLinkSync(filepath) {
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   try {
     return fs.lstatSync(filepath).isSymbolicLink();
   } catch {
@@ -375,7 +354,7 @@ function normalizeEncodingSlow(enc) {
 }
 // @__NO_SIDE_EFFECTS__
 async function readDirNames(dirname, options) {
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   try {
     return /* @__PURE__ */ innerReadDirNames(
       await fs.promises.readdir(dirname, {
@@ -392,7 +371,7 @@ async function readDirNames(dirname, options) {
 }
 // @__NO_SIDE_EFFECTS__
 function readDirNamesSync(dirname, options) {
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   try {
     return /* @__PURE__ */ innerReadDirNames(
       fs.readdirSync(dirname, {
@@ -410,7 +389,7 @@ function readDirNamesSync(dirname, options) {
 // @__NO_SIDE_EFFECTS__
 async function readFileBinary(filepath, options) {
   const opts = typeof options === "string" ? { encoding: options } : options;
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   return await fs.promises.readFile(filepath, {
     signal: abortSignal,
     ...opts,
@@ -420,7 +399,7 @@ async function readFileBinary(filepath, options) {
 // @__NO_SIDE_EFFECTS__
 function readFileBinarySync(filepath, options) {
   const opts = typeof options === "string" ? { encoding: options } : options;
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   return fs.readFileSync(filepath, {
     ...opts,
     encoding: null
@@ -429,7 +408,7 @@ function readFileBinarySync(filepath, options) {
 // @__NO_SIDE_EFFECTS__
 async function readFileUtf8(filepath, options) {
   const opts = typeof options === "string" ? { encoding: options } : options;
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   return await fs.promises.readFile(filepath, {
     signal: abortSignal,
     ...opts,
@@ -439,7 +418,7 @@ async function readFileUtf8(filepath, options) {
 // @__NO_SIDE_EFFECTS__
 function readFileUtf8Sync(filepath, options) {
   const opts = typeof options === "string" ? { encoding: options } : options;
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   return fs.readFileSync(filepath, {
     ...opts,
     encoding: "utf8"
@@ -453,7 +432,7 @@ async function readJson(filepath, options) {
     ...opts
   };
   const shouldThrow = throws === void 0 || !!throws;
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   let content = "";
   try {
     content = await fs.promises.readFile(filepath, {
@@ -465,14 +444,14 @@ async function readJson(filepath, options) {
     if (shouldThrow) {
       const code = e.code;
       if (code === "ENOENT") {
-        throw new Error(
+        throw new import_primordials.ErrorCtor(
           `JSON file not found: ${filepath}
 Ensure the file exists or create it with the expected structure.`,
           { cause: e }
         );
       }
       if (code === "EACCES" || code === "EPERM") {
-        throw new Error(
+        throw new import_primordials.ErrorCtor(
           `Permission denied reading JSON file: ${filepath}
 Check file permissions or run with appropriate access.`,
           { cause: e }
@@ -496,7 +475,7 @@ function readJsonSync(filepath, options) {
     ...opts
   };
   const shouldThrow = throws === void 0 || !!throws;
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   let content = "";
   try {
     content = fs.readFileSync(filepath, {
@@ -508,14 +487,14 @@ function readJsonSync(filepath, options) {
     if (shouldThrow) {
       const code = e.code;
       if (code === "ENOENT") {
-        throw new Error(
+        throw new import_primordials.ErrorCtor(
           `JSON file not found: ${filepath}
 Ensure the file exists or create it with the expected structure.`,
           { cause: e }
         );
       }
       if (code === "EACCES" || code === "EPERM") {
-        throw new Error(
+        throw new import_primordials.ErrorCtor(
           `Permission denied reading JSON file: ${filepath}
 Check file permissions or run with appropriate access.`,
           { cause: e }
@@ -536,14 +515,14 @@ async function safeDelete(filepath, options) {
   const patterns = (0, import_arrays.isArray)(filepath) ? filepath.map(import_normalize.pathLikeToString) : [(0, import_normalize.pathLikeToString)(filepath)];
   let shouldForce = opts.force !== false;
   if (!shouldForce && patterns.length > 0) {
-    const path = /* @__PURE__ */ getPath();
+    const path = (0, import_path.getNodePath)();
     const allowedDirs = getAllowedDirectories();
     const allInAllowedDirs = patterns.every((pattern) => {
       const resolvedPath = path.resolve(pattern);
       for (const allowedDir of allowedDirs) {
-        const isInAllowedDir = resolvedPath.startsWith(allowedDir + path.sep) || resolvedPath === allowedDir;
+        const isInAllowedDir = (0, import_primordials.StringPrototypeStartsWith)(resolvedPath, allowedDir + path.sep) || resolvedPath === allowedDir;
         const relativePath = path.relative(allowedDir, resolvedPath);
-        const isGoingBackward = relativePath.startsWith("..");
+        const isGoingBackward = (0, import_primordials.StringPrototypeStartsWith)(relativePath, "..");
         if (isInAllowedDir && !isGoingBackward) {
           return true;
         }
@@ -578,14 +557,14 @@ function safeDeleteSync(filepath, options) {
   const patterns = (0, import_arrays.isArray)(filepath) ? filepath.map(import_normalize.pathLikeToString) : [(0, import_normalize.pathLikeToString)(filepath)];
   let shouldForce = opts.force !== false;
   if (!shouldForce && patterns.length > 0) {
-    const path = /* @__PURE__ */ getPath();
+    const path = (0, import_path.getNodePath)();
     const allowedDirs = getAllowedDirectories();
     const allInAllowedDirs = patterns.every((pattern) => {
       const resolvedPath = path.resolve(pattern);
       for (const allowedDir of allowedDirs) {
-        const isInAllowedDir = resolvedPath.startsWith(allowedDir + path.sep) || resolvedPath === allowedDir;
+        const isInAllowedDir = (0, import_primordials.StringPrototypeStartsWith)(resolvedPath, allowedDir + path.sep) || resolvedPath === allowedDir;
         const relativePath = path.relative(allowedDir, resolvedPath);
-        const isGoingBackward = relativePath.startsWith("..");
+        const isGoingBackward = (0, import_primordials.StringPrototypeStartsWith)(relativePath, "..");
         if (isInAllowedDir && !isGoingBackward) {
           return true;
         }
@@ -613,7 +592,12 @@ function safeDeleteSync(filepath, options) {
       lastError = e;
       if (attempt < maxRetries) {
         const waitMs = delay;
-        Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, waitMs);
+        (0, import_primordials.AtomicsWait)(
+          new import_primordials.Int32ArrayCtor(new import_primordials.SharedArrayBufferCtor(4)),
+          0,
+          0,
+          waitMs
+        );
         delay *= 2;
       }
     }
@@ -623,7 +607,7 @@ function safeDeleteSync(filepath, options) {
   }
 }
 async function safeMkdir(path, options) {
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   const opts = { __proto__: null, recursive: true, ...options };
   try {
     await fs.promises.mkdir(path, opts);
@@ -634,7 +618,7 @@ async function safeMkdir(path, options) {
   }
 }
 function safeMkdirSync(path, options) {
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   const opts = { __proto__: null, recursive: true, ...options };
   try {
     fs.mkdirSync(path, opts);
@@ -651,7 +635,7 @@ async function safeReadFile(filepath, options) {
   const readOpts = { __proto__: null, ...rawReadOpts };
   const shouldReturnBuffer = readOpts.encoding === null;
   const encoding = shouldReturnBuffer ? null : /* @__PURE__ */ normalizeEncoding(readOpts.encoding);
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   try {
     return await fs.promises.readFile(filepath, {
       __proto__: null,
@@ -665,8 +649,7 @@ async function safeReadFile(filepath, options) {
     return void 0;
   }
   if (shouldReturnBuffer) {
-    const { Buffer: Buffer2 } = /* @__PURE__ */ getBuffer();
-    return Buffer2.isBuffer(defaultValue) ? defaultValue : void 0;
+    return (0, import_primordials.BufferIsBuffer)(defaultValue) ? defaultValue : void 0;
   }
   return typeof defaultValue === "string" ? defaultValue : String(defaultValue);
 }
@@ -677,7 +660,7 @@ function safeReadFileSync(filepath, options) {
   const readOpts = { __proto__: null, ...rawReadOpts };
   const shouldReturnBuffer = readOpts.encoding === null;
   const encoding = shouldReturnBuffer ? null : /* @__PURE__ */ normalizeEncoding(readOpts.encoding);
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   try {
     return fs.readFileSync(filepath, {
       __proto__: null,
@@ -690,14 +673,13 @@ function safeReadFileSync(filepath, options) {
     return void 0;
   }
   if (shouldReturnBuffer) {
-    const { Buffer: Buffer2 } = /* @__PURE__ */ getBuffer();
-    return Buffer2.isBuffer(defaultValue) ? defaultValue : void 0;
+    return (0, import_primordials.BufferIsBuffer)(defaultValue) ? defaultValue : void 0;
   }
   return typeof defaultValue === "string" ? defaultValue : String(defaultValue);
 }
 // @__NO_SIDE_EFFECTS__
 async function safeStats(filepath) {
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   try {
     return await fs.promises.stat(filepath);
   } catch {
@@ -706,7 +688,7 @@ async function safeStats(filepath) {
 }
 // @__NO_SIDE_EFFECTS__
 function safeStatsSync(filepath) {
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   try {
     return fs.statSync(filepath, {
       __proto__: null,
@@ -718,8 +700,8 @@ function safeStatsSync(filepath) {
 }
 // @__NO_SIDE_EFFECTS__
 function uniqueSync(filepath) {
-  const fs = /* @__PURE__ */ getFs();
-  const path = /* @__PURE__ */ getPath();
+  const fs = (0, import_fs.getNodeFs)();
+  const path = (0, import_path.getNodePath)();
   const filepathStr = String(filepath);
   if (!fs.existsSync(filepathStr)) {
     return (0, import_normalize.normalizePath)(filepathStr);
@@ -737,7 +719,7 @@ function uniqueSync(filepath) {
 }
 // @__NO_SIDE_EFFECTS__
 function validateFiles(filepaths) {
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   const validPaths = [];
   const invalidPaths = [];
   const { R_OK } = fs.constants;
@@ -757,7 +739,7 @@ async function writeJson(filepath, jsonContent, options) {
     __proto__: null,
     ...opts
   };
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   const jsonString = /* @__PURE__ */ stringify(
     jsonContent,
     EOL || "\n",
@@ -777,7 +759,7 @@ function writeJsonSync(filepath, jsonContent, options) {
     __proto__: null,
     ...opts
   };
-  const fs = /* @__PURE__ */ getFs();
+  const fs = (0, import_fs.getNodeFs)();
   const jsonString = /* @__PURE__ */ stringify(
     jsonContent,
     EOL || "\n",

package/dist/git.js

@@ -52,13 +52,14 @@ var import_globs = require("./globs");
 var import_normalize = require("./paths/normalize");
 var import_spawn = require("./spawn");
 var import_strings = require("./strings");
+var import_primordials = require("./primordials");
 let _fs;
 let _path;
-const gitDiffCache = /* @__PURE__ */ new Map();
+const gitDiffCache = new import_primordials.MapCtor();
 const GIT_CACHE_MAX_SIZE = 100;
 let _gitPath;
-const realpathCache = /* @__PURE__ */ new Map();
-const gitRootCache = /* @__PURE__ */ new Map();
+const realpathCache = new import_primordials.MapCtor();
+const gitRootCache = new import_primordials.MapCtor();
 function getCachedGitDiff(key) {
   const result = gitDiffCache.get(key);
   if (result) {
@@ -68,7 +69,7 @@ function getCachedGitDiff(key) {
   return result;
 }
 function stableKey(value) {
-  return JSON.stringify(value, (_key, val) => {
+  return (0, import_primordials.JSONStringify)(value, (_key, val) => {
     if (val && typeof val === "object" && !Array.isArray(val)) {
       const sorted = {};
       for (const k of Object.keys(val).sort()) {
@@ -166,7 +167,7 @@ async function innerDiff(args, options) {
       ...args[2],
       stdioString: false
     });
-    const stdout = Buffer.isBuffer(spawnResult.stdout) ? spawnResult.stdout.toString("utf8") : String(spawnResult.stdout);
+    const stdout = (0, import_primordials.BufferIsBuffer)(spawnResult.stdout) ? spawnResult.stdout.toString("utf8") : String(spawnResult.stdout);
     const spawnCwd = typeof args[2]["cwd"] === "string" ? args[2]["cwd"] : void 0;
     result = parseGitDiffStdout(stdout, parseOptions, spawnCwd);
   } catch (e) {
@@ -196,7 +197,7 @@ function innerDiffSync(args, options) {
       ...args[2],
       stdioString: false
     });
-    const stdout = Buffer.isBuffer(spawnResult.stdout) ? spawnResult.stdout.toString("utf8") : String(spawnResult.stdout);
+    const stdout = (0, import_primordials.BufferIsBuffer)(spawnResult.stdout) ? spawnResult.stdout.toString("utf8") : String(spawnResult.stdout);
     const spawnCwd = typeof args[2]["cwd"] === "string" ? args[2]["cwd"] : void 0;
     result = parseGitDiffStdout(stdout, parseOptions, spawnCwd);
   } catch (e) {
@@ -225,7 +226,7 @@ function parseGitDiffStdout(stdout, options, spawnCwd) {
   let rawFiles = stdout ? (0, import_strings.stripAnsi)(stdout).split(/\r?\n/).map((line) => line.trimEnd()).filter((line) => line) : [];
   if (porcelain) {
     rawFiles = rawFiles.map((line) => {
-      return line.length > 3 ? line.substring(3) : line;
+      return line.length > 3 ? (0, import_primordials.StringPrototypeSubstring)(line, 3) : line;
     });
   }
   const files = absolute ? rawFiles.map((relPath2) => (0, import_normalize.normalizePath)(path.join(rootPath, relPath2))) : rawFiles.map((relPath2) => (0, import_normalize.normalizePath)(relPath2));
@@ -324,7 +325,7 @@ async function isChanged(pathname, options) {
   const resolvedPathname = getCachedRealpath(pathname);
   const baseCwd = options?.cwd ? getCachedRealpath(options["cwd"]) : getCwd();
   const relativePath = (0, import_normalize.normalizePath)(path.relative(baseCwd, resolvedPathname));
-  return files.includes(relativePath);
+  return (0, import_primordials.ArrayPrototypeIncludes)(files, relativePath);
 }
 function isChangedSync(pathname, options) {
   const files = getChangedFilesSync({
@@ -337,7 +338,7 @@ function isChangedSync(pathname, options) {
     const resolvedPathname = getCachedRealpath(pathname);
     const baseCwd = options?.cwd ? getCachedRealpath(options["cwd"]) : getCwd();
     const relativePath = (0, import_normalize.normalizePath)(path.relative(baseCwd, resolvedPathname));
-    return files.includes(relativePath);
+    return (0, import_primordials.ArrayPrototypeIncludes)(files, relativePath);
   } catch {
     return false;
   }
@@ -352,7 +353,7 @@ async function isStaged(pathname, options) {
   const resolvedPathname = getCachedRealpath(pathname);
   const baseCwd = options?.cwd ? getCachedRealpath(options["cwd"]) : getCwd();
   const relativePath = (0, import_normalize.normalizePath)(path.relative(baseCwd, resolvedPathname));
-  return files.includes(relativePath);
+  return (0, import_primordials.ArrayPrototypeIncludes)(files, relativePath);
 }
 function isStagedSync(pathname, options) {
   const files = getStagedFilesSync({
@@ -364,7 +365,7 @@ function isStagedSync(pathname, options) {
   const resolvedPathname = getCachedRealpath(pathname);
   const baseCwd = options?.cwd ? getCachedRealpath(options["cwd"]) : getCwd();
   const relativePath = (0, import_normalize.normalizePath)(path.relative(baseCwd, resolvedPathname));
-  return files.includes(relativePath);
+  return (0, import_primordials.ArrayPrototypeIncludes)(files, relativePath);
 }
 async function isUnstaged(pathname, options) {
   const files = await getUnstagedFiles({
@@ -376,7 +377,7 @@ async function isUnstaged(pathname, options) {
   const resolvedPathname = getCachedRealpath(pathname);
   const baseCwd = options?.cwd ? getCachedRealpath(options["cwd"]) : getCwd();
   const relativePath = (0, import_normalize.normalizePath)(path.relative(baseCwd, resolvedPathname));
-  return files.includes(relativePath);
+  return (0, import_primordials.ArrayPrototypeIncludes)(files, relativePath);
 }
 function isUnstagedSync(pathname, options) {
   const files = getUnstagedFilesSync({
@@ -388,7 +389,7 @@ function isUnstagedSync(pathname, options) {
   const resolvedPathname = getCachedRealpath(pathname);
   const baseCwd = options?.cwd ? getCachedRealpath(options["cwd"]) : getCwd();
   const relativePath = (0, import_normalize.normalizePath)(path.relative(baseCwd, resolvedPathname));
-  return files.includes(relativePath);
+  return (0, import_primordials.ArrayPrototypeIncludes)(files, relativePath);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/github.d.ts

@@ -21,6 +21,40 @@
  * - Cache to minimize API calls
  */
 import type { SpawnOptions } from './spawn';
+/**
+ * Thrown by `fetchGitHub` when GitHub returns HTTP 200 OK with a
+ * zero-byte body — the "successful empty response" pattern.
+ *
+ * Why this exists (background for new contributors):
+ *   GitHub's REST API has a documented failure mode that is *very*
+ *   easy to miss in code review. During incidents where the search
+ *   / Elasticsearch backing index is degraded (see GitHub status
+ *   pages with titles like "search is degraded" or "Pull Requests
+ *   degraded"), the REST `/repos/...` GET endpoints return:
+ *     - HTTP status: 200 OK   ← looks like success
+ *     - Body:        ""       ← but the payload is empty
+ *     - Headers:     no Retry-After, no rate-limit signal, nothing
+ *
+ *   Without a typed error, calling code does
+ *     `JSON.parse(response.body.toString('utf8'))`
+ *   on an empty string, which throws a confusing
+ *   `SyntaxError: Unexpected end of JSON input`. That error has
+ *   nothing to do with our code — but it's the only signal upstream
+ *   sees. This class wraps that case in a *named* error so callers
+ *   can `instanceof GitHubEmptyBodyError` and choose what to do:
+ *   retry the same endpoint later, fall back to GraphQL (which uses
+ *   a different backend and is unaffected by ES outages), or surface
+ *   a clean message to the user.
+ *
+ *   The HTTP status is hard-coded to 200 because that's *exactly*
+ *   what makes this insidious — a real 4xx/5xx would already be
+ *   handled by the rate-limit / status-code branch above.
+ */
+export declare class GitHubEmptyBodyError extends Error {
+    /** HTTP status (always 200 — that's what makes this case insidious). */
+    status: number;
+    constructor(url: string);
+}
 /**
  * Options for GitHub API fetch requests.
  */