cve-lite-cli 1.3.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,258 @@
1
+ import { compareVersions, looksLikeVersion } from "../utils/version.js";
2
+ const packumentCache = new Map();
3
+ const DEFAULT_NPM_REGISTRY_URL = "https://registry.npmjs.org";
4
+ export function clearPackumentCache() {
5
+ packumentCache.clear();
6
+ }
7
+ export async function fetchPackument(packageName) {
8
+ if (packumentCache.has(packageName)) {
9
+ return packumentCache.get(packageName) ?? null;
10
+ }
11
+ const url = `${DEFAULT_NPM_REGISTRY_URL}/${encodeURIComponent(packageName)
12
+ .replace(/%40/g, "@")
13
+ .replace(/%2F/g, "/")}`;
14
+ try {
15
+ const response = await fetch(url);
16
+ if (!response.ok) {
17
+ packumentCache.set(packageName, null);
18
+ return null;
19
+ }
20
+ const json = (await response.json());
21
+ packumentCache.set(packageName, json);
22
+ return json;
23
+ }
24
+ catch {
25
+ packumentCache.set(packageName, null);
26
+ return null;
27
+ }
28
+ }
29
+ export async function packageVersionExists(packageName, version) {
30
+ const packument = await fetchPackument(packageName);
31
+ if (!packument)
32
+ return null;
33
+ return Boolean(packument.versions && version in packument.versions);
34
+ }
35
+ export async function resolvePublishedFixVersion(packageName, fixedVersionHint) {
36
+ const packument = await fetchPackument(packageName);
37
+ if (!packument) {
38
+ return {
39
+ resolvedVersion: null,
40
+ note: `Fixed-version hint ${fixedVersionHint} could not be verified against the npm registry for ${packageName}.`,
41
+ verified: false,
42
+ candidatesChecked: 0,
43
+ candidatesKnownVulnerable: 0,
44
+ candidatesUnknownCoverage: 0,
45
+ };
46
+ }
47
+ const publishedVersions = Object.keys(packument.versions ?? {})
48
+ .filter(looksLikeVersion)
49
+ .sort(compareVersions);
50
+ if (publishedVersions.includes(fixedVersionHint)) {
51
+ return {
52
+ resolvedVersion: fixedVersionHint,
53
+ note: null,
54
+ verified: true,
55
+ candidatesChecked: 0,
56
+ candidatesKnownVulnerable: 0,
57
+ candidatesUnknownCoverage: 0,
58
+ };
59
+ }
60
+ const nearestPublishedVersion = publishedVersions.find(version => compareVersions(version, fixedVersionHint) >= 0) ?? null;
61
+ if (nearestPublishedVersion) {
62
+ return {
63
+ resolvedVersion: nearestPublishedVersion,
64
+ note: `Advisory fixed-version hint ${fixedVersionHint} is not published on npm for ${packageName}; using nearest published version ${nearestPublishedVersion}.`,
65
+ verified: true,
66
+ candidatesChecked: 0,
67
+ candidatesKnownVulnerable: 0,
68
+ candidatesUnknownCoverage: 0,
69
+ };
70
+ }
71
+ return {
72
+ resolvedVersion: null,
73
+ note: `Advisory fixed-version hint ${fixedVersionHint} is not published on npm for ${packageName}, and no published version >= ${fixedVersionHint} was found.`,
74
+ verified: true,
75
+ candidatesChecked: 0,
76
+ candidatesKnownVulnerable: 0,
77
+ candidatesUnknownCoverage: 0,
78
+ };
79
+ }
80
+ export async function resolveLowestKnownNonVulnerableVersion(packageName, installedVersion, vulnerabilities) {
81
+ if (!looksLikeVersion(installedVersion)) {
82
+ return {
83
+ resolvedVersion: null,
84
+ note: `Installed version ${installedVersion} for ${packageName} could not be evaluated as an exact semver version.`,
85
+ verified: false,
86
+ candidatesChecked: 0,
87
+ candidatesKnownVulnerable: 0,
88
+ candidatesUnknownCoverage: 0,
89
+ };
90
+ }
91
+ if (vulnerabilities.length === 0) {
92
+ return {
93
+ resolvedVersion: null,
94
+ note: `No advisory details were available to validate a lowest known non-vulnerable version for ${packageName}.`,
95
+ verified: false,
96
+ candidatesChecked: 0,
97
+ candidatesKnownVulnerable: 0,
98
+ candidatesUnknownCoverage: 0,
99
+ };
100
+ }
101
+ const packument = await fetchPackument(packageName);
102
+ if (!packument) {
103
+ return {
104
+ resolvedVersion: null,
105
+ note: `Published versions for ${packageName} could not be verified against the npm registry.`,
106
+ verified: false,
107
+ candidatesChecked: 0,
108
+ candidatesKnownVulnerable: 0,
109
+ candidatesUnknownCoverage: 0,
110
+ };
111
+ }
112
+ const candidates = Object.keys(packument.versions ?? {})
113
+ .filter(looksLikeVersion)
114
+ .filter(version => compareVersions(version, installedVersion) > 0)
115
+ .sort(compareVersions);
116
+ if (candidates.length === 0) {
117
+ return {
118
+ resolvedVersion: null,
119
+ note: `No published versions above ${installedVersion} were found for ${packageName}.`,
120
+ verified: true,
121
+ candidatesChecked: 0,
122
+ candidatesKnownVulnerable: 0,
123
+ candidatesUnknownCoverage: 0,
124
+ };
125
+ }
126
+ let candidatesChecked = 0;
127
+ let candidatesKnownVulnerable = 0;
128
+ let candidatesUnknownCoverage = 0;
129
+ let sawUnknownCoverage = false;
130
+ for (const candidate of candidates) {
131
+ candidatesChecked += 1;
132
+ let affected = false;
133
+ let unknown = false;
134
+ for (const vuln of vulnerabilities) {
135
+ const impacted = isVersionAffectedByVulnerability(packageName, candidate, vuln);
136
+ if (impacted === true) {
137
+ affected = true;
138
+ break;
139
+ }
140
+ if (impacted === null) {
141
+ unknown = true;
142
+ }
143
+ }
144
+ if (affected) {
145
+ candidatesKnownVulnerable += 1;
146
+ continue;
147
+ }
148
+ if (unknown) {
149
+ sawUnknownCoverage = true;
150
+ candidatesUnknownCoverage += 1;
151
+ continue;
152
+ }
153
+ return {
154
+ resolvedVersion: candidate,
155
+ note: null,
156
+ verified: true,
157
+ candidatesChecked,
158
+ candidatesKnownVulnerable,
159
+ candidatesUnknownCoverage,
160
+ };
161
+ }
162
+ if (sawUnknownCoverage) {
163
+ return {
164
+ resolvedVersion: null,
165
+ note: `Advisory range data for ${packageName} is incomplete, so a lowest known non-vulnerable version could not be confirmed.`,
166
+ verified: false,
167
+ candidatesChecked,
168
+ candidatesKnownVulnerable,
169
+ candidatesUnknownCoverage,
170
+ };
171
+ }
172
+ return {
173
+ resolvedVersion: null,
174
+ note: `No known non-vulnerable published version was found above ${installedVersion} for ${packageName}.`,
175
+ verified: true,
176
+ candidatesChecked,
177
+ candidatesKnownVulnerable,
178
+ candidatesUnknownCoverage,
179
+ };
180
+ }
181
+ function isVersionAffectedByVulnerability(packageName, version, vuln) {
182
+ const affectedEntries = vuln.affected ?? [];
183
+ if (affectedEntries.length === 0)
184
+ return null;
185
+ const matchingEntries = affectedEntries.filter(entry => {
186
+ const affectedName = entry.package?.name;
187
+ const affectedEcosystem = entry.package?.ecosystem?.toLowerCase();
188
+ if (affectedName && affectedName !== packageName)
189
+ return false;
190
+ if (affectedEcosystem && affectedEcosystem !== "npm")
191
+ return false;
192
+ return true;
193
+ });
194
+ if (matchingEntries.length === 0)
195
+ return null;
196
+ let sawUnknown = false;
197
+ for (const entry of matchingEntries) {
198
+ const ranges = entry.ranges ?? [];
199
+ if (ranges.length === 0) {
200
+ sawUnknown = true;
201
+ continue;
202
+ }
203
+ for (const range of ranges) {
204
+ if (range.type && range.type !== "SEMVER") {
205
+ sawUnknown = true;
206
+ continue;
207
+ }
208
+ const impacted = isVersionAffectedByEvents(version, range.events ?? []);
209
+ if (impacted === true)
210
+ return true;
211
+ if (impacted === null)
212
+ sawUnknown = true;
213
+ }
214
+ }
215
+ return sawUnknown ? null : false;
216
+ }
217
+ function isVersionAffectedByEvents(version, events) {
218
+ if (events.length === 0)
219
+ return null;
220
+ let introduced = null;
221
+ let sawComparableWindow = false;
222
+ for (const event of events) {
223
+ if (event.introduced !== undefined) {
224
+ if (event.introduced !== "0" && !looksLikeVersion(event.introduced)) {
225
+ return null;
226
+ }
227
+ introduced = event.introduced;
228
+ }
229
+ if (event.fixed !== undefined || event.last_affected !== undefined) {
230
+ if (event.fixed && !looksLikeVersion(event.fixed))
231
+ return null;
232
+ if (event.last_affected && !looksLikeVersion(event.last_affected))
233
+ return null;
234
+ sawComparableWindow = true;
235
+ const lowerBoundOk = introduced === null || introduced === "0" || compareVersions(version, introduced) >= 0;
236
+ const upperBoundOk = event.fixed
237
+ ? compareVersions(version, event.fixed) < 0
238
+ : event.last_affected
239
+ ? compareVersions(version, event.last_affected) <= 0
240
+ : true;
241
+ if (lowerBoundOk && upperBoundOk) {
242
+ return true;
243
+ }
244
+ introduced = null;
245
+ }
246
+ }
247
+ if (introduced !== null) {
248
+ if (introduced !== "0" && !looksLikeVersion(introduced))
249
+ return null;
250
+ sawComparableWindow = true;
251
+ const lowerBoundOk = introduced === "0" || compareVersions(version, introduced) >= 0;
252
+ if (lowerBoundOk)
253
+ return true;
254
+ }
255
+ if (!sawComparableWindow)
256
+ return null;
257
+ return false;
258
+ }
@@ -1,6 +1,5 @@
1
1
  import { compareVersions, looksLikeVersion } from "../utils/version.js";
