@jayf0x/npm-exists 2.0.6 → 2.1.1

package/README.md

@@ -1,13 +1,15 @@
 # npm-exists
 
-> Check if an npm package name is taken.
+```
+⚡ HEAD → 200? true. 404? false. Done.
+```
 
 [![npm version](https://img.shields.io/npm/v/@jayf0x/npm-exists)](https://www.npmjs.com/package/@jayf0x/npm-exists)
 [![npm downloads](https://img.shields.io/npm/dm/@jayf0x/npm-exists)](https://www.npmjs.com/package/@jayf0x/npm-exists)
 [![bundle size](https://img.shields.io/bundlephobia/minzip/@jayf0x/npm-exists)](https://bundlephobia.com/package/@jayf0x/npm-exists)
 [![license](https://img.shields.io/npm/l/@jayf0x/npm-exists)](./LICENSE)
 
-Zero dependencies. Returns the npm package URL or `false`.
+The simplest, fastest possible npm package existence check. One HEAD request. No body. No regex. No deps.
 
 ## Install
 
@@ -20,52 +22,52 @@ npm install @jayf0x/npm-exists
 ```js
 import npmExists from '@jayf0x/npm-exists'
 
-const url = await npmExists('react')
-// 'https://www.npmjs.com/package/react' | false
+await npmExists('react')      // true
+await npmExists('not-a-pkg')  // false
 ```
 
 ```js
 // Custom registry
-const url = await npmExists('my-pkg', 'https://my.private.registry.io')
-```
+await npmExists('my-pkg', { registry: 'https://my.private.registry.io' })
 
-```js
-// Suppress errors (network failures return false instead of throwing)
-const url = await npmExists('react', { silent: true })
+// Suppress network errors
+await npmExists('react', { silent: true })
 ```
 
 ```js
-// Build your own fetch
+// Get the registry URL (useful with axios, ky, etc.)
 import { getNpmUrl } from '@jayf0x/npm-exists'
-const url = getNpmUrl('react') // https://registry.npmjs.org/react
+getNpmUrl('react')        // 'https://registry.npmjs.org/react'
+getNpmUrl('@types/node')  // 'https://registry.npmjs.org/%40types%2Fnode'
 ```
 
 ## CLI
 
 ```sh
 npx @jayf0x/npm-exists react
-# ✓ react@19.1.0 exists on npm
+# ✓ react exists on npm
 
-npm-exists my-pkg https://my.private.registry.io
+npm-exists my-pkg
+# ✗ my-pkg is not registered on npm
 ```
 
 Exit codes: `0` exists · `1` not found · `2` bad usage
 
 ## API
 
-### `npmExists(pkg, registryOrOptions?, options?)`
+### `npmExists(pkg, options?)`
 
-| Param | Type | Description |
-|---|---|---|
-| `pkg` | `string` | Package name |
-| `registryOrOptions` | `string \| { registry?, silent? }` | Registry URL or options object |
-| `options` | `{ silent? }` | `silent: true` returns `false` instead of throwing on error |
+| Param | Type | Default | Description |
+|---|---|---|---|
+| `pkg` | `string` | — | Package name |
+| `options.registry` | `string` | `'https://registry.npmjs.org'` | Custom registry URL |
+| `options.silent` | `boolean` | `false` | Return `false` on errors instead of throwing |
 
-Returns `Promise<string \| false>`
+Returns `Promise<boolean>`
 
 ### `getNpmUrl(pkg, registry?)`
 
-Returns the registry API URL. Useful with custom HTTP clients like axios or ky.
+Returns the registry API URL. Use this directly with your own HTTP client.
 
 ## License
 

package/bin/cli.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { npmExists } from '../dist/index.js'
+
+const [pkg, registry] = process.argv.slice(2)
+
+if (!pkg) {
+  console.error('Usage: npm-exists <package-name> [registry-url]')
+  process.exit(2)
+}
+
+const exists = await npmExists(pkg, registry ? { registry } : {})
+
+if (exists) {
+  console.log(`✓ ${pkg} exists on npm`)
+  process.exit(0)
+} else {
+  console.log(`✗ ${pkg} is not registered on npm`)
+  process.exit(1)
+}

package/dist/index.cjs

@@ -1,29 +1,20 @@
 "use strict";
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
 const DEFAULT_REGISTRY = "https://registry.npmjs.org";
-const NPM_PAGE_BASE = "https://www.npmjs.com/package";
 function getNpmUrl(pkg, registry = DEFAULT_REGISTRY) {
-  return `${registry.replace(/\/$/, "")}/${encodeURIComponent(pkg)}`;
+  const base = registry.endsWith("/") ? registry : `${registry}/`;
+  return new URL(encodeURIComponent(pkg), base).toString();
 }
-function getPageUrl(pkg, registry) {
-  const base = !registry || registry === DEFAULT_REGISTRY ? NPM_PAGE_BASE : `${registry.replace(/\/$/, "")}/package`;
-  return `${base}/${pkg}`;
-}
-async function npmExists(pkg, registryOrOptions, options) {
-  let registry = DEFAULT_REGISTRY;
-  let silent = false;
-  if (typeof registryOrOptions === "string") {
-    registry = registryOrOptions;
-    silent = options?.silent ?? false;
-  } else if (registryOrOptions != null) {
-    registry = registryOrOptions.registry ?? DEFAULT_REGISTRY;
-    silent = registryOrOptions.silent ?? false;
-  }
+async function npmExists(pkg, options = {}) {
+  const {
+    registry = DEFAULT_REGISTRY,
+    silent = false
+  } = options;
   try {
     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);
+    return true;
   } catch (err) {
     if (silent) return false;
     throw err;

package/dist/index.js

@@ -1,27 +1,18 @@
 const DEFAULT_REGISTRY = "https://registry.npmjs.org";
-const NPM_PAGE_BASE = "https://www.npmjs.com/package";
 function getNpmUrl(pkg, registry = DEFAULT_REGISTRY) {
-  return `${registry.replace(/\/$/, "")}/${encodeURIComponent(pkg)}`;
+  const base = registry.endsWith("/") ? registry : `${registry}/`;
+  return new URL(encodeURIComponent(pkg), base).toString();
 }
-function getPageUrl(pkg, registry) {
-  const base = !registry || registry === DEFAULT_REGISTRY ? NPM_PAGE_BASE : `${registry.replace(/\/$/, "")}/package`;
-  return `${base}/${pkg}`;
-}
-async function npmExists(pkg, registryOrOptions, options) {
-  let registry = DEFAULT_REGISTRY;
-  let silent = false;
-  if (typeof registryOrOptions === "string") {
-    registry = registryOrOptions;
-    silent = options?.silent ?? false;
-  } else if (registryOrOptions != null) {
-    registry = registryOrOptions.registry ?? DEFAULT_REGISTRY;
-    silent = registryOrOptions.silent ?? false;
-  }
+async function npmExists(pkg, options = {}) {
+  const {
+    registry = DEFAULT_REGISTRY,
+    silent = false
+  } = options;
   try {
     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);
+    return true;
   } catch (err) {
     if (silent) return false;
     throw err;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jayf0x/npm-exists",
-  "version": "2.0.6",
-  "description": "Check if an npm package name is taken. Zero dependencies, uses native fetch.",
+  "version": "2.1.1",
+  "description": "The fastest way to check if an npm package exists. Zero dependencies, lightweight, and uses ultra-fast HTTP HEAD requests.",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -27,7 +27,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "release": "bash publish-npm.sh",
-    "prepublishOnly": "bun run build && bun test"
+    "prepublishOnly": "bun run build && bun run test"
   },
   "keywords": [
     "npm",
@@ -52,11 +52,11 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/jayF0x/npm-exists.git"
+    "url": "https://github.com/jayf0x/npm-exists"
   },
-  "homepage": "https://github.com/jayF0x/npm-exists#readme",
+  "homepage": "https://github.com/jayf0x/npm-exists#readme",
   "bugs": {
-    "url": "https://github.com/jayF0x/npm-exists/issues"
+    "url": "https://github.com/jayf0x/npm-exists/issues"
   },
   "engines": {
     "node": ">=18"