@openai/codex-security 0.8.2 → 0.9.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 (649) hide show
  1. package/README.md +201 -178
  2. package/_bundled_plugin/.app.json +4 -0
  3. package/_bundled_plugin/.mcp.json +6 -1
  4. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  5. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  6. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  7. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  8. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  9. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/package.json +1 -0
  20. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +51 -14
  21. package/_bundled_plugin/mcp/server.mjs +2 -11
  22. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  23. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  24. package/_bundled_plugin/references/artifact-storage.md +1 -1
  25. package/_bundled_plugin/references/core-scan.md +14 -5
  26. package/_bundled_plugin/references/default-severity-rubric.md +33 -0
  27. package/_bundled_plugin/references/final-report.md +5 -3
  28. package/_bundled_plugin/references/finding-detail-fields.md +19 -18
  29. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  30. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  31. package/_bundled_plugin/references/scan-contract.md +27 -33
  32. package/_bundled_plugin/references/threat-model.md +1 -0
  33. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  34. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  35. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  36. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  37. package/_bundled_plugin/scripts/deep_scan_workbench.py +188 -454
  38. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  39. package/_bundled_plugin/scripts/finalize_scan_contract.py +317 -377
  40. package/_bundled_plugin/scripts/finding_preview.py +25 -29
  41. package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
  42. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  43. package/_bundled_plugin/scripts/posix_scan_local_files.py +198 -0
  44. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  45. package/_bundled_plugin/scripts/report_projection.py +167 -178
  46. package/_bundled_plugin/scripts/review_state.py +8 -2
  47. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  48. package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
  49. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  50. package/_bundled_plugin/scripts/validate_scan_contract.py +9 -7
  51. package/_bundled_plugin/scripts/windows_scan_local_files.py +600 -72
  52. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  53. package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
  54. package/_bundled_plugin/scripts/workbench/retained_coverage.py +38 -75
  55. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  56. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  57. package/_bundled_plugin/scripts/workbench/saved_coverage.py +152 -248
  58. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  59. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  60. package/_bundled_plugin/scripts/workbench/storage.py +71 -7
  61. package/_bundled_plugin/scripts/workbench_cli.py +121 -14
  62. package/_bundled_plugin/scripts/workbench_constants.py +19 -0
  63. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  64. package/_bundled_plugin/scripts/workbench_db.py +550 -492
  65. package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
  66. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  67. package/_bundled_plugin/scripts/workbench_finding_workflows.py +90 -4
  68. package/_bundled_plugin/scripts/workbench_native_indexes.py +29 -33
  69. package/_bundled_plugin/scripts/workbench_progress.py +10 -1
  70. package/_bundled_plugin/scripts/workbench_publication.py +14 -10
  71. package/_bundled_plugin/scripts/workbench_remediation.py +508 -11
  72. package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
  73. package/_bundled_plugin/scripts/workbench_scan_history.py +139 -80
  74. package/_bundled_plugin/scripts/workbench_scan_start.py +84 -25
  75. package/_bundled_plugin/scripts/workbench_scan_usage.py +666 -117
  76. package/_bundled_plugin/scripts/workbench_schema.py +44 -55
  77. package/_bundled_plugin/scripts/workbench_setup.py +251 -0
  78. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  79. package/_bundled_plugin/scripts/workbench_source_scopes.py +33 -23
  80. package/_bundled_plugin/scripts/workbench_target.py +330 -66
  81. package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
  82. package/_bundled_plugin/scripts/workbench_validation.py +44 -12
  83. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -16
  84. package/_bundled_plugin/shared/workbench-migrations.json +53 -0
  85. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -1
  86. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +4 -68
  87. package/_bundled_plugin/skills/check-skills/SKILL.md +43 -0
  88. package/_bundled_plugin/skills/check-skills/agents/openai.yaml +4 -0
  89. package/_bundled_plugin/skills/cloud-findings/SKILL.md +6 -4
  90. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  91. package/_bundled_plugin/skills/fix-finding/SKILL.md +19 -2
  92. package/_bundled_plugin/skills/publish-findings/SKILL.md +81 -45
  93. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  94. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +5 -24
  95. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
  96. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +36 -9
  97. package/_bundled_plugin/skills/track-findings/SKILL.md +5 -3
  98. package/_bundled_plugin/skills/triage-finding/references/github-rest-intake.md +22 -68
  99. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +12 -6
  100. package/dist/api.d.ts +45 -5
  101. package/dist/api.d.ts.map +1 -1
  102. package/dist/api.js +1144 -411
  103. package/dist/api.js.map +1 -1
  104. package/dist/auth.d.ts.map +1 -1
  105. package/dist/auth.js +10 -7
  106. package/dist/auth.js.map +1 -1
  107. package/dist/bedrock-oss-pricing.d.ts +6 -0
  108. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  109. package/dist/bedrock-oss-pricing.js +58 -0
  110. package/dist/bedrock-oss-pricing.js.map +1 -0
  111. package/dist/bedrock-pricing.d.ts +15 -0
  112. package/dist/bedrock-pricing.d.ts.map +1 -0
  113. package/dist/bedrock-pricing.js +117 -0
  114. package/dist/bedrock-pricing.js.map +1 -0
  115. package/dist/blackduck-findings.d.ts +8 -0
  116. package/dist/blackduck-findings.d.ts.map +1 -0
  117. package/dist/blackduck-findings.js +320 -0
  118. package/dist/blackduck-findings.js.map +1 -0
  119. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  120. package/dist/bulk-scan-discovery.js +51 -36
  121. package/dist/bulk-scan-discovery.js.map +1 -1
  122. package/dist/checkmarx-evidence.d.ts +19 -0
  123. package/dist/checkmarx-evidence.d.ts.map +1 -0
  124. package/dist/checkmarx-evidence.js +36 -0
  125. package/dist/checkmarx-evidence.js.map +1 -0
  126. package/dist/checkmarx-findings.d.ts +4 -0
  127. package/dist/checkmarx-findings.d.ts.map +1 -0
  128. package/dist/checkmarx-findings.js +27 -0
  129. package/dist/checkmarx-findings.js.map +1 -0
  130. package/dist/checkmarx-one.d.ts +4 -0
  131. package/dist/checkmarx-one.d.ts.map +1 -0
  132. package/dist/checkmarx-one.js +53 -0
  133. package/dist/checkmarx-one.js.map +1 -0
  134. package/dist/checkmarx-repository.d.ts +12 -0
  135. package/dist/checkmarx-repository.d.ts.map +1 -0
  136. package/dist/checkmarx-repository.js +181 -0
  137. package/dist/checkmarx-repository.js.map +1 -0
  138. package/dist/checkmarx-xml.d.ts +12 -0
  139. package/dist/checkmarx-xml.d.ts.map +1 -0
  140. package/dist/checkmarx-xml.js +196 -0
  141. package/dist/checkmarx-xml.js.map +1 -0
  142. package/dist/classify-severity-records.d.ts +6 -9
  143. package/dist/classify-severity-records.d.ts.map +1 -1
  144. package/dist/classify-severity-records.js +9 -21
  145. package/dist/classify-severity-records.js.map +1 -1
  146. package/dist/classify-severity.d.ts +4 -1
  147. package/dist/classify-severity.d.ts.map +1 -1
  148. package/dist/classify-severity.js +30 -13
  149. package/dist/classify-severity.js.map +1 -1
  150. package/dist/cli.d.ts +14 -5
  151. package/dist/cli.d.ts.map +1 -1
  152. package/dist/cli.js +2112 -1266
  153. package/dist/cli.js.map +1 -1
  154. package/dist/cloud-publish.js +2 -2
  155. package/dist/cloud-publish.js.map +1 -1
  156. package/dist/codex-prompt.d.ts +2 -0
  157. package/dist/codex-prompt.d.ts.map +1 -1
  158. package/dist/codex-prompt.js +6 -0
  159. package/dist/codex-prompt.js.map +1 -1
  160. package/dist/component-scan.d.ts +16 -3
  161. package/dist/component-scan.d.ts.map +1 -1
  162. package/dist/component-scan.js +32 -6
  163. package/dist/component-scan.js.map +1 -1
  164. package/dist/config.d.ts +2 -1
  165. package/dist/config.d.ts.map +1 -1
  166. package/dist/config.js +221 -65
  167. package/dist/config.js.map +1 -1
  168. package/dist/continuum-findings.d.ts +7 -0
  169. package/dist/continuum-findings.d.ts.map +1 -0
  170. package/dist/continuum-findings.js +225 -0
  171. package/dist/continuum-findings.js.map +1 -0
  172. package/dist/contract-values.d.ts +30 -0
  173. package/dist/contract-values.d.ts.map +1 -0
  174. package/dist/contract-values.js +78 -0
  175. package/dist/contract-values.js.map +1 -0
  176. package/dist/contract.d.ts +2 -20
  177. package/dist/contract.d.ts.map +1 -1
  178. package/dist/contract.js +58 -669
  179. package/dist/contract.js.map +1 -1
  180. package/dist/cost-model.d.ts +13 -1
  181. package/dist/cost-model.d.ts.map +1 -1
  182. package/dist/cost-model.js +66 -115
  183. package/dist/cost-model.js.map +1 -1
  184. package/dist/cost.d.ts +61 -4
  185. package/dist/cost.d.ts.map +1 -1
  186. package/dist/cost.js +2560 -100
  187. package/dist/cost.js.map +1 -1
  188. package/dist/custom-publish.d.ts +4 -0
  189. package/dist/custom-publish.d.ts.map +1 -1
  190. package/dist/custom-publish.js +40 -3
  191. package/dist/custom-publish.js.map +1 -1
  192. package/dist/custom-validation-prompt.d.ts +1 -1
  193. package/dist/custom-validation-prompt.d.ts.map +1 -1
  194. package/dist/custom-validation-prompt.js +5 -0
  195. package/dist/custom-validation-prompt.js.map +1 -1
  196. package/dist/custom-validation.d.ts +2 -0
  197. package/dist/custom-validation.d.ts.map +1 -1
  198. package/dist/custom-validation.js +4 -0
  199. package/dist/custom-validation.js.map +1 -1
  200. package/dist/deduplication/deduplication-prompts.d.ts +4 -4
  201. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  202. package/dist/deduplication/deduplication-prompts.js +2 -2
  203. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  204. package/dist/deduplication/deduplication-reviewer.d.ts +14 -11
  205. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  206. package/dist/deduplication/deduplication-reviewer.js +11 -4
  207. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  208. package/dist/deduplication/deduplication.js.map +1 -1
  209. package/dist/deduplication/finding-schema.d.ts +19 -1
  210. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  211. package/dist/deduplication/finding-schema.js +25 -0
  212. package/dist/deduplication/finding-schema.js.map +1 -1
  213. package/dist/deduplication/local.d.ts +2 -2
  214. package/dist/deduplication/local.d.ts.map +1 -1
  215. package/dist/deduplication/local.js +5 -10
  216. package/dist/deduplication/local.js.map +1 -1
  217. package/dist/deduplication/records.d.ts +8 -2
  218. package/dist/deduplication/records.d.ts.map +1 -1
  219. package/dist/deduplication/records.js +36 -8
  220. package/dist/deduplication/records.js.map +1 -1
  221. package/dist/deduplication/refusal.d.ts.map +1 -1
  222. package/dist/deduplication/refusal.js +25 -5
  223. package/dist/deduplication/refusal.js.map +1 -1
  224. package/dist/deduplication/scan.d.ts +3 -0
  225. package/dist/deduplication/scan.d.ts.map +1 -1
  226. package/dist/deduplication/scan.js +1 -1
  227. package/dist/deduplication/scan.js.map +1 -1
  228. package/dist/deep-config.d.ts +0 -1
  229. package/dist/deep-config.d.ts.map +1 -1
  230. package/dist/deep-config.js +22 -33
  231. package/dist/deep-config.js.map +1 -1
  232. package/dist/deep-scan-defaults.d.ts +2 -0
  233. package/dist/deep-scan-defaults.d.ts.map +1 -1
  234. package/dist/deep-scan-defaults.js +28 -1
  235. package/dist/deep-scan-defaults.js.map +1 -1
  236. package/dist/deep-scan.d.ts +13 -0
  237. package/dist/deep-scan.d.ts.map +1 -1
  238. package/dist/deep-scan.js +262 -7
  239. package/dist/deep-scan.js.map +1 -1
  240. package/dist/default-severity-rubric.d.ts +1 -2
  241. package/dist/default-severity-rubric.d.ts.map +1 -1
  242. package/dist/default-severity-rubric.js +2 -66
  243. package/dist/default-severity-rubric.js.map +1 -1
  244. package/dist/endor-findings.d.ts +3 -1
  245. package/dist/endor-findings.d.ts.map +1 -1
  246. package/dist/endor-findings.js +108 -80
  247. package/dist/endor-findings.js.map +1 -1
  248. package/dist/errors.d.ts +1 -1
  249. package/dist/errors.d.ts.map +1 -1
  250. package/dist/errors.js +9 -2
  251. package/dist/errors.js.map +1 -1
  252. package/dist/external-findings-import.d.ts +5 -3
  253. package/dist/external-findings-import.d.ts.map +1 -1
  254. package/dist/external-findings-import.js +11 -16
  255. package/dist/external-findings-import.js.map +1 -1
  256. package/dist/external-findings-local.d.ts +15 -4
  257. package/dist/external-findings-local.d.ts.map +1 -1
  258. package/dist/external-findings-local.js +619 -225
  259. package/dist/external-findings-local.js.map +1 -1
  260. package/dist/external-findings-publish.d.ts +20 -6
  261. package/dist/external-findings-publish.d.ts.map +1 -1
  262. package/dist/external-findings-publish.js +2356 -308
  263. package/dist/external-findings-publish.js.map +1 -1
  264. package/dist/external-findings-read.d.ts +28 -2
  265. package/dist/external-findings-read.d.ts.map +1 -1
  266. package/dist/external-findings-read.js +174 -81
  267. package/dist/external-findings-read.js.map +1 -1
  268. package/dist/external-findings.d.ts +17 -3
  269. package/dist/external-findings.d.ts.map +1 -1
  270. package/dist/external-findings.js +153 -1
  271. package/dist/external-findings.js.map +1 -1
  272. package/dist/external-import-contract.d.ts +33 -1
  273. package/dist/external-import-contract.d.ts.map +1 -1
  274. package/dist/external-import-contract.js +335 -51
  275. package/dist/external-import-contract.js.map +1 -1
  276. package/dist/external-import-models.d.ts +1 -1
  277. package/dist/external-import-models.d.ts.map +1 -1
  278. package/dist/external-import-models.js.map +1 -1
  279. package/dist/feedback.d.ts.map +1 -1
  280. package/dist/feedback.js +5 -4
  281. package/dist/feedback.js.map +1 -1
  282. package/dist/finding-prompt.d.ts +5 -0
  283. package/dist/finding-prompt.d.ts.map +1 -0
  284. package/dist/finding-prompt.js +32 -0
  285. package/dist/finding-prompt.js.map +1 -0
  286. package/dist/finding-retrieval.d.ts +3 -3
  287. package/dist/finding-retrieval.d.ts.map +1 -1
  288. package/dist/finding-retrieval.js.map +1 -1
  289. package/dist/finding-workflow.d.ts +6 -1
  290. package/dist/finding-workflow.d.ts.map +1 -1
  291. package/dist/finding-workflow.js +2 -2
  292. package/dist/finding-workflow.js.map +1 -1
  293. package/dist/findings-client.d.ts +1 -0
  294. package/dist/findings-client.d.ts.map +1 -1
  295. package/dist/findings-client.js +27 -3
  296. package/dist/findings-client.js.map +1 -1
  297. package/dist/git-remote.d.ts +4 -0
  298. package/dist/git-remote.d.ts.map +1 -1
  299. package/dist/git-remote.js +20 -0
  300. package/dist/git-remote.js.map +1 -1
  301. package/dist/github-advisories.d.ts +3 -12
  302. package/dist/github-advisories.d.ts.map +1 -1
  303. package/dist/github-advisories.js +9 -31
  304. package/dist/github-advisories.js.map +1 -1
  305. package/dist/github-dependabot-findings.d.ts.map +1 -1
  306. package/dist/github-dependabot-findings.js +22 -20
  307. package/dist/github-dependabot-findings.js.map +1 -1
  308. package/dist/github-findings.d.ts +4 -1
  309. package/dist/github-findings.d.ts.map +1 -1
  310. package/dist/github-findings.js +392 -79
  311. package/dist/github-findings.js.map +1 -1
  312. package/dist/github.d.ts +17 -7
  313. package/dist/github.d.ts.map +1 -1
  314. package/dist/github.js +43 -30
  315. package/dist/github.js.map +1 -1
  316. package/dist/host-protocol.d.ts +2 -2
  317. package/dist/host-protocol.d.ts.map +1 -1
  318. package/dist/host-protocol.js.map +1 -1
  319. package/dist/host-records-protocol.d.ts +10 -11
  320. package/dist/host-records-protocol.d.ts.map +1 -1
  321. package/dist/host-records-protocol.js +69 -9
  322. package/dist/host-records-protocol.js.map +1 -1
  323. package/dist/hosted-git-remotes.d.ts +5 -0
  324. package/dist/hosted-git-remotes.d.ts.map +1 -0
  325. package/dist/hosted-git-remotes.js +285 -0
  326. package/dist/hosted-git-remotes.js.map +1 -0
  327. package/dist/hosted-git-repository.d.ts +28 -0
  328. package/dist/hosted-git-repository.d.ts.map +1 -0
  329. package/dist/hosted-git-repository.js +222 -0
  330. package/dist/hosted-git-repository.js.map +1 -0
  331. package/dist/hosted-scan-protocol.js +2 -2
  332. package/dist/hosted-scan-protocol.js.map +1 -1
  333. package/dist/hosted-scan.d.ts +15 -0
  334. package/dist/hosted-scan.d.ts.map +1 -1
  335. package/dist/hosted-scan.js +71 -44
  336. package/dist/hosted-scan.js.map +1 -1
  337. package/dist/hosted-scanner-http.d.ts +21 -0
  338. package/dist/hosted-scanner-http.d.ts.map +1 -0
  339. package/dist/hosted-scanner-http.js +204 -0
  340. package/dist/hosted-scanner-http.js.map +1 -0
  341. package/dist/hosted-scanner-v1.d.ts +6 -0
  342. package/dist/hosted-scanner-v1.d.ts.map +1 -0
  343. package/dist/hosted-scanner-v1.js +60 -0
  344. package/dist/hosted-scanner-v1.js.map +1 -0
  345. package/dist/import-scan.d.ts.map +1 -1
  346. package/dist/import-scan.js +3 -0
  347. package/dist/import-scan.js.map +1 -1
  348. package/dist/index.d.ts +24 -6
  349. package/dist/index.d.ts.map +1 -1
  350. package/dist/index.js +15 -1
  351. package/dist/index.js.map +1 -1
  352. package/dist/inspector-findings.d.ts.map +1 -1
  353. package/dist/inspector-findings.js +58 -81
  354. package/dist/inspector-findings.js.map +1 -1
  355. package/dist/knowledge-base.d.ts.map +1 -1
  356. package/dist/knowledge-base.js +86 -10
  357. package/dist/knowledge-base.js.map +1 -1
  358. package/dist/local-git-metadata.d.ts +5 -0
  359. package/dist/local-git-metadata.d.ts.map +1 -0
  360. package/dist/local-git-metadata.js +130 -0
  361. package/dist/local-git-metadata.js.map +1 -0
  362. package/dist/multiscan.d.ts +6 -4
  363. package/dist/multiscan.d.ts.map +1 -1
  364. package/dist/multiscan.js +160 -77
  365. package/dist/multiscan.js.map +1 -1
  366. package/dist/native-json-findings.d.ts +2 -1
  367. package/dist/native-json-findings.d.ts.map +1 -1
  368. package/dist/native-json-findings.js +12 -2
  369. package/dist/native-json-findings.js.map +1 -1
  370. package/dist/opengrep-findings.d.ts +1 -0
  371. package/dist/opengrep-findings.d.ts.map +1 -1
  372. package/dist/opengrep-findings.js +49 -31
  373. package/dist/opengrep-findings.js.map +1 -1
  374. package/dist/operation-telemetry.d.ts +104 -0
  375. package/dist/operation-telemetry.d.ts.map +1 -0
  376. package/dist/operation-telemetry.js +293 -0
  377. package/dist/operation-telemetry.js.map +1 -0
  378. package/dist/patch-tui.d.ts.map +1 -1
  379. package/dist/patch-tui.js +90 -35
  380. package/dist/patch-tui.js.map +1 -1
  381. package/dist/plugin-python-probe.d.ts +4 -0
  382. package/dist/plugin-python-probe.d.ts.map +1 -0
  383. package/dist/plugin-python-probe.js +10 -0
  384. package/dist/plugin-python-probe.js.map +1 -0
  385. package/dist/private-finding-import.d.ts +341 -0
  386. package/dist/private-finding-import.d.ts.map +1 -0
  387. package/dist/private-finding-import.js +411 -0
  388. package/dist/private-finding-import.js.map +1 -0
  389. package/dist/project-config.d.ts.map +1 -1
  390. package/dist/project-config.js +2 -2
  391. package/dist/project-config.js.map +1 -1
  392. package/dist/provider-profile.d.ts +11 -3
  393. package/dist/provider-profile.d.ts.map +1 -1
  394. package/dist/provider-profile.js +80 -11
  395. package/dist/provider-profile.js.map +1 -1
  396. package/dist/publication-telemetry.d.ts +45 -0
  397. package/dist/publication-telemetry.d.ts.map +1 -0
  398. package/dist/publication-telemetry.js +50 -0
  399. package/dist/publication-telemetry.js.map +1 -0
  400. package/dist/publication.js +7 -1
  401. package/dist/publication.js.map +1 -1
  402. package/dist/publish.d.ts +4 -0
  403. package/dist/publish.d.ts.map +1 -1
  404. package/dist/publish.js +42 -2
  405. package/dist/publish.js.map +1 -1
  406. package/dist/reader-selection.d.ts +15 -0
  407. package/dist/reader-selection.d.ts.map +1 -0
  408. package/dist/reader-selection.js +89 -0
  409. package/dist/reader-selection.js.map +1 -0
  410. package/dist/record.d.ts +6 -1
  411. package/dist/record.d.ts.map +1 -1
  412. package/dist/record.js +53 -2
  413. package/dist/record.js.map +1 -1
  414. package/dist/remediation.d.ts +3 -1
  415. package/dist/remediation.d.ts.map +1 -1
  416. package/dist/remediation.js +28 -2
  417. package/dist/remediation.js.map +1 -1
  418. package/dist/request-metadata.d.ts +3 -0
  419. package/dist/request-metadata.d.ts.map +1 -1
  420. package/dist/request-metadata.js +9 -0
  421. package/dist/request-metadata.js.map +1 -1
  422. package/dist/result.d.ts +6 -0
  423. package/dist/result.d.ts.map +1 -1
  424. package/dist/result.js +3 -1
  425. package/dist/result.js.map +1 -1
  426. package/dist/retry-windows-rename.d.ts +8 -0
  427. package/dist/retry-windows-rename.d.ts.map +1 -0
  428. package/dist/retry-windows-rename.js +24 -0
  429. package/dist/retry-windows-rename.js.map +1 -0
  430. package/dist/runtime.d.ts +22 -1
  431. package/dist/runtime.d.ts.map +1 -1
  432. package/dist/runtime.js +408 -162
  433. package/dist/runtime.js.map +1 -1
  434. package/dist/saved-scan-bootstrap.d.ts +1 -0
  435. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  436. package/dist/saved-scan-bootstrap.js +18 -15
  437. package/dist/saved-scan-bootstrap.js.map +1 -1
  438. package/dist/scan-activity.d.ts.map +1 -1
  439. package/dist/scan-activity.js +172 -64
  440. package/dist/scan-activity.js.map +1 -1
  441. package/dist/scan-comparison.d.ts +10 -5
  442. package/dist/scan-comparison.d.ts.map +1 -1
  443. package/dist/scan-comparison.js +68 -25
  444. package/dist/scan-comparison.js.map +1 -1
  445. package/dist/scan-dashboard.d.ts +7 -6
  446. package/dist/scan-dashboard.d.ts.map +1 -1
  447. package/dist/scan-dashboard.js +91 -79
  448. package/dist/scan-dashboard.js.map +1 -1
  449. package/dist/scan-executor.d.ts +12 -1
  450. package/dist/scan-executor.d.ts.map +1 -1
  451. package/dist/scan-executor.js +22 -2
  452. package/dist/scan-executor.js.map +1 -1
  453. package/dist/scan-history-renderer.d.ts.map +1 -1
  454. package/dist/scan-history-renderer.js +31 -28
  455. package/dist/scan-history-renderer.js.map +1 -1
  456. package/dist/scan-logs.d.ts +12 -0
  457. package/dist/scan-logs.d.ts.map +1 -1
  458. package/dist/scan-logs.js +106 -77
  459. package/dist/scan-logs.js.map +1 -1
  460. package/dist/scan-measurement.d.ts +26 -0
  461. package/dist/scan-measurement.d.ts.map +1 -0
  462. package/dist/scan-measurement.js +77 -0
  463. package/dist/scan-measurement.js.map +1 -0
  464. package/dist/scan-progress.d.ts +1 -0
  465. package/dist/scan-progress.d.ts.map +1 -1
  466. package/dist/scan-progress.js +3 -0
  467. package/dist/scan-progress.js.map +1 -1
  468. package/dist/scan-sessions.d.ts.map +1 -1
  469. package/dist/scan-sessions.js +4 -1
  470. package/dist/scan-sessions.js.map +1 -1
  471. package/dist/scan-settings.d.ts +1 -1
  472. package/dist/scan-settings.d.ts.map +1 -1
  473. package/dist/scan-settings.js +1 -24
  474. package/dist/scan-settings.js.map +1 -1
  475. package/dist/scanner-import.d.ts +64 -6
  476. package/dist/scanner-import.d.ts.map +1 -1
  477. package/dist/scanner-import.js +406 -48
  478. package/dist/scanner-import.js.map +1 -1
  479. package/dist/scanner-repository-url.d.ts +17 -0
  480. package/dist/scanner-repository-url.d.ts.map +1 -0
  481. package/dist/scanner-repository-url.js +71 -0
  482. package/dist/scanner-repository-url.js.map +1 -0
  483. package/dist/security-policy.d.ts +1 -1
  484. package/dist/security-policy.d.ts.map +1 -1
  485. package/dist/security-policy.js.map +1 -1
  486. package/dist/semgrep-findings.d.ts +6 -3
  487. package/dist/semgrep-findings.d.ts.map +1 -1
  488. package/dist/semgrep-findings.js +124 -88
  489. package/dist/semgrep-findings.js.map +1 -1
  490. package/dist/semgrep-guardian-findings.d.ts +38 -0
  491. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  492. package/dist/semgrep-guardian-findings.js +165 -0
  493. package/dist/semgrep-guardian-findings.js.map +1 -0
  494. package/dist/semgrep-platform-collector.d.ts +26 -0
  495. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  496. package/dist/semgrep-platform-collector.js +108 -0
  497. package/dist/semgrep-platform-collector.js.map +1 -0
  498. package/dist/semgrep-platform-findings.d.ts +213 -0
  499. package/dist/semgrep-platform-findings.d.ts.map +1 -0
  500. package/dist/semgrep-platform-findings.js +1078 -0
  501. package/dist/semgrep-platform-findings.js.map +1 -0
  502. package/dist/semgrep-platform-v1.d.ts +6 -0
  503. package/dist/semgrep-platform-v1.d.ts.map +1 -0
  504. package/dist/semgrep-platform-v1.js +83 -0
  505. package/dist/semgrep-platform-v1.js.map +1 -0
  506. package/dist/server/api.d.ts +1 -1
  507. package/dist/server/api.d.ts.map +1 -1
  508. package/dist/server/api.js.map +1 -1
  509. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  510. package/dist/server/embedding-tokenizer.d.ts +2 -0
  511. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  512. package/dist/server/embedding-tokenizer.js +322 -0
  513. package/dist/server/embedding-tokenizer.js.map +6 -0
  514. package/dist/server/embeddings.d.ts +16 -2
  515. package/dist/server/embeddings.d.ts.map +1 -1
  516. package/dist/server/embeddings.js +35 -5
  517. package/dist/server/embeddings.js.map +1 -1
  518. package/dist/session-lines.d.ts +5 -0
  519. package/dist/session-lines.d.ts.map +1 -0
  520. package/dist/session-lines.js +60 -0
  521. package/dist/session-lines.js.map +1 -0
  522. package/dist/severity-review.d.ts +3 -1
  523. package/dist/severity-review.d.ts.map +1 -1
  524. package/dist/severity-review.js +3 -2
  525. package/dist/severity-review.js.map +1 -1
  526. package/dist/severity-rubric.d.ts +20 -0
  527. package/dist/severity-rubric.d.ts.map +1 -0
  528. package/dist/severity-rubric.js +73 -0
  529. package/dist/severity-rubric.js.map +1 -0
  530. package/dist/severity-store.js +15 -5
  531. package/dist/severity-store.js.map +1 -1
  532. package/dist/skill-authentication.d.ts +1 -0
  533. package/dist/skill-authentication.d.ts.map +1 -1
  534. package/dist/skill-authentication.js +1 -0
  535. package/dist/skill-authentication.js.map +1 -1
  536. package/dist/snyk-findings.d.ts +7 -2
  537. package/dist/snyk-findings.d.ts.map +1 -1
  538. package/dist/snyk-findings.js +108 -84
  539. package/dist/snyk-findings.js.map +1 -1
  540. package/dist/snyk-rest-findings.d.ts +76 -0
  541. package/dist/snyk-rest-findings.d.ts.map +1 -0
  542. package/dist/snyk-rest-findings.js +1051 -0
  543. package/dist/snyk-rest-findings.js.map +1 -0
  544. package/dist/snyk-rest-v1.d.ts +28 -0
  545. package/dist/snyk-rest-v1.d.ts.map +1 -0
  546. package/dist/snyk-rest-v1.js +132 -0
  547. package/dist/snyk-rest-v1.js.map +1 -0
  548. package/dist/snyk-token-origin.d.ts +4 -0
  549. package/dist/snyk-token-origin.d.ts.map +1 -0
  550. package/dist/snyk-token-origin.js +82 -0
  551. package/dist/snyk-token-origin.js.map +1 -0
  552. package/dist/sonar-collector.d.ts +16 -0
  553. package/dist/sonar-collector.d.ts.map +1 -0
  554. package/dist/sonar-collector.js +380 -0
  555. package/dist/sonar-collector.js.map +1 -0
  556. package/dist/sonar-findings.d.ts +49 -0
  557. package/dist/sonar-findings.d.ts.map +1 -0
  558. package/dist/sonar-findings.js +288 -0
  559. package/dist/sonar-findings.js.map +1 -0
  560. package/dist/sonar-import.d.ts +111 -0
  561. package/dist/sonar-import.d.ts.map +1 -0
  562. package/dist/sonar-import.js +277 -0
  563. package/dist/sonar-import.js.map +1 -0
  564. package/dist/suggest-owners.d.ts.map +1 -1
  565. package/dist/suggest-owners.js +2 -1
  566. package/dist/suggest-owners.js.map +1 -1
  567. package/dist/target-drift.d.ts +9 -0
  568. package/dist/target-drift.d.ts.map +1 -0
  569. package/dist/target-drift.js +27 -0
  570. package/dist/target-drift.js.map +1 -0
  571. package/dist/targets.d.ts +5 -0
  572. package/dist/targets.d.ts.map +1 -1
  573. package/dist/targets.js +73 -31
  574. package/dist/targets.js.map +1 -1
  575. package/dist/tenable-findings.d.ts +9 -0
  576. package/dist/tenable-findings.d.ts.map +1 -0
  577. package/dist/tenable-findings.js +122 -0
  578. package/dist/tenable-findings.js.map +1 -0
  579. package/dist/terminal-columns.d.ts +4 -0
  580. package/dist/terminal-columns.d.ts.map +1 -0
  581. package/dist/terminal-columns.js +19 -0
  582. package/dist/terminal-columns.js.map +1 -0
  583. package/dist/terminal-stream.d.ts +13 -0
  584. package/dist/terminal-stream.d.ts.map +1 -0
  585. package/dist/terminal-stream.js +35 -0
  586. package/dist/terminal-stream.js.map +1 -0
  587. package/dist/trivy-findings.d.ts +19 -0
  588. package/dist/trivy-findings.d.ts.map +1 -0
  589. package/dist/trivy-findings.js +435 -0
  590. package/dist/trivy-findings.js.map +1 -0
  591. package/dist/trivy-import.d.ts +19 -0
  592. package/dist/trivy-import.d.ts.map +1 -0
  593. package/dist/trivy-import.js +151 -0
  594. package/dist/trivy-import.js.map +1 -0
  595. package/dist/validation-records.d.ts +0 -3
  596. package/dist/validation-records.d.ts.map +1 -1
  597. package/dist/validation-records.js +1 -17
  598. package/dist/validation-records.js.map +1 -1
  599. package/dist/veracode-findings.d.ts +9 -0
  600. package/dist/veracode-findings.d.ts.map +1 -0
  601. package/dist/veracode-findings.js +409 -0
  602. package/dist/veracode-findings.js.map +1 -0
  603. package/dist/vertex-pricing.d.ts +8 -0
  604. package/dist/vertex-pricing.d.ts.map +1 -0
  605. package/dist/vertex-pricing.js +20 -0
  606. package/dist/vertex-pricing.js.map +1 -0
  607. package/dist/windows-path.d.ts +1 -0
  608. package/dist/windows-path.d.ts.map +1 -1
  609. package/dist/windows-path.js +27 -1
  610. package/dist/windows-path.js.map +1 -1
  611. package/dist/wiz-csv.d.ts +2 -2
  612. package/dist/wiz-csv.d.ts.map +1 -1
  613. package/dist/wiz-csv.js +1 -3
  614. package/dist/wiz-csv.js.map +1 -1
  615. package/dist/wiz-findings.d.ts +14 -2
  616. package/dist/wiz-findings.d.ts.map +1 -1
  617. package/dist/wiz-findings.js +143 -50
  618. package/dist/wiz-findings.js.map +1 -1
  619. package/docs/classify-severity-records.md +28 -13
  620. package/docs/cli.md +623 -843
  621. package/docs/dedupe-records.md +54 -24
  622. package/docs/findings-service.md +87 -47
  623. package/docs/hosted-remediation.md +14 -7
  624. package/docs/hosted-scans.md +64 -41
  625. package/docs/telemetry.md +236 -0
  626. package/docs/validate-records.md +78 -44
  627. package/package.json +19 -17
  628. package/schemas/external-findings.schema.json +14 -1
  629. package/schemas/hosted-scan-v2.fixture.json +16 -1
  630. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  631. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  632. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  633. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  634. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  635. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  636. package/_bundled_plugin/scripts/validate_tracking_source.py +0 -82
  637. package/_bundled_plugin/scripts/workbench_local_dedupe.py +0 -136
  638. package/dist/deduplication/records-protocol.d.ts +0 -4
  639. package/dist/deduplication/records-protocol.d.ts.map +0 -1
  640. package/dist/deduplication/records-protocol.js +0 -49
  641. package/dist/deduplication/records-protocol.js.map +0 -1
  642. package/dist/external-imports-feature.d.ts +0 -6
  643. package/dist/external-imports-feature.d.ts.map +0 -1
  644. package/dist/external-imports-feature.js +0 -51
  645. package/dist/external-imports-feature.js.map +0 -1
  646. package/dist/finding-normalization.d.ts +0 -5
  647. package/dist/finding-normalization.d.ts.map +0 -1
  648. package/dist/finding-normalization.js +0 -120
  649. package/dist/finding-normalization.js.map +0 -1
