@trustify-da/trustify-da-javascript-client 0.3.0-ea.608d6fa → 0.3.0-ea.62b88e5

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 (94) hide show
  1. package/README.md +326 -21
  2. package/dist/package.json +36 -27
  3. package/dist/src/analysis.d.ts +58 -14
  4. package/dist/src/analysis.js +118 -17
  5. package/dist/src/batch_opts.d.ts +24 -0
  6. package/dist/src/batch_opts.js +35 -0
  7. package/dist/src/cli.js +357 -8
  8. package/dist/src/config.d.ts +120 -0
  9. package/dist/src/config.js +260 -0
  10. package/dist/src/cyclone_dx_sbom.d.ts +27 -1
  11. package/dist/src/cyclone_dx_sbom.js +84 -10
  12. package/dist/src/index.d.ts +151 -16
  13. package/dist/src/index.js +369 -36
  14. package/dist/src/license/index.d.ts +4 -4
  15. package/dist/src/license/index.js +13 -7
  16. package/dist/src/license/license_utils.js +4 -1
  17. package/dist/src/license/licenses_api.d.ts +3 -3
  18. package/dist/src/license/licenses_api.js +1 -1
  19. package/dist/src/oci_image/images.d.ts +1 -1
  20. package/dist/src/oci_image/images.js +15 -1
  21. package/dist/src/oci_image/utils.d.ts +5 -5
  22. package/dist/src/oci_image/utils.js +11 -2
  23. package/dist/src/package_version.d.ts +8 -0
  24. package/dist/src/package_version.js +31 -0
  25. package/dist/src/provider.d.ts +8 -4
  26. package/dist/src/provider.js +16 -5
  27. package/dist/src/providers/base_java.d.ts +67 -12
  28. package/dist/src/providers/base_java.js +82 -61
  29. package/dist/src/providers/base_javascript.d.ts +91 -10
  30. package/dist/src/providers/base_javascript.js +214 -24
  31. package/dist/src/providers/base_pyproject.d.ts +158 -0
  32. package/dist/src/providers/base_pyproject.js +322 -0
  33. package/dist/src/providers/containerfile_parser.d.ts +5 -0
  34. package/dist/src/providers/containerfile_parser.js +20 -0
  35. package/dist/src/providers/golang_gomodules.d.ts +23 -13
  36. package/dist/src/providers/golang_gomodules.js +208 -120
  37. package/dist/src/providers/gomod_parser.d.ts +4 -0
  38. package/dist/src/providers/gomod_parser.js +16 -0
  39. package/dist/src/providers/java_gradle.d.ts +67 -0
  40. package/dist/src/providers/java_gradle.js +320 -22
  41. package/dist/src/providers/java_gradle_groovy.d.ts +1 -1
  42. package/dist/src/providers/java_gradle_kotlin.d.ts +1 -1
  43. package/dist/src/providers/java_maven.d.ts +37 -9
  44. package/dist/src/providers/java_maven.js +269 -11
  45. package/dist/src/providers/javascript_bun.d.ts +22 -0
  46. package/dist/src/providers/javascript_bun.js +141 -0
  47. package/dist/src/providers/javascript_npm.d.ts +19 -0
  48. package/dist/src/providers/javascript_npm.js +61 -1
  49. package/dist/src/providers/javascript_pnpm.d.ts +14 -1
  50. package/dist/src/providers/javascript_pnpm.js +55 -5
  51. package/dist/src/providers/javascript_yarn.d.ts +12 -0
  52. package/dist/src/providers/javascript_yarn.js +75 -2
  53. package/dist/src/providers/manifest.d.ts +2 -0
  54. package/dist/src/providers/manifest.js +28 -7
  55. package/dist/src/providers/marker_evaluator.d.ts +14 -0
  56. package/dist/src/providers/marker_evaluator.js +191 -0
  57. package/dist/src/providers/oci_dockerfile.d.ts +51 -0
  58. package/dist/src/providers/oci_dockerfile.js +177 -0
  59. package/dist/src/providers/processors/yarn_berry_processor.d.ts +6 -2
  60. package/dist/src/providers/processors/yarn_berry_processor.js +91 -7
  61. package/dist/src/providers/processors/yarn_classic_processor.d.ts +6 -2
  62. package/dist/src/providers/processors/yarn_classic_processor.js +8 -6
  63. package/dist/src/providers/python_controller.d.ts +5 -1
  64. package/dist/src/providers/python_controller.js +69 -8
  65. package/dist/src/providers/python_pip.d.ts +5 -0
  66. package/dist/src/providers/python_pip.js +6 -6
  67. package/dist/src/providers/python_pip_pyproject.d.ts +61 -0
  68. package/dist/src/providers/python_pip_pyproject.js +146 -0
  69. package/dist/src/providers/python_poetry.d.ts +98 -0
  70. package/dist/src/providers/python_poetry.js +286 -0
  71. package/dist/src/providers/python_uv.d.ts +46 -0
  72. package/dist/src/providers/python_uv.js +275 -0
  73. package/dist/src/providers/requirements_parser.js +1 -1
  74. package/dist/src/providers/rust_cargo.d.ts +12 -3
  75. package/dist/src/providers/rust_cargo.js +107 -31
  76. package/dist/src/providers/tree-sitter-containerfile.wasm +0 -0
  77. package/dist/src/providers/tree-sitter-gomod.wasm +0 -0
  78. package/dist/src/remediate.d.ts +107 -0
  79. package/dist/src/remediate.js +244 -0
  80. package/dist/src/remediation.d.ts +81 -0
  81. package/dist/src/remediation.js +475 -0
  82. package/dist/src/remediation_report.d.ts +23 -0
  83. package/dist/src/remediation_report.js +180 -0
  84. package/dist/src/sbom.d.ts +25 -1
  85. package/dist/src/sbom.js +23 -2
  86. package/dist/src/tools.d.ts +37 -13
  87. package/dist/src/tools.js +92 -13
  88. package/dist/src/updaters/maven_updater.d.ts +58 -0
  89. package/dist/src/updaters/maven_updater.js +345 -0
  90. package/dist/src/updaters/toml_updater.d.ts +62 -0
  91. package/dist/src/updaters/toml_updater.js +276 -0
  92. package/dist/src/workspace.d.ts +71 -0
  93. package/dist/src/workspace.js +257 -0
  94. package/package.json +37 -28
