npm-info

# Get npm Package Information

Retrieve detailed metadata for a specific npm package.

## Usage

```bash
npx tsx scripts/info.ts <package-name> [options]
```

### Arguments

| Argument | Required | Description |
|----------|----------|-------------|
| `package-name` | Yes | The exact package name (case-sensitive) |

### Options

| Option | Description |
|--------|-------------|
| `--no-cache` | Bypass cache and fetch fresh data from API |

### Output

```
react
------
Description: React is a JavaScript library for building user interfaces.
Latest: 18.2.0
License: MIT
Homepage: https://react.dev
Repository: https://github.com/facebook/react

Versions (last 5):
  18.2.0 - Published 2022-06-14
  18.1.0 - Published 2022-04-26
  18.0.0 - Published 2022-03-29
  17.0.2 - Published 2021-03-10
  17.0.1 - Published 2020-12-20

Maintainers:
  - @hzoo
  - @acdlite
```

## Script Execution (Preferred)

```bash
npx tsx scripts/info.ts <package-name> [options]
```

Options:
- `--no-cache` - Bypass cache and fetch fresh data from API

Run from the npm-registry plugin directory: `~/.claude/plugins/cache/npm-registry/`

## Package Metadata API

```
GET https://registry.npmjs.org/{package}
```

### Parameters

| Parameter | Required | Description |
|-----------|----------|-------------|
| `package` | Yes | The exact package name (case-sensitive) |

### Examples

Get package metadata:
```
https://registry.npmjs.org/react
```

## Response Format

The response contains comprehensive package metadata:

- **`name`** - Package name
- **`versions`** - Object mapping version numbers to full version metadata
- **`dist-tags`** - Tags like `latest`, `next`, `canary`
- **`time`** - Timestamps for each version publish
- **`maintainers`** - Array of package maintainers
- **`description`** - Package description
- **`homepage`** - Project homepage URL
- **`repository`** - Repository information (type, URL)
- **`bugs`** - Bug tracker URL or email
- **`license`** - License identifier
- **`author`** - A