@jayf0x/npm-exists 2.0.3 → 2.0.4

package/README.md

@@ -34,6 +34,12 @@ const url = await npmExists('my-pkg', 'https://my.private.registry.io')
 const url = await npmExists('react', { silent: true })
 ```
 
+```js
+// Full metadata (GET instead of HEAD)
+const meta = await npmExists('react', { full: true })
+// → { name, description, 'dist-tags', versions, ... } | false
+```
+
 ```js
 // Build your own fetch
 import { getNpmUrl } from '@jayf0x/npm-exists'
@@ -58,10 +64,10 @@ Exit codes: `0` exists · `1` not found · `2` bad usage
 | Param | Type | Description |
 |---|---|---|
 | `pkg` | `string` | Package name |
-| `registryOrOptions` | `string \| { registry?, silent? }` | Registry URL or options object |
-| `options` | `{ silent? }` | When `silent: true`, errors return `false` instead of throwing |
+| `registryOrOptions` | `string \| { registry?, silent?, full? }` | Registry URL or options object |
+| `options` | `{ silent?, full? }` | `silent`: errors → `false`; `full`: GET full metadata instead of HEAD |
 
-Returns `Promise<string \| false>` — the npm page URL or `false` if not found.
+Returns `Promise<string \| Record<string, unknown> \| false>`
 
 ### `getNpmUrl(pkg, registry?)`
 

package/dist/index.cjs

@@ -12,18 +12,23 @@ function getPageUrl(pkg, registry) {
 async function npmExists(pkg, registryOrOptions, options) {
   let registry = DEFAULT_REGISTRY;
   let silent = false;
+  let full = false;
   if (typeof registryOrOptions === "string") {
     registry = registryOrOptions;
     silent = options?.silent ?? false;
+    full = options?.full ?? false;
   } else if (registryOrOptions != null) {
     registry = registryOrOptions.registry ?? DEFAULT_REGISTRY;
     silent = registryOrOptions.silent ?? false;
+    full = registryOrOptions.full ?? false;
   }
   try {
-    const res = await fetch(getNpmUrl(pkg, registry));
+    const res = await fetch(getNpmUrl(pkg, registry), {
+      method: full ? "GET" : "HEAD"
+    });
     if (res.status === 404) return false;
     if (!res.ok) throw new Error(`npm registry error: HTTP ${res.status}`);
-    return getPageUrl(pkg, registry);
+    return full ? res.json() : getPageUrl(pkg, registry);
   } catch (err) {
     if (silent) return false;
     throw err;

package/dist/index.d.ts

@@ -2,13 +2,20 @@ 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
+  /** Fetch full registry metadata instead of a lightweight HEAD check */
+  full?: boolean
 }
 
+/**
+ * Checks if an npm package exists.
+ * Returns the npm page URL by default, or full registry metadata with `full: true`.
+ */
 export declare function npmExists(
   pkg: string,
   registryOrOptions?: string | NpmExistsOptions,
-  options?: Pick<NpmExistsOptions, 'silent'>
-): Promise<string | false>
+  options?: Pick<NpmExistsOptions, 'silent' | 'full'>
+): Promise<string | Record<string, unknown> | false>
 
 export default npmExists

package/dist/index.js

@@ -10,18 +10,23 @@ function getPageUrl(pkg, registry) {
 async function npmExists(pkg, registryOrOptions, options) {
   let registry = DEFAULT_REGISTRY;
   let silent = false;
+  let full = false;
   if (typeof registryOrOptions === "string") {
     registry = registryOrOptions;
     silent = options?.silent ?? false;
+    full = options?.full ?? false;
   } else if (registryOrOptions != null) {
     registry = registryOrOptions.registry ?? DEFAULT_REGISTRY;
     silent = registryOrOptions.silent ?? false;
+    full = registryOrOptions.full ?? false;
   }
   try {
-    const res = await fetch(getNpmUrl(pkg, registry));
+    const res = await fetch(getNpmUrl(pkg, registry), {
+      method: full ? "GET" : "HEAD"
+    });
     if (res.status === 404) return false;
     if (!res.ok) throw new Error(`npm registry error: HTTP ${res.status}`);
-    return getPageUrl(pkg, registry);
+    return full ? res.json() : getPageUrl(pkg, registry);
   } catch (err) {
     if (silent) return false;
     throw err;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jayf0x/npm-exists",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "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": {