@@ -0,0 +1,1051 @@
1
+ import { validateExternalEvidence, } from "./external-import-contract.js";
2
+ import { snapshotSourceRepositories, } from "./external-findings.js";
3
+ import { SNYK_REST_ISSUES_FORMAT, encodeSnykV1File, isSnykRestFormat, SNYK_REST_ISSUES_V1, originalSnykEvidence, readSnykRestDocument, } from "./snyk-rest-v1.js";
4
+ import { snykRepositoryUrls } from "./snyk-findings.js";
5
+ import { isGitHubCloudHost } from "./git-remote.js";
6
+ import { gitPathToHttpPath, ambiguousGitIpHost, gitServiceHostname, gitTransportBytes, hostedRepositoryMatches, hostedRepositoryUrlKey, isPublicGitHost, normalizeHostedGitRepositoryUrl, } from "./hosted-git-repository.js";
7
+ import { hostedNumberToken, parseHostedScannerJson, stringifyHostedEvidence, hostedScannerHttp, hostedRepositoryUrl, } from "./hosted-scanner-http.js";
8
+ import { isRecord } from "./record.js";
9
+ import { legacyDecimalInteger } from "./hosted-scanner-v1.js";
10
+ import { isSafeNonNegativeInteger } from "./value.js";
11
+ import { checkSnykTokenOrigin, snykApiToken } from "./snyk-token-origin.js";
12
+ import { regexes } from "zod/v4/core";
13
+ import { array, normalizeRecords, record as scannerRecord, hostedRepositoryPath, repositoryFilePath, requiredText, scannerSeverity, stableId, strings, text, } from "./scanner-import.js";
14
+ export { SNYK_REST_ISSUES_FORMAT, isSnykRestFormat } from "./snyk-rest-v1.js";
15
+ const issueTimestamp = new RegExp(regexes.datetime({ offset: true }).source, "i");
16
+ export const snykRestApiVersion = "2026-03-25";
17
+ const formatVersion = {
18
+ format: SNYK_REST_ISSUES_FORMAT,
19
+ apiVersion: snykRestApiVersion,
20
+ };
21
+ const defaultOrigin = "https://api.snyk.io";
22
+ const origins = new Set([
23
+ defaultOrigin,
24
+ "https://api.us.snyk.io",
25
+ "https://api.eu.snyk.io",
26
+ "https://api.au.snyk.io",
27
+ ]);
28
+ // Some project origins name a provider, while app integrations identify a deployment.
29
+ const githubDeployments = ["github-cloud", "github-server"];
30
+ const scmOrigins = new Map([
31
+ ["azure-repos", ["azure-repos"]],
32
+ ["bitbucket-cloud", ["bitbucket-cloud"]],
33
+ ["bitbucket-connect-app", ["bitbucket-cloud"]],
34
+ ["bitbucket-server", ["bitbucket-server"]],
35
+ ["github", githubDeployments],
36
+ ["github-app", githubDeployments],
37
+ ["github-cloud-app", ["github-cloud"]],
38
+ ["github-enterprise", githubDeployments],
39
+ ["github-server-app", ["github-server"]],
40
+ ["gitlab", ["gitlab"]],
41
+ ]);
42
+ function concreteDeployment(deployments) {
43
+ return deployments?.length === 1 ? deployments[0] : undefined;
44
+ }
45
+ const openSourceProjects = new Set([
46
+ "cargo",
47
+ "cocoapods",
48
+ "composer",
49
+ "conan",
50
+ "cpp",
51
+ "golang",
52
+ "golangdep",
53
+ "gomodules",
54
+ "govendor",
55
+ "gradle",
56
+ "hex",
57
+ "maven",
58
+ "npm",
59
+ "nuget",
60
+ "paket",
61
+ "pip",
62
+ "pipenv",
63
+ "pnpm",
64
+ "poetry",
65
+ "pub",
66
+ "rubygems",
67
+ "sbt",
68
+ "swift",
69
+ "unmanaged",
70
+ "uv",
71
+ "yarn",
72
+ "yarn-workspace",
73
+ ]);
74
+ const issueTypes = {
75
+ "open-source": "package_vulnerability",
76
+ code: "code",
77
+ };
78
+ function isUuid(value) {
79
+ return (typeof value === "string" &&
80
+ /^[\da-f]{8}(?:-[\da-f]{4}){3}-[\da-f]{12}$/iu.test(value));
81
+ }
82
+ function uuid(value, label) {
83
+ if (!isUuid(value))
84
+ throw new Error(`${label} must be a UUID.`);
85
+ return value.toLowerCase();
86
+ }
87
+ function scope(input, origin, product = input["product"]) {
88
+ const apiOrigin = requiredText(origin, "Snyk API origin").replace(/\/$/u, "");
89
+ if (!origins.has(apiOrigin))
90
+ throw new Error("Select a documented Snyk regional HTTPS API origin.");
91
+ if (product !== "open-source" && product !== "code")
92
+ throw new Error("Snyk product must be open-source or code.");
93
+ return {
94
+ apiOrigin,
95
+ product,
96
+ sourceRepositoryUrl: hostedRepositoryUrl(input["sourceRepositoryUrl"], "Snyk source repository URL"),
97
+ organizationId: uuid(input["organizationId"], "Snyk organization ID"),
98
+ projectId: uuid(input["projectId"], "Snyk project ID"),
99
+ };
100
+ }
101
+ function endpoint(selected, route) {
102
+ const url = new URL(`/rest/orgs/${selected.organizationId}/${route}`, selected.apiOrigin);
103
+ url.searchParams.set("version", snykRestApiVersion);
104
+ return url;
105
+ }
106
+ function issuesEndpoint(selected) {
107
+ const url = endpoint(selected, "issues");
108
+ url.searchParams.set("scan_item.type", "project");
109
+ url.searchParams.set("scan_item.id", selected.projectId);
110
+ url.searchParams.set("type", issueTypes[selected.product]);
111
+ url.searchParams.set("status", "open,resolved");
112
+ url.searchParams.set("limit", "100");
113
+ if (selected.product === "code")
114
+ url.searchParams.set("include_code_flows", "true");
115
+ return url;
116
+ }
117
+ function jsonApi(input, label) {
118
+ const document = record(input, label);
119
+ if ("errors" in document)
120
+ throw new Error(`${label}: JSON:API errors: ${JSON.stringify(document["errors"])}`);
121
+ return document;
122
+ }
123
+ function resourceIdentifier(resource, type) {
124
+ if (resource["type"] !== type)
125
+ throw new Error(`Expected a Snyk ${type} resource.`);
126
+ return resource["id"];
127
+ }
128
+ function resourceId(resource, type) {
129
+ return uuid(resourceIdentifier(resource, type), `Snyk ${type} ID`);
130
+ }
131
+ function relationship(relationships, name) {
132
+ return record(record(relationships[name], `Snyk ${name} relationship`)["data"], `Snyk ${name} linkage`);
133
+ }
134
+ function checkOrganization(relationships, selected, project = false) {
135
+ const org = relationship(relationships, "organization");
136
+ if ((org["type"] !== "organization" && !(project && org["type"] === "org")) ||
137
+ uuid(org["id"], "Snyk organization relationship ID") !==
138
+ selected.organizationId)
139
+ throw new Error("Snyk resource does not belong to the selected organization.");
140
+ }
141
+ function scmUrl(binding, remote) {
142
+ try {
143
+ const hostname = new URL(binding.url).hostname;
144
+ if (hostname === "dev.azure.com") {
145
+ const uri = /^(?:ssh|git\+ssh|ssh\+git):\/\/git@([^/:]+)(?::22)?\/(v3\/.+)$/u.exec(remote);
146
+ const address = uri ?? /^git@([^/:]+):(v3\/.+)$/u.exec(remote);
147
+ if (address && address[1].toLowerCase() === "ssh.dev.azure.com") {
148
+ // Azure clone paths may already contain URL escapes in the upload-pack path.
149
+ const path = gitPathToHttpPath(gitTransportBytes(address[2], uri === null)).replace(/%25(?=[\da-f]{2})/giu, "%");
150
+ const parts = /^v3\/([^/]+)\/([^/]+)\/([^/]+)$/u.exec(path);
151
+ if (parts)
152
+ return hostedRepositoryUrl(`https://dev.azure.com/${parts[1]}/${parts[2]}/_git/${parts[3]}`, "Snyk target URL");
153
+ }
154
+ }
155
+ const url = normalizeHostedGitRepositoryUrl(remote, binding.url, binding.platform === "github" || binding.gitlab === true);
156
+ return hostedRepositoryUrl(url, "Snyk target URL");
157
+ }
158
+ catch {
159
+ return undefined;
160
+ }
161
+ }
162
+ export function snykRestRepositoryMatches(binding, remote) {
163
+ const candidate = scmUrl(binding, remote);
164
+ if (!candidate ||
165
+ ambiguousGitIpHost(candidate) ||
166
+ ambiguousGitIpHost(binding.url))
167
+ return false;
168
+ const key = (url) => hostedRepositoryUrlKey(url, binding.platform === "github", binding.gitlab);
169
+ return key(binding.url) === key(candidate);
170
+ }
171
+ /** Git's HTTP checkout may use credentials or spell out the default port. */
172
+ export function snykRestCheckoutMatches(binding, remote) {
173
+ const url = /^https?:\/\//iu.test(remote) ? remote : scmUrl(binding, remote);
174
+ return url !== undefined && hostedRepositoryMatches(binding, url);
175
+ }
176
+ function reportedScm(url, origin) {
177
+ const host = gitServiceHostname(new URL(url).hostname);
178
+ const publicGitHub = isGitHubCloudHost(host);
179
+ const custom = !isPublicGitHost(host) &&
180
+ host !== "dev.azure.com" &&
181
+ !/^[a-z\d-]+\.visualstudio\.com$/u.test(host);
182
+ const enterprise = (custom || publicGitHub) &&
183
+ (origin === "github-enterprise" || origin === "github-server-app");
184
+ const gitlab = origin === "gitlab" && (custom || host === "gitlab.com");
185
+ const github = origin.startsWith("github") && (custom || publicGitHub);
186
+ return { custom, publicGitHub, enterprise, gitlab, github };
187
+ }
188
+ function trustedScmBinding(url, references, allowGitHub, allowGitLab) {
189
+ for (const hint of references) {
190
+ const github = allowGitHub && hint.platform === "github";
191
+ const gitlab = allowGitLab && hint.platform === "gitlab";
192
+ if (github || gitlab) {
193
+ const candidate = {
194
+ url,
195
+ platform: github ? "github" : undefined,
196
+ gitlab,
197
+ };
198
+ if (snykRestRepositoryMatches(candidate, hint.url))
199
+ return candidate;
200
+ }
201
+ }
202
+ return { url };
203
+ }
204
+ class SnykTargetRepositoryMismatch extends Error {
205
+ }
206
+ function checkRemote(remote, selected, origin, references) {
207
+ if (remote === null || remote === "")
208
+ return;
209
+ const url = requiredText(remote, "Snyk target URL");
210
+ // Snyk monitor can render a local path and a Git server as the same HTTP target.
211
+ if (origin === "cli" &&
212
+ selected.product === "open-source" &&
213
+ /^http:\/\//iu.test(url))
214
+ throw new Error("Snyk CLI HTTP target URL cannot verify a repository. Set an explicit HTTPS URL with snyk monitor --remote-repo-url.");
215
+ const { custom, publicGitHub, enterprise, gitlab, github } = reportedScm(selected.sourceRepositoryUrl, origin);
216
+ const platformNeutral = !scmOrigins.has(origin);
217
+ const binding = custom && (platformNeutral || references.length > 0)
218
+ ? trustedScmBinding(selected.sourceRepositoryUrl, references, platformNeutral || github, platformNeutral || gitlab)
219
+ : {
220
+ url: selected.sourceRepositoryUrl,
221
+ platform: publicGitHub || enterprise ? "github" : undefined,
222
+ gitlab,
223
+ };
224
+ if (!snykRestRepositoryMatches(binding, url))
225
+ throw new SnykTargetRepositoryMismatch("Snyk target URL does not match the selected source repository URL.");
226
+ return {
227
+ github,
228
+ enterprise,
229
+ gitlab,
230
+ // Recheck the exact target with the caller's platform mapping at import time.
231
+ nativeUrl: url,
232
+ };
233
+ }
234
+ function projectProduct(manager) {
235
+ if (manager === "sast")
236
+ return "code";
237
+ if (typeof manager === "string" && openSourceProjects.has(manager))
238
+ return "open-source";
239
+ }
240
+ function projectContext(project, selected) {
241
+ if (resourceId(project, "project") !== selected.projectId)
242
+ throw new Error("Snyk returned a different project from the selected project.");
243
+ const attributes = record(project["attributes"], "Snyk project attributes");
244
+ const manager = requiredText(attributes["type"], "Snyk project type");
245
+ const origin = requiredText(attributes["origin"], "Snyk project origin");
246
+ const scm = scmOrigins.has(origin);
247
+ if ((!scm && origin !== "cli" && origin !== "api") ||
248
+ projectProduct(manager) !== selected.product)
249
+ throw new Error(`Snyk project type ${manager} from ${origin} is not a supported ${selected.product} project.`);
250
+ const context = {
251
+ manager,
252
+ scm,
253
+ origin,
254
+ targetFile: scm ? attributes["target_file"] : null,
255
+ };
256
+ const relationships = project["relationships"] === undefined
257
+ ? undefined
258
+ : record(project["relationships"], "Snyk project relationships");
259
+ if (relationships)
260
+ checkOrganization(relationships, selected, true);
261
+ const target = relationships?.["target"];
262
+ const linkage = target === undefined
263
+ ? null
264
+ : record(target, "Snyk target relationship")["data"];
265
+ if (linkage === null)
266
+ return {
267
+ ...context,
268
+ targetId: undefined,
269
+ lookupTargetId: undefined,
270
+ expandedUrl: undefined,
271
+ integration: undefined,
272
+ };
273
+ const link = record(linkage, "Snyk target linkage");
274
+ const expandedUrl = link["attributes"] === undefined
275
+ ? undefined
276
+ : record(link["attributes"], "Snyk expanded target attributes")["url"];
277
+ const targetId = resourceId(link, "target");
278
+ const integration = checkTargetRelationships(link, selected, origin);
279
+ return {
280
+ ...context,
281
+ targetId,
282
+ integration,
283
+ lookupTargetId: expandedUrl == null || expandedUrl === "" ? targetId : undefined,
284
+ expandedUrl,
285
+ };
286
+ }
287
+ function checkTarget(value, selected, { expandedUrl, lookupTargetId, origin, integration, }, references = []) {
288
+ if (lookupTargetId === undefined) {
289
+ if (value !== null)
290
+ throw new Error("Unexpected separate Snyk target without a project target lookup.");
291
+ return {
292
+ ...checkRemote(expandedUrl ?? null, selected, origin, references),
293
+ integrationId: integration?.id,
294
+ deployment: integration?.deployment,
295
+ };
296
+ }
297
+ const target = record(value, "Snyk target resource");
298
+ if (resourceId(target, "target") !== lookupTargetId)
299
+ throw new Error("Snyk target does not match the selected project's target.");
300
+ const fetched = checkTargetRelationships(target, selected, origin, integration?.deployment);
301
+ if (integration?.id && fetched?.id && integration.id !== fetched.id)
302
+ throw new Error("The fetched Snyk target names a different integration than the project's target.");
303
+ const remote = checkRemote(record(target["attributes"], "Snyk target attributes")["url"], selected, origin, references);
304
+ return {
305
+ ...remote,
306
+ integrationId: fetched?.id ?? integration?.id,
307
+ deployment: fetched?.deployment ?? integration?.deployment,
308
+ };
309
+ }
310
+ function checkTargetRelationships(target, selected, origin, linkedDeployment) {
311
+ if (target["relationships"] === undefined)
312
+ return;
313
+ const relationships = record(target["relationships"], "Snyk target relationships");
314
+ if (relationships["organization"] !== undefined)
315
+ checkOrganization(relationships, selected, true);
316
+ if (relationships["integration"] === undefined)
317
+ return;
318
+ const linkage = record(relationships["integration"], "Snyk integration relationship")["data"];
319
+ if (linkage === null && !scmOrigins.has(origin))
320
+ return;
321
+ const integration = record(linkage, "Snyk integration linkage");
322
+ if (integration["type"] !== "integration")
323
+ throw new Error("Expected a Snyk integration resource.");
324
+ const attributes = integration["attributes"];
325
+ // The Targets API allows a null ID on an expanded integration.
326
+ const id = attributes === undefined || integration["id"] !== null
327
+ ? uuid(integration["id"], "Snyk integration ID")
328
+ : undefined;
329
+ if (attributes === undefined)
330
+ return { id };
331
+ const type = requiredText(record(attributes, "Snyk integration attributes")["integration_type"], "Snyk integration type");
332
+ const deployments = scmOrigins.get(origin);
333
+ const claimed = scmOrigins.get(type);
334
+ if (deployments &&
335
+ !claimed?.some((candidate) => deployments.includes(candidate) &&
336
+ (linkedDeployment === undefined || linkedDeployment === candidate))) {
337
+ const source = linkedDeployment ? "target linkage" : `${origin} origin`;
338
+ throw new Error(`Snyk target integration ${type} must be a supported SCM integration for the project's ${source}.`);
339
+ }
340
+ return {
341
+ id,
342
+ deployment: deployments && concreteDeployment(claimed),
343
+ };
344
+ }
345
+ function pageLinkCursor(link, endpoint, label, cursorName = "starting_after") {
346
+ const href = requiredText(isRecord(link) ? link["href"] : link, label);
347
+ const url = new URL(href.startsWith("/orgs/") ? `/rest${href}` : href, endpoint);
348
+ if (url.origin !== endpoint.origin ||
349
+ url.pathname !== endpoint.pathname ||
350
+ url.username ||
351
+ url.password ||
352
+ url.hash)
353
+ throw new Error(`${label} leaves the selected Issues endpoint.`);
354
+ for (const [key, value] of url.searchParams) {
355
+ if (url.searchParams.getAll(key).length !== 1 ||
356
+ (key !== cursorName && endpoint.searchParams.get(key) !== value))
357
+ throw new Error(`${label} changes the selected Issues query.`);
358
+ }
359
+ return url.searchParams.get(cursorName);
360
+ }
361
+ function nextCursor(value, endpoint, current) {
362
+ if (value === undefined)
363
+ return null;
364
+ const links = record(value, "Snyk issue page links");
365
+ if (links["prev"] != null) {
366
+ if (current === null)
367
+ throw new Error("The first Snyk issue page has a previous page link.");
368
+ pageLinkCursor(links["prev"], endpoint, "Snyk previous page link", "ending_before");
369
+ }
370
+ if (links["self"] != null &&
371
+ pageLinkCursor(links["self"], endpoint, "Snyk self page link") !== current)
372
+ throw new Error("Snyk self page link does not match the requested cursor.");
373
+ if (links["next"] == null)
374
+ return null;
375
+ return requiredText(pageLinkCursor(links["next"], endpoint, "Snyk next page link"), "Snyk next page starting_after cursor");
376
+ }
377
+ function scopedIssue(value, selected) {
378
+ const issue = record(value, "Snyk issue");
379
+ const relationships = record(issue["relationships"], "Snyk issue relationships");
380
+ checkOrganization(relationships, selected);
381
+ const item = relationship(relationships, "scan_item");
382
+ if (resourceId(item, "project") !== selected.projectId)
383
+ throw new Error("Snyk issue does not belong to the selected project.");
384
+ return issue;
385
+ }
386
+ function selectedIssueAttributes(issue, selected) {
387
+ const attributes = record(issue["attributes"], "Snyk issue attributes");
388
+ if (attributes["type"] !== issueTypes[selected.product])
389
+ throw new Error(`Only ${issueTypes[selected.product]} issues are supported for this Snyk project selection.`);
390
+ return attributes;
391
+ }
392
+ function selectedIssue(issue, selected) {
393
+ return {
394
+ id: resourceId(issue, "issue"),
395
+ attributes: selectedIssueAttributes(issue, selected),
396
+ };
397
+ }
398
+ function snykIssueId(attributes, source, retainedKey) {
399
+ const key = requiredText(attributes["key"], "Snyk issue key");
400
+ if (retainedKey !== undefined && retainedKey !== key)
401
+ throw new Error("The retained Snyk issue key does not match the original issue.");
402
+ return stableId("snyk-rest", [
403
+ source.apiOrigin,
404
+ source.organizationId,
405
+ source.projectId,
406
+ source.product,
407
+ key,
408
+ ]);
409
+ }
410
+ function verifySnykFindingId(finding, attributes, source) {
411
+ const id = snykIssueId(attributes, source, finding.evidence.source_data?.["snykRestIssueKey"]);
412
+ if (id !== finding.source_finding_id)
413
+ throw new Error("The normalized finding ID does not match the original Snyk issue key and project.");
414
+ }
415
+ function issuePage(response, selected, url, seen, current) {
416
+ const issues = array(response["data"], "Snyk issue page data").map((value) => scopedIssue(value, selected));
417
+ const next = nextCursor(response["links"], url, current);
418
+ if (next !== null) {
419
+ if (seen.has(next))
420
+ throw new Error("Snyk Issues pagination repeated a cursor.");
421
+ seen.add(next);
422
+ }
423
+ return { issues, next };
424
+ }
425
+ export async function collectSnykIssues(options, dependencies = {}) {
426
+ const environment = dependencies.environment ?? process.env;
427
+ const { getJson, signal } = hostedScannerHttp(dependencies, options.signal);
428
+ const { product = "open-source" } = options;
429
+ const selected = scope(options, options.apiOrigin ?? defaultOrigin, product);
430
+ const references = snapshotSourceRepositories(dependencies.sourceRepositories);
431
+ const token = requiredText(snykApiToken(environment, selected.apiOrigin, options.token), "Snyk API token (SNYK_TOKEN)");
432
+ checkSnykTokenOrigin(token, selected.apiOrigin);
433
+ const get = async (url, label) => jsonApi(await getJson(url, `token ${token}`), label);
434
+ const getResource = async (url, kind) => record((await get(url, `Snyk ${kind} response`))["data"], `Snyk ${kind} resource`);
435
+ const projectUrl = endpoint(selected, `projects/${selected.projectId}`);
436
+ projectUrl.searchParams.set("expand", "target");
437
+ const project = await getResource(projectUrl, "project");
438
+ const context = projectContext(project, selected);
439
+ const target = context.lookupTargetId === undefined
440
+ ? null
441
+ : await getResource(endpoint(selected, `targets/${context.lookupTargetId}`), "target");
442
+ checkTarget(target, selected, context, references);
443
+ const pages = [];
444
+ const base = issuesEndpoint(selected);
445
+ const cursors = new Set();
446
+ const issueIds = new Set();
447
+ let startingAfter = null;
448
+ do {
449
+ const url = new URL(base);
450
+ if (startingAfter !== null)
451
+ url.searchParams.set("starting_after", startingAfter);
452
+ const response = await get(url, "Snyk issue page");
453
+ const page = issuePage(response, selected, base, cursors, startingAfter);
454
+ for (const issue of page.issues) {
455
+ const { id } = selectedIssue(issue, selected);
456
+ if (issueIds.has(id))
457
+ throw new Error("Snyk Issues returned overlapping issue IDs. Retry the collection.");
458
+ issueIds.add(id);
459
+ }
460
+ pages.push({
461
+ startingAfter,
462
+ responseJson: JSON.stringify(response),
463
+ });
464
+ startingAfter = page.next;
465
+ } while (startingAfter !== null);
466
+ signal?.throwIfAborted();
467
+ return {
468
+ ...formatVersion,
469
+ ...selected,
470
+ complete: true,
471
+ projectJson: JSON.stringify(project),
472
+ targetJson: JSON.stringify(target),
473
+ pages,
474
+ };
475
+ }
476
+ function savedContext(document, references) {
477
+ if (document["format"] !== SNYK_REST_ISSUES_FORMAT ||
478
+ document["apiVersion"] !== snykRestApiVersion)
479
+ throw new Error(`Expected ${SNYK_REST_ISSUES_FORMAT} for API version ${snykRestApiVersion}.`);
480
+ const selected = scope(document, document["apiOrigin"]);
481
+ const project = record(parseHostedScannerJson(requiredText(document["projectJson"], "Snyk original project")), "Snyk project resource");
482
+ const context = projectContext(project, selected);
483
+ const target = parseHostedScannerJson(requiredText(document["targetJson"], "Snyk original target"));
484
+ const remote = checkTarget(target, selected, context, references);
485
+ const nativeUrl = remote.nativeUrl;
486
+ const gitlab = remote.gitlab ??
487
+ reportedScm(selected.sourceRepositoryUrl, context.origin).gitlab;
488
+ const github = remote.github ?? context.origin.startsWith("github");
489
+ const platform = remote.enterprise ? "github" : context.scm && !github ? "other" : undefined;
490
+ return {
491
+ project,
492
+ target,
493
+ source: {
494
+ ...formatVersion,
495
+ ...selected,
496
+ projectJson: stringifyHostedEvidence(project),
497
+ targetJson: stringifyHostedEvidence(target),
498
+ },
499
+ context,
500
+ repository: {
501
+ scope: selected,
502
+ scm: context.scm,
503
+ targetId: context.targetId,
504
+ integrationId: remote.integrationId,
505
+ deployment: remote.deployment,
506
+ url: selected.sourceRepositoryUrl,
507
+ platform,
508
+ ...(gitlab && { gitlab: true }),
509
+ ...(nativeUrl && { nativeUrl }),
510
+ },
511
+ };
512
+ }
513
+ const snykRestId = /^snyk-rest:[0-9a-f]{64}$/u;
514
+ function originalSnykResource(data, field, json) {
515
+ const value = data[field + (json ? "Json" : "")];
516
+ if (!json)
517
+ return isRecord(value) ? value : undefined;
518
+ if (typeof value !== "string")
519
+ return;
520
+ try {
521
+ const parsed = parseHostedScannerJson(value);
522
+ return isRecord(parsed) ? parsed : undefined;
523
+ }
524
+ catch {
525
+ return;
526
+ }
527
+ }
528
+ /** A Snyk Issues resource carries its own product and links to both its organization and project. */
529
+ function linkedSnykResources(data, json, hosted) {
530
+ const issue = originalSnykResource(data, "issue", json);
531
+ if (issue?.["type"] === "issue" && (hosted || isUuid(issue["id"]))) {
532
+ const attributes = issue["attributes"];
533
+ const links = issue["relationships"];
534
+ const relationType = (name) => {
535
+ const link = isRecord(links) ? links[name] : undefined;
536
+ const resource = isRecord(link) ? link["data"] : undefined;
537
+ return isRecord(resource) && (hosted || isUuid(resource["id"]))
538
+ ? resource["type"]
539
+ : undefined;
540
+ };
541
+ if (isRecord(attributes) &&
542
+ "key" in attributes &&
543
+ (hosted ||
544
+ attributes["type"] === issueTypes.code ||
545
+ attributes["type"] === issueTypes["open-source"]) &&
546
+ relationType("organization") === "organization" &&
547
+ relationType("scan_item") === "project")
548
+ return { issue };
549
+ }
550
+ if (!hosted && data["apiVersion"] !== snykRestApiVersion)
551
+ return;
552
+ const project = originalSnykResource(data, "project", json);
553
+ const attributes = project?.["attributes"];
554
+ const nativeProject = project?.["type"] === "project" &&
555
+ isUuid(project["id"]) &&
556
+ isRecord(attributes) &&
557
+ "origin" in attributes &&
558
+ "type" in attributes;
559
+ if (!nativeProject) {
560
+ const target = originalSnykResource(data, "target", json);
561
+ if (target?.["type"] !== "target" || !isUuid(target["id"]))
562
+ return;
563
+ }
564
+ if (!hosted) {
565
+ // A project or target alone only identifies an unmarked row with the complete monitor scope.
566
+ try {
567
+ scope(data, data["apiOrigin"]);
568
+ }
569
+ catch {
570
+ return;
571
+ }
572
+ }
573
+ return {};
574
+ }
575
+ function retainedRelationship(resource, name) {
576
+ const links = resource?.["relationships"];
577
+ const relation = isRecord(links) ? links[name] : undefined;
578
+ const data = isRecord(relation) ? relation["data"] : undefined;
579
+ if (data === null)
580
+ return null;
581
+ if (isRecord(data) &&
582
+ (data["type"] === name ||
583
+ (name === "organization" && data["type"] === "org")))
584
+ return data;
585
+ }
586
+ /** Read only vendor-typed claims still present in an already-approved request. */
587
+ function retainedSnykAssets(data) {
588
+ const assets = [];
589
+ const id = (resource) => {
590
+ const value = resource?.["id"];
591
+ return isUuid(value) ? value.toLowerCase() : undefined;
592
+ };
593
+ for (const json of [false, true]) {
594
+ const project = originalSnykResource(data, "project", json);
595
+ let expanded;
596
+ if (project?.["type"] === "project") {
597
+ const attributes = project["attributes"];
598
+ const origin = isRecord(attributes) ? attributes["origin"] : undefined;
599
+ expanded = retainedRelationship(project, "target");
600
+ assets.push({
601
+ projectId: id(project),
602
+ product: projectProduct(isRecord(attributes) ? attributes["type"] : undefined),
603
+ targetId: expanded === null ? null : undefined,
604
+ organizationId: id(retainedRelationship(project, "organization")),
605
+ origin: typeof origin === "string" && scmOrigins.has(origin)
606
+ ? origin
607
+ : undefined,
608
+ });
609
+ }
610
+ for (const target of [
611
+ expanded,
612
+ originalSnykResource(data, "target", json),
613
+ ]) {
614
+ if (target?.["type"] !== "target")
615
+ continue;
616
+ const attributes = target["attributes"];
617
+ const url = isRecord(attributes) ? attributes["url"] : undefined;
618
+ const integration = retainedRelationship(target, "integration");
619
+ const integrationAttributes = integration?.["attributes"];
620
+ const type = isRecord(integrationAttributes)
621
+ ? integrationAttributes["integration_type"]
622
+ : undefined;
623
+ assets.push({
624
+ url: typeof url === "string" ? url : undefined,
625
+ targetId: id(target),
626
+ integrationId: id(integration),
627
+ deployment: typeof type === "string"
628
+ ? concreteDeployment(scmOrigins.get(type))
629
+ : undefined,
630
+ organizationId: id(retainedRelationship(target, "organization")),
631
+ });
632
+ }
633
+ }
634
+ return assets;
635
+ }
636
+ function snykRowEvidence(finding, hostedReport = false) {
637
+ const retained = finding.evidence.source_data;
638
+ const marked = snykRestId.test(finding.source_finding_id) ||
639
+ isSnykRestFormat(retained?.["format"]);
640
+ const hosted = hostedReport || marked;
641
+ const v1 = retained && linkedSnykResources(retained, false, hosted);
642
+ const v2 = retained && linkedSnykResources(retained, true, hosted);
643
+ if (v1 || v2 || marked)
644
+ return { v1, v2 };
645
+ }
646
+ export function isSnykRestFinding(finding) {
647
+ return snykRowEvidence(finding) !== undefined;
648
+ }
649
+ /** Recover the native occurrence from an earlier normalized submission with a caller-assigned ID. */
650
+ export function snykRestCheckpointFindingId(finding, references) {
651
+ const data = finding.evidence.source_data;
652
+ const evidence = snykRowEvidence(finding);
653
+ if (!data || (!evidence?.v1?.issue && !evidence?.v2?.issue))
654
+ return;
655
+ const format = evidence.v2?.issue
656
+ ? SNYK_REST_ISSUES_FORMAT
657
+ : SNYK_REST_ISSUES_V1;
658
+ const document = readSnykRestDocument({
659
+ ...data,
660
+ format: data["format"] ?? format,
661
+ });
662
+ const { source } = savedContext(document, references);
663
+ const issue = parseHostedScannerJson(requiredText(document["issueJson"], "Snyk original issue"));
664
+ const { attributes } = selectedIssue(scopedIssue(issue, source), source);
665
+ return snykIssueId(attributes, source, data["snykRestIssueKey"]);
666
+ }
667
+ export function snykRestFindingRepository(finding, references = []) {
668
+ return bindSnykFinding(finding, references, snykRowEvidence(finding));
669
+ }
670
+ function bindSnykFinding(finding, references, originals, report, retain) {
671
+ const retained = record(finding.evidence.source_data, "Original Snyk REST issue evidence");
672
+ const format = retained["format"] === undefined
673
+ ? originals?.v1
674
+ ? SNYK_REST_ISSUES_V1
675
+ : SNYK_REST_ISSUES_FORMAT
676
+ : retained["format"];
677
+ if (isSnykRestFormat(format) &&
678
+ (format === SNYK_REST_ISSUES_V1 ? originals?.v2 : originals?.v1))
679
+ throw new Error("A normalized Snyk row cannot claim both v1 and v2 native representations.");
680
+ const document = readSnykRestDocument({ ...retained, format }, report?.fields);
681
+ const issue = (format === SNYK_REST_ISSUES_FORMAT ? originals?.v2?.issue : undefined) ??
682
+ parseHostedScannerJson(requiredText(document["issueJson"], "Snyk original issue"));
683
+ // A selected issue can retain any of its original monitor fields. Fill only those it omitted.
684
+ let projected = false;
685
+ if (report && (originals?.v1?.issue || originals?.v2?.issue)) {
686
+ for (const [field, value] of Object.entries(report.fields)) {
687
+ if (document[field] !== undefined)
688
+ continue;
689
+ document[field] = value;
690
+ projected = true;
691
+ }
692
+ }
693
+ // Complete v2 selections normally carry the same verified monitor and native assets on every row.
694
+ const asset = format === SNYK_REST_ISSUES_FORMAT &&
695
+ report &&
696
+ Object.entries(report.fields).every(([key, value]) => document[key] === value)
697
+ ? report.asset
698
+ : savedContext(document, references);
699
+ const { source, repository } = asset;
700
+ const { id: issueId, attributes } = selectedIssue(scopedIssue(issue, source), source);
701
+ verifySnykFindingId(finding, attributes, source);
702
+ projectSnykIssue(attributes, asset, { ...retained, format }, "local");
703
+ if (retain && format === SNYK_REST_ISSUES_V1) {
704
+ // The legacy witness stores the original decimal token, including its spelling.
705
+ const context = projected
706
+ ? encodeSnykV1File({
707
+ ...repository.scope,
708
+ apiVersion: source.apiVersion,
709
+ format,
710
+ project: asset.project,
711
+ target: asset.target,
712
+ })
713
+ : { format };
714
+ retain(finding, {
715
+ ...retained,
716
+ ...context,
717
+ ...(isRecord(context["numericFields"]) && {
718
+ numericFields: {
719
+ ...context["numericFields"],
720
+ ...(isRecord(retained["numericFields"]) && retained["numericFields"]),
721
+ },
722
+ }),
723
+ });
724
+ }
725
+ else if (retain && format === SNYK_REST_ISSUES_FORMAT) {
726
+ retain(finding, {
727
+ ...retained,
728
+ ...(projected && source),
729
+ format,
730
+ snykRestIssueKey: attributes["key"],
731
+ projectJson: source.projectJson,
732
+ targetJson: source.targetJson,
733
+ issueJson: stringifyHostedEvidence(issue),
734
+ });
735
+ }
736
+ return { ...repository, issueId };
737
+ }
738
+ function readIssues(document, selected) {
739
+ if (document["complete"] !== true)
740
+ throw new Error("Expected a complete Snyk REST Issues export.");
741
+ const url = issuesEndpoint(selected);
742
+ const pages = array(document["pages"], "Snyk issue pages");
743
+ if (!pages.length)
744
+ throw new Error("Incomplete Snyk collection: no issue page.");
745
+ const seen = new Set();
746
+ let cursor = null;
747
+ const issues = pages.flatMap((value, index) => {
748
+ const page = record(value, "Snyk saved page");
749
+ if ((index !== 0 && cursor === null) || page["startingAfter"] !== cursor)
750
+ throw new Error("Incomplete or inconsistent Snyk issue page sequence.");
751
+ const parsed = issuePage(jsonApi(parseHostedScannerJson(requiredText(page["responseJson"], "Snyk original issue page")), "Snyk issue page"), selected, url, seen, cursor);
752
+ cursor = parsed.next;
753
+ return parsed.issues;
754
+ });
755
+ if (cursor !== null)
756
+ throw new Error("Incomplete Snyk collection: missing next issue page.");
757
+ return issues;
758
+ }
759
+ // Lossless parsing preserves JSON numbers in raw token objects.
760
+ function record(value, label) {
761
+ return scannerRecord(hostedNumberToken(value) ?? value, label);
762
+ }
763
+ function records(parent, field) {
764
+ const label = `Snyk ${field}`;
765
+ return array(parent[field] ?? [], label).map((entry) => record(entry, label));
766
+ }
767
+ function problemIds(entries, type) {
768
+ const ids = new Set();
769
+ for (const entry of entries) {
770
+ if (type === undefined || entry["type"] === type)
771
+ ids.add(requiredText(entry["id"], "Snyk problem or class ID"));
772
+ }
773
+ return [...ids];
774
+ }
775
+ function findingFilePath(value, v2) {
776
+ const path = hostedRepositoryPath(value);
777
+ if (v2 && (path?.endsWith("/.") || !repositoryFilePath(path)))
778
+ return null;
779
+ return path;
780
+ }
781
+ function packageEvidence(coordinates, { manager, targetFile }, v2) {
782
+ const manifest = findingFilePath(targetFile, v2);
783
+ const packages = [];
784
+ for (const coordinate of coordinates) {
785
+ const fixed = records(coordinate, "remedies").flatMap((remedy) => {
786
+ const meta = remedy["meta"];
787
+ return isRecord(meta) &&
788
+ meta["schema_version"] === "package_vulnerability/v0"
789
+ ? strings(record(meta["data"], "Snyk package remedy data")["fixed_in"])
790
+ : [];
791
+ });
792
+ for (const representation of records(coordinate, "representations")) {
793
+ if (!("dependency" in representation))
794
+ continue;
795
+ const dependency = record(representation["dependency"], "Snyk dependency");
796
+ packages.push({
797
+ name: requiredText(dependency["package_name"], "Snyk dependency package name"),
798
+ installed_version: requiredText(dependency["package_version"], "Snyk dependency package version"),
799
+ ecosystem: manager,
800
+ manifest_path: manifest,
801
+ fixed_versions: [...new Set(fixed)],
802
+ });
803
+ }
804
+ }
805
+ return packages;
806
+ }
807
+ function codeStartLine(region) {
808
+ const start = isRecord(region) ? region["start"] : undefined;
809
+ const token = isRecord(start) ? hostedNumberToken(start["line"]) : undefined;
810
+ const line = token && Number(legacyDecimalInteger(token));
811
+ return isSafeNonNegativeInteger(line) && line > 0 ? line : null;
812
+ }
813
+ function codeEvidence(coordinates, scm, v2) {
814
+ const locations = [];
815
+ const revisions = new Set();
816
+ for (const coordinate of coordinates) {
817
+ for (const representation of records(coordinate, "representations")) {
818
+ const value = representation["sourceLocation"] ?? representation["source_location"];
819
+ if (value === undefined)
820
+ continue;
821
+ const location = record(value, "Snyk source location");
822
+ revisions.add(text(location["commit_id"]));
823
+ const path = findingFilePath(location["file"], v2);
824
+ if (scm && path)
825
+ locations.push(v2 ? { path, line: codeStartLine(location["region"]) } : { path });
826
+ }
827
+ }
828
+ return {
829
+ locations,
830
+ code_revision: revisions.size === 1 ? ([...revisions][0] ?? null) : null,
831
+ };
832
+ }
833
+ function projectSnykIssue(attributes, { source, context }, sourceData, target) {
834
+ const code = source.product === "code";
835
+ const v2 = sourceData["format"] !== SNYK_REST_ISSUES_V1;
836
+ const status = attributes["status"];
837
+ if ((status !== "open" && status !== "resolved") ||
838
+ typeof attributes["ignored"] !== "boolean")
839
+ throw new Error("Snyk issue must have a source status and an ignored flag.");
840
+ const updatedAt = requiredText(attributes["updated_at"], "Snyk updated_at");
841
+ const updated = Date.parse(updatedAt);
842
+ if (updatedAt.startsWith("0000") ||
843
+ !issueTimestamp.test(updatedAt) ||
844
+ !Number.isFinite(updated) ||
845
+ updated < 0)
846
+ throw new Error("Invalid Snyk issue updated_at.");
847
+ const severity = requiredText(attributes["effective_severity_level"], "Snyk effective severity");
848
+ const problems = records(attributes, "problems");
849
+ const rules = problemIds(problems, "rule");
850
+ const activeCoordinates = records(attributes, "coordinates").filter((coordinate) => status === "open" && coordinate["state"] === "open");
851
+ return validateExternalEvidence({
852
+ title: requiredText(attributes["title"], "Snyk issue title"),
853
+ description: text(attributes["description"]),
854
+ severity: severity === "info" ? "informational" : scannerSeverity(severity),
855
+ advisory_ids: code ? [] : problemIds(problems),
856
+ ...(code
857
+ ? codeEvidence(activeCoordinates, context.scm, v2)
858
+ : {
859
+ packages: packageEvidence(activeCoordinates, context, v2),
860
+ }),
861
+ source_updated_at: Math.floor(updated / 1000),
862
+ source_data: sourceData,
863
+ ...(code && {
864
+ details: {
865
+ kind: "sast",
866
+ repository: { url: source.sourceRepositoryUrl },
867
+ scanner_origin: "Snyk Code",
868
+ source_status: status,
869
+ rule: rules.length === 1 ? { id: rules[0] } : null,
870
+ weakness_ids: problemIds(records(attributes, "classes"), "weakness"),
871
+ },
872
+ }),
873
+ }, target);
874
+ }
875
+ export function normalizeSnykIssues(input, target = "local", references = []) {
876
+ const wire = record(input, "Snyk REST Issues export");
877
+ const document = readSnykRestDocument(wire);
878
+ const asset = savedContext(document, references);
879
+ const { source, repository } = asset;
880
+ const issues = readIssues(document, source);
881
+ const legacy = originalSnykEvidence(wire, source);
882
+ // normalizeRecords identifies every row before projecting any evidence.
883
+ const resourceCounts = new Map();
884
+ const result = normalizeRecords(issues.map((issue, index) => ({ issue, original: legacy?.rows[index] })), ({ issue, original }) => {
885
+ if (resourceCounts.get(resourceId(issue, "issue")) > 1)
886
+ throw new Error("The saved Snyk report contains overlapping issue IDs.");
887
+ const attributes = record(issue["attributes"], "Snyk issue attributes");
888
+ const sourceData = original
889
+ ? structuredClone(original)
890
+ : {
891
+ ...source,
892
+ snykRestIssueKey: attributes["key"],
893
+ issueJson: stringifyHostedEvidence(issue),
894
+ };
895
+ return projectSnykIssue(attributes, asset, sourceData, target);
896
+ }, ({ issue }) => {
897
+ const identifier = resourceIdentifier(issue, "issue");
898
+ const raw = issue["attributes"];
899
+ const product = isRecord(raw) ? raw["type"] : undefined;
900
+ // A missing product cannot establish that this resource belongs to another selection.
901
+ if (isUuid(identifier) &&
902
+ (!text(product) || product === issueTypes[source.product])) {
903
+ const id = identifier.toLowerCase();
904
+ resourceCounts.set(id, (resourceCounts.get(id) ?? 0) + 1);
905
+ }
906
+ return snykIssueId(selectedIssueAttributes(issue, source), source);
907
+ }, target);
908
+ return {
909
+ ...result,
910
+ sourceRepositoryUrl: source.sourceRepositoryUrl,
911
+ ...(repository.platform && {
912
+ sourceRepositoryPlatform: repository.platform,
913
+ }),
914
+ snykRestContext: legacy ? structuredClone(legacy.context) : source,
915
+ };
916
+ }
917
+ /** Reconcile the original records, normalized projections, and reader or destination URLs. */
918
+ export function snykRestImportRepository(input, provider, urls = [], trustedSources = [], retain, allowOpaqueLegacyRows = false, declaredCloudRepository) {
919
+ const project = input.snykRestContext !== undefined
920
+ ? savedContext(readSnykRestDocument(record(input.snykRestContext, "Snyk report context")), trustedSources)
921
+ : undefined;
922
+ const rows = input.findings.map((finding) => ({
923
+ finding,
924
+ originals: snykRowEvidence(finding, project !== undefined),
925
+ }));
926
+ const hosted = project !== undefined || rows.some(({ originals }) => originals);
927
+ if (!hosted && !declaredCloudRepository)
928
+ return;
929
+ const context = project && {
930
+ asset: project,
931
+ fields: {
932
+ ...project.source,
933
+ projectJson: JSON.stringify(project.project),
934
+ targetJson: JSON.stringify(project.target),
935
+ },
936
+ };
937
+ const retainedIssues = [];
938
+ const retainedRows = [];
939
+ const boundRows = hosted
940
+ ? rows.flatMap(({ finding, originals }) => {
941
+ try {
942
+ return [
943
+ bindSnykFinding(finding, trustedSources, originals, context, retain),
944
+ ];
945
+ }
946
+ catch (error) {
947
+ if (!allowOpaqueLegacyRows ||
948
+ error instanceof SnykTargetRepositoryMismatch)
949
+ throw error;
950
+ for (const issue of [originals?.v1?.issue, originals?.v2?.issue])
951
+ if (issue)
952
+ retainedIssues.push({ finding, issue });
953
+ if (originals && finding.evidence.source_data)
954
+ retainedRows.push(finding.evidence.source_data);
955
+ return [];
956
+ }
957
+ })
958
+ : [];
959
+ const selected = project?.repository.scope ?? boundRows[0]?.scope;
960
+ const bindings = project ? [...boundRows, project.repository] : boundRows;
961
+ const repositoryUrl = bindings[0]?.url ?? declaredCloudRepository;
962
+ if (!repositoryUrl)
963
+ return;
964
+ if (provider !== "snyk")
965
+ throw new Error("Use the snyk provider for Snyk REST issues.");
966
+ if (project &&
967
+ boundRows.some((row) => (project.repository.targetId && !row.targetId) ||
968
+ (project.repository.nativeUrl && !row.nativeUrl)))
969
+ throw new Error("The selected Snyk finding is missing the report's native target. Keep its full project or omit the project to use the report context.");
970
+ const retainedAssets = retainedRows.flatMap(retainedSnykAssets);
971
+ const monitorBindings = [...bindings, ...retainedAssets];
972
+ for (const key of ["targetId", "integrationId", "deployment"]) {
973
+ // Sparse targets can contradict a verified SCM deployment but cannot establish one.
974
+ if (key === "deployment" && !bindings.some((binding) => binding.deployment))
975
+ continue;
976
+ const ids = new Set(monitorBindings
977
+ .map((binding) => binding[key])
978
+ .filter((id) => id !== undefined));
979
+ if (ids.size > 1)
980
+ throw new Error("The Snyk project scope names conflicting targets or integrations.");
981
+ }
982
+ const scopes = boundRows.map(({ scope }) => scope);
983
+ const claims = new Set(bindings.map((binding) => binding.url));
984
+ const retainedScms = [];
985
+ for (const { url, origin, product, projectId, organizationId, } of retainedAssets) {
986
+ if (url)
987
+ claims.add(url);
988
+ if (origin)
989
+ retainedScms.push(reportedScm(repositoryUrl, origin));
990
+ if (selected)
991
+ scopes.push({
992
+ ...selected,
993
+ projectId: projectId ?? selected.projectId,
994
+ organizationId: organizationId ?? selected.organizationId,
995
+ product: product ?? selected.product,
996
+ });
997
+ }
998
+ // Already-approved rows can lack the original project while retaining a
999
+ // monitored issue, partial scope, or source URL that contradicts a new claim.
1000
+ if (selected) {
1001
+ for (const { finding, issue } of retainedIssues) {
1002
+ const { attributes } = selectedIssue(scopedIssue(issue, selected), selected);
1003
+ if (snykRestId.test(finding.source_finding_id))
1004
+ verifySnykFindingId(finding, attributes, selected);
1005
+ }
1006
+ }
1007
+ for (const { sourceRepositoryUrl, ...fields } of retainedRows) {
1008
+ if (sourceRepositoryUrl !== undefined)
1009
+ claims.add(requiredText(sourceRepositoryUrl, "Snyk source repository URL"));
1010
+ if (selected) {
1011
+ const supplied = { ...selected, ...fields };
1012
+ scopes.push(scope(supplied, supplied.apiOrigin));
1013
+ }
1014
+ }
1015
+ if (bindings.some((binding) => binding.scm !== bindings[0]?.scm) ||
1016
+ (selected &&
1017
+ scopes.some((scope) => scope.apiOrigin !== selected.apiOrigin ||
1018
+ scope.organizationId !== selected.organizationId ||
1019
+ scope.projectId !== selected.projectId ||
1020
+ scope.product !== selected.product)))
1021
+ throw new Error("The normalized finding does not match the retained Snyk project scope.");
1022
+ for (const binding of bindings)
1023
+ if (binding.nativeUrl)
1024
+ claims.add(binding.nativeUrl);
1025
+ if (input.sourceRepositoryUrl !== undefined)
1026
+ claims.add(input.sourceRepositoryUrl);
1027
+ for (const { evidence } of input.findings) {
1028
+ const typed = evidence.details?.repository?.url;
1029
+ if (typed)
1030
+ claims.add(typed);
1031
+ for (const native of snykRepositoryUrls(evidence.source_data, {
1032
+ normalizeGitRemote: false,
1033
+ }))
1034
+ claims.add(native);
1035
+ }
1036
+ if (new Set(boundRows.map(({ issueId }) => issueId)).size !== boundRows.length)
1037
+ throw new Error("The normalized Snyk selection contains overlapping issue IDs.");
1038
+ for (const url of urls)
1039
+ claims.add(url);
1040
+ // Saved SCM metadata can contradict a caller's mapping but cannot establish one.
1041
+ const source = trustedScmBinding(repositoryUrl, trustedSources, input.sourceRepositoryPlatform !== "other" &&
1042
+ retainedScms.every(({ github }) => github) &&
1043
+ bindings.every((binding) => binding.platform !== "other" && !binding.gitlab), input.sourceRepositoryPlatform !== "github" &&
1044
+ retainedScms.every(({ gitlab }) => gitlab) &&
1045
+ bindings.every((binding) => binding.gitlab || binding.platform === undefined));
1046
+ for (const url of claims)
1047
+ if (!snykRestRepositoryMatches(source, url))
1048
+ throw new Error("The normalized repository does not match the original Snyk project.");
1049
+ return source;
1050
+ }
1051
+ //# sourceMappingURL=snyk-rest-findings.js.map