@trustify-da/trustify-da-javascript-client 0.3.0-ea.b6d9c3f → 0.3.0-ea.b77d624

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 (43) hide show
  1. package/README.md +187 -1
  2. package/dist/package.json +6 -2
  3. package/dist/src/cli.js +48 -1
  4. package/dist/src/cyclone_dx_sbom.d.ts +13 -0
  5. package/dist/src/cyclone_dx_sbom.js +39 -1
  6. package/dist/src/index.d.ts +1 -0
  7. package/dist/src/index.js +8 -24
  8. package/dist/src/package_version.d.ts +8 -0
  9. package/dist/src/package_version.js +31 -0
  10. package/dist/src/providers/base_java.d.ts +53 -0
  11. package/dist/src/providers/base_java.js +64 -17
  12. package/dist/src/providers/base_javascript.d.ts +54 -0
  13. package/dist/src/providers/base_javascript.js +105 -3
  14. package/dist/src/providers/golang_gomodules.js +49 -7
  15. package/dist/src/providers/java_gradle.d.ts +48 -0
  16. package/dist/src/providers/java_gradle.js +196 -18
  17. package/dist/src/providers/java_maven.d.ts +28 -8
  18. package/dist/src/providers/java_maven.js +104 -10
  19. package/dist/src/providers/javascript_bun.d.ts +12 -0
  20. package/dist/src/providers/javascript_bun.js +42 -1
  21. package/dist/src/providers/javascript_npm.d.ts +13 -0
  22. package/dist/src/providers/javascript_npm.js +40 -1
  23. package/dist/src/providers/javascript_pnpm.d.ts +13 -0
  24. package/dist/src/providers/javascript_pnpm.js +47 -1
  25. package/dist/src/providers/javascript_yarn.d.ts +12 -0
  26. package/dist/src/providers/javascript_yarn.js +75 -2
  27. package/dist/src/providers/manifest.js +6 -3
  28. package/dist/src/providers/processors/yarn_berry_processor.d.ts +5 -1
  29. package/dist/src/providers/processors/yarn_berry_processor.js +3 -2
  30. package/dist/src/providers/processors/yarn_classic_processor.d.ts +5 -1
  31. package/dist/src/providers/processors/yarn_classic_processor.js +8 -6
  32. package/dist/src/providers/requirements_parser.js +1 -1
  33. package/dist/src/providers/rust_cargo.js +70 -29
  34. package/dist/src/remediate.d.ts +21 -0
  35. package/dist/src/remediate.js +149 -0
  36. package/dist/src/remediation.d.ts +27 -3
  37. package/dist/src/remediation.js +135 -20
  38. package/dist/src/remediation_report.d.ts +40 -0
  39. package/dist/src/remediation_report.js +159 -0
  40. package/dist/src/sbom.d.ts +11 -0
  41. package/dist/src/sbom.js +10 -0
  42. package/dist/src/tools.js +24 -1
  43. package/package.json +7 -3
@@ -33,6 +33,17 @@ export default class Sbom {
33
33
  alg: string;
34
34
  content: string;
35
35
  }>): CycloneDxSbom;
36
+ /**
37
+ * Attach hashes to existing components by matching their PURL. Post-processing
38
+ * step used by ecosystem-specific providers (e.g. Maven) to enrich the SBOM
39
+ * with artifact hashes without leaking their concern into the shared parser.
40
+ * @param {Map<string, Array<{alg: string, content: string}>>} hashMap - PURL→hashes map
41
+ * @return {Sbom}
42
+ */
43
+ attachHashes(hashMap: Map<string, Array<{
44
+ alg: string;
45
+ content: string;
46
+ }>>): Sbom;
36
47
  /**
37
48
  * @return String sbom json in a string format
38
49
  */
package/dist/src/sbom.js CHANGED
@@ -50,6 +50,16 @@ export default class Sbom {
50
50
  addDependency(sourceRef, targetRef, scope, targetHashes) {
51
51
  return this.sbomModel.addDependency(sourceRef, targetRef, scope, targetHashes);
52
52
  }
53
+ /**
54
+ * Attach hashes to existing components by matching their PURL. Post-processing
55
+ * step used by ecosystem-specific providers (e.g. Maven) to enrich the SBOM
56
+ * with artifact hashes without leaking their concern into the shared parser.
57
+ * @param {Map<string, Array<{alg: string, content: string}>>} hashMap - PURL→hashes map
58
+ * @return {Sbom}
59
+ */
60
+ attachHashes(hashMap) {
61
+ return this.sbomModel.attachHashes(hashMap);
62
+ }
53
63
  /**
54
64
  * @return String sbom json in a string format
55
65
  */
package/dist/src/tools.js CHANGED
@@ -42,6 +42,28 @@ export function getCustom(key, def = null, opts = {}) {
42
42
  }
43
43
  return key in process.env ? process.env[key] : key in opts && typeof opts[key] === 'string' ? opts[key] : def;
44
44
  }