@@ -1,15 +1,19 @@
1
+ import crypto from 'node:crypto';
1
2
  import fs from 'node:fs';
3
+ import os from 'node:os';
2
4
  import path from 'node:path';
3
5
  import { EOL } from 'os';
4
- import TOML from 'fast-toml';
6
+ import { parse as parseToml } from 'smol-toml';
5
7
  import { readLicenseFile } from '../license/license_utils.js';
6
8
  import Sbom from '../sbom.js';
9
+ import { invokeCommand } from '../tools.js';
10
+ import { filterManifestPathsByDiscoveryIgnore, resolveWorkspaceDiscoveryIgnore } from '../workspace.js';
7
11
  import Base_java, { ecosystem_gradle } from "./base_java.js";
8
12
  /** @typedef {import('../provider.js').Provider} */
9
13
  /** @typedef {import('../provider.js').Provided} Provided */
10
14
  const ROOT_PROJECT_KEY_NAME = "root-project";
11
- const TRUSTIFY_DA_IGNORE_REGEX_LINE = /.*\s?exhortignore\s*$/g;
12
- const TRUSTIFY_DA_IGNORE_REGEX = /\/\/\s?exhortignore/;
15
+ const TRUSTIFY_DA_IGNORE_REGEX_LINE = /.*\s?(exhortignore|trustify-da-ignore)\s*$/g;
16
+ const TRUSTIFY_DA_IGNORE_REGEX = /\/\/\s?(exhortignore|trustify-da-ignore)/;
13
17
  /**
14
18
  * Check if the dependency marked for exclusion has libs notation , so if it's true the rest of coordinates( GAV) should be fetched from TOML file.
15
19
  * @param {string} depToBeIgnored
@@ -55,7 +59,6 @@ export default class Java_gradle extends Base_java {
55
59
  * @param {string} manifestPath - path to manifest
56
60
  * @returns {null}
57
61
  */
58
- // eslint-disable-next-line no-unused-vars
59
62
  readLicenseFromManifest(manifestPath) { return readLicenseFile(manifestPath); }
60
63
  /**
61
64
  * Provide content and content type for stack analysis.
@@ -63,10 +66,10 @@ export default class Java_gradle extends Base_java {
63
66
  * @param {{}} [opts={}] - optional various options to pass along the application
64
67
  * @returns {Provided}
65
68
  */
