@jayf0x/npm-exists 2.0.3 → 2.0.5

package/README.md

@@ -59,9 +59,9 @@ Exit codes: `0` exists · `1` not found · `2` bad usage
 |---|---|---|
 | `pkg` | `string` | Package name |
 | `registryOrOptions` | `string \| { registry?, silent? }` | Registry URL or options object |
-| `options` | `{ silent? }` | When `silent: true`, errors return `false` instead of throwing |
+| `options` | `{ silent? }` | `silent: true` returns `false` instead of throwing on error |
 
-Returns `Promise<string \| false>` — the npm page URL or `false` if not found.
+Returns `Promise<string \| false>`
 
 ### `getNpmUrl(pkg, registry?)`
 

package/dist/index.cjs

@@ -20,7 +20,7 @@ async function npmExists(pkg, registryOrOptions, options) {
     silent = registryOrOptions.silent ?? false;
   }
   try {
-    const res = await fetch(getNpmUrl(pkg, registry));
+    const res = await fetch(getNpmUrl(pkg, registry), { method: "HEAD" });
     if (res.status === 404) return false;
     if (!res.ok) throw new Error(`npm registry error: HTTP ${res.status}`);
     return getPageUrl(pkg, registry);

package/dist/index.d.ts

@@ -2,13 +2,18 @@ export declare function getNpmUrl(pkg: string, registry?: string): string
 
 export interface NpmExistsOptions {
   registry?: string
+  /** Suppress errors — network/registry failures return false instead of throwing */
   silent?: boolean
 }
 
+/**
+ * Checks if an npm package exists.
+ * Returns the npm page URL, or false if not found.
+ */
 export declare function npmExists(
   pkg: string,
   registryOrOptions?: string | NpmExistsOptions,
-  options?: Pick<NpmExistsOptions, 'silent'>
+  options?: NpmExistsOptions
 ): Promise<string | false>
 
 export default npmExists

package/dist/index.js

@@ -18,7 +18,7 @@ async function npmExists(pkg, registryOrOptions, options) {
     silent = registryOrOptions.silent ?? false;
   }
   try {
-    const res = await fetch(getNpmUrl(pkg, registry));
+    const res = await fetch(getNpmUrl(pkg, registry), { method: "HEAD" });
     if (res.status === 404) return false;
     if (!res.ok) throw new Error(`npm registry error: HTTP ${res.status}`);
     return getPageUrl(pkg, registry);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jayf0x/npm-exists",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "description": "Check if an npm package name is taken. Zero dependencies, uses native fetch.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -46,8 +46,8 @@
     "typescript"
   ],
   "author": {
-    "name": "Jay Verstraete",
-    "email": "jonatanverstraete@outlook.com"
+    "name": "Jay Fox",
+    "email": "jjay56883@gmail.com"
   },
   "license": "MIT",
   "repository": {