blackveil-dns 2.13.0 → 3.100.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 (640) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +237 -62
  3. package/dist/cli.js +1098 -0
  4. package/dist/cli.js.map +1 -0
  5. package/dist/index.js +10011 -2433
  6. package/dist/index.js.map +1 -1
  7. package/dist/stdio.js +33244 -9766
  8. package/dist/stdio.js.map +1 -1
  9. package/package.json +101 -21
  10. package/.claude/settings.json +0 -61
  11. package/.cursorrules +0 -1
  12. package/.devcontainer/Dockerfile +0 -17
  13. package/.devcontainer/devcontainer.json +0 -18
  14. package/.editorconfig +0 -12
  15. package/.gitattributes +0 -24
  16. package/.githooks/blocked-patterns +0 -13
  17. package/.githooks/pre-commit +0 -127
  18. package/.github/CODEOWNERS +0 -11
  19. package/.github/ISSUE_TEMPLATE/bug_report.yml +0 -99
  20. package/.github/ISSUE_TEMPLATE/config.yml +0 -11
  21. package/.github/ISSUE_TEMPLATE/feature_request.yml +0 -51
  22. package/.github/PULL_REQUEST_TEMPLATE.md +0 -30
  23. package/.github/copilot-instructions.md +0 -73
  24. package/.github/dependabot.yml +0 -22
  25. package/.github/instructions/scan-orchestration.instructions.md +0 -56
  26. package/.github/instructions/schemas.instructions.md +0 -52
  27. package/.github/instructions/security.instructions.md +0 -77
  28. package/.github/instructions/tests.instructions.md +0 -31
  29. package/.github/instructions/tools.instructions.md +0 -55
  30. package/.github/workflows/auto-deploy-main.yml.disabled +0 -145
  31. package/.github/workflows/ci-contract.yml +0 -47
  32. package/.github/workflows/ci.yml +0 -53
  33. package/.github/workflows/deploy-hook.yml +0 -113
  34. package/.github/workflows/dns-security.yml +0 -32
  35. package/.github/workflows/publish.yml +0 -275
  36. package/.github/workflows/repo-hygiene.yml +0 -121
  37. package/.github/workflows/security.yml +0 -62
  38. package/.github/workflows/triage-issues.yml +0 -82
  39. package/.gitleaks.toml +0 -190
  40. package/.intent/.gitignore +0 -5
  41. package/.intent/config.json +0 -88
  42. package/.nvmrc +0 -1
  43. package/.phase2-queue/baseline.txt +0 -1
  44. package/.prettierrc +0 -6
  45. package/CHANGELOG.md +0 -793
  46. package/CLAUDE.md +0 -580
  47. package/CODE_OF_CONDUCT.md +0 -133
  48. package/CONTRIBUTING.md +0 -63
  49. package/SECURITY.md +0 -66
  50. package/SUPPORT.md +0 -17
  51. package/assets/brave-score.png +0 -0
  52. package/assets/bv-logo-full.png +0 -0
  53. package/assets/bv-logo-mark.png +0 -0
  54. package/assets/our-listing-final.png +0 -0
  55. package/assets/smithery-listing.png +0 -0
  56. package/assets/smithery-score-2.png +0 -0
  57. package/assets/smithery-score-hover.png +0 -0
  58. package/assets/smithery-score.png +0 -0
  59. package/assets/supabase-score.png +0 -0
  60. package/conductor/index.md +0 -1
  61. package/conductor/registrar-commercial-models.md +0 -64
  62. package/crates/bv-wasm-core/Cargo.lock +0 -177
  63. package/crates/bv-wasm-core/Cargo.toml +0 -12
  64. package/crates/bv-wasm-core/src/compact.rs +0 -60
  65. package/crates/bv-wasm-core/src/lib.rs +0 -116
  66. package/crates/bv-wasm-core/src/permissions.rs +0 -106
  67. package/dist/index.d.ts +0 -500
  68. package/dist/stdio.d.ts +0 -12
  69. package/docs/client-setup.md +0 -587
  70. package/docs/scoring.md +0 -245
  71. package/docs/style-guide.md +0 -69
  72. package/docs/tenant-Capacity-and-Discovery-Design.md +0 -267
  73. package/docs/tenant-Scalable-Architecture-Design.md +0 -639
  74. package/docs/tenant-ops-runbook.md +0 -191
  75. package/docs/troubleshooting.md +0 -392
  76. package/eslint.config.mjs +0 -21
  77. package/examples/slack-discord-webhook/README.md +0 -38
  78. package/examples/slack-discord-webhook/worker.ts +0 -133
  79. package/examples/slack-discord-webhook/wrangler.toml +0 -11
  80. package/extensions/vscode/.vscodeignore +0 -2
  81. package/extensions/vscode/CHANGELOG.md +0 -8
  82. package/extensions/vscode/LICENSE +0 -76
  83. package/extensions/vscode/README.md +0 -105
  84. package/extensions/vscode/icon.png +0 -0
  85. package/extensions/vscode/package.json +0 -49
  86. package/packages/dns-checks/LICENSE +0 -76
  87. package/packages/dns-checks/README.md +0 -61
  88. package/packages/dns-checks/package.json +0 -39
  89. package/packages/dns-checks/src/__tests__/check-utils.test.ts +0 -188
  90. package/packages/dns-checks/src/__tests__/checks/check-dkim.test.ts +0 -54
  91. package/packages/dns-checks/src/__tests__/checks/check-dmarc.test.ts +0 -70
  92. package/packages/dns-checks/src/__tests__/checks/check-dnssec.test.ts +0 -56
  93. package/packages/dns-checks/src/__tests__/checks/check-remaining.test.ts +0 -244
  94. package/packages/dns-checks/src/__tests__/checks/check-spf.test.ts +0 -114
  95. package/packages/dns-checks/src/__tests__/scoring/generic-engine.spec.ts +0 -858
  96. package/packages/dns-checks/src/__tests__/scoring/score-determinism.spec.ts +0 -73
  97. package/packages/dns-checks/src/__tests__/scoring/scoring-config.spec.ts +0 -194
  98. package/packages/dns-checks/src/__tests__/scoring/scoring-engine.spec.ts +0 -137
  99. package/packages/dns-checks/src/__tests__/scoring/scoring-model.spec.ts +0 -46
  100. package/packages/dns-checks/src/__tests__/scoring/scoring-profiles.spec.ts +0 -316
  101. package/packages/dns-checks/src/__tests__/scoring-schemas.test.ts +0 -307
  102. package/packages/dns-checks/src/check-utils.ts +0 -44
  103. package/packages/dns-checks/src/checks/caa-analysis.ts +0 -126
  104. package/packages/dns-checks/src/checks/check-bimi.ts +0 -305
  105. package/packages/dns-checks/src/checks/check-caa.ts +0 -63
  106. package/packages/dns-checks/src/checks/check-dane-https.ts +0 -88
  107. package/packages/dns-checks/src/checks/check-dane.ts +0 -110
  108. package/packages/dns-checks/src/checks/check-dkim.ts +0 -261
  109. package/packages/dns-checks/src/checks/check-dmarc.ts +0 -370
  110. package/packages/dns-checks/src/checks/check-dnssec.ts +0 -131
  111. package/packages/dns-checks/src/checks/check-http-security.ts +0 -187
  112. package/packages/dns-checks/src/checks/check-mta-sts.ts +0 -195
  113. package/packages/dns-checks/src/checks/check-mx.ts +0 -130
  114. package/packages/dns-checks/src/checks/check-ns.ts +0 -133
  115. package/packages/dns-checks/src/checks/check-spf.ts +0 -271
  116. package/packages/dns-checks/src/checks/check-ssl.ts +0 -95
  117. package/packages/dns-checks/src/checks/check-subdomailing.ts +0 -77
  118. package/packages/dns-checks/src/checks/check-subdomain-takeover.ts +0 -45
  119. package/packages/dns-checks/src/checks/check-svcb-https.ts +0 -246
  120. package/packages/dns-checks/src/checks/check-tlsrpt.ts +0 -112
  121. package/packages/dns-checks/src/checks/dane-analysis.ts +0 -203
  122. package/packages/dns-checks/src/checks/dkim-analysis.ts +0 -102
  123. package/packages/dns-checks/src/checks/dmarc-utils.ts +0 -126
  124. package/packages/dns-checks/src/checks/dnssec-analysis.ts +0 -237
  125. package/packages/dns-checks/src/checks/http-security-analysis.ts +0 -230
  126. package/packages/dns-checks/src/checks/index.ts +0 -36
  127. package/packages/dns-checks/src/checks/mta-sts-analysis.ts +0 -259
  128. package/packages/dns-checks/src/checks/mx-analysis.ts +0 -63
  129. package/packages/dns-checks/src/checks/ns-analysis.ts +0 -171
  130. package/packages/dns-checks/src/checks/spf-analysis.ts +0 -211
  131. package/packages/dns-checks/src/checks/spf-trust-surface.ts +0 -141
  132. package/packages/dns-checks/src/checks/ssl-analysis.ts +0 -111
  133. package/packages/dns-checks/src/checks/subdomailing-analysis.ts +0 -262
  134. package/packages/dns-checks/src/checks/subdomain-takeover-analysis.ts +0 -217
  135. package/packages/dns-checks/src/index.ts +0 -73
  136. package/packages/dns-checks/src/schemas/scoring.ts +0 -52
  137. package/packages/dns-checks/src/scoring/config.ts +0 -346
  138. package/packages/dns-checks/src/scoring/engine.ts +0 -293
  139. package/packages/dns-checks/src/scoring/generic.ts +0 -317
  140. package/packages/dns-checks/src/scoring/index.ts +0 -56
  141. package/packages/dns-checks/src/scoring/model.ts +0 -133
  142. package/packages/dns-checks/src/scoring/profiles.ts +0 -332
  143. package/packages/dns-checks/src/types.ts +0 -172
  144. package/packages/dns-checks/tsconfig.json +0 -15
  145. package/packages/dns-checks/tsup.config.ts +0 -14
  146. package/packages/dns-checks/vitest.config.ts +0 -8
  147. package/public/index.html +0 -45
  148. package/scripts/benchmark-doh.mjs +0 -216
  149. package/scripts/benchmark.sh +0 -151
  150. package/scripts/chaos/chaos-run.py +0 -393
  151. package/scripts/chaos/chaos-test-clients.py +0 -884
  152. package/scripts/chaos/chaos-test-msp.py +0 -745
  153. package/scripts/chaos/chaos-test-v205.py +0 -829
  154. package/scripts/chaos/chaos-test-v210.py +0 -2038
  155. package/scripts/chaos/chaos-test-wasm.py +0 -65
  156. package/scripts/chaos/chaos-test.py +0 -952
  157. package/scripts/chaos/score-stability-test.py +0 -298
  158. package/scripts/chaos/tenant-chaos-v3.py +0 -119
  159. package/scripts/context-usage-test.py +0 -281
  160. package/scripts/conversation-sim.py +0 -421
  161. package/scripts/deploy-private.mjs +0 -22
  162. package/scripts/generate-report.sh +0 -42
  163. package/scripts/inject-private-config.cjs +0 -41
  164. package/scripts/maintenance/dispatch_all.sh +0 -26
  165. package/scripts/maintenance/fix_wrangler.py +0 -32
  166. package/scripts/maintenance/run_rescan_prod.py +0 -34
  167. package/scripts/maintenance/run_sync_batches.py +0 -56
  168. package/scripts/maintenance/run_sync_test.py +0 -27
  169. package/scripts/maintenance/run_test_msg.py +0 -22
  170. package/scripts/maintenance/test_analytics_stream.js +0 -3
  171. package/scripts/maintenance/update_wrangler.cjs +0 -22
  172. package/scripts/maintenance/update_wrangler.js +0 -22
  173. package/scripts/maintenance/validate-internal-deps.mjs +0 -49
  174. package/scripts/oauth/README.md +0 -101
  175. package/scripts/oauth/prod-probe.py +0 -329
  176. package/scripts/output-usage-test.py +0 -221
  177. package/scripts/pressure-chaos-test.mjs +0 -481
  178. package/scripts/tenants/add_consumer.js +0 -17
  179. package/scripts/tenants/calibrate.mjs +0 -206
  180. package/scripts/tenants/provision-tenant.mjs +0 -578
  181. package/scripts/tenants/register_domains.py +0 -27
  182. package/scripts/tenants/sql/register_0.sql +0 -1
  183. package/scripts/tenants/sql/register_1.sql +0 -1
  184. package/scripts/tenants/sql/register_2.sql +0 -1
  185. package/scripts/tenants/sql/register_3.sql +0 -1
  186. package/scripts/tenants/sql/register_4.sql +0 -1
  187. package/scripts/tenants/sql/register_5.sql +0 -1
  188. package/scripts/tenants/sql/register_6.sql +0 -1
  189. package/scripts/tenants/sql/register_7.sql +0 -1
  190. package/scripts/tenants/sql/register_8.sql +0 -1
  191. package/scripts/tenants/sql/register_9.sql +0 -1
  192. package/scripts/tranco-deep-2026-04-05_12h42m.json +0 -47002
  193. package/scripts/tranco-deep-scan.mjs +0 -307
  194. package/scripts/tranco-scan-2026-04-05_12h14m.json +0 -6002
  195. package/scripts/tranco-scan-2026-04-06_02h49m.json +0 -602
  196. package/scripts/tranco-scan-2026-04-07_13h30m.json +0 -1202
  197. package/scripts/tranco-scan.mjs +0 -253
  198. package/scripts/trial-key.mjs +0 -346
  199. package/server.json +0 -35
  200. package/smithery.yaml +0 -13
  201. package/src/handlers/prompts.ts +0 -279
  202. package/src/handlers/resources.ts +0 -283
  203. package/src/handlers/tool-args.ts +0 -150
  204. package/src/handlers/tool-execution.ts +0 -107
  205. package/src/handlers/tool-formatters.ts +0 -94
  206. package/src/handlers/tool-schemas.ts +0 -9
  207. package/src/handlers/tools.ts +0 -529
  208. package/src/index.ts +0 -794
  209. package/src/internal.ts +0 -666
  210. package/src/lib/adaptive-weights.ts +0 -246
  211. package/src/lib/alerting.ts +0 -103
  212. package/src/lib/analytics-engine.ts +0 -33
  213. package/src/lib/analytics-queries.ts +0 -399
  214. package/src/lib/analytics.ts +0 -310
  215. package/src/lib/audit.ts +0 -56
  216. package/src/lib/auth.ts +0 -52
  217. package/src/lib/badge.ts +0 -94
  218. package/src/lib/cache.ts +0 -310
  219. package/src/lib/category-interactions.ts +0 -154
  220. package/src/lib/circuit-breaker.ts +0 -101
  221. package/src/lib/client-detection.ts +0 -31
  222. package/src/lib/config.ts +0 -370
  223. package/src/lib/context-profiles.ts +0 -16
  224. package/src/lib/db/schema.ts +0 -77
  225. package/src/lib/dns-multi-resolver.ts +0 -218
  226. package/src/lib/dns-query-adapter.ts +0 -18
  227. package/src/lib/dns-records.ts +0 -233
  228. package/src/lib/dns-transport.ts +0 -237
  229. package/src/lib/dns-types.ts +0 -91
  230. package/src/lib/dns.ts +0 -27
  231. package/src/lib/fuzzing-counter.ts +0 -79
  232. package/src/lib/fuzzing-detector.ts +0 -115
  233. package/src/lib/hooks/analytics-stream.ts +0 -28
  234. package/src/lib/ip-utils.ts +0 -70
  235. package/src/lib/json-rpc.ts +0 -67
  236. package/src/lib/legacy-sse.ts +0 -185
  237. package/src/lib/log.ts +0 -113
  238. package/src/lib/output-sanitize.ts +0 -40
  239. package/src/lib/profile-accumulator.ts +0 -830
  240. package/src/lib/provider-signature-source.ts +0 -191
  241. package/src/lib/provider-signatures.ts +0 -134
  242. package/src/lib/public-suffix.ts +0 -131
  243. package/src/lib/quota-coordinator.ts +0 -446
  244. package/src/lib/rate-limiter-memory.ts +0 -163
  245. package/src/lib/rate-limiter.ts +0 -528
  246. package/src/lib/safe-fetch.ts +0 -42
  247. package/src/lib/sanitize.ts +0 -245
  248. package/src/lib/scoring-config.ts +0 -36
  249. package/src/lib/scoring-engine.ts +0 -15
  250. package/src/lib/scoring-model.ts +0 -26
  251. package/src/lib/scoring.ts +0 -58
  252. package/src/lib/semaphore.ts +0 -101
  253. package/src/lib/server-version.ts +0 -4
  254. package/src/lib/session-memory.ts +0 -177
  255. package/src/lib/session.ts +0 -295
  256. package/src/lib/sse.ts +0 -174
  257. package/src/lib/tier-auth.ts +0 -237
  258. package/src/lib/trial-keys.ts +0 -217
  259. package/src/mcp/dispatch.ts +0 -222
  260. package/src/mcp/execute.ts +0 -680
  261. package/src/mcp/request.ts +0 -152
  262. package/src/mcp/route-gates.ts +0 -119
  263. package/src/oauth/authorize.ts +0 -268
  264. package/src/oauth/discovery.ts +0 -48
  265. package/src/oauth/entitlements.ts +0 -77
  266. package/src/oauth/jwt.ts +0 -142
  267. package/src/oauth/register.ts +0 -72
  268. package/src/oauth/storage.ts +0 -66
  269. package/src/oauth/token.ts +0 -171
  270. package/src/package.ts +0 -59
  271. package/src/scheduled.ts +0 -310
  272. package/src/schemas/alerting.ts +0 -49
  273. package/src/schemas/audit.ts +0 -39
  274. package/src/schemas/auth.ts +0 -27
  275. package/src/schemas/dns.ts +0 -49
  276. package/src/schemas/internal.ts +0 -26
  277. package/src/schemas/json-rpc.ts +0 -20
  278. package/src/schemas/oauth.ts +0 -120
  279. package/src/schemas/primitives.ts +0 -58
  280. package/src/schemas/session.ts +0 -9
  281. package/src/schemas/tenant-alerts.ts +0 -118
  282. package/src/schemas/tenant-internal.ts +0 -143
  283. package/src/schemas/tool-args.ts +0 -270
  284. package/src/schemas/tool-definitions.ts +0 -452
  285. package/src/stdio.ts +0 -183
  286. package/src/tenants/adapters/tenant-d1.ts +0 -51
  287. package/src/tenants/adapters/tenant-kv.ts +0 -64
  288. package/src/tenants/adapters/tenant-r2.ts +0 -69
  289. package/src/tenants/alerts/diff.ts +0 -201
  290. package/src/tenants/alerts/index.ts +0 -12
  291. package/src/tenants/alerts/webhook.ts +0 -141
  292. package/src/tenants/analytics-stream.ts +0 -26
  293. package/src/tenants/audit.ts +0 -123
  294. package/src/tenants/db/drizzle.registry.config.ts +0 -18
  295. package/src/tenants/db/drizzle.tenant.config.ts +0 -21
  296. package/src/tenants/db/index.ts +0 -19
  297. package/src/tenants/db/migrations/registry/0000_minor_skaar.sql +0 -46
  298. package/src/tenants/db/migrations/registry/0001_wet_warhawk.sql +0 -23
  299. package/src/tenants/db/migrations/registry/0002_big_speedball.sql +0 -17
  300. package/src/tenants/db/migrations/registry/meta/0000_snapshot.json +0 -330
  301. package/src/tenants/db/migrations/registry/meta/0001_snapshot.json +0 -498
  302. package/src/tenants/db/migrations/registry/meta/0002_snapshot.json +0 -624
  303. package/src/tenants/db/migrations/registry/meta/_journal.json +0 -27
  304. package/src/tenants/db/migrations/tenant/0000_clear_clea.sql +0 -54
  305. package/src/tenants/db/migrations/tenant/0001_clumsy_master_mold.sql +0 -3
  306. package/src/tenants/db/migrations/tenant/meta/0000_snapshot.json +0 -375
  307. package/src/tenants/db/migrations/tenant/meta/0001_snapshot.json +0 -397
  308. package/src/tenants/db/migrations/tenant/meta/_journal.json +0 -20
  309. package/src/tenants/db/schema/registry.ts +0 -154
  310. package/src/tenants/db/schema/tenant.ts +0 -106
  311. package/src/tenants/discovery/dkim-key-reuse.ts +0 -250
  312. package/src/tenants/discovery/dmarc-rua-miner.ts +0 -186
  313. package/src/tenants/discovery/index.ts +0 -31
  314. package/src/tenants/discovery/ns-correlator.ts +0 -155
  315. package/src/tenants/discovery/san-correlator.ts +0 -212
  316. package/src/tenants/dns-fingerprint.ts +0 -313
  317. package/src/tenants/monitoring/index.ts +0 -17
  318. package/src/tenants/per-tenant-rate-limit.ts +0 -148
  319. package/src/tenants/queue-consumer.ts +0 -375
  320. package/src/tenants/routes.ts +0 -1014
  321. package/src/tenants/scheduled-handlers.ts +0 -550
  322. package/src/tenants/tenant-resolver.ts +0 -143
  323. package/src/tools/analyze-drift.ts +0 -235
  324. package/src/tools/assess-spoofability.ts +0 -224
  325. package/src/tools/batch-scan.ts +0 -163
  326. package/src/tools/caa-analysis.ts +0 -72
  327. package/src/tools/check-bimi.ts +0 -30
  328. package/src/tools/check-caa.ts +0 -23
  329. package/src/tools/check-cymru-asn.ts +0 -175
  330. package/src/tools/check-dane-https.ts +0 -29
  331. package/src/tools/check-dane.ts +0 -29
  332. package/src/tools/check-dbl.ts +0 -251
  333. package/src/tools/check-dkim.ts +0 -98
  334. package/src/tools/check-dmarc.ts +0 -25
  335. package/src/tools/check-dnssec-chain.ts +0 -284
  336. package/src/tools/check-dnssec.ts +0 -171
  337. package/src/tools/check-fast-flux.ts +0 -168
  338. package/src/tools/check-http-security.ts +0 -339
  339. package/src/tools/check-lookalikes.ts +0 -379
  340. package/src/tools/check-mta-sts.ts +0 -24
  341. package/src/tools/check-mx-reputation.ts +0 -174
  342. package/src/tools/check-mx.ts +0 -117
  343. package/src/tools/check-ns.ts +0 -30
  344. package/src/tools/check-nsec-walkability.ts +0 -173
  345. package/src/tools/check-rbl.ts +0 -235
  346. package/src/tools/check-rdap-lookup.ts +0 -333
  347. package/src/tools/check-resolver-consistency.ts +0 -151
  348. package/src/tools/check-shadow-domains.ts +0 -517
  349. package/src/tools/check-spf.ts +0 -48
  350. package/src/tools/check-srv.ts +0 -75
  351. package/src/tools/check-ssl.ts +0 -18
  352. package/src/tools/check-subdomailing.ts +0 -22
  353. package/src/tools/check-subdomain-takeover.ts +0 -24
  354. package/src/tools/check-svcb-https.ts +0 -22
  355. package/src/tools/check-tlsrpt.ts +0 -23
  356. package/src/tools/check-txt-hygiene.ts +0 -364
  357. package/src/tools/check-zone-hygiene.ts +0 -154
  358. package/src/tools/compare-baseline.ts +0 -199
  359. package/src/tools/compare-domains.ts +0 -182
  360. package/src/tools/dane-analysis.ts +0 -172
  361. package/src/tools/discover-brand-domains.ts +0 -377
  362. package/src/tools/discover-subdomains.ts +0 -487
  363. package/src/tools/dkim-analysis.ts +0 -86
  364. package/src/tools/dmarc-utils.ts +0 -114
  365. package/src/tools/dnssec-analysis.ts +0 -123
  366. package/src/tools/explain-finding-data.ts +0 -766
  367. package/src/tools/explain-finding.ts +0 -181
  368. package/src/tools/generate-fix-plan.ts +0 -196
  369. package/src/tools/generate-records.ts +0 -412
  370. package/src/tools/generate-rollout-plan.ts +0 -342
  371. package/src/tools/http-security-analysis.ts +0 -192
  372. package/src/tools/intelligence.ts +0 -331
  373. package/src/tools/lookalike-analysis.ts +0 -176
  374. package/src/tools/map-compliance.ts +0 -243
  375. package/src/tools/map-supply-chain.ts +0 -458
  376. package/src/tools/mta-sts-analysis.ts +0 -250
  377. package/src/tools/mx-analysis.ts +0 -55
  378. package/src/tools/mx-reputation-analysis.ts +0 -205
  379. package/src/tools/ns-analysis.ts +0 -162
  380. package/src/tools/provider-guides.ts +0 -404
  381. package/src/tools/resolve-spf-chain.ts +0 -254
  382. package/src/tools/scan/format-report.ts +0 -248
  383. package/src/tools/scan/maturity-staging.ts +0 -166
  384. package/src/tools/scan/post-processing.ts +0 -270
  385. package/src/tools/scan-domain.ts +0 -664
  386. package/src/tools/simulate-attack-paths.ts +0 -513
  387. package/src/tools/spf-analysis.ts +0 -203
  388. package/src/tools/spf-trust-surface.ts +0 -138
  389. package/src/tools/srv-analysis.ts +0 -118
  390. package/src/tools/ssl-analysis.ts +0 -102
  391. package/src/tools/subdomain-takeover-analysis.ts +0 -202
  392. package/src/tools/txt-hygiene-analysis.ts +0 -87
  393. package/src/tools/validate-fix.ts +0 -219
  394. package/src/tools/zone-hygiene-analysis.ts +0 -217
  395. package/src/types/env.d.ts +0 -6
  396. package/test/.!52131!.DS_Store +0 -0
  397. package/test/adaptive-weights.spec.ts +0 -359
  398. package/test/alerting.spec.ts +0 -91
  399. package/test/analytics-ip-hash.spec.ts +0 -90
  400. package/test/analytics-queries.spec.ts +0 -197
  401. package/test/analytics-stream.spec.ts +0 -32
  402. package/test/analytics.spec.ts +0 -205
  403. package/test/analyze-drift.spec.ts +0 -82
  404. package/test/assess-spoofability.spec.ts +0 -186
  405. package/test/audit.spec.ts +0 -250
  406. package/test/audits/fuzzing-config.audit.test.ts +0 -76
  407. package/test/audits/no-tracked-secrets.audit.test.ts +0 -166
  408. package/test/audits/oauth-readiness-gate.audit.test.ts +0 -83
  409. package/test/audits/tenant-capacity-readiness.audit.test.ts +0 -92
  410. package/test/audits/tenant-scale-quota.audit.test.ts +0 -35
  411. package/test/audits/tool-quota-coverage.audit.test.ts +0 -41
  412. package/test/audits/workflow-secret-check.audit.test.ts +0 -79
  413. package/test/auth.spec.ts +0 -94
  414. package/test/badge.spec.ts +0 -112
  415. package/test/batch-scan.spec.ts +0 -141
  416. package/test/caa-analysis.spec.ts +0 -24
  417. package/test/cache.spec.ts +0 -421
  418. package/test/category-interactions.spec.ts +0 -172
  419. package/test/chaos/fuzzing-degradation.chaos.test.ts +0 -50
  420. package/test/chaos/invariants.spec.ts +0 -181
  421. package/test/chaos/oauth-misconfiguration.chaos.test.ts +0 -132
  422. package/test/chaos/tenant-cron.chaos.test.ts +0 -276
  423. package/test/chaos/tenant-queue.chaos.test.ts +0 -272
  424. package/test/check-bimi.spec.ts +0 -160
  425. package/test/check-caa.spec.ts +0 -144
  426. package/test/check-cymru-asn.spec.ts +0 -239
  427. package/test/check-dane-https.spec.ts +0 -203
  428. package/test/check-dane.spec.ts +0 -234
  429. package/test/check-dbl.spec.ts +0 -214
  430. package/test/check-dkim.spec.ts +0 -413
  431. package/test/check-dmarc.spec.ts +0 -377
  432. package/test/check-dnssec-catch.spec.ts +0 -48
  433. package/test/check-dnssec-chain.spec.ts +0 -196
  434. package/test/check-dnssec.spec.ts +0 -271
  435. package/test/check-fast-flux.spec.ts +0 -201
  436. package/test/check-http-security.spec.ts +0 -420
  437. package/test/check-lookalikes.spec.ts +0 -860
  438. package/test/check-mta-sts.spec.ts +0 -196
  439. package/test/check-mx-reputation.spec.ts +0 -395
  440. package/test/check-mx.spec.ts +0 -183
  441. package/test/check-ns.spec.ts +0 -172
  442. package/test/check-nsec-walkability.spec.ts +0 -107
  443. package/test/check-rbl.spec.ts +0 -283
  444. package/test/check-rdap-lookup.spec.ts +0 -235
  445. package/test/check-resolver-consistency.spec.ts +0 -117
  446. package/test/check-shadow-domains.spec.ts +0 -883
  447. package/test/check-spf.spec.ts +0 -399
  448. package/test/check-srv.spec.ts +0 -160
  449. package/test/check-ssl.spec.ts +0 -192
  450. package/test/check-subdomailing.spec.ts +0 -308
  451. package/test/check-subdomain-takeover.spec.ts +0 -366
  452. package/test/check-svcb-https.spec.ts +0 -247
  453. package/test/check-tlsrpt.spec.ts +0 -70
  454. package/test/check-txt-hygiene.spec.ts +0 -414
  455. package/test/check-zone-hygiene.spec.ts +0 -234
  456. package/test/circuit-breaker.spec.ts +0 -171
  457. package/test/client-detection.spec.ts +0 -73
  458. package/test/compare-baseline.spec.ts +0 -221
  459. package/test/compare-domains.spec.ts +0 -46
  460. package/test/config.spec.ts +0 -216
  461. package/test/context-profiles.spec.ts +0 -215
  462. package/test/contracts/fuzzing-alert.contract.test.ts +0 -58
  463. package/test/contracts/oauth-tier.contract.test.ts +0 -53
  464. package/test/contracts/tenant-alerts.contract.test.ts +0 -79
  465. package/test/dane-analysis.spec.ts +0 -165
  466. package/test/data/batch_test.json +0 -1
  467. package/test/data/domains.json +0 -26976
  468. package/test/data/rescan_batch.json +0 -1
  469. package/test/data/sync_test.json +0 -1
  470. package/test/data/temp_sync_batch.json +0 -1
  471. package/test/discover-brand-domains.spec.ts +0 -215
  472. package/test/discover-subdomains.spec.ts +0 -382
  473. package/test/dispatch-reinitialize.spec.ts +0 -101
  474. package/test/dkim-analysis.spec.ts +0 -48
  475. package/test/dmarc-utils.spec.ts +0 -27
  476. package/test/dns-multi-resolver.spec.ts +0 -109
  477. package/test/dns-records-new.spec.ts +0 -244
  478. package/test/dns-records.spec.ts +0 -20
  479. package/test/dns-semaphore.spec.ts +0 -184
  480. package/test/dns-transport.spec.ts +0 -669
  481. package/test/dns.spec.ts +0 -118
  482. package/test/dnssec-analysis.spec.ts +0 -48
  483. package/test/env.d.ts +0 -3
  484. package/test/explain-finding.spec.ts +0 -578
  485. package/test/format-report.spec.ts +0 -273
  486. package/test/format-scan-report.spec.ts +0 -160
  487. package/test/freemium-limits.spec.ts +0 -102
  488. package/test/freemium-model.spec.ts +0 -143
  489. package/test/fuzzing-alert-dedup.test.ts +0 -82
  490. package/test/fuzzing-counter.integration.test.ts +0 -75
  491. package/test/fuzzing-detector.test.ts +0 -87
  492. package/test/fuzzing-e2e.integration.test.ts +0 -114
  493. package/test/generate-discovery-report.spec.ts +0 -337
  494. package/test/generate-fix-plan.spec.ts +0 -219
  495. package/test/generate-records.spec.ts +0 -241
  496. package/test/generate-rollout-plan.spec.ts +0 -261
  497. package/test/handlers-prompts.spec.ts +0 -96
  498. package/test/handlers-resources.spec.ts +0 -85
  499. package/test/handlers-tools.spec.ts +0 -1042
  500. package/test/helpers/dns-mock.ts +0 -155
  501. package/test/http-security-analysis.spec.ts +0 -242
  502. package/test/index.spec.ts +0 -1721
  503. package/test/intelligence.spec.ts +0 -217
  504. package/test/internal-guard.spec.ts +0 -34
  505. package/test/internal-tools-analytics-auth.test.ts +0 -102
  506. package/test/internal-tools-call-body-limit.test.ts +0 -45
  507. package/test/internal-trial-keys-auth.spec.ts +0 -99
  508. package/test/internal.spec.ts +0 -411
  509. package/test/ip-utils.spec.ts +0 -127
  510. package/test/kv-fallback-logging.spec.ts +0 -220
  511. package/test/legacy-session-validation.spec.ts +0 -113
  512. package/test/legacy-sse.spec.ts +0 -140
  513. package/test/log-cf-ip-redaction.test.ts +0 -30
  514. package/test/log.spec.ts +0 -189
  515. package/test/lookalike-analysis.spec.ts +0 -67
  516. package/test/map-compliance.spec.ts +0 -284
  517. package/test/map-supply-chain.spec.ts +0 -584
  518. package/test/maturity-staging.spec.ts +0 -312
  519. package/test/mcp-dispatch.spec.ts +0 -123
  520. package/test/mcp-execute.spec.ts +0 -1259
  521. package/test/mcp-request.spec.ts +0 -115
  522. package/test/mcp-route-gates.spec.ts +0 -88
  523. package/test/mta-sts-analysis.spec.ts +0 -74
  524. package/test/mx-analysis.spec.ts +0 -32
  525. package/test/mx-reputation-analysis.spec.ts +0 -116
  526. package/test/ns-analysis.spec.ts +0 -49
  527. package/test/oauth/authorize-get.spec.ts +0 -170
  528. package/test/oauth/authorize-post.spec.ts +0 -286
  529. package/test/oauth/authorize-zod-leak.test.ts +0 -40
  530. package/test/oauth/bearer-jwt.spec.ts +0 -152
  531. package/test/oauth/discovery.spec.ts +0 -51
  532. package/test/oauth/e2e.spec.ts +0 -141
  533. package/test/oauth/entitlements.spec.ts +0 -110
  534. package/test/oauth/internal-grant.spec.ts +0 -183
  535. package/test/oauth/jwt.spec.ts +0 -91
  536. package/test/oauth/pkce.spec.ts +0 -57
  537. package/test/oauth/register.spec.ts +0 -79
  538. package/test/oauth/storage.spec.ts +0 -74
  539. package/test/oauth/token.spec.ts +0 -270
  540. package/test/output-sanitize.spec.ts +0 -450
  541. package/test/package-api.spec.ts +0 -35
  542. package/test/profile-accumulator.spec.ts +0 -567
  543. package/test/provider-guides.spec.ts +0 -74
  544. package/test/provider-signature-source.spec.ts +0 -68
  545. package/test/provider-signatures.spec.ts +0 -112
  546. package/test/public-suffix.spec.ts +0 -197
  547. package/test/queue-consumer-analytics.spec.ts +0 -65
  548. package/test/quota-coordinator.spec.ts +0 -74
  549. package/test/rate-limit-chaos.spec.ts +0 -529
  550. package/test/rate-limiter-kv-reset.test.ts +0 -62
  551. package/test/rate-limiter-memory.spec.ts +0 -31
  552. package/test/rate-limiter-ttl.spec.ts +0 -100
  553. package/test/rate-limiter.spec.ts +0 -491
  554. package/test/resolve-spf-chain.spec.ts +0 -183
  555. package/test/safe-fetch.test.ts +0 -45
  556. package/test/sanitize.spec.ts +0 -233
  557. package/test/scan-domain-cache-status.test.ts +0 -128
  558. package/test/scan-domain-provider-inference.spec.ts +0 -93
  559. package/test/scan-domain-safe-check.spec.ts +0 -91
  560. package/test/scan-domain.spec.ts +0 -1063
  561. package/test/scan-post-processing.spec.ts +0 -663
  562. package/test/scheduled.spec.ts +0 -104
  563. package/test/schemas/audit.test.ts +0 -140
  564. package/test/schemas/auth.spec.ts +0 -36
  565. package/test/schemas/dns.spec.ts +0 -48
  566. package/test/schemas/internal.spec.ts +0 -50
  567. package/test/schemas/json-rpc.spec.ts +0 -63
  568. package/test/schemas/oauth.spec.ts +0 -104
  569. package/test/schemas/primitives.spec.ts +0 -131
  570. package/test/schemas/session.spec.ts +0 -21
  571. package/test/schemas/tenant-alerts.test.ts +0 -126
  572. package/test/schemas/tenant-internal.test.ts +0 -128
  573. package/test/schemas/tool-args.spec.ts +0 -166
  574. package/test/schemas/tool-definitions.spec.ts +0 -67
  575. package/test/scoring-config-cached.spec.ts +0 -63
  576. package/test/scoring-config.spec.ts +0 -177
  577. package/test/scoring-determinism.spec.ts +0 -162
  578. package/test/scoring-engine.spec.ts +0 -134
  579. package/test/scoring-model.spec.ts +0 -44
  580. package/test/scoring-profiles.spec.ts +0 -235
  581. package/test/scoring.spec.ts +0 -197
  582. package/test/security-hardening.spec.ts +0 -58
  583. package/test/session-degradation-event.spec.ts +0 -66
  584. package/test/session-keepalive.spec.ts +0 -347
  585. package/test/session-kv-failure-logging.spec.ts +0 -99
  586. package/test/session-memory.spec.ts +0 -111
  587. package/test/session-recovery.spec.ts +0 -260
  588. package/test/session.spec.ts +0 -266
  589. package/test/simulate-attack-paths.spec.ts +0 -888
  590. package/test/spf-analysis.spec.ts +0 -29
  591. package/test/spf-trust-surface.spec.ts +0 -62
  592. package/test/srv-analysis.spec.ts +0 -151
  593. package/test/sse.spec.ts +0 -44
  594. package/test/ssl-analysis.spec.ts +0 -27
  595. package/test/stdio.spec.ts +0 -71
  596. package/test/streaming-sse.spec.ts +0 -419
  597. package/test/subdomain-takeover-analysis.spec.ts +0 -104
  598. package/test/tenants/alerts/diff.test.ts +0 -127
  599. package/test/tenants/alerts/webhook.test.ts +0 -129
  600. package/test/tenants/audit.test.ts +0 -220
  601. package/test/tenants/cron.integration.test.ts +0 -117
  602. package/test/tenants/db/registry-schema.spec.ts +0 -254
  603. package/test/tenants/db/tenant-schema.spec.ts +0 -202
  604. package/test/tenants/discovery/dkim-key-reuse.test.ts +0 -213
  605. package/test/tenants/discovery/dmarc-rua-miner.test.ts +0 -179
  606. package/test/tenants/discovery/ns-correlator.test.ts +0 -186
  607. package/test/tenants/discovery/san-correlator.test.ts +0 -128
  608. package/test/tenants/discovery-route.integration.test.ts +0 -135
  609. package/test/tenants/dns-fingerprint.test.ts +0 -321
  610. package/test/tenants/hammer-stress.integration.test.ts +0 -136
  611. package/test/tenants/per-tenant-rate-limit.test.ts +0 -119
  612. package/test/tenants/phase6-fingerprint.integration.test.ts +0 -147
  613. package/test/tenants/provision-tenant.test.ts +0 -351
  614. package/test/tenants/queue-consumer.integration.test.ts +0 -355
  615. package/test/tenants/queue-producer.integration.test.ts +0 -219
  616. package/test/tenants/routes.integration.test.ts +0 -783
  617. package/test/tenants/scheduled-handlers.integration.test.ts +0 -713
  618. package/test/tenants/tenant-d1.spec.ts +0 -78
  619. package/test/tenants/tenant-kv.spec.ts +0 -104
  620. package/test/tenants/tenant-r2.spec.ts +0 -103
  621. package/test/tier-auth-jwt-enum.test.ts +0 -55
  622. package/test/tier-auth-owner-jwt-ip.test.ts +0 -80
  623. package/test/tier-auth.spec.ts +0 -191
  624. package/test/tool-args.spec.ts +0 -101
  625. package/test/tool-execution.spec.ts +0 -421
  626. package/test/tool-formatters.spec.ts +0 -84
  627. package/test/tool-metadata.spec.ts +0 -25
  628. package/test/tool-schemas.spec.ts +0 -113
  629. package/test/trial-keys.spec.ts +0 -367
  630. package/test/tsconfig.json +0 -8
  631. package/test/txt-hygiene-analysis.spec.ts +0 -118
  632. package/test/validate-fix.spec.ts +0 -71
  633. package/test/validate-outbound-url.test.ts +0 -63
  634. package/test/wasm-integration.test.ts +0 -32
  635. package/test/zone-hygiene-analysis.spec.ts +0 -172
  636. package/tsconfig.json +0 -40
  637. package/tsup.config.ts +0 -42
  638. package/vitest.config.mts +0 -33
  639. package/wrangler.jsonc +0 -70
  640. package/wrangler.private.example.jsonc +0 -31