66
- provideStack(manifest, opts = {}) {
69
+ async provideStack(manifest, opts = {}) {
67
70
  return {
68
71
  ecosystem: ecosystem_gradle,
69
- content: this.#createSbomStackAnalysis(manifest, opts),
72
+ content: await this.#createSbomStackAnalysis(manifest, opts),
70
73
  contentType: 'application/vnd.cyclonedx+json'
71
74
  };
72
75
  }
@@ -76,10 +79,10 @@ export default class Java_gradle extends Base_java {
76
79
  * @param {{}} [opts={}] - optional various options to pass along the application
77
80
  * @returns {Provided}
78
81
  */
79
- provideComponent(manifest, opts = {}) {
82
+ async provideComponent(manifest, opts = {}) {
80
83
  return {
81
84
  ecosystem: ecosystem_gradle,
82
- content: this.#getSbomForComponentAnalysis(manifest, opts),
85
+ content: await this.#getSbomForComponentAnalysis(manifest, opts),
83
86
  contentType: 'application/vnd.cyclonedx+json'
84
87
  };
85
88
  }
@@ -129,9 +132,10 @@ export default class Java_gradle extends Base_java {
129
132
  * @param {Sbom} sbom - the SBOM object to add dependencies to
130
133
  * @param {Set} processedDeps - set of already processed dependencies
131
134
  * @param {string} scope - the dependency scope
135
+ * @param {Map<string, Array<{alg: string, content: string}>>} [hashMap] - map of "group:name@version" to CycloneDX hashes
132
136
  * @private
133
137
  */
134
- #processDependencyTree(config, parentPurl, sbom, processedDeps, scope) {
138
+ #processDependencyTree(config, parentPurl, sbom, processedDeps, scope, hashMap) {
135
139
  const processedLines = this.#prepareLinesForParsingDependencyTree(config);
136
140
  let parentStack = [parentPurl];
137
141
  for (const { line, depth } of processedLines) {
@@ -149,12 +153,18 @@ export default class Java_gradle extends Base_java {
149
153
  // Add dependency to SBOM if not already processed
150
154
  if (!processedDeps.has(depKey)) {
151
155
  processedDeps.add(depKey);
152
- sbom.addDependency(currentParent, purl, scope);
156
+ sbom.addDependency(currentParent, purl, scope, hashMap?.get(purl.toString()));
153
157
  }
154
158
  parentStack.push(purl);
155
159
  }
156
160
  }
157
161
  }
162
+ #buildRootCoordinate(properties) {
163
+ const group = properties.group || 'unknown';
164
+ const version = properties.version || '0.0.0';
165
+ const rootName = properties[ROOT_PROJECT_KEY_NAME]?.match(/Root project '(.+)'/)?.[1] || 'unknown';
166
+ return `${group}:${rootName}:jar:${version}`;
167
+ }
158
168
  /**
159
169
  * Create a Dot Graph dependency tree for a manifest path.
160
170
  * @param {string} manifest - path for pom.xml
@@ -162,17 +172,17 @@ export default class Java_gradle extends Base_java {
162
172
  * @returns {string} the Dot Graph content
163
173
  * @private
164
174
  */
165
- #buildSbom(content, properties, manifestPath, opts = {}) {
175
+ #buildSbom(content, properties, manifestPath, opts = {}, hashMap) {
166
176
  let sbom = new Sbom();
167
- let root = `${properties.group}:${properties[ROOT_PROJECT_KEY_NAME].match(/Root project '(.+)'/)[1]}:jar:${properties.version}`;
177
+ let root = this.#buildRootCoordinate(properties);
168
178
  let rootPurl = this.parseDep(root);
169
179
  const license = this.readLicenseFromManifest(manifestPath);
170
180
  sbom.addRoot(rootPurl, license);
171
181
  let ignoredDeps = this.#getIgnoredDeps(manifestPath);
172
182
  const [runtimeConfig, compileConfig] = this.#extractConfigurations(content);
173
183
  const processedDeps = new Set();
174
- this.#processDependencyTree(runtimeConfig, rootPurl, sbom, processedDeps, 'required');
175
- this.#processDependencyTree(compileConfig, rootPurl, sbom, processedDeps, 'optional');
184
+ this.#processDependencyTree(runtimeConfig, rootPurl, sbom, processedDeps, 'required', hashMap);
185
+ this.#processDependencyTree(compileConfig, rootPurl, sbom, processedDeps, 'optional', hashMap);
176
186
  return sbom.filterIgnoredDepsIncludingVersion(ignoredDeps).getAsJsonString(opts);
177
187
  }
178
188
  /**
@@ -182,14 +192,15 @@ export default class Java_gradle extends Base_java {
182
192
  * @returns {string} the Dot Graph content
183
193
  * @private
184
194
  */
185
- #createSbomStackAnalysis(manifest, opts = {}) {
195
+ async #createSbomStackAnalysis(manifest, opts = {}) {
186
196
  let content = this.#getDependencies(manifest, opts);
187
197
  let properties = this.#extractProperties(manifest, opts);
198
+ let hashMap = await this.parseGradleHashes(manifest, opts);
188
199
  // read dependency tree from temp file
189
200
  if (process.env["TRUSTIFY_DA_DEBUG"] === "true") {
190
201
  console.log("Dependency tree that will be used as input for creating the BOM =>" + EOL + EOL + content);
191
202
  }
192
- let sbom = this.#buildSbom(content, properties, manifest, opts);
203
+ let sbom = this.#buildSbom(content, properties, manifest, opts, hashMap);
193
204
  return sbom;
194
205
  }
