@nextjswebdev/freshness

freshness

Check your package.json for outdated, stale, and deprecated dependencies using the WorkersCanDo API.

Install

npm install -g @nextjswebdev/freshness

Use

freshness             # prod dependencies
freshness --dev       # include devDependencies
freshness --json      # raw JSON output
freshness --allow-prerelease
freshness --file=path/to/package.json
freshness --endpoint=https://your-worker/analyze  # use your own deployed worker

Output includes:

• Summary counts (outdated, breaking, stale, deprecated)
• Per-package suggestions and flags
• An npm install ... command for safe upgrades

How it works

• Fetches metadata from the npm registry (latest version, publish times, deprecation messages)
• Marks stale if no release in ~18 months
• Marks deprecated if your resolved version or the latest is deprecated
• Marks breaking when latest major differs from your range
• Suggests the highest safe version inside your declared range before recommending a major jump

Environment

• Requires Node 18+ (uses built-in fetch)
• Default endpoint: https://dependency-freshness.brogee9o9.workers.dev/analyze
• Override endpoint with --endpoint or FRESHNESS_ENDPOINT