@openai/codex-security 0.8.3 → 0.10.0

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