195
206
  /**
@@ -234,10 +245,11 @@ export default class Java_gradle extends Base_java {
234
245
  * @returns {string} - sbom string of the direct dependencies of build.gradle
235
246
  * @private
236
247
  */
237
- #getSbomForComponentAnalysis(manifestPath, opts = {}) {
248
+ async #getSbomForComponentAnalysis(manifestPath, opts = {}) {
238
249
  let content = this.#getDependencies(manifestPath, opts);
239
250
  let properties = this.#extractProperties(manifestPath, opts);
240
- let sbom = this.#buildDirectDependenciesSbom(content, properties, manifestPath, opts);
251
+ let hashMap = await this.parseGradleHashes(manifestPath, opts);
252
+ let sbom = this.#buildDirectDependenciesSbom(content, properties, manifestPath, opts, hashMap);
241
253
  return sbom;
242
254
  }
243
255
  /**
@@ -256,6 +268,112 @@ export default class Java_gradle extends Base_java {
256
268
  throw new Error(`Couldn't run gradle dependencies command, error message returned from gradle binary => ${EOL} ${error.message}`);
257
269
  }
258
270
  }
271
+ /**
272
+ * Hash a file using SHA-256 with streaming to handle large files efficiently.
273
+ * @param {string} filePath - path to the file to hash
274
+ * @returns {Promise<string>} hex-encoded SHA-256 digest
275
+ * @private
276
+ */
277
+ #hashFileStream(filePath) {
278
+ return new Promise((resolve, reject) => {
279
+ const hash = crypto.createHash('sha256');
280
+ const stream = fs.createReadStream(filePath);
281
+ stream.on('data', chunk => hash.update(chunk));
282
+ stream.on('end', () => resolve(hash.digest('hex')));
283
+ stream.on('error', reject);
284
+ });
285
+ }
286
+ /**
287
+ * Compute SHA-256 hashes for the resolved artifacts of a Gradle manifest.
288
+ *
289
+ * Rather than scanning the local Gradle cache, this asks Gradle itself for
290
+ * the resolved artifact files via an init script (mirroring the pattern used
291
+ * by {@link discoverGradleSubprojects}), then hashes each file with the
292
+ * Node.js `crypto` module. The result is keyed by the canonical PURL string
293
+ * built via {@link Base_java#toPurl} — the same builder {@link parseDep} uses
294
+ * for the lookup — so the stored key and the lookup key cannot drift.
295
+ *
296
+ * Degrades gracefully: if Gradle cannot be invoked, the init script fails, or
297
+ * an artifact has no readable file (e.g. BOM/`platform()` dependencies), the
298
+ * hash for that component is omitted rather than throwing. A warning is emitted
299
+ * on every degradation path so incomplete hash coverage is visible even without
300
+ * `TRUSTIFY_DA_DEBUG` (mirroring the pip/cargo providers).
301
+ *
302
+ * @param {string} manifest - path to build.gradle[.kts]
303
+ * @param {{}} [opts={}] - optional various options to pass along the application
304
+ * @returns {Promise<Map<string, Array<{alg: string, content: string}>>>} map of canonical PURL string to CycloneDX hashes
305
+ */
306
+ async parseGradleHashes(manifest, opts = {}) {
307
+ const hashMap = new Map();
308
+ const debug = process.env["TRUSTIFY_DA_DEBUG"] === "true";
309
+ let gradle;
310
+ try {
311
+ gradle = this.selectToolBinary(manifest, opts);
312
+ }
313
+ catch (error) {
314
+ console.warn(`Gradle could not be invoked to compute artifact hashes, SBOM will be generated without hashes: ${error.stack || error.message}`);
315
+ return hashMap;
316
+ }
317
+ const initScriptPath = path.join(os.tmpdir(), `da-list-hashes-${crypto.randomUUID()}.gradle`);
318
+ try {
319
+ fs.writeFileSync(initScriptPath, GRADLE_HASH_INIT_SCRIPT);
320
+ let output;
321
+ try {
322
+ output = this._invokeCommand(gradle, [
323
+ '-q', '--no-daemon',
324
+ '--init-script', initScriptPath,
325
+ 'daListHashes',
326
+ ], { cwd: path.dirname(manifest) });
327
+ }
328
+ catch (error) {
329
+ console.warn(`Gradle hash init script failed, SBOM will be generated without hashes: ${error.stack || error.message}`);
330
+ return hashMap;
331
+ }
332
+ let attempted = 0;
333
+ let missed = 0;
334
+ for (const { id, file } of parseGradleHashScriptOutput(output.toString())) {
335
+ const coord = parseComponentId(id);
336
+ if (!coord) {
337
+ continue;
338
+ }
339
+ // Build the key with the same canonical PURL builder parseDep uses for
340
+ // the lookup, so the stored key and the lookup key cannot drift.
341
+ const key = this.toPurl(coord.group, coord.name, coord.version).toString();
342
+ if (hashMap.has(key)) {
343
+ continue;
344
+ }
345
+ attempted++;
346
+ try {
347
+ const digest = await this.#hashFileStream(file);
348
+ hashMap.set(key, [{ alg: 'SHA-256', content: digest }]);
349
+ }
350
+ catch (error) {
351
+ // artifact file missing/unreadable — omit the hash for this component
352
+ missed++;
353
+ if (debug) {
354
+ console.error(`Gradle hash: could not read artifact ${file} => ${error.message}`);
355
+ }
356
+ }
357
+ }
358
+ if (missed > 0) {
359
+ console.warn(`Gradle hash: ${missed} of ${attempted} resolved artifacts could not be read, SBOM will be generated without hashes for those components`);
360
+ }
361
+ }
362
+ catch (error) {
363
+ // Unexpected failure (e.g. a programming error) is degraded to keep SBOM
364
+ // generation working, but the error is surfaced so it is not mistaken
365
+ // for ordinary graceful degradation.
366
+ console.warn(`Gradle artifact hashing failed, SBOM will be generated without hashes: ${error.stack || error.message}`);
367
+ return hashMap;
368
+ }
369
+ finally {
370
+ try {
371
+ fs.unlinkSync(initScriptPath);
372
+ }
373
+ catch { /* ignore */ }
374
+ }
375
+ return hashMap;
376
+ }
259
377
  /**
260
378
  * Extracts runtime and compile configurations from the dependency tree
261
379
  * @param {string} content - the dependency tree content
@@ -303,9 +421,9 @@ export default class Java_gradle extends Base_java {
303
421
  * @param properties {Object} - properties of the gradle project.
304
422
  * @return {string} return sbom json string of the build.gradle manifest file
305
423
  */
