@cyclonedx/cdxgen 12.1.5 → 12.2.1

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.
Files changed (193) hide show
  1. package/README.md +51 -40
  2. package/bin/cdxgen.js +194 -97
  3. package/bin/evinse.js +4 -4
  4. package/bin/repl.js +1 -1
  5. package/bin/sign.js +102 -0
  6. package/bin/validate.js +233 -0
  7. package/bin/verify.js +69 -28
  8. package/data/queries.json +1 -1
  9. package/data/rules/ci-permissions.yaml +186 -0
  10. package/data/rules/dependency-sources.yaml +123 -0
  11. package/data/rules/package-integrity.yaml +135 -0
  12. package/data/rules/vscode-extensions.yaml +228 -0
  13. package/lib/cli/index.js +449 -429
  14. package/lib/cli/index.poku.js +117 -0
  15. package/lib/evinser/db.js +137 -0
  16. package/lib/{helpers → evinser}/db.poku.js +2 -6
  17. package/lib/evinser/evinser.js +2 -14
  18. package/lib/helpers/analyzer.js +606 -3
  19. package/lib/helpers/analyzer.poku.js +230 -0
  20. package/lib/helpers/bomSigner.js +312 -0
  21. package/lib/helpers/bomSigner.poku.js +156 -0
  22. package/lib/helpers/ciParsers/azurePipelines.js +295 -0
  23. package/lib/helpers/ciParsers/azurePipelines.poku.js +253 -0
  24. package/lib/helpers/ciParsers/circleCi.js +286 -0
  25. package/lib/helpers/ciParsers/circleCi.poku.js +230 -0
  26. package/lib/helpers/ciParsers/common.js +24 -0
  27. package/lib/helpers/ciParsers/githubActions.js +636 -0
  28. package/lib/helpers/ciParsers/githubActions.poku.js +802 -0
  29. package/lib/helpers/ciParsers/gitlabCi.js +213 -0
  30. package/lib/helpers/ciParsers/gitlabCi.poku.js +247 -0
  31. package/lib/helpers/ciParsers/jenkins.js +181 -0
  32. package/lib/helpers/ciParsers/jenkins.poku.js +197 -0
  33. package/lib/helpers/depsUtils.js +219 -0
  34. package/lib/helpers/depsUtils.poku.js +207 -0
  35. package/lib/helpers/display.js +426 -5
  36. package/lib/helpers/envcontext.js +18 -3
  37. package/lib/helpers/formulationParsers.js +351 -0
  38. package/lib/helpers/logger.js +14 -0
  39. package/lib/helpers/protobom.js +9 -9
  40. package/lib/helpers/pythonutils.js +9 -0
  41. package/lib/helpers/remote/dependency-track.js +84 -0
  42. package/lib/helpers/remote/dependency-track.poku.js +119 -0
  43. package/lib/helpers/table.js +384 -0
  44. package/lib/helpers/table.poku.js +186 -0
  45. package/lib/helpers/utils.js +865 -416
  46. package/lib/helpers/utils.poku.js +172 -265
  47. package/lib/helpers/versutils.js +202 -0
  48. package/lib/helpers/versutils.poku.js +315 -0
  49. package/lib/helpers/vsixutils.js +1061 -0
  50. package/lib/helpers/vsixutils.poku.js +2247 -0
  51. package/lib/managers/binary.js +19 -19
  52. package/lib/managers/docker.js +108 -1
  53. package/lib/managers/oci.js +10 -0
  54. package/lib/managers/piptree.js +3 -9
  55. package/lib/parsers/npmrc.js +17 -13
  56. package/lib/parsers/npmrc.poku.js +41 -5
  57. package/lib/server/openapi.yaml +34 -1
  58. package/lib/server/server.js +50 -13
  59. package/lib/server/server.poku.js +332 -144
  60. package/lib/stages/postgen/annotator.js +1 -1
  61. package/lib/stages/postgen/auditBom.js +196 -0
  62. package/lib/stages/postgen/auditBom.poku.js +378 -0
  63. package/lib/stages/postgen/postgen.js +54 -1
  64. package/lib/stages/postgen/postgen.poku.js +90 -1
  65. package/lib/stages/postgen/ruleEngine.js +369 -0
  66. package/lib/stages/pregen/envAudit.js +299 -0
  67. package/lib/stages/pregen/envAudit.poku.js +572 -0
  68. package/lib/stages/pregen/pregen.js +12 -8
  69. package/lib/{helpers/validator.js → validator/bomValidator.js} +107 -47
  70. package/lib/validator/complianceEngine.js +241 -0
  71. package/lib/validator/complianceEngine.poku.js +168 -0
  72. package/lib/validator/complianceRules.js +1610 -0
  73. package/lib/validator/complianceRules.poku.js +328 -0
  74. package/lib/validator/index.js +222 -0
  75. package/lib/validator/index.poku.js +144 -0
  76. package/lib/validator/reporters/annotations.js +121 -0
  77. package/lib/validator/reporters/console.js +149 -0
  78. package/lib/validator/reporters/index.js +41 -0
  79. package/lib/validator/reporters/json.js +37 -0
  80. package/lib/validator/reporters/sarif.js +184 -0
  81. package/lib/validator/reporters.poku.js +150 -0
  82. package/package.json +8 -9
  83. package/types/bin/sign.d.ts +3 -0
  84. package/types/bin/sign.d.ts.map +1 -0
  85. package/types/bin/validate.d.ts +3 -0
  86. package/types/bin/validate.d.ts.map +1 -0
  87. package/types/helpers/utils.d.ts +0 -1
  88. package/types/lib/cli/index.d.ts +49 -52
  89. package/types/lib/cli/index.d.ts.map +1 -1
  90. package/types/lib/evinser/db.d.ts +34 -0
  91. package/types/lib/evinser/db.d.ts.map +1 -0
  92. package/types/lib/evinser/evinser.d.ts +63 -16
  93. package/types/lib/evinser/evinser.d.ts.map +1 -1
  94. package/types/lib/helpers/analyzer.d.ts.map +1 -1
  95. package/types/lib/helpers/bomSigner.d.ts +27 -0
  96. package/types/lib/helpers/bomSigner.d.ts.map +1 -0
  97. package/types/lib/helpers/ciParsers/azurePipelines.d.ts +17 -0
  98. package/types/lib/helpers/ciParsers/azurePipelines.d.ts.map +1 -0
  99. package/types/lib/helpers/ciParsers/circleCi.d.ts +17 -0
  100. package/types/lib/helpers/ciParsers/circleCi.d.ts.map +1 -0
  101. package/types/lib/helpers/ciParsers/common.d.ts +11 -0
  102. package/types/lib/helpers/ciParsers/common.d.ts.map +1 -0
  103. package/types/lib/helpers/ciParsers/githubActions.d.ts +34 -0
  104. package/types/lib/helpers/ciParsers/githubActions.d.ts.map +1 -0
  105. package/types/lib/helpers/ciParsers/gitlabCi.d.ts +17 -0
  106. package/types/lib/helpers/ciParsers/gitlabCi.d.ts.map +1 -0
  107. package/types/lib/helpers/ciParsers/jenkins.d.ts +17 -0
  108. package/types/lib/helpers/ciParsers/jenkins.d.ts.map +1 -0
  109. package/types/lib/helpers/depsUtils.d.ts +21 -0
  110. package/types/lib/helpers/depsUtils.d.ts.map +1 -0
  111. package/types/lib/helpers/display.d.ts +111 -11
  112. package/types/lib/helpers/display.d.ts.map +1 -1
  113. package/types/lib/helpers/envcontext.d.ts +19 -7
  114. package/types/lib/helpers/envcontext.d.ts.map +1 -1
  115. package/types/lib/helpers/formulationParsers.d.ts +50 -0
  116. package/types/lib/helpers/formulationParsers.d.ts.map +1 -0
  117. package/types/lib/helpers/logger.d.ts +15 -1
  118. package/types/lib/helpers/logger.d.ts.map +1 -1
  119. package/types/lib/helpers/protobom.d.ts +2 -2
  120. package/types/lib/helpers/pythonutils.d.ts +10 -1
  121. package/types/lib/helpers/pythonutils.d.ts.map +1 -1
  122. package/types/lib/helpers/remote/dependency-track.d.ts +16 -0
  123. package/types/lib/helpers/remote/dependency-track.d.ts.map +1 -0
  124. package/types/lib/helpers/table.d.ts +6 -0
  125. package/types/lib/helpers/table.d.ts.map +1 -0
  126. package/types/lib/helpers/utils.d.ts +533 -128
  127. package/types/lib/helpers/utils.d.ts.map +1 -1
  128. package/types/lib/helpers/versutils.d.ts +8 -0
  129. package/types/lib/helpers/versutils.d.ts.map +1 -0
  130. package/types/lib/helpers/vsixutils.d.ts +130 -0
  131. package/types/lib/helpers/vsixutils.d.ts.map +1 -0
  132. package/types/lib/managers/docker.d.ts +12 -31
  133. package/types/lib/managers/docker.d.ts.map +1 -1
  134. package/types/lib/managers/oci.d.ts +11 -1
  135. package/types/lib/managers/oci.d.ts.map +1 -1
  136. package/types/lib/managers/piptree.d.ts.map +1 -1
  137. package/types/lib/parsers/npmrc.d.ts +4 -1
  138. package/types/lib/parsers/npmrc.d.ts.map +1 -1
  139. package/types/lib/server/server.d.ts +22 -2
  140. package/types/lib/server/server.d.ts.map +1 -1
  141. package/types/lib/stages/postgen/auditBom.d.ts +20 -0
  142. package/types/lib/stages/postgen/auditBom.d.ts.map +1 -0
  143. package/types/lib/stages/postgen/postgen.d.ts +8 -1
  144. package/types/lib/stages/postgen/postgen.d.ts.map +1 -1
  145. package/types/lib/stages/postgen/ruleEngine.d.ts +18 -0
  146. package/types/lib/stages/postgen/ruleEngine.d.ts.map +1 -0
  147. package/types/lib/stages/pregen/envAudit.d.ts +8 -0
  148. package/types/lib/stages/pregen/envAudit.d.ts.map +1 -0
  149. package/types/lib/stages/pregen/pregen.d.ts.map +1 -1
  150. package/types/lib/{helpers/validator.d.ts → validator/bomValidator.d.ts} +1 -1
  151. package/types/lib/validator/bomValidator.d.ts.map +1 -0
  152. package/types/lib/validator/complianceEngine.d.ts +66 -0
  153. package/types/lib/validator/complianceEngine.d.ts.map +1 -0
  154. package/types/lib/validator/complianceRules.d.ts +70 -0
  155. package/types/lib/validator/complianceRules.d.ts.map +1 -0
  156. package/types/lib/validator/index.d.ts +70 -0
  157. package/types/lib/validator/index.d.ts.map +1 -0
  158. package/types/lib/validator/reporters/annotations.d.ts +31 -0
  159. package/types/lib/validator/reporters/annotations.d.ts.map +1 -0
  160. package/types/lib/validator/reporters/console.d.ts +30 -0
  161. package/types/lib/validator/reporters/console.d.ts.map +1 -0
  162. package/types/lib/validator/reporters/index.d.ts +21 -0
  163. package/types/lib/validator/reporters/index.d.ts.map +1 -0
  164. package/types/lib/validator/reporters/json.d.ts +11 -0
  165. package/types/lib/validator/reporters/json.d.ts.map +1 -0
  166. package/types/lib/validator/reporters/sarif.d.ts +16 -0
  167. package/types/lib/validator/reporters/sarif.d.ts.map +1 -0
  168. package/lib/helpers/db.js +0 -162
  169. package/lib/stages/pregen/env-audit.js +0 -34
  170. package/lib/stages/pregen/env-audit.poku.js +0 -290
  171. package/types/helpers/db.d.ts +0 -35
  172. package/types/helpers/db.d.ts.map +0 -1
  173. package/types/lib/helpers/db.d.ts +0 -35
  174. package/types/lib/helpers/db.d.ts.map +0 -1
  175. package/types/lib/helpers/validator.d.ts.map +0 -1
  176. package/types/lib/stages/pregen/env-audit.d.ts +0 -2
  177. package/types/lib/stages/pregen/env-audit.d.ts.map +0 -1
  178. package/types/managers/binary.d.ts +0 -37
  179. package/types/managers/binary.d.ts.map +0 -1
  180. package/types/managers/docker.d.ts +0 -56
  181. package/types/managers/docker.d.ts.map +0 -1
  182. package/types/managers/oci.d.ts +0 -2
  183. package/types/managers/oci.d.ts.map +0 -1
  184. package/types/managers/piptree.d.ts +0 -2
  185. package/types/managers/piptree.d.ts.map +0 -1
  186. package/types/server/server.d.ts +0 -34
  187. package/types/server/server.d.ts.map +0 -1
  188. package/types/stages/postgen/annotator.d.ts +0 -27
  189. package/types/stages/postgen/annotator.d.ts.map +0 -1
  190. package/types/stages/postgen/postgen.d.ts +0 -51
  191. package/types/stages/postgen/postgen.d.ts.map +0 -1
  192. package/types/stages/pregen/pregen.d.ts +0 -59
  193. package/types/stages/pregen/pregen.d.ts.map +0 -1