45
+ /**
46
+ * Validates that an executable path does not use directory traversal or relative segments.
47
+ * @param {string} binPath - The executable path to validate.
48
+ * @returns {string} The validated path.
49
+ * @throws {Error} If the path contains '..' segments or is a relative path with separators.
50
+ */
51
+ function validateExecutablePath(binPath) {
52
+ if (typeof binPath !== 'string' || binPath.length === 0) {
53
+ throw new Error('Executable path rejected: expected a non-empty string');
54
+ }
55
+ if (binPath.startsWith('./') || binPath.startsWith('.\\')) {
56
+ throw new Error(`Executable path rejected: relative paths starting with './' are not allowed: ${binPath}`);
57
+ }
58
+ const segments = binPath.split(/[/\\]/);
59
+ if (segments.includes('..')) {
60
+ throw new Error(`Executable path rejected: path contains directory traversal segment (..): ${binPath}`);
61
+ }
62
+ if ((binPath.includes('/') || binPath.includes('\\')) && !path.isAbsolute(binPath)) {
63
+ throw new Error(`Executable path rejected: relative paths are not allowed, use an absolute path or a bare command name: ${binPath}`);
64
+ }
65
+ return binPath;
66
+ }
45
67
  /**
46
68
  * Utility function for looking up custom variable for a binary path.
47
69
  * Will look in the environment variables (1) or in opts (2) for a key with TRUSTIFY_DA_x_PATH, x is an
@@ -53,7 +75,8 @@ export function getCustom(key, def = null, opts = {}) {
53
75
  * original name supplied
54
76
  */
55
77
  export function getCustomPath(name, opts = {}) {
56
- return getCustom(`TRUSTIFY_DA_${name.toUpperCase()}_PATH`, name, opts);
78
+ const resolvedPath = getCustom(`TRUSTIFY_DA_${name.toUpperCase()}_PATH`, name, opts);
79
+ return validateExecutablePath(resolvedPath);
57
80
  }
58
81
  /**
59
82
  * Utility function for determining whether wrappers for build tools such as gradlew/mvnw should be
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@trustify-da/trustify-da-javascript-client",
3
- "version": "0.3.0-ea.b6d9c3f",
3
+ "version": "0.3.0-ea.b77d624",
4
4
  "description": "Code-Ready Dependency Analytics JavaScript API.",
5
5
  "license": "Apache-2.0",
6
6
  "homepage": "https://github.com/guacsec/trustify-da-javascript-client#README.md",
@@ -25,7 +25,9 @@
25
25
  "provenance": true
26
26
  },
27
27
  "type": "module",
28
- "bin": "dist/src/cli.js",
28
+ "bin": {
29
+ "trustify-da": "dist/src/cli.js"
30
+ },
29
31
  "main": "dist/src/index.js",
30
32
  "module": "dist/src/index.js",
31
33
  "types": "dist/src/index.d.ts",
@@ -48,7 +50,7 @@
48
50
  },
49
51
  "dependencies": {
50
52
  "@babel/core": "^7.23.2",
51
- "@cyclonedx/cyclonedx-library": "^10.0.0",
53
+ "@yarnpkg/parsers": "^3.1.0",
52
54
  "eslint-import-resolver-typescript": "^4.4.4",
53
55
  "fast-glob": "^3.3.3",
54
56
  "fast-xml-parser": "^5.3.4",
@@ -69,10 +71,12 @@
69
71
  },
70
72
  "devDependencies": {
71
73
  "@babel/core": "^7.23.2",
74
+ "@cyclonedx/cyclonedx-library": "^10.2.0",
72
75
  "@eslint/js": "^10.0.0",
73
76
  "@trustify-da/trustify-da-api-model": "^2.0.12",
74
77
  "@types/node": "^25.9.1",
75
78
  "@types/which": "^3.0.4",
79
+ "ajv": "^8.20.0",
76
80
  "babel-plugin-rewire": "^1.2.0",
77
81
  "c8": "^11.0.0",
78
82
  "chai": "^6.2.2",