306
- #buildDirectDependenciesSbom(content, properties, manifestPath, opts = {}) {
424
+ #buildDirectDependenciesSbom(content, properties, manifestPath, opts = {}, hashMap) {
307
425
  let sbom = new Sbom();
308
- let root = `${properties.group}:${properties[ROOT_PROJECT_KEY_NAME].match(/Root project '(.+)'/)[1]}:jar:${properties.version}`;
426
+ let root = this.#buildRootCoordinate(properties);
309
427
  let rootPurl = this.parseDep(root);
310
428
  const license = this.readLicenseFromManifest(manifestPath);
311
429
  sbom.addRoot(rootPurl, license);
@@ -317,7 +435,7 @@ export default class Java_gradle extends Base_java {
317
435
  directDependencies.forEach((scope, dep) => {
318
436
  const purl = this.parseDep(dep);
319
437
  purl.scope = scope;
320
- sbom.addDependency(rootPurl, purl, scope);
438
+ sbom.addDependency(rootPurl, purl, scope, hashMap?.get(purl.toString()));
321
439
  });
322
440
  return sbom.filterIgnoredDepsIncludingVersion(ignoredDeps).getAsJsonString(opts);
323
441
  }
@@ -362,7 +480,7 @@ export default class Java_gradle extends Base_java {
362
480
  // Read and parse the TOML file
363
481
  let pathOfToml = path.join(path.dirname(manifestPath), "gradle", "libs.versions.toml");
364
482
  const tomlString = fs.readFileSync(pathOfToml).toString();
365
- let tomlObject = TOML.parse(tomlString);
483
+ let tomlObject = parseToml(tomlString);
366
484
  let groupPlusArtifactObject = tomlObject.libraries[alias];
367
485
  let parts = groupPlusArtifactObject.module.split(":");
368
486
  let groupId = parts[0];
@@ -407,3 +525,183 @@ export default class Java_gradle extends Base_java {
407
525
  return undefined;
408
526
  }
409
527
  }