@@ -36,7 +36,11 @@ const ALLOWED_PARAMS = [
36
36
  "projectGroup",
37
37
  "projectTag",
38
38
  "projectVersion",
39
+ "autoCreate",
40
+ "isLatest",
39
41
  "parentUUID",
42
+ "parentProjectName",
43
+ "parentProjectVersion",
40
44
  "serverUrl",
41
45
  "apiKey",
42
46
  "specVersion",
@@ -270,7 +274,10 @@ function gitClone(repoUrl, branch = null) {
270
274
  "core.fsmonitor=false",
271
275
  "-c",
272
276
  "safe.bareRepository=explicit",
277
+ "-c",
278
+ "core.hooksPath=/dev/null",
273
279
  "clone",
280
+ "--template=",
274
281
  repoUrl,
275
282
  "--depth",
276
283
  "1",
@@ -297,13 +304,14 @@ function gitClone(repoUrl, branch = null) {
297
304
  GIT_CONFIG_VALUE_0: "false",
298
305
  GIT_CONFIG_KEY_1: "safe.bareRepository",
299
306
  GIT_CONFIG_VALUE_1: "explicit",
307
+ GIT_TERMINAL_PROMPT: "0",
300
308
  };
301
309
  const env = isSecureMode
302
310
  ? {
303
311
  ...process.env,
304
312
  ...envConfigs,
305
313
  GIT_CONFIG_NOSYSTEM: "1",
306
- GIT_CONFIG_NOGLOBAL: "1",
314
+ GIT_CONFIG_GLOBAL: "/dev/null",
307
315
  GIT_ALLOW_PROTOCOL: gitAllowProtocol,
308
316
  }
309
317
  : {
@@ -372,6 +380,17 @@ export function parseValue(raw) {
372
380
  throw new TypeError(`Invalid value type: ${t}.`);
373
381
  }
374
382
 
383
+ /**
384
+ * Parses allowed query/body parameters into a typed options object.
385
+ * Query parameters take priority over body parameters. Handles the
386
+ * `type` → `projectType` rename, lifecycle-based `installDeps` defaulting,
387
+ * and profile option expansion.
388
+ *
389
+ * @param {Object} q Parsed query string key/value map
390
+ * @param {Object} [body={}] Parsed request body key/value map
391
+ * @param {Object} [options={}] Seed options object to merge results into
392
+ * @returns {Object} Populated options object
393
+ */
375
394
  export function parseQueryString(q, body = {}, options = {}) {
376
395
  // Priority is query params followed by body
377
396
  for (const param of ALLOWED_PARAMS) {
@@ -391,6 +410,14 @@ export function parseQueryString(q, body = {}, options = {}) {
391
410
  return options;
392
411
  }
393
412
 
413
+ /**
414
+ * Extracts query parameters from an incoming HTTP request object.
415
+ * Handles repeated keys by collecting their values into an array.
416
+ * Returns an empty object if the URL cannot be parsed.
417
+ *
418
+ * @param {Object} req Node.js/connect HTTP request object
419
+ * @returns {Object} Key/value map of query parameters from the request URL
420
+ */
394
421
  export function getQueryParams(req) {
395
422
  try {
396
423
  if (!req?.url) {
@@ -402,7 +429,7 @@ export function getQueryParams(req) {
402
429
  const baseUrl = `${protocol}://${host}`;
403
430
 
404
431
  const fullUrl = new URL(req.url, baseUrl);
405
- const params = {};
432
+ const params = Object.create(null);
406
433
 
407
434
  // Convert multiple values to an array
408
435
  for (const [key, value] of fullUrl.searchParams) {
@@ -449,21 +476,25 @@ const configureServer = (cdxgenServer) => {
449
476
  const ALL_INTERFACES = new Set(["0.0.0.0", "::", "::/128", "::/0"]);
450
477
 
451
478
  const start = (options) => {
479
+ if (isSecureMode && !process.permission) {
480
+ console.error(
481
+ "SECURE MODE: Node.js permission model not enabled. Use --permission flag.",
482
+ );
483
+ process.exit(1);
484
+ }
452
485
  console.log(`cdxgen server version ${CDXGEN_VERSION}`);
453
-
454
- console.log(
455
- "Listening on",
456
- options.serverHost,
457
- options.serverPort,
458
- "without authentication!",
459
- );
460
486
  if (ALL_INTERFACES.has(options.serverHost)) {
461
487
  console.log("Exposing cdxgen server on all IP address is a security risk!");
462
488
  if (isSecureMode) {
463
489
  process.exit(1);
464
490
  }
465
491
  }
466
- if (+options.serverPort < 1024) {
492
+ const serverPort = Number(options.serverPort);
493
+ if (!Number.isInteger(serverPort) || serverPort <= 0 || serverPort > 65535) {
494
+ console.log("Invalid server port specified.");
495
+ process.exit(1);
496
+ }
497
+ if (serverPort < 1024) {
467
498
  console.log(
468
499
  "Running cdxgen server with a privileged port is a security risk!",
469
500
  );
@@ -503,9 +534,15 @@ const start = (options) => {
503
534
  process.exit(1);
504
535
  }
505
536
  }
537
+ console.log(
538
+ "Listening on",
539
+ options.serverHost,
540
+ serverPort,
541
+ "without authentication!",
542
+ );
506
543
  const cdxgenServer = http
507
544
  .createServer(app)
508
- .listen(options.serverPort, options.serverHost);
545
+ .listen(serverPort, options.serverHost);
509
546
  configureServer(cdxgenServer);
510
547
 
511
548
  app.use("/health", (_req, res) => {
@@ -525,7 +562,7 @@ const start = (options) => {
525
562
  }
526
563
  const q = getQueryParams(req);
527
564
  let cleanup = false;
528
- let reqOptions = {};
565
+ let reqOptions = Object.create(null);
529
566
  try {
530
567
  reqOptions = parseQueryString(
531
568
  q,
@@ -647,4 +684,4 @@ const start = (options) => {
647
684
  });
648
685
  };
649
686
 
650
- export { configureServer, start };
687
+ export { configureServer, gitClone, start };