2
- const packumentCache = new Map();
3
- const DEFAULT_NPM_REGISTRY_URL = "https://registry.npmjs.org";
2
+ import { fetchPackument } from "./npm-registry.js";
4
3
  export async function resolveRecommendedParentUpgrade(finding, packages) {
5
4
  if (finding.relationship !== "transitive")
6
5
  return null;
@@ -21,7 +20,7 @@ export async function resolveRecommendedParentUpgrade(finding, packages) {
21
20
  directParentVersion: directParent.version,
22
21
  vulnerableName,
23
22
  vulnerableInstalledVersion: finding.pkg.version,
24
- vulnerableFixedVersion: finding.firstFixedVersion,
23
+ vulnerableFixedVersion: finding.validatedFirstFixedVersion ?? finding.firstFixedVersion,
25
24
  viaPath,
26
25
  });
27
26
  }
@@ -132,22 +131,6 @@ async function findUpgradeForImmediateIntermediate(args) {
132
131
  }
133
132
  return null;
134
133
  }
135
- async function fetchPackument(packageName) {
136
- if (packumentCache.has(packageName)) {
137
- return packumentCache.get(packageName) ?? null;
138
- }
139
- const url = `${DEFAULT_NPM_REGISTRY_URL}/${encodeURIComponent(packageName)
140
- .replace(/%40/g, "@")
141
- .replace(/%2F/g, "/")}`;
142
- const response = await fetch(url);
143
- if (!response.ok) {
144
- packumentCache.set(packageName, null);
145
- return null;
146
- }
147
- const json = (await response.json());
148
- packumentCache.set(packageName, json);
149
- return json;
150
- }
151
134
  function versionSatisfiesRange(version, rawRange) {
152
135
  const range = rawRange.trim();
153
136
  if (!range)
package/dist/scanner.js CHANGED
@@ -8,6 +8,7 @@ import { LocalAdvisorySource } from "./advisory/local-advisory-source.js";
8
8
  import { LocalAdvisoryDatabase } from "./advisory/local-db.js";
9
9
  import { ADVISORY_DB_STALE_AFTER_MS, getDefaultAdvisoryDbPath } from "./advisory/osv-sync.js";
10
10
  import { resolveRecommendedParentUpgrade } from "./remediation/parent-upgrade.js";
11
+ import { resolveLowestKnownNonVulnerableVersion, resolvePublishedFixVersion } from "./remediation/npm-registry.js";
11
12
  export function createAdvisorySource(options) {
12
13
  const offline = !!options?.offline || !!options?.offlineDb;
13
14
  if (offline) {
@@ -174,9 +175,16 @@ export async function scanPackages(packages, batchSize, options) {
174
175
  dependencyPaths,
175
176
  relationship,
176
177
  firstFixedVersion,
178
+ validatedFirstFixedVersion: null,
179
+ fixVersionValidationNote: null,
180
+ validatedTargetScannedVersions: null,
181
+ validatedTargetKnownVulnerableVersions: null,
177
182
  recommendedParentUpgrade: undefined,
178
183
  };
179
184
  });
185
+ if (!offline) {
186
+ await validateDirectFixTargets(findings);
187
+ }
180
188
  for (const finding of findings) {
181
189
  if (finding.relationship !== "transitive" || offline)
182
190
  continue;
@@ -197,6 +205,43 @@ export async function scanPackages(packages, batchSize, options) {
197
205
  sourceContext.cleanup();
198
206
  }
199
207
  }
208
+ async function validateDirectFixTargets(findings) {
209
+ const directCandidates = findings.filter(finding => finding.vulnerabilities.length > 0);
210
+ for (const finding of directCandidates) {
211
+ const lowestKnownResolution = await resolveLowestKnownNonVulnerableVersion(finding.pkg.name, finding.pkg.version, finding.vulnerabilities);
212
+ const fixedVersionHint = finding.firstFixedVersion;
213
+ if (lowestKnownResolution.resolvedVersion) {
214
+ finding.validatedFirstFixedVersion = lowestKnownResolution.resolvedVersion;
215
+ finding.validatedTargetScannedVersions = lowestKnownResolution.candidatesChecked;
216
+ finding.validatedTargetKnownVulnerableVersions = lowestKnownResolution.candidatesKnownVulnerable;
217
+ if (!fixedVersionHint || fixedVersionHint === lowestKnownResolution.resolvedVersion) {
218
+ finding.fixVersionValidationNote = null;
219
+ continue;
220
+ }
221
+ const hintResolution = await resolvePublishedFixVersion(finding.pkg.name, fixedVersionHint);
222
+ if (hintResolution.resolvedVersion === lowestKnownResolution.resolvedVersion &&
223
+ hintResolution.note) {
224
+ finding.fixVersionValidationNote = hintResolution.note;
225
+ continue;
226
+ }
227
+ finding.fixVersionValidationNote =
228
+ `Advisory fixed-version hint ${fixedVersionHint} is still known vulnerable for ${finding.pkg.name}; scanned ${lowestKnownResolution.candidatesChecked} package version${lowestKnownResolution.candidatesChecked === 1 ? "" : "s"} above current version (${lowestKnownResolution.candidatesKnownVulnerable} still known vulnerable); using lowest known non-vulnerable version ${lowestKnownResolution.resolvedVersion}.`;
229
+ continue;
230
+ }
231
+ if (!fixedVersionHint) {
232
+ finding.validatedFirstFixedVersion = null;
233
+ finding.fixVersionValidationNote = lowestKnownResolution.note;
234
+ finding.validatedTargetScannedVersions = null;
235
+ finding.validatedTargetKnownVulnerableVersions = null;
236
+ continue;
237
+ }
238
+ const resolution = await resolvePublishedFixVersion(finding.pkg.name, fixedVersionHint);
239
+ finding.validatedFirstFixedVersion = resolution.resolvedVersion;
240
+ finding.fixVersionValidationNote = resolution.note ?? lowestKnownResolution.note;
241
+ finding.validatedTargetScannedVersions = null;
242
+ finding.validatedTargetKnownVulnerableVersions = null;
243
+ }
244
+ }
200
245
  function isAdvisoryDbStale(metadata) {
201
246
  if (!metadata.lastSyncAt) {
202
247
  return true;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cve-lite-cli",
3
- "version": "1.3.0",
3
+ "version": "1.5.0",
4
4
  "description": "Developer-friendly CLI for scanning JS/TS projects for dependency vulnerabilities using local lockfiles and OSV",
5
5
  "type": "module",
6
6
  "bin": {