528
+ const DEFAULT_GRADLE_DISCOVERY_IGNORE = [
529
+ '**/build/**',
530
+ '**/.gradle/**',
531
+ ];
532
+ /** Gradle init script that emits structured project listing. */
533
+ const GRADLE_INIT_SCRIPT = `allprojects {
534
+ task daListProjects {
535
+ doLast {
536
+ println "::DA_PROJECT::\${project.path}::\${project.projectDir}"
537
+ }
538
+ }
539
+ }
540
+ `;
541
+ /**
542
+ * Gradle init script that emits, per resolved module artifact, a structured line
543
+ * of the form `::DA_HASH::group:name:version::/absolute/file/path`. It obtains
544
+ * files from Gradle's resolution API (the same approach as the CycloneDX Gradle
545
+ * plugin) so it is robust to cache-layout changes and correctly reports
546
+ * classifiers and non-jar artifacts. Uses a lenient artifact view so
547
+ * unresolved/fileless artifacts are skipped rather than failing the build.
548
+ */
549
+ const GRADLE_HASH_INIT_SCRIPT = `allprojects {
550
+ task daListHashes {
551
+ doLast {
552
+ configurations.findAll { it.canBeResolved }.each { cfg ->
553
+ cfg.incoming.artifactView { lenient = true }.artifacts.each { artifact ->
554
+ def cid = artifact.id.componentIdentifier
555
+ if (cid instanceof org.gradle.api.artifacts.component.ModuleComponentIdentifier) {
556
+ println "::DA_HASH::\${cid.group}:\${cid.module}:\${cid.version}::\${artifact.file.absolutePath}"
557
+ }
558
+ }
559
+ }
560
+ }
561
+ }
562
+ }
563
+ `;
564
+ /**
565
+ * Discover all build.gradle[.kts] manifest paths in a Gradle multi-project build.
566
+ * Uses a custom init script to get structured project listing.
567
+ *
568
+ * @param {string} workspaceRoot - Absolute or relative path to workspace root (must contain settings.gradle[.kts])
569
+ * @param {import('../index.js').Options} [opts={}]
570
+ * @returns {Promise<string[]>} Paths to build.gradle[.kts] files (absolute)
571
+ */
572
+ export async function discoverGradleSubprojects(workspaceRoot, opts = {}) {
573
+ const root = path.resolve(workspaceRoot);
574
+ const hasSettings = fs.existsSync(path.join(root, 'settings.gradle'))
575
+ || fs.existsSync(path.join(root, 'settings.gradle.kts'));
576
+ if (!hasSettings) {
577
+ return [];
578
+ }
579
+ const manifestPaths = [];
580
+ const rootBuildKts = path.join(root, 'build.gradle.kts');
581
+ const rootBuild = path.join(root, 'build.gradle');
582
+ const rootManifest = fs.existsSync(rootBuildKts) ? rootBuildKts : fs.existsSync(rootBuild) ? rootBuild : null;
583
+ if (rootManifest) {
584
+ manifestPaths.push(rootManifest);
585
+ }
586
+ let gradleBin;
587
+ try {
588
+ gradleBin = new Java_gradle().selectToolBinary(rootManifest || rootBuild, opts);
589
+ }
590
+ catch {
591
+ const ignorePatterns = [...resolveWorkspaceDiscoveryIgnore(opts), ...DEFAULT_GRADLE_DISCOVERY_IGNORE];
592
+ return filterManifestPathsByDiscoveryIgnore(manifestPaths, root, ignorePatterns);
593
+ }
594
+ const initScriptPath = path.join(os.tmpdir(), `da-list-projects-${crypto.randomUUID()}.gradle`);
595
+ try {
596
+ fs.writeFileSync(initScriptPath, GRADLE_INIT_SCRIPT);
597
+ let output;
598
+ try {
599
+ output = invokeCommand(gradleBin, [
600
+ '-q', '--no-daemon',
601
+ '--init-script', initScriptPath,
602
+ 'daListProjects',
603
+ ], { cwd: root });
604
+ }
605
+ catch {
606
+ const ignorePatterns = [...resolveWorkspaceDiscoveryIgnore(opts), ...DEFAULT_GRADLE_DISCOVERY_IGNORE];
607
+ return filterManifestPathsByDiscoveryIgnore(manifestPaths, root, ignorePatterns);
608
+ }
609
+ const projects = parseGradleInitScriptOutput(output.toString());
610
+ for (const proj of projects) {
611
+ if (proj.path === ':') {
612
+ continue;
613
+ }
614
+ const projDir = path.resolve(proj.dir);
615
+ const buildKts = path.join(projDir, 'build.gradle.kts');
616
+ const buildGroovy = path.join(projDir, 'build.gradle');
617
+ if (fs.existsSync(buildKts)) {
618
+ manifestPaths.push(buildKts);
619
+ }
620
+ else if (fs.existsSync(buildGroovy)) {
621
+ manifestPaths.push(buildGroovy);
622
+ }
623
+ }
624
+ }
625
+ finally {
626
+ try {
627
+ fs.unlinkSync(initScriptPath);
628
+ }
629
+ catch { /* ignore */ }
630
+ }
631
+ const ignorePatterns = [...resolveWorkspaceDiscoveryIgnore(opts), ...DEFAULT_GRADLE_DISCOVERY_IGNORE];
632
+ return filterManifestPathsByDiscoveryIgnore(manifestPaths, root, ignorePatterns);
633
+ }
634
+ /**
635
+ * Parse the structured output from the Gradle init script.
636
+ *
637
+ * @param {string} raw - Raw stdout from gradle
638
+ * @returns {{ path: string, dir: string }[]}
639
+ */
640
+ export function parseGradleInitScriptOutput(raw) {
641
+ const projects = [];
642
+ for (const rawLine of raw.split('\n')) {
643
+ const line = rawLine.trimEnd();
644
+ if (!line.startsWith('::DA_PROJECT::')) {
645
+ continue;
646
+ }
647
+ const prefix = '::DA_PROJECT::';
648
+ const remainder = line.substring(prefix.length);
649
+ const lastSep = remainder.lastIndexOf('::');
650
+ if (lastSep < 0) {
651
+ continue;
652
+ }
653
+ const projPath = remainder.substring(0, lastSep);
654
+ const dir = remainder.substring(lastSep + 2);
655
+ if (projPath && dir) {
656
+ projects.push({ path: projPath, dir });
657
+ }
658
+ }
659
+ return projects;
660
+ }
661
+ /**
662
+ * Parse the structured output from the Gradle hash init script.
663
+ * Each recognised line has the form `::DA_HASH::group:name:version::<file-path>`.
664
+ *
665
+ * @param {string} raw - Raw stdout from gradle
666
+ * @returns {{ id: string, file: string }[]} component id (`group:name:version`) and absolute artifact file path
667
+ */
668
+ export function parseGradleHashScriptOutput(raw) {
669
+ const artifacts = [];
670
+ for (const rawLine of raw.split('\n')) {
671
+ const line = rawLine.trimEnd();
672
+ if (!line.startsWith('::DA_HASH::')) {
673
+ continue;
674
+ }
675
+ const prefix = '::DA_HASH::';
676
+ const remainder = line.substring(prefix.length);
677
+ const lastSep = remainder.lastIndexOf('::');
678
+ if (lastSep < 0) {
679
+ continue;
680
+ }
681
+ const id = remainder.substring(0, lastSep);
682
+ const file = remainder.substring(lastSep + 2);
683
+ if (id && file) {
684
+ artifacts.push({ id, file });
685
+ }
686
+ }
687
+ return artifacts;
688
+ }
689
+ /**
690
+ * Parse a Gradle module component id (`group:name:version`) into its coordinate
691
+ * parts. The caller builds the canonical PURL key from these parts using the same
692
+ * builder {@link parseDep} uses, so the stored key and the lookup key cannot drift.
693
+ *
694
+ * @param {string} id - the Gradle component id
695
+ * @returns {{group: string, name: string, version: string}|null} the parsed coordinate, or null when the id is malformed
696
+ */
697
+ export function parseComponentId(id) {
698
+ const parts = id.split(':');
699
+ if (parts.length < 3) {
700
+ return null;
701
+ }
702
+ const [group, name, version] = parts;
703
+ if (!group || !name || !version) {
704
+ return null;
705
+ }
706
+ return { group, name, version };
707
+ }
@@ -3,5 +3,5 @@ export default class Java_gradle_groovy extends Java_gradle {
3
3
  _parseAliasForLibsNotation(alias: any): any;
4
4
  _extractDepToBeIgnored(dep: any): any;
5
5
  }