@@ -1,55 +0,0 @@
1
- // SPDX-License-Identifier: BUSL-1.1
2
-
3
- import type { Finding } from '../lib/scoring';
4
- import { createFinding } from '../lib/scoring';
5
-
6
- export type ParsedMxRecord = {
7
- priority: number;
8
- exchange: string;
9
- raw: string;
10
- };
11
-
12
- export function parseMxRecords(answers: string[]): ParsedMxRecord[] {
13
- return answers.map((answer) => {
14
- const parts = answer.split(' ');
15
- const priority = parseInt(parts[0], 10);
16
- const exchange = (parts.slice(1).join(' ') || '').replace(/\.$/, '').toLowerCase();
17
- return { priority, exchange, raw: answer };
18
- });
19
- }
20
-
21
- export function isNullMxRecord(record: ParsedMxRecord): boolean {
22
- return record.exchange === '' || record.exchange === '.';
23
- }
24
-
25
- export function getNullMxFinding(): Finding {
26
- return createFinding('mx', 'Null MX record (RFC 7505)', 'info', 'Domain explicitly declares it does not accept email via null MX record.');
27
- }
28
-
29
- export function getPresenceFinding(mxRecords: ParsedMxRecord[]): Finding {
30
- return createFinding('mx', 'MX records found', 'info', `${mxRecords.length} mail exchange record(s) present.`);
31
- }
32
-
33
- export function getIpTargetFindings(mxRecords: ParsedMxRecord[]): Finding[] {
34
- const ipPattern = /^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/;
35
- return mxRecords.flatMap((mxRecord) =>
36
- ipPattern.test(mxRecord.exchange)
37
- ? [
38
- createFinding(
39
- 'mx',
40
- 'MX points to IP address',
41
- 'medium',
42
- `MX record "${mxRecord.raw}" points to an IP address. MX targets must be hostnames per RFC 5321.`,
43
- ),
44
- ]
45
- : [],
46
- );
47
- }
48
-
49
- export function getSingleMxFinding(mxRecords: ParsedMxRecord[]): Finding | null {
50
- if (mxRecords.length !== 1) {
51
- return null;
52
- }
53
-
54
- return createFinding('mx', 'Single MX record', 'low', 'Only one MX record found. Consider adding a backup MX for redundancy.');
55
- }
@@ -1,205 +0,0 @@
1
- // SPDX-License-Identifier: BUSL-1.1
2
-
3
- /**
4
- * Pure analysis functions for MX reputation checking.
5
- * Handles PTR record validation, FCrDNS verification, and DNSBL result interpretation.
6
- */
7
-
8
- import type { Finding } from '../lib/scoring';
9
- import { createFinding } from '../lib/scoring';
10
-
11
- /** Pattern matching generic/residential PTR hostnames */
12
- const GENERIC_PTR_PATTERN = /^(ip-|host-|static-|dynamic-|dhcp|dsl|cable|pool|customer|client|user|broadband)/i;
13
-
14
- /**
15
- * Known shared email provider MX hostname suffixes.
16
- * IPs behind these hostnames are shared infrastructure — DNSBL listings reflect
17
- * the platform's aggregate traffic, not any individual customer domain's reputation.
18
- */
19
- const SHARED_PROVIDER_MX_SUFFIXES: Array<{ suffix: string; provider: string }> = [
20
- { suffix: '.google.com', provider: 'Google Workspace' },
21
- { suffix: '.googlemail.com', provider: 'Google Workspace' },
22
- { suffix: '.1e100.net', provider: 'Google Workspace' },
23
- { suffix: '.outlook.com', provider: 'Microsoft 365' },
24
- { suffix: '.protection.outlook.com', provider: 'Microsoft 365' },
25
- { suffix: '.pphosted.com', provider: 'Proofpoint' },
26
- { suffix: '.mimecast.com', provider: 'Mimecast' },
27
- { suffix: '.mailgun.org', provider: 'Mailgun' },
28
- { suffix: '.sendgrid.net', provider: 'SendGrid' },
29
- { suffix: '.amazonses.com', provider: 'Amazon SES' },
30
- { suffix: '.messagelabs.com', provider: 'Symantec/Broadcom' },
31
- { suffix: '.fireeyecloud.com', provider: 'Trellix' },
32
- { suffix: '.iphmx.com', provider: 'Cisco IronPort' },
33
- ];
34
-
35
- /**
36
- * Check if an MX hostname belongs to a known shared email provider.
37
- *
38
- * @param mxHost - The MX exchange hostname (e.g., "smtp-in.l.google.com")
39
- * @returns The provider name if matched, or null if the host is dedicated infrastructure
40
- */
41
- export function detectSharedMxProvider(mxHost: string): string | null {
42
- const normalized = mxHost.trim().toLowerCase().replace(/\.$/, '');
43
- if (!normalized) return null;
44
- for (const { suffix, provider } of SHARED_PROVIDER_MX_SUFFIXES) {
45
- if (normalized === suffix.slice(1) || normalized.endsWith(suffix)) {
46
- return provider;
47
- }
48
- }
49
- return null;
50
- }
51
-
52
- /**
53
- * Analyze PTR (reverse DNS) records for an MX server IP.
54
- *
55
- * Checks for:
56
- * - Missing PTR records (no reverse DNS)
57
- * - Forward-confirmed reverse DNS (FCrDNS) failure
58
- * - Generic/residential PTR hostnames
59
- * - Valid PTR matching forward DNS
60
- *
61
- * @param ip - The MX server IP address
62
- * @param ptrHostnames - PTR record hostnames for the IP
63
- * @param forwardIps - IPs resolved from PTR hostnames (for FCrDNS verification)
64
- * @returns Array of findings from PTR analysis
65
- */
66
- export function analyzePtrRecords(ip: string, ptrHostnames: string[], forwardIps: string[]): Finding[] {
67
- const findings: Finding[] = [];
68
-
69
- if (ptrHostnames.length === 0) {
70
- findings.push(
71
- createFinding(
72
- 'mx_reputation',
73
- `No PTR record for MX server ${ip}`,
74
- 'medium',
75
- `IP ${ip} has no reverse DNS (PTR) record. Mail servers without PTR records are frequently rejected by receiving servers.`,
76
- { ip },
77
- ),
78
- );
79
- return findings;
80
- }
81
-
82
- // Check FCrDNS — PTR hostname must resolve back to the original IP
83
- const hasFcrDns = forwardIps.includes(ip);
84
-
85
- if (!hasFcrDns) {
86
- findings.push(
87
- createFinding(
88
- 'mx_reputation',
89
- `PTR does not match forward DNS for ${ip}`,
90
- 'medium',
91
- `IP ${ip} has PTR record(s) (${ptrHostnames.join(', ')}), but none resolve back to ${ip}. Forward-confirmed reverse DNS (FCrDNS) failure reduces deliverability.`,
92
- { ip, ptrHostnames, forwardIps },
93
- ),
94
- );
95
- }
96
-
97
- // Check for generic/residential PTR patterns
98
- for (const hostname of ptrHostnames) {
99
- if (GENERIC_PTR_PATTERN.test(hostname)) {
100
- findings.push(
101
- createFinding(
102
- 'mx_reputation',
103
- 'MX uses generic PTR hostname',
104
- 'low',
105
- `PTR hostname "${hostname}" for IP ${ip} matches a generic/residential naming pattern. This may reduce email deliverability.`,
106
- { ip, hostname },
107
- ),
108
- );
109
- }
110
- }
111
-
112
- // If FCrDNS passed and no generic PTR, add info finding
113
- if (hasFcrDns && !ptrHostnames.some((h) => GENERIC_PTR_PATTERN.test(h))) {
114
- findings.push(
115
- createFinding(
116
- 'mx_reputation',
117
- `Reverse DNS valid for ${ip}`,
118
- 'info',
119
- `IP ${ip} has valid PTR record (${ptrHostnames.join(', ')}) that matches forward DNS.`,
120
- { ip, ptrHostnames },
121
- ),
122
- );
123
- }
124
-
125
- return findings;
126
- }
127
-
128
- /**
129
- * Analyze DNSBL lookup results for an MX server IP.
130
- *
131
- * When the MX host belongs to a known shared email provider (e.g., Google Workspace,
132
- * Microsoft 365), DNSBL listings are downgraded from `high` to `info` because the
133
- * listed IPs are shared infrastructure — their blocklist status reflects aggregate
134
- * platform traffic, not the individual domain's sending reputation.
135
- *
136
- * @param ip - The MX server IP address
137
- * @param listings - Array of DNSBL zone check results
138
- * @param sharedProvider - If non-null, the name of the shared provider (triggers downgrade)
139
- * @returns Array of findings from DNSBL analysis
140
- */
141
- export function analyzeDnsblResults(
142
- ip: string,
143
- listings: Array<{ zone: string; listed: boolean }>,
144
- sharedProvider?: string | null,
145
- ): Finding[] {
146
- const findings: Finding[] = [];
147
- const listedZones = listings.filter((l) => l.listed);
148
-
149
- if (listedZones.length > 0) {
150
- for (const listing of listedZones) {
151
- if (sharedProvider) {
152
- findings.push(
153
- createFinding(
154
- 'mx_reputation',
155
- `Shared ${sharedProvider} IP listed on ${listing.zone} (informational)`,
156
- 'info',
157
- `IP ${ip} is listed on DNSBL ${listing.zone}, but this is a shared ${sharedProvider} IP. DNSBL listings on shared email infrastructure reflect the provider's aggregate traffic, not your domain's individual reputation. Your sending reputation is managed at the account level by ${sharedProvider}.`,
158
- { ip, zone: listing.zone, sharedProvider },
159
- ),
160
- );
161
- } else {
162
- findings.push(
163
- createFinding(
164
- 'mx_reputation',
165
- `MX server IP listed on ${listing.zone}`,
166
- 'high',
167
- `IP ${ip} is listed on DNSBL ${listing.zone}. Blacklisted mail servers will have significantly degraded email deliverability.`,
168
- { ip, zone: listing.zone },
169
- ),
170
- );
171
- }
172
- }
173
- } else {
174
- findings.push(
175
- createFinding(
176
- 'mx_reputation',
177
- `MX reputation clean for ${ip}`,
178
- 'info',
179
- `IP ${ip} is not listed on any checked DNSBLs (${listings.map((l) => l.zone).join(', ')}).`,
180
- { ip, zones: listings.map((l) => l.zone) },
181
- ),
182
- );
183
- }
184
-
185
- return findings;
186
- }
187
-
188
- /**
189
- * Return the list of DNSBL zones to check.
190
- * These are well-known, reliable blocklists with publicly queryable DNS interfaces.
191
- */
192
- export function buildDnsblZones(): string[] {
193
- return ['zen.spamhaus.org', 'bl.spamcop.net', 'b.barracudacentral.org'];
194
- }
195
-
196
- /**
197
- * Reverse IPv4 octets for DNSBL lookup.
198
- * Example: `192.0.2.1` becomes `1.2.0.192`
199
- *
200
- * @param ip - IPv4 address string
201
- * @returns Reversed octet string
202
- */
203
- export function reverseIpForDnsbl(ip: string): string {
204
- return ip.split('.').reverse().join('.');
205
- }
@@ -1,162 +0,0 @@
1
- // SPDX-License-Identifier: BUSL-1.1
2
-
3
- import type { Finding } from '../lib/scoring';
4
- import { createFinding } from '../lib/scoring';
5
-
6
- const RESILIENT_NS_PROVIDERS: Record<string, string> = {
7
- 'cloudflare.com':
8
- "Cloudflare's anycast network provides built-in geographic redundancy, so this is lower risk than single-provider setups on traditional DNS hosts.",
9
- 'awsdns.com': "AWS Route 53's anycast network provides built-in geographic redundancy, so this is lower risk than single-provider setups on traditional DNS hosts.",
10
- 'google.com':
11
- 'Google Cloud DNS uses globally distributed authoritative infrastructure, so this is lower risk than single-provider setups on traditional DNS hosts.',
12
- };
13
-
14
- export type ParsedSoaValues = {
15
- refresh: number | null;
16
- retry: number | null;
17
- expire: number | null;
18
- minimum: number | null;
19
- };
20
-
21
- export function normalizeNsRecords(nsRecords: string[]): string[] {
22
- return nsRecords.map((record) => record.replace(/\.$/, '').toLowerCase());
23
- }
24
-
25
- export function getNsVisibilityFinding(domain: string, domainResolves: boolean): Finding {
26
- if (domainResolves) {
27
- return createFinding(
28
- 'ns',
29
- 'NS records not directly visible',
30
- 'low',
31
- `No NS records returned for ${domain} directly, but the domain resolves. NS records may be managed at a parent zone.`,
32
- );
33
- }
34
-
35
- return createFinding(
36
- 'ns',
37
- 'No NS records found',
38
- 'critical',
39
- `No nameserver records found for ${domain}. Without NS records, the domain cannot resolve.`,
40
- );
41
- }
42
-
43
- export function getSingleNsFinding(nsRecords: string[]): Finding | null {
44
- if (nsRecords.length !== 1) {
45
- return null;
46
- }
47
-
48
- return createFinding(
49
- 'ns',
50
- 'Single nameserver (violates RFC 1035 §2.2)',
51
- 'high',
52
- `Only one nameserver found (${nsRecords[0]}). RFC 1035 §2.2 mandates at least two nameservers for every zone to ensure redundancy and availability.`,
53
- );
54
- }
55
-
56
- export function getNameserverDiversityFinding(nsRecords: string[]): Finding | null {
57
- const providerDomains = new Set(
58
- nsRecords.map((record) => {
59
- const parts = record.split('.');
60
- return parts.slice(-2).join('.');
61
- }),
62
- );
63
-
64
- if (providerDomains.size !== 1 || nsRecords.length <= 1) {
65
- return null;
66
- }
67
-
68
- const providerDomain = [...providerDomains][0];
69
- const providerContext =
70
- RESILIENT_NS_PROVIDERS[providerDomain] ?? 'Consider using nameservers from different providers for better resilience.';
71
-
72
- return createFinding(
73
- 'ns',
74
- 'Low nameserver diversity',
75
- 'low',
76
- `All nameservers are under ${providerDomain}. ${providerContext} For maximum independence, a secondary DNS provider can be added.`,
77
- );
78
- }
79
-
80
- export function parseSoaValues(soaData: string): ParsedSoaValues | null {
81
- const soaParts = soaData.trim().split(/\s+/);
82
- if (soaParts.length < 7) {
83
- return null;
84
- }
85
-
86
- const refresh = parseInt(soaParts[3], 10);
87
- const retry = parseInt(soaParts[4], 10);
88
- const expire = parseInt(soaParts[5], 10);
89
- const minimum = parseInt(soaParts[6], 10);
90
-
91
- return {
92
- refresh: Number.isNaN(refresh) ? null : refresh,
93
- retry: Number.isNaN(retry) ? null : retry,
94
- expire: Number.isNaN(expire) ? null : expire,
95
- minimum: Number.isNaN(minimum) ? null : minimum,
96
- };
97
- }
98
-
99
- export function getSoaValidationFindings(soaValues: ParsedSoaValues): Finding[] {
100
- const findings: Finding[] = [];
101
-
102
- if (soaValues.refresh !== null) {
103
- if (soaValues.refresh < 300) {
104
- findings.push(
105
- createFinding(
106
- 'ns',
107
- 'SOA refresh interval too short',
108
- 'low',
109
- `SOA refresh interval is ${soaValues.refresh}s (< 300s / 5 min). Very short refresh intervals increase DNS traffic and load on nameservers.`,
110
- ),
111
- );
112
- } else if (soaValues.refresh > 86400) {
113
- findings.push(
114
- createFinding(
115
- 'ns',
116
- 'SOA refresh interval too long',
117
- 'low',
118
- `SOA refresh interval is ${soaValues.refresh}s (> 86400s / 1 day). Long refresh intervals delay propagation of zone changes to secondary nameservers.`,
119
- ),
120
- );
121
- }
122
- }
123
-
124
- if (soaValues.retry !== null && soaValues.refresh !== null && soaValues.retry > soaValues.refresh) {
125
- findings.push(
126
- createFinding(
127
- 'ns',
128
- 'SOA retry exceeds refresh interval',
129
- 'low',
130
- `SOA retry interval (${soaValues.retry}s) exceeds refresh interval (${soaValues.refresh}s). Retry should be shorter than refresh to allow timely recovery after failed zone transfers.`,
131
- ),
132
- );
133
- }
134
-
135
- if (soaValues.expire !== null && soaValues.expire < 604800) {
136
- findings.push(
137
- createFinding(
138
- 'ns',
139
- 'SOA expire too short',
140
- 'medium',
141
- `SOA expire value is ${soaValues.expire}s (< 604800s / 1 week). If secondary nameservers cannot reach the primary for this duration, they will stop serving the zone.`,
142
- ),
143
- );
144
- }
145
-
146
- if (soaValues.minimum !== null && soaValues.minimum > 86400) {
147
- findings.push(
148
- createFinding(
149
- 'ns',
150
- 'SOA negative cache TTL too long',
151
- 'low',
152
- `SOA minimum (negative cache TTL) is ${soaValues.minimum}s (> 86400s / 1 day). This means NXDOMAIN responses will be cached for extended periods, delaying visibility of new records.`,
153
- ),
154
- );
155
- }
156
-
157
- return findings;
158
- }
159
-
160
- export function getNsConfiguredFinding(nsRecords: string[]): Finding {
161
- return createFinding('ns', 'Nameservers properly configured', 'info', `${nsRecords.length} nameservers found: ${nsRecords.join(', ')}`);
162
- }