6
- export type Provided = import("../provider").Provided;
6
+ export type Provided = any;
7
7
  import Java_gradle from './java_gradle.js';
@@ -7,5 +7,5 @@ export default class Java_gradle_kotlin extends Java_gradle {
7
7
  _parseAliasForLibsNotation(alias: any): any;
8
8
  _extractDepToBeIgnored(dep: any): string | null;
9
9
  }
10
- export type Provided = import("../provider").Provided;
10
+ export type Provided = any;
11
11
  import Java_gradle from './java_gradle.js';
@@ -1,8 +1,16 @@
1
- /** @typedef {import('../provider').Provider} */
2
- /** @typedef {import('../provider').Provided} Provided */
3
- /** @typedef {{name: string, version: string}} Package */
4
- /** @typedef {{groupId: string, artifactId: string, version: string, scope: string, ignore: boolean}} Dependency */
1
+ /**
2
+ * Discover all pom.xml manifest paths in a Maven multi-module project.
3
+ *
4
+ * @param {string} workspaceRoot - Absolute or relative path to workspace root (must contain pom.xml)
5
+ * @param {object} [opts={}]
6
+ * @returns {Promise<string[]>} Paths to pom.xml files (absolute)
7
+ */
8
+ export function discoverMavenModules(workspaceRoot: string, opts?: object): Promise<string[]>;
5
9
  export default class Java_maven extends Base_java {
10
+ /** @type {Object<string, string>} Packaging types that produce .jar files despite non-jar packaging names. */
11
+ static PACKAGING_TO_JAR: {
12
+ [x: string]: string;
13
+ };
6
14
  constructor();
7
15
  /**
8
16
  * @param {string} manifestName - the subject manifest name-type
@@ -17,9 +25,9 @@ export default class Java_maven extends Base_java {
17
25
  * Provide content and content type for maven-maven stack analysis.
18
26
  * @param {string} manifest - the manifest path or name
19
27
  * @param {{}} [opts={}] - optional various options to pass along the application
20
- * @returns {Provided}
28
+ * @returns {Promise<Provided>}
21
29
  */
22
- provideStack(manifest: string, opts?: {}): Provided;
30
+ provideStack(manifest: string, opts?: {}): Promise<Provided>;
23
31
  /**
24
32
  * Provide content and content type for maven-maven component analysis.
25
33
  * @param {string} manifest - path to the manifest file
@@ -34,17 +42,37 @@ export default class Java_maven extends Base_java {
34
42
  */
35
43
  readLicenseFromManifest(manifestPath: string): string | null;
36
44
  /**
45
+ * Build a Map of PURL string → CycloneDX hash entries by reading artifact files from the local Maven repository.
46
+ *
47
+ * Both the artifact file path and the hash-map key are derived from the
48
+ * shared {@link Base_java#parseCoordinate} parser: the file path uses the
49
+ * resolved version and raw classifier, while the key uses the same canonical
50
+ * PURL builder as {@link Base_java#parseDep}. This guarantees the key always
51
+ * matches the PURL that {@link Base_java#parseDependencyTree} looks up.
37
52
  *
53
+ * @param {string} depTreeText Raw dependency tree text from mvn dependency:tree
54
+ * @param {{}} [opts={}] Options bag (may contain TRUSTIFY_DA_MVN_REPO)
55
+ * @returns {Promise<Map<string, Array<{alg: string, content: string}>>>}
56
+ */
57
+ _buildMavenHashMap(depTreeText: string, opts?: {}): Promise<Map<string, Array<{
58
+ alg: string;
59
+ content: string;
60
+ }>>>;
61
+ /**
38
62
  * @param {String} textGraphList Text graph String of the manifest
39
63
  * @param {[String]} ignoredDeps List of ignored dependencies to be omitted from sbom
64
+ * @param {{}} opts Options
40
65
  * @param {String} manifestPath Path to the pom.xml manifest
66
+ * @param {Map<string, Array<{alg: string, content: string}>>} [hashMap] PURL→hashes map
41
67
  * @return {String} formatted sbom Json String with all dependencies
42
68
  */
43
- createSbomFileFromTextFormat(textGraphList: string, ignoredDeps: [string], opts: any, manifestPath: string): string;
69
+ createSbomFileFromTextFormat(textGraphList: string, ignoredDeps: [string], opts: {}, manifestPath: string, hashMap?: Map<string, Array<{
70
+ alg: string;
71
+ content: string;
72
+ }>>): string;
44
73
  #private;
45
74
  }
46
- export type Java_maven = import("../provider").Provider;
47
- export type Provided = import("../provider").Provided;
75
+ export type Provided = any;
48
76
  export type Package = {
49
77
  name: string;
50
78